@artinet/sdk 0.5.4 → 0.5.6

package/dist/types/types/interfaces/services/a2a/legacy.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type Task, type Message, type MessageSendConfiguration } from "../../../schemas/a2a/index.js";
+import { A2AEngine } from "./engine.js";
+/**
+ * @deprecated Task now has a history property.
+ * Represents a task and its associated message history.
+ */
+export interface TaskAndHistory {
+    /** The task object */
+    task: Task;
+    /** The complete message history associated with the task */
+    history: Message[];
+}
+/**
+ * @deprecated Use the Store interface instead.
+ * @description Interface for task storage providers.
+ * Abstracts the storage mechanism for tasks and their message history.
+ */
+export interface TaskStore {
+    /**
+     * Saves a task and its associated message history.
+     * Overwrites existing data if the task ID exists.
+     * @param data An object containing the task and its history.
+     * @returns A promise resolving when the save operation is complete.
+     */
+    save(data: TaskAndHistory): Promise<void>;
+    /**
+     * Loads a task and its history by task ID.
+     * @param taskId The ID of the task to load.
+     * @returns A promise resolving to an object containing the Task and its history, or null if not found.
+     */
+    load(taskId: string): Promise<TaskAndHistory | null>;
+}
+/**
+ * @deprecated This interface will be removed in the future. Use ExecutionContext instead.
+ * Context object provided to the TaskHandler.
+ * Contains the information needed for the handler to process the task.
+ */
+export interface TaskContext {
+    /**
+     * The context ID of the task.
+     */
+    contextId: string;
+    /**
+     * The current state of the task when the handler is invoked or resumed.
+     * This is a snapshot - the latest state may need to be reloaded during async operations.
+     */
+    task: Task;
+    /**
+     * The specific user message that triggered this handler invocation or resumption.
+     */
+    userMessage: Message;
+    /**
+     * Function to check if cancellation has been requested for this task.
+     * Handlers should check this periodically during long-running operations.
+     * @returns True if cancellation has been requested, false otherwise.
+     */
+    isCancelled(): boolean;
+    /**
+     * The message history associated with the task up to the point the handler is invoked.
+     */
+    history: Message[];
+    /**
+     * @description The latest user message that triggered this handler invocation or resumption.
+     * @note It's unclear whether this is necessary as userMessage already exists
+     */
+    latestUserMessage?: Message;
+    /**
+     * The configuration for the task.
+     */
+    configuration?: MessageSendConfiguration;
+}
+/**
+ * Defines the signature for a task handler function.
+ *
+ * Handlers are implemented as async generators. They receive context about the
+ * task and the triggering message. They perform work and yield status
+ * or artifact updates (TaskYieldUpdate). The server consumes these yields,
+ * updates the task state in the store, and streams events if applicable.
+ *
+ * @param context The TaskContext object containing task details and state.
+ * @yields Updates to the task's status or artifacts.
+ * @returns Optionally returns the final complete Task object (needed for non-streaming 'message/send').
+ *   If void is returned, the server uses the last known state after processing all yields.
+ */
+export type TaskHandler = A2AEngine;
+//# sourceMappingURL=legacy.d.ts.map

package/dist/types/types/interfaces/services/a2a/legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.d.ts","sourceRoot":"","sources":["../../../../../../src/types/interfaces/services/a2a/legacy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,KAAK,IAAI,EACT,KAAK,OAAO,EACZ,KAAK,wBAAwB,EAC9B,sCAAqC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,IAAI,EAAE,IAAI,CAAC;IAEX,4DAA4D;IAC5D,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;OAIG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CACtD;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,IAAI,EAAE,IAAI,CAAC;IAEX;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,OAAO,EAAE,OAAO,EAAE,CAAC;IAEnB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,aAAa,CAAC,EAAE,wBAAwB,CAAC;CAC1C;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC"}

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

@@ -0,0 +1,409 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @fileoverview A2A Service Interface Definitions
+ *
+ * This module defines interfaces for Agent-to-Agent (A2A) service implementations,
+ * including factory parameters, method options, and the main service interface.
+ * It extends the core service framework with A2A-specific functionality for
+ * agent communication, task management, and message handling.
+ *
+ * @module A2AService
+ * @version 1.0.0
+ * @since 0.5.6
+ * @author The Artinet Project
+ */
+import { ConnectionManagerInterface, CancellationManagerInterface, ContextManagerInterface, ServiceInterface, TaskManagerInterface, EventManagerOptions } from "../core/index.js";
+import { AgentCard, MessageSendParams, SendMessageSuccessResult, Task, TaskIdParams } from "../../../schemas/a2a/index.js";
+import { UpdateEvent, Command, State, Update } from "./context.js";
+import { A2AEngine } from "./engine.js";
+/**
+ * Configuration parameters for creating A2A service instances.
+ *
+ * This interface defines the required and optional components needed to
+ * instantiate an A2A service, including the agent identity, execution engine,
+ * and various manager interfaces for handling different aspects of A2A operations.
+ *
+ * @example
+ * ```typescript
+ * const factoryParams: FactoryParams = {
+ *   agentCard: {
+ *     id: 'agent-123',
+ *     name: 'MyAgent',
+ *     capabilities: ['messaging', 'task-processing']
+ *   },
+ *   engine: createA2AEngine(),
+ *   contexts: createContextManager(),
+ *   connections: createConnectionManager(),
+ *   methods: {
+ *     sendMessage: customSendMessage,
+ *     getTask: customGetTask
+ *   }
+ * };
+ *
+ * const service = createA2AService(factoryParams);
+ * ```
+ *
+ * @public
+ * @since 0.5.6
+ */
+export interface FactoryParams {
+    /** Agent identity and capabilities information */
+    agentCard: AgentCard;
+    /** Execution engine for processing A2A commands */
+    engine: A2AEngine;
+    /** Optional context manager for execution state management */
+    contexts?: ContextManagerInterface<Command, State, Update>;
+    /** Optional connection manager for agent connections */
+    connections?: ConnectionManagerInterface;
+    /** Optional cancellation manager for handling operation cancellations */
+    cancellations?: CancellationManagerInterface;
+    /** Optional task manager for task lifecycle management */
+    tasks?: TaskManagerInterface<State>;
+    /** Optional custom method implementations */
+    methods?: Partial<MethodOptions>;
+    /** Optional event manager configuration overrides */
+    events?: EventManagerOptions<Command, State, Update>;
+}
+/**
+ * Parameters passed to A2A method implementations.
+ *
+ * This interface defines the dependencies and context information that
+ * method implementations receive when they are invoked. It provides access
+ * to the service instance, execution engine, context management, and
+ * cancellation mechanisms.
+ *
+ * @example
+ * ```typescript
+ * const customSendMessage = async (
+ *   message: MessageSendParams,
+ *   params: MethodParams
+ * ): Promise<SendMessageSuccessResult> => {
+ *   const { service, engine, contextManager, signal } = params;
+ *
+ *   // Create execution context
+ *   const context = contextManager.createContext(message);
+ *
+ *   // Check for cancellation
+ *   if (signal.aborted) {
+ *     throw new Error('Operation cancelled');
+ *   }
+ *
+ *   // Execute message sending
+ *   return await service.execute(engine, context);
+ * };
+ * ```
+ *
+ * @public
+ * @since 0.5.6
+ */
+export interface MethodParams {
+    /** The A2A service instance */
+    service: A2AServiceInterface<Command, State, Update>;
+    /** The execution engine for processing */
+    engine: A2AEngine;
+    /** Context manager for execution state */
+    contextManager: ContextManagerInterface<Command, State, Update>;
+    /** Abort signal for cancellation handling */
+    signal: AbortSignal;
+}
+/**
+ * Custom method implementation options for A2A services.
+ *
+ * This interface allows customization of core A2A operations by providing
+ * alternative implementations for task management, message handling, and
+ * streaming operations. Each method can be individually overridden to
+ * provide custom behavior while maintaining the standard interface.
+ *
+ * @example
+ * ```typescript
+ * const customMethods: MethodOptions = {
+ *   sendMessage: async (message, params) => {
+ *     // Custom message sending logic
+ *     console.log(`Sending message to: ${message.recipient}`);
+ *     const result = await defaultSendMessage(message, params);
+ *     console.log(`Message sent with ID: ${result.messageId}`);
+ *     return result;
+ *   },
+ *
+ *   getTask: async (input, params) => {
+ *     // Custom task retrieval with caching
+ *     const cached = taskCache.get(input.taskId);
+ *     if (cached) return cached;
+ *
+ *     const task = await defaultGetTask(input, params);
+ *     taskCache.set(input.taskId, task);
+ *     return task;
+ *   }
+ * };
+ * ```
+ *
+ * @public
+ * @since 0.5.6
+ */
+export interface MethodOptions {
+    /**
+     * Custom task retrieval implementation.
+     *
+     * @param input - Task identification parameters
+     * @param params - Method execution parameters (without engine, contextManager, signal)
+     * @returns Promise resolving to the requested task
+     */
+    getTask: (input: TaskIdParams, params: Omit<MethodParams, "engine" | "contextManager" | "signal">) => Promise<Task>;
+    /**
+     * Task cancellation.
+     *
+     * @param input - Task identification parameters
+     * @param params - Method execution parameters (without engine, signal)
+     * @returns Promise resolving to the cancelled task
+     */
+    cancelTask: (input: TaskIdParams, params: Omit<MethodParams, "engine" | "signal">) => Promise<Task>;
+    /**
+     * Message sending.
+     *
+     * @param message - Message parameters to send
+     * @param params - Full method execution parameters
+     * @returns Promise resolving to send operation result
+     */
+    sendMessage: (message: MessageSendParams, params: MethodParams) => Promise<SendMessageSuccessResult>;
+    /**
+     * Streaming messages.
+     *
+     * @param message - Message parameters to send
+     * @param params - Full method execution parameters
+     * @returns AsyncGenerator yielding update events
+     */
+    streamMessage: (message: MessageSendParams, params: MethodParams) => AsyncGenerator<UpdateEvent>;
+    /**
+     * Resubscription.
+     *
+     * @param input - Task identification parameters
+     * @param params - Full method execution parameters
+     * @returns AsyncGenerator yielding update events
+     */
+    resubscribe: (input: TaskIdParams, params: MethodParams) => AsyncGenerator<UpdateEvent>;
+}
+/**
+ * Public interface for A2A service methods.
+ *
+ * This interface defines the public API that consumers of A2A services
+ * can use to interact with agents. It provides simplified method signatures
+ * that hide internal complexity while exposing the essential functionality
+ * for agent-to-agent communication.
+ *
+ * @example
+ * ```typescript
+ * // Using the methods interface
+ * const service: MethodsInterface = createA2AService(params);
+ *
+ * // Get a task
+ * const task = await service.getTask({ taskId: 'task-123' });
+ *
+ * // Send a message
+ * const result = await service.sendMessage({
+ *   recipient: 'agent-456',
+ *   content: 'Hello, how are you?'
+ * });
+ *
+ * // Stream messages for real-time updates
+ * for await (const update of service.streamMessage({
+ *   recipient: 'agent-456',
+ *   content: 'Processing your request...'
+ * })) {
+ *   console.log('Update:', update);
+ * }
+ * ```
+ *
+ * @public
+ * @since 0.5.6
+ */
+export interface MethodsInterface {
+    /**
+     * Retrieves a task by its ID.
+     *
+     * @param input - Task identification parameters
+     * @returns Promise resolving to the requested task
+     */
+    getTask: (input: TaskIdParams) => Promise<Task>;
+    /**
+     * Cancels a task by its ID.
+     *
+     * @param input - Task identification parameters
+     * @returns Promise resolving to the cancelled task
+     */
+    cancelTask: (input: TaskIdParams) => Promise<Task>;
+    /**
+     * Sends a message to another agent.
+     *
+     * @param message - Message parameters to send
+     * @param params - Optional execution parameters
+     * @returns Promise resolving to send operation result
+     */
+    sendMessage: (message: MessageSendParams, params?: Partial<Omit<MethodParams, "service" | "contextManager">>) => Promise<SendMessageSuccessResult>;
+    /**
+     * Sends a message with streaming updates.
+     *
+     * @param message - Message parameters to send
+     * @param params - Optional execution parameters
+     * @returns AsyncGenerator yielding update events
+     */
+    streamMessage: (message: MessageSendParams, params?: Partial<Omit<MethodParams, "service" | "contextManager">>) => AsyncGenerator<UpdateEvent>;
+    /**
+     * Resubscribes to updates for a specific task.
+     *
+     * @param input - Task identification parameters
+     * @param params - Optional execution parameters
+     * @returns AsyncGenerator yielding update events
+     */
+    resubscribe: (input: TaskIdParams, params?: Partial<Omit<MethodParams, "service" | "contextManager">>) => AsyncGenerator<UpdateEvent>;
+}
+/**
+ * Main interface for A2A service implementations.
+ *
+ * This interface extends the core ServiceInterface and MethodsInterface to provide
+ * a complete A2A service implementation. It includes agent identity management,
+ * connection tracking, cancellation handling, and state management capabilities
+ * specific to agent-to-agent communication scenarios.
+ *
+ * @template TCommand - The command type, must extend Command
+ * @template TState - The state type, must extend State
+ * @template TUpdate - The update type, must extend Update
+ *
+ * @example
+ * ```typescript
+ * class MyA2AService implements A2AServiceInterface {
+ *   constructor(
+ *     public agentCard: AgentCard,
+ *     private engine: A2AEngine
+ *   ) {}
+ *
+ *   async execute(engine, context) {
+ *     // Handle execution
+ *   }
+ *
+ *   async sendMessage(message, params) {
+ *     // Handle message sending
+ *   }
+ *
+ *   addConnection(id: string) {
+ *     this.connections.add(id);
+ *     console.log(`Added connection: ${id}`);
+ *   }
+ *
+ *   // ... implement other methods
+ * }
+ * ```
+ *
+ * @public
+ * @since 0.5.6
+ */
+export interface A2AServiceInterface<TCommand extends Command = Command, TState extends State = State, TUpdate extends Update = Update> extends ServiceInterface<TCommand, TState, TUpdate>, MethodsInterface {
+    /**
+     * Optional event manager configuration overrides.
+     *
+     * When present, these overrides customize the default event handling
+     * behavior for this service instance.
+     */
+    readonly eventOverrides: EventManagerOptions<TCommand, TState, TUpdate> | undefined;
+    /**
+     * Agent identity and capabilities information.
+     *
+     * This card identifies the agent and describes its capabilities,
+     * which is used for agent discovery and capability matching.
+     */
+    agentCard: AgentCard;
+    /**
+     * Adds a connection to the active connections registry.
+     *
+     * @param id - Unique identifier for the connection
+     *
+     * @example
+     * ```typescript
+     * service.addConnection('connection-123');
+     * ```
+     */
+    addConnection: (id: string) => void;
+    /**
+     * Removes a connection from the active connections registry.
+     *
+     * @param id - Unique identifier for the connection
+     *
+     * @example
+     * ```typescript
+     * service.removeConnection('connection-123');
+     * ```
+     */
+    removeConnection: (id: string) => void;
+    /**
+     * Checks if a specific execution context has been cancelled.
+     *
+     * @param id - Context or execution identifier
+     * @returns True if cancelled, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (service.isCancelled('context-123')) {
+     *   console.log('Execution was cancelled');
+     *   return;
+     * }
+     * ```
+     */
+    isCancelled: (id: string) => boolean;
+    /**
+     * Adds a cancellation marker for a specific execution context.
+     *
+     * @param id - Context or execution identifier to cancel
+     *
+     * @example
+     * ```typescript
+     * service.addCancellation('context-123');
+     * ```
+     */
+    addCancellation: (id: string) => void;
+    /**
+     * Removes a cancellation marker for a specific execution context.
+     *
+     * @param id - Context or execution identifier
+     *
+     * @example
+     * ```typescript
+     * service.removeCancellation('context-123');
+     * ```
+     */
+    removeCancellation: (id: string) => void;
+    /**
+     * Retrieves the current state for a specific Task.
+     *
+     * @param id - Task identifier
+     * @returns Promise resolving to the state, or undefined if not found
+     *
+     * @example
+     * ```typescript
+     * const state = await service.getState('task-123');
+     * if (state) {
+     *   console.log('Current progress:', state.progress);
+     * }
+     * ```
+     */
+    getState: (id: string) => Promise<TState | undefined>;
+    /**
+     * Sets the state for a specific Task.
+     *
+     * @param id - Task identifier
+     * @param data - The state data to store
+     * @returns Promise that resolves when state is saved
+     *
+     * @example
+     * ```typescript
+     * await service.setState('task-123', {
+     *   progress: 0.75,
+     *   status: 'processing',
+     *   data: processedResults
+     * });
+     * ```
+     */
+    setState: (id: string, data: TState) => Promise<void>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/types/types/interfaces/services/a2a/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../../src/types/interfaces/services/a2a/service.ts"],"names":[],"mappings":"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"}

package/dist/types/types/interfaces/services/core/context/command.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CoreCommand } from "./types.js";
+import { EventEmitter } from "events";
+export interface CommandChannelMap<TCommand extends CoreCommand = CoreCommand> {
+    send: [TCommand];
+    close: [];
+}
+export interface SendCommandInterface<TCommand extends CoreCommand = CoreCommand> {
+    isOpen: boolean;
+    send(command: TCommand): void;
+}
+export interface ReceiveCommandInterface<TCommand extends CoreCommand = CoreCommand> extends AsyncIterable<TCommand, TCommand, TCommand | undefined>, EventEmitter<CommandChannelMap<TCommand>> {
+    command: TCommand;
+    commandList: TCommand[];
+    close(): void;
+    next(): Promise<IteratorResult<TCommand>>;
+    return(value: TCommand): Promise<IteratorResult<TCommand>>;
+}
+export type ReceiveCommandProxyInterface<TCommand extends CoreCommand = CoreCommand> = ReceiveCommandInterface<TCommand> & TCommand;
+export interface CommandChannelInterface<TCommand extends CoreCommand = CoreCommand> extends ReceiveCommandInterface<TCommand>, SendCommandInterface<TCommand> {
+}
+export type CommandChannelProxyInterface<TCommand extends CoreCommand = CoreCommand> = CommandChannelInterface<TCommand> & TCommand;
+//# sourceMappingURL=command.d.ts.map

package/dist/types/types/interfaces/services/core/context/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../../../../src/types/interfaces/services/core/context/command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,WAAW,iBAAiB,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW;IAC3E,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC;IACjB,KAAK,EAAE,EAAE,CAAC;CACX;AAED,MAAM,WAAW,oBAAoB,CACnC,QAAQ,SAAS,WAAW,GAAG,WAAW;IAE1C,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB,CACtC,QAAQ,SAAS,WAAW,GAAG,WAAW,CAC1C,SAAQ,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC,EAC7D,YAAY,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC3C,OAAO,EAAE,QAAQ,CAAC;IAClB,WAAW,EAAE,QAAQ,EAAE,CAAC;IACxB,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1C,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC5D;AAED,MAAM,MAAM,4BAA4B,CACtC,QAAQ,SAAS,WAAW,GAAG,WAAW,IACxC,uBAAuB,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,uBAAuB,CACtC,QAAQ,SAAS,WAAW,GAAG,WAAW,CAC1C,SAAQ,uBAAuB,CAAC,QAAQ,CAAC,EACvC,oBAAoB,CAAC,QAAQ,CAAC;CAAG;AAErC,MAAM,MAAM,4BAA4B,CACtC,QAAQ,SAAS,WAAW,GAAG,WAAW,IACxC,uBAAuB,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC"}