@a2a-js/sdk 0.3.2 → 0.3.4

package/dist/client/index.cjs

@@ -28,94 +28,80 @@ module.exports = __toCommonJS(client_exports);
 var AGENT_CARD_PATH = ".well-known/agent-card.json";
 
 // src/client/client.ts
-var A2AClient = class {
+var A2AClient = class _A2AClient {
   agentCardPromise;
   requestIdCounter = 1;
   serviceEndpointUrl;
   // To be populated from AgentCard after fetching
-  fetchImpl;
+  customFetchImpl;
   /**
-   * Constructs an A2AClient instance.
-   * It initiates fetching the agent card from the provided agent baseUrl.
-   * The Agent Card is fetched from a path relative to the agentBaseUrl, which defaults to '.well-known/agent-card.json'.
-   * The `url` field from the Agent Card will be used as the RPC service endpoint.
-   * @param agentBaseUrl The base URL of the A2A agent (e.g., https://agent.example.com)
-   * @param options Optional. The options for the A2AClient including the fetch implementation, agent card path, and authentication handler.
-   */
-  constructor(agentBaseUrl, options) {
-    this.fetchImpl = options?.fetchImpl ?? fetch;
-    this.agentCardPromise = this._fetchAndCacheAgentCard(agentBaseUrl, options?.agentCardPath);
-  }
-  /**
-   * Fetches the Agent Card from the agent's well-known URI and caches its service endpoint URL.
-   * This method is called by the constructor.
-   * @param agentBaseUrl The base URL of the A2A agent (e.g., https://agent.example.com)
-   * @param agentCardPath path to the agent card, defaults to .well-known/agent-card.json
-   * @returns A Promise that resolves to the AgentCard.
+   * Constructs an A2AClient instance from an AgentCard.
+   * @param agentCard The AgentCard object.
+   * @param options Optional. The options for the A2AClient including the fetch/auth implementation.
    */
-  async _fetchAndCacheAgentCard(agentBaseUrl, agentCardPath) {
-    try {
-      const agentCardUrl = this.resolveAgentCardUrl(agentBaseUrl, agentCardPath);
-      const response = await this.fetchImpl(agentCardUrl, {
-        headers: { "Accept": "application/json" }
-      });
-      if (!response.ok) {
-        throw new Error(`Failed to fetch Agent Card from ${agentCardUrl}: ${response.status} ${response.statusText}`);
-      }
-      const agentCard = await response.json();
+  constructor(agentCard, options) {
+    this.customFetchImpl = options?.fetchImpl;
+    if (typeof agentCard === "string") {
+      console.warn("Warning: Constructing A2AClient with a URL is deprecated. Please use A2AClient.fromCardUrl() instead.");
+      this.agentCardPromise = this._fetchAndCacheAgentCard(agentCard, options?.agentCardPath);
+    } else {
       if (!agentCard.url) {
-        throw new Error("Fetched Agent Card does not contain a valid 'url' for the service endpoint.");
+        throw new Error("Provided Agent Card does not contain a valid 'url' for the service endpoint.");
       }
       this.serviceEndpointUrl = agentCard.url;
-      return agentCard;
-    } catch (error) {
-      console.error("Error fetching or parsing Agent Card:", error);
-      throw error;
+      this.agentCardPromise = Promise.resolve(agentCard);
     }
   }
   /**
-   * Retrieves the Agent Card.
-   * If an `agentBaseUrl` is provided, it fetches the card from that specific URL.
-   * Otherwise, it returns the card fetched and cached during client construction.
-   * @param agentBaseUrl Optional. The base URL of the agent to fetch the card from.
-   * @param agentCardPath path to the agent card, defaults to .well-known/agent-card.json
-   * If provided, this will fetch a new card, not use the cached one from the constructor's URL.
-   * @returns A Promise that resolves to the AgentCard.
+   * Dynamically resolves the fetch implementation to use for requests. 
+   * Prefers a custom implementation if provided, otherwise falls back to the global fetch.
+   * @returns The fetch implementation.
+   * @param args Arguments to pass to the fetch implementation.
+   * @throws If no fetch implementation is available.
    */
-  async getAgentCard(agentBaseUrl, agentCardPath) {
-    if (agentBaseUrl) {
-      const agentCardUrl = this.resolveAgentCardUrl(agentBaseUrl, agentCardPath);
-      const response = await this.fetchImpl(agentCardUrl, {
-        headers: { "Accept": "application/json" }
-      });
-      if (!response.ok) {
-        throw new Error(`Failed to fetch Agent Card from ${agentCardUrl}: ${response.status} ${response.statusText}`);
-      }
-      return await response.json();
+  _fetch(...args) {
+    if (this.customFetchImpl) {
+      return this.customFetchImpl(...args);
     }
-    return this.agentCardPromise;
-  }
-  /**
-   * Determines the agent card URL based on the agent URL.
-   * @param agentBaseUrl The agent URL.
-   * @param agentCardPath Optional relative path to the agent card, defaults to .well-known/agent-card.json
-   */
-  resolveAgentCardUrl(agentBaseUrl, agentCardPath = AGENT_CARD_PATH) {
-    return `${agentBaseUrl.replace(/\/$/, "")}/${agentCardPath.replace(/^\//, "")}`;
+    if (typeof fetch === "function") {
+      return fetch(...args);
+    }
+    throw new Error(
+      "A `fetch` implementation was not provided and is not available in the global scope. Please provide a `fetchImpl` in the A2AClientOptions. For earlier Node.js versions (pre-v18), you can use a library like `node-fetch`."
+    );
   }
   /**
-   * Gets the RPC service endpoint URL. Ensures the agent card has been fetched first.
-   * @returns A Promise that resolves to the service endpoint URL string.
+   * Creates an A2AClient instance by fetching the AgentCard from a URL then constructing the A2AClient.
+   * @param agentCardUrl The URL of the agent card.
+   * @param options Optional. The options for the A2AClient including the fetch/auth implementation.
+   * @returns A Promise that resolves to a new A2AClient instance.
    */
-  async _getServiceEndpoint() {
-    if (this.serviceEndpointUrl) {
-      return this.serviceEndpointUrl;
+  static async fromCardUrl(agentCardUrl, options) {
+    const fetchImpl = options?.fetchImpl;
+    const requestInit = {
+      headers: { "Accept": "application/json" }
+    };
+    let response;
+    if (fetchImpl) {
+      response = await fetchImpl(agentCardUrl, requestInit);
+    } else if (typeof fetch === "function") {
+      response = await fetch(agentCardUrl, requestInit);
+    } else {
+      throw new Error(
+        "A `fetch` implementation was not provided and is not available in the global scope. Please provide a `fetchImpl` in the A2AClientOptions. For earlier Node.js versions (pre-v18), you can use a library like `node-fetch`."
+      );
     }
-    await this.agentCardPromise;
-    if (!this.serviceEndpointUrl) {
-      throw new Error("Agent Card URL for RPC endpoint is not available. Fetching might have failed.");
+    if (!response.ok) {
+      throw new Error(`Failed to fetch Agent Card from ${agentCardUrl}: ${response.status} ${response.statusText}`);
     }
-    return this.serviceEndpointUrl;
+    let agentCard;
+    try {
+      agentCard = await response.json();
+    } catch (error) {
+      console.error("Failed to parse Agent Card JSON:", error);
+      throw new Error(`Failed to parse Agent Card JSON from ${agentCardUrl}. Original error: ${error.message}`);
+    }
+    return new _A2AClient(agentCard, options);
   }
   /**
    * Helper method to make a generic JSON-RPC POST request.
@@ -174,7 +160,7 @@ var A2AClient = class {
       },
       body: JSON.stringify(rpcRequest)
     };
-    return this.fetchImpl(url, requestInit);
+    return this._fetch(url, requestInit);
   }
   /**
    * Sends a message to the agent.
@@ -257,6 +243,28 @@ var A2AClient = class {
       params
     );
   }
+  /**
+   * Lists the push notification configurations for a given task.
+   * @param params Parameters containing the taskId.
+   * @returns A Promise resolving to ListTaskPushNotificationConfigResponse.
+   */
+  async listTaskPushNotificationConfig(params) {
+    return this._postRpcRequest(
+      "tasks/pushNotificationConfig/list",
+      params
+    );
+  }
+  /**
+   * Deletes the push notification configuration for a given task.
+   * @param params Parameters containing the taskId and push notification configuration ID.
+   * @returns A Promise resolving to DeleteTaskPushNotificationConfigResponse.
+   */
+  async deleteTaskPushNotificationConfig(params) {
+    return this._postRpcRequest(
+      "tasks/pushNotificationConfig/delete",
+      params
+    );
+  }
   /**
    * Retrieves a task by its ID.
    * @param params Parameters containing the taskId and optional historyLength.
@@ -273,6 +281,17 @@ var A2AClient = class {
   async cancelTask(params) {
     return this._postRpcRequest("tasks/cancel", params);
   }
+  /**
+   * @template TExtensionParams The type of parameters for the custom extension method.
+   * @template TExtensionResponse The type of response expected from the custom extension method. 
+   * This should extend JSONRPCResponse. This ensures the extension response is still a valid A2A response.
+   * @param method Custom JSON-RPC method defined in the AgentCard's extensions.
+   * @param params Extension paramters defined in the AgentCard's extensions.
+   * @returns A Promise that resolves to the RPC response.
+   */
+  async callExtensionMethod(method, params) {
+    return this._postRpcRequest(method, params);
+  }
   /**
    * Resubscribes to a task's event stream using Server-Sent Events (SSE).
    * This is used if a previous SSE connection for an active task was broken.
@@ -294,7 +313,7 @@ var A2AClient = class {
       params,
       id: clientRequestId
     };
-    const response = await this.fetchImpl(endpoint, {
+    const response = await this._fetch(endpoint, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
@@ -409,6 +428,87 @@ var A2AClient = class {
   isErrorResponse(response) {
     return "error" in response;
   }
+  ////////////////////////////////////////////////////////////////////////////////
+  // Functions used to support old A2AClient Constructor to be deprecated soon
+  // TODOs:
+  // * remove `agentCardPromise`, and just use agentCard initialized
+  // * _getServiceEndpoint can be made synchronous or deleted and accessed via
+  //   agentCard.url
+  // * getAgentCard changed to this.agentCard
+  // * delete resolveAgentCardUrl(), _fetchAndCacheAgentCard(),
+  //   agentCardPath from A2AClientOptions
+  ////////////////////////////////////////////////////////////////////////////////
+  /**
+   * Fetches the Agent Card from the agent's well-known URI and caches its service endpoint URL.
+   * This method is called by the constructor.
+   * @param agentBaseUrl The base URL of the A2A agent (e.g., https://agent.example.com)
+   * @param agentCardPath path to the agent card, defaults to .well-known/agent-card.json
+   * @returns A Promise that resolves to the AgentCard.
+   */
+  async _fetchAndCacheAgentCard(agentBaseUrl, agentCardPath) {
+    try {
+      const agentCardUrl = this.resolveAgentCardUrl(agentBaseUrl, agentCardPath);
+      const response = await this._fetch(agentCardUrl, {
+        headers: { "Accept": "application/json" }
+      });
+      if (!response.ok) {
+        throw new Error(`Failed to fetch Agent Card from ${agentCardUrl}: ${response.status} ${response.statusText}`);
+      }
+      const agentCard = await response.json();
+      if (!agentCard.url) {
+        throw new Error("Fetched Agent Card does not contain a valid 'url' for the service endpoint.");
+      }
+      this.serviceEndpointUrl = agentCard.url;
+      return agentCard;
+    } catch (error) {
+      console.error("Error fetching or parsing Agent Card:", error);
+      throw error;
+    }
+  }
+  /**
+  * Retrieves the Agent Card.
+  * If an `agentBaseUrl` is provided, it fetches the card from that specific URL.
+  * Otherwise, it returns the card fetched and cached during client construction.
+  * @param agentBaseUrl Optional. The base URL of the agent to fetch the card from.
+  * @param agentCardPath path to the agent card, defaults to .well-known/agent-card.json
+  * If provided, this will fetch a new card, not use the cached one from the constructor's URL.
+  * @returns A Promise that resolves to the AgentCard.
+  */
+  async getAgentCard(agentBaseUrl, agentCardPath) {
+    if (agentBaseUrl) {
+      const agentCardUrl = this.resolveAgentCardUrl(agentBaseUrl, agentCardPath);
+      const response = await this._fetch(agentCardUrl, {
+        headers: { "Accept": "application/json" }
+      });
+      if (!response.ok) {
+        throw new Error(`Failed to fetch Agent Card from ${agentCardUrl}: ${response.status} ${response.statusText}`);
+      }
+      return await response.json();
+    }
+    return this.agentCardPromise;
+  }
+  /**
+   * Determines the agent card URL based on the agent URL.
+   * @param agentBaseUrl The agent URL.
+   * @param agentCardPath Optional relative path to the agent card, defaults to .well-known/agent-card.json
+   */
+  resolveAgentCardUrl(agentBaseUrl, agentCardPath = AGENT_CARD_PATH) {
+    return `${agentBaseUrl.replace(/\/$/, "")}/${agentCardPath.replace(/^\//, "")}`;
+  }
+  /**
+   * Gets the RPC service endpoint URL. Ensures the agent card has been fetched first.
+   * @returns A Promise that resolves to the service endpoint URL string.
+   */
+  async _getServiceEndpoint() {
+    if (this.serviceEndpointUrl) {
+      return this.serviceEndpointUrl;
+    }
+    await this.agentCardPromise;
+    if (!this.serviceEndpointUrl) {
+      throw new Error("Agent Card URL for RPC endpoint is not available. Fetching might have failed.");
+    }
+    return this.serviceEndpointUrl;
+  }
 };
 
 // src/client/auth-handler.ts

package/dist/client/index.d.cts

@@ -1,4 +1,4 @@
-import { ac as AgentCard, w as MessageSendParams, S as SendMessageResponse, B as Message, aw as Task, aO as TaskStatusUpdateEvent, aQ as TaskArtifactUpdateEvent, Z as TaskPushNotificationConfig, b as SetTaskPushNotificationConfigResponse, X as TaskIdParams, c as GetTaskPushNotificationConfigResponse, V as TaskQueryParams, G as GetTaskResponse, C as CancelTaskResponse, i as JSONRPCResponse, J as JSONRPCErrorResponse } from '../types-DNKcmF0f.cjs';
+import { ac as AgentCard, w as MessageSendParams, S as SendMessageResponse, B as Message, aw as Task, aO as TaskStatusUpdateEvent, aQ as TaskArtifactUpdateEvent, Z as TaskPushNotificationConfig, b as SetTaskPushNotificationConfigResponse, X as TaskIdParams, c as GetTaskPushNotificationConfigResponse, a5 as ListTaskPushNotificationConfigParams, j as ListTaskPushNotificationConfigResponse, a7 as DeleteTaskPushNotificationConfigParams, g as DeleteTaskPushNotificationConfigResponse, V as TaskQueryParams, G as GetTaskResponse, C as CancelTaskResponse, i as JSONRPCResponse, J as JSONRPCErrorResponse } from '../types-DNKcmF0f.cjs';
 
 type A2AStreamEventData = Message | Task | TaskStatusUpdateEvent | TaskArtifactUpdateEvent;
 interface A2AClientOptions {
@@ -12,45 +12,28 @@ declare class A2AClient {
     private agentCardPromise;
     private requestIdCounter;
     private serviceEndpointUrl?;
-    private fetchImpl;
+    private customFetchImpl?;
     /**
-     * Constructs an A2AClient instance.
-     * It initiates fetching the agent card from the provided agent baseUrl.
-     * The Agent Card is fetched from a path relative to the agentBaseUrl, which defaults to '.well-known/agent-card.json'.
-     * The `url` field from the Agent Card will be used as the RPC service endpoint.
-     * @param agentBaseUrl The base URL of the A2A agent (e.g., https://agent.example.com)
-     * @param options Optional. The options for the A2AClient including the fetch implementation, agent card path, and authentication handler.
+     * Constructs an A2AClient instance from an AgentCard.
+     * @param agentCard The AgentCard object.
+     * @param options Optional. The options for the A2AClient including the fetch/auth implementation.
      */
-    constructor(agentBaseUrl: string, options?: A2AClientOptions);
+    constructor(agentCard: AgentCard | string, options?: A2AClientOptions);
     /**
-     * Fetches the Agent Card from the agent's well-known URI and caches its service endpoint URL.
-     * This method is called by the constructor.
-     * @param agentBaseUrl The base URL of the A2A agent (e.g., https://agent.example.com)
-     * @param agentCardPath path to the agent card, defaults to .well-known/agent-card.json
-     * @returns A Promise that resolves to the AgentCard.
+     * Dynamically resolves the fetch implementation to use for requests.
+     * Prefers a custom implementation if provided, otherwise falls back to the global fetch.
+     * @returns The fetch implementation.
+     * @param args Arguments to pass to the fetch implementation.
+     * @throws If no fetch implementation is available.
      */
-    private _fetchAndCacheAgentCard;
+    private _fetch;
     /**
-     * Retrieves the Agent Card.
-     * If an `agentBaseUrl` is provided, it fetches the card from that specific URL.
-     * Otherwise, it returns the card fetched and cached during client construction.
-     * @param agentBaseUrl Optional. The base URL of the agent to fetch the card from.
-     * @param agentCardPath path to the agent card, defaults to .well-known/agent-card.json
-     * If provided, this will fetch a new card, not use the cached one from the constructor's URL.
-     * @returns A Promise that resolves to the AgentCard.
+     * Creates an A2AClient instance by fetching the AgentCard from a URL then constructing the A2AClient.
+     * @param agentCardUrl The URL of the agent card.
+     * @param options Optional. The options for the A2AClient including the fetch/auth implementation.
+     * @returns A Promise that resolves to a new A2AClient instance.
      */
-    getAgentCard(agentBaseUrl?: string, agentCardPath?: string): Promise<AgentCard>;
-    /**
-     * Determines the agent card URL based on the agent URL.
-     * @param agentBaseUrl The agent URL.
-     * @param agentCardPath Optional relative path to the agent card, defaults to .well-known/agent-card.json
-     */
-    private resolveAgentCardUrl;
-    /**
-     * Gets the RPC service endpoint URL. Ensures the agent card has been fetched first.
-     * @returns A Promise that resolves to the service endpoint URL string.
-     */
-    private _getServiceEndpoint;
+    static fromCardUrl(agentCardUrl: string, options?: A2AClientOptions): Promise<A2AClient>;
     /**
      * Helper method to make a generic JSON-RPC POST request.
      * @param method The RPC method name.
@@ -98,6 +81,18 @@ declare class A2AClient {
      * @returns A Promise resolving to GetTaskPushNotificationConfigResponse.
      */
     getTaskPushNotificationConfig(params: TaskIdParams): Promise<GetTaskPushNotificationConfigResponse>;
+    /**
+     * Lists the push notification configurations for a given task.
+     * @param params Parameters containing the taskId.
+     * @returns A Promise resolving to ListTaskPushNotificationConfigResponse.
+     */
+    listTaskPushNotificationConfig(params: ListTaskPushNotificationConfigParams): Promise<ListTaskPushNotificationConfigResponse>;
+    /**
+     * Deletes the push notification configuration for a given task.
+     * @param params Parameters containing the taskId and push notification configuration ID.
+     * @returns A Promise resolving to DeleteTaskPushNotificationConfigResponse.
+     */
+    deleteTaskPushNotificationConfig(params: DeleteTaskPushNotificationConfigParams): Promise<DeleteTaskPushNotificationConfigResponse>;
     /**
      * Retrieves a task by its ID.
      * @param params Parameters containing the taskId and optional historyLength.
@@ -110,6 +105,15 @@ declare class A2AClient {
      * @returns A Promise resolving to CancelTaskResponse, which contains the updated Task object or an error.
      */
     cancelTask(params: TaskIdParams): Promise<CancelTaskResponse>;
+    /**
+     * @template TExtensionParams The type of parameters for the custom extension method.
+     * @template TExtensionResponse The type of response expected from the custom extension method.
+     * This should extend JSONRPCResponse. This ensures the extension response is still a valid A2A response.
+     * @param method Custom JSON-RPC method defined in the AgentCard's extensions.
+     * @param params Extension paramters defined in the AgentCard's extensions.
+     * @returns A Promise that resolves to the RPC response.
+     */
+    callExtensionMethod<TExtensionParams, TExtensionResponse extends JSONRPCResponse>(method: string, params: TExtensionParams): Promise<TExtensionResponse>;
     /**
      * Resubscribes to a task's event stream using Server-Sent Events (SSE).
      * This is used if a previous SSE connection for an active task was broken.
@@ -137,6 +141,35 @@ declare class A2AClient {
      */
     private _processSseEventData;
     isErrorResponse(response: JSONRPCResponse): response is JSONRPCErrorResponse;
+    /**
+     * Fetches the Agent Card from the agent's well-known URI and caches its service endpoint URL.
+     * This method is called by the constructor.
+     * @param agentBaseUrl The base URL of the A2A agent (e.g., https://agent.example.com)
+     * @param agentCardPath path to the agent card, defaults to .well-known/agent-card.json
+     * @returns A Promise that resolves to the AgentCard.
+     */
+    private _fetchAndCacheAgentCard;
+    /**
+   * Retrieves the Agent Card.
+   * If an `agentBaseUrl` is provided, it fetches the card from that specific URL.
+   * Otherwise, it returns the card fetched and cached during client construction.
+   * @param agentBaseUrl Optional. The base URL of the agent to fetch the card from.
+   * @param agentCardPath path to the agent card, defaults to .well-known/agent-card.json
+   * If provided, this will fetch a new card, not use the cached one from the constructor's URL.
+   * @returns A Promise that resolves to the AgentCard.
+   */
+    getAgentCard(agentBaseUrl?: string, agentCardPath?: string): Promise<AgentCard>;
+    /**
+     * Determines the agent card URL based on the agent URL.
+     * @param agentBaseUrl The agent URL.
+     * @param agentCardPath Optional relative path to the agent card, defaults to .well-known/agent-card.json
+     */
+    private resolveAgentCardUrl;
+    /**
+     * Gets the RPC service endpoint URL. Ensures the agent card has been fetched first.
+     * @returns A Promise that resolves to the service endpoint URL string.
+     */
+    private _getServiceEndpoint;
 }
 
 interface HttpHeaders {

package/dist/client/index.d.ts

@@ -1,4 +1,4 @@
-import { ac as AgentCard, w as MessageSendParams, S as SendMessageResponse, B as Message, aw as Task, aO as TaskStatusUpdateEvent, aQ as TaskArtifactUpdateEvent, Z as TaskPushNotificationConfig, b as SetTaskPushNotificationConfigResponse, X as TaskIdParams, c as GetTaskPushNotificationConfigResponse, V as TaskQueryParams, G as GetTaskResponse, C as CancelTaskResponse, i as JSONRPCResponse, J as JSONRPCErrorResponse } from '../types-DNKcmF0f.js';
+import { ac as AgentCard, w as MessageSendParams, S as SendMessageResponse, B as Message, aw as Task, aO as TaskStatusUpdateEvent, aQ as TaskArtifactUpdateEvent, Z as TaskPushNotificationConfig, b as SetTaskPushNotificationConfigResponse, X as TaskIdParams, c as GetTaskPushNotificationConfigResponse, a5 as ListTaskPushNotificationConfigParams, j as ListTaskPushNotificationConfigResponse, a7 as DeleteTaskPushNotificationConfigParams, g as DeleteTaskPushNotificationConfigResponse, V as TaskQueryParams, G as GetTaskResponse, C as CancelTaskResponse, i as JSONRPCResponse, J as JSONRPCErrorResponse } from '../types-DNKcmF0f.js';
 
 type A2AStreamEventData = Message | Task | TaskStatusUpdateEvent | TaskArtifactUpdateEvent;
 interface A2AClientOptions {
@@ -12,45 +12,28 @@ declare class A2AClient {
     private agentCardPromise;
     private requestIdCounter;
     private serviceEndpointUrl?;
-    private fetchImpl;
+    private customFetchImpl?;
     /**
-     * Constructs an A2AClient instance.
-     * It initiates fetching the agent card from the provided agent baseUrl.
-     * The Agent Card is fetched from a path relative to the agentBaseUrl, which defaults to '.well-known/agent-card.json'.
-     * The `url` field from the Agent Card will be used as the RPC service endpoint.
-     * @param agentBaseUrl The base URL of the A2A agent (e.g., https://agent.example.com)
-     * @param options Optional. The options for the A2AClient including the fetch implementation, agent card path, and authentication handler.
+     * Constructs an A2AClient instance from an AgentCard.
+     * @param agentCard The AgentCard object.
+     * @param options Optional. The options for the A2AClient including the fetch/auth implementation.
      */
-    constructor(agentBaseUrl: string, options?: A2AClientOptions);
+    constructor(agentCard: AgentCard | string, options?: A2AClientOptions);
     /**
-     * Fetches the Agent Card from the agent's well-known URI and caches its service endpoint URL.
-     * This method is called by the constructor.
-     * @param agentBaseUrl The base URL of the A2A agent (e.g., https://agent.example.com)
-     * @param agentCardPath path to the agent card, defaults to .well-known/agent-card.json
-     * @returns A Promise that resolves to the AgentCard.
+     * Dynamically resolves the fetch implementation to use for requests.
+     * Prefers a custom implementation if provided, otherwise falls back to the global fetch.
+     * @returns The fetch implementation.
+     * @param args Arguments to pass to the fetch implementation.
+     * @throws If no fetch implementation is available.
      */
-    private _fetchAndCacheAgentCard;
+    private _fetch;
     /**
-     * Retrieves the Agent Card.
-     * If an `agentBaseUrl` is provided, it fetches the card from that specific URL.
-     * Otherwise, it returns the card fetched and cached during client construction.
-     * @param agentBaseUrl Optional. The base URL of the agent to fetch the card from.
-     * @param agentCardPath path to the agent card, defaults to .well-known/agent-card.json
-     * If provided, this will fetch a new card, not use the cached one from the constructor's URL.
-     * @returns A Promise that resolves to the AgentCard.
+     * Creates an A2AClient instance by fetching the AgentCard from a URL then constructing the A2AClient.
+     * @param agentCardUrl The URL of the agent card.
+     * @param options Optional. The options for the A2AClient including the fetch/auth implementation.
+     * @returns A Promise that resolves to a new A2AClient instance.
      */
-    getAgentCard(agentBaseUrl?: string, agentCardPath?: string): Promise<AgentCard>;
-    /**
-     * Determines the agent card URL based on the agent URL.
-     * @param agentBaseUrl The agent URL.
-     * @param agentCardPath Optional relative path to the agent card, defaults to .well-known/agent-card.json
-     */
-    private resolveAgentCardUrl;
-    /**
-     * Gets the RPC service endpoint URL. Ensures the agent card has been fetched first.
-     * @returns A Promise that resolves to the service endpoint URL string.
-     */
-    private _getServiceEndpoint;
+    static fromCardUrl(agentCardUrl: string, options?: A2AClientOptions): Promise<A2AClient>;
     /**
      * Helper method to make a generic JSON-RPC POST request.
      * @param method The RPC method name.
@@ -98,6 +81,18 @@ declare class A2AClient {
      * @returns A Promise resolving to GetTaskPushNotificationConfigResponse.
      */
     getTaskPushNotificationConfig(params: TaskIdParams): Promise<GetTaskPushNotificationConfigResponse>;
+    /**
+     * Lists the push notification configurations for a given task.
+     * @param params Parameters containing the taskId.
+     * @returns A Promise resolving to ListTaskPushNotificationConfigResponse.
+     */
+    listTaskPushNotificationConfig(params: ListTaskPushNotificationConfigParams): Promise<ListTaskPushNotificationConfigResponse>;
+    /**
+     * Deletes the push notification configuration for a given task.
+     * @param params Parameters containing the taskId and push notification configuration ID.
+     * @returns A Promise resolving to DeleteTaskPushNotificationConfigResponse.
+     */
+    deleteTaskPushNotificationConfig(params: DeleteTaskPushNotificationConfigParams): Promise<DeleteTaskPushNotificationConfigResponse>;
     /**
      * Retrieves a task by its ID.
      * @param params Parameters containing the taskId and optional historyLength.
@@ -110,6 +105,15 @@ declare class A2AClient {
      * @returns A Promise resolving to CancelTaskResponse, which contains the updated Task object or an error.
      */
     cancelTask(params: TaskIdParams): Promise<CancelTaskResponse>;
+    /**
+     * @template TExtensionParams The type of parameters for the custom extension method.
+     * @template TExtensionResponse The type of response expected from the custom extension method.
+     * This should extend JSONRPCResponse. This ensures the extension response is still a valid A2A response.
+     * @param method Custom JSON-RPC method defined in the AgentCard's extensions.
+     * @param params Extension paramters defined in the AgentCard's extensions.
+     * @returns A Promise that resolves to the RPC response.
+     */
+    callExtensionMethod<TExtensionParams, TExtensionResponse extends JSONRPCResponse>(method: string, params: TExtensionParams): Promise<TExtensionResponse>;
     /**
      * Resubscribes to a task's event stream using Server-Sent Events (SSE).
      * This is used if a previous SSE connection for an active task was broken.
@@ -137,6 +141,35 @@ declare class A2AClient {
      */
     private _processSseEventData;
     isErrorResponse(response: JSONRPCResponse): response is JSONRPCErrorResponse;
+    /**
+     * Fetches the Agent Card from the agent's well-known URI and caches its service endpoint URL.
+     * This method is called by the constructor.
+     * @param agentBaseUrl The base URL of the A2A agent (e.g., https://agent.example.com)
+     * @param agentCardPath path to the agent card, defaults to .well-known/agent-card.json
+     * @returns A Promise that resolves to the AgentCard.
+     */
+    private _fetchAndCacheAgentCard;
+    /**
+   * Retrieves the Agent Card.
+   * If an `agentBaseUrl` is provided, it fetches the card from that specific URL.
+   * Otherwise, it returns the card fetched and cached during client construction.
+   * @param agentBaseUrl Optional. The base URL of the agent to fetch the card from.
+   * @param agentCardPath path to the agent card, defaults to .well-known/agent-card.json
+   * If provided, this will fetch a new card, not use the cached one from the constructor's URL.
+   * @returns A Promise that resolves to the AgentCard.
+   */
+    getAgentCard(agentBaseUrl?: string, agentCardPath?: string): Promise<AgentCard>;
+    /**
+     * Determines the agent card URL based on the agent URL.
+     * @param agentBaseUrl The agent URL.
+     * @param agentCardPath Optional relative path to the agent card, defaults to .well-known/agent-card.json
+     */
+    private resolveAgentCardUrl;
+    /**
+     * Gets the RPC service endpoint URL. Ensures the agent card has been fetched first.
+     * @returns A Promise that resolves to the service endpoint URL string.
+     */
+    private _getServiceEndpoint;
 }
 
 interface HttpHeaders {