@btst/stack 4.5.0 → 4.6.0

package/dist/shared/{stack.BggTHKlo.d.mts → stack.Dvy7FmaA.d.mts}

@@ -2,7 +2,7 @@ import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import { createApiClient } from '@btst/stack/plugins/client';
 import * as zod from 'zod';
 import { z } from 'zod';
-import { c as createPostSchema, u as updatePostSchema } from './stack.CKc_Bais.mjs';
+import { c as createPostSchema, u as updatePostSchema } from './stack.Csi-4Mgz.mjs';
 import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from './stack.Dsatjh0B.mjs';
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import { DeepReadonly, OperationContext, OperationErrorContext } from '@btst/stack/plugins/api';
@@ -89,12 +89,6 @@ declare const NextPreviousPostsQuerySchema: z.ZodObject<{
     date: z.ZodPipe<z.ZodCoercedDate<unknown>, z.ZodTransform<string, Date>>;
 }, z.core.$strip>;
 declare const CreatePostOperationInputSchema: z.ZodObject<{
-    slug: z.ZodOptional<z.ZodString>;
-    title: z.ZodString;
-    content: z.ZodString;
-    excerpt: z.ZodString;
-    image: z.ZodOptional<z.ZodString>;
-    published: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         name: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
@@ -102,6 +96,12 @@ declare const CreatePostOperationInputSchema: z.ZodObject<{
         name: z.ZodString;
         slug: z.ZodString;
     }, z.core.$strip>]>>>>;
+    slug: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    content: z.ZodString;
+    excerpt: z.ZodString;
+    image: z.ZodOptional<z.ZodString>;
+    published: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     publishedAt: z.ZodOptional<z.ZodPipe<z.ZodCoercedDate<unknown>, z.ZodTransform<string, Date>>>;
     createdAt: z.ZodOptional<z.ZodPipe<z.ZodCoercedDate<unknown>, z.ZodTransform<string, Date>>>;
     updatedAt: z.ZodOptional<z.ZodPipe<z.ZodCoercedDate<unknown>, z.ZodTransform<string, Date>>>;
@@ -109,12 +109,6 @@ declare const CreatePostOperationInputSchema: z.ZodObject<{
 declare const UpdatePostOperationInputSchema: z.ZodObject<{
     id: z.ZodString;
     data: z.ZodObject<{
-        slug: z.ZodString;
-        title: z.ZodString;
-        content: z.ZodString;
-        excerpt: z.ZodString;
-        image: z.ZodOptional<z.ZodString>;
-        published: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             name: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
@@ -122,6 +116,12 @@ declare const UpdatePostOperationInputSchema: z.ZodObject<{
             name: z.ZodString;
             slug: z.ZodString;
         }, z.core.$strip>]>>>>;
+        slug: z.ZodString;
+        title: z.ZodString;
+        content: z.ZodString;
+        excerpt: z.ZodString;
+        image: z.ZodOptional<z.ZodString>;
+        published: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         publishedAt: z.ZodOptional<z.ZodPipe<z.ZodCoercedDate<unknown>, z.ZodTransform<string, Date>>>;
         createdAt: z.ZodOptional<z.ZodPipe<z.ZodCoercedDate<unknown>, z.ZodTransform<string, Date>>>;
         updatedAt: z.ZodOptional<z.ZodPipe<z.ZodCoercedDate<unknown>, z.ZodTransform<string, Date>>>;
@@ -386,9 +386,6 @@ declare const blogBackendPlugin: (options?: BlogBackendOptions) => _btst_stack_p
             title: string;
             content: string;
             excerpt: string;
-            slug?: string | undefined;
-            image?: string | undefined;
-            published?: boolean | undefined;
             tags?: ({
                 name: string;
             } | {
@@ -396,6 +393,9 @@ declare const blogBackendPlugin: (options?: BlogBackendOptions) => _btst_stack_p
                 name: string;
                 slug: string;
             })[] | undefined;
+            slug?: string | undefined;
+            image?: string | undefined;
+            published?: boolean | undefined;
             publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
@@ -403,9 +403,6 @@ declare const blogBackendPlugin: (options?: BlogBackendOptions) => _btst_stack_p
             title: string;
             content: string;
             excerpt: string;
-            slug?: string | undefined;
-            image?: string | undefined;
-            published?: boolean | undefined;
             tags?: ({
                 name: string;
             } | {
@@ -413,6 +410,9 @@ declare const blogBackendPlugin: (options?: BlogBackendOptions) => _btst_stack_p
                 name: string;
                 slug: string;
             })[] | undefined;
+            slug?: string | undefined;
+            image?: string | undefined;
+            published?: boolean | undefined;
             publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
@@ -448,8 +448,6 @@ declare const blogBackendPlugin: (options?: BlogBackendOptions) => _btst_stack_p
             title: string;
             content: string;
             excerpt: string;
-            image?: string | undefined;
-            published?: boolean | undefined;
             tags?: ({
                 name: string;
             } | {
@@ -457,6 +455,8 @@ declare const blogBackendPlugin: (options?: BlogBackendOptions) => _btst_stack_p
                 name: string;
                 slug: string;
             })[] | undefined;
+            image?: string | undefined;
+            published?: boolean | undefined;
             publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
@@ -465,8 +465,6 @@ declare const blogBackendPlugin: (options?: BlogBackendOptions) => _btst_stack_p
             title: string;
             content: string;
             excerpt: string;
-            image?: string | undefined;
-            published?: boolean | undefined;
             tags?: ({
                 name: string;
             } | {
@@ -474,6 +472,8 @@ declare const blogBackendPlugin: (options?: BlogBackendOptions) => _btst_stack_p
                 name: string;
                 slug: string;
             })[] | undefined;
+            image?: string | undefined;
+            published?: boolean | undefined;
             publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
@@ -627,12 +627,6 @@ declare const blogBackendPlugin: (options?: BlogBackendOptions) => _btst_stack_p
         total: number;
     }, false>;
     readonly createPost: _btst_stack_plugins_api.Operation<zod.ZodObject<{
-        slug: zod.ZodOptional<zod.ZodString>;
-        title: zod.ZodString;
-        content: zod.ZodString;
-        excerpt: zod.ZodString;
-        image: zod.ZodOptional<zod.ZodString>;
-        published: zod.ZodDefault<zod.ZodOptional<zod.ZodBoolean>>;
         tags: zod.ZodDefault<zod.ZodOptional<zod.ZodArray<zod.ZodUnion<readonly [zod.ZodObject<{
             name: zod.ZodString;
         }, zod_v4_core.$strip>, zod.ZodObject<{
@@ -640,6 +634,12 @@ declare const blogBackendPlugin: (options?: BlogBackendOptions) => _btst_stack_p
             name: zod.ZodString;
             slug: zod.ZodString;
         }, zod_v4_core.$strip>]>>>>;
+        slug: zod.ZodOptional<zod.ZodString>;
+        title: zod.ZodString;
+        content: zod.ZodString;
+        excerpt: zod.ZodString;
+        image: zod.ZodOptional<zod.ZodString>;
+        published: zod.ZodDefault<zod.ZodOptional<zod.ZodBoolean>>;
         publishedAt: zod.ZodOptional<zod.ZodPipe<zod.ZodCoercedDate<unknown>, zod.ZodTransform<string, Date>>>;
         createdAt: zod.ZodOptional<zod.ZodPipe<zod.ZodCoercedDate<unknown>, zod.ZodTransform<string, Date>>>;
         updatedAt: zod.ZodOptional<zod.ZodPipe<zod.ZodCoercedDate<unknown>, zod.ZodTransform<string, Date>>>;
@@ -673,12 +673,6 @@ declare const blogBackendPlugin: (options?: BlogBackendOptions) => _btst_stack_p
     readonly updatePost: _btst_stack_plugins_api.Operation<zod.ZodObject<{
         id: zod.ZodString;
         data: zod.ZodObject<{
-            slug: zod.ZodString;
-            title: zod.ZodString;
-            content: zod.ZodString;
-            excerpt: zod.ZodString;
-            image: zod.ZodOptional<zod.ZodString>;
-            published: zod.ZodDefault<zod.ZodOptional<zod.ZodBoolean>>;
             tags: zod.ZodDefault<zod.ZodOptional<zod.ZodArray<zod.ZodUnion<readonly [zod.ZodObject<{
                 name: zod.ZodString;
             }, zod_v4_core.$strip>, zod.ZodObject<{
@@ -686,6 +680,12 @@ declare const blogBackendPlugin: (options?: BlogBackendOptions) => _btst_stack_p
                 name: zod.ZodString;
                 slug: zod.ZodString;
             }, zod_v4_core.$strip>]>>>>;
+            slug: zod.ZodString;
+            title: zod.ZodString;
+            content: zod.ZodString;
+            excerpt: zod.ZodString;
+            image: zod.ZodOptional<zod.ZodString>;
+            published: zod.ZodDefault<zod.ZodOptional<zod.ZodBoolean>>;
             publishedAt: zod.ZodOptional<zod.ZodPipe<zod.ZodCoercedDate<unknown>, zod.ZodTransform<string, Date>>>;
             createdAt: zod.ZodOptional<zod.ZodPipe<zod.ZodCoercedDate<unknown>, zod.ZodTransform<string, Date>>>;
             updatedAt: zod.ZodOptional<zod.ZodPipe<zod.ZodCoercedDate<unknown>, zod.ZodTransform<string, Date>>>;

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

@@ -57,10 +57,12 @@ interface AiChatPageContentConfig {
     description?: string;
 }
 
-/** Opt-in context compaction for 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";
@@ -230,7 +232,7 @@ interface AiChatBackendConfig {
      */
     access?: AiChatAccess;
     systemPrompt?: string;
-    /** Automatically summarize older context in 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. */

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

@@ -57,10 +57,12 @@ interface AiChatPageContentConfig {
     description?: string;
 }
 
-/** Opt-in context compaction for 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";
@@ -230,7 +232,7 @@ interface AiChatBackendConfig {
      */
     access?: AiChatAccess;
     systemPrompt?: string;
-    /** Automatically summarize older context in 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. */

package/package.json

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

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__/compaction.test.ts

@@ -56,6 +56,85 @@ describe("public context compaction", () => {
 		expect(summarize).toHaveBeenCalledOnce();
 	});
 
+	it("counts image content separately from inline bytes and keeps tool output as text", () => {
+		const inline = {
+			role: "user",
+			parts: [
+				{
+					type: "file",
+					mediaType: "image/png",
+					url: "data:image/png;base64," + "A".repeat(100_000),
+				},
+			],
+		};
+		const remote = {
+			role: "user",
+			parts: [
+				{
+					type: "file",
+					mediaType: "image/png",
+					url: "https://example.org/image.png",
+				},
+			],
+		};
+		expect(estimateContextTokens([inline])).toBe(
+			estimateContextTokens([remote]),
+		);
+		expect(estimateContextTokens([inline])).toBeGreaterThanOrEqual(4096);
+		const toolOutput = {
+			role: "tool",
+			content: [
+				{ type: "tool-result", output: { type: "json", value: inline } },
+			],
+		};
+		expect(estimateContextTokens([toolOutput])).toBeGreaterThan(30_000);
+	});
+
+	it("sends older images as vision input when summarizing instead of serialized bytes", async () => {
+		const png =
+			"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+jr1sAAAAASUVORK5CYII=";
+		const original = [
+			message("u1", "user", "Remember the number in this image"),
+		];
+		original[0]!.parts.push({ type: "file", mediaType: "image/png", url: png });
+		const model = new MockLanguageModelV2({
+			doGenerate: async ({ prompt }) => ({
+				content: [
+					{
+						type: "text",
+						text: JSON.stringify(prompt).includes('"type":"file"')
+							? "The image shows verification number 917."
+							: "The user wants to remember the image number.",
+					},
+				],
+				finishReason: "stop",
+				usage: { inputTokens: 100, outputTokens: 20, totalTokens: 120 },
+				warnings: [],
+			}),
+		});
+		const before = structuredClone(original);
+		const summary = await createSummarizer(
+			model,
+			16_384,
+		)({ messages: original });
+		expect(summary).toContain("917");
+		expect(
+			model.doGenerateCalls.some((call) =>
+				call.prompt.some(
+					(message) =>
+						message.role === "user" &&
+						message.content.some(
+							(part) => part.type === "file" && part.mediaType === "image/png",
+						),
+				),
+			),
+		).toBe(true);
+		expect(JSON.stringify(model.doGenerateCalls)).not.toContain(
+			"data:image/png;base64",
+		);
+		expect(original).toEqual(before);
+	});
+
 	it("reuses a checkpoint only while all summarized messages are unchanged", () => {
 		const checkpoint = captureContextCheckpoint(history, "summary", "a1");
 		expect(contextRequest(history, checkpoint)).toEqual({
@@ -219,25 +298,6 @@ describe("public context compaction", () => {
 					body: JSON.stringify(body),
 				}),
 			);
-		const attachment = await send({
-			messages: [
-				{
-					id: "file",
-					role: "user",
-					parts: [
-						{
-							type: "file",
-							mediaType: "image/png",
-							url: "https://example.org/image.png",
-						},
-					],
-				},
-			],
-		});
-		expect(attachment.status).toBe(400);
-		expect(await attachment.text()).toContain("text-only");
-		expect(model.doGenerateCalls).toHaveLength(0);
-		expect(model.doStreamCalls).toHaveLength(0);
 		const response = await send({ messages: history });
 		expect(response.status).toBe(200);
 		const text = await response.text();

package/src/plugins/ai-chat/__tests__/persisted-compaction.test.ts

@@ -77,6 +77,7 @@ function backend(
 			return [
 				aiChat.stream.start.when(owns),
 				aiChat.message.send.when(owns),
+				aiChat.attachment.send.when(owns),
 				aiChat.message.retry.when(owns),
 				aiChat.message.edit.when(owns),
 				aiChat.tool.activate.when(owns),
@@ -162,6 +163,134 @@ async function seed(app: ReturnType<typeof backend>["app"]) {
 }
 
 describe("persisted context compaction", () => {
+	it.each([undefined, 1, "application/pdf"])(
+		"rejects unsupported attachment media type %s as a client error",
+		async (mediaType) => {
+			const { app, languageModel } = backend();
+			const response = await app.handler(
+				new Request("http://localhost/api/chat", {
+					method: "POST",
+					headers: { "content-type": "application/json" },
+					body: JSON.stringify({
+						messages: [
+							{
+								id: "bad-file",
+								role: "user",
+								parts: [
+									{ type: "file", mediaType, url: "https://example.org/file" },
+								],
+							},
+						],
+					}),
+				}),
+			);
+			expect(response.status).toBe(400);
+			expect(languageModel.doGenerateCalls).toHaveLength(0);
+			expect(languageModel.doStreamCalls).toHaveLength(0);
+		},
+	);
+
+	it.each(["public", "authorized"] as const)(
+		"keeps images usable across compaction and resume in %s chats",
+		async (access) => {
+			const { app, languageModel, errors } = backend(model(), {
+				access,
+				compaction: { contextWindowTokens: 16_384 },
+			});
+			const png =
+				"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+jr1sAAAAASUVORK5CYII=";
+			const first = text(
+				"image-1",
+				"user",
+				"Remember this image. " + "research ".repeat(2500),
+			);
+			first.parts.push({ type: "file", mediaType: "image/png", url: png });
+			const request = (body: unknown) =>
+				app.handler(
+					new Request("http://localhost/api/chat", {
+						method: "POST",
+						headers: { "content-type": "application/json" },
+						body: JSON.stringify(body),
+					}),
+				);
+			const firstResponse = await request({ messages: [first] });
+			expect(firstResponse.status).toBe(200);
+			expect(await firstResponse.text()).toContain("ORCHID-917");
+			expect(languageModel.doGenerateCalls).toHaveLength(0);
+			const id = firstResponse.headers.get("X-Conversation-Id");
+			const previous =
+				access === "authorized"
+					? await resume(app, id!)
+					: [first, text("a1", "assistant", "ORCHID-917")];
+			const second = text(
+				"image-2",
+				"user",
+				"Compare the images. " + "context ".repeat(750),
+			);
+			second.parts.push({ type: "file", mediaType: "image/png", url: png });
+			const messages = [...previous, second];
+			const response = await request({
+				messages,
+				...(id ? { conversationId: id } : {}),
+			});
+			const stream = await response.text();
+			expect(response.status).toBe(200);
+			expect(stream).toContain("ORCHID-917");
+			expect(stream).toContain("data-context-status");
+			const visionCalls = languageModel.doGenerateCalls.filter((call) =>
+				call.prompt.some(
+					(message) =>
+						message.role === "user" &&
+						message.content.some(
+							(part) => part.type === "file" && part.mediaType === "image/png",
+						),
+				),
+			);
+			expect(visionCalls).toHaveLength(1);
+			const liveImages = languageModel.doStreamCalls
+				.at(-1)!
+				.prompt.flatMap((message) =>
+					message.role === "user"
+						? message.content.filter((part) => part.type === "file")
+						: [],
+				);
+			expect(liveImages).toHaveLength(1);
+			const summaries = languageModel.doGenerateCalls.length;
+			let continuation: Record<string, unknown>;
+			if (access === "authorized") {
+				const saved = await resume(app, id!);
+				expect(saved[0]!.parts).toEqual(first.parts);
+				expect(saved[2]!.parts).toEqual(second.parts);
+				continuation = {
+					conversationId: id,
+					messages: [...saved, text("u3", "user", "Repeat it")],
+				};
+			} else {
+				expect(messages[0]!.parts).toEqual(first.parts);
+				const line = stream
+					.split("\n")
+					.find((line) => line.includes('"data-context-checkpoint"'))!;
+				const checkpoint = JSON.parse(line.slice(6)).data;
+				const cut =
+					messages.findIndex(
+						(message) => message.id === checkpoint.throughMessageId,
+					) + 1;
+				continuation = {
+					contextSummary: checkpoint.summary,
+					messages: [
+						...messages.slice(cut),
+						text("a2", "assistant", "ORCHID-917"),
+						text("u3", "user", "Repeat it"),
+					],
+				};
+			}
+			const continued = await request(continuation);
+			expect(await continued.text()).toContain("ORCHID-917");
+			expect(languageModel.doGenerateCalls).toHaveLength(summaries);
+			expect(errors).not.toHaveBeenCalled();
+		},
+	);
+
 	it("persists successful responses without content and calls the completion hook", async () => {
 		const languageModel = model();
 		languageModel.doStream = async () => ({