@agentdeck/bridge 0.2.1 → 0.2.3

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

@@ -0,0 +1,234 @@
+/**
+ * OpenClaw Gateway event → TelemetrySpan adapter.
+ *
+ * OpenClaw is a chat-style remote agent reached over a WebSocket Gateway
+ * (`shared/src/gateway-protocol.ts`). Unlike Claude Code (Stop hook +
+ * PostToolUse TodoWrite) and Codex CLI (hook system), OpenClaw never emits a
+ * structured "task complete" signal — it streams `chat.delta` chunks during
+ * generation and a single `chat.final` per assistant turn. With nothing
+ * stronger to anchor a task to, OpenClaw previously fell back to
+ * `session_end` only, collapsing every chat session to a single APME task
+ * and defeating per-task evaluation.
+ *
+ * # Boundary signal: idle_gap (90 s)
+ *
+ * The chosen boundary is **idle_gap**: after `chat.final`, if the user
+ * doesn't send a new `chat.send` within 90 seconds, treat the conversation
+ * as one closed task. Rationale, derived from inspecting the chat-final /
+ * chat-delta fixture set (`tests/parity/gateway-frames/`) and the four
+ * scenario classes that ship in the audit plan:
+ *
+ *   (a) Single Q/A         → 1 final, no follow-up → idle_gap fires once.
+ *   (b) Multi-turn collab  → user keeps replying within 90 s → 1 task
+ *                            (collaboration stays together).
+ *   (c) Long task w/ Qs    → same as (b), user clarifications keep the
+ *                            idle timer reset until the agent fully closes
+ *                            the topic.
+ *   (d) Abrupt new topic   → if the pivot happens within 90 s of the
+ *                            previous final, this v1 will lump both into
+ *                            one task. Acceptable v1 limitation —
+ *                            user-driven `manual` boundary or longer
+ *                            silence between topics splits them. A future
+ *                            topic-shift embedder is the obvious next step.
+ *
+ * 90 s is conservative: long enough that genuine multi-turn debugging
+ * stays together, short enough that a real "I'm done, walking away"
+ * gesture closes the task within a normal coffee break. The threshold is
+ * exposed as `OPENCLAW_IDLE_GAP_MS` so a downstream consumer can override
+ * for a hot-research session if needed.
+ *
+ * # Alternative boundaries considered (rejected for v1)
+ *
+ *   - `chat.final` per turn: too granular — every user/assistant turn pair
+ *     would be its own task. Defeats the "what did the agent accomplish"
+ *     framing — evaluation should span the work, not the words.
+ *   - Embedding-based topic shift: cost-heavy + cold-start fragile. Not v1.
+ *   - Gateway `taskCompleted` event: no such event in `GatewayEventPayload`
+ *     union. Adding it requires the OpenClaw server to emit it, which the
+ *     bridge can't unilaterally do.
+ *
+ * # Wiring
+ *
+ * `bridge/src/adapters/openclaw.ts` calls `openclawChatEventToSpans(ctx,
+ * payload)` from its `chat` event branch and forwards the resulting spans
+ * to `apme.collector.ingestSpan`. The idle timer is owned by the OpenClaw
+ * adapter (not this module) because it needs access to the active session
+ * id and an actual `setTimeout`. This module is pure — given a payload it
+ * returns the spans the adapter should currently emit, no side effects.
+ */
+import { randomUUID } from 'crypto';
+import { spanNameForKind } from '@agentdeck/shared';
+/** Default idle-gap threshold after `chat.final` before we close the task. */
+export const OPENCLAW_IDLE_GAP_MS = 90_000;
+/**
+ * Convert a Gateway `chat` event payload into the spans the APME collector
+ * should ingest right now. Does NOT emit the idle-gap `task_boundary` —
+ * that's owned by the adapter's timer (it needs setTimeout + per-session
+ * state). Callers should also fire `emitIdleGapTaskBoundary(...)` when the
+ * idle timer expires.
+ */
+export function openclawChatEventToSpans(ctx, payload) {
+    const ts = Date.now();
+    const baseAttrs = {
+        'agentdeck.agent_type': ctx.agentType,
+        ...(ctx.cwd ? { 'agentdeck.cwd': ctx.cwd } : {}),
+        ...(payload.runId ? { 'agentdeck.run_id': payload.runId } : {}),
+        ...(payload.sessionKey ? { 'agentdeck.gateway_session_key': payload.sessionKey } : {}),
+    };
+    const make = (kind, attributes = {}) => ({
+        traceId: ctx.traceId,
+        spanId: randomUUID(),
+        parentSpanId: ctx.activeTurnId,
+        name: spanNameForKind(kind),
+        kind,
+        ts,
+        attributes: { ...baseAttrs, ...attributes },
+    });
+    if (payload.state === 'delta') {
+        // Deltas are streaming chunks — only the first delta of a new turn is
+        // load-bearing for APME (opens the turn). The OpenClaw adapter detects
+        // "first delta" via `chatStarted` and is responsible for emitting the
+        // turn_start when calling us. We don't emit on every delta — that
+        // would balloon the steps table and add no eval signal.
+        return [];
+    }
+    if (payload.state === 'final') {
+        const spans = [];
+        if (payload.response) {
+            spans.push(make('turn_response', { 'agentdeck.response_text': payload.response }));
+        }
+        if (Array.isArray(payload.tools)) {
+            for (const t of payload.tools) {
+                if (!t.name)
+                    continue;
+                spans.push(make('tool_result', {
+                    'gen_ai.tool.name': t.name,
+                    'agentdeck.tool_name': t.name,
+                    ...(t.status ? { 'agentdeck.tool_status': t.status } : {}),
+                }));
+            }
+        }
+        return spans;
+    }
+    if (payload.state === 'aborted') {
+        // Treat as a manual boundary — user explicitly stopped this turn. The
+        // composite outcome derivation will see the absence of a complete
+        // response and score accordingly.
+        return [make('task_boundary', { 'agentdeck.boundary_signal': 'manual' })];
+    }
+    if (payload.state === 'error') {
+        // Error doesn't close the task — agent might retry on the same prompt.
+        // The error is recorded for context but the idle timer continues to
+        // run. Returning empty array lets the adapter keep its lifecycle state.
+        return [];
+    }
+    return [];
+}
+/**
+ * Convert a Gateway `session.tool` event into spans. This granular per-tool
+ * stream carries the tool INPUT/OUTPUT that the coarse `chat.final` tools array
+ * lacks — and it was previously silently dropped (openclaw.ts default case), so
+ * the sample's tool trajectory had no detail. A `running`/`pending` status maps
+ * to a `tool_call` (opens a pending ToolEvent); a terminal status maps to a
+ * `tool_result` (resolves it). Pure — no side effects.
+ */
+export function openclawSessionToolToSpans(ctx, payload) {
+    const name = payload.name ?? payload.tool;
+    if (!name)
+        return [];
+    const ts = typeof payload.ts === 'number' ? payload.ts : Date.now();
+    const status = (payload.status ?? '').toLowerCase();
+    const pending = status === '' || status === 'running' || status === 'pending' || status === 'started' || status === 'in_progress';
+    const kind = pending ? 'tool_call' : 'tool_result';
+    const attrs = {
+        'agentdeck.agent_type': ctx.agentType,
+        ...(ctx.cwd ? { 'agentdeck.cwd': ctx.cwd } : {}),
+        'gen_ai.tool.name': name,
+        'agentdeck.tool_name': name,
+        'agentdeck.raw_payload': {
+            ...(payload.status ? { status: payload.status } : {}),
+            ...(payload.input !== undefined ? { tool_input: payload.input } : {}),
+            ...(payload.output !== undefined ? { tool_response: payload.output } : {}),
+        },
+    };
+    return [{
+            traceId: ctx.traceId,
+            spanId: randomUUID(),
+            parentSpanId: ctx.activeTurnId,
+            name: spanNameForKind(kind),
+            kind,
+            ts,
+            attributes: attrs,
+        }];
+}
+/**
+ * Convert a Gateway `session.out-of-band message` into a turn span. User
+ * messages open a turn (turn_start); assistant messages set the response
+ * (turn_response). Previously dropped, so gateway-initiated turns (cron,
+ * automations) had no captured prompt/response in the sample.
+ */
+export function openclawSessionMessageToSpans(ctx, payload) {
+    const text = (typeof payload.text === 'string' ? payload.text : undefined)
+        ?? (typeof payload.content === 'string' ? payload.content : undefined);
+    if (!text || !text.trim())
+        return [];
+    const ts = typeof payload.ts === 'number' ? payload.ts : Date.now();
+    const role = (payload.role ?? '').toLowerCase();
+    const kind = role === 'assistant' ? 'turn_response' : 'turn_start';
+    const attrs = {
+        'agentdeck.agent_type': ctx.agentType,
+        ...(ctx.cwd ? { 'agentdeck.cwd': ctx.cwd } : {}),
+        ...(kind === 'turn_start' ? { 'agentdeck.prompt_text': text } : { 'agentdeck.response_text': text }),
+    };
+    return [{
+            traceId: ctx.traceId,
+            spanId: randomUUID(),
+            parentSpanId: ctx.activeTurnId,
+            name: spanNameForKind(kind),
+            kind,
+            ts,
+            attributes: attrs,
+        }];
+}
+/**
+ * Build the spans the adapter should emit when its idle-gap timer expires.
+ * Returned as a function (not a constant) because the timestamp is "now"
+ * at expiry, not "now" at adapter construction.
+ */
+export function openclawIdleGapTaskBoundary(ctx) {
+    return {
+        traceId: ctx.traceId,
+        spanId: randomUUID(),
+        parentSpanId: ctx.activeTurnId,
+        name: spanNameForKind('task_boundary'),
+        kind: 'task_boundary',
+        ts: Date.now(),
+        attributes: {
+            'agentdeck.agent_type': ctx.agentType,
+            ...(ctx.cwd ? { 'agentdeck.cwd': ctx.cwd } : {}),
+            'agentdeck.boundary_signal': 'idle_gap',
+        },
+    };
+}
+/**
+ * Build the user-prompt span the adapter should emit on `chat.send`. Kept
+ * here for symmetry with `claude-hook.ts::claudeHookToSpans` and so future
+ * test fixtures can exercise the boundary detector without spinning a real
+ * Gateway connection.
+ */
+export function openclawChatSendToSpan(ctx, prompt) {
+    return {
+        traceId: ctx.traceId,
+        spanId: randomUUID(),
+        parentSpanId: undefined,
+        name: spanNameForKind('turn_start'),
+        kind: 'turn_start',
+        ts: Date.now(),
+        attributes: {
+            'agentdeck.agent_type': ctx.agentType,
+            ...(ctx.cwd ? { 'agentdeck.cwd': ctx.cwd } : {}),
+            'agentdeck.prompt_text': prompt,
+        },
+    };
+}
+//# sourceMappingURL=openclaw-hook.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-hook.js","sourceRoot":"","sources":["../../../src/apme/adapters/openclaw-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AASpC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,GAAmB,EACnB,OAAyB;IAEzB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,MAAM,SAAS,GAAwB;QACrC,sBAAsB,EAAE,GAAG,CAAC,SAAS;QACrC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,+BAA+B,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvF,CAAC;IACF,MAAM,IAAI,GAAG,CACX,IAA2B,EAC3B,aAAkC,EAAE,EACrB,EAAE,CAAC,CAAC;QACnB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,UAAU,EAAE;QACpB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;QAC3B,IAAI;QACJ,EAAE;QACF,UAAU,EAAE,EAAE,GAAG,SAAS,EAAE,GAAG,UAAU,EAAE;KAC5C,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;QAC9B,sEAAsE;QACtE,uEAAuE;QACvE,sEAAsE;QACtE,kEAAkE;QAClE,wDAAwD;QACxD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAoB,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,yBAAyB,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAC9B,IAAI,CAAC,CAAC,CAAC,IAAI;oBAAE,SAAS;gBACtB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE;oBAC7B,kBAAkB,EAAE,CAAC,CAAC,IAAI;oBAC1B,qBAAqB,EAAE,CAAC,CAAC,IAAI;oBAC7B,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,uBAAuB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC3D,CAAC,CAAC,CAAC;YACN,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,sEAAsE;QACtE,kEAAkE;QAClE,kCAAkC;QAClC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,2BAA2B,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;QAC9B,uEAAuE;QACvE,oEAAoE;QACpE,wEAAwE;QACxE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CACxC,GAAmB,EACnB,OAA2B;IAE3B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,EAAE,GAAG,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACpE,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACpD,MAAM,OAAO,GAAG,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,aAAa,CAAC;IAClI,MAAM,IAAI,GAA0B,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC;IAC1E,MAAM,KAAK,GAAwB;QACjC,sBAAsB,EAAE,GAAG,CAAC,SAAS;QACrC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,kBAAkB,EAAE,IAAI;QACxB,qBAAqB,EAAE,IAAI;QAC3B,uBAAuB,EAAE;YACvB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3E;KACF,CAAC;IACF,OAAO,CAAC;YACN,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,MAAM,EAAE,UAAU,EAAE;YACpB,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;YAC3B,IAAI;YACJ,EAAE;YACF,UAAU,EAAE,KAAK;SAClB,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAC3C,GAAmB,EACnB,OAA8B;IAE9B,MAAM,IAAI,GAAG,CAAC,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;WACrE,CAAC,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACzE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,EAAE,GAAG,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACpE,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,MAAM,IAAI,GAA0B,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC;IAC1F,MAAM,KAAK,GAAwB;QACjC,sBAAsB,EAAE,GAAG,CAAC,SAAS;QACrC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,yBAAyB,EAAE,IAAI,EAAE,CAAC;KACrG,CAAC;IACF,OAAO,CAAC;YACN,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,MAAM,EAAE,UAAU,EAAE;YACpB,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;YAC3B,IAAI;YACJ,EAAE;YACF,UAAU,EAAE,KAAK;SAClB,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,GAAmB;IAC7D,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,UAAU,EAAE;QACpB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,IAAI,EAAE,eAAe,CAAC,eAAe,CAAC;QACtC,IAAI,EAAE,eAAe;QACrB,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;QACd,UAAU,EAAE;YACV,sBAAsB,EAAE,GAAG,CAAC,SAAS;YACrC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,2BAA2B,EAAE,UAAU;SACxC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAmB,EACnB,MAAc;IAEd,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,UAAU,EAAE;QACpB,YAAY,EAAE,SAAS;QACvB,IAAI,EAAE,eAAe,CAAC,YAAY,CAAC;QACnC,IAAI,EAAE,YAAY;QAClB,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;QACd,UAAU,EAAE;YACV,sBAAsB,EAAE,GAAG,CAAC,SAAS;YACrC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,uBAAuB,EAAE,MAAM;SAChC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,56 @@
+/**
+ * OpenCode SSE → TelemetrySpan adapter.
+ *
+ * OpenCode (https://github.com/sst/opencode) is the third coding agent
+ * AgentDeck monitors. Unlike Claude Code and Codex CLI, it has no command-
+ * level hook layer — its lifecycle is observed via the SSE stream emitted by
+ * `opencode serve` on its HTTP port. The OpenCode adapter
+ * (`bridge/src/adapters/opencode-adapter.ts`) subscribes to that stream and
+ * forwards `OpenCodeSSEEvent` payloads into the bridge.
+ *
+ * This helper takes those SSE payloads and produces the same `TelemetrySpan`
+ * shape that `claude-hook.ts` and `codex-hook.ts` emit, so the existing
+ * `ApmeCollector.ingestSpan` pipeline handles all three agents uniformly.
+ * Without this, OpenCode runs never reach APME — they fall back to
+ * `session_end`-only task boundaries (one task per session, defeating
+ * per-task evaluation).
+ *
+ * Detected boundary signals (priority order):
+ *   1. `todo_complete` — `message.part.updated` carrying a tool part whose
+ *      tool name is "todowrite" and whose `state.output` reports every todo
+ *      with `status === 'completed'`. OpenCode's todowrite tool is the
+ *      analogue of Claude's TodoWrite + Codex's todo manager.
+ *   2. `idle_gap` — the adapter arms a timer on `session.idle` and fires
+ *      `opencodeIdleGapTaskBoundary` after OPENCODE_IDLE_GAP_MS with no new
+ *      work (mirrors the OpenClaw idle-gap segmentation). Without it,
+ *      OpenCode tasks close only on `session_end` — one task per session,
+ *      defeating per-task evaluation.
+ *   3. (`/clear` and `manual` are reserved for future direct integrations —
+ *      OpenCode doesn't currently surface either via SSE.)
+ *
+ * Tool calls and tool results map to `tool_call` / `tool_result` spans for
+ * step-level parity with Claude / Codex (drives the timeline and the
+ * deterministic Layer 1 efficiency metrics).
+ */
+import type { AdapterContext, TelemetrySpan } from '@agentdeck/shared';
+import type { OpenCodeMessagePart, OpenCodeMessageInfo } from '../../opencode-client.js';
+/**
+ * Convert a single OpenCode SSE `message.part.updated` payload into spans.
+ *
+ * Returns an empty array when the part isn't APME-relevant (text / step-finish
+ * are accumulated elsewhere). Caller is expected to drop empty arrays.
+ */
+export declare function opencodePartToSpans(ctx: AdapterContext, part: OpenCodeMessagePart): TelemetrySpan[];
+/**
+ * Spans for a `message.updated` SSE payload. OpenCode emits these on both
+ * user prompts (open a turn) and assistant turn-end signals (close it).
+ */
+export declare function opencodeMessageToSpans(ctx: AdapterContext, info: OpenCodeMessageInfo, promptText: string | undefined, responseText: string | undefined): TelemetrySpan[];
+/** How long a session must sit idle (no new work after `session.idle`)
+ *  before the active task closes with an `idle_gap` boundary. Matches
+ *  OPENCLAW_IDLE_GAP_MS — the two adapters segment on the same rhythm. */
+export declare const OPENCODE_IDLE_GAP_MS = 90000;
+/** Build the `task_boundary` (idle_gap) span the adapter emits when the
+ *  idle-gap timer fires. Mirrors `openclawIdleGapTaskBoundary`. */
+export declare function opencodeIdleGapTaskBoundary(ctx: AdapterContext): TelemetrySpan;
+//# sourceMappingURL=opencode-hook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-hook.d.ts","sourceRoot":"","sources":["../../../src/apme/adapters/opencode-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEzF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,mBAAmB,GACxB,aAAa,EAAE,CAuCjB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,mBAAmB,EACzB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,aAAa,EAAE,CAoCjB;AAED;;0EAE0E;AAC1E,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAE3C;mEACmE;AACnE,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,cAAc,GAAG,aAAa,CAc9E"}

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

@@ -0,0 +1,182 @@
+/**
+ * OpenCode SSE → TelemetrySpan adapter.
+ *
+ * OpenCode (https://github.com/sst/opencode) is the third coding agent
+ * AgentDeck monitors. Unlike Claude Code and Codex CLI, it has no command-
+ * level hook layer — its lifecycle is observed via the SSE stream emitted by
+ * `opencode serve` on its HTTP port. The OpenCode adapter
+ * (`bridge/src/adapters/opencode-adapter.ts`) subscribes to that stream and
+ * forwards `OpenCodeSSEEvent` payloads into the bridge.
+ *
+ * This helper takes those SSE payloads and produces the same `TelemetrySpan`
+ * shape that `claude-hook.ts` and `codex-hook.ts` emit, so the existing
+ * `ApmeCollector.ingestSpan` pipeline handles all three agents uniformly.
+ * Without this, OpenCode runs never reach APME — they fall back to
+ * `session_end`-only task boundaries (one task per session, defeating
+ * per-task evaluation).
+ *
+ * Detected boundary signals (priority order):
+ *   1. `todo_complete` — `message.part.updated` carrying a tool part whose
+ *      tool name is "todowrite" and whose `state.output` reports every todo
+ *      with `status === 'completed'`. OpenCode's todowrite tool is the
+ *      analogue of Claude's TodoWrite + Codex's todo manager.
+ *   2. `idle_gap` — the adapter arms a timer on `session.idle` and fires
+ *      `opencodeIdleGapTaskBoundary` after OPENCODE_IDLE_GAP_MS with no new
+ *      work (mirrors the OpenClaw idle-gap segmentation). Without it,
+ *      OpenCode tasks close only on `session_end` — one task per session,
+ *      defeating per-task evaluation.
+ *   3. (`/clear` and `manual` are reserved for future direct integrations —
+ *      OpenCode doesn't currently surface either via SSE.)
+ *
+ * Tool calls and tool results map to `tool_call` / `tool_result` spans for
+ * step-level parity with Claude / Codex (drives the timeline and the
+ * deterministic Layer 1 efficiency metrics).
+ */
+import { randomUUID } from 'crypto';
+import { spanNameForKind } from '@agentdeck/shared';
+/**
+ * Convert a single OpenCode SSE `message.part.updated` payload into spans.
+ *
+ * Returns an empty array when the part isn't APME-relevant (text / step-finish
+ * are accumulated elsewhere). Caller is expected to drop empty arrays.
+ */
+export function opencodePartToSpans(ctx, part) {
+    if (part.type !== 'tool')
+        return [];
+    const ts = Date.now();
+    const toolName = (part.tool ?? 'unknown').toLowerCase();
+    const status = part.state?.status ?? 'running';
+    const baseAttrs = {
+        'agentdeck.agent_type': ctx.agentType,
+        ...(ctx.cwd ? { 'agentdeck.cwd': ctx.cwd } : {}),
+        'gen_ai.tool.name': toolName,
+        'agentdeck.tool_name': toolName,
+        'agentdeck.raw_payload': part,
+    };
+    const make = (kind, attributes = {}) => ({
+        traceId: ctx.traceId,
+        spanId: randomUUID(),
+        parentSpanId: ctx.activeTurnId,
+        name: spanNameForKind(kind),
+        kind,
+        ts,
+        attributes: { ...baseAttrs, ...attributes },
+    });
+    const spans = [];
+    if (status === 'completed') {
+        spans.push(make('tool_result'));
+        // todowrite completion with every item marked 'completed' is the agent
+        // declaring the task done — same semantics as Claude's TodoWrite
+        // PostToolUse boundary check in `collector.ts::ingestHook`.
+        if (toolName === 'todowrite' && allTodosCompleted(part)) {
+            spans.push(make('task_boundary', { 'agentdeck.boundary_signal': 'todo_complete' }));
+        }
+    }
+    else {
+        spans.push(make('tool_call'));
+    }
+    return spans;
+}
+/**
+ * Spans for a `message.updated` SSE payload. OpenCode emits these on both
+ * user prompts (open a turn) and assistant turn-end signals (close it).
+ */
+export function opencodeMessageToSpans(ctx, info, promptText, responseText) {
+    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 },
+    });
+    const spans = [];
+    // Attribute the model as soon as an assistant message reveals it. OpenCode's
+    // SSE `message.updated` carries modelID/providerID, but that only ever
+    // reached the display StateMachine — the APME span pipeline never emitted a
+    // session_meta span, so every opencode run persisted model_id=NULL. Emitting
+    // it here routes through collector.ts (gen_ai.request.model -> updateModel),
+    // which writes directly to the bound APME session (no StateMachine reliance).
+    if (info.role === 'assistant' && info.modelID) {
+        const model = info.providerID ? `${info.providerID}/${info.modelID}` : info.modelID;
+        spans.push(make('session_meta', { 'gen_ai.request.model': model }));
+    }
+    if (info.role === 'user' && promptText) {
+        spans.push(make('turn_start', { 'agentdeck.prompt_text': promptText }));
+    }
+    else if (info.role === 'assistant' && responseText) {
+        spans.push(make('turn_response', { 'agentdeck.response_text': responseText }));
+    }
+    return spans;
+}
+/** How long a session must sit idle (no new work after `session.idle`)
+ *  before the active task closes with an `idle_gap` boundary. Matches
+ *  OPENCLAW_IDLE_GAP_MS — the two adapters segment on the same rhythm. */
+export const OPENCODE_IDLE_GAP_MS = 90_000;
+/** Build the `task_boundary` (idle_gap) span the adapter emits when the
+ *  idle-gap timer fires. Mirrors `openclawIdleGapTaskBoundary`. */
+export function opencodeIdleGapTaskBoundary(ctx) {
+    return {
+        traceId: ctx.traceId,
+        spanId: randomUUID(),
+        parentSpanId: ctx.activeTurnId,
+        name: spanNameForKind('task_boundary'),
+        kind: 'task_boundary',
+        ts: Date.now(),
+        attributes: {
+            'agentdeck.agent_type': ctx.agentType,
+            ...(ctx.cwd ? { 'agentdeck.cwd': ctx.cwd } : {}),
+            'agentdeck.boundary_signal': 'idle_gap',
+        },
+    };
+}
+/**
+ * Read the todos array out of an OpenCode todowrite tool part. OpenCode's
+ * todowrite stores its state under `part.state.output` as a JSON string of
+ * `{ todos: [{ status, ... }] }` (the same shape Claude Code's TodoWrite
+ * uses). Returns true when every entry is `completed`. Empty list returns
+ * false — we shouldn't treat "no todos" as task completion.
+ */
+function allTodosCompleted(part) {
+    // Try input first (some OpenCode versions echo the final todos list there).
+    const inputTodos = readTodosFromUnknown(part.state?.input);
+    if (inputTodos && inputTodos.length > 0 && inputTodos.every((t) => t.status === 'completed')) {
+        return true;
+    }
+    // Output is usually a JSON-encoded string.
+    const output = part.state?.output;
+    if (typeof output === 'string') {
+        try {
+            const parsed = JSON.parse(output);
+            const todos = readTodosFromUnknown(parsed);
+            if (todos && todos.length > 0) {
+                return todos.every((t) => t.status === 'completed');
+            }
+        }
+        catch {
+            // ignore malformed output — treat as not-all-completed
+        }
+    }
+    return false;
+}
+function readTodosFromUnknown(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    const obj = value;
+    const candidates = [obj.todos, obj.tool_input?.todos];
+    for (const c of candidates) {
+        if (Array.isArray(c)) {
+            return c
+                .filter((it) => !!it && typeof it === 'object')
+                .map((it) => ({ status: String(it.status ?? '') }));
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=opencode-hook.js.map

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

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

package/dist/apme/adapters/timeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../../src/apme/adapters/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEb,aAAa,EACd,MAAM,mBAAmB,CAAC;AAG3B,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,aAAa,GACnB,aAAa,EAAE,CAmDjB"}
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../../src/apme/adapters/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEb,aAAa,EACd,MAAM,mBAAmB,CAAC;AAG3B,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,aAAa,GACnB,aAAa,EAAE,CAwDjB"}

package/dist/apme/adapters/timeline.js

@@ -48,7 +48,12 @@ export function timelineEntryToSpans(ctx, entry) {
                     'agentdeck.fallback_to_last_closed': true,
                 })];
         }
-        case 'tool_request': {
+        // tool_request: Claude PreToolUse hook + Codex parser tool_action (after
+        // 2025-05 alignment) emit this. tool_exec: legacy OpenClaw parseLogLine
+        // and pre-alignment Codex emits — treated identically so APME counts
+        // every tool invocation regardless of source.
+        case 'tool_request':
+        case 'tool_exec': {
             // Some sources pack the tool name as the first whitespace-delimited token
             // in `raw`; when missing, the collector falls back to the literal 'tool'.
             const toolName = entry.raw?.split(' ')[0] ?? 'tool';

package/dist/apme/adapters/timeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../../src/apme/adapters/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAOpC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,UAAU,oBAAoB,CAClC,GAAmB,EACnB,KAAoB;IAEpB,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IAClC,MAAM,SAAS,GAAwB;QACrC,sBAAsB,EAAE,GAAG,CAAC,SAAS;QACrC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjD,CAAC;IACF,MAAM,IAAI,GAAG,CACX,IAA2B,EAC3B,UAA+B,EAChB,EAAE,CAAC,CAAC;QACnB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,UAAU,EAAE;QACpB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;QAC3B,IAAI;QACJ,EAAE;QACF,UAAU,EAAE,EAAE,GAAG,SAAS,EAAE,GAAG,UAAU,EAAE;KAC5C,CAAC,CAAC;IAEH,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,uBAAuB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;YACjD,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC;gBAAE,OAAO,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,yBAAyB,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC1E,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;YACpC,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC;gBAAE,OAAO,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE;oBAC5B,yBAAyB,EAAE,QAAQ;oBACnC,mCAAmC,EAAE,IAAI;iBAC1C,CAAC,CAAC,CAAC;QACN,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,0EAA0E;YAC1E,0EAA0E;YAC1E,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE;oBACxB,kBAAkB,EAAE,QAAQ;oBAC5B,qBAAqB,EAAE,QAAQ;iBAChC,CAAC,CAAC,CAAC;QACN,CAAC;QACD,KAAK,eAAe;YAClB,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC;QACnC;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../../src/apme/adapters/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAOpC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,UAAU,oBAAoB,CAClC,GAAmB,EACnB,KAAoB;IAEpB,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IAClC,MAAM,SAAS,GAAwB;QACrC,sBAAsB,EAAE,GAAG,CAAC,SAAS;QACrC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjD,CAAC;IACF,MAAM,IAAI,GAAG,CACX,IAA2B,EAC3B,UAA+B,EAChB,EAAE,CAAC,CAAC;QACnB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,UAAU,EAAE;QACpB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;QAC3B,IAAI;QACJ,EAAE;QACF,UAAU,EAAE,EAAE,GAAG,SAAS,EAAE,GAAG,UAAU,EAAE;KAC5C,CAAC,CAAC;IAEH,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,uBAAuB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;YACjD,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC;gBAAE,OAAO,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,yBAAyB,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC1E,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;YACpC,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC;gBAAE,OAAO,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE;oBAC5B,yBAAyB,EAAE,QAAQ;oBACnC,mCAAmC,EAAE,IAAI;iBAC1C,CAAC,CAAC,CAAC;QACN,CAAC;QACD,yEAAyE;QACzE,wEAAwE;QACxE,qEAAqE;QACrE,8CAA8C;QAC9C,KAAK,cAAc,CAAC;QACpB,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,0EAA0E;YAC1E,0EAA0E;YAC1E,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE;oBACxB,kBAAkB,EAAE,QAAQ;oBAC5B,qBAAqB,EAAE,QAAQ;iBAChC,CAAC,CAAC,CAAC;QACN,CAAC;QACD,KAAK,eAAe;YAClB,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC;QACnC;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/apme/antigravity-transcript.d.ts

@@ -0,0 +1,18 @@
+export interface AntigravityTranscriptSummary {
+    goal?: string;
+    state: 'idle' | 'processing';
+    currentTask?: string;
+    /** Human model label from the transcript's last USER_SETTINGS_CHANGE, if any
+     *  (e.g. "GPT-OSS 120B (Medium)", "Gemini 3.5 Flash (Medium)"). */
+    model?: string;
+}
+export declare function antigravityRoot(): string;
+/** Parse an agy transcript sample into goal / state / currentTask / model. */
+export declare function parseAntigravityTranscript(raw: string): AntigravityTranscriptSummary;
+/** Global default model from settings.json (fallback when a conversation never
+ *  recorded an explicit model selection). */
+export declare function antigravityDefaultModel(): string | undefined;
+/** Resolve the conversationId for a workspace cwd via the last-opened cache. */
+export declare function antigravityConversationId(cwd: string | undefined): string | undefined;
+export declare function antigravityTranscriptPath(conversationId: string): string;
+//# sourceMappingURL=antigravity-transcript.d.ts.map

package/dist/apme/antigravity-transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"antigravity-transcript.d.ts","sourceRoot":"","sources":["../../src/apme/antigravity-transcript.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,4BAA4B;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;uEACmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAgBD,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,8EAA8E;AAC9E,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,4BAA4B,CA8BpF;AAMD;6CAC6C;AAC7C,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,SAAS,CAK5D;AAED,gFAAgF;AAChF,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAQrF;AAED,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAExE"}

package/dist/apme/antigravity-transcript.js

@@ -0,0 +1,94 @@
+/**
+ * Antigravity (`agy` CLI) transcript parsing.
+ *
+ * The agy CLI persists each conversation as a plain JSONL transcript at
+ *   ~/.gemini/antigravity-cli/brain/<conversationId>/.system_generated/logs/transcript.jsonl
+ * one JSON object per step:
+ *   { step_index, source, type, status, created_at, content?, thinking?, tool_calls? }
+ *
+ * Unlike Claude/Codex, the model id is NOT on each record. It surfaces in the
+ * first USER_INPUT's `<USER_SETTINGS_CHANGE>` tag ("...from None to <MODEL>.")
+ * when a model is selected for the conversation; otherwise the global default
+ * in `settings.json` applies. The session log carries a live override line too,
+ * but the per-conversation transcript is the cleanest attribution source.
+ *
+ * These pure functions are shared by the passive observer (creature + model
+ * display) and the APME ingester (run/turn model attribution) so agy gets the
+ * same scorecard treatment as the other agents.
+ */
+import { readFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+/** Step types that represent the agent doing tool work (drives currentTask). */
+const TOOL_TYPES = new Set([
+    'VIEW_FILE', 'RUN_COMMAND', 'GREP_SEARCH', 'LIST_DIRECTORY', 'CODE_ACTION', 'EDIT_FILE',
+]);
+export function antigravityRoot() {
+    return join(homedir(), '.gemini', 'antigravity-cli');
+}
+/** Parse an agy transcript sample into goal / state / currentTask / model. */
+export function parseAntigravityTranscript(raw) {
+    const records = [];
+    for (const line of raw.split('\n')) {
+        if (!line.trim())
+            continue;
+        try {
+            records.push(JSON.parse(line));
+        }
+        catch { /* skip malformed line */ }
+    }
+    let goal;
+    let model;
+    let currentTask;
+    let processing = false;
+    for (const rec of records) {
+        if (rec.type === 'USER_INPUT' && typeof rec.content === 'string') {
+            if (!goal) {
+                const req = rec.content.match(/<USER_REQUEST>\s*([\s\S]*?)\s*<\/USER_REQUEST>/);
+                if (req && req[1].trim())
+                    goal = cleanGoal(req[1]);
+            }
+            // "The user changed setting `Model Selection` from None to GPT-OSS 120B (Medium)."
+            // Take the latest one seen → the model active for this conversation.
+            const change = rec.content.match(/Model Selection`?\s+from\s+.*?\s+to\s+(.+?)\.(?:\s|$)/);
+            if (change && change[1].trim())
+                model = change[1].trim();
+        }
+        if (rec.status === 'RUNNING')
+            processing = true;
+        if (rec.type && TOOL_TYPES.has(rec.type)) {
+            currentTask = rec.tool_calls?.[0]?.name ?? rec.type.toLowerCase();
+        }
+    }
+    return { goal, model, currentTask, state: processing ? 'processing' : 'idle' };
+}
+function cleanGoal(s) {
+    return s.replace(/\s+/g, ' ').trim().slice(0, 200);
+}
+/** Global default model from settings.json (fallback when a conversation never
+ *  recorded an explicit model selection). */
+export function antigravityDefaultModel() {
+    try {
+        const j = JSON.parse(readFileSync(join(antigravityRoot(), 'settings.json'), 'utf8'));
+        return typeof j.model === 'string' ? j.model : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Resolve the conversationId for a workspace cwd via the last-opened cache. */
+export function antigravityConversationId(cwd) {
+    if (!cwd)
+        return undefined;
+    try {
+        const j = JSON.parse(readFileSync(join(antigravityRoot(), 'cache', 'last_conversations.json'), 'utf8'));
+        return typeof j[cwd] === 'string' ? j[cwd] : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function antigravityTranscriptPath(conversationId) {
+    return join(antigravityRoot(), 'brain', conversationId, '.system_generated', 'logs', 'transcript.jsonl');
+}
+//# sourceMappingURL=antigravity-transcript.js.map