@assistant-ui/react-a2a 0.2.21 → 0.2.23

package/dist/types.d.ts

@@ -1,6 +1,5 @@
 import { A2AClient, A2AClientOptions } from "./A2AClient.js";
 import { AttachmentAdapter, DictationAdapter, ExternalStoreSharedOptions, FeedbackAdapter, RealtimeVoiceAdapter, SpeechSynthesisAdapter, ThreadHistoryAdapter, ThreadMessage } from "@assistant-ui/core";
-
 //#region src/types.d.ts
 declare const A2A_PROTOCOL_VERSION = "1.0";
 type A2ARole = "unspecified" | "user" | "agent";
@@ -157,8 +156,10 @@ type A2APasswordOAuthFlow = {
 };
 type A2AOAuthFlows = {
   authorizationCode?: A2AAuthorizationCodeOAuthFlow | undefined;
-  clientCredentials?: A2AClientCredentialsOAuthFlow | undefined; /** @deprecated */
-  implicit?: A2AImplicitOAuthFlow | undefined; /** @deprecated */
+  clientCredentials?: A2AClientCredentialsOAuthFlow | undefined;
+  /** @deprecated */
+  implicit?: A2AImplicitOAuthFlow | undefined;
+  /** @deprecated */
   password?: A2APasswordOAuthFlow | undefined;
   deviceCode?: A2ADeviceCodeOAuthFlow | undefined;
 };
@@ -251,17 +252,29 @@ type UseA2AThreadListAdapter = {
   }>;
 };
 type UseA2ARuntimeOptions = ExternalStoreSharedOptions & {
-  /** Pre-built A2A client instance. Provide this OR baseUrl. */client?: A2AClient; /** Base URL of the A2A server. Used to create a client if `client` is not provided. */
-  baseUrl?: string; /** Optional path prefix for all API endpoints (e.g. "/v1"). Does not affect agent card discovery. Only used with baseUrl. */
-  basePath?: string; /** Optional tenant ID for multi-tenant servers. Only used with baseUrl. */
-  tenant?: string; /** Headers for the A2A client (only used with baseUrl). */
-  headers?: A2AClientOptions["headers"]; /** A2A extension URIs to negotiate. Only used with baseUrl. */
-  extensions?: string[]; /** Extra fetch options (e.g. `{ credentials: 'include' }`). Only used with `baseUrl`. */
-  fetchOptions?: A2AClientOptions["fetchOptions"]; /** Initial context ID for the conversation. */
-  contextId?: string; /** Default send message configuration. */
-  configuration?: A2ASendMessageConfiguration; /** Called when an error occurs. */
-  onError?: (error: Error) => void; /** Called when a run is cancelled. */
-  onCancel?: () => void; /** Called when an artifact is fully received (lastChunk). */
+  /** Pre-built A2A client instance. Provide this OR baseUrl. */
+  client?: A2AClient;
+  /** Base URL of the A2A server. Used to create a client if `client` is not provided. */
+  baseUrl?: string;
+  /** Optional path prefix for all API endpoints (e.g. "/v1"). Does not affect agent card discovery. Only used with baseUrl. */
+  basePath?: string;
+  /** Optional tenant ID for multi-tenant servers. Only used with baseUrl. */
+  tenant?: string;
+  /** Headers for the A2A client (only used with baseUrl). */
+  headers?: A2AClientOptions["headers"];
+  /** A2A extension URIs to negotiate. Only used with baseUrl. */
+  extensions?: string[];
+  /** Extra fetch options (e.g. `{ credentials: 'include' }`). Only used with `baseUrl`. */
+  fetchOptions?: A2AClientOptions["fetchOptions"];
+  /** Initial context ID for the conversation. */
+  contextId?: string;
+  /** Default send message configuration. */
+  configuration?: A2ASendMessageConfiguration;
+  /** Called when an error occurs. */
+  onError?: (error: Error) => void;
+  /** Called when a run is cancelled. */
+  onCancel?: () => void;
+  /** Called when an artifact is fully received (lastChunk). */
   onArtifactComplete?: (artifact: A2AArtifact) => void;
   adapters?: {
     attachments?: AttachmentAdapter;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":"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"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;cAgBa;KAED;KAEA;EACV;EACA;EACA;EACA;EAEA,WAAW;EACX;EACA;;KAGU;EACV;EACA;EACA;EACA,MAAM;EACN,OAAO;EACP,WAAW;EACX;EACA;;KAGU;KAWA;EACV,OAAO;EACP,UAAU;EACV;;KAGU;EACV;EACA;EACA;EACA,OAAO;EACP,WAAW;EACX;;KAGU;EACV;EACA;EACA,QAAQ;EACR,YAAY;EACZ,UAAU;EACV,WAAW;;KAID;EACV;EACA;EACA,QAAQ;EACR,WAAW;;KAGD;EACV;EACA;EACA,UAAU;EACV;EACA;EACA,WAAW;;KAGD;EACN;EAAc,MAAM;;EACpB;EAAiB,SAAS;;EAC1B;EAAsB,OAAO;;EAC7B;EAAwB,OAAO;;KAEzB;EACV;EACA;;KAGU;EACV;EACA;EACA;EACA;EACA;EACA,iBAAiB;;KAGP;EACV,SAAS;EACT;;KAGU;EACV;EACA,6BAA6B;EAC7B;EACA;;KAGU;EACV;EACA,SAAS;EACT;EACA;EACA;EACA;EACA;;KAGU;EACV,OAAO;EACP;EACA;EACA;;KAIU;EACV;EACA;EACA;EACA;;KAGU;EACV;EACA;EACA;;KAGU;EACV;EACA;EACA;;KAGU;EACV;EACA;EACA;EACA,QAAQ;EACR;;KAGU;EACV;EACA;EACA,QAAQ;;KAGE;EACV;EACA;EACA;EACA,QAAQ;;;KAIE;EACV;EACA;EACA,SAAS;;;KAIC;EACV;EACA;EACA,SAAS;;KAGC;EACV,oBAAoB;EACpB,oBAAoB;;EAEpB,WAAW;;EAEX,WAAW;EACX,aAAa;;KAGH;EACV;EACA,OAAO;EACP;;KAGU;EACV;EACA;;KAGU;EACV;;KAGU;EACV,uBAAuB;EACvB,yBAAyB;EACzB,uBAAuB;EACvB,8BAA8B;EAC9B,qBAAqB;;KAGX;EACV,SAAS;IAAiB;;;KAIhB;EACV;EACA;EACA,SAAS;;KAGC;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA,uBAAuB;;KAGb;EACV;EACA;EACA,aACI;IACE;IACA;IACA;IACA,SAAS;;EAGf;;KAGU;EACV;EACA;EACA;EACA;;KAGU;EACV;EACA;EACA,qBAAqB;EACrB;IAEM;IACA;;EAGN;EACA;EACA,cAAc;EACd,kBAAkB,eAAe;EACjC,uBAAuB;EACvB;EACA;EACA,QAAQ;EACR,aAAa;EACb;;;KAIU;EACV,MAAM;EACN,oBAAoB;EACpB,WAAW;;KAGD;EACV;EACA,4BAA4B;EAC5B,oBAAoB,qBAAqB;IACvC,mBAAmB;;;KAIX,uBAAuB;;EAEjC,SAAS;;EAET;;EAEA;;EAEA;;EAEA,UAAU;;EAEV;;EAEA,eAAe;;EAGf;;EAEA,gBAAgB;;EAGhB,WAAW,OAAO;;EAElB;;EAEA,sBAAsB,UAAU;EAEhC;IACE,cAAc;IACd,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,WAAW;IACX,UAAU;IACV,aAAa"}

package/dist/useA2ARuntime.d.ts

@@ -1,6 +1,5 @@
 import { UseA2ARuntimeOptions } from "./types.js";
 import { AssistantRuntime } from "@assistant-ui/core";
-
 //#region src/useA2ARuntime.d.ts
 declare function useA2ARuntime(options: UseA2ARuntimeOptions): AssistantRuntime;
 //#endregion

package/dist/useA2ARuntime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useA2ARuntime.d.ts","names":[],"sources":["../src/useA2ARuntime.ts"],"mappings":";;;;iBAmBgB,aAAA,CAAc,OAAA,EAAS,oBAAA,GAAuB,gBAAgB"}
+{"version":3,"file":"useA2ARuntime.d.ts","names":[],"sources":["../src/useA2ARuntime.ts"],"mappings":";;;iBAoCgB,cAAc,SAAS,uBAAuB"}

package/dist/useA2ARuntime.js

@@ -5,36 +5,48 @@ import { a2aExtras } from "./a2aExtras.js";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { useExternalStoreRuntime, useExternalStoreSharedOptions, useRuntimeAdapters } from "@assistant-ui/core/react";
 //#region src/useA2ARuntime.ts
+const serializeManagedClientOptions = (options) => {
+	const fetchOptions = Object.fromEntries(Object.entries(options.fetchOptions ?? {}).sort(([a], [b]) => a.localeCompare(b)));
+	return JSON.stringify({
+		...options,
+		fetchOptions
+	});
+};
 function useA2ARuntime(options) {
 	const [_version, setVersion] = useState(0);
 	const notifyUpdate = useCallback(() => setVersion((v) => v + 1), []);
 	const runtimeAdapters = useRuntimeAdapters();
 	const historyAdapter = options.adapters?.history ?? runtimeAdapters?.history;
 	const threadListAdapter = options.adapters?.threadList;
-	const clientRef = useRef(null);
-	if (!clientRef.current) if (options.client) clientRef.current = options.client;
-	else if (options.baseUrl) clientRef.current = new A2AClient({
+	const headersRef = useRef(options.headers);
+	headersRef.current = options.headers;
+	const resolveHeaders = useCallback(() => {
+		const headers = headersRef.current;
+		return typeof headers === "function" ? headers() : headers ?? {};
+	}, []);
+	const managedClientOptionsKey = options.client ? null : options.baseUrl ? serializeManagedClientOptions({
 		baseUrl: options.baseUrl,
 		basePath: options.basePath,
 		tenant: options.tenant,
-		headers: options.headers,
 		extensions: options.extensions,
 		fetchOptions: options.fetchOptions
-	});
-	else throw new Error("useA2ARuntime requires either `client` or `baseUrl`");
-	const client = clientRef.current;
-	const coreRef = useRef(null);
-	if (!coreRef.current) coreRef.current = new A2AThreadRuntimeCore({
+	}) : null;
+	const client = useMemo(() => {
+		if (options.client) return options.client;
+		if (!managedClientOptionsKey) throw new Error("useA2ARuntime requires either `client` or `baseUrl`");
+		return new A2AClient({
+			...JSON.parse(managedClientOptionsKey),
+			headers: resolveHeaders
+		});
+	}, [
+		managedClientOptionsKey,
+		options.client,
+		resolveHeaders
+	]);
+	const core = useMemo(() => new A2AThreadRuntimeCore({
 		client,
-		contextId: options.contextId,
-		configuration: options.configuration,
-		...options.onError && { onError: options.onError },
-		...options.onCancel && { onCancel: options.onCancel },
-		...options.onArtifactComplete && { onArtifactComplete: options.onArtifactComplete },
-		...historyAdapter && { history: historyAdapter },
 		notifyUpdate
-	});
-	const core = coreRef.current;
+	}), [client, notifyUpdate]);
 	core.updateOptions({
 		client,
 		contextId: options.contextId,
@@ -77,7 +89,7 @@ function useA2ARuntime(options) {
 		return {
 			...shared,
 			isLoading: core.isLoading,
-			messages: core.getMessages(),
+			messageRepository: core.getMessageRepository(),
 			isRunning: core.isRunning(),
 			extras: a2aExtras.provide({
 				task: core.getTask(),

package/dist/useA2ARuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"useA2ARuntime.js","names":[],"sources":["../src/useA2ARuntime.ts"],"sourcesContent":["\"use client\";\n\nimport { useCallback, useEffect, useMemo, useRef, useState } 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 } from \"./A2AClient\";\nimport { A2AThreadRuntimeCore } from \"./A2AThreadRuntimeCore\";\nimport { a2aExtras } from \"./a2aExtras\";\nimport type { UseA2ARuntimeOptions } from \"./types\";\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  // Create or reuse client\n  const clientRef = useRef<A2AClient | null>(null);\n  if (!clientRef.current) {\n    if (options.client) {\n      clientRef.current = options.client;\n    } else if (options.baseUrl) {\n      clientRef.current = new A2AClient({\n        baseUrl: options.baseUrl,\n        basePath: options.basePath,\n        tenant: options.tenant,\n        headers: options.headers,\n        extensions: options.extensions,\n        fetchOptions: options.fetchOptions,\n      });\n    } else {\n      throw new Error(\"useA2ARuntime requires either `client` or `baseUrl`\");\n    }\n  }\n  const client = clientRef.current;\n\n  // Create or reuse core\n  const coreRef = useRef<A2AThreadRuntimeCore | null>(null);\n  if (!coreRef.current) {\n    coreRef.current = new A2AThreadRuntimeCore({\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      notifyUpdate,\n    });\n  }\n\n  const core = coreRef.current;\n  core.updateOptions({\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\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            core.applyExternalMessages([]);\n          }\n        : undefined,\n      onSwitchToThread: onSwitchToThread\n        ? async (threadId: string) => {\n            const result = await onSwitchToThread(threadId);\n            core.applyExternalMessages(result.messages);\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      messages: core.getMessages(),\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 { useCallback, useEffect, useMemo, useRef, useState } 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  headersRef.current = options.headers;\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 core = useMemo(\n    () =>\n      new A2AThreadRuntimeCore({\n        client,\n        notifyUpdate,\n      }),\n    [client, notifyUpdate],\n  );\n\n  core.updateOptions({\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\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            core.applyExternalMessages([]);\n          }\n        : undefined,\n      onSwitchToThread: onSwitchToThread\n        ? async (threadId: string) => {\n            const result = await onSwitchToThread(threadId);\n            core.applyExternalMessages(result.messages);\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.21",
+  "version": "0.2.23",
   "description": "A2A (Agent-to-Agent) v1.0 protocol adapter for assistant-ui",
   "keywords": [
     "a2a",
@@ -29,8 +29,9 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@assistant-ui/core": "^0.2.19",
-    "@assistant-ui/store": "^0.2.19"
+    "@assistant-ui/core": "^0.2.22",
+    "@assistant-ui/store": "^0.2.21",
+    "assistant-stream": "^0.3.27"
   },
   "peerDependencies": {
     "@types/react": "*",
@@ -42,10 +43,14 @@
     }
   },
   "devDependencies": {
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.2",
     "@types/react": "^19.2.17",
-    "react": "^19.2.7",
-    "vitest": "^4.1.9",
-    "@assistant-ui/x-buildutils": "0.0.16"
+    "jsdom": "^29.1.1",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "vitest": "^4.1.10",
+    "@assistant-ui/x-buildutils": "0.0.19"
   },
   "publishConfig": {
     "access": "public",

package/src/A2AClient.test.ts

@@ -14,17 +14,23 @@ function mockFetchResponse(body: unknown, ok = true, status = 200): Response {
   } as unknown as Response;
 }
 
-function mockSSEResponse(lines: string[]): Response {
-  const text = lines.join("\n");
+function mockSSETextResponse(
+  text: string | string[],
+  contentType: string | null = "text/event-stream",
+): Response {
   const encoder = new TextEncoder();
-  const chunks = [encoder.encode(text)];
+  const chunks = (Array.isArray(text) ? text : [text]).map((chunk) =>
+    encoder.encode(chunk),
+  );
   let index = 0;
+  const headers = new Headers();
+  if (contentType !== null) headers.set("content-type", contentType);
 
   return {
     ok: true,
     status: 200,
     statusText: "OK",
-    headers: new Headers({ "content-type": "text/event-stream" }),
+    headers,
     body: {
       getReader: () => ({
         read: vi.fn().mockImplementation(() => {
@@ -42,6 +48,13 @@ function mockSSEResponse(lines: string[]): Response {
   } as unknown as Response;
 }
 
+function mockSSEResponse(
+  lines: string[],
+  contentType: string | null = "text/event-stream",
+): Response {
+  return mockSSETextResponse(lines.join("\n"), contentType);
+}
+
 const userMessage: A2AMessage = {
   messageId: "msg-1",
   role: "user",
@@ -429,6 +442,48 @@ describe("A2AClient", () => {
       expect((result as any).role).toBe("agent");
     });
 
+    it.each([
+      ["an empty object", {}],
+      ["a malformed task", { task: {} }],
+      [
+        "a task with an unknown state",
+        { task: { id: "t1", status: { state: "typo" } } },
+      ],
+      ["a malformed message", { message: {} }],
+      [
+        "a message with a malformed part",
+        {
+          message: {
+            messageId: "m2",
+            role: "agent",
+            parts: [null],
+          },
+        },
+      ],
+    ])("rejects %s returned with a successful status", async (_name, body) => {
+      fetchMock.mockResolvedValue(mockFetchResponse(body));
+
+      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" } }],
+      [
+        "message",
+        {
+          messageId: "m2",
+          role: "agent",
+          parts: [{ text: "Hi" }],
+        },
+      ],
+    ])("accepts a direct %s response", async (_name, body) => {
+      fetchMock.mockResolvedValue(mockFetchResponse(body));
+
+      await expect(client.sendMessage(userMessage)).resolves.toEqual(body);
+    });
+
     it("normalizes 'content' array from v0.3 server response to internal 'parts'", async () => {
       fetchMock.mockResolvedValue(
         mockFetchResponse({
@@ -758,6 +813,83 @@ describe("A2AClient", () => {
       expect(card.supportedInterfaces).toHaveLength(1);
       expect(card.supportedInterfaces[0]!.protocolBinding).toBe("HTTP+JSON");
     });
+
+    it.each([
+      ["an empty payload", {}],
+      ["a payload without a name", { version: "1.0", skills: [] }],
+      ["a non-object payload", "not a card"],
+      [
+        "a wrong-typed supportedInterfaces",
+        { name: "Test Agent", supportedInterfaces: "invalid" },
+      ],
+      ["a wrong-typed skill entry", { name: "Test Agent", skills: ["nope"] }],
+      [
+        "a wrong-typed skill tags field",
+        { name: "Test Agent", skills: [{ id: "s", tags: "broken" }] },
+      ],
+    ])("rejects %s", async (_name, body) => {
+      fetchMock.mockResolvedValue(mockFetchResponse(body));
+
+      await expect(client.getAgentCard()).rejects.toThrow(
+        "Invalid A2A agent card response: expected a valid agent card payload.",
+      );
+    });
+
+    it("treats explicit null fields as defaults", async () => {
+      fetchMock.mockResolvedValue(
+        mockFetchResponse({
+          name: "Test Agent",
+          description: null,
+          skills: null,
+        }),
+      );
+
+      const card = await client.getAgentCard();
+
+      expect(card.description).toBe("");
+      expect(card.skills).toEqual([]);
+    });
+
+    it("fills defaults for fields omitted by proto3 JSON serialization", async () => {
+      fetchMock.mockResolvedValue(mockFetchResponse({ name: "Test Agent" }));
+
+      const card = await client.getAgentCard();
+
+      expect(card).toMatchObject({
+        name: "Test Agent",
+        description: "",
+        version: "",
+        supportedInterfaces: [],
+        capabilities: {},
+        defaultInputModes: [],
+        defaultOutputModes: [],
+        skills: [],
+      });
+    });
+
+    it("fills defaults inside interfaces and skills", async () => {
+      fetchMock.mockResolvedValue(
+        mockFetchResponse({
+          name: "Test Agent",
+          supported_interfaces: [{ url: "https://agent.test/a2a" }],
+          skills: [{ id: "recipes", name: "Recipes" }],
+        }),
+      );
+
+      const card = await client.getAgentCard();
+
+      expect(card.supportedInterfaces[0]).toMatchObject({
+        url: "https://agent.test/a2a",
+        protocolBinding: "",
+        protocolVersion: "",
+      });
+      expect(card.skills[0]).toMatchObject({
+        id: "recipes",
+        name: "Recipes",
+        description: "",
+        tags: [],
+      });
+    });
   });
 
   // --- SSE streaming ---
@@ -799,6 +931,111 @@ describe("A2AClient", () => {
       expect(evt.event.status.message?.role).toBe("agent");
     });
 
+    it("parses CRLF-delimited SSE events", async () => {
+      const sseData = JSON.stringify({
+        status_update: {
+          task_id: "t1",
+          context_id: "ctx-1",
+          status: { state: "TASK_STATE_WORKING" },
+        },
+      });
+
+      fetchMock.mockResolvedValue(
+        mockSSETextResponse(`data: ${sseData}\r\n\r\n`),
+      );
+
+      const events: A2AStreamEvent[] = [];
+      for await (const event of client.streamMessage(userMessage)) {
+        events.push(event);
+      }
+
+      expect(events).toHaveLength(1);
+      expect(events[0]!.type).toBe("statusUpdate");
+    });
+
+    it("parses CR-delimited SSE events", async () => {
+      const sseData = JSON.stringify({
+        status_update: {
+          task_id: "t1",
+          context_id: "ctx-1",
+          status: { state: "TASK_STATE_WORKING" },
+        },
+      });
+
+      fetchMock.mockResolvedValue(mockSSETextResponse(`data: ${sseData}\r\r`));
+
+      const events: A2AStreamEvent[] = [];
+      for await (const event of client.streamMessage(userMessage)) {
+        events.push(event);
+      }
+
+      expect(events).toHaveLength(1);
+      expect(events[0]!.type).toBe("statusUpdate");
+    });
+
+    it("parses CRLF delimiters split across chunks", async () => {
+      const sseData = JSON.stringify({
+        status_update: {
+          task_id: "t1",
+          context_id: "ctx-1",
+          status: { state: "TASK_STATE_WORKING" },
+        },
+      });
+
+      fetchMock.mockResolvedValue(
+        mockSSETextResponse([`data: ${sseData}\r`, "\n\r", "\n"]),
+      );
+
+      const events: A2AStreamEvent[] = [];
+      for await (const event of client.streamMessage(userMessage)) {
+        events.push(event);
+      }
+
+      expect(events).toHaveLength(1);
+      expect(events[0]!.type).toBe("statusUpdate");
+    });
+
+    it("parses CR-delimited events split across chunks", async () => {
+      const sseData = JSON.stringify({
+        status_update: {
+          task_id: "t1",
+          context_id: "ctx-1",
+          status: { state: "TASK_STATE_WORKING" },
+        },
+      });
+
+      fetchMock.mockResolvedValue(
+        mockSSETextResponse([`data: ${sseData}\r`, "\r"]),
+      );
+
+      const events: A2AStreamEvent[] = [];
+      for await (const event of client.streamMessage(userMessage)) {
+        events.push(event);
+      }
+
+      expect(events).toHaveLength(1);
+      expect(events[0]!.type).toBe("statusUpdate");
+    });
+
+    it("does not dispatch unterminated SSE events", async () => {
+      const sseData = JSON.stringify({
+        status_update: {
+          task_id: "t1",
+          context_id: "ctx-1",
+          status: { state: "TASK_STATE_WORKING" },
+        },
+      });
+
+      fetchMock.mockResolvedValue(mockSSETextResponse(`data: ${sseData}`));
+
+      const events: A2AStreamEvent[] = [];
+      for await (const event of client.streamMessage(userMessage)) {
+        events.push(event);
+      }
+
+      expect(events).toHaveLength(0);
+    });
+
     it("parses SSE artifact update events", async () => {
       const sseData = JSON.stringify({
         artifact_update: {
@@ -887,6 +1124,63 @@ describe("A2AClient", () => {
       expect(events).toHaveLength(2);
     });
 
+    it("accepts parameterized event-stream content types", async () => {
+      const sseData = JSON.stringify({
+        status_update: {
+          task_id: "t1",
+          context_id: "ctx-1",
+          status: { state: "TASK_STATE_COMPLETED" },
+        },
+      });
+
+      fetchMock.mockResolvedValue(
+        mockSSEResponse(
+          [`data: ${sseData}`, "", ""],
+          "text/event-stream; charset=utf-8",
+        ),
+      );
+
+      const events: A2AStreamEvent[] = [];
+      for await (const event of client.streamMessage(userMessage)) {
+        events.push(event);
+      }
+
+      expect(events).toHaveLength(1);
+    });
+
+    it("rejects successful responses that are not event streams", async () => {
+      fetchMock.mockResolvedValue(
+        mockSSETextResponse(
+          "<html><body>Please sign in</body></html>",
+          "text/html; charset=utf-8",
+        ),
+      );
+
+      const consumeStream = async () => {
+        for await (const event of client.streamMessage(userMessage)) {
+          void event;
+        }
+      };
+
+      await expect(consumeStream()).rejects.toThrow(
+        'Expected A2A stream response Content-Type "text/event-stream", received "text/html; charset=utf-8"',
+      );
+    });
+
+    it("rejects task subscriptions without a content type", async () => {
+      fetchMock.mockResolvedValue(mockSSETextResponse("", null));
+
+      const consumeStream = async () => {
+        for await (const event of client.subscribeToTask("t1")) {
+          void event;
+        }
+      };
+
+      await expect(consumeStream()).rejects.toThrow(
+        'Expected A2A stream response Content-Type "text/event-stream", received no Content-Type header',
+      );
+    });
+
     it("normalizes 'content' array from v0.3 server response to 'parts' in SSE artifact update events", async () => {
       const sseData = JSON.stringify({
         artifact_update: {
@@ -1076,5 +1370,28 @@ describe("A2AClient", () => {
       const [url] = fetchMock.mock.calls[0]!;
       expect(url).toBe("https://agent.test/extendedAgentCard");
     });
+
+    it.each([
+      ["an empty payload", {}],
+      ["a payload without a name", { version: "1.0" }],
+    ])("rejects %s", async (_name, body) => {
+      fetchMock.mockResolvedValue(mockFetchResponse(body));
+
+      await expect(client.getExtendedAgentCard()).rejects.toThrow(
+        "Invalid A2A agent card response: expected a valid agent card payload.",
+      );
+    });
+
+    it("fills defaults for omitted fields", async () => {
+      fetchMock.mockResolvedValue(
+        mockFetchResponse({ name: "Extended Agent", skills: [{ id: "s" }] }),
+      );
+
+      const card = await client.getExtendedAgentCard();
+
+      expect(card.name).toBe("Extended Agent");
+      expect(card.supportedInterfaces).toEqual([]);
+      expect(card.skills[0]).toMatchObject({ id: "s", tags: [] });
+    });
   });
 });