network-ai 3.9.0 → 4.0.0

package/README.md

@@ -4,7 +4,7 @@
 
 [![CI](https://github.com/jovanSAPFIONEER/Network-AI/actions/workflows/ci.yml/badge.svg)](https://github.com/jovanSAPFIONEER/Network-AI/actions/workflows/ci.yml)
 [![CodeQL](https://github.com/jovanSAPFIONEER/Network-AI/actions/workflows/codeql.yml/badge.svg)](https://github.com/jovanSAPFIONEER/Network-AI/actions/workflows/codeql.yml)
-[![Release](https://img.shields.io/badge/release-v3.9.0-blue.svg)](https://github.com/jovanSAPFIONEER/Network-AI/releases)
+[![Release](https://img.shields.io/badge/release-v4.0.0-blue.svg)](https://github.com/jovanSAPFIONEER/Network-AI/releases)
 [![npm](https://img.shields.io/npm/dw/network-ai.svg?label=npm%20downloads)](https://www.npmjs.com/package/network-ai)
 [![ClawHub](https://img.shields.io/badge/ClawHub-network--ai-orange.svg)](https://clawhub.ai/skills/network-ai)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org)
@@ -13,7 +13,7 @@
 [![License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](LICENSE)
 [![Socket](https://socket.dev/api/badge/npm/package/network-ai)](https://socket.dev/npm/package/network-ai/overview)
 [![AgentSkills](https://img.shields.io/badge/AgentSkills-compatible-orange.svg)](https://agentskills.io)
-[![Tests](https://img.shields.io/badge/tests-1095%20passing-brightgreen.svg)](#testing)
+[![Tests](https://img.shields.io/badge/tests-1216%20passing-brightgreen.svg)](#testing)
 [![Adapters](https://img.shields.io/badge/frameworks-12%20supported-blueviolet.svg)](#adapter-system)
 [![RSS Feed](https://img.shields.io/badge/RSS-releases-orange?logo=rss)](https://github.com/jovanSAPFIONEER/Network-AI/releases.atom)
 

package/bin/mcp-server.ts

@@ -0,0 +1,266 @@
+#!/usr/bin/env node
+/**
+ * Network-AI MCP Server — Phase 6 Part 3
+ *
+ * Starts an HTTP/SSE server that exposes the full Network-AI tool suite to
+ * any MCP-compatible AI agent (Claude Desktop, Cursor, Cline, etc.).
+ *
+ * Usage:
+ *   npx ts-node bin/mcp-server.ts [options]
+ *   npx network-ai-server [options]              (after clawhub publish)
+ *
+ * Options:
+ *   --port <n>           TCP port to listen on (default: 3001)
+ *   --host <h>           Hostname to bind to   (default: 0.0.0.0)
+ *   --board <name>       Named blackboard to expose (default: main)
+ *   --ceiling <n>        Initial FederatedBudget token ceiling (default: 1_000_000)
+ *   --no-budget          Disable budget tools
+ *   --no-token           Disable token tools
+ *   --no-extended        Disable all extended tools (budget + token + audit)
+ *   --no-control         Disable control-plane tools
+ *   --audit-log <path>   Path to audit log file (default: ./data/audit_log.jsonl)
+ *   --heartbeat <ms>     SSE heartbeat interval in ms (default: 15000)
+ *   --help               Print this help text
+ *
+ * Connect any MCP client to:
+ *   http://localhost:3001           (SSE stream — GET /sse)
+ *   http://localhost:3001/mcp       (JSON-RPC POST)
+ *   http://localhost:3001/health    (health check)
+ *   http://localhost:3001/tools     (list all tools)
+ *
+ * @module bin/mcp-server
+ * @version 4.0.0
+ */
+
+import {
+  createSwarmOrchestrator,
+  FederatedBudget,
+  McpBlackboardBridge,
+  getConfig,
+  setConfig,
+} from '../index';
+import { SecureTokenManager } from '../security';
+import {
+  McpSseServer,
+  McpCombinedBridge,
+  McpBlackboardBridgeAdapter,
+} from '../lib/mcp-transport-sse';
+import { ExtendedMcpTools } from '../lib/mcp-tools-extended';
+import { ControlMcpTools } from '../lib/mcp-tools-control';
+
+// ============================================================================
+// ARGUMENT PARSING
+// ============================================================================
+
+interface ServerArgs {
+  port: number;
+  host: string;
+  board: string;
+  ceiling: number;
+  noBudget: boolean;
+  noToken: boolean;
+  noExtended: boolean;
+  noControl: boolean;
+  auditLog: string;
+  heartbeat: number;
+  help: boolean;
+}
+
+function parseArgs(argv: string[]): ServerArgs {
+  const args: ServerArgs = {
+    port: 3001,
+    host: '0.0.0.0',
+    board: 'main',
+    ceiling: 1_000_000,
+    noBudget: false,
+    noToken: false,
+    noExtended: false,
+    noControl: false,
+    auditLog: './data/audit_log.jsonl',
+    heartbeat: 15000,
+    help: false,
+  };
+
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    const next = argv[i + 1];
+    switch (arg) {
+      case '--port':       args.port = parseInt(next ?? '3001', 10); i++; break;
+      case '--host':       args.host = next ?? '0.0.0.0'; i++; break;
+      case '--board':      args.board = next ?? 'main'; i++; break;
+      case '--ceiling':    args.ceiling = parseFloat(next ?? '1000000'); i++; break;
+      case '--audit-log':  args.auditLog = next ?? './data/audit_log.jsonl'; i++; break;
+      case '--heartbeat':  args.heartbeat = parseInt(next ?? '15000', 10); i++; break;
+      case '--no-budget':    args.noBudget = true; break;
+      case '--no-token':     args.noToken = true; break;
+      case '--no-extended':  args.noExtended = true; break;
+      case '--no-control':   args.noControl = true; break;
+      case '--help': case '-h': args.help = true; break;
+    }
+  }
+  return args;
+}
+
+function printHelp(): void {
+  console.log(`
+network-ai-server — Network-AI MCP Server v4.0.0
+
+Usage: npx ts-node bin/mcp-server.ts [options]
+
+Options:
+  --port <n>           TCP port (default: 3001)
+  --host <h>           Bind host (default: 0.0.0.0)
+  --board <name>       Named blackboard to expose (default: main)
+  --ceiling <n>        Budget token ceiling (default: 1000000)
+  --audit-log <path>   Audit log path (default: ./data/audit_log.jsonl)
+  --heartbeat <ms>     SSE heartbeat interval (default: 15000)
+  --no-budget          Disable budget tools
+  --no-token           Disable token tools
+  --no-extended        Disable extended tools (budget + token + audit)
+  --no-control         Disable control-plane tools
+  --help               Show this help
+
+Connect to:
+  GET  http://localhost:3001/sse     SSE stream
+  POST http://localhost:3001/mcp     JSON-RPC 2.0 tool calls
+  GET  http://localhost:3001/health  Health check
+  GET  http://localhost:3001/tools   All available tools
+`);
+}
+
+// ============================================================================
+// MAIN
+// ============================================================================
+
+async function main(): Promise<void> {
+  const args = parseArgs(process.argv.slice(2));
+
+  if (args.help) {
+    printHelp();
+    process.exit(0);
+  }
+
+  console.log(`\n[network-ai-server] Starting MCP Server v4.0.0`);
+  console.log(`[network-ai-server] Board: ${args.board} | Port: ${args.port}`);
+
+  // --------------------------------------------------------------------------
+  // 1. Create orchestrator + blackboard
+  // --------------------------------------------------------------------------
+  const orchestrator = createSwarmOrchestrator();
+  const blackboard = orchestrator.getBlackboard(args.board);
+
+  // --------------------------------------------------------------------------
+  // 2. Create MCP bridge for blackboard tools (5 tools)
+  // --------------------------------------------------------------------------
+  const blackboardBridge = new McpBlackboardBridge(blackboard, { name: args.board });
+  const blackboardAdapter = new McpBlackboardBridgeAdapter(blackboardBridge);
+
+  // --------------------------------------------------------------------------
+  // 3. Create extended tools (budget + token + audit) — optional
+  // --------------------------------------------------------------------------
+  let extendedTools: ExtendedMcpTools | null = null;
+  if (!args.noExtended) {
+    const budget = !args.noBudget
+      ? new FederatedBudget({ ceiling: args.ceiling })
+      : undefined;
+
+    const tokenManager = !args.noToken
+      ? new SecureTokenManager()
+      : undefined;
+
+    extendedTools = new ExtendedMcpTools({
+      budget,
+      tokenManager,
+      auditLogPath: args.auditLog,
+    });
+
+    const toolsEnabled: string[] = [];
+    if (budget) toolsEnabled.push('budget (5 tools)');
+    if (tokenManager) toolsEnabled.push('token (3 tools)');
+    toolsEnabled.push('audit (2 tools)');
+    console.log(`[network-ai-server] Extended tools: ${toolsEnabled.join(', ')}`);
+  }
+
+  // --------------------------------------------------------------------------
+  // 4. Create control-plane tools — optional
+  // --------------------------------------------------------------------------
+  let controlTools: ControlMcpTools | null = null;
+  if (!args.noControl) {
+    // Get the live CONFIG reference via the exported accessor
+    const liveConfig = getConfig() as Record<string, unknown>;
+
+    // Create a proxy config object that both reads from and writes to CONFIG
+    const configProxy = new Proxy(liveConfig, {
+      get(_t, key: string) {
+        return getConfig(key);
+      },
+      set(_t, key: string, value: unknown) {
+        setConfig(key, value);
+        return true;
+      },
+      ownKeys() {
+        return Object.keys(getConfig() as object);
+      },
+      getOwnPropertyDescriptor(_t, key: string) {
+        return { value: getConfig(key), writable: true, enumerable: true, configurable: true };
+      },
+    }) as unknown as import('../lib/mcp-tools-control').IConfig;
+
+    controlTools = new ControlMcpTools({
+      config: configProxy,
+      blackboard: blackboard as unknown as import('../lib/mcp-tools-control').IControlBlackboard,
+      systemToken: 'system-orchestrator-token',
+    });
+
+    console.log(`[network-ai-server] Control tools: config (2), agent (3), fsm (1), info (1)`);
+  }
+
+  // --------------------------------------------------------------------------
+  // 5. Assemble combined bridge
+  // --------------------------------------------------------------------------
+  const combined = new McpCombinedBridge('network-ai');
+  combined.register(blackboardAdapter);
+  if (extendedTools) combined.register(extendedTools);
+  if (controlTools) combined.register(controlTools);
+
+  const totalTools = combined.allDefinitions().length;
+  console.log(`[network-ai-server] Total tools exposed: ${totalTools}`);
+
+  // --------------------------------------------------------------------------
+  // 6. Start SSE server
+  // --------------------------------------------------------------------------
+  const server = new McpSseServer(combined, {
+    port: args.port,
+    host: args.host,
+    heartbeatMs: args.heartbeat,
+  });
+
+  await server.listen();
+
+  const localUrl = `http://localhost:${args.port}`;
+  console.log(`\n[network-ai-server] ✓ Listening on ${localUrl}`);
+  console.log(`[network-ai-server]   SSE stream : ${localUrl}/sse`);
+  console.log(`[network-ai-server]   Tool calls : ${localUrl}/mcp  (POST)`);
+  console.log(`[network-ai-server]   Health     : ${localUrl}/health`);
+  console.log(`[network-ai-server]   All tools  : ${localUrl}/tools\n`);
+  console.log(`[network-ai-server] Connect any MCP client to: ${localUrl}`);
+  console.log(`[network-ai-server] Press Ctrl+C to stop.\n`);
+
+  // --------------------------------------------------------------------------
+  // 7. Graceful shutdown
+  // --------------------------------------------------------------------------
+  const shutdown = async (signal: string): Promise<void> => {
+    console.log(`\n[network-ai-server] Received ${signal} — shutting down...`);
+    await server.close();
+    console.log('[network-ai-server] Server stopped. Goodbye.\n');
+    process.exit(0);
+  };
+
+  process.on('SIGINT', () => void shutdown('SIGINT'));
+  process.on('SIGTERM', () => void shutdown('SIGTERM'));
+}
+
+main().catch(err => {
+  console.error('\n[network-ai-server] Fatal error:', err instanceof Error ? err.message : String(err));
+  process.exit(1);
+});

package/dist/bin/mcp-server.d.ts

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * Network-AI MCP Server — Phase 6 Part 3
+ *
+ * Starts an HTTP/SSE server that exposes the full Network-AI tool suite to
+ * any MCP-compatible AI agent (Claude Desktop, Cursor, Cline, etc.).
+ *
+ * Usage:
+ *   npx ts-node bin/mcp-server.ts [options]
+ *   npx network-ai-server [options]              (after clawhub publish)
+ *
+ * Options:
+ *   --port <n>           TCP port to listen on (default: 3001)
+ *   --host <h>           Hostname to bind to   (default: 0.0.0.0)
+ *   --board <name>       Named blackboard to expose (default: main)
+ *   --ceiling <n>        Initial FederatedBudget token ceiling (default: 1_000_000)
+ *   --no-budget          Disable budget tools
+ *   --no-token           Disable token tools
+ *   --no-extended        Disable all extended tools (budget + token + audit)
+ *   --no-control         Disable control-plane tools
+ *   --audit-log <path>   Path to audit log file (default: ./data/audit_log.jsonl)
+ *   --heartbeat <ms>     SSE heartbeat interval in ms (default: 15000)
+ *   --help               Print this help text
+ *
+ * Connect any MCP client to:
+ *   http://localhost:3001           (SSE stream — GET /sse)
+ *   http://localhost:3001/mcp       (JSON-RPC POST)
+ *   http://localhost:3001/health    (health check)
+ *   http://localhost:3001/tools     (list all tools)
+ *
+ * @module bin/mcp-server
+ * @version 4.0.0
+ */
+export {};
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/bin/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../bin/mcp-server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG"}

package/dist/bin/mcp-server.js

@@ -0,0 +1,248 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Network-AI MCP Server — Phase 6 Part 3
+ *
+ * Starts an HTTP/SSE server that exposes the full Network-AI tool suite to
+ * any MCP-compatible AI agent (Claude Desktop, Cursor, Cline, etc.).
+ *
+ * Usage:
+ *   npx ts-node bin/mcp-server.ts [options]
+ *   npx network-ai-server [options]              (after clawhub publish)
+ *
+ * Options:
+ *   --port <n>           TCP port to listen on (default: 3001)
+ *   --host <h>           Hostname to bind to   (default: 0.0.0.0)
+ *   --board <name>       Named blackboard to expose (default: main)
+ *   --ceiling <n>        Initial FederatedBudget token ceiling (default: 1_000_000)
+ *   --no-budget          Disable budget tools
+ *   --no-token           Disable token tools
+ *   --no-extended        Disable all extended tools (budget + token + audit)
+ *   --no-control         Disable control-plane tools
+ *   --audit-log <path>   Path to audit log file (default: ./data/audit_log.jsonl)
+ *   --heartbeat <ms>     SSE heartbeat interval in ms (default: 15000)
+ *   --help               Print this help text
+ *
+ * Connect any MCP client to:
+ *   http://localhost:3001           (SSE stream — GET /sse)
+ *   http://localhost:3001/mcp       (JSON-RPC POST)
+ *   http://localhost:3001/health    (health check)
+ *   http://localhost:3001/tools     (list all tools)
+ *
+ * @module bin/mcp-server
+ * @version 4.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("../index");
+const security_1 = require("../security");
+const mcp_transport_sse_1 = require("../lib/mcp-transport-sse");
+const mcp_tools_extended_1 = require("../lib/mcp-tools-extended");
+const mcp_tools_control_1 = require("../lib/mcp-tools-control");
+function parseArgs(argv) {
+    const args = {
+        port: 3001,
+        host: '0.0.0.0',
+        board: 'main',
+        ceiling: 1_000_000,
+        noBudget: false,
+        noToken: false,
+        noExtended: false,
+        noControl: false,
+        auditLog: './data/audit_log.jsonl',
+        heartbeat: 15000,
+        help: false,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        const next = argv[i + 1];
+        switch (arg) {
+            case '--port':
+                args.port = parseInt(next ?? '3001', 10);
+                i++;
+                break;
+            case '--host':
+                args.host = next ?? '0.0.0.0';
+                i++;
+                break;
+            case '--board':
+                args.board = next ?? 'main';
+                i++;
+                break;
+            case '--ceiling':
+                args.ceiling = parseFloat(next ?? '1000000');
+                i++;
+                break;
+            case '--audit-log':
+                args.auditLog = next ?? './data/audit_log.jsonl';
+                i++;
+                break;
+            case '--heartbeat':
+                args.heartbeat = parseInt(next ?? '15000', 10);
+                i++;
+                break;
+            case '--no-budget':
+                args.noBudget = true;
+                break;
+            case '--no-token':
+                args.noToken = true;
+                break;
+            case '--no-extended':
+                args.noExtended = true;
+                break;
+            case '--no-control':
+                args.noControl = true;
+                break;
+            case '--help':
+            case '-h':
+                args.help = true;
+                break;
+        }
+    }
+    return args;
+}
+function printHelp() {
+    console.log(`
+network-ai-server — Network-AI MCP Server v4.0.0
+
+Usage: npx ts-node bin/mcp-server.ts [options]
+
+Options:
+  --port <n>           TCP port (default: 3001)
+  --host <h>           Bind host (default: 0.0.0.0)
+  --board <name>       Named blackboard to expose (default: main)
+  --ceiling <n>        Budget token ceiling (default: 1000000)
+  --audit-log <path>   Audit log path (default: ./data/audit_log.jsonl)
+  --heartbeat <ms>     SSE heartbeat interval (default: 15000)
+  --no-budget          Disable budget tools
+  --no-token           Disable token tools
+  --no-extended        Disable extended tools (budget + token + audit)
+  --no-control         Disable control-plane tools
+  --help               Show this help
+
+Connect to:
+  GET  http://localhost:3001/sse     SSE stream
+  POST http://localhost:3001/mcp     JSON-RPC 2.0 tool calls
+  GET  http://localhost:3001/health  Health check
+  GET  http://localhost:3001/tools   All available tools
+`);
+}
+// ============================================================================
+// MAIN
+// ============================================================================
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.help) {
+        printHelp();
+        process.exit(0);
+    }
+    console.log(`\n[network-ai-server] Starting MCP Server v4.0.0`);
+    console.log(`[network-ai-server] Board: ${args.board} | Port: ${args.port}`);
+    // --------------------------------------------------------------------------
+    // 1. Create orchestrator + blackboard
+    // --------------------------------------------------------------------------
+    const orchestrator = (0, index_1.createSwarmOrchestrator)();
+    const blackboard = orchestrator.getBlackboard(args.board);
+    // --------------------------------------------------------------------------
+    // 2. Create MCP bridge for blackboard tools (5 tools)
+    // --------------------------------------------------------------------------
+    const blackboardBridge = new index_1.McpBlackboardBridge(blackboard, { name: args.board });
+    const blackboardAdapter = new mcp_transport_sse_1.McpBlackboardBridgeAdapter(blackboardBridge);
+    // --------------------------------------------------------------------------
+    // 3. Create extended tools (budget + token + audit) — optional
+    // --------------------------------------------------------------------------
+    let extendedTools = null;
+    if (!args.noExtended) {
+        const budget = !args.noBudget
+            ? new index_1.FederatedBudget({ ceiling: args.ceiling })
+            : undefined;
+        const tokenManager = !args.noToken
+            ? new security_1.SecureTokenManager()
+            : undefined;
+        extendedTools = new mcp_tools_extended_1.ExtendedMcpTools({
+            budget,
+            tokenManager,
+            auditLogPath: args.auditLog,
+        });
+        const toolsEnabled = [];
+        if (budget)
+            toolsEnabled.push('budget (5 tools)');
+        if (tokenManager)
+            toolsEnabled.push('token (3 tools)');
+        toolsEnabled.push('audit (2 tools)');
+        console.log(`[network-ai-server] Extended tools: ${toolsEnabled.join(', ')}`);
+    }
+    // --------------------------------------------------------------------------
+    // 4. Create control-plane tools — optional
+    // --------------------------------------------------------------------------
+    let controlTools = null;
+    if (!args.noControl) {
+        // Get the live CONFIG reference via the exported accessor
+        const liveConfig = (0, index_1.getConfig)();
+        // Create a proxy config object that both reads from and writes to CONFIG
+        const configProxy = new Proxy(liveConfig, {
+            get(_t, key) {
+                return (0, index_1.getConfig)(key);
+            },
+            set(_t, key, value) {
+                (0, index_1.setConfig)(key, value);
+                return true;
+            },
+            ownKeys() {
+                return Object.keys((0, index_1.getConfig)());
+            },
+            getOwnPropertyDescriptor(_t, key) {
+                return { value: (0, index_1.getConfig)(key), writable: true, enumerable: true, configurable: true };
+            },
+        });
+        controlTools = new mcp_tools_control_1.ControlMcpTools({
+            config: configProxy,
+            blackboard: blackboard,
+            systemToken: 'system-orchestrator-token',
+        });
+        console.log(`[network-ai-server] Control tools: config (2), agent (3), fsm (1), info (1)`);
+    }
+    // --------------------------------------------------------------------------
+    // 5. Assemble combined bridge
+    // --------------------------------------------------------------------------
+    const combined = new mcp_transport_sse_1.McpCombinedBridge('network-ai');
+    combined.register(blackboardAdapter);
+    if (extendedTools)
+        combined.register(extendedTools);
+    if (controlTools)
+        combined.register(controlTools);
+    const totalTools = combined.allDefinitions().length;
+    console.log(`[network-ai-server] Total tools exposed: ${totalTools}`);
+    // --------------------------------------------------------------------------
+    // 6. Start SSE server
+    // --------------------------------------------------------------------------
+    const server = new mcp_transport_sse_1.McpSseServer(combined, {
+        port: args.port,
+        host: args.host,
+        heartbeatMs: args.heartbeat,
+    });
+    await server.listen();
+    const localUrl = `http://localhost:${args.port}`;
+    console.log(`\n[network-ai-server] ✓ Listening on ${localUrl}`);
+    console.log(`[network-ai-server]   SSE stream : ${localUrl}/sse`);
+    console.log(`[network-ai-server]   Tool calls : ${localUrl}/mcp  (POST)`);
+    console.log(`[network-ai-server]   Health     : ${localUrl}/health`);
+    console.log(`[network-ai-server]   All tools  : ${localUrl}/tools\n`);
+    console.log(`[network-ai-server] Connect any MCP client to: ${localUrl}`);
+    console.log(`[network-ai-server] Press Ctrl+C to stop.\n`);
+    // --------------------------------------------------------------------------
+    // 7. Graceful shutdown
+    // --------------------------------------------------------------------------
+    const shutdown = async (signal) => {
+        console.log(`\n[network-ai-server] Received ${signal} — shutting down...`);
+        await server.close();
+        console.log('[network-ai-server] Server stopped. Goodbye.\n');
+        process.exit(0);
+    };
+    process.on('SIGINT', () => void shutdown('SIGINT'));
+    process.on('SIGTERM', () => void shutdown('SIGTERM'));
+}
+main().catch(err => {
+    console.error('\n[network-ai-server] Fatal error:', err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=mcp-server.js.map

package/dist/bin/mcp-server.js.map

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

package/dist/index.d.ts

@@ -758,4 +758,32 @@ export declare function createSwarmOrchestrator(config?: Partial<typeof CONFIG>
     qualityThreshold?: number;
     aiReviewCallback?: AIReviewCallback;
 }): SwarmOrchestrator;
+/**
+ * Read the current value of a CONFIG key, or the entire CONFIG snapshot.
+ *
+ * @example
+ * ```typescript
+ * const cfg = getConfig(); // { maxParallelAgents: Infinity, ... }
+ * const timeout = getConfig('defaultTimeout'); // 30000
+ * ```
+ */
+export declare function getConfig(): Readonly<typeof CONFIG>;
+export declare function getConfig(key: string): unknown;
+/**
+ * Update a CONFIG key at runtime.  Changes take effect immediately for all
+ * subsequent orchestrator operations.
+ *
+ * @example
+ * ```typescript
+ * setConfig('maxParallelAgents', 10);
+ * setConfig('enableTracing', false);
+ * ```
+ */
+export declare function setConfig(key: string, value: unknown): void;
+export { McpSseServer, McpSseTransport, McpCombinedBridge, McpBlackboardBridgeAdapter, } from './lib/mcp-transport-sse';
+export type { McpToolProvider, McpSseServerOptions } from './lib/mcp-transport-sse';
+export { ExtendedMcpTools } from './lib/mcp-tools-extended';
+export type { IBudget, ITokenManager, ExtendedMcpToolsOptions } from './lib/mcp-tools-extended';
+export { ControlMcpTools } from './lib/mcp-tools-control';
+export type { IConfig, IAgentStatus, ControlMcpToolsOptions } from './lib/mcp-tools-control';
 //# sourceMappingURL=index.d.ts.map