@agentvault/claude-bridge 0.7.6 → 0.7.7

package/dist/index.js

@@ -453,12 +453,12 @@ import { join as join11 } from "node:path";
 // ../plugin/dist/index.js
 import * as nc from "node:crypto";
 import { chmod, mkdir, writeFile } from "node:fs/promises";
-import { readFile, rm } from "node:fs/promises";
+import { readdir, readFile, rename, rm } from "node:fs/promises";
 import { join } from "node:path";
-import { readFile as readFile2, rename, rm as rm2 } from "node:fs/promises";
+import { readFile as readFile2, rename as rename2, rm as rm2 } from "node:fs/promises";
 import { join as join2 } from "node:path";
 import { Readable } from "node:stream";
-import { readdir, readFile as readFile3, writeFile as writeFile2, rename as rename2, stat, unlink, mkdir as mkdir2 } from "node:fs/promises";
+import { readdir as readdir2, readFile as readFile3, writeFile as writeFile2, rename as rename3, stat, unlink, mkdir as mkdir2 } from "node:fs/promises";
 import { join as join3 } from "node:path";
 import { randomUUID } from "node:crypto";
 import { EventEmitter } from "node:events";
@@ -63991,7 +63991,7 @@ async function backupState(dataDir) {
   try {
     const data = await readFile2(src, "utf-8");
     await writeSecureFile(tmp, data);
-    await rename(tmp, bak);
+    await rename2(tmp, bak);
   } catch {
   }
 }
@@ -64126,19 +64126,30 @@ var init_transport2 = __esm2({
 });
 var openclaw_compat_exports = {};
 __export2(openclaw_compat_exports, {
+  AGENT_EVENT_CANDIDATES: () => AGENT_EVENT_CANDIDATES,
+  HEARTBEAT_CANDIDATES: () => HEARTBEAT_CANDIDATES,
+  TRANSCRIPT_CANDIDATES: () => TRANSCRIPT_CANDIDATES,
+  _resetCompatCacheForTest: () => _resetCompatCacheForTest,
   onAgentEvent: () => onAgentEvent,
   onSessionTranscriptUpdate: () => onSessionTranscriptUpdate,
-  requestHeartbeatNow: () => requestHeartbeatNow
+  requestHeartbeatNow: () => requestHeartbeatNow,
+  resolveSdkFn: () => resolveSdkFn
 });
-async function requestHeartbeatNow(opts) {
-  if (_heartbeatFn === null) {
+async function resolveSdkFn(candidates, importer = defaultImporter) {
+  for (const { specifier, symbol: symbol22 } of candidates) {
     try {
-      const mod4 = await import("openclaw/dist/plugin-sdk/infra/heartbeat-wake.js");
-      _heartbeatFn = mod4.requestHeartbeatNow ?? mod4.default?.requestHeartbeatNow ?? false;
+      const mod4 = await importer(specifier);
+      const found = mod4?.[symbol22] ?? mod4?.default?.[symbol22];
+      if (typeof found === "function") return found;
     } catch {
-      _heartbeatFn = false;
     }
   }
+  return false;
+}
+async function requestHeartbeatNow(opts) {
+  if (_heartbeatFn === null) {
+    _heartbeatFn = await resolveSdkFn(HEARTBEAT_CANDIDATES);
+  }
   if (typeof _heartbeatFn === "function") {
     try {
       await _heartbeatFn(opts);
@@ -64151,12 +64162,7 @@ async function requestHeartbeatNow(opts) {
 }
 async function onAgentEvent(callback) {
   if (_agentEventFn === null) {
-    try {
-      const mod4 = await import("openclaw/dist/plugin-sdk/infra/agent-events.js");
-      _agentEventFn = mod4.onAgentEvent ?? mod4.default?.onAgentEvent ?? false;
-    } catch {
-      _agentEventFn = false;
-    }
+    _agentEventFn = await resolveSdkFn(AGENT_EVENT_CANDIDATES);
   }
   if (typeof _agentEventFn === "function") {
     try {
@@ -64171,12 +64177,7 @@ async function onAgentEvent(callback) {
 }
 async function onSessionTranscriptUpdate(callback) {
   if (_transcriptFn === null) {
-    try {
-      const mod4 = await import("openclaw/dist/plugin-sdk/sessions/transcript-events.js");
-      _transcriptFn = mod4.onSessionTranscriptUpdate ?? mod4.default?.onSessionTranscriptUpdate ?? false;
-    } catch {
-      _transcriptFn = false;
-    }
+    _transcriptFn = await resolveSdkFn(TRANSCRIPT_CANDIDATES);
   }
   if (typeof _transcriptFn === "function") {
     try {
@@ -64189,12 +64190,45 @@ async function onSessionTranscriptUpdate(callback) {
   return () => {
   };
 }
+function _resetCompatCacheForTest() {
+  _heartbeatFn = null;
+  _agentEventFn = null;
+  _transcriptFn = null;
+}
+var defaultImporter;
+var HEARTBEAT_CANDIDATES;
+var AGENT_EVENT_CANDIDATES;
+var TRANSCRIPT_CANDIDATES;
 var _heartbeatFn;
 var _agentEventFn;
 var _transcriptFn;
 var init_openclaw_compat = __esm2({
   "src/openclaw-compat.ts"() {
     "use strict";
+    defaultImporter = (specifier) => import(
+      /* @vite-ignore */
+      specifier
+    );
+    HEARTBEAT_CANDIDATES = [
+      // 2026.7.x — exported subpath, and the symbol lost its `Now` suffix.
+      { specifier: "openclaw/plugin-sdk/heartbeat-runtime", symbol: "requestHeartbeat" },
+      // <=2026.6.x — deep dist path, original name.
+      { specifier: "openclaw/dist/plugin-sdk/infra/heartbeat-wake.js", symbol: "requestHeartbeatNow" }
+    ];
+    AGENT_EVENT_CANDIDATES = [
+      { specifier: "openclaw/plugin-sdk/agent-harness", symbol: "onAgentEvent" },
+      { specifier: "openclaw/dist/plugin-sdk/infra/agent-events.js", symbol: "onAgentEvent" }
+    ];
+    TRANSCRIPT_CANDIDATES = [
+      {
+        specifier: "openclaw/plugin-sdk/memory-core-host-engine-foundation",
+        symbol: "onSessionTranscriptUpdate"
+      },
+      {
+        specifier: "openclaw/dist/plugin-sdk/sessions/transcript-events.js",
+        symbol: "onSessionTranscriptUpdate"
+      }
+    ];
     _heartbeatFn = null;
     _agentEventFn = null;
     _transcriptFn = null;
@@ -64509,7 +64543,7 @@ async function handleWorkspaceUpload(data, workspaceDir) {
   const tempPath = join3(workspaceDir, `.tmp_${randomUUID()}_${data.filename}`);
   try {
     await writeFile2(tempPath, data.content, "utf-8");
-    await rename2(tempPath, targetPath);
+    await rename3(tempPath, targetPath);
   } catch (err) {
     try {
       await unlink(tempPath);
@@ -64526,7 +64560,7 @@ async function handleWorkspaceUpload(data, workspaceDir) {
 }
 async function handleWorkspaceList(workspaceDir) {
   try {
-    const entries = await readdir(workspaceDir);
+    const entries = await readdir2(workspaceDir);
     const files = [];
     for (const entry of entries) {
       if (!entry.endsWith(".md")) continue;
@@ -65687,7 +65721,7 @@ var init_channel = __esm2({
        */
       sendActivitySpan(spanData) {
         if (!this._ws || this._ws.readyState !== WebSocket2.OPEN) return;
-        const pluginVersion = true ? "0.23.18" : "0.0.0-dev";
+        const pluginVersion = true ? "0.23.19" : "0.0.0-dev";
         const agentName = this.config.agentName ?? "Agent";
         const resource = {
           "service.name": "agentvault-agent",
@@ -67552,7 +67586,7 @@ var init_channel = __esm2({
                 agentVersion: this.config.agentVersion ?? "0.0.0",
                 // __AV_VERSION__ is injected by esbuild from package.json at build time.
                 // Falls back to "0.0.0-dev" in non-bundled contexts (tests).
-                pluginVersion: true ? "0.23.18" : "0.0.0-dev"
+                pluginVersion: true ? "0.23.19" : "0.0.0-dev"
               });
               this._telemetryReporter.startAutoFlush(3e4);
             }
@@ -67875,7 +67909,7 @@ var init_channel = __esm2({
                     agentVersion: this.config.agentVersion ?? "0.0.0",
                     // __AV_VERSION__ is injected by esbuild from package.json at build time.
                     // Falls back to "0.0.0-dev" in non-bundled contexts (tests).
-                    pluginVersion: true ? "0.23.18" : "0.0.0-dev"
+                    pluginVersion: true ? "0.23.19" : "0.0.0-dev"
                   });
                   this._telemetryReporter.startAutoFlush(3e4);
                 }
@@ -71697,6 +71731,11 @@ var init_tool_audit = __esm2({
     "use strict";
   }
 });
+var init_harness_compat = __esm2({
+  "src/harness-compat.ts"() {
+    "use strict";
+  }
+});
 var isUsingManagedRoutes;
 var init_openclaw_entry = __esm2({
   "src/openclaw-entry.ts"() {
@@ -71707,6 +71746,7 @@ var init_openclaw_entry = __esm2({
     init_openclaw_compat();
     init_lifecycle();
     init_tool_audit();
+    init_harness_compat();
     init_types();
     isUsingManagedRoutes = false;
   }
@@ -97758,7 +97798,7 @@ var init_index = __esm2({
     init_skill_invoker();
     await init_skill_telemetry();
     await init_policy_enforcer();
-    VERSION = true ? "0.23.18" : "0.0.0-dev";
+    VERSION = true ? "0.23.19" : "0.0.0-dev";
   }
 });
 await init_index();
@@ -133398,6 +133438,16 @@ var WorkerQueue = class {
       this.running = false;
     }
   }
+  /**
+   * What the worker had produced, when the session can report it. Read on BOTH the
+   * clean and the failing path: on a clean turn `said: false` with a non-zero
+   * `composedChars` is the "composed but could never ship it" signature (agent-
+   * authored room traffic, where `replyExpected` is false), which is otherwise
+   * indistinguishable from a turn that did nothing.
+   */
+  snapshotOf(session) {
+    return session?.snapshot?.();
+  }
   /** Best-effort trap emit. A broken sink must never break the queue. */
   emitIncident(rec) {
     try {
@@ -133429,10 +133479,23 @@ var WorkerQueue = class {
         }, this.deps.timeoutMs);
       });
       await Promise.race([session.start(), timeout]);
+      const okSnap = this.snapshotOf(session);
+      this.emitIncident({
+        at: new Date(startedAt).toISOString(),
+        outcome: "ok",
+        waitedMs,
+        ranMs: Date.now() - startedAt,
+        timeoutMs: this.deps.timeoutMs,
+        queueDepthAtEnqueue: entry.queueDepthAtEnqueue,
+        queueDepthAtStart,
+        instructionChars: task.instruction.length,
+        replyExpected: task.replyExpected,
+        ...okSnap ? { session: okSnap } : {}
+      });
     } catch (e7) {
       const err = e7;
       this.deps.log(`[worker-queue] task failed: ${err.message}`);
-      const snap = session?.snapshot?.();
+      const snap = this.snapshotOf(session);
       this.emitIncident({
         at: new Date(startedAt).toISOString(),
         outcome: timedOut ? "timeout" : "error",
@@ -133443,6 +133506,7 @@ var WorkerQueue = class {
         queueDepthAtEnqueue: entry.queueDepthAtEnqueue,
         queueDepthAtStart,
         instructionChars: task.instruction.length,
+        replyExpected: task.replyExpected,
         ...snap ? { session: snap } : {}
       });
       session?.abort();
@@ -133464,7 +133528,7 @@ function makeRouter(deps) {
       const replySink = reply ?? (() => {
       });
       const isOwnerDm = opts?.autoReplyOnText === true && opts?.armed === void 0 && deps.workAllowed();
-      const isArmedRoom = opts?.armed?.() === true && deps.workAllowed();
+      const isArmedRoom = opts?.armed?.() === true && deps.workAllowed() && opts?.replyExpected !== false;
       if (isOwnerDm) {
         deps.queue.enqueue({
           instruction: text,
@@ -134027,7 +134091,7 @@ async function main() {
       "[bridge] warning: passing the invite token on the command line is visible to other local users via 'ps'. Prefer: AV_INVITE_TOKEN=\u2026 npx @agentvault/claude-bridge"
     );
   }
-  console.error(`[bridge] version: ${true ? "0.7.6" : "dev"}`);
+  console.error(`[bridge] version: ${true ? "0.7.7" : "dev"}`);
   console.error(`[bridge] data dir: ${cfg.dataDir} (${cfg.dataDirSource})`);
   console.error(`[bridge] workspace: ${cfg.workspaceDir} \xB7 permissions: ${cfg.permissionMode} \xB7 enclave dir fenced`);
   if (cfg.armRoom) {
@@ -134110,7 +134174,7 @@ async function main() {
     // incident is visible in bridge.error.log at the moment it happens.
     onIncident: (rec) => {
       console.error(
-        `[worker-trap] ${rec.at} ${rec.outcome} after ${rec.ranMs}ms (waited ${rec.waitedMs}ms behind ${rec.queueDepthAtEnqueue}, ${rec.queueDepthAtStart} still queued)` + (rec.session ? ` composed=${rec.session.composedChars} result=${rec.session.sawResult} said=${rec.session.said}` : "")
+        `[worker-trap] ${rec.at} ${rec.outcome} after ${rec.ranMs}ms (waited ${rec.waitedMs}ms behind ${rec.queueDepthAtEnqueue}, ${rec.queueDepthAtStart} still queued) replyExpected=${rec.replyExpected}` + (rec.session ? ` composed=${rec.session.composedChars} result=${rec.session.sawResult} said=${rec.session.said}` : "")
       );
       try {
         const dir = join11(cfg.dataDir, "logs");

package/dist/worker-queue.d.ts

@@ -17,19 +17,27 @@ export type WorkerTask = {
     armed?: () => boolean;
 };
 /**
- * Forensic record of a task that did NOT complete cleanly.
+ * Forensic record of EVERY task the queue runs — clean or not.
  *
  * Exists because the 2026-07-24 "loopita went quiet for 5 minutes" incident was
  * diagnosable only by coincidence: the drop-trap happened to capture that the
  * reply landed 300.016s after the ack, and 300s is `WORKER_TIMEOUT_MS` exactly.
  * Nothing in the bridge recorded WHY the worker hung, and the logs carry no
  * timestamps at all, so the evidence was gone by the time we looked.
+ *
+ * 2026-08-06: widened from failures-only to every turn. Recording only failures
+ * made the SLOW case unmeasurable, and slow is the common case: loopita answered
+ * Ballroom2 in 21s when the room was quiet and 81s when a second agent was
+ * talking, and nothing said whether the extra 60s was `waitedMs` or `ranMs`.
+ * Those are different bugs with identical symptoms. A trap that only reports
+ * when it breaks cannot tell you it is the reason things are slow.
  */
 export type WorkerIncident = {
     /** ISO timestamp — the bridge's own logs are unstamped, so this is the anchor. */
     at: string;
-    outcome: "timeout" | "error";
-    error: string;
+    outcome: "ok" | "timeout" | "error";
+    /** Absent on a clean turn — its presence is what marks a real incident. */
+    error?: string;
     /**
      * enqueue -> start. THE load-bearing field: it separates "this task hung" from
      * "this task was stuck behind one that hung". Both look identical to the owner
@@ -44,6 +52,15 @@ export type WorkerIncident = {
     /** Depth still waiting when this task began — the blast radius of this hang. */
     queueDepthAtStart: number;
     instructionChars: number;
+    /**
+     * Whether a reply was expected of this turn — mirrors `WorkerTask.replyExpected`,
+     * i.e. `senderIsAgent === false` upstream. Without it a silent turn
+     * (composed=0, said=false) is unattributable: it could be agent-authored traffic
+     * that was never going to answer, or a turn that waited so long the previous one
+     * already answered. Ballroom2 on 2026-08-06 produced both readings and the record
+     * could not separate them.
+     */
+    replyExpected?: boolean;
     /** What the worker had produced when it died, when the session can report it. */
     session?: {
         composedChars: number;
@@ -91,6 +108,14 @@ export declare class WorkerQueue {
     /** Resolves when the queue has processed everything enqueued so far. */
     whenDrained(): Promise<void>;
     private drain;
+    /**
+     * What the worker had produced, when the session can report it. Read on BOTH the
+     * clean and the failing path: on a clean turn `said: false` with a non-zero
+     * `composedChars` is the "composed but could never ship it" signature (agent-
+     * authored room traffic, where `replyExpected` is false), which is otherwise
+     * indistinguishable from a turn that did nothing.
+     */
+    private snapshotOf;
     /** Best-effort trap emit. A broken sink must never break the queue. */
     private emitIncident;
     private runOne;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentvault/claude-bridge",
-  "version": "0.7.6",
+  "version": "0.7.7",
   "type": "module",
   "description": "AgentVault Claude Bridge — daemon for bridging a Claude agent into secure E2E-encrypted AgentVault 1:1 direct messages and rooms.",
   "main": "dist/index.js",