@downcity/agent 1.1.408 → 1.1.437

package/bin/city/host/CityHostRegistry.js

@@ -1,225 +0,0 @@
-/**
- * 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

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

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

package/bin/city/index.d.ts

@@ -1,22 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,10 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,99 +0,0 @@
-/**
- * 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

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