@artinet/sdk 0.5.18 → 0.6.0-preview.1

package/dist/services/{core/managers/command.js → a2a/messenger.js}

@@ -1,21 +1,17 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
 import { EventEmitter } from "events";
-export class CommandChannel extends EventEmitter {
-    _command;
-    commands = [];
+export class Messenger extends EventEmitter {
+    _message;
+    _messages = [];
     resolvers = [];
     done = false;
     /**
-     * @param command - The initial command to send
-     * @note The initial command is tied to the channel and cannot be changed
+     * @param message - The initial message to send
+     * @note The initial message is tied to the messenger and cannot be changed
      */
-    constructor(_command) {
+    constructor(message) {
         super();
-        this._command = _command;
-        this.commands.push(_command);
+        this._message = message;
+        this._messages.push(message);
     }
     /**
      * @returns True if the channel is open
@@ -26,14 +22,14 @@ export class CommandChannel extends EventEmitter {
     /**
      * @returns The list of commands
      */
-    get commandList() {
-        return this.commands;
+    get message() {
+        return this._messages[0] ?? this._message;
     }
     /**
-     * @returns The current command
+     * @returns The current message
      */
-    get command() {
-        return this.commands[0] ?? this._command;
+    get messages() {
+        return this._messages;
     }
     /**
      * @returns The command channel as an async iterable
@@ -42,30 +38,30 @@ export class CommandChannel extends EventEmitter {
         return this;
     }
     valueOf() {
-        return this.command;
+        return this.message;
     }
-    send(command) {
+    async send(message) {
         if (this.done) {
-            throw new Error("Command channel is closed");
+            throw new Error("Messenger is closed");
         }
         const resolver = this.resolvers.shift();
         if (resolver) {
-            resolver({ value: command, done: false });
+            resolver({ value: message, done: false });
         }
         else {
-            this.commands.push(command);
+            this._messages.push(message);
         }
-        this.emit("send", command);
+        this.emit("message", message);
     }
-    close() {
+    async close() {
         this.done = true;
         this.resolvers.forEach((resolver) => resolver({ value: undefined, done: true }));
         this.resolvers = [];
         this.emit("close");
     }
     async next() {
-        if (this.commands.length)
-            return Promise.resolve({ value: this.commands.shift(), done: false });
+        if (this._messages.length)
+            return Promise.resolve({ value: this._messages.shift(), done: false });
         if (this.done)
             return Promise.resolve({ value: undefined, done: true });
         return new Promise((resolve) => {
@@ -74,15 +70,15 @@ export class CommandChannel extends EventEmitter {
     }
     return(value) {
         this.close();
-        this.commands = [];
+        this._messages = [];
         return Promise.resolve({ value, done: true });
     }
-    static create(command) {
-        const instance = new CommandChannel(command);
+    static create(messageParams) {
+        const instance = new Messenger(messageParams);
         return new Proxy(instance, {
             get(target, prop, _) {
-                if (prop in target.command) {
-                    return target.command[prop];
+                if (prop in target.message) {
+                    return target.message[prop];
                 }
                 else if (prop in target) {
                     return target[prop];

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

@@ -2,377 +2,46 @@
  * Copyright 2025 The Artinet Project
  * SPDX-License-Identifier: Apache-2.0
  */
-import { A2AServiceInterface, A2AEngine, AgentCard, ContextManagerInterface, ConnectionManagerInterface, CancellationManagerInterface, TaskManagerInterface, MethodOptions, TaskAndHistory, TaskIdParams, MessageSendParams, Command, State, Update, CoreContext, EventManagerOptions, MethodParams, TaskQueryParams } from "../../types/index.js";
-export declare class A2AService implements A2AServiceInterface {
-    readonly agentCard: AgentCard;
-    private engine;
-    private connections;
-    private cancellations;
-    private tasks;
-    private contexts;
-    private methods;
-    readonly eventOverrides: EventManagerOptions<Command, State, Update> | undefined;
-    private enforceParamValidation;
-    constructor(agentCard: AgentCard, engine: A2AEngine, contexts: ContextManagerInterface<Command, State, Update>, connections: ConnectionManagerInterface, cancellations: CancellationManagerInterface, tasks: TaskManagerInterface<TaskAndHistory>, methods: MethodOptions, eventOverrides?: EventManagerOptions<Command, State, Update>, enforceParamValidation?: boolean);
-    execute(engine: A2AEngine, context: CoreContext<Command, State, Update>): Promise<void>;
+import { A2A } from "../../types/index.js";
+import { ServiceParams } from "./factory/service.js";
+export declare class Service implements A2A.Service {
+    private _agentCard;
+    private _engine;
+    private _connections;
+    private _cancellations;
+    private _tasks;
+    private _contexts;
+    private _streams;
+    private _methods;
+    private _overrides?;
+    constructor(_agentCard: A2A.AgentCard, _engine: A2A.Engine, _connections: A2A.Connections, _cancellations: A2A.Cancellations, _tasks: A2A.Tasks, _contexts: A2A.Contexts, _streams: A2A.Streams, _methods: Omit<A2A.RequestHandler, "getAgentCard">, _overrides?: Partial<Omit<A2A.EventConsumer, "contextId">> | undefined);
+    get methods(): Omit<A2A.RequestHandler, "getAgentCard">;
+    set methods(methods: Partial<Omit<A2A.RequestHandler, "getAgentCard">>);
+    get agentCard(): A2A.AgentCard;
+    get engine(): A2A.Engine;
+    set engine(engine: A2A.Engine);
+    get connections(): A2A.Connections;
+    get cancellations(): A2A.Cancellations;
+    get tasks(): A2A.Tasks;
+    get contexts(): A2A.Contexts;
+    set contexts(contexts: A2A.Contexts);
+    get streams(): A2A.Streams;
+    get overrides(): Partial<Omit<A2A.EventConsumer, "contextId">> | undefined;
+    set overrides(overrides: Partial<Omit<A2A.EventConsumer, "contextId">>);
+    execute({ engine, context, }: {
+        engine: A2A.Engine;
+        context: A2A.Context;
+    }): Promise<void>;
+    getAgentCard(): Promise<A2A.AgentCard>;
     stop(): Promise<void>;
-    addConnection(id: string): void;
-    removeConnection(id: string): void;
-    isCancelled(id: string): boolean;
-    addCancellation(id: string): void;
-    removeCancellation(id: string): void;
-    getState(id: string): Promise<TaskAndHistory | undefined>;
-    setState(id: string, data: TaskAndHistory): Promise<void>;
-    getTask(input: TaskQueryParams): Promise<{
-        id: string;
-        status: {
-            state: "failed" | "unknown" | "completed" | "canceled" | "rejected" | "submitted" | "working" | "input-required" | "auth-required";
-            message?: {
-                role: "user" | "agent";
-                kind: "message";
-                parts: ({
-                    file: {
-                        bytes: string;
-                        name?: string | undefined;
-                        mimeType?: string | undefined;
-                        uri?: undefined;
-                    } | {
-                        uri: string;
-                        name?: string | undefined;
-                        bytes?: undefined;
-                        mimeType?: string | undefined;
-                    };
-                    kind: "file";
-                    metadata?: Record<string, unknown> | undefined;
-                } | {
-                    text: string;
-                    kind: "text";
-                    metadata?: Record<string, unknown> | undefined;
-                } | {
-                    data: Record<string, unknown>;
-                    kind: "data";
-                    metadata?: Record<string, unknown> | undefined;
-                })[];
-                messageId: string;
-                metadata?: Record<string, unknown> | undefined;
-                extensions?: string[] | undefined;
-                referenceTaskIds?: string[] | undefined;
-                taskId?: string | undefined;
-                contextId?: string | undefined;
-            } | undefined;
-            timestamp?: string | undefined;
-        };
-        kind: "task";
-        contextId: string;
-        metadata?: Record<string, unknown> | undefined;
-        history?: {
-            role: "user" | "agent";
-            kind: "message";
-            parts: ({
-                file: {
-                    bytes: string;
-                    name?: string | undefined;
-                    mimeType?: string | undefined;
-                    uri?: undefined;
-                } | {
-                    uri: string;
-                    name?: string | undefined;
-                    bytes?: undefined;
-                    mimeType?: string | undefined;
-                };
-                kind: "file";
-                metadata?: Record<string, unknown> | undefined;
-            } | {
-                text: string;
-                kind: "text";
-                metadata?: Record<string, unknown> | undefined;
-            } | {
-                data: Record<string, unknown>;
-                kind: "data";
-                metadata?: Record<string, unknown> | undefined;
-            })[];
-            messageId: string;
-            metadata?: Record<string, unknown> | undefined;
-            extensions?: string[] | undefined;
-            referenceTaskIds?: string[] | undefined;
-            taskId?: string | undefined;
-            contextId?: string | undefined;
-        }[] | undefined;
-        artifacts?: {
-            artifactId: string;
-            parts: ({
-                file: {
-                    bytes: string;
-                    name?: string | undefined;
-                    mimeType?: string | undefined;
-                    uri?: undefined;
-                } | {
-                    uri: string;
-                    name?: string | undefined;
-                    bytes?: undefined;
-                    mimeType?: string | undefined;
-                };
-                kind: "file";
-                metadata?: Record<string, unknown> | undefined;
-            } | {
-                text: string;
-                kind: "text";
-                metadata?: Record<string, unknown> | undefined;
-            } | {
-                data: Record<string, unknown>;
-                kind: "data";
-                metadata?: Record<string, unknown> | undefined;
-            })[];
-            name?: string | undefined;
-            metadata?: Record<string, unknown> | undefined;
-            description?: string | undefined;
-            extension?: string[] | undefined;
-        }[] | undefined;
-    }>;
-    cancelTask(input: TaskIdParams): Promise<{
-        id: string;
-        status: {
-            state: "failed" | "unknown" | "completed" | "canceled" | "rejected" | "submitted" | "working" | "input-required" | "auth-required";
-            message?: {
-                role: "user" | "agent";
-                kind: "message";
-                parts: ({
-                    file: {
-                        bytes: string;
-                        name?: string | undefined;
-                        mimeType?: string | undefined;
-                        uri?: undefined;
-                    } | {
-                        uri: string;
-                        name?: string | undefined;
-                        bytes?: undefined;
-                        mimeType?: string | undefined;
-                    };
-                    kind: "file";
-                    metadata?: Record<string, unknown> | undefined;
-                } | {
-                    text: string;
-                    kind: "text";
-                    metadata?: Record<string, unknown> | undefined;
-                } | {
-                    data: Record<string, unknown>;
-                    kind: "data";
-                    metadata?: Record<string, unknown> | undefined;
-                })[];
-                messageId: string;
-                metadata?: Record<string, unknown> | undefined;
-                extensions?: string[] | undefined;
-                referenceTaskIds?: string[] | undefined;
-                taskId?: string | undefined;
-                contextId?: string | undefined;
-            } | undefined;
-            timestamp?: string | undefined;
-        };
-        kind: "task";
-        contextId: string;
-        metadata?: Record<string, unknown> | undefined;
-        history?: {
-            role: "user" | "agent";
-            kind: "message";
-            parts: ({
-                file: {
-                    bytes: string;
-                    name?: string | undefined;
-                    mimeType?: string | undefined;
-                    uri?: undefined;
-                } | {
-                    uri: string;
-                    name?: string | undefined;
-                    bytes?: undefined;
-                    mimeType?: string | undefined;
-                };
-                kind: "file";
-                metadata?: Record<string, unknown> | undefined;
-            } | {
-                text: string;
-                kind: "text";
-                metadata?: Record<string, unknown> | undefined;
-            } | {
-                data: Record<string, unknown>;
-                kind: "data";
-                metadata?: Record<string, unknown> | undefined;
-            })[];
-            messageId: string;
-            metadata?: Record<string, unknown> | undefined;
-            extensions?: string[] | undefined;
-            referenceTaskIds?: string[] | undefined;
-            taskId?: string | undefined;
-            contextId?: string | undefined;
-        }[] | undefined;
-        artifacts?: {
-            artifactId: string;
-            parts: ({
-                file: {
-                    bytes: string;
-                    name?: string | undefined;
-                    mimeType?: string | undefined;
-                    uri?: undefined;
-                } | {
-                    uri: string;
-                    name?: string | undefined;
-                    bytes?: undefined;
-                    mimeType?: string | undefined;
-                };
-                kind: "file";
-                metadata?: Record<string, unknown> | undefined;
-            } | {
-                text: string;
-                kind: "text";
-                metadata?: Record<string, unknown> | undefined;
-            } | {
-                data: Record<string, unknown>;
-                kind: "data";
-                metadata?: Record<string, unknown> | undefined;
-            })[];
-            name?: string | undefined;
-            metadata?: Record<string, unknown> | undefined;
-            description?: string | undefined;
-            extension?: string[] | undefined;
-        }[] | undefined;
-    }>;
-    sendMessage(message: MessageSendParams | string, params?: Partial<Omit<MethodParams, "service" | "contextManager">>): Promise<{
-        role: "user" | "agent";
-        kind: "message";
-        parts: ({
-            file: {
-                bytes: string;
-                name?: string | undefined;
-                mimeType?: string | undefined;
-                uri?: undefined;
-            } | {
-                uri: string;
-                name?: string | undefined;
-                bytes?: undefined;
-                mimeType?: string | undefined;
-            };
-            kind: "file";
-            metadata?: Record<string, unknown> | undefined;
-        } | {
-            text: string;
-            kind: "text";
-            metadata?: Record<string, unknown> | undefined;
-        } | {
-            data: Record<string, unknown>;
-            kind: "data";
-            metadata?: Record<string, unknown> | undefined;
-        })[];
-        messageId: string;
-        metadata?: Record<string, unknown> | undefined;
-        extensions?: string[] | undefined;
-        referenceTaskIds?: string[] | undefined;
-        taskId?: string | undefined;
-        contextId?: string | undefined;
-    } | {
-        id: string;
-        status: {
-            state: "failed" | "unknown" | "completed" | "canceled" | "rejected" | "submitted" | "working" | "input-required" | "auth-required";
-            message?: {
-                role: "user" | "agent";
-                kind: "message";
-                parts: ({
-                    file: {
-                        bytes: string;
-                        name?: string | undefined;
-                        mimeType?: string | undefined;
-                        uri?: undefined;
-                    } | {
-                        uri: string;
-                        name?: string | undefined;
-                        bytes?: undefined;
-                        mimeType?: string | undefined;
-                    };
-                    kind: "file";
-                    metadata?: Record<string, unknown> | undefined;
-                } | {
-                    text: string;
-                    kind: "text";
-                    metadata?: Record<string, unknown> | undefined;
-                } | {
-                    data: Record<string, unknown>;
-                    kind: "data";
-                    metadata?: Record<string, unknown> | undefined;
-                })[];
-                messageId: string;
-                metadata?: Record<string, unknown> | undefined;
-                extensions?: string[] | undefined;
-                referenceTaskIds?: string[] | undefined;
-                taskId?: string | undefined;
-                contextId?: string | undefined;
-            } | undefined;
-            timestamp?: string | undefined;
-        };
-        kind: "task";
-        contextId: string;
-        metadata?: Record<string, unknown> | undefined;
-        history?: {
-            role: "user" | "agent";
-            kind: "message";
-            parts: ({
-                file: {
-                    bytes: string;
-                    name?: string | undefined;
-                    mimeType?: string | undefined;
-                    uri?: undefined;
-                } | {
-                    uri: string;
-                    name?: string | undefined;
-                    bytes?: undefined;
-                    mimeType?: string | undefined;
-                };
-                kind: "file";
-                metadata?: Record<string, unknown> | undefined;
-            } | {
-                text: string;
-                kind: "text";
-                metadata?: Record<string, unknown> | undefined;
-            } | {
-                data: Record<string, unknown>;
-                kind: "data";
-                metadata?: Record<string, unknown> | undefined;
-            })[];
-            messageId: string;
-            metadata?: Record<string, unknown> | undefined;
-            extensions?: string[] | undefined;
-            referenceTaskIds?: string[] | undefined;
-            taskId?: string | undefined;
-            contextId?: string | undefined;
-        }[] | undefined;
-        artifacts?: {
-            artifactId: string;
-            parts: ({
-                file: {
-                    bytes: string;
-                    name?: string | undefined;
-                    mimeType?: string | undefined;
-                    uri?: undefined;
-                } | {
-                    uri: string;
-                    name?: string | undefined;
-                    bytes?: undefined;
-                    mimeType?: string | undefined;
-                };
-                kind: "file";
-                metadata?: Record<string, unknown> | undefined;
-            } | {
-                text: string;
-                kind: "text";
-                metadata?: Record<string, unknown> | undefined;
-            } | {
-                data: Record<string, unknown>;
-                kind: "data";
-                metadata?: Record<string, unknown> | undefined;
-            })[];
-            name?: string | undefined;
-            metadata?: Record<string, unknown> | undefined;
-            description?: string | undefined;
-            extension?: string[] | undefined;
-        }[] | undefined;
-    }>;
-    streamMessage(message: MessageSendParams | string, params?: Partial<Omit<MethodParams, "service" | "contextManager">>): AsyncGenerator<import("../../types/index.js").UpdateEvent, void, any>;
-    resubscribe(input: TaskIdParams, params?: Partial<Omit<MethodParams, "service" | "contextManager">>): AsyncGenerator<import("../../types/index.js").UpdateEvent, void, any>;
+    getTask(params: A2A.TaskQueryParams, context?: A2A.Context, options?: A2A.ServiceOptions): Promise<A2A.Task>;
+    cancelTask(params: A2A.TaskIdParams, context?: A2A.Context, options?: A2A.ServiceOptions): Promise<A2A.Task>;
+    sendMessage(params: A2A.MessageSendParams, context?: A2A.Context, options?: A2A.ServiceOptions): Promise<A2A.SendMessageSuccessResult>;
+    sendMessage(message: string | A2A.MessageSendParams["message"], context?: A2A.Context, options?: A2A.ServiceOptions): Promise<A2A.SendMessageSuccessResult>;
+    _sendMessage(params: A2A.MessageSendParams, context?: A2A.Context, options?: A2A.ServiceOptions): Promise<A2A.SendMessageSuccessResult>;
+    streamMessage(params: A2A.MessageSendParams, context?: A2A.Context, options?: A2A.ServiceOptions): AsyncGenerator<A2A.Update>;
+    streamMessage(message: string, context?: A2A.Context, options?: A2A.ServiceOptions): AsyncGenerator<A2A.Update>;
+    _streamMessage(params: A2A.MessageSendParams, context?: A2A.Context, options?: A2A.ServiceOptions): AsyncGenerator<A2A.Update>;
+    resubscribe(params: A2A.TaskIdParams, context?: A2A.Context, options?: A2A.ServiceOptions): AsyncGenerator<A2A.Update>;
+    static create(params: ServiceParams): Service;
 }