@temporalio/langsmith 1.23.0 → 2.0.0-rc.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/plugin.js CHANGED
@@ -21,15 +21,32 @@
21
21
  */
22
22
  Object.defineProperty(exports, "__esModule", { value: true });
23
23
  exports.LangSmithPlugin = void 0;
24
+ exports.envDestination = envDestination;
24
25
  const langsmith_1 = require("langsmith");
26
+ const run_trees_1 = require("langsmith/run_trees");
25
27
  const plugin_1 = require("@temporalio/plugin");
28
+ const worker_1 = require("@temporalio/worker");
26
29
  const activity_interceptor_1 = require("./activity-interceptor");
27
30
  const client_interceptor_1 = require("./client-interceptor");
28
31
  const sinks_1 = require("./sinks");
32
+ const run_tree_1 = require("./run-tree");
33
+ const worker_run_tree_1 = require("./worker-run-tree");
34
+ const workflow_run_tree_1 = require("./workflow-run-tree");
35
+ const routing_1 = require("./routing");
29
36
  // Bare identifier (not dotted) so DefinePlugin substitutes textually.
30
37
  const CONFIG_GLOBAL = '__TEMPORAL_LANGSMITH_CONFIG__';
31
38
  // Bare builtin name added to `ignoreModules`; see {@link bundleRewritesPlugin}.
32
39
  const ASYNC_HOOKS_MODULE = 'async_hooks';
40
+ /** Reads this package's version, which worker heartbeats report. Empty if it can't be read. */
41
+ function packageVersion() {
42
+ try {
43
+ // eslint-disable-next-line @typescript-eslint/no-require-imports
44
+ return require('../package.json').version ?? '';
45
+ }
46
+ catch {
47
+ return '';
48
+ }
49
+ }
33
50
  /**
34
51
  * Temporal plugin that adds LangSmith observability to a Client + Worker.
35
52
  *
@@ -41,13 +58,14 @@ const ASYNC_HOOKS_MODULE = 'async_hooks';
41
58
  * const plugin = new LangSmithPlugin({ addTemporalRuns: true });
42
59
  * const worker = await Worker.create({ workflowsPath, taskQueue: 'tq', plugins: [plugin] });
43
60
  * ```
44
- *
45
- * @experimental Plugins is an experimental feature; APIs may change without notice.
46
61
  */
47
62
  class LangSmithPlugin extends plugin_1.SimplePlugin {
63
+ /** The package version, reported in worker heartbeats. */
64
+ version = packageVersion();
48
65
  client;
49
66
  emitter;
50
67
  workflowConfig;
68
+ drains = [];
51
69
  // Absolute paths so the workflow bundler resolves them under strict pnpm.
52
70
  workflowInterceptorModule = require.resolve('./workflow-interceptors');
53
71
  // Target of the `node:async_hooks` rewrite; re-exports the runtime-injected ALS.
@@ -55,18 +73,36 @@ class LangSmithPlugin extends plugin_1.SimplePlugin {
55
73
  constructor(options = {}) {
56
74
  // super() reads options.name immediately
57
75
  super({ name: 'langchain.LangSmithPlugin' });
76
+ if (options.projectName !== undefined && options.address !== undefined) {
77
+ throw new TypeError('projectName and address are mutually exclusive');
78
+ }
58
79
  this.client = options.client ?? new langsmith_1.Client();
80
+ const defaults = new run_trees_1.RunTree({
81
+ name: 'temporal-routing-defaults',
82
+ client: this.client,
83
+ project_name: options.projectName,
84
+ address: options.address,
85
+ });
86
+ // Let LangSmith validate and normalize its own address objects.
87
+ const address = options.address === undefined ? undefined : defaults.address;
88
+ const replicas = defaults.replicas;
59
89
  const addTemporalRuns = options.addTemporalRuns ?? false;
60
90
  this.emitter = {
61
91
  client: this.client,
62
92
  addTemporalRuns,
63
- projectName: options.projectName,
93
+ // LangSmith treats an empty project name as unset, so the plugin does too.
94
+ projectName: options.projectName || undefined,
95
+ address,
96
+ replicas,
64
97
  tags: options.tags,
65
98
  metadata: options.metadata,
66
99
  };
67
100
  this.workflowConfig = {
68
101
  addTemporalRuns,
69
- projectName: options.projectName,
102
+ // Resolved here, where LangSmith can read env; inside the isolate it can only fall back to `"default"`.
103
+ destination: pluginDestination(this.client, address, this.emitter.projectName),
104
+ tracingEnabled: (0, langsmith_1.isTracingEnabled)(),
105
+ replicas: (0, routing_1.replicaRouting)(replicas),
70
106
  tags: options.tags,
71
107
  metadata: options.metadata,
72
108
  };
@@ -85,9 +121,10 @@ class LangSmithPlugin extends plugin_1.SimplePlugin {
85
121
  return this.withLangSmithWorker(super.configureReplayWorker(options));
86
122
  }
87
123
  withLangSmithWorker(options) {
124
+ (0, run_tree_1.requireRunTreeMembers)(workflow_run_tree_1.WORKFLOW_RUN_TREE_OVERRIDES, worker_run_tree_1.WORKER_RUN_TREE_OVERRIDES);
88
125
  const interceptors = options.interceptors ?? {};
89
- const activityInbound = [...(interceptors.activityInbound ?? [])];
90
- activityInbound.push((0, activity_interceptor_1.createActivityInboundInterceptor)(this.emitter));
126
+ const activity = [...(interceptors.activity ?? [])];
127
+ activity.push((ctx) => ({ inbound: (0, activity_interceptor_1.createActivityInboundInterceptor)(this.emitter)(ctx) }));
91
128
  const workflowModules = [...(interceptors.workflowModules ?? [])];
92
129
  if (!workflowModules.includes(this.workflowInterceptorModule)) {
93
130
  workflowModules.push(this.workflowInterceptorModule);
@@ -95,11 +132,18 @@ class LangSmithPlugin extends plugin_1.SimplePlugin {
95
132
  const nexusInbound = (0, activity_interceptor_1.createNexusInboundInterceptor)(this.emitter);
96
133
  const nexusInterceptors = [...(interceptors.nexus ?? [])];
97
134
  nexusInterceptors.push((_ctx) => ({ inbound: nexusInbound }));
135
+ const logger = worker_1.Runtime.instance().logger;
136
+ if (this.workflowConfig.destination === undefined) {
137
+ logger.warn("LangSmith can't name a destination from the environment, so the Temporal plugin traces nothing that starts " +
138
+ 'without a parent run.');
139
+ }
140
+ const { sinks: langsmithSinks, drain } = (0, sinks_1.createLangSmithSinks)(this.client, this.emitter.replicas, logger);
141
+ this.drains.push(drain);
98
142
  // The user's own Worker sinks take precedence on any key collision.
99
- const sinks = { ...(0, sinks_1.createLangSmithSinks)(this.client), ...(options.sinks ?? {}) };
143
+ const sinks = { ...langsmithSinks, ...(options.sinks ?? {}) };
100
144
  return {
101
145
  ...options,
102
- interceptors: { ...interceptors, activityInbound, workflowModules, nexus: nexusInterceptors },
146
+ interceptors: { ...interceptors, activity, workflowModules, nexus: nexusInterceptors },
103
147
  sinks,
104
148
  };
105
149
  }
@@ -140,6 +184,8 @@ class LangSmithPlugin extends plugin_1.SimplePlugin {
140
184
  }
141
185
  async flush() {
142
186
  try {
187
+ // Sink writes reach the client one at a time, so hand them all over before flushing it.
188
+ await Promise.all(this.drains.map((drain) => drain()));
143
189
  await this.client.awaitPendingTraceBatches();
144
190
  }
145
191
  catch {
@@ -148,9 +194,36 @@ class LangSmithPlugin extends plugin_1.SimplePlugin {
148
194
  }
149
195
  }
150
196
  exports.LangSmithPlugin = LangSmithPlugin;
197
+ /** The plugin's explicit `address` or `projectName`, else the destination the env names. */
198
+ function pluginDestination(client, address, projectName) {
199
+ if (address !== undefined) {
200
+ return { address };
201
+ }
202
+ if (projectName !== undefined) {
203
+ return { project_name: projectName };
204
+ }
205
+ return envDestination(client);
206
+ }
207
+ /**
208
+ * The destination LangSmith's env defaults (`LANGSMITH_PROJECT`, `LANGSMITH_AGENT_ID` and
209
+ * `LANGSMITH_AGENT_ENVIRONMENT`) name, as LangSmith's own `RunTree` constructor resolves it for a run that names none;
210
+ * `undefined` when the env can't address a run. The probe run is never posted.
211
+ *
212
+ * @internal
213
+ */
214
+ function envDestination(client) {
215
+ // `tracingEnabled: false` stops LangSmith warning here about an env it can't use; its `Client` already warned once.
216
+ const probe = new run_trees_1.RunTree({ name: 'temporal-langsmith-destination-probe', client, tracingEnabled: false });
217
+ if (probe.project_name) {
218
+ return { project_name: probe.project_name };
219
+ }
220
+ return probe.address ? { address: probe.address } : undefined;
221
+ }
151
222
  /**
152
- * A webpack plugin that installs the three Workflow-bundle rewrites LangSmith needs:
223
+ * A webpack plugin that installs the four Workflow-bundle rewrites LangSmith needs:
153
224
  *
225
+ * - resolve `langsmith` and `langsmith/*` to the CommonJS build this plugin
226
+ * patches, so ESM Workflow code doesn't load a second, unpatched copy.
154
227
  * - redirect `node:async_hooks` to the shim module that re-exports the
155
228
  * runtime-injected `AsyncLocalStorage`, so LangSmith's `new AsyncLocalStorage()`
156
229
  * and `AsyncLocalStorage.snapshot()` resolve to the real SDK-provided ALS.
@@ -176,6 +249,9 @@ function bundleRewritesPlugin(asyncHooksShimModule, definitions) {
176
249
  return {
177
250
  apply(compiler) {
178
251
  const { NormalModuleReplacementPlugin, DefinePlugin } = compiler.webpack;
252
+ new NormalModuleReplacementPlugin(/^langsmith(?:\/|$)/, (resource) => {
253
+ resource.request = require.resolve(resource.request);
254
+ }).apply(compiler);
179
255
  new NormalModuleReplacementPlugin(/^node:async_hooks$/, (resource) => {
180
256
  resource.request = asyncHooksShimModule;
181
257
  }).apply(compiler);
package/lib/plugin.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}
@@ -33,7 +33,7 @@ const common_1 = require("@temporalio/common");
33
33
  * Must byte-match the Python plugin's key so trace context propagates across SDKs.
34
34
  */
35
35
  exports.HEADER_KEY = '_temporal-langsmith-context';
36
- /** Case-insensitive key prefixes scrubbed from runs and propagated headers. */
36
+ /** Case-insensitive key prefixes scrubbed from propagated replica settings. */
37
37
  const SENSITIVE_KEY_PREFIXES = [
38
38
  'auth',
39
39
  'api_key',
@@ -0,0 +1,14 @@
1
+ /** Destination and credential-free replica routing shared across Temporal boundaries. */
2
+ import type { RunTreeConfig, WriteReplica } from 'langsmith/run_trees';
3
+ type Destination = Pick<RunTreeConfig, 'project_name' | 'address'>;
4
+ export type ReplicaRouting = Pick<WriteReplica, 'projectName' | 'address' | 'primary' | 'updates' | 'reroot'>;
5
+ /** Select one destination, clearing the other mode when inheriting an address. */
6
+ export declare function destination(preferred?: Destination, fallback?: Destination): Destination;
7
+ /** Follow LangSmith's header allowlist; clients, credentials and ingestion URLs stay local. */
8
+ export declare function replicaRouting(replicas: readonly WriteReplica[] | undefined): ReplicaRouting[] | undefined;
9
+ /** The Temporal wire format uses Python's spelling; accept native JS headers too. */
10
+ export declare function replicaHeaders(replicas: readonly WriteReplica[]): unknown[];
11
+ export declare function normalizeReplicaHeaders(baggage: string): string;
12
+ /** Restore a destination's credentials from the receiving process's own configuration. */
13
+ export declare function bindReplicaCredentials(replicas: readonly ReplicaRouting[] | undefined, localReplicas: readonly WriteReplica[] | undefined): WriteReplica[] | undefined;
14
+ export {};
package/lib/routing.js ADDED
@@ -0,0 +1,101 @@
1
+ "use strict";
2
+ /** Destination and credential-free replica routing shared across Temporal boundaries. */
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.destination = destination;
5
+ exports.replicaRouting = replicaRouting;
6
+ exports.replicaHeaders = replicaHeaders;
7
+ exports.normalizeReplicaHeaders = normalizeReplicaHeaders;
8
+ exports.bindReplicaCredentials = bindReplicaCredentials;
9
+ const langsmith_1 = require("langsmith");
10
+ const propagation_1 = require("./propagation");
11
+ const SAFE_UPDATE_FIELDS = new Set(['tags', 'metadata', 'extra', 'reroot']);
12
+ /** Select one destination, clearing the other mode when inheriting an address. */
13
+ function destination(preferred, fallback) {
14
+ const selected = preferred?.address || preferred?.project_name ? preferred : fallback;
15
+ return {
16
+ project_name: selected?.address ? undefined : selected?.project_name,
17
+ address: selected?.address,
18
+ };
19
+ }
20
+ function safeUpdates(value) {
21
+ if (value === null || typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
22
+ return value;
23
+ }
24
+ if (Array.isArray(value))
25
+ return value.map(safeUpdates);
26
+ if (value && typeof value === 'object' && Object.getPrototypeOf(value) === Object.prototype) {
27
+ return Object.fromEntries(Object.entries((0, propagation_1.scrubSensitive)(value) ?? {})
28
+ .filter(([key]) => !['client', 'apiUrl', 'workspaceId'].includes(key))
29
+ .map(([key, item]) => [key, safeUpdates(item)])
30
+ .filter(([, item]) => item !== undefined));
31
+ }
32
+ return undefined;
33
+ }
34
+ function replicaFields(replica) {
35
+ return {
36
+ ...(typeof replica.projectName === 'string' ? { projectName: replica.projectName } : {}),
37
+ ...(typeof replica.primary === 'boolean' ? { primary: replica.primary } : {}),
38
+ ...(typeof replica.reroot === 'boolean' ? { reroot: replica.reroot } : {}),
39
+ ...(replica.updates ? {
40
+ updates: safeUpdates(Object.fromEntries(Object.entries(replica.updates).filter(([key]) => SAFE_UPDATE_FIELDS.has(key)))),
41
+ } : {}),
42
+ };
43
+ }
44
+ /** Follow LangSmith's header allowlist; clients, credentials and ingestion URLs stay local. */
45
+ function replicaRouting(replicas) {
46
+ return replicas?.map((replica) => ({
47
+ ...replicaFields(replica),
48
+ ...(replica.address ? { address: { ...new langsmith_1.AgentAddress(replica.address.id, replica.address.environment) } } : {}),
49
+ }));
50
+ }
51
+ /** The Temporal wire format uses Python's spelling; accept native JS headers too. */
52
+ function replicaHeaders(replicas) {
53
+ return replicaRouting(replicas).map(({ projectName, address, ...replica }) => ({
54
+ ...replica,
55
+ ...(projectName === undefined ? {} : { project_name: projectName }),
56
+ // LangSmith and Python use LRN strings on the wire, including older histories.
57
+ ...(address ? { address: `lrn:agents/${address.id}/environments/${address.environment.toLowerCase()}` } : {}),
58
+ }));
59
+ }
60
+ function normalizeReplicaHeaders(baggage) {
61
+ return baggage.split(',').map((item) => {
62
+ const prefix = 'langsmith-replicas=';
63
+ if (!item.startsWith(prefix))
64
+ return item;
65
+ const replicas = JSON.parse(decodeURIComponent(item.slice(prefix.length)));
66
+ if (!Array.isArray(replicas))
67
+ throw new TypeError('replica routing must be an array');
68
+ const normalized = replicas.map((replica) => {
69
+ if (Array.isArray(replica))
70
+ return { projectName: replica[0], updates: replica[1] };
71
+ if (!replica || typeof replica !== 'object')
72
+ throw new TypeError('replica routing must be an object');
73
+ const record = replica;
74
+ return { ...record, projectName: record.project_name ?? record.projectName };
75
+ });
76
+ // Leave wire addresses for RunTree.fromHeaders to parse and validate.
77
+ const sanitized = normalized.map((replica) => ({
78
+ ...replicaFields(replica),
79
+ ...(replica.address === undefined ? {} : { address: replica.address }),
80
+ }));
81
+ return `${prefix}${encodeURIComponent(JSON.stringify(sanitized))}`;
82
+ }).join(',');
83
+ }
84
+ /** Restore a destination's credentials from the receiving process's own configuration. */
85
+ function bindReplicaCredentials(replicas, localReplicas) {
86
+ if (replicas === undefined)
87
+ return localReplicas ? [...localReplicas] : undefined;
88
+ return replicas.map((replica) => {
89
+ const local = localReplicas?.find((candidate) => candidate.projectName === replica.projectName &&
90
+ candidate.address?.kind === replica.address?.kind && candidate.address?.id === replica.address?.id &&
91
+ candidate.address?.environment === replica.address?.environment);
92
+ return {
93
+ ...replica,
94
+ apiKey: local?.apiKey,
95
+ apiUrl: local?.apiUrl,
96
+ workspaceId: local?.workspaceId,
97
+ client: local?.client,
98
+ };
99
+ });
100
+ }
101
+ //# sourceMappingURL=routing.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"routing.js","sourceRoot":"","sources":["../src/routing.ts"],"names":[],"mappings":";AAAA,yFAAyF;;AAazF,kCAMC;AAgCD,wCAKC;AAGD,wCAOC;AAED,0DAmBC;AAGD,wDAmBC;AA3GD,yCAAyC;AAEzC,+CAA+C;AAM/C,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE5E,kFAAkF;AAClF,SAAgB,WAAW,CAAC,SAAuB,EAAE,QAAsB;IACzE,MAAM,QAAQ,GAAG,SAAS,EAAE,OAAO,IAAI,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;IACtF,OAAO;QACL,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,YAAY;QACpE,OAAO,EAAE,QAAQ,EAAE,OAAO;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC3G,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACxD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QAC5F,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,IAAA,4BAAc,EAAC,KAAgC,CAAC,IAAI,EAAE,CAAC;aACnE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;aACrE,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;aAC9C,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAC5C,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,aAAa,CAAC,OAAqB;IAC1C,OAAO;QACL,GAAG,CAAC,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,GAAG,CAAC,OAAO,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,GAAG,CAAC,OAAO,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;YACpB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,WAAW,CACrC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAC/E,CAA4B;SAC9B,CAAC,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,+FAA+F;AAC/F,SAAgB,cAAc,CAAC,QAA6C;IAC1E,OAAO,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjC,GAAG,aAAa,CAAC,OAAO,CAAC;QACzB,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,IAAI,wBAAY,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClH,CAAC,CAAC,CAAC;AACN,CAAC;AAED,qFAAqF;AACrF,SAAgB,cAAc,CAAC,QAAiC;IAC9D,OAAO,cAAc,CAAC,QAAQ,CAAE,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9E,GAAG,OAAO;QACV,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;QACnE,+EAA+E;QAC/E,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,OAAO,CAAC,EAAE,iBAAiB,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9G,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAgB,uBAAuB,CAAC,OAAe;IACrD,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,qBAAqB,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,MAAM,QAAQ,GAAY,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACpF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAC;QACtF,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAgB,EAAE,EAAE;YACnD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;gBAAE,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAkB,CAAC;YACpG,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;gBAAE,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;YACtG,MAAM,MAAM,GAAG,OAAkC,CAAC;YAClD,OAAO,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,WAAW,EAAkB,CAAC;QAC/F,CAAC,CAAC,CAAC;QACH,sEAAsE;QACtE,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC7C,GAAG,aAAa,CAAC,OAAO,CAAC;YACzB,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;SACvE,CAAC,CAAC,CAAC;QACJ,OAAO,GAAG,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;IACrE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,0FAA0F;AAC1F,SAAgB,sBAAsB,CACpC,QAA+C,EAC/C,aAAkD;IAElD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,aAAa,EAAE,IAAI,CAC/B,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,KAAK,OAAO,CAAC,WAAW;YAC1D,SAAS,CAAC,OAAO,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,IAAI,IAAI,SAAS,CAAC,OAAO,EAAE,EAAE,KAAK,OAAO,CAAC,OAAO,EAAE,EAAE;YAClG,SAAS,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,EAAE,WAAW,CAClE,CAAC;QACF,OAAO;YACL,GAAG,OAAO;YACV,MAAM,EAAE,KAAK,EAAE,MAAM;YACrB,MAAM,EAAE,KAAK,EAAE,MAAM;YACrB,WAAW,EAAE,KAAK,EAAE,WAAW;YAC/B,MAAM,EAAE,KAAK,EAAE,MAAM;SACtB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}
package/lib/run-tree.d.ts CHANGED
@@ -3,7 +3,7 @@
3
3
  * run-name builders shared by every interceptor.
4
4
  *
5
5
  * Inside the workflow isolate LangSmith's default `RunTree` is unsafe on two
6
- * counts that {@link ReplaySafeRunTree} fixes:
6
+ * counts that the workflow lifecycle overrides fix:
7
7
  *
8
8
  * 1. **Non-deterministic ids.** Its default random-tailed uuid7 would mint a
9
9
  * fresh id on every replay, flooding the backend with duplicates.
@@ -16,8 +16,9 @@
16
16
  * @module
17
17
  * @internal
18
18
  */
19
- import { type LangSmithTraceContext } from './propagation';
20
- import { type EmitterConfig } from './sinks';
19
+ import { RunTree, type RunTreeConfig } from 'langsmith/run_trees';
20
+ import type { LangSmithTraceContext } from './propagation';
21
+ import type { EmitterConfig, SerializedRun } from './sinks';
21
22
  /** LangSmith run-type constants used for Temporal-operation runs. */
22
23
  export declare const RUN_TYPE: {
23
24
  /** Workflow / child-workflow / scheduling / handler spans. */
@@ -61,8 +62,23 @@ export declare const signalWithStartRunName: (workflowType: string) => string;
61
62
  export declare const queryWorkflowRunName: (queryName: string) => string;
62
63
  /** `StartWorkflowUpdate:<name>` — client update-start marker. */
63
64
  export declare const startWorkflowUpdateRunName: (updateName: string) => string;
64
- /** `StartUpdateWithStartWorkflow:<name>` — client update-with-start marker. */
65
- export declare const startUpdateWithStartRunName: (updateName: string) => string;
65
+ /** `StartUpdateWithStartWorkflow:<type>` — client update-with-start marker. */
66
+ export declare const startUpdateWithStartRunName: (workflowType: string) => string;
67
+ type RunTreeMember = (this: any, ...args: any[]) => any;
68
+ /** RunTree members to replace, each mapped to a function that builds the replacement from LangSmith's original. */
69
+ export interface RunTreeOverrides {
70
+ statics: Record<string, (original: RunTreeMember) => RunTreeMember>;
71
+ methods: Record<string, (original: RunTreeMember) => RunTreeMember>;
72
+ }
73
+ /**
74
+ * Throw, naming each one, unless every member the overrides replace is a function. The Workflow bundle may carry a
75
+ * different LangSmith copy than the Worker, so both check.
76
+ */
77
+ export declare function requireRunTreeMembers(...overrides: RunTreeOverrides[]): void;
78
+ /** Replace the overridden RunTree members, or none if any is missing. */
79
+ export declare function patchRunTree(overrides: RunTreeOverrides): void;
80
+ /** Flatten a {@link RunTree} into the plain wire shape consumed by the Sink. */
81
+ export declare function serializeRun(run: RunTree): SerializedRun;
66
82
  /**
67
83
  * Render an error into the LangSmith `error` string, honoring Temporal's
68
84
  * benign-failure category.
@@ -72,19 +88,38 @@ export declare const startUpdateWithStartRunName: (updateName: string) => string
72
88
  * failures produce `"<type>: <message>"`.
73
89
  */
74
90
  export declare function describeError(err: unknown): string | undefined;
75
- /** Coerce an arbitrary operation result into a LangSmith outputs object. */
76
- export declare function asOutputs(result: unknown): Record<string, unknown>;
77
- /** The trace context to propagate for `run`, or `undefined` when absent. */
91
+ /** Outputs of a plugin run that ends without an error. Plugin runs never record Temporal arguments or results. */
92
+ export declare function statusOutputs(status: 'ok' | 'cancelled' | 'continued_as_new'): Record<string, unknown>;
93
+ /** The `RunTree.end` arguments that close a plugin run. */
94
+ export type RunEnd = [outputs: Record<string, unknown> | undefined, error: string | undefined];
95
+ /** The `RunTree.end` arguments for a plugin run whose operation threw `err`; cancellation isn't an error. */
96
+ export declare function thrownEnd(err: unknown): RunEnd;
97
+ /** Run `fn`, then end and patch the already-posted `run` with an ok status, or with `endThrown` of what `fn` threw. */
98
+ export declare function wrapWithRun<T>(run: RunTree, fn: () => Promise<T>, endThrown?: (err: unknown) => RunEnd): Promise<T>;
99
+ export declare function isUntraced(run: RunTree): boolean;
100
+ export declare function suppressRun(run: RunTree): void;
101
+ /**
102
+ * The trace context to propagate for `run`, or `undefined` when no LangSmith run exists to parent under: no run, a
103
+ * run with no destination, or a run LangSmith won't trace (`tracingEnabled: false`). LangSmith turns tracing off for
104
+ * a run built in an env it can't use, such as a client marker.
105
+ */
78
106
  export declare function runHeaders(run: RunTree | undefined): LangSmithTraceContext | undefined;
79
- /** Emit a short-lived marker run. */
80
- export declare function emitMarkerRun(marker: RunTree): Promise<void>;
81
- /** Reconstruct a propagated parent {@link RunTree} from a trace context; never throws. */
82
- export declare function runTreeFromContext(ctx: LangSmithTraceContext | undefined): RunTree | undefined;
107
+ /**
108
+ * A run's destination: a LangSmith project, or an agent address (LangSmith's `RunTreeConfig.address`, in the
109
+ * installed version's own form).
110
+ */
111
+ export type Destination = Pick<RunTreeConfig, 'project_name' | 'address'>;
112
+ /**
113
+ * Reconstruct a propagated parent {@link RunTree} from a trace context; never throws. LangSmith's `RunTree.fromHeaders`
114
+ * lets the context's destination outrank `fallback`, so `fallback` applies only when the context names none.
115
+ */
116
+ export declare function runTreeFromContext(ctx: LangSmithTraceContext | undefined, fallback?: Destination): RunTree | undefined;
83
117
  interface RunTreeParams {
84
118
  name: string;
85
119
  runType: string;
86
120
  parent: RunTree | undefined;
87
- inputs?: Record<string, unknown>;
121
+ /** Merged over the plugin's metadata. */
122
+ metadata?: Record<string, unknown>;
88
123
  }
89
124
  /**
90
125
  * Build an emitter-side {@link RunTree} (client / activity / Nexus); force-enables