@schlessera/brain-ui-react 0.35.0 → 0.37.0

package/dist/stores/activity-state.d.ts

@@ -0,0 +1,29 @@
+import type { StoreEnvironment } from "./store-environment.js";
+import type { ActivityState } from "./activity-store-types.js";
+export { EMPTY_EVENTS, childSpans, eventsFor, narrativeEventsFor, payloadEventsFor, runEvents, runSpans, spanForTool, subagentSpans, timingFor, } from "./activity-store-helpers.js";
+/**
+ * Client mirror of the server's activity record, fed by the snapshot-then-
+ * delta stream. The server computes; this store only holds and indexes what
+ * arrived — no aggregation, no derived rollups (those come from the REST
+ * activity API).
+ *
+ * Ordering contract (AE6): a snapshot sets the per-run high-water seq; a
+ * delta at or below it is DISCARDED (its content is already in the
+ * snapshot). Applying a delta is idempotent — span deltas upsert by spanId,
+ * event deltas insert-if-absent by (spanId, eventIndex) — so a duplicate
+ * delivery can never corrupt state. The guard is symmetric: a snapshot
+ * whose per-run high-water is STRICTLY LOWER than what is held (a stale
+ * frame racing a reconnect) is skipped for that run; an equal value still
+ * applies, so chunked append frames keep working.
+ *
+ * Bounded mirror: at most MAX_TERMINAL_RUNS finished runs are held — once a
+ * run past the cap, the oldest terminal runs (by root start time) are
+ * evicted wholesale (spans, events, high-water, reverse index). Live runs
+ * are never evicted; evicted history remains fetchable over REST.
+ */
+export declare function createActivityStore(env: StoreEnvironment): import("zustand").StoreApi<ActivityState> & {
+    loadSessionActivityHistory: (sessionId: string) => Promise<void>;
+    loadSpanPayloads: (spanId: string) => Promise<void>;
+    dispose(): void;
+};
+//# sourceMappingURL=activity-state.d.ts.map

package/dist/stores/activity-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-state.d.ts","sourceRoot":"","sources":["../../src/stores/activity-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,2BAA2B,CAAC;AAQ3E,OAAO,EACL,YAAY,EACZ,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,WAAW,EACX,aAAa,EACb,SAAS,GACV,MAAM,6BAA6B,CAAC;AAKrC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB;4CA+KF,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;+BA0CnC,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;;EA+B/D"}

package/dist/stores/activity-state.js

@@ -0,0 +1,282 @@
+import { createStore } from "zustand/vanilla";
+import { evictRun, insertEvent, pruneTerminalRuns, rootSpanOf, } from "./activity-store-helpers.js";
+export { EMPTY_EVENTS, childSpans, eventsFor, narrativeEventsFor, payloadEventsFor, runEvents, runSpans, spanForTool, subagentSpans, timingFor, } from "./activity-store-helpers.js";
+/** How many finished runs' details are fetched when a session opens. */
+const HISTORY_RUN_LIMIT = 10;
+/**
+ * Client mirror of the server's activity record, fed by the snapshot-then-
+ * delta stream. The server computes; this store only holds and indexes what
+ * arrived — no aggregation, no derived rollups (those come from the REST
+ * activity API).
+ *
+ * Ordering contract (AE6): a snapshot sets the per-run high-water seq; a
+ * delta at or below it is DISCARDED (its content is already in the
+ * snapshot). Applying a delta is idempotent — span deltas upsert by spanId,
+ * event deltas insert-if-absent by (spanId, eventIndex) — so a duplicate
+ * delivery can never corrupt state. The guard is symmetric: a snapshot
+ * whose per-run high-water is STRICTLY LOWER than what is held (a stale
+ * frame racing a reconnect) is skipped for that run; an equal value still
+ * applies, so chunked append frames keep working.
+ *
+ * Bounded mirror: at most MAX_TERMINAL_RUNS finished runs are held — once a
+ * run past the cap, the oldest terminal runs (by root start time) are
+ * evicted wholesale (spans, events, high-water, reverse index). Live runs
+ * are never evicted; evicted history remains fetchable over REST.
+ */
+export function createActivityStore(env) {
+    const { api } = env;
+    let disposed = false;
+    const store = createStore((set, get) => ({
+        supported: false,
+        subscribed: {},
+        connectionEpoch: 0,
+        spans: {},
+        events: {},
+        highWater: {},
+        deltaSeq: {},
+        spanRun: {},
+        inbox: [],
+        loadInbox: async () => {
+            try {
+                const { intents } = await api.activityInbox();
+                if (!disposed)
+                    set({ inbox: intents });
+            }
+            catch {
+                // Badge absence over a crash — the inbox is reachable from Activity.
+            }
+        },
+        acknowledgeIntent: async (id) => {
+            set((s) => ({ inbox: s.inbox.filter((i) => i.id !== id) }));
+            try {
+                await api.activityInboxAck(id);
+            }
+            catch {
+                // Optimistic removal stands; the next load re-syncs.
+            }
+        },
+        acknowledgeAllIntents: async () => {
+            set({ inbox: [] });
+            try {
+                await api.activityInboxAckAll();
+            }
+            catch {
+                // Same optimistic policy.
+            }
+        },
+        setSupported: (supported) => {
+            set({ supported });
+            if (supported)
+                startInboxPolling();
+            else
+                stopInboxPolling();
+        },
+        resetSubscriptions: () => set({ subscribed: {} }),
+        bumpConnectionEpoch: () => set((s) => ({ connectionEpoch: s.connectionEpoch + 1 })),
+        markSubscribed: (sessionId) => set((s) => ({ subscribed: { ...s.subscribed, [sessionId]: true } })),
+        applySnapshot: (msg) => {
+            set((s) => {
+                const maps = {
+                    spans: { ...s.spans },
+                    events: { ...s.events },
+                    highWater: { ...s.highWater },
+                    deltaSeq: { ...s.deltaSeq },
+                    spanRun: { ...s.spanRun },
+                };
+                // Staleness guard: a run whose incoming high-water is strictly below
+                // what is held (snapshot floor or an applied delta) carries older
+                // state than what already applied — skip its spans/events. Equal
+                // still applies (chunked append frames).
+                const stale = new Set();
+                for (const [runId, seq] of Object.entries(msg.highWaterSeq)) {
+                    const held = Math.max(maps.highWater[runId] ?? 0, maps.deltaSeq[runId] ?? 0);
+                    if (seq < held)
+                        stale.add(runId);
+                    else
+                        maps.highWater[runId] = seq;
+                }
+                for (const span of msg.spans) {
+                    if (stale.has(span.runId))
+                        continue;
+                    maps.spans[span.runId] = { ...(maps.spans[span.runId] ?? {}), [span.spanId]: span };
+                    maps.spanRun[span.spanId] = span.runId;
+                }
+                for (const event of msg.events) {
+                    const runId = maps.spanRun[event.spanId];
+                    if (runId !== undefined && stale.has(runId))
+                        continue;
+                    maps.events[event.spanId] = insertEvent(maps.events[event.spanId], event);
+                }
+                // Scope eviction: a fresh session/index snapshot is authoritative for
+                // its scope. A held run that still looks live but is absent from the
+                // frame's high-water map is a ghost — the server says it is not
+                // running any more (its REST history remains fetchable).
+                if (!msg.append && (msg.view === "session" || msg.view === "index")) {
+                    for (const [runId, byId] of Object.entries(maps.spans)) {
+                        if (runId in msg.highWaterSeq)
+                            continue;
+                        const root = rootSpanOf(byId);
+                        if (!root || root.outcome !== undefined)
+                            continue;
+                        const inScope = msg.view === "index" || root.sessionId === msg.sessionId;
+                        if (inScope)
+                            evictRun(maps, runId);
+                    }
+                }
+                pruneTerminalRuns(maps);
+                return maps;
+            });
+        },
+        applyDelta: (msg) => {
+            const s = get();
+            if (msg.seq <= (s.highWater[msg.runId] ?? 0))
+                return;
+            if (msg.span) {
+                const span = msg.span;
+                set((prev) => ({
+                    spans: {
+                        ...prev.spans,
+                        [msg.runId]: { ...(prev.spans[msg.runId] ?? {}), [span.spanId]: span },
+                    },
+                    // Recording the applied seq keeps the snapshot staleness guard
+                    // honest: a snapshot frame older than this delta must not roll it back.
+                    deltaSeq: {
+                        ...prev.deltaSeq,
+                        [msg.runId]: Math.max(prev.deltaSeq[msg.runId] ?? 0, msg.seq),
+                    },
+                    // The mapping is almost always already present — re-spreading it on
+                    // every delta would churn a large object for nothing.
+                    ...(prev.spanRun[span.spanId] === msg.runId
+                        ? {}
+                        : { spanRun: { ...prev.spanRun, [span.spanId]: msg.runId } }),
+                }));
+                // A root span closing may push the mirror past the terminal-run cap.
+                if (span.parentSpanId === undefined && span.outcome !== undefined) {
+                    const prev = get();
+                    const maps = {
+                        spans: { ...prev.spans },
+                        events: { ...prev.events },
+                        highWater: { ...prev.highWater },
+                        deltaSeq: { ...prev.deltaSeq },
+                        spanRun: { ...prev.spanRun },
+                    };
+                    if (pruneTerminalRuns(maps))
+                        set(maps);
+                }
+            }
+            else if (msg.event) {
+                const event = msg.event;
+                set((prev) => ({
+                    events: { ...prev.events, [event.spanId]: insertEvent(prev.events[event.spanId], event) },
+                    deltaSeq: {
+                        ...prev.deltaSeq,
+                        [msg.runId]: Math.max(prev.deltaSeq[msg.runId] ?? 0, msg.seq),
+                    },
+                    ...(prev.spanRun[event.spanId] !== undefined
+                        ? {}
+                        : { spanRun: { ...prev.spanRun, [event.spanId]: msg.runId } }),
+                }));
+            }
+        },
+        clear: () => set({ spans: {}, events: {}, highWater: {}, deltaSeq: {}, spanRun: {} }),
+    }));
+    /** One badge poller per page lifetime — the inbox is cheap and the badge
+     *  must be honest even when the Activity surface never opens. */
+    let inboxPoller = null;
+    function startInboxPolling() {
+        if (inboxPoller || disposed)
+            return;
+        void store.getState().loadInbox();
+        inboxPoller = setInterval(() => {
+            void store.getState().loadInbox();
+        }, 60_000);
+    }
+    /** Runs whose history has been fetched already (per page lifetime). */
+    const loadedHistorySessions = new Set();
+    /**
+     * Pull a session's recent FINISHED runs from the REST activity API into the
+     * store. The live subscription's snapshot carries open runs only; this is
+     * what makes duration badges on history-loaded messages real (AE2) — span
+     * ids are tool-use ids, so the timeline's timing lookup starts hitting.
+     * Fire-and-forget; a failure just leaves badges absent, as before.
+     */
+    async function loadSessionActivityHistory(sessionId) {
+        if (loadedHistorySessions.has(sessionId))
+            return;
+        loadedHistorySessions.add(sessionId);
+        try {
+            const { history } = await api.activityRuns({ session: sessionId, limit: HISTORY_RUN_LIMIT });
+            const state = store.getState();
+            const details = await Promise.all(history
+                .slice(0, HISTORY_RUN_LIMIT)
+                .filter((run) => !run.detailPruned)
+                .map((run) => api.activityRun(run.runId)));
+            if (disposed)
+                return;
+            for (const detail of details) {
+                if (detail.detailPruned || !detail.spans)
+                    continue;
+                state.applySnapshot({
+                    type: "activity_snapshot",
+                    view: "run",
+                    runId: detail.runId,
+                    spans: detail.spans,
+                    events: detail.events ?? [],
+                    highWaterSeq: { [detail.runId]: detail.highWaterSeq ?? 0 },
+                });
+            }
+        }
+        catch {
+            // History timing is an enhancement; the transcript renders without it.
+            loadedHistorySessions.delete(sessionId);
+        }
+    }
+    /** Runs whose payload events have been backfilled over REST (per page lifetime). */
+    const payloadLoadedRuns = new Set();
+    /**
+     * Backfill one finished run's tool payload events into the mirror. The
+     * history fetch above and the run-list default deliberately skip payload
+     * bodies — they exist for duration badges, not drill-ins — so the first
+     * expanded payload view of a history span pulls the full detail
+     * (`include=payloads`) and merges it. Live runs never need this: their
+     * payload events ride the delta stream. The merge is safe because a snapshot
+     * at the same high-water still applies and events insert-if-absent.
+     */
+    async function loadSpanPayloads(spanId) {
+        const state = store.getState();
+        const runId = state.spanRun[spanId];
+        if (!runId || payloadLoadedRuns.has(runId))
+            return;
+        const root = rootSpanOf(state.spans[runId] ?? {});
+        if (!root || root.outcome === undefined)
+            return;
+        payloadLoadedRuns.add(runId);
+        try {
+            const detail = await api.activityRun(runId, { includePayloads: true });
+            if (disposed || detail.detailPruned || !detail.spans)
+                return;
+            store.getState().applySnapshot({
+                type: "activity_snapshot",
+                view: "run",
+                runId,
+                spans: detail.spans,
+                events: detail.events ?? [],
+                highWaterSeq: { [runId]: detail.highWaterSeq ?? 0 },
+            });
+        }
+        catch {
+            // Payloads are an enhancement; the row keeps its no-payload notice.
+            payloadLoadedRuns.delete(runId);
+        }
+    }
+    function stopInboxPolling() {
+        if (inboxPoller)
+            clearInterval(inboxPoller);
+        inboxPoller = null;
+    }
+    return Object.assign(store, {
+        loadSessionActivityHistory, loadSpanPayloads,
+        dispose() { disposed = true; stopInboxPolling(); loadedHistorySessions.clear(); payloadLoadedRuns.clear(); },
+    });
+}
+//# sourceMappingURL=activity-state.js.map

package/dist/stores/activity-state.js.map

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

package/dist/stores/activity-store.d.ts

@@ -1,42 +1,11 @@
-import type { ActivityState } from "./activity-store-types.js";
-export { EMPTY_EVENTS, childSpans, eventsFor, narrativeEventsFor, payloadEventsFor, runEvents, runSpans, spanForTool, subagentSpans, timingFor, } from "./activity-store-helpers.js";
-/**
- * Client mirror of the server's activity record, fed by the snapshot-then-
- * delta stream. The server computes; this store only holds and indexes what
- * arrived — no aggregation, no derived rollups (those come from the REST
- * activity API).
- *
- * Ordering contract (AE6): a snapshot sets the per-run high-water seq; a
- * delta at or below it is DISCARDED (its content is already in the
- * snapshot). Applying a delta is idempotent — span deltas upsert by spanId,
- * event deltas insert-if-absent by (spanId, eventIndex) — so a duplicate
- * delivery can never corrupt state. The guard is symmetric: a snapshot
- * whose per-run high-water is STRICTLY LOWER than what is held (a stale
- * frame racing a reconnect) is skipped for that run; an equal value still
- * applies, so chunked append frames keep working.
- *
- * Bounded mirror: at most MAX_TERMINAL_RUNS finished runs are held — once a
- * run past the cap, the oldest terminal runs (by root start time) are
- * evicted wholesale (spans, events, high-water, reverse index). Live runs
- * are never evicted; evicted history remains fetchable over REST.
- */
-export declare const useActivityStore: import("zustand").UseBoundStore<import("zustand").StoreApi<ActivityState>>;
-/**
- * Pull a session's recent FINISHED runs from the REST activity API into the
- * store. The live subscription's snapshot carries open runs only; this is
- * what makes duration badges on history-loaded messages real (AE2) — span
- * ids are tool-use ids, so the timeline's timing lookup starts hitting.
- * Fire-and-forget; a failure just leaves badges absent, as before.
- */
-export declare function loadSessionActivityHistory(sessionId: string): Promise<void>;
-/**
- * Backfill one finished run's tool payload events into the mirror. The
- * history fetch above and the run-list default deliberately skip payload
- * bodies — they exist for duration badges, not drill-ins — so the first
- * expanded payload view of a history span pulls the full detail
- * (`include=payloads`) and merges it. Live runs never need this: their
- * payload events ride the delta stream. The merge is safe because a snapshot
- * at the same high-water still applies and events insert-if-absent.
- */
-export declare function loadSpanPayloads(spanId: string): Promise<void>;
+import { defaultRoot } from "../default-root.js";
+export * from "./activity-state.js";
+/** Hook reads the current provider. Statics address the default app only. */
+export declare const useActivityStore: (<T>(selector: (state: ReturnType<typeof defaultRoot.stores.activity.getState>) => T) => T) & import("zustand").StoreApi<import("./activity-store-types.js").ActivityState> & {
+    loadSessionActivityHistory: (sessionId: string) => Promise<void>;
+    loadSpanPayloads: (spanId: string) => Promise<void>;
+    dispose(): void;
+};
+export declare const loadSessionActivityHistory: (sessionId: string) => Promise<void>;
+export declare const loadSpanPayloads: (spanId: string) => Promise<void>;
 //# sourceMappingURL=activity-store.d.ts.map

package/dist/stores/activity-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity-store.d.ts","sourceRoot":"","sources":["../../src/stores/activity-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,2BAA2B,CAAC;AAQ3E,OAAO,EACL,YAAY,EACZ,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,WAAW,EACX,aAAa,EACb,SAAS,GACV,MAAM,6BAA6B,CAAC;AAKrC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,gBAAgB,4EAoJ1B,CAAC;AAgBJ;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BjF;AAKD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBpE"}
+{"version":3,"file":"activity-store.d.ts","sourceRoot":"","sources":["../../src/stores/activity-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,cAAc,qBAAqB,CAAC;AAEpC,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,IACD,CAAC,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAG,CAAC;;;;CAIjH,CAAC;AAEF,eAAO,MAAM,0BAA0B,sCAAyD,CAAC;AACjG,eAAO,MAAM,gBAAgB,mCAA+C,CAAC"}