@ai.ntellect/core 1.0.0 → 1.1.0

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

@@ -0,0 +1,182 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scoreEntities = scoreEntities;
+const WEIGHTS = {
+    lexical: 0.25,
+    exact: 0.20,
+    stem: 0.15,
+    typeHint: 0.15,
+    context: 0.15,
+    recency: 0.10,
+};
+function scoreLexical(query, entity) {
+    const reasons = [];
+    const qLower = query.toLowerCase();
+    const tokens = qLower.split(/[-._\s]+/).filter(Boolean);
+    const entityTokens = entity.tokens;
+    if (tokens.length === 0)
+        return { score: 0, reasons: [] };
+    let matchCount = 0;
+    for (const qt of tokens) {
+        if (entityTokens.some(et => et === qt || et.startsWith(qt) || qt.startsWith(et))) {
+            matchCount++;
+        }
+    }
+    let overlap = matchCount / Math.max(tokens.length, entityTokens.length);
+    overlap = Math.min(1, overlap);
+    if (overlap > 0)
+        reasons.push(`token overlap ${(overlap * 100).toFixed(0)}%`);
+    return { score: overlap, reasons };
+}
+function scoreExact(query, entity) {
+    const qLower = query.toLowerCase();
+    const reasons = [];
+    if (entity.filename.toLowerCase() === qLower) {
+        reasons.push(`filename exact match: ${entity.filename}`);
+        return { score: 1, reasons };
+    }
+    if (entity.stem.toLowerCase() === qLower) {
+        reasons.push(`stem exact match: ${entity.stem}`);
+        return { score: 0.9, reasons };
+    }
+    if (entity.filename.toLowerCase().includes(qLower)) {
+        reasons.push(`filename contains query`);
+        return { score: 0.6, reasons };
+    }
+    return { score: 0, reasons };
+}
+function scoreStem(query, entity) {
+    const qLower = query.toLowerCase();
+    const reasons = [];
+    if (entity.stem.toLowerCase() === qLower) {
+        reasons.push(`stem match: ${entity.stem}`);
+        return { score: 1, reasons };
+    }
+    if (entity.stem.toLowerCase().includes(qLower) || qLower.includes(entity.stem.toLowerCase())) {
+        reasons.push(`stem partial match`);
+        return { score: 0.7, reasons };
+    }
+    return { score: 0, reasons };
+}
+function scoreTypeHint(query, entity) {
+    const reasons = [];
+    const qLower = query.toLowerCase();
+    let score = 0;
+    const fileHints = /\b(fichier|file|read|lis|lecture|ouvre|contenu)\b/i;
+    const dirHints = /\b(dossier|dir|folder|list|lister|répertoire)\b/i;
+    const isFileHint = fileHints.test(qLower);
+    const isDirHint = dirHints.test(qLower);
+    if (isFileHint && entity.category === "file") {
+        score = 1;
+        reasons.push("user said 'fichier'/'file' → entity is file");
+    }
+    else if (isDirHint && entity.category === "dir") {
+        score = 1;
+        reasons.push("user said 'dossier'/'dir' → entity is dir");
+    }
+    else if (isFileHint && entity.category !== "file") {
+        score = 0.1;
+    }
+    else if (isDirHint && entity.category !== "dir") {
+        score = 0.1;
+    }
+    else {
+        score = 0.5;
+    }
+    return { score, reasons };
+}
+function scoreContext(query, entity, ctx) {
+    const reasons = [];
+    const qLower = query.toLowerCase();
+    const lastTarget = ctx.conversationState.lastResolvedEntity;
+    const lastType = ctx.conversationState.lastResolvedType;
+    const pending = ctx.conversationState.pendingIntent;
+    let score = 0;
+    if (lastTarget) {
+        const lastFile = lastTarget.split("/").pop() || "";
+        const lastStem = lastFile.includes(".") ? lastFile.slice(0, lastFile.lastIndexOf(".")) : lastFile;
+        if (lastStem.toLowerCase() === qLower) {
+            score = 1;
+            reasons.push(`continues from last entity: ${lastTarget}`);
+            return { score, reasons };
+        }
+        const lastTokens = lastStem.split(/[-._\s]+/).filter(Boolean).map(t => t.toLowerCase());
+        const queryTokens = qLower.split(/[-._\s]+/).filter(Boolean);
+        if (lastTokens.some(lt => queryTokens.includes(lt)) || queryTokens.some(qt => lastTokens.includes(qt))) {
+            score = 0.6;
+            reasons.push(`token overlap with last entity: ${lastTarget}`);
+        }
+        if (lastType && entity.category === lastType) {
+            score = Math.max(score, 0.4);
+            reasons.push(`same type as last entity: ${lastType}`);
+        }
+        const lastDir = lastTarget.includes("/") ? lastTarget.split("/").slice(0, -1).join("/") : "";
+        if (lastDir && entity.id.startsWith(lastDir + "/")) {
+            score = Math.max(score, 0.5);
+            reasons.push(`same directory as last entity`);
+        }
+    }
+    if (pending && pending.unresolvedEntity) {
+        const pendingLower = pending.unresolvedEntity.toLowerCase();
+        if (entity.stem.toLowerCase() === pendingLower || entity.filename.toLowerCase().includes(pendingLower)) {
+            score = Math.max(score, 0.7);
+            reasons.push(`matches pending unresolved entity: ${pending.unresolvedEntity}`);
+        }
+    }
+    if (score === 0) {
+        reasons.push("no contextual match");
+    }
+    return { score: Math.min(1, score), reasons };
+}
+function scoreRecency(query, entity, ctx) {
+    const reasons = [];
+    const msgs = ctx.conversationHistory.slice(-6);
+    for (const msg of msgs) {
+        const content = msg.content.toLowerCase();
+        if (content.includes(entity.filename.toLowerCase()) || content.includes(entity.stem.toLowerCase())) {
+            reasons.push(`mentioned in recent conversation: ${entity.filename}`);
+            return { score: 1, reasons };
+        }
+        for (const token of entity.tokens) {
+            if (content.includes(token)) {
+                reasons.push(`token "${token}" in recent conversation`);
+                return { score: 0.8, reasons };
+            }
+        }
+    }
+    return { score: 0, reasons: ["not recently mentioned"] };
+}
+function scoreEntities(query, entities, ctx) {
+    return entities.map(entity => {
+        const lex = scoreLexical(query, entity);
+        const exact = scoreExact(query, entity);
+        const stem = scoreStem(query, entity);
+        const type = scoreTypeHint(query, entity);
+        const context = scoreContext(query, entity, ctx);
+        const recency = scoreRecency(query, entity, ctx);
+        const breakdown = {
+            lexical: lex.score,
+            typeHint: type.score,
+            context: context.score,
+            recency: recency.score,
+            total: 0,
+        };
+        breakdown.total =
+            WEIGHTS.lexical * lex.score +
+                WEIGHTS.exact * exact.score +
+                WEIGHTS.stem * stem.score +
+                WEIGHTS.typeHint * type.score +
+                WEIGHTS.context * context.score +
+                WEIGHTS.recency * recency.score;
+        const reasons = [
+            ...lex.reasons,
+            ...exact.reasons,
+            ...stem.reasons,
+            ...type.reasons,
+            ...context.reasons,
+            ...recency.reasons,
+        ];
+        return { entity, breakdown, reasons };
+    }).sort((a, b) => b.breakdown.total - a.breakdown.total);
+}
+//# sourceMappingURL=scorer.js.map

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

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

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

@@ -0,0 +1,89 @@
+export type EntityCategory = "file" | "dir" | "command" | "workflow" | "test" | "service";
+export type Entity = {
+    id: string;
+    category: EntityCategory;
+    filename: string;
+    stem: string;
+    extension: string | null;
+    tokens: string[];
+    path: string;
+};
+export type ScoredCandidate = {
+    entity: Entity;
+    breakdown: ScoreBreakdown;
+    reasons: string[];
+};
+export type ScoreBreakdown = {
+    lexical: number;
+    typeHint: number;
+    context: number;
+    recency: number;
+    total: number;
+};
+export type ConfidenceLevel = "high" | "medium" | "low";
+export type Confidence = {
+    level: ConfidenceLevel;
+    score: number;
+    gap: number;
+    reason: string;
+};
+export type EntityReference = {
+    raw: string;
+    resolved: Entity | null;
+    candidates: ScoredCandidate[];
+    confidence: Confidence;
+};
+export type EntityResolution = {
+    references: EntityReference[];
+    resolved: EntityReference[];
+    ambiguous: EntityReference[];
+    modifiedInput: string;
+};
+export type ExplorationBudget = {
+    maxSteps: number;
+    maxExplorations: number;
+    maxToolCalls: number;
+    stepsUsed: number;
+    explorationsUsed: number;
+    toolCallsUsed: number;
+};
+export type PendingIntent = {
+    action: string | null;
+    unresolvedEntity: string | null;
+    originalInput: string;
+    turn: number;
+    failed: boolean;
+};
+export type ConversationState = {
+    currentGoal: string;
+    currentTarget: string | null;
+    lastResolvedEntity: string | null;
+    lastResolvedType: EntityCategory | null;
+    pendingTask: string | null;
+    turnCount: number;
+    pendingIntent: PendingIntent | null;
+};
+export type EntityHandle = {
+    id: string;
+    label: string;
+    path: string;
+    category: EntityCategory;
+};
+export type ResolutionTraceEntry = {
+    query: string;
+    candidates: ScoredCandidate[];
+    confidence: number;
+    action: "auto_resolved" | "injected" | "explored" | "failed";
+    exploration?: string;
+};
+export type ResolverContext = {
+    userMessage: string;
+    conversationHistory: {
+        role: string;
+        content: string;
+    }[];
+    conversationState: ConversationState;
+    cwd: string;
+    entityIndex: any;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../agent/entity-resolver/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,68 @@
+import { GraphFlow } from "../execution/index";
+import { AgentContext, DecisionOutput, ExecutorConfig } from "../types/agent";
+import { BaseAgent } from "./base";
+import { AgentExecutor } from "./base/executor";
+import { AgentLogger } from "./tools/logger";
+import { EntityIndex } from "./entity-resolver";
+export declare class GenericExecutor extends AgentExecutor {
+    private verbose;
+    private llm;
+    private logger;
+    private cognitiveHandler;
+    private enableSchedule;
+    private enableReflection;
+    private agenda;
+    private entityIndex;
+    constructor(agent: BaseAgent, graphs: GraphFlow<any>[], config: ExecutorConfig, logger?: AgentLogger, options?: {
+        dynamicGoal?: boolean;
+        dynamicGoalPrompt?: string;
+        dynamicNext?: boolean;
+        dynamicNextPrompt?: string;
+        enableSchedule?: boolean;
+        enableReflection?: boolean;
+        agenda?: any;
+    });
+    setDynamicGoal(enabled: boolean, customPrompt?: string): void;
+    getCurrentGoal(): string;
+    getCurrentState(): string;
+    setCurrentState(state: string): void;
+    getAvailableNodes(): string[];
+    setLogger(logger: AgentLogger): void;
+    setEntityIndex(index: EntityIndex): void;
+    computeNextState(context: AgentContext, currentState: string, iteration: number): Promise<string>;
+    scheduleTask(cronExpression: string, request: string): Promise<string | null>;
+    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;
+    private buildSystemPrompt;
+    updateDynamicGoal(context: AgentContext): Promise<string>;
+    reflect(context: AgentContext): Promise<{
+        learning: string;
+        adjustedGoal?: 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>;
+    decomposeTask(actions: any[], context: AgentContext): Promise<{
+        groups: any[][];
+        response: string;
+    }>;
+    /**
+     * 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/agent/generic-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-executor.d.ts","sourceRoot":"","sources":["../../agent/generic-executor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAEL,YAAY,EACZ,cAAc,EACd,cAAc,EAEf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAY,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,qBAAa,eAAgB,SAAQ,aAAa;IAChD,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,GAAG,CAA0C;IACrD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,WAAW,CAA4B;gBAG7C,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,EACxB,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,MAAM,CAAC,EAAE,GAAG,CAAC;KACd;IAkBH,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM;IAOtD,cAAc,IAAI,MAAM;IAIxB,eAAe,IAAI,MAAM;IAIzB,eAAe,CAAC,KAAK,EAAE,MAAM;IAI7B,iBAAiB,IAAI,MAAM,EAAE;IAI7B,SAAS,CAAC,MAAM,EAAE,WAAW;IAI7B,cAAc,CAAC,KAAK,EAAE,WAAW;IAI3B,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIjG,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmBnF,OAAO,CAAC,GAAG;IAiBX;;;;OAIG;IACH,SAAS,CAAC,oBAAoB,IAAI,MAAM;YAkC1B,iBAAiB;IA6IzB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzD,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA4C1F;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IA+F5D,aAAa,CACjB,OAAO,EAAE,GAAG,EAAE,EACd,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC;QAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IA6CjD;;;;;;;;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;CAgMjB"}