@artinet/sdk 0.5.18 → 0.6.0-preview.2

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

@@ -1,162 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * @fileoverview A2A (Agent-to-Agent) Context Type Definitions
- *
- * This module provides type definitions for the Agent-to-Agent communication context,
- * extending the core context types with A2A-specific functionality for task handling,
- * message processing, and event management.
- *
- * @module A2AContext
- * @version 0.5.7
- * @since 0.5.6
- * @author The Artinet Project
- */
-import { type TaskStatusUpdateEvent, type TaskArtifactUpdateEvent, type Task, type Message, A2ARequest, MessageSendParams } from "../../../schemas/a2a/index.js";
-import { CoreCommand, CoreState, CoreUpdate } from "../core/context/types.js";
-import { CoreContext } from "../core/context/context.js";
-import { TaskAndHistory } from "./legacy.js";
-/**
- * Represents the possible types of updates that can be yielded by a TaskHandler.
- *
- * This union type encompasses all event types that can be emitted during A2A
- * task processing, providing a type-safe way to handle different update scenarios.
- *
- * @description Either a Message, Task, TaskStatusUpdateEvent, or TaskArtifactUpdateEvent.
- *
- * @public
- * @since 0.5.6
- */
-export type UpdateEvent = Message | Task | TaskStatusUpdateEvent | TaskArtifactUpdateEvent;
-/**
- * A2A Command type that extends CoreCommand with A2A-specific parameter constraints.
- *
- * This generic type provides type-safe command handling for A2A operations,
- * ensuring that command parameters conform to the expected A2A request structure.
- *
- * @template TParams - The parameter type for the command, must extend A2ARequest params
- * @default MessageSendParams - Default parameter type for message sending operations
- *
- * @example
- * ```typescript
- * // Using default MessageSendParams
- * const messageCommand: Command = {
- *   type: 'send_message',
- *   params: { content: 'Hello', recipient: 'agent123' }
- * };
- *
- * // Using custom parameter type
- * interface CustomParams extends NonNullable<A2ARequest["params"]> {
- *   customField: string;
- * }
- * const customCommand: Command<CustomParams> = {
- *   type: 'custom_action',
- *   params: { customField: 'value' }
- * };
- * ```
- *
- * @public
- * @since 0.5.6
- */
-export type Command<TParams extends NonNullable<A2ARequest["params"]> = MessageSendParams> = CoreCommand<TParams>;
-/**
- * A2A State type that extends CoreState with task and history management.
- *
- * This type represents the state container for A2A operations, including
- * task tracking and historical data management capabilities.
- *
- * @example
- * ```typescript
- * const state: State = {
- *   data: {
- *     currentTask: taskInstance,
- *     history: [...previousTasks]
- *   },
- *   metadata: {
- *     lastUpdated: new Date(),
- *     version: '1.0.0'
- *   }
- * };
- * ```
- *
- * @public
- * @since 0.5.6
- */
-export type State = CoreState<TaskAndHistory>;
-/**
- * A2A Update type that extends CoreUpdate with A2A-specific update events.
- *
- * This generic type provides type-safe update handling for A2A operations,
- * ensuring that updates conform to the expected UpdateEvent structure.
- *
- * @template TUpdate - The update event type, must extend UpdateEvent
- * @default UpdateEvent - Default update event type
- *
- * @example
- * ```typescript
- * // Using default UpdateEvent
- * const update: Update = {
- *   type: 'task_status_update',
- *   payload: statusUpdateEvent
- * };
- *
- * // Using specific update type
- * const messageUpdate: Update<Message> = {
- *   type: 'message',
- *   payload: messageEvent
- * };
- * ```
- *
- * @public
- * @since 0.5.6
- */
-export type Update<TUpdate extends UpdateEvent = UpdateEvent> = CoreUpdate<TUpdate>;
-/**
- * A2A Context type that combines Command, State, and Update types for complete context management.
- *
- * This is the main context type for A2A operations, providing a comprehensive
- * type-safe interface for handling commands, managing state, and processing updates
- * within the Agent-to-Agent communication framework.
- *
- * @template TCommand - The command type, must extend Command
- * @template TState - The state type, must extend State
- * @template TUpdate - The update type, must extend Update<UpdateEvent>
- *
- * @default TCommand - Command<MessageSendParams>
- * @default TState - State
- * @default TUpdate - Update<UpdateEvent>
- *
- * @example
- * ```typescript
- * // Using default types
- * const context: Context = {
- *   command: messageCommand,
- *   state: currentState,
- *   update: latestUpdate,
- *   // ... other context properties
- * };
- *
- * // Using custom types
- * interface CustomCommand extends Command<CustomParams> {
- *   priority: number;
- * }
- *
- * const customContext: Context<CustomCommand, State, Update<Task>> = {
- *   command: customCommand,
- *   state: currentState,
- *   update: taskUpdate,
- *   // ... other context properties
- * };
- * ```
- *
- * @remarks
- * This context type is designed to be the primary interface for A2A service
- * implementations, providing type safety and ensuring proper handling of
- * agent-to-agent communication patterns.
- *
- * @public
- * @since 0.5.6
- */
-export type Context<TCommand extends Command = Command<MessageSendParams>, TState extends State = State, TUpdate extends Update<UpdateEvent> = Update<UpdateEvent>> = CoreContext<TCommand, TState, TUpdate>;

package/dist/types/interfaces/services/a2a/context.js

@@ -1,5 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-export {};

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

@@ -1,7 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-import { ExecutionEngine } from "../core/execution/index.js";
-import { Command, State, Update } from "./context.js";
-export type A2AEngine = ExecutionEngine<Command, State, Update>;

package/dist/types/interfaces/services/a2a/engine.js

@@ -1,5 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-export {};

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

@@ -1,5 +0,0 @@
-export * from "./builder.js";
-export * from "./context.js";
-export * from "./engine.js";
-export * from "./legacy.js";
-export * from "./service.js";

package/dist/types/interfaces/services/a2a/index.js

@@ -1,5 +0,0 @@
-export * from "./builder.js";
-export * from "./context.js";
-export * from "./engine.js";
-export * from "./legacy.js";
-export * from "./service.js";

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

@@ -1,93 +0,0 @@
-/**
- * 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;
-    /**
-     * @deprecated This property is no longer being updated. Use the task.history property instead.
-     * 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.
- *
- * @deprecated Use A2AEngine instead.
- * @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;

package/dist/types/interfaces/services/a2a/legacy.js

@@ -1,5 +0,0 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-export {};