network-ai 4.15.3 → 5.1.0

package/dist/examples/02-fsm-pipeline.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * 02-fsm-pipeline.ts
+ * ──────────────────
+ * Demonstrates `JourneyFSM` — network-ai's Finite State Machine governance
+ * layer that controls which agents can act (and which tools they can use)
+ * depending on the current workflow state.
+ *
+ * You'll see:
+ *   ✅ Successful state transitions
+ *   🚫 A blocked action (wrong agent for current state)
+ *   🔒 A blocked tool (agent not authorized for that tool in this state)
+ *   📋 Full transition history at the end
+ *
+ * No API key needed.
+ *
+ * Run:
+ *   npx ts-node examples/02-fsm-pipeline.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const __1 = require("..");
+// ─── ANSI helpers ─────────────────────────────────────────────────────────────
+const c = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    cyan: '\x1b[36m',
+    green: '\x1b[32m',
+    red: '\x1b[31m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    dim: '\x1b[2m',
+};
+const banner = (msg) => console.log(`\n${c.bold}${c.cyan}---  ${msg}  ---${c.reset}`);
+const ok = (msg) => console.log(`  ${c.green}[OK]${c.reset} ${msg}`);
+const fail = (msg) => console.log(`  ${c.red}[NO]${c.reset} ${msg}`);
+const info = (msg) => console.log(`  ${c.dim}${msg}${c.reset}`);
+// ─── Helper: pretty-print a compliance result ─────────────────────────────────
+function showCompliance(label, result) {
+    if (result.allowed) {
+        ok(`  ${label}: ${c.green}ALLOWED${c.reset} in state [${result.currentState}]`);
+    }
+    else {
+        fail(`  ${label}: ${c.red}BLOCKED${c.reset} - ${result.reason}`);
+    }
+}
+// ─── Helper: pretty-print a transition result ─────────────────────────────────
+function showTransition(event, result) {
+    if (result.success) {
+        ok(`  "${event}": ${c.blue}${result.previousState}${c.reset} -> ${c.bold}${c.blue}${result.currentState}${c.reset}`);
+    }
+    else {
+        fail(`  "${event}" blocked - ${result.reason}`);
+    }
+}
+// ─── MAIN ─────────────────────────────────────────────────────────────────────
+async function main() {
+    banner('network-ai - FSM Governance Pipeline');
+    // ─── Build the FSM ──────────────────────────────────────────────────────────
+    //
+    // Pipeline stages:
+    //   INTAKE → VALIDATE → RESEARCH → EXECUTE → DELIVER → COMPLETE
+    //
+    // Each state declares:
+    //   • which agents are authorized to act
+    //   • which tools those agents may use
+    //
+    const fsm = new __1.JourneyFSM({
+        states: [
+            {
+                name: __1.WORKFLOW_STATES.INTAKE,
+                description: 'Initial intake and triage',
+                authorizedAgents: ['orchestrator'],
+                authorizedTools: {
+                    orchestrator: ['read_intake', 'triage_task'],
+                },
+            },
+            {
+                name: __1.WORKFLOW_STATES.VALIDATE,
+                description: 'Validate inputs and permissions',
+                authorizedAgents: ['orchestrator', 'validator'],
+                authorizedTools: {
+                    orchestrator: ['check_schema'],
+                    validator: ['run_validation', 'check_schema'],
+                },
+            },
+            {
+                name: __1.WORKFLOW_STATES.RESEARCH,
+                description: 'Gather information',
+                authorizedAgents: ['data_analyst', 'researcher'],
+                authorizedTools: {
+                    data_analyst: ['query_db', 'search_web', 'read_blackboard'],
+                    researcher: ['search_web', 'read_blackboard'],
+                },
+                timeoutMs: 60_000, // 60 second timeout
+            },
+            {
+                name: __1.WORKFLOW_STATES.EXECUTE,
+                description: 'Execute the main task',
+                authorizedAgents: ['executor', 'code_writer'],
+                authorizedTools: {
+                    executor: ['write_file', 'run_build'],
+                    code_writer: ['write_file', 'read_file'],
+                    '*': ['read_blackboard'],
+                },
+            },
+            {
+                name: __1.WORKFLOW_STATES.DELIVER,
+                description: 'Produce and write final output',
+                authorizedAgents: ['reporter', 'orchestrator'],
+                authorizedTools: {
+                    reporter: ['write_report', 'write_blackboard'],
+                    orchestrator: ['write_blackboard', 'notify'],
+                },
+            },
+            {
+                name: __1.WORKFLOW_STATES.COMPLETE,
+                description: 'Workflow complete',
+                authorizedAgents: ['*'],
+                authorizedTools: { '*': ['read_blackboard'] },
+            },
+        ],
+        transitions: [
+            { from: __1.WORKFLOW_STATES.INTAKE, event: 'intake_done', to: __1.WORKFLOW_STATES.VALIDATE, allowedBy: 'orchestrator' },
+            { from: __1.WORKFLOW_STATES.VALIDATE, event: 'valid', to: __1.WORKFLOW_STATES.RESEARCH, allowedBy: 'orchestrator' },
+            { from: __1.WORKFLOW_STATES.VALIDATE, event: 'invalid', to: __1.WORKFLOW_STATES.ERROR, allowedBy: '*' },
+            { from: __1.WORKFLOW_STATES.RESEARCH, event: 'research_done', to: __1.WORKFLOW_STATES.EXECUTE, allowedBy: 'data_analyst' },
+            { from: __1.WORKFLOW_STATES.EXECUTE, event: 'exec_done', to: __1.WORKFLOW_STATES.DELIVER, allowedBy: 'executor' },
+            { from: __1.WORKFLOW_STATES.DELIVER, event: 'delivered', to: __1.WORKFLOW_STATES.COMPLETE, allowedBy: '*' },
+        ],
+        initialState: __1.WORKFLOW_STATES.INTAKE,
+        // Called on every successful transition
+        onTransition: (result) => {
+            info(`     [FSM] ${result.previousState} -> ${result.currentState}`);
+        },
+        // Called when a compliance check fails
+        onViolation: (result) => {
+            info(`     [FSM] Violation: ${result.reason}`);
+        },
+    });
+    // ─── PHASE 1: Compliance checks in INTAKE state ──────────────────────────────
+    banner(`Current state: ${fsm.state}`);
+    info(`Authorized agents: [${fsm.stateDefinition.authorizedAgents.join(', ')}]`);
+    console.log();
+    showCompliance('orchestrator can act              ', fsm.checkCompliance('orchestrator'));
+    showCompliance('orchestrator uses read_intake     ', fsm.checkCompliance('orchestrator', 'read_intake'));
+    showCompliance('data_analyst (wrong state) can act', fsm.checkCompliance('data_analyst'));
+    showCompliance('orchestrator uses query_db (wrong)', fsm.checkCompliance('orchestrator', 'query_db'));
+    // ─── PHASE 2: Transition INTAKE → VALIDATE ────────────────────────────────┐
+    banner('Transitions');
+    showTransition('intake_done', fsm.transition('intake_done', 'orchestrator'));
+    info(`  Now in: ${c.bold}${fsm.state}${c.reset}`);
+    showTransition('valid', fsm.transition('valid', 'orchestrator'));
+    info(`  Now in: ${c.bold}${fsm.state}${c.reset}`); // RESEARCH
+    // Wrong agent trying to move out of RESEARCH (should fail)
+    showTransition('research_done by orchestrator (blocked)', fsm.transition('research_done', 'orchestrator'));
+    // Correct agent
+    showTransition('research_done', fsm.transition('research_done', 'data_analyst'));
+    info(`  Now in: ${c.bold}${fsm.state}${c.reset}`); // EXECUTE
+    // ─── PHASE 3: Tool checks in EXECUTE state ───────────────────────────────────
+    banner(`Tool Checks in state: ${fsm.state}`);
+    showCompliance('executor uses write_file     ', fsm.checkCompliance('executor', 'write_file'));
+    showCompliance('executor uses run_build      ', fsm.checkCompliance('executor', 'run_build'));
+    showCompliance('code_writer uses read_file   ', fsm.checkCompliance('code_writer', 'read_file'));
+    showCompliance('anyone reads blackboard (*)  ', fsm.checkCompliance('random_agent', 'read_blackboard'));
+    showCompliance('reporter (wrong state)       ', fsm.checkCompliance('reporter', 'write_report'));
+    // ─── PHASE 4: Finish the pipeline ────────────────────────────────────────────
+    banner('Finish Pipeline');
+    showTransition('exec_done', fsm.transition('exec_done', 'executor'));
+    showTransition('delivered', fsm.transition('delivered', 'reporter'));
+    info(`  Final state: ${c.bold}${c.green}${fsm.state}${c.reset}`);
+    // ─── PHASE 5: Transition history ─────────────────────────────────────────────
+    banner('Transition History');
+    const history = fsm.transitionHistory;
+    for (let i = 0; i < history.length; i++) {
+        const h = history[i];
+        const duration = h.exitedAt
+            ? `${h.exitedAt - h.enteredAt} ms`
+            : '(current)';
+        info(`  ${String(i + 1).padStart(2)}. ${c.blue}${h.state.padEnd(10)}${c.reset}  ` +
+            `entered ${new Date(h.enteredAt).toISOString().slice(11, 23)}  ` +
+            `${duration}`);
+    }
+    console.log(`\n${c.dim}Done.${c.reset}\n`);
+}
+main().catch(err => {
+    console.error('\n[ERROR]', err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=02-fsm-pipeline.js.map

package/dist/examples/02-fsm-pipeline.js.map

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

package/dist/examples/03-parallel-agents.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 03-parallel-agents.ts
+ * ─────────────────────
+ * Demonstrates `spawn_parallel_agents` — running multiple specialist agents
+ * concurrently and synthesizing their results with different strategies.
+ *
+ * Three agents work in parallel on the same topic:
+ *   • sentiment_agent  — tone & sentiment analysis
+ *   • keyword_agent    — key-phrase extraction
+ *   • summary_agent    — executive summary
+ *
+ * The demo runs through all four synthesis strategies so you can see how
+ * each one combines (or selects) the parallel outputs.
+ *
+ * No API key needed.
+ *
+ * Run:
+ *   npx ts-node examples/03-parallel-agents.ts
+ */
+export {};
+//# sourceMappingURL=03-parallel-agents.d.ts.map

package/dist/examples/03-parallel-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"03-parallel-agents.d.ts","sourceRoot":"","sources":["../../examples/03-parallel-agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/examples/03-parallel-agents.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * 03-parallel-agents.ts
+ * ─────────────────────
+ * Demonstrates `spawn_parallel_agents` — running multiple specialist agents
+ * concurrently and synthesizing their results with different strategies.
+ *
+ * Three agents work in parallel on the same topic:
+ *   • sentiment_agent  — tone & sentiment analysis
+ *   • keyword_agent    — key-phrase extraction
+ *   • summary_agent    — executive summary
+ *
+ * The demo runs through all four synthesis strategies so you can see how
+ * each one combines (or selects) the parallel outputs.
+ *
+ * No API key needed.
+ *
+ * Run:
+ *   npx ts-node examples/03-parallel-agents.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const __1 = require("..");
+// ─── ANSI helpers ─────────────────────────────────────────────────────────────
+const c = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    cyan: '\x1b[36m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    magenta: '\x1b[35m',
+    dim: '\x1b[2m',
+};
+const banner = (msg) => console.log(`\n${c.bold}${c.cyan}---  ${msg}  ---${c.reset}`);
+const row = (label, val) => console.log(`  ${c.bold}${label.padEnd(20)}${c.reset}${val}`);
+const info = (msg) => console.log(`  ${c.dim}${msg}${c.reset}`);
+// ─── Sample text the agents will analyze ─────────────────────────────────────
+const SAMPLE_TEXT = `
+  network-ai makes multi-agent coordination easy and secure. The shared
+  blackboard lets agents collaborate without tight coupling, and the permission
+  wall ensures every resource access is justified and audited. Real-world swarms
+  can now be built in minutes rather than months.
+`.trim();
+// ─── MAIN ─────────────────────────────────────────────────────────────────────
+async function main() {
+    banner('network-ai - Parallel Agents');
+    // ─── Register three specialist agents ──────────────────────────────────────
+    const adapter = new __1.CustomAdapter();
+    // Agent 1 — Sentiment analysis
+    adapter.registerHandler('sentiment_agent', async (payload) => {
+        const text = payload.handoff?.context?.text ?? '';
+        await sleep(250);
+        const positiveWords = (text.match(/easy|secure|simple|fast|safe|great|better|improve/gi) ?? []).length;
+        const negativeWords = (text.match(/hard|slow|insecure|bad|broken|fail|complex/gi) ?? []).length;
+        const total = positiveWords + negativeWords;
+        const score = total === 0 ? 0.5 : positiveWords / total;
+        return {
+            agent: 'sentiment_agent',
+            sentiment: score >= 0.7 ? 'positive' : score >= 0.4 ? 'neutral' : 'negative',
+            score: parseFloat(score.toFixed(2)),
+            positiveHits: positiveWords,
+            negativeHits: negativeWords,
+        };
+    });
+    // Agent 2 — Keyword extraction
+    adapter.registerHandler('keyword_agent', async (payload) => {
+        const text = payload.handoff?.context?.text ?? '';
+        await sleep(180);
+        // Very simple: pull out capitalized proper nouns and domain terms
+        const domainTerms = [
+            'network-ai', 'blackboard', 'agent', 'permission',
+            'orchestrator', 'swarm', 'coordination', 'security',
+        ];
+        const found = domainTerms.filter(t => text.toLowerCase().includes(t));
+        return {
+            agent: 'keyword_agent',
+            keywords: found,
+            count: found.length,
+            density: parseFloat((found.length / text.split(/\s+/).length).toFixed(3)),
+        };
+    });
+    // Agent 3 — Executive summary
+    adapter.registerHandler('summary_agent', async (payload) => {
+        const text = payload.handoff?.context?.text ?? '';
+        await sleep(320);
+        const sentences = text.split(/[.!?]+/).map(s => s.trim()).filter(Boolean);
+        const wordCount = text.split(/\s+/).length;
+        return {
+            agent: 'summary_agent',
+            wordCount,
+            sentenceCount: sentences.length,
+            firstSentence: sentences[0] ?? '',
+            readingTimeSeconds: Math.ceil(wordCount / 3), // ~180 wpm
+            oneLiner: 'A secure, blackboard-based multi-agent coordination library.',
+        };
+    });
+    // ─── Build orchestrator ─────────────────────────────────────────────────────
+    const orchestrator = (0, __1.createSwarmOrchestrator)({
+        qualityThreshold: 0, // demos don't need quality-gate filtering
+        trustLevels: [
+            { agentId: 'orchestrator', trustLevel: 0.9, allowedNamespaces: ['*'], allowedResources: ['*'] },
+            { agentId: 'sentiment_agent', trustLevel: 0.8, allowedNamespaces: ['task:'] },
+            { agentId: 'keyword_agent', trustLevel: 0.8, allowedNamespaces: ['task:'] },
+            { agentId: 'summary_agent', trustLevel: 0.8, allowedNamespaces: ['task:'] },
+        ],
+    });
+    await orchestrator.addAdapter(adapter);
+    const ctx = { agentId: 'orchestrator', taskId: 'demo-parallel', sessionId: 'session-p1' };
+    // Shared task params (3 agents, same input text)
+    const parallelTasks = [
+        {
+            agentType: 'custom:sentiment_agent',
+            taskPayload: {
+                instruction: 'Analyze sentiment of the provided text',
+                context: { text: SAMPLE_TEXT },
+            },
+        },
+        {
+            agentType: 'custom:keyword_agent',
+            taskPayload: {
+                instruction: 'Extract keywords from the provided text',
+                context: { text: SAMPLE_TEXT },
+            },
+        },
+        {
+            agentType: 'custom:summary_agent',
+            taskPayload: {
+                instruction: 'Summarize the provided text',
+                context: { text: SAMPLE_TEXT },
+            },
+        },
+    ];
+    // ─── Run with every synthesis strategy ──────────────────────────────────────
+    const strategies = ['merge', 'vote', 'chain', 'first-success'];
+    for (const strategy of strategies) {
+        banner(`Strategy: ${strategy.toUpperCase()}`);
+        const start = Date.now();
+        const result = await orchestrator.execute('spawn_parallel_agents', { tasks: parallelTasks, synthesisStrategy: strategy }, ctx);
+        const elapsed = Date.now() - start;
+        if (!result.success) {
+            console.log(`  ${c.yellow}Failed:${c.reset}`, result.error?.message);
+            continue;
+        }
+        const data = result.data;
+        // Per-agent stats
+        info('Individual results:');
+        for (const r of data.individualResults) {
+            const name = r.agentType.replace('custom:', '');
+            const icon = r.success ? c.green + '+' : c.yellow + 'x';
+            console.log(`    ${icon}${c.reset}  ${name.padEnd(18)} ${r.executionTime} ms`);
+        }
+        // Synthesis output (strategy-specific top-level fields)
+        info('\nSynthesized output (top-level fields):');
+        const synth = data.synthesizedResult;
+        for (const [k, v] of Object.entries(synth)) {
+            if (typeof v !== 'object') {
+                row(`  ${k}`, String(v));
+            }
+            else {
+                row(`  ${k}`, c.dim + JSON.stringify(v).slice(0, 80) + c.reset);
+            }
+        }
+        // Metrics
+        info('');
+        row('  Wall-clock time', `${elapsed} ms`);
+        row('  Success rate', `${(data.executionMetrics.successRate * 100).toFixed(0)} %`);
+        row('  Strategy used', data.executionMetrics.synthesisStrategy);
+    }
+    // ─── Demonstrate: result caching on second run ─────────────────────────────
+    banner('Second Run (cache hit demo)');
+    info('network-ai caches successful results on the blackboard.');
+    info('A second spawn_parallel_agents call with the same tasks should be instant.');
+    const t0 = Date.now();
+    const r2 = await orchestrator.execute('spawn_parallel_agents', { tasks: parallelTasks, synthesisStrategy: 'merge' }, ctx);
+    const t1 = Date.now();
+    if (r2.success) {
+        const d2 = r2.data;
+        const anyFromCache = d2.individualResults.some(r => r.executionTime === 0);
+        console.log(`  ${c.bold}Elapsed:${c.reset} ${t1 - t0} ms  ` +
+            (anyFromCache
+                ? `${c.green}<- cache hits detected (executionTime = 0)${c.reset}`
+                : `${c.yellow}(no cache hits)${c.reset}`));
+    }
+    console.log(`\n${c.dim}Done.${c.reset}\n`);
+}
+// ─── Utility ─────────────────────────────────────────────────────────────────
+const sleep = (ms) => new Promise(r => setTimeout(r, ms));
+main().catch(err => {
+    console.error('\n[ERROR]', err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=03-parallel-agents.js.map

package/dist/examples/03-parallel-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"03-parallel-agents.js","sourceRoot":"","sources":["../../examples/03-parallel-agents.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;AAEH,0BAIY;AAEZ,iFAAiF;AACjF,MAAM,CAAC,GAAG;IACR,KAAK,EAAI,SAAS;IAClB,IAAI,EAAK,SAAS;IAClB,IAAI,EAAK,UAAU;IACnB,KAAK,EAAI,UAAU;IACnB,MAAM,EAAG,UAAU;IACnB,IAAI,EAAK,UAAU;IACnB,OAAO,EAAE,UAAU;IACnB,GAAG,EAAM,SAAS;CACnB,CAAC;AACF,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,EAAE,CAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,QAAQ,GAAG,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;AAChE,MAAM,GAAG,GAAM,CAAC,KAAa,EAAE,GAAW,EAAE,EAAE,CAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC;AAChE,MAAM,IAAI,GAAK,CAAC,GAAW,EAAE,EAAE,CAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;AAE5C,gFAAgF;AAChF,MAAM,WAAW,GAAG;;;;;CAKnB,CAAC,IAAI,EAAE,CAAC;AAET,iFAAiF;AACjF,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,8BAA8B,CAAC,CAAC;IAEvC,8EAA8E;IAC9E,MAAM,OAAO,GAAG,IAAI,iBAAa,EAAE,CAAC;IAEpC,+BAA+B;IAC/B,OAAO,CAAC,eAAe,CAAC,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC3D,MAAM,IAAI,GAAI,OAAO,CAAC,OAAO,EAAE,OAA6B,EAAE,IAAI,IAAI,EAAE,CAAC;QACzE,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAEjB,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,qDAAqD,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACvG,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,8CAA8C,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAChG,MAAM,KAAK,GAAG,aAAa,GAAG,aAAa,CAAC;QAC5C,MAAM,KAAK,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,GAAG,KAAK,CAAC;QAExD,OAAO;YACL,KAAK,EAAM,iBAAiB;YAC5B,SAAS,EAAE,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;YAC5E,KAAK,EAAM,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACvC,YAAY,EAAE,aAAa;YAC3B,YAAY,EAAE,aAAa;SAC5B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,+BAA+B;IAC/B,OAAO,CAAC,eAAe,CAAC,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACzD,MAAM,IAAI,GAAI,OAAO,CAAC,OAAO,EAAE,OAA6B,EAAE,IAAI,IAAI,EAAE,CAAC;QACzE,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAEjB,kEAAkE;QAClE,MAAM,WAAW,GAAG;YAClB,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY;YACjD,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,UAAU;SACpD,CAAC;QACF,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtE,OAAO;YACL,KAAK,EAAK,eAAe;YACzB,QAAQ,EAAE,KAAK;YACf,KAAK,EAAK,KAAK,CAAC,MAAM;YACtB,OAAO,EAAG,UAAU,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;SAC3E,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,8BAA8B;IAC9B,OAAO,CAAC,eAAe,CAAC,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACzD,MAAM,IAAI,GAAI,OAAO,CAAC,OAAO,EAAE,OAA6B,EAAE,IAAI,IAAI,EAAE,CAAC;QACzE,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAEjB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;QAE3C,OAAO;YACL,KAAK,EAAQ,eAAe;YAC5B,SAAS;YACT,aAAa,EAAE,SAAS,CAAC,MAAM;YAC/B,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE;YACjC,kBAAkB,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,WAAW;YACzD,QAAQ,EAAK,8DAA8D;SAC5E,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,+EAA+E;IAC/E,MAAM,YAAY,GAAG,IAAA,2BAAuB,EAAC;QAC3C,gBAAgB,EAAE,CAAC,EAAI,0CAA0C;QACjE,WAAW,EAAE;YACX,EAAE,OAAO,EAAE,cAAc,EAAK,UAAU,EAAE,GAAG,EAAE,iBAAiB,EAAE,CAAC,GAAG,CAAC,EAAE,gBAAgB,EAAE,CAAC,GAAG,CAAC,EAAE;YAClG,EAAE,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,GAAG,EAAE,iBAAiB,EAAE,CAAC,OAAO,CAAC,EAAE;YAC7E,EAAE,OAAO,EAAE,eAAe,EAAI,UAAU,EAAE,GAAG,EAAE,iBAAiB,EAAE,CAAC,OAAO,CAAC,EAAE;YAC7E,EAAE,OAAO,EAAE,eAAe,EAAI,UAAU,EAAE,GAAG,EAAE,iBAAiB,EAAE,CAAC,OAAO,CAAC,EAAE;SAC9E;KACF,CAAC,CAAC;IACH,MAAM,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAEvC,MAAM,GAAG,GAAG,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;IAE1F,iDAAiD;IACjD,MAAM,aAAa,GAAG;QACpB;YACE,SAAS,EAAE,wBAAwB;YACnC,WAAW,EAAE;gBACX,WAAW,EAAE,wCAAwC;gBACrD,OAAO,EAAM,EAAE,IAAI,EAAE,WAAW,EAAE;aACnC;SACF;QACD;YACE,SAAS,EAAE,sBAAsB;YACjC,WAAW,EAAE;gBACX,WAAW,EAAE,yCAAyC;gBACtD,OAAO,EAAM,EAAE,IAAI,EAAE,WAAW,EAAE;aACnC;SACF;QACD;YACE,SAAS,EAAE,sBAAsB;YACjC,WAAW,EAAE;gBACX,WAAW,EAAE,6BAA6B;gBAC1C,OAAO,EAAM,EAAE,IAAI,EAAE,WAAW,EAAE;aACnC;SACF;KACF,CAAC;IAEF,+EAA+E;IAC/E,MAAM,UAAU,GAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;IAEpF,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,MAAM,CAAC,aAAa,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAE9C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CACvC,uBAAuB,EACvB,EAAE,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,QAAQ,EAAE,EACrD,GAAG,CACJ,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAEnC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACrE,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAInB,CAAC;QAEF,kBAAkB;QAClB,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YAChD,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC;QACjF,CAAC;QAED,wDAAwD;QACxD,IAAI,CAAC,0CAA0C,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC;QACrC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC1B,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAED,UAAU;QACV,IAAI,CAAC,EAAE,CAAC,CAAC;QACT,GAAG,CAAC,mBAAmB,EAAG,GAAG,OAAO,KAAK,CAAC,CAAC;QAC3C,GAAG,CAAC,gBAAgB,EAAM,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACvF,GAAG,CAAC,iBAAiB,EAAK,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;IACrE,CAAC;IAED,8EAA8E;IAC9E,MAAM,CAAC,6BAA6B,CAAC,CAAC;IACtC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IAChE,IAAI,CAAC,4EAA4E,CAAC,CAAC;IAEnF,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,OAAO,CACnC,uBAAuB,EACvB,EAAE,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,OAAO,EAAE,EACpD,GAAG,CACJ,CAAC;IACF,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEtB,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;QACf,MAAM,EAAE,GAAG,EAAE,CAAC,IAA+D,CAAC;QAC9E,MAAM,YAAY,GAAG,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC;QAC3E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,KAAK,IAAI,EAAE,GAAG,EAAE,OAAO;YACzD,CAAC,YAAY;gBACX,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,6CAA6C,CAAC,CAAC,KAAK,EAAE;gBAClE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,kBAAkB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,gFAAgF;AAChF,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAElE,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/examples/05-code-review-swarm.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 05-code-review-swarm.ts
+ * ───────────────────────
+ * 6 real LLM agents do a parallel code review of a buggy auth service.
+ *
+ * Architecture:
+ *   Wave   (parallel): 5 specialist reviewers — security, performance,
+ *                       reliability, testing, architecture
+ *   Final             : 1 coordinator — "top 3 blockers before you ship"
+ *
+ * Each agent makes a real gpt-5.2 call.
+ * Findings are coordinated through SharedBlackboard.
+ *
+ * Run:
+ *   npx ts-node examples/05-code-review-swarm.ts
+ *
+ * API key:
+ *   $env:OPENAI_API_KEY = Read-Host -MaskInput "API Key"
+ */
+export {};
+//# sourceMappingURL=05-code-review-swarm.d.ts.map

package/dist/examples/05-code-review-swarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"05-code-review-swarm.d.ts","sourceRoot":"","sources":["../../examples/05-code-review-swarm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}