agent-nuvira 1.14.0

package/dist/memory/embedder.js.map

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

package/dist/memory/memory-integration.d.ts

@@ -0,0 +1,56 @@
+/**
+ * MemoryIntegration — Connects the persistent memory system to the Orchestrator.
+ *
+ * This module provides the glue between agent execution and memory:
+ * - Before planning: retrieves similar past trajectories as few-shot examples
+ * - After execution: stores the successful trajectory for future use
+ *
+ * The Orchestrator calls these hooks when the `useMemory` option is enabled.
+ */
+import type { TaskStep } from '../agents/agent.js';
+import type { LLMCallFn } from '../agents/agent.js';
+import type { OrchestrationResult } from '../agents/orchestrator.js';
+import type { Trajectory } from './trajectory-store.js';
+/**
+ * Retrieve relevant past trajectories to use as few-shot examples
+ * for the PlannerAgent.
+ *
+ * @param goal     The current user goal
+ * @param callLLM  LLM function for embedding generation
+ * @param k        Maximum number of trajectories to retrieve
+ * @returns        An object with:
+ *   - trajectories: the raw trajectory objects
+ *   - fewShotContext: formatted string for injection into planner prompts
+ */
+export declare function retrieveMemoryContext(goal: string, callLLM: LLMCallFn, k?: number): Promise<{
+    trajectories: Trajectory[];
+    fewShotContext: string;
+    patternContext: string;
+}>;
+/**
+ * Store a successful orchestration result as a trajectory for future use.
+ * This is called at the end of the orchestration pipeline.
+ *
+ * @param result         The orchestration result
+ * @param callLLM        LLM function for embedding generation
+ * @param taskPlan       The task plan that was executed
+ * @param contextFiles   The files that were gathered as context
+ * @param verbose        Whether to log details
+ * @returns              The trajectory ID, or empty string if not saved
+ */
+export declare function storeExecutionTrajectory(result: OrchestrationResult, callLLM: LLMCallFn, taskPlan: TaskStep[], contextFiles: string[], verbose?: boolean): Promise<string>;
+/**
+ * Get memory storage statistics.
+ */
+export declare function getMemoryStats(): Promise<{
+    total: number;
+    avgScore: number;
+    byProjectFingerprint: Record<string, number>;
+}>;
+/**
+ * Clear all stored memory (trajectories and vector index).
+ * Also resets the embedding tier cache so native embeddings (Xenova/Python)
+ * can be re-detected on the next embedding call.
+ */
+export declare function clearMemory(): Promise<void>;
+//# sourceMappingURL=memory-integration.d.ts.map

package/dist/memory/memory-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-integration.d.ts","sourceRoot":"","sources":["../../src/memory/memory-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,EAClB,CAAC,GAAE,MAAU,GACZ,OAAO,CAAC;IACT,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC,CAmBD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,QAAQ,EAAE,EACpB,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C,CAAC,CAGD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAYjD"}

package/dist/memory/memory-integration.js

@@ -0,0 +1,95 @@
+/**
+ * MemoryIntegration — Connects the persistent memory system to the Orchestrator.
+ *
+ * This module provides the glue between agent execution and memory:
+ * - Before planning: retrieves similar past trajectories as few-shot examples
+ * - After execution: stores the successful trajectory for future use
+ *
+ * The Orchestrator calls these hooks when the `useMemory` option is enabled.
+ */
+import { getTrajectoryStore } from './trajectory-store.js';
+import { getPatternStore } from '../learning/pattern-extractor.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Retrieve relevant past trajectories to use as few-shot examples
+ * for the PlannerAgent.
+ *
+ * @param goal     The current user goal
+ * @param callLLM  LLM function for embedding generation
+ * @param k        Maximum number of trajectories to retrieve
+ * @returns        An object with:
+ *   - trajectories: the raw trajectory objects
+ *   - fewShotContext: formatted string for injection into planner prompts
+ */
+export async function retrieveMemoryContext(goal, callLLM, k = 3) {
+    const store = getTrajectoryStore();
+    const trajectories = await store.searchByGoal(goal, callLLM, k);
+    const fewShotContext = store.formatAsFewShot(trajectories);
+    // Also retrieve relevant coding patterns
+    let patternContext = '';
+    try {
+        const patternStore = getPatternStore();
+        // Use the first trajectory's project fingerprint for domain matching
+        const domainTags = trajectories.length > 0
+            ? trajectories[0].projectFingerprint.split(',').map((s) => s.trim())
+            : [];
+        patternContext = patternStore.formatAsPrompt(domainTags);
+    }
+    catch {
+        // Non-critical — patterns are optional
+    }
+    return { trajectories, fewShotContext, patternContext: patternContext || '' };
+}
+/**
+ * Store a successful orchestration result as a trajectory for future use.
+ * This is called at the end of the orchestration pipeline.
+ *
+ * @param result         The orchestration result
+ * @param callLLM        LLM function for embedding generation
+ * @param taskPlan       The task plan that was executed
+ * @param contextFiles   The files that were gathered as context
+ * @param verbose        Whether to log details
+ * @returns              The trajectory ID, or empty string if not saved
+ */
+export async function storeExecutionTrajectory(result, callLLM, taskPlan, contextFiles, verbose = false) {
+    try {
+        const store = getTrajectoryStore();
+        const id = await store.save(result, callLLM, taskPlan, contextFiles);
+        if (id && verbose) {
+            logger.success(`   Stored execution trajectory: ${id}`);
+        }
+        return id;
+    }
+    catch (err) {
+        if (verbose) {
+            logger.debug(`Failed to store trajectory: ${err}`);
+        }
+        return '';
+    }
+}
+/**
+ * Get memory storage statistics.
+ */
+export async function getMemoryStats() {
+    const store = getTrajectoryStore();
+    return store.stats();
+}
+/**
+ * Clear all stored memory (trajectories and vector index).
+ * Also resets the embedding tier cache so native embeddings (Xenova/Python)
+ * can be re-detected on the next embedding call.
+ */
+export async function clearMemory() {
+    const store = getTrajectoryStore();
+    await store.clear();
+    // Reset embedding tier cache — allows re-detection of newly installed
+    // @huggingface/transformers or sentence-transformers packages
+    try {
+        const { resetEmbeddingTierCache } = await import('./embedder.js');
+        resetEmbeddingTierCache();
+    }
+    catch {
+        // Non-critical
+    }
+}
+//# sourceMappingURL=memory-integration.js.map

package/dist/memory/memory-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-integration.js","sourceRoot":"","sources":["../../src/memory/memory-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAY,EACZ,OAAkB,EAClB,IAAY,CAAC;IAMb,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAChE,MAAM,cAAc,GAAG,KAAK,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;IAE3D,yCAAyC;IACzC,IAAI,cAAc,GAAG,EAAE,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,qEAAqE;QACrE,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC;YACxC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACpE,CAAC,CAAC,EAAE,CAAC;QACP,cAAc,GAAG,YAAY,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;IACzC,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,IAAI,EAAE,EAAE,CAAC;AAChF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAA2B,EAC3B,OAAkB,EAClB,QAAoB,EACpB,YAAsB,EACtB,UAAmB,KAAK;IAExB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;QACnC,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;QAErE,IAAI,EAAE,IAAI,OAAO,EAAE,CAAC;YAClB,MAAM,CAAC,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAKlC,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IAEpB,sEAAsE;IACtE,8DAA8D;IAC9D,IAAI,CAAC;QACH,MAAM,EAAE,uBAAuB,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAClE,uBAAuB,EAAE,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;AACH,CAAC"}

package/dist/memory/trajectory-store.d.ts

@@ -0,0 +1,149 @@
+/**
+ * TrajectoryStore — Stores and retrieves successful agent execution trajectories.
+ *
+ * A trajectory captures a full agent session: the goal, the plan,
+ * what files were touched, what changes were made, and the outcome.
+ * This data is stored in a JSON file and indexed via the VectorStore
+ * for semantic similarity search.
+ *
+ * When a new goal arrives, the Orchestrator queries past trajectories
+ * and injects similar ones as few-shot examples into agent prompts.
+ *
+ * File location: ~/.buff/memory/trajectories.json
+ */
+import type { TaskStep } from '../agents/agent.js';
+import type { OrchestrationResult } from '../agents/orchestrator.js';
+import type { LLMCallFn } from '../agents/agent.js';
+/** A lightweight summary of a task step, suitable for few-shot prompting */
+export interface TrajectoryStep {
+    id: string;
+    description: string;
+    agentType: string;
+}
+/** A stored agent execution trajectory */
+export interface Trajectory {
+    /** Unique identifier */
+    id: string;
+    /** The original user goal */
+    goal: string;
+    /** A concise description of the project's tech stack / domain */
+    projectFingerprint: string;
+    /** The execution plan (lightweight — descriptions only, no full content) */
+    taskPlan: TrajectoryStep[];
+    /** File paths that were read as context */
+    contextFiles: string[];
+    /** File changes (just paths and status, not full diffs) */
+    fileChanges: Array<{
+        path: string;
+        status: string;
+    }>;
+    /** How many agent steps completed successfully */
+    tasksCompleted: number;
+    tasksTotal: number;
+    /** Quality score (0-1) — higher = more reliable trajectory */
+    score: number;
+    /** When this trajectory was created */
+    timestamp: number;
+}
+/**
+ * Manages the storage and retrieval of agent execution trajectories.
+ */
+export declare class TrajectoryStore {
+    /**
+     * Save a successful orchestration result as a trajectory.
+     * Also indexes it in the VectorStore for semantic search.
+     *
+     * @param result       The orchestration result to save
+     * @param callLLM      LLM function for generating the embedding vector
+     * @param taskPlan     The original task plan steps
+     * @returns            The trajectory ID
+     */
+    save(result: OrchestrationResult, callLLM: LLMCallFn, taskPlan: TaskStep[], contextFiles: string[]): Promise<string>;
+    /**
+     * Retrieve a single trajectory by ID.
+     */
+    get(id: string): Promise<Trajectory | null>;
+    /**
+     * Search for trajectories similar to a goal.
+     *
+     * @param goal      The goal text to search by
+     * @param callLLM   LLM function for generating the query embedding
+     * @param k         Maximum number of results
+     * @returns         Array of trajectories sorted by relevance
+     */
+    searchByGoal(goal: string, callLLM: LLMCallFn, k?: number): Promise<Trajectory[]>;
+    /**
+     * Format trajectories as few-shot examples for agent prompts.
+     * Truncates plans to the first 5 steps to save token budget.
+     * Returns a string that can be injected into the PlannerAgent's prompt.
+     */
+    formatAsFewShot(trajectories: Trajectory[]): string;
+    /**
+     * Get statistics about stored trajectories.
+     */
+    stats(): Promise<{
+        total: number;
+        avgScore: number;
+        byProjectFingerprint: Record<string, number>;
+    }>;
+    /**
+     * Get all stored trajectories.
+     */
+    getAll(): Trajectory[];
+    /**
+     * Clear all trajectories.
+     */
+    clear(): Promise<void>;
+    /**
+     * Build text to generate an embedding for a trajectory.
+     */
+    private buildEmbeddingText;
+    /**
+     * Remove oldest trajectories when the store exceeds MAX_TRAJECTORIES.
+     */
+    private pruneIfNeeded;
+    /**
+     * Summarize old trajectories by merging multiple low-scoring or old
+     * trajectories into a single compact representation.
+     *
+     * Summarization replaces a group of similar old trajectories with a
+     * single aggregated entry that retains the most important information
+     * (goal, file patterns, common steps) while discarding individual details.
+     *
+     * @param retentionDays  Keep original trajectories newer than this (default: 7)
+     * @param verbose        Log summarization details
+     * @returns              Number of trajectories summarized/removed
+     */
+    summarize(retentionDays?: number, verbose?: boolean): Promise<{
+        summarized: number;
+        merged: number;
+    }>;
+    /**
+     * Merge file changes from multiple trajectories into a unique set,
+     * preferring 'modified' status over 'read' etc.
+     */
+    private mergeFileChanges;
+    /**
+     * Prune trajectories based on configurable retention policy.
+     *
+     * @param maxAgeDays       Remove trajectories older than this (default: 90)
+     * @param minScore         Remove trajectories with score below this (default: 0.1)
+     * @param maxTrajectories  Maximum number to keep (default: 500)
+     * @param verbose          Log pruning details
+     * @returns                Number of trajectories removed
+     */
+    pruneByPolicy(maxAgeDays?: number, minScore?: number, maxTrajectories?: number, verbose?: boolean): number;
+    /**
+     * Get compression statistics showing memory usage and optimization potential.
+     */
+    getCompressionStats(): {
+        totalTrajectories: number;
+        totalSizeBytes: number;
+        oldTrajectories: number;
+        lowScoreTrajectories: number;
+        mergeableGroups: number;
+        estimatedOptimization: string;
+    };
+}
+export declare function getTrajectoryStore(): TrajectoryStore;
+//# sourceMappingURL=trajectory-store.d.ts.map

package/dist/memory/trajectory-store.d.ts.map

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