@assistant-ui/core 0.2.20 → 0.2.22

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 = {
@@ -242,6 +277,7 @@ type ThreadUserMessage = MessageCommonProps & {
     readonly steps?: undefined;
     readonly submittedFeedback?: undefined;
     readonly timing?: undefined;
+    readonly isOptimistic?: boolean;
     readonly custom: Record<string, unknown>;
   };
 };
@@ -288,12 +324,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;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","isOptimistic","ThreadAssistantMessage","status","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 isOptimistic?: boolean;\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/data-url.d.ts

@@ -0,0 +1,9 @@
+//#region src/utils/data-url.d.ts
+declare const httpUrlPattern: RegExp;
+declare function parseDataUrl(value: string): {
+  mimeType: string;
+  data: string;
+} | null;
+//#endregion
+export { httpUrlPattern, parseDataUrl };
+//# sourceMappingURL=data-url.d.ts.map

package/dist/utils/data-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-url.d.ts","names":[],"sources":["../../src/utils/data-url.ts"],"mappings":";cAAa,gBAAc;iBAEX,aACd;EACG;EAAkB"}

package/dist/utils/data-url.js

@@ -0,0 +1,14 @@
+//#region src/utils/data-url.ts
+const httpUrlPattern = /^https?:\/\//i;
+function parseDataUrl(value) {
+	const match = value.match(/^data:([^;,]+)(?:;[^;,]+)*;base64,(.+)$/);
+	if (!match) return null;
+	return {
+		mimeType: match[1],
+		data: match[2]
+	};
+}
+//#endregion
+export { httpUrlPattern, parseDataUrl };
+
+//# sourceMappingURL=data-url.js.map

package/dist/utils/data-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-url.js","names":["httpUrlPattern","parseDataUrl","value","mimeType","data","match"],"sources":["../../src/utils/data-url.ts"],"sourcesContent":["export const httpUrlPattern = /^https?:\\/\\//i;\n\nexport function parseDataUrl(\n  value: string,\n): { mimeType: string; data: string } | null {\n  const match = value.match(/^data:([^;,]+)(?:;[^;,]+)*;base64,(.+)$/);\n  if (!match) return null;\n  return { mimeType: match[1]!, data: match[2]! };\n}\n"],"mappings":";AAAA,MAAaA,iBAAiB;AAE9B,SAAgBC,aACdC,OAC2C;CAC3C,MAAMG,QAAQH,MAAMG,MAAM,yCAAyC;CACnE,IAAI,CAACA,OAAO,OAAO;CACnB,OAAO;EAAEF,UAAUE,MAAM;EAAKD,MAAMC,MAAM;CAAI;AAChD"}

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/notify-event-listeners.d.ts

@@ -0,0 +1,6 @@
+//#region src/utils/notify-event-listeners.d.ts
+type EventListener = (payload?: unknown) => void;
+declare const notifyEventListeners: (listeners: Iterable<EventListener>, payload: unknown, errorContext: string) => void;
+//#endregion
+export { notifyEventListeners };
+//# sourceMappingURL=notify-event-listeners.d.ts.map

package/dist/utils/notify-event-listeners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify-event-listeners.d.ts","names":[],"sources":["../../src/utils/notify-event-listeners.ts"],"mappings":";KAAK,iBAAiB;cAET,uBACX,WAAW,SAAS,gBACpB,kBACA"}

package/dist/utils/notify-event-listeners.js

@@ -0,0 +1,16 @@
+//#region src/utils/notify-event-listeners.ts
+const notifyEventListeners = (listeners, payload, errorContext) => {
+	const reportError = (error) => {
+		console.error(`[assistant-ui] ${errorContext} listener threw an error`, error);
+	};
+	for (const listener of listeners) try {
+		const result = listener(payload);
+		if (result !== null && (typeof result === "object" || typeof result === "function") && "then" in result && typeof result.then === "function") Promise.resolve(result).catch(reportError);
+	} catch (error) {
+		reportError(error);
+	}
+};
+//#endregion
+export { notifyEventListeners };
+
+//# sourceMappingURL=notify-event-listeners.js.map

package/dist/utils/notify-event-listeners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify-event-listeners.js","names":["EventListener","payload","notifyEventListeners","listeners","Iterable","errorContext","reportError","error","console","listener","result","then","Promise","resolve","catch"],"sources":["../../src/utils/notify-event-listeners.ts"],"sourcesContent":["type EventListener = (payload?: unknown) => void;\n\nexport const notifyEventListeners = (\n  listeners: Iterable<EventListener>,\n  payload: unknown,\n  errorContext: string,\n) => {\n  const reportError = (error: unknown) => {\n    console.error(\n      `[assistant-ui] ${errorContext} listener threw an error`,\n      error,\n    );\n  };\n\n  for (const listener of listeners) {\n    try {\n      const result = listener(payload) as unknown;\n      if (\n        result !== null &&\n        (typeof result === \"object\" || typeof result === \"function\") &&\n        \"then\" in result &&\n        typeof result.then === \"function\"\n      ) {\n        void Promise.resolve(result).catch(reportError);\n      }\n    } catch (error) {\n      reportError(error);\n    }\n  }\n};\n"],"mappings":";AAEA,MAAaE,wBACXC,WACAF,SACAI,iBACG;CACH,MAAMC,eAAeC,UAAmB;EACtCC,QAAQD,MACN,kBAAkBF,aAAY,2BAC9BE,KACF;CACF;CAEA,KAAK,MAAME,YAAYN,WACrB,IAAI;EACF,MAAMO,SAASD,SAASR,OAAO;EAC/B,IACES,WAAW,SACV,OAAOA,WAAW,YAAY,OAAOA,WAAW,eACjD,UAAUA,UACV,OAAOA,OAAOC,SAAS,YAEvB,QAAaE,QAAQH,MAAM,CAAC,CAACI,MAAMR,WAAW;CAElD,SAASC,OAAO;EACdD,YAAYC,KAAK;CACnB;AAEJ"}

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.20",
+  "version": "0.2.22",
   "description": "Framework-agnostic core runtime for assistant-ui",
   "keywords": [
     "assistant",
@@ -59,8 +59,8 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "assistant-stream": "^0.3.25",
-    "nanoid": "^5.1.15"
+    "assistant-stream": "^0.3.27",
+    "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",
-    "react": "^19.2.7",
-    "vitest": "^4.1.9",
+    "jsdom": "^29.1.1",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "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.8",
-    "@assistant-ui/x-buildutils": "0.0.17",
-    "assistant-cloud": "0.1.34"
+    "@assistant-ui/store": "0.2.21",
+    "@assistant-ui/tap": "0.9.5",
+    "@assistant-ui/vite": "0.0.10",
+    "@assistant-ui/x-buildutils": "0.0.19",
+    "assistant-cloud": "0.1.36"
   },
   "publishConfig": {
     "access": "public",
@@ -114,6 +117,7 @@
   "scripts": {
     "build": "aui-build",
     "test": "vitest run",
+    "test:react-compiler": "vitest run --config vitest.react-compiler.config.ts",
     "test:watch": "vitest"
   }
 }