@mandible-ai/mandible 0.3.6 → 0.3.8

package/README.md

@@ -86,7 +86,7 @@ await host.stop();
 
 #### Docker
 
-Runs each colony as a Docker container via the Mandible Cloud API:
+Runs each colony in a Docker container. Same colony definitions, but the runtime boundary is containers instead of running in-process:
 
 ```typescript
 import { mandible, FilesystemEnvironment, docker } from '@mandible-ai/mandible';
@@ -95,23 +95,19 @@ const env = new FilesystemEnvironment({ root: './.mandible/signals' });
 
 const host = await mandible('code-pipeline')
   .environment(env)
-  .host(docker({
-    apiUrl: process.env.MANDIBLE_API_URL!,
-    apiKey: process.env.MANDIBLE_API_KEY!,
-    image: 'mandible-colony:latest',
-  }))
+  .host(docker({ image: 'mandible-colony:latest' }))
   .colony('shaper', shaper)
   .colony('critic', critic)
   .colony('keeper', keeper)
   .start();
 
-console.log(host.metadata.projectId);
+await host.dashboard(); // signal snapshots + colony names from containers
 await host.stop();
 ```
 
-#### Cloud (Edera microVMs)
+#### Cloud (microVMs)
 
-For production workloads, run colonies in isolated Edera zones via [Mandible Cloud](https://mandible.dev):
+For production workloads, run colonies in isolated zones via [Mandible Cloud](https://mandible.cloud):
 
 ```typescript
 import { mandible, FilesystemEnvironment } from '@mandible-ai/mandible';
@@ -175,7 +171,7 @@ Every concept maps to a biological analogy:
 | Mandible | Biology | Description |
 |----------|---------|-------------|
 | **Signal** | Pheromone | A typed marker deposited in the environment with a payload, concentration, and TTL. |
-| **Environment** | Substrate | The shared medium agents read from and write to. Filesystem, GitHub, Remote, Dolt. |
+| **Environment** | Substrate | The shared medium agents read from and write to. Filesystem, GitHub, Dolt. |
 | **Colony** | Ant caste | A group of identical agents with shared sensors, rules, and claim strategy. |
 | **Sensor** | Antennae | How a colony perceives signals. A query pattern like `task:ready` or `review:*`. |
 | **Rule** | Instinct | A stimulus→response mapping: "when I sense X, do Y and deposit Z." |
@@ -221,17 +217,45 @@ const host = await mandible('my-swarm')
 
 ### Colony builder
 
-For lower-level control, use the `colony()` builder directly:
+Colony definitions are typically written as standalone configurator functions that return a `ColonyBuilder` callback. This keeps colony logic in its own module, reusable across hosts:
 
 ```typescript
-colony('name')
-  .in(env)                                        // which environment
+// colonies/worker.ts
+import type { ColonyBuilder } from '@mandible-ai/mandible';
+
+export function configureWorker() {
+  return (c: ColonyBuilder) => c
+    .sense('task:ready', { unclaimed: true })
+    .do('process', async (signal, ctx) => {
+      ctx.log(`processing ${signal.id}`);
+      await ctx.deposit('task:done', signal.payload, {
+        causedBy: [signal.id],
+      });
+      await ctx.withdraw(signal.id);
+    })
+    .concurrency(1)
+    .claim('exclusive');
+}
+```
+
+Then wire it into a mandible system:
+
+```typescript
+import { configureWorker } from './colonies/worker.js';
+
+const host = await mandible('my-system')
+  .environment(env)
+  .colony('worker', configureWorker())
+  .start();
+```
+
+The builder supports the full range of colony configuration:
+
+```typescript
+(c: ColonyBuilder) => c
   .sense('type:pattern', { unclaimed: true })     // what to watch for
   .when(signal => signal.payload.priority > 0)    // optional guard
-  .do('shape', withClaudeCode({                   // action provider
-    prompt: signal => `Implement: ${signal.payload.name}`,
-    allowedTools: ['Read', 'Write'],
-  }))
+  .do('shape', handler)                           // action handler
   .concurrency(3)                                 // max parallel agents
   .claim('lease', 30_000)                         // claim strategy
   .poll(2000)                                     // sensor poll interval (ms)
@@ -239,7 +263,6 @@ colony('name')
   .autoWithdraw()                                 // auto-remove processed signals
   .timeout(60_000)                                // action timeout
   .retry(3, 1000)                                 // retry with backoff
-  .build();
 ```
 
 **Claim strategies:**
@@ -265,6 +288,8 @@ Action providers wrap external capabilities into a standard interface for colony
 
 The provider assembles context by walking signal lineage (`caused_by` chains), giving the agent full awareness of the work pipeline state.
 
+See [Action Providers Guide](docs/how-to/action-providers.md) for full configuration reference, output mapping, and context assembly.
+
 ## Signal types
 
 Signal types use a `domain:state` convention and support glob patterns for sensing:
@@ -322,7 +347,7 @@ const env = new GitHubEnvironment({
 
 ### Writing your own
 
-Implement the `Environment` interface:
+Implement the `Environment` interface (see [Custom Environment Guide](docs/how-to/custom-environment.md) for a full walkthrough):
 
 ```typescript
 interface Environment {
@@ -357,7 +382,7 @@ Built-in hosts: `local()` (in-process), `docker()` (containers). Cloud hosts liv
 
 ## Patterns
 
-Reusable coordination patterns built on top of the core primitives.
+Reusable coordination patterns built on top of the core primitives. See [Bridging Signals](docs/how-to/bridge-signals.md) and [Monitoring Trust](docs/how-to/monitor-trust.md) for detailed usage.
 
 ### SignalBridge
 
@@ -376,9 +401,25 @@ const bridge = createBridge({
 await bridge.start();
 ```
 
+### DebugBridge
+
+One-way gate from a signal server into a local environment. Enables ad-hoc testing from the cloud console — deposit a signal in the console and it flows through the WebSocket into the colony's real environment.
+
+```typescript
+import { createDebugBridge } from '@mandible-ai/mandible';
+
+const bridge = createDebugBridge({
+  url: 'wss://signals.mandible.cloud/ws',
+  apiKey: 'mnd_...',
+  project: 'my-project',
+  environment: localEnv,
+});
+await bridge.start();
+```
+
 ### Sentinel
 
-Trust monitoring colony that watches an environment for signals with invalid or missing provenance. When violations are detected, the sentinel deposits `trust:violation` report signals that other colonies can react to.
+Trust monitoring colony that watches an environment for signals with invalid or missing provenance. When violations are detected, the sentinel deposits `sentinel:flagged` report signals that other colonies can react to.
 
 ```typescript
 import { createSentinel } from '@mandible-ai/mandible';
@@ -400,7 +441,7 @@ src/
     server.ts           Dashboard HTTP + WebSocket server
     dashboard.html      Live dashboard UI
   cloud/
-    index.ts            Cloud client for hosted observability
+    index.ts            Cloud client for deploy + bundle upload
   core/
     types.ts            Core type system (Signal, Environment, Colony, Trust)
     signal.ts           Signal creation, matching, decay, priority sorting
@@ -423,15 +464,24 @@ src/
     context.ts          Context assembly from signal lineage
   patterns/
     bridge.ts           SignalBridge — cross-environment mirroring with attestation
+    debug-bridge.ts     DebugBridge — signal server → environment gate
     sentinel.ts         Sentinel — trust monitoring and violation reporting
 
 tests/
+  cli/                  Dashboard server, resolveEnvironments tests
   core/                 Signal, runtime, attestation tests
   environments/         Filesystem, GitHub adapter tests
   dsl/                  DSL and mandible() builder tests
   providers/            Agent, structured output, bash provider tests
   colonies/             Integration tests for colony workflows
 
+docs/
+  how-to/
+    bridge-signals.md   SignalBridge + DebugBridge usage guide
+    action-providers.md withClaudeCode, withStructuredOutput, withBash reference
+    monitor-trust.md    Sentinel pattern + trust policies
+    custom-environment.md Implementing the Environment interface
+
 examples/
   code-pipeline/
     colonies.ts         Shared colony definitions (shaper, critic, keeper)
@@ -484,11 +534,11 @@ Both colonies are wired to real Claude agents via `withClaudeCode`. The dashboar
 
 - [x] `mandible dev` CLI + live dashboard
 - [x] `withClaudeCode` wired to Claude Code SDK
-- [x] Test suite (378 tests, 95%+ coverage)
+- [x] Test suite (473 tests, 95%+ coverage)
 - [x] GitHub environment adapter
 - [x] `mandible()` DSL with Host/Environment separation
 - [x] `local()` and `docker()` host implementations
-- [ ] `@mandible-ai/cloud` — run colonies in Edera microVMs via Mandible Cloud
+- [x] `@mandible-ai/cloud` — run colonies in isolation using microVMs via Mandible Cloud
 - [ ] `create-mandible` starter template
 - [ ] Dashboard GIF + landing page
 - [ ] Dolt full implementation

package/dist/src/index.d.ts

@@ -22,6 +22,8 @@ export { createBridge } from './patterns/bridge.js';
 export type { SignalBridge, BridgeStats } from './patterns/bridge.js';
 export { createSentinel } from './patterns/sentinel.js';
 export type { Sentinel, SentinelConfig, SentinelEvaluation, SentinelStats } from './patterns/sentinel.js';
+export { createDebugBridge } from './patterns/debug-bridge.js';
+export type { DebugBridge, DebugBridgeConfig } from './patterns/debug-bridge.js';
 export { startDashboard, LocalDashboardSource, resolveEnvironments } from './cli/server.js';
 export type { DashboardSource, ColonyInfo, DashboardOptions as DashboardServerOptions, SimpleConfig } from './cli/server.js';
 export { withClaudeCode } from './providers/claude-code.js';

package/dist/src/index.d.ts.map

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

package/dist/src/index.js

@@ -30,6 +30,7 @@ export { generateIdentity, signSignal, createSigner, verifySignature, verifyAtte
 // Patterns — reusable colony patterns
 export { createBridge } from './patterns/bridge.js';
 export { createSentinel } from './patterns/sentinel.js';
+export { createDebugBridge } from './patterns/debug-bridge.js';
 // Dashboard
 export { startDashboard, LocalDashboardSource, resolveEnvironments } from './cli/server.js';
 // Action providers

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,wBAAwB;AACxB,+DAA+D;AAkC/D,mBAAmB;AACnB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,aAAa;AACb,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,iBAAiB;AACjB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGzC,qDAAqD;AACrD,qDAAqD;AACrD,gFAAgF;AAChF,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGvD,UAAU;AACV,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEjE,eAAe;AACf,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,aAAa;AACb,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAElF,uBAAuB;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAInE,mBAAmB;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,kCAAkC;AAClC,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,sCAAsC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG5F,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,wBAAwB;AACxB,+DAA+D;AAkC/D,mBAAmB;AACnB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,aAAa;AACb,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,iBAAiB;AACjB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGzC,qDAAqD;AACrD,qDAAqD;AACrD,gFAAgF;AAChF,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGvD,UAAU;AACV,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEjE,eAAe;AACf,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,aAAa;AACb,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAElF,uBAAuB;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAInE,mBAAmB;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,kCAAkC;AAClC,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,sCAAsC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAG/D,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG5F,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/patterns/debug-bridge.d.ts

@@ -0,0 +1,48 @@
+import type { Signal, Environment } from '../core/types.js';
+import type { BridgeStats } from './bridge.js';
+export interface DebugBridgeConfig {
+    /** Human-readable name for this bridge instance */
+    name?: string;
+    /** Signal server WebSocket URL */
+    url: string;
+    /** API key for signal server authentication */
+    apiKey: string;
+    /** Project ID for signal isolation */
+    project: string;
+    /** Target environment — inbound signals are deposited here */
+    environment: Environment;
+    /** Signal type filter patterns sent to the signal server (default: ['*']) */
+    signalTypes?: string[];
+    /** Auto-reconnect on disconnect (default: true) */
+    reconnect?: boolean;
+    /** Callback when a signal is successfully bridged */
+    onBridged?: (signal: Signal) => void;
+    /** Callback on errors */
+    onError?: (error: Error) => void;
+    /** Connection timeout in ms (default: 10000) */
+    connectTimeout?: number;
+}
+export interface DebugBridge {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    readonly running: boolean;
+    readonly stats: BridgeStats;
+}
+/**
+ * Create a debug bridge that subscribes to signals from a signal server
+ * and deposits them into a local environment.
+ *
+ * This is a one-way gate: signal server → environment. It enables ad-hoc
+ * testing from the cloud console's deposit drawer.
+ *
+ * Usage:
+ *   const bridge = createDebugBridge({
+ *     url: 'ws://localhost:8080/ws',
+ *     apiKey: 'mnd_...',
+ *     project: 'my-project',
+ *     environment: localEnv,
+ *   });
+ *   await bridge.start();
+ */
+export declare function createDebugBridge(config: DebugBridgeConfig): DebugBridge;
+//# sourceMappingURL=debug-bridge.d.ts.map

package/dist/src/patterns/debug-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-bridge.d.ts","sourceRoot":"","sources":["../../../src/patterns/debug-bridge.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;IAEZ,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IAEf,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAEhB,8DAA8D;IAC9D,WAAW,EAAE,WAAW,CAAC;IAEzB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,qDAAqD;IACrD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAErC,yBAAyB;IACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B;AAQD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAiMxE"}

package/dist/src/patterns/debug-bridge.js

@@ -0,0 +1,216 @@
+// PURPOSE: DebugBridge — one-way gate from signal server to a local environment.
+// PURPOSE: Enables ad-hoc testing: console deposits a signal → bridge carries it into the colony's real environment.
+import WebSocket from 'ws';
+const PING_INTERVAL = 30_000;
+const PONG_TIMEOUT = 10_000;
+const MAX_BACKOFF = 30_000;
+const MAX_TRACKED = 10_000;
+const DEFAULT_CONNECT_TIMEOUT = 10_000;
+/**
+ * Create a debug bridge that subscribes to signals from a signal server
+ * and deposits them into a local environment.
+ *
+ * This is a one-way gate: signal server → environment. It enables ad-hoc
+ * testing from the cloud console's deposit drawer.
+ *
+ * Usage:
+ *   const bridge = createDebugBridge({
+ *     url: 'ws://localhost:8080/ws',
+ *     apiKey: 'mnd_...',
+ *     project: 'my-project',
+ *     environment: localEnv,
+ *   });
+ *   await bridge.start();
+ */
+export function createDebugBridge(config) {
+    const name = config.name ?? 'debug-bridge';
+    const signalTypes = config.signalTypes ?? ['*'];
+    const shouldReconnect = config.reconnect !== false;
+    const connectTimeout = config.connectTimeout ?? DEFAULT_CONNECT_TIMEOUT;
+    let running = false;
+    let intentionalClose = false;
+    let ws = null;
+    let pingTimer = null;
+    let pongTimer = null;
+    let reconnectTimer = null;
+    let attempt = 0;
+    let msgCounter = 0;
+    let pendingSubId = null;
+    // Dedup set — prevents re-depositing the same signal on reconnect
+    const bridgedIds = new Set();
+    const stats = {
+        signalsBridged: 0,
+        signalsFiltered: 0,
+        errors: 0,
+    };
+    function trackBridged(id) {
+        bridgedIds.add(id);
+        if (bridgedIds.size > MAX_TRACKED) {
+            const iter = bridgedIds.values();
+            for (let i = 0; i < MAX_TRACKED / 2; i++) {
+                bridgedIds.delete(iter.next().value);
+            }
+        }
+    }
+    function clearTimers() {
+        if (pingTimer) {
+            clearInterval(pingTimer);
+            pingTimer = null;
+        }
+        if (pongTimer) {
+            clearTimeout(pongTimer);
+            pongTimer = null;
+        }
+        if (reconnectTimer) {
+            clearTimeout(reconnectTimer);
+            reconnectTimer = null;
+        }
+    }
+    function scheduleReconnect() {
+        if (intentionalClose || !shouldReconnect)
+            return;
+        const delay = Math.min(1000 * 2 ** attempt, MAX_BACKOFF);
+        attempt++;
+        reconnectTimer = setTimeout(() => {
+            if (!intentionalClose && running) {
+                connectWs();
+            }
+        }, delay);
+    }
+    function connectWs(onAuthenticated, onFailed) {
+        const socket = new WebSocket(config.url);
+        ws = socket;
+        socket.on('open', () => {
+            attempt = 0;
+            socket.send(JSON.stringify({ type: 'auth', apiKey: config.apiKey, project: config.project }));
+        });
+        socket.on('message', (raw) => {
+            let msg;
+            try {
+                msg = JSON.parse(typeof raw === 'string' ? raw : raw.toString());
+            }
+            catch {
+                return;
+            }
+            if (msg.type === 'authenticated') {
+                // Start keepalive pings
+                pingTimer = setInterval(() => {
+                    if (socket.readyState === WebSocket.OPEN) {
+                        socket.ping();
+                        pongTimer = setTimeout(() => {
+                            socket.terminate();
+                        }, PONG_TIMEOUT);
+                    }
+                }, PING_INTERVAL);
+                // Subscribe to inbound signals — wait for server ack before resolving
+                const subId = `debug_bridge_${++msgCounter}`;
+                pendingSubId = subId;
+                socket.send(JSON.stringify({
+                    type: 'subscribe',
+                    id: subId,
+                    query: { type: signalTypes.length === 1 ? signalTypes[0] : signalTypes },
+                }));
+            }
+            else if (msg.type === 'result' && msg.id === pendingSubId) {
+                pendingSubId = null;
+                onAuthenticated?.();
+            }
+            else if (msg.type === 'signal' && msg.signal) {
+                const sig = msg.signal;
+                if (bridgedIds.has(sig.id))
+                    return;
+                trackBridged(sig.id);
+                config.environment.deposit({
+                    type: sig.type,
+                    payload: sig.payload,
+                    meta: {
+                        deposited_by: sig.meta?.deposited_by ?? 'console',
+                        tags: sig.meta?.tags,
+                        caused_by: sig.meta?.caused_by,
+                        ...(sig.meta?.ttl != null && { ttl: sig.meta.ttl }),
+                    },
+                }).then(() => {
+                    stats.signalsBridged++;
+                    stats.lastBridgedAt = Date.now();
+                    config.onBridged?.(sig);
+                }).catch((err) => {
+                    stats.errors++;
+                    config.onError?.(err instanceof Error ? err : new Error(String(err)));
+                });
+            }
+            else if (msg.type === 'error') {
+                const err = new Error(`signal server error: ${msg.code} — ${msg.message}`);
+                stats.errors++;
+                config.onError?.(err);
+            }
+        });
+        socket.on('pong', () => {
+            if (pongTimer) {
+                clearTimeout(pongTimer);
+                pongTimer = null;
+            }
+        });
+        socket.on('error', (err) => {
+            const error = err instanceof Error ? err : new Error(String(err));
+            stats.errors++;
+            config.onError?.(error);
+            onFailed?.(error);
+        });
+        socket.on('close', () => {
+            clearTimers();
+            ws = null;
+            if (!intentionalClose && running) {
+                scheduleReconnect();
+            }
+        });
+    }
+    return {
+        start() {
+            if (running)
+                return Promise.resolve();
+            running = true;
+            intentionalClose = false;
+            attempt = 0;
+            return new Promise((resolve, reject) => {
+                let settled = false;
+                const timeout = setTimeout(() => {
+                    if (!settled) {
+                        settled = true;
+                        reject(new Error(`[debug-bridge:${name}] connection timeout after ${connectTimeout}ms`));
+                    }
+                }, connectTimeout);
+                connectWs(() => {
+                    if (!settled) {
+                        settled = true;
+                        clearTimeout(timeout);
+                        resolve();
+                    }
+                }, (err) => {
+                    if (!settled) {
+                        settled = true;
+                        clearTimeout(timeout);
+                        reject(err);
+                    }
+                });
+            });
+        },
+        async stop() {
+            if (!running)
+                return;
+            running = false;
+            intentionalClose = true;
+            clearTimers();
+            if (ws) {
+                ws.close();
+                ws = null;
+            }
+        },
+        get running() {
+            return running;
+        },
+        get stats() {
+            return { ...stats };
+        },
+    };
+}
+//# sourceMappingURL=debug-bridge.js.map

package/dist/src/patterns/debug-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-bridge.js","sourceRoot":"","sources":["../../../src/patterns/debug-bridge.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,qHAAqH;AAIrH,OAAO,SAAS,MAAM,IAAI,CAAC;AAyC3B,MAAM,aAAa,GAAG,MAAM,CAAC;AAC7B,MAAM,YAAY,GAAG,MAAM,CAAC;AAC5B,MAAM,WAAW,GAAG,MAAM,CAAC;AAC3B,MAAM,WAAW,GAAG,MAAM,CAAC;AAC3B,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAEvC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAyB;IACzD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,cAAc,CAAC;IAC3C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,KAAK,KAAK,CAAC;IACnD,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,uBAAuB,CAAC;IAExE,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAC7B,IAAI,EAAE,GAAqB,IAAI,CAAC;IAChC,IAAI,SAAS,GAA0C,IAAI,CAAC;IAC5D,IAAI,SAAS,GAAyC,IAAI,CAAC;IAC3D,IAAI,cAAc,GAAyC,IAAI,CAAC;IAChE,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,YAAY,GAAkB,IAAI,CAAC;IAEvC,kEAAkE;IAClE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAErC,MAAM,KAAK,GAAgB;QACzB,cAAc,EAAE,CAAC;QACjB,eAAe,EAAE,CAAC;QAClB,MAAM,EAAE,CAAC;KACV,CAAC;IAEF,SAAS,YAAY,CAAC,EAAU;QAC9B,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnB,IAAI,UAAU,CAAC,IAAI,GAAG,WAAW,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;YACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBACzC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAM,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS,WAAW;QAClB,IAAI,SAAS,EAAE,CAAC;YAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YAAC,SAAS,GAAG,IAAI,CAAC;QAAC,CAAC;QAC9D,IAAI,SAAS,EAAE,CAAC;YAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YAAC,SAAS,GAAG,IAAI,CAAC;QAAC,CAAC;QAC7D,IAAI,cAAc,EAAE,CAAC;YAAC,YAAY,CAAC,cAAc,CAAC,CAAC;YAAC,cAAc,GAAG,IAAI,CAAC;QAAC,CAAC;IAC9E,CAAC;IAED,SAAS,iBAAiB;QACxB,IAAI,gBAAgB,IAAI,CAAC,eAAe;YAAE,OAAO;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,OAAO,EAAE,WAAW,CAAC,CAAC;QACzD,OAAO,EAAE,CAAC;QACV,cAAc,GAAG,UAAU,CAAC,GAAG,EAAE;YAC/B,IAAI,CAAC,gBAAgB,IAAI,OAAO,EAAE,CAAC;gBACjC,SAAS,EAAE,CAAC;YACd,CAAC;QACH,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC;IAED,SAAS,SAAS,CAAC,eAA4B,EAAE,QAA+B;QAC9E,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzC,EAAE,GAAG,MAAM,CAAC;QAEZ,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;YACrB,OAAO,GAAG,CAAC,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAChG,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAoB,EAAE,EAAE;YAC5C,IAAI,GAAQ,CAAC;YACb,IAAI,CAAC;gBACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;YACnE,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO;YAAC,CAAC;YAEnB,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBACjC,wBAAwB;gBACxB,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;oBAC3B,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;wBACzC,MAAM,CAAC,IAAI,EAAE,CAAC;wBACd,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;4BAC1B,MAAM,CAAC,SAAS,EAAE,CAAC;wBACrB,CAAC,EAAE,YAAY,CAAC,CAAC;oBACnB,CAAC;gBACH,CAAC,EAAE,aAAa,CAAC,CAAC;gBAElB,sEAAsE;gBACtE,MAAM,KAAK,GAAG,gBAAgB,EAAE,UAAU,EAAE,CAAC;gBAC7C,YAAY,GAAG,KAAK,CAAC;gBACrB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;oBACzB,IAAI,EAAE,WAAW;oBACjB,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;iBACzE,CAAC,CAAC,CAAC;YACN,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,EAAE,KAAK,YAAY,EAAE,CAAC;gBAC5D,YAAY,GAAG,IAAI,CAAC;gBACpB,eAAe,EAAE,EAAE,CAAC;YACtB,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBAC/C,MAAM,GAAG,GAAG,GAAG,CAAC,MAAgB,CAAC;gBACjC,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAAE,OAAO;gBAEnC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAErB,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC;oBACzB,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,IAAI,EAAE;wBACJ,YAAY,EAAE,GAAG,CAAC,IAAI,EAAE,YAAY,IAAI,SAAS;wBACjD,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI;wBACpB,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,SAAS;wBAC9B,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;qBACpD;iBACF,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;oBACX,KAAK,CAAC,cAAc,EAAE,CAAC;oBACvB,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBACjC,MAAM,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;gBAC1B,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAQ,EAAE,EAAE;oBACpB,KAAK,CAAC,MAAM,EAAE,CAAC;oBACf,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACxE,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAChC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,wBAAwB,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC3E,KAAK,CAAC,MAAM,EAAE,CAAC;gBACf,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;YACrB,IAAI,SAAS,EAAE,CAAC;gBAAC,YAAY,CAAC,SAAS,CAAC,CAAC;gBAAC,SAAS,GAAG,IAAI,CAAC;YAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACzB,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,KAAK,CAAC,MAAM,EAAE,CAAC;YACf,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;YACxB,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,WAAW,EAAE,CAAC;YACd,EAAE,GAAG,IAAI,CAAC;YACV,IAAI,CAAC,gBAAgB,IAAI,OAAO,EAAE,CAAC;gBACjC,iBAAiB,EAAE,CAAC;YACtB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,KAAK;YACH,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YACtC,OAAO,GAAG,IAAI,CAAC;YACf,gBAAgB,GAAG,KAAK,CAAC;YACzB,OAAO,GAAG,CAAC,CAAC;YAEZ,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC3C,IAAI,OAAO,GAAG,KAAK,CAAC;gBACpB,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;wBACb,OAAO,GAAG,IAAI,CAAC;wBACf,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,IAAI,8BAA8B,cAAc,IAAI,CAAC,CAAC,CAAC;oBAC3F,CAAC;gBACH,CAAC,EAAE,cAAc,CAAC,CAAC;gBAEnB,SAAS,CACP,GAAG,EAAE;oBACH,IAAI,CAAC,OAAO,EAAE,CAAC;wBACb,OAAO,GAAG,IAAI,CAAC;wBACf,YAAY,CAAC,OAAO,CAAC,CAAC;wBACtB,OAAO,EAAE,CAAC;oBACZ,CAAC;gBACH,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;oBACN,IAAI,CAAC,OAAO,EAAE,CAAC;wBACb,OAAO,GAAG,IAAI,CAAC;wBACf,YAAY,CAAC,OAAO,CAAC,CAAC;wBACtB,MAAM,CAAC,GAAG,CAAC,CAAC;oBACd,CAAC;gBACH,CAAC,CACF,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,IAAI;YACR,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,OAAO,GAAG,KAAK,CAAC;YAChB,gBAAgB,GAAG,IAAI,CAAC;YACxB,WAAW,EAAE,CAAC;YACd,IAAI,EAAE,EAAE,CAAC;gBACP,EAAE,CAAC,KAAK,EAAE,CAAC;gBACX,EAAE,GAAG,IAAI,CAAC;YACZ,CAAC;QACH,CAAC;QAED,IAAI,OAAO;YACT,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,IAAI,KAAK;YACP,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/patterns/index.d.ts

@@ -2,4 +2,6 @@ export { createBridge } from './bridge.js';
 export type { SignalBridge, BridgeStats } from './bridge.js';
 export { createSentinel } from './sentinel.js';
 export type { Sentinel, SentinelConfig, SentinelEvaluation, SentinelStats } from './sentinel.js';
+export { createDebugBridge } from './debug-bridge.js';
+export type { DebugBridge, DebugBridgeConfig } from './debug-bridge.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/patterns/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/patterns/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/patterns/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/patterns/index.js

@@ -1,3 +1,4 @@
 export { createBridge } from './bridge.js';
 export { createSentinel } from './sentinel.js';
+export { createDebugBridge } from './debug-bridge.js';
 //# sourceMappingURL=index.js.map

package/dist/src/patterns/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/patterns/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/patterns/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandible-ai/mandible",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "description": "Universal stigmergy framework for autonomous agent coordination — like ant colonies using pheromone trails",
   "type": "module",
   "main": "dist/src/index.js",