@arvo-tools/agentic 1.2.17 → 2.0.1

package/dist/AgentTool/types.d.ts

@@ -1,4 +1,5 @@
 import type z from 'zod';
+import type { AgentMessage, AgentToolResultContent } from '../Agent/types';
 import type { OtelInfoType, PromiseAble } from '../types';
 /**
  * Defines the structure of a **Synchronous Internal Tool**.
@@ -15,7 +16,7 @@ import type { OtelInfoType, PromiseAble } from '../types';
  * - 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> = {
+export type AgentInternalTool<TInputSchema 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.
@@ -32,11 +33,6 @@ export type AgentInternalTool<TInputSchema extends z.ZodTypeAny = any, TOutputSc
      * 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**.
@@ -49,11 +45,33 @@ export type AgentInternalTool<TInputSchema extends z.ZodTypeAny = any, TOutputSc
      * 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`.
+     * @param config - Observability context (Span/Headers) to link any internal logging or network calls,
+     *                 plus the `toolUseId` for correlation.
+     * @returns One of three forms:
+     *   - `{ messages }` — Provide full control over the tool result message(s) sent back to the LLM.
+     *     Can be a single user message or a tuple starting with a user message followed by additional agent messages.
+     *     Use this to supply multimedia data from as user message
+     *   - `{ data }` — A simple key-value object that Arvo automatically wraps into a tool result content block.
+     *   - `void` — Return nothing; Arvo treats this as a successful no-op (useful for side-effect-only tools).
      */
     fn: (input: z.infer<TInputSchema>, config: {
         otelInfo: OtelInfoType;
-    }) => PromiseAble<z.infer<TOutputSchema>>;
+        toolUseId: string;
+    }) => PromiseAble<{
+        messages: {
+            role: 'user';
+            seenCount: number;
+            content: AgentToolResultContent;
+        } | [
+            {
+                role: 'user';
+                seenCount: number;
+                content: AgentToolResultContent;
+            },
+            ...AgentMessage[]
+        ];
+    } | {
+        data: Record<string, any>;
+    } | void>;
 };
 //# sourceMappingURL=types.d.ts.map

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;;;;;;;;;;;;;;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"}
+{"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,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE1D;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,iBAAiB,CAE3B,YAAY,SAAS,CAAC,CAAC,UAAU,GAAG,GAAG,IACrC;IACF;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,KAAK,EAAE,YAAY,CAAC;IAEpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;;;;;OAYG;IACH,EAAE,EAAE,CACF,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAC5B,MAAM,EAAE;QAAE,QAAQ,EAAE,YAAY,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAClD,WAAW,CACZ;QACE,QAAQ,EACJ;YACE,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,MAAM,CAAC;YAClB,OAAO,EAAE,sBAAsB,CAAC;SACjC,GACD;YACE;gBACE,IAAI,EAAE,MAAM,CAAC;gBACb,SAAS,EAAE,MAAM,CAAC;gBAClB,OAAO,EAAE,sBAAsB,CAAC;aACjC;YACD,GAAG,YAAY,EAAE;SAClB,CAAC;KACP,GAED;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GAE7B,IAAI,CACP,CAAC;CACH,CAAC"}

package/dist/Integrations/MCPClient.d.ts

@@ -10,9 +10,9 @@ export type MCPClientParam = {
     };
 };
 /**
- * A Production-grade Client for the Model Context Protocol (MCP).
+ * A Client for the Model Context Protocol (MCP).
  *
- * This class bridges Arvo Agents with the external MCP ecosystem, allowing agents to
+ * This connector bridges Arvo Agents with the external MCP ecosystem, allowing agents to
  * interact with filesystem, databases, GitHub, Slack, and other standardized MCP servers.
  *
  * @remarks

package/dist/Integrations/MCPClient.js

@@ -65,9 +65,9 @@ var streamableHttp_js_1 = require("@modelcontextprotocol/sdk/client/streamableHt
 var api_1 = require("@opentelemetry/api");
 var arvo_core_1 = require("arvo-core");
 /**
- * A Production-grade Client for the Model Context Protocol (MCP).
+ * A Client for the Model Context Protocol (MCP).
  *
- * This class bridges Arvo Agents with the external MCP ecosystem, allowing agents to
+ * This connector bridges Arvo Agents with the external MCP ecosystem, allowing agents to
  * interact with filesystem, databases, GitHub, Slack, and other standardized MCP servers.
  *
  * @remarks

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

@@ -1 +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,EAAiD,MAAM,UAAU,CAAC;AAGnG,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC;AAG7D;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,uBAAuB,GACjC,QAAQ,SAAS,EAAE,SAAS,6BAA6B,KAAG,mBAkKzD,CAAC"}
+{"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,EAAiD,MAAM,UAAU,CAAC;AAGnG,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC;AAG7D;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,uBAAuB,GACjC,QAAQ,SAAS,EAAE,SAAS,6BAA6B,KAAG,mBAyJzD,CAAC"}

package/dist/Integrations/anthropic/index.js

@@ -91,7 +91,7 @@ var utils_2 = require("./utils");
 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, onStream = _c.onStream;
+        var _messages = _c.messages, _system = _c.system, tools = _c.tools, outputFormat = _c.outputFormat, lifecycle = _c.lifecycle, agentCycles = _c.agentCycles, onStream = _c.onStream;
         var otelInfo = _d.otelInfo;
         return __generator(this, function (_f) {
             switch (_f.label) {
@@ -121,8 +121,8 @@ var anthropicLLMIntegration = function (client, config) {
                                             })];
                                     case 1:
                                         _a = _l.sent(), messages = _a.messages, system = _a.system;
-                                        if (toolInteractions.exhausted) {
-                                            limitMessage = (_f = (_e = config === null || config === void 0 ? void 0 : config.toolLimitPrompt) === null || _e === void 0 ? void 0 : _e.call(config, toolInteractions)) !== null && _f !== void 0 ? _f : prompts_1.DEFAULT_TOOL_LIMIT_PROMPT;
+                                        if (agentCycles.exhausted) {
+                                            limitMessage = (_f = (_e = config === null || config === void 0 ? void 0 : config.toolLimitPrompt) === null || _e === void 0 ? void 0 : _e.call(config, agentCycles)) !== null && _f !== void 0 ? _f : prompts_1.DEFAULT_TOOL_LIMIT_PROMPT;
                                             messages.push({
                                                 role: 'user',
                                                 content: {

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Integrations/openai/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAY1C,OAAO,KAAK,EAAE,mBAAmB,EAAiD,MAAM,UAAU,CAAC;AAGnG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAG1D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,GAC9B,OAAO,SAAS,MAAM,GAAG,WAAW,EACnC,QAAQ,OAAO,EACf,SAAS,0BAA0B,CAAC,OAAO,CAAC,KAC3C,mBAiLC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Integrations/openai/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAY1C,OAAO,KAAK,EAAE,mBAAmB,EAAiD,MAAM,UAAU,CAAC;AAGnG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAG1D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,GAC9B,OAAO,SAAS,MAAM,GAAG,WAAW,EACnC,QAAQ,OAAO,EACf,SAAS,0BAA0B,CAAC,OAAO,CAAC,KAC3C,mBAwKC,CAAC"}

package/dist/Integrations/openai/index.js

@@ -87,7 +87,7 @@ var utils_2 = require("./utils");
 var openaiLLMIntegration = 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, onStream = _c.onStream;
+        var _messages = _c.messages, _system = _c.system, tools = _c.tools, outputFormat = _c.outputFormat, lifecycle = _c.lifecycle, agentCycles = _c.agentCycles, onStream = _c.onStream;
         var otelInfo = _d.otelInfo;
         return __generator(this, function (_f) {
             switch (_f.label) {
@@ -117,8 +117,8 @@ var openaiLLMIntegration = function (client, config) {
                                             })];
                                     case 1:
                                         _a = _r.sent(), messages = _a.messages, system = _a.system;
-                                        if (toolInteractions.exhausted) {
-                                            limitMessage = (_f = (_e = config === null || config === void 0 ? void 0 : config.toolLimitPrompt) === null || _e === void 0 ? void 0 : _e.call(config, toolInteractions)) !== null && _f !== void 0 ? _f : prompts_1.DEFAULT_TOOL_LIMIT_PROMPT;
+                                        if (agentCycles.exhausted) {
+                                            limitMessage = (_f = (_e = config === null || config === void 0 ? void 0 : config.toolLimitPrompt) === null || _e === void 0 ? void 0 : _e.call(config, agentCycles)) !== null && _f !== void 0 ? _f : prompts_1.DEFAULT_TOOL_LIMIT_PROMPT;
                                             messages.push({
                                                 role: 'user',
                                                 content: {

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

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

package/dist/Integrations/types.d.ts

@@ -1,4 +1,4 @@
-import type z from 'zod';
+import z from 'zod';
 import type { AgentEventStreamer } from '../Agent/stream/types';
 import type { AgentLLMContext, AgentMessage, AgentToolCallContent, AgentToolDefinition } from '../Agent/types';
 import type { OtelInfoType, PromiseAble } from '../types';
@@ -24,11 +24,11 @@ export type AgentLLMIntegrationParam = {
     /** List of available tools. You must convert these to your provider's tool/function schema. */
     tools: AgentToolDefinition[];
     /**
-     * Tool loop limits.
+     * Agent loop limits.
      * If `exhausted` is true, you should inject a system instruction forcing the LLM to stop calling tools
      * and synthesize a final answer.
      */
-    toolInteractions: AgentLLMContext['toolInteractions'] & {
+    agentCycles: AgentLLMContext['toolInteractions'] & {
         exhausted: boolean;
     };
     /**
@@ -53,37 +53,111 @@ export type AgentLLMIntegrationParam = {
  * You must parse your provider's raw response (e.g. OpenAI `Choice`, Anthropic `ContentBlock`)
  * and normalize it into one of these three mutually exclusive types so the Agent Loop can act on it.
  */
-export type AgentLLMIntegrationOutput = {
+export declare const AgentLLMIntegrationOutputSchema: z.ZodIntersection<z.ZodObject<{
     /** Token metrics for observability/billing. */
-    usage: {
+    usage: z.ZodObject<{
+        tokens: z.ZodObject<{
+            prompt: z.ZodNumber;
+            completion: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            prompt: number;
+            completion: number;
+        }, {
+            prompt: number;
+            completion: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
         tokens: {
             prompt: number;
             completion: number;
         };
-    };
+    }, {
+        tokens: {
+            prompt: number;
+            completion: number;
+        };
+    }>;
     /**
      * A standardized cost metric for Arvo's throttling/billing (e.g. 1 unit = 1 input token).
      * You define the calculation logic in your integration.
      */
+    executionUnits: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    usage: {
+        tokens: {
+            prompt: number;
+            completion: number;
+        };
+    };
     executionUnits: number;
-} & ({
+}, {
+    usage: {
+        tokens: {
+            prompt: number;
+            completion: number;
+        };
+    };
+    executionUnits: number;
+}>, z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     /** The LLM wants to execute tools. */
-    type: 'tool_call';
-    toolRequests: Omit<AgentToolCallContent, 'type'>[];
-} | {
+    type: z.ZodLiteral<"tool_call">;
+    toolRequests: z.ZodArray<z.ZodObject<Omit<{
+        type: z.ZodLiteral<"tool_use">;
+        toolUseId: z.ZodString;
+        name: z.ZodString;
+        input: z.ZodRecord<z.ZodString, z.ZodAny>;
+    }, "type">, "strip", z.ZodTypeAny, {
+        toolUseId: string;
+        name: string;
+        input: Record<string, any>;
+    }, {
+        toolUseId: string;
+        name: string;
+        input: Record<string, any>;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "tool_call";
+    toolRequests: {
+        toolUseId: string;
+        name: string;
+        input: Record<string, any>;
+    }[];
+}, {
+    type: "tool_call";
+    toolRequests: {
+        toolUseId: string;
+        name: string;
+        input: Record<string, any>;
+    }[];
+}>, z.ZodObject<{
     /** The LLM responded with conversational text. */
-    type: 'text';
+    type: z.ZodLiteral<"text">;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "text";
     content: string;
-} | {
+}, {
+    type: "text";
+    content: string;
+}>, z.ZodObject<{
     /**
      * The LLM responded with Structured JSON (requested via `outputFormat`).
      * `parsedContent` must be the valid JS object result of parsing `content`.
      * You can use `tryParseJson` utility from `@arvo-tools/agentic`
      */
-    type: 'json';
+    type: z.ZodLiteral<"json">;
+    content: z.ZodString;
+    parsedContent: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "json";
+    content: string;
+    parsedContent: Record<string, unknown> | null;
+}, {
+    type: "json";
     content: string;
     parsedContent: Record<string, unknown> | null;
-});
+}>]>>;
+export type AgentLLMIntegrationOutput = z.infer<typeof AgentLLMIntegrationOutputSchema>;
 /**
  * Interface for an LLM Provider Adapter function.
  *
@@ -121,7 +195,7 @@ export type CommonIntegrationConfig = {
      * 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;
+    toolLimitPrompt?: (toolInteractions: AgentLLMIntegrationParam['agentCycles']) => string;
     /**
      * An optional interceptor to transform messages or system instructions immediately before the LLM call.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/Integrations/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/Integrations/types.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,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,WAAW,EAAE,eAAe,CAAC,kBAAkB,CAAC,GAAG;QACjD,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,eAAO,MAAM,+BAA+B;IAExC,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;IAO/C;;;OAGG;;;;;;;;;;;;;;;;;;;IAKD,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAKtC,kDAAkD;;;;;;;;;;IAKlD;;;;OAIG;;;;;;;;;;;;KAMR,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;;;;;;;;;;;;;;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,aAAa,CAAC,KAAK,MAAM,CAAC;IAExF;;;;;;;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;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC;IAC1D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,WAAW,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,CAAC;CACxD,CAAC"}

package/dist/Integrations/types.js

@@ -1,3 +1,50 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentLLMIntegrationOutputSchema = void 0;
+var zod_1 = __importDefault(require("zod"));
+var schema_1 = require("../Agent/schema");
+/**
+ * The normalized response object your Custom Integration must return.
+ *
+ * You must parse your provider's raw response (e.g. OpenAI `Choice`, Anthropic `ContentBlock`)
+ * and normalize it into one of these three mutually exclusive types so the Agent Loop can act on it.
+ */
+exports.AgentLLMIntegrationOutputSchema = zod_1.default.intersection(zod_1.default.object({
+    /** Token metrics for observability/billing. */
+    usage: zod_1.default.object({
+        tokens: zod_1.default.object({
+            prompt: zod_1.default.number(),
+            completion: zod_1.default.number(),
+        }),
+    }),
+    /**
+     * A standardized cost metric for Arvo's throttling/billing (e.g. 1 unit = 1 input token).
+     * You define the calculation logic in your integration.
+     */
+    executionUnits: zod_1.default.number(),
+}), zod_1.default.discriminatedUnion('type', [
+    zod_1.default.object({
+        /** The LLM wants to execute tools. */
+        type: zod_1.default.literal('tool_call'),
+        toolRequests: schema_1.AgentToolCallContentSchema.omit({ type: true }).array(),
+    }),
+    zod_1.default.object({
+        /** The LLM responded with conversational text. */
+        type: zod_1.default.literal('text'),
+        content: zod_1.default.string(),
+    }),
+    zod_1.default.object({
+        /**
+         * The LLM responded with Structured JSON (requested via `outputFormat`).
+         * `parsedContent` must be the valid JS object result of parsing `content`.
+         * You can use `tryParseJson` utility from `@arvo-tools/agentic`
+         */
+        type: zod_1.default.literal('json'),
+        content: zod_1.default.string(),
+        parsedContent: zod_1.default.record(zod_1.default.string(), zod_1.default.unknown()).nullable(),
+    }),
+]));
 //# sourceMappingURL=types.js.map

package/dist/Integrations/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/Integrations/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/Integrations/types.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AACpB,0CAA6D;AAgE7D;;;;;GAKG;AACU,QAAA,+BAA+B,GAAG,aAAC,CAAC,YAAY,CAC3D,aAAC,CAAC,MAAM,CAAC;IACP,+CAA+C;IAC/C,KAAK,EAAE,aAAC,CAAC,MAAM,CAAC;QACd,MAAM,EAAE,aAAC,CAAC,MAAM,CAAC;YACf,MAAM,EAAE,aAAC,CAAC,MAAM,EAAE;YAClB,UAAU,EAAE,aAAC,CAAC,MAAM,EAAE;SACvB,CAAC;KACH,CAAC;IACF;;;OAGG;IACH,cAAc,EAAE,aAAC,CAAC,MAAM,EAAE;CAC3B,CAAC,EACF,aAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC3B,aAAC,CAAC,MAAM,CAAC;QACP,sCAAsC;QACtC,IAAI,EAAE,aAAC,CAAC,OAAO,CAAC,WAAW,CAAC;QAC5B,YAAY,EAAE,mCAA0B,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE;KACtE,CAAC;IACF,aAAC,CAAC,MAAM,CAAC;QACP,kDAAkD;QAClD,IAAI,EAAE,aAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACvB,OAAO,EAAE,aAAC,CAAC,MAAM,EAAE;KACpB,CAAC;IACF,aAAC,CAAC,MAAM,CAAC;QACP;;;;WAIG;QACH,IAAI,EAAE,aAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACvB,OAAO,EAAE,aAAC,CAAC,MAAM,EAAE;QACnB,aAAa,EAAE,aAAC,CAAC,MAAM,CAAC,aAAC,CAAC,MAAM,EAAE,EAAE,aAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;KAC5D,CAAC;CACH,CAAC,CACH,CAAC"}

package/dist/SimplePermissionManager/contract.d.ts

@@ -14,13 +14,13 @@ export declare const simplePermissionContract: import("arvo-core").SimpleArvoCon
                 kind: z.ZodString;
                 requests: z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
             }, "strip", z.ZodTypeAny, {
-                kind: string;
                 name: string;
+                kind: string;
                 originalName: string;
                 requests: Record<string, any>[] | null;
             }, {
-                kind: string;
                 name: string;
+                kind: string;
                 originalName: string;
                 requests: Record<string, any>[] | null;
             }>>;
@@ -29,8 +29,8 @@ export declare const simplePermissionContract: import("arvo-core").SimpleArvoCon
             requestedTools: string[];
             reason: string;
             toolMetaData: Record<string, {
-                kind: string;
                 name: string;
+                kind: string;
                 originalName: string;
                 requests: Record<string, any>[] | null;
             }>;
@@ -39,8 +39,8 @@ export declare const simplePermissionContract: import("arvo-core").SimpleArvoCon
             requestedTools: string[];
             reason: string;
             toolMetaData: Record<string, {
-                kind: string;
                 name: string;
+                kind: string;
                 originalName: string;
                 requests: Record<string, any>[] | null;
             }>;

package/dist/SimplePermissionManager/index.d.ts

@@ -37,13 +37,13 @@ export declare class SimplePermissionManager implements IPermissionManager<Versi
                     kind: import("zod").ZodString;
                     requests: import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>, "many">>;
                 }, "strip", import("zod").ZodTypeAny, {
-                    kind: string;
                     name: string;
+                    kind: string;
                     originalName: string;
                     requests: Record<string, any>[] | null;
                 }, {
-                    kind: string;
                     name: string;
+                    kind: string;
                     originalName: string;
                     requests: Record<string, any>[] | null;
                 }>>;
@@ -52,8 +52,8 @@ export declare class SimplePermissionManager implements IPermissionManager<Versi
                 requestedTools: string[];
                 reason: string;
                 toolMetaData: Record<string, {
-                    kind: string;
                     name: string;
+                    kind: string;
                     originalName: string;
                     requests: Record<string, any>[] | null;
                 }>;
@@ -62,8 +62,8 @@ export declare class SimplePermissionManager implements IPermissionManager<Versi
                 requestedTools: string[];
                 reason: string;
                 toolMetaData: Record<string, {
-                    kind: string;
                     name: string;
+                    kind: string;
                     originalName: string;
                     requests: Record<string, any>[] | null;
                 }>;
@@ -95,13 +95,13 @@ export declare class SimplePermissionManager implements IPermissionManager<Versi
                     kind: import("zod").ZodString;
                     requests: import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>, "many">>;
                 }, "strip", import("zod").ZodTypeAny, {
-                    kind: string;
                     name: string;
+                    kind: string;
                     originalName: string;
                     requests: Record<string, any>[] | null;
                 }, {
-                    kind: string;
                     name: string;
+                    kind: string;
                     originalName: string;
                     requests: Record<string, any>[] | null;
                 }>>;
@@ -110,8 +110,8 @@ export declare class SimplePermissionManager implements IPermissionManager<Versi
                 requestedTools: string[];
                 reason: string;
                 toolMetaData: Record<string, {
-                    kind: string;
                     name: string;
+                    kind: string;
                     originalName: string;
                     requests: Record<string, any>[] | null;
                 }>;
@@ -120,8 +120,8 @@ export declare class SimplePermissionManager implements IPermissionManager<Versi
                 requestedTools: string[];
                 reason: string;
                 toolMetaData: Record<string, {
-                    kind: string;
                     name: string;
+                    kind: string;
                     originalName: string;
                     requests: Record<string, any>[] | null;
                 }>;
@@ -161,13 +161,13 @@ export declare class SimplePermissionManager implements IPermissionManager<Versi
                     kind: import("zod").ZodString;
                     requests: import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>, "many">>;
                 }, "strip", import("zod").ZodTypeAny, {
-                    kind: string;
                     name: string;
+                    kind: string;
                     originalName: string;
                     requests: Record<string, any>[] | null;
                 }, {
-                    kind: string;
                     name: string;
+                    kind: string;
                     originalName: string;
                     requests: Record<string, any>[] | null;
                 }>>;
@@ -176,8 +176,8 @@ export declare class SimplePermissionManager implements IPermissionManager<Versi
                 requestedTools: string[];
                 reason: string;
                 toolMetaData: Record<string, {
-                    kind: string;
                     name: string;
+                    kind: string;
                     originalName: string;
                     requests: Record<string, any>[] | null;
                 }>;
@@ -186,8 +186,8 @@ export declare class SimplePermissionManager implements IPermissionManager<Versi
                 requestedTools: string[];
                 reason: string;
                 toolMetaData: Record<string, {
-                    kind: string;
                     name: string;
+                    kind: string;
                     originalName: string;
                     requests: Record<string, any>[] | null;
                 }>;

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 export * as Anthropic from '@anthropic-ai/sdk';
 export * as OpenAI from 'openai';
-export { AgentState, createArvoAgent } from './Agent';
+export { createArvoAgent } from './Agent';
 export { AgentDefaults } from './Agent/AgentDefaults';
-export { AgentMediaContentSchema, AgentMessageContentSchema, AgentMessageSchema, AgentTextContentSchema, AgentToolCallContentSchema, AgentToolResultContentSchema, } from './Agent/schema';
+export { AgentMediaContentSchema, AgentMessageContentSchema, AgentMessageSchema, AgentStateSchema, AgentTextContentSchema, AgentToolCallContentSchema, AgentToolResultContentSchema, } from './Agent/schema';
 export { AgentStreamEventSchema } from './Agent/stream/schema';
 export type { 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 type { AgentContextBuilder, AgentInferenceConfiguration, AgentLLMContext, AgentMediaContent, AgentMessage, AgentMessageContent, AgentOutputBuilder, AgentServiceContract, AgentState, AgentTextContent, AgentToolCallContent, AgentToolDefinition, AgentToolResultContent, AnyArvoContract, AnyArvoOrchestratorContract, CreateArvoAgentParam, PostInferenceHook, PreInferenceHook, } from './Agent/types';
 export { setOpenInferenceInputAttr, setOpenInferenceResponseOutputAttr, setOpenInferenceToolCallOutputAttr, setOpenInferenceUsageOutputAttr, tryParseJson, } from './Agent/utils';
 export { createAgentTool } from './AgentTool';
 export type { AgentInternalTool } from './AgentTool/types';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,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,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,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,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,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,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,YAAY,EACV,mBAAmB,EACnB,2BAA2B,EAC3B,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,2BAA2B,EAC3B,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,GACjB,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,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SimplePermissionManager = 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 = exports.OpenAI = exports.Anthropic = void 0;
+exports.SimplePermissionManager = 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.AgentStateSchema = exports.AgentMessageSchema = exports.AgentMessageContentSchema = exports.AgentMediaContentSchema = exports.AgentDefaults = exports.createArvoAgent = exports.OpenAI = exports.Anthropic = void 0;
 exports.Anthropic = __importStar(require("@anthropic-ai/sdk"));
 exports.OpenAI = __importStar(require("openai"));
 var Agent_1 = require("./Agent");
@@ -44,6 +44,7 @@ var schema_1 = require("./Agent/schema");
 Object.defineProperty(exports, "AgentMediaContentSchema", { enumerable: true, get: function () { return schema_1.AgentMediaContentSchema; } });
 Object.defineProperty(exports, "AgentMessageContentSchema", { enumerable: true, get: function () { return schema_1.AgentMessageContentSchema; } });
 Object.defineProperty(exports, "AgentMessageSchema", { enumerable: true, get: function () { return schema_1.AgentMessageSchema; } });
+Object.defineProperty(exports, "AgentStateSchema", { enumerable: true, get: function () { return schema_1.AgentStateSchema; } });
 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; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+DAA+C;AAC/C,iDAAiC;AACjC,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;AAQlC,qEAAoE;AAA3D,kIAAA,uBAAuB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+DAA+C;AAC/C,iDAAiC;AACjC,iCAA0C;AAAjC,wGAAA,eAAe,OAAA;AACxB,uDAAsD;AAA7C,8GAAA,aAAa,OAAA;AACtB,yCAQwB;AAPtB,iHAAA,uBAAuB,OAAA;AACvB,mHAAA,yBAAyB,OAAA;AACzB,4GAAA,kBAAkB,OAAA;AAClB,0GAAA,gBAAgB,OAAA;AAChB,gHAAA,sBAAsB,OAAA;AACtB,oHAAA,0BAA0B,OAAA;AAC1B,sHAAA,4BAA4B,OAAA;AAE9B,gDAA+D;AAAtD,gHAAA,sBAAsB,OAAA;AAsB/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;AAQlC,qEAAoE;AAA3D,kIAAA,uBAAuB,OAAA"}