@assistant-ui/core 0.2.5 → 0.2.7

package/dist/subscribable/subscribable.js.map

@@ -1 +1 @@
-{"version":3,"file":"subscribable.js","names":[],"sources":["../../src/subscribable/subscribable.ts"],"sourcesContent":["import type { Unsubscribe } from \"../types/unsubscribe\";\n\nexport const SKIP_UPDATE = Symbol(\"skip-update\");\nexport type SKIP_UPDATE = typeof SKIP_UPDATE;\n\nexport type Subscribable = {\n  subscribe: (callback: () => void) => Unsubscribe;\n};\n\nexport type SubscribableWithState<TState, TPath> = Subscribable & {\n  path: TPath;\n  getState: () => TState;\n};\n\nexport type NestedSubscribable<\n  TState extends Subscribable | undefined,\n  TPath,\n> = SubscribableWithState<TState, TPath>;\n\nexport type EventSubscribable<TEvent extends string> = {\n  event: TEvent;\n  binding: SubscribableWithState<\n    | {\n        unstable_on: (\n          event: TEvent,\n          callback: (payload?: unknown) => void,\n        ) => Unsubscribe;\n      }\n    | undefined,\n    unknown\n  >;\n};\n\nfunction shallowEqual<T extends object>(\n  objA: T | undefined,\n  objB: T | undefined,\n) {\n  if (objA === undefined && objB === undefined) return true;\n  if (objA === undefined) return false;\n  if (objB === undefined) return false;\n\n  for (const key of Object.keys(objA)) {\n    const valueA = objA[key as keyof T];\n    const valueB = objB[key as keyof T];\n    if (!Object.is(valueA, valueB)) return false;\n  }\n\n  return true;\n}\n\nexport class BaseSubscribable {\n  private _subscribers = new Set<() => void>();\n\n  public subscribe(callback: () => void): Unsubscribe {\n    this._subscribers.add(callback);\n    return () => this._subscribers.delete(callback);\n  }\n\n  public waitForUpdate() {\n    return new Promise<void>((resolve) => {\n      const unsubscribe = this.subscribe(() => {\n        unsubscribe();\n        resolve();\n      });\n    });\n  }\n\n  protected _notifySubscribers() {\n    const errors = [];\n    for (const callback of this._subscribers) {\n      try {\n        callback();\n      } catch (error) {\n        errors.push(error);\n      }\n    }\n\n    if (errors.length > 0) {\n      if (errors.length === 1) {\n        throw errors[0];\n      } else {\n        for (const error of errors) {\n          console.error(error);\n        }\n        throw new AggregateError(errors);\n      }\n    }\n  }\n}\n\n// lazy connect/disconnect: only opens upstream subscription while it has subscribers\nexport abstract class BaseSubject {\n  private _subscriptions = new Set<(payload?: unknown) => void>();\n  private _connection: Unsubscribe | undefined;\n\n  protected get isConnected() {\n    return !!this._connection;\n  }\n\n  protected abstract _connect(): Unsubscribe;\n\n  protected notifySubscribers(payload?: unknown) {\n    for (const callback of this._subscriptions) callback(payload);\n  }\n\n  private _updateConnection() {\n    if (this._subscriptions.size > 0) {\n      if (this._connection) return;\n      this._connection = this._connect();\n    } else {\n      this._connection?.();\n      this._connection = undefined;\n    }\n  }\n\n  public subscribe(callback: (payload?: unknown) => void) {\n    this._subscriptions.add(callback);\n    this._updateConnection();\n\n    return () => {\n      this._subscriptions.delete(callback);\n      this._updateConnection();\n    };\n  }\n}\n\nexport class ShallowMemoizeSubject<TState extends object, TPath>\n  extends BaseSubject\n  implements SubscribableWithState<TState, TPath>\n{\n  public get path() {\n    return this.binding.path;\n  }\n\n  constructor(\n    private binding: SubscribableWithState<TState | SKIP_UPDATE, TPath>,\n  ) {\n    super();\n    const state = binding.getState();\n    if (state === SKIP_UPDATE)\n      throw new Error(\"Entry not available in the store\");\n    this._previousState = state;\n  }\n\n  private _previousState: TState;\n  public getState = () => {\n    if (!this.isConnected) this._syncState();\n    return this._previousState;\n  };\n\n  private _syncState() {\n    const state = this.binding.getState();\n    if (state === SKIP_UPDATE) return false;\n    if (shallowEqual(state, this._previousState)) return false;\n    this._previousState = state;\n    return true;\n  }\n\n  protected _connect() {\n    const callback = () => {\n      if (this._syncState()) {\n        this.notifySubscribers();\n      }\n    };\n\n    return this.binding.subscribe(callback);\n  }\n}\n\nexport class LazyMemoizeSubject<TState extends object, TPath>\n  extends BaseSubject\n  implements SubscribableWithState<TState, TPath>\n{\n  public get path() {\n    return this.binding.path;\n  }\n\n  constructor(\n    private binding: SubscribableWithState<TState | SKIP_UPDATE, TPath>,\n  ) {\n    super();\n  }\n\n  private _previousStateDirty = true;\n  private _previousState: TState | undefined;\n  public getState = () => {\n    if (!this.isConnected || this._previousStateDirty) {\n      const newState = this.binding.getState();\n      if (newState !== SKIP_UPDATE) {\n        this._previousState = newState;\n      }\n      this._previousStateDirty = false;\n    }\n    if (this._previousState === undefined)\n      throw new Error(\"Entry not available in the store\");\n    return this._previousState;\n  };\n\n  protected _connect() {\n    const callback = () => {\n      this._previousStateDirty = true;\n      this.notifySubscribers();\n    };\n\n    return this.binding.subscribe(callback);\n  }\n}\n\nexport class NestedSubscriptionSubject<\n    TState extends Subscribable | undefined,\n    TPath,\n  >\n  extends BaseSubject\n  implements\n    SubscribableWithState<TState, TPath>,\n    NestedSubscribable<TState, TPath>\n{\n  public get path() {\n    return this.binding.path;\n  }\n\n  constructor(private binding: NestedSubscribable<TState, TPath>) {\n    super();\n  }\n\n  public getState() {\n    return this.binding.getState();\n  }\n\n  public outerSubscribe(callback: () => void) {\n    return this.binding.subscribe(callback);\n  }\n\n  protected _connect(): Unsubscribe {\n    const callback = () => {\n      this.notifySubscribers();\n    };\n\n    let lastState = this.binding.getState();\n    let innerUnsubscribe = lastState?.subscribe(callback);\n    const onRuntimeUpdate = () => {\n      const newState = this.binding.getState();\n      if (newState === lastState) return;\n      lastState = newState;\n\n      innerUnsubscribe?.();\n      innerUnsubscribe = newState?.subscribe(callback);\n\n      callback();\n    };\n\n    const outerUnsubscribe = this.outerSubscribe(onRuntimeUpdate);\n    return () => {\n      outerUnsubscribe?.();\n      innerUnsubscribe?.();\n    };\n  }\n}\n\nexport class EventSubscriptionSubject<\n  TEvent extends string,\n> extends BaseSubject {\n  constructor(private config: EventSubscribable<TEvent>) {\n    super();\n  }\n\n  public getState() {\n    return this.config.binding.getState();\n  }\n\n  public outerSubscribe(callback: () => void) {\n    return this.config.binding.subscribe(callback);\n  }\n\n  protected _connect(): Unsubscribe {\n    const callback = (payload?: unknown) => {\n      this.notifySubscribers(payload);\n    };\n\n    let lastState = this.config.binding.getState();\n    let innerUnsubscribe = lastState?.unstable_on(this.config.event, callback);\n    const onRuntimeUpdate = () => {\n      const newState = this.config.binding.getState();\n      if (newState === lastState) return;\n      lastState = newState;\n\n      innerUnsubscribe?.();\n      innerUnsubscribe = newState?.unstable_on(this.config.event, callback);\n    };\n\n    const outerUnsubscribe = this.outerSubscribe(onRuntimeUpdate);\n    return () => {\n      outerUnsubscribe?.();\n      innerUnsubscribe?.();\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"subscribable.js","names":[],"sources":["../../src/subscribable/subscribable.ts"],"sourcesContent":["import type { Unsubscribe } from \"../types/unsubscribe\";\n\nexport const SKIP_UPDATE = Symbol(\"skip-update\");\nexport type SKIP_UPDATE = typeof SKIP_UPDATE;\n\nexport type Subscribable = {\n  subscribe: (callback: () => void) => Unsubscribe;\n};\n\nexport type SubscribableWithState<TState, TPath> = Subscribable & {\n  path: TPath;\n  getState: () => TState;\n};\n\nexport type NestedSubscribable<\n  TState extends Subscribable | undefined,\n  TPath,\n> = SubscribableWithState<TState, TPath>;\n\nexport type EventSubscribable<TEvent extends string> = {\n  event: TEvent;\n  binding: SubscribableWithState<\n    | {\n        unstable_on: (\n          event: TEvent,\n          callback: (payload?: unknown) => void,\n        ) => Unsubscribe;\n      }\n    | undefined,\n    unknown\n  >;\n};\n\nfunction shallowEqual<T extends object>(\n  objA: T | undefined,\n  objB: T | undefined,\n) {\n  if (objA === undefined && objB === undefined) return true;\n  if (objA === undefined) return false;\n  if (objB === undefined) return false;\n\n  for (const key of Object.keys(objA)) {\n    const valueA = objA[key as keyof T];\n    const valueB = objB[key as keyof T];\n    if (!Object.is(valueA, valueB)) return false;\n  }\n\n  return true;\n}\n\nexport class BaseSubscribable {\n  private _subscribers = new Set<() => void>();\n\n  public subscribe(callback: () => void): Unsubscribe {\n    this._subscribers.add(callback);\n    return () => this._subscribers.delete(callback);\n  }\n\n  public waitForUpdate() {\n    return new Promise<void>((resolve) => {\n      const unsubscribe = this.subscribe(() => {\n        unsubscribe();\n        resolve();\n      });\n    });\n  }\n\n  protected _notifySubscribers() {\n    const errors = [];\n    for (const callback of this._subscribers) {\n      try {\n        callback();\n      } catch (error) {\n        errors.push(error);\n      }\n    }\n\n    if (errors.length > 0) {\n      if (errors.length === 1) {\n        throw errors[0];\n      } else {\n        for (const error of errors) {\n          console.error(error);\n        }\n        throw new AggregateError(errors);\n      }\n    }\n  }\n}\n\n// lazy connect/disconnect: only opens upstream subscription while it has subscribers\nexport abstract class BaseSubject {\n  private _subscriptions = new Set<(payload?: unknown) => void>();\n  private _connection: Unsubscribe | undefined;\n\n  protected get isConnected() {\n    return !!this._connection;\n  }\n\n  protected abstract _connect(): Unsubscribe;\n\n  protected notifySubscribers(payload?: unknown) {\n    for (const callback of this._subscriptions) callback(payload);\n  }\n\n  private _updateConnection() {\n    if (this._subscriptions.size > 0) {\n      if (this._connection) return;\n      this._connection = this._connect();\n    } else {\n      this._connection?.();\n      this._connection = undefined;\n    }\n  }\n\n  public subscribe(callback: (payload?: unknown) => void) {\n    this._subscriptions.add(callback);\n    this._updateConnection();\n\n    return () => {\n      this._subscriptions.delete(callback);\n      this._updateConnection();\n    };\n  }\n}\n\nexport class ShallowMemoizeSubject<TState extends object, TPath>\n  extends BaseSubject\n  implements SubscribableWithState<TState, TPath>\n{\n  public get path() {\n    return this.binding.path;\n  }\n\n  constructor(\n    private binding: SubscribableWithState<TState | SKIP_UPDATE, TPath>,\n  ) {\n    super();\n    const state = binding.getState();\n    if (state === SKIP_UPDATE)\n      throw new Error(\"Entry not available in the store\");\n    this._previousState = state;\n  }\n\n  private _previousState: TState;\n  public getState = () => {\n    if (!this.isConnected) this._syncState();\n    return this._previousState;\n  };\n\n  private _syncState() {\n    const state = this.binding.getState();\n    if (state === SKIP_UPDATE) return false;\n    if (shallowEqual(state, this._previousState)) return false;\n    this._previousState = state;\n    return true;\n  }\n\n  protected _connect() {\n    const callback = () => {\n      if (this._syncState()) {\n        this.notifySubscribers();\n      }\n    };\n\n    return this.binding.subscribe(callback);\n  }\n}\n\nexport class LazyMemoizeSubject<TState extends object, TPath>\n  extends BaseSubject\n  implements SubscribableWithState<TState, TPath>\n{\n  public get path() {\n    return this.binding.path;\n  }\n\n  constructor(\n    private binding: SubscribableWithState<TState | SKIP_UPDATE, TPath>,\n  ) {\n    super();\n  }\n\n  private _previousStateDirty = true;\n  private _previousState: TState | undefined;\n  public getState = () => {\n    if (!this.isConnected || this._previousStateDirty) {\n      const newState = this.binding.getState();\n      if (newState !== SKIP_UPDATE) {\n        this._previousState = newState;\n      }\n      this._previousStateDirty = false;\n    }\n    if (this._previousState === undefined)\n      throw new Error(\"Entry not available in the store\");\n    return this._previousState;\n  };\n\n  protected _connect() {\n    const callback = () => {\n      this._previousStateDirty = true;\n      this.notifySubscribers();\n    };\n\n    return this.binding.subscribe(callback);\n  }\n}\n\nexport class NestedSubscriptionSubject<\n  TState extends Subscribable | undefined,\n  TPath,\n>\n  extends BaseSubject\n  implements\n    SubscribableWithState<TState, TPath>,\n    NestedSubscribable<TState, TPath>\n{\n  public get path() {\n    return this.binding.path;\n  }\n\n  constructor(private binding: NestedSubscribable<TState, TPath>) {\n    super();\n  }\n\n  public getState() {\n    return this.binding.getState();\n  }\n\n  public outerSubscribe(callback: () => void) {\n    return this.binding.subscribe(callback);\n  }\n\n  protected _connect(): Unsubscribe {\n    const callback = () => {\n      this.notifySubscribers();\n    };\n\n    let lastState = this.binding.getState();\n    let innerUnsubscribe = lastState?.subscribe(callback);\n    const onRuntimeUpdate = () => {\n      const newState = this.binding.getState();\n      if (newState === lastState) return;\n      lastState = newState;\n\n      innerUnsubscribe?.();\n      innerUnsubscribe = newState?.subscribe(callback);\n\n      callback();\n    };\n\n    const outerUnsubscribe = this.outerSubscribe(onRuntimeUpdate);\n    return () => {\n      outerUnsubscribe?.();\n      innerUnsubscribe?.();\n    };\n  }\n}\n\nexport class EventSubscriptionSubject<\n  TEvent extends string,\n> extends BaseSubject {\n  constructor(private config: EventSubscribable<TEvent>) {\n    super();\n  }\n\n  public getState() {\n    return this.config.binding.getState();\n  }\n\n  public outerSubscribe(callback: () => void) {\n    return this.config.binding.subscribe(callback);\n  }\n\n  protected _connect(): Unsubscribe {\n    const callback = (payload?: unknown) => {\n      this.notifySubscribers(payload);\n    };\n\n    let lastState = this.config.binding.getState();\n    let innerUnsubscribe = lastState?.unstable_on(this.config.event, callback);\n    const onRuntimeUpdate = () => {\n      const newState = this.config.binding.getState();\n      if (newState === lastState) return;\n      lastState = newState;\n\n      innerUnsubscribe?.();\n      innerUnsubscribe = newState?.unstable_on(this.config.event, callback);\n    };\n\n    const outerUnsubscribe = this.outerSubscribe(onRuntimeUpdate);\n    return () => {\n      outerUnsubscribe?.();\n      innerUnsubscribe?.();\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/types/message.d.ts

@@ -123,6 +123,12 @@ type ToolCallMessagePart<TArgs = ReadonlyJSONObject, TResult = unknown> = {
   readonly interrupt?: {
     type: "human";
     payload: unknown;
+  }; /** Server-side approval gate. `approved === undefined` is the only state in which `respondToApproval` may be called. */
+  readonly approval?: {
+    readonly id: string;
+    readonly approved?: boolean;
+    readonly reason?: string;
+    readonly isAutomatic?: boolean;
   }; /** Parent message-part ID when this part belongs to a nested structure. */
   readonly parentId?: string;
   /**

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

package/dist/types/message.js.map

@@ -1 +1 @@
-{"version":3,"file":"message.js","names":[],"sources":["../../src/types/message.ts"],"sourcesContent":["import type {\n  ReadonlyJSONObject,\n  ReadonlyJSONValue,\n} from \"assistant-stream/utils\";\nimport type { ToolModelContentPart } from \"assistant-stream\";\nimport type { CompleteAttachment } from \"./attachment\";\n\nexport type { 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 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  /** 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  /** 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    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 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};\n"],"mappings":";AAgIA,MAAa,qBAAqB;AAElC,MAAa,eAAe,QAC1B,CAAC,CAAC,KAAK,WAAW,kBAAkB"}
+{"version":3,"file":"message.js","names":[],"sources":["../../src/types/message.ts"],"sourcesContent":["import type {\n  ReadonlyJSONObject,\n  ReadonlyJSONValue,\n} from \"assistant-stream/utils\";\nimport type { ToolModelContentPart } from \"assistant-stream\";\nimport type { CompleteAttachment } from \"./attachment\";\n\nexport type { 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 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  /** 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. `approved === undefined` is the only state in which `respondToApproval` may be called. */\n  readonly approval?: {\n    readonly id: string;\n    readonly approved?: boolean;\n    readonly reason?: string;\n    readonly isAutomatic?: boolean;\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    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 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};\n"],"mappings":";AAgIA,MAAa,qBAAqB;AAElC,MAAa,eAAe,QAC1B,CAAC,CAAC,KAAK,WAAW,kBAAkB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/core",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "Framework-agnostic core runtime for assistant-ui",
   "keywords": [
     "assistant",
@@ -59,12 +59,12 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "assistant-stream": "^0.3.16",
+    "assistant-stream": "^0.3.17",
     "nanoid": "^5.1.11"
   },
   "peerDependencies": {
     "@assistant-ui/store": "^0.2.12",
-    "@assistant-ui/tap": "^0.5.12",
+    "@assistant-ui/tap": "^0.5.13",
     "@types/react": "*",
     "react": "^18 || ^19",
     "assistant-cloud": "^0.1.29",
@@ -90,7 +90,7 @@
     "vitest": "^4.1.7",
     "zustand": "^5.0.13",
     "@assistant-ui/store": "0.2.12",
-    "@assistant-ui/tap": "0.5.12",
+    "@assistant-ui/tap": "0.5.13",
     "@assistant-ui/x-buildutils": "0.0.9",
     "assistant-cloud": "0.1.29"
   },

package/src/adapters/index.ts

@@ -8,10 +8,7 @@ export {
 
 // Speech adapters
 export type { SpeechSynthesisAdapter, DictationAdapter } from "./speech";
-export {
-  WebSpeechSynthesisAdapter,
-  WebSpeechDictationAdapter,
-} from "./speech";
+export { WebSpeechSynthesisAdapter, WebSpeechDictationAdapter } from "./speech";
 
 // Voice adapter
 export type { RealtimeVoiceAdapter } from "./voice";

package/src/index.ts

@@ -1,5 +1,13 @@
 // @assistant-ui/core - Framework-agnostic core runtime (public API)
 
+/// <reference path="./store/scope-registration.ts" />
+
+import { checkDuplicateCore } from "./internal/duplicate-detection";
+
+if (process.env.NODE_ENV !== "production") {
+  checkDuplicateCore();
+}
+
 export type {
   // Message parts
   TextMessagePart,
@@ -80,6 +88,8 @@ export { mergeModelContexts } from "./model-context/types";
 
 export { tool } from "./model-context/tool";
 
+export type { ToolExecutionStatus } from "./runtimes/tool-invocations/ToolInvocationTracker";
+
 export { ModelContextRegistry } from "./model-context/registry";
 export type {
   ModelContextRegistryToolHandle,
@@ -170,6 +180,7 @@ export type {
   RuntimeCapabilities,
   AddToolResultOptions,
   ResumeToolCallOptions,
+  RespondToToolApprovalOptions,
   SubmitFeedbackOptions,
   ThreadSuggestion,
   SpeechState,

package/src/internal/duplicate-detection.ts

@@ -0,0 +1,26 @@
+// Warns once if a second copy of @assistant-ui/core is loaded into the
+// same runtime. Mismatched transitive versions of core silently break
+// runtime behavior — tools registered via `makeAssistantTool` don't reach
+// the active runtime, context lookups resolve to the wrong provider,
+// `instanceof` checks fail (see issue #4101). The actual version diagnosis
+// lives in `npx assistant-ui doctor`.
+//
+// The caller is responsible for gating on `process.env.NODE_ENV` so this
+// module tree-shakes out of production bundles.
+
+const KEY = Symbol.for("@assistant-ui/core.loaded");
+
+export function checkDuplicateCore(): void {
+  const g = globalThis as unknown as Record<symbol, boolean | undefined>;
+  if (g[KEY]) {
+    // eslint-disable-next-line no-console
+    console.warn(
+      "[@assistant-ui/core] Multiple copies of @assistant-ui/core are " +
+        "loaded into the same runtime. This causes subtle bugs (tools not " +
+        "reaching the runtime, context lookups returning the wrong " +
+        "provider, instanceof checks failing). Run " +
+        "`npx assistant-ui doctor` to diagnose.",
+    );
+  }
+  g[KEY] = true;
+}

package/src/react/AssistantProvider.tsx

@@ -10,9 +10,8 @@ import type { AssistantRuntimeCore } from "../runtime/interfaces/assistant-runti
 import { RuntimeAdapter } from "./RuntimeAdapter";
 
 export const getRenderComponent = (runtime: AssistantRuntime) => {
-  return (runtime as { _core?: AssistantRuntimeCore })._core?.RenderComponent as
-    | ComponentType
-    | undefined;
+  return (runtime as { _core?: AssistantRuntimeCore })._core
+    ?.RenderComponent as ComponentType | undefined;
 };
 
 export type AssistantProviderBaseProps = PropsWithChildren<{

package/src/react/index.ts

@@ -1,3 +1,4 @@
+/// <reference path="../store/scope-registration.ts" />
 /// <reference path="./types/store-augmentation.ts" />
 
 // model-context
@@ -129,12 +130,6 @@ export {
   useRuntimeAdapters,
   type RuntimeAdapters,
 } from "./runtimes/RuntimeAdapterProvider";
-export {
-  useToolInvocations,
-  type ToolExecutionStatus,
-  type AssistantTransportState,
-  type AddToolResultCommand,
-} from "./runtimes/useToolInvocations";
 export { useExternalStoreRuntime } from "./runtimes/useExternalStoreRuntime";
 export {
   useExternalMessageConverter,
@@ -178,6 +173,7 @@ export {
   type PartState,
 } from "./primitives/message/MessageParts";
 export { MessagePrimitiveGroupedParts } from "./primitives/message/MessageGroupedParts";
+export { groupPartByType } from "./utils/groupParts";
 export {
   MessagePrimitiveGenerativeUI,
   GenerativeUIRender,

package/src/react/primitives/chainOfThought/ChainOfThoughtParts.tsx

@@ -86,8 +86,7 @@ export const ChainOfThoughtPrimitiveParts: FC<
     );
   }
 
-  // eslint-disable-next-line react-hooks/exhaustive-deps
-  // biome-ignore lint/correctness/useHookAtTopLevel: intentional conditional/nested hook usage
+  // oxlint-disable-next-line react-hooks/rules-of-hooks -- intentional conditional hook below the early return above
   const messageComponents = useMemo(
     () => ({
       Reasoning: components?.Reasoning,

package/src/react/primitives/message/MessageAttachments.test.tsx

@@ -4,7 +4,7 @@ import { MessagePrimitiveAttachments } from "./MessageAttachments";
 
 const mockUseAuiState = vi.fn();
 type UseAuiStateSelector = Parameters<
-  typeof import("@assistant-ui/store")["useAuiState"]
+  (typeof import("@assistant-ui/store"))["useAuiState"]
 >[0];
 type AttachmentsElement = ReactElement<{ children: () => null }>;
 

package/src/react/primitives/message/MessageGroupedParts.tsx

@@ -10,9 +10,8 @@ import type {
 } from "../../../types/message";
 import {
   buildGroupTree,
-  type GroupKey,
+  GROUPBY_MEMO_KEY,
   type GroupNode,
-  normalizeGroupKey,
 } from "../../utils/groupParts";
 import { MessagePartChildren, type EnrichedPartState } from "./MessageParts";
 
@@ -47,30 +46,32 @@ export namespace MessagePrimitiveGroupedParts {
 
   export type Props<TKey extends `group-${string}` = `group-${string}`> = {
     /**
-     * Maps each part to its group key path. Adjacent parts that share a
-     * prefix coalesce up to that prefix. Return `null`, `undefined`, or
-     * `[]` to leave a part ungrouped — it will be rendered as a leaf
-     * through `children` with `part` set to its {@link EnrichedPartState}.
+     * Maps each part to a group-key path. Adjacent parts that share a
+     * prefix coalesce into the same group. Return `[]` (or `null`) to
+     * leave a part ungrouped.
      *
-     * Keys must start with `"group-"` so the renderer's
-     * `switch (part.type)` can distinguish groups from real part types.
+     * Group keys must start with `"group-"` so the renderer's
+     * `switch (part.type)` can tell groups apart from real part types.
      *
-     * For best performance, pass a stable reference (module-level
-     * constant or `useCallback`).
+     * **Prefer {@link groupPartByType}** for the common case of mapping by
+     * `part.type` — it ships a stable memo fingerprint so the tree
+     * survives unrelated re-renders. Use an inline function only when
+     * the helper isn't expressive enough (e.g. branching on
+     * `part.toolName` or part metadata).
      *
      * @example
-     * ```ts
-     * const groupBy = (part) =>
-     *   part.type === "reasoning" ? ["group-thought", "group-reasoning"] :
-     *   part.type === "tool-call" ? ["group-thought", "group-tool"] :
-     *   null;
+     * ```tsx
+     * import { groupPartByType } from "@assistant-ui/react";
+     *
+     * <MessagePrimitive.GroupedParts
+     *   groupBy={groupPartByType({
+     *     reasoning: ["group-thought", "group-reasoning"],
+     *     "tool-call": ["group-thought", "group-tool"],
+     *   })}
+     * >
      * ```
      */
-    readonly groupBy: (
-      part: PartState,
-      index: number,
-      parts: readonly PartState[],
-    ) => GroupKey<TKey>;
+    readonly groupBy: (part: PartState) => readonly TKey[] | null;
 
     /**
      * Render function called once per group node and once per leaf part.
@@ -79,7 +80,7 @@ export namespace MessagePrimitiveGroupedParts {
      *
      * Leaf parts receive the same {@link EnrichedPartState} that
      * `<MessagePrimitive.Parts>` would produce (`toolUI`, `addResult`,
-     * `resume`, `dataRendererUI`).
+     * `resume`, `respondToApproval`, `dataRendererUI`).
      */
     readonly children: (info: RenderInfo<TKey>) => ReactNode;
   };
@@ -148,11 +149,10 @@ const renderNode = <TKey extends `group-${string}`>(
  * @example
  * ```tsx
  * <MessagePrimitive.GroupedParts
- *   groupBy={(part) =>
- *     part.type === "reasoning" ? ["group-thought", "group-reasoning"] :
- *     part.type === "tool-call" ? ["group-thought", "group-tool"] :
- *     null
- *   }
+ *   groupBy={groupPartByType({
+ *     reasoning: ["group-thought", "group-reasoning"],
+ *     "tool-call": ["group-thought", "group-tool"],
+ *   })}
  * >
  *   {({ part, children }) => {
  *     switch (part.type) {
@@ -173,12 +173,19 @@ export const MessagePrimitiveGroupedParts = <TKey extends `group-${string}`>({
 }: MessagePrimitiveGroupedParts.Props<TKey>): ReactNode => {
   const parts = useAuiState(useShallow((s) => s.message.parts));
 
+  // Helpers like `groupPartByType` tag the function with `GROUPBY_MEMO_KEY`
+  // (a stable string fingerprint of the helper config). When present,
+  // memo on `[parts, memoKey]` so the tree survives unrelated renders.
+  // For inline `groupBy`, fall back to recomputing each render — O(n)
+  // and cheap.
+  const memoKey = (groupBy as { [GROUPBY_MEMO_KEY]?: string })[
+    GROUPBY_MEMO_KEY
+  ];
+  const memoDep = memoKey ?? groupBy;
   const tree = useMemo(
-    () =>
-      buildGroupTree(
-        parts.map((part, i) => normalizeGroupKey(groupBy(part, i, parts))),
-      ),
-    [parts, groupBy],
+    () => buildGroupTree(parts.map((part) => groupBy(part) ?? [])),
+    // oxlint-disable-next-line tap-hooks/exhaustive-deps -- groupBy is captured via memoDep (either its identity or the helper's memoKey fingerprint); listing it directly would defeat the helper-tagged memo path
+    [parts, memoDep],
   );
 
   return <>{tree.map((node) => renderNode(node, parts, children))}</>;

package/src/react/primitives/message/MessageParts.tsx

@@ -379,8 +379,16 @@ export const MessagePartComponent: FC<MessagePartComponentProps> = ({
   if (type === "tool-call") {
     const addResult = aui.part().addToolResult;
     const resume = aui.part().resumeToolCall;
+    const respondToApproval = aui.part().respondToToolApproval;
     if ("Override" in tools)
-      return <tools.Override {...part} addResult={addResult} resume={resume} />;
+      return (
+        <tools.Override
+          {...part}
+          addResult={addResult}
+          resume={resume}
+          respondToApproval={respondToApproval}
+        />
+      );
     const Tool = tools.by_name?.[part.toolName] ?? tools.Fallback;
     return (
       <ToolUIDisplay
@@ -388,6 +396,7 @@ export const MessagePartComponent: FC<MessagePartComponentProps> = ({
         Fallback={Tool}
         addResult={addResult}
         resume={resume}
+        respondToApproval={respondToApproval}
       />
     );
   }
@@ -592,6 +601,7 @@ const RegisteredToolUI: FC = () => {
       {...part}
       addResult={aui.part().addToolResult}
       resume={aui.part().resumeToolCall}
+      respondToApproval={aui.part().respondToToolApproval}
     />
   );
 };
@@ -657,6 +667,8 @@ export type EnrichedPartState =
       addResult: ToolCallMessagePartProps["addResult"];
       /** Resume a tool call waiting for human input. */
       resume: ToolCallMessagePartProps["resume"];
+      /** Respond to a server-side tool approval gate. */
+      respondToApproval: ToolCallMessagePartProps["respondToApproval"];
     })
   | (Extract<PartState, { type: "data" }> & {
       /** The registered data renderer UI element, or null if none registered. */
@@ -706,6 +718,7 @@ export const MessagePartChildren: FC<{
                   toolUI: hasUI ? <RegisteredToolUI /> : null,
                   addResult: partMethods.addToolResult,
                   resume: partMethods.resumeToolCall,
+                  respondToApproval: partMethods.respondToToolApproval,
                 };
               }
               if (state.type === "data") {

package/src/react/providers/TextMessagePartProvider.tsx

@@ -28,6 +28,9 @@ const TextMessagePartClient = resource(
       resumeToolCall: () => {
         throw new Error("Not supported");
       },
+      respondToToolApproval: () => {
+        throw new Error("Not supported");
+      },
     };
   },
 );

package/src/react/runtimes/external-message-converter.ts

@@ -12,7 +12,7 @@ import {
   type ThreadMessageLike,
 } from "../../runtime/utils/thread-message-like";
 import { getAutoStatus, isAutoStatus } from "../../runtime/utils/auto-status";
-import type { ToolExecutionStatus } from "./useToolInvocations";
+import type { ToolExecutionStatus } from "../../runtimes/tool-invocations/ToolInvocationTracker";
 import type { ReadonlyJSONValue } from "assistant-stream/utils";
 import { generateErrorMessageId } from "../../utils/id";
 import type {
@@ -22,6 +22,22 @@ import type {
 } from "../../types/message";
 import type { MessageTiming } from "../../types/message";
 
+type ThreadMessageLikeContentItem = Exclude<
+  ThreadMessageLike["content"],
+  string
+>[number];
+
+const isPendingToolCall = (c: ThreadMessageLikeContentItem): boolean =>
+  c.type === "tool-call" && c.result === undefined;
+
+const isInterruptedToolCall = (c: ThreadMessageLikeContentItem): boolean => {
+  if (c.type !== "tool-call" || c.result !== undefined) return false;
+  return (
+    c.interrupt != null ||
+    (c.approval != null && c.approval.approved === undefined)
+  );
+};
+
 export namespace useExternalMessageConverter {
   export type Message =
     | (ThreadMessageLike & {
@@ -335,15 +351,16 @@ export const convertExternalMessages = <T extends WeakKey>(
   const result = chunks.map((message, idx) => {
     const isLast = idx === chunks.length - 1;
     const joined = joinExternalMessages(message.outputs);
+    const hasInterruptedToolCalls =
+      typeof joined.content === "object" &&
+      joined.content.some(isInterruptedToolCall);
     const hasPendingToolCalls =
       typeof joined.content === "object" &&
-      joined.content.some(
-        (c) => c.type === "tool-call" && c.result === undefined,
-      );
+      joined.content.some(isPendingToolCall);
     const autoStatus = getAutoStatus(
       isLast,
       isRunning,
-      hasPendingToolCalls,
+      hasInterruptedToolCalls,
       hasPendingToolCalls,
       isLast ? metadata.error : undefined,
     );
@@ -425,20 +442,16 @@ export const useExternalMessageConverter = <T extends WeakKey>({
         const isLast = idx === chunks.length - 1;
 
         const joined = joinExternalMessages(message.outputs);
-        const hasSuspendedToolCalls =
+        const hasInterruptedToolCalls =
           typeof joined.content === "object" &&
-          joined.content.some(
-            (c) => c.type === "tool-call" && c.result === undefined,
-          );
+          joined.content.some(isInterruptedToolCall);
         const hasPendingToolCalls =
           typeof joined.content === "object" &&
-          joined.content.some(
-            (c) => c.type === "tool-call" && c.result === undefined,
-          );
+          joined.content.some(isPendingToolCall);
         const autoStatus = getAutoStatus(
           isLast,
           isRunning,
-          hasSuspendedToolCalls,
+          hasInterruptedToolCalls,
           hasPendingToolCalls,
           isLast ? state.metadata.error : undefined,
         );

package/src/react/types/MessagePartComponentTypes.ts

@@ -71,6 +71,14 @@ export type ToolCallMessagePartProps<
      * paused frontend tool execution.
      */
     resume: (payload: unknown) => void;
+    /**
+     * Responds to a server-side tool approval gate. Only valid while
+     * `approval` is set on the part and `approval.approved === undefined`.
+     */
+    respondToApproval: (response: {
+      approved: boolean;
+      reason?: string;
+    }) => void;
   };
 
 /** Component used to render a tool-call message part. */