@agent-native/core 0.176.1 → 0.176.2-nightly-20260831184159

package/dist/client/setup-connections/useBuilderConnectCardController.d.ts

@@ -1,3 +1,4 @@
+import { type BuilderConnectFlow } from "../settings/useBuilderStatus.js";
 export interface BuilderConnectCardControllerOptions {
     title?: string;
     description?: string;
@@ -18,7 +19,7 @@ export interface BuilderConnectCardAction {
     label: "Connect Builder.io";
     pending: boolean;
     disabled: boolean;
-    onPress: () => void;
+    onPress: (provisionAccount?: boolean) => void;
 }
 export interface BuilderConnectCardViewModel {
     title: string;
@@ -28,6 +29,7 @@ export interface BuilderConnectCardViewModel {
     pending: boolean;
     error: string | null;
     orgName: string | null;
+    connectFlow?: BuilderConnectFlow;
     action: BuilderConnectCardAction | null;
 }
 export declare function useBuilderConnectCardController({ title, description, trackingSource, onConnected, }?: BuilderConnectCardControllerOptions): BuilderConnectCardViewModel;

package/dist/client/setup-connections/useBuilderConnectCardController.js

@@ -1,15 +1,16 @@
 import { useCallback } from "react";
-import { useBuilderConnectFlow } from "../settings/useBuilderStatus.js";
+import { useBuilderConnectFlow, } from "../settings/useBuilderStatus.js";
 const DEFAULT_TITLE = "Builder connect";
 const DEFAULT_DESCRIPTION = "Connect Builder.io for managed model access, browser automation, and workspace identity. Free tier available.";
 const DEFAULT_TRACKING_SOURCE = "setup_connections_page";
 export function useBuilderConnectCardController({ title = DEFAULT_TITLE, description = DEFAULT_DESCRIPTION, trackingSource = DEFAULT_TRACKING_SOURCE, onConnected, } = {}) {
     const handleConnected = useCallback(({ orgName }) => onConnected?.(orgName), [onConnected]);
     const flow = useBuilderConnectFlow({
+        provisionAccount: true,
         trackingSource,
         onConnected: handleConnected,
     });
-    const handlePress = useCallback(() => flow.start(), [flow.start]);
+    const handlePress = useCallback((provisionAccount = false) => flow.start({ provisionAccount }), [flow.start]);
     const status = !flow.hasFetchedStatus
         ? { kind: "checking", label: "Checking" }
         : flow.configured
@@ -26,6 +27,7 @@ export function useBuilderConnectCardController({ title = DEFAULT_TITLE, descrip
         pending: flow.connecting,
         error: flow.error,
         orgName: flow.orgName,
+        connectFlow: flow,
         action: flow.configured
             ? null
             : {

package/dist/client/sse-event-processor.js

@@ -484,6 +484,14 @@ function isAutoRecoverableError(ev, errMsg) {
     // flag re-POSTs the exact chain the server just refused to continue.
     if (ev.recoverable === false)
         return false;
+    // These messages can carry `recoverable: true` for banner rendering, but
+    // repeating the request would retry the same rejected credential or a run
+    // the user already stopped.
+    if (msg.includes("the provider rejected the credential used for this request") ||
+        msg.includes("stopped before finishing") ||
+        msg.includes("stopped before it finished")) {
+        return false;
+    }
     if (code === "context_length_exceeded" ||
         code === "input_too_long" ||
         code.startsWith("credits-limit") ||

package/dist/client/terminal/AgentTerminal.js

@@ -218,13 +218,12 @@ export function AgentTerminal({ command, flags, wsUrl: wsUrlProp, hideInFrame =
                 }
             }
             // Build WebSocket URL with query params
-            const qs = new URLSearchParams();
-            if (resolvedCommand)
-                qs.set("command", resolvedCommand);
+            const fullWsUrl = new URL(wsUrl);
+            if (resolvedCommand) {
+                fullWsUrl.searchParams.set("command", resolvedCommand);
+            }
             if (flags)
-                qs.set("flags", flags);
-            const qsStr = qs.toString();
-            const fullWsUrl = qsStr ? `${wsUrl}?${qsStr}` : wsUrl;
+                fullWsUrl.searchParams.set("flags", flags);
             term.write(`\x1b[2m[terminal] Starting ${resolvedCommand || "CLI"}...\x1b[0m\r\n`);
             // Connect WebSocket
             let agentRunning = false;
@@ -355,7 +354,7 @@ export function AgentTerminal({ command, flags, wsUrl: wsUrlProp, hideInFrame =
             const initialRequest = pendingSubmitRequestRef.current;
             if (initialRequest)
                 submitPrompt(initialRequest);
-            connect(fullWsUrl);
+            connect(fullWsUrl.toString());
             // Store cleanup references
             return () => {
                 disposed = true;

package/dist/client/transcription/BuilderTranscriptionCta.js

@@ -7,76 +7,24 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * Drop this next to transcript displays in any template.
  */
 import { IconBolt, IconLoader2 } from "@tabler/icons-react";
-import { useCallback, useEffect, useRef, useState } from "react";
-import { agentNativePath } from "../api-path.js";
-import { openBuilderConnectPopup } from "../settings/useBuilderStatus.js";
-import { usePollLoop } from "../use-poll-loop.js";
-const POLL_TIMEOUT_MS = 5 * 60 * 1000;
+import { BuilderConnectPopover } from "../settings/BuilderConnectPopover.js";
+import { useBuilderConnectFlow } from "../settings/useBuilderStatus.js";
 export function BuilderTranscriptionCta() {
-    const [configured, setConfigured] = useState(null);
-    const [connectUrl, setConnectUrl] = useState(null);
-    const [connecting, setConnecting] = useState(false);
-    const [error, setError] = useState(null);
-    const connectStartedAtRef = useRef(null);
-    const mountedRef = useRef(true);
-    useEffect(() => {
-        mountedRef.current = true;
-        fetch(agentNativePath("/_agent-native/builder/status"))
-            .then((r) => r.ok
-            ? r.json()
-            : null)
-            .then((s) => {
-            if (!mountedRef.current)
-                return;
-            // Env-managed mode counts as configured for the CTA — the deploy
-            // already routes transcription through Builder, no per-user prompt.
-            setConfigured(!!(s?.configured || s?.envManaged));
-            setConnectUrl(s?.connectUrl || null);
-        })
-            .catch(() => {
-            if (mountedRef.current)
-                setConfigured(false);
-        });
-        return () => {
-            mountedRef.current = false;
-        };
-    }, []);
-    const handleConnect = useCallback(() => {
-        connectStartedAtRef.current = Date.now();
-        setConnecting(true);
-        setError(null);
-        openBuilderConnectPopup({
-            url: connectUrl ?? undefined,
-            source: "builder_transcription_cta",
-        });
-    }, [connectUrl]);
-    usePollLoop(async (signal) => {
-        const started = connectStartedAtRef.current;
-        if (started == null)
-            return;
-        const r = await fetch(agentNativePath("/_agent-native/builder/status"), {
-            signal,
-        });
-        if (!r.ok || !mountedRef.current)
-            return;
-        const s = (await r.json());
-        if (!mountedRef.current)
-            return;
-        if (s.configured) {
-            connectStartedAtRef.current = null;
-            setConfigured(true);
-            setConnecting(false);
-        }
-        else if (Date.now() - started > POLL_TIMEOUT_MS) {
-            connectStartedAtRef.current = null;
-            setConnecting(false);
-            setError("Didn't hear back from Builder. Allow popups and try again.");
-        }
-    }, { intervalMs: 2000, leading: false, enabled: connecting });
-    // Already connected or still loading — render nothing
-    if (configured === null || configured)
+    const flow = useBuilderConnectFlow({
+        provisionAccount: true,
+        trackingSource: "builder_transcription_cta",
+        trackingFlow: "transcription",
+    });
+    const configured = flow.statusResolved
+        ? flow.configured || flow.envManaged
+        : null;
+    const statusUnavailable = flow.hasFetchedStatus && !flow.statusResolved;
+    // Keep a retry path visible after an unreadable status response.
+    if (configured || (configured === null && !statusUnavailable))
         return null;
-    return (_jsxs("div", { className: "flex items-center gap-2 rounded-md border border-border/50 bg-muted/30 px-3 py-2 text-xs text-muted-foreground", children: [_jsx(IconBolt, { size: 14, className: "shrink-0 text-muted-foreground/70", "aria-hidden": "true" }), _jsx("span", { className: "flex-1", children: connecting
+    return (_jsxs("div", { className: "flex items-center gap-2 rounded-md border border-border/50 bg-muted/30 px-3 py-2 text-xs text-muted-foreground", children: [_jsx(IconBolt, { size: 14, className: "shrink-0 text-muted-foreground/70", "aria-hidden": "true" }), _jsx("span", { className: "flex-1", children: flow.connecting
                     ? "Waiting for Builder.io…"
-                    : "Connect Builder.io for higher-quality transcription — free credits, no API key needed." }), error ? (_jsx("span", { className: "text-destructive text-[10px]", children: error })) : connecting ? (_jsx(IconLoader2, { size: 12, className: "shrink-0 animate-spin" })) : (_jsx("button", { type: "button", onClick: handleConnect, className: "ml-auto shrink-0 inline-flex items-center gap-1 rounded bg-foreground px-2 py-1 text-[10px] font-semibold text-background hover:opacity-90 transition-opacity", children: "Connect" }))] }));
+                    : statusUnavailable
+                        ? "Builder status unavailable. Try again."
+                        : "Connect Builder.io for higher-quality transcription — free credits, no API key needed." }), flow.error && (_jsx("span", { className: "text-destructive text-[10px]", children: flow.error })), flow.connecting ? (_jsx(IconLoader2, { size: 12, className: "shrink-0 animate-spin" })) : (_jsx(BuilderConnectPopover, { flow: flow, children: _jsx("button", { type: "button", disabled: flow.connecting, className: "ml-auto shrink-0 inline-flex items-center gap-1 rounded bg-foreground px-2 py-1 text-[10px] font-semibold text-background transition-opacity hover:opacity-90 disabled:cursor-wait disabled:opacity-60", children: statusUnavailable || flow.error ? "Retry" : "Connect" }) }))] }));
 }

package/dist/client/ui/index.d.ts

@@ -11,6 +11,7 @@ export { getClientSurface, type ClientSurface } from "../client-surface.js";
 export { ErrorBoundary } from "../ErrorBoundary.js";
 export { ClientOnly } from "../ClientOnly.js";
 export { DefaultSpinner } from "../DefaultSpinner.js";
+export { Spinner } from "@agent-native/toolkit/ui/spinner";
 export { RuntimeConfigNotice } from "../RuntimeConfigNotice.js";
 export { EnvironmentBadge, buildEnvironmentUrl, isBuilderIoEmployee, resolveEnvironmentChannel, resolveEnvironmentTargets, type EnvironmentBadgeTargets, } from "../EnvironmentBadge.js";
 export { RouteTransitionIndicator, ROUTE_TRANSITION_INDICATOR_DELAY_MS, } from "../RouteTransitionIndicator.js";

package/dist/client/ui/index.js

@@ -11,6 +11,7 @@ export { getClientSurface } from "../client-surface.js";
 export { ErrorBoundary } from "../ErrorBoundary.js";
 export { ClientOnly } from "../ClientOnly.js";
 export { DefaultSpinner } from "../DefaultSpinner.js";
+export { Spinner } from "@agent-native/toolkit/ui/spinner";
 export { RuntimeConfigNotice } from "../RuntimeConfigNotice.js";
 export { EnvironmentBadge, buildEnvironmentUrl, isBuilderIoEmployee, resolveEnvironmentChannel, resolveEnvironmentTargets, } from "../EnvironmentBadge.js";
 export { RouteTransitionIndicator, ROUTE_TRANSITION_INDICATOR_DELAY_MS, } from "../RouteTransitionIndicator.js";

package/dist/client/use-chat-models.js

@@ -205,10 +205,11 @@ export function useChatModels({ storageKey = DEFAULT_STORAGE_KEY, enabled = true
                 // Default only to a CONFIGURED group, and to nothing when there is
                 // none. `DEFAULT_MODEL` is a builder-gateway id that no group carries
                 // unless Builder is connected, and unconfigured groups are kept in the
-                // list for their connect affordance — so both `?? DEFAULT_MODEL` and
-                // `?? groups[0]` yield a selection the app cannot route, which the
-                // server silently replaces with its own default. An empty selection
-                // hides the picker instead of showing a model that will not be used.
+                // list for their connect affordance where that is useful — so both
+                // `?? DEFAULT_MODEL` and `?? groups[0]` yield a selection the app
+                // cannot route, which the server silently replaces with its own
+                // default. An empty selection hides the picker instead of showing a
+                // model that will not be used.
                 const configuredGroups = groups.filter((g) => g.configured);
                 const resolveRoutableSelection = () => {
                     const group = configuredGroups.find((g) => g.models.includes(nextDefaultModel)) ?? configuredGroups[0];

package/dist/client/webmcp.d.ts

@@ -71,4 +71,8 @@ export interface AgentNativeWebMcpRegistration {
     start(): Promise<void>;
     stop(): void;
 }
+export declare function createAgentNativeServerActionWebMcpRegistration(options?: {
+    document?: Document;
+    fetch?: typeof fetch;
+}): AgentNativeWebMcpRegistration;
 export declare function createAgentNativeWebMcpRegistration(options: AgentNativeWebMcpRegistrationOptions): AgentNativeWebMcpRegistration;

package/dist/client/webmcp.js

@@ -234,6 +234,52 @@ export function createAgentNativeWebMcpClient(options = {}) {
     };
     return client;
 }
+export function createAgentNativeServerActionWebMcpRegistration(options) {
+    const fetchImpl = options?.fetch ?? ((...args) => fetch(...args));
+    return createAgentNativeWebMcpRegistration({
+        document: options?.document,
+        maxToolCount: 1_000,
+        maxDescriptionChars: 10_000,
+        actions: async () => {
+            const response = await fetchImpl("/_agent-native/webmcp/manifest", {
+                credentials: "same-origin",
+                headers: { Accept: "application/json" },
+            });
+            if (!response.ok) {
+                throw new Error(`Unable to load WebMCP actions (${response.status})`);
+            }
+            const manifest = (await response.json());
+            if (!Array.isArray(manifest)) {
+                throw new Error("WebMCP action manifest must be an array");
+            }
+            return manifest.map((action) => ({
+                name: action.name,
+                description: action.description,
+                ...(action.inputSchema ? { schema: action.inputSchema } : {}),
+                ...(action.readOnly ? { readOnly: true } : {}),
+                run: async (args, runtime) => {
+                    const result = await fetchImpl(`/_agent-native/webmcp/actions/${encodeURIComponent(action.name)}`, {
+                        method: "POST",
+                        credentials: "same-origin",
+                        headers: {
+                            Accept: "application/json",
+                            "Content-Type": "application/json",
+                        },
+                        body: JSON.stringify(args),
+                        ...(runtime.signal ? { signal: runtime.signal } : {}),
+                    });
+                    const body = await result.json();
+                    if (!result.ok) {
+                        throw new Error(isRecord(body) && typeof body.error === "string"
+                            ? body.error
+                            : `WebMCP action failed (${result.status})`);
+                    }
+                    return body;
+                },
+            }));
+        },
+    });
+}
 function resolveActions(actions) {
     return Promise.resolve(typeof actions === "function" ? actions() : actions).then((value) => {
         if (!Array.isArray(value)) {
@@ -271,7 +317,7 @@ function actionManifest(action) {
 function actionInputSchema(action) {
     return action.schema ?? action.parameters ?? EMPTY_INPUT_SCHEMA;
 }
-function actionRuntime(options, context, session) {
+function actionRuntime(options, context, session, signal) {
     const origin = options.origin ?? "agent-native-webmcp";
     const runCommand = async (command, payload) => {
         const handler = options.commands?.[command] ??
@@ -281,6 +327,7 @@ function actionRuntime(options, context, session) {
         return handler({ command, payload, origin }, undefined);
     };
     return {
+        ...(signal ? { signal } : {}),
         origin,
         context,
         session,
@@ -381,7 +428,7 @@ export function createAgentNativeWebMcpRegistration(options) {
                             : {}),
                     },
                     execute: async (input, executionOptions) => {
-                        if (executionOptions.signal.aborted) {
+                        if (executionOptions?.signal.aborted) {
                             throw new Error(`WebMCP action "${action.name}" was aborted`);
                         }
                         validateBoundedJson(input, `WebMCP action "${action.name}" input`, options.maxInputChars ?? DEFAULT_INPUT_CHARS);
@@ -417,8 +464,8 @@ export function createAgentNativeWebMcpRegistration(options) {
                                 throw new Error(`WebMCP action "${action.name}" was not approved`);
                             }
                         }
-                        const result = await action.run(input, actionRuntime(options, context, session));
-                        if (executionOptions.signal.aborted) {
+                        const result = await action.run(input, actionRuntime(options, context, session, executionOptions?.signal));
+                        if (executionOptions?.signal.aborted) {
                             throw new Error(`WebMCP action "${action.name}" was aborted`);
                         }
                         return serializeWebMcpResult(result, `WebMCP action "${action.name}" result`, options.maxResultChars ?? DEFAULT_RESULT_CHARS);

package/dist/collab/client.d.ts

@@ -54,6 +54,15 @@ export interface UseCollaborativeDocOptions {
     /** Current user info for cursor labels. */
     user?: CollabUser;
 }
+export type CollabInitializationErrorCategory = "forbidden-or-not-found" | "server" | "network" | "invalid-payload";
+export type CollabInitializationState = {
+    status: "loading";
+} | {
+    status: "ready";
+} | {
+    status: "error";
+    category: CollabInitializationErrorCategory;
+};
 export interface UseCollaborativeDocResult {
     /** The Yjs document instance. Stable per docId — never changes identity. */
     ydoc: Y.Doc | null;
@@ -63,6 +72,10 @@ export interface UseCollaborativeDocResult {
     isLoading: boolean;
     /** Whether the doc is synced with the server. */
     isSynced: boolean;
+    /** Typed initial-state outcome. A document is writable only when ready. */
+    initialization: CollabInitializationState;
+    /** Retry a failed initial-state read. No transport starts until it succeeds. */
+    retry: () => void;
     /** Active users on this document (from awareness). */
     activeUsers: CollabUser[];
     /** True briefly when the AI agent makes an edit (for presence indicator). */

package/dist/collab/client.js

@@ -167,6 +167,7 @@ function scheduleAwarenessPush(baseUrl, docId, clientId, getState) {
 const EMPTY_SNAPSHOT = Object.freeze({
     isLoading: false,
     isSynced: false,
+    initialization: { status: "loading" },
     activeUsers: [],
     agentActive: false,
     agentPresent: false,
@@ -232,6 +233,7 @@ class CollabDocConnection {
         this.snapshot = {
             isLoading: true,
             isSynced: false,
+            initialization: { status: "loading" },
             activeUsers: [],
             agentActive: false,
             agentPresent: false,
@@ -458,7 +460,10 @@ class CollabDocConnection {
         // storm that gets worse as more people join the doc). Only active once a
         // local user identity has been published (matches the previous per-hook
         // gating on `user`). The poll cycle remains the authoritative baseline.
-        if (this.lastSetUser && origin === "local" && !this.disposed) {
+        if (this.lastSetUser &&
+            this.snapshot.isSynced &&
+            origin === "local" &&
+            !this.disposed) {
             scheduleAwarenessPush(this.baseUrl, this.docId, this.ydoc.clientID, () => this.awareness.getLocalState());
         }
     };
@@ -466,8 +471,10 @@ class CollabDocConnection {
     // Startup: initial state fetch, update handler, sync loops
     // -------------------------------------------------------------------------
     start() {
-        this.attachUpdateHandler();
         this.fetchInitialState();
+    }
+    startTransport() {
+        this.attachUpdateHandler();
         this.startSync();
         // SSE fast-path for awareness: listen on the SHARED framework transport
         // and apply awareness-change events immediately so peers receive cursor
@@ -483,44 +490,97 @@ class CollabDocConnection {
         });
     }
     fetchInitialState() {
-        fetch(`${this.baseUrl}/${this.docId}/state`)
-            .then(async (res) => {
+        fetch(`${this.baseUrl}/${this.docId}/state`).then(async (res) => {
             if (this.disposed)
                 return;
             if (res.status === 404 || res.status === 403) {
-                this.markDocMissing();
+                this.markInitializationFailed("forbidden-or-not-found");
+                return;
+            }
+            if (!res.ok) {
+                this.markInitializationFailed("server");
                 return;
             }
             const data = (await res.json().catch(() => null));
             if (this.disposed)
                 return;
-            if (data?.state) {
-                const binary = base64ToUint8Array(data.state);
-                if (binary.length > 4) {
+            if (typeof data?.state !== "string" || data.state.length === 0) {
+                this.markInitializationFailed("invalid-payload");
+                return;
+            }
+            if (data.state) {
+                try {
+                    const binary = base64ToUint8Array(data.state);
+                    // Y.applyUpdate is not transactional: a malformed update can
+                    // mutate a document before throwing. Validate against a disposable
+                    // document so retries always start from the last authoritative
+                    // live state.
+                    const validationDoc = new Y.Doc();
+                    try {
+                        Y.applyUpdate(validationDoc, binary, "remote");
+                    }
+                    finally {
+                        validationDoc.destroy();
+                    }
                     Y.applyUpdate(this.ydoc, binary, "remote");
                 }
+                catch {
+                    this.markInitializationFailed("invalid-payload");
+                    return;
+                }
             }
-            this.setSnapshot({ isLoading: false, isSynced: true });
-        })
-            .catch(() => {
+            this.setSnapshot({
+                isLoading: false,
+                isSynced: true,
+                initialization: { status: "ready" },
+            });
+            this.startTransport();
+        }, () => {
             if (this.disposed)
                 return;
-            this.setSnapshot({ isLoading: false, isSynced: true });
+            this.markInitializationFailed("network");
         });
     }
     /**
-     * The initial state fetch returned 404/403 — the doc doesn't exist or isn't
-     * accessible. Stop doc-update traffic (poll loop, update POSTs, collab SSE
-     * handling) so we don't spam the console with errors against it. The
-     * awareness SSE subscription stays (matches previous behavior).
+     * A failed initial state must never turn an uninitialized Y.Doc into a
+     * writable empty document. Keep every outbound channel detached until an
+     * retry completes with a validated state payload.
      */
-    markDocMissing() {
+    markInitializationFailed(category) {
         this.docMissing = true;
-        this.flushPendingUpdates(true);
+        this.pendingUpdates = [];
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
         this.detachUpdateHandler();
         this.stopSync();
-        this.setSnapshot({ isLoading: false, isSynced: true });
+        this.unsubscribeAwarenessEvents?.();
+        this.unsubscribeAwarenessEvents = null;
+        this.setSnapshot({
+            isLoading: false,
+            isSynced: false,
+            initialization: { status: "error", category },
+        });
     }
+    retryInitialization() {
+        if (this.disposed)
+            return;
+        this.detachUpdateHandler();
+        this.stopSync();
+        this.unsubscribeAwarenessEvents?.();
+        this.unsubscribeAwarenessEvents = null;
+        this.docMissing = false;
+        this.setSnapshot({
+            isLoading: true,
+            isSynced: false,
+            initialization: { status: "loading" },
+        });
+        this.fetchInitialState();
+    }
+    retry = () => {
+        this.retryInitialization();
+    };
     // -------------------------------------------------------------------------
     // Local update batching
     // -------------------------------------------------------------------------
@@ -1016,10 +1076,25 @@ export function useCollaborativeDoc(options) {
         conn.setUser(resolvedUser);
     }, [conn, resolvedUser]);
     return {
-        ydoc: conn ? conn.ydoc : null,
-        awareness: conn ? conn.awareness : null,
+        // The document is authoritative only after a validated initial state has
+        // been applied. Hiding it while loading or failed also prevents a caller
+        // from contaminating a later retry with pre-initialization local edits.
+        ydoc: conn && snapshot.initialization.status === "ready" ? conn.ydoc : null,
+        awareness: conn && snapshot.initialization.status === "ready"
+            ? conn.awareness
+            : null,
         isLoading: snapshot.isLoading,
         isSynced: snapshot.isSynced,
+        initialization: snapshot.initialization,
+        retry: conn
+            ? () => {
+                if (conn.disposed) {
+                    setGeneration((current) => current + 1);
+                    return;
+                }
+                conn.retry();
+            }
+            : () => { },
         activeUsers: snapshot.activeUsers,
         agentActive: snapshot.agentActive,
         agentPresent: snapshot.agentPresent,

package/dist/dashboard-storage/index.d.ts

@@ -1,3 +1,3 @@
 export { createDashboardStorageSchema, type DashboardStorageSchema, type DashboardStorageSchemaOptions, } from "./schema.js";
-export { createDashboardStorage, DashboardStorageConflictError, type DashboardRecord, type DashboardRevisionRecord, type DashboardStorageOptions, type DashboardWriteInput, } from "./store.js";
+export { createDashboardStorage, DashboardStorageConflictError, type DashboardRecord, type DashboardRevisionChatContext, type DashboardRevisionMetadataRecord, type DashboardRevisionRecord, type DashboardStorageOptions, type DashboardWriteInput, } from "./store.js";
 export { createPanelSourceResolverRegistry, createProgramPanelSourceResolver, parseProgramPanelDescriptor, type DashboardPanelColumn, type PanelSourceFailure, type PanelSourceRequest, type PanelSourceResolver, type PanelSourceResolverRegistry, type PanelSourceResponse, type PanelSourceResult, type ProgramPanelContext, type ProgramPanelDescriptor, } from "./panel-source.js";

package/dist/dashboard-storage/schema.d.ts

@@ -414,6 +414,25 @@ export declare function createDashboardStorageSchema(options?: DashboardStorageS
             }, {}, {
                 length: number | undefined;
             }>;
+            chatContext: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                name: "chat_context";
+                tableName: string;
+                dataType: "string";
+                columnType: "SQLiteText";
+                data: string;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {
+                length: number | undefined;
+            }>;
         };
         dialect: 'sqlite';
     }>;

package/dist/dashboard-storage/schema.js

@@ -23,6 +23,7 @@ export function createDashboardStorageSchema(options = {}) {
         config: text("config").notNull(),
         createdAt: text("created_at").notNull().default(now()),
         createdBy: text("created_by"),
+        chatContext: text("chat_context"),
         ...ownableColumns(),
     }, (revision) => ({
         dashboardCreatedIdx: index(`${revisionsTable}_dashboard_created_idx`).on(revision.dashboardId, revision.createdAt),

package/dist/dashboard-storage/store.d.ts

@@ -21,7 +21,14 @@ export interface DashboardRevisionRecord<TKind extends string = string, TConfig
     config: TConfig;
     createdAt: string;
     createdBy: string | null;
+    chatContext: DashboardRevisionChatContext | null;
 }
+export interface DashboardRevisionChatContext {
+    threadId?: string;
+    runId?: string;
+    turnId?: string;
+}
+export type DashboardRevisionMetadataRecord<TKind extends string = string> = Omit<DashboardRevisionRecord<TKind>, "config">;
 export interface DashboardWriteInput<TKind extends string = string, TConfig = Record<string, unknown>> {
     id: string;
     kind: TKind;
@@ -56,6 +63,8 @@ export declare function createDashboardStorage<TKind extends string = string, TC
     list: (ctx: AccessContext, archive?: "active" | "archived" | "all") => Promise<any>;
     write: (input: DashboardWriteInput<TKind, TConfig>, ctx: AccessContext) => Promise<DashboardRecord<TKind, TConfig>>;
     listRevisions: (id: string, ctx: AccessContext) => Promise<any>;
+    listRevisionMetadata: (id: string, ctx: AccessContext) => Promise<any>;
+    createRevisionSnapshot: (id: string, ctx: AccessContext, chatContext?: DashboardRevisionChatContext) => Promise<DashboardRecord<TKind, TConfig> | null>;
     restore: (id: string, revisionId: string, ctx: AccessContext) => Promise<DashboardRecord<TKind, TConfig> | null>;
     registerShareable: () => void;
 };