@soleri/core 2.12.0 → 7.0.0

package/dist/flows/gate-evaluator.js

@@ -0,0 +1,162 @@
+/**
+ * Gate evaluator — checks step gates against tool results to decide
+ * whether execution should CONTINUE, STOP, or BRANCH.
+ */
+/**
+ * Evaluate a plan step's gate against collected tool results.
+ * If no gate is defined, returns CONTINUE (passed).
+ */
+export function evaluateGate(gate, toolResults) {
+    if (!gate) {
+        return { passed: true, action: 'CONTINUE' };
+    }
+    switch (gate.type) {
+        case 'GATE': {
+            const passed = gate.condition ? evaluateCondition(gate.condition, toolResults) : true;
+            if (passed)
+                return { passed: true, action: 'CONTINUE' };
+            return {
+                passed: false,
+                action: gate.onFail?.action ?? 'STOP',
+                goto: gate.onFail?.goto,
+                message: gate.onFail?.message,
+            };
+        }
+        case 'SCORE': {
+            const score = extractScore(toolResults);
+            const minScore = gate.min ?? 0;
+            const passed = score >= minScore;
+            if (passed)
+                return { passed: true, action: 'CONTINUE', score };
+            return {
+                passed: false,
+                action: gate.onFail?.action ?? 'STOP',
+                goto: gate.onFail?.goto,
+                message: gate.onFail?.message ?? `Score ${score} below minimum ${minScore}`,
+                score,
+            };
+        }
+        case 'CHECKPOINT': {
+            const passed = gate.condition ? evaluateCondition(gate.condition, toolResults) : true;
+            if (passed)
+                return { passed: true, action: 'CONTINUE' };
+            return {
+                passed: false,
+                action: gate.onFail?.action ?? 'CONTINUE',
+                goto: gate.onFail?.goto,
+                message: gate.onFail?.message,
+            };
+        }
+        case 'BRANCH': {
+            // BRANCH gates always trigger branching
+            return {
+                passed: true,
+                action: 'BRANCH',
+                goto: gate.onFail?.goto,
+                message: gate.onFail?.message,
+            };
+        }
+        default:
+            return { passed: true, action: 'CONTINUE' };
+    }
+}
+/**
+ * Evaluate a simple condition string: "lhs op rhs".
+ * Supported operators: ==, !=, >=, <=, >, <
+ * lhs is resolved as a dotted path from data, rhs is a literal.
+ */
+export function evaluateCondition(condition, data) {
+    const operators = ['>=', '<=', '!=', '==', '>', '<'];
+    for (const op of operators) {
+        const idx = condition.indexOf(op);
+        if (idx === -1)
+            continue;
+        const lhsPath = condition.slice(0, idx).trim();
+        const rhsRaw = condition.slice(idx + op.length).trim();
+        const lhsValue = resolvePath(data, lhsPath);
+        const rhsValue = parseConditionValue(rhsRaw);
+        const lNum = typeof lhsValue === 'number' ? lhsValue : Number(lhsValue);
+        const rNum = typeof rhsValue === 'number' ? rhsValue : Number(rhsValue);
+        const useNumeric = !Number.isNaN(lNum) && !Number.isNaN(rNum);
+        switch (op) {
+            case '==':
+                return useNumeric ? lNum === rNum : String(lhsValue) === String(rhsValue);
+            case '!=':
+                return useNumeric ? lNum !== rNum : String(lhsValue) !== String(rhsValue);
+            case '>=':
+                return useNumeric ? lNum >= rNum : false;
+            case '<=':
+                return useNumeric ? lNum <= rNum : false;
+            case '>':
+                return useNumeric ? lNum > rNum : false;
+            case '<':
+                return useNumeric ? lNum < rNum : false;
+        }
+    }
+    // No operator found — check if value is truthy
+    const val = resolvePath(data, condition.trim());
+    return !!val;
+}
+/**
+ * Extract a numeric score from tool results.
+ * Looks for common score field names.
+ */
+export function extractScore(data) {
+    // Direct score fields
+    for (const key of ['score', 'validationScore', 'total']) {
+        if (typeof data[key] === 'number')
+            return data[key];
+    }
+    // Search within nested result objects
+    for (const val of Object.values(data)) {
+        if (val && typeof val === 'object' && !Array.isArray(val)) {
+            const nested = val;
+            for (const key of ['score', 'validationScore', 'total']) {
+                if (typeof nested[key] === 'number')
+                    return nested[key];
+            }
+            // One more level: data property
+            if (nested.data && typeof nested.data === 'object') {
+                const deep = nested.data;
+                for (const key of ['score', 'validationScore', 'total']) {
+                    if (typeof deep[key] === 'number')
+                        return deep[key];
+                }
+            }
+        }
+    }
+    return 0;
+}
+/**
+ * Resolve a dotted path like "result.data.score" against an object.
+ */
+export function resolvePath(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined || typeof current !== 'object')
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+// ---------------------------------------------------------------------------
+// Internal
+// ---------------------------------------------------------------------------
+function parseConditionValue(raw) {
+    if (raw === 'true')
+        return true;
+    if (raw === 'false')
+        return false;
+    if (raw === 'null')
+        return 0;
+    // Strip quotes
+    if ((raw.startsWith('"') && raw.endsWith('"')) || (raw.startsWith("'") && raw.endsWith("'"))) {
+        return raw.slice(1, -1);
+    }
+    const num = Number(raw);
+    if (!Number.isNaN(num))
+        return num;
+    return raw;
+}
+//# sourceMappingURL=gate-evaluator.js.map

package/dist/flows/gate-evaluator.js.map

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

package/dist/flows/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Flow engine — YAML-driven workflow orchestration.
+ */
+export type { Flow, FlowStep, Gate, GateAction, ProbeName, ProbeResults, PlanStep, SkippedStep, OrchestrationPlan, OrchestrationContext, StepResult, ExecutionResult, GateVerdict, } from './types.js';
+export { loadFlowById, loadAllFlows, parseSimpleYaml } from './loader.js';
+export { runProbes } from './probes.js';
+export { INTENT_TO_FLOW, chainToToolName, chainToRequires, flowStepsToPlanSteps, pruneSteps, buildPlan, } from './plan-builder.js';
+export { detectContext, applyContextOverrides, getFlowOverrides } from './context-router.js';
+export type { ContextOverride } from './context-router.js';
+export { evaluateGate, evaluateCondition, extractScore, resolvePath } from './gate-evaluator.js';
+export { FlowExecutor } from './executor.js';
+export { createDispatcher } from './dispatch-registry.js';
+export { runEpilogue } from './epilogue.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/flows/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,eAAe,EACf,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG1E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EACL,cAAc,EACd,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,SAAS,GACV,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGjG,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/flows/index.js

@@ -0,0 +1,20 @@
+/**
+ * Flow engine — YAML-driven workflow orchestration.
+ */
+// Loader
+export { loadFlowById, loadAllFlows, parseSimpleYaml } from './loader.js';
+// Probes
+export { runProbes } from './probes.js';
+// Plan builder
+export { INTENT_TO_FLOW, chainToToolName, chainToRequires, flowStepsToPlanSteps, pruneSteps, buildPlan, } from './plan-builder.js';
+// Context router
+export { detectContext, applyContextOverrides, getFlowOverrides } from './context-router.js';
+// Gate evaluator
+export { evaluateGate, evaluateCondition, extractScore, resolvePath } from './gate-evaluator.js';
+// Executor
+export { FlowExecutor } from './executor.js';
+// Dispatch registry
+export { createDispatcher } from './dispatch-registry.js';
+// Epilogue
+export { runEpilogue } from './epilogue.js';
+//# sourceMappingURL=index.js.map

package/dist/flows/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/flows/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1E,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,eAAe;AACf,OAAO,EACL,cAAc,EACd,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,SAAS,GACV,MAAM,mBAAmB,CAAC;AAE3B,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG7F,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEjG,WAAW;AACX,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,oBAAoB;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,WAAW;AACX,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/flows/loader.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Flow loader — reads and validates YAML flow files from a directory.
+ */
+import { parse as parseYaml } from 'yaml';
+import { type Flow } from './types.js';
+/** Re-export for backward compat (tests import this). */
+export declare const parseSimpleYaml: typeof parseYaml;
+/**
+ * Load a single flow by its `id` field from *.flow.yaml files in a directory.
+ * Returns `null` if not found or validation fails.
+ */
+export declare function loadFlowById(flowId: string, flowsDir?: string): Flow | null;
+/**
+ * Load all valid flows from *.flow.yaml files in a directory.
+ */
+export declare function loadAllFlows(flowsDir?: string): Flow[];
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/flows/loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAKnD,yDAAyD;AACzD,eAAO,MAAM,eAAe,kBAAY,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAkB3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,CAmBtD"}

package/dist/flows/loader.js

@@ -0,0 +1,61 @@
+/**
+ * Flow loader — reads and validates YAML flow files from a directory.
+ */
+import { readdirSync, readFileSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parse as parseYaml } from 'yaml';
+import { flowSchema } from './types.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const DEFAULT_FLOWS_DIR = join(__dirname, '..', '..', 'data', 'flows');
+/** Re-export for backward compat (tests import this). */
+export const parseSimpleYaml = parseYaml;
+/**
+ * Load a single flow by its `id` field from *.flow.yaml files in a directory.
+ * Returns `null` if not found or validation fails.
+ */
+export function loadFlowById(flowId, flowsDir) {
+    const dir = flowsDir ?? DEFAULT_FLOWS_DIR;
+    if (!existsSync(dir))
+        return null;
+    const files = readdirSync(dir).filter((f) => f.endsWith('.flow.yaml'));
+    for (const file of files) {
+        try {
+            const content = readFileSync(join(dir, file), 'utf-8');
+            const raw = parseYaml(content);
+            const parsed = flowSchema.safeParse(raw);
+            if (parsed.success && parsed.data.id === flowId) {
+                return parsed.data;
+            }
+        }
+        catch {
+            // skip invalid files
+        }
+    }
+    return null;
+}
+/**
+ * Load all valid flows from *.flow.yaml files in a directory.
+ */
+export function loadAllFlows(flowsDir) {
+    const dir = flowsDir ?? DEFAULT_FLOWS_DIR;
+    if (!existsSync(dir))
+        return [];
+    const files = readdirSync(dir).filter((f) => f.endsWith('.flow.yaml'));
+    const flows = [];
+    for (const file of files) {
+        try {
+            const content = readFileSync(join(dir, file), 'utf-8');
+            const raw = parseYaml(content);
+            const parsed = flowSchema.safeParse(raw);
+            if (parsed.success) {
+                flows.push(parsed.data);
+            }
+        }
+        catch {
+            // skip invalid files
+        }
+    }
+    return flows;
+}
+//# sourceMappingURL=loader.js.map

package/dist/flows/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/flows/loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAa,MAAM,YAAY,CAAC;AAEnD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvE,yDAAyD;AACzD,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,QAAiB;IAC5D,MAAM,GAAG,GAAG,QAAQ,IAAI,iBAAiB,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAElC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;IACvE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;gBAChD,OAAO,MAAM,CAAC,IAAI,CAAC;YACrB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAiB;IAC5C,MAAM,GAAG,GAAG,QAAQ,IAAI,iBAAiB,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;IACvE,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/flows/plan-builder.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Plan builder — converts intent + flow + probes into an OrchestrationPlan.
+ */
+import type { AgentRuntime } from '../runtime/types.js';
+import type { Flow, PlanStep, SkippedStep, OrchestrationPlan, ProbeResults, ProbeName } from './types.js';
+import type { CapabilityRegistry } from '../capabilities/index.js';
+export declare const INTENT_TO_FLOW: Record<string, string>;
+/**
+ * Convert a chain name (e.g. "vault-search") to a tool name (e.g. "myagent_vault_search").
+ */
+export declare function chainToToolName(chain: string, agentId: string): string;
+/**
+ * Infer which probe capability a chain requires, or undefined if none.
+ */
+export declare function chainToRequires(chain: string): ProbeName | undefined;
+/**
+ * Convert flow steps into plan steps.
+ *
+ * Resolution order for capability IDs:
+ * 1. If the step has `needs:` (v2), use those capability IDs directly
+ * 2. If the step only has `chains:` (v1), map via chainToCapability()
+ * 3. chainToToolName() is still used for tool dispatch (fallback path)
+ *
+ * When an optional `registry` is provided, each resolved capability is
+ * validated. Unavailable capabilities are recorded in the step's
+ * `unavailableCapabilities` list (informational — pruning is separate).
+ */
+export declare function flowStepsToPlanSteps(flow: Flow, agentId: string, registry?: CapabilityRegistry): PlanStep[];
+/**
+ * Remove steps whose required capabilities are not available.
+ */
+export declare function pruneSteps(steps: PlanStep[], probes: ProbeResults): {
+    kept: PlanStep[];
+    skipped: SkippedStep[];
+};
+/**
+ * Build a full orchestration plan from intent, agent config, and runtime.
+ */
+export declare function buildPlan(intent: string, agentId: string, projectPath: string, runtime: AgentRuntime, prompt?: string): Promise<OrchestrationPlan>;
+//# sourceMappingURL=plan-builder.d.ts.map

package/dist/flows/plan-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-builder.d.ts","sourceRoot":"","sources":["../../src/flows/plan-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EACV,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACV,MAAM,YAAY,CAAC;AAKpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAMnE,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAWjD,CAAC;AAMF;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAUpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,QAAQ,EAAE,CA4EZ;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,EAAE,EACjB,MAAM,EAAE,YAAY,GACnB;IAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,CAkB9C;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,CAAC,CAyD5B"}

package/dist/flows/plan-builder.js

@@ -0,0 +1,213 @@
+/**
+ * Plan builder — converts intent + flow + probes into an OrchestrationPlan.
+ */
+import { randomUUID } from 'node:crypto';
+import { loadFlowById } from './loader.js';
+import { runProbes } from './probes.js';
+import { detectContext, applyContextOverrides } from './context-router.js';
+import { chainToCapability } from '../capabilities/index.js';
+// ---------------------------------------------------------------------------
+// Intent → Flow mapping
+// ---------------------------------------------------------------------------
+export const INTENT_TO_FLOW = {
+    BUILD: 'BUILD-flow',
+    CREATE: 'BUILD-flow',
+    FIX: 'FIX-flow',
+    REVIEW: 'REVIEW-flow',
+    PLAN: 'PLAN-flow',
+    DESIGN: 'DESIGN-flow',
+    ENHANCE: 'ENHANCE-flow',
+    IMPROVE: 'ENHANCE-flow',
+    EXPLORE: 'EXPLORE-flow',
+    DELIVER: 'DELIVER-flow',
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Convert a chain name (e.g. "vault-search") to a tool name (e.g. "myagent_vault_search").
+ */
+export function chainToToolName(chain, agentId) {
+    return `${agentId}_${chain.replace(/-/g, '_')}`;
+}
+/**
+ * Infer which probe capability a chain requires, or undefined if none.
+ */
+export function chainToRequires(chain) {
+    const lower = chain.toLowerCase();
+    if (lower.startsWith('vault') || lower.startsWith('memory'))
+        return 'vault';
+    if (lower.startsWith('brain'))
+        return 'brain';
+    if (lower.startsWith('component') || lower.startsWith('token') || lower.startsWith('design'))
+        return 'designSystem';
+    if (lower.startsWith('session'))
+        return 'sessionStore';
+    // recommend-* and get-stack-* have no hard requirements
+    if (lower.startsWith('recommend') || lower.startsWith('get-stack'))
+        return undefined;
+    return undefined;
+}
+/**
+ * Convert flow steps into plan steps.
+ *
+ * Resolution order for capability IDs:
+ * 1. If the step has `needs:` (v2), use those capability IDs directly
+ * 2. If the step only has `chains:` (v1), map via chainToCapability()
+ * 3. chainToToolName() is still used for tool dispatch (fallback path)
+ *
+ * When an optional `registry` is provided, each resolved capability is
+ * validated. Unavailable capabilities are recorded in the step's
+ * `unavailableCapabilities` list (informational — pruning is separate).
+ */
+export function flowStepsToPlanSteps(flow, agentId, registry) {
+    return flow.steps.map((step) => {
+        // Tool names for dispatch fallback (always computed from chains)
+        const tools = (step.chains ?? []).map((c) => chainToToolName(c, agentId));
+        // Resolve capability IDs: prefer needs (v2), fall back to chains (v1)
+        const capabilityIds = [];
+        if (step.needs && step.needs.length > 0) {
+            capabilityIds.push(...step.needs);
+        }
+        else if (step.chains) {
+            for (const chain of step.chains) {
+                const capId = chainToCapability(chain);
+                if (capId && !capabilityIds.includes(capId)) {
+                    capabilityIds.push(capId);
+                }
+            }
+        }
+        // Probe-level requires (existing behavior, derived from chains)
+        const requires = [];
+        for (const chain of step.chains ?? []) {
+            const req = chainToRequires(chain);
+            if (req && !requires.includes(req))
+                requires.push(req);
+        }
+        // Validate capabilities against registry if provided
+        const unavailableCapabilities = [];
+        if (registry) {
+            for (const capId of capabilityIds) {
+                const resolved = registry.resolve(capId);
+                if (!resolved.available) {
+                    unavailableCapabilities.push(capId);
+                }
+            }
+        }
+        const planStep = {
+            id: step.id,
+            name: step.name ?? step.id,
+            tools,
+            parallel: step.parallel ?? false,
+            requires,
+            status: 'pending',
+        };
+        // Attach capability metadata (non-breaking additions)
+        if (capabilityIds.length > 0) {
+            planStep.capabilities = capabilityIds;
+        }
+        if (unavailableCapabilities.length > 0) {
+            planStep.unavailableCapabilities =
+                unavailableCapabilities;
+        }
+        if (step.gate) {
+            const gate = step.gate;
+            planStep.gate = {
+                type: gate.type,
+            };
+            if ('condition' in gate && gate.condition) {
+                planStep.gate.condition = gate.condition;
+            }
+            if ('min' in gate && gate.min !== undefined) {
+                planStep.gate.min = gate.min;
+            }
+            if (gate['on-false']) {
+                planStep.gate.onFail = {
+                    action: gate['on-false'].action,
+                    goto: gate['on-false'].goto,
+                    message: gate['on-false'].message,
+                };
+            }
+        }
+        return planStep;
+    });
+}
+/**
+ * Remove steps whose required capabilities are not available.
+ */
+export function pruneSteps(steps, probes) {
+    const kept = [];
+    const skipped = [];
+    for (const step of steps) {
+        const missingProbes = step.requires.filter((r) => !probes[r]);
+        if (missingProbes.length > 0) {
+            skipped.push({
+                id: step.id,
+                name: step.name,
+                reason: `Missing capabilities: ${missingProbes.join(', ')}`,
+            });
+        }
+        else {
+            kept.push(step);
+        }
+    }
+    return { kept, skipped };
+}
+/**
+ * Build a full orchestration plan from intent, agent config, and runtime.
+ */
+export async function buildPlan(intent, agentId, projectPath, runtime, prompt) {
+    const normalizedIntent = intent.toUpperCase();
+    const flowId = INTENT_TO_FLOW[normalizedIntent] ?? 'BUILD-flow';
+    const flow = loadFlowById(flowId);
+    const probes = await runProbes(runtime, projectPath);
+    let steps = [];
+    let skipped = [];
+    const warnings = [];
+    if (flow) {
+        let allSteps = flowStepsToPlanSteps(flow, agentId);
+        // Context-sensitive chain routing: detect what's being built/fixed/reviewed
+        // and apply chain overrides (inject, skip, substitute) before pruning.
+        const entities = { components: [], actions: [] };
+        const contexts = prompt ? detectContext(prompt, entities) : [];
+        if (contexts.length > 0) {
+            allSteps = applyContextOverrides(allSteps, contexts, flowId, agentId);
+        }
+        const pruneResult = pruneSteps(allSteps, probes);
+        steps = pruneResult.kept;
+        skipped = pruneResult.skipped;
+        if (pruneResult.skipped.length > 0) {
+            warnings.push(`${pruneResult.skipped.length} step(s) skipped due to missing capabilities.`);
+        }
+    }
+    else {
+        warnings.push(`Flow "${flowId}" not found — plan will have no steps.`);
+    }
+    if (!probes.vault)
+        warnings.push('Vault unavailable — knowledge capture will be skipped.');
+    if (!probes.brain)
+        warnings.push('Brain has no vocabulary — recommendations may be limited.');
+    const epilogue = [];
+    if (probes.vault)
+        epilogue.push('capture_knowledge');
+    if (probes.sessionStore)
+        epilogue.push('session_capture');
+    return {
+        planId: randomUUID(),
+        intent: normalizedIntent,
+        flowId,
+        steps,
+        skipped,
+        epilogue,
+        warnings,
+        summary: prompt ?? `${normalizedIntent} plan with ${steps.length} step(s)`,
+        estimatedTools: steps.reduce((acc, s) => acc + s.tools.length, 0),
+        context: {
+            intent: normalizedIntent,
+            probes,
+            entities: { components: [], actions: [] },
+            projectPath,
+        },
+    };
+}
+//# sourceMappingURL=plan-builder.js.map

package/dist/flows/plan-builder.js.map

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

package/dist/flows/probes.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Capability probes — detect what subsystems are available at runtime.
+ * All probes are resilient: they catch errors and return false on failure.
+ */
+import type { AgentRuntime } from '../runtime/types.js';
+import type { ProbeResults } from './types.js';
+/**
+ * Run all 6 capability probes in parallel and return results.
+ */
+export declare function runProbes(runtime: AgentRuntime, projectPath: string): Promise<ProbeResults>;
+//# sourceMappingURL=probes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"probes.d.ts","sourceRoot":"","sources":["../../src/flows/probes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAWjG"}

package/dist/flows/probes.js

@@ -0,0 +1,62 @@
+/**
+ * Capability probes — detect what subsystems are available at runtime.
+ * All probes are resilient: they catch errors and return false on failure.
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Run all 6 capability probes in parallel and return results.
+ */
+export async function runProbes(runtime, projectPath) {
+    const [vault, brain, designSystem, sessionStore, projectRules, active] = await Promise.all([
+        probeVault(runtime),
+        probeBrain(runtime),
+        probeDesignSystem(runtime),
+        probeSessionStore(),
+        probeProjectRules(projectPath),
+        probeActive(),
+    ]);
+    return { vault, brain, designSystem, sessionStore, projectRules, active };
+}
+async function probeVault(runtime) {
+    try {
+        const stats = runtime.vault.stats();
+        return stats.totalEntries >= 0;
+    }
+    catch {
+        return false;
+    }
+}
+async function probeBrain(runtime) {
+    try {
+        return runtime.brain.getVocabularySize() > 0;
+    }
+    catch {
+        return false;
+    }
+}
+async function probeDesignSystem(runtime) {
+    try {
+        return runtime.projectRegistry.list().length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+async function probeSessionStore() {
+    // Session store is always available in Soleri runtime
+    return true;
+}
+async function probeProjectRules(projectPath) {
+    try {
+        return (existsSync(join(projectPath, 'docs', 'vault')) || existsSync(join(projectPath, '.soleri')));
+    }
+    catch {
+        return false;
+    }
+}
+async function probeActive() {
+    // Always true when the engine is running
+    return true;
+}
+//# sourceMappingURL=probes.js.map