basalt-ui 1.10.0 → 1.12.0

package/dist/agent/parts.js

@@ -1,49 +1,176 @@
+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["toolName"] !== "string") return null;
+  if (typeof obj["state"] !== "string") return null;
+  const rawToolCallId = obj["toolCallId"];
+  if (rawToolCallId !== void 0 && typeof rawToolCallId !== "string") return null;
+  const toolCallId = typeof rawToolCallId === "string" && rawToolCallId.length > 0 ? rawToolCallId : void 0;
+  const toolName = obj["toolName"];
+  const common = {
+    id,
+    type: "tool",
+    toolName,
+    ...typeof obj["durationMs"] === "number" ? { durationMs: obj["durationMs"] } : {},
+    ...typeof obj["providerExecuted"] === "boolean" ? { providerExecuted: obj["providerExecuted"] } : {}
+  };
+  const identified = toolCallId !== void 0 ? { ...common, toolCallId } : null;
+  const identity = toolCallId !== void 0 ? { toolCallId } : {};
+  switch (obj["state"]) {
+    case "input-streaming":
+      if (identified === null) return null;
+      return {
+        ...identified,
+        state: "input-streaming",
+        ..."input" in obj ? { input: obj["input"] } : {}
+      };
+    case "input-available":
+      if (identified === null) return null;
+      if (!("input" in obj)) return null;
+      return { ...identified, state: "input-available", input: obj["input"] };
+    case "approval-requested": {
+      if (identified === null) return null;
+      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 {
+        ...identified,
+        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,
+        ...identity,
+        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,
+        ...identity,
+        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,
+        ...identity,
+        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,
+        ...identity,
+        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/parts.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parts.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parts.test.d.ts","sourceRoot":"","sources":["../../src/agent/parts.test.ts"],"names":[],"mappings":""}

package/dist/agent/thread.d.ts

@@ -103,6 +103,20 @@ export type ThreadsStore<TPart = AgentPart> = {
     readonly remove: (id: string) => void;
     /** Remove all threads and clear the active selection. */
     readonly clear: () => void;
+    /**
+     * Whether `threads` reflects the backing store yet. Always `true` for the localStorage store
+     * (createPersistedState resolves synchronously); meaningful only for an async, server-backed
+     * store built with `createAdapterThreadsStore` (./adapter), where it stays `false` until the
+     * first `listThreads` SUCCEEDS. Pair it with `error` — `!hydrated && error !== undefined` is a
+     * failed load, `!hydrated && error === undefined` is still loading.
+     */
+    readonly hydrated: boolean;
+    /**
+     * The most recent persistence failure, or `undefined`. Always `undefined` for the localStorage
+     * store, which has no failure the caller can act on. An async store surfaces the rejected
+     * load/write here after rolling its optimistic edit back.
+     */
+    readonly error: unknown;
 };
 /**
  * Creates a stable persisted multi-thread hook for the given key + version.

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

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

package/dist/agent/thread.js

@@ -1,5 +1,6 @@
 import { useCallback, useRef } from "react";
 import { createPersistedState } from "../state.js";
+import { mintThreadId } from "./id.js";
 function createThreadsStore(opts) {
   const maxThreads = opts.maxThreads ?? 50;
   const maxMessages = opts.maxMessagesPerThread ?? 100;
@@ -27,7 +28,7 @@ function createThreadsStore(opts) {
     );
     const create = useCallback(
       (createOpts) => {
-        const id = crypto.randomUUID();
+        const id = mintThreadId();
         const now = Date.now();
         const thread = {
           id,
@@ -122,7 +123,12 @@ function createThreadsStore(opts) {
       setResumeToken,
       markRead,
       remove,
-      clear
+      clear,
+      // localStorage resolves synchronously and swallows its own quota errors, so there is never
+      // a pending load to await nor a failure a caller could act on. See ./adapter for the async
+      // store where these two carry real information.
+      hydrated: true,
+      error: void 0
     };
   };
 }

package/dist/agent/thread.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=thread.test.d.ts.map

package/dist/agent/thread.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.test.d.ts","sourceRoot":"","sources":["../../src/agent/thread.test.ts"],"names":[],"mappings":""}

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/transport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport.test.d.ts","sourceRoot":"","sources":["../../src/agent/transport.test.ts"],"names":[],"mappings":""}

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-stream.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=use-agent-stream.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent-stream.test.d.ts","sourceRoot":"","sources":["../../src/agent/use-agent-stream.test.tsx"],"names":[],"mappings":""}

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.foreign.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=use-agent-thread-runs.foreign.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent-thread-runs.foreign.test.d.ts","sourceRoot":"","sources":["../../src/agent/use-agent-thread-runs.foreign.test.tsx"],"names":[],"mappings":""}