@ekkos/cli 1.3.1 → 1.3.5

package/dist/index.js

@@ -42,19 +42,20 @@ const init_1 = require("./commands/init");
 const test_1 = require("./commands/test");
 const status_1 = require("./commands/status");
 const run_1 = require("./commands/run");
+const gemini_1 = require("./commands/gemini");
 const test_claude_1 = require("./commands/test-claude");
 const doctor_1 = require("./commands/doctor");
 const stream_1 = require("./commands/stream");
+const claw_1 = require("./commands/claw");
 // DEPRECATED: Hooks removed in hookless architecture migration
 // hooksInstall, hooksVerify, hooksStatus no longer called — `hooks` command prints a deprecation notice.
-const setup_remote_1 = require("./commands/setup-remote");
-const agent_1 = require("./commands/agent");
 const state_1 = require("./utils/state");
 const index_1 = require("./commands/usage/index");
 const dashboard_1 = require("./commands/dashboard");
 const swarm_1 = require("./commands/swarm");
 const swarm_dashboard_1 = require("./commands/swarm-dashboard");
 const swarm_setup_1 = require("./commands/swarm-setup");
+const scan_1 = require("./commands/scan");
 const chalk_1 = __importDefault(require("chalk"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
@@ -76,10 +77,13 @@ commander_1.program
     chalk_1.default.cyan.bold('Examples:'),
     `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos')}                              ${chalk_1.default.gray('Start Claude Code with ekkOS memory (default: run)')}`,
     `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos init')}                         ${chalk_1.default.gray('First-time setup — authenticate + configure your IDE')}`,
+    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos scan')}                         ${chalk_1.default.gray('Scan repo structure and seed system registry')}`,
+    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos scan --compile')}               ${chalk_1.default.gray('Scan, seed, and trigger compile pass')}`,
     `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos run --dashboard')}              ${chalk_1.default.gray('Launch with live usage dashboard (tmux split)')}`,
     `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos run -b')}                       ${chalk_1.default.gray('Launch with bypass permissions mode')}`,
     `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos doctor --fix')}                 ${chalk_1.default.gray('Check and auto-fix system prerequisites')}`,
     `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos usage daily')}                  ${chalk_1.default.gray("View today's token usage and costs")}`,
+    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos gemini')}                       ${chalk_1.default.gray('Launch Gemini CLI with ekkOS memory proxy')}`,
     `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos swarm launch -t "build X"')}    ${chalk_1.default.gray('Launch parallel workers on a task')}`,
     '',
     chalk_1.default.gray('  Run ') + chalk_1.default.white('ekkos <command> --help') + chalk_1.default.gray(' for detailed options on any command.'),
@@ -149,6 +153,7 @@ commander_1.program
                 icon: '▸',
                 commands: [
                     { name: 'init', desc: 'Authenticate and configure your IDE (Claude, Cursor, Windsurf)' },
+                    { name: 'scan', desc: 'Scan repo structure and seed ekkOS system registry' },
                     { name: 'status', desc: 'Show memory status and installation info' },
                     { name: 'test', desc: 'Test connection to ekkOS memory API' },
                     { name: 'doctor', desc: 'Check system prerequisites (Node, PTY, Claude, MCP)' },
@@ -158,9 +163,10 @@ commander_1.program
                 title: 'Running',
                 icon: '▸',
                 commands: [
-                    { name: 'run', desc: 'Launch Claude Code with ekkOS memory + auto-continue', note: 'default' },
-                    { name: 'test-claude', desc: 'Launch Claude with proxy only (no ccDNA/PTY) for debugging' },
+                    { name: 'run', desc: 'Launch Claude Code with ekkOS memory', note: 'default' },
+                    { name: 'test-claude', desc: 'Launch Claude with proxy only (no PTY) for debugging' },
                     { name: 'sessions', desc: 'List active Claude Code sessions' },
+                    { name: 'claw', desc: 'OpenClaw integration status and upgrade controls' },
                 ],
             },
             {
@@ -173,14 +179,6 @@ commander_1.program
                     { name: 'hooks', desc: '[DEPRECATED] Hooks no longer needed — use `ekkos run`' },
                 ],
             },
-            {
-                title: 'Remote Terminal',
-                icon: '▸',
-                commands: [
-                    { name: 'setup-remote', desc: 'Set up remote access (run Claude on your PC from anywhere)' },
-                    { name: 'agent', desc: 'Manage the remote terminal agent (start, stop, status, logs)' },
-                ],
-            },
             {
                 title: 'Swarm (Multi-Agent)',
                 icon: '▸',
@@ -224,30 +222,86 @@ commander_1.program
     .option('-i, --ide <ide>', 'IDE to setup (claude, cursor, windsurf, all)')
     .option('-k, --key <key>', 'Use API key instead of device auth')
     .option('-f, --force', 'Force re-authentication and overwrite existing config')
+    .option('-q, --quick', 'Quick setup: auto-detect IDE, use defaults, only prompt for API key if missing')
     .option('--skip-hooks', '[DEPRECATED] Hooks are no longer deployed; this flag is a no-op')
     .option('--skip-skills', 'Skip skills deployment')
     .action(init_1.init);
+// Scan command — discover repo systems and seed registry
+commander_1.program
+    .command('scan')
+    .description('Scan repo structure, discover systems, and seed ekkOS registry')
+    .option('-c, --compile', 'Trigger a compile pass after seeding')
+    .option('-n, --dry-run', 'Show discovered systems without seeding')
+    .option('-p, --path <path>', 'Path to scan (default: current directory)')
+    .action((options) => {
+    (0, scan_1.scan)({
+        compile: options.compile,
+        dryRun: options.dryRun,
+        path: options.path,
+    });
+});
 // Status command
 commander_1.program
     .command('status')
-    .description('Show your ekkOS memory status and installation info')
-    .action(status_1.status);
+    .description('Show live session metrics and memory status')
+    .option('-w, --watch', 'Watch mode — refresh session panel every 2s')
+    .option('--json', 'Output raw metrics JSON (no memory API call)')
+    .action((options) => {
+    (0, status_1.status)({ watch: options.watch, json: options.json });
+});
+// OpenClaw integration commands
+const clawCmd = commander_1.program
+    .command('claw')
+    .description('Manage OpenClaw + ekkOS integration');
+clawCmd
+    .command('status')
+    .description('Show OpenClaw runtime + ekkOS proxy integration status')
+    .option('-j, --json', 'Output machine-readable JSON')
+    .option('--proxy-url <url>', 'Expected ekkOS proxy URL (default: https://proxy.ekkos.dev)')
+    .option('--model <model>', 'Expected primary OpenClaw model (default: ekkos-proxy/claude-sonnet-4-6)')
+    .option('--workspace <path>', 'Expected OpenClaw workspace path')
+    .action((options) => {
+    (0, claw_1.clawStatus)({
+        json: options.json,
+        proxyUrl: options.proxyUrl,
+        model: options.model,
+        workspace: options.workspace,
+    });
+});
+clawCmd
+    .command('upgrade')
+    .description('Apply foundation config upgrades for OpenClaw -> ekkOS proxy routing')
+    .option('--apply', 'Write changes to ~/.openclaw/openclaw.json (otherwise dry run)')
+    .option('--force', 'Reserved for future migration modes')
+    .option('-j, --json', 'Output machine-readable JSON')
+    .option('--proxy-url <url>', 'Target ekkOS proxy URL')
+    .option('--model <model>', 'Target primary OpenClaw model')
+    .option('--workspace <path>', 'Expected OpenClaw workspace path for status verification')
+    .action((options) => {
+    (0, claw_1.clawUpgrade)({
+        apply: options.apply,
+        force: options.force,
+        json: options.json,
+        proxyUrl: options.proxyUrl,
+        model: options.model,
+        workspace: options.workspace,
+    });
+});
 // Test command
 commander_1.program
     .command('test')
     .description('Test connection to ekkOS memory')
     .action(test_1.test);
-// Run command - launches Claude with auto-continue wrapper
+// Run command - launches Claude Code with ekkOS proxy
 commander_1.program
     .command('run')
-    .description('Launch Claude Code with auto-continue (auto /clear + /continue when context is high)')
+    .description('Launch Claude Code with ekkOS memory proxy (IPC compression + pattern injection)')
     .option('-s, --session <name>', 'Session name to restore on clear')
     .option('-b, --bypass', 'Enable bypass permissions mode (dangerously skip all permission checks)')
     .option('-v, --verbose', 'Show debug output')
     .option('-d, --doctor', 'Run diagnostics before starting')
     .option('-r, --research', 'Auto-run research agent on startup (scans arXiv for new AI papers)')
     .option('--skip-inject', 'Monitor-only mode (detect context wall but print instructions instead of auto-inject)')
-    .option('--skip-dna', 'Skip ccDNA injection (bypass Claude Code patching)')
     .option('--skip-proxy', 'Skip API proxy (use direct Anthropic API, disables seamless context eviction)')
     .option('--dashboard', 'Launch with live usage dashboard in an isolated 60/40 tmux split (requires tmux)')
     .option('--add-dir <dirs...>', 'Additional directories Claude Code can access (outside working directory)')
@@ -259,16 +313,29 @@ commander_1.program
         doctor: options.doctor,
         noInject: options.skipInject,
         research: options.research,
-        noDna: options.skipDna,
         noProxy: options.skipProxy,
         dashboard: options.dashboard,
         addDirs: options.addDir,
     });
 });
+// Gemini CLI — launch Gemini with ekkOS proxy
+commander_1.program
+    .command('gemini')
+    .description('Launch Gemini CLI with ekkOS memory proxy (IPC compression + pattern injection)')
+    .option('-s, --session <name>', 'Session name')
+    .option('-v, --verbose', 'Show debug output')
+    .option('--skip-proxy', 'Skip API proxy (use direct Gemini API)')
+    .action((options) => {
+    (0, gemini_1.gemini)({
+        session: options.session,
+        verbose: options.verbose,
+        noProxy: options.skipProxy,
+    });
+});
 // Test Claude — bare proxy test (no CLI wrapper)
 commander_1.program
     .command('test-claude')
-    .description('Launch Claude Code with proxy only (no ccDNA, no PTY, no injections) for debugging')
+    .description('Launch Claude Code with proxy only (no PTY, no injections) for debugging')
     .option('--no-proxy', 'Skip proxy too (completely vanilla Claude)')
     .option('--no-hooks', 'Temporarily disable all hooks during test')
     .option('-v, --verbose', 'Show debug output')
@@ -381,83 +448,6 @@ commander_1.program
         key: options.key
     });
 });
-// ============================================================================
-// REMOTE TERMINAL COMMANDS
-// ============================================================================
-// Setup remote - one-command setup for remote terminal access
-commander_1.program
-    .command('setup-remote')
-    .description('Set up remote terminal access (run Claude on your PC from anywhere)')
-    .option('-f, --force', 'Force re-pairing even if already paired')
-    .option('--skip-service', 'Skip installing background service')
-    .option('-v, --verbose', 'Show detailed output')
-    .action((options) => {
-    (0, setup_remote_1.setupRemote)({
-        force: options.force,
-        skipService: options.skipService,
-        verbose: options.verbose,
-    });
-});
-// Agent command - manage the background agent
-const agentCmd = commander_1.program
-    .command('agent')
-    .description('Manage the remote terminal agent');
-agentCmd
-    .command('daemon')
-    .description('Run the agent daemon (used by system service)')
-    .option('-v, --verbose', 'Show verbose output')
-    .action((options) => {
-    (0, agent_1.agentDaemon)({ verbose: options.verbose });
-});
-agentCmd
-    .command('start')
-    .description('Start the agent service')
-    .option('-v, --verbose', 'Show verbose output')
-    .action((options) => {
-    (0, agent_1.agentStart)({ verbose: options.verbose });
-});
-agentCmd
-    .command('stop')
-    .description('Stop the agent service')
-    .option('-v, --verbose', 'Show verbose output')
-    .action((options) => {
-    (0, agent_1.agentStop)({ verbose: options.verbose });
-});
-agentCmd
-    .command('restart')
-    .description('Restart the agent service')
-    .option('-v, --verbose', 'Show verbose output')
-    .action((options) => {
-    (0, agent_1.agentRestart)({ verbose: options.verbose });
-});
-agentCmd
-    .command('status')
-    .description('Check agent status and connection')
-    .option('-v, --verbose', 'Show verbose output')
-    .action((options) => {
-    (0, agent_1.agentStatus)({ verbose: options.verbose });
-});
-agentCmd
-    .command('uninstall')
-    .description('Remove the agent service and unpair device')
-    .option('-v, --verbose', 'Show verbose output')
-    .action((options) => {
-    (0, agent_1.agentUninstall)({ verbose: options.verbose });
-});
-agentCmd
-    .command('logs')
-    .description('Show agent logs')
-    .option('-f, --follow', 'Follow log output (like tail -f)')
-    .action((options) => {
-    (0, agent_1.agentLogs)({ follow: options.follow });
-});
-agentCmd
-    .command('health')
-    .description('Check agent daemon health and diagnose connection issues')
-    .option('-j, --json', 'Output machine-readable JSON')
-    .action((options) => {
-    (0, agent_1.agentHealth)({ json: options.json });
-});
 // Swarm command - manage Q-learning routing
 const swarmCmd = commander_1.program
     .command('swarm')

package/dist/lib/usage-parser.d.ts

@@ -13,7 +13,7 @@ interface SessionNameResolution {
     encodedProjectPath: string;
     startedAt?: string;
 }
-/** Detect ekkOS 3-word session names like "lit-lex-zip" */
+/** Detect ekkOS 3-word session names like "lit-lex-zip" or "ink-net-wag-235" */
 export declare function isEkkosSessionName(name: string): boolean;
 /** Resolve an ekkOS session name to a JSONL UUID */
 export declare function resolveSessionName(name: string): SessionNameResolution | null;

package/dist/lib/usage-parser.js

@@ -50,11 +50,12 @@ const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 // ── Anthropic model pricing per 1M tokens ──────────────────────────────────
 const MODEL_PRICING = {
-    'claude-opus-4-6': { input: 15, output: 75, cacheWrite: 18.75, cacheRead: 1.50 },
-    'claude-opus-4-5-20250620': { input: 15, output: 75, cacheWrite: 18.75, cacheRead: 1.50 },
+    'claude-opus-4-6': { input: 5, output: 25, cacheWrite: 6.25, cacheRead: 0.50 },
+    'claude-opus-4-5-20250620': { input: 5, output: 25, cacheWrite: 6.25, cacheRead: 0.50 },
+    'claude-sonnet-4-6': { input: 3, output: 15, cacheWrite: 3.75, cacheRead: 0.30 },
     'claude-sonnet-4-5-20250929': { input: 3, output: 15, cacheWrite: 3.75, cacheRead: 0.30 },
     'claude-sonnet-4-5-20250514': { input: 3, output: 15, cacheWrite: 3.75, cacheRead: 0.30 },
-    'claude-haiku-4-5-20251001': { input: 0.80, output: 4, cacheWrite: 1.00, cacheRead: 0.08 },
+    'claude-haiku-4-5-20251001': { input: 1, output: 5, cacheWrite: 1.25, cacheRead: 0.10 },
 };
 function getModelPricing(modelId) {
     if (MODEL_PRICING[modelId])
@@ -74,12 +75,14 @@ function calculateTurnCost(model, usage) {
         (usage.cache_creation_tokens / 1000000) * p.cacheWrite +
         (usage.cache_read_tokens / 1000000) * p.cacheRead);
 }
-/** Detect ekkOS 3-word session names like "lit-lex-zip" */
+/** Detect ekkOS 3-word session names like "lit-lex-zip" or "ink-net-wag-235" */
 function isEkkosSessionName(name) {
-    return /^[a-z]+-[a-z]+-[a-z]+$/.test(name);
+    return /^[a-z]+-[a-z]+-[a-z]+(-\d+)?$/.test(name);
 }
 function encodeProjectPath(projectPath) {
-    return projectPath.replace(/\//g, '-');
+    // Claude Code replaces all non-alphanumeric chars with '-' in project dir names.
+    // This must match Claude's encoding (e.g., /Volumes/ekkOS_Drive → -Volumes-ekkOS-Drive).
+    return projectPath.replace(/[^a-zA-Z0-9]/g, '-');
 }
 /** Resolve an ekkOS session name to a JSONL UUID */
 function resolveSessionName(name) {

package/dist/local/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Local-First Mode — barrel export
+ *
+ * Phase 6 of the ekkOS Leadership Plan.
+ * Provides offline-capable memory, fallback logic, sync, and local embeddings.
+ */
+export { LocalMemoryStore, localStore, } from './sqlite-store';
+export type { Pattern, Directive, EpisodicMemory, SyncQueueItem, StoreStats, } from './sqlite-store';
+export { callWithFallback, isOfflineFallbackReady, OFFLINE_CAPABLE_TOOLS, } from './offline-fallback';
+export type { ToolCallResult, RemoteCallFn, } from './offline-fallback';
+export { SyncEngine, createSyncEngine, } from './sync-engine';
+export type { SyncResult, } from './sync-engine';
+export { generateLocalEmbedding, cosineSimilarity, searchByEmbedding, isEmbeddingAvailable, } from './local-embeddings';
+export type { SimilarityResult, } from './local-embeddings';

package/dist/local/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Local-First Mode — barrel export
+ *
+ * Phase 6 of the ekkOS Leadership Plan.
+ * Provides offline-capable memory, fallback logic, sync, and local embeddings.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEmbeddingAvailable = exports.searchByEmbedding = exports.cosineSimilarity = exports.generateLocalEmbedding = exports.createSyncEngine = exports.SyncEngine = exports.OFFLINE_CAPABLE_TOOLS = exports.isOfflineFallbackReady = exports.callWithFallback = exports.localStore = exports.LocalMemoryStore = void 0;
+// SQLite memory store (Phase 6A)
+var sqlite_store_1 = require("./sqlite-store");
+Object.defineProperty(exports, "LocalMemoryStore", { enumerable: true, get: function () { return sqlite_store_1.LocalMemoryStore; } });
+Object.defineProperty(exports, "localStore", { enumerable: true, get: function () { return sqlite_store_1.localStore; } });
+// Offline MCP fallback (Phase 6B)
+var offline_fallback_1 = require("./offline-fallback");
+Object.defineProperty(exports, "callWithFallback", { enumerable: true, get: function () { return offline_fallback_1.callWithFallback; } });
+Object.defineProperty(exports, "isOfflineFallbackReady", { enumerable: true, get: function () { return offline_fallback_1.isOfflineFallbackReady; } });
+Object.defineProperty(exports, "OFFLINE_CAPABLE_TOOLS", { enumerable: true, get: function () { return offline_fallback_1.OFFLINE_CAPABLE_TOOLS; } });
+// Sync engine (Phase 6C)
+var sync_engine_1 = require("./sync-engine");
+Object.defineProperty(exports, "SyncEngine", { enumerable: true, get: function () { return sync_engine_1.SyncEngine; } });
+Object.defineProperty(exports, "createSyncEngine", { enumerable: true, get: function () { return sync_engine_1.createSyncEngine; } });
+// Local embeddings (Phase 6D)
+var local_embeddings_1 = require("./local-embeddings");
+Object.defineProperty(exports, "generateLocalEmbedding", { enumerable: true, get: function () { return local_embeddings_1.generateLocalEmbedding; } });
+Object.defineProperty(exports, "cosineSimilarity", { enumerable: true, get: function () { return local_embeddings_1.cosineSimilarity; } });
+Object.defineProperty(exports, "searchByEmbedding", { enumerable: true, get: function () { return local_embeddings_1.searchByEmbedding; } });
+Object.defineProperty(exports, "isEmbeddingAvailable", { enumerable: true, get: function () { return local_embeddings_1.isEmbeddingAvailable; } });

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

@@ -0,0 +1,49 @@
+/**
+ * Local Embeddings using ONNX Runtime
+ *
+ * Uses bge-small-en-v1.5 (384 dimensions) for offline similarity search.
+ * Same model OMEGA uses — lightweight, good quality.
+ *
+ * Note: Local embeddings are 384-dim (bge-small-en-v1.5)
+ *       Cloud embeddings are 1536-dim (OpenAI text-embedding-3-small)
+ *       On sync: re-embed with cloud model for consistency
+ *
+ * Optional dependency: @xenova/transformers
+ * If not installed, falls back to TF-IDF keyword similarity.
+ */
+export interface SimilarityResult {
+    id: string;
+    score: number;
+}
+/**
+ * Generate a 384-dimensional embedding vector using bge-small-en-v1.5.
+ * Falls back to an empty array if @xenova/transformers is not installed.
+ * Callers should check array length before using for similarity.
+ */
+export declare function generateLocalEmbedding(text: string): Promise<number[]>;
+/**
+ * Cosine similarity between two dense numeric vectors.
+ * Returns a value in [-1, 1] (1 = identical direction).
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+/**
+ * Rank candidates by semantic similarity to the query.
+ *
+ * Tries ONNX embedding first; falls back to TF-IDF keyword similarity if
+ * @xenova/transformers is not installed or if embedding fails.
+ *
+ * @param query      - Search query string
+ * @param candidates - Items to rank (each has an `id` and `text` for embedding)
+ * @param topK       - How many results to return (default 5)
+ *
+ * @returns Ranked array of { id, score } sorted by descending similarity
+ */
+export declare function searchByEmbedding(query: string, candidates: {
+    id: string;
+    text: string;
+}[], topK?: number): Promise<SimilarityResult[]>;
+/**
+ * Check whether the ONNX embedding pipeline is available.
+ * Returns false if @xenova/transformers is not installed.
+ */
+export declare function isEmbeddingAvailable(): Promise<boolean>;

package/dist/local/local-embeddings.js

@@ -0,0 +1,232 @@
+"use strict";
+/**
+ * Local Embeddings using ONNX Runtime
+ *
+ * Uses bge-small-en-v1.5 (384 dimensions) for offline similarity search.
+ * Same model OMEGA uses — lightweight, good quality.
+ *
+ * Note: Local embeddings are 384-dim (bge-small-en-v1.5)
+ *       Cloud embeddings are 1536-dim (OpenAI text-embedding-3-small)
+ *       On sync: re-embed with cloud model for consistency
+ *
+ * Optional dependency: @xenova/transformers
+ * If not installed, falls back to TF-IDF keyword similarity.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateLocalEmbedding = generateLocalEmbedding;
+exports.cosineSimilarity = cosineSimilarity;
+exports.searchByEmbedding = searchByEmbedding;
+exports.isEmbeddingAvailable = isEmbeddingAvailable;
+let _pipeline = null;
+let _pipelineLoading = null;
+let _transformersAvailable = null; // null = not yet checked
+async function getTransformerPipeline() {
+    if (_transformersAvailable === false)
+        return null;
+    if (_pipeline)
+        return _pipeline;
+    if (_pipelineLoading)
+        return _pipelineLoading;
+    _pipelineLoading = (async () => {
+        try {
+            // Dynamic import — fails gracefully if package not installed
+            const mod = await Promise.resolve(`${'@xenova/transformers'}`).then(s => __importStar(require(s)));
+            const { pipeline } = mod;
+            // Load the bge-small-en-v1.5 model (384 dims, ~33MB)
+            const featureExtractor = await pipeline('feature-extraction', 'Xenova/bge-small-en-v1.5', {
+                quantized: true, // use int8 quantised version for speed
+            });
+            // Wrap in a normalised shape so callers get consistent output
+            const wrapped = async (text) => {
+                const output = await featureExtractor(text, { pooling: 'mean', normalize: true });
+                return output;
+            };
+            _pipeline = wrapped;
+            _transformersAvailable = true;
+            return wrapped;
+        }
+        catch {
+            _transformersAvailable = false;
+            return null;
+        }
+    })();
+    return _pipelineLoading;
+}
+// ---------------------------------------------------------------------------
+// TF-IDF fallback
+// ---------------------------------------------------------------------------
+/**
+ * Build a simple term-frequency vector from a piece of text.
+ * Returns a sparse Map<term, tf> (normalised by document length).
+ */
+function buildTfVector(text) {
+    const tokens = tokenise(text);
+    const tf = new Map();
+    for (const token of tokens) {
+        tf.set(token, (tf.get(token) ?? 0) + 1);
+    }
+    // Normalise by document length
+    for (const [term, count] of tf) {
+        tf.set(term, count / tokens.length);
+    }
+    return tf;
+}
+function tokenise(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, ' ')
+        .split(/\s+/)
+        .filter(t => t.length > 1 && !STOP_WORDS.has(t));
+}
+/** Minimal English stop-word list */
+const STOP_WORDS = new Set([
+    'a', 'an', 'the', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for',
+    'of', 'is', 'it', 'its', 'be', 'by', 'as', 'are', 'was', 'were', 'with',
+    'this', 'that', 'from', 'not', 'we', 'i', 'you', 'he', 'she', 'they',
+    'do', 'does', 'did', 'have', 'has', 'had', 'can', 'will', 'would', 'should',
+    'so', 'if', 'up', 'out', 'no', 'my', 'your', 'our', 'all', 'more', 'also',
+]);
+/**
+ * Cosine similarity between two TF sparse vectors.
+ */
+function sparseCosine(a, b) {
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (const [term, va] of a) {
+        normA += va * va;
+        const vb = b.get(term) ?? 0;
+        dot += va * vb;
+    }
+    for (const [, vb] of b) {
+        normB += vb * vb;
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+// ---------------------------------------------------------------------------
+// Exported functions
+// ---------------------------------------------------------------------------
+/**
+ * Generate a 384-dimensional embedding vector using bge-small-en-v1.5.
+ * Falls back to an empty array if @xenova/transformers is not installed.
+ * Callers should check array length before using for similarity.
+ */
+async function generateLocalEmbedding(text) {
+    const pipe = await getTransformerPipeline();
+    if (!pipe)
+        return [];
+    try {
+        const result = await pipe(text);
+        return Array.from(result.data);
+    }
+    catch (err) {
+        console.warn('[LocalEmbeddings] generateLocalEmbedding failed:', err.message);
+        return [];
+    }
+}
+/**
+ * Cosine similarity between two dense numeric vectors.
+ * Returns a value in [-1, 1] (1 = identical direction).
+ */
+function cosineSimilarity(a, b) {
+    if (a.length === 0 || b.length === 0 || a.length !== b.length)
+        return 0;
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+/**
+ * Rank candidates by semantic similarity to the query.
+ *
+ * Tries ONNX embedding first; falls back to TF-IDF keyword similarity if
+ * @xenova/transformers is not installed or if embedding fails.
+ *
+ * @param query      - Search query string
+ * @param candidates - Items to rank (each has an `id` and `text` for embedding)
+ * @param topK       - How many results to return (default 5)
+ *
+ * @returns Ranked array of { id, score } sorted by descending similarity
+ */
+async function searchByEmbedding(query, candidates, topK = 5) {
+    if (candidates.length === 0)
+        return [];
+    const pipe = await getTransformerPipeline();
+    if (pipe) {
+        // --- ONNX path ---
+        try {
+            const queryVec = await generateLocalEmbedding(query);
+            if (queryVec.length === 0)
+                throw new Error('Empty query embedding');
+            const scored = await Promise.all(candidates.map(async (c) => {
+                const vec = await generateLocalEmbedding(c.text);
+                return { id: c.id, score: cosineSimilarity(queryVec, vec) };
+            }));
+            return scored
+                .sort((a, b) => b.score - a.score)
+                .slice(0, topK);
+        }
+        catch (err) {
+            console.warn('[LocalEmbeddings] ONNX search failed, falling back to TF-IDF:', err.message);
+        }
+    }
+    // --- TF-IDF keyword fallback ---
+    const queryTf = buildTfVector(query);
+    const scored = candidates.map((c) => ({
+        id: c.id,
+        score: sparseCosine(queryTf, buildTfVector(c.text)),
+    }));
+    return scored
+        .sort((a, b) => b.score - a.score)
+        .slice(0, topK);
+}
+/**
+ * Check whether the ONNX embedding pipeline is available.
+ * Returns false if @xenova/transformers is not installed.
+ */
+async function isEmbeddingAvailable() {
+    if (_transformersAvailable !== null)
+        return _transformersAvailable;
+    const pipe = await getTransformerPipeline();
+    return pipe !== null;
+}