@assistant-ui/react-ink 0.0.15 → 0.0.16

package/README.md

@@ -1,74 +1,72 @@
-# @assistant-ui/react-ink
+# `@assistant-ui/react-ink`
 
-React Ink (terminal UI) bindings for [assistant-ui](https://www.assistant-ui.com/).
+[![npm version](https://img.shields.io/npm/v/@assistant-ui/react-ink)](https://www.npmjs.com/package/@assistant-ui/react-ink)
+[![npm downloads](https://img.shields.io/npm/dm/@assistant-ui/react-ink)](https://www.npmjs.com/package/@assistant-ui/react-ink)
+[![GitHub stars](https://img.shields.io/github/stars/assistant-ui/assistant-ui)](https://github.com/assistant-ui/assistant-ui)
+![License](https://img.shields.io/npm/l/@assistant-ui/react-ink)
 
-Build AI chat interfaces for the terminal using [Ink](https://github.com/vadimdemedes/ink) — React for CLIs — powered by the same runtime as assistant-ui.
+[Ink](https://github.com/vadimdemedes/ink) bindings for assistant-ui. Composable, unstyled terminal primitives that share the same runtime, adapters, and tools as `@assistant-ui/react`, so you can ship a CLI chat UI without rewriting your backend code.
 
 ## Installation
 
-```sh
+Requires React 19 and ink 6 or newer.
+
+```bash
 npm install @assistant-ui/react-ink ink react
 ```
 
-## Quick Start
+For markdown rendering with syntax highlighting, also install [`@assistant-ui/react-ink-markdown`](https://www.npmjs.com/package/@assistant-ui/react-ink-markdown).
+
+## Usage
 
 ```tsx
-import { render } from "ink";
-import { Box, Text } from "ink";
+import { render, Box, Text } from "ink";
 import {
-  AssistantProvider,
+  AssistantRuntimeProvider,
   useLocalRuntime,
-  ThreadRoot,
-  ThreadMessages,
-  ComposerInput,
+  ThreadPrimitive,
+  ComposerPrimitive,
+  useAuiState,
   type ChatModelAdapter,
 } from "@assistant-ui/react-ink";
 
-const myAdapter: ChatModelAdapter = {
+const adapter: ChatModelAdapter = {
   async *run({ messages }) {
-    // your AI backend here
     yield { content: [{ type: "text", text: "Hello from AI!" }] };
   },
 };
 
-function App() {
-  const runtime = useLocalRuntime(myAdapter);
+const Message = () => {
+  const message = useAuiState((s) => s.message);
+  const text = message.content.find((p) => p.type === "text")?.text ?? "";
+  return (
+    <Box marginBottom={1}>
+      <Text color={message.role === "user" ? "green" : "blue"}>
+        {message.role === "user" ? "You: " : "AI: "}
+      </Text>
+      <Text>{text}</Text>
+    </Box>
+  );
+};
 
+const App = () => {
+  const runtime = useLocalRuntime(adapter);
   return (
-    <AssistantProvider runtime={runtime}>
-      <ThreadRoot>
-        <ThreadMessages
-          renderMessage={({ message }) => (
-            <Box marginBottom={1}>
-              <Text>
-                {message.content
-                  .filter((p) => p.type === "text")
-                  .map((p) => p.text)
-                  .join("")}
-              </Text>
-            </Box>
-          )}
-        />
-        <ComposerInput submitOnEnter placeholder="Message..." autoFocus />
-      </ThreadRoot>
-    </AssistantProvider>
+    <AssistantRuntimeProvider runtime={runtime}>
+      <ThreadPrimitive.Root>
+        <ThreadPrimitive.Messages>{() => <Message />}</ThreadPrimitive.Messages>
+        <Box borderStyle="round" paddingX={1}>
+          <Text>{"> "}</Text>
+          <ComposerPrimitive.Input submitOnEnter placeholder="Message..." autoFocus />
+        </Box>
+      </ThreadPrimitive.Root>
+    </AssistantRuntimeProvider>
   );
-}
+};
 
 render(<App />);
 ```
 
-## Features
-
-- Composable, unstyled primitives (Thread, Composer, Message, ActionBar, etc.)
-- Streaming responses with real-time updates
-- Tool call support with built-in ToolFallback component
-- Diff rendering with DiffPrimitive components and DiffView for unified diffs and file comparisons in the terminal
-- Message branching and editing
-- Multi-thread support with thread list management
-- Markdown rendering via `@assistant-ui/react-ink-markdown`
-- Same runtime as `@assistant-ui/react` — share adapters, tools, and backend code
-
 ## Documentation
 
 - [Getting Started](https://www.assistant-ui.com/docs/ink)
@@ -76,12 +74,7 @@ render(<App />);
 - [Primitives](https://www.assistant-ui.com/docs/ink/primitives)
 - [Hooks](https://www.assistant-ui.com/docs/ink/hooks)
 
-## Related Packages
-
-- [`@assistant-ui/react-ink-markdown`](https://www.npmjs.com/package/@assistant-ui/react-ink-markdown) — Terminal markdown rendering with syntax highlighting
-- [`@assistant-ui/react`](https://www.npmjs.com/package/@assistant-ui/react) — Web (React) bindings
-- [`@assistant-ui/react-native`](https://www.npmjs.com/package/@assistant-ui/react-native) — React Native bindings
-
-## License
+## For other platforms
 
-MIT
+- Web: [`@assistant-ui/react`](https://www.npmjs.com/package/@assistant-ui/react)
+- React Native: [`@assistant-ui/react-native`](https://www.npmjs.com/package/@assistant-ui/react-native)

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="@assistant-ui/core/react" />
-export type { ThreadMessage, ThreadUserMessage, ThreadAssistantMessage, ThreadSystemMessage, MessageStatus, MessageRole, ThreadMessageLike, AppendMessage, RunConfig, TextMessagePart, ReasoningMessagePart, SourceMessagePart, ToolCallMessagePart, ImageMessagePart, FileMessagePart, DataMessagePart, Unstable_AudioMessagePart, ThreadUserMessagePart, ThreadAssistantMessagePart, AssistantRuntime, ThreadRuntime, MessageRuntime, ThreadComposerRuntime, EditComposerRuntime, ComposerRuntime, ThreadListRuntime, ThreadListItemRuntime, ChatModelAdapter, ChatModelRunOptions, ChatModelRunResult, RuntimeCapabilities, Attachment, PendingAttachment, CompleteAttachment, CreateAttachment, AttachmentRuntime, AttachmentAdapter, ThreadHistoryAdapter, FeedbackAdapter, RealtimeVoiceAdapter, VoiceSessionControls, VoiceSessionHelpers, SuggestionAdapter, Unsubscribe, } from "@assistant-ui/core";
+export type { ThreadMessage, ThreadUserMessage, ThreadAssistantMessage, ThreadSystemMessage, MessageStatus, MessageRole, ThreadMessageLike, AppendMessage, RunConfig, TextMessagePart, ReasoningMessagePart, SourceMessagePart, ToolCallMessagePart, ToolModelContentPart, ImageMessagePart, FileMessagePart, DataMessagePart, Unstable_AudioMessagePart, ThreadUserMessagePart, ThreadAssistantMessagePart, AssistantRuntime, ThreadRuntime, MessageRuntime, ThreadComposerRuntime, EditComposerRuntime, ComposerRuntime, ThreadListRuntime, ThreadListItemRuntime, ChatModelAdapter, ChatModelRunOptions, ChatModelRunResult, RuntimeCapabilities, Attachment, PendingAttachment, CompleteAttachment, CreateAttachment, AttachmentRuntime, AttachmentAdapter, ThreadHistoryAdapter, FeedbackAdapter, RealtimeVoiceAdapter, VoiceSessionControls, VoiceSessionHelpers, SuggestionAdapter, Unsubscribe, } from "@assistant-ui/core";
 export type { RemoteThreadListAdapter, RemoteThreadListOptions, } from "@assistant-ui/core";
 export { InMemoryThreadListAdapter } from "@assistant-ui/core";
 export { createVoiceSession } from "@assistant-ui/core";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAEV,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,SAAS,EAET,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,qBAAqB,EACrB,0BAA0B,EAE1B,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EAErB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EAEnB,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EAEjB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EAEjB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,eAAe,EACf,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,MAAM,EACN,WAAW,EACX,WAAW,EACX,WAAW,EACX,KAAK,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,wBAAwB,EAAE,sCAAmC;AACtE,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,eAAe,GACrB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,eAAe,EACf,KAAK,mBAAmB,GACzB,sCAAmC;AACpC,OAAO,EAAE,0BAA0B,EAAE,iDAA8C;AAGnF,OAAO,KAAK,eAAe,+BAA4B;AACvD,OAAO,KAAK,iBAAiB,iCAA8B;AAC3D,OAAO,KAAK,gBAAgB,gCAA6B;AACzD,OAAO,KAAK,mBAAmB,mCAAgC;AAC/D,OAAO,KAAK,kBAAkB,kCAA+B;AAC7D,OAAO,KAAK,qBAAqB,qCAAkC;AACnE,OAAO,KAAK,mBAAmB,mCAAgC;AAC/D,OAAO,KAAK,uBAAuB,uCAAoC;AACvE,OAAO,KAAK,uBAAuB,uCAAoC;AACvE,OAAO,KAAK,mBAAmB,mCAAgC;AAC/D,OAAO,KAAK,iBAAiB,iCAA8B;AAC3D,OAAO,KAAK,cAAc,oCAA2B;AACrD,OAAO,KAAK,aAAa,6BAA0B;AACnD,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,sCAAmC;AAG1E,OAAO,EACL,6BAA6B,EAC7B,+BAA+B,EAC/B,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,iCAAiC,EACjC,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,iBAAiB,EACjB,KAAK,aAAa,EAClB,mBAAmB,EACnB,KAAK,eAAe,EACpB,mBAAmB,EACnB,KAAK,eAAe,EACpB,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,eAAe,EACf,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,EACL,aAAa,EACb,aAAa,EACb,wBAAwB,EACxB,KAAK,0BAA0B,EAC/B,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,cAAc,GACpB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EACV,8BAA8B,EAC9B,qCAAqC,EACrC,kCAAkC,GACnC,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGhE,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,6BAA6B,EAC7B,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,kCAAkC,EAClC,8BAA8B,EAC9B,wBAAwB,EACxB,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AA8DlD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,qCAAqC;AACrC,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAY5B,6BAA6B;AAC7B,OAAO,EACL,MAAM,EACN,WAAW,EACX,WAAW,EACX,WAAW,EACX,KAAK,GAQN,MAAM,qBAAqB,CAAC;AAE7B,oBAAoB;AACpB,OAAO,EAAE,wBAAwB,EAAE,sCAAmC;AACtE,OAAO,EACL,sBAAsB,EACtB,kBAAkB,GAEnB,MAAM,0BAA0B,CAAC;AAElC,UAAU;AACV,OAAO,EACL,eAAe,GAEhB,sCAAmC;AACpC,OAAO,EAAE,0BAA0B,EAAE,iDAA8C;AAEnF,aAAa;AACb,OAAO,KAAK,eAAe,+BAA4B;AACvD,OAAO,KAAK,iBAAiB,iCAA8B;AAC3D,OAAO,KAAK,gBAAgB,gCAA6B;AACzD,OAAO,KAAK,mBAAmB,mCAAgC;AAC/D,OAAO,KAAK,kBAAkB,kCAA+B;AAC7D,OAAO,KAAK,qBAAqB,qCAAkC;AACnE,OAAO,KAAK,mBAAmB,mCAAgC;AAC/D,OAAO,KAAK,uBAAuB,uCAAoC;AACvE,OAAO,KAAK,uBAAuB,uCAAoC;AACvE,OAAO,KAAK,mBAAmB,mCAAgC;AAC/D,OAAO,KAAK,iBAAiB,iCAA8B;AAC3D,OAAO,KAAK,cAAc,oCAA2B;AACrD,OAAO,KAAK,aAAa,6BAA0B;AACnD,OAAO,EAAE,QAAQ,EAAsB,sCAAmC;AAE1E,6CAA6C;AAC7C,OAAO,EACL,6BAA6B,EAC7B,+BAA+B,EAC/B,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,iCAAiC,EACjC,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAElC,iCAAiC;AACjC,OAAO,EACL,iBAAiB,EAEjB,mBAAmB,EAEnB,mBAAmB,EAEnB,gBAAgB,EAEhB,kBAAkB,EAElB,kBAAkB,EAElB,wBAAwB,EACxB,mBAAmB,EAEnB,eAAe,EAGf,KAAK,EACL,aAAa,EACb,aAAa,EACb,wBAAwB,EAExB,oBAAoB,EACpB,iBAAiB,GAElB,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAyB,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAO1D,iBAAiB;AACjB,OAAO,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AA0BhE,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AA+DlD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,qCAAqC;AACrC,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAY5B,6BAA6B;AAC7B,OAAO,EACL,MAAM,EACN,WAAW,EACX,WAAW,EACX,WAAW,EACX,KAAK,GAQN,MAAM,qBAAqB,CAAC;AAE7B,oBAAoB;AACpB,OAAO,EAAE,wBAAwB,EAAE,sCAAmC;AACtE,OAAO,EACL,sBAAsB,EACtB,kBAAkB,GAEnB,MAAM,0BAA0B,CAAC;AAElC,UAAU;AACV,OAAO,EACL,eAAe,GAEhB,sCAAmC;AACpC,OAAO,EAAE,0BAA0B,EAAE,iDAA8C;AAEnF,aAAa;AACb,OAAO,KAAK,eAAe,+BAA4B;AACvD,OAAO,KAAK,iBAAiB,iCAA8B;AAC3D,OAAO,KAAK,gBAAgB,gCAA6B;AACzD,OAAO,KAAK,mBAAmB,mCAAgC;AAC/D,OAAO,KAAK,kBAAkB,kCAA+B;AAC7D,OAAO,KAAK,qBAAqB,qCAAkC;AACnE,OAAO,KAAK,mBAAmB,mCAAgC;AAC/D,OAAO,KAAK,uBAAuB,uCAAoC;AACvE,OAAO,KAAK,uBAAuB,uCAAoC;AACvE,OAAO,KAAK,mBAAmB,mCAAgC;AAC/D,OAAO,KAAK,iBAAiB,iCAA8B;AAC3D,OAAO,KAAK,cAAc,oCAA2B;AACrD,OAAO,KAAK,aAAa,6BAA0B;AACnD,OAAO,EAAE,QAAQ,EAAsB,sCAAmC;AAE1E,6CAA6C;AAC7C,OAAO,EACL,6BAA6B,EAC7B,+BAA+B,EAC/B,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,iCAAiC,EACjC,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAElC,iCAAiC;AACjC,OAAO,EACL,iBAAiB,EAEjB,mBAAmB,EAEnB,mBAAmB,EAEnB,gBAAgB,EAEhB,kBAAkB,EAElB,kBAAkB,EAElB,wBAAwB,EACxB,mBAAmB,EAEnB,eAAe,EAGf,KAAK,EACL,aAAa,EACb,aAAa,EACb,wBAAwB,EAExB,oBAAoB,EACpB,iBAAiB,GAElB,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAyB,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAO1D,iBAAiB;AACjB,OAAO,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AA0BhE,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}

package/dist/primitives/internal/MemoMessage.d.ts

@@ -0,0 +1,14 @@
+import { type ReactNode } from "react";
+import type { ThreadMessage } from "@assistant-ui/core";
+type MemoMessageProps = {
+    index: number;
+    render: (value: {
+        message: ThreadMessage;
+    }) => ReactNode;
+};
+export declare const MemoMessage: import("react").MemoExoticComponent<{
+    ({ index, render }: MemoMessageProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+}>;
+export {};
+//# sourceMappingURL=MemoMessage.d.ts.map

package/dist/primitives/internal/MemoMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoMessage.d.ts","sourceRoot":"","sources":["../../../src/primitives/internal/MemoMessage.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAQ,MAAM,OAAO,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,KAAK,gBAAgB,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,aAAa,CAAA;KAAE,KAAK,SAAS,CAAC;CAC1D,CAAC;AAsBF,eAAO,MAAM,WAAW;wBApBoB,gBAAgB;;EAwB3D,CAAC"}

package/dist/primitives/internal/MemoMessage.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { memo } from "react";
+import { RenderChildrenWithAccessor } from "@assistant-ui/store";
+import { MessageByIndexProvider } from "@assistant-ui/core/react";
+const MemoMessageImpl = ({ index, render }) => {
+    return (_jsx(MessageByIndexProvider, { index: index, children: _jsx(RenderChildrenWithAccessor, { getItemState: (aui) => aui.thread().message({ index }).getState(), children: (getItem) => render({
+                get message() {
+                    return getItem();
+                },
+            }) }) }));
+};
+MemoMessageImpl.displayName = "ThreadPrimitive.Messages.MemoItem";
+export const MemoMessage = memo(MemoMessageImpl, (prev, next) => prev.index === next.index && Object.is(prev.render, next.render));
+//# sourceMappingURL=MemoMessage.js.map

package/dist/primitives/internal/MemoMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoMessage.js","sourceRoot":"","sources":["../../../src/primitives/internal/MemoMessage.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAkB,IAAI,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAOlE,MAAM,eAAe,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAoB,EAAE,EAAE;IAC9D,OAAO,CACL,KAAC,sBAAsB,IAAC,KAAK,EAAE,KAAK,YAClC,KAAC,0BAA0B,IACzB,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,YAEhE,CAAC,OAAO,EAAE,EAAE,CACX,MAAM,CAAC;gBACL,IAAI,OAAO;oBACT,OAAO,OAAO,EAAE,CAAC;gBACnB,CAAC;aACF,CAAC,GAEuB,GACN,CAC1B,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,CAAC,WAAW,GAAG,mCAAmC,CAAC;AAElE,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAC7B,eAAe,EACf,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CACb,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CACnE,CAAC"}

package/dist/primitives/thread/ThreadMessages.d.ts

@@ -19,15 +19,30 @@ type MessageComponents = {
     AssistantMessage: ComponentType;
     SystemMessage?: ComponentType | undefined;
 };
-export type ThreadMessagesProps = {
+/**
+ * Live render region keeps the last `windowSize + windowOverscan` messages;
+ * older messages graduate through Ink's `<Static>` into terminal scrollback
+ * and stop repainting. Defaults to no windowing.
+ *
+ * Per-message memoization only engages when the render callback is
+ * referentially stable. The `components` API handles stability internally;
+ * with the children render-fn API, hoist or memoize the function.
+ */
+type WindowingProps = {
+    /** Recent messages kept live. Unset renders all dynamically. Negative clamped to 0. */
+    windowSize?: number | undefined;
+    /** Extra live messages above the window to absorb boundary churn. Defaults to 4. Negative clamped to 0. */
+    windowOverscan?: number | undefined;
+};
+export type ThreadMessagesProps = ({
     components: MessageComponents;
     children?: never;
-} | {
+} & WindowingProps) | ({
     children: (value: {
         message: ThreadMessage;
     }) => ReactNode;
     components?: never;
-};
+} & WindowingProps);
 export declare const ThreadMessages: FC<ThreadMessagesProps>;
 export {};
 //# sourceMappingURL=ThreadMessages.d.ts.map

package/dist/primitives/thread/ThreadMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThreadMessages.d.ts","sourceRoot":"","sources":["../../../src/primitives/thread/ThreadMessages.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,EAAE,EAAE,KAAK,SAAS,EAAW,MAAM,OAAO,CAAC;AAE7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,KAAK,iBAAiB,GAClB;IACE,OAAO,EAAE,aAAa,CAAC;IACvB,YAAY,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACzC,gBAAgB,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC7C,qBAAqB,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAClD,kBAAkB,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC/C,WAAW,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACxC,gBAAgB,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC7C,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAC3C,GACD;IACE,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,YAAY,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACzC,gBAAgB,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC7C,qBAAqB,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAClD,kBAAkB,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC/C,WAAW,EAAE,aAAa,CAAC;IAC3B,gBAAgB,EAAE,aAAa,CAAC;IAChC,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAC3C,CAAC;AAEN,MAAM,MAAM,mBAAmB,GAC3B;IACE,UAAU,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB,GACD;IACE,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,aAAa,CAAA;KAAE,KAAK,SAAS,CAAC;IAC3D,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB,CAAC;AA4FN,eAAO,MAAM,cAAc,EAAE,EAAE,CAAC,mBAAmB,CAkBlD,CAAC"}
+{"version":3,"file":"ThreadMessages.d.ts","sourceRoot":"","sources":["../../../src/primitives/thread/ThreadMessages.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,EAAE,EACP,KAAK,SAAS,EAGf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,KAAK,iBAAiB,GAClB;IACE,OAAO,EAAE,aAAa,CAAC;IACvB,YAAY,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACzC,gBAAgB,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC7C,qBAAqB,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAClD,kBAAkB,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC/C,WAAW,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACxC,gBAAgB,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC7C,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAC3C,GACD;IACE,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,YAAY,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACzC,gBAAgB,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC7C,qBAAqB,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAClD,kBAAkB,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC/C,WAAW,EAAE,aAAa,CAAC;IAC3B,gBAAgB,EAAE,aAAa,CAAC;IAChC,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAC3C,CAAC;AAEN;;;;;;;;GAQG;AACH,KAAK,cAAc,GAAG;IACpB,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,2GAA2G;IAC3G,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAC3B,CAAC;IACC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB,GAAG,cAAc,CAAC,GACnB,CAAC;IACC,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,aAAa,CAAA;KAAE,KAAK,SAAS,CAAC;IAC3D,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB,GAAG,cAAc,CAAC,CAAC;AA8GxB,eAAO,MAAM,cAAc,EAAE,EAAE,CAAC,mBAAmB,CAqElD,CAAC"}

package/dist/primitives/thread/ThreadMessages.js

@@ -1,8 +1,8 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { useMemo } from "react";
-import { Box } from "ink";
-import { RenderChildrenWithAccessor, useAuiState } from "@assistant-ui/store";
-import { MessageByIndexProvider } from "@assistant-ui/core/react";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useMemo, } from "react";
+import { Box, Static } from "ink";
+import { useAuiState } from "@assistant-ui/store";
+import { MemoMessage } from "../internal/MemoMessage.js";
 const DEFAULT_SYSTEM_MESSAGE = () => null;
 const getComponent = (components, role, isEditing) => {
     switch (role) {
@@ -51,22 +51,64 @@ const ThreadMessageComponent = ({ components, }) => {
     const Component = getComponent(components, role, isEditing);
     return _jsx(Component, {});
 };
-const ThreadMessagesInner = ({ children }) => {
+const ThreadMessagesInner = ({ children, windowSize, windowOverscan = 4 }) => {
     const messagesLength = useAuiState((s) => s.thread.messages.length);
-    return useMemo(() => {
+    const tailStart = windowSize !== undefined
+        ? Math.max(0, messagesLength -
+            Math.max(0, windowSize) -
+            Math.max(0, windowOverscan))
+        : 0;
+    const prefixIndices = useMemo(() => Array.from({ length: tailStart }, (_, i) => i), [tailStart]);
+    const tail = useMemo(() => {
         if (messagesLength === 0)
             return null;
-        return Array.from({ length: messagesLength }, (_, index) => (_jsx(MessageByIndexProvider, { index: index, children: _jsx(RenderChildrenWithAccessor, { getItemState: (aui) => aui.thread().message({ index }).getState(), children: (getItem) => children({
-                    get message() {
-                        return getItem();
-                    },
-                }) }) }, index)));
-    }, [messagesLength, children]);
+        const items = [];
+        for (let index = tailStart; index < messagesLength; index++) {
+            items.push(_jsx(MemoMessage, { index: index, render: children }, index));
+        }
+        return items;
+    }, [messagesLength, tailStart, children]);
+    if (tailStart === 0)
+        return tail;
+    return (_jsxs(_Fragment, { children: [_jsx(Static, { items: prefixIndices, children: (index) => _jsx(MemoMessage, { index: index, render: children }, index) }), tail] }));
 };
-export const ThreadMessages = ({ components, children, }) => {
+export const ThreadMessages = ({ components, children, windowSize, windowOverscan, }) => {
+    const Message = components?.Message;
+    const EditComposer = components?.EditComposer;
+    const UserEditComposer = components?.UserEditComposer;
+    const AssistantEditComposer = components?.AssistantEditComposer;
+    const SystemEditComposer = components?.SystemEditComposer;
+    const UserMessage = components?.UserMessage;
+    const AssistantMessage = components?.AssistantMessage;
+    const SystemMessage = components?.SystemMessage;
+    // biome-ignore lint/correctness/useExhaustiveDependencies: `components` excluded so inline literals do not bust the memo; per-field deps cover real changes.
+    const stableComponents = useMemo(() => {
+        if (!components)
+            return undefined;
+        return {
+            Message,
+            EditComposer,
+            UserEditComposer,
+            AssistantEditComposer,
+            SystemEditComposer,
+            UserMessage,
+            AssistantMessage,
+            SystemMessage,
+        };
+    }, [
+        Message,
+        EditComposer,
+        UserEditComposer,
+        AssistantEditComposer,
+        SystemEditComposer,
+        UserMessage,
+        AssistantMessage,
+        SystemMessage,
+    ]);
+    const renderFromComponents = useCallback(() => stableComponents ? (_jsx(ThreadMessageComponent, { components: stableComponents })) : null, [stableComponents]);
     if (components) {
-        return (_jsx(Box, { flexDirection: "column", children: _jsx(ThreadMessagesInner, { children: () => _jsx(ThreadMessageComponent, { components: components }) }) }));
+        return (_jsx(Box, { flexDirection: "column", children: _jsx(ThreadMessagesInner, { windowSize: windowSize, windowOverscan: windowOverscan, children: renderFromComponents }) }));
     }
-    return (_jsx(Box, { flexDirection: "column", children: _jsx(ThreadMessagesInner, { children: children }) }));
+    return (_jsx(Box, { flexDirection: "column", children: _jsx(ThreadMessagesInner, { windowSize: windowSize, windowOverscan: windowOverscan, children: children }) }));
 };
 //# sourceMappingURL=ThreadMessages.js.map

package/dist/primitives/thread/ThreadMessages.js.map

@@ -1 +1 @@
-{"version":3,"file":"ThreadMessages.js","sourceRoot":"","sources":["../../../src/primitives/thread/ThreadMessages.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"ThreadMessages.js","sourceRoot":"","sources":["../../../src/primitives/thread/ThreadMessages.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/react-ink",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "description": "React Ink (terminal UI) bindings for assistant-ui",
   "keywords": [
     "assistant",
@@ -32,10 +32,10 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@assistant-ui/core": "^0.2.0",
+    "@assistant-ui/core": "^0.2.1",
     "@assistant-ui/store": "^0.2.10",
     "@assistant-ui/tap": "^0.5.11",
-    "assistant-stream": "^0.3.13",
+    "assistant-stream": "^0.3.14",
     "diff": "^9.0.0",
     "ink-spinner": "^5.0.0",
     "parse-diff": "^0.12.0",
@@ -56,12 +56,12 @@
     "ink": "^7.0.2",
     "ink-testing-library": "^4.0.0",
     "react": "^19.2.5",
+    "tsx": "^4.21.0",
     "vitest": "^4.1.5",
     "@assistant-ui/x-buildutils": "0.0.7"
   },
   "publishConfig": {
-    "access": "public",
-    "provenance": true
+    "access": "public"
   },
   "homepage": "https://www.assistant-ui.com/",
   "repository": {
@@ -75,6 +75,7 @@
   "scripts": {
     "build": "aui-build",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "benchmark": "tsx benchmarks/run.ts"
   }
 }

package/src/index.ts

@@ -17,6 +17,7 @@ export type {
   ReasoningMessagePart,
   SourceMessagePart,
   ToolCallMessagePart,
+  ToolModelContentPart,
   ImageMessagePart,
   FileMessagePart,
   DataMessagePart,

package/src/primitives/internal/MemoMessage.tsx

@@ -0,0 +1,35 @@
+import { type ReactNode, memo } from "react";
+import type { ThreadMessage } from "@assistant-ui/core";
+import { RenderChildrenWithAccessor } from "@assistant-ui/store";
+import { MessageByIndexProvider } from "@assistant-ui/core/react";
+
+type MemoMessageProps = {
+  index: number;
+  render: (value: { message: ThreadMessage }) => ReactNode;
+};
+
+const MemoMessageImpl = ({ index, render }: MemoMessageProps) => {
+  return (
+    <MessageByIndexProvider index={index}>
+      <RenderChildrenWithAccessor
+        getItemState={(aui) => aui.thread().message({ index }).getState()}
+      >
+        {(getItem) =>
+          render({
+            get message() {
+              return getItem();
+            },
+          })
+        }
+      </RenderChildrenWithAccessor>
+    </MessageByIndexProvider>
+  );
+};
+
+MemoMessageImpl.displayName = "ThreadPrimitive.Messages.MemoItem";
+
+export const MemoMessage = memo(
+  MemoMessageImpl,
+  (prev, next) =>
+    prev.index === next.index && Object.is(prev.render, next.render),
+);

package/src/primitives/thread/ThreadMessages.test.tsx

@@ -0,0 +1,220 @@
+import type { ReactNode } from "react";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { cleanup, render } from "ink-testing-library";
+import { Text } from "ink";
+
+const hoisted = vi.hoisted(() => ({
+  state: { messagesLength: 0 },
+  capturedIndices: [] as number[],
+  staticItemCounts: [] as number[],
+  tailItemCounts: [] as number[],
+}));
+
+vi.mock("ink", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("ink")>();
+  return {
+    ...actual,
+    Static: <T,>({
+      items,
+      children,
+    }: {
+      items: readonly T[];
+      children: (item: T, index: number) => ReactNode;
+    }) => {
+      hoisted.staticItemCounts.push(items.length);
+      return <>{items.map((item, i) => children(item, i))}</>;
+    },
+  };
+});
+
+vi.mock("@assistant-ui/store", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("@assistant-ui/store")>();
+  return {
+    ...actual,
+    useAuiState: (selector: (s: unknown) => unknown) => {
+      const state = {
+        thread: { messages: { length: hoisted.state.messagesLength } },
+        message: {
+          role: "user" as const,
+          composer: { isEditing: false },
+          parts: [],
+        },
+      };
+      return selector(state);
+    },
+    RenderChildrenWithAccessor: ({
+      children,
+    }: {
+      children: (getItem: () => unknown) => ReactNode;
+    }) => <>{children(() => ({}))}</>,
+  };
+});
+
+vi.mock("@assistant-ui/core/react", async (importOriginal) => {
+  const actual =
+    await importOriginal<typeof import("@assistant-ui/core/react")>();
+  return {
+    ...actual,
+    MessageByIndexProvider: ({
+      index,
+      children,
+    }: {
+      index: number;
+      children: ReactNode;
+    }) => {
+      hoisted.capturedIndices.push(index);
+      return <>{children}</>;
+    },
+  };
+});
+
+import { ThreadPrimitive } from "../../index";
+
+beforeEach(() => {
+  hoisted.state.messagesLength = 0;
+  hoisted.capturedIndices = [];
+  hoisted.staticItemCounts = [];
+  hoisted.tailItemCounts = [];
+});
+
+afterEach(() => {
+  cleanup();
+});
+
+describe("ThreadPrimitive.Messages", () => {
+  it("renders every message when windowSize is undefined", () => {
+    hoisted.state.messagesLength = 5;
+
+    render(
+      <ThreadPrimitive.Messages>
+        {() => <Text>m</Text>}
+      </ThreadPrimitive.Messages>,
+    );
+
+    expect(hoisted.capturedIndices).toEqual([0, 1, 2, 3, 4]);
+    expect(hoisted.staticItemCounts).toEqual([]);
+  });
+
+  it("renders nothing when there are no messages", () => {
+    hoisted.state.messagesLength = 0;
+
+    render(
+      <ThreadPrimitive.Messages>
+        {() => <Text>m</Text>}
+      </ThreadPrimitive.Messages>,
+    );
+
+    expect(hoisted.capturedIndices).toEqual([]);
+    expect(hoisted.staticItemCounts).toEqual([]);
+  });
+
+  it("keeps every message live when total fits within windowSize + windowOverscan", () => {
+    hoisted.state.messagesLength = 5;
+
+    render(
+      <ThreadPrimitive.Messages windowSize={3} windowOverscan={4}>
+        {() => <Text>m</Text>}
+      </ThreadPrimitive.Messages>,
+    );
+
+    expect(hoisted.capturedIndices).toEqual([0, 1, 2, 3, 4]);
+    expect(hoisted.staticItemCounts).toEqual([]);
+  });
+
+  it("splits long threads into a Static prefix plus live tail covering windowSize + windowOverscan", () => {
+    hoisted.state.messagesLength = 20;
+
+    render(
+      <ThreadPrimitive.Messages windowSize={3} windowOverscan={4}>
+        {() => <Text>m</Text>}
+      </ThreadPrimitive.Messages>,
+    );
+
+    expect(hoisted.staticItemCounts.at(-1)).toBe(13);
+    expect(hoisted.capturedIndices).toHaveLength(20);
+    expect(hoisted.capturedIndices.slice(0, 13)).toEqual(
+      Array.from({ length: 13 }, (_, i) => i),
+    );
+    expect(hoisted.capturedIndices.slice(13)).toEqual([
+      13, 14, 15, 16, 17, 18, 19,
+    ]);
+  });
+
+  it("defaults windowOverscan to 4", () => {
+    hoisted.state.messagesLength = 7;
+
+    render(
+      <ThreadPrimitive.Messages windowSize={2}>
+        {() => <Text>m</Text>}
+      </ThreadPrimitive.Messages>,
+    );
+
+    expect(hoisted.staticItemCounts.at(-1)).toBe(1);
+    expect(hoisted.capturedIndices).toHaveLength(7);
+  });
+
+  it("clamps negative windowSize and windowOverscan to 0", () => {
+    hoisted.state.messagesLength = 6;
+
+    render(
+      <ThreadPrimitive.Messages windowSize={-5} windowOverscan={-2}>
+        {() => <Text>m</Text>}
+      </ThreadPrimitive.Messages>,
+    );
+
+    expect(hoisted.staticItemCounts.at(-1)).toBe(6);
+    expect(hoisted.capturedIndices).toHaveLength(6);
+  });
+
+  it("with windowSize=0 keeps only windowOverscan messages live", () => {
+    hoisted.state.messagesLength = 10;
+
+    render(
+      <ThreadPrimitive.Messages windowSize={0} windowOverscan={4}>
+        {() => <Text>m</Text>}
+      </ThreadPrimitive.Messages>,
+    );
+
+    expect(hoisted.staticItemCounts.at(-1)).toBe(6);
+    expect(hoisted.capturedIndices).toHaveLength(10);
+  });
+
+  it("does not re-render messages on parent rerender with a stable render fn", () => {
+    hoisted.state.messagesLength = 3;
+    const stableRender = () => <Text>m</Text>;
+
+    const instance = render(
+      <ThreadPrimitive.Messages>{stableRender}</ThreadPrimitive.Messages>,
+    );
+    expect(hoisted.capturedIndices).toEqual([0, 1, 2]);
+
+    instance.rerender(
+      <ThreadPrimitive.Messages>{stableRender}</ThreadPrimitive.Messages>,
+    );
+    expect(hoisted.capturedIndices).toEqual([0, 1, 2]);
+  });
+
+  it("supports the components API alongside windowing", () => {
+    hoisted.state.messagesLength = 4;
+    const Message = () => <Text>m</Text>;
+
+    render(
+      <ThreadPrimitive.Messages windowSize={2} components={{ Message }} />,
+    );
+
+    expect(hoisted.capturedIndices).toEqual([0, 1, 2, 3]);
+  });
+
+  it("does not re-render messages when an inline components literal is passed", () => {
+    hoisted.state.messagesLength = 3;
+    const Message = () => <Text>m</Text>;
+
+    const App = () => <ThreadPrimitive.Messages components={{ Message }} />;
+
+    const instance = render(<App />);
+    expect(hoisted.capturedIndices).toEqual([0, 1, 2]);
+
+    instance.rerender(<App />);
+    expect(hoisted.capturedIndices).toEqual([0, 1, 2]);
+  });
+});

package/src/primitives/thread/ThreadMessages.tsx

@@ -1,8 +1,14 @@
-import { type ComponentType, type FC, type ReactNode, useMemo } from "react";
-import { Box } from "ink";
+import {
+  type ComponentType,
+  type FC,
+  type ReactNode,
+  useCallback,
+  useMemo,
+} from "react";
+import { Box, Static } from "ink";
 import type { ThreadMessage } from "@assistant-ui/core";
-import { RenderChildrenWithAccessor, useAuiState } from "@assistant-ui/store";
-import { MessageByIndexProvider } from "@assistant-ui/core/react";
+import { useAuiState } from "@assistant-ui/store";
+import { MemoMessage } from "../internal/MemoMessage";
 
 type MessageComponents =
   | {
@@ -26,15 +32,31 @@ type MessageComponents =
       SystemMessage?: ComponentType | undefined;
     };
 
+/**
+ * Live render region keeps the last `windowSize + windowOverscan` messages;
+ * older messages graduate through Ink's `<Static>` into terminal scrollback
+ * and stop repainting. Defaults to no windowing.
+ *
+ * Per-message memoization only engages when the render callback is
+ * referentially stable. The `components` API handles stability internally;
+ * with the children render-fn API, hoist or memoize the function.
+ */
+type WindowingProps = {
+  /** Recent messages kept live. Unset renders all dynamically. Negative clamped to 0. */
+  windowSize?: number | undefined;
+  /** Extra live messages above the window to absorb boundary churn. Defaults to 4. Negative clamped to 0. */
+  windowOverscan?: number | undefined;
+};
+
 export type ThreadMessagesProps =
-  | {
+  | ({
       components: MessageComponents;
       children?: never;
-    }
-  | {
+    } & WindowingProps)
+  | ({
       children: (value: { message: ThreadMessage }) => ReactNode;
       components?: never;
-    };
+    } & WindowingProps);
 
 const DEFAULT_SYSTEM_MESSAGE = () => null;
 
@@ -103,45 +125,114 @@ const ThreadMessageComponent: FC<{ components: MessageComponents }> = ({
 
 const ThreadMessagesInner: FC<{
   children: (value: { message: ThreadMessage }) => ReactNode;
-}> = ({ children }) => {
+  windowSize?: number | undefined;
+  windowOverscan?: number | undefined;
+}> = ({ children, windowSize, windowOverscan = 4 }) => {
   const messagesLength = useAuiState((s) => s.thread.messages.length);
 
-  return useMemo(() => {
+  const tailStart =
+    windowSize !== undefined
+      ? Math.max(
+          0,
+          messagesLength -
+            Math.max(0, windowSize) -
+            Math.max(0, windowOverscan),
+        )
+      : 0;
+
+  const prefixIndices = useMemo(
+    () => Array.from({ length: tailStart }, (_, i) => i),
+    [tailStart],
+  );
+
+  const tail = useMemo(() => {
     if (messagesLength === 0) return null;
-    return Array.from({ length: messagesLength }, (_, index) => (
-      <MessageByIndexProvider key={index} index={index}>
-        <RenderChildrenWithAccessor
-          getItemState={(aui) => aui.thread().message({ index }).getState()}
-        >
-          {(getItem) =>
-            children({
-              get message() {
-                return getItem();
-              },
-            })
-          }
-        </RenderChildrenWithAccessor>
-      </MessageByIndexProvider>
-    ));
-  }, [messagesLength, children]);
+    const items: ReactNode[] = [];
+    for (let index = tailStart; index < messagesLength; index++) {
+      items.push(<MemoMessage key={index} index={index} render={children} />);
+    }
+    return items;
+  }, [messagesLength, tailStart, children]);
+
+  if (tailStart === 0) return tail;
+
+  return (
+    <>
+      <Static items={prefixIndices}>
+        {(index) => <MemoMessage key={index} index={index} render={children} />}
+      </Static>
+      {tail}
+    </>
+  );
 };
 
 export const ThreadMessages: FC<ThreadMessagesProps> = ({
   components,
   children,
+  windowSize,
+  windowOverscan,
 }) => {
+  const Message = components?.Message;
+  const EditComposer = components?.EditComposer;
+  const UserEditComposer = components?.UserEditComposer;
+  const AssistantEditComposer = components?.AssistantEditComposer;
+  const SystemEditComposer = components?.SystemEditComposer;
+  const UserMessage = components?.UserMessage;
+  const AssistantMessage = components?.AssistantMessage;
+  const SystemMessage = components?.SystemMessage;
+
+  // biome-ignore lint/correctness/useExhaustiveDependencies: `components` excluded so inline literals do not bust the memo; per-field deps cover real changes.
+  const stableComponents = useMemo<MessageComponents | undefined>(() => {
+    if (!components) return undefined;
+    return {
+      Message,
+      EditComposer,
+      UserEditComposer,
+      AssistantEditComposer,
+      SystemEditComposer,
+      UserMessage,
+      AssistantMessage,
+      SystemMessage,
+    } as MessageComponents;
+  }, [
+    Message,
+    EditComposer,
+    UserEditComposer,
+    AssistantEditComposer,
+    SystemEditComposer,
+    UserMessage,
+    AssistantMessage,
+    SystemMessage,
+  ]);
+
+  const renderFromComponents = useCallback(
+    () =>
+      stableComponents ? (
+        <ThreadMessageComponent components={stableComponents} />
+      ) : null,
+    [stableComponents],
+  );
+
   if (components) {
     return (
       <Box flexDirection="column">
-        <ThreadMessagesInner>
-          {() => <ThreadMessageComponent components={components} />}
+        <ThreadMessagesInner
+          windowSize={windowSize}
+          windowOverscan={windowOverscan}
+        >
+          {renderFromComponents}
         </ThreadMessagesInner>
       </Box>
     );
   }
   return (
     <Box flexDirection="column">
-      <ThreadMessagesInner>{children}</ThreadMessagesInner>
+      <ThreadMessagesInner
+        windowSize={windowSize}
+        windowOverscan={windowOverscan}
+      >
+        {children}
+      </ThreadMessagesInner>
     </Box>
   );
 };