@btst/stack 2.3.0 → 2.5.0

package/dist/plugins/ai-chat/client/components/index.d.cts

@@ -1,4 +1,4 @@
-export { i as ChatInput, C as ChatInterface, e as ChatLayout, f as ChatLayoutProps, h as ChatMessage, g as ChatSidebar, j as ToolCallDisplay } from '../../../../shared/stack.DaOcgmrM.cjs';
+export { i as ChatInput, C as ChatInterface, e as ChatLayout, f as ChatLayoutProps, h as ChatMessage, g as ChatSidebar, j as ToolCallDisplay } from '../../../../shared/stack.BV9hnvu4.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { FallbackProps } from 'react-error-boundary';
 import 'ai';

package/dist/plugins/ai-chat/client/components/index.d.mts

@@ -1,4 +1,4 @@
-export { i as ChatInput, C as ChatInterface, e as ChatLayout, f as ChatLayoutProps, h as ChatMessage, g as ChatSidebar, j as ToolCallDisplay } from '../../../../shared/stack.DaOcgmrM.mjs';
+export { i as ChatInput, C as ChatInterface, e as ChatLayout, f as ChatLayoutProps, h as ChatMessage, g as ChatSidebar, j as ToolCallDisplay } from '../../../../shared/stack.BV9hnvu4.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { FallbackProps } from 'react-error-boundary';
 import 'ai';

package/dist/plugins/ai-chat/client/components/index.d.ts

@@ -1,4 +1,4 @@
-export { i as ChatInput, C as ChatInterface, e as ChatLayout, f as ChatLayoutProps, h as ChatMessage, g as ChatSidebar, j as ToolCallDisplay } from '../../../../shared/stack.DaOcgmrM.js';
+export { i as ChatInput, C as ChatInterface, e as ChatLayout, f as ChatLayoutProps, h as ChatMessage, g as ChatSidebar, j as ToolCallDisplay } from '../../../../shared/stack.BV9hnvu4.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { FallbackProps } from 'react-error-boundary';
 import 'ai';

package/dist/plugins/ai-chat/client/context/page-ai-context.cjs

@@ -0,0 +1,92 @@
+"use client";
+'use strict';
+
+const jsxRuntime = require('react/jsx-runtime');
+const React = require('react');
+
+const PageAIAPIContext = React.createContext(null);
+const PageAIVersionContext = React.createContext(0);
+function PageAIContextProvider({
+  children
+}) {
+  const registrationsRef = React.useRef(/* @__PURE__ */ new Map());
+  const insertionOrderRef = React.useRef([]);
+  const [version, setVersion] = React.useState(0);
+  const bumpVersion = React.useCallback(() => setVersion((v) => v + 1), []);
+  const register = React.useCallback(
+    (id, config) => {
+      registrationsRef.current.set(id, config);
+      insertionOrderRef.current = insertionOrderRef.current.filter(
+        (k) => k !== id
+      );
+      insertionOrderRef.current.push(id);
+      bumpVersion();
+    },
+    [bumpVersion]
+  );
+  const unregister = React.useCallback(
+    (id) => {
+      registrationsRef.current.delete(id);
+      insertionOrderRef.current = insertionOrderRef.current.filter(
+        (k) => k !== id
+      );
+      bumpVersion();
+    },
+    [bumpVersion]
+  );
+  const getActive = React.useCallback(() => {
+    const order = insertionOrderRef.current;
+    if (order.length === 0) return null;
+    const lastId = order[order.length - 1];
+    if (!lastId) return null;
+    return registrationsRef.current.get(lastId) ?? null;
+  }, []);
+  const api = React.useMemo(
+    () => ({ register, unregister, getActive }),
+    [register, unregister, getActive]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(PageAIAPIContext.Provider, { value: api, children: /* @__PURE__ */ jsxRuntime.jsx(PageAIVersionContext.Provider, { value: version, children }) });
+}
+function useRegisterPageAIContext(config) {
+  const ctx = React.useContext(PageAIAPIContext);
+  const id = React.useId();
+  const configRef = React.useRef(config);
+  configRef.current = config;
+  React.useEffect(() => {
+    if (!ctx || !configRef.current) return;
+    ctx.register(id, {
+      get routeName() {
+        return configRef.current?.routeName ?? "";
+      },
+      get pageDescription() {
+        return configRef.current?.pageDescription ?? "";
+      },
+      get suggestions() {
+        return configRef.current?.suggestions;
+      },
+      get clientTools() {
+        return configRef.current?.clientTools;
+      }
+    });
+    return () => {
+      ctx.unregister(id);
+    };
+  }, [
+    ctx,
+    id,
+    config === null,
+    config?.routeName,
+    config?.pageDescription,
+    JSON.stringify(config?.suggestions)
+  ]);
+}
+function usePageAIContext() {
+  React.useContext(PageAIVersionContext);
+  const ctx = React.useContext(PageAIAPIContext);
+  if (!ctx) return null;
+  return ctx.getActive();
+}
+
+exports.PageAIContextProvider = PageAIContextProvider;
+exports.usePageAIContext = usePageAIContext;
+exports.useRegisterPageAIContext = useRegisterPageAIContext;

package/dist/plugins/ai-chat/client/context/page-ai-context.d.cts

@@ -0,0 +1,84 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * A client-side tool handler — receives the AI's tool call args and returns a result.
+ * The result is sent back to the model so it can continue the conversation.
+ */
+type PageAIClientTool = (args: any) => Promise<{
+    success: boolean;
+    message?: string;
+}>;
+/**
+ * Configuration registered by a page to provide AI context and capabilities.
+ * Any component in the tree can call useRegisterPageAIContext with this config.
+ */
+interface PageAIContextConfig {
+    /**
+     * Identifier for the current route/page (e.g. "blog-post", "ui-builder-edit-page").
+     * Shown as a badge in the chat header.
+     */
+    routeName: string;
+    /**
+     * Human-readable description of the current page and its content.
+     * Injected into the AI system prompt so it understands what the user is looking at.
+     * Capped at 8,000 characters server-side.
+     */
+    pageDescription: string;
+    /**
+     * Optional suggested prompts shown as quick-action chips in the chat empty state.
+     * These augment (not replace) any static suggestions configured in plugin overrides.
+     */
+    suggestions?: string[];
+    /**
+     * Client-side tool handlers keyed by tool name.
+     * When the AI calls a tool by this name, the handler is invoked with the tool args.
+     * The result is sent back to the model via addToolResult.
+     *
+     * Tool schemas must be registered server-side via enablePageTools + clientToolSchemas
+     * in aiChatBackendPlugin (built-in tools like fillBlogForm are pre-registered).
+     */
+    clientTools?: Record<string, PageAIClientTool>;
+}
+/**
+ * Provider that enables route-aware AI context across the app.
+ *
+ * Place this at the root layout — above all StackProviders — so it spans
+ * both your main app tree and any chat modals rendered as parallel/intercept routes.
+ *
+ * @example
+ * // app/layout.tsx
+ * import { PageAIContextProvider } from "@btst/stack/plugins/ai-chat/client/context"
+ *
+ * export default function RootLayout({ children }) {
+ *   return <PageAIContextProvider>{children}</PageAIContextProvider>
+ * }
+ */
+declare function PageAIContextProvider({ children, }: {
+    children: React.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+/**
+ * Register page AI context from any component.
+ * The registration is cleaned up automatically when the component unmounts.
+ *
+ * Pass `null` to conditionally disable context (e.g. while data is loading).
+ *
+ * @example
+ * // Blog post page
+ * useRegisterPageAIContext(post ? {
+ *   routeName: "blog-post",
+ *   pageDescription: `Blog post: "${post.title}"\n\n${post.content?.slice(0, 16000)}`,
+ *   suggestions: ["Summarize this post", "What are the key takeaways?"],
+ * } : null)
+ */
+declare function useRegisterPageAIContext(config: PageAIContextConfig | null): void;
+/**
+ * Read the currently active page AI context.
+ * Returns null when no page has registered context, or when PageAIContextProvider
+ * is not in the tree.
+ *
+ * Used internally by ChatInterface to inject context into requests.
+ */
+declare function usePageAIContext(): PageAIContextConfig | null;
+
+export { PageAIContextProvider, usePageAIContext, useRegisterPageAIContext };
+export type { PageAIClientTool, PageAIContextConfig };

package/dist/plugins/ai-chat/client/context/page-ai-context.d.mts

@@ -0,0 +1,84 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * A client-side tool handler — receives the AI's tool call args and returns a result.
+ * The result is sent back to the model so it can continue the conversation.
+ */
+type PageAIClientTool = (args: any) => Promise<{
+    success: boolean;
+    message?: string;
+}>;
+/**
+ * Configuration registered by a page to provide AI context and capabilities.
+ * Any component in the tree can call useRegisterPageAIContext with this config.
+ */
+interface PageAIContextConfig {
+    /**
+     * Identifier for the current route/page (e.g. "blog-post", "ui-builder-edit-page").
+     * Shown as a badge in the chat header.
+     */
+    routeName: string;
+    /**
+     * Human-readable description of the current page and its content.
+     * Injected into the AI system prompt so it understands what the user is looking at.
+     * Capped at 8,000 characters server-side.
+     */
+    pageDescription: string;
+    /**
+     * Optional suggested prompts shown as quick-action chips in the chat empty state.
+     * These augment (not replace) any static suggestions configured in plugin overrides.
+     */
+    suggestions?: string[];
+    /**
+     * Client-side tool handlers keyed by tool name.
+     * When the AI calls a tool by this name, the handler is invoked with the tool args.
+     * The result is sent back to the model via addToolResult.
+     *
+     * Tool schemas must be registered server-side via enablePageTools + clientToolSchemas
+     * in aiChatBackendPlugin (built-in tools like fillBlogForm are pre-registered).
+     */
+    clientTools?: Record<string, PageAIClientTool>;
+}
+/**
+ * Provider that enables route-aware AI context across the app.
+ *
+ * Place this at the root layout — above all StackProviders — so it spans
+ * both your main app tree and any chat modals rendered as parallel/intercept routes.
+ *
+ * @example
+ * // app/layout.tsx
+ * import { PageAIContextProvider } from "@btst/stack/plugins/ai-chat/client/context"
+ *
+ * export default function RootLayout({ children }) {
+ *   return <PageAIContextProvider>{children}</PageAIContextProvider>
+ * }
+ */
+declare function PageAIContextProvider({ children, }: {
+    children: React.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+/**
+ * Register page AI context from any component.
+ * The registration is cleaned up automatically when the component unmounts.
+ *
+ * Pass `null` to conditionally disable context (e.g. while data is loading).
+ *
+ * @example
+ * // Blog post page
+ * useRegisterPageAIContext(post ? {
+ *   routeName: "blog-post",
+ *   pageDescription: `Blog post: "${post.title}"\n\n${post.content?.slice(0, 16000)}`,
+ *   suggestions: ["Summarize this post", "What are the key takeaways?"],
+ * } : null)
+ */
+declare function useRegisterPageAIContext(config: PageAIContextConfig | null): void;
+/**
+ * Read the currently active page AI context.
+ * Returns null when no page has registered context, or when PageAIContextProvider
+ * is not in the tree.
+ *
+ * Used internally by ChatInterface to inject context into requests.
+ */
+declare function usePageAIContext(): PageAIContextConfig | null;
+
+export { PageAIContextProvider, usePageAIContext, useRegisterPageAIContext };
+export type { PageAIClientTool, PageAIContextConfig };

package/dist/plugins/ai-chat/client/context/page-ai-context.d.ts

@@ -0,0 +1,84 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * A client-side tool handler — receives the AI's tool call args and returns a result.
+ * The result is sent back to the model so it can continue the conversation.
+ */
+type PageAIClientTool = (args: any) => Promise<{
+    success: boolean;
+    message?: string;
+}>;
+/**
+ * Configuration registered by a page to provide AI context and capabilities.
+ * Any component in the tree can call useRegisterPageAIContext with this config.
+ */
+interface PageAIContextConfig {
+    /**
+     * Identifier for the current route/page (e.g. "blog-post", "ui-builder-edit-page").
+     * Shown as a badge in the chat header.
+     */
+    routeName: string;
+    /**
+     * Human-readable description of the current page and its content.
+     * Injected into the AI system prompt so it understands what the user is looking at.
+     * Capped at 8,000 characters server-side.
+     */
+    pageDescription: string;
+    /**
+     * Optional suggested prompts shown as quick-action chips in the chat empty state.
+     * These augment (not replace) any static suggestions configured in plugin overrides.
+     */
+    suggestions?: string[];
+    /**
+     * Client-side tool handlers keyed by tool name.
+     * When the AI calls a tool by this name, the handler is invoked with the tool args.
+     * The result is sent back to the model via addToolResult.
+     *
+     * Tool schemas must be registered server-side via enablePageTools + clientToolSchemas
+     * in aiChatBackendPlugin (built-in tools like fillBlogForm are pre-registered).
+     */
+    clientTools?: Record<string, PageAIClientTool>;
+}
+/**
+ * Provider that enables route-aware AI context across the app.
+ *
+ * Place this at the root layout — above all StackProviders — so it spans
+ * both your main app tree and any chat modals rendered as parallel/intercept routes.
+ *
+ * @example
+ * // app/layout.tsx
+ * import { PageAIContextProvider } from "@btst/stack/plugins/ai-chat/client/context"
+ *
+ * export default function RootLayout({ children }) {
+ *   return <PageAIContextProvider>{children}</PageAIContextProvider>
+ * }
+ */
+declare function PageAIContextProvider({ children, }: {
+    children: React.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+/**
+ * Register page AI context from any component.
+ * The registration is cleaned up automatically when the component unmounts.
+ *
+ * Pass `null` to conditionally disable context (e.g. while data is loading).
+ *
+ * @example
+ * // Blog post page
+ * useRegisterPageAIContext(post ? {
+ *   routeName: "blog-post",
+ *   pageDescription: `Blog post: "${post.title}"\n\n${post.content?.slice(0, 16000)}`,
+ *   suggestions: ["Summarize this post", "What are the key takeaways?"],
+ * } : null)
+ */
+declare function useRegisterPageAIContext(config: PageAIContextConfig | null): void;
+/**
+ * Read the currently active page AI context.
+ * Returns null when no page has registered context, or when PageAIContextProvider
+ * is not in the tree.
+ *
+ * Used internally by ChatInterface to inject context into requests.
+ */
+declare function usePageAIContext(): PageAIContextConfig | null;
+
+export { PageAIContextProvider, usePageAIContext, useRegisterPageAIContext };
+export type { PageAIClientTool, PageAIContextConfig };

package/dist/plugins/ai-chat/client/context/page-ai-context.mjs

@@ -0,0 +1,88 @@
+"use client";
+import { jsx } from 'react/jsx-runtime';
+import { createContext, useRef, useState, useCallback, useMemo, useContext, useId, useEffect } from 'react';
+
+const PageAIAPIContext = createContext(null);
+const PageAIVersionContext = createContext(0);
+function PageAIContextProvider({
+  children
+}) {
+  const registrationsRef = useRef(/* @__PURE__ */ new Map());
+  const insertionOrderRef = useRef([]);
+  const [version, setVersion] = useState(0);
+  const bumpVersion = useCallback(() => setVersion((v) => v + 1), []);
+  const register = useCallback(
+    (id, config) => {
+      registrationsRef.current.set(id, config);
+      insertionOrderRef.current = insertionOrderRef.current.filter(
+        (k) => k !== id
+      );
+      insertionOrderRef.current.push(id);
+      bumpVersion();
+    },
+    [bumpVersion]
+  );
+  const unregister = useCallback(
+    (id) => {
+      registrationsRef.current.delete(id);
+      insertionOrderRef.current = insertionOrderRef.current.filter(
+        (k) => k !== id
+      );
+      bumpVersion();
+    },
+    [bumpVersion]
+  );
+  const getActive = useCallback(() => {
+    const order = insertionOrderRef.current;
+    if (order.length === 0) return null;
+    const lastId = order[order.length - 1];
+    if (!lastId) return null;
+    return registrationsRef.current.get(lastId) ?? null;
+  }, []);
+  const api = useMemo(
+    () => ({ register, unregister, getActive }),
+    [register, unregister, getActive]
+  );
+  return /* @__PURE__ */ jsx(PageAIAPIContext.Provider, { value: api, children: /* @__PURE__ */ jsx(PageAIVersionContext.Provider, { value: version, children }) });
+}
+function useRegisterPageAIContext(config) {
+  const ctx = useContext(PageAIAPIContext);
+  const id = useId();
+  const configRef = useRef(config);
+  configRef.current = config;
+  useEffect(() => {
+    if (!ctx || !configRef.current) return;
+    ctx.register(id, {
+      get routeName() {
+        return configRef.current?.routeName ?? "";
+      },
+      get pageDescription() {
+        return configRef.current?.pageDescription ?? "";
+      },
+      get suggestions() {
+        return configRef.current?.suggestions;
+      },
+      get clientTools() {
+        return configRef.current?.clientTools;
+      }
+    });
+    return () => {
+      ctx.unregister(id);
+    };
+  }, [
+    ctx,
+    id,
+    config === null,
+    config?.routeName,
+    config?.pageDescription,
+    JSON.stringify(config?.suggestions)
+  ]);
+}
+function usePageAIContext() {
+  useContext(PageAIVersionContext);
+  const ctx = useContext(PageAIAPIContext);
+  if (!ctx) return null;
+  return ctx.getActive();
+}
+
+export { PageAIContextProvider, usePageAIContext, useRegisterPageAIContext };

package/dist/plugins/ai-chat/client/hooks/index.d.cts

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { f as ConversationWithMessages } from '../../../../shared/stack.CMh_EdxW.cjs';
+import { f as ConversationWithMessages } from '../../../../shared/stack.D-b5zbPm.cjs';
 import { S as SerializedConversation } from '../../../../shared/stack.Be1QIHEn.cjs';
 export { a as SerializedMessage } from '../../../../shared/stack.Be1QIHEn.cjs';
 import '@btst/stack/plugins/client';

package/dist/plugins/ai-chat/client/hooks/index.d.mts

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { f as ConversationWithMessages } from '../../../../shared/stack.Dg09R0oB.mjs';
+import { f as ConversationWithMessages } from '../../../../shared/stack.FVWf2JhZ.mjs';
 import { S as SerializedConversation } from '../../../../shared/stack.Be1QIHEn.mjs';
 export { a as SerializedMessage } from '../../../../shared/stack.Be1QIHEn.mjs';
 import '@btst/stack/plugins/client';

package/dist/plugins/ai-chat/client/hooks/index.d.ts

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { f as ConversationWithMessages } from '../../../../shared/stack.BeSm90va.js';
+import { f as ConversationWithMessages } from '../../../../shared/stack.CTDVxbrA.js';
 import { S as SerializedConversation } from '../../../../shared/stack.Be1QIHEn.js';
 export { a as SerializedMessage } from '../../../../shared/stack.Be1QIHEn.js';
 import '@btst/stack/plugins/client';

package/dist/plugins/ai-chat/client/index.d.cts

@@ -3,8 +3,8 @@ import * as react from 'react';
 import * as _btst_yar from '@btst/yar';
 import { QueryClient } from '@tanstack/react-query';
 import { S as SerializedConversation, a as SerializedMessage } from '../../../shared/stack.Be1QIHEn.cjs';
-import { A as AiChatMode } from '../../../shared/stack.DaOcgmrM.cjs';
-export { a as AiChatPluginOverrides, b as AllowedFileType, i as ChatInput, C as ChatInterface, e as ChatLayout, f as ChatLayoutProps, h as ChatMessage, g as ChatSidebar, D as DEFAULT_ALLOWED_FILE_TYPES, j as ToolCallDisplay, T as ToolCallProps, d as ToolCallRenderer, c as ToolCallState } from '../../../shared/stack.DaOcgmrM.cjs';
+import { A as AiChatMode } from '../../../shared/stack.BV9hnvu4.cjs';
+export { a as AiChatPluginOverrides, b as AllowedFileType, i as ChatInput, C as ChatInterface, e as ChatLayout, f as ChatLayoutProps, h as ChatMessage, g as ChatSidebar, D as DEFAULT_ALLOWED_FILE_TYPES, j as ToolCallDisplay, T as ToolCallProps, d as ToolCallRenderer, c as ToolCallState } from '../../../shared/stack.BV9hnvu4.cjs';
 export { UIMessage } from 'ai';
 import 'react/jsx-runtime';
 
@@ -83,31 +83,31 @@ interface AiChatClientConfig {
  */
 interface AiChatClientHooks {
     /**
-     * Called before loading conversations list. Return false to cancel loading.
+     * Called before loading conversations list. Throw an error to cancel loading.
      * @param context - Loader context with path, params, etc.
      */
-    beforeLoadConversations?: (context: LoaderContext) => Promise<boolean> | boolean;
+    beforeLoadConversations?: (context: LoaderContext) => Promise<void> | void;
     /**
-     * Called after conversations are loaded. Return false to cancel further processing.
+     * Called after conversations are loaded. Throw an error to cancel further processing.
      * @param conversations - Array of loaded conversations or null
      * @param context - Loader context
      */
-    afterLoadConversations?: (conversations: SerializedConversation[] | null, context: LoaderContext) => Promise<boolean> | boolean;
+    afterLoadConversations?: (conversations: SerializedConversation[] | null, context: LoaderContext) => Promise<void> | void;
     /**
-     * Called before loading a single conversation. Return false to cancel loading.
+     * Called before loading a single conversation. Throw an error to cancel loading.
      * @param id - Conversation ID being loaded
      * @param context - Loader context
      */
-    beforeLoadConversation?: (id: string, context: LoaderContext) => Promise<boolean> | boolean;
+    beforeLoadConversation?: (id: string, context: LoaderContext) => Promise<void> | void;
     /**
-     * Called after a conversation is loaded. Return false to cancel further processing.
+     * Called after a conversation is loaded. Throw an error to cancel further processing.
      * @param conversation - Loaded conversation or null if not found
      * @param id - Conversation ID that was requested
      * @param context - Loader context
      */
     afterLoadConversation?: (conversation: (SerializedConversation & {
         messages: SerializedMessage[];
-    }) | null, id: string, context: LoaderContext) => Promise<boolean> | boolean;
+    }) | null, id: string, context: LoaderContext) => Promise<void> | void;
     /**
      * Called when a loading error occurs
      * @param error - The error that occurred

package/dist/plugins/ai-chat/client/index.d.mts

@@ -3,8 +3,8 @@ import * as react from 'react';
 import * as _btst_yar from '@btst/yar';
 import { QueryClient } from '@tanstack/react-query';
 import { S as SerializedConversation, a as SerializedMessage } from '../../../shared/stack.Be1QIHEn.mjs';
-import { A as AiChatMode } from '../../../shared/stack.DaOcgmrM.mjs';
-export { a as AiChatPluginOverrides, b as AllowedFileType, i as ChatInput, C as ChatInterface, e as ChatLayout, f as ChatLayoutProps, h as ChatMessage, g as ChatSidebar, D as DEFAULT_ALLOWED_FILE_TYPES, j as ToolCallDisplay, T as ToolCallProps, d as ToolCallRenderer, c as ToolCallState } from '../../../shared/stack.DaOcgmrM.mjs';
+import { A as AiChatMode } from '../../../shared/stack.BV9hnvu4.mjs';
+export { a as AiChatPluginOverrides, b as AllowedFileType, i as ChatInput, C as ChatInterface, e as ChatLayout, f as ChatLayoutProps, h as ChatMessage, g as ChatSidebar, D as DEFAULT_ALLOWED_FILE_TYPES, j as ToolCallDisplay, T as ToolCallProps, d as ToolCallRenderer, c as ToolCallState } from '../../../shared/stack.BV9hnvu4.mjs';
 export { UIMessage } from 'ai';
 import 'react/jsx-runtime';
 
@@ -83,31 +83,31 @@ interface AiChatClientConfig {
  */
 interface AiChatClientHooks {
     /**
-     * Called before loading conversations list. Return false to cancel loading.
+     * Called before loading conversations list. Throw an error to cancel loading.
      * @param context - Loader context with path, params, etc.
      */
-    beforeLoadConversations?: (context: LoaderContext) => Promise<boolean> | boolean;
+    beforeLoadConversations?: (context: LoaderContext) => Promise<void> | void;
     /**
-     * Called after conversations are loaded. Return false to cancel further processing.
+     * Called after conversations are loaded. Throw an error to cancel further processing.
      * @param conversations - Array of loaded conversations or null
      * @param context - Loader context
      */
-    afterLoadConversations?: (conversations: SerializedConversation[] | null, context: LoaderContext) => Promise<boolean> | boolean;
+    afterLoadConversations?: (conversations: SerializedConversation[] | null, context: LoaderContext) => Promise<void> | void;
     /**
-     * Called before loading a single conversation. Return false to cancel loading.
+     * Called before loading a single conversation. Throw an error to cancel loading.
      * @param id - Conversation ID being loaded
      * @param context - Loader context
      */
-    beforeLoadConversation?: (id: string, context: LoaderContext) => Promise<boolean> | boolean;
+    beforeLoadConversation?: (id: string, context: LoaderContext) => Promise<void> | void;
     /**
-     * Called after a conversation is loaded. Return false to cancel further processing.
+     * Called after a conversation is loaded. Throw an error to cancel further processing.
      * @param conversation - Loaded conversation or null if not found
      * @param id - Conversation ID that was requested
      * @param context - Loader context
      */
     afterLoadConversation?: (conversation: (SerializedConversation & {
         messages: SerializedMessage[];
-    }) | null, id: string, context: LoaderContext) => Promise<boolean> | boolean;
+    }) | null, id: string, context: LoaderContext) => Promise<void> | void;
     /**
      * Called when a loading error occurs
      * @param error - The error that occurred

package/dist/plugins/ai-chat/client/index.d.ts

@@ -3,8 +3,8 @@ import * as react from 'react';
 import * as _btst_yar from '@btst/yar';
 import { QueryClient } from '@tanstack/react-query';
 import { S as SerializedConversation, a as SerializedMessage } from '../../../shared/stack.Be1QIHEn.js';
-import { A as AiChatMode } from '../../../shared/stack.DaOcgmrM.js';
-export { a as AiChatPluginOverrides, b as AllowedFileType, i as ChatInput, C as ChatInterface, e as ChatLayout, f as ChatLayoutProps, h as ChatMessage, g as ChatSidebar, D as DEFAULT_ALLOWED_FILE_TYPES, j as ToolCallDisplay, T as ToolCallProps, d as ToolCallRenderer, c as ToolCallState } from '../../../shared/stack.DaOcgmrM.js';
+import { A as AiChatMode } from '../../../shared/stack.BV9hnvu4.js';
+export { a as AiChatPluginOverrides, b as AllowedFileType, i as ChatInput, C as ChatInterface, e as ChatLayout, f as ChatLayoutProps, h as ChatMessage, g as ChatSidebar, D as DEFAULT_ALLOWED_FILE_TYPES, j as ToolCallDisplay, T as ToolCallProps, d as ToolCallRenderer, c as ToolCallState } from '../../../shared/stack.BV9hnvu4.js';
 export { UIMessage } from 'ai';
 import 'react/jsx-runtime';
 
@@ -83,31 +83,31 @@ interface AiChatClientConfig {
  */
 interface AiChatClientHooks {
     /**
-     * Called before loading conversations list. Return false to cancel loading.
+     * Called before loading conversations list. Throw an error to cancel loading.
      * @param context - Loader context with path, params, etc.
      */
-    beforeLoadConversations?: (context: LoaderContext) => Promise<boolean> | boolean;
+    beforeLoadConversations?: (context: LoaderContext) => Promise<void> | void;
     /**
-     * Called after conversations are loaded. Return false to cancel further processing.
+     * Called after conversations are loaded. Throw an error to cancel further processing.
      * @param conversations - Array of loaded conversations or null
      * @param context - Loader context
      */
-    afterLoadConversations?: (conversations: SerializedConversation[] | null, context: LoaderContext) => Promise<boolean> | boolean;
+    afterLoadConversations?: (conversations: SerializedConversation[] | null, context: LoaderContext) => Promise<void> | void;
     /**
-     * Called before loading a single conversation. Return false to cancel loading.
+     * Called before loading a single conversation. Throw an error to cancel loading.
      * @param id - Conversation ID being loaded
      * @param context - Loader context
      */
-    beforeLoadConversation?: (id: string, context: LoaderContext) => Promise<boolean> | boolean;
+    beforeLoadConversation?: (id: string, context: LoaderContext) => Promise<void> | void;
     /**
-     * Called after a conversation is loaded. Return false to cancel further processing.
+     * Called after a conversation is loaded. Throw an error to cancel further processing.
      * @param conversation - Loaded conversation or null if not found
      * @param id - Conversation ID that was requested
      * @param context - Loader context
      */
     afterLoadConversation?: (conversation: (SerializedConversation & {
         messages: SerializedMessage[];
-    }) | null, id: string, context: LoaderContext) => Promise<boolean> | boolean;
+    }) | null, id: string, context: LoaderContext) => Promise<void> | void;
     /**
      * Called when a loading error occurs
      * @param error - The error that occurred

package/dist/plugins/ai-chat/query-keys.d.cts

@@ -1,7 +1,7 @@
 import '@tanstack/react-query';
 import '@btst/stack/plugins/client';
 import '../../shared/stack.Be1QIHEn.cjs';
-export { f as ConversationWithMessages, c as createAiChatQueryKeys } from '../../shared/stack.CMh_EdxW.cjs';
+export { f as ConversationWithMessages, c as createAiChatQueryKeys } from '../../shared/stack.D-b5zbPm.cjs';
 import '@btst/stack/plugins/api';
 import 'better-call';
 import 'zod/v4/core';

package/dist/plugins/ai-chat/query-keys.d.mts

@@ -1,7 +1,7 @@
 import '@tanstack/react-query';
 import '@btst/stack/plugins/client';
 import '../../shared/stack.Be1QIHEn.mjs';
-export { f as ConversationWithMessages, c as createAiChatQueryKeys } from '../../shared/stack.Dg09R0oB.mjs';
+export { f as ConversationWithMessages, c as createAiChatQueryKeys } from '../../shared/stack.FVWf2JhZ.mjs';
 import '@btst/stack/plugins/api';
 import 'better-call';
 import 'zod/v4/core';