@soleri/core 2.12.0 → 8.0.0

package/dist/flows/context-router.js

@@ -0,0 +1,206 @@
+/**
+ * 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 { chainToToolName, chainToRequires } from './plan-builder.js';
+// ---------------------------------------------------------------------------
+// Context override definitions
+// ---------------------------------------------------------------------------
+const BUILD_OVERRIDES = [
+    {
+        match: /\b(button|icon|badge|chip|tag|pill)\b/i,
+        context: 'small-component',
+        skipSteps: ['get-architecture'],
+        injectBefore: {
+            validate: ['button-semantics-check'],
+        },
+    },
+    {
+        match: /\b(page|layout|dashboard|screen|view)\b/i,
+        context: 'large-component',
+        injectBefore: {
+            validate: ['responsive-patterns'],
+        },
+        injectAfter: {
+            validate: ['performance-check'],
+        },
+    },
+    {
+        match: /\b(form|input|select|textarea|checkbox|radio|switch|dropdown)\b/i,
+        context: 'form-component',
+        injectBefore: {
+            validate: ['defensive-design', 'accessibility-precheck'],
+        },
+    },
+    {
+        match: /\b(modal|dialog|sheet|drawer|popover|overlay|tooltip)\b/i,
+        context: 'container-component',
+        injectBefore: {
+            validate: ['container-pattern-check', 'dialog-patterns'],
+        },
+    },
+];
+const FIX_OVERRIDES = [
+    {
+        match: /\b(styl(e|ing)|color|token|theme|palette|css)\b/i,
+        context: 'design-fix',
+        injectBefore: {
+            validate: ['contrast-check', 'token-validation'],
+        },
+    },
+    {
+        match: /\b(accessib|a11y|aria|screen.?reader|keyboard|focus)\b/i,
+        context: 'a11y-fix',
+        injectBefore: {
+            validate: ['accessibility-audit'],
+        },
+    },
+];
+const REVIEW_OVERRIDES = [
+    {
+        match: /\b(pr|pull.?request|diff|merge)\b/i,
+        context: 'pr-review',
+        injectAfter: {
+            'check-rules': ['review-pr-design'],
+        },
+    },
+    {
+        match: /\b(architecture|import|dependency|structure)\b/i,
+        context: 'architecture-review',
+        injectAfter: {
+            'check-rules': ['check-architecture'],
+        },
+    },
+];
+/**
+ * Registry mapping flow IDs to their context overrides.
+ */
+const FLOW_OVERRIDES = {
+    'BUILD-flow': BUILD_OVERRIDES,
+    'FIX-flow': FIX_OVERRIDES,
+    'REVIEW-flow': REVIEW_OVERRIDES,
+};
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Detect which contexts apply to a prompt and entity set.
+ * Returns an array of matching context labels.
+ */
+export function detectContext(prompt, entities) {
+    const contexts = [];
+    const searchText = [prompt, ...entities.components, ...entities.actions].join(' ');
+    // Check all flow overrides — a prompt might match contexts across flows
+    for (const overrides of Object.values(FLOW_OVERRIDES)) {
+        for (const override of overrides) {
+            if (override.match.test(searchText) && !contexts.includes(override.context)) {
+                contexts.push(override.context);
+            }
+        }
+    }
+    return contexts;
+}
+/**
+ * Apply context overrides to a set of plan steps: chain substitutions,
+ * injections (before/after), and step skipping.
+ */
+export function applyContextOverrides(steps, contexts, flowId, agentId = 'agent') {
+    const overrides = FLOW_OVERRIDES[flowId];
+    if (!overrides || contexts.length === 0)
+        return steps;
+    // Collect active overrides for the detected contexts
+    const active = overrides.filter((o) => contexts.includes(o.context));
+    if (active.length === 0)
+        return steps;
+    // Aggregate all skip, inject-before, inject-after, and chain overrides
+    const skipSet = new Set();
+    const injectBefore = new Map();
+    const injectAfter = new Map();
+    const chainSubs = new Map();
+    for (const ov of active) {
+        if (ov.skipSteps)
+            ov.skipSteps.forEach((s) => skipSet.add(s));
+        if (ov.injectBefore) {
+            for (const [stepId, chains] of Object.entries(ov.injectBefore)) {
+                const existing = injectBefore.get(stepId) ?? [];
+                injectBefore.set(stepId, [...existing, ...chains]);
+            }
+        }
+        if (ov.injectAfter) {
+            for (const [stepId, chains] of Object.entries(ov.injectAfter)) {
+                const existing = injectAfter.get(stepId) ?? [];
+                injectAfter.set(stepId, [...existing, ...chains]);
+            }
+        }
+        if (ov.chainOverrides) {
+            for (const [from, to] of Object.entries(ov.chainOverrides)) {
+                chainSubs.set(from, to);
+            }
+        }
+    }
+    const result = [];
+    for (const step of steps) {
+        // 1. Skip steps
+        if (skipSet.has(step.id))
+            continue;
+        // 2. Inject before
+        const beforeChains = injectBefore.get(step.id);
+        if (beforeChains) {
+            result.push(buildInjectedStep(step.id, 'before', beforeChains, agentId));
+        }
+        // 3. Apply chain substitutions to existing step
+        let processed = step;
+        if (chainSubs.size > 0) {
+            const newTools = step.tools.map((tool) => {
+                for (const [from, to] of chainSubs) {
+                    const fromTool = chainToToolName(from, agentId);
+                    if (tool === fromTool)
+                        return chainToToolName(to, agentId);
+                }
+                return tool;
+            });
+            if (newTools.some((t, i) => t !== step.tools[i])) {
+                processed = { ...step, tools: newTools };
+            }
+        }
+        result.push(processed);
+        // 4. Inject after
+        const afterChains = injectAfter.get(step.id);
+        if (afterChains) {
+            result.push(buildInjectedStep(step.id, 'after', afterChains, agentId));
+        }
+    }
+    return result;
+}
+/**
+ * Get all registered context overrides for a flow (useful for introspection).
+ */
+export function getFlowOverrides(flowId) {
+    return FLOW_OVERRIDES[flowId] ?? [];
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Build a synthetic PlanStep from injected chains.
+ */
+function buildInjectedStep(anchorStepId, position, chains, agentId) {
+    const tools = chains.map((c) => chainToToolName(c, agentId));
+    const requires = [];
+    for (const chain of chains) {
+        const req = chainToRequires(chain);
+        if (req && !requires.includes(req))
+            requires.push(req);
+    }
+    return {
+        id: `ctx-${position}-${anchorStepId}`,
+        name: `Context: ${chains.join(', ')} (${position} ${anchorStepId})`,
+        tools,
+        parallel: chains.length > 1,
+        requires,
+        status: 'pending',
+    };
+}
+//# sourceMappingURL=context-router.js.map

package/dist/flows/context-router.js.map

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

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

@@ -0,0 +1,24 @@
+/**
+ * Dispatch registry — maps tool names to real facade op handlers.
+ *
+ * Tool names follow the convention: `{agentId}_{facadeName}_{opName}`
+ * e.g. "myagent_vault_search" → facade "myagent_vault", op "search".
+ */
+import type { FacadeConfig } from '../facades/types.js';
+type DispatchResult = {
+    tool: string;
+    status: string;
+    data?: unknown;
+    error?: string;
+};
+type DispatchFn = (toolName: string, params: Record<string, unknown>) => Promise<DispatchResult>;
+/**
+ * Create a dispatcher function that routes tool calls to the correct facade op.
+ *
+ * @param agentId - Agent identifier prefix (e.g. "myagent")
+ * @param facades - Array of registered facade configs
+ * @returns A dispatch function that takes (toolName, params) and calls the matching handler
+ */
+export declare function createDispatcher(agentId: string, facades: FacadeConfig[]): DispatchFn;
+export {};
+//# sourceMappingURL=dispatch-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-registry.d.ts","sourceRoot":"","sources":["../../src/flows/dispatch-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,KAAK,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACvF,KAAK,UAAU,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAEjG;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,UAAU,CA4DrF"}

package/dist/flows/dispatch-registry.js

@@ -0,0 +1,70 @@
+/**
+ * Dispatch registry — maps tool names to real facade op handlers.
+ *
+ * Tool names follow the convention: `{agentId}_{facadeName}_{opName}`
+ * e.g. "myagent_vault_search" → facade "myagent_vault", op "search".
+ */
+/**
+ * Create a dispatcher function that routes tool calls to the correct facade op.
+ *
+ * @param agentId - Agent identifier prefix (e.g. "myagent")
+ * @param facades - Array of registered facade configs
+ * @returns A dispatch function that takes (toolName, params) and calls the matching handler
+ */
+export function createDispatcher(agentId, facades) {
+    // Build a lookup map: facadeName → { opName → handler }
+    const facadeMap = new Map();
+    for (const facade of facades) {
+        facadeMap.set(facade.name, facade);
+    }
+    return async (toolName, params) => {
+        const prefix = `${agentId}_`;
+        // Strip agent prefix if present
+        const unprefixed = toolName.startsWith(prefix) ? toolName.slice(prefix.length) : toolName;
+        // Try progressively longer facade name prefixes.
+        // E.g. for "vault_extra_search": try "vault_extra_search", "vault_extra", "vault"
+        const parts = unprefixed.split('_');
+        for (let splitAt = parts.length - 1; splitAt >= 1; splitAt--) {
+            const facadeSuffix = parts.slice(0, splitAt).join('_');
+            const opName = parts.slice(splitAt).join('_');
+            const facadeFullName = `${prefix}${facadeSuffix}`;
+            const facade = facadeMap.get(facadeFullName);
+            if (!facade)
+                continue;
+            const op = facade.ops.find((o) => o.name === opName);
+            if (!op)
+                continue;
+            try {
+                const result = await op.handler(params);
+                return { tool: toolName, status: 'ok', data: result };
+            }
+            catch (err) {
+                return {
+                    tool: toolName,
+                    status: 'error',
+                    error: err instanceof Error ? err.message : String(err),
+                };
+            }
+        }
+        // Also try matching the full unprefixed name as a facade with "op" from params
+        const facade = facadeMap.get(`${prefix}${unprefixed}`);
+        if (facade && params.op && typeof params.op === 'string') {
+            const op = facade.ops.find((o) => o.name === params.op);
+            if (op) {
+                try {
+                    const result = await op.handler(params);
+                    return { tool: toolName, status: 'ok', data: result };
+                }
+                catch (err) {
+                    return {
+                        tool: toolName,
+                        status: 'error',
+                        error: err instanceof Error ? err.message : String(err),
+                    };
+                }
+            }
+        }
+        return { tool: toolName, status: 'unregistered' };
+    };
+}
+//# sourceMappingURL=dispatch-registry.js.map

package/dist/flows/dispatch-registry.js.map

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

package/dist/flows/epilogue.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Epilogue — post-execution cleanup: capture knowledge and session summary.
+ * All operations are resilient (errors are caught, never propagated).
+ */
+import type { ProbeResults } from './types.js';
+type DispatchFn = (toolName: string, params: Record<string, unknown>) => Promise<{
+    tool: string;
+    status: string;
+    data?: unknown;
+    error?: string;
+}>;
+/**
+ * Run post-execution epilogue steps.
+ * - Captures knowledge to vault (if available)
+ * - Captures session summary (if session store available)
+ *
+ * @returns Whether anything was captured and an optional session ID.
+ */
+export declare function runEpilogue(dispatch: DispatchFn, probes: ProbeResults, projectPath: string, summary: string): Promise<{
+    captured: boolean;
+    sessionId?: string;
+}>;
+export {};
+//# sourceMappingURL=epilogue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"epilogue.d.ts","sourceRoot":"","sources":["../../src/flows/epilogue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,KAAK,UAAU,GAAG,CAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE/E;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,UAAU,EACpB,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwCpD"}

package/dist/flows/epilogue.js

@@ -0,0 +1,52 @@
+/**
+ * Epilogue — post-execution cleanup: capture knowledge and session summary.
+ * All operations are resilient (errors are caught, never propagated).
+ */
+/**
+ * Run post-execution epilogue steps.
+ * - Captures knowledge to vault (if available)
+ * - Captures session summary (if session store available)
+ *
+ * @returns Whether anything was captured and an optional session ID.
+ */
+export async function runEpilogue(dispatch, probes, projectPath, summary) {
+    let captured = false;
+    let sessionId;
+    // Capture knowledge to vault
+    if (probes.vault) {
+        try {
+            await dispatch('capture_knowledge', {
+                title: 'Flow execution summary',
+                content: summary,
+                type: 'workflow',
+                tags: ['flow-engine', 'auto-captured'],
+                projectPath,
+            });
+            captured = true;
+        }
+        catch {
+            // Silently ignore — vault capture is best-effort
+        }
+    }
+    // Capture session
+    if (probes.sessionStore) {
+        try {
+            const result = await dispatch('session_capture', {
+                summary,
+                projectPath,
+            });
+            captured = true;
+            if (result.data && typeof result.data === 'object') {
+                const data = result.data;
+                if (typeof data.sessionId === 'string') {
+                    sessionId = data.sessionId;
+                }
+            }
+        }
+        catch {
+            // Silently ignore — session capture is best-effort
+        }
+    }
+    return { captured, sessionId };
+}
+//# sourceMappingURL=epilogue.js.map

package/dist/flows/epilogue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"epilogue.js","sourceRoot":"","sources":["../../src/flows/epilogue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAoB,EACpB,MAAoB,EACpB,WAAmB,EACnB,OAAe;IAEf,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,SAA6B,CAAC;IAElC,6BAA6B;IAC7B,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,mBAAmB,EAAE;gBAClC,KAAK,EAAE,wBAAwB;gBAC/B,OAAO,EAAE,OAAO;gBAChB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,CAAC,aAAa,EAAE,eAAe,CAAC;gBACtC,WAAW;aACZ,CAAC,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,iDAAiD;QACnD,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,iBAAiB,EAAE;gBAC/C,OAAO;gBACP,WAAW;aACZ,CAAC,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,MAAM,CAAC,IAAI,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACnD,MAAM,IAAI,GAAG,MAAM,CAAC,IAA+B,CAAC;gBACpD,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;oBACvC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AACjC,CAAC"}

package/dist/flows/executor.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Flow executor — runs an orchestration plan step-by-step,
+ * evaluating gates and handling branching.
+ */
+import type { OrchestrationPlan, ExecutionResult } from './types.js';
+type DispatchFn = (toolName: string, params: Record<string, unknown>) => Promise<{
+    tool: string;
+    status: string;
+    data?: unknown;
+    error?: string;
+}>;
+/**
+ * Executes an orchestration plan sequentially (with parallel inner steps).
+ */
+export declare class FlowExecutor {
+    private dispatch;
+    constructor(dispatch: DispatchFn);
+    /**
+     * Execute a full orchestration plan. Returns an ExecutionResult
+     * summarizing what happened.
+     */
+    execute(plan: OrchestrationPlan): Promise<ExecutionResult>;
+}
+export {};
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/flows/executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAc,MAAM,YAAY,CAAC;AAMjF,KAAK,UAAU,GAAG,CAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE/E;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAa;gBAEjB,QAAQ,EAAE,UAAU;IAIhC;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;CAqIjE"}

package/dist/flows/executor.js

@@ -0,0 +1,153 @@
+/**
+ * Flow executor — runs an orchestration plan step-by-step,
+ * evaluating gates and handling branching.
+ */
+import { evaluateGate } from './gate-evaluator.js';
+/** Maximum iterations for BRANCH loops to prevent infinite cycles. */
+const MAX_BRANCH_ITERATIONS = 10;
+/**
+ * Executes an orchestration plan sequentially (with parallel inner steps).
+ */
+export class FlowExecutor {
+    dispatch;
+    constructor(dispatch) {
+        this.dispatch = dispatch;
+    }
+    /**
+     * Execute a full orchestration plan. Returns an ExecutionResult
+     * summarizing what happened.
+     */
+    async execute(plan) {
+        const startTime = Date.now();
+        const stepResults = [];
+        const toolsCalled = [];
+        let branchIterations = 0;
+        let currentIndex = 0;
+        while (currentIndex < plan.steps.length) {
+            const step = plan.steps[currentIndex];
+            const stepStart = Date.now();
+            step.status = 'running';
+            const toolResults = {};
+            try {
+                if (step.parallel && step.tools.length > 1) {
+                    // Execute tools in parallel
+                    const results = await Promise.allSettled(step.tools.map((tool) => this.dispatch(tool, { stepId: step.id, planId: plan.planId })));
+                    for (let i = 0; i < step.tools.length; i++) {
+                        const toolName = step.tools[i];
+                        const result = results[i];
+                        if (result.status === 'fulfilled') {
+                            toolResults[toolName] = result.value;
+                        }
+                        else {
+                            toolResults[toolName] = {
+                                tool: toolName,
+                                status: 'error',
+                                error: result.reason instanceof Error ? result.reason.message : String(result.reason),
+                            };
+                        }
+                        toolsCalled.push(toolName);
+                    }
+                }
+                else {
+                    // Execute tools sequentially
+                    for (const toolName of step.tools) {
+                        try {
+                            toolResults[toolName] = await this.dispatch(toolName, {
+                                stepId: step.id,
+                                planId: plan.planId,
+                            });
+                        }
+                        catch (_err) {
+                            toolResults[toolName] = {
+                                tool: toolName,
+                                status: 'error',
+                                error: _err instanceof Error ? _err.message : String(_err),
+                            };
+                        }
+                        toolsCalled.push(toolName);
+                    }
+                }
+            }
+            catch (_err) {
+                // Entire step failed
+                const stepResult = {
+                    stepId: step.id,
+                    status: 'failed',
+                    toolResults,
+                    durationMs: Date.now() - stepStart,
+                };
+                stepResults.push(stepResult);
+                step.status = 'failed';
+                break;
+            }
+            // Evaluate gate
+            const flatData = {};
+            for (const [key, val] of Object.entries(toolResults)) {
+                flatData[key] = val;
+                if (val.data && typeof val.data === 'object') {
+                    Object.assign(flatData, val.data);
+                }
+            }
+            const verdict = evaluateGate(step.gate, flatData);
+            const stepResult = {
+                stepId: step.id,
+                status: verdict.passed ? 'passed' : 'failed',
+                toolResults,
+                durationMs: Date.now() - stepStart,
+            };
+            if (!verdict.passed || verdict.action !== 'CONTINUE') {
+                stepResult.gateResult = {
+                    action: verdict.action,
+                    message: verdict.message,
+                };
+            }
+            stepResults.push(stepResult);
+            // Handle gate action
+            switch (verdict.action) {
+                case 'STOP':
+                    step.status = 'failed';
+                    // Stop execution
+                    return buildResult(plan, stepResults, toolsCalled, startTime, 'partial');
+                case 'BRANCH': {
+                    step.status = verdict.passed ? 'passed' : 'gate-paused';
+                    branchIterations++;
+                    if (branchIterations >= MAX_BRANCH_ITERATIONS) {
+                        return buildResult(plan, stepResults, toolsCalled, startTime, 'partial');
+                    }
+                    if (verdict.goto) {
+                        const targetIdx = plan.steps.findIndex((s) => s.id === verdict.goto);
+                        if (targetIdx >= 0) {
+                            currentIndex = targetIdx;
+                            continue;
+                        }
+                    }
+                    // No valid goto — continue to next step
+                    step.status = 'passed';
+                    currentIndex++;
+                    break;
+                }
+                case 'CONTINUE':
+                default:
+                    step.status = verdict.passed ? 'passed' : 'failed';
+                    currentIndex++;
+                    break;
+            }
+        }
+        const allPassed = stepResults.every((r) => r.status === 'passed');
+        const anyFailed = stepResults.some((r) => r.status === 'failed');
+        const status = allPassed ? 'completed' : anyFailed ? 'partial' : 'completed';
+        return buildResult(plan, stepResults, toolsCalled, startTime, status);
+    }
+}
+function buildResult(plan, stepResults, toolsCalled, startTime, status) {
+    return {
+        planId: plan.planId,
+        status,
+        stepsCompleted: stepResults.filter((r) => r.status === 'passed').length,
+        totalSteps: plan.steps.length,
+        toolsCalled: [...new Set(toolsCalled)],
+        durationMs: Date.now() - startTime,
+        stepResults,
+    };
+}
+//# sourceMappingURL=executor.js.map

package/dist/flows/executor.js.map

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

package/dist/flows/gate-evaluator.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Gate evaluator — checks step gates against tool results to decide
+ * whether execution should CONTINUE, STOP, or BRANCH.
+ */
+import type { PlanStep, GateVerdict } from './types.js';
+/**
+ * Evaluate a plan step's gate against collected tool results.
+ * If no gate is defined, returns CONTINUE (passed).
+ */
+export declare function evaluateGate(gate: PlanStep['gate'], toolResults: Record<string, unknown>): GateVerdict;
+/**
+ * Evaluate a simple condition string: "lhs op rhs".
+ * Supported operators: ==, !=, >=, <=, >, <
+ * lhs is resolved as a dotted path from data, rhs is a literal.
+ */
+export declare function evaluateCondition(condition: string, data: Record<string, unknown>): boolean;
+/**
+ * Extract a numeric score from tool results.
+ * Looks for common score field names.
+ */
+export declare function extractScore(data: Record<string, unknown>): number;
+/**
+ * Resolve a dotted path like "result.data.score" against an object.
+ */
+export declare function resolvePath(obj: Record<string, unknown>, path: string): unknown;
+//# sourceMappingURL=gate-evaluator.d.ts.map

package/dist/flows/gate-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-evaluator.d.ts","sourceRoot":"","sources":["../../src/flows/gate-evaluator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,EACtB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,WAAW,CAuDb;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAkC3F;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAwBlE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ/E"}