@downcity/city 1.1.1 → 1.1.5

package/bin/cli/agent/AgentReset.js

@@ -0,0 +1,167 @@
+/**
+ * `city agent reset`：重新配置 Agent 的执行绑定。
+ *
+ * 关键点（中文）
+ * - 当 agent 启动失败（如 model not found）时，不必删除重建，直接重选模型。
+ * - 从平台全局模型池中选择可用模型，更新 downcity.json.execution.modelId。
+ * - 仅修改 execution.modelId，不触碰 PROFILE.md / SOUL.md / channels 等其他配置。
+ */
+import path from "node:path";
+import fs from "fs-extra";
+import prompts from "prompts";
+import { getDowncityJsonPath } from "../../config/Paths.js";
+import { PlatformStore } from "@downcity/agent";
+import { emitCliBlock } from "../shared/CliReporter.js";
+import { CliError } from "../shared/CliError.js";
+import { resolveAgentName } from "../shared/IndexSupport.js";
+/**
+ * 读取当前 agent 的 execution.modelId。
+ */
+function readCurrentModelId(projectRoot) {
+    const shipJsonPath = getDowncityJsonPath(projectRoot);
+    if (!fs.existsSync(shipJsonPath)) {
+        throw new Error(`downcity.json not found: ${shipJsonPath}`);
+    }
+    const raw = fs.readJsonSync(shipJsonPath);
+    const current = String(raw?.execution && typeof raw.execution === "object"
+        ? raw.execution.modelId || ""
+        : "").trim();
+    return { shipJsonPath, current };
+}
+/**
+ * 列出可用的平台模型选项。
+ */
+function listModelChoices() {
+    const store = new PlatformStore();
+    try {
+        const models = store.listModels();
+        const providers = store.listProvidersSync();
+        const providerMap = new Map(providers.map((p) => [p.id, p]));
+        return models
+            .filter((m) => !m.isPaused)
+            .map((m) => {
+            const provider = providerMap.get(m.providerId);
+            const label = provider
+                ? `${provider.type}${provider.baseUrl ? ` · ${provider.baseUrl}` : ""}`
+                : "-";
+            return {
+                title: `${m.id}  [${label}]`,
+                value: m.id,
+            };
+        });
+    }
+    finally {
+        store.close();
+    }
+}
+/**
+ * 执行 `city agent reset` 交互流程。
+ */
+export async function agentResetCommand(cwd = ".") {
+    const projectRoot = path.resolve(cwd);
+    // 1) 校验项目文件存在
+    const shipJsonPath = getDowncityJsonPath(projectRoot);
+    if (!fs.existsSync(shipJsonPath)) {
+        throw new CliError({
+            title: "downcity.json not found",
+            note: `project: ${projectRoot}`,
+            fix: "city agent create <path>",
+        });
+    }
+    // 2) 读取当前 modelId
+    const { current } = readCurrentModelId(projectRoot);
+    // 3) 获取可用模型列表
+    const choices = listModelChoices();
+    if (choices.length === 0) {
+        throw new CliError({
+            title: "No models available in platform pool",
+            note: "请先配置 provider 并创建 model",
+            fix: "city model create",
+        });
+    }
+    // 4) 交互选择模型
+    const response = (await prompts({
+        type: "select",
+        name: "modelId",
+        message: "选择 Agent 使用的模型",
+        choices,
+        initial: current ? Math.max(0, choices.findIndex((c) => c.value === current)) : 0,
+    }));
+    const nextModelId = String(response.modelId || "").trim();
+    if (!nextModelId) {
+        emitCliBlock({
+            tone: "info",
+            title: "Agent reset cancelled",
+            summary: resolveAgentName(projectRoot),
+        });
+        return;
+    }
+    if (nextModelId === current) {
+        emitCliBlock({
+            tone: "info",
+            title: "Model unchanged",
+            summary: resolveAgentName(projectRoot),
+            facts: [
+                { label: "modelId", value: current },
+                { label: "project", value: projectRoot },
+            ],
+        });
+        return;
+    }
+    // 5) 写入 downcity.json
+    const raw = fs.readJsonSync(shipJsonPath);
+    raw.execution = { type: "api", modelId: nextModelId };
+    fs.writeJsonSync(shipJsonPath, raw, { spaces: 2 });
+    emitCliBlock({
+        tone: "success",
+        title: "Agent reconfigured",
+        summary: resolveAgentName(projectRoot),
+        facts: [
+            { label: "previous", value: current || "(none)" },
+            { label: "current", value: nextModelId },
+            { label: "project", value: projectRoot },
+        ],
+    });
+    // 关键点（中文）：检测控制面是否运行，决定能否即时重启。
+    const { isCityRunning } = await import("../../process/registry/CityRuntime.js");
+    const controlPlaneRunning = await isCityRunning();
+    if (!controlPlaneRunning) {
+        emitCliBlock({
+            tone: "warning",
+            title: "Control plane is not running",
+            note: "请先启动控制面再重启 agent",
+            facts: [
+                { label: "step 1", value: "city start" },
+                { label: "step 2", value: `city agent restart ${projectRoot}` },
+            ],
+        });
+        return;
+    }
+    const restartNow = (await prompts({
+        type: "confirm",
+        name: "restart",
+        message: "立即重启 agent 使新模型生效？",
+        initial: true,
+    }));
+    if (restartNow.restart === true) {
+        const { restartCommand } = await import("./Restart.js");
+        try {
+            await restartCommand(projectRoot, {});
+            return;
+        }
+        catch (error) {
+            emitCliBlock({
+                tone: "error",
+                title: "Agent restart failed",
+                note: error instanceof Error ? error.message : String(error),
+            });
+            return;
+        }
+    }
+    emitCliBlock({
+        tone: "info",
+        title: "Agent not restarted",
+        note: `run \`city agent restart ${projectRoot}\` to apply the new model`,
+    });
+}
+//# sourceMappingURL=AgentReset.js.map

package/bin/cli/agent/AgentReset.js.map

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

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

@@ -0,0 +1,43 @@
+/**
+ * agent 列表与交互式选择辅助模块。
+ *
+ * 关键点（中文）
+ * - 统一承接 `city agent list` 的 registry 展示逻辑。
+ * - 统一承接 `city agent start` 在省略路径时的目标选择逻辑。
+ * - 规则固定为：显式路径优先，其次当前目录已初始化，最后才进入交互选择。
+ */
+import type { CliAgentPromptChoice, CliRegisteredAgentView, ResolveCliAgentStartTargetDecision, ResolveCliAgentStartTargetDecisionInput } from "./AgentSelectionTypes.js";
+/**
+ * 读取当前 registry 中的已登记 agent 列表。
+ */
+export declare function listRegisteredAgentsForCli(): Promise<CliRegisteredAgentView[]>;
+/**
+ * 构建交互式选择器的 choices。
+ */
+export declare function buildCliAgentPromptChoices(agents: CliRegisteredAgentView[]): CliAgentPromptChoice[];
+/**
+ * 解析 `agent start` 在当前上下文下应该如何决定目标目录。
+ */
+export declare function resolveCliAgentStartTargetDecision(input: ResolveCliAgentStartTargetDecisionInput): ResolveCliAgentStartTargetDecision;
+/**
+ * 输出已登记 agent 列表。
+ */
+export declare function emitRegisteredAgentList(): Promise<void>;
+/**
+ * 输出已登记 agent 列表，可选仅显示运行中项目。
+ */
+export declare function emitRegisteredAgentListWithOptions(options?: {
+    /**
+     * 是否只输出当前运行中的 agent。
+     */
+    runningOnly?: boolean;
+    /**
+     * 是否以 JSON 输出。
+     */
+    asJson?: boolean;
+}): Promise<void>;
+/**
+ * 为 `city agent start` 解析最终要启动的项目目录。
+ */
+export declare function resolveCliAgentStartProjectRoot(pathInput?: string): Promise<string>;
+//# sourceMappingURL=AgentSelection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentSelection.d.ts","sourceRoot":"","sources":["../../../src/cli/agent/AgentSelection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACtB,kCAAkC,EAClC,uCAAuC,EACxC,MAAM,0BAA0B,CAAC;AA4BlC;;GAEG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAmBpF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,sBAAsB,EAAE,GAC/B,oBAAoB,EAAE,CAMxB;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,uCAAuC,GAC7C,kCAAkC,CAkCpC;AAoBD;;GAEG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiC7D;AAED;;GAEG;AACH,wBAAsB,kCAAkC,CAAC,OAAO,CAAC,EAAE;IACjE;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDhB;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CACnD,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CA0CjB"}

package/bin/cli/agent/AgentSelection.js

@@ -0,0 +1,243 @@
+/**
+ * agent 列表与交互式选择辅助模块。
+ *
+ * 关键点（中文）
+ * - 统一承接 `city agent list` 的 registry 展示逻辑。
+ * - 统一承接 `city agent start` 在省略路径时的目标选择逻辑。
+ * - 规则固定为：显式路径优先，其次当前目录已初始化，最后才进入交互选择。
+ */
+import { existsSync } from "fs";
+import { resolve } from "path";
+import prompts from "prompts";
+import { getDowncityJsonPath, getProfileMdPath } from "../../config/Paths.js";
+import { listManagedAgentEntries } from "../../process/registry/CityRegistry.js";
+import { emitCliBlock, emitCliList } from "../shared/CliReporter.js";
+import { printResult } from "../../utils/cli/CliOutput.js";
+import { CliError } from "../shared/CliError.js";
+import { resolveAgentName } from "../shared/IndexSupport.js";
+import { resolveRunningManagedAgents } from "../control-plane/ControlPlaneProcess.js";
+/**
+ * 判断一个目录是否已经满足最小 agent 初始化条件。
+ */
+function isInitializedAgentProject(projectRoot) {
+    return existsSync(getProfileMdPath(projectRoot)) && existsSync(getDowncityJsonPath(projectRoot));
+}
+/**
+ * 将 registry entry 转换为 CLI 展示视图。
+ */
+function toCliRegisteredAgentView(entry) {
+    const projectRoot = resolve(String(entry.projectRoot || "").trim() || ".");
+    return {
+        name: resolveAgentName(projectRoot),
+        projectRoot,
+        status: entry.status === "stopped" ? "stopped" : "running",
+    };
+}
+/**
+ * 读取当前 registry 中的已登记 agent 列表。
+ */
+export async function listRegisteredAgentsForCli() {
+    const entries = await listManagedAgentEntries();
+    const runningViews = await resolveRunningManagedAgents({
+        syncRegistry: false,
+    });
+    const runningProjectRoots = new Set(runningViews.map((item) => resolve(String(item.projectRoot || "").trim() || ".")));
+    return entries
+        .map((entry) => {
+        const view = toCliRegisteredAgentView(entry);
+        return {
+            ...view,
+            status: runningProjectRoots.has(view.projectRoot) ? "running" : "stopped",
+        };
+    })
+        .sort((left, right) => left.name.localeCompare(right.name) || left.projectRoot.localeCompare(right.projectRoot));
+}
+/**
+ * 构建交互式选择器的 choices。
+ */
+export function buildCliAgentPromptChoices(agents) {
+    return agents.map((agent) => ({
+        title: agent.name,
+        value: agent.projectRoot,
+        description: `${agent.status} · ${agent.projectRoot}`,
+    }));
+}
+/**
+ * 解析 `agent start` 在当前上下文下应该如何决定目标目录。
+ */
+export function resolveCliAgentStartTargetDecision(input) {
+    const explicitPath = String(input.pathInput || "").trim();
+    if (explicitPath) {
+        return {
+            mode: "explicit",
+            projectRoot: resolve(explicitPath),
+        };
+    }
+    const currentWorkingDirectory = resolve(input.currentWorkingDirectory || ".");
+    if (input.currentDirectoryInitialized) {
+        return {
+            mode: "current",
+            projectRoot: currentWorkingDirectory,
+        };
+    }
+    if (input.registeredAgents.length === 0) {
+        return {
+            mode: "error",
+            reason: "no-registered-agents",
+        };
+    }
+    if (!input.interactive) {
+        return {
+            mode: "error",
+            reason: "non-interactive",
+        };
+    }
+    return {
+        mode: "prompt",
+    };
+}
+/**
+ * 通过终端交互让用户选择一个已登记 agent。
+ */
+async function promptRegisteredAgentProjectRoot(agents) {
+    const response = (await prompts({
+        type: "select",
+        name: "projectRoot",
+        message: "选择要启动的 Agent",
+        choices: buildCliAgentPromptChoices(agents),
+        initial: 0,
+    }));
+    const projectRoot = String(response.projectRoot || "").trim();
+    return projectRoot || null;
+}
+/**
+ * 输出已登记 agent 列表。
+ */
+export async function emitRegisteredAgentList() {
+    const agents = await listRegisteredAgentsForCli();
+    const filteredAgents = agents;
+    if (filteredAgents.length === 0) {
+        emitCliBlock({
+            tone: "info",
+            title: "Agents",
+            summary: "0 registered",
+            note: "Run `city agent start <path>` once to register an agent with city.",
+        });
+        return;
+    }
+    emitCliList({
+        tone: "accent",
+        title: "Agents",
+        summary: `${filteredAgents.length} registered`,
+        items: filteredAgents.map((agent) => ({
+            tone: agent.status === "running" ? "success" : "info",
+            title: agent.name,
+            facts: [
+                {
+                    label: "Project",
+                    value: agent.projectRoot,
+                },
+                {
+                    label: "Status",
+                    value: agent.status,
+                },
+            ],
+        })),
+    });
+}
+/**
+ * 输出已登记 agent 列表，可选仅显示运行中项目。
+ */
+export async function emitRegisteredAgentListWithOptions(options) {
+    const allAgents = await listRegisteredAgentsForCli();
+    const agents = options?.runningOnly === true
+        ? allAgents.filter((item) => item.status === "running")
+        : allAgents;
+    if (options?.asJson === true) {
+        printResult({
+            asJson: true,
+            success: true,
+            title: "agents",
+            payload: {
+                count: agents.length,
+                runningOnly: options.runningOnly === true,
+                agents,
+            },
+        });
+        return;
+    }
+    if (agents.length === 0) {
+        emitCliBlock({
+            tone: "info",
+            title: options?.runningOnly === true ? "Running agents" : "Agents",
+            summary: options?.runningOnly === true ? "0 running" : "0 registered",
+            note: options?.runningOnly === true
+                ? "No agent daemon is currently running."
+                : "Run `city agent start <path>` once to register an agent with city.",
+        });
+        return;
+    }
+    emitCliList({
+        tone: "accent",
+        title: options?.runningOnly === true ? "Running agents" : "Agents",
+        summary: options?.runningOnly === true
+            ? `${agents.length} running`
+            : `${agents.length} registered`,
+        items: agents.map((agent) => ({
+            tone: agent.status === "running" ? "success" : "info",
+            title: agent.name,
+            facts: [
+                {
+                    label: "Project",
+                    value: agent.projectRoot,
+                },
+                {
+                    label: "Status",
+                    value: agent.status,
+                },
+            ],
+        })),
+    });
+}
+/**
+ * 为 `city agent start` 解析最终要启动的项目目录。
+ */
+export async function resolveCliAgentStartProjectRoot(pathInput) {
+    const currentWorkingDirectory = resolve(process.cwd());
+    const registeredAgents = await listRegisteredAgentsForCli();
+    const decision = resolveCliAgentStartTargetDecision({
+        pathInput,
+        currentWorkingDirectory,
+        currentDirectoryInitialized: isInitializedAgentProject(currentWorkingDirectory),
+        interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY),
+        registeredAgents,
+    });
+    if (decision.mode === "explicit" || decision.mode === "current") {
+        return decision.projectRoot;
+    }
+    if (decision.mode === "error") {
+        if (decision.reason === "no-registered-agents") {
+            throw new CliError({
+                title: "No registered agents",
+                fix: "city agent start <path>",
+            });
+        }
+        throw new CliError({
+            title: "Agent path is required",
+            fix: "city agent start <path>",
+        });
+    }
+    const selectedProjectRoot = await promptRegisteredAgentProjectRoot(registeredAgents);
+    if (!selectedProjectRoot) {
+        emitCliBlock({
+            tone: "info",
+            title: "Agent start cancelled",
+        });
+        throw new CliError({
+            title: "Agent start cancelled",
+            exitCode: 0,
+        });
+    }
+    return selectedProjectRoot;
+}
+//# sourceMappingURL=AgentSelection.js.map

package/bin/cli/agent/AgentSelection.js.map

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

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

@@ -0,0 +1,30 @@
+/**
+ * agent 选择与列表展示类型定义。
+ */
+export type CliRegisteredAgentView = {
+    name: string;
+    projectRoot: string;
+    status: "running" | "stopped";
+};
+export type CliAgentPromptChoice = {
+    title: string;
+    value: string;
+    description: string;
+};
+export type ResolveCliAgentStartTargetDecisionInput = {
+    pathInput?: string;
+    currentWorkingDirectory: string;
+    currentDirectoryInitialized: boolean;
+    interactive: boolean;
+    registeredAgents: CliRegisteredAgentView[];
+};
+export type ResolveCliAgentStartTargetDecision = {
+    mode: "explicit" | "current";
+    projectRoot: string;
+} | {
+    mode: "prompt";
+} | {
+    mode: "error";
+    reason: "no-registered-agents" | "non-interactive";
+};
+//# sourceMappingURL=AgentSelectionTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentSelectionTypes.d.ts","sourceRoot":"","sources":["../../../src/cli/agent/AgentSelectionTypes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,uCAAuC,GAAG;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB,EAAE,MAAM,CAAC;IAChC,2BAA2B,EAAE,OAAO,CAAC;IACrC,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,sBAAsB,EAAE,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAC1C;IACE,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;CAChB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,sBAAsB,GAAG,iBAAiB,CAAC;CACpD,CAAC"}

package/bin/cli/agent/AgentSelectionTypes.js

@@ -0,0 +1,5 @@
+/**
+ * agent 选择与列表展示类型定义。
+ */
+export {};
+//# sourceMappingURL=AgentSelectionTypes.js.map

package/bin/cli/agent/AgentSelectionTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentSelectionTypes.js","sourceRoot":"","sources":["../../../src/cli/agent/AgentSelectionTypes.ts"],"names":[],"mappings":"AAAA;;GAEG"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"Init.d.ts","sourceRoot":"","sources":["../../../src/cli/agent/Init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAyBH;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,GAAG,GAAE,MAAY,EACjB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,OAAO,CAAC,IAAI,CAAC,CAmPf"}