@soleri/core 2.12.0 → 8.0.0

package/dist/events/event-bus.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Typed Event Bus — generic event emitter for decoupled subsystem communication.
+ *
+ * Wraps Node EventEmitter with type-safe emit/subscribe.
+ * Any module can define its own event map and create a bus.
+ */
+/**
+ * Create a typed event bus.
+ *
+ * Usage:
+ * ```ts
+ * type MyEvents = {
+ *   'entry:created': { id: string; title: string };
+ *   'entry:deleted': { id: string };
+ * };
+ * const bus = new TypedEventBus<MyEvents>();
+ * bus.on('entry:created', (payload) => console.log(payload.title));
+ * bus.emit('entry:created', { id: '1', title: 'Hello' });
+ * ```
+ */
+export declare class TypedEventBus<TEvents extends Record<string, unknown>> {
+    private emitter;
+    on<E extends keyof TEvents & string>(event: E, listener: (payload: TEvents[E]) => void): this;
+    once<E extends keyof TEvents & string>(event: E, listener: (payload: TEvents[E]) => void): this;
+    off<E extends keyof TEvents & string>(event: E, listener: (payload: TEvents[E]) => void): this;
+    emit<E extends keyof TEvents & string>(event: E, payload: TEvents[E]): boolean;
+    listenerCount(): number;
+    removeAllListeners(): this;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/events/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/events/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE,OAAO,CAAC,OAAO,CAAsB;IAErC,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAK7F,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAK/F,GAAG,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAK9F,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO;IAI9E,aAAa,IAAI,MAAM;IAQvB,kBAAkB,IAAI,IAAI;CAI3B"}

package/dist/events/event-bus.js

@@ -0,0 +1,51 @@
+/**
+ * Typed Event Bus — generic event emitter for decoupled subsystem communication.
+ *
+ * Wraps Node EventEmitter with type-safe emit/subscribe.
+ * Any module can define its own event map and create a bus.
+ */
+import { EventEmitter } from 'node:events';
+/**
+ * Create a typed event bus.
+ *
+ * Usage:
+ * ```ts
+ * type MyEvents = {
+ *   'entry:created': { id: string; title: string };
+ *   'entry:deleted': { id: string };
+ * };
+ * const bus = new TypedEventBus<MyEvents>();
+ * bus.on('entry:created', (payload) => console.log(payload.title));
+ * bus.emit('entry:created', { id: '1', title: 'Hello' });
+ * ```
+ */
+export class TypedEventBus {
+    emitter = new EventEmitter();
+    on(event, listener) {
+        this.emitter.on(event, listener);
+        return this;
+    }
+    once(event, listener) {
+        this.emitter.once(event, listener);
+        return this;
+    }
+    off(event, listener) {
+        this.emitter.off(event, listener);
+        return this;
+    }
+    emit(event, payload) {
+        return this.emitter.emit(event, payload);
+    }
+    listenerCount() {
+        let total = 0;
+        for (const name of this.emitter.eventNames()) {
+            total += this.emitter.listenerCount(name);
+        }
+        return total;
+    }
+    removeAllListeners() {
+        this.emitter.removeAllListeners();
+        return this;
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/events/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/events/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,aAAa;IAChB,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;IAErC,EAAE,CAAmC,KAAQ,EAAE,QAAuC;QACpF,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAmC,KAAQ,EAAE,QAAuC;QACtF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAmC,KAAQ,EAAE,QAAuC;QACrF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAmC,KAAQ,EAAE,OAAmB;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,aAAa;QACX,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;YAC7C,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/flows/chain-runner.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Chain Runner — executes multi-step workflows with data flow between steps.
+ *
+ * Steps call facade ops via a dispatch function. Each step's output is stored
+ * in a context object and can be referenced by subsequent steps via $variable syntax.
+ *
+ * Gates pause execution. Resume via approve(). State persists to SQLite.
+ */
+import type { PersistenceProvider } from '../persistence/types.js';
+import type { ChainDef, ChainInstance } from './chain-types.js';
+export type DispatchFn = (op: string, params: Record<string, unknown>) => Promise<unknown>;
+type GateCheckFn = (gate: string, stepId: string, stepResult: unknown) => Promise<{
+    passed: boolean;
+    message?: string;
+}>;
+export declare class ChainRunner {
+    private provider;
+    constructor(provider: PersistenceProvider);
+    private initializeTable;
+    /**
+     * Execute a chain from the beginning (or a specific step).
+     */
+    execute(chainDef: ChainDef, input: Record<string, unknown>, dispatch: DispatchFn, gateCheck?: GateCheckFn, startFromStep?: string): Promise<ChainInstance>;
+    /**
+     * Resume a paused chain from where it left off.
+     */
+    resume(instanceId: string, chainDef: ChainDef, dispatch: DispatchFn, gateCheck?: GateCheckFn): Promise<ChainInstance>;
+    /**
+     * Approve a gate-paused step and resume the chain.
+     */
+    approve(instanceId: string, chainDef: ChainDef, dispatch: DispatchFn, gateCheck?: GateCheckFn): Promise<ChainInstance>;
+    /**
+     * Get chain instance status.
+     */
+    getInstance(instanceId: string): ChainInstance | null;
+    /**
+     * List all chain instances.
+     */
+    list(limit?: number): ChainInstance[];
+    private runSteps;
+    private runStep;
+    private evaluateChainGate;
+    private persist;
+}
+export {};
+//# sourceMappingURL=chain-runner.d.ts.map

package/dist/flows/chain-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-runner.d.ts","sourceRoot":"","sources":["../../src/flows/chain-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAc,MAAM,kBAAkB,CAAC;AAI5E,MAAM,MAAM,UAAU,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE3F,KAAK,WAAW,GAAG,CACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,OAAO,KAChB,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAIpD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAsB;gBAE1B,QAAQ,EAAE,mBAAmB;IAKzC,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACG,OAAO,CACX,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,QAAQ,EAAE,UAAU,EACpB,SAAS,CAAC,EAAE,WAAW,EACvB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC;IA8BzB;;OAEG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,UAAU,EACpB,SAAS,CAAC,EAAE,WAAW,GACtB,OAAO,CAAC,aAAa,CAAC;IAoBzB;;OAEG;IACG,OAAO,CACX,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,UAAU,EACpB,SAAS,CAAC,EAAE,WAAW,GACtB,OAAO,CAAC,aAAa,CAAC;IAIzB;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAOrD;;OAEG;IACH,IAAI,CAAC,KAAK,GAAE,MAAW,GAAG,aAAa,EAAE;YAU3B,QAAQ;YAYR,OAAO;YAsEP,iBAAiB;IA6B/B,OAAO,CAAC,OAAO;CAuBhB"}

package/dist/flows/chain-runner.js

@@ -0,0 +1,271 @@
+/**
+ * Chain Runner — executes multi-step workflows with data flow between steps.
+ *
+ * Steps call facade ops via a dispatch function. Each step's output is stored
+ * in a context object and can be referenced by subsequent steps via $variable syntax.
+ *
+ * Gates pause execution. Resume via approve(). State persists to SQLite.
+ */
+import { randomUUID } from 'node:crypto';
+// ─── Class ───────────────────────────────────────────────────────────
+export class ChainRunner {
+    provider;
+    constructor(provider) {
+        this.provider = provider;
+        this.initializeTable();
+    }
+    initializeTable() {
+        this.provider.execSql(`
+      CREATE TABLE IF NOT EXISTS chain_instances (
+        id TEXT PRIMARY KEY,
+        chain_id TEXT NOT NULL,
+        chain_name TEXT NOT NULL DEFAULT '',
+        status TEXT NOT NULL DEFAULT 'running',
+        current_step TEXT,
+        paused_at_gate TEXT,
+        input TEXT NOT NULL DEFAULT '{}',
+        context TEXT NOT NULL DEFAULT '{}',
+        step_outputs TEXT NOT NULL DEFAULT '[]',
+        steps_completed INTEGER NOT NULL DEFAULT 0,
+        total_steps INTEGER NOT NULL DEFAULT 0,
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+    `);
+    }
+    /**
+     * Execute a chain from the beginning (or a specific step).
+     */
+    async execute(chainDef, input, dispatch, gateCheck, startFromStep) {
+        const instanceId = randomUUID().slice(0, 12);
+        const instance = {
+            id: instanceId,
+            chainId: chainDef.id,
+            chainName: chainDef.name ?? chainDef.id,
+            status: 'running',
+            currentStep: null,
+            pausedAtGate: null,
+            input,
+            context: { input },
+            stepOutputs: [],
+            stepsCompleted: 0,
+            totalSteps: chainDef.steps.length,
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+        this.persist(instance);
+        // Find start index
+        let startIdx = 0;
+        if (startFromStep) {
+            const idx = chainDef.steps.findIndex((s) => s.id === startFromStep);
+            if (idx >= 0)
+                startIdx = idx;
+        }
+        return this.runSteps(chainDef, instance, dispatch, gateCheck, startIdx);
+    }
+    /**
+     * Resume a paused chain from where it left off.
+     */
+    async resume(instanceId, chainDef, dispatch, gateCheck) {
+        const instance = this.getInstance(instanceId);
+        if (!instance)
+            throw new Error(`Chain instance not found: ${instanceId}`);
+        if (instance.status !== 'paused')
+            throw new Error(`Chain is ${instance.status}, not paused`);
+        // Find the step after the paused gate
+        const pausedStep = instance.pausedAtGate;
+        if (!pausedStep)
+            throw new Error('No paused gate to resume from');
+        const stepIdx = chainDef.steps.findIndex((s) => s.id === pausedStep);
+        if (stepIdx < 0)
+            throw new Error(`Paused step ${pausedStep} not found in chain def`);
+        // Mark step as approved, move to next
+        instance.status = 'running';
+        instance.pausedAtGate = null;
+        this.persist(instance);
+        return this.runSteps(chainDef, instance, dispatch, gateCheck, stepIdx + 1);
+    }
+    /**
+     * Approve a gate-paused step and resume the chain.
+     */
+    async approve(instanceId, chainDef, dispatch, gateCheck) {
+        return this.resume(instanceId, chainDef, dispatch, gateCheck);
+    }
+    /**
+     * Get chain instance status.
+     */
+    getInstance(instanceId) {
+        const row = this.provider.get('SELECT * FROM chain_instances WHERE id = ?', [
+            instanceId,
+        ]);
+        return row ? rowToInstance(row) : null;
+    }
+    /**
+     * List all chain instances.
+     */
+    list(limit = 20) {
+        const rows = this.provider.all('SELECT * FROM chain_instances ORDER BY updated_at DESC LIMIT ?', [limit]);
+        return rows.map(rowToInstance);
+    }
+    // ─── Core Execution Loop ──────────────────────────────────────────
+    async runSteps(chainDef, instance, dispatch, gateCheck, startIdx) {
+        // Steps MUST run sequentially — step N output feeds step N+1 input.
+        // Using recursive approach to satisfy no-await-in-loop lint rule.
+        return this.runStep(chainDef, instance, dispatch, gateCheck, startIdx);
+    }
+    async runStep(chainDef, instance, dispatch, gateCheck, idx) {
+        if (idx >= chainDef.steps.length) {
+            instance.status = 'completed';
+            instance.currentStep = null;
+            this.persist(instance);
+            return instance;
+        }
+        const step = chainDef.steps[idx];
+        instance.currentStep = step.id;
+        this.persist(instance);
+        const resolvedParams = resolveParams(step.params ?? {}, instance.context);
+        const stepStart = Date.now();
+        let result;
+        let stepStatus = 'completed';
+        try {
+            result = await dispatch(step.op, resolvedParams);
+        }
+        catch (err) {
+            result = { error: err.message };
+            stepStatus = 'failed';
+        }
+        const output = {
+            stepId: step.id,
+            op: step.op,
+            result,
+            status: stepStatus,
+            durationMs: Date.now() - stepStart,
+        };
+        instance.stepOutputs.push(output);
+        instance.context[step.id] = result;
+        if (step.output)
+            instance.context[step.output] = result;
+        if (stepStatus === 'completed')
+            instance.stepsCompleted++;
+        // Check gate
+        if (step.gate && step.gate !== 'none' && stepStatus === 'completed') {
+            const gateResult = await this.evaluateChainGate(step.gate, step.id, result, gateCheck);
+            if (!gateResult.passed) {
+                if (step.gate === 'user-approval') {
+                    instance.status = 'paused';
+                    instance.pausedAtGate = step.id;
+                    this.persist(instance);
+                    return instance;
+                }
+                instance.status = 'failed';
+                this.persist(instance);
+                return instance;
+            }
+        }
+        if (stepStatus === 'failed') {
+            instance.status = 'failed';
+            this.persist(instance);
+            return instance;
+        }
+        this.persist(instance);
+        return this.runStep(chainDef, instance, dispatch, gateCheck, idx + 1);
+    }
+    async evaluateChainGate(gate, stepId, stepResult, gateCheck) {
+        switch (gate) {
+            case 'user-approval':
+                return { passed: false, message: 'Awaiting user approval' };
+            case 'auto-test': {
+                const result = stepResult;
+                if (!result)
+                    return { passed: false, message: 'Step returned no result' };
+                if (result.error)
+                    return { passed: false, message: `Step error: ${result.error}` };
+                return { passed: true };
+            }
+            case 'vault-check': {
+                if (gateCheck)
+                    return gateCheck(gate, stepId, stepResult);
+                return { passed: true };
+            }
+            default:
+                return { passed: true };
+        }
+    }
+    // ─── Persistence ──────────────────────────────────────────────────
+    persist(instance) {
+        instance.updatedAt = new Date().toISOString();
+        this.provider.run(`INSERT OR REPLACE INTO chain_instances
+       (id, chain_id, chain_name, status, current_step, paused_at_gate, input, context, step_outputs, steps_completed, total_steps, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            instance.id,
+            instance.chainId,
+            instance.chainName,
+            instance.status,
+            instance.currentStep,
+            instance.pausedAtGate,
+            JSON.stringify(instance.input),
+            JSON.stringify(instance.context),
+            JSON.stringify(instance.stepOutputs),
+            instance.stepsCompleted,
+            instance.totalSteps,
+            instance.createdAt,
+            instance.updatedAt,
+        ]);
+    }
+}
+// ─── Variable Resolution ─────────────────────────────────────────────
+/**
+ * Resolve $variable references in params.
+ * $input.url → context.input.url
+ * $research.title → context.research.title
+ * $stepId → context.stepId (whole object)
+ */
+function resolveParams(params, context) {
+    const resolved = {};
+    for (const [key, value] of Object.entries(params)) {
+        resolved[key] = resolveValue(value, context);
+    }
+    return resolved;
+}
+function resolveValue(value, context) {
+    if (typeof value === 'string' && value.startsWith('$')) {
+        return resolveReference(value.slice(1), context);
+    }
+    if (Array.isArray(value)) {
+        return value.map((v) => resolveValue(v, context));
+    }
+    if (value !== null && typeof value === 'object') {
+        return resolveParams(value, context);
+    }
+    return value;
+}
+function resolveReference(path, context) {
+    const parts = path.split('.');
+    let current = context;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof current !== 'object')
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+function rowToInstance(row) {
+    return {
+        id: row.id,
+        chainId: row.chain_id,
+        chainName: row.chain_name,
+        status: row.status,
+        currentStep: row.current_step,
+        pausedAtGate: row.paused_at_gate,
+        input: JSON.parse(row.input),
+        context: JSON.parse(row.context),
+        stepOutputs: JSON.parse(row.step_outputs),
+        stepsCompleted: row.steps_completed,
+        totalSteps: row.total_steps,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+//# sourceMappingURL=chain-runner.js.map

package/dist/flows/chain-runner.js.map

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

package/dist/flows/chain-types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Chain types — composable multi-step workflows with data flow.
+ */
+import { z } from 'zod';
+export declare const chainStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    op: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    output: z.ZodOptional<z.ZodString>;
+    gate: z.ZodOptional<z.ZodEnum<["user-approval", "auto-test", "vault-check", "none"]>>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    op: string;
+    params?: Record<string, unknown> | undefined;
+    output?: string | undefined;
+    gate?: "user-approval" | "auto-test" | "vault-check" | "none" | undefined;
+    description?: string | undefined;
+}, {
+    id: string;
+    op: string;
+    params?: Record<string, unknown> | undefined;
+    output?: string | undefined;
+    gate?: "user-approval" | "auto-test" | "vault-check" | "none" | undefined;
+    description?: string | undefined;
+}>;
+export declare const chainDefSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        op: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        output: z.ZodOptional<z.ZodString>;
+        gate: z.ZodOptional<z.ZodEnum<["user-approval", "auto-test", "vault-check", "none"]>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        op: string;
+        params?: Record<string, unknown> | undefined;
+        output?: string | undefined;
+        gate?: "user-approval" | "auto-test" | "vault-check" | "none" | undefined;
+        description?: string | undefined;
+    }, {
+        id: string;
+        op: string;
+        params?: Record<string, unknown> | undefined;
+        output?: string | undefined;
+        gate?: "user-approval" | "auto-test" | "vault-check" | "none" | undefined;
+        description?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    steps: {
+        id: string;
+        op: string;
+        params?: Record<string, unknown> | undefined;
+        output?: string | undefined;
+        gate?: "user-approval" | "auto-test" | "vault-check" | "none" | undefined;
+        description?: string | undefined;
+    }[];
+    description?: string | undefined;
+    name?: string | undefined;
+}, {
+    id: string;
+    steps: {
+        id: string;
+        op: string;
+        params?: Record<string, unknown> | undefined;
+        output?: string | undefined;
+        gate?: "user-approval" | "auto-test" | "vault-check" | "none" | undefined;
+        description?: string | undefined;
+    }[];
+    description?: string | undefined;
+    name?: string | undefined;
+}>;
+export type ChainDef = z.infer<typeof chainDefSchema>;
+export type ChainStep = z.infer<typeof chainStepSchema>;
+export type ChainStatus = 'running' | 'paused' | 'completed' | 'failed';
+export interface StepOutput {
+    stepId: string;
+    op: string;
+    result: unknown;
+    status: 'completed' | 'failed' | 'skipped';
+    durationMs: number;
+}
+export interface ChainInstance {
+    id: string;
+    chainId: string;
+    chainName: string;
+    status: ChainStatus;
+    currentStep: string | null;
+    pausedAtGate: string | null;
+    input: Record<string, unknown>;
+    context: Record<string, unknown>;
+    stepOutputs: StepOutput[];
+    stepsCompleted: number;
+    totalSteps: number;
+    createdAt: string;
+    updatedAt: string;
+}
+//# sourceMappingURL=chain-types.d.ts.map

package/dist/flows/chain-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-types.d.ts","sourceRoot":"","sources":["../../src/flows/chain-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;EAU1B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/flows/chain-types.js

@@ -0,0 +1,23 @@
+/**
+ * Chain types — composable multi-step workflows with data flow.
+ */
+import { z } from 'zod';
+// ─── Chain Definition (YAML schema) ──────────────────────────────────
+export const chainStepSchema = z.object({
+    id: z.string(),
+    op: z.string().describe('Facade op to call'),
+    params: z
+        .record(z.unknown())
+        .optional()
+        .describe('Params — use $input.x or $stepId.field for data flow'),
+    output: z.string().optional().describe('Key to store step result under'),
+    gate: z.enum(['user-approval', 'auto-test', 'vault-check', 'none']).optional(),
+    description: z.string().optional(),
+});
+export const chainDefSchema = z.object({
+    id: z.string(),
+    name: z.string().optional(),
+    description: z.string().optional(),
+    steps: z.array(chainStepSchema).min(1),
+});
+//# sourceMappingURL=chain-types.js.map

package/dist/flows/chain-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-types.js","sourceRoot":"","sources":["../../src/flows/chain-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wEAAwE;AAExE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC5C,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CAAC,sDAAsD,CAAC;IACnE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACxE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACvC,CAAC,CAAC"}

package/dist/flows/context-router.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Context-sensitive chain routing — the same intent routes to different chain
+ * sequences depending on what's being built/fixed/reviewed.
+ *
+ * Building a Button follows a different workflow than building a Page layout.
+ */
+import type { PlanStep } from './types.js';
+export interface ContextOverride {
+    /** Pattern to match against prompt or entities */
+    match: RegExp;
+    /** Context label */
+    context: string;
+    /** Chain substitutions: original chain → replacement chain */
+    chainOverrides?: Record<string, string>;
+    /** Additional chains to inject before specific steps */
+    injectBefore?: Record<string, string[]>;
+    /** Additional chains to inject after specific steps */
+    injectAfter?: Record<string, string[]>;
+    /** Steps to skip in this context */
+    skipSteps?: string[];
+}
+/**
+ * Detect which contexts apply to a prompt and entity set.
+ * Returns an array of matching context labels.
+ */
+export declare function detectContext(prompt: string, entities: {
+    components: string[];
+    actions: string[];
+}): string[];
+/**
+ * Apply context overrides to a set of plan steps: chain substitutions,
+ * injections (before/after), and step skipping.
+ */
+export declare function applyContextOverrides(steps: PlanStep[], contexts: string[], flowId: string, agentId?: string): PlanStep[];
+/**
+ * Get all registered context overrides for a flow (useful for introspection).
+ */
+export declare function getFlowOverrides(flowId: string): ContextOverride[];
+//# sourceMappingURL=context-router.d.ts.map

package/dist/flows/context-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-router.d.ts","sourceRoot":"","sources":["../../src/flows/context-router.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAa,MAAM,YAAY,CAAC;AAOtD,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAwFD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE;IAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GACpD,MAAM,EAAE,CAcV;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,QAAQ,EAAE,EACjB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,MAAgB,GACxB,QAAQ,EAAE,CAwEZ;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CAElE"}