@xyne/workflow-sdk 1.0.0

package/dist/steps/builtin/wait.step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.step.d.ts","sourceRoot":"","sources":["../../../src/steps/builtin/wait.step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAuG9D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAI/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,MAAM,WAAW,cAAe,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,2BAA2B;IAC3B,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;IACvC,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AASD,qBAAa,QAAS,SAAQ,cAAc,CAC1C,OAAO,oBAAoB,EAC3B,cAAc,CACf;IACC,SAAkB,IAAI,wBAAwB;IAC9C,SAAkB,IAAI,UAAU;IAChC,SAAkB,WAAW,oFACsD;IACnF,SAAkB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAAwB;IACtD,SAAkB,YAAY;;;;;;;;;OAAwB;IACtD,SAAkB,QAAQ,EAAE,YAAY,CAAU;IAClD,SAAkB,IAAI,WAAW;IAElB,OAAO,CACpB,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,cAAc,CAAC;IAWX,QAAQ,CACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,cAAc,CAAC;IAU1B,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,cAAc;IAgCtB,OAAO,CAAC,eAAe;CAqBxB"}

package/dist/steps/builtin/wait.step.js

@@ -0,0 +1,211 @@
+/**
+ * WAIT step — pause execution and resume on a trigger.
+ *
+ * Three modes:
+ *
+ * - `delay`: Resume automatically after a specified duration.
+ *   The step pauses with `statePatch.resumeAfter` so the host/runtime
+ *   can schedule a delayed re-enqueue.
+ *
+ * - `webhook`: Resume when an external system calls a callback URL.
+ *   The step pauses with an `externalRef` that the host uses to
+ *   route inbound callbacks to the correct execution.
+ *
+ * - `approval`: Resume when a user explicitly approves/rejects via the API.
+ *   Supports compositional interactions: display data, editable form,
+ *   and custom action buttons.
+ *
+ * All modes use `ctx.pause()`. The host runtime is responsible for
+ * scheduling delayed resumes (delay mode) or routing callbacks
+ * (webhook mode). The step itself is stateless — it pauses and
+ * trusts `onResume()` to receive whatever data the caller provides.
+ */
+import { z } from 'zod';
+import { BaseActionStep } from '../base-step.js';
+import { BuiltinStepType } from '../../types/known-types.js';
+// ─── Pause UI Schemas (shared with PauseState types) ───
+const PauseDisplaySectionSchema = z.object({
+    label: z.string(),
+    value: z.unknown(),
+});
+const PauseFormFieldOptionSchema = z.object({
+    label: z.string(),
+    value: z.string(),
+});
+const PauseFormFieldSchema = z.discriminatedUnion('type', [
+    z.object({
+        type: z.literal('text'),
+        name: z.string(),
+        label: z.string(),
+        required: z.boolean().optional(),
+        description: z.string().optional(),
+        placeholder: z.string().optional(),
+        defaultValue: z.string().optional(),
+    }),
+    z.object({
+        type: z.literal('textarea'),
+        name: z.string(),
+        label: z.string(),
+        required: z.boolean().optional(),
+        description: z.string().optional(),
+        placeholder: z.string().optional(),
+        defaultValue: z.string().optional(),
+        rows: z.number().optional(),
+    }),
+    z.object({
+        type: z.literal('number'),
+        name: z.string(),
+        label: z.string(),
+        required: z.boolean().optional(),
+        description: z.string().optional(),
+        placeholder: z.string().optional(),
+        defaultValue: z.number().optional(),
+        min: z.number().optional(),
+        max: z.number().optional(),
+    }),
+    z.object({
+        type: z.literal('select'),
+        name: z.string(),
+        label: z.string(),
+        required: z.boolean().optional(),
+        description: z.string().optional(),
+        placeholder: z.string().optional(),
+        defaultValue: z.string().optional(),
+        // Accepts array of options or a {{variable}} ref string (resolved at runtime)
+        options: z.union([z.array(PauseFormFieldOptionSchema), z.string()]),
+        allowCustomValue: z.boolean().optional(),
+    }),
+    z.object({
+        type: z.literal('checkbox'),
+        name: z.string(),
+        label: z.string(),
+        required: z.boolean().optional(),
+        description: z.string().optional(),
+        defaultValue: z.boolean().optional(),
+    }),
+]);
+const PauseFormSchema = z.object({
+    fields: z.array(PauseFormFieldSchema),
+    description: z.string().optional(),
+});
+const PauseActionSchema = z.object({
+    key: z.string(),
+    label: z.string(),
+    style: z.enum(['primary', 'danger', 'default']).optional(),
+    abort: z.boolean().optional(),
+    submitsForm: z.boolean().optional(),
+});
+// ─── Config ───
+const WaitDelayConfigSchema = z.object({
+    mode: z.literal('delay'),
+    delayMs: z.number().int().positive().describe('Duration to wait in milliseconds before auto-resuming'),
+});
+const WaitWebhookConfigSchema = z.object({
+    mode: z.literal('webhook'),
+    // No per-step config needed. The workflow's stable callback secret +
+    // this execution's ID together form the callback URL.
+});
+const WaitApprovalConfigSchema = z.object({
+    mode: z.literal('approval'),
+    reason: z.string().min(1).describe('Human-readable reason shown to the approver'),
+    prompt: z.string().optional().describe('Prompt text shown above the interaction panel'),
+    display: z.array(PauseDisplaySectionSchema).optional().describe('Read-only data sections to display. Values support {{variable}} refs'),
+    form: PauseFormSchema.optional().describe('Editable form with typed fields for the approver'),
+    actions: z.array(PauseActionSchema).optional().describe('Action buttons. Defaults to Approve + Reject when omitted'),
+});
+export const WaitStepConfigSchema = z.discriminatedUnion('mode', [
+    WaitDelayConfigSchema,
+    WaitWebhookConfigSchema,
+    WaitApprovalConfigSchema,
+]);
+const WaitStepOutputSchema = z.object({
+    mode: z.enum(['delay', 'webhook', 'approval']),
+    resumeData: z.record(z.unknown()),
+});
+// ─── Step ───
+export class WaitStep extends BaseActionStep {
+    type = BuiltinStepType.WAIT;
+    name = 'Wait';
+    description = 'Pause execution and resume after a delay, webhook callback, or manual approval';
+    configSchema = WaitStepConfigSchema;
+    outputSchema = WaitStepOutputSchema;
+    category = 'flow';
+    icon = 'clock';
+    async execute(config, ctx) {
+        switch (config.mode) {
+            case 'delay':
+                return this.executeDelay(config, ctx);
+            case 'webhook':
+                return this.executeWebhook(config, ctx);
+            case 'approval':
+                return this.executeApproval(config, ctx);
+        }
+    }
+    async onResume(rowData, _config, _ctx) {
+        const waitMode = rowData['waitMode'] ?? 'delay';
+        const resumePayload = rowData['resumePayload'] ?? {};
+        return {
+            mode: waitMode,
+            resumeData: resumePayload,
+        };
+    }
+    executeDelay(config, ctx) {
+        ctx.pause(`Waiting for ${String(config.delayMs)}ms`, {
+            statePatch: {
+                waitMode: 'delay',
+                delayMs: config.delayMs,
+                resumeAfter: new Date(Date.now() + config.delayMs).toISOString(),
+            },
+        });
+    }
+    executeWebhook(_config, ctx) {
+        // No per-step secret needed — the workflow has a stable callback secret
+        // generated at save time. The HTTP step that runs before this one
+        // interpolated `{{ runtime.executionId }}` into the URL it sent the
+        // external system. The runtime resolves the callback via the workflow
+        // secret + executionId pair (see `runtime.handleWaitCallback`).
+        //
+        // The UI surfaces the full URL by joining the workflow's stored secret
+        // with this execution's ID — the wait step itself only needs to
+        // identify which execution is paused.
+        ctx.pause('Waiting for webhook callback', {
+            statePatch: {
+                waitMode: 'webhook',
+                executionId: ctx.runtime.executionId,
+                pauseState: {
+                    reason: 'Waiting for webhook callback',
+                    category: 'input_required',
+                    display: [
+                        { label: 'Execution ID', value: ctx.runtime.executionId },
+                        {
+                            label: 'Callback URL template',
+                            value: `${ctx.runtime.baseUrl}/wait/callback/<workflow-secret>/${ctx.runtime.executionId}`,
+                        },
+                    ],
+                },
+            },
+        });
+    }
+    executeApproval(config, ctx) {
+        // Build compositional PauseState from resolved config
+        const pauseState = {
+            reason: config.reason,
+        };
+        if (config.prompt)
+            pauseState.prompt = config.prompt;
+        if (config.display)
+            pauseState.display = config.display;
+        if (config.form)
+            pauseState.form = config.form;
+        if (config.actions)
+            pauseState.actions = config.actions;
+        ctx.pause(config.reason, {
+            statePatch: {
+                waitMode: 'approval',
+                reason: config.reason,
+                pauseState,
+            },
+        });
+    }
+}
+//# sourceMappingURL=wait.step.js.map

package/dist/steps/builtin/wait.step.js.map

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

package/dist/steps/step-registry.d.ts

@@ -0,0 +1,64 @@
+import type { z } from 'zod';
+import type { StepType } from '../types/step-types.js';
+import type { StepCategory } from '../types/categories.js';
+import type { ServiceRegistry } from '../engine/service-registry.js';
+import type { BranchModel, CredentialSlot, CredentialTypeSchema, DeclaredOutput } from './base-step.js';
+import { BaseStep, StepKind } from './base-step.js';
+export interface StepSummary {
+    type: StepType;
+    name: string;
+    description: string;
+    category: StepCategory;
+    kind: StepKind;
+    icon?: string;
+    /** Control-flow steps only: 'iterate' for LOOP, 'fanout' for everything else. Absent for action steps. */
+    branchModel?: BranchModel;
+}
+export interface StepDescriptor extends StepSummary {
+    /** JSON Schema for the step's config — generated from the Zod schema. */
+    configSchema: Record<string, unknown>;
+    /** JSON Schema for the step's output — generated from the Zod schema. */
+    outputSchema: Record<string, unknown>;
+    /** Credential slots this step declares. Empty array if none. */
+    credentialSlots: readonly CredentialSlot[];
+    /** Output branches (for control-flow steps). Empty array for action steps. */
+    declaredOutputs: readonly DeclaredOutput[];
+    /** Service names this step requires at runtime. Empty array if none. */
+    requiredServices: readonly string[];
+    /** Event types this step may emit (action steps only). Empty array if none. */
+    mayEmit: readonly string[];
+    /** Credential type schemas — defines what fields each credential type needs for UI forms. */
+    credentialTypeSchemas: readonly CredentialTypeSchema[];
+}
+export declare class UnknownStepError extends Error {
+    readonly stepType: StepType;
+    constructor(stepType: StepType);
+}
+type AnyStep = BaseStep<z.ZodTypeAny, Record<string, unknown>>;
+export declare class StepRegistry {
+    private readonly map;
+    constructor();
+    /**
+     * Register a step implementation. Throws on duplicate type.
+     *
+     * If a `ServiceRegistry` is provided, validates that all
+     * `requiredServices` declared by the step are present.
+     */
+    register(instance: AnyStep, services?: ServiceRegistry): void;
+    /** Look up a step by type. Throws `UnknownStepError` if not found. */
+    get(type: StepType): AnyStep;
+    /** All registered step instances. */
+    list(): AnyStep[];
+    /** Lightweight summaries — type, name, description, category, kind, icon. */
+    listSummaries(): StepSummary[];
+    /** Full descriptor for a single step type — includes JSON Schemas and all metadata. */
+    getDescriptor(type: StepType): StepDescriptor;
+    /** Check if a step type is registered. */
+    has(type: StepType): boolean;
+    /** Number of registered steps. */
+    get size(): number;
+    private buildSummary;
+    private buildDescriptor;
+}
+export {};
+//# sourceMappingURL=step-registry.d.ts.map

package/dist/steps/step-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-registry.d.ts","sourceRoot":"","sources":["../../src/steps/step-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACxG,OAAO,EAAE,QAAQ,EAAuC,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAazF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0GAA0G;IAC1G,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAID,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,gEAAgE;IAChE,eAAe,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,8EAA8E;IAC9E,eAAe,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,wEAAwE;IACxE,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,+EAA+E;IAC/E,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,6FAA6F;IAC7F,qBAAqB,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACxD;AAID,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBAEhB,QAAQ,EAAE,QAAQ;CAO/B;AAKD,KAAK,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE/D,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgC;;IAcpD;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI;IAY7D,sEAAsE;IACtE,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO;IAQ5B,qCAAqC;IACrC,IAAI,IAAI,OAAO,EAAE;IAIjB,6EAA6E;IAC7E,aAAa,IAAI,WAAW,EAAE;IAI9B,uFAAuF;IACvF,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc;IAK7C,0CAA0C;IAC1C,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO;IAI5B,kCAAkC;IAClC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAID,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,eAAe;CAaxB"}

package/dist/steps/step-registry.js

@@ -0,0 +1,102 @@
+import { BaseStep, BaseActionStep, BaseControlFlowStep, StepKind } from './base-step.js';
+import { zodToJsonSchemaRecord } from '../util/schema-convert.js';
+import { CodeStep } from './builtin/code.step.js';
+import { ConditionalStep } from './builtin/conditional.step.js';
+import { HttpRequestStep } from './builtin/http-request.step.js';
+import { LoopStep } from './builtin/loop.step.js';
+import { ParallelStep } from './builtin/parallel.step.js';
+import { SwitchStep } from './builtin/switch.step.js';
+import { WaitStep } from './builtin/wait.step.js';
+import { DedupStep } from './builtin/dedup.step.js';
+// ─── Error ───
+export class UnknownStepError extends Error {
+    stepType;
+    constructor(stepType) {
+        super(`StepRegistry: unknown step type "${stepType}". Is it registered at boot?`);
+        this.name = 'UnknownStepError';
+        this.stepType = stepType;
+    }
+}
+export class StepRegistry {
+    map = new Map();
+    constructor() {
+        // Auto-register all built-in steps
+        this.map.set('CODE', new CodeStep());
+        this.map.set('CONDITIONAL', new ConditionalStep());
+        this.map.set('HTTP_REQUEST', new HttpRequestStep());
+        this.map.set('LOOP', new LoopStep());
+        this.map.set('PARALLEL', new ParallelStep());
+        this.map.set('SWITCH', new SwitchStep());
+        this.map.set('WAIT', new WaitStep());
+        this.map.set('DEDUP', new DedupStep());
+    }
+    /**
+     * Register a step implementation. Throws on duplicate type.
+     *
+     * If a `ServiceRegistry` is provided, validates that all
+     * `requiredServices` declared by the step are present.
+     */
+    register(instance, services) {
+        if (this.map.has(instance.type)) {
+            throw new Error(`StepRegistry: step type "${instance.type}" is already registered.`);
+        }
+        if (services && instance.requiredServices) {
+            services.assertRegistered(instance.requiredServices);
+        }
+        this.map.set(instance.type, instance);
+    }
+    /** Look up a step by type. Throws `UnknownStepError` if not found. */
+    get(type) {
+        const impl = this.map.get(type);
+        if (!impl) {
+            throw new UnknownStepError(type);
+        }
+        return impl;
+    }
+    /** All registered step instances. */
+    list() {
+        return Array.from(this.map.values());
+    }
+    /** Lightweight summaries — type, name, description, category, kind, icon. */
+    listSummaries() {
+        return this.list().map((s) => this.buildSummary(s));
+    }
+    /** Full descriptor for a single step type — includes JSON Schemas and all metadata. */
+    getDescriptor(type) {
+        const impl = this.get(type);
+        return this.buildDescriptor(impl);
+    }
+    /** Check if a step type is registered. */
+    has(type) {
+        return this.map.has(type);
+    }
+    /** Number of registered steps. */
+    get size() {
+        return this.map.size;
+    }
+    // ─── Internal builders ───
+    buildSummary(s) {
+        return {
+            type: s.type,
+            name: s.name,
+            description: s.description,
+            category: s.category,
+            kind: s.kind,
+            ...(s.icon !== undefined ? { icon: s.icon } : {}),
+            ...(s instanceof BaseControlFlowStep ? { branchModel: s.branchModel } : {}),
+        };
+    }
+    buildDescriptor(s) {
+        return {
+            ...this.buildSummary(s),
+            configSchema: s.decorateConfigSchema(zodToJsonSchemaRecord(s.configSchema)),
+            outputSchema: zodToJsonSchemaRecord(s.outputSchema),
+            credentialSlots: s.credentialSlots ?? [],
+            declaredOutputs: s.declaredOutputs ?? [],
+            requiredServices: s.requiredServices ?? [],
+            mayEmit: s instanceof BaseActionStep ? (s.mayEmit ?? []) : [],
+            credentialTypeSchemas: s.credentialTypeSchemas ?? [],
+        };
+    }
+}
+//# sourceMappingURL=step-registry.js.map

package/dist/steps/step-registry.js.map

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

package/dist/storage/in-memory-adapter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * In-memory StorageAdapter for tests and local development.
+ *
+ * Stores blobs in a Map keyed by a generated `mem://<id>` reference.
+ * Not suitable for production — bytes live in process memory and disappear
+ * on restart.
+ */
+import type { Attachment } from '../common/attachment.js';
+import type { StorageAdapter, StorageFile, StorageScope } from './types.js';
+interface StoredBlob {
+    bytes: Uint8Array;
+    attachment: Attachment;
+}
+export declare class InMemoryStorageAdapter implements StorageAdapter {
+    /** Exposed for test inspection — count, clear, etc. */
+    readonly blobs: Map<string, StoredBlob>;
+    private nextId;
+    private genRef;
+    store(_scope: StorageScope, file: StorageFile): Promise<Attachment>;
+    read(ref: Attachment): Promise<Uint8Array>;
+    signUrl(ref: Attachment, _ttlSeconds: number): Promise<string>;
+    delete(ref: Attachment): Promise<void>;
+}
+export {};
+//# sourceMappingURL=in-memory-adapter.d.ts.map

package/dist/storage/in-memory-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-adapter.d.ts","sourceRoot":"","sources":["../../src/storage/in-memory-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5E,UAAU,UAAU;IAClB,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,uDAAuD;IACvD,QAAQ,CAAC,KAAK,0BAAiC;IAE/C,OAAO,CAAC,MAAM,CAAK;IAEnB,OAAO,CAAC,MAAM;IAIR,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAYnE,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAQ1C,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK9D,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAG7C"}

package/dist/storage/in-memory-adapter.js

@@ -0,0 +1,41 @@
+/**
+ * In-memory StorageAdapter for tests and local development.
+ *
+ * Stores blobs in a Map keyed by a generated `mem://<id>` reference.
+ * Not suitable for production — bytes live in process memory and disappear
+ * on restart.
+ */
+export class InMemoryStorageAdapter {
+    /** Exposed for test inspection — count, clear, etc. */
+    blobs = new Map();
+    nextId = 1;
+    genRef() {
+        return `mem://${String(this.nextId++)}_${Math.random().toString(36).slice(2, 10)}`;
+    }
+    async store(_scope, file) {
+        const ref = this.genRef();
+        const attachment = {
+            name: file.name,
+            mimeType: file.mimeType,
+            data: ref,
+            size: file.bytes.byteLength,
+        };
+        this.blobs.set(ref, { bytes: file.bytes, attachment });
+        return attachment;
+    }
+    async read(ref) {
+        const stored = this.blobs.get(ref.data);
+        if (!stored) {
+            throw new Error(`InMemoryStorageAdapter: unknown reference "${ref.data}"`);
+        }
+        return stored.bytes;
+    }
+    async signUrl(ref, _ttlSeconds) {
+        // For tests / dev — return the opaque ref as a URL.
+        return ref.data;
+    }
+    async delete(ref) {
+        this.blobs.delete(ref.data);
+    }
+}
+//# sourceMappingURL=in-memory-adapter.js.map

package/dist/storage/in-memory-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-adapter.js","sourceRoot":"","sources":["../../src/storage/in-memory-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,OAAO,sBAAsB;IACjC,uDAAuD;IAC9C,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEvC,MAAM,GAAG,CAAC,CAAC;IAEX,MAAM;QACZ,OAAO,SAAS,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAoB,EAAE,IAAiB;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAe;YAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU;SAC5B,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACvD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAe;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,8CAA8C,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAe,EAAE,WAAmB;QAChD,oDAAoD;QACpD,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAe;QAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/storage/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * StorageAdapter — host plug-in for blob storage.
+ *
+ * The runtime calls `store()` when files arrive at `POST /uploads`, and
+ * steps call `read()` (via a host-registered service) when they need the
+ * bytes. The framework never opens an attachment's `data` field — that's
+ * the host's reference and the host's adapter must understand it.
+ *
+ * Adapters live next to {@link PersistenceAdapter} / {@link QueueAdapter} /
+ * {@link SchedulerAdapter} in `RuntimeOptions`.
+ */
+import type { Attachment } from '../common/attachment.js';
+/**
+ * Per-upload scope, propagated from the router. Typically the host's
+ * `AuthContext.metadata` — workspaceId, tenantId, userId — so the adapter
+ * can route writes into the right bucket / prefix / tenant.
+ */
+export type StorageScope = Record<string, unknown>;
+export interface StorageFile {
+    /** Original filename — e.g. "contract.pdf". */
+    name: string;
+    /** MIME type from the multipart part headers. */
+    mimeType: string;
+    /** Raw bytes parsed by the host's multipart middleware. */
+    bytes: Uint8Array;
+}
+export interface StorageAdapter {
+    /**
+     * Persist a file and return its {@link Attachment} reference. The framework
+     * passes this reference through workflow context and steps without ever
+     * opening `data`.
+     */
+    store(scope: StorageScope, file: StorageFile): Promise<Attachment>;
+    /**
+     * Resolve an attachment back to raw bytes. Steps that need the file
+     * contents call this through a host-registered service (e.g. an agent
+     * step loading an image to send to the LLM).
+     */
+    read(ref: Attachment): Promise<Uint8Array>;
+    /**
+     * Optional: short-lived presigned URL for the UI to render a preview
+     * (image thumbnail, download link). When omitted, the UI may not be able
+     * to display the attachment inline.
+     */
+    signUrl?(ref: Attachment, ttlSeconds: number): Promise<string>;
+    /**
+     * Optional: delete the underlying blob. The framework does NOT call this
+     * automatically — hosts wire cleanup into their own lifecycle hooks
+     * (execution completion, TTL job, manual purge).
+     */
+    delete?(ref: Attachment): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/storage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEnE;;;;OAIG;IACH,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE3C;;;;OAIG;IACH,OAAO,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/D;;;;OAIG;IACH,MAAM,CAAC,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}

package/dist/storage/types.js

@@ -0,0 +1,13 @@
+/**
+ * StorageAdapter — host plug-in for blob storage.
+ *
+ * The runtime calls `store()` when files arrive at `POST /uploads`, and
+ * steps call `read()` (via a host-registered service) when they need the
+ * bytes. The framework never opens an attachment's `data` field — that's
+ * the host's reference and the host's adapter must understand it.
+ *
+ * Adapters live next to {@link PersistenceAdapter} / {@link QueueAdapter} /
+ * {@link SchedulerAdapter} in `RuntimeOptions`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/testing/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @xyne/workflow-sdk/testing — Test utilities for host consumers.
+ *
+ * Provides mock factories for WorkflowContext, StepExecutionContext,
+ * and ControlFlowExecutionContext. Intended for use in unit tests
+ * when writing custom steps and triggers.
+ */
+export { createMockContext } from './mock-context.js';
+export { createMockStepContext, createMockControlFlowContext, } from './mock-step-context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACL,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,10 @@
+/**
+ * @xyne/workflow-sdk/testing — Test utilities for host consumers.
+ *
+ * Provides mock factories for WorkflowContext, StepExecutionContext,
+ * and ControlFlowExecutionContext. Intended for use in unit tests
+ * when writing custom steps and triggers.
+ */
+export { createMockContext } from './mock-context.js';
+export { createMockStepContext, createMockControlFlowContext, } from './mock-step-context.js';
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACL,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC"}

package/dist/testing/mock-context.d.ts

@@ -0,0 +1,13 @@
+import type { WorkflowContext } from '../types/context.js';
+/**
+ * Create a mock WorkflowContext for testing.
+ *
+ * Provides sensible defaults — override any field via the `overrides` param.
+ */
+export declare function createMockContext(overrides?: Partial<WorkflowContext> & {
+    workflowId?: string;
+    metadata?: Record<string, unknown>;
+    triggerType?: string;
+    triggerData?: Record<string, unknown>;
+}): WorkflowContext;
+//# sourceMappingURL=mock-context.d.ts.map

package/dist/testing/mock-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-context.d.ts","sourceRoot":"","sources":["../../src/testing/mock-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC,GACA,eAAe,CAqBjB"}

package/dist/testing/mock-context.js

@@ -0,0 +1,21 @@
+/**
+ * Create a mock WorkflowContext for testing.
+ *
+ * Provides sensible defaults — override any field via the `overrides` param.
+ */
+export function createMockContext(overrides) {
+    const { workflowId, metadata, triggerType, triggerData, ...rest } = overrides ?? {};
+    return {
+        workflow: {
+            id: workflowId ?? 'wf_test',
+            metadata: metadata ?? {},
+        },
+        trigger: {
+            type: triggerType ?? 'TEST',
+            ...triggerData,
+        },
+        steps: {},
+        ...rest,
+    };
+}
+//# sourceMappingURL=mock-context.js.map

package/dist/testing/mock-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-context.js","sourceRoot":"","sources":["../../src/testing/mock-context.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAKC;IAED,MAAM,EACJ,UAAU,EACV,QAAQ,EACR,WAAW,EACX,WAAW,EACX,GAAG,IAAI,EACR,GAAG,SAAS,IAAI,EAAE,CAAC;IAEpB,OAAO;QACL,QAAQ,EAAE;YACR,EAAE,EAAE,UAAU,IAAI,SAAS;YAC3B,QAAQ,EAAE,QAAQ,IAAI,EAAE;SACzB;QACD,OAAO,EAAE;YACP,IAAI,EAAE,WAAW,IAAI,MAAM;YAC3B,GAAG,WAAW;SACf;QACD,KAAK,EAAE,EAAE;QACT,GAAG,IAAI;KACR,CAAC;AACJ,CAAC"}