@ai.ntellect/core 0.7.14 → 0.8.0

package/dist/modules/agent/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../modules/agent/agent.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAA8C;AAC9C,6CAI2B;AAC3B,iCAAmC;AACnC,yDAAqD;AAErD;;;;;;;;;;;GAWG;AACH,MAAa,KAAK;IAIhB;;;OAGG;IACH,YAAY,MAAmB;QAC7B,MAAM,KAAK,GAAG,IAAI,gBAAS,CAAC;YAC1B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,IAAI,kCAAe,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;YACvD,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACK,aAAa;QACnB,OAAO,IAAI,iBAAS,CAAC,WAAW,EAAE;YAChC,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,0BAAkB;YAC1B,OAAO,EAAE;gBACP,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;gBAClB,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,EAAE;gBACZ,eAAe,EAAE,EAAE;aACpB;YACD,KAAK,EAAE;gBACL;oBACE,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,CAAO,OAAO,EAAE,EAAE;wBACzB,MAAM,YAAY,GAAG,OAAkC,CAAC;wBACxD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;wBAChE,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;wBACnC,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;oBACvC,CAAC,CAAA;oBACD,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;iBACnE;gBACD;oBACE,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,CAAO,OAAO,EAAE,EAAE;wBACzB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;wBAClC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;wBAC7B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;wBAC3C,OAAO,CAAC,SAAS,GAAG,SAAS,SAAS,KAAK,IAAI,CAAC,SAAS,CACvD,OAAO,CAAC,OAAO,CAChB,EAAE,CAAC;wBACJ,MAAM,IAAI,CAAC,QAAQ,CAAC,cAAc,CAChC,OAAO,CAAC,OAAO,EACf,OAAkC,CACnC,CAAC;oBACJ,CAAC,CAAA;oBACD,IAAI,EAAE,CAAC,SAAS,CAAC;iBAClB;aACF;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACU,OAAO,CAAC,KAAa;;YAChC,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE;gBAChD,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE;gBACrB,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,EAAE;aACb,CAAC,CAAC;YAEH,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,EAA6B,CAAC;QAC/D,CAAC;KAAA;CACF;AAtFD,sBAsFC"}

package/dist/modules/agent/base/executor.d.ts

@@ -0,0 +1,51 @@
+import { BaseAgent } from ".";
+import { GraphFlow } from "../../../graph";
+import { ActionSchema, AgentContext, DecisionOutput } from "../../../types/agent";
+/**
+ * Abstract base class for agent executors that handle action execution
+ * @abstract
+ * @class AgentExecutor
+ */
+export declare abstract class AgentExecutor {
+    protected agent: BaseAgent;
+    protected availableGraphs: Map<string, GraphFlow<any>>;
+    /**
+     * Creates an instance of AgentExecutor
+     * @param {BaseAgent} agent - The agent instance this executor is tied to
+     * @param {GraphFlow<any>[]} graphs - Array of available graph flows that can be executed
+     */
+    constructor(agent: BaseAgent, graphs: GraphFlow<any>[]);
+    /**
+     * Makes a decision based on the current context
+     * @abstract
+     * @param {any} context - The context to base the decision on
+     * @returns {Promise<DecisionOutput>} The decision output containing actions and response
+     */
+    abstract makeDecision(context: any): Promise<DecisionOutput>;
+    /**
+     * Executes a list of actions in the given context
+     * @param {ActionSchema[]} actions - Array of actions to execute
+     * @param {AgentContext} context - The context in which to execute the actions
+     * @returns {Promise<void>}
+     */
+    executeActions(actions: ActionSchema[], context: AgentContext): Promise<void>;
+    /**
+     * Prepares the input parameters for an action
+     * @private
+     * @param {Array<{name: string, value: any}>} parameters - Array of parameter objects
+     * @returns {Record<string, any>} Object with parameter names as keys and their values
+     */
+    private prepareActionInputs;
+    /**
+     * Executes multiple workflows with their respective inputs
+     * @protected
+     * @abstract
+     * @param {GraphFlow<any>[]} workflows - Array of workflows to execute
+     * @param {string[]} startNodes - Array of starting node names for each workflow
+     * @param {any[]} inputs - Array of inputs for each workflow
+     * @param {AgentContext} context - The context in which to execute the workflows
+     * @returns {Promise<void>}
+     */
+    protected abstract executeWorkflows(workflows: GraphFlow<any>[], startNodes: string[], inputs: any[], context: AgentContext): Promise<void>;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/modules/agent/base/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../../modules/agent/base/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,8BAAsB,aAAa;IACjC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC;IAC3B,SAAS,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAEvD;;;;OAIG;gBACS,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE;IAKtD;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC;IAE5D;;;;;OAKG;IACG,cAAc,CAClB,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC;IAwBhB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;;;;;;;;OASG;IACH,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CACjC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,EAC3B,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,GAAG,EAAE,EACb,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC;CACjB"}

package/dist/modules/agent/base/executor.js

@@ -0,0 +1,66 @@
+"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.AgentExecutor = void 0;
+/**
+ * Abstract base class for agent executors that handle action execution
+ * @abstract
+ * @class AgentExecutor
+ */
+class AgentExecutor {
+    /**
+     * Creates an instance of AgentExecutor
+     * @param {BaseAgent} agent - The agent instance this executor is tied to
+     * @param {GraphFlow<any>[]} graphs - Array of available graph flows that can be executed
+     */
+    constructor(agent, graphs) {
+        this.agent = agent;
+        this.availableGraphs = new Map(graphs.map((g) => [g.name, g]));
+    }
+    /**
+     * Executes a list of actions in the given context
+     * @param {ActionSchema[]} actions - Array of actions to execute
+     * @param {AgentContext} context - The context in which to execute the actions
+     * @returns {Promise<void>}
+     */
+    executeActions(actions, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const workflowsToExecute = [];
+            const startNodes = [];
+            const inputs = [];
+            for (const action of actions) {
+                const workflow = this.availableGraphs.get(action.name);
+                if (!workflow)
+                    continue;
+                workflowsToExecute.push(workflow);
+                startNodes.push(workflow.getNodes()[0].name);
+                inputs.push(this.prepareActionInputs(action.parameters));
+            }
+            if (workflowsToExecute.length > 0) {
+                yield this.executeWorkflows(workflowsToExecute, startNodes, inputs, context);
+            }
+        });
+    }
+    /**
+     * Prepares the input parameters for an action
+     * @private
+     * @param {Array<{name: string, value: any}>} parameters - Array of parameter objects
+     * @returns {Record<string, any>} Object with parameter names as keys and their values
+     */
+    prepareActionInputs(parameters) {
+        return parameters.reduce((acc, param) => {
+            acc[param.name] = param.value;
+            return acc;
+        }, {});
+    }
+}
+exports.AgentExecutor = AgentExecutor;
+//# sourceMappingURL=executor.js.map

package/dist/modules/agent/base/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../modules/agent/base/executor.ts"],"names":[],"mappings":";;;;;;;;;;;;AAQA;;;;GAIG;AACH,MAAsB,aAAa;IAIjC;;;;OAIG;IACH,YAAY,KAAgB,EAAE,MAAwB;QACpD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IAUD;;;;;OAKG;IACG,cAAc,CAClB,OAAuB,EACvB,OAAqB;;YAErB,MAAM,kBAAkB,GAAqB,EAAE,CAAC;YAChD,MAAM,UAAU,GAAa,EAAE,CAAC;YAChC,MAAM,MAAM,GAAU,EAAE,CAAC;YAEzB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACvD,IAAI,CAAC,QAAQ;oBAAE,SAAS;gBAExB,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAClC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC7C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;YAC3D,CAAC;YAED,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,CAAC,gBAAgB,CACzB,kBAAkB,EAClB,UAAU,EACV,MAAM,EACN,OAAO,CACR,CAAC;YACJ,CAAC;QACH,CAAC;KAAA;IAED;;;;;OAKG;IACK,mBAAmB,CACzB,UAA+C;QAE/C,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YACtC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;YAC9B,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAyB,CAAC,CAAC;IAChC,CAAC;CAkBF;AAtFD,sCAsFC"}

package/dist/modules/agent/base/index.d.ts

@@ -0,0 +1,30 @@
+import { AgentConfig } from "@/types/agent";
+import { BaseMemoryType } from "../../../types";
+/**
+ * Base agent class that handles role, goal, and personality management
+ * @class BaseAgent
+ */
+export declare class BaseAgent {
+    private config;
+    private memory?;
+    constructor(config: AgentConfig);
+    execute(context: any, inputs?: any): Promise<any>;
+    private storeInMemory;
+    recall(query: string): Promise<BaseMemoryType[]>;
+    /**
+     * Get the agent's role - what function/job it performs
+     * @returns {string} The agent's role
+     */
+    getRole(): string;
+    /**
+     * Get the agent's goal - what it tries to achieve
+     * @returns {string} The agent's goal
+     */
+    getGoal(): string;
+    /**
+     * Get the agent's backstory - its personality and behavioral traits
+     * @returns {string} The agent's backstory
+     */
+    getBackstory(): string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/agent/base/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../modules/agent/base/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,MAAM,EAAE,WAAW;IAKzB,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;YAmCzC,aAAa;IAcd,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAS7D;;;OAGG;IACI,OAAO,IAAI,MAAM;IAIxB;;;OAGG;IACI,OAAO,IAAI,MAAM;IAIxB;;;OAGG;IACI,YAAY,IAAI,MAAM;CAG9B"}

package/dist/modules/agent/base/index.js

@@ -0,0 +1,100 @@
+"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.BaseAgent = void 0;
+/**
+ * Base agent class that handles role, goal, and personality management
+ * @class BaseAgent
+ */
+class BaseAgent {
+    constructor(config) {
+        this.config = config;
+        this.memory = config.memory;
+    }
+    execute(context, inputs) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Log execution if verbose
+            if (this.config.verbose) {
+                console.log(`Agent ${this.config.role} executing...`);
+                console.log("Context:", context);
+                console.log("Inputs:", inputs);
+            }
+            // Store context in memory if available
+            if (this.memory) {
+                yield this.storeInMemory({
+                    type: "execution",
+                    content: JSON.stringify({ context, inputs }),
+                    metadata: {
+                        role: this.config.role,
+                        timestamp: new Date().toISOString(),
+                    },
+                });
+            }
+            // Execute tools if available
+            if (this.config.tools) {
+                for (const tool of this.config.tools) {
+                    try {
+                        const result = yield tool.execute(context, inputs);
+                        context = Object.assign(Object.assign({}, context), result);
+                    }
+                    catch (error) {
+                        console.error(`Tool execution failed:`, error);
+                    }
+                }
+            }
+            return context;
+        });
+    }
+    storeInMemory(data) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.memory)
+                return;
+            return this.memory.createMemory({
+                content: data.content,
+                metadata: data.metadata,
+                roomId: "default",
+            });
+        });
+    }
+    recall(query) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.memory)
+                return [];
+            return this.memory.getMemoryByIndex(query, {
+                roomId: "default",
+                limit: 10,
+            });
+        });
+    }
+    /**
+     * Get the agent's role - what function/job it performs
+     * @returns {string} The agent's role
+     */
+    getRole() {
+        return this.config.role;
+    }
+    /**
+     * Get the agent's goal - what it tries to achieve
+     * @returns {string} The agent's goal
+     */
+    getGoal() {
+        return this.config.goal;
+    }
+    /**
+     * Get the agent's backstory - its personality and behavioral traits
+     * @returns {string} The agent's backstory
+     */
+    getBackstory() {
+        return this.config.backstory;
+    }
+}
+exports.BaseAgent = BaseAgent;
+//# sourceMappingURL=index.js.map

package/dist/modules/agent/base/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../modules/agent/base/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAIA;;;GAGG;AACH,MAAa,SAAS;IAIpB,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC;IAEK,OAAO,CAAC,OAAY,EAAE,MAAY;;YACtC,2BAA2B;YAC3B,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACxB,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,CAAC;gBACtD,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBACjC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACjC,CAAC;YAED,uCAAuC;YACvC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,IAAI,CAAC,aAAa,CAAC;oBACvB,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;oBAC5C,QAAQ,EAAE;wBACR,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;wBACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;qBACpC;iBACF,CAAC,CAAC;YACL,CAAC;YAED,6BAA6B;YAC7B,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACtB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;oBACrC,IAAI,CAAC;wBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;wBACnD,OAAO,mCAAQ,OAAO,GAAK,MAAM,CAAE,CAAC;oBACtC,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;oBACjD,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC;KAAA;IAEa,aAAa,CAAC,IAI3B;;YACC,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,OAAO;YAEzB,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;gBAC9B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;QACL,CAAC;KAAA;IAEY,MAAM,CAAC,KAAa;;YAC/B,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,OAAO,EAAE,CAAC;YAE5B,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE;gBACzC,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,EAAE;aACV,CAAC,CAAC;QACL,CAAC;KAAA;IAED;;;OAGG;IACI,OAAO;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACI,OAAO;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACI,YAAY;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;IAC/B,CAAC;CACF;AA1FD,8BA0FC"}

package/dist/modules/agent/generic-assistant.d.ts

@@ -0,0 +1,20 @@
+import { AgentConfig, AgentContext } from "../../types/agent";
+/**
+ * A generic assistant that can be configured with different roles, goals, and personalities
+ * @class Agent
+ * @example
+ * const assistant = new Agent({
+ *   role: "Email Assistant",
+ *   goal: "Help users send emails efficiently",
+ *   backstory: "I am a professional and friendly assistant who specializes in email communication",
+ *   llmConfig: { provider: "openai", model: "gpt-4" }
+ * });
+ */
+export declare class Agent {
+    private executor;
+    private workflow;
+    constructor(config: AgentConfig);
+    private setupWorkflow;
+    process(input: string): Promise<AgentContext>;
+}
+//# sourceMappingURL=generic-assistant.d.ts.map

package/dist/modules/agent/generic-assistant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-assistant.d.ts","sourceRoot":"","sources":["../../../modules/agent/generic-assistant.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,YAAY,EAEb,MAAM,mBAAmB,CAAC;AAI3B;;;;;;;;;;GAUG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,QAAQ,CAAuC;gBAE3C,MAAM,EAAE,WAAW;IAkB/B,OAAO,CAAC,aAAa;IAsCR,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAS3D"}

package/dist/modules/agent/generic-assistant.js

@@ -0,0 +1,89 @@
+"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.Agent = void 0;
+const index_1 = require("../../graph/index");
+const agent_1 = require("../../types/agent");
+const base_1 = require("./base");
+const generic_executor_1 = require("./generic-executor");
+/**
+ * A generic assistant that can be configured with different roles, goals, and personalities
+ * @class Agent
+ * @example
+ * const assistant = new Agent({
+ *   role: "Email Assistant",
+ *   goal: "Help users send emails efficiently",
+ *   backstory: "I am a professional and friendly assistant who specializes in email communication",
+ *   llmConfig: { provider: "openai", model: "gpt-4" }
+ * });
+ */
+class Agent {
+    constructor(config) {
+        const agent = new base_1.BaseAgent({
+            role: config.role,
+            goal: config.goal,
+            backstory: config.backstory,
+            tools: config.tools,
+            memory: config.memory,
+            llmConfig: config.llmConfig,
+        });
+        this.executor = new generic_executor_1.GenericExecutor(agent, config.tools, {
+            llmConfig: config.llmConfig,
+            verbose: config.verbose,
+        });
+        this.workflow = this.setupWorkflow();
+    }
+    setupWorkflow() {
+        return new index_1.GraphFlow("assistant", {
+            name: "assistant",
+            schema: agent_1.AgentContextSchema,
+            context: {
+                input: { raw: "" },
+                actions: [],
+                response: "",
+                executedActions: [],
+            },
+            nodes: [
+                {
+                    name: "process",
+                    execute: (context) => __awaiter(this, void 0, void 0, function* () {
+                        const agentContext = context;
+                        const decision = yield this.executor.makeDecision(agentContext);
+                        context.actions = decision.actions;
+                        context.response = decision.response;
+                    }),
+                    next: (context) => (context.actions.length > 0 ? ["execute"] : []),
+                },
+                {
+                    name: "execute",
+                    execute: (context) => __awaiter(this, void 0, void 0, function* () {
+                        console.log(`Executing actions:`);
+                        console.log(context.actions);
+                        yield this.executor.executeActions(context.actions, context);
+                    }),
+                    next: ["process"],
+                },
+            ],
+        });
+    }
+    process(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.workflow.execute("process", undefined, {
+                input: { raw: input },
+                actions: [],
+                response: "",
+            });
+            return this.workflow.getContext();
+        });
+    }
+}
+exports.Agent = Agent;
+//# sourceMappingURL=generic-assistant.js.map

package/dist/modules/agent/generic-assistant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-assistant.js","sourceRoot":"","sources":["../../../modules/agent/generic-assistant.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAA8C;AAC9C,6CAI2B;AAC3B,iCAAmC;AACnC,yDAAqD;AAErD;;;;;;;;;;GAUG;AACH,MAAa,KAAK;IAIhB,YAAY,MAAmB;QAC7B,MAAM,KAAK,GAAG,IAAI,gBAAS,CAAC;YAC1B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,IAAI,kCAAe,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;YACvD,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;IACvC,CAAC;IAEO,aAAa;QACnB,OAAO,IAAI,iBAAS,CAAC,WAAW,EAAE;YAChC,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,0BAAkB;YAC1B,OAAO,EAAE;gBACP,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;gBAClB,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,EAAE;gBACZ,eAAe,EAAE,EAAE;aACpB;YACD,KAAK,EAAE;gBACL;oBACE,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,CAAO,OAAO,EAAE,EAAE;wBACzB,MAAM,YAAY,GAAG,OAAkC,CAAC;wBACxD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;wBAChE,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;wBACnC,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;oBACvC,CAAC,CAAA;oBACD,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;iBACnE;gBACD;oBACE,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,CAAO,OAAO,EAAE,EAAE;wBACzB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;wBAClC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;wBAE7B,MAAM,IAAI,CAAC,QAAQ,CAAC,cAAc,CAChC,OAAO,CAAC,OAAO,EACf,OAAkC,CACnC,CAAC;oBACJ,CAAC,CAAA;oBACD,IAAI,EAAE,CAAC,SAAS,CAAC;iBAClB;aACF;SACF,CAAC,CAAC;IACL,CAAC;IAEY,OAAO,CAAC,KAAa;;YAChC,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE;gBAChD,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE;gBACrB,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,EAAE;aACb,CAAC,CAAC;YAEH,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,EAA6B,CAAC;QAC/D,CAAC;KAAA;CACF;AArED,sBAqEC"}

package/dist/modules/agent/generic-executor.d.ts

@@ -0,0 +1,57 @@
+import { GraphFlow } from "../../graph/index";
+import { AgentContext, DecisionOutput, ExecutorConfig } from "../../types/agent";
+import { BaseAgent } from "./base";
+import { AgentExecutor } from "./base/executor";
+/**
+ * Generic executor that handles the interaction between the agent and LLM
+ * Uses a structured prompt format:
+ * - ROLE: The function/job the agent performs
+ * - GOAL: The specific objective to achieve
+ * - BACKSTORY: The personality and behavior traits
+ * - CONTEXT: Current knowledge and state
+ * - AVAILABLE ACTIONS: What the agent can do
+ * - INSTRUCTIONS: How to process and respond
+ * @class GenericExecutor
+ * @extends {AgentExecutor}
+ */
+export declare class GenericExecutor extends AgentExecutor {
+    private verbose;
+    private llm;
+    /**
+     * Creates an instance of GenericExecutor
+     * @param {BaseAgent} agent - The agent instance this executor is tied to
+     * @param {GraphFlow<any>[]} graphs - Array of available graph flows
+     * @param {ExecutorConfig} config - Configuration for the executor
+     */
+    constructor(agent: BaseAgent, graphs: GraphFlow<any>[], config: ExecutorConfig);
+    /**
+     * Logs a message with a specific type if verbose mode is enabled
+     * @private
+     * @param {"info" | "success" | "warning" | "error" | "thinking"} type - The type of log message
+     * @param {string} message - The message to log
+     */
+    private log;
+    /**
+     * Generates a string representation of the available action schemas
+     * @private
+     * @returns {string} Formatted string containing all available actions and their parameters
+     */
+    protected generateActionSchema(): string;
+    /**
+     * Makes a decision based on the current context using the LLM
+     * @param {AgentContext} context - The context to base the decision on
+     * @returns {Promise<DecisionOutput>} The decision output containing actions and response
+     */
+    makeDecision(context: AgentContext): Promise<DecisionOutput>;
+    /**
+     * Executes multiple workflows with their respective inputs
+     * @protected
+     * @param {GraphFlow<any>[]} workflows - Array of workflows to execute
+     * @param {string[]} startNodes - Array of starting node names for each workflow
+     * @param {any[]} inputs - Array of inputs for each workflow
+     * @param {AgentContext} context - The context in which to execute the workflows
+     * @returns {Promise<void>}
+     */
+    protected executeWorkflows(workflows: GraphFlow<any>[], startNodes: string[], inputs: any[], context: AgentContext): Promise<void>;
+}
+//# sourceMappingURL=generic-executor.d.ts.map

package/dist/modules/agent/generic-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-executor.d.ts","sourceRoot":"","sources":["../../../modules/agent/generic-executor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAEL,YAAY,EACZ,cAAc,EACd,cAAc,EACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;;;;;;;;;GAWG;AACH,qBAAa,eAAgB,SAAQ,aAAa;IAChD,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,GAAG,CAA0C;IAErD;;;;;OAKG;gBAED,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,EACxB,MAAM,EAAE,cAAc;IAOxB;;;;;OAKG;IACH,OAAO,CAAC,GAAG;IAiBX;;;;OAIG;IACH,SAAS,CAAC,oBAAoB,IAAI,MAAM;IAyBxC;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAgGlE;;;;;;;;OAQG;cACa,gBAAgB,CAC9B,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,EAC3B,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,GAAG,EAAE,EACb,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC;CA6CjB"}

package/dist/modules/agent/generic-executor.js

@@ -0,0 +1,200 @@
+"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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenericExecutor = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const zod_1 = require("zod");
+const executor_1 = require("./base/executor");
+const llm_factory_1 = require("./llm-factory");
+/**
+ * Generic executor that handles the interaction between the agent and LLM
+ * Uses a structured prompt format:
+ * - ROLE: The function/job the agent performs
+ * - GOAL: The specific objective to achieve
+ * - BACKSTORY: The personality and behavior traits
+ * - CONTEXT: Current knowledge and state
+ * - AVAILABLE ACTIONS: What the agent can do
+ * - INSTRUCTIONS: How to process and respond
+ * @class GenericExecutor
+ * @extends {AgentExecutor}
+ */
+class GenericExecutor extends executor_1.AgentExecutor {
+    /**
+     * Creates an instance of GenericExecutor
+     * @param {BaseAgent} agent - The agent instance this executor is tied to
+     * @param {GraphFlow<any>[]} graphs - Array of available graph flows
+     * @param {ExecutorConfig} config - Configuration for the executor
+     */
+    constructor(agent, graphs, config) {
+        var _a;
+        super(agent, graphs);
+        this.verbose = (_a = config.verbose) !== null && _a !== void 0 ? _a : true;
+        this.llm = llm_factory_1.LLMFactory.createLLM(config.llmConfig);
+    }
+    /**
+     * Logs a message with a specific type if verbose mode is enabled
+     * @private
+     * @param {"info" | "success" | "warning" | "error" | "thinking"} type - The type of log message
+     * @param {string} message - The message to log
+     */
+    log(type, message) {
+        if (!this.verbose)
+            return;
+        const prefix = {
+            info: chalk_1.default.blue("ℹ"),
+            success: chalk_1.default.green("✓"),
+            warning: chalk_1.default.yellow("⚠"),
+            error: chalk_1.default.red("✖"),
+            thinking: chalk_1.default.magenta("🤔"),
+        }[type];
+        console.log(`${prefix} ${message}`);
+    }
+    /**
+     * Generates a string representation of the available action schemas
+     * @private
+     * @returns {string} Formatted string containing all available actions and their parameters
+     */
+    generateActionSchema() {
+        return Array.from(this.availableGraphs.values())
+            .map((graph) => {
+            const schema = graph.getSchema();
+            const schemaDescription = Object.entries(schema.shape)
+                .map(([key, value]) => {
+                const zodValue = value;
+                return `    - ${key}: ${zodValue.description || zodValue._def.typeName}`;
+            })
+                .join("\n");
+            return `${graph.name}:
+  Parameters:
+${schemaDescription}
+  Available Operations:
+${graph
+                .getNodes()
+                .map((n) => `    - ${n.name}`)
+                .join("\n")}`;
+        })
+            .join("\n\n");
+    }
+    /**
+     * Makes a decision based on the current context using the LLM
+     * @param {AgentContext} context - The context to base the decision on
+     * @returns {Promise<DecisionOutput>} The decision output containing actions and response
+     */
+    makeDecision(context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            this.log("thinking", chalk_1.default.dim("Analyzing context and available actions..."));
+            const memories = yield this.agent.recall(context.input.raw);
+            if (memories.length > 0) {
+                this.log("info", chalk_1.default.dim("Retrieved relevant memories:"));
+                memories.forEach((m) => this.log("info", chalk_1.default.dim(`- ${m.content}`)));
+                context.knowledge =
+                    (context.knowledge || "") +
+                        "\n" +
+                        memories.map((m) => m.content).join("\n");
+            }
+            const systemPrompt = `
+      ## ROLE
+      ${this.agent.getRole()}
+
+      ## GOAL
+      ${this.agent.getGoal()}
+
+      ## BACKSTORY
+      ${this.agent.getBackstory()}
+
+      ## RECENT ACTIONS
+      ${context.knowledge ? `${context.knowledge}\n` : "None"}
+     
+      ## AVAILABLE ACTIONS
+      ${this.generateActionSchema()}
+
+      ## INSTRUCTIONS
+      - Analyze the user input and what you have done (if no action is needed, just return an empty array)
+      - Choose appropriate actions based on their parameters
+      - Structure parameters according to the action's schema
+      - Look at the goal and the actions you have done, if you have achieved the goal, STOP
+    `;
+            this.log("info", chalk_1.default.dim("Generating response..."));
+            const result = yield this.llm.generate({
+                system: systemPrompt,
+                user: `User input: ${context.input.raw}
+        Actions you have already done: ${((_a = context.executedActions) === null || _a === void 0 ? void 0 : _a.map((a) => `\n- ${a.name} => ${JSON.stringify(a.result)}`).join("")) || "None"}`,
+            }, zod_1.z.object({
+                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(),
+                    })),
+                })),
+                response: zod_1.z.string(),
+            }));
+            if (result.object.actions.length > 0) {
+                this.log("success", chalk_1.default.green("Decided to take actions:"));
+                result.object.actions.forEach((action) => {
+                    this.log("info", chalk_1.default.cyan(`Action: ${action.name}`));
+                    action.parameters.forEach((param) => {
+                        this.log("info", chalk_1.default.dim(`  - ${param.name}: ${JSON.stringify(param.value)}`));
+                    });
+                });
+            }
+            else {
+                this.log("info", chalk_1.default.yellow("No actions needed"));
+            }
+            this.log("success", chalk_1.default.green(`Response: ${result.object.response}`));
+            return {
+                actions: result.object.actions,
+                response: result.object.response,
+            };
+        });
+    }
+    /**
+     * Executes multiple workflows with their respective inputs
+     * @protected
+     * @param {GraphFlow<any>[]} workflows - Array of workflows to execute
+     * @param {string[]} startNodes - Array of starting node names for each workflow
+     * @param {any[]} inputs - Array of inputs for each workflow
+     * @param {AgentContext} context - The context in which to execute the workflows
+     * @returns {Promise<void>}
+     */
+    executeWorkflows(workflows, startNodes, inputs, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.log("info", chalk_1.default.cyan("Executing workflows:"));
+            for (let i = 0; i < workflows.length; i++) {
+                const workflow = workflows[i];
+                const startNode = startNodes[i];
+                const input = inputs[i];
+                this.log("info", chalk_1.default.dim(`Executing workflow ${workflow.name} starting at node ${startNode}`));
+                this.log("info", chalk_1.default.dim(`Input parameters: ${JSON.stringify(input, null, 2)}`));
+                // Initialize workflow context with input
+                const workflowContext = Object.assign(Object.assign({}, workflow.getContext()), input);
+                // Execute with merged context
+                const result = yield workflow.execute(startNode, undefined, workflowContext);
+                this.log("success", chalk_1.default.green(`Workflow ${workflow.name} completed`));
+                this.log("info", chalk_1.default.dim(`Result: ${JSON.stringify(result, null, 2)}`));
+                if (context.executedActions) {
+                    context.executedActions.push({
+                        name: workflow.name,
+                        result: result,
+                        timestamp: new Date().toISOString(),
+                        isExecuted: true,
+                    });
+                }
+            }
+        });
+    }
+}
+exports.GenericExecutor = GenericExecutor;
+//# sourceMappingURL=generic-executor.js.map