@assistant-ui/react-a2a 0.2.33 → 0.2.35

package/dist/A2AThreadRuntimeCore.js.map

@@ -1 +1 @@
-{"version":3,"file":"A2AThreadRuntimeCore.js","names":[],"sources":["../src/A2AThreadRuntimeCore.ts"],"sourcesContent":["\"use client\";\n\nimport { generateId, fromThreadMessageLike } from \"@assistant-ui/core\";\nimport type {\n  AppendMessage,\n  AssistantRuntime,\n  ExportedMessageRepository,\n  MessageStatus,\n  ThreadAssistantMessage,\n  ThreadHistoryAdapter,\n  ThreadMessage,\n} from \"@assistant-ui/core\";\nimport {\n  createMessageRepositorySession,\n  invokeUserCallback,\n} from \"@assistant-ui/core/internal\";\nimport type { A2AClient } from \"./A2AClient\";\nimport type {\n  A2AArtifact,\n  A2AAgentCard,\n  A2AMessage,\n  A2ASendMessageConfiguration,\n  A2AStreamEvent,\n  A2ATask,\n  A2ATaskArtifactUpdateEvent,\n  A2ATaskStatusUpdateEvent,\n} from \"./types\";\nimport {\n  a2aMessageToContent,\n  isTerminalTaskState,\n  threadMessageToA2AMessage,\n  taskStateToMessageStatus,\n} from \"./conversions\";\n\nexport type A2AThreadRuntimeCoreOptions = {\n  client: A2AClient;\n  contextId?: string | undefined;\n  configuration?: A2ASendMessageConfiguration | undefined;\n  onError?: ((error: Error) => void) | undefined;\n  onCancel?: (() => void) | undefined;\n  onArtifactComplete?: ((artifact: A2AArtifact) => void) | undefined;\n  history?: ThreadHistoryAdapter | undefined;\n  notifyUpdate: () => void;\n};\n\nconst FALLBACK_USER_STATUS = {\n  type: \"complete\",\n  reason: \"unknown\",\n} as const;\n\ntype A2ARuntimeCallbackName = \"onError\" | \"onCancel\" | \"onArtifactComplete\";\n\nconst invokeRuntimeCallback = <TArgs extends readonly unknown[]>(\n  name: A2ARuntimeCallbackName,\n  callback: ((...args: TArgs) => unknown) | undefined,\n  ...args: TArgs\n): void => {\n  void invokeUserCallback(\"react-a2a\", name, callback, ...args);\n};\n\nfunction normalizeArtifact(artifact: A2AArtifact): A2AArtifact {\n  return {\n    ...artifact,\n    parts: Array.isArray(artifact.parts) ? artifact.parts : [],\n  };\n}\n\nexport class A2AThreadRuntimeCore {\n  private client: A2AClient;\n  private contextId: string | undefined;\n  private configuration: A2ASendMessageConfiguration | undefined;\n  private onError: ((error: Error) => void) | undefined;\n  private onCancel: (() => void) | undefined;\n  private onArtifactComplete: ((artifact: A2AArtifact) => void) | undefined;\n  private history: ThreadHistoryAdapter | undefined;\n  private readonly notifyUpdate: () => void;\n\n  private runtime: AssistantRuntime | undefined;\n  private readonly session = createMessageRepositorySession();\n  private isRunningFlag = false;\n  private abortController: AbortController | null = null;\n  private pendingError: Error | null = null;\n\n  // A2A-specific state\n  private currentTask: A2ATask | undefined;\n  private currentArtifacts: A2AArtifact[] = [];\n  private agentCardValue: A2AAgentCard | undefined;\n\n  // History tracking\n  private readonly assistantHistoryParents = new Map<string, string | null>();\n  private readonly recordedHistoryIds = new Set<string>();\n  private _isLoading = false;\n  private _loadPromise: Promise<void> | undefined;\n  private _loadRequested = false;\n  private _agentCardPromise: Promise<void> | undefined;\n\n  private lastOptionsContextId: string | undefined;\n\n  constructor(options: A2AThreadRuntimeCoreOptions) {\n    this.client = options.client;\n    this.contextId = options.contextId;\n    this.lastOptionsContextId = options.contextId;\n    this.configuration = options.configuration;\n    this.onError = options.onError;\n    this.onCancel = options.onCancel;\n    this.onArtifactComplete = options.onArtifactComplete;\n    this.history = options.history;\n    this.notifyUpdate = options.notifyUpdate;\n  }\n\n  updateOptions(options: Omit<A2AThreadRuntimeCoreOptions, \"notifyUpdate\">) {\n    this.client = options.client;\n    // The hook re-applies options on every render, including renders caused\n    // by this core's own notifyUpdate. The option only seeds the context: a\n    // re-render with the same value must not clobber a server-assigned\n    // contextId learned from the stream.\n    if (options.contextId !== this.lastOptionsContextId) {\n      this.contextId = options.contextId;\n      this.lastOptionsContextId = options.contextId;\n    }\n    this.configuration = options.configuration;\n    this.onError = options.onError;\n    this.onCancel = options.onCancel;\n    this.onArtifactComplete = options.onArtifactComplete;\n    const previousHistory = this.history;\n    this.history = options.history;\n\n    if (\n      this._loadRequested &&\n      !this._loadPromise &&\n      !previousHistory &&\n      options.history &&\n      this.session.getMessages().length === 0\n    ) {\n      void this.__internal_load();\n    }\n  }\n\n  /** Thread-boundary reset: applyExternalMessages alone also serves branch\n   * switches, deletes, and cancel resyncs, which must keep the live context. */\n  resetContext(): void {\n    // Restore the seed before aborting: an onCancel callback that starts a\n    // new run must not pick up the old thread's context, and its controller\n    // must not be discarded.\n    const controller = this.abortController;\n    this.contextId = this.lastOptionsContextId;\n    if (controller) {\n      controller.abort();\n      if (this.abortController === controller) {\n        this.abortController = null;\n      }\n    }\n  }\n\n  attachRuntime(runtime: AssistantRuntime) {\n    this.runtime = runtime;\n  }\n\n  detachRuntime() {\n    this.runtime = undefined;\n    // Abort in-flight requests on unmount\n    if (this.abortController) {\n      this.abortController.abort();\n      this.abortController = null;\n    }\n  }\n\n  getRuntime(): AssistantRuntime | undefined {\n    return this.runtime;\n  }\n\n  getMessages(): readonly ThreadMessage[] {\n    return this.session.getMessages();\n  }\n\n  getMessageRepository(): ExportedMessageRepository {\n    return this.session.export();\n  }\n\n  getTask(): A2ATask | undefined {\n    return this.currentTask;\n  }\n\n  getArtifacts(): readonly A2AArtifact[] {\n    return this.currentArtifacts;\n  }\n\n  getAgentCard(): A2AAgentCard | undefined {\n    return this.agentCardValue;\n  }\n\n  isRunning(): boolean {\n    return this.isRunningFlag;\n  }\n\n  get isLoading(): boolean {\n    return this._isLoading;\n  }\n\n  __internal_load(): Promise<void> {\n    this._loadRequested = true;\n    this._agentCardPromise ??= this.client\n      .getAgentCard()\n      .then((agentCard) => {\n        this.agentCardValue = agentCard;\n        this.notifyUpdate();\n      })\n      .catch(() => undefined);\n\n    if (this._loadPromise) return this._loadPromise;\n    if (!this.history) return this._agentCardPromise;\n\n    this._isLoading = true;\n\n    const historyPromise = this.history.load();\n\n    this._loadPromise = Promise.all([historyPromise, this._agentCardPromise])\n      .then(([repo]) => {\n        if (repo) {\n          this.session.applyExternalMessageRepository(repo);\n          this.finalizeExternalApply();\n        }\n      })\n      .catch((error) => {\n        invokeRuntimeCallback(\n          \"onError\",\n          this.onError,\n          error instanceof Error ? error : new Error(String(error)),\n        );\n      })\n      .finally(() => {\n        this._isLoading = false;\n        this.notifyUpdate();\n      });\n\n    this.notifyUpdate();\n    return this._loadPromise;\n  }\n\n  async append(message: AppendMessage): Promise<void> {\n    const startRun = message.startRun ?? message.role === \"user\";\n\n    const threadMessage = fromThreadMessageLike(\n      message as any,\n      generateId(),\n      FALLBACK_USER_STATUS,\n    );\n    const parentId =\n      message.parentId === null\n        ? null\n        : message.parentId && this.session.hasMessage(message.parentId)\n          ? message.parentId\n          : this.session.headId;\n    this.session.addOrUpdateMessage(parentId, threadMessage);\n    this.session.switchToBranch(threadMessage.id);\n    this.notifyUpdate();\n    this.recordHistoryEntry(parentId, threadMessage);\n\n    if (!startRun) return;\n    await this.startRun(threadMessage);\n  }\n\n  async edit(message: AppendMessage): Promise<void> {\n    await this.append(message);\n  }\n\n  async reload(\n    parentId: string | null,\n    _config: { runConfig?: Record<string, unknown> } = {},\n  ): Promise<void> {\n    const messages =\n      parentId === null\n        ? []\n        : (this.session.tryGetMessages(parentId) ?? this.getMessages());\n    for (let i = messages.length - 1; i >= 0; i--) {\n      if (messages[i]!.role === \"user\") {\n        await this.startRun(messages[i]!);\n        return;\n      }\n    }\n  }\n\n  async cancel(): Promise<void> {\n    if (!this.abortController) return;\n\n    // Abort locally first so the stream stops immediately\n    this.abortController.abort();\n\n    // Then try to cancel the task on the server\n    if (this.currentTask?.id) {\n      try {\n        const updated = await this.client.cancelTask(this.currentTask.id);\n        this.currentTask = updated;\n      } catch {\n        // Server cancel failed; local abort already handled\n      }\n    }\n  }\n\n  private appendLinearChain(messages: readonly ThreadMessage[]): string | null {\n    let parentId: string | null = null;\n    let lastId: string | null = null;\n    const seen = new Set<string>();\n\n    for (const message of messages) {\n      if (seen.has(message.id)) continue;\n      seen.add(message.id);\n      this.session.addOrUpdateMessage(parentId, message);\n      parentId = message.id;\n      lastId = message.id;\n    }\n\n    return lastId;\n  }\n\n  private finalizeExternalApply(): void {\n    this.assistantHistoryParents.clear();\n    this.recordedHistoryIds.clear();\n    for (const { message } of this.getMessageRepository().messages) {\n      this.recordedHistoryIds.add(message.id);\n    }\n    this.currentTask = undefined;\n    this.currentArtifacts = [];\n    this.notifyUpdate();\n  }\n\n  applyExternalMessages(messages: readonly ThreadMessage[]): void {\n    if (messages.length === 0) {\n      this.session.clear();\n    } else {\n      let expectedParentId: string | null = null;\n      let lastAppliedId: string | null = null;\n      let hardReplace = false;\n      const seen = new Set<string>();\n\n      for (const message of messages) {\n        if (seen.has(message.id)) continue;\n        seen.add(message.id);\n        const existing = this.session.tryGetMessage(message.id);\n        if (existing && existing.parentId !== expectedParentId) {\n          hardReplace = true;\n          break;\n        }\n        this.session.addOrUpdateMessage(expectedParentId, message);\n        expectedParentId = message.id;\n        lastAppliedId = message.id;\n      }\n\n      if (hardReplace) {\n        this.session.clear();\n        lastAppliedId = this.appendLinearChain(messages);\n      }\n\n      this.session.resetHead(lastAppliedId);\n    }\n\n    this.finalizeExternalApply();\n  }\n\n  // --- Run logic ---\n\n  private async startRun(userThreadMessage: ThreadMessage): Promise<void> {\n    // Cancel any in-progress run before starting a new one\n    if (this.abortController) {\n      this.abortController.abort();\n      this.abortController = null;\n    }\n\n    const a2aMessage = threadMessageToA2AMessage(userThreadMessage, {\n      contextId: this.contextId,\n      taskId:\n        this.currentTask?.id &&\n        !isTerminalTaskState(this.currentTask.status.state)\n          ? this.currentTask.id\n          : undefined,\n    });\n\n    // Clear task if previous task reached terminal state\n    if (\n      this.currentTask &&\n      isTerminalTaskState(this.currentTask.status.state)\n    ) {\n      this.currentTask = undefined;\n    }\n\n    this.currentArtifacts = [];\n\n    const assistantParentId = userThreadMessage.id;\n    const assistantId = this.insertAssistantPlaceholder(assistantParentId);\n    this.markPendingAssistantHistory(assistantId, assistantParentId);\n\n    const abortController = new AbortController();\n    this.abortController = abortController;\n\n    abortController.signal.addEventListener(\n      \"abort\",\n      () => {\n        this.updateAssistantStatus(assistantId, {\n          type: \"incomplete\",\n          reason: \"cancelled\",\n        });\n        this.finishRun(abortController);\n        invokeRuntimeCallback(\"onCancel\", this.onCancel);\n      },\n      { once: true },\n    );\n\n    this.setRunning(true);\n\n    // Check if agent supports streaming; fall back to sync sendMessage if not\n    const supportsStreaming =\n      this.agentCardValue?.capabilities?.streaming !== false;\n\n    try {\n      if (supportsStreaming) {\n        await this.runStreaming(a2aMessage, assistantId, abortController);\n      } else {\n        await this.runSync(a2aMessage, assistantId, abortController);\n      }\n    } catch (error) {\n      if (!abortController.signal.aborted) {\n        const err = error instanceof Error ? error : new Error(String(error));\n        this.updateAssistantStatus(assistantId, {\n          type: \"incomplete\",\n          reason: \"error\",\n        });\n        invokeRuntimeCallback(\"onError\", this.onError, err);\n        this.pendingError = this.pendingError ?? err;\n      }\n    } finally {\n      this.finishRun(abortController);\n    }\n\n    if (this.pendingError) {\n      const err = this.pendingError;\n      this.pendingError = null;\n      throw err;\n    }\n  }\n\n  private async runStreaming(\n    a2aMessage: A2AMessage,\n    assistantId: string,\n    abortController: AbortController,\n  ): Promise<void> {\n    const stream = this.client.streamMessage(\n      a2aMessage,\n      this.configuration,\n      undefined, // metadata\n      abortController.signal,\n    );\n\n    let receivedEvent = false;\n    let skipReason: string | undefined;\n    const diagnosedStream = (async function* () {\n      const reason = yield* stream;\n      if (typeof reason === \"string\") skipReason = reason;\n    })();\n\n    for await (const event of diagnosedStream) {\n      if (abortController.signal.aborted) break;\n      receivedEvent = true;\n      this.handleStreamEvent(assistantId, event);\n    }\n\n    if (!abortController.signal.aborted) {\n      if (!receivedEvent) {\n        throw new Error(\n          skipReason\n            ? `A2A message stream ended without any events. First skipped frame: ${skipReason}`\n            : \"A2A message stream ended without any events.\",\n        );\n      }\n\n      const lastStatus = this.getAssistantStatus(assistantId);\n      if (lastStatus?.type === \"running\") {\n        this.updateAssistantStatus(assistantId, {\n          type: \"complete\",\n          reason: \"stop\",\n        });\n      }\n    }\n  }\n\n  private async runSync(\n    a2aMessage: A2AMessage,\n    assistantId: string,\n    abortController: AbortController,\n  ): Promise<void> {\n    const result = await this.client.sendMessage(\n      a2aMessage,\n      this.configuration,\n      undefined, // metadata\n      abortController.signal,\n    );\n\n    if (abortController.signal.aborted) return;\n\n    // Result is either A2ATask or A2AMessage\n    if (\"id\" in result && \"status\" in result) {\n      // It's a Task\n      this.handleTaskSnapshot(assistantId, result as A2ATask);\n    } else if (\"messageId\" in result && \"parts\" in result) {\n      // It's a Message\n      this.handleMessage(assistantId, result as A2AMessage);\n      this.updateAssistantStatus(assistantId, {\n        type: \"complete\",\n        reason: \"stop\",\n      });\n    }\n  }\n\n  private handleStreamEvent(assistantId: string, event: A2AStreamEvent) {\n    switch (event.type) {\n      case \"statusUpdate\":\n        this.handleStatusUpdate(assistantId, event.event);\n        break;\n      case \"artifactUpdate\":\n        this.handleArtifactUpdate(event.event);\n        break;\n      case \"message\":\n        this.handleMessage(assistantId, event.message);\n        break;\n      case \"task\":\n        this.handleTaskSnapshot(assistantId, event.task);\n        break;\n    }\n  }\n\n  private handleStatusUpdate(\n    assistantId: string,\n    event: A2ATaskStatusUpdateEvent,\n  ) {\n    if (!this.currentTask) {\n      this.currentTask = {\n        id: event.taskId,\n        contextId: event.contextId,\n        status: event.status,\n      };\n    } else {\n      this.currentTask = { ...this.currentTask, status: event.status };\n    }\n\n    if (event.contextId) {\n      this.contextId = event.contextId;\n    }\n\n    if (event.status.message) {\n      const content = a2aMessageToContent(event.status.message);\n      this.updateAssistantContent(assistantId, content);\n    }\n\n    const status = taskStateToMessageStatus(event.status.state);\n    this.updateAssistantStatus(assistantId, status);\n\n    this.notifyUpdate();\n  }\n\n  private handleArtifactUpdate(event: A2ATaskArtifactUpdateEvent) {\n    const { append, lastChunk } = event;\n    const artifact = normalizeArtifact(event.artifact);\n    const existingIdx = this.currentArtifacts.findIndex(\n      (a) => a.artifactId === artifact.artifactId,\n    );\n\n    let updated: A2AArtifact;\n    if (existingIdx >= 0 && append) {\n      const existing = this.currentArtifacts[existingIdx]!;\n      updated = {\n        ...existing,\n        parts: [...existing.parts, ...artifact.parts],\n      };\n      this.currentArtifacts = [\n        ...this.currentArtifacts.slice(0, existingIdx),\n        updated,\n        ...this.currentArtifacts.slice(existingIdx + 1),\n      ];\n    } else if (existingIdx >= 0) {\n      updated = artifact;\n      this.currentArtifacts = [\n        ...this.currentArtifacts.slice(0, existingIdx),\n        updated,\n        ...this.currentArtifacts.slice(existingIdx + 1),\n      ];\n    } else {\n      updated = artifact;\n      this.currentArtifacts = [...this.currentArtifacts, updated];\n    }\n\n    if (lastChunk) {\n      invokeRuntimeCallback(\n        \"onArtifactComplete\",\n        this.onArtifactComplete,\n        updated,\n      );\n    }\n\n    this.notifyUpdate();\n  }\n\n  private handleMessage(assistantId: string, message: A2AMessage) {\n    if (message.role !== \"agent\") return;\n\n    const content = a2aMessageToContent(message);\n    this.updateAssistantContent(assistantId, content);\n    this.notifyUpdate();\n  }\n\n  private handleTaskSnapshot(assistantId: string, task: A2ATask) {\n    const artifacts =\n      task.artifacts === undefined\n        ? undefined\n        : Array.isArray(task.artifacts)\n          ? task.artifacts.map(normalizeArtifact)\n          : [];\n    const history =\n      task.history === undefined\n        ? undefined\n        : Array.isArray(task.history)\n          ? task.history\n          : [];\n    this.currentTask = {\n      ...task,\n      ...(artifacts === undefined ? {} : { artifacts }),\n      ...(history === undefined ? {} : { history }),\n    };\n\n    if (task.contextId) {\n      this.contextId = task.contextId;\n    }\n    if (artifacts) {\n      this.currentArtifacts = artifacts;\n    }\n\n    if (task.status.message) {\n      const content = a2aMessageToContent(task.status.message);\n      this.updateAssistantContent(assistantId, content);\n    }\n\n    const status = taskStateToMessageStatus(task.status.state);\n    this.updateAssistantStatus(assistantId, status);\n\n    this.notifyUpdate();\n  }\n\n  // --- Message helpers ---\n\n  private insertAssistantPlaceholder(parentId: string): string {\n    const id = generateId();\n    const assistant: ThreadAssistantMessage = {\n      id,\n      role: \"assistant\",\n      createdAt: new Date(),\n      status: { type: \"running\" },\n      content: [],\n      metadata: {\n        unstable_state: null,\n        unstable_annotations: [],\n        unstable_data: [],\n        steps: [],\n        custom: {},\n      },\n    };\n    this.session.addOrUpdateMessage(parentId, assistant);\n    this.session.switchToBranch(id);\n    this.notifyUpdate();\n    return id;\n  }\n\n  private updateAssistantContent(\n    messageId: string,\n    content: ThreadAssistantMessage[\"content\"],\n  ) {\n    this.session.updateMessage(messageId, (message) => {\n      if (message.role !== \"assistant\") return message;\n      return { ...message, content };\n    });\n  }\n\n  private updateAssistantStatus(messageId: string, status: MessageStatus) {\n    const touched = this.session.updateMessage(messageId, (message) => {\n      if (message.role !== \"assistant\") return message;\n      return { ...message, status };\n    });\n    if (touched) {\n      this.notifyUpdate();\n      if (status.type === \"complete\" || status.type === \"incomplete\") {\n        this.persistAssistantHistory(messageId);\n      }\n    }\n  }\n\n  private getAssistantStatus(messageId: string): MessageStatus | undefined {\n    const msg = this.session.tryGetMessage(messageId)?.message;\n    if (msg?.role !== \"assistant\") return undefined;\n    return msg.status;\n  }\n\n  // --- Lifecycle helpers ---\n\n  private setRunning(running: boolean) {\n    this.isRunningFlag = running;\n    this.notifyUpdate();\n  }\n\n  private finishRun(controller: AbortController | null) {\n    if (this.abortController !== controller) return;\n    this.abortController = null;\n    this.setRunning(false);\n  }\n\n  // --- History persistence ---\n\n  private recordHistoryEntry(parentId: string | null, message: ThreadMessage) {\n    this.appendHistoryItem(parentId, message);\n  }\n\n  private markPendingAssistantHistory(\n    messageId: string,\n    parentId: string | null,\n  ) {\n    if (!this.history) return;\n    this.assistantHistoryParents.set(messageId, parentId);\n  }\n\n  private persistAssistantHistory(messageId: string) {\n    if (!this.history) return;\n    const parentId = this.assistantHistoryParents.get(messageId);\n    if (parentId === undefined) return;\n    const message = this.session.tryGetMessage(messageId)?.message;\n    if (!message || message.role !== \"assistant\") return;\n    if (\n      message.status?.type !== \"complete\" &&\n      message.status?.type !== \"incomplete\"\n    )\n      return;\n    this.assistantHistoryParents.delete(messageId);\n    this.appendHistoryItem(parentId, message);\n  }\n\n  private appendHistoryItem(parentId: string | null, message: ThreadMessage) {\n    if (!this.history || this.recordedHistoryIds.has(message.id)) return;\n    this.recordedHistoryIds.add(message.id);\n    void this.history.append({ parentId, message }).catch(() => {\n      this.recordedHistoryIds.delete(message.id);\n    });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"A2AThreadRuntimeCore.js","names":[],"sources":["../src/A2AThreadRuntimeCore.ts"],"sourcesContent":["\"use client\";\n\nimport { generateId, fromThreadMessageLike } from \"@assistant-ui/core\";\nimport type {\n  AppendMessage,\n  AssistantRuntime,\n  ExportedMessageRepository,\n  MessageStatus,\n  ThreadAssistantMessage,\n  ThreadHistoryAdapter,\n  ThreadMessage,\n} from \"@assistant-ui/core\";\nimport {\n  createMessageRepositorySession,\n  invokeUserCallback,\n} from \"@assistant-ui/core/internal\";\nimport type { A2AClient } from \"./A2AClient\";\nimport type {\n  A2AArtifact,\n  A2AAgentCard,\n  A2AMessage,\n  A2ASendMessageConfiguration,\n  A2AStreamEvent,\n  A2ATask,\n  A2ATaskArtifactUpdateEvent,\n  A2ATaskStatusUpdateEvent,\n} from \"./types\";\n\nimport {\n  a2aMessageToContent,\n  isTerminalTaskState,\n  threadMessageToA2AMessage,\n  taskStateToMessageStatus,\n} from \"./conversions\";\n\nconst INITIAL_AGENT_CARD_RETRY_DELAY_MS = 5_000;\nconst MAX_AGENT_CARD_RETRY_DELAY_MS = 5 * 60_000;\n\nexport type A2AThreadRuntimeCoreOptions = {\n  client: A2AClient;\n  contextId?: string | undefined;\n  configuration?: A2ASendMessageConfiguration | undefined;\n  onError?: ((error: Error) => void) | undefined;\n  onCancel?: (() => void) | undefined;\n  onArtifactComplete?: ((artifact: A2AArtifact) => void) | undefined;\n  history?: ThreadHistoryAdapter | undefined;\n  notifyUpdate: () => void;\n};\n\nconst FALLBACK_USER_STATUS = {\n  type: \"complete\",\n  reason: \"unknown\",\n} as const;\n\ntype A2ARuntimeCallbackName = \"onError\" | \"onCancel\" | \"onArtifactComplete\";\n\nconst invokeRuntimeCallback = <TArgs extends readonly unknown[]>(\n  name: A2ARuntimeCallbackName,\n  callback: ((...args: TArgs) => unknown) | undefined,\n  ...args: TArgs\n): void => {\n  void invokeUserCallback(\"react-a2a\", name, callback, ...args);\n};\n\nfunction normalizeArtifact(artifact: A2AArtifact): A2AArtifact {\n  return {\n    ...artifact,\n    parts: Array.isArray(artifact.parts) ? artifact.parts : [],\n  };\n}\n\nexport class A2AThreadRuntimeCore {\n  private client: A2AClient;\n  private contextId: string | undefined;\n  private configuration: A2ASendMessageConfiguration | undefined;\n  private onError: ((error: Error) => void) | undefined;\n  private onCancel: (() => void) | undefined;\n  private onArtifactComplete: ((artifact: A2AArtifact) => void) | undefined;\n  private history: ThreadHistoryAdapter | undefined;\n  private readonly notifyUpdate: () => void;\n\n  private runtime: AssistantRuntime | undefined;\n  private readonly session = createMessageRepositorySession();\n  private isRunningFlag = false;\n  private abortController: AbortController | null = null;\n  private pendingError: Error | null = null;\n\n  // A2A-specific state\n  private currentTask: A2ATask | undefined;\n  private currentArtifacts: A2AArtifact[] = [];\n  private agentCardValue: A2AAgentCard | undefined;\n\n  // History tracking\n  private readonly assistantHistoryParents = new Map<string, string | null>();\n  private readonly recordedHistoryIds = new Set<string>();\n  private _isLoading = false;\n  private _loadPromise: Promise<void> | undefined;\n  private _loadRequested = false;\n  private _agentCardPromise: Promise<void> | undefined;\n  private _agentCardRetryAfter = 0;\n  private _agentCardRetryDelay = INITIAL_AGENT_CARD_RETRY_DELAY_MS;\n  private _agentCardDiscoveryFailed = false;\n\n  private lastOptionsContextId: string | undefined;\n\n  constructor(options: A2AThreadRuntimeCoreOptions) {\n    this.client = options.client;\n    this.contextId = options.contextId;\n    this.lastOptionsContextId = options.contextId;\n    this.configuration = options.configuration;\n    this.onError = options.onError;\n    this.onCancel = options.onCancel;\n    this.onArtifactComplete = options.onArtifactComplete;\n    this.history = options.history;\n    this.notifyUpdate = options.notifyUpdate;\n  }\n\n  updateOptions(options: Omit<A2AThreadRuntimeCoreOptions, \"notifyUpdate\">) {\n    this.client = options.client;\n    // The hook re-applies options on every render, including renders caused\n    // by this core's own notifyUpdate. The option only seeds the context: a\n    // re-render with the same value must not clobber a server-assigned\n    // contextId learned from the stream.\n    if (options.contextId !== this.lastOptionsContextId) {\n      this.contextId = options.contextId;\n      this.lastOptionsContextId = options.contextId;\n    }\n    this.configuration = options.configuration;\n    this.onError = options.onError;\n    this.onCancel = options.onCancel;\n    this.onArtifactComplete = options.onArtifactComplete;\n    const previousHistory = this.history;\n    this.history = options.history;\n\n    if (\n      this._loadRequested &&\n      !this._loadPromise &&\n      !previousHistory &&\n      options.history &&\n      this.session.getMessages().length === 0\n    ) {\n      void this.__internal_load();\n    }\n  }\n\n  /** Thread-boundary reset: applyExternalMessages alone also serves branch\n   * switches, deletes, and cancel resyncs, which must keep the live context. */\n  resetContext(): void {\n    // Restore the seed before aborting: an onCancel callback that starts a\n    // new run must not pick up the old thread's context, and its controller\n    // must not be discarded.\n    const controller = this.abortController;\n    this.contextId = this.lastOptionsContextId;\n    if (controller) {\n      controller.abort();\n      if (this.abortController === controller) {\n        this.abortController = null;\n      }\n    }\n  }\n\n  attachRuntime(runtime: AssistantRuntime) {\n    this.runtime = runtime;\n  }\n\n  detachRuntime() {\n    this.runtime = undefined;\n    // Abort in-flight requests on unmount\n    if (this.abortController) {\n      this.abortController.abort();\n      this.abortController = null;\n    }\n  }\n\n  getRuntime(): AssistantRuntime | undefined {\n    return this.runtime;\n  }\n\n  getMessages(): readonly ThreadMessage[] {\n    return this.session.getMessages();\n  }\n\n  getMessageRepository(): ExportedMessageRepository {\n    return this.session.export();\n  }\n\n  getTask(): A2ATask | undefined {\n    return this.currentTask;\n  }\n\n  getArtifacts(): readonly A2AArtifact[] {\n    return this.currentArtifacts;\n  }\n\n  getAgentCard(): A2AAgentCard | undefined {\n    return this.agentCardValue;\n  }\n\n  isRunning(): boolean {\n    return this.isRunningFlag;\n  }\n\n  get isLoading(): boolean {\n    return this._isLoading;\n  }\n\n  private loadAgentCard(): Promise<void> {\n    if (Date.now() < this._agentCardRetryAfter) return Promise.resolve();\n\n    this._agentCardPromise ??= this.client.getAgentCard().then(\n      (agentCard) => {\n        this.agentCardValue = agentCard;\n        this._agentCardRetryAfter = 0;\n        this._agentCardRetryDelay = INITIAL_AGENT_CARD_RETRY_DELAY_MS;\n        this._agentCardDiscoveryFailed = false;\n        this.notifyUpdate();\n      },\n      () => {\n        this._agentCardDiscoveryFailed = true;\n        this._agentCardRetryAfter = Date.now() + this._agentCardRetryDelay;\n        this._agentCardRetryDelay = Math.min(\n          this._agentCardRetryDelay * 2,\n          MAX_AGENT_CARD_RETRY_DELAY_MS,\n        );\n        this._agentCardPromise = undefined;\n      },\n    );\n    return this._agentCardPromise;\n  }\n\n  private async waitForAgentCard(signal: AbortSignal): Promise<boolean> {\n    const shouldWait = !this._agentCardDiscoveryFailed;\n    const load = this.loadAgentCard();\n    if (signal.aborted) return false;\n    if (!shouldWait) return true;\n\n    let onAbort!: () => void;\n    const abort = new Promise<void>((resolve) => {\n      onAbort = resolve;\n      signal.addEventListener(\"abort\", onAbort, { once: true });\n    });\n\n    try {\n      await Promise.race([load, abort]);\n    } finally {\n      signal.removeEventListener(\"abort\", onAbort);\n    }\n    return !signal.aborted;\n  }\n\n  __internal_load(): Promise<void> {\n    this._loadRequested = true;\n    const agentCardPromise = this.loadAgentCard();\n\n    if (this._loadPromise) return this._loadPromise;\n    if (!this.history) return agentCardPromise;\n\n    this._isLoading = true;\n\n    const historyPromise = this.history.load();\n\n    this._loadPromise = Promise.all([historyPromise, agentCardPromise])\n      .then(([repo]) => {\n        if (repo) {\n          this.session.applyExternalMessageRepository(repo);\n          this.finalizeExternalApply();\n        }\n      })\n      .catch((error) => {\n        invokeRuntimeCallback(\n          \"onError\",\n          this.onError,\n          error instanceof Error ? error : new Error(String(error)),\n        );\n      })\n      .finally(() => {\n        this._isLoading = false;\n        this.notifyUpdate();\n      });\n\n    this.notifyUpdate();\n    return this._loadPromise;\n  }\n\n  async append(message: AppendMessage): Promise<void> {\n    const startRun = message.startRun ?? message.role === \"user\";\n\n    const threadMessage = fromThreadMessageLike(\n      message as any,\n      generateId(),\n      FALLBACK_USER_STATUS,\n    );\n    const parentId =\n      message.parentId === null\n        ? null\n        : message.parentId && this.session.hasMessage(message.parentId)\n          ? message.parentId\n          : this.session.headId;\n    this.session.addOrUpdateMessage(parentId, threadMessage);\n    this.session.switchToBranch(threadMessage.id);\n    this.notifyUpdate();\n    this.recordHistoryEntry(parentId, threadMessage);\n\n    if (!startRun) return;\n    await this.startRun(threadMessage);\n  }\n\n  async edit(message: AppendMessage): Promise<void> {\n    await this.append(message);\n  }\n\n  async reload(\n    parentId: string | null,\n    _config: { runConfig?: Record<string, unknown> } = {},\n  ): Promise<void> {\n    const messages =\n      parentId === null\n        ? []\n        : (this.session.tryGetMessages(parentId) ?? this.getMessages());\n    for (let i = messages.length - 1; i >= 0; i--) {\n      if (messages[i]!.role === \"user\") {\n        await this.startRun(messages[i]!);\n        return;\n      }\n    }\n  }\n\n  async cancel(): Promise<void> {\n    if (!this.abortController) return;\n\n    // Abort locally first so the stream stops immediately\n    this.abortController.abort();\n\n    // Then try to cancel the task on the server\n    if (this.currentTask?.id) {\n      try {\n        const updated = await this.client.cancelTask(this.currentTask.id);\n        this.currentTask = updated;\n      } catch {\n        // Server cancel failed; local abort already handled\n      }\n    }\n  }\n\n  private appendLinearChain(messages: readonly ThreadMessage[]): string | null {\n    let parentId: string | null = null;\n    let lastId: string | null = null;\n    const seen = new Set<string>();\n\n    for (const message of messages) {\n      if (seen.has(message.id)) continue;\n      seen.add(message.id);\n      this.session.addOrUpdateMessage(parentId, message);\n      parentId = message.id;\n      lastId = message.id;\n    }\n\n    return lastId;\n  }\n\n  private finalizeExternalApply(): void {\n    this.assistantHistoryParents.clear();\n    this.recordedHistoryIds.clear();\n    for (const { message } of this.getMessageRepository().messages) {\n      this.recordedHistoryIds.add(message.id);\n    }\n    this.currentTask = undefined;\n    this.currentArtifacts = [];\n    this.notifyUpdate();\n  }\n\n  applyExternalMessages(messages: readonly ThreadMessage[]): void {\n    if (messages.length === 0) {\n      this.session.clear();\n    } else {\n      let expectedParentId: string | null = null;\n      let lastAppliedId: string | null = null;\n      let hardReplace = false;\n      const seen = new Set<string>();\n\n      for (const message of messages) {\n        if (seen.has(message.id)) continue;\n        seen.add(message.id);\n        const existing = this.session.tryGetMessage(message.id);\n        if (existing && existing.parentId !== expectedParentId) {\n          hardReplace = true;\n          break;\n        }\n        this.session.addOrUpdateMessage(expectedParentId, message);\n        expectedParentId = message.id;\n        lastAppliedId = message.id;\n      }\n\n      if (hardReplace) {\n        this.session.clear();\n        lastAppliedId = this.appendLinearChain(messages);\n      }\n\n      this.session.resetHead(lastAppliedId);\n    }\n\n    this.finalizeExternalApply();\n  }\n\n  // --- Run logic ---\n\n  private async startRun(userThreadMessage: ThreadMessage): Promise<void> {\n    // Cancel any in-progress run before starting a new one\n    if (this.abortController) {\n      this.abortController.abort();\n      this.abortController = null;\n    }\n\n    const a2aMessage = threadMessageToA2AMessage(userThreadMessage, {\n      contextId: this.contextId,\n      taskId:\n        this.currentTask?.id &&\n        !isTerminalTaskState(this.currentTask.status.state)\n          ? this.currentTask.id\n          : undefined,\n    });\n\n    // Clear task if previous task reached terminal state\n    if (\n      this.currentTask &&\n      isTerminalTaskState(this.currentTask.status.state)\n    ) {\n      this.currentTask = undefined;\n    }\n\n    this.currentArtifacts = [];\n\n    const assistantParentId = userThreadMessage.id;\n    const assistantId = this.insertAssistantPlaceholder(assistantParentId);\n    this.markPendingAssistantHistory(assistantId, assistantParentId);\n\n    const abortController = new AbortController();\n    this.abortController = abortController;\n\n    abortController.signal.addEventListener(\n      \"abort\",\n      () => {\n        this.updateAssistantStatus(assistantId, {\n          type: \"incomplete\",\n          reason: \"cancelled\",\n        });\n        this.finishRun(abortController);\n        invokeRuntimeCallback(\"onCancel\", this.onCancel);\n      },\n      { once: true },\n    );\n\n    this.setRunning(true);\n\n    try {\n      if (!(await this.waitForAgentCard(abortController.signal))) return;\n\n      const supportsStreaming =\n        this.agentCardValue?.capabilities?.streaming !== false;\n      if (supportsStreaming) {\n        await this.runStreaming(a2aMessage, assistantId, abortController);\n      } else {\n        await this.runSync(a2aMessage, assistantId, abortController);\n      }\n    } catch (error) {\n      if (!abortController.signal.aborted) {\n        const err = error instanceof Error ? error : new Error(String(error));\n        this.updateAssistantStatus(assistantId, {\n          type: \"incomplete\",\n          reason: \"error\",\n        });\n        invokeRuntimeCallback(\"onError\", this.onError, err);\n        this.pendingError = this.pendingError ?? err;\n      }\n    } finally {\n      this.finishRun(abortController);\n    }\n\n    if (this.pendingError) {\n      const err = this.pendingError;\n      this.pendingError = null;\n      throw err;\n    }\n  }\n\n  private async runStreaming(\n    a2aMessage: A2AMessage,\n    assistantId: string,\n    abortController: AbortController,\n  ): Promise<void> {\n    const stream = this.client.streamMessage(\n      a2aMessage,\n      this.configuration,\n      undefined, // metadata\n      abortController.signal,\n    );\n\n    let receivedEvent = false;\n    let skipReason: string | undefined;\n    const diagnosedStream = (async function* () {\n      const reason = yield* stream;\n      if (typeof reason === \"string\") skipReason = reason;\n    })();\n\n    for await (const event of diagnosedStream) {\n      if (abortController.signal.aborted) break;\n      receivedEvent = true;\n      this.handleStreamEvent(assistantId, event);\n    }\n\n    if (!abortController.signal.aborted) {\n      if (!receivedEvent) {\n        throw new Error(\n          skipReason\n            ? `A2A message stream ended without any events. First skipped frame: ${skipReason}`\n            : \"A2A message stream ended without any events.\",\n        );\n      }\n\n      const lastStatus = this.getAssistantStatus(assistantId);\n      if (lastStatus?.type === \"running\") {\n        this.updateAssistantStatus(assistantId, {\n          type: \"complete\",\n          reason: \"stop\",\n        });\n      }\n    }\n  }\n\n  private async runSync(\n    a2aMessage: A2AMessage,\n    assistantId: string,\n    abortController: AbortController,\n  ): Promise<void> {\n    const result = await this.client.sendMessage(\n      a2aMessage,\n      this.configuration,\n      undefined, // metadata\n      abortController.signal,\n    );\n\n    if (abortController.signal.aborted) return;\n\n    // Result is either A2ATask or A2AMessage\n    if (\"id\" in result && \"status\" in result) {\n      // It's a Task\n      this.handleTaskSnapshot(assistantId, result as A2ATask);\n    } else if (\"messageId\" in result && \"parts\" in result) {\n      // It's a Message\n      this.handleMessage(assistantId, result as A2AMessage);\n      this.updateAssistantStatus(assistantId, {\n        type: \"complete\",\n        reason: \"stop\",\n      });\n    }\n  }\n\n  private handleStreamEvent(assistantId: string, event: A2AStreamEvent) {\n    switch (event.type) {\n      case \"statusUpdate\":\n        this.handleStatusUpdate(assistantId, event.event);\n        break;\n      case \"artifactUpdate\":\n        this.handleArtifactUpdate(event.event);\n        break;\n      case \"message\":\n        this.handleMessage(assistantId, event.message);\n        break;\n      case \"task\":\n        this.handleTaskSnapshot(assistantId, event.task);\n        break;\n    }\n  }\n\n  private handleStatusUpdate(\n    assistantId: string,\n    event: A2ATaskStatusUpdateEvent,\n  ) {\n    if (!this.currentTask) {\n      this.currentTask = {\n        id: event.taskId,\n        contextId: event.contextId,\n        status: event.status,\n      };\n    } else {\n      this.currentTask = { ...this.currentTask, status: event.status };\n    }\n\n    if (event.contextId) {\n      this.contextId = event.contextId;\n    }\n\n    if (event.status.message) {\n      const content = a2aMessageToContent(event.status.message);\n      this.updateAssistantContent(assistantId, content);\n    }\n\n    const status = taskStateToMessageStatus(event.status.state);\n    this.updateAssistantStatus(assistantId, status);\n\n    this.notifyUpdate();\n  }\n\n  private handleArtifactUpdate(event: A2ATaskArtifactUpdateEvent) {\n    const { append, lastChunk } = event;\n    const artifact = normalizeArtifact(event.artifact);\n    const existingIdx = this.currentArtifacts.findIndex(\n      (a) => a.artifactId === artifact.artifactId,\n    );\n\n    let updated: A2AArtifact;\n    if (existingIdx >= 0 && append) {\n      const existing = this.currentArtifacts[existingIdx]!;\n      updated = {\n        ...existing,\n        parts: [...existing.parts, ...artifact.parts],\n      };\n      this.currentArtifacts = [\n        ...this.currentArtifacts.slice(0, existingIdx),\n        updated,\n        ...this.currentArtifacts.slice(existingIdx + 1),\n      ];\n    } else if (existingIdx >= 0) {\n      updated = artifact;\n      this.currentArtifacts = [\n        ...this.currentArtifacts.slice(0, existingIdx),\n        updated,\n        ...this.currentArtifacts.slice(existingIdx + 1),\n      ];\n    } else {\n      updated = artifact;\n      this.currentArtifacts = [...this.currentArtifacts, updated];\n    }\n\n    if (lastChunk) {\n      invokeRuntimeCallback(\n        \"onArtifactComplete\",\n        this.onArtifactComplete,\n        updated,\n      );\n    }\n\n    this.notifyUpdate();\n  }\n\n  private handleMessage(assistantId: string, message: A2AMessage) {\n    if (message.role !== \"agent\") return;\n\n    const content = a2aMessageToContent(message);\n    this.updateAssistantContent(assistantId, content);\n    this.notifyUpdate();\n  }\n\n  private handleTaskSnapshot(assistantId: string, task: A2ATask) {\n    const artifacts =\n      task.artifacts === undefined\n        ? undefined\n        : Array.isArray(task.artifacts)\n          ? task.artifacts.map(normalizeArtifact)\n          : [];\n    const history =\n      task.history === undefined\n        ? undefined\n        : Array.isArray(task.history)\n          ? task.history\n          : [];\n    this.currentTask = {\n      ...task,\n      ...(artifacts === undefined ? {} : { artifacts }),\n      ...(history === undefined ? {} : { history }),\n    };\n\n    if (task.contextId) {\n      this.contextId = task.contextId;\n    }\n    if (artifacts) {\n      this.currentArtifacts = artifacts;\n    }\n\n    if (task.status.message) {\n      const content = a2aMessageToContent(task.status.message);\n      this.updateAssistantContent(assistantId, content);\n    }\n\n    const status = taskStateToMessageStatus(task.status.state);\n    this.updateAssistantStatus(assistantId, status);\n\n    this.notifyUpdate();\n  }\n\n  // --- Message helpers ---\n\n  private insertAssistantPlaceholder(parentId: string): string {\n    const id = generateId();\n    const assistant: ThreadAssistantMessage = {\n      id,\n      role: \"assistant\",\n      createdAt: new Date(),\n      status: { type: \"running\" },\n      content: [],\n      metadata: {\n        unstable_state: null,\n        unstable_annotations: [],\n        unstable_data: [],\n        steps: [],\n        custom: {},\n      },\n    };\n    this.session.addOrUpdateMessage(parentId, assistant);\n    this.session.switchToBranch(id);\n    this.notifyUpdate();\n    return id;\n  }\n\n  private updateAssistantContent(\n    messageId: string,\n    content: ThreadAssistantMessage[\"content\"],\n  ) {\n    this.session.updateMessage(messageId, (message) => {\n      if (message.role !== \"assistant\") return message;\n      return { ...message, content };\n    });\n  }\n\n  private updateAssistantStatus(messageId: string, status: MessageStatus) {\n    const touched = this.session.updateMessage(messageId, (message) => {\n      if (message.role !== \"assistant\") return message;\n      return { ...message, status };\n    });\n    if (touched) {\n      this.notifyUpdate();\n      if (status.type === \"complete\" || status.type === \"incomplete\") {\n        this.persistAssistantHistory(messageId);\n      }\n    }\n  }\n\n  private getAssistantStatus(messageId: string): MessageStatus | undefined {\n    const msg = this.session.tryGetMessage(messageId)?.message;\n    if (msg?.role !== \"assistant\") return undefined;\n    return msg.status;\n  }\n\n  // --- Lifecycle helpers ---\n\n  private setRunning(running: boolean) {\n    this.isRunningFlag = running;\n    this.notifyUpdate();\n  }\n\n  private finishRun(controller: AbortController | null) {\n    if (this.abortController !== controller) return;\n    this.abortController = null;\n    this.setRunning(false);\n  }\n\n  // --- History persistence ---\n\n  private recordHistoryEntry(parentId: string | null, message: ThreadMessage) {\n    this.appendHistoryItem(parentId, message);\n  }\n\n  private markPendingAssistantHistory(\n    messageId: string,\n    parentId: string | null,\n  ) {\n    if (!this.history) return;\n    this.assistantHistoryParents.set(messageId, parentId);\n  }\n\n  private persistAssistantHistory(messageId: string) {\n    if (!this.history) return;\n    const parentId = this.assistantHistoryParents.get(messageId);\n    if (parentId === undefined) return;\n    const message = this.session.tryGetMessage(messageId)?.message;\n    if (!message || message.role !== \"assistant\") return;\n    if (\n      message.status?.type !== \"complete\" &&\n      message.status?.type !== \"incomplete\"\n    )\n      return;\n    this.assistantHistoryParents.delete(messageId);\n    this.appendHistoryItem(parentId, message);\n  }\n\n  private appendHistoryItem(parentId: string | null, message: ThreadMessage) {\n    if (!this.history || this.recordedHistoryIds.has(message.id)) return;\n    this.recordedHistoryIds.add(message.id);\n    void this.history.append({ parentId, message }).catch(() => {\n      this.recordedHistoryIds.delete(message.id);\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/useA2ARuntime.js

@@ -64,18 +64,23 @@ function useA2ARuntime(options) {
 	useEffect(() => {
 		core.updateOptions(coreOptions);
 	});
+	const threadSwitchGenerationRef = useRef(0);
 	const threadList = useMemo(() => {
 		if (!threadListAdapter) return void 0;
 		const { onSwitchToNewThread, onSwitchToThread } = threadListAdapter;
 		return {
 			threadId: threadListAdapter.threadId,
 			onSwitchToNewThread: onSwitchToNewThread ? async () => {
+				const generation = ++threadSwitchGenerationRef.current;
 				await onSwitchToNewThread();
+				if (generation !== threadSwitchGenerationRef.current) return;
 				core.applyExternalMessages([]);
 				core.resetContext();
 			} : void 0,
 			onSwitchToThread: onSwitchToThread ? async (threadId) => {
+				const generation = ++threadSwitchGenerationRef.current;
 				const result = await onSwitchToThread(threadId);
+				if (generation !== threadSwitchGenerationRef.current) return;
 				core.applyExternalMessages(result.messages);
 				core.resetContext();
 			} : void 0

package/dist/useA2ARuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"useA2ARuntime.js","names":[],"sources":["../src/useA2ARuntime.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  useCallback,\n  useEffect,\n  useInsertionEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport {\n  useExternalStoreRuntime,\n  useExternalStoreSharedOptions,\n  useRuntimeAdapters,\n} from \"@assistant-ui/core/react\";\nimport type {\n  AssistantRuntime,\n  AppendMessage,\n  ExternalStoreAdapter,\n  ThreadMessage,\n} from \"@assistant-ui/core\";\nimport { A2AClient, type A2AClientOptions } from \"./A2AClient\";\nimport { A2AThreadRuntimeCore } from \"./A2AThreadRuntimeCore\";\nimport { a2aExtras } from \"./a2aExtras\";\nimport type { UseA2ARuntimeOptions } from \"./types\";\n\ntype ManagedA2AClientOptions = Omit<A2AClientOptions, \"headers\">;\n\nconst serializeManagedClientOptions = (\n  options: ManagedA2AClientOptions,\n): string => {\n  const fetchOptions = Object.fromEntries(\n    Object.entries(options.fetchOptions ?? {}).sort(([a], [b]) =>\n      a.localeCompare(b),\n    ),\n  );\n\n  return JSON.stringify({\n    ...options,\n    fetchOptions,\n  });\n};\n\nexport function useA2ARuntime(options: UseA2ARuntimeOptions): AssistantRuntime {\n  const [_version, setVersion] = useState(0);\n  const notifyUpdate = useCallback(() => setVersion((v) => v + 1), []);\n  const runtimeAdapters = useRuntimeAdapters();\n  const historyAdapter = options.adapters?.history ?? runtimeAdapters?.history;\n  const threadListAdapter = options.adapters?.threadList;\n\n  const headersRef = useRef(options.headers);\n  useInsertionEffect(() => {\n    headersRef.current = options.headers;\n  });\n  const resolveHeaders = useCallback(() => {\n    const headers = headersRef.current;\n    return typeof headers === \"function\" ? headers() : (headers ?? {});\n  }, []);\n\n  const managedClientOptionsKey = options.client\n    ? null\n    : options.baseUrl\n      ? serializeManagedClientOptions({\n          baseUrl: options.baseUrl,\n          basePath: options.basePath,\n          tenant: options.tenant,\n          extensions: options.extensions,\n          fetchOptions: options.fetchOptions,\n        })\n      : null;\n\n  const client = useMemo(() => {\n    if (options.client) return options.client;\n    if (!managedClientOptionsKey) {\n      throw new Error(\"useA2ARuntime requires either `client` or `baseUrl`\");\n    }\n\n    return new A2AClient({\n      ...(JSON.parse(managedClientOptionsKey) as ManagedA2AClientOptions),\n      headers: resolveHeaders,\n    });\n  }, [managedClientOptionsKey, options.client, resolveHeaders]);\n\n  const coreOptions = {\n    client,\n    contextId: options.contextId,\n    configuration: options.configuration,\n    ...(options.onError && { onError: options.onError }),\n    ...(options.onCancel && { onCancel: options.onCancel }),\n    ...(options.onArtifactComplete && {\n      onArtifactComplete: options.onArtifactComplete,\n    }),\n    ...(historyAdapter && { history: historyAdapter }),\n  };\n  const coreOptionsRef = useRef(coreOptions);\n  coreOptionsRef.current = coreOptions;\n\n  const core = useMemo(\n    () =>\n      new A2AThreadRuntimeCore({\n        ...coreOptionsRef.current,\n        client,\n        notifyUpdate,\n      }),\n    [client, notifyUpdate],\n  );\n\n  useEffect(() => {\n    core.updateOptions(coreOptions);\n  });\n\n  // Thread list\n  const threadList = useMemo(() => {\n    if (!threadListAdapter) return undefined;\n\n    const { onSwitchToNewThread, onSwitchToThread } = threadListAdapter;\n\n    return {\n      threadId: threadListAdapter.threadId,\n      onSwitchToNewThread: onSwitchToNewThread\n        ? async () => {\n            await onSwitchToNewThread();\n            // Apply first so the abort inside resetContext finds an already\n            // cleared repository and cannot persist the old thread's partial\n            // assistant message.\n            core.applyExternalMessages([]);\n            core.resetContext();\n          }\n        : undefined,\n      onSwitchToThread: onSwitchToThread\n        ? async (threadId: string) => {\n            const result = await onSwitchToThread(threadId);\n            core.applyExternalMessages(result.messages);\n            core.resetContext();\n          }\n        : undefined,\n    };\n  }, [threadListAdapter, core]);\n\n  // Adapters\n  const adapters = options.adapters;\n  const adapterAdapters = useMemo(\n    () => ({\n      attachments: adapters?.attachments ?? runtimeAdapters?.attachments,\n      speech: adapters?.speech,\n      dictation: adapters?.dictation,\n      voice: adapters?.voice,\n      feedback: adapters?.feedback,\n      threadList,\n    }),\n    [adapters, runtimeAdapters, threadList],\n  );\n\n  // Build store adapter\n  const shared = useExternalStoreSharedOptions(options);\n  const store = useMemo(() => {\n    void _version;\n\n    return {\n      ...shared,\n      isLoading: core.isLoading,\n      messageRepository: core.getMessageRepository(),\n      isRunning: core.isRunning(),\n      extras: a2aExtras.provide({\n        task: core.getTask(),\n        artifacts: core.getArtifacts(),\n        agentCard: core.getAgentCard(),\n      }),\n      onNew: (message: AppendMessage) => core.append(message),\n      onEdit: (message: AppendMessage) => core.edit(message),\n      onReload: (parentId: string | null) => core.reload(parentId),\n      onCancel: () => core.cancel(),\n      setMessages: (messages: readonly ThreadMessage[]) =>\n        core.applyExternalMessages(messages),\n      onImport: (messages: readonly ThreadMessage[]) =>\n        core.applyExternalMessages(messages),\n      adapters: adapterAdapters,\n    } satisfies ExternalStoreAdapter<ThreadMessage>;\n  }, [adapterAdapters, core, _version, shared]);\n\n  const runtime = useExternalStoreRuntime(store);\n\n  useEffect(() => {\n    core.attachRuntime(runtime);\n    return () => {\n      core.detachRuntime();\n    };\n  }, [core, runtime]);\n\n  useEffect(() => {\n    core.__internal_load();\n  }, [core]);\n\n  return runtime;\n}\n"],"mappings":"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"}
+{"version":3,"file":"useA2ARuntime.js","names":[],"sources":["../src/useA2ARuntime.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  useCallback,\n  useEffect,\n  useInsertionEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport {\n  useExternalStoreRuntime,\n  useExternalStoreSharedOptions,\n  useRuntimeAdapters,\n} from \"@assistant-ui/core/react\";\nimport type {\n  AssistantRuntime,\n  AppendMessage,\n  ExternalStoreAdapter,\n  ThreadMessage,\n} from \"@assistant-ui/core\";\nimport { A2AClient, type A2AClientOptions } from \"./A2AClient\";\nimport { A2AThreadRuntimeCore } from \"./A2AThreadRuntimeCore\";\nimport { a2aExtras } from \"./a2aExtras\";\nimport type { UseA2ARuntimeOptions } from \"./types\";\n\ntype ManagedA2AClientOptions = Omit<A2AClientOptions, \"headers\">;\n\nconst serializeManagedClientOptions = (\n  options: ManagedA2AClientOptions,\n): string => {\n  const fetchOptions = Object.fromEntries(\n    Object.entries(options.fetchOptions ?? {}).sort(([a], [b]) =>\n      a.localeCompare(b),\n    ),\n  );\n\n  return JSON.stringify({\n    ...options,\n    fetchOptions,\n  });\n};\n\nexport function useA2ARuntime(options: UseA2ARuntimeOptions): AssistantRuntime {\n  const [_version, setVersion] = useState(0);\n  const notifyUpdate = useCallback(() => setVersion((v) => v + 1), []);\n  const runtimeAdapters = useRuntimeAdapters();\n  const historyAdapter = options.adapters?.history ?? runtimeAdapters?.history;\n  const threadListAdapter = options.adapters?.threadList;\n\n  const headersRef = useRef(options.headers);\n  useInsertionEffect(() => {\n    headersRef.current = options.headers;\n  });\n  const resolveHeaders = useCallback(() => {\n    const headers = headersRef.current;\n    return typeof headers === \"function\" ? headers() : (headers ?? {});\n  }, []);\n\n  const managedClientOptionsKey = options.client\n    ? null\n    : options.baseUrl\n      ? serializeManagedClientOptions({\n          baseUrl: options.baseUrl,\n          basePath: options.basePath,\n          tenant: options.tenant,\n          extensions: options.extensions,\n          fetchOptions: options.fetchOptions,\n        })\n      : null;\n\n  const client = useMemo(() => {\n    if (options.client) return options.client;\n    if (!managedClientOptionsKey) {\n      throw new Error(\"useA2ARuntime requires either `client` or `baseUrl`\");\n    }\n\n    return new A2AClient({\n      ...(JSON.parse(managedClientOptionsKey) as ManagedA2AClientOptions),\n      headers: resolveHeaders,\n    });\n  }, [managedClientOptionsKey, options.client, resolveHeaders]);\n\n  const coreOptions = {\n    client,\n    contextId: options.contextId,\n    configuration: options.configuration,\n    ...(options.onError && { onError: options.onError }),\n    ...(options.onCancel && { onCancel: options.onCancel }),\n    ...(options.onArtifactComplete && {\n      onArtifactComplete: options.onArtifactComplete,\n    }),\n    ...(historyAdapter && { history: historyAdapter }),\n  };\n  const coreOptionsRef = useRef(coreOptions);\n  coreOptionsRef.current = coreOptions;\n\n  const core = useMemo(\n    () =>\n      new A2AThreadRuntimeCore({\n        ...coreOptionsRef.current,\n        client,\n        notifyUpdate,\n      }),\n    [client, notifyUpdate],\n  );\n\n  useEffect(() => {\n    core.updateOptions(coreOptions);\n  });\n\n  // Thread list\n  const threadSwitchGenerationRef = useRef(0);\n  const threadList = useMemo(() => {\n    if (!threadListAdapter) return undefined;\n\n    const { onSwitchToNewThread, onSwitchToThread } = threadListAdapter;\n\n    return {\n      threadId: threadListAdapter.threadId,\n      onSwitchToNewThread: onSwitchToNewThread\n        ? async () => {\n            const generation = ++threadSwitchGenerationRef.current;\n            await onSwitchToNewThread();\n            if (generation !== threadSwitchGenerationRef.current) return;\n            // Apply first so the abort inside resetContext finds an already\n            // cleared repository and cannot persist the old thread's partial\n            // assistant message.\n            core.applyExternalMessages([]);\n            core.resetContext();\n          }\n        : undefined,\n      onSwitchToThread: onSwitchToThread\n        ? async (threadId: string) => {\n            const generation = ++threadSwitchGenerationRef.current;\n            const result = await onSwitchToThread(threadId);\n            if (generation !== threadSwitchGenerationRef.current) return;\n            core.applyExternalMessages(result.messages);\n            core.resetContext();\n          }\n        : undefined,\n    };\n  }, [threadListAdapter, core]);\n\n  // Adapters\n  const adapters = options.adapters;\n  const adapterAdapters = useMemo(\n    () => ({\n      attachments: adapters?.attachments ?? runtimeAdapters?.attachments,\n      speech: adapters?.speech,\n      dictation: adapters?.dictation,\n      voice: adapters?.voice,\n      feedback: adapters?.feedback,\n      threadList,\n    }),\n    [adapters, runtimeAdapters, threadList],\n  );\n\n  // Build store adapter\n  const shared = useExternalStoreSharedOptions(options);\n  const store = useMemo(() => {\n    void _version;\n\n    return {\n      ...shared,\n      isLoading: core.isLoading,\n      messageRepository: core.getMessageRepository(),\n      isRunning: core.isRunning(),\n      extras: a2aExtras.provide({\n        task: core.getTask(),\n        artifacts: core.getArtifacts(),\n        agentCard: core.getAgentCard(),\n      }),\n      onNew: (message: AppendMessage) => core.append(message),\n      onEdit: (message: AppendMessage) => core.edit(message),\n      onReload: (parentId: string | null) => core.reload(parentId),\n      onCancel: () => core.cancel(),\n      setMessages: (messages: readonly ThreadMessage[]) =>\n        core.applyExternalMessages(messages),\n      onImport: (messages: readonly ThreadMessage[]) =>\n        core.applyExternalMessages(messages),\n      adapters: adapterAdapters,\n    } satisfies ExternalStoreAdapter<ThreadMessage>;\n  }, [adapterAdapters, core, _version, shared]);\n\n  const runtime = useExternalStoreRuntime(store);\n\n  useEffect(() => {\n    core.attachRuntime(runtime);\n    return () => {\n      core.detachRuntime();\n    };\n  }, [core, runtime]);\n\n  useEffect(() => {\n    core.__internal_load();\n  }, [core]);\n\n  return runtime;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/react-a2a",
-  "version": "0.2.33",
+  "version": "0.2.35",
   "description": "A2A (Agent-to-Agent) v1.0 protocol adapter for assistant-ui",
   "keywords": [
     "a2a",
@@ -29,9 +29,9 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@assistant-ui/core": "^0.3.17",
-    "@assistant-ui/store": "^0.3.12",
-    "assistant-stream": "^0.3.41"
+    "@assistant-ui/core": "^0.3.19",
+    "@assistant-ui/store": "^0.3.13",
+    "assistant-stream": "^0.3.43"
   },
   "peerDependencies": {
     "@types/react": "*",
@@ -43,14 +43,14 @@
     }
   },
   "devDependencies": {
-    "@assistant-ui/x-buildutils": "0.0.25",
+    "@assistant-ui/x-buildutils": "0.0.27",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.3",
     "@types/react": "^19.2.18",
     "jsdom": "^30.0.1",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
-    "vitest": "^4.1.11"
+    "vitest": "^5.0.0"
   },
   "publishConfig": {
     "access": "public",

package/src/A2AClient.test.ts

@@ -479,6 +479,83 @@ describe("A2AClient", () => {
       );
     });
 
+    it.each([
+      ["text", { invalid: true }],
+      ["raw", 42],
+      ["url", false],
+      ["filename", []],
+      ["mediaType", {}],
+      ["metadata", []],
+    ])("rejects a message part with malformed %s", async (field, value) => {
+      fetchMock.mockResolvedValue(
+        mockFetchResponse({
+          message: {
+            messageId: "m2",
+            role: "agent",
+            parts: [{ [field]: value }],
+          },
+        }),
+      );
+
+      await expect(client.sendMessage(userMessage)).rejects.toThrow(
+        "Invalid A2A message:send response: expected a valid task or message payload.",
+      );
+    });
+
+    it("normalizes null optional message-part fields", async () => {
+      fetchMock.mockResolvedValue(
+        mockFetchResponse({
+          message: {
+            messageId: "m2",
+            role: "agent",
+            parts: [
+              {
+                text: null,
+                raw: null,
+                url: null,
+                data: null,
+                metadata: null,
+                filename: null,
+                mediaType: null,
+              },
+            ],
+          },
+        }),
+      );
+
+      const result = await client.sendMessage(userMessage);
+
+      expect((result as A2AMessage).parts).toEqual([{ data: null }]);
+    });
+
+    it.each([
+      [
+        "status message",
+        {
+          status: {
+            state: "completed",
+            message: { parts: [{ text: { invalid: true } }] },
+          },
+        },
+      ],
+      ["history message", { history: [{ parts: [{ raw: 42 }] }] }],
+      ["artifact", { artifacts: [{ parts: [{ metadata: [] }] }] }],
+    ])("rejects a task with malformed %s parts", async (_name, nested) => {
+      fetchMock.mockResolvedValue(
+        mockFetchResponse({
+          task: {
+            id: "t1",
+            status: { state: "completed" },
+            ...nested,
+          },
+        }),
+      );
+
+      await expect(client.sendMessage(userMessage)).rejects.toThrow(
+        "Invalid A2A message:send response: expected a valid task or message payload.",
+      );
+    });
+
     it.each([
       ["task", { id: "t1", status: { state: "completed" } }],
       [
@@ -1072,6 +1149,60 @@ describe("A2AClient", () => {
       }
     });
 
+    it("drops wrapped messages and artifact updates with malformed parts", async () => {
+      const frames = [
+        {
+          message: {
+            message_id: "m1",
+            role: "ROLE_AGENT",
+            parts: [{ text: { invalid: true } }],
+          },
+        },
+        {
+          artifact_update: {
+            task_id: "t1",
+            context_id: "c1",
+            artifact: {
+              artifact_id: "a1",
+              parts: [{ url: 42 }],
+            },
+          },
+        },
+        {
+          status_update: {
+            task_id: "t1",
+            context_id: "c1",
+            status: {
+              state: "TASK_STATE_WORKING",
+              message: { parts: [{ text: { invalid: true } }] },
+            },
+          },
+        },
+        {
+          task: {
+            id: "t1",
+            status: {
+              state: "TASK_STATE_WORKING",
+              message: { parts: [{ text: { invalid: true } }] },
+            },
+          },
+        },
+      ];
+
+      for (const frame of frames) {
+        fetchMock.mockResolvedValue(
+          mockSSEResponse([`data: ${JSON.stringify(frame)}`, "", ""]),
+        );
+
+        const events: A2AStreamEvent[] = [];
+        for await (const event of client.streamMessage(userMessage)) {
+          events.push(event);
+        }
+
+        expect(events).toEqual([]);
+      }
+    });
+
     it("drops a wrapped status update whose contextId is not a string", async () => {
       const sseData = JSON.stringify({
         status_update: {

package/src/A2AClient.ts

@@ -7,6 +7,7 @@ import type {
   A2AListTasksRequest,
   A2AListTasksResponse,
   A2AMessage,
+  A2APart,
   A2ARole,
   A2ASendMessageConfiguration,
   A2AStreamEvent,
@@ -69,6 +70,26 @@ const JSONRPC_STATE_MAP: Record<string, string> = {
   unknown: "unspecified",
 };
 
+const PART_STRING_FIELDS = [
+  "text",
+  "raw",
+  "url",
+  "filename",
+  "mediaType",
+] as const;
+
+const NULLABLE_PART_FIELDS = [...PART_STRING_FIELDS, "metadata"] as const;
+
+function normalizePartNulls(
+  part: Record<string, unknown>,
+): Record<string, unknown> {
+  const normalized = { ...part };
+  for (const field of NULLABLE_PART_FIELDS) {
+    if (normalized[field] === null) delete normalized[field];
+  }
+  return normalized;
+}
+
 // JSON-RPC file parts nest the payload under `file`; the internal A2APart is
 // flat, so the nested fields map onto url/raw/mediaType/filename.
 function normalizeParts(value: unknown[]): unknown[] {
@@ -76,8 +97,8 @@ function normalizeParts(value: unknown[]): unknown[] {
     const part = normalizeKeys(raw, false);
     if (part === null || typeof part !== "object" || Array.isArray(part))
       return part;
-    const record = part as Record<string, unknown>;
-    if (record.kind === undefined) return part;
+    const record = normalizePartNulls(part as Record<string, unknown>);
+    if (record.kind === undefined) return record;
     const { kind, ...rest } = record;
     const file = rest.file;
     if (kind !== "file" || file === null || typeof file !== "object")
@@ -86,10 +107,10 @@ function normalizeParts(value: unknown[]): unknown[] {
     const nested = file as Record<string, unknown>;
     return {
       ...others,
-      ...(nested.uri !== undefined ? { url: nested.uri } : {}),
-      ...(nested.bytes !== undefined ? { raw: nested.bytes } : {}),
-      ...(nested.mimeType !== undefined ? { mediaType: nested.mimeType } : {}),
-      ...(nested.name !== undefined ? { filename: nested.name } : {}),
+      ...(nested.uri != null ? { url: nested.uri } : {}),
+      ...(nested.bytes != null ? { raw: nested.bytes } : {}),
+      ...(nested.mimeType != null ? { mediaType: nested.mimeType } : {}),
+      ...(nested.name != null ? { filename: nested.name } : {}),
     };
   });
 }
@@ -272,13 +293,35 @@ const hasOptionalStringIds = (
 ): boolean =>
   keys.every((key) => value[key] == null || typeof value[key] === "string");
 
+const hasOptionalStringFields = (
+  value: Record<string, unknown>,
+  keys: readonly string[],
+): boolean =>
+  keys.every(
+    (key) => value[key] === undefined || typeof value[key] === "string",
+  );
+
+const isPart = (value: unknown): value is A2APart =>
+  isRecord(value) &&
+  hasOptionalStringFields(value, PART_STRING_FIELDS) &&
+  (value.metadata === undefined || isRecord(value.metadata));
+
+const hasValidNestedParts = (value: unknown): boolean =>
+  !isRecord(value) || !Array.isArray(value.parts) || value.parts.every(isPart);
+
+const hasValidNestedPartsInCollection = (value: unknown): boolean =>
+  !Array.isArray(value) || value.every(hasValidNestedParts);
+
 const isTask = (value: unknown): value is A2ATask =>
   isRecord(value) &&
   typeof value.id === "string" &&
   value.id.length > 0 &&
   hasOptionalStringIds(value, ["contextId"]) &&
   isRecord(value.status) &&
-  isTaskState(value.status.state);
+  isTaskState(value.status.state) &&
+  hasValidNestedParts(value.status.message) &&
+  hasValidNestedPartsInCollection(value.artifacts) &&
+  hasValidNestedPartsInCollection(value.history);
 
 const isMessage = (value: unknown): value is A2AMessage =>
   isRecord(value) &&
@@ -287,7 +330,7 @@ const isMessage = (value: unknown): value is A2AMessage =>
   hasOptionalStringIds(value, ["contextId", "taskId"]) &&
   isRole(value.role) &&
   Array.isArray(value.parts) &&
-  value.parts.every(isRecord);
+  value.parts.every(isPart);
 
 // Legacy wrappers use ProtoJSON, where omitted and null fields decode to proto
 // defaults. Normalize those defaults before enforcing semantic requirements.
@@ -346,7 +389,8 @@ const isStatusUpdate = (
   (allowEmptyTaskId || value.taskId.length > 0) &&
   hasOptionalStringIds(value, ["contextId"]) &&
   isRecord(value.status) &&
-  isTaskState(value.status.state);
+  isTaskState(value.status.state) &&
+  hasValidNestedParts(value.status.message);
 
 const toWrappedStatusUpdate = (
   value: unknown,
@@ -369,7 +413,7 @@ const isArtifact = (value: unknown): value is Record<string, unknown> =>
   isRecord(value) &&
   typeof value.artifactId === "string" &&
   Array.isArray(value.parts) &&
-  value.parts.every(isRecord);
+  value.parts.every(isPart);
 
 const isArtifactUpdate = (value: unknown): value is Record<string, unknown> =>
   isRecord(value) &&