maestro-flow 0.1.0

package/dist/coordinator/intent-router.js

@@ -0,0 +1,65 @@
+// ---------------------------------------------------------------------------
+// Intent Router — resolves user intent to a graph ID via pattern matching.
+// ---------------------------------------------------------------------------
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+const DEFAULT_GRAPH = 'singles/quick';
+export class IntentRouter {
+    loader;
+    chainsRoot;
+    intentMap = null;
+    loaded = false;
+    constructor(loader, chainsRoot) {
+        this.loader = loader;
+        this.chainsRoot = chainsRoot;
+    }
+    resolve(intent, forceGraph) {
+        if (forceGraph) {
+            return forceGraph;
+        }
+        const map = this.getIntentMap();
+        if (!map) {
+            return DEFAULT_GRAPH;
+        }
+        if (!intent) {
+            return map.fallback.graph ?? DEFAULT_GRAPH;
+        }
+        for (const pattern of map.patterns) {
+            let re;
+            try {
+                re = new RegExp(pattern.regex, pattern.flags);
+            }
+            catch {
+                console.warn(`[IntentRouter] Invalid regex "${pattern.regex}" in pattern "${pattern.type}", skipping`);
+                continue;
+            }
+            if (re.test(intent)) {
+                const route = pattern.route;
+                if (route.graph)
+                    return route.graph;
+                if (route.strategy === 'state_router')
+                    return '_router';
+            }
+        }
+        return map.fallback.graph ?? DEFAULT_GRAPH;
+    }
+    // -------------------------------------------------------------------------
+    // Private
+    // -------------------------------------------------------------------------
+    getIntentMap() {
+        if (this.loaded)
+            return this.intentMap;
+        this.loaded = true;
+        const filePath = join(this.chainsRoot, '_intent-map.json');
+        try {
+            const content = readFileSync(filePath, 'utf-8');
+            this.intentMap = JSON.parse(content);
+        }
+        catch {
+            console.warn(`[IntentRouter] _intent-map.json not found at ${filePath}, using default`);
+            this.intentMap = null;
+        }
+        return this.intentMap;
+    }
+}
+//# sourceMappingURL=intent-router.js.map

package/dist/coordinator/intent-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-router.js","sourceRoot":"","sources":["../../src/coordinator/intent-router.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAE9E,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,MAAM,aAAa,GAAG,eAAe,CAAC;AAEtC,MAAM,OAAO,YAAY;IAKJ;IACA;IALX,SAAS,GAAqB,IAAI,CAAC;IACnC,MAAM,GAAG,KAAK,CAAC;IAEvB,YACmB,MAAmB,EACnB,UAAkB;QADlB,WAAM,GAAN,MAAM,CAAa;QACnB,eAAU,GAAV,UAAU,CAAQ;IAClC,CAAC;IAEJ,OAAO,CAAC,MAAc,EAAE,UAAmB;QACzC,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAChC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,aAAa,CAAC;QAC7C,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACnC,IAAI,EAAU,CAAC;YACf,IAAI,CAAC;gBACH,EAAE,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YAChD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,IAAI,CAAC,iCAAiC,OAAO,CAAC,KAAK,iBAAiB,OAAO,CAAC,IAAI,aAAa,CAAC,CAAC;gBACvG,SAAS;YACX,CAAC;YAED,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;gBAC5B,IAAI,KAAK,CAAC,KAAK;oBAAE,OAAO,KAAK,CAAC,KAAK,CAAC;gBACpC,IAAI,KAAK,CAAC,QAAQ,KAAK,cAAc;oBAAE,OAAO,SAAS,CAAC;YAC1D,CAAC;QACH,CAAC;QAED,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,aAAa,CAAC;IAC7C,CAAC;IAED,4EAA4E;IAC5E,UAAU;IACV,4EAA4E;IAEpE,YAAY;QAClB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QAEnB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAChD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,gDAAgD,QAAQ,iBAAiB,CAAC,CAAC;YACxF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF"}

package/dist/coordinator/link-session.d.ts

@@ -0,0 +1,29 @@
+import type { ChainGraph, LinkUpcomingStep } from './graph-types.js';
+export declare class LinkSession {
+    private readonly graph;
+    constructor(graph: ChainGraph);
+    /**
+     * Insert a new command node after the given node.
+     * Returns the generated node_id.
+     */
+    addNode(afterNodeId: string, cmd: string, args?: string): string;
+    /**
+     * Remove a node, reconnecting its predecessor to its successor.
+     */
+    removeNode(nodeId: string): void;
+    /**
+     * Modify the args of a command node.
+     */
+    modifyArgs(nodeId: string, newArgs: string): void;
+    /**
+     * Trace forward from startNode, collecting command nodes along the default path.
+     */
+    traceCommandPath(startNode: string): LinkUpcomingStep[];
+    getGraph(): ChainGraph;
+    private getNextTarget;
+    private setNextTarget;
+    private retarget;
+    private findPredecessors;
+    private referencesTarget;
+}
+//# sourceMappingURL=link-session.d.ts.map

package/dist/coordinator/link-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-session.d.ts","sourceRoot":"","sources":["../../src/coordinator/link-session.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,UAAU,EAGV,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAE1B,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,UAAU;IAE9C;;;OAGG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAqBhE;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAsBhC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAQjD;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,EAAE;IA0BvD,QAAQ,IAAI,UAAU;IAQtB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,QAAQ;IA8BhB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,gBAAgB;CAiBzB"}

package/dist/coordinator/link-session.js

@@ -0,0 +1,192 @@
+// ---------------------------------------------------------------------------
+// LinkSession — Dynamic chain editing on a mutable graph copy.
+// Supports add/remove/modify of command nodes for interactive coordination.
+// ---------------------------------------------------------------------------
+import { randomBytes } from 'node:crypto';
+export class LinkSession {
+    graph;
+    constructor(graph) {
+        this.graph = graph;
+    }
+    /**
+     * Insert a new command node after the given node.
+     * Returns the generated node_id.
+     */
+    addNode(afterNodeId, cmd, args) {
+        const afterNode = this.graph.nodes[afterNodeId];
+        if (!afterNode)
+            throw new Error(`Node not found: ${afterNodeId}`);
+        const nextTarget = this.getNextTarget(afterNode);
+        if (!nextTarget)
+            throw new Error(`Cannot insert after non-linear node: ${afterNodeId}`);
+        const newId = `link-${cmd}-${randomBytes(2).toString('hex')}`;
+        const newNode = {
+            type: 'command',
+            cmd,
+            args: args ?? '',
+            next: nextTarget,
+        };
+        this.graph.nodes[newId] = newNode;
+        this.setNextTarget(afterNode, newId);
+        return newId;
+    }
+    /**
+     * Remove a node, reconnecting its predecessor to its successor.
+     */
+    removeNode(nodeId) {
+        const node = this.graph.nodes[nodeId];
+        if (!node)
+            throw new Error(`Node not found: ${nodeId}`);
+        if (node.type === 'terminal')
+            throw new Error('Cannot remove terminal node');
+        const successor = this.getNextTarget(node);
+        if (!successor)
+            throw new Error(`Cannot remove non-linear node: ${nodeId}`);
+        // Find predecessor(s) and repoint
+        const predecessors = this.findPredecessors(nodeId);
+        if (predecessors.length === 0 && this.graph.entry === nodeId) {
+            this.graph.entry = successor;
+        }
+        for (const predId of predecessors) {
+            const predNode = this.graph.nodes[predId];
+            if (predNode)
+                this.retarget(predNode, nodeId, successor);
+        }
+        delete this.graph.nodes[nodeId];
+    }
+    /**
+     * Modify the args of a command node.
+     */
+    modifyArgs(nodeId, newArgs) {
+        const node = this.graph.nodes[nodeId];
+        if (!node || node.type !== 'command') {
+            throw new Error(`Node ${nodeId} is not a command node`);
+        }
+        node.args = newArgs;
+    }
+    /**
+     * Trace forward from startNode, collecting command nodes along the default path.
+     */
+    traceCommandPath(startNode) {
+        const steps = [];
+        const seen = new Set();
+        let current = startNode;
+        while (current && !seen.has(current)) {
+            seen.add(current);
+            const node = this.graph.nodes[current];
+            if (!node)
+                break;
+            if (node.type === 'command') {
+                steps.push({
+                    node_id: current,
+                    cmd: node.cmd,
+                    args_template: node.args ?? '',
+                    description: node.description,
+                });
+            }
+            if (node.type === 'terminal')
+                break;
+            current = this.getNextTarget(node);
+        }
+        return steps;
+    }
+    getGraph() {
+        return this.graph;
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    getNextTarget(node) {
+        switch (node.type) {
+            case 'command': return node.next;
+            case 'eval': return node.next;
+            case 'join': return node.next;
+            case 'gate': return node.on_pass; // default path
+            case 'decision': {
+                const def = node.edges.find(e => e.default);
+                return def?.target ?? node.edges[0]?.target ?? null;
+            }
+            case 'fork': return node.join;
+            case 'terminal': return null;
+        }
+    }
+    setNextTarget(node, target) {
+        switch (node.type) {
+            case 'command':
+                node.next = target;
+                break;
+            case 'eval':
+                node.next = target;
+                break;
+            case 'join':
+                node.next = target;
+                break;
+            default: break; // gate/decision/fork: more complex, not supported for direct set
+        }
+    }
+    retarget(node, oldTarget, newTarget) {
+        switch (node.type) {
+            case 'command':
+                if (node.next === oldTarget)
+                    node.next = newTarget;
+                if (node.on_failure === oldTarget)
+                    node.on_failure = newTarget;
+                break;
+            case 'eval':
+                if (node.next === oldTarget)
+                    node.next = newTarget;
+                break;
+            case 'join':
+                if (node.next === oldTarget)
+                    node.next = newTarget;
+                break;
+            case 'gate':
+                if (node.on_pass === oldTarget)
+                    node.on_pass = newTarget;
+                if (node.on_fail === oldTarget)
+                    node.on_fail = newTarget;
+                break;
+            case 'decision':
+                for (const edge of node.edges) {
+                    if (edge.target === oldTarget)
+                        edge.target = newTarget;
+                }
+                break;
+            case 'fork':
+                node.branches = node.branches.map(b => b === oldTarget ? newTarget : b);
+                if (node.join === oldTarget)
+                    node.join = newTarget;
+                break;
+            case 'terminal':
+                break;
+        }
+    }
+    findPredecessors(nodeId) {
+        const preds = [];
+        for (const [id, node] of Object.entries(this.graph.nodes)) {
+            if (id === nodeId)
+                continue;
+            if (this.referencesTarget(node, nodeId))
+                preds.push(id);
+        }
+        return preds;
+    }
+    referencesTarget(node, target) {
+        switch (node.type) {
+            case 'command':
+                return node.next === target || node.on_failure === target;
+            case 'eval':
+            case 'join':
+                return node.next === target;
+            case 'gate':
+                return node.on_pass === target || node.on_fail === target;
+            case 'decision':
+                return node.edges.some(e => e.target === target);
+            case 'fork':
+                return node.branches.includes(target) || node.join === target;
+            case 'terminal':
+                return false;
+        }
+    }
+}
+//# sourceMappingURL=link-session.js.map

package/dist/coordinator/link-session.js.map

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

package/dist/coordinator/link-walker.d.ts

@@ -0,0 +1,56 @@
+import type { CommandExecutor, PromptAssembler, ExprEvaluator, OutputParser, StepAnalyzer, LinkStepPreview, LinkAction, LinkSessionState, LinkUpcomingStep } from './graph-types.js';
+import type { GraphLoader } from './graph-loader.js';
+export interface LinkStartOptions {
+    tool: string;
+    workflowRoot: string;
+    inputs?: Record<string, unknown>;
+}
+export declare class LinkWalker {
+    private readonly loader;
+    private readonly assembler;
+    private readonly executor;
+    private readonly outputParser;
+    private readonly evaluator;
+    private readonly analyzer?;
+    private readonly sessionDir?;
+    private state;
+    private graph;
+    private session;
+    constructor(loader: GraphLoader, assembler: PromptAssembler, executor: CommandExecutor, outputParser: OutputParser, evaluator: ExprEvaluator, analyzer?: StepAnalyzer | undefined, sessionDir?: string | undefined);
+    /**
+     * Load graph, initialize state, advance to first command node, return preview.
+     */
+    start(graphId: string, intent: string, options: LinkStartOptions): Promise<LinkStepPreview | null>;
+    /**
+     * Resume from saved session state.
+     */
+    resume(sessionDir: string, sessionId?: string): Promise<LinkStepPreview | null>;
+    /**
+     * Execute the user's chosen action for the current step.
+     * Returns the next step preview or null if walk is done.
+     */
+    executeStep(action: LinkAction): Promise<LinkStepPreview | null>;
+    getPreview(): LinkStepPreview | null;
+    addNode(afterNodeId: string, cmd: string, args?: string): void;
+    removeNode(nodeId: string): void;
+    modifyArgs(nodeId: string, newArgs: string): void;
+    getUpcomingChain(): LinkUpcomingStep[];
+    getState(): LinkSessionState | null;
+    private buildPreviewForCurrent;
+    private advanceToNextCommand;
+    private handleNonCommandNode;
+    private executeCurrentCommand;
+    private skipCurrentCommand;
+    private buildPreview;
+    private buildContextSummary;
+    private resolveArgs;
+    private findPreviousCommand;
+    private countCommandsBefore;
+    private countCommandNodes;
+    private setContextValue;
+    private recordModification;
+    private buildInitialContext;
+    private save;
+    private saveOutput;
+}
+//# sourceMappingURL=link-walker.d.ts.map

package/dist/coordinator/link-walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-walker.d.ts","sourceRoot":"","sources":["../../src/coordinator/link-walker.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAOV,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EAEZ,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAGjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,qBAAa,UAAU;IAMnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAX9B,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,OAAO,CAA4B;gBAGxB,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,eAAe,EAC1B,QAAQ,EAAE,eAAe,EACzB,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,aAAa,EACxB,QAAQ,CAAC,EAAE,YAAY,YAAA,EACvB,UAAU,CAAC,EAAE,MAAM,YAAA;IAGtC;;OAEG;IACG,KAAK,CACT,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAgClC;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA4BrF;;;OAGG;IACG,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA0CtE,UAAU,IAAI,eAAe,GAAG,IAAI;IAIpC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAM9D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOhC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjD,gBAAgB,IAAI,gBAAgB,EAAE;IAKtC,QAAQ,IAAI,gBAAgB,GAAG,IAAI;YAQrB,sBAAsB;YAWtB,oBAAoB;IA8BlC,OAAO,CAAC,oBAAoB;YAiFd,qBAAqB;IA0EnC,OAAO,CAAC,kBAAkB;YAoBZ,YAAY;IAmC1B,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,mBAAmB;IAkB3B,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,mBAAmB;IAqC3B,OAAO,CAAC,IAAI;IAeZ,OAAO,CAAC,UAAU;CAQnB"}