@vinaes/succ 1.3.19

package/dist/lib/ort-provider.js

@@ -0,0 +1,83 @@
+/**
+ * ONNX Runtime Execution Provider auto-detection.
+ *
+ * Selects the best provider per platform:
+ * - Windows: dml (DirectML, any GPU vendor, bundled)
+ * - macOS arm64: coreml (Apple Silicon, bundled)
+ * - Linux: cuda (requires user-installed CUDA 12)
+ * - All platforms: cpu as fallback (4.6x faster than WASM)
+ *
+ * Note: onnxruntime-node 1.25+ uses short backend names ('cpu', 'dml', 'cuda', 'coreml')
+ * instead of legacy 'CPUExecutionProvider', 'DmlExecutionProvider', etc.
+ */
+export function detectExecutionProvider(platform, options = {}) {
+    const gpuEnabled = options.gpu_enabled !== false;
+    const arch = options.arch || process.arch;
+    // Explicit CPU request or GPU disabled
+    if (!gpuEnabled || options.gpu_device === 'cpu') {
+        return { provider: 'cpu', fallbackChain: ['cpu'] };
+    }
+    // Explicit gpu_device override (cpu already handled above)
+    if (options.gpu_device && options.gpu_device !== 'webgpu') {
+        return resolveExplicitDevice(options.gpu_device, platform);
+    }
+    // Auto-detect by platform
+    switch (platform) {
+        case 'win32':
+            return {
+                provider: 'dml',
+                fallbackChain: ['dml', 'cpu'],
+            };
+        case 'darwin':
+            if (arch === 'arm64') {
+                return {
+                    provider: 'coreml',
+                    fallbackChain: ['coreml', 'cpu'],
+                };
+            }
+            return { provider: 'cpu', fallbackChain: ['cpu'] };
+        case 'linux':
+            return {
+                provider: 'cuda',
+                fallbackChain: ['cuda', 'cpu'],
+            };
+        default:
+            return { provider: 'cpu', fallbackChain: ['cpu'] };
+    }
+}
+function resolveExplicitDevice(device, platform) {
+    switch (device) {
+        case 'directml':
+            if (platform !== 'win32') {
+                return {
+                    provider: 'cpu',
+                    fallbackChain: ['cpu'],
+                    warning: 'DirectML is only available on Windows. Falling back to CPU.',
+                };
+            }
+            return {
+                provider: 'dml',
+                fallbackChain: ['dml', 'cpu'],
+            };
+        case 'cuda':
+            return {
+                provider: 'cuda',
+                fallbackChain: ['cuda', 'cpu'],
+            };
+        case 'coreml':
+            if (platform !== 'darwin') {
+                return {
+                    provider: 'cpu',
+                    fallbackChain: ['cpu'],
+                    warning: 'CoreML is only available on macOS. Falling back to CPU.',
+                };
+            }
+            return {
+                provider: 'coreml',
+                fallbackChain: ['coreml', 'cpu'],
+            };
+        default:
+            return { provider: 'cpu', fallbackChain: ['cpu'] };
+    }
+}
+//# sourceMappingURL=ort-provider.js.map

package/dist/lib/ort-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ort-provider.js","sourceRoot":"","sources":["../../src/lib/ort-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiBH,MAAM,UAAU,uBAAuB,CACrC,QAAgB,EAChB,UAA8B,EAAE;IAEhC,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,KAAK,KAAK,CAAC;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAE1C,uCAAuC;IACvC,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;QAChD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IACrD,CAAC;IAED,2DAA2D;IAC3D,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC1D,OAAO,qBAAqB,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;IAED,0BAA0B;IAC1B,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,OAAO;YACV,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;aAC9B,CAAC;QACJ,KAAK,QAAQ;YACX,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrB,OAAO;oBACL,QAAQ,EAAE,QAAQ;oBAClB,aAAa,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;iBACjC,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,KAAK,OAAO;YACV,OAAO;gBACL,QAAQ,EAAE,MAAM;gBAChB,aAAa,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;aAC/B,CAAC;QACJ;YACE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IACvD,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAc,EAAE,QAAgB;IAC7D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU;YACb,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACzB,OAAO;oBACL,QAAQ,EAAE,KAAK;oBACf,aAAa,EAAE,CAAC,KAAK,CAAC;oBACtB,OAAO,EAAE,6DAA6D;iBACvE,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;aAC9B,CAAC;QACJ,KAAK,MAAM;YACT,OAAO;gBACL,QAAQ,EAAE,MAAM;gBAChB,aAAa,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;aAC/B,CAAC;QACJ,KAAK,QAAQ;YACX,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC1B,OAAO;oBACL,QAAQ,EAAE,KAAK;oBACf,aAAa,EAAE,CAAC,KAAK,CAAC;oBACtB,OAAO,EAAE,yDAAyD;iBACnE,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE,QAAQ;gBAClB,aAAa,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;aACjC,CAAC;QACJ;YACE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IACvD,CAAC;AACH,CAAC"}

package/dist/lib/ort-session.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Native ONNX Runtime session for embedding generation.
+ *
+ * Uses onnxruntime-node directly instead of @huggingface/transformers WASM backend.
+ * Supports DirectML (Windows), CoreML (macOS), CUDA (Linux), CPU (all).
+ *
+ * Tokenization still uses @huggingface/transformers AutoTokenizer.
+ */
+export interface NativeOrtSessionConfig {
+    model: string;
+    providers?: string[];
+    numThreads?: number;
+}
+export declare class NativeOrtSession {
+    private session;
+    private tokenizer;
+    private model;
+    private providers;
+    private numThreads;
+    private activeProvider;
+    constructor(config: NativeOrtSessionConfig);
+    init(): Promise<void>;
+    embed(texts: string[]): Promise<number[][]>;
+    get provider(): string;
+    get isInitialized(): boolean;
+    dispose(): Promise<void>;
+}
+/**
+ * Resolve ONNX model file path from various cache locations.
+ */
+export declare function resolveModelPath(modelName: string): Promise<string>;
+//# sourceMappingURL=ort-session.d.ts.map

package/dist/lib/ort-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ort-session.d.ts","sourceRoot":"","sources":["../../src/lib/ort-session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAiB;gBAE3B,MAAM,EAAE,sBAAsB;IAMpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCrB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAqDjD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,aAAa,IAAI,OAAO,CAE3B;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAO/B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBzE"}

package/dist/lib/ort-session.js

@@ -0,0 +1,227 @@
+/**
+ * Native ONNX Runtime session for embedding generation.
+ *
+ * Uses onnxruntime-node directly instead of @huggingface/transformers WASM backend.
+ * Supports DirectML (Windows), CoreML (macOS), CUDA (Linux), CPU (all).
+ *
+ * Tokenization still uses @huggingface/transformers AutoTokenizer.
+ */
+import * as ort from 'onnxruntime-node';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { createRequire } from 'module';
+import { DependencyError } from './errors.js';
+export class NativeOrtSession {
+    session = null;
+    tokenizer = null;
+    model;
+    providers;
+    numThreads;
+    activeProvider = 'cpu';
+    constructor(config) {
+        this.model = config.model;
+        this.providers = config.providers || ['cpu'];
+        this.numThreads = config.numThreads ?? 1;
+    }
+    async init() {
+        // 1. Load tokenizer via @huggingface/transformers
+        const { AutoTokenizer } = await import('@huggingface/transformers');
+        this.tokenizer = await AutoTokenizer.from_pretrained(this.model);
+        // 2. Resolve ONNX model path
+        const modelPath = await resolveModelPath(this.model);
+        // 3. Create InferenceSession with provider fallback
+        for (const provider of this.providers) {
+            try {
+                this.session = await ort.InferenceSession.create(modelPath, {
+                    executionProviders: [provider],
+                    interOpNumThreads: this.numThreads,
+                    intraOpNumThreads: this.numThreads,
+                });
+                this.activeProvider = provider;
+                return;
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                if (this.providers.indexOf(provider) === this.providers.length - 1) {
+                    // Last provider in chain — throw with details
+                    throw new DependencyError(`Failed to create ORT session. Last provider ${provider}: ${msg}`);
+                }
+                // More providers to try
+            }
+        }
+        throw new DependencyError(`Failed to create ORT session with any provider: ${this.providers.join(', ')}`);
+    }
+    async embed(texts) {
+        if (texts.length === 0)
+            return [];
+        if (!this.session || !this.tokenizer) {
+            throw new DependencyError('Session not initialized. Call init() first.');
+        }
+        // Tokenize
+        const encoded = this.tokenizer(texts, {
+            padding: true,
+            truncation: true,
+            max_length: 128,
+        });
+        const batchSize = encoded.input_ids.dims[0];
+        const seqLen = encoded.input_ids.dims[1];
+        // Convert to ORT int64 tensors
+        const inputIds = toBigInt64Tensor(encoded.input_ids.data, [batchSize, seqLen]);
+        const attentionMask = toBigInt64Tensor(encoded.attention_mask.data, [batchSize, seqLen]);
+        const feeds = {
+            input_ids: inputIds,
+            attention_mask: attentionMask,
+        };
+        // Some models require token_type_ids
+        if (this.session.inputNames.includes('token_type_ids')) {
+            feeds.token_type_ids = new ort.Tensor('int64', new BigInt64Array(batchSize * seqLen), [
+                batchSize,
+                seqLen,
+            ]);
+        }
+        // Run inference
+        const results = await this.session.run(feeds);
+        // Get output — model outputs last_hidden_state or similar
+        const outputKey = 'last_hidden_state' in results ? 'last_hidden_state' : this.session.outputNames[0];
+        const output = results[outputKey];
+        const hiddenDim = output.dims[output.dims.length - 1];
+        const outputData = output.data;
+        // Mean pooling with attention mask + L2 normalization
+        return meanPoolAndNormalize(outputData, encoded.attention_mask.data, batchSize, seqLen, hiddenDim);
+    }
+    get provider() {
+        return this.activeProvider;
+    }
+    get isInitialized() {
+        return this.session !== null && this.tokenizer !== null;
+    }
+    async dispose() {
+        if (this.session) {
+            await this.session.release();
+            this.session = null;
+        }
+        this.tokenizer = null;
+    }
+}
+/**
+ * Resolve ONNX model file path from various cache locations.
+ */
+export async function resolveModelPath(modelName) {
+    // 1. Check transformers.js cache (node_modules/@huggingface/transformers/.cache/)
+    const tfCachePath = findTransformersJsCache(modelName);
+    if (tfCachePath)
+        return tfCachePath;
+    // 2. Check HuggingFace Hub standard cache
+    const hfCachePath = findHfHubCache(modelName);
+    if (hfCachePath)
+        return hfCachePath;
+    // 3. Not cached — trigger download via AutoTokenizer (downloads full repo including onnx/)
+    const { AutoTokenizer } = await import('@huggingface/transformers');
+    await AutoTokenizer.from_pretrained(modelName);
+    // Retry after download
+    const retryPath = findTransformersJsCache(modelName) || findHfHubCache(modelName);
+    if (retryPath)
+        return retryPath;
+    throw new DependencyError(`ONNX model file not found for '${modelName}'. ` +
+        `Ensure the model has ONNX exports (e.g., Xenova/ models on HuggingFace).`);
+}
+function findTransformersJsCache(modelName) {
+    // transformers.js v3 stores models at:
+    // node_modules/@huggingface/transformers/.cache/{modelName}/onnx/model.onnx
+    try {
+        const require = createRequire(import.meta.url);
+        const resolvedEntry = require.resolve('@huggingface/transformers');
+        // resolve points to dist/transformers.node.cjs — go up to package root
+        const transformersRoot = path.dirname(path.dirname(resolvedEntry));
+        const candidates = [
+            path.join(transformersRoot, '.cache', modelName, 'onnx', 'model.onnx'),
+            path.join(transformersRoot, '.cache', modelName, 'onnx', 'model_quantized.onnx'),
+        ];
+        for (const candidate of candidates) {
+            if (fs.existsSync(candidate))
+                return candidate;
+        }
+    }
+    catch {
+        // @huggingface/transformers not installed or path resolution failed
+    }
+    return null;
+}
+function findHfHubCache(modelName) {
+    const hfCacheDir = getHfCacheDir();
+    const safeModelName = modelName.replace(/\//g, '--');
+    const modelDir = path.join(hfCacheDir, `models--${safeModelName}`);
+    const refsMain = path.join(modelDir, 'refs', 'main');
+    if (!fs.existsSync(refsMain))
+        return null;
+    try {
+        const hash = fs.readFileSync(refsMain, 'utf-8').trim();
+        const snapshotDir = path.join(modelDir, 'snapshots', hash);
+        const candidates = [
+            path.join(snapshotDir, 'onnx', 'model.onnx'),
+            path.join(snapshotDir, 'onnx', 'model_quantized.onnx'),
+        ];
+        for (const candidate of candidates) {
+            if (fs.existsSync(candidate))
+                return candidate;
+        }
+    }
+    catch {
+        // Corrupted cache
+    }
+    return null;
+}
+function getHfCacheDir() {
+    if (process.env.HF_HOME)
+        return path.join(process.env.HF_HOME, 'hub');
+    if (process.env.HUGGINGFACE_HUB_CACHE)
+        return process.env.HUGGINGFACE_HUB_CACHE;
+    if (process.env.XDG_CACHE_HOME)
+        return path.join(process.env.XDG_CACHE_HOME, 'huggingface', 'hub');
+    return path.join(os.homedir(), '.cache', 'huggingface', 'hub');
+}
+function toBigInt64Tensor(data, dims) {
+    const arr = new BigInt64Array(data.length);
+    for (let i = 0; i < data.length; i++) {
+        arr[i] = BigInt(data[i]);
+    }
+    return new ort.Tensor('int64', arr, dims);
+}
+function meanPoolAndNormalize(hiddenStates, attentionMask, batchSize, seqLen, hiddenDim) {
+    const embeddings = [];
+    for (let b = 0; b < batchSize; b++) {
+        const embedding = new Float64Array(hiddenDim);
+        let maskSum = 0;
+        for (let s = 0; s < seqLen; s++) {
+            const mask = Number(attentionMask[b * seqLen + s]);
+            if (mask === 0)
+                continue;
+            maskSum += mask;
+            const offset = (b * seqLen + s) * hiddenDim;
+            for (let d = 0; d < hiddenDim; d++) {
+                embedding[d] += hiddenStates[offset + d] * mask;
+            }
+        }
+        // Mean
+        if (maskSum > 0) {
+            for (let d = 0; d < hiddenDim; d++) {
+                embedding[d] /= maskSum;
+            }
+        }
+        // L2 normalize
+        let norm = 0;
+        for (let d = 0; d < hiddenDim; d++) {
+            norm += embedding[d] * embedding[d];
+        }
+        norm = Math.sqrt(norm);
+        if (norm > 0) {
+            for (let d = 0; d < hiddenDim; d++) {
+                embedding[d] /= norm;
+            }
+        }
+        embeddings.push(Array.from(embedding));
+    }
+    return embeddings;
+}
+//# sourceMappingURL=ort-session.js.map

package/dist/lib/ort-session.js.map

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

package/dist/lib/patterns.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Common file patterns for code and documentation indexing.
+ *
+ * Based on:
+ * - GitHub Linguist (https://github.com/github-linguist/linguist)
+ * - GitHub gitignore templates (https://github.com/github/gitignore)
+ */
+/**
+ * Code file extensions to index/watch.
+ * Covers most common programming languages used in production.
+ */
+export declare const CODE_EXTENSIONS: Set<string>;
+/**
+ * Documentation file extensions to index/watch.
+ */
+export declare const DOC_EXTENSIONS: Set<string>;
+/**
+ * Default glob patterns for code files.
+ */
+export declare const DEFAULT_CODE_PATTERNS: string[];
+/**
+ * Directories to ignore (for fast path checking).
+ */
+export declare const IGNORE_DIRS: Set<string>;
+/**
+ * Default glob ignore patterns.
+ */
+export declare const DEFAULT_IGNORE_PATTERNS: string[];
+/**
+ * Specific paths to ignore within .succ directory.
+ * These are checked separately to allow .succ/brain/** files.
+ */
+export declare const IGNORE_SUCC_PATHS: Set<string>;
+/**
+ * Get file type based on extension.
+ */
+export declare function getFileType(filePath: string): 'code' | 'doc' | null;
+/**
+ * Check if a path should be ignored based on directory components.
+ * Fast path check without glob matching.
+ */
+export declare function shouldIgnorePath(relativePath: string, sep?: string): boolean;
+//# sourceMappingURL=patterns.d.ts.map

package/dist/lib/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../src/lib/patterns.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,aA8E1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,aASzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB,UAkFjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,aA0DtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB,UA8HnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,aAO5B,CAAC;AAEH;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,CAKnE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,GAAE,MAAY,GAAG,OAAO,CAsCjF"}