@agent-os-sdk/client 0.9.25 → 0.9.26

package/dist/sse/client.d.ts

@@ -1,140 +0,0 @@
-/**
- * Agent OS SDK - SSE Client
- *
- * Typed Server-Sent Events client for streaming endpoints.
- *
- * This module provides utilities for parsing SSE responses.
- * The actual HTTP request should be made via rawClient.streamGet/streamPost.
- */
-export type SSEEvent<T = unknown> = {
-    id?: string;
-    event: string;
-    data: T;
-    retry?: number;
-};
-export type SSEOptions = {
-    headers?: Record<string, string>;
-    onOpen?: () => void;
-    onError?: (error: Error) => void;
-    signal?: AbortSignal;
-};
-/**
- * Parse SSE events from a Response object.
- * Use this with rawClient.streamGet() or rawClient.streamPost().
- *
- * @example
- * ```ts
- * const response = await client.streamGet("/v1/api/runs/{runId}/events/stream", {
- *   params: { path: { runId }, query: { attemptId, afterSeq: 0 } }
- * });
- * for await (const event of parseSSE<RunStreamEvent>(response)) {
- *   console.log(event);
- * }
- * ```
- */
-export declare function parseSSE<T>(response: Response, options?: {
-    onOpen?: () => void;
-}): AsyncGenerator<SSEEvent<T>>;
-/**
- * Legacy streamSSE function - DEPRECATED.
- * Use rawClient.streamGet() + parseSSE() instead.
- *
- * Kept for backward compatibility during migration.
- *
- * @deprecated Use rawClient.streamGet() + parseSSE() instead
- */
-export declare function streamSSE<T>(url: string, options?: SSEOptions): AsyncGenerator<SSEEvent<T>>;
-/**
- * Run event from the execution ledger (Wave 2.3).
- * This is the actual payload sent within SSE `run_event` messages.
- */
-export interface RunEventDto {
-    id: string;
-    seq: number;
-    type: string;
-    timestamp: string;
-    attempt_id: string;
-    payload: Record<string, unknown> | null;
-    truncated?: boolean;
-}
-/**
- * SSE Event types for Run streaming (V1.2 Cinema Mode).
- *
- * The server sends these event types:
- * - `connected`: Initial connection acknowledgment
- * - `run_event`: Individual run events from the ledger (with seq for resume)
- * - `heartbeat`: Keepalive every 15s
- * - `close`: Run reached terminal state (completed/failed/canceled)
- * - `error`: Stream error occurred
- *
- * Each event has an `id` field containing the seq number for Last-Event-ID resume support.
- */
-export type RunSSEEvent = {
-    event: "connected";
-    data: {
-        run_id: string;
-        start_seq: number;
-    };
-} | {
-    event: "run_event";
-    data: RunEventDto;
-} | {
-    event: "heartbeat";
-    data: {
-        timestamp: string;
-    };
-} | {
-    event: "close";
-    data: {
-        final_status: string;
-        final_seq: number;
-    };
-} | {
-    event: "error";
-    data: {
-        code?: string;
-        message: string;
-    };
-};
-/**
- * @deprecated Use RunSSEEvent for typed SSE events, or RunEventDto for event payloads.
- * Kept for backward compatibility.
- */
-export type RunStreamEvent = {
-    type: "run_started";
-    run_id: string;
-    status: string;
-} | {
-    type: "node_started";
-    node_name: string;
-    timestamp: string;
-} | {
-    type: "node_completed";
-    node_name: string;
-    output: unknown;
-} | {
-    type: "tool_call";
-    tool_name: string;
-    args: unknown;
-} | {
-    type: "tool_result";
-    tool_name: string;
-    result: unknown;
-} | {
-    type: "checkpoint";
-    checkpoint_id: string;
-    step_name: string;
-} | {
-    type: "waiting_for_human";
-    prompt: string;
-} | {
-    type: "run_completed";
-    output: unknown;
-} | {
-    type: "run_failed";
-    error: unknown;
-} | {
-    type: "heartbeat";
-    timestamp: string;
-};
-//# sourceMappingURL=client.d.ts.map

package/dist/sse/client.d.ts.map

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

package/dist/sse/client.js

@@ -1,103 +0,0 @@
-/**
- * Agent OS SDK - SSE Client
- *
- * Typed Server-Sent Events client for streaming endpoints.
- *
- * This module provides utilities for parsing SSE responses.
- * The actual HTTP request should be made via rawClient.streamGet/streamPost.
- */
-/**
- * Parse SSE events from a Response object.
- * Use this with rawClient.streamGet() or rawClient.streamPost().
- *
- * @example
- * ```ts
- * const response = await client.streamGet("/v1/api/runs/{runId}/events/stream", {
- *   params: { path: { runId }, query: { attemptId, afterSeq: 0 } }
- * });
- * for await (const event of parseSSE<RunStreamEvent>(response)) {
- *   console.log(event);
- * }
- * ```
- */
-export async function* parseSSE(response, options) {
-    if (!response.ok) {
-        throw new Error(`SSE connection failed: ${response.status}`);
-    }
-    if (!response.body) {
-        throw new Error("No response body");
-    }
-    options?.onOpen?.();
-    const reader = response.body.getReader();
-    const decoder = new TextDecoder();
-    let buffer = "";
-    // State must be maintained across chunks
-    let currentEvent = { event: "message" };
-    try {
-        while (true) {
-            const { done, value } = await reader.read();
-            if (done)
-                break;
-            buffer += decoder.decode(value, { stream: true });
-            const lines = buffer.split("\n");
-            // Keep the last partial line in the buffer
-            buffer = lines.pop() ?? "";
-            for (const line of lines) {
-                const trimmed = line.trim();
-                if (trimmed === "") {
-                    // Empty line triggers event dispatch if we have data
-                    if (currentEvent.data !== undefined) {
-                        yield currentEvent;
-                    }
-                    // Reset for next event
-                    currentEvent = { event: "message" };
-                    continue;
-                }
-                if (line.startsWith("event:")) {
-                    currentEvent.event = line.slice(6).trim();
-                }
-                else if (line.startsWith("data:")) {
-                    const dataStr = line.slice(5).trim();
-                    try {
-                        // Accumulate data if meaningful (though standard SSE usually has one data line per event, 
-                        // multiline data is possible but rare in this specific protocol. 
-                        // For simplicity and matching current backend, we overwrite or concatenation check could be stricter).
-                        // Given strict JSON protocol, we assume valid info per data line or single data line.
-                        currentEvent.data = JSON.parse(dataStr);
-                    }
-                    catch {
-                        currentEvent.data = dataStr;
-                    }
-                }
-                else if (line.startsWith("id:")) {
-                    currentEvent.id = line.slice(3).trim();
-                }
-                else if (line.startsWith("retry:")) {
-                    currentEvent.retry = parseInt(line.slice(6).trim(), 10);
-                }
-            }
-        }
-    }
-    finally {
-        reader.releaseLock();
-    }
-}
-/**
- * Legacy streamSSE function - DEPRECATED.
- * Use rawClient.streamGet() + parseSSE() instead.
- *
- * Kept for backward compatibility during migration.
- *
- * @deprecated Use rawClient.streamGet() + parseSSE() instead
- */
-export async function* streamSSE(url, options = {}) {
-    const response = await fetch(url, {
-        method: "GET",
-        headers: {
-            Accept: "text/event-stream",
-            ...options.headers,
-        },
-        signal: options.signal,
-    });
-    yield* parseSSE(response, { onOpen: options.onOpen });
-}