@halo-sdk/stream 1.0.0

package/README.md

@@ -0,0 +1,6 @@
+# @halo-sdk/stream
+
+Streaming utilities for Halo AI SDK.
+
+- `toDataStream` — convert `AsyncGenerator<TurnChunk>` to SSE Response (Vercel AI SDK compatible)
+- `createHaloStream` — custom stream factory

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { toDataStream, createHaloStream } from "./stream.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { toDataStream, createHaloStream } from "./stream.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/stream.d.ts

@@ -0,0 +1,18 @@
+import type { TurnChunk, ToolCall, Usage } from "@halo-sdk/core";
+/**
+ * Wraps an AsyncGenerator<TurnChunk> as an SSE Response.
+ * Format compatible with Vercel AI SDK's 0:/d: protocol.
+ */
+export declare function toDataStream(source: AsyncGenerator<TurnChunk>, opts?: {
+    headers?: Record<string, string>;
+}): Response;
+/**
+ * Custom stream entry. Does not go through HaloAgent.
+ */
+export declare function createHaloStream(fn: (ctrl: {
+    writeText: (delta: string) => void;
+    writeToolCall: (call: ToolCall) => void;
+    close: (usage?: Usage) => void;
+    error: (err: Error) => void;
+}) => Promise<void>): ReadableStream;
+//# sourceMappingURL=stream.d.ts.map

package/dist/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,CAAC,SAAS,CAAC,EACjC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC1C,QAAQ,CAqCV;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,CAAC,IAAI,EAAE;IACT,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,aAAa,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACxC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAC7B,KAAK,OAAO,CAAC,IAAI,CAAC,GAClB,cAAc,CAoBhB"}

package/dist/stream.js

@@ -0,0 +1,68 @@
+/**
+ * Wraps an AsyncGenerator<TurnChunk> as an SSE Response.
+ * Format compatible with Vercel AI SDK's 0:/d: protocol.
+ */
+export function toDataStream(source, opts) {
+    const stream = new ReadableStream({
+        async start(controller) {
+            const encoder = new TextEncoder();
+            try {
+                for await (const chunk of source) {
+                    switch (chunk.type) {
+                        case "text-delta":
+                            controller.enqueue(encoder.encode(`0:${JSON.stringify(chunk.delta)}\n`));
+                            break;
+                        case "tool-call-delta":
+                            controller.enqueue(encoder.encode(`9:${JSON.stringify([chunk])}\n`));
+                            break;
+                        case "tool-call-ready":
+                            controller.enqueue(encoder.encode(`9:${JSON.stringify([chunk])}\n`));
+                            break;
+                        case "done":
+                            controller.enqueue(encoder.encode(`d:${JSON.stringify({ usage: chunk.usage })}\n`));
+                            break;
+                    }
+                }
+            }
+            catch (err) {
+                controller.error(err);
+            }
+            finally {
+                controller.close();
+            }
+        },
+    });
+    return new Response(stream, {
+        headers: {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache",
+            Connection: "keep-alive",
+            ...opts?.headers,
+        },
+    });
+}
+/**
+ * Custom stream entry. Does not go through HaloAgent.
+ */
+export function createHaloStream(fn) {
+    return new ReadableStream({
+        async start(controller) {
+            const encoder = new TextEncoder();
+            await fn({
+                writeText(delta) {
+                    controller.enqueue(encoder.encode(delta));
+                },
+                writeToolCall(call) {
+                    controller.enqueue(encoder.encode(JSON.stringify(call)));
+                },
+                close(_usage) {
+                    controller.close();
+                },
+                error(err) {
+                    controller.error(err);
+                },
+            });
+        },
+    });
+}
+//# sourceMappingURL=stream.js.map

package/dist/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAiC,EACjC,IAA2C;IAE3C,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,KAAK,CAAC,KAAK,CAAC,UAAU;YACpB,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;oBACjC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;wBACnB,KAAK,YAAY;4BACf,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;4BACzE,MAAM;wBACR,KAAK,iBAAiB;4BACpB,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;4BACrE,MAAM;wBACR,KAAK,iBAAiB;4BACpB,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;4BACrE,MAAM;wBACR,KAAK,MAAM;4BACT,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;4BACpF,MAAM;oBACV,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;oBAAS,CAAC;gBACT,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE;QAC1B,OAAO,EAAE;YACP,cAAc,EAAE,mBAAmB;YACnC,eAAe,EAAE,UAAU;YAC3B,UAAU,EAAE,YAAY;YACxB,GAAG,IAAI,EAAE,OAAO;SACjB;KACF,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,EAKmB;IAEnB,OAAO,IAAI,cAAc,CAAC;QACxB,KAAK,CAAC,KAAK,CAAC,UAAU;YACpB,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;YAClC,MAAM,EAAE,CAAC;gBACP,SAAS,CAAC,KAAK;oBACb,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC5C,CAAC;gBACD,aAAa,CAAC,IAAI;oBAChB,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC3D,CAAC;gBACD,KAAK,CAAC,MAAM;oBACV,UAAU,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC;gBACD,KAAK,CAAC,GAAG;oBACP,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACxB,CAAC;aACF,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@halo-sdk/stream",
+  "version": "1.0.0",
+  "description": "Streaming utilities for Halo AI SDK — SSE Response for Vercel AI SDK compatibility",
+  "license": "MIT",
+  "keywords": [
+    "ai",
+    "llm",
+    "streaming",
+    "sse",
+    "vercel-ai-sdk"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/halo-sdk/halo-ai",
+    "directory": "packages/stream"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@halo-sdk/core": ">=1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0",
+    "@halo-sdk/core": "1.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}