@downcity/city 1.1.4 → 1.1.5

package/src/console/gateway/GatewaySupport.ts

@@ -1,59 +0,0 @@
-/**
- * Console gateway 共享辅助函数。
- *
- * 关键点（中文）
- * - 提供与路由层正交的纯文本/纯 payload 组装能力。
- * - 让 `ConsoleGateway` 与 route 注册模块不再重复拼接阻塞文案。
- */
-
-/**
- * Console workload 安全检查结果。
- */
-export interface ConsoleWorkloadSafetyCheck {
-  /**
-   * 当前仍在运行的上下文列表。
-   */
-  activeContexts: string[];
-  /**
-   * 当前仍在运行的任务列表。
-   */
-  activeTasks: string[];
-}
-
-/**
- * 生成 workload 阻塞详情文本。
- */
-export function buildConsoleWorkloadBlockDetail(
-  checks: ConsoleWorkloadSafetyCheck,
-): string {
-  const contextLabel =
-    checks.activeContexts.length > 0
-      ? `contexts: ${checks.activeContexts.join(", ")}`
-      : "";
-  const taskLabel =
-    checks.activeTasks.length > 0 ? `tasks: ${checks.activeTasks.join(", ")}` : "";
-  return [contextLabel, taskLabel].filter(Boolean).join(" | ");
-}
-
-/**
- * 生成 stop/restart 被阻塞时的统一响应 payload。
- */
-export function buildConsoleWorkloadBlockPayload(
-  action: "stop" | "restart",
-  checks: ConsoleWorkloadSafetyCheck,
-): {
-  success: false;
-  error: string;
-  activeContexts: string[];
-  activeTasks: string[];
-} {
-  const detail = buildConsoleWorkloadBlockDetail(checks);
-  return {
-    success: false,
-    error: detail
-      ? `Agent has running workload, ${action} blocked (${detail})`
-      : `Agent has running workload, ${action} blocked`,
-    activeContexts: checks.activeContexts,
-    activeTasks: checks.activeTasks,
-  };
-}

package/src/console/gateway/Proxy.ts

@@ -1,62 +0,0 @@
-/**
- * Console 代理转发辅助。
- *
- * 关键点（中文）
- * - 负责把 `/api/*` 请求转发到选中 agent。
- * - 保持最小职责，不参与 agent 选择逻辑。
- */
-
-/**
- * 构造上游请求地址。
- */
-export function buildConsoleUpstreamUrl(
-  requestUrl: URL,
-  baseUrl: string,
-): string {
-  const upstreamPath = new URL(requestUrl.pathname + requestUrl.search, baseUrl);
-  upstreamPath.searchParams.delete("agent");
-  return upstreamPath.toString();
-}
-
-/**
- * 转发请求到目标 runtime。
- */
-export async function forwardConsoleRequest(
-  request: Request,
-  upstreamUrl: string,
-): Promise<Response> {
-  const method = request.method || "GET";
-  const headers = new Headers();
-  for (const [key, value] of request.headers.entries()) {
-    const lower = key.toLowerCase();
-    if (
-      lower === "host" ||
-      lower === "content-length" ||
-      lower === "x-city-agent"
-    ) {
-      continue;
-    }
-    headers.set(key, value);
-  }
-
-  const body =
-    method === "GET" || method === "HEAD"
-      ? undefined
-      : Buffer.from(await request.arrayBuffer());
-
-  const response = await fetch(upstreamUrl, {
-    method,
-    headers,
-    body,
-  });
-  const buffer = Buffer.from(await response.arrayBuffer());
-  const outHeaders = new Headers();
-  outHeaders.set(
-    "content-type",
-    response.headers.get("content-type") || "application/octet-stream",
-  );
-  return new Response(buffer, {
-    status: response.status,
-    headers: outHeaders,
-  });
-}

package/src/constants/DowncitySchema.ts

@@ -1,377 +0,0 @@
-import type { JsonObject } from "@downcity/agent/shared/types/Json.js";
-
-export const DOWNCITY_JSON_SCHEMA: JsonObject = {
-  $schema: "https://json-schema.org/draft/2020-12/schema",
-  $id: "https://downcity.ai/schemas/downcity.schema.json",
-  title: "Downcity downcity.json",
-  type: "object",
-  additionalProperties: true,
-  properties: {
-    $schema: {
-      type: "string",
-      description:
-        "JSON Schema reference for editor/IDE validation (e.g. ./.downcity/schema/downcity.schema.json).",
-    },
-    name: { type: "string" },
-    version: { type: "string" },
-    description: { type: "string" },
-    start: {
-      type: "object",
-      additionalProperties: true,
-      properties: {
-        port: { type: "integer", minimum: 1, maximum: 65535 },
-        host: { type: "string" },
-      },
-    },
-    execution: {
-      type: "object",
-      additionalProperties: true,
-      properties: {
-        type: {
-          type: "string",
-          enum: ["api", "acp", "local"],
-        },
-        modelId: {
-          type: "string",
-          description:
-            "API 执行模式下绑定的 console 全局模型 ID。",
-        },
-        agent: {
-          type: "object",
-          additionalProperties: true,
-          properties: {
-            type: {
-              type: "string",
-              enum: ["codex", "claude", "kimi"],
-            },
-            command: { type: "string" },
-            args: {
-              type: "array",
-              items: { type: "string" },
-            },
-            env: {
-              type: "object",
-              additionalProperties: { type: "string" },
-            },
-          },
-          required: ["type"],
-        },
-        local: {
-          type: "null",
-          description:
-            "本地执行模式不再从 execution.local 读取配置；请改为使用 plugins.lmp。",
-        },
-      },
-      required: ["type"],
-      allOf: [
-        {
-          if: {
-            properties: {
-              type: { const: "api" },
-            },
-          },
-          then: {
-            required: ["modelId"],
-          },
-        },
-        {
-          if: {
-            properties: {
-              type: { const: "acp" },
-            },
-          },
-          then: {
-            required: ["agent"],
-          },
-        },
-        {
-          if: {
-            properties: {
-              type: { const: "local" },
-            },
-          },
-          then: true,
-        },
-      ],
-    },
-    sandbox: {
-      type: "object",
-      additionalProperties: true,
-      description:
-        "Shell / CLI sandbox boundary configuration for local command execution. Sandbox is always required for shell execution.",
-      properties: {
-        envAllowlist: {
-          type: "array",
-          description:
-            "Environment variable names that may be exported into the sandbox.",
-          items: { type: "string" },
-        },
-        writablePaths: {
-          type: "array",
-          description:
-            "Writable paths, absolute or relative to the project root.",
-          items: { type: "string" },
-        },
-        networkMode: {
-          type: "string",
-          enum: ["off", "restricted", "full"],
-          description:
-            "Network boundary for sandboxed shell execution.",
-        },
-      },
-    },
-    services: {
-      type: "object",
-      additionalProperties: true,
-      properties: {
-        skills: {
-          type: "object",
-          additionalProperties: true,
-          properties: {
-            paths: { type: "array", items: { type: "string" } },
-            allowExternalPaths: { type: "boolean" },
-          },
-        },
-        chat: {
-          type: "object",
-          additionalProperties: true,
-          properties: {
-            queue: {
-              type: "object",
-              additionalProperties: true,
-              properties: {
-                maxConcurrency: { type: "integer", minimum: 1, maximum: 32 },
-                mergeDebounceMs: { type: "integer", minimum: 0, maximum: 60000 },
-                mergeMaxWaitMs: { type: "integer", minimum: 0, maximum: 120000 },
-              },
-            },
-            egress: {
-              type: "object",
-              additionalProperties: true,
-              properties: {
-                chatSendMaxCallsPerRun: { type: "integer", minimum: 1, maximum: 500 },
-                chatSendIdempotency: { type: "boolean" },
-              },
-            },
-            channels: {
-              type: "object",
-              additionalProperties: true,
-              description:
-                "Chat platform channels (Telegram / Feishu / QQ...).",
-              properties: {
-                telegram: {
-                  type: "object",
-                  additionalProperties: true,
-                  properties: {
-                    enabled: { type: "boolean" },
-                    channelAccountId: { type: "string" },
-                  },
-                },
-                feishu: {
-                  type: "object",
-                  additionalProperties: true,
-                  properties: {
-                    enabled: { type: "boolean" },
-                    channelAccountId: { type: "string" },
-                  },
-                },
-                qq: {
-                  type: "object",
-                  additionalProperties: true,
-                  properties: {
-                    enabled: { type: "boolean" },
-                    channelAccountId: { type: "string" },
-                  },
-                },
-              },
-            },
-          },
-        },
-      },
-    },
-    plugins: {
-      type: "object",
-      additionalProperties: true,
-      properties: {
-        asr: {
-          type: "object",
-          additionalProperties: true,
-          properties: {
-            injectPrompt: { type: "boolean" },
-            augmentMessage: { type: "boolean" },
-            provider: { type: "string", enum: ["local", "command"] },
-            modelId: {
-              type: "string",
-              enum: [
-                "SenseVoiceSmall",
-                "paraformer-zh-streaming",
-                "whisper-large-v3-turbo",
-              ],
-            },
-            modelsDir: { type: "string" },
-            pythonBin: { type: "string" },
-            command: { type: "string" },
-            language: { type: "string" },
-            timeoutMs: { type: "integer", minimum: 1000, maximum: 600000 },
-            strategy: {
-              type: "string",
-              enum: ["auto", "funasr", "transformers-whisper", "command"],
-            },
-            installedModels: {
-              type: "array",
-              items: {
-                type: "string",
-                enum: [
-                  "SenseVoiceSmall",
-                  "paraformer-zh-streaming",
-                  "whisper-large-v3-turbo",
-                ],
-              },
-            },
-          },
-        },
-        tts: {
-          type: "object",
-          additionalProperties: true,
-          properties: {
-            provider: {
-              type: "string",
-              enum: ["local"],
-            },
-            modelId: {
-              type: "string",
-              enum: ["qwen3-tts-0.6b", "kokoro-82m", "qwen3-tts-1.7b"],
-            },
-            modelsDir: { type: "string" },
-            pythonBin: { type: "string" },
-            language: { type: "string" },
-            voice: { type: "string" },
-            format: {
-              type: "string",
-              enum: ["wav", "flac"],
-            },
-            speed: { type: "number", minimum: 0.5, maximum: 2 },
-            outputDir: { type: "string" },
-            timeoutMs: { type: "integer", minimum: 5000, maximum: 900000 },
-            installedModels: {
-              type: "array",
-              items: {
-                type: "string",
-                enum: ["qwen3-tts-0.6b", "kokoro-82m", "qwen3-tts-1.7b"],
-              },
-            },
-          },
-        },
-        lmp: {
-          type: "object",
-          additionalProperties: true,
-          properties: {
-            provider: {
-              type: "string",
-              enum: ["llama"],
-            },
-            model: {
-              type: "string",
-              description:
-                "当前激活的本地模型文件名或绝对路径；相对路径默认相对 plugins.lmp.modelsDir。",
-            },
-            modelsDir: {
-              type: "string",
-              description: "本地模型目录，默认 ~/.models。",
-            },
-            command: {
-              type: "string",
-              description: "llama-server 可执行命令，默认 llama-server。",
-            },
-            args: {
-              type: "array",
-              items: { type: "string" },
-            },
-            host: { type: "string" },
-            port: { type: "integer", minimum: 1, maximum: 65535 },
-            contextSize: { type: "integer", minimum: 512, maximum: 1048576 },
-            gpuLayers: { type: "integer", minimum: -1, maximum: 65535 },
-            autoStart: { type: "boolean" },
-            installedModels: {
-              type: "array",
-              items: {
-                type: "string",
-              },
-            },
-          },
-        },
-      },
-    },
-    llm: {
-      type: "object",
-      additionalProperties: true,
-      properties: {
-        providers: {
-          type: "object",
-          additionalProperties: {
-            type: "object",
-            additionalProperties: true,
-            properties: {
-              type: {
-                type: "string",
-                enum: [
-                  "anthropic",
-                  "openai",
-                  "deepseek",
-                  "gemini",
-                  "open-compatible",
-                  "open-responses",
-                  "moonshot-cn",
-                  "moonshot-ai",
-                  "kimi-code",
-                  "xai",
-                  "huggingface",
-                  "openrouter",
-                ],
-              },
-              baseUrl: { type: "string" },
-              apiKey: { type: "string" },
-            },
-            required: ["type"],
-          },
-        },
-        models: {
-          type: "object",
-          additionalProperties: {
-            type: "object",
-            additionalProperties: true,
-            properties: {
-              provider: { type: "string" },
-              name: { type: "string" },
-              temperature: { type: "number" },
-              maxTokens: { type: "number" },
-              topP: { type: "number" },
-              frequencyPenalty: { type: "number" },
-              presencePenalty: { type: "number" },
-              anthropicVersion: { type: "string" },
-            },
-            required: ["provider", "name"],
-          },
-        },
-        logMessages: { type: "boolean" },
-      },
-      required: ["providers", "models"],
-    },
-    context: {
-      type: "object",
-      additionalProperties: true,
-      properties: {
-        messages: {
-          type: "object",
-          additionalProperties: true,
-          properties: {
-            keepLastMessages: { type: "integer", minimum: 6, maximum: 5000 },
-            maxInputTokensApprox: { type: "integer", minimum: 2000, maximum: 200000 },
-            archiveOnCompact: { type: "boolean" },
-            compactRatio: { type: "number", minimum: 0.1, maximum: 0.9 },
-          },
-        },
-      },
-    },
-  },
-};

package/src/daemon/Api.ts

@@ -1,64 +0,0 @@
-/**
- * Daemon API 协议类型模块。
- *
- * 关键点（中文）
- * - 这里描述的是 CLI 与 agent daemon 之间的远程访问契约，不包含具体 HTTP 实现。
- * - service 等上层模块只依赖这些协议类型，不需要感知 city/daemon 的内部实现细节。
- * - 该文件属于 `main/city/daemon/*` 的协议边界，而不是通用 HTTP 类型目录。
- */
-
-import type { JsonValue } from "@downcity/agent/shared/types/Json.js";
-
-/**
- * Daemon 服务端点。
- */
-export type DaemonEndpoint = {
-  host: string;
-  port: number;
-  baseUrl: string;
-};
-
-/**
- * Daemon HTTP 方法白名单。
- */
-export type DaemonHttpMethod = "GET" | "POST" | "PUT" | "DELETE";
-
-/**
- * JSON API 调用参数。
- *
- * 关键点（中文）
- * - `projectRoot` 用于解析 downcity.json 与默认 endpoint。
- * - `host/port` 可显式覆盖自动解析结果。
- */
-export type DaemonJsonApiCallParams = {
-  projectRoot: string;
-  path: string;
-  method?: DaemonHttpMethod;
-  body?: JsonValue;
-  /**
-   * 单次调用超时（毫秒）。
-   *
-   * 说明（中文）
-   * - 仅本地 IPC transport 当前会消费该参数。
-   * - 用于 `session execute`、`service command` 这类可能持续几十秒的请求，
-   *   避免被默认短超时误判成“Agent server 未启动”。
-   */
-  timeoutMs?: number;
-  host?: string;
-  port?: number;
-  authToken?: string;
-};
-
-/**
- * JSON API 通用返回结构。
- *
- * 语义（中文）
- * - `success=true` 时读取 `data`。
- * - `success=false` 时读取 `error`（可选 `status`）。
- */
-export type DaemonJsonApiCallResult<T> = {
-  success: boolean;
-  status?: number;
-  data?: T;
-  error?: string;
-};

package/src/daemon/CliArgs.ts

@@ -1,39 +0,0 @@
-/**
- * 负责把 commander 解析到的 options 转换成子进程 CLI 参数。
- *
- * 关键点
- * - daemon（来自 `agent start` / `agent restart`）会拉起一个前台 `agent start`
- *   进程（显式 `--foreground true`），这里负责拼装其 argv。
- */
-
-import type { StartOptions } from "@downcity/agent/shared/types/Start.js";
-import { allocateAvailablePort } from "@/daemon/PortAllocator.js";
-
-/**
- * 将 daemon 选项转换为 `agent start` 子进程 argv。
- *
- * 关键点（中文）
- * - daemon 始终启动 `agent start` 前台流程，因此参数统一映射到 `agent start` CLI 形态。
- * - 只透传用户显式传入的字段，避免污染默认值决策。
- */
-export const buildRunArgsFromOptions = async (
-  projectRoot: string,
-  options: StartOptions,
-): Promise<string[]> => {
-  // 关键点（中文）：daemon 子进程必须强制前台模式，避免再次进入 startCommand 形成递归拉起。
-  const args: string[] = ["agent", "start", projectRoot, "--foreground", "true"];
-
-  // 关键点（中文）：host 未指定时统一落到 0.0.0.0，保持历史监听行为。
-  const host = String(options.host || "0.0.0.0").trim() || "0.0.0.0";
-
-  // 关键点（中文）：agent 端口统一由 console 分配，不接受命令行显式覆盖。
-  const port = await allocateAvailablePort({ host });
-  if (!Number.isFinite(port) || Number.isNaN(port) || port <= 0 || port > 65535) {
-    throw new Error(`Invalid allocated port: ${String(port)}`);
-  }
-
-  args.push("--port", String(port));
-  args.push("--host", host);
-
-  return args;
-};