eve 0.9.2 → 0.9.4

package/dist/src/compiled/@workflow/core/telemetry/semantic-conventions.d.ts

@@ -72,6 +72,10 @@ export declare const WorkflowResultType: (value: string) => {
 export declare const WorkflowTracePropagated: (value: boolean) => {
     [k: string]: boolean;
 };
+/** Active trace-correlation mode for this invocation (linked or continuous) */
+export declare const WorkflowTraceMode: (value: "linked" | "continuous") => {
+    [k: string]: "linked" | "continuous";
+};
 /** Name of the error that caused workflow failure */
 export declare const WorkflowErrorName: (value: string) => {
     [k: string]: string;

package/dist/src/compiled/@workflow/core/telemetry.d.ts

@@ -1,5 +1,55 @@
 import type * as api from '#compiled/@opentelemetry/api/index.js';
 import type { Span, SpanKind, SpanOptions } from '#compiled/@opentelemetry/api/index.js';
+/**
+ * Controls how workflow/step queue-handler spans relate to the run-origin
+ * trace context carried in queue messages:
+ *
+ * - `'linked'` (default): each invocation starts a NEW root trace; the
+ *   run-origin context (and the incoming delivery context) are attached as
+ *   span links. This keeps traces bounded per invocation instead of
+ *   stitching a long-lived run into one giant trace.
+ * - `'continuous'`: the restored run-origin context becomes the parent of
+ *   the invocation span (legacy behavior), producing a single trace that
+ *   spans the entire run.
+ */
+export type WorkflowTraceMode = 'linked' | 'continuous';
+/**
+ * Resolves the active trace mode from the `WORKFLOW_TRACE_MODE` env var.
+ * Defaults to `'linked'`; any value other than `'continuous'` selects it.
+ * Unrecognized non-empty values (e.g. typos like `continous`) emit a
+ * one-time warning so silent fallback to `linked` is at least visible.
+ */
+export declare function getWorkflowTraceMode(): WorkflowTraceMode;
+/**
+ * Returns whether a serialized trace carrier is usable, i.e. present and
+ * non-empty. `serializeTraceCarrier()` returns `{}` when no OTEL SDK is
+ * registered or no span is active, and `start()` always attaches the
+ * carrier to the first queue message — so an empty carrier must be treated
+ * the same as an absent one wherever the trace-mode logic branches.
+ */
+export declare function isUsableTraceCarrier(carrier: Record<string, string> | undefined): carrier is Record<string, string>;
+/**
+ * Returns the trace carrier to attach to messages the current invocation
+ * enqueues. In `linked` mode the ORIGINAL run-origin carrier is forwarded
+ * unchanged (when usable) so every future invocation links back to the same
+ * origin; otherwise — `continuous` mode, or no usable incoming carrier —
+ * the current (active) context is serialized, so the trace keeps chaining
+ * (continuous) or the first instrumented invocation becomes the de-facto
+ * origin (linked).
+ */
+export declare function getNextTraceCarrier(traceMode: WorkflowTraceMode, incomingCarrier: Record<string, string> | undefined): Promise<Record<string, string>>;
+/**
+ * Builds the span links for a queue-delivered invocation span
+ * (`workflow.execute` / `step.execute`):
+ *
+ * - a link to the incoming delivery context (the active span extracted from
+ *   the queue delivery request, i.e. the enqueue site once the queue
+ *   propagates producer context), and
+ * - in `linked` mode, a link to the run-origin context from the message's
+ *   trace carrier (skipped when absent, empty, invalid, or identical to the
+ *   delivery context).
+ */
+export declare function buildInvocationSpanLinks(traceMode: WorkflowTraceMode, incomingCarrier: Record<string, string> | undefined): Promise<api.Link[] | undefined>;
 /**
  * Serializes the current trace context into a format that can be passed through queues
  * @returns A record of strings representing the trace context
@@ -31,6 +81,13 @@ export declare function instrumentObject<T extends object>(prefix: string, o: T)
 export declare function getSpanKind(field: keyof typeof SpanKind): Promise<api.SpanKind | undefined>;
 export declare function withOtel<T>(fn: (otel: typeof api) => T): Promise<Awaited<T> | undefined>;
 export declare function linkToCurrentContext(): Promise<[api.Link] | undefined>;
+/**
+ * Builds a span link pointing at the span context embedded in a serialized
+ * trace carrier (e.g. the run-origin context flowing through queue
+ * messages). Returns `undefined` when OTEL is unavailable, the carrier is
+ * absent, or it does not contain a valid span context.
+ */
+export declare function linkToTraceCarrier(carrier: Record<string, string> | undefined): Promise<api.Link | undefined>;
 /**
  * Workflow context to propagate via baggage
  */

package/dist/src/compiled/@workflow/core/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "5.0.0-beta.15";
+export declare const version = "5.0.0-beta.17";
 //# sourceMappingURL=version.d.ts.map

package/dist/src/compiled/@workflow/core/workflow.js

@@ -1 +1 @@
-import{c as e,i as t}from"../../_chunks/workflow/dist-6a3viBXZ.js";import{$n as n,Ht as r,Jn as i,Kt as a,Qt as o,Vt as s,Xt as c,Yn as l,Zn as u,Zt as d,t as f}from"../../_chunks/workflow/attribute-changes-DGVGRGfw.js";import{t as p}from"../../_chunks/workflow/sleep-CpXfoXLF.js";import{t as m}from"../../_chunks/workflow/run-BRdn7zy_.js";async function h(e,n={}){let r=f(e,n);if(r.length===0)return;let i=n.allowReservedAttributes===!0,a=globalThis[o];if(!a)throw new t("experimental_setAttributes() called outside a workflow runtime context. It must be called from within a workflow body (`use workflow`).");await a(r,i?{allowReservedAttributes:!0}:{})}r(s,m);function g(e){let t=globalThis[c];return t||l(`createHook()`,`https://workflow-sdk.dev/docs/api-reference/workflow/create-hook`,g),t(e)}function _(e){let{respondWith:t,token:r,...i}=e??{};if(r!==void 0)throw Error("`createWebhook()` does not accept a `token` option. Webhook tokens are always randomly generated. Use `createHook()` with `resumeHook()` for deterministic token patterns.");let a;t!==void 0&&(a={respondWith:t});let o=g({...i,metadata:a,isWebhook:!0}),{url:s}=n();return o.url=`${s}/.well-known/workflow/v1/webhook/${encodeURIComponent(o.token)}`,o}function v(){function e(t,n){u(`defineHook().resume()`,`https://workflow-sdk.dev/docs/api-reference/workflow-api/resume-hook`,e)}return{create(e){return g(e)},resume:e}}function y(e={}){let{namespace:t}=e,n=globalThis[d](t);return Object.create(globalThis.WritableStream.prototype,{[a]:{value:n,writable:!1}})}function b(){i(`getStepMetadata()`,`https://workflow-sdk.dev/docs/api-reference/workflow/get-step-metadata`,b)}function x(){u(`resumeHook()`,`https://workflow-sdk.dev/docs/api-reference/workflow-api/resume-hook`,x)}export{t as FatalError,e as RetryableError,g as createHook,_ as createWebhook,v as defineHook,h as experimental_setAttributes,b as getStepMetadata,n as getWorkflowMetadata,y as getWritable,x as resumeHook,p as sleep};
+import{c as e,i as t}from"../../_chunks/workflow/dist-DvHFhSJM.js";import{$n as n,Kt as r,Zt as i,er as a,ir as o,nn as s,nr as c,qt as l,rn as u,t as d,tn as f}from"../../_chunks/workflow/attribute-changes-Db-CKuLh.js";import{t as p}from"../../_chunks/workflow/sleep-BG6X2Bli.js";import{t as m}from"../../_chunks/workflow/run-AA-FTD_U.js";async function h(e,n={}){let r=d(e,n);if(r.length===0)return;let i=n.allowReservedAttributes===!0,a=globalThis[u];if(!a)throw new t("experimental_setAttributes() called outside a workflow runtime context. It must be called from within a workflow body (`use workflow`).");await a(r,i?{allowReservedAttributes:!0}:{})}l(r,m);function g(e){let t=globalThis[f];return t||a(`createHook()`,`https://workflow-sdk.dev/docs/api-reference/workflow/create-hook`,g),t(e)}function _(e){let{respondWith:t,token:n,...r}=e??{};if(n!==void 0)throw Error("`createWebhook()` does not accept a `token` option. Webhook tokens are always randomly generated. Use `createHook()` with `resumeHook()` for deterministic token patterns.");let i;t!==void 0&&(i={respondWith:t});let a=g({...r,metadata:i,isWebhook:!0}),{url:s}=o();return a.url=`${s}/.well-known/workflow/v1/webhook/${encodeURIComponent(a.token)}`,a}function v(){function e(t,n){c(`defineHook().resume()`,`https://workflow-sdk.dev/docs/api-reference/workflow-api/resume-hook`,e)}return{create(e){return g(e)},resume:e}}function y(e={}){let{namespace:t}=e,n=globalThis[s](t);return Object.create(globalThis.WritableStream.prototype,{[i]:{value:n,writable:!1}})}function b(){n(`getStepMetadata()`,`https://workflow-sdk.dev/docs/api-reference/workflow/get-step-metadata`,b)}function x(){c(`resumeHook()`,`https://workflow-sdk.dev/docs/api-reference/workflow-api/resume-hook`,x)}export{t as FatalError,e as RetryableError,g as createHook,_ as createWebhook,v as defineHook,h as experimental_setAttributes,b as getStepMetadata,o as getWorkflowMetadata,y as getWritable,x as resumeHook,p as sleep};

package/dist/src/compiled/@workflow/errors/index.js

@@ -1 +1 @@
-import{C as e,E as t,S as n,T as r,_ as i,a,b as o,c as s,d as c,f as l,g as u,h as d,i as f,l as p,m,n as h,o as g,p as _,r as v,s as y,t as b,u as x,v as S,w as C,x as w,y as T}from"../../_chunks/workflow/dist-6a3viBXZ.js";export{b as CorruptedEventLogError,h as ERROR_SLUGS,v as EntityConflictError,f as FatalError,a as HookConflictError,g as HookNotFoundError,t as RUN_ERROR_CODES,y as ReplayDivergenceError,s as RetryableError,p as RunExpiredError,x as RunNotSupportedError,c as RuntimeDecryptionError,l as SerializationError,_ as StepNotRegisteredError,m as ThrottleError,d as TooEarlyError,u as VERCEL_403_ERROR_MESSAGE,i as WorkflowBuildError,S as WorkflowError,T as WorkflowNotRegisteredError,o as WorkflowRunCancelledError,w as WorkflowRunFailedError,n as WorkflowRunNotCompletedError,e as WorkflowRunNotFoundError,C as WorkflowRuntimeError,r as WorkflowWorldError};
+import{C as e,E as t,S as n,T as r,_ as i,a,b as o,c as s,d as c,f as l,g as u,h as d,i as f,l as p,m,n as h,o as g,p as _,r as v,s as y,t as b,u as x,v as S,w as C,x as w,y as T}from"../../_chunks/workflow/dist-DvHFhSJM.js";export{b as CorruptedEventLogError,h as ERROR_SLUGS,v as EntityConflictError,f as FatalError,a as HookConflictError,g as HookNotFoundError,t as RUN_ERROR_CODES,y as ReplayDivergenceError,s as RetryableError,p as RunExpiredError,x as RunNotSupportedError,c as RuntimeDecryptionError,l as SerializationError,_ as StepNotRegisteredError,m as ThrottleError,d as TooEarlyError,u as VERCEL_403_ERROR_MESSAGE,i as WorkflowBuildError,S as WorkflowError,T as WorkflowNotRegisteredError,o as WorkflowRunCancelledError,w as WorkflowRunFailedError,n as WorkflowRunNotCompletedError,e as WorkflowRunNotFoundError,C as WorkflowRuntimeError,r as WorkflowWorldError};

package/dist/src/compiled/@workflow/world/queue.d.ts

@@ -49,6 +49,7 @@ export declare const RunInputSchema: z.ZodObject<{
     specVersion: z.ZodNumber;
     executionContext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    allowReservedAttributes: z.ZodOptional<z.ZodLiteral<true>>;
 }, z.core.$strip>;
 export type RunInput = z.infer<typeof RunInputSchema>;
 export declare const WorkflowInvokePayloadSchema: z.ZodObject<{
@@ -69,6 +70,7 @@ export declare const WorkflowInvokePayloadSchema: z.ZodObject<{
         specVersion: z.ZodNumber;
         executionContext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
         attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        allowReservedAttributes: z.ZodOptional<z.ZodLiteral<true>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const StepInvokePayloadSchema: z.ZodObject<{
@@ -108,6 +110,7 @@ export declare const QueuePayloadSchema: z.ZodUnion<readonly [z.ZodObject<{
         specVersion: z.ZodNumber;
         executionContext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
         attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        allowReservedAttributes: z.ZodOptional<z.ZodLiteral<true>>;
     }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     workflowName: z.ZodString;