@arvo-tools/agentic 0.2.0 → 0.3.0

package/dist/Agent/AgentDefaults.d.ts

@@ -0,0 +1,28 @@
+import type { ArvoSemanticVersion } from 'arvo-core';
+import z from 'zod';
+import type { AgentContextBuilder, AgentInternalTool, AgentOutputBuilder, AgentServiceContract, AnyArvoOrchestratorContract, PromiseLike } from './types.js';
+export declare const AgentDefaults: {
+    readonly INIT_SCHEMA: z.ZodObject<{
+        message: z.ZodString;
+        imageBase64: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        pdfBase64: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        imageBase64?: string[] | undefined;
+        pdfBase64?: string[] | undefined;
+    }, {
+        message: string;
+        imageBase64?: string[] | undefined;
+        pdfBase64?: string[] | undefined;
+    }>;
+    readonly COMPLETE_SCHEMA: z.ZodObject<{
+        response: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        response: string;
+    }, {
+        response: string;
+    }>;
+    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]) => PromiseLike<string>) => AgentContextBuilder<T, V, TServiceContract, TTools>;
+    readonly OUTPUT_BUILDER: AgentOutputBuilder;
+};
+//# sourceMappingURL=AgentDefaults.d.ts.map

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

@@ -0,0 +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,EACV,mBAAmB,EACnB,iBAAiB,EAEjB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;+BAqBpB,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;6BAoDlD,kBAAkB;CAChB,CAAC"}

package/dist/Agent/AgentDefaults.js

@@ -0,0 +1,154 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentDefaults = void 0;
+var uuid_1 = require("uuid");
+var zod_1 = __importDefault(require("zod"));
+exports.AgentDefaults = {
+    INIT_SCHEMA: zod_1.default.object({
+        message: zod_1.default.string().describe('The input message to the agent'),
+        imageBase64: zod_1.default
+            .string()
+            .array()
+            .optional()
+            .describe('An optional list of base64 image strings to read. Must not be added by an AI Agent'),
+        pdfBase64: zod_1.default
+            .string()
+            .array()
+            .optional()
+            .describe('An optional list of base64 pngs to read. Must not be added by an AI Agent'),
+    }),
+    COMPLETE_SCHEMA: zod_1.default.object({
+        response: zod_1.default.string().describe('The output response of the agent'),
+    }),
+    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) {
+                    case 0:
+                        messages = [
+                            {
+                                role: 'user',
+                                content: { type: 'text', content: param.input.data.message },
+                            },
+                        ];
+                        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({
+                                    role: 'user',
+                                    content: {
+                                        type: 'media',
+                                        content: item,
+                                        contentType: {
+                                            format: 'base64',
+                                            type: 'file',
+                                            filename: "".concat((0, uuid_1.v4)(), ".pdf"),
+                                            filetype: '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; }
+                        }
+                        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({
+                                    role: 'user',
+                                    content: {
+                                        type: 'media',
+                                        content: item,
+                                        contentType: {
+                                            format: 'base64',
+                                            type: 'image',
+                                            filename: "".concat((0, uuid_1.v4)(), ".png"),
+                                            filetype: '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; }
+                        }
+                        _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)];
+                }
+            });
+        }); };
+    },
+    OUTPUT_BUILDER: (function (param) {
+        return {
+            data: {
+                response: param.content,
+            },
+        };
+    }),
+};
+//# sourceMappingURL=AgentDefaults.js.map

package/dist/Agent/AgentDefaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentDefaults.js","sourceRoot":"","sources":["../../src/Agent/AgentDefaults.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,6BAA0B;AAC1B,4CAAoB;AAWP,QAAA,aAAa,GAAG;IAC3B,WAAW,EAAE,aAAC,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC9D,WAAW,EAAE,aAAC;aACX,MAAM,EAAE;aACR,KAAK,EAAE;aACP,QAAQ,EAAE;aACV,QAAQ,CACP,oFAAoF,CACrF;QACH,SAAS,EAAE,aAAC;aACT,MAAM,EAAE;aACR,KAAK,EAAE;aACP,QAAQ,EAAE;aACV,QAAQ,CAAC,2EAA2E,CAAC;KACzF,CAAC;IACF,eAAe,EAAE,aAAC,CAAC,MAAM,CAAC;QACxB,QAAQ,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;KAClE,CAAC;IACF,eAAe,EACb,UAME,mBAEwB;QAE1B,OAAA,UAAO,KAAK;;;;;;;wBACJ,QAAQ,GAAmB;4BAC/B;gCACE,IAAI,EAAE,MAAM;gCACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE;6BAC7D;yBACF,CAAC;;4BAEF,KAAmB,KAAA,SAAA,MAAA,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,mCAAI,EAAE,CAAA,4CAAE,CAAC;gCAA3C,IAAI;gCACb,QAAQ,CAAC,IAAI,CAAC;oCACZ,IAAI,EAAE,MAAM;oCACZ,OAAO,EAAE;wCACP,IAAI,EAAE,OAAO;wCACb,OAAO,EAAE,IAAI;wCACb,WAAW,EAAE;4CACX,MAAM,EAAE,QAAQ;4CAChB,IAAI,EAAE,MAAM;4CACZ,QAAQ,EAAE,UAAG,IAAA,SAAE,GAAE,SAAM;4CACvB,QAAQ,EAAE,KAAK;yCAChB;qCACF;iCACF,CAAC,CAAC;4BACL,CAAC;;;;;;;;;;4BAED,KAAmB,KAAA,SAAA,MAAA,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,mCAAI,EAAE,CAAA,4CAAE,CAAC;gCAA7C,IAAI;gCACb,QAAQ,CAAC,IAAI,CAAC;oCACZ,IAAI,EAAE,MAAM;oCACZ,OAAO,EAAE;wCACP,IAAI,EAAE,OAAO;wCACb,OAAO,EAAE,IAAI;wCACb,WAAW,EAAE;4CACX,MAAM,EAAE,QAAQ;4CAChB,IAAI,EAAE,OAAO;4CACb,QAAQ,EAAE,UAAG,IAAA,SAAE,GAAE,SAAM;4CACvB,QAAQ,EAAE,KAAK;yCAChB;qCACF;iCACF,CAAC,CAAC;4BACL,CAAC;;;;;;;;;;wBAGU,qBAAM,CAAA,mBAAmB,aAAnB,mBAAmB,uBAAnB,mBAAmB,CAAG,KAAK,CAAC,CAAA,EAAA;4BAD7C,uBACE,SAAM,GAAE,MAAA,CAAC,SAAkC,CAAC,mCAAI,IAAI;4BACpD,WAAQ,WAAA;iCACR;;;aACH;IA5CD,CA4CC;IACH,cAAc,EAAE,CAAC,UAAC,KAAK;QACrB,OAAO;YACL,IAAI,EAAE;gBACJ,QAAQ,EAAE,KAAK,CAAC,OAAO;aACxB;SACF,CAAC;IACJ,CAAC,CAAuB;CAChB,CAAC"}

package/dist/Agent/agentLoop.d.ts

@@ -0,0 +1,109 @@
+import type z from 'zod';
+import type { IMCPClient } from '../interfaces.mcp.js';
+import type { OtelInfoType } from '../types.js';
+import type { AgentLLMIntegration, AgentLLMIntegrationParam, AgentMessage, AgentOutputBuilder, AgentToolDefinition, CreateArvoAgentParam } from './types.js';
+export declare const agentLoop: (param: {
+    initLifecycle: AgentLLMIntegrationParam["lifecycle"];
+    system: string | null;
+    messages: AgentMessage[];
+    tools: AgentToolDefinition[];
+    outputFormat: z.ZodTypeAny;
+    outputBuilder: AgentOutputBuilder;
+    llmResponseType: NonNullable<CreateArvoAgentParam["llmResponseType"]>;
+    llm: AgentLLMIntegration;
+    mcp: IMCPClient | null;
+    toolInteraction: {
+        current: number;
+        max: number;
+    };
+    currentTotalExecutionUnits: number;
+}, config: {
+    otelInfo: OtelInfoType;
+}) => Promise<{
+    messages: {
+        content: {
+            type: "text";
+            content: string;
+        } | {
+            type: "media";
+            content: string;
+            contentType: {
+                type: "image";
+                filename: string;
+                filetype: string;
+                format: "base64";
+            } | {
+                type: "file";
+                filename: string;
+                filetype: string;
+                format: "base64";
+            };
+        } | {
+            type: "tool_result";
+            content: string;
+            toolUseId: string;
+        } | {
+            type: "tool_use";
+            toolUseId: string;
+            name: string;
+            input: Record<string, any>;
+        };
+        role: "user" | "assistant";
+    }[];
+    toolCalls: {
+        type: "tool_use";
+        toolUseId: string;
+        name: string;
+        input: Record<string, any>;
+    }[];
+    toolInteractions: {
+        current: number;
+        max: number;
+    };
+    executionUnits: number;
+    output?: undefined;
+} | {
+    messages: {
+        content: {
+            type: "text";
+            content: string;
+        } | {
+            type: "media";
+            content: string;
+            contentType: {
+                type: "image";
+                filename: string;
+                filetype: string;
+                format: "base64";
+            } | {
+                type: "file";
+                filename: string;
+                filetype: string;
+                format: "base64";
+            };
+        } | {
+            type: "tool_result";
+            content: string;
+            toolUseId: string;
+        } | {
+            type: "tool_use";
+            toolUseId: string;
+            name: string;
+            input: Record<string, any>;
+        };
+        role: "user" | "assistant";
+    }[];
+    output: {
+        [x: string]: any;
+    } & {
+        __id?: import("arvo-core").CreateArvoEvent<Record<string, unknown>, string>["id"];
+        __executionunits?: import("arvo-core").CreateArvoEvent<Record<string, unknown>, string>["executionunits"];
+    };
+    toolInteractions: {
+        current: number;
+        max: number;
+    };
+    executionUnits: number;
+    toolCalls?: undefined;
+}>;
+//# sourceMappingURL=agentLoop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentLoop.d.ts","sourceRoot":"","sources":["../../src/Agent/agentLoop.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAEV,mBAAmB,EACnB,wBAAwB,EACxB,YAAY,EACZ,kBAAkB,EAElB,mBAAmB,EAGnB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAGpB,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;CACpC,EACD,QAAQ;IAAE,QAAQ,EAAE,YAAY,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiPhC,CAAC"}