@arvo-tools/agentic 1.0.0 → 1.1.0

package/dist/Agent/types.d.ts

@@ -7,6 +7,7 @@ import type { AgentLLMIntegration, AgentLLMIntegrationOutput, AgentLLMIntegratio
 import type { IMCPClient } from '../interfaces.mcp';
 import type { NonEmptyArray, PromiseAble } from '../types';
 import type { AgentMediaContentSchema, AgentMessageContentSchema, AgentMessageSchema, AgentTextContentSchema, AgentToolCallContentSchema, AgentToolResultContentSchema } from './schema';
+import type { AgentStreamListener } from './stream/types';
 /** Represents a pure text block in the conversation history. */
 export type AgentTextContent = z.infer<typeof AgentTextContentSchema>;
 /** Represents media (images/files) passed to the Agent, usually for multimodal models. */
@@ -181,6 +182,8 @@ export type AgentContextBuilder<T extends AnyArvoOrchestratorContract = AnyArvoO
     lifecycle: AgentLLMIntegrationParam['lifecycle'];
     /** The fully typed input event data for this specific contract version. */
     input: InferVersionedArvoContract<VersionedArvoContract<T, V>>['accepts'];
+    /** The agent's self contract reference */
+    selfContract: VersionedArvoContract<T, V>;
     /** Catalog of available tools for dynamic prompt injection. */
     tools: AgentLLMContext<TServiceContract, TTools>['tools'];
     /** The Otel span to add logs to */
@@ -260,17 +263,19 @@ export type CreateArvoAgentParam<TSelfContract extends AnyArvoOrchestratorContra
      */
     tools?: TTools;
     /**
-     * Forces the Agent to generate a specific output structure.
+     * The default mechanism to force the Agent to generate a specific output structure.
      * - `'text'`: Standard conversational response.
      * - `'json'`: Structured Output / JSON Mode (validated against the contract's output schema).
      * @defaultValue 'text'
      */
     llmResponseType?: AgentLLMIntegrationParam['outputFormat']['type'];
     /**
-     * The integration function that connects this generic loop to a specific provider
+     * The default llm integrations function which connect this agent to the intelligence layer
      * (e.g., `openaiLLMIntegration`, `anthropicLLMIntegration`).
      */
     llm: AgentLLMIntegration;
+    /** A agent stream listener hook */
+    onStream?: AgentStreamListener;
     /**
      * Arvo enforces strict version compliance. You must provide specific logic
      * (System Prompt Building & Output Mapping) for **every semantic version**
@@ -281,6 +286,14 @@ export type CreateArvoAgentParam<TSelfContract extends AnyArvoOrchestratorContra
      */
     handler: {
         [K in keyof TSelfContract['versions'] & ArvoSemanticVersion]: {
+            /**
+             * An optional override to forces the Agent to generate a specific output structure.
+             * - `'text'`: Standard conversational response.
+             * - `'json'`: Structured Output / JSON Mode (validated against the contract's output schema).
+             */
+            llmResponseType?: AgentLLMIntegrationParam['outputFormat']['type'];
+            /** An optional override llm integration specific to this version. This allows to completely version an agent */
+            llm?: AgentLLMIntegration;
             /** Generates the System Prompt and initial conversation context for this version. */
             context: AgentContextBuilder<TSelfContract, K, TServiceContract, TTools>;
             /** Maps the LLM's final response to the strict output contract for this version. */

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

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

package/dist/AgentTool/index.d.ts

@@ -1,4 +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

@@ -1 +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,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"}
+{"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/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;

package/dist/AgentTool/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/AgentTool/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,kGAGqD;AACrD,0CAAoD;AACpD,uCAAqE;AAK9D,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"}
+{"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

@@ -1,19 +1,57 @@
 import type z from 'zod';
 import type { OtelInfoType, PromiseAble } from '../types';
 /**
- * Defines a Synchronous Internal Tool.
+ * Defines the structure of a **Synchronous Internal Tool**.
  *
- * Internal tools are standard JavaScript functions that run within the Agent's process.
- * Unlike Services, the Agent **does not suspend** when calling these. They are awaited immediately.
+ * Internal tools are JavaScript/TypeScript functions that execute *inside* the Agent's loop.
  *
- * Use cases: Mathematical calculations, Date/Time checks, Regex validation, lightweight logic.
+ * @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>>;

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

@@ -1 +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;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,CAE3B,YAAY,SAAS,CAAC,CAAC,UAAU,GAAG,GAAG,EAEvC,aAAa,SAAS,CAAC,CAAC,UAAU,GAAG,GAAG,IACtC;IACF,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,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"}
+{"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/Integrations/anthropic/index.d.ts

@@ -0,0 +1,24 @@
+import type Anthropic from '@anthropic-ai/sdk';
+import type { AgentLLMIntegration } from '../types';
+import type { AnthropicLlmIntegrationConfig } from './types';
+/**
+ * Creates an Arvo-compatible LLM Adapter for Anthropic Claude models.
+ *
+ * This factory configures an integration that bridges the generic `Arvo` agent runner with the specific
+ * Anthropic API requirements. It includes built-in features for:
+ *
+ * - **Structured Outputs:** Automatically converts Zod schemas to JSON schema format and instructs
+ *   Claude to respond with valid JSON matching the schema.
+ * - **Token Optimization:** Automatically replaces large media payloads (images/files) with placeholder
+ *   text in the conversational history after they have been processed once to reduce context window usage.
+ * - **Observability:** Instruments calls with OpenInference-compliant OpenTelemetry attributes,
+ *   including detailed input/output recording and token usage.
+ * - **Safety:** Automatically injects a "tool limit reached" system instruction when the agent
+ *   exhausts its configured tool budget.
+ *
+ * @param client - An initialized `Anthropic` SDK client instance.
+ * @param config - Configuration for model parameters (e.g., temperature, max tokens), cost calculations, and telemetry metadata.
+ * @returns An `AgentLLMIntegration` function ready for use with `createArvoAgent`.
+ */
+export declare const anthropicLLMIntegration: (client: Anthropic, config?: AnthropicLlmIntegrationConfig) => AgentLLMIntegration;
+//# sourceMappingURL=index.d.ts.map

package/dist/Integrations/anthropic/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Integrations/anthropic/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAiB/C,OAAO,KAAK,EAAE,mBAAmB,EAA6B,MAAM,UAAU,CAAC;AAC/E,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC;AAG7D;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,uBAAuB,GACjC,QAAQ,SAAS,EAAE,SAAS,6BAA6B,KAAG,mBAoLzD,CAAC"}

package/dist/Integrations/anthropic/index.js

@@ -0,0 +1,278 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.anthropicLLMIntegration = 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");
+var zod_to_json_schema_1 = require("zod-to-json-schema");
+var utils_1 = require("../../Agent/utils");
+var prompts_1 = require("../prompts");
+var utils_2 = require("./utils");
+/**
+ * Creates an Arvo-compatible LLM Adapter for Anthropic Claude models.
+ *
+ * This factory configures an integration that bridges the generic `Arvo` agent runner with the specific
+ * Anthropic API requirements. It includes built-in features for:
+ *
+ * - **Structured Outputs:** Automatically converts Zod schemas to JSON schema format and instructs
+ *   Claude to respond with valid JSON matching the schema.
+ * - **Token Optimization:** Automatically replaces large media payloads (images/files) with placeholder
+ *   text in the conversational history after they have been processed once to reduce context window usage.
+ * - **Observability:** Instruments calls with OpenInference-compliant OpenTelemetry attributes,
+ *   including detailed input/output recording and token usage.
+ * - **Safety:** Automatically injects a "tool limit reached" system instruction when the agent
+ *   exhausts its configured tool budget.
+ *
+ * @param client - An initialized `Anthropic` SDK client instance.
+ * @param config - Configuration for model parameters (e.g., temperature, max tokens), cost calculations, and telemetry metadata.
+ * @returns An `AgentLLMIntegration` function ready for use with `createArvoAgent`.
+ */
+var anthropicLLMIntegration = function (client, config) {
+    return function (_a, _b) { return __awaiter(void 0, [_a, _b], void 0, function (_c, _d) {
+        var _e;
+        var _messages = _c.messages, _system = _c.system, tools = _c.tools, outputFormat = _c.outputFormat, lifecycle = _c.lifecycle, toolInteractions = _c.toolInteractions;
+        var otelInfo = _d.otelInfo;
+        return __generator(this, function (_f) {
+            switch (_f.label) {
+                case 0: return [4 /*yield*/, arvo_core_1.ArvoOpenTelemetry.getInstance().startActiveSpan({
+                        name: "LLM.invoke<".concat(lifecycle === 'init' ? 'init' : lifecycle === 'tool_result' ? 'resume' : 'output_validation_feedback', ">"),
+                        disableSpanManagement: true,
+                        context: {
+                            inheritFrom: 'TRACE_HEADERS',
+                            traceHeaders: otelInfo.headers,
+                        },
+                        spanOptions: {
+                            attributes: (_e = {},
+                                _e[openinference_semantic_conventions_1.SemanticConventions.OPENINFERENCE_SPAN_KIND] = openinference_semantic_conventions_1.OpenInferenceSpanKind.LLM,
+                                _e),
+                        },
+                        fn: function (span) { return __awaiter(void 0, void 0, void 0, function () {
+                            var messageCreateParams, _a, messages, system, limitMessage, jsonSchema, schemaInstruction, toolDef, tools_1, tools_1_1, tool, formattedMessages, response, llmUsage, executionUnits, toolUseBlocks, toolRequests, toolUseBlocks_1, toolUseBlocks_1_1, toolCall, textBlocks, content, e_1;
+                            var e_2, _b, e_3, _c;
+                            var _d, _e, _f, _g, _h, _j, _k;
+                            return __generator(this, function (_l) {
+                                switch (_l.label) {
+                                    case 0:
+                                        messageCreateParams = (_d = config === null || config === void 0 ? void 0 : config.invocationParam) !== null && _d !== void 0 ? _d : {
+                                            model: 'claude-sonnet-4-20250514',
+                                            max_tokens: 4096,
+                                            temperature: 0,
+                                        };
+                                        return [4 /*yield*/, ((_e = config === null || config === void 0 ? void 0 : config.contextTransformer) === null || _e === void 0 ? void 0 : _e.call(config, {
+                                                messages: _messages,
+                                                system: _system,
+                                            }))];
+                                    case 1:
+                                        _a = (_f = (_l.sent())) !== null && _f !== void 0 ? _f : {
+                                            messages: _messages.map(function (item) {
+                                                if (item.content.type === 'media' && item.seenCount > 0) {
+                                                    return {
+                                                        role: item.role,
+                                                        content: {
+                                                            type: 'text',
+                                                            content: "Media file (type: ".concat(item.content.contentType.type, "@").concat(item.content.contentType.format, ") already parsed and looked at. No need for you to look at it again"),
+                                                        },
+                                                        seenCount: item.seenCount,
+                                                    };
+                                                }
+                                                return item;
+                                            }),
+                                            system: _system,
+                                        }, messages = _a.messages, system = _a.system;
+                                        if (toolInteractions.exhausted) {
+                                            limitMessage = (_h = (_g = config === null || config === void 0 ? void 0 : config.toolLimitPrompt) === null || _g === void 0 ? void 0 : _g.call(config, toolInteractions)) !== null && _h !== void 0 ? _h : prompts_1.DEFAULT_TOOL_LIMIT_PROMPT;
+                                            messages.push({
+                                                role: 'user',
+                                                content: {
+                                                    type: 'text',
+                                                    content: limitMessage,
+                                                },
+                                                seenCount: 0,
+                                            });
+                                            system = "".concat(system, "\n\n").concat(limitMessage);
+                                        }
+                                        // For JSON output format, append schema instructions to the system prompt
+                                        if (outputFormat.type === 'json') {
+                                            jsonSchema = (0, zod_to_json_schema_1.zodToJsonSchema)(outputFormat.format);
+                                            schemaInstruction = (0, prompts_1.jsonPrompt)(JSON.stringify(jsonSchema));
+                                            system = system ? "".concat(system).concat(schemaInstruction) : schemaInstruction;
+                                        }
+                                        (0, utils_1.setOpenInferenceInputAttr)({
+                                            llm: {
+                                                provider: 'anthropic',
+                                                system: 'anthropic',
+                                                model: messageCreateParams === null || messageCreateParams === void 0 ? void 0 : messageCreateParams.model,
+                                                invocationParam: messageCreateParams,
+                                            },
+                                            messages: messages,
+                                            system: system,
+                                            tools: tools,
+                                        }, span);
+                                        _l.label = 2;
+                                    case 2:
+                                        _l.trys.push([2, 4, 5, 6]);
+                                        toolDef = [];
+                                        try {
+                                            for (tools_1 = __values(tools), tools_1_1 = tools_1.next(); !tools_1_1.done; tools_1_1 = tools_1.next()) {
+                                                tool = tools_1_1.value;
+                                                toolDef.push({
+                                                    name: tool.name,
+                                                    description: tool.description,
+                                                    input_schema: tool.inputSchema,
+                                                });
+                                            }
+                                        }
+                                        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+                                        finally {
+                                            try {
+                                                if (tools_1_1 && !tools_1_1.done && (_b = tools_1.return)) _b.call(tools_1);
+                                            }
+                                            finally { if (e_2) throw e_2.error; }
+                                        }
+                                        formattedMessages = (0, utils_2.formatMessagesForAnthropic)(messages);
+                                        return [4 /*yield*/, client.messages.create(__assign(__assign({}, messageCreateParams), { system: system !== null && system !== void 0 ? system : undefined, tools: toolDef.length ? toolDef : undefined, messages: formattedMessages }))];
+                                    case 3:
+                                        response = _l.sent();
+                                        llmUsage = {
+                                            tokens: {
+                                                prompt: response.usage.input_tokens,
+                                                completion: response.usage.output_tokens,
+                                            },
+                                        };
+                                        executionUnits = (_k = (_j = config === null || config === void 0 ? void 0 : config.executionunits) === null || _j === void 0 ? void 0 : _j.call(config, llmUsage.tokens.prompt, llmUsage.tokens.completion)) !== null && _k !== void 0 ? _k : llmUsage.tokens.prompt + llmUsage.tokens.completion;
+                                        (0, utils_1.setOpenInferenceUsageOutputAttr)(llmUsage, span);
+                                        toolUseBlocks = response.content.filter(function (block) { return block.type === 'tool_use'; });
+                                        if (toolUseBlocks.length > 0) {
+                                            toolRequests = [];
+                                            try {
+                                                for (toolUseBlocks_1 = __values(toolUseBlocks), toolUseBlocks_1_1 = toolUseBlocks_1.next(); !toolUseBlocks_1_1.done; toolUseBlocks_1_1 = toolUseBlocks_1.next()) {
+                                                    toolCall = toolUseBlocks_1_1.value;
+                                                    try {
+                                                        toolRequests.push({
+                                                            toolUseId: toolCall.id,
+                                                            name: toolCall.name,
+                                                            input: toolCall.input,
+                                                        });
+                                                    }
+                                                    catch (err) {
+                                                        (0, arvo_core_1.exceptionToSpan)(err, span);
+                                                    }
+                                                }
+                                            }
+                                            catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                                            finally {
+                                                try {
+                                                    if (toolUseBlocks_1_1 && !toolUseBlocks_1_1.done && (_c = toolUseBlocks_1.return)) _c.call(toolUseBlocks_1);
+                                                }
+                                                finally { if (e_3) throw e_3.error; }
+                                            }
+                                            if (toolRequests.length) {
+                                                (0, utils_1.setOpenInferenceToolCallOutputAttr)({ toolCalls: toolRequests }, span);
+                                                return [2 /*return*/, {
+                                                        type: 'tool_call',
+                                                        toolRequests: toolRequests,
+                                                        usage: llmUsage,
+                                                        executionUnits: executionUnits,
+                                                    }];
+                                            }
+                                        }
+                                        textBlocks = response.content.filter(function (block) { return block.type === 'text'; });
+                                        content = textBlocks.map(function (block) { return block.text; }).join('');
+                                        // Handle stop reasons
+                                        if (response.stop_reason === 'max_tokens') {
+                                            content = "".concat(content, " [Max response token limit (<= ").concat(messageCreateParams.max_tokens, ") reached]");
+                                            throw new Error("Agent reached max token limit. The partial response is \"".concat(content, "\""));
+                                        }
+                                        (0, utils_1.setOpenInferenceResponseOutputAttr)({ response: content }, span);
+                                        if (outputFormat.type === 'json') {
+                                            return [2 /*return*/, {
+                                                    type: 'json',
+                                                    content: content || '{}',
+                                                    parsedContent: (0, utils_1.tryParseJson)(content || '{}'),
+                                                    usage: llmUsage,
+                                                    executionUnits: executionUnits,
+                                                }];
+                                        }
+                                        return [2 /*return*/, {
+                                                type: 'text',
+                                                content: content,
+                                                usage: llmUsage,
+                                                executionUnits: executionUnits,
+                                            }];
+                                    case 4:
+                                        e_1 = _l.sent();
+                                        span.setStatus({ code: api_1.SpanStatusCode.ERROR, message: e_1 === null || e_1 === void 0 ? void 0 : e_1.message });
+                                        throw e_1;
+                                    case 5:
+                                        span.end();
+                                        return [7 /*endfinally*/];
+                                    case 6: return [2 /*return*/];
+                                }
+                            });
+                        }); },
+                    })];
+                case 1: return [2 /*return*/, _f.sent()];
+            }
+        });
+    }); };
+};
+exports.anthropicLLMIntegration = anthropicLLMIntegration;
+//# sourceMappingURL=index.js.map

package/dist/Integrations/anthropic/index.js.map

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

package/dist/Integrations/anthropic/types.d.ts

@@ -0,0 +1,17 @@
+import type Anthropic from '@anthropic-ai/sdk';
+import type { CommonIntegrationConfig } from '../types';
+export type AnthropicLlmIntegrationConfig = {
+    /**
+     * Configuration strictly for the model invocation parameters passed to the Anthropic SDK.
+     *
+     * Common parameters include:
+     * - `model`: The model ID (e.g., `claude-sonnet-4-20250514`, `claude-3-5-sonnet-20241022`).
+     * - `temperature`: Controls randomness (0-1).
+     * - `max_tokens`: Limits the generation length (required by Anthropic).
+     *
+     * @default
+     * { model: 'claude-sonnet-4-20250514', max_tokens: 4096, temperature: 0 }
+     */
+    invocationParam?: Pick<Anthropic.MessageCreateParamsNonStreaming, 'model' | 'temperature' | 'max_tokens'>;
+} & CommonIntegrationConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/Integrations/anthropic/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/Integrations/anthropic/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAExD,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,IAAI,CACpB,SAAS,CAAC,+BAA+B,EACzC,OAAO,GAAG,aAAa,GAAG,YAAY,CACvC,CAAC;CACH,GAAG,uBAAuB,CAAC"}

package/dist/Integrations/anthropic/types.js

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

package/dist/Integrations/anthropic/types.js.map

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

package/dist/Integrations/anthropic/utils.d.ts

@@ -0,0 +1,14 @@
+import type Anthropic from '@anthropic-ai/sdk';
+import type { AgentLLMIntegrationParam } from '../types';
+/**
+ * Internal Adapter: Maps Arvo's generic Agent Message format to Anthropic's specific API format.
+ *
+ * Handles:
+ * - Mapping Tool Results to their originating Tool Call IDs.
+ * - Multimodal Content (converting Arvo media objects to Anthropic Image source format).
+ * - Reconstructs the specific message ordering Anthropic expects (User -> Assistant(ToolUse) -> User(ToolResult)).
+ *
+ * Note: Anthropic does not use a system message in the messages array - it's passed separately.
+ */
+export declare const formatMessagesForAnthropic: (messages: AgentLLMIntegrationParam["messages"]) => Anthropic.MessageParam[];
+//# sourceMappingURL=utils.d.ts.map

package/dist/Integrations/anthropic/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/Integrations/anthropic/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEzD;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,GACrC,UAAU,wBAAwB,CAAC,UAAU,CAAC,KAC7C,SAAS,CAAC,YAAY,EA0FxB,CAAC"}