downcity 1.0.523 → 1.1.24

package/README.md

@@ -1,146 +1,263 @@
-# downcity
+# @downcity/city
 
-## install
+`@downcity/city` 是 Downcity 的平台层与多 Agent 宿主管理包。
 
-```bash
-npm install -g downcity
-city -v
-downcity -v
-```
+它负责 CLI、控制面、city runtime 进程管理、全局配置存储，以及多个 agent 的注册与调度。  
+它依赖 `@downcity/agent` 提供单 Agent runtime、service、plugin、control API、sandbox 与执行能力，但不重复实现这些内核。
 
-> `city` 与 `downcity` 指向同一个 CLI。
+## 包定位
 
-upgrade:
+- 面向平台层和宿主管理层。
+- 管理多个 Agent 项目与后台进程。
+- 提供控制面 gateway / control plane。
+- 提供全局模型池、模型实例创建、全局环境变量、全局 chat channel account 存储。
 
-```bash
-city update
-```
+## 与其他包的边界
 
-## quick start
+- `@downcity/city`
+  - 多 Agent 管理。
+  - 平台 CLI。
+  - 控制面 gateway / control plane。
+  - 全局模型池与 city 宿主侧模型工厂。
+  - city 级全局 store。
 
-### 1. initialize console
+- `@downcity/agent`
+  - 单 Agent runtime。
+  - 单 Agent control API。
+  - service / plugin / sandbox / tool loop / session 执行。
 
-```bash
-city init
-city start
-```
+- `@downcity/ui`
+  - React UI 组件与前端展示层。
 
-### 2. initialize agent project
+## 根目录结构
 
-```bash
-cd /path/to/your-repo
-city agent create .
+```text
+packages/city
+├── bin/                # 编译输出目录，CLI 实际执行入口
+├── public/             # 控制面前端静态资源
+├── scripts/            # 构建和发布辅助脚本
+├── src/                # 源码目录
+├── package.json        # 包信息、CLI bin、脚本
+└── tsconfig.json       # TypeScript 配置
 ```
 
-### 3. configure model
+## 源码结构树
+
+```text
+src
+├── cli/
+│   ├── agent/
+│   ├── control-plane/
+│   ├── model/
+│   │   └── preset/
+│   ├── service/
+│   ├── shared/
+│   └── Index.ts
+├── config/
+├── control/
+│   ├── instant/
+│   └── gateway/
+├── http/
+│   └── auth/
+├── model/
+│   └── runtime/
+├── platform/
+│   └── store/
+├── process/
+│   ├── daemon/
+│   ├── registry/
+│   └── rpc/
+├── types/
+│   ├── chat/
+│   ├── contact/
+│   └── task/
+└── utils/
+    └── cli/
+```
 
-Create project `.env`:
+## 目录职责
 
-```bash
-LLM_API_KEY=your_key
-```
+- `src/cli/`
+  - CLI 命令实现与装配。
+  - 已按子域拆分，避免扁平堆积。
 
-Minimal `downcity.json`:
+- `src/cli/agent/`
+  - `city agent ...` 命令。
+  - 包括 agent create、start、stop、restart、status、chat、history、交互式 manager。
 
-```json
-{
-  "name": "my-agent",
-  "version": "1.0.0",
-  "model": {
-    "primary": "default"
-  }
-}
-```
+- `src/cli/control-plane/`
+  - `city` 顶层 runtime 命令与 `city console ...` 命令。
+  - 这层语义是 control plane / gateway 宿主管理，而不是单 Agent API。
 
-### 4. start agent
+- `src/cli/model/`
+  - `city model ...` 命令。
+  - 面向 city 全局模型池的 CLI 管理。
 
-```bash
-city agent start
-```
+- `src/cli/model/preset/`
+  - city 侧模型预设目录。
+  - 只保留命令交互需要的预设定义，不再复制全局 store 实现。
 
-Debug in foreground:
+- `src/cli/service/`
+  - `city service ...` 与服务 action 命令桥接。
+  - 负责把 CLI 命令转发到单 Agent runtime。
 
-```bash
-city agent start --foreground
-```
+- `src/cli/shared/`
+  - 多个 CLI 子域共用的基础能力。
+  - 包括 reporter、错误类型、env、token、plugin、chat manager、命令参数辅助等。
 
-## verify
+- `src/config/`
+  - city 自己的静态配置结构。
+  - 包括路径规则、schema 常量。
 
-```bash
-city agent status
-city agents
-city service list
-```
+- `src/control/`
+  - 平台控制面 HTTP gateway。
+  - 负责聚合多 Agent 视图、控制动作、前端资源、模型池与 channel account API。
+  - 这是 gateway / control plane，不是单 Agent control API。
 
-## troubleshooting
+- `src/control/instant/`
+  - control plane 下的即时执行子域。
+  - 放置 instant-run 路由、临时 session service 和即时 system composer。
 
-### `city: command not found`
+- `src/control/gateway/`
+  - gateway 的读写辅助模块。
+  - 包括 agent catalog、agent actions、proxy、frontend assets 等。
 
-Check npm global prefix and PATH:
+## 命名说明
 
-```bash
-npm config get prefix
-echo $PATH
-```
+- `city/cli/control-plane`
+  - 这里承载 city gateway / control plane 的命令面与进程管理面。
+  - CLI 命令对用户仍保留 `city console`，但源码结构已经按 control plane 语义命名。
 
-If the prefix bin is not in PATH, add it:
+- `city/control`
+  - 这里承载的是多 agent 聚合控制面，不是单 agent control API。
 
-```bash
-export PATH="$(npm config get prefix)/bin:$PATH"
-```
+- `@downcity/agent` 内部的 `server/http/control`
+  - 这里承载的是 single-agent control API。
+  - 当前统一路径是 `/api/control/*`。
 
-Then reload shell:
+- `src/http/auth/`
+  - city 控制面自己的鉴权体系。
+  - 包括 token、middleware、route policy、store。
 
-```bash
-rehash
-city -v
-```
+- `src/model/runtime/`
+  - city 宿主侧 `LanguageModel` 工厂。
+  - 负责把 `downcity.json.execution.modelId` 解析成 provider/model 配置，再创建可注入 Agent session 的模型实例。
+  - `@downcity/agent` 只消费 `LanguageModel`，不再负责模型池解析。
 
-### `sudo city: command not found`
+- `src/platform/store/`
+  - city 平台持久化存储入口。
+  - 承载 provider、model、环境变量、channel account 等宿主级数据。
 
-`sudo` may use a different PATH from your user shell.
+- `src/process/`
+  - city runtime 进程侧能力。
+  - 统一承接 daemon、registry、local rpc，不再散落在顶层目录。
 
-Prefer running `city` directly. If you really need `sudo`, use:
+- `src/process/daemon/`
+  - Agent daemon 的 pid/log/meta/启停管理。
+  - 负责后台拉起 agent 前台进程。
 
-```bash
-sudo env "PATH=$(npm config get prefix)/bin:$PATH" city -v
-```
+- `src/process/registry/`
+  - city runtime 与多 Agent registry 状态。
+  - 记录哪些 agent 已登记、哪些 daemon 正在运行、Console/city pid 路径等。
+
+- `src/process/rpc/`
+  - city 侧 local RPC 客户端辅助。
+  - 用于本机调用 Agent 暴露的 IPC 接口。
 
-### `downcity` works but `city` does not
+- `src/types/`
+  - 当前仅保留尚未进一步归位的领域类型。
+  - 目前主要是 `chat / contact / task` 三组。
+  - CLI、store、city 自己的高频类型已经贴回对应模块邻近位置。
 
-Reinstall the global package or relink it:
+- `src/utils/`
+  - 平台层通用工具。
 
-```bash
-npm install -g downcity
+- `src/utils/cli/`
+  - CLI 输出、spinner 等命令行体验辅助。
+
+## 关键调用关系
+
+### 1. CLI 主入口
+
+```text
+src/cli/Index.ts
+  -> control-plane/
+  -> agent/
+  -> model/
+  -> service/
+  -> shared/
 ```
 
-For local source development:
+### 2. 启动 city runtime 与 Console
 
-```bash
-cd /path/to/downcity/packages/downcity
-npm install
-npm run build
-npm link
-rehash
-city -v
+```text
+city start
+  -> src/cli/control-plane/ControlPlaneCommand.ts
+  -> src/cli/control-plane/ControlPlaneProcess.ts
+  -> src/process/registry/*
+  -> src/control/ControlGateway.ts
 ```
 
-## api
+### 3. 启动 Agent daemon
 
-```http
-GET http://localhost:<agent-port>/health
-GET http://localhost:<agent-port>/api/status
+```text
+city agent start
+  -> src/cli/agent/Start.ts
+  -> src/process/daemon/Manager.ts
+  -> detached child process
+  -> @downcity/agent runtime
+```
 
-POST http://localhost:<agent-port>/api/execute
-Content-Type: application/json
+### 4. 控制面读写 Agent
 
-{"instructions":"Say hi"}
+```text
+browser / UI
+  -> src/control/ControlGateway.ts
+  -> src/control/gateway/*
+  -> src/process/registry/*
+  -> 转发到单 Agent HTTP / RPC
 ```
 
-Use `city agent status` or `city agents` to inspect the actual agent port.
+### 5. 全局模型池
+
+```text
+city model ...
+  -> src/cli/model/*
+  -> src/platform/store/*
+  -> src/model/runtime/CreateRuntimeModel.ts
+  -> 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 核心。
 
-## debug
+- `src/model/runtime/CreateRuntimeModel.ts`
+  - city 宿主侧模型工厂，负责把项目 `execution.modelId` 转成 session 可用的 `LanguageModel`。
 
-By default the runtime logs every LLM request payload (messages + system) to help debugging.
+## 维护约定
 
-- Disable: set `llm.logMessages=false` in `downcity.json`
+- 不要把单 Agent 执行逻辑重新实现到这个包里。
+- sandbox、tool loop、session 执行、service 内核统一来自 `@downcity/agent`。
+- 模型池、provider store 与模型创建逻辑留在 city 宿主层，不下沉回 `@downcity/agent`。
+- `control/` 是平台 gateway / control plane。
+- 单 Agent 的 HTTP control API 语义应该留在 `@downcity/agent`。
+- `process/` 统一放 city 的进程管理、registry、RPC，不要再散落回顶层。
+- `config/` 只放静态配置/schema/路径，不混入运行时 store 逻辑。
+- CLI 类型、store 类型、city 自有小类型优先就近放在对应模块旁边。

package/bin/cli/Index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * CLI 程序入口模块。
+ *
+ * 关键点（中文）
+ * - 这里只负责 CLI 基础初始化与一级命令装配，不承载具体业务逻辑。
+ * - 根命令层统一注册 city runtime、Console、agent、service、plugin 等入口模块。
+ * - 所有具体命令树都继续下沉到各自模块，避免入口文件继续膨胀。
+ */
+export {};
+//# sourceMappingURL=Index.d.ts.map

package/bin/cli/Index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Index.d.ts","sourceRoot":"","sources":["../../src/cli/Index.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG"}

package/bin/cli/Index.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+/**
+ * CLI 程序入口模块。
+ *
+ * 关键点（中文）
+ * - 这里只负责 CLI 基础初始化与一级命令装配，不承载具体业务逻辑。
+ * - 根命令层统一注册 city runtime、Console、agent、service、plugin 等入口模块。
+ * - 所有具体命令树都继续下沉到各自模块，避免入口文件继续膨胀。
+ */
+import { readFileSync } from "fs";
+import { basename, dirname, join } from "path";
+import { createRequire } from "module";
+import { fileURLToPath } from "url";
+import { Command, Option } from "commander";
+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");
+const require = createRequire(import.meta.url);
+const packageJson = JSON.parse(readFileSync(join(__dirname, "../../package.json"), "utf-8"));
+/**
+ * 解析当前 city 安装所绑定的 agent runtime 版本号。
+ *
+ * 关键点（中文）
+ * - 这里读取的是 city 当前安装依赖中的 `@downcity/agent` 版本，
+ *   不是 workspace 源码目录里的 package.json。
+ * - 这样 `city agent -v` 才能反映“这份 city CLI 实际会驱动哪个 agent runtime”。
+ */
+function resolveInstalledAgentVersion() {
+    try {
+        const agentEntryPath = require.resolve("@downcity/agent");
+        const agentPackageJson = JSON.parse(readFileSync(join(dirname(agentEntryPath), "../package.json"), "utf-8"));
+        const version = String(agentPackageJson.version || "").trim();
+        return version || "unknown";
+    }
+    catch {
+        try {
+            const siblingAgentPackageJson = JSON.parse(readFileSync(join(__dirname, "../../../agent/package.json"), "utf-8"));
+            const version = String(siblingAgentPackageJson.version || "").trim();
+            return version || "unknown";
+        }
+        catch {
+            return "unknown";
+        }
+    }
+}
+const installedAgentVersion = resolveInstalledAgentVersion();
+const program = new Command();
+const argv = process.argv.slice(2);
+program
+    .name(basename(process.argv[1] || "downcity"))
+    .description("把一个代码仓库，启动为一个拥有自主意识和执行能力的 Agent")
+    .version(packageJson.version, "-v, --version");
+program.helpOption("--help", "display help for command");
+program.option("-q, --quiet", "仅输出错误信息");
+program.option("--verbose", "输出详细进度");
+registerControlPlaneCommands(program, {
+    version: packageJson.version,
+    cliPath,
+});
+registerAgentCommands(program, {
+    version: packageJson.version,
+    agentVersion: installedAgentVersion,
+    hiddenPortOption: Option,
+});
+registerTokenCommand(program);
+registerEnvCommand(program);
+registerResetCommand(program);
+registerChatCommand(program);
+registerServicesCommand(program);
+registerPluginsCommand(program);
+// 服务命令统一注册（chat / task / memory / shell / future services）
+registerAllServicesForCli(program);
+// 插件命令统一注册（skill / asr / tts / future plugins）
+registerAllPluginsForCli(program);
+program.showHelpAfterError();
+program.showSuggestionAfterError();
+/**
+ * 处理 `city agent -v/--version`。
+ *
+ * 关键点（中文）
+ * - commander 根命令会优先消费全局 `-v`，导致 `city agent -v` 默认只显示 city 版本。
+ * - 这里在 parse 前做一次显式分流，确保 agent 命令能返回双版本信息。
+ */
+if (argv[0] === "agent" &&
+    argv.length === 2 &&
+    (argv[1] === "-v" || argv[1] === "--version")) {
+    console.log(`city ${packageJson.version} (agent ${installedAgentVersion})`);
+    process.exit(0);
+}
+if (process.argv.length <= 2) {
+    program.outputHelp();
+    process.exit(0);
+}
+// 关键点（中文）：在 parse 前解析 --quiet / --verbose，设置全局 verbosity。
+program.hook("preAction", (thisCommand) => {
+    const opts = thisCommand.optsWithGlobals();
+    if (opts.quiet)
+        setCliVerbosity("quiet");
+    else if (opts.verbose)
+        setCliVerbosity("verbose");
+});
+await program.parseAsync();
+//# sourceMappingURL=Index.js.map

package/bin/cli/Index.js.map

@@ -0,0 +1 @@
+{"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 的 SDK actor session 发送一轮消息。
+ */
+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;AAkBH,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EAEzB,yBAAyB,EAC1B,MAAM,qBAAqB,CAAC;AA6d7B;;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,CAwCrC;AAqID;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC7E"}