@a2a-js/sdk 0.3.6 → 0.3.8

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.
@@ -1,9 +1,11 @@
1
1
  import {
2
- A2AError,
3
2
  JsonRpcTransportHandler,
4
3
  ServerCallContext,
5
4
  UnauthenticatedUser
6
- } from "../chunk-LTPINR5K.js";
5
+ } from "../chunk-NUQQPJNY.js";
6
+ import {
7
+ A2AError
8
+ } from "../chunk-UHZEIZLS.js";
7
9
  import "../chunk-ZX6KNMCP.js";
8
10
 
9
11
  // src/server/agent_execution/request_context.ts
@@ -25,16 +27,194 @@ var RequestContext = class {
25
27
  };
26
28
 
27
29
  // src/server/events/execution_event_bus.ts
28
- import { EventEmitter } from "events";
29
- var DefaultExecutionEventBus = class extends EventEmitter {
30
- constructor() {
31
- super();
30
+ var CustomEventImpl = typeof CustomEvent !== "undefined" ? CustomEvent : class CustomEventPolyfill extends Event {
31
+ detail;
32
+ constructor(type, eventInitDict) {
33
+ super(type, eventInitDict);
34
+ this.detail = eventInitDict?.detail ?? null;
32
35
  }
36
+ };
37
+ function isAgentExecutionCustomEvent(e) {
38
+ return e instanceof CustomEventImpl;
39
+ }
40
+ var DefaultExecutionEventBus = class extends EventTarget {
41
+ // Separate storage for each event type - both use the interface's Listener type
42
+ // but are invoked differently (with event payload vs. no arguments)
43
+ eventListeners = /* @__PURE__ */ new Map();
44
+ finishedListeners = /* @__PURE__ */ new Map();
33
45
  publish(event) {
34
- this.emit("event", event);
46
+ this.dispatchEvent(new CustomEventImpl("event", { detail: event }));
35
47
  }
36
48
  finished() {
37
- this.emit("finished");
49
+ this.dispatchEvent(new Event("finished"));
50
+ }
51
+ /**
52
+ * EventEmitter-compatible 'on' method.
53
+ * Wraps the listener to extract event detail from CustomEvent.
54
+ * Supports multiple registrations of the same listener (like EventEmitter).
55
+ * @param eventName The event name to listen for.
56
+ * @param listener The callback function to invoke when the event is emitted.
57
+ * @returns This instance for method chaining.
58
+ */
59
+ on(eventName, listener) {
60
+ if (eventName === "event") {
61
+ this.addEventListenerInternal(listener);
62
+ } else {
63
+ this.addFinishedListenerInternal(listener);
64
+ }
65
+ return this;
66
+ }
67
+ /**
68
+ * EventEmitter-compatible 'off' method.
69
+ * Uses the stored wrapped listener for proper removal.
70
+ * Removes at most one instance of a listener per call (like EventEmitter).
71
+ * @param eventName The event name to stop listening for.
72
+ * @param listener The callback function to remove.
73
+ * @returns This instance for method chaining.
74
+ */
75
+ off(eventName, listener) {
76
+ if (eventName === "event") {
77
+ this.removeEventListenerInternal(listener);
78
+ } else {
79
+ this.removeFinishedListenerInternal(listener);
80
+ }
81
+ return this;
82
+ }
83
+ /**
84
+ * EventEmitter-compatible 'once' method.
85
+ * Listener is automatically removed after first invocation.
86
+ * Supports multiple registrations of the same listener (like EventEmitter).
87
+ * @param eventName The event name to listen for once.
88
+ * @param listener The callback function to invoke when the event is emitted.
89
+ * @returns This instance for method chaining.
90
+ */
91
+ once(eventName, listener) {
92
+ if (eventName === "event") {
93
+ this.addEventListenerOnceInternal(listener);
94
+ } else {
95
+ this.addFinishedListenerOnceInternal(listener);
96
+ }
97
+ return this;
98
+ }
99
+ /**
100
+ * EventEmitter-compatible 'removeAllListeners' method.
101
+ * Removes all listeners for a specific event or all events.
102
+ * @param eventName Optional event name to remove listeners for. If omitted, removes all.
103
+ * @returns This instance for method chaining.
104
+ */
105
+ removeAllListeners(eventName) {
106
+ if (eventName === void 0 || eventName === "event") {
107
+ for (const wrappedListeners of this.eventListeners.values()) {
108
+ for (const wrapped of wrappedListeners) {
109
+ this.removeEventListener("event", wrapped);
110
+ }
111
+ }
112
+ this.eventListeners.clear();
113
+ }
114
+ if (eventName === void 0 || eventName === "finished") {
115
+ for (const wrappedListeners of this.finishedListeners.values()) {
116
+ for (const wrapped of wrappedListeners) {
117
+ this.removeEventListener("finished", wrapped);
118
+ }
119
+ }
120
+ this.finishedListeners.clear();
121
+ }
122
+ return this;
123
+ }
124
+ // ========================
125
+ // Helper methods for listener tracking
126
+ // ========================
127
+ /**
128
+ * Adds a wrapped listener to the tracking map.
129
+ */
130
+ trackListener(listenerMap, listener, wrapped) {
131
+ const existing = listenerMap.get(listener);
132
+ if (existing) {
133
+ existing.push(wrapped);
134
+ } else {
135
+ listenerMap.set(listener, [wrapped]);
136
+ }
137
+ }
138
+ /**
139
+ * Removes a wrapped listener from the tracking map (for once cleanup).
140
+ */
141
+ untrackWrappedListener(listenerMap, listener, wrapped) {
142
+ const wrappedList = listenerMap.get(listener);
143
+ if (wrappedList && wrappedList.length > 0) {
144
+ const index = wrappedList.indexOf(wrapped);
145
+ if (index !== -1) {
146
+ wrappedList.splice(index, 1);
147
+ if (wrappedList.length === 0) {
148
+ listenerMap.delete(listener);
149
+ }
150
+ }
151
+ }
152
+ }
153
+ // ========================
154
+ // Internal methods for 'event' listeners
155
+ // ========================
156
+ addEventListenerInternal(listener) {
157
+ const wrapped = (e) => {
158
+ if (!isAgentExecutionCustomEvent(e)) {
159
+ throw new Error('Internal error: expected CustomEvent for "event" type');
160
+ }
161
+ listener.call(this, e.detail);
162
+ };
163
+ this.trackListener(this.eventListeners, listener, wrapped);
164
+ this.addEventListener("event", wrapped);
165
+ }
166
+ removeEventListenerInternal(listener) {
167
+ const wrappedList = this.eventListeners.get(listener);
168
+ if (wrappedList && wrappedList.length > 0) {
169
+ const wrapped = wrappedList.pop();
170
+ if (wrappedList.length === 0) {
171
+ this.eventListeners.delete(listener);
172
+ }
173
+ this.removeEventListener("event", wrapped);
174
+ }
175
+ }
176
+ addEventListenerOnceInternal(listener) {
177
+ const wrapped = (e) => {
178
+ if (!isAgentExecutionCustomEvent(e)) {
179
+ throw new Error('Internal error: expected CustomEvent for "event" type');
180
+ }
181
+ this.untrackWrappedListener(this.eventListeners, listener, wrapped);
182
+ listener.call(this, e.detail);
183
+ };
184
+ this.trackListener(this.eventListeners, listener, wrapped);
185
+ this.addEventListener("event", wrapped, { once: true });
186
+ }
187
+ // ========================
188
+ // Internal methods for 'finished' listeners
189
+ // ========================
190
+ // The interface declares listeners as (event: AgentExecutionEvent) => void,
191
+ // but for 'finished' events they are invoked with no arguments (EventEmitter behavior).
192
+ // We use Function.prototype.call to invoke with `this` as the event bus (matching
193
+ // EventEmitter semantics) and no arguments, which is type-safe.
194
+ addFinishedListenerInternal(listener) {
195
+ const wrapped = () => {
196
+ listener.call(this);
197
+ };
198
+ this.trackListener(this.finishedListeners, listener, wrapped);
199
+ this.addEventListener("finished", wrapped);
200
+ }
201
+ removeFinishedListenerInternal(listener) {
202
+ const wrappedList = this.finishedListeners.get(listener);
203
+ if (wrappedList && wrappedList.length > 0) {
204
+ const wrapped = wrappedList.pop();
205
+ if (wrappedList.length === 0) {
206
+ this.finishedListeners.delete(listener);
207
+ }
208
+ this.removeEventListener("finished", wrapped);
209
+ }
210
+ }
211
+ addFinishedListenerOnceInternal(listener) {
212
+ const wrapped = () => {
213
+ this.untrackWrappedListener(this.finishedListeners, listener, wrapped);
214
+ listener.call(this);
215
+ };
216
+ this.trackListener(this.finishedListeners, listener, wrapped);
217
+ this.addEventListener("finished", wrapped, { once: true });
38
218
  }
39
219
  };
40
220
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@a2a-js/sdk",
3
- "version": "0.3.6",
3
+ "version": "0.3.8",
4
4
  "description": "Server & Client SDK for Agent2Agent protocol",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -13,6 +13,19 @@
13
13
  "main": "dist/index.js",
14
14
  "types": "dist/index.d.ts",
15
15
  "type": "module",
16
+ "typesVersions": {
17
+ "*": {
18
+ "server": [
19
+ "./dist/server/index.d.ts"
20
+ ],
21
+ "server/express": [
22
+ "./dist/server/express/index.d.ts"
23
+ ],
24
+ "client": [
25
+ "./dist/client/index.d.ts"
26
+ ]
27
+ }
28
+ },
16
29
  "exports": {
17
30
  ".": {
18
31
  "types": "./dist/index.d.ts",
@@ -41,15 +54,12 @@
41
54
  "README.md"
42
55
  ],
43
56
  "devDependencies": {
57
+ "@cloudflare/vitest-pool-workers": "^0.10.15",
44
58
  "@eslint/js": "^9.39.1",
45
- "@types/chai": "^5.2.2",
46
59
  "@types/express": "^5.0.3",
47
- "@types/mocha": "^10.0.10",
48
60
  "@types/node": "^22.13.14",
49
- "@types/sinon": "^17.0.4",
50
61
  "@types/supertest": "^6.0.3",
51
- "c8": "^10.1.3",
52
- "chai": "^5.2.0",
62
+ "@vitest/coverage-v8": "^3.2.4",
53
63
  "esbuild": "^0.27.0",
54
64
  "eslint": "^9.39.1",
55
65
  "eslint-config-prettier": "^10.1.8",
@@ -57,25 +67,25 @@
57
67
  "express": "^5.1.0",
58
68
  "gts": "^6.0.2",
59
69
  "json-schema-to-typescript": "^15.0.4",
60
- "mocha": "^11.6.0",
61
70
  "prettier": "^3.6.2",
62
- "sinon": "^20.0.0",
63
71
  "supertest": "^7.1.4",
64
72
  "tsup": "^8.5.0",
65
73
  "tsx": "^4.19.3",
66
74
  "typescript": "^5.9.3",
67
- "typescript-eslint": "^8.46.4"
75
+ "typescript-eslint": "^8.46.4",
76
+ "vitest": "^3.2.4"
68
77
  },
69
78
  "scripts": {
70
79
  "clean": "gts clean",
71
80
  "build": "tsup",
72
- "test": "mocha \"test/**/*.spec.ts\"",
81
+ "test": "vitest run",
82
+ "test:edge": "vitest run --config vitest.edge.config.ts",
73
83
  "lint": "tsc --noEmit && npx eslint .",
74
84
  "format:readme": "prettier --write ./README.md",
75
85
  "lint:fix": "npx eslint . --fix",
76
- "coverage": "c8 npm run test",
86
+ "coverage": "vitest run --coverage",
77
87
  "generate": "curl https://raw.githubusercontent.com/google-a2a/A2A/refs/heads/main/specification/json/a2a.json > spec.json && node scripts/generateTypes.js && rm spec.json",
78
- "test-build:browser": "esbuild ./dist/client/index.js ./dist/index.js --bundle --platform=browser --outdir=dist/tmp-checks --outbase=./dist"
88
+ "test-build": "esbuild ./dist/client/index.js ./dist/server/index.js ./dist/index.js --bundle --platform=neutral --outdir=dist/tmp-checks --outbase=./dist"
79
89
  },
80
90
  "dependencies": {
81
91
  "uuid": "^11.1.0"
@@ -87,8 +97,5 @@
87
97
  "express": {
88
98
  "optional": true
89
99
  }
90
- },
91
- "mocha": {
92
- "require": "tsx"
93
100
  }
94
101
  }