@downcity/agent 1.1.74 → 1.1.81

package/bin/agent/remote/RemoteSession.js

@@ -0,0 +1,225 @@
+/**
+ * RemoteSession：远程 session actor 客户端。
+ *
+ * 关键点（中文）
+ * - 这里只负责 session 级 API、turn lifecycle 与事件泵。
+ * - 具体 HTTP / RPC 细节由 RemoteSessionTransport 提供。
+ */
+import { SessionEventHub } from "../../session/runtime/SessionEventHub.js";
+/**
+ * 远程 Session 客户端。
+ */
+export class RemoteSession {
+    id;
+    transport;
+    event_hub = new SessionEventHub();
+    turns_by_id = new Map();
+    completed_turn_ids = [];
+    event_pump_connect_promise = null;
+    event_pump_running = false;
+    event_subscriber_count = 0;
+    event_subscription = null;
+    constructor(transport, session_id) {
+        this.transport = transport;
+        this.id = session_id;
+    }
+    /**
+     * 远程 session 当前不支持直接注入本地模型实例。
+     */
+    async set(_input) {
+        throw new Error("Remote session.set({ model }) is not supported in v1. Configure the model on the server-side local Agent session instead.");
+    }
+    /**
+     * 读取当前远程 session 详情。
+     */
+    async getInfo() {
+        return await this.transport.get_info(this.id);
+    }
+    /**
+     * 向当前远程 session 追加一条新的 prompt。
+     */
+    async prompt(input) {
+        const query = String(input.query || "").trim();
+        if (!query) {
+            throw new Error("remote session.prompt requires a non-empty query");
+        }
+        await this.ensure_event_pump();
+        const turn = await this.transport.prompt(this.id, input);
+        const lifecycle = this.ensure_turn_lifecycle(turn.id);
+        return create_turn_handle(lifecycle);
+    }
+    /**
+     * 订阅当前远程 session 的 future 事件。
+     */
+    subscribe(subscriber) {
+        this.event_subscriber_count += 1;
+        void this.ensure_event_pump().catch((error) => {
+            this.event_hub.publish({
+                type: "error",
+                message: error instanceof Error ? error.message : String(error),
+            });
+        });
+        const unsubscribe = this.event_hub.subscribe(subscriber);
+        return () => {
+            unsubscribe();
+            this.event_subscriber_count = Math.max(0, this.event_subscriber_count - 1);
+            void this.maybe_stop_event_pump();
+        };
+    }
+    /**
+     * 读取远程消息历史。
+     */
+    async history(input) {
+        return await this.transport.history(this.id, input);
+    }
+    /**
+     * 读取远程 session 当前生效的 system prompt 快照。
+     */
+    async system() {
+        return await this.transport.system(this.id);
+    }
+    /**
+     * 分叉远程 session。
+     */
+    async fork(input) {
+        const info = await this.transport.fork(this.id, input);
+        return new RemoteSession(this.transport, info.sessionId);
+    }
+    async ensure_event_pump() {
+        if (this.event_pump_connect_promise) {
+            await this.event_pump_connect_promise;
+            return;
+        }
+        if (this.event_pump_running)
+            return;
+        this.event_pump_connect_promise = (async () => {
+            let resolved_ready = false;
+            this.event_subscription = await this.transport.subscribe({
+                session_id: this.id,
+                on_ready: () => {
+                    resolved_ready = true;
+                },
+                on_event: (event) => {
+                    this.handle_event(event);
+                },
+            });
+            this.event_pump_running = true;
+            if (!resolved_ready) {
+                throw new Error("Remote session events connection closed before ready");
+            }
+        })();
+        try {
+            await this.event_pump_connect_promise;
+        }
+        finally {
+            this.event_pump_connect_promise = null;
+        }
+    }
+    handle_event(event) {
+        if (event.type === "error") {
+            this.fail_pending_turns(event.message);
+        }
+        const turn_id = extract_turn_id(event);
+        if (turn_id) {
+            this.ensure_turn_lifecycle(turn_id);
+        }
+        if (event.type === "turn-finish") {
+            const lifecycle = this.ensure_turn_lifecycle(event.turnId);
+            const result = {
+                turnId: event.turnId,
+                text: event.text,
+                success: event.success,
+                ...(event.error ? { error: event.error } : {}),
+            };
+            lifecycle.result = result;
+            lifecycle.deferred_finished.resolve(result);
+            this.remember_completed_turn(event.turnId);
+            void this.maybe_stop_event_pump();
+        }
+        this.event_hub.publish(event);
+    }
+    ensure_turn_lifecycle(turn_id) {
+        const cached = this.turns_by_id.get(turn_id);
+        if (cached)
+            return cached;
+        const created = {
+            turnId: turn_id,
+            result: null,
+            deferred_finished: create_deferred(),
+        };
+        this.turns_by_id.set(turn_id, created);
+        return created;
+    }
+    fail_pending_turns(message) {
+        for (const lifecycle of this.turns_by_id.values()) {
+            if (lifecycle.result)
+                continue;
+            const result = {
+                turnId: lifecycle.turnId,
+                text: "",
+                success: false,
+                error: message,
+            };
+            lifecycle.result = result;
+            lifecycle.deferred_finished.resolve(result);
+            this.remember_completed_turn(lifecycle.turnId);
+        }
+    }
+    remember_completed_turn(turn_id) {
+        this.completed_turn_ids.push(turn_id);
+        while (this.completed_turn_ids.length > 200) {
+            const oldest_turn_id = this.completed_turn_ids.shift();
+            if (oldest_turn_id) {
+                this.turns_by_id.delete(oldest_turn_id);
+            }
+        }
+    }
+    async maybe_stop_event_pump() {
+        if (this.event_subscriber_count > 0)
+            return;
+        if ([...this.turns_by_id.values()].some((item) => item.result === null))
+            return;
+        const current = this.event_subscription;
+        this.event_subscription = null;
+        this.event_pump_running = false;
+        if (!current)
+            return;
+        await current.close().catch((error) => {
+            this.fail_pending_turns(error instanceof Error ? error.message : String(error));
+        });
+    }
+}
+function create_deferred() {
+    let resolve;
+    const promise = new Promise((inner_resolve) => {
+        resolve = inner_resolve;
+    });
+    return {
+        promise,
+        resolve,
+    };
+}
+function create_turn_handle(lifecycle) {
+    return {
+        id: lifecycle.turnId,
+        get result() {
+            return lifecycle.result;
+        },
+        finished: lifecycle.deferred_finished.promise,
+    };
+}
+function extract_turn_id(event) {
+    switch (event.type) {
+        case "turn-start":
+        case "text-delta":
+        case "reasoning-delta":
+        case "tool-call":
+        case "tool-result":
+        case "assistant-step":
+        case "turn-finish":
+            return event.turnId;
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=RemoteSession.js.map

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

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

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

@@ -0,0 +1,52 @@
+/**
+ * RemoteAgent transport 协议。
+ *
+ * 关键点（中文）
+ * - RemoteSession 只依赖这里定义的最小会话传输能力。
+ * - HTTP / RPC transport 只负责协议适配，不持有 session 编排逻辑。
+ */
+import type { AgentCreateSessionInput, AgentListSessionsInput, AgentSessionForkInput, 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";
+/**
+ * Transport 持有的事件订阅句柄。
+ */
+export type TransportSubscription = {
+    /** 关闭当前订阅。 */
+    close(): Promise<void>;
+};
+/**
+ * 单个远程 session 所需的 transport 能力。
+ */
+export type RemoteSessionTransport = {
+    /** 读取 session 信息。 */
+    get_info(session_id: string): Promise<AgentSessionInfo>;
+    /** 发送 prompt。 */
+    prompt(session_id: string, input: AgentSessionPromptInput): Promise<{
+        id: string;
+    }>;
+    /** 订阅 session 事件。 */
+    subscribe(params: {
+        session_id: string;
+        on_ready: () => void;
+        on_event: (event: AgentSessionEvent) => void;
+    }): Promise<TransportSubscription>;
+    /** 读取 history。 */
+    history(session_id: string, input?: AgentSessionHistoryInput): Promise<AgentSessionHistoryPage>;
+    /** 读取 system snapshot。 */
+    system(session_id: string): Promise<AgentSessionSystemSnapshot>;
+    /** 分叉 session。 */
+    fork(session_id: string, input?: AgentSessionForkInput | string): Promise<AgentSessionInfo>;
+};
+/**
+ * RemoteAgent 顶层 transport 能力。
+ */
+export type RemoteAgentTransport = RemoteSessionTransport & {
+    /** 新建 session。 */
+    create_session(input?: AgentCreateSessionInput): Promise<AgentSessionInfo>;
+    /** 列出 sessions。 */
+    list_sessions(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
+    /** 关闭 transport 持有的长期连接。 */
+    close?(): Promise<void>;
+};
+//# sourceMappingURL=RemoteTransport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteTransport.d.ts","sourceRoot":"","sources":["../../../src/agent/remote/RemoteTransport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,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;AAEjF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc;IACd,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,qBAAqB;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACxD,iBAAiB;IACjB,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,MAAM,EAAE;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,IAAI,CAAC;QACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;KAC9C,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACnC,kBAAkB;IAClB,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,wBAAwB,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpC,0BAA0B;IAC1B,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAChE,kBAAkB;IAClB,IAAI,CACF,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,qBAAqB,GAAG,MAAM,GACrC,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,GAAG;IAC1D,kBAAkB;IAClB,cAAc,CAAC,KAAK,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC3E,mBAAmB;IACnB,aAAa,CAAC,KAAK,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAChF,4BAA4B;IAC5B,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB,CAAC"}

package/bin/agent/remote/RemoteTransport.js

@@ -0,0 +1,9 @@
+/**
+ * RemoteAgent transport 协议。
+ *
+ * 关键点（中文）
+ * - RemoteSession 只依赖这里定义的最小会话传输能力。
+ * - HTTP / RPC transport 只负责协议适配，不持有 session 编排逻辑。
+ */
+export {};
+//# sourceMappingURL=RemoteTransport.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteTransport.js","sourceRoot":"","sources":["../../../src/agent/remote/RemoteTransport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

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

@@ -0,0 +1,13 @@
+/**
+ * RemoteAgent transport 工厂。
+ *
+ * 关键点（中文）
+ * - `RemoteAgent` 对外只接收 url，这里负责选择具体 transport。
+ * - HTTP token 只传给 HTTP transport，RPC 不读取 token。
+ */
+import type { RemoteAgentTransport } from "../../agent/remote/RemoteTransport.js";
+/**
+ * 根据 URL 协议创建远程 transport。
+ */
+export declare function create_remote_agent_transport(url: string, token?: string): RemoteAgentTransport;
+//# sourceMappingURL=TransportFactory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TransportFactory.d.ts","sourceRoot":"","sources":["../../../src/agent/remote/TransportFactory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAI9E;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,GACb,oBAAoB,CAUtB"}

package/bin/agent/remote/TransportFactory.js

@@ -0,0 +1,22 @@
+/**
+ * RemoteAgent transport 工厂。
+ *
+ * 关键点（中文）
+ * - `RemoteAgent` 对外只接收 url，这里负责选择具体 transport。
+ * - HTTP token 只传给 HTTP transport，RPC 不读取 token。
+ */
+import { HttpRemoteAgentTransport } from "../../agent/remote/transports/HttpRemoteAgentTransport.js";
+import { RpcRemoteAgentTransport } from "../../agent/remote/transports/RpcRemoteAgentTransport.js";
+/**
+ * 根据 URL 协议创建远程 transport。
+ */
+export function create_remote_agent_transport(url, token) {
+    if (/^https?:\/\//i.test(url)) {
+        return new HttpRemoteAgentTransport(url, token);
+    }
+    if (/^rpc:\/\//i.test(url)) {
+        return new RpcRemoteAgentTransport(url);
+    }
+    throw new Error(`Unsupported RemoteAgent url protocol: ${url}. Expected http://, https://, or rpc://`);
+}
+//# sourceMappingURL=TransportFactory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TransportFactory.js","sourceRoot":"","sources":["../../../src/agent/remote/TransportFactory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,wBAAwB,EAAE,MAAM,uDAAuD,CAAC;AACjG,OAAO,EAAE,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AAE/F;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,GAAW,EACX,KAAc;IAEd,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,wBAAwB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,IAAI,KAAK,CACb,yCAAyC,GAAG,yCAAyC,CACtF,CAAC;AACJ,CAAC"}

package/bin/agent/remote/transports/HttpRemoteAgentTransport.d.ts

@@ -0,0 +1,35 @@
+/**
+ * RemoteAgent HTTP transport。
+ *
+ * 关键点（中文）
+ * - 只适配 Town Agent HTTP gateway 的 SDK routes。
+ * - 不处理 RemoteSession 的 turn lifecycle，避免 transport 与 actor 逻辑混在一起。
+ */
+import type { AgentCreateSessionInput, AgentListSessionsInput, AgentSessionForkInput, 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";
+import type { RemoteAgentTransport, TransportSubscription } from "../../../agent/remote/RemoteTransport.js";
+/**
+ * Town HTTP gateway transport。
+ */
+export declare class HttpRemoteAgentTransport implements RemoteAgentTransport {
+    private readonly base_url;
+    private readonly token;
+    constructor(url: string, token?: string);
+    private headers;
+    create_session(input?: AgentCreateSessionInput): Promise<AgentSessionInfo>;
+    get_info(session_id: string): Promise<AgentSessionInfo>;
+    prompt(session_id: string, input: AgentSessionPromptInput): Promise<{
+        id: string;
+    }>;
+    subscribe(params: {
+        session_id: string;
+        on_ready: () => void;
+        on_event: (event: AgentSessionEvent) => void;
+    }): Promise<TransportSubscription>;
+    history(session_id: string, input?: AgentSessionHistoryInput): Promise<AgentSessionHistoryPage>;
+    system(session_id: string): Promise<AgentSessionSystemSnapshot>;
+    fork(session_id: string, input?: AgentSessionForkInput | string): Promise<AgentSessionInfo>;
+    list_sessions(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
+}
+//# sourceMappingURL=HttpRemoteAgentTransport.d.ts.map

package/bin/agent/remote/transports/HttpRemoteAgentTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpRemoteAgentTransport.d.ts","sourceRoot":"","sources":["../../../../src/agent/remote/transports/HttpRemoteAgentTransport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,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;AACjF,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,mCAAmC,CAAC;AAO3C;;GAEG;AACH,qBAAa,wBAAyB,YAAW,oBAAoB;IACnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAKvC,OAAO,CAAC,OAAO;IAQT,cAAc,CAAC,KAAK,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoB1E,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAcvD,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAuBpB,SAAS,CAAC,MAAM,EAAE;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,IAAI,CAAC;QACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;KAC9C,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAuC5B,OAAO,CACX,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,wBAAwB,GAC/B,OAAO,CAAC,uBAAuB,CAAC;IAwB7B,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAc/D,IAAI,CACR,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,qBAAqB,GAAG,MAAM,GACrC,OAAO,CAAC,gBAAgB,CAAC;IAwBtB,aAAa,CAAC,KAAK,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAoBtF"}

package/bin/agent/remote/transports/HttpRemoteAgentTransport.js

@@ -0,0 +1,259 @@
+/**
+ * RemoteAgent HTTP transport。
+ *
+ * 关键点（中文）
+ * - 只适配 Town Agent HTTP gateway 的 SDK routes。
+ * - 不处理 RemoteSession 的 turn lifecycle，避免 transport 与 actor 逻辑混在一起。
+ */
+/**
+ * Town HTTP gateway transport。
+ */
+export class HttpRemoteAgentTransport {
+    base_url;
+    token;
+    constructor(url, token) {
+        this.base_url = url.replace(/\/+$/, "");
+        this.token = String(token || "").trim();
+    }
+    headers(input) {
+        const headers = new Headers(input);
+        if (this.token) {
+            headers.set("Authorization", `Bearer ${this.token}`);
+        }
+        return headers;
+    }
+    async create_session(input) {
+        const payload = await read_http_json(`${this.base_url}/api/sdk/sessions`, {
+            method: "POST",
+            headers: this.headers({
+                "Content-Type": "application/json",
+            }),
+            body: JSON.stringify({
+                ...(input?.sessionId ? { sessionId: input.sessionId } : {}),
+            }),
+        });
+        if (!payload.success || !payload.session?.sessionId) {
+            throw new Error(String(payload.error || "Remote session create failed"));
+        }
+        return payload.session;
+    }
+    async get_info(session_id) {
+        const payload = await read_http_json(`${this.base_url}/api/sdk/sessions/${encodeURIComponent(session_id)}`, {
+            headers: this.headers(),
+        });
+        if (!payload.success || !payload.session?.sessionId) {
+            throw new Error(String(payload.error || "Remote session info failed"));
+        }
+        return payload.session;
+    }
+    async prompt(session_id, input) {
+        const payload = await read_http_json(`${this.base_url}/api/sdk/sessions/${encodeURIComponent(session_id)}/prompt`, {
+            method: "POST",
+            headers: this.headers({
+                "Content-Type": "application/json",
+            }),
+            body: JSON.stringify({
+                query: input.query,
+            }),
+        });
+        const id = String(payload.turn?.id || "").trim();
+        if (!payload.success || !id) {
+            throw new Error(String(payload.error || "Remote session prompt failed"));
+        }
+        return { id };
+    }
+    async subscribe(params) {
+        const abort_controller = new AbortController();
+        let resolve_ready;
+        let reject_ready;
+        const ready_promise = new Promise((resolve, reject) => {
+            resolve_ready = resolve;
+            reject_ready = reject;
+        });
+        const response = await fetch(`${this.base_url}/api/sdk/sessions/${encodeURIComponent(params.session_id)}/events`, {
+            headers: this.headers(),
+            signal: abort_controller.signal,
+        });
+        if (!response.ok || !response.body) {
+            const text = await response.text().catch(() => "");
+            throw new Error(text || `Remote session events failed (${response.status})`);
+        }
+        void consume_http_event_stream({
+            body: response.body,
+            abort_controller,
+            on_ready: () => {
+                params.on_ready();
+                resolve_ready();
+            },
+            on_ready_error: (error) => {
+                reject_ready(error);
+            },
+            on_event: params.on_event,
+        });
+        await ready_promise;
+        return {
+            close: async () => {
+                abort_controller.abort();
+            },
+        };
+    }
+    async history(session_id, input) {
+        const query = new URLSearchParams();
+        if (input?.limit !== undefined)
+            query.set("limit", String(input.limit));
+        if (input?.cursor)
+            query.set("cursor", input.cursor);
+        if (input?.order)
+            query.set("order", input.order);
+        if (input?.view)
+            query.set("view", input.view);
+        const payload = await read_http_json(`${this.base_url}/api/sdk/sessions/${encodeURIComponent(session_id)}/history${query.size > 0 ? `?${query.toString()}` : ""}`, {
+            headers: this.headers(),
+        });
+        if (!payload.success || !payload.history || !Array.isArray(payload.history.items)) {
+            throw new Error(String(payload.error || "Remote session history failed"));
+        }
+        return payload.history;
+    }
+    async system(session_id) {
+        const payload = await read_http_json(`${this.base_url}/api/sdk/sessions/${encodeURIComponent(session_id)}/system`, {
+            headers: this.headers(),
+        });
+        if (!payload.success || !payload.system || !Array.isArray(payload.system.blocks)) {
+            throw new Error(String(payload.error || "Remote session system failed"));
+        }
+        return payload.system;
+    }
+    async fork(session_id, input) {
+        const message_id = typeof input === "string"
+            ? String(input || "").trim() || undefined
+            : String(input?.messageId || "").trim() || undefined;
+        const payload = await read_http_json(`${this.base_url}/api/sdk/sessions/${encodeURIComponent(session_id)}/fork`, {
+            method: "POST",
+            headers: this.headers({
+                "Content-Type": "application/json",
+            }),
+            body: JSON.stringify({
+                ...(message_id ? { messageId: message_id } : {}),
+            }),
+        });
+        if (!payload.success || !payload.session?.sessionId) {
+            throw new Error(String(payload.error || "Remote session fork failed"));
+        }
+        return payload.session;
+    }
+    async list_sessions(input) {
+        const query = new URLSearchParams();
+        if (input?.limit !== undefined)
+            query.set("limit", String(input.limit));
+        if (input?.cursor)
+            query.set("cursor", input.cursor);
+        if (input?.query)
+            query.set("query", input.query);
+        const payload = await read_http_json(`${this.base_url}/api/sdk/sessions${query.size > 0 ? `?${query.toString()}` : ""}`, {
+            headers: this.headers(),
+        });
+        if (!payload.success || !payload.page) {
+            throw new Error(String(payload.error || "Remote sessions list failed"));
+        }
+        return payload.page;
+    }
+}
+async function read_http_json(input, init) {
+    const response = await fetch(input, init);
+    const payload = (await response.json().catch(() => ({})));
+    if (!response.ok) {
+        const message = extract_error_message(payload);
+        throw new Error(message || `HTTP ${response.status}`);
+    }
+    return payload;
+}
+async function consume_http_event_stream(params) {
+    const decoder = new TextDecoder();
+    const reader = params.body.getReader();
+    let buffered = "";
+    let ready_resolved = false;
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffered += decoder.decode(value, { stream: true });
+            let newline_index = buffered.indexOf("\n");
+            while (newline_index >= 0) {
+                const line = buffered.slice(0, newline_index).trim();
+                buffered = buffered.slice(newline_index + 1);
+                if (line) {
+                    const value = JSON.parse(line);
+                    if (is_sdk_events_ready_frame(value)) {
+                        ready_resolved = true;
+                        params.on_ready();
+                    }
+                    else {
+                        params.on_event(value);
+                    }
+                }
+                newline_index = buffered.indexOf("\n");
+            }
+        }
+        const tail = buffered.trim();
+        if (tail) {
+            const value = JSON.parse(tail);
+            if (is_sdk_events_ready_frame(value)) {
+                ready_resolved = true;
+                params.on_ready();
+            }
+            else {
+                params.on_event(value);
+            }
+        }
+        if (!params.abort_controller.signal.aborted) {
+            if (!ready_resolved) {
+                const error = new Error("Remote session events connection closed before ready");
+                params.on_ready_error(error);
+                throw error;
+            }
+            params.on_event({
+                type: "error",
+                message: "Remote session events connection closed",
+            });
+        }
+    }
+    catch (error) {
+        if (!params.abort_controller.signal.aborted) {
+            if (!ready_resolved) {
+                params.on_ready_error(error);
+            }
+            params.on_event({
+                type: "error",
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    finally {
+        try {
+            reader.releaseLock();
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+function extract_error_message(payload) {
+    if (!payload || typeof payload !== "object")
+        return "";
+    if ("error" in payload && typeof payload.error === "string") {
+        return payload.error;
+    }
+    if ("message" in payload && typeof payload.message === "string") {
+        return payload.message;
+    }
+    return "";
+}
+function is_sdk_events_ready_frame(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "type" in value &&
+        value.type === "sdk-events-ready");
+}
+//# sourceMappingURL=HttpRemoteAgentTransport.js.map