@agentdeck/bridge 0.2.1 → 0.2.3

package/dist/codex-rollout-response.js

@@ -0,0 +1,135 @@
+/**
+ * Extract a Codex turn's final response text from its rollout JSONL.
+ *
+ * Why this exists: observed (direct-run) Codex sessions reach the daemon
+ * only through codex_* lifecycle hooks, and `codex_stop`'s stdin payload
+ * does not reliably carry the assistant text (the Swift daemon probes
+ * `last_assistant_message`/`response`/`output`/`result` and usually finds
+ * nothing). The rollout Codex writes under `~/.codex/sessions/` DOES hold
+ * it: `event_msg` records of type `agent_message` (`payload.message`) and,
+ * at turn end, `task_complete` (`payload.last_agent_message`). This is the
+ * Codex counterpart of `lastAssistantTextFromTranscript` for Claude —
+ * hooks stay the boundary signal, the agent's own on-disk log supplies the
+ * body, and nothing parses terminal output.
+ *
+ * Self-contained and read-only on purpose (mirrors
+ * session-transcript-timeline.ts): never throws, returns '' when nothing
+ * is found. Locating scans recent `~/.codex/sessions/<y>/<m>/<d>/` dirs
+ * newest-first for `rollout-*-<sessionId>.jsonl` — the filename embeds the
+ * session uuid, and scanning across day dirs (bounded) covers turns that
+ * roll past midnight (memory: cross-day rollout selection).
+ */
+import { readdirSync, readFileSync, openSync, readSync, closeSync, fstatSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { debug } from './logger.js';
+/** Max day directories to inspect, newest first. */
+const MAX_DAY_DIRS = 30;
+/** Tail window — final agent_message + task_complete land at the end. */
+const TAIL_BYTES = 128 * 1024;
+function numericDesc(names) {
+    return names
+        .filter((n) => /^\d+$/.test(n))
+        .sort((a, b) => Number(b) - Number(a));
+}
+function safeReaddir(path) {
+    try {
+        return readdirSync(path);
+    }
+    catch {
+        return [];
+    }
+}
+/** Locate `rollout-*-<sessionId>.jsonl` under the newest day dirs. */
+export function locateCodexRollout(sessionId, sessionsRoot) {
+    if (!sessionId || !/^[0-9a-f-]{8,}$/i.test(sessionId))
+        return null;
+    const root = sessionsRoot ?? join(homedir(), '.codex', 'sessions');
+    const suffix = `-${sessionId}.jsonl`;
+    let dayDirsChecked = 0;
+    for (const year of numericDesc(safeReaddir(root))) {
+        for (const month of numericDesc(safeReaddir(join(root, year)))) {
+            for (const day of numericDesc(safeReaddir(join(root, year, month)))) {
+                if (++dayDirsChecked > MAX_DAY_DIRS)
+                    return null;
+                const dir = join(root, year, month, day);
+                for (const name of safeReaddir(dir)) {
+                    if (name.startsWith('rollout-') && name.endsWith(suffix)) {
+                        return join(dir, name);
+                    }
+                }
+            }
+        }
+    }
+    return null;
+}
+function readTail(path, maxBytes) {
+    try {
+        const fd = openSync(path, 'r');
+        try {
+            const size = fstatSync(fd).size;
+            const len = Math.min(size, maxBytes);
+            const buf = Buffer.alloc(len);
+            readSync(fd, buf, 0, len, size - len);
+            return buf.toString('utf-8');
+        }
+        finally {
+            closeSync(fd);
+        }
+    }
+    catch {
+        try {
+            return readFileSync(path, 'utf-8').slice(-maxBytes);
+        }
+        catch {
+            return '';
+        }
+    }
+}
+/**
+ * Parse the rollout tail for the turn's final response, newest record
+ * first. `task_complete.last_agent_message` wins (authoritative turn
+ * close); otherwise the last `agent_message` body — Codex emits
+ * mid-turn `commentary` messages too, and the final one is the reply.
+ */
+export function lastAgentMessageFromCodexRollout(sessionId, sessionsRoot) {
+    const path = locateCodexRollout(sessionId, sessionsRoot);
+    if (!path)
+        return '';
+    const lines = readTail(path, TAIL_BYTES).split('\n');
+    let lastAgentMessage = '';
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i].trim();
+        if (!line)
+            continue;
+        let record;
+        try {
+            record = JSON.parse(line);
+        }
+        catch {
+            continue; // torn first line of the tail window
+        }
+        if (record.type !== 'event_msg')
+            continue;
+        const payload = record.payload;
+        if (!payload || typeof payload !== 'object')
+            continue;
+        if (payload.type === 'task_complete' && typeof payload.last_agent_message === 'string'
+            && payload.last_agent_message.trim()) {
+            return payload.last_agent_message.trim();
+        }
+        if (!lastAgentMessage && payload.type === 'agent_message'
+            && typeof payload.message === 'string' && payload.message.trim()) {
+            lastAgentMessage = payload.message.trim();
+            // Keep scanning upward only for a task_complete that might supersede;
+            // but task_complete always FOLLOWS agent_message in the log, so if we
+            // reached an agent_message first (scanning backwards) there is no
+            // newer task_complete — return immediately.
+            break;
+        }
+    }
+    if (!lastAgentMessage)
+        debug('codex-rollout', `no agent_message in tail of ${path}`);
+    return lastAgentMessage;
+}
+//# sourceMappingURL=codex-rollout-response.js.map

package/dist/codex-rollout-response.js.map

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

package/dist/daemon-server.d.ts

@@ -10,10 +10,95 @@
  *
  * Exports `startDaemon()` called by cli.ts.
  */
+import WebSocket from 'ws';
+import { BridgeCore } from './bridge-core.js';
+/**
+ * Single-path transport dedup. A physical ESP32 can be reachable over BOTH a
+ * USB serial connection and a WiFi WebSocket at once (e.g. inkdeck/ttgo/tc001
+ * plugged in for flashing while still joined to the AP). Serial is the more
+ * reliable, lower-latency path, so when a board is live on serial we drive it
+ * over serial only and suppress the redundant WiFi copy — no board receives the
+ * same event twice.
+ *
+ * Match is by board id, confirmed by the board's WiFi IP when both sides report
+ * one. If the serial side reports no IP (radio parked / pre-DHCP) the board id
+ * is the only shared key and we still prefer serial. Pure + exported for tests.
+ */
+export declare function isWifiTransportRedundant(wifi: {
+    board?: string;
+    ip?: string;
+} | null, serialBoards: Array<{
+    board: string;
+    ip?: string;
+}>): boolean;
+declare function registerWifiEsp32(d: Record<string, unknown>, ws: WebSocket): void;
+declare function unregisterWifiEsp32Socket(ws: WebSocket): void;
+declare function handleEsp32OtaReply(msg: Record<string, unknown>): boolean;
+/** @internal */
+export declare function __setOtaTimeoutsForTest(t: {
+    begin?: number;
+    chunk?: number;
+    end?: number;
+    reconnectWait?: number;
+}): void;
+/** @internal */
+export declare function __resetWifiEsp32OtaState(): void;
+/** @internal */
+export declare const __wifiOtaTestApi: {
+    registerWifiEsp32: typeof registerWifiEsp32;
+    unregisterWifiEsp32Socket: typeof unregisterWifiEsp32Socket;
+    handleEsp32OtaReply: typeof handleEsp32OtaReply;
+    performWifiEsp32Ota: typeof performWifiEsp32Ota;
+};
+declare function performWifiEsp32Ota(core: BridgeCore, target: string, firmwarePath: string): Promise<Record<string, unknown>>;
+/**
+ * Stamp OpenClaw origin onto a timeline entry emitted by the Gateway adapter.
+ *
+ * The adapter emits bare entries (no agentType/projectName); without this the
+ * BridgeCore attributor falls back to the daemon's hardcoded projectName
+ * ('AgentDeck') and leaves agentType null, so OpenClaw cron activity gets
+ * mis-grouped under AgentDeck and never renders as OpenClaw. `?? ` fallbacks
+ * preserve any value the adapter did set, and the downstream attributor's own
+ * `?? ` keeps these in turn.
+ */
+export declare function enrichGatewayTimelineEntry<T extends {
+    agentType?: string;
+    projectName?: string;
+}>(entry: T): T;
+/**
+ * Classify a `/hooks/<eventName>` POST for the observed-session pipeline.
+ *
+ * Claude hooks arrive as PascalCase names (already snake_cased by the
+ * caller's eventMap → `mapped`); Codex lifecycle hooks (installed into
+ * `~/.codex/config.toml`) arrive as `codex_*`; the AgentDeck OpenCode
+ * observer plugin posts `opencode_*`. All three share one pipeline —
+ * APME run/turn management, the chat_start row, and the stop-completion
+ * row — keyed off the returned agent-neutral `boundary`, so a direct
+ * `codex` or standalone `opencode` run gets the same prompt → response
+ * turn shape on the timeline as a direct `claude` run. (The Swift daemon
+ * has carried Codex parity since its observation pass —
+ * DaemonServer.swift appendCodexChatStart/End; this closes the same gap
+ * on the Node daemon.)
+ *
+ * Codex notify's `turn_complete` maps to `stop`: it closes a turn the
+ * same way, and the caller's open-turn guard collapses a stop +
+ * turn_complete pair into a single completion row.
+ *
+ * `antigravity_*` is accepted for forward-compatibility: Antigravity has
+ * no hook installer yet (the IDE exposes no lifecycle hook config; its
+ * sessions surface via PassiveSessionObserver transcript polling), but
+ * anything that starts POSTing these names gets full turn parity with no
+ * daemon change.
+ */
+export declare function classifyObservedHookEvent(eventName: string, mapped: string): {
+    boundary: string;
+    agentType: 'claude-code' | 'codex-cli' | 'opencode' | 'antigravity';
+};
 export interface DaemonOptions {
     port?: number;
     debug?: boolean;
     wakeWord?: boolean;
 }
 export declare function startDaemon(opts: DaemonOptions): Promise<void>;
+export {};
 //# sourceMappingURL=daemon-server.d.ts.map

package/dist/daemon-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"daemon-server.d.ts","sourceRoot":"","sources":["../src/daemon-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAmJH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAiED,wBAAsB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAw9BpE"}
+{"version":3,"file":"daemon-server.d.ts","sourceRoot":"","sources":["../src/daemon-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,UAAU,EAA8B,MAAM,kBAAkB,CAAC;AA4I1E;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAC5C,YAAY,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAClD,OAAO,CAST;AAkBD,iBAAS,iBAAiB,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,GAAG,IAAI,CA4B1E;AAYD,iBAAS,yBAAyB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAStD;AAED,iBAAS,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAsBlE;AA6ED,gBAAgB;AAChB,wBAAgB,uBAAuB,CAAC,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKzH;AACD,gBAAgB;AAChB,wBAAgB,wBAAwB,IAAI,IAAI,CAS/C;AACD,gBAAgB;AAChB,eAAO,MAAM,gBAAgB;;;;;CAK5B,CAAC;AAEF,iBAAe,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8F3H;AAoID;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/F,KAAK,EAAE,CAAC,GACP,CAAC,CAMH;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,CAAA;CAAE,CAU3F;AAID,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAiHD,wBAAsB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA03DpE"}