network-ai 5.0.0 → 5.1.0

package/dist/adapters/orchestrator-adapter.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * Orchestrator Adapter — Wrap a child SwarmOrchestrator as an agent
+ *
+ * This adapter enables hierarchical multi-orchestrator coordination.
+ * A parent SwarmOrchestrator treats a child SwarmOrchestrator as just
+ * another agent via the adapter system. Each child has its own
+ * LockedBlackboard with its own filesystem mutex, so the propose →
+ * validate → commit pattern prevents overwrites at every level.
+ *
+ * Usage:
+ *   const child = new SwarmOrchestrator('./boards/child-project', childRegistry);
+ *   const adapter = new OrchestratorAdapter();
+ *   adapter.registerOrchestrator('child-team', child, {
+ *     description: 'Backend team orchestrator',
+ *   });
+ *
+ *   // Parent orchestrator delegates to the child as a normal agent
+ *   await parentOrchestrator.addAdapter(adapter);
+ *   await parentOrchestrator.execute('delegate_task', {
+ *     targetAgent: 'orchestrator:child-team',
+ *     taskPayload: { instruction: 'Refactor the auth module' },
+ *   }, { agentId: 'root' });
+ *
+ * The child orchestrator receives the task, decomposes it across its own
+ * agents, and returns the aggregated result. The parent sees it as one
+ * atomic response — the hierarchy is transparent.
+ *
+ * @module OrchestratorAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrchestratorAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+class OrchestratorAdapter extends base_adapter_1.BaseAdapter {
+    name = 'orchestrator';
+    version = '1.0.0';
+    children = new Map();
+    get capabilities() {
+        return {
+            streaming: false,
+            parallel: true,
+            bidirectional: false,
+            discovery: true,
+            authentication: false,
+            statefulSessions: true,
+        };
+    }
+    /**
+     * Register a child SwarmOrchestrator as an agent.
+     * The child keeps its own blackboard, adapters, and lock — full isolation.
+     */
+    registerOrchestrator(orchestratorId, orchestrator, config) {
+        if (!orchestratorId || typeof orchestratorId !== 'string') {
+            throw new Error('orchestratorId must be a non-empty string');
+        }
+        if (!orchestrator || typeof orchestrator.execute !== 'function') {
+            throw new Error('orchestrator must implement execute()');
+        }
+        const childConfig = {
+            description: config?.description ?? `Child orchestrator: ${orchestratorId}`,
+            capabilities: config?.capabilities ?? ['orchestration', 'delegation', 'parallel'],
+            defaultTargetAgent: config?.defaultTargetAgent,
+            timeout: config?.timeout ?? 120_000,
+        };
+        this.children.set(orchestratorId, {
+            orchestrator,
+            config: childConfig,
+            busy: false,
+        });
+        this.registerLocalAgent({
+            id: orchestratorId,
+            name: orchestrator.name ?? orchestratorId,
+            description: childConfig.description,
+            capabilities: childConfig.capabilities,
+            status: 'available',
+            metadata: {
+                type: 'orchestrator',
+                timeout: childConfig.timeout,
+                defaultTargetAgent: childConfig.defaultTargetAgent,
+            },
+        });
+    }
+    /**
+     * Remove a child orchestrator from this adapter.
+     */
+    removeOrchestrator(orchestratorId) {
+        const removed = this.children.delete(orchestratorId);
+        if (removed) {
+            this.unregisterAgent(orchestratorId);
+        }
+        return removed;
+    }
+    /**
+     * Execute a task on a child orchestrator.
+     *
+     * The payload is translated into a `delegate_task` call on the child.
+     * If `handoff.targetAgent` is set, it becomes the target within the child
+     * swarm. Otherwise, the child's `defaultTargetAgent` is used, or the
+     * child decides its own routing.
+     */
+    async executeAgent(agentId, payload, context) {
+        this.ensureReady();
+        const child = this.children.get(agentId);
+        if (!child) {
+            return this.errorResult('ORCHESTRATOR_NOT_FOUND', `Child orchestrator "${agentId}" is not registered. Use registerOrchestrator().`, false);
+        }
+        const startTime = Date.now();
+        child.busy = true;
+        // Update agent status
+        const agentInfo = this.registeredAgents.get(agentId);
+        if (agentInfo)
+            agentInfo.status = 'busy';
+        try {
+            const instruction = payload.handoff?.instruction
+                ?? payload.params?.instruction
+                ?? JSON.stringify(payload.params);
+            // Determine the target agent within the child swarm
+            const innerTarget = payload.handoff?.targetAgent
+                ?? child.config.defaultTargetAgent
+                ?? 'orchestrator';
+            const childParams = {
+                targetAgent: innerTarget,
+                taskPayload: {
+                    instruction,
+                    context: payload.handoff?.context ?? payload.params?.context,
+                    constraints: payload.handoff?.constraints ?? payload.params?.constraints,
+                    expectedOutput: payload.handoff?.expectedOutput ?? payload.params?.expectedOutput,
+                },
+                timeout: child.config.timeout,
+            };
+            // Forward blackboard snapshot if provided (cross-level context sharing)
+            if (payload.blackboardSnapshot) {
+                childParams.parentBlackboardSnapshot = payload.blackboardSnapshot;
+            }
+            const childContext = {
+                agentId: context.agentId,
+                taskId: context.taskId,
+                sessionId: context.sessionId,
+            };
+            // Execute on the child orchestrator with timeout
+            const result = await Promise.race([
+                child.orchestrator.execute('delegate_task', childParams, childContext),
+                this.timeoutAfter(child.config.timeout ?? 120_000),
+            ]);
+            const elapsed = Date.now() - startTime;
+            if (!result.success) {
+                return this.errorResult(result.error?.code ?? 'CHILD_EXECUTION_FAILED', result.error?.message ?? 'Child orchestrator returned failure', result.error?.recoverable ?? true, result.error);
+            }
+            return this.successResult({
+                orchestratorId: agentId,
+                childResult: result.data,
+                hierarchy: true,
+            }, elapsed);
+        }
+        catch (error) {
+            const elapsed = Date.now() - startTime;
+            if (error instanceof Error && error.message === 'ORCHESTRATOR_TIMEOUT') {
+                return this.errorResult('CHILD_TIMEOUT', `Child orchestrator "${agentId}" timed out after ${child.config.timeout}ms`, true);
+            }
+            return this.errorResult('CHILD_EXECUTION_ERROR', error instanceof Error ? error.message : 'Child orchestrator execution failed', true, error);
+        }
+        finally {
+            child.busy = false;
+            const agentInfo2 = this.registeredAgents.get(agentId);
+            if (agentInfo2)
+                agentInfo2.status = 'available';
+        }
+    }
+    /**
+     * Query the internal state of a child orchestrator.
+     * Returns agents, blackboard snapshot, and tasks from the child swarm.
+     * The parent can use this for unified visibility across the hierarchy.
+     */
+    async queryChildState(orchestratorId, scope = 'all') {
+        const child = this.children.get(orchestratorId);
+        if (!child)
+            return null;
+        const result = await child.orchestrator.execute('query_swarm_state', { scope }, { agentId: 'parent-orchestrator' });
+        return {
+            orchestratorId,
+            busy: child.busy,
+            swarmState: result.success ? result.data : null,
+            queriedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Query state of all registered child orchestrators.
+     * This is the foundation for the unified ControlPlane view.
+     */
+    async queryAllChildStates(scope = 'all') {
+        const entries = Array.from(this.children.keys());
+        const results = await Promise.all(entries.map(id => this.queryChildState(id, scope)));
+        return results.filter((s) => s !== null);
+    }
+    /**
+     * Get the list of registered child orchestrator IDs.
+     */
+    listOrchestrators() {
+        return Array.from(this.children.keys());
+    }
+    /**
+     * Check if a specific child orchestrator is currently busy.
+     */
+    isChildBusy(orchestratorId) {
+        return this.children.get(orchestratorId)?.busy ?? false;
+    }
+    async shutdown() {
+        this.children.clear();
+        await super.shutdown();
+    }
+    timeoutAfter(ms) {
+        return new Promise((_, reject) => {
+            setTimeout(() => reject(new Error('ORCHESTRATOR_TIMEOUT')), ms);
+        });
+    }
+}
+exports.OrchestratorAdapter = OrchestratorAdapter;
+//# sourceMappingURL=orchestrator-adapter.js.map

package/dist/adapters/orchestrator-adapter.js.map

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

package/dist/demo-control-plane.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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
+ */
+export {};
+//# sourceMappingURL=demo-control-plane.d.ts.map

package/dist/demo-control-plane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-control-plane.d.ts","sourceRoot":"","sources":["../demo-control-plane.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

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":";;AAAA,+CAA2C;AAC3C,mEAA8D;AAE9D,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,IAAI,oBAAQ,CAAC,MAAM,EAAE,qCAAqC,CAAC,CAAC;IAEzE,MAAM,SAAS,GAAG,IAAI,uCAAiB,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;IACxB,OAAO,CAAC,GAAG,CAAC,kBAAkB,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;IAExE,uBAAuB;IACvB,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IACjF,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACzE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAExE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IAClF,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IAErF,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAC3E,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAE/E,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAC3E,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAE3E,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7E,kEAAkE;IAClE,MAAM,KAAK,GAAgC;QACzC,CAAC,GAAG,EAAI,GAAG,EAAE,GAAG,SAAS,CAAC,aAAa,CAAC,+DAA+D,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5G,CAAC,IAAI,EAAG,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAChC,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,sCAAsC,CAAC,CAAC;gBACvE,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,0CAA0C,EAAE,MAAM,CAAC,CAAC;YAChF,CAAC,CAAC;QACF,CAAC,IAAI,EAAG,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gBAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC7D,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,8CAA8C,CAAC,CAAC;gBAC/E,SAAS,CAAC,aAAa,CAAC,oDAAoD,CAAC,CAAC;YAChF,CAAC,CAAC;QACF,CAAC,IAAI,EAAG,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAChC,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,qCAAqC,CAAC,CAAC;YACxE,CAAC,CAAC;QACF,CAAC,IAAI,EAAG,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gBAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC5D,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,6CAA6C,CAAC,CAAC;gBAC9E,SAAS,CAAC,aAAa,CAAC,0DAA0D,CAAC,CAAC;YACtF,CAAC,CAAC;QACF,CAAC,IAAI,EAAG,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAClE,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,6CAA6C,CAAC,CAAC;gBAC7E,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,qCAAqC,CAAC,CAAC;gBACrE,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,kDAAkD,CAAC,CAAC;gBAC9E,SAAS,CAAC,aAAa,CAAC,sDAAsD,CAAC,CAAC;YAClF,CAAC,CAAC;QACF,CAAC,IAAI,EAAG,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC3B,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,oCAAoC,CAAC,CAAC;gBACpE,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,oCAAoC,CAAC,CAAC;YACtE,CAAC,CAAC;QACF,CAAC,IAAI,EAAG,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;gBAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC/D,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,qDAAqD,CAAC,CAAC;YACvF,CAAC,CAAC;QACF,CAAC,IAAI,EAAG,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBACjC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,qCAAqC,CAAC,CAAC;gBACrE,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,+CAA+C,CAAC,CAAC;YAC7E,CAAC,CAAC;QACF,CAAC,IAAI,EAAG,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gBAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC7D,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,6CAA6C,CAAC,CAAC;gBAC7E,SAAS,CAAC,aAAa,CAAC,oCAAoC,CAAC,CAAC;YAChE,CAAC,CAAC;QACF,CAAC,KAAK,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAChC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,mCAAmC,CAAC,CAAC;gBACnE,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,oCAAoC,CAAC,CAAC;YAClE,CAAC,CAAC;QACF,CAAC,KAAK,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC3B,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,yCAAyC,CAAC,CAAC;gBACzE,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,qCAAqC,CAAC,CAAC;YACvE,CAAC,CAAC;QACF,CAAC,KAAK,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACzD,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,qDAAqD,EAAE,OAAO,CAAC,CAAC;gBAC9F,SAAS,CAAC,aAAa,CAAC,0DAA0D,CAAC,CAAC;YACtF,CAAC,CAAC;QACF,CAAC,KAAK,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;gBAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC/D,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,uCAAuC,CAAC,CAAC;gBACvE,SAAS,CAAC,aAAa,CAAC,mDAAmD,CAAC,CAAC;YAC/E,CAAC,CAAC;QACF,CAAC,KAAK,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAChC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,yCAAyC,CAAC,CAAC;gBACnE,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,kDAAkD,CAAC,CAAC;YAChF,CAAC,CAAC;QACF,CAAC,KAAK,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gBAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC7D,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,4BAA4B,CAAC,CAAC;YACxD,CAAC,CAAC;QACF,CAAC,KAAK,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAChC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,iCAAiC,CAAC,CAAC;gBAC3D,SAAS,CAAC,aAAa,CAAC,+CAA+C,CAAC,CAAC;YAC3E,CAAC,CAAC;QACF,CAAC,KAAK,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gBAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC7D,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,mCAAmC,CAAC,CAAC;gBAC7D,SAAS,CAAC,aAAa,CAAC,+EAA+E,CAAC,CAAC;YAC3G,CAAC,CAAC;QACF,CAAC,KAAK,EAAE,GAAG,EAAE;gBACX,SAAS,CAAC,aAAa,CAAC,mEAAmE,CAAC,CAAC;gBAC7F,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;YAClE,CAAC,CAAC;KACH,CAAC;IAEF,KAAK,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;QAChC,UAAU,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

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"}