@artinet/sdk 0.6.0 → 0.6.1

package/README.md

@@ -3,7 +3,7 @@
 <a href="https://www.npmjs.com/package/@artinet/sdk"><img src="https://img.shields.io/npm/v/@artinet/sdk?color=black" alt="Version"></a>
 <a href="https://www.npmjs.com/package/@artinet/sdk"><img src="https://img.shields.io/npm/dt/@artinet/sdk?color=black" alt="Downloads"></a>
 <a><img src="https://img.shields.io/badge/License-Apache_2.0-black.svg" alt="License"></a>
-<a href="https://reddit.com/r/artinet"><img src="https://img.shields.io/reddit/subreddit-subscribers/theartinet?label=reddit&style=flat&color=black" alt="Subreddit"></a>
+<a href="https://reddit.com/r/theartinet"><img src="https://img.shields.io/reddit/subreddit-subscribers/theartinet?label=reddit&style=flat&color=black" alt="Subreddit"></a>
 <a><img src="https://img.shields.io/github/stars/the-artinet-project/artinet-sdk?style=social&color=black" alt="Github"></a>
 <a href="https://snyk.io/test/npm/@artinet/sdk"><img src="https://snyk.io/test/npm/@artinet/sdk/badge.svg" alt="Known Vulnerabilities"></a>
 </p>

package/dist/browser/create/task-builder.js

@@ -177,6 +177,10 @@ const strict_update = (params) => {
     return TaskStatusUpdateEvent.create(params);
 };
 function _buildUpdate(state, params, final) {
+    if (params.message) {
+        params.message.contextId = params.contextId;
+        params.message.taskId = params.taskId;
+    }
     return strict_update({
         taskId: params.taskId,
         contextId: params.contextId,

package/dist/browser/messenger/messenger.d.ts

@@ -9,7 +9,7 @@ export interface MessengerParams {
     baseUrl: URL | string;
     headers?: Record<string, string>;
     fallbackPath?: string;
-    factory?: ClientFactoryOptions;
+    factory?: Partial<ClientFactoryOptions>;
     config?: ClientConfig;
 }
 /**
@@ -76,7 +76,7 @@ declare class Messenger implements Omit<Transport, "getAuthenticatedExtendedAgen
      * @param capability The capability to check (e.g., 'streaming', 'pushNotifications').
      * @returns A promise resolving to true if the capability is supported.
      */
-    supports(capability: "streaming" | "pushNotifications" | "stateTransitionHistory" | "extentions"): Promise<boolean>;
+    supports(capability: "streaming" | "pushNotifications" | "stateTransitionHistory" | "extensions"): Promise<boolean>;
     /**
      * Adds a single header to be included in all requests.
      * @param name The header name.

package/dist/browser/messenger/messenger.js

@@ -6,7 +6,7 @@ import { A2A } from "../types/index.js";
 import { validateSchema } from "../utils/schema-validation.js";
 import { logger } from "../config/index.js";
 import * as describe from "../create/describe.js";
-import { ClientFactory, ClientFactoryOptions, } from "@a2a-js/sdk/client";
+import { ClientFactory, ClientFactoryOptions, AgentCardResolver, } from "@a2a-js/sdk/client";
 class HeaderInterceptor {
     constructor(_getCustomHeaders) {
         this._getCustomHeaders = _getCustomHeaders;
@@ -25,6 +25,33 @@ class HeaderInterceptor {
         return Promise.resolve();
     }
 }
+class NestedAgentCardResolver {
+    constructor(_options) {
+        this._options = _options;
+        this._fetchImpl = _options.fetchImpl ?? fetch;
+    }
+    get options() {
+        return this._options;
+    }
+    async resolve(baseUrl, _path) {
+        const path = _path ?? this._options?.path;
+        const agentCard = await AgentCardResolver.default
+            .resolve(baseUrl, path)
+            .catch((error) => {
+            logger.error("Failed to fetch agent card", { error });
+            return undefined;
+        });
+        if (agentCard) {
+            return agentCard;
+        }
+        logger.warn("Fetching agent card from", { baseUrl });
+        const response = await this._fetchImpl(baseUrl + (path ?? "/well-known/agent-card.json"));
+        if (!response.ok) {
+            throw new Error(`Failed to fetch Agent Card from ${baseUrl}: ${response.status}`);
+        }
+        return await validateSchema(A2A.AgentCardSchema, await response.json());
+    }
+}
 /**
  * Messenger is the main communication client for interacting with remote A2A-compatible services.
  * It provides methods for sending messages, retrieving tasks, canceling operations, and handling streaming responses.
@@ -44,6 +71,7 @@ class Messenger {
                 ],
             },
         }));
+        //RAII
         this.clientPromise = this.reset(this._baseUrl, this._fallbackPath);
     }
     async reset(baseUrl = this._baseUrl, fallbackPath = this._fallbackPath) {
@@ -187,7 +215,7 @@ class Messenger {
                 return !!card.capabilities.pushNotifications;
             case "stateTransitionHistory":
                 return !!card.capabilities.stateTransitionHistory;
-            case "extentions":
+            case "extensions":
                 return !!card.capabilities.extensions;
             default:
                 return false;
@@ -209,7 +237,14 @@ class Messenger {
         delete this.headers[name];
     }
     static async create({ baseUrl, headers, fallbackPath, factory, config, }) {
-        const messenger = new Messenger(baseUrl, headers, fallbackPath, factory, config);
+        const _factory = {
+            ...ClientFactoryOptions.default,
+            cardResolver: new NestedAgentCardResolver({
+                path: "/.well-known/agent-card.json",
+            }),
+            ...factory,
+        };
+        const messenger = new Messenger(baseUrl, headers, fallbackPath, _factory, config);
         const card = await messenger.getAgentCard();
         /**Validate the agent card to ensure the target conforms to the A2A specification */
         await validateSchema(A2A.AgentCardSchema, card).catch((error) => {

package/dist/browser/utils/parse.js

@@ -1,6 +1,9 @@
 import { validateSchema } from "./schema-validation.js";
 import { logger } from "../config/index.js";
 export function safeParse(json) {
+    if (!json || json === "{}" || json === "[]" || json === "") {
+        return {};
+    }
     try {
         return JSON.parse(json);
     }

package/dist/create/task-builder.js

@@ -182,6 +182,10 @@ const strict_update = (params) => {
     return TaskStatusUpdateEvent.create(params);
 };
 function _buildUpdate(state, params, final) {
+    if (params.message) {
+        params.message.contextId = params.contextId;
+        params.message.taskId = params.taskId;
+    }
     return strict_update({
         taskId: params.taskId,
         contextId: params.contextId,

package/dist/messenger/messenger.d.ts

@@ -9,7 +9,7 @@ export interface MessengerParams {
     baseUrl: URL | string;
     headers?: Record<string, string>;
     fallbackPath?: string;
-    factory?: ClientFactoryOptions;
+    factory?: Partial<ClientFactoryOptions>;
     config?: ClientConfig;
 }
 /**
@@ -76,7 +76,7 @@ declare class Messenger implements Omit<Transport, "getAuthenticatedExtendedAgen
      * @param capability The capability to check (e.g., 'streaming', 'pushNotifications').
      * @returns A promise resolving to true if the capability is supported.
      */
-    supports(capability: "streaming" | "pushNotifications" | "stateTransitionHistory" | "extentions"): Promise<boolean>;
+    supports(capability: "streaming" | "pushNotifications" | "stateTransitionHistory" | "extensions"): Promise<boolean>;
     /**
      * Adds a single header to be included in all requests.
      * @param name The header name.

package/dist/messenger/messenger.js

@@ -6,7 +6,7 @@ import { A2A } from "../types/index.js";
 import { validateSchema } from "../utils/schema-validation.js";
 import { logger } from "../config/index.js";
 import * as describe from "../create/describe.js";
-import { ClientFactory, ClientFactoryOptions, } from "@a2a-js/sdk/client";
+import { ClientFactory, ClientFactoryOptions, AgentCardResolver, } from "@a2a-js/sdk/client";
 class HeaderInterceptor {
     _getCustomHeaders;
     constructor(_getCustomHeaders) {
@@ -26,6 +26,35 @@ class HeaderInterceptor {
         return Promise.resolve();
     }
 }
+class NestedAgentCardResolver {
+    _options;
+    _fetchImpl;
+    constructor(_options) {
+        this._options = _options;
+        this._fetchImpl = _options.fetchImpl ?? fetch;
+    }
+    get options() {
+        return this._options;
+    }
+    async resolve(baseUrl, _path) {
+        const path = _path ?? this._options?.path;
+        const agentCard = await AgentCardResolver.default
+            .resolve(baseUrl, path)
+            .catch((error) => {
+            logger.error("Failed to fetch agent card", { error });
+            return undefined;
+        });
+        if (agentCard) {
+            return agentCard;
+        }
+        logger.warn("Fetching agent card from", { baseUrl });
+        const response = await this._fetchImpl(baseUrl + (path ?? "/well-known/agent-card.json"));
+        if (!response.ok) {
+            throw new Error(`Failed to fetch Agent Card from ${baseUrl}: ${response.status}`);
+        }
+        return await validateSchema(A2A.AgentCardSchema, await response.json());
+    }
+}
 /**
  * Messenger is the main communication client for interacting with remote A2A-compatible services.
  * It provides methods for sending messages, retrieving tasks, canceling operations, and handling streaming responses.
@@ -50,6 +79,7 @@ class Messenger {
                 ],
             },
         }));
+        //RAII
         this.clientPromise = this.reset(this._baseUrl, this._fallbackPath);
     }
     async reset(baseUrl = this._baseUrl, fallbackPath = this._fallbackPath) {
@@ -193,7 +223,7 @@ class Messenger {
                 return !!card.capabilities.pushNotifications;
             case "stateTransitionHistory":
                 return !!card.capabilities.stateTransitionHistory;
-            case "extentions":
+            case "extensions":
                 return !!card.capabilities.extensions;
             default:
                 return false;
@@ -215,7 +245,14 @@ class Messenger {
         delete this.headers[name];
     }
     static async create({ baseUrl, headers, fallbackPath, factory, config, }) {
-        const messenger = new Messenger(baseUrl, headers, fallbackPath, factory, config);
+        const _factory = {
+            ...ClientFactoryOptions.default,
+            cardResolver: new NestedAgentCardResolver({
+                path: "/.well-known/agent-card.json",
+            }),
+            ...factory,
+        };
+        const messenger = new Messenger(baseUrl, headers, fallbackPath, _factory, config);
         const card = await messenger.getAgentCard();
         /**Validate the agent card to ensure the target conforms to the A2A specification */
         await validateSchema(A2A.AgentCardSchema, card).catch((error) => {

package/dist/services/a2a/service.js

@@ -12,9 +12,9 @@ import { createService } from "./factory/service.js";
 import { getReferences } from "./helpers/references.js";
 import { logger } from "../../config/index.js";
 const taskToMessageParams = (task) => {
-    const latestUserMessage = task.history
-        ?.filter((msg) => msg.role === "user")
-        ?.pop();
+    const latestUserMessage = task.history?.filter((msg) => msg.role === "user")?.pop() ??
+        /**fallback to the first message if no user message is found */
+        task.history?.[0];
     if (!latestUserMessage) {
         throw INVALID_REQUEST("No user message found");
     }

package/dist/utils/parse.js

@@ -1,6 +1,9 @@
 import { validateSchema } from "./schema-validation.js";
 import { logger } from "../config/index.js";
 export function safeParse(json) {
+    if (!json || json === "{}" || json === "[]" || json === "") {
+        return {};
+    }
     try {
         return JSON.parse(json);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artinet/sdk",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "A TypeScript SDK for building collaborative AI agents.",
   "type": "module",
   "main": "./dist/index.js",
@@ -95,7 +95,7 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/the-artinet-project/artinet"
+    "url": "https://github.com/the-artinet-project/artinet-sdk.git"
   },
   "bugs": {
     "url": "https://github.com/the-artinet-project/artinet/issues"