@agentdeck/bridge 1.0.24 → 1.1.0

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"}