@plumbus/core 0.7.1 → 0.8.0-beta.0

package/dist/execution/transactional-outbox.d.ts

@@ -4,6 +4,10 @@ import type { EventRegistry } from '../events/registry.js';
 import type { AuditService } from '../types/audit.js';
 import type { CapabilityContract } from '../types/capability.js';
 import type { ExecutionContext, WithTransactionFn } from '../types/context.js';
+export interface DurableDispatchRunnerConfig {
+    /** Schema for Protocol A tables. Default `core_plumbus`. */
+    schemaName?: string;
+}
 export interface TransactionRunnerConfig {
     db: PostgresJsDatabase;
     entities: EntityRegistry;
@@ -14,6 +18,12 @@ export interface TransactionRunnerConfig {
     correlationId?: string;
     bypassTenantScope?: boolean;
     encryptionKey?: Buffer;
+    /**
+     * When set, the transaction scope can write `dispatch_outbox` (and
+     * persist-before-ack acceptance) in the same tenant transaction. Omitted,
+     * the runner is unchanged: handler + `event_outbox` only.
+     */
+    durableDispatch?: DurableDispatchRunnerConfig;
 }
 /**
  * Build a `withTransaction` hook that runs work inside `db.transaction`,

package/dist/execution/transactional-outbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transactional-outbox.d.ts","sourceRoot":"","sources":["../../src/execution/transactional-outbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAoB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGjG,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,kBAAkB,CAAC;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,MAAM,OAAO,sBAAsB,EAAE,WAAW,CAAC;IAC1D,QAAQ,EAAE,MAAM,YAAY,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAoD1F;AAOD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,kBAAkB,EAC9B,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAmBT;AAED,0EAA0E;AAC1E,qBAAa,+BAAgC,SAAQ,KAAK;IACxD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBAEb,MAAM,EAAE,OAAO;CAK5B"}
+{"version":3,"file":"transactional-outbox.d.ts","sourceRoot":"","sources":["../../src/execution/transactional-outbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAoB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGjG,MAAM,WAAW,2BAA2B;IAC1C,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,kBAAkB,CAAC;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,MAAM,OAAO,sBAAsB,EAAE,WAAW,CAAC;IAC1D,QAAQ,EAAE,MAAM,YAAY,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,eAAe,CAAC,EAAE,2BAA2B,CAAC;CAC/C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAsG1F;AAOD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,kBAAkB,EAC9B,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAmBT;AAED,0EAA0E;AAC1E,qBAAa,+BAAgC,SAAQ,KAAK;IACxD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBAEb,MAAM,EAAE,OAAO;CAK5B"}

package/dist/execution/transactional-outbox.js

@@ -5,7 +5,7 @@ import { CapabilityKind } from '../types/enums.js';
  * providing tx-scoped data + events while audit stays on the outer db.
  */
 export function createTransactionRunner(config) {
-    const { db, entities, events: eventRegistry, getAuth, getAudit, getCausationId, correlationId, bypassTenantScope, encryptionKey, } = config;
+    const { db, entities, events: eventRegistry, getAuth, getAudit, getCausationId, correlationId, bypassTenantScope, encryptionKey, durableDispatch, } = config;
     function createScope(tx) {
         const auth = getAuth();
         const audit = getAudit();
@@ -24,7 +24,46 @@ export function createTransactionRunner(config) {
             correlationId,
             getCausationId,
         });
-        return { data, events };
+        const scope = { data, events };
+        if (durableDispatch) {
+            const schemaName = durableDispatch.schemaName;
+            scope.persistAcceptance = async (input) => {
+                const { persistAcceptanceOnDb } = await import('../durable/postgres-persist.js');
+                const result = await persistAcceptanceOnDb(tx, {
+                    executionId: input.executionId,
+                    tenantRef: input.tenantRef,
+                    definitionId: input.definitionId,
+                    definitionVersion: input.definitionVersion,
+                    firstStepId: input.firstStepId,
+                    correlationId: input.correlationId,
+                    nowIso: input.nowIso ?? new Date().toISOString(),
+                }, schemaName);
+                return { executionId: result.execution.executionId, outboxId: result.outbox.outboxId };
+            };
+            scope.enqueueDispatch = async (input) => {
+                const { insertDispatchOutbox } = await import('../durable/postgres-persist.js');
+                const nowIso = input.nowIso ?? new Date().toISOString();
+                const outbox = await insertDispatchOutbox(tx, {
+                    executionId: input.executionId,
+                    stateRefId: input.stateRefId,
+                    tenantRef: input.tenantRef,
+                    revision: input.revision,
+                    tenantEpoch: input.tenantEpoch,
+                    status: 'running',
+                    definitionId: input.definitionId,
+                    definitionVersion: input.definitionVersion,
+                    currentStepId: input.stepId,
+                    stepIndex: 0,
+                    attempt: 0,
+                    correlationId: input.correlationId,
+                    createdAt: nowIso,
+                    updatedAt: nowIso,
+                    terminal: false,
+                }, input.stepId, nowIso, schemaName);
+                return { outboxId: outbox.outboxId };
+            };
+        }
+        return scope;
     }
     return async (fn) => {
         const deferred = [];

package/dist/execution/transactional-outbox.js.map

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

package/dist/flows/budget.d.ts

@@ -0,0 +1,44 @@
+import { BudgetExhaustedError } from '../errors/index.js';
+export declare const BUDGET_STATE_KEY = "__budget";
+export declare const BUDGET_EXHAUSTED = "budget-exhausted";
+export { BudgetExhaustedError };
+/** Per-execution ledger (recovery.schema BudgetLedger v1 subset). */
+export interface ExecutionBudgetAmount {
+    dimensionId: string;
+    unitId: string;
+    allocated: number;
+    consumed: number;
+    reserved: number;
+}
+export interface ExecutionBudgetLedger {
+    contractVersion: '0.1.0';
+    budgetLedgerId: string;
+    executionId: string;
+    budgetProfileId: string;
+    state: 'active' | 'exhausted' | 'closed';
+    amounts: ExecutionBudgetAmount[];
+    revision: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export type { FlowBudget } from '../types/flow.js';
+export declare function createExecutionBudgetLedger(input: {
+    executionId: string;
+    profileId: string;
+    allocated: number;
+    unitId?: string;
+    dimensionId?: string;
+    now?: Date;
+}): ExecutionBudgetLedger;
+export declare function readExecutionBudget(state: unknown): ExecutionBudgetLedger | undefined;
+export declare function writeExecutionBudget(state: unknown, ledger: ExecutionBudgetLedger): Record<string, unknown>;
+export declare function chargeExecutionBudget(ledger: ExecutionBudgetLedger, amount: number, now?: Date): ExecutionBudgetLedger;
+/**
+ * Charge one unit from `state.__budget` when a ledger is present.
+ * Returns null when the flow has no budget (no-op).
+ */
+export declare function consumeExecutionBudget(state: unknown, amount?: number): {
+    state: Record<string, unknown>;
+    exhausted: boolean;
+} | null;
+//# sourceMappingURL=budget.d.ts.map

package/dist/flows/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/flows/budget.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAC3C,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAEhC,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IACzC,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,qBAAqB,CAqBxB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,GAAG,SAAS,CAOrF;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,qBAAqB,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,MAAM,EACd,GAAG,OAAa,GACf,qBAAqB,CAoBvB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,MAAM,SAAI,GACT;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAQ/D"}

package/dist/flows/budget.js

@@ -0,0 +1,81 @@
+import { randomUUID } from 'node:crypto';
+import { BudgetExhaustedError } from '../errors/index.js';
+export const BUDGET_STATE_KEY = '__budget';
+export const BUDGET_EXHAUSTED = 'budget-exhausted';
+export { BudgetExhaustedError };
+export function createExecutionBudgetLedger(input) {
+    const now = (input.now ?? new Date()).toISOString();
+    return {
+        contractVersion: '0.1.0',
+        budgetLedgerId: randomUUID(),
+        executionId: input.executionId,
+        budgetProfileId: input.profileId,
+        state: input.allocated <= 0 ? 'exhausted' : 'active',
+        amounts: [
+            {
+                dimensionId: input.dimensionId ?? 'plumbus.execution.step',
+                unitId: input.unitId ?? 'plumbus.unit.step',
+                allocated: input.allocated,
+                consumed: 0,
+                reserved: 0,
+            },
+        ],
+        revision: 1,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+export function readExecutionBudget(state) {
+    if (!state || typeof state !== 'object' || Array.isArray(state))
+        return undefined;
+    const ledger = state[BUDGET_STATE_KEY];
+    if (!ledger || typeof ledger !== 'object' || Array.isArray(ledger))
+        return undefined;
+    const typed = ledger;
+    if (typed.contractVersion !== '0.1.0' || !Array.isArray(typed.amounts))
+        return undefined;
+    return typed;
+}
+export function writeExecutionBudget(state, ledger) {
+    const base = state && typeof state === 'object' && !Array.isArray(state)
+        ? { ...state }
+        : {};
+    base[BUDGET_STATE_KEY] = ledger;
+    return base;
+}
+export function chargeExecutionBudget(ledger, amount, now = new Date()) {
+    const primary = ledger.amounts[0];
+    if (!primary) {
+        return {
+            ...ledger,
+            state: 'exhausted',
+            revision: ledger.revision + 1,
+            updatedAt: now.toISOString(),
+        };
+    }
+    const nextConsumed = primary.consumed + amount;
+    const next = { ...primary, consumed: nextConsumed };
+    const exhausted = nextConsumed > primary.allocated;
+    return {
+        ...ledger,
+        amounts: [next, ...ledger.amounts.slice(1)],
+        state: exhausted ? 'exhausted' : ledger.state,
+        revision: ledger.revision + 1,
+        updatedAt: now.toISOString(),
+    };
+}
+/**
+ * Charge one unit from `state.__budget` when a ledger is present.
+ * Returns null when the flow has no budget (no-op).
+ */
+export function consumeExecutionBudget(state, amount = 1) {
+    const ledger = readExecutionBudget(state);
+    if (!ledger)
+        return null;
+    if (ledger.state === 'exhausted' || ledger.state === 'closed') {
+        return { state: writeExecutionBudget(state, ledger), exhausted: true };
+    }
+    const next = chargeExecutionBudget(ledger, amount);
+    return { state: writeExecutionBudget(state, next), exhausted: next.state === 'exhausted' };
+}
+//# sourceMappingURL=budget.js.map

package/dist/flows/budget.js.map

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

package/dist/flows/compile-flow.d.ts

@@ -0,0 +1,23 @@
+import type { CompiledFlowDefinition, FlowDefinition } from '../types/flow.js';
+export declare const COMPILED_FLOW_CONTRACT_VERSION: "0.1.0";
+/** SHA-256 of canonical JSON (key-sorted). Used for definition and binding digests. */
+export declare function digestCanonicalJson(value: unknown): string;
+/** Stable identity: `{domain}.{name}`. */
+export declare function flowDefinitionId(flow: {
+    domain: string;
+    name: string;
+}): string;
+export interface CompileFlowOptions {
+    definitionVersion?: string;
+}
+/**
+ * Compile a live `defineFlow` object into a signed artifact.
+ * Recompiling an identical flow yields the same `definitionDigest`.
+ */
+export declare function compileFlowDefinition(flow: FlowDefinition, options?: CompileFlowOptions): CompiledFlowDefinition;
+/**
+ * Reconstruct live `FlowStep[]` from a compiled artifact, keeping Zod
+ * schemas and metadata from the authoring `FlowDefinition`.
+ */
+export declare function hydrateCompiledFlow(compiled: CompiledFlowDefinition, authoring: FlowDefinition): FlowDefinition;
+//# sourceMappingURL=compile-flow.d.ts.map

package/dist/flows/compile-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-flow.d.ts","sourceRoot":"","sources":["../../src/flows/compile-flow.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAEV,sBAAsB,EAEtB,cAAc,EAEf,MAAM,kBAAkB,CAAC;AAE1B,eAAO,MAAM,8BAA8B,EAAG,OAAgB,CAAC;AAiB/D,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG1D;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE/E;AAuED,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,sBAAsB,CAwBxB;AAUD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,sBAAsB,EAChC,SAAS,EAAE,cAAc,GACxB,cAAc,CAsDhB"}

package/dist/flows/compile-flow.js

@@ -0,0 +1,176 @@
+// Compile defineFlow authoring objects into a signed FlowDefinition JSON
+// artifact. Inline condition expressions and step IO mappings are hoisted
+// into individually digested bindings.
+// The existing flow engine hydrates these back to FlowStep[] — this is
+// not a second workflow engine.
+import { createHash } from 'node:crypto';
+import { FlowStepType } from '../types/enums.js';
+export const COMPILED_FLOW_CONTRACT_VERSION = '0.1.0';
+function sortKeys(value) {
+    if (Array.isArray(value)) {
+        return value.map(sortKeys);
+    }
+    if (value !== null && typeof value === 'object') {
+        const record = value;
+        const sorted = {};
+        for (const key of Object.keys(record).sort()) {
+            sorted[key] = sortKeys(record[key]);
+        }
+        return sorted;
+    }
+    return value;
+}
+/** SHA-256 of canonical JSON (key-sorted). Used for definition and binding digests. */
+export function digestCanonicalJson(value) {
+    const json = JSON.stringify(sortKeys(value));
+    return createHash('sha256').update(json).digest('hex');
+}
+/** Stable identity: `{domain}.{name}`. */
+export function flowDefinitionId(flow) {
+    return `${flow.domain}.${flow.name}`;
+}
+function bindingId(id, kind, stepName) {
+    return `${id}:${kind}:${stepName}`;
+}
+function hoistBinding(bindings, id, kind, stepName, source) {
+    const compiled = {
+        bindingId: bindingId(id, kind, stepName),
+        kind,
+        source,
+        digest: digestCanonicalJson(source),
+    };
+    bindings.push(compiled);
+    return compiled.bindingId;
+}
+function compileStep(step, id, bindings) {
+    const compiled = { name: step.name, type: step.type };
+    if (step.type === FlowStepType.Capability) {
+        if (step.capability)
+            compiled.capability = step.capability;
+        if (step.compensate)
+            compiled.compensate = step.compensate;
+        if (step.input) {
+            compiled.inputBindingId = hoistBinding(bindings, id, 'input-mapping', step.name, JSON.stringify(sortKeys(step.input)));
+        }
+        return compiled;
+    }
+    if (step.type === FlowStepType.Conditional) {
+        compiled.conditionBindingId = hoistBinding(bindings, id, 'condition', step.name, step.if);
+        compiled.then = step.then;
+        if (step.else)
+            compiled.else = step.else;
+        return compiled;
+    }
+    if (step.type === FlowStepType.Wait || step.type === FlowStepType.EventEmit) {
+        compiled.event = step.event;
+        return compiled;
+    }
+    if (step.type === FlowStepType.Delay) {
+        compiled.duration = step.duration;
+        return compiled;
+    }
+    if (step.type === FlowStepType.Parallel) {
+        compiled.branches = [...step.branches];
+        return compiled;
+    }
+    if (step.type === FlowStepType.ApprovalOutcome) {
+        compiled.outcomes = { ...step.outcomes };
+        return compiled;
+    }
+    return compiled;
+}
+/**
+ * Compile a live `defineFlow` object into a signed artifact.
+ * Recompiling an identical flow yields the same `definitionDigest`.
+ */
+export function compileFlowDefinition(flow, options) {
+    const id = flowDefinitionId(flow);
+    const definitionVersion = options?.definitionVersion ?? flow.version ?? '1';
+    const bindings = [];
+    const steps = flow.steps.map((step) => compileStep(step, id, bindings));
+    const unsigned = {
+        contractVersion: COMPILED_FLOW_CONTRACT_VERSION,
+        flowDefinitionId: id,
+        definitionVersion,
+        domain: flow.domain,
+        name: flow.name,
+        steps,
+        bindings,
+    };
+    if (flow.description)
+        unsigned.description = flow.description;
+    if (flow.trigger)
+        unsigned.trigger = flow.trigger;
+    if (flow.schedule)
+        unsigned.schedule = flow.schedule;
+    if (flow.retry)
+        unsigned.retry = flow.retry;
+    return {
+        ...unsigned,
+        definitionDigest: digestCanonicalJson(unsigned),
+    };
+}
+function bindingSource(compiled, bindingId) {
+    if (!bindingId)
+        return undefined;
+    return compiled.bindings.find((b) => b.bindingId === bindingId)?.source;
+}
+/**
+ * Reconstruct live `FlowStep[]` from a compiled artifact, keeping Zod
+ * schemas and metadata from the authoring `FlowDefinition`.
+ */
+export function hydrateCompiledFlow(compiled, authoring) {
+    const steps = compiled.steps.map((step) => {
+        if (step.type === FlowStepType.Capability) {
+            const source = bindingSource(compiled, step.inputBindingId);
+            return {
+                name: step.name,
+                type: FlowStepType.Capability,
+                ...(step.capability ? { capability: step.capability } : {}),
+                ...(step.compensate ? { compensate: step.compensate } : {}),
+                ...(source ? { input: JSON.parse(source) } : {}),
+            };
+        }
+        if (step.type === FlowStepType.Conditional) {
+            return {
+                name: step.name,
+                type: FlowStepType.Conditional,
+                if: bindingSource(compiled, step.conditionBindingId) ?? '',
+                then: step.then ?? '',
+                ...(step.else ? { else: step.else } : {}),
+            };
+        }
+        if (step.type === FlowStepType.Wait) {
+            return { name: step.name, type: FlowStepType.Wait, event: step.event ?? '' };
+        }
+        if (step.type === FlowStepType.EventEmit) {
+            return { name: step.name, type: FlowStepType.EventEmit, event: step.event ?? '' };
+        }
+        if (step.type === FlowStepType.Delay) {
+            return { name: step.name, type: FlowStepType.Delay, duration: step.duration ?? '0s' };
+        }
+        if (step.type === FlowStepType.Parallel) {
+            return { name: step.name, type: FlowStepType.Parallel, branches: step.branches ?? [] };
+        }
+        if (step.type === FlowStepType.ApprovalOutcome) {
+            return {
+                name: step.name,
+                type: FlowStepType.ApprovalOutcome,
+                outcomes: step.outcomes ?? {},
+            };
+        }
+        return { name: step.name, type: FlowStepType.Capability };
+    });
+    return {
+        ...authoring,
+        name: compiled.name,
+        domain: compiled.domain,
+        description: compiled.description ?? authoring.description,
+        steps,
+        trigger: compiled.trigger ?? authoring.trigger,
+        schedule: compiled.schedule ?? authoring.schedule,
+        retry: compiled.retry ?? authoring.retry,
+        version: compiled.definitionVersion,
+    };
+}
+//# sourceMappingURL=compile-flow.js.map

package/dist/flows/compile-flow.js.map

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

package/dist/flows/compiled-registry.d.ts

@@ -0,0 +1,43 @@
+import type { CompiledFlowDefinition } from '../types/flow.js';
+/** Project-relative default used by `plumbus compile-flows` and boot load. */
+export declare const DEFAULT_COMPILED_FLOWS_DIRECTORY = ".plumbus/compiled-flows";
+export declare class CompiledFlowRegistry {
+    private readonly versions;
+    private readonly publishOrder;
+    /**
+     * Publish a compiled definition. Same version + same digest is a no-op.
+     * Same version + different digest is rejected (immutable retain-all).
+     */
+    publish(compiled: CompiledFlowDefinition): void;
+    get(flowDefinitionId: string, definitionVersion: string): CompiledFlowDefinition | undefined;
+    /** Most recently published version for this id (not semver-max). */
+    getLatest(flowDefinitionId: string): CompiledFlowDefinition | undefined;
+    listVersions(flowDefinitionId: string): string[];
+}
+/**
+ * Parse one signed artifact. Recomputes `definitionDigest` and refuses a
+ * mismatch so a tampered file cannot enter the registry.
+ */
+export declare function parseCompiledFlowArtifact(value: unknown, fileName?: string): CompiledFlowDefinition;
+/**
+ * Load signed JSON from a host-owned directory (the `plumbus compile-flows`
+ * output). Each file is digest-checked; a mismatch refuses the whole load.
+ */
+export declare function loadCompiledFlowRegistryFromDirectory(directory: string): CompiledFlowRegistry;
+/**
+ * Same as `loadCompiledFlowRegistryFromDirectory`, but a missing or empty
+ * directory is "not configured" (`undefined`) so live TypeScript flows stay
+ * on. A directory that exists with invalid JSON still throws.
+ */
+export declare function tryLoadCompiledFlowRegistryFromDirectory(directory: string): CompiledFlowRegistry | undefined;
+export interface ResolveCompiledFlowRegistryOptions {
+    compiledRegistry?: CompiledFlowRegistry;
+    compiledFlowsDirectory?: string;
+    cwd?: string;
+}
+/**
+ * Prefer an explicit registry. Else load `compiledFlowsDirectory` (required
+ * when set). Else try `{cwd}/.plumbus/compiled-flows` when that tree has JSON.
+ */
+export declare function resolveCompiledFlowRegistry(options?: ResolveCompiledFlowRegistryOptions): CompiledFlowRegistry | undefined;
+//# sourceMappingURL=compiled-registry.d.ts.map

package/dist/flows/compiled-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiled-registry.d.ts","sourceRoot":"","sources":["../../src/flows/compiled-registry.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE/D,8EAA8E;AAC9E,eAAO,MAAM,gCAAgC,4BAA4B,CAAC;AAE1E,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0D;IACnF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAE5D;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IA4B/C,GAAG,CAAC,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAI5F,oEAAoE;IACpE,SAAS,CAAC,gBAAgB,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAKvE,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,EAAE;CAGjD;AAwBD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,QAAQ,SAAuB,GAC9B,sBAAsB,CA6CxB;AA6BD;;;GAGG;AACH,wBAAgB,qCAAqC,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,CAc7F;AAED;;;;GAIG;AACH,wBAAgB,wCAAwC,CACtD,SAAS,EAAE,MAAM,GAChB,oBAAoB,GAAG,SAAS,CAkBlC;AAED,MAAM,WAAW,kCAAkC;IACjD,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,kCAAuC,GAC/C,oBAAoB,GAAG,SAAS,CAiBlC"}