@schlessera/brain-ui-react 0.34.0 → 0.34.1

package/dist/hooks/websocket-handlers/chat.js

@@ -0,0 +1,175 @@
+import { activeChat, useChatStore } from "../../stores/chat-store.js";
+import { isAskUserTool } from "../../lib/tool-names.js";
+let historyMessageCounter = 0;
+function historyId() {
+    return `hist-${++historyMessageCounter}-${Date.now()}`;
+}
+function convertHistoryMessage(msg) {
+    // Fallback for history without chronological parts: synthesize the legacy
+    // grouped order (thinking, tools, text).
+    const parts = msg.parts ??
+        [
+            ...(msg.thinking ? [{ kind: "thinking", text: msg.thinking }] : []),
+            ...msg.toolCalls.map((_, i) => ({ kind: "tool", toolIndex: i })),
+            ...(msg.content ? [{ kind: "text", text: msg.content }] : []),
+        ];
+    const askUserExchanges = reconstructAskUserExchanges(msg.toolCalls);
+    return {
+        id: historyId(),
+        role: msg.role,
+        content: msg.content,
+        thinking: msg.thinking,
+        toolCalls: msg.toolCalls.map((tc) => ({
+            id: tc.id,
+            name: tc.name,
+            input: tc.input,
+            inputJson: JSON.stringify(tc.input, null, 2),
+            output: tc.output,
+            isError: tc.isError,
+            status: "complete",
+        })),
+        parts,
+        isStreaming: false,
+        timestamp: Date.now(),
+        ...(askUserExchanges ? { askUserExchanges } : {}),
+        ...(msg.attachmentCount ? { attachmentCount: msg.attachmentCount } : {}),
+    };
+}
+/** Rebuild ask_user exchanges from a resumed message's tool calls. */
+function isBareAnswersMap(v) {
+    return (!!v &&
+        typeof v === "object" &&
+        !Array.isArray(v) &&
+        Object.values(v).every((x) => typeof x === "string"));
+}
+function reconstructAskUserExchanges(toolCalls) {
+    const exchanges = [];
+    for (const tc of toolCalls) {
+        if (!isAskUserTool(tc.name))
+            continue;
+        const questions = tc.input?.questions ?? [];
+        const exchange = { requestId: tc.id, questions };
+        if (tc.output) {
+            try {
+                const payload = JSON.parse(tc.output);
+                if (payload && typeof payload === "object" && payload.answers) {
+                    exchange.answers = payload.answers;
+                    exchange.annotations = payload.annotations;
+                }
+                else if (isBareAnswersMap(payload)) {
+                    // The pi backend persists the bare answers map, without the
+                    // `{answers}` envelope the Claude tool writes.
+                    exchange.answers = payload;
+                }
+            }
+            catch {
+                // Non-JSON output means the question was dismissed or errored out.
+                exchange.cancelled = true;
+            }
+        }
+        if (tc.isError && !exchange.answers)
+            exchange.cancelled = true;
+        exchanges.push(exchange);
+    }
+    return exchanges.length ? exchanges : undefined;
+}
+/** Map a frame to the run-state its session should show in the session list. */
+export function runStateForFrame(msg) {
+    if (msg.type === "result" || msg.type === "error")
+        return "idle";
+    if (msg.type === "status") {
+        if (msg.status === "queued")
+            return "queued";
+        if (msg.status === "idle" || msg.status === "cancelled")
+            return "idle";
+    }
+    return "streaming";
+}
+export const chatFrameHandlers = {
+    text_delta: (msg, context) => {
+        // Opening the bubble stays immediate — the first token should show a
+        // message starting, and every later delta needs isStreaming to be true.
+        if (!context.buffer()?.isStreaming) {
+            context.state.startAssistantMessage(context.key);
+        }
+        context.enqueueDelta(context.key, "text", msg.text);
+    },
+    thinking_delta: (msg, context) => {
+        if (!context.buffer()?.isStreaming) {
+            context.state.startAssistantMessage(context.key);
+        }
+        context.enqueueDelta(context.key, "thinking", msg.text);
+    },
+    tool_use_start: (msg, context) => {
+        // A tool call INSIDE a subagent nests under its Agent entry, rendered
+        // from the activity stream — putting it in the flat transcript would
+        // interleave fan-out work with the main turn's steps.
+        if (msg.parentToolUseId)
+            return;
+        context.state.startToolCall(context.key, msg.toolUseId, msg.toolName);
+    },
+    tool_input_delta: (msg, context) => {
+        context.state.appendToolInput(context.key, msg.partialJson);
+    },
+    tool_use_complete: (msg, context) => {
+        // Subagent tool calls render nested (activity stream), and the flat
+        // store's name-based fallback match must never see them.
+        if (msg.parentToolUseId)
+            return;
+        context.state.completeToolCall(context.key, msg.toolUseId, msg.toolName, msg.input);
+    },
+    tool_approval_request: (msg, context) => {
+        context.state.requestToolApproval(context.key, msg.toolUseId, msg.toolName, msg.input, msg.description, msg.kind);
+    },
+    tool_result: (msg, context) => {
+        context.state.setToolResult(context.key, msg.toolUseId, msg.output, msg.isError);
+        // Once the agent receives the ask_user tool result, the exchange is
+        // complete — drop any leftover ask_user UI state.
+        const chat = context.buffer();
+        if (chat?.askUser?.answers || chat?.askUser?.cancelled) {
+            context.state.clearAskUser(context.key);
+        }
+    },
+    ask_user_request: (msg, context) => {
+        context.state.setAskUserRequest(context.key, msg.requestId, msg.questions);
+    },
+    result: (msg, context) => {
+        context.state.finishAssistantMessage(context.key);
+        context.resyncIfNeeded(msg.sessionId);
+    },
+    session_history: (msg, context) => {
+        const converted = msg.messages.map(convertHistoryMessage);
+        if (msg.append) {
+            context.state.appendMessages(context.key, converted);
+        }
+        else {
+            // First (replacing) chunk = fresh authoritative transcript. Cancel any
+            // pending reconnect resync so we don't redundantly re-fetch it, and
+            // mark this session cold-resumed so idle-status handling doesn't loop.
+            context.state.setMessages(context.key, converted);
+            context.markHistoryReplaced(context.key);
+        }
+    },
+    status: (msg, context) => {
+        // Only finish streaming if this buffer actually started it
+        if ((msg.status === "idle" || msg.status === "cancelled") &&
+            context.buffer()?.isStreaming) {
+            context.state.finishAssistantMessage(context.key);
+        }
+        // A session that finished while we were offline never delivers its
+        // `result` — the idle status on reconnect is the cue to resync. Keyed to
+        // THIS frame's session: a background session settling must not consume
+        // (or trigger) the active session's pending resync.
+        if (msg.status === "idle" || msg.status === "cancelled") {
+            const current = useChatStore.getState();
+            context.resyncIfNeeded(context.frameSessionId ?? current.activeSessionId);
+            // Cold load: we hold a stored session id but an empty transcript and
+            // the server is idle (so it sent no snapshot). Fetch the history.
+            // Only the active session's own (or an unscoped legacy) idle counts.
+            if (!context.frameSessionId || context.frameSessionId === current.activeSessionId) {
+                context.coldResumeIfNeeded(current.activeSessionId, activeChat(current).messages.length);
+            }
+        }
+    },
+};
+//# sourceMappingURL=chat.js.map

package/dist/hooks/websocket-handlers/chat.js.map

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

package/dist/hooks/websocket-handlers/connection.d.ts

@@ -0,0 +1,6 @@
+export declare const connectionFrameHandlers: {
+    server_hello: (msg: import("@schlessera/brain-ui-sdk/protocol").ServerHello, context: import("./types.js").DispatchContext) => void;
+    location_request: (msg: import("@schlessera/brain-ui-sdk/protocol").ServerLocationRequest, context: import("./types.js").DispatchContext) => void;
+    error: (msg: import("@schlessera/brain-ui-sdk/protocol").ServerError, context: import("./types.js").DispatchContext) => void;
+};
+//# sourceMappingURL=connection.d.ts.map

package/dist/hooks/websocket-handlers/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/hooks/websocket-handlers/connection.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,uBAAuB;;;;CAuBgB,CAAC"}

package/dist/hooks/websocket-handlers/connection.js

@@ -0,0 +1,27 @@
+import { useActivityStore } from "../../stores/activity-store.js";
+import { useConnectionStore } from "../../stores/connection-store.js";
+export const connectionFrameHandlers = {
+    server_hello: (msg, context) => {
+        useActivityStore.getState().setSupported(msg.capabilities?.activity === true);
+        // A new hello means a new connection: server-side subscriptions are gone.
+        useActivityStore.getState().resetSubscriptions();
+        // …and view-owned subscriptions (the Activity index) must re-send too.
+        useActivityStore.getState().bumpConnectionEpoch();
+        context.ensureActivitySubscription(context.state.activeSessionId);
+    },
+    location_request: (msg, context) => {
+        context.requestBrowserLocation(msg);
+    },
+    error: (msg, context) => {
+        // ALWAYS recorded. Appending to the transcript only works while a
+        // message is streaming, and this used to be the whole handler — so an
+        // error arriving between turns (a rejected frame, a failed resume) was
+        // dropped as silently on the client as it was on the server.
+        useConnectionStore.getState().reportError(msg.code, msg.message);
+        if (context.buffer()?.isStreaming) {
+            context.state.appendText(context.key, `\n\n**Error:** ${msg.message}`);
+            context.state.finishAssistantMessage(context.key);
+        }
+    },
+};
+//# sourceMappingURL=connection.js.map

package/dist/hooks/websocket-handlers/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../src/hooks/websocket-handlers/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAKtE,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,YAAY,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;QAC7B,gBAAgB,CAAC,QAAQ,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC;QAC9E,0EAA0E;QAC1E,gBAAgB,CAAC,QAAQ,EAAE,CAAC,kBAAkB,EAAE,CAAC;QACjD,uEAAuE;QACvE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,mBAAmB,EAAE,CAAC;QAClD,OAAO,CAAC,0BAA0B,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACpE,CAAC;IACD,gBAAgB,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;QACjC,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;QACtB,kEAAkE;QAClE,sEAAsE;QACtE,uEAAuE;QACvE,6DAA6D;QAC7D,kBAAkB,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,kBAAkB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACvE,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;CACiD,CAAC"}

package/dist/hooks/websocket-handlers/index.d.ts

@@ -0,0 +1,4 @@
+import type { ServerMessage } from "@schlessera/brain-ui-sdk/protocol";
+import type { DispatchContext } from "./types.js";
+export declare function dispatchServerMessage(msg: ServerMessage, context: DispatchContext): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/websocket-handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/websocket-handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAMvE,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,YAAY,CAAC;AA2CpB,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAKxF"}

package/dist/hooks/websocket-handlers/index.js

@@ -0,0 +1,19 @@
+import { activityFrameHandlers } from "./activity.js";
+import { chatFrameHandlers } from "./chat.js";
+import { connectionFrameHandlers } from "./connection.js";
+import { maskFrameHandlers } from "./mask.js";
+import { providerFrameHandlers } from "./provider.js";
+const serverMessageHandlers = {
+    ...chatFrameHandlers,
+    ...activityFrameHandlers,
+    ...maskFrameHandlers,
+    ...providerFrameHandlers,
+    ...connectionFrameHandlers,
+};
+export function dispatchServerMessage(msg, context) {
+    // The mapped type preserves the message/handler correlation. TypeScript
+    // loses that correlation at an indexed union access, so restore it only at
+    // this single composition boundary.
+    serverMessageHandlers[msg.type](msg, context);
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/websocket-handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/websocket-handlers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAwCtD,MAAM,qBAAqB,GAAG;IAC5B,GAAG,iBAAiB;IACpB,GAAG,qBAAqB;IACxB,GAAG,iBAAiB;IACpB,GAAG,qBAAqB;IACxB,GAAG,uBAAuB;CAC0B,CAAC;AAEvD,MAAM,UAAU,qBAAqB,CAAC,GAAkB,EAAE,OAAwB;IAChF,wEAAwE;IACxE,2EAA2E;IAC3E,oCAAoC;IACpC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAY,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC"}

package/dist/hooks/websocket-handlers/mask.d.ts

@@ -0,0 +1,4 @@
+export declare const maskFrameHandlers: {
+    mask_request: (msg: import("@schlessera/brain-ui-sdk/protocol").ServerMaskRequest) => void;
+};
+//# sourceMappingURL=mask.d.ts.map

package/dist/hooks/websocket-handlers/mask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask.d.ts","sourceRoot":"","sources":["../../../src/hooks/websocket-handlers/mask.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,iBAAiB;;CAWgB,CAAC"}

package/dist/hooks/websocket-handlers/mask.js

@@ -0,0 +1,14 @@
+import { useMaskStore } from "../../stores/mask-store.js";
+export const maskFrameHandlers = {
+    mask_request: (msg) => {
+        // Opens the editor; the answer travels back from the component, because
+        // only the user can say which part of the picture they meant.
+        useMaskStore.getState().open({
+            requestId: msg.requestId,
+            imagePath: msg.imagePath,
+            ...(msg.instruction ? { instruction: msg.instruction } : {}),
+            ...(msg.turnId ? { turnId: msg.turnId } : {}),
+        });
+    },
+};
+//# sourceMappingURL=mask.js.map

package/dist/hooks/websocket-handlers/mask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask.js","sourceRoot":"","sources":["../../../src/hooks/websocket-handlers/mask.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAK1D,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE;QACpB,wEAAwE;QACxE,8DAA8D;QAC9D,YAAY,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC;YAC3B,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C,CAAC,CAAC;IACL,CAAC;CAC2C,CAAC"}

package/dist/hooks/websocket-handlers/provider.d.ts

@@ -0,0 +1,4 @@
+export declare const providerFrameHandlers: {
+    session_info: (msg: import("@schlessera/brain-ui-sdk/protocol").ServerSessionInfo, context: import("./types.js").DispatchContext) => void;
+};
+//# sourceMappingURL=provider.d.ts.map

package/dist/hooks/websocket-handlers/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/hooks/websocket-handlers/provider.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,qBAAqB;;CA4BgB,CAAC"}

package/dist/hooks/websocket-handlers/provider.js

@@ -0,0 +1,31 @@
+import { useChatStore } from "../../stores/chat-store.js";
+import { useProviderStore } from "../../stores/provider-store.js";
+export const providerFrameHandlers = {
+    session_info: (msg, context) => {
+        context.ensureActivitySubscription(msg.sessionId);
+        // Record backend ownership for renderer scoping — for ANY session, since
+        // background sessions keep their own transcript buffers. Older servers
+        // omit backendId; derive it from the pinned profile when still possible
+        // (fails only for since-hidden profiles, which then use the default).
+        const ownerBackendId = msg.backendId ??
+            useProviderStore
+                .getState()
+                .available.find((p) => p.id === msg.providerId)?.backendId;
+        if (ownerBackendId) {
+            useChatStore.getState().setSessionBackend(msg.sessionId, ownerBackendId);
+        }
+        // bindDraftSession in the dispatcher handled draft adoption; an info frame
+        // may still re-pin the provider picker when it concerns the session in view.
+        const current = useChatStore.getState();
+        if (context.frameSessionId && context.frameSessionId === current.activeSessionId) {
+            useProviderStore.getState().setPinned(msg.providerId ?? null);
+            // Reattachment on a fresh connection: enter streaming mode so deltas
+            // append to a live assistant message instead of vanishing.
+            const chat = current.buffers[context.frameSessionId];
+            if (chat && !chat.isStreaming && chat.messages.length === 0) {
+                current.startAssistantMessage(context.frameSessionId);
+            }
+        }
+    },
+};
+//# sourceMappingURL=provider.js.map

package/dist/hooks/websocket-handlers/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/hooks/websocket-handlers/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAKlE,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,YAAY,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;QAC7B,OAAO,CAAC,0BAA0B,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAClD,yEAAyE;QACzE,uEAAuE;QACvE,wEAAwE;QACxE,sEAAsE;QACtE,MAAM,cAAc,GAClB,GAAG,CAAC,SAAS;YACb,gBAAgB;iBACb,QAAQ,EAAE;iBACV,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;QAC/D,IAAI,cAAc,EAAE,CAAC;YACnB,YAAY,CAAC,QAAQ,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAC3E,CAAC;QACD,2EAA2E;QAC3E,6EAA6E;QAC7E,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC;YACjF,gBAAgB,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC;YAC9D,qEAAqE;YACrE,2DAA2D;YAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YACrD,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5D,OAAO,CAAC,qBAAqB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;IACH,CAAC;CAC+C,CAAC"}

package/dist/hooks/websocket-handlers/types.d.ts

@@ -0,0 +1,24 @@
+import type { ServerMessage } from "@schlessera/brain-ui-sdk/protocol";
+import type { ChatKey, SessionChat } from "../../stores/chat-store.js";
+import { useChatStore } from "../../stores/chat-store.js";
+export type ServerMessageType = ServerMessage["type"];
+export interface DispatchContext {
+    state: ReturnType<typeof useChatStore.getState>;
+    frameSessionId: string | undefined;
+    key: ChatKey;
+    buffer: () => SessionChat | null | undefined;
+    enqueueDelta: (key: ChatKey, kind: "text" | "thinking", text: string) => void;
+    ensureActivitySubscription: (sessionId: string | null | undefined) => void;
+    requestBrowserLocation: (msg: Extract<ServerMessage, {
+        type: "location_request";
+    }>) => void;
+    resyncIfNeeded: (sessionId: string | null) => void;
+    coldResumeIfNeeded: (sessionId: string | null, messageCount: number) => void;
+    markHistoryReplaced: (key: ChatKey) => void;
+}
+export type ServerMessageHandlerMap<T extends ServerMessageType> = {
+    [K in T]: (msg: Extract<ServerMessage, {
+        type: K;
+    }>, context: DispatchContext) => void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/websocket-handlers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hooks/websocket-handlers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChD,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;IAC7C,YAAY,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9E,0BAA0B,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IAC3E,sBAAsB,EAAE,CACtB,GAAG,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,kBAAkB,CAAA;KAAE,CAAC,KACtD,IAAI,CAAC;IACV,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACnD,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7E,mBAAmB,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7C;AAED,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,iBAAiB,IAAI;KAChE,CAAC,IAAI,CAAC,GAAG,CACR,GAAG,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,EACxC,OAAO,EAAE,eAAe,KACrB,IAAI;CACV,CAAC"}

package/dist/hooks/websocket-handlers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hooks/websocket-handlers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hooks/websocket-handlers/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,50 @@
+import type { ActivitySpan, ActivitySpanEvent } from "@schlessera/brain-ui-sdk/protocol";
+import type { ActivityState, MirrorMaps } from "./activity-store-types.js";
+export declare function rootSpanOf(byId: Record<string, ActivitySpan>): ActivitySpan | undefined;
+/** Drop a whole run from the mirror — spans, events, high-water, reverse index. */
+export declare function evictRun(maps: MirrorMaps, runId: string): void;
+/**
+ * Enforce the terminal-run bound in place. Returns whether anything was
+ * evicted. Runs whose root span is still open (or unknown) are never touched.
+ */
+export declare function pruneTerminalRuns(maps: MirrorMaps): boolean;
+export declare function insertEvent(list: ActivitySpanEvent[] | undefined, event: ActivitySpanEvent): ActivitySpanEvent[];
+/** All spans of a run, roots first, then by start time. */
+export declare function runSpans(state: ActivityState, runId: string): ActivitySpan[];
+/** Direct children of a span (e.g. the tool calls inside a subagent). */
+export declare function childSpans(state: ActivityState, parentSpanId: string): ActivitySpan[];
+/** The subagent spans spawned by a turn's Agent tool calls, live status included. */
+export declare function subagentSpans(state: ActivityState, sessionId: string): ActivitySpan[];
+/** Stable empty result for `eventsFor` — a fresh `[]` per call would defeat
+ *  reference-equality checks in zustand selectors. */
+export declare const EMPTY_EVENTS: ActivitySpanEvent[];
+/** Ordered events of a span; the shared frozen empty array when none. */
+export declare function eventsFor(state: ActivityState, spanId: string): ActivitySpanEvent[];
+/**
+ * The recorded input/output payload events of a tool span (AE7). Returns a
+ * fresh array per call — subscribe through `useShallow` (like `childSpans`).
+ */
+export declare function payloadEventsFor(state: ActivityState, spanId: string): ActivitySpanEvent[];
+/**
+ * Everything recorded against a span that is NOT a tool input/output payload:
+ * transcript excerpts, job output, and any span-sink event type a producer
+ * invents. Rendered as the span's narrative so an unknown type degrades to a
+ * labelled block rather than to invisibility.
+ */
+export declare function narrativeEventsFor(state: ActivityState, spanId: string): ActivitySpanEvent[];
+/** Every event recorded under a run, ordered by time — the run detail's
+ *  narrative stream and the raw-trace dump both read through this. */
+export declare function runEvents(state: ActivityState, runId: string): ActivitySpanEvent[];
+/** The span behind one tool call (span ids ARE toolUseIds), if streamed. */
+export declare function spanForTool(state: ActivityState, toolUseId: string): ActivitySpan | null;
+/**
+ * Server-stamped timing for a tool call. One clock for live and reloaded
+ * views: when the activity stream carries the span, its timestamps win over
+ * client stamps (AE2 — live and revisit must render identical timings).
+ * `waitUntil` marks the approval-wait/execution boundary.
+ */
+export declare function timingFor(state: ActivityState, toolUseId: string): {
+    startedAt: number;
+    endedAt?: number;
+} | null;
+//# sourceMappingURL=activity-store-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activity-store-helpers.d.ts","sourceRoot":"","sources":["../../src/stores/activity-store-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAK3E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,YAAY,GAAG,SAAS,CAEvF;AAED,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQ9D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAc3D;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,iBAAiB,EAAE,GAAG,SAAS,EACrC,KAAK,EAAE,iBAAiB,GACvB,iBAAiB,EAAE,CAMrB;AAID,2DAA2D;AAC3D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAO5E;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,YAAY,EAAE,CAMrF;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CAQrF;AAED;sDACsD;AACtD,eAAO,MAAM,YAAY,EAAE,iBAAiB,EAEpB,CAAC;AAEzB,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAEnF;AAOD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAK1F;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,GACb,iBAAiB,EAAE,CAKrB;AAED;sEACsE;AACtE,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAUlF;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAGxF;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,GAChB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAOhD"}

package/dist/stores/activity-store-helpers.js

@@ -0,0 +1,143 @@
+/** Bound on the mirror: how many TERMINAL runs stay held. Live runs never count. */
+const MAX_TERMINAL_RUNS = 50;
+export function rootSpanOf(byId) {
+    return Object.values(byId).find((span) => span.parentSpanId === undefined);
+}
+/** Drop a whole run from the mirror — spans, events, high-water, reverse index. */
+export function evictRun(maps, runId) {
+    for (const spanId of Object.keys(maps.spans[runId] ?? {})) {
+        delete maps.events[spanId];
+        delete maps.spanRun[spanId];
+    }
+    delete maps.spans[runId];
+    delete maps.highWater[runId];
+    delete maps.deltaSeq[runId];
+}
+/**
+ * Enforce the terminal-run bound in place. Returns whether anything was
+ * evicted. Runs whose root span is still open (or unknown) are never touched.
+ */
+export function pruneTerminalRuns(maps) {
+    const terminal = [];
+    for (const [runId, byId] of Object.entries(maps.spans)) {
+        const root = rootSpanOf(byId);
+        if (root && root.outcome !== undefined) {
+            terminal.push({ runId, startedAt: root.startedAt });
+        }
+    }
+    if (terminal.length <= MAX_TERMINAL_RUNS)
+        return false;
+    terminal.sort((a, b) => a.startedAt - b.startedAt);
+    for (const { runId } of terminal.slice(0, terminal.length - MAX_TERMINAL_RUNS)) {
+        evictRun(maps, runId);
+    }
+    return true;
+}
+export function insertEvent(list, event) {
+    const existing = list ?? [];
+    if (existing.some((e) => e.eventIndex === event.eventIndex))
+        return existing;
+    const next = [...existing, event];
+    next.sort((a, b) => a.eventIndex - b.eventIndex);
+    return next;
+}
+// --- Selectors (plain functions over the state, like activeChat) ---
+/** All spans of a run, roots first, then by start time. */
+export function runSpans(state, runId) {
+    const byId = state.spans[runId];
+    if (!byId)
+        return [];
+    return Object.values(byId).sort((a, b) => (a.parentSpanId ? 1 : 0) - (b.parentSpanId ? 1 : 0) || a.startedAt - b.startedAt);
+}
+/** Direct children of a span (e.g. the tool calls inside a subagent). */
+export function childSpans(state, parentSpanId) {
+    const runId = state.spanRun[parentSpanId];
+    if (!runId)
+        return [];
+    return Object.values(state.spans[runId] ?? {})
+        .filter((s) => s.parentSpanId === parentSpanId)
+        .sort((a, b) => a.startedAt - b.startedAt);
+}
+/** The subagent spans spawned by a turn's Agent tool calls, live status included. */
+export function subagentSpans(state, sessionId) {
+    const out = [];
+    for (const byId of Object.values(state.spans)) {
+        for (const span of Object.values(byId)) {
+            if (span.kind === "subagent" && span.sessionId === sessionId)
+                out.push(span);
+        }
+    }
+    return out.sort((a, b) => a.startedAt - b.startedAt);
+}
+/** Stable empty result for `eventsFor` — a fresh `[]` per call would defeat
+ *  reference-equality checks in zustand selectors. */
+export const EMPTY_EVENTS = Object.freeze([]);
+/** Ordered events of a span; the shared frozen empty array when none. */
+export function eventsFor(state, spanId) {
+    return state.events[spanId] ?? EMPTY_EVENTS;
+}
+/** Payload event types the tool expander owns — every OTHER type belongs to
+ *  the narrative stream (`narrativeEventsFor`) so nothing recorded is
+ *  rendered nowhere. */
+const TOOL_PAYLOAD_TYPES = new Set(["tool_input", "tool_output"]);
+/**
+ * The recorded input/output payload events of a tool span (AE7). Returns a
+ * fresh array per call — subscribe through `useShallow` (like `childSpans`).
+ */
+export function payloadEventsFor(state, spanId) {
+    const events = state.events[spanId];
+    if (!events)
+        return EMPTY_EVENTS;
+    const payloads = events.filter((e) => TOOL_PAYLOAD_TYPES.has(e.eventType));
+    return payloads.length > 0 ? payloads : EMPTY_EVENTS;
+}
+/**
+ * Everything recorded against a span that is NOT a tool input/output payload:
+ * transcript excerpts, job output, and any span-sink event type a producer
+ * invents. Rendered as the span's narrative so an unknown type degrades to a
+ * labelled block rather than to invisibility.
+ */
+export function narrativeEventsFor(state, spanId) {
+    const events = state.events[spanId];
+    if (!events)
+        return EMPTY_EVENTS;
+    const rest = events.filter((e) => !TOOL_PAYLOAD_TYPES.has(e.eventType));
+    return rest.length > 0 ? rest : EMPTY_EVENTS;
+}
+/** Every event recorded under a run, ordered by time — the run detail's
+ *  narrative stream and the raw-trace dump both read through this. */
+export function runEvents(state, runId) {
+    const byId = state.spans[runId];
+    if (!byId)
+        return EMPTY_EVENTS;
+    const out = [];
+    for (const spanId of Object.keys(byId)) {
+        const events = state.events[spanId];
+        if (events)
+            out.push(...events);
+    }
+    if (out.length === 0)
+        return EMPTY_EVENTS;
+    return out.sort((a, b) => a.ts - b.ts || a.eventIndex - b.eventIndex);
+}
+/** The span behind one tool call (span ids ARE toolUseIds), if streamed. */
+export function spanForTool(state, toolUseId) {
+    const runId = state.spanRun[toolUseId];
+    return runId ? (state.spans[runId]?.[toolUseId] ?? null) : null;
+}
+/**
+ * Server-stamped timing for a tool call. One clock for live and reloaded
+ * views: when the activity stream carries the span, its timestamps win over
+ * client stamps (AE2 — live and revisit must render identical timings).
+ * `waitUntil` marks the approval-wait/execution boundary.
+ */
+export function timingFor(state, toolUseId) {
+    const span = spanForTool(state, toolUseId);
+    if (!span)
+        return null;
+    return {
+        startedAt: span.waitUntil ?? span.startedAt,
+        ...(span.endedAt !== undefined ? { endedAt: span.endedAt } : {}),
+    };
+}
+//# sourceMappingURL=activity-store-helpers.js.map

package/dist/stores/activity-store-helpers.js.map

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