@mozilla-ai/mcpd 0.0.3 → 0.1.0

package/README.md

@@ -73,7 +73,6 @@ const client = new McpdClient({
   apiEndpoint: "http://localhost:8090",
   apiKey: "optional-key", // Optional API key
   healthCacheTtl: 10, // Cache health checks for 10 seconds
-  serverCacheTtl: 60, // Cache server/tool metadata for 60 seconds
 });
 
 // Full type safety and autocomplete
@@ -107,11 +106,114 @@ const client = new McpdClient({
   apiEndpoint: "http://localhost:8090", // Required
   apiKey: "optional-key", // Optional: API key for authentication
   healthCacheTtl: 10, // Optional: TTL in seconds for health cache (default: 10)
-  serverCacheTtl: 60, // Optional: TTL in seconds for server/tools cache (default: 60)
   timeout: 30000, // Optional: Request timeout in ms (default: 30000)
 });
 ```
 
+### Logging
+
+The SDK includes optional logging for warnings about unhealthy or non-existent servers that are skipped during operations.
+
+**Important:** Logging is disabled by default. Only enable logging in non-MCP-server contexts. MCP servers using stdio transport for JSON-RPC communication should never enable logging, as it will contaminate stdout/stderr and break the protocol.
+
+#### Using Environment Variable
+
+Set the `MCPD_LOG_LEVEL` environment variable to control logging:
+
+```bash
+# Valid levels: trace, debug, info, warn, error, off (default)
+export MCPD_LOG_LEVEL=warn
+```
+
+**Available Log Levels:**
+
+| Level   | Description                                                     |
+| ------- | --------------------------------------------------------------- |
+| `trace` | Verbose information (includes `debug`, `info`, `warn`, `error`) |
+| `debug` | Debug information (includes `info`, `warn`, `error`)            |
+| `info`  | General informational messages (includes `warn`, `error`)       |
+| `warn`  | Warning messages only (includes `error`)                        |
+| `error` | Error messages only                                             |
+| `off`   | (...or unset) Logging disabled (default)                        |
+
+```typescript
+// Logging is automatically enabled based on MCPD_LOG_LEVEL
+const client = new McpdClient({
+  apiEndpoint: "http://localhost:8090",
+});
+```
+
+#### Using Custom Logger
+
+For advanced use cases, inject your own logger implementation.
+
+**Partial Logger Support:** You can provide only the methods you want to customize. Any omitted methods will fall back to the default logger, which respects `MCPD_LOG_LEVEL`.
+
+```typescript
+import { McpdClient } from "@mozilla-ai/mcpd";
+
+// Full custom logger
+const client = new McpdClient({
+  apiEndpoint: "http://localhost:8090",
+  logger: {
+    trace: (...args) => myLogger.trace(args),
+    debug: (...args) => myLogger.debug(args),
+    info: (...args) => myLogger.info(args),
+    warn: (...args) => myLogger.warn(args),
+    error: (...args) => myLogger.error(args),
+  },
+});
+
+// Partial logger: custom warn/error, default (MCPD_LOG_LEVEL-aware) for others
+const client2 = new McpdClient({
+  apiEndpoint: "http://localhost:8090",
+  logger: {
+    warn: (msg) => console.warn(`[mcpd] ${msg}`),
+    error: (msg) => console.error(`[mcpd] ${msg}`),
+    // trace, debug, info use default logger (respects MCPD_LOG_LEVEL)
+  },
+});
+```
+
+#### Disabling Logging
+
+To disable logging, simply ensure `MCPD_LOG_LEVEL` is unset or set to `off` (the default):
+
+```typescript
+// Logging is disabled by default (no configuration needed)
+const client = new McpdClient({
+  apiEndpoint: "http://localhost:8090",
+});
+```
+
+If you need to disable logging even when `MCPD_LOG_LEVEL` is set (rare case), provide a custom logger with no-op implementations:
+
+```typescript
+// Override MCPD_LOG_LEVEL to force disable
+const client = new McpdClient({
+  apiEndpoint: "http://localhost:8090",
+  logger: {
+    trace: () => {},
+    debug: () => {},
+    info: () => {},
+    warn: () => {},
+    error: () => {},
+  },
+});
+```
+
+When logging is enabled, warnings are emitted for:
+
+- Unhealthy servers that are skipped (e.g., status `timeout`, `unreachable`)
+- Non-existent servers specified in filter options
+
+Example warning messages:
+
+```text
+Skipping unhealthy server 'time' with status 'timeout'
+Skipping non-existent server 'unknown'
+```
+
 ### Core Methods
 
 #### `client.listServers()`
@@ -357,12 +459,29 @@ if (await client.isServerHealthy("time")) {
 
 #### `client.getAgentTools(options?)`
 
-Generate callable functions that work directly with AI agent frameworks. No conversion layers needed.
+Generate (cached) callable functions that work directly with AI agent frameworks. No conversion layers needed.
+
+> [!IMPORTANT]
+> Generated functions are cached for performance. Once cached, subsequent calls return cached functions regardless of filter parameters.
+> To force regeneration, either call `client.clearAgentToolsCache()` first, or use the `refreshCache: true` option.
+
+##### Supports filtering by servers and by tools
+
+AI agents perform better with focused tool sets they need to complete the given task.
+Tool filtering enables progressive disclosure - operators can expose a subset of server tools via `mcpd` configuration,
+then agents can further narrow down to only the tools needed for their specific task.
+This prevents overwhelming the model's context window and improves response quality.
+
+##### Examples
 
 ```typescript
-// Options: { servers?: string[], format?: 'array' | 'object' | 'map' }
-// Default format is 'array' (for LangChain)
+// Options: { servers?: string[], tools?: string[], format?: 'array' | 'object' | 'map', refreshCache?: boolean }
+// Default format is 'array' (for LangChain), refreshCache defaults to false
+```
+
+LangChain
 
+```typescript
 // Use with LangChain JS (array format is default)
 import { ChatOpenAI } from "@langchain/openai";
 
@@ -380,7 +499,11 @@ const agent = await createOpenAIToolsAgent({
   tools: langchainTools,
   prompt,
 });
+```
+
+Vercel-AI
 
+```typescript
 // Use with Vercel AI SDK (expects object format)
 import { generateText } from "ai";
 
@@ -390,12 +513,46 @@ const result = await generateText({
   tools: vercelTools,
   prompt: "What time is it in Tokyo?",
 });
+```
+
+Filtering examples
 
+```typescript
 // Filter to specific servers
 const timeTools = await client.getAgentTools({
   servers: ["time"],
   format: "array",
 });
+```
+
+```typescript
+// Filter by tool names (cross-cutting across all servers)
+const mathTools = await client.getAgentTools({
+  tools: ["add", "multiply"],
+});
+```
+
+```typescript
+// Filter by qualified tool names (server-specific)
+const specificTools = await client.getAgentTools({
+  tools: ["time__get_current_time", "math__add"],
+});
+```
+
+```typescript
+// Combine server and tool filtering
+const filteredTools = await client.getAgentTools({
+  servers: ["time", "math"],
+  tools: ["add", "get_current_time"],
+});
+```
+
+```typescript
+// Tool filtering works with different formats
+const toolsObject = await client.getAgentTools({
+  tools: ["add", "multiply"],
+  format: "object",
+});
 
 // Use with Map for efficient lookups
 const toolMap = await client.getAgentTools({ format: "map" });
@@ -404,6 +561,9 @@ if (timeTool) {
   const result = await timeTool({ timezone: "UTC" });
 }
 
+// Force refresh from cache to get latest schemas
+const freshTools = await client.getAgentTools({ refreshCache: true });
+
 // Each function has metadata for both frameworks
 const tools = await client.getAgentTools();
 for (const tool of tools) {
@@ -419,7 +579,7 @@ for (const tool of tools) {
 Clear the cache of generated agent tools functions.
 
 ```typescript
-// Clear cache to regenerate tools with latest schemas
+// Clear cache to regenerate tools with latest schemas, or latest client side server/tool filters.
 client.clearAgentToolsCache();
 const freshTools = await client.getAgentTools();
 ```
@@ -449,12 +609,20 @@ import {
   ToolExecutionError, // Tool execution failed
   ValidationError, // Input validation failed
   TimeoutError, // Operation timed out
+  PipelineError, // Pipeline processing failed
 } from "@mozilla-ai/mcpd";
 
 try {
   const result = await client.servers.unknown.tools.tool();
 } catch (error) {
-  if (error instanceof ToolNotFoundError) {
+  if (error instanceof PipelineError) {
+    // Pipeline failure - a required plugin failed during processing.
+    console.error(`Pipeline ${error.pipelineFlow} failure:`, error.message);
+    if (error.pipelineFlow === "response") {
+      // Tool was called but results cannot be delivered.
+      console.error("A required plugin failed during response processing");
+    }
+  } else if (error instanceof ToolNotFoundError) {
     console.error(
       `Tool not found: ${error.toolName} on server ${error.serverName}`,
     );
@@ -466,6 +634,20 @@ try {
 }
 ```
 
+### PipelineError
+
+The `PipelineError` is thrown when mcpd's plugin pipeline fails. This indicates a problem with a plugin or an external system that a plugin depends on (e.g., audit service, authentication provider), not a problem with your request or the tool itself.
+
+- **Response Pipeline Failure** (`pipelineFlow === 'response'`): The upstream request was processed (the tool was called), but results cannot be returned because a required plugin (like audit logging) failed during response processing. This does not indicate whether the tool itself succeeded or failed.
+- **Request Pipeline Failure** (`pipelineFlow === 'request'`): The request was rejected before reaching the upstream server because a required plugin (like authentication) failed during request processing.
+
+Properties:
+
+- `message: string` - Descriptive error message
+- `serverName?: string` - The server name (when called through tool execution)
+- `operation?: string` - The operation (e.g., "time.get_current_time")
+- `pipelineFlow?: 'request' | 'response'` - Which pipeline flow failed
+
 ## Development
 
 ### Setup

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { McpdClientOptions, ServerHealth } from './types';
+import { McpdClientOptions, ServerHealth, ArrayAgentToolsOptions, ObjectAgentToolsOptions, MapAgentToolsOptions } from './types';
 import { ServersNamespace } from './dynamicCaller';
 import { AgentFunction } from './functionBuilder';
 /**
@@ -20,7 +20,6 @@ import { AgentFunction } from './functionBuilder';
  *   apiEndpoint: 'http://localhost:8090',
  *   apiKey: 'optional-key',
  *   healthCacheTtl: 10,
- *   serverCacheTtl: 60
  * });
  *
  * // List available servers
@@ -48,6 +47,10 @@ export declare class McpdClient {
      * Get a list of all configured MCP servers.
      *
      * @returns Array of server names
+     *
+     * @throws {AuthenticationError} If API key was present and authentication fails
+     * @throws {ConnectionError} If unable to connect to the mcpd daemon
+     * @throws {TimeoutError} If the request times out
      * @throws {McpdError} If the request fails
      *
      * @example
@@ -60,9 +63,13 @@ export declare class McpdClient {
     /**
      * Get health information for one or all servers.
      *
-     * @param serverName - Optional server name to get health for
+     * @param serverName - Server name to get health for, or undefined for all servers
+     *
      * @returns Health information for the specified server or all servers
-     * @throws {ServerNotFoundError} If the specified server doesn't exist
+     *
+     * @throws {AuthenticationError} If API key was present and authentication fails
+     * @throws {ConnectionError} If unable to connect to the mcpd daemon
+     * @throws {TimeoutError} If the request times out
      * @throws {McpdError} If the request fails
      *
      * @example
@@ -82,8 +89,14 @@ export declare class McpdClient {
      * Check if a specific server is healthy.
      *
      * @param serverName - The name of the server to check
+     *
      * @returns True if the server is healthy, false otherwise
      *
+     * @throws {AuthenticationError} If API key was present and authentication fails
+     * @throws {ConnectionError} If unable to connect to the mcpd daemon
+     * @throws {TimeoutError} If the request times out
+     * @throws {McpdError} If the request fails
+     *
      * @example
      * ```typescript
      * if (await client.isServerHealthy('time')) {
@@ -102,47 +115,29 @@ export declare class McpdClient {
      * This forces fresh health checks on the next getServerHealth() or isServerHealthy() call.
      */
     clearServerHealthCache(): void;
-    /**
-     * Generate callable functions for use with AI agent frameworks (internal).
-     *
-     * This method queries servers and creates self-contained, callable functions
-     * that can be passed to AI agent frameworks. Each function includes its schema
-     * as metadata and handles the MCP communication internally.
-     *
-     * This method automatically filters out unhealthy servers by checking their health
-     * status before fetching tools. Unhealthy servers are silently skipped to ensure
-     * the method returns quickly without waiting for timeouts on failed servers.
-     *
-     * Tool fetches from multiple servers are executed concurrently for optimal performance.
-     *
-     * @param servers - Optional list of server names to include. If not specified, includes all servers.
-     * @returns Array of callable functions with metadata. Only includes tools from healthy servers.
-     *
-     * @throws {ConnectionError} If unable to connect to the mcpd daemon
-     * @throws {TimeoutError} If requests to the daemon time out
-     * @throws {AuthenticationError} If API key authentication fails
-     * @throws {McpdError} If unable to retrieve health status, server list, or generate functions
-     * @internal
-     */
-    agentTools(servers?: string[]): Promise<AgentFunction[]>;
     /**
      * Generate callable functions for use with AI agent frameworks.
      *
-     * This method queries servers and creates self-contained, callable functions
+     * This method queries servers to create and cache self-contained, callable functions
      * that can be passed to AI agent frameworks. Each function includes its schema
      * as metadata and handles the MCP communication internally.
      *
-     * This method automatically filters out unhealthy servers by checking their health
-     * status before fetching tools. Unhealthy servers are silently skipped to ensure
-     * the method returns quickly without waiting for timeouts on failed servers.
+     * @remarks
+     * This method automatically filters out unhealthy servers by checking their health status before fetching tools.
+     * Unhealthy servers are skipped (with optional warnings when logging is enabled) to ensure the
+     * method returns quickly without waiting for timeouts on failed servers.
      *
      * Tool fetches from multiple servers are executed concurrently for optimal performance.
      *
-     * The generated functions are cached for performance. Use clearAgentToolsCache()
-     * to force regeneration if servers or tools have changed.
+     * Generated functions are cached for performance. Once cached, subsequent calls return
+     * the cached functions immediately without refetching schemas, regardless of filter parameters.
+     * Use {@link clearAgentToolsCache()} to clear the cache, or set refreshCache to true
+     * to force regeneration when tool schemas have changed.
+     *
+     * @param options - Options for output format, server/tool filtering, and cache control
      *
-     * @param options - Options for generating agent tools (format and server filtering)
-     * @returns Functions in the requested format (array, object, or map). Only includes tools from healthy servers.
+     * @returns Functions in the requested format (array, object, or map).
+     *          Only includes tools from healthy servers.
      *
      * @throws {ConnectionError} If unable to connect to the mcpd daemon
      * @throws {TimeoutError} If requests to the daemon time out
@@ -158,6 +153,9 @@ export declare class McpdClient {
      * // Get tools from specific servers
      * const tools = await client.getAgentTools({ servers: ['time', 'fetch'] });
      *
+     * // Force refresh from cache
+     * const freshTools = await client.getAgentTools({ refreshCache: true });
+     *
      * // Use with LangChain JS (array format)
      * const langchainTools = await client.getAgentTools({ format: 'array' });
      * const agent = await createOpenAIToolsAgent({ llm, tools: langchainTools, prompt });
@@ -170,17 +168,8 @@ export declare class McpdClient {
      * const result = await generateText({ model, tools: vercelTools, prompt });
      * ```
      */
-    getAgentTools(options?: {
-        format?: "array";
-        servers?: string[];
-    }): Promise<AgentFunction[]>;
-    getAgentTools(options: {
-        format: "object";
-        servers?: string[];
-    }): Promise<Record<string, AgentFunction>>;
-    getAgentTools(options: {
-        format: "map";
-        servers?: string[];
-    }): Promise<Map<string, AgentFunction>>;
+    getAgentTools(options?: ArrayAgentToolsOptions): Promise<AgentFunction[]>;
+    getAgentTools(options: ObjectAgentToolsOptions): Promise<Record<string, AgentFunction>>;
+    getAgentTools(options: MapAgentToolsOptions): Promise<Map<string, AgentFunction>>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,OAAO,EAEL,iBAAiB,EACjB,YAAY,EAeb,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AASxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,UAAU;;IAYrB;;OAEG;IACH,SAAgB,OAAO,EAAE,gBAAgB,CAAC;IAE1C;;;;OAIG;gBACS,OAAO,EAAE,iBAAiB;IAkJtC;;;;;;;;;;;OAWG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAmNtC;;;;;;;;;;;;;;;;;;OAkBG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAoDhE;;;;;;;;;;;;OAYG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqH3D;;;OAGG;IACH,oBAAoB,IAAI,IAAI;IAI5B;;;OAGG;IACH,sBAAsB,IAAI,IAAI;IAI9B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA6B9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE;QAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IACtB,aAAa,CAAC,OAAO,EAAE;QAC3B,MAAM,EAAE,QAAQ,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACpC,aAAa,CAAC,OAAO,EAAE;QAC3B,MAAM,EAAE,KAAK,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAwBxC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgBH,OAAO,EAEL,iBAAiB,EACjB,YAAY,EAMZ,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EAUrB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AA6DxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,UAAU;;IAarB;;OAEG;IACH,SAAgB,OAAO,EAAE,gBAAgB,CAAC;IAE1C;;;;OAIG;gBACS,OAAO,EAAE,iBAAiB;IAqLtC;;;;;;;;;;;;;;;OAeG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA8PtC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAoDhE;;;;;;;;;;;;;;;;;;OAkBG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA6J3D;;;OAGG;IACH,oBAAoB,IAAI,IAAI;IAI5B;;;OAGG;IACH,sBAAsB,IAAI,IAAI;IA4D9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoDG;IACG,aAAa,CACjB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,aAAa,EAAE,CAAC;IACrB,aAAa,CACjB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACnC,aAAa,CACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CA+DvC"}

package/dist/errors.d.ts

@@ -1,4 +1,16 @@
 import { ErrorModel } from './types';
+/**
+ * Pipeline flow constant for request processing failures.
+ */
+export declare const PIPELINE_FLOW_REQUEST: "request";
+/**
+ * Pipeline flow constant for response processing failures.
+ */
+export declare const PIPELINE_FLOW_RESPONSE: "response";
+/**
+ * Pipeline flow indicating where in the pipeline the failure occurred.
+ */
+export type PipelineFlow = typeof PIPELINE_FLOW_REQUEST | typeof PIPELINE_FLOW_RESPONSE;
 /**
  * Base exception for all mcpd SDK errors.
  *
@@ -110,4 +122,60 @@ export declare class TimeoutError extends McpdError {
     readonly timeout: number | undefined;
     constructor(message: string, operation?: string, timeout?: number, cause?: Error);
 }
+/**
+ * Raised when required pipeline processing fails.
+ *
+ * This indicates that required processing failed in the mcpd pipeline.
+ * The error occurs when a required plugin (such as authentication, validation,
+ * audit logging, monitoring, or response transformation) fails during request
+ * or response processing.
+ *
+ * Pipeline Flow Distinction:
+ * - **response-pipeline-failure**: The upstream request was processed (the tool
+ *   was called), but results cannot be returned due to a required response
+ *   processing step failure. Note: This does not indicate whether the tool
+ *   itself succeeded or failed - only that the response cannot be delivered.
+ *
+ * - **request-pipeline-failure**: The request was rejected before reaching the
+ *   upstream server due to a required request processing step failure (such as
+ *   authentication, authorization, validation, or rate limiting plugin failure).
+ *
+ * This typically indicates a problem with a plugin or an external system
+ * that a plugin depends on (e.g., audit service, authentication provider).
+ * Retrying is unlikely to help as this usually indicates a configuration
+ * or dependency problem rather than a transient failure.
+ *
+ * @example
+ * ```typescript
+ * import { McpdClient, PipelineError } from '@mozilla-ai/mcpd';
+ *
+ * const client = new McpdClient({ apiEndpoint: 'http://localhost:8090' });
+ *
+ * try {
+ *   const result = await client.servers.time.tools.get_current_time();
+ * } catch (error) {
+ *   if (error instanceof PipelineError) {
+ *     console.log(`Pipeline failure: ${error.message}`);
+ *     console.log(`Flow: ${error.pipelineFlow}`);
+ *
+ *     if (error.pipelineFlow === 'response') {
+ *       console.log('Tool was called but results cannot be delivered');
+ *     } else {
+ *       console.log('Request was rejected by pipeline');
+ *       console.log('Check authentication, authorization, or rate limiting');
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @remarks
+ * This exception indicates a problem with a plugin or its dependencies, not
+ * with your request or the tool itself.
+ */
+export declare class PipelineError extends McpdError {
+    readonly serverName: string | undefined;
+    readonly operation: string | undefined;
+    readonly pipelineFlow: PipelineFlow | undefined;
+    constructor(message: string, serverName?: string, operation?: string, pipelineFlow?: PipelineFlow, cause?: Error);
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3C;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAK3C;AAED;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAK3C;AAED;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,SAAgB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEnC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAMhE;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;IACjD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,YAAY,EAAE,MAAM,CAAC;gBAGnC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,KAAK;CAQhB;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,SAAgB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,SAAgB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;gBAG3C,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,KAAK;CAQhB;AAED;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,SAAgB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,SAAgB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,SAAgB,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;gBAGjD,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,UAAU,EACvB,KAAK,CAAC,EAAE,KAAK;CAShB;AAED;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,SAAgB,gBAAgB,EAAE,MAAM,EAAE,CAAC;gBAE/B,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,KAAK;CAMxE;AAED;;;;;;;GAOG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,SAAgB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,SAAgB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;gBAG1C,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,KAAK;CAQhB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAG,SAAkB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAG,UAAmB,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,OAAO,qBAAqB,GAC5B,OAAO,sBAAsB,CAAC;AAElC;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM3C;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAK3C;AAED;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAK3C;AAED;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,SAAgB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEnC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAMhE;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;IACjD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,YAAY,EAAE,MAAM,CAAC;gBAGnC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,KAAK;CAQhB;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,SAAgB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,SAAgB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;gBAG3C,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,KAAK;CAQhB;AAED;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,SAAgB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,SAAgB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,SAAgB,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;gBAGjD,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,UAAU,EACvB,KAAK,CAAC,EAAE,KAAK;CAShB;AAED;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,SAAgB,gBAAgB,EAAE,MAAM,EAAE,CAAC;gBAE/B,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,KAAK;CAMxE;AAED;;;;;;;GAOG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,SAAgB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,SAAgB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;gBAG1C,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,KAAK;CAQhB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,qBAAa,aAAc,SAAQ,SAAS;IAC1C,SAAgB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,SAAgB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,SAAgB,YAAY,EAAE,YAAY,GAAG,SAAS,CAAC;gBAGrD,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,YAAY,EAC3B,KAAK,CAAC,EAAE,KAAK;CAShB"}

package/dist/functionBuilder.d.ts

@@ -106,5 +106,11 @@ export declare class FunctionBuilder {
      * @returns The number of functions currently cached
      */
     getCacheSize(): number;
+    /**
+     * Get all cached functions.
+     *
+     * @returns Array of all cached agent functions, or empty array if cache is empty
+     */
+    getCachedFunctions(): AgentFunction[];
 }
 //# sourceMappingURL=functionBuilder.d.ts.map

package/dist/functionBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"functionBuilder.d.ts","sourceRoot":"","sources":["../src/functionBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGnD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAGvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IAIpB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IAItB,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAG7C,OAAO,EAAE,IAAI,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAe;;IAI1B;;;;OAIG;gBACS,WAAW,EAAE,aAAa;IA2EtC;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ;IAKhB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;;;;;;;;;;OAaG;IACH,wBAAwB,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa;IAoBzE;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAoIrB;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;IAoCvB;;;;;OAKG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;OAIG;IACH,YAAY,IAAI,MAAM;CAGvB"}
+{"version":3,"file":"functionBuilder.d.ts","sourceRoot":"","sources":["../src/functionBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGnD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAGvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IAIpB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IAItB,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAG7C,OAAO,EAAE,IAAI,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAe;;IAI1B;;;;OAIG;gBACS,WAAW,EAAE,aAAa;IA2EtC;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ;IAKhB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;;;;;;;;;;OAaG;IACH,wBAAwB,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa;IAoBzE;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAoIrB;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;IAoCvB;;;;;OAKG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;OAIG;IACH,YAAY,IAAI,MAAM;IAItB;;;;OAIG;IACH,kBAAkB,IAAI,aAAa,EAAE;CAGtC"}

package/dist/index.d.ts

@@ -15,6 +15,6 @@
  * @packageDocumentation
  */
 export { McpdClient } from './client';
-export { McpdError, AuthenticationError, ConnectionError, ServerNotFoundError, ServerUnhealthyError, TimeoutError, ToolExecutionError, ToolNotFoundError, ValidationError, } from './errors';
-export { HealthStatus, HealthStatusHelpers, type JsonSchema, type Tool, type Tools, type ToolAnnotations, type ServerHealth, type ToolsResponse, type HealthResponse, type McpdClientOptions, type ErrorDetail, type ErrorModel, type ToolFormat, type AgentToolsOptions, type Resource, type Resources, type ResourceContent, type ResourceTemplate, type ResourceTemplates, type Prompt, type PromptArgument, type Prompts, type PromptMessage, type PromptGenerateArguments, type GeneratePromptResponseBody, } from './types';
+export { McpdError, AuthenticationError, ConnectionError, PipelineError, PIPELINE_FLOW_REQUEST, PIPELINE_FLOW_RESPONSE, ServerNotFoundError, ServerUnhealthyError, TimeoutError, ToolExecutionError, ToolNotFoundError, ValidationError, type PipelineFlow, } from './errors';
+export { HealthStatus, HealthStatusHelpers, type JsonSchema, type Tool, type Tools, type ToolAnnotations, type ServerHealth, type ToolsResponse, type HealthResponse, type McpdClientOptions, type ErrorDetail, type ErrorModel, type AgentToolsFormat, type BaseAgentToolsOptions, type ArrayAgentToolsOptions, type ObjectAgentToolsOptions, type MapAgentToolsOptions, type AgentToolsOptions, type Resource, type Resources, type ResourceContent, type ResourceTemplate, type ResourceTemplates, type Prompt, type PromptArgument, type Prompts, type PromptMessage, type PromptGenerateArguments, type GeneratePromptResponseBody, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GAChB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,KAAK,UAAU,EACf,KAAK,IAAI,EACT,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,GAChC,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,KAAK,YAAY,GAClB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,KAAK,UAAU,EACf,KAAK,IAAI,EACT,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,GAChC,MAAM,SAAS,CAAC"}