@naylence/agent-sdk 0.3.12 → 0.3.14

package/dist/esm/naylence/agent/background-task-agent.js

@@ -1,9 +1,28 @@
+/**
+ * Agent base for running background work (polling/cron-like).
+ *
+ * {@link BackgroundTaskAgent} extends {@link BaseAgent} with infrastructure for
+ * long-running, asynchronous task execution. Tasks run in the background after
+ * being started, with status updates streamed to subscribers.
+ *
+ * @remarks
+ * Use BackgroundTaskAgent when:
+ * - Task execution takes significant time (seconds to minutes)
+ * - You need to report progress updates during execution
+ * - Clients should not block waiting for completion
+ *
+ * For simple request-response patterns, use {@link BaseAgent} instead.
+ *
+ * @module
+ */
 import { AsyncLock, getLogger } from '@naylence/runtime';
 import { TaskState, } from './a2a-types.js';
 import { BaseAgent, TERMINAL_TASK_STATES, } from './base-agent.js';
 import { makeMessage } from './util.js';
 const logger = getLogger('naylence.agent.background_task_agent');
+/** @internal */
 const DEFAULT_EVENT_QUEUE_SIZE = 1000;
+/** @internal */
 const END_OF_STREAM_SENTINEL = Object.freeze({
     id: '__sentinel__',
     status: {
@@ -14,13 +33,16 @@ const END_OF_STREAM_SENTINEL = Object.freeze({
     final: false,
     metadata: null,
 });
+/** @internal */
 const TIMEOUT_SYMBOL = Symbol('background-task-queue-timeout');
+/** @internal */
 function monotonicSeconds() {
     if (typeof performance !== 'undefined' && typeof performance.now === 'function') {
         return performance.now() / 1000;
     }
     return Date.now() / 1000;
 }
+/** @internal */
 async function delay(ms) {
     await new Promise((resolve) => {
         const timeout = globalThis.setTimeout;
@@ -30,6 +52,7 @@ async function delay(ms) {
         timeout(resolve, ms);
     });
 }
+/** @internal */
 class AsyncEventQueue {
     constructor(maxSize) {
         this.maxSize = maxSize;
@@ -72,6 +95,7 @@ class AsyncEventQueue {
         }
     }
 }
+/** @internal */
 function createTaskFromStatus(id, status) {
     return {
         id,
@@ -82,6 +106,7 @@ function createTaskFromStatus(id, status) {
         metadata: null,
     };
 }
+/** @internal */
 function errorToString(error) {
     if (error instanceof Error) {
         return error.message || error.toString();
@@ -96,19 +121,75 @@ function errorToString(error) {
         return String(error);
     }
 }
+/**
+ * Base class for agents that execute long-running background tasks.
+ *
+ * Unlike {@link BaseAgent} which runs tasks synchronously in startTask,
+ * BackgroundTaskAgent starts tasks in the background and streams status
+ * updates to subscribers. This is ideal for work that takes significant time.
+ *
+ * @remarks
+ * Lifecycle:
+ * 1. Client calls startTask, which returns immediately with WORKING status
+ * 2. runBackgroundTask executes asynchronously
+ * 3. Status updates are queued and delivered to subscribers
+ * 4. Task completes with COMPLETED, FAILED, or CANCELED status
+ *
+ * Completed tasks are cached briefly for late subscribers to retrieve final status.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   BackgroundTaskAgent,
+ *   TaskSendParams,
+ *   TaskState,
+ * } from '@naylence/agent-sdk';
+ *
+ * class SlowAgent extends BackgroundTaskAgent {
+ *   protected async runBackgroundTask(params: TaskSendParams): Promise<string> {
+ *     // Report progress
+ *     await this.updateTaskState(params.id, TaskState.WORKING);
+ *
+ *     // Do expensive work
+ *     await someSlowOperation();
+ *
+ *     // Return value becomes the task result
+ *     return 'done';
+ *   }
+ * }
+ *
+ * const agent = new SlowAgent('slow-worker', {
+ *   maxTaskLifetimeMs: 60_000, // 1 minute timeout
+ * });
+ * await agent.serve('fame://slow-worker');
+ * ```
+ *
+ * @typeParam StateT - The state model type, defaults to {@link BaseAgentState}.
+ */
 export class BackgroundTaskAgent extends BaseAgent {
+    /**
+     * Creates a new BackgroundTaskAgent.
+     *
+     * @param name - Agent name. Defaults to snake_case of the class name.
+     * @param options - Configuration options for task execution and caching.
+     */
     constructor(name = null, options = {}) {
         const { maxQueueSize = DEFAULT_EVENT_QUEUE_SIZE, maxTaskLifetimeMs = null, completedCacheSize = 100, completedCacheTtlSec = 300, ...baseOptions } = options;
         super(name, baseOptions);
+        /** @internal */
         this.taskStatuses = new Map();
+        /** @internal */
         this.taskEventQueues = new Map();
+        /** @internal */
         this.completed = new Map();
+        /** @internal */
         this.statusLock = new AsyncLock();
         this.maxQueueSize = maxQueueSize;
         this.maxTaskLifetimeMs = maxTaskLifetimeMs;
         this.completedCacheSize = completedCacheSize;
         this.completedCacheTtlSec = completedCacheTtlSec;
     }
+    /** @internal */
     isTerminalTaskState(taskId) {
         const status = this.taskStatuses.get(taskId);
         if (status && TERMINAL_TASK_STATES.has(status.state)) {
@@ -116,6 +197,15 @@ export class BackgroundTaskAgent extends BaseAgent {
         }
         return this.completed.has(taskId);
     }
+    /**
+     * Starts a background task.
+     *
+     * Returns immediately with WORKING status. The task executes asynchronously
+     * via {@link BackgroundTaskAgent.runBackgroundTask}.
+     *
+     * @param params - Task parameters.
+     * @returns The task with initial WORKING status.
+     */
     async startTask(params) {
         this.taskEventQueues.set(params.id, new AsyncEventQueue(this.maxQueueSize));
         await this.updateTaskState(params.id, TaskState.WORKING);
@@ -125,6 +215,7 @@ export class BackgroundTaskAgent extends BaseAgent {
         }
         return await this.getTaskStatus({ id: params.id });
     }
+    /** @internal */
     async enforceMaxLifetime(taskId) {
         if (this.maxTaskLifetimeMs === null) {
             return;
@@ -138,6 +229,7 @@ export class BackgroundTaskAgent extends BaseAgent {
             await queue.put(END_OF_STREAM_SENTINEL);
         }
     }
+    /** @internal */
     async runBackgroundTaskInternal(params) {
         try {
             const result = await this.runBackgroundTask(params);
@@ -160,6 +252,12 @@ export class BackgroundTaskAgent extends BaseAgent {
             }
         }
     }
+    /**
+     * Gets the current state of a task.
+     *
+     * @param taskId - The task identifier.
+     * @returns The current task state, or UNKNOWN if not found.
+     */
     async getTaskState(taskId) {
         try {
             const task = await this.getTaskStatus({ id: taskId });
@@ -169,6 +267,13 @@ export class BackgroundTaskAgent extends BaseAgent {
             return TaskState.UNKNOWN;
         }
     }
+    /**
+     * Retrieves the full status of a task.
+     *
+     * @param params - Query parameters including the task ID.
+     * @returns The task with current status.
+     * @throws Error if the task is unknown or expired.
+     */
     async getTaskStatus(params) {
         return await this.statusLock.runExclusive(async () => {
             const status = this.taskStatuses.get(params.id);
@@ -185,6 +290,17 @@ export class BackgroundTaskAgent extends BaseAgent {
             throw new Error(`Unknown or expired task ${params.id}`);
         });
     }
+    /**
+     * Updates the state of a running task.
+     *
+     * Call this from {@link BackgroundTaskAgent.runBackgroundTask} to report progress.
+     * Status updates are delivered to subscribers.
+     *
+     * @param taskId - The task identifier.
+     * @param state - The new task state.
+     * @param message - Optional message with details.
+     * @returns True if the update was applied, false if the task is already terminal.
+     */
     async updateTaskState(taskId, state, message) {
         return await this.statusLock.runExclusive(async () => {
             if (this.isTerminalTaskState(taskId)) {
@@ -216,6 +332,7 @@ export class BackgroundTaskAgent extends BaseAgent {
             return true;
         });
     }
+    /** @internal */
     addToCompleted(taskId, status) {
         if (this.completedCacheSize <= 0) {
             return;
@@ -235,6 +352,14 @@ export class BackgroundTaskAgent extends BaseAgent {
             timestamp: monotonicSeconds(),
         });
     }
+    /**
+     * Emits an artifact for a running task.
+     *
+     * Artifacts are delivered to subscribers as TaskArtifactUpdateEvents.
+     *
+     * @param taskId - The task identifier.
+     * @param artifact - The artifact to emit.
+     */
     async updateTaskArtifact(taskId, artifact) {
         const queue = this.taskEventQueues.get(taskId);
         if (!queue) {
@@ -248,6 +373,15 @@ export class BackgroundTaskAgent extends BaseAgent {
         };
         await queue.put(event);
     }
+    /**
+     * Subscribes to updates for a task.
+     *
+     * Returns an async iterable that yields status and artifact events.
+     * For completed tasks, yields the cached final status if still available.
+     *
+     * @param params - Task parameters including the task ID.
+     * @returns Async iterable of task events.
+     */
     subscribeToTaskUpdates(params) {
         const queue = this.taskEventQueues.get(params.id);
         const self = this;
@@ -291,6 +425,11 @@ export class BackgroundTaskAgent extends BaseAgent {
         };
         return stream();
     }
+    /**
+     * Cancels a task subscription.
+     *
+     * @param params - Parameters including the task ID.
+     */
     async unsubscribeTask(params) {
         const queue = this.taskEventQueues.get(params.id);
         if (queue) {
@@ -298,15 +437,26 @@ export class BackgroundTaskAgent extends BaseAgent {
             await queue.put(END_OF_STREAM_SENTINEL);
         }
     }
+    /**
+     * Cancels a running task.
+     *
+     * Sets the task state to CANCELED. Does not interrupt runBackgroundTask,
+     * but prevents further state updates.
+     *
+     * @param params - Parameters including the task ID.
+     * @returns The task with CANCELED status.
+     */
     async cancelTask(params) {
         await this.updateTaskState(params.id, TaskState.CANCELED);
         return await this.getTaskStatus({ id: params.id });
     }
+    /** @internal */
     async purgeCompletedAfterTtl(taskId) {
         await delay(this.completedCacheTtlSec * 1000);
         this.completed.delete(taskId);
         this.taskEventQueues.delete(taskId);
     }
+    /** @internal */
     normalizeResultPayload(result) {
         if (result === null || result === undefined) {
             return null;

package/dist/esm/naylence/agent/background-task-agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"background-task-agent.js","sourceRoot":"","sources":["../../../../src/naylence/agent/background-task-agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"background-task-agent.js","sourceRoot":"","sources":["../../../../src/naylence/agent/background-task-agent.ts"],"names":[],"mappings":"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"}

package/dist/esm/naylence/agent/base-agent.d.ts

@@ -1,3 +1,15 @@
+/**
+ * Base class for implementing agents.
+ *
+ * {@link BaseAgent} provides the standard implementation of the {@link Agent} protocol
+ * with built-in support for state management, message handling, and task execution.
+ *
+ * @remarks
+ * Extend this class for request-response style agents. For long-running background
+ * work, consider extending {@link BackgroundTaskAgent} instead.
+ *
+ * @module
+ */
 import { type FameDeliveryContext, type FameEnvelope, type FameMessageResponse } from '@naylence/core';
 import { FameAddress, FameFabric, NodeLike, Registerable, type StorageProvider } from '@naylence/runtime';
 import { z } from 'zod';
@@ -5,6 +17,7 @@ import { Agent, type Payload } from './agent.js';
 import { type AgentCard, Task, type TaskArtifactUpdateEvent, TaskIdParams, TaskPushNotificationConfig, TaskQueryParams, TaskSendParams, TaskStatusUpdateEvent } from './a2a-types.js';
 import { TERMINAL_TASK_STATES } from './task-states.js';
 export { TERMINAL_TASK_STATES };
+/** @internal */
 declare class StateContext<StateT extends BaseAgentState> {
     private readonly acquireLock;
     private readonly loadState;
@@ -133,16 +146,73 @@ export declare class BaseAgentState {
      */
     clone(): this;
 }
+/** @internal */
 type StateModelCtor<T extends BaseAgentState> = new () => T;
+/**
+ * Configuration options for {@link BaseAgent}.
+ */
 export interface BaseAgentOptions<StateT extends BaseAgentState> {
+    /** State model class for typed state management. */
     stateModel?: StateModelCtor<StateT> | null;
+    /** Namespace for state storage. Defaults to agent name. */
     stateNamespace?: string | null;
+    /** Key under which state is stored. Defaults to 'state'. */
     stateKey?: string;
+    /** Factory function to create initial state. */
     stateFactory?: (() => StateT) | null;
+    /** Custom storage provider for state persistence. */
     storageProvider?: StorageProvider | null;
 }
+/**
+ * Standard implementation of the {@link Agent} protocol.
+ *
+ * Provides built-in state management, message handling, and task lifecycle support.
+ * Extend this class and override {@link BaseAgent.runTask} to implement your agent logic.
+ *
+ * @remarks
+ * BaseAgent handles:
+ * - JSON-RPC message routing
+ * - State persistence with optional Zod validation
+ * - Task creation from runTask results
+ * - Graceful shutdown via SIGINT/SIGTERM
+ *
+ * For background/async task execution, use {@link BackgroundTaskAgent} instead.
+ *
+ * @example
+ * ```typescript
+ * import { BaseAgent, Payload, BaseAgentState } from '@naylence/agent-sdk';
+ * import { z } from 'zod';
+ *
+ * const CounterSchema = z.object({ count: z.number() });
+ *
+ * class CounterState extends BaseAgentState {
+ *   static readonly schema = CounterSchema;
+ *   count = 0;
+ * }
+ *
+ * class CounterAgent extends BaseAgent<CounterState> {
+ *   static STATE_MODEL = CounterState;
+ *
+ *   async runTask(payload: Payload): Promise<number> {
+ *     return await this.withState(async (state) => {
+ *       state.count += 1;
+ *       return state.count;
+ *     });
+ *   }
+ * }
+ *
+ * const agent = new CounterAgent('counter');
+ * await agent.serve('fame://counter');
+ * ```
+ *
+ * @typeParam StateT - The state model type, defaults to {@link BaseAgentState}.
+ */
 export declare class BaseAgent<StateT extends BaseAgentState = BaseAgentState> extends Agent implements Registerable {
     #private;
+    /**
+     * Default state model class. Override in subclasses to set state type.
+     * @internal
+     */
     static STATE_MODEL: StateModelCtor<BaseAgentState> | null;
     private _name;
     private _address;
@@ -158,12 +228,29 @@ export declare class BaseAgent<StateT extends BaseAgentState = BaseAgentState> e
     private _fabric;
     private _stateStore;
     private _stateCache;
+    /**
+     * Creates a new BaseAgent.
+     *
+     * @param name - Agent name. Defaults to snake_case of the class name.
+     * @param options - Configuration options for state and storage.
+     */
     constructor(name?: string | null, options?: BaseAgentOptions<StateT>);
+    /**
+     * Capabilities advertised by this agent.
+     * Includes the standard agent capability by default.
+     */
     get capabilities(): string[];
+    /** The agent's name. */
     get name(): string | null;
     get spec(): Record<string, unknown>;
+    /** The address this agent is registered at. */
     get address(): FameAddress | null;
+    /** @internal */
     set address(value: FameAddress | null);
+    /**
+     * Storage provider for state persistence.
+     * @throws Error if no storage provider is available.
+     */
     get storageProvider(): StorageProvider;
     /**
      * Returns the fabric this agent is registered with.
@@ -172,21 +259,74 @@ export declare class BaseAgent<StateT extends BaseAgentState = BaseAgentState> e
      */
     protected get fabric(): FameFabric | null;
     onRegister?(node: NodeLike): Promise<void>;
+    /** @internal */
     protected acquireStateLock(): Promise<() => void>;
+    /** @internal */
     private ensureStateModel;
+    /** @internal */
     private ensureStateStore;
+    /** @internal */
     private defaultStateNamespace;
+    /** @internal */
     protected loadStateInternal(): Promise<StateT>;
+    /** @internal */
     protected saveStateInternal(state: StateT): Promise<void>;
+    /**
+     * State context for lock-protected state access.
+     *
+     * @remarks
+     * Prefer using {@link BaseAgent.withState} for simpler access patterns.
+     *
+     * @throws Error if no state model is configured.
+     */
     get state(): StateContext<StateT>;
+    /**
+     * Executes a callback with exclusive access to the agent's state.
+     *
+     * State changes are automatically persisted after the callback completes.
+     *
+     * @param callback - Function receiving the current state.
+     * @returns The callback's return value.
+     *
+     * @example
+     * ```typescript
+     * const count = await this.withState(async (state) => {
+     *   state.count += 1;
+     *   return state.count;
+     * });
+     * ```
+     */
     withState<T>(callback: (state: StateT) => Promise<T>): Promise<T>;
+    /**
+     * Retrieves a snapshot of the current state.
+     *
+     * @remarks
+     * Returns a point-in-time copy. For modifications, use {@link BaseAgent.withState}.
+     */
     getState(): Promise<StateT>;
+    /**
+     * Deletes all persisted state for this agent.
+     */
     clearState(): Promise<void>;
+    /** @internal */
     private static isRpcRequest;
+    /** @internal */
     handleMessage(envelope: FameEnvelope, _context?: FameDeliveryContext): Promise<FameMessageResponse | AsyncIterable<FameMessageResponse> | null | void>;
+    /**
+     * Override to handle non-RPC messages.
+     *
+     * Called when the agent receives a message that is not a JSON-RPC request.
+     * The default implementation logs a warning and returns null.
+     *
+     * @param message - The decoded message payload.
+     * @returns Optional response to send back.
+     */
     onMessage(message: unknown): Promise<FameMessageResponse | null | void>;
+    /** @internal */
     private handleRpcMessage;
+    /** @internal */
     private startSubscriptionTask;
+    /** @internal */
     private streamSendSubscribe;
     authenticate(_credentials: unknown): boolean;
     registerPushEndpoint(_config: TaskPushNotificationConfig): Promise<TaskPushNotificationConfig>;
@@ -196,7 +336,38 @@ export declare class BaseAgent<StateT extends BaseAgentState = BaseAgentState> e
     cancelTask(_params: TaskIdParams): Promise<Task>;
     getAgentCard(): Promise<AgentCard>;
     getTaskStatus(_params: TaskQueryParams): Promise<Task>;
+    /**
+     * Override to implement task execution logic.
+     *
+     * This is the primary extension point for agent behavior. Return the task result
+     * or throw an error to fail the task.
+     *
+     * @param _payload - The task payload.
+     * @param _id - Optional task identifier.
+     * @returns The task result.
+     * @throws UnsupportedOperationException if not overridden.
+     *
+     * @example
+     * ```typescript
+     * async runTask(payload: Payload): Promise<string> {
+     *   const input = typeof payload === 'string' ? payload : '';
+     *   return `Hello, ${input}!`;
+     * }
+     * ```
+     */
     runTask(_payload: Payload, _id: string | null): Promise<unknown>;
+    /**
+     * Initiates a task and returns its status.
+     *
+     * @remarks
+     * If you override {@link BaseAgent.runTask}, this method automatically
+     * creates a Task from the result. Override this method for custom
+     * task lifecycle management.
+     *
+     * @param params - Task parameters including message and metadata.
+     * @returns The completed task with result.
+     * @throws Error if neither startTask nor runTask is implemented.
+     */
     startTask(params: TaskSendParams): Promise<Task>;
     aserve(address: FameAddress | string, options?: Parameters<Agent['aserve']>[1]): Promise<void>;
 }