@ai.ntellect/core 0.7.14 → 0.8.0

package/dist/modules/nlp/engine.js

@@ -0,0 +1,300 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NLPEngine = void 0;
+const { dockStart } = require("@nlpjs/basic");
+/**
+ * NLP Engine for processing natural language commands
+ * @example
+ * const engine = await NLPEngine.create({
+ *   corpus: require('./corpus.json'),
+ *   responses: require('./responses.json'),
+ *   entities: require('./entities.json')
+ * });
+ *
+ * engine.addAction('transferTokens', async (data) => {
+ *   // Handle transfer logic
+ * });
+ *
+ * const response = await engine.process('transfer 5 ETH');
+ */
+class NLPEngine {
+    constructor() {
+        this.intentHandlers = {};
+        this.responses = {};
+    }
+    /**
+     * Creates and initializes a new NLP Engine
+     */
+    static create(config) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const engine = new NLPEngine();
+            yield engine.init(config);
+            return engine;
+        });
+    }
+    /**
+     * Initializes the NLP engine with configuration
+     */
+    init(_a) {
+        return __awaiter(this, arguments, void 0, function* ({ corpus, responses, entities, language = "en", threshold = 0.5, }) {
+            const dock = yield dockStart({
+                settings: {
+                    nlp: {
+                        forceNER: true,
+                        languages: [language],
+                        corpora: corpus ? [corpus] : undefined,
+                    },
+                    ner: { threshold },
+                },
+                use: ["Basic", "LangEn"],
+            });
+            this.manager = dock.get("nlp");
+            this.responses = responses || {};
+            if (corpus) {
+                yield this.manager.addCorpus(corpus);
+            }
+            if (entities) {
+                this.registerEntities(entities);
+            }
+            yield this.manager.train();
+        });
+    }
+    /**
+     * Registers entities for Named Entity Recognition (NER)
+     * @private
+     * @param {Record<string, any>} entities - Entity definitions
+     */
+    registerEntities(entities) {
+        Object.entries(entities).forEach(([name, data]) => {
+            if (data.options) {
+                Object.entries(data.options).forEach(([option, texts]) => {
+                    this.manager.addNerRuleOptionTexts("en", name, option, texts);
+                });
+            }
+            else if (data.regex) {
+                this.manager.addNerRegexRule("en", name, data.regex);
+            }
+            else if (data.trim) {
+                data.trim.forEach((trimRule) => {
+                    if (trimRule.position === "afterLast") {
+                        trimRule.words.forEach((word) => {
+                            this.manager.addNerAfterLastCondition("en", name, word);
+                        });
+                    }
+                    else if (trimRule.position === "betweenLast") {
+                        this.manager.addNerBetweenLastCondition("en", name, trimRule.leftWords, trimRule.rightWords);
+                    }
+                });
+            }
+        });
+    }
+    /**
+     * Adds an action handler for a specific intent
+     * @param {string} name - Intent name
+     * @param {ActionHandler} handler - Action handler function
+     */
+    addAction(name, handler) {
+        this.intentHandlers[name] = handler;
+    }
+    /**
+     * Creates and loads a pre-trained NLP Engine
+     */
+    static loadFromModel(modelPath, responses) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const engine = new NLPEngine();
+            engine.responses = responses || {};
+            yield engine.loadModel(modelPath);
+            return engine;
+        });
+    }
+    /**
+     * Loads a pre-trained model and configures default actions
+     */
+    loadModel(modelPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const dock = yield dockStart({
+                settings: {
+                    nlp: {
+                        forceNER: true,
+                        languages: ["en"],
+                    },
+                },
+                use: ["Basic", "LangEn"],
+            });
+            this.manager = dock.get("nlp");
+            yield this.manager.load(modelPath);
+            // Configure default actions handler
+            this.setupDefaultActions();
+        });
+    }
+    /**
+     * Setup default actions to handle responses
+     */
+    setupDefaultActions() {
+        this.manager.onIntent = (data) => __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            // Execute registered action if exists
+            if (((_a = data.actions) === null || _a === void 0 ? void 0 : _a.length) > 0) {
+                for (const actionData of data.actions) {
+                    const result = yield this.executeAction(actionData, data);
+                    if (result) {
+                        data.actionResult = result;
+                    }
+                }
+            }
+            // Format response if answer exists
+            if (data.answer && this.responses[data.answer]) {
+                data.jsonResponse = this.formatResponse(this.responses[data.answer], data.actionResult || {});
+            }
+            return data;
+        });
+    }
+    /**
+     * Execute a single action
+     */
+    executeAction(actionData, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { action, parameters } = actionData;
+            const handler = this.manager.actions[action];
+            if (handler) {
+                return handler(context);
+            }
+            return null;
+        });
+    }
+    /**
+     * Processes natural language input text
+     * @param {string} input - Input text to process
+     * @returns {Promise<any>} Processing result with intent, entities and response
+     */
+    process(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.manager.process("en", input);
+            console.log("NLP Engine Result:", result);
+            // Si une action est définie, exécuter le handler
+            if (result.intent) {
+                const handler = this.intentHandlers[result.intent.split(".")[1]];
+                if (handler) {
+                    const handlerResult = yield handler(result);
+                    return Object.assign(Object.assign({}, result), handlerResult);
+                }
+            }
+            return result;
+        });
+    }
+    /**
+     * Trains the NLP model with current corpus
+     * @returns {Promise<void>}
+     */
+    train() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.manager.train();
+        });
+    }
+    /**
+     * Exports the trained model
+     * @param {boolean} [minified=true] - Whether to minify the exported model
+     * @returns {string} Exported model as string
+     */
+    export(minified = true) {
+        return this.manager.export(minified);
+    }
+    /**
+     * Imports a previously trained model
+     * @param {string} data - Model data to import
+     */
+    import(data) {
+        this.manager.import(data);
+    }
+    /**
+     * Saves the current model to a file
+     * @param {string} [path='./model.json'] - Path to save the model
+     * @returns {Promise<void>}
+     */
+    saveModel() {
+        return __awaiter(this, arguments, void 0, function* (path = "./model.json") {
+            this.manager.save();
+            this.manager.save("./model.json");
+        });
+    }
+    /**
+     * Formats response using template and context
+     */
+    formatResponse(template, context) {
+        const response = JSON.parse(JSON.stringify(template));
+        // Format data fields
+        if (response.data) {
+            Object.keys(response.data).forEach((key) => {
+                if (context[key] !== undefined) {
+                    response.data[key] = context[key];
+                }
+            });
+        }
+        return response;
+    }
+    /**
+     * Gets entity value from NLP result
+     * @param {any} data - NLP processing result
+     * @param {string} entityName - Name of the entity to extract
+     * @returns {string|undefined} Entity value if found
+     */
+    getEntity(data, entityName) {
+        var _a;
+        const entity = (_a = data.entities) === null || _a === void 0 ? void 0 : _a.find((e) => e.entity === entityName);
+        return entity ? entity.utteranceText : undefined;
+    }
+    /**
+     * Gets entity option from NLP result
+     * @param {any} data - NLP processing result
+     * @param {string} entityName - Name of the entity to extract
+     * @returns {string|undefined} Entity option if found
+     */
+    getEntityOption(data, entityName) {
+        var _a;
+        const entity = (_a = data.entities) === null || _a === void 0 ? void 0 : _a.find((e) => e.entity === entityName);
+        return entity ? entity.option : undefined;
+    }
+    /**
+     * Gets recipient entity from NLP result
+     * @param {any} data - NLP processing result
+     * @returns {string|undefined} Recipient value if found
+     */
+    getRecipient(data) {
+        var _a;
+        const toEntity = (_a = data.entities) === null || _a === void 0 ? void 0 : _a.find((e) => e.entity === "to");
+        return toEntity ? toEntity.utteranceText : undefined;
+    }
+    /**
+     * Gets current responses configuration
+     * @returns {Record<string, any>} Current responses
+     */
+    getResponses() {
+        return this.responses;
+    }
+    /**
+     * Gets current corpus configuration
+     * @returns {any} Current corpus
+     */
+    getCorpus() {
+        return this.manager.corpora;
+    }
+    /**
+     * Gets current entities configuration
+     * @returns {any} Current entities configuration
+     */
+    getEntities() {
+        var _a;
+        return ((_a = this.manager.nerManager) === null || _a === void 0 ? void 0 : _a.rules) || {};
+    }
+}
+exports.NLPEngine = NLPEngine;
+//# sourceMappingURL=engine.js.map

package/dist/modules/nlp/engine.js.map

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

package/dist/modules/nlp/index.d.ts

@@ -0,0 +1,27 @@
+import { NLPNodeConfig } from "@/interfaces";
+import { ZodSchema } from "zod";
+/**
+ * NLPNode class handles natural language processing operations with type-safe schema validation
+ * @template T - Zod schema type for validation
+ */
+export declare class NLPNode<T extends ZodSchema> {
+    private config;
+    private engine;
+    /**
+     * Creates an instance of NLPNode
+     * @param {NLPNodeConfig<T>} config - Configuration object for the NLP node
+     */
+    constructor(config: NLPNodeConfig<T>);
+    /**
+     * Initializes the NLP engine and sets up intent handlers
+     * @returns {Promise<void>}
+     */
+    initialize(): Promise<void>;
+    /**
+     * Processes the input text through the NLP engine
+     * @param {string} input - Text to be processed
+     * @returns {Promise<any>} - Processing result from the engine
+     */
+    process(input: string): Promise<any>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/nlp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../modules/nlp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAGhC;;;GAGG;AACH,qBAAa,OAAO,CAAC,CAAC,SAAS,SAAS;IAO1B,OAAO,CAAC,MAAM;IAN1B,OAAO,CAAC,MAAM,CAAa;IAE3B;;;OAGG;gBACiB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAE5C;;;OAGG;IACG,UAAU;IAYhB;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM;CAM5B"}

package/dist/modules/nlp/index.js

@@ -0,0 +1,56 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NLPNode = void 0;
+const engine_1 = require("./engine");
+/**
+ * NLPNode class handles natural language processing operations with type-safe schema validation
+ * @template T - Zod schema type for validation
+ */
+class NLPNode {
+    /**
+     * Creates an instance of NLPNode
+     * @param {NLPNodeConfig<T>} config - Configuration object for the NLP node
+     */
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Initializes the NLP engine and sets up intent handlers
+     * @returns {Promise<void>}
+     */
+    initialize() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.engine = yield engine_1.NLPEngine.create(this.config.nlpConfig);
+            console.log("Loaded engine");
+            if (this.config.intentHandlers) {
+                Object.entries(this.config.intentHandlers).forEach(([intent, handler]) => {
+                    this.engine.addAction(intent, handler);
+                });
+            }
+        });
+    }
+    /**
+     * Processes the input text through the NLP engine
+     * @param {string} input - Text to be processed
+     * @returns {Promise<any>} - Processing result from the engine
+     */
+    process(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            console.log("NLP Node processing:", input);
+            const result = yield this.engine.process(input);
+            console.log("NLP Node result:", result);
+            return result;
+        });
+    }
+}
+exports.NLPNode = NLPNode;
+//# sourceMappingURL=index.js.map

package/dist/modules/nlp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../modules/nlp/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,qCAAqC;AAErC;;;GAGG;AACH,MAAa,OAAO;IAGlB;;;OAGG;IACH,YAAoB,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;IAAG,CAAC;IAEhD;;;OAGG;IACG,UAAU;;YACd,IAAI,CAAC,MAAM,GAAG,MAAM,kBAAS,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC5D,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC7B,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;gBAC/B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,OAAO,CAChD,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE;oBACpB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACzC,CAAC,CACF,CAAC;YACJ,CAAC;QACH,CAAC;KAAA;IAED;;;;OAIG;IACG,OAAO,CAAC,KAAa;;YACzB,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;YACxC,OAAO,MAAM,CAAC;QAChB,CAAC;KAAA;CACF;AApCD,0BAoCC"}

package/dist/types/agent.d.ts

@@ -0,0 +1,233 @@
+import { GraphFlow } from "@/graph";
+import { z } from "zod";
+/**
+ * Represents an action that has been executed by the agent
+ * @interface ExecutedAction
+ * @property {string} name - The name of the executed action
+ * @property {boolean} isExecuted - Whether the action was successfully executed
+ * @property {string | null} [error] - Optional error message if the action failed
+ * @property {any} result - The result of the action execution
+ * @property {string} timestamp - When the action was executed
+ */
+export type ExecutedAction = {
+    name: string;
+    isExecuted: boolean;
+    error?: string | null;
+    result: any;
+    timestamp: string;
+};
+/**
+ * Represents the context in which an agent operates
+ * @interface AgentContext
+ * @property {Object} input - The input provided to the agent
+ * @property {string} input.raw - The raw input text
+ * @property {number[]} [input.embedding] - Optional vector embedding of the input
+ * @property {ActionSchema[]} actions - List of actions available to the agent
+ * @property {string} response - The agent's response
+ * @property {string} [knowledge] - Optional knowledge base or context
+ * @property {ExecutedAction[]} executedActions - History of executed actions
+ */
+export type AgentContext = {
+    input: {
+        raw: string;
+        embedding?: number[];
+    };
+    actions: ActionSchema[];
+    response: string;
+    knowledge?: string;
+    executedActions: ExecutedAction[];
+};
+export declare const AgentContextSchema: z.ZodObject<{
+    input: z.ZodObject<{
+        raw: z.ZodString;
+        embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        raw: string;
+        embedding?: number[] | undefined;
+    }, {
+        raw: string;
+        embedding?: number[] | undefined;
+    }>;
+    actions: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        parameters: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodAny;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            value?: any;
+        }, {
+            name: string;
+            value?: any;
+        }>, "many">;
+        isExecuted: z.ZodOptional<z.ZodBoolean>;
+        result: z.ZodOptional<z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        parameters: {
+            name: string;
+            value?: any;
+        }[];
+        isExecuted?: boolean | undefined;
+        result?: any;
+    }, {
+        name: string;
+        parameters: {
+            name: string;
+            value?: any;
+        }[];
+        isExecuted?: boolean | undefined;
+        result?: any;
+    }>, "many">;
+    knowledge: z.ZodOptional<z.ZodString>;
+    response: z.ZodString;
+    executedActions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        result: z.ZodAny;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        timestamp: string;
+        result?: any;
+    }, {
+        name: string;
+        timestamp: string;
+        result?: any;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    input: {
+        raw: string;
+        embedding?: number[] | undefined;
+    };
+    actions: {
+        name: string;
+        parameters: {
+            name: string;
+            value?: any;
+        }[];
+        isExecuted?: boolean | undefined;
+        result?: any;
+    }[];
+    response: string;
+    knowledge?: string | undefined;
+    executedActions?: {
+        name: string;
+        timestamp: string;
+        result?: any;
+    }[] | undefined;
+}, {
+    input: {
+        raw: string;
+        embedding?: number[] | undefined;
+    };
+    actions: {
+        name: string;
+        parameters: {
+            name: string;
+            value?: any;
+        }[];
+        isExecuted?: boolean | undefined;
+        result?: any;
+    }[];
+    response: string;
+    knowledge?: string | undefined;
+    executedActions?: {
+        name: string;
+        timestamp: string;
+        result?: any;
+    }[] | undefined;
+}>;
+/**
+ * Represents a section of the prompt with a title and content
+ * @interface PromptSection
+ * @property {string} title - The title of the prompt section
+ * @property {string | ((context: AgentContext) => string | Promise<string>)} content - The content or a function to generate content
+ */
+export type PromptSection = {
+    title: string;
+    content: string | ((context: AgentContext) => string | Promise<string>);
+};
+/**
+ * Supported LLM providers
+ */
+export type LLMProvider = "openai" | "anthropic" | "custom";
+/**
+ * Supported LLM models
+ */
+export type LLMModel = "gpt-4" | "gpt-3.5-turbo" | "claude-2" | string;
+export type ExecutorConfig = {
+    llmConfig: LLMConfig;
+    verbose?: boolean;
+};
+/**
+ * Configuration for the Agent
+ * @type AssistantConfig
+ * @extends {Omit<ExecutorConfig, "verbose">}
+ * @property {string} role - The function/job of the assistant (e.g., "Email Assistant")
+ * @property {string} goal - The specific objective the assistant tries to achieve
+ * @property {string} backstory - The personality and behavioral traits of the assistant
+ * @property {any[]} [tools] - Optional tools the assistant can use
+ * @property {any} [memory] - Optional memory system
+ * @property {boolean} [verbose] - Whether to log detailed information
+ */
+export type AgentConfig = {
+    role: string;
+    goal: string;
+    backstory: string;
+    tools: GraphFlow<any>[];
+    memory?: any;
+    verbose?: boolean;
+    llmConfig: ExecutorConfig["llmConfig"];
+};
+/**
+ * Represents the schema of an action that can be performed by the agent
+ * @interface ActionSchema
+ * @property {string} name - The name of the action
+ * @property {Array<{name: string, value: any}>} parameters - The parameters required for the action
+ */
+export type ActionSchema = {
+    name: string;
+    parameters: Array<{
+        name: string;
+        value: any;
+    }>;
+};
+/**
+ * Represents the output of the agent's decision-making process
+ * @interface DecisionOutput
+ * @property {ActionSchema[]} actions - The actions to be executed
+ * @property {string} response - The agent's response message
+ */
+export type DecisionOutput = {
+    actions: ActionSchema[];
+    response: string;
+};
+/**
+ * Configuration for the Language Model
+ * @interface LLMConfig
+ * @property {LLMProvider} provider - The LLM provider to use
+ * @property {string} apiKey - API key for the provider
+ * @property {LLMModel} model - The specific model to use
+ * @property {number} [temperature] - Optional temperature parameter for response randomness
+ * @property {number} [maxTokens] - Optional maximum tokens for the response
+ * @property {Function} [customCall] - Optional custom implementation for API calls
+ */
+export type LLMConfig = {
+    provider: LLMProvider;
+    apiKey: string;
+    model: LLMModel;
+    temperature?: number;
+    maxTokens?: number;
+    customCall?: (prompt: string | PromptInput, schema: z.ZodType<any>) => Promise<any>;
+};
+/**
+ * Structure for prompt input to the LLM
+ * @interface PromptInput
+ * @property {string} system - The system message/context
+ * @property {string} user - The user's input message
+ */
+export type PromptInput = {
+    system: string;
+    user: string;
+};
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../types/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,GAAG,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,cAAc,EAAE,CAAC;CACnC,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6B7B,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,YAAY,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;CACzE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,eAAe,GAAG,UAAU,GAAG,MAAM,CAAC;AAEvE,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;CACjD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,CACX,MAAM,EAAE,MAAM,GAAG,WAAW,EAC5B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KACnB,OAAO,CAAC,GAAG,CAAC,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}

package/dist/types/agent.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentContextSchema = void 0;
+const zod_1 = require("zod");
+exports.AgentContextSchema = zod_1.z.object({
+    input: zod_1.z.object({
+        raw: zod_1.z.string(),
+        embedding: zod_1.z.array(zod_1.z.number()).optional(),
+    }),
+    actions: zod_1.z.array(zod_1.z.object({
+        name: zod_1.z.string(),
+        parameters: zod_1.z.array(zod_1.z.object({
+            name: zod_1.z.string(),
+            value: zod_1.z.any(),
+        })),
+        isExecuted: zod_1.z.boolean().optional(),
+        result: zod_1.z.any().optional(),
+    })),
+    knowledge: zod_1.z.string().optional(),
+    response: zod_1.z.string(),
+    executedActions: zod_1.z
+        .array(zod_1.z.object({
+        name: zod_1.z.string(),
+        result: zod_1.z.any(),
+        timestamp: zod_1.z.string(),
+    }))
+        .optional(),
+});
+//# sourceMappingURL=agent.js.map

package/dist/types/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../types/agent.ts"],"names":[],"mappings":";;;AACA,6BAAwB;AAyCX,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC;QACd,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;QACf,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KAC1C,CAAC;IACF,OAAO,EAAE,OAAC,CAAC,KAAK,CACd,OAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;QAChB,UAAU,EAAE,OAAC,CAAC,KAAK,CACjB,OAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;YAChB,KAAK,EAAE,OAAC,CAAC,GAAG,EAAE;SACf,CAAC,CACH;QACD,UAAU,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAClC,MAAM,EAAE,OAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KAC3B,CAAC,CACH;IACD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,eAAe,EAAE,OAAC;SACf,KAAK,CACJ,OAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,OAAC,CAAC,GAAG,EAAE;QACf,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;KACtB,CAAC,CACH;SACA,QAAQ,EAAE;CACd,CAAC,CAAC"}