downcity 1.1.190 → 1.1.224

package/README.md

@@ -4,13 +4,12 @@
 
 ```bash
 npm install -g downcity
-city -v
-town -v
+downcity -v
 ```
 
-安装后会得到两个命令：
+安装后会得到 `downcity` 命令（别名 `city`、`downfed`、`fed`）：
 
-- `city`：管理已部署的 City、共享模型目录与服务资源。
-- `town`：在本机启动和管理 Agent 宿主环境。
+- 管理已部署的 City、共享模型目录与服务资源。
+- 在本机启动和管理 Agent 宿主环境。
 
-`cli/city` 与 `cli/town` 是仓库内部构建单元；用户只需要安装 `downcity`。
+无参数执行 `downcity` 会进入全屏交互式管理界面。

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

@@ -0,0 +1,16 @@
+/**
+ * `city agent chat` 统一入口。
+ *
+ * 关键点（中文）
+ * - 统一覆盖交互式持续对话与一次性消息模式，不再保留独立 `quest` 命令。
+ * - 目标 agent 始终按 managed agent registry 名称解析，不依赖当前工作目录。
+ * - 默认使用独立 local-cli 主会话：`local-cli-chat-main`。
+ * - 远程访问统一走 `RemoteAgent({ url })`，不再在 CLI 侧维护第二套 HTTP SDK transport。
+ * - 远程连接、session 创建/列表等操作委托给 `AgentChatRemote.ts`。
+ */
+import type { AgentChatCliOptions } from "@/city/agent/AgentChatTypes.js";
+/**
+ * `city agent chat` 统一入口。
+ */
+export declare function chatCommand(options: AgentChatCliOptions): Promise<void>;
+//# sourceMappingURL=AgentChat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentChat.d.ts","sourceRoot":"","sources":["../../../src/city/agent/AgentChat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAU1E;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmG7E"}

package/bin/city/agent/AgentChat.js

@@ -0,0 +1,111 @@
+/**
+ * `city agent chat` 统一入口。
+ *
+ * 关键点（中文）
+ * - 统一覆盖交互式持续对话与一次性消息模式，不再保留独立 `quest` 命令。
+ * - 目标 agent 始终按 managed agent registry 名称解析，不依赖当前工作目录。
+ * - 默认使用独立 local-cli 主会话：`local-cli-chat-main`。
+ * - 远程访问统一走 `RemoteAgent({ url })`，不再在 CLI 侧维护第二套 HTTP SDK transport。
+ * - 远程连接、session 创建/列表等操作委托给 `AgentChatRemote.ts`。
+ */
+import { emitCliBlock } from "@/shared/CliReporter.js";
+import { createRemoteChatSession, listRemoteChatSessions, } from "@/city/agent/AgentChatRemote.js";
+import { run_agent_chat_tui } from "@/city/agent/AgentChatTui.js";
+import { normalizeChatMessage, resolveAgentChatSessionOptions, resolveChatTargetAgentId, resolveInteractiveChatSession, runOneShotChat, runSdkPromptTurn, } from "@/city/agent/AgentChatHelpers.js";
+/**
+ * `city agent chat` 统一入口。
+ */
+export async function chatCommand(options) {
+    const resolved_session = resolveAgentChatSessionOptions(options);
+    if (!resolved_session.success) {
+        emitCliBlock({
+            tone: "error",
+            title: "Invalid chat session options",
+            note: resolved_session.error,
+        });
+        return;
+    }
+    const agentId = await resolveChatTargetAgentId(options.to);
+    if (!agentId)
+        return;
+    const oneShotMessage = normalizeChatMessage(String(options.message || ""));
+    if (oneShotMessage) {
+        await runOneShotChat({
+            agentId,
+            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;
+    }
+    const interactive = await resolveInteractiveChatSession({
+        agentId,
+        options,
+        transport: {
+            host: options.host,
+            port: options.port,
+        },
+    });
+    if (!interactive.success) {
+        if (interactive.error) {
+            emitCliBlock({
+                tone: "error",
+                title: "Agent chat failed",
+                note: interactive.error,
+            });
+        }
+        return;
+    }
+    try {
+        await run_agent_chat_tui({
+            agent_id: agentId,
+            session_id: interactive.target.sessionId,
+            list_sessions: async () => await listRemoteChatSessions({
+                remote_agent: interactive.remote_agent,
+            }),
+            create_session: async () => await createRemoteChatSession({
+                remote_agent: interactive.remote_agent,
+            }),
+            run_turn: async ({ session_id, message, interactive_renderer }) => {
+                const outcome = await runSdkPromptTurn({
+                    agentId,
+                    message,
+                    sessionOptions: {
+                        sessionId: session_id,
+                        newSession: false,
+                    },
+                    transport: {
+                        host: options.host,
+                        port: options.port,
+                    },
+                    interactiveRenderer: interactive_renderer,
+                });
+                return {
+                    success: outcome.success,
+                    error: outcome.error,
+                    emitted_visible_text: outcome.emittedVisibleText,
+                    text: outcome.text,
+                };
+            },
+        });
+    }
+    finally {
+        await interactive.remote_agent.close();
+    }
+}
+//# sourceMappingURL=AgentChat.js.map

package/bin/city/agent/AgentChat.js.map

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

package/bin/city/agent/AgentChatHelpers.d.ts

@@ -0,0 +1,105 @@
+/**
+ * `city agent chat` 命令辅助函数。
+ *
+ * 关键点（中文）
+ * - 统一覆盖交互式持续对话与一次性消息模式，不再保留独立 `quest` 命令。
+ * - 目标 agent 始终按 managed agent registry 名称解析，不依赖当前工作目录。
+ * - 默认使用独立 local-cli 主会话：`local-cli-chat-main`。
+ * - 远程访问统一走 `RemoteAgent({ url })`，不再在 CLI 侧维护第二套 HTTP SDK transport。
+ * - 远程连接、session 创建/列表等操作委托给 `AgentChatRemote.ts`。
+ */
+import { RemoteAgent } from "@downcity/agent";
+import type { AgentChatCliOptions, AgentChatExecutionOutcome, AgentChatSessionOptions } from "@/city/agent/AgentChatTypes.js";
+import type { AgentChatInteractiveRendererPort } from "@/city/types/AgentChatInteractive.js";
+export type ResolvedAgentChatTarget = {
+    /** 目标 agent id。 */
+    agentId: string;
+    /** 目标项目根目录。 */
+    projectRoot: string;
+    /** 当前 chat 绑定的 sessionId。 */
+    sessionId: string;
+    /** 当前 chat 是否要求创建全新的 session。 */
+    createNewSession: boolean;
+};
+export declare function normalizeChatMessage(input: string): string;
+/**
+ * 解析 `city agent chat` 的 session 选择语义。
+ *
+ * 关键点（中文）
+ * - 默认继续使用 `local-cli-chat-main`，保持老命令行为稳定。
+ * - `--new-session` 生成不可预测的新 ID，避免用户手动清理旧上下文。
+ * - `--session-id` 与 `--new-session` 互斥，避免“复用”和“新建”语义冲突。
+ */
+export declare function resolveAgentChatSessionOptions(input?: AgentChatSessionOptions): {
+    success: true;
+    session_id: string;
+    create_new_session: boolean;
+} | {
+    success: false;
+    error: string;
+};
+export declare function hasExplicitSessionSelection(input: AgentChatSessionOptions): boolean;
+export declare function resolveChatTargetAgentId(inputId?: string): Promise<string | null>;
+export declare function resolveAgentChatTarget(agentIdInput: string, sessionOptions?: AgentChatSessionOptions): Promise<{
+    success: true;
+    target: ResolvedAgentChatTarget;
+} | {
+    success: false;
+    outcome: AgentChatExecutionOutcome;
+}>;
+export declare function printAssistantReply(replyText: string): void;
+export declare function printAgentChatFailure(params: {
+    agentId: string;
+    error?: string;
+}): void;
+export declare function resolveInteractiveChatSession(params: {
+    agentId: string;
+    options: AgentChatCliOptions;
+    transport?: {
+        host?: string;
+        port?: number;
+    };
+}): Promise<{
+    success: true;
+    target: ResolvedAgentChatTarget;
+    remote_agent: RemoteAgent;
+} | {
+    success: false;
+    error?: string;
+}>;
+export declare function runSdkPromptTurn(params: {
+    agentId: string;
+    message: string;
+    sessionOptions?: AgentChatSessionOptions;
+    transport?: {
+        host?: string;
+        port?: number;
+    };
+    renderText?: boolean;
+    interactiveRenderer?: AgentChatInteractiveRendererPort;
+}): Promise<{
+    success: boolean;
+    error?: string;
+    emittedVisibleText: boolean;
+    sessionId: string;
+    projectRoot?: string;
+    text?: string;
+}>;
+/**
+ * 向目标 agent 的 SDK actor session 发送一轮消息。
+ */
+export declare function executeAgentChatTurn(params: {
+    agentId: string;
+    message: string;
+    sessionOptions?: AgentChatSessionOptions;
+    transport?: {
+        host?: string;
+        port?: number;
+    };
+}): Promise<AgentChatExecutionOutcome>;
+export declare function runOneShotChat(params: {
+    agentId: string;
+    message: string;
+    options: AgentChatCliOptions;
+}): Promise<void>;
+//# sourceMappingURL=AgentChatHelpers.d.ts.map

package/bin/city/agent/AgentChatHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentChatHelpers.d.ts","sourceRoot":"","sources":["../../../src/city/agent/AgentChatHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,WAAW,EAEZ,MAAM,iBAAiB,CAAC;AAgBzB,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,gCAAgC,CAAC;AAIxC,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AAE7F,MAAM,MAAM,uBAAuB,GAAG;IACpC,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,CAAC,EAAE,uBAAuB,GAE7B;IACE,OAAO,EAAE,IAAI,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,OAAO,CAAC;CAC7B,GACD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAwBJ;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAEnF;AAED,wBAAsB,wBAAwB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6CvF;AAED,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,uBAAuB,GACvC,OAAO,CACN;IACE,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,uBAAuB,CAAC;CACjC,GACD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,yBAAyB,CAAC;CACpC,CACJ,CAoFA;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAW3D;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,IAAI,CAeP;AAED,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,SAAS,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C,GAAG,OAAO,CACP;IACE,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,uBAAuB,CAAC;IAChC,YAAY,EAAE,WAAW,CAAC;CAC3B,GACD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CACJ,CAsDA;AAiCD,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,uBAAuB,CAAC;IACzC,SAAS,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mBAAmB,CAAC,EAAE,gCAAgC,CAAC;CACxD,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC,CAiKD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,uBAAuB,CAAC;IACzC,SAAS,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAyCrC;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,mBAAmB,CAAC;CAC9B,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDhB"}