@agentdeck/bridge 1.2.0 → 1.2.1

package/dist/hook-opencode-sessions.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Hook-derived OpenCode session rows for the Node daemon.
+ *
+ * The passive process scan lists a standalone `opencode` TUI as
+ * `observed:opencode:<pid>` — alive, always `idle`, project from the process
+ * cwd — because it can see nothing else. The AgentDeck observer plugin
+ * (hooks/src/opencode-install.ts) POSTs `opencode_*` lifecycle hooks keyed by
+ * OpenCode's own session id, and those carry everything the scan cannot: the
+ * turn (prompt/stop), the running tool, and — the reason this module exists —
+ * `permission.asked`, which OpenCode emits only when it is GENUINELY waiting
+ * for the user. Until 2026-09-05 the Node daemon classified those hooks for
+ * the timeline/APME and dropped them for session state, so an OpenCode
+ * session blocked on a permission read `idle` on every surface while the
+ * Swift daemon (which builds `opencode:<id>` rows from the same hooks)
+ * showed PERM with an answerable requestId.
+ *
+ * Mirror of the Swift daemon's `opencode_*` cases in `DaemonServer.swift`,
+ * shaped like `HookCodexSessions`: rows come and go with the hooks, and the
+ * PID row for the same working directory yields to the hook row so one TUI is
+ * never two creatures.
+ */
+import type { ObservedSession } from './passive-observer.js';
+export type HookOpenCodeState = 'idle' | 'processing' | 'awaiting_permission';
+export interface HookOpenCodeSession {
+    sessionId: string;
+    projectName: string;
+    cwd?: string;
+    state: HookOpenCodeState;
+    currentTool?: string;
+    /** Permission prompt text while `awaiting_permission`. */
+    question?: string;
+    /** `ocperm:<sid>:<permissionId>` — the daemon's `permission_decision`
+     *  route recognises this prefix and answers through the plugin queue. */
+    requestId?: string;
+    startedAt: number;
+    lastHookAt: number;
+}
+export interface HookOpenCodePayload {
+    sessionId?: string;
+    cwd?: string;
+    projectName?: string;
+    toolName?: string;
+    permissionId?: string;
+    title?: string;
+}
+export declare function openCodePermissionRequestId(sessionId: string, permissionId: string): string;
+export declare class HookOpenCodeSessions {
+    private readonly sessions;
+    /** Fired when a hook changed something worth broadcasting. */
+    onChanged: (() => void) | undefined;
+    note(event: string, payload: HookOpenCodePayload, now?: number): boolean;
+    snapshot(): HookOpenCodeSession[];
+    private clearPermission;
+    private reap;
+    /**
+     * Merge hook rows into the observed list. A hook row wins over a PID row
+     * for the same working directory: the scan cannot tell which TUI is which,
+     * while the hook row knows its session, its turn and its prompt.
+     */
+    applyTo(observed: ObservedSession[], now?: number): ObservedSession[];
+}
+//# sourceMappingURL=hook-opencode-sessions.d.ts.map

package/dist/hook-opencode-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-opencode-sessions.d.ts","sourceRoot":"","sources":["../src/hook-opencode-sessions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO7D,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,YAAY,GAAG,qBAAqB,CAAC;AAE9E,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,iBAAiB,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;6EACyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IAEnE,8DAA8D;IAC9D,SAAS,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAEpC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,GAAG,SAAa,GAAG,OAAO;IA+E5E,QAAQ,IAAI,mBAAmB,EAAE;IAIjC,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,IAAI;IAMZ;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,EAAE,GAAG,SAAa,GAAG,eAAe,EAAE;CA6C1E"}

package/dist/hook-opencode-sessions.js

@@ -0,0 +1,180 @@
+/**
+ * Hook-derived OpenCode session rows for the Node daemon.
+ *
+ * The passive process scan lists a standalone `opencode` TUI as
+ * `observed:opencode:<pid>` — alive, always `idle`, project from the process
+ * cwd — because it can see nothing else. The AgentDeck observer plugin
+ * (hooks/src/opencode-install.ts) POSTs `opencode_*` lifecycle hooks keyed by
+ * OpenCode's own session id, and those carry everything the scan cannot: the
+ * turn (prompt/stop), the running tool, and — the reason this module exists —
+ * `permission.asked`, which OpenCode emits only when it is GENUINELY waiting
+ * for the user. Until 2026-09-05 the Node daemon classified those hooks for
+ * the timeline/APME and dropped them for session state, so an OpenCode
+ * session blocked on a permission read `idle` on every surface while the
+ * Swift daemon (which builds `opencode:<id>` rows from the same hooks)
+ * showed PERM with an answerable requestId.
+ *
+ * Mirror of the Swift daemon's `opencode_*` cases in `DaemonServer.swift`,
+ * shaped like `HookCodexSessions`: rows come and go with the hooks, and the
+ * PID row for the same working directory yields to the hook row so one TUI is
+ * never two creatures.
+ */
+import { resolveProjectNameFromCwdCached } from './utils/project-name.js';
+/** A row with no hook at all for this long is gone (the plugin posts on every
+ *  turn edge and tool, so an attended session refreshes constantly). */
+const SILENT_TTL_MS = 30 * 60_000;
+const OPENING_EVENTS = new Set([
+    'opencode_session_start', 'opencode_user_prompt_submit', 'opencode_tool_start',
+    'opencode_permission_asked',
+]);
+export function openCodePermissionRequestId(sessionId, permissionId) {
+    return `ocperm:${sessionId}:${permissionId}`;
+}
+export class HookOpenCodeSessions {
+    sessions = new Map();
+    /** Fired when a hook changed something worth broadcasting. */
+    onChanged;
+    note(event, payload, now = Date.now()) {
+        const sessionId = payload.sessionId?.trim();
+        if (!sessionId || !event.startsWith('opencode_'))
+            return false;
+        if (event === 'opencode_session_end') {
+            const removed = this.sessions.delete(sessionId);
+            if (removed)
+                this.onChanged?.();
+            return removed;
+        }
+        const existing = this.sessions.get(sessionId);
+        if (!existing && !OPENING_EVENTS.has(event))
+            return false;
+        const session = existing ?? {
+            sessionId,
+            projectName: '',
+            state: 'idle',
+            startedAt: now,
+            lastHookAt: now,
+        };
+        const before = JSON.stringify(session);
+        session.lastHookAt = now;
+        if (!session.cwd && payload.cwd) {
+            session.cwd = payload.cwd;
+            session.projectName = resolveProjectNameFromCwdCached(payload.cwd);
+        }
+        if (!session.projectName && payload.projectName)
+            session.projectName = payload.projectName;
+        switch (event) {
+            case 'opencode_user_prompt_submit':
+                session.state = 'processing';
+                session.currentTool = undefined;
+                this.clearPermission(session);
+                break;
+            case 'opencode_tool_start':
+                session.state = 'processing';
+                session.currentTool = payload.toolName || undefined;
+                this.clearPermission(session);
+                break;
+            case 'opencode_tool_end':
+                session.state = 'processing';
+                session.currentTool = undefined;
+                this.clearPermission(session);
+                break;
+            case 'opencode_stop':
+                session.state = 'idle';
+                session.currentTool = undefined;
+                this.clearPermission(session);
+                break;
+            case 'opencode_permission_asked': {
+                // OpenCode fires this only when it is genuinely asking — a
+                // zero-false-positive gate signal, no prediction needed.
+                const permissionId = payload.permissionId?.trim();
+                if (permissionId) {
+                    const title = (payload.title ?? '').replace(/\s+/g, ' ').trim();
+                    session.state = 'awaiting_permission';
+                    session.question = (title || 'Permission requested').slice(0, 120);
+                    session.requestId = openCodePermissionRequestId(sessionId, permissionId);
+                }
+                break;
+            }
+            case 'opencode_permission_replied':
+                // Answered in the TUI or from a device — the tool now runs (or the
+                // turn ends); either way the wait is over.
+                if (session.state === 'awaiting_permission')
+                    session.state = 'processing';
+                this.clearPermission(session);
+                break;
+            default:
+                break;
+        }
+        this.sessions.set(sessionId, session);
+        this.reap(now);
+        const changed = JSON.stringify(session) !== before || !existing;
+        if (changed)
+            this.onChanged?.();
+        return changed;
+    }
+    snapshot() {
+        return [...this.sessions.values()];
+    }
+    clearPermission(session) {
+        session.question = undefined;
+        session.requestId = undefined;
+    }
+    reap(now) {
+        for (const [sessionId, session] of this.sessions) {
+            if (now - session.lastHookAt > SILENT_TTL_MS)
+                this.sessions.delete(sessionId);
+        }
+    }
+    /**
+     * Merge hook rows into the observed list. A hook row wins over a PID row
+     * for the same working directory: the scan cannot tell which TUI is which,
+     * while the hook row knows its session, its turn and its prompt.
+     */
+    applyTo(observed, now = Date.now()) {
+        this.reap(now);
+        if (this.sessions.size === 0)
+            return observed;
+        const hookRows = [...this.sessions.values()];
+        const hookCwds = new Set(hookRows.map((s) => s.cwd).filter((c) => Boolean(c)));
+        const seen = new Set();
+        const kept = [];
+        for (const session of observed) {
+            const match = /^observed:opencode:(.+)$/.exec(session.id);
+            if (!match?.[1]) {
+                kept.push(session);
+                continue;
+            }
+            if (this.sessions.has(match[1])) {
+                seen.add(match[1]);
+                kept.push(session);
+                continue;
+            }
+            // A PID-keyed scan row in a directory a hook row already covers.
+            const isPidRow = /^\d+$/.test(match[1]);
+            if (isPidRow && session.cwd && hookCwds.has(session.cwd))
+                continue;
+            kept.push(session);
+        }
+        for (const session of hookRows) {
+            if (seen.has(session.sessionId))
+                continue;
+            kept.push({
+                id: `observed:opencode:${session.sessionId}`,
+                port: 0,
+                pid: 0,
+                projectName: session.projectName || (session.cwd ? resolveProjectNameFromCwdCached(session.cwd) : 'OpenCode'),
+                agentType: 'opencode',
+                alive: true,
+                state: session.state,
+                controlMode: 'observed',
+                cwd: session.cwd,
+                startedAt: new Date(session.startedAt).toISOString(),
+                currentTask: session.currentTool,
+                ...(session.question ? { question: session.question } : {}),
+                ...(session.requestId ? { requestId: session.requestId } : {}),
+            });
+        }
+        return kept;
+    }
+}
+//# sourceMappingURL=hook-opencode-sessions.js.map

package/dist/hook-opencode-sessions.js.map

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

package/dist/hook-response-source.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Where a Stop hook's reply text comes from, decided per agent.
+ *
+ * Inline text wins wherever it exists — it is the hook's own statement of
+ * what the agent said. Otherwise each agent's OWN on-disk record is read by
+ * ITS reader: Claude's transcript JSONL by the Claude reader, Codex's rollout
+ * by the Codex reader. The old rule was "transcript_path ⇒ Claude reader",
+ * and a Codex hook carries a transcript_path too — its rollout — so every
+ * Codex turn read '' while `last_assistant_message` sat in the same payload.
+ * Measured 2026-09-03 over one week: 3 of 128 codex stop-turns held a
+ * response; the task judge scored the other tasks against silence.
+ *
+ * Pure so the decision table is testable without a daemon: the readers are
+ * injected, and only the one the agent owns is ever called.
+ */
+import type { CodexTurnOutcome } from './codex-rollout-response.js';
+export interface StopResponseReaders {
+    /** Claude transcript JSONL → last assistant text ('' when none). */
+    readClaudeTranscript: (transcriptPath: string) => string;
+    /** Codex rollout at a known path. */
+    readCodexRolloutPath: (rolloutPath: string) => CodexTurnOutcome;
+    /** Codex rollout located by session id (when the hook carried no path). */
+    readCodexRolloutById: (sessionId: string) => CodexTurnOutcome;
+}
+export interface StopResponseInput {
+    agentType: string;
+    sessionId: string;
+    /** Payload fields, in preference order, already reduced to the first
+     *  non-empty string (`last_assistant_message` / `response` / …). */
+    inlineResponse: string;
+    transcriptPath: string;
+}
+export interface StopResponse {
+    /** Raw reply text before display sanitising; '' when nothing was found. */
+    text: string;
+    /** Codex's recorded failure for the turn, when its rollout was read. */
+    rollout: CodexTurnOutcome;
+}
+export declare function resolveStopResponse(input: StopResponseInput, readers: StopResponseReaders): StopResponse;
+//# sourceMappingURL=hook-response-source.d.ts.map

package/dist/hook-response-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-response-source.d.ts","sourceRoot":"","sources":["../src/hook-response-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,oBAAoB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,MAAM,CAAC;IACzD,qCAAqC;IACrC,oBAAoB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,gBAAgB,CAAC;IAChE,2EAA2E;IAC3E,oBAAoB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,gBAAgB,CAAC;CAC/D;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB;wEACoE;IACpE,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAID,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAYxG"}

package/dist/hook-response-source.js

@@ -0,0 +1,31 @@
+/**
+ * Where a Stop hook's reply text comes from, decided per agent.
+ *
+ * Inline text wins wherever it exists — it is the hook's own statement of
+ * what the agent said. Otherwise each agent's OWN on-disk record is read by
+ * ITS reader: Claude's transcript JSONL by the Claude reader, Codex's rollout
+ * by the Codex reader. The old rule was "transcript_path ⇒ Claude reader",
+ * and a Codex hook carries a transcript_path too — its rollout — so every
+ * Codex turn read '' while `last_assistant_message` sat in the same payload.
+ * Measured 2026-09-03 over one week: 3 of 128 codex stop-turns held a
+ * response; the task judge scored the other tasks against silence.
+ *
+ * Pure so the decision table is testable without a daemon: the readers are
+ * injected, and only the one the agent owns is ever called.
+ */
+const NO_OUTCOME = { text: '' };
+export function resolveStopResponse(input, readers) {
+    if (input.inlineResponse)
+        return { text: input.inlineResponse, rollout: NO_OUTCOME };
+    if (input.agentType === 'codex-cli') {
+        const rollout = input.transcriptPath
+            ? readers.readCodexRolloutPath(input.transcriptPath)
+            : readers.readCodexRolloutById(input.sessionId);
+        return { text: rollout.text, rollout };
+    }
+    if (input.agentType === 'claude-code' && input.transcriptPath) {
+        return { text: readers.readClaudeTranscript(input.transcriptPath), rollout: NO_OUTCOME };
+    }
+    return { text: '', rollout: NO_OUTCOME };
+}
+//# sourceMappingURL=hook-response-source.js.map

package/dist/hook-response-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-response-source.js","sourceRoot":"","sources":["../src/hook-response-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA6BH,MAAM,UAAU,GAAqB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AAElD,MAAM,UAAU,mBAAmB,CAAC,KAAwB,EAAE,OAA4B;IACxF,IAAI,KAAK,CAAC,cAAc;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IACrF,IAAI,KAAK,CAAC,SAAS,KAAK,WAAW,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,KAAK,CAAC,cAAc;YAClC,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,cAAc,CAAC;YACpD,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAClD,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IACzC,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,aAAa,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAC3F,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AAC3C,CAAC"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4DH,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAUvE,OAAO,EAOL,KAAK,SAAS,EAQf,MAAM,YAAY,CAAC;AAwDpB,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,wEAAwE;IACxE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;kFAC8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;0EACsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;gEAC4D;IAC5D,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAID,wBAAsB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA6rCtE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4DH,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAUvE,OAAO,EAOL,KAAK,SAAS,EAQf,MAAM,YAAY,CAAC;AAwDpB,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,wEAAwE;IACxE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;kFAC8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;0EACsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;gEAC4D;IAC5D,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAID,wBAAsB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgsCtE"}

package/dist/index.js

@@ -452,13 +452,16 @@ export async function startSession(opts) {
     adapter.on('event', (evt) => {
         if (evt.source !== 'hook')
             return;
-        subagentTimeline.handle({
+        const result = subagentTimeline.handle({
             eventName: evt.event,
             payload: evt.data ?? {},
             sessionId: core.sessionId,
             agentType,
             projectName: core.projectName,
         });
+        if (result.sampleEvent) {
+            apme?.collector.noteSubagentLifecycle(core.sessionId, result.sampleEvent);
+        }
     });
     // Claude Code hook events → timeline entries
     if (agentType === 'claude-code') {