@schlessera/brain-ui-server 0.18.0 → 0.20.0

package/dist/activity/push-sender.js

@@ -0,0 +1,131 @@
+import webpush from "web-push";
+/** Per-send cap: a hung push service rejects instead of wedging the
+ *  delivering guard (the tick's reentrancy flag) forever. */
+const SEND_TIMEOUT_MS = 10_000;
+export function createPushSender(db, options = {}) {
+    const log = options.log;
+    const subject = options.subject ?? "mailto:admin@localhost";
+    const send = options.send ??
+        ((sub, payload, opts) => webpush.sendNotification({ endpoint: sub.endpoint, keys: sub.keys }, payload, { vapidDetails: opts.vapidDetails, timeout: opts.timeout }));
+    // Generate-once VAPID keys. Concurrent first boots are safe: the INSERT is
+    // OR IGNORE and the read-back wins.
+    function vapid() {
+        const row = db
+            .query("SELECT public_key AS publicKey, private_key AS privateKey FROM vapid_keys WHERE id = 1")
+            .get();
+        if (row)
+            return row;
+        const generated = webpush.generateVAPIDKeys();
+        db.query("INSERT OR IGNORE INTO vapid_keys (id, public_key, private_key, created_at) VALUES (1, ?, ?, ?)").run(generated.publicKey, generated.privateKey, Date.now());
+        return vapid();
+    }
+    function rows() {
+        return db.query("SELECT * FROM push_subscriptions ORDER BY created_at").all().map((r) => ({
+            endpoint: r.endpoint,
+            p256dh: r.p256dh,
+            auth: r.auth,
+            label: r.label,
+            createdAt: r.created_at,
+            lastUsedAt: r.last_used_at,
+        }));
+    }
+    return {
+        publicKey() {
+            return vapid().publicKey;
+        },
+        subscribe(sub, label) {
+            db.query(`INSERT INTO push_subscriptions (endpoint, p256dh, auth, label, created_at)
+         VALUES (?, ?, ?, ?, ?)
+         ON CONFLICT(endpoint) DO UPDATE SET p256dh = excluded.p256dh, auth = excluded.auth`).run(sub.endpoint, sub.keys.p256dh, sub.keys.auth, label ?? null, Date.now());
+        },
+        unsubscribe(endpoint) {
+            return db.query("DELETE FROM push_subscriptions WHERE endpoint = ?").run(endpoint)
+                .changes > 0;
+        },
+        subscriptions: rows,
+        async deliverPending(notifier) {
+            const pending = notifier.pending();
+            if (pending.length === 0)
+                return 0;
+            if (rows().length === 0) {
+                // No devices: the inbox already has it; nothing to deliver. Leave
+                // the intents pending so a device subscribing later still gets them
+                // if they are fresh, and the boot sweep can retry.
+                return 0;
+            }
+            const keys = vapid();
+            let attempts = 0;
+            for (const intent of pending) {
+                // Re-read per intent: an endpoint pruned as dead during the previous
+                // intent's pass must not be attempted again in this one.
+                const subs = rows();
+                if (subs.length === 0)
+                    break;
+                // Minimized payload; the tag coalesces repeats per run across devices.
+                const payload = JSON.stringify({
+                    title: intent.title,
+                    body: intent.body,
+                    tag: `brain-activity:${intent.runId}`,
+                    url: `/#/activity/${encodeURIComponent(intent.runId)}`,
+                });
+                attempts += subs.length;
+                const results = await Promise.allSettled(subs.map((sub) => send({ endpoint: sub.endpoint, keys: { p256dh: sub.p256dh, auth: sub.auth } }, payload, {
+                    vapidDetails: { subject, publicKey: keys.publicKey, privateKey: keys.privateKey },
+                    timeout: SEND_TIMEOUT_MS,
+                })));
+                // DB writes only after the whole settled pass — never concurrent
+                // with in-flight sends against the same handle.
+                let delivered = 0;
+                const touched = [];
+                const dead = [];
+                results.forEach((result, i) => {
+                    const sub = subs[i];
+                    if (result.status === "fulfilled") {
+                        delivered++;
+                        touched.push(sub.endpoint);
+                        return;
+                    }
+                    const err = result.reason;
+                    const status = err.statusCode;
+                    if (status === 404 || status === 410) {
+                        // The push service says this device is gone.
+                        dead.push(sub.endpoint);
+                        log?.emit({
+                            severityText: "INFO",
+                            body: "pruned dead push subscription",
+                            attributes: { status: status },
+                        });
+                    }
+                    else {
+                        log?.emit({
+                            severityText: "WARN",
+                            body: "push send failed",
+                            attributes: {
+                                error: err instanceof Error ? err.message : String(err),
+                                ...(status ? { status } : {}),
+                            },
+                        });
+                    }
+                });
+                for (const endpoint of touched) {
+                    db.query("UPDATE push_subscriptions SET last_used_at = ? WHERE endpoint = ?").run(Date.now(), endpoint);
+                }
+                for (const endpoint of dead) {
+                    db.query("DELETE FROM push_subscriptions WHERE endpoint = ?").run(endpoint);
+                }
+                notifier.markDelivered(intent.id, delivered > 0 ? "sent" : "send_failed");
+                if (delivered === 0) {
+                    // Every device failed — the all-devices signal (invalid VAPID after
+                    // a restore, typically). Loud, because it is silent on every phone.
+                    log?.emit({
+                        severityText: "ERROR",
+                        body: "push delivery failed on every subscription",
+                        attributes: { subscriptions: subs.length },
+                    });
+                }
+            }
+            return attempts;
+        },
+    };
+}
+//# sourceMappingURL=push-sender.js.map

package/dist/activity/push-sender.js.map

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

package/dist/activity/query.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The agent-facing read over the activity record — the same data the UI
+ * reads, shaped for model consumption and served through the backend
+ * bridge's `queryActivity` seam (the MCP tool calls it).
+ *
+ * Read-only by construction: nothing here writes. Free-text fields that
+ * originated outside the primary agent's own context (failure reasons /
+ * stderr tails, subagent transcript excerpts) are DATA, not instructions —
+ * the tool layer labels them as such before they reach a model.
+ */
+import type { Database } from "bun:sqlite";
+import type { ActivityQuery, ActivityQueryResult } from "@schlessera/brain-ui-sdk/server";
+import type { ActivityNotifier } from "./notify.js";
+import { type ActivityStore } from "./store.js";
+export declare function runActivityQuery(db: Database, store: ActivityStore, query: ActivityQuery, notifier?: ActivityNotifier): ActivityQueryResult;
+//# sourceMappingURL=query.d.ts.map

package/dist/activity/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/activity/query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAI1F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAoC,KAAK,aAAa,EAAgB,MAAM,YAAY,CAAC;AAEhG,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,aAAa,EACpB,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,mBAAmB,CA+IrB"}

package/dist/activity/query.js

@@ -0,0 +1,155 @@
+import { isFailureOutcome } from "@schlessera/brain-ui-sdk/protocol";
+import { latestActivityDigest } from "./digest.js";
+import { rowToRunRollup, sumEffectiveCost } from "./store.js";
+export function runActivityQuery(db, store, query, notifier) {
+    const limit = Math.min(Math.max(query.limit ?? 20, 1), 100);
+    const hoursBack = Math.min(Math.max(query.hoursBack ?? 24, 1), 24 * 90);
+    const since = Date.now() - hoursBack * 60 * 60 * 1000;
+    switch (query.scope) {
+        case "running": {
+            return {
+                running: store.openRootSpans().map(liveSummary),
+            };
+        }
+        case "recent": {
+            const rows = db
+                .query("SELECT * FROM activity_run_rollups WHERE started_at >= ? ORDER BY started_at DESC LIMIT ?")
+                .all(since, limit).map(rowToRunRollup);
+            return {
+                windowHours: hoursBack,
+                running: store.openRootSpans().map(liveSummary),
+                finished: rows.map((r) => ({
+                    runId: r.runId,
+                    origin: r.origin,
+                    name: r.name,
+                    jobName: r.jobName,
+                    sessionId: r.sessionId,
+                    startedAt: iso(r.startedAt),
+                    outcome: r.outcome,
+                    durationMs: r.durationMs,
+                    costUsd: r.costUsd,
+                    // Explicit nulls, never omitted: the model must be able to tell
+                    // "unknown" (null) from "genuinely free" ($0) — AE3.
+                    effectiveCostUsd: r.effectiveCostUsd,
+                    billingMode: r.billingMode,
+                    pricingEstimate: r.pricingEstimate,
+                    failureReason: r.failureReason,
+                })),
+            };
+        }
+        case "run": {
+            if (!query.runId)
+                return { error: "scope 'run' needs runId" };
+            const snapshot = store.snapshotRun(query.runId);
+            if (snapshot) {
+                // The cost facts live on the rollup, not the spans — attach them here
+                // the same way the REST detail route does, so the agent sees the
+                // frozen triple for a finished run without waiting for detail
+                // pruning. Explicit nulls (AE3): a still-running run has no rollup
+                // yet, and unknown must never read as $0.
+                const rollupRow = db
+                    .query("SELECT * FROM activity_run_rollups WHERE run_id = ?")
+                    .get(query.runId);
+                const liveRollup = rollupRow ? rowToRunRollup(rollupRow) : null;
+                return {
+                    runId: query.runId,
+                    costUsd: liveRollup?.costUsd ?? null,
+                    effectiveCostUsd: liveRollup?.effectiveCostUsd ?? null,
+                    billingMode: liveRollup?.billingMode ?? null,
+                    pricingEstimate: liveRollup?.pricingEstimate ?? null,
+                    failureReason: liveRollup?.failureReason ?? null,
+                    spans: snapshot.spans.map((s) => ({
+                        spanId: s.spanId,
+                        parent: s.parentSpanId,
+                        name: s.name,
+                        kind: s.kind,
+                        startedAt: iso(s.startedAt),
+                        endedAt: s.endedAt ? iso(s.endedAt) : null,
+                        outcome: s.outcome,
+                        reason: s.outcomeReason,
+                        costUsd: s.usage.costUsd,
+                        tokens: s.usage.inputTokens !== undefined || s.usage.outputTokens !== undefined
+                            ? { in: s.usage.inputTokens, out: s.usage.outputTokens }
+                            : undefined,
+                    })),
+                };
+            }
+            const row = db
+                .query("SELECT * FROM activity_run_rollups WHERE run_id = ?")
+                .get(query.runId);
+            if (!row)
+                return { error: `unknown run ${query.runId}` };
+            const rollup = rowToRunRollup(row);
+            return {
+                runId: query.runId,
+                detailPruned: true,
+                rollup: {
+                    name: rollup.name,
+                    jobName: rollup.jobName,
+                    outcome: rollup.outcome,
+                    startedAt: iso(rollup.startedAt),
+                    durationMs: rollup.durationMs,
+                    costUsd: rollup.costUsd,
+                    effectiveCostUsd: rollup.effectiveCostUsd,
+                    billingMode: rollup.billingMode,
+                    pricingEstimate: rollup.pricingEstimate,
+                    failureReason: rollup.failureReason,
+                },
+            };
+        }
+        case "rollups": {
+            const rows = db
+                .query("SELECT * FROM activity_run_rollups WHERE started_at >= ?")
+                .all(since).map(rowToRunRollup);
+            const digest = latestActivityDigest(db);
+            const effective = sumEffectiveCost(rows);
+            return {
+                windowHours: hoursBack,
+                runs: rows.length,
+                failures: rows.filter((r) => isFailureOutcome(r.outcome)).length,
+                // Both sums are sum-of-KNOWNS; the runs excluded from the effective
+                // sum ride along as unpricedRuns so unknown never reads as $0 (AE3).
+                costUsd: round(rows.reduce((a, r) => a + (r.costUsd ?? 0), 0)),
+                effectiveCostUsd: round(effective.effectiveCostUsd),
+                unpricedRuns: effective.unpricedRuns,
+                inputTokens: rows.reduce((a, r) => a + (r.inputTokens ?? 0), 0),
+                outputTokens: rows.reduce((a, r) => a + (r.outputTokens ?? 0), 0),
+                ...(digest ? { lastDigestAt: iso(digest.generatedAt) } : {}),
+            };
+        }
+        case "inbox": {
+            // The unacknowledged notification inbox — the same list the UI shows.
+            if (!notifier)
+                return { error: "inbox unavailable" };
+            return {
+                intents: notifier.inbox(limit).map((i) => ({
+                    kind: i.kind,
+                    title: i.title,
+                    status: i.status,
+                    createdAt: iso(i.createdAt),
+                    runId: i.runId,
+                })),
+            };
+        }
+        default:
+            return { error: `unknown scope` };
+    }
+}
+function liveSummary(span) {
+    return {
+        runId: span.runId,
+        origin: span.origin,
+        name: span.name,
+        jobName: span.jobName,
+        sessionId: span.sessionId,
+        startedAt: iso(span.startedAt),
+        elapsedMs: Date.now() - span.startedAt,
+    };
+}
+function iso(ms) {
+    return new Date(ms).toISOString();
+}
+function round(n) {
+    return Math.round(n * 10000) / 10000;
+}
+//# sourceMappingURL=query.js.map

package/dist/activity/query.js.map

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

package/dist/activity/recorder.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Per-turn span derivation: the host-side half of activity recording.
+ *
+ * The host already sees everything a baseline trace needs — the frames it
+ * relays (tool starts/results, the terminal result), its own approval flow
+ * (wait time, denials), and the turn lifecycle it owns (timeout, cancel).
+ * A `TurnRecorder` turns that stream into spans, so EVERY backend gets a
+ * full activity tree with zero backend work; the bridge's activity side
+ * channel enriches with what only the backend sees (subagent lifecycle,
+ * usage, transcripts).
+ *
+ * Terminal-write precedence (the write-once race): enrichment arrives on the
+ * same ordered call path as frames, and the recorder buffers the result
+ * frame's outcome/usage rather than closing the root span on sight. The ONE
+ * terminal write for the root happens in `finish()` — after the backend's
+ * startTurn resolved, when everything that could refine the outcome has
+ * drained. Frame-derived outcome is the fallback, never a competing writer.
+ *
+ * Nothing here may fail the observed turn: every public method catches and
+ * drops its own errors.
+ */
+import type { BackendActivityEvent, ServerMessage } from "@schlessera/brain-ui-sdk/server";
+import { type BillingMode } from "@schlessera/brain-ui-sdk/protocol";
+import type { Logger } from "@opentelemetry/api-logs";
+import type { ActivityStore } from "./store.js";
+export interface TurnRecorderDeps {
+    store: ActivityStore;
+    /** Called after any committed write so the live stream can pump. */
+    onWrite?: () => void;
+    log?: Logger;
+}
+export interface TurnRecorder {
+    /** The run id (one run per turn). */
+    readonly runId: string;
+    observeFrame(msg: ServerMessage): void;
+    observeActivity(event: BackendActivityEvent): void;
+    /** The user's approval decision arrived for a gated tool call. */
+    onApprovalDecision(toolUseId: string, allowed: boolean): void;
+    /**
+     * Close the turn: merge the buffered result enrichment into the root's
+     * single terminal write, cascade-cancel anything left open, roll up.
+     */
+    finish(disposition: "success" | "error" | "cancelled" | "timeout"): void;
+}
+export declare function createTurnRecorder(deps: TurnRecorderDeps, turn: {
+    turnId: string;
+    sessionId: string | null;
+    /** The RESOLVED inference profile this turn runs on (post pin-drop fallback). */
+    profileId?: string;
+    /** Billing classification of that profile, resolved at run start (U3). */
+    billingMode?: BillingMode;
+}): TurnRecorder;
+//# sourceMappingURL=recorder.d.ts.map

package/dist/activity/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/activity/recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EAEd,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,KAAK,EAAE,aAAa,EAA0B,MAAM,YAAY,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAAC;IACvC,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACnD,kEAAkE;IAClE,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9D;;;OAGG;IACH,MAAM,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,IAAI,CAAC;CAC1E;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,GACA,YAAY,CAkOd"}

package/dist/activity/recorder.js

@@ -0,0 +1,238 @@
+import { SPAN_OP_EXECUTE_TOOL, SPAN_OP_INVOKE_AGENT, SPAN_TOOL_NAME_PREFIX, } from "@schlessera/brain-ui-sdk/protocol";
+export function createTurnRecorder(deps, turn) {
+    const { store, onWrite, log } = deps;
+    const runId = turn.turnId;
+    const rootSpanId = `${runId}:turn`;
+    let sessionId = turn.sessionId ?? undefined;
+    let rootStarted = false;
+    let finished = false;
+    /** Buffered terminal enrichment from the result frame. */
+    let resultOutcome = null;
+    let resultUsage;
+    let resultAttrs;
+    const guard = (fn) => {
+        try {
+            fn();
+        }
+        catch (err) {
+            log?.emit({
+                severityText: "WARN",
+                body: "activity recording failed; dropping",
+                attributes: { error: err instanceof Error ? err.message : String(err) },
+            });
+        }
+    };
+    function ensureRoot() {
+        if (rootStarted)
+            return;
+        rootStarted = true;
+        store.startSpan({
+            spanId: rootSpanId,
+            runId,
+            name: SPAN_OP_INVOKE_AGENT,
+            kind: "turn",
+            origin: "session",
+            sessionId,
+            // Profile + billing ride the ROOT span so the rollup can price the run
+            // without any registry or env lookup of its own (a root missing the
+            // billing attr falls back to env classification at rollup time).
+            attrs: {
+                "gen_ai.operation.name": SPAN_OP_INVOKE_AGENT,
+                ...(turn.profileId ? { "brain.profile_id": turn.profileId } : {}),
+                ...(turn.billingMode ? { "brain.billing_mode": turn.billingMode } : {}),
+            },
+        });
+        onWrite?.();
+    }
+    function usageFromTurnUsage(usage) {
+        const models = usage.perModel ? Object.keys(usage.perModel) : [];
+        return {
+            inputTokens: usage.inputTokens,
+            outputTokens: usage.outputTokens,
+            cacheReadTokens: usage.cacheReadTokens,
+            cacheCreationTokens: usage.cacheCreationTokens,
+            model: models.length === 1 ? models[0] : undefined,
+        };
+    }
+    return {
+        runId,
+        observeFrame(msg) {
+            guard(() => {
+                if (finished)
+                    return;
+                switch (msg.type) {
+                    case "session_info": {
+                        sessionId = msg.sessionId;
+                        ensureRoot();
+                        // The root may have been opened before the session had a name.
+                        store.patchSpan(rootSpanId, { attrs: { "session.id": msg.sessionId } });
+                        onWrite?.();
+                        break;
+                    }
+                    case "tool_use_start": {
+                        ensureRoot();
+                        const isSubagent = msg.toolName === "Agent";
+                        store.startSpan({
+                            spanId: msg.toolUseId,
+                            runId,
+                            parentSpanId: msg.parentToolUseId ?? rootSpanId,
+                            name: `${SPAN_TOOL_NAME_PREFIX}${msg.toolName}`,
+                            kind: isSubagent ? "subagent" : "tool",
+                            origin: "session",
+                            sessionId,
+                            attrs: {
+                                "gen_ai.operation.name": isSubagent ? SPAN_OP_INVOKE_AGENT : SPAN_OP_EXECUTE_TOOL,
+                                "gen_ai.tool.name": msg.toolName,
+                            },
+                        });
+                        onWrite?.();
+                        break;
+                    }
+                    case "tool_approval_request": {
+                        // The span exists (tool_use_start preceded it). Nothing to write:
+                        // startedAt already marks the wait's beginning; the grant stamps
+                        // the wait/execution boundary.
+                        break;
+                    }
+                    case "tool_use_complete": {
+                        // The complete input object in one frame — tool_input_delta
+                        // frames stay ignored, no accumulation needed. Recorded as a
+                        // span event so the Activity drill-in can expand the call (R14).
+                        store.appendEvent(msg.toolUseId, "tool_input", safeStringify(msg.input), undefined, PAYLOAD_EVENT_CAP);
+                        onWrite?.();
+                        break;
+                    }
+                    case "tool_result": {
+                        // endSpan is write-once: a span already closed (a denial landed
+                        // the outcome first) rejects this as a no-op, and an unknown
+                        // span id is equally a no-op — no bookkeeping set needed.
+                        const outcome = msg.isError ? "error" : "success";
+                        store.endSpan(msg.toolUseId, {
+                            outcome,
+                            reason: outcome === "error" ? clip(msg.output, 500) : undefined,
+                        });
+                        // Error output rides along too — a failed call's output is what
+                        // the drill-in needs most. appendEvent no-ops on unknown spans.
+                        store.appendEvent(msg.toolUseId, "tool_output", msg.output, undefined, PAYLOAD_EVENT_CAP);
+                        onWrite?.();
+                        break;
+                    }
+                    case "result": {
+                        // Buffered — the single terminal write happens in finish().
+                        resultOutcome =
+                            msg.outcome === "success"
+                                ? "success"
+                                : msg.outcome === "cancelled"
+                                    ? "cancelled"
+                                    : msg.outcomeDetail === "max_turns" || msg.outcomeDetail === "max_budget"
+                                        ? "timeout"
+                                        : "error";
+                        if (msg.usage)
+                            resultUsage = usageFromTurnUsage(msg.usage);
+                        if (typeof msg.costUsd === "number") {
+                            resultUsage = { ...(resultUsage ?? {}), costUsd: msg.costUsd };
+                        }
+                        resultAttrs = {
+                            ...(msg.outcomeDetail ? { "outcome.detail": msg.outcomeDetail } : {}),
+                            ...(msg.usage?.perModel
+                                ? { "gen_ai.usage.per_model": msg.usage.perModel }
+                                : {}),
+                        };
+                        break;
+                    }
+                    default:
+                        break;
+                }
+            });
+        },
+        observeActivity(event) {
+            guard(() => {
+                if (finished)
+                    return;
+                switch (event.kind) {
+                    case "subagent_started": {
+                        store.patchSpan(event.toolUseId, {
+                            attrs: {
+                                "subagent.type": event.subagentType,
+                                "subagent.description": event.description,
+                            },
+                        });
+                        onWrite?.();
+                        break;
+                    }
+                    case "subagent_status": {
+                        const attrs = {
+                            ...(event.usage ? { "subagent.total_tokens": event.usage.totalTokens } : {}),
+                            ...(event.summary ? { "subagent.summary": event.summary } : {}),
+                        };
+                        if (Object.keys(attrs).length > 0) {
+                            store.patchSpan(event.toolUseId, { attrs });
+                            onWrite?.();
+                        }
+                        break;
+                    }
+                    case "subagent_transcript": {
+                        store.appendEvent(event.toolUseId, `transcript_${event.role}`, event.text);
+                        onWrite?.();
+                        break;
+                    }
+                }
+            });
+        },
+        onApprovalDecision(toolUseId, allowed) {
+            guard(() => {
+                if (allowed) {
+                    // Everything before this moment was approval wait, not execution.
+                    store.patchSpan(toolUseId, { waitUntil: Date.now() });
+                }
+                else {
+                    // The denied outcome lands now — write-once makes the backend's
+                    // later error tool_result a no-op on this span.
+                    store.endSpan(toolUseId, { outcome: "denied", reason: "user declined" });
+                }
+                onWrite?.();
+            });
+        },
+        finish(disposition) {
+            guard(() => {
+                if (finished)
+                    return;
+                finished = true;
+                ensureRoot();
+                // Merged precedence: the buffered result enrichment refines the
+                // host's own disposition; the host wins only where the backend said
+                // nothing. Cancellation/timeout are host-owned facts and always win.
+                const outcome = disposition === "cancelled" || disposition === "timeout"
+                    ? disposition
+                    : (resultOutcome ?? disposition);
+                store.endSpan(rootSpanId, {
+                    outcome,
+                    usage: resultUsage,
+                    attrs: resultAttrs,
+                });
+                // Anything still open died with the turn.
+                store.cascadeClose(runId, "cancelled", `turn ${outcome}`);
+                store.rollupRun(runId);
+                onWrite?.();
+            });
+        },
+    };
+}
+function clip(text, max) {
+    return text.length > max ? text.slice(0, max) : text;
+}
+/** Cap for recorded tool input/output payload events — roomier than the
+ *  500-char outcome-reason clip, still far under the store's 16 KB event cap.
+ *  Passed to appendEvent, whose clipping sets the wire `truncated` flag. */
+const PAYLOAD_EVENT_CAP = 4096;
+/** Tool inputs are arbitrary values: serialization must never take the turn
+ *  down with it (BigInt members throw; a toJSON can return undefined). */
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value) ?? String(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+//# sourceMappingURL=recorder.js.map

package/dist/activity/recorder.js.map

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