@btst/stack 4.1.0 → 4.2.0

package/dist/packages/stack/src/plugins/ai-chat/client/context/chat-analytics.mjs

@@ -0,0 +1,39 @@
+"use client";
+import { createContext, useContext, useRef, useCallback } from 'react';
+import { usePluginOverrides, useStack } from '@btst/stack/context';
+import { usePageAIContext } from '../../../../../../../plugins/ai-chat/client/context/page-ai-context.mjs';
+import { resolveAiChatMode } from '../overrides.mjs';
+
+const ChatAnalyticsPageKey = createContext(
+  void 0
+);
+function useChatAnalytics() {
+  const { onAnalyticsEvent } = usePluginOverrides("aiChat", {});
+  const { plugins } = useStack();
+  const pageKey = useContext(ChatAnalyticsPageKey);
+  const routeName = usePageAIContext()?.routeName;
+  const latest = useRef({
+    onAnalyticsEvent,
+    pageKey,
+    routeName,
+    mode: resolveAiChatMode(plugins?.aiChat?.config)
+  });
+  latest.current = {
+    onAnalyticsEvent,
+    pageKey,
+    routeName,
+    mode: resolveAiChatMode(plugins?.aiChat?.config)
+  };
+  return useCallback((event) => {
+    const { onAnalyticsEvent: callback, ...context } = latest.current;
+    try {
+      void Promise.resolve(callback?.({ ...context, ...event })).catch(
+        () => {
+        }
+      );
+    } catch {
+    }
+  }, []);
+}
+
+export { ChatAnalyticsPageKey, useChatAnalytics };

package/dist/packages/stack/src/plugins/ai-chat/client/plugin.cjs

@@ -307,7 +307,8 @@ function resolveAiChatClientPlugin(config) {
 const aiChatClientPlugin = (config = {}) => client.defineClientPlugin()({
   id: "aiChat",
   providerConfig: {
-    mode: config.mode ?? "authenticated"
+    mode: config.mode ?? "authenticated",
+    ...config.pageContent ? { pageContent: true } : {}
   },
   resolve: (runtime) => resolveAiChatClientPlugin({ ...config, runtime })
 });

package/dist/packages/stack/src/plugins/ai-chat/client/plugin.mjs

@@ -305,7 +305,8 @@ function resolveAiChatClientPlugin(config) {
 const aiChatClientPlugin = (config = {}) => defineClientPlugin()({
   id: "aiChat",
   providerConfig: {
-    mode: config.mode ?? "authenticated"
+    mode: config.mode ?? "authenticated",
+    ...config.pageContent ? { pageContent: true } : {}
   },
   resolve: (runtime) => resolveAiChatClientPlugin({ ...config, runtime })
 });

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

@@ -1,5 +1,5 @@
-import { c as Conversation, M as Message } from '../../../shared/stack.C4oVW2qK.cjs';
-export { n as AI_CHAT_OPERATION_INVENTORY, o as AI_CHAT_RAW_ESCAPE_HATCH_INVENTORY, k as AiChatAccess, j as AiChatApiRouter, h as AiChatBackendConfig, l as AiChatBackendHooks, A as AiChatIdentityPartition, p as AiChatOperationError, g as AiChatQueryKeys, m as ChatApiContext, q as ChatOperationInputSchema, r as ConversationOperationInputSchema, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput, U as UpdateConversationOperationInputSchema, i as aiChatBackendPlugin, d as aiChatIdentityKey, e as aiChatResources, f as createAiChatQueryKeys } from '../../../shared/stack.C4oVW2qK.cjs';
+import { c as Conversation, M as Message } from '../../../shared/stack.Dgt3MCtW.cjs';
+export { o as AI_CHAT_OPERATION_INVENTORY, p as AI_CHAT_RAW_ESCAPE_HATCH_INVENTORY, l as AiChatAccess, j as AiChatApiRouter, h as AiChatBackendConfig, m as AiChatBackendHooks, A as AiChatIdentityPartition, q as AiChatOperationError, k as AiChatPageContentConfig, g as AiChatQueryKeys, n as ChatApiContext, r as ChatOperationInputSchema, s as ConversationOperationInputSchema, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput, U as UpdateConversationOperationInputSchema, i as aiChatBackendPlugin, d as aiChatIdentityKey, e as aiChatResources, f as createAiChatQueryKeys } from '../../../shared/stack.Dgt3MCtW.cjs';
 import { DBAdapter } from '@btst/db';
 import '@btst/stack/plugins/client';
 import '@btst/stack/plugins/api';

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

@@ -1,5 +1,5 @@
-import { c as Conversation, M as Message } from '../../../shared/stack.B5yPgHsp.mjs';
-export { n as AI_CHAT_OPERATION_INVENTORY, o as AI_CHAT_RAW_ESCAPE_HATCH_INVENTORY, k as AiChatAccess, j as AiChatApiRouter, h as AiChatBackendConfig, l as AiChatBackendHooks, A as AiChatIdentityPartition, p as AiChatOperationError, g as AiChatQueryKeys, m as ChatApiContext, q as ChatOperationInputSchema, r as ConversationOperationInputSchema, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput, U as UpdateConversationOperationInputSchema, i as aiChatBackendPlugin, d as aiChatIdentityKey, e as aiChatResources, f as createAiChatQueryKeys } from '../../../shared/stack.B5yPgHsp.mjs';
+import { c as Conversation, M as Message } from '../../../shared/stack.B7Mj74BQ.mjs';
+export { o as AI_CHAT_OPERATION_INVENTORY, p as AI_CHAT_RAW_ESCAPE_HATCH_INVENTORY, l as AiChatAccess, j as AiChatApiRouter, h as AiChatBackendConfig, m as AiChatBackendHooks, A as AiChatIdentityPartition, q as AiChatOperationError, k as AiChatPageContentConfig, g as AiChatQueryKeys, n as ChatApiContext, r as ChatOperationInputSchema, s as ConversationOperationInputSchema, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput, U as UpdateConversationOperationInputSchema, i as aiChatBackendPlugin, d as aiChatIdentityKey, e as aiChatResources, f as createAiChatQueryKeys } from '../../../shared/stack.B7Mj74BQ.mjs';
 import { DBAdapter } from '@btst/db';
 import '@btst/stack/plugins/client';
 import '@btst/stack/plugins/api';

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

@@ -1,5 +1,5 @@
-import { c as Conversation, M as Message } from '../../../shared/stack.3Sr6qRtT.js';
-export { n as AI_CHAT_OPERATION_INVENTORY, o as AI_CHAT_RAW_ESCAPE_HATCH_INVENTORY, k as AiChatAccess, j as AiChatApiRouter, h as AiChatBackendConfig, l as AiChatBackendHooks, A as AiChatIdentityPartition, p as AiChatOperationError, g as AiChatQueryKeys, m as ChatApiContext, q as ChatOperationInputSchema, r as ConversationOperationInputSchema, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput, U as UpdateConversationOperationInputSchema, i as aiChatBackendPlugin, d as aiChatIdentityKey, e as aiChatResources, f as createAiChatQueryKeys } from '../../../shared/stack.3Sr6qRtT.js';
+import { c as Conversation, M as Message } from '../../../shared/stack.DBH1Bjko.js';
+export { o as AI_CHAT_OPERATION_INVENTORY, p as AI_CHAT_RAW_ESCAPE_HATCH_INVENTORY, l as AiChatAccess, j as AiChatApiRouter, h as AiChatBackendConfig, m as AiChatBackendHooks, A as AiChatIdentityPartition, q as AiChatOperationError, k as AiChatPageContentConfig, g as AiChatQueryKeys, n as ChatApiContext, r as ChatOperationInputSchema, s as ConversationOperationInputSchema, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput, U as UpdateConversationOperationInputSchema, i as aiChatBackendPlugin, d as aiChatIdentityKey, e as aiChatResources, f as createAiChatQueryKeys } from '../../../shared/stack.DBH1Bjko.js';
 import { DBAdapter } from '@btst/db';
 import '@btst/stack/plugins/client';
 import '@btst/stack/plugins/api';

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

@@ -1,8 +1,9 @@
-export { j as ChatInput, C as ChatInterface, f as ChatLayout, g as ChatLayoutProps, i as ChatMessage, h as ChatSidebar, k as ToolCallDisplay } from '../../../../shared/stack.rVF0f509.cjs';
+export { j as ChatInput, C as ChatInterface, f as ChatLayout, g as ChatLayoutProps, i as ChatMessage, h as ChatSidebar, k as ToolCallDisplay } from '../../../../shared/stack.xAiy2VtO.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { FallbackProps } from 'react-error-boundary';
 import 'ai';
 import 'react';
+import '../context/page-ai-context.cjs';
 
 interface ChatPageComponentProps {
     conversationId?: string;

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

@@ -1,8 +1,9 @@
-export { j as ChatInput, C as ChatInterface, f as ChatLayout, g as ChatLayoutProps, i as ChatMessage, h as ChatSidebar, k as ToolCallDisplay } from '../../../../shared/stack.rVF0f509.mjs';
+export { j as ChatInput, C as ChatInterface, f as ChatLayout, g as ChatLayoutProps, i as ChatMessage, h as ChatSidebar, k as ToolCallDisplay } from '../../../../shared/stack.C5FZr-jJ.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { FallbackProps } from 'react-error-boundary';
 import 'ai';
 import 'react';
+import '../context/page-ai-context.mjs';
 
 interface ChatPageComponentProps {
     conversationId?: string;

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

@@ -1,8 +1,9 @@
-export { j as ChatInput, C as ChatInterface, f as ChatLayout, g as ChatLayoutProps, i as ChatMessage, h as ChatSidebar, k as ToolCallDisplay } from '../../../../shared/stack.rVF0f509.js';
+export { j as ChatInput, C as ChatInterface, f as ChatLayout, g as ChatLayoutProps, i as ChatMessage, h as ChatSidebar, k as ToolCallDisplay } from '../../../../shared/stack.C-eQN_Jt.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { FallbackProps } from 'react-error-boundary';
 import 'ai';
 import 'react';
+import '../context/page-ai-context.js';
 
 interface ChatPageComponentProps {
     conversationId?: string;

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

@@ -6,6 +6,7 @@ const React = require('react');
 
 const PageAIAPIContext = React.createContext(null);
 const PageAIVersionContext = React.createContext(0);
+const PageAIContextScope = React.createContext(void 0);
 function PageAIContextProvider({
   children
 }) {
@@ -83,10 +84,13 @@ function useRegisterPageAIContext(config) {
 function usePageAIContext() {
   React.useContext(PageAIVersionContext);
   const ctx = React.useContext(PageAIAPIContext);
+  const scoped = React.useContext(PageAIContextScope);
+  if (scoped !== void 0) return scoped;
   if (!ctx) return null;
   return ctx.getActive();
 }
 
 exports.PageAIContextProvider = PageAIContextProvider;
+exports.PageAIContextScope = PageAIContextScope;
 exports.usePageAIContext = usePageAIContext;
 exports.useRegisterPageAIContext = useRegisterPageAIContext;

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

@@ -1,4 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React$1 from 'react';
 
 /**
  * A client-side tool handler — receives the AI's tool call args and returns a result.
@@ -21,7 +22,8 @@ interface PageAIContextConfig {
     /**
      * 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.
+     * Limited to 16,000 characters server-side. For longer content, pass a page
+     * path and configure the backend pageContent resolver.
      */
     pageDescription: string;
     /**
@@ -39,6 +41,8 @@ interface PageAIContextConfig {
      */
     clientTools?: Record<string, PageAIClientTool>;
 }
+/** Instance-local context used by ChatLayout; undefined inherits page registrations. */
+declare const PageAIContextScope: React$1.Context<PageAIContextConfig | null | undefined>;
 /**
  * Provider that enables route-aware AI context across the app.
  *
@@ -80,5 +84,5 @@ declare function useRegisterPageAIContext(config: PageAIContextConfig | null): v
  */
 declare function usePageAIContext(): PageAIContextConfig | null;
 
-export { PageAIContextProvider, usePageAIContext, useRegisterPageAIContext };
+export { PageAIContextProvider, PageAIContextScope, usePageAIContext, useRegisterPageAIContext };
 export type { PageAIClientTool, PageAIContextConfig };

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

@@ -1,4 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React$1 from 'react';
 
 /**
  * A client-side tool handler — receives the AI's tool call args and returns a result.
@@ -21,7 +22,8 @@ interface PageAIContextConfig {
     /**
      * 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.
+     * Limited to 16,000 characters server-side. For longer content, pass a page
+     * path and configure the backend pageContent resolver.
      */
     pageDescription: string;
     /**
@@ -39,6 +41,8 @@ interface PageAIContextConfig {
      */
     clientTools?: Record<string, PageAIClientTool>;
 }
+/** Instance-local context used by ChatLayout; undefined inherits page registrations. */
+declare const PageAIContextScope: React$1.Context<PageAIContextConfig | null | undefined>;
 /**
  * Provider that enables route-aware AI context across the app.
  *
@@ -80,5 +84,5 @@ declare function useRegisterPageAIContext(config: PageAIContextConfig | null): v
  */
 declare function usePageAIContext(): PageAIContextConfig | null;
 
-export { PageAIContextProvider, usePageAIContext, useRegisterPageAIContext };
+export { PageAIContextProvider, PageAIContextScope, usePageAIContext, useRegisterPageAIContext };
 export type { PageAIClientTool, PageAIContextConfig };

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

@@ -1,4 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React$1 from 'react';
 
 /**
  * A client-side tool handler — receives the AI's tool call args and returns a result.
@@ -21,7 +22,8 @@ interface PageAIContextConfig {
     /**
      * 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.
+     * Limited to 16,000 characters server-side. For longer content, pass a page
+     * path and configure the backend pageContent resolver.
      */
     pageDescription: string;
     /**
@@ -39,6 +41,8 @@ interface PageAIContextConfig {
      */
     clientTools?: Record<string, PageAIClientTool>;
 }
+/** Instance-local context used by ChatLayout; undefined inherits page registrations. */
+declare const PageAIContextScope: React$1.Context<PageAIContextConfig | null | undefined>;
 /**
  * Provider that enables route-aware AI context across the app.
  *
@@ -80,5 +84,5 @@ declare function useRegisterPageAIContext(config: PageAIContextConfig | null): v
  */
 declare function usePageAIContext(): PageAIContextConfig | null;
 
-export { PageAIContextProvider, usePageAIContext, useRegisterPageAIContext };
+export { PageAIContextProvider, PageAIContextScope, usePageAIContext, useRegisterPageAIContext };
 export type { PageAIClientTool, PageAIContextConfig };

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

@@ -4,6 +4,7 @@ import { createContext, useRef, useState, useCallback, useMemo, useContext, useI
 
 const PageAIAPIContext = createContext(null);
 const PageAIVersionContext = createContext(0);
+const PageAIContextScope = createContext(void 0);
 function PageAIContextProvider({
   children
 }) {
@@ -81,8 +82,10 @@ function useRegisterPageAIContext(config) {
 function usePageAIContext() {
   useContext(PageAIVersionContext);
   const ctx = useContext(PageAIAPIContext);
+  const scoped = useContext(PageAIContextScope);
+  if (scoped !== void 0) return scoped;
   if (!ctx) return null;
   return ctx.getActive();
 }
 
-export { PageAIContextProvider, usePageAIContext, useRegisterPageAIContext };
+export { PageAIContextProvider, PageAIContextScope, usePageAIContext, useRegisterPageAIContext };

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

@@ -1,7 +1,7 @@
 import { UseMutationResult } from '@tanstack/react-query';
 import { ResourceFormResult } from '@btst/stack/plugins/client/hooks';
-import { A as AiChatIdentityPartition, S as SerializedConversation, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput } from '../../../../shared/stack.C4oVW2qK.cjs';
-export { a as SerializedMessage } from '../../../../shared/stack.C4oVW2qK.cjs';
+import { A as AiChatIdentityPartition, S as SerializedConversation, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput } from '../../../../shared/stack.Dgt3MCtW.cjs';
+export { a as SerializedMessage } from '../../../../shared/stack.Dgt3MCtW.cjs';
 import '@btst/stack/plugins/client';
 import '@btst/stack/plugins/api';
 import '@btst/stack/authorization';

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

@@ -1,7 +1,7 @@
 import { UseMutationResult } from '@tanstack/react-query';
 import { ResourceFormResult } from '@btst/stack/plugins/client/hooks';
-import { A as AiChatIdentityPartition, S as SerializedConversation, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput } from '../../../../shared/stack.B5yPgHsp.mjs';
-export { a as SerializedMessage } from '../../../../shared/stack.B5yPgHsp.mjs';
+import { A as AiChatIdentityPartition, S as SerializedConversation, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput } from '../../../../shared/stack.B7Mj74BQ.mjs';
+export { a as SerializedMessage } from '../../../../shared/stack.B7Mj74BQ.mjs';
 import '@btst/stack/plugins/client';
 import '@btst/stack/plugins/api';
 import '@btst/stack/authorization';

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

@@ -1,7 +1,7 @@
 import { UseMutationResult } from '@tanstack/react-query';
 import { ResourceFormResult } from '@btst/stack/plugins/client/hooks';
-import { A as AiChatIdentityPartition, S as SerializedConversation, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput } from '../../../../shared/stack.3Sr6qRtT.js';
-export { a as SerializedMessage } from '../../../../shared/stack.3Sr6qRtT.js';
+import { A as AiChatIdentityPartition, S as SerializedConversation, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput } from '../../../../shared/stack.DBH1Bjko.js';
+export { a as SerializedMessage } from '../../../../shared/stack.DBH1Bjko.js';
 import '@btst/stack/plugins/client';
 import '@btst/stack/plugins/api';
 import '@btst/stack/authorization';

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

@@ -2,9 +2,9 @@ import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import * as _btst_yar from '@btst/yar';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ComponentType } from 'react';
-import { S as SerializedConversation, a as SerializedMessage, A as AiChatIdentityPartition } from '../../../shared/stack.C4oVW2qK.cjs';
-import { A as AiChatMode, a as AiChatPluginOverrides } from '../../../shared/stack.rVF0f509.cjs';
-export { b as AiChatProviderConfig, c as AllowedFileType, j as ChatInput, C as ChatInterface, f as ChatLayout, g as ChatLayoutProps, i as ChatMessage, h as ChatSidebar, D as DEFAULT_ALLOWED_FILE_TYPES, k as ToolCallDisplay, T as ToolCallProps, e as ToolCallRenderer, d as ToolCallState } from '../../../shared/stack.rVF0f509.cjs';
+import { S as SerializedConversation, a as SerializedMessage, A as AiChatIdentityPartition } from '../../../shared/stack.Dgt3MCtW.cjs';
+import { A as AiChatMode, a as AiChatPluginOverrides } from '../../../shared/stack.xAiy2VtO.cjs';
+export { l as AiChatAnalyticsEvent, b as AiChatProviderConfig, c as AllowedFileType, j as ChatInput, C as ChatInterface, f as ChatLayout, g as ChatLayoutProps, i as ChatMessage, h as ChatSidebar, D as DEFAULT_ALLOWED_FILE_TYPES, k as ToolCallDisplay, T as ToolCallProps, e as ToolCallRenderer, d as ToolCallState } from '../../../shared/stack.xAiy2VtO.cjs';
 export { UIMessage } from 'ai';
 import '@btst/stack/plugins/api';
 import '@btst/stack/authorization';
@@ -13,6 +13,7 @@ import '../permissions.cjs';
 import 'zod/v4/core';
 import 'better-call';
 import '@btst/stack/context';
+import './context/page-ai-context.cjs';
 
 /**
  * Context passed to route hooks
@@ -57,6 +58,8 @@ interface AiChatClientConfig {
      * @default 'authenticated'
      */
     mode?: AiChatMode;
+    /** Enable built-in readPage permission checks and compact status alongside backend pageContent. */
+    pageContent?: boolean;
     /** Optional SEO configuration for meta tags */
     seo?: {
         /** Site name for Open Graph tags */
@@ -152,6 +155,7 @@ declare const aiChatClientPlugin: (config?: AiChatClientConfig) => _btst_stack_p
         })[];
     }, _btst_yar.RouteMeta>;
 }, "aiChat", {
+    pageContent?: true | undefined;
     mode: AiChatMode;
 }, never>;
 

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

@@ -2,9 +2,9 @@ import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import * as _btst_yar from '@btst/yar';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ComponentType } from 'react';
-import { S as SerializedConversation, a as SerializedMessage, A as AiChatIdentityPartition } from '../../../shared/stack.B5yPgHsp.mjs';
-import { A as AiChatMode, a as AiChatPluginOverrides } from '../../../shared/stack.rVF0f509.mjs';
-export { b as AiChatProviderConfig, c as AllowedFileType, j as ChatInput, C as ChatInterface, f as ChatLayout, g as ChatLayoutProps, i as ChatMessage, h as ChatSidebar, D as DEFAULT_ALLOWED_FILE_TYPES, k as ToolCallDisplay, T as ToolCallProps, e as ToolCallRenderer, d as ToolCallState } from '../../../shared/stack.rVF0f509.mjs';
+import { S as SerializedConversation, a as SerializedMessage, A as AiChatIdentityPartition } from '../../../shared/stack.B7Mj74BQ.mjs';
+import { A as AiChatMode, a as AiChatPluginOverrides } from '../../../shared/stack.C5FZr-jJ.mjs';
+export { l as AiChatAnalyticsEvent, b as AiChatProviderConfig, c as AllowedFileType, j as ChatInput, C as ChatInterface, f as ChatLayout, g as ChatLayoutProps, i as ChatMessage, h as ChatSidebar, D as DEFAULT_ALLOWED_FILE_TYPES, k as ToolCallDisplay, T as ToolCallProps, e as ToolCallRenderer, d as ToolCallState } from '../../../shared/stack.C5FZr-jJ.mjs';
 export { UIMessage } from 'ai';
 import '@btst/stack/plugins/api';
 import '@btst/stack/authorization';
@@ -13,6 +13,7 @@ import '../permissions.mjs';
 import 'zod/v4/core';
 import 'better-call';
 import '@btst/stack/context';
+import './context/page-ai-context.mjs';
 
 /**
  * Context passed to route hooks
@@ -57,6 +58,8 @@ interface AiChatClientConfig {
      * @default 'authenticated'
      */
     mode?: AiChatMode;
+    /** Enable built-in readPage permission checks and compact status alongside backend pageContent. */
+    pageContent?: boolean;
     /** Optional SEO configuration for meta tags */
     seo?: {
         /** Site name for Open Graph tags */
@@ -152,6 +155,7 @@ declare const aiChatClientPlugin: (config?: AiChatClientConfig) => _btst_stack_p
         })[];
     }, _btst_yar.RouteMeta>;
 }, "aiChat", {
+    pageContent?: true | undefined;
     mode: AiChatMode;
 }, never>;
 

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

@@ -2,9 +2,9 @@ import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import * as _btst_yar from '@btst/yar';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ComponentType } from 'react';
-import { S as SerializedConversation, a as SerializedMessage, A as AiChatIdentityPartition } from '../../../shared/stack.3Sr6qRtT.js';
-import { A as AiChatMode, a as AiChatPluginOverrides } from '../../../shared/stack.rVF0f509.js';
-export { b as AiChatProviderConfig, c as AllowedFileType, j as ChatInput, C as ChatInterface, f as ChatLayout, g as ChatLayoutProps, i as ChatMessage, h as ChatSidebar, D as DEFAULT_ALLOWED_FILE_TYPES, k as ToolCallDisplay, T as ToolCallProps, e as ToolCallRenderer, d as ToolCallState } from '../../../shared/stack.rVF0f509.js';
+import { S as SerializedConversation, a as SerializedMessage, A as AiChatIdentityPartition } from '../../../shared/stack.DBH1Bjko.js';
+import { A as AiChatMode, a as AiChatPluginOverrides } from '../../../shared/stack.C-eQN_Jt.js';
+export { l as AiChatAnalyticsEvent, b as AiChatProviderConfig, c as AllowedFileType, j as ChatInput, C as ChatInterface, f as ChatLayout, g as ChatLayoutProps, i as ChatMessage, h as ChatSidebar, D as DEFAULT_ALLOWED_FILE_TYPES, k as ToolCallDisplay, T as ToolCallProps, e as ToolCallRenderer, d as ToolCallState } from '../../../shared/stack.C-eQN_Jt.js';
 export { UIMessage } from 'ai';
 import '@btst/stack/plugins/api';
 import '@btst/stack/authorization';
@@ -13,6 +13,7 @@ import '../permissions.js';
 import 'zod/v4/core';
 import 'better-call';
 import '@btst/stack/context';
+import './context/page-ai-context.js';
 
 /**
  * Context passed to route hooks
@@ -57,6 +58,8 @@ interface AiChatClientConfig {
      * @default 'authenticated'
      */
     mode?: AiChatMode;
+    /** Enable built-in readPage permission checks and compact status alongside backend pageContent. */
+    pageContent?: boolean;
     /** Optional SEO configuration for meta tags */
     seo?: {
         /** Site name for Open Graph tags */
@@ -152,6 +155,7 @@ declare const aiChatClientPlugin: (config?: AiChatClientConfig) => _btst_stack_p
         })[];
     }, _btst_yar.RouteMeta>;
 }, "aiChat", {
+    pageContent?: true | undefined;
     mode: AiChatMode;
 }, never>;
 

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

@@ -1,5 +1,5 @@
 import '@btst/stack/plugins/client';
-export { A as AiChatIdentityPartition, g as AiChatQueryKeys, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput, d as aiChatIdentityKey, e as aiChatResources, f as createAiChatQueryKeys } from '../../shared/stack.C4oVW2qK.cjs';
+export { A as AiChatIdentityPartition, g as AiChatQueryKeys, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput, d as aiChatIdentityKey, e as aiChatResources, f as createAiChatQueryKeys } from '../../shared/stack.Dgt3MCtW.cjs';
 import '@btst/stack/context';
 import '@btst/stack/plugins/api';
 import '@btst/stack/authorization';

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

@@ -1,5 +1,5 @@
 import '@btst/stack/plugins/client';
-export { A as AiChatIdentityPartition, g as AiChatQueryKeys, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput, d as aiChatIdentityKey, e as aiChatResources, f as createAiChatQueryKeys } from '../../shared/stack.B5yPgHsp.mjs';
+export { A as AiChatIdentityPartition, g as AiChatQueryKeys, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput, d as aiChatIdentityKey, e as aiChatResources, f as createAiChatQueryKeys } from '../../shared/stack.B7Mj74BQ.mjs';
 import '@btst/stack/context';
 import '@btst/stack/plugins/api';
 import '@btst/stack/authorization';

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

@@ -1,5 +1,5 @@
 import '@btst/stack/plugins/client';
-export { A as AiChatIdentityPartition, g as AiChatQueryKeys, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput, d as aiChatIdentityKey, e as aiChatResources, f as createAiChatQueryKeys } from '../../shared/stack.3Sr6qRtT.js';
+export { A as AiChatIdentityPartition, g as AiChatQueryKeys, C as ConversationWithMessages, b as CreateConversationInput, R as RenameConversationInput, d as aiChatIdentityKey, e as aiChatResources, f as createAiChatQueryKeys } from '../../shared/stack.DBH1Bjko.js';
 import '@btst/stack/context';
 import '@btst/stack/plugins/api';
 import '@btst/stack/authorization';

package/dist/plugins/blog/api/index.d.cts

@@ -1,10 +1,10 @@
-export { B as BLOG_QUERY_KEYS, i as BlogApiRouter, k as BlogBackendHooks, f as BlogBackendOptions, l as BlogCreateErrorContext, m as BlogCreateOperationContext, n as BlogCreateResultContext, o as BlogDeleteErrorContext, p as BlogDeleteOperationContext, q as BlogDeleteResultContext, r as BlogListErrorContext, s as BlogListOperationContext, t as BlogListResultContext, u as BlogNextPreviousErrorContext, v as BlogNextPreviousOperationContext, w as BlogNextPreviousResultContext, e as BlogRouteKey, x as BlogUpdateErrorContext, y as BlogUpdateOperationContext, z as BlogUpdateResultContext, C as CreatePostOperationInputSchema, N as NextPreviousPostsQuerySchema, P as PostListParams, j as PostListQuerySchema, c as PostListResult, S as SerializedNextPreviousPostsResult, A as SerializedPostListResult, U as UpdatePostOperationInputSchema, h as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.BOZRaVpu.cjs';
+export { B as BLOG_QUERY_KEYS, i as BlogApiRouter, k as BlogBackendHooks, f as BlogBackendOptions, l as BlogCreateErrorContext, m as BlogCreateOperationContext, n as BlogCreateResultContext, o as BlogDeleteErrorContext, p as BlogDeleteOperationContext, q as BlogDeleteResultContext, r as BlogListErrorContext, s as BlogListOperationContext, t as BlogListResultContext, u as BlogNextPreviousErrorContext, v as BlogNextPreviousOperationContext, w as BlogNextPreviousResultContext, e as BlogRouteKey, x as BlogUpdateErrorContext, y as BlogUpdateOperationContext, z as BlogUpdateResultContext, C as CreatePostOperationInputSchema, N as NextPreviousPostsQuerySchema, P as PostListParams, j as PostListQuerySchema, c as PostListResult, S as SerializedNextPreviousPostsResult, A as SerializedPostListResult, U as UpdatePostOperationInputSchema, h as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.Ce6V7eDj.cjs';
 import { DBAdapter } from '@btst/db';
 import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.Dsatjh0B.cjs';
 export { blogPermissions } from '../permissions.cjs';
 import '@btst/stack/plugins/client';
 import 'zod';
-import '../../../shared/stack.Csi-4Mgz.cjs';
+import '../../../shared/stack.CKc_Bais.cjs';
 import '@btst/stack/plugins/api';
 import '../../../authorization/index.cjs';
 import 'zod/v4/core';

package/dist/plugins/blog/api/index.d.mts

@@ -1,10 +1,10 @@
-export { B as BLOG_QUERY_KEYS, i as BlogApiRouter, k as BlogBackendHooks, f as BlogBackendOptions, l as BlogCreateErrorContext, m as BlogCreateOperationContext, n as BlogCreateResultContext, o as BlogDeleteErrorContext, p as BlogDeleteOperationContext, q as BlogDeleteResultContext, r as BlogListErrorContext, s as BlogListOperationContext, t as BlogListResultContext, u as BlogNextPreviousErrorContext, v as BlogNextPreviousOperationContext, w as BlogNextPreviousResultContext, e as BlogRouteKey, x as BlogUpdateErrorContext, y as BlogUpdateOperationContext, z as BlogUpdateResultContext, C as CreatePostOperationInputSchema, N as NextPreviousPostsQuerySchema, P as PostListParams, j as PostListQuerySchema, c as PostListResult, S as SerializedNextPreviousPostsResult, A as SerializedPostListResult, U as UpdatePostOperationInputSchema, h as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.Dvy7FmaA.mjs';
+export { B as BLOG_QUERY_KEYS, i as BlogApiRouter, k as BlogBackendHooks, f as BlogBackendOptions, l as BlogCreateErrorContext, m as BlogCreateOperationContext, n as BlogCreateResultContext, o as BlogDeleteErrorContext, p as BlogDeleteOperationContext, q as BlogDeleteResultContext, r as BlogListErrorContext, s as BlogListOperationContext, t as BlogListResultContext, u as BlogNextPreviousErrorContext, v as BlogNextPreviousOperationContext, w as BlogNextPreviousResultContext, e as BlogRouteKey, x as BlogUpdateErrorContext, y as BlogUpdateOperationContext, z as BlogUpdateResultContext, C as CreatePostOperationInputSchema, N as NextPreviousPostsQuerySchema, P as PostListParams, j as PostListQuerySchema, c as PostListResult, S as SerializedNextPreviousPostsResult, A as SerializedPostListResult, U as UpdatePostOperationInputSchema, h as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.CTneIW0u.mjs';
 import { DBAdapter } from '@btst/db';
 import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.Dsatjh0B.mjs';
 export { blogPermissions } from '../permissions.mjs';
 import '@btst/stack/plugins/client';
 import 'zod';
-import '../../../shared/stack.Csi-4Mgz.mjs';
+import '../../../shared/stack.CKc_Bais.mjs';
 import '@btst/stack/plugins/api';
 import '../../../authorization/index.mjs';
 import 'zod/v4/core';

package/dist/plugins/blog/api/index.d.ts

@@ -1,10 +1,10 @@
-export { B as BLOG_QUERY_KEYS, i as BlogApiRouter, k as BlogBackendHooks, f as BlogBackendOptions, l as BlogCreateErrorContext, m as BlogCreateOperationContext, n as BlogCreateResultContext, o as BlogDeleteErrorContext, p as BlogDeleteOperationContext, q as BlogDeleteResultContext, r as BlogListErrorContext, s as BlogListOperationContext, t as BlogListResultContext, u as BlogNextPreviousErrorContext, v as BlogNextPreviousOperationContext, w as BlogNextPreviousResultContext, e as BlogRouteKey, x as BlogUpdateErrorContext, y as BlogUpdateOperationContext, z as BlogUpdateResultContext, C as CreatePostOperationInputSchema, N as NextPreviousPostsQuerySchema, P as PostListParams, j as PostListQuerySchema, c as PostListResult, S as SerializedNextPreviousPostsResult, A as SerializedPostListResult, U as UpdatePostOperationInputSchema, h as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.DlBoNqYu.js';
+export { B as BLOG_QUERY_KEYS, i as BlogApiRouter, k as BlogBackendHooks, f as BlogBackendOptions, l as BlogCreateErrorContext, m as BlogCreateOperationContext, n as BlogCreateResultContext, o as BlogDeleteErrorContext, p as BlogDeleteOperationContext, q as BlogDeleteResultContext, r as BlogListErrorContext, s as BlogListOperationContext, t as BlogListResultContext, u as BlogNextPreviousErrorContext, v as BlogNextPreviousOperationContext, w as BlogNextPreviousResultContext, e as BlogRouteKey, x as BlogUpdateErrorContext, y as BlogUpdateOperationContext, z as BlogUpdateResultContext, C as CreatePostOperationInputSchema, N as NextPreviousPostsQuerySchema, P as PostListParams, j as PostListQuerySchema, c as PostListResult, S as SerializedNextPreviousPostsResult, A as SerializedPostListResult, U as UpdatePostOperationInputSchema, h as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.D5b9l24t.js';
 import { DBAdapter } from '@btst/db';
 import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.Dsatjh0B.js';
 export { blogPermissions } from '../permissions.js';
 import '@btst/stack/plugins/client';
 import 'zod';
-import '../../../shared/stack.Csi-4Mgz.js';
+import '../../../shared/stack.CKc_Bais.js';
 import '@btst/stack/plugins/api';
 import '../../../authorization/index.js';
 import 'zod/v4/core';

package/dist/plugins/blog/client/hooks/index.d.cts

@@ -1,9 +1,9 @@
-export { P as PostCreateInput, e as PostUpdateInput, p as UseNextPreviousPostsOptions, q as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, s as UseRecentPostsOptions, t as UseRecentPostsResult, l as useCreatePost, n as useDeletePost, r as useNextPreviousPosts, g as usePost, k as usePostForm, o as usePostSearch, u as usePosts, v as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, m as useUpdatePost } from '../../../../shared/stack.BGzgFx3R.cjs';
+export { P as PostCreateInput, e as PostUpdateInput, p as UseNextPreviousPostsOptions, q as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, s as UseRecentPostsOptions, t as UseRecentPostsResult, l as useCreatePost, n as useDeletePost, r as useNextPreviousPosts, g as usePost, k as usePostForm, o as usePostSearch, u as usePosts, v as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, m as useUpdatePost } from '../../../../shared/stack.BTStHVTy.cjs';
 export { useDebounce } from '@btst/stack/plugins/client/hooks';
 import '@tanstack/react-query';
 import 'zod';
 import '../../../../shared/stack.Dsatjh0B.cjs';
-import '../../../../shared/stack.Csi-4Mgz.cjs';
+import '../../../../shared/stack.CKc_Bais.cjs';
 
 declare function useThrottle<T>(value: T, wait?: number): T;
 

package/dist/plugins/blog/client/hooks/index.d.mts

@@ -1,9 +1,9 @@
-export { P as PostCreateInput, e as PostUpdateInput, p as UseNextPreviousPostsOptions, q as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, s as UseRecentPostsOptions, t as UseRecentPostsResult, l as useCreatePost, n as useDeletePost, r as useNextPreviousPosts, g as usePost, k as usePostForm, o as usePostSearch, u as usePosts, v as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, m as useUpdatePost } from '../../../../shared/stack.CjCSDfWy.mjs';
+export { P as PostCreateInput, e as PostUpdateInput, p as UseNextPreviousPostsOptions, q as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, s as UseRecentPostsOptions, t as UseRecentPostsResult, l as useCreatePost, n as useDeletePost, r as useNextPreviousPosts, g as usePost, k as usePostForm, o as usePostSearch, u as usePosts, v as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, m as useUpdatePost } from '../../../../shared/stack.94kN3pEK.mjs';
 export { useDebounce } from '@btst/stack/plugins/client/hooks';
 import '@tanstack/react-query';
 import 'zod';
 import '../../../../shared/stack.Dsatjh0B.mjs';
-import '../../../../shared/stack.Csi-4Mgz.mjs';
+import '../../../../shared/stack.CKc_Bais.mjs';
 
 declare function useThrottle<T>(value: T, wait?: number): T;
 

package/dist/plugins/blog/client/hooks/index.d.ts

@@ -1,9 +1,9 @@
-export { P as PostCreateInput, e as PostUpdateInput, p as UseNextPreviousPostsOptions, q as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, s as UseRecentPostsOptions, t as UseRecentPostsResult, l as useCreatePost, n as useDeletePost, r as useNextPreviousPosts, g as usePost, k as usePostForm, o as usePostSearch, u as usePosts, v as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, m as useUpdatePost } from '../../../../shared/stack.Dpg_JjIo.js';
+export { P as PostCreateInput, e as PostUpdateInput, p as UseNextPreviousPostsOptions, q as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, s as UseRecentPostsOptions, t as UseRecentPostsResult, l as useCreatePost, n as useDeletePost, r as useNextPreviousPosts, g as usePost, k as usePostForm, o as usePostSearch, u as usePosts, v as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, m as useUpdatePost } from '../../../../shared/stack.DfrRYOIl.js';
 export { useDebounce } from '@btst/stack/plugins/client/hooks';
 import '@tanstack/react-query';
 import 'zod';
 import '../../../../shared/stack.Dsatjh0B.js';
-import '../../../../shared/stack.Csi-4Mgz.js';
+import '../../../../shared/stack.CKc_Bais.js';
 
 declare function useThrottle<T>(value: T, wait?: number): T;
 

package/dist/plugins/blog/client/index.d.cts

@@ -4,11 +4,11 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ComponentType, ReactNode } from 'react';
 import { S as SerializedPost, P as Post } from '../../../shared/stack.Dsatjh0B.cjs';
 import { N as NewPostPageComponent } from '../../../shared/stack.Bz-YPsuX.cjs';
-export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.BGzgFx3R.cjs';
+export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.BTStHVTy.cjs';
 import '@tanstack/react-query';
 import 'zod';
 import '@btst/stack/plugins/client/hooks';
-import '../../../shared/stack.Csi-4Mgz.cjs';
+import '../../../shared/stack.CKc_Bais.cjs';
 
 declare const BLOG_LOCALIZATION: {
     BLOG_FORMS_TITLE_LABEL: string;

package/dist/plugins/blog/client/index.d.mts

@@ -4,11 +4,11 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ComponentType, ReactNode } from 'react';
 import { S as SerializedPost, P as Post } from '../../../shared/stack.Dsatjh0B.mjs';
 import { N as NewPostPageComponent } from '../../../shared/stack.Bz-YPsuX.mjs';
-export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.CjCSDfWy.mjs';
+export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.94kN3pEK.mjs';
 import '@tanstack/react-query';
 import 'zod';
 import '@btst/stack/plugins/client/hooks';
-import '../../../shared/stack.Csi-4Mgz.mjs';
+import '../../../shared/stack.CKc_Bais.mjs';
 
 declare const BLOG_LOCALIZATION: {
     BLOG_FORMS_TITLE_LABEL: string;

package/dist/plugins/blog/client/index.d.ts

@@ -4,11 +4,11 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ComponentType, ReactNode } from 'react';
 import { S as SerializedPost, P as Post } from '../../../shared/stack.Dsatjh0B.js';
 import { N as NewPostPageComponent } from '../../../shared/stack.Bz-YPsuX.js';
-export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.Dpg_JjIo.js';
+export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.DfrRYOIl.js';
 import '@tanstack/react-query';
 import 'zod';
 import '@btst/stack/plugins/client/hooks';
-import '../../../shared/stack.Csi-4Mgz.js';
+import '../../../shared/stack.CKc_Bais.js';
 
 declare const BLOG_LOCALIZATION: {
     BLOG_FORMS_TITLE_LABEL: string;

package/dist/plugins/blog/query-keys.d.cts

@@ -1,7 +1,7 @@
 import '@btst/stack/plugins/client';
-export { D as blogResources, d as createBlogQueryKeys } from '../../shared/stack.BOZRaVpu.cjs';
+export { D as blogResources, d as createBlogQueryKeys } from '../../shared/stack.Ce6V7eDj.cjs';
 import 'zod';
-import '../../shared/stack.Csi-4Mgz.cjs';
+import '../../shared/stack.CKc_Bais.cjs';
 import '../../shared/stack.Dsatjh0B.cjs';
 import '@btst/stack/plugins/api';
 import '../../authorization/index.cjs';

package/dist/plugins/blog/query-keys.d.mts

@@ -1,7 +1,7 @@
 import '@btst/stack/plugins/client';
-export { D as blogResources, d as createBlogQueryKeys } from '../../shared/stack.Dvy7FmaA.mjs';
+export { D as blogResources, d as createBlogQueryKeys } from '../../shared/stack.CTneIW0u.mjs';
 import 'zod';
-import '../../shared/stack.Csi-4Mgz.mjs';
+import '../../shared/stack.CKc_Bais.mjs';
 import '../../shared/stack.Dsatjh0B.mjs';
 import '@btst/stack/plugins/api';
 import '../../authorization/index.mjs';