@downcity/agent 1.1.35 → 1.1.51

package/bin/plugin/types/PluginApi.d.ts

@@ -148,7 +148,7 @@ export interface PluginCliBaseOptions {
      */
     json?: boolean;
     /**
-     * agent 名称（从 managed agent registry 解析到项目路径）。
+     * agent id（从 managed agent registry 解析到项目路径）。
      */
     agent?: string;
 }

package/bin/rpc/Client.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Agent 本机 RPC Client。
+ *
+ * 职责说明（中文）
+ * - 为 `RemoteAgent(rpc://...)` 提供最小客户端实现。
+ * - 复用逐行 JSON（NDJSON）协议，与本机 RPC Server 对接。
+ * - 当前只承载 Session actor 所需方法。
+ */
+import type { AgentCreateSessionInput, AgentListSessionsInput, AgentSessionHistoryInput, AgentSessionHistoryPage, AgentSessionInfo, AgentSessionSummaryPage, AgentSessionSystemSnapshot } from "../types/agent/AgentTypes.js";
+import type { AgentSessionEvent } from "../types/sdk/AgentSessionEvent.js";
+import type { AgentSessionPromptInput } from "../types/sdk/AgentSessionPrompt.js";
+/**
+ * RPC endpoint。
+ */
+export interface RpcClientEndpoint {
+    /** RPC host。 */
+    host: string;
+    /** RPC port。 */
+    port: number;
+}
+/**
+ * RPC Session 订阅句柄。
+ */
+export interface RpcSessionSubscription {
+    /** 当前订阅 id。 */
+    subscription_id: string;
+    /** 取消订阅。 */
+    unsubscribe(): Promise<void>;
+}
+/**
+ * RPC Client。
+ */
+export declare class RpcClient {
+    private readonly endpoint;
+    private socket;
+    private connect_promise;
+    private buffered;
+    private readonly pending_requests;
+    private readonly subscriptions;
+    private request_sequence;
+    constructor(endpoint: RpcClientEndpoint);
+    /**
+     * 列出远程 session。
+     */
+    list_sessions(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
+    /**
+     * 创建远程 session。
+     */
+    create_session(input?: AgentCreateSessionInput): Promise<AgentSessionInfo>;
+    /**
+     * 获取远程 session 信息。
+     */
+    get_session(session_id: string): Promise<AgentSessionInfo>;
+    /**
+     * 发送 prompt。
+     */
+    prompt_session(params: {
+        session_id: string;
+        input: AgentSessionPromptInput;
+    }): Promise<{
+        id: string;
+    }>;
+    /**
+     * 读取 history。
+     */
+    get_session_history(params: {
+        session_id: string;
+        input?: AgentSessionHistoryInput;
+    }): Promise<AgentSessionHistoryPage>;
+    /**
+     * 读取 system snapshot。
+     */
+    get_session_system(session_id: string): Promise<AgentSessionSystemSnapshot>;
+    /**
+     * 分叉 session。
+     */
+    fork_session(params: {
+        session_id: string;
+        message_id?: string;
+    }): Promise<AgentSessionInfo>;
+    /**
+     * 订阅 session 事件。
+     */
+    subscribe_session(params: {
+        session_id: string;
+        on_ready: () => void;
+        on_event: (event: AgentSessionEvent) => void;
+    }): Promise<RpcSessionSubscription>;
+    /**
+     * 关闭底层连接。
+     */
+    close(): Promise<void>;
+    private request;
+    private ensure_connected;
+    private consume_data;
+    private consume_line;
+    private fail_all_pending;
+    private fail_all_subscriptions;
+}
+/**
+ * 解析 rpc url。
+ */
+export declare function parse_rpc_url(url_input: string): RpcClientEndpoint;
+//# sourceMappingURL=Client.d.ts.map

package/bin/rpc/Client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../src/rpc/Client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AA8FjF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,eAAe;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY;IACZ,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqC;IACtE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsC;IACpE,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,QAAQ,EAAE,iBAAiB;IAIvC;;OAEG;IACG,aAAa,CACjB,KAAK,CAAC,EAAE,sBAAsB,GAC7B,OAAO,CAAC,uBAAuB,CAAC;IAQnC;;OAEG;IACG,cAAc,CAClB,KAAK,CAAC,EAAE,uBAAuB,GAC9B,OAAO,CAAC,gBAAgB,CAAC;IAQ5B;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUhE;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE;QAC3B,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,uBAAuB,CAAC;KAChC,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAW3B;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE;QAChC,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,wBAAwB,CAAC;KAClC,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAWpC;;OAEG;IACG,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAUjF;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAW7B;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE;QAC9B,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,IAAI,CAAC;QACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;KAC9C,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA8BnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAgBd,OAAO;YAiCP,gBAAgB;IAmD9B,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,sBAAsB;CAS/B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAiBlE"}

package/bin/rpc/Client.js

@@ -0,0 +1,300 @@
+/**
+ * Agent 本机 RPC Client。
+ *
+ * 职责说明（中文）
+ * - 为 `RemoteAgent(rpc://...)` 提供最小客户端实现。
+ * - 复用逐行 JSON（NDJSON）协议，与本机 RPC Server 对接。
+ * - 当前只承载 Session actor 所需方法。
+ */
+import net from "node:net";
+/**
+ * RPC Client。
+ */
+export class RpcClient {
+    endpoint;
+    socket = null;
+    connect_promise = null;
+    buffered = "";
+    pending_requests = new Map();
+    subscriptions = new Map();
+    request_sequence = 0;
+    constructor(endpoint) {
+        this.endpoint = endpoint;
+    }
+    /**
+     * 列出远程 session。
+     */
+    async list_sessions(input) {
+        const data = await this.request({
+            method: "sdk.sessions.list",
+            params: input,
+        });
+        return data.page;
+    }
+    /**
+     * 创建远程 session。
+     */
+    async create_session(input) {
+        const data = await this.request({
+            method: "sdk.sessions.create",
+            params: input,
+        });
+        return data.session;
+    }
+    /**
+     * 获取远程 session 信息。
+     */
+    async get_session(session_id) {
+        const data = await this.request({
+            method: "sdk.sessions.get",
+            params: {
+                sessionId: session_id,
+            },
+        });
+        return data.session;
+    }
+    /**
+     * 发送 prompt。
+     */
+    async prompt_session(params) {
+        const data = await this.request({
+            method: "sdk.sessions.prompt",
+            params: {
+                sessionId: params.session_id,
+                input: params.input,
+            },
+        });
+        return data.turn;
+    }
+    /**
+     * 读取 history。
+     */
+    async get_session_history(params) {
+        const data = await this.request({
+            method: "sdk.sessions.history",
+            params: {
+                sessionId: params.session_id,
+                input: params.input,
+            },
+        });
+        return data.history;
+    }
+    /**
+     * 读取 system snapshot。
+     */
+    async get_session_system(session_id) {
+        const data = await this.request({
+            method: "sdk.sessions.system",
+            params: {
+                sessionId: session_id,
+            },
+        });
+        return data.system;
+    }
+    /**
+     * 分叉 session。
+     */
+    async fork_session(params) {
+        const data = await this.request({
+            method: "sdk.sessions.fork",
+            params: {
+                sessionId: params.session_id,
+                ...(params.message_id ? { messageId: params.message_id } : {}),
+            },
+        });
+        return data.session;
+    }
+    /**
+     * 订阅 session 事件。
+     */
+    async subscribe_session(params) {
+        const data = await this.request({
+            method: "sdk.sessions.subscribe",
+            params: {
+                sessionId: params.session_id,
+            },
+        });
+        const subscription_id = String(data.subscriptionId || "").trim();
+        if (!subscription_id) {
+            throw new Error("RPC subscription did not return subscriptionId");
+        }
+        this.subscriptions.set(subscription_id, {
+            on_ready: params.on_ready,
+            on_event: params.on_event,
+        });
+        params.on_ready();
+        return {
+            subscription_id,
+            unsubscribe: async () => {
+                this.subscriptions.delete(subscription_id);
+                await this.request({
+                    method: "sdk.sessions.unsubscribe",
+                    params: {
+                        subscriptionId: subscription_id,
+                    },
+                });
+            },
+        };
+    }
+    /**
+     * 关闭底层连接。
+     */
+    async close() {
+        const socket = this.socket;
+        this.socket = null;
+        this.connect_promise = null;
+        this.buffered = "";
+        for (const pending of this.pending_requests.values()) {
+            pending.reject(new Error("RPC client closed"));
+        }
+        this.pending_requests.clear();
+        this.fail_all_subscriptions("RPC client closed");
+        if (!socket)
+            return;
+        await new Promise((resolve) => {
+            socket.end(() => resolve());
+        });
+    }
+    async request(input) {
+        await this.ensure_connected();
+        const socket = this.socket;
+        if (!socket) {
+            throw new Error("RPC socket is not connected");
+        }
+        const id = `rpc_${Date.now()}_${this.request_sequence += 1}`;
+        const request = (input.params === undefined
+            ? {
+                id,
+                method: input.method,
+            }
+            : {
+                id,
+                method: input.method,
+                params: input.params,
+            });
+        const result = await new Promise((resolve, reject) => {
+            this.pending_requests.set(id, { resolve, reject });
+            socket.write(`${JSON.stringify(request)}\n`, (error) => {
+                if (!error)
+                    return;
+                this.pending_requests.delete(id);
+                reject(error);
+            });
+        });
+        return result;
+    }
+    async ensure_connected() {
+        if (this.socket && !this.socket.destroyed)
+            return;
+        if (this.connect_promise) {
+            await this.connect_promise;
+            return;
+        }
+        this.connect_promise = new Promise((resolve, reject) => {
+            const socket = net.createConnection({
+                host: this.endpoint.host,
+                port: this.endpoint.port,
+            });
+            socket.setEncoding("utf8");
+            socket.on("connect", () => {
+                this.socket = socket;
+                resolve();
+            });
+            socket.on("data", (chunk) => {
+                this.consume_data(chunk);
+            });
+            socket.on("error", (error) => {
+                if (!this.socket) {
+                    reject(error);
+                    return;
+                }
+                this.fail_all_pending(error);
+                this.fail_all_subscriptions(error instanceof Error ? error.message : String(error));
+            });
+            socket.on("close", () => {
+                this.socket = null;
+                this.connect_promise = null;
+                this.fail_all_pending(new Error("RPC socket closed"));
+                this.fail_all_subscriptions("RPC socket closed");
+            });
+        });
+        try {
+            await this.connect_promise;
+        }
+        catch (error) {
+            this.connect_promise = null;
+            throw error;
+        }
+    }
+    consume_data(chunk) {
+        this.buffered += chunk;
+        let newline_index = this.buffered.indexOf("\n");
+        while (newline_index >= 0) {
+            const line = this.buffered.slice(0, newline_index).trim();
+            this.buffered = this.buffered.slice(newline_index + 1);
+            if (line) {
+                this.consume_line(line);
+            }
+            newline_index = this.buffered.indexOf("\n");
+        }
+    }
+    consume_line(line) {
+        const payload = JSON.parse(line);
+        if ("type" in payload && payload.type === "ready") {
+            const subscription = this.subscriptions.get(payload.subscriptionId);
+            subscription?.on_ready();
+            return;
+        }
+        if ("type" in payload && payload.type === "event") {
+            const subscription = this.subscriptions.get(payload.subscriptionId);
+            subscription?.on_event(payload.event);
+            return;
+        }
+        const pending = this.pending_requests.get(payload.id);
+        if (!pending)
+            return;
+        this.pending_requests.delete(payload.id);
+        if (payload.success) {
+            pending.resolve(payload.data);
+            return;
+        }
+        pending.reject(new Error(String(payload.error || "RPC request failed")));
+    }
+    fail_all_pending(error) {
+        for (const pending of this.pending_requests.values()) {
+            pending.reject(error);
+        }
+        this.pending_requests.clear();
+    }
+    fail_all_subscriptions(message) {
+        for (const subscription of this.subscriptions.values()) {
+            subscription.on_event({
+                type: "error",
+                message,
+            });
+        }
+        this.subscriptions.clear();
+    }
+}
+/**
+ * 解析 rpc url。
+ */
+export function parse_rpc_url(url_input) {
+    const url = new URL(url_input);
+    if (url.protocol !== "rpc:") {
+        throw new Error(`Unsupported RPC protocol: ${url.protocol}`);
+    }
+    const host = String(url.hostname || "").trim();
+    const port = Number.parseInt(String(url.port || ""), 10);
+    if (!host) {
+        throw new Error("RPC url requires a host");
+    }
+    if (!Number.isInteger(port) || port <= 0 || port > 65535) {
+        throw new Error("RPC url requires a valid port");
+    }
+    return {
+        host,
+        port,
+    };
+}
+//# sourceMappingURL=Client.js.map

package/bin/rpc/Client.js.map

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

package/bin/rpc/Server.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Agent 本机 RPC Server。
+ *
+ * 职责说明（中文）
+ * - 为本机 `RemoteAgent(rpc://...)` 提供最小 SDK 会话访问面。
+ * - 当前只承载 Session actor 所需方法，不混入控制台 HTTP 语义。
+ * - 协议使用逐行 JSON（NDJSON），便于调试与事件流推送。
+ */
+import net from "node:net";
+import type { AgentSessionCollection } from "../types/agent/AgentTypes.js";
+/**
+ * RPC Server 启动参数。
+ */
+export interface RpcServerStartOptions {
+    /** RPC 服务监听端口。 */
+    port: number;
+    /** RPC 服务监听主机。 */
+    host: string;
+    /** Session 集合访问口。 */
+    sessionCollection: AgentSessionCollection;
+}
+/**
+ * RPC Server 运行实例。
+ */
+export interface RpcServerInstance {
+    /** 当前监听 host。 */
+    host: string;
+    /** 当前监听 port。 */
+    port: number;
+    /** 当前访问 URL。 */
+    url: string;
+    /** 原生 net server。 */
+    server: net.Server;
+    /** 停止当前服务。 */
+    stop(): Promise<void>;
+}
+/**
+ * 启动 Agent 本机 RPC 服务。
+ */
+export declare function startRpcServer(options: RpcServerStartOptions): Promise<RpcServerInstance>;
+//# sourceMappingURL=Server.d.ts.map

package/bin/rpc/Server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Server.d.ts","sourceRoot":"","sources":["../../src/rpc/Server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AAkGrC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,iBAAiB,EAAE,sBAAsB,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,qBAAqB;IACrB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC;IACnB,cAAc;IACd,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CA6J5B"}

package/bin/rpc/Server.js

@@ -0,0 +1,164 @@
+/**
+ * Agent 本机 RPC Server。
+ *
+ * 职责说明（中文）
+ * - 为本机 `RemoteAgent(rpc://...)` 提供最小 SDK 会话访问面。
+ * - 当前只承载 Session actor 所需方法，不混入控制台 HTTP 语义。
+ * - 协议使用逐行 JSON（NDJSON），便于调试与事件流推送。
+ */
+import net from "node:net";
+/**
+ * 启动 Agent 本机 RPC 服务。
+ */
+export async function startRpcServer(options) {
+    const server = net.createServer((socket) => {
+        const subscriptions = new Map();
+        let buffered = "";
+        const cleanupSubscriptions = () => {
+            for (const subscription of subscriptions.values()) {
+                subscription.unsubscribe();
+            }
+            subscriptions.clear();
+        };
+        const writeFrame = (frame) => {
+            socket.write(`${JSON.stringify(frame)}\n`);
+        };
+        const writeSuccess = (id, data) => {
+            writeFrame({
+                id,
+                success: true,
+                ...(data === undefined ? {} : { data }),
+            });
+        };
+        const writeError = (id, error) => {
+            writeFrame({
+                id,
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        };
+        const handleRequest = async (request) => {
+            try {
+                switch (request.method) {
+                    case "sdk.sessions.list": {
+                        const page = await options.sessionCollection.listSessions(request.params);
+                        writeSuccess(request.id, { page });
+                        return;
+                    }
+                    case "sdk.sessions.create": {
+                        const session = await options.sessionCollection.createSession(request.params);
+                        writeSuccess(request.id, { session: await session.getInfo() });
+                        return;
+                    }
+                    case "sdk.sessions.get": {
+                        const session = await options.sessionCollection.getSession(request.params.sessionId);
+                        writeSuccess(request.id, { session: await session.getInfo() });
+                        return;
+                    }
+                    case "sdk.sessions.prompt": {
+                        const session = await options.sessionCollection.getSession(request.params.sessionId);
+                        const turn = await session.prompt(request.params.input);
+                        writeSuccess(request.id, { turn: { id: turn.id } });
+                        return;
+                    }
+                    case "sdk.sessions.history": {
+                        const session = await options.sessionCollection.getSession(request.params.sessionId);
+                        const history = await session.history(request.params.input);
+                        writeSuccess(request.id, { history });
+                        return;
+                    }
+                    case "sdk.sessions.system": {
+                        const session = await options.sessionCollection.getSession(request.params.sessionId);
+                        writeSuccess(request.id, { system: await session.system() });
+                        return;
+                    }
+                    case "sdk.sessions.fork": {
+                        const session = await options.sessionCollection.getSession(request.params.sessionId);
+                        const forked = await session.fork(request.params.messageId);
+                        writeSuccess(request.id, { session: await forked.getInfo() });
+                        return;
+                    }
+                    case "sdk.sessions.subscribe": {
+                        const session = await options.sessionCollection.getSession(request.params.sessionId);
+                        const subscriptionId = `${request.params.sessionId}:${Date.now()}:${Math.random().toString(36).slice(2, 10)}`;
+                        const unsubscribe = session.subscribe((event) => {
+                            writeFrame({
+                                type: "event",
+                                subscriptionId,
+                                event,
+                            });
+                        });
+                        subscriptions.set(subscriptionId, {
+                            sessionId: request.params.sessionId,
+                            unsubscribe,
+                        });
+                        writeSuccess(request.id, { subscriptionId });
+                        return;
+                    }
+                    case "sdk.sessions.unsubscribe": {
+                        const subscription = subscriptions.get(request.params.subscriptionId);
+                        if (subscription) {
+                            subscription.unsubscribe();
+                            subscriptions.delete(request.params.subscriptionId);
+                        }
+                        writeSuccess(request.id, { unsubscribed: true });
+                        return;
+                    }
+                }
+            }
+            catch (error) {
+                writeError(request.id, error);
+            }
+        };
+        socket.on("data", (chunk) => {
+            buffered += chunk.toString("utf8");
+            let newlineIndex = buffered.indexOf("\n");
+            while (newlineIndex >= 0) {
+                const line = buffered.slice(0, newlineIndex).trim();
+                buffered = buffered.slice(newlineIndex + 1);
+                if (line) {
+                    try {
+                        const parsed = JSON.parse(line);
+                        void handleRequest(parsed);
+                    }
+                    catch (error) {
+                        writeFrame({
+                            id: "parse",
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        });
+                    }
+                }
+                newlineIndex = buffered.indexOf("\n");
+            }
+        });
+        socket.on("error", () => {
+            cleanupSubscriptions();
+        });
+        socket.on("close", () => {
+            cleanupSubscriptions();
+        });
+        socket.on("end", () => {
+            cleanupSubscriptions();
+        });
+    });
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(options.port, options.host, () => {
+            server.off("error", reject);
+            resolve();
+        });
+    });
+    return {
+        host: options.host,
+        port: options.port,
+        url: `rpc://${options.host}:${options.port}`,
+        server,
+        async stop() {
+            await new Promise((resolve) => {
+                server.close(() => resolve());
+            });
+        },
+    };
+}
+//# sourceMappingURL=Server.js.map

package/bin/rpc/Server.js.map

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

package/bin/runtime/host/daemon/Api.d.ts

@@ -35,7 +35,7 @@ export type DaemonJsonApiCallParams = {
      * 单次调用超时（毫秒）。
      *
      * 说明（中文）
-     * - 仅本地 IPC transport 当前会消费该参数。
+     * - HTTP daemon client 可消费该参数。
      * - 用于 `session execute`、`plugin command` 这类可能持续几十秒的请求，
      *   避免被默认短超时误判成“Agent server 未启动”。
      */

package/bin/runtime/host/daemon/Client.d.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 业务模块统一通过 daemon API 与运行时通信。
- * - 地址解析优先级：CLI 参数 > 环境变量 > daemon meta > 默认值。
+ * - HTTP gateway 与本机 RPC 的地址解析分开，避免端口语义混淆。
  */
 import { type DaemonJsonApiCallParams, type DaemonJsonApiCallResult } from "./Api.js";
 /**