@arvo-tools/agentic 0.4.1 → 1.0.1

package/dist/Agent/utils.js

@@ -88,6 +88,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.prioritizeToolCalls = exports.tryParseJson = exports.setOpenInferenceResponseOutputAttr = exports.setOpenInferenceUsageOutputAttr = exports.setOpenInferenceToolCallOutputAttr = exports.setOpenInferenceInputAttr = exports.clampStr = exports.generateAgentInternalToolDefinitions = exports.generateMcpToolDefinitions = exports.generateServiceToolDefinitions = void 0;
 var openinference_semantic_conventions_1 = require("@arizeai/openinference-semantic-conventions");
 var zod_to_json_schema_1 = require("zod-to-json-schema");
+/**
+ * Transforms a map of Arvo Service Contracts into LLM-compatible Tool Definitions.
+ *
+ * This function extracts the `accepts` schema from the contract, strips out internal
+ * Arvo fields (like `parentSubject$$`), and formats it for the LLM's context window.
+ */
 var generateServiceToolDefinitions = function (services) {
     var e_1, _a;
     var _b, _c, _d;
@@ -124,6 +130,11 @@ var generateServiceToolDefinitions = function (services) {
     return serviceTools;
 };
 exports.generateServiceToolDefinitions = generateServiceToolDefinitions;
+/**
+ * Fetches available tools from a connected MCP Client and adapts them to the Agent's internal format.
+ *
+ * This runs at runtime during the Agent execution loop to ensure the tool list is current.
+ */
 var generateMcpToolDefinitions = function (mcp, config) { return __awaiter(void 0, void 0, void 0, function () {
     var mcpToolList, mcpToolPriorityMap;
     var _a, _b;
@@ -156,6 +167,10 @@ var generateMcpToolDefinitions = function (mcp, config) { return __awaiter(void
     });
 }); };
 exports.generateMcpToolDefinitions = generateMcpToolDefinitions;
+/**
+ * Converts local `AgentInternalTool` definitions (Zod schemas) into JSON Schema for the LLM.
+ * Uses `zod-to-json-schema` for the conversion.
+ */
 var generateAgentInternalToolDefinitions = function (tools) {
     var e_2, _a;
     var _b;
@@ -186,10 +201,20 @@ var generateAgentInternalToolDefinitions = function (tools) {
     return toolDef;
 };
 exports.generateAgentInternalToolDefinitions = generateAgentInternalToolDefinitions;
+/** Helper utility to truncate long strings (e.g. Base64 images) in logs/traces. */
 var clampStr = function (s, len) {
     return s.length > len ? "".concat(s.slice(0, len), "...") : s;
 };
 exports.clampStr = clampStr;
+/**
+ * Populates the OpenTelemetry Span with all LLM Input data using OpenInference Semantic Conventions.
+ *
+ * This records:
+ * 1. The LLM Config (Provider, Model, System Prompt).
+ * 2. The full Conversation History (mapped from Arvo format to OpenInference format).
+ * 3. Tool Definitions (so traces show what tools were available).
+ * 4. Multi-modal content (Image/File placeholders).
+ */
 var setOpenInferenceInputAttr = function (param, span) {
     var _a, e_3, _b, _c, e_4, _d, _e, _f, _g, _h;
     span.setAttributes((_a = {},
@@ -264,6 +289,10 @@ var setOpenInferenceInputAttr = function (param, span) {
     }
 };
 exports.setOpenInferenceInputAttr = setOpenInferenceInputAttr;
+/**
+ * Records the LLM's generated Tool Calls to the OpenTelemetry Span.
+ * Adds attributes for Function Name and JSON Arguments.
+ */
 var setOpenInferenceToolCallOutputAttr = function (param, span) {
     var _a;
     var _b;
@@ -287,6 +316,9 @@ var setOpenInferenceToolCallOutputAttr = function (param, span) {
     }
 };
 exports.setOpenInferenceToolCallOutputAttr = setOpenInferenceToolCallOutputAttr;
+/**
+ * Records Token Usage metrics (Prompt, Completion, Total) to the OpenTelemetry Span.
+ */
 var setOpenInferenceUsageOutputAttr = function (param, span) {
     var _a;
     if (param) {
@@ -298,6 +330,9 @@ var setOpenInferenceUsageOutputAttr = function (param, span) {
     }
 };
 exports.setOpenInferenceUsageOutputAttr = setOpenInferenceUsageOutputAttr;
+/**
+ * Records the LLM's final textual response to the OpenTelemetry Span.
+ */
 var setOpenInferenceResponseOutputAttr = function (param, span) {
     var _a, _b;
     span.setAttributes((_a = {},
@@ -308,6 +343,7 @@ var setOpenInferenceResponseOutputAttr = function (param, span) {
         _b));
 };
 exports.setOpenInferenceResponseOutputAttr = setOpenInferenceResponseOutputAttr;
+/** Safe wrapper around JSON.parse that returns null instead of throwing. */
 var tryParseJson = function (str) {
     try {
         return JSON.parse(str);
@@ -317,6 +353,13 @@ var tryParseJson = function (str) {
     }
 };
 exports.tryParseJson = tryParseJson;
+/**
+ * Implements the Priority-Based Execution logic.
+ *
+ * Takes a list of requested tool calls, groups them by their configured priority,
+ * and returns **only** the batch with the highest priority. All lower priority
+ * calls are discarded.
+ */
 var prioritizeToolCalls = function (toolCalls, nameToToolMap) {
     var e_5, _a;
     var _b, _c, _d, _e, _f;

package/dist/Agent/utils.js.map

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

package/dist/AgentTool/index.d.ts

@@ -0,0 +1,30 @@
+import type z from 'zod/v3/external.cjs';
+import type { AgentInternalTool } from './types';
+/**
+ * Factory function to create an Instrumented Agent Tool.
+ *
+ * Wraps your raw tool logic with **OpenTelemetry Auto-Instrumentation** and **Input Validation**.
+ *
+ * **Why use this instead of a raw object?**
+ * 1. **Observability:** Automatically creates a child Span (`OpenInferenceSpanKind.TOOL`).
+ *    It records input arguments, output values, and execution duration to your tracing backend.
+ * 2. **Safety:** Automatically validates `input` against the Zod schema *before* your function runs.
+ *    Throws a clear error if the LLM hallucinated invalid arguments.
+ * 3. **Type Safety:** Infers generic types for `input` and `output` automatically.
+ *
+ * @param param - The tool definition.
+ * @returns The wrapped, production-ready tool.
+ *
+ * @example
+ * ```ts
+ * const timeTool = createAgentTool({
+ *   name: 'get_time',
+ *   description: 'Returns current server time',
+ *   input: z.object({}),
+ *   output: z.object({ time: z.string() }),
+ *   fn: () => ({ time: new Date().toISOString() })
+ * });
+ * ```
+ */
+export declare const createAgentTool: <TInputSchema extends z.ZodTypeAny, TOutputSchema extends z.ZodTypeAny>(param: AgentInternalTool<TInputSchema, TOutputSchema>) => AgentInternalTool<TInputSchema, TOutputSchema>;
+//# sourceMappingURL=index.d.ts.map

package/dist/AgentTool/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/AgentTool/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,CAAC,MAAM,qBAAqB,CAAC;AAEzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,eAAe,GAC1B,YAAY,SAAS,CAAC,CAAC,UAAU,EACjC,aAAa,SAAS,CAAC,CAAC,UAAU,EAElC,OAAO,iBAAiB,CAAC,YAAY,EAAE,aAAa,CAAC,KAiD/C,iBAAiB,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC"}

package/dist/{Agent/agentTool.js → AgentTool/index.js}

@@ -51,6 +51,32 @@ exports.createAgentTool = void 0;
 var openinference_semantic_conventions_1 = require("@arizeai/openinference-semantic-conventions");
 var api_1 = require("@opentelemetry/api");
 var arvo_core_1 = require("arvo-core");
+/**
+ * Factory function to create an Instrumented Agent Tool.
+ *
+ * Wraps your raw tool logic with **OpenTelemetry Auto-Instrumentation** and **Input Validation**.
+ *
+ * **Why use this instead of a raw object?**
+ * 1. **Observability:** Automatically creates a child Span (`OpenInferenceSpanKind.TOOL`).
+ *    It records input arguments, output values, and execution duration to your tracing backend.
+ * 2. **Safety:** Automatically validates `input` against the Zod schema *before* your function runs.
+ *    Throws a clear error if the LLM hallucinated invalid arguments.
+ * 3. **Type Safety:** Infers generic types for `input` and `output` automatically.
+ *
+ * @param param - The tool definition.
+ * @returns The wrapped, production-ready tool.
+ *
+ * @example
+ * ```ts
+ * const timeTool = createAgentTool({
+ *   name: 'get_time',
+ *   description: 'Returns current server time',
+ *   input: z.object({}),
+ *   output: z.object({ time: z.string() }),
+ *   fn: () => ({ time: new Date().toISOString() })
+ * });
+ * ```
+ */
 var createAgentTool = function (param) {
     return (__assign(__assign({}, param), { fn: function (input, config) { return __awaiter(void 0, void 0, void 0, function () {
             var _a;
@@ -108,4 +134,4 @@ var createAgentTool = function (param) {
         }); } }));
 };
 exports.createAgentTool = createAgentTool;
-//# sourceMappingURL=agentTool.js.map
+//# sourceMappingURL=index.js.map

package/dist/AgentTool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/AgentTool/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,kGAGqD;AACrD,0CAAoD;AACpD,uCAAqE;AAKrE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACI,IAAM,eAAe,GAAG,UAI7B,KAAqD;IAErD,OAAA,uBACK,KAAK,KACR,EAAE,EAAE,UAAO,KAA4B,EAAE,MAAkC;;;;4BACzE,qBAAM,6BAAiB,CAAC,WAAW,EAAE,CAAC,eAAe,CAAC;4BACpD,IAAI,EAAE,oBAAa,KAAK,CAAC,IAAI,cAAW;4BACxC,qBAAqB,EAAE,IAAI;4BAC3B,OAAO,EAAE;gCACP,WAAW,EAAE,eAAe;gCAC5B,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;6BACtC;4BACD,WAAW,EAAE;gCACX,UAAU;oCACR,GAAC,wDAAgC,CAAC,uBAAuB,IAAG,0DAAqB,CAAC,IAAI;uCACvF;6BACF;4BACD,EAAE,EAAE,UAAO,IAAI;;;;;;4CAEX,IAAI,CAAC,YAAY,CAAC,wDAAgC,CAAC,uBAAuB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;4CACxF,IAAI,CAAC,YAAY,CACf,wDAAgC,CAAC,iCAAiC,EAClE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CACtB,CAAC;4CACF,IAAI,CAAC,YAAY,CAAC,wDAAgC,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;4CACjF,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;4CACrD,IAAI,eAAe,CAAC,KAAK;gDACvB,MAAM,IAAI,KAAK,CACb,2GAAoG,eAAe,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAE,CACvI,CAAC;4CACW,qBAAM,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE;oDAClD,QAAQ,EAAE;wDACR,IAAI,MAAA;wDACJ,OAAO,EAAE,IAAA,iCAAqB,EAAC,IAAI,CAAC;qDACrC;iDACF,CAAC,EAAA;;4CALI,MAAM,GAAG,SAKb;4CACF,IAAI,CAAC,YAAY,CACf,wDAAgC,CAAC,YAAY,EAC7C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CACvB,CAAC;4CACF,sBAAO,MAAM,EAAC;;;4CAEd,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,oBAAc,CAAC,KAAK,EAAE,OAAO,EAAG,KAAa,aAAb,KAAG,uBAAH,KAAG,CAAY,OAAO,EAAE,CAAC,CAAC;4CACjF,MAAM,KAAG,CAAC;;4CAEV,IAAI,CAAC,GAAG,EAAE,CAAC;;;;;iCAEd;yBACF,CAAC,EAAA;4BA3CF,sBAAA,SA2CE,EAAA;;;aAAA,IAC8C;AA/CpD,CA+CoD,CAAC;AArD1C,QAAA,eAAe,mBAqD2B"}

package/dist/AgentTool/types.d.ts

@@ -0,0 +1,59 @@
+import type z from 'zod';
+import type { OtelInfoType, PromiseAble } from '../types';
+/**
+ * Defines the structure of a **Synchronous Internal Tool**.
+ *
+ * Internal tools are JavaScript/TypeScript functions that execute *inside* the Agent's loop.
+ *
+ * @remarks
+ * **Architectural Note:**
+ * Unlike Arvo Services (which trigger a "Suspend & Emit" lifecycle), Internal Tools are atomic.
+ * The Agent calls them, awaits the result, and continues reasoning in the same execution tick.
+ *
+ * **Best Practices:**
+ * - Use for **Fast, CPU-bound** logic (Math, Data Transformation, Regex).
+ * - Use for **Read-only** operations that don't require distributed consensus.
+ * - Do **not** use for long-running tasks, as this blocks the Agent execution.
+ */
+export type AgentInternalTool<TInputSchema extends z.ZodTypeAny = any, TOutputSchema extends z.ZodTypeAny = any> = {
+    /**
+     * The unique identifier for this tool (e.g. `calculator`, `get_current_time`).
+     * This name is injected into the LLM's system prompt.
+     */
+    name: string;
+    /**
+     * This string is critical. It tells the LLM *when* and *why* to use this tool.
+     * @example
+     * "Calculate the MD5 hash of a string. Use this whenever the user asks for a checksum."
+     */
+    description: string;
+    /**
+     * Zod Schema defining the arguments the LLM must provide.
+     * Arvo automatically validates the LLM's JSON output against this schema before calling `fn`.
+     */
+    input: TInputSchema;
+    /**
+     * Zod Schema defining what this tool returns.
+     * Used for type inference and documentation, though runtime validation of the result is optional.
+     */
+    output: TOutputSchema;
+    /**
+     * If the LLM attempts to call multiple tools in parallel (e.g. `delete_user` + `human_approval`),
+     * Arvo sorts calls by priority and **only executes the highest priority batch**.
+     * Lower priority calls are silently dropped to enforce safety/auth guardrails.
+     *
+     * @defaultValue 0
+     */
+    priority?: number;
+    /**
+     * The implementation logic.
+     *
+     * @param input - The validated arguments matching `TInputSchema`. You do not need to re-validate.
+     * @param config - Observability context (Span/Headers) to link any internal logging or network calls.
+     * @returns The result matching `TOutputSchema`.
+     */
+    fn: (input: z.infer<TInputSchema>, config: {
+        otelInfo: OtelInfoType;
+    }) => PromiseAble<z.infer<TOutputSchema>>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/AgentTool/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/AgentTool/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE1D;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,iBAAiB,CAE3B,YAAY,SAAS,CAAC,CAAC,UAAU,GAAG,GAAG,EAEvC,aAAa,SAAS,CAAC,CAAC,UAAU,GAAG,GAAG,IACtC;IACF;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,KAAK,EAAE,YAAY,CAAC;IAEpB;;;OAGG;IACH,MAAM,EAAE,aAAa,CAAC;IAEtB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,EAAE,EAAE,CACF,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAC5B,MAAM,EAAE;QAAE,QAAQ,EAAE,YAAY,CAAA;KAAE,KAC/B,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;CAC1C,CAAC"}

package/dist/AgentTool/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/AgentTool/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/AgentTool/types.ts"],"names":[],"mappings":""}

package/dist/Integrations/MCPClient.d.ts

@@ -1,12 +1,32 @@
 import type { IMCPClient } from '../interfaces.mcp.js';
 import type { OtelInfoType } from '../types.js';
 /**
- * Model Context Protocol (MCP) client implementation for connecting to and interacting with MCP servers.
+ * A Production-grade Client for the Model Context Protocol (MCP).
  *
- * This client provides a robust interface for establishing connections to MCP servers,
- * discovering available tools, invoking those tools with arguments, and managing the
- * connection lifecycle. It supports both Server-Sent Events (SSE) and streamable HTTP
- * transport protocols, automatically selecting the appropriate transport based on the URL.
+ * This class bridges Arvo Agents with the external MCP ecosystem, allowing agents to
+ * interact with filesystem, databases, GitHub, Slack, and other standardized MCP servers.
+ *
+ * @remarks
+ * **Key Features:**
+ * - **Auto-Transport Selection:** Automatically chooses between `SSEClientTransport` and
+ *   `StreamableHTTPClientTransport` based on the URL pattern (checks for `/mcp` suffix).
+ * - **Orchestration Control:** Supports mapping priorities to external tools, allowing
+ *   MCP tools to participate in Arvo's **Priority Batch Execution** logic.
+ * - **Observability:** Deep integration with Arvo's OpenTelemetry system to trace
+ *   connection status and tool execution metrics.
+ * - **Tool Caching:** Discovers and caches tool definitions upon connection to minimize latency
+ *   during the Agent's reasoning loop.
+ *
+ * @example
+ * ```ts
+ * const mcp = new MCPClient({
+ *   url: 'http://localhost:8080/sse',
+ *   // Give the 'delete_file' tool high priority so it executes before other tools
+ *   toolPriority: {
+ *     'delete_file': 100
+ *   }
+ * });
+ * ```
  */
 export declare class MCPClient implements IMCPClient {
     private client;
@@ -14,35 +34,45 @@ export declare class MCPClient implements IMCPClient {
     private availableTools;
     private readonly url;
     private readonly requestInit;
+    private readonly toolPriority;
+    /**
+     * Creates a new MCP Client.
+     *
+     * @param param - Configuration object or a Lazy Configuration function.
+     *
+     * **Why use a function?**
+     * Using a function is recommended if the URL, Auth Headers, or Tool Priorities
+     * need to be resolved at **Runtime** (e.g., fetched from a Secrets Manager or Env Var)
+     * rather than at **Instantiation time**.
+     */
     constructor(param: {
         url: string;
+        toolPriority?: Record<string, number>;
         requestInit?: RequestInit;
     } | (() => {
         url: string;
+        toolPriority?: Record<string, number>;
         requestInit?: RequestInit;
     }));
     /**
-     * Establishes a connection to the MCP server and discovers available tools.
+     * Initializes the connection to the remote MCP Server.
      *
-     * This method performs the following operations:
-     * 1. Selects the appropriate transport (SSE or HTTP streaming) based on URL
-     * 2. Creates and configures the MCP client with capabilities
-     * 3. Establishes the connection to the server
-     * 4. Retrieves and caches the list of available tools
-     * 5. Logs all operations to the provided OpenTelemetry span
+     * This lifecycle method:
+     * 1. Resolves the Transport (SSE vs HTTP).
+     * 2. Performs the protocol handshake.
+     * 3. Fetches the list of available tools immediately (to populate the Agent's context).
      *
-     * @returns Promise that resolves when connection is established and tools are discovered
-     * @throws {Error} Throws an error if connection fails, with details logged to the span
+     * @param config - Trace context.
+     * @throws Error if the connection fails or handshake is rejected.
      */
     connect(config: {
         otelInfo: OtelInfoType;
     }): Promise<void>;
     /**
-     * Retrieves the list of available tool definitions from the connected MCP server.
+     * Returns the Tool Definitions discovered during the `connect()` phase.
      *
-     * Transforms the cached MCP tools into the AgentToolDefinition format required
-     * by the agent system. Tools listed in restrictedTools will have requires_approval set to true.
-     * This method returns an empty array if not connected.
+     * This maps the raw MCP Tool format into Arvo's `AgentToolDefinition` structure
+     * so they can be injected into the LLM's context window.
      */
     getTools(config: {
         otelInfo: OtelInfoType;
@@ -52,12 +82,13 @@ export declare class MCPClient implements IMCPClient {
         inputSchema: Record<string, any>;
     }[]>;
     /**
-     * Invokes a specific tool on the MCP server with the provided arguments.
+     * Executes a tool on the remote MCP Server.
      *
-     * This method sends a tool invocation request to the connected MCP server and
-     * returns the result. All operations are logged to the OpenTelemetry span for
-     * observability. If an error occurs during invocation, it returns an error message
-     * rather than throwing, allowing the agent to handle tool failures gracefully.
+     * Wraps the execution in a dedicated OpenTelemetry Child Span (`MCP.invoke<tool_name>`)
+     * to track latency and success/failure rates of the external system.
+     *
+     * @param param - The tool name and argument payload generated by the LLM.
+     * @returns The simplified JSON string result to be fed back to the LLM.
      */
     invokeTool(param: {
         name: string;
@@ -66,15 +97,17 @@ export declare class MCPClient implements IMCPClient {
         otelInfo: OtelInfoType;
     }): Promise<string>;
     /**
-     * Gracefully disconnects from the MCP server and cleans up resources.
-     *
-     * This method safely closes the connection to the MCP server if one exists,
-     * resets the connection state, and clears cached data. It's safe to call
-     * multiple times - subsequent calls will be no-ops if already disconnected.
+     * Terminates the transport session and resets clients state.
+     * Safe to call multiple times (idempotent).
      */
     disconnect(config: {
         otelInfo: OtelInfoType;
     }): Promise<void>;
-    getToolPriority(): Promise<{}>;
+    /**
+     * Retrieves the priority configuration for MCP Tools.
+     *
+     * This allows external MCP tools to explicitly participate in Arvo's **Priority Batch Execution**.
+     */
+    getToolPriority(): Promise<Record<string, number>>;
 }
 //# sourceMappingURL=MCPClient.d.ts.map

package/dist/Integrations/MCPClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MCPClient.d.ts","sourceRoot":"","sources":["../../src/Integrations/MCPClient.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;GAOG;AACH,qBAAa,SAAU,YAAW,UAAU;IAC1C,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;gBAG9C,KAAK,EACD;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE,GAC1C,CAAC,MAAM;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE,CAAC;IASxD;;;;;;;;;;;;OAYG;IACG,OAAO,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,YAAY,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4ChE;;;;;;OAMG;IACG,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,YAAY,CAAA;KAAE,GAAG,OAAO,CACzD;QACE,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QAEpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAClC,EAAE,CACJ;IAsCD;;;;;;;OAOG;IACG,UAAU,CACd,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;KAAE,EACnE,MAAM,EAAE;QAAE,QAAQ,EAAE,YAAY,CAAA;KAAE,GACjC,OAAO,CAAC,MAAM,CAAC;IA6DlB;;;;;;OAMG;IACG,UAAU,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,YAAY,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB7D,eAAe;CAGtB"}
+{"version":3,"file":"MCPClient.d.ts","sourceRoot":"","sources":["../../src/Integrations/MCPClient.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,SAAU,YAAW,UAAU;IAC1C,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAE5D;;;;;;;;;OASG;gBAED,KAAK,EACD;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE,GACjF,CAAC,MAAM;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE,CAAC;IAU/F;;;;;;;;;;OAUG;IACG,OAAO,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,YAAY,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4ChE;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,YAAY,CAAA;KAAE,GAAG,OAAO,CACzD;QACE,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QAEpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAClC,EAAE,CACJ;IAsCD;;;;;;;;OAQG;IACG,UAAU,CACd,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;KAAE,EACnE,MAAM,EAAE;QAAE,QAAQ,EAAE,YAAY,CAAA;KAAE,GACjC,OAAO,CAAC,MAAM,CAAC;IA6DlB;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,YAAY,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBnE;;;;OAIG;IACG,eAAe;CAGtB"}

package/dist/Integrations/MCPClient.js

@@ -54,33 +54,62 @@ var streamableHttp_js_1 = require("@modelcontextprotocol/sdk/client/streamableHt
 var api_1 = require("@opentelemetry/api");
 var arvo_core_1 = require("arvo-core");
 /**
- * Model Context Protocol (MCP) client implementation for connecting to and interacting with MCP servers.
+ * A Production-grade Client for the Model Context Protocol (MCP).
  *
- * This client provides a robust interface for establishing connections to MCP servers,
- * discovering available tools, invoking those tools with arguments, and managing the
- * connection lifecycle. It supports both Server-Sent Events (SSE) and streamable HTTP
- * transport protocols, automatically selecting the appropriate transport based on the URL.
+ * This class bridges Arvo Agents with the external MCP ecosystem, allowing agents to
+ * interact with filesystem, databases, GitHub, Slack, and other standardized MCP servers.
+ *
+ * @remarks
+ * **Key Features:**
+ * - **Auto-Transport Selection:** Automatically chooses between `SSEClientTransport` and
+ *   `StreamableHTTPClientTransport` based on the URL pattern (checks for `/mcp` suffix).
+ * - **Orchestration Control:** Supports mapping priorities to external tools, allowing
+ *   MCP tools to participate in Arvo's **Priority Batch Execution** logic.
+ * - **Observability:** Deep integration with Arvo's OpenTelemetry system to trace
+ *   connection status and tool execution metrics.
+ * - **Tool Caching:** Discovers and caches tool definitions upon connection to minimize latency
+ *   during the Agent's reasoning loop.
+ *
+ * @example
+ * ```ts
+ * const mcp = new MCPClient({
+ *   url: 'http://localhost:8080/sse',
+ *   // Give the 'delete_file' tool high priority so it executes before other tools
+ *   toolPriority: {
+ *     'delete_file': 100
+ *   }
+ * });
+ * ```
  */
 var MCPClient = /** @class */ (function () {
+    /**
+     * Creates a new MCP Client.
+     *
+     * @param param - Configuration object or a Lazy Configuration function.
+     *
+     * **Why use a function?**
+     * Using a function is recommended if the URL, Auth Headers, or Tool Priorities
+     * need to be resolved at **Runtime** (e.g., fetched from a Secrets Manager or Env Var)
+     * rather than at **Instantiation time**.
+     */
     function MCPClient(param) {
         this.client = null;
         this.isConnected = false;
         this.availableTools = [];
         this.url = function () { return (typeof param === 'function' ? param() : param).url; };
         this.requestInit = function () { var _a; return (_a = (typeof param === 'function' ? param() : param).requestInit) !== null && _a !== void 0 ? _a : {}; };
+        this.toolPriority = function () { var _a; return (_a = (typeof param === 'function' ? param() : param).toolPriority) !== null && _a !== void 0 ? _a : {}; };
     }
     /**
-     * Establishes a connection to the MCP server and discovers available tools.
+     * Initializes the connection to the remote MCP Server.
      *
-     * This method performs the following operations:
-     * 1. Selects the appropriate transport (SSE or HTTP streaming) based on URL
-     * 2. Creates and configures the MCP client with capabilities
-     * 3. Establishes the connection to the server
-     * 4. Retrieves and caches the list of available tools
-     * 5. Logs all operations to the provided OpenTelemetry span
+     * This lifecycle method:
+     * 1. Resolves the Transport (SSE vs HTTP).
+     * 2. Performs the protocol handshake.
+     * 3. Fetches the list of available tools immediately (to populate the Agent's context).
      *
-     * @returns Promise that resolves when connection is established and tools are discovered
-     * @throws {Error} Throws an error if connection fails, with details logged to the span
+     * @param config - Trace context.
+     * @throws Error if the connection fails or handshake is rejected.
      */
     MCPClient.prototype.connect = function (config) {
         return __awaiter(this, void 0, void 0, function () {
@@ -127,11 +156,10 @@ var MCPClient = /** @class */ (function () {
         });
     };
     /**
-     * Retrieves the list of available tool definitions from the connected MCP server.
+     * Returns the Tool Definitions discovered during the `connect()` phase.
      *
-     * Transforms the cached MCP tools into the AgentToolDefinition format required
-     * by the agent system. Tools listed in restrictedTools will have requires_approval set to true.
-     * This method returns an empty array if not connected.
+     * This maps the raw MCP Tool format into Arvo's `AgentToolDefinition` structure
+     * so they can be injected into the LLM's context window.
      */
     MCPClient.prototype.getTools = function (config) {
         return __awaiter(this, void 0, void 0, function () {
@@ -173,12 +201,13 @@ var MCPClient = /** @class */ (function () {
         });
     };
     /**
-     * Invokes a specific tool on the MCP server with the provided arguments.
+     * Executes a tool on the remote MCP Server.
      *
-     * This method sends a tool invocation request to the connected MCP server and
-     * returns the result. All operations are logged to the OpenTelemetry span for
-     * observability. If an error occurs during invocation, it returns an error message
-     * rather than throwing, allowing the agent to handle tool failures gracefully.
+     * Wraps the execution in a dedicated OpenTelemetry Child Span (`MCP.invoke<tool_name>`)
+     * to track latency and success/failure rates of the external system.
+     *
+     * @param param - The tool name and argument payload generated by the LLM.
+     * @returns The simplified JSON string result to be fed back to the LLM.
      */
     MCPClient.prototype.invokeTool = function (param, config) {
         return __awaiter(this, void 0, void 0, function () {
@@ -245,11 +274,8 @@ var MCPClient = /** @class */ (function () {
         });
     };
     /**
-     * Gracefully disconnects from the MCP server and cleans up resources.
-     *
-     * This method safely closes the connection to the MCP server if one exists,
-     * resets the connection state, and clears cached data. It's safe to call
-     * multiple times - subsequent calls will be no-ops if already disconnected.
+     * Terminates the transport session and resets clients state.
+     * Safe to call multiple times (idempotent).
      */
     MCPClient.prototype.disconnect = function (config) {
         return __awaiter(this, void 0, void 0, function () {
@@ -279,10 +305,15 @@ var MCPClient = /** @class */ (function () {
             });
         });
     };
+    /**
+     * Retrieves the priority configuration for MCP Tools.
+     *
+     * This allows external MCP tools to explicitly participate in Arvo's **Priority Batch Execution**.
+     */
     MCPClient.prototype.getToolPriority = function () {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
-                return [2 /*return*/, {}];
+                return [2 /*return*/, this.toolPriority()];
             });
         });
     };

package/dist/Integrations/MCPClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"MCPClient.js","sourceRoot":"","sources":["../../src/Integrations/MCPClient.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,sEAAmE;AACnE,kEAA6E;AAC7E,wFAAmG;AAEnG,0CAAoD;AACpD,uCAMmB;AAInB;;;;;;;GAOG;AACH;IAOE,mBACE,KAEsD;QAEtD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,GAAG,cAAM,OAAA,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAnD,CAAmD,CAAC;QACrE,IAAI,CAAC,WAAW,GAAG,sBAAM,OAAA,MAAA,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,mCAAI,EAAE,CAAA,EAAA,CAAC;IAC7F,CAAC;IAED;;;;;;;;;;;;OAYG;IACG,2BAAO,GAAb,UAAc,MAAkC;;;;;;;wBAEtC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;wBACjB,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;wBACjC,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;4BACpC,CAAC,CAAC,IAAI,iDAA6B,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,aAAA,EAAE,CAAC;4BAClE,CAAC,CAAC,IAAI,2BAAkB,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,aAAA,EAAE,CAAC,CAAC;wBAE1D,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAM,CAAC;4BACvB,IAAI,EAAE,+BAA+B;4BACrC,OAAO,EAAE,OAAO;yBACjB,CAAC,CAAC;wBAEH,qBAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAA;;wBAApC,SAAoC,CAAC;wBAErC,IAAA,qBAAS,EACP;4BACE,KAAK,EAAE,MAAM;4BACb,OAAO,EAAE,kCAA2B,GAAG,CAAE;yBAC1C,EACD,MAAM,CAAC,QAAQ,CAAC,IAAI,CACrB,CAAC;wBAE6B,qBAAM,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAA;;wBAAtD,KAAK,GAAoB,SAA6B;wBAC5D,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC;wBAClC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;wBAExB,IAAA,qBAAS,EACP;4BACE,KAAK,EAAE,MAAM;4BACb,OAAO,EAAE,sBAAsB;4BAC/B,KAAK,EAAE,IAAI,CAAC,SAAS,CACnB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,UAAC,CAAO,IAAK,OAAA,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,EAA9C,CAA8C,CAAC,CACrF;yBACF,EACD,MAAM,CAAC,QAAQ,CAAC,IAAI,CACrB,CAAC;;;;wBAEF,IAAA,2BAAe,EAAC,OAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;wBACtD,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;wBACzB,MAAM,IAAI,KAAK,CAAC,8CAAuC,IAAI,CAAC,GAAG,EAAE,CAAE,CAAC,CAAC;;;;;KAExE;IAED;;;;;;OAMG;IACG,4BAAQ,GAAd,UAAe,MAAkC;;;;;;gBAQzC,OAAO,GAKP,EAAE,CAAC;gBAET,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;oBACtB,IAAA,qBAAS,EACP;wBACE,KAAK,EAAE,SAAS;wBAChB,OAAO,EAAE,yDAAkD,IAAI,CAAC,GAAG,EAAE,CAAE;qBACxE,EACD,MAAM,CAAC,QAAQ,CAAC,IAAI,CACrB,CAAC;oBACF,sBAAO,OAAO,EAAC;gBACjB,CAAC;;oBAED,KAAmB,KAAA,SAAA,IAAI,CAAC,cAAc,CAAA,4CAAE,CAAC;wBAA9B,IAAI;wBACb,OAAO,CAAC,IAAI,CAAC;4BACX,IAAI,EAAE,IAAI,CAAC,IAAI;4BACf,WAAW,EAAE,MAAA,IAAI,CAAC,WAAW,mCAAI,EAAE;4BACnC,WAAW,EAAE,IAAI,CAAC,WAAW;yBAC9B,CAAC,CAAC;oBACL,CAAC;;;;;;;;;gBAED,IAAA,qBAAS,EACP;oBACE,KAAK,EAAE,MAAM;oBACb,OAAO,EAAE,oBAAa,OAAO,CAAC,MAAM,+CAAqC,IAAI,CAAC,GAAG,EAAE,CAAE;iBACtF,EACD,MAAM,CAAC,QAAQ,CAAC,IAAI,CACrB,CAAC;gBAEF,sBAAO,OAAO,EAAC;;;KAChB;IAED;;;;;;;OAOG;IACG,8BAAU,GAAhB,UACE,KAAmE,EACnE,MAAkC;;;;;4BAE3B,qBAAM,6BAAiB,CAAC,WAAW,EAAE,CAAC,eAAe,CAAC;4BAC3D,IAAI,EAAE,qBAAc,KAAK,CAAC,IAAI,MAAG;4BACjC,qBAAqB,EAAE,IAAI;4BAC3B,OAAO,EAAE;gCACP,WAAW,EAAE,eAAe;gCAC5B,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;6BACtC;4BACD,EAAE,EAAE,UAAO,IAAI;;;;;;;4CAEX,IAAI,CAAC,YAAY,CAAC,yBAAa,CAAC,cAAc,EAAE,iCAAqB,CAAC,IAAI,CAAC,CAAC;4CAC5E,IAAI,CAAC,SAAS,CAAC;gDACb,IAAI,EAAE,oBAAc,CAAC,EAAE;6CACxB,CAAC,CAAC;4CAEH,IAAA,qBAAS,EACP;gDACE,KAAK,EAAE,MAAM;gDACb,OAAO,EAAE,wBAAiB,KAAK,CAAC,IAAI,4CAAkC,IAAI,CAAC,GAAG,EAAE,CAAE;gDAClF,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;6CAC7B,EACD,IAAI,CACL,CAAC;4CAEF,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gDACtC,MAAM,IAAI,KAAK,CAAC,qBAAc,IAAI,CAAC,GAAG,EAAE,mBAAgB,CAAC,CAAC;4CAC5D,CAAC;4CAEc,qBAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;oDACxC,IAAI,EAAE,KAAK,CAAC,IAAI;oDAChB,SAAS,EAAE,MAAA,KAAK,CAAC,SAAS,mCAAI,SAAS;iDACxC,CAAC,EAAA;;4CAHI,MAAM,GAAG,SAGb;4CAEF,IAAA,qBAAS,EACP;gDACE,KAAK,EAAE,MAAM;gDACb,OAAO,EAAE,oCAA6B,KAAK,CAAC,IAAI,6BAAmB,IAAI,CAAC,GAAG,EAAE,CAAE;6CAChF,EACD,IAAI,CACL,CAAC;4CAEF,sBAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAC;;;4CAExB,GAAG,GAAG,IAAI,KAAK,CACnB,kDAA2C,KAAK,CAAC,IAAI,cAAI,IAAI,CAAC,GAAG,EAAE,kBAAQ,MAAC,OAAe,aAAf,OAAK,uBAAL,OAAK,CAAY,OAAO,mCAAI,sBAAsB,CAAE,CACjI,CAAC;4CAEF,IAAA,2BAAe,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;4CAC3B,IAAI,CAAC,SAAS,CAAC;gDACb,IAAI,EAAE,oBAAc,CAAC,KAAK;gDAC1B,OAAO,EAAE,GAAG,CAAC,OAAO;6CACrB,CAAC,CAAC;4CAEH,sBAAO,GAAG,CAAC,OAAO,EAAC;;4CAEnB,IAAI,CAAC,GAAG,EAAE,CAAC;;;;;iCAEd;yBACF,CAAC,EAAA;4BAzDF,sBAAO,SAyDL,EAAC;;;;KACJ;IAED;;;;;;OAMG;IACG,8BAAU,GAAhB,UAAiB,MAAkC;;;;;6BAC7C,CAAA,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,WAAW,CAAA,EAA/B,wBAA+B;wBACjC,qBAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAA;;wBAAzB,SAAyB,CAAC;wBAC1B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;wBACzB,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;wBACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;wBAEnB,IAAA,qBAAS,EACP;4BACE,KAAK,EAAE,MAAM;4BACb,OAAO,EAAE,uCAAgC,IAAI,CAAC,GAAG,EAAE,CAAE;yBACtD,EACD,MAAM,CAAC,QAAQ,CAAC,IAAI,CACrB,CAAC;;;wBAEF,IAAA,qBAAS,EACP;4BACE,KAAK,EAAE,MAAM;4BACb,OAAO,EAAE,qBAAc,IAAI,CAAC,GAAG,EAAE,0BAAuB;yBACzD,EACD,MAAM,CAAC,QAAQ,CAAC,IAAI,CACrB,CAAC;;;;;;KAEL;IACK,mCAAe,GAArB;;;gBACE,sBAAO,EAAE,EAAC;;;KACX;IACH,gBAAC;AAAD,CAAC,AA1OD,IA0OC;AA1OY,8BAAS"}
+{"version":3,"file":"MCPClient.js","sourceRoot":"","sources":["../../src/Integrations/MCPClient.ts"],"names":[],"mappings":"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"}