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;
}