network-ai 4.15.3 → 5.1.0

package/dist/demo-control-plane.js

@@ -0,0 +1,147 @@
+"use strict";
+/**
+ * Demo: ControlPlane — Multi-workspace dashboard
+ *
+ * Creates two workspaces, each with a WorkTree and LockedBlackboard,
+ * then simulates concurrent agent work across both.
+ *
+ * Usage:
+ *   npx ts-node demo-control-plane.ts
+ *   Open http://127.0.0.1:4800
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const work_tree_1 = require("./lib/work-tree");
+const locked_blackboard_1 = require("./lib/locked-blackboard");
+const control_plane_1 = require("./lib/control-plane");
+const path_1 = require("path");
+const delay = (ms) => new Promise(r => setTimeout(r, ms));
+async function main() {
+    // ── Workspace 1: Feature-Auth ──────────────────────────────────
+    const tree1 = new work_tree_1.WorkTree('root-auth', 'Auth System');
+    tree1.addChild('root-auth', { id: 'oauth', label: 'OAuth Provider' });
+    tree1.addChild('root-auth', { id: 'jwt', label: 'JWT Validation' });
+    tree1.addChild('root-auth', { id: 'session', label: 'Session Store' });
+    tree1.addChild('root-auth', { id: 'rate-limit', label: 'Rate Limiter' });
+    const bb1Dir = (0, path_1.join)(__dirname, 'data', 'demo-cp-auth');
+    const bb1 = new locked_blackboard_1.LockedBlackboard(bb1Dir);
+    // ── Workspace 2: Feature-Search ────────────────────────────────
+    const tree2 = new work_tree_1.WorkTree('root-search', 'Search Pipeline');
+    tree2.addChild('root-search', { id: 'indexer', label: 'Index Builder' });
+    tree2.addChild('root-search', { id: 'query-parser', label: 'Query Parser' });
+    tree2.addChild('root-search', { id: 'ranker', label: 'Ranking Engine' });
+    tree2.addChild('query-parser', { id: 'tokenizer', label: 'Tokenizer' });
+    tree2.addChild('query-parser', { id: 'synonyms', label: 'Synonym Resolver' });
+    const bb2Dir = (0, path_1.join)(__dirname, 'data', 'demo-cp-search');
+    const bb2 = new locked_blackboard_1.LockedBlackboard(bb2Dir);
+    // ── ControlPlane ───────────────────────────────────────────────
+    const cp = new control_plane_1.ControlPlane({ port: 4800 });
+    cp.addWorkspace('feature-auth', { tree: tree1, blackboard: bb1 });
+    cp.addWorkspace('feature-search', { tree: tree2, blackboard: bb2 });
+    cp.setOrchestrator('feature-auth', 'lead');
+    cp.setOrchestrator('feature-search', 'architect');
+    await cp.start();
+    console.log(`\n  ControlPlane running → ${cp.url}\n  2 workspaces registered\n  Press Ctrl+C to stop.\n`);
+    // ── Simulate Auth workspace ────────────────────────────────────
+    async function runAuth() {
+        cp.pushNarrative('feature-auth', 'Starting Auth System build');
+        cp.pushLog('feature-auth', 'lead', 'Orchestrating auth pipeline');
+        // OAuth
+        tree1.setStatus('oauth', 'running');
+        cp.pushLog('feature-auth', 'oauth-bot', 'Connecting to OAuth discovery endpoint');
+        await delay(1200);
+        const id1 = bb1.propose('auth:provider', { type: 'oauth2', issuer: 'https://auth.example.com' }, 'oauth-bot');
+        bb1.validate(id1, 'lead');
+        bb1.commit(id1);
+        cp.pushLog('feature-auth', 'oauth-bot', 'Provider config written to blackboard');
+        tree1.addTokens('oauth', 2400);
+        tree1.setStatus('oauth', 'completed');
+        // JWT
+        tree1.setStatus('jwt', 'running');
+        cp.pushLog('feature-auth', 'jwt-agent', 'Generating RS256 key pair');
+        await delay(1500);
+        const id2 = bb1.propose('auth:jwt_secret', 'RS256:auto-generated', 'jwt-agent');
+        bb1.validate(id2, 'lead');
+        bb1.commit(id2);
+        cp.pushLog('feature-auth', 'jwt-agent', 'JWT validation service ready');
+        tree1.addTokens('jwt', 1800);
+        tree1.setStatus('jwt', 'completed');
+        // Session Store
+        tree1.setStatus('session', 'running');
+        cp.pushLog('feature-auth', 'session-agent', 'Setting up Redis session store');
+        await delay(1000);
+        const id3 = bb1.propose('auth:session_ttl', 3600, 'session-agent');
+        bb1.validate(id3, 'lead');
+        bb1.commit(id3);
+        cp.pushLog('feature-auth', 'session-agent', 'Session TTL: 3600s');
+        tree1.addTokens('session', 900);
+        tree1.setStatus('session', 'completed');
+        // Rate Limiter
+        tree1.setStatus('rate-limit', 'running');
+        cp.pushLog('feature-auth', 'rate-agent', 'Configuring sliding window limiter');
+        await delay(800);
+        const id4 = bb1.propose('auth:rate_limit', { windowMs: 60000, max: 100 }, 'rate-agent');
+        bb1.validate(id4, 'lead');
+        bb1.commit(id4);
+        cp.pushLog('feature-auth', 'rate-agent', 'Rate limit: 100 req/min');
+        tree1.addTokens('rate-limit', 600);
+        tree1.setStatus('rate-limit', 'completed');
+        cp.pushNarrative('feature-auth', 'Auth system complete — all 4 components done');
+        cp.pushLog('feature-auth', 'lead', 'All auth tasks finished');
+    }
+    // ── Simulate Search workspace ──────────────────────────────────
+    async function runSearch() {
+        await delay(500); // slight offset
+        cp.pushNarrative('feature-search', 'Initializing search pipeline');
+        cp.pushLog('feature-search', 'architect', 'Coordinating search build');
+        // Tokenizer
+        tree2.setStatus('tokenizer', 'running');
+        cp.pushLog('feature-search', 'nlp-bot', 'Training BPE tokenizer');
+        await delay(1800);
+        const sid1 = bb2.propose('search:tokenizer', { type: 'bpe', vocabSize: 32000 }, 'nlp-bot');
+        bb2.validate(sid1, 'architect');
+        bb2.commit(sid1);
+        cp.pushLog('feature-search', 'nlp-bot', 'Tokenizer ready — 32k vocab');
+        tree2.addTokens('tokenizer', 3200);
+        tree2.setStatus('tokenizer', 'completed');
+        // Synonym Resolver
+        tree2.setStatus('synonyms', 'running');
+        cp.pushLog('feature-search', 'nlp-bot', 'Loading synonym graph');
+        await delay(1200);
+        const sid2 = bb2.propose('search:synonyms', { count: 45000, source: 'wordnet' }, 'nlp-bot');
+        bb2.validate(sid2, 'architect');
+        bb2.commit(sid2);
+        tree2.addTokens('synonyms', 1800);
+        tree2.setStatus('synonyms', 'completed');
+        // Query Parser (parent — auto-completes when children done)
+        cp.pushLog('feature-search', 'architect', 'Query parser subtasks complete');
+        // Index Builder
+        tree2.setStatus('indexer', 'running');
+        cp.pushLog('feature-search', 'indexer', 'Building inverted index');
+        await delay(2000);
+        const sid3 = bb2.propose('search:index_status', { shards: 8, docsIndexed: 1_200_000 }, 'indexer');
+        bb2.validate(sid3, 'architect');
+        bb2.commit(sid3);
+        cp.pushLog('feature-search', 'indexer', 'Indexed 1.2M documents across 8 shards');
+        tree2.addTokens('indexer', 5400);
+        tree2.setStatus('indexer', 'completed');
+        // Ranking Engine
+        tree2.setStatus('ranker', 'running');
+        cp.pushLog('feature-search', 'ranker', 'Training BM25 + neural reranker');
+        await delay(1400);
+        const sid4 = bb2.propose('search:ranking_model', { algo: 'bm25+neural', ndcg: 0.87 }, 'ranker');
+        bb2.validate(sid4, 'architect');
+        bb2.commit(sid4);
+        cp.pushLog('feature-search', 'ranker', 'NDCG@10 = 0.87');
+        tree2.addTokens('ranker', 4100);
+        tree2.setStatus('ranker', 'completed');
+        cp.pushNarrative('feature-search', 'Search pipeline complete');
+        cp.pushLog('feature-search', 'architect', 'All search tasks finished');
+    }
+    // Run both workspaces concurrently
+    await Promise.all([runAuth(), runSearch()]);
+    console.log('  Simulation complete. Dashboard remains live. Press Ctrl+C to exit.\n');
+    // Keep alive
+    await new Promise(() => { });
+}
+main().catch(console.error);
+//# sourceMappingURL=demo-control-plane.js.map

package/dist/demo-control-plane.js.map

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

package/dist/demo-worktree-dashboard.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=demo-worktree-dashboard.d.ts.map

package/dist/demo-worktree-dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-worktree-dashboard.d.ts","sourceRoot":"","sources":["../demo-worktree-dashboard.ts"],"names":[],"mappings":""}

package/dist/demo-worktree-dashboard.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const work_tree_1 = require("./lib/work-tree");
+const work_tree_dashboard_1 = require("./lib/work-tree-dashboard");
+async function main() {
+    const tree = new work_tree_1.WorkTree('root', 'Build Feature X — Code Review Swarm');
+    const dashboard = new work_tree_dashboard_1.WorkTreeDashboard(tree, { port: 4821 });
+    dashboard.setOrchestrator('lead');
+    await dashboard.start();
+    console.log(`\n  Dashboard: ${dashboard.url}\n`);
+    console.log('  Open the Agents tab to see agent orchestration view.\n');
+    // Build tree structure
+    tree.addChild('root', { id: 'design', label: 'Design API', agent: 'architect' });
+    tree.addChild('root', { id: 'impl', label: 'Implement', agent: 'lead' });
+    tree.addChild('root', { id: 'test', label: 'Test Suite', agent: 'qa' });
+    tree.addChild('design', { id: 'd1', label: 'Schema design', agent: 'architect' });
+    tree.addChild('design', { id: 'd2', label: 'Review endpoints', agent: 'architect' });
+    tree.addChild('impl', { id: 'i1', label: 'Auth module', agent: 'worker-1' });
+    tree.addChild('impl', { id: 'i2', label: 'DB schema', agent: 'worker-2' });
+    tree.addChild('impl', { id: 'i3', label: 'REST handlers', agent: 'worker-3' });
+    tree.addChild('i1', { id: 'i1a', label: 'JWT tokens', agent: 'worker-1' });
+    tree.addChild('i1', { id: 'i1b', label: 'OAuth flow', agent: 'worker-1' });
+    tree.addChild('test', { id: 't1', label: 'Unit tests', agent: 'qa' });
+    tree.addChild('test', { id: 't2', label: 'Integration tests', agent: 'qa' });
+    // Simulate agent work with timed updates (now with pushLog calls)
+    const steps = [
+        [500, () => { dashboard.pushNarrative('Orchestration started. Dispatching design phase to architect.'); }],
+        [1000, () => {
+                tree.setStatus('d1', 'running');
+                dashboard.pushLog('architect', 'Starting schema design for Feature X');
+                dashboard.pushLog('lead', 'Assigned design tasks to architect agent', 'info');
+            }],
+        [2000, () => {
+                tree.setStatus('d1', 'completed');
+                tree.addTokens('d1', 120);
+                dashboard.pushLog('architect', 'Schema design complete — 3 tables, 12 fields');
+                dashboard.pushNarrative('Schema design finished. Moving to endpoint review.');
+            }],
+        [2500, () => {
+                tree.setStatus('d2', 'running');
+                dashboard.pushLog('architect', 'Reviewing REST endpoint definitions');
+            }],
+        [4000, () => {
+                tree.setStatus('d2', 'completed');
+                tree.addTokens('d2', 80);
+                dashboard.pushLog('architect', 'Endpoint review done — 5 endpoints approved');
+                dashboard.pushNarrative('Design phase complete. Starting parallel implementation.');
+            }],
+        [5000, () => {
+                tree.setStatus('i1a', 'running');
+                tree.setStatus('i2', 'running');
+                dashboard.pushLog('worker-1', 'Implementing JWT token signing/verification');
+                dashboard.pushLog('worker-2', 'Creating database schema migrations');
+                dashboard.pushLog('lead', 'Dispatched auth + DB work to workers in parallel');
+                dashboard.pushNarrative('Implementation phase: 2 workers running in parallel.');
+            }],
+        [6500, () => {
+                tree.addTokens('i1a', 200);
+                dashboard.pushLog('worker-1', 'Generated RSA-256 key pair for JWT');
+                dashboard.pushLog('worker-2', 'Migration 001: users table created');
+            }],
+        [8000, () => {
+                tree.setStatus('i1a', 'completed');
+                tree.addTokens('i1a', 150);
+                dashboard.pushLog('worker-1', 'JWT module done — sign, verify, refresh implemented');
+            }],
+        [8500, () => {
+                tree.setStatus('i1b', 'running');
+                dashboard.pushLog('worker-1', 'Starting OAuth2 flow implementation');
+                dashboard.pushLog('lead', 'Worker-1 moving to OAuth after JWT completion');
+            }],
+        [9500, () => {
+                tree.setStatus('i2', 'completed');
+                tree.addTokens('i2', 180);
+                dashboard.pushLog('worker-2', 'All DB migrations complete — 3 tables ready');
+                dashboard.pushNarrative('DB schema done. Worker-2 now idle.');
+            }],
+        [10000, () => {
+                tree.setStatus('i3', 'running');
+                dashboard.pushLog('worker-3', 'Building REST handler boilerplate');
+                dashboard.pushLog('lead', 'Assigned REST handlers to worker-3');
+            }],
+        [11000, () => {
+                tree.addTokens('i1b', 300);
+                dashboard.pushLog('worker-1', 'OAuth callback + token exchange working');
+                dashboard.pushLog('worker-3', 'GET /api/users endpoint implemented');
+            }],
+        [12000, () => {
+                tree.setStatus('i3', 'failed');
+                tree.addTokens('i3', 90);
+                dashboard.pushLog('worker-3', 'FAILED: POST /api/auth — validation error in schema', 'error');
+                dashboard.pushNarrative('⚠ Worker-3 failed on REST handlers. Needs investigation.');
+            }],
+        [13000, () => {
+                tree.setStatus('i1b', 'completed');
+                tree.addTokens('i1b', 100);
+                dashboard.pushLog('worker-1', 'OAuth flow complete with PKCE support');
+                dashboard.pushNarrative('Auth module fully complete. Moving to test phase.');
+            }],
+        [14000, () => {
+                tree.setStatus('t1', 'running');
+                dashboard.pushLog('qa', 'Running unit test suite (47 test cases)');
+                dashboard.pushLog('lead', 'Test phase started — QA agent running unit tests');
+            }],
+        [16000, () => {
+                tree.setStatus('t1', 'completed');
+                tree.addTokens('t1', 250);
+                dashboard.pushLog('qa', 'Unit tests: 47/47 passed ✔');
+            }],
+        [17000, () => {
+                tree.setStatus('t2', 'running');
+                dashboard.pushLog('qa', 'Starting integration test suite');
+                dashboard.pushNarrative('Integration testing in progress. Almost done.');
+            }],
+        [19000, () => {
+                tree.setStatus('t2', 'completed');
+                tree.addTokens('t2', 300);
+                dashboard.pushLog('qa', 'Integration tests: 12/12 passed ✔');
+                dashboard.pushNarrative('All tests passed. Orchestration nearly complete (1 failure in REST handlers).');
+            }],
+        [20000, () => {
+                dashboard.pushNarrative('Orchestration finished. Summary: 10/11 tasks succeeded, 1 failed.');
+                console.log('\n  Simulation complete. Press Ctrl+C to exit.\n');
+            }],
+    ];
+    for (const [delay, fn] of steps) {
+        setTimeout(fn, delay);
+    }
+}
+main().catch(console.error);
+//# sourceMappingURL=demo-worktree-dashboard.js.map

package/dist/demo-worktree-dashboard.js.map

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

package/dist/examples/01-hello-swarm.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 01-hello-swarm.ts
+ * ─────────────────
+ * The simplest possible network-ai demo: three agents (Researcher, Analyst,
+ * Reporter) passing work through a shared blackboard.
+ *
+ * No API key needed — all agents are plain async functions.
+ *
+ * Run:
+ *   npx ts-node examples/01-hello-swarm.ts
+ */
+export {};
+//# sourceMappingURL=01-hello-swarm.d.ts.map

package/dist/examples/01-hello-swarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"01-hello-swarm.d.ts","sourceRoot":"","sources":["../../examples/01-hello-swarm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/examples/01-hello-swarm.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * 01-hello-swarm.ts
+ * ─────────────────
+ * The simplest possible network-ai demo: three agents (Researcher, Analyst,
+ * Reporter) passing work through a shared blackboard.
+ *
+ * No API key needed — all agents are plain async functions.
+ *
+ * Run:
+ *   npx ts-node examples/01-hello-swarm.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const __1 = require("..");
+// ─── ANSI helpers for readable terminal output ────────────────────────────────
+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 step = (agent, msg) => console.log(`  ${c.green}[${agent}]${c.reset} ${msg}`);
+const info = (msg) => console.log(`  ${c.dim}${msg}${c.reset}`);
+// ─── MAIN ─────────────────────────────────────────────────────────────────────
+async function main() {
+    banner('network-ai - Hello Swarm');
+    // 1. Shared blackboard — the agents' shared memory
+    //    (writes to swarm-blackboard.md in the workspace root)
+    const blackboard = new __1.SharedBlackboard(process.cwd());
+    // Register each agent identity on the blackboard.
+    // Token + namespace scoping means agents can only see keys they're allowed to.
+    blackboard.registerAgent('researcher', 'tok-researcher', ['task:', 'research:']);
+    blackboard.registerAgent('analyst', 'tok-analyst', ['task:', 'research:', 'analysis:']);
+    blackboard.registerAgent('reporter', 'tok-reporter', ['task:', 'analysis:', 'report:']);
+    // 2. CustomAdapter — wire plain async functions as named agents
+    const adapter = new __1.CustomAdapter();
+    adapter.registerHandler('researcher', async (payload) => {
+        const topic = payload.handoff?.instruction ?? 'unknown topic';
+        step('Researcher', `Investigating: "${topic}"`);
+        // Simulate research work
+        await sleep(300);
+        const findings = {
+            topic,
+            sources: 3,
+            keyFacts: [
+                'Multi-agent systems reduce task latency by ~40 %.',
+                'Shared blackboard architecture avoids tight coupling.',
+                'Permission walls prevent unauthorized resource access.',
+            ],
+            confidence: 0.87,
+        };
+        // Write findings to the shared blackboard
+        blackboard.write('research:findings', findings, 'researcher', 3600, 'tok-researcher');
+        step('Researcher', `Wrote findings to blackboard  ${c.dim}(research:findings)${c.reset}`);
+        return findings;
+    });
+    adapter.registerHandler('analyst', async () => {
+        step('Analyst', 'Reading researcher findings from blackboard...');
+        const entry = blackboard.read('research:findings');
+        if (!entry)
+            throw new Error('No findings on blackboard - did Researcher run first?');
+        const findings = entry.value;
+        await sleep(200);
+        const analysis = {
+            inputTopic: findings.topic,
+            factCount: findings.keyFacts.length,
+            confidence: findings.confidence,
+            recommendation: findings.confidence >= 0.8
+                ? 'High confidence - proceed to report.'
+                : 'Low confidence - request additional research.',
+            summary: `Reviewed ${findings.keyFacts.length} facts about [${findings.topic}]. ` +
+                `Confidence score: ${(findings.confidence * 100).toFixed(0)} %.`,
+        };
+        blackboard.write('analysis:result', analysis, 'analyst', 3600, 'tok-analyst');
+        step('Analyst', `Wrote analysis to blackboard  ${c.dim}(analysis:result)${c.reset}`);
+        return analysis;
+    });
+    adapter.registerHandler('reporter', async () => {
+        step('Reporter', 'Reading analysis from blackboard...');
+        const entry = blackboard.read('analysis:result');
+        if (!entry)
+            throw new Error('No analysis on blackboard - did Analyst run first?');
+        const analysis = entry.value;
+        await sleep(150);
+        const report = {
+            title: `Swarm Research Report: ${analysis.inputTopic}`,
+            generatedAt: new Date().toISOString(),
+            summary: analysis.summary,
+            recommendation: analysis.recommendation,
+            status: 'FINAL',
+        };
+        blackboard.write('report:final', report, 'reporter', 7200, 'tok-reporter');
+        step('Reporter', `Published final report  ${c.dim}(report:final)${c.reset}`);
+        return report;
+    });
+    // 3. Build the orchestrator and register the adapter
+    const orchestrator = (0, __1.createSwarmOrchestrator)({
+        qualityThreshold: 0, // demos don't need quality-gate filtering
+        trustLevels: [
+            { agentId: 'orchestrator', trustLevel: 0.9, allowedNamespaces: ['*'], allowedResources: ['*'] },
+            { agentId: 'researcher', trustLevel: 0.8, allowedNamespaces: ['task:', 'research:'] },
+            { agentId: 'analyst', trustLevel: 0.8, allowedNamespaces: ['task:', 'research:', 'analysis:'] },
+            { agentId: 'reporter', trustLevel: 0.8, allowedNamespaces: ['task:', 'analysis:', 'report:'] },
+        ],
+    });
+    await orchestrator.addAdapter(adapter);
+    const ctx = { agentId: 'orchestrator', taskId: 'demo-001', sessionId: 'session-demo' };
+    // ─── STEP 1: Delegate to Researcher ────────────────────────────────────────
+    banner('Step 1 - Researcher');
+    await orchestrator.execute('delegate_task', {
+        targetAgent: 'custom:researcher',
+        taskPayload: {
+            instruction: 'multi-agent coordination patterns',
+            expectedOutput: 'key facts with confidence score',
+        },
+    }, ctx);
+    // ─── STEP 2: Delegate to Analyst ───────────────────────────────────────────
+    banner('Step 2 - Analyst');
+    await orchestrator.execute('delegate_task', {
+        targetAgent: 'custom:analyst',
+        taskPayload: {
+            instruction: 'analyze researcher findings',
+            expectedOutput: 'summary + recommendation',
+        },
+    }, ctx);
+    // ─── STEP 3: Delegate to Reporter ──────────────────────────────────────────
+    banner('Step 3 - Reporter');
+    await orchestrator.execute('delegate_task', {
+        targetAgent: 'custom:reporter',
+        taskPayload: {
+            instruction: 'produce final report from analysis',
+            expectedOutput: 'formatted report object',
+        },
+    }, ctx);
+    // ─── FINAL REPORT ──────────────────────────────────────────────────────────
+    banner('Final Report');
+    const finalEntry = blackboard.read('report:final');
+    if (finalEntry) {
+        const report = finalEntry.value;
+        console.log(`\n  ${c.bold}${c.magenta}${report.title}${c.reset}`);
+        console.log(`  ${c.dim}Generated: ${report.generatedAt}${c.reset}`);
+        console.log(`\n  ${c.bold}Summary:${c.reset}        ${report.summary}`);
+        console.log(`  ${c.bold}Recommendation:${c.reset} ${report.recommendation}`);
+        console.log(`  ${c.bold}Status:${c.reset}         ${c.green}${report.status}${c.reset}\n`);
+    }
+    // ─── BLACKBOARD SNAPSHOT ───────────────────────────────────────────────────
+    info('Blackboard keys written this session:');
+    const snap = blackboard.getSnapshot();
+    for (const [key, entry] of Object.entries(snap)) {
+        info(`  ${c.blue}${key}${c.reset}  <-  ${entry.sourceAgent}  @ ${entry.timestamp.slice(11, 19)}`);
+    }
+    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=01-hello-swarm.js.map

package/dist/examples/01-hello-swarm.js.map

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

package/dist/examples/02-fsm-pipeline.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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
+ */
+export {};
+//# sourceMappingURL=02-fsm-pipeline.d.ts.map

package/dist/examples/02-fsm-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"02-fsm-pipeline.d.ts","sourceRoot":"","sources":["../../examples/02-fsm-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}