@artinet/sdk 0.5.18 → 0.6.0-preview.1

package/dist/browser/types/a2a/builder.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MessageSendParams, DataPart, FilePart, TextPart } from "@artinet/types/a2a";
+import { Context } from "./a2a.js";
+/**
+ * Restricting to command for now, but could be extended to other types of commands in the future.
+ * When we shift to CoreCommand, move this into core.
+ */
+export interface StepArgs {
+    message: MessageSendParams;
+    context: Context;
+    skip: () => Promise<void> | void;
+}
+export type BaseArgs = Record<string, unknown>;
+export type EmptyArgs = Record<string, never>;
+export type StepParams<TInboundArgs extends BaseArgs = EmptyArgs> = StepArgs & Partial<{
+    content: string;
+    args: TInboundArgs;
+}>;
+export type PartContent = DataPart["data"] | FilePart["file"] | TextPart["text"];
+export type StepOutput<TPart extends PartContent> = {
+    parts: Array<TPart> | TPart;
+};
+export type StepOutputWithForwardArgs<TPart extends PartContent, TForwardArgs extends BaseArgs = EmptyArgs> = StepOutput<TPart> & {
+    args: TForwardArgs;
+};
+export type OutputType<TPart extends PartContent, TForwardArgs extends BaseArgs = EmptyArgs> = StepOutput<TPart> | StepOutputWithForwardArgs<TPart, TForwardArgs> | Array<TPart> | TPart;
+export type Step<TPart extends PartContent = TextPart["text"], TInboundArgs extends BaseArgs = EmptyArgs, TForwardArgs extends BaseArgs = EmptyArgs, TOutput extends OutputType<TPart, TForwardArgs> = OutputType<TPart, TForwardArgs>> = (params: StepParams<TInboundArgs>) => Promise<TOutput> | TOutput;
+export type StepWithKind<TPart extends PartContent = TextPart["text"], TInboundArgs extends BaseArgs = EmptyArgs, TForwardArgs extends BaseArgs = EmptyArgs, TOutput extends OutputType<TPart, TForwardArgs> = OutputType<TPart, TForwardArgs>, TKind extends "text" | "file" | "data" = "text"> = {
+    step: Step<TPart, TInboundArgs, TForwardArgs, TOutput>;
+    kind: TKind;
+};
+export type OutArgsOf<O> = O extends StepOutputWithForwardArgs<any, infer A> ? A : EmptyArgs;
+export interface StepBuilder<TInboundArgs extends BaseArgs = EmptyArgs> {
+    /**
+     * Add a step to the builder.
+     * @param step - The step to add.
+     * @returns A new builder with the step added.
+     */
+    addStep<TPart extends PartContent = TextPart["text"], TForwardArgs extends BaseArgs = EmptyArgs, TOutput extends OutputType<TPart, TForwardArgs> = OutputType<TPart, TForwardArgs>, TKind extends "text" | "file" | "data" = "text">(step: StepWithKind<TPart, TInboundArgs, TForwardArgs, TOutput, TKind>): StepBuilder<OutArgsOf<TOutput>>;
+}

package/dist/browser/types/a2a/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./builder.js";
+export * as A2A from "./a2a.js";
+export type { Engine as AgentEngine } from "./a2a.js";

package/dist/browser/types/a2a/index.js

@@ -0,0 +1,2 @@
+export * from "./builder.js";
+export * as A2A from "./a2a.js";

package/dist/{types/interfaces → browser/types}/client.d.ts

@@ -2,9 +2,7 @@
  * Copyright 2025 The Artinet Project
  * SPDX-License-Identifier: Apache-2.0
  */
-import { TaskPushNotificationConfig, TaskIdParams, Task } from "../schemas/a2a/index.js";
-import type { AgentCard, TaskQueryParams, MessageSendParams, Message } from "../schemas/a2a/index.js";
-import { UpdateEvent } from "./services/a2a/index.js";
+import { A2A } from "./a2a/index.js";
 /**
  * @interface Client
  * @description Defines the standard contract for an A2A (Agent-to-Agent) client implementation.
@@ -19,24 +17,24 @@ export interface Client {
      * The AgentCard contains essential information about the agent, such as its capabilities and endpoints.
      * @param {string} wellKnownPath The standard path (e.g., "/.well-known/a2a") to look for the AgentCard.
      * @param {string} fallbackPath An alternative path to check if the well-known path fails.
-     * @returns {Promise<AgentCard>} A promise that resolves with the AgentCard object.
+     * @returns {Promise<A2A.AgentCard>} A promise that resolves with the AgentCard object.
      * @async
      */
-    agentCard(): Promise<AgentCard>;
+    agentCard(): Promise<A2A.AgentCard>;
     /**
      * @description Refreshes the cached AgentCard information by re-fetching it from the server.
      * Useful when the agent's capabilities or configuration might have changed.
-     * @returns {Promise<AgentCard>} A promise that resolves with the updated AgentCard object.
+     * @returns {Promise<A2A.AgentCard>} A promise that resolves with the updated AgentCard object.
      * @async
      */
-    refreshAgentCard(): Promise<AgentCard>;
+    refreshAgentCard(): Promise<A2A.AgentCard>;
     /**
      * @description Sends a task request to the agent server.
-     * @param {MessageSendParams} params Parameters required to send the task, including the task definition and metadata.
-     * @returns {Promise<Task | null>} A promise that resolves with the initial Task object representing the submitted task, or null if the submission failed.
+     * @param {A2A.MessageSendParams} params Parameters required to send the task, including the task definition and metadata.
+     * @returns {Promise<A2A.Task | null>} A promise that resolves with the initial Task object representing the submitted task, or null if the submission failed.
      * @async
      */
-    sendMessage(params: MessageSendParams): Promise<Message | Task | null>;
+    sendMessage(params: A2A.MessageSendParams): Promise<A2A.Message | A2A.Task | null>;
     /**
      * @deprecated Will be removed in v6.Use sendMessage instead.
      * @description Sends a task request to the agent server.
@@ -44,7 +42,7 @@ export interface Client {
      * @returns {Promise<Task | null>} A promise that resolves with the initial Task object representing the submitted task, or null if the submission failed.
      * @async
      */
-    sendTask(params: MessageSendParams): Promise<Message | Task | null>;
+    sendTask(params: A2A.MessageSendParams): Promise<A2A.Message | A2A.Task | null>;
     /**
      * @description Sends a task request and subscribes to real-time updates (status changes, artifact updates) for that task.
      * This uses a streaming connection if available.
@@ -52,7 +50,7 @@ export interface Client {
      * @returns {AsyncIterable<UpdateEvent>} An async iterable that yields task status and artifact updates.
      * @async
      */
-    sendStreamingMessage(params: MessageSendParams): AsyncIterable<UpdateEvent>;
+    sendStreamingMessage(params: A2A.MessageSendParams): AsyncIterable<A2A.Update>;
     /**
      * @deprecated Will be removed in v6Use sendStreamingMessage instead.
      * @description Sends a task request and subscribes to real-time updates (status changes, artifact updates) for that task.
@@ -61,45 +59,45 @@ export interface Client {
      * @returns {AsyncIterable<UpdateEvent>} An async iterable that yields task status and artifact updates.
      * @async
      */
-    sendTaskSubscribe(params: MessageSendParams): AsyncIterable<UpdateEvent>;
+    sendTaskSubscribe(params: A2A.MessageSendParams): AsyncIterable<A2A.Update>;
     /**
      * @description Retrieves the current state of a specific task by its ID.
-     * @param {TaskQueryParams} params Parameters containing the task ID to query.
-     * @returns {Promise<Task | null>} A promise that resolves with the Task object, or null if the task is not found.
+     * @param {A2A.TaskQueryParams} params Parameters containing the task ID to query.
+     * @returns {Promise<A2A.Task | null>} A promise that resolves with the Task object, or null if the task is not found.
      * @async
      */
-    getTask(params: TaskQueryParams): Promise<Task | null>;
+    getTask(params: A2A.TaskQueryParams): Promise<A2A.Task | null>;
     /**
      * @description Sends a request to cancel an ongoing task.
-     * @param {TaskIdParams} params Parameters containing the ID of the task to cancel.
-     * @returns {Promise<Task | null>} A promise that resolves with the final state of the cancelled Task object, or null if cancellation failed or the task wasn't found.
+     * @param {A2A.TaskIdParams} params Parameters containing the ID of the task to cancel.
+     * @returns {Promise<A2A.Task | null>} A promise that resolves with the final state of the cancelled Task object, or null if cancellation failed or the task wasn't found.
      * @async
      */
-    cancelTask(params: TaskIdParams): Promise<Task | null>;
+    cancelTask(params: A2A.TaskIdParams): Promise<A2A.Task | null>;
     /**
      * @description Configures push notifications for a specific task. This allows the client
      * to receive updates asynchronously via a specified webhook URL.
      * Requires the agent to support the 'pushNotifications' capability.
-     * @param {TaskPushNotificationConfig} params The configuration details for the push notification, including the task ID and webhook URL.
-     * @returns {Promise<TaskPushNotificationConfig | null>} A promise that resolves with the applied configuration, or null if the configuration failed.
+     * @param {A2A.TaskPushNotificationConfig} params The configuration details for the push notification, including the task ID and webhook URL.
+     * @returns {Promise<A2A.TaskPushNotificationConfig | null>} A promise that resolves with the applied configuration, or null if the configuration failed.
      * @async
      */
-    setTaskPushNotification(params: TaskPushNotificationConfig): Promise<TaskPushNotificationConfig | null>;
+    setTaskPushNotification(params: A2A.TaskPushNotificationConfig): Promise<A2A.TaskPushNotificationConfig | null>;
     /**
      * @description Retrieves the current push notification configuration for a specific task.
-     * @param {TaskIdParams} params Parameters containing the task ID.
-     * @returns {Promise<TaskPushNotificationConfig | null>} A promise that resolves with the push notification configuration, or null if not configured or not found.
+     * @param {A2A.TaskIdParams} params Parameters containing the task ID.
+     * @returns {Promise<A2A.TaskPushNotificationConfig | null>} A promise that resolves with the push notification configuration, or null if not configured or not found.
      * @async
      */
-    getTaskPushNotification(params: TaskIdParams): Promise<TaskPushNotificationConfig | null>;
+    getTaskPushNotification(params: A2A.TaskIdParams): Promise<A2A.TaskPushNotificationConfig | null>;
     /**
      * @description Resubscribes to updates for an existing task, potentially after a connection drop or client restart.
      * This allows resuming the stream of status and artifact updates.
-     * @param {TaskQueryParams} params Parameters containing the task ID to resubscribe to.
+     * @param {A2A.TaskQueryParams} params Parameters containing the task ID to resubscribe to.
      * @returns {AsyncIterable<UpdateEvent>} An async iterable that yields task status and artifact updates.
      * @async
      */
-    resubscribeTask(params: TaskQueryParams): AsyncIterable<UpdateEvent>;
+    resubscribeTask(params: A2A.TaskQueryParams): AsyncIterable<A2A.Update>;
     /**
      * @description Checks if the agent server supports a specific capability.
      * @param {"streaming" | "pushNotifications" | "stateTransitionHistory"} capability The capability to check for.

package/dist/browser/types/core/core.d.ts

@@ -0,0 +1,31 @@
+import { EventEmitter } from "events";
+export interface Service<Params extends object = object, Result extends unknown = void> {
+    execute: (params: Params) => Promise<Result>;
+    stop: () => Promise<void>;
+}
+export interface Context<State extends object = object> {
+    readonly contextId: string;
+    readonly isCancelled: () => Promise<boolean>;
+    readonly abortSignal: AbortSignal;
+    readonly messages?: AsyncIterable<unknown>;
+    readonly publisher?: Publisher;
+    readonly getState: (args?: string) => Promise<State | undefined>;
+    metadata?: Record<string, unknown>;
+    readonly hooks?: Record<string, (...args: unknown[]) => Promise<unknown>>;
+}
+export interface Manager<T = object> {
+    get: (id: string) => Promise<T | undefined>;
+    set: (id: string, data?: T) => Promise<void>;
+    delete: (id: string) => Promise<void>;
+    has?: (id: string) => Promise<boolean>;
+    list?: () => Promise<T[]>;
+}
+export type Optional<T extends object = object> = Partial<T> & {
+    contextId: string;
+};
+export interface Contexts<T extends Context = Context> extends Manager<T> {
+}
+export interface Publisher<EventMap extends Record<string, any[]> = Record<string, any[]>> extends EventEmitter<EventMap> {
+}
+export interface Consumer<Received extends unknown, EventMap extends Record<string, any[]> = Record<string, any[]>> extends AsyncIterable<Received, Received, Received | undefined>, Publisher<EventMap> {
+}

package/dist/browser/types/core/index.d.ts

@@ -0,0 +1 @@
+export * as core from "./core.js";

package/dist/browser/types/core/index.js

@@ -0,0 +1 @@
+export * as core from "./core.js";

package/dist/browser/types/index.d.ts

@@ -1,4 +1,7 @@
-export * from "./ext.js";
-export * from "./schemas/index.js";
-export * from "./interfaces/index.js";
+export * from "./a2a/index.js";
+export * from "./core/index.js";
+export * from "./mcp/index.js";
+export * from "./client.js";
+export * from "./protocol.js";
+export * from "./storage.js";
 export * from "./utils/index.js";

package/dist/browser/types/index.js

@@ -1,4 +1,7 @@
-export * from "./ext.js";
-export * from "./schemas/index.js";
-export * from "./interfaces/index.js";
+export * from "./a2a/index.js";
+export * from "./core/index.js";
+export * from "./mcp/index.js";
+export * from "./client.js";
+export * from "./protocol.js";
+export * from "./storage.js";
 export * from "./utils/index.js";

package/dist/browser/types/mcp/index.d.ts

@@ -0,0 +1 @@
+export * as MCP from "./mcp.js";

package/dist/browser/types/mcp/index.js

@@ -0,0 +1 @@
+export * as MCP from "./mcp.js";

package/dist/browser/types/{interfaces/services/mcp/service.d.ts → mcp/mcp.d.ts}

@@ -10,11 +10,11 @@
  * managing service lifecycle.
  *
  * @module MCPService
- * @version 0.5.7
+ * @version 0.6.0-preview
  * @since 0.5.7
  * @author The Artinet Project
  */
-import { ServiceInterface } from "../core/index.js";
+import { core } from "../core/index.js";
 /**
  * Main interface for MCP service implementations.
  *
@@ -40,10 +40,11 @@ import { ServiceInterface } from "../core/index.js";
  * @public
  * @since 0.5.7
  */
-export interface MCPServiceInterface extends Omit<ServiceInterface, "execute"> {
+export interface Service extends Omit<core.Service, "execute"> {
     /**
      * Registers tools for the MCP service.
      * @param uri - The URI of the agent card resource.
      */
     registerTools?: (uri: string) => void;
 }
+export * from "@artinet/types/mcp";

package/dist/browser/types/{interfaces/services/a2a/context.js → mcp/mcp.js}

@@ -2,4 +2,4 @@
  * Copyright 2025 The Artinet Project
  * SPDX-License-Identifier: Apache-2.0
  */
-export {};
+export * from "@artinet/types/mcp";

package/dist/browser/types/storage.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Interface for a store of data.
+ * @deprecated Use IStore instead
+ * @template T - The type of data to store
+ */
+export interface Store<T> {
+    set(data: T, id?: string): Promise<void>;
+    get(id: string): Promise<T | undefined>;
+}
+/**
+ * Interface for a store of data.
+ * @template T - The type of data to store
+ */
+export interface IStore<T> {
+    set(id: string, data: T): Promise<void>;
+    get(id: string): Promise<T | undefined>;
+}

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

@@ -2,10 +2,10 @@
  * Copyright 2025 The Artinet Project
  * SPDX-License-Identifier: Apache-2.0
  */
-import { TaskState, TaskStatusUpdateEvent, Message } from "../../types/index.js";
-export declare const STATUS_UPDATE: (taskId: string, contextId: string, status: TaskState, message?: Message, timestamp?: string, final?: boolean) => TaskStatusUpdateEvent;
-export declare const WORKING_UPDATE: (taskId: string, contextId: string, message?: Message, timestamp?: string) => TaskStatusUpdateEvent;
-export declare const CANCEL_UPDATE: (taskId: string, contextId: string, message?: Message, timestamp?: string) => TaskStatusUpdateEvent;
-export declare const SUBMITTED_UPDATE: (taskId: string, contextId: string, message?: Message, timestamp?: string) => TaskStatusUpdateEvent;
-export declare const FAILED_UPDATE_EVENT: (taskId: string, contextId: string, message?: Message, timestamp?: string) => TaskStatusUpdateEvent;
-export declare const FINAL_STATES: TaskState[];
+import { A2A } from "../../types/index.js";
+export declare const STATUS_UPDATE: (taskId: string, contextId: string, status: A2A.TaskState, message?: A2A.Message, timestamp?: string, final?: boolean) => A2A.TaskStatusUpdateEvent;
+export declare const WORKING_UPDATE: (taskId: string, contextId: string, message?: A2A.Message, timestamp?: string) => A2A.TaskStatusUpdateEvent;
+export declare const CANCEL_UPDATE: (taskId: string, contextId: string, message?: A2A.Message, timestamp?: string) => A2A.TaskStatusUpdateEvent;
+export declare const SUBMITTED_UPDATE: (taskId: string, contextId: string, message?: A2A.Message, timestamp?: string) => A2A.TaskStatusUpdateEvent;
+export declare const FAILED_UPDATE_EVENT: (taskId: string, contextId: string, message?: A2A.Message, timestamp?: string) => A2A.TaskStatusUpdateEvent;
+export declare const FINAL_STATES: A2A.TaskState[];

package/dist/browser/utils/common/constants.js

@@ -2,7 +2,7 @@
  * Copyright 2025 The Artinet Project
  * SPDX-License-Identifier: Apache-2.0
  */
-import { TaskState } from "../../types/index.js";
+import { A2A } from "../../types/index.js";
 import { getCurrentTimestamp } from "./utils.js";
 //todo: protocol specific so move to a2a folder
 export const STATUS_UPDATE = (taskId, contextId, status, message, timestamp = getCurrentTimestamp(), final = false) => {
@@ -19,20 +19,20 @@ export const STATUS_UPDATE = (taskId, contextId, status, message, timestamp = ge
     };
 };
 export const WORKING_UPDATE = (taskId, contextId, message, timestamp) => {
-    return STATUS_UPDATE(taskId, contextId, TaskState.working, message, timestamp);
+    return STATUS_UPDATE(taskId, contextId, A2A.TaskState.working, message, timestamp);
 };
 export const CANCEL_UPDATE = (taskId, contextId, message, timestamp) => {
-    return STATUS_UPDATE(taskId, contextId, TaskState.canceled, message, timestamp, true);
+    return STATUS_UPDATE(taskId, contextId, A2A.TaskState.canceled, message, timestamp, true);
 };
 export const SUBMITTED_UPDATE = (taskId, contextId, message, timestamp) => {
-    return STATUS_UPDATE(taskId, contextId, TaskState.submitted, message, timestamp);
+    return STATUS_UPDATE(taskId, contextId, A2A.TaskState.submitted, message, timestamp);
 };
 export const FAILED_UPDATE_EVENT = (taskId, contextId, message, timestamp) => {
-    return STATUS_UPDATE(taskId, contextId, TaskState.failed, message, timestamp, true);
+    return STATUS_UPDATE(taskId, contextId, A2A.TaskState.failed, message, timestamp, true);
 };
 export const FINAL_STATES = [
-    TaskState.completed,
-    TaskState.failed,
-    TaskState.canceled,
-    TaskState.rejected,
+    A2A.TaskState.completed,
+    A2A.TaskState.failed,
+    A2A.TaskState.canceled,
+    A2A.TaskState.rejected,
 ];

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

@@ -2,23 +2,23 @@
  * Copyright 2025 The Artinet Project
  * SPDX-License-Identifier: Apache-2.0
  */
-import { A2AError, InvalidParamsError, InvalidRequestError, JSONRPCError, MethodNotFoundError, InternalError, TaskNotFoundError, TaskNotCancelableError, ContentTypeNotSupportedError, InvalidAgentResponseError, TaskStatusUpdateEvent, JSONParseError, AuthenticatedExtendedCardNotConfiguredError } from "../../types/index.js";
-export declare class SystemError<T extends JSONRPCError> extends Error {
+import { A2A, MCP } from "../../types/index.js";
+export declare class SystemError<T extends MCP.JSONRPCError> extends Error {
     message: string;
-    code: T["code"];
-    data: T["data"];
-    constructor(message: string, code: T["code"], data: T["data"]);
+    code: T["error"]["code"];
+    data: T["error"]["data"];
+    constructor(message: string, code: T["error"]["code"], data: T["error"]["data"]);
 }
-export declare const PARSE_ERROR: <T extends JSONParseError>(data: T["data"]) => SystemError<T>;
-export declare const INVALID_REQUEST: <T extends InvalidRequestError>(data: T["data"]) => SystemError<T>;
-export declare const METHOD_NOT_FOUND: <T extends MethodNotFoundError>(data: T["data"]) => SystemError<T>;
-export declare const INVALID_PARAMS: <T extends InvalidParamsError>(data: T["data"]) => SystemError<T>;
-export declare const INTERNAL_ERROR: <T extends InternalError>(data: T["data"]) => SystemError<T>;
-export declare const TASK_NOT_FOUND: <T extends TaskNotFoundError>(data: T["data"]) => SystemError<T>;
-export declare const TASK_NOT_CANCELABLE: <T extends TaskNotCancelableError>(data: T["data"]) => SystemError<T>;
-export declare const PUSH_NOTIFICATION_NOT_SUPPORTED: <T extends A2AError>(data: T["data"]) => SystemError<T>;
-export declare const AUTHENTICATED_EXTENDED_CARD_NOT_CONFIGURED: <T extends AuthenticatedExtendedCardNotConfiguredError>(data: T["data"]) => SystemError<T>;
-export declare const UNSUPPORTED_OPERATION: <T extends A2AError>(data: T["data"]) => SystemError<T>;
-export declare const CONTENT_TYPE_NOT_SUPPORTED: <T extends ContentTypeNotSupportedError>(data: T["data"]) => SystemError<T>;
-export declare const INVALID_AGENT_RESPONSE: <T extends InvalidAgentResponseError>(data: T["data"]) => SystemError<T>;
-export declare const FAILED_UPDATE: (taskId: string, contextId: string, messageId: string | undefined, errMessage: string) => TaskStatusUpdateEvent;
+export declare const PARSE_ERROR: <T extends A2A.JSONParseError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const INVALID_REQUEST: <T extends A2A.InvalidRequestError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const METHOD_NOT_FOUND: <T extends A2A.MethodNotFoundError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const INVALID_PARAMS: <T extends A2A.InvalidParamsError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const INTERNAL_ERROR: <T extends A2A.InternalError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const TASK_NOT_FOUND: <T extends A2A.TaskNotFoundError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const TASK_NOT_CANCELABLE: <T extends A2A.TaskNotCancelableError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const PUSH_NOTIFICATION_NOT_SUPPORTED: <T extends A2A.A2AError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const AUTHENTICATED_EXTENDED_CARD_NOT_CONFIGURED: <T extends A2A.AuthenticatedExtendedCardNotConfiguredError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const UNSUPPORTED_OPERATION: <T extends A2A.A2AError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const CONTENT_TYPE_NOT_SUPPORTED: <T extends A2A.ContentTypeNotSupportedError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const INVALID_AGENT_RESPONSE: <T extends A2A.InvalidAgentResponseError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const FAILED_UPDATE: (taskId: string, contextId: string, messageId: string | undefined, errMessage: string) => A2A.TaskStatusUpdateEvent;

package/dist/browser/utils/common/errors.js

@@ -2,7 +2,7 @@
  * Copyright 2025 The Artinet Project
  * SPDX-License-Identifier: Apache-2.0
  */
-import { ErrorCodeInternalError, ErrorCodeInvalidRequest, ErrorCodeMethodNotFound, ErrorCodeParseError, ErrorCodeInvalidParams, ErrorCodeTaskNotFound, ErrorCodeTaskNotCancelable, ErrorCodeUnsupportedOperation, ErrorCodePushNotificationNotSupported, ErrorCodeContentTypeNotSupported, ErrorCodeInvalidAgentResponse, TaskState, ErrorCodeAuthenticatedExtendedCardNotConfigured, } from "../../types/index.js";
+import { A2A } from "../../types/index.js";
 export class SystemError extends Error {
     constructor(message, code, data) {
         super(message);
@@ -13,25 +13,25 @@ export class SystemError extends Error {
     }
 }
 // Factory methods for common errors
-export const PARSE_ERROR = (data) => new SystemError("Invalid JSON payload", ErrorCodeParseError, data);
-export const INVALID_REQUEST = (data) => new SystemError("Request payload validation error", ErrorCodeInvalidRequest, data);
-export const METHOD_NOT_FOUND = (data) => new SystemError("Method not found", ErrorCodeMethodNotFound, data);
-export const INVALID_PARAMS = (data) => new SystemError("Invalid parameters", ErrorCodeInvalidParams, data);
-export const INTERNAL_ERROR = (data) => new SystemError("Internal error", ErrorCodeInternalError, data);
-export const TASK_NOT_FOUND = (data) => new SystemError("Task not found", ErrorCodeTaskNotFound, data);
-export const TASK_NOT_CANCELABLE = (data) => new SystemError("Task cannot be canceled", ErrorCodeTaskNotCancelable, data);
-export const PUSH_NOTIFICATION_NOT_SUPPORTED = (data) => new SystemError("Push Notifications is not supported", ErrorCodePushNotificationNotSupported, data);
-export const AUTHENTICATED_EXTENDED_CARD_NOT_CONFIGURED = (data) => new SystemError("Authenticated Extended Card is not configured", ErrorCodeAuthenticatedExtendedCardNotConfigured, data);
-export const UNSUPPORTED_OPERATION = (data) => new SystemError("This operation is not supported", ErrorCodeUnsupportedOperation, data);
-export const CONTENT_TYPE_NOT_SUPPORTED = (data) => new SystemError("Content type not supported", ErrorCodeContentTypeNotSupported, data);
-export const INVALID_AGENT_RESPONSE = (data) => new SystemError("Invalid agent response", ErrorCodeInvalidAgentResponse, data);
+export const PARSE_ERROR = (data) => new SystemError("Invalid JSON payload", A2A.ErrorCodeParseError, data);
+export const INVALID_REQUEST = (data) => new SystemError("Request payload validation error", A2A.ErrorCodeInvalidRequest, data);
+export const METHOD_NOT_FOUND = (data) => new SystemError("Method not found", A2A.ErrorCodeMethodNotFound, data);
+export const INVALID_PARAMS = (data) => new SystemError("Invalid parameters", A2A.ErrorCodeInvalidParams, data);
+export const INTERNAL_ERROR = (data) => new SystemError("Internal error", A2A.ErrorCodeInternalError, data);
+export const TASK_NOT_FOUND = (data) => new SystemError("Task not found", A2A.ErrorCodeTaskNotFound, data);
+export const TASK_NOT_CANCELABLE = (data) => new SystemError("Task cannot be canceled", A2A.ErrorCodeTaskNotCancelable, data);
+export const PUSH_NOTIFICATION_NOT_SUPPORTED = (data) => new SystemError("Push Notifications is not supported", A2A.ErrorCodePushNotificationNotSupported, data);
+export const AUTHENTICATED_EXTENDED_CARD_NOT_CONFIGURED = (data) => new SystemError("Authenticated Extended Card is not configured", A2A.ErrorCodeAuthenticatedExtendedCardNotConfigured, data);
+export const UNSUPPORTED_OPERATION = (data) => new SystemError("This operation is not supported", A2A.ErrorCodeUnsupportedOperation, data);
+export const CONTENT_TYPE_NOT_SUPPORTED = (data) => new SystemError("Content type not supported", A2A.ErrorCodeContentTypeNotSupported, data);
+export const INVALID_AGENT_RESPONSE = (data) => new SystemError("Invalid agent response", A2A.ErrorCodeInvalidAgentResponse, data);
 export const FAILED_UPDATE = (taskId, contextId, messageId = "failed-update", errMessage) => ({
     taskId,
     contextId,
     kind: "status-update",
     final: true,
     status: {
-        state: TaskState.failed,
+        state: A2A.TaskState.failed,
         message: {
             messageId,
             role: "agent",

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

@@ -7,3 +7,26 @@
  * @returns The current timestamp as a string.
  */
 export declare function getCurrentTimestamp(): string;
+/**
+ * Sleeps for a given number of milliseconds.
+ * @param ms - The number of milliseconds to sleep.
+ * @returns A promise that resolves when the sleep is complete.
+ *
+ * @example
+ * ```typescript
+ * await sleep(1000);
+ * ```
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Formats a JSON object into a string with indentation.
+ * @param json - The JSON object to format.
+ * @returns A string representation of the JSON object.
+ */
+export declare function formatJson(json: object): 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;

package/dist/browser/utils/common/utils.js

@@ -9,3 +9,35 @@
 export function getCurrentTimestamp() {
     return new Date().toISOString();
 }
+/**
+ * Sleeps for a given number of milliseconds.
+ * @param ms - The number of milliseconds to sleep.
+ * @returns A promise that resolves when the sleep is complete.
+ *
+ * @example
+ * ```typescript
+ * await sleep(1000);
+ * ```
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Formats a JSON object into a string with indentation.
+ * @param json - The JSON object to format.
+ * @returns A string representation of the JSON object.
+ */
+export function formatJson(json) {
+    return JSON.stringify(json, null, 2);
+}
+/**
+ * Formats an error into a standard error object for logging.
+ * @param error - The error to format.
+ * @returns A standard error object.
+ */
+export function formatError(error) {
+    if (error instanceof Error) {
+        return error;
+    }
+    return new Error(String(error));
+}

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

@@ -2,8 +2,8 @@
  * Copyright 2025 The Artinet Project
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { AgentCard, MessageSendParams, TaskQueryParams, TaskIdParams, TaskPushNotificationConfig, Task, Message, UpdateEvent } from "../types/index.js";
-import type { Client } from "../types/interfaces/client.js";
+import { A2A } from "../types/index.js";
+import type { Client } from "../types/client.js";
 /**
  * A2AClient is the main client class for interacting with Agent2Agent (A2A) protocol-compliant services.
  * It provides methods for sending tasks, retrieving statuses, canceling operations, and handling streaming responses.
@@ -35,68 +35,69 @@ export declare class A2AClient implements Client {
      * Caches the result after the first successful fetch.
      * @returns A promise resolving to the AgentCard.
      */
-    agentCard(): Promise<AgentCard>;
+    agentCard(): Promise<A2A.AgentCard>;
     /**
-     * Refreshes the cached AgentCard by fetching it again from the server.
-     * @returns A promise resolving to the updated AgentCard.
+     * Retrieves the AgentCard from the A2A server.
+     * @returns A promise resolving to the AgentCard.
      */
-    refreshAgentCard(): Promise<AgentCard>;
+    getAgentCard(): Promise<A2A.AgentCard>;
     /**
-     * Sends a Message to an agent server.
-     * @param params The parameters for the message/send method.
-     * @returns A promise resolving to Message/Task response from the agent server or null.
+     * Refreshes the cached AgentCard by fetching it again from the server.
+     * @returns A promise resolving to the updated AgentCard.
      */
-    sendMessage(params: MessageSendParams | string): Promise<Message | Task | null>;
+    refreshAgentCard(): Promise<A2A.AgentCard>;
+    sendMessage(params: A2A.MessageSendParams): Promise<A2A.Message | A2A.Task | null>;
+    sendMessage(params: string | A2A.MessageSendParams["message"]): Promise<A2A.Message | A2A.Task | null>;
     /**
      * @deprecated Use sendMessage instead.
      * Sends a task request to the agent (non-streaming).
      * @param params The parameters for the message/send method.
      * @returns A promise resolving to the Task object or null.
      */
-    sendTask(params: MessageSendParams): Promise<Message | Task | null>;
+    sendTask(params: A2A.MessageSendParams): Promise<A2A.Message | A2A.Task | null>;
     /**
      * Sends a Message and returns a stream of status and artifact updates.
      * @param params Task parameters for the request
      * @returns An AsyncIterable that yields TaskStatusUpdateEvent/TaskArtifactUpdateEvent/Task/Message payloads.
      */
-    sendStreamingMessage(params: MessageSendParams | string): AsyncIterable<UpdateEvent>;
+    sendStreamingMessage(params: A2A.MessageSendParams | string): AsyncIterable<A2A.Update>;
     /**
      * @deprecated Use sendStreamingMessage instead.
      * Sends a task and returns a subscription to status and artifact updates.
      * @param params Task parameters for the request
      * @returns An AsyncIterable that yields TaskStatusUpdateEvent or TaskArtifactUpdateEvent payloads.
      */
-    sendTaskSubscribe(params: MessageSendParams): AsyncIterable<UpdateEvent>;
+    sendTaskSubscribe(params: A2A.MessageSendParams): AsyncIterable<A2A.Update>;
     /**
      * Retrieves the current state of a task.
      * @param params The parameters for the tasks/get method.
      * @returns A promise resolving to the Task object or null.
      */
-    getTask(params: TaskQueryParams): Promise<Task | null>;
+    getTask(params: A2A.TaskQueryParams): Promise<A2A.Task | null>;
     /**
      * Cancels a currently running task.
      * @param params The parameters for the tasks/cancel method.
      * @returns A promise resolving to the updated Task object (usually canceled state) or null.
      */
-    cancelTask(params: TaskIdParams): Promise<Task | null>;
+    cancelTask(params: A2A.TaskIdParams): Promise<A2A.Task | null>;
     /**
      * Sets or updates the push notification config for a task.
      * @param params The parameters for the tasks/pushNotificationConfig/set method (which is TaskPushNotificationConfig).
      * @returns A promise resolving to the confirmed TaskPushNotificationConfig or null.
      */
-    setTaskPushNotification(params: TaskPushNotificationConfig): Promise<TaskPushNotificationConfig | null>;
+    setTaskPushNotification(params: A2A.TaskPushNotificationConfig): Promise<A2A.TaskPushNotificationConfig | null>;
     /**
      * Retrieves the currently configured push notification config for a task.
      * @param params The parameters for the tasks/pushNotificationConfig/get method.
      * @returns A promise resolving to the TaskPushNotificationConfig or null.
      */
-    getTaskPushNotification(params: TaskIdParams): Promise<TaskPushNotificationConfig | null>;
+    getTaskPushNotification(params: A2A.TaskIdParams): Promise<A2A.TaskPushNotificationConfig | null>;
     /**
      * Resubscribes to an existing task's update stream.
      * @param params Parameters identifying the task to resubscribe to
      * @returns An AsyncIterable that yields TaskStatusUpdateEvent or TaskArtifactUpdateEvent payloads.
      */
-    resubscribeTask(params: TaskQueryParams): AsyncIterable<UpdateEvent>;
+    resubscribeTask(params: A2A.TaskQueryParams): AsyncIterable<A2A.Update>;
     /**
      * Checks if the server supports a specific capability based on the agent card.
      * @param capability The capability to check (e.g., 'streaming', 'pushNotifications').