@downcity/city 1.1.4 → 1.1.5

package/README.md

@@ -0,0 +1,245 @@
+# @downcity/city
+
+`@downcity/city` 是 Downcity 的平台层与多 Agent 宿主管理包。
+
+它负责 CLI、控制面、city runtime 进程管理、全局配置存储，以及多个 agent 的注册与调度。  
+它依赖 `@downcity/agent` 提供单 Agent runtime、service、plugin、control API、sandbox 与执行能力，但不重复实现这些内核。
+
+## 包定位
+
+- 面向平台层和宿主管理层。
+- 管理多个 Agent 项目与后台进程。
+- 提供控制面 gateway / control plane。
+- 提供全局模型池、全局环境变量、全局 chat channel account 存储。
+
+## 与其他包的边界
+
+- `@downcity/city`
+  - 多 Agent 管理。
+  - 平台 CLI。
+  - 控制面 gateway / control plane。
+  - city 级全局 store。
+
+- `@downcity/agent`
+  - 单 Agent runtime。
+  - 单 Agent control API。
+  - service / plugin / sandbox / tool loop / session 执行。
+
+- `@downcity/ui`
+  - React UI 组件与前端展示层。
+
+## 根目录结构
+
+```text
+packages/city
+├── bin/                # 编译输出目录，CLI 实际执行入口
+├── public/             # 控制面前端静态资源
+├── scripts/            # 构建和发布辅助脚本
+├── src/                # 源码目录
+├── package.json        # 包信息、CLI bin、脚本
+└── tsconfig.json       # TypeScript 配置
+```
+
+## 源码结构树
+
+```text
+src
+├── cli/
+│   ├── agent/
+│   ├── control-plane/
+│   ├── model/
+│   │   └── preset/
+│   ├── service/
+│   ├── shared/
+│   └── Index.ts
+├── config/
+├── control/
+│   ├── instant/
+│   └── gateway/
+├── http/
+│   └── auth/
+├── process/
+│   ├── daemon/
+│   ├── registry/
+│   └── rpc/
+├── types/
+│   ├── chat/
+│   ├── contact/
+│   └── task/
+└── utils/
+    └── cli/
+```
+
+## 目录职责
+
+- `src/cli/`
+  - CLI 命令实现与装配。
+  - 已按子域拆分，避免扁平堆积。
+
+- `src/cli/agent/`
+  - `city agent ...` 命令。
+  - 包括 agent create、start、stop、restart、status、chat、history、交互式 manager。
+
+- `src/cli/control-plane/`
+  - `city` 顶层 runtime 命令与 `city console ...` 命令。
+  - 这层语义是 control plane / gateway 宿主管理，而不是单 Agent API。
+
+- `src/cli/model/`
+  - `city model ...` 命令。
+  - 面向 city 全局模型池的 CLI 管理。
+
+- `src/cli/model/preset/`
+  - city 侧模型预设目录。
+  - 只保留命令交互需要的预设定义，不再复制全局 store 实现。
+
+- `src/cli/service/`
+  - `city service ...` 与服务 action 命令桥接。
+  - 负责把 CLI 命令转发到单 Agent runtime。
+
+- `src/cli/shared/`
+  - 多个 CLI 子域共用的基础能力。
+  - 包括 reporter、错误类型、env、token、plugin、chat manager、命令参数辅助等。
+
+- `src/config/`
+  - city 自己的静态配置结构。
+  - 包括路径规则、schema 常量。
+
+- `src/control/`
+  - 平台控制面 HTTP gateway。
+  - 负责聚合多 Agent 视图、控制动作、前端资源、模型池与 channel account API。
+  - 这是 gateway / control plane，不是单 Agent control API。
+
+- `src/control/instant/`
+  - control plane 下的即时执行子域。
+  - 放置 instant-run 路由、临时 session service 和即时 system composer。
+
+- `src/control/gateway/`
+  - gateway 的读写辅助模块。
+  - 包括 agent catalog、agent actions、proxy、frontend assets 等。
+
+## 命名说明
+
+- `city/cli/control-plane`
+  - 这里承载 city gateway / control plane 的命令面与进程管理面。
+  - CLI 命令对用户仍保留 `city console`，但源码结构已经按 control plane 语义命名。
+
+- `city/control`
+  - 这里承载的是多 agent 聚合控制面，不是单 agent control API。
+
+- `@downcity/agent/http/control`
+  - 这里承载的是 single-agent control API。
+  - 当前统一路径是 `/api/control/*`。
+
+- `src/http/auth/`
+  - city 控制面自己的鉴权体系。
+  - 包括 token、middleware、route policy、store。
+
+- `src/process/`
+  - city runtime 进程侧能力。
+  - 统一承接 daemon、registry、local rpc，不再散落在顶层目录。
+
+- `src/process/daemon/`
+  - Agent daemon 的 pid/log/meta/启停管理。
+  - 负责后台拉起 agent 前台进程。
+
+- `src/process/registry/`
+  - city runtime 与多 Agent registry 状态。
+  - 记录哪些 agent 已登记、哪些 daemon 正在运行、Console/city pid 路径等。
+
+- `src/process/rpc/`
+  - city 侧 local RPC 客户端辅助。
+  - 用于本机调用 Agent 暴露的 IPC 接口。
+
+- `src/types/`
+  - 当前仅保留尚未进一步归位的领域类型。
+  - 目前主要是 `chat / contact / task` 三组。
+  - CLI、store、city 自己的高频类型已经贴回对应模块邻近位置。
+
+- `src/utils/`
+  - 平台层通用工具。
+
+- `src/utils/cli/`
+  - CLI 输出、spinner 等命令行体验辅助。
+
+## 关键调用关系
+
+### 1. CLI 主入口
+
+```text
+src/cli/Index.ts
+  -> control-plane/
+  -> agent/
+  -> model/
+  -> service/
+  -> shared/
+```
+
+### 2. 启动 city runtime 与 Console
+
+```text
+city start
+  -> src/cli/control-plane/ControlPlaneCommand.ts
+  -> src/cli/control-plane/ControlPlaneProcess.ts
+  -> src/process/registry/*
+  -> src/control/ControlGateway.ts
+```
+
+### 3. 启动 Agent daemon
+
+```text
+city agent start
+  -> src/cli/agent/Start.ts
+  -> src/process/daemon/Manager.ts
+  -> detached child process
+  -> @downcity/agent runtime
+```
+
+### 4. 控制面读写 Agent
+
+```text
+browser / UI
+  -> src/control/ControlGateway.ts
+  -> src/control/gateway/*
+  -> src/process/registry/*
+  -> 转发到单 Agent HTTP / RPC
+```
+
+### 5. 全局模型池
+
+```text
+city model ...
+  -> src/cli/model/*
+  -> @downcity/agent PlatformStore
+  -> src/cli/model/preset/*
+```
+
+## 当前最重要的入口文件
+
+- `src/cli/Index.ts`
+  - CLI 主入口。
+
+- `src/cli/control-plane/ControlPlaneCommand.ts`
+  - 顶层 city / control plane 命令装配。
+
+- `src/cli/shared/IndexAgentCommand.ts`
+  - `city agent` 命令树装配。
+
+- `src/control/ControlGateway.ts`
+  - 平台控制面 gateway 主入口。
+
+- `src/process/daemon/Manager.ts`
+  - agent daemon 生命周期管理核心。
+
+- `src/process/registry/CityRegistry.ts`
+  - 多 Agent registry 核心。
+
+## 维护约定
+
+- 不要把单 Agent 执行逻辑重新实现到这个包里。
+- sandbox、tool loop、session 执行、service 内核统一来自 `@downcity/agent`。
+- 全局 store 也统一来自 `@downcity/agent`，不要在 city 再复制一份持久化实现。
+- `control/` 是平台 gateway / control plane。
+- 单 Agent 的 HTTP control API 语义应该留在 `@downcity/agent`。
+- `process/` 统一放 city 的进程管理、registry、RPC，不要再散落回顶层。
+- `config/` 只放静态配置/schema/路径，不混入运行时 store 逻辑。
+- CLI 类型、store 类型、city 自有小类型优先就近放在对应模块旁边。

package/bin/cli/Index.js

@@ -11,17 +11,17 @@ import { readFileSync } from "fs";
 import { basename, dirname, join } from "path";
 import { fileURLToPath } from "url";
 import { Command, Option } from "commander";
-import { registerAllPluginsForCli } from "@downcity/agent/plugin/PluginCommand.js";
-import { registerServicesCommand } from "./Services.js";
-import { registerPluginsCommand } from "./Plugins.js";
-import { registerAllServicesForCli } from "./ServiceActionCommands.js";
-import { registerConsoleCommands } from "./IndexConsoleCommand.js";
-import { registerAgentCommands } from "./IndexAgentCommand.js";
-import { registerEnvCommand } from "./Env.js";
-import { registerTokenCommand } from "./Token.js";
-import { registerResetCommand } from "./Reset.js";
-import { registerChatCommand } from "./Chat.js";
-import { setCliVerbosity } from "./CliReporter.js";
+import { registerAllPluginsForCli } from "@downcity/agent";
+import { registerServicesCommand } from "./service/Services.js";
+import { registerPluginsCommand } from "./shared/Plugins.js";
+import { registerAllServicesForCli } from "./service/ServiceActionCommands.js";
+import { registerControlPlaneCommands } from "./control-plane/ControlPlaneCommand.js";
+import { registerAgentCommands } from "./shared/IndexAgentCommand.js";
+import { registerEnvCommand } from "./shared/Env.js";
+import { registerTokenCommand } from "./shared/Token.js";
+import { registerResetCommand } from "./shared/Reset.js";
+import { registerChatCommand } from "./shared/Chat.js";
+import { setCliVerbosity } from "./shared/CliReporter.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const cliPath = join(__dirname, "./Index.js");
@@ -34,7 +34,7 @@ program
 program.helpOption("--help", "display help for command");
 program.option("-q, --quiet", "仅输出错误信息");
 program.option("--verbose", "输出详细进度");
-registerConsoleCommands(program, {
+registerControlPlaneCommands(program, {
     version: packageJson.version,
     cliPath,
 });

package/bin/cli/Index.js.map

@@ -1 +1 @@
-{"version":3,"file":"Index.js","sourceRoot":"","sources":["../../src/cli/Index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Index.js","sourceRoot":"","sources":["../../src/cli/Index.ts"],"names":[],"mappings":"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"}

package/bin/cli/agent/AgentChat.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `city agent chat` 命令实现。
+ *
+ * 关键点（中文）
+ * - 统一覆盖交互式持续对话与一次性消息模式，不再保留独立 `quest` 命令。
+ * - 目标 agent 始终按 managed agent registry 名称解析，不依赖当前工作目录。
+ * - 默认使用独立 local-cli 主会话：`local-cli-chat-main`。
+ */
+import type { AgentChatCliOptions, AgentChatExecutionOutcome, AgentChatTransportOptions } from "./AgentChatTypes.js";
+/**
+ * 向目标 agent 的 Console 主会话发送一轮消息。
+ */
+export declare function executeAgentChatTurn(params: {
+    agentName: string;
+    message: string;
+    transport?: AgentChatTransportOptions;
+}): Promise<AgentChatExecutionOutcome>;
+/**
+ * `city agent chat` 统一入口。
+ */
+export declare function chatCommand(options: AgentChatCliOptions): Promise<void>;
+//# sourceMappingURL=AgentChat.d.ts.map

package/bin/cli/agent/AgentChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentChat.d.ts","sourceRoot":"","sources":["../../../src/cli/agent/AgentChat.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmBH,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EAEzB,yBAAyB,EAC1B,MAAM,qBAAqB,CAAC;AAkG7B;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,yBAAyB,CAAC;CACvC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAiFrC;AA8JD;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC7E"}

package/bin/cli/agent/AgentChat.js

@@ -0,0 +1,357 @@
+/**
+ * `city agent chat` 命令实现。
+ *
+ * 关键点（中文）
+ * - 统一覆盖交互式持续对话与一次性消息模式，不再保留独立 `quest` 命令。
+ * - 目标 agent 始终按 managed agent registry 名称解析，不依赖当前工作目录。
+ * - 默认使用独立 local-cli 主会话：`local-cli-chat-main`。
+ */
+import { createInterface } from "node:readline/promises";
+import chalk from "chalk";
+import prompts from "prompts";
+import { callAgentTransport } from "@downcity/agent";
+import { emitCliBlock } from "../shared/CliReporter.js";
+import { runWithSpinner, } from "../../utils/cli/Spinner.js";
+import { printResult } from "../../utils/cli/CliOutput.js";
+import { resolveProjectRootByAgentName, validateAgentProjectRoot, } from "../service/ServiceCommandSupport.js";
+import { listRegisteredAgentsForCli } from "./AgentSelection.js";
+import { AGENT_CHAT_DEFAULT_SESSION_ID } from "./AgentChatTypes.js";
+const AGENT_CHAT_EXECUTE_TIMEOUT_MS = 120_000;
+function normalizeChatMessage(input) {
+    return String(input || "").trim();
+}
+function isChatSuccess(payload) {
+    if (!payload || payload.success !== true)
+        return false;
+    if (payload.result?.success === false)
+        return false;
+    return true;
+}
+async function resolveChatTargetAgentName(inputName) {
+    const explicit = String(inputName || "").trim();
+    if (explicit)
+        return explicit;
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        emitCliBlock({
+            tone: "error",
+            title: "Agent name is required",
+            note: "Use `city agent chat --to <agentName>` or run this command in an interactive terminal.",
+        });
+        return null;
+    }
+    const runningAgents = (await listRegisteredAgentsForCli()).filter((item) => item.status === "running");
+    if (runningAgents.length === 0) {
+        emitCliBlock({
+            tone: "error",
+            title: "No running agents",
+            note: "Run `city agent start` first.",
+        });
+        return null;
+    }
+    const response = (await prompts({
+        type: "select",
+        name: "agentName",
+        message: "选择要聊天的 Agent",
+        choices: runningAgents.map((agent) => ({
+            title: agent.name,
+            description: agent.projectRoot,
+            value: agent.name,
+        })),
+        initial: 0,
+    }));
+    const agentName = String(response.agentName || "").trim();
+    if (!agentName) {
+        emitCliBlock({
+            tone: "info",
+            title: "Agent chat cancelled",
+        });
+        return null;
+    }
+    return agentName;
+}
+function printAssistantReply(replyText) {
+    const text = String(replyText || "").trim();
+    if (!text) {
+        emitCliBlock({
+            tone: "info",
+            title: "No visible reply",
+            note: "The turn completed, but no user-visible text was returned.",
+        });
+        return;
+    }
+    console.log(`\n${text}\n`);
+}
+function printQueuedResult(params) {
+    emitCliBlock({
+        tone: "info",
+        title: "Turn queued",
+        facts: [
+            {
+                label: "agent",
+                value: params.agentName,
+            },
+            ...(params.payload.result?.queueItemId
+                ? [
+                    {
+                        label: "queue item",
+                        value: params.payload.result.queueItemId,
+                    },
+                ]
+                : []),
+        ],
+    });
+}
+/**
+ * 向目标 agent 的 Console 主会话发送一轮消息。
+ */
+export async function executeAgentChatTurn(params) {
+    const agentName = String(params.agentName || "").trim();
+    const message = normalizeChatMessage(params.message);
+    const sessionId = AGENT_CHAT_DEFAULT_SESSION_ID;
+    if (!agentName) {
+        return {
+            agentName: "",
+            sessionId,
+            success: false,
+            error: "Missing target agent name.",
+        };
+    }
+    if (!message) {
+        return {
+            agentName,
+            sessionId,
+            success: false,
+            error: "Chat message is required.",
+        };
+    }
+    const resolved = await resolveProjectRootByAgentName(agentName);
+    if (!resolved.projectRoot) {
+        return {
+            agentName,
+            sessionId,
+            success: false,
+            error: resolved.error || "Failed to resolve agent project path",
+        };
+    }
+    const pathError = validateAgentProjectRoot(resolved.projectRoot);
+    if (pathError) {
+        return {
+            agentName,
+            projectRoot: resolved.projectRoot,
+            sessionId,
+            success: false,
+            error: pathError,
+        };
+    }
+    const remote = await callAgentTransport({
+        projectRoot: resolved.projectRoot,
+        path: `/api/control/sessions/${encodeURIComponent(sessionId)}/execute`,
+        method: "POST",
+        timeoutMs: AGENT_CHAT_EXECUTE_TIMEOUT_MS,
+        host: params.transport?.host,
+        port: params.transport?.port,
+        authToken: params.transport?.token,
+        body: {
+            instructions: message,
+        },
+    });
+    if (!remote.success || !remote.data) {
+        return {
+            agentName,
+            projectRoot: resolved.projectRoot,
+            sessionId,
+            success: false,
+            error: remote.error || "Agent daemon unreachable or returned empty error (try `city agent restart`)",
+        };
+    }
+    return {
+        agentName,
+        projectRoot: resolved.projectRoot,
+        sessionId: String(remote.data.sessionId || sessionId),
+        success: isChatSuccess(remote.data),
+        payload: remote.data,
+        ...(isChatSuccess(remote.data)
+            ? {}
+            : {
+                error: String(remote.data.result?.error || remote.data.error || "").trim() ||
+                    "Daemon error (check `city agent status` and `city agent doctor`)",
+            }),
+    };
+}
+async function runOneShotChat(params) {
+    const outcome = await runWithSpinner(async () => {
+        return await executeAgentChatTurn({
+            agentName: params.agentName,
+            message: params.message,
+            transport: {
+                host: params.options.host,
+                port: params.options.port,
+                token: params.options.token,
+            },
+        });
+    }, {
+        text: `${params.agentName} is replying...`,
+        disabled: params.options.json === true,
+    });
+    if (params.options.json === true) {
+        printResult({
+            asJson: true,
+            success: outcome.success,
+            title: "agent chat",
+            payload: {
+                agent: params.agentName,
+                ...(outcome.projectRoot ? { projectRoot: outcome.projectRoot } : {}),
+                sessionId: outcome.sessionId,
+                ...(outcome.payload?.result ? { result: outcome.payload.result } : {}),
+                ...(outcome.error ? { error: outcome.error } : {}),
+            },
+        });
+        return;
+    }
+    if (!outcome.success || !outcome.payload) {
+        emitCliBlock({
+            tone: "error",
+            title: "Agent chat failed",
+            facts: [
+                {
+                    label: "agent",
+                    value: params.agentName,
+                },
+                {
+                    label: "error",
+                    value: outcome.error || "Agent daemon returned empty error (check config with `city agent status`)",
+                },
+            ],
+        });
+        return;
+    }
+    if (outcome.payload.result?.queued === true) {
+        printQueuedResult({
+            agentName: params.agentName,
+            payload: outcome.payload,
+        });
+        return;
+    }
+    printAssistantReply(String(outcome.payload.result?.userVisible || ""));
+}
+/**
+ * 启动交互式持续对话。
+ */
+async function runInteractiveChat(params) {
+    const prompt = `${chalk.cyan(params.agentName)} ${chalk.dim("›")} `;
+    const helpText = [
+        `${chalk.dim("/exit, /quit  — 退出对话")}`,
+        `${chalk.dim("/clear       — 清屏")}`,
+        `${chalk.dim("/help        — 显示此帮助")}`,
+        `${chalk.dim("Ctrl+C       — 退出对话")}`,
+    ];
+    emitCliBlock({
+        tone: "info",
+        title: `Agent chat · ${params.agentName}`,
+        note: `Session: local-cli-chat-main · ${helpText[0].replace(chalk.dim(""), "").trim()}`,
+    });
+    console.log(helpText.join("\n"));
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        terminal: true,
+    });
+    try {
+        while (true) {
+            const line = await rl.question(prompt);
+            const text = normalizeChatMessage(line);
+            if (!text)
+                continue;
+            if (text === "/exit" || text === "/quit")
+                break;
+            if (text === "/clear") {
+                console.clear();
+                continue;
+            }
+            if (text === "/help") {
+                console.log(helpText.join("\n"));
+                continue;
+            }
+            const outcome = await runWithSpinner(async () => {
+                return await executeAgentChatTurn({
+                    agentName: params.agentName,
+                    message: text,
+                    transport: {
+                        host: params.options.host,
+                        port: params.options.port,
+                        token: params.options.token,
+                    },
+                });
+            }, {
+                text: `${params.agentName} is replying...`,
+            });
+            if (!outcome.success || !outcome.payload) {
+                emitCliBlock({
+                    tone: "error",
+                    title: "Agent chat failed",
+                    facts: [
+                        {
+                            label: "agent",
+                            value: params.agentName,
+                        },
+                        {
+                            label: "error",
+                            value: outcome.error || "Agent daemon returned empty error (check config with `city agent status`)",
+                        },
+                    ],
+                });
+                continue;
+            }
+            if (outcome.payload.result?.queued === true) {
+                printQueuedResult({
+                    agentName: params.agentName,
+                    payload: outcome.payload,
+                });
+                continue;
+            }
+            printAssistantReply(String(outcome.payload.result?.userVisible || ""));
+        }
+    }
+    finally {
+        rl.close();
+    }
+    console.log(chalk.dim("Chat ended."));
+}
+/**
+ * `city agent chat` 统一入口。
+ */
+export async function chatCommand(options) {
+    const agentName = await resolveChatTargetAgentName(options.to);
+    if (!agentName)
+        return;
+    const oneShotMessage = normalizeChatMessage(String(options.message || ""));
+    if (oneShotMessage) {
+        await runOneShotChat({
+            agentName,
+            message: oneShotMessage,
+            options,
+        });
+        return;
+    }
+    if (options.json === true) {
+        emitCliBlock({
+            tone: "error",
+            title: "JSON mode requires --message",
+            note: "Use `city agent chat --message <text> --json` for one-shot structured output.",
+        });
+        return;
+    }
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        emitCliBlock({
+            tone: "error",
+            title: "Interactive terminal required",
+            note: "Use this command in a local terminal with TTY support, or pass `--message` for one-shot mode.",
+        });
+        return;
+    }
+    await runInteractiveChat({
+        agentName,
+        options,
+    });
+}
+//# sourceMappingURL=AgentChat.js.map