eve 0.63.0 → 0.64.1

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

@@ -340,8 +340,12 @@ export declare function createForwardedWritable<W = any>({ global, ops, runId, n
  * @internal
  */
 export declare function getRunReadableStream<T>(global: Record<string, any>, ops: Promise<void>[], runId: string, name: string, startIndex: number | undefined, cryptoKey: EncryptionKeyParam): ReadableStream<T>;
-/** Options for externally revived object streams. @internal */
+/** Options for external hydration. Defaults preserve live, eager hydration. @internal */
 type ExternalReviverOptions = {
+    /** Defer readable stream I/O until consumption, including nested streams. */
+    lazyStreams?: boolean;
+    /** Set false for terminal reporting: revive only the persisted abort snapshot. */
+    liveAbortSignals?: boolean;
     /** Receives completion state when a wrapper owns the public readable. */
     onReadableState?: (state: ReturnType<typeof createFlushableState>) => void;
 };

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

@@ -1 +1 @@
-import{An as e,Bn as t,Dn as n,En as r,Fn as i,In as a,Ln as o,Nn as s,On as c,Pn as l,Rn as u,jn as d,kn as f,zn as p}from"../../_chunks/workflow/logger-NN5YHpYy.js";import{A as m,C as h,D as g,E as _,F as v,I as y,J as b,L as x,M as S,N as C,O as w,P as T,S as E,T as D,_ as O,a as k,b as A,c as j,d as M,f as N,g as P,h as F,i as I,j as L,k as R,l as z,m as B,n as V,o as H,p as U,q as W,r as G,s as K,t as q,u as J,v as Y,w as X,x as Z,y as Q}from"../../_chunks/workflow/serialization-C5KgPESk.js";export{q as FRAMED_STREAM_MAX_RECONNECTS,V as FRAMED_STREAM_MAX_TOTAL_RECONNECTS,p as SerializationFormat,G as WorkflowServerReadableStream,I as WorkflowServerWritableStream,r as aesKeyOf,k as cancelAbortReaders,W as compress,H as createForwardedWritable,K as createReconnectingFramedStream,i as decodeFormatPrefix,b as decompress,n as decrypt,j as dehydrateRunError,z as dehydrateStepArguments,J as dehydrateStepError,M as dehydrateStepReturnValue,N as dehydrateWorkflowArguments,U as dehydrateWorkflowReturnValue,c as deriveRunPayloadKeys,B as deserializePreparedReplayPayload,F as deserializePreparedStepError,a as encodeWithFormatPrefix,f as encrypt,P as getByteFramingStream,O as getByteUnframingStream,Y as getCommonRevivers,Q as getDeserializeStream,A as getExternalReducers,Z as getExternalRevivers,E as getForwardedWritableEncryptionKey,h as getRunReadableStream,X as getSerializeStream,D as getStreamType,_ as getWorkflowReducers,g as getWorkflowRevivers,w as hydrateRunError,R as hydrateStepArguments,m as hydrateStepError,L as hydrateStepReturnValue,S as hydrateWorkflowArguments,C as hydrateWorkflowReturnValue,o as isEncrypted,t as isFormatPrefix,e as isRunPayloadKeys,d as isSealTarget,T as maybeDecrypt,v as maybeEncrypt,u as peekFormatPrefix,y as prepareReplayPayload,s as runPayloadKeys,l as sealTo,x as tagForwardedWritableTarget};
+import{An as e,Bn as t,Dn as n,En as r,Fn as i,In as a,Ln as o,Nn as s,On as c,Pn as l,Rn as u,jn as d,kn as f,zn as p}from"../../_chunks/workflow/logger-DFNCa8Nl.js";import{A as m,C as h,D as g,E as _,F as v,I as y,J as b,L as x,M as S,N as C,O as w,P as T,S as E,T as D,_ as O,a as k,b as A,c as j,d as M,f as N,g as P,h as F,i as I,j as L,k as R,l as z,m as B,n as V,o as H,p as U,q as W,r as G,s as K,t as q,u as J,v as Y,w as X,x as Z,y as Q}from"../../_chunks/workflow/serialization-Cl0SYU0I.js";export{q as FRAMED_STREAM_MAX_RECONNECTS,V as FRAMED_STREAM_MAX_TOTAL_RECONNECTS,p as SerializationFormat,G as WorkflowServerReadableStream,I as WorkflowServerWritableStream,r as aesKeyOf,k as cancelAbortReaders,W as compress,H as createForwardedWritable,K as createReconnectingFramedStream,i as decodeFormatPrefix,b as decompress,n as decrypt,j as dehydrateRunError,z as dehydrateStepArguments,J as dehydrateStepError,M as dehydrateStepReturnValue,N as dehydrateWorkflowArguments,U as dehydrateWorkflowReturnValue,c as deriveRunPayloadKeys,B as deserializePreparedReplayPayload,F as deserializePreparedStepError,a as encodeWithFormatPrefix,f as encrypt,P as getByteFramingStream,O as getByteUnframingStream,Y as getCommonRevivers,Q as getDeserializeStream,A as getExternalReducers,Z as getExternalRevivers,E as getForwardedWritableEncryptionKey,h as getRunReadableStream,X as getSerializeStream,D as getStreamType,_ as getWorkflowReducers,g as getWorkflowRevivers,w as hydrateRunError,R as hydrateStepArguments,m as hydrateStepError,L as hydrateStepReturnValue,S as hydrateWorkflowArguments,C as hydrateWorkflowReturnValue,o as isEncrypted,t as isFormatPrefix,e as isRunPayloadKeys,d as isSealTarget,T as maybeDecrypt,v as maybeEncrypt,u as peekFormatPrefix,y as prepareReplayPayload,s as runPayloadKeys,l as sealTo,x as tagForwardedWritableTarget};

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

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

package/dist/src/compiled/@workflow/core/workflow/set-attributes.d.ts

@@ -31,6 +31,10 @@ export interface SetAttributesOptions {
  * empty record is a no-op. `value: undefined` removes the key from the
  * run's attribute map.
  *
+ * Each call's complete eventData must fit in 8192 UTF-8 JSON bytes, including
+ * keys, escaped values, and writer metadata. Split larger updates into smaller
+ * calls; the per-value and per-run attribute limits still apply.
+ *
  * **Reserved namespace.** Keys starting with `$` are reserved for
  * framework/library code (telemetry, agent metadata, etc.). User code
  * trying to write a `$`-prefixed key throws `FatalError`. If you are a

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

@@ -1 +1 @@
-import{i as e,u as t}from"../../_chunks/workflow/dist-xTushGCp.js";import{i as n}from"../../_chunks/workflow/workflow-routes-CwqB063q.js";import{X as r,Y as i,ft as a,mt as o,pt as s,st as c}from"../../_chunks/workflow/serialization-C5KgPESk.js";import{c as l,i as u,o as d,r as f,t as p}from"../../_chunks/workflow/attribute-changes-A6HfMNG3.js";import{t as m}from"../../_chunks/workflow/sleep-CbUwdv6O.js";import{t as h}from"../../_chunks/workflow/run-DJevv8zz.js";r(i,h);function g(e){let t=globalThis[a];return t||u(`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 generated for you. 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}=l();return o.url=n(s,{type:`webhook`,token:o.token}),o}function v(){function e(t,n){d(`defineHook().resume()`,`https://workflow-sdk.dev/docs/api-reference/workflow-api/resume-hook`,e)}return{create(e){return g(e)},resume:e}}async function y(t,n={}){let r=p(t,n);if(r.length===0)return;let i=n.allowReservedAttributes===!0,a=globalThis[o];if(!a)throw new e("setAttributes() called outside a workflow runtime context. It must be called from within a workflow body (`use workflow`).");await a(r,i?{allowReservedAttributes:!0}:{})}function b(e={}){let{namespace:t}=e,n=globalThis[s](t);return Object.create(globalThis.WritableStream.prototype,{[c]:{value:n,writable:!1}})}function x(){f(`getStepMetadata()`,`https://workflow-sdk.dev/docs/api-reference/workflow/get-step-metadata`,x)}function S(){d(`resumeHook()`,`https://workflow-sdk.dev/docs/api-reference/workflow-api/resume-hook`,S)}export{e as FatalError,t as RetryableError,g as createHook,_ as createWebhook,v as defineHook,x as getStepMetadata,l as getWorkflowMetadata,b as getWritable,S as resumeHook,y as setAttributes,m as sleep};
+import{i as e,u as t}from"../../_chunks/workflow/dist-xTushGCp.js";import{i as n}from"../../_chunks/workflow/workflow-routes-CwqB063q.js";import{X as r,Y as i,ft as a,mt as o,pt as s,st as c}from"../../_chunks/workflow/serialization-Cl0SYU0I.js";import{c as l,i as u,o as d,r as f,t as p}from"../../_chunks/workflow/attribute-changes-DFx4eluc.js";import{t as m}from"../../_chunks/workflow/sleep-DB4AH9-A.js";import{t as h}from"../../_chunks/workflow/run-BT6SQv5f.js";r(i,h);function g(e){let t=globalThis[a];return t||u(`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 generated for you. 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}=l();return o.url=n(s,{type:`webhook`,token:o.token}),o}function v(){function e(t,n){d(`defineHook().resume()`,`https://workflow-sdk.dev/docs/api-reference/workflow-api/resume-hook`,e)}return{create(e){return g(e)},resume:e}}async function y(t,n={}){let r=p(t,n);if(r.length===0)return;let i=n.allowReservedAttributes===!0,a=globalThis[o];if(!a)throw new e("setAttributes() called outside a workflow runtime context. It must be called from within a workflow body (`use workflow`).");await a(r,i?{allowReservedAttributes:!0}:{})}function b(e={}){let{namespace:t}=e,n=globalThis[s](t);return Object.create(globalThis.WritableStream.prototype,{[c]:{value:n,writable:!1}})}function x(){f(`getStepMetadata()`,`https://workflow-sdk.dev/docs/api-reference/workflow/get-step-metadata`,x)}function S(){d(`resumeHook()`,`https://workflow-sdk.dev/docs/api-reference/workflow-api/resume-hook`,S)}export{e as FatalError,t as RetryableError,g as createHook,_ as createWebhook,v as defineHook,x as getStepMetadata,l as getWorkflowMetadata,b as getWritable,S as resumeHook,y as setAttributes,m as sleep};

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

@@ -47,7 +47,6 @@ export declare const AnalyticsEventSchema: z.ZodObject<{
     runId: z.ZodString;
     eventId: z.ZodString;
     eventType: z.ZodEnum<{
-        noop: "noop";
         run_created: "run_created";
         run_started: "run_started";
         run_completed: "run_completed";
@@ -65,6 +64,7 @@ export declare const AnalyticsEventSchema: z.ZodObject<{
         hook_conflict: "hook_conflict";
         wait_created: "wait_created";
         wait_completed: "wait_completed";
+        noop: "noop";
     }>;
     correlationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     entityId: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/src/compiled/@workflow/world/attributes-validation.d.ts

@@ -1,3 +1,4 @@
+import type { EventOfType } from './events.js';
 /** A single run-attribute change. `null` removes the key. */
 export interface AttributeChange {
     key: string;
@@ -77,10 +78,14 @@ export declare function purgesUserDataOnFinish(attributes: Record<string, string
 export declare const ATTRIBUTE_KEY_MAX_LENGTH = 256;
 export declare const ATTRIBUTE_VALUE_MAX_BYTES = 256;
 export declare const ATTRIBUTE_MAX_PER_RUN = 64;
+/** World attr_set limit for JSON-serialized eventData, not just attribute values. */
+export declare const ATTRIBUTE_EVENT_DATA_MAX_BYTES = 8192;
 /** A validation failure that callers can translate at their API boundary. */
 export declare class AttributeValidationError extends Error {
     constructor(message: string);
 }
+/** Validate writes without applying a new constraint to persisted event schemas. */
+export declare function validateAttributeEventDataSize(eventData: EventOfType<'attr_set'>['eventData']): void;
 /** Validates constraints that apply across a batch of individually valid changes. */
 export declare function validateAttributeBatchConstraints(changes: AttributeChange[], context?: {
     /** Existing keys make the post-merge count exact. */

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

@@ -6,7 +6,6 @@ import type { StartedStep, Step } from './steps.js';
 import type { Wait } from './waits.js';
 export * from './event-metadata.js';
 export declare const EventTypeSchema: z.ZodEnum<{
-    noop: "noop";
     run_created: "run_created";
     run_started: "run_started";
     run_completed: "run_completed";
@@ -24,6 +23,7 @@ export declare const EventTypeSchema: z.ZodEnum<{
     hook_conflict: "hook_conflict";
     wait_created: "wait_created";
     wait_completed: "wait_completed";
+    noop: "noop";
 }>;
 export type EventType = z.infer<typeof EventTypeSchema>;
 declare const RunEventTypeSchema: z.ZodEnum<{
@@ -99,7 +99,6 @@ export declare function isChildEntityCreationEventType(eventType: string): event
 export declare function stripEventDataRefs(event: Event, resolveData: ResolveData): Event;
 export declare const BaseEventSchema: z.ZodObject<{
     eventType: z.ZodEnum<{
-        noop: "noop";
         run_created: "run_created";
         run_started: "run_started";
         run_completed: "run_completed";
@@ -117,6 +116,7 @@ export declare const BaseEventSchema: z.ZodObject<{
         hook_conflict: "hook_conflict";
         wait_created: "wait_created";
         wait_completed: "wait_completed";
+        noop: "noop";
     }>;
     correlationId: z.ZodOptional<z.ZodString>;
     specVersion: z.ZodOptional<z.ZodNumber>;

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

@@ -1,13 +1,14 @@
 export type * from './analytics.js';
 export { ANALYTICS_EVENTS_GET_MANY_LIMIT, ANALYTICS_MAX_ATTRIBUTE_FILTERS, ANALYTICS_PAGE_LIMIT, ANALYTICS_RUN_SCOPED_PAGE_LIMIT, AnalyticsAttributeKeySchema, AnalyticsEventSchema, AnalyticsHookSchema, AnalyticsRunSchema, AnalyticsStepSchema, AnalyticsWaitSchema, } from './analytics.js';
 export type * from './attributes.js';
-export { ATTRIBUTE_KEY_MAX_LENGTH, ATTRIBUTE_MAX_PER_RUN, ATTRIBUTE_VALUE_MAX_BYTES, AttributeChangeSchema, AttributeChangesSchema, AttributeKeySchema, AttributeValidationError, AttributeValueSchema, applyAttributeChanges, PARENT_RUN_ID_ATTRIBUTE, purgesUserDataOnFinish, RESERVED_ATTRIBUTE_KEY_PREFIX, RETENTION_ATTRIBUTE, RETENTION_DEFAULT, RETENTION_ZERO, type ResolvedRunRetention, ROOT_RUN_ID_ATTRIBUTE, type RunRetention, readRunRetention, validateAttributeChanges, } from './attributes.js';
+export { ATTRIBUTE_EVENT_DATA_MAX_BYTES, ATTRIBUTE_KEY_MAX_LENGTH, ATTRIBUTE_MAX_PER_RUN, ATTRIBUTE_VALUE_MAX_BYTES, AttributeChangeSchema, AttributeChangesSchema, AttributeKeySchema, AttributeValidationError, AttributeValueSchema, applyAttributeChanges, PARENT_RUN_ID_ATTRIBUTE, purgesUserDataOnFinish, RESERVED_ATTRIBUTE_KEY_PREFIX, RETENTION_ATTRIBUTE, RETENTION_DEFAULT, RETENTION_ZERO, type ResolvedRunRetention, ROOT_RUN_ID_ATTRIBUTE, type RunRetention, readRunRetention, validateAttributeChanges, validateAttributeEventDataSize, } from './attributes.js';
 export { _resetEnvWarnCacheForTests, type EnvNumberOptions, envFlag, envNumber, getMaxEventsPerRun, } from './env-config.js';
 export type * from './events.js';
 export { BaseEventSchema, CHILD_ENTITY_CREATION_EVENT_TYPES, CreateEventSchema, classifyEntityEvent, EventSchema, EventTypeSchema, entityEventClass, getEventDataPayloadField, getEventDataRefFields, HOOK_EVENTS_REQUIRING_EXISTENCE, HOOK_LIFECYCLE_EVENT_TYPES, HookCreatedEventSchema, isChildEntityCreationEvent, isChildEntityCreationEventType, isHookEventRequiringExistence, isHookLifecycleEventType, isRunEventType, isSealedNoopEvent, isStepEventType, isTerminalRunEventType, isTerminalStepEventType, isWaitEventType, RUN_ENTITY_KEY, RUN_EVENT_TYPES, STEP_EVENT_TYPES, stripEventDataRefs, TERMINAL_EVENT_CLASSES, TERMINAL_RUN_EVENT_TYPES, TERMINAL_STEP_EVENT_TYPES, TerminalRunEventTypeSchema, WAIT_EVENT_TYPES, } from './events.js';
 export type * from './hooks.js';
 export { HOOK_RESUME_DEDUP_VERSION, HOOK_RESUME_INPUT_VERSION, HookResumeCapabilitiesSchema, HookSchema, } from './hooks.js';
 export type * from './interfaces.js';
+export type { InvocationOutcome, SerializedWorkflowError, } from './invocation.js';
 export { isNodeHttpEnabled, NODE_HTTP_DEFAULT, NODE_HTTP_ENV_VAR, } from './node-http-flag.js';
 export type * from './queue.js';
 export { getQueueTopicPrefix, HealthCheckPayloadSchema, MessageId, parseQueueName, QueuePayloadSchema, QueuePrefix, RunInputSchema, resolveQueueNamespace, ValidQueueName, WorkflowInvokePayloadSchema, } from './queue.js';

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

@@ -366,6 +366,16 @@ export interface Storage {
  * explicitly declares it.
  */
 export interface WorldCapabilities {
+    /**
+     * Enables invoke() and request/response processing through createQueueHandler.
+     * Requires at most one active workflow runner per runId across all worker
+     * processes. Different runs may execute concurrently.
+     *
+     * The active runner must process inputs while it awaits step work. A replacement
+     * runner may take over after the previous runner stops, so process identity can
+     * change over the run's lifetime.
+     */
+    invoke?: boolean;
     /**
      * Supports `experimental_minRetention` for Hooks. Missing or inactive means
      * the runtime rejects retained Hooks before registration.
@@ -415,7 +425,8 @@ export interface WorldCapabilities {
      * server-computed, response-only `Hook.resumeCapabilities.hookResumeDedupVersion`
      * (see `HookResumeCapabilitiesSchema`), so a server rollback or kill switch
      * degrades new resumes to plain writes immediately without redeploying
-     * the adapter. `world-postgres` leaves it unset for now.
+     * the adapter. `world-postgres` enforces resume identities transactionally
+     * and declares the capability statically.
      *
      * The resume gate treats EITHER signal as backend support (see
      * `resume-hook.ts`): this static capability OR a current

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

@@ -0,0 +1,19 @@
+/** An executor error encoded for transport. Fields can contain Uint8Array and Date values. */
+export interface SerializedWorkflowError {
+    name: string;
+    message: string;
+    stack?: string;
+    fields: Record<string, unknown>;
+    cause?: SerializedWorkflowError;
+    /** Preserves a cause value that is not an Error instance. */
+    causeValue?: unknown;
+}
+/** A transported handler result. invoke() returns the value or throws the restored error. */
+export type InvocationOutcome = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    error: SerializedWorkflowError;
+};
+//# sourceMappingURL=invocation.d.ts.map

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

@@ -158,6 +158,9 @@ export declare const HookResumeTimingSchema: z.ZodObject<{
 export type HookResumeTiming = z.infer<typeof HookResumeTimingSchema>;
 export declare const WorkflowInvokePayloadSchema: z.ZodObject<{
     runId: z.ZodString;
+    invoke: z.ZodOptional<z.ZodLiteral<true>>;
+    requestId: z.ZodOptional<z.ZodString>;
+    input: z.ZodOptional<z.ZodUnknown>;
     traceCarrier: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     requestedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     replayDivergence: z.ZodOptional<z.ZodObject<{
@@ -245,6 +248,9 @@ export declare const QueuePayloadSchema: z.ZodUnion<readonly [z.ZodObject<{
     runId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     runId: z.ZodString;
+    invoke: z.ZodOptional<z.ZodLiteral<true>>;
+    requestId: z.ZodOptional<z.ZodString>;
+    input: z.ZodOptional<z.ZodUnknown>;
     traceCarrier: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     requestedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     replayDivergence: z.ZodOptional<z.ZodObject<{
@@ -337,8 +343,23 @@ export type QueueBatchResult = {
     /** Republishing the batch may succeed. */
     retryable: boolean;
 };
+export interface InvokeOptions {
+    /** Retries of one request reuse this key and the exact same payload. */
+    idempotencyKey?: string;
+    /** Maximum time to await a response. Timeout does not undo processing. */
+    timeoutMs?: number;
+}
 export interface Queue {
     getDeploymentId(): Promise<string>;
+    /**
+     * Send an invocation to a run's executor. Must be enabled via capabilities.invoke.
+     * An invocation carries an out-of-band request that must be processed by the
+     * executor. The executor's response is propagated back and errors are rethrown
+     * by invoke(). A transport error is an unknown outcome: the request may have
+     * been successfully processed by the executor, for example, and the success
+     * result may be lost.
+     */
+    invoke?(runId: string, payload: unknown, options?: InvokeOptions): Promise<unknown>;
     /**
      * Returns true only when a queue error definitively means the explicitly
      * targeted deployment cannot receive the message. Unknown and transient
@@ -392,6 +413,8 @@ export interface Queue {
     /**
      * Creates an HTTP queue handler for processing messages from a specific queue.
      * A rejected handler must retry the same message with an incremented attempt.
+     * With `invoke: true`, the return value is response data delivered by World.
+     * Only ordinary wake results interpret `{ timeoutSeconds }` as queue control.
      *
      * `meta.messageId` SHOULD be stable across redeliveries of the same message
      * (one ID per enqueued message, reused on every delivery attempt). The
@@ -408,8 +431,6 @@ export interface Queue {
         queueName: ValidQueueName;
         messageId: MessageId;
         requestId?: string;
-    }) => Promise<void | {
-        timeoutSeconds: number;
-    }>): (req: Request) => Promise<Response>;
+    }) => Promise<unknown>): (req: Request) => Promise<Response>;
 }
 //# sourceMappingURL=queue.d.ts.map