@artinet/sdk 0.5.18 → 0.6.0-preview.2

package/dist/browser/types/{interfaces/client.d.ts → 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/{types/interfaces/services/mcp/service.d.ts → browser/types/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/builder.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,5 @@
  * 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 FINAL_STATES: A2A.TaskState[];

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

@@ -2,37 +2,10 @@
  * Copyright 2025 The Artinet Project
  * SPDX-License-Identifier: Apache-2.0
  */
-import { TaskState } 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) => {
-    return {
-        taskId: taskId,
-        contextId: contextId,
-        kind: "status-update",
-        status: {
-            state: status,
-            message: message,
-            timestamp: timestamp,
-        },
-        final: final,
-    };
-};
-export const WORKING_UPDATE = (taskId, contextId, message, timestamp) => {
-    return STATUS_UPDATE(taskId, contextId, TaskState.working, message, timestamp);
-};
-export const CANCEL_UPDATE = (taskId, contextId, message, timestamp) => {
-    return STATUS_UPDATE(taskId, contextId, TaskState.canceled, message, timestamp, true);
-};
-export const SUBMITTED_UPDATE = (taskId, contextId, message, timestamp) => {
-    return STATUS_UPDATE(taskId, contextId, TaskState.submitted, message, timestamp);
-};
-export const FAILED_UPDATE_EVENT = (taskId, contextId, message, timestamp) => {
-    return STATUS_UPDATE(taskId, contextId, TaskState.failed, message, timestamp, true);
-};
+import { A2A } from "../../types/index.js";
 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,79 @@
  * 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";
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export declare class SystemError<T extends MCP.JSONRPCErrorResponse> 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;
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export declare const PARSE_ERROR: <T extends A2A.JSONParseError>(data: T["error"]["data"]) => SystemError<T>;
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export declare const INVALID_REQUEST: <T extends A2A.InvalidRequestError>(data: T["error"]["data"]) => SystemError<T>;
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export declare const METHOD_NOT_FOUND: <T extends A2A.MethodNotFoundError>(data: T["error"]["data"]) => SystemError<T>;
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export declare const INVALID_PARAMS: <T extends A2A.InvalidParamsError>(data: T["error"]["data"]) => SystemError<T>;
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export declare const INTERNAL_ERROR: <T extends A2A.InternalError>(data: T["error"]["data"]) => SystemError<T>;
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export declare const TASK_NOT_FOUND: <T extends A2A.TaskNotFoundError>(data: T["error"]["data"]) => SystemError<T>;
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export declare const TASK_NOT_CANCELABLE: <T extends A2A.TaskNotCancelableError>(data: T["error"]["data"]) => SystemError<T>;
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export declare const PUSH_NOTIFICATION_NOT_SUPPORTED: <T extends A2A.A2AError>(data: T["error"]["data"]) => SystemError<T>;
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export declare const AUTHENTICATED_EXTENDED_CARD_NOT_CONFIGURED: <T extends A2A.AuthenticatedExtendedCardNotConfiguredError>(data: T["error"]["data"]) => SystemError<T>;
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export declare const UNSUPPORTED_OPERATION: <T extends A2A.A2AError>(data: T["error"]["data"]) => SystemError<T>;
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export declare const CONTENT_TYPE_NOT_SUPPORTED: <T extends A2A.ContentTypeNotSupportedError>(data: T["error"]["data"]) => SystemError<T>;
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export declare const INVALID_AGENT_RESPONSE: <T extends A2A.InvalidAgentResponseError>(data: T["error"]["data"]) => SystemError<T>;
+/**
+ * @deprecated Use {@link describe.update.failed} instead
+ * @since 0.6.0
+ */
+export declare const FAILED_UPDATE: (taskId: string, contextId: string, messageId: string | undefined, errMessage: string) => A2A.TaskStatusUpdateEvent;

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

@@ -2,41 +2,94 @@
  * 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";
+import * as describe from "../../create/describe.js";
+import { formatJson } from "./utils.js";
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
 export class SystemError extends Error {
     constructor(message, code, data) {
-        super(message);
+        super(message + " " + formatJson({ cause: data }));
         // this.name = "RpcError";
         this.message = message;
         this.code = code;
         this.data = data;
     }
 }
-// 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 FAILED_UPDATE = (taskId, contextId, messageId = "failed-update", errMessage) => ({
-    taskId,
-    contextId,
-    kind: "status-update",
-    final: true,
-    status: {
-        state: TaskState.failed,
-        message: {
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export const PARSE_ERROR = (data) => new SystemError("Invalid JSON payload", A2A.ErrorCodeParseError, data);
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export const INVALID_REQUEST = (data) => new SystemError("Request payload validation error", A2A.ErrorCodeInvalidRequest, data);
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export const METHOD_NOT_FOUND = (data) => new SystemError("Method not found", A2A.ErrorCodeMethodNotFound, data);
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export const INVALID_PARAMS = (data) => new SystemError("Invalid parameters", A2A.ErrorCodeInvalidParams, data);
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export const INTERNAL_ERROR = (data) => new SystemError("Internal error", A2A.ErrorCodeInternalError, data);
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export const TASK_NOT_FOUND = (data) => new SystemError("Task not found", A2A.ErrorCodeTaskNotFound, data);
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export const TASK_NOT_CANCELABLE = (data) => new SystemError("Task cannot be canceled", A2A.ErrorCodeTaskNotCancelable, data);
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export const PUSH_NOTIFICATION_NOT_SUPPORTED = (data) => new SystemError("Push Notifications is not supported", A2A.ErrorCodePushNotificationNotSupported, data);
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export const AUTHENTICATED_EXTENDED_CARD_NOT_CONFIGURED = (data) => new SystemError("Authenticated Extended Card is not configured", A2A.ErrorCodeAuthenticatedExtendedCardNotConfigured, data);
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export const UNSUPPORTED_OPERATION = (data) => new SystemError("This operation is not supported", A2A.ErrorCodeUnsupportedOperation, data);
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export const CONTENT_TYPE_NOT_SUPPORTED = (data) => new SystemError("Content type not supported", A2A.ErrorCodeContentTypeNotSupported, data);
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export const INVALID_AGENT_RESPONSE = (data) => new SystemError("Invalid agent response", A2A.ErrorCodeInvalidAgentResponse, data);
+/**
+ * @deprecated Use {@link describe.update.failed} instead
+ * @since 0.6.0
+ */
+export const FAILED_UPDATE = (taskId, contextId, messageId = "failed-update", errMessage) => {
+    return describe.update.failed({
+        taskId,
+        contextId,
+        final: true,
+        message: describe.message({
             messageId,
-            role: "agent",
             parts: [{ kind: "text", text: errMessage }],
-            kind: "message",
-        },
-    },
-});
+        }),
+    });
+};

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));
+}