basalt-ui 1.10.0 → 1.11.0

package/dist/agent/use-agent-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-agent-stream.d.ts","sourceRoot":"","sources":["../../src/agent/use-agent-stream.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAIjD,iDAAiD;AACjD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAA;AAIlE,MAAM,MAAM,oBAAoB,CAAC,KAAK,EAAE,MAAM,IAAI;IAChD,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;IACvB,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAA;IACzB,kEAAkE;IAClE,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACzC,CAAA;AAID;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,GAAG,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,EACjE,SAAS,GACV,EAAE;IACD,SAAS,EAAE,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;CACzC,GAAG,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,CAmEtC"}
+{"version":3,"file":"use-agent-stream.d.ts","sourceRoot":"","sources":["../../src/agent/use-agent-stream.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAIjD,iDAAiD;AACjD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAA;AAIlE,MAAM,MAAM,oBAAoB,CAAC,KAAK,EAAE,MAAM,IAAI;IAChD,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;IACvB,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAA;IACzB,kEAAkE;IAClE,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACzC,CAAA;AAID;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,SAAS,QAAQ,GAAG,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,EAClF,SAAS,GACV,EAAE;IACD,SAAS,EAAE,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;CACzC,GAAG,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,CA0EtC"}

package/dist/agent/use-agent-stream.js

@@ -1,5 +1,7 @@
 import { useCallback, useEffect, useRef, useState } from "react";
+import { withPartIds } from "./id.js";
 import { isStartPart } from "./parts.js";
+import { mergePart } from "./merge.js";
 function useAgentStream({
   transport
 }) {
@@ -23,12 +25,13 @@ function useAgentStream({
       setParts([]);
       setError(void 0);
       setStatus("streaming");
+      const runId = crypto.randomUUID();
       try {
-        for await (const part of transport.stream(input, controller.signal)) {
+        for await (const part of withPartIds(runId, transport.stream(input, controller.signal))) {
           if (controllerRef.current !== controller) return;
           if (controller.signal.aborted) break;
           if (isStartPart(part)) continue;
-          setParts((prev) => [...prev, part]);
+          setParts((prev) => mergePart(prev, part));
         }
         if (controllerRef.current === controller && !controller.signal.aborted) setStatus("done");
       } catch (err) {

package/dist/agent/use-agent-thread-runs.d.ts

@@ -1,3 +1,4 @@
+import type { PartLike } from './merge.js';
 import type { OutcomeResolver } from './outcome.js';
 import type { AgentPart } from './parts.js';
 import type { ThreadsStore } from './thread.js';
@@ -52,9 +53,14 @@ export type UseAgentThreadRunsReturn<TPart = AgentPart> = {
      * `threadId` has never had a turn started, or already has one in flight.
      */
     readonly retry: (threadId: string) => void;
-    /** Abort the in-flight stream for `threadId` (no-op if idle). */
+    /**
+     * Abort the in-flight stream for `threadId` (no-op if idle). Preserves whatever content had
+     * already arrived: if the run had accumulated any parts, they're persisted as an assistant
+     * ChatMessage with `finish: 'stopped'` (unless that message already landed — see finalizeStop),
+     * then distilled into an outcome and the thread is settled to 'done'.
+     */
     readonly stop: (threadId: string) => void;
-    /** Abort every in-flight stream across all threads. */
+    /** Abort every in-flight stream across all threads, settling each the same way stop() would. */
     readonly stopAll: () => void;
 };
 /**
@@ -68,5 +74,5 @@ export type UseAgentThreadRunsReturn<TPart = AgentPart> = {
  * start(threadB, 'What changed in the last release?')
  * // both stream concurrently; runs.get(threadA) / runs.get(threadB) update independently
  */
-export declare function useAgentThreadRuns<TPart = AgentPart>({ transport, store, resolveOutcome, toUserParts, }: UseAgentThreadRunsArgs<TPart>): UseAgentThreadRunsReturn<TPart>;
+export declare function useAgentThreadRuns<TPart extends PartLike = AgentPart>({ transport, store, resolveOutcome, toUserParts, }: UseAgentThreadRunsArgs<TPart>): UseAgentThreadRunsReturn<TPart>;
 //# sourceMappingURL=use-agent-thread-runs.d.ts.map

package/dist/agent/use-agent-thread-runs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-agent-thread-runs.d.ts","sourceRoot":"","sources":["../../src/agent/use-agent-thread-runs.ts"],"names":[],"mappings":"AA0CA,OAAO,KAAK,EAAgB,eAAe,EAAE,MAAM,WAAW,CAAA;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,KAAK,EAA6B,YAAY,EAAE,MAAM,UAAU,CAAA;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAIjD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,SAAS,IAAI;IAC9C,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;CACxB,CAAA;AAID,MAAM,MAAM,sBAAsB,CAAC,KAAK,GAAG,SAAS,IAAI;IACtD;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAS,EACd,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,GAC7B,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;IACzD,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,CAAA;IACnC,uFAAuF;IACvF,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC,KAAK,CAAC,CAAA;IAC/C;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,EAAE,CAAA;CAClD,CAAA;AAID,MAAM,MAAM,wBAAwB,CAAC,KAAK,GAAG,SAAS,IAAI;IACxD,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAA;IACzD,2FAA2F;IAC3F,QAAQ,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACzD;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAC7B,CAAA;AA0ID;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,GAAG,SAAS,EAAE,EACpD,SAAS,EACT,KAAK,EACL,cAAc,EACd,WAAW,GACZ,EAAE,sBAAsB,CAAC,KAAK,CAAC,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAmLjE"}
+{"version":3,"file":"use-agent-thread-runs.d.ts","sourceRoot":"","sources":["../../src/agent/use-agent-thread-runs.ts"],"names":[],"mappings":"AA4CA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,KAAK,EAAgB,eAAe,EAAE,MAAM,WAAW,CAAA;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,KAAK,EAA6B,YAAY,EAAE,MAAM,UAAU,CAAA;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAIjD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,SAAS,IAAI;IAC9C,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;CACxB,CAAA;AAID,MAAM,MAAM,sBAAsB,CAAC,KAAK,GAAG,SAAS,IAAI;IACtD;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAS,EACd,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,GAC7B,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;IACzD,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,CAAA;IACnC,uFAAuF;IACvF,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC,KAAK,CAAC,CAAA;IAC/C;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,EAAE,CAAA;CAClD,CAAA;AAID,MAAM,MAAM,wBAAwB,CAAC,KAAK,GAAG,SAAS,IAAI;IACxD,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAA;IACzD,2FAA2F;IAC3F,QAAQ,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACzD;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,gGAAgG;IAChG,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAC7B,CAAA;AAkND;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,SAAS,QAAQ,GAAG,SAAS,EAAE,EACrE,SAAS,EACT,KAAK,EACL,cAAc,EACd,WAAW,GACZ,EAAE,sBAAsB,CAAC,KAAK,CAAC,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAkPjE"}

package/dist/agent/use-agent-thread-runs.js

@@ -1,7 +1,10 @@
 import { useCallback, useEffect, useRef, useState } from "react";
+import { withPartIds } from "./id.js";
+import { mergePart } from "./merge.js";
 import { isStartPart } from "./parts.js";
+import { isResumable } from "./transport.js";
 function defaultToUserParts(input) {
-  return [{ type: "text", text: input }];
+  return [{ id: crypto.randomUUID(), type: "text", text: input }];
 }
 function buildDoneSnapshot(priorThread, threadId, userMessage, assistantMessage) {
   const updatedAt = Date.now();
@@ -30,12 +33,13 @@ async function consumeAndFinalize(args) {
     generator,
     userMessage,
     controllersRef,
+    appendedRef,
     storeRef,
     resolveOutcome,
     setRuns,
     onFailureStatus
   } = args;
-  const parts = [];
+  let parts = [];
   try {
     for await (const part of generator) {
       if (controllersRef.current.get(threadId) !== controller) return;
@@ -44,10 +48,10 @@ async function consumeAndFinalize(args) {
         storeRef.current.setResumeToken(threadId, part.resumeToken);
         continue;
       }
-      parts.push(part);
+      parts = mergePart(parts, part);
       setRuns((prev) => {
         const next = new Map(prev);
-        next.set(threadId, { status: "streaming", parts: [...parts] });
+        next.set(threadId, { status: "streaming", parts });
         return next;
       });
     }
@@ -58,16 +62,22 @@ async function consumeAndFinalize(args) {
       id: crypto.randomUUID(),
       role: "assistant",
       parts,
-      createdAt: Date.now()
+      createdAt: Date.now(),
+      finish: "complete"
     };
     storeRef.current.appendMessage(threadId, assistantMessage);
+    appendedRef.current.set(threadId, controller);
     const priorThread = storeRef.current.threads.find((thread) => thread.id === threadId);
     const snapshot = buildDoneSnapshot(priorThread, threadId, userMessage, assistantMessage);
     const outcome = await resolveOutcome(snapshot);
+    if (controllersRef.current.get(threadId) !== controller || controller.signal.aborted) {
+      return;
+    }
     storeRef.current.setOutcome(threadId, outcome);
     storeRef.current.setStatus(threadId, outcome.status);
     storeRef.current.setResumeToken(threadId, void 0);
     controllersRef.current.delete(threadId);
+    appendedRef.current.delete(threadId);
     setRuns((prev) => {
       if (!prev.has(threadId)) return prev;
       const next = new Map(prev);
@@ -80,6 +90,7 @@ async function consumeAndFinalize(args) {
     if (controller.signal.aborted) return;
     storeRef.current.setStatus(threadId, onFailureStatus);
     controllersRef.current.delete(threadId);
+    appendedRef.current.delete(threadId);
     setRuns((prev) => {
       if (!prev.has(threadId)) return prev;
       const next = new Map(prev);
@@ -88,6 +99,31 @@ async function consumeAndFinalize(args) {
     });
   }
 }
+async function finalizeStop(args) {
+  const { threadId, parts, alreadyAppended, storeRef, resolveOutcome, setRuns } = args;
+  if (!alreadyAppended && parts.length > 0) {
+    const stoppedMessage = {
+      id: crypto.randomUUID(),
+      role: "assistant",
+      parts,
+      createdAt: Date.now(),
+      finish: "stopped"
+    };
+    storeRef.current.appendMessage(threadId, stoppedMessage);
+  }
+  storeRef.current.setStatus(threadId, "done");
+  storeRef.current.setResumeToken(threadId, void 0);
+  setRuns((prev) => {
+    if (!prev.has(threadId)) return prev;
+    const next = new Map(prev);
+    next.delete(threadId);
+    return next;
+  });
+  const snapshot = storeRef.current.threads.find((thread) => thread.id === threadId);
+  if (snapshot === void 0) return;
+  const outcome = await resolveOutcome(snapshot);
+  storeRef.current.setOutcome(threadId, outcome);
+}
 function useAgentThreadRuns({
   transport,
   store,
@@ -95,7 +131,10 @@ function useAgentThreadRuns({
   toUserParts
 }) {
   const [runs, setRuns] = useState(/* @__PURE__ */ new Map());
+  const runsRef = useRef(runs);
+  runsRef.current = runs;
   const controllersRef = useRef(/* @__PURE__ */ new Map());
+  const appendedRef = useRef(/* @__PURE__ */ new Map());
   const lastInputRef = useRef(/* @__PURE__ */ new Map());
   const storeRef = useRef(store);
   storeRef.current = store;
@@ -118,6 +157,7 @@ function useAgentThreadRuns({
     () => () => {
       controllersRef.current.forEach((controller) => controller.abort());
       controllersRef.current.clear();
+      appendedRef.current.clear();
     },
     []
   );
@@ -128,7 +168,7 @@ function useAgentThreadRuns({
       const resumeToken = thread.resumeToken;
       const lastUserMessage = thread.messages.filter((message) => message.role === "user").at(-1);
       const resolvedTransport = resolveTransport(thread.id);
-      if (resolvedTransport.resume === void 0 || resumeToken === void 0 || lastUserMessage === void 0) {
+      if (!isResumable(resolvedTransport) || resumeToken === void 0 || lastUserMessage === void 0) {
         storeRef.current.setStatus(thread.id, "interrupted");
         continue;
       }
@@ -143,9 +183,17 @@ function useAgentThreadRuns({
       void consumeAndFinalize({
         threadId: thread.id,
         controller,
-        generator: resume(resumeToken, controller.signal),
+        // Namespaced by thread.id (stable across a thread's whole lifetime, including this
+        // resume) rather than per-call — see withPartIds' own doc for why this is NOT a replay-
+        // convergence guarantee on its own: it only protects against two id-less drafts within
+        // ONE generator colliding (the F1 bug). A transport whose resume() needs genuine replay
+        // safety must assert `idempotentReplay: true` AND mint its own content-stable ids (as
+        // aiSdkTransport does) — withPartIds is then a no-op passthrough for it, not the mechanism
+        // providing that safety.
+        generator: withPartIds(thread.id, resume(resumeToken, controller.signal)),
         userMessage: lastUserMessage,
         controllersRef,
+        appendedRef,
         storeRef,
         resolveOutcome,
         setRuns,
@@ -176,9 +224,11 @@ function useAgentThreadRuns({
       void consumeAndFinalize({
         threadId,
         controller,
-        generator: resolvedTransport.stream(input, controller.signal),
+        // Namespaced by threadId — same choice, same caveat, as the mount-time resume call above.
+        generator: withPartIds(threadId, resolvedTransport.stream(input, controller.signal)),
         userMessage,
         controllersRef,
+        appendedRef,
         storeRef,
         resolveOutcome,
         setRuns,
@@ -195,22 +245,24 @@ function useAgentThreadRuns({
     },
     [start]
   );
-  const stop = useCallback((threadId) => {
-    controllersRef.current.get(threadId)?.abort();
-    controllersRef.current.delete(threadId);
-    storeRef.current.setStatus(threadId, "done");
-    setRuns((prev) => {
-      if (!prev.has(threadId)) return prev;
-      const next = new Map(prev);
-      next.delete(threadId);
-      return next;
-    });
-  }, []);
+  const stop = useCallback(
+    (threadId) => {
+      const controller = controllersRef.current.get(threadId);
+      if (controller === void 0) return;
+      controllersRef.current.delete(threadId);
+      const parts = runsRef.current.get(threadId)?.parts ?? [];
+      controller.abort();
+      const alreadyAppended = appendedRef.current.get(threadId) === controller;
+      appendedRef.current.delete(threadId);
+      void finalizeStop({ threadId, parts, alreadyAppended, storeRef, resolveOutcome, setRuns });
+    },
+    [resolveOutcome]
+  );
   const stopAll = useCallback(() => {
-    controllersRef.current.forEach((controller) => controller.abort());
-    controllersRef.current.clear();
-    setRuns(/* @__PURE__ */ new Map());
-  }, []);
+    for (const threadId of Array.from(controllersRef.current.keys())) {
+      stop(threadId);
+    }
+  }, [stop]);
   return { runs, start, retry, stop, stopAll };
 }
 export {

package/dist/agent-chat/index.d.ts

@@ -22,4 +22,6 @@ export { Composer } from './composer.js';
 export type { ComposerProps } from './composer.js';
 export { threadPartRenderers, ThreadTranscript } from './thread-message.js';
 export type { ThreadTranscriptProps } from './thread-message.js';
+export { ToolChip } from './tool-chip.js';
+export type { ToolChipProps } from './tool-chip.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/agent-chat/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-chat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAG9D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAGpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAGnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAGnE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG/C,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxE,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-chat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAG9D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAGpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAGnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAGnE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG/C,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxE,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAG7D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA"}

package/dist/agent-chat/index.js

@@ -4,6 +4,7 @@ import { ThreadOutcomeCard } from "./thread-outcome-card.js";
 import { ThreadDetailPanel } from "./thread-detail-panel.js";
 import { Composer } from "./composer.js";
 import { threadPartRenderers, ThreadTranscript } from "./thread-message.js";
+import { ToolChip } from "./tool-chip.js";
 export {
   Composer,
   ThreadDetailPanel,
@@ -11,5 +12,6 @@ export {
   ThreadOutcomeCard,
   ThreadTranscript,
   ThreadWorkspace,
+  ToolChip,
   threadPartRenderers
 };

package/dist/agent-chat/thread-message.d.ts

@@ -1,5 +1,5 @@
 import type { JSX } from 'react';
-import type { AgentPart, AgentPartRenderers, ChatMessage, StreamStatus } from '../agent/index.js';
+import type { AgentPartRenderers, ChatMessage, ForeignPart, PartRenderer, PartRenderers, StreamStatus, TranscriptPart } from '../agent/index.js';
 /**
  * Mantine overrides for `PartList`'s default headless renderers — the house style for rendering
  * an `AgentPart` inside a chat surface.
@@ -10,22 +10,39 @@ import type { AgentPart, AgentPartRenderers, ChatMessage, StreamStatus } from '.
  * <PartList parts={parts} components={threadPartRenderers} />
  */
 export declare const threadPartRenderers: Partial<AgentPartRenderers>;
-export type ThreadTranscriptProps = {
+/**
+ * Render-execution counter for `MessageBlockImpl` — increments only when React actually calls the
+ * function body (a `memo` bail-out never reaches it). NOT part of the public surface —
+ * `agent-chat/index.ts` does not re-export it. The memoization test imports this module directly
+ * (bypassing the barrel) to prove the memo boundary in a controlled render-count harness.
+ */
+export declare const messageBlockRenderCounter: {
+    count: number;
+};
+type ThreadTranscriptBase = {
     /** Settled messages for the thread, oldest first. */
-    readonly messages: ChatMessage[];
+    readonly messages: readonly ChatMessage<TranscriptPart>[];
     /** The live (in-flight) assistant turn's parts, when a run is streaming for this thread. */
-    readonly liveParts?: AgentPart[];
+    readonly liveParts?: readonly TranscriptPart[];
     /** The live run's status — drives the in-progress indicator on the live block. */
     readonly liveStatus?: StreamStatus;
+    /** Consumer renderers keyed by part.type. Consulted BEFORE the built-in union. */
+    readonly renderers?: PartRenderers;
+    /** Called for a part whose type is neither an AgentPart variant nor a registered key. Defaults
+     * to a visible `UnknownPartChip` outside production, `null` in production — never throws. */
+    readonly fallbackRenderer?: PartRenderer<ForeignPart>;
 };
+export type ThreadTranscriptProps = ThreadTranscriptBase;
 /**
- * Renders a thread's settled messages, each role-labelled ("You" / "Assistant") and rendered via
- * `PartList` + `threadPartRenderers`. When `liveParts` is non-empty, an extra in-progress
+ * Renders a thread's settled messages, each role-labelled ("You" / "Assistant"). Each part
+ * resolves in order: a registered `renderers[part.type]` first, then basalt's own `PartList` for
+ * the built-in six, then `fallbackRenderer`. When `liveParts` is non-empty, an extra in-progress
  * assistant block is appended at the tail.
  *
  * @example
  * import { ThreadTranscript } from 'basalt-ui'
  * <ThreadTranscript messages={thread.messages} liveParts={liveParts} liveStatus={runStatus} />
  */
-export declare function ThreadTranscript({ messages, liveParts, liveStatus, }: ThreadTranscriptProps): JSX.Element;
+export declare function ThreadTranscript({ messages, liveParts, liveStatus, renderers: renderersProp, fallbackRenderer, }: ThreadTranscriptProps): JSX.Element;
+export {};
 //# sourceMappingURL=thread-message.d.ts.map

package/dist/agent-chat/thread-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"thread-message.d.ts","sourceRoot":"","sources":["../../src/agent-chat/thread-message.tsx"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,KAAK,EACV,SAAS,EACT,kBAAkB,EAClB,WAAW,EAIX,YAAY,EAGb,MAAM,UAAU,CAAA;AAmGjB;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAO,CAAC,kBAAkB,CAM3D,CAAA;AAyDD,MAAM,MAAM,qBAAqB,GAAG;IAClC,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAA;IAChC,4FAA4F;IAC5F,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,CAAA;IAChC,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAA;CACnC,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,SAAS,EACT,UAAU,GACX,EAAE,qBAAqB,GAAG,GAAG,CAAC,OAAO,CAiBrC"}
+{"version":3,"file":"thread-message.d.ts","sourceRoot":"","sources":["../../src/agent-chat/thread-message.tsx"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,KAAK,EAEV,kBAAkB,EAClB,WAAW,EAEX,WAAW,EACX,YAAY,EACZ,aAAa,EAGb,YAAY,EAGZ,cAAc,EACf,MAAM,UAAU,CAAA;AAkFjB;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAO,CAAC,kBAAkB,CAM3D,CAAA;AAqID;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;CAAe,CAAA;AA8ErD,KAAK,oBAAoB,GAAG;IAC1B,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,CAAC,cAAc,CAAC,EAAE,CAAA;IACzD,4FAA4F;IAC5F,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;IAC9C,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAA;IAClC,kFAAkF;IAClF,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAA;IAClC;iGAC6F;IAC7F,QAAQ,CAAC,gBAAgB,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,CAAA;CACtD,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,CAAA;AAExD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,SAAS,EACT,UAAU,EACV,SAAS,EAAE,aAAa,EACxB,gBAA4C,GAC7C,EAAE,qBAAqB,GAAG,GAAG,CAAC,OAAO,CAgCrC"}

package/dist/agent-chat/thread-message.js

@@ -11,9 +11,11 @@ import {
   UnstyledButton
 } from "@mantine/core";
 import { useDisclosure } from "@mantine/hooks";
-import { PartList } from "../agent/index.js";
+import { Fragment, memo, useMemo } from "react";
+import { coalesceParts, narrowAgentPart, PartList } from "../agent/index.js";
 import { Markdown } from "../content/markdown.js";
-import { alpha, VX } from "../tokens/index.js";
+import { VX } from "../tokens/index.js";
+import { ToolChip } from "./tool-chip.js";
 const MICRO_LABEL_STYLE = {
   fontFamily: "var(--basalt-font-mono)",
   fontSize: VX.text.micro,
@@ -29,16 +31,6 @@ const RAIL_STYLE = {
   borderLeft: `2px solid ${VX.divider}`,
   paddingLeft: "var(--vx-space-agent-rail-inset-x)"
 };
-const CODE_BLOCK_STYLE = {
-  margin: 0,
-  marginTop: "var(--vx-space-agent-part-gap-top)",
-  fontFamily: "var(--basalt-font-mono)",
-  backgroundColor: alpha(VX.ink, 0.06),
-  borderRadius: "var(--vx-radius-card)",
-  padding: "var(--vx-space-agent-code-inset)",
-  whiteSpace: "pre-wrap",
-  overflowWrap: "anywhere"
-};
 function ReasoningRenderer({ part }) {
   const [open, { toggle }] = useDisclosure(false);
   return /* @__PURE__ */ jsx(Box, { style: RAIL_STYLE, children: /* @__PURE__ */ jsxs(Stack, { gap: 4, children: [
@@ -46,12 +38,8 @@ function ReasoningRenderer({ part }) {
     /* @__PURE__ */ jsx(Collapse, { expanded: open, children: /* @__PURE__ */ jsx(Text, { size: "xs", c: "dimmed", style: { whiteSpace: "pre-wrap" }, children: part.text }) })
   ] }) });
 }
-function ToolRenderer({ part }) {
-  return /* @__PURE__ */ jsx(Box, { style: RAIL_STYLE, children: /* @__PURE__ */ jsxs(Stack, { gap: 4, children: [
-    /* @__PURE__ */ jsx(Text, { style: MICRO_LABEL_STYLE, children: part.toolName }),
-    /* @__PURE__ */ jsx(Text, { component: "pre", size: "xs", style: CODE_BLOCK_STYLE, children: JSON.stringify(part.input, null, 2) }),
-    part.output !== void 0 && /* @__PURE__ */ jsx(Text, { component: "pre", size: "xs", style: CODE_BLOCK_STYLE, children: JSON.stringify(part.output, null, 2) })
-  ] }) });
+function ToolChipRenderer({ part }) {
+  return /* @__PURE__ */ jsx(ToolChip, { part });
 }
 function SourceRenderer({ part }) {
   return /* @__PURE__ */ jsx(Anchor, { href: part.url, target: "_blank", rel: "noopener noreferrer", size: "sm", children: part.title ?? part.url });
@@ -62,70 +50,141 @@ function ErrorRenderer({ part }) {
 const threadPartRenderers = {
   text: TextRenderer,
   reasoning: ReasoningRenderer,
-  tool: ToolRenderer,
+  tool: ToolChipRenderer,
   source: SourceRenderer,
   error: ErrorRenderer
 };
-function coalesceParts(parts) {
-  const out = [];
+function UnknownPartChip({ part }) {
+  return /* @__PURE__ */ jsx(Box, { style: RAIL_STYLE, children: /* @__PURE__ */ jsx(Text, { style: MICRO_LABEL_STYLE, children: `Unknown part: ${part.type}` }) });
+}
+const DEFAULT_FALLBACK_RENDERER = ({ part }) => process.env["NODE_ENV"] !== "production" ? /* @__PURE__ */ jsx(UnknownPartChip, { part }) : null;
+function resolveSegments(parts, renderers, fallbackRenderer) {
+  const segments = [];
+  let buffer = [];
+  const flushBuffer = () => {
+    const first = buffer[0];
+    if (first === void 0) return;
+    segments.push({ kind: "agent", key: first.id, parts: coalesceParts(buffer) });
+    buffer = [];
+  };
   for (const part of parts) {
-    const last = out[out.length - 1];
-    if (part.type === "text" && last?.type === "text") {
-      out[out.length - 1] = { type: "text", text: last.text + part.text };
-    } else if (part.type === "reasoning" && last?.type === "reasoning") {
-      out[out.length - 1] = { type: "reasoning", text: last.text + part.text };
-    } else {
-      out.push(part);
+    const consumerRenderer = renderers[part.type];
+    if (consumerRenderer !== void 0) {
+      flushBuffer();
+      segments.push({
+        kind: "foreign",
+        key: part.id,
+        part,
+        render: consumerRenderer
+      });
+      continue;
+    }
+    const agentPart = narrowAgentPart(part);
+    if (agentPart !== null) {
+      buffer.push(agentPart);
+      continue;
     }
+    flushBuffer();
+    segments.push({
+      kind: "foreign",
+      key: part.id,
+      part,
+      render: fallbackRenderer
+    });
   }
-  return out;
+  flushBuffer();
+  return segments;
 }
 const ROLE_LABEL = {
   user: "You",
   assistant: "Assistant"
 };
-function MessageBlock({
-  author,
-  parts,
-  streaming = false
+const FINISH_INDICATOR = {
+  stopped: { label: "Stopped", statusToken: VX.status.warn },
+  error: { label: "Error", statusToken: VX.status.bad }
+};
+const messageBlockRenderCounter = { count: 0 };
+function MessageBlockImpl({
+  message,
+  streaming = false,
+  renderers,
+  fallbackRenderer
 }) {
+  messageBlockRenderCounter.count += 1;
+  const settled = !streaming;
+  const segments = useMemo(
+    () => resolveSegments(message.parts, renderers, fallbackRenderer),
+    [message.parts, renderers, fallbackRenderer]
+  );
+  const finishIndicator = message.finish === void 0 ? void 0 : FINISH_INDICATOR[message.finish];
   return /* @__PURE__ */ jsx(
     Box,
     {
       style: {
         padding: "var(--vx-space-agent-message-inset-y) var(--vx-space-agent-message-inset-x)",
-        backgroundColor: author === "user" ? VX.surface.subtle : VX.surface.panel,
+        backgroundColor: message.role === "user" ? VX.surface.subtle : VX.surface.panel,
         borderRadius: VX.radiusCard,
         boxShadow: VX.shadowCard
       },
       children: /* @__PURE__ */ jsxs(Stack, { gap: 6, children: [
         /* @__PURE__ */ jsxs(Group, { gap: 6, align: "center", children: [
-          /* @__PURE__ */ jsx(Text, { style: MICRO_LABEL_STYLE, children: ROLE_LABEL[author] }),
-          streaming && /* @__PURE__ */ jsx(Loader, { size: "xs" })
+          /* @__PURE__ */ jsx(Text, { style: MICRO_LABEL_STYLE, children: ROLE_LABEL[message.role] }),
+          streaming && /* @__PURE__ */ jsx(Loader, { size: "xs" }),
+          finishIndicator !== void 0 && /* @__PURE__ */ jsx(Text, { style: { ...MICRO_LABEL_STYLE, color: finishIndicator.statusToken }, children: finishIndicator.label })
         ] }),
-        /* @__PURE__ */ jsx(PartList, { parts: coalesceParts(parts), components: threadPartRenderers })
+        segments.map(
+          (segment) => segment.kind === "agent" ? /* @__PURE__ */ jsx(PartList, { parts: segment.parts, components: threadPartRenderers }, segment.key) : /* @__PURE__ */ jsx(Fragment, { children: segment.render({
+            part: segment.part,
+            messageId: message.id,
+            partId: segment.part.id,
+            settled,
+            role: message.role
+          }) }, segment.key)
+        )
       ] })
     }
   );
 }
+function areMessageBlockPropsEqual(prev, next) {
+  return prev.message === next.message && prev.streaming === next.streaming && prev.renderers === next.renderers && prev.fallbackRenderer === next.fallbackRenderer;
+}
+const MessageBlock = memo(MessageBlockImpl, areMessageBlockPropsEqual);
+const EMPTY_RENDERERS = {};
 function ThreadTranscript({
   messages,
   liveParts,
-  liveStatus
+  liveStatus,
+  renderers: renderersProp,
+  fallbackRenderer = DEFAULT_FALLBACK_RENDERER
 }) {
+  const renderers = useMemo(() => renderersProp ?? EMPTY_RENDERERS, [renderersProp]);
+  const liveMessage = useMemo(() => {
+    if (liveParts === void 0 || liveParts.length === 0) return null;
+    return { id: "__live__", role: "assistant", parts: liveParts, createdAt: 0 };
+  }, [liveParts]);
   return /* @__PURE__ */ jsxs(Stack, { gap: "sm", children: [
-    messages.map((message) => /* @__PURE__ */ jsx(MessageBlock, { author: message.role, parts: message.parts }, message.id)),
-    liveParts !== void 0 && liveParts.length > 0 && /* @__PURE__ */ jsx("div", { "aria-live": "polite", "aria-atomic": "false", "aria-relevant": "additions", children: /* @__PURE__ */ jsx(
+    messages.map((message) => /* @__PURE__ */ jsx(
+      MessageBlock,
+      {
+        message,
+        renderers,
+        fallbackRenderer
+      },
+      message.id
+    )),
+    liveMessage !== null && /* @__PURE__ */ jsx("div", { "aria-live": "polite", "aria-atomic": "false", "aria-relevant": "additions", children: /* @__PURE__ */ jsx(
       MessageBlock,
       {
-        author: "assistant",
-        parts: liveParts,
-        streaming: liveStatus === "streaming"
+        message: liveMessage,
+        streaming: liveStatus === "streaming",
+        renderers,
+        fallbackRenderer
       }
     ) })
   ] });
 }
 export {
   ThreadTranscript,
+  messageBlockRenderCounter,
   threadPartRenderers
 };

package/dist/agent-chat/tool-chip.d.ts

@@ -0,0 +1,21 @@
+import type { JSX } from 'react';
+import type { ToolCallPart } from '../agent/index.js';
+export type ToolChipProps = {
+    readonly part: ToolCallPart;
+    readonly defaultExpanded?: boolean;
+    /** Rendered only in 'approval-requested'. Omit both to render a read-only chip. */
+    readonly onApprove?: (approvalId: string) => void;
+    readonly onDeny?: (approvalId: string, reason?: string) => void;
+};
+/**
+ * A collapsed-by-default row for a single tool-call part. All seven wire states render something
+ * sane; the switch above still gates an eighth (compile-time-unhandled) state as a tsc error via a
+ * `const _: never = part` assignment, but unlike a truly-closed switch, its `default` branch never
+ * throws at RUNTIME — a value from persisted/wire data that reaches here with a `state` this build
+ * doesn't recognize renders an inert 'unknown' chip instead of blanking the transcript.
+ *
+ * @example
+ * <ToolChip part={part} />
+ */
+export declare function ToolChip({ part, defaultExpanded, onApprove, onDeny, }: ToolChipProps): JSX.Element;
+//# sourceMappingURL=tool-chip.d.ts.map

package/dist/agent-chat/tool-chip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-chip.d.ts","sourceRoot":"","sources":["../../src/agent-chat/tool-chip.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAEhC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AA4E5C,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;IAClC,mFAAmF;IACnF,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAChE,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,eAAuB,EACvB,SAAS,EACT,MAAM,GACP,EAAE,aAAa,GAAG,GAAG,CAAC,OAAO,CAiG7B"}