universal-agent-memory 0.4.0 → 0.5.0

package/dist/generators/template-loader.js

@@ -0,0 +1,291 @@
+import Handlebars from 'handlebars';
+import { existsSync, readFileSync, readdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Default section definitions.
+ */
+export const DEFAULT_SECTIONS = [
+    { id: 'header', file: 'header.hbs', required: true, tokenEstimate: 50 },
+    { id: 'directives', file: 'directives.hbs', required: true, tokenEstimate: 200 },
+    { id: 'session-start', file: 'session-start.hbs', required: true, tokenEstimate: 150 },
+    { id: 'coordination', file: 'coordination.hbs', required: true, tokenEstimate: 400 },
+    { id: 'decision-loop', file: 'decision-loop.hbs', required: true, tokenEstimate: 300 },
+    { id: 'memory-system', file: 'memory-system.hbs', required: true, tokenEstimate: 500 },
+    { id: 'worktree', file: 'worktree.hbs', required: true, tokenEstimate: 200 },
+    { id: 'parallel-review', file: 'parallel-review.hbs', required: true, tokenEstimate: 250 },
+    { id: 'triggers', file: 'triggers.hbs', required: true, tokenEstimate: 150 },
+    {
+        id: 'repository',
+        file: 'repository.hbs',
+        required: false,
+        condition: (a) => !!a.components?.length,
+        tokenEstimate: 300
+    },
+    {
+        id: 'architecture',
+        file: 'architecture.hbs',
+        required: false,
+        condition: (analysis) => !!analysis.infrastructure?.iac || analysis.components?.length > 3,
+        tokenEstimate: 400
+    },
+    {
+        id: 'components',
+        file: 'components.hbs',
+        required: false,
+        condition: (a) => (a.components?.length || 0) > 0,
+        tokenEstimate: 300
+    },
+    {
+        id: 'auth',
+        file: 'auth.hbs',
+        required: false,
+        condition: (a) => !!a.authentication,
+        tokenEstimate: 200
+    },
+    { id: 'quick-reference', file: 'quick-reference.hbs', required: false, tokenEstimate: 250 },
+    {
+        id: 'skills-droids',
+        file: 'skills-droids.hbs',
+        required: false,
+        condition: () => existsSync(join(process.cwd(), '.factory/skills')) || existsSync(join(process.cwd(), '.factory/droids')),
+        tokenEstimate: 400
+    },
+    {
+        id: 'infrastructure',
+        file: 'infrastructure.hbs',
+        required: false,
+        condition: (analysis) => (analysis.directories?.infrastructure?.length || 0) > 0,
+        tokenEstimate: 300
+    },
+    { id: 'testing', file: 'testing.hbs', required: false, tokenEstimate: 150 },
+    {
+        id: 'troubleshooting',
+        file: 'troubleshooting.hbs',
+        required: false,
+        condition: () => false, // Only include if explicitly requested
+        tokenEstimate: 300
+    },
+    { id: 'config-files', file: 'config-files.hbs', required: false, tokenEstimate: 200 },
+    { id: 'checklist', file: 'checklist.hbs', required: true, tokenEstimate: 100 },
+    {
+        id: 'knowledge',
+        file: 'knowledge.hbs',
+        required: false,
+        condition: () => false, // Only include if memory has content
+        tokenEstimate: 400
+    },
+    { id: 'footer', file: 'footer.hbs', required: true, tokenEstimate: 20 },
+];
+/**
+ * Modular template loader with lazy-loading support.
+ */
+export class TemplateLoader {
+    sectionsDir;
+    maxTokens;
+    sections;
+    compiledSections;
+    analysis = null;
+    constructor(config = {}) {
+        this.sectionsDir = config.sectionsDir || this.findSectionsDir();
+        this.maxTokens = config.maxTokens || 8000; // Conservative default
+        this.sections = [...DEFAULT_SECTIONS];
+        this.compiledSections = new Map();
+        // Apply include/exclude filters
+        if (config.includeSections) {
+            this.sections = this.sections.filter(s => s.required || config.includeSections.includes(s.id));
+        }
+        if (config.excludeSections) {
+            this.sections = this.sections.filter(s => s.required || !config.excludeSections.includes(s.id));
+        }
+        if (config.forceInclude) {
+            for (const id of config.forceInclude) {
+                const existing = this.sections.find(s => s.id === id);
+                if (existing) {
+                    existing.required = true;
+                }
+            }
+        }
+        this.registerHelpers();
+    }
+    /**
+     * Find the sections directory.
+     */
+    findSectionsDir() {
+        const locations = [
+            join(process.cwd(), 'templates/sections'),
+            join(__dirname, '../../templates/sections'),
+        ];
+        for (const loc of locations) {
+            if (existsSync(loc)) {
+                return loc;
+            }
+        }
+        // Fall back to main template if no sections exist
+        return join(__dirname, '../../templates');
+    }
+    /**
+     * Register Handlebars helpers.
+     */
+    registerHelpers() {
+        // Conditional section helper
+        Handlebars.registerHelper('section', (sectionId, options) => {
+            const section = this.sections.find(s => s.id === sectionId);
+            if (!section)
+                return '';
+            if (!this.shouldIncludeSection(section)) {
+                return '';
+            }
+            return options.fn(this);
+        });
+        // Token budget helper
+        Handlebars.registerHelper('withinBudget', (tokens, options) => {
+            if (this.getRemainingTokenBudget() >= tokens) {
+                return options.fn(this);
+            }
+            return options.inverse(this);
+        });
+    }
+    /**
+     * Set the project analysis for conditional loading.
+     */
+    setAnalysis(analysis) {
+        this.analysis = analysis;
+    }
+    /**
+     * Check if a section should be included based on conditions.
+     */
+    shouldIncludeSection(section) {
+        if (section.required)
+            return true;
+        if (section.condition && this.analysis) {
+            return section.condition(this.analysis);
+        }
+        return true; // Include by default if no condition
+    }
+    /**
+     * Get sections that should be included.
+     */
+    getIncludedSections() {
+        return this.sections.filter(s => this.shouldIncludeSection(s));
+    }
+    /**
+     * Estimate total tokens for included sections.
+     */
+    estimateTotalTokens() {
+        return this.getIncludedSections()
+            .reduce((sum, s) => sum + s.tokenEstimate, 0);
+    }
+    /**
+     * Get remaining token budget.
+     */
+    getRemainingTokenBudget() {
+        return this.maxTokens - this.estimateTotalTokens();
+    }
+    /**
+     * Load and compile a section template.
+     */
+    loadSection(sectionId) {
+        if (this.compiledSections.has(sectionId)) {
+            return this.compiledSections.get(sectionId);
+        }
+        const section = this.sections.find(s => s.id === sectionId);
+        if (!section)
+            return null;
+        const filePath = join(this.sectionsDir, section.file);
+        if (!existsSync(filePath)) {
+            return null;
+        }
+        try {
+            const content = readFileSync(filePath, 'utf-8');
+            const compiled = Handlebars.compile(content);
+            this.compiledSections.set(sectionId, compiled);
+            return compiled;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Load all sections and assemble the full template.
+     */
+    loadFullTemplate() {
+        // Check if sections directory exists
+        if (!existsSync(this.sectionsDir) || !this.hasSectionFiles()) {
+            // Fall back to monolithic template
+            return this.loadMonolithicTemplate();
+        }
+        const parts = [];
+        for (const section of this.getIncludedSections()) {
+            const filePath = join(this.sectionsDir, section.file);
+            if (existsSync(filePath)) {
+                parts.push(readFileSync(filePath, 'utf-8'));
+            }
+        }
+        return parts.join('\n\n');
+    }
+    /**
+     * Check if section files exist.
+     */
+    hasSectionFiles() {
+        try {
+            const files = readdirSync(this.sectionsDir);
+            return files.some(f => f.endsWith('.hbs'));
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Load the monolithic template as fallback.
+     */
+    loadMonolithicTemplate() {
+        const locations = [
+            join(process.cwd(), 'templates/CLAUDE.template.md'),
+            join(__dirname, '../../templates/CLAUDE.template.md'),
+        ];
+        for (const loc of locations) {
+            if (existsSync(loc)) {
+                return readFileSync(loc, 'utf-8');
+            }
+        }
+        throw new Error('No template found');
+    }
+    /**
+     * Compile the full template with context.
+     */
+    compile(context) {
+        const template = this.loadFullTemplate();
+        const compiled = Handlebars.compile(template);
+        return compiled(context);
+    }
+    /**
+     * Get a summary of what will be included.
+     */
+    getSummary() {
+        const included = this.getIncludedSections().map(s => s.id);
+        const excluded = this.sections
+            .filter(s => !this.shouldIncludeSection(s))
+            .map(s => s.id);
+        const estimatedTokens = this.estimateTotalTokens();
+        return {
+            includedSections: included,
+            excludedSections: excluded,
+            estimatedTokens,
+            withinBudget: estimatedTokens <= this.maxTokens,
+        };
+    }
+}
+/**
+ * Create section template files from the monolithic template.
+ * This is a one-time migration utility.
+ */
+export async function splitTemplateIntoSections(templatePath, outputDir) {
+    // This would be implemented to parse the monolithic template
+    // and split it into section files based on markers.
+    // For now, we use the monolithic template directly.
+    console.log(`Would split ${templatePath} into sections at ${outputDir}`);
+}
+//# sourceMappingURL=template-loader.js.map

package/dist/generators/template-loader.js.map

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

package/dist/memory/serverless-qdrant.d.ts

@@ -0,0 +1,102 @@
+import type { QdrantServerlessConfig } from '../types/config.js';
+/**
+ * Serverless Qdrant manager for cost-optimized vector storage.
+ * Supports lazy-start local Docker instances and cloud serverless backends.
+ */
+export declare class ServerlessQdrantManager {
+    private config;
+    private lastActivityTime;
+    private healthCheckInterval;
+    private idleCheckInterval;
+    private isStarting;
+    private inMemoryFallback;
+    constructor(config: QdrantServerlessConfig);
+    /**
+     * Normalize and fill in default config values.
+     */
+    private normalizeConfig;
+    /**
+     * Get the current environment (dev/prod).
+     */
+    private getEnvironment;
+    /**
+     * Get the effective backend based on mode and environment.
+     */
+    getEffectiveBackend(): 'local' | 'cloud' | 'memory';
+    /**
+     * Get the Qdrant endpoint URL.
+     */
+    getEndpoint(): Promise<string>;
+    /**
+     * Get the API key for cloud backend.
+     */
+    getApiKey(): string | undefined;
+    /**
+     * Check if local Qdrant is running.
+     */
+    private isLocalRunning;
+    /**
+     * Start local Qdrant Docker container.
+     */
+    private startLocal;
+    /**
+     * Stop local Qdrant Docker container.
+     */
+    private stopLocal;
+    /**
+     * Ensure local Qdrant is running, starting it if needed.
+     */
+    ensureLocalRunning(): Promise<void>;
+    /**
+     * Record activity to reset idle timer.
+     */
+    recordActivity(): void;
+    /**
+     * Start health check and idle monitoring.
+     */
+    private startMonitoring;
+    /**
+     * Stop monitoring intervals.
+     */
+    private stopMonitoring;
+    /**
+     * Store vectors with automatic backend selection.
+     */
+    store(collection: string, vectors: Array<{
+        id: string;
+        vector: number[];
+        payload: Record<string, unknown>;
+    }>): Promise<void>;
+    /**
+     * Search vectors with automatic backend selection.
+     */
+    search(collection: string, vector: number[], limit?: number): Promise<Array<{
+        id: string;
+        score: number;
+        payload: Record<string, unknown>;
+    }>>;
+    /**
+     * Simple in-memory cosine similarity search (fallback).
+     */
+    private inMemorySearch;
+    /**
+     * Calculate cosine similarity between two vectors.
+     */
+    private cosineSimilarity;
+    /**
+     * Gracefully shutdown the manager.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Get current status.
+     */
+    getStatus(): {
+        backend: 'local' | 'cloud' | 'memory';
+        localRunning: boolean;
+        lastActivity: number;
+        inMemorySize: number;
+    };
+}
+export declare function getServerlessQdrantManager(config?: QdrantServerlessConfig): ServerlessQdrantManager;
+export declare function initServerlessQdrant(config: QdrantServerlessConfig): ServerlessQdrantManager;
+//# sourceMappingURL=serverless-qdrant.d.ts.map

package/dist/memory/serverless-qdrant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverless-qdrant.d.ts","sourceRoot":"","sources":["../../src/memory/serverless-qdrant.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;;GAGG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,gBAAgB,CAAsB;IAC9C,OAAO,CAAC,mBAAmB,CAA+B;IAC1D,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,gBAAgB,CAAqC;gBAEjD,MAAM,EAAE,sBAAsB;IAI1C;;OAEG;IACH,OAAO,CAAC,eAAe;IA8BvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAiBtB;;OAEG;IACH,mBAAmB,IAAI,OAAO,GAAG,OAAO,GAAG,QAAQ;IAwBnD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAmBpC;;OAEG;IACH,SAAS,IAAI,MAAM,GAAG,SAAS;IAI/B;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;YACW,UAAU;IAuDxB;;OAEG;YACW,SAAS;IAUvB;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAYzC;;OAEG;IACH,cAAc,IAAI,IAAI;IAItB;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACG,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkClI;;OAEG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,GAAE,MAAU,GAChB,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAmClF;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ/B;;OAEG;IACH,SAAS,IAAI;QACX,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;QACtC,YAAY,EAAE,OAAO,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;KACtB;CASF;AAOD,wBAAgB,0BAA0B,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,uBAAuB,CAQnG;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,GAAG,uBAAuB,CAG5F"}