@assistant-ui/core 0.2.19 → 0.2.21

package/dist/types/error.js

@@ -0,0 +1,46 @@
+//#region src/types/error.ts
+const ERROR_SEVERITIES = [
+	"critical",
+	"warning",
+	"info"
+];
+const ERROR_DISPLAYS = [
+	"inline",
+	"toast",
+	"silent",
+	"dev-only"
+];
+const isAssistantError = (value) => {
+	if (typeof value !== "object" || value === null) return false;
+	const candidate = value;
+	if (typeof candidate.code !== "string" || typeof candidate.message !== "string") return false;
+	if ("severity" in candidate && candidate.severity !== void 0 && (typeof candidate.severity !== "string" || !ERROR_SEVERITIES.includes(candidate.severity))) return false;
+	if ("display" in candidate && candidate.display !== void 0 && (typeof candidate.display !== "string" || !ERROR_DISPLAYS.includes(candidate.display))) return false;
+	return true;
+};
+const toAssistantError = (error) => {
+	if (isAssistantError(error)) return error;
+	if (error instanceof Error) return {
+		code: "unknown",
+		message: error.message
+	};
+	if (typeof error === "string") return {
+		code: "unknown",
+		message: error
+	};
+	try {
+		return {
+			code: "unknown",
+			message: `[${typeof error}] ${String(error)}`
+		};
+	} catch {
+		return {
+			code: "unknown",
+			message: `[${typeof error}]`
+		};
+	}
+};
+//#endregion
+export { isAssistantError, toAssistantError };
+
+//# sourceMappingURL=error.js.map

package/dist/types/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","names":["ErrorSeverity","ErrorDisplay","AssistantErrorCode","AssistantError","code","message","severity","display","ERROR_SEVERITIES","ERROR_DISPLAYS","isAssistantError","value","candidate","Record","undefined","includes","toAssistantError","error","Error","String"],"sources":["../../src/types/error.ts"],"sourcesContent":["export type ErrorSeverity = \"critical\" | \"warning\" | \"info\";\n\nexport type ErrorDisplay = \"inline\" | \"toast\" | \"silent\" | \"dev-only\";\n\nexport type AssistantErrorCode =\n  | \"unknown\"\n  | \"network\"\n  | \"provider\"\n  | (string & {});\n\nexport type AssistantError = {\n  readonly code: AssistantErrorCode;\n  readonly message: string;\n  readonly severity?: ErrorSeverity;\n  readonly display?: ErrorDisplay;\n};\n\nconst ERROR_SEVERITIES: readonly string[] = [\"critical\", \"warning\", \"info\"];\n\nconst ERROR_DISPLAYS: readonly string[] = [\n  \"inline\",\n  \"toast\",\n  \"silent\",\n  \"dev-only\",\n];\n\nexport const isAssistantError = (value: unknown): value is AssistantError => {\n  if (typeof value !== \"object\" || value === null) return false;\n  const candidate = value as Record<string, unknown>;\n  if (\n    typeof candidate.code !== \"string\" ||\n    typeof candidate.message !== \"string\"\n  ) {\n    return false;\n  }\n  if (\n    \"severity\" in candidate &&\n    candidate.severity !== undefined &&\n    (typeof candidate.severity !== \"string\" ||\n      !ERROR_SEVERITIES.includes(candidate.severity))\n  ) {\n    return false;\n  }\n  if (\n    \"display\" in candidate &&\n    candidate.display !== undefined &&\n    (typeof candidate.display !== \"string\" ||\n      !ERROR_DISPLAYS.includes(candidate.display))\n  ) {\n    return false;\n  }\n  return true;\n};\n\nexport const toAssistantError = (error: unknown): AssistantError => {\n  if (isAssistantError(error)) return error;\n  if (error instanceof Error) {\n    return { code: \"unknown\", message: error.message };\n  }\n  if (typeof error === \"string\") {\n    return { code: \"unknown\", message: error };\n  }\n  try {\n    return {\n      code: \"unknown\",\n      message: `[${typeof error}] ${String(error)}`,\n    };\n  } catch {\n    return {\n      code: \"unknown\",\n      message: `[${typeof error}]`,\n    };\n  }\n};\n"],"mappings":";AAiBA,MAAMQ,mBAAsC;CAAC;CAAY;CAAW;AAAM;AAE1E,MAAMC,iBAAoC;CACxC;CACA;CACA;CACA;AAAU;AAGZ,MAAaC,oBAAoBC,UAA4C;CAC3E,IAAI,OAAOA,UAAU,YAAYA,UAAU,MAAM,OAAO;CACxD,MAAMC,YAAYD;CAClB,IACE,OAAOC,UAAUR,SAAS,YAC1B,OAAOQ,UAAUP,YAAY,UAE7B,OAAO;CAET,IACE,cAAcO,aACdA,UAAUN,aAAaQ,KAAAA,MACtB,OAAOF,UAAUN,aAAa,YAC7B,CAACE,iBAAiBO,SAASH,UAAUN,QAAQ,IAE/C,OAAO;CAET,IACE,aAAaM,aACbA,UAAUL,YAAYO,KAAAA,MACrB,OAAOF,UAAUL,YAAY,YAC5B,CAACE,eAAeM,SAASH,UAAUL,OAAO,IAE5C,OAAO;CAET,OAAO;AACT;AAEA,MAAaS,oBAAoBC,UAAmC;CAClE,IAAIP,iBAAiBO,KAAK,GAAG,OAAOA;CACpC,IAAIA,iBAAiBC,OACnB,OAAO;EAAEd,MAAM;EAAWC,SAASY,MAAMZ;CAAQ;CAEnD,IAAI,OAAOY,UAAU,UACnB,OAAO;EAAEb,MAAM;EAAWC,SAASY;CAAM;CAE3C,IAAI;EACF,OAAO;GACLb,MAAM;GACNC,SAAS,IAAI,OAAOY,MAAK,IAAKE,OAAOF,KAAK;EAC5C;CACF,QAAQ;EACN,OAAO;GACLb,MAAM;GACNC,SAAS,IAAI,OAAOY,MAAK;EAC3B;CACF;AACF"}

package/dist/types/index.d.ts

@@ -1,7 +1,7 @@
-import { AppendMessage, DataMessagePart, FileMessagePart, GenerativeUIMessagePart, GenerativeUINode, GenerativeUISpec, ImageMessagePart, MessagePartStatus, MessageRole, MessageStatus, MessageTiming, ReasoningMessagePart, RunConfig, SourceMessagePart, SourceProviderMetadata, TextMessagePart, ThreadAssistantMessage, ThreadAssistantMessagePart, ThreadMessage, ThreadStep, ThreadSystemMessage, ThreadUserMessage, ThreadUserMessagePart, ToolCallMessagePart, ToolCallMessagePartStatus, ToolModelContentPart, Unstable_AudioMessagePart } from "./message.js";
+import { AppendMessage, DataMessagePart, FileMessagePart, GenerativeUIMessagePart, GenerativeUINode, GenerativeUISpec, ImageMessagePart, MessagePartStatus, MessageRole, MessageStatus, MessageTiming, PartProviderMetadata, ReasoningMessagePart, RunConfig, SourceMessagePart, SourceProviderMetadata, TextMessagePart, ThreadAssistantMessage, ThreadAssistantMessagePart, ThreadMessage, ThreadStep, ThreadSystemMessage, ThreadUserMessage, ThreadUserMessagePart, ToolCallMessagePart, ToolCallMessagePartStatus, ToolModelContentPart, Unstable_AudioMessagePart } from "./message.js";
 import { Attachment, AttachmentStatus, CompleteAttachment, CreateAttachment, PendingAttachment } from "./attachment.js";
 import { Unstable_TriggerCategory, Unstable_TriggerItem } from "./trigger.js";
 import { Unstable_DirectiveFormatter, Unstable_DirectiveSegment } from "./directive.js";
 import { Unsubscribe } from "./unsubscribe.js";
 import { QuoteInfo } from "./quote.js";
-export type { AppendMessage, Attachment, AttachmentStatus, CompleteAttachment, CreateAttachment, DataMessagePart, FileMessagePart, GenerativeUIMessagePart, GenerativeUINode, GenerativeUISpec, ImageMessagePart, MessagePartStatus, MessageRole, MessageStatus, MessageTiming, PendingAttachment, QuoteInfo, ReasoningMessagePart, RunConfig, SourceMessagePart, SourceProviderMetadata, TextMessagePart, ThreadAssistantMessage, ThreadAssistantMessagePart, ThreadMessage, ThreadStep, ThreadSystemMessage, ThreadUserMessage, ThreadUserMessagePart, ToolCallMessagePart, ToolCallMessagePartStatus, ToolModelContentPart, Unstable_AudioMessagePart, Unstable_DirectiveFormatter, Unstable_DirectiveSegment, Unstable_TriggerCategory, Unstable_TriggerItem, Unsubscribe };
+export type { AppendMessage, Attachment, AttachmentStatus, CompleteAttachment, CreateAttachment, DataMessagePart, FileMessagePart, GenerativeUIMessagePart, GenerativeUINode, GenerativeUISpec, ImageMessagePart, MessagePartStatus, MessageRole, MessageStatus, MessageTiming, PartProviderMetadata, PendingAttachment, QuoteInfo, ReasoningMessagePart, RunConfig, SourceMessagePart, SourceProviderMetadata, TextMessagePart, ThreadAssistantMessage, ThreadAssistantMessagePart, ThreadMessage, ThreadStep, ThreadSystemMessage, ThreadUserMessage, ThreadUserMessagePart, ToolCallMessagePart, ToolCallMessagePartStatus, ToolModelContentPart, Unstable_AudioMessagePart, Unstable_DirectiveFormatter, Unstable_DirectiveSegment, Unstable_TriggerCategory, Unstable_TriggerItem, Unsubscribe };

package/dist/types/message.d.ts

@@ -1,21 +1,23 @@
 import { CompleteAttachment } from "./attachment.js";
 import { ToolCallTiming, ToolModelContentPart } from "assistant-stream";
 import { ReadonlyJSONObject, ReadonlyJSONValue } from "assistant-stream/utils";
-
 //#region src/types/message.d.ts
+type PartProviderMetadata = {
+  readonly [providerName: string]: ReadonlyJSONObject;
+};
 type TextMessagePart = {
   readonly type: "text";
   readonly text: string;
+  readonly providerMetadata?: PartProviderMetadata;
   readonly parentId?: string;
 };
 type ReasoningMessagePart = {
   readonly type: "reasoning";
   readonly text: string;
+  readonly providerMetadata?: PartProviderMetadata;
   readonly parentId?: string;
 };
-type SourceProviderMetadata = {
-  readonly [providerName: string]: ReadonlyJSONObject;
-};
+type SourceProviderMetadata = PartProviderMetadata;
 type SourceMessagePart = {
   readonly type: "source";
   readonly sourceType: "url";
@@ -69,16 +71,21 @@ type DataMessagePart<T = any> = {
  * default same-realm rendering path.
  */
 type GenerativeUINode = string | {
-  /** Allowlisted component name (resolved against the consumer registry). */readonly component: string; /** Props passed to the resolved component (must be JSON-serializable). */
-  readonly props?: Record<string, unknown>; /** Optional children — strings render as text, objects recurse. */
-  readonly children?: readonly GenerativeUINode[]; /** Optional stable key for React reconciliation. */
+  /** Allowlisted component name (resolved against the consumer registry). */
+  readonly component: string;
+  /** Props passed to the resolved component (must be JSON-serializable). */
+  readonly props?: Record<string, unknown>;
+  /** Optional children — strings render as text, objects recurse. */
+  readonly children?: readonly GenerativeUINode[];
+  /** Optional stable key for React reconciliation. */
   readonly key?: string;
 };
 /**
  * The root spec for a generative UI tree.
  */
 type GenerativeUISpec = {
-  /** Root node(s) to render. */readonly root: GenerativeUINode | readonly GenerativeUINode[];
+  /** Root node(s) to render. */
+  readonly root: GenerativeUINode | readonly GenerativeUINode[];
 };
 /**
  * A message part that carries a JSON spec describing UI to render.
@@ -89,8 +96,10 @@ type GenerativeUISpec = {
  * friendly: a partially-streamed spec renders progressively.
  */
 type GenerativeUIMessagePart = {
-  readonly type: "generative-ui"; /** The JSON spec describing the UI tree. */
-  readonly spec: GenerativeUISpec; /** Optional id (useful for replays / stable keys). */
+  readonly type: "generative-ui";
+  /** The JSON spec describing the UI tree. */
+  readonly spec: GenerativeUISpec;
+  /** Optional id (useful for replays / stable keys). */
   readonly id?: string;
   readonly parentId?: string;
 };
@@ -98,6 +107,8 @@ type McpAppMetadata = {
   readonly resourceUri: string;
   readonly mimeType?: string;
   readonly visibility?: readonly ("model" | "app")[];
+  /** Routable server identity emitted by the agent stack when multiple MCP servers back one agent; for @ag-ui/mcp-apps-middleware this is the configured serverId, falling back to its serverHash. */
+  readonly serverId?: string;
 };
 declare const MCP_APP_URI_SCHEME = "ui://";
 declare const isMcpAppUri: (uri: string | undefined) => boolean;
@@ -106,17 +117,21 @@ type ToolCallMessagePartMcpMetadata = {
 };
 type ToolApprovalOptionKind = "allow-once" | "allow-always" | "reject-once" | "reject-always";
 type ToolApprovalOption = {
-  /** Opaque, host-defined identifier. Scope semantics (session vs project vs global) belong to the option supplier. */readonly id: string;
+  /** Opaque, host-defined identifier. Scope semantics (session vs project vs global) belong to the option supplier. */
+  readonly id: string;
   /**
    * Decision class. Drives approved-resolution and default rendering.
    * Open union: `_`-prefixed custom kinds are never auto-resolved and the
    * default kit skips them; they must be answered with an explicit
    * `approved` value (optionally alongside the `optionId`).
    */
-  readonly kind: ToolApprovalOptionKind | (string & {}); /** Human label. Renderers supply defaults per kind when omitted. */
+  readonly kind: ToolApprovalOptionKind | (string & {});
+  /** Human label. Renderers supply defaults per kind when omitted. */
   readonly label?: string;
-  readonly description?: string; /** Patterns or rules this option would persist, shown before the user commits. Supplied by the host; never derived by the library. */
-  readonly grants?: readonly string[]; /** Opt-in confirmation step before this option resolves. */
+  readonly description?: string;
+  /** Patterns or rules this option would persist, shown before the user commits. Supplied by the host; never derived by the library. */
+  readonly grants?: readonly string[];
+  /** Opt-in confirmation step before this option resolves. */
   readonly confirm?: boolean | {
     title?: string;
     description?: string;
@@ -134,35 +149,53 @@ type ToolApprovalResponse = {
   readonly reason?: string;
 };
 type ToolCallMessagePart<TArgs = ReadonlyJSONObject, TResult = unknown> = {
-  /** Identifies this part as a tool call. */readonly type: "tool-call"; /** Stable identifier for this invocation of the tool. */
-  readonly toolCallId: string; /** Name of the tool requested by the model. */
+  /** Identifies this part as a tool call. */
+  readonly type: "tool-call";
+  /** Stable identifier for this invocation of the tool. */
+  readonly toolCallId: string;
+  /** Name of the tool requested by the model. */
   readonly toolName: string;
   /**
    * Arguments supplied by the model. During streaming this is a partial parse:
    * fields may be missing or incomplete. From a tool-call renderer, use
    * `useToolArgsStatus` to detect which fields are still arriving.
    */
-  readonly args: TArgs; /** Result returned by the tool, if it has completed. */
-  readonly result?: TResult | undefined; /** Whether the result represents a tool execution error. */
-  readonly isError?: boolean | undefined; /** Raw JSON argument text streamed by the model. */
-  readonly argsText: string; /** UI-only artifact associated with the tool result. */
-  readonly artifact?: unknown; /** Wall-clock timing for this call, when the runtime or host tracks it. */
-  readonly timing?: ToolCallTiming; /** MCP app metadata associated with this tool call, when present. */
-  readonly mcp?: ToolCallMessagePartMcpMetadata; /** Content returned to the model for this tool result. */
-  readonly modelContent?: readonly ToolModelContentPart[] | undefined; /** Human-input request that must be resolved before the run can continue. */
+  readonly args: TArgs;
+  /** Result returned by the tool, if it has completed. */
+  readonly result?: TResult | undefined;
+  /** Whether the result represents a tool execution error. */
+  readonly isError?: boolean | undefined;
+  /** Raw JSON argument text streamed by the model. */
+  readonly argsText: string;
+  /** UI-only artifact associated with the tool result. */
+  readonly artifact?: unknown;
+  /** Wall-clock timing for this call, when the runtime or host tracks it. */
+  readonly timing?: ToolCallTiming;
+  /** MCP app metadata associated with this tool call, when present. */
+  readonly mcp?: ToolCallMessagePartMcpMetadata;
+  /** Provider metadata associated with this tool call, when present. */
+  readonly providerMetadata?: PartProviderMetadata;
+  /** Content returned to the model for this tool result. */
+  readonly modelContent?: readonly ToolModelContentPart[] | undefined;
+  /** Human-input request that must be resolved before the run can continue. */
   readonly interrupt?: {
     type: "human";
     payload: unknown;
-  }; /** Server-side approval gate. `respondToApproval` may only be called while `approved` is undefined and no `resolution` is recorded. */
+  };
+  /** Server-side approval gate. `respondToApproval` may only be called while `approved` is undefined and no `resolution` is recorded. */
   readonly approval?: {
     readonly id: string;
     readonly approved?: boolean;
     readonly reason?: string;
-    readonly isAutomatic?: boolean; /** Available decisions for this call. Absent: a plain allow / deny pair. */
-    readonly options?: readonly ToolApprovalOption[]; /** The option chosen at resolution, when options were present. */
-    readonly optionId?: string; /** Terminal non-decision state: the request was cancelled or expired without a user decision. Set by the host. */
+    readonly isAutomatic?: boolean;
+    /** Available decisions for this call. Absent: a plain allow / deny pair. */
+    readonly options?: readonly ToolApprovalOption[];
+    /** The option chosen at resolution, when options were present. */
+    readonly optionId?: string;
+    /** Terminal non-decision state: the request was cancelled or expired without a user decision. Set by the host. */
     readonly resolution?: "cancelled" | "expired";
-  }; /** Parent message-part ID when this part belongs to a nested structure. */
+  };
+  /** Parent message-part ID when this part belongs to a nested structure. */
   readonly parentId?: string;
   /**
    * Nested thread messages produced by this tool call, for example a sub-agent
@@ -182,7 +215,9 @@ type MessagePartStatus = {
   readonly error?: unknown;
 };
 type ToolCallMessagePartStatus = {
-  /** The tool call is waiting for UI or human input before continuing. */readonly type: "requires-action"; /** Reason the tool call requires action. */
+  /** The tool call is waiting for UI or human input before continuing. */
+  readonly type: "requires-action";
+  /** Reason the tool call requires action. */
   readonly reason: "interrupt";
 } | MessagePartStatus;
 type MessageStatus = {
@@ -288,12 +323,14 @@ type RunConfig = {
   readonly custom?: Record<string, unknown>;
 };
 type AppendMessage = Omit<ThreadMessage, "id"> & {
-  parentId: string | null; /** The ID of the message that was edited or undefined. */
+  parentId: string | null;
+  /** The ID of the message that was edited or undefined. */
   sourceId: string | null;
   runConfig: RunConfig | undefined;
-  startRun?: boolean | undefined; /** Process this message next; only meaningful for queue-capable runtimes. */
+  startRun?: boolean | undefined;
+  /** Process this message next; only meaningful for queue-capable runtimes. */
   steer?: boolean | undefined;
 };
 //#endregion
-export { AppendMessage, DataMessagePart, FileMessagePart, GenerativeUIMessagePart, GenerativeUINode, GenerativeUISpec, ImageMessagePart, MCP_APP_URI_SCHEME, McpAppMetadata, MessagePartStatus, MessageRole, MessageStatus, MessageTiming, ReasoningMessagePart, RunConfig, SourceMessagePart, SourceProviderMetadata, TextMessagePart, ThreadAssistantMessage, ThreadAssistantMessagePart, ThreadMessage, ThreadStep, ThreadSystemMessage, ThreadUserMessage, ThreadUserMessagePart, ToolApprovalOption, ToolApprovalOptionKind, ToolApprovalResponse, ToolCallMessagePart, ToolCallMessagePartMcpMetadata, ToolCallMessagePartStatus, type ToolCallTiming, type ToolModelContentPart, Unstable_AudioMessagePart, isMcpAppUri };
+export { AppendMessage, DataMessagePart, FileMessagePart, GenerativeUIMessagePart, GenerativeUINode, GenerativeUISpec, ImageMessagePart, MCP_APP_URI_SCHEME, McpAppMetadata, MessagePartStatus, MessageRole, MessageStatus, MessageTiming, PartProviderMetadata, ReasoningMessagePart, RunConfig, SourceMessagePart, SourceProviderMetadata, TextMessagePart, ThreadAssistantMessage, ThreadAssistantMessagePart, ThreadMessage, ThreadStep, ThreadSystemMessage, ThreadUserMessage, ThreadUserMessagePart, ToolApprovalOption, ToolApprovalOptionKind, ToolApprovalResponse, ToolCallMessagePart, ToolCallMessagePartMcpMetadata, ToolCallMessagePartStatus, type ToolCallTiming, type ToolModelContentPart, Unstable_AudioMessagePart, isMcpAppUri };
 //# sourceMappingURL=message.d.ts.map

package/dist/types/message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message.d.ts","names":[],"sources":["../../src/types/message.ts"],"mappings":"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"}
+{"version":3,"file":"message.d.ts","names":[],"sources":["../../src/types/message.ts"],"mappings":";;;;KASY;YACA,uBAAuB;;KAGvB;WACD;WACA;WACA,mBAAmB;WACnB;;KAGC;WACD;WACA;WACA,mBAAmB;WACnB;;KAGC,yBAAyB;KAEzB;WAEG;WACA;WACA;WACA;WACA;WACA,mBAAmB;WACnB;;WAGA;WACA;WACA;WACA;WACA;WACA;WACA;WACA,mBAAmB;WACnB;;KAGH;WACD;WACA;WACA;;KAGC;WACD;WACA;WACA;WACA;WACA;;KAGC;WACD;WACA;aACE;aACA;;;KAID,gBAAgB;WACjB;WACA;WACA,MAAM;;;;;;;;;;;KAYL;;WAIG;;WAEA,QAAQ;;WAER,oBAAoB;;WAEpB;;;;;KAMH;;WAED,MAAM,4BAA4B;;;;;;;;;;KAWjC;WACD;;WAEA,MAAM;;WAEN;WACA;;KAGC;WACD;WACA;WACA;;WAEA;;cAGE;cAEA,cAAe;KAGhB;WACD,MAAM;;KAGL;KAMA;;WAED;;;;;;;WAOA,MAAM;;WAEN;WACA;;WAEA;;WAEA;IAAsB;IAAgB;;;KAGrC;WACG;WAA4B;;WAC5B;WAA2B;;WAE3B;WACA;WACA;;KAGH,oBACV,QAAQ,oBACR;;WAGS;;WAEA;;WAEA;;;;;;WAMA,MAAM;;WAEN,SAAS;;WAET;;WAEA;;WAEA;;WAEA,SAAS;;WAET,MAAM;;WAEN,mBAAmB;;WAEnB,wBAAwB;;WAExB;IAAc;IAAe;;;WAE7B;aACE;aACA;aACA;aACA;;aAEA,mBAAmB;;aAEnB;;aAEA;;;WAGF;;;;;WAKA,oBAAoB;;KAGnB,wBACR,kBACA,mBACA,kBACA,kBACA;KAEQ,6BACR,kBACA,uBACA,sBACA,oBACA,kBACA,mBACA,kBACA;KAEQ;WAEG;;WAGA;;WAGA;WACA;WAMA;;KAGH;;WAGG;;WAEA;IAEX;KAEQ;WAEG;;WAGA;WACA;;WAGA;WACA;;WAGA;WACA;WAOA,QAAQ;;KAGX;WACD;WACA;WACA;WACA;WACA;WACA;WACA;;KAGC;WACD;WACA;aAEM;aACA;;;KAKZ;WACM;WACA,WAAW;;KAGV,sBAAsB;WACvB;WACA,mBAAmB;WACnB;aACE;aACA;aACA;aACA;aACA;aACA;aACA,QAAQ;;;KAIT,oBAAoB;WACrB;WACA,kBAAkB;WAClB,sBAAsB;WACtB;aACE;aACA;aACA;aACA;aACA;aACA;aACA,QAAQ;;;KAIT,yBAAyB;WAC1B;WACA,kBAAkB;WAClB,QAAQ;WACR;aACE,gBAAgB;aAChB,+BAA+B;aAC/B,wBAAwB;aACxB,gBAAgB;aAChB;eAA+B;;aAC/B,SAAS;;;;;aAKT;aACA,QAAQ;;;KAIhB;WACM,SAAS;WACT;aACE,iBAAiB;aACjB,gCAAgC;aAChC,yBAAyB;aACzB,iBAAiB;aACjB;eAA+B;;aAC/B,SAAS;aACT;aACA,QAAQ;;WAEV,cAAc;;KAGb,gBAAgB,qBACzB,sBAAsB,oBAAoB;KAEjC,cAAc;KAEd;WACD,SAAS;;KAGR,gBAAgB,KAAK;EAC/B;;EAGA;EACA,WAAW;EACX;;EAEA"}

package/dist/types/message.js.map

@@ -1 +1 @@
-{"version":3,"file":"message.js","names":["ReadonlyJSONObject","ReadonlyJSONValue","ToolCallTiming","ToolModelContentPart","CompleteAttachment","TextMessagePart","type","text","parentId","ReasoningMessagePart","SourceProviderMetadata","providerName","SourceMessagePart","sourceType","id","url","title","providerMetadata","mediaType","filename","ImageMessagePart","image","FileMessagePart","data","mimeType","Unstable_AudioMessagePart","audio","format","DataMessagePart","name","T","GenerativeUINode","component","props","Record","children","key","GenerativeUISpec","root","GenerativeUIMessagePart","spec","McpAppMetadata","resourceUri","visibility","MCP_APP_URI_SCHEME","isMcpAppUri","uri","startsWith","ToolCallMessagePartMcpMetadata","app","ToolApprovalOptionKind","ToolApprovalOption","kind","label","description","grants","confirm","ToolApprovalResponse","approved","reason","optionId","ToolCallMessagePart","toolCallId","toolName","args","TArgs","result","TResult","isError","argsText","artifact","timing","mcp","modelContent","interrupt","payload","approval","isAutomatic","options","resolution","messages","ThreadMessage","ThreadUserMessagePart","ThreadAssistantMessagePart","MessagePartStatus","error","ToolCallMessagePartStatus","MessageStatus","MessageTiming","streamStartTime","firstTokenTime","totalStreamTime","tokenCount","tokensPerSecond","totalChunks","toolCallCount","ThreadStep","messageId","usage","inputTokens","outputTokens","MessageCommonProps","createdAt","Date","ThreadSystemMessage","role","content","metadata","unstable_state","unstable_annotations","unstable_data","steps","submittedFeedback","custom","ThreadUserMessage","attachments","ThreadAssistantMessage","status","isOptimistic","BaseThreadMessage","MessageRole","RunConfig","AppendMessage","Omit","sourceId","runConfig","startRun","steer"],"sources":["../../src/types/message.ts"],"sourcesContent":["import type {\n  ReadonlyJSONObject,\n  ReadonlyJSONValue,\n} from \"assistant-stream/utils\";\nimport type { ToolCallTiming, ToolModelContentPart } from \"assistant-stream\";\nimport type { CompleteAttachment } from \"./attachment\";\n\nexport type { ToolCallTiming, ToolModelContentPart };\n\nexport type TextMessagePart = {\n  readonly type: \"text\";\n  readonly text: string;\n  readonly parentId?: string;\n};\n\nexport type ReasoningMessagePart = {\n  readonly type: \"reasoning\";\n  readonly text: string;\n  readonly parentId?: string;\n};\n\nexport type SourceProviderMetadata = {\n  readonly [providerName: string]: ReadonlyJSONObject;\n};\n\nexport type SourceMessagePart =\n  | {\n      readonly type: \"source\";\n      readonly sourceType: \"url\";\n      readonly id: string;\n      readonly url: string;\n      readonly title?: string;\n      readonly providerMetadata?: SourceProviderMetadata;\n      readonly parentId?: string;\n    }\n  | {\n      readonly type: \"source\";\n      readonly sourceType: \"document\";\n      readonly id: string;\n      readonly url?: undefined;\n      readonly title: string;\n      readonly mediaType: string;\n      readonly filename?: string;\n      readonly providerMetadata?: SourceProviderMetadata;\n      readonly parentId?: string;\n    };\n\nexport type ImageMessagePart = {\n  readonly type: \"image\";\n  readonly image: string;\n  readonly filename?: string;\n};\n\nexport type FileMessagePart = {\n  readonly type: \"file\";\n  readonly filename?: string;\n  readonly data: string;\n  readonly mimeType: string;\n  readonly parentId?: string;\n};\n\nexport type Unstable_AudioMessagePart = {\n  readonly type: \"audio\";\n  readonly audio: {\n    readonly data: string;\n    readonly format: \"mp3\" | \"wav\";\n  };\n};\n\nexport type DataMessagePart<T = any> = {\n  readonly type: \"data\";\n  readonly name: string;\n  readonly data: T;\n};\n\n/**\n * A JSON spec describing a tree of UI components to render.\n *\n * The agent emits a {@link GenerativeUIMessagePart} containing this spec, and\n * the consumer-provided component allowlist is used to resolve `component`\n * names. Any component referenced that is not present in the allowlist is\n * rejected with a typed error — the allowlist is the security boundary in the\n * default same-realm rendering path.\n */\nexport type GenerativeUINode =\n  | string\n  | {\n      /** Allowlisted component name (resolved against the consumer registry). */\n      readonly component: string;\n      /** Props passed to the resolved component (must be JSON-serializable). */\n      readonly props?: Record<string, unknown>;\n      /** Optional children — strings render as text, objects recurse. */\n      readonly children?: readonly GenerativeUINode[];\n      /** Optional stable key for React reconciliation. */\n      readonly key?: string;\n    };\n\n/**\n * The root spec for a generative UI tree.\n */\nexport type GenerativeUISpec = {\n  /** Root node(s) to render. */\n  readonly root: GenerativeUINode | readonly GenerativeUINode[];\n};\n\n/**\n * A message part that carries a JSON spec describing UI to render.\n *\n * Render with `<MessagePrimitive.GenerativeUI components={...} />`. The\n * primitive resolves component names against the consumer-provided allowlist\n * — any unknown name throws a typed error rather than rendering. Stream-\n * friendly: a partially-streamed spec renders progressively.\n */\nexport type GenerativeUIMessagePart = {\n  readonly type: \"generative-ui\";\n  /** The JSON spec describing the UI tree. */\n  readonly spec: GenerativeUISpec;\n  /** Optional id (useful for replays / stable keys). */\n  readonly id?: string;\n  readonly parentId?: string;\n};\n\nexport type McpAppMetadata = {\n  readonly resourceUri: string;\n  readonly mimeType?: string;\n  readonly visibility?: readonly (\"model\" | \"app\")[];\n};\n\nexport const MCP_APP_URI_SCHEME = \"ui://\";\n\nexport const isMcpAppUri = (uri: string | undefined): boolean =>\n  !!uri?.startsWith(MCP_APP_URI_SCHEME);\n\nexport type ToolCallMessagePartMcpMetadata = {\n  readonly app?: McpAppMetadata;\n};\n\nexport type ToolApprovalOptionKind =\n  | \"allow-once\"\n  | \"allow-always\"\n  | \"reject-once\"\n  | \"reject-always\";\n\nexport type ToolApprovalOption = {\n  /** Opaque, host-defined identifier. Scope semantics (session vs project vs global) belong to the option supplier. */\n  readonly id: string;\n  /**\n   * Decision class. Drives approved-resolution and default rendering.\n   * Open union: `_`-prefixed custom kinds are never auto-resolved and the\n   * default kit skips them; they must be answered with an explicit\n   * `approved` value (optionally alongside the `optionId`).\n   */\n  readonly kind: ToolApprovalOptionKind | (string & {});\n  /** Human label. Renderers supply defaults per kind when omitted. */\n  readonly label?: string;\n  readonly description?: string;\n  /** Patterns or rules this option would persist, shown before the user commits. Supplied by the host; never derived by the library. */\n  readonly grants?: readonly string[];\n  /** Opt-in confirmation step before this option resolves. */\n  readonly confirm?: boolean | { title?: string; description?: string };\n};\n\nexport type ToolApprovalResponse =\n  | { readonly approved: boolean; readonly reason?: string }\n  | { readonly optionId: string; readonly reason?: string }\n  | {\n      readonly approved: boolean;\n      readonly optionId: string;\n      readonly reason?: string;\n    };\n\nexport type ToolCallMessagePart<\n  TArgs = ReadonlyJSONObject,\n  TResult = unknown,\n> = {\n  /** Identifies this part as a tool call. */\n  readonly type: \"tool-call\";\n  /** Stable identifier for this invocation of the tool. */\n  readonly toolCallId: string;\n  /** Name of the tool requested by the model. */\n  readonly toolName: string;\n  /**\n   * Arguments supplied by the model. During streaming this is a partial parse:\n   * fields may be missing or incomplete. From a tool-call renderer, use\n   * `useToolArgsStatus` to detect which fields are still arriving.\n   */\n  readonly args: TArgs;\n  /** Result returned by the tool, if it has completed. */\n  readonly result?: TResult | undefined;\n  /** Whether the result represents a tool execution error. */\n  readonly isError?: boolean | undefined;\n  /** Raw JSON argument text streamed by the model. */\n  readonly argsText: string;\n  /** UI-only artifact associated with the tool result. */\n  readonly artifact?: unknown;\n  /** Wall-clock timing for this call, when the runtime or host tracks it. */\n  readonly timing?: ToolCallTiming;\n  /** MCP app metadata associated with this tool call, when present. */\n  readonly mcp?: ToolCallMessagePartMcpMetadata;\n  /** Content returned to the model for this tool result. */\n  readonly modelContent?: readonly ToolModelContentPart[] | undefined;\n  /** Human-input request that must be resolved before the run can continue. */\n  readonly interrupt?: { type: \"human\"; payload: unknown };\n  /** Server-side approval gate. `respondToApproval` may only be called while `approved` is undefined and no `resolution` is recorded. */\n  readonly approval?: {\n    readonly id: string;\n    readonly approved?: boolean;\n    readonly reason?: string;\n    readonly isAutomatic?: boolean;\n    /** Available decisions for this call. Absent: a plain allow / deny pair. */\n    readonly options?: readonly ToolApprovalOption[];\n    /** The option chosen at resolution, when options were present. */\n    readonly optionId?: string;\n    /** Terminal non-decision state: the request was cancelled or expired without a user decision. Set by the host. */\n    readonly resolution?: \"cancelled\" | \"expired\";\n  };\n  /** Parent message-part ID when this part belongs to a nested structure. */\n  readonly parentId?: string;\n  /**\n   * Nested thread messages produced by this tool call, for example a sub-agent\n   * conversation.\n   */\n  readonly messages?: readonly ThreadMessage[];\n};\n\nexport type ThreadUserMessagePart =\n  | TextMessagePart\n  | ImageMessagePart\n  | FileMessagePart\n  | DataMessagePart\n  | Unstable_AudioMessagePart;\n\nexport type ThreadAssistantMessagePart =\n  | TextMessagePart\n  | ReasoningMessagePart\n  | ToolCallMessagePart\n  | SourceMessagePart\n  | FileMessagePart\n  | ImageMessagePart\n  | DataMessagePart\n  | GenerativeUIMessagePart;\n\nexport type MessagePartStatus =\n  | {\n      readonly type: \"running\";\n    }\n  | {\n      readonly type: \"complete\";\n    }\n  | {\n      readonly type: \"incomplete\";\n      readonly reason:\n        | \"cancelled\"\n        | \"length\"\n        | \"content-filter\"\n        | \"other\"\n        | \"error\";\n      readonly error?: unknown;\n    };\n\nexport type ToolCallMessagePartStatus =\n  | {\n      /** The tool call is waiting for UI or human input before continuing. */\n      readonly type: \"requires-action\";\n      /** Reason the tool call requires action. */\n      readonly reason: \"interrupt\";\n    }\n  | MessagePartStatus;\n\nexport type MessageStatus =\n  | {\n      readonly type: \"running\";\n    }\n  | {\n      readonly type: \"requires-action\";\n      readonly reason: \"tool-calls\" | \"interrupt\";\n    }\n  | {\n      readonly type: \"complete\";\n      readonly reason: \"stop\" | \"unknown\";\n    }\n  | {\n      readonly type: \"incomplete\";\n      readonly reason:\n        | \"cancelled\"\n        | \"tool-calls\"\n        | \"length\"\n        | \"content-filter\"\n        | \"other\"\n        | \"error\";\n      readonly error?: ReadonlyJSONValue;\n    };\n\nexport type MessageTiming = {\n  readonly streamStartTime: number;\n  readonly firstTokenTime?: number;\n  readonly totalStreamTime?: number;\n  readonly tokenCount?: number;\n  readonly tokensPerSecond?: number;\n  readonly totalChunks: number;\n  readonly toolCallCount: number;\n};\n\nexport type ThreadStep = {\n  readonly messageId?: string;\n  readonly usage?:\n    | {\n        readonly inputTokens: number;\n        readonly outputTokens: number;\n      }\n    | undefined;\n};\n\ntype MessageCommonProps = {\n  readonly id: string;\n  readonly createdAt: Date;\n};\n\nexport type ThreadSystemMessage = MessageCommonProps & {\n  readonly role: \"system\";\n  readonly content: readonly [TextMessagePart];\n  readonly metadata: {\n    readonly unstable_state?: undefined;\n    readonly unstable_annotations?: undefined;\n    readonly unstable_data?: undefined;\n    readonly steps?: undefined;\n    readonly submittedFeedback?: undefined;\n    readonly timing?: undefined;\n    readonly custom: Record<string, unknown>;\n  };\n};\n\nexport type ThreadUserMessage = MessageCommonProps & {\n  readonly role: \"user\";\n  readonly content: readonly ThreadUserMessagePart[];\n  readonly attachments: readonly CompleteAttachment[];\n  readonly metadata: {\n    readonly unstable_state?: undefined;\n    readonly unstable_annotations?: undefined;\n    readonly unstable_data?: undefined;\n    readonly steps?: undefined;\n    readonly submittedFeedback?: undefined;\n    readonly timing?: undefined;\n    readonly custom: Record<string, unknown>;\n  };\n};\n\nexport type ThreadAssistantMessage = MessageCommonProps & {\n  readonly role: \"assistant\";\n  readonly content: readonly ThreadAssistantMessagePart[];\n  readonly status: MessageStatus;\n  readonly metadata: {\n    readonly unstable_state: ReadonlyJSONValue;\n    readonly unstable_annotations: readonly ReadonlyJSONValue[];\n    readonly unstable_data: readonly ReadonlyJSONValue[];\n    readonly steps: readonly ThreadStep[];\n    readonly submittedFeedback?: { readonly type: \"positive\" | \"negative\" };\n    readonly timing?: MessageTiming;\n    /**\n     * Marks a client-side optimistic placeholder. Such messages are evicted\n     * once off the head branch and are never persisted.\n     */\n    readonly isOptimistic?: boolean;\n    readonly custom: Record<string, unknown>;\n  };\n};\n\ntype BaseThreadMessage = {\n  readonly status?: ThreadAssistantMessage[\"status\"];\n  readonly metadata: {\n    readonly unstable_state?: ReadonlyJSONValue;\n    readonly unstable_annotations?: readonly ReadonlyJSONValue[];\n    readonly unstable_data?: readonly ReadonlyJSONValue[];\n    readonly steps?: readonly ThreadStep[];\n    readonly submittedFeedback?: { readonly type: \"positive\" | \"negative\" };\n    readonly timing?: MessageTiming;\n    readonly isOptimistic?: boolean;\n    readonly custom: Record<string, unknown>;\n  };\n  readonly attachments?: ThreadUserMessage[\"attachments\"];\n};\n\nexport type ThreadMessage = BaseThreadMessage &\n  (ThreadSystemMessage | ThreadUserMessage | ThreadAssistantMessage);\n\nexport type MessageRole = ThreadMessage[\"role\"];\n\nexport type RunConfig = {\n  readonly custom?: Record<string, unknown>;\n};\n\nexport type AppendMessage = Omit<ThreadMessage, \"id\"> & {\n  parentId: string | null;\n\n  /** The ID of the message that was edited or undefined. */\n  sourceId: string | null;\n  runConfig: RunConfig | undefined;\n  startRun?: boolean | undefined;\n  /** Process this message next; only meaningful for queue-capable runtimes. */\n  steer?: boolean | undefined;\n};\n"],"mappings":";AAgIA,MAAa4C,qBAAqB;AAElC,MAAaC,eAAeC,QAC1B,CAAC,CAACA,KAAKC,WAAWH,kBAAkB"}
+{"version":3,"file":"message.js","names":["ReadonlyJSONObject","ReadonlyJSONValue","ToolCallTiming","ToolModelContentPart","CompleteAttachment","PartProviderMetadata","providerName","TextMessagePart","type","text","providerMetadata","parentId","ReasoningMessagePart","SourceProviderMetadata","SourceMessagePart","sourceType","id","url","title","mediaType","filename","ImageMessagePart","image","FileMessagePart","data","mimeType","Unstable_AudioMessagePart","audio","format","DataMessagePart","name","T","GenerativeUINode","component","props","Record","children","key","GenerativeUISpec","root","GenerativeUIMessagePart","spec","McpAppMetadata","resourceUri","visibility","serverId","MCP_APP_URI_SCHEME","isMcpAppUri","uri","startsWith","ToolCallMessagePartMcpMetadata","app","ToolApprovalOptionKind","ToolApprovalOption","kind","label","description","grants","confirm","ToolApprovalResponse","approved","reason","optionId","ToolCallMessagePart","toolCallId","toolName","args","TArgs","result","TResult","isError","argsText","artifact","timing","mcp","modelContent","interrupt","payload","approval","isAutomatic","options","resolution","messages","ThreadMessage","ThreadUserMessagePart","ThreadAssistantMessagePart","MessagePartStatus","error","ToolCallMessagePartStatus","MessageStatus","MessageTiming","streamStartTime","firstTokenTime","totalStreamTime","tokenCount","tokensPerSecond","totalChunks","toolCallCount","ThreadStep","messageId","usage","inputTokens","outputTokens","MessageCommonProps","createdAt","Date","ThreadSystemMessage","role","content","metadata","unstable_state","unstable_annotations","unstable_data","steps","submittedFeedback","custom","ThreadUserMessage","attachments","ThreadAssistantMessage","status","isOptimistic","BaseThreadMessage","MessageRole","RunConfig","AppendMessage","Omit","sourceId","runConfig","startRun","steer"],"sources":["../../src/types/message.ts"],"sourcesContent":["import type {\n  ReadonlyJSONObject,\n  ReadonlyJSONValue,\n} from \"assistant-stream/utils\";\nimport type { ToolCallTiming, ToolModelContentPart } from \"assistant-stream\";\nimport type { CompleteAttachment } from \"./attachment\";\n\nexport type { ToolCallTiming, ToolModelContentPart };\n\nexport type PartProviderMetadata = {\n  readonly [providerName: string]: ReadonlyJSONObject;\n};\n\nexport type TextMessagePart = {\n  readonly type: \"text\";\n  readonly text: string;\n  readonly providerMetadata?: PartProviderMetadata;\n  readonly parentId?: string;\n};\n\nexport type ReasoningMessagePart = {\n  readonly type: \"reasoning\";\n  readonly text: string;\n  readonly providerMetadata?: PartProviderMetadata;\n  readonly parentId?: string;\n};\n\nexport type SourceProviderMetadata = PartProviderMetadata;\n\nexport type SourceMessagePart =\n  | {\n      readonly type: \"source\";\n      readonly sourceType: \"url\";\n      readonly id: string;\n      readonly url: string;\n      readonly title?: string;\n      readonly providerMetadata?: SourceProviderMetadata;\n      readonly parentId?: string;\n    }\n  | {\n      readonly type: \"source\";\n      readonly sourceType: \"document\";\n      readonly id: string;\n      readonly url?: undefined;\n      readonly title: string;\n      readonly mediaType: string;\n      readonly filename?: string;\n      readonly providerMetadata?: SourceProviderMetadata;\n      readonly parentId?: string;\n    };\n\nexport type ImageMessagePart = {\n  readonly type: \"image\";\n  readonly image: string;\n  readonly filename?: string;\n};\n\nexport type FileMessagePart = {\n  readonly type: \"file\";\n  readonly filename?: string;\n  readonly data: string;\n  readonly mimeType: string;\n  readonly parentId?: string;\n};\n\nexport type Unstable_AudioMessagePart = {\n  readonly type: \"audio\";\n  readonly audio: {\n    readonly data: string;\n    readonly format: \"mp3\" | \"wav\";\n  };\n};\n\nexport type DataMessagePart<T = any> = {\n  readonly type: \"data\";\n  readonly name: string;\n  readonly data: T;\n};\n\n/**\n * A JSON spec describing a tree of UI components to render.\n *\n * The agent emits a {@link GenerativeUIMessagePart} containing this spec, and\n * the consumer-provided component allowlist is used to resolve `component`\n * names. Any component referenced that is not present in the allowlist is\n * rejected with a typed error — the allowlist is the security boundary in the\n * default same-realm rendering path.\n */\nexport type GenerativeUINode =\n  | string\n  | {\n      /** Allowlisted component name (resolved against the consumer registry). */\n      readonly component: string;\n      /** Props passed to the resolved component (must be JSON-serializable). */\n      readonly props?: Record<string, unknown>;\n      /** Optional children — strings render as text, objects recurse. */\n      readonly children?: readonly GenerativeUINode[];\n      /** Optional stable key for React reconciliation. */\n      readonly key?: string;\n    };\n\n/**\n * The root spec for a generative UI tree.\n */\nexport type GenerativeUISpec = {\n  /** Root node(s) to render. */\n  readonly root: GenerativeUINode | readonly GenerativeUINode[];\n};\n\n/**\n * A message part that carries a JSON spec describing UI to render.\n *\n * Render with `<MessagePrimitive.GenerativeUI components={...} />`. The\n * primitive resolves component names against the consumer-provided allowlist\n * — any unknown name throws a typed error rather than rendering. Stream-\n * friendly: a partially-streamed spec renders progressively.\n */\nexport type GenerativeUIMessagePart = {\n  readonly type: \"generative-ui\";\n  /** The JSON spec describing the UI tree. */\n  readonly spec: GenerativeUISpec;\n  /** Optional id (useful for replays / stable keys). */\n  readonly id?: string;\n  readonly parentId?: string;\n};\n\nexport type McpAppMetadata = {\n  readonly resourceUri: string;\n  readonly mimeType?: string;\n  readonly visibility?: readonly (\"model\" | \"app\")[];\n  /** Routable server identity emitted by the agent stack when multiple MCP servers back one agent; for @ag-ui/mcp-apps-middleware this is the configured serverId, falling back to its serverHash. */\n  readonly serverId?: string;\n};\n\nexport const MCP_APP_URI_SCHEME = \"ui://\";\n\nexport const isMcpAppUri = (uri: string | undefined): boolean =>\n  !!uri?.startsWith(MCP_APP_URI_SCHEME);\n\nexport type ToolCallMessagePartMcpMetadata = {\n  readonly app?: McpAppMetadata;\n};\n\nexport type ToolApprovalOptionKind =\n  | \"allow-once\"\n  | \"allow-always\"\n  | \"reject-once\"\n  | \"reject-always\";\n\nexport type ToolApprovalOption = {\n  /** Opaque, host-defined identifier. Scope semantics (session vs project vs global) belong to the option supplier. */\n  readonly id: string;\n  /**\n   * Decision class. Drives approved-resolution and default rendering.\n   * Open union: `_`-prefixed custom kinds are never auto-resolved and the\n   * default kit skips them; they must be answered with an explicit\n   * `approved` value (optionally alongside the `optionId`).\n   */\n  readonly kind: ToolApprovalOptionKind | (string & {});\n  /** Human label. Renderers supply defaults per kind when omitted. */\n  readonly label?: string;\n  readonly description?: string;\n  /** Patterns or rules this option would persist, shown before the user commits. Supplied by the host; never derived by the library. */\n  readonly grants?: readonly string[];\n  /** Opt-in confirmation step before this option resolves. */\n  readonly confirm?: boolean | { title?: string; description?: string };\n};\n\nexport type ToolApprovalResponse =\n  | { readonly approved: boolean; readonly reason?: string }\n  | { readonly optionId: string; readonly reason?: string }\n  | {\n      readonly approved: boolean;\n      readonly optionId: string;\n      readonly reason?: string;\n    };\n\nexport type ToolCallMessagePart<\n  TArgs = ReadonlyJSONObject,\n  TResult = unknown,\n> = {\n  /** Identifies this part as a tool call. */\n  readonly type: \"tool-call\";\n  /** Stable identifier for this invocation of the tool. */\n  readonly toolCallId: string;\n  /** Name of the tool requested by the model. */\n  readonly toolName: string;\n  /**\n   * Arguments supplied by the model. During streaming this is a partial parse:\n   * fields may be missing or incomplete. From a tool-call renderer, use\n   * `useToolArgsStatus` to detect which fields are still arriving.\n   */\n  readonly args: TArgs;\n  /** Result returned by the tool, if it has completed. */\n  readonly result?: TResult | undefined;\n  /** Whether the result represents a tool execution error. */\n  readonly isError?: boolean | undefined;\n  /** Raw JSON argument text streamed by the model. */\n  readonly argsText: string;\n  /** UI-only artifact associated with the tool result. */\n  readonly artifact?: unknown;\n  /** Wall-clock timing for this call, when the runtime or host tracks it. */\n  readonly timing?: ToolCallTiming;\n  /** MCP app metadata associated with this tool call, when present. */\n  readonly mcp?: ToolCallMessagePartMcpMetadata;\n  /** Provider metadata associated with this tool call, when present. */\n  readonly providerMetadata?: PartProviderMetadata;\n  /** Content returned to the model for this tool result. */\n  readonly modelContent?: readonly ToolModelContentPart[] | undefined;\n  /** Human-input request that must be resolved before the run can continue. */\n  readonly interrupt?: { type: \"human\"; payload: unknown };\n  /** Server-side approval gate. `respondToApproval` may only be called while `approved` is undefined and no `resolution` is recorded. */\n  readonly approval?: {\n    readonly id: string;\n    readonly approved?: boolean;\n    readonly reason?: string;\n    readonly isAutomatic?: boolean;\n    /** Available decisions for this call. Absent: a plain allow / deny pair. */\n    readonly options?: readonly ToolApprovalOption[];\n    /** The option chosen at resolution, when options were present. */\n    readonly optionId?: string;\n    /** Terminal non-decision state: the request was cancelled or expired without a user decision. Set by the host. */\n    readonly resolution?: \"cancelled\" | \"expired\";\n  };\n  /** Parent message-part ID when this part belongs to a nested structure. */\n  readonly parentId?: string;\n  /**\n   * Nested thread messages produced by this tool call, for example a sub-agent\n   * conversation.\n   */\n  readonly messages?: readonly ThreadMessage[];\n};\n\nexport type ThreadUserMessagePart =\n  | TextMessagePart\n  | ImageMessagePart\n  | FileMessagePart\n  | DataMessagePart\n  | Unstable_AudioMessagePart;\n\nexport type ThreadAssistantMessagePart =\n  | TextMessagePart\n  | ReasoningMessagePart\n  | ToolCallMessagePart\n  | SourceMessagePart\n  | FileMessagePart\n  | ImageMessagePart\n  | DataMessagePart\n  | GenerativeUIMessagePart;\n\nexport type MessagePartStatus =\n  | {\n      readonly type: \"running\";\n    }\n  | {\n      readonly type: \"complete\";\n    }\n  | {\n      readonly type: \"incomplete\";\n      readonly reason:\n        | \"cancelled\"\n        | \"length\"\n        | \"content-filter\"\n        | \"other\"\n        | \"error\";\n      readonly error?: unknown;\n    };\n\nexport type ToolCallMessagePartStatus =\n  | {\n      /** The tool call is waiting for UI or human input before continuing. */\n      readonly type: \"requires-action\";\n      /** Reason the tool call requires action. */\n      readonly reason: \"interrupt\";\n    }\n  | MessagePartStatus;\n\nexport type MessageStatus =\n  | {\n      readonly type: \"running\";\n    }\n  | {\n      readonly type: \"requires-action\";\n      readonly reason: \"tool-calls\" | \"interrupt\";\n    }\n  | {\n      readonly type: \"complete\";\n      readonly reason: \"stop\" | \"unknown\";\n    }\n  | {\n      readonly type: \"incomplete\";\n      readonly reason:\n        | \"cancelled\"\n        | \"tool-calls\"\n        | \"length\"\n        | \"content-filter\"\n        | \"other\"\n        | \"error\";\n      readonly error?: ReadonlyJSONValue;\n    };\n\nexport type MessageTiming = {\n  readonly streamStartTime: number;\n  readonly firstTokenTime?: number;\n  readonly totalStreamTime?: number;\n  readonly tokenCount?: number;\n  readonly tokensPerSecond?: number;\n  readonly totalChunks: number;\n  readonly toolCallCount: number;\n};\n\nexport type ThreadStep = {\n  readonly messageId?: string;\n  readonly usage?:\n    | {\n        readonly inputTokens: number;\n        readonly outputTokens: number;\n      }\n    | undefined;\n};\n\ntype MessageCommonProps = {\n  readonly id: string;\n  readonly createdAt: Date;\n};\n\nexport type ThreadSystemMessage = MessageCommonProps & {\n  readonly role: \"system\";\n  readonly content: readonly [TextMessagePart];\n  readonly metadata: {\n    readonly unstable_state?: undefined;\n    readonly unstable_annotations?: undefined;\n    readonly unstable_data?: undefined;\n    readonly steps?: undefined;\n    readonly submittedFeedback?: undefined;\n    readonly timing?: undefined;\n    readonly custom: Record<string, unknown>;\n  };\n};\n\nexport type ThreadUserMessage = MessageCommonProps & {\n  readonly role: \"user\";\n  readonly content: readonly ThreadUserMessagePart[];\n  readonly attachments: readonly CompleteAttachment[];\n  readonly metadata: {\n    readonly unstable_state?: undefined;\n    readonly unstable_annotations?: undefined;\n    readonly unstable_data?: undefined;\n    readonly steps?: undefined;\n    readonly submittedFeedback?: undefined;\n    readonly timing?: undefined;\n    readonly custom: Record<string, unknown>;\n  };\n};\n\nexport type ThreadAssistantMessage = MessageCommonProps & {\n  readonly role: \"assistant\";\n  readonly content: readonly ThreadAssistantMessagePart[];\n  readonly status: MessageStatus;\n  readonly metadata: {\n    readonly unstable_state: ReadonlyJSONValue;\n    readonly unstable_annotations: readonly ReadonlyJSONValue[];\n    readonly unstable_data: readonly ReadonlyJSONValue[];\n    readonly steps: readonly ThreadStep[];\n    readonly submittedFeedback?: { readonly type: \"positive\" | \"negative\" };\n    readonly timing?: MessageTiming;\n    /**\n     * Marks a client-side optimistic placeholder. Such messages are evicted\n     * once off the head branch and are never persisted.\n     */\n    readonly isOptimistic?: boolean;\n    readonly custom: Record<string, unknown>;\n  };\n};\n\ntype BaseThreadMessage = {\n  readonly status?: ThreadAssistantMessage[\"status\"];\n  readonly metadata: {\n    readonly unstable_state?: ReadonlyJSONValue;\n    readonly unstable_annotations?: readonly ReadonlyJSONValue[];\n    readonly unstable_data?: readonly ReadonlyJSONValue[];\n    readonly steps?: readonly ThreadStep[];\n    readonly submittedFeedback?: { readonly type: \"positive\" | \"negative\" };\n    readonly timing?: MessageTiming;\n    readonly isOptimistic?: boolean;\n    readonly custom: Record<string, unknown>;\n  };\n  readonly attachments?: ThreadUserMessage[\"attachments\"];\n};\n\nexport type ThreadMessage = BaseThreadMessage &\n  (ThreadSystemMessage | ThreadUserMessage | ThreadAssistantMessage);\n\nexport type MessageRole = ThreadMessage[\"role\"];\n\nexport type RunConfig = {\n  readonly custom?: Record<string, unknown>;\n};\n\nexport type AppendMessage = Omit<ThreadMessage, \"id\"> & {\n  parentId: string | null;\n\n  /** The ID of the message that was edited or undefined. */\n  sourceId: string | null;\n  runConfig: RunConfig | undefined;\n  startRun?: boolean | undefined;\n  /** Process this message next; only meaningful for queue-capable runtimes. */\n  steer?: boolean | undefined;\n};\n"],"mappings":";AAsIA,MAAa8C,qBAAqB;AAElC,MAAaC,eAAeC,QAC1B,CAAC,CAACA,KAAKC,WAAWH,kBAAkB"}

package/dist/types/quote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quote.d.ts","names":[],"sources":["../../src/types/quote.ts"],"mappings":";KAAY,SAAA;EAAA,SACD,IAAA;EAAA,SACA,SAAS;AAAA"}
+{"version":3,"file":"quote.d.ts","names":[],"sources":["../../src/types/quote.ts"],"mappings":";KAAY;WACD;WACA"}

package/dist/types/trigger.d.ts

@@ -1,5 +1,4 @@
 import { ReadonlyJSONObject } from "assistant-stream/utils";
-
 //#region src/types/trigger.d.ts
 /** A selectable item displayed inside a trigger popover (e.g. mention, slash command). */
 type Unstable_TriggerItem = {

package/dist/types/trigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trigger.d.ts","names":[],"sources":["../../src/types/trigger.ts"],"mappings":";;;;KAGY,oBAAA;EAAA,SACD,EAAA;EAAA,SACA,IAAA;EAAA,SACA,KAAA;EAAA,SACA,WAAA;EAAA,SACA,QAAA,GAAW,kBAAkB;AAAA;;KAI5B,wBAAA;EAAA,SACD,EAAA;EAAA,SACA,KAAK;AAAA"}
+{"version":3,"file":"trigger.d.ts","names":[],"sources":["../../src/types/trigger.ts"],"mappings":";;;KAGY;WACD;WACA;WACA;WACA;WACA,WAAW;;;KAIV;WACD;WACA"}

package/dist/types/unsubscribe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unsubscribe.d.ts","names":[],"sources":["../../src/types/unsubscribe.ts"],"mappings":";KAAY,WAAA"}
+{"version":3,"file":"unsubscribe.d.ts","names":[],"sources":["../../src/types/unsubscribe.ts"],"mappings":";KAAY"}

package/dist/utils/composite-context-provider.d.ts

@@ -1,4 +1,5 @@
 import { ModelContext, ModelContextProvider } from "../model-context/types.js";
+import "../index.js";
 //#region src/utils/composite-context-provider.d.ts
 declare class CompositeContextProvider implements ModelContextProvider {
   private _providers;

package/dist/utils/composite-context-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composite-context-provider.d.ts","names":[],"sources":["../../src/utils/composite-context-provider.ts"],"mappings":";;cAKa,wBAAA,YAAoC,oBAAA;EAAA,QACvC,UAAA;EAER,eAAA,IAHoC,YAAA;EAOpC,4BAAA,CAA6B,QAAA,EAAU,oBAAA;EAAA,QAa/B,YAAA;EAER,iBAAA;EAIA,SAAA,CAAU,QAAA;AAAA"}
+{"version":3,"file":"composite-context-provider.d.ts","names":[],"sources":["../../src/utils/composite-context-provider.ts"],"mappings":";;;cAKa,oCAAoC;UACvC;EAER,mBAHW;EAOX,6BAA6B,UAAU;UAa/B;EAER;EAIA,UAAU"}

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

@@ -1 +1 @@
-{"version":3,"file":"id.d.ts","names":[],"sources":["../../src/utils/id.ts"],"mappings":";;AAKA;;cAAa,UAAA,GAAU,IAAA;AAAA,cAMV,sBAAA;AAAA,cACA,gBAAA,GAAoB,EAAU"}
+{"version":3,"file":"id.d.ts","names":[],"sources":["../../src/utils/id.ts"],"mappings":";;;;cAKa,aAAU;cAMV;cACA,mBAAoB"}

package/dist/utils/json/is-json-equal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"is-json-equal.d.ts","names":[],"sources":["../../../src/utils/json/is-json-equal.ts"],"mappings":";cA4Ca,gBAAA,GAAoB,CAAA,WAAY,CAAU"}
+{"version":3,"file":"is-json-equal.d.ts","names":[],"sources":["../../../src/utils/json/is-json-equal.ts"],"mappings":";cA4Ca,mBAAoB,YAAY"}

package/dist/utils/json/is-json.d.ts

@@ -1,5 +1,4 @@
 import { ReadonlyJSONArray, ReadonlyJSONObject, ReadonlyJSONValue } from "assistant-stream/utils";
-
 //#region src/utils/json/is-json.d.ts
 declare function isRecord(value: unknown): value is Record<string, unknown>;
 declare function isJSONValue(value: unknown, currentDepth?: number): value is ReadonlyJSONValue;

package/dist/utils/json/is-json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"is-json.d.ts","names":[],"sources":["../../../src/utils/json/is-json.ts"],"mappings":";;;iBAMgB,QAAA,CAAS,KAAA,YAAiB,KAAA,IAAS,MAAM;AAAA,iBAIzC,WAAA,CACd,KAAA,WACA,YAAA,YACC,KAAA,IAAS,iBAAiB;AAAA,iBAiCb,WAAA,CAAY,KAAA,YAAiB,KAAA,IAAS,iBAAiB;AAAA,iBAIvD,YAAA,CAAa,KAAA,YAAiB,KAAA,IAAS,kBAAkB"}
+{"version":3,"file":"is-json.d.ts","names":[],"sources":["../../../src/utils/json/is-json.ts"],"mappings":";;iBAMgB,SAAS,iBAAiB,SAAS;iBAInC,YACd,gBACA,wBACC,SAAS;iBAiCI,YAAY,iBAAiB,SAAS;iBAItC,aAAa,iBAAiB,SAAS"}

package/dist/utils/json/is-json.js

@@ -11,7 +11,7 @@ function isJSONValue(value, currentDepth = 0) {
 	return false;
 }
 function isJSONArray(value) {
-	return Array.isArray(value) && value.every(isJSONValue);
+	return Array.isArray(value) && value.every((item) => isJSONValue(item));
 }
 function isJSONObject(value) {
 	return isRecord(value) && Object.entries(value).every(([key, val]) => typeof key === "string" && isJSONValue(val));

package/dist/utils/json/is-json.js.map

@@ -1 +1 @@
-{"version":3,"file":"is-json.js","names":["ReadonlyJSONArray","ReadonlyJSONObject","ReadonlyJSONValue","isRecord","value","Record","Array","isArray","isJSONValue","currentDepth","Number","isNaN","isFinite","every","item","Object","entries","key","val","isJSONArray","isJSONObject"],"sources":["../../../src/utils/json/is-json.ts"],"sourcesContent":["import type {\n  ReadonlyJSONArray,\n  ReadonlyJSONObject,\n  ReadonlyJSONValue,\n} from \"assistant-stream/utils\";\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return value != null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nexport function isJSONValue(\n  value: unknown,\n  currentDepth: number = 0,\n): value is ReadonlyJSONValue {\n  // Protect against too deep recursion\n  if (currentDepth > 100) {\n    return false;\n  }\n\n  if (\n    value === null ||\n    typeof value === \"string\" ||\n    typeof value === \"boolean\"\n  ) {\n    return true;\n  }\n\n  // Handle special number cases\n  if (typeof value === \"number\") {\n    return !Number.isNaN(value) && Number.isFinite(value);\n  }\n\n  if (Array.isArray(value)) {\n    return value.every((item) => isJSONValue(item, currentDepth + 1));\n  }\n\n  if (isRecord(value)) {\n    return Object.entries(value).every(\n      ([key, val]) =>\n        typeof key === \"string\" && isJSONValue(val, currentDepth + 1),\n    );\n  }\n\n  return false;\n}\n\nexport function isJSONArray(value: unknown): value is ReadonlyJSONArray {\n  return Array.isArray(value) && value.every(isJSONValue);\n}\n\nexport function isJSONObject(value: unknown): value is ReadonlyJSONObject {\n  return (\n    isRecord(value) &&\n    Object.entries(value).every(\n      ([key, val]) => typeof key === \"string\" && isJSONValue(val),\n    )\n  );\n}\n"],"mappings":";AAMA,SAAgBG,SAASC,OAAkD;CACzE,OAAOA,SAAS,QAAQ,OAAOA,UAAU,YAAY,CAACE,MAAMC,QAAQH,KAAK;AAC3E;AAEA,SAAgBI,YACdJ,OACAK,eAAuB,GACK;CAE5B,IAAIA,eAAe,KACjB,OAAO;CAGT,IACEL,UAAU,QACV,OAAOA,UAAU,YACjB,OAAOA,UAAU,WAEjB,OAAO;CAIT,IAAI,OAAOA,UAAU,UACnB,OAAO,CAACM,OAAOC,MAAMP,KAAK,KAAKM,OAAOE,SAASR,KAAK;CAGtD,IAAIE,MAAMC,QAAQH,KAAK,GACrB,OAAOA,MAAMS,OAAOC,SAASN,YAAYM,MAAML,eAAe,CAAC,CAAC;CAGlE,IAAIN,SAASC,KAAK,GAChB,OAAOW,OAAOC,QAAQZ,KAAK,CAAC,CAACS,OAC1B,CAACI,KAAKC,SACL,OAAOD,QAAQ,YAAYT,YAAYU,KAAKT,eAAe,CAAC,CAChE;CAGF,OAAO;AACT;AAEA,SAAgBU,YAAYf,OAA4C;CACtE,OAAOE,MAAMC,QAAQH,KAAK,KAAKA,MAAMS,MAAML,WAAW;AACxD;AAEA,SAAgBY,aAAahB,OAA6C;CACxE,OACED,SAASC,KAAK,KACdW,OAAOC,QAAQZ,KAAK,CAAC,CAACS,OACnB,CAACI,KAAKC,SAAS,OAAOD,QAAQ,YAAYT,YAAYU,GAAG,CAC5D;AAEJ"}
+{"version":3,"file":"is-json.js","names":["ReadonlyJSONArray","ReadonlyJSONObject","ReadonlyJSONValue","isRecord","value","Record","Array","isArray","isJSONValue","currentDepth","Number","isNaN","isFinite","every","item","Object","entries","key","val","isJSONArray","isJSONObject"],"sources":["../../../src/utils/json/is-json.ts"],"sourcesContent":["import type {\n  ReadonlyJSONArray,\n  ReadonlyJSONObject,\n  ReadonlyJSONValue,\n} from \"assistant-stream/utils\";\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return value != null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nexport function isJSONValue(\n  value: unknown,\n  currentDepth: number = 0,\n): value is ReadonlyJSONValue {\n  // Protect against too deep recursion\n  if (currentDepth > 100) {\n    return false;\n  }\n\n  if (\n    value === null ||\n    typeof value === \"string\" ||\n    typeof value === \"boolean\"\n  ) {\n    return true;\n  }\n\n  // Handle special number cases\n  if (typeof value === \"number\") {\n    return !Number.isNaN(value) && Number.isFinite(value);\n  }\n\n  if (Array.isArray(value)) {\n    return value.every((item) => isJSONValue(item, currentDepth + 1));\n  }\n\n  if (isRecord(value)) {\n    return Object.entries(value).every(\n      ([key, val]) =>\n        typeof key === \"string\" && isJSONValue(val, currentDepth + 1),\n    );\n  }\n\n  return false;\n}\n\nexport function isJSONArray(value: unknown): value is ReadonlyJSONArray {\n  return Array.isArray(value) && value.every((item) => isJSONValue(item));\n}\n\nexport function isJSONObject(value: unknown): value is ReadonlyJSONObject {\n  return (\n    isRecord(value) &&\n    Object.entries(value).every(\n      ([key, val]) => typeof key === \"string\" && isJSONValue(val),\n    )\n  );\n}\n"],"mappings":";AAMA,SAAgBG,SAASC,OAAkD;CACzE,OAAOA,SAAS,QAAQ,OAAOA,UAAU,YAAY,CAACE,MAAMC,QAAQH,KAAK;AAC3E;AAEA,SAAgBI,YACdJ,OACAK,eAAuB,GACK;CAE5B,IAAIA,eAAe,KACjB,OAAO;CAGT,IACEL,UAAU,QACV,OAAOA,UAAU,YACjB,OAAOA,UAAU,WAEjB,OAAO;CAIT,IAAI,OAAOA,UAAU,UACnB,OAAO,CAACM,OAAOC,MAAMP,KAAK,KAAKM,OAAOE,SAASR,KAAK;CAGtD,IAAIE,MAAMC,QAAQH,KAAK,GACrB,OAAOA,MAAMS,OAAOC,SAASN,YAAYM,MAAML,eAAe,CAAC,CAAC;CAGlE,IAAIN,SAASC,KAAK,GAChB,OAAOW,OAAOC,QAAQZ,KAAK,CAAC,CAACS,OAC1B,CAACI,KAAKC,SACL,OAAOD,QAAQ,YAAYT,YAAYU,KAAKT,eAAe,CAAC,CAChE;CAGF,OAAO;AACT;AAEA,SAAgBU,YAAYf,OAA4C;CACtE,OAAOE,MAAMC,QAAQH,KAAK,KAAKA,MAAMS,OAAOC,SAASN,YAAYM,IAAI,CAAC;AACxE;AAEA,SAAgBM,aAAahB,OAA6C;CACxE,OACED,SAASC,KAAK,KACdW,OAAOC,QAAQZ,KAAK,CAAC,CAACS,OACnB,CAACI,KAAKC,SAAS,OAAOD,QAAQ,YAAYT,YAAYU,GAAG,CAC5D;AAEJ"}

package/dist/utils/json/stable-stringify-tool-args.d.ts

@@ -0,0 +1,7 @@
+import { ReadonlyJSONObject } from "assistant-stream/utils";
+//#region src/utils/json/stable-stringify-tool-args.d.ts
+declare const trackToolArgsKeyOrder: (keyOrderCache: Map<string, Map<string, string[]>> | undefined, cacheKey: string, args: ReadonlyJSONObject) => void;
+declare const stableStringifyToolArgs: (keyOrderCache: Map<string, Map<string, string[]>> | undefined, cacheKey: string, args: ReadonlyJSONObject) => string;
+//#endregion
+export { stableStringifyToolArgs, trackToolArgsKeyOrder };
+//# sourceMappingURL=stable-stringify-tool-args.d.ts.map

package/dist/utils/json/stable-stringify-tool-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-stringify-tool-args.d.ts","names":[],"sources":["../../../src/utils/json/stable-stringify-tool-args.ts"],"mappings":";;cAgDa,wBACX,eAAe,YAAY,oCAC3B,kBACA,MAAM;cAMK,0BACX,eAAe,YAAY,oCAC3B,kBACA,MAAM"}

package/dist/utils/json/stable-stringify-tool-args.js

@@ -0,0 +1,32 @@
+//#region src/utils/json/stable-stringify-tool-args.ts
+const stabilizeToolArgsValue = (value, path, keyOrderByPath) => {
+	if (Array.isArray(value)) return value.map((item, idx) => stabilizeToolArgsValue(item, `${path}[${idx}]`, keyOrderByPath));
+	if (value && typeof value === "object") {
+		const record = value;
+		const currentKeys = Object.keys(record);
+		const previousOrder = keyOrderByPath.get(path) ?? [];
+		const previousOrderSet = new Set(previousOrder);
+		const nextOrder = [...previousOrder.filter((key) => Object.hasOwn(record, key)), ...currentKeys.filter((key) => !previousOrderSet.has(key))];
+		keyOrderByPath.set(path, nextOrder);
+		return Object.fromEntries(nextOrder.map((key) => [key, stabilizeToolArgsValue(record[key], `${path}.${JSON.stringify(key)}`, keyOrderByPath)]));
+	}
+	return value;
+};
+const getToolArgsKeyOrder = (keyOrderCache, cacheKey) => {
+	const keyOrderByPath = keyOrderCache?.get(cacheKey) ?? /* @__PURE__ */ new Map();
+	keyOrderCache?.set(cacheKey, keyOrderByPath);
+	return keyOrderByPath;
+};
+const trackToolArgsKeyOrder = (keyOrderCache, cacheKey, args) => {
+	const keyOrderByPath = getToolArgsKeyOrder(keyOrderCache, cacheKey);
+	stabilizeToolArgsValue(args, "$", keyOrderByPath);
+};
+const stableStringifyToolArgs = (keyOrderCache, cacheKey, args) => {
+	const keyOrderByPath = getToolArgsKeyOrder(keyOrderCache, cacheKey);
+	const stableArgs = stabilizeToolArgsValue(args, "$", keyOrderByPath);
+	return JSON.stringify(stableArgs);
+};
+//#endregion
+export { stableStringifyToolArgs, trackToolArgsKeyOrder };
+
+//# sourceMappingURL=stable-stringify-tool-args.js.map

package/dist/utils/json/stable-stringify-tool-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-stringify-tool-args.js","names":["ReadonlyJSONObject","stabilizeToolArgsValue","value","path","keyOrderByPath","Map","Array","isArray","map","item","idx","record","Record","currentKeys","Object","keys","previousOrder","get","previousOrderSet","Set","nextOrder","filter","key","hasOwn","has","set","fromEntries","JSON","stringify","getToolArgsKeyOrder","keyOrderCache","cacheKey","trackToolArgsKeyOrder","args","stableStringifyToolArgs","stableArgs"],"sources":["../../../src/utils/json/stable-stringify-tool-args.ts"],"sourcesContent":["import type { ReadonlyJSONObject } from \"assistant-stream/utils\";\n\nconst stabilizeToolArgsValue = (\n  value: unknown,\n  path: string,\n  keyOrderByPath: Map<string, string[]>,\n): unknown => {\n  if (Array.isArray(value)) {\n    return value.map((item, idx) =>\n      stabilizeToolArgsValue(item, `${path}[${idx}]`, keyOrderByPath),\n    );\n  }\n\n  if (value && typeof value === \"object\") {\n    const record = value as Record<string, unknown>;\n    const currentKeys = Object.keys(record);\n    const previousOrder = keyOrderByPath.get(path) ?? [];\n    const previousOrderSet = new Set(previousOrder);\n    const nextOrder = [\n      ...previousOrder.filter((key) => Object.hasOwn(record, key)),\n      ...currentKeys.filter((key) => !previousOrderSet.has(key)),\n    ];\n    keyOrderByPath.set(path, nextOrder);\n\n    return Object.fromEntries(\n      nextOrder.map((key) => [\n        key,\n        stabilizeToolArgsValue(\n          record[key],\n          `${path}.${JSON.stringify(key)}`,\n          keyOrderByPath,\n        ),\n      ]),\n    );\n  }\n\n  return value;\n};\n\nconst getToolArgsKeyOrder = (\n  keyOrderCache: Map<string, Map<string, string[]>> | undefined,\n  cacheKey: string,\n): Map<string, string[]> => {\n  const keyOrderByPath = keyOrderCache?.get(cacheKey) ?? new Map();\n  keyOrderCache?.set(cacheKey, keyOrderByPath);\n  return keyOrderByPath;\n};\n\nexport const trackToolArgsKeyOrder = (\n  keyOrderCache: Map<string, Map<string, string[]>> | undefined,\n  cacheKey: string,\n  args: ReadonlyJSONObject,\n) => {\n  const keyOrderByPath = getToolArgsKeyOrder(keyOrderCache, cacheKey);\n  stabilizeToolArgsValue(args, \"$\", keyOrderByPath);\n};\n\nexport const stableStringifyToolArgs = (\n  keyOrderCache: Map<string, Map<string, string[]>> | undefined,\n  cacheKey: string,\n  args: ReadonlyJSONObject,\n): string => {\n  const keyOrderByPath = getToolArgsKeyOrder(keyOrderCache, cacheKey);\n  const stableArgs = stabilizeToolArgsValue(\n    args,\n    \"$\",\n    keyOrderByPath,\n  ) as ReadonlyJSONObject;\n  return JSON.stringify(stableArgs);\n};\n"],"mappings":";AAEA,MAAMC,0BACJC,OACAC,MACAC,mBACY;CACZ,IAAIE,MAAMC,QAAQL,KAAK,GACrB,OAAOA,MAAMM,KAAKC,MAAMC,QACtBT,uBAAuBQ,MAAM,GAAGN,KAAI,GAAIO,IAAG,IAAKN,cAAc,CAChE;CAGF,IAAIF,SAAS,OAAOA,UAAU,UAAU;EACtC,MAAMS,SAAST;EACf,MAAMW,cAAcC,OAAOC,KAAKJ,MAAM;EACtC,MAAMK,gBAAgBZ,eAAea,IAAId,IAAI,KAAK,CAAA;EAClD,MAAMe,mBAAmB,IAAIC,IAAIH,aAAa;EAC9C,MAAMI,YAAY,CAChB,GAAGJ,cAAcK,QAAQC,QAAQR,OAAOS,OAAOZ,QAAQW,GAAG,CAAC,GAC3D,GAAGT,YAAYQ,QAAQC,QAAQ,CAACJ,iBAAiBM,IAAIF,GAAG,CAAC,CAAC;EAE5DlB,eAAeqB,IAAItB,MAAMiB,SAAS;EAElC,OAAON,OAAOY,YACZN,UAAUZ,KAAKc,QAAQ,CACrBA,KACArB,uBACEU,OAAOW,MACP,GAAGnB,KAAI,GAAIwB,KAAKC,UAAUN,GAAG,KAC7BlB,cACF,CAAC,CACF,CACH;CACF;CAEA,OAAOF;AACT;AAEA,MAAM2B,uBACJC,eACAC,aAC0B;CAC1B,MAAM3B,iBAAiB0B,eAAeb,IAAIc,QAAQ,qBAAK,IAAI1B,IAAI;CAC/DyB,eAAeL,IAAIM,UAAU3B,cAAc;CAC3C,OAAOA;AACT;AAEA,MAAa4B,yBACXF,eACAC,UACAE,SACG;CACH,MAAM7B,iBAAiByB,oBAAoBC,eAAeC,QAAQ;CAClE9B,uBAAuBgC,MAAM,KAAK7B,cAAc;AAClD;AAEA,MAAa8B,2BACXJ,eACAC,UACAE,SACW;CACX,MAAM7B,iBAAiByB,oBAAoBC,eAAeC,QAAQ;CAClE,MAAMI,aAAalC,uBACjBgC,MACA,KACA7B,cACF;CACA,OAAOuB,KAAKC,UAAUO,UAAU;AAClC"}

package/dist/utils/text.d.ts

@@ -1,5 +1,4 @@
 import { AppendMessage, ThreadMessage } from "../types/message.js";
-
 //#region src/utils/text.d.ts
 declare const getThreadMessageText: (message: ThreadMessage | AppendMessage) => string;
 //#endregion

package/dist/utils/text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","names":[],"sources":["../../src/utils/text.ts"],"mappings":";;;cAGa,oBAAA,GACX,OAAA,EAAS,aAAA,GAAgB,aAAa"}
+{"version":3,"file":"text.d.ts","names":[],"sources":["../../src/utils/text.ts"],"mappings":";;cAGa,uBACX,SAAS,gBAAgB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/core",
-  "version": "0.2.19",
+  "version": "0.2.21",
   "description": "Framework-agnostic core runtime for assistant-ui",
   "keywords": [
     "assistant",
@@ -59,8 +59,8 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "assistant-stream": "^0.3.24",
-    "nanoid": "^5.1.15"
+    "assistant-stream": "^0.3.26",
+    "nanoid": "^6.0.0"
   },
   "optionalDevDependencies": {
     "@assistant-ui/x-generative-compiler": ">=0.0.3"
@@ -88,15 +88,18 @@
     }
   },
   "devDependencies": {
+    "@testing-library/react": "^16.3.2",
     "@types/react": "^19.2.17",
+    "jsdom": "^29.1.1",
     "react": "^19.2.7",
-    "vitest": "^4.1.9",
+    "react-dom": "^19.2.7",
+    "vitest": "^4.1.10",
     "zustand": "^5.0.14",
-    "@assistant-ui/store": "0.2.19",
-    "@assistant-ui/tap": "0.9.3",
-    "@assistant-ui/vite": "0.0.6",
-    "@assistant-ui/x-buildutils": "0.0.16",
-    "assistant-cloud": "0.1.34"
+    "@assistant-ui/store": "0.2.20",
+    "@assistant-ui/tap": "0.9.4",
+    "@assistant-ui/vite": "0.0.9",
+    "@assistant-ui/x-buildutils": "0.0.18",
+    "assistant-cloud": "0.1.35"
   },
   "publishConfig": {
     "access": "public",