@btst/stack 4.4.0 → 4.5.1

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

@@ -1,4 +1,4 @@
-export { C as CMSApiRouter, b as CMSRouteKey, d as CMS_QUERY_KEYS, c as cmsBackendPlugin } from '../../../shared/stack.D6Pg-ufX.cjs';
+export { C as CMSApiRouter, b as CMSRouteKey, d as CMS_QUERY_KEYS, c as cmsBackendPlugin } from '../../../shared/stack.Bf6BGZNk.cjs';
 import { DBAdapter } from '@btst/db';
 import { S as SerializedContentType, a as SerializedContentItemWithType, b as ContentType, c as ContentItem, d as SerializedContentItem, e as ContentItemWithType } from '../../../shared/stack.B3_aDcYL.cjs';
 export { C as CMSBackendConfig, f as CMSBackendHooks, g as CMSCreateOperationContext, h as CMSCreateResultContext, i as CMSDeleteOperationContext, j as CMSDeleteResultContext, k as CMSOperationErrorContext, l as CMSOperationLifecycleContext, m as CMSUpdateOperationContext, n as CMSUpdateResultContext, o as ContentTypeConfig } from '../../../shared/stack.B3_aDcYL.cjs';

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

@@ -1,4 +1,4 @@
-export { C as CMSApiRouter, b as CMSRouteKey, d as CMS_QUERY_KEYS, c as cmsBackendPlugin } from '../../../shared/stack.B8PG21zX.mjs';
+export { C as CMSApiRouter, b as CMSRouteKey, d as CMS_QUERY_KEYS, c as cmsBackendPlugin } from '../../../shared/stack.BLYaUcQa.mjs';
 import { DBAdapter } from '@btst/db';
 import { S as SerializedContentType, a as SerializedContentItemWithType, b as ContentType, c as ContentItem, d as SerializedContentItem, e as ContentItemWithType } from '../../../shared/stack.B3_aDcYL.mjs';
 export { C as CMSBackendConfig, f as CMSBackendHooks, g as CMSCreateOperationContext, h as CMSCreateResultContext, i as CMSDeleteOperationContext, j as CMSDeleteResultContext, k as CMSOperationErrorContext, l as CMSOperationLifecycleContext, m as CMSUpdateOperationContext, n as CMSUpdateResultContext, o as ContentTypeConfig } from '../../../shared/stack.B3_aDcYL.mjs';

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

@@ -1,4 +1,4 @@
-export { C as CMSApiRouter, b as CMSRouteKey, d as CMS_QUERY_KEYS, c as cmsBackendPlugin } from '../../../shared/stack.CyalJ0j6.js';
+export { C as CMSApiRouter, b as CMSRouteKey, d as CMS_QUERY_KEYS, c as cmsBackendPlugin } from '../../../shared/stack.CyltNNZZ.js';
 import { DBAdapter } from '@btst/db';
 import { S as SerializedContentType, a as SerializedContentItemWithType, b as ContentType, c as ContentItem, d as SerializedContentItem, e as ContentItemWithType } from '../../../shared/stack.B3_aDcYL.js';
 export { C as CMSBackendConfig, f as CMSBackendHooks, g as CMSCreateOperationContext, h as CMSCreateResultContext, i as CMSDeleteOperationContext, j as CMSDeleteResultContext, k as CMSOperationErrorContext, l as CMSOperationLifecycleContext, m as CMSUpdateOperationContext, n as CMSUpdateResultContext, o as ContentTypeConfig } from '../../../shared/stack.B3_aDcYL.js';

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

@@ -1,6 +1,6 @@
 import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { C as CMSApiRouter, a as ContentListDiscriminator } from '../../shared/stack.D6Pg-ufX.cjs';
+import { C as CMSApiRouter, a as ContentListDiscriminator } from '../../shared/stack.Bf6BGZNk.cjs';
 import { S as SerializedContentType, I as InverseRelation, a as SerializedContentItemWithType, P as PaginatedContentItems } from '../../shared/stack.B3_aDcYL.cjs';
 import '@btst/stack/plugins/api';
 import '../../authorization/index.cjs';

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

@@ -1,6 +1,6 @@
 import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { C as CMSApiRouter, a as ContentListDiscriminator } from '../../shared/stack.B8PG21zX.mjs';
+import { C as CMSApiRouter, a as ContentListDiscriminator } from '../../shared/stack.BLYaUcQa.mjs';
 import { S as SerializedContentType, I as InverseRelation, a as SerializedContentItemWithType, P as PaginatedContentItems } from '../../shared/stack.B3_aDcYL.mjs';
 import '@btst/stack/plugins/api';
 import '../../authorization/index.mjs';

package/dist/plugins/cms/query-keys.d.ts

@@ -1,6 +1,6 @@
 import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { C as CMSApiRouter, a as ContentListDiscriminator } from '../../shared/stack.CyalJ0j6.js';
+import { C as CMSApiRouter, a as ContentListDiscriminator } from '../../shared/stack.CyltNNZZ.js';
 import { S as SerializedContentType, I as InverseRelation, a as SerializedContentItemWithType, P as PaginatedContentItems } from '../../shared/stack.B3_aDcYL.js';
 import '@btst/stack/plugins/api';
 import '../../authorization/index.js';

package/dist/plugins/form-builder/api/index.d.cts

@@ -1,4 +1,4 @@
-export { k as FORM_QUERY_KEYS, a as FormBuilderApiRouter, c as FormBuilderOperationError, e as FormBuilderOperations, b as FormBuilderRouteKey, g as FormListOperationResult, h as SubmissionDetailOperationResult, i as SubmissionListOperationResult, j as SubmitOperationResult, d as createFormBuilderOperations, f as formBuilderBackendPlugin } from '../../../shared/stack.zch70Loj.cjs';
+export { k as FORM_QUERY_KEYS, a as FormBuilderApiRouter, c as FormBuilderOperationError, e as FormBuilderOperations, b as FormBuilderRouteKey, g as FormListOperationResult, h as SubmissionDetailOperationResult, i as SubmissionListOperationResult, j as SubmitOperationResult, d as createFormBuilderOperations, f as formBuilderBackendPlugin } from '../../../shared/stack.CX83YNuS.cjs';
 export { formBuilderPermissions } from '../permissions.cjs';
 import { S as SerializedForm, d as SerializedFormSubmissionWithData, F as Form, f as FormSubmission, a as SerializedFormSubmission, c as SerializedFormSubmissionSummary, g as FormSubmissionWithForm } from '../../../shared/stack.v2O65JqF.cjs';
 export { h as FormBuilderBackendConfig, i as FormBuilderBackendHooks, j as FormBuilderHookContext, k as FormBuilderOperationHookContext, l as FormCreateOperationContext, m as FormDeleteOperationContext, o as FormGetForUpdateOperationContext, n as FormGetOperationContext, p as FormListOperationContext, q as FormUpdateOperationContext, r as SubmissionCreateOperationContext, s as SubmissionDeleteOperationContext, t as SubmissionGetOperationContext, v as SubmissionHookContext, b as SubmissionListFormContext, u as SubmissionListOperationContext } from '../../../shared/stack.v2O65JqF.cjs';

package/dist/plugins/form-builder/api/index.d.mts

@@ -1,4 +1,4 @@
-export { k as FORM_QUERY_KEYS, a as FormBuilderApiRouter, c as FormBuilderOperationError, e as FormBuilderOperations, b as FormBuilderRouteKey, g as FormListOperationResult, h as SubmissionDetailOperationResult, i as SubmissionListOperationResult, j as SubmitOperationResult, d as createFormBuilderOperations, f as formBuilderBackendPlugin } from '../../../shared/stack.Doy2_wgl.mjs';
+export { k as FORM_QUERY_KEYS, a as FormBuilderApiRouter, c as FormBuilderOperationError, e as FormBuilderOperations, b as FormBuilderRouteKey, g as FormListOperationResult, h as SubmissionDetailOperationResult, i as SubmissionListOperationResult, j as SubmitOperationResult, d as createFormBuilderOperations, f as formBuilderBackendPlugin } from '../../../shared/stack.Egr3RWhA.mjs';
 export { formBuilderPermissions } from '../permissions.mjs';
 import { S as SerializedForm, d as SerializedFormSubmissionWithData, F as Form, f as FormSubmission, a as SerializedFormSubmission, c as SerializedFormSubmissionSummary, g as FormSubmissionWithForm } from '../../../shared/stack.OYT8WU4n.mjs';
 export { h as FormBuilderBackendConfig, i as FormBuilderBackendHooks, j as FormBuilderHookContext, k as FormBuilderOperationHookContext, l as FormCreateOperationContext, m as FormDeleteOperationContext, o as FormGetForUpdateOperationContext, n as FormGetOperationContext, p as FormListOperationContext, q as FormUpdateOperationContext, r as SubmissionCreateOperationContext, s as SubmissionDeleteOperationContext, t as SubmissionGetOperationContext, v as SubmissionHookContext, b as SubmissionListFormContext, u as SubmissionListOperationContext } from '../../../shared/stack.OYT8WU4n.mjs';

package/dist/plugins/form-builder/api/index.d.ts

@@ -1,4 +1,4 @@
-export { k as FORM_QUERY_KEYS, a as FormBuilderApiRouter, c as FormBuilderOperationError, e as FormBuilderOperations, b as FormBuilderRouteKey, g as FormListOperationResult, h as SubmissionDetailOperationResult, i as SubmissionListOperationResult, j as SubmitOperationResult, d as createFormBuilderOperations, f as formBuilderBackendPlugin } from '../../../shared/stack.CGmh-Lpe.js';
+export { k as FORM_QUERY_KEYS, a as FormBuilderApiRouter, c as FormBuilderOperationError, e as FormBuilderOperations, b as FormBuilderRouteKey, g as FormListOperationResult, h as SubmissionDetailOperationResult, i as SubmissionListOperationResult, j as SubmitOperationResult, d as createFormBuilderOperations, f as formBuilderBackendPlugin } from '../../../shared/stack.BuxUQqL8.js';
 export { formBuilderPermissions } from '../permissions.js';
 import { S as SerializedForm, d as SerializedFormSubmissionWithData, F as Form, f as FormSubmission, a as SerializedFormSubmission, c as SerializedFormSubmissionSummary, g as FormSubmissionWithForm } from '../../../shared/stack.C3bU9w6L.js';
 export { h as FormBuilderBackendConfig, i as FormBuilderBackendHooks, j as FormBuilderHookContext, k as FormBuilderOperationHookContext, l as FormCreateOperationContext, m as FormDeleteOperationContext, o as FormGetForUpdateOperationContext, n as FormGetOperationContext, p as FormListOperationContext, q as FormUpdateOperationContext, r as SubmissionCreateOperationContext, s as SubmissionDeleteOperationContext, t as SubmissionGetOperationContext, v as SubmissionHookContext, b as SubmissionListFormContext, u as SubmissionListOperationContext } from '../../../shared/stack.C3bU9w6L.js';

package/dist/plugins/form-builder/client/hooks/index.d.cts

@@ -8,7 +8,7 @@ import '@btst/stack/context';
 import '../../permissions.cjs';
 import 'zod';
 import '@btst/stack/plugins/client';
-import '../../../../shared/stack.zch70Loj.cjs';
+import '../../../../shared/stack.CX83YNuS.cjs';
 import '@btst/db';
 import 'zod/v4/core';
 import 'better-call';

package/dist/plugins/form-builder/client/hooks/index.d.mts

@@ -8,7 +8,7 @@ import '@btst/stack/context';
 import '../../permissions.mjs';
 import 'zod';
 import '@btst/stack/plugins/client';
-import '../../../../shared/stack.Doy2_wgl.mjs';
+import '../../../../shared/stack.Egr3RWhA.mjs';
 import '@btst/db';
 import 'zod/v4/core';
 import 'better-call';

package/dist/plugins/form-builder/client/hooks/index.d.ts

@@ -8,7 +8,7 @@ import '@btst/stack/context';
 import '../../permissions.js';
 import 'zod';
 import '@btst/stack/plugins/client';
-import '../../../../shared/stack.CGmh-Lpe.js';
+import '../../../../shared/stack.BuxUQqL8.js';
 import '@btst/db';
 import 'zod/v4/core';
 import 'better-call';

package/dist/plugins/form-builder/query-keys.d.cts

@@ -1,6 +1,6 @@
 import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { F as FormsListDiscriminator, S as SubmissionsListDiscriminator, a as FormBuilderApiRouter } from '../../shared/stack.zch70Loj.cjs';
+import { F as FormsListDiscriminator, S as SubmissionsListDiscriminator, a as FormBuilderApiRouter } from '../../shared/stack.CX83YNuS.cjs';
 import { P as PaginatedForms, S as SerializedForm, a as SerializedFormSubmission, e as PaginatedFormSubmissions, d as SerializedFormSubmissionWithData } from '../../shared/stack.v2O65JqF.cjs';
 import { StackIdentity } from '@btst/stack/context';
 import '@btst/stack/plugins/api';

package/dist/plugins/form-builder/query-keys.d.mts

@@ -1,6 +1,6 @@
 import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { F as FormsListDiscriminator, S as SubmissionsListDiscriminator, a as FormBuilderApiRouter } from '../../shared/stack.Doy2_wgl.mjs';
+import { F as FormsListDiscriminator, S as SubmissionsListDiscriminator, a as FormBuilderApiRouter } from '../../shared/stack.Egr3RWhA.mjs';
 import { P as PaginatedForms, S as SerializedForm, a as SerializedFormSubmission, e as PaginatedFormSubmissions, d as SerializedFormSubmissionWithData } from '../../shared/stack.OYT8WU4n.mjs';
 import { StackIdentity } from '@btst/stack/context';
 import '@btst/stack/plugins/api';

package/dist/plugins/form-builder/query-keys.d.ts

@@ -1,6 +1,6 @@
 import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { F as FormsListDiscriminator, S as SubmissionsListDiscriminator, a as FormBuilderApiRouter } from '../../shared/stack.CGmh-Lpe.js';
+import { F as FormsListDiscriminator, S as SubmissionsListDiscriminator, a as FormBuilderApiRouter } from '../../shared/stack.BuxUQqL8.js';
 import { P as PaginatedForms, S as SerializedForm, a as SerializedFormSubmission, e as PaginatedFormSubmissions, d as SerializedFormSubmissionWithData } from '../../shared/stack.C3bU9w6L.js';
 import { StackIdentity } from '@btst/stack/context';
 import '@btst/stack/plugins/api';

package/dist/plugins/ui-builder/client/hooks/index.d.cts

@@ -9,7 +9,7 @@ import '../../../../shared/stack.fdi94T4S.cjs';
 import 'react-hook-form';
 import 'react/jsx-runtime';
 import '@btst/stack/plugins/client';
-import '../../../../shared/stack.D6Pg-ufX.cjs';
+import '../../../../shared/stack.Bf6BGZNk.cjs';
 import '@btst/stack/plugins/api';
 import '../../../../authorization/index.cjs';
 import 'better-call';

package/dist/plugins/ui-builder/client/hooks/index.d.mts

@@ -9,7 +9,7 @@ import '../../../../shared/stack.fdi94T4S.mjs';
 import 'react-hook-form';
 import 'react/jsx-runtime';
 import '@btst/stack/plugins/client';
-import '../../../../shared/stack.B8PG21zX.mjs';
+import '../../../../shared/stack.BLYaUcQa.mjs';
 import '@btst/stack/plugins/api';
 import '../../../../authorization/index.mjs';
 import 'better-call';

package/dist/plugins/ui-builder/client/hooks/index.d.ts

@@ -9,7 +9,7 @@ import '../../../../shared/stack.fdi94T4S.js';
 import 'react-hook-form';
 import 'react/jsx-runtime';
 import '@btst/stack/plugins/client';
-import '../../../../shared/stack.CyalJ0j6.js';
+import '../../../../shared/stack.CyltNNZZ.js';
 import '@btst/stack/plugins/api';
 import '../../../../authorization/index.js';
 import 'better-call';

package/dist/plugins/ui-builder/client/index.d.cts

@@ -15,7 +15,7 @@ import '../../../shared/stack.B3_aDcYL.cjs';
 import 'react-hook-form';
 import '@tanstack/react-query';
 import '@btst/stack/plugins/client/hooks';
-import '../../../shared/stack.D6Pg-ufX.cjs';
+import '../../../shared/stack.Bf6BGZNk.cjs';
 import '@btst/stack/plugins/api';
 import '../../../authorization/index.cjs';
 import 'better-call';

package/dist/plugins/ui-builder/client/index.d.mts

@@ -15,7 +15,7 @@ import '../../../shared/stack.B3_aDcYL.mjs';
 import 'react-hook-form';
 import '@tanstack/react-query';
 import '@btst/stack/plugins/client/hooks';
-import '../../../shared/stack.B8PG21zX.mjs';
+import '../../../shared/stack.BLYaUcQa.mjs';
 import '@btst/stack/plugins/api';
 import '../../../authorization/index.mjs';
 import 'better-call';

package/dist/plugins/ui-builder/client/index.d.ts

@@ -15,7 +15,7 @@ import '../../../shared/stack.B3_aDcYL.js';
 import 'react-hook-form';
 import '@tanstack/react-query';
 import '@btst/stack/plugins/client/hooks';
-import '../../../shared/stack.CyalJ0j6.js';
+import '../../../shared/stack.CyltNNZZ.js';
 import '@btst/stack/plugins/api';
 import '../../../authorization/index.js';
 import 'better-call';

package/dist/plugins/ui-builder/query-keys.d.cts

@@ -1,6 +1,6 @@
 import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { a as ContentListDiscriminator, C as CMSApiRouter } from '../../shared/stack.D6Pg-ufX.cjs';
+import { a as ContentListDiscriminator, C as CMSApiRouter } from '../../shared/stack.Bf6BGZNk.cjs';
 import { C as ComponentLayer, V as Variable } from '../../shared/stack.DmpPDPxA.cjs';
 import { P as PaginatedContentItems, a as SerializedContentItemWithType } from '../../shared/stack.B3_aDcYL.cjs';
 import { UIBuilderPageSchemaType, PaginatedUIBuilderPages, SerializedUIBuilderPage } from './index.cjs';

package/dist/plugins/ui-builder/query-keys.d.mts

@@ -1,6 +1,6 @@
 import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { a as ContentListDiscriminator, C as CMSApiRouter } from '../../shared/stack.B8PG21zX.mjs';
+import { a as ContentListDiscriminator, C as CMSApiRouter } from '../../shared/stack.BLYaUcQa.mjs';
 import { C as ComponentLayer, V as Variable } from '../../shared/stack.B1srlBud.mjs';
 import { P as PaginatedContentItems, a as SerializedContentItemWithType } from '../../shared/stack.B3_aDcYL.mjs';
 import { UIBuilderPageSchemaType, PaginatedUIBuilderPages, SerializedUIBuilderPage } from './index.mjs';

package/dist/plugins/ui-builder/query-keys.d.ts

@@ -1,6 +1,6 @@
 import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { a as ContentListDiscriminator, C as CMSApiRouter } from '../../shared/stack.CyalJ0j6.js';
+import { a as ContentListDiscriminator, C as CMSApiRouter } from '../../shared/stack.CyltNNZZ.js';
 import { C as ComponentLayer, V as Variable } from '../../shared/stack.BK9Z2dcL.js';
 import { P as PaginatedContentItems, a as SerializedContentItemWithType } from '../../shared/stack.B3_aDcYL.js';
 import { UIBuilderPageSchemaType, PaginatedUIBuilderPages, SerializedUIBuilderPage } from './index.js';

package/dist/shared/{stack.DDQlE2Pm.d.cts → stack.Cei2T2gc.d.cts}

@@ -44,6 +44,7 @@ interface AiChatLocalization {
     CHAT_EMPTY_STATE: string;
     CHAT_LOADING: string;
     CHAT_COMPACTING?: string;
+    CHAT_INTERRUPTED?: string;
     CHAT_ERROR: string;
     CHAT_RETRY: string;
     CHAT_GENERIC_ERROR_TITLE: string;

package/dist/shared/{stack.C4zspX0T.d.ts → stack.DDQTbADz.d.ts}

@@ -31,6 +31,8 @@ type Message = {
     conversationId: string;
     role: "system" | "user" | "assistant" | "data";
     content: string;
+    /** True when generation stopped before a successful completion. */
+    interrupted?: boolean | null;
     createdAt: Date;
 };
 type SerializedConversation = Omit<Conversation, "createdAt" | "updatedAt"> & {
@@ -55,10 +57,12 @@ interface AiChatPageContentConfig {
     description?: string;
 }
 
-/** Opt-in context compaction for public, text-only conversations. */
+/** Opt-in context compaction for conversations containing text and images. */
 interface AiChatCompactionConfig {
     /** Actual context window. Configure the model's output limit at or below 20% of this. */
     contextWindowTokens: number;
+    /** Estimated tokens per image, excluding encoded bytes. Default: 4096. Increase for models with higher image token costs. */
+    imageTokenEstimate?: number;
 }
 
 type AiChatAccess = "authorized" | "public";
@@ -228,7 +232,7 @@ interface AiChatBackendConfig {
      */
     access?: AiChatAccess;
     systemPrompt?: string;
-    /** Automatically summarize older context in public text chats; off by default. */
+    /** Automatically summarize older text and image context; off by default. */
     compaction?: AiChatCompactionConfig;
     tools?: Record<string, Tool>;
     /** Enable the standard readPage server tool for full page content. Reserves the readPage tool name. */
@@ -319,6 +323,7 @@ declare const aiChatBackendPlugin: <TTools extends Record<string, Tool> = Record
             readonly conversationId: string;
             readonly role: "system" | "user" | "assistant" | "data";
             readonly content: string;
+            readonly interrupted?: boolean | null | undefined;
             readonly createdAt: string;
         }[];
     }>;

package/dist/shared/{stack.tAUeRAtd.d.mts → stack.DZRZAzcx.d.mts}

@@ -44,6 +44,7 @@ interface AiChatLocalization {
     CHAT_EMPTY_STATE: string;
     CHAT_LOADING: string;
     CHAT_COMPACTING?: string;
+    CHAT_INTERRUPTED?: string;
     CHAT_ERROR: string;
     CHAT_RETRY: string;
     CHAT_GENERIC_ERROR_TITLE: string;

package/dist/shared/{stack.ymWsP4HZ.d.cts → stack.IY-ngxuw.d.cts}

@@ -31,6 +31,8 @@ type Message = {
     conversationId: string;
     role: "system" | "user" | "assistant" | "data";
     content: string;
+    /** True when generation stopped before a successful completion. */
+    interrupted?: boolean | null;
     createdAt: Date;
 };
 type SerializedConversation = Omit<Conversation, "createdAt" | "updatedAt"> & {
@@ -55,10 +57,12 @@ interface AiChatPageContentConfig {
     description?: string;
 }
 
-/** Opt-in context compaction for public, text-only conversations. */
+/** Opt-in context compaction for conversations containing text and images. */
 interface AiChatCompactionConfig {
     /** Actual context window. Configure the model's output limit at or below 20% of this. */
     contextWindowTokens: number;
+    /** Estimated tokens per image, excluding encoded bytes. Default: 4096. Increase for models with higher image token costs. */
+    imageTokenEstimate?: number;
 }
 
 type AiChatAccess = "authorized" | "public";
@@ -228,7 +232,7 @@ interface AiChatBackendConfig {
      */
     access?: AiChatAccess;
     systemPrompt?: string;
-    /** Automatically summarize older context in public text chats; off by default. */
+    /** Automatically summarize older text and image context; off by default. */
     compaction?: AiChatCompactionConfig;
     tools?: Record<string, Tool>;
     /** Enable the standard readPage server tool for full page content. Reserves the readPage tool name. */
@@ -319,6 +323,7 @@ declare const aiChatBackendPlugin: <TTools extends Record<string, Tool> = Record
             readonly conversationId: string;
             readonly role: "system" | "user" | "assistant" | "data";
             readonly content: string;
+            readonly interrupted?: boolean | null | undefined;
             readonly createdAt: string;
         }[];
     }>;

package/dist/shared/{stack.DlehgNZZ.d.ts → stack.byjorQi5.d.ts}

@@ -44,6 +44,7 @@ interface AiChatLocalization {
     CHAT_EMPTY_STATE: string;
     CHAT_LOADING: string;
     CHAT_COMPACTING?: string;
+    CHAT_INTERRUPTED?: string;
     CHAT_ERROR: string;
     CHAT_RETRY: string;
     CHAT_GENERIC_ERROR_TITLE: string;

package/dist/shared/{stack.Ps3MDhTC.d.mts → stack.mU9iMF2j.d.mts}

@@ -31,6 +31,8 @@ type Message = {
     conversationId: string;
     role: "system" | "user" | "assistant" | "data";
     content: string;
+    /** True when generation stopped before a successful completion. */
+    interrupted?: boolean | null;
     createdAt: Date;
 };
 type SerializedConversation = Omit<Conversation, "createdAt" | "updatedAt"> & {
@@ -55,10 +57,12 @@ interface AiChatPageContentConfig {
     description?: string;
 }
 
-/** Opt-in context compaction for public, text-only conversations. */
+/** Opt-in context compaction for conversations containing text and images. */
 interface AiChatCompactionConfig {
     /** Actual context window. Configure the model's output limit at or below 20% of this. */
     contextWindowTokens: number;
+    /** Estimated tokens per image, excluding encoded bytes. Default: 4096. Increase for models with higher image token costs. */
+    imageTokenEstimate?: number;
 }
 
 type AiChatAccess = "authorized" | "public";
@@ -228,7 +232,7 @@ interface AiChatBackendConfig {
      */
     access?: AiChatAccess;
     systemPrompt?: string;
-    /** Automatically summarize older context in public text chats; off by default. */
+    /** Automatically summarize older text and image context; off by default. */
     compaction?: AiChatCompactionConfig;
     tools?: Record<string, Tool>;
     /** Enable the standard readPage server tool for full page content. Reserves the readPage tool name. */
@@ -319,6 +323,7 @@ declare const aiChatBackendPlugin: <TTools extends Record<string, Tool> = Record
             readonly conversationId: string;
             readonly role: "system" | "user" | "assistant" | "data";
             readonly content: string;
+            readonly interrupted?: boolean | null | undefined;
             readonly createdAt: string;
         }[];
     }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btst/stack",
-  "version": "4.4.0",
+  "version": "4.5.1",
   "description": "A composable, plugin-based library for building full-stack applications.",
   "repository": {
     "type": "git",

package/src/plugins/ai-chat/__tests__/authorization.test.ts

@@ -14,18 +14,53 @@ import {
 import { aiChatPermissions } from "../permissions";
 import type { Conversation, Message } from "../types";
 
-const { streamText } = vi.hoisted(() => ({
+const { streamText, completions } = vi.hoisted(() => ({
+	completions: [] as Array<
+		NonNullable<
+			Parameters<typeof import("ai").createUIMessageStream>[0]["onFinish"]
+		>
+	>,
 	streamText: vi.fn(() => ({
+		toUIMessageStream: () =>
+			new ReadableStream({
+				start(controller) {
+					controller.close();
+				},
+			}),
 		toUIMessageStreamResponse: () => new Response("stream", { status: 200 }),
 	})),
 }));
 
-vi.mock("ai", async (importOriginal) => ({
-	...(await importOriginal<typeof import("ai")>()),
-	convertToModelMessages: (messages: unknown) => messages,
-	stepCountIs: () => () => false,
-	streamText,
-}));
+vi.mock("ai", async (importOriginal) => {
+	const original = await importOriginal<typeof import("ai")>();
+	return {
+		...original,
+		createUIMessageStream: (
+			options: Parameters<typeof original.createUIMessageStream>[0],
+		) => {
+			if (options.onFinish) completions.push(options.onFinish);
+			return original.createUIMessageStream(options);
+		},
+		convertToModelMessages: (messages: unknown) => messages,
+		stepCountIs: () => () => false,
+		streamText,
+	};
+});
+
+function completion(text: string) {
+	const responseMessage = {
+		id: "server-response",
+		role: "assistant" as const,
+		parts: [{ type: "text" as const, text }],
+	};
+	return {
+		responseMessage,
+		messages: [responseMessage],
+		isAborted: false,
+		isContinuation: false,
+		finishReason: "stop" as const,
+	};
+}
 
 type Identity = { id: string; role: "user" | "admin" };
 
@@ -173,7 +208,10 @@ async function seedMessage(
 }
 
 describe("AI Chat operation authorization", () => {
-	beforeEach(() => streamText.mockClear());
+	beforeEach(() => {
+		streamText.mockClear();
+		completions.length = 0;
+	});
 
 	it("publishes one executable inventory for every maintained transport", () => {
 		const plugin = aiChatBackendPlugin({ model });
@@ -815,15 +853,7 @@ describe("AI Chat operation authorization", () => {
 		await app
 			.forRequest(request("/chat", { identity: owner }))
 			.operations.aiChat.startStream(messageBody);
-		const finish = (
-			streamText.mock.calls as unknown as Array<
-				[
-					{
-						onFinish: (completion: { text: string }) => Promise<void>;
-					},
-				]
-			>
-		)[0]?.[0].onFinish;
+		const finish = completions[0];
 		expect(finish).toBeDefined();
 		if (!finish) throw new Error("Missing stream completion callback");
 		const adapterConfig = app.adapter.options?.adapterConfig;
@@ -831,7 +861,7 @@ describe("AI Chat operation authorization", () => {
 		if (!adapterConfig) throw new Error("Missing adapter config");
 		adapterConfig.transaction = false;
 
-		await finish({ text: "unsafe answer" });
+		await finish(completion("unsafe answer"));
 
 		expect(
 			await app.adapter.count({
@@ -876,6 +906,7 @@ describe("AI Chat operation authorization", () => {
 			identity: z.object({ id: z.string(), role: z.enum(["user", "admin"]) }),
 			permissions: [aiChatPermissions] as const,
 			rules: ({ aiChat }) => [
+				aiChat.conversation.read.allow(),
 				aiChat.stream.start.allow(),
 				aiChat.message.retry.when(({ facts }) => {
 					observed.push({ intent: "retry", messageId: facts.messageId });
@@ -959,6 +990,7 @@ describe("AI Chat operation authorization", () => {
 			identity: z.object({ id: z.string(), role: z.enum(["user", "admin"]) }),
 			permissions: [aiChatPermissions] as const,
 			rules: ({ aiChat }) => [
+				aiChat.conversation.read.allow(),
 				aiChat.stream.start.allow(),
 				aiChat.message.retry.allow(),
 				aiChat.message.edit.when(() => false),
@@ -1030,6 +1062,7 @@ describe("AI Chat operation authorization", () => {
 			identity: z.object({ id: z.string(), role: z.enum(["user", "admin"]) }),
 			permissions: [aiChatPermissions] as const,
 			rules: ({ aiChat }) => [
+				aiChat.conversation.read.allow(),
 				aiChat.stream.start.allow(),
 				aiChat.message.send.allow(),
 				aiChat.message.retry.when(({ facts }) => observedRetry(facts)),
@@ -1490,7 +1523,7 @@ describe("AI Chat operation authorization", () => {
 		expect(before).not.toHaveBeenCalled();
 		expect(streamText).not.toHaveBeenCalled();
 		expect(await app.adapter.count({ model: "message" })).toBe(0);
-		expect(onError).toHaveBeenCalledOnce();
+		expect(onError).not.toHaveBeenCalled();
 	});
 
 	it("rechecks a missing requested conversation before entering hooks", async () => {
@@ -1962,20 +1995,13 @@ describe("AI Chat operation authorization", () => {
 		await app
 			.forRequest(request("/first", { identity: owner }))
 			.operations.aiChat.startStream(input);
-		const streamCalls = streamText.mock.calls as unknown as Array<
-			[
-				{
-					onFinish: (completion: { text: string }) => Promise<void>;
-				},
-			]
-		>;
-		const firstFinish = streamCalls[0]?.[0].onFinish;
+		const firstFinish = completions[0];
 		await app
 			.forRequest(request("/second", { identity: owner }))
 			.operations.aiChat.startStream(input);
-		const secondFinish = streamCalls[1]?.[0].onFinish;
+		const secondFinish = completions[1];
 
-		await firstFinish?.({ text: "stale answer" });
+		await firstFinish?.(completion("stale answer"));
 		expect(
 			await app.adapter.count({
 				model: "message",
@@ -1984,7 +2010,7 @@ describe("AI Chat operation authorization", () => {
 		).toBe(0);
 		expect(onErrorChat).toHaveBeenCalledOnce();
 
-		await secondFinish?.({ text: "current answer" });
+		await secondFinish?.(completion("current answer"));
 		const assistants = await app.adapter.findMany<Message>({
 			model: "message",
 			where: [{ field: "role", value: "assistant", operator: "eq" }],

package/src/plugins/ai-chat/__tests__/chat-input-authorization.test.tsx

@@ -37,6 +37,48 @@ afterEach(async () => {
 });
 
 describe("AI Chat attachment authorization", () => {
+	it("uses the configured upload transport in public mode without requiring a saved-chat identity", async () => {
+		const uploadFile = vi.fn(async () => "https://files/public.png");
+		const onFilesAttached = vi.fn();
+		await act(async () => {
+			root.render(
+				<StackProvider
+					stack={createTestClientStack({
+						aiChat: aiChatClientPlugin({ mode: "public" }),
+					})}
+					overrides={{ aiChat: { uploadFile, allowedFileTypes: ["image"] } }}
+				>
+					<ChatInput
+						handleInputChange={() => {}}
+						handleSubmit={() => {}}
+						isLoading={false}
+						attachedFiles={[]}
+						onFilesAttached={onFilesAttached}
+					/>
+				</StackProvider>,
+			);
+		});
+		const input =
+			container.querySelector<HTMLInputElement>('input[type="file"]');
+		expect(input).toBeTruthy();
+		Object.defineProperty(input!, "files", {
+			configurable: true,
+			value: [new File(["image"], "public.png", { type: "image/png" })],
+		});
+		await act(async () => {
+			input!.dispatchEvent(new Event("change", { bubbles: true }));
+			await Promise.resolve();
+		});
+		expect(uploadFile).toHaveBeenCalledOnce();
+		expect(onFilesAttached).toHaveBeenCalledWith([
+			{
+				url: "https://files/public.png",
+				mediaType: "image/png",
+				filename: "public.png",
+			},
+		]);
+	});
+
 	it("checks the selected MIME type before calling the upload transport", async () => {
 		const observedMediaTypes: string[][] = [];
 		const authorization = defineAuthorization({

package/src/plugins/ai-chat/__tests__/classnames-overrides.test.tsx

@@ -161,6 +161,31 @@ function query(selector: string): HTMLElement {
 }
 
 describe("ai-chat classNames overrides (issue #36)", () => {
+	it("labels interrupted responses and stops unfinished tool indicators", async () => {
+		await render(
+			<ChatMessage
+				message={{
+					...assistantMessage,
+					metadata: { interrupted: true },
+					parts: [
+						...assistantMessage.parts,
+						{
+							type: "tool-inspect",
+							toolCallId: "pending",
+							state: "input-available",
+							input: {},
+						},
+					],
+				}}
+			/>,
+		);
+		expect(query('[data-testid="chat-interrupted"]').textContent).toBe(
+			"Response interrupted",
+		);
+		expect(container.textContent).not.toContain("Executing...");
+		expect(container.querySelector(".animate-spin")).toBeNull();
+	});
+
 	it("applies message, userMessage and assistantMessage to a user message", async () => {
 		await render(<ChatMessage message={userMessage} />);