adaptive-bitmask 1.0.0 → 2.0.4

package/dist/cli/index.mjs

@@ -0,0 +1,355 @@
+#!/usr/bin/env node
+
+// src/cli/index.ts
+import { intro, outro, text, select, confirm, spinner, isCancel, cancel } from "@clack/prompts";
+import pc from "picocolors";
+import fs from "fs";
+import path from "path";
+async function main() {
+  intro(`${pc.bgCyan(pc.black(" create-swarm "))} ${pc.dim("v1.0.0")}`);
+  const projectName = await text({
+    message: "What is your project name?",
+    placeholder: "my-agent-swarm",
+    validate(value) {
+      if (!value || value.length === 0) return "Value is required";
+      if (fs.existsSync(path.join(process.cwd(), value))) return "Directory already exists";
+    }
+  });
+  if (isCancel(projectName) || typeof projectName !== "string") {
+    cancel("Operation cancelled");
+    process.exit(0);
+  }
+  const intent = await text({
+    message: "What is your swarm's primary intent?",
+    placeholder: "algorithmic trading",
+    initialValue: "algorithmic trading"
+  });
+  if (isCancel(intent) || typeof intent !== "string") {
+    cancel("Operation cancelled");
+    process.exit(0);
+  }
+  const agentCount = await text({
+    message: "How many agents in the swarm?",
+    placeholder: "10",
+    initialValue: "10",
+    validate(value) {
+      if (!value) return "Value is required";
+      const num = parseInt(value);
+      if (isNaN(num) || num <= 0) return "Must be a positive number";
+      if (num > 1e3) return "Let's start smaller (< 1000)";
+    }
+  });
+  if (isCancel(agentCount) || typeof agentCount !== "string") {
+    cancel("Operation cancelled");
+    process.exit(0);
+  }
+  const useAiSdk = await confirm({
+    message: "Integrate with Vercel AI SDK (CoordinationSession + Middleware)?",
+    initialValue: true
+  });
+  if (isCancel(useAiSdk) || typeof useAiSdk !== "boolean") {
+    cancel("Operation cancelled");
+    process.exit(0);
+  }
+  const useDashboard = await confirm({
+    message: "Scaffold a Live Dashboard / Control Plane (WebSocket)?",
+    initialValue: true
+  });
+  if (isCancel(useDashboard) || typeof useDashboard !== "boolean") {
+    cancel("Operation cancelled");
+    process.exit(0);
+  }
+  const deployment = await select({
+    message: "Choose a deployment strategy:",
+    options: [
+      { value: "cloud", label: "Cloud LLMs (OpenAI/Anthropic)", hint: "Fast, paid" },
+      { value: "local", label: "Local Models (Ollama/Llama)", hint: "Private, free" },
+      { value: "sim", label: "Simulation / Mock", hint: "Ultra-fast testing (no LLM latency)" }
+    ]
+  });
+  if (isCancel(deployment) || typeof deployment !== "string") {
+    cancel("Operation cancelled");
+    process.exit(0);
+  }
+  const s = spinner();
+  s.start(`Scaffolding ${projectName}...`);
+  const projectPath = path.join(process.cwd(), projectName);
+  fs.mkdirSync(projectPath, { recursive: true });
+  const pkg = {
+    name: projectName,
+    version: "0.1.0",
+    type: "module",
+    scripts: {
+      start: "tsx index.ts",
+      dev: "tsx --watch index.ts"
+    },
+    dependencies: {
+      "adaptive-bitmask": "^1.0.0",
+      "dotenv": "^16.4.5",
+      "p-limit": "^5.0.0"
+    },
+    devDependencies: {
+      "typescript": "^5.4.0",
+      "tsx": "^4.10.0",
+      "@types/node": "^20.0.0"
+    }
+  };
+  if (useAiSdk) {
+    pkg.dependencies["ai"] = "^4.0.0";
+    pkg.dependencies["zod"] = "^3.23.0";
+    pkg.dependencies["@ai-sdk/openai"] = "latest";
+  }
+  if (useDashboard) {
+    pkg.dependencies["ws"] = "^8.17.0";
+    pkg.devDependencies["@types/ws"] = "^8.5.10";
+  }
+  fs.writeFileSync(path.join(projectPath, "package.json"), JSON.stringify(pkg, null, 2));
+  const tsconfig = {
+    compilerOptions: {
+      target: "ES2022",
+      module: "ESNext",
+      moduleResolution: "bundler",
+      strict: true,
+      esModuleInterop: true,
+      skipLibCheck: true
+    }
+  };
+  fs.writeFileSync(path.join(projectPath, "tsconfig.json"), JSON.stringify(tsconfig, null, 2));
+  const envContent = deployment === "cloud" ? "OPENAI_API_KEY=sk-your-key-here\n" : deployment === "local" ? "OLLAMA_BASE_URL=http://localhost:11434\n" : "";
+  fs.writeFileSync(path.join(projectPath, ".env"), envContent);
+  fs.writeFileSync(path.join(projectPath, ".gitignore"), "node_modules\n.env\ndist\n");
+  const indexTs = generateIndexTs({
+    projectName,
+    intent,
+    agentCount: parseInt(agentCount),
+    useAiSdk,
+    useDashboard,
+    deployment
+  });
+  fs.writeFileSync(path.join(projectPath, "index.ts"), indexTs);
+  s.stop(`Project ${projectName} scaffolded!`);
+  outro(`
+  ${pc.green("Success!")} Your swarm is ready.
+  ${useDashboard ? pc.blue("\u{1F5A5}\uFE0F Dashboard active at: http://localhost:3000") : ""}
+  
+  ${pc.dim("Next steps:")}
+  ${pc.cyan(`cd ${projectName}`)}
+  ${pc.cyan("npm install")}
+  ${pc.cyan("npm start")}
+  
+  ${pc.yellow("Note:")} Edit ${pc.bold("index.ts")} to customize agent prompts and scoring.
+  `);
+}
+function generateIndexTs(config) {
+  const { intent, agentCount, useAiSdk, useDashboard, deployment } = config;
+  let imports = `import 'dotenv/config';
+import { SharedCognition } from 'adaptive-bitmask';
+import pLimit from 'p-limit';`;
+  if (useAiSdk) {
+    imports += `
+import { CoordinationSession } from 'adaptive-bitmask/ai';
+import { openai } from '@ai-sdk/openai';
+import { generateText } from 'ai';`;
+  }
+  if (useDashboard) {
+    imports += `
+import { WebSocketServer } from 'ws';
+import { createServer } from 'http';`;
+  }
+  const concurrency = Math.min(agentCount, 10);
+  let dashboardCode = "";
+  if (useDashboard) {
+    dashboardCode = `
+/**
+ * \u{1F5A5}\uFE0F DASHBOARD / CONTROL PLANE
+ * Real-time monitoring of agent "thinking", bandwidth, and coordination.
+ */
+const server = createServer((req, res) => {
+  res.writeHead(200, { 'Content-Type': 'text/html' });
+  res.end(\`
+    <html>
+      <head>
+        <title>Shared Cognition Dashboard</title>
+        <style>
+          body { font-family: system-ui; background: #0f172a; color: #f8fafc; margin: 0; padding: 2rem; }
+          .grid { display: grid; grid-template-columns: 1fr 1fr; gap: 1rem; }
+          .card { background: #1e293b; padding: 1.5rem; border-radius: 0.5rem; border: 1px solid #334155; }
+          .log { font-family: monospace; height: 300px; overflow-y: auto; background: #000; padding: 1rem; border-radius: 0.25rem; font-size: 0.8rem; }
+          .agent-thinking { color: #38bdf8; }
+          .decision { color: #4ade80; font-weight: bold; }
+          .feature { display: inline-block; background: #334155; padding: 0.2rem 0.5rem; border-radius: 1rem; margin-right: 0.5rem; font-size: 0.7rem; }
+          h1 { margin-top: 0; color: #e2e8f0; }
+        </style>
+      </head>
+      <body>
+        <h1>\u{1F9E0} Shared Cognition Dashboard</h1>
+        <div class="grid">
+          <div class="card">
+            <h2>Swarm Status</h2>
+            <div id="status">Waiting for round...</div>
+            <h3>Active Consensus Features</h3>
+            <div id="features"></div>
+          </div>
+          <div class="card">
+            <h2>Real-time Analytics</h2>
+            <p>Coordination Latency: <span id="latency">0</span>ms</p>
+            <p>Total Agents: ${agentCount}</p>
+            <p>Bandwidth Reduction: 85x (Bitmask Protocol)</p>
+          </div>
+        </div>
+        <div class="card" style="margin-top: 1rem;">
+          <h2>Live Agent Logs ("Thinking")</h2>
+          <div id="logs" class="log"></div>
+        </div>
+        <script>
+          const ws = new WebSocket('ws://localhost:3001');
+          const logEl = document.getElementById('logs');
+          const statusEl = document.getElementById('status');
+          const featuresEl = document.getElementById('features');
+          const latencyEl = document.getElementById('latency');
+
+          ws.onmessage = (event) => {
+            const data = JSON.parse(event.data);
+            if (data.type === 'log') {
+              const div = document.createElement('div');
+              const time = new Date(data.timestamp).toLocaleTimeString();
+              div.innerHTML = \\\`[\${time}] <b>\${data.agentId}:</b> \${data.content}\\\`;
+              if (data.logType === 'thinking') div.className = 'agent-thinking';
+              if (data.logType === 'decision') div.className = 'decision';
+              logEl.prepend(div);
+            } else if (data.type === 'update') {
+              statusEl.innerText = \\\`Round Complete: \${data.decision}\\\`;
+              featuresEl.innerHTML = data.features.map(f => \\\`<span class="feature">\${f}</span>\\\`).join('');
+              latencyEl.innerText = data.latency.toFixed(2);
+            }
+          };
+        </script>
+      </body>
+    </html>
+  \`);
+});
+
+const wss = new WebSocketServer({ port: 3001 });
+server.listen(3000);
+
+function broadcast(data: any) {
+  const msg = JSON.stringify(data);
+  wss.clients.forEach(c => c.send(msg));
+}
+`;
+  }
+  const concurrencyLimit = Math.min(agentCount, 10);
+  let agentLogic = "";
+  if (deployment === "sim") {
+    agentLogic = `
+/**
+ * SIMULATION MODE: Parallel Mock Agent Execution
+ */
+const mockFeatures = ['price_up', 'volume_spike', 'momentum_strong', 'breakout_detected', 'EMERGENCY_halt'];
+
+async function runAgent(id: number${useAiSdk ? ", session: any" : ""}) {
+  const agentName = \`Agent-\${id}\`;
+  
+  // Simulate "Thinking"
+  ${useAiSdk ? `session.logThinking(agentName, 'Analyzing market indicators...');` : useDashboard ? `broadcast({ type: 'log', agentId: agentName, logType: 'thinking', content: 'Analyzing market indicators...', timestamp: Date.now() });` : ""}
+  
+  await new Promise(r => setTimeout(r, 10 + Math.random() * 50));
+  
+  const count = Math.floor(Math.random() * 3) + 1;
+  const features = [];
+  for(let i=0; i<count; i++) {
+    features.push(mockFeatures[Math.floor(Math.random() * mockFeatures.length)]);
+  }
+  return features;
+}`;
+  } else if (useAiSdk) {
+    agentLogic = `
+/**
+ * AI SDK MODE: Parallel LLM Execution
+ */
+async function runAgent(id: number, session: any) {
+  const agentName = \`Agent-\${id}\`;
+  session.logThinking(agentName, 'Prompting LLM for observation...');
+  
+  const { text } = await generateText({
+    model: openai('gpt-4o-mini'),
+    system: \`You are a \${intent} agent. Analyze the situation and output 1-3 relevant features from the schema as comma-separated strings.\`,
+    prompt: 'Current state analysis...',
+  });
+  
+  const features = text.split(',').map(f => f.trim());
+  return features;
+}`;
+  } else {
+    agentLogic = `
+/**
+ * BASIC MODE: Parallel fetch execution
+ */
+async function runAgent(id: number) {
+  const agentName = \`Agent-\${id}\`;
+  ${useDashboard ? `broadcast({ type: 'log', agentId: agentName, logType: 'thinking', content: 'Fetching data...', timestamp: Date.now() });` : ""}
+  return ['feature_a', 'feature_b'];
+}`;
+  }
+  return `${imports}
+
+const intent = "${intent}";
+const agentCount = ${agentCount};
+const limit = pLimit(${concurrencyLimit});
+
+${dashboardCode}
+
+${useAiSdk ? `const session = new CoordinationSession({
+  features: ['price_up', 'volume_spike', 'trend_up', 'volatility_high'],
+  onLog: (log) => {
+    ${useDashboard ? "broadcast({ type: 'log', agentId: log.agentId, logType: log.type, content: log.content, timestamp: log.timestamp });" : "console.log(`[${new Date(log.timestamp).toLocaleTimeString()}] ${log.agentId}: ${log.content}`);"}
+  }
+});` : `const cognition = new SharedCognition();`}
+
+${agentLogic}
+
+async function runSwarm() {
+  console.log(\`\u{1F680} Starting swarm: "\${intent}" with \${agentCount} agents...\`);
+  
+  while (true) {
+    const start = performance.now();
+    ${useAiSdk ? "session.startRound();" : ""}
+
+    const agentTasks = Array.from({ length: agentCount }, (_, i) => 
+      limit(() => runAgent(i${useAiSdk ? ", session" : ""}))
+    );
+
+    const allObservations = await Promise.all(agentTasks);
+    const llmTime = performance.now() - start;
+
+    const coordStart = performance.now();
+    ${useAiSdk ? `
+    allObservations.forEach((obs, i) => session.report(\`agent-\${i}\`, obs));
+    const { decision, result, aggregatedFeatures } = session.decide();
+    const finalScore = result.finalScore;
+    ` : `
+    const { decision, finalScore, activeFeatures: aggregatedFeatures } = cognition.processSwarmTick(allObservations);
+    `}
+    const coordTime = performance.now() - coordStart;
+
+    ${useDashboard ? `
+    broadcast({ 
+      type: 'update', 
+      decision, 
+      features: aggregatedFeatures, 
+      latency: coordTime,
+      totalLatency: performance.now() - start
+    });
+    ` : ""}
+
+    console.log(\`\\nDecision: \${decision} (Coord: \${coordTime.toFixed(2)}ms, Total: \${(performance.now() - start).toFixed(2)}ms)\`);
+    
+    // Pause between ticks
+    await new Promise(r => setTimeout(r, 2000));
+  }
+}
+
+runSwarm().catch(console.error);
+`;
+}
+main().catch(console.error);

package/dist/{coordinator-Df48t6yJ.d.mts → coordinator-CqBBHhXv.d.mts}

@@ -510,6 +510,11 @@ declare class Coordinator {
      * Returns number of messages accepted.
      */
     receiveAll(messages: BitmaskMessage[]): number;
+    /**
+     * Peek at current consensus state without clearing the buffer.
+     * Useful for mid-round status queries by AI agents.
+     */
+    peekAggregate(): AggregationResult;
     /**
      * Aggregate all buffered messages into a consensus result.
      * Clears the buffer after aggregation.
@@ -518,4 +523,4 @@ declare class Coordinator {
     private _emitTelemetry;
 }
 
-export { Arbiter as A, BitmaskMessage as B, Coordinator as C, type Decision as D, EMERGENCY_RANGE as E, delta as F, emergencyBits as G, HIGH_FREQ_RANGE as H, empty as I, encode as J, forEachSetBit as K, fromBytes as L, MED_FREQ_RANGE as M, hammingDistance as N, hasEmergency as O, type PruneResult as P, intersect as Q, merge as R, SchemaManager as S, popcount as T, setBit as U, testBit as V, toBytes as W, type SchemaConfig as a, type CoordinatorConfig as b, type ArbiterConfig as c, type ArbiterResult as d, type AggregationResult as e, type ArbiterTelemetryEvent as f, BITMASK_WIDTH as g, type BitConfidence as h, type Bitmask as i, type BitmaskMessageData as j, type CoordinatorDropReason as k, type CoordinatorTelemetryEvent as l, type EncodeOptions as m, type ExportedSchema as n, MESSAGE_SIZE_BYTES as o, type SchemaSnapshot as p, type ScoreStrategiesOptions as q, type StaleMessagePolicy as r, type StrategyCandidate as s, type StrategyDecisionResult as t, type StrategyScore as u, activeBits as v, clearBit as w, createFinancialArbiter as x, createRoboticArbiter as y, decode as z };
+export { Arbiter as A, BitmaskMessage as B, Coordinator as C, type Decision as D, EMERGENCY_RANGE as E, delta as F, emergencyBits as G, HIGH_FREQ_RANGE as H, empty as I, encode as J, forEachSetBit as K, fromBytes as L, MED_FREQ_RANGE as M, hammingDistance as N, hasEmergency as O, type PruneResult as P, intersect as Q, merge as R, SchemaManager as S, popcount as T, setBit as U, testBit as V, toBytes as W, type CoordinatorConfig as a, type ArbiterConfig as b, type ArbiterResult as c, type SchemaConfig as d, type AggregationResult as e, type ArbiterTelemetryEvent as f, BITMASK_WIDTH as g, type BitConfidence as h, type Bitmask as i, type BitmaskMessageData as j, type CoordinatorDropReason as k, type CoordinatorTelemetryEvent as l, type EncodeOptions as m, type ExportedSchema as n, MESSAGE_SIZE_BYTES as o, type SchemaSnapshot as p, type ScoreStrategiesOptions as q, type StaleMessagePolicy as r, type StrategyCandidate as s, type StrategyDecisionResult as t, type StrategyScore as u, activeBits as v, clearBit as w, createFinancialArbiter as x, createRoboticArbiter as y, decode as z };

package/dist/{coordinator-Df48t6yJ.d.ts → coordinator-CqBBHhXv.d.ts}

@@ -510,6 +510,11 @@ declare class Coordinator {
      * Returns number of messages accepted.
      */
     receiveAll(messages: BitmaskMessage[]): number;
+    /**
+     * Peek at current consensus state without clearing the buffer.
+     * Useful for mid-round status queries by AI agents.
+     */
+    peekAggregate(): AggregationResult;
     /**
      * Aggregate all buffered messages into a consensus result.
      * Clears the buffer after aggregation.
@@ -518,4 +523,4 @@ declare class Coordinator {
     private _emitTelemetry;
 }
 
-export { Arbiter as A, BitmaskMessage as B, Coordinator as C, type Decision as D, EMERGENCY_RANGE as E, delta as F, emergencyBits as G, HIGH_FREQ_RANGE as H, empty as I, encode as J, forEachSetBit as K, fromBytes as L, MED_FREQ_RANGE as M, hammingDistance as N, hasEmergency as O, type PruneResult as P, intersect as Q, merge as R, SchemaManager as S, popcount as T, setBit as U, testBit as V, toBytes as W, type SchemaConfig as a, type CoordinatorConfig as b, type ArbiterConfig as c, type ArbiterResult as d, type AggregationResult as e, type ArbiterTelemetryEvent as f, BITMASK_WIDTH as g, type BitConfidence as h, type Bitmask as i, type BitmaskMessageData as j, type CoordinatorDropReason as k, type CoordinatorTelemetryEvent as l, type EncodeOptions as m, type ExportedSchema as n, MESSAGE_SIZE_BYTES as o, type SchemaSnapshot as p, type ScoreStrategiesOptions as q, type StaleMessagePolicy as r, type StrategyCandidate as s, type StrategyDecisionResult as t, type StrategyScore as u, activeBits as v, clearBit as w, createFinancialArbiter as x, createRoboticArbiter as y, decode as z };
+export { Arbiter as A, BitmaskMessage as B, Coordinator as C, type Decision as D, EMERGENCY_RANGE as E, delta as F, emergencyBits as G, HIGH_FREQ_RANGE as H, empty as I, encode as J, forEachSetBit as K, fromBytes as L, MED_FREQ_RANGE as M, hammingDistance as N, hasEmergency as O, type PruneResult as P, intersect as Q, merge as R, SchemaManager as S, popcount as T, setBit as U, testBit as V, toBytes as W, type CoordinatorConfig as a, type ArbiterConfig as b, type ArbiterResult as c, type SchemaConfig as d, type AggregationResult as e, type ArbiterTelemetryEvent as f, BITMASK_WIDTH as g, type BitConfidence as h, type Bitmask as i, type BitmaskMessageData as j, type CoordinatorDropReason as k, type CoordinatorTelemetryEvent as l, type EncodeOptions as m, type ExportedSchema as n, MESSAGE_SIZE_BYTES as o, type SchemaSnapshot as p, type ScoreStrategiesOptions as q, type StaleMessagePolicy as r, type StrategyCandidate as s, type StrategyDecisionResult as t, type StrategyScore as u, activeBits as v, clearBit as w, createFinancialArbiter as x, createRoboticArbiter as y, decode as z };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { WebSocket } from 'ws';
-import { S as SchemaManager, C as Coordinator, A as Arbiter, a as SchemaConfig, b as CoordinatorConfig, c as ArbiterConfig, d as ArbiterResult, B as BitmaskMessage } from './coordinator-Df48t6yJ.mjs';
-export { e as AggregationResult, f as ArbiterTelemetryEvent, g as BITMASK_WIDTH, h as BitConfidence, i as Bitmask, j as BitmaskMessageData, k as CoordinatorDropReason, l as CoordinatorTelemetryEvent, D as Decision, E as EMERGENCY_RANGE, m as EncodeOptions, n as ExportedSchema, H as HIGH_FREQ_RANGE, M as MED_FREQ_RANGE, o as MESSAGE_SIZE_BYTES, P as PruneResult, p as SchemaSnapshot, q as ScoreStrategiesOptions, r as StaleMessagePolicy, s as StrategyCandidate, t as StrategyDecisionResult, u as StrategyScore, v as activeBits, w as clearBit, x as createFinancialArbiter, y as createRoboticArbiter, z as decode, F as delta, G as emergencyBits, I as empty, J as encode, K as forEachSetBit, L as fromBytes, N as hammingDistance, O as hasEmergency, Q as intersect, R as merge, T as popcount, U as setBit, V as testBit, W as toBytes } from './coordinator-Df48t6yJ.mjs';
+import { S as SchemaManager, C as Coordinator, A as Arbiter, d as SchemaConfig, a as CoordinatorConfig, b as ArbiterConfig, c as ArbiterResult, B as BitmaskMessage } from './coordinator-CqBBHhXv.mjs';
+export { e as AggregationResult, f as ArbiterTelemetryEvent, g as BITMASK_WIDTH, h as BitConfidence, i as Bitmask, j as BitmaskMessageData, k as CoordinatorDropReason, l as CoordinatorTelemetryEvent, D as Decision, E as EMERGENCY_RANGE, m as EncodeOptions, n as ExportedSchema, H as HIGH_FREQ_RANGE, M as MED_FREQ_RANGE, o as MESSAGE_SIZE_BYTES, P as PruneResult, p as SchemaSnapshot, q as ScoreStrategiesOptions, r as StaleMessagePolicy, s as StrategyCandidate, t as StrategyDecisionResult, u as StrategyScore, v as activeBits, w as clearBit, x as createFinancialArbiter, y as createRoboticArbiter, z as decode, F as delta, G as emergencyBits, I as empty, J as encode, K as forEachSetBit, L as fromBytes, N as hammingDistance, O as hasEmergency, Q as intersect, R as merge, T as popcount, U as setBit, V as testBit, W as toBytes } from './coordinator-CqBBHhXv.mjs';
 
 /**
  * WebSocket transport layer for adaptive-bitmask

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { WebSocket } from 'ws';
-import { S as SchemaManager, C as Coordinator, A as Arbiter, a as SchemaConfig, b as CoordinatorConfig, c as ArbiterConfig, d as ArbiterResult, B as BitmaskMessage } from './coordinator-Df48t6yJ.js';
-export { e as AggregationResult, f as ArbiterTelemetryEvent, g as BITMASK_WIDTH, h as BitConfidence, i as Bitmask, j as BitmaskMessageData, k as CoordinatorDropReason, l as CoordinatorTelemetryEvent, D as Decision, E as EMERGENCY_RANGE, m as EncodeOptions, n as ExportedSchema, H as HIGH_FREQ_RANGE, M as MED_FREQ_RANGE, o as MESSAGE_SIZE_BYTES, P as PruneResult, p as SchemaSnapshot, q as ScoreStrategiesOptions, r as StaleMessagePolicy, s as StrategyCandidate, t as StrategyDecisionResult, u as StrategyScore, v as activeBits, w as clearBit, x as createFinancialArbiter, y as createRoboticArbiter, z as decode, F as delta, G as emergencyBits, I as empty, J as encode, K as forEachSetBit, L as fromBytes, N as hammingDistance, O as hasEmergency, Q as intersect, R as merge, T as popcount, U as setBit, V as testBit, W as toBytes } from './coordinator-Df48t6yJ.js';
+import { S as SchemaManager, C as Coordinator, A as Arbiter, d as SchemaConfig, a as CoordinatorConfig, b as ArbiterConfig, c as ArbiterResult, B as BitmaskMessage } from './coordinator-CqBBHhXv.js';
+export { e as AggregationResult, f as ArbiterTelemetryEvent, g as BITMASK_WIDTH, h as BitConfidence, i as Bitmask, j as BitmaskMessageData, k as CoordinatorDropReason, l as CoordinatorTelemetryEvent, D as Decision, E as EMERGENCY_RANGE, m as EncodeOptions, n as ExportedSchema, H as HIGH_FREQ_RANGE, M as MED_FREQ_RANGE, o as MESSAGE_SIZE_BYTES, P as PruneResult, p as SchemaSnapshot, q as ScoreStrategiesOptions, r as StaleMessagePolicy, s as StrategyCandidate, t as StrategyDecisionResult, u as StrategyScore, v as activeBits, w as clearBit, x as createFinancialArbiter, y as createRoboticArbiter, z as decode, F as delta, G as emergencyBits, I as empty, J as encode, K as forEachSetBit, L as fromBytes, N as hammingDistance, O as hasEmergency, Q as intersect, R as merge, T as popcount, U as setBit, V as testBit, W as toBytes } from './coordinator-CqBBHhXv.js';
 
 /**
  * WebSocket transport layer for adaptive-bitmask

package/dist/index.js

@@ -2010,6 +2010,52 @@ var Coordinator = class {
     }
     return accepted;
   }
+  /**
+   * Peek at current consensus state without clearing the buffer.
+   * Useful for mid-round status queries by AI agents.
+   */
+  peekAggregate() {
+    if (this._buffer.length === 0) {
+      return {
+        aggregatedMask: 0n,
+        confidence: /* @__PURE__ */ new Map(),
+        messageCount: 0,
+        uniqueAgents: 0,
+        staleMessages: 0,
+        droppedStaleMessages: this._droppedStaleMessages,
+        aggregationTimeUs: 0
+      };
+    }
+    const t0 = performance.now();
+    let aggregated = 0n;
+    const bitVotes = /* @__PURE__ */ new Map();
+    const uniqueAgents = /* @__PURE__ */ new Set();
+    let staleCount = 0;
+    for (const msg of this._buffer) {
+      uniqueAgents.add(msg.agentId);
+      if (this._schemaVersion !== void 0 && msg.schemaVersion !== this._schemaVersion) {
+        staleCount++;
+      }
+      aggregated |= msg.mask;
+      forEachSetBit(msg.mask, (bit) => {
+        bitVotes.set(bit, (bitVotes.get(bit) ?? 0) + 1);
+      });
+    }
+    const confidence = /* @__PURE__ */ new Map();
+    for (const [bit, count] of bitVotes) {
+      confidence.set(bit, count / this._buffer.length);
+    }
+    const elapsed = (performance.now() - t0) * 1e3;
+    return {
+      aggregatedMask: aggregated,
+      confidence,
+      messageCount: this._buffer.length,
+      uniqueAgents: uniqueAgents.size,
+      staleMessages: staleCount,
+      droppedStaleMessages: this._droppedStaleMessages,
+      aggregationTimeUs: elapsed
+    };
+  }
   /**
    * Aggregate all buffered messages into a consensus result.
    * Clears the buffer after aggregation.
@@ -2037,8 +2083,6 @@ var Coordinator = class {
     }
     const elapsed = (performance.now() - t0) * 1e3;
     this._aggregationCount++;
-    this._buffer = [];
-    this._seenAgents.clear();
     const result = {
       aggregatedMask: aggregated,
       confidence,
@@ -2048,6 +2092,10 @@ var Coordinator = class {
       droppedStaleMessages: this._droppedStaleMessages,
       aggregationTimeUs: elapsed
     };
+    this._buffer = [];
+    this._seenAgents.clear();
+    this._roundStartTime = 0;
+    this._droppedStaleMessages = 0;
     this._emitTelemetry({ type: "round_aggregated", result });
     return result;
   }
@@ -2366,6 +2414,9 @@ var SharedCognition = class {
    */
   processSwarmTick(agentObservations) {
     const startMs = performance.now();
+    if (this.schema.activeFeatureCount >= 50) {
+      this.schema.prune();
+    }
     if (this.autoRegister) {
       const uniqueFeatures = /* @__PURE__ */ new Set();
       for (const obs of agentObservations) {

package/dist/index.mjs

@@ -56,7 +56,7 @@ import {
   setBit,
   testBit,
   toBytes
-} from "./chunk-ZWEXRT33.mjs";
+} from "./chunk-QICJNGMQ.mjs";
 export {
   AdaptiveBitmaskError,
   Arbiter,

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "adaptive-bitmask",
-  "version": "1.0.0",
+  "version": "2.0.4",
   "description": "Sub-10ms coordination protocol for multi-agent systems. 85× bandwidth reduction through semantic bitmask encoding.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
+  "bin": {
+    "create-swarm": "./dist/cli/index.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -23,14 +26,19 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsup src/index.ts src/ai/index.ts --format cjs,esm --dts --clean",
+    "build": "tsup src/index.ts src/ai/index.ts src/cli/index.ts --format cjs,esm --dts --clean",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "tsc --noEmit",
     "benchmark": "npm run build && npm run benchmark:run",
     "benchmark:run": "node benchmarks/run.mjs",
     "benchmark:check": "node benchmarks/check.mjs",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "lean:build": "cd lean && lake build",
+    "lean:test": "cd lean && lake test",
+    "lean:format": "echo 'No Lean formatter configured (lake format is not available)'",
+    "lean:format:check": "echo 'No Lean formatter configured (lake format is not available)'",
+    "verify:math": "npm run lean:build && npm run lean:test"
   },
   "keywords": [
     "multi-agent",
@@ -48,7 +56,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/jverene/adaptive-bitmask"
+    "url": "git+https://github.com/jverene/adaptive-bitmask.git"
   },
   "peerDependencies": {
     "ai": ">=4.0.0",
@@ -71,6 +79,7 @@
     "@types/ws": "^8.18.1",
     "ai": "^4.0.0",
     "tsup": "^8.0.0",
+    "tsx": "^4.21.0",
     "typescript": "^5.4.0",
     "vitest": "^1.6.0",
     "ws": "^8.19.0",
@@ -78,5 +87,9 @@
   },
   "engines": {
     "node": ">=18"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "picocolors": "^1.1.1"
   }
 }