@downcity/agent 1.1.338 → 1.1.400

package/bin/agent/WorkspaceEntry.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Workspace 执行上下文的内部组合对象。
+ *
+ * 关键点（中文）
+ * - Agent 仍是身份、模型、指令与 Plugin 的唯一拥有者。
+ * - 当前对象只组合 Workspace Tool、Plugin Context、日志与后台资源。
+ * - Session 的所有权属于 Agent.sessions；本对象只提供内部执行上下文。
+ * - 它不是公开领域对象，也不是 AgentWorkspace。
+ */
+import type { RuntimeTool as Tool } from "@downcity/type";
+import type { SessionSystemMessage } from "../executor/types/SessionPrompts.js";
+import type { Hono } from "hono";
+import type { WorkspaceShell } from "@downcity/workspace";
+import type { AgentSessionCollection } from "../types/agent/AgentSessionCollection.js";
+import type { AgentPlugins } from "../types/plugin/PluginRuntime.js";
+import type { AgentPluginExecutionRuntime } from "../types/plugin/PluginRuntime.js";
+import type { PluginContext } from "../types/plugin/PluginContext.js";
+import type { PluginSnapshot } from "../types/plugin/PluginState.js";
+import type { WorkspaceEntryOptions } from "../types/agent/WorkspaceEntryOptions.js";
+import { Logger } from "../utils/logger/Logger.js";
+import type { AgentStorage } from "../types/agent/AgentStorage.js";
+import { type SystemProfile } from "../executor/composer/system/default/SystemDomain.js";
+/** Agent 在一个 Workspace 中的内部执行上下文。 */
+export declare class WorkspaceEntry {
+    /** 拥有当前作用域的 Agent。 */
+    readonly agent: WorkspaceEntryOptions["agent"];
+    /** 当前 Workspace。 */
+    readonly workspace: WorkspaceEntryOptions["workspace"];
+    /** 当前 Workspace ID。 */
+    readonly workspace_id: string;
+    /** 当前 Workspace 下的 Tool 集合。 */
+    readonly tools: Record<string, Tool>;
+    /** 当前 Workspace Context 绑定的 Agent Plugin 调用面。 */
+    readonly plugins: AgentPlugins;
+    /**
+     * 当前 Workspace 的内部 Session 查询视图；实际所有权仍属于 Agent.sessions。
+     * 该视图只供 City transport 和内部测试装配使用，不是新的 Session 所有者。
+     */
+    readonly sessions: AgentSessionCollection;
+    /** 当前 Workspace 的 Session、日志和调度数据根路径。 */
+    readonly data_path: string;
+    private readonly context;
+    private readonly logger;
+    private readonly unsubscribe_env;
+    private readonly unsubscribe_plugins;
+    private readonly storage;
+    private readonly plugin_contexts;
+    private leave_promise?;
+    constructor(options: WorkspaceEntryOptions);
+    /** 当前 Agent ID。 */
+    get id(): string;
+    /** 返回当前 Workspace 的 Shell。 */
+    get_shell(): WorkspaceShell | undefined;
+    /** 返回当前 Workspace 的日志器。 */
+    get_logger(): Logger;
+    /** 列出当前 Agent 注册的 Plugin 状态。 */
+    list_plugin_states(): PluginSnapshot[];
+    /** 将 Plugin HTTP 路由绑定到当前 Workspace Context。 */
+    register_plugin_http_routes(app: Hono): void;
+    /** 解析指定 Session 当前可见的完整 system messages。 */
+    resolve_system_messages(input: {
+        session_id: string;
+        profile?: SystemProfile;
+    }): Promise<SessionSystemMessage[]>;
+    /** 离开当前 Workspace 并释放 Agent 独享的执行资源。 */
+    leave(): Promise<void>;
+    /** 返回当前 Workspace 的 PluginContext，供 Agent 级调度器解析执行上下文。 */
+    get_context(): PluginContext;
+    /** 返回单个 Session 创建所需的 Workspace 执行上下文。 */
+    get_session_context(): {
+        workspace_path: string;
+        workspace_id: string;
+        logger: Logger;
+        tools: Record<string, Tool>;
+        get_workspace_env: () => Record<string, string>;
+        get_agent_plugins: () => AgentPluginExecutionRuntime;
+        store: AgentStorage["sessions"];
+    };
+    /** 返回指定 Plugin 的 Agent 级运行时 Context。 */
+    private get_plugin_context;
+}
+//# sourceMappingURL=WorkspaceEntry.d.ts.map

package/bin/agent/WorkspaceEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceEntry.d.ts","sourceRoot":"","sources":["../../src/agent/WorkspaceEntry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAItF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AACnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AACpF,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,oDAAoD,CAAC;AA+B5D,qCAAqC;AACrC,qBAAa,cAAc;IACzB,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/C,oBAAoB;IACpB,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC;IACvD,uBAAuB;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrC,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAa;IAC7C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAa;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoC;IACpE,OAAO,CAAC,aAAa,CAAC,CAAgB;gBAE1B,OAAO,EAAE,qBAAqB;IAsG1C,mBAAmB;IACnB,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,8BAA8B;IAC9B,SAAS,IAAI,cAAc,GAAG,SAAS;IAIvC,2BAA2B;IAC3B,UAAU,IAAI,MAAM;IAIpB,gCAAgC;IAChC,kBAAkB,IAAI,cAAc,EAAE;IAItC,+CAA+C;IAC/C,2BAA2B,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI;IAU5C,4CAA4C;IACtC,uBAAuB,CAAC,KAAK,EAAE;QACnC,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,aAAa,CAAC;KACzB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAUnC,wCAAwC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B5B,0DAA0D;IAC1D,WAAW,IAAI,aAAa;IAI5B,0CAA0C;IAC1C,mBAAmB,IAAI;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5B,iBAAiB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChD,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;QACrD,KAAK,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;KACjC;IAYD,wCAAwC;IACxC,OAAO,CAAC,kBAAkB;CAiB3B"}

package/bin/agent/WorkspaceEntry.js

@@ -0,0 +1,246 @@
+/**
+ * Workspace 执行上下文的内部组合对象。
+ *
+ * 关键点（中文）
+ * - Agent 仍是身份、模型、指令与 Plugin 的唯一拥有者。
+ * - 当前对象只组合 Workspace Tool、Plugin Context、日志与后台资源。
+ * - Session 的所有权属于 Agent.sessions；本对象只提供内部执行上下文。
+ * - 它不是公开领域对象，也不是 AgentWorkspace。
+ */
+import { create_plugin_context } from "../plugin/core/PluginContext.js";
+import { register_plugin_http_routes } from "../plugin/core/PluginHttpRoutes.js";
+import { list_plugin_states } from "../plugin/core/PluginStateController.js";
+import { Logger } from "../utils/logger/Logger.js";
+import { generate_id } from "../utils/Id.js";
+import { resolve_session_system_messages, } from "../executor/composer/system/default/SystemDomain.js";
+import { agent_embassy, agent_is_in_city, get_agent_storage, plugin_storage_scope, release_workspace_entry } from "../internal/AgentRuntime.js";
+const RESERVED_PLUGIN_TOOL_NAMES = new Set(["plugin_read", "plugin_call"]);
+/** 拒绝普通 Tool 占用 PluginRegistry 的稳定桥接名称。 */
+function assert_no_reserved_plugin_tools(source, source_name) {
+    for (const tool_name of Object.keys(source)) {
+        if (RESERVED_PLUGIN_TOOL_NAMES.has(tool_name)) {
+            throw new Error(`Agent tool name conflict: "${tool_name}" is reserved for PluginRegistry (${source_name})`);
+        }
+    }
+}
+/** 注册 Tool Set，并拒绝不同来源静默覆盖。 */
+function register_tools(target, source, source_name) {
+    for (const [tool_name, tool_definition] of Object.entries(source)) {
+        if (Object.prototype.hasOwnProperty.call(target, tool_name)) {
+            throw new Error(`Agent tool name conflict: "${tool_name}" from ${source_name}`);
+        }
+        target[tool_name] = tool_definition;
+    }
+}
+/** Agent 在一个 Workspace 中的内部执行上下文。 */
+export class WorkspaceEntry {
+    /** 拥有当前作用域的 Agent。 */
+    agent;
+    /** 当前 Workspace。 */
+    workspace;
+    /** 当前 Workspace ID。 */
+    workspace_id;
+    /** 当前 Workspace 下的 Tool 集合。 */
+    tools;
+    /** 当前 Workspace Context 绑定的 Agent Plugin 调用面。 */
+    plugins;
+    /**
+     * 当前 Workspace 的内部 Session 查询视图；实际所有权仍属于 Agent.sessions。
+     * 该视图只供 City transport 和内部测试装配使用，不是新的 Session 所有者。
+     */
+    sessions;
+    /** 当前 Workspace 的 Session、日志和调度数据根路径。 */
+    data_path;
+    context;
+    logger;
+    unsubscribe_env;
+    unsubscribe_plugins;
+    storage;
+    plugin_contexts = new Map();
+    leave_promise;
+    constructor(options) {
+        this.agent = options.agent;
+        this.workspace = options.workspace;
+        this.workspace_id = options.workspace.id;
+        const storage = get_agent_storage(this.agent);
+        this.storage = storage;
+        this.data_path = storage.root_path;
+        if (!agent_is_in_city(this.agent)) {
+            this.workspace.shell?.bind({
+                root_path: this.workspace.path,
+                // 无 City 时内部状态仍在内存；Shell 的审批/临时文件必须落在真实项目根目录。
+                data_path: this.workspace.path,
+            });
+        }
+        this.logger = new Logger();
+        this.logger.bind_storage(storage.files, storage.root_path, {
+            agent_id: this.agent.id,
+            workspace_id: this.workspace_id,
+        });
+        let contextual_plugins;
+        const context_input = {
+            agent_id: this.agent.id,
+            workspace_id: this.workspace_id,
+            workspace_path: this.workspace.path,
+            data_path: this.data_path,
+            files: this.workspace.files,
+            data_files: storage.files,
+            ...(this.workspace.shell ? { shell: this.workspace.shell } : {}),
+            logger: this.logger,
+            embassy: agent_embassy(this.agent),
+            get_workspace_env: () => this.workspace.get_env(),
+            get_instructions: () => this.agent.get_instructions(),
+            get_plugins: () => {
+                if (!contextual_plugins)
+                    throw new Error("WorkspaceEntry plugins are not initialized");
+                return contextual_plugins;
+            },
+            get_sessions: () => {
+                return this.agent.sessions;
+            },
+        };
+        this.context = create_plugin_context(context_input);
+        this.agent.plugin_registry.bind_workspace_context(this.context, (plugin_name) => this.get_plugin_context(plugin_name, context_input));
+        contextual_plugins = this.agent.plugin_registry.contextual(this.context);
+        this.plugins = contextual_plugins;
+        this.tools = {};
+        assert_no_reserved_plugin_tools(this.workspace.tools, "WorkspaceTools");
+        assert_no_reserved_plugin_tools(this.agent.custom_tools, "AgentOptions.tools");
+        register_tools(this.tools, this.workspace.tools, "WorkspaceTools");
+        register_tools(this.tools, this.agent.plugin_registry.tools(this.context), "PluginRegistry");
+        register_tools(this.tools, this.agent.custom_tools, "AgentOptions.tools");
+        this.sessions = {
+            create: async (input) => await this.agent.sessions.create({ ...(input || {}), workspace: this.workspace }),
+            get: async (session_id, input) => await this.agent.sessions.get(session_id, { ...(input || {}), workspace: this.workspace }),
+            list: async (input) => await this.agent.sessions.list({ ...(input || {}), workspace_id: this.workspace_id }),
+            archive: async (input) => {
+                await this.agent.sessions.get(input.id, { workspace: this.workspace });
+                return await this.agent.sessions.archive(input);
+            },
+            archived: async (input) => await this.agent.sessions.archived({ ...(input || {}), workspace_id: this.workspace_id }),
+            clean_archive: async () => await this.agent.sessions.clean_archive(),
+            runtime: (session_id) => this.agent.sessions.runtime(session_id),
+            list_executing_session_ids: () => this.agent.sessions.list_executing_session_ids(this.workspace_id),
+            remove: async (session_id) => {
+                await this.agent.sessions.get(session_id, { workspace: this.workspace });
+                return await this.agent.sessions.remove(session_id);
+            },
+            clear_messages: async (session_id) => {
+                await this.agent.sessions.get(session_id, { workspace: this.workspace });
+                return await this.agent.sessions.clear_messages(session_id);
+            },
+        };
+        this.unsubscribe_env = this.workspace.subscribe_env((env) => {
+            this.agent.sessions.broadcast_env({ ...env }, generate_id(), this.workspace_id);
+        });
+        this.unsubscribe_plugins = this.agent.plugin_registry.subscribe_change((change) => {
+            for (const tool_name of RESERVED_PLUGIN_TOOL_NAMES)
+                delete this.tools[tool_name];
+            register_tools(this.tools, this.agent.plugin_registry.tools(this.context), "PluginRegistry");
+            const verb = change.type === "register" ? "registered" : "unregistered";
+            this.agent.sessions.broadcast_plugins({
+                command_id: generate_id(),
+                title: `Agent plugin ${change.plugin_name} ${verb}`,
+                plugins: this.agent.plugin_registry.execution_view(this.context),
+                workspace_id: this.workspace_id,
+            });
+        });
+    }
+    /** 当前 Agent ID。 */
+    get id() {
+        return this.agent.id;
+    }
+    /** 返回当前 Workspace 的 Shell。 */
+    get_shell() {
+        return this.workspace.shell;
+    }
+    /** 返回当前 Workspace 的日志器。 */
+    get_logger() {
+        return this.logger;
+    }
+    /** 列出当前 Agent 注册的 Plugin 状态。 */
+    list_plugin_states() {
+        return list_plugin_states({ context: this.context });
+    }
+    /** 将 Plugin HTTP 路由绑定到当前 Workspace Context。 */
+    register_plugin_http_routes(app) {
+        register_plugin_http_routes({
+            app,
+            get_context: (plugin_name) => this.agent.plugin_registry.plugin_context(this.context, plugin_name),
+            plugins: this.agent.plugin_registry.snapshots()
+                .map((snapshot) => this.agent.plugin_registry.get(snapshot.name))
+                .filter((plugin) => plugin !== null),
+        });
+    }
+    /** 解析指定 Session 当前可见的完整 system messages。 */
+    async resolve_system_messages(input) {
+        return await resolve_session_system_messages({
+            project_root: this.workspace.path,
+            session_id: input.session_id,
+            profile: input.profile || "chat",
+            static_system_prompts: [...this.agent.get_instructions()],
+            context: this.context,
+        });
+    }
+    /** 离开当前 Workspace 并释放 Agent 独享的执行资源。 */
+    async leave() {
+        this.leave_promise ??= (async () => {
+            const errors = [];
+            const cleanup_steps = [
+                () => this.unsubscribe_env(),
+                () => this.unsubscribe_plugins(),
+                async () => await this.agent.sessions.stop_executing_sessions(this.workspace_id),
+                () => this.agent.sessions.dispose_title_generation(this.workspace_id),
+                async () => await this.logger.save_all_logs(),
+                ...(agent_is_in_city(this.agent) ? [] : [async () => await this.workspace.dispose()]),
+            ];
+            for (const cleanup of cleanup_steps) {
+                try {
+                    await cleanup();
+                }
+                catch (error) {
+                    errors.push(error);
+                }
+            }
+            release_workspace_entry(this.agent, this.workspace_id, this);
+            this.agent.plugin_registry.unbind_workspace_context(this.context);
+            if (errors.length > 0) {
+                throw new AggregateError(errors, `WorkspaceEntry cleanup failed: ${this.workspace_id}`);
+            }
+        })();
+        await this.leave_promise;
+    }
+    /** 返回当前 Workspace 的 PluginContext，供 Agent 级调度器解析执行上下文。 */
+    get_context() {
+        return this.context;
+    }
+    /** 返回单个 Session 创建所需的 Workspace 执行上下文。 */
+    get_session_context() {
+        return {
+            workspace_path: this.workspace.path,
+            workspace_id: this.workspace_id,
+            logger: this.logger,
+            tools: this.tools,
+            get_workspace_env: () => this.workspace.get_env(),
+            get_agent_plugins: () => this.agent.plugin_registry.execution_view(this.context),
+            store: this.storage.sessions,
+        };
+    }
+    /** 返回指定 Plugin 的 Agent 级运行时 Context。 */
+    get_plugin_context(plugin_name, input) {
+        const key = String(plugin_name || "").trim();
+        const existing = this.plugin_contexts.get(key);
+        if (existing)
+            return existing;
+        const plugin_scope = plugin_storage_scope(this.agent, key);
+        const plugin_files = plugin_scope.files;
+        const context = create_plugin_context({
+            ...input,
+            data_path: plugin_scope.root_path,
+            data_files: plugin_files,
+        });
+        this.plugin_contexts.set(key, context);
+        return context;
+    }
+}
+//# sourceMappingURL=WorkspaceEntry.js.map

package/bin/agent/WorkspaceEntry.js.map

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

package/bin/agent/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * `@downcity/agent/agent` 的 Agent 主体入口。
+ */
+export { Agent } from "./Agent.js";
+//# sourceMappingURL=index.d.ts.map

package/bin/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/bin/agent/index.js

@@ -0,0 +1,5 @@
+/**
+ * `@downcity/agent/agent` 的 Agent 主体入口。
+ */
+export { Agent } from "./Agent.js";
+//# sourceMappingURL=index.js.map

package/bin/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/bin/city/host/CityHostRegistry.d.ts

@@ -0,0 +1,44 @@
+/**
+ * City 宿主进程协调协议。
+ *
+ * 该模块只协调 CLI 与 Desktop 的 City 宿主，不保存 Agent 配置，也不改变
+ * Agent 的生命周期模型。宿主启动前读取状态，确认后可以请求已有宿主退出。
+ */
+/** City 宿主类型。 */
+export type CityHostOwner = "cli" | "desktop";
+/** City 宿主状态文件内容。 */
+export interface CityHostState {
+    /** 当前宿主类型。 */
+    owner: CityHostOwner;
+    /** 操作系统进程 ID。 */
+    pid: number;
+    /** 本次宿主实例的唯一 ID。 */
+    instance_id: string;
+    /** 宿主启动时间。 */
+    started_at: string;
+    /** 可选 HTTP 地址。 */
+    http_host?: string;
+    /** 可选 HTTP 端口。 */
+    http_port?: number;
+    /** 可选 RPC 地址。 */
+    rpc_host?: string;
+    /** 可选 RPC 端口。 */
+    rpc_port?: number;
+}
+/** 当前宿主状态文件路径。 */
+export declare function get_city_host_state_path(): string;
+/** 生成本次宿主实例 ID。 */
+export declare function create_city_host_instance_id(): string;
+/** 读取当前 City 宿主状态。无效或已退出的状态返回 null。 */
+export declare function read_city_host_state(): Promise<CityHostState | null>;
+/** 登记当前 City 宿主。 */
+export declare function register_city_host(state: CityHostState): Promise<void>;
+/** 只删除仍属于当前实例的宿主状态。 */
+export declare function unregister_city_host(instance_id: string): Promise<void>;
+/** 请求已有宿主退出并等待进程释放资源。 */
+export declare function request_city_host_shutdown(state: CityHostState, timeout_ms?: number): Promise<void>;
+/** 等待指定宿主进程退出；超时不会强制杀死进程。 */
+export declare function wait_for_city_host_exit(state: CityHostState, timeout_ms?: number): Promise<void>;
+/** 检查进程是否存活。 */
+export declare function is_process_alive(pid: number): boolean;
+//# sourceMappingURL=CityHostRegistry.d.ts.map

package/bin/city/host/CityHostRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CityHostRegistry.d.ts","sourceRoot":"","sources":["../../../src/city/host/CityHostRegistry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,iBAAiB;AACjB,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,SAAS,CAAC;AAE9C,qBAAqB;AACrB,MAAM,WAAW,aAAa;IAC5B,cAAc;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,kBAAkB;AAClB,wBAAgB,wBAAwB,IAAI,MAAM,CAIjD;AAED,mBAAmB;AACnB,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED,uCAAuC;AACvC,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA+C1E;AAED,oBAAoB;AACpB,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB5E;AAED,uBAAuB;AACvB,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB7E;AAED,yBAAyB;AACzB,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,aAAa,EACpB,UAAU,SAAS,GAClB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,6BAA6B;AAC7B,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,aAAa,EACpB,UAAU,SAAS,GAClB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,gBAAgB;AAChB,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOrD"}

package/bin/city/host/CityHostRegistry.js

@@ -0,0 +1,225 @@
+/**
+ * City 宿主进程协调协议。
+ *
+ * 该模块只协调 CLI 与 Desktop 的 City 宿主，不保存 Agent 配置，也不改变
+ * Agent 的生命周期模型。宿主启动前读取状态，确认后可以请求已有宿主退出。
+ */
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { createConnection } from "node:net";
+import { randomUUID } from "node:crypto";
+/** 当前宿主状态文件路径。 */
+export function get_city_host_state_path() {
+    const root_path = String(process.env.DC_PLATFORM_ROOT || "").trim()
+        || path.join(os.homedir(), ".downcity");
+    return path.join(path.resolve(root_path), "runtimes", "city", "host.json");
+}
+/** 生成本次宿主实例 ID。 */
+export function create_city_host_instance_id() {
+    return randomUUID();
+}
+/** 读取当前 City 宿主状态。无效或已退出的状态返回 null。 */
+export async function read_city_host_state() {
+    const file_path = get_city_host_state_path();
+    let file_identity;
+    try {
+        const file_handle = await fs.open(file_path, "r");
+        let content;
+        try {
+            const [raw, stat] = await Promise.all([
+                file_handle.readFile("utf8"),
+                file_handle.stat(),
+            ]);
+            content = raw;
+            file_identity = { dev: stat.dev, ino: stat.ino };
+        }
+        finally {
+            await file_handle.close();
+        }
+        const value = JSON.parse(content);
+        if (value.owner !== "cli" && value.owner !== "desktop") {
+            await remove_city_host_state_if_same(file_path, file_identity);
+            return null;
+        }
+        if (!Number.isInteger(value.pid) || Number(value.pid) <= 0) {
+            await remove_city_host_state_if_same(file_path, file_identity);
+            return null;
+        }
+        if (!String(value.instance_id || "").trim() || !String(value.started_at || "").trim()) {
+            await remove_city_host_state_if_same(file_path, file_identity);
+            return null;
+        }
+        if (!is_process_alive(Number(value.pid))) {
+            await remove_city_host_state_if_same(file_path, file_identity);
+            return null;
+        }
+        return {
+            owner: value.owner,
+            pid: Number(value.pid),
+            instance_id: String(value.instance_id),
+            started_at: String(value.started_at),
+            ...(typeof value.http_host === "string" ? { http_host: value.http_host } : {}),
+            ...(valid_port(value.http_port) ? { http_port: Number(value.http_port) } : {}),
+            ...(typeof value.rpc_host === "string" ? { rpc_host: value.rpc_host } : {}),
+            ...(valid_port(value.rpc_port) ? { rpc_port: Number(value.rpc_port) } : {}),
+        };
+    }
+    catch {
+        if (file_identity)
+            await remove_city_host_state_if_same(file_path, file_identity);
+        return null;
+    }
+}
+/** 登记当前 City 宿主。 */
+export async function register_city_host(state) {
+    const file_path = get_city_host_state_path();
+    await fs.mkdir(path.dirname(file_path), { recursive: true });
+    if (await claim_city_host_state(file_path, state))
+        return;
+    const current = await read_city_host_state();
+    if (current) {
+        throw new Error(`City is already owned by ${current.owner} (pid: ${current.pid})`);
+    }
+    if (!await claim_city_host_state(file_path, state)) {
+        const owner = await read_city_host_state();
+        throw new Error(owner
+            ? `City is already owned by ${owner.owner} (pid: ${owner.pid})`
+            : "City host ownership could not be acquired");
+    }
+}
+/** 只删除仍属于当前实例的宿主状态。 */
+export async function unregister_city_host(instance_id) {
+    const file_path = get_city_host_state_path();
+    try {
+        const file_handle = await fs.open(file_path, "r");
+        let current;
+        let file_identity;
+        try {
+            const [content, stat] = await Promise.all([
+                file_handle.readFile("utf8"),
+                file_handle.stat(),
+            ]);
+            current = JSON.parse(content);
+            file_identity = { dev: stat.dev, ino: stat.ino };
+        }
+        finally {
+            await file_handle.close();
+        }
+        if (String(current.instance_id || "") !== String(instance_id || ""))
+            return;
+        await remove_city_host_state_if_same(file_path, file_identity);
+    }
+    catch {
+        return;
+    }
+}
+/** 请求已有宿主退出并等待进程释放资源。 */
+export async function request_city_host_shutdown(state, timeout_ms = 10_000) {
+    if (state.rpc_host && state.rpc_port) {
+        const accepted = await request_rpc_shutdown(state);
+        if (!accepted && is_process_alive(state.pid))
+            process.kill(state.pid, "SIGTERM");
+    }
+    else if (is_process_alive(state.pid)) {
+        process.kill(state.pid, "SIGTERM");
+    }
+    await wait_for_city_host_exit(state, timeout_ms);
+}
+/** 等待指定宿主进程退出；超时不会强制杀死进程。 */
+export async function wait_for_city_host_exit(state, timeout_ms = 10_000) {
+    const started_at = Date.now();
+    while (is_process_alive(state.pid)) {
+        if (Date.now() - started_at >= timeout_ms) {
+            throw new Error(`Timed out waiting for ${state.owner} City to stop (pid: ${state.pid})`);
+        }
+        await sleep(100);
+    }
+    await unregister_city_host(state.instance_id);
+}
+/** 检查进程是否存活。 */
+export function is_process_alive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function request_rpc_shutdown(state) {
+    const rpc_host = state.rpc_host;
+    const rpc_port = state.rpc_port;
+    if (!rpc_host || !rpc_port)
+        return false;
+    return await new Promise((resolve) => {
+        const socket = createConnection({ host: rpc_host, port: rpc_port });
+        let buffered = "";
+        let settled = false;
+        const finish = (accepted) => {
+            if (settled)
+                return;
+            settled = true;
+            socket.destroy();
+            resolve(accepted);
+        };
+        socket.setTimeout(1_500);
+        socket.once("connect", () => socket.write(`${JSON.stringify({
+            id: `city-shutdown-${randomUUID()}`,
+            method: "internal.city.shutdown",
+        })}\n`));
+        socket.on("data", (chunk) => {
+            buffered += chunk.toString("utf8");
+            const newline_index = buffered.indexOf("\n");
+            if (newline_index < 0)
+                return;
+            try {
+                const frame = JSON.parse(buffered.slice(0, newline_index));
+                finish(frame.success === true);
+            }
+            catch {
+                finish(false);
+            }
+        });
+        socket.once("timeout", () => finish(false));
+        socket.once("error", () => finish(false));
+        socket.once("close", () => finish(false));
+    });
+}
+function valid_port(value) {
+    return Number.isInteger(value) && Number(value) > 0 && Number(value) <= 65_535;
+}
+function has_error_code(error, code) {
+    return error instanceof Error && "code" in error && error.code === code;
+}
+async function claim_city_host_state(file_path, state) {
+    const temporary_path = `${file_path}.${state.instance_id}.tmp`;
+    await fs.writeFile(temporary_path, `${JSON.stringify(state, null, 2)}\n`, "utf8");
+    try {
+        await fs.link(temporary_path, file_path);
+        return true;
+    }
+    catch (error) {
+        if (has_error_code(error, "EEXIST"))
+            return false;
+        throw error;
+    }
+    finally {
+        await fs.rm(temporary_path, { force: true });
+    }
+}
+async function remove_city_host_state_if_same(file_path, file_identity) {
+    try {
+        const current = await fs.stat(file_path);
+        if (current.dev !== file_identity.dev || current.ino !== file_identity.ino)
+            return;
+        await fs.rm(file_path, { force: true });
+    }
+    catch {
+        return;
+    }
+}
+async function sleep(timeout_ms) {
+    await new Promise((resolve) => setTimeout(resolve, timeout_ms));
+}
+//# sourceMappingURL=CityHostRegistry.js.map