experimental-ash 0.45.0 → 0.46.0

package/dist/src/compiled/@workflow/world/spec-version.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Spec version utilities for backwards compatibility.
+ *
+ * Uses a branded type to ensure packages import the version constants
+ * from @workflow/world rather than using arbitrary numbers.
+ */
+declare const SpecVersionBrand: unique symbol;
+/**
+ * Branded type for spec versions. Must be created via SPEC_VERSION constants.
+ * This ensures all packages use the canonical version from @workflow/world.
+ */
+export type SpecVersion = number & {
+    readonly [SpecVersionBrand]: typeof SpecVersionBrand;
+};
+/**
+ * Legacy spec version (pre-event-sourcing). Also used for runs without specVersion.
+ * This is the only true legacy version — specVersion 2+ all use the event-sourced model.
+ */
+export declare const SPEC_VERSION_LEGACY: SpecVersion;
+export declare const SPEC_VERSION_SUPPORTS_EVENT_SOURCING: SpecVersion;
+export declare const SPEC_VERSION_SUPPORTS_CBOR_QUEUE_TRANSPORT: SpecVersion;
+/** Current spec version (event-sourced architecture with CBOR queue transport). */
+export declare const SPEC_VERSION_CURRENT: SpecVersion;
+/**
+ * Check if a spec version is legacy (<= SPEC_VERSION_LEGACY or undefined).
+ * Legacy runs require different handling - they use direct entity mutation
+ * instead of the event-sourced model.
+ *
+ * Checks against SPEC_VERSION_LEGACY (1), not SPEC_VERSION_CURRENT, so that
+ * intermediate versions (e.g. 2) are not incorrectly treated as legacy when
+ * SPEC_VERSION_CURRENT is bumped.
+ *
+ * @param v - The spec version number, or undefined/null for legacy runs
+ * @returns true if the run is a legacy run
+ */
+export declare function isLegacySpecVersion(v: number | undefined | null): boolean;
+/**
+ * Check if a spec version requires a newer world (> SPEC_VERSION_CURRENT).
+ * This happens when a run was created by a newer SDK version.
+ *
+ * @param v - The spec version number, or undefined/null for legacy runs
+ * @returns true if the run requires a newer world version
+ */
+export declare function requiresNewerWorld(v: number | undefined | null): boolean;
+export {};
+//# sourceMappingURL=spec-version.d.ts.map

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

@@ -0,0 +1,70 @@
+import { z } from '#compiled/zod/index.js';
+import { type SerializedData } from './serialization.js';
+import type { PaginationOptions, ResolveData } from './shared.js';
+export declare const StepStatusSchema: z.ZodEnum<{
+    pending: "pending";
+    running: "running";
+    completed: "completed";
+    failed: "failed";
+    cancelled: "cancelled";
+}>;
+/**
+ * Schema for workflow steps.
+ *
+ * Note: input/output use SerializedDataSchema to support both:
+ * - specVersion >= 2: Uint8Array (binary devalue format)
+ * - specVersion 1: any (legacy JSON format)
+ */
+export declare const StepSchema: z.ZodObject<{
+    runId: z.ZodString;
+    stepId: z.ZodString;
+    stepName: z.ZodString;
+    status: z.ZodEnum<{
+        pending: "pending";
+        running: "running";
+        completed: "completed";
+        failed: "failed";
+        cancelled: "cancelled";
+    }>;
+    input: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>]>>;
+    output: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>]>>;
+    error: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>]>>;
+    attempt: z.ZodNumber;
+    startedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    completedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    createdAt: z.ZodCoercedDate<unknown>;
+    updatedAt: z.ZodCoercedDate<unknown>;
+    retryAfter: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    specVersion: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type StepStatus = z.infer<typeof StepStatusSchema>;
+export type Step = z.infer<typeof StepSchema>;
+/**
+ * Step with input/output fields excluded (when resolveData='none').
+ * Used for listing steps without fetching the full serialized data.
+ */
+export type StepWithoutData = Omit<Step, 'input' | 'output'> & {
+    input: undefined;
+    output: undefined;
+};
+export interface CreateStepRequest {
+    stepId: string;
+    stepName: string;
+    input: SerializedData;
+}
+export interface UpdateStepRequest {
+    attempt?: number;
+    status?: StepStatus;
+    output?: SerializedData;
+    error?: SerializedData;
+    retryAfter?: Date;
+}
+export interface GetStepParams {
+    resolveData?: ResolveData;
+}
+export interface ListWorkflowRunStepsParams {
+    runId: string;
+    pagination?: PaginationOptions;
+    resolveData?: ResolveData;
+}
+//# sourceMappingURL=steps.d.ts.map

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

@@ -0,0 +1,35 @@
+/**
+ * Default threshold for ULID timestamps in the past (24 hours).
+ *
+ * Set to 24 hours to support the resilient start path: when start() fails to
+ * create run_created, the queue carries the run input and the runtime creates
+ * the run on run_started. VQS supports delayed messages up to 24 hours.
+ */
+export declare const DEFAULT_TIMESTAMP_THRESHOLD_PAST_MS: number;
+/**
+ * Default threshold for ULID timestamps in the future (5 minutes).
+ *
+ * Kept tight to prevent abuse from client-generated ULIDs with manipulated
+ * future timestamps while still tolerating minor clock skew.
+ */
+export declare const DEFAULT_TIMESTAMP_THRESHOLD_FUTURE_MS: number;
+/** @deprecated Use DEFAULT_TIMESTAMP_THRESHOLD_PAST_MS instead */
+export declare const DEFAULT_TIMESTAMP_THRESHOLD_MS: number;
+/**
+ * Extracts a Date from a ULID string, or null if the string is not a valid ULID.
+ */
+export declare function ulidToDate(maybeUlid: string): Date | null;
+/**
+ * Validates that a prefixed ULID's embedded timestamp is within acceptable thresholds
+ * of the current server time. Uses asymmetric thresholds: 24h in the past (to support
+ * resilient start with queue delays) and 5min in the future (to prevent abuse while
+ * tolerating clock skew).
+ *
+ * @param prefixedUlid - The prefixed ULID to validate (e.g., "wrun_01ARYZ...")
+ * @param prefix - The prefix to strip (e.g., "wrun_")
+ * @param pastThresholdMs - Maximum allowed age in the past (default: 24 hours)
+ * @param futureThresholdMs - Maximum allowed distance in the future (default: 5 minutes)
+ * @returns null if valid, or an error message string if invalid
+ */
+export declare function validateUlidTimestamp(prefixedUlid: string, prefix: string, pastThresholdMs?: number, futureThresholdMs?: number): string | null;
+//# sourceMappingURL=ulid.d.ts.map

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

@@ -0,0 +1,21 @@
+import { z } from '#compiled/zod/index.js';
+export declare const WaitStatusSchema: z.ZodEnum<{
+    completed: "completed";
+    waiting: "waiting";
+}>;
+export declare const WaitSchema: z.ZodObject<{
+    waitId: z.ZodString;
+    runId: z.ZodString;
+    status: z.ZodEnum<{
+        completed: "completed";
+        waiting: "waiting";
+    }>;
+    resumeAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    completedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    createdAt: z.ZodCoercedDate<unknown>;
+    updatedAt: z.ZodCoercedDate<unknown>;
+    specVersion: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type WaitStatus = z.infer<typeof WaitStatusSchema>;
+export type Wait = z.infer<typeof WaitSchema>;
+//# sourceMappingURL=waits.d.ts.map

package/dist/src/compiled/_chunks/node/{token-CoIbMZkq.js → token-ORseRyWn.js}

@@ -1 +1 @@
-import{r as e}from"./dist-BdTs18CF.js";import{n as t,t as n}from"../../@vercel/sandbox/index.js";var r=e(((e,r)=>{var i=Object.defineProperty,a=Object.getOwnPropertyDescriptor,o=Object.getOwnPropertyNames,s=Object.prototype.hasOwnProperty,c=(e,t)=>{for(var n in t)i(e,n,{get:t[n],enumerable:!0})},l=(e,t,n,r)=>{if(t&&typeof t==`object`||typeof t==`function`)for(let c of o(t))!s.call(e,c)&&c!==n&&i(e,c,{get:()=>t[c],enumerable:!(r=a(t,c))||r.enumerable});return e},u=e=>l(i({},`__esModule`,{value:!0}),e),d={};c(d,{refreshToken:()=>m}),r.exports=u(d);var f=t(),p=n();async function m(e){let t=e?.project,n=e?.team;if(!t&&!n){let e=(0,p.findProjectInfo)();t=e.projectId,n=e.teamId}else if(!t||!n){let e=(0,p.findProjectInfo)();t??=e.projectId,n??=e.teamId}if(!t)throw new f.VercelOidcTokenError("Failed to refresh OIDC token: No project specified. Try re-linking your project with `vc link`");let r=(0,p.loadToken)(t);if(!r||(0,p.isExpired)((0,p.getTokenPayload)(r.token),e?.expirationBufferMs)){let i=await(0,p.getVercelToken)({expirationBufferMs:e?.expirationBufferMs});if(r=await(0,p.getVercelOidcToken)(i,t,n),!r)throw new f.VercelOidcTokenError(`Failed to refresh OIDC token`);(0,p.saveToken)(r,t)}process.env.VERCEL_OIDC_TOKEN=r.token}}));export default r();export{};
+import{r as e}from"./dist-BdTs18CF.js";import{n as t,t as n}from"../../@vercel/sandbox/index.js";var r=e(((e,r)=>{var i=Object.defineProperty,a=Object.getOwnPropertyDescriptor,o=Object.getOwnPropertyNames,s=Object.prototype.hasOwnProperty,c=(e,t)=>{for(var n in t)i(e,n,{get:t[n],enumerable:!0})},l=(e,t,n,r)=>{if(t&&typeof t==`object`||typeof t==`function`)for(let c of o(t))!s.call(e,c)&&c!==n&&i(e,c,{get:()=>t[c],enumerable:!(r=a(t,c))||r.enumerable});return e},u=e=>l(i({},`__esModule`,{value:!0}),e),d={};c(d,{refreshToken:()=>m}),r.exports=u(d);var f=t(),p=n();async function m(e){let t=e?.project,n=e?.team;if(!t&&!n){let e=(0,p.findProjectInfo)();t=e.projectId,n=e.teamId}else if(!t||!n){let e=(0,p.findProjectInfo)();t??=e.projectId,n??=e.teamId}if(!t)throw new f.VercelOidcTokenError("Failed to refresh OIDC token: No project specified. Try re-linking your project with `vc link`");let r=(0,p.loadToken)(t);if(!r||(0,p.isExpired)((0,p.getTokenPayload)(r.token),e?.expirationBufferMs)){let i=await(0,p.getVercelToken)({expirationBufferMs:e?.expirationBufferMs});if(r=await(0,p.getVercelOidcToken)(i,t,n),!r)throw new f.VercelOidcTokenError(`Failed to refresh OIDC token`);(0,p.saveToken)(r,t)}process.env.VERCEL_OIDC_TOKEN=r.token}0&&(r.exports={refreshToken:m})}));export default r();export{};

package/dist/src/compiled/_chunks/workflow/{coerce-BhzIW-Hm.js → coerce-BTuSKQr5.js}

@@ -1 +1 @@
-import{n as e}from"./chunk-DSjMdhoD.js";import{$ as t,et as n,nt as r,rt as i,tt as a}from"./core-XWIi7wKc.js";import{$ as o,H as s,a as c,g as l,s as u}from"./schemas-DmgDnhW3.js";var d=e({bigint:()=>h,boolean:()=>m,date:()=>g,number:()=>p,string:()=>f});function f(e){return i(o,e)}function p(e){return r(s,e)}function m(e){return n(u,e)}function h(e){return t(c,e)}function g(e){return a(l,e)}export{p as n,d as t};
+import{n as e}from"./chunk-DSjMdhoD.js";import{$ as t,et as n,nt as r,rt as i,tt as a}from"./core-5Woff_dW.js";import{$ as o,H as s,a as c,g as l,s as u}from"./schemas-DWOIBELG.js";var d=e({bigint:()=>h,boolean:()=>m,date:()=>g,number:()=>p,string:()=>f});function f(e){return i(o,e)}function p(e){return r(s,e)}function m(e){return n(u,e)}function h(e){return t(c,e)}function g(e){return a(l,e)}export{p as n,d as t};

package/dist/src/compiled/_chunks/workflow/{compat-DcEvieoj.js → compat-CG1hDp-3.js}

@@ -1 +1 @@
-import{Vi as e}from"./core-XWIi7wKc.js";const t={invalid_type:`invalid_type`,too_big:`too_big`,too_small:`too_small`,invalid_format:`invalid_format`,not_multiple_of:`not_multiple_of`,unrecognized_keys:`unrecognized_keys`,invalid_union:`invalid_union`,invalid_key:`invalid_key`,invalid_element:`invalid_element`,invalid_value:`invalid_value`,custom:`custom`};function n(t){e({customError:t})}function r(){return e().customError}var i;(function(e){})(i||={});export{n as i,t as n,r,i as t};
+import{Vi as e}from"./core-5Woff_dW.js";const t={invalid_type:`invalid_type`,too_big:`too_big`,too_small:`too_small`,invalid_format:`invalid_format`,not_multiple_of:`not_multiple_of`,unrecognized_keys:`unrecognized_keys`,invalid_union:`invalid_union`,invalid_key:`invalid_key`,invalid_element:`invalid_element`,invalid_value:`invalid_value`,custom:`custom`};function n(t){e({customError:t})}function r(){return e().customError}var i;i||={};export{n as i,t as n,r,i as t};