basalt-ui 1.10.0 → 1.11.0

package/dist/agent/index.js

@@ -1,5 +1,9 @@
-import { parseAgentPart, isStartPart } from "./parts.js";
-import { edenTransport } from "./transport.js";
+import { parseAgentPart, isStartPart, isToolCallSettled, TERMINAL_TOOL_STATES } from "./parts.js";
+import { mergePart } from "./merge.js";
+import { withPartIds } from "./id.js";
+import { coalesceParts } from "./coalesce.js";
+import { definePartRenderers, narrowAgentPart } from "./foreign.js";
+import { edenTransport, isResumable } from "./transport.js";
 import { aiSdkTransport } from "./ai-sdk-transport.js";
 import { useAgentStream } from "./use-agent-stream.js";
 import { useAgentThreadRuns } from "./use-agent-thread-runs.js";
@@ -11,13 +15,21 @@ import { heuristicOutcome } from "./outcome.js";
 export {
   BasaltStickToBottom,
   PartList,
+  TERMINAL_TOOL_STATES,
   aiSdkTransport,
+  coalesceParts,
   createChatHistoryStore,
   createThreadsStore,
+  definePartRenderers,
   edenTransport,
   heuristicOutcome,
+  isResumable,
   isStartPart,
+  isToolCallSettled,
+  mergePart,
+  narrowAgentPart,
   parseAgentPart,
   useAgentStream,
-  useAgentThreadRuns
+  useAgentThreadRuns,
+  withPartIds
 };

package/dist/agent/merge.d.ts

@@ -0,0 +1,8 @@
+/** The structural bound `mergePart` (and the hooks that call it) actually need — an `AgentPart` or
+ * a `ForeignPart` both satisfy it, so this is the widened constraint, not a new closed union. */
+export type PartLike = {
+    readonly id: string;
+    readonly type: string;
+};
+export declare function mergePart<TPart extends PartLike>(parts: readonly TPart[], next: TPart): TPart[];
+//# sourceMappingURL=merge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/agent/merge.ts"],"names":[],"mappings":"AA+BA;iGACiG;AACjG,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAgBrE,wBAAgB,SAAS,CAAC,KAAK,SAAS,QAAQ,EAAE,KAAK,EAAE,SAAS,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,EAAE,CAiB/F"}

package/dist/agent/merge.js

@@ -0,0 +1,23 @@
+function isTextLikeType(type) {
+  return type === "text" || type === "reasoning";
+}
+function spliceText(existing, next) {
+  const offset = next.offset ?? existing.text.length;
+  return existing.text.slice(0, offset) + next.text + existing.text.slice(offset + next.text.length);
+}
+function mergePart(parts, next) {
+  const index = parts.findIndex((part) => part.id === next.id);
+  if (index === -1) return [...parts, next];
+  const existing = parts[index];
+  const spliceable = existing.type === next.type && isTextLikeType(next.type);
+  const merged = spliceable ? {
+    ...next,
+    text: spliceText(existing, next)
+  } : next;
+  const out = parts.slice();
+  out[index] = merged;
+  return out;
+}
+export {
+  mergePart
+};

package/dist/agent/part-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"part-list.d.ts","sourceRoot":"","sources":["../../src/agent/part-list.tsx"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAGhC,OAAO,KAAK,EACV,SAAS,EAMV,MAAM,SAAS,CAAA;AAIhB,MAAM,MAAM,gBAAgB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CAAC,KAAK,EAAE;IAC1E,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACtC,KAAK,EAAE,MAAM,CAAA;CACd,KAAK,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAExB,MAAM,MAAM,qBAAqB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CAAC,KAAK,EAAE;IAC/E,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC,CAAA;IAC3C,KAAK,EAAE,MAAM,CAAA;CACd,KAAK,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAExB,MAAM,MAAM,oBAAoB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CAAC,KAAK,EAAE;IAC9E,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACtC,KAAK,EAAE,MAAM,CAAA;CACd,KAAK,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAExB,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CAAC,KAAK,EAAE;IAC5E,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAA;IACxC,KAAK,EAAE,MAAM,CAAA;CACd,KAAK,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAExB,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CAAC,KAAK,EAAE;IAC3E,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IACvC,KAAK,EAAE,MAAM,CAAA;CACd,KAAK,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAExB;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI;IACpE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAA;IAChD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAA;IAC1C,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAC1C,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAA;CACzC,CAAA;AA4HD,MAAM,MAAM,aAAa,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI;IAC/D,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;IACvB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAA;CACzD,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,EAAE,EAC5D,KAAK,EACL,UAAU,GACX,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,OAAO,CAgEpC"}
+{"version":3,"file":"part-list.d.ts","sourceRoot":"","sources":["../../src/agent/part-list.tsx"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAGhC,OAAO,KAAK,EACV,SAAS,EAMV,MAAM,SAAS,CAAA;AAIhB,MAAM,MAAM,gBAAgB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CAAC,KAAK,EAAE;IAC1E,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACtC,KAAK,EAAE,MAAM,CAAA;CACd,KAAK,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAExB,MAAM,MAAM,qBAAqB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CAAC,KAAK,EAAE;IAC/E,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC,CAAA;IAC3C,KAAK,EAAE,MAAM,CAAA;CACd,KAAK,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAExB,MAAM,MAAM,oBAAoB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CAAC,KAAK,EAAE;IAC9E,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACtC,KAAK,EAAE,MAAM,CAAA;CACd,KAAK,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAExB,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CAAC,KAAK,EAAE;IAC5E,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAA;IACxC,KAAK,EAAE,MAAM,CAAA;CACd,KAAK,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAExB,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CAAC,KAAK,EAAE;IAC3E,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IACvC,KAAK,EAAE,MAAM,CAAA;CACd,KAAK,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAExB;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI;IACpE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAA;IAChD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAA;IAC1C,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAC1C,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAA;CACzC,CAAA;AAqJD,MAAM,MAAM,aAAa,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI;IAC/D,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;IACvB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAA;CACzD,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,EAAE,EAC5D,KAAK,EACL,UAAU,GACX,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,OAAO,CAgEpC"}

package/dist/agent/part-list.js

@@ -22,6 +22,10 @@ const CODE_BLOCK_STYLE = {
   padding: "var(--vx-space-agent-code-inset)",
   overflowX: "auto"
 };
+const STATUS_LINE_STYLE = {
+  marginTop: "var(--vx-space-agent-part-gap-top)",
+  color: VX.status.bad
+};
 function DefaultText({ part }) {
   return /* @__PURE__ */ jsx(
     "div",
@@ -56,7 +60,13 @@ function DefaultToolCall({ part }) {
   return /* @__PURE__ */ jsxs("div", { className: "basalt-agent-tool", style: RAIL_STYLE, children: [
     /* @__PURE__ */ jsx("span", { className: "basalt-agent-tool-name", style: MICRO_LABEL_STYLE, children: part.toolName }),
     /* @__PURE__ */ jsx("pre", { className: "basalt-agent-tool-input", style: CODE_BLOCK_STYLE, children: JSON.stringify(part.input, null, 2) }),
-    part.output !== void 0 && /* @__PURE__ */ jsx("pre", { className: "basalt-agent-tool-output", style: CODE_BLOCK_STYLE, children: JSON.stringify(part.output, null, 2) })
+    part.state === "output-error" && part.input === void 0 && part.rawInput !== void 0 && /* @__PURE__ */ jsx("pre", { className: "basalt-agent-tool-raw-input", style: CODE_BLOCK_STYLE, children: JSON.stringify(part.rawInput, null, 2) }),
+    part.state === "output-available" && /* @__PURE__ */ jsx("pre", { className: "basalt-agent-tool-output", style: CODE_BLOCK_STYLE, children: JSON.stringify(part.output, null, 2) }),
+    part.state === "output-error" && /* @__PURE__ */ jsx("div", { className: "basalt-agent-tool-error", role: "alert", style: STATUS_LINE_STYLE, children: part.errorText }),
+    part.state === "output-denied" && /* @__PURE__ */ jsxs("div", { className: "basalt-agent-tool-denied", style: STATUS_LINE_STYLE, children: [
+      "Denied",
+      part.approval.reason !== void 0 ? `: ${part.approval.reason}` : ""
+    ] })
   ] });
 }
 function DefaultSource({ part }) {
@@ -109,23 +119,23 @@ function PartList({
         return null;
       case "text": {
         const Render = renderers.text;
-        return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(Render, { part, index }) }, index);
+        return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(Render, { part, index }) }, part.id);
       }
       case "reasoning": {
         const Render = renderers.reasoning;
-        return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(Render, { part, index }) }, index);
+        return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(Render, { part, index }) }, part.id);
       }
       case "tool": {
         const Render = renderers.tool;
-        return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(Render, { part, index }) }, index);
+        return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(Render, { part, index }) }, part.id);
       }
       case "source": {
         const Render = renderers.source;
-        return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(Render, { part, index }) }, index);
+        return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(Render, { part, index }) }, part.id);
       }
       case "error": {
         const Render = renderers.error;
-        return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(Render, { part, index }) }, index);
+        return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(Render, { part, index }) }, part.id);
       }
       default:
         return assertNever(part);

package/dist/agent/parts.d.ts

@@ -9,6 +9,11 @@
  * explicitly and carry NO t.Object/t.Union response schema. Validate at yield-time. See
  * agent/rules/basalt-agent.md for the full doctrine.
  *
+ * Part identity: every variant carries a stable `id` (see `PartBase`). Transports are permitted to
+ * yield a DRAFT — `id` omitted — via `AgentPartDraft`; the consuming hooks (or `withPartIds`)
+ * normalize a draft into a fully-identified part before it is ever accumulated. `parseAgentPart`
+ * validates the FULL (identified) shape — a draft is a separate, narrower concern.
+ *
  * @example
  * import type { AgentPart } from 'basalt-ui/agent'
  * function describe(p: AgentPart): string {
@@ -23,49 +28,110 @@
  *   }
  * }
  */
+/** Every AgentPart variant carries a stable id — the addressing key for `mergePart`/`coalesceParts`. */
+type PartBase = {
+    readonly id: string;
+};
 /**
  * Emitted once at stream start, carrying the run id and an opaque token a transport can use to
  * resume this run after a disconnect. Not renderable content — UI code should treat it as a
  * no-op signal, not conversation content.
  */
-export type StartPart = {
+export type StartPart = PartBase & {
     readonly type: 'start';
     readonly runId: string;
     readonly resumeToken?: string;
 };
-/** A streamed text fragment from the assistant. */
-export type TextPart = {
+/**
+ * A streamed text fragment from the assistant. `offset` is the character position of this delta
+ * inside its part (undefined = append at the tail) — the mechanism `mergePart` uses to splice a
+ * replayed delta in place rather than duplicating it.
+ */
+export type TextPart = PartBase & {
     readonly type: 'text';
     readonly text: string;
+    readonly offset?: number;
 };
-/** An internal reasoning/thinking fragment (may be hidden in the UI). */
-export type ReasoningPart = {
+/** An internal reasoning/thinking fragment (may be hidden in the UI). Same `offset` mechanism as TextPart. */
+export type ReasoningPart = PartBase & {
     readonly type: 'reasoning';
     readonly text: string;
+    readonly offset?: number;
 };
-/**
- * A tool invocation — input is the parameters sent, output (optional) is the result once
- * the tool has completed. Streams arrive with output undefined; it may be appended later.
- *
- * `toolCallId` (optional) identifies the specific invocation when a transport's wire format
- * carries one (e.g. AI SDK's `ToolUIPart`) — useful for consumer-side coalescing of a tool call's
- * input/output pair by id rather than by array position.
- */
-export type ToolCallPart = {
+/** The nested approval envelope — mirrors the SDK's shape verbatim, never flattened. */
+type ToolApproval = {
+    readonly id: string;
+    readonly approved?: boolean;
+    readonly reason?: string;
+    readonly isAutomatic?: boolean;
+    readonly signature?: string;
+};
+type ToolCallBase = PartBase & {
     readonly type: 'tool';
+    /** Required on all seven states (was optional — see parts.ts history). */
+    readonly toolCallId: string;
     readonly toolName: string;
-    readonly input: unknown;
-    readonly output?: unknown;
-    readonly toolCallId?: string;
+    /** Wall-clock time from first sighting of this toolCallId to its terminal state. */
+    readonly durationMs?: number;
+    readonly providerExecuted?: boolean;
 };
+export type ToolCallPart = (ToolCallBase & {
+    readonly state: 'input-streaming';
+    readonly input?: unknown;
+}) | (ToolCallBase & {
+    readonly state: 'input-available';
+    readonly input: unknown;
+}) | (ToolCallBase & {
+    readonly state: 'approval-requested';
+    readonly input: unknown;
+    readonly approval: ToolApproval & {
+        readonly approved?: never;
+        readonly reason?: never;
+    };
+}) | (ToolCallBase & {
+    readonly state: 'approval-responded';
+    readonly input: unknown;
+    readonly approval: ToolApproval & {
+        readonly approved: boolean;
+    };
+}) | (ToolCallBase & {
+    readonly state: 'output-available';
+    readonly input: unknown;
+    readonly output: unknown;
+    readonly preliminary?: boolean;
+    readonly approval?: ToolApproval & {
+        readonly approved?: true;
+    };
+}) | (ToolCallBase & {
+    readonly state: 'output-error';
+    readonly input?: unknown;
+    /** The SDK's field name — there is no field named `error` anywhere in the union. */
+    readonly errorText: string;
+    /** The only place the raw, un-parsed input survives — what lets a UI render a call whose input never validated. */
+    readonly rawInput?: unknown;
+    readonly approval?: ToolApproval & {
+        readonly approved?: true;
+    };
+}) | (ToolCallBase & {
+    readonly state: 'output-denied';
+    readonly input: unknown;
+    readonly approval: ToolApproval & {
+        readonly approved: false;
+    };
+});
+export type ToolCallState = ToolCallPart['state'];
+/** The three states a tool call can never leave — see `isToolCallSettled`. */
+export declare const TERMINAL_TOOL_STATES: readonly ["output-available", "output-error", "output-denied"];
+/** True once a tool call has reached one of `TERMINAL_TOOL_STATES` — no further state transition. */
+export declare function isToolCallSettled(part: ToolCallPart): boolean;
 /** A cited source URL referenced by the assistant. */
-export type SourcePart = {
+export type SourcePart = PartBase & {
     readonly type: 'source';
     readonly url: string;
     readonly title?: string;
 };
 /** A fatal or recoverable error emitted in-stream by the agent. */
-export type ErrorPart = {
+export type ErrorPart = PartBase & {
     readonly type: 'error';
     readonly message: string;
 };
@@ -73,12 +139,24 @@ export type ErrorPart = {
  * The complete discriminated union of all structured agent stream parts.
  *
  * @example
- * const part: AgentPart = { type: 'text', text: 'Hello' }
+ * const part: AgentPart = { id: 'p1', type: 'text', text: 'Hello' }
  */
 export type AgentPart = StartPart | TextPart | ReasoningPart | ToolCallPart | SourcePart | ErrorPart;
+/**
+ * An AgentPart with `id` optional — the shape a transport is allowed to yield. The naked type
+ * parameter (not `AgentPart extends unknown ? ... : never` written some other way) is deliberate:
+ * it makes the conditional type distribute over the AgentPart union member-by-member, so
+ * `Drafted<AgentPart>` is `Drafted<StartPart> | Drafted<TextPart> | ...` rather than one flattened
+ * (and wrong) shape.
+ */
+export type Drafted<T> = T extends unknown ? Omit<T, 'id'> & {
+    readonly id?: string;
+} : never;
+export type AgentPartDraft = Drafted<AgentPart>;
 /**
  * Runtime type-narrowing guard: validates an unknown value against the AgentPart discriminated
- * union and returns the narrowed type or null when validation fails.
+ * union and returns the narrowed type or null when validation fails. Validates the FULL
+ * (identified) shape — an `id`-less draft is a separate concern handled by `withPartIds`.
  *
  * @example
  * const raw = JSON.parse(line)
@@ -88,4 +166,5 @@ export type AgentPart = StartPart | TextPart | ReasoningPart | ToolCallPart | So
 export declare function parseAgentPart(raw: unknown): AgentPart | null;
 /** Type guard: narrows an unknown value to StartPart. */
 export declare function isStartPart(part: unknown): part is StartPart;
+export {};
 //# sourceMappingURL=parts.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"parts.d.ts","sourceRoot":"","sources":["../../src/agent/parts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED,mDAAmD;AACnD,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvE,yEAAyE;AACzE,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjF;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnG,mEAAmE;AACnE,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5E;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAA;AAIpG;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CA0C7D;AAID,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,SAAS,CAE5D"}
+{"version":3,"file":"parts.d.ts","sourceRoot":"","sources":["../../src/agent/parts.ts"],"names":[],"mappings":"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"}

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