@downcity/agent 1.1.337 → 1.1.399

package/bin/city/host/CityHostRegistry.js.map

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

package/bin/city/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @downcity/agent - Agent 内存索引与 HTTP/RPC 转发器。
+ *
+ * City 维护多 Agent 运行时引用并提供可选 HTTP/RPC transport。
+ * Agent、Session 与 Plugin 执行能力由 `@/index.js` 提供，Workspace 资源由
+ * `@downcity/workspace` 提供。
+ */
+export { City } from "./runtime/City.js";
+export type { CityAgents, CityGroups, CityListenOptions, CityOptions, CityRuntimeOptions, CityWorkspaces, } from "./types/City.js";
+export type { PluginHostContext, PluginHostExtensions, AgentPluginModule, } from "./types/PluginHostContext.js";
+export { create_city_host_instance_id, get_city_host_state_path, is_process_alive, read_city_host_state, register_city_host, request_city_host_shutdown, unregister_city_host, wait_for_city_host_exit, } from "./host/CityHostRegistry.js";
+export type { CityHostOwner, CityHostState } from "./host/CityHostRegistry.js";
+/** Transport 实现由 City.http() / City.rpc() 持有，不作为独立构造器公开。 */
+export type { AgentHttpBinding, AgentHttpListenOptions, } from "./transport/types/AgentHttpBinding.js";
+export type { AgentHttpRuntimeOptions } from "./transport/types/AgentHttpRuntime.js";
+export type { CityHttpRuntimeOptions } from "./transport/types/CityHttpRuntime.js";
+export type { CityAgentHttpExtension } from "./transport/types/CityHttpRuntime.js";
+export type { AgentRpcBinding, AgentRpcListenOptions, } from "./transport/types/AgentRpcBinding.js";
+export type { AgentRpcRuntimeOptions } from "./transport/types/AgentRpcRuntime.js";
+export type { CityRpcRuntimeOptions } from "./transport/types/CityRpcRuntime.js";
+export type { AgentSessionModelResolver } from "./transport/types/AgentSessionModelResolver.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/city/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,YAAY,EACV,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE/E,4DAA4D;AAC5D,YAAY,EACV,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AACrF,YAAY,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACnF,YAAY,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACnF,YAAY,EACV,eAAe,EACf,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACjF,YAAY,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC"}

package/bin/city/index.js

@@ -0,0 +1,10 @@
+/**
+ * @downcity/agent - Agent 内存索引与 HTTP/RPC 转发器。
+ *
+ * City 维护多 Agent 运行时引用并提供可选 HTTP/RPC transport。
+ * Agent、Session 与 Plugin 执行能力由 `@/index.js` 提供，Workspace 资源由
+ * `@downcity/workspace` 提供。
+ */
+export { City } from "./runtime/City.js";
+export { create_city_host_instance_id, get_city_host_state_path, is_process_alive, read_city_host_state, register_city_host, request_city_host_shutdown, unregister_city_host, wait_for_city_host_exit, } from "./host/CityHostRegistry.js";
+//# sourceMappingURL=index.js.map

package/bin/city/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/city/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAczC,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,4BAA4B,CAAC"}

package/bin/city/runtime/City.d.ts

@@ -0,0 +1,99 @@
+/**
+ * City：Workspace、Embassy 与统一 transport 的资源容器。
+ *
+ * City 不创建 Agent、Session 或 Plugin。应用创建 Agent 后通过
+ * `city.agents.add(agent)` 加入当前容器；City 管理 Agent 集合、Workspace/Embassy
+ * 资源与统一 transport。
+ */
+import type { WorkspaceEntry } from "../../agent/WorkspaceEntry.js";
+import type { WorkspaceBase } from "@downcity/workspace";
+import type { StorageProvider } from "@downcity/workspace";
+import { CityHTTP } from "../transport/http/CityHTTP.js";
+import { CityRPC } from "../transport/rpc/CityRPC.js";
+import type { CityAgents, CityGroups, CityListenOptions, CityOptions, CityWorkspaces } from "../types/City.js";
+/** Agent 实例索引与 transport 宿主。 */
+export declare class City {
+    /** City 持有的底层 Storage；默认是进程内存储。 */
+    readonly storage: StorageProvider;
+    /** 当前 City 引用的 Agent，按稳定 ID 索引。 */
+    private readonly agents_by_id;
+    /** 当前 City 引用的 Group，按稳定 ID 索引。 */
+    private readonly groups_by_id;
+    /** City 面向应用的 Agent 集合入口。 */
+    readonly agents: CityAgents;
+    /** City 面向宿主的 Group 集合入口。 */
+    readonly groups: CityGroups;
+    /** City 面向宿主的 Workspace 集合入口。 */
+    readonly workspaces: CityWorkspaces;
+    /** City 持有的 Workspace 资源，按稳定 ID 索引。 */
+    private readonly workspaces_by_id;
+    /** City 绑定的 Embassy 服务入口。 */
+    readonly embassy?: CityOptions["embassy"];
+    /** 正在解除注册的 Agent；对查询立即不可见，失败后恢复可见。 */
+    private readonly removing_agent_ids;
+    /** 每个 Agent 当前唯一的解除注册流程。 */
+    private readonly removal_promises;
+    /** 宿主提供的按需 Workspace 创建能力。 */
+    private readonly resolve_workspace?;
+    /** 相同 Agent/Workspace 目标当前唯一的进入流程。 */
+    private readonly workspace_entry_promises;
+    /** 当前 City 唯一的 HTTP transport。 */
+    private readonly http_transport;
+    /** 当前 City 唯一的 RPC transport。 */
+    private readonly rpc_transport;
+    /** City transport 组合操作的唯一串行链。 */
+    private transport_operation_chain;
+    /** City 自身的生命周期状态。 */
+    private city_status;
+    /** City 关闭流程；并发调用共享同一个 Promise。 */
+    private close_promise?;
+    constructor(options?: CityOptions);
+    /** 按稳定 ID 获取 City 管理的 Group。 */
+    private get_group;
+    /** 返回 City 管理的 Group 稳定快照。 */
+    private list_groups;
+    /** 将已创建 Group 加入 City，并校验成员属于当前 City。 */
+    private add_group;
+    /** 释放并移除一个 Group。 */
+    private remove_group;
+    /** 返回 City 持有的 Workspace；不存在时返回 null。 */
+    /** 内部 AgentCity 协议；用户应使用 `city.workspaces.get()`。 */
+    get_workspace(workspace_id_input: string): WorkspaceBase | null;
+    /** 返回 City 持有的 Workspace 稳定快照。 */
+    private list_workspaces;
+    /** 返回当前 City 已注册 Agent 的稳定快照。 */
+    private list_agents;
+    /** 按稳定 ID 返回可直接使用的 Agent；不存在时返回 null。 */
+    private get_agent;
+    /** 按稳定 ID 返回内部 transport 所需 Agent；不存在时抛出明确错误。 */
+    private require_agent;
+    /** 按 Agent ID 与 Workspace ID 返回 transport 所需的明确执行作用域。 */
+    require_workspace(agent_id_input: string, workspace_id_input: string): WorkspaceEntry;
+    /** 按需解析并进入 Workspace；相同目标的并发请求共享一次创建流程。 */
+    enter_workspace(agent_id_input: string, workspace_id_input: string): Promise<WorkspaceEntry>;
+    /** 停止、释放并从 City 移除指定 Agent。 */
+    private remove_agent;
+    /** 启动 City 唯一的 HTTP/RPC transport。 */
+    http(options: Parameters<CityHTTP["listen"]>[0]): Promise<CityHTTP>;
+    /** 启动 City 唯一的 RPC transport。 */
+    rpc(options?: Parameters<CityRPC["listen"]>[0]): Promise<CityRPC>;
+    /** 启动 City 唯一的 HTTP/RPC transport。 */
+    listen(options: CityListenOptions): Promise<void>;
+    /** 幂等关闭 transport，并按依赖顺序释放绑定 Agent 与 City Workspace。 */
+    close(): Promise<void>;
+    /** 将已创建 Agent 加入集合并建立唯一 City 绑定。 */
+    private add_agent;
+    /** Agent 自行释放时清除 City 运行时引用。 */
+    release_agent(agent: {
+        readonly id: string;
+    }): void;
+    /** 把宿主按需解析出的 Workspace 纳入 City 资源索引。 */
+    private add_workspace;
+    /** 将 City 的底层 Storage 绑定到 Workspace 的 Shell 运行目录。 */
+    private bind_workspace_shell;
+    /** 拒绝在 City 关闭后继续注入运行时资源。 */
+    private assert_active;
+    /** 串行执行一次 City transport 组合操作。 */
+    private enqueue_transport_operation;
+}
+//# sourceMappingURL=City.d.ts.map

package/bin/city/runtime/City.d.ts.map

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

package/bin/city/runtime/City.js

@@ -0,0 +1,376 @@
+/**
+ * City：Workspace、Embassy 与统一 transport 的资源容器。
+ *
+ * City 不创建 Agent、Session 或 Plugin。应用创建 Agent 后通过
+ * `city.agents.add(agent)` 加入当前容器；City 管理 Agent 集合、Workspace/Embassy
+ * 资源与统一 transport。
+ */
+import { attach_agent_city, attach_agent_storage, attach_group_storage, detach_group_storage, create_workspace_entry, detach_agent_city, get_workspace_entry, } from "../../internal/index.js";
+import { MemoryStorageProvider } from "@downcity/workspace";
+import { CityHTTP } from "../transport/http/CityHTTP.js";
+import { CityRPC } from "../transport/rpc/CityRPC.js";
+/** Agent 实例索引与 transport 宿主。 */
+export class City {
+    /** City 持有的底层 Storage；默认是进程内存储。 */
+    storage;
+    /** 当前 City 引用的 Agent，按稳定 ID 索引。 */
+    agents_by_id = new Map();
+    /** 当前 City 引用的 Group，按稳定 ID 索引。 */
+    groups_by_id = new Map();
+    /** City 面向应用的 Agent 集合入口。 */
+    agents;
+    /** City 面向宿主的 Group 集合入口。 */
+    groups;
+    /** City 面向宿主的 Workspace 集合入口。 */
+    workspaces;
+    /** City 持有的 Workspace 资源，按稳定 ID 索引。 */
+    workspaces_by_id = new Map();
+    /** City 绑定的 Embassy 服务入口。 */
+    embassy;
+    /** 正在解除注册的 Agent；对查询立即不可见，失败后恢复可见。 */
+    removing_agent_ids = new Set();
+    /** 每个 Agent 当前唯一的解除注册流程。 */
+    removal_promises = new Map();
+    /** 宿主提供的按需 Workspace 创建能力。 */
+    resolve_workspace;
+    /** 相同 Agent/Workspace 目标当前唯一的进入流程。 */
+    workspace_entry_promises = new Map();
+    /** 当前 City 唯一的 HTTP transport。 */
+    http_transport;
+    /** 当前 City 唯一的 RPC transport。 */
+    rpc_transport;
+    /** City transport 组合操作的唯一串行链。 */
+    transport_operation_chain = Promise.resolve();
+    /** City 自身的生命周期状态。 */
+    city_status = "active";
+    /** City 关闭流程；并发调用共享同一个 Promise。 */
+    close_promise;
+    constructor(options = {}) {
+        this.storage = options.storage || new MemoryStorageProvider();
+        this.embassy = options.embassy;
+        for (const workspace of options.workspaces ?? []) {
+            const workspace_id = String(workspace?.id || "").trim();
+            if (!workspace_id)
+                throw new Error("City requires Workspace with a stable id");
+            if (this.workspaces_by_id.has(workspace_id)) {
+                throw new Error(`Workspace already exists in City: ${workspace_id}`);
+            }
+            this.bind_workspace_shell(workspace);
+            this.workspaces_by_id.set(workspace_id, workspace);
+        }
+        const runtime_options = options.runtime ?? {};
+        this.resolve_workspace = runtime_options.resolve_workspace;
+        this.http_transport = new CityHTTP(this, runtime_options.http);
+        this.rpc_transport = new CityRPC(this, runtime_options.rpc);
+        this.agents = Object.freeze({
+            add: (agent) => this.add_agent(agent),
+            get: (agent_id) => this.get_agent(agent_id),
+            list: () => this.list_agents(),
+            remove: async (agent_id) => await this.remove_agent(agent_id),
+        });
+        this.groups = Object.freeze({
+            add: (group) => this.add_group(group),
+            get: (group_id) => this.get_group(group_id),
+            list: () => this.list_groups(),
+            remove: async (group_id) => await this.remove_group(group_id),
+        });
+        this.workspaces = Object.freeze({
+            add: (workspace) => this.add_workspace(workspace),
+            get: (workspace_id) => this.get_workspace(workspace_id),
+            list: () => this.list_workspaces(),
+        });
+    }
+    /** 按稳定 ID 获取 City 管理的 Group。 */
+    get_group(group_id_input) {
+        return this.groups_by_id.get(String(group_id_input || "").trim()) ?? null;
+    }
+    /** 返回 City 管理的 Group 稳定快照。 */
+    list_groups() {
+        return [...this.groups_by_id.values()];
+    }
+    /** 将已创建 Group 加入 City，并校验成员属于当前 City。 */
+    add_group(group) {
+        this.assert_active();
+        if (!group?.id)
+            throw new Error("City requires a Group with a stable ID");
+        const existing = this.groups_by_id.get(group.id);
+        if (existing && existing !== group)
+            throw new Error(`Group already exists in City: ${group.id}`);
+        if (existing)
+            return existing;
+        for (const member of group.members) {
+            if (this.agents_by_id.get(member.id) !== member) {
+                throw new Error(`Group member is not registered in City: ${member.id}`);
+            }
+        }
+        attach_group_storage(group, this.storage, this);
+        this.groups_by_id.set(group.id, group);
+        return group;
+    }
+    /** 释放并移除一个 Group。 */
+    async remove_group(group_id_input) {
+        const group_id = String(group_id_input || "").trim();
+        const group = this.groups_by_id.get(group_id) ?? null;
+        if (!group)
+            return null;
+        await group.dispose();
+        await detach_group_storage(group, this);
+        this.groups_by_id.delete(group_id);
+        return group;
+    }
+    /** 返回 City 持有的 Workspace；不存在时返回 null。 */
+    /** 内部 AgentCity 协议；用户应使用 `city.workspaces.get()`。 */
+    get_workspace(workspace_id_input) {
+        const workspace_id = String(workspace_id_input || "").trim();
+        return this.workspaces_by_id.get(workspace_id) ?? null;
+    }
+    /** 返回 City 持有的 Workspace 稳定快照。 */
+    list_workspaces() {
+        return [...this.workspaces_by_id.values()];
+    }
+    /** 返回当前 City 已注册 Agent 的稳定快照。 */
+    list_agents() {
+        return [...this.agents_by_id.entries()]
+            .filter(([agent_id]) => !this.removing_agent_ids.has(agent_id))
+            .map(([, agent]) => agent);
+    }
+    /** 按稳定 ID 返回可直接使用的 Agent；不存在时返回 null。 */
+    get_agent(agent_id_input) {
+        const agent_id = String(agent_id_input || "").trim();
+        if (this.removing_agent_ids.has(agent_id))
+            return null;
+        return this.agents_by_id.get(agent_id) ?? null;
+    }
+    /** 按稳定 ID 返回内部 transport 所需 Agent；不存在时抛出明确错误。 */
+    require_agent(agent_id_input) {
+        const agent_id = String(agent_id_input || "").trim();
+        const agent = this.get_agent(agent_id);
+        if (!agent)
+            throw new Error(`Agent not found in City: ${agent_id}`);
+        return agent;
+    }
+    /** 按 Agent ID 与 Workspace ID 返回 transport 所需的明确执行作用域。 */
+    require_workspace(agent_id_input, workspace_id_input) {
+        const agent = this.require_agent(agent_id_input);
+        const workspace_id = String(workspace_id_input || "").trim();
+        if (!workspace_id)
+            throw new Error("City request requires workspace_id");
+        const entry = get_workspace_entry(agent, workspace_id);
+        if (!entry) {
+            throw new Error(`Agent "${agent.id}" has not entered Workspace: ${workspace_id}`);
+        }
+        return entry;
+    }
+    /** 按需解析并进入 Workspace；相同目标的并发请求共享一次创建流程。 */
+    async enter_workspace(agent_id_input, workspace_id_input) {
+        const agent = this.require_agent(agent_id_input);
+        const workspace_id = String(workspace_id_input || "").trim();
+        if (!workspace_id)
+            throw new Error("City request requires workspace_id");
+        const existing = get_workspace_entry(agent, workspace_id);
+        if (existing)
+            return existing;
+        const city_workspace = this.get_workspace(workspace_id);
+        if (city_workspace)
+            return create_workspace_entry(agent, city_workspace);
+        if (!this.resolve_workspace) {
+            throw new Error(`Agent "${agent.id}" has not entered Workspace: ${workspace_id}`);
+        }
+        const target_key = `${agent.id}/${workspace_id}`;
+        const current = this.workspace_entry_promises.get(target_key);
+        if (current)
+            return await current;
+        const entry_promise = (async () => {
+            const workspace = await this.resolve_workspace(agent, workspace_id);
+            if (workspace.id !== workspace_id) {
+                await workspace.dispose().catch(() => undefined);
+                throw new Error(`Resolved Workspace ID mismatch: expected ${workspace_id}, received ${workspace.id}`);
+            }
+            this.add_workspace(workspace);
+            return create_workspace_entry(agent, workspace);
+        })();
+        this.workspace_entry_promises.set(target_key, entry_promise);
+        try {
+            return await entry_promise;
+        }
+        finally {
+            if (this.workspace_entry_promises.get(target_key) === entry_promise) {
+                this.workspace_entry_promises.delete(target_key);
+            }
+        }
+    }
+    /** 停止、释放并从 City 移除指定 Agent。 */
+    async remove_agent(agent_id_input) {
+        const agent_id = String(agent_id_input || "").trim();
+        const existing_removal = this.removal_promises.get(agent_id);
+        if (existing_removal)
+            return await existing_removal;
+        const agent = this.agents_by_id.get(agent_id) ?? null;
+        if (!agent)
+            return null;
+        this.removing_agent_ids.add(agent_id);
+        const removal = (async () => {
+            try {
+                await this.http_transport.detach_agent(agent_id);
+                const dependent_groups = [...this.groups_by_id.values()]
+                    .filter((group) => group.members.some((member) => member === agent));
+                await Promise.allSettled(dependent_groups.map(async (group) => {
+                    await group.dispose();
+                    this.groups_by_id.delete(group.id);
+                }));
+                await agent.dispose();
+                this.release_agent(agent);
+                return agent;
+            }
+            finally {
+                this.removing_agent_ids.delete(agent_id);
+            }
+        })();
+        this.removal_promises.set(agent_id, removal);
+        try {
+            return await removal;
+        }
+        finally {
+            if (this.removal_promises.get(agent_id) === removal) {
+                this.removal_promises.delete(agent_id);
+            }
+        }
+    }
+    /** 启动 City 唯一的 HTTP/RPC transport。 */
+    async http(options) {
+        this.assert_active();
+        await this.enqueue_transport_operation(async () => {
+            await this.http_transport.listen(options);
+        });
+        return this.http_transport;
+    }
+    /** 启动 City 唯一的 RPC transport。 */
+    async rpc(options) {
+        this.assert_active();
+        await this.enqueue_transport_operation(async () => {
+            await this.rpc_transport.listen(options);
+        });
+        return this.rpc_transport;
+    }
+    /** 启动 City 唯一的 HTTP/RPC transport。 */
+    async listen(options) {
+        this.assert_active();
+        await this.enqueue_transport_operation(async () => {
+            const started = [];
+            try {
+                if (options.rpc) {
+                    const was_listening = Boolean(this.rpc_transport.binding());
+                    await this.rpc_transport.listen(options.rpc);
+                    if (!was_listening)
+                        started.push(async () => await this.rpc_transport.close());
+                }
+                if (options.http) {
+                    const was_listening = Boolean(this.http_transport.binding());
+                    await this.http_transport.listen(options.http);
+                    if (!was_listening)
+                        started.push(async () => await this.http_transport.close());
+                }
+            }
+            catch (error) {
+                await Promise.allSettled(started.reverse().map(async (close) => await close()));
+                throw error;
+            }
+        });
+    }
+    /** 幂等关闭 transport，并按依赖顺序释放绑定 Agent 与 City Workspace。 */
+    async close() {
+        if (this.city_status === "closed")
+            return;
+        if (!this.close_promise) {
+            const close_operation = this.enqueue_transport_operation(async () => {
+                this.city_status = "closing";
+                const results = [];
+                results.push(...await Promise.allSettled([
+                    this.http_transport.close(),
+                    this.rpc_transport.close(),
+                ]));
+                results.push(...await Promise.allSettled([...this.groups_by_id.values()].map(async (group) => {
+                    await group.dispose();
+                    await detach_group_storage(group, this);
+                })));
+                results.push(...await Promise.allSettled(this.agents.list().map(async (agent) => await agent.dispose())));
+                results.push(...await Promise.allSettled([...this.workspaces_by_id.values()].map(async (workspace) => await workspace.dispose())));
+                results.push(...await Promise.allSettled([
+                    this.storage.dispose?.() ?? Promise.resolve(),
+                ]));
+                const errors = results.flatMap((result) => result.status === "rejected" ? [result.reason] : []);
+                if (errors.length > 0) {
+                    this.city_status = "active";
+                    throw new AggregateError(errors, "City transport close failed");
+                }
+                this.agents_by_id.clear();
+                this.groups_by_id.clear();
+                this.workspaces_by_id.clear();
+                this.city_status = "closed";
+            });
+            this.close_promise = close_operation.catch((error) => {
+                this.close_promise = undefined;
+                throw error;
+            });
+        }
+        await this.close_promise;
+    }
+    /** 将已创建 Agent 加入集合并建立唯一 City 绑定。 */
+    add_agent(agent) {
+        this.assert_active();
+        if (!agent?.id)
+            throw new Error("City requires an Agent with a stable ID");
+        if (this.agents_by_id.has(agent.id) || this.removing_agent_ids.has(agent.id)) {
+            throw new Error(`Agent already exists in City: ${agent.id}`);
+        }
+        attach_agent_city(agent, this);
+        attach_agent_storage(agent, this.storage);
+        this.agents_by_id.set(agent.id, agent);
+        return agent;
+    }
+    /** Agent 自行释放时清除 City 运行时引用。 */
+    release_agent(agent) {
+        const current = this.agents_by_id.get(agent.id);
+        if (!current || current !== agent)
+            return;
+        detach_agent_city(current, this);
+        this.agents_by_id.delete(agent.id);
+        void this.http_transport.detach_agent(agent.id).catch(() => undefined);
+    }
+    /** 把宿主按需解析出的 Workspace 纳入 City 资源索引。 */
+    add_workspace(workspace) {
+        this.assert_active();
+        const workspace_id = String(workspace?.id || "").trim();
+        if (!workspace_id)
+            throw new Error("City requires Workspace with a stable id");
+        const existing = this.workspaces_by_id.get(workspace_id);
+        if (existing && existing !== workspace) {
+            throw new Error(`Workspace already exists in City: ${workspace_id}`);
+        }
+        if (existing)
+            return existing;
+        this.bind_workspace_shell(workspace);
+        this.workspaces_by_id.set(workspace_id, workspace);
+        return workspace;
+    }
+    /** 将 City 的底层 Storage 绑定到 Workspace 的 Shell 运行目录。 */
+    bind_workspace_shell(workspace) {
+        workspace.shell?.bind({
+            root_path: workspace.path,
+            data_path: this.storage.open_scope(["workspaces", workspace.id, "shell"]).root_path,
+        });
+    }
+    /** 拒绝在 City 关闭后继续注入运行时资源。 */
+    assert_active() {
+        if (this.city_status !== "active") {
+            throw new Error(`City is ${this.city_status}`);
+        }
+    }
+    /** 串行执行一次 City transport 组合操作。 */
+    enqueue_transport_operation(operation) {
+        const result = this.transport_operation_chain.then(operation);
+        this.transport_operation_chain = result.then(() => undefined, () => undefined);
+        return result;
+    }
+}
+//# sourceMappingURL=City.js.map

package/bin/city/runtime/City.js.map

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

package/bin/city/transport/SerializedTransport.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 串行 transport 生命周期。
+ *
+ * 该对象是 HTTP/RPC Server 状态的唯一拥有者。listen 与 close 按调用顺序执行，
+ * 因此启动过程中收到 close 时，会先完成启动再立即释放，不会留下失联端口。
+ */
+import type { SerializedTransportOptions } from "../types/SerializedTransport.js";
+/** 管理一个可重复监听和关闭的底层 transport。 */
+export declare class SerializedTransport<TOptions, TResource, TBinding> {
+    /** 创建和释放底层资源的实现。 */
+    private readonly options;
+    /** transport 操作的唯一串行链。 */
+    private operation_chain;
+    /** 当前已经成功启动的底层资源。 */
+    private current_resource;
+    /** 当前监听地址；未监听时为空。 */
+    private current_binding;
+    constructor(
+    /** 创建和释放底层资源的实现。 */
+    options: SerializedTransportOptions<TOptions, TResource, TBinding>);
+    /** 按调用顺序启动 transport；已监听时返回现有 binding。 */
+    listen(options: TOptions): Promise<TBinding>;
+    /** 按调用顺序关闭 transport；没有监听时直接完成。 */
+    close(): Promise<void>;
+    /** 返回当前已完成监听的 binding 快照。 */
+    binding(): TBinding | null;
+    /** 将一次状态变化接到唯一操作链，并保证失败后后续操作仍可继续。 */
+    private enqueue;
+}
+//# sourceMappingURL=SerializedTransport.d.ts.map

package/bin/city/transport/SerializedTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerializedTransport.d.ts","sourceRoot":"","sources":["../../../src/city/transport/SerializedTransport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAEtF,iCAAiC;AACjC,qBAAa,mBAAmB,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ;IAW1D,oBAAoB;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX1B,0BAA0B;IAC1B,OAAO,CAAC,eAAe,CAAoC;IAE3D,qBAAqB;IACrB,OAAO,CAAC,gBAAgB,CAA0B;IAElD,qBAAqB;IACrB,OAAO,CAAC,eAAe,CAAyB;;IAG9C,oBAAoB;IACH,OAAO,EAAE,0BAA0B,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC;IAGrF,0CAA0C;IACpC,MAAM,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAUlD,mCAAmC;IAC7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B,6BAA6B;IAC7B,OAAO,IAAI,QAAQ,GAAG,IAAI;IAI1B,qCAAqC;IACrC,OAAO,CAAC,OAAO;CAQhB"}