@temporalio/langsmith 1.20.0

package/lib/run-tree.js

@@ -0,0 +1,319 @@
+"use strict";
+/**
+ * Replay-safe LangSmith run construction for workflow code, plus the pure
+ * run-name builders shared by every interceptor.
+ *
+ * Inside the workflow isolate LangSmith's default `RunTree` is unsafe on two
+ * counts that {@link ReplaySafeRunTree} fixes:
+ *
+ *  1. **Non-deterministic ids.** Its default random-tailed uuid7 would mint a
+ *     fresh id on every replay, flooding the backend with duplicates.
+ *  2. **Network I/O on replay.** `postRun` / `patchRun` would re-POST runs on
+ *     every history replay.
+ *
+ * Internal: every export here is consumed only by sibling modules in this
+ * package; none is reachable through a package entry point.
+ *
+ * @module
+ * @internal
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._RootReplaySafeRunTreeFactory = exports.ReplaySafeRunTree = exports.startUpdateWithStartRunName = exports.startWorkflowUpdateRunName = exports.queryWorkflowRunName = exports.signalWithStartRunName = exports.signalExternalWorkflowRunName = exports.signalChildWorkflowRunName = exports.signalWorkflowRunName = exports.validateUpdateRunName = exports.handleUpdateRunName = exports.handleQueryRunName = exports.handleSignalRunName = exports.runCancelNexusHandlerRunName = exports.runStartNexusHandlerRunName = exports.startNexusOperationRunName = exports.startChildWorkflowRunName = exports.runActivityRunName = exports.startActivityRunName = exports.runWorkflowRunName = exports.startWorkflowRunName = exports.RUN_TYPE = void 0;
+exports.describeError = describeError;
+exports.asOutputs = asOutputs;
+exports.runHeaders = runHeaders;
+exports.emitMarkerRun = emitMarkerRun;
+exports.runTreeFromContext = runTreeFromContext;
+exports.buildRunTree = buildRunTree;
+const run_trees_1 = require("langsmith/run_trees");
+const common_1 = require("@temporalio/common");
+const workflow_1 = require("@temporalio/workflow");
+const propagation_1 = require("./propagation");
+const sinks_1 = require("./sinks");
+/** Named random stream for recorded-path run ids; isolated from the workflow's main RNG. */
+const LANGSMITH_RUN_TREE_STREAM = 'package-langsmith-tracing';
+/** LangSmith run-type constants used for Temporal-operation runs. */
+exports.RUN_TYPE = {
+    /** Workflow / child-workflow / scheduling / handler spans. */
+    CHAIN: 'chain',
+    /** Activity-body execution spans. */
+    TOOL: 'tool',
+};
+/** `StartWorkflow:<type>` — client/parent-side workflow-start marker. */
+const startWorkflowRunName = (workflowType) => `StartWorkflow:${workflowType}`;
+exports.startWorkflowRunName = startWorkflowRunName;
+/** `RunWorkflow:<type>` — the workflow-execution span (inbound). */
+const runWorkflowRunName = (workflowType) => `RunWorkflow:${workflowType}`;
+exports.runWorkflowRunName = runWorkflowRunName;
+/** `StartActivity:<name>` — workflow-side activity-schedule marker. */
+const startActivityRunName = (activityType) => `StartActivity:${activityType}`;
+exports.startActivityRunName = startActivityRunName;
+/** `RunActivity:<name>` — the activity-execution span (activity inbound). */
+const runActivityRunName = (activityType) => `RunActivity:${activityType}`;
+exports.runActivityRunName = runActivityRunName;
+/** `StartChildWorkflow:<type>` — workflow-side child-start marker. */
+const startChildWorkflowRunName = (workflowType) => `StartChildWorkflow:${workflowType}`;
+exports.startChildWorkflowRunName = startChildWorkflowRunName;
+/** `StartNexusOperation:<service>/<op>` — workflow-side Nexus-start marker. */
+const startNexusOperationRunName = (service, operation) => `StartNexusOperation:${service}/${operation}`;
+exports.startNexusOperationRunName = startNexusOperationRunName;
+/** `RunStartNexusOperationHandler:<service>/<op>` — Nexus start-handler span. */
+const runStartNexusHandlerRunName = (service, operation) => `RunStartNexusOperationHandler:${service}/${operation}`;
+exports.runStartNexusHandlerRunName = runStartNexusHandlerRunName;
+/** `RunCancelNexusOperationHandler:<service>/<op>` — Nexus cancel-handler span. */
+const runCancelNexusHandlerRunName = (service, operation) => `RunCancelNexusOperationHandler:${service}/${operation}`;
+exports.runCancelNexusHandlerRunName = runCancelNexusHandlerRunName;
+/** `HandleSignal:<name>` — inbound signal handler span. */
+const handleSignalRunName = (signalName) => `HandleSignal:${signalName}`;
+exports.handleSignalRunName = handleSignalRunName;
+/** `HandleQuery:<name>` — inbound query handler span. */
+const handleQueryRunName = (queryName) => `HandleQuery:${queryName}`;
+exports.handleQueryRunName = handleQueryRunName;
+/** `HandleUpdate:<name>` — inbound update handler span. */
+const handleUpdateRunName = (updateName) => `HandleUpdate:${updateName}`;
+exports.handleUpdateRunName = handleUpdateRunName;
+/** `ValidateUpdate:<name>` — inbound update validator span. */
+const validateUpdateRunName = (updateName) => `ValidateUpdate:${updateName}`;
+exports.validateUpdateRunName = validateUpdateRunName;
+/** `SignalWorkflow:<name>` — client/outbound signal marker. */
+const signalWorkflowRunName = (signalName) => `SignalWorkflow:${signalName}`;
+exports.signalWorkflowRunName = signalWorkflowRunName;
+/** `SignalChildWorkflow:<name>` — workflow-side signal-child marker. */
+const signalChildWorkflowRunName = (signalName) => `SignalChildWorkflow:${signalName}`;
+exports.signalChildWorkflowRunName = signalChildWorkflowRunName;
+/** `SignalExternalWorkflow:<name>` — workflow-side signal-external marker. */
+const signalExternalWorkflowRunName = (signalName) => `SignalExternalWorkflow:${signalName}`;
+exports.signalExternalWorkflowRunName = signalExternalWorkflowRunName;
+/** `SignalWithStartWorkflow:<type>` — client signal-with-start marker. */
+const signalWithStartRunName = (workflowType) => `SignalWithStartWorkflow:${workflowType}`;
+exports.signalWithStartRunName = signalWithStartRunName;
+/** `QueryWorkflow:<name>` — client query marker. */
+const queryWorkflowRunName = (queryName) => `QueryWorkflow:${queryName}`;
+exports.queryWorkflowRunName = queryWorkflowRunName;
+/** `StartWorkflowUpdate:<name>` — client update-start marker. */
+const startWorkflowUpdateRunName = (updateName) => `StartWorkflowUpdate:${updateName}`;
+exports.startWorkflowUpdateRunName = startWorkflowUpdateRunName;
+/** `StartUpdateWithStartWorkflow:<name>` — client update-with-start marker. */
+const startUpdateWithStartRunName = (updateName) => `StartUpdateWithStartWorkflow:${updateName}`;
+exports.startUpdateWithStartRunName = startUpdateWithStartRunName;
+/**
+ * True only while replaying genuine history events, when emission must be
+ * suppressed. Deliberately `isReplayingHistoryEvents`, NOT `isReplaying`: for
+ * live read-only handlers (queries, update validators) `isReplaying` is `true`
+ * but `isReplayingHistoryEvents` is `false`, so their runs still emit. Matches
+ * how the SDK gates `callDuringReplay: false` sinks.
+ */
+function isReplaying() {
+    return (0, workflow_1.workflowInfo)().unsafe.isReplayingHistoryEvents;
+}
+let cachedSinks;
+/** Lazily-resolved workflow Sink proxy (must be called inside a workflow). */
+function sinks() {
+    if (cachedSinks === undefined) {
+        cachedSinks = (0, workflow_1.proxySinks)();
+    }
+    return cachedSinks;
+}
+/**
+ * A no-op LangSmith client. {@link ReplaySafeRunTree} never lets the underlying
+ * `RunTree` perform network I/O — emission goes through the Sink — so the
+ * client it carries must do nothing and must never read env / open sockets
+ * inside the isolate.
+ */
+const NOOP_CLIENT = {
+    createRun: async () => { },
+    updateRun: async () => { },
+};
+/** Flatten a {@link RunTree} into the plain wire shape consumed by the Sink. */
+function serializeRun(run) {
+    const extra = run.extra ? { ...run.extra } : undefined;
+    if (extra && extra.metadata && typeof extra.metadata === 'object') {
+        extra.metadata = (0, propagation_1.scrubSensitive)(extra.metadata);
+    }
+    return {
+        id: run.id,
+        trace_id: run.trace_id,
+        dotted_order: run.dotted_order,
+        parent_run_id: run.parent_run_id,
+        name: run.name,
+        run_type: run.run_type,
+        start_time: run.start_time,
+        end_time: run.end_time,
+        inputs: run.inputs,
+        outputs: run.outputs,
+        error: run.error,
+        extra,
+        tags: run.tags,
+        project_name: run.project_name,
+        events: run.events,
+    };
+}
+/**
+ * Render an error into the LangSmith `error` string, honoring Temporal's
+ * benign-failure category.
+ *
+ * A `BENIGN`-category `ApplicationFailure` is an expected, non-alarming outcome
+ * (e.g. a control-flow signal), so it leaves the run's `error` unset. All other
+ * failures produce `"<type>: <message>"`.
+ */
+function describeError(err) {
+    if (err instanceof common_1.ApplicationFailure) {
+        if (err.category === common_1.ApplicationFailureCategory.BENIGN) {
+            return undefined;
+        }
+        return `${err.type ?? 'ApplicationError'}: ${err.message}`;
+    }
+    if (err instanceof Error) {
+        return `${err.name}: ${err.message}`;
+    }
+    return String(err);
+}
+/** Coerce an arbitrary operation result into a LangSmith outputs object. */
+function asOutputs(result) {
+    if (result !== null && typeof result === 'object' && !Array.isArray(result)) {
+        return result;
+    }
+    return { result };
+}
+/** The trace context to propagate for `run`, or `undefined` when absent. */
+function runHeaders(run) {
+    return run ? run.toHeaders() : undefined;
+}
+/** Emit a short-lived marker run. */
+async function emitMarkerRun(marker) {
+    await marker.postRun();
+    await marker.end({});
+    await marker.patchRun();
+}
+/** Reconstruct a propagated parent {@link RunTree} from a trace context; never throws. */
+function runTreeFromContext(ctx) {
+    if (!ctx) {
+        return undefined;
+    }
+    try {
+        return run_trees_1.RunTree.fromHeaders(ctx) ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Build an emitter-side {@link RunTree} (client / activity / Nexus); force-enables
+ * tracing so nested body `traceable` runs emit — tracing gate is `isTracingEnabled()`.
+ */
+function buildRunTree(config, params) {
+    return new run_trees_1.RunTree({
+        name: params.name,
+        run_type: params.runType,
+        inputs: params.inputs ?? {},
+        parent_run: params.parent,
+        client: config.client,
+        project_name: config.projectName ?? params.parent?.project_name,
+        tags: config.tags,
+        extra: { metadata: (0, propagation_1.scrubSensitive)(config.metadata) ?? {} },
+        tracingEnabled: true,
+    });
+}
+/**
+ * A {@link RunTree} subclass safe to construct and drive from workflow code.
+ *
+ * Subclasses rather than wraps because LangSmith's `traceable` resolves its
+ * parent with `instanceof RunTree` before calling `parent.createChild(...)`, so
+ * a plain wrapper would refuse to nest under it.
+ *
+ * @internal
+ */
+class ReplaySafeRunTree extends run_trees_1.RunTree {
+    // Per-invocation run-id factory. Supplied by read-only handlers (queries, update
+    // validators) so their ids don't draw from the Workflow main PRNG; left
+    // undefined on recorded paths, where id minting falls back to the isolated
+    // LANGSMITH_RUN_TREE_STREAM named stream. Propagated to every child so the whole
+    // subtree mints from one factory.
+    generateNewUuid4;
+    constructor(config, generateNewUuid4) {
+        super(ReplaySafeRunTree.fill(config, generateNewUuid4));
+        this.generateNewUuid4 = generateNewUuid4;
+    }
+    static fill(config, generateNewUuid4) {
+        const id = config.id ?? (generateNewUuid4 ? generateNewUuid4() : (0, workflow_1.getRandomStream)(LANGSMITH_RUN_TREE_STREAM).uuid4());
+        const start_time = config.start_time ?? Date.now();
+        const trace_id = config.trace_id ?? config.parent_run?.trace_id ?? id;
+        let dotted_order = config.dotted_order;
+        if (dotted_order == null) {
+            const startMs = typeof start_time === 'number' ? start_time : Date.parse(String(start_time));
+            const { dottedOrder } = (0, run_trees_1.convertToDottedOrderFormat)(startMs, id);
+            const parentDotted = config.parent_run?.dotted_order;
+            dotted_order = parentDotted ? `${parentDotted}.${dottedOrder}` : dottedOrder;
+        }
+        return {
+            ...config,
+            id,
+            start_time,
+            trace_id,
+            dotted_order,
+            parent_run_id: config.parent_run_id ?? config.parent_run?.id,
+            client: NOOP_CLIENT,
+            tracingEnabled: config.tracingEnabled ?? true,
+        };
+    }
+    /** Produce a replay-safe child so deeply-nested `traceable` runs stay deterministic. */
+    createChild(config) {
+        const child = new ReplaySafeRunTree({
+            ...config,
+            run_type: config.run_type ?? exports.RUN_TYPE.CHAIN,
+            parent_run: this,
+            parent_run_id: this.id,
+            trace_id: this.trace_id,
+            project_name: config.project_name ?? this.project_name,
+        }, this.generateNewUuid4);
+        this.child_runs.push(child);
+        return child;
+    }
+    /** Emit a `createRun` via the Sink, unless replaying. */
+    async postRun() {
+        if (isReplaying()) {
+            return;
+        }
+        sinks()[sinks_1.LANGSMITH_SINK_NAME].createRun(serializeRun(this));
+    }
+    /** Record outputs/end-time locally then emit an `updateRun` via the Sink, unless replaying. */
+    async patchRun() {
+        if (isReplaying()) {
+            return;
+        }
+        sinks()[sinks_1.LANGSMITH_SINK_NAME].updateRun(serializeRun(this));
+    }
+    /** Record end-time / outputs / error on the run object (pure, replay-safe). */
+    async end(outputs, error, endTime) {
+        if (outputs !== undefined) {
+            this.outputs = outputs;
+        }
+        if (error !== undefined) {
+            this.error = error;
+        }
+        this.end_time = endTime ?? Date.now();
+    }
+}
+exports.ReplaySafeRunTree = ReplaySafeRunTree;
+/**
+ * A placeholder, never-emitted parent whose {@link createChild} produces
+ * independent root children. Installed as the ambient so a workflow-body
+ * `traceable` takes LangSmith's `createChild` branch (deterministic id) instead
+ * of the no-parent branch that mints a uuid via `crypto`, which the isolate lacks.
+ *
+ * @internal
+ */
+class _RootReplaySafeRunTreeFactory extends ReplaySafeRunTree {
+    /** Produce a replay-safe child with no link back to this factory. */
+    createChild(config) {
+        return new ReplaySafeRunTree({
+            ...config,
+            run_type: config.run_type ?? exports.RUN_TYPE.CHAIN,
+            project_name: config.project_name ?? this.project_name,
+        }, this.generateNewUuid4);
+    }
+    async postRun() { }
+    async patchRun() { }
+}
+exports._RootReplaySafeRunTreeFactory = _RootReplaySafeRunTreeFactory;
+//# sourceMappingURL=run-tree.js.map

package/lib/run-tree.js.map

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

package/lib/sinks.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Worker-side LangSmith emission, exposed as a Temporal {@link InjectedSinks}.
+ *
+ * @module
+ */
+import { type Client } from 'langsmith';
+import type { Sinks } from '@temporalio/workflow';
+import type { InjectedSinks } from '@temporalio/worker';
+/** Plain-JSON description of a LangSmith run crossing the isolate→worker boundary. */
+export interface SerializedRun {
+    id: string;
+    trace_id: string;
+    dotted_order: string;
+    parent_run_id?: string;
+    name: string;
+    run_type: string;
+    start_time: number;
+    /** End time (epoch ms); present only on the update record. */
+    end_time?: number;
+    inputs?: Record<string, unknown>;
+    outputs?: Record<string, unknown>;
+    /** Error string; non-null marks the run errored. */
+    error?: string;
+    extra?: Record<string, unknown>;
+    tags?: string[];
+    project_name?: string;
+    events?: Record<string, unknown>[];
+}
+/** Runtime configuration shared by the client and activity interceptors. */
+export interface EmitterConfig {
+    /** The LangSmith client runs are emitted to. */
+    client: Client;
+    /** When false, no Temporal-operation runs are emitted (propagation only). */
+    addTemporalRuns: boolean;
+    /** Target LangSmith project. */
+    projectName?: string;
+    /** Tags attached to every emitted run. */
+    tags?: string[];
+    /** Metadata merged into every emitted run. */
+    metadata?: Record<string, unknown>;
+}
+/** The injected sink's wire name. Reserved-prefixed; allowlisted in `@temporalio/common`. */
+export declare const LANGSMITH_SINK_NAME: "__temporal_langsmith";
+/** The Temporal sink surface this plugin injects. */
+export interface LangSmithSinks extends Sinks {
+    [LANGSMITH_SINK_NAME]: {
+        /** Emit a `createRun` for a newly started run. */
+        createRun(run: SerializedRun): void;
+        /** Emit an `updateRun` (end / outputs / error / events) for a run. */
+        updateRun(run: SerializedRun): void;
+    };
+}
+/** Build the worker-side {@link InjectedSinks} routing serialized runs to a real LangSmith client. */
+export declare function createLangSmithSinks(client: Client): InjectedSinks<LangSmithSinks>;

package/lib/sinks.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Worker-side LangSmith emission, exposed as a Temporal {@link InjectedSinks}.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LANGSMITH_SINK_NAME = void 0;
+exports.createLangSmithSinks = createLangSmithSinks;
+const langsmith_1 = require("langsmith");
+/** The injected sink's wire name. Reserved-prefixed; allowlisted in `@temporalio/common`. */
+exports.LANGSMITH_SINK_NAME = '__temporal_langsmith';
+// langsmith's CreateRunParams omits tags, but createRun spreads them into the request at runtime.
+function toCreateParams(run) {
+    return {
+        id: run.id,
+        trace_id: run.trace_id,
+        dotted_order: run.dotted_order,
+        parent_run_id: run.parent_run_id,
+        name: run.name,
+        run_type: run.run_type,
+        start_time: run.start_time,
+        inputs: run.inputs ?? {},
+        extra: run.extra,
+        tags: run.tags,
+        project_name: run.project_name,
+    };
+}
+function toUpdateParams(run) {
+    return {
+        end_time: run.end_time,
+        outputs: run.outputs,
+        error: run.error,
+        extra: run.extra,
+        tags: run.tags,
+        events: run.events,
+        dotted_order: run.dotted_order,
+        trace_id: run.trace_id,
+        parent_run_id: run.parent_run_id,
+    };
+}
+/** Build the worker-side {@link InjectedSinks} routing serialized runs to a real LangSmith client. */
+function createLangSmithSinks(client) {
+    return {
+        [exports.LANGSMITH_SINK_NAME]: {
+            createRun: {
+                fn: (_info, run) => {
+                    // Honor the LangSmith tracing gate at the real-env emission point.
+                    if (!(0, langsmith_1.isTracingEnabled)()) {
+                        return;
+                    }
+                    void Promise.resolve(client.createRun(toCreateParams(run))).catch(() => {
+                        /* swallow: emission must never fail the workflow */
+                    });
+                },
+                callDuringReplay: false,
+            },
+            updateRun: {
+                fn: (_info, run) => {
+                    if (!(0, langsmith_1.isTracingEnabled)()) {
+                        return;
+                    }
+                    void Promise.resolve(client.updateRun(run.id, toUpdateParams(run))).catch(() => {
+                        /* swallow: emission must never fail the workflow */
+                    });
+                },
+                callDuringReplay: false,
+            },
+        },
+    };
+}
+//# sourceMappingURL=sinks.js.map

package/lib/sinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sinks.js","sourceRoot":"","sources":["../src/sinks.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAsFH,oDA4BC;AAhHD,yCAA0D;AAuC1D,6FAA6F;AAChF,QAAA,mBAAmB,GAAG,sBAA+B,CAAC;AAYnE,kGAAkG;AAClG,SAAS,cAAc,CAAC,GAAkB;IACxC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE;QACxB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,YAAY,EAAE,GAAG,CAAC,YAAY;KAC/B,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,GAAkB;IACxC,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,aAAa,EAAE,GAAG,CAAC,aAAa;KACjC,CAAC;AACJ,CAAC;AAED,sGAAsG;AACtG,SAAgB,oBAAoB,CAAC,MAAc;IACjD,OAAO;QACL,CAAC,2BAAmB,CAAC,EAAE;YACrB,SAAS,EAAE;gBACT,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;oBACjB,mEAAmE;oBACnE,IAAI,CAAC,IAAA,4BAAgB,GAAE,EAAE,CAAC;wBACxB,OAAO;oBACT,CAAC;oBACD,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;wBACrE,oDAAoD;oBACtD,CAAC,CAAC,CAAC;gBACL,CAAC;gBACD,gBAAgB,EAAE,KAAK;aACxB;YACD,SAAS,EAAE;gBACT,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;oBACjB,IAAI,CAAC,IAAA,4BAAgB,GAAE,EAAE,CAAC;wBACxB,OAAO;oBACT,CAAC;oBACD,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;wBAC7E,oDAAoD;oBACtD,CAAC,CAAC,CAAC;gBACL,CAAC;gBACD,gBAAgB,EAAE,KAAK;aACxB;SACF;KACF,CAAC;AACJ,CAAC"}

package/lib/workflow-interceptors.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Workflow-isolate interceptors and the deterministic LangSmith context
+ * provider. Loaded into the workflow bundle (via the plugin's `workflowModules`)
+ * and runs entirely inside the V8 isolate, where `node:async_hooks` is
+ * unavailable so a synchronous stack-based context provider stands in for
+ * LangSmith's async-context store.
+ *
+ * Internal: the worker loads this module by specifier and the bundler aliases
+ * `node:async_hooks` to it — it is not a hand-import API.
+ *
+ * @module
+ * @internal
+ */
+export {};