@schlessera/brain-ui-server 0.18.0 → 0.19.0

package/dist/activity/query.js

@@ -0,0 +1,128 @@
+import { isFailureOutcome } from "@schlessera/brain-ui-sdk/protocol";
+import { latestActivityDigest } from "./digest.js";
+import { rowToRunRollup } 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,
+                    failureReason: r.failureReason,
+                })),
+            };
+        }
+        case "run": {
+            if (!query.runId)
+                return { error: "scope 'run' needs runId" };
+            const snapshot = store.snapshotRun(query.runId);
+            if (snapshot) {
+                return {
+                    runId: query.runId,
+                    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,
+                    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);
+            return {
+                windowHours: hoursBack,
+                runs: rows.length,
+                failures: rows.filter((r) => isFailureOutcome(r.outcome)).length,
+                costUsd: round(rows.reduce((a, r) => a + (r.costUsd ?? 0), 0)),
+                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,48 @@
+/**
+ * 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 { 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;
+}): 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,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;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACjD,YAAY,CA0Md"}

package/dist/activity/recorder.js

@@ -0,0 +1,205 @@
+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: "invoke_agent",
+            kind: "turn",
+            origin: "session",
+            sessionId,
+            attrs: { "gen_ai.operation.name": "invoke_agent" },
+        });
+        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: `execute_tool ${msg.toolName}`,
+                            kind: isSubagent ? "subagent" : "tool",
+                            origin: "session",
+                            sessionId,
+                            attrs: {
+                                "gen_ai.operation.name": isSubagent ? "invoke_agent" : "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_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,
+                        });
+                        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;
+}
+//# 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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"}

package/dist/activity/runtime.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The activity runtime: everything the activity record needs to live inside
+ * one app instance — store, live stream, notifier, push sender, the boot
+ * orphan sweep, and the always-on lifecycle tick (stale sweep, notification
+ * detection, push delivery, hourly prune). `createApp` constructs one and
+ * wires its pieces into the host, routes, and bridge; `close()` releases the
+ * interval and subscriptions.
+ *
+ * Nothing here may block boot or fail the observed work: the sweep and every
+ * tick pass log and continue on failure.
+ */
+import type { Database } from "bun:sqlite";
+import type { Logger } from "@opentelemetry/api-logs";
+import type { ActivityQuery, ActivityQueryResult } from "@schlessera/brain-ui-sdk/server";
+import { type ActivityStore } from "./store.js";
+import { type ActivityStream } from "./stream.js";
+import { type ActivityNotifier } from "./notify.js";
+import { type PushSender } from "./push-sender.js";
+export interface ActivityRuntime {
+    store: ActivityStore;
+    stream: ActivityStream;
+    notifier: ActivityNotifier;
+    pushSender: PushSender;
+    /** The agent-facing read seam (bridge.queryActivity). */
+    query(query: ActivityQuery): ActivityQueryResult;
+    close(): void;
+}
+export declare function createActivityRuntime(db: Database, deps: {
+    log: Logger;
+}): ActivityRuntime;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/activity/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE1F,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAerE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,yDAAyD;IACzD,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,mBAAmB,CAAC;IACjD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GACpB,eAAe,CA8FjB"}

package/dist/activity/runtime.js

@@ -0,0 +1,109 @@
+import { createActivityStore } from "./store.js";
+import { createActivityStream } from "./stream.js";
+import { createActivityNotifier } from "./notify.js";
+import { createPushSender } from "./push-sender.js";
+import { digestRetentionFloor } from "./digest.js";
+import { runActivityQuery } from "./query.js";
+// Activity lifecycle cadence. The stale threshold must comfortably exceed
+// the cron wrapper's heartbeat interval (~30s) so a live writer is never
+// swept; the tick doubles as the always-on low-frequency sweep the
+// notification layer extends.
+const ACTIVITY_TICK_MS = 20_000;
+const ACTIVITY_STALE_AFTER_MS = 2 * 60 * 1000;
+const ACTIVITY_PRUNE_INTERVAL_MS = 60 * 60 * 1000;
+const ACTIVITY_HARD_CEILING_MS = 90 * 24 * 60 * 60 * 1000;
+/** Acknowledged notification intents are kept this long, then deleted. */
+const INTENT_RETENTION_MS = 30 * 24 * 60 * 60 * 1000;
+export function createActivityRuntime(db, deps) {
+    const { log } = deps;
+    const store = createActivityStore(db);
+    const stream = createActivityStream(store, log);
+    // Boot sweep: close this server's orphans from a previous life (interrupted).
+    try {
+        const orphans = store.sweepOwnOrphans();
+        if (orphans > 0) {
+            log.emit({
+                severityText: "WARN",
+                body: "closed orphaned activity spans from a previous process",
+                attributes: { count: orphans },
+            });
+        }
+    }
+    catch (err) {
+        log.emit({
+            severityText: "WARN",
+            body: "boot activity sweep failed",
+            attributes: { error: err instanceof Error ? err.message : String(err) },
+        });
+    }
+    const notifier = createActivityNotifier({
+        db,
+        store,
+        isWatched: (scope) => stream.isWatched(scope),
+        log,
+    });
+    const pushSender = createPushSender(db, { log });
+    let delivering = false;
+    let lastPrune = 0;
+    const tick = setInterval(() => {
+        try {
+            const stale = store.sweepStale(ACTIVITY_STALE_AFTER_MS);
+            if (stale > 0) {
+                log.emit({
+                    severityText: "WARN",
+                    body: "closed stale activity spans (writer went silent)",
+                    attributes: { count: stale },
+                });
+                stream.pump();
+            }
+            notifier.tick();
+            // Async delivery, reentrancy-guarded: a slow push service must not
+            // stack passes; the next tick simply retries what stayed pending.
+            if (!delivering) {
+                delivering = true;
+                void pushSender
+                    .deliverPending(notifier)
+                    .catch((err) => log.emit({
+                    severityText: "WARN",
+                    body: "push delivery pass failed",
+                    attributes: { error: err instanceof Error ? err.message : String(err) },
+                }))
+                    .finally(() => {
+                    delivering = false;
+                });
+            }
+            if (Date.now() - lastPrune > ACTIVITY_PRUNE_INTERVAL_MS) {
+                lastPrune = Date.now();
+                store.prune({
+                    // Full detail survives until the digest has covered it; the hard
+                    // ceiling bounds growth even if the digest job silently dies.
+                    digestFloorAt: digestRetentionFloor(db),
+                    hardCeilingMs: ACTIVITY_HARD_CEILING_MS,
+                });
+                notifier.pruneAcknowledged(INTENT_RETENTION_MS);
+            }
+        }
+        catch (err) {
+            log.emit({
+                severityText: "WARN",
+                body: "activity tick failed",
+                attributes: { error: err instanceof Error ? err.message : String(err) },
+            });
+        }
+    }, ACTIVITY_TICK_MS);
+    // A Bun interval would otherwise keep a closed test app's process alive.
+    if (typeof tick === "object" && "unref" in tick)
+        tick.unref();
+    return {
+        store,
+        stream,
+        notifier,
+        pushSender,
+        query: (query) => runActivityQuery(db, store, query, notifier),
+        close() {
+            clearInterval(tick);
+            stream.close();
+        },
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/activity/runtime.js.map

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

package/dist/activity/span-sink.d.ts

@@ -0,0 +1,22 @@
+import { type ActivityStore } from "./store.js";
+export interface SpanSinkContext {
+    /** The run every ingested span belongs to. */
+    runId: string;
+    /** Parent for lines that name none — the cron root span. */
+    rootSpanId: string;
+    jobName?: string;
+}
+export interface SpanSinkResult {
+    /** Byte offset consumed so far — pass back on the next incremental call. */
+    offset: number;
+    ingested: number;
+    skipped: number;
+}
+/**
+ * Ingest new complete lines from a span-sink file. Incremental: pass the
+ * previous call's `offset`; a partial trailing line is left for next time.
+ * A missing file is an empty result, not an error — the child may simply
+ * never have emitted.
+ */
+export declare function ingestSpanSink(store: ActivityStore, path: string, context: SpanSinkContext, offset?: number): SpanSinkResult;
+//# sourceMappingURL=span-sink.d.ts.map

package/dist/activity/span-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-sink.d.ts","sourceRoot":"","sources":["../../src/activity/span-sink.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAiB,KAAK,aAAa,EAAoC,MAAM,YAAY,CAAC;AAEjG,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,EACxB,MAAM,SAAI,GACT,cAAc,CAuBhB"}