@arvo-tools/agentic 1.0.0 → 1.1.0

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

@@ -0,0 +1,33 @@
+import type OpenAI from 'openai';
+import type { AzureOpenAI } from 'openai';
+import type { CommonIntegrationConfig } from '../types';
+export type OpenAILlmIntegrationConfig<TClient extends OpenAI | AzureOpenAI> = {
+    /**
+     * Configuration strictly for the model invocation parameters passed to the OpenAI SDK.
+     *
+     * Common parameters include:
+     * - `model`: The model ID (e.g., `gpt-4o`).
+     * - `temperature`: Controls randomness.
+     * - `max_completion_tokens` or `max_tokens`: Limits the generation length.
+     *
+     * @default
+     * { model: 'gpt-4o', max_completion_tokens: 4096, temperature: 0 }
+     */
+    invocationParam?: Pick<Parameters<TClient['chat']['completions']['create']>[0], 'model' | 'temperature' | 'max_tokens' | 'max_completion_tokens'>;
+    /**
+     * Configuration for distributed tracing attributes.
+     */
+    telemetry?: {
+        /**
+         * The value for the `llm.provider` OpenTelemetry attribute.
+         * @default 'openai'
+         */
+        modelProvider?: string;
+        /**
+         * The value for the `llm.system` OpenTelemetry attribute.
+         * @default 'openai' (or 'azure_openai' if utilizing Azure)
+         */
+        modelSystem?: string;
+    };
+} & CommonIntegrationConfig;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/Integrations/openai/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAExD,MAAM,MAAM,0BAA0B,CAAC,OAAO,SAAS,MAAM,GAAG,WAAW,IAAI;IAC7E;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,IAAI,CACpB,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EACvD,OAAO,GAAG,aAAa,GAAG,YAAY,GAAG,uBAAuB,CACjE,CAAC;IAEF;;OAEG;IACH,SAAS,CAAC,EAAE;QACV;;;WAGG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB;;;WAGG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH,GAAG,uBAAuB,CAAC"}

package/dist/Integrations/openai/types.js

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

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

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

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

@@ -0,0 +1,13 @@
+import type { ChatCompletionMessageParam } from 'openai/resources/index.mjs';
+import type { AgentLLMIntegrationParam } from '../types';
+/**
+ * Internal Adapter: Maps Arvo's generic Agent Message format to OpenAI's specific API format.
+ *
+ * Handles:
+ * - System Prompt injection.
+ * - Mapping Tool Results to their originating Tool Call IDs.
+ * - Multimodal Content (converting Arvo media objects to OpenAI Image/File URLs).
+ * - Reconstructs the specific message ordering OpenAI expects (User -> Assistant(ToolCall) -> Tool(Result)).
+ */
+export declare const formatMessagesForOpenAI: (messages: AgentLLMIntegrationParam["messages"], systemPrompt: string | null) => ChatCompletionMessageParam[];
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/Integrations/openai/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAE7E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEzD;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,wBAAwB,CAAC,UAAU,CAAC,EAC9C,cAAc,MAAM,GAAG,IAAI,KAC1B,0BAA0B,EAyF5B,CAAC"}

package/dist/Integrations/openai/utils.js

@@ -0,0 +1,133 @@
+"use strict";
+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.formatMessagesForOpenAI = void 0;
+/**
+ * Internal Adapter: Maps Arvo's generic Agent Message format to OpenAI's specific API format.
+ *
+ * Handles:
+ * - System Prompt injection.
+ * - Mapping Tool Results to their originating Tool Call IDs.
+ * - Multimodal Content (converting Arvo media objects to OpenAI Image/File URLs).
+ * - Reconstructs the specific message ordering OpenAI expects (User -> Assistant(ToolCall) -> Tool(Result)).
+ */
+var formatMessagesForOpenAI = function (messages, systemPrompt) {
+    var e_1, _a, e_2, _b;
+    var _c;
+    var formattedMessages = [];
+    if (systemPrompt) {
+        formattedMessages.push({
+            role: 'system',
+            content: systemPrompt,
+        });
+    }
+    var toolResponseMap = {};
+    try {
+        for (var messages_1 = __values(messages), messages_1_1 = messages_1.next(); !messages_1_1.done; messages_1_1 = messages_1.next()) {
+            var message = messages_1_1.value;
+            if (message.role === 'user' && message.content.type === 'tool_result') {
+                toolResponseMap[message.content.toolUseId] = message.content;
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (messages_1_1 && !messages_1_1.done && (_a = messages_1.return)) _a.call(messages_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    try {
+        for (var messages_2 = __values(messages), messages_2_1 = messages_2.next(); !messages_2_1.done; messages_2_1 = messages_2.next()) {
+            var message = messages_2_1.value;
+            if (message.role === 'user') {
+                if (message.content.type === 'text') {
+                    formattedMessages.push({
+                        role: 'user',
+                        content: message.content.content,
+                    });
+                }
+                else if (message.content.type === 'media' &&
+                    message.content.contentType.type === 'image' &&
+                    message.content.contentType.format === 'base64') {
+                    formattedMessages.push({
+                        role: 'user',
+                        content: [
+                            {
+                                type: 'image_url',
+                                image_url: {
+                                    url: message.content.content,
+                                },
+                            },
+                        ],
+                    });
+                }
+                else if (message.content.type === 'media' &&
+                    message.content.contentType.type === 'file' &&
+                    message.content.contentType.format === 'base64') {
+                    formattedMessages.push({
+                        role: 'user',
+                        content: [
+                            {
+                                type: 'file',
+                                file: {
+                                    filename: message.content.contentType.name,
+                                    file_data: message.content.content,
+                                },
+                            },
+                        ],
+                    });
+                }
+            }
+            else if (message.role === 'assistant') {
+                if (message.content.type === 'text') {
+                    formattedMessages.push({
+                        role: 'assistant',
+                        content: message.content.content,
+                    });
+                }
+                else if (message.content.type === 'tool_use') {
+                    formattedMessages.push({
+                        role: 'assistant',
+                        tool_calls: [
+                            {
+                                type: 'function',
+                                id: message.content.toolUseId,
+                                function: {
+                                    name: message.content.name,
+                                    arguments: JSON.stringify(message.content.input),
+                                },
+                            },
+                        ],
+                    });
+                    var toolResult = toolResponseMap[message.content.toolUseId];
+                    formattedMessages.push({
+                        role: 'tool',
+                        tool_call_id: message.content.toolUseId,
+                        content: (_c = toolResult === null || toolResult === void 0 ? void 0 : toolResult.content) !== null && _c !== void 0 ? _c : JSON.stringify({ error: 'No tool response' }),
+                    });
+                }
+            }
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (messages_2_1 && !messages_2_1.done && (_b = messages_2.return)) _b.call(messages_2);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    return formattedMessages;
+};
+exports.formatMessagesForOpenAI = formatMessagesForOpenAI;
+//# sourceMappingURL=utils.js.map

package/dist/Integrations/openai/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/Integrations/openai/utils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAIA;;;;;;;;GAQG;AACI,IAAM,uBAAuB,GAAG,UACrC,QAA8C,EAC9C,YAA2B;;;IAE3B,IAAM,iBAAiB,GAAiC,EAAE,CAAC;IAE3D,IAAI,YAAY,EAAE,CAAC;QACjB,iBAAiB,CAAC,IAAI,CAAC;YACrB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,YAAY;SACtB,CAAC,CAAC;IACL,CAAC;IAED,IAAM,eAAe,GAA2C,EAAE,CAAC;;QACnE,KAAsB,IAAA,aAAA,SAAA,QAAQ,CAAA,kCAAA,wDAAE,CAAC;YAA5B,IAAM,OAAO,qBAAA;YAChB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACtE,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;YAC/D,CAAC;QACH,CAAC;;;;;;;;;;QAED,KAAsB,IAAA,aAAA,SAAA,QAAQ,CAAA,kCAAA,wDAAE,CAAC;YAA5B,IAAM,OAAO,qBAAA;YAChB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC5B,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBACpC,iBAAiB,CAAC,IAAI,CAAC;wBACrB,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO;qBACjC,CAAC,CAAC;gBACL,CAAC;qBAAM,IACL,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO;oBAChC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,KAAK,OAAO;oBAC5C,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,KAAK,QAAQ,EAC/C,CAAC;oBACD,iBAAiB,CAAC,IAAI,CAAC;wBACrB,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,WAAW;gCACjB,SAAS,EAAE;oCACT,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO;iCAC7B;6BACF;yBACF;qBACF,CAAC,CAAC;gBACL,CAAC;qBAAM,IACL,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO;oBAChC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,KAAK,MAAM;oBAC3C,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,KAAK,QAAQ,EAC/C,CAAC;oBACD,iBAAiB,CAAC,IAAI,CAAC;wBACrB,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE;oCACJ,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI;oCAC1C,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO;iCACnC;6BACF;yBACF;qBACF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;iBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACxC,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBACpC,iBAAiB,CAAC,IAAI,CAAC;wBACrB,IAAI,EAAE,WAAW;wBACjB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO;qBACjC,CAAC,CAAC;gBACL,CAAC;qBAAM,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBAC/C,iBAAiB,CAAC,IAAI,CAAC;wBACrB,IAAI,EAAE,WAAW;wBACjB,UAAU,EAAE;4BACV;gCACE,IAAI,EAAE,UAAU;gCAChB,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS;gCAC7B,QAAQ,EAAE;oCACR,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI;oCAC1B,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;iCACjD;6BACF;yBACF;qBACF,CAAC,CAAC;oBACH,IAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;oBAC9D,iBAAiB,CAAC,IAAI,CAAC;wBACrB,IAAI,EAAE,MAAM;wBACZ,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS;wBACvC,OAAO,EAAE,MAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,OAAO,mCAAI,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;qBAC9E,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;;;;;;;;;IAED,OAAO,iBAAiB,CAAC;AAC3B,CAAC,CAAC;AA5FW,QAAA,uBAAuB,2BA4FlC"}

package/dist/Integrations/prompts.d.ts

@@ -5,4 +5,5 @@
  * synthesize a final response based on whatever partial data it has managed to collect so far.
  */
 export declare const DEFAULT_TOOL_LIMIT_PROMPT: string;
+export declare const jsonPrompt: (schema: string) => string;
 //# sourceMappingURL=prompts.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/Integrations/prompts.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,QAOpC,CAAC"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/Integrations/prompts.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,QAOpC,CAAC;AAEH,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,WAmCvC,CAAC"}

package/dist/Integrations/prompts.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_TOOL_LIMIT_PROMPT = void 0;
+exports.jsonPrompt = exports.DEFAULT_TOOL_LIMIT_PROMPT = void 0;
 var arvo_core_1 = require("arvo-core");
 /**
  * Standard System Instruction injected when the Agent reaches its `maxToolInteractions` limit.
@@ -9,4 +9,8 @@ var arvo_core_1 = require("arvo-core");
  * synthesize a final response based on whatever partial data it has managed to collect so far.
  */
 exports.DEFAULT_TOOL_LIMIT_PROMPT = (0, arvo_core_1.cleanString)("\n  **CRITICAL WARNING: You have reached your tool interaction limit!**\n  You must answer the original question using all the data available to you. \n  You have run out of tool call budget. No more tool calls are allowed any more.\n  If you cannot answer the query well. Then mention what you have done briefly, what\n  can you answer based on the collected data, what data is missing and why you cannot \n  answer any further.  \n");
+var jsonPrompt = function (schema) {
+    return (0, arvo_core_1.cleanString)("\n    # Critical JSON Output Requirements\n    You must return ONLY a valid JSON object with no additional text, explanations, or formatting outside the required JSON structure.\n\n    ## Mandatory Compliance Rules\n    1. The entire response must be a single, parseable JSON object\n    2. Use double quotes for all keys and string values\n    3. No text, commentary, or explanations before or after the JSON\n    4. No markdown code fences (```json or ```) - return raw JSON only\n    5. Properly escape special characters: \\n for newlines, \\\" for quotes, \\\\ for backslashes\n    6. Use literal values: true, false, and null (lowercase, never as strings)\n    7. Numbers must not be enclosed in quotes\n    8. No comments (// or /* */) or trailing commas anywhere in the JSON\n    9. Arrays must use square brackets [], objects must use curly braces {}\n    10. All required fields in the schema MUST be present\n    11. Do not include fields not defined in the schema\n    12. When a field is optional and you have no value, omit it entirely (do not use null unless the schema explicitly allows it)\n\n    ## Schema Specification\n    The response must conform exactly to this JSON Schema (Draft-07) structure:\n    ```json\n    ".concat(schema, "\n    ```\n\n    ## Output Format\n    Return ONLY the raw JSON object starting with { and ending with }.\n    The output will be parsed directly using JSON.parse(), so any non-compliant formatting will cause a fatal error.\n\n    ## Common Mistakes to Avoid\n    - Do NOT wrap the JSON in markdown code blocks\n    - Do NOT include any preamble like \"Here is the JSON:\"\n    - Do NOT include any explanation after the JSON\n    - Do NOT use single quotes instead of double quotes\n    - Do NOT leave trailing commas after the last item in arrays or objects\n"));
+};
+exports.jsonPrompt = jsonPrompt;
 //# sourceMappingURL=prompts.js.map

package/dist/Integrations/prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/Integrations/prompts.ts"],"names":[],"mappings":";;;AAAA,uCAAwC;AAExC;;;;;GAKG;AACU,QAAA,yBAAyB,GAAG,IAAA,uBAAW,EAAC,mbAOpD,CAAC,CAAC"}
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/Integrations/prompts.ts"],"names":[],"mappings":";;;AAAA,uCAAwC;AAExC;;;;;GAKG;AACU,QAAA,yBAAyB,GAAG,IAAA,uBAAW,EAAC,mbAOpD,CAAC,CAAC;AAEI,IAAM,UAAU,GAAG,UAAC,MAAc;IACvC,OAAA,IAAA,uBAAW,EAAC,+tCAqBR,MAAM,sjBAaX,CAAC;AAlCA,CAkCA,CAAC;AAnCU,QAAA,UAAU,cAmCpB"}

package/dist/Integrations/types.d.ts

@@ -1,6 +1,7 @@
 import type z from 'zod';
+import type { AgentEventStreamer } from '../Agent/stream/types';
 import type { AgentLLMContext, AgentMessage, AgentToolCallContent, AgentToolDefinition } from '../Agent/types';
-import type { OtelInfoType } from '../types';
+import type { OtelInfoType, PromiseAble } from '../types';
 /**
  * The standardized input payload passed to a Custom LLM Integration function.
  *
@@ -41,6 +42,10 @@ export type AgentLLMIntegrationParam = {
         type: 'json';
         format: z.ZodTypeAny;
     };
+    /**
+     * A function to log streaming events from the llm
+     */
+    onStream: AgentEventStreamer;
 };
 /**
  * The normalized response object your Custom Integration must return.
@@ -98,4 +103,39 @@ export type AgentLLMIntegrationOutput = {
 export type AgentLLMIntegration = (param: AgentLLMIntegrationParam, config: {
     otelInfo: OtelInfoType;
 }) => Promise<AgentLLMIntegrationOutput>;
+export type CommonIntegrationConfig = {
+    /**
+     * A calculator function to determine the abstract "Execution Units" (cost) of the LLM call.
+     *
+     * This allows mapping raw token usage to a unified cost metric used by the `Arvo` event system.
+     * For example, $Cost = (PromptTokens \times Price_{in}) + (CompletionTokens \times Price_{out})$.
+     *
+     * @param prompt - The number of input tokens used.
+     * @param completion - The number of output tokens generated.
+     * @returns The calculated execution units (e.g., cost in cents or arbitrary units).
+     */
+    executionunits?: (prompt: number, completion: number) => number;
+    /**
+     * A custom system instruction injected when the agent exceeds its `maxToolInteractions` limit.
+     *
+     * Use this to guide the model to either summarize its current progress, give up gracefully, or
+     * attempt a final answer without further tool usage.
+     */
+    toolLimitPrompt?: (toolInteractions: AgentLLMIntegrationParam['toolInteractions']) => string;
+    /**
+     * An optional interceptor to transform messages or system instructions immediately before the LLM call.
+     *
+     * This is useful for last-mile modifications, such as filtering sensitive data or appending dynamic
+     * context, without permanently altering the Agent's state history.
+     *
+     * @returns A promise resolving to the modified `messages` array and `system` prompt string.
+     */
+    contextTransformer?: (param: {
+        messages: AgentMessage[];
+        system: string | null;
+    }) => PromiseAble<{
+        messages: AgentMessage[];
+        system: string | null;
+    }>;
+};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/Integrations/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,uBAAuB,CAAC;IAE5D,kGAAkG;IAClG,QAAQ,EAAE,YAAY,EAAE,CAAC;IAEzB,mFAAmF;IACnF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB,+FAA+F;IAC/F,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAE7B;;;;OAIG;IACH,gBAAgB,EAAE,eAAe,CAAC,kBAAkB,CAAC,GAAG;QACtD,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IAEF;;;;OAIG;IACH,YAAY,EACR;QACE,IAAI,EAAE,MAAM,CAAC;KACd,GACD;QACE,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;KACtB,CAAC;CACP,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,+CAA+C;IAC/C,KAAK,EAAE;QACL,MAAM,EAAE;YACN,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;IACF;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,CACA;IACE,sCAAsC;IACtC,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,EAAE,CAAC;CACpD,GACD;IACE,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC/C,CACJ,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,KAAK,EAAE,wBAAwB,EAC/B,MAAM,EAAE;IAAE,QAAQ,EAAE,YAAY,CAAA;CAAE,KAC/B,OAAO,CAAC,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/Integrations/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,uBAAuB,CAAC;IAE5D,kGAAkG;IAClG,QAAQ,EAAE,YAAY,EAAE,CAAC;IAEzB,mFAAmF;IACnF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB,+FAA+F;IAC/F,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAE7B;;;;OAIG;IACH,gBAAgB,EAAE,eAAe,CAAC,kBAAkB,CAAC,GAAG;QACtD,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IAEF;;;;OAIG;IACH,YAAY,EACR;QACE,IAAI,EAAE,MAAM,CAAC;KACd,GACD;QACE,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;KACtB,CAAC;IAEN;;OAEG;IACH,QAAQ,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,+CAA+C;IAC/C,KAAK,EAAE;QACL,MAAM,EAAE;YACN,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;IACF;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,CACA;IACE,sCAAsC;IACtC,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,EAAE,CAAC;CACpD,GACD;IACE,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC/C,CACJ,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,KAAK,EAAE,wBAAwB,EAC/B,MAAM,EAAE;IAAE,QAAQ,EAAE,YAAY,CAAA;CAAE,KAC/B,OAAO,CAAC,yBAAyB,CAAC,CAAC;AAExC,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IAEhE;;;;;OAKG;IACH,eAAe,CAAC,EAAE,CAAC,gBAAgB,EAAE,wBAAwB,CAAC,kBAAkB,CAAC,KAAK,MAAM,CAAC;IAE7F;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,WAAW,CAAC;QAC/F,QAAQ,EAAE,YAAY,EAAE,CAAC;QACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC,CAAC;CACJ,CAAC"}

package/dist/index.d.ts

@@ -1,10 +1,13 @@
 export { AgentState, createArvoAgent } from './Agent';
 export { AgentDefaults } from './Agent/AgentDefaults';
 export { AgentMediaContentSchema, AgentMessageContentSchema, AgentMessageSchema, AgentTextContentSchema, AgentToolCallContentSchema, AgentToolResultContentSchema, } from './Agent/schema';
+export { AgentStreamEventSchema } from './Agent/stream/schema';
+export { AgentStreamListener } from './Agent/stream/types';
 export type { AgentContextBuilder, AgentLLMContext, AgentMediaContent, AgentMessage, AgentMessageContent, AgentOutputBuilder, AgentServiceContract, AgentTextContent, AgentToolCallContent, AgentToolDefinition, AgentToolResultContent, AnyArvoContract, AnyArvoOrchestratorContract, CreateArvoAgentParam, } from './Agent/types';
 export { setOpenInferenceInputAttr, setOpenInferenceResponseOutputAttr, setOpenInferenceToolCallOutputAttr, setOpenInferenceUsageOutputAttr, tryParseJson, } from './Agent/utils';
 export { createAgentTool } from './AgentTool';
 export type { AgentInternalTool } from './AgentTool/types';
+export { anthropicLLMIntegration } from './Integrations/anthropic';
 export { MCPClient } from './Integrations/MCPClient';
 export { openaiLLMIntegration } from './Integrations/openai';
 export { DEFAULT_TOOL_LIMIT_PROMPT } from './Integrations/prompts';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,yBAAyB,EACzB,kCAAkC,EAClC,kCAAkC,EAClC,+BAA+B,EAC/B,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EACV,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,yBAAyB,EACzB,kCAAkC,EAClC,kCAAkC,EAClC,+BAA+B,EAC/B,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EACV,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_TOOL_LIMIT_PROMPT = exports.openaiLLMIntegration = exports.MCPClient = exports.createAgentTool = exports.tryParseJson = exports.setOpenInferenceUsageOutputAttr = exports.setOpenInferenceToolCallOutputAttr = exports.setOpenInferenceResponseOutputAttr = exports.setOpenInferenceInputAttr = exports.AgentToolResultContentSchema = exports.AgentToolCallContentSchema = exports.AgentTextContentSchema = exports.AgentMessageSchema = exports.AgentMessageContentSchema = exports.AgentMediaContentSchema = exports.AgentDefaults = exports.createArvoAgent = void 0;
+exports.DEFAULT_TOOL_LIMIT_PROMPT = exports.openaiLLMIntegration = exports.MCPClient = exports.anthropicLLMIntegration = exports.createAgentTool = exports.tryParseJson = exports.setOpenInferenceUsageOutputAttr = exports.setOpenInferenceToolCallOutputAttr = exports.setOpenInferenceResponseOutputAttr = exports.setOpenInferenceInputAttr = exports.AgentStreamEventSchema = exports.AgentToolResultContentSchema = exports.AgentToolCallContentSchema = exports.AgentTextContentSchema = exports.AgentMessageSchema = exports.AgentMessageContentSchema = exports.AgentMediaContentSchema = exports.AgentDefaults = exports.createArvoAgent = void 0;
 var Agent_1 = require("./Agent");
 Object.defineProperty(exports, "createArvoAgent", { enumerable: true, get: function () { return Agent_1.createArvoAgent; } });
 var AgentDefaults_1 = require("./Agent/AgentDefaults");
@@ -12,6 +12,8 @@ Object.defineProperty(exports, "AgentMessageSchema", { enumerable: true, get: fu
 Object.defineProperty(exports, "AgentTextContentSchema", { enumerable: true, get: function () { return schema_1.AgentTextContentSchema; } });
 Object.defineProperty(exports, "AgentToolCallContentSchema", { enumerable: true, get: function () { return schema_1.AgentToolCallContentSchema; } });
 Object.defineProperty(exports, "AgentToolResultContentSchema", { enumerable: true, get: function () { return schema_1.AgentToolResultContentSchema; } });
+var schema_2 = require("./Agent/stream/schema");
+Object.defineProperty(exports, "AgentStreamEventSchema", { enumerable: true, get: function () { return schema_2.AgentStreamEventSchema; } });
 var utils_1 = require("./Agent/utils");
 Object.defineProperty(exports, "setOpenInferenceInputAttr", { enumerable: true, get: function () { return utils_1.setOpenInferenceInputAttr; } });
 Object.defineProperty(exports, "setOpenInferenceResponseOutputAttr", { enumerable: true, get: function () { return utils_1.setOpenInferenceResponseOutputAttr; } });
@@ -20,6 +22,8 @@ Object.defineProperty(exports, "setOpenInferenceUsageOutputAttr", { enumerable:
 Object.defineProperty(exports, "tryParseJson", { enumerable: true, get: function () { return utils_1.tryParseJson; } });
 var AgentTool_1 = require("./AgentTool");
 Object.defineProperty(exports, "createAgentTool", { enumerable: true, get: function () { return AgentTool_1.createAgentTool; } });
+var anthropic_1 = require("./Integrations/anthropic");
+Object.defineProperty(exports, "anthropicLLMIntegration", { enumerable: true, get: function () { return anthropic_1.anthropicLLMIntegration; } });
 var MCPClient_1 = require("./Integrations/MCPClient");
 Object.defineProperty(exports, "MCPClient", { enumerable: true, get: function () { return MCPClient_1.MCPClient; } });
 var openai_1 = require("./Integrations/openai");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iCAAsD;AAAjC,wGAAA,eAAe,OAAA;AACpC,uDAAsD;AAA7C,8GAAA,aAAa,OAAA;AACtB,yCAOwB;AANtB,iHAAA,uBAAuB,OAAA;AACvB,mHAAA,yBAAyB,OAAA;AACzB,4GAAA,kBAAkB,OAAA;AAClB,gHAAA,sBAAsB,OAAA;AACtB,oHAAA,0BAA0B,OAAA;AAC1B,sHAAA,4BAA4B,OAAA;AAkB9B,uCAMuB;AALrB,kHAAA,yBAAyB,OAAA;AACzB,2HAAA,kCAAkC,OAAA;AAClC,2HAAA,kCAAkC,OAAA;AAClC,wHAAA,+BAA+B,OAAA;AAC/B,qGAAA,YAAY,OAAA;AAEd,yCAA8C;AAArC,4GAAA,eAAe,OAAA;AAExB,sDAAqD;AAA5C,sGAAA,SAAS,OAAA;AAClB,gDAA6D;AAApD,8GAAA,oBAAoB,OAAA;AAC7B,kDAAmE;AAA1D,oHAAA,yBAAyB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iCAAsD;AAAjC,wGAAA,eAAe,OAAA;AACpC,uDAAsD;AAA7C,8GAAA,aAAa,OAAA;AACtB,yCAOwB;AANtB,iHAAA,uBAAuB,OAAA;AACvB,mHAAA,yBAAyB,OAAA;AACzB,4GAAA,kBAAkB,OAAA;AAClB,gHAAA,sBAAsB,OAAA;AACtB,oHAAA,0BAA0B,OAAA;AAC1B,sHAAA,4BAA4B,OAAA;AAE9B,gDAA+D;AAAtD,gHAAA,sBAAsB,OAAA;AAkB/B,uCAMuB;AALrB,kHAAA,yBAAyB,OAAA;AACzB,2HAAA,kCAAkC,OAAA;AAClC,2HAAA,kCAAkC,OAAA;AAClC,wHAAA,+BAA+B,OAAA;AAC/B,qGAAA,YAAY,OAAA;AAEd,yCAA8C;AAArC,4GAAA,eAAe,OAAA;AAExB,sDAAmE;AAA1D,oHAAA,uBAAuB,OAAA;AAChC,sDAAqD;AAA5C,sGAAA,SAAS,OAAA;AAClB,gDAA6D;AAApD,8GAAA,oBAAoB,OAAA;AAC7B,kDAAmE;AAA1D,oHAAA,yBAAyB,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arvo-tools/agentic",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Agentic toolset for building applications using arvo-core and arvo-event-handler",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -25,7 +25,9 @@
     "access": "public"
   },
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.71.0",
     "@arizeai/openinference-semantic-conventions": "^2.1.2",
+    "@azure/openai": "^2.0.0",
     "@modelcontextprotocol/sdk": "^1.22.0",
     "@opentelemetry/api": "1.9.0",
     "arvo-core": "^3.0.19",