@xyne/workflow-sdk 1.0.0

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

@@ -0,0 +1,315 @@
+/**
+ * In-memory PersistenceAdapter for testing.
+ *
+ * All data lives in Maps — no external deps. Useful for unit tests
+ * and for hosts bootstrapping without a database.
+ */
+export class InMemoryPersistenceAdapter {
+    workflows = new Map();
+    executions = new Map();
+    executionStates = new Map();
+    /** Keyed by `${executionId}::${stepName}`. */
+    steps = new Map();
+    /** Keyed by `${workflowId}::${key}`. */
+    staticData = new Map();
+    /** Keyed by `${metadataKey}::${name}` — simplified for testing. */
+    credentials = new Map();
+    /** Keyed by `${executionId}::${stepName}`, stores ordered event arrays. */
+    stepEvents = new Map();
+    /** Keyed by workflowId. */
+    webhooks = new Map();
+    /** Reverse lookup: path → workflowId. */
+    webhooksByPath = new Map();
+    /** Keyed by executionId. */
+    resumePayloads = new Map();
+    /**
+     * Per-workflow wait-callback secret. Keyed by workflowId; the secret
+     * also indexed in a reverse map for O(1) lookup at callback time.
+     */
+    workflowCallbacks = new Map();
+    /** Reverse index: secret → workflowId. The Map.get hash IS the comparison. */
+    workflowCallbacksBySecret = new Map();
+    nextId = 1;
+    genId() {
+        return `id_${String(this.nextId++)}`;
+    }
+    // --- Workflow definitions ---
+    async getWorkflow(id) {
+        return this.workflows.get(id) ?? null;
+    }
+    async listWorkflows(_metadata) {
+        return Array.from(this.workflows.values());
+    }
+    async findActiveWorkflows(eventType, _metadata) {
+        return Array.from(this.workflows.values()).filter((w) => w.eventType === eventType && w.status === 'ACTIVE');
+    }
+    async createWorkflow(data) {
+        const id = data.id ?? this.genId();
+        const record = {
+            id,
+            status: data.status,
+            config: data.config,
+            metadata: data.metadata,
+            eventType: data.eventType,
+        };
+        this.workflows.set(id, record);
+        return id;
+    }
+    async updateWorkflow(id, data) {
+        const existing = this.workflows.get(id);
+        if (!existing)
+            throw new Error(`Workflow ${id} not found`);
+        if (data.status !== undefined)
+            existing.status = data.status;
+        if (data.config !== undefined)
+            existing.config = data.config;
+        if (data.metadata !== undefined)
+            existing.metadata = data.metadata;
+        if (data.eventType !== undefined)
+            existing.eventType = data.eventType;
+    }
+    // --- Execution lifecycle ---
+    async createExecution(data) {
+        const id = this.genId();
+        const record = {
+            id,
+            workflowId: data.workflowId,
+            status: data.status,
+            createdAt: new Date(),
+        };
+        if (data.sourceExecutionId !== undefined) {
+            record.sourceExecutionId = data.sourceExecutionId;
+        }
+        this.executions.set(id, record);
+        this.executionStates.set(id, {
+            context: data.context,
+            currentStepIndex: 0,
+            pausePath: null,
+        });
+        return id;
+    }
+    async updateExecutionStatus(executionId, status) {
+        const exec = this.executions.get(executionId);
+        if (exec) {
+            exec.status = status;
+        }
+    }
+    async getExecution(executionId) {
+        return this.executions.get(executionId) ?? null;
+    }
+    async listExecutions(params) {
+        let items = Array.from(this.executions.values());
+        if (params.workflowId) {
+            items = items.filter((e) => e.workflowId === params.workflowId);
+        }
+        if (params.status) {
+            items = items.filter((e) => e.status === params.status);
+        }
+        // Sort by createdAt descending (newest first)
+        items.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+        // Cursor-based pagination: cursor is the execution ID after which to start
+        if (params.cursor) {
+            const idx = items.findIndex((e) => e.id === params.cursor);
+            if (idx >= 0) {
+                items = items.slice(idx + 1);
+            }
+        }
+        const limit = params.limit ?? 50;
+        const page = items.slice(0, limit);
+        const result = { items: page };
+        if (page.length === limit) {
+            result.nextCursor = page[page.length - 1].id;
+        }
+        return result;
+    }
+    // --- Execution state ---
+    async getExecutionState(executionId) {
+        return this.executionStates.get(executionId) ?? null;
+    }
+    async persistState(executionId, data) {
+        const existing = this.executionStates.get(executionId);
+        const next = {
+            context: data.context,
+            currentStepIndex: data.currentStepIndex ?? existing?.currentStepIndex ?? 0,
+            pausePath: data.pausePath ?? null,
+        };
+        if (data.pauseType !== undefined) {
+            next.pauseType = data.pauseType;
+        }
+        this.executionStates.set(executionId, next);
+    }
+    // --- Step tracking ---
+    async upsertStep(executionId, stepName, data) {
+        const key = `${executionId}::${stepName}`;
+        this.steps.set(key, {
+            stepName,
+            status: data.status,
+            executorType: data.executorType,
+            data: data.data ?? null,
+        });
+    }
+    async getStepRows(executionId) {
+        const prefix = `${executionId}::`;
+        const result = [];
+        for (const [key, value] of this.steps) {
+            if (key.startsWith(prefix)) {
+                result.push(value);
+            }
+        }
+        return result;
+    }
+    async getStep(executionId, stepName) {
+        return this.steps.get(`${executionId}::${stepName}`) ?? null;
+    }
+    // --- Failure handling ---
+    async markFailed(executionId, _error) {
+        const exec = this.executions.get(executionId);
+        if (!exec)
+            return 'not-found';
+        if (exec.status === 'COMPLETED' || exec.status === 'FAILED') {
+            return 'skipped-terminal';
+        }
+        exec.status = 'FAILED';
+        return 'marked';
+    }
+    // --- Static data ---
+    async getStaticData(workflowId, key) {
+        return this.staticData.get(`${workflowId}::${key}`);
+    }
+    async setStaticData(workflowId, key, value) {
+        this.staticData.set(`${workflowId}::${key}`, value);
+    }
+    async deleteStaticData(workflowId, key) {
+        this.staticData.delete(`${workflowId}::${key}`);
+    }
+    // --- Step events ---
+    async appendStepEvent(executionId, stepName, event) {
+        const key = `${executionId}::${stepName}`;
+        let events = this.stepEvents.get(key);
+        if (!events) {
+            events = [];
+            this.stepEvents.set(key, events);
+        }
+        events.push({
+            id: this.genId(),
+            type: event.type,
+            data: event.data,
+            createdAt: new Date(),
+        });
+    }
+    async getStepEvents(executionId, stepName, after) {
+        const key = `${executionId}::${stepName}`;
+        const events = this.stepEvents.get(key) ?? [];
+        if (after) {
+            return events.filter((e) => e.createdAt > after);
+        }
+        return [...events];
+    }
+    // --- Credentials ---
+    async resolveCredential(_metadata, name) {
+        return this.credentials.get(name) ?? null;
+    }
+    async listCredentials(_metadata) {
+        return Array.from(this.credentials.entries()).map(([name, cred]) => ({
+            name,
+            type: cred.type,
+        }));
+    }
+    async storeCredential(_metadata, name, credential) {
+        this.credentials.set(name, credential);
+    }
+    async deleteCredential(_metadata, name) {
+        this.credentials.delete(name);
+    }
+    // --- Webhook registration ---
+    async storeWebhookPath(workflowId, path, secret) {
+        const record = { workflowId, path, secret };
+        this.webhooks.set(workflowId, record);
+        this.webhooksByPath.set(path, workflowId);
+    }
+    async removeWebhookPath(workflowId) {
+        const existing = this.webhooks.get(workflowId);
+        if (existing) {
+            this.webhooksByPath.delete(existing.path);
+            this.webhooks.delete(workflowId);
+        }
+    }
+    async getWebhookByPath(path) {
+        const workflowId = this.webhooksByPath.get(path);
+        if (!workflowId)
+            return null;
+        return this.webhooks.get(workflowId) ?? null;
+    }
+    // --- Resume payload ---
+    async persistResumePayload(executionId, payload) {
+        this.resumePayloads.set(executionId, payload);
+    }
+    async getResumePayload(executionId) {
+        const payload = this.resumePayloads.get(executionId) ?? null;
+        if (payload) {
+            this.resumePayloads.delete(executionId);
+        }
+        return payload;
+    }
+    // --- Workflow callback secret ---
+    async storeWorkflowCallback(record) {
+        // If a previous secret existed for this workflow, evict it from the
+        // reverse index so the old URL stops working immediately.
+        const existing = this.workflowCallbacks.get(record.workflowId);
+        if (existing) {
+            this.workflowCallbacksBySecret.delete(existing.secret);
+        }
+        this.workflowCallbacks.set(record.workflowId, record);
+        this.workflowCallbacksBySecret.set(record.secret, record.workflowId);
+    }
+    async getWorkflowCallbackBySecret(secret) {
+        const workflowId = this.workflowCallbacksBySecret.get(secret);
+        if (!workflowId)
+            return null;
+        return this.workflowCallbacks.get(workflowId) ?? null;
+    }
+    async getWorkflowCallback(workflowId) {
+        return this.workflowCallbacks.get(workflowId) ?? null;
+    }
+    async rotateWorkflowCallback(workflowId, newSecret) {
+        const record = {
+            workflowId,
+            secret: newSecret,
+            createdAt: new Date(),
+        };
+        await this.storeWorkflowCallback(record);
+        return record;
+    }
+    async removeWorkflowCallback(workflowId) {
+        const existing = this.workflowCallbacks.get(workflowId);
+        if (!existing)
+            return;
+        this.workflowCallbacks.delete(workflowId);
+        this.workflowCallbacksBySecret.delete(existing.secret);
+    }
+    // --- Test helpers ---
+    /** Seed a workflow record for testing. */
+    seedWorkflow(record) {
+        this.workflows.set(record.id, record);
+    }
+    /** Seed a credential for testing. */
+    seedCredential(name, cred) {
+        this.credentials.set(name, cred);
+    }
+    /** Clear all data. */
+    clear() {
+        this.workflows.clear();
+        this.executions.clear();
+        this.executionStates.clear();
+        this.steps.clear();
+        this.staticData.clear();
+        this.credentials.clear();
+        this.stepEvents.clear();
+        this.webhooks.clear();
+        this.webhooksByPath.clear();
+        this.resumePayloads.clear();
+        this.workflowCallbacks.clear();
+        this.workflowCallbacksBySecret.clear();
+    }
+}
+//# sourceMappingURL=in-memory-adapter.js.map

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

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

package/dist/persistence/types.d.ts

@@ -0,0 +1,214 @@
+/**
+ * Persistence interfaces for the workflow SDK.
+ *
+ * The runtime depends on these abstractions — hosts provide concrete
+ * implementations (Prisma, MongoDB, in-memory for testing, etc.).
+ */
+import type { ResumePayload } from '../common/resume-payload.js';
+/** What the engine stores about a workflow definition. */
+export interface WorkflowRecord {
+    id: string;
+    status: string;
+    /** JSON string — the full WorkflowConfig (trigger + steps + settings). */
+    config: string | null;
+    /** JSON string — host-defined metadata (description, name, etc.). */
+    metadata: string | null;
+    /** Maps to trigger type for event routing. */
+    eventType: string;
+}
+/** Webhook registration for a workflow. */
+export interface WebhookRecord {
+    workflowId: string;
+    /** URL path segment (e.g. '/webhooks/<workflowId>/<secret>'). */
+    path: string;
+    secret: string;
+}
+/**
+ * Stable wait-callback secret bound to a workflow.
+ *
+ * One row per workflow. The secret is generated at workflow create and
+ * remains stable across executions so authors can paste a single URL
+ * template into their external system's configuration:
+ *
+ *     POST {baseUrl}/wait/callback/{secret}/{executionId}
+ *
+ * The external system substitutes the per-execution `executionId` from
+ * whatever correlation token the workflow's HTTP step gave it. The runtime
+ * resolves `secret → workflowId` via this table, validates the execution
+ * belongs to that workflow, finds the paused step, and resumes.
+ *
+ * Mirrors the trigger-webhook security model: secret IS the lookup key,
+ * `Map.get` returns null on mismatch, no distinction leaked.
+ */
+export interface WorkflowCallbackRecord {
+    workflowId: string;
+    /** 192-bit hex string. Primary lookup key — the URL's bearer credential. */
+    secret: string;
+    createdAt: Date;
+}
+/** What the engine stores per execution run. */
+export interface ExecutionRecord {
+    id: string;
+    workflowId: string;
+    status: string;
+    createdAt: Date;
+    /** Set when this execution was created via `rerunFromStep()` — links to the source. */
+    sourceExecutionId?: string;
+}
+/**
+ * Why the execution is paused.
+ * - `step`: a step called `ctx.pause()` mid-execution (tool approval, input required, etc.)
+ * - `review`: the step completed successfully but `onComplete: 'review'` gated advancement
+ *
+ * Determines the resume path: `step` resumes via `onResume`, `review` either advances
+ * (approve) or re-executes the step (retry with feedback).
+ */
+export type ExecutionPauseType = 'step' | 'review';
+/** Execution state — separate from execution for size (context can be multi-MB). */
+export interface ExecutionStateRecord {
+    /** JSON string — full WorkflowContext snapshot. */
+    context: string | null;
+    currentStepIndex: number;
+    /** JSON string — PausePath for nested pause/resume. */
+    pausePath: string | null;
+    /** Why the execution is paused. Absent for non-paused executions. */
+    pauseType?: ExecutionPauseType;
+}
+/** Per-step tracking within an execution. */
+export interface StepRecord {
+    stepName: string;
+    status: string;
+    executorType: string;
+    /** JSON string — { type, input?, output, error?, statePatch? }. */
+    data: string | null;
+}
+export interface PersistenceAdapter {
+    getWorkflow(id: string): Promise<WorkflowRecord | null>;
+    listWorkflows(metadata: Record<string, unknown>): Promise<WorkflowRecord[]>;
+    findActiveWorkflows(eventType: string, metadata: Record<string, unknown>): Promise<WorkflowRecord[]>;
+    /** Create a new workflow definition. Returns the assigned workflow ID. */
+    createWorkflow(data: {
+        id?: string;
+        status: string;
+        config: string;
+        metadata: string;
+        eventType: string;
+    }): Promise<string>;
+    /** Update an existing workflow definition. */
+    updateWorkflow(id: string, data: {
+        status?: string;
+        config?: string;
+        metadata?: string;
+        eventType?: string;
+    }): Promise<void>;
+    createExecution(data: {
+        workflowId: string;
+        status: string;
+        /** Initial WorkflowContext as JSON. */
+        context: string;
+        /** Source execution this run was derived from (rerun). */
+        sourceExecutionId?: string;
+    }): Promise<string>;
+    updateExecutionStatus(executionId: string, status: string): Promise<void>;
+    getExecution(executionId: string): Promise<ExecutionRecord | null>;
+    listExecutions(params: {
+        workflowId?: string;
+        status?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        items: ExecutionRecord[];
+        nextCursor?: string;
+    }>;
+    getExecutionState(executionId: string): Promise<ExecutionStateRecord | null>;
+    persistState(executionId: string, data: {
+        context: string;
+        currentStepIndex?: number;
+        pausePath?: string;
+        pauseType?: ExecutionPauseType;
+    }): Promise<void>;
+    upsertStep(executionId: string, stepName: string, data: {
+        status: string;
+        executorType: string;
+        data?: string;
+    }): Promise<void>;
+    getStepRows(executionId: string): Promise<StepRecord[]>;
+    getStep(executionId: string, stepName: string): Promise<StepRecord | null>;
+    markFailed(executionId: string, error: string): Promise<'marked' | 'skipped-terminal' | 'not-found'>;
+    getStaticData(workflowId: string, key: string): Promise<unknown>;
+    setStaticData(workflowId: string, key: string, value: unknown): Promise<void>;
+    deleteStaticData(workflowId: string, key: string): Promise<void>;
+    appendStepEvent(executionId: string, stepName: string, event: {
+        type: string;
+        data: string;
+    }): Promise<void>;
+    getStepEvents(executionId: string, stepName: string, after?: Date): Promise<Array<{
+        id: string;
+        type: string;
+        data: string;
+        createdAt: Date;
+    }>>;
+    resolveCredential(metadata: Record<string, unknown>, name: string): Promise<{
+        type: string;
+        data: Record<string, unknown>;
+    } | null>;
+    listCredentials(metadata: Record<string, unknown>): Promise<Array<{
+        name: string;
+        type: string;
+    }>>;
+    storeCredential(metadata: Record<string, unknown>, name: string, credential: {
+        type: string;
+        data: Record<string, unknown>;
+    }): Promise<void>;
+    deleteCredential(metadata: Record<string, unknown>, name: string): Promise<void>;
+    /** Store a webhook path+secret for a workflow. */
+    storeWebhookPath(workflowId: string, path: string, secret: string): Promise<void>;
+    /** Remove the webhook registration for a workflow. */
+    removeWebhookPath(workflowId: string): Promise<void>;
+    /** Look up which workflow owns a given webhook path. */
+    getWebhookByPath(path: string): Promise<WebhookRecord | null>;
+    /** Store a resume payload for a paused execution. */
+    persistResumePayload(executionId: string, payload: ResumePayload): Promise<void>;
+    /** Retrieve and consume the resume payload (returns null if none). */
+    getResumePayload(executionId: string): Promise<ResumePayload | null>;
+    /**
+     * Store the workflow's callback secret. Called at workflow create / save
+     * so the UI can show a stable URL the author pastes into their external
+     * system. Mirrors {@link storeWebhookPath} — secret is the URL bearer
+     * credential AND the lookup key.
+     */
+    storeWorkflowCallback(record: WorkflowCallbackRecord): Promise<void>;
+    /**
+     * Look up the workflow that owns a callback secret. Returns null on
+     * mismatch — same semantics as {@link getWebhookByPath}, no distinction
+     * leaked between "wrong secret" and "no such workflow."
+     */
+    getWorkflowCallbackBySecret(secret: string): Promise<WorkflowCallbackRecord | null>;
+    /**
+     * Look up a workflow's callback record by workflow id. Used when the UI
+     * needs to display the URL template.
+     */
+    getWorkflowCallback(workflowId: string): Promise<WorkflowCallbackRecord | null>;
+    /**
+     * Replace the current secret with a new one. Returns the new record.
+     * Used by the rotate-secret UI affordance after a leak.
+     */
+    rotateWorkflowCallback(workflowId: string, newSecret: string): Promise<WorkflowCallbackRecord>;
+    /**
+     * Remove the callback registration. Called when the workflow itself is
+     * deleted (not on deactivate — the URL stays stable across activation
+     * cycles so external configurations don't break).
+     */
+    removeWorkflowCallback(workflowId: string): Promise<void>;
+}
+export interface QueueAdapter {
+    enqueue(data: {
+        executionId: string;
+        delay?: number;
+    }): Promise<void>;
+}
+export interface SchedulerAdapter {
+    schedule(workflowId: string, cronExpression: string, timezone?: string): Promise<void>;
+    unschedule(workflowId: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/persistence/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAIjE,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,uFAAuF;IACvF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnD,oFAAoF;AACpF,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qEAAqE;IACrE,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED,6CAA6C;AAC7C,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAID,MAAM,WAAW,kBAAkB;IAGjC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACxD,aAAa,CACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC7B,mBAAmB,CACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE7B,0EAA0E;IAC1E,cAAc,CAAC,IAAI,EAAE;QACnB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpB,8CAA8C;IAC9C,cAAc,CACZ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE;QACJ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,IAAI,CAAC,CAAC;IAIjB,eAAe,CAAC,IAAI,EAAE;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,uCAAuC;QACvC,OAAO,EAAE,MAAM,CAAC;QAChB,0DAA0D;QAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpB,qBAAqB,CACnB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,YAAY,CACV,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAEnC,cAAc,CAAC,MAAM,EAAE;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,eAAe,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAI/D,iBAAiB,CACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAExC,YAAY,CACV,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,kBAAkB,CAAC;KAChC,GACA,OAAO,CAAC,IAAI,CAAC,CAAC;IAIjB,UAAU,CACR,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GACA,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAExD,OAAO,CACL,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAI9B,UAAU,CACR,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,QAAQ,GAAG,kBAAkB,GAAG,WAAW,CAAC,CAAC;IAIxD,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAIjE,eAAe,CACb,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GACpC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,aAAa,CACX,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,IAAI,GACX,OAAO,CACR,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC,CACnE,CAAC;IAIF,iBAAiB,CACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAEnE,eAAe,CACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAElD,eAAe,CACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAC1D,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,gBAAgB,CACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAAC;IAIjB,kDAAkD;IAClD,gBAAgB,CACd,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,sDAAsD;IACtD,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD,wDAAwD;IACxD,gBAAgB,CACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAIjC,qDAAqD;IACrD,oBAAoB,CAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,sEAAsE;IACtE,gBAAgB,CACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAIjC;;;;;OAKG;IACH,qBAAqB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE;;;;OAIG;IACH,2BAA2B,CACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAE1C;;;OAGG;IACH,mBAAmB,CACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAE1C;;;OAGG;IACH,sBAAsB,CACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEnC;;;;OAIG;IACH,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAID,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAID,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C"}

package/dist/persistence/types.js

@@ -0,0 +1,8 @@
+/**
+ * Persistence interfaces for the workflow SDK.
+ *
+ * The runtime depends on these abstractions — hosts provide concrete
+ * implementations (Prisma, MongoDB, in-memory for testing, etc.).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/persistence/types.js.map

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

package/dist/router/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Router types — framework-agnostic request/response abstractions.
+ *
+ * The router produces plain handler functions. The host maps them to their
+ * HTTP framework (Express, Fastify, Hono, etc.) with minimal glue code.
+ */
+/**
+ * Extracted from the request by the host's `authenticate` function.
+ * The router passes this to every handler.
+ */
+export interface AuthContext {
+    userId: string;
+    /** Host-defined metadata — workspaceId, tenantId, etc. */
+    metadata: Record<string, unknown>;
+}
+export interface RouterOptions {
+    /**
+     * Extract auth context from request headers/cookies.
+     * Throw to reject the request (the router will catch and return 401).
+     */
+    authenticate: (headers: Record<string, string | string[] | undefined>) => AuthContext | Promise<AuthContext>;
+}
+/** The shape every route handler returns. */
+export interface RouteResponse {
+    status: number;
+    body: unknown;
+    headers?: Record<string, string>;
+    /** If present, the host should stream this as SSE instead of sending body as JSON. */
+    stream?: AsyncIterable<string>;
+}
+/** Parsed request data passed to handlers. */
+export interface RouteRequest {
+    params: Record<string, string>;
+    query: Record<string, string | string[] | undefined>;
+    body: unknown;
+    headers: Record<string, string | string[] | undefined>;
+    /**
+     * Populated by the host's multipart parser for file-upload routes.
+     * The framework never parses multipart itself — the host's middleware
+     * (multer, @fastify/multipart, Hono's parseBody, etc.) runs first and
+     * fills this array before the route handler is invoked.
+     */
+    files?: Array<{
+        name: string;
+        mimeType: string;
+        bytes: Uint8Array;
+    }>;
+}
+/** A single route definition. */
+export interface RouteDefinition {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    path: string;
+    /** Whether this route requires authentication. Defaults to true. */
+    authenticated?: boolean;
+    handler: (req: RouteRequest, auth: AuthContext | null) => Promise<RouteResponse>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/router/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAID,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,KAAK,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC9G;AAID,6CAA6C;AAC7C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,sFAAsF;IACtF,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACrD,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACvD;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;CACtE;AAED,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,CACP,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,WAAW,GAAG,IAAI,KACrB,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7B"}

package/dist/router/types.js

@@ -0,0 +1,8 @@
+/**
+ * Router types — framework-agnostic request/response abstractions.
+ *
+ * The router produces plain handler functions. The host maps them to their
+ * HTTP framework (Express, Fastify, Hono, etc.) with minimal glue code.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/router/types.js.map

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