@telorun/sdk 0.6.0 → 0.7.0

package/dist/index.d.ts

@@ -15,5 +15,6 @@ export * from "./invoke-error.js";
 export * from "./runtime-error.js";
 export * from "./runtime-event.js";
 export * from "./runtime-resource.js";
+export * from "./stream.js";
 export * from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -15,4 +15,5 @@ export * from "./invoke-error.js";
 export * from "./runtime-error.js";
 export * from "./runtime-event.js";
 export * from "./runtime-resource.js";
+export * from "./stream.js";
 export * from "./types.js";

package/dist/stream.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Stream — a thin wrapper around an `AsyncIterable` that gives stream-typed
+ * values a stable, recognized constructor.
+ *
+ * Why this exists: cel-js's runtime type-checker rejects values whose
+ * constructor isn't one of `Object/Map/Array/Set` or a registered object type.
+ * AsyncGenerator instances (the native shape of `async function*` results) hit
+ * that rejection because their `.constructor` is an `AsyncGeneratorFunction`
+ * object — typeof `"object"`, not `"function"` — which `Environment.registerType`
+ * refuses to accept. Wrapping an iterable in a `new Stream(...)` gives the
+ * resulting value a real-class constructor that cel-js can register and
+ * recognize, so `${{ steps.X.result.output }}` evaluations pass through cleanly.
+ *
+ * The companion analyzer registers `Stream` as a CEL object type with no
+ * fields — terminal access (passing the value through) succeeds, member access
+ * (`result.output.text`, `result.output[0]`) raises a CEL error at runtime,
+ * mirroring the analyzer's static check on `x-telo-stream` properties.
+ *
+ * Producers that yield streams (encoder controllers, `Ai.TextStream`, file
+ * read sources, etc.) construct `new Stream(asyncIterable)` for any value
+ * exposed on a stream-typed property. Consumers iterate via `for await`.
+ *
+ * The class implements `AsyncIterable<T>`, so all standard JS iteration
+ * patterns work without unwrapping. Internally it forwards `Symbol.asyncIterator`
+ * to the underlying iterable.
+ */
+export declare class Stream<T = unknown> implements AsyncIterable<T> {
+    private readonly source;
+    constructor(source: AsyncIterable<T>);
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+}
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,MAAM,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAErD,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;CAG3C"}

package/dist/stream.js

@@ -0,0 +1,35 @@
+/**
+ * Stream — a thin wrapper around an `AsyncIterable` that gives stream-typed
+ * values a stable, recognized constructor.
+ *
+ * Why this exists: cel-js's runtime type-checker rejects values whose
+ * constructor isn't one of `Object/Map/Array/Set` or a registered object type.
+ * AsyncGenerator instances (the native shape of `async function*` results) hit
+ * that rejection because their `.constructor` is an `AsyncGeneratorFunction`
+ * object — typeof `"object"`, not `"function"` — which `Environment.registerType`
+ * refuses to accept. Wrapping an iterable in a `new Stream(...)` gives the
+ * resulting value a real-class constructor that cel-js can register and
+ * recognize, so `${{ steps.X.result.output }}` evaluations pass through cleanly.
+ *
+ * The companion analyzer registers `Stream` as a CEL object type with no
+ * fields — terminal access (passing the value through) succeeds, member access
+ * (`result.output.text`, `result.output[0]`) raises a CEL error at runtime,
+ * mirroring the analyzer's static check on `x-telo-stream` properties.
+ *
+ * Producers that yield streams (encoder controllers, `Ai.TextStream`, file
+ * read sources, etc.) construct `new Stream(asyncIterable)` for any value
+ * exposed on a stream-typed property. Consumers iterate via `for await`.
+ *
+ * The class implements `AsyncIterable<T>`, so all standard JS iteration
+ * patterns work without unwrapping. Internally it forwards `Symbol.asyncIterator`
+ * to the underlying iterable.
+ */
+export class Stream {
+    source;
+    constructor(source) {
+        this.source = source;
+    }
+    [Symbol.asyncIterator]() {
+        return this.source[Symbol.asyncIterator]();
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/sdk",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Telo SDK - Public API for Telo module authors.",
   "keywords": [
     "telo",

package/src/index.ts

@@ -15,5 +15,6 @@ export * from "./invoke-error.js";
 export * from "./runtime-error.js";
 export * from "./runtime-event.js";
 export * from "./runtime-resource.js";
+export * from "./stream.js";
 export * from "./types.js";
 

package/src/stream.ts

@@ -0,0 +1,33 @@
+/**
+ * Stream — a thin wrapper around an `AsyncIterable` that gives stream-typed
+ * values a stable, recognized constructor.
+ *
+ * Why this exists: cel-js's runtime type-checker rejects values whose
+ * constructor isn't one of `Object/Map/Array/Set` or a registered object type.
+ * AsyncGenerator instances (the native shape of `async function*` results) hit
+ * that rejection because their `.constructor` is an `AsyncGeneratorFunction`
+ * object — typeof `"object"`, not `"function"` — which `Environment.registerType`
+ * refuses to accept. Wrapping an iterable in a `new Stream(...)` gives the
+ * resulting value a real-class constructor that cel-js can register and
+ * recognize, so `${{ steps.X.result.output }}` evaluations pass through cleanly.
+ *
+ * The companion analyzer registers `Stream` as a CEL object type with no
+ * fields — terminal access (passing the value through) succeeds, member access
+ * (`result.output.text`, `result.output[0]`) raises a CEL error at runtime,
+ * mirroring the analyzer's static check on `x-telo-stream` properties.
+ *
+ * Producers that yield streams (encoder controllers, `Ai.TextStream`, file
+ * read sources, etc.) construct `new Stream(asyncIterable)` for any value
+ * exposed on a stream-typed property. Consumers iterate via `for await`.
+ *
+ * The class implements `AsyncIterable<T>`, so all standard JS iteration
+ * patterns work without unwrapping. Internally it forwards `Symbol.asyncIterator`
+ * to the underlying iterable.
+ */
+export class Stream<T = unknown> implements AsyncIterable<T> {
+  constructor(private readonly source: AsyncIterable<T>) {}
+
+  [Symbol.asyncIterator](): AsyncIterator<T> {
+    return this.source[Symbol.asyncIterator]();
+  }
+}