notoken-core 1.6.0 → 2.0.0

package/dist/index.d.ts

@@ -12,12 +12,23 @@ export { parseByRules } from "./nlp/ruleParser.js";
 export { disambiguate } from "./nlp/disambiguate.js";
 export { classifyMulti } from "./nlp/multiClassifier.js";
 export { semanticParse, tokenize, keyboardDistance, fuzzyMatch } from "./nlp/semantic.js";
+export { findSimilarIntents, phraseSimilarity, expandWithCooccurrences } from "./nlp/semanticSimilarity.js";
+export { loadKnowledgeGraph, saveKnowledgeGraph, addEntity, addRelation, getEntity, getRelated, resolveReference, resolveCandidates, inferIntent, queryGraph, rebuildGraph, learnFromExecution, flushGraph } from "./nlp/knowledgeGraph.js";
+export { expandQuery, findCluster, suggestIntents, clusterWords } from "./nlp/conceptExpansion.js";
 export { analyzeUncertainty, getUncoveredSpans } from "./nlp/uncertainty.js";
 export { llmFallback, isLLMConfigured, getLLMBackend, formatLLMFallback } from "./nlp/llmFallback.js";
+export { suggestEntityCorrection, correctEntities, resolveDescription, resetEntityVocab } from "./nlp/entitySpellCorrect.js";
+export { recordOutcome, getMultiplier, calibrateVotes, recordCorrection, getCalibrationStats, flushCalibration } from "./nlp/confidenceCalibrator.js";
+export { detectBatch, expandBatch, expandEnvironmentBatch } from "./nlp/batchParser.js";
+export { getCurrentTopic, suggestFollowups, getTopicDefault } from "./conversation/topicTracker.js";
+export { progressReporter, reportProgress, reportStep } from "./utils/progressReporter.js";
+export { loadHistory as loadCommandHistory, addToHistory, searchHistory as searchCommandHistory, getRecentCommands, getReadlineHistory } from "./utils/commandHistory.js";
 export { executeIntent } from "./handlers/executor.js";
 export { runRemoteCommand, runLocalCommand } from "./execution/ssh.js";
 export { loadRules, loadIntents, getIntentDef, loadHosts, getConfigDir } from "./utils/config.js";
 export { CONFIG_DIR, DATA_DIR, LOG_DIR, PACKAGE_ROOT, USER_HOME, isSEA, ensureUserDirs } from "./utils/paths.js";
+export { loadAliases, resolveAlias, saveAlias, removeAlias, listAliases } from "./utils/aliases.js";
+export { buildCompletions, completeInput } from "./utils/completer.js";
 export { detectLocalPlatform, getInstallCommand, getServiceCommand, getPackageForCommand, formatPlatform } from "./utils/platform.js";
 export type { PlatformInfo } from "./utils/platform.js";
 export { winToLinux, linuxToWin, normalizePath, getUserDirs, isWSL, isWindows } from "./utils/wslPaths.js";
@@ -27,8 +38,8 @@ export { analyzeDirectory } from "./utils/dirAnalysis.js";
 export { smartRead, smartSearch, getFileInfo } from "./utils/smartFile.js";
 export { parseFile, formatParsedFile, detectFileType } from "./parsers/index.js";
 export { findKnownLocations, searchRemoteFile } from "./parsers/fileFinder.js";
-export { getOrCreateConversation, addUserTurn, addSystemTurn, saveConversation, getLastEntity, getRecentEntities, listConversations } from "./conversation/store.js";
-export type { Conversation, ConversationTurn, KnowledgeNode, UncertaintyReport } from "./conversation/store.js";
+export { getOrCreateConversation, addUserTurn, addSystemTurn, saveConversation, getLastEntity, getRecentEntities, getRecentTurns, listConversations, loadContextFile, unloadContextFile, listContextFiles, setEntityFocus, getEntityFocus, getPreviousFocus, resolveFocusReference } from "./conversation/store.js";
+export type { Conversation, ConversationTurn, KnowledgeNode, UncertaintyReport, EntityFocus } from "./conversation/store.js";
 export { resolveCoreferences, extractEntitiesFromFields } from "./conversation/coreference.js";
 export { redactSecrets, listSecrets, clearSecrets, saveSecretsToFile, resolvePlaceholders } from "./conversation/secrets.js";
 export { taskRunner, type BackgroundTask } from "./agents/taskRunner.js";
@@ -44,10 +55,21 @@ export { formatExplain } from "./utils/explain.js";
 export { formatParsedCommand } from "./utils/output.js";
 export { Spinner, withSpinner, progressBar } from "./utils/spinner.js";
 export { createBackup, rollback, listBackups, cleanExpiredBackups, formatBackupList } from "./utils/autoBackup.js";
-export { checkForUpdate, checkForUpdateSync, runUpdate, formatUpdateBanner, type UpdateInfo } from "./utils/updater.js";
+export { checkForUpdate, checkForUpdateSync, runUpdate, formatUpdateBanner, isNewer, type UpdateInfo } from "./utils/updater.js";
 export { detectProviders, formatStatus, goOffline, goOnline, disableLLM, enableLLM, isOfflineMode, isLLMDisabled, recordOfflineCommand, getTokensSaved, formatTokensSaved, formatTokensSavedBrief, saveOnExit, getSessionId, type LLMProvider, type LLMState, } from "./utils/llmManager.js";
 export { getRecentSessions, getSessionsForFolder, formatSessionSummary, formatSessionList, type SessionSummary, } from "./utils/sessionSummary.js";
 export { isSessionOpen, toggleSession, hideSession, unhideSession, getHiddenSessions, getLastViewedSession, createFullBackup, restoreFromBackup, listFullBackups, formatBackupsList, type BackupInfo, } from "./utils/sessionBackup.js";
+export { analyzeFailure, type FailureAnalysis, } from "./utils/smartRetry.js";
+export { suggestAction, getLastPendingAction, consumePendingAction, isAffirmation, isRedirectingPendingAction, clearPendingActions, type PendingAction, } from "./conversation/pendingActions.js";
+export { parseMultiIntent, splitCompoundSentence, formatPlanSteps, type MultiIntentPlan, type PlanStep, } from "./nlp/multiIntent.js";
+export { routeByConcepts, mergeConceptDomains, type ConceptRouterResult } from "./nlp/conceptRouter.js";
+export { enrichVocabularyFromWiki, loadLearnedVocabulary, getEnrichedConcepts, type LearnedVocabulary, } from "./nlp/vocabularyBuilder.js";
+export { commandExists, tryExec as shellTryExec, getTempDir, timestamp, fileSize, lineCount, shellExec, crossPlatformCmd, silenceStderr, isWin, getPlatformSummary, isAdmin, getSystemInstallCmd, } from "./utils/shellCompat.js";
+export { trackInstall, getInstallHistory, getInstalledByType, getInstalledItem, untrackInstall, formatInstallHistory, getUninstallSteps, type InstalledItem, type InstallHistory, } from "./utils/installTracker.js";
+export { searchWikidata, lookupUnknownNouns, formatWikiEntity, formatWikiSuggestions, type WikiEntity, type WikiLookupResult, } from "./nlp/wikidata.js";
+export { detectGpu, detectImageEngines, getBestImageEngine, generateImage, getInstallPlan, installImageEngine, formatImageEngineStatus, getDriveInfo, resolveUserPath, type ImageEngine, type ImageEngineStatus, type GpuInfo, type GenerateResult, type DriveInfo, } from "./utils/imageGen.js";
+export { scanProjects, summarizeDirectory, formatProjectList, formatDirSummary, type ProjectInfo, type DirSummary, } from "./utils/projectScanner.js";
+export { detectBrowserEngines, getBestEngine, installBrowserEngine, browse, formatBrowserStatus, stopDockerBrowser, normalizeUrl, type BrowserEngine, type BrowserStatus, type BrowseOptions, type BrowseResult, type InstallResult, } from "./utils/browser.js";
 export { logFailure, loadFailures, clearFailures } from "./utils/logger.js";
 export { logUncertainty, loadUncertaintyLog, getUncertaintySummary } from "./nlp/uncertainty.js";
 export { recordHistory, loadHistory, getRecentHistory, searchHistory } from "./context/history.js";

package/dist/index.js

@@ -13,14 +13,26 @@ export { parseByRules } from "./nlp/ruleParser.js";
 export { disambiguate } from "./nlp/disambiguate.js";
 export { classifyMulti } from "./nlp/multiClassifier.js";
 export { semanticParse, tokenize, keyboardDistance, fuzzyMatch } from "./nlp/semantic.js";
+export { findSimilarIntents, phraseSimilarity, expandWithCooccurrences } from "./nlp/semanticSimilarity.js";
+export { loadKnowledgeGraph, saveKnowledgeGraph, addEntity, addRelation, getEntity, getRelated, resolveReference, resolveCandidates, inferIntent, queryGraph, rebuildGraph, learnFromExecution, flushGraph } from "./nlp/knowledgeGraph.js";
+export { expandQuery, findCluster, suggestIntents, clusterWords } from "./nlp/conceptExpansion.js";
 export { analyzeUncertainty, getUncoveredSpans } from "./nlp/uncertainty.js";
 export { llmFallback, isLLMConfigured, getLLMBackend, formatLLMFallback } from "./nlp/llmFallback.js";
+export { suggestEntityCorrection, correctEntities, resolveDescription, resetEntityVocab } from "./nlp/entitySpellCorrect.js";
+export { recordOutcome, getMultiplier, calibrateVotes, recordCorrection, getCalibrationStats, flushCalibration } from "./nlp/confidenceCalibrator.js";
+export { detectBatch, expandBatch, expandEnvironmentBatch } from "./nlp/batchParser.js";
+export { getCurrentTopic, suggestFollowups, getTopicDefault } from "./conversation/topicTracker.js";
+// ── Progress & History ──
+export { progressReporter, reportProgress, reportStep } from "./utils/progressReporter.js";
+export { loadHistory as loadCommandHistory, addToHistory, searchHistory as searchCommandHistory, getRecentCommands, getReadlineHistory } from "./utils/commandHistory.js";
 // ── Execution ──
 export { executeIntent } from "./handlers/executor.js";
 export { runRemoteCommand, runLocalCommand } from "./execution/ssh.js";
 // ── Config ──
 export { loadRules, loadIntents, getIntentDef, loadHosts, getConfigDir } from "./utils/config.js";
 export { CONFIG_DIR, DATA_DIR, LOG_DIR, PACKAGE_ROOT, USER_HOME, isSEA, ensureUserDirs } from "./utils/paths.js";
+export { loadAliases, resolveAlias, saveAlias, removeAlias, listAliases } from "./utils/aliases.js";
+export { buildCompletions, completeInput } from "./utils/completer.js";
 // ── Platform & Detection ──
 export { detectLocalPlatform, getInstallCommand, getServiceCommand, getPackageForCommand, formatPlatform } from "./utils/platform.js";
 // ── Paths ──
@@ -35,7 +47,7 @@ export { smartRead, smartSearch, getFileInfo } from "./utils/smartFile.js";
 export { parseFile, formatParsedFile, detectFileType } from "./parsers/index.js";
 export { findKnownLocations, searchRemoteFile } from "./parsers/fileFinder.js";
 // ── Conversation ──
-export { getOrCreateConversation, addUserTurn, addSystemTurn, saveConversation, getLastEntity, getRecentEntities, listConversations } from "./conversation/store.js";
+export { getOrCreateConversation, addUserTurn, addSystemTurn, saveConversation, getLastEntity, getRecentEntities, getRecentTurns, listConversations, loadContextFile, unloadContextFile, listContextFiles, setEntityFocus, getEntityFocus, getPreviousFocus, resolveFocusReference } from "./conversation/store.js";
 export { resolveCoreferences, extractEntitiesFromFields } from "./conversation/coreference.js";
 export { redactSecrets, listSecrets, clearSecrets, saveSecretsToFile, resolvePlaceholders } from "./conversation/secrets.js";
 // ── Agents & Background ──
@@ -57,13 +69,35 @@ export { Spinner, withSpinner, progressBar } from "./utils/spinner.js";
 // ── Auto-backup ──
 export { createBackup, rollback, listBackups, cleanExpiredBackups, formatBackupList } from "./utils/autoBackup.js";
 // ── Updates ──
-export { checkForUpdate, checkForUpdateSync, runUpdate, formatUpdateBanner } from "./utils/updater.js";
+export { checkForUpdate, checkForUpdateSync, runUpdate, formatUpdateBanner, isNewer } from "./utils/updater.js";
 // ── LLM Manager ──
 export { detectProviders, formatStatus, goOffline, goOnline, disableLLM, enableLLM, isOfflineMode, isLLMDisabled, recordOfflineCommand, getTokensSaved, formatTokensSaved, formatTokensSavedBrief, saveOnExit, getSessionId, } from "./utils/llmManager.js";
 // ── Session Summaries ──
 export { getRecentSessions, getSessionsForFolder, formatSessionSummary, formatSessionList, } from "./utils/sessionSummary.js";
 // ── Session Backup & Prefs ──
 export { isSessionOpen, toggleSession, hideSession, unhideSession, getHiddenSessions, getLastViewedSession, createFullBackup, restoreFromBackup, listFullBackups, formatBackupsList, } from "./utils/sessionBackup.js";
+// ── Smart Retry ──
+export { analyzeFailure, } from "./utils/smartRetry.js";
+// ── Pending Actions ──
+export { suggestAction, getLastPendingAction, consumePendingAction, isAffirmation, isRedirectingPendingAction, clearPendingActions, } from "./conversation/pendingActions.js";
+// ── Multi-Intent ──
+export { parseMultiIntent, splitCompoundSentence, formatPlanSteps, } from "./nlp/multiIntent.js";
+// ── Concept Router ──
+export { routeByConcepts, mergeConceptDomains } from "./nlp/conceptRouter.js";
+// ── Vocabulary Builder ──
+export { enrichVocabularyFromWiki, loadLearnedVocabulary, getEnrichedConcepts, } from "./nlp/vocabularyBuilder.js";
+// ── Shell Compatibility ──
+export { commandExists, tryExec as shellTryExec, getTempDir, timestamp, fileSize, lineCount, shellExec, crossPlatformCmd, silenceStderr, isWin, getPlatformSummary, isAdmin, getSystemInstallCmd, } from "./utils/shellCompat.js";
+// ── Install Tracker ──
+export { trackInstall, getInstallHistory, getInstalledByType, getInstalledItem, untrackInstall, formatInstallHistory, getUninstallSteps, } from "./utils/installTracker.js";
+// ── Wikidata Knowledge Base ──
+export { searchWikidata, lookupUnknownNouns, formatWikiEntity, formatWikiSuggestions, } from "./nlp/wikidata.js";
+// ── Image Generation ──
+export { detectGpu, detectImageEngines, getBestImageEngine, generateImage, getInstallPlan, installImageEngine, formatImageEngineStatus, getDriveInfo, resolveUserPath, } from "./utils/imageGen.js";
+// ── Project Scanner ──
+export { scanProjects, summarizeDirectory, formatProjectList, formatDirSummary, } from "./utils/projectScanner.js";
+// ── Browser ──
+export { detectBrowserEngines, getBestEngine, installBrowserEngine, browse, formatBrowserStatus, stopDockerBrowser, normalizeUrl, } from "./utils/browser.js";
 // ── Logging ──
 export { logFailure, loadFailures, clearFailures } from "./utils/logger.js";
 export { logUncertainty, loadUncertaintyLog, getUncertaintySummary } from "./nlp/uncertainty.js";

package/dist/nlp/batchParser.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Batch Parser — detect and expand batch commands.
+ *
+ * "restart nginx, redis, and mysql on prod"
+ *   → 3 intents: restart nginx on prod, restart redis on prod, restart mysql on prod
+ *
+ * "check disk on prod, staging, and dev"
+ *   → 3 intents: check disk on prod, check disk on staging, check disk on dev
+ *
+ * "stop containers api, worker, and scheduler"
+ *   → 3 intents: stop container api, stop container worker, stop container scheduler
+ */
+export interface BatchExpansion {
+    isBatch: boolean;
+    commands: string[];
+    original: string;
+}
+/**
+ * Detect if input contains a batch/list of targets and expand.
+ */
+export declare function expandBatch(rawText: string): BatchExpansion;
+/**
+ * Also handle "on X, Y, and Z" pattern:
+ * "check disk on prod, staging, and dev"
+ */
+export declare function expandEnvironmentBatch(rawText: string): BatchExpansion;
+/**
+ * Try both batch patterns and return the first match.
+ */
+export declare function detectBatch(rawText: string): BatchExpansion;

package/dist/nlp/batchParser.js

@@ -0,0 +1,77 @@
+/**
+ * Batch Parser — detect and expand batch commands.
+ *
+ * "restart nginx, redis, and mysql on prod"
+ *   → 3 intents: restart nginx on prod, restart redis on prod, restart mysql on prod
+ *
+ * "check disk on prod, staging, and dev"
+ *   → 3 intents: check disk on prod, check disk on staging, check disk on dev
+ *
+ * "stop containers api, worker, and scheduler"
+ *   → 3 intents: stop container api, stop container worker, stop container scheduler
+ */
+// Patterns for comma-separated lists with "and"
+const LIST_PATTERN = /^(.+?)\s+([\w-]+(?:\s*,\s*[\w-]+)*\s*(?:,?\s*and\s+[\w-]+))\s*(.*)$/i;
+/**
+ * Detect if input contains a batch/list of targets and expand.
+ */
+export function expandBatch(rawText) {
+    const text = rawText.trim();
+    // Pattern: "verb targets, target2, and target3 modifier"
+    // E.g., "restart nginx, redis, and mysql on prod"
+    const match = text.match(LIST_PATTERN);
+    if (!match)
+        return { isBatch: false, commands: [text], original: text };
+    const prefix = match[1].trim(); // "restart"
+    const listPart = match[2].trim(); // "nginx, redis, and mysql"
+    const suffix = match[3].trim(); // "on prod"
+    // Parse the comma/and-separated list
+    const items = listPart
+        .replace(/\s+and\s+/gi, ", ")
+        .split(/\s*,\s*/)
+        .map(s => s.trim())
+        .filter(s => s.length > 0);
+    // Need at least 2 items for it to be a batch
+    if (items.length < 2)
+        return { isBatch: false, commands: [text], original: text };
+    // Verify these look like service/entity names (not random words)
+    const looksLikeEntities = items.every(item => /^[\w][\w.-]*$/.test(item) && item.length >= 2 && item.length <= 30);
+    if (!looksLikeEntities)
+        return { isBatch: false, commands: [text], original: text };
+    // Expand: "restart X on prod" for each item
+    const commands = items.map(item => `${prefix} ${item}${suffix ? ` ${suffix}` : ""}`);
+    return { isBatch: true, commands, original: text };
+}
+/**
+ * Also handle "on X, Y, and Z" pattern:
+ * "check disk on prod, staging, and dev"
+ */
+export function expandEnvironmentBatch(rawText) {
+    const text = rawText.trim();
+    // Pattern: "command on env1, env2, and env3"
+    const match = text.match(/^(.+?)\s+on\s+([\w-]+(?:\s*,\s*[\w-]+)*\s*(?:,?\s*and\s+[\w-]+))$/i);
+    if (!match)
+        return { isBatch: false, commands: [text], original: text };
+    const command = match[1].trim();
+    const envPart = match[2].trim();
+    const envs = envPart
+        .replace(/\s+and\s+/gi, ", ")
+        .split(/\s*,\s*/)
+        .map(s => s.trim())
+        .filter(s => s.length > 0);
+    if (envs.length < 2)
+        return { isBatch: false, commands: [text], original: text };
+    const commands = envs.map(env => `${command} on ${env}`);
+    return { isBatch: true, commands, original: text };
+}
+/**
+ * Try both batch patterns and return the first match.
+ */
+export function detectBatch(rawText) {
+    // Try environment batch first ("check disk on prod, staging, and dev")
+    const envBatch = expandEnvironmentBatch(rawText);
+    if (envBatch.isBatch)
+        return envBatch;
+    // Then try entity batch ("restart nginx, redis, and mysql")
+    return expandBatch(rawText);
+}

package/dist/nlp/conceptExpansion.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Concept expansion module.
+ *
+ * Auto-expands concepts so the classifier catches more natural language
+ * variations. Synonym clusters and domain mappings are stored in
+ * config/concept-clusters.json so users can extend them.
+ *
+ * Main exports:
+ *   - expandQuery(text)    — appends synonym keywords for scoring
+ *   - findCluster(word)    — returns the cluster name a word belongs to
+ *   - suggestIntents(word) — maps a concept cluster to likely intent domains
+ */
+/** Force-reload config (useful after user edits the JSON). */
+export declare function reloadConfig(): void;
+/**
+ * Find which cluster a word belongs to.
+ * Returns the canonical cluster name, or undefined if no match.
+ *
+ *   findCluster("reboot")  → "restart"
+ *   findCluster("hello")   → undefined
+ */
+export declare function findCluster(word: string): string | undefined;
+/**
+ * Expand a query by appending synonym keywords from every cluster
+ * that matches a token in the text. The original text is preserved;
+ * extra tokens are appended (space-separated) for scoring purposes.
+ *
+ *   expandQuery("reboot the server")
+ *   → "reboot the server restart cycle reload bounce"
+ */
+export declare function expandQuery(text: string): string;
+/**
+ * Given a word, find its cluster, then return the intent domain patterns
+ * whose concept list includes that cluster.
+ *
+ *   suggestIntents("reboot")
+ *   → ["service.*", "docker.*"]   (domains that list "restart")
+ *
+ *   suggestIntents("hello")
+ *   → []
+ */
+export declare function suggestIntents(word: string): string[];
+/**
+ * Return all clusters that are relevant to a given intent domain.
+ *
+ *   clustersForDomain("docker.restart") → ["restart", "stop", "start", "show"]
+ */
+export declare function clustersForDomain(intentId: string): string[];
+/**
+ * Get all synonyms for a cluster (including the canonical name).
+ *
+ *   clusterWords("restart") → ["restart", "reboot", "bounce", "cycle", "reload"]
+ */
+export declare function clusterWords(clusterName: string): string[];

package/dist/nlp/conceptExpansion.js

@@ -0,0 +1,136 @@
+/**
+ * Concept expansion module.
+ *
+ * Auto-expands concepts so the classifier catches more natural language
+ * variations. Synonym clusters and domain mappings are stored in
+ * config/concept-clusters.json so users can extend them.
+ *
+ * Main exports:
+ *   - expandQuery(text)    — appends synonym keywords for scoring
+ *   - findCluster(word)    — returns the cluster name a word belongs to
+ *   - suggestIntents(word) — maps a concept cluster to likely intent domains
+ */
+import { readFileSync } from "fs";
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+// ─── Load config ─────────────────────────────────────────────────────────────
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const CONFIG_PATH = resolve(__dirname, "../../config/concept-clusters.json");
+let config;
+function loadConfig() {
+    const raw = readFileSync(CONFIG_PATH, "utf-8");
+    return JSON.parse(raw);
+}
+function getConfig() {
+    if (!config)
+        config = loadConfig();
+    return config;
+}
+/** Force-reload config (useful after user edits the JSON). */
+export function reloadConfig() {
+    config = loadConfig();
+}
+// ─── Synonym lookup (built lazily) ──────────────────────────────────────────
+/** Reverse index: synonym word → cluster name. Built once on first access. */
+let reverseIndex;
+function getReverseIndex() {
+    if (reverseIndex)
+        return reverseIndex;
+    reverseIndex = new Map();
+    const clusters = getConfig().synonymClusters;
+    for (const [canonical, synonyms] of Object.entries(clusters)) {
+        reverseIndex.set(canonical, canonical);
+        for (const s of synonyms) {
+            reverseIndex.set(s.toLowerCase(), canonical);
+        }
+    }
+    return reverseIndex;
+}
+// ─── Public API ─────────────────────────────────────────────────────────────
+/**
+ * Find which cluster a word belongs to.
+ * Returns the canonical cluster name, or undefined if no match.
+ *
+ *   findCluster("reboot")  → "restart"
+ *   findCluster("hello")   → undefined
+ */
+export function findCluster(word) {
+    return getReverseIndex().get(word.toLowerCase());
+}
+/**
+ * Expand a query by appending synonym keywords from every cluster
+ * that matches a token in the text. The original text is preserved;
+ * extra tokens are appended (space-separated) for scoring purposes.
+ *
+ *   expandQuery("reboot the server")
+ *   → "reboot the server restart cycle reload bounce"
+ */
+export function expandQuery(text) {
+    const clusters = getConfig().synonymClusters;
+    const idx = getReverseIndex();
+    const tokens = text.toLowerCase().split(/\s+/);
+    const seen = new Set();
+    const extras = [];
+    for (const tok of tokens) {
+        const cluster = idx.get(tok);
+        if (!cluster || seen.has(cluster))
+            continue;
+        seen.add(cluster);
+        // Append canonical name + all synonyms that aren't already in the text
+        const all = [cluster, ...clusters[cluster]];
+        for (const w of all) {
+            const lower = w.toLowerCase();
+            if (!tokens.includes(lower))
+                extras.push(lower);
+        }
+    }
+    return extras.length ? `${text} ${extras.join(" ")}` : text;
+}
+/**
+ * Given a word, find its cluster, then return the intent domain patterns
+ * whose concept list includes that cluster.
+ *
+ *   suggestIntents("reboot")
+ *   → ["service.*", "docker.*"]   (domains that list "restart")
+ *
+ *   suggestIntents("hello")
+ *   → []
+ */
+export function suggestIntents(word) {
+    const cluster = findCluster(word);
+    if (!cluster)
+        return [];
+    const domains = getConfig().domainConcepts;
+    const matches = [];
+    for (const [pattern, concepts] of Object.entries(domains)) {
+        if (concepts.includes(cluster))
+            matches.push(pattern);
+    }
+    return matches;
+}
+/**
+ * Return all clusters that are relevant to a given intent domain.
+ *
+ *   clustersForDomain("docker.restart") → ["restart", "stop", "start", "show"]
+ */
+export function clustersForDomain(intentId) {
+    const domains = getConfig().domainConcepts;
+    for (const [pattern, concepts] of Object.entries(domains)) {
+        const re = new RegExp("^" + pattern.replace(/\./g, "\\.").replace(/\*/g, ".*") + "$");
+        if (re.test(intentId))
+            return concepts;
+    }
+    return [];
+}
+/**
+ * Get all synonyms for a cluster (including the canonical name).
+ *
+ *   clusterWords("restart") → ["restart", "reboot", "bounce", "cycle", "reload"]
+ */
+export function clusterWords(clusterName) {
+    const clusters = getConfig().synonymClusters;
+    const syns = clusters[clusterName];
+    if (!syns)
+        return [];
+    return [clusterName, ...syns];
+}

package/dist/nlp/conceptRouter.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Concept-based intent router.
+ *
+ * Instead of matching exact synonym phrases, this extracts concepts
+ * from the user's input and routes to the right intent domain.
+ *
+ * How it works:
+ *   1. Tokenize with compromise (POS tags)
+ *   2. Extract: action verbs, subject nouns, attribute adjectives, question type
+ *   3. Map concepts to intent domains via a concept→domain map
+ *   4. Pick the best intent within that domain
+ *
+ * This handles:
+ *   "is this happening offline or locally is it free or using cloud?"
+ *   → concepts: [offline, local, free, cloud] → domain: ai.image_status
+ *
+ *   "can you check what crontabs I have running"
+ *   → action: check, subject: crontabs → domain: cron.list
+ */
+/**
+ * Merge additional concept→domain mappings into the router at runtime.
+ * Used by the vocabulary builder to inject learned concepts.
+ * Existing domains for a concept are preserved; new ones are appended.
+ */
+export declare function mergeConceptDomains(mappings: Record<string, string[]>): void;
+export interface DependencyRouteResult {
+    intent: string;
+    confidence: number;
+    verb: string;
+    object?: string;
+    location?: string;
+    reason: string;
+}
+/**
+ * Route by parsing dependency structure (SVO triples).
+ * Maps verb+object combinations to specific intents with graduated confidence.
+ */
+export declare function routeByDependencies(rawText: string): DependencyRouteResult | null;
+export interface ConceptRouterResult {
+    intent: string;
+    confidence: number;
+    concepts: string[];
+    isQuestion: boolean;
+    reason: string;
+}
+/**
+ * Route user input to intent by understanding concepts, not matching phrases.
+ */
+export declare function routeByConcepts(rawText: string): ConceptRouterResult | null;