@naylence/agent-sdk 0.3.12 → 0.3.14

package/dist/esm/naylence/agent/agent-proxy.js

@@ -1,17 +1,33 @@
+/**
+ * Agent proxy module for remote agent communication.
+ *
+ * An {@link AgentProxy} is a client-side handle for invoking methods on a remote
+ * agent. Use it when you need to call an agent that lives in another process,
+ * container, or network location.
+ *
+ * @remarks
+ * Create proxies via {@link Agent.remote}, {@link Agent.remoteByAddress}, or
+ * {@link Agent.remoteByCapabilities} rather than instantiating AgentProxy directly.
+ *
+ * @module
+ */
 import { FameAddress, generateId, createRpcProxy } from '@naylence/runtime';
 import { TaskSchema, TaskArtifactUpdateEventSchema, TaskIdParamsSchema, TaskPushNotificationConfigSchema, TaskQueryParamsSchema, TaskSendParamsSchema, TaskState, TaskStatusUpdateEventSchema, } from './a2a-types.js';
 import { TERMINAL_TASK_STATES } from './task-states.js';
 import { firstTextPart, makeTaskParams } from './util.js';
 import { Agent } from './agent.js';
+/** @internal */
 function toRecord(value) {
     if (!value || typeof value !== 'object') {
         return {};
     }
     return value;
 }
+/** @internal */
 function toFameAddress(address) {
     return address instanceof FameAddress ? address : new FameAddress(String(address));
 }
+/** @internal */
 function wrapAgentProxy(proxy) {
     // Create RPC proxy options - only include address or capabilities, not both
     const proxyOptions = {
@@ -40,6 +56,7 @@ function wrapAgentProxy(proxy) {
         },
     });
 }
+/** @internal */
 async function nextWithTimeout(iterator, timeoutMs) {
     if (timeoutMs == null) {
         return await iterator.next();
@@ -57,7 +74,44 @@ async function nextWithTimeout(iterator, timeoutMs) {
         }
     }
 }
+/**
+ * Client-side proxy for communicating with remote agents.
+ *
+ * AgentProxy implements the {@link Agent} interface, allowing you to call
+ * remote agents as if they were local objects. Method calls are serialized
+ * and sent over the Fame fabric.
+ *
+ * @remarks
+ * Do not instantiate AgentProxy directly. Use the factory methods on
+ * {@link Agent} to create proxies:
+ * - {@link Agent.remote} for flexible options
+ * - {@link Agent.remoteByAddress} for direct addressing
+ * - {@link Agent.remoteByCapabilities} for capability-based discovery
+ *
+ * The proxy also supports arbitrary RPC method calls. Any method not defined
+ * on the proxy class is forwarded as an RPC call to the remote agent.
+ *
+ * @example
+ * ```typescript
+ * import { Agent } from '@naylence/agent-sdk';
+ *
+ * // Create a proxy to a remote agent
+ * const proxy = Agent.remoteByAddress('fame://calculator');
+ *
+ * // Run a task synchronously
+ * const result = await proxy.runTask({ a: 1, b: 2 });
+ *
+ * // Or start a task and poll for completion
+ * const task = await proxy.startTask({
+ *   id: 'task-1',
+ *   message: { role: 'user', parts: [{ type: 'text', text: 'compute' }] },
+ * });
+ * ```
+ *
+ * @typeParam TAgent - The type of the remote agent for result typing.
+ */
 export class AgentProxy extends Agent {
+    /** @internal */
     constructor(options) {
         const { address = null, capabilities = null, intentNl = null, fabric } = options;
         const provided = Number(address != null) + Number(capabilities != null) + Number(intentNl != null);
@@ -73,9 +127,11 @@ export class AgentProxy extends Agent {
         this.intentNl = intentNl;
         this.fabric = fabric;
     }
+    /** Returns null as proxies do not have a local name. */
     get name() {
         return null;
     }
+    /** Returns the proxy's targeting specification. */
     get spec() {
         const spec = {
             address: this.targetAddress ? this.targetAddress.toString() : null,
@@ -88,15 +144,22 @@ export class AgentProxy extends Agent {
         }
         return spec;
     }
+    /**
+     * The target agent's address, if specified.
+     * @deprecated Use {@link AgentProxy.address} instead.
+     */
     get addressRef() {
         return this.targetAddress;
     }
+    /** The target agent's address, if specified. */
     get address() {
         return this.targetAddress;
     }
+    /** The required capabilities for discovery, if specified. */
     get capabilities() {
         return this.targetCapabilities ?? undefined;
     }
+    /** The fabric this proxy uses for communication. */
     get proxyFabric() {
         return this.fabric;
     }
@@ -107,6 +170,24 @@ export class AgentProxy extends Agent {
         void _credentials;
         throw new Error('Proxy authentication is not supported');
     }
+    /**
+     * Executes a task on the remote agent and waits for completion.
+     *
+     * Starts the task, subscribes to updates, and returns when the task reaches
+     * a terminal state (completed, failed, or canceled).
+     *
+     * @param payload - The task payload to send.
+     * @param id - Optional task identifier. Generated if not provided.
+     * @returns The task result extracted from the final status message.
+     * @throws Error if the task fails.
+     *
+     * @example
+     * ```typescript
+     * const proxy = Agent.remoteByAddress('fame://echo');
+     * const result = await proxy.runTask('hello');
+     * console.log(result); // 'hello'
+     * ```
+     */
     async runTask(payload = null, id = null) {
         const taskId = id ?? generateId();
         const params = makeTaskParams({ id: taskId, payload });
@@ -180,16 +261,38 @@ export class AgentProxy extends Agent {
         const result = await this._invokeTarget('tasks/send', params);
         return TaskSchema.parse(result);
     }
+    /**
+     * Retrieves the current status of a task.
+     *
+     * @param params - Query parameters including the task ID.
+     * @returns The task with current status.
+     */
     async getTaskStatus(params) {
         const payload = TaskQueryParamsSchema.parse(params);
         const result = await this._invokeTarget('tasks/get', payload);
         return TaskSchema.parse(result);
     }
+    /**
+     * Requests cancellation of a running task.
+     *
+     * @param params - Parameters including the task ID.
+     * @returns The task with updated status.
+     */
     async cancelTask(params) {
         const payload = TaskIdParamsSchema.parse(params);
         const result = await this._invokeTarget('tasks/cancel', payload);
         return TaskSchema.parse(result);
     }
+    /**
+     * Subscribes to real-time updates for a task.
+     *
+     * Returns an async iterable that yields status and artifact events
+     * until the task reaches a terminal state or the stream is closed.
+     *
+     * @param params - Task parameters.
+     * @param options - Optional timeout and item limit settings.
+     * @returns Async iterable of task events.
+     */
     subscribeToTaskUpdates(params, options = {}) {
         const payload = TaskSendParamsSchema.parse(params);
         return this._streamRpc('tasks/sendSubscribe', payload, (frame) => {
@@ -199,20 +302,38 @@ export class AgentProxy extends Agent {
             return TaskStatusUpdateEventSchema.parse(frame);
         }, 'tasks/sendUnsubscribe', TaskIdParamsSchema.parse({ id: payload.id }), options);
     }
+    /**
+     * Cancels a task subscription.
+     *
+     * @param params - Parameters including the task ID.
+     */
     async unsubscribeTask(params) {
         const payload = TaskIdParamsSchema.parse(params);
         return await this._invokeTarget('tasks/sendUnsubscribe', payload);
     }
+    /**
+     * Registers a push notification endpoint for task updates.
+     *
+     * @param config - Push notification configuration.
+     * @returns The registered configuration.
+     */
     async registerPushEndpoint(config) {
         const payload = TaskPushNotificationConfigSchema.parse(config);
         const result = await this._invokeTarget('tasks/pushNotification/set', payload);
         return TaskPushNotificationConfigSchema.parse(result ?? payload);
     }
+    /**
+     * Retrieves the push notification config for a task.
+     *
+     * @param params - Parameters including the task ID.
+     * @returns The push notification configuration.
+     */
     async getPushNotificationConfig(params) {
         const payload = TaskIdParamsSchema.parse(params);
         const result = await this._invokeTarget('tasks/pushNotification/get', payload);
         return TaskPushNotificationConfigSchema.parse(result ?? payload);
     }
+    /** @internal */
     _streamRpc(method, params, parseFrame, unsubscribeMethod, unsubscribeParams, options) {
         const self = this;
         return {
@@ -282,6 +403,7 @@ export class AgentProxy extends Agent {
             },
         };
     }
+    /** @internal */
     async _invokeTarget(method, params, options = {}) {
         if (this.intentNl) {
             throw new Error('Intent-based routing not yet supported');
@@ -301,10 +423,18 @@ export class AgentProxy extends Agent {
         }
         throw new Error('Proxy has no routing target');
     }
+    /**
+     * Creates a proxy for a remote agent by address.
+     * @internal Use {@link Agent.remoteByAddress} instead.
+     */
     static remoteByAddress(address, options) {
         const proxy = new AgentProxy({ address, fabric: options.fabric });
         return wrapAgentProxy(proxy);
     }
+    /**
+     * Creates a proxy for a remote agent by capabilities.
+     * @internal Use {@link Agent.remoteByCapabilities} instead.
+     */
     static remoteByCapabilities(capabilities, options) {
         const proxy = new AgentProxy({ capabilities, fabric: options.fabric });
         return wrapAgentProxy(proxy);

package/dist/esm/naylence/agent/agent-proxy.js.map

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

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

@@ -1,3 +1,17 @@
+/**
+ * Agent module providing the abstract {@link Agent} class.
+ *
+ * An Agent is a self-contained unit of work that can receive tasks, process them,
+ * and return results. Agents communicate over the Fame fabric using a standard
+ * task-based protocol.
+ *
+ * @remarks
+ * For concrete implementations:
+ * - Use {@link BaseAgent} when you need full control over task handling and state.
+ * - Use {@link BackgroundTaskAgent} for long-running or async background work.
+ *
+ * @module
+ */
 import { FameAddress, FameFabric, LogLevel } from '@naylence/runtime';
 import { RpcMixin } from '@naylence/runtime';
 import type { FameService } from '@naylence/core';
@@ -6,25 +20,57 @@ export { registerAgentProxyFactory } from './agent-proxy-registry.js';
 export type { AgentProxyConstructor } from './agent-proxy-registry.js';
 import type { BaseAgent } from './base-agent.js';
 import type { AgentProxy } from './agent-proxy.js';
+/**
+ * Payload type for agent task messages.
+ *
+ * Can be a JSON object, a string, or null.
+ */
 export type Payload = Record<string, unknown> | string | null;
+/**
+ * Collection of address-payload pairs for broadcasting tasks to multiple agents.
+ */
 export type Targets = Iterable<readonly [FameAddress | string, Payload]>;
+/** @internal */
 type AgentTaskHandler = (payload: Payload, id: string | null) => unknown | Promise<unknown>;
+/**
+ * Constructor signature for BaseAgent implementations.
+ * @internal
+ */
 export type BaseAgentConstructor = new (name?: string | null, options?: any) => BaseAgent;
 /** @internal */
 export declare function registerBaseAgentConstructor(ctor: BaseAgentConstructor): void;
+/**
+ * Options for creating a remote agent proxy.
+ *
+ * Provide exactly one of `address` or `capabilities` to identify the target.
+ */
 export interface AgentRemoteOptions {
+    /** Direct address of the target agent. */
     address?: FameAddress | string;
+    /** Required capabilities for capability-based discovery. */
     capabilities?: string[];
+    /** Fabric instance to use. Defaults to the current fabric. */
     fabric?: FameFabric;
 }
+/**
+ * Options for running tasks on multiple agents.
+ */
 export interface AgentRunManyOptions {
+    /** Fabric instance to use. Defaults to the current fabric. */
     fabric?: FameFabric;
+    /**
+     * If true (default), errors are collected alongside results.
+     * If false, the first error rejects the promise.
+     */
     gatherExceptions?: boolean;
 }
+/**
+ * Options for serving an agent at a given address.
+ */
 export interface AgentServeOptions {
     /**
-     * Log level for the agent. Can be a string ('debug', 'info', 'warning', 'error', 'critical'),
-     * a numeric log level, or a LogLevel enum value.
+     * Log level for the agent.
+     * Accepts 'debug', 'info', 'warning', 'error', 'critical', or a LogLevel value.
      */
     logLevel?: string | number | LogLevel | null;
     /**
@@ -40,30 +86,176 @@ export interface AgentServeOptions {
      */
     [key: string]: unknown;
 }
+/**
+ * Abstract base class for all agents.
+ *
+ * Agents are addressable services that handle tasks over the Fame fabric.
+ * This class defines the core protocol methods every agent must implement.
+ *
+ * @remarks
+ * Do not extend Agent directly. Instead:
+ * - Extend {@link BaseAgent} for standard request-response agents.
+ * - Extend {@link BackgroundTaskAgent} for long-running background work.
+ *
+ * Use {@link Agent.remote} or {@link Agent.remoteByAddress} to create proxies
+ * for communicating with remote agents.
+ *
+ * @example
+ * ```typescript
+ * import { BaseAgent, Payload } from '@naylence/agent-sdk';
+ *
+ * class EchoAgent extends BaseAgent {
+ *   async runTask(payload: Payload): Promise<Payload> {
+ *     return payload;
+ *   }
+ * }
+ *
+ * const agent = new EchoAgent('echo');
+ * await agent.serve('fame://echo');
+ * ```
+ */
 export declare abstract class Agent extends RpcMixin implements FameService {
+    /**
+     * Capabilities advertised by this agent for discovery.
+     */
     get capabilities(): string[] | undefined;
+    /** The agent's name, used for logging and identification. */
     abstract get name(): string | null;
+    /** Returns metadata about this agent (address, capabilities, etc.). */
     abstract get spec(): Record<string, unknown>;
+    /** Returns the agent's card describing its capabilities and metadata. */
     abstract getAgentCard(): Promise<AgentCard>;
+    /**
+     * Validates authentication credentials.
+     * @param credentials - The credentials to validate.
+     * @returns True if authentication succeeds.
+     */
     abstract authenticate(credentials: AuthenticationInfo): boolean;
+    /**
+     * Initiates a new task.
+     * @param params - Task parameters including message and optional metadata.
+     * @returns The created task with its initial status.
+     */
     abstract startTask(params: TaskSendParams): Promise<Task>;
+    /**
+     * Executes a task synchronously and returns the result.
+     * @param payload - The task payload.
+     * @param id - Optional task identifier.
+     * @returns The task result.
+     */
     abstract runTask(payload: Payload, id: string | null): Promise<any>;
+    /**
+     * Retrieves the current status of a task.
+     * @param params - Query parameters including the task ID.
+     */
     abstract getTaskStatus(params: TaskQueryParams): Promise<Task>;
+    /**
+     * Requests cancellation of a running task.
+     * @param params - Parameters including the task ID.
+     * @returns The task with updated status.
+     */
     abstract cancelTask(params: TaskIdParams): Promise<Task>;
+    /**
+     * Subscribes to real-time updates for a task.
+     * @param params - Task parameters.
+     * @returns An async iterable of status and artifact update events.
+     */
     abstract subscribeToTaskUpdates(params: TaskSendParams): AsyncIterable<TaskStatusUpdateEvent | TaskArtifactUpdateEvent>;
+    /**
+     * Cancels a task subscription.
+     * @param params - Parameters including the task ID.
+     */
     abstract unsubscribeTask(params: TaskIdParams): Promise<any>;
+    /**
+     * Registers a push notification endpoint for task updates.
+     * @param config - Push notification configuration.
+     */
     abstract registerPushEndpoint(config: TaskPushNotificationConfig): Promise<TaskPushNotificationConfig>;
+    /**
+     * Retrieves the push notification config for a task.
+     * @param params - Parameters including the task ID.
+     */
     abstract getPushNotificationConfig(params: TaskIdParams): Promise<TaskPushNotificationConfig>;
+    /**
+     * Creates a proxy for communicating with a remote agent.
+     *
+     * @remarks
+     * Provide exactly one of `address` or `capabilities` in the options.
+     *
+     * @example
+     * ```typescript
+     * const proxy = Agent.remote<EchoAgent>({ address: 'fame://echo' });
+     * const result = await proxy.runTask('hello');
+     * ```
+     *
+     * @param options - Remote agent options.
+     * @returns A proxy for the remote agent.
+     * @throws Error if both or neither of address/capabilities are provided.
+     */
     static remote<TAgent extends Agent>(this: typeof Agent, options: AgentRemoteOptions): AgentProxy<TAgent>;
+    /**
+     * Creates a proxy for a remote agent by its address.
+     *
+     * @param address - The target agent's address.
+     * @param options - Optional fabric configuration.
+     * @returns A proxy for the remote agent.
+     */
     static remoteByAddress<TAgent extends Agent>(this: typeof Agent, address: FameAddress | string, options?: {
         fabric?: FameFabric;
     }): AgentProxy<TAgent>;
+    /**
+     * Creates a proxy for a remote agent by required capabilities.
+     *
+     * @param capabilities - Required capabilities for discovery.
+     * @param options - Optional fabric configuration.
+     * @returns A proxy for a matching remote agent.
+     */
     static remoteByCapabilities<TAgent extends Agent>(this: typeof Agent, capabilities: string[], options?: {
         fabric?: FameFabric;
     }): AgentProxy<TAgent>;
+    /**
+     * Creates an agent from a simple handler function.
+     *
+     * @remarks
+     * Useful for quick prototyping without defining a full agent class.
+     *
+     * @param handler - Function that processes task payloads.
+     * @returns A new agent instance wrapping the handler.
+     */
     static fromHandler(handler: AgentTaskHandler): Promise<Agent>;
+    /**
+     * Sends the same payload to multiple agents.
+     *
+     * @param addresses - List of agent addresses.
+     * @param payload - Payload to send to all agents.
+     * @param options - Execution options.
+     * @returns Array of [address, result|error] tuples.
+     */
     static broadcast(this: typeof Agent, addresses: Array<FameAddress | string>, payload?: Payload, options?: AgentRunManyOptions): Promise<Array<[string, any | Error]>>;
+    /**
+     * Runs tasks on multiple agents with individual payloads.
+     *
+     * @param targets - Iterable of [address, payload] pairs.
+     * @param options - Execution options.
+     * @returns Array of [address, result|error] tuples.
+     */
     static runMany<TAgent extends Agent>(this: typeof Agent, targets: Targets, options?: AgentRunManyOptions): Promise<Array<[string, any | Error]>>;
+    /**
+     * Starts serving this agent at the given address.
+     *
+     * @remarks
+     * In Node.js, the agent listens for SIGINT/SIGTERM to shut down gracefully.
+     * The method returns when the agent stops serving.
+     *
+     * @param address - The address to serve at (e.g., 'fame://my-agent').
+     * @param options - Serve options including log level and fabric config.
+     */
     aserve(address: FameAddress | string, options?: AgentServeOptions): Promise<void>;
+    /**
+     * Alias for {@link Agent.aserve}.
+     *
+     * @param address - The address to serve at.
+     * @param options - Serve options.
+     */
     serve(address: FameAddress | string, options?: AgentServeOptions): Promise<void>;
 }