@artinet/sdk 0.5.18 → 0.6.0-preview.2

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

@@ -0,0 +1,382 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AgentCard, Message, Task, AgentExtension, TaskQueryParams, TaskIdParams, MessageSendParams, SendMessageSuccessResult } from "@artinet/types/a2a";
+import { core } from "../core/index.js";
+import { z } from "zod/v4";
+export type AgentCardParams = (Partial<AgentCard> & Required<Pick<AgentCard, "name">>) | string;
+export declare const UpdateSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    role: z.ZodEnum<{
+        user: "user";
+        agent: "agent";
+    }>;
+    parts: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        kind: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        kind: z.ZodLiteral<"file">;
+        file: z.ZodUnion<readonly [z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            mimeType: z.ZodOptional<z.ZodString>;
+            bytes: z.ZodString;
+            uri: z.ZodOptional<z.ZodNever>;
+        }, z.core.$strip>, z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            mimeType: z.ZodOptional<z.ZodString>;
+            uri: z.ZodString;
+            bytes: z.ZodOptional<z.ZodNever>;
+        }, z.core.$strip>]>;
+    }, z.core.$strip>, z.ZodObject<{
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        kind: z.ZodLiteral<"data">;
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>]>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    referenceTaskIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    messageId: z.ZodString;
+    taskId: z.ZodOptional<z.ZodString>;
+    contextId: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<"message">;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    contextId: z.ZodString;
+    status: z.ZodObject<{
+        state: z.ZodEnum<{
+            failed: "failed";
+            unknown: "unknown";
+            completed: "completed";
+            canceled: "canceled";
+            rejected: "rejected";
+            working: "working";
+            submitted: "submitted";
+            "input-required": "input-required";
+            "auth-required": "auth-required";
+        }>;
+        message: z.ZodOptional<z.ZodObject<{
+            role: z.ZodEnum<{
+                user: "user";
+                agent: "agent";
+            }>;
+            parts: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                kind: z.ZodLiteral<"text">;
+                text: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                kind: z.ZodLiteral<"file">;
+                file: z.ZodUnion<readonly [z.ZodObject<{
+                    name: z.ZodOptional<z.ZodString>;
+                    mimeType: z.ZodOptional<z.ZodString>;
+                    bytes: z.ZodString;
+                    uri: z.ZodOptional<z.ZodNever>;
+                }, z.core.$strip>, z.ZodObject<{
+                    name: z.ZodOptional<z.ZodString>;
+                    mimeType: z.ZodOptional<z.ZodString>;
+                    uri: z.ZodString;
+                    bytes: z.ZodOptional<z.ZodNever>;
+                }, z.core.$strip>]>;
+            }, z.core.$strip>, z.ZodObject<{
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                kind: z.ZodLiteral<"data">;
+                data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>]>>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            referenceTaskIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            messageId: z.ZodString;
+            taskId: z.ZodOptional<z.ZodString>;
+            contextId: z.ZodOptional<z.ZodString>;
+            kind: z.ZodLiteral<"message">;
+        }, z.core.$strip>>;
+        timestamp: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strip>;
+    history: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<{
+            user: "user";
+            agent: "agent";
+        }>;
+        parts: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            kind: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            kind: z.ZodLiteral<"file">;
+            file: z.ZodUnion<readonly [z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                mimeType: z.ZodOptional<z.ZodString>;
+                bytes: z.ZodString;
+                uri: z.ZodOptional<z.ZodNever>;
+            }, z.core.$strip>, z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                mimeType: z.ZodOptional<z.ZodString>;
+                uri: z.ZodString;
+                bytes: z.ZodOptional<z.ZodNever>;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>, z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            kind: z.ZodLiteral<"data">;
+            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>]>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        referenceTaskIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        messageId: z.ZodString;
+        taskId: z.ZodOptional<z.ZodString>;
+        contextId: z.ZodOptional<z.ZodString>;
+        kind: z.ZodLiteral<"message">;
+    }, z.core.$strip>>>;
+    artifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        artifactId: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        parts: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            kind: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            kind: z.ZodLiteral<"file">;
+            file: z.ZodUnion<readonly [z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                mimeType: z.ZodOptional<z.ZodString>;
+                bytes: z.ZodString;
+                uri: z.ZodOptional<z.ZodNever>;
+            }, z.core.$strip>, z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                mimeType: z.ZodOptional<z.ZodString>;
+                uri: z.ZodString;
+                bytes: z.ZodOptional<z.ZodNever>;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>, z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            kind: z.ZodLiteral<"data">;
+            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>]>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        extension: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    kind: z.ZodLiteral<"task">;
+}, z.core.$strip>, z.ZodObject<{
+    taskId: z.ZodString;
+    contextId: z.ZodString;
+    kind: z.ZodLiteral<"status-update">;
+    status: z.ZodObject<{
+        state: z.ZodEnum<{
+            failed: "failed";
+            unknown: "unknown";
+            completed: "completed";
+            canceled: "canceled";
+            rejected: "rejected";
+            working: "working";
+            submitted: "submitted";
+            "input-required": "input-required";
+            "auth-required": "auth-required";
+        }>;
+        message: z.ZodOptional<z.ZodObject<{
+            role: z.ZodEnum<{
+                user: "user";
+                agent: "agent";
+            }>;
+            parts: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                kind: z.ZodLiteral<"text">;
+                text: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                kind: z.ZodLiteral<"file">;
+                file: z.ZodUnion<readonly [z.ZodObject<{
+                    name: z.ZodOptional<z.ZodString>;
+                    mimeType: z.ZodOptional<z.ZodString>;
+                    bytes: z.ZodString;
+                    uri: z.ZodOptional<z.ZodNever>;
+                }, z.core.$strip>, z.ZodObject<{
+                    name: z.ZodOptional<z.ZodString>;
+                    mimeType: z.ZodOptional<z.ZodString>;
+                    uri: z.ZodString;
+                    bytes: z.ZodOptional<z.ZodNever>;
+                }, z.core.$strip>]>;
+            }, z.core.$strip>, z.ZodObject<{
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                kind: z.ZodLiteral<"data">;
+                data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>]>>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            referenceTaskIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            messageId: z.ZodString;
+            taskId: z.ZodOptional<z.ZodString>;
+            contextId: z.ZodOptional<z.ZodString>;
+            kind: z.ZodLiteral<"message">;
+        }, z.core.$strip>>;
+        timestamp: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strip>;
+    final: z.ZodBoolean;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>, z.ZodObject<{
+    taskId: z.ZodString;
+    contextId: z.ZodString;
+    kind: z.ZodLiteral<"artifact-update">;
+    artifact: z.ZodObject<{
+        artifactId: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        parts: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            kind: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            kind: z.ZodLiteral<"file">;
+            file: z.ZodUnion<readonly [z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                mimeType: z.ZodOptional<z.ZodString>;
+                bytes: z.ZodString;
+                uri: z.ZodOptional<z.ZodNever>;
+            }, z.core.$strip>, z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                mimeType: z.ZodOptional<z.ZodString>;
+                uri: z.ZodString;
+                bytes: z.ZodOptional<z.ZodNever>;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>, z.ZodObject<{
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            kind: z.ZodLiteral<"data">;
+            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>]>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        extension: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    append: z.ZodOptional<z.ZodBoolean>;
+    lastChunk: z.ZodOptional<z.ZodBoolean>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>]>;
+export type Update = z.output<typeof UpdateSchema>;
+export type Engine = (context: Context) => AsyncGenerator<Update, void, unknown>;
+export interface BaseContext extends core.Context<Task> {
+    readonly service: Service;
+    /**
+     * Considering ommit OnStart & OnComplete from Context consumers.
+     * That way the user cannot inadvertently trigger a start/completion out of band.
+     */
+    readonly publisher: EventPublisher;
+}
+export interface Context extends BaseContext {
+    readonly taskId: string;
+    readonly userMessage: Message;
+    readonly messages: MessageConsumerProxy;
+    extensions?: AgentExtension[];
+    references?: Task[];
+    getTask: () => Promise<Task>;
+}
+export type ContextParams = Omit<BaseContext, "publisher" | "isCancelled" | "getState" | "abortSignal"> & Omit<Partial<Context>, "userMessage" | "taskId"> & {
+    messenger: MessageConsumerProxy;
+    task: Task;
+    overrides?: Partial<Omit<EventConsumer, "contextId">>;
+    abortSignal?: AbortSignal;
+};
+export interface Contexts extends core.Contexts<Context> {
+    create: (params: ContextParams) => Promise<Context>;
+    list: () => Promise<Context[]>;
+}
+export interface Tasks extends core.Manager<Task> {
+    update: (context: Context, update: Update) => Promise<Task>;
+    create: (params: Partial<Task>) => Promise<Task>;
+    has: (id: string) => Promise<boolean>;
+}
+export interface Cancellations extends Omit<core.Manager<void>, "get"> {
+    has: (id: string) => Promise<boolean>;
+}
+export interface Connections extends Omit<core.Manager<void>, "get"> {
+}
+export interface ServiceOptions {
+    abortSignal?: AbortSignal;
+}
+export interface RequestHandler {
+    getTask: (input: TaskQueryParams, context?: Context, options?: ServiceOptions) => Promise<Task>;
+    cancelTask: (input: TaskIdParams, context?: Context, options?: ServiceOptions) => Promise<Task>;
+    sendMessage: (message: MessageSendParams, context?: Context, options?: ServiceOptions) => Promise<SendMessageSuccessResult>;
+    streamMessage: (message: MessageSendParams, context?: Context, options?: ServiceOptions) => AsyncGenerator<Update>;
+    resubscribe: (input: TaskIdParams, context?: Context, options?: ServiceOptions) => AsyncGenerator<Update>;
+    getAgentCard: () => Promise<AgentCard>;
+}
+export interface ExtendedHandler extends RequestHandler {
+    getAuthenticatedExtendedCard: () => Promise<AgentCard>;
+}
+export interface Stream {
+    readonly contextId: string;
+    isAlive: boolean;
+    kill: () => Promise<void>;
+    updates: Update[];
+    context: Context;
+    run: (params: {
+        service: Service;
+    }) => AsyncGenerator<Update>;
+    subscribe: () => AsyncGenerator<Update>;
+}
+export interface Streams extends Omit<core.Manager<Stream>, "set"> {
+    create: (params: core.Optional<Stream> & {
+        context: Context;
+    }) => Promise<Stream>;
+    has: (id: string) => Promise<boolean>;
+}
+export interface Service extends core.Service<{
+    engine: Engine;
+    context: Context;
+}>, RequestHandler {
+    readonly events?: Events;
+    readonly connections: Connections;
+    readonly cancellations: Cancellations;
+    readonly tasks: Tasks;
+    readonly contexts: Contexts;
+    readonly streams: Streams;
+    engine: Engine;
+    agentCard: AgentCard;
+}
+export interface MessageProducer {
+    isOpen: boolean;
+    send: (message: MessageSendParams) => Promise<void>;
+}
+export type MessageMap = {
+    message: [MessageSendParams];
+    close: [];
+};
+export interface MessageConsumer extends core.Consumer<MessageSendParams, MessageMap> {
+    message: MessageSendParams;
+    messages: MessageSendParams[];
+    close: () => Promise<void>;
+    next: () => Promise<IteratorResult<MessageSendParams>>;
+    return: (value: MessageSendParams) => Promise<IteratorResult<MessageSendParams>>;
+}
+export type MessageConsumerProxy = MessageConsumer & MessageSendParams;
+export interface EventConsumer {
+    readonly contextId: string;
+    readonly onStart?: (context: Context) => Promise<Task>;
+    readonly onCancel: (update: Update, current: Task) => Promise<void>;
+    readonly onUpdate: (update: Update, current: Task) => Promise<Task>;
+    readonly onError: (error: any, current: Task) => Promise<void>;
+    onComplete: (current: Task) => Promise<void>;
+}
+export type Emissions = {
+    start: [MessageSendParams, Task];
+    cancel: [Update];
+    update: [Task, Update];
+    error: [any, Task];
+    complete: [Task];
+};
+export interface EventPublisher extends Omit<EventConsumer, "onComplete" | "onCancel" | "onError" | "onUpdate">, core.Publisher<Emissions> {
+    readonly onStart?: (context: Context) => Promise<Task>;
+    readonly onCancel: (update: Update) => Promise<void>;
+    readonly onUpdate: (update: Update) => Promise<Task>;
+    readonly onError: (error: any) => Promise<void>;
+    onComplete: () => Promise<void>;
+}
+export interface Events extends core.Manager<EventPublisher> {
+    create: (params: core.Optional<EventPublisher>) => Promise<EventPublisher>;
+}
+export * from "@artinet/types/a2a";

package/dist/types/a2a/a2a.js

@@ -0,0 +1,14 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//lets stay really granular with the imports
+import { TaskArtifactUpdateEventSchema, MessageSchema, TaskSchema, TaskStatusUpdateEventSchema, } from "@artinet/types/a2a";
+import { z } from "zod/v4";
+export const UpdateSchema = z.discriminatedUnion("kind", [
+    MessageSchema,
+    TaskSchema,
+    TaskStatusUpdateEventSchema,
+    TaskArtifactUpdateEventSchema,
+]);
+export * from "@artinet/types/a2a";

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

@@ -0,0 +1,5 @@
+export * as A2A from "./a2a.js";
+/**
+ * @deprecated Use {@link A2A.Engine} instead.
+ */
+export type { Engine as AgentEngine } from "./a2a.js";

package/dist/types/a2a/index.js

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

package/dist/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/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/types/core/core.js

@@ -0,0 +1 @@
+export {};

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

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

package/dist/types/core/index.js

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

package/dist/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/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/types/mcp/index.d.ts

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

package/dist/types/mcp/index.js

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

package/dist/{browser/types/interfaces/services/mcp/service.d.ts → 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/context.js → types/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/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>;
+}