network-ai 5.10.2 → 5.12.0

package/dist/esm/lib/partition-planner.js

@@ -0,0 +1,246 @@
+"use strict";
+/**
+ * Partition Planner — Logical Work Partitioning for Network-AI
+ *
+ * Prevents parallel agents from performing redundant research or analysis by
+ * running a "meta-step" before DAG execution that generates a Scope Assignment
+ * Map (PartitionSchema). Each agent receives a boundary constraint injected
+ * into its parameters, declaring what it SHOULD focus on and what it should
+ * EXCLUDE.
+ *
+ * The planner also performs an overlap check — verifying that no two
+ * `focus_area` strings overlap semantically (or lexically, when using the
+ * built-in heuristic check).
+ *
+ * Zero external dependencies — the overlap checker and the planner function
+ * are pluggable so callers can use any LLM or rule-based strategy.
+ *
+ * @module PartitionPlanner
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PartitionPlanner = void 0;
+exports.createLexicalOverlapChecker = createLexicalOverlapChecker;
+exports.createLLMPartitionPlanner = createLLMPartitionPlanner;
+exports.parsePartitionJSON = parsePartitionJSON;
+// ============================================================================
+// BUILT-IN OVERLAP CHECKER (lexical heuristic — zero model cost)
+// ============================================================================
+/**
+ * Lexical overlap checker: considers two focus areas to overlap when they
+ * share significant word stems (ignoring common stop words).
+ *
+ * This is the built-in default. For true semantic overlap detection, inject
+ * an LLM-based `OverlapCheckFunction` via `PartitionPlannerOptions.overlapChecker`.
+ */
+function createLexicalOverlapChecker() {
+    const STOP_WORDS = new Set([
+        'a', 'an', 'the', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for',
+        'of', 'with', 'by', 'from', 'is', 'are', 'was', 'were', 'be', 'been',
+        'as', 'its', 'it', 'this', 'that', 'all', 'any', 'each', 'every',
+    ]);
+    function tokenize(text) {
+        return new Set(text
+            .toLowerCase()
+            .replace(/[^a-z0-9\s]/g, ' ')
+            .split(/\s+/)
+            .filter((w) => w.length > 2 && !STOP_WORDS.has(w)));
+    }
+    return async (schema) => {
+        const overlaps = [];
+        for (let i = 0; i < schema.length; i++) {
+            for (let j = i + 1; j < schema.length; j++) {
+                const tokensA = tokenize(schema[i].focus_area);
+                const tokensB = tokenize(schema[j].focus_area);
+                const shared = [];
+                for (const token of tokensA) {
+                    if (tokensB.has(token))
+                        shared.push(token);
+                }
+                // Flag as overlap when ≥ 2 shared significant words or overlap ratio > 0.4
+                const unionSize = new Set([...tokensA, ...tokensB]).size;
+                const ratio = unionSize > 0 ? shared.length / unionSize : 0;
+                if (shared.length >= 2 || ratio > 0.4) {
+                    overlaps.push(`Overlap between "${schema[i].agent_type}" (focus: "${schema[i].focus_area}") and "${schema[j].agent_type}" (focus: "${schema[j].focus_area}") — shared terms: ${shared.join(', ')}`);
+                }
+            }
+        }
+        return overlaps;
+    };
+}
+/**
+ * Build a partition planner backed by an LLM.
+ *
+ * The LLM is asked to generate a PartitionSchema JSON array given the goal
+ * and the available agents. Use this for rich semantic partitioning.
+ *
+ * @param executor - Network-AI executor function
+ * @param plannerAgentId - Agent ID for the LLM that does partitioning
+ */
+function createLLMPartitionPlanner(executor, plannerAgentId) {
+    return async (goal, agents, context) => {
+        const agentList = agents.map((a) => `- ${a.id}: ${a.role}`).join('\n');
+        const prompt = [
+            'You are a work-partitioning planner for a multi-agent AI system.',
+            'Generate a scope assignment for each agent to prevent redundant research.',
+            '',
+            `GOAL: ${goal}`,
+            '',
+            'AGENTS:',
+            agentList,
+            '',
+            context ? `CONTEXT: ${JSON.stringify(context)}` : '',
+            '',
+            'Respond with ONLY a JSON array where each element has:',
+            '- "agent_type": agent ID from the list above',
+            '- "focus_area": a short phrase describing what ONLY this agent researches',
+            '- "excluded_topics": array of topic strings this agent must NOT cover',
+            '',
+            'Ensure no two focus_area values overlap semantically.',
+            '',
+            'Example:',
+            '[{"agent_type":"researcher","focus_area":"market trends and competitive landscape","excluded_topics":["financial projections","legal compliance"]},',
+            ' {"agent_type":"analyst","focus_area":"financial projections and ROI analysis","excluded_topics":["market research","legal compliance"]}]',
+        ].filter(Boolean).join('\n');
+        const result = await executor(plannerAgentId, { action: 'partition', params: { prompt } }, { agentId: plannerAgentId, taskId: `partition-${Date.now()}`, metadata: { type: 'partition-planning', ...(context ?? {}) } });
+        if (!result.success || !result.data) {
+            throw new Error(`Partition planner failed: ${result.error?.message ?? 'no data returned'}`);
+        }
+        return parsePartitionJSON(typeof result.data === 'string' ? result.data : JSON.stringify(result.data));
+    };
+}
+/**
+ * Parse a PartitionSchema from an LLM response string.
+ * Handles markdown fences and leading/trailing text.
+ */
+function parsePartitionJSON(text) {
+    let cleaned = text.trim();
+    // Strip markdown fences
+    const fenceOpen = cleaned.indexOf('```');
+    if (fenceOpen !== -1) {
+        const afterOpen = cleaned.indexOf('\n', fenceOpen);
+        const fenceClose = cleaned.indexOf('```', afterOpen !== -1 ? afterOpen : fenceOpen + 3);
+        if (afterOpen !== -1 && fenceClose > afterOpen) {
+            cleaned = cleaned.substring(afterOpen + 1, fenceClose).trim();
+        }
+    }
+    // Find JSON array
+    const arrayStart = cleaned.indexOf('[');
+    const arrayEnd = cleaned.lastIndexOf(']');
+    if (arrayStart !== -1 && arrayEnd > arrayStart) {
+        cleaned = cleaned.substring(arrayStart, arrayEnd + 1);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(cleaned);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse partition schema JSON: ${err.message}`);
+    }
+    if (!Array.isArray(parsed)) {
+        throw new Error('Partition schema must be a JSON array');
+    }
+    // Validate each entry
+    const schema = [];
+    for (const entry of parsed) {
+        if (typeof entry !== 'object' || entry === null) {
+            throw new Error('Each partition entry must be a JSON object');
+        }
+        const e = entry;
+        if (!e.agent_type || typeof e.agent_type !== 'string') {
+            throw new Error('Each partition entry must have a string "agent_type"');
+        }
+        if (!e.focus_area || typeof e.focus_area !== 'string') {
+            throw new Error(`Partition entry for "${e.agent_type}" must have a string "focus_area"`);
+        }
+        if (!Array.isArray(e.excluded_topics)) {
+            e.excluded_topics = [];
+        }
+        schema.push({
+            agent_type: e.agent_type,
+            focus_area: e.focus_area,
+            excluded_topics: e.excluded_topics.map(String),
+        });
+    }
+    return schema;
+}
+// ============================================================================
+// PARTITION PLANNER (OOP interface)
+// ============================================================================
+/**
+ * PartitionPlanner generates a PartitionSchema (scope assignment map) for a
+ * set of agents before the DAG is executed, preventing redundant research.
+ *
+ * @example
+ * ```typescript
+ * const planner = new PartitionPlanner(myLLMPartitionPlannerFn);
+ * const result = await planner.plan('Analyse Q3 financial results', agents);
+ * // result.schema[0] = { agent_type: 'researcher', focus_area: '...', excluded_topics: [...] }
+ * // Inject result.schema[i] as boundary constraint into each agent's params
+ * ```
+ */
+class PartitionPlanner {
+    plannerFn;
+    overlapChecker;
+    strictOverlap;
+    constructor(plannerFn, options = {}) {
+        this.plannerFn = plannerFn;
+        this.overlapChecker = options.overlapChecker ?? createLexicalOverlapChecker();
+        this.strictOverlap = options.strictOverlap ?? false;
+    }
+    /**
+     * Generate a PartitionSchema for a goal and agent list.
+     *
+     * Runs the planner then validates for overlaps. If `strictOverlap` is true
+     * and overlaps are found, throws an error. Otherwise overlaps are reported
+     * in the result.
+     *
+     * @param goal - Natural language goal
+     * @param agents - Available team agents
+     * @param context - Optional context to feed to the planner
+     */
+    async plan(goal, agents, context) {
+        if (!goal || typeof goal !== 'string') {
+            throw new Error('Goal must be a non-empty string');
+        }
+        if (!agents || agents.length === 0) {
+            throw new Error('At least one agent is required');
+        }
+        const schema = await this.plannerFn(goal, agents, context);
+        const overlaps = await this.overlapChecker(schema);
+        const hasOverlaps = overlaps.length > 0;
+        if (hasOverlaps && this.strictOverlap) {
+            throw new Error(`Partition schema has semantic overlaps:\n${overlaps.join('\n')}`);
+        }
+        return {
+            schema,
+            overlaps,
+            hasOverlaps,
+            createdAt: Date.now(),
+        };
+    }
+    /**
+     * Inject partition boundary constraints into agent params.
+     *
+     * Given a PartitionSchema and an existing params object for an agent,
+     * returns a new params object with `_partitionConstraint` added.
+     *
+     * @param agentId - Agent ID to look up in the schema
+     * @param params - Existing task params
+     * @param schema - The partition schema
+     */
+    static injectConstraint(agentId, params, schema) {
+        const entry = schema.find((e) => e.agent_type === agentId);
+        if (!entry)
+            return params;
+        return {
+            ...params,
+            _partitionConstraint: {
+                focus_area: entry.focus_area,
+                excluded_topics: entry.excluded_topics,
+            },
+        };
+    }
+}
+exports.PartitionPlanner = PartitionPlanner;
+//# sourceMappingURL=partition-planner.js.map

package/dist/esm/lib/partition-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"partition-planner.js","sourceRoot":"","sources":["../../../lib/partition-planner.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAgFH,kEA4CC;AAWD,8DA6CC;AAMD,gDAuDC;AA5KD,+EAA+E;AAC/E,iEAAiE;AACjE,+EAA+E;AAE/E;;;;;;GAMG;AACH,SAAgB,2BAA2B;IACzC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;QACzB,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK;QACnE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;QACpE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO;KACjE,CAAC,CAAC;IAEH,SAAS,QAAQ,CAAC,IAAY;QAC5B,OAAO,IAAI,GAAG,CACZ,IAAI;aACD,WAAW,EAAE;aACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;aAC5B,KAAK,CAAC,KAAK,CAAC;aACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CACrD,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,EAAE,MAAuB,EAAqB,EAAE;QAC1D,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;gBAC/C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;gBAE/C,MAAM,MAAM,GAAa,EAAE,CAAC;gBAC5B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;oBAC5B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;wBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC7C,CAAC;gBAED,2EAA2E;gBAC3E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;gBACzD,MAAM,KAAK,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;gBAE5D,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;oBACtC,QAAQ,CAAC,IAAI,CACX,oBAAoB,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,cAAc,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,WAAW,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,cAAc,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,sBAAsB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrL,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,yBAAyB,CACvC,QAI+E,EAC/E,cAAsB;IAEtB,OAAO,KAAK,EAAE,IAAY,EAAE,MAAmB,EAAE,OAAiC,EAA4B,EAAE;QAC9G,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG;YACb,kEAAkE;YAClE,2EAA2E;YAC3E,EAAE;YACF,SAAS,IAAI,EAAE;YACf,EAAE;YACF,SAAS;YACT,SAAS;YACT,EAAE;YACF,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;YACpD,EAAE;YACF,wDAAwD;YACxD,8CAA8C;YAC9C,2EAA2E;YAC3E,uEAAuE;YACvE,EAAE;YACF,uDAAuD;YACvD,EAAE;YACF,UAAU;YACV,qJAAqJ;YACrJ,2IAA2I;SAC5I,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE7B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC3B,cAAc,EACd,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAC3C,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,EAAE,CAC7H,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,kBAAkB,EAAE,CAAC,CAAC;QAC9F,CAAC;QAED,OAAO,kBAAkB,CAAC,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACzG,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,IAAY;IAC7C,IAAI,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAE1B,wBAAwB;IACxB,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QACxF,IAAI,SAAS,KAAK,CAAC,CAAC,IAAI,UAAU,GAAG,SAAS,EAAE,CAAC;YAC/C,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;QAChE,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,UAAU,KAAK,CAAC,CAAC,IAAI,QAAQ,GAAG,UAAU,EAAE,CAAC;QAC/C,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,0CAA2C,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,sBAAsB;IACtB,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,CAAC,GAAG,KAAgC,CAAC;QAC3C,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,UAAU,mCAAmC,CAAC,CAAC;QAC3F,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC;YACtC,CAAC,CAAC,eAAe,GAAG,EAAE,CAAC;QACzB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,UAAU,EAAE,CAAC,CAAC,UAAoB;YAClC,UAAU,EAAE,CAAC,CAAC,UAAoB;YAClC,eAAe,EAAG,CAAC,CAAC,eAA6B,CAAC,GAAG,CAAC,MAAM,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+EAA+E;AAC/E,oCAAoC;AACpC,+EAA+E;AAE/E;;;;;;;;;;;GAWG;AACH,MAAa,gBAAgB;IACnB,SAAS,CAA2B;IACpC,cAAc,CAAuB;IACrC,aAAa,CAAU;IAE/B,YAAY,SAAmC,EAAE,UAAmC,EAAE;QACpF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,2BAA2B,EAAE,CAAC;QAC9E,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,KAAK,CAAC;IACtD,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,IAAI,CACR,IAAY,EACZ,MAAmB,EACnB,OAAiC;QAEjC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAExC,IAAI,WAAW,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,4CAA4C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrF,CAAC;QAED,OAAO;YACL,MAAM;YACN,QAAQ;YACR,WAAW;YACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,gBAAgB,CACrB,OAAe,EACf,MAA+B,EAC/B,MAAuB;QAEvB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK;YAAE,OAAO,MAAM,CAAC;QAC1B,OAAO;YACL,GAAG,MAAM;YACT,oBAAoB,EAAE;gBACpB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,eAAe,EAAE,KAAK,CAAC,eAAe;aACvC;SACF,CAAC;IACJ,CAAC;CACF;AA3ED,4CA2EC"}

package/dist/esm/lib/phase-pipeline.js

@@ -0,0 +1,367 @@
+"use strict";
+/**
+ * Phase Pipeline — Multi-phase workflows with approval gates
+ *
+ * Defines ordered execution phases. Each phase can optionally require human
+ * approval before proceeding. Phases may run their assigned agents in parallel
+ * or sequentially. Inspired by Claude Code's multi-phase orchestration pattern.
+ *
+ * @module PhasePipeline
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PhasePipeline = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+// ============================================================================
+// PHASE PIPELINE
+// ============================================================================
+/**
+ * Orchestrates multi-phase workflows with optional approval gates.
+ *
+ * @example
+ * ```typescript
+ * const pipeline = new PhasePipeline(registry, baseContext, {
+ *   phases: [
+ *     { name: 'research', agents: ['researcher'], parallel: false },
+ *     { name: 'review', agents: ['reviewer-a', 'reviewer-b'], parallel: true, requiresApproval: true },
+ *     { name: 'publish', agents: ['publisher'] },
+ *   ],
+ *   onApproval: async (name, result) => {
+ *     // In production: prompt the user
+ *     return { approved: true, approvedBy: 'admin' };
+ *   },
+ * });
+ *
+ * const result = await pipeline.run();
+ * ```
+ */
+class PhasePipeline {
+    registry;
+    baseContext;
+    options;
+    phaseResults = [];
+    _status = 'idle';
+    /** Running count of compactions for this pipeline run. */
+    _compactionCount = 0;
+    /** Summary produced by the most recent compaction, or null. */
+    _lastCompactionSummary = null;
+    constructor(registry, baseContext, options) {
+        if (!options.phases.length) {
+            throw new Error('PhasePipeline requires at least one phase');
+        }
+        const names = new Set();
+        for (const p of options.phases) {
+            if (names.has(p.name)) {
+                throw new Error(`Duplicate phase name: "${p.name}"`);
+            }
+            names.add(p.name);
+        }
+        this.registry = registry;
+        this.baseContext = baseContext;
+        this.options = options;
+    }
+    /** Current pipeline status */
+    get status() {
+        return this._status;
+    }
+    /** Results from all executed phases (even if pipeline was aborted) */
+    get results() {
+        return this.phaseResults;
+    }
+    /** Phase definitions */
+    get phases() {
+        return this.options.phases;
+    }
+    /**
+     * Execute the entire pipeline, phase by phase.
+     *
+     * For each phase:
+     * 1. Run all assigned agents (parallel or sequential)
+     * 2. If `requiresApproval`, call the approval callback and wait
+     * 3. If rejected, stop the pipeline
+     * 4. Otherwise move to the next phase
+     */
+    async run(defaultPayload) {
+        const pipelineStart = Date.now();
+        this._status = 'running';
+        this.phaseResults = [];
+        // ── Checkpoint resume ─────────────────────────────────────────────────
+        const startIndex = this._loadCheckpoint();
+        // ── End checkpoint resume ─────────────────────────────────────────────
+        for (let i = startIndex; i < this.options.phases.length; i++) {
+            const phaseDef = this.options.phases[i];
+            this.options.onPhaseStart?.(phaseDef.name, i);
+            const phaseStart = Date.now();
+            const agentResults = new Map();
+            let phaseStatus;
+            // --- Execute agents -------------------------------------------------
+            try {
+                if (phaseDef.parallel) {
+                    const executions = phaseDef.agents.map(agentId => {
+                        const payload = this.buildPayload(agentId, phaseDef, defaultPayload);
+                        const ctx = { ...this.baseContext, metadata: { ...this.baseContext.metadata, phase: phaseDef.name } };
+                        return this.executeWithTimeout(agentId, payload, ctx, phaseDef.timeoutMs)
+                            .then(result => ({ agentId, result }));
+                    });
+                    const results = await Promise.all(executions);
+                    for (const { agentId, result } of results) {
+                        agentResults.set(agentId, result);
+                    }
+                }
+                else {
+                    for (const agentId of phaseDef.agents) {
+                        const payload = this.buildPayload(agentId, phaseDef, defaultPayload);
+                        const ctx = { ...this.baseContext, metadata: { ...this.baseContext.metadata, phase: phaseDef.name } };
+                        const result = await this.executeWithTimeout(agentId, payload, ctx, phaseDef.timeoutMs);
+                        agentResults.set(agentId, result);
+                        if (!result.success)
+                            break; // stop this phase on first failure
+                    }
+                }
+                // Check if any agent failed
+                const anyFailed = Array.from(agentResults.values()).some(r => !r.success);
+                phaseStatus = anyFailed ? 'failed' : 'completed';
+            }
+            catch (err) {
+                phaseStatus = 'failed';
+            }
+            const phaseResult = {
+                phaseName: phaseDef.name,
+                status: phaseStatus,
+                agentResults,
+                durationMs: Date.now() - phaseStart,
+            };
+            // --- Check failure --------------------------------------------------
+            if (phaseStatus === 'failed') {
+                phaseResult.status = 'failed';
+                this.phaseResults.push(phaseResult);
+                this.options.onPhaseComplete?.(phaseResult, i);
+                this._saveCheckpoint(i); // save so resume can retry from this phase
+                this._status = 'failed';
+                return {
+                    success: false,
+                    phases: this.phaseResults,
+                    totalMs: Date.now() - pipelineStart,
+                    stoppedAt: phaseDef.name,
+                    stopReason: 'Phase failed',
+                };
+            }
+            // --- Approval gate --------------------------------------------------
+            if (phaseDef.requiresApproval) {
+                phaseResult.status = 'awaiting_approval';
+                const pipelineCtx = {
+                    completedPhases: [...this.phaseResults],
+                    currentPhaseIndex: i,
+                    totalPhases: this.options.phases.length,
+                };
+                let approval;
+                if (this.options.autoApprove) {
+                    approval = { approved: true, approvedBy: 'auto' };
+                }
+                else if (this.options.onApproval) {
+                    const timeoutMs = this.options.approvalTimeoutMs ?? 300_000;
+                    const timeoutError = new Error(`Approval timeout: phase "${phaseDef.name}" did not receive a decision within ${timeoutMs}ms`);
+                    approval = await Promise.race([
+                        this.options.onApproval(phaseDef.name, phaseResult, pipelineCtx),
+                        new Promise((_, reject) => setTimeout(() => reject(timeoutError), timeoutMs)),
+                    ]).catch((err) => ({
+                        approved: false,
+                        reason: err instanceof Error ? err.message : 'Approval callback failed',
+                    }));
+                }
+                else {
+                    // No approval handler and not auto-approved → reject by default
+                    approval = { approved: false, reason: 'No approval callback configured' };
+                }
+                phaseResult.approval = {
+                    approvedBy: approval.approvedBy,
+                    reason: approval.reason,
+                    timestamp: Date.now(),
+                };
+                if (!approval.approved) {
+                    phaseResult.status = 'rejected';
+                    this.phaseResults.push(phaseResult);
+                    this.options.onPhaseComplete?.(phaseResult, i);
+                    this._saveCheckpoint(i); // save so resume can retry from this phase
+                    this._status = 'rejected';
+                    return {
+                        success: false,
+                        phases: this.phaseResults,
+                        totalMs: Date.now() - pipelineStart,
+                        stoppedAt: phaseDef.name,
+                        stopReason: approval.reason ?? 'Approval rejected',
+                    };
+                }
+                phaseResult.status = 'approved';
+            }
+            this.phaseResults.push(phaseResult);
+            this.options.onPhaseComplete?.(phaseResult, i);
+            this._saveCheckpoint(i + 1); // advance checkpoint to next phase
+            // ── Trajectory compaction ─────────────────────────────────────────────
+            if (this.options.compaction) {
+                await this._maybeCompact();
+            }
+            // ── End compaction ────────────────────────────────────────────────────
+        }
+        this._status = 'completed';
+        return {
+            success: true,
+            phases: this.phaseResults,
+            totalMs: Date.now() - pipelineStart,
+        };
+    }
+    /** The summary produced by the last compaction, or `null` if none has occurred. */
+    get lastCompactionSummary() {
+        return this._lastCompactionSummary;
+    }
+    /** Total number of compactions performed so far in this run. */
+    get compactionCount() {
+        return this._compactionCount;
+    }
+    /**
+     * Reset the pipeline for re-execution.
+     */
+    reset() {
+        this.phaseResults = [];
+        this._status = 'idle';
+        this._compactionCount = 0;
+        this._lastCompactionSummary = null;
+    }
+    // --------------------------------------------------------------------------
+    // Checkpoint / resume
+    // --------------------------------------------------------------------------
+    /**
+     * Save the current pipeline state to the checkpoint file.
+     * Called automatically after each phase when `checkpointPath` is set.
+     * @internal
+     */
+    _saveCheckpoint(nextPhaseIndex) {
+        const path = this.options.checkpointPath;
+        if (!path)
+            return;
+        const resolved = (0, path_1.resolve)(path);
+        const dir = (0, path_1.dirname)(resolved);
+        try {
+            (0, fs_1.mkdirSync)(dir, { recursive: true });
+            const checkpoint = {
+                version: 1,
+                savedAt: new Date().toISOString(),
+                nextPhaseIndex,
+                completedPhases: this.phaseResults.map(pr => ({
+                    phaseName: pr.phaseName,
+                    status: pr.status,
+                    agentResults: Array.from(pr.agentResults.entries()),
+                    durationMs: pr.durationMs,
+                    approval: pr.approval,
+                })),
+            };
+            (0, fs_1.writeFileSync)(resolved, JSON.stringify(checkpoint, null, 2), 'utf-8');
+        }
+        catch {
+            // Non-fatal — checkpoint write failure should not abort the pipeline
+        }
+    }
+    /**
+     * Load a checkpoint from disk and restore phase results + next phase index.
+     * Returns the index of the next phase to run (0 if no checkpoint).
+     * @internal
+     */
+    _loadCheckpoint() {
+        const path = this.options.checkpointPath;
+        if (!path)
+            return 0;
+        const resolved = (0, path_1.resolve)(path);
+        if (!(0, fs_1.existsSync)(resolved))
+            return 0;
+        try {
+            const raw = (0, fs_1.readFileSync)(resolved, 'utf-8');
+            const cp = JSON.parse(raw);
+            if (cp.version !== 1)
+                return 0;
+            this.phaseResults = cp.completedPhases.map(pr => ({
+                phaseName: pr.phaseName,
+                status: pr.status,
+                agentResults: new Map(pr.agentResults),
+                durationMs: pr.durationMs,
+                approval: pr.approval,
+            }));
+            return cp.nextPhaseIndex;
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * Delete the checkpoint file for this pipeline (or any given path).
+     * Call this after a successful pipeline run to clean up.
+     *
+     * @example
+     * ```typescript
+     * const result = await pipeline.run();
+     * if (result.success) PhasePipeline.clearCheckpoint('./data/my-pipeline.checkpoint.json');
+     * ```
+     */
+    static clearCheckpoint(checkpointPath) {
+        const resolved = (0, path_1.resolve)(checkpointPath);
+        if ((0, fs_1.existsSync)(resolved)) {
+            try {
+                const { unlinkSync } = require('fs');
+                unlinkSync(resolved);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Private helpers
+    // --------------------------------------------------------------------------
+    /** @internal */
+    async _maybeCompact() {
+        const opts = this.options.compaction;
+        const threshold = opts.thresholdChars ?? 50_000;
+        let size = 0;
+        for (const pr of this.phaseResults) {
+            try {
+                size += JSON.stringify({ n: pr.phaseName, r: Array.from(pr.agentResults.values()) }).length;
+            }
+            catch {
+                // ignore serialisation errors
+            }
+        }
+        if (size <= threshold)
+            return;
+        const summary = await opts.summarize(this.phaseResults);
+        this._compactionCount++;
+        this._lastCompactionSummary = summary;
+        // Capture full history before it is replaced so callers can archive it
+        const archivedPhases = [...this.phaseResults];
+        // Replace the full history with a single compact stub phase
+        const stub = {
+            phaseName: `__compacted_${this._compactionCount}`,
+            status: 'completed',
+            agentResults: new Map([
+                ['__summary', { success: true, data: summary, metadata: { compacted: true, compactionCount: this._compactionCount } }],
+            ]),
+            durationMs: 0,
+        };
+        this.phaseResults = [stub];
+        opts.onCompact?.(summary, this._compactionCount, archivedPhases);
+    }
+    buildPayload(agentId, phase, defaultPayload) {
+        if (phase.payloadFactory) {
+            return phase.payloadFactory(agentId, this.phaseResults);
+        }
+        return defaultPayload ?? { action: phase.name, params: {} };
+    }
+    async executeWithTimeout(agentId, payload, ctx, timeoutMs) {
+        if (!timeoutMs) {
+            return this.registry.executeAgent(agentId, payload, ctx);
+        }
+        return Promise.race([
+            this.registry.executeAgent(agentId, payload, ctx),
+            new Promise((_, reject) => setTimeout(() => reject(new Error(`Phase timeout: agent "${agentId}" exceeded ${timeoutMs}ms`)), timeoutMs)),
+        ]);
+    }
+}
+exports.PhasePipeline = PhasePipeline;
+//# sourceMappingURL=phase-pipeline.js.map

package/dist/esm/lib/phase-pipeline.js.map

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