@naylence/agent-sdk 0.3.12 → 0.3.13

package/dist/types/naylence/agent/background-task-agent.d.ts

@@ -1,36 +1,200 @@
 import { type Artifact, type Message, Task, type TaskArtifactUpdateEvent, TaskIdParams, type TaskQueryParams, TaskSendParams, TaskState, type TaskStatusUpdateEvent } from './a2a-types.js';
 import { BaseAgent, type BaseAgentOptions, type BaseAgentState } from './base-agent.js';
+/** @internal */
 type TaskEvent = TaskStatusUpdateEvent | TaskArtifactUpdateEvent;
+/**
+ * Configuration options for {@link BackgroundTaskAgent}.
+ */
 export interface BackgroundTaskAgentOptions<StateT extends BaseAgentState> extends BaseAgentOptions<StateT> {
+    /** Maximum number of events buffered per task. Defaults to 1000. */
     maxQueueSize?: number;
+    /**
+     * Maximum task execution time in milliseconds.
+     * Tasks exceeding this limit are automatically canceled. Null disables the limit.
+     */
     maxTaskLifetimeMs?: number | null;
+    /** Maximum number of completed tasks to cache. Defaults to 100. */
     completedCacheSize?: number;
+    /** Time-to-live for cached completed tasks in seconds. Defaults to 300. */
     completedCacheTtlSec?: number;
 }
+/**
+ * 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 declare abstract class BackgroundTaskAgent<StateT extends BaseAgentState = BaseAgentState> extends BaseAgent<StateT> {
+    /** @internal */
     private readonly maxQueueSize;
+    /** @internal */
     private readonly maxTaskLifetimeMs;
+    /** @internal */
     private readonly taskStatuses;
+    /** @internal */
     private readonly taskEventQueues;
+    /** @internal */
     private readonly completed;
+    /** @internal */
     private readonly completedCacheSize;
+    /** @internal */
     private readonly completedCacheTtlSec;
+    /** @internal */
     private readonly statusLock;
+    /**
+     * 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.
+     */
     protected constructor(name?: string | null, options?: BackgroundTaskAgentOptions<StateT>);
+    /** @internal */
     private isTerminalTaskState;
+    /**
+     * 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.
+     */
     startTask(params: TaskSendParams): Promise<Task>;
+    /** @internal */
     private enforceMaxLifetime;
+    /** @internal */
     private runBackgroundTaskInternal;
+    /**
+     * Override to implement background task execution logic.
+     *
+     * This method runs asynchronously after startTask returns. The return value
+     * becomes the task's completion message. Throwing an error fails the task.
+     *
+     * @remarks
+     * Call {@link BackgroundTaskAgent.updateTaskState} to report progress.
+     * Call {@link BackgroundTaskAgent.updateTaskArtifact} to emit artifacts.
+     *
+     * @param params - The original task parameters.
+     * @returns The task result, which is included in the completion message.
+     *
+     * @example
+     * ```typescript
+     * protected async runBackgroundTask(params: TaskSendParams): Promise<unknown> {
+     *   for (let i = 0; i < 10; i++) {
+     *     await this.updateTaskState(params.id, TaskState.WORKING);
+     *     await doStep(i);
+     *   }
+     *   return { steps: 10 };
+     * }
+     * ```
+     */
     protected abstract runBackgroundTask(params: TaskSendParams): Promise<unknown>;
+    /**
+     * Gets the current state of a task.
+     *
+     * @param taskId - The task identifier.
+     * @returns The current task state, or UNKNOWN if not found.
+     */
     getTaskState(taskId: string): Promise<TaskState>;
+    /**
+     * 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.
+     */
     getTaskStatus(params: TaskQueryParams): Promise<Task>;
+    /**
+     * 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.
+     */
     updateTaskState(taskId: string, state: TaskState, message?: Message | null): Promise<boolean>;
+    /** @internal */
     private addToCompleted;
+    /**
+     * 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.
+     */
     updateTaskArtifact(taskId: string, artifact: Artifact): Promise<void>;
+    /**
+     * 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: TaskSendParams): AsyncIterable<TaskEvent>;
+    /**
+     * Cancels a task subscription.
+     *
+     * @param params - Parameters including the task ID.
+     */
     unsubscribeTask(params: TaskIdParams): Promise<void>;
+    /**
+     * 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.
+     */
     cancelTask(params: TaskIdParams): Promise<Task>;
+    /** @internal */
     private purgeCompletedAfterTtl;
+    /** @internal */
     private normalizeResultPayload;
 }
 export {};

package/dist/types/naylence/agent/background-task-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"background-task-agent.d.ts","sourceRoot":"","sources":["../../../../src/naylence/agent/background-task-agent.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,IAAI,EACJ,KAAK,uBAAuB,EAC5B,YAAY,EACZ,KAAK,eAAe,EACpB,cAAc,EACd,SAAS,EAET,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAmBzB,KAAK,SAAS,GAAG,qBAAqB,GAAG,uBAAuB,CAAC;AAiGjE,MAAM,WAAW,0BAA0B,CAAC,MAAM,SAAS,cAAc,CACvE,SAAQ,gBAAgB,CAAC,MAAM,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,8BAAsB,mBAAmB,CACvC,MAAM,SAAS,cAAc,GAAG,cAAc,CAC9C,SAAQ,SAAS,CAAC,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgB;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAC9D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiD;IACjF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAE9C,SAAS,aACP,IAAI,GAAE,MAAM,GAAG,IAAW,EAC1B,OAAO,GAAE,0BAA0B,CAAC,MAAM,CAAM;IAkBlD,OAAO,CAAC,mBAAmB;IAQrB,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;YAiBxC,kBAAkB;YAiBlB,yBAAyB;IAqBvC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAExE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAShD,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBrD,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,EAChB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,OAAO,CAAC,OAAO,CAAC;IAuCnB,OAAO,CAAC,cAAc;IAuBhB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB3E,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,CAAC,SAAS,CAAC;IAqDlE,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;YAKvC,sBAAsB;IAMpC,OAAO,CAAC,sBAAsB;CAY/B"}
+{"version":3,"file":"background-task-agent.d.ts","sourceRoot":"","sources":["../../../../src/naylence/agent/background-task-agent.ts"],"names":[],"mappings":"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"}

package/dist/types/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>;
 }

package/dist/types/naylence/agent/base-agent.d.ts.map

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

package/dist/types/public-api.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Public API entrypoint for documentation generation.
+ *
+ * This file exports only the curated public surface of the Naylence Agent SDK.
+ * It is used by TypeDoc to generate API reference documentation.
+ *
+ * @packageDocumentation
+ */
+export * from './naylence/agent/a2a-types.js';
+export * from './naylence/agent/agent.js';
+export * from './naylence/agent/base-agent.js';
+export * from './naylence/agent/background-task-agent.js';
+export { AgentProxy } from './naylence/agent/agent-proxy.js';
+export * from './naylence/agent/errors.js';
+export * from './naylence/agent/configs.js';
+//# sourceMappingURL=public-api.d.ts.map

package/dist/types/public-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../../src/public-api.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2CAA2C,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC"}

package/dist/types/version.d.ts

@@ -2,5 +2,5 @@
  * The package version, injected at build time.
  * @internal
  */
-export declare const VERSION = "0.3.12";
+export declare const VERSION = "0.3.13";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naylence/agent-sdk",
-  "version": "0.3.12",
+  "version": "0.3.13",
   "type": "module",
   "description": "Naylence Agent SDK for TypeScript",
   "author": "Naylence Dev <naylencedev@gmail.com>",
@@ -71,13 +71,16 @@
     "lint:fix": "eslint src/**/*.ts --fix",
     "format": "prettier --write \"src/**/*.ts\"",
     "dev": "tsc --watch --outDir dist/esm",
+    "docs:clean": "rimraf docs/reference/ts/_generated",
+    "docs:gen": "typedoc",
+    "docs": "npm run docs:clean && npm run docs:gen",
     "inject-version": "node ./scripts/inject-version.js",
     "prebuild": "npm run inject-version",
     "predev": "npm run inject-version",
     "prepublishOnly": "npm run build && npm test"
   },
   "dependencies": {
-    "@naylence/runtime": "^0.3.15",
+    "@naylence/runtime": "^0.3.16",
     "zod": "^4.1.11"
   },
   "peerDependencies": {
@@ -107,6 +110,8 @@
     "ts-jest": "^29.4.4",
     "tslib": "^2.6.2",
     "tsx": "^4.20.6",
+    "typedoc": "^0.28.15",
+    "typedoc-plugin-markdown": "^4.9.0",
     "typescript": "^5.3.2"
   },
   "engines": {