network-ai 4.15.3 → 5.1.0

package/dist/lib/comparison-runner.js

@@ -0,0 +1,138 @@
+"use strict";
+/**
+ * ComparisonRunner — Run the same goal across two adapter configurations side-by-side
+ *
+ * Executes identical tasks through two different adapter setups and produces
+ * a structured comparison of results, timing, cost, and quality.
+ *
+ * Usage:
+ *   const runner = new ComparisonRunner();
+ *   const result = await runner.compare({
+ *     goal: { action: 'review', params: { code: '...' } },
+ *     configA: { name: 'GPT-4', adapter: openaiAdapter },
+ *     configB: { name: 'Claude', adapter: anthropicAdapter },
+ *   });
+ *   runner.printReport(result);
+ *
+ * @module ComparisonRunner
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComparisonRunner = void 0;
+// ============================================================================
+// RUNNER
+// ============================================================================
+/**
+ * ComparisonRunner — Side-by-side adapter comparison.
+ */
+class ComparisonRunner {
+    /**
+     * Run the same goal through two configurations and compare results.
+     */
+    async compare(input) {
+        const runs = input.runs ?? 1;
+        const [runsA, runsB] = await Promise.all([
+            this.runSide(input.configA, input.goal, runs, input.scorer),
+            this.runSide(input.configB, input.goal, runs, input.scorer),
+        ]);
+        const a = this.aggregateSide(input.configA.name, runsA, input.scorer);
+        const b = this.aggregateSide(input.configB.name, runsB, input.scorer);
+        const { winner, winReason } = this.determineWinner(a, b);
+        return {
+            goal: input.goal,
+            a,
+            b,
+            winner,
+            winReason,
+            comparedAt: Date.now(),
+        };
+    }
+    /**
+     * Print a human-readable comparison report.
+     */
+    printReport(result) {
+        const { a, b } = result;
+        console.log('═'.repeat(60));
+        console.log('  COMPARISON REPORT');
+        console.log('═'.repeat(60));
+        console.log(`  A: ${a.name}`);
+        console.log(`  B: ${b.name}`);
+        console.log('─'.repeat(60));
+        const rows = [
+            ['Metric', a.name, b.name],
+            ['Success Rate', `${pct(a.successRate)}`, `${pct(b.successRate)}`],
+            ['Avg Duration', `${a.avgDurationMs.toFixed(0)}ms`, `${b.avgDurationMs.toFixed(0)}ms`],
+        ];
+        if (a.avgScore !== null) {
+            rows.push(['Avg Score', `${a.avgScore.toFixed(1)}`, `${b.avgScore?.toFixed(1) ?? 'N/A'}`]);
+        }
+        if (a.avgCostUsd !== null) {
+            rows.push(['Avg Cost', `$${a.avgCostUsd.toFixed(4)}`, `$${b.avgCostUsd?.toFixed(4) ?? 'N/A'}`]);
+        }
+        for (const [label, va, vb] of rows) {
+            console.log(`  ${label.padEnd(20)} ${va.padEnd(18)} ${vb}`);
+        }
+        console.log('─'.repeat(60));
+        console.log(`  Winner: ${result.winner === 'TIE' ? 'TIE' : result.winner === 'A' ? a.name : b.name}`);
+        console.log(`  Reason: ${result.winReason}`);
+        console.log('═'.repeat(60));
+    }
+    // --------------------------------------------------------------------------
+    // Internal
+    // --------------------------------------------------------------------------
+    async runSide(config, goal, runs, _scorer) {
+        const results = [];
+        for (let i = 0; i < runs; i++) {
+            const start = Date.now();
+            let output;
+            try {
+                output = await config.handler(goal);
+            }
+            catch (err) {
+                output = {
+                    success: false,
+                    error: err instanceof Error ? err.message : String(err),
+                };
+            }
+            results.push({ output, durationMs: Date.now() - start, runIndex: i });
+        }
+        return results;
+    }
+    aggregateSide(name, runs, scorer) {
+        const avgDurationMs = runs.reduce((s, r) => s + r.durationMs, 0) / runs.length;
+        const successRate = runs.filter((r) => r.output.success).length / runs.length;
+        let avgScore = null;
+        if (scorer) {
+            const scores = runs.map((r) => scorer(r.output));
+            avgScore = scores.reduce((s, v) => s + v, 0) / scores.length;
+        }
+        let avgCostUsd = null;
+        const costs = runs.map((r) => r.output.costUsd).filter((c) => c !== undefined);
+        if (costs.length > 0) {
+            avgCostUsd = costs.reduce((s, c) => s + c, 0) / costs.length;
+        }
+        return { name, runs, avgDurationMs, avgScore, avgCostUsd, successRate };
+    }
+    determineWinner(a, b) {
+        // Priority: success rate > score > speed > cost
+        if (a.successRate !== b.successRate) {
+            const w = a.successRate > b.successRate ? 'A' : 'B';
+            return { winner: w, winReason: `Higher success rate (${pct(Math.max(a.successRate, b.successRate))})` };
+        }
+        if (a.avgScore !== null && b.avgScore !== null && Math.abs(a.avgScore - b.avgScore) > 1) {
+            const w = a.avgScore > b.avgScore ? 'A' : 'B';
+            return { winner: w, winReason: `Higher quality score` };
+        }
+        const speedDiff = Math.abs(a.avgDurationMs - b.avgDurationMs);
+        if (speedDiff > a.avgDurationMs * 0.1) {
+            const w = a.avgDurationMs < b.avgDurationMs ? 'A' : 'B';
+            return { winner: w, winReason: `Faster execution` };
+        }
+        return { winner: 'TIE', winReason: 'No significant difference' };
+    }
+}
+exports.ComparisonRunner = ComparisonRunner;
+function pct(n) {
+    return `${(n * 100).toFixed(0)}%`;
+}
+//# sourceMappingURL=comparison-runner.js.map

package/dist/lib/comparison-runner.js.map

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

package/dist/lib/config-watcher.d.ts

@@ -0,0 +1,109 @@
+/**
+ * ConfigWatcher — Hot-reload configuration from disk.
+ *
+ * Uses `fs.watch()` to monitor config files and applies changes to
+ * live CONFIG, trust levels, resource profiles, and budget ceilings.
+ * Emits events on reload so components can react.
+ *
+ * @module ConfigWatcher
+ */
+import { EventEmitter } from 'events';
+/** Fields that can be hot-reloaded on CONFIG */
+export interface ReloadableConfig {
+    maxParallelAgents?: number;
+    defaultTimeout?: number;
+    enableTracing?: boolean;
+    grantTokenTTL?: number;
+    maxBlackboardValueSize?: number;
+    [key: string]: unknown;
+}
+/** Trust level entry */
+export interface TrustEntry {
+    agentId: string;
+    level: number;
+    tags?: string[];
+}
+/** Budget overrides */
+export interface BudgetOverrides {
+    ceiling?: number;
+    perAgentCeiling?: number;
+}
+/** Callback targets for reloaded config */
+export interface ConfigTargets {
+    /** Mutable CONFIG object to patch in-place */
+    config?: Record<string, unknown>;
+    /** AuthGuardian instance — for trust level updates */
+    authGuardian?: {
+        setTrustLevel?(agentId: string, level: number): void;
+    };
+    /** FederatedBudget instance — for ceiling updates */
+    budget?: {
+        setCeiling?(ceiling: number): void;
+    };
+}
+/** Emitted on successful reload */
+export interface ReloadEvent {
+    file: string;
+    timestamp: number;
+    changes: string[];
+}
+/** Emitted on reload error */
+export interface ReloadError {
+    file: string;
+    timestamp: number;
+    error: string;
+}
+/**
+ * Watches config files on disk and applies changes to live objects.
+ *
+ * Supports three config file types:
+ * - **config.json** — patches `CONFIG` object fields
+ * - **trust_levels.json** — array of `{ agentId, level }` applied to AuthGuardian
+ * - **budget.json** — `{ ceiling, perAgentCeiling }` applied to FederatedBudget
+ *
+ * @example
+ * ```ts
+ * const watcher = new ConfigWatcher({
+ *   configPath: './data/config.json',
+ *   trustPath: './data/trust_levels.json',
+ *   targets: { config: CONFIG, authGuardian: guardian, budget: fed },
+ * });
+ * watcher.on('reload', (evt) => console.log('Reloaded:', evt.file));
+ * watcher.start();
+ * // ... later
+ * watcher.stop();
+ * ```
+ */
+export declare class ConfigWatcher extends EventEmitter {
+    private watchers;
+    private targets;
+    private configPath?;
+    private trustPath?;
+    private budgetPath?;
+    private debounceMs;
+    private debounceTimers;
+    private running;
+    constructor(options?: {
+        configPath?: string;
+        trustPath?: string;
+        budgetPath?: string;
+        targets?: ConfigTargets;
+        debounceMs?: number;
+    });
+    /** Update targets after construction */
+    setTargets(targets: ConfigTargets): void;
+    /** Start watching all configured paths */
+    start(): void;
+    /** Stop all watchers */
+    stop(): void;
+    /** Manually trigger a reload for a specific file */
+    reload(filePath: string): void;
+    /** Whether the watcher is currently active */
+    isRunning(): boolean;
+    private debouncedReload;
+    private applyReload;
+    private applyConfig;
+    private applyTrust;
+    private applyBudget;
+}
+//# sourceMappingURL=config-watcher.d.ts.map

package/dist/lib/config-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-watcher.d.ts","sourceRoot":"","sources":["../../lib/config-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAQtC,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAwB;AACxB,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,uBAAuB;AACvB,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,sDAAsD;IACtD,YAAY,CAAC,EAAE;QAAE,aAAa,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACxE,qDAAqD;IACrD,MAAM,CAAC,EAAE;QAAE,UAAU,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACjD;AAED,mCAAmC;AACnC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,8BAA8B;AAC9B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAyD;IAC/E,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,aAAa,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;KAChB;IASN,wCAAwC;IACxC,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAIxC,0CAA0C;IAC1C,KAAK,IAAI,IAAI;IAkBb,wBAAwB;IACxB,IAAI,IAAI,IAAI;IAUZ,oDAAoD;IACpD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI9B,8CAA8C;IAC9C,SAAS,IAAI,OAAO;IAQpB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,WAAW;IA2BnB,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,WAAW;CAQpB"}

package/dist/lib/config-watcher.js

@@ -0,0 +1,215 @@
+"use strict";
+/**
+ * ConfigWatcher — Hot-reload configuration from disk.
+ *
+ * Uses `fs.watch()` to monitor config files and applies changes to
+ * live CONFIG, trust levels, resource profiles, and budget ceilings.
+ * Emits events on reload so components can react.
+ *
+ * @module ConfigWatcher
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigWatcher = void 0;
+const events_1 = require("events");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ============================================================================
+// CONFIG WATCHER
+// ============================================================================
+/**
+ * Watches config files on disk and applies changes to live objects.
+ *
+ * Supports three config file types:
+ * - **config.json** — patches `CONFIG` object fields
+ * - **trust_levels.json** — array of `{ agentId, level }` applied to AuthGuardian
+ * - **budget.json** — `{ ceiling, perAgentCeiling }` applied to FederatedBudget
+ *
+ * @example
+ * ```ts
+ * const watcher = new ConfigWatcher({
+ *   configPath: './data/config.json',
+ *   trustPath: './data/trust_levels.json',
+ *   targets: { config: CONFIG, authGuardian: guardian, budget: fed },
+ * });
+ * watcher.on('reload', (evt) => console.log('Reloaded:', evt.file));
+ * watcher.start();
+ * // ... later
+ * watcher.stop();
+ * ```
+ */
+class ConfigWatcher extends events_1.EventEmitter {
+    watchers = [];
+    targets;
+    configPath;
+    trustPath;
+    budgetPath;
+    debounceMs;
+    debounceTimers = new Map();
+    running = false;
+    constructor(options = {}) {
+        super();
+        this.configPath = options.configPath;
+        this.trustPath = options.trustPath;
+        this.budgetPath = options.budgetPath;
+        this.targets = options.targets ?? {};
+        this.debounceMs = options.debounceMs ?? 300;
+    }
+    /** Update targets after construction */
+    setTargets(targets) {
+        Object.assign(this.targets, targets);
+    }
+    /** Start watching all configured paths */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        const paths = [this.configPath, this.trustPath, this.budgetPath].filter(Boolean);
+        for (const filePath of paths) {
+            try {
+                if (!fs.existsSync(filePath))
+                    continue;
+                const watcher = fs.watch(filePath, { persistent: false }, (_event) => {
+                    this.debouncedReload(filePath);
+                });
+                this.watchers.push(watcher);
+            }
+            catch {
+                // File doesn't exist or not watchable — skip silently
+            }
+        }
+    }
+    /** Stop all watchers */
+    stop() {
+        this.running = false;
+        for (const w of this.watchers) {
+            try {
+                w.close();
+            }
+            catch { /* ignore */ }
+        }
+        this.watchers = [];
+        for (const timer of this.debounceTimers.values())
+            clearTimeout(timer);
+        this.debounceTimers.clear();
+    }
+    /** Manually trigger a reload for a specific file */
+    reload(filePath) {
+        this.applyReload(filePath);
+    }
+    /** Whether the watcher is currently active */
+    isRunning() {
+        return this.running;
+    }
+    // --------------------------------------------------------------------------
+    // INTERNAL
+    // --------------------------------------------------------------------------
+    debouncedReload(filePath) {
+        const existing = this.debounceTimers.get(filePath);
+        if (existing)
+            clearTimeout(existing);
+        this.debounceTimers.set(filePath, setTimeout(() => {
+            this.debounceTimers.delete(filePath);
+            this.applyReload(filePath);
+        }, this.debounceMs));
+    }
+    applyReload(filePath) {
+        try {
+            const resolved = path.resolve(filePath);
+            const raw = fs.readFileSync(resolved, 'utf-8');
+            const data = JSON.parse(raw);
+            const changes = [];
+            if (resolved === path.resolve(this.configPath ?? '')) {
+                this.applyConfig(data, changes);
+            }
+            else if (resolved === path.resolve(this.trustPath ?? '')) {
+                this.applyTrust(data, changes);
+            }
+            else if (resolved === path.resolve(this.budgetPath ?? '')) {
+                this.applyBudget(data, changes);
+            }
+            const evt = { file: filePath, timestamp: Date.now(), changes };
+            this.emit('reload', evt);
+        }
+        catch (err) {
+            const errEvt = {
+                file: filePath,
+                timestamp: Date.now(),
+                error: err instanceof Error ? err.message : String(err),
+            };
+            this.emit('error', errEvt);
+        }
+    }
+    applyConfig(data, changes) {
+        if (!this.targets.config || typeof data !== 'object' || data === null)
+            return;
+        const obj = data;
+        const allowed = new Set([
+            'maxParallelAgents', 'defaultTimeout', 'enableTracing',
+            'grantTokenTTL', 'maxBlackboardValueSize',
+        ]);
+        for (const [key, value] of Object.entries(obj)) {
+            if (allowed.has(key)) {
+                this.targets.config[key] = value;
+                changes.push(`config.${key}=${JSON.stringify(value)}`);
+            }
+        }
+    }
+    applyTrust(data, changes) {
+        if (!this.targets.authGuardian?.setTrustLevel || !Array.isArray(data))
+            return;
+        for (const entry of data) {
+            if (typeof entry === 'object' && entry !== null &&
+                'agentId' in entry && 'level' in entry &&
+                typeof entry.agentId === 'string' &&
+                typeof entry.level === 'number') {
+                const { agentId, level } = entry;
+                this.targets.authGuardian.setTrustLevel(agentId, level);
+                changes.push(`trust.${agentId}=${level}`);
+            }
+        }
+    }
+    applyBudget(data, changes) {
+        if (!this.targets.budget?.setCeiling || typeof data !== 'object' || data === null)
+            return;
+        const obj = data;
+        if (typeof obj.ceiling === 'number') {
+            this.targets.budget.setCeiling(obj.ceiling);
+            changes.push(`budget.ceiling=${obj.ceiling}`);
+        }
+    }
+}
+exports.ConfigWatcher = ConfigWatcher;
+//# sourceMappingURL=config-watcher.js.map

package/dist/lib/config-watcher.js.map

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

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

@@ -0,0 +1,128 @@
+/**
+ * ControlPlane — Unified multi-workspace dashboard server
+ *
+ * Provides a single HTTP + WebSocket server that aggregates multiple
+ * WorkTrees and LockedBlackboards into one live dashboard. Users register
+ * named workspaces; the browser UI lets operators switch between them
+ * and view Task Trees, Agent orchestration, and Blackboard state.
+ *
+ * ```typescript
+ * const cp = new ControlPlane({ port: 4800 });
+ * cp.addWorkspace('feature-x', { tree: myTree, blackboard: myBB });
+ * cp.addWorkspace('feature-y', { tree: otherTree });
+ * await cp.start();
+ * // Open http://127.0.0.1:4800
+ * ```
+ *
+ * @module ControlPlane
+ * @version 1.0.0
+ */
+import { EventEmitter } from 'events';
+import type { WorkTree } from './work-tree';
+import type { LockedBlackboard } from './locked-blackboard';
+/** Configuration for a single workspace */
+export interface WorkspaceConfig {
+    /** Hierarchical task tree (enables Tree + Agents tabs) */
+    tree?: WorkTree;
+    /** Shared blackboard (enables Blackboard tab) */
+    blackboard?: LockedBlackboard;
+}
+/** A log entry for an agent */
+export interface AgentLogEntry {
+    time: string;
+    message: string;
+    level: 'info' | 'warn' | 'error';
+}
+/** Agent info for the dashboard */
+export interface CPAgentInfo {
+    name: string;
+    role: 'orchestrator' | 'worker';
+    status: 'idle' | 'busy' | 'error';
+    tasks: Array<{
+        id: string;
+        label: string;
+        status: string;
+    }>;
+    currentTask: string | null;
+    logs: AgentLogEntry[];
+    tokens: number;
+}
+/** Workspace summary for the workspace picker */
+export interface WorkspaceSummary {
+    name: string;
+    hasTree: boolean;
+    hasBlackboard: boolean;
+    nodeCount: number;
+    progress: number;
+    bbKeyCount: number;
+}
+/** Options for the ControlPlane */
+export interface ControlPlaneOptions {
+    /** TCP port (default: 4800) */
+    port?: number;
+    /** Hostname (default: '127.0.0.1') */
+    host?: string;
+}
+/**
+ * Unified dashboard server for multiple WorkTrees and Blackboards.
+ *
+ * Register named workspaces, then open the browser to see them all.
+ */
+export declare class ControlPlane extends EventEmitter {
+    private readonly port;
+    private readonly host;
+    private server;
+    private clients;
+    private workspaces;
+    private pingInterval;
+    private bbPollInterval;
+    private clientCounter;
+    private pendingBroadcasts;
+    constructor(options?: ControlPlaneOptions);
+    /**
+     * Register a named workspace with an optional WorkTree and/or Blackboard.
+     */
+    addWorkspace(name: string, config: WorkspaceConfig): void;
+    /**
+     * Remove a workspace.
+     */
+    removeWorkspace(name: string): boolean;
+    /**
+     * Set the orchestrator agent for a workspace.
+     */
+    setOrchestrator(workspaceName: string, agentName: string): void;
+    /**
+     * Push a log entry to an agent in a workspace.
+     */
+    pushLog(workspaceName: string, agent: string, message: string, level?: 'info' | 'warn' | 'error'): void;
+    /**
+     * Push a narrative message to the orchestrator log for a workspace.
+     */
+    pushNarrative(workspaceName: string, message: string): void;
+    /**
+     * List all registered workspace names.
+     */
+    listWorkspaces(): string[];
+    /** Start the ControlPlane server. */
+    start(): Promise<void>;
+    /** Stop the ControlPlane server. */
+    stop(): Promise<void>;
+    /** Number of connected clients. */
+    clientCount(): number;
+    /** Dashboard URL. */
+    get url(): string;
+    private handleHTTP;
+    private handleUpgrade;
+    private handleClientMessage;
+    private buildWorkspaceList;
+    private buildWorkspaceData;
+    private buildAgentMap;
+    private sendWorkspaceSnapshot;
+    private scheduleBroadcast;
+    private broadcastWorkspaceList;
+    /** Track last BB snapshot hashes for change detection */
+    private bbHashes;
+    private pollBlackboards;
+    private pingClients;
+}
+//# sourceMappingURL=control-plane.d.ts.map

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

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