@voyantjs/workflows 0.6.7 → 0.6.9

package/dist/trigger.d.ts

@@ -0,0 +1,122 @@
+import type { Duration, EnvironmentName, RunStatus } from "./types.js";
+import type { EnvironmentContext, WorkflowHandle } from "./workflow.js";
+export interface WorkflowsClient {
+    trigger<TIn, TOut>(workflow: WorkflowHandle<TIn, TOut> | string, input: TIn, opts?: TriggerOptions): Promise<Run<TOut>>;
+    signal(runId: string, name: string, payload: unknown, opts?: {
+        nonce?: string;
+    }): Promise<void>;
+    completeToken(tokenId: string, payload: unknown): Promise<void>;
+    cancel(runId: string, opts?: {
+        compensate?: boolean;
+        reason?: string;
+    }): Promise<void>;
+    retry(runId: string, opts: {
+        mode: "re-trigger" | "resume";
+    }): Promise<Run>;
+    replay(runId: string, opts?: {
+        fromStepId?: string;
+        input?: unknown;
+    }): Promise<Run>;
+    get(runId: string): Promise<RunDetail>;
+    list(opts?: ListRunsOptions): Promise<{
+        runs: RunSummary[];
+        nextCursor?: string;
+    }>;
+    mintAccessToken(opts: MintAccessTokenOptions): Promise<PublicAccessToken>;
+}
+export interface TriggerOptions {
+    idempotencyKey?: string;
+    delay?: Duration | Date;
+    debounce?: {
+        key: string;
+        delay: Duration;
+        mode?: "leading" | "trailing";
+    };
+    ttl?: Duration;
+    tags?: string[];
+    priority?: number;
+    concurrencyKey?: string;
+    lockToVersion?: string;
+    environment?: EnvironmentName;
+    issuePublicAccessToken?: boolean;
+}
+export interface Run<TOut = unknown> {
+    id: string;
+    workflowId: string;
+    status: RunStatus;
+    startedAt: number;
+    accessToken?: string;
+    /** Phantom; used only for TypeScript inference. */
+    readonly __output?: TOut;
+}
+export interface RunSummary {
+    id: string;
+    workflowId: string;
+    status: RunStatus;
+    startedAt: number;
+    completedAt?: number;
+    tags: string[];
+    environment: EnvironmentName;
+}
+export interface RunDetail<TOut = unknown> extends RunSummary {
+    version: string;
+    input: unknown;
+    output?: TOut;
+    error?: unknown;
+    durationMs?: number;
+}
+export interface ListRunsOptions {
+    workflowId?: string;
+    status?: RunStatus | RunStatus[];
+    environment?: EnvironmentName;
+    tag?: string;
+    since?: Date | number;
+    until?: Date | number;
+    cursor?: string;
+    limit?: number;
+}
+export interface MintAccessTokenOptions {
+    target: {
+        kind: "run";
+        runId: string;
+    } | {
+        kind: "workflow";
+        workflowId: string;
+    } | {
+        kind: "tag";
+        tag: string;
+    };
+    scope: ("read" | "trigger" | "cancel")[];
+    ttl?: Duration;
+}
+export interface PublicAccessToken {
+    token: string;
+    exp: number;
+}
+/**
+ * Top-level server SDK client. Resolves against the configured
+ * Voyant Cloud API key and account. The runtime implementation is
+ * installed by the cloud client package; imported alone, every
+ * method throws with guidance.
+ */
+export declare const workflows: WorkflowsClient;
+export interface EventFilterHandle {
+    readonly id: string;
+    readonly event: string;
+}
+export interface EventFilterDeclaration<T> {
+    target: WorkflowHandle<T, unknown>;
+    match?: (payload: T, ctx: {
+        environment: EnvironmentContext;
+        project: {
+            id: string;
+        };
+    }) => boolean;
+    scope?: string;
+    input?: (payload: T) => unknown;
+}
+export interface TriggerApi {
+    on<T = unknown>(event: string, filter: EventFilterDeclaration<T>): EventFilterHandle;
+}
+export declare const trigger: TriggerApi;
+//# sourceMappingURL=trigger.d.ts.map

package/dist/trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../src/trigger.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAIvE,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,GAAG,EAAE,IAAI,EACf,QAAQ,EAAE,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,MAAM,EAC5C,KAAK,EAAE,GAAG,EACV,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;IAErB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/F,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE/D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtF,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAC3E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAEpF,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IACtC,IAAI,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAElF,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;CAC1E;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;IACvB,QAAQ,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,CAAA;KAAE,CAAA;IAC1E,GAAG,CAAC,EAAE,QAAQ,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,sBAAsB,CAAC,EAAE,OAAO,CAAA;CACjC;AAED,MAAM,WAAW,GAAG,CAAC,IAAI,GAAG,OAAO;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,SAAS,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,SAAS,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,WAAW,EAAE,eAAe,CAAA;CAC7B;AAED,MAAM,WAAW,SAAS,CAAC,IAAI,GAAG,OAAO,CAAE,SAAQ,UAAU;IAC3D,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,IAAI,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;CAEpB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,CAAA;IAChC,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EACF;QAAE,IAAI,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAC9B;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GACxC;QAAE,IAAI,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IAChC,KAAK,EAAE,CAAC,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC,EAAE,CAAA;IACxC,GAAG,CAAC,EAAE,QAAQ,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,eAStB,CAAA;AAIF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;IAClC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE;QAAE,WAAW,EAAE,kBAAkB,CAAC;QAAC,OAAO,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAK,OAAO,CAAA;IAClG,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAA;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAA;CACrF;AAED,eAAO,MAAM,OAAO,EAAE,UAQrB,CAAA"}

package/dist/trigger.js

@@ -0,0 +1,23 @@
+// Triggering workflows from server code, plus event filter declarations.
+// Authoritative contract in docs/sdk-surface.md §6.
+/**
+ * Top-level server SDK client. Resolves against the configured
+ * Voyant Cloud API key and account. The runtime implementation is
+ * installed by the cloud client package; imported alone, every
+ * method throws with guidance.
+ */
+export const workflows = new Proxy({}, {
+    get(_, method) {
+        return () => {
+            throw new Error(`@voyantjs/workflows: workflows.${method}() requires the Voyant Cloud client. ` +
+                `Install + configure it via @voyantjs/client, or see docs/sdk-surface.md §6.`);
+        };
+    },
+});
+export const trigger = {
+    on(_event, _filter) {
+        throw new Error("@voyantjs/workflows: trigger.on() must be collected by `voyant workflows build` and " +
+            "registered with the orchestrator at deploy time; it has no runtime behavior when " +
+            "called directly. See docs/sdk-surface.md §6.2.");
+    },
+};

package/dist/types.d.ts

@@ -0,0 +1,63 @@
+export type Duration = number | `${number}${"ms" | "s" | "m" | "h" | "d" | "w"}`;
+/**
+ * Cloudflare Container instance types — the set Voyant Cloud honors
+ * for `runtime: "node"` steps. Match the sizes published at
+ * https://developers.cloudflare.com/containers/ (as of
+ * compat-date 2026-04-01).
+ *
+ * | name        | vCPU  | memory  | disk  |
+ * | ----------- | ----- | ------- | ----- |
+ * | lite        | 1/16  | 256 MiB | 2 GB  |
+ * | basic       | 1/4   | 1 GiB   | 4 GB  |
+ * | standard-1  | 1/2   | 4 GiB   | 8 GB  |
+ * | standard-2  | 1     | 6 GiB   | 12 GB |
+ * | standard-3  | 2     | 8 GiB   | 16 GB |
+ * | standard-4  | 4     | 12 GiB  | 20 GB |
+ *
+ * The open `(string & {})` escape hatch accepts CF custom instance
+ * types (up to 4 vCPU / 12 GiB / 20 GB, min 3 GiB RAM per vCPU) —
+ * rendered as `"custom-<vcpu>-<ramGiB>"` by convention.
+ */
+export type MachineType = "lite" | "basic" | "standard-1" | "standard-2" | "standard-3" | "standard-4" | (string & {});
+export type EnvironmentName = "production" | "preview" | "development";
+export type RunStatus = "pending" | "running" | "waiting" | "completed" | "failed" | "cancelled" | "cancelled_by_dev_reload" | "cancelled_by_version_sunset" | "compensated" | "compensation_failed" | "timed_out";
+export type ExecutionStatus = "CREATED" | "QUEUED" | "EXECUTING" | "EXECUTING_WITH_WAITPOINTS" | "SUSPENDED" | "PENDING_CANCEL" | "FINISHED";
+export type WaitpointKind = "DATETIME" | "EVENT" | "SIGNAL" | "RUN" | "MANUAL";
+export interface RetryPolicy {
+    max?: number;
+    backoff?: "exponential" | "linear" | "fixed";
+    initial?: Duration;
+    maxDelay?: Duration;
+}
+export interface RateLimitSpec {
+    key: string | ((input: unknown, ctx: {
+        run: {
+            id: string;
+        };
+        project: {
+            id: string;
+        };
+    }) => string);
+    limit: number | ((input: unknown) => number);
+    units?: number | ((input: unknown) => number);
+    window: Duration;
+    onLimit?: "queue" | "fail";
+}
+export type RunTrigger = {
+    kind: "api";
+    actor?: string;
+    accessTokenId?: string;
+} | {
+    kind: "schedule";
+    scheduleId: string;
+} | {
+    kind: "event";
+    eventId: string;
+    eventType: string;
+    filterId: string;
+} | {
+    kind: "parent";
+    parentRunId: string;
+    parentStepId: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,GAAG,MAAM,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,CAAA;AAEhF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,OAAO,GACP,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEjB,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,SAAS,GAAG,aAAa,CAAA;AAEtE,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,GACX,yBAAyB,GACzB,6BAA6B,GAC7B,aAAa,GACb,qBAAqB,GACrB,WAAW,CAAA;AAEf,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,QAAQ,GACR,WAAW,GACX,2BAA2B,GAC3B,WAAW,GACX,gBAAgB,GAChB,UAAU,CAAA;AAEd,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAA;AAE9E,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAA;IAC5C,OAAO,CAAC,EAAE,QAAQ,CAAA;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE;QAAE,GAAG,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,OAAO,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAK,MAAM,CAAC,CAAA;IACjG,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,CAAA;IAC5C,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,CAAA;IAC7C,MAAM,EAAE,QAAQ,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAC3B;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAA"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// Core type aliases used across the SDK.
+// Authoritative definitions in docs/sdk-surface.md §0 and §2.
+export {};

package/dist/workflow.d.ts

@@ -0,0 +1,212 @@
+import type { Condition } from "./conditions.js";
+import type { Duration, EnvironmentName, MachineType, RateLimitSpec, RetryPolicy, RunStatus, RunTrigger } from "./types.js";
+export interface WorkflowHandle<TInput = unknown, TOutput = unknown> {
+    readonly id: string;
+    /** Phantom; used only for TypeScript inference of `workflows.trigger(...)`. */
+    readonly __input?: TInput;
+    readonly __output?: TOutput;
+}
+export interface WorkflowConfig<TInput, TOutput> {
+    id: string;
+    input?: unknown;
+    output?: unknown;
+    description?: string;
+    schedule?: ScheduleDeclaration | ScheduleDeclaration[];
+    concurrency?: ConcurrencyPolicy<TInput>;
+    retry?: RetryPolicy;
+    timeout?: Duration;
+    defaultRuntime?: "edge" | "node";
+    tags?: string[];
+    run: (input: TInput, ctx: WorkflowContext<TInput>) => Promise<TOutput>;
+}
+/**
+ * Internal registered form of a workflow. The executor takes this
+ * plus a request and drives the body.
+ */
+export interface WorkflowDefinition<TInput = unknown, TOutput = unknown> extends WorkflowHandle<TInput, TOutput> {
+    readonly config: WorkflowConfig<TInput, TOutput>;
+}
+export type ScheduleDeclaration = ({
+    cron: string;
+} | {
+    every: Duration;
+} | {
+    at: string | Date;
+}) & {
+    timezone?: string;
+    input?: unknown | (() => unknown | Promise<unknown>);
+    enabled?: boolean;
+    overlap?: "skip" | "queue" | "allow";
+    environments?: EnvironmentName[];
+    name?: string;
+};
+export interface ConcurrencyPolicy<TInput> {
+    key?: string | ((input: TInput) => string);
+    limit?: number;
+    strategy?: "queue" | "cancel-in-progress" | "cancel-newest" | "round-robin";
+}
+/** Declare a workflow. See docs/sdk-surface.md §2.1. */
+export declare function workflow<TInput = unknown, TOutput = unknown>(config: WorkflowConfig<TInput, TOutput>): WorkflowDefinition<TInput, TOutput>;
+/** Internal: look up a registered workflow by id. */
+export declare function getWorkflow(id: string): WorkflowDefinition | undefined;
+/**
+ * Internal: enumerate every registered workflow. Used by the CLI to list
+ * workflows discovered from a loaded entry file. Not part of the stable
+ * public API — implementation detail of the SDK/CLI pair.
+ */
+export declare function __listRegisteredWorkflows(): WorkflowDefinition[];
+/**
+ * Internal: clear the workflow registry. Called by the CLI between
+ * builds / hot-reloads to drop stale workflows before re-importing
+ * the tenant bundle, and by test suites in beforeEach to isolate
+ * runs. Not part of the stable public API.
+ */
+export declare function __resetRegistry(): void;
+export interface RunContext {
+    id: string;
+    number: number;
+    attempt: number;
+    triggeredBy: RunTrigger;
+    tags: readonly string[];
+    startedAt: number;
+}
+export interface EnvironmentContext {
+    name: EnvironmentName;
+    git?: {
+        commit: string;
+        branch: string;
+        pr?: {
+            number: number;
+            url: string;
+        };
+    };
+}
+export interface WorkflowContext<_TInput = unknown> {
+    readonly run: RunContext;
+    readonly workflow: {
+        id: string;
+        version: string;
+    };
+    readonly environment: EnvironmentContext;
+    readonly project: {
+        id: string;
+        slug: string;
+    };
+    readonly organization: {
+        id: string;
+        slug: string;
+    };
+    readonly invocationCount: number;
+    readonly signal: AbortSignal;
+    step: StepApi;
+    sleep: (duration: Duration) => Promise<void>;
+    waitForEvent: WaitForEventApi;
+    waitForSignal: WaitForSignalApi;
+    waitForToken: WaitForTokenApi;
+    invoke: InvokeApi;
+    parallel: ParallelApi;
+    stream: StreamApi;
+    group: GroupApi;
+    compensate: () => Promise<never>;
+    metadata: MetadataApi;
+    now: () => number;
+    random: () => number;
+    randomUUID: () => string;
+    setRetry: (policy: RetryPolicy) => void;
+}
+export interface StepApi {
+    <T>(id: string, fn: StepFn<T>): Promise<T>;
+    <T>(id: string, opts: StepOptions<T>, fn: StepFn<T>): Promise<T>;
+}
+export type StepFn<T> = (stepCtx: StepContext) => Promise<T>;
+export interface StepContext {
+    signal: AbortSignal;
+    attempt: number;
+    log: (level: "info" | "warn" | "error", msg: string, data?: object) => void;
+}
+export interface StepOptions<T = unknown> {
+    runtime?: "edge" | "node";
+    machine?: MachineType;
+    timeout?: Duration;
+    retry?: RetryPolicy | {
+        max: 0;
+    };
+    idempotencyKey?: string;
+    compensate?: (output: T) => Promise<void>;
+    rateLimit?: RateLimitSpec;
+    waitFor?: Condition;
+    cancelIf?: Condition;
+    skipIf?: Condition;
+}
+export interface Waitable<T> extends PromiseLike<T | null> {
+    [Symbol.asyncIterator](): AsyncIterableIterator<T>;
+    close(): void;
+}
+export type WaitForEventApi = <T = unknown>(eventType: string, opts?: WaitForEventOptions<T>) => Waitable<T>;
+export interface WaitForEventOptions<T> {
+    match?: Partial<T> | ((payload: T) => boolean);
+    timeout?: Duration;
+    lookback?: Duration;
+    bufferSize?: number;
+    onTimeout?: "null" | "throw";
+}
+export type WaitForSignalApi = <T = unknown>(name: string, opts?: WaitForSignalOptions<T>) => Waitable<T>;
+export interface WaitForSignalOptions<T> extends WaitForEventOptions<T> {
+}
+export type WaitForTokenApi = <T = unknown>(opts?: WaitForTokenOptions<T>) => Promise<TokenWait<T>>;
+export interface WaitForTokenOptions<_T> {
+    tokenId?: string;
+    timeout?: Duration;
+    onTimeout?: "null" | "throw";
+    schema?: unknown;
+}
+export interface TokenWait<T> {
+    tokenId: string;
+    url: string;
+    wait: () => Promise<T | null>;
+}
+export type InvokeApi = <TIn, TOut>(workflow: WorkflowHandle<TIn, TOut>, input: TIn, opts?: InvokeOptions) => Promise<TOut>;
+export interface InvokeOptions {
+    idempotencyKey?: string;
+    tags?: string[];
+    lockToVersion?: string;
+    /**
+     * Fire-and-forget child run. The child is still triggered and
+     * persisted, but the parent does not wait for its output or error.
+     * The awaited result resolves to `undefined`; callers should not use
+     * detached invokes for control flow.
+     */
+    detach?: boolean;
+}
+export type ParallelApi = <T, R>(items: readonly T[], fn: (item: T, index: number) => Promise<R>, opts?: ParallelOptions) => Promise<R[]>;
+export interface ParallelOptions {
+    concurrency?: number;
+    settle?: boolean;
+}
+export interface StreamApi {
+    text(streamId: string, source: AsyncIterable<string>): Promise<void>;
+    json<T>(streamId: string, source: AsyncIterable<T>): Promise<void>;
+    bytes(streamId: string, source: AsyncIterable<Uint8Array>): Promise<void>;
+    <T>(streamId: string, fn: () => AsyncGenerator<T>): Promise<void>;
+}
+export type GroupApi = <T>(name: string, fn: (scope: GroupScope) => Promise<T>) => Promise<T>;
+export interface GroupScope {
+    step: StepApi;
+    compensate: () => Promise<never>;
+}
+export type MetadataValue = string | number | boolean | null | MetadataValue[] | {
+    [key: string]: MetadataValue;
+};
+export interface MetadataMutatorSubset {
+    set(key: string, value: MetadataValue): void;
+    increment(key: string, by?: number): void;
+    append<T>(key: string, value: T): void;
+    remove(key: string): void;
+}
+export interface MetadataApi extends MetadataMutatorSubset {
+    flush(): Promise<void>;
+    parent?: MetadataMutatorSubset;
+    root?: MetadataMutatorSubset;
+}
+export type { RunStatus };
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

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

package/dist/workflow.js

@@ -0,0 +1,46 @@
+// Workflow declaration and the `ctx` object.
+// Authoritative contract in docs/sdk-surface.md §2–§3.
+/**
+ * Process-local registry. Backed by globalThis so bundles that inline
+ * their own copy of @voyantjs/workflows still share the registry with
+ * the loader's copy (voyant build relies on this to extract the
+ * manifest from a user bundle at load-time). Module-local `const`
+ * would create a private map per bundle copy.
+ */
+const REGISTRY_KEY = "__voyantWorkflowRegistry";
+const globalRef = globalThis;
+const REGISTRY = globalRef[REGISTRY_KEY] ?? new Map();
+globalRef[REGISTRY_KEY] = REGISTRY;
+/** Declare a workflow. See docs/sdk-surface.md §2.1. */
+export function workflow(config) {
+    if (REGISTRY.has(config.id)) {
+        throw new Error(`workflow id "${config.id}" is already registered`);
+    }
+    const def = {
+        id: config.id,
+        config,
+    };
+    REGISTRY.set(config.id, def);
+    return def;
+}
+/** Internal: look up a registered workflow by id. */
+export function getWorkflow(id) {
+    return REGISTRY.get(id);
+}
+/**
+ * Internal: enumerate every registered workflow. Used by the CLI to list
+ * workflows discovered from a loaded entry file. Not part of the stable
+ * public API — implementation detail of the SDK/CLI pair.
+ */
+export function __listRegisteredWorkflows() {
+    return [...REGISTRY.values()];
+}
+/**
+ * Internal: clear the workflow registry. Called by the CLI between
+ * builds / hot-reloads to drop stale workflows before re-importing
+ * the tenant bundle, and by test suites in beforeEach to isolate
+ * runs. Not part of the stable public API.
+ */
+export function __resetRegistry() {
+    REGISTRY.clear();
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@voyantjs/workflows",
-  "version": "0.6.7",
-  "description": "Authoring SDK for Voyant Workflows \u2014 durable, step-based orchestrations for Voyant Cloud.",
+  "version": "0.6.9",
+  "description": "Authoring SDK for Voyant Workflows — durable, step-based orchestrations for Voyant Cloud.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -12,32 +12,32 @@
   "type": "module",
   "exports": {
     ".": {
-      "types": "./src/index.ts",
-      "import": "./src/index.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     },
     "./testing": {
-      "types": "./src/testing/index.ts",
-      "import": "./src/testing/index.ts"
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js"
     },
     "./protocol": {
-      "types": "./src/protocol/index.ts",
-      "import": "./src/protocol/index.ts"
+      "types": "./dist/protocol/index.d.ts",
+      "import": "./dist/protocol/index.js"
     },
     "./handler": {
-      "types": "./src/handler/index.ts",
-      "import": "./src/handler/index.ts"
+      "types": "./dist/handler/index.d.ts",
+      "import": "./dist/handler/index.js"
     },
     "./auth": {
-      "types": "./src/auth/index.ts",
-      "import": "./src/auth/index.ts"
+      "types": "./dist/auth/index.d.ts",
+      "import": "./dist/auth/index.js"
     },
     "./rate-limit": {
-      "types": "./src/rate-limit/index.ts",
-      "import": "./src/rate-limit/index.ts"
+      "types": "./dist/rate-limit/index.d.ts",
+      "import": "./dist/rate-limit/index.js"
     }
   },
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "files": [
     "dist",
     "src",
@@ -45,24 +45,15 @@
     "!**/*.spec.*",
     "NOTICE"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "build:examples": "tsc -p tsconfig.examples.json",
-    "spike": "pnpm build && pnpm build:examples && node examples-dist/drive.js",
-    "check-types": "tsc --noEmit",
-    "dev": "tsc -w -p tsconfig.json",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
   "dependencies": {
-    "@voyantjs/workflows-errors": "workspace:*",
-    "zod": "^3.23.8"
+    "zod": "^3.23.8",
+    "@voyantjs/workflows-errors": "0.6.9"
   },
   "devDependencies": {
     "@types/node": "^20.12.0",
-    "@voyantjs/voyant-typescript-config": "workspace:*",
     "typescript": "^5.9.2",
-    "vitest": "^3.2.0"
+    "vitest": "^3.2.0",
+    "@voyantjs/voyant-typescript-config": "0.1.0"
   },
   "peerDependencies": {
     "zod": "^3.23.0 || ^4.0.0"
@@ -74,5 +65,14 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "build:examples": "tsc -p tsconfig.examples.json",
+    "spike": "pnpm build && pnpm build:examples && node examples-dist/drive.js",
+    "check-types": "tsc --noEmit",
+    "dev": "tsc -w -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}