@trigger.dev/sdk 0.0.0-prerelease-20251007140052 → 0.0.0-prerelease-20251113143926

package/dist/commonjs/v3/streams.d.ts

@@ -0,0 +1,266 @@
+import { AsyncIterableStream, WriterStreamOptions, PipeStreamOptions, PipeStreamResult, ReadStreamOptions, AppendStreamOptions, RealtimeDefinedStream, InferStreamType } from "@trigger.dev/core/v3";
+/**
+ * Pipes data to a realtime stream using the default stream key (`"default"`).
+ *
+ * This is a convenience overload that allows you to pipe data without specifying a stream key.
+ * The stream will be created/accessed with the key `"default"`.
+ *
+ * @template T - The type of data chunks in the stream
+ * @param value - The stream of data to pipe from. Can be an `AsyncIterable<T>` or `ReadableStream<T>`.
+ * @param options - Optional configuration for the stream operation
+ * @returns A promise that resolves to an object containing:
+ *   - `stream`: The original stream (can be consumed in your task)
+ *   - `waitUntilComplete`: A function that returns a promise resolving when the stream is fully sent
+ *
+ * @example
+ * ```ts
+ * import { streams } from "@trigger.dev/sdk";
+ *
+ * // Stream OpenAI completion chunks to the default stream
+ * const completion = await openai.chat.completions.create({
+ *   model: "gpt-4",
+ *   messages: [{ role: "user", content: "Hello" }],
+ *   stream: true,
+ * });
+ *
+ * const { waitUntilComplete } = await streams.pipe(completion);
+ *
+ * // Process the stream locally
+ * for await (const chunk of completion) {
+ *   console.log(chunk);
+ * }
+ *
+ * // Or alternatievely wait for all chunks to be sent to the realtime stream
+ * await waitUntilComplete();
+ * ```
+ */
+declare function pipe<T>(value: AsyncIterable<T> | ReadableStream<T>, options?: PipeStreamOptions): PipeStreamResult<T>;
+/**
+ * Pipes data to a realtime stream with a specific stream key.
+ *
+ * Use this overload when you want to use a custom stream key instead of the default.
+ *
+ * @template T - The type of data chunks in the stream
+ * @param key - The unique identifier for this stream. If multiple streams use the same key,
+ *   they will be merged into a single stream. Defaults to `"default"` if not provided.
+ * @param value - The stream of data to pipe from. Can be an `AsyncIterable<T>` or `ReadableStream<T>`.
+ * @param options - Optional configuration for the stream operation
+ * @returns A promise that resolves to an object containing:
+ *   - `stream`: The original stream (can be consumed in your task)
+ *   - `waitUntilComplete`: A function that returns a promise resolving when the stream is fully sent
+ *
+ * @example
+ * ```ts
+ * import { streams } from "@trigger.dev/sdk";
+ *
+ * // Stream data to a specific stream key
+ * const myStream = createAsyncGenerator();
+ * const { waitUntilComplete } = await streams.pipe("my-custom-stream", myStream);
+ *
+ * // Process the stream locally
+ * for await (const chunk of myStream) {
+ *   console.log(chunk);
+ * }
+ *
+ * // Wait for all chunks to be sent
+ * await waitUntilComplete();
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Stream to a parent run
+ * await streams.pipe("output", myStream, {
+ *   target: "parent",
+ * });
+ * ```
+ */
+declare function pipe<T>(key: string, value: AsyncIterable<T> | ReadableStream<T>, options?: PipeStreamOptions): PipeStreamResult<T>;
+/**
+ * Reads data from a realtime stream using the default stream key (`"default"`).
+ *
+ * This is a convenience overload that allows you to read from the default stream without
+ * specifying a stream key. The stream will be accessed with the key `"default"`.
+ *
+ * @template T - The type of data chunks in the stream
+ * @param runId - The unique identifier of the run to read the stream from
+ * @param options - Optional configuration for reading the stream
+ * @returns A promise that resolves to an `AsyncIterableStream<T>` that can be consumed
+ *   using `for await...of` or as a `ReadableStream`.
+ *
+ * @example
+ * ```ts
+ * import { streams } from "@trigger.dev/sdk/v3";
+ *
+ * // Read from the default stream
+ * const stream = await streams.read<string>(runId);
+ *
+ * for await (const chunk of stream) {
+ *   console.log("Received chunk:", chunk);
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Read with custom timeout and starting position
+ * const stream = await streams.read<string>(runId, {
+ *   timeoutInSeconds: 120,
+ *   startIndex: 10, // Start from the 10th chunk
+ * });
+ * ```
+ */
+declare function read<T>(runId: string, options?: ReadStreamOptions): Promise<AsyncIterableStream<T>>;
+/**
+ * Reads data from a realtime stream with a specific stream key.
+ *
+ * Use this overload when you want to read from a stream with a custom key.
+ *
+ * @template T - The type of data chunks in the stream
+ * @param runId - The unique identifier of the run to read the stream from
+ * @param key - The unique identifier of the stream to read from. Defaults to `"default"` if not provided.
+ * @param options - Optional configuration for reading the stream
+ * @returns A promise that resolves to an `AsyncIterableStream<T>` that can be consumed
+ *   using `for await...of` or as a `ReadableStream`.
+ *
+ * @example
+ * ```ts
+ * import { streams } from "@trigger.dev/sdk";
+ *
+ * // Read from a specific stream key
+ * const stream = await streams.read<string>(runId, "my-custom-stream");
+ *
+ * for await (const chunk of stream) {
+ *   console.log("Received chunk:", chunk);
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Read with signal for cancellation
+ * const controller = new AbortController();
+ * const stream = await streams.read<string>(runId, "my-stream", {
+ *   signal: controller.signal,
+ *   timeoutInSeconds: 30,
+ * });
+ *
+ * // Cancel after 5 seconds
+ * setTimeout(() => controller.abort(), 5000);
+ * ```
+ */
+declare function read<T>(runId: string, key: string, options?: ReadStreamOptions): Promise<AsyncIterableStream<T>>;
+declare function append<TPart extends BodyInit>(value: TPart, options?: AppendStreamOptions): Promise<void>;
+declare function append<TPart extends BodyInit>(key: string, value: TPart, options?: AppendStreamOptions): Promise<void>;
+/**
+ * Writes data to a realtime stream using the default stream key (`"default"`).
+ *
+ * This is a convenience overload that allows you to write to the default stream without
+ * specifying a stream key. The stream will be created/accessed with the key `"default"`.
+ *
+ * @template TPart - The type of data chunks in the stream
+ * @param options - The options for writing to the stream
+ * @returns A promise that resolves to an object containing:
+ *   - `stream`: The original stream (can be consumed in your task)
+ *   - `waitUntilComplete`: A function that returns a promise resolving when the stream is fully sent
+ *
+ * @example
+ * ```ts
+ * import { streams } from "@trigger.dev/sdk";
+ *
+ * // Write to the default stream
+ * const { waitUntilComplete } = await streams.writer({
+ *   execute: ({ write, merge }) => {
+ *     write("chunk 1");
+ *     write("chunk 2");
+ *     write("chunk 3");
+ *   },
+ * });
+ *
+ * // Wait for all chunks to be written
+ * await waitUntilComplete();
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Write to a specific stream key
+ * const { waitUntilComplete } = await streams.writer("my-custom-stream", {
+ *   execute: ({ write, merge }) => {
+ *     write("chunk 1");
+ *     write("chunk 2");
+ *     write("chunk 3");
+ *   },
+ * });
+ *
+ * // Wait for all chunks to be written
+ * await waitUntilComplete();
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Write to a parent run
+ * await streams.writer("output", {
+ *   execute: ({ write, merge }) => {
+ *     write("chunk 1");
+ *     write("chunk 2");
+ *     write("chunk 3");
+ *   },
+ * });
+ *
+ * // Wait for all chunks to be written
+ * await waitUntilComplete();
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Write to a specific stream key
+ * await streams.writer("my-custom-stream", {
+ *   execute: ({ write, merge }) => {
+ *     write("chunk 1");
+ *     write("chunk 2");
+ *     write("chunk 3");
+ *   },
+ * });
+ *
+ * // Wait for all chunks to be written
+ * await waitUntilComplete();
+ * ```
+ */
+declare function writer<TPart>(options: WriterStreamOptions<TPart>): PipeStreamResult<TPart>;
+/**
+ * Writes data to a realtime stream with a specific stream key.
+ *
+ * @template TPart - The type of data chunks in the stream
+ * @param key - The unique identifier of the stream to write to. Defaults to `"default"` if not provided.
+ * @param options - The options for writing to the stream
+ * @returns A promise that resolves to an object containing:
+ *   - `stream`: The original stream (can be consumed in your task)
+ *   - `waitUntilComplete`: A function that returns a promise resolving when the stream is fully sent
+ *
+ * @example
+ * ```ts
+ * import { streams } from "@trigger.dev/sdk";
+ *
+ * // Write to a specific stream key
+ * const { waitUntilComplete } = await streams.writer("my-custom-stream", {
+ *   execute: ({ write, merge }) => {
+ *     write("chunk 1");
+ *     write("chunk 2");
+ *     write("chunk 3");
+ *   },
+ * });
+ *
+ * // Wait for all chunks to be written
+ * await waitUntilComplete();
+ * ```
+ */
+declare function writer<TPart>(key: string, options: WriterStreamOptions<TPart>): PipeStreamResult<TPart>;
+export type RealtimeDefineStreamOptions = {
+    id: string;
+};
+declare function define<TPart>(opts: RealtimeDefineStreamOptions): RealtimeDefinedStream<TPart>;
+export type { InferStreamType };
+export declare const streams: {
+    pipe: typeof pipe;
+    read: typeof read;
+    append: typeof append;
+    writer: typeof writer;
+    define: typeof define;
+};

package/dist/commonjs/v3/streams.js

@@ -0,0 +1,322 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.streams = void 0;
+const v3_1 = require("@trigger.dev/core/v3");
+const tracer_js_1 = require("./tracer.js");
+const api_1 = require("@opentelemetry/api");
+const DEFAULT_STREAM_KEY = "default";
+function pipe(keyOrValue, valueOrOptions, options) {
+    // Handle overload: pipe(value, options?) or pipe(key, value, options?)
+    let key;
+    let value;
+    let opts;
+    if (typeof keyOrValue === "string") {
+        // pipe(key, value, options?)
+        key = keyOrValue;
+        value = valueOrOptions;
+        opts = options;
+    }
+    else {
+        // pipe(value, options?)
+        key = DEFAULT_STREAM_KEY;
+        value = keyOrValue;
+        opts = valueOrOptions;
+    }
+    return pipeInternal(key, value, opts, "streams.pipe()");
+}
+/**
+ * Internal pipe implementation that allows customizing the span name.
+ * This is used by both the public `pipe` method and the `writer` method.
+ */
+function pipeInternal(key, value, opts, spanName) {
+    const runId = getRunIdForOptions(opts);
+    if (!runId) {
+        throw new Error("Could not determine the target run ID for the realtime stream. Please specify a target run ID using the `target` option or use this function from inside a task.");
+    }
+    const span = tracer_js_1.tracer.startSpan(spanName, {
+        attributes: {
+            key,
+            runId,
+            [v3_1.SemanticInternalAttributes.ENTITY_TYPE]: "realtime-stream",
+            [v3_1.SemanticInternalAttributes.ENTITY_ID]: `${runId}:${key}`,
+            [v3_1.SemanticInternalAttributes.STYLE_ICON]: "streams",
+            ...(0, v3_1.accessoryAttributes)({
+                items: [
+                    {
+                        text: key,
+                        variant: "normal",
+                    },
+                ],
+                style: "codepath",
+            }),
+        },
+    });
+    const requestOptions = (0, v3_1.mergeRequestOptions)({}, opts?.requestOptions);
+    try {
+        const instance = v3_1.realtimeStreams.pipe(key, value, {
+            signal: opts?.signal,
+            target: runId,
+            requestOptions,
+        });
+        instance.wait().finally(() => {
+            span.end();
+        });
+        return {
+            stream: instance.stream,
+            waitUntilComplete: () => instance.wait(),
+        };
+    }
+    catch (error) {
+        // if the error is a signal abort error, we need to end the span but not record an exception
+        if (error instanceof Error && error.name === "AbortError") {
+            span.end();
+            throw error;
+        }
+        if (error instanceof Error || typeof error === "string") {
+            span.recordException(error);
+        }
+        else {
+            span.recordException(String(error));
+        }
+        span.setStatus({ code: api_1.SpanStatusCode.ERROR });
+        span.end();
+        throw error;
+    }
+}
+async function read(runId, keyOrOptions, options) {
+    // Handle overload: read(runId, options?) or read(runId, key, options?)
+    let key;
+    let opts;
+    if (typeof keyOrOptions === "string") {
+        // read(runId, key, options?)
+        key = keyOrOptions;
+        opts = options;
+    }
+    else {
+        // read(runId, options?)
+        key = DEFAULT_STREAM_KEY;
+        opts = keyOrOptions;
+    }
+    // Rename to readStream for consistency with existing code
+    return readStreamImpl(runId, key, opts);
+}
+async function readStreamImpl(runId, key, options) {
+    const apiClient = v3_1.apiClientManager.clientOrThrow();
+    const span = tracer_js_1.tracer.startSpan("streams.read()", {
+        attributes: {
+            key,
+            runId,
+            [v3_1.SemanticInternalAttributes.ENTITY_TYPE]: "realtime-stream",
+            [v3_1.SemanticInternalAttributes.ENTITY_ID]: `${runId}:${key}`,
+            [v3_1.SemanticInternalAttributes.ENTITY_METADATA]: JSON.stringify({
+                startIndex: options?.startIndex,
+            }),
+            [v3_1.SemanticInternalAttributes.STYLE_ICON]: "streams",
+            ...(0, v3_1.accessoryAttributes)({
+                items: [
+                    {
+                        text: key,
+                        variant: "normal",
+                    },
+                ],
+                style: "codepath",
+            }),
+        },
+    });
+    return await apiClient.fetchStream(runId, key, {
+        signal: options?.signal,
+        timeoutInSeconds: options?.timeoutInSeconds ?? 60,
+        lastEventId: options?.startIndex ? (options.startIndex - 1).toString() : undefined,
+        onComplete: () => {
+            span.end();
+        },
+        onError: (error) => {
+            span.recordException(error);
+            span.setStatus({ code: api_1.SpanStatusCode.ERROR });
+            span.end();
+        },
+    });
+}
+function append(keyOrValue, valueOrOptions, options) {
+    if (typeof keyOrValue === "string" && typeof valueOrOptions === "string") {
+        return appendInternal(keyOrValue, valueOrOptions, options);
+    }
+    if (typeof keyOrValue === "string") {
+        if (isAppendStreamOptions(valueOrOptions)) {
+            return appendInternal(DEFAULT_STREAM_KEY, keyOrValue, valueOrOptions);
+        }
+        else {
+            if (!valueOrOptions) {
+                return appendInternal(DEFAULT_STREAM_KEY, keyOrValue, options);
+            }
+            return appendInternal(keyOrValue, valueOrOptions, options);
+        }
+    }
+    else {
+        if (isAppendStreamOptions(valueOrOptions)) {
+            return appendInternal(DEFAULT_STREAM_KEY, keyOrValue, valueOrOptions);
+        }
+        else {
+            return appendInternal(DEFAULT_STREAM_KEY, keyOrValue, options);
+        }
+    }
+}
+async function appendInternal(key, part, options) {
+    const runId = getRunIdForOptions(options);
+    if (!runId) {
+        throw new Error("Could not determine the target run ID for the realtime stream. Please specify a target run ID using the `target` option or use this function from inside a task.");
+    }
+    const span = tracer_js_1.tracer.startSpan("streams.append()", {
+        attributes: {
+            key,
+            runId,
+            [v3_1.SemanticInternalAttributes.ENTITY_TYPE]: "realtime-stream",
+            [v3_1.SemanticInternalAttributes.ENTITY_ID]: `${runId}:${key}`,
+            [v3_1.SemanticInternalAttributes.STYLE_ICON]: "streams",
+            ...(0, v3_1.accessoryAttributes)({
+                items: [
+                    {
+                        text: key,
+                        variant: "normal",
+                    },
+                ],
+                style: "codepath",
+            }),
+        },
+    });
+    try {
+        await v3_1.realtimeStreams.append(key, part, options);
+        span.end();
+    }
+    catch (error) {
+        // if the error is a signal abort error, we need to end the span but not record an exception
+        if (error instanceof Error && error.name === "AbortError") {
+            span.end();
+            throw error;
+        }
+        if (error instanceof Error || typeof error === "string") {
+            span.recordException(error);
+        }
+        else {
+            span.recordException(String(error));
+        }
+        span.setStatus({ code: api_1.SpanStatusCode.ERROR });
+        span.end();
+        throw error;
+    }
+}
+function isAppendStreamOptions(val) {
+    return (typeof val === "object" &&
+        val !== null &&
+        !Array.isArray(val) &&
+        (("target" in val && typeof val.target === "string") ||
+            ("requestOptions" in val && typeof val.requestOptions === "object")));
+}
+function writer(keyOrOptions, valueOrOptions) {
+    if (typeof keyOrOptions === "string") {
+        return writerInternal(keyOrOptions, valueOrOptions);
+    }
+    return writerInternal(DEFAULT_STREAM_KEY, keyOrOptions);
+}
+function writerInternal(key, options) {
+    let controller;
+    const ongoingStreamPromises = [];
+    const stream = new ReadableStream({
+        start(controllerArg) {
+            controller = controllerArg;
+        },
+    });
+    function safeEnqueue(data) {
+        try {
+            controller.enqueue(data);
+        }
+        catch (error) {
+            // suppress errors when the stream has been closed
+        }
+    }
+    try {
+        const result = options.execute({
+            write(part) {
+                safeEnqueue(part);
+            },
+            merge(streamArg) {
+                ongoingStreamPromises.push((async () => {
+                    const reader = streamArg.getReader();
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done)
+                            break;
+                        safeEnqueue(value);
+                    }
+                })().catch((error) => {
+                    console.error(error);
+                }));
+            },
+        });
+        if (result) {
+            ongoingStreamPromises.push(result.catch((error) => {
+                console.error(error);
+            }));
+        }
+    }
+    catch (error) {
+        console.error(error);
+    }
+    const waitForStreams = new Promise((resolve, reject) => {
+        (async () => {
+            while (ongoingStreamPromises.length > 0) {
+                await ongoingStreamPromises.shift();
+            }
+            resolve();
+        })().catch(reject);
+    });
+    waitForStreams.finally(() => {
+        try {
+            controller.close();
+        }
+        catch (error) {
+            // suppress errors when the stream has been closed
+        }
+    });
+    return pipeInternal(key, stream, options, "streams.writer()");
+}
+function define(opts) {
+    return {
+        id: opts.id,
+        pipe(value, options) {
+            return pipe(opts.id, value, options);
+        },
+        read(runId, options) {
+            return read(runId, opts.id, options);
+        },
+        append(value, options) {
+            return append(opts.id, value, options);
+        },
+        writer(options) {
+            return writer(opts.id, options);
+        },
+    };
+}
+exports.streams = {
+    pipe,
+    read,
+    append,
+    writer,
+    define,
+};
+function getRunIdForOptions(options) {
+    if (options?.target) {
+        if (options.target === "parent") {
+            return v3_1.taskContext.ctx?.run?.parentTaskRunId;
+        }
+        if (options.target === "root") {
+            return v3_1.taskContext.ctx?.run?.rootTaskRunId;
+        }
+        if (options.target === "self") {
+            return v3_1.taskContext.ctx?.run?.id;
+        }
+        return options.target;
+    }
+    return v3_1.taskContext.ctx?.run?.id;
+}
+//# sourceMappingURL=streams.js.map

package/dist/commonjs/v3/streams.js.map

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

package/dist/commonjs/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = "0.0.0-prerelease-20251007140052";
+exports.VERSION = "0.0.0-prerelease-20251113143926";
 //# sourceMappingURL=version.js.map

package/dist/esm/v3/index.d.ts

@@ -16,6 +16,7 @@ export * from "./locals.js";
 export * from "./otel.js";
 export * from "./schemas.js";
 export * from "./heartbeats.js";
+export * from "./streams.js";
 export type { Context };
 import type { Context } from "./shared.js";
 import type { ApiClientConfiguration } from "@trigger.dev/core/v3";

package/dist/esm/v3/index.js

@@ -16,6 +16,7 @@ export * from "./locals.js";
 export * from "./otel.js";
 export * from "./schemas.js";
 export * from "./heartbeats.js";
+export * from "./streams.js";
 export { ApiError, AuthenticationError, BadRequestError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, UnprocessableEntityError, AbortTaskRunError, OutOfMemoryError, CompleteTaskWithOutput, logger, } from "@trigger.dev/core/v3";
 export { runs, } from "./runs.js";
 export * as schedules from "./schedules/index.js";

package/dist/esm/v3/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAShC,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,MAAM,GAEP,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,IAAI,GAQL,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAGtC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAS7B,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,MAAM,GAEP,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,IAAI,GAQL,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAGtC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/esm/v3/metadata.d.ts

@@ -188,6 +188,9 @@ declare function flushMetadata(requestOptions?: ApiRequestOptions): Promise<void
  * @returns {Promise<void>} A promise that resolves when the metadata refresh operation is complete.
  */
 declare function refreshMetadata(requestOptions?: ApiRequestOptions): Promise<void>;
+/**
+ * @deprecated Use `streams.pipe()` instead.
+ */
 declare function stream<T>(key: string, value: AsyncIterable<T> | ReadableStream<T>, signal?: AbortSignal): Promise<AsyncIterable<T>>;
 declare function fetchStream<T>(key: string, signal?: AbortSignal): Promise<AsyncIterableStream<T>>;
 export {};

package/dist/esm/v3/metadata.js

@@ -1,5 +1,6 @@
 import { mergeRequestOptions, runMetadata, } from "@trigger.dev/core/v3";
 import { tracer } from "./tracer.js";
+import { streams } from "./streams.js";
 const parentMetadataUpdater = runMetadata.parent;
 const rootMetadataUpdater = runMetadata.root;
 /**
@@ -193,8 +194,14 @@ async function refreshMetadata(requestOptions) {
     }, requestOptions);
     await runMetadata.refresh($requestOptions);
 }
+/**
+ * @deprecated Use `streams.pipe()` instead.
+ */
 async function stream(key, value, signal) {
-    return runMetadata.stream(key, value, signal);
+    const streamInstance = await streams.pipe(key, value, {
+        signal,
+    });
+    return streamInstance.stream;
 }
 async function fetchStream(key, signal) {
     return runMetadata.fetchStream(key, signal);