basalt-ui 1.9.0 → 1.11.0

package/dist/agent/parts.js

@@ -1,49 +1,166 @@
+const TERMINAL_TOOL_STATES = ["output-available", "output-error", "output-denied"];
+function isToolCallSettled(part) {
+  return TERMINAL_TOOL_STATES.includes(part.state);
+}
 function parseAgentPart(raw) {
   if (raw === null || typeof raw !== "object") return null;
   const obj = raw;
   if (typeof obj["type"] !== "string") return null;
+  if (typeof obj["id"] !== "string") return null;
+  const id = obj["id"];
   switch (obj["type"]) {
     case "start":
       if (typeof obj["runId"] !== "string") return null;
       return {
+        id,
         type: "start",
         runId: obj["runId"],
         ...typeof obj["resumeToken"] === "string" ? { resumeToken: obj["resumeToken"] } : {}
       };
     case "text":
       if (typeof obj["text"] !== "string") return null;
-      return { type: "text", text: obj["text"] };
+      return {
+        id,
+        type: "text",
+        text: obj["text"],
+        ...typeof obj["offset"] === "number" ? { offset: obj["offset"] } : {}
+      };
     case "reasoning":
       if (typeof obj["text"] !== "string") return null;
-      return { type: "reasoning", text: obj["text"] };
-    case "tool":
-      if (typeof obj["toolName"] !== "string") return null;
-      if (!("input" in obj)) return null;
       return {
-        type: "tool",
-        toolName: obj["toolName"],
-        input: obj["input"],
-        ...obj["output"] !== void 0 ? { output: obj["output"] } : {},
-        ...typeof obj["toolCallId"] === "string" ? { toolCallId: obj["toolCallId"] } : {}
+        id,
+        type: "reasoning",
+        text: obj["text"],
+        ...typeof obj["offset"] === "number" ? { offset: obj["offset"] } : {}
       };
+    case "tool":
+      return parseToolCallPart(id, obj);
     case "source":
       if (typeof obj["url"] !== "string") return null;
       return {
+        id,
         type: "source",
         url: obj["url"],
         ...typeof obj["title"] === "string" ? { title: obj["title"] } : {}
       };
     case "error":
       if (typeof obj["message"] !== "string") return null;
-      return { type: "error", message: obj["message"] };
+      return { id, type: "error", message: obj["message"] };
     default:
       return null;
   }
 }
+function parseToolCallPart(id, obj) {
+  if (typeof obj["toolCallId"] !== "string") return null;
+  if (typeof obj["toolName"] !== "string") return null;
+  if (typeof obj["state"] !== "string") return null;
+  const { toolCallId, toolName } = obj;
+  const common = {
+    id,
+    type: "tool",
+    toolCallId,
+    toolName,
+    ...typeof obj["durationMs"] === "number" ? { durationMs: obj["durationMs"] } : {},
+    ...typeof obj["providerExecuted"] === "boolean" ? { providerExecuted: obj["providerExecuted"] } : {}
+  };
+  switch (obj["state"]) {
+    case "input-streaming":
+      return {
+        ...common,
+        state: "input-streaming",
+        ..."input" in obj ? { input: obj["input"] } : {}
+      };
+    case "input-available":
+      if (!("input" in obj)) return null;
+      return { ...common, state: "input-available", input: obj["input"] };
+    case "approval-requested": {
+      if (!("input" in obj)) return null;
+      const approval = parseApproval(obj["approval"]);
+      if (approval === null || approval.approved !== void 0 || approval.reason !== void 0) {
+        return null;
+      }
+      return {
+        ...common,
+        state: "approval-requested",
+        input: obj["input"],
+        approval
+      };
+    }
+    case "approval-responded": {
+      if (!("input" in obj)) return null;
+      const approval = parseApproval(obj["approval"]);
+      if (approval === null || typeof approval.approved !== "boolean") return null;
+      return {
+        ...common,
+        state: "approval-responded",
+        input: obj["input"],
+        approval
+      };
+    }
+    case "output-denied": {
+      if (!("input" in obj)) return null;
+      const approval = parseApproval(obj["approval"]);
+      if (approval === null || approval.approved !== false) return null;
+      return {
+        ...common,
+        state: "output-denied",
+        input: obj["input"],
+        approval
+      };
+    }
+    case "output-available": {
+      if (!("input" in obj)) return null;
+      if (!("output" in obj)) return null;
+      const approval = obj["approval"] === void 0 ? null : parseApproval(obj["approval"]);
+      if (obj["approval"] !== void 0 && (approval === null || approval.approved === false)) {
+        return null;
+      }
+      return {
+        ...common,
+        state: "output-available",
+        input: obj["input"],
+        output: obj["output"],
+        ...typeof obj["preliminary"] === "boolean" ? { preliminary: obj["preliminary"] } : {},
+        ...approval !== null ? { approval } : {}
+      };
+    }
+    case "output-error": {
+      if (typeof obj["errorText"] !== "string") return null;
+      const approval = obj["approval"] === void 0 ? null : parseApproval(obj["approval"]);
+      if (obj["approval"] !== void 0 && (approval === null || approval.approved === false)) {
+        return null;
+      }
+      return {
+        ...common,
+        state: "output-error",
+        errorText: obj["errorText"],
+        ..."input" in obj ? { input: obj["input"] } : {},
+        ..."rawInput" in obj ? { rawInput: obj["rawInput"] } : {},
+        ...approval !== null ? { approval } : {}
+      };
+    }
+    default:
+      return null;
+  }
+}
+function parseApproval(raw) {
+  if (raw === null || typeof raw !== "object") return null;
+  const obj = raw;
+  if (typeof obj["id"] !== "string") return null;
+  return {
+    id: obj["id"],
+    ...typeof obj["approved"] === "boolean" ? { approved: obj["approved"] } : {},
+    ...typeof obj["reason"] === "string" ? { reason: obj["reason"] } : {},
+    ...typeof obj["isAutomatic"] === "boolean" ? { isAutomatic: obj["isAutomatic"] } : {},
+    ...typeof obj["signature"] === "string" ? { signature: obj["signature"] } : {}
+  };
+}
 function isStartPart(part) {
   return typeof part === "object" && part !== null && part.type === "start";
 }
 export {
+  TERMINAL_TOOL_STATES,
   isStartPart,
+  isToolCallSettled,
   parseAgentPart
 };

package/dist/agent/transport.d.ts

@@ -29,11 +29,16 @@
  *   api.chat.post({ body: { message: input }, fetch: { signal } }),
  * )
  */
-import type { AgentPart } from './parts.js';
+import type { AgentPart, AgentPartDraft } from './parts.js';
 /**
  * The injected transport seam. `stream(input, signal)` returns an async generator of parts.
  * Implement this interface for any backend — Eden, fetch-based SSE, AI SDK, or a mock.
  *
+ * The default `TPart` is `AgentPartDraft` (not `AgentPart`): transports yield DRAFTS — `id`
+ * optional — and the consuming hooks (or `withPartIds`) normalize a draft into a fully-identified
+ * part before it is ever accumulated. Pass an explicit `AgentPart` generic when a transport mints
+ * its own ids directly (as `aiSdkTransport` does).
+ *
  * @example
  * // Minimal mock transport for tests / playground:
  * const mockTransport: AgentTransport = {
@@ -42,11 +47,33 @@ import type { AgentPart } from './parts.js';
  *   },
  * }
  */
-export type AgentTransport<TPart = AgentPart, TInput = string> = {
+export type AgentTransport<TPart = AgentPartDraft, TInput = string> = {
     stream: (input: TInput, signal?: AbortSignal) => AsyncGenerator<TPart>;
     /** Optional: resume a previously-started run from its resumeToken (see StartPart). Transports that don't support resumption simply omit this. */
     resume?: (resumeToken: string, signal?: AbortSignal) => AsyncGenerator<TPart>;
 };
+/**
+ * A transport whose replay is safe to run over an already-rendered turn. Implementing `resume`
+ * alone is no longer enough: `idempotentReplay: true` is a literal-typed assertion that every
+ * text/reasoning part this transport emits carries an authoritative `offset`, so mergePart
+ * rewrites instead of appending.
+ */
+export type ResumableAgentTransport<TPart = AgentPartDraft, TInput = string> = AgentTransport<TPart, TInput> & {
+    readonly resume: (resumeToken: string, signal?: AbortSignal) => AsyncGenerator<TPart>;
+    readonly idempotentReplay: true;
+};
+/**
+ * Type guard: true when `t` both implements `resume` AND has explicitly asserted
+ * `idempotentReplay: true`. A transport with `resume` but no `idempotentReplay` is NOT resumable
+ * — the mount-time reconcile in `useAgentThreadRuns` falls back to `'interrupted'` for it rather
+ * than risk duplicating already-rendered content.
+ *
+ * @example
+ * if (isResumable(transport)) {
+ *   for await (const part of transport.resume(resumeToken)) { ... }
+ * }
+ */
+export declare function isResumable<TPart, TInput>(t: AgentTransport<TPart, TInput>): t is ResumableAgentTransport<TPart, TInput>;
 /**
  * Wraps a consumer's Eden async-generator call into an AgentTransport.
  *
@@ -64,6 +91,12 @@ export type AgentTransport<TPart = AgentPart, TInput = string> = {
  * object has NO `resume` key at all (not `resume: undefined`) — consumers that don't wire a
  * resumable backend get a transport that behaves exactly as before.
  *
+ * `resumeCall` alone does NOT make the transport resumable per `isResumable` — pass
+ * `{ idempotentReplay: true }` as the third argument to opt in EXPLICITLY once the server-side
+ * `resumeCall` route is verified to re-emit every text/reasoning delta with an authoritative
+ * `offset` (never a bare append). This is an opt-in, not an inference: a `resumeCall` whose deltas
+ * aren't offset-accurate would double-render on replay if treated as resumable.
+ *
  * @example
  * import { edenTransport, type AgentPart } from 'basalt-ui/agent'
  *
@@ -72,6 +105,7 @@ export type AgentTransport<TPart = AgentPart, TInput = string> = {
  * const transport = edenTransport<AgentPart>(
  *   (input, signal) => api.chat.post({ body: { message: input }, fetch: { signal } }),
  *   (resumeToken, signal) => api.chat.resume.post({ body: { resumeToken }, fetch: { signal } }),
+ *   { idempotentReplay: true },
  * )
  *
  * // Wire into useAgentStream:
@@ -83,5 +117,7 @@ export declare function edenTransport<TPart = AgentPart, TInput = string>(call:
 }>, resumeCall?: (resumeToken: string, signal?: AbortSignal) => Promise<{
     data: AsyncGenerator<TPart> | null;
     error: unknown;
-}>): AgentTransport<TPart, TInput>;
+}>, options?: {
+    readonly idempotentReplay?: true;
+}): AgentTransport<TPart, TInput> | ResumableAgentTransport<TPart, TInput>;
 //# sourceMappingURL=transport.d.ts.map

package/dist/agent/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/agent/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAIxC;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,SAAS,EAAE,MAAM,GAAG,MAAM,IAAI;IAC/D,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,cAAc,CAAC,KAAK,CAAC,CAAA;IACtE,iJAAiJ;IACjJ,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,cAAc,CAAC,KAAK,CAAC,CAAA;CAC9E,CAAA;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAG,SAAS,EAAE,MAAM,GAAG,MAAM,EAC9D,IAAI,EAAE,CACJ,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC;IAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,EACpE,UAAU,CAAC,EAAE,CACX,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC;IAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,GACnE,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAmB/B"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/agent/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAIxD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,cAAc,EAAE,MAAM,GAAG,MAAM,IAAI;IACpE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,cAAc,CAAC,KAAK,CAAC,CAAA;IACtE,iJAAiJ;IACjJ,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,cAAc,CAAC,KAAK,CAAC,CAAA;CAC9E,CAAA;AAID;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,CAAC,KAAK,GAAG,cAAc,EAAE,MAAM,GAAG,MAAM,IAAI,cAAc,CAC3F,KAAK,EACL,MAAM,CACP,GAAG;IACF,QAAQ,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,cAAc,CAAC,KAAK,CAAC,CAAA;IACrF,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAA;CAChC,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EACvC,CAAC,EAAE,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,GAC/B,CAAC,IAAI,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,CAK7C;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAG,SAAS,EAAE,MAAM,GAAG,MAAM,EAC9D,IAAI,EAAE,CACJ,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC;IAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,EACpE,UAAU,CAAC,EAAE,CACX,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC;IAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,EACpE,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAA;CAAE,GAC7C,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,CAsBxE"}

package/dist/agent/transport.js

@@ -1,21 +1,24 @@
-function edenTransport(call, resumeCall) {
-  return {
-    async *stream(input, signal) {
-      const { data, error } = await call(input, signal);
-      if (error) throw error;
-      if (data === null) return;
-      yield* data;
-    },
-    ...resumeCall !== void 0 ? {
-      async *resume(resumeToken, signal) {
-        const { data, error } = await resumeCall(resumeToken, signal);
-        if (error) throw error;
-        if (data === null) return;
-        yield* data;
-      }
-    } : {}
+function isResumable(t) {
+  return typeof t.resume === "function" && t.idempotentReplay === true;
+}
+function edenTransport(call, resumeCall, options) {
+  const stream = async function* (input, signal) {
+    const { data, error } = await call(input, signal);
+    if (error) throw error;
+    if (data === null) return;
+    yield* data;
+  };
+  if (resumeCall === void 0) return { stream };
+  const resume = async function* (resumeToken, signal) {
+    const { data, error } = await resumeCall(resumeToken, signal);
+    if (error) throw error;
+    if (data === null) return;
+    yield* data;
   };
+  if (options?.idempotentReplay !== true) return { stream, resume };
+  return { stream, resume, idempotentReplay: true };
 }
 export {
-  edenTransport
+  edenTransport,
+  isResumable
 };

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

@@ -1,3 +1,4 @@
+import type { PartLike } from './merge.js';
 import type { AgentPart } from './parts.js';
 import type { AgentTransport } from './transport.js';
 /** The lifecycle state of the current stream. */
@@ -28,7 +29,7 @@ export type UseAgentStreamReturn<TPart, TInput> = {
  * // parts accumulates as the stream arrives
  * // status: 'idle' → 'streaming' → 'done' (or 'error')
  */
-export declare function useAgentStream<TPart = AgentPart, TInput = string>({ transport, }: {
+export declare function useAgentStream<TPart extends PartLike = AgentPart, TInput = string>({ transport, }: {
     transport: AgentTransport<TPart, TInput>;
 }): UseAgentStreamReturn<TPart, TInput>;
 //# sourceMappingURL=use-agent-stream.d.ts.map

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,CA6KjE"}
+{"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;
@@ -117,6 +156,8 @@ function useAgentThreadRuns({
   useEffect(
     () => () => {
       controllersRef.current.forEach((controller) => controller.abort());
+      controllersRef.current.clear();
+      appendedRef.current.clear();
     },
     []
   );
@@ -127,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;
       }
@@ -142,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,
@@ -175,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,
@@ -194,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

@@ -2,11 +2,12 @@
  * Mantine-styled thread-chat components over the headless `basalt-ui/agent` layer, capped by the
  * flagship `ThreadWorkspace` composite.
  *
- * This module is Mantine-coupled by design and lives under the root entry (unlike `basalt-ui/agent`,
- * which stays headless so it can be styled by any consumer).
+ * This module is Mantine-coupled by design and ships its own `basalt-ui/agent-chat` subpath
+ * (also re-exported from the root entry, unchanged for existing consumers) — unlike
+ * `basalt-ui/agent`, which stays headless so it can be styled by any consumer.
  *
  * @example
- * import { ThreadWorkspace } from 'basalt-ui'
+ * import { ThreadWorkspace } from 'basalt-ui/agent-chat'
  * import { createThreadsStore, edenTransport, heuristicOutcome } from 'basalt-ui/agent'
  */
 export { ThreadWorkspace } from './thread-workspace.js';
@@ -21,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;;;;;;;;;;GAUG;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
 };