@assistant-ui/react-a2a 0.2.14 → 0.2.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +12 -25
- package/dist/A2AClient.d.ts +43 -42
- package/dist/A2AClient.d.ts.map +1 -1
- package/dist/A2AClient.js +267 -349
- package/dist/A2AClient.js.map +1 -1
- package/dist/A2AThreadRuntimeCore.d.ts +76 -72
- package/dist/A2AThreadRuntimeCore.d.ts.map +1 -1
- package/dist/A2AThreadRuntimeCore.js +400 -479
- package/dist/A2AThreadRuntimeCore.js.map +1 -1
- package/dist/conversions.d.ts +16 -12
- package/dist/conversions.d.ts.map +1 -1
- package/dist/conversions.js +88 -79
- package/dist/conversions.js.map +1 -1
- package/dist/index.d.ts +5 -8
- package/dist/index.js +5 -8
- package/dist/types.d.ts +229 -228
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +5 -4
- package/dist/types.js.map +1 -1
- package/dist/useA2ARuntime.d.ts +36 -44
- package/dist/useA2ARuntime.d.ts.map +1 -1
- package/dist/useA2ARuntime.js +113 -134
- package/dist/useA2ARuntime.js.map +1 -1
- package/package.json +7 -7
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
package/README.md
CHANGED
|
@@ -1,23 +1,22 @@
|
|
|
1
1
|
# `@assistant-ui/react-a2a`
|
|
2
2
|
|
|
3
|
-
[A2A (Agent-to-Agent) v1.0](https://github.com/a2aproject/A2A) protocol
|
|
3
|
+
[A2A (Agent-to-Agent) v1.0](https://github.com/a2aproject/A2A) protocol integration for `@assistant-ui/react`. Built-in HTTP client with SSE streaming, agent-card discovery, multi-tenancy, and structured error handling.
|
|
4
4
|
|
|
5
5
|
## Installation
|
|
6
6
|
|
|
7
|
-
```
|
|
7
|
+
```bash
|
|
8
8
|
npm install @assistant-ui/react @assistant-ui/react-a2a
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## Usage
|
|
12
12
|
|
|
13
13
|
```tsx
|
|
14
|
-
import { AssistantRuntimeProvider
|
|
14
|
+
import { AssistantRuntimeProvider } from "@assistant-ui/react";
|
|
15
15
|
import { useA2ARuntime } from "@assistant-ui/react-a2a";
|
|
16
|
+
import { Thread } from "@/components/assistant-ui/thread";
|
|
16
17
|
|
|
17
|
-
function App() {
|
|
18
|
-
const runtime = useA2ARuntime({
|
|
19
|
-
baseUrl: "http://localhost:9999",
|
|
20
|
-
});
|
|
18
|
+
export function App() {
|
|
19
|
+
const runtime = useA2ARuntime({ baseUrl: "http://localhost:9999" });
|
|
21
20
|
|
|
22
21
|
return (
|
|
23
22
|
<AssistantRuntimeProvider runtime={runtime}>
|
|
@@ -27,23 +26,11 @@ function App() {
|
|
|
27
26
|
}
|
|
28
27
|
```
|
|
29
28
|
|
|
30
|
-
|
|
29
|
+
Supports all 9 A2A task states (including `input_required` and `auth_required`), artifact streaming, push-notification config, extension negotiation, and streaming/non-streaming auto-fallback.
|
|
31
30
|
|
|
32
|
-
|
|
31
|
+
## See also
|
|
33
32
|
|
|
34
|
-
|
|
33
|
+
- `@assistant-ui/react-ag-ui` for the AG-UI protocol.
|
|
34
|
+
- `@assistant-ui/react-langgraph` for LangGraph agents.
|
|
35
35
|
|
|
36
|
-
|
|
37
|
-
- Built-in HTTP client with SSE streaming
|
|
38
|
-
- All 9 task states (including `input_required`, `auth_required`)
|
|
39
|
-
- Artifact streaming with append/lastChunk support
|
|
40
|
-
- Agent card discovery
|
|
41
|
-
- Multi-tenancy
|
|
42
|
-
- Structured error handling (google.rpc.Status)
|
|
43
|
-
- Push notification config CRUD
|
|
44
|
-
- Extension negotiation
|
|
45
|
-
- Streaming/non-streaming auto-fallback
|
|
46
|
-
|
|
47
|
-
## License
|
|
48
|
-
|
|
49
|
-
MIT
|
|
36
|
+
Full reference at [assistant-ui.com/docs/runtimes/a2a](https://www.assistant-ui.com/docs/runtimes/a2a/overview).
|
package/dist/A2AClient.d.ts
CHANGED
|
@@ -1,46 +1,47 @@
|
|
|
1
|
-
import
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
extensions?: string[] | undefined;
|
|
1
|
+
import { A2AAgentCard, A2AErrorInfo, A2AListTaskPushNotificationConfigsResponse, A2AListTasksRequest, A2AListTasksResponse, A2AMessage, A2ASendMessageConfiguration, A2AStreamEvent, A2ATask, A2ATaskPushNotificationConfig } from "./types.js";
|
|
2
|
+
|
|
3
|
+
//#region src/A2AClient.d.ts
|
|
4
|
+
type A2AClientOptions = {
|
|
5
|
+
baseUrl: string; /** Optional path prefix for all API endpoints (e.g. "/v1"). Does not affect agent card discovery. */
|
|
6
|
+
basePath?: string | undefined; /** Optional tenant ID for multi-tenant servers. */
|
|
7
|
+
tenant?: string | undefined;
|
|
8
|
+
headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>) | undefined; /** A2A extension URIs to negotiate. Sent as A2A-Extensions header. */
|
|
9
|
+
extensions?: string[] | undefined;
|
|
11
10
|
};
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
11
|
+
declare class A2AError extends Error {
|
|
12
|
+
code: number;
|
|
13
|
+
status: string;
|
|
14
|
+
details: unknown[] | undefined;
|
|
15
|
+
constructor(info: A2AErrorInfo);
|
|
17
16
|
}
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
17
|
+
declare class A2AClient {
|
|
18
|
+
private baseUrl;
|
|
19
|
+
private basePath;
|
|
20
|
+
private tenant;
|
|
21
|
+
private extensionUris;
|
|
22
|
+
private headersFn;
|
|
23
|
+
constructor(options: A2AClientOptions);
|
|
24
|
+
private getBasePath;
|
|
25
|
+
private getHeaders;
|
|
26
|
+
private throwResponseError;
|
|
27
|
+
private fetchJSON;
|
|
28
|
+
getAgentCard(signal?: AbortSignal): Promise<A2AAgentCard>;
|
|
29
|
+
getExtendedAgentCard(signal?: AbortSignal): Promise<A2AAgentCard>;
|
|
30
|
+
sendMessage(message: A2AMessage, configuration?: A2ASendMessageConfiguration, metadata?: Record<string, unknown>, signal?: AbortSignal): Promise<A2ATask | A2AMessage>;
|
|
31
|
+
streamMessage(message: A2AMessage, configuration?: A2ASendMessageConfiguration, metadata?: Record<string, unknown>, signal?: AbortSignal): AsyncGenerator<A2AStreamEvent>;
|
|
32
|
+
getTask(taskId: string, historyLength?: number, signal?: AbortSignal): Promise<A2ATask>;
|
|
33
|
+
listTasks(request?: A2AListTasksRequest, signal?: AbortSignal): Promise<A2AListTasksResponse>;
|
|
34
|
+
cancelTask(taskId: string, metadata?: Record<string, unknown>, signal?: AbortSignal): Promise<A2ATask>;
|
|
35
|
+
subscribeToTask(taskId: string, signal?: AbortSignal): AsyncGenerator<A2AStreamEvent>;
|
|
36
|
+
createTaskPushNotificationConfig(config: A2ATaskPushNotificationConfig, signal?: AbortSignal): Promise<A2ATaskPushNotificationConfig>;
|
|
37
|
+
getTaskPushNotificationConfig(taskId: string, configId: string, signal?: AbortSignal): Promise<A2ATaskPushNotificationConfig>;
|
|
38
|
+
listTaskPushNotificationConfigs(taskId: string, options?: {
|
|
39
|
+
pageSize?: number;
|
|
40
|
+
pageToken?: string;
|
|
41
|
+
}, signal?: AbortSignal): Promise<A2AListTaskPushNotificationConfigsResponse>;
|
|
42
|
+
deleteTaskPushNotificationConfig(taskId: string, configId: string, signal?: AbortSignal): Promise<void>;
|
|
43
|
+
private parseSSE;
|
|
45
44
|
}
|
|
45
|
+
//#endregion
|
|
46
|
+
export { A2AClient, A2AClientOptions, A2AError };
|
|
46
47
|
//# sourceMappingURL=A2AClient.d.ts.map
|
package/dist/A2AClient.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"A2AClient.d.ts","
|
|
1
|
+
{"version":3,"file":"A2AClient.d.ts","names":[],"sources":["../src/A2AClient.ts"],"mappings":";;;KAgBY,gBAAA;EACV,OAAA,UADU;EAGV,QAAA;EAEA,MAAA;EACA,OAAA,GACI,MAAA,0BACO,MAAA,mBAAyB,OAAA,CAAQ,MAAA,gCAAA;EAG5C,UAAA;AAAA;AAAA,cAGW,QAAA,SAAiB,KAAK;EACjC,IAAA;EACA,MAAA;EACA,OAAA;cAEY,IAAA,EAAM,YAAA;AAAA;AAAA,cAwHP,SAAA;EAAA,QACH,OAAA;EAAA,QACA,QAAA;EAAA,QACA,MAAA;EAAA,QACA,aAAA;EAAA,QACA,SAAA;cAII,OAAA,EAAS,gBAAA;EAAA,QAUb,WAAA;EAAA,QAIM,UAAA;EAAA,QAqBA,kBAAA;EAAA,QAyBA,SAAA;EAsBR,YAAA,CAAa,MAAA,GAAS,WAAA,GAAc,OAAA,CAAQ,YAAA;EAW5C,oBAAA,CAAqB,MAAA,GAAS,WAAA,GAAc,OAAA,CAAQ,YAAA;EASpD,WAAA,CACJ,OAAA,EAAS,UAAA,EACT,aAAA,GAAgB,2BAAA,EAChB,QAAA,GAAW,MAAA,mBACX,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,OAAA,GAAU,UAAA;EAuBd,aAAA,CACL,OAAA,EAAS,UAAA,EACT,aAAA,GAAgB,2BAAA,EAChB,QAAA,GAAW,MAAA,mBACX,MAAA,GAAS,WAAA,GACR,cAAA,CAAe,cAAA;EA4BZ,OAAA,CACJ,MAAA,UACA,aAAA,WACA,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,OAAA;EAaL,SAAA,CACJ,OAAA,GAAU,mBAAA,EACV,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,oBAAA;EAoBL,UAAA,CACJ,MAAA,UACA,QAAA,GAAW,MAAA,mBACX,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,OAAA;EAYJ,eAAA,CACL,MAAA,UACA,MAAA,GAAS,WAAA,GACR,cAAA,CAAe,cAAA;EAiBZ,gCAAA,CACJ,MAAA,EAAQ,6BAAA,EACR,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,6BAAA;EAaL,6BAAA,CACJ,MAAA,UACA,QAAA,UACA,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,6BAAA;EAOL,+BAAA,CACJ,MAAA,UACA,OAAA;IAAY,QAAA;IAAmB,SAAA;EAAA,GAC/B,MAAA,GAAS,WAAA,GACR,OAAA,CAAQ,0CAAA;EAYL,gCAAA,CACJ,MAAA,UACA,QAAA,UACA,MAAA,GAAS,WAAA,GACR,OAAA;EAAA,QAcY,QAAA;AAAA"}
|