@a2a-js/sdk 0.3.3 → 0.3.5

package/dist/server/index.cjs

@@ -22,8 +22,10 @@ __export(server_exports, {
   A2AError: () => A2AError,
   DefaultExecutionEventBus: () => DefaultExecutionEventBus,
   DefaultExecutionEventBusManager: () => DefaultExecutionEventBusManager,
+  DefaultPushNotificationSender: () => DefaultPushNotificationSender,
   DefaultRequestHandler: () => DefaultRequestHandler,
   ExecutionEventQueue: () => ExecutionEventQueue,
+  InMemoryPushNotificationStore: () => InMemoryPushNotificationStore,
   InMemoryTaskStore: () => InMemoryTaskStore,
   JsonRpcTransportHandler: () => JsonRpcTransportHandler,
   RequestContext: () => RequestContext,
@@ -366,6 +368,109 @@ var ResultManager = class {
   }
 };
 
+// src/server/push_notification/push_notification_store.ts
+var InMemoryPushNotificationStore = class {
+  store = /* @__PURE__ */ new Map();
+  async save(taskId, pushNotificationConfig) {
+    const configs = this.store.get(taskId) || [];
+    if (!pushNotificationConfig.id) {
+      pushNotificationConfig.id = taskId;
+    }
+    const existingIndex = configs.findIndex((config) => config.id === pushNotificationConfig.id);
+    if (existingIndex !== -1) {
+      configs.splice(existingIndex, 1);
+    }
+    configs.push(pushNotificationConfig);
+    this.store.set(taskId, configs);
+  }
+  async load(taskId) {
+    const configs = this.store.get(taskId);
+    return configs || [];
+  }
+  async delete(taskId, configId) {
+    if (configId === void 0) {
+      configId = taskId;
+    }
+    const configs = this.store.get(taskId);
+    if (!configs) {
+      return;
+    }
+    const configIndex = configs.findIndex((config) => config.id === configId);
+    if (configIndex !== -1) {
+      configs.splice(configIndex, 1);
+    }
+    if (configs.length === 0) {
+      this.store.delete(taskId);
+    } else {
+      this.store.set(taskId, configs);
+    }
+  }
+};
+
+// src/server/push_notification/default_push_notification_sender.ts
+var DefaultPushNotificationSender = class {
+  pushNotificationStore;
+  notificationChain;
+  options;
+  constructor(pushNotificationStore, options = {}) {
+    this.pushNotificationStore = pushNotificationStore;
+    this.notificationChain = /* @__PURE__ */ new Map();
+    this.options = {
+      timeout: 5e3,
+      tokenHeaderName: "X-A2A-Notification-Token",
+      ...options
+    };
+  }
+  async send(task) {
+    const pushConfigs = await this.pushNotificationStore.load(task.id);
+    if (!pushConfigs || pushConfigs.length === 0) {
+      return;
+    }
+    const lastPromise = this.notificationChain.get(task.id) ?? Promise.resolve();
+    const newPromise = lastPromise.then(async () => {
+      const dispatches = pushConfigs.map(async (pushConfig) => {
+        try {
+          await this._dispatchNotification(task, pushConfig);
+        } catch (error) {
+          console.error(`Error sending push notification for task_id=${task.id} to URL: ${pushConfig.url}. Error:`, error);
+        }
+      });
+      await Promise.all(dispatches);
+    });
+    this.notificationChain.set(task.id, newPromise);
+    newPromise.finally(() => {
+      if (this.notificationChain.get(task.id) === newPromise) {
+        this.notificationChain.delete(task.id);
+      }
+    });
+  }
+  async _dispatchNotification(task, pushConfig) {
+    const url = pushConfig.url;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.options.timeout);
+    try {
+      const headers = {
+        "Content-Type": "application/json"
+      };
+      if (pushConfig.token) {
+        headers[this.options.tokenHeaderName] = pushConfig.token;
+      }
+      const response = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(task),
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+      }
+      console.info(`Push notification sent for task_id=${task.id} to URL: ${url}`);
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+};
+
 // src/server/request_handler/default_request_handler.ts
 var terminalStates = ["completed", "failed", "canceled", "rejected"];
 var DefaultRequestHandler = class {
@@ -374,14 +479,18 @@ var DefaultRequestHandler = class {
   taskStore;
   agentExecutor;
   eventBusManager;
-  // Store for push notification configurations (could be part of TaskStore or separate)
-  pushNotificationConfigs = /* @__PURE__ */ new Map();
-  constructor(agentCard, taskStore, agentExecutor, eventBusManager = new DefaultExecutionEventBusManager(), extendedAgentCard) {
+  pushNotificationStore;
+  pushNotificationSender;
+  constructor(agentCard, taskStore, agentExecutor, eventBusManager = new DefaultExecutionEventBusManager(), pushNotificationStore, pushNotificationSender, extendedAgentCard) {
     this.agentCard = agentCard;
     this.taskStore = taskStore;
     this.agentExecutor = agentExecutor;
     this.eventBusManager = eventBusManager;
     this.extendedAgentCard = extendedAgentCard;
+    if (agentCard.capabilities.pushNotifications) {
+      this.pushNotificationStore = pushNotificationStore || new InMemoryPushNotificationStore();
+      this.pushNotificationSender = pushNotificationSender || new DefaultPushNotificationSender(this.pushNotificationStore);
+    }
   }
   async getAgentCard() {
     return this.agentCard;
@@ -403,6 +512,8 @@ var DefaultRequestHandler = class {
       if (terminalStates.includes(task.status.state)) {
         throw A2AError.invalidRequest(`Task ${task.id} is in a terminal state (${task.status.state}) and cannot be modified.`);
       }
+      task.history = [...task.history || [], incomingMessage];
+      await this.taskStore.save(task);
     }
     if (incomingMessage.referenceTaskIds && incomingMessage.referenceTaskIds.length > 0) {
       referenceTasks = [];
@@ -433,9 +544,16 @@ var DefaultRequestHandler = class {
     try {
       for await (const event of eventQueue.events()) {
         await resultManager.processEvent(event);
+        await this._sendPushNotificationIfNeeded(event);
         if (options?.firstResultResolver && !firstResultSent) {
-          if (event.kind === "message" || event.kind === "task") {
-            options.firstResultResolver(event);
+          let firstResult;
+          if (event.kind === "message") {
+            firstResult = event;
+          } else {
+            firstResult = resultManager.getCurrentTask();
+          }
+          if (firstResult) {
+            options.firstResultResolver(firstResult);
             firstResultSent = true;
           }
         }
@@ -464,6 +582,9 @@ var DefaultRequestHandler = class {
     resultManager.setContext(incomingMessage);
     const requestContext = await this._createRequestContext(incomingMessage, taskId, false);
     const finalMessageForAgent = requestContext.userMessage;
+    if (params.configuration?.pushNotificationConfig && this.agentCard.capabilities.pushNotifications) {
+      await this.pushNotificationStore?.save(taskId, params.configuration.pushNotificationConfig);
+    }
     const eventBus = this.eventBusManager.createOrGetByTaskId(taskId);
     const eventQueue = new ExecutionEventQueue(eventBus);
     this.agentExecutor.execute(requestContext, eventBus).catch((err) => {
@@ -531,6 +652,9 @@ var DefaultRequestHandler = class {
     const finalMessageForAgent = requestContext.userMessage;
     const eventBus = this.eventBusManager.createOrGetByTaskId(taskId);
     const eventQueue = new ExecutionEventQueue(eventBus);
+    if (params.configuration?.pushNotificationConfig && this.agentCard.capabilities.pushNotifications) {
+      await this.pushNotificationStore?.save(taskId, params.configuration.pushNotificationConfig);
+    }
     this.agentExecutor.execute(requestContext, eventBus).catch((err) => {
       console.error(`Agent execution failed for stream message ${finalMessageForAgent.messageId}:`, err);
       const errorTaskStatus = {
@@ -558,6 +682,7 @@ var DefaultRequestHandler = class {
     try {
       for await (const event of eventQueue.events()) {
         await resultManager.processEvent(event);
+        await this._sendPushNotificationIfNeeded(event);
         yield event;
       }
     } finally {
@@ -589,7 +714,9 @@ var DefaultRequestHandler = class {
     }
     const eventBus = this.eventBusManager.getByTaskId(params.id);
     if (eventBus) {
+      const eventQueue = new ExecutionEventQueue(eventBus);
       await this.agentExecutor.cancelTask(params.id, eventBus);
+      await this._processEvents(params.id, new ResultManager(this.taskStore), eventQueue);
     } else {
       task.status = {
         state: "canceled",
@@ -608,6 +735,12 @@ var DefaultRequestHandler = class {
       await this.taskStore.save(task);
     }
     const latestTask = await this.taskStore.load(params.id);
+    if (!latestTask) {
+      throw A2AError.internalError(`Task ${params.id} not found after cancellation.`);
+    }
+    if (latestTask.status.state != "canceled") {
+      throw A2AError.taskNotCancelable(params.id);
+    }
     return latestTask;
   }
   async setTaskPushNotificationConfig(params) {
@@ -622,10 +755,7 @@ var DefaultRequestHandler = class {
     if (!pushNotificationConfig.id) {
       pushNotificationConfig.id = taskId;
     }
-    const configs = this.pushNotificationConfigs.get(taskId) || [];
-    const updatedConfigs = configs.filter((c) => c.id !== pushNotificationConfig.id);
-    updatedConfigs.push(pushNotificationConfig);
-    this.pushNotificationConfigs.set(taskId, updatedConfigs);
+    await this.pushNotificationStore?.save(taskId, pushNotificationConfig);
     return params;
   }
   async getTaskPushNotificationConfig(params) {
@@ -636,7 +766,7 @@ var DefaultRequestHandler = class {
     if (!task) {
       throw A2AError.taskNotFound(params.id);
     }
-    const configs = this.pushNotificationConfigs.get(params.id) || [];
+    const configs = await this.pushNotificationStore?.load(params.id) || [];
     if (configs.length === 0) {
       throw A2AError.internalError(`Push notification config not found for task ${params.id}.`);
     }
@@ -660,7 +790,7 @@ var DefaultRequestHandler = class {
     if (!task) {
       throw A2AError.taskNotFound(params.id);
     }
-    const configs = this.pushNotificationConfigs.get(params.id) || [];
+    const configs = await this.pushNotificationStore?.load(params.id) || [];
     return configs.map((config) => ({
       taskId: params.id,
       pushNotificationConfig: config
@@ -675,16 +805,7 @@ var DefaultRequestHandler = class {
       throw A2AError.taskNotFound(params.id);
     }
     const { id: taskId, pushNotificationConfigId } = params;
-    const configs = this.pushNotificationConfigs.get(taskId);
-    if (!configs) {
-      return;
-    }
-    const updatedConfigs = configs.filter((c) => c.id !== pushNotificationConfigId);
-    if (updatedConfigs.length === 0) {
-      this.pushNotificationConfigs.delete(taskId);
-    } else if (updatedConfigs.length < configs.length) {
-      this.pushNotificationConfigs.set(taskId, updatedConfigs);
-    }
+    await this.pushNotificationStore?.delete(taskId, pushNotificationConfigId);
   }
   async *resubscribe(params) {
     if (!this.agentCard.capabilities.streaming) {
@@ -719,6 +840,28 @@ var DefaultRequestHandler = class {
       eventQueue.stop();
     }
   }
+  async _sendPushNotificationIfNeeded(event) {
+    if (!this.agentCard.capabilities.pushNotifications) {
+      return;
+    }
+    let taskId = "";
+    if (event.kind == "task") {
+      const task2 = event;
+      taskId = task2.id;
+    } else {
+      taskId = event.taskId;
+    }
+    if (!taskId) {
+      console.error(`Task ID not found for event ${event.kind}.`);
+      return;
+    }
+    const task = await this.taskStore.load(taskId);
+    if (!task) {
+      console.error(`Task ${taskId} not found.`);
+      return;
+    }
+    this.pushNotificationSender?.send(task);
+  }
 };
 
 // src/server/store.ts
@@ -754,10 +897,8 @@ var JsonRpcTransportHandler = class {
       } else {
         throw A2AError.parseError("Invalid request body type.");
       }
-      if (rpcRequest.jsonrpc !== "2.0" || !rpcRequest.method || typeof rpcRequest.method !== "string") {
-        throw A2AError.invalidRequest(
-          "Invalid JSON-RPC request structure."
-        );
+      if (!this.isRequestValid(rpcRequest)) {
+        throw A2AError.invalidRequest("Invalid JSON-RPC Request.");
       }
     } catch (error) {
       const a2aError = error instanceof A2AError ? error : A2AError.parseError(error.message || "Failed to parse JSON request.");
@@ -777,8 +918,8 @@ var JsonRpcTransportHandler = class {
           result
         };
       }
-      if (!rpcRequest.params) {
-        throw A2AError.invalidParams(`'params' is required for '${method}'`);
+      if (!this.paramsAreValid(rpcRequest.params)) {
+        throw A2AError.invalidParams(`Invalid method parameters.`);
       }
       if (method === "message/stream" || method === "tasks/resubscribe") {
         const params = rpcRequest.params;
@@ -853,14 +994,47 @@ var JsonRpcTransportHandler = class {
       };
     }
   }
+  // Validates the basic structure of a JSON-RPC request
+  isRequestValid(rpcRequest) {
+    if (rpcRequest.jsonrpc !== "2.0") {
+      return false;
+    }
+    if ("id" in rpcRequest) {
+      const id = rpcRequest.id;
+      const isString = typeof id === "string";
+      const isInteger = typeof id === "number" && Number.isInteger(id);
+      const isNull = id === null;
+      if (!isString && !isInteger && !isNull) {
+        return false;
+      }
+    }
+    if (!rpcRequest.method || typeof rpcRequest.method !== "string") {
+      return false;
+    }
+    return true;
+  }
+  // Validates that params is an object with non-empty string keys
+  paramsAreValid(params) {
+    if (typeof params !== "object" || params === null || Array.isArray(params)) {
+      return false;
+    }
+    for (const key of Object.keys(params)) {
+      if (key === "") {
+        return false;
+      }
+    }
+    return true;
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   A2AError,
   DefaultExecutionEventBus,
   DefaultExecutionEventBusManager,
+  DefaultPushNotificationSender,
   DefaultRequestHandler,
   ExecutionEventQueue,
+  InMemoryPushNotificationStore,
   InMemoryTaskStore,
   JsonRpcTransportHandler,
   RequestContext,

package/dist/server/index.d.cts

@@ -1,5 +1,5 @@
 import { EventEmitter } from 'events';
-import { B as Message, aw as Task, aO as TaskStatusUpdateEvent, aQ as TaskArtifactUpdateEvent, ac as AgentCard, w as MessageSendParams, V as TaskQueryParams, X as TaskIdParams, Z as TaskPushNotificationConfig, a1 as GetTaskPushNotificationConfigParams, a5 as ListTaskPushNotificationConfigParams, a7 as DeleteTaskPushNotificationConfigParams, i as JSONRPCResponse, au as JSONRPCError } from '../types-DNKcmF0f.cjs';
+import { B as Message, aw as Task, aO as TaskStatusUpdateEvent, aQ as TaskArtifactUpdateEvent, y as PushNotificationConfig, ac as AgentCard, w as MessageSendParams, V as TaskQueryParams, X as TaskIdParams, Z as TaskPushNotificationConfig, a1 as GetTaskPushNotificationConfigParams, a5 as ListTaskPushNotificationConfigParams, a7 as DeleteTaskPushNotificationConfigParams, i as JSONRPCResponse, au as JSONRPCError } from '../types-DNKcmF0f.cjs';
 import { A as A2ARequestHandler } from '../a2a_request_handler-DUvKWfix.cjs';
 
 type AgentExecutionEvent = Message | Task | TaskStatusUpdateEvent | TaskArtifactUpdateEvent;
@@ -119,14 +119,31 @@ declare class InMemoryTaskStore implements TaskStore {
     save(task: Task): Promise<void>;
 }
 
+interface PushNotificationStore {
+    save(taskId: string, pushNotificationConfig: PushNotificationConfig): Promise<void>;
+    load(taskId: string): Promise<PushNotificationConfig[]>;
+    delete(taskId: string, configId?: string): Promise<void>;
+}
+declare class InMemoryPushNotificationStore implements PushNotificationStore {
+    private store;
+    save(taskId: string, pushNotificationConfig: PushNotificationConfig): Promise<void>;
+    load(taskId: string): Promise<PushNotificationConfig[]>;
+    delete(taskId: string, configId?: string): Promise<void>;
+}
+
+interface PushNotificationSender {
+    send(task: Task): Promise<void>;
+}
+
 declare class DefaultRequestHandler implements A2ARequestHandler {
     private readonly agentCard;
     private readonly extendedAgentCard?;
     private readonly taskStore;
     private readonly agentExecutor;
     private readonly eventBusManager;
-    private readonly pushNotificationConfigs;
-    constructor(agentCard: AgentCard, taskStore: TaskStore, agentExecutor: AgentExecutor, eventBusManager?: ExecutionEventBusManager, extendedAgentCard?: AgentCard);
+    private readonly pushNotificationStore?;
+    private readonly pushNotificationSender?;
+    constructor(agentCard: AgentCard, taskStore: TaskStore, agentExecutor: AgentExecutor, eventBusManager?: ExecutionEventBusManager, pushNotificationStore?: PushNotificationStore, pushNotificationSender?: PushNotificationSender, extendedAgentCard?: AgentCard);
     getAgentCard(): Promise<AgentCard>;
     getAuthenticatedExtendedAgentCard(): Promise<AgentCard>;
     private _createRequestContext;
@@ -140,6 +157,7 @@ declare class DefaultRequestHandler implements A2ARequestHandler {
     listTaskPushNotificationConfigs(params: ListTaskPushNotificationConfigParams): Promise<TaskPushNotificationConfig[]>;
     deleteTaskPushNotificationConfig(params: DeleteTaskPushNotificationConfigParams): Promise<void>;
     resubscribe(params: TaskIdParams): AsyncGenerator<Task | TaskStatusUpdateEvent | TaskArtifactUpdateEvent, void, undefined>;
+    private _sendPushNotificationIfNeeded;
 }
 
 declare class ResultManager {
@@ -181,6 +199,8 @@ declare class JsonRpcTransportHandler {
      * For non-streaming methods, it returns a Promise of a single JSONRPCMessage (Result or ErrorResponse).
      */
     handle(requestBody: any): Promise<JSONRPCResponse | AsyncGenerator<JSONRPCResponse, void, undefined>>;
+    private isRequestValid;
+    private paramsAreValid;
 }
 
 /**
@@ -207,4 +227,23 @@ declare class A2AError extends Error {
     static authenticatedExtendedCardNotConfigured(): A2AError;
 }
 
-export { A2AError, A2ARequestHandler, type AgentExecutionEvent, type AgentExecutor, DefaultExecutionEventBus, DefaultExecutionEventBusManager, DefaultRequestHandler, type ExecutionEventBus, type ExecutionEventBusManager, ExecutionEventQueue, InMemoryTaskStore, JsonRpcTransportHandler, RequestContext, ResultManager, type TaskStore };
+interface DefaultPushNotificationSenderOptions {
+    /**
+     * Timeout in milliseconds for the abort controller. Defaults to 5000ms.
+     */
+    timeout?: number;
+    /**
+     * Custom header name for the token. Defaults to 'X-A2A-Notification-Token'.
+     */
+    tokenHeaderName?: string;
+}
+declare class DefaultPushNotificationSender implements PushNotificationSender {
+    private readonly pushNotificationStore;
+    private notificationChain;
+    private readonly options;
+    constructor(pushNotificationStore: PushNotificationStore, options?: DefaultPushNotificationSenderOptions);
+    send(task: Task): Promise<void>;
+    private _dispatchNotification;
+}
+
+export { A2AError, A2ARequestHandler, type AgentExecutionEvent, type AgentExecutor, DefaultExecutionEventBus, DefaultExecutionEventBusManager, DefaultPushNotificationSender, type DefaultPushNotificationSenderOptions, DefaultRequestHandler, type ExecutionEventBus, type ExecutionEventBusManager, ExecutionEventQueue, InMemoryPushNotificationStore, InMemoryTaskStore, JsonRpcTransportHandler, type PushNotificationSender, type PushNotificationStore, RequestContext, ResultManager, type TaskStore };

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from 'events';
-import { B as Message, aw as Task, aO as TaskStatusUpdateEvent, aQ as TaskArtifactUpdateEvent, ac as AgentCard, w as MessageSendParams, V as TaskQueryParams, X as TaskIdParams, Z as TaskPushNotificationConfig, a1 as GetTaskPushNotificationConfigParams, a5 as ListTaskPushNotificationConfigParams, a7 as DeleteTaskPushNotificationConfigParams, i as JSONRPCResponse, au as JSONRPCError } from '../types-DNKcmF0f.js';
+import { B as Message, aw as Task, aO as TaskStatusUpdateEvent, aQ as TaskArtifactUpdateEvent, y as PushNotificationConfig, ac as AgentCard, w as MessageSendParams, V as TaskQueryParams, X as TaskIdParams, Z as TaskPushNotificationConfig, a1 as GetTaskPushNotificationConfigParams, a5 as ListTaskPushNotificationConfigParams, a7 as DeleteTaskPushNotificationConfigParams, i as JSONRPCResponse, au as JSONRPCError } from '../types-DNKcmF0f.js';
 import { A as A2ARequestHandler } from '../a2a_request_handler-B5t-IxgA.js';
 
 type AgentExecutionEvent = Message | Task | TaskStatusUpdateEvent | TaskArtifactUpdateEvent;
@@ -119,14 +119,31 @@ declare class InMemoryTaskStore implements TaskStore {
     save(task: Task): Promise<void>;
 }
 
+interface PushNotificationStore {
+    save(taskId: string, pushNotificationConfig: PushNotificationConfig): Promise<void>;
+    load(taskId: string): Promise<PushNotificationConfig[]>;
+    delete(taskId: string, configId?: string): Promise<void>;
+}
+declare class InMemoryPushNotificationStore implements PushNotificationStore {
+    private store;
+    save(taskId: string, pushNotificationConfig: PushNotificationConfig): Promise<void>;
+    load(taskId: string): Promise<PushNotificationConfig[]>;
+    delete(taskId: string, configId?: string): Promise<void>;
+}
+
+interface PushNotificationSender {
+    send(task: Task): Promise<void>;
+}
+
 declare class DefaultRequestHandler implements A2ARequestHandler {
     private readonly agentCard;
     private readonly extendedAgentCard?;
     private readonly taskStore;
     private readonly agentExecutor;
     private readonly eventBusManager;
-    private readonly pushNotificationConfigs;
-    constructor(agentCard: AgentCard, taskStore: TaskStore, agentExecutor: AgentExecutor, eventBusManager?: ExecutionEventBusManager, extendedAgentCard?: AgentCard);
+    private readonly pushNotificationStore?;
+    private readonly pushNotificationSender?;
+    constructor(agentCard: AgentCard, taskStore: TaskStore, agentExecutor: AgentExecutor, eventBusManager?: ExecutionEventBusManager, pushNotificationStore?: PushNotificationStore, pushNotificationSender?: PushNotificationSender, extendedAgentCard?: AgentCard);
     getAgentCard(): Promise<AgentCard>;
     getAuthenticatedExtendedAgentCard(): Promise<AgentCard>;
     private _createRequestContext;
@@ -140,6 +157,7 @@ declare class DefaultRequestHandler implements A2ARequestHandler {
     listTaskPushNotificationConfigs(params: ListTaskPushNotificationConfigParams): Promise<TaskPushNotificationConfig[]>;
     deleteTaskPushNotificationConfig(params: DeleteTaskPushNotificationConfigParams): Promise<void>;
     resubscribe(params: TaskIdParams): AsyncGenerator<Task | TaskStatusUpdateEvent | TaskArtifactUpdateEvent, void, undefined>;
+    private _sendPushNotificationIfNeeded;
 }
 
 declare class ResultManager {
@@ -181,6 +199,8 @@ declare class JsonRpcTransportHandler {
      * For non-streaming methods, it returns a Promise of a single JSONRPCMessage (Result or ErrorResponse).
      */
     handle(requestBody: any): Promise<JSONRPCResponse | AsyncGenerator<JSONRPCResponse, void, undefined>>;
+    private isRequestValid;
+    private paramsAreValid;
 }
 
 /**
@@ -207,4 +227,23 @@ declare class A2AError extends Error {
     static authenticatedExtendedCardNotConfigured(): A2AError;
 }
 
-export { A2AError, A2ARequestHandler, type AgentExecutionEvent, type AgentExecutor, DefaultExecutionEventBus, DefaultExecutionEventBusManager, DefaultRequestHandler, type ExecutionEventBus, type ExecutionEventBusManager, ExecutionEventQueue, InMemoryTaskStore, JsonRpcTransportHandler, RequestContext, ResultManager, type TaskStore };
+interface DefaultPushNotificationSenderOptions {
+    /**
+     * Timeout in milliseconds for the abort controller. Defaults to 5000ms.
+     */
+    timeout?: number;
+    /**
+     * Custom header name for the token. Defaults to 'X-A2A-Notification-Token'.
+     */
+    tokenHeaderName?: string;
+}
+declare class DefaultPushNotificationSender implements PushNotificationSender {
+    private readonly pushNotificationStore;
+    private notificationChain;
+    private readonly options;
+    constructor(pushNotificationStore: PushNotificationStore, options?: DefaultPushNotificationSenderOptions);
+    send(task: Task): Promise<void>;
+    private _dispatchNotification;
+}
+
+export { A2AError, A2ARequestHandler, type AgentExecutionEvent, type AgentExecutor, DefaultExecutionEventBus, DefaultExecutionEventBusManager, DefaultPushNotificationSender, type DefaultPushNotificationSenderOptions, DefaultRequestHandler, type ExecutionEventBus, type ExecutionEventBusManager, ExecutionEventQueue, InMemoryPushNotificationStore, InMemoryTaskStore, JsonRpcTransportHandler, type PushNotificationSender, type PushNotificationStore, RequestContext, ResultManager, type TaskStore };