@naylence/agent-sdk 0.3.11 → 0.3.13

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/naylence/agent/configs.d.ts

@@ -10,6 +10,10 @@ export declare const CLIENT_CONFIG: {
             readonly type: "AdmissionProfile";
             readonly profile: "${env:FAME_ADMISSION_PROFILE:open}";
         };
+        readonly identity_policy: {
+            readonly type: "NodeIdentityPolicyProfile";
+            readonly profile: "${env:FAME_NODE_IDENTITY_PROFILE:default}";
+        };
         readonly storage: {
             readonly type: "StorageProfile";
             readonly profile: "${env:FAME_STORAGE_PROFILE:memory}";
@@ -35,6 +39,10 @@ export declare const NODE_CONFIG: {
             readonly type: "AdmissionProfile";
             readonly profile: "${env:FAME_ADMISSION_PROFILE:open}";
         };
+        readonly identity_policy: {
+            readonly type: "NodeIdentityPolicyProfile";
+            readonly profile: "${env:FAME_NODE_IDENTITY_PROFILE:default}";
+        };
         readonly storage: {
             readonly type: "StorageProfile";
             readonly profile: "${env:FAME_STORAGE_PROFILE:memory}";
@@ -67,6 +75,10 @@ export declare const SENTINEL_CONFIG: {
             readonly type: "AdmissionProfile";
             readonly profile: "${env:FAME_ADMISSION_PROFILE:none}";
         };
+        readonly identity_policy: {
+            readonly type: "NodeIdentityPolicyProfile";
+            readonly profile: "${env:FAME_NODE_IDENTITY_PROFILE:default}";
+        };
         readonly storage: {
             readonly type: "StorageProfile";
             readonly profile: "${env:FAME_STORAGE_PROFILE:memory}";

package/dist/types/naylence/agent/configs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configs.d.ts","sourceRoot":"","sources":["../../../../src/naylence/agent/configs.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,OAAO,CAAC;AAqDlC,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;CAoBhB,CAAC;AAEX,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;CAwBd,CAAC;AAEX,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkClB,CAAC"}
+{"version":3,"file":"configs.d.ts","sourceRoot":"","sources":["../../../../src/naylence/agent/configs.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,OAAO,CAAC;AAqDlC,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;CAwBhB,CAAC;AAEX,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4Bd,CAAC;AAEX,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsClB,CAAC"}

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.11";
+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.11",
+  "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.12",
+    "@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": {