@downcity/city 1.1.1

package/bin/cli/Index.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+/**
+ * CLI 程序入口模块。
+ *
+ * 关键点（中文）
+ * - 这里只负责 CLI 基础初始化与一级命令装配，不承载具体业务逻辑。
+ * - 根命令层统一注册 city runtime、Console、agent、service、plugin 等入口模块。
+ * - 所有具体命令树都继续下沉到各自模块，避免入口文件继续膨胀。
+ */
+import { readFileSync } from "fs";
+import { basename, dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { Command, Option } from "commander";
+import { registerServicesCommand } from "./Services.js";
+import { registerPluginsCommand } from "./Plugins.js";
+import { registerAllServicesForCli } from "../service/ServiceCommand.js";
+import { registerAllPluginsForCli } from "../plugin/PluginCommand.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";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const cliPath = join(__dirname, "./Index.js");
+const packageJson = JSON.parse(readFileSync(join(__dirname, "../../package.json"), "utf-8"));
+const program = new Command();
+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", "输出详细进度");
+registerConsoleCommands(program, {
+    version: packageJson.version,
+    cliPath,
+});
+registerAgentCommands(program, {
+    version: packageJson.version,
+    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();
+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/IndexAgentCommand.d.ts

@@ -0,0 +1,22 @@
+/**
+ * CLI agent 命令装配。
+ *
+ * 关键点（中文）
+ * - 统一承载 `city agent` 命令树，避免主入口继续混合 console 与 agent 两套语义。
+ * - 只保留 agent 命令自身的校验与装配，不接管全局 CLI 初始化。
+ */
+import type { Command, Option } from "commander";
+/**
+ * agent 命令注册参数。
+ */
+export interface AgentCommandRegistrationContext {
+    /** 当前 CLI 版本号。 */
+    version: string;
+    /** commander 的隐藏 Option 构造器。 */
+    hiddenPortOption: typeof Option;
+}
+/**
+ * 注册 `city agent` 命令组。
+ */
+export declare function registerAgentCommands(program: Command, context: AgentCommandRegistrationContext): void;
+//# sourceMappingURL=IndexAgentCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IndexAgentCommand.d.ts","sourceRoot":"","sources":["../../src/cli/IndexAgentCommand.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AA+BjD;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,gBAAgB,EAAE,OAAO,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,+BAA+B,GACvC,IAAI,CAuPN"}

package/bin/cli/IndexAgentCommand.js

@@ -0,0 +1,218 @@
+/**
+ * CLI agent 命令装配。
+ *
+ * 关键点（中文）
+ * - 统一承载 `city agent` 命令树，避免主入口继续混合 console 与 agent 两套语义。
+ * - 只保留 agent 命令自身的校验与装配，不接管全局 CLI 初始化。
+ */
+import { emitRegisteredAgentListWithOptions, resolveCliAgentStartProjectRoot, } from "./AgentSelection.js";
+import { runInteractiveAgentManager } from "./AgentManager.js";
+import { chatCommand } from "./AgentChat.js";
+import { agentHistoryCleanCommand } from "./AgentHistory.js";
+import { initCommand } from "./Init.js";
+import { restartCommand } from "./Restart.js";
+import { stopCommand } from "./Stop.js";
+import { agentResetCommand } from "./AgentReset.js";
+import { runCommand } from "./Run.js";
+import { startCommand } from "./Start.js";
+import { statusCommand } from "./Status.js";
+import { createVersionBanner, injectAgentContext, parseBoolean, parsePort } from "./IndexSupport.js";
+import { runWithSpinner } from "../shared/utils/cli/Spinner.js";
+import { emitCliBlock } from "./CliReporter.js";
+import { cleanupStaleDaemonFiles, diagnoseDaemonStaleReasons, isProcessAlive as isDaemonProcessAlive, readDaemonPid, } from "../daemon/Manager.js";
+import { ensureRegisteredAgentProjectRoot, prepareForegroundAgent, } from "./IndexConsoleCommand.js";
+/**
+ * 注册 `city agent` 命令组。
+ */
+export function registerAgentCommands(program, context) {
+    const agent = program
+        .command("agent")
+        .description("管理 Agent：创建/列出/启停/重启（无参数时启动交互式管理器）")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async () => {
+        if (process.stdin.isTTY === true && process.stdout.isTTY === true) {
+            await runInteractiveAgentManager();
+            return;
+        }
+        agent.outputHelp();
+    }));
+    agent
+        .command("create [path]")
+        .description("创建/初始化一个 Agent 项目")
+        .option("-f, --force [enabled]", "允许覆盖已有 downcity.json（危险操作）", parseBoolean)
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async (cwd = ".", options) => {
+        await initCommand(cwd, options);
+    }));
+    agent
+        .command("list")
+        .description("列出已登记到 city 的 Agent 项目")
+        .option("--running [enabled]", "仅列出当前运行中的 Agent", parseBoolean)
+        .option("--json [enabled]", "以 JSON 输出", parseBoolean)
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async (options) => {
+        await emitRegisteredAgentListWithOptions({
+            runningOnly: options.running === true,
+            asJson: options.json === true,
+        });
+    }));
+    agent
+        .command("start [path]")
+        .description("启动 Agent 进程（后台/前台）")
+        .addOption(new context.hiddenPortOption("--port <port>").argParser(parsePort).hideHelp())
+        .option("-h, --host <host>", "服务主机（默认 0.0.0.0）")
+        .option("--foreground [enabled]", "前台启动（仅当前终端）", parseBoolean)
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async (cwd, options) => {
+        const projectRoot = await resolveCliAgentStartProjectRoot(cwd);
+        const prepared = await prepareForegroundAgent(projectRoot, options);
+        if (prepared.shouldForeground) {
+            await runCommand(prepared.projectRoot, prepared.options);
+            return;
+        }
+        await startCommand(prepared.projectRoot, prepared.options);
+    }));
+    agent
+        .command("chat")
+        .description("在终端中与指定 Agent 对话（交互式或一次性）")
+        .option("-t, --to <name>", "目标 agent 名称（省略时交互选择）")
+        .option("-m, --message <text>", "一次性发送一轮消息并退出")
+        .option("--json [enabled]", "一次性模式下以 JSON 输出", parseBoolean)
+        .option("--host <host>", "Server host（覆盖自动解析）")
+        .addOption(new context.hiddenPortOption("--port <port>").argParser(parsePort).hideHelp())
+        .option("--token <token>", "覆盖 Bearer Token（仅远程 HTTP 调用需要）")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async (options) => {
+        await chatCommand(options);
+    }));
+    const history = agent
+        .command("history")
+        .description("维护 Agent 会话历史");
+    history
+        .command("clean [path]")
+        .description("按 session 或 chat 目标硬清理一条会话历史")
+        .option("--session-id <sessionId>", "目标 session ID")
+        .option("--channel <channel>", "目标聊天渠道，例如 telegram")
+        .option("--chat-id <chatId>", "目标渠道 chat ID")
+        .option("--target-type <targetType>", "目标渠道会话类型")
+        .option("--thread-id <threadId>", "目标线程 ID")
+        .option("--hard [enabled]", "执行硬清理：删除 session/chat/route", parseBoolean)
+        .option("--json [enabled]", "以 JSON 输出", parseBoolean)
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async (cwd = ".", options) => {
+        const projectRoot = await ensureRegisteredAgentProjectRoot(cwd);
+        await agentHistoryCleanCommand(projectRoot, options);
+    }));
+    agent
+        .command("status [path]")
+        .description("查看后台 Agent 进程（daemon）状态")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async (cwd = ".") => {
+        const projectRoot = await ensureRegisteredAgentProjectRoot(cwd);
+        injectAgentContext(projectRoot);
+        await statusCommand(projectRoot);
+    }));
+    agent
+        .command("doctor [path]")
+        .description("诊断 daemon 状态文件；可选修复僵尸 pid/meta")
+        .option("--fix [enabled]", "清理僵尸 daemon 状态文件", parseBoolean)
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async (cwd = ".", options) => {
+        const projectRoot = await ensureRegisteredAgentProjectRoot(cwd);
+        injectAgentContext(projectRoot);
+        const pid = await readDaemonPid(projectRoot);
+        if (!pid) {
+            emitCliBlock({
+                tone: "success",
+                title: "No daemon state found",
+                facts: [
+                    {
+                        label: "Project",
+                        value: projectRoot,
+                    },
+                ],
+            });
+            return;
+        }
+        if (isDaemonProcessAlive(pid)) {
+            emitCliBlock({
+                tone: "success",
+                title: "Daemon process is alive",
+                facts: [
+                    {
+                        label: "Project",
+                        value: projectRoot,
+                    },
+                ],
+            });
+            return;
+        }
+        const staleReasons = await diagnoseDaemonStaleReasons(projectRoot, pid);
+        emitCliBlock({
+            tone: "warning",
+            title: "Stale daemon state detected",
+            facts: [
+                {
+                    label: "Project",
+                    value: projectRoot,
+                },
+                {
+                    label: "Reason",
+                    value: staleReasons.map((item) => item.message).join("; "),
+                },
+            ],
+        });
+        if (options.fix !== true) {
+            emitCliBlock({
+                tone: "info",
+                title: "Suggested fix",
+                facts: [
+                    {
+                        label: "Command",
+                        value: "city agent doctor <path> --fix",
+                    },
+                ],
+            });
+            return;
+        }
+        await runWithSpinner(() => cleanupStaleDaemonFiles(projectRoot), { text: "Cleaning stale daemon files..." });
+        emitCliBlock({
+            tone: "success",
+            title: "Cleaned stale daemon state",
+            facts: [
+                {
+                    label: "Project",
+                    value: projectRoot,
+                },
+            ],
+        });
+    }));
+    agent
+        .command("reset [path]")
+        .description("重新配置 Agent 的执行模型绑定")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async (cwd = ".") => {
+        // reset 不要求 agent 在 registry 中，只需要 downcity.json 存在
+        await agentResetCommand(cwd);
+    }));
+    agent
+        .command("stop [path]")
+        .description("停止后台 Agent 进程（daemon）")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async (cwd = ".") => {
+        const projectRoot = await ensureRegisteredAgentProjectRoot(cwd);
+        injectAgentContext(projectRoot);
+        await stopCommand(projectRoot);
+    }));
+    agent
+        .command("restart [path]")
+        .description("重启后台 Agent 进程（daemon）")
+        .option("-h, --host <host>", "服务主机（默认 0.0.0.0）")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async (cwd = ".", options) => {
+        const projectRoot = await ensureRegisteredAgentProjectRoot(cwd);
+        injectAgentContext(projectRoot);
+        await restartCommand(projectRoot, options);
+    }));
+}
+//# sourceMappingURL=IndexAgentCommand.js.map

package/bin/cli/IndexAgentCommand.js.map

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

package/bin/cli/IndexConsoleCommand.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CLI city/console 命令装配。
+ *
+ * 关键点（中文）
+ * - 统一管理 top-level city 生命周期命令与 Console 模块命令。
+ * - 本文件只保留命令树装配；runtime 与状态细节已拆到辅助模块。
+ */
+import { Command } from "commander";
+import { prepareForegroundAgent, ensureRegisteredAgentProjectRoot } from "./IndexConsoleProcess.js";
+/**
+ * top-level city/Console 命令注册参数。
+ */
+export interface ConsoleCommandRegistrationContext {
+    /** 当前 CLI 版本号。 */
+    version: string;
+    /** 当前 CLI 入口文件绝对路径。 */
+    cliPath: string;
+}
+/**
+ * 注册 top-level city 生命周期命令与 `console` 模块命令。
+ */
+export declare function registerConsoleCommands(program: Command, context: ConsoleCommandRegistrationContext): void;
+export { ensureRegisteredAgentProjectRoot, prepareForegroundAgent, };
+//# sourceMappingURL=IndexConsoleCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IndexConsoleCommand.d.ts","sourceRoot":"","sources":["../../src/cli/IndexConsoleCommand.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAkB5C,OAAO,EACL,sBAAsB,EACtB,gCAAgC,EAKjC,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,iCAAiC,GACzC,IAAI,CA0JN;AAED,OAAO,EACL,gCAAgC,EAChC,sBAAsB,GACvB,CAAC"}

package/bin/cli/IndexConsoleCommand.js

@@ -0,0 +1,147 @@
+/**
+ * CLI city/console 命令装配。
+ *
+ * 关键点（中文）
+ * - 统一管理 top-level city 生命周期命令与 Console 模块命令。
+ * - 本文件只保留命令树装配；runtime 与状态细节已拆到辅助模块。
+ */
+import { Option } from "commander";
+import { getConsoleRuntimeStatus, restartConsoleCommand, runConsoleRuntimeCommand, startConsoleCommand, stopConsoleCommand, } from "./Console.js";
+import { registerConfigCommand } from "./Config.js";
+import { registerModelCommand } from "./Model.js";
+import { consoleInitCommand } from "./ConsoleInit.js";
+import { parseBoolean, parsePort, createVersionBanner } from "./IndexSupport.js";
+import { CliError } from "../types/cli/CliError.js";
+import { updateCommand } from "./Update.js";
+import { consoleStatusCommand, printConsoleStatusPanel, } from "./IndexConsoleStatus.js";
+import { prepareForegroundAgent, ensureRegisteredAgentProjectRoot, restartCityRuntimeCommand, runCityRuntimeCommand, startCityRuntimeCommand, stopCityRuntimeCommand, } from "./IndexConsoleProcess.js";
+/**
+ * 注册 top-level city 生命周期命令与 `console` 模块命令。
+ */
+export function registerConsoleCommands(program, context) {
+    program
+        .command("init")
+        .description("初始化 city 全局配置（模型/插件等，写入 ~/.downcity/downcity.db）")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async () => {
+        await consoleInitCommand();
+    }));
+    program
+        .command("start")
+        .description("启动 city runtime；使用 -a/--all、--console 或 -p/--public 可同时启动 Console")
+        .option("-a, --all", "同时启动 Console")
+        .option("--console", "同时启动 Console")
+        .option("-p, --public [enabled]", "以公网模式启动 Console（绑定 0.0.0.0）", parseBoolean)
+        .option("-h, --host <host>", "Console 主机；传入后默认同时启动 Console")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async (_options, command) => {
+        const options = command.opts();
+        const shouldStartConsole = options?.all === true ||
+            options?.console === true ||
+            options?.public === true ||
+            Boolean(String(options?.host || "").trim());
+        await startCityRuntimeCommand(context.cliPath);
+        if (shouldStartConsole) {
+            await startConsoleCommand({
+                options: {
+                    public: options?.public,
+                    host: options?.host,
+                },
+                cliPath: context.cliPath,
+            });
+        }
+    }));
+    program
+        .command("stop")
+        .description("停止 CITY（先停 Console，再停 city 后台与受管 agent）")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async () => {
+        await stopCityRuntimeCommand();
+    }));
+    program
+        .command("restart")
+        .description("重启 CITY（重启 city 后台并恢复已运行 agent，再拉起 Console）")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async () => {
+        await restartCityRuntimeCommand(context.cliPath);
+        await startConsoleCommand({
+            cliPath: context.cliPath,
+        });
+    }));
+    program
+        .command("status")
+        .description("查看 city 后台、Console 与已托管 agent 运行状态")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async () => {
+        await consoleStatusCommand();
+    }));
+    program
+        .command("update")
+        .description("更新全局 downcity CLI 到最新版本")
+        .option("--manager <manager>", "指定包管理器（npm|pnpm|auto）", "auto")
+        .helpOption("--help", "display help for command")
+        .action(createVersionBanner(context.version, async (_options, command) => {
+        const options = command.opts();
+        const manager = String(options.manager || "auto").trim().toLowerCase();
+        if (manager !== "auto" && manager !== "npm" && manager !== "pnpm") {
+            throw new CliError({
+                title: `Invalid manager: ${manager}`,
+                fix: "Use npm|pnpm|auto.",
+            });
+        }
+        await updateCommand({
+            manager: manager,
+        });
+    }));
+    program
+        .command("run", { hidden: true })
+        .description("city 内部运行时（不直接使用）")
+        .action(runCityRuntimeCommand);
+    const consoleCommand = program
+        .command("console [action]")
+        .description("管理 Console 模块（start/stop/restart/status，默认 start）")
+        .option("-p, --public [enabled]", "以公网模式启动 Console（绑定 0.0.0.0）", parseBoolean)
+        .option("-h, --host <host>", "Console 主机（默认 127.0.0.1）")
+        .addOption(new Option("--port <port>").argParser(parsePort).hideHelp())
+        .helpOption("--help", "display help for command");
+    consoleCommand
+        .action(createVersionBanner(context.version, async (action, _options, command) => {
+        const options = command.opts();
+        const resolvedAction = String(action || "start").trim().toLowerCase();
+        if (resolvedAction === "start") {
+            await startConsoleCommand({
+                options,
+                cliPath: context.cliPath,
+            });
+            return;
+        }
+        if (resolvedAction === "run") {
+            await runConsoleRuntimeCommand(options);
+            return;
+        }
+        if (resolvedAction === "stop") {
+            await stopConsoleCommand();
+            return;
+        }
+        if (resolvedAction === "restart") {
+            await restartConsoleCommand({
+                options,
+                cliPath: context.cliPath,
+            });
+            return;
+        }
+        if (resolvedAction === "status") {
+            const status = await getConsoleRuntimeStatus();
+            printConsoleStatusPanel(status);
+            return;
+        }
+        throw new CliError({
+            title: `Unknown action: ${resolvedAction}`,
+            fix: "Use start|stop|restart|status.",
+        });
+    }));
+    registerConfigCommand(program);
+    registerModelCommand(program);
+}
+export { ensureRegisteredAgentProjectRoot, prepareForegroundAgent, };
+//# sourceMappingURL=IndexConsoleCommand.js.map

package/bin/cli/IndexConsoleCommand.js.map

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

package/bin/cli/IndexConsoleProcess.d.ts

@@ -0,0 +1,61 @@
+/**
+ * IndexConsoleProcess：console 命令的 runtime/进程控制辅助。
+ *
+ * 关键点（中文）
+ * - 聚合 console 与受管 agent 的后台进程控制逻辑。
+ * - 让 `IndexConsoleCommand` 只保留命令树装配，不再混杂大量进程细节。
+ */
+import type { ConsoleAgentProcessView } from "../shared/types/Console.js";
+import type { StartOptions } from "../shared/types/Start.js";
+/**
+ * 启动 city runtime 后台进程。
+ */
+export declare function startCityRuntimeCommand(cliPath: string): Promise<void>;
+/**
+ * 解析 console 维护的“正在运行” agent 列表。
+ */
+export declare function resolveRunningConsoleAgents(params?: {
+    /**
+     * 是否在扫描过程中回写 registry。
+     *
+     * 关键点（中文）
+     * - `status` 等纯观测命令应关闭该开关，避免只读操作因为目录不可写而失败。
+     * - stop/restart 等运维命令仍保留默认同步行为，确保 registry 最终状态收敛。
+     */
+    syncRegistry?: boolean;
+}): Promise<ConsoleAgentProcessView[]>;
+/**
+ * 停止 city runtime 后台进程（先停 Console，再停受管 agent，最后停 city runtime）。
+ */
+export declare function stopCityRuntimeCommand(params?: {
+    timeoutMs?: number;
+}): Promise<void>;
+/**
+ * 重启后恢复此前仍在运行的 agent daemon。
+ */
+export declare function restartManagedConsoleAgents(cliPath: string): Promise<void>;
+/**
+ * 重启 console 主进程。
+ */
+export declare function restartCityRuntimeCommand(cliPath: string): Promise<void>;
+/**
+ * 执行 city runtime 常驻进程。
+ */
+export declare function runCityRuntimeCommand(): Promise<void>;
+/**
+ * 注册 `agent doctor` 对 console registry 的依赖校验。
+ */
+export declare function ensureRegisteredAgentProjectRoot(cwd: string): Promise<string>;
+/**
+ * 为前台 agent 运行补齐上下文与模型绑定。
+ */
+export declare function prepareForegroundAgent(cwd: string, options: StartOptions & {
+    foreground?: boolean;
+}): Promise<{
+    projectRoot: string;
+    options: StartOptions & {
+        foreground?: boolean;
+    };
+    shouldForeground: boolean;
+}>;
+//# sourceMappingURL=IndexConsoleProcess.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IndexConsoleProcess.d.ts","sourceRoot":"","sources":["../../src/cli/IndexConsoleProcess.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAgBzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAc5D;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyE5E;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,CAAC,EAAE;IACzD;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CA2BrC;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyI3F;AAqBD;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8ChF;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9E;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAsB3D;AAuBD;;GAEG;AACH,wBAAsB,gCAAgC,CACpD,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,GAAG;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/C,OAAO,CAAC;IACT,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,GAAG;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACjD,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC,CAoCD"}