@downcity/agent 1.1.74 → 1.1.81

package/bin/agent/local/services/AgentSessionManager.d.ts

@@ -0,0 +1,106 @@
+/**
+ * AgentSessionManager：本地 Agent session 管理服务。
+ *
+ * 关键点（中文）
+ * - 统一管理 session 缓存、创建、恢复、默认配置注入与 session collection。
+ * - 该服务只负责 session 生命周期与查询，不负责 plugin / RPC 启停。
+ * - Session 对象创建细节集中在这里，避免 facade 和 lifecycle 重复依赖 Session 构造逻辑。
+ */
+import type { Tool } from "ai";
+import type { Logger } from "../../../utils/logger/Logger.js";
+import type { AgentCreateSessionInput, AgentListSessionsInput, AgentManagedSession, AgentModel, AgentSession, AgentSessionCollection, AgentSessionConstructor, AgentSessionSummaryPage } from "../../../types/agent/AgentTypes.js";
+import type { AgentRuntime } from "../../../types/runtime/agent/AgentRuntime.js";
+import type { AgentContext } from "../../../types/runtime/agent/AgentContext.js";
+import type { SessionPort } from "../../../types/runtime/agent/AgentContext.js";
+import type { BasePlugin } from "../../../plugin/core/BasePlugin.js";
+type AgentSessionManagerOptions = {
+    /**
+     * 当前 agent 稳定标识。
+     */
+    agent_id: string;
+    /**
+     * 当前项目根目录。
+     */
+    project_root: string;
+    /**
+     * 当前 agent 默认工具集合。
+     */
+    tools: Record<string, Tool>;
+    /**
+     * 当前统一日志器。
+     */
+    logger: Logger;
+    /**
+     * 当前 agent runtime。
+     */
+    runtime: AgentRuntime;
+    /**
+     * 延迟读取当前 agent context。
+     */
+    get_agent_context: () => AgentContext;
+    /**
+     * 当前静态 instruction 文本集合。
+     */
+    get_instruction: () => string[];
+    /**
+     * 当前 plugin 实例集合。
+     */
+    plugin_instances: Map<string, BasePlugin>;
+    /**
+     * 当前默认模型实例。
+     */
+    default_model?: AgentModel;
+    /**
+     * 当前 agent 使用的本地 Session 类。
+     */
+    SessionClass?: AgentSessionConstructor;
+};
+/**
+ * 本地 Agent session 管理服务。
+ */
+export declare class AgentSessionManager {
+    private readonly agent_id;
+    private readonly project_root;
+    private readonly tools;
+    private readonly logger;
+    private readonly runtime;
+    private readonly get_agent_context;
+    private readonly get_instruction;
+    private readonly plugin_instances;
+    private readonly default_model?;
+    private readonly SessionClass;
+    private readonly sessions_by_id;
+    private readonly configured_session_ids;
+    private readonly session_collection;
+    constructor(options: AgentSessionManagerOptions);
+    /**
+     * 返回当前缓存的 session 实例。
+     */
+    list_cached_sessions(): AgentManagedSession[];
+    /**
+     * 返回对外暴露的 session collection。
+     */
+    get_session_collection(): AgentSessionCollection;
+    /**
+     * 获取或创建一个 session runtime port。
+     */
+    get_session_port(session_id: string): SessionPort;
+    /**
+     * 新建一个 session。
+     */
+    create_session(input?: AgentCreateSessionInput): Promise<AgentSession>;
+    /**
+     * 获取一个已存在的 session。
+     */
+    get_session(session_id: string): Promise<AgentSession>;
+    /**
+     * 列出当前 agent 的 session 摘要页。
+     */
+    list_sessions(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
+    private get_or_create_session;
+    private apply_session_defaults;
+    private load_instruction_system_blocks;
+    private load_plugin_system_blocks;
+}
+export {};
+//# sourceMappingURL=AgentSessionManager.d.ts.map

package/bin/agent/local/services/AgentSessionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentSessionManager.d.ts","sourceRoot":"","sources":["../../../../src/agent/local/services/AgentSessionManager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EAExB,MAAM,6BAA6B,CAAC;AAMrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAI9D,KAAK,0BAA0B,GAAG;IAChC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,iBAAiB,EAAE,MAAM,YAAY,CAAC;IAEtC;;OAEG;IACH,eAAe,EAAE,MAAM,MAAM,EAAE,CAAC;IAEhC;;OAEG;IACH,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAE1C;;OAEG;IACH,aAAa,CAAC,EAAE,UAAU,CAAC;IAE3B;;OAEG;IACH,YAAY,CAAC,EAAE,uBAAuB,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkD;IACpF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgD;IAChF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0B;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAa;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0C;IACzE,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAqB;IAC5D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAyB;gBAEhD,OAAO,EAAE,0BAA0B;IAkB/C;;OAEG;IACH,oBAAoB,IAAI,mBAAmB,EAAE;IAI7C;;OAEG;IACH,sBAAsB,IAAI,sBAAsB;IAIhD;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW;IAMjD;;OAEG;IACG,cAAc,CAClB,KAAK,CAAC,EAAE,uBAAuB,GAC9B,OAAO,CAAC,YAAY,CAAC;IAwBxB;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAwB5D;;OAEG;IACG,aAAa,CACjB,KAAK,CAAC,EAAE,sBAAsB,GAC7B,OAAO,CAAC,uBAAuB,CAAC;IASnC,OAAO,CAAC,qBAAqB;YA8Bf,sBAAsB;IAYpC,OAAO,CAAC,8BAA8B;YAOxB,yBAAyB;CAwBxC"}

package/bin/agent/local/services/AgentSessionManager.js

@@ -0,0 +1,182 @@
+/**
+ * AgentSessionManager：本地 Agent session 管理服务。
+ *
+ * 关键点（中文）
+ * - 统一管理 session 缓存、创建、恢复、默认配置注入与 session collection。
+ * - 该服务只负责 session 生命周期与查询，不负责 plugin / RPC 启停。
+ * - Session 对象创建细节集中在这里，避免 facade 和 lifecycle 重复依赖 Session 构造逻辑。
+ */
+import fs from "fs-extra";
+import { nanoid } from "nanoid";
+import { Session } from "../../../session/Session.js";
+import { getSdkAgentSessionDirPath, listAgentSessionSummaryPage, } from "../../../session/index.js";
+import { isPluginEnabled } from "../../../plugin/core/Activation.js";
+import { createInstructionSystemBlocks } from "../../../agent/local/AgentInstructions.js";
+/**
+ * 本地 Agent session 管理服务。
+ */
+export class AgentSessionManager {
+    agent_id;
+    project_root;
+    tools;
+    logger;
+    runtime;
+    get_agent_context;
+    get_instruction;
+    plugin_instances;
+    default_model;
+    SessionClass;
+    sessions_by_id = new Map();
+    configured_session_ids = new Set();
+    session_collection;
+    constructor(options) {
+        this.agent_id = options.agent_id;
+        this.project_root = options.project_root;
+        this.tools = options.tools;
+        this.logger = options.logger;
+        this.runtime = options.runtime;
+        this.get_agent_context = options.get_agent_context;
+        this.get_instruction = options.get_instruction;
+        this.plugin_instances = options.plugin_instances;
+        this.default_model = options.default_model;
+        this.SessionClass = options.SessionClass || Session;
+        this.session_collection = {
+            createSession: async (input) => await this.create_session(input),
+            getSession: async (session_id) => await this.get_session(session_id),
+            listSessions: async (input) => await this.list_sessions(input),
+        };
+    }
+    /**
+     * 返回当前缓存的 session 实例。
+     */
+    list_cached_sessions() {
+        return [...this.sessions_by_id.values()];
+    }
+    /**
+     * 返回对外暴露的 session collection。
+     */
+    get_session_collection() {
+        return this.session_collection;
+    }
+    /**
+     * 获取或创建一个 session runtime port。
+     */
+    get_session_port(session_id) {
+        return this.get_or_create_session({
+            session_id,
+        }).getRuntimePort();
+    }
+    /**
+     * 新建一个 session。
+     */
+    async create_session(input) {
+        const explicit_session_id = String(input?.sessionId || "").trim() || undefined;
+        if (explicit_session_id &&
+            (this.sessions_by_id.has(explicit_session_id) ||
+                (await fs.pathExists(getSdkAgentSessionDirPath(this.project_root, this.agent_id, explicit_session_id))))) {
+            throw new Error(`Session "${explicit_session_id}" already exists`);
+        }
+        const session = this.get_or_create_session({
+            session_id: explicit_session_id,
+        });
+        await session.initialize();
+        await this.apply_session_defaults(session);
+        return session;
+    }
+    /**
+     * 获取一个已存在的 session。
+     */
+    async get_session(session_id) {
+        const resolved_session_id = String(session_id || "").trim();
+        if (!resolved_session_id) {
+            throw new Error("getSession requires a non-empty sessionId");
+        }
+        const session_dir_path = getSdkAgentSessionDirPath(this.project_root, this.agent_id, resolved_session_id);
+        if (!this.sessions_by_id.has(resolved_session_id) &&
+            !(await fs.pathExists(session_dir_path))) {
+            throw new Error(`Session "${resolved_session_id}" not found`);
+        }
+        const session = this.get_or_create_session({
+            session_id: resolved_session_id,
+        });
+        await session.initialize();
+        await this.apply_session_defaults(session);
+        return session;
+    }
+    /**
+     * 列出当前 agent 的 session 摘要页。
+     */
+    async list_sessions(input) {
+        return await listAgentSessionSummaryPage({
+            projectRoot: this.project_root,
+            agentId: this.agent_id,
+            input,
+            executingSessionIds: new Set(this.runtime.listExecutingSessionIds()),
+        });
+    }
+    get_or_create_session(input) {
+        const resolved_session_id = String(input?.session_id || "").trim() ||
+            `session-${Date.now()}-${nanoid(8)}`;
+        const cached = this.sessions_by_id.get(resolved_session_id);
+        if (cached)
+            return cached;
+        const created = new this.SessionClass({
+            agentId: this.agent_id,
+            projectRoot: this.project_root,
+            sessionId: resolved_session_id,
+            tools: this.tools,
+            logger: this.logger,
+            getInstructionSystemBlocks: () => this.load_instruction_system_blocks(),
+            getManagedPluginSystemBlocks: async () => [],
+            getPluginSystemBlocks: async () => await this.load_plugin_system_blocks(),
+            ensureConfigured: async (session) => {
+                await this.apply_session_defaults(session);
+            },
+        });
+        this.sessions_by_id.set(resolved_session_id, created);
+        return created;
+    }
+    async apply_session_defaults(session) {
+        if (this.configured_session_ids.has(session.id))
+            return;
+        if (this.default_model) {
+            await session.set({
+                model: this.default_model,
+            });
+        }
+        this.configured_session_ids.add(session.id);
+    }
+    load_instruction_system_blocks() {
+        return createInstructionSystemBlocks(this.get_instruction(), this.project_root);
+    }
+    async load_plugin_system_blocks() {
+        const context = this.get_agent_context();
+        const out = [];
+        for (const plugin of this.plugin_instances.values()) {
+            if (typeof plugin.system !== "function")
+                continue;
+            try {
+                if (!isPluginEnabled({ plugin, context }))
+                    continue;
+                if (typeof plugin.availability === "function") {
+                    const availability = await plugin.availability(context);
+                    if (!availability.available)
+                        continue;
+                }
+                const text = String(await plugin.system(context)).trim();
+                if (!text)
+                    continue;
+                out.push({
+                    source: "plugin",
+                    name: plugin.name,
+                    content: text,
+                });
+            }
+            catch {
+                // 单个 plugin system 失败不应阻断 SDK session 主链路。
+            }
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=AgentSessionManager.js.map

package/bin/agent/local/services/AgentSessionManager.js.map

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

package/bin/agent/{RemoteAgent.d.ts → remote/RemoteAgent.d.ts}

@@ -1,12 +1,12 @@
 /**
- * RemoteAgent：统一远程 SDK 客户端。
+ * Agent remote：统一远程 SDK 客户端。
  *
  * 关键点（中文）
  * - 对外只暴露一个 `url` 入口，不向用户暴露 transport 细节。
  * - 当前内部支持 `http/https` 与 `rpc` 两种访问方式。
- * - `RemoteAgent` 只负责远程访问与 turn handle 合成，不重复实现第二套会话编排器。
+ * - `RemoteAgent` 只负责远程访问，不重复实现第二套会话编排器。
  */
-import type { AgentCreateSessionInput, AgentListSessionsInput, AgentSessionSummaryPage, RemoteAgentOptions, RemoteAgentSession } from "../types/agent/AgentTypes.js";
+import type { AgentCreateSessionInput, AgentListSessionsInput, AgentSessionSummaryPage, RemoteAgentOptions, RemoteAgentSession } from "../../types/agent/AgentTypes.js";
 /**
  * RemoteAgent：远程 Agent 客户端。
  */

package/bin/agent/remote/RemoteAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteAgent.d.ts","sourceRoot":"","sources":["../../../src/agent/remote/RemoteAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,6BAA6B,CAAC;AAKrC;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;gBAErC,OAAO,EAAE,kBAAkB;IAQvC;;OAEG;IACG,aAAa,CACjB,KAAK,CAAC,EAAE,uBAAuB,GAC9B,OAAO,CAAC,kBAAkB,CAAC;IAK9B;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAShE;;OAEG;IACG,YAAY,CAChB,KAAK,CAAC,EAAE,sBAAsB,GAC7B,OAAO,CAAC,uBAAuB,CAAC;IAInC;;;;;;OAMG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/bin/agent/remote/RemoteAgent.js

@@ -0,0 +1,58 @@
+/**
+ * Agent remote：统一远程 SDK 客户端。
+ *
+ * 关键点（中文）
+ * - 对外只暴露一个 `url` 入口，不向用户暴露 transport 细节。
+ * - 当前内部支持 `http/https` 与 `rpc` 两种访问方式。
+ * - `RemoteAgent` 只负责远程访问，不重复实现第二套会话编排器。
+ */
+import { RemoteSession } from "../../agent/remote/RemoteSession.js";
+import { create_remote_agent_transport } from "../../agent/remote/TransportFactory.js";
+/**
+ * RemoteAgent：远程 Agent 客户端。
+ */
+export class RemoteAgent {
+    transport;
+    constructor(options) {
+        const url = String(options.url || "").trim();
+        if (!url) {
+            throw new Error("RemoteAgent requires a non-empty url");
+        }
+        this.transport = create_remote_agent_transport(url, options.token);
+    }
+    /**
+     * 新建一个远程 session。
+     */
+    async createSession(input) {
+        const info = await this.transport.create_session(input);
+        return new RemoteSession(this.transport, info.sessionId);
+    }
+    /**
+     * 获取一个已存在的远程 session。
+     */
+    async getSession(sessionId) {
+        const resolved_session_id = String(sessionId || "").trim();
+        if (!resolved_session_id) {
+            throw new Error("getSession requires a non-empty sessionId");
+        }
+        const info = await this.transport.get_info(resolved_session_id);
+        return new RemoteSession(this.transport, info.sessionId);
+    }
+    /**
+     * 列出远程 agent 的 session 摘要页。
+     */
+    async listSessions(input) {
+        return await this.transport.list_sessions(input);
+    }
+    /**
+     * 关闭远程 transport。
+     *
+     * 关键点（中文）
+     * - `rpc://` 会关闭底层长连接。
+     * - `http://` / `https://` 没有常驻连接，调用时是安全 no-op。
+     */
+    async close() {
+        await this.transport.close?.();
+    }
+}
+//# sourceMappingURL=RemoteAgent.js.map

package/bin/agent/remote/RemoteAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteAgent.js","sourceRoot":"","sources":["../../../src/agent/remote/RemoteAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAEnF;;GAEG;AACH,MAAM,OAAO,WAAW;IACL,SAAS,CAAuB;IAEjD,YAAY,OAA2B;QACrC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,6BAA6B,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,KAA+B;QAE/B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACxD,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,MAAM,mBAAmB,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3D,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;QAChE,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAChB,KAA8B;QAE9B,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;IACjC,CAAC;CACF"}

package/bin/agent/remote/RemoteSession.d.ts

@@ -0,0 +1,62 @@
+/**
+ * RemoteSession：远程 session actor 客户端。
+ *
+ * 关键点（中文）
+ * - 这里只负责 session 级 API、turn lifecycle 与事件泵。
+ * - 具体 HTTP / RPC 细节由 RemoteSessionTransport 提供。
+ */
+import type { AgentSessionForkInput, AgentSessionHistoryInput, AgentSessionHistoryPage, AgentSessionInfo, AgentSessionSetInput, AgentSessionSystemSnapshot, RemoteAgentSession } from "../../types/agent/AgentTypes.js";
+import type { AgentSessionSubscriber, AgentSessionUnsubscribe } from "../../types/sdk/AgentSessionEvent.js";
+import type { AgentSessionPromptInput } from "../../types/sdk/AgentSessionPrompt.js";
+import type { AgentSessionTurnHandle } from "../../types/sdk/AgentSessionTurn.js";
+import type { RemoteSessionTransport } from "../../agent/remote/RemoteTransport.js";
+/**
+ * 远程 Session 客户端。
+ */
+export declare class RemoteSession implements RemoteAgentSession {
+    readonly id: string;
+    private readonly transport;
+    private readonly event_hub;
+    private readonly turns_by_id;
+    private readonly completed_turn_ids;
+    private event_pump_connect_promise;
+    private event_pump_running;
+    private event_subscriber_count;
+    private event_subscription;
+    constructor(transport: RemoteSessionTransport, session_id: string);
+    /**
+     * 远程 session 当前不支持直接注入本地模型实例。
+     */
+    set(_input: AgentSessionSetInput): Promise<void>;
+    /**
+     * 读取当前远程 session 详情。
+     */
+    getInfo(): Promise<AgentSessionInfo>;
+    /**
+     * 向当前远程 session 追加一条新的 prompt。
+     */
+    prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle>;
+    /**
+     * 订阅当前远程 session 的 future 事件。
+     */
+    subscribe(subscriber: AgentSessionSubscriber): AgentSessionUnsubscribe;
+    /**
+     * 读取远程消息历史。
+     */
+    history(input?: AgentSessionHistoryInput): Promise<AgentSessionHistoryPage>;
+    /**
+     * 读取远程 session 当前生效的 system prompt 快照。
+     */
+    system(): Promise<AgentSessionSystemSnapshot>;
+    /**
+     * 分叉远程 session。
+     */
+    fork(input?: AgentSessionForkInput | string): Promise<RemoteAgentSession>;
+    private ensure_event_pump;
+    private handle_event;
+    private ensure_turn_lifecycle;
+    private fail_pending_turns;
+    private remember_completed_turn;
+    private maybe_stop_event_pump;
+}
+//# sourceMappingURL=RemoteSession.d.ts.map

package/bin/agent/remote/RemoteSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteSession.d.ts","sourceRoot":"","sources":["../../../src/agent/remote/RemoteSession.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,0BAA0B,EAC1B,kBAAkB,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAEV,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,mCAAmC,CAAC;AAkB3C;;GAEG;AACH,qBAAa,aAAc,YAAW,kBAAkB;IACtD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0C;IACtE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAgB;IACnD,OAAO,CAAC,0BAA0B,CAA8B;IAChE,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,sBAAsB,CAAK;IACnC,OAAO,CAAC,kBAAkB,CAAsC;gBAEpD,SAAS,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM;IAKjE;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAI1C;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAY7E;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,sBAAsB,GAAG,uBAAuB;IAgBtE;;OAEG;IACG,OAAO,CAAC,KAAK,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIjF;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,0BAA0B,CAAC;IAInD;;OAEG;IACG,IAAI,CAAC,KAAK,CAAC,EAAE,qBAAqB,GAAG,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAKjE,iBAAiB;IA+B/B,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,qBAAqB;IAY7B,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,uBAAuB;YAUjB,qBAAqB;CAapC"}