@langchain/core 0.1.61 → 0.1.62

package/dist/runnables/base.cjs

@@ -16,6 +16,7 @@ const root_listener_js_1 = require("../tracers/root_listener.cjs");
 const utils_js_1 = require("./utils.cjs");
 const index_js_1 = require("../singletons/index.cjs");
 const graph_js_1 = require("./graph.cjs");
+const wrappers_js_1 = require("./wrappers.cjs");
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 function _coerceToDict(value, defaultKey) {
     return value &&
@@ -448,46 +449,16 @@ class Runnable extends serializable_js_1.Serializable {
             await runnableStreamConsumePromise;
         }
     }
-    /**
-     * Generate a stream of events emitted by the internal steps of the runnable.
-     *
-     * Use to create an iterator over StreamEvents that provide real-time information
-     * about the progress of the runnable, including StreamEvents from intermediate
-     * results.
-     *
-     * A StreamEvent is a dictionary with the following schema:
-     *
-     * - `event`: string - Event names are of the format: on_[runnable_type]_(start|stream|end).
-     * - `name`: string - The name of the runnable that generated the event.
-     * - `run_id`: string - Randomly generated ID associated with the given execution of
-     *   the runnable that emitted the event. A child runnable that gets invoked as part of the execution of a
-     *   parent runnable is assigned its own unique ID.
-     * - `tags`: string[] - The tags of the runnable that generated the event.
-     * - `metadata`: Record<string, any> - The metadata of the runnable that generated the event.
-     * - `data`: Record<string, any>
-     *
-     * Below is a table that illustrates some events that might be emitted by various
-     * chains. Metadata fields have been omitted from the table for brevity.
-     * Chain definitions have been included after the table.
-     *
-     * | event                | name             | chunk                              | input                                         | output                                          |
-     * |----------------------|------------------|------------------------------------|-----------------------------------------------|-------------------------------------------------|
-     * | on_llm_start         | [model name]     |                                    | {'input': 'hello'}                            |                                                 |
-     * | on_llm_stream        | [model name]     | 'Hello' OR AIMessageChunk("hello") |                                               |                                                 |
-     * | on_llm_end           | [model name]     |                                    | 'Hello human!'                                |
-     * | on_chain_start       | format_docs      |                                    |                                               |                                                 |
-     * | on_chain_stream      | format_docs      | "hello world!, goodbye world!"     |                                               |                                                 |
-     * | on_chain_end         | format_docs      |                                    | [Document(...)]                               | "hello world!, goodbye world!"                  |
-     * | on_tool_start        | some_tool        |                                    | {"x": 1, "y": "2"}                            |                                                 |
-     * | on_tool_stream       | some_tool        |   {"x": 1, "y": "2"}               |                                               |                                                 |
-     * | on_tool_end          | some_tool        |                                    |                                               | {"x": 1, "y": "2"}                              |
-     * | on_retriever_start   | [retriever name] |                                    | {"query": "hello"}                            |                                                 |
-     * | on_retriever_chunk   | [retriever name] |  {documents: [...]}                |                                               |                                                 |
-     * | on_retriever_end     | [retriever name] |                                    | {"query": "hello"}                            | {documents: [...]}                              |
-     * | on_prompt_start      | [template_name]  |                                    | {"question": "hello"}                         |                                                 |
-     * | on_prompt_end        | [template_name]  |                                    | {"question": "hello"}                         | ChatPromptValue(messages: [SystemMessage, ...]) |
-     */
     async *streamEvents(input, options, streamOptions) {
+        if (options.encoding === "text/event-stream") {
+            const stream = await this._streamEvents(input, options, streamOptions);
+            yield* (0, wrappers_js_1.convertToHttpEventStream)(stream);
+        }
+        else {
+            yield* this._streamEvents(input, options, streamOptions);
+        }
+    }
+    async *_streamEvents(input, options, streamOptions) {
         if (options.version !== "v1") {
             throw new Error(`Only version "v1" of the events schema is currently supported.`);
         }

package/dist/runnables/base.d.ts

@@ -199,6 +199,13 @@ export declare abstract class Runnable<RunInput = any, RunOutput = any, CallOpti
     streamEvents(input: RunInput, options: Partial<CallOptions> & {
         version: "v1";
     }, streamOptions?: Omit<LogStreamCallbackHandlerInput, "autoClose">): AsyncGenerator<StreamEvent>;
+    streamEvents(input: RunInput, options: Partial<CallOptions> & {
+        version: "v1";
+        encoding: "text/event-stream";
+    }, streamOptions?: Omit<LogStreamCallbackHandlerInput, "autoClose">): AsyncGenerator<Uint8Array>;
+    _streamEvents(input: RunInput, options: Partial<CallOptions> & {
+        version: "v1";
+    }, streamOptions?: Omit<LogStreamCallbackHandlerInput, "autoClose">): AsyncGenerator<StreamEvent>;
     static isRunnable(thing: any): thing is Runnable;
     /**
      * Bind lifecycle listeners to a Runnable, returning a new Runnable.
@@ -257,6 +264,10 @@ export declare class RunnableBinding<RunInput, RunOutput, CallOptions extends Ru
     streamEvents(input: RunInput, options: Partial<CallOptions> & {
         version: "v1";
     }, streamOptions?: Omit<LogStreamCallbackHandlerInput, "autoClose">): AsyncGenerator<StreamEvent>;
+    streamEvents(input: RunInput, options: Partial<CallOptions> & {
+        version: "v1";
+        encoding: "text/event-stream";
+    }, streamOptions?: Omit<LogStreamCallbackHandlerInput, "autoClose">): AsyncGenerator<Uint8Array>;
     static isRunnableBinding(thing: any): thing is RunnableBinding<any, any, any>;
     /**
      * Bind lifecycle listeners to a Runnable, returning a new Runnable.

package/dist/runnables/base.js

@@ -10,6 +10,7 @@ import { RootListenersTracer } from "../tracers/root_listener.js";
 import { _RootEventFilter, isRunnableInterface } from "./utils.js";
 import { AsyncLocalStorageProviderSingleton } from "../singletons/index.js";
 import { Graph } from "./graph.js";
+import { convertToHttpEventStream } from "./wrappers.js";
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function _coerceToDict(value, defaultKey) {
     return value &&
@@ -441,46 +442,16 @@ export class Runnable extends Serializable {
             await runnableStreamConsumePromise;
         }
     }
-    /**
-     * Generate a stream of events emitted by the internal steps of the runnable.
-     *
-     * Use to create an iterator over StreamEvents that provide real-time information
-     * about the progress of the runnable, including StreamEvents from intermediate
-     * results.
-     *
-     * A StreamEvent is a dictionary with the following schema:
-     *
-     * - `event`: string - Event names are of the format: on_[runnable_type]_(start|stream|end).
-     * - `name`: string - The name of the runnable that generated the event.
-     * - `run_id`: string - Randomly generated ID associated with the given execution of
-     *   the runnable that emitted the event. A child runnable that gets invoked as part of the execution of a
-     *   parent runnable is assigned its own unique ID.
-     * - `tags`: string[] - The tags of the runnable that generated the event.
-     * - `metadata`: Record<string, any> - The metadata of the runnable that generated the event.
-     * - `data`: Record<string, any>
-     *
-     * Below is a table that illustrates some events that might be emitted by various
-     * chains. Metadata fields have been omitted from the table for brevity.
-     * Chain definitions have been included after the table.
-     *
-     * | event                | name             | chunk                              | input                                         | output                                          |
-     * |----------------------|------------------|------------------------------------|-----------------------------------------------|-------------------------------------------------|
-     * | on_llm_start         | [model name]     |                                    | {'input': 'hello'}                            |                                                 |
-     * | on_llm_stream        | [model name]     | 'Hello' OR AIMessageChunk("hello") |                                               |                                                 |
-     * | on_llm_end           | [model name]     |                                    | 'Hello human!'                                |
-     * | on_chain_start       | format_docs      |                                    |                                               |                                                 |
-     * | on_chain_stream      | format_docs      | "hello world!, goodbye world!"     |                                               |                                                 |
-     * | on_chain_end         | format_docs      |                                    | [Document(...)]                               | "hello world!, goodbye world!"                  |
-     * | on_tool_start        | some_tool        |                                    | {"x": 1, "y": "2"}                            |                                                 |
-     * | on_tool_stream       | some_tool        |   {"x": 1, "y": "2"}               |                                               |                                                 |
-     * | on_tool_end          | some_tool        |                                    |                                               | {"x": 1, "y": "2"}                              |
-     * | on_retriever_start   | [retriever name] |                                    | {"query": "hello"}                            |                                                 |
-     * | on_retriever_chunk   | [retriever name] |  {documents: [...]}                |                                               |                                                 |
-     * | on_retriever_end     | [retriever name] |                                    | {"query": "hello"}                            | {documents: [...]}                              |
-     * | on_prompt_start      | [template_name]  |                                    | {"question": "hello"}                         |                                                 |
-     * | on_prompt_end        | [template_name]  |                                    | {"question": "hello"}                         | ChatPromptValue(messages: [SystemMessage, ...]) |
-     */
     async *streamEvents(input, options, streamOptions) {
+        if (options.encoding === "text/event-stream") {
+            const stream = await this._streamEvents(input, options, streamOptions);
+            yield* convertToHttpEventStream(stream);
+        }
+        else {
+            yield* this._streamEvents(input, options, streamOptions);
+        }
+    }
+    async *_streamEvents(input, options, streamOptions) {
         if (options.version !== "v1") {
             throw new Error(`Only version "v1" of the events schema is currently supported.`);
         }

package/dist/runnables/remote.d.ts

@@ -30,5 +30,9 @@ export declare class RemoteRunnable<RunInput, RunOutput, CallOptions extends Run
     streamEvents(input: RunInput, options: Partial<CallOptions> & {
         version: "v1";
     }, streamOptions?: Omit<LogStreamCallbackHandlerInput, "autoClose">): AsyncGenerator<StreamEvent>;
+    streamEvents(input: RunInput, options: Partial<CallOptions> & {
+        version: "v1";
+        encoding: "text/event-stream";
+    }, streamOptions?: Omit<LogStreamCallbackHandlerInput, "autoClose">): AsyncGenerator<Uint8Array>;
 }
 export {};

package/dist/runnables/wrappers.cjs

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertToHttpEventStream = void 0;
+const stream_js_1 = require("../utils/stream.cjs");
+function convertToHttpEventStream(stream) {
+    const encoder = new TextEncoder();
+    const finalStream = new ReadableStream({
+        async start(controller) {
+            for await (const chunk of stream) {
+                controller.enqueue(encoder.encode(`event: data\ndata: ${JSON.stringify(chunk)}\n\n`));
+            }
+            controller.enqueue(encoder.encode("event: end\n\n"));
+            controller.close();
+        },
+    });
+    return stream_js_1.IterableReadableStream.fromReadableStream(finalStream);
+}
+exports.convertToHttpEventStream = convertToHttpEventStream;

package/dist/runnables/wrappers.d.ts

@@ -0,0 +1,2 @@
+import { IterableReadableStream } from "../utils/stream.js";
+export declare function convertToHttpEventStream(stream: AsyncGenerator): IterableReadableStream<Uint8Array>;

package/dist/runnables/wrappers.js

@@ -0,0 +1,14 @@
+import { IterableReadableStream } from "../utils/stream.js";
+export function convertToHttpEventStream(stream) {
+    const encoder = new TextEncoder();
+    const finalStream = new ReadableStream({
+        async start(controller) {
+            for await (const chunk of stream) {
+                controller.enqueue(encoder.encode(`event: data\ndata: ${JSON.stringify(chunk)}\n\n`));
+            }
+            controller.enqueue(encoder.encode("event: end\n\n"));
+            controller.close();
+        },
+    });
+    return IterableReadableStream.fromReadableStream(finalStream);
+}

package/dist/tracers/base.cjs

@@ -11,9 +11,9 @@ function _coerceToDict(value, defaultKey) {
 function stripNonAlphanumeric(input) {
     return input.replace(/[-:.]/g, "");
 }
-function convertToDottedOrderFormat(epoch, runId) {
-    return (stripNonAlphanumeric(`${new Date(epoch).toISOString().slice(0, -1)}000Z`) +
-        runId);
+function convertToDottedOrderFormat(epoch, runId, executionOrder) {
+    const paddedOrder = executionOrder.toFixed(0).slice(0, 3).padStart(3, "0");
+    return (stripNonAlphanumeric(`${new Date(epoch).toISOString().slice(0, -1)}${paddedOrder}Z`) + runId);
 }
 class BaseTracer extends base_js_1.BaseCallbackHandler {
     constructor(_fields) {
@@ -42,7 +42,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
         parentRun.child_runs.push(childRun);
     }
     async _startTrace(run) {
-        const currentDottedOrder = convertToDottedOrderFormat(run.start_time, run.id);
+        const currentDottedOrder = convertToDottedOrderFormat(run.start_time, run.id, run.execution_order);
         const storedRun = { ...run };
         if (storedRun.parent_run_id !== undefined) {
             const parentRun = this.runMap.get(storedRun.parent_run_id);

package/dist/tracers/base.js

@@ -8,9 +8,9 @@ function _coerceToDict(value, defaultKey) {
 function stripNonAlphanumeric(input) {
     return input.replace(/[-:.]/g, "");
 }
-function convertToDottedOrderFormat(epoch, runId) {
-    return (stripNonAlphanumeric(`${new Date(epoch).toISOString().slice(0, -1)}000Z`) +
-        runId);
+function convertToDottedOrderFormat(epoch, runId, executionOrder) {
+    const paddedOrder = executionOrder.toFixed(0).slice(0, 3).padStart(3, "0");
+    return (stripNonAlphanumeric(`${new Date(epoch).toISOString().slice(0, -1)}${paddedOrder}Z`) + runId);
 }
 export class BaseTracer extends BaseCallbackHandler {
     constructor(_fields) {
@@ -39,7 +39,7 @@ export class BaseTracer extends BaseCallbackHandler {
         parentRun.child_runs.push(childRun);
     }
     async _startTrace(run) {
-        const currentDottedOrder = convertToDottedOrderFormat(run.start_time, run.id);
+        const currentDottedOrder = convertToDottedOrderFormat(run.start_time, run.id, run.execution_order);
         const storedRun = { ...run };
         if (storedRun.parent_run_id !== undefined) {
             const parentRun = this.runMap.get(storedRun.parent_run_id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/core",
-  "version": "0.1.61",
+  "version": "0.1.62",
   "description": "Core LangChain.js abstractions and schemas",
   "type": "module",
   "engines": {