@schlessera/brain-ui-react 0.4.0

package/dist/hooks/use-websocket.js

@@ -0,0 +1,366 @@
+import { useEffect, useRef, useCallback } from "react";
+import { WSClient } from "../lib/ws-client.js";
+import { useConnectionStore } from "../stores/connection-store.js";
+import { useChatStore, activeChat } from "../stores/chat-store.js";
+import { useProviderStore } from "../stores/provider-store.js";
+import { getWsUrl } from "../lib/backend.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. The ask_user
+ * tool's input carries the questions and its output carries the JSON answer
+ * payload, so an answered question survives session resume (rendered in its
+ * chronological slot, collapsed) instead of vanishing.
+ */
+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);
+                exchange.answers = payload.answers;
+                exchange.annotations = payload.annotations;
+            }
+            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 function handleServerMessage(msg) {
+    const state = useChatStore.getState();
+    // Parallel-session demux (per-session buffers). Every frame is scoped by
+    // sessionId; a scoped frame lands in ITS session's buffer, so a background
+    // session's transcript keeps accumulating while another one is in view.
+    // Frames without a sessionId (legacy single-session servers, or a new
+    // session's pre-binding frames) apply to the buffer in view.
+    const frameSessionId = msg.sessionId;
+    if (frameSessionId) {
+        state.setRunState(frameSessionId, runStateForFrame(msg));
+    }
+    // Resolve the target buffer key for this frame.
+    let key;
+    if (!frameSessionId) {
+        key = state.activeSessionId; // null = the draft view
+    }
+    else if (state.buffers[frameSessionId]) {
+        key = frameSessionId;
+    }
+    else if (state.draft && (msg.type === "session_info" || msg.type === "result")) {
+        // A draft run just got its server identity: adopt the draft buffer.
+        state.bindDraftSession(frameSessionId);
+        key = frameSessionId;
+    }
+    else if (msg.type === "session_info" && frameSessionId === state.activeSessionId) {
+        // The ACTIVE session announced itself but has no buffer yet — the cold
+        // reattach case (PWA relaunch mid-turn; the server may skip the history
+        // frame when a first turn has no history yet). Materialize the buffer so
+        // this session_info and every following delta land instead of vanishing.
+        state.setActiveSession(frameSessionId);
+        key = frameSessionId;
+    }
+    else if (msg.type === "session_history") {
+        // History replay may create a buffer (cold resume / reattach).
+        key = frameSessionId;
+    }
+    else {
+        // Scoped frame for a session with no buffer (never opened, or evicted):
+        // the badge above is all we track. The transcript heals via
+        // session_resume when the user opens it.
+        return;
+    }
+    const buffer = () => {
+        const s = useChatStore.getState();
+        return key === null ? s.draft : s.buffers[key];
+    };
+    switch (msg.type) {
+        case "text_delta":
+            if (!buffer()?.isStreaming) {
+                state.startAssistantMessage(key);
+            }
+            state.appendText(key, msg.text);
+            break;
+        case "thinking_delta":
+            if (!buffer()?.isStreaming) {
+                state.startAssistantMessage(key);
+            }
+            state.appendThinking(key, msg.text);
+            break;
+        case "tool_use_start":
+            state.startToolCall(key, msg.toolUseId, msg.toolName);
+            break;
+        case "tool_input_delta":
+            state.appendToolInput(key, msg.partialJson);
+            break;
+        case "tool_use_complete":
+            state.completeToolCall(key, msg.toolUseId, msg.toolName, msg.input);
+            break;
+        case "tool_approval_request":
+            state.requestToolApproval(key, msg.toolUseId, msg.toolName, msg.input, msg.description);
+            break;
+        case "tool_result": {
+            state.setToolResult(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 = buffer();
+            if (chat?.askUser?.answers || chat?.askUser?.cancelled) {
+                state.clearAskUser(key);
+            }
+            break;
+        }
+        case "ask_user_request":
+            state.setAskUserRequest(key, msg.requestId, msg.questions);
+            break;
+        case "location_request":
+            requestBrowserLocation(msg);
+            break;
+        case "result":
+            state.finishAssistantMessage(key);
+            resyncIfNeeded(msg.sessionId);
+            break;
+        case "session_info": {
+            // bindDraftSession above 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 (frameSessionId && 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[frameSessionId];
+                if (chat && !chat.isStreaming && chat.messages.length === 0) {
+                    current.startAssistantMessage(frameSessionId);
+                }
+            }
+            break;
+        }
+        case "session_history": {
+            const converted = msg.messages.map(convertHistoryMessage);
+            if (msg.append) {
+                state.appendMessages(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.
+                state.setMessages(key, converted);
+                if (key !== null && key === resyncSessionId)
+                    resyncSessionId = null;
+                coldResumedSessionId = key;
+            }
+            break;
+        }
+        case "status": {
+            // Only finish streaming if this buffer actually started it
+            if ((msg.status === "idle" || msg.status === "cancelled") &&
+                buffer()?.isStreaming) {
+                state.finishAssistantMessage(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();
+                resyncIfNeeded(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 (!frameSessionId || frameSessionId === current.activeSessionId) {
+                    coldResumeIfNeeded(current.activeSessionId, activeChat(current).messages.length);
+                }
+            }
+            break;
+        }
+        case "error":
+            if (buffer()?.isStreaming) {
+                state.appendText(key, `\n\n**Error:** ${msg.message}`);
+                state.finishAssistantMessage(key);
+            }
+            break;
+    }
+}
+/**
+ * The server asked the browser for its location (the agent called
+ * `get_current_location`). Read `navigator.geolocation` and reply over the same
+ * requestId. The browser shows its own permission prompt on first use; a denial,
+ * timeout, or unavailable position comes back as a `location_error` that the
+ * server turns into a tool error for the agent.
+ */
+function requestBrowserLocation(msg) {
+    const { requestId } = msg;
+    if (typeof navigator === "undefined" || !navigator.geolocation) {
+        wsClient?.send({
+            type: "location_error",
+            requestId,
+            code: 0,
+            message: "Geolocation is not available in this browser.",
+        });
+        return;
+    }
+    const opts = msg.options ?? {};
+    navigator.geolocation.getCurrentPosition((pos) => {
+        wsClient?.send({
+            type: "location_response",
+            requestId,
+            coords: {
+                latitude: pos.coords.latitude,
+                longitude: pos.coords.longitude,
+                accuracy: pos.coords.accuracy,
+                altitude: pos.coords.altitude,
+                altitudeAccuracy: pos.coords.altitudeAccuracy,
+                heading: pos.coords.heading,
+                speed: pos.coords.speed,
+            },
+            timestamp: pos.timestamp,
+        });
+    }, (err) => {
+        wsClient?.send({
+            type: "location_error",
+            requestId,
+            code: err.code,
+            message: err.message || "Failed to retrieve location.",
+        });
+    }, {
+        enableHighAccuracy: opts.enableHighAccuracy ?? false,
+        timeout: opts.timeoutMs ?? 15000,
+        maximumAge: opts.maximumAgeMs ?? 60000,
+    });
+}
+// Reconnection bookkeeping: after a WS drop, the rendered transcript may have
+// gaps (deltas streamed while offline are lost). We heal by replaying the
+// authoritative session history — immediately if nothing is streaming, or
+// once the in-flight turn settles (result / idle status). The pending resync
+// is keyed to the session that needs healing (the one that was active at the
+// reconnect), so a background session settling first cannot consume it.
+let wasDisconnected = false;
+let resyncSessionId = null;
+function resyncIfNeeded(sessionId) {
+    if (!resyncSessionId || !sessionId || sessionId !== resyncSessionId)
+        return;
+    resyncSessionId = null;
+    wsClient?.send({ type: "session_resume", sessionId });
+}
+// A cold page / PWA relaunch restores only the stored session id, not the
+// transcript. The server pushes a snapshot on connect only while a session is
+// actively running; when it's idle (the common "agent finished while the phone
+// slept" case) nothing arrives, so the client must fetch the finished
+// session's history itself. Guarded to fire at most once per session id per
+// connection — an empty session would otherwise re-trigger on every idle
+// status and loop.
+let coldResumedSessionId = null;
+function coldResumeIfNeeded(sessionId, messageCount) {
+    if (!sessionId || messageCount > 0)
+        return;
+    if (coldResumedSessionId === sessionId)
+        return;
+    coldResumedSessionId = sessionId;
+    wsClient?.send({ type: "session_resume", sessionId });
+}
+function handleStatusChange(status) {
+    useConnectionStore.getState().setWsStatus(status);
+    if (status === "disconnected") {
+        wasDisconnected = true;
+        // Allow a fresh cold-resume attempt after we reconnect.
+        coldResumedSessionId = null;
+    }
+    else if (status === "connected" && wasDisconnected) {
+        wasDisconnected = false;
+        const chat = useChatStore.getState();
+        const active = activeChat(chat);
+        if (chat.activeSessionId && active.messages.length > 0) {
+            resyncSessionId = chat.activeSessionId;
+            // Not mid-stream: replay right away. Mid-stream: the flag holds until
+            // the running turn finishes (result or idle status).
+            if (!active.isStreaming) {
+                resyncIfNeeded(chat.activeSessionId);
+            }
+        }
+    }
+}
+// Singleton client - survives React re-renders
+let wsClient = null;
+export function useWebSocket() {
+    const initialized = useRef(false);
+    useEffect(() => {
+        if (initialized.current)
+            return;
+        initialized.current = true;
+        wsClient = new WSClient(getWsUrl(), handleServerMessage, handleStatusChange);
+        wsClient.connect();
+        // Skip the exponential backoff when the network demonstrably returns.
+        const reconnectNow = () => wsClient?.reconnectNow();
+        const onVisible = () => {
+            if (document.visibilityState === "visible")
+                wsClient?.reconnectNow();
+        };
+        window.addEventListener("online", reconnectNow);
+        document.addEventListener("visibilitychange", onVisible);
+        return () => {
+            window.removeEventListener("online", reconnectNow);
+            document.removeEventListener("visibilitychange", onVisible);
+            wsClient?.close();
+            wsClient = null;
+            initialized.current = false;
+        };
+    }, []);
+    const send = useCallback((msg) => {
+        wsClient?.send(msg);
+    }, []);
+    return { send };
+}
+//# sourceMappingURL=use-websocket.js.map

package/dist/hooks/use-websocket.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @schlessera/brain-ui-react — the chat UI as a component library.
+ *
+ * The deployment shell owns the document: index.html, the mount point, the
+ * Vite/PWA build, the service worker, and the theme entry (import ./theme.css
+ * into a Tailwind v4 build together with an @source pointing at this package's
+ * src, or use the precompiled ./styles.css export). The shell composes the
+ * pieces below and calls configureBrainUi() before mounting.
+ */
+export { configureBrainUi, uiConfig, type BrainUiConfig } from "./config.js";
+export { ConnectionGate } from "./components/connectivity/connection-gate.js";
+export { AppShell } from "./components/layout/app-shell.js";
+export { ChatPage } from "./components/chat/chat-page.js";
+export { BrainMarkdown } from "./components/chat/brain-markdown.js";
+export { useChatStore, activeChat, anyStreaming, type ChatKey, type ChatMessage, type SessionChat, type ToolCall, type AskUserExchange, type MessageAttachment, } from "./stores/chat-store.js";
+export { useFileStore } from "./stores/file-store.js";
+export { useUIStore } from "./stores/ui-store.js";
+export { useConnectionStore } from "./stores/connection-store.js";
+export { useProviderStore } from "./stores/provider-store.js";
+export { useVoiceStore } from "./voice/voice-store.js";
+export { useVpnStatus } from "./hooks/use-vpn-status.js";
+export { useWebSocket, handleServerMessage, runStateForFrame } from "./hooks/use-websocket.js";
+export { api } from "./lib/api-client.js";
+export { API_BASE, getWsUrl, getBackendUrl } from "./lib/backend.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAG7E,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAGpE,OAAO,EACL,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG/F,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+/**
+ * @schlessera/brain-ui-react — the chat UI as a component library.
+ *
+ * The deployment shell owns the document: index.html, the mount point, the
+ * Vite/PWA build, the service worker, and the theme entry (import ./theme.css
+ * into a Tailwind v4 build together with an @source pointing at this package's
+ * src, or use the precompiled ./styles.css export). The shell composes the
+ * pieces below and calls configureBrainUi() before mounting.
+ */
+// Branding / copy configuration (module singleton, set once at boot).
+export { configureBrainUi, uiConfig } from "./config.js";
+// Top-level surfaces the shell composes.
+export { ConnectionGate } from "./components/connectivity/connection-gate.js";
+export { AppShell } from "./components/layout/app-shell.js";
+export { ChatPage } from "./components/chat/chat-page.js";
+// Markdown renderer (also useful standalone, e.g. for a dev kitchen sink).
+export { BrainMarkdown } from "./components/chat/brain-markdown.js";
+// Stores + selectors the shell reads (service-worker busy check, deep links).
+export { useChatStore, activeChat, anyStreaming, } from "./stores/chat-store.js";
+export { useFileStore } from "./stores/file-store.js";
+export { useUIStore } from "./stores/ui-store.js";
+export { useConnectionStore } from "./stores/connection-store.js";
+export { useProviderStore } from "./stores/provider-store.js";
+export { useVoiceStore } from "./voice/voice-store.js";
+// Connectivity probes.
+export { useVpnStatus } from "./hooks/use-vpn-status.js";
+export { useWebSocket, handleServerMessage, runStateForFrame } from "./hooks/use-websocket.js";
+// API surface (typed REST client + backend URL helpers).
+export { api } from "./lib/api-client.js";
+export { API_BASE, getWsUrl, getBackendUrl } from "./lib/backend.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,sEAAsE;AACtE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAsB,MAAM,aAAa,CAAC;AAE7E,yCAAyC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,2EAA2E;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,8EAA8E;AAC9E,OAAO,EACL,YAAY,EACZ,UAAU,EACV,YAAY,GAOb,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,uBAAuB;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE/F,yDAAyD;AACzD,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/lib/api-client.d.ts

@@ -0,0 +1,115 @@
+import type { VoiceKeytermsResponse, VoiceTokenResponse, VoiceSessionResponse, PronunciationOverride, ProviderInfo, PasskeySummary } from "@schlessera/brain-ui-sdk/protocol";
+import type { AuthenticationResponseJSON, RegistrationResponseJSON, PublicKeyCredentialCreationOptionsJSON, PublicKeyCredentialRequestOptionsJSON } from "@simplewebauthn/browser";
+/** Backend id + capability flags the client renders behavior from. */
+export interface BackendInfo {
+    id: string;
+    capabilities: {
+        concurrentSessions: boolean;
+        followUp: boolean;
+        [key: string]: boolean;
+    };
+}
+export declare const api: {
+    health: () => Promise<{
+        status: string;
+        uptime: number;
+        version: string;
+    }>;
+    vpnCheck: () => Promise<{
+        vpn: boolean;
+    }>;
+    status: () => Promise<{
+        healthy: boolean;
+        uptime: number;
+        cronJobs: Array<{
+            name: string;
+            lastRunAt: number | null;
+            lastStatus: string | null;
+        }>;
+        activeSession: boolean;
+    }>;
+    brainSearch: (q: string, opts?: {
+        type?: string;
+        limit?: number;
+    }) => Promise<{
+        results: Array<{
+            path: string;
+            title: string;
+            snippet: string;
+            score: number;
+        }>;
+        warnings: string[];
+    }>;
+    brainBriefing: () => Promise<{
+        content: string;
+    }>;
+    brainStats: () => Promise<{
+        documents: number;
+        byType: Record<string, number>;
+        byStatus: Record<string, number>;
+        tags: number;
+        links: number;
+    }>;
+    brainSync: () => Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    brainAdd: (content: string, opts?: {
+        type?: string;
+        title?: string;
+        tags?: string[];
+    }) => Promise<{
+        success: boolean;
+    }>;
+    sessions: () => Promise<{
+        sessions: Array<{
+            id: string;
+            title: string | null;
+            createdAt: number;
+            lastActiveAt: number;
+        }>;
+    }>;
+    /** Mint a dictation session for the active speech provider. */
+    voiceSession: (signal?: AbortSignal) => Promise<VoiceSessionResponse>;
+    /** @deprecated use voiceSession(); kept during client transition. */
+    voiceToken: () => Promise<VoiceTokenResponse>;
+    voiceKeyterms: () => Promise<VoiceKeytermsResponse>;
+    voiceOverrides: (signal?: AbortSignal) => Promise<{
+        overrides: PronunciationOverride[];
+    }>;
+    providers: () => Promise<{
+        providers: ProviderInfo[];
+        backends?: Record<string, BackendInfo>;
+    }>;
+    /** Password-mode login. Resolves on success; throws the server error otherwise. */
+    login: (password: string) => Promise<{
+        ok: true;
+    }>;
+    logout: () => Promise<{
+        ok: true;
+    }>;
+    /** Which login methods the server offers (public; drives the login screen). */
+    authMethods: () => Promise<{
+        password: boolean;
+        passkey: boolean;
+    }>;
+    passkeyLoginOptions: () => Promise<PublicKeyCredentialRequestOptionsJSON>;
+    passkeyLoginVerify: (response: AuthenticationResponseJSON) => Promise<{
+        ok: true;
+    }>;
+    passkeyRegisterOptions: () => Promise<PublicKeyCredentialCreationOptionsJSON>;
+    passkeyRegisterVerify: (response: RegistrationResponseJSON, label?: string) => Promise<{
+        ok: true;
+        credential: PasskeySummary | null;
+    }>;
+    passkeyList: () => Promise<{
+        credentials: PasskeySummary[];
+    }>;
+    passkeyRename: (id: string, label: string) => Promise<{
+        ok: true;
+    }>;
+    passkeyDelete: (id: string) => Promise<{
+        ok: true;
+    }>;
+};
+//# sourceMappingURL=api-client.d.ts.map

package/dist/lib/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/lib/api-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EACV,0BAA0B,EAC1B,wBAAwB,EACxB,sCAAsC,EACtC,qCAAqC,EACtC,MAAM,yBAAyB,CAAC;AAEjC,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE;QACZ,kBAAkB,EAAE,OAAO,CAAC;QAC5B,QAAQ,EAAE,OAAO,CAAC;QAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAiBD,eAAO,MAAM,GAAG;;gBAEQ,MAAM;gBAAU,MAAM;iBAAW,MAAM;;;aAE5B,OAAO;;;iBAI3B,OAAO;gBACR,MAAM;kBACJ,KAAK,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;YACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;SAC3B,CAAC;uBACa,OAAO;;qBAGT,MAAM,SAAS;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;iBAEpD,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;kBACrE,MAAM,EAAE;;;iBAMC,MAAM;;;mBAId,MAAM;gBACT,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;kBACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;cAC1B,MAAM;eACL,MAAM;;;iBAIM,OAAO;iBAAW,MAAM;;wBAI3B,MAAM,SAAS;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;iBAC9D,OAAO;;;kBAOhB,KAAK,CAAC;YACd,EAAE,EAAE,MAAM,CAAC;YACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;YACrB,SAAS,EAAE,MAAM,CAAC;YAClB,YAAY,EAAE,MAAM,CAAC;SACtB,CAAC;;IAGN,+DAA+D;4BACvC,WAAW;IAGnC,qEAAqE;;;8BAM3C,WAAW;mBACZ,qBAAqB,EAAE;;;mBAMjC,YAAY,EAAE;mBACd,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;;IAG1C,mFAAmF;sBACjE,MAAM;YACN,IAAI;;;YAMJ,IAAI;;IAEtB,+EAA+E;;kBAEvD,OAAO;iBAAW,OAAO;;;mCAQlB,0BAA0B;YACvC,IAAI;;;sCAWY,wBAAwB,UAAU,MAAM;YACxD,IAAI;oBAAc,cAAc,GAAG,IAAI;;;qBAM9B,cAAc,EAAE;;wBAEvB,MAAM,SAAS,MAAM;YACvB,IAAI;;wBAKF,MAAM;YACR,IAAI;;CAGvB,CAAC"}

package/dist/lib/api-client.js

@@ -0,0 +1,70 @@
+import { API_BASE } from "./backend.js";
+async function fetchJson(path, init) {
+    const res = await fetch(`${API_BASE}${path}`, {
+        ...init,
+        headers: {
+            "Content-Type": "application/json",
+            ...init?.headers,
+        },
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({ error: res.statusText }));
+        throw new Error(body.error || `HTTP ${res.status}`);
+    }
+    return res.json();
+}
+export const api = {
+    health: () => fetchJson("/health"),
+    vpnCheck: () => fetchJson("/vpn-check"),
+    status: () => fetchJson("/status"),
+    brainSearch: (q, opts) => fetchJson(`/brain/search?q=${encodeURIComponent(q)}${opts?.type ? `&type=${opts.type}` : ""}${opts?.limit ? `&limit=${opts.limit}` : ""}`),
+    brainBriefing: () => fetchJson("/brain/briefing"),
+    brainStats: () => fetchJson("/brain/stats"),
+    brainSync: () => fetchJson("/brain/sync", {
+        method: "POST",
+    }),
+    brainAdd: (content, opts) => fetchJson("/brain/add", {
+        method: "POST",
+        body: JSON.stringify({ content, ...opts }),
+    }),
+    sessions: () => fetchJson("/sessions"),
+    /** Mint a dictation session for the active speech provider. */
+    voiceSession: (signal) => fetchJson("/voice/session", { method: "POST", signal }),
+    /** @deprecated use voiceSession(); kept during client transition. */
+    voiceToken: () => fetchJson("/voice/token", { method: "POST" }),
+    voiceKeyterms: () => fetchJson("/voice/keyterms"),
+    voiceOverrides: (signal) => fetchJson("/voice/overrides", {
+        signal,
+    }),
+    providers: () => fetchJson("/providers"),
+    /** Password-mode login. Resolves on success; throws the server error otherwise. */
+    login: (password) => fetchJson("/auth/login", {
+        method: "POST",
+        body: JSON.stringify({ password }),
+    }),
+    logout: () => fetchJson("/auth/logout", { method: "POST" }),
+    /** Which login methods the server offers (public; drives the login screen). */
+    authMethods: () => fetchJson("/auth/methods"),
+    passkeyLoginOptions: () => fetchJson("/auth/passkey/login-options", {
+        method: "POST",
+        body: "{}",
+    }),
+    passkeyLoginVerify: (response) => fetchJson("/auth/passkey/login-verify", {
+        method: "POST",
+        body: JSON.stringify(response),
+    }),
+    passkeyRegisterOptions: () => fetchJson("/auth/passkey/register-options", {
+        method: "POST",
+        body: "{}",
+    }),
+    passkeyRegisterVerify: (response, label) => fetchJson("/auth/passkey/register-verify", { method: "POST", body: JSON.stringify({ response, label }) }),
+    passkeyList: () => fetchJson("/auth/passkey/list"),
+    passkeyRename: (id, label) => fetchJson(`/auth/passkey/${encodeURIComponent(id)}`, {
+        method: "PUT",
+        body: JSON.stringify({ label }),
+    }),
+    passkeyDelete: (id) => fetchJson(`/auth/passkey/${encodeURIComponent(id)}`, {
+        method: "DELETE",
+    }),
+};
+//# sourceMappingURL=api-client.js.map

package/dist/lib/api-client.js.map

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