@arvo-tools/agentic 1.2.17 → 2.0.0

package/dist/Agent/AgentDefaults.d.ts

@@ -95,7 +95,10 @@ export declare const AgentDefaults: {
      * )
      * ```
      */
-    readonly CONTEXT_BUILDER: <T extends AnyArvoOrchestratorContract, V extends ArvoSemanticVersion, TServiceContract extends Record<string, AgentServiceContract>, TTools extends Record<string, AgentInternalTool>>(systemPromptBuilder?: (param: Parameters<AgentContextBuilder<T, V, TServiceContract, TTools>>[0]) => PromiseAble<string>) => AgentContextBuilder<T, V, TServiceContract, TTools>;
+    readonly CONTEXT_BUILDER: <T extends AnyArvoOrchestratorContract, V extends ArvoSemanticVersion, TServiceContract extends Record<string, AgentServiceContract>, TTools extends Record<string, AgentInternalTool>>(systemPromptBuilder?: (param: Parameters<AgentContextBuilder<T, V, TServiceContract, TTools>>[0]) => PromiseAble<string | {
+        system: string;
+        enabledTools?: Record<string, boolean>;
+    }>) => AgentContextBuilder<T, V, TServiceContract, TTools>;
     /**
      * Default output builder validating agent responses against contract schemas.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"AgentDefaults.d.ts","sourceRoot":"","sources":["../../src/Agent/AgentDefaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErD,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EACV,mBAAmB,EAEnB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GAAI,kBAAkB,MAAM,EAAE,8CAarD,CAAC;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;IACxB;;;;OAIG;;;;;;;;IAIH;;;;;;;;;;;OAWG;;;;;;;;;;;;;;IAgBH;;;;OAIG;;;;;;;;IAIH;;;;;;;;;;;;;;;;;;;;OAoBG;+BAGC,CAAC,SAAS,2BAA2B,EACrC,CAAC,SAAS,mBAAmB,EAC7B,gBAAgB,SAAS,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAC7D,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,wBAE1B,CACpB,KAAK,EAAE,UAAU,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KACtE,WAAW,CAAC,MAAM,CAAC,KACvB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC;IAiDxD;;;;;;;;;;;OAWG;6BAcG,kBAAkB;CAChB,CAAC"}
+{"version":3,"file":"AgentDefaults.d.ts","sourceRoot":"","sources":["../../src/Agent/AgentDefaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErD,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EACV,mBAAmB,EAEnB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GAAI,kBAAkB,MAAM,EAAE,8CAarD,CAAC;AAsBJ;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;IACxB;;;;OAIG;;;;;;;;IAEH;;;;;;;;;;;OAWG;;;;;;;;;;;;;;IAEH;;;;OAIG;;;;;;;;IAIH;;;;;;;;;;;;;;;;;;;;OAoBG;+BAGC,CAAC,SAAS,2BAA2B,EACrC,CAAC,SAAS,mBAAmB,EAC7B,gBAAgB,SAAS,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAC7D,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,wBAE1B,CACpB,KAAK,EAAE,UAAU,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KACtE,WAAW,CAAC,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,KACpF,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC;IAyExD;;;;;;;;;;;OAWG;6BAcG,kBAAkB;CAChB,CAAC"}

package/dist/Agent/AgentDefaults.js

@@ -1,4 +1,15 @@
 "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) {
@@ -81,6 +92,20 @@ var dataUrlString = function (allowedMimeTypes) {
     });
 };
 exports.dataUrlString = dataUrlString;
+var initSchema = zod_1.default.object({
+    message: zod_1.default.string().describe('The input message to the agent'),
+});
+var initMultiModalSchema = zod_1.default.object({
+    message: zod_1.default.string().describe('The input message to the agent'),
+    imageBase64: (0, exports.dataUrlString)(['image/jpeg', 'image/png', 'image/gif', 'image/webp'])
+        .array()
+        .optional()
+        .describe('An optional list of base64 image strings to read. An AI Agent must not send data via this field'),
+    pdfBase64: (0, exports.dataUrlString)(['application/pdf'])
+        .array()
+        .optional()
+        .describe('An optional list of base64 pdfs to read. An AI Agent must not send data via this field'),
+});
 /**
  * Default schemas and builders for common agent patterns.
  *
@@ -94,9 +119,7 @@ exports.AgentDefaults = {
      *
      * Use for basic conversational agents that only need text input.
      */
-    INIT_SCHEMA: zod_1.default.object({
-        message: zod_1.default.string().describe('The input message to the agent'),
-    }),
+    INIT_SCHEMA: initSchema,
     /**
      * Multimodal initialization schema supporting text, images, and PDFs.
      *
@@ -109,17 +132,7 @@ exports.AgentDefaults = {
      * The media masking optimization automatically replaces viewed media with
      * placeholder text in subsequent LLM calls to reduce token consumption.
      */
-    INIT_MULTIMODAL_SCHEMA: zod_1.default.object({
-        message: zod_1.default.string().describe('The input message to the agent'),
-        imageBase64: (0, exports.dataUrlString)(['image/jpeg', 'image/png', 'image/gif', 'image/webp'])
-            .array()
-            .optional()
-            .describe('An optional list of base64 image strings to read. An AI Agent must not send data via this field'),
-        pdfBase64: (0, exports.dataUrlString)(['application/pdf'])
-            .array()
-            .optional()
-            .describe('An optional list of base64 pdfs to read. An AI Agent must not send data via this field'),
-    }),
+    INIT_MULTIMODAL_SCHEMA: initMultiModalSchema,
     /**
      * Default completion schema outputting a simple text response.
      *
@@ -151,76 +164,100 @@ exports.AgentDefaults = {
      */
     CONTEXT_BUILDER: function (systemPromptBuilder) {
         return function (param) { return __awaiter(void 0, void 0, void 0, function () {
-            var messages, _a, _b, item, _c, _d, item;
-            var e_1, _e, e_2, _f, _g;
-            var _h, _j, _k;
-            return __generator(this, function (_l) {
-                switch (_l.label) {
+            var messages, _a, _b, item, _c, _d, item, result;
+            var e_1, _e, e_2, _f;
+            var _g, _h, _j;
+            return __generator(this, function (_k) {
+                switch (_k.label) {
                     case 0:
-                        messages = [
-                            {
-                                role: 'user',
-                                content: { type: 'text', content: param.input.data.message },
-                                seenCount: 0,
-                            },
-                        ];
-                        try {
-                            for (_a = __values((_h = param.input.data.pdfBase64) !== null && _h !== void 0 ? _h : []), _b = _a.next(); !_b.done; _b = _a.next()) {
-                                item = _b.value;
-                                messages.push({
-                                    seenCount: 0,
+                        messages = [];
+                        if (initMultiModalSchema.safeParse(param.input.data).success) {
+                            messages = [
+                                {
                                     role: 'user',
-                                    content: {
-                                        type: 'media',
-                                        content: item,
-                                        contentType: {
-                                            format: 'base64',
-                                            type: 'file',
-                                            name: "".concat((0, uuid_1.v4)(), ".pdf"),
-                                            mediatype: 'application/pdf',
+                                    content: { type: 'text', content: param.input.data.message },
+                                    seenCount: 0,
+                                },
+                            ];
+                            try {
+                                for (_a = __values((_g = param.input.data.pdfBase64) !== null && _g !== void 0 ? _g : []), _b = _a.next(); !_b.done; _b = _a.next()) {
+                                    item = _b.value;
+                                    messages.push({
+                                        seenCount: 0,
+                                        role: 'user',
+                                        content: {
+                                            type: 'media',
+                                            content: item,
+                                            contentType: {
+                                                format: 'base64',
+                                                type: 'file',
+                                                name: "".concat((0, uuid_1.v4)(), ".pdf"),
+                                                mediatype: 'application/pdf',
+                                            },
                                         },
-                                    },
-                                });
+                                    });
+                                }
+                            }
+                            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                            finally {
+                                try {
+                                    if (_b && !_b.done && (_e = _a.return)) _e.call(_a);
+                                }
+                                finally { if (e_1) throw e_1.error; }
                             }
-                        }
-                        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-                        finally {
                             try {
-                                if (_b && !_b.done && (_e = _a.return)) _e.call(_a);
+                                for (_c = __values((_h = param.input.data.imageBase64) !== null && _h !== void 0 ? _h : []), _d = _c.next(); !_d.done; _d = _c.next()) {
+                                    item = _d.value;
+                                    messages.push({
+                                        seenCount: 0,
+                                        role: 'user',
+                                        content: {
+                                            type: 'media',
+                                            content: item,
+                                            contentType: {
+                                                format: 'base64',
+                                                type: 'image',
+                                                name: "".concat((0, uuid_1.v4)(), ".png"),
+                                                mediatype: 'image/png',
+                                            },
+                                        },
+                                    });
+                                }
+                            }
+                            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+                            finally {
+                                try {
+                                    if (_d && !_d.done && (_f = _c.return)) _f.call(_c);
+                                }
+                                finally { if (e_2) throw e_2.error; }
                             }
-                            finally { if (e_1) throw e_1.error; }
                         }
-                        try {
-                            for (_c = __values((_j = param.input.data.imageBase64) !== null && _j !== void 0 ? _j : []), _d = _c.next(); !_d.done; _d = _c.next()) {
-                                item = _d.value;
-                                messages.push({
-                                    seenCount: 0,
+                        else if (initSchema.safeParse(param.input.data).success) {
+                            messages = [
+                                {
                                     role: 'user',
-                                    content: {
-                                        type: 'media',
-                                        content: item,
-                                        contentType: {
-                                            format: 'base64',
-                                            type: 'image',
-                                            name: "".concat((0, uuid_1.v4)(), ".png"),
-                                            mediatype: 'image/png',
-                                        },
-                                    },
-                                });
-                            }
+                                    content: { type: 'text', content: param.input.data.message },
+                                    seenCount: 0,
+                                },
+                            ];
                         }
-                        catch (e_2_1) { e_2 = { error: e_2_1 }; }
-                        finally {
-                            try {
-                                if (_d && !_d.done && (_f = _c.return)) _f.call(_c);
-                            }
-                            finally { if (e_2) throw e_2.error; }
+                        else {
+                            messages = [
+                                {
+                                    role: 'user',
+                                    content: { type: 'text', content: JSON.stringify(param.input.data) },
+                                    seenCount: 0,
+                                },
+                            ];
                         }
-                        _g = {};
                         return [4 /*yield*/, (systemPromptBuilder === null || systemPromptBuilder === void 0 ? void 0 : systemPromptBuilder(param))];
-                    case 1: return [2 /*return*/, (_g.system = (_k = (_l.sent())) !== null && _k !== void 0 ? _k : null,
-                            _g.messages = messages,
-                            _g)];
+                    case 1:
+                        result = (_j = (_k.sent())) !== null && _j !== void 0 ? _j : null;
+                        if (result === null)
+                            return [2 /*return*/, { messages: messages }];
+                        if (typeof result === 'string')
+                            return [2 /*return*/, { system: result, messages: messages }];
+                        return [2 /*return*/, __assign(__assign({}, result), { messages: messages })];
                 }
             });
         }); };

package/dist/Agent/AgentDefaults.js.map

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

package/dist/Agent/agentLoop.d.ts

@@ -1,5 +1,5 @@
 import type z from 'zod';
-import type { AgentLLMIntegration, AgentLLMIntegrationParam } from '../Integrations/types.js';
+import type { AgentLLMIntegrationParam } from '../Integrations/types.js';
 import type { IMCPClient } from '../interfaces.mcp.js';
 import type { IPermissionManager, PermissionManagerContext } from '../interfaces.permission.manager.js';
 import type { OtelInfoType } from '../types.js';
@@ -30,10 +30,12 @@ export declare const agentLoop: (param: {
     tools: AgentToolDefinition[];
     outputFormat: z.ZodTypeAny;
     outputBuilder: AgentOutputBuilder;
-    llmResponseType: NonNullable<CreateArvoAgentParam["llmResponseType"]>;
-    llm: AgentLLMIntegration;
+    llmResponseType: NonNullable<NonNullable<CreateArvoAgentParam["inferenceConfig"]>["responseType"]>;
+    llm: NonNullable<NonNullable<CreateArvoAgentParam["inferenceConfig"]>["llm"]>;
+    preInferenceHook: NonNullable<NonNullable<NonNullable<CreateArvoAgentParam["inferenceConfig"]>["hooks"]>["preInference"]> | null;
+    postInferenceHook: NonNullable<NonNullable<NonNullable<CreateArvoAgentParam["inferenceConfig"]>["hooks"]>["postInference"]> | null;
     mcp: IMCPClient | null;
-    toolInteraction: {
+    agentCycles: {
         current: number;
         max: number;
     };
@@ -51,6 +53,10 @@ export declare const agentLoop: (param: {
 }) => Promise<{
     messages: {
         content: {
+            type: "tool_result";
+            toolUseId: string;
+            content: string;
+        } | {
             type: "text";
             content: string;
         } | {
@@ -67,14 +73,10 @@ export declare const agentLoop: (param: {
                 mediatype: string;
                 format: "base64";
             };
-        } | {
-            type: "tool_result";
-            content: string;
-            toolUseId: string;
         } | {
             type: "tool_use";
-            name: string;
             toolUseId: string;
+            name: string;
             input: Record<string, any>;
         };
         role: "user" | "assistant";
@@ -82,11 +84,11 @@ export declare const agentLoop: (param: {
     }[];
     toolCalls: {
         type: "tool_use";
-        name: string;
         toolUseId: string;
+        name: string;
         input: Record<string, any>;
     }[];
-    toolInteractions: {
+    agentCycles: {
         current: number;
         max: number;
     };
@@ -99,6 +101,10 @@ export declare const agentLoop: (param: {
 } | {
     messages: {
         content: {
+            type: "tool_result";
+            toolUseId: string;
+            content: string;
+        } | {
             type: "text";
             content: string;
         } | {
@@ -115,14 +121,10 @@ export declare const agentLoop: (param: {
                 mediatype: string;
                 format: "base64";
             };
-        } | {
-            type: "tool_result";
-            content: string;
-            toolUseId: string;
         } | {
             type: "tool_use";
-            name: string;
             toolUseId: string;
+            name: string;
             input: Record<string, any>;
         };
         role: "user" | "assistant";
@@ -134,7 +136,7 @@ export declare const agentLoop: (param: {
         __id?: import("arvo-core").CreateArvoEvent<Record<string, unknown>, string>["id"];
         __executionunits?: import("arvo-core").CreateArvoEvent<Record<string, unknown>, string>["executionunits"];
     };
-    toolInteractions: {
+    agentCycles: {
         current: number;
         max: number;
     };

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

@@ -1 +1 @@
-{"version":3,"file":"agentLoop.d.ts","sourceRoot":"","sources":["../../src/Agent/agentLoop.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAC9F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EAEzB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAElB,mBAAmB,EAGnB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAGpB;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,SAAS,GACpB,OAAO;IACL,aAAa,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,YAAY,EAAE,CAAC,CAAC,UAAU,CAAC;IAC3B,aAAa,EAAE,kBAAkB,CAAC;IAClC,eAAe,EAAE,WAAW,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACtE,GAAG,EAAE,mBAAmB,CAAC;IACzB,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,0BAA0B,EAAE,MAAM,CAAC;IACnC,uBAAuB,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC7C,wBAAwB,EAAE,wBAAwB,CAAC;CACpD,EACD,QAAQ;IAAE,QAAQ,EAAE,YAAY,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBARtB,MAAM;oBACF,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBADV,MAAM;oBACF,MAAM;;;EA0gBpB,CAAC"}
+{"version":3,"file":"agentLoop.d.ts","sourceRoot":"","sources":["../../src/Agent/agentLoop.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EAEzB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAElB,mBAAmB,EAGnB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAGpB;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,SAAS,GACpB,OAAO;IACL,aAAa,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,YAAY,EAAE,CAAC,CAAC,UAAU,CAAC;IAC3B,aAAa,EAAE,kBAAkB,CAAC;IAClC,eAAe,EAAE,WAAW,CAC1B,WAAW,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,CAAC,cAAc,CAAC,CACrE,CAAC;IACF,GAAG,EAAE,WAAW,CAAC,WAAW,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9E,gBAAgB,EAAE,WAAW,CAC3B,WAAW,CAAC,WAAW,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAC3F,GAAG,IAAI,CAAC;IACT,iBAAiB,EAAE,WAAW,CAC5B,WAAW,CAAC,WAAW,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAC5F,GAAG,IAAI,CAAC;IACT,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,0BAA0B,EAAE,MAAM,CAAC;IACnC,uBAAuB,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC7C,wBAAwB,EAAE,wBAAwB,CAAC;CACpD,EACD,QAAQ;IAAE,QAAQ,EAAE,YAAY,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBARtB,MAAM;oBACF,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBADV,MAAM;oBACF,MAAM;;;EA+nBpB,CAAC"}