@agent-os-sdk/client 0.3.0 → 0.3.1

package/src/sse/client.ts

@@ -2,6 +2,9 @@
  * 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> = {
@@ -19,21 +22,23 @@ export type SSEOptions = {
 };
 
 /**
- * Creates a typed SSE stream from a URL.
+ * 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}/stream", {
+ *   params: { path: { runId } }
+ * });
+ * for await (const event of parseSSE<RunStreamEvent>(response)) {
+ *   console.log(event);
+ * }
+ * ```
  */
-export async function* streamSSE<T>(
-    url: string,
-    options: SSEOptions = {}
+export async function* parseSSE<T>(
+    response: Response,
+    options?: { onOpen?: () => void }
 ): AsyncGenerator<SSEEvent<T>> {
-    const response = await fetch(url, {
-        method: "GET",
-        headers: {
-            Accept: "text/event-stream",
-            ...options.headers,
-        },
-        signal: options.signal,
-    });
-
     if (!response.ok) {
         throw new Error(`SSE connection failed: ${response.status}`);
     }
@@ -42,7 +47,7 @@ export async function* streamSSE<T>(
         throw new Error("No response body");
     }
 
-    options.onOpen?.();
+    options?.onOpen?.();
 
     const reader = response.body.getReader();
     const decoder = new TextDecoder();
@@ -84,6 +89,30 @@ export async function* streamSSE<T>(
     }
 }
 
+/**
+ * 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>> {
+    const response = await fetch(url, {
+        method: "GET",
+        headers: {
+            Accept: "text/event-stream",
+            ...options.headers,
+        },
+        signal: options.signal,
+    });
+
+    yield* parseSSE<T>(response, { onOpen: options.onOpen });
+}
+
 /**
  * SSE Event types for Run streaming
  */