@agentdeck/bridge 0.2.2 → 1.0.0

package/dist/apme/adapters/claude-hook.js

@@ -29,6 +29,8 @@ export function claudeHookToSpans(ctx, event, data) {
     });
     if (event === 'UserPromptSubmit') {
         const prompt = extractPrompt(data);
+        if (isTaskNotificationPrompt(prompt))
+            return [];
         if (/^\s*\/clear\s*$/i.test(prompt)) {
             return [make('task_boundary', { 'agentdeck.boundary_signal': 'clear' })];
         }
@@ -82,4 +84,7 @@ function extractPrompt(data) {
         return fromMessage;
     return typeof data.prompt === 'string' ? data.prompt : '';
 }
+function isTaskNotificationPrompt(prompt) {
+    return prompt.trim().toLowerCase().startsWith('<task-notification>');
+}
 //# sourceMappingURL=claude-hook.js.map

package/dist/apme/adapters/claude-hook.js.map

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

package/dist/apme/adapters/codex-hook.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Codex CLI hook → TelemetrySpan adapter.
+ *
+ * Mirror of `claude-hook.ts:claudeHookToSpans` for the codex_* event family
+ * installed by `hooks/src/codex-install.ts`. Codex hook payloads use the
+ * same shape as Claude (stdin JSON forwarded as the POST body) — only the
+ * event name prefix differs — so the span shapes are kept aligned with the
+ * Claude adapter so downstream APME ingestion handles both transparently.
+ *
+ * Schema source: Codex CLI command-hook stdin JSON; canonical reference is
+ * apple/AgentDeck/Daemon/Server/DaemonServer.swift:handleHookEvent (codex
+ * branches) and the `~/.codex/config.toml` body assembled by
+ * hooks/src/codex-install.ts:managedBlockBody.
+ */
+import type { AdapterContext, TelemetrySpan } from '@agentdeck/shared';
+export declare function codexHookToSpans(ctx: AdapterContext, event: string, data: Record<string, unknown>): TelemetrySpan[];
+//# sourceMappingURL=codex-hook.d.ts.map

package/dist/apme/adapters/codex-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-hook.d.ts","sourceRoot":"","sources":["../../../src/apme/adapters/codex-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAG3B,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,aAAa,EAAE,CA8DjB"}

package/dist/apme/adapters/codex-hook.js

@@ -0,0 +1,95 @@
+/**
+ * Codex CLI hook → TelemetrySpan adapter.
+ *
+ * Mirror of `claude-hook.ts:claudeHookToSpans` for the codex_* event family
+ * installed by `hooks/src/codex-install.ts`. Codex hook payloads use the
+ * same shape as Claude (stdin JSON forwarded as the POST body) — only the
+ * event name prefix differs — so the span shapes are kept aligned with the
+ * Claude adapter so downstream APME ingestion handles both transparently.
+ *
+ * Schema source: Codex CLI command-hook stdin JSON; canonical reference is
+ * apple/AgentDeck/Daemon/Server/DaemonServer.swift:handleHookEvent (codex
+ * branches) and the `~/.codex/config.toml` body assembled by
+ * hooks/src/codex-install.ts:managedBlockBody.
+ */
+import { randomUUID } from 'crypto';
+import { spanNameForKind } from '@agentdeck/shared';
+export function codexHookToSpans(ctx, event, data) {
+    const ts = Date.now();
+    const baseAttrs = {
+        'agentdeck.agent_type': ctx.agentType,
+        ...(ctx.cwd ? { 'agentdeck.cwd': ctx.cwd } : {}),
+    };
+    const make = (kind, attributes) => ({
+        traceId: ctx.traceId,
+        spanId: randomUUID(),
+        parentSpanId: ctx.activeTurnId,
+        name: spanNameForKind(kind),
+        kind,
+        ts,
+        attributes: { ...baseAttrs, ...attributes },
+    });
+    if (event === 'codex_user_prompt_submit') {
+        const prompt = extractPrompt(data);
+        if (/^\s*\/clear\s*$/i.test(prompt)) {
+            return [make('task_boundary', { 'agentdeck.boundary_signal': 'clear' })];
+        }
+        return [
+            make('turn_start', {
+                'agentdeck.prompt_text': prompt,
+                'agentdeck.raw_payload': data,
+            }),
+        ];
+    }
+    if (event === 'codex_tool_start') {
+        const toolName = typeof data.tool_name === 'string' ? data.tool_name : undefined;
+        return [
+            make('tool_call', {
+                ...(toolName ? { 'gen_ai.tool.name': toolName, 'agentdeck.tool_name': toolName } : {}),
+                'agentdeck.raw_payload': data,
+            }),
+        ];
+    }
+    if (event === 'codex_tool_end') {
+        const toolName = typeof data.tool_name === 'string' ? data.tool_name : undefined;
+        return [
+            make('tool_result', {
+                ...(toolName ? { 'gen_ai.tool.name': toolName, 'agentdeck.tool_name': toolName } : {}),
+                'agentdeck.raw_payload': data,
+            }),
+        ];
+    }
+    // codex_session_start, codex_stop, codex_turn_complete, etc. are recorded
+    // verbatim so the collector still writes a `steps` row for timeline /
+    // tuner queries. State transitions (IDLE / PROCESSING) live in
+    // state-machine.ts:handleHookEvent — APME doesn't need its own.
+    return [
+        make('raw_step', {
+            'agentdeck.raw_event': event,
+            'agentdeck.raw_payload': data,
+        }),
+    ];
+}
+/** Codex hook payload uses Claude-compatible shapes when the upstream CLI
+ *  forwards them (the stdin JSON is whatever Codex's lifecycle hook layer
+ *  emits). Most variants nest the prompt under `message.content`; some
+ *  embed a top-level `prompt`. Returns `''` if neither shape is present. */
+function extractPrompt(data) {
+    const fromMessage = (() => {
+        const msg = data.message;
+        if (msg && typeof msg === 'object') {
+            const content = msg.content;
+            return typeof content === 'string' ? content : '';
+        }
+        return '';
+    })();
+    if (fromMessage)
+        return fromMessage;
+    if (typeof data.prompt === 'string')
+        return data.prompt;
+    // Codex sometimes sends `{ user_prompt: "..." }`; accept that shape too.
+    if (typeof data.user_prompt === 'string')
+        return data.user_prompt;
+    return '';
+}
+//# sourceMappingURL=codex-hook.js.map

package/dist/apme/adapters/codex-hook.js.map

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

package/dist/apme/adapters/codex-turn-manager.d.ts

@@ -0,0 +1,86 @@
+/**
+ * CodexTurnManager — turn-boundary reconstruction for Codex CLI sessions.
+ *
+ * Two signal sources are wired into one state machine:
+ *
+ * 1. **Hook mode** (primary) — `~/.codex/config.toml` lifecycle hooks send
+ *    `codex_user_prompt_submit` / `codex_tool_start` / `codex_tool_end` /
+ *    `codex_stop` to the daemon. These are unambiguous turn boundaries.
+ *    APME span ingestion for hooks happens in `bridge/src/index.ts`'s
+ *    hook branch via `codexHookToSpans` — this manager only adds the
+ *    timeline-visible entries (chat_start / tool_request / chat_response /
+ *    chat_end) so the dashboard sees them.
+ *
+ * 2. **PTY-parser fallback** (legacy / hook-miss path) — when no codex_*
+ *    hook has fired in the last 30 s, the manager falls back to the
+ *    pre-hook PTY-only logic: spinner_start opens a turn, prompt-source
+ *    idle (with deferred close + status-line false-positive guard +
+ *    tool-silence latch + PTY tail snapshot) closes it.
+ *
+ * The 30 s "hook-fresh" window demotes parser signals to no-ops while
+ * hooks are flowing, which eliminates the seven-state-variable race we
+ * landed seven Codex review iterations on. If hooks stop firing (Codex
+ * Ink-TUI repaint glitch), parser fallback re-engages automatically.
+ *
+ * Extracted from `bridge/src/index.ts wireAgentApme` so the codex segment
+ * can be unit-tested with fake collector / fake ringbuffer / fake adapter.
+ */
+import type { AgentType } from '@agentdeck/shared';
+import type { AdapterHookEvent, AdapterParserEvent } from '@agentdeck/shared';
+import type { BridgeCore } from '../../bridge-core.js';
+import type { ApmeModule } from '../index.js';
+import type { PtyRingBuffer } from '../../pty-ringbuffer.js';
+export declare class CodexTurnManager {
+    private readonly core;
+    private readonly apme;
+    private readonly ptyRingBuffer;
+    private readonly sessionId;
+    private readonly agentType;
+    private chatStart;
+    private lastPromptText;
+    private idleCloseTimer;
+    private inToolSilence;
+    private toolActiveSinceLastSpinner;
+    private toolSilenceTimer;
+    private pendingPromptIdle;
+    private pendingTailSnapshot;
+    private hookActive;
+    private lastHookTs;
+    constructor(core: BridgeCore, apme: ApmeModule, ptyRingBuffer: PtyRingBuffer, sessionId: string, agentType: AgentType);
+    /** Process a codex_* hook event. Hooks are authoritative — they own
+     *  the turn boundaries while fresh. APME span ingestion already happens
+     *  in `bridge/src/index.ts` via `codexHookToSpans`; this method only
+     *  adds the timeline-visible entries the dashboard renders. */
+    onHookEvent(evt: AdapterHookEvent): void;
+    /** Process a PTY parser event. While a hook is fresh, this is a no-op
+     *  for turn-boundary signals (hook owns them). Outside the freshness
+     *  window we run the legacy PTY-only state machine. */
+    onParserEvent(evt: AdapterParserEvent): void;
+    /** Clear timers so a session shutdown leaves no lingering work. */
+    cleanup(): void;
+    private hookFresh;
+    private makeCtx;
+    private addTimelineEntry;
+    /** Add a timeline entry AND feed it through APME ingestion. Use this
+     *  on the PTY-fallback path where no upstream hook adapter has done
+     *  the ingestion. */
+    private addEntryAndIngest;
+    /** Hook-path chat_start opener: timeline entry only. The APME turn
+     *  was opened upstream by codexHookToSpans → ingestSpan(turn_start)
+     *  in the index.ts hook branch. Re-ingesting here would close the
+     *  just-opened turn and immediately reopen another. */
+    private openTimelineChatStart;
+    /** PTY-path chat_start opener: timeline entry AND APME ingestion. */
+    private ensureChatStart;
+    /** Close the turn that started at `startedAt`: extract the response
+     *  tail (live ringbuffer or passed snapshot), emit chat_response +
+     *  chat_end timeline entries, and ingest the response span. The
+     *  snapshot path is used when closing in response to a delayed signal
+     *  (auto-clear timer or next spinner_start) — by that point the live
+     *  ringbuffer contains turn N+1 content that would contaminate N's
+     *  response. */
+    private closeTurn;
+    private scheduleClose;
+    private exitToolSilence;
+}
+//# sourceMappingURL=codex-turn-manager.d.ts.map

package/dist/apme/adapters/codex-turn-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-turn-manager.d.ts","sourceRoot":"","sources":["../../../src/apme/adapters/codex-turn-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAkB,SAAS,EAAiB,MAAM,mBAAmB,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAwB7D,qBAAa,gBAAgB;IAezB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAjB5B,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,0BAA0B,CAAS;IAC3C,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,mBAAmB,CAAuB;IAElD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAK;gBAGJ,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,UAAU,EAChB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS;IAKvC;;;mEAG+D;IAC/D,WAAW,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;IAiDxC;;2DAEuD;IACvD,aAAa,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI;IA2G5C,mEAAmE;IACnE,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,gBAAgB;IAIxB;;yBAEqB;IACrB,OAAO,CAAC,iBAAiB;IAQzB;;;2DAGuD;IACvD,OAAO,CAAC,qBAAqB;IAwC7B,qEAAqE;IACrE,OAAO,CAAC,eAAe;IAuCvB;;;;;;oBAMgB;IAChB,OAAO,CAAC,SAAS;IA2EjB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,eAAe;CAOxB"}