@amigo-ai/platform-sdk 0.17.3 → 0.19.0

package/api.md

@@ -239,6 +239,7 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `get`
 - `close`
 - `createTurn`
+- `createTurnStream`
 - `textStreamUrl`
 
 ### `phoneNumbers`

package/dist/index.cjs

@@ -1984,10 +1984,47 @@ var ConversationsResource = class extends WorkspaceScopedResource {
         params: {
           path: { workspace_id: this.workspaceId, conversation_id: conversationId }
         },
-        body: request
+        body: request,
+        headers: { Accept: "application/json" }
       })
     );
   }
+  /**
+   * Send a message and receive the agent's response as an SSE stream.
+   *
+   * Returns a `ReadableStream` of SSE bytes. Use `EventSourceParserStream`
+   * (from `eventsource-parser/stream`) to parse into typed `TurnStreamEvent`.
+   *
+   * @example
+   * ```ts
+   * const stream = await client.conversations.createTurnStream(convId, { message: "Hello" });
+   * const events = stream
+   *   .pipeThrough(new TextDecoderStream())
+   *   .pipeThrough(new EventSourceParserStream());
+   * for await (const event of events) {
+   *   const parsed = JSON.parse(event.data) as TurnStreamEvent;
+   *   if (parsed.event === "token") console.log(parsed.text);
+   * }
+   * ```
+   */
+  async createTurnStream(conversationId, request, options) {
+    const result = await this.client.POST(
+      "/v1/{workspace_id}/conversations/{conversation_id}/turns",
+      {
+        params: {
+          path: { workspace_id: this.workspaceId, conversation_id: conversationId }
+        },
+        body: request,
+        headers: { Accept: "text/event-stream" },
+        parseAs: "stream",
+        signal: options?.signal
+      }
+    );
+    if (result.error !== void 0) {
+      throw new Error(`API error: ${JSON.stringify(result.error)}`);
+    }
+    return result.data;
+  }
   /** Build the real-time text WebSocket URL for browser or custom clients. */
   textStreamUrl(params) {
     const url = buildTextStreamUrl({