basalt-ui 1.9.0 → 1.11.0

package/dist/agent/foreign.d.ts

@@ -0,0 +1,97 @@
+/**
+ * foreign.ts — the open half of the transcript's part-rendering registry.
+ *
+ * `AgentPart` (`./parts`) is a closed, exhaustively-switched union — adding a variant without
+ * updating every consuming switch is a tsc error (`PartList`'s `assertNever` gate). A transport
+ * that streams app-specific structured data (a chart spec, a progress ping) needs a part type
+ * `AgentPart` will never carry — closing the union around it would defeat the whole point of the
+ * gate. This file is the seam: `ForeignPart` describes what basalt does NOT know, `ConsumerPart`
+ * resolves the augmented union a consumer registers via `declare module 'basalt-ui'`, and
+ * `definePartRenderers` types an exhaustive renderer map against it. See
+ * `agent-chat/thread-message.tsx`'s three-step resolution order for how this plugs into
+ * `ThreadTranscript`: a consumer renderer wins first, `narrowAgentPart` routes the built-in six to
+ * `PartList`'s own exhaustive switch second, and `fallbackRenderer` catches anything left.
+ *
+ * @example
+ * // app-side: src/features/chat/parts.ts
+ * type ChartPart = { type: 'data-chart'; id: string; spec: ChartSpec }
+ * declare module 'basalt-ui' {
+ *   interface BasaltRegister { parts: ChartPart }
+ * }
+ * export const chatRenderers = definePartRenderers({
+ *   'data-chart': ({ part, settled }) => (settled ? <Chart spec={part.spec} /> : <ChartSkeleton />),
+ * })
+ */
+import type { ReactNode } from 'react';
+import type { BasaltRegister } from '../register.js';
+import type { ChatMessage } from './history.js';
+import type { AgentPart } from './parts.js';
+/** A part basalt does not know. NOT a member of AgentPart — the built-in union stays closed. */
+export type ForeignPart = {
+    readonly type: string;
+    readonly id: string;
+    readonly [k: string]: unknown;
+};
+/** What a transcript actually holds — basalt's own six variants plus anything a consumer registers. */
+export type TranscriptPart = AgentPart | ForeignPart;
+/** The consumer's registered foreign-part union, or `never` when un-augmented. */
+export type ConsumerPart = BasaltRegister extends {
+    parts: infer P extends ForeignPart;
+} ? P : never;
+/**
+ * Un-augmented: a loose string-keyed map (any renderer, any key — there is nothing to check
+ * against). Augmented: a MISSING key is a tsc error (`definePartRenderers` requires the full
+ * registered union), and each renderer's `part` is narrowed to exactly its variant. Same
+ * bound-check mechanism as `SeriesKey` (`register.ts:26-58`), applied to a union instead of a map.
+ *
+ * NOT caught: a STALE (extra, unregistered) key. `<const T extends Constraint>` inference does
+ * not excess-property-check an object-literal argument the way a direct assignment to a fixed
+ * target type would (verified against this repo's tsc — see
+ * `apps/playground/src/demo/agent-part-registry.type-guard.ts`'s Fixture 3) — an extra key
+ * compiles as dead code rather than erroring. Catching it would need an `Exact<T, Shape>`-style
+ * wrapper that departs from the `spec: T` "canonical token-factory contract" every other `defineX`
+ * in this codebase follows verbatim; that trade was left as a documented gap rather than a one-off
+ * factory shape.
+ */
+export type PartRenderers = [ConsumerPart] extends [never] ? Readonly<Record<string, PartRenderer<ForeignPart>>> : {
+    readonly [K in ConsumerPart['type']]: PartRenderer<Extract<ConsumerPart, {
+        type: K;
+    }>>;
+};
+/** Everything a foreign-part renderer needs beyond the part itself. */
+export type PartRenderContext<TPart = ForeignPart> = {
+    readonly part: TPart;
+    readonly messageId: string;
+    readonly partId: string;
+    /** false while this part belongs to the in-flight tail of a streaming turn. */
+    readonly settled: boolean;
+    readonly role: ChatMessage['role'];
+};
+export type PartRenderer<TPart = ForeignPart> = (ctx: PartRenderContext<TPart>) => ReactNode;
+/**
+ * Canonical const-generic factory (`packages/basalt-ui/CLAUDE.md`, "Canonical token-factory
+ * contract") — identity passthrough, exact-keyed return, no builder, no config bag. Mirrors
+ * `defineSeries` (`tokens/index.ts:648-650`) and `defineNotifications`
+ * (`notifications/define-notifications.ts:112-115`).
+ *
+ * @example
+ * const chatRenderers = definePartRenderers({
+ *   'data-chart': ({ part }) => <Chart spec={part.spec} />,
+ * })
+ */
+export declare function definePartRenderers<const T extends PartRenderers>(map: T): T;
+/**
+ * Returns `part` as an `AgentPart` when its `type` is one of the six built-in variants, else
+ * `null`. Deliberately NOT routed through `parseAgentPart`: that function is a VALIDATING parser
+ * for untrusted wire data — it checks every field a variant requires (`runId`, `toolCallId`,
+ * `approval`, ...) and would reject an already-well-typed in-memory `AgentPart` on shape grounds
+ * if it doesn't happen to match the wire representation byte-for-byte. `narrowAgentPart` is the
+ * cheap complement: a plain discriminator check on a value already known to be a `TranscriptPart`,
+ * used purely to route rendering — it trusts the caller's typing rather than re-validating it.
+ *
+ * @example
+ * const agentPart = narrowAgentPart(part)
+ * if (agentPart !== null) return <PartList parts={[agentPart]} />
+ */
+export declare function narrowAgentPart(part: TranscriptPart): AgentPart | null;
+//# sourceMappingURL=foreign.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"foreign.d.ts","sourceRoot":"","sources":["../../src/agent/foreign.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAIxC,gGAAgG;AAChG,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAC9B,CAAA;AAED,uGAAuG;AACvG,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,WAAW,CAAA;AAuBpD,kFAAkF;AAClF,MAAM,MAAM,YAAY,GAAG,cAAc,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC,SAAS,WAAW,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAA;AAIpG;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,GACtD,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,GACnD;IAAE,QAAQ,EAAE,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CAAE,CAAA;AAE9F,uEAAuE;AACvE,MAAM,MAAM,iBAAiB,CAAC,KAAK,GAAG,WAAW,IAAI;IACnD,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,YAAY,CAAC,KAAK,GAAG,WAAW,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,KAAK,CAAC,KAAK,SAAS,CAAA;AAE5F;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,CAAC,SAAS,aAAa,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAE5E;AAaD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,CAEtE"}

package/dist/agent/foreign.js

@@ -0,0 +1,18 @@
+function definePartRenderers(map) {
+  return map;
+}
+const AGENT_PART_TYPES = /* @__PURE__ */ new Set([
+  "start",
+  "text",
+  "reasoning",
+  "tool",
+  "source",
+  "error"
+]);
+function narrowAgentPart(part) {
+  return AGENT_PART_TYPES.has(part.type) ? part : null;
+}
+export {
+  definePartRenderers,
+  narrowAgentPart
+};

package/dist/agent/history.d.ts

@@ -16,6 +16,8 @@ export type ChatMessage<TPart = AgentPart> = {
     readonly role: 'user' | 'assistant';
     readonly parts: TPart[];
     readonly createdAt: number;
+    /** How the turn ended. Absent on user messages and on pre-1.11 persisted assistant messages. */
+    readonly finish?: 'complete' | 'stopped' | 'error';
 };
 export type ChatHistoryStoreOptions = {
     /** localStorage key (namespaced as `basalt:<key>`). Stable — changes key lose history. */

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

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/agent/history.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAIxC;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,CAAC,KAAK,GAAG,SAAS,IAAI;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B,CAAA;AAID,MAAM,MAAM,uBAAuB,GAAG;IACpC,0FAA0F;IAC1F,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAID,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,SAAS,IAAI;IAChD,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAA;IACvC,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,IAAI,CAAA;IACtD,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAC3B,CAAA;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,GAAG,SAAS,EACtD,IAAI,EAAE,uBAAuB,GAC5B,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAoC/B"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/agent/history.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAIxC;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,CAAC,KAAK,GAAG,SAAS,IAAI;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,gGAAgG;IAChG,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAA;CACnD,CAAA;AAID,MAAM,MAAM,uBAAuB,GAAG;IACpC,0FAA0F;IAC1F,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAID,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,SAAS,IAAI;IAChD,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAA;IACvC,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,IAAI,CAAA;IACtD,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAC3B,CAAA;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,GAAG,SAAS,EACtD,IAAI,EAAE,uBAAuB,GAC5B,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAoC/B"}

package/dist/agent/id.d.ts

@@ -0,0 +1,35 @@
+/**
+ * withPartIds — stamps a stable id onto every draft part arriving without one.
+ *
+ * A transport is allowed to yield a draft (`AgentPartDraft` — `id` optional); this wraps such a
+ * generator and normalizes it into a fully-identified stream, minting `${runId}#${n}` for any
+ * part that arrives without an `id`. A part that already carries an id passes through untouched
+ * (idempotent) and does not advance the counter.
+ *
+ * NOT a replay-convergence mechanism. The minted id is a bare per-call sequence number with no
+ * relationship to content or offset — it identifies "the nth id-less part THIS invocation saw",
+ * nothing more. Calling `withPartIds` again over a resumed/replayed stream restarts its counter at
+ * 0, so the resumed stream's first delta mints the SAME id as the original run's first delta
+ * (`${runId}#0`) regardless of whether it carries the same content — if the resumed transport
+ * re-sends the full text as one chunk while the original sent it as several deltas, mergePart's
+ * tail-splice will corrupt the accumulated text rather than converge it. A transport that needs
+ * genuine replay convergence (one asserting `ResumableAgentTransport`'s `idempotentReplay: true`)
+ * MUST mint its own content-stable ids — e.g. `aiSdkTransport`'s `${chatId}#${index}` /
+ * `tool#${toolCallId}` — and must not rely on this helper for that guarantee. Combining
+ * `withPartIds` with a transport that asserts `idempotentReplay: true` is only safe when that
+ * transport already mints stable ids itself, in which case every part already carries an `id` and
+ * `withPartIds` is a no-op passthrough (see the idempotent behavior above) — it is never the thing
+ * providing replay safety.
+ *
+ * @example
+ * const identified = withPartIds(runId, transport.stream(input, signal))
+ * for await (const part of identified) {
+ *   // part.id is always defined here
+ * }
+ */
+export declare function withPartIds<TPart extends {
+    id?: string;
+}>(runId: string, source: AsyncGenerator<TPart>): AsyncGenerator<TPart & {
+    id: string;
+}>;
+//# sourceMappingURL=id.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/agent/id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAuB,WAAW,CAAC,KAAK,SAAS;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9D,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,GAC5B,cAAc,CAAC,KAAK,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAUxC"}

package/dist/agent/id.js

@@ -0,0 +1,14 @@
+async function* withPartIds(runId, source) {
+  let n = 0;
+  for await (const part of source) {
+    if (part.id !== void 0) {
+      yield part;
+      continue;
+    }
+    yield { ...part, id: `${runId}#${n}` };
+    n += 1;
+  }
+}
+export {
+  withPartIds
+};

package/dist/agent/index.d.ts

@@ -30,10 +30,15 @@
  *   )
  * }
  */
-export type { AgentPart, StartPart, TextPart, ReasoningPart, ToolCallPart, SourcePart, ErrorPart, } from './parts.js';
-export { parseAgentPart, isStartPart } from './parts.js';
-export type { AgentTransport } from './transport.js';
-export { edenTransport } from './transport.js';
+export type { AgentPart, AgentPartDraft, Drafted, StartPart, TextPart, ReasoningPart, ToolCallPart, ToolCallState, SourcePart, ErrorPart, } from './parts.js';
+export { parseAgentPart, isStartPart, isToolCallSettled, TERMINAL_TOOL_STATES } from './parts.js';
+export { mergePart } from './merge.js';
+export { withPartIds } from './id.js';
+export { coalesceParts } from './coalesce.js';
+export { definePartRenderers, narrowAgentPart } from './foreign.js';
+export type { ForeignPart, TranscriptPart, ConsumerPart, PartRenderers, PartRenderContext, PartRenderer, } from './foreign.js';
+export type { AgentTransport, ResumableAgentTransport } from './transport.js';
+export { edenTransport, isResumable } from './transport.js';
 export { aiSdkTransport } from './ai-sdk-transport.js';
 export type { AiSdkTransport, AiSdkTransportOptions } from './ai-sdk-transport.js';
 export { useAgentStream } from './use-agent-stream.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,YAAY,EACV,SAAS,EACT,SAAS,EACT,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,UAAU,EACV,SAAS,GACV,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAGrD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAG3C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAG5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,yBAAyB,CAAA;AAGhC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAGpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAGjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAClD,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA;AAGvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC7C,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAG5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5C,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,YAAY,EACV,SAAS,EACT,cAAc,EACd,OAAO,EACP,SAAS,EACT,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAU,EACV,SAAS,GACV,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAG9F,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAGnC,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAA;AAGlC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG1C,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAChE,YAAY,EACV,WAAW,EACX,cAAc,EACd,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,WAAW,CAAA;AAGlB,YAAY,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAC1E,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAGxD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAG5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,yBAAyB,CAAA;AAGhC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAGpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAGjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAClD,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA;AAGvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC7C,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAG5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5C,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA"}

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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"}