@downcity/city 1.1.32 → 1.1.47

package/src/platform/store/index.ts

@@ -14,15 +14,12 @@ import { getPlatformStoreDbPath } from "@/process/registry/CityPaths.js";
 import { ensurePlatformStoreSchema } from "./StoreSchema.js";
 import type { PlatformStoreContext } from "./StoreShared.js";
 import type {
-  StoredAgentEnvEntry,
   StoredChannelAccount,
   StoredEnvEntry,
-  StoredEnvScope,
   StoredGlobalEnvEntry,
   StoredModel,
   StoredModelProvider,
   StoredProviderMeta,
-  UpsertAgentEnvEntryInput,
   UpsertChannelAccountInput,
   UpsertEnvEntryInput,
   UpsertGlobalEnvEntryInput,
@@ -55,23 +52,15 @@ import {
   setSecureSettingJsonSync,
 } from "./StoreSecureSettings.js";
 import {
-  clearAgentEnvEntries,
   clearGlobalEnvEntries,
-  getAgentEnvMap,
-  getAgentEnvMapSync,
   getGlobalEnvMap,
   getGlobalEnvMapSync,
-  listAgentEnvEntries,
-  listAgentEnvEntriesSync,
-  listAllAgentEnvEntries,
   listEnvEntries,
   listEnvEntriesSync,
   listGlobalEnvEntries,
   listGlobalEnvEntriesSync,
-  removeAgentEnvEntry,
   removeEnvEntry,
   removeGlobalEnvEntry,
-  upsertAgentEnvEntry,
   upsertEnvEntry,
   upsertGlobalEnvEntry,
 } from "./StoreEnvRepository.js";
@@ -204,8 +193,6 @@ export class PlatformStore {
     clearStoredModelsAndProviders(this.context);
     this.sqlite.exec("DELETE FROM platform_secure_settings;");
     this.sqlite.exec("DELETE FROM env_entries;");
-    this.sqlite.exec("DELETE FROM global_env;");
-    this.sqlite.exec("DELETE FROM agent_env;");
     this.sqlite.exec("DELETE FROM channel_accounts;");
   }
 
@@ -299,15 +286,15 @@ export class PlatformStore {
   /**
    * 查询 env 条目（同步）。
    */
-  listEnvEntriesSync(scopeInput?: StoredEnvScope, agentIdInput?: string): StoredEnvEntry[] {
-    return listEnvEntriesSync(this.context, scopeInput, agentIdInput);
+  listEnvEntriesSync(): StoredEnvEntry[] {
+    return listEnvEntriesSync(this.context);
   }
 
   /**
    * 查询 env 条目（异步）。
    */
-  async listEnvEntries(scopeInput?: StoredEnvScope, agentIdInput?: string): Promise<StoredEnvEntry[]> {
-    return await listEnvEntries(this.context, scopeInput, agentIdInput);
+  async listEnvEntries(): Promise<StoredEnvEntry[]> {
+    return await listEnvEntries(this.context);
   }
 
   /**
@@ -320,8 +307,8 @@ export class PlatformStore {
   /**
    * 删除单个 env 条目。
    */
-  removeEnvEntry(input: { scope: StoredEnvScope; agentId?: string; key: string }): void {
-    removeEnvEntry(this.context, input);
+  removeEnvEntry(keyInput: string): void {
+    removeEnvEntry(this.context, keyInput);
   }
 
   /**
@@ -332,23 +319,23 @@ export class PlatformStore {
   }
 
   /**
-   * 读取全局环境变量映射（同步解密）。
+   * 读取环境变量映射（同步解密）。
    */
-  getGlobalEnvMapSync(): Record<string, string> {
+  getEnvMapSync(): Record<string, string> {
     return getGlobalEnvMapSync(this.context);
   }
 
   /**
-   * 列出全局环境变量（解密后）。
+   * 列出环境变量（解密后）。
    */
   async listGlobalEnvEntries(): Promise<StoredGlobalEnvEntry[]> {
     return await listGlobalEnvEntries(this.context);
   }
 
   /**
-   * 读取全局环境变量映射（解密后）。
+   * 读取环境变量映射（解密后）。
    */
-  async getGlobalEnvMap(): Promise<Record<string, string>> {
+  async getEnvMap(): Promise<Record<string, string>> {
     return await getGlobalEnvMap(this.context);
   }
 
@@ -373,62 +360,6 @@ export class PlatformStore {
     clearGlobalEnvEntries(this.context);
   }
 
-  /**
-   * 列出指定 agent 的私有环境变量（同步解密）。
-   */
-  listAgentEnvEntriesSync(agentIdInput: string): StoredAgentEnvEntry[] {
-    return listAgentEnvEntriesSync(this.context, agentIdInput);
-  }
-
-  /**
-   * 读取指定 agent 的私有环境变量映射（同步解密）。
-   */
-  getAgentEnvMapSync(agentIdInput: string): Record<string, string> {
-    return getAgentEnvMapSync(this.context, agentIdInput);
-  }
-
-  /**
-   * 列出指定 agent 的私有环境变量（解密后）。
-   */
-  async listAgentEnvEntries(agentIdInput: string): Promise<StoredAgentEnvEntry[]> {
-    return await listAgentEnvEntries(this.context, agentIdInput);
-  }
-
-  /**
-   * 列出全部 agent 私有环境变量（解密后）。
-   */
-  async listAllAgentEnvEntries(): Promise<StoredAgentEnvEntry[]> {
-    return await listAllAgentEnvEntries(this.context);
-  }
-
-  /**
-   * 读取指定 agent 的私有环境变量映射（解密后）。
-   */
-  async getAgentEnvMap(agentIdInput: string): Promise<Record<string, string>> {
-    return await getAgentEnvMap(this.context, agentIdInput);
-  }
-
-  /**
-   * 新增或更新 agent 私有环境变量。
-   */
-  async upsertAgentEnvEntry(input: UpsertAgentEnvEntryInput): Promise<void> {
-    await upsertAgentEnvEntry(this.context, input);
-  }
-
-  /**
-   * 删除指定 agent 的单个环境变量。
-   */
-  removeAgentEnvEntry(agentIdInput: string, keyInput: string): void {
-    removeAgentEnvEntry(this.context, agentIdInput, keyInput);
-  }
-
-  /**
-   * 清空指定 agent 的私有环境变量。
-   */
-  clearAgentEnvEntries(agentIdInput: string): void {
-    clearAgentEnvEntries(this.context, agentIdInput);
-  }
-
   /**
    * 列出 channel accounts（同步解密）。
    */

package/src/platform/store/schema.ts

@@ -48,8 +48,8 @@ export const modelsTable = sqliteTable(
  * 平台 Env 统一存储表。
  *
  * 关键点（中文）
- * - 全局 env 与 agent env 共用一张表，通过 `scope` + `agentId` 区分。
- * - `agentId` 在 `scope=global` 时固定为空字符串，避免 SQLite 复合主键中的 NULL 语义问题。
+ * - 当前只保留平台全局 env。
+ * - 仍使用 `scope + agent_id + key` 复合主键，其中运行时固定写入 `global + ''`。
  * - value 采用密文存储，解密仅在运行时内存中进行。
  */
 export const envEntriesTable = sqliteTable(

package/src/process/daemon/Api.ts

@@ -39,7 +39,7 @@ export type DaemonJsonApiCallParams = {
    * 单次调用超时（毫秒）。
    *
    * 说明（中文）
-   * - 仅本地 IPC transport 当前会消费该参数。
+   * - 当前 HTTP daemon client 会消费该参数。
    * - 用于 `session execute`、`plugin command` 这类可能持续几十秒的请求，
    *   避免被默认短超时误判成“Agent server 未启动”。
    */

package/src/process/daemon/CliArgs.ts

@@ -4,6 +4,7 @@
  * 关键点
  * - daemon（来自 `agent start` / `agent restart`）会拉起一个前台 `agent start`
  *   进程（显式 `--foreground true`），这里负责拼装其 argv。
+ * - city 托管的 HTTP gateway 与 agent 本机 RPC 使用不同端口，避免职责混用。
  */
 
 import type { StartOptions } from "@downcity/agent";
@@ -26,13 +27,35 @@ export const buildRunArgsFromOptions = async (
   // 关键点（中文）：host 未指定时统一落到 0.0.0.0，保持历史监听行为。
   const host = String(options.host || "0.0.0.0").trim() || "0.0.0.0";
 
-  // 关键点（中文）：agent 端口统一由 console 分配，不接受命令行显式覆盖。
+  // 关键点（中文）：外层 HTTP gateway 端口统一由 city 分配。
   const port = await allocateAvailablePort({ host });
   if (!Number.isFinite(port) || Number.isNaN(port) || port <= 0 || port > 65535) {
     throw new Error(`Invalid allocated port: ${String(port)}`);
   }
 
+  // 关键点（中文）：本机 RPC 端口独立分配到另一段端口区间，避免和 HTTP gateway 冲突。
+  const rpc_port =
+    typeof options.rpcPort === "number" && Number.isInteger(options.rpcPort)
+      ? options.rpcPort
+      : await allocateAvailablePort({
+          host: "127.0.0.1",
+          start: 15314,
+          end: 16399,
+        });
+  if (
+    !Number.isFinite(rpc_port) ||
+    Number.isNaN(rpc_port) ||
+    rpc_port <= 0 ||
+    rpc_port > 65535
+  ) {
+    throw new Error(`Invalid allocated rpc port: ${String(rpc_port)}`);
+  }
+  if (rpc_port === port) {
+    throw new Error(`HTTP port and RPC port must be different: ${port}`);
+  }
+
   args.push("--port", String(port));
+  args.push("--rpc-port", String(rpc_port));
   args.push("--host", host);
 
   return args;

package/src/process/daemon/Client.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 业务模块统一通过 daemon API 与运行时通信。
- * - 地址解析优先级：CLI 参数 > 环境变量 > daemon meta > 默认值。
+ * - HTTP gateway 与本机 RPC 的地址解析分开，避免端口语义混淆。
  */
 
 import fs from "fs-extra";
@@ -62,29 +62,27 @@ function pickArgValue(args: string[], key: string): string | undefined {
   return next || undefined;
 }
 
-/**
- * 解析 daemon endpoint。
- *
- * 优先级（中文）
- * 1) 显式入参 `host/port`
- * 2) 环境变量 `DC_SERVER_*` / `DC_CTX_SERVER_*`
- * 3) daemon meta args（`downcity.daemon.json`）
- * 4) 默认 `127.0.0.1:5314`
- */
-export function resolveDaemonEndpoint(params: {
+type ResolveDaemonEndpointParams = {
   projectRoot: string;
   host?: string;
   port?: number;
+};
+
+function resolveDaemonEndpointFromSources(params: {
+  projectRoot: string;
+  explicit_host?: string;
+  explicit_port?: number;
+  env_host_name: string;
+  env_port_name: string;
+  arg_port_name: string;
+  default_host: string;
+  default_port: number;
 }): DaemonEndpoint {
-  const explicitHost = normalizeHost(params.host);
-  const explicitPort = parsePortLike(params.port);
+  const explicitHost = normalizeHost(params.explicit_host);
+  const explicitPort = parsePortLike(params.explicit_port);
 
-  const envHost =
-    normalizeHost(process.env.DC_SERVER_HOST) ||
-    normalizeHost(process.env.DC_CTX_SERVER_HOST);
-  const envPort =
-    parsePortLike(process.env.DC_SERVER_PORT) ||
-    parsePortLike(process.env.DC_CTX_SERVER_PORT);
+  const envHost = normalizeHost(process.env[params.env_host_name]);
+  const envPort = parsePortLike(process.env[params.env_port_name]);
 
   let daemonArgHost: string | undefined;
   let daemonArgPort: number | undefined;
@@ -96,14 +94,14 @@ export function resolveDaemonEndpoint(params: {
         ? raw.args.map((item) => String(item))
         : [];
       daemonArgHost = normalizeHost(pickArgValue(args, "--host"));
-      daemonArgPort = parsePortLike(pickArgValue(args, "--port"));
+      daemonArgPort = parsePortLike(pickArgValue(args, params.arg_port_name));
     }
   } catch {
     // ignore daemon meta errors, fallback to other sources
   }
 
-  const host = explicitHost || envHost || daemonArgHost || "127.0.0.1";
-  const port = explicitPort || envPort || daemonArgPort || 5314;
+  const host = explicitHost || envHost || daemonArgHost || params.default_host;
+  const port = explicitPort || envPort || daemonArgPort || params.default_port;
 
   return {
     host,
@@ -112,6 +110,56 @@ export function resolveDaemonEndpoint(params: {
   };
 }
 
+/**
+ * 解析 daemon endpoint。
+ *
+ * 优先级（中文）
+ * 1) 显式入参 `host/port`
+ * 2) 环境变量 `DC_CITY_HOST/DC_CITY_PORT`
+ * 3) daemon meta args（`downcity.daemon.json`）
+ * 4) 默认 `127.0.0.1:5314`
+ */
+export function resolveDaemonEndpoint(params: {
+  projectRoot: string;
+  host?: string;
+  port?: number;
+}): DaemonEndpoint {
+  return resolveDaemonEndpointFromSources({
+    projectRoot: params.projectRoot,
+    explicit_host: params.host,
+    explicit_port: params.port,
+    env_host_name: "DC_CITY_HOST",
+    env_port_name: "DC_CITY_PORT",
+    arg_port_name: "--port",
+    default_host: "127.0.0.1",
+    default_port: 5314,
+  });
+}
+
+/**
+ * 解析 daemon 本机 RPC endpoint。
+ *
+ * 优先级（中文）
+ * 1) 显式入参 `host/port`
+ * 2) 环境变量 `DC_AGENT_RPC_HOST/DC_AGENT_RPC_PORT`
+ * 3) daemon meta args（`downcity.daemon.json`）
+ * 4) 默认 `127.0.0.1:15314`
+ */
+export function resolveDaemonRpcEndpoint(
+  params: ResolveDaemonEndpointParams,
+): DaemonEndpoint {
+  return resolveDaemonEndpointFromSources({
+    projectRoot: params.projectRoot,
+    explicit_host: params.host,
+    explicit_port: params.port,
+    env_host_name: "DC_AGENT_RPC_HOST",
+    env_port_name: "DC_AGENT_RPC_PORT",
+    arg_port_name: "--rpc-port",
+    default_host: "127.0.0.1",
+    default_port: 15314,
+  });
+}
+
 /**
  * 调用 daemon JSON API。
  *
@@ -132,6 +180,12 @@ export async function callServer<T>(
   const method = params.method || "GET";
   const hasBody = params.body !== undefined && method !== "GET";
   const headers: Record<string, string> = {};
+  const timeoutMs =
+    typeof params.timeoutMs === "number" &&
+    Number.isFinite(params.timeoutMs) &&
+    params.timeoutMs > 0
+      ? Math.floor(params.timeoutMs)
+      : undefined;
   const authHeaderValue = formatCliBearerHeaderValue(
     resolveCliAuthToken({
       explicitToken: params.authToken,
@@ -145,11 +199,19 @@ export async function callServer<T>(
   }
 
   try {
+    const abortController = timeoutMs ? new AbortController() : undefined;
+    const timeoutHandle = timeoutMs
+      ? setTimeout(() => abortController?.abort(), timeoutMs)
+      : undefined;
     const response = await fetch(url, {
       method,
       headers: Object.keys(headers).length > 0 ? headers : undefined,
       body: hasBody ? JSON.stringify(params.body) : undefined,
+      signal: abortController?.signal,
     });
+    if (timeoutHandle) {
+      clearTimeout(timeoutHandle);
+    }
 
     let data: JsonValue | null = null;
     try {
@@ -174,6 +236,12 @@ export async function callServer<T>(
       data: data as T,
     };
   } catch (error) {
+    if (timeoutMs && error instanceof Error && error.name === "AbortError") {
+      return {
+        success: false,
+        error: `Failed to call ${url}: timeout after ${timeoutMs}ms`,
+      };
+    }
     return {
       success: false,
       error: `Failed to call ${url}: ${String(error)}`,

package/src/process/daemon/Manager.ts

@@ -28,6 +28,7 @@ import {
   upsertManagedAgentEntry,
 } from "@/process/registry/CityRegistry.js";
 import { signalDetachedProcess } from "@/process/registry/ProcessSweep.js";
+import { mergeProcessEnvWithPlatformGlobalEnv } from "@/env/ProcessEnv.js";
 
 /**
  * 异步睡眠工具。
@@ -239,7 +240,7 @@ export const startDaemonProcess = async (params: {
   const logFd = fs.openSync(logPath, "a");
 
   const childEnv: NodeJS.ProcessEnv = {
-    ...process.env,
+    ...mergeProcessEnvWithPlatformGlobalEnv(process.env),
     DOWNCITY_DAEMON: "1",
   };
 

package/src/process/registry/AgentHostRuntime.ts

@@ -4,7 +4,7 @@
  * 关键点（中文）
  * - `main/agent/*` 负责创建这些宿主能力对象，再注入到 AgentRuntime。
  * - plugin runtimes / session / plugins 只消费这些对象，不再直接 import `main/*`。
- * - 当前由 city 在这里统一装配路径、plugin 配置持久化与平台能力三类宿主对象。
+ * - 当前由 city 在这里统一装配路径与 plugin 配置持久化两类宿主对象。
  */
 import {
   getCacheDirPath,
@@ -21,76 +21,9 @@ import {
 import { persistProjectPluginConfig } from "@downcity/agent";
 import type {
   AgentPathRuntime,
-  AgentPlatformRuntime,
   AgentPluginConfigRuntime,
-  ChatChannelAccountListItem,
-  StoredChannelAccount,
-  StoredChannelAccountChannel,
 } from "@downcity/agent";
 import type { DowncityConfig } from "@downcity/agent";
-import { PlatformStore } from "@/platform/store/index.js";
-import {
-  isCityPluginEnabled,
-  setCityPluginEnabled,
-} from "@/platform/PluginLifecycle.js";
-import {
-  readChatAuthorizationConfigSync,
-  setChatAuthorizationUserRole,
-  writeChatAuthorizationConfig,
-} from "@/platform/chatAuthorization/Store.js";
-
-/**
- * 脱敏显示密钥。
- *
- * 关键点（中文）
- * - channel account 列表只返回安全视图，避免在 CLI/UI 展示链路泄露明文。
- * - 保持和现有 model provider 脱敏规则一致，减少用户心智负担。
- */
-function maskSecret(value: string | undefined): string | undefined {
-  const raw = String(value || "").trim();
-  if (!raw) return undefined;
-  if (raw.length <= 8) return "***";
-  return `${raw.slice(0, 4)}***${raw.slice(-4)}`;
-}
-
-/**
- * 将存储层 channel account 转成对外安全视图。
- */
-function toChannelAccountListItem(
-  account: StoredChannelAccount,
-): ChatChannelAccountListItem {
-  return {
-    id: account.id,
-    channel: account.channel,
-    name: account.name,
-    identity: account.identity,
-    owner: account.owner,
-    creator: account.creator,
-    domain: account.domain,
-    sandbox: account.sandbox === true,
-    hasBotToken: !!String(account.botToken || "").trim(),
-    hasAppId: !!String(account.appId || "").trim(),
-    hasAppSecret: !!String(account.appSecret || "").trim(),
-    botTokenMasked: maskSecret(account.botToken),
-    appIdMasked: maskSecret(account.appId),
-    appSecretMasked: maskSecret(account.appSecret),
-    createdAt: account.createdAt,
-    updatedAt: account.updatedAt,
-  };
-}
-
-/**
- * 归一化并校验 channel account 渠道名。
- */
-function normalizeChannelAccountChannel(
-  channelInput: string,
-): StoredChannelAccountChannel {
-  const channel = String(channelInput || "").trim().toLowerCase();
-  if (channel === "telegram" || channel === "feishu" || channel === "qq") {
-    return channel;
-  }
-  throw new Error(`Unsupported channel account channel: ${channelInput}`);
-}
 
 /**
  * 创建当前项目的路径能力集合。
@@ -134,98 +67,3 @@ export function createAgentPluginConfigRuntime(projectRoot: string): AgentPlugin
     },
   };
 }
-
-/**
- * 创建当前项目的平台能力集合。
- *
- * 关键点（中文）
- * - 这里先暴露 agent 当前已经需要的最小平台读能力。
- * - 具体平台数据仍由 city 自己管理，agent 只消费这一层接口。
- */
-export function createAgentPlatformRuntime(): AgentPlatformRuntime {
-  return {
-    getGlobalEnv: () => {
-      const store = new PlatformStore();
-      try {
-        return store.getGlobalEnvMapSync();
-      } finally {
-        store.close();
-      }
-    },
-    getAgentEnv: (projectRoot) => {
-      const store = new PlatformStore();
-      try {
-        return store.getAgentEnvMapSync(projectRoot);
-      } finally {
-        store.close();
-      }
-    },
-    listModels: () => {
-      const store = new PlatformStore();
-      try {
-        return store.listModels();
-      } finally {
-        store.close();
-      }
-    },
-    listProviders: async () => {
-      const store = new PlatformStore();
-      try {
-        return await store.listProviders();
-      } finally {
-        store.close();
-      }
-    },
-    getModel: (modelId) => {
-      const store = new PlatformStore();
-      try {
-        return store.getModel(modelId);
-      } finally {
-        store.close();
-      }
-    },
-    getChannelAccount: (channelAccountId) => {
-      const store = new PlatformStore();
-      try {
-        return store.getChannelAccountSync(channelAccountId);
-      } finally {
-        store.close();
-      }
-    },
-    listChannelAccounts: async () => {
-      const store = new PlatformStore();
-      try {
-        const accounts = await store.listChannelAccounts();
-        return accounts.map(toChannelAccountListItem);
-      } finally {
-        store.close();
-      }
-    },
-    updateChannelAccount: async (input) => {
-      const store = new PlatformStore();
-      try {
-        await store.upsertChannelAccount({
-          ...input,
-          channel: normalizeChannelAccountChannel(input.channel),
-        });
-      } finally {
-        store.close();
-      }
-    },
-    removeChannelAccount: async (channelAccountId) => {
-      const store = new PlatformStore();
-      try {
-        store.removeChannelAccount(channelAccountId);
-      } finally {
-        store.close();
-      }
-    },
-    readChatAuthorizationConfig: (projectRoot) => readChatAuthorizationConfigSync(projectRoot),
-    writeChatAuthorizationConfig,
-    setChatAuthorizationUserRole,
-    isPluginEnabled: (pluginName) => isCityPluginEnabled(pluginName),
-    setPluginEnabled: (pluginName, enabled) => {
-      setCityPluginEnabled(pluginName, enabled);
-    },
-  };
-}

package/src/terminal/admin/auth-error.ts

@@ -0,0 +1,62 @@
+/**
+ * Admin 鉴权错误工具。
+ *
+ * 关键说明（中文）
+ * - 当 admin key 不正确或已失效时，SDK 会把请求失败包装成带 `status` 的 Error。
+ * - 这里统一把 401 转成可识别的 AdminAuthError，方便外层清理缓存 session 并提示重新输入。
+ */
+
+/**
+ * admin key 无效时给用户展示的统一提示。
+ */
+export const ADMIN_AUTH_INVALID_MESSAGE =
+  "Current server admin key is incorrect or expired. Please set it again.";
+
+interface HttpClientError extends Error {
+  /** HTTP 状态码 */
+  status?: number;
+}
+
+/**
+ * 判断服务端是否缺少新接口。
+ */
+export function isAdminNotFoundError(error: unknown): boolean {
+  return (error as HttpClientError | undefined)?.status === 404;
+}
+
+/**
+ * admin 鉴权失效错误。
+ */
+export class AdminAuthError extends Error {
+  constructor(message = ADMIN_AUTH_INVALID_MESSAGE) {
+    super(message);
+    this.name = "AdminAuthError";
+  }
+}
+
+/**
+ * 判断当前错误是否是 admin 鉴权失效。
+ */
+export function isAdminAuthError(error: unknown): error is AdminAuthError {
+  return error instanceof AdminAuthError;
+}
+
+/**
+ * 如果底层错误是 401，则提升为 AdminAuthError。
+ */
+export function rethrowAdminAuthError(error: unknown): void {
+  const status = (error as HttpClientError | undefined)?.status;
+  if (status === 401) {
+    throw new AdminAuthError();
+  }
+}
+
+/**
+ * 提取可展示的错误文本。
+ */
+export function adminErrorMessage(error: unknown): string {
+  if (error instanceof Error) {
+    return error.message;
+  }
+  return String(error);
+}