adaptive-bitmask 1.0.0 → 2.0.5

package/dist/ai/index.d.mts

@@ -1,4 +1,4 @@
-import { S as SchemaManager, C as Coordinator, A as Arbiter, b as CoordinatorConfig, c as ArbiterConfig, D as Decision, d as ArbiterResult } from '../coordinator-Df48t6yJ.mjs';
+import { S as SchemaManager, C as Coordinator, A as Arbiter, a as CoordinatorConfig, b as ArbiterConfig, D as Decision, c as ArbiterResult } from '../coordinator-CqBBHhXv.mjs';
 import * as ai from 'ai';
 import { LanguageModelV1Middleware } from 'ai';
 import { z } from 'zod';
@@ -10,6 +10,13 @@ import { z } from 'zod';
  * that AI SDK tools and middleware can reference.
  */
 
+interface SessionLog {
+    timestamp: number;
+    agentId: string;
+    type: 'observation' | 'decision' | 'thinking' | 'system';
+    content: string;
+    metadata?: any;
+}
 interface CoordinationSessionConfig {
     /** Initial feature vocabulary to register. */
     features: string[];
@@ -21,6 +28,8 @@ interface CoordinationSessionConfig {
     coordinatorConfig?: Partial<CoordinatorConfig>;
     /** Arbiter configuration overrides. */
     arbiterConfig?: Partial<ArbiterConfig>;
+    /** Optional callback for telemetry/logs. */
+    onLog?: (log: SessionLog) => void;
 }
 interface ReportResult {
     accepted: boolean;
@@ -37,14 +46,20 @@ declare class CoordinationSession {
     readonly schema: SchemaManager;
     readonly coordinator: Coordinator;
     readonly arbiter: Arbiter;
+    private readonly _onLog?;
     private readonly _agentIds;
     constructor(config: CoordinationSessionConfig);
+    private _log;
     /** Deterministic agent ID: FNV-1a hash of name → uint32. */
     agentId(name: string): number;
+    /** Log internal "thinking" or reasoning from an agent. */
+    logThinking(agentName: string, content: string, metadata?: any): void;
     /** Start a new coordination round. Clears the coordinator buffer. */
     startRound(): void;
     /** Encode features + create message + receive in one call. */
     report(agentName: string, features: string[]): ReportResult;
+    /** Aggregate current buffer without clearing it. */
+    peek(): DecisionResult;
     /** Aggregate current buffer + score via arbiter. */
     decide(): DecisionResult;
 }

package/dist/ai/index.d.ts

@@ -1,4 +1,4 @@
-import { S as SchemaManager, C as Coordinator, A as Arbiter, b as CoordinatorConfig, c as ArbiterConfig, D as Decision, d as ArbiterResult } from '../coordinator-Df48t6yJ.js';
+import { S as SchemaManager, C as Coordinator, A as Arbiter, a as CoordinatorConfig, b as ArbiterConfig, D as Decision, c as ArbiterResult } from '../coordinator-CqBBHhXv.js';
 import * as ai from 'ai';
 import { LanguageModelV1Middleware } from 'ai';
 import { z } from 'zod';
@@ -10,6 +10,13 @@ import { z } from 'zod';
  * that AI SDK tools and middleware can reference.
  */
 
+interface SessionLog {
+    timestamp: number;
+    agentId: string;
+    type: 'observation' | 'decision' | 'thinking' | 'system';
+    content: string;
+    metadata?: any;
+}
 interface CoordinationSessionConfig {
     /** Initial feature vocabulary to register. */
     features: string[];
@@ -21,6 +28,8 @@ interface CoordinationSessionConfig {
     coordinatorConfig?: Partial<CoordinatorConfig>;
     /** Arbiter configuration overrides. */
     arbiterConfig?: Partial<ArbiterConfig>;
+    /** Optional callback for telemetry/logs. */
+    onLog?: (log: SessionLog) => void;
 }
 interface ReportResult {
     accepted: boolean;
@@ -37,14 +46,20 @@ declare class CoordinationSession {
     readonly schema: SchemaManager;
     readonly coordinator: Coordinator;
     readonly arbiter: Arbiter;
+    private readonly _onLog?;
     private readonly _agentIds;
     constructor(config: CoordinationSessionConfig);
+    private _log;
     /** Deterministic agent ID: FNV-1a hash of name → uint32. */
     agentId(name: string): number;
+    /** Log internal "thinking" or reasoning from an agent. */
+    logThinking(agentName: string, content: string, metadata?: any): void;
     /** Start a new coordination round. Clears the coordinator buffer. */
     startRound(): void;
     /** Encode features + create message + receive in one call. */
     report(agentName: string, features: string[]): ReportResult;
+    /** Aggregate current buffer without clearing it. */
+    peek(): DecisionResult;
     /** Aggregate current buffer + score via arbiter. */
     decide(): DecisionResult;
 }

package/dist/ai/index.js

@@ -665,6 +665,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.
@@ -692,8 +738,6 @@ var Coordinator = class {
     }
     const elapsed = (performance.now() - t0) * 1e3;
     this._aggregationCount++;
-    this._buffer = [];
-    this._seenAgents.clear();
     const result = {
       aggregatedMask: aggregated,
       confidence,
@@ -703,6 +747,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;
   }
@@ -980,6 +1028,7 @@ var CoordinationSession = class {
   schema;
   coordinator;
   arbiter;
+  _onLog;
   _agentIds = /* @__PURE__ */ new Map();
   constructor(config) {
     this.schema = new SchemaManager({
@@ -992,6 +1041,11 @@ var CoordinationSession = class {
       schemaVersion: this.schema.version
     });
     this.arbiter = new Arbiter(config.arbiterConfig);
+    this._onLog = config.onLog;
+  }
+  _log(log) {
+    const fullLog = { ...log, timestamp: Date.now() };
+    this._onLog?.(fullLog);
   }
   /** Deterministic agent ID: FNV-1a hash of name → uint32. */
   agentId(name) {
@@ -1006,12 +1060,33 @@ var CoordinationSession = class {
     this._agentIds.set(name, id);
     return id;
   }
+  /** Log internal "thinking" or reasoning from an agent. */
+  logThinking(agentName, content, metadata) {
+    this._log({
+      agentId: agentName,
+      type: "thinking",
+      content,
+      metadata
+    });
+  }
   /** Start a new coordination round. Clears the coordinator buffer. */
   startRound() {
     this.coordinator.startRound();
+    this._log({
+      agentId: "system",
+      type: "system",
+      content: "Started new coordination round"
+    });
   }
   /** Encode features + create message + receive in one call. */
   report(agentName, features) {
+    this._log({
+      agentId: agentName,
+      type: "observation",
+      content: `Reported features: ${features.join(", ")}`,
+      metadata: { features }
+    });
+    this.schema.recordActivations(features);
     const { mask, mapped, unmapped } = encode(
       features,
       this.schema.featureToBit
@@ -1024,11 +1099,33 @@ var CoordinationSession = class {
     const accepted = this.coordinator.receive(msg);
     return { accepted, mapped, unmapped };
   }
+  /** Aggregate current buffer without clearing it. */
+  peek() {
+    const { aggregatedMask, confidence } = this.coordinator.peekAggregate();
+    const aggregatedFeatures = decode(aggregatedMask, this.schema.bitToFeatures);
+    const result = this.arbiter.score(aggregatedMask, confidence);
+    return {
+      decision: result.decision,
+      aggregatedFeatures,
+      confidence,
+      result
+    };
+  }
   /** Aggregate current buffer + score via arbiter. */
   decide() {
     const { aggregatedMask, confidence } = this.coordinator.aggregate();
     const aggregatedFeatures = decode(aggregatedMask, this.schema.bitToFeatures);
     const result = this.arbiter.score(aggregatedMask, confidence);
+    this._log({
+      agentId: "system",
+      type: "decision",
+      content: `Final Decision: ${result.decision}`,
+      metadata: {
+        result,
+        aggregatedFeatures,
+        score: result.finalScore
+      }
+    });
     return {
       decision: result.decision,
       aggregatedFeatures,
@@ -1061,16 +1158,15 @@ function createCoordinationTools(session) {
     description: "Query the current aggregated consensus state across all agents.",
     parameters: import_zod.z.object({}),
     execute: async () => {
-      const { aggregatedMask, confidence, uniqueAgents } = session.coordinator.aggregate();
-      const features = decode(aggregatedMask, session.schema.bitToFeatures);
+      const { aggregatedFeatures, confidence, result } = session.peek();
       const confidenceObj = {};
       for (const [bit, conf] of confidence) {
         confidenceObj[String(bit)] = conf;
       }
       return {
-        features,
+        features: aggregatedFeatures,
         confidence: confidenceObj,
-        agentCount: uniqueAgents
+        agentCount: session.coordinator.bufferedCount
       };
     }
   });

package/dist/ai/index.mjs

@@ -6,13 +6,14 @@ import {
   decode,
   encode,
   hasEmergency
-} from "../chunk-ZWEXRT33.mjs";
+} from "../chunk-QICJNGMQ.mjs";
 
 // src/ai/session.ts
 var CoordinationSession = class {
   schema;
   coordinator;
   arbiter;
+  _onLog;
   _agentIds = /* @__PURE__ */ new Map();
   constructor(config) {
     this.schema = new SchemaManager({
@@ -25,6 +26,11 @@ var CoordinationSession = class {
       schemaVersion: this.schema.version
     });
     this.arbiter = new Arbiter(config.arbiterConfig);
+    this._onLog = config.onLog;
+  }
+  _log(log) {
+    const fullLog = { ...log, timestamp: Date.now() };
+    this._onLog?.(fullLog);
   }
   /** Deterministic agent ID: FNV-1a hash of name → uint32. */
   agentId(name) {
@@ -39,12 +45,33 @@ var CoordinationSession = class {
     this._agentIds.set(name, id);
     return id;
   }
+  /** Log internal "thinking" or reasoning from an agent. */
+  logThinking(agentName, content, metadata) {
+    this._log({
+      agentId: agentName,
+      type: "thinking",
+      content,
+      metadata
+    });
+  }
   /** Start a new coordination round. Clears the coordinator buffer. */
   startRound() {
     this.coordinator.startRound();
+    this._log({
+      agentId: "system",
+      type: "system",
+      content: "Started new coordination round"
+    });
   }
   /** Encode features + create message + receive in one call. */
   report(agentName, features) {
+    this._log({
+      agentId: agentName,
+      type: "observation",
+      content: `Reported features: ${features.join(", ")}`,
+      metadata: { features }
+    });
+    this.schema.recordActivations(features);
     const { mask, mapped, unmapped } = encode(
       features,
       this.schema.featureToBit
@@ -57,11 +84,33 @@ var CoordinationSession = class {
     const accepted = this.coordinator.receive(msg);
     return { accepted, mapped, unmapped };
   }
+  /** Aggregate current buffer without clearing it. */
+  peek() {
+    const { aggregatedMask, confidence } = this.coordinator.peekAggregate();
+    const aggregatedFeatures = decode(aggregatedMask, this.schema.bitToFeatures);
+    const result = this.arbiter.score(aggregatedMask, confidence);
+    return {
+      decision: result.decision,
+      aggregatedFeatures,
+      confidence,
+      result
+    };
+  }
   /** Aggregate current buffer + score via arbiter. */
   decide() {
     const { aggregatedMask, confidence } = this.coordinator.aggregate();
     const aggregatedFeatures = decode(aggregatedMask, this.schema.bitToFeatures);
     const result = this.arbiter.score(aggregatedMask, confidence);
+    this._log({
+      agentId: "system",
+      type: "decision",
+      content: `Final Decision: ${result.decision}`,
+      metadata: {
+        result,
+        aggregatedFeatures,
+        score: result.finalScore
+      }
+    });
     return {
       decision: result.decision,
       aggregatedFeatures,
@@ -94,16 +143,15 @@ function createCoordinationTools(session) {
     description: "Query the current aggregated consensus state across all agents.",
     parameters: z.object({}),
     execute: async () => {
-      const { aggregatedMask, confidence, uniqueAgents } = session.coordinator.aggregate();
-      const features = decode(aggregatedMask, session.schema.bitToFeatures);
+      const { aggregatedFeatures, confidence, result } = session.peek();
       const confidenceObj = {};
       for (const [bit, conf] of confidence) {
         confidenceObj[String(bit)] = conf;
       }
       return {
-        features,
+        features: aggregatedFeatures,
         confidence: confidenceObj,
-        agentCount: uniqueAgents
+        agentCount: session.coordinator.bufferedCount
       };
     }
   });

package/dist/{chunk-ZWEXRT33.mjs → chunk-QICJNGMQ.mjs}

@@ -1928,6 +1928,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.
@@ -1955,8 +2001,6 @@ var Coordinator = class {
     }
     const elapsed = (performance.now() - t0) * 1e3;
     this._aggregationCount++;
-    this._buffer = [];
-    this._seenAgents.clear();
     const result = {
       aggregatedMask: aggregated,
       confidence,
@@ -1966,6 +2010,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;
   }
@@ -2284,6 +2332,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/cli/index.d.mts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node