@ai.ntellect/core 1.0.0 → 1.1.1

package/dist/agent/agent.js

@@ -0,0 +1,149 @@
+"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 base_1 = require("./base");
+const generic_executor_1 = require("./generic-executor");
+const logger_1 = require("./tools/logger");
+const agent_workflow_1 = require("./agent-workflow");
+const entity_index_1 = require("./entity-resolver/entity-index");
+const resolver_1 = require("./entity-resolver/resolver");
+const explore_strategy_1 = require("./entity-resolver/explore-strategy");
+/**
+ * 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" }
+ *   tools: []
+ * });
+ */
+class Agent {
+    constructor(config) {
+        var _a, _b;
+        const agent = new base_1.BaseAgent({
+            role: config.role,
+            goal: config.goal,
+            backstory: config.backstory,
+            tools: config.tools,
+            memory: config.memory,
+            llmConfig: config.llmConfig,
+        });
+        const maxIterations = config.maxIterations || 5;
+        this.logger = new logger_1.AgentLogger((_a = config.verbose) !== null && _a !== void 0 ? _a : true);
+        this.executor = new generic_executor_1.GenericExecutor(agent, config.tools, {
+            llmConfig: config.llmConfig,
+            verbose: config.verbose,
+        }, this.logger, {
+            dynamicGoal: config.dynamicGoal,
+            dynamicGoalPrompt: config.dynamicGoalPrompt,
+            dynamicNext: config.dynamicNext,
+            dynamicNextPrompt: config.dynamicNextPrompt,
+            enableSchedule: config.enableSchedule,
+            agenda: config.agenda,
+        });
+        this.executor.setLogger(this.logger);
+        const entityIndex = new entity_index_1.EntityIndex(config.entityStore);
+        if (config.entityStore) {
+            entityIndex.hydrate().catch((err) => this.logger.log("warn", "agent", `Entity store hydration failed: ${err}`));
+        }
+        const entityResolver = new resolver_1.EntityResolver(entityIndex);
+        const exploreStrategy = new explore_strategy_1.ExploreStrategy(entityIndex);
+        this.executor.setEntityIndex(entityIndex);
+        this.workflow = (0, agent_workflow_1.buildAgentWorkflow)({
+            executor: this.executor,
+            baseAgent: agent,
+            logger: this.logger,
+            maxIterations,
+            enableClone: (_b = config.enableClone) !== null && _b !== void 0 ? _b : false,
+            entityResolver: {
+                resolve: (ctx) => entityResolver.resolve(ctx),
+                getIndex: () => entityIndex,
+            },
+            exploreStrategy: {
+                plan: (candidates, cwd) => exploreStrategy.plan(candidates, cwd),
+            },
+        });
+    }
+    /**
+     * Processes an input string through the agent's workflow
+     * @param {string} input - The input string to process
+     * @returns {Promise<AgentContext>} The resulting context after processing
+     */
+    process(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.workflow.execute("defineGoal", {
+                input: { raw: input },
+                cwd: process.cwd(),
+                actions: [],
+                response: "",
+                scratchpad: [],
+                memories: [],
+            });
+            return this.workflow.getContext();
+        });
+    }
+    getWorkflow() {
+        return this.workflow;
+    }
+    processWithCheckpoint(input_1, adapter_1) {
+        return __awaiter(this, arguments, void 0, function* (input, adapter, config = {}) {
+            var _a, _b, _c;
+            const result = yield this.workflow.executeWithCheckpoint("defineGoal", adapter, Object.assign(Object.assign({}, config), { breakpoints: config.breakpoints || ["execute"], initialContext: Object.assign({ input: { raw: input }, cwd: process.cwd(), scratchpad: [], memories: [], entityState: ((_a = config.initialContext) === null || _a === void 0 ? void 0 : _a.entityState) || {
+                        currentTarget: undefined,
+                        lastEntityType: null,
+                        pendingResolutions: [],
+                        resolutionTrace: [],
+                        explored: false,
+                    }, conversationState: ((_b = config.initialContext) === null || _b === void 0 ? void 0 : _b.conversationState) || {
+                        currentGoal: "",
+                        currentTarget: null,
+                        lastResolvedEntity: null,
+                        lastResolvedType: null,
+                        pendingTask: null,
+                        turnCount: 0,
+                        pendingIntent: null,
+                    }, explorationBudget: ((_c = config.initialContext) === null || _c === void 0 ? void 0 : _c.explorationBudget) || {
+                        maxSteps: 12,
+                        maxExplorations: 2,
+                        maxToolCalls: 8,
+                        stepsUsed: 0,
+                        explorationsUsed: 0,
+                        toolCallsUsed: 0,
+                    } }, config.initialContext) }));
+            return {
+                context: result.context,
+                checkpointId: result.checkpointId,
+            };
+        });
+    }
+    resumeFromCheckpoint(checkpointId, adapter, contextModifications) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.workflow.resumeFromCheckpoint(checkpointId, adapter, contextModifications);
+            return result;
+        });
+    }
+    listCheckpoints(adapter) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.workflow.listCheckpoints(adapter);
+        });
+    }
+    getCheckpointHistory(runId, adapter) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.workflow.getCheckpointHistory(runId, adapter);
+        });
+    }
+}
+exports.Agent = Agent;
+//# sourceMappingURL=agent.js.map

package/dist/agent/agent.js.map

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

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

@@ -0,0 +1,51 @@
+import { BaseAgent } from ".";
+import { GraphFlow } from "../../execution";
+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}> | Record<string, any>} parameters - Array of parameter objects or direct object
+     * @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/agent/base/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../agent/base/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B;;;;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;IAY3B;;;;;;;;;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/agent/base/executor.js

@@ -0,0 +1,69 @@
+"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}> | Record<string, any>} parameters - Array of parameter objects or direct object
+     * @returns {Record<string, any>} Object with parameter names as keys and their values
+     */
+    prepareActionInputs(parameters) {
+        if (Array.isArray(parameters)) {
+            return parameters.reduce((acc, param) => {
+                acc[param.name] = param.value;
+                return acc;
+            }, {});
+        }
+        return parameters;
+    }
+}
+exports.AgentExecutor = AgentExecutor;
+//# sourceMappingURL=executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../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,UAAqE;QAErE,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;gBACtC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;gBAC9B,OAAO,GAAG,CAAC;YACb,CAAC,EAAE,EAAyB,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,UAAiC,CAAC;IAC3C,CAAC;CAkBF;AAzFD,sCAyFC"}

package/dist/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/agent/base/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../agent/base/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C;;;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;YAuBzC,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/agent/base/index.js

@@ -0,0 +1,88 @@
+"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(),
+                    },
+                });
+            }
+            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/agent/base/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../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,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;AA9ED,8BA8EC"}

package/dist/agent/entity-resolver/confidence.d.ts

@@ -0,0 +1,4 @@
+import { ScoredCandidate, Confidence } from "./types";
+export declare function computeConfidence(candidates: ScoredCandidate[]): Confidence;
+export declare function confidenceImproved(before: Confidence, after: Confidence): boolean;
+//# sourceMappingURL=confidence.d.ts.map

package/dist/agent/entity-resolver/confidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.d.ts","sourceRoot":"","sources":["../../../agent/entity-resolver/confidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKtD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,UAAU,CAyC3E;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,UAAU,GAChB,OAAO,CAET"}

package/dist/agent/entity-resolver/confidence.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeConfidence = computeConfidence;
+exports.confidenceImproved = confidenceImproved;
+const HIGH_GAP = 0.3;
+const MEDIUM_GAP = 0.15;
+function computeConfidence(candidates) {
+    if (candidates.length === 0) {
+        return { level: "low", score: 0, gap: 0, reason: "no candidates found" };
+    }
+    if (candidates.length === 1) {
+        const score = candidates[0].breakdown.total;
+        if (score >= 0.7) {
+            return { level: "high", score, gap: 1, reason: "single candidate with high score" };
+        }
+        return { level: "medium", score, gap: 1, reason: "single candidate but low score" };
+    }
+    const top = candidates[0].breakdown.total;
+    const second = candidates[1].breakdown.total;
+    const gap = top - second;
+    if (gap >= HIGH_GAP) {
+        return {
+            level: "high",
+            score: top,
+            gap,
+            reason: `gap ${gap.toFixed(2)} >= ${HIGH_GAP}, clear winner: ${candidates[0].entity.filename}`,
+        };
+    }
+    if (gap >= MEDIUM_GAP) {
+        return {
+            level: "medium",
+            score: top,
+            gap,
+            reason: `gap ${gap.toFixed(2)} >= ${MEDIUM_GAP}, ambiguous: ${candidates[0].entity.filename} vs ${candidates[1].entity.filename}`,
+        };
+    }
+    return {
+        level: "low",
+        score: top,
+        gap,
+        reason: `gap ${gap.toFixed(2)} < ${MEDIUM_GAP}, too close: ${candidates.map(c => c.entity.filename).join(", ")}`,
+    };
+}
+function confidenceImproved(before, after) {
+    return after.score > before.score;
+}
+//# sourceMappingURL=confidence.js.map

package/dist/agent/entity-resolver/confidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.js","sourceRoot":"","sources":["../../../agent/entity-resolver/confidence.ts"],"names":[],"mappings":";;AAKA,8CAyCC;AAED,gDAKC;AAnDD,MAAM,QAAQ,GAAG,GAAG,CAAC;AACrB,MAAM,UAAU,GAAG,IAAI,CAAC;AAExB,SAAgB,iBAAiB,CAAC,UAA6B;IAC7D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAC3E,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC;QAC5C,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;YACjB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAC;QACtF,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,gCAAgC,EAAE,CAAC;IACtF,CAAC;IAED,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC;IAC1C,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC;IAC7C,MAAM,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC;IAEzB,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QACpB,OAAO;YACL,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,GAAG;YACV,GAAG;YACH,MAAM,EAAE,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,QAAQ,mBAAmB,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE;SAC/F,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,IAAI,UAAU,EAAE,CAAC;QACtB,OAAO;YACL,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,GAAG;YACV,GAAG;YACH,MAAM,EAAE,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,UAAU,gBAAgB,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE;SAClI,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,GAAG;QACV,GAAG;QACH,MAAM,EAAE,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,UAAU,gBAAgB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KACjH,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAChC,MAAkB,EAClB,KAAiB;IAEjB,OAAO,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;AACpC,CAAC"}

package/dist/agent/entity-resolver/entity-index.d.ts

@@ -0,0 +1,40 @@
+import { Entity } from "./types";
+export interface IEntityStore {
+    upsertMany(entities: Entity[]): Promise<void>;
+    loadAll(scope?: string): Promise<Entity[]>;
+    recordResolution(entityId: string, query: string, confidence: number): Promise<void>;
+    clear(scope?: string): Promise<void>;
+}
+export type TargetResolution = {
+    target: string;
+    resolvedEntity: Entity | null;
+    path: string | null;
+    entityId: string | null;
+};
+export type LookupMode = "exact" | "fuzzy";
+export declare class EntityIndex {
+    private store?;
+    private entities;
+    private byId;
+    private allEntities;
+    constructor(store?: IEntityStore | undefined);
+    hydrate(scope?: string): Promise<void>;
+    private addEntity;
+    ingestDirectory(dirPath: string, entries: {
+        name: string;
+        type: string;
+    }[]): void;
+    ingestFile(filePath: string): void;
+    lookup(query: string, options?: {
+        mode?: LookupMode;
+    }): Entity[];
+    resolveByTarget(target: string): Entity | null;
+    resolve(target: string, _toolName?: string): TargetResolution;
+    resolveToolParams(params: Record<string, any>, toolName: string): Record<string, any>;
+    getByDir(dirPath: string): Entity[];
+    getAll(): Entity[];
+    getById(id: string): Entity | undefined;
+    clear(): void;
+    size(): number;
+}
+//# sourceMappingURL=entity-index.d.ts.map

package/dist/agent/entity-resolver/entity-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-index.d.ts","sourceRoot":"","sources":["../../../agent/entity-resolver/entity-index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAkB,MAAM,SAAS,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrF,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAyBD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3C,qBAAa,WAAW;IAKV,OAAO,CAAC,KAAK,CAAC;IAJ1B,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,WAAW,CAAgB;gBAEf,KAAK,CAAC,EAAE,YAAY,YAAA;IAElC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C,OAAO,CAAC,SAAS;IASjB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,IAAI;IA4BjF,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAwBlC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,UAAU,CAAA;KAAO,GAAG,MAAM,EAAE;IA0BpE,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAmB9C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB;IA0B7D,iBAAiB,CACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAuBtB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAKnC,MAAM,IAAI,MAAM,EAAE;IAIlB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIvC,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,MAAM;CAGf"}