@btst/stack 3.0.0-rc.1 → 3.0.0-rc.3

package/dist/shared/stack.3Sr6qRtT.d.ts

@@ -0,0 +1,507 @@
+import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
+import { createApiClient } from '@btst/stack/plugins/client';
+import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
+import { OperationContext, DeepReadonly, Operation, OperationHttpError } from '@btst/stack/plugins/api';
+import { PermissionFactsFor } from '@btst/stack/authorization';
+import * as zod from 'zod';
+import { z } from 'zod';
+import { aiChatPermissions } from '../plugins/ai-chat/permissions.js';
+import * as zod_v4_core from 'zod/v4/core';
+import * as better_call from 'better-call';
+import { Tool, LanguageModel } from 'ai';
+import { StackIdentity } from '@btst/stack/context';
+
+declare const createConversationSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const updateConversationSchema: z.ZodObject<{
+    title: z.ZodString;
+}, z.core.$strip>;
+
+type Conversation = {
+    id: string;
+    userId?: string;
+    title: string;
+    createdAt: Date;
+    updatedAt: Date;
+};
+type Message = {
+    id: string;
+    conversationId: string;
+    role: "system" | "user" | "assistant" | "data";
+    content: string;
+    createdAt: Date;
+};
+type SerializedConversation = Omit<Conversation, "createdAt" | "updatedAt"> & {
+    createdAt: string;
+    updatedAt: string;
+};
+type SerializedMessage = Omit<Message, "createdAt"> & {
+    createdAt: string;
+};
+
+type AiChatAccess = "authorized" | "public";
+/** Runtime input for one conversation operation. */
+declare const ConversationOperationInputSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+/** Runtime input for one conversation rename operation. */
+declare const UpdateConversationOperationInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    data: z.ZodObject<{
+        title: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Runtime input accepted only from trusted stream callers. */
+declare const ChatOperationInputSchema: z.ZodType<ChatOperationInput>;
+/** JSON-safe AI SDK message shape accepted at the operation boundary. */
+type ChatOperationInput = {
+    readonly messages: readonly ({
+        readonly role: "system" | "user" | "assistant" | "data";
+        readonly content: string;
+        readonly id?: string;
+    } | {
+        readonly role: "system" | "user" | "assistant" | "data";
+        readonly parts: readonly ({
+            readonly type: string;
+            readonly text?: string;
+        } & Record<string, any>)[];
+        readonly id?: string;
+        readonly metadata?: any;
+    })[];
+    readonly conversationId?: string;
+    readonly model?: string;
+    readonly pageContext?: string;
+    readonly availableTools?: readonly string[];
+    readonly routeName?: string;
+    readonly trustedUserId?: string;
+};
+declare const EmptyInputSchema: z.ZodObject<{}, z.core.$strip>;
+type ConversationReadFacts = PermissionFactsFor<typeof aiChatPermissions.conversation.read>;
+type ConversationRecordFacts = PermissionFactsFor<typeof aiChatPermissions.conversation.update>;
+type StreamStartFacts = PermissionFactsFor<typeof aiChatPermissions.stream.start>;
+/** One conversation and its serialized message history. */
+type AiChatConversationResult = SerializedConversation & {
+    readonly messages: readonly SerializedMessage[];
+};
+/** Complete AI Chat operation inventory shared by every server transport. */
+type AiChatOperations = {
+    readonly startStream: Operation<typeof ChatOperationInputSchema, typeof aiChatPermissions.stream.start, Response, true>;
+    readonly listConversations: Operation<typeof EmptyInputSchema, typeof aiChatPermissions.conversation.read, readonly SerializedConversation[]>;
+    readonly getConversation: Operation<typeof ConversationOperationInputSchema, typeof aiChatPermissions.conversation.read, AiChatConversationResult>;
+    readonly createConversation: Operation<typeof createConversationSchema, typeof aiChatPermissions.conversation.create, SerializedConversation>;
+    readonly updateConversation: Operation<typeof UpdateConversationOperationInputSchema, typeof aiChatPermissions.conversation.update, SerializedConversation>;
+    readonly deleteConversation: Operation<typeof ConversationOperationInputSchema, typeof aiChatPermissions.conversation.delete, {
+        readonly success: true;
+    }>;
+};
+/** Executable inventory used by tests, docs, and future transport audits. */
+declare const AI_CHAT_OPERATION_INVENTORY: Readonly<{
+    startStream: Readonly<{
+        http: "POST /chat";
+        request: "forRequest(request).operations.aiChat.startStream";
+        trusted: "trusted.aiChat.startStream";
+        ui: readonly string[];
+        semantics: readonly string[];
+        publicSemantics: readonly string[];
+        publicWhenConfigured: true;
+    }>;
+    listConversations: Readonly<{
+        http: "GET /chat/conversations";
+        request: "forRequest(request).operations.aiChat.listConversations";
+        trusted: "trusted.aiChat.listConversations";
+        ui: readonly string[];
+        semantics: readonly string[];
+        publicWhenConfigured: false;
+    }>;
+    getConversation: Readonly<{
+        http: "GET /chat/conversations/:id";
+        request: "forRequest(request).operations.aiChat.getConversation";
+        trusted: "trusted.aiChat.getConversation";
+        ui: readonly string[];
+        semantics: readonly string[];
+        publicWhenConfigured: false;
+    }>;
+    createConversation: Readonly<{
+        http: "POST /chat/conversations";
+        request: "forRequest(request).operations.aiChat.createConversation";
+        trusted: "trusted.aiChat.createConversation";
+        ui: readonly string[];
+        semantics: readonly string[];
+        publicWhenConfigured: false;
+    }>;
+    updateConversation: Readonly<{
+        http: "PUT /chat/conversations/:id";
+        request: "forRequest(request).operations.aiChat.updateConversation";
+        trusted: "trusted.aiChat.updateConversation";
+        ui: readonly string[];
+        semantics: readonly string[];
+        publicWhenConfigured: false;
+    }>;
+    deleteConversation: Readonly<{
+        http: "DELETE /chat/conversations/:id";
+        request: "forRequest(request).operations.aiChat.deleteConversation";
+        trusted: "trusted.aiChat.deleteConversation";
+        ui: readonly string[];
+        semantics: readonly string[];
+        publicWhenConfigured: false;
+    }>;
+}>;
+/** Standalone raw getters that bypass authorization and operation lifecycle hooks. */
+declare const AI_CHAT_RAW_ESCAPE_HATCH_INVENTORY: readonly string[];
+/** A domain/HTTP failure raised after AI Chat authorization succeeds. */
+declare class AiChatOperationError extends OperationHttpError {
+    constructor(statusCode: number, message: string, code: string);
+}
+/** Typed operation context supplied to AI Chat lifecycle hooks. */
+interface ChatApiContext<TInput = unknown, TFacts = unknown> extends OperationContext<TInput, TFacts> {
+    readonly headers?: Headers;
+    readonly body?: DeepReadonly<TInput>;
+    readonly params?: Readonly<Record<string, string>>;
+    readonly query?: DeepReadonly<TInput>;
+}
+/** Post-authorization AI Chat domain lifecycle hooks. */
+interface AiChatBackendHooks {
+    onBeforeChat?: (messages: readonly {
+        readonly role: string;
+        readonly content: string;
+    }[], context: ChatApiContext<z.output<typeof ChatOperationInputSchema>, StreamStartFacts>) => Promise<void> | void;
+    onBeforeListConversations?: (context: ChatApiContext<z.output<typeof EmptyInputSchema>, ConversationReadFacts>) => Promise<void> | void;
+    onBeforeGetConversation?: (conversationId: string, context: ChatApiContext<z.output<typeof ConversationOperationInputSchema>, ConversationReadFacts>) => Promise<void> | void;
+    onBeforeCreateConversation?: (data: DeepReadonly<z.output<typeof createConversationSchema>>, context: ChatApiContext<z.output<typeof createConversationSchema>, undefined>) => Promise<void> | void;
+    onBeforeUpdateConversation?: (conversationId: string, data: DeepReadonly<z.output<typeof updateConversationSchema>>, context: ChatApiContext<z.output<typeof UpdateConversationOperationInputSchema>, ConversationRecordFacts>) => Promise<void> | void;
+    onBeforeDeleteConversation?: (conversationId: string, context: ChatApiContext<z.output<typeof ConversationOperationInputSchema>, ConversationRecordFacts>) => Promise<void> | void;
+    /**
+     * Post-authorization tool safety/filter hook. Structural route validation and
+     * exact `tool.activate` authorization have already succeeded.
+     */
+    onBeforeActivateTools?: (toolNames: readonly string[], routeName: string | undefined, context: ChatApiContext<z.output<typeof ChatOperationInputSchema>, StreamStartFacts>) => Promise<readonly string[]> | readonly string[];
+    onAfterChat?: (conversationId: string, messages: readonly SerializedMessage[], context: ChatApiContext<z.output<typeof ChatOperationInputSchema>, StreamStartFacts>) => Promise<void> | void;
+    onAfterListConversations?: (conversations: readonly SerializedConversation[], context: ChatApiContext<z.output<typeof EmptyInputSchema>, ConversationReadFacts>) => Promise<void> | void;
+    onAfterGetConversation?: (conversation: DeepReadonly<AiChatConversationResult>, context: ChatApiContext<z.output<typeof ConversationOperationInputSchema>, ConversationReadFacts>) => Promise<void> | void;
+    onAfterCreateConversation?: (conversation: DeepReadonly<SerializedConversation>, context: ChatApiContext<z.output<typeof createConversationSchema>, undefined>) => Promise<void> | void;
+    onAfterUpdateConversation?: (conversation: DeepReadonly<SerializedConversation>, context: ChatApiContext<z.output<typeof UpdateConversationOperationInputSchema>, ConversationRecordFacts>) => Promise<void> | void;
+    onAfterDeleteConversation?: (conversationId: string, context: ChatApiContext<z.output<typeof ConversationOperationInputSchema>, ConversationRecordFacts>) => Promise<void> | void;
+    onErrorChat?: (error: Error, context: ChatApiContext<z.output<typeof ChatOperationInputSchema>, StreamStartFacts>) => Promise<void> | void;
+    onErrorListConversations?: (error: Error, context: ChatApiContext<z.output<typeof EmptyInputSchema>, ConversationReadFacts>) => Promise<void> | void;
+    onErrorGetConversation?: (error: Error, context: ChatApiContext<z.output<typeof ConversationOperationInputSchema>, ConversationReadFacts>) => Promise<void> | void;
+    onErrorCreateConversation?: (error: Error, context: ChatApiContext<z.output<typeof createConversationSchema>, undefined>) => Promise<void> | void;
+    onErrorUpdateConversation?: (error: Error, context: ChatApiContext<z.output<typeof UpdateConversationOperationInputSchema>, ConversationRecordFacts>) => Promise<void> | void;
+    onErrorDeleteConversation?: (error: Error, context: ChatApiContext<z.output<typeof ConversationOperationInputSchema>, ConversationRecordFacts>) => Promise<void> | void;
+}
+
+type KnownKeys<T> = {
+    [K in keyof T]: string extends K ? never : K;
+}[keyof T];
+type NoKeyCollision<TTools, TClientTools extends Record<string, Tool>> = KnownKeys<TTools> & keyof TClientTools extends never ? TClientTools : {
+    [K in keyof TClientTools]: K extends KnownKeys<TTools> ? never : TClientTools[K];
+};
+/** AI Chat server configuration. */
+interface AiChatBackendConfig {
+    model: LanguageModel;
+    /**
+     * Explicit server access policy. Authorized mode persists identity-scoped
+     * history and denies missing rules. Public mode exposes only stateless chat.
+     * @default "authorized"
+     */
+    access?: AiChatAccess;
+    systemPrompt?: string;
+    tools?: Record<string, Tool>;
+    enablePageTools?: boolean;
+    clientToolSchemas?: Record<string, Tool>;
+    hooks?: AiChatBackendHooks;
+}
+/** AI Chat backend plugin backed by one typed operation catalog. */
+declare const aiChatBackendPlugin: <TTools extends Record<string, Tool> = Record<never, Tool>, TClientTools extends Record<string, Tool> = Record<never, Tool>>(config: Omit<AiChatBackendConfig, "tools" | "clientToolSchemas"> & {
+    tools?: TTools;
+    clientToolSchemas?: NoKeyCollision<TTools, TClientTools>;
+}) => _btst_stack_plugins_api.BackendPlugin<{
+    readonly chat: better_call.StrictEndpoint<"/chat", {
+        requireRequest: true;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<{
+            messages: ({
+                role: "data" | "system" | "user" | "assistant";
+                content: string;
+                id?: string | undefined;
+            } | {
+                role: "data" | "system" | "user" | "assistant";
+                parts: {
+                    [x: string]: unknown;
+                    type: string;
+                    text?: string | undefined;
+                }[];
+                id?: string | undefined;
+                metadata?: any;
+            })[];
+            conversationId?: string | undefined;
+            model?: string | undefined;
+            pageContext?: string | undefined;
+            availableTools?: string[] | undefined;
+            routeName?: string | undefined;
+        }, {
+            messages: ({
+                role: "data" | "system" | "user" | "assistant";
+                content: string;
+                id?: string | undefined;
+            } | {
+                role: "data" | "system" | "user" | "assistant";
+                parts: {
+                    [x: string]: unknown;
+                    type: string;
+                    text?: string | undefined;
+                }[];
+                id?: string | undefined;
+                metadata?: any;
+            })[];
+            conversationId?: string | undefined;
+            model?: string | undefined;
+            pageContext?: string | undefined;
+            availableTools?: string[] | undefined;
+            routeName?: string | undefined;
+        }>;
+    }, Response>;
+    readonly listConversations: better_call.StrictEndpoint<"/chat/conversations", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    }, readonly {
+        readonly id: string;
+        readonly title: string;
+        readonly userId?: string | undefined;
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }[]>;
+    readonly getConversation: better_call.StrictEndpoint<"/chat/conversations/:id", {
+        params: zod.ZodObject<{
+            id: zod.ZodString;
+        }, zod_v4_core.$strip>;
+        requireRequest: true;
+    } & {
+        method: "GET";
+    }, {
+        readonly id: string;
+        readonly title: string;
+        readonly userId?: string | undefined;
+        readonly createdAt: string;
+        readonly updatedAt: string;
+        readonly messages: readonly {
+            readonly id: string;
+            readonly conversationId: string;
+            readonly role: "system" | "user" | "assistant" | "data";
+            readonly content: string;
+            readonly createdAt: string;
+        }[];
+    }>;
+    readonly createConversation: better_call.StrictEndpoint<"/chat/conversations", {
+        requireRequest: true;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<{
+            id?: string | undefined;
+            title?: string | undefined;
+        }, {
+            id?: string | undefined;
+            title?: string | undefined;
+        }>;
+    }, {
+        readonly id: string;
+        readonly title: string;
+        readonly userId?: string | undefined;
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }>;
+    readonly updateConversation: better_call.StrictEndpoint<"/chat/conversations/:id", {
+        requireRequest: true;
+    } & {
+        method: "PUT";
+        body: better_call.StandardSchemaV1<{
+            title: string;
+        }, {
+            title: string;
+        }>;
+    }, {
+        readonly id: string;
+        readonly title: string;
+        readonly userId?: string | undefined;
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }>;
+    readonly deleteConversation: better_call.StrictEndpoint<"/chat/conversations/:id", {
+        requireRequest: true;
+    } & {
+        method: "DELETE";
+        body: better_call.StandardSchemaV1<unknown, unknown>;
+    }, {
+        readonly success: true;
+    }>;
+}, never, AiChatOperations, "aiChat">;
+type AiChatApiRouter = ReturnType<ReturnType<typeof aiChatBackendPlugin>["routes"]>;
+
+/** Identity partition for protected AI Chat history caches. */
+type AiChatIdentityPartition = Readonly<StackIdentity> | "anonymous" | `pending:${number}` | `error:${number}`;
+/** @internal Serializable marker that never embeds arbitrary identity metadata. */
+declare function aiChatIdentityKey(identityPartition: AiChatIdentityPartition): "anonymous" | `pending:${number}` | `error:${number}` | {
+    id: string;
+    fingerprint: string;
+};
+type ConversationWithMessages = SerializedConversation & {
+    messages: SerializedMessage[];
+};
+interface CreateConversationInput {
+    id?: string;
+    title?: string;
+}
+interface RenameConversationInput {
+    id: string;
+    title: string;
+}
+/** Single source of truth for conversation HTTP mappings and cache behavior. */
+declare const aiChatResources: {
+    conversations: {
+        queries: {
+            list: {
+                path: string;
+                key: (identityPartition?: AiChatIdentityPartition) => (string | {
+                    identity: "anonymous" | `pending:${number}` | `error:${number}` | {
+                        id: string;
+                        fingerprint: string;
+                    };
+                })[];
+                select: (data: any, _identityPartition?: AiChatIdentityPartition) => SerializedConversation[];
+                skip: (identityPartition?: AiChatIdentityPartition) => boolean;
+            };
+            detail: {
+                path: string;
+                params: (id: string, _identityPartition?: AiChatIdentityPartition) => {
+                    id: string;
+                };
+                key: (id: string, identityPartition?: AiChatIdentityPartition) => (string | {
+                    identity: "anonymous" | `pending:${number}` | `error:${number}` | {
+                        id: string;
+                        fingerprint: string;
+                    };
+                })[];
+                select: (data: any, _id?: string, _identityPartition?: AiChatIdentityPartition) => ConversationWithMessages | null;
+                skip: (id: string, identityPartition?: AiChatIdentityPartition) => boolean;
+            };
+        };
+        mutations: {
+            create: {
+                path: string;
+                method: "POST";
+                input: (input: CreateConversationInput) => {
+                    body: CreateConversationInput;
+                };
+                select: (data: any) => SerializedConversation | null;
+                refresh: false;
+            };
+            rename: {
+                path: string;
+                method: "PUT";
+                input: (input: RenameConversationInput) => {
+                    params: {
+                        id: string;
+                    };
+                    body: {
+                        title: string;
+                    };
+                };
+                select: (data: any) => SerializedConversation | null;
+                refresh: false;
+            };
+            delete: {
+                path: string;
+                method: "DELETE";
+                input: (input: {
+                    id: string;
+                }) => {
+                    params: {
+                        id: string;
+                    };
+                };
+                select: (data: any) => {
+                    success: boolean;
+                };
+                refresh: false;
+            };
+        };
+    };
+};
+declare function createAiChatQueryKeys(client: ReturnType<typeof createApiClient<AiChatApiRouter>>, headers?: HeadersInit): _btst_stack_plugins_client.ResourceQueryKeys<{
+    conversations: {
+        queries: {
+            list: {
+                path: string;
+                key: (identityPartition?: AiChatIdentityPartition) => (string | {
+                    identity: "anonymous" | `pending:${number}` | `error:${number}` | {
+                        id: string;
+                        fingerprint: string;
+                    };
+                })[];
+                select: (data: any, _identityPartition?: AiChatIdentityPartition) => SerializedConversation[];
+                skip: (identityPartition?: AiChatIdentityPartition) => boolean;
+            };
+            detail: {
+                path: string;
+                params: (id: string, _identityPartition?: AiChatIdentityPartition) => {
+                    id: string;
+                };
+                key: (id: string, identityPartition?: AiChatIdentityPartition) => (string | {
+                    identity: "anonymous" | `pending:${number}` | `error:${number}` | {
+                        id: string;
+                        fingerprint: string;
+                    };
+                })[];
+                select: (data: any, _id?: string, _identityPartition?: AiChatIdentityPartition) => ConversationWithMessages | null;
+                skip: (id: string, identityPartition?: AiChatIdentityPartition) => boolean;
+            };
+        };
+        mutations: {
+            create: {
+                path: string;
+                method: "POST";
+                input: (input: CreateConversationInput) => {
+                    body: CreateConversationInput;
+                };
+                select: (data: any) => SerializedConversation | null;
+                refresh: false;
+            };
+            rename: {
+                path: string;
+                method: "PUT";
+                input: (input: RenameConversationInput) => {
+                    params: {
+                        id: string;
+                    };
+                    body: {
+                        title: string;
+                    };
+                };
+                select: (data: any) => SerializedConversation | null;
+                refresh: false;
+            };
+            delete: {
+                path: string;
+                method: "DELETE";
+                input: (input: {
+                    id: string;
+                }) => {
+                    params: {
+                        id: string;
+                    };
+                };
+                select: (data: any) => {
+                    success: boolean;
+                };
+                refresh: false;
+            };
+        };
+    };
+}>;
+type AiChatQueryKeys = ReturnType<typeof createAiChatQueryKeys>;
+
+export { UpdateConversationOperationInputSchema as U, aiChatIdentityKey as d, aiChatResources as e, createAiChatQueryKeys as f, aiChatBackendPlugin as i, AI_CHAT_OPERATION_INVENTORY as n, AI_CHAT_RAW_ESCAPE_HATCH_INVENTORY as o, AiChatOperationError as p, ChatOperationInputSchema as q, ConversationOperationInputSchema as r };
+export type { AiChatIdentityPartition as A, ConversationWithMessages as C, Message as M, RenameConversationInput as R, SerializedConversation as S, SerializedMessage as a, CreateConversationInput as b, Conversation as c, AiChatQueryKeys as g, AiChatBackendConfig as h, AiChatApiRouter as j, AiChatAccess as k, AiChatBackendHooks as l, ChatApiContext as m };

package/dist/shared/{stack.9BAOaSqE.d.mts → stack.5_zzCejP.d.cts}

@@ -90,6 +90,11 @@ interface AiChatLocalization {
  * - 'public': Stateless chat, no persistence (ideal for public chatbots)
  */
 type AiChatMode = "authenticated" | "public";
+/** Browser-safe AI Chat factory values carried by the resolved client stack. */
+interface AiChatProviderConfig {
+    /** Conversation behavior selected by `aiChatClientPlugin()`. */
+    readonly mode: AiChatMode;
+}
 /**
  * State of a tool call execution
  */
@@ -147,11 +152,6 @@ interface RouteContext {
  * plugin-specific components and behavior.
  */
 interface AiChatPluginOverrides {
-    /**
-     * Plugin mode - should match backend config
-     * @default 'authenticated'
-     */
-    mode?: AiChatMode;
     /**
      * Function used to upload a file and return its URL.
      * Called for images, PDFs, text files, and other supported file types.
@@ -168,10 +168,6 @@ interface AiChatPluginOverrides {
      * Localization object for the AI Chat plugin
      */
     localization?: Partial<AiChatLocalization>;
-    /**
-     * Optional headers to pass with API requests (e.g., for SSR auth)
-     */
-    headers?: HeadersInit;
     /**
      * Whether to show the attribution
      * @default true
@@ -224,7 +220,6 @@ interface AiChatPluginOverrides {
 }
 
 interface ChatInterfaceProps {
-    apiPath?: string;
     initialMessages?: UIMessage[];
     id?: string;
     /** Variant: 'full' for full-page layout, 'widget' for embedded widget */
@@ -233,7 +228,7 @@ interface ChatInterfaceProps {
     /** Called whenever messages change (for persistence). Only fires in public mode. */
     onMessagesChange?: (messages: UIMessage[]) => void;
 }
-declare function ChatInterface({ apiPath, initialMessages, id, variant, className, onMessagesChange, }: ChatInterfaceProps): react_jsx_runtime.JSX.Element;
+declare function ChatInterface({ initialMessages, id, variant, className, onMessagesChange, }: ChatInterfaceProps): react_jsx_runtime.JSX.Element;
 
 interface ChatLayoutBaseProps {
     /** Current conversation ID (if viewing existing conversation) */
@@ -323,8 +318,15 @@ interface ChatInputProps {
     onFilesAttached?: (files: AttachedFile[]) => void;
     /** Attached files (for controlled mode) */
     attachedFiles?: AttachedFile[];
+    /** Browser permission hint for showing attachment controls. */
+    allowAttachments?: boolean;
+    /** Rendered owner hints for an exact attachment permission check. */
+    attachmentPermissionFacts?: {
+        conversationId?: string;
+        ownerId?: string;
+    };
 }
-declare function ChatInput({ input, handleInputChange, handleSubmit, isLoading, placeholder, variant, onFilesAttached, attachedFiles: controlledFiles, }: ChatInputProps): react_jsx_runtime.JSX.Element;
+declare function ChatInput({ input, handleInputChange, handleSubmit, isLoading, placeholder, variant, onFilesAttached, attachedFiles: controlledFiles, allowAttachments, attachmentPermissionFacts, }: ChatInputProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Default tool call display component.
@@ -332,5 +334,5 @@ declare function ChatInput({ input, handleInputChange, handleSubmit, isLoading,
  */
 declare function ToolCallDisplay({ toolCallId, toolName, state, input, output, errorText, isLoading, }: ToolCallProps): react_jsx_runtime.JSX.Element;
 
-export { ChatInterface as C, DEFAULT_ALLOWED_FILE_TYPES as D, ChatLayout as e, ChatSidebar as g, ChatMessage as h, ChatInput as i, ToolCallDisplay as j };
-export type { AiChatMode as A, ToolCallProps as T, AiChatPluginOverrides as a, AllowedFileType as b, ToolCallState as c, ToolCallRenderer as d, ChatLayoutProps as f };
+export { ChatInterface as C, DEFAULT_ALLOWED_FILE_TYPES as D, ChatLayout as f, ChatSidebar as h, ChatMessage as i, ChatInput as j, ToolCallDisplay as k };
+export type { AiChatMode as A, ToolCallProps as T, AiChatPluginOverrides as a, AiChatProviderConfig as b, AllowedFileType as c, ToolCallState as d, ToolCallRenderer as e, ChatLayoutProps as g };

package/dist/shared/{stack.9BAOaSqE.d.ts → stack.5_zzCejP.d.mts}

@@ -90,6 +90,11 @@ interface AiChatLocalization {
  * - 'public': Stateless chat, no persistence (ideal for public chatbots)
  */
 type AiChatMode = "authenticated" | "public";
+/** Browser-safe AI Chat factory values carried by the resolved client stack. */
+interface AiChatProviderConfig {
+    /** Conversation behavior selected by `aiChatClientPlugin()`. */
+    readonly mode: AiChatMode;
+}
 /**
  * State of a tool call execution
  */
@@ -147,11 +152,6 @@ interface RouteContext {
  * plugin-specific components and behavior.
  */
 interface AiChatPluginOverrides {
-    /**
-     * Plugin mode - should match backend config
-     * @default 'authenticated'
-     */
-    mode?: AiChatMode;
     /**
      * Function used to upload a file and return its URL.
      * Called for images, PDFs, text files, and other supported file types.
@@ -168,10 +168,6 @@ interface AiChatPluginOverrides {
      * Localization object for the AI Chat plugin
      */
     localization?: Partial<AiChatLocalization>;
-    /**
-     * Optional headers to pass with API requests (e.g., for SSR auth)
-     */
-    headers?: HeadersInit;
     /**
      * Whether to show the attribution
      * @default true
@@ -224,7 +220,6 @@ interface AiChatPluginOverrides {
 }
 
 interface ChatInterfaceProps {
-    apiPath?: string;
     initialMessages?: UIMessage[];
     id?: string;
     /** Variant: 'full' for full-page layout, 'widget' for embedded widget */
@@ -233,7 +228,7 @@ interface ChatInterfaceProps {
     /** Called whenever messages change (for persistence). Only fires in public mode. */
     onMessagesChange?: (messages: UIMessage[]) => void;
 }
-declare function ChatInterface({ apiPath, initialMessages, id, variant, className, onMessagesChange, }: ChatInterfaceProps): react_jsx_runtime.JSX.Element;
+declare function ChatInterface({ initialMessages, id, variant, className, onMessagesChange, }: ChatInterfaceProps): react_jsx_runtime.JSX.Element;
 
 interface ChatLayoutBaseProps {
     /** Current conversation ID (if viewing existing conversation) */
@@ -323,8 +318,15 @@ interface ChatInputProps {
     onFilesAttached?: (files: AttachedFile[]) => void;
     /** Attached files (for controlled mode) */
     attachedFiles?: AttachedFile[];
+    /** Browser permission hint for showing attachment controls. */
+    allowAttachments?: boolean;
+    /** Rendered owner hints for an exact attachment permission check. */
+    attachmentPermissionFacts?: {
+        conversationId?: string;
+        ownerId?: string;
+    };
 }
-declare function ChatInput({ input, handleInputChange, handleSubmit, isLoading, placeholder, variant, onFilesAttached, attachedFiles: controlledFiles, }: ChatInputProps): react_jsx_runtime.JSX.Element;
+declare function ChatInput({ input, handleInputChange, handleSubmit, isLoading, placeholder, variant, onFilesAttached, attachedFiles: controlledFiles, allowAttachments, attachmentPermissionFacts, }: ChatInputProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Default tool call display component.
@@ -332,5 +334,5 @@ declare function ChatInput({ input, handleInputChange, handleSubmit, isLoading,
  */
 declare function ToolCallDisplay({ toolCallId, toolName, state, input, output, errorText, isLoading, }: ToolCallProps): react_jsx_runtime.JSX.Element;
 
-export { ChatInterface as C, DEFAULT_ALLOWED_FILE_TYPES as D, ChatLayout as e, ChatSidebar as g, ChatMessage as h, ChatInput as i, ToolCallDisplay as j };
-export type { AiChatMode as A, ToolCallProps as T, AiChatPluginOverrides as a, AllowedFileType as b, ToolCallState as c, ToolCallRenderer as d, ChatLayoutProps as f };
+export { ChatInterface as C, DEFAULT_ALLOWED_FILE_TYPES as D, ChatLayout as f, ChatSidebar as h, ChatMessage as i, ChatInput as j, ToolCallDisplay as k };
+export type { AiChatMode as A, ToolCallProps as T, AiChatPluginOverrides as a, AiChatProviderConfig as b, AllowedFileType as c, ToolCallState as d, ToolCallRenderer as e, ChatLayoutProps as g };