886a8e31d0
三件一條鏈(HANDOFF §2/§3b,kbdb-base Phase 9):
A. KBDB MCP 薄殼(9.1):mcp/src/tools/kbdb_data.ts 6 工具
template/record/query/search,調基本盤 API。鐵律:不給建表/SQL,只 template+slot。
B. MCP self-hosted 認證 401(mcp-account-source §5.5):
- partner-auth.ts:MULTI_TENANT=false 時 Bearer 明碼直接當 org_namespace,
繞 KBDB partner 驗證(對齊 cypher 的 opaque-key 模型)。官方 SaaS 行為不變、共用同碼。
- mcp-setup.ts:把 namespace/api_key 寫進 .mcp.json headers.Authorization。
- 新增 self-hosted vs SaaS 分支單測(9 tests 綠)。
C. cypher KBDB proxy(9.5)+ CLI 薄殼(9.2):
- routes/kbdb-proxy.ts 純轉發 /kbdb/* → KBDB 基本盤(KBDB_BASE_URL HTTP fetch,
不新增 service binding)。讓 CLI(只認證到 cypher)能達獨立 KBDB worker。
- 租戶隔離:X-Arcrun-API-Key 自動當 owner_id 注入 records/entries(強制覆寫防跨租戶);
templates 全域共享(虛擬表定義是 schema 非資料)。
- cli/src/commands/kbdb.ts:acr kbdb template/record/query/search,與 MCP kbdb_* 同能力。
- kbdb base:entries 加 page_name 過濾(9.3)。
cypher + cli + mcp tsc exit 0。未驗收:端到端需 deploy + KBDB_BASE_URL 可達後實測。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
24 lines
993 B
TypeScript
24 lines
993 B
TypeScript
export interface Env {
|
||
COMPONENT_REGISTRY: Fetcher;
|
||
CYPHER_EXECUTOR: Fetcher;
|
||
KBDB: Fetcher;
|
||
KBDB_INTERNAL_TOKEN: string;
|
||
API_KEY?: string;
|
||
// Platform telemetry / feedback aggregation key (optional)
|
||
// 對應 arcrun SDD .agents/specs/llm-interface/ M1.2-1.3
|
||
// 設了會把 agent-feedback / agent-telemetry block 都寫到 platform user_id 下;
|
||
// 沒設則 fallback 寫進 user 自己的 namespace
|
||
PLATFORM_API_KEY?: string;
|
||
// Self-hosted 單租戶模式旗標(與 cypher-executor 同名同義)。
|
||
// "false" = self-hosted:Bearer 帶的是 namespace 明碼(非平台 partner key),
|
||
// 不打 KBDB partner 驗證,直接當 org_namespace(對齊 cypher 的 opaque-key 模型)。
|
||
// 未設 / "true" = 官方 SaaS:維持 partner-key 驗證(行為完全不變)。
|
||
// SDD: sdk-and-website/mcp-account-source.md;HANDOFF §3b。
|
||
MULTI_TENANT?: string;
|
||
}
|
||
|
||
export interface ToolContext {
|
||
env: Env;
|
||
orgNamespace: string;
|
||
}
|