@a2a-js/sdk 0.3.6 → 0.3.8

package/dist/server/express/index.js

@@ -1,13 +1,30 @@
+import {
+  A2A_ERROR_CODE,
+  AgentCard,
+  FromProto,
+  ListTaskPushNotificationConfigResponse,
+  SSE_HEADERS,
+  SendMessageRequest,
+  SendMessageResponse,
+  StreamResponse,
+  Task,
+  TaskPushNotificationConfig,
+  ToProto,
+  formatSSEErrorEvent,
+  formatSSEEvent
+} from "../../chunk-DHC2REQH.js";
 import {
   AGENT_CARD_PATH,
   HTTP_EXTENSION_HEADER
 } from "../../chunk-3QDLXHKS.js";
 import {
-  A2AError,
   JsonRpcTransportHandler,
   ServerCallContext,
   UnauthenticatedUser
-} from "../../chunk-LTPINR5K.js";
+} from "../../chunk-NUQQPJNY.js";
+import {
+  A2AError
+} from "../../chunk-UHZEIZLS.js";
 import {
   Extensions
 } from "../../chunk-ZX6KNMCP.js";
@@ -17,28 +34,6 @@ import express3 from "express";
 
 // src/server/express/json_rpc_handler.ts
 import express from "express";
-
-// src/sse_utils.ts
-var SSE_HEADERS = {
-  "Content-Type": "text/event-stream",
-  "Cache-Control": "no-cache",
-  Connection: "keep-alive",
-  "X-Accel-Buffering": "no"
-  // Disable buffering in nginx
-};
-function formatSSEEvent(event) {
-  return `data: ${JSON.stringify(event)}
-
-`;
-}
-function formatSSEErrorEvent(error) {
-  return `event: error
-data: ${JSON.stringify(error)}
-
-`;
-}
-
-// src/server/express/json_rpc_handler.ts
 function jsonRpcHandler(options) {
   const jsonRpcTransportHandler = new JsonRpcTransportHandler(options.requestHandler);
   const router = express.Router();
@@ -196,17 +191,6 @@ var HTTP_STATUS = {
   INTERNAL_SERVER_ERROR: 500,
   NOT_IMPLEMENTED: 501
 };
-var A2A_ERROR_CODE = {
-  PARSE_ERROR: -32700,
-  INVALID_REQUEST: -32600,
-  METHOD_NOT_FOUND: -32601,
-  INVALID_PARAMS: -32602,
-  TASK_NOT_FOUND: -32001,
-  TASK_NOT_CANCELABLE: -32002,
-  PUSH_NOTIFICATION_NOT_SUPPORTED: -32003,
-  UNSUPPORTED_OPERATION: -32004,
-  UNAUTHORIZED: -32005
-};
 function mapErrorToStatus(errorCode) {
   switch (errorCode) {
     case A2A_ERROR_CODE.PARSE_ERROR:
@@ -221,8 +205,6 @@ function mapErrorToStatus(errorCode) {
     case A2A_ERROR_CODE.PUSH_NOTIFICATION_NOT_SUPPORTED:
     case A2A_ERROR_CODE.UNSUPPORTED_OPERATION:
       return HTTP_STATUS.BAD_REQUEST;
-    case A2A_ERROR_CODE.UNAUTHORIZED:
-      return HTTP_STATUS.UNAUTHORIZED;
     default:
       return HTTP_STATUS.INTERNAL_SERVER_ERROR;
   }
@@ -254,8 +236,8 @@ var RestTransportHandler = class _RestTransportHandler {
   /**
    * Gets the authenticated extended agent card.
    */
-  async getAuthenticatedExtendedAgentCard() {
-    return this.requestHandler.getAuthenticatedExtendedAgentCard();
+  async getAuthenticatedExtendedAgentCard(context) {
+    return this.requestHandler.getAuthenticatedExtendedAgentCard(context);
   }
   /**
    * Sends a message to the agent.
@@ -498,13 +480,16 @@ function restHandler(options) {
       res.setHeader(HTTP_EXTENSION_HEADER, Array.from(context.activatedExtensions));
     }
   };
-  const sendResponse = (res, statusCode, context, body) => {
+  const sendResponse = (res, statusCode, context, body, responseType) => {
     setExtensionsHeader(res, context);
     res.status(statusCode);
     if (statusCode === HTTP_STATUS.NO_CONTENT) {
       res.end();
     } else {
-      res.json(body);
+      if (!responseType) {
+        throw new Error("Bug: toJson serializer must be provided for non-204 responses.");
+      }
+      res.json(responseType.toJSON(body));
     }
   };
   const sendStreamResponse = async (res, stream, context) => {
@@ -525,10 +510,14 @@ function restHandler(options) {
     res.flushHeaders();
     try {
       if (!firstResult.done) {
-        res.write(formatSSEEvent(firstResult.value));
+        const proto = ToProto.messageStreamResult(firstResult.value);
+        const result = StreamResponse.toJSON(proto);
+        res.write(formatSSEEvent(result));
       }
       for await (const event of { [Symbol.asyncIterator]: () => iterator }) {
-        res.write(formatSSEEvent(event));
+        const proto = ToProto.messageStreamResult(event);
+        const result = StreamResponse.toJSON(proto);
+        res.write(formatSSEEvent(result));
       }
     } catch (streamError) {
       console.error("SSE streaming error:", streamError);
@@ -568,23 +557,35 @@ function restHandler(options) {
     "/v1/card",
     asyncHandler(async (req, res) => {
       const context = await buildContext(req);
-      const result = await restTransportHandler.getAuthenticatedExtendedAgentCard();
-      sendResponse(res, HTTP_STATUS.OK, context, result);
+      const result = await restTransportHandler.getAuthenticatedExtendedAgentCard(context);
+      const protoResult = ToProto.agentCard(result);
+      sendResponse(res, HTTP_STATUS.OK, context, protoResult, AgentCard);
     })
   );
   router.post(
     "/v1/message\\:send",
     asyncHandler(async (req, res) => {
       const context = await buildContext(req);
-      const result = await restTransportHandler.sendMessage(req.body, context);
-      sendResponse(res, HTTP_STATUS.CREATED, context, result);
+      const protoReq = SendMessageRequest.fromJSON(req.body);
+      const params = FromProto.messageSendParams(protoReq);
+      const result = await restTransportHandler.sendMessage(params, context);
+      const protoResult = ToProto.messageSendResult(result);
+      sendResponse(
+        res,
+        HTTP_STATUS.CREATED,
+        context,
+        protoResult,
+        SendMessageResponse
+      );
     })
   );
   router.post(
     "/v1/message\\:stream",
     asyncHandler(async (req, res) => {
       const context = await buildContext(req);
-      const stream = await restTransportHandler.sendMessageStream(req.body, context);
+      const protoReq = SendMessageRequest.fromJSON(req.body);
+      const params = FromProto.messageSendParams(protoReq);
+      const stream = await restTransportHandler.sendMessageStream(params, context);
       await sendStreamResponse(res, stream, context);
     })
   );
@@ -595,9 +596,11 @@ function restHandler(options) {
       const result = await restTransportHandler.getTask(
         req.params.taskId,
         context,
-        req.query.historyLength
+        //TODO: clarify for version 1.0.0 the format of the historyLength query parameter, and if history should always be added to the returned object
+        req.query.historyLength ?? req.query.history_length
       );
-      sendResponse(res, HTTP_STATUS.OK, context, result);
+      const protoResult = ToProto.task(result);
+      sendResponse(res, HTTP_STATUS.OK, context, protoResult, Task);
     })
   );
   router.post(
@@ -605,7 +608,8 @@ function restHandler(options) {
     asyncHandler(async (req, res) => {
       const context = await buildContext(req);
       const result = await restTransportHandler.cancelTask(req.params.taskId, context);
-      sendResponse(res, HTTP_STATUS.ACCEPTED, context, result);
+      const protoResult = ToProto.task(result);
+      sendResponse(res, HTTP_STATUS.ACCEPTED, context, protoResult, Task);
     })
   );
   router.post(
@@ -626,7 +630,14 @@ function restHandler(options) {
         task_id: req.params.taskId
       };
       const result = await restTransportHandler.setTaskPushNotificationConfig(config, context);
-      sendResponse(res, HTTP_STATUS.CREATED, context, result);
+      const protoResult = ToProto.taskPushNotificationConfig(result);
+      sendResponse(
+        res,
+        HTTP_STATUS.CREATED,
+        context,
+        protoResult,
+        TaskPushNotificationConfig
+      );
     })
   );
   router.get(
@@ -637,7 +648,14 @@ function restHandler(options) {
         req.params.taskId,
         context
       );
-      sendResponse(res, HTTP_STATUS.OK, context, result);
+      const protoResult = ToProto.listTaskPushNotificationConfig(result);
+      sendResponse(
+        res,
+        HTTP_STATUS.OK,
+        context,
+        protoResult,
+        ListTaskPushNotificationConfigResponse
+      );
     })
   );
   router.get(
@@ -649,7 +667,14 @@ function restHandler(options) {
         req.params.configId,
         context
       );
-      sendResponse(res, HTTP_STATUS.OK, context, result);
+      const protoResult = ToProto.taskPushNotificationConfig(result);
+      sendResponse(
+        res,
+        HTTP_STATUS.OK,
+        context,
+        protoResult,
+        TaskPushNotificationConfig
+      );
     })
   );
   router.delete(

package/dist/server/index.cjs

@@ -54,16 +54,194 @@ var RequestContext = class {
 };
 
 // src/server/events/execution_event_bus.ts
-var import_events = require("events");
-var DefaultExecutionEventBus = class extends import_events.EventEmitter {
-  constructor() {
-    super();
+var CustomEventImpl = typeof CustomEvent !== "undefined" ? CustomEvent : class CustomEventPolyfill extends Event {
+  detail;
+  constructor(type, eventInitDict) {
+    super(type, eventInitDict);
+    this.detail = eventInitDict?.detail ?? null;
   }
+};
+function isAgentExecutionCustomEvent(e) {
+  return e instanceof CustomEventImpl;
+}
+var DefaultExecutionEventBus = class extends EventTarget {
+  // Separate storage for each event type - both use the interface's Listener type
+  // but are invoked differently (with event payload vs. no arguments)
+  eventListeners = /* @__PURE__ */ new Map();
+  finishedListeners = /* @__PURE__ */ new Map();
   publish(event) {
-    this.emit("event", event);
+    this.dispatchEvent(new CustomEventImpl("event", { detail: event }));
   }
   finished() {
-    this.emit("finished");
+    this.dispatchEvent(new Event("finished"));
+  }
+  /**
+   * EventEmitter-compatible 'on' method.
+   * Wraps the listener to extract event detail from CustomEvent.
+   * Supports multiple registrations of the same listener (like EventEmitter).
+   * @param eventName The event name to listen for.
+   * @param listener The callback function to invoke when the event is emitted.
+   * @returns This instance for method chaining.
+   */
+  on(eventName, listener) {
+    if (eventName === "event") {
+      this.addEventListenerInternal(listener);
+    } else {
+      this.addFinishedListenerInternal(listener);
+    }
+    return this;
+  }
+  /**
+   * EventEmitter-compatible 'off' method.
+   * Uses the stored wrapped listener for proper removal.
+   * Removes at most one instance of a listener per call (like EventEmitter).
+   * @param eventName The event name to stop listening for.
+   * @param listener The callback function to remove.
+   * @returns This instance for method chaining.
+   */
+  off(eventName, listener) {
+    if (eventName === "event") {
+      this.removeEventListenerInternal(listener);
+    } else {
+      this.removeFinishedListenerInternal(listener);
+    }
+    return this;
+  }
+  /**
+   * EventEmitter-compatible 'once' method.
+   * Listener is automatically removed after first invocation.
+   * Supports multiple registrations of the same listener (like EventEmitter).
+   * @param eventName The event name to listen for once.
+   * @param listener The callback function to invoke when the event is emitted.
+   * @returns This instance for method chaining.
+   */
+  once(eventName, listener) {
+    if (eventName === "event") {
+      this.addEventListenerOnceInternal(listener);
+    } else {
+      this.addFinishedListenerOnceInternal(listener);
+    }
+    return this;
+  }
+  /**
+   * EventEmitter-compatible 'removeAllListeners' method.
+   * Removes all listeners for a specific event or all events.
+   * @param eventName Optional event name to remove listeners for. If omitted, removes all.
+   * @returns This instance for method chaining.
+   */
+  removeAllListeners(eventName) {
+    if (eventName === void 0 || eventName === "event") {
+      for (const wrappedListeners of this.eventListeners.values()) {
+        for (const wrapped of wrappedListeners) {
+          this.removeEventListener("event", wrapped);
+        }
+      }
+      this.eventListeners.clear();
+    }
+    if (eventName === void 0 || eventName === "finished") {
+      for (const wrappedListeners of this.finishedListeners.values()) {
+        for (const wrapped of wrappedListeners) {
+          this.removeEventListener("finished", wrapped);
+        }
+      }
+      this.finishedListeners.clear();
+    }
+    return this;
+  }
+  // ========================
+  // Helper methods for listener tracking
+  // ========================
+  /**
+   * Adds a wrapped listener to the tracking map.
+   */
+  trackListener(listenerMap, listener, wrapped) {
+    const existing = listenerMap.get(listener);
+    if (existing) {
+      existing.push(wrapped);
+    } else {
+      listenerMap.set(listener, [wrapped]);
+    }
+  }
+  /**
+   * Removes a wrapped listener from the tracking map (for once cleanup).
+   */
+  untrackWrappedListener(listenerMap, listener, wrapped) {
+    const wrappedList = listenerMap.get(listener);
+    if (wrappedList && wrappedList.length > 0) {
+      const index = wrappedList.indexOf(wrapped);
+      if (index !== -1) {
+        wrappedList.splice(index, 1);
+        if (wrappedList.length === 0) {
+          listenerMap.delete(listener);
+        }
+      }
+    }
+  }
+  // ========================
+  // Internal methods for 'event' listeners
+  // ========================
+  addEventListenerInternal(listener) {
+    const wrapped = (e) => {
+      if (!isAgentExecutionCustomEvent(e)) {
+        throw new Error('Internal error: expected CustomEvent for "event" type');
+      }
+      listener.call(this, e.detail);
+    };
+    this.trackListener(this.eventListeners, listener, wrapped);
+    this.addEventListener("event", wrapped);
+  }
+  removeEventListenerInternal(listener) {
+    const wrappedList = this.eventListeners.get(listener);
+    if (wrappedList && wrappedList.length > 0) {
+      const wrapped = wrappedList.pop();
+      if (wrappedList.length === 0) {
+        this.eventListeners.delete(listener);
+      }
+      this.removeEventListener("event", wrapped);
+    }
+  }
+  addEventListenerOnceInternal(listener) {
+    const wrapped = (e) => {
+      if (!isAgentExecutionCustomEvent(e)) {
+        throw new Error('Internal error: expected CustomEvent for "event" type');
+      }
+      this.untrackWrappedListener(this.eventListeners, listener, wrapped);
+      listener.call(this, e.detail);
+    };
+    this.trackListener(this.eventListeners, listener, wrapped);
+    this.addEventListener("event", wrapped, { once: true });
+  }
+  // ========================
+  // Internal methods for 'finished' listeners
+  // ========================
+  // The interface declares listeners as (event: AgentExecutionEvent) => void,
+  // but for 'finished' events they are invoked with no arguments (EventEmitter behavior).
+  // We use Function.prototype.call to invoke with `this` as the event bus (matching
+  // EventEmitter semantics) and no arguments, which is type-safe.
+  addFinishedListenerInternal(listener) {
+    const wrapped = () => {
+      listener.call(this);
+    };
+    this.trackListener(this.finishedListeners, listener, wrapped);
+    this.addEventListener("finished", wrapped);
+  }
+  removeFinishedListenerInternal(listener) {
+    const wrappedList = this.finishedListeners.get(listener);
+    if (wrappedList && wrappedList.length > 0) {
+      const wrapped = wrappedList.pop();
+      if (wrappedList.length === 0) {
+        this.finishedListeners.delete(listener);
+      }
+      this.removeEventListener("finished", wrapped);
+    }
+  }
+  addFinishedListenerOnceInternal(listener) {
+    const wrapped = () => {
+      this.untrackWrappedListener(this.finishedListeners, listener, wrapped);
+      listener.call(this);
+    };
+    this.trackListener(this.finishedListeners, listener, wrapped);
+    this.addEventListener("finished", wrapped, { once: true });
   }
 };
 

package/dist/server/index.d.cts

@@ -1,21 +1,81 @@
-import { EventEmitter } from 'events';
 import { F as Message, ay as Task, aQ as TaskStatusUpdateEvent, aS as TaskArtifactUpdateEvent, z as PushNotificationConfig, ae as AgentCard, x as MessageSendParams, X as TaskQueryParams, Z as TaskIdParams, $ as TaskPushNotificationConfig, a3 as GetTaskPushNotificationConfigParams, a7 as ListTaskPushNotificationConfigParams, a9 as DeleteTaskPushNotificationConfigParams, j as JSONRPCResponse, aw as JSONRPCError } from '../extensions-DvruCIzw.cjs';
 import { S as ServerCallContext, A as A2ARequestHandler } from '../a2a_request_handler-B3LxMq3P.cjs';
 export { a as UnauthenticatedUser, U as User } from '../a2a_request_handler-B3LxMq3P.cjs';
 
 type AgentExecutionEvent = Message | Task | TaskStatusUpdateEvent | TaskArtifactUpdateEvent;
+/**
+ * Event names supported by ExecutionEventBus.
+ */
+type ExecutionEventName = 'event' | 'finished';
 interface ExecutionEventBus {
     publish(event: AgentExecutionEvent): void;
-    on(eventName: 'event' | 'finished', listener: (event: AgentExecutionEvent) => void): this;
-    off(eventName: 'event' | 'finished', listener: (event: AgentExecutionEvent) => void): this;
-    once(eventName: 'event' | 'finished', listener: (event: AgentExecutionEvent) => void): this;
-    removeAllListeners(eventName?: 'event' | 'finished'): this;
+    on(eventName: ExecutionEventName, listener: (event: AgentExecutionEvent) => void): this;
+    off(eventName: ExecutionEventName, listener: (event: AgentExecutionEvent) => void): this;
+    once(eventName: ExecutionEventName, listener: (event: AgentExecutionEvent) => void): this;
+    removeAllListeners(eventName?: ExecutionEventName): this;
     finished(): void;
 }
-declare class DefaultExecutionEventBus extends EventEmitter implements ExecutionEventBus {
-    constructor();
+/**
+ * Web-compatible ExecutionEventBus using EventTarget.
+ * Works across all modern runtimes: Node.js 15+, browsers, Cloudflare Workers, Deno, Bun.
+ *
+ * This implementation provides the subset of EventEmitter methods defined in the
+ * ExecutionEventBus interface. Users extending DefaultExecutionEventBus should note
+ * that other EventEmitter methods (e.g., listenerCount, rawListeners) are not available.
+ */
+declare class DefaultExecutionEventBus extends EventTarget implements ExecutionEventBus {
+    private readonly eventListeners;
+    private readonly finishedListeners;
     publish(event: AgentExecutionEvent): void;
     finished(): void;
+    /**
+     * EventEmitter-compatible 'on' method.
+     * Wraps the listener to extract event detail from CustomEvent.
+     * Supports multiple registrations of the same listener (like EventEmitter).
+     * @param eventName The event name to listen for.
+     * @param listener The callback function to invoke when the event is emitted.
+     * @returns This instance for method chaining.
+     */
+    on(eventName: ExecutionEventName, listener: (event: AgentExecutionEvent) => void): this;
+    /**
+     * EventEmitter-compatible 'off' method.
+     * Uses the stored wrapped listener for proper removal.
+     * Removes at most one instance of a listener per call (like EventEmitter).
+     * @param eventName The event name to stop listening for.
+     * @param listener The callback function to remove.
+     * @returns This instance for method chaining.
+     */
+    off(eventName: ExecutionEventName, listener: (event: AgentExecutionEvent) => void): this;
+    /**
+     * EventEmitter-compatible 'once' method.
+     * Listener is automatically removed after first invocation.
+     * Supports multiple registrations of the same listener (like EventEmitter).
+     * @param eventName The event name to listen for once.
+     * @param listener The callback function to invoke when the event is emitted.
+     * @returns This instance for method chaining.
+     */
+    once(eventName: ExecutionEventName, listener: (event: AgentExecutionEvent) => void): this;
+    /**
+     * EventEmitter-compatible 'removeAllListeners' method.
+     * Removes all listeners for a specific event or all events.
+     * @param eventName Optional event name to remove listeners for. If omitted, removes all.
+     * @returns This instance for method chaining.
+     */
+    removeAllListeners(eventName?: ExecutionEventName): this;
+    /**
+     * Adds a wrapped listener to the tracking map.
+     */
+    private trackListener;
+    /**
+     * Removes a wrapped listener from the tracking map (for once cleanup).
+     */
+    private untrackWrappedListener;
+    private addEventListenerInternal;
+    private removeEventListenerInternal;
+    private addEventListenerOnceInternal;
+    private addFinishedListenerInternal;
+    private removeFinishedListenerInternal;
+    private addFinishedListenerOnceInternal;
 }
 
 declare class RequestContext {
@@ -253,4 +313,4 @@ declare class DefaultPushNotificationSender implements PushNotificationSender {
     private _dispatchNotification;
 }
 
-export { A2AError, A2ARequestHandler, type AgentExecutionEvent, type AgentExecutor, DefaultExecutionEventBus, DefaultExecutionEventBusManager, DefaultPushNotificationSender, type DefaultPushNotificationSenderOptions, DefaultRequestHandler, type ExecutionEventBus, type ExecutionEventBusManager, ExecutionEventQueue, type ExtendedAgentCardProvider, InMemoryPushNotificationStore, InMemoryTaskStore, JsonRpcTransportHandler, type PushNotificationSender, type PushNotificationStore, RequestContext, ResultManager, ServerCallContext, type TaskStore };
+export { A2AError, A2ARequestHandler, type AgentExecutionEvent, type AgentExecutor, DefaultExecutionEventBus, DefaultExecutionEventBusManager, DefaultPushNotificationSender, type DefaultPushNotificationSenderOptions, DefaultRequestHandler, type ExecutionEventBus, type ExecutionEventBusManager, type ExecutionEventName, ExecutionEventQueue, type ExtendedAgentCardProvider, InMemoryPushNotificationStore, InMemoryTaskStore, JsonRpcTransportHandler, type PushNotificationSender, type PushNotificationStore, RequestContext, ResultManager, ServerCallContext, type TaskStore };

package/dist/server/index.d.ts

@@ -1,21 +1,81 @@
-import { EventEmitter } from 'events';
 import { F as Message, ay as Task, aQ as TaskStatusUpdateEvent, aS as TaskArtifactUpdateEvent, z as PushNotificationConfig, ae as AgentCard, x as MessageSendParams, X as TaskQueryParams, Z as TaskIdParams, $ as TaskPushNotificationConfig, a3 as GetTaskPushNotificationConfigParams, a7 as ListTaskPushNotificationConfigParams, a9 as DeleteTaskPushNotificationConfigParams, j as JSONRPCResponse, aw as JSONRPCError } from '../extensions-DvruCIzw.js';
 import { S as ServerCallContext, A as A2ARequestHandler } from '../a2a_request_handler-BuP9LgXH.js';
 export { a as UnauthenticatedUser, U as User } from '../a2a_request_handler-BuP9LgXH.js';
 
 type AgentExecutionEvent = Message | Task | TaskStatusUpdateEvent | TaskArtifactUpdateEvent;
+/**
+ * Event names supported by ExecutionEventBus.
+ */
+type ExecutionEventName = 'event' | 'finished';
 interface ExecutionEventBus {
     publish(event: AgentExecutionEvent): void;
-    on(eventName: 'event' | 'finished', listener: (event: AgentExecutionEvent) => void): this;
-    off(eventName: 'event' | 'finished', listener: (event: AgentExecutionEvent) => void): this;
-    once(eventName: 'event' | 'finished', listener: (event: AgentExecutionEvent) => void): this;
-    removeAllListeners(eventName?: 'event' | 'finished'): this;
+    on(eventName: ExecutionEventName, listener: (event: AgentExecutionEvent) => void): this;
+    off(eventName: ExecutionEventName, listener: (event: AgentExecutionEvent) => void): this;
+    once(eventName: ExecutionEventName, listener: (event: AgentExecutionEvent) => void): this;
+    removeAllListeners(eventName?: ExecutionEventName): this;
     finished(): void;
 }
-declare class DefaultExecutionEventBus extends EventEmitter implements ExecutionEventBus {
-    constructor();
+/**
+ * Web-compatible ExecutionEventBus using EventTarget.
+ * Works across all modern runtimes: Node.js 15+, browsers, Cloudflare Workers, Deno, Bun.
+ *
+ * This implementation provides the subset of EventEmitter methods defined in the
+ * ExecutionEventBus interface. Users extending DefaultExecutionEventBus should note
+ * that other EventEmitter methods (e.g., listenerCount, rawListeners) are not available.
+ */
+declare class DefaultExecutionEventBus extends EventTarget implements ExecutionEventBus {
+    private readonly eventListeners;
+    private readonly finishedListeners;
     publish(event: AgentExecutionEvent): void;
     finished(): void;
+    /**
+     * EventEmitter-compatible 'on' method.
+     * Wraps the listener to extract event detail from CustomEvent.
+     * Supports multiple registrations of the same listener (like EventEmitter).
+     * @param eventName The event name to listen for.
+     * @param listener The callback function to invoke when the event is emitted.
+     * @returns This instance for method chaining.
+     */
+    on(eventName: ExecutionEventName, listener: (event: AgentExecutionEvent) => void): this;
+    /**
+     * EventEmitter-compatible 'off' method.
+     * Uses the stored wrapped listener for proper removal.
+     * Removes at most one instance of a listener per call (like EventEmitter).
+     * @param eventName The event name to stop listening for.
+     * @param listener The callback function to remove.
+     * @returns This instance for method chaining.
+     */
+    off(eventName: ExecutionEventName, listener: (event: AgentExecutionEvent) => void): this;
+    /**
+     * EventEmitter-compatible 'once' method.
+     * Listener is automatically removed after first invocation.
+     * Supports multiple registrations of the same listener (like EventEmitter).
+     * @param eventName The event name to listen for once.
+     * @param listener The callback function to invoke when the event is emitted.
+     * @returns This instance for method chaining.
+     */
+    once(eventName: ExecutionEventName, listener: (event: AgentExecutionEvent) => void): this;
+    /**
+     * EventEmitter-compatible 'removeAllListeners' method.
+     * Removes all listeners for a specific event or all events.
+     * @param eventName Optional event name to remove listeners for. If omitted, removes all.
+     * @returns This instance for method chaining.
+     */
+    removeAllListeners(eventName?: ExecutionEventName): this;
+    /**
+     * Adds a wrapped listener to the tracking map.
+     */
+    private trackListener;
+    /**
+     * Removes a wrapped listener from the tracking map (for once cleanup).
+     */
+    private untrackWrappedListener;
+    private addEventListenerInternal;
+    private removeEventListenerInternal;
+    private addEventListenerOnceInternal;
+    private addFinishedListenerInternal;
+    private removeFinishedListenerInternal;
+    private addFinishedListenerOnceInternal;
 }
 
 declare class RequestContext {
@@ -253,4 +313,4 @@ declare class DefaultPushNotificationSender implements PushNotificationSender {
     private _dispatchNotification;
 }
 
-export { A2AError, A2ARequestHandler, type AgentExecutionEvent, type AgentExecutor, DefaultExecutionEventBus, DefaultExecutionEventBusManager, DefaultPushNotificationSender, type DefaultPushNotificationSenderOptions, DefaultRequestHandler, type ExecutionEventBus, type ExecutionEventBusManager, ExecutionEventQueue, type ExtendedAgentCardProvider, InMemoryPushNotificationStore, InMemoryTaskStore, JsonRpcTransportHandler, type PushNotificationSender, type PushNotificationStore, RequestContext, ResultManager, ServerCallContext, type TaskStore };
+export { A2AError, A2ARequestHandler, type AgentExecutionEvent, type AgentExecutor, DefaultExecutionEventBus, DefaultExecutionEventBusManager, DefaultPushNotificationSender, type DefaultPushNotificationSenderOptions, DefaultRequestHandler, type ExecutionEventBus, type ExecutionEventBusManager, type ExecutionEventName, ExecutionEventQueue, type ExtendedAgentCardProvider, InMemoryPushNotificationStore, InMemoryTaskStore, JsonRpcTransportHandler, type PushNotificationSender, type PushNotificationStore, RequestContext, ResultManager, ServerCallContext, type TaskStore };