@artinet/sdk 0.6.6 → 0.6.8

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

@@ -4,8 +4,8 @@
  */
 import { A2A } from "../types/index.js";
 import * as describe from "../create/describe.js";
-import { ClientFactoryOptions, ClientConfig, Client, Transport, RequestOptions } from "@a2a-js/sdk/client";
-import { z } from "zod/v4";
+import { ClientFactoryOptions, ClientConfig, Client, Transport, RequestOptions } from '@a2a-js/sdk/client';
+import { z } from 'zod/v4';
 export declare const MessengerParamsSchema: z.ZodObject<{
     headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     authToken: z.ZodOptional<z.ZodString>;
@@ -19,7 +19,7 @@ type BaseMessengerParams = z.infer<typeof MessengerParamsSchema>;
  * @returns True if the parameters are a valid MessengerParams object, false otherwise.
  */
 export declare const isMessengerParams: (params: unknown) => params is MessengerParams;
-export interface MessengerParams extends Omit<BaseMessengerParams, "baseUrl"> {
+export interface MessengerParams extends Omit<BaseMessengerParams, 'baseUrl'> {
     baseUrl: URL | string;
     factory?: Partial<ClientFactoryOptions>;
     config?: ClientConfig;
@@ -28,7 +28,7 @@ export interface MessengerParams extends Omit<BaseMessengerParams, "baseUrl"> {
  * 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.
  */
-declare class Messenger implements Omit<Transport, "getAuthenticatedExtendedAgentCard" | "getExtendedAgentCard"> {
+declare class Messenger implements Omit<Transport, 'getAuthenticatedExtendedAgentCard' | 'getExtendedAgentCard'> {
     private _headers;
     private _fallbackPath?;
     private _baseUrl;
@@ -88,7 +88,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" | "extensions"): 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.
@@ -100,7 +100,7 @@ declare class Messenger implements Omit<Transport, "getAuthenticatedExtendedAgen
      * @param name The header name to remove.
      */
     removeHeader(name: string): void;
-    static create({ baseUrl, headers, fallbackPath, factory, config, }: MessengerParams): Promise<Messenger>;
+    static create({ baseUrl, headers, fallbackPath, factory, config }: MessengerParams): Promise<Messenger>;
 }
 /**
  * Creates a new Messenger instance.

package/dist/browser/messenger/messenger.js

@@ -6,9 +6,9 @@ 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, AgentCardResolver, } from "@a2a-js/sdk/client";
-import { Runtime } from "@artinet/types";
-import { z } from "zod/v4";
+import { ClientFactory, ClientFactoryOptions, AgentCardResolver, } from '@a2a-js/sdk/client';
+import { Runtime } from '@artinet/types';
+import { z } from 'zod/v4';
 class HeaderInterceptor {
     constructor(_getCustomHeaders) {
         this._getCustomHeaders = _getCustomHeaders;
@@ -40,14 +40,14 @@ class NestedAgentCardResolver {
         const agentCard = await AgentCardResolver.default
             .resolve(baseUrl, path)
             .catch((error) => {
-            logger.error("Failed to fetch agent card", { error });
+            logger.debug('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"));
+        logger.debug('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}`);
         }
@@ -77,35 +77,34 @@ class Messenger {
     constructor(baseUrl, _headers = {}, _fallbackPath, factory = ClientFactoryOptions.default, config) {
         this._headers = _headers;
         this._fallbackPath = _fallbackPath;
-        this._baseUrl = typeof baseUrl === "string" ? baseUrl : baseUrl.toString();
-        this._fallbackPath = _fallbackPath ?? "/agent.json";
+        this._baseUrl = typeof baseUrl === 'string' ? baseUrl : baseUrl.toString();
+        this._fallbackPath = _fallbackPath ?? '/agent.json';
         this._factory = new ClientFactory(ClientFactoryOptions.createFrom(factory, {
             clientConfig: {
                 ...config,
-                interceptors: [
-                    ...(config?.interceptors ?? []),
-                    new HeaderInterceptor(() => this.headers),
-                ],
+                interceptors: [...(config?.interceptors ?? []), new HeaderInterceptor(() => this.headers)],
             },
         }));
         //RAII
         this.clientPromise = this.reset(this._baseUrl, this._fallbackPath);
     }
     async reset(baseUrl = this._baseUrl, fallbackPath = this._fallbackPath) {
-        this._baseUrl = typeof baseUrl === "string" ? baseUrl : baseUrl.toString();
-        this._fallbackPath = fallbackPath ?? "/agent.json";
-        this.clientPromise = this._factory
-            .createFromUrl(this._baseUrl)
-            .catch(async (error) => {
+        this._baseUrl = typeof baseUrl === 'string' ? baseUrl : baseUrl.toString();
+        this._fallbackPath = fallbackPath ?? '/agent.json';
+        this.clientPromise = this._factory.createFromUrl(this._baseUrl).catch(async (error) => {
             if (!this._fallbackPath) {
-                logger.error("Messenger: Failed to create client, no fallback path provided", { error });
+                logger.debug('Messenger: Failed to create client, no fallback path provided', { error });
                 throw error;
             }
-            logger.warn("Messenger: Failed to create client, falling back to fallback path: ", { error, fallbackPath: this._fallbackPath });
-            return await this._factory
-                .createFromUrl(this._baseUrl, this._fallbackPath)
-                .catch(async (error) => {
-                logger.error("Messenger: Failed to create client, at fallback path: ", { error, fallbackPath: this._fallbackPath });
+            logger.debug('Messenger: Failed to create client, falling back to fallback path: ', {
+                error,
+                fallbackPath: this._fallbackPath,
+            });
+            return await this._factory.createFromUrl(this._baseUrl, this._fallbackPath).catch(async (error) => {
+                logger.debug('Messenger: Failed to create client, at fallback path: ', {
+                    error,
+                    fallbackPath: this._fallbackPath,
+                });
                 throw error;
             });
         });
@@ -152,7 +151,7 @@ class Messenger {
             yield* client.sendMessageStream(describe.messageSendParams(params), options);
         }
         catch (error) {
-            logger.error("Messenger: Failed to send message stream", { error });
+            logger.error('Messenger: Failed to send message stream', { error });
             throw error;
         }
     }
@@ -211,7 +210,7 @@ class Messenger {
             yield* client.resubscribeTask(params, options);
         }
         catch (error) {
-            logger.error("Messenger: Failed to resubscribe task", { error });
+            logger.error('Messenger: Failed to resubscribe task', { error });
             throw error;
         }
     }
@@ -226,13 +225,13 @@ class Messenger {
             return false;
         }
         switch (capability) {
-            case "streaming":
+            case 'streaming':
                 return !!card.capabilities.streaming;
-            case "pushNotifications":
+            case 'pushNotifications':
                 return !!card.capabilities.pushNotifications;
-            case "stateTransitionHistory":
+            case 'stateTransitionHistory':
                 return !!card.capabilities.stateTransitionHistory;
-            case "extensions":
+            case 'extensions':
                 return !!card.capabilities.extensions;
             default:
                 return false;
@@ -253,11 +252,11 @@ class Messenger {
     removeHeader(name) {
         delete this.headers[name];
     }
-    static async create({ baseUrl, headers, fallbackPath, factory, config, }) {
+    static async create({ baseUrl, headers, fallbackPath, factory, config }) {
         const _factory = {
             ...ClientFactoryOptions.default,
             cardResolver: new NestedAgentCardResolver({
-                path: "/.well-known/agent-card.json",
+                path: '/.well-known/agent-card.json',
             }),
             ...factory,
         };
@@ -265,7 +264,7 @@ class Messenger {
         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) => {
-            logger.warn("Messenger: Invalid agent card detected", { error });
+            logger.warn('Messenger: Invalid agent card detected', { error });
         });
         return messenger;
     }

package/dist/browser/utils/utils.d.ts

@@ -21,12 +21,32 @@ export declare function sleep(ms: number): Promise<void>;
 /**
  * Formats a JSON object into a string with indentation.
  * @param json - The JSON object to format.
+ * @param replacer - A function that transforms the results.
+ * @param space - Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
  * @returns A string representation of the JSON object.
  */
-export declare function formatJson(json: object): string;
+export declare function formatJson(json: object, replacer?: (number | string)[] | null, space?: string | number): string;
 /**
  * Formats an error into a standard error object for logging.
  * @param error - The error to format.
  * @returns A standard error object.
  */
 export declare function formatError(error: unknown): Error;
+/**
+ * Executes a function immediately.
+ * @param fn - The function to execute.
+ * @returns The result of the function.
+ *
+ * @example
+ * ```typescript
+ * const result = iife(() => {
+ *   return 1 + 1;
+ * });
+ * console.log(result); // 2
+ * ```
+ * LangChain <3
+ * @see https://github.com/langchain-ai/langchainjs/blob/981cf9c480925187a524fd6ad1dbf0488d2758eb/libs/langchain-core/src/language_models/utils.ts#L5
+ */
+export declare const iife: <T>(fn: () => T) => T;
+export declare function encodeBase64(data: string): string;
+export declare function decodeBase64(data: string): string;

package/dist/browser/utils/utils.js

@@ -25,10 +25,12 @@ export function sleep(ms) {
 /**
  * Formats a JSON object into a string with indentation.
  * @param json - The JSON object to format.
+ * @param replacer - A function that transforms the results.
+ * @param space - Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
  * @returns A string representation of the JSON object.
  */
-export function formatJson(json) {
-    return JSON.stringify(json, null, 2);
+export function formatJson(json, replacer = null, space = 2) {
+    return JSON.stringify(json, replacer, space);
 }
 /**
  * Formats an error into a standard error object for logging.
@@ -41,3 +43,25 @@ export function formatError(error) {
     }
     return new Error(String(error));
 }
+/**
+ * Executes a function immediately.
+ * @param fn - The function to execute.
+ * @returns The result of the function.
+ *
+ * @example
+ * ```typescript
+ * const result = iife(() => {
+ *   return 1 + 1;
+ * });
+ * console.log(result); // 2
+ * ```
+ * LangChain <3
+ * @see https://github.com/langchain-ai/langchainjs/blob/981cf9c480925187a524fd6ad1dbf0488d2758eb/libs/langchain-core/src/language_models/utils.ts#L5
+ */
+export const iife = (fn) => fn();
+export function encodeBase64(data) {
+    return Buffer.from(data).toString('base64');
+}
+export function decodeBase64(data) {
+    return Buffer.from(data, 'base64').toString();
+}

package/dist/messenger/messenger.d.ts

@@ -4,8 +4,8 @@
  */
 import { A2A } from "../types/index.js";
 import * as describe from "../create/describe.js";
-import { ClientFactoryOptions, ClientConfig, Client, Transport, RequestOptions } from "@a2a-js/sdk/client";
-import { z } from "zod/v4";
+import { ClientFactoryOptions, ClientConfig, Client, Transport, RequestOptions } from '@a2a-js/sdk/client';
+import { z } from 'zod/v4';
 export declare const MessengerParamsSchema: z.ZodObject<{
     headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     authToken: z.ZodOptional<z.ZodString>;
@@ -19,7 +19,7 @@ type BaseMessengerParams = z.infer<typeof MessengerParamsSchema>;
  * @returns True if the parameters are a valid MessengerParams object, false otherwise.
  */
 export declare const isMessengerParams: (params: unknown) => params is MessengerParams;
-export interface MessengerParams extends Omit<BaseMessengerParams, "baseUrl"> {
+export interface MessengerParams extends Omit<BaseMessengerParams, 'baseUrl'> {
     baseUrl: URL | string;
     factory?: Partial<ClientFactoryOptions>;
     config?: ClientConfig;
@@ -28,7 +28,7 @@ export interface MessengerParams extends Omit<BaseMessengerParams, "baseUrl"> {
  * 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.
  */
-declare class Messenger implements Omit<Transport, "getAuthenticatedExtendedAgentCard" | "getExtendedAgentCard"> {
+declare class Messenger implements Omit<Transport, 'getAuthenticatedExtendedAgentCard' | 'getExtendedAgentCard'> {
     private _headers;
     private _fallbackPath?;
     private _baseUrl;
@@ -88,7 +88,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" | "extensions"): 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.
@@ -100,7 +100,7 @@ declare class Messenger implements Omit<Transport, "getAuthenticatedExtendedAgen
      * @param name The header name to remove.
      */
     removeHeader(name: string): void;
-    static create({ baseUrl, headers, fallbackPath, factory, config, }: MessengerParams): Promise<Messenger>;
+    static create({ baseUrl, headers, fallbackPath, factory, config }: MessengerParams): Promise<Messenger>;
 }
 /**
  * Creates a new Messenger instance.

package/dist/messenger/messenger.js

@@ -6,9 +6,9 @@ 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, AgentCardResolver, } from "@a2a-js/sdk/client";
-import { Runtime } from "@artinet/types";
-import { z } from "zod/v4";
+import { ClientFactory, ClientFactoryOptions, AgentCardResolver, } from '@a2a-js/sdk/client';
+import { Runtime } from '@artinet/types';
+import { z } from 'zod/v4';
 class HeaderInterceptor {
     _getCustomHeaders;
     constructor(_getCustomHeaders) {
@@ -43,14 +43,14 @@ class NestedAgentCardResolver {
         const agentCard = await AgentCardResolver.default
             .resolve(baseUrl, path)
             .catch((error) => {
-            logger.error("Failed to fetch agent card", { error });
+            logger.debug('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"));
+        logger.debug('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}`);
         }
@@ -85,35 +85,34 @@ class Messenger {
     constructor(baseUrl, _headers = {}, _fallbackPath, factory = ClientFactoryOptions.default, config) {
         this._headers = _headers;
         this._fallbackPath = _fallbackPath;
-        this._baseUrl = typeof baseUrl === "string" ? baseUrl : baseUrl.toString();
-        this._fallbackPath = _fallbackPath ?? "/agent.json";
+        this._baseUrl = typeof baseUrl === 'string' ? baseUrl : baseUrl.toString();
+        this._fallbackPath = _fallbackPath ?? '/agent.json';
         this._factory = new ClientFactory(ClientFactoryOptions.createFrom(factory, {
             clientConfig: {
                 ...config,
-                interceptors: [
-                    ...(config?.interceptors ?? []),
-                    new HeaderInterceptor(() => this.headers),
-                ],
+                interceptors: [...(config?.interceptors ?? []), new HeaderInterceptor(() => this.headers)],
             },
         }));
         //RAII
         this.clientPromise = this.reset(this._baseUrl, this._fallbackPath);
     }
     async reset(baseUrl = this._baseUrl, fallbackPath = this._fallbackPath) {
-        this._baseUrl = typeof baseUrl === "string" ? baseUrl : baseUrl.toString();
-        this._fallbackPath = fallbackPath ?? "/agent.json";
-        this.clientPromise = this._factory
-            .createFromUrl(this._baseUrl)
-            .catch(async (error) => {
+        this._baseUrl = typeof baseUrl === 'string' ? baseUrl : baseUrl.toString();
+        this._fallbackPath = fallbackPath ?? '/agent.json';
+        this.clientPromise = this._factory.createFromUrl(this._baseUrl).catch(async (error) => {
             if (!this._fallbackPath) {
-                logger.error("Messenger: Failed to create client, no fallback path provided", { error });
+                logger.debug('Messenger: Failed to create client, no fallback path provided', { error });
                 throw error;
             }
-            logger.warn("Messenger: Failed to create client, falling back to fallback path: ", { error, fallbackPath: this._fallbackPath });
-            return await this._factory
-                .createFromUrl(this._baseUrl, this._fallbackPath)
-                .catch(async (error) => {
-                logger.error("Messenger: Failed to create client, at fallback path: ", { error, fallbackPath: this._fallbackPath });
+            logger.debug('Messenger: Failed to create client, falling back to fallback path: ', {
+                error,
+                fallbackPath: this._fallbackPath,
+            });
+            return await this._factory.createFromUrl(this._baseUrl, this._fallbackPath).catch(async (error) => {
+                logger.debug('Messenger: Failed to create client, at fallback path: ', {
+                    error,
+                    fallbackPath: this._fallbackPath,
+                });
                 throw error;
             });
         });
@@ -160,7 +159,7 @@ class Messenger {
             yield* client.sendMessageStream(describe.messageSendParams(params), options);
         }
         catch (error) {
-            logger.error("Messenger: Failed to send message stream", { error });
+            logger.error('Messenger: Failed to send message stream', { error });
             throw error;
         }
     }
@@ -219,7 +218,7 @@ class Messenger {
             yield* client.resubscribeTask(params, options);
         }
         catch (error) {
-            logger.error("Messenger: Failed to resubscribe task", { error });
+            logger.error('Messenger: Failed to resubscribe task', { error });
             throw error;
         }
     }
@@ -234,13 +233,13 @@ class Messenger {
             return false;
         }
         switch (capability) {
-            case "streaming":
+            case 'streaming':
                 return !!card.capabilities.streaming;
-            case "pushNotifications":
+            case 'pushNotifications':
                 return !!card.capabilities.pushNotifications;
-            case "stateTransitionHistory":
+            case 'stateTransitionHistory':
                 return !!card.capabilities.stateTransitionHistory;
-            case "extensions":
+            case 'extensions':
                 return !!card.capabilities.extensions;
             default:
                 return false;
@@ -261,11 +260,11 @@ class Messenger {
     removeHeader(name) {
         delete this.headers[name];
     }
-    static async create({ baseUrl, headers, fallbackPath, factory, config, }) {
+    static async create({ baseUrl, headers, fallbackPath, factory, config }) {
         const _factory = {
             ...ClientFactoryOptions.default,
             cardResolver: new NestedAgentCardResolver({
-                path: "/.well-known/agent-card.json",
+                path: '/.well-known/agent-card.json',
             }),
             ...factory,
         };
@@ -273,7 +272,7 @@ class Messenger {
         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) => {
-            logger.warn("Messenger: Invalid agent card detected", { error });
+            logger.warn('Messenger: Invalid agent card detected', { error });
         });
         return messenger;
     }

package/dist/services/a2a/helpers/content.js

@@ -2,7 +2,7 @@
  * Copyright 2025 The Artinet Project
  * SPDX-License-Identifier: Apache-2.0
  */
-import { getParts } from "./part.js";
+import { getParts } from './part.js';
 /**
  * Extracts the content of an agent response.
  * @param input - The input event.
@@ -17,16 +17,16 @@ export function extractTextContent(input, legacy = true) {
         []);
     if (legacy) {
         return (parts.text ??
-            parts.file?.map((file) => file.bytes).join("\n") ??
-            parts.file?.map((file) => file.uri).join("\n") ??
-            parts.data?.map((data) => JSON.stringify(data)).join("\n") ??
+            parts.file?.map((file) => file.bytes).join('\n') ??
+            parts.file?.map((file) => file.uri).join('\n') ??
+            parts.data?.map((data) => JSON.stringify(data)).join('\n') ??
             undefined);
     }
-    return parts.text && parts.text !== ""
+    return parts.text && parts.text !== ''
         ? parts.text
-        : parts.file?.map((file) => file.bytes ?? file.uri).join("\n") ??
-            parts.data?.map((data) => JSON.stringify(data)).join("\n") ??
-            undefined;
+        : (parts.file?.map((file) => file.bytes ?? file.uri).join('\n') ??
+            parts.data?.map((data) => JSON.stringify(data)).join('\n') ??
+            undefined);
 }
 /**
  * @deprecated Use extractTextContent instead.

package/dist/services/a2a/service.d.ts

@@ -3,7 +3,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { A2A } from "../../types/index.js";
-import { ServiceParams } from "./factory/service.js";
+import { ServiceParams } from './factory/service.js';
 /**
  * @note We endeavor to remove all optional parameters from below this class.
  * This will allow the service to act as the boundary to our Hexagonal Architecture.
@@ -30,9 +30,9 @@ export declare class Service implements A2A.Service {
     get contexts(): A2A.Contexts;
     set contexts(contexts: A2A.Contexts);
     get streams(): A2A.Streams;
-    get overrides(): Partial<Omit<A2A.EventConsumer, "contextId">> | undefined;
-    set overrides(overrides: Partial<Omit<A2A.EventConsumer, "contextId">>);
-    execute({ engine, context, }: {
+    get overrides(): Partial<Omit<A2A.EventConsumer, 'contextId'>> | undefined;
+    set overrides(overrides: Partial<Omit<A2A.EventConsumer, 'contextId'>>);
+    execute({ engine, context }: {
         engine: A2A.Engine;
         context: A2A.Context;
     }): Promise<void>;
@@ -41,11 +41,11 @@ export declare class Service implements A2A.Service {
     getTask(params: A2A.TaskQueryParams, options?: A2A.ServiceOptions): Promise<A2A.Task>;
     cancelTask(params: A2A.TaskIdParams, options?: A2A.ServiceOptions): Promise<A2A.Task>;
     sendMessage(params: A2A.MessageSendParams, options?: A2A.ServiceOptions): Promise<A2A.SendMessageSuccessResult>;
-    sendMessage(message: string | A2A.MessageSendParams["message"], options?: A2A.ServiceOptions): Promise<A2A.SendMessageSuccessResult>;
+    sendMessage(message: string | A2A.MessageSendParams['message'], options?: A2A.ServiceOptions): Promise<A2A.SendMessageSuccessResult>;
     protected _sendMessage(params: A2A.MessageSendParams, options?: A2A.ServiceOptions): Promise<A2A.SendMessageSuccessResult>;
     sendMessageStream(params: A2A.MessageSendParams, options?: A2A.ServiceOptions): AsyncGenerator<A2A.Update>;
     sendMessageStream(message: string, options?: A2A.ServiceOptions): AsyncGenerator<A2A.Update>;
-    sendMessageStream(params: A2A.MessageSendParams["message"], options?: A2A.ServiceOptions): AsyncGenerator<A2A.Update>;
+    sendMessageStream(params: A2A.MessageSendParams['message'], options?: A2A.ServiceOptions): AsyncGenerator<A2A.Update>;
     /**
      * @deprecated Use sendMessageStream instead
      */

package/dist/services/a2a/service.js

@@ -6,21 +6,20 @@ import { A2A } from "../../types/index.js";
 import { validateSchema } from "../../utils/schema-validation.js";
 import * as describe from "../../create/describe.js";
 import { INVALID_REQUEST, TASK_NOT_FOUND } from "../../utils/errors.js";
-import { Messenger } from "./messenger.js";
-import { execute } from "./execute.js";
-import { createService } from "./factory/service.js";
-import { getReferences } from "./helpers/references.js";
+import { Messenger } from './messenger.js';
+import { execute } from './execute.js';
+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");
+        throw INVALID_REQUEST('No user message found');
     }
-    if (latestUserMessage.contextId &&
-        latestUserMessage.contextId !== task.contextId) {
-        throw INVALID_REQUEST("User message context ID does not match task context ID");
+    if (latestUserMessage.contextId && latestUserMessage.contextId !== task.contextId) {
+        throw INVALID_REQUEST('User message context ID does not match task context ID');
     }
     const messageParams = {
         message: {
@@ -49,13 +48,13 @@ const bindNotifier = async (context, taskId, config, notifier) => {
     if (!notifier || !config) {
         return;
     }
-    context.publisher.on("update", async (task, update) => {
+    context.publisher.on('update', async (task, update) => {
         await notifier.notify(task, update, context).catch((error) => {
-            logger.error("Error sending push notification: ", { error });
+            logger.error('Error sending push notification: ', { error });
         });
     });
     await notifier.register(taskId, config).catch((error) => {
-        logger.error("Error registering push notification: ", { error });
+        logger.error('Error registering push notification: ', { error });
     });
 };
 /**
@@ -114,10 +113,12 @@ export class Service {
         return this._contexts;
     }
     set contexts(contexts) {
-        this._contexts = {
-            ...this._contexts,
-            ...contexts,
-        };
+        this._contexts.list().then((list) => {
+            list.forEach((context) => {
+                contexts.set(context.contextId, context);
+            });
+        });
+        this._contexts = contexts;
     }
     get streams() {
         return this._streams;
@@ -131,7 +132,7 @@ export class Service {
             ...overrides,
         };
     }
-    async execute({ engine, context, }) {
+    async execute({ engine, context }) {
         await execute(engine, context);
     }
     async getAgentCard() {
@@ -143,7 +144,7 @@ export class Service {
             await context.publisher.onCancel(describe.update.canceled({
                 contextId: context.contextId,
                 taskId: context.taskId,
-                message: describe.message("service stopped"),
+                message: describe.message('service stopped'),
             }));
         }
         return;
@@ -233,8 +234,7 @@ export class Service {
     }
     async *sendMessageStream(_params, options) {
         let params;
-        if (typeof _params === "string" ||
-            (typeof _params === "object" && "parts" in _params)) {
+        if (typeof _params === 'string' || (typeof _params === 'object' && 'parts' in _params)) {
             params = describe.messageSendParams(_params);
         }
         else {
@@ -252,7 +252,7 @@ export class Service {
     }
     async *_sendMessageStream(params, options) {
         const messageParams = await validateSchema(A2A.MessageSendParamsSchema, params);
-        logger.info("Service[streamMessage]:", {
+        logger.info('Service[streamMessage]:', {
             taskId: messageParams.message.taskId,
             contextId: messageParams.message.contextId,
         });
@@ -265,7 +265,7 @@ export class Service {
                     ...messageParams.metadata,
                 },
             }));
-        logger.debug("Service[streamMessage]: task created", {
+        logger.debug('Service[streamMessage]: task created', {
             taskId: task.id,
             contextId: task.contextId,
         });
@@ -294,7 +294,7 @@ export class Service {
         if (!task) {
             throw TASK_NOT_FOUND({ taskId: taskParams.id });
         }
-        logger.debug("Service[resubscribe]:", {
+        logger.debug('Service[resubscribe]:', {
             taskId: task.id,
             contextId: task.contextId,
         });

package/dist/services/core/manager.js

@@ -72,9 +72,9 @@ export class Manager {
     async list() {
         const listed = Array.from(this.cache.values());
         if (this.storage) {
+            const storedList = (await this.storage.list?.())?.filter((item) => item !== undefined && !listed.includes(item));
             /** Could be an expensive operation */
-            listed.push(...((await this.storage.list?.())?.filter((item) => item !== undefined && !listed.includes(item)) ??
-                []));
+            listed.push(...(storedList ?? []));
         }
         return listed;
     }
@@ -88,7 +88,14 @@ export class Manager {
         }
         const results = [];
         if (filter) {
-            results.push(...Array.from(this.cache.values()).filter(filter));
+            const items = Array.from(this.cache.values());
+            const filterResults = await Promise.all(items.map(async (item) => {
+                if (await filter(item)) {
+                    return item;
+                }
+                return undefined;
+            }));
+            results.push(...filterResults.filter((item) => item !== undefined));
         }
         if (this.storage) {
             const storageFilter = async (item) => {

package/dist/services/mcp/modules/mem.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Copyright 2026 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod/v4';
+/**
+ * Configuration for mounting an in-memory MCP server.
+ */
+declare const InMemoryParamsSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        factory: "factory";
+        constructor: "constructor";
+    }>;
+    target: z.ZodString;
+    module: z.ZodString;
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type InMemoryParams = z.infer<typeof InMemoryParamsSchema>;
+/**
+ * Mounts an MCP server in-memory for direct integration.
+ * Creates a linked transport pair for client-server communication without network overhead.
+ * @docs https://modelcontextprotocol.io/docs/concepts/transports#in-memory
+ *
+ * @param params - {@link InMemoryParams} Configuration for the server module
+ * @param extract - Optional function to extract the McpServer from the imported module.
+ *                  Use when the module's export structure doesn't match standard factory/constructor patterns.
+ * @example
+ * ```typescript
+ * import { mountMemServer } from "@artinet/sdk/mcp/mem";
+ * import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+ *
+ * // Mount a server using a factory function with custom extraction
+ * const { server, clientTransport } = await mountMemServer(
+ *   {
+ *     type: "factory",
+ *     target: "createServer",
+ *     module: "@modelcontextprotocol/server-everything/dist/everything.js",
+ *   },
+ *   (module) => module.createServer().server
+ * );
+ *
+ * // Connect a client to the in-memory server
+ * const client = new Client({ name: "my-client", version: "1.0.0" });
+ * await client.connect(clientTransport);
+ *
+ * // Use the client
+ * const tools = await client.listTools();
+ * ```
+ * @returns Promise containing the {@link McpServer} instance and linked transport pair
+ */
+export declare function mountMemServer(params: InMemoryParams, extract?: (module: any) => McpServer): Promise<{
+    serverTransport: InMemoryTransport;
+    clientTransport: InMemoryTransport;
+    server: McpServer;
+}>;
+export {};

package/dist/services/mcp/modules/mem.js

@@ -0,0 +1,112 @@
+/**
+ * Copyright 2026 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';
+import { logger } from "../../../config/index.js";
+import { z } from 'zod/v4';
+/**
+ * Configuration for mounting an in-memory MCP server.
+ */
+const InMemoryParamsSchema = z.object({
+    /** Whether to invoke the target as a factory function or constructor */
+    type: z.enum(['factory', 'constructor']),
+    /** The name of the exported factory function or constructor class */
+    target: z.string(),
+    /** The module path to dynamically import (e.g., '@modelcontextprotocol/server-everything/dist/everything.js') */
+    module: z.string(),
+    /** Optional arguments to pass to the factory function or constructor */
+    args: z.record(z.string(), z.unknown()).optional(),
+});
+/**
+ * Mounts an MCP server in-memory for direct integration.
+ * Creates a linked transport pair for client-server communication without network overhead.
+ * @docs https://modelcontextprotocol.io/docs/concepts/transports#in-memory
+ *
+ * @param params - {@link InMemoryParams} Configuration for the server module
+ * @param extract - Optional function to extract the McpServer from the imported module.
+ *                  Use when the module's export structure doesn't match standard factory/constructor patterns.
+ * @example
+ * ```typescript
+ * import { mountMemServer } from "@artinet/sdk/mcp/mem";
+ * import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+ *
+ * // Mount a server using a factory function with custom extraction
+ * const { server, clientTransport } = await mountMemServer(
+ *   {
+ *     type: "factory",
+ *     target: "createServer",
+ *     module: "@modelcontextprotocol/server-everything/dist/everything.js",
+ *   },
+ *   (module) => module.createServer().server
+ * );
+ *
+ * // Connect a client to the in-memory server
+ * const client = new Client({ name: "my-client", version: "1.0.0" });
+ * await client.connect(clientTransport);
+ *
+ * // Use the client
+ * const tools = await client.listTools();
+ * ```
+ * @returns Promise containing the {@link McpServer} instance and linked transport pair
+ */
+export async function mountMemServer(params, extract) {
+    const [serverTransport, clientTransport] = InMemoryTransport.createLinkedPair();
+    //IFFE
+    const modules = (() => {
+        const modules = new Map();
+        return async (moduleName) => {
+            if (modules.has(moduleName)) {
+                return modules.get(moduleName);
+            }
+            const module = await import(moduleName).catch((error) => {
+                logger.error(`Failed to import module ${moduleName}`, error);
+                throw error;
+            });
+            if (module) {
+                modules.set(moduleName, module);
+            }
+            return module;
+        };
+    })();
+    const module = await modules(params.module).catch((error) => {
+        logger.error(`Failed to import module ${params.module}`, error);
+        throw error;
+    });
+    if (!module) {
+        logger.warn(`Failed to import module ${params.module}`);
+        throw new Error(`Failed to import module ${params.module}`);
+    }
+    let server;
+    if (extract) {
+        server = extract(module);
+    }
+    else if (params.type === 'factory') {
+        const factory = module[params.target];
+        if (!factory) {
+            const error = new Error(`Failed to find factory ${params.target} in module ${params.module}`);
+            logger.error(error.message, error);
+            throw error;
+        }
+        server = factory(params.args);
+    }
+    else {
+        const constructor = module[params.target];
+        if (!constructor) {
+            const error = new Error(`Failed to find constructor ${params.target} in module ${params.module}`);
+            logger.error(error.message, error);
+            throw error;
+        }
+        server = new constructor(params.args);
+    }
+    if (!server?.connect) {
+        const error = new Error(`Server ${params.target} does not have a connect method`);
+        logger.error(error.message, error);
+        throw error;
+    }
+    await server.connect(serverTransport).catch((error) => {
+        logger.error(`Failed to connect to server ${params.target}`, error);
+        throw error;
+    });
+    return { serverTransport, clientTransport, server };
+}

package/dist/utils/utils.d.ts

@@ -21,12 +21,32 @@ export declare function sleep(ms: number): Promise<void>;
 /**
  * Formats a JSON object into a string with indentation.
  * @param json - The JSON object to format.
+ * @param replacer - A function that transforms the results.
+ * @param space - Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
  * @returns A string representation of the JSON object.
  */
-export declare function formatJson(json: object): string;
+export declare function formatJson(json: object, replacer?: (number | string)[] | null, space?: string | number): string;
 /**
  * Formats an error into a standard error object for logging.
  * @param error - The error to format.
  * @returns A standard error object.
  */
 export declare function formatError(error: unknown): Error;
+/**
+ * Executes a function immediately.
+ * @param fn - The function to execute.
+ * @returns The result of the function.
+ *
+ * @example
+ * ```typescript
+ * const result = iife(() => {
+ *   return 1 + 1;
+ * });
+ * console.log(result); // 2
+ * ```
+ * LangChain <3
+ * @see https://github.com/langchain-ai/langchainjs/blob/981cf9c480925187a524fd6ad1dbf0488d2758eb/libs/langchain-core/src/language_models/utils.ts#L5
+ */
+export declare const iife: <T>(fn: () => T) => T;
+export declare function encodeBase64(data: string): string;
+export declare function decodeBase64(data: string): string;

package/dist/utils/utils.js

@@ -25,10 +25,12 @@ export function sleep(ms) {
 /**
  * Formats a JSON object into a string with indentation.
  * @param json - The JSON object to format.
+ * @param replacer - A function that transforms the results.
+ * @param space - Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
  * @returns A string representation of the JSON object.
  */
-export function formatJson(json) {
-    return JSON.stringify(json, null, 2);
+export function formatJson(json, replacer = null, space = 2) {
+    return JSON.stringify(json, replacer, space);
 }
 /**
  * Formats an error into a standard error object for logging.
@@ -41,3 +43,25 @@ export function formatError(error) {
     }
     return new Error(String(error));
 }
+/**
+ * Executes a function immediately.
+ * @param fn - The function to execute.
+ * @returns The result of the function.
+ *
+ * @example
+ * ```typescript
+ * const result = iife(() => {
+ *   return 1 + 1;
+ * });
+ * console.log(result); // 2
+ * ```
+ * LangChain <3
+ * @see https://github.com/langchain-ai/langchainjs/blob/981cf9c480925187a524fd6ad1dbf0488d2758eb/libs/langchain-core/src/language_models/utils.ts#L5
+ */
+export const iife = (fn) => fn();
+export function encodeBase64(data) {
+    return Buffer.from(data).toString('base64');
+}
+export function decodeBase64(data) {
+    return Buffer.from(data, 'base64').toString();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@artinet/sdk",
-    "version": "0.6.6",
+    "version": "0.6.8",
     "description": "A TypeScript SDK for building collaborative AI agents.",
     "type": "module",
     "main": "./dist/index.js",
@@ -22,6 +22,11 @@
             "import": "./dist/services/mcp/index.js",
             "default": "./dist/services/mcp/index.js"
         },
+        "./mcp/mem": {
+            "types": "./dist/services/mcp/modules/mem.d.ts",
+            "import": "./dist/services/mcp/modules/mem.js",
+            "default": "./dist/services/mcp/modules/mem.js"
+        },
         "./serverless": {
             "types": "./dist/server/express/serverless/index.d.ts",
             "import": "./dist/server/express/serverless/index.js",
@@ -154,6 +159,7 @@
         "@cfworker/json-schema": "^4.1.1",
         "@eslint/js": "^9.25.1",
         "@modelcontextprotocol/sdk": "^1.24.3",
+        "@modelcontextprotocol/server-everything": "^2026.1.14",
         "@opentelemetry/api": "^1.9.0",
         "@trpc/server": "^11.4.3",
         "@types/cors": "^2.8.17",