@artinet/sdk 0.5.18 → 0.6.0-preview.2

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

@@ -2,377 +2,50 @@
  * 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";
+/**
+ * @note We endeavor to remove all optional parameters from below this class.
+ * This will allow the service to act as the boundary to our Hexagonal Architecture.
+ */
+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>;
+    protected _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>;
+    sendMessageStream(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;
 }