@agentdeck/bridge 1.0.24 → 1.2.0

package/dist/mdns.d.ts

@@ -1,4 +1,37 @@
 import type { AgentType } from './types.js';
+/**
+ * True when a LAN peer could actually route to this IPv4 address.
+ *
+ * `bonjour-service` publishes one A record per non-internal IPv4 address it
+ * finds, with no routability test (`service.js` -> `records()`). That set is
+ * captured at PUBLISH time, and the daemon publishes seconds after start — so a
+ * machine whose second interface is still negotiating DHCP advertises its
+ * transient `169.254/16` APIPA address as a way to reach the daemon. Nothing
+ * ever retracts it: the address disappears from `os.networkInterfaces()`, so no
+ * later announcement carries it and no goodbye is ever sent for it, while every
+ * resolver that heard it keeps handing it out.
+ *
+ * Measured on this repo's own fleet (2026-08-23): the advertised host resolved
+ * to `192.168.68.100`, `192.168.68.60` AND `169.254.213.161` while no interface
+ * on the machine held that third address. A board that picks it dials a dead
+ * address at max backoff forever, and — because it never reaches the daemon —
+ * leaves no trace in the daemon's log at all. That is the failure mode this
+ * predicate exists to prevent, and the reason the filter belongs on the
+ * PUBLISHING side: a client cannot tell a stale record from a live one.
+ */
+export declare function isRoutableIpv4(addr: string): boolean;
+/**
+ * The IPv4 addresses this host would advertise, after the routability filter.
+ *
+ * This is the value the republish trigger watches. It deliberately returns the
+ * whole SET rather than one address: the publisher emits an A record per
+ * interface while `getLanIp()` names only the default-route one, so watching
+ * `getLanIp()` alone cannot see an address appear or vanish on any OTHER
+ * interface — which is exactly how the stale APIPA record above survived for
+ * hours with the recovery timer running the whole time. A change detector must
+ * watch what actually varies.
+ */
+export declare function advertisedIpv4Addresses(): string[];
 /**
  * `bonjour-service` defaults SRV/A/AAAA records to `os.hostname()`. On macOS
  * that makes its user-space responder claim the same `.local` hostname as the

package/dist/mdns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mdns.d.ts","sourceRoot":"","sources":["../src/mdns.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAc5C;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,QAAwD,CAAC;AAEvF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAcvE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAQ7C;AAKD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,SAAS,GACnB,MAAM,IAAI,CAiJZ"}
+{"version":3,"file":"mdns.d.ts","sourceRoot":"","sources":["../src/mdns.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAU5C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAWlD;AAMD;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,QAAwD,CAAC;AAEvF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAcvE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAQ7C;AAKD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,SAAS,GACnB,MAAM,IAAI,CA+KZ"}

package/dist/mdns.js

@@ -1,8 +1,66 @@
 import Bonjour from 'bonjour-service';
 import { randomUUID } from 'node:crypto';
-import { hostname, userInfo } from 'node:os';
+import { hostname, networkInterfaces, userInfo } from 'node:os';
 import { debug, log } from './logger.js';
 import { getLanIp, buildMdnsInstanceName, mdnsUserTag, sanitizeMdnsLabel, MDNS_TXT_SCHEMA_VERSION, } from '@agentdeck/shared';
+/**
+ * True when a LAN peer could actually route to this IPv4 address.
+ *
+ * `bonjour-service` publishes one A record per non-internal IPv4 address it
+ * finds, with no routability test (`service.js` -> `records()`). That set is
+ * captured at PUBLISH time, and the daemon publishes seconds after start — so a
+ * machine whose second interface is still negotiating DHCP advertises its
+ * transient `169.254/16` APIPA address as a way to reach the daemon. Nothing
+ * ever retracts it: the address disappears from `os.networkInterfaces()`, so no
+ * later announcement carries it and no goodbye is ever sent for it, while every
+ * resolver that heard it keeps handing it out.
+ *
+ * Measured on this repo's own fleet (2026-08-23): the advertised host resolved
+ * to `192.168.68.100`, `192.168.68.60` AND `169.254.213.161` while no interface
+ * on the machine held that third address. A board that picks it dials a dead
+ * address at max backoff forever, and — because it never reaches the daemon —
+ * leaves no trace in the daemon's log at all. That is the failure mode this
+ * predicate exists to prevent, and the reason the filter belongs on the
+ * PUBLISHING side: a client cannot tell a stale record from a live one.
+ */
+export function isRoutableIpv4(addr) {
+    // Link-local / APIPA. Self-assigned; never reachable from another host.
+    if (addr.startsWith('169.254.'))
+        return false;
+    // Loopback. `internal` already covers 127.0.0.1, but an alias on a
+    // non-internal interface would not be caught by that flag.
+    if (addr.startsWith('127.'))
+        return false;
+    if (addr === '0.0.0.0')
+        return false;
+    return true;
+}
+/**
+ * The IPv4 addresses this host would advertise, after the routability filter.
+ *
+ * This is the value the republish trigger watches. It deliberately returns the
+ * whole SET rather than one address: the publisher emits an A record per
+ * interface while `getLanIp()` names only the default-route one, so watching
+ * `getLanIp()` alone cannot see an address appear or vanish on any OTHER
+ * interface — which is exactly how the stale APIPA record above survived for
+ * hours with the recovery timer running the whole time. A change detector must
+ * watch what actually varies.
+ */
+export function advertisedIpv4Addresses() {
+    const out = [];
+    for (const addrs of Object.values(networkInterfaces())) {
+        for (const addr of addrs ?? []) {
+            if (addr.family !== 'IPv4')
+                continue;
+            if (addr.internal || addr.mac === '00:00:00:00:00:00')
+                continue;
+            if (!isRoutableIpv4(addr.address))
+                continue;
+            out.push(addr.address);
+        }
+    }
+    return out.sort();
+}
 let instance = null;
 const MDNS_RECOVERY_INTERVAL = 5_000; // 5s — tightens WiFi-change discovery gap (was 30s)
 /**
@@ -128,7 +186,7 @@ export function advertiseBridge(port, projectName, agentType) {
                 project: projectName,
                 agent: agentType,
                 // TXT schema version — keep in lockstep with the Swift daemon's
-                // advertisement (apple/AgentDeck/Daemon/Modules/MdnsModule.swift) so
+                // advertisement (apple/AgentDeck/Daemon/Server/MdnsAdvertisement.swift) so
                 // clients see one contract regardless of which daemon owns the port.
                 v: MDNS_TXT_SCHEMA_VERSION,
                 port: String(port),
@@ -147,6 +205,24 @@ export function advertiseBridge(port, projectName, agentType) {
                 port,
                 txt,
             });
+            // Drop unroutable A records at the source. `records()` is recomputed on
+            // every announce AND on the goodbye, so wrapping the instance method
+            // covers both: what we never announce, we never have to retract.
+            //
+            // This is a wrap rather than a config flag because `bonjour-service`
+            // offers none — it hard-codes "every non-internal IPv4 address" — and
+            // the `interface` option below pins only the SOCKET, not the record set,
+            // so even the Windows egress pin ships the bogus addresses inside the
+            // packet it sends out the right adapter.
+            const svc = service;
+            const baseRecords = svc.records?.bind(service);
+            if (baseRecords) {
+                svc.records = () => baseRecords().filter((r) => {
+                    if (r.type !== 'A')
+                        return true;
+                    return typeof r.data === 'string' && isRoutableIpv4(r.data);
+                });
+            }
             // Catch async publish errors — mDNS is non-critical
             service.on?.('error', (err) => {
                 debug('mDNS', `Service error (ignored): ${err.message}`);
@@ -172,10 +248,16 @@ export function advertiseBridge(port, projectName, agentType) {
             return false;
         }
     }
-    // Track published IP to detect changes (DHCP renewal, interface switch)
+    // Track the published ADDRESS SET, not just the default-route IP. A record
+    // per interface goes out, so an address appearing or vanishing on a
+    // non-default interface changes what we advertise while `getLanIp()` stays
+    // put — and that gap is what let a transient APIPA address stay advertised
+    // for hours with this very timer running. See `advertisedIpv4Addresses`.
     let publishedIp;
+    let publishedAddrs = '';
     function publishAndTrackIp() {
         publishedIp = getLanIp();
+        publishedAddrs = advertisedIpv4Addresses().join(',');
         return publish();
     }
     // Initial publish
@@ -208,6 +290,13 @@ export function advertiseBridge(port, projectName, agentType) {
             log(`[mDNS] IP changed (${publishedIp} → ${lanIp}) — re-publishing service`);
             publishAndTrackIp();
         }
+        else {
+            const addrs = advertisedIpv4Addresses().join(',');
+            if (addrs !== publishedAddrs) {
+                log(`[mDNS] Advertised address set changed (${publishedAddrs || 'none'} → ${addrs || 'none'}) — re-publishing service`);
+                publishAndTrackIp();
+            }
+        }
     }, MDNS_RECOVERY_INTERVAL);
     return () => {
         stopped = true;

package/dist/mdns.js.map

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

package/dist/openclaw-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openclaw-session.d.ts","sourceRoot":"","sources":["../src/openclaw-session.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AAEtD,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAC1C;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,eAAe,EAAE,EAC3B,IAAI,EAAE,qBAAqB,GAC1B,eAAe,EAAE,CA0BnB"}
+{"version":3,"file":"openclaw-session.d.ts","sourceRoot":"","sources":["../src/openclaw-session.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AAEtD,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAC1C;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,eAAe,EAAE,EAC3B,IAAI,EAAE,qBAAqB,GAC1B,eAAe,EAAE,CAsCnB"}

package/dist/openclaw-session.js

@@ -37,6 +37,19 @@ export function injectOpenClawSession(sessions, opts) {
         injected.controlMode = opts.controlMode;
     if (opts.approval) {
         injected.question = opts.approval.question;
+        // The question is the command; `questionDetail` is everything that makes it
+        // a decision — the policy reason approval was demanded, the cwd, and WHICH
+        // OpenClaw session asked. All three were parsed and then dropped here, so a
+        // deck asked the user to approve a bare `sed -n` with no reason and no way
+        // to tell a cron heartbeat apart from a model-eval run (measured
+        // 2026-08-23: every approval came from `agent:main:eval-…__r2`, while the
+        // row said only "OpenClaw").
+        const detailLines = [
+            ...(opts.approval.detail ? opts.approval.detail.split('\n') : []),
+            ...(opts.approval.sessionKey ? [`session: ${opts.approval.sessionKey}`] : []),
+        ].map((l) => l.trim()).filter(Boolean);
+        if (detailLines.length > 0)
+            injected.questionDetail = detailLines.join('\n');
         injected.options = opts.approval.options.map((o) => ({
             index: o.index, label: o.label, shortcut: o.shortcut,
         }));

package/dist/openclaw-session.js.map

@@ -1 +1 @@
-{"version":3,"file":"openclaw-session.js","sourceRoot":"","sources":["../src/openclaw-session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAIhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAqBtD;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA2B,EAC3B,IAA2B;IAE3B,IAAI,CAAC,uBAAuB,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC3F,IAAI,kBAAkB,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClD,MAAM,QAAQ,GAAoB;QAChC,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,UAAU;QAC3C,SAAS,EAAE,UAAU;QACrB,KAAK,EAAE,IAAI;KACZ,CAAC;IACF,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1D,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACtE,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IAC5E,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC3C,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnD,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrD,CAAC,CAAC,CAAC;QACJ,QAAQ,CAAC,UAAU,GAAG,eAAe,CAAC;QACtC,yEAAyE;QACzE,wEAAwE;QACxE,4EAA4E;QAC5E,sBAAsB;QACtB,QAAQ,CAAC,cAAc,GAAG,IAAI,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"openclaw-session.js","sourceRoot":"","sources":["../src/openclaw-session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAIhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAqBtD;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA2B,EAC3B,IAA2B;IAE3B,IAAI,CAAC,uBAAuB,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC3F,IAAI,kBAAkB,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClD,MAAM,QAAQ,GAAoB;QAChC,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,UAAU;QAC3C,SAAS,EAAE,UAAU;QACrB,KAAK,EAAE,IAAI;KACZ,CAAC;IACF,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1D,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACtE,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IAC5E,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC3C,4EAA4E;QAC5E,2EAA2E;QAC3E,4EAA4E;QAC5E,2EAA2E;QAC3E,iEAAiE;QACjE,0EAA0E;QAC1E,6BAA6B;QAC7B,MAAM,WAAW,GAAG;YAClB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9E,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YAAE,QAAQ,CAAC,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnD,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrD,CAAC,CAAC,CAAC;QACJ,QAAQ,CAAC,UAAU,GAAG,eAAe,CAAC;QACtC,yEAAyE;QACzE,wEAAwE;QACxE,4EAA4E;QAC5E,sBAAsB;QACtB,QAAQ,CAAC,cAAc,GAAG,IAAI,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACjC,CAAC"}

package/dist/openclaw-timeline-feed.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Feeds OpenClaw's own transcript into the daemon's live timeline.
+ *
+ * The Gateway stream says that OpenClaw answered; it does not say what it did
+ * to answer. Only tools that needed approval ever reached the strip, which is a
+ * biased sample rather than a log. This is the producer for the rest, read off
+ * the store OpenClaw writes anyway (`openclaw-transcript-timeline.ts`).
+ *
+ * Three bounds, each for a measured reason:
+ *
+ *  - **Only recently-active sessions are read.** The store keeps every session
+ *    forever — 103 of them on the machine this was built against, most long
+ *    finished. Sessions are polled by `updatedAt`, newest first, inside
+ *    `ACTIVE_WINDOW_MS`.
+ *
+ *  - **A first sighting emits NOTHING.** This is the opposite of
+ *    `KiroTimelineFeed`, deliberately: Kiro seeds the last turn because a Kiro
+ *    session otherwise shows a live row beside a blank strip, which reads as
+ *    broken. OpenClaw has no such gap — the Gateway stream is already filling
+ *    the strip live — so seeding here would only inject minutes-old tool calls
+ *    from finished eval runs into an activity log, competing with the live
+ *    rows it is meant to supplement.
+ *
+ *  - **Rows land on the existing `openclaw-gateway` row, not on new sessions.**
+ *    One OpenClaw instance is one session everywhere else in AgentDeck, the
+ *    deck is sized for sessions, and an eval suite opens a fresh session key
+ *    per run — six in the three hours this was measured over. Which session key
+ *    produced a row rides its `detail` instead, since that is the fact that
+ *    distinguishes the chat the user is looking at from a cron job and from a
+ *    model-eval run.
+ */
+import type { TimelineEntry } from '@agentdeck/shared';
+import { type OpenClawStoreSession } from './openclaw-transcript-timeline.js';
+/**
+ * How often the daemon pumps this feed.
+ *
+ * Deliberately equal to the passive observer's `SCAN_INTERVAL_MS`: this feed is
+ * polled, so an OpenClaw tool call reaches the timeline seconds late rather
+ * than instantly, which is the same contract every transcript-observed agent
+ * already carries. It is exported so the daemon cannot quietly drift to a
+ * cadence nobody measured — the pump is synchronous fs work (~7 ms typical,
+ * ~28 ms worst case against a real store).
+ */
+export declare const OPENCLAW_FEED_INTERVAL_MS = 5000;
+export type OpenClawRowReader = (sessionId: string, opts: {
+    since?: number;
+    limit?: number;
+}) => TimelineEntry[];
+export type OpenClawSessionLister = () => OpenClawStoreSession[];
+/**
+ * The human-facing half of a session key.
+ *
+ * `agent:main:eval-full-unified-mlx-2026-08-23-a03__openrouter-stealth-ox-alpha__r2`
+ * is what the store holds and it does not fit anywhere. The leading
+ * `agent:<agent>:` is constant for a given install and carries nothing, so it
+ * is dropped; what remains is the part that says which KIND of work this is.
+ */
+export declare function shortSessionKey(sessionKey: string): string;
+export declare class OpenClawTimelineFeed {
+    private readonly readRows;
+    private readonly listSessions;
+    /** sessionId → newest row timestamp already accounted for. */
+    private readonly watermark;
+    constructor(readRows?: OpenClawRowReader, listSessions?: OpenClawSessionLister);
+    /**
+     * Rows to emit for this tick, oldest-first across all sessions.
+     *
+     * `now` is injectable so a test can drive the activity window without a clock.
+     */
+    pump(now?: number): TimelineEntry[];
+    /** Tracked session count — for tests and diagnostics. */
+    get size(): number;
+    /**
+     * Stamp the row with the virtual Gateway session and say which OpenClaw
+     * session key produced it.
+     *
+     * The key leads `detail`: everything below it (the tool's own output, the
+     * model) is context, while "this came from a model-eval run and not from your
+     * chat" is the part that reorients the reader.
+     */
+    private attribute;
+    private enforceCeiling;
+}
+//# sourceMappingURL=openclaw-timeline-feed.d.ts.map

package/dist/openclaw-timeline-feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-timeline-feed.d.ts","sourceRoot":"","sources":["../src/openclaw-timeline-feed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,mCAAmC,CAAC;AAG3C;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAW/C,MAAM,MAAM,iBAAiB,GAAG,CAC9B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KACrC,aAAa,EAAE,CAAC;AACrB,MAAM,MAAM,qBAAqB,GAAG,MAAM,oBAAoB,EAAE,CAAC;AAEjE;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,qBAAa,oBAAoB;IAK7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAL/B,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;gBAGpC,QAAQ,GAAE,iBAA8C,EACxD,YAAY,GAAE,qBAA4C;IAG7E;;;;OAIG;IACH,IAAI,CAAC,GAAG,GAAE,MAAmB,GAAG,aAAa,EAAE;IA+C/C,yDAAyD;IACzD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,cAAc;CAQvB"}

package/dist/openclaw-timeline-feed.js

@@ -0,0 +1,162 @@
+/**
+ * Feeds OpenClaw's own transcript into the daemon's live timeline.
+ *
+ * The Gateway stream says that OpenClaw answered; it does not say what it did
+ * to answer. Only tools that needed approval ever reached the strip, which is a
+ * biased sample rather than a log. This is the producer for the rest, read off
+ * the store OpenClaw writes anyway (`openclaw-transcript-timeline.ts`).
+ *
+ * Three bounds, each for a measured reason:
+ *
+ *  - **Only recently-active sessions are read.** The store keeps every session
+ *    forever — 103 of them on the machine this was built against, most long
+ *    finished. Sessions are polled by `updatedAt`, newest first, inside
+ *    `ACTIVE_WINDOW_MS`.
+ *
+ *  - **A first sighting emits NOTHING.** This is the opposite of
+ *    `KiroTimelineFeed`, deliberately: Kiro seeds the last turn because a Kiro
+ *    session otherwise shows a live row beside a blank strip, which reads as
+ *    broken. OpenClaw has no such gap — the Gateway stream is already filling
+ *    the strip live — so seeding here would only inject minutes-old tool calls
+ *    from finished eval runs into an activity log, competing with the live
+ *    rows it is meant to supplement.
+ *
+ *  - **Rows land on the existing `openclaw-gateway` row, not on new sessions.**
+ *    One OpenClaw instance is one session everywhere else in AgentDeck, the
+ *    deck is sized for sessions, and an eval suite opens a fresh session key
+ *    per run — six in the three hours this was measured over. Which session key
+ *    produced a row rides its `detail` instead, since that is the fact that
+ *    distinguishes the chat the user is looking at from a cron job and from a
+ *    model-eval run.
+ */
+import { OPENCLAW_SESSION_ID } from './openclaw-session.js';
+import { listOpenClawSessions, openClawTimelineForSession, } from './openclaw-transcript-timeline.js';
+import { debug } from './logger.js';
+/**
+ * How often the daemon pumps this feed.
+ *
+ * Deliberately equal to the passive observer's `SCAN_INTERVAL_MS`: this feed is
+ * polled, so an OpenClaw tool call reaches the timeline seconds late rather
+ * than instantly, which is the same contract every transcript-observed agent
+ * already carries. It is exported so the daemon cannot quietly drift to a
+ * cadence nobody measured — the pump is synchronous fs work (~7 ms typical,
+ * ~28 ms worst case against a real store).
+ */
+export const OPENCLAW_FEED_INTERVAL_MS = 5_000;
+/** How recently a session must have been written to be worth reading. */
+const ACTIVE_WINDOW_MS = 30 * 60 * 1000;
+/** Sessions read per tick, newest-first. An eval suite runs a handful at once. */
+const MAX_SESSIONS_PER_TICK = 8;
+/** Rows read per session per tick — measured traffic was 28 tool calls / 3 h. */
+const ROWS_PER_TICK = 12;
+/** Watermarks kept at most, newest-first: the store never forgets a session. */
+const MAX_TRACKED = 64;
+/**
+ * The human-facing half of a session key.
+ *
+ * `agent:main:eval-full-unified-mlx-2026-08-23-a03__openrouter-stealth-ox-alpha__r2`
+ * is what the store holds and it does not fit anywhere. The leading
+ * `agent:<agent>:` is constant for a given install and carries nothing, so it
+ * is dropped; what remains is the part that says which KIND of work this is.
+ */
+export function shortSessionKey(sessionKey) {
+    const stripped = sessionKey.replace(/^agent:[^:]+:/, '');
+    return stripped || sessionKey;
+}
+export class OpenClawTimelineFeed {
+    readRows;
+    listSessions;
+    /** sessionId → newest row timestamp already accounted for. */
+    watermark = new Map();
+    constructor(readRows = openClawTimelineForSession, listSessions = listOpenClawSessions) {
+        this.readRows = readRows;
+        this.listSessions = listSessions;
+    }
+    /**
+     * Rows to emit for this tick, oldest-first across all sessions.
+     *
+     * `now` is injectable so a test can drive the activity window without a clock.
+     */
+    pump(now = Date.now()) {
+        let sessions;
+        try {
+            sessions = this.listSessions();
+        }
+        catch (err) {
+            debug('daemon', `openclaw-feed session list failed: ${String(err)}`);
+            return [];
+        }
+        const active = sessions
+            .filter((s) => now - s.updatedAt <= ACTIVE_WINDOW_MS)
+            .slice(0, MAX_SESSIONS_PER_TICK);
+        const live = new Set(active.map((s) => s.sessionId));
+        for (const id of [...this.watermark.keys()]) {
+            if (!live.has(id))
+                this.watermark.delete(id);
+        }
+        const out = [];
+        for (const session of active) {
+            const since = this.watermark.get(session.sessionId);
+            let rows;
+            try {
+                rows = this.readRows(session.sessionId, { since, limit: ROWS_PER_TICK });
+            }
+            catch (err) {
+                debug('daemon', `openclaw-feed read failed for ${session.sessionId}: ${String(err)}`);
+                continue;
+            }
+            if (rows.length === 0) {
+                // Seed an empty/unreadable session at 0 so its first real row is
+                // emitted rather than swallowed as history.
+                if (since === undefined)
+                    this.watermark.set(session.sessionId, 0);
+                continue;
+            }
+            const newest = rows[rows.length - 1].ts;
+            this.watermark.set(session.sessionId, newest);
+            if (since === undefined) {
+                // First sighting: adopt the position, emit nothing. See the header —
+                // the Gateway stream is already filling this session's strip.
+                debug('daemon', `openclaw-feed seeded ${session.sessionId} at ${newest} (silent)`);
+                continue;
+            }
+            for (const row of rows)
+                out.push(this.attribute(row, session));
+        }
+        this.enforceCeiling();
+        return out.sort((a, b) => (a.ts < b.ts ? -1 : a.ts > b.ts ? 1 : 0));
+    }
+    /** Tracked session count — for tests and diagnostics. */
+    get size() {
+        return this.watermark.size;
+    }
+    /**
+     * Stamp the row with the virtual Gateway session and say which OpenClaw
+     * session key produced it.
+     *
+     * The key leads `detail`: everything below it (the tool's own output, the
+     * model) is context, while "this came from a model-eval run and not from your
+     * chat" is the part that reorients the reader.
+     */
+    attribute(row, session) {
+        const head = `session: ${shortSessionKey(session.sessionKey)}`;
+        return {
+            ...row,
+            sessionId: OPENCLAW_SESSION_ID,
+            agentType: 'openclaw',
+            projectName: 'OpenClaw',
+            detail: [head, row.detail].filter(Boolean).join('\n'),
+        };
+    }
+    enforceCeiling() {
+        if (this.watermark.size <= MAX_TRACKED)
+            return;
+        const byAge = [...this.watermark.entries()].sort((a, b) => a[1] - b[1]);
+        for (const [id] of byAge) {
+            if (this.watermark.size <= MAX_TRACKED)
+                break;
+            this.watermark.delete(id);
+        }
+    }
+}
+//# sourceMappingURL=openclaw-timeline-feed.js.map

package/dist/openclaw-timeline-feed.js.map

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

package/dist/openclaw-transcript-timeline.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Timeline rows read from OpenClaw's OWN on-disk session store.
+ *
+ * WHY THIS EXISTS. OpenClaw reaches this daemon through the Gateway WebSocket
+ * event stream and nothing else — the adapter's whole RPC surface is `connect`
+ * / `sessions.list` / `chat.send` / `chat.abort` / `exec.approval.*`. That
+ * stream carries the prompt, the final response, and the approvals it has to
+ * block on. It does NOT carry the individual tool calls, so the timeline showed
+ * "OpenClaw said something" with no account of what it actually did, and the
+ * only tools that ever appeared were the ones that happened to need approval —
+ * a biased sample, not a log.
+ *
+ * OpenClaw writes a full transcript per session (measured 2026-08-23 against
+ * OpenClaw 2026.7.1-2). This reads it, exactly the way `kiro-transcript-timeline`
+ * reads Kiro's — an agent that pushes nothing still has a producer.
+ *
+ * **Scope is deliberately the complement of the Gateway stream, not a
+ * duplicate of it.** Only `tool_exec` rows are emitted here. Prompts, responses
+ * and approval rows already arrive live over the Gateway and re-deriving them
+ * would double every turn in the strip.
+ *
+ * The record shapes below were copied off a real store, never invented — this
+ * repo has a specific history of parsers written against imagined fixtures that
+ * passed their tests and matched nothing real, so the test file pins the
+ * measured shape verbatim:
+ *
+ *   {"type":"session","version":3,"id":"fef73899-…","timestamp":"2026-08-22T23:52:16.443Z",
+ *    "cwd":"/Users/x/.openclaw/workspace"}
+ *   {"type":"message","id":"577c04b8","parentId":"40296bc1",
+ *    "timestamp":"2026-08-22T23:52:23.315Z",
+ *    "message":{"role":"assistant","content":[
+ *      {"type":"thinking","thinking":"…"},
+ *      {"type":"toolCall","id":"38e16c61-…","name":"exec",
+ *       "arguments":{"command":"ls ~/github/OpenClaw && …"}}],
+ *     "provider":"openrouter","model":"stealth/ox-alpha","usage":{…}}}
+ *   {"type":"message","id":"53079fbe","timestamp":"2026-08-22T23:52:23.376Z",
+ *    "message":{"role":"toolResult","toolCallId":"38e16c61-…","toolName":"exec",
+ *     "content":[{"type":"text","text":"CAPTURE_GUIDE.md\n…"}],
+ *     "details":{"status":"completed","exitCode":0,"durationMs":13},"isError":false}}
+ *
+ * Three properties of that shape drive the code:
+ *  - A line carries an ISO `timestamp` AND `message.timestamp` in epoch-ms.
+ *    They agree; the ISO one is used, with the epoch one as the fallback,
+ *    because a row with no time cannot be ordered against the live stream.
+ *  - A tool call and its result are SEPARATE lines linked by `toolCallId`. The
+ *    call names what was attempted and only the result knows whether it worked,
+ *    so a row is emitted once, at the call, and completed from the result.
+ *  - `isError` and `details.exitCode` disagree in the interesting direction: a
+ *    command can exit 0 while the tool reports an error (and vice versa), so
+ *    both are consulted rather than picking one.
+ */
+import type { TimelineEntry } from '@agentdeck/shared';
+export interface OpenClawStoreOptions {
+    /** Injectable for tests; defaults to `~/.openclaw`. */
+    stateDir?: string;
+}
+export interface OpenClawTimelineOptions extends OpenClawStoreOptions {
+    /** Epoch-ms lower bound; rows at or before it are dropped. */
+    since?: number;
+    /** Newest N rows kept. */
+    limit?: number;
+}
+/** One session as the index describes it. */
+export interface OpenClawStoreSession {
+    /** `agent:main:main`, `agent:main:cron:<uuid>`, `agent:main:eval-…__r2`. */
+    sessionKey: string;
+    sessionId: string;
+    agent: string;
+    updatedAt: number;
+}
+export declare function openClawStateDir(opts?: OpenClawStoreOptions): string;
+/**
+ * Sessions across every agent, newest-first.
+ *
+ * Reads each agent's `sessions.json`, whose keys ARE the session keys — the one
+ * fact that says whether a given piece of OpenClaw activity is the chat the
+ * user is looking at (`agent:main:main`), a scheduled job
+ * (`agent:main:cron:<id>`) or a model-eval run (`agent:main:eval-…__r2`). All
+ * three arrive at AgentDeck as the single literal "OpenClaw", which is why an
+ * approval raised by an eval harness looked like it came from a conversation
+ * the user could not find.
+ */
+export declare function listOpenClawSessions(opts?: OpenClawStoreOptions): OpenClawStoreSession[];
+/**
+ * The one line that says what a tool call is going to do.
+ *
+ * `exec` is the overwhelming majority and its `command` is the whole story.
+ * Anything else falls back to the first string-valued argument, then to the
+ * argument names — a tool this build has never seen must degrade to something
+ * true ("browser · url, selector") rather than render as nothing.
+ */
+export declare function summarizeToolArguments(args: unknown): string;
+/**
+ * `tool_exec` rows for one session's transcript, oldest-first.
+ *
+ * Emitted at the CALL, then completed in place from the matching result: the
+ * call is when the work started and is what orders correctly against the live
+ * Gateway rows, while only the result knows the outcome. Building the row at
+ * the result instead would stamp every tool with the time it finished and lose
+ * any call still running when the read happened.
+ */
+export declare function openClawTimelineForSession(sessionId: string, opts?: OpenClawTimelineOptions): TimelineEntry[];
+//# sourceMappingURL=openclaw-transcript-timeline.d.ts.map

package/dist/openclaw-transcript-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-transcript-timeline.d.ts","sourceRoot":"","sources":["../src/openclaw-transcript-timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAWvD,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,oBAAyB,GAAG,MAAM,CAExE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,oBAAyB,GAAG,oBAAoB,EAAE,CAqC5F;AA2CD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAa5D;AAOD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,uBAA4B,GACjC,aAAa,EAAE,CA2HjB"}