@agent-os-sdk/client 0.9.26 → 0.9.27

package/dist/sse/client.d.ts

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

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

package/{src/sse/client.ts → dist/sse/client.js}

@@ -1,30 +1,15 @@
 /**
  * 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", {
@@ -35,88 +20,77 @@ export type SSEOptions = {
  * }
  * ```
  */
-export async function* parseSSE<T>(
-    response: Response,
-    options?: { onOpen?: () => void }
-): AsyncGenerator<SSEEvent<T>> {
+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: Partial<SSEEvent<T>> = { event: "message" };
-
+    let currentEvent = { event: "message" };
     try {
         while (true) {
             const { done, value } = await reader.read();
-            if (done) break;
-
+            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 as SSEEvent<T>;
+                        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:")) {
+                }
+                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) as T;
-                    } catch {
-                        currentEvent.data = dataStr as T;
+                        currentEvent.data = JSON.parse(dataStr);
+                    }
+                    catch {
+                        currentEvent.data = dataStr;
                     }
-                } else if (line.startsWith("id:")) {
+                }
+                else if (line.startsWith("id:")) {
                     currentEvent.id = line.slice(3).trim();
-                } else if (line.startsWith("retry:")) {
+                }
+                else if (line.startsWith("retry:")) {
                     currentEvent.retry = parseInt(line.slice(6).trim(), 10);
                 }
             }
         }
-    } finally {
+    }
+    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<T>(
-    url: string,
-    options: SSEOptions = {}
-): AsyncGenerator<SSEEvent<T>> {
+export async function* streamSSE(url, options = {}) {
     const response = await fetch(url, {
         method: "GET",
         headers: {
@@ -125,55 +99,5 @@ export async function* streamSSE<T>(
         },
         signal: options.signal,
     });
-
-    yield* parseSSE<T>(response, { onOpen: options.onOpen });
-}
-
-/**
- * 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;
+    yield* parseSSE(response, { onOpen: options.onOpen });
 }
-
-/**
- * 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 };

package/package.json

@@ -1,15 +1,15 @@
 {
     "name": "@agent-os-sdk/client",
-    "version": "0.9.26",
+    "version": "0.9.27",
     "description": "Official TypeScript SDK for Agent OS platform",
     "type": "module",
-    "main": "./index.js",
-    "module": "./index.js",
-    "types": "./index.d.ts",
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
     "exports": {
         ".": {
-            "import": "./index.js",
-            "types": "./index.d.ts"
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
         }
     },
     "scripts": {
@@ -47,14 +47,7 @@
         "vitest": "^4.0.18"
     },
     "files": [
-        "client",
-        "errors",
-        "generated",
-        "index.d.ts",
-        "index.d.ts.map",
-        "index.js",
-        "modules",
-        "src",
-        "sse"
+        "dist",
+        "README.md"
     ]
 }