@artinet/sdk 0.5.13 → 0.5.14

package/README.md

@@ -66,8 +66,9 @@ It has [serveral template projects](https://github.com/the-artinet-project/creat
 - AgentBuilder now prefers the contextId & taskId from the calling context.
 - In a future release the following packages will be set as peer dependancies to reduce the size of the build: `@modelcontextprotocol/sdk`, `@trpc/server`, `cors`, `express`
 - The `history` object from `TaskAndHistory` is deprecated and no longer being updated. Use `Task.history` instead.
-- The A2AClient now checks `/.well-known/agent-card.json` as a opposed to `/.well-known/agent.json` in-line with the A2A spec.
-- The examples folder will be removed in favor of [`create-agent`](https://github.com/the-artinet-project/create-agent)
+- The `A2AClient` now checks `/.well-known/agent-card.json` as a opposed to `/.well-known/agent.json` in-line with the A2A spec.
+- The `A2AClient` now uses uses the `AgentCard`.url if an `AgentCard` has been successfully retrieved, else it will default to the `baseUrl`.
+- The examples folder will be removed in favor of [`create-agent`](https://github.com/the-artinet-project/create-agent).
 
 ## Installation
 

package/dist/client/a2a-client.d.ts

@@ -13,10 +13,20 @@ export declare class A2AClient implements Client {
     private cachedAgentCard;
     private customHeaders;
     private fallbackPath;
+    private agentUrl;
     /**
      * Creates a new A2AClient instance.
      * @param baseUrl The base URL for the A2A server.
      * @param headers Optional custom headers to include in all requests.
+     * @param fallbackPath Optional fallback path to use if the agent card is not found at the base URL.
+     * @example
+     * const client = new A2AClient("http://localhost:4000/a2a");
+     * const card = await client.agentCard();
+     * console.log(card);
+     * @example
+     * const client = new A2AClient("http://localhost:4000/a2a", {}, "/agent-card");
+     * const card = await client.agentCard();
+     * console.log(card);
      */
     constructor(baseUrl: URL | string, headers?: Record<string, string>, fallbackPath?: string);
     /**

package/dist/client/a2a-client.js

@@ -15,15 +15,26 @@ export class A2AClient {
     cachedAgentCard = null;
     customHeaders = {};
     fallbackPath;
+    agentUrl;
     /**
      * Creates a new A2AClient instance.
      * @param baseUrl The base URL for the A2A server.
      * @param headers Optional custom headers to include in all requests.
+     * @param fallbackPath Optional fallback path to use if the agent card is not found at the base URL.
+     * @example
+     * const client = new A2AClient("http://localhost:4000/a2a");
+     * const card = await client.agentCard();
+     * console.log(card);
+     * @example
+     * const client = new A2AClient("http://localhost:4000/a2a", {}, "/agent-card");
+     * const card = await client.agentCard();
+     * console.log(card);
      */
     constructor(baseUrl, headers = {}, fallbackPath) {
         this.baseUrl = typeof baseUrl === "string" ? new URL(baseUrl) : baseUrl;
         this.customHeaders = headers;
         this.fallbackPath = fallbackPath ?? "/agent-card";
+        this.agentUrl = this.baseUrl;
     }
     /**
      * Retrieves the AgentCard from the A2A server.
@@ -46,7 +57,6 @@ export class A2AClient {
                     throw new Error("No agent card found");
                 }
                 this.cachedAgentCard = card;
-                return this.cachedAgentCard;
             }
             catch (error) {
                 const fallbackUrl = new URL(this.fallbackPath, this.baseUrl);
@@ -57,13 +67,14 @@ export class A2AClient {
                     throw new Error("No fallback agent card found");
                 }
                 this.cachedAgentCard = fallbackCard;
-                return this.cachedAgentCard;
             }
         }
         catch (error) {
             logError("A2AClient:agentCard", "Failed to fetch or parse agent card:", error);
             throw INTERNAL_ERROR(`Could not retrieve agent card: ${error instanceof Error ? error.message : String(error)}`);
         }
+        this.agentUrl = new URL(this.cachedAgentCard.url, this.baseUrl);
+        return this.cachedAgentCard;
     }
     /**
      * Refreshes the cached AgentCard by fetching it again from the server.
@@ -79,7 +90,7 @@ export class A2AClient {
      * @returns A promise resolving to Message/Task response from the agent server or null.
      */
     async sendMessage(params) {
-        return await executeJsonRpcRequest(this.baseUrl, "message/send", createMessageSendParams(params), this.customHeaders);
+        return await executeJsonRpcRequest(this.agentUrl, "message/send", createMessageSendParams(params), this.customHeaders);
     }
     /**
      * @deprecated Use sendMessage instead.
@@ -96,7 +107,7 @@ export class A2AClient {
      * @returns An AsyncIterable that yields TaskStatusUpdateEvent/TaskArtifactUpdateEvent/Task/Message payloads.
      */
     sendStreamingMessage(params) {
-        return executeStreamEvents(this.baseUrl, "message/stream", createMessageSendParams(params), this.customHeaders);
+        return executeStreamEvents(this.agentUrl, "message/stream", createMessageSendParams(params), this.customHeaders);
     }
     /**
      * @deprecated Use sendStreamingMessage instead.
@@ -113,7 +124,7 @@ export class A2AClient {
      * @returns A promise resolving to the Task object or null.
      */
     async getTask(params) {
-        return await executeJsonRpcRequest(this.baseUrl, "tasks/get", params, this.customHeaders);
+        return await executeJsonRpcRequest(this.agentUrl, "tasks/get", params, this.customHeaders);
     }
     /**
      * Cancels a currently running task.
@@ -121,7 +132,7 @@ export class A2AClient {
      * @returns A promise resolving to the updated Task object (usually canceled state) or null.
      */
     async cancelTask(params) {
-        return await executeJsonRpcRequest(this.baseUrl, "tasks/cancel", params, this.customHeaders);
+        return await executeJsonRpcRequest(this.agentUrl, "tasks/cancel", params, this.customHeaders);
     }
     /**
      * Sets or updates the push notification config for a task.
@@ -129,7 +140,7 @@ export class A2AClient {
      * @returns A promise resolving to the confirmed TaskPushNotificationConfig or null.
      */
     async setTaskPushNotification(params) {
-        return await executeJsonRpcRequest(this.baseUrl, "tasks/pushNotificationConfig/set", params, this.customHeaders);
+        return await executeJsonRpcRequest(this.agentUrl, "tasks/pushNotificationConfig/set", params, this.customHeaders);
     }
     /**
      * Retrieves the currently configured push notification config for a task.
@@ -137,7 +148,7 @@ export class A2AClient {
      * @returns A promise resolving to the TaskPushNotificationConfig or null.
      */
     async getTaskPushNotification(params) {
-        return await executeJsonRpcRequest(this.baseUrl, "tasks/pushNotificationConfig/get", params, this.customHeaders);
+        return await executeJsonRpcRequest(this.agentUrl, "tasks/pushNotificationConfig/get", params, this.customHeaders);
     }
     /**
      * Resubscribes to an existing task's update stream.
@@ -145,7 +156,7 @@ export class A2AClient {
      * @returns An AsyncIterable that yields TaskStatusUpdateEvent or TaskArtifactUpdateEvent payloads.
      */
     resubscribeTask(params) {
-        return executeStreamEvents(this.baseUrl, "tasks/resubscribe", params, this.customHeaders);
+        return executeStreamEvents(this.agentUrl, "tasks/resubscribe", params, this.customHeaders);
     }
     /**
      * Checks if the server supports a specific capability based on the agent card.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artinet/sdk",
-  "version": "0.5.13",
+  "version": "0.5.14",
   "description": "A TypeScript SDK for building collaborative AI agents.",
   "type": "module",
   "main": "./dist/index.js",