cccmemory 1.8.0

package/dist/embeddings/providers/OpenAIEmbeddings.js

@@ -0,0 +1,129 @@
+/**
+ * OpenAI Embeddings Provider
+ * Uses OpenAI API for high-quality embeddings
+ */
+import { getModelDimensions } from "../ModelRegistry.js";
+export class OpenAIEmbeddings {
+    client = null;
+    model;
+    dimensions;
+    apiKey;
+    available = false;
+    initializationError = null;
+    constructor(apiKey, model = "text-embedding-3-small", dimensions) {
+        this.apiKey = apiKey;
+        this.model = model;
+        this.dimensions = dimensions || this.getDefaultDimensions(model);
+    }
+    /**
+     * Initialize OpenAI client
+     */
+    async initialize() {
+        try {
+            if (!this.apiKey) {
+                throw new Error("OpenAI API key required. Set OPENAI_API_KEY environment variable.");
+            }
+            // Dynamic import of OpenAI SDK (optional dependency)
+            const { default: OpenAI } = await import("openai");
+            this.client = new OpenAI({
+                apiKey: this.apiKey,
+            });
+            // Test the API key with a small request
+            await this.client.embeddings.create({
+                model: this.model,
+                input: "test",
+            });
+            this.available = true;
+            console.error(`✓ OpenAI embeddings ready (${this.model})`);
+        }
+        catch (error) {
+            this.initializationError = error;
+            this.available = false;
+            if (error.message.includes("Cannot find module")) {
+                console.error("⚠️ OpenAI SDK not installed");
+                console.error("   Install with: npm install openai");
+            }
+            else {
+                console.error("⚠️ OpenAI initialization failed:", error.message);
+            }
+        }
+    }
+    /**
+     * Check if embeddings are available
+     */
+    isAvailable() {
+        return this.available;
+    }
+    /**
+     * Generate embedding for a single text
+     */
+    async embed(text) {
+        if (!this.available || !this.client) {
+            throw new Error(`OpenAI embeddings not available: ${this.initializationError?.message || "Not initialized"}`);
+        }
+        try {
+            const response = await this.client.embeddings.create({
+                model: this.model,
+                input: text,
+            });
+            return new Float32Array(response.data[0].embedding);
+        }
+        catch (error) {
+            console.error("Error generating embedding with OpenAI:", error);
+            throw error;
+        }
+    }
+    /**
+     * Generate embeddings for multiple texts (batched)
+     * OpenAI supports batch requests natively
+     */
+    async embedBatch(texts, batchSize = 100) {
+        if (!this.available || !this.client) {
+            throw new Error("OpenAI embeddings not initialized");
+        }
+        const embeddings = [];
+        // OpenAI allows up to 2048 inputs per request, but we use smaller batches for reliability
+        for (let i = 0; i < texts.length; i += batchSize) {
+            const batch = texts.slice(i, i + batchSize);
+            console.error(`Generating embeddings for batch ${Math.floor(i / batchSize) + 1}/${Math.ceil(texts.length / batchSize)} (OpenAI)`);
+            try {
+                const response = await this.client.embeddings.create({
+                    model: this.model,
+                    input: batch,
+                });
+                // Convert all embeddings in the batch
+                const batchEmbeddings = response.data.map((item) => new Float32Array(item.embedding));
+                embeddings.push(...batchEmbeddings);
+            }
+            catch (error) {
+                console.error("Error in batch embedding:", error);
+                throw error;
+            }
+        }
+        return embeddings;
+    }
+    /**
+     * Get model information
+     */
+    getModelInfo() {
+        return {
+            provider: "openai",
+            model: this.model,
+            dimensions: this.dimensions,
+            available: this.available,
+        };
+    }
+    /**
+     * Get default dimensions for OpenAI models using ModelRegistry
+     */
+    getDefaultDimensions(model) {
+        // Try to get dimensions from ModelRegistry
+        const dimensions = getModelDimensions(model);
+        if (dimensions) {
+            return dimensions;
+        }
+        // Default to 1536 if unknown (most common for OpenAI models)
+        return 1536;
+    }
+}
+//# sourceMappingURL=OpenAIEmbeddings.js.map

package/dist/embeddings/providers/OpenAIEmbeddings.js.map

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

package/dist/embeddings/providers/TransformersEmbeddings.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Transformers.js Embeddings Provider
+ * Uses @xenova/transformers for local, offline embeddings
+ */
+import type { EmbeddingProvider, ModelInfo } from "../EmbeddingProvider.js";
+export declare class TransformersEmbeddings implements EmbeddingProvider {
+    private pipeline;
+    private model;
+    private dimensions;
+    private available;
+    private initializationError;
+    constructor(model?: string, dimensions?: number);
+    /**
+     * Initialize the embedding pipeline
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if embeddings are available
+     */
+    isAvailable(): boolean;
+    /**
+     * Generate embedding for text
+     */
+    embed(text: string): Promise<Float32Array>;
+    /**
+     * Generate embeddings for multiple texts (batched)
+     */
+    embedBatch(texts: string[], batchSize?: number): Promise<Float32Array[]>;
+    /**
+     * Get model information
+     */
+    getModelInfo(): ModelInfo;
+    /**
+     * Get default dimensions for common transformer models using ModelRegistry
+     */
+    private getDefaultDimensions;
+}
+//# sourceMappingURL=TransformersEmbeddings.d.ts.map

package/dist/embeddings/providers/TransformersEmbeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransformersEmbeddings.d.ts","sourceRoot":"","sources":["../../../src/embeddings/providers/TransformersEmbeddings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAM5E,qBAAa,sBAAuB,YAAW,iBAAiB;IAC9D,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,mBAAmB,CAAsB;gBAErC,KAAK,GAAE,MAAkC,EAAE,UAAU,CAAC,EAAE,MAAM;IAK1E;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BjC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA4BhD;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,MAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAyBlF;;OAEG;IACH,YAAY,IAAI,SAAS;IASzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAU7B"}

package/dist/embeddings/providers/TransformersEmbeddings.js

@@ -0,0 +1,115 @@
+/**
+ * Transformers.js Embeddings Provider
+ * Uses @xenova/transformers for local, offline embeddings
+ */
+import { getModelDimensions } from "../ModelRegistry.js";
+export class TransformersEmbeddings {
+    pipeline = null;
+    model;
+    dimensions;
+    available = false;
+    initializationError = null;
+    constructor(model = "Xenova/all-MiniLM-L6-v2", dimensions) {
+        this.model = model;
+        this.dimensions = dimensions || this.getDefaultDimensions(model);
+    }
+    /**
+     * Initialize the embedding pipeline
+     */
+    async initialize() {
+        if (this.available) {
+            return;
+        }
+        try {
+            // Try to import @xenova/transformers
+            const { pipeline } = await import("@xenova/transformers");
+            console.error(`Loading embedding model: ${this.model}...`);
+            this.pipeline = (await pipeline("feature-extraction", this.model));
+            this.available = true;
+            console.error(`✓ Transformers.js embeddings ready (${this.model})`);
+        }
+        catch (error) {
+            this.initializationError = error;
+            this.available = false;
+            if (error.message.includes("Cannot find module")) {
+                console.error("⚠️ @xenova/transformers not installed");
+                console.error("   Install with: npm install @xenova/transformers");
+            }
+            else {
+                console.error("⚠️ Could not load embedding model:", error.message);
+            }
+        }
+    }
+    /**
+     * Check if embeddings are available
+     */
+    isAvailable() {
+        return this.available && this.pipeline !== null;
+    }
+    /**
+     * Generate embedding for text
+     */
+    async embed(text) {
+        if (!this.isAvailable()) {
+            throw new Error(`Transformers embeddings not available: ${this.initializationError?.message || "Not initialized"}`);
+        }
+        if (!this.pipeline) {
+            throw new Error("Pipeline not initialized");
+        }
+        try {
+            // Generate embedding
+            const output = await this.pipeline(text, {
+                pooling: "mean",
+                normalize: true,
+            });
+            // Extract the embedding array
+            const embedding = output.data;
+            return new Float32Array(embedding);
+        }
+        catch (error) {
+            console.error("Error generating embedding:", error);
+            throw error;
+        }
+    }
+    /**
+     * Generate embeddings for multiple texts (batched)
+     */
+    async embedBatch(texts, batchSize = 32) {
+        if (!this.isAvailable()) {
+            throw new Error("Transformers embeddings not initialized");
+        }
+        const embeddings = [];
+        // Process in batches
+        for (let i = 0; i < texts.length; i += batchSize) {
+            const batch = texts.slice(i, i + batchSize);
+            console.error(`Generating embeddings for batch ${Math.floor(i / batchSize) + 1}/${Math.ceil(texts.length / batchSize)} (Transformers.js)`);
+            const batchEmbeddings = await Promise.all(batch.map((text) => this.embed(text)));
+            embeddings.push(...batchEmbeddings);
+        }
+        return embeddings;
+    }
+    /**
+     * Get model information
+     */
+    getModelInfo() {
+        return {
+            provider: "transformers",
+            model: this.model,
+            dimensions: this.dimensions,
+            available: this.available,
+        };
+    }
+    /**
+     * Get default dimensions for common transformer models using ModelRegistry
+     */
+    getDefaultDimensions(model) {
+        // Try to get dimensions from ModelRegistry
+        const dimensions = getModelDimensions(model);
+        if (dimensions) {
+            return dimensions;
+        }
+        // Default to 384 if unknown (most common for small models)
+        return 384;
+    }
+}
+//# sourceMappingURL=TransformersEmbeddings.js.map

package/dist/embeddings/providers/TransformersEmbeddings.js.map

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

package/dist/handoff/SessionHandoffStore.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Session Handoff Store
+ *
+ * Manages session handoff documents for transferring context between
+ * conversations when context fills up or when explicitly requested.
+ */
+import type { Database } from "better-sqlite3";
+import type { SessionHandoff } from "../memory/types.js";
+/**
+ * Options for creating a handoff
+ */
+export interface PrepareHandoffOptions {
+    sessionId?: string;
+    projectPath: string;
+    include?: Array<"decisions" | "files" | "tasks" | "memory">;
+}
+/**
+ * Options for resuming from a handoff
+ */
+export interface ResumeHandoffOptions {
+    handoffId?: string;
+    projectPath: string;
+    newSessionId?: string;
+    injectContext?: boolean;
+}
+export declare class SessionHandoffStore {
+    private db;
+    constructor(db: Database);
+    /**
+     * Prepare a handoff document from the current session
+     */
+    prepareHandoff(options: PrepareHandoffOptions): SessionHandoff;
+    /**
+     * Resume from a handoff in a new session
+     */
+    resumeFromHandoff(options: ResumeHandoffOptions): SessionHandoff | null;
+    /**
+     * List available handoffs for a project
+     */
+    listHandoffs(projectPath: string, options?: {
+        limit?: number;
+        includeResumed?: boolean;
+    }): Array<{
+        id: string;
+        fromSessionId: string;
+        createdAt: number;
+        resumedBy?: string;
+        resumedAt?: number;
+        summary: string;
+    }>;
+    /**
+     * Get a specific handoff by ID
+     */
+    getHandoff(handoffId: string): SessionHandoff | null;
+    /**
+     * Delete a handoff by ID
+     */
+    deleteHandoff(handoffId: string): boolean;
+    /**
+     * Get recent decisions from the database
+     */
+    private getRecentDecisions;
+    /**
+     * Get recent file activity from tool uses
+     */
+    private getActiveFiles;
+    /**
+     * Get pending tasks from working memory
+     */
+    private getPendingTasks;
+    /**
+     * Infer task status from tags
+     */
+    private inferTaskStatus;
+    /**
+     * Generate a context summary from handoff data
+     */
+    private generateContextSummary;
+}
+//# sourceMappingURL=SessionHandoffStore.d.ts.map

package/dist/handoff/SessionHandoffStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionHandoffStore.d.ts","sourceRoot":"","sources":["../../src/handoff/SessionHandoffStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EACV,cAAc,EAMf,MAAM,oBAAoB,CAAC;AAG5B;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAaD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,EAAE,CAAW;gBAET,EAAE,EAAE,QAAQ;IAIxB;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc;IA6D9D;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,cAAc,GAAG,IAAI;IAkEvE;;OAEG;IACH,YAAY,CACV,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GACrD,KAAK,CAAC;QACP,EAAE,EAAE,MAAM,CAAC;QACX,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAyBF;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAsBpD;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAQzC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqC1B;;OAEG;IACH,OAAO,CAAC,cAAc;IA8DtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;CA+B/B"}