purecontext-mcp 1.0.1

package/dist/index.js.map

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

package/dist/semantic/embedding-provider.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Embedding provider abstraction for Phase 11 semantic search.
+ *
+ * Supported providers:
+ *   'anthropic' — Anthropic embedding endpoint (uses ai.apiKey / ANTHROPIC_API_KEY)
+ *   'openai'    — OpenAI text-embedding-3-small (uses ai.openaiApiKey / OPENAI_API_KEY)
+ *   'local'     — Ollama or any local /api/embed endpoint (no API key)
+ *
+ * All providers return Float32Array for memory efficiency.
+ * Batch embedding reduces API round trips.
+ */
+import type { PureContextConfig } from '../config/config-schema.js';
+export interface EmbeddingProvider {
+    name: string;
+    /** Vector dimensionality produced by this provider. */
+    dimension: number;
+    /** Approximate max input tokens per text (used for truncation). */
+    maxTokens: number;
+    /** Embed a batch of texts. Returns one Float32Array per input text, in order. */
+    embed(texts: string[]): Promise<Float32Array[]>;
+}
+/**
+ * Minimal injectable HTTP POST function for testability.
+ * Accepts a URL, JSON body, and headers; resolves with the parsed JSON response.
+ */
+export type EmbedFetchFn = (url: string, body: Record<string, unknown>, headers: Record<string, string>) => Promise<unknown>;
+export declare class AnthropicEmbedding implements EmbeddingProvider {
+    readonly name = "anthropic";
+    readonly dimension = 1024;
+    readonly maxTokens = 4096;
+    private static readonly BATCH_SIZE;
+    private static readonly ENDPOINT;
+    private readonly apiKey;
+    private readonly fetch;
+    constructor(apiKey: string, fetch?: EmbedFetchFn);
+    embed(texts: string[]): Promise<Float32Array[]>;
+}
+export declare class OpenAIEmbedding implements EmbeddingProvider {
+    readonly name = "openai";
+    readonly dimension = 1536;
+    readonly maxTokens = 8191;
+    private static readonly BATCH_SIZE;
+    private static readonly MODEL;
+    private static readonly ENDPOINT;
+    private readonly apiKey;
+    private readonly fetch;
+    constructor(apiKey: string, fetch?: EmbedFetchFn);
+    embed(texts: string[]): Promise<Float32Array[]>;
+}
+export declare class LocalEmbedding implements EmbeddingProvider {
+    readonly name = "local";
+    readonly maxTokens = 512;
+    dimension: number;
+    private readonly endpoint;
+    private readonly fetch;
+    constructor(endpoint: string, dimension?: number, fetch?: EmbedFetchFn);
+    embed(texts: string[]): Promise<Float32Array[]>;
+}
+/**
+ * Create an EmbeddingProvider from the current config.
+ * Throws `PureContextError` if `semantic.provider` is 'none' or required config is missing.
+ *
+ * Pass `fetch` to inject a custom HTTP function (useful in tests).
+ */
+export declare function createEmbeddingProvider(config: PureContextConfig, fetch?: EmbedFetchFn): EmbeddingProvider;
+//# sourceMappingURL=embedding-provider.d.ts.map

package/dist/semantic/embedding-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-provider.d.ts","sourceRoot":"","sources":["../../src/semantic/embedding-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAMpE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACjD;AAID;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC5B,OAAO,CAAC,OAAO,CAAC,CAAC;AAsEtB,qBAAa,kBAAmB,YAAW,iBAAiB;IAC1D,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,SAAS,QAAQ;IAC1B,QAAQ,CAAC,SAAS,QAAQ;IAE1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAO;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA6C;IAE7E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,YAAgC;IAK7D,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAmBtD;AAQD,qBAAa,eAAgB,YAAW,iBAAiB;IACvD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,SAAS,QAAQ;IAC1B,QAAQ,CAAC,SAAS,QAAQ;IAE1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAQ;IAC1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAA4B;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IAE1E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,YAAgC;IAK7D,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAiBtD;AAQD,qBAAa,cAAe,YAAW,iBAAiB;IACtD,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,SAAS,OAAO;IACzB,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAGnC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAY,EACvB,KAAK,GAAE,YAAgC;IAOnC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAStD;AAID;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,EACzB,KAAK,CAAC,EAAE,YAAY,GACnB,iBAAiB,CAyCnB"}

package/dist/semantic/embedding-provider.js

@@ -0,0 +1,176 @@
+/**
+ * Embedding provider abstraction for Phase 11 semantic search.
+ *
+ * Supported providers:
+ *   'anthropic' — Anthropic embedding endpoint (uses ai.apiKey / ANTHROPIC_API_KEY)
+ *   'openai'    — OpenAI text-embedding-3-small (uses ai.openaiApiKey / OPENAI_API_KEY)
+ *   'local'     — Ollama or any local /api/embed endpoint (no API key)
+ *
+ * All providers return Float32Array for memory efficiency.
+ * Batch embedding reduces API round trips.
+ */
+import { request as httpsRequest } from 'https';
+import { request as httpRequest } from 'http';
+import { PureContextError } from '../core/errors.js';
+import { logger } from '../core/logger.js';
+function defaultEmbedFetch(url, body, headers) {
+    return new Promise((resolve, reject) => {
+        const bodyStr = JSON.stringify(body);
+        let parsedUrl;
+        try {
+            parsedUrl = new URL(url);
+        }
+        catch (err) {
+            reject(new PureContextError(`Invalid embedding endpoint URL: ${url}`, err));
+            return;
+        }
+        const isHttps = parsedUrl.protocol === 'https:';
+        const reqFn = isHttps ? httpsRequest : httpRequest;
+        const port = parsedUrl.port
+            ? Number(parsedUrl.port)
+            : isHttps ? 443 : 80;
+        const req = reqFn({
+            hostname: parsedUrl.hostname,
+            port,
+            path: parsedUrl.pathname + parsedUrl.search,
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(bodyStr),
+                ...headers,
+            },
+        }, (res) => {
+            const chunks = [];
+            res.on('data', (chunk) => chunks.push(chunk));
+            res.on('end', () => {
+                const text = Buffer.concat(chunks).toString('utf8');
+                let parsed;
+                try {
+                    parsed = JSON.parse(text);
+                }
+                catch {
+                    reject(new PureContextError(`Embedding API returned non-JSON response: ${text.slice(0, 200)}`));
+                    return;
+                }
+                if (res.statusCode !== undefined && res.statusCode >= 400) {
+                    reject(new PureContextError(`Embedding API HTTP ${res.statusCode}: ${text.slice(0, 400)}`));
+                    return;
+                }
+                resolve(parsed);
+            });
+        });
+        req.on('error', (err) => reject(new PureContextError('Embedding API network error', err)));
+        req.write(bodyStr);
+        req.end();
+    });
+}
+export class AnthropicEmbedding {
+    name = 'anthropic';
+    dimension = 1024;
+    maxTokens = 4096;
+    static BATCH_SIZE = 100;
+    static ENDPOINT = 'https://api.anthropic.com/v1/embeddings';
+    apiKey;
+    fetch;
+    constructor(apiKey, fetch = defaultEmbedFetch) {
+        this.apiKey = apiKey;
+        this.fetch = fetch;
+    }
+    async embed(texts) {
+        const results = [];
+        for (let i = 0; i < texts.length; i += AnthropicEmbedding.BATCH_SIZE) {
+            const batch = texts.slice(i, i + AnthropicEmbedding.BATCH_SIZE);
+            logger.debug('AnthropicEmbedding: embedding batch', { offset: i, size: batch.length });
+            const data = (await this.fetch(AnthropicEmbedding.ENDPOINT, { inputs: batch, input_type: 'document' }, {
+                'x-api-key': this.apiKey,
+                'anthropic-version': '2023-06-01',
+            }));
+            for (const item of data.embeddings) {
+                results.push(new Float32Array(item.embedding));
+            }
+        }
+        return results;
+    }
+}
+export class OpenAIEmbedding {
+    name = 'openai';
+    dimension = 1536;
+    maxTokens = 8191;
+    static BATCH_SIZE = 2048;
+    static MODEL = 'text-embedding-3-small';
+    static ENDPOINT = 'https://api.openai.com/v1/embeddings';
+    apiKey;
+    fetch;
+    constructor(apiKey, fetch = defaultEmbedFetch) {
+        this.apiKey = apiKey;
+        this.fetch = fetch;
+    }
+    async embed(texts) {
+        const results = new Array(texts.length);
+        for (let i = 0; i < texts.length; i += OpenAIEmbedding.BATCH_SIZE) {
+            const batch = texts.slice(i, i + OpenAIEmbedding.BATCH_SIZE);
+            logger.debug('OpenAIEmbedding: embedding batch', { offset: i, size: batch.length });
+            const data = (await this.fetch(OpenAIEmbedding.ENDPOINT, { model: OpenAIEmbedding.MODEL, input: batch }, { Authorization: `Bearer ${this.apiKey}` }));
+            // OpenAI returns results with an index field — respect it for correct ordering
+            for (const item of data.data) {
+                results[i + item.index] = new Float32Array(item.embedding);
+            }
+        }
+        return results;
+    }
+}
+export class LocalEmbedding {
+    name = 'local';
+    maxTokens = 512;
+    dimension;
+    endpoint;
+    fetch;
+    constructor(endpoint, dimension = 384, fetch = defaultEmbedFetch) {
+        this.endpoint = endpoint.replace(/\/$/, '');
+        this.dimension = dimension;
+        this.fetch = fetch;
+    }
+    async embed(texts) {
+        logger.debug('LocalEmbedding: embedding batch', { size: texts.length, endpoint: this.endpoint });
+        const data = (await this.fetch(`${this.endpoint}/api/embed`, { model: 'nomic-embed-text', input: texts }, {}));
+        return data.embeddings.map((e) => new Float32Array(e));
+    }
+}
+// ─── Factory ──────────────────────────────────────────────────────────────────
+/**
+ * Create an EmbeddingProvider from the current config.
+ * Throws `PureContextError` if `semantic.provider` is 'none' or required config is missing.
+ *
+ * Pass `fetch` to inject a custom HTTP function (useful in tests).
+ */
+export function createEmbeddingProvider(config, fetch) {
+    const { provider } = config.semantic;
+    if (provider === 'none') {
+        throw new PureContextError("No embedding provider configured. Set semantic.provider to 'anthropic', 'openai', or 'local' in config.json.");
+    }
+    if (provider === 'anthropic') {
+        const apiKey = config.ai.apiKey || process.env['ANTHROPIC_API_KEY'] || '';
+        if (!apiKey) {
+            throw new PureContextError('Anthropic embedding provider requires an API key. ' +
+                'Set ai.apiKey in config.json or the ANTHROPIC_API_KEY environment variable.');
+        }
+        return new AnthropicEmbedding(apiKey, fetch);
+    }
+    if (provider === 'openai') {
+        const apiKey = config.ai.openaiApiKey || process.env['OPENAI_API_KEY'] || '';
+        if (!apiKey) {
+            throw new PureContextError('OpenAI embedding provider requires an API key. ' +
+                'Set ai.openaiApiKey in config.json or the OPENAI_API_KEY environment variable.');
+        }
+        return new OpenAIEmbedding(apiKey, fetch);
+    }
+    // local
+    const endpoint = config.semantic.localEmbeddingEndpoint;
+    if (!endpoint) {
+        throw new PureContextError('Local embedding provider requires an endpoint URL. ' +
+            'Set semantic.localEmbeddingEndpoint in config.json.');
+    }
+    const dimension = config.semantic.dimension ?? 384;
+    return new LocalEmbedding(endpoint, dimension, fetch);
+}
+//# sourceMappingURL=embedding-provider.js.map

package/dist/semantic/embedding-provider.js.map

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

package/dist/semantic/hnsw-index.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Pure TypeScript HNSW (Hierarchical Navigable Small World) index.
+ *
+ * Implements approximate nearest-neighbor search with O(log n) average-case
+ * complexity via a layered proximity graph.
+ *
+ * Reference: Malkov & Yashunin, 2018
+ * "Efficient and robust approximate nearest neighbor search using
+ *  Hierarchical Navigable Small World graphs"
+ *
+ * Design notes:
+ * - No native addon or WASM dependency — works everywhere Node.js runs.
+ * - Cosine distance metric (L2-normalized input vectors recommended).
+ * - String IDs mapped to integer labels internally for graph adjacency lists.
+ * - Serializes to JSON for persistence (readable, portable).
+ */
+export interface SearchResult {
+    id: string;
+    distance: number;
+}
+/**
+ * HNSW approximate nearest-neighbor index.
+ *
+ * Usage:
+ * ```typescript
+ * const index = new HNSWIndex(1024, 100_000);
+ * index.add(['id1', 'id2'], [vec1, vec2]);
+ * const results = index.search(queryVec, 10);
+ * index.save('/path/to/hnsw.idx');
+ * ```
+ */
+export declare class HNSWIndex {
+    private readonly dimension;
+    private readonly _maxElements;
+    private readonly M;
+    /** Max connections at layer 0: 2×M per the paper. */
+    private readonly Mmax0;
+    private readonly efConstruction;
+    private efSearch;
+    private nodes;
+    private readonly idToLabel;
+    private readonly deletedLabels;
+    private entryPoint;
+    private maxLayer;
+    /** Reciprocal of ln(M) — used for random level generation. */
+    private readonly mL;
+    constructor(dimension: number, _maxElements: number, M?: number, efConstruction?: number, efSearch?: number);
+    /**
+     * Cosine distance = 1 - cosine_similarity.
+     * For L2-normalized vectors, this equals the inner product distance.
+     * Range: [0, 2]. Identical vectors → 0. Opposite vectors → 2.
+     */
+    private dist;
+    /** Geometric distribution — same formula as the original HNSW paper. */
+    private randomLevel;
+    /**
+     * Search layer `level` starting from `entryLabel`.
+     * Returns up to `ef` nearest labels, sorted nearest-first.
+     */
+    private searchLayer;
+    /**
+     * Select M neighbors from sorted candidates (nearest-first).
+     * Simple heuristic: take the M closest.
+     */
+    private selectNeighbors;
+    private insertOne;
+    /**
+     * Insert vectors into the index.
+     * `ids` and `vectors` must be the same length.
+     */
+    add(ids: string[], vectors: Float32Array[]): void;
+    /**
+     * Search for the `k` nearest neighbors of `query`.
+     * Returns results sorted by ascending distance (nearest first).
+     * Deleted vectors are excluded from results.
+     */
+    search(query: Float32Array, k: number): SearchResult[];
+    /**
+     * Mark vectors as deleted. Deleted vectors are excluded from search results.
+     * Actual storage is reclaimed on `rebuild()`.
+     */
+    remove(ids: string[]): void;
+    /** Number of live (non-deleted) vectors in the index. */
+    size(): number;
+    /**
+     * Persist the index to disk as JSON.
+     * Path: typically `~/.purecontext/indexes/{repoId}/hnsw.idx`
+     */
+    save(path: string): void;
+    /**
+     * Load a previously saved index from disk.
+     * Replaces all current state.
+     */
+    load(path: string): void;
+}
+//# sourceMappingURL=hnsw-index.d.ts.map

package/dist/semantic/hnsw-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hnsw-index.d.ts","sourceRoot":"","sources":["../../src/semantic/hnsw-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAqGD;;;;;;;;;;GAUG;AACH,qBAAa,SAAS;IAiBlB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAjB/B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAS;IAC3B,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,QAAQ,CAAM;IAEtB,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;gBAGT,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACrC,CAAC,SAAK,EACN,cAAc,SAAM,EACpB,QAAQ,SAAM;IAWhB;;;;OAIG;IACH,OAAO,CAAC,IAAI;IAcZ,wEAAwE;IACxE,OAAO,CAAC,WAAW;IAMnB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAiDnB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,SAAS;IAkEjB;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI;IAUjD;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAyBtD;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI;IAU3B,yDAAyD;IACzD,IAAI,IAAI,MAAM;IAId;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAsBxB;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CA+BzB"}