@btst/stack 4.3.0 → 4.5.0

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

@@ -2,6 +2,7 @@
 'use strict';
 
 const jsxRuntime = require('react/jsx-runtime');
+const history = require('../../history.cjs');
 const react = require('@ai-sdk/react');
 const React = require('react');
 const reactQuery = require('@tanstack/react-query');
@@ -21,6 +22,7 @@ const chatHooks = require('../hooks/chat-hooks.cjs');
 const plugins_aiChat_client_context_pageAiContext = require('../../../../../../../plugins/ai-chat/client/context/page-ai-context.cjs');
 const chatAnalytics = require('../context/chat-analytics.cjs');
 const navigation = require('../navigation.cjs');
+const contextCheckpoint = require('../context-checkpoint.cjs');
 
 function reconcilePersistedMessageIds(messages, persistedMessages) {
   const userMessages = messages.filter((message) => message.role === "user");
@@ -42,23 +44,18 @@ function reconcilePersistedMessageIds(messages, persistedMessages) {
   }
   return messages.map((message) => ({
     ...message,
-    id: persistedIds.get(message) ?? message.id
+    id: persistedIds.get(message) ?? message.id,
+    ...persistedMessages.some(
+      (saved) => saved.id === message.id && saved.interrupted
+    ) ? { metadata: { ...message.metadata, interrupted: true } } : {}
   }));
 }
 function persistedMessagesToUiMessages(messages) {
-  return messages.filter((message) => message.role !== "data").map((message) => {
-    let parts;
-    try {
-      const parsed = JSON.parse(message.content);
-      parts = Array.isArray(parsed) ? parsed : [{ type: "text", text: message.content }];
-    } catch {
-      parts = [{ type: "text", text: message.content }];
-    }
-    return {
-      id: message.id,
-      role: message.role,
-      parts
-    };
+  return history.persistedHistory(messages).map((message) => {
+    const abandoned = message.parts.some(
+      (part) => "toolCallId" in part && (part.state === "input-streaming" || part.state === "input-available")
+    );
+    return abandoned ? { ...message, metadata: { interrupted: true } } : message;
   });
 }
 function ChatActionCheck({
@@ -208,6 +205,9 @@ function ChatInterface({
   const latestStreamRequestGeneration = React.useRef(0);
   const pendingStreamRequests = React.useRef([]);
   const latestMessages = React.useRef([]);
+  const contextCheckpoint$1 = React.useRef(void 0);
+  const submittedMessages = React.useRef([]);
+  const [isCompacting, setIsCompacting] = React.useState(false);
   const conversationsListQueryKey = React.useMemo(() => {
     if (isPublicMode) return ["ai-chat", "disabled"];
     const client$1 = client.createApiClient({
@@ -307,6 +307,7 @@ function ChatInterface({
           pendingStreamRequests.current.push(request);
           activeStreamPartitionKey.current = request.identityPartitionKey;
         }
+        setIsCompacting(false);
         const currentPageContext = pageAIContextRef.current;
         const pageContextBody = currentPageContext?.pageDescription ? {
           pageContext: currentPageContext.pageDescription,
@@ -319,18 +320,20 @@ function ChatInterface({
           if (newUserMessage) {
             messagesToSend.push(newUserMessage);
           }
+          submittedMessages.current = messagesToSend;
           editMessagesRef.current = null;
           return {
             body: {
-              messages: messagesToSend,
+              ...isPublicMode ? contextCheckpoint.contextRequest(messagesToSend, contextCheckpoint$1.current) : { messages: messagesToSend },
               conversationId: conversationIdRef.current,
               ...pageContextBody
             }
           };
         }
+        submittedMessages.current = hookMessages;
         return {
           body: {
-            messages: hookMessages,
+            ...isPublicMode ? contextCheckpoint.contextRequest(hookMessages, contextCheckpoint$1.current) : { messages: hookMessages },
             conversationId: conversationIdRef.current,
             ...pageContextBody
           }
@@ -374,6 +377,21 @@ function ChatInterface({
   } = react.useChat({
     id: `${chatInstanceId}:${isPublicMode ? "public" : identitySessionVersion}`,
     transport,
+    onData: ({ type, data }) => {
+      if (!mounted.current || !data || typeof data !== "object") return;
+      if (!isPublicMode && (identitySessionVersion !== identitySessionGeneration.current || activeStreamPartitionKey.current !== latestIdentityPartitionKey.current))
+        return;
+      if (type === "data-context-status" && "compacting" in data) {
+        setIsCompacting(data.compacting === true);
+      }
+      if (isPublicMode && type === "data-context-checkpoint" && "summary" in data && "throughMessageId" in data && typeof data.summary === "string" && typeof data.throughMessageId === "string") {
+        contextCheckpoint$1.current = contextCheckpoint.captureContextCheckpoint(
+          submittedMessages.current,
+          data.summary,
+          data.throughMessageId
+        );
+      }
+    },
     // Automatically resubmit after all client-side tool results are provided
     sendAutomaticallyWhen: (options) => mounted.current && (isPublicMode || identitySessionVersion === identitySessionGeneration.current) && ai.lastAssistantMessageIsCompleteWithToolCalls(options),
     onToolCall: async ({ toolCall }) => {
@@ -424,6 +442,7 @@ function ChatInterface({
       }
     },
     onError: (err) => {
+      setIsCompacting(false);
       if (!mounted.current) return;
       console.error("useChat onError:", err);
       if (!isPublicMode && identitySessionVersion !== identitySessionGeneration.current) {
@@ -437,6 +456,7 @@ function ChatInterface({
       trackFailure();
     },
     onFinish: async (completion) => {
+      setIsCompacting(false);
       if (!mounted.current || !isPublicMode && identitySessionVersion !== identitySessionGeneration.current)
         return;
       if (completion?.isError || completion?.isDisconnect) trackFailure();
@@ -458,6 +478,19 @@ function ChatInterface({
           ).length
         });
       }
+      if (completion?.isAbort || completion?.isError || completion?.isDisconnect) {
+        setMessages(
+          (current) => current.map(
+            (message) => message.id === completion.message.id ? {
+              ...message,
+              metadata: {
+                ...message.metadata,
+                interrupted: true
+              }
+            } : message
+          )
+        );
+      }
       if (isPublicMode) {
         activeStreamPartitionKey.current = void 0;
         return;
@@ -932,7 +965,19 @@ function ChatInterface({
                 },
                 m.id || `msg-${index}`
               )),
-              isLoading && messages[messages.length - 1]?.role !== "assistant" && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex items-center gap-2 text-muted-foreground text-sm py-4", children: /* @__PURE__ */ jsxRuntime.jsx("div", { className: "animate-pulse", children: tr("CHAT_LOADING", "aiChat.chat.loading", "Thinking...") }) }),
+              isLoading && isCompacting && /* @__PURE__ */ jsxRuntime.jsx(
+                "div",
+                {
+                  role: "status",
+                  className: "text-muted-foreground text-sm py-4",
+                  children: tr(
+                    "CHAT_COMPACTING",
+                    "aiChat.chat.compacting",
+                    "Summarizing earlier conversation\u2026"
+                  )
+                }
+              ),
+              isLoading && !isCompacting && messages[messages.length - 1]?.role !== "assistant" && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex items-center gap-2 text-muted-foreground text-sm py-4", children: /* @__PURE__ */ jsxRuntime.jsx("div", { className: "animate-pulse", children: tr("CHAT_LOADING", "aiChat.chat.loading", "Thinking...") }) }),
               (error || historySyncError) && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-2 text-destructive text-sm py-4 px-3 bg-destructive/10 rounded-md", children: [
                 /* @__PURE__ */ jsxRuntime.jsx("span", { className: "flex-1", children: tr(
                   "CHAT_ERROR",

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

@@ -1,5 +1,6 @@
 "use client";
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
+import { persistedHistory } from '../../history.mjs';
 import { useChat } from '@ai-sdk/react';
 import { useId, useRef, useState, useMemo, useEffect, useCallback, useLayoutEffect } from 'react';
 import { useQueryClient, hashKey } from '@tanstack/react-query';
@@ -19,6 +20,7 @@ import { useAiChatIdentityPartition, useConversation, useConversations } from '.
 import { usePageAIContext } from '../../../../../../../plugins/ai-chat/client/context/page-ai-context.mjs';
 import { useChatAnalytics } from '../context/chat-analytics.mjs';
 import { navigateAiChatCrossOrigin } from '../navigation.mjs';
+import { contextRequest, captureContextCheckpoint } from '../context-checkpoint.mjs';
 
 function reconcilePersistedMessageIds(messages, persistedMessages) {
   const userMessages = messages.filter((message) => message.role === "user");
@@ -40,23 +42,18 @@ function reconcilePersistedMessageIds(messages, persistedMessages) {
   }
   return messages.map((message) => ({
     ...message,
-    id: persistedIds.get(message) ?? message.id
+    id: persistedIds.get(message) ?? message.id,
+    ...persistedMessages.some(
+      (saved) => saved.id === message.id && saved.interrupted
+    ) ? { metadata: { ...message.metadata, interrupted: true } } : {}
   }));
 }
 function persistedMessagesToUiMessages(messages) {
-  return messages.filter((message) => message.role !== "data").map((message) => {
-    let parts;
-    try {
-      const parsed = JSON.parse(message.content);
-      parts = Array.isArray(parsed) ? parsed : [{ type: "text", text: message.content }];
-    } catch {
-      parts = [{ type: "text", text: message.content }];
-    }
-    return {
-      id: message.id,
-      role: message.role,
-      parts
-    };
+  return persistedHistory(messages).map((message) => {
+    const abandoned = message.parts.some(
+      (part) => "toolCallId" in part && (part.state === "input-streaming" || part.state === "input-available")
+    );
+    return abandoned ? { ...message, metadata: { interrupted: true } } : message;
   });
 }
 function ChatActionCheck({
@@ -206,6 +203,9 @@ function ChatInterface({
   const latestStreamRequestGeneration = useRef(0);
   const pendingStreamRequests = useRef([]);
   const latestMessages = useRef([]);
+  const contextCheckpoint = useRef(void 0);
+  const submittedMessages = useRef([]);
+  const [isCompacting, setIsCompacting] = useState(false);
   const conversationsListQueryKey = useMemo(() => {
     if (isPublicMode) return ["ai-chat", "disabled"];
     const client = createApiClient({
@@ -305,6 +305,7 @@ function ChatInterface({
           pendingStreamRequests.current.push(request);
           activeStreamPartitionKey.current = request.identityPartitionKey;
         }
+        setIsCompacting(false);
         const currentPageContext = pageAIContextRef.current;
         const pageContextBody = currentPageContext?.pageDescription ? {
           pageContext: currentPageContext.pageDescription,
@@ -317,18 +318,20 @@ function ChatInterface({
           if (newUserMessage) {
             messagesToSend.push(newUserMessage);
           }
+          submittedMessages.current = messagesToSend;
           editMessagesRef.current = null;
           return {
             body: {
-              messages: messagesToSend,
+              ...isPublicMode ? contextRequest(messagesToSend, contextCheckpoint.current) : { messages: messagesToSend },
               conversationId: conversationIdRef.current,
               ...pageContextBody
             }
           };
         }
+        submittedMessages.current = hookMessages;
         return {
           body: {
-            messages: hookMessages,
+            ...isPublicMode ? contextRequest(hookMessages, contextCheckpoint.current) : { messages: hookMessages },
             conversationId: conversationIdRef.current,
             ...pageContextBody
           }
@@ -372,6 +375,21 @@ function ChatInterface({
   } = useChat({
     id: `${chatInstanceId}:${isPublicMode ? "public" : identitySessionVersion}`,
     transport,
+    onData: ({ type, data }) => {
+      if (!mounted.current || !data || typeof data !== "object") return;
+      if (!isPublicMode && (identitySessionVersion !== identitySessionGeneration.current || activeStreamPartitionKey.current !== latestIdentityPartitionKey.current))
+        return;
+      if (type === "data-context-status" && "compacting" in data) {
+        setIsCompacting(data.compacting === true);
+      }
+      if (isPublicMode && type === "data-context-checkpoint" && "summary" in data && "throughMessageId" in data && typeof data.summary === "string" && typeof data.throughMessageId === "string") {
+        contextCheckpoint.current = captureContextCheckpoint(
+          submittedMessages.current,
+          data.summary,
+          data.throughMessageId
+        );
+      }
+    },
     // Automatically resubmit after all client-side tool results are provided
     sendAutomaticallyWhen: (options) => mounted.current && (isPublicMode || identitySessionVersion === identitySessionGeneration.current) && lastAssistantMessageIsCompleteWithToolCalls(options),
     onToolCall: async ({ toolCall }) => {
@@ -422,6 +440,7 @@ function ChatInterface({
       }
     },
     onError: (err) => {
+      setIsCompacting(false);
       if (!mounted.current) return;
       console.error("useChat onError:", err);
       if (!isPublicMode && identitySessionVersion !== identitySessionGeneration.current) {
@@ -435,6 +454,7 @@ function ChatInterface({
       trackFailure();
     },
     onFinish: async (completion) => {
+      setIsCompacting(false);
       if (!mounted.current || !isPublicMode && identitySessionVersion !== identitySessionGeneration.current)
         return;
       if (completion?.isError || completion?.isDisconnect) trackFailure();
@@ -456,6 +476,19 @@ function ChatInterface({
           ).length
         });
       }
+      if (completion?.isAbort || completion?.isError || completion?.isDisconnect) {
+        setMessages(
+          (current) => current.map(
+            (message) => message.id === completion.message.id ? {
+              ...message,
+              metadata: {
+                ...message.metadata,
+                interrupted: true
+              }
+            } : message
+          )
+        );
+      }
       if (isPublicMode) {
         activeStreamPartitionKey.current = void 0;
         return;
@@ -930,7 +963,19 @@ function ChatInterface({
                 },
                 m.id || `msg-${index}`
               )),
-              isLoading && messages[messages.length - 1]?.role !== "assistant" && /* @__PURE__ */ jsx("div", { className: "flex items-center gap-2 text-muted-foreground text-sm py-4", children: /* @__PURE__ */ jsx("div", { className: "animate-pulse", children: tr("CHAT_LOADING", "aiChat.chat.loading", "Thinking...") }) }),
+              isLoading && isCompacting && /* @__PURE__ */ jsx(
+                "div",
+                {
+                  role: "status",
+                  className: "text-muted-foreground text-sm py-4",
+                  children: tr(
+                    "CHAT_COMPACTING",
+                    "aiChat.chat.compacting",
+                    "Summarizing earlier conversation\u2026"
+                  )
+                }
+              ),
+              isLoading && !isCompacting && messages[messages.length - 1]?.role !== "assistant" && /* @__PURE__ */ jsx("div", { className: "flex items-center gap-2 text-muted-foreground text-sm py-4", children: /* @__PURE__ */ jsx("div", { className: "animate-pulse", children: tr("CHAT_LOADING", "aiChat.chat.loading", "Thinking...") }) }),
               (error || historySyncError) && /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 text-destructive text-sm py-4 px-3 bg-destructive/10 rounded-md", children: [
                 /* @__PURE__ */ jsx("span", { className: "flex-1", children: tr(
                   "CHAT_ERROR",

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

@@ -82,6 +82,9 @@ function ChatMessage({
   isRetrying = false
 }) {
   const isUser = message.role === "user";
+  const interrupted = Boolean(
+    message.metadata && typeof message.metadata === "object" && "interrupted" in message.metadata && message.metadata.interrupted
+  );
   const {
     localization: customLocalization,
     toolRenderers,
@@ -359,10 +362,15 @@ function ChatMessage({
                   toolParts.length > 0 && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "space-y-2", children: toolParts.map((part) => {
                     const toolName = ai.getToolName(part);
                     const toolCallId = part.toolCallId;
-                    const state = part.state;
+                    const unfinished = interrupted && (part.state === "input-streaming" || part.state === "input-available");
+                    const state = unfinished ? "output-error" : part.state;
                     const input = part.input;
                     const output = part.output;
-                    const errorText = part.errorText;
+                    const errorText = unfinished ? tr(
+                      "CHAT_INTERRUPTED",
+                      "aiChat.interrupted",
+                      "Response interrupted"
+                    ) : part.errorText;
                     const isLoading = state === "input-streaming" || state === "input-available";
                     const toolCallProps = {
                       toolCallId,
@@ -379,6 +387,18 @@ function ChatMessage({
                     }
                     return /* @__PURE__ */ jsxRuntime.jsx(toolCallDisplay.ToolCallDisplay, { ...toolCallProps }, toolCallId);
                   }) }),
+                  interrupted && !isStreaming && /* @__PURE__ */ jsxRuntime.jsx(
+                    "p",
+                    {
+                      className: "text-xs text-muted-foreground",
+                      "data-testid": "chat-interrupted",
+                      children: tr(
+                        "CHAT_INTERRUPTED",
+                        "aiChat.interrupted",
+                        "Response interrupted"
+                      )
+                    }
+                  ),
                   displayContent ? /* @__PURE__ */ jsxRuntime.jsx(
                     markdownContent.MarkdownContent,
                     {

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

@@ -76,6 +76,9 @@ function ChatMessage({
   isRetrying = false
 }) {
   const isUser = message.role === "user";
+  const interrupted = Boolean(
+    message.metadata && typeof message.metadata === "object" && "interrupted" in message.metadata && message.metadata.interrupted
+  );
   const {
     localization: customLocalization,
     toolRenderers,
@@ -353,10 +356,15 @@ function ChatMessage({
                   toolParts.length > 0 && /* @__PURE__ */ jsx("div", { className: "space-y-2", children: toolParts.map((part) => {
                     const toolName = getToolName(part);
                     const toolCallId = part.toolCallId;
-                    const state = part.state;
+                    const unfinished = interrupted && (part.state === "input-streaming" || part.state === "input-available");
+                    const state = unfinished ? "output-error" : part.state;
                     const input = part.input;
                     const output = part.output;
-                    const errorText = part.errorText;
+                    const errorText = unfinished ? tr(
+                      "CHAT_INTERRUPTED",
+                      "aiChat.interrupted",
+                      "Response interrupted"
+                    ) : part.errorText;
                     const isLoading = state === "input-streaming" || state === "input-available";
                     const toolCallProps = {
                       toolCallId,
@@ -373,6 +381,18 @@ function ChatMessage({
                     }
                     return /* @__PURE__ */ jsx(ToolCallDisplay, { ...toolCallProps }, toolCallId);
                   }) }),
+                  interrupted && !isStreaming && /* @__PURE__ */ jsx(
+                    "p",
+                    {
+                      className: "text-xs text-muted-foreground",
+                      "data-testid": "chat-interrupted",
+                      children: tr(
+                        "CHAT_INTERRUPTED",
+                        "aiChat.interrupted",
+                        "Response interrupted"
+                      )
+                    }
+                  ),
                   displayContent ? /* @__PURE__ */ jsx(
                     MarkdownContent,
                     {

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

@@ -0,0 +1,30 @@
+'use strict';
+
+function captureContextCheckpoint(messages, summary, throughMessageId) {
+  const index = messages.findIndex(
+    (message) => message.id === throughMessageId
+  );
+  if (index < 0) return void 0;
+  return {
+    summary,
+    throughMessageId,
+    prefix: JSON.stringify(messages.slice(0, index + 1))
+  };
+}
+function contextRequest(messages, checkpoint) {
+  if (checkpoint) {
+    const index = messages.findIndex(
+      (message) => message.id === checkpoint.throughMessageId
+    );
+    if (index >= 0 && JSON.stringify(messages.slice(0, index + 1)) === checkpoint.prefix) {
+      return {
+        messages: messages.slice(index + 1),
+        contextSummary: checkpoint.summary
+      };
+    }
+  }
+  return { messages };
+}
+
+exports.captureContextCheckpoint = captureContextCheckpoint;
+exports.contextRequest = contextRequest;

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

@@ -0,0 +1,27 @@
+function captureContextCheckpoint(messages, summary, throughMessageId) {
+  const index = messages.findIndex(
+    (message) => message.id === throughMessageId
+  );
+  if (index < 0) return void 0;
+  return {
+    summary,
+    throughMessageId,
+    prefix: JSON.stringify(messages.slice(0, index + 1))
+  };
+}
+function contextRequest(messages, checkpoint) {
+  if (checkpoint) {
+    const index = messages.findIndex(
+      (message) => message.id === checkpoint.throughMessageId
+    );
+    if (index >= 0 && JSON.stringify(messages.slice(0, index + 1)) === checkpoint.prefix) {
+      return {
+        messages: messages.slice(index + 1),
+        contextSummary: checkpoint.summary
+      };
+    }
+  }
+  return { messages };
+}
+
+export { captureContextCheckpoint, contextRequest };

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

@@ -19,6 +19,10 @@ const aiChatSchema = db.createDbPlugin("aiChat", {
         type: "string",
         required: true
       },
+      contextCheckpoint: {
+        type: "string",
+        required: false
+      },
       createdAt: {
         type: "date",
         defaultValue: () => /* @__PURE__ */ new Date()
@@ -54,6 +58,10 @@ const aiChatSchema = db.createDbPlugin("aiChat", {
         type: "string",
         required: true
       },
+      interrupted: {
+        type: "boolean",
+        required: false
+      },
       createdAt: {
         type: "date",
         defaultValue: () => /* @__PURE__ */ new Date()

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

@@ -17,6 +17,10 @@ const aiChatSchema = createDbPlugin("aiChat", {
         type: "string",
         required: true
       },
+      contextCheckpoint: {
+        type: "string",
+        required: false
+      },
       createdAt: {
         type: "date",
         defaultValue: () => /* @__PURE__ */ new Date()
@@ -52,6 +56,10 @@ const aiChatSchema = createDbPlugin("aiChat", {
         type: "string",
         required: true
       },
+      interrupted: {
+        type: "boolean",
+        required: false
+      },
       createdAt: {
         type: "date",
         defaultValue: () => /* @__PURE__ */ new Date()

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

@@ -0,0 +1,47 @@
+'use strict';
+
+function isMessagePart(value) {
+  if (!value || typeof value !== "object" || !("type" in value)) return false;
+  const part = value;
+  if (typeof part.type !== "string") return false;
+  switch (part.type) {
+    case "text":
+    case "reasoning":
+      return typeof part.text === "string";
+    case "file":
+      return typeof part.url === "string" && typeof part.mediaType === "string";
+    case "source-url":
+      return typeof part.sourceId === "string" && typeof part.url === "string";
+    case "source-document":
+      return typeof part.sourceId === "string" && typeof part.mediaType === "string" && typeof part.title === "string";
+    case "step-start":
+      return true;
+    default:
+      if (part.type.startsWith("data-")) return "data" in part;
+      return (part.type.startsWith("tool-") || part.type === "dynamic-tool" && typeof part.toolName === "string") && typeof part.toolCallId === "string" && [
+        "input-streaming",
+        "input-available",
+        "output-available",
+        "output-error"
+      ].includes(String(part.state));
+  }
+}
+function persistedHistory(messages) {
+  return messages.filter((message) => message.role !== "data").map((message) => {
+    let parts;
+    try {
+      const parsed = JSON.parse(message.content);
+      parts = Array.isArray(parsed) && (parsed.length > 0 || message.role === "assistant") && parsed.every(isMessagePart) ? parsed : [{ type: "text", text: message.content }];
+    } catch {
+      parts = [{ type: "text", text: message.content }];
+    }
+    return {
+      id: message.id,
+      role: message.role,
+      parts,
+      ...message.interrupted ? { metadata: { interrupted: true } } : {}
+    };
+  });
+}
+
+exports.persistedHistory = persistedHistory;

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

@@ -0,0 +1,45 @@
+function isMessagePart(value) {
+  if (!value || typeof value !== "object" || !("type" in value)) return false;
+  const part = value;
+  if (typeof part.type !== "string") return false;
+  switch (part.type) {
+    case "text":
+    case "reasoning":
+      return typeof part.text === "string";
+    case "file":
+      return typeof part.url === "string" && typeof part.mediaType === "string";
+    case "source-url":
+      return typeof part.sourceId === "string" && typeof part.url === "string";
+    case "source-document":
+      return typeof part.sourceId === "string" && typeof part.mediaType === "string" && typeof part.title === "string";
+    case "step-start":
+      return true;
+    default:
+      if (part.type.startsWith("data-")) return "data" in part;
+      return (part.type.startsWith("tool-") || part.type === "dynamic-tool" && typeof part.toolName === "string") && typeof part.toolCallId === "string" && [
+        "input-streaming",
+        "input-available",
+        "output-available",
+        "output-error"
+      ].includes(String(part.state));
+  }
+}
+function persistedHistory(messages) {
+  return messages.filter((message) => message.role !== "data").map((message) => {
+    let parts;
+    try {
+      const parsed = JSON.parse(message.content);
+      parts = Array.isArray(parsed) && (parsed.length > 0 || message.role === "assistant") && parsed.every(isMessagePart) ? parsed : [{ type: "text", text: message.content }];
+    } catch {
+      parts = [{ type: "text", text: message.content }];
+    }
+    return {
+      id: message.id,
+      role: message.role,
+      parts,
+      ...message.interrupted ? { metadata: { interrupted: true } } : {}
+    };
+  });
+}
+
+export { persistedHistory };

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

@@ -34,6 +34,8 @@ const chatRequestSchema = z.z.object({
     ])
   ),
   conversationId: z.z.string().optional(),
+  /** Untrusted continuation summary for opt-in public context compaction. */
+  contextSummary: z.z.string().max(32e3).optional(),
   model: z.z.string().optional(),
   /**
    * Description of the current page context, injected into the AI system prompt.

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

@@ -32,6 +32,8 @@ const chatRequestSchema = z.object({
     ])
   ),
   conversationId: z.string().optional(),
+  /** Untrusted continuation summary for opt-in public context compaction. */
+  contextSummary: z.string().max(32e3).optional(),
   model: z.string().optional(),
   /**
    * Description of the current page context, injected into the AI system prompt.