agent-knowledge 1.0.0

package/dist/embeddings/gemini.d.ts

@@ -0,0 +1,21 @@
+import type { EmbeddingProvider } from './types.js';
+/**
+ * Google Gemini embedding provider using the Generative Language API.
+ * Uses the batchEmbedContents endpoint for efficient bulk embedding.
+ */
+export declare class GeminiEmbeddingProvider implements EmbeddingProvider {
+    readonly name = "gemini";
+    readonly dimensions: number;
+    readonly model: string;
+    private readonly apiKey;
+    constructor(apiKey: string, modelOverride?: string);
+    /** Embed one or more texts, batching internally at 100 texts per request. */
+    embed(texts: string[]): Promise<number[][]>;
+    /** Embed a single text. */
+    embedOne(text: string): Promise<number[]>;
+    /** Check availability by making a test embedding request. */
+    isAvailable(): Promise<boolean>;
+    private get endpoint();
+    private requestEmbeddings;
+}
+//# sourceMappingURL=gemini.d.ts.map

package/dist/embeddings/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../src/embeddings/gemini.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAOpD;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;IAMlD,6EAA6E;IACvE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAYjD,2BAA2B;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAK/C,6DAA6D;IACvD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC,OAAO,KAAK,QAAQ,GAEnB;YAEa,iBAAiB;CAuChC"}

package/dist/embeddings/gemini.js

@@ -0,0 +1,86 @@
+const DEFAULT_MODEL = 'text-embedding-004';
+const DEFAULT_DIMENSIONS = 768;
+const MAX_BATCH_SIZE = 100;
+const TIMEOUT_MS = 30_000;
+/**
+ * Google Gemini embedding provider using the Generative Language API.
+ * Uses the batchEmbedContents endpoint for efficient bulk embedding.
+ */
+export class GeminiEmbeddingProvider {
+    name = 'gemini';
+    dimensions;
+    model;
+    apiKey;
+    constructor(apiKey, modelOverride) {
+        this.apiKey = apiKey;
+        this.model = modelOverride || DEFAULT_MODEL;
+        this.dimensions = DEFAULT_DIMENSIONS;
+    }
+    /** Embed one or more texts, batching internally at 100 texts per request. */
+    async embed(texts) {
+        if (texts.length === 0)
+            return [];
+        const results = [];
+        for (let i = 0; i < texts.length; i += MAX_BATCH_SIZE) {
+            const batch = texts.slice(i, i + MAX_BATCH_SIZE);
+            const vectors = await this.requestEmbeddings(batch);
+            results.push(...vectors);
+        }
+        return results;
+    }
+    /** Embed a single text. */
+    async embedOne(text) {
+        const results = await this.embed([text]);
+        return results[0] ?? [];
+    }
+    /** Check availability by making a test embedding request. */
+    async isAvailable() {
+        try {
+            const result = await this.embed(['test']);
+            return result.length === 1 && result[0].length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    get endpoint() {
+        return `https://generativelanguage.googleapis.com/v1beta/models/${this.model}:batchEmbedContents?key=${this.apiKey}`;
+    }
+    async requestEmbeddings(texts, retry = true) {
+        const modelPath = `models/${this.model}`;
+        const requests = texts.map((text) => ({
+            model: modelPath,
+            content: { parts: [{ text }] },
+        }));
+        try {
+            const response = await fetch(this.endpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ requests }),
+                signal: AbortSignal.timeout(TIMEOUT_MS),
+            });
+            if (response.status === 429 && retry) {
+                const retryAfter = parseInt(response.headers.get('retry-after') || '1', 10);
+                const delayMs = Math.max(retryAfter, 1) * 1000;
+                console.error(`[knowledge] Gemini rate limited, retrying in ${delayMs}ms`);
+                await sleep(delayMs);
+                return this.requestEmbeddings(texts, false);
+            }
+            if (!response.ok) {
+                const body = await response.text().catch(() => '');
+                console.error(`[knowledge] Gemini embedding request failed (${response.status}): ${body}`);
+                return texts.map(() => []);
+            }
+            const json = (await response.json());
+            return json.embeddings.map((e) => e.values);
+        }
+        catch (err) {
+            console.error('[knowledge] Gemini embedding request error:', err);
+            return texts.map(() => []);
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=gemini.js.map

package/dist/embeddings/gemini.js.map

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

package/dist/embeddings/index.d.ts

@@ -0,0 +1,4 @@
+export type { EmbeddingProvider, EmbeddingConfig, ProviderName } from './types.js';
+export { getEmbeddingConfig } from './types.js';
+export { getEmbeddingProvider, resetProvider } from './factory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/embeddings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/embeddings/index.js

@@ -0,0 +1,3 @@
+export { getEmbeddingConfig } from './types.js';
+export { getEmbeddingProvider, resetProvider } from './factory.js';
+//# sourceMappingURL=index.js.map

package/dist/embeddings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/embeddings/local.d.ts

@@ -0,0 +1,20 @@
+import type { EmbeddingProvider } from './types.js';
+/**
+ * Local embedding provider using @huggingface/transformers.
+ * Downloads the model silently on first use and caches the pipeline as a singleton.
+ */
+export declare class LocalEmbeddingProvider implements EmbeddingProvider {
+    readonly name = "local";
+    readonly dimensions: number;
+    readonly model: string;
+    private readonly batchSize;
+    constructor(modelOverride?: string, batchSize?: number);
+    /** Embed one or more texts, batching internally if needed. */
+    embed(texts: string[]): Promise<number[][]>;
+    /** Embed a single text. */
+    embedOne(text: string): Promise<number[]>;
+    /** Check if the provider is available. Attempts to load the model if not yet loaded. */
+    isAvailable(): Promise<boolean>;
+    private getPipeline;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/embeddings/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/embeddings/local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA2BpD;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,iBAAiB;IAC9D,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,aAAa,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAMtD,8DAA8D;IACxD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAsBjD,2BAA2B;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAK/C,wFAAwF;IAClF,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;YAKvB,WAAW;CAM1B"}

package/dist/embeddings/local.js

@@ -0,0 +1,73 @@
+const DEFAULT_MODEL = 'Xenova/all-MiniLM-L6-v2';
+const DEFAULT_DIMENSIONS = 384;
+const DEFAULT_BATCH_SIZE = 32;
+/** Cached pipeline instance — only loaded once. */
+let _pipeline = null;
+async function createPipeline(model) {
+    try {
+        const { pipeline } = await import('@huggingface/transformers');
+        const pipe = await pipeline('feature-extraction', model, {
+            dtype: 'fp32',
+        });
+        return pipe;
+    }
+    catch (err) {
+        console.error(`[knowledge] Failed to load embedding model ${model}:`, err);
+        return null;
+    }
+}
+/**
+ * Local embedding provider using @huggingface/transformers.
+ * Downloads the model silently on first use and caches the pipeline as a singleton.
+ */
+export class LocalEmbeddingProvider {
+    name = 'local';
+    dimensions;
+    model;
+    batchSize;
+    constructor(modelOverride, batchSize) {
+        this.model = modelOverride || DEFAULT_MODEL;
+        this.dimensions = DEFAULT_DIMENSIONS;
+        this.batchSize = batchSize ?? DEFAULT_BATCH_SIZE;
+    }
+    /** Embed one or more texts, batching internally if needed. */
+    async embed(texts) {
+        const pipe = await this.getPipeline();
+        if (!pipe)
+            return texts.map(() => []);
+        const results = [];
+        for (let i = 0; i < texts.length; i += this.batchSize) {
+            const batch = texts.slice(i, i + this.batchSize);
+            try {
+                const output = await pipe(batch, {
+                    pooling: 'mean',
+                    normalize: true,
+                });
+                const vectors = output.tolist();
+                results.push(...vectors);
+            }
+            catch (err) {
+                console.error('[knowledge] Embedding batch failed:', err);
+                results.push(...batch.map(() => []));
+            }
+        }
+        return results;
+    }
+    /** Embed a single text. */
+    async embedOne(text) {
+        const results = await this.embed([text]);
+        return results[0] ?? [];
+    }
+    /** Check if the provider is available. Attempts to load the model if not yet loaded. */
+    async isAvailable() {
+        const pipe = await this.getPipeline();
+        return pipe !== null;
+    }
+    async getPipeline() {
+        if (!_pipeline) {
+            _pipeline = createPipeline(this.model);
+        }
+        return _pipeline;
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/embeddings/local.js.map

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

package/dist/embeddings/openai.d.ts

@@ -0,0 +1,20 @@
+import type { EmbeddingProvider } from './types.js';
+/**
+ * OpenAI embedding provider using the text-embedding-3-small model.
+ * Communicates via native fetch — no SDK dependency.
+ */
+export declare class OpenAIEmbeddingProvider implements EmbeddingProvider {
+    readonly name = "openai";
+    readonly dimensions: number;
+    readonly model: string;
+    private readonly apiKey;
+    constructor(apiKey: string, modelOverride?: string);
+    /** Embed one or more texts, batching internally at 2048 texts per request. */
+    embed(texts: string[]): Promise<number[][]>;
+    /** Embed a single text. */
+    embedOne(text: string): Promise<number[]>;
+    /** Check availability by making a test embedding request. */
+    isAvailable(): Promise<boolean>;
+    private requestEmbeddings;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/embeddings/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/embeddings/openai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAQpD;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;IAMlD,8EAA8E;IACxE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAYjD,2BAA2B;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAK/C,6DAA6D;IACvD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;YASvB,iBAAiB;CAsChC"}

package/dist/embeddings/openai.js

@@ -0,0 +1,84 @@
+const DEFAULT_MODEL = 'text-embedding-3-small';
+const DEFAULT_DIMENSIONS = 1536;
+const MAX_BATCH_SIZE = 2048;
+const TIMEOUT_MS = 30_000;
+const ENDPOINT = 'https://api.openai.com/v1/embeddings';
+/**
+ * OpenAI embedding provider using the text-embedding-3-small model.
+ * Communicates via native fetch — no SDK dependency.
+ */
+export class OpenAIEmbeddingProvider {
+    name = 'openai';
+    dimensions;
+    model;
+    apiKey;
+    constructor(apiKey, modelOverride) {
+        this.apiKey = apiKey;
+        this.model = modelOverride || DEFAULT_MODEL;
+        this.dimensions = DEFAULT_DIMENSIONS;
+    }
+    /** Embed one or more texts, batching internally at 2048 texts per request. */
+    async embed(texts) {
+        if (texts.length === 0)
+            return [];
+        const results = [];
+        for (let i = 0; i < texts.length; i += MAX_BATCH_SIZE) {
+            const batch = texts.slice(i, i + MAX_BATCH_SIZE);
+            const vectors = await this.requestEmbeddings(batch);
+            results.push(...vectors);
+        }
+        return results;
+    }
+    /** Embed a single text. */
+    async embedOne(text) {
+        const results = await this.embed([text]);
+        return results[0] ?? [];
+    }
+    /** Check availability by making a test embedding request. */
+    async isAvailable() {
+        try {
+            const result = await this.embed(['test']);
+            return result.length === 1 && result[0].length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    async requestEmbeddings(texts, retry = true) {
+        try {
+            const response = await fetch(ENDPOINT, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify({ model: this.model, input: texts }),
+                signal: AbortSignal.timeout(TIMEOUT_MS),
+            });
+            if (response.status === 429 && retry) {
+                const retryAfter = parseInt(response.headers.get('retry-after') || '1', 10);
+                const delayMs = Math.max(retryAfter, 1) * 1000;
+                console.error(`[knowledge] OpenAI rate limited, retrying in ${delayMs}ms`);
+                await sleep(delayMs);
+                return this.requestEmbeddings(texts, false);
+            }
+            if (!response.ok) {
+                const body = await response.text().catch(() => '');
+                console.error(`[knowledge] OpenAI embedding request failed (${response.status}): ${body}`);
+                return texts.map(() => []);
+            }
+            const json = (await response.json());
+            // API may return embeddings out of order — sort by index
+            const sorted = json.data.sort((a, b) => a.index - b.index);
+            return sorted.map((d) => d.embedding);
+        }
+        catch (err) {
+            console.error('[knowledge] OpenAI embedding request error:', err);
+            return texts.map(() => []);
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=openai.js.map

package/dist/embeddings/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../src/embeddings/openai.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG,wBAAwB,CAAC;AAC/C,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,cAAc,GAAG,IAAI,CAAC;AAC5B,MAAM,UAAU,GAAG,MAAM,CAAC;AAC1B,MAAM,QAAQ,GAAG,sCAAsC,CAAC;AAExD;;;GAGG;AACH,MAAM,OAAO,uBAAuB;IACzB,IAAI,GAAG,QAAQ,CAAC;IAChB,UAAU,CAAS;IACnB,KAAK,CAAS;IACN,MAAM,CAAS;IAEhC,YAAY,MAAc,EAAE,aAAsB;QAChD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,aAAa,IAAI,aAAa,CAAC;QAC5C,IAAI,CAAC,UAAU,GAAG,kBAAkB,CAAC;IACvC,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,KAAK,CAAC,KAAe;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAElC,MAAM,OAAO,GAAe,EAAE,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,cAAc,EAAE,CAAC;YACtD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC;YACjD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,2BAA2B;IAC3B,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,WAAW;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAC1C,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,KAAe,EAAE,KAAK,GAAG,IAAI;QAC3D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;gBACrC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;iBACvC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;gBACzD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC;aACxC,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;gBACrC,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC5E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;gBAC/C,OAAO,CAAC,KAAK,CAAC,gDAAgD,OAAO,IAAI,CAAC,CAAC;gBAC3E,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;gBACrB,OAAO,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC9C,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBACnD,OAAO,CAAC,KAAK,CAAC,gDAAgD,QAAQ,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;gBAC3F,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC7B,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAElC,CAAC;YAEF,yDAAyD;YACzD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;YAC3D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,6CAA6C,EAAE,GAAG,CAAC,CAAC;YAClE,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;CACF;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/embeddings/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Embedding provider interface — all providers (local, OpenAI, Claude, Gemini) implement this.
+ */
+export interface EmbeddingProvider {
+    /** Provider identifier */
+    readonly name: string;
+    /** Vector dimensions produced by this provider */
+    readonly dimensions: number;
+    /** Model identifier */
+    readonly model: string;
+    /**
+     * Embed one or more texts. Returns array of float arrays.
+     * Implementations MUST handle batching internally if needed.
+     */
+    embed(texts: string[]): Promise<number[][]>;
+    /**
+     * Embed a single text. Convenience wrapper.
+     */
+    embedOne(text: string): Promise<number[]>;
+    /**
+     * Check if the provider is available (model downloaded, API key valid, etc.)
+     */
+    isAvailable(): Promise<boolean>;
+}
+export type ProviderName = 'local' | 'openai' | 'claude' | 'gemini';
+export interface EmbeddingConfig {
+    provider: ProviderName;
+    /** TF-IDF vs semantic weight. 0 = pure semantic, 1 = pure TF-IDF. Default 0.3 */
+    alpha: number;
+    /** API keys for external providers */
+    openaiApiKey?: string;
+    claudeApiKey?: string;
+    geminiApiKey?: string;
+    /** Custom model override per provider */
+    modelOverride?: string;
+}
+/** Read embedding configuration from environment variables. */
+export declare function getEmbeddingConfig(): EmbeddingConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/embeddings/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,uBAAuB;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,IAAI,eAAe,CASpD"}

package/dist/embeddings/types.js

@@ -0,0 +1,12 @@
+/** Read embedding configuration from environment variables. */
+export function getEmbeddingConfig() {
+    return {
+        provider: process.env.KNOWLEDGE_EMBEDDING_PROVIDER || 'local',
+        alpha: parseFloat(process.env.KNOWLEDGE_EMBEDDING_ALPHA || '0.3'),
+        openaiApiKey: process.env.KNOWLEDGE_OPENAI_API_KEY || process.env.OPENAI_API_KEY,
+        claudeApiKey: process.env.KNOWLEDGE_CLAUDE_API_KEY || process.env.ANTHROPIC_API_KEY,
+        geminiApiKey: process.env.KNOWLEDGE_GEMINI_API_KEY || process.env.GEMINI_API_KEY,
+        modelOverride: process.env.KNOWLEDGE_EMBEDDING_MODEL,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/embeddings/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAuCA,+DAA+D;AAC/D,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,QAAQ,EAAG,OAAO,CAAC,GAAG,CAAC,4BAA6C,IAAI,OAAO;QAC/E,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,KAAK,CAAC;QACjE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QAChF,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB;QACnF,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QAChF,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB;KACrD,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,18 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+import { startDashboard } from './dashboard.js';
+async function main() {
+    const port = parseInt(process.env.CORTEX_PORT || '3423', 10);
+    try {
+        await startDashboard(port);
+        process.stderr.write(`Dashboard: http://localhost:${port}\n`);
+    }
+    catch (err) {
+        process.stderr.write(`Warning: Dashboard failed to start: ${err}\n`);
+    }
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IAE7D,IAAI,CAAC;QACH,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,IAAI,IAAI,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,GAAG,IAAI,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/knowledge/distill.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Scrub secrets and system noise from text before it reaches git.
+ */
+export declare function scrubContent(text: string): string;
+/**
+ * Normalize a Claude Code project directory name to a clean, readable
+ * project name suitable for the knowledge base.
+ *
+ * Input examples:
+ *   "C--Users-Mathias--claude-mcp-servers-agent-comm--worktrees-review-security"
+ *   "C--Users-Mathias-odoo19-odoo"
+ *   "C--Users-Mathias--agent-comm-swarm-scale-test-3"
+ *   "C--Users-Mathias--claude"
+ *
+ * Output:
+ *   "agent-comm" (worktree merged with parent)
+ *   "odoo19" (Windows path cleaned)
+ *   "agent-comm" (swarm merged with parent)
+ *   "claude-code-config" (special case for ~/.claude)
+ */
+export declare function normalizeProjectName(raw: string): string;
+export declare function distillSessions(): Promise<{
+    updated: string[];
+    created: string[];
+    skipped: string[];
+}>;
+//# sourceMappingURL=distill.d.ts.map

package/dist/knowledge/distill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distill.d.ts","sourceRoot":"","sources":["../../src/knowledge/distill.ts"],"names":[],"mappings":"AAmGA;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBjD;AA0BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA+CxD;AAwKD,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAC/C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC,CAgGD"}