agent-nuvira 3.3.11 → 3.3.13

package/dist/learning/knowledge-base.d.ts

@@ -0,0 +1,124 @@
+/**
+ * KnowledgeBase — tag-scoped, vectorized retrieval over a user's own documents.
+ *
+ * WHY THIS EXISTS. The retrieval engine (`src/learning/retrieval.ts`) vectorizes
+ * a REPO for token reduction and keys everything by file path; the tagged memory
+ * store (`src/tools/memory-tools.ts`) holds FACTS, not whole documents. Neither
+ * answers "I brought my documents, gave them a tag, and I want precise answers
+ * scoped to that tag." So a user asking about their own data had exactly one
+ * path — re-read the file into context on EVERY turn, which costs the document's
+ * tokens repeatedly and is slow on large files.
+ *
+ * This module pays that cost ONCE. A document is extracted, chunked and embedded
+ * a single time under a tag; each later question embeds a short query and
+ * retrieves its top-k chunks. The tag is a real scope: each tag gets its own
+ * vector namespace (`knowledge-<tag>`), so tags never bleed into each other and
+ * a tag can be forgotten without touching anything else.
+ *
+ * The retrieved chunks are USER DATA; the model supplies the generic half of an
+ * answer (and `web-research` supplies the net-based half). `formatKnowledgeContext`
+ * labels each chunk with its source file so the model can attribute precisely
+ * which part of an answer came from the user's data.
+ *
+ * Storage: vectors in the existing pluggable VectorStore (one JSON/FAISS file
+ * per namespace), a small manifest at `<memory>/knowledge-index.json` for
+ * listing/removal. Everything lives in the Nuvira data dir (`~/.nuvira/memory`),
+ * never in a repository or package.
+ */
+import { DEFAULT_CHUNK_TOKENS, DEFAULT_OVERLAP_TOKENS } from './retrieval.js';
+/** A tag is a sandboxed namespace segment: lowercase alphanumerics + hyphens, with at least one alphanumeric. */
+export declare const KNOWLEDGE_TAG_RE: RegExp;
+/** Namespace prefix — keeps knowledge vectors apart from memory/history/repo. */
+export declare const KNOWLEDGE_NAMESPACE_PREFIX = "knowledge-";
+/** Manifest of tags → documents (listing/removal only; vectors live elsewhere). */
+export declare const KNOWLEDGE_MANIFEST_FILE = "knowledge-index.json";
+/** Default chunks returned per query. */
+export declare const DEFAULT_KNOWLEDGE_TOP_K = 6;
+/** One document recorded under a tag. */
+export interface KnowledgeDocument {
+    path: string;
+    chunks: number;
+    addedAt: number;
+}
+/** Manifest entry for a tag. */
+export interface KnowledgeTagEntry {
+    tag: string;
+    updatedAt: number;
+    chunkCount: number;
+    documents: KnowledgeDocument[];
+}
+interface KnowledgeManifest {
+    version: number;
+    tags: Record<string, KnowledgeTagEntry>;
+}
+/** A retrieval hit scoped to a tag. */
+export interface KnowledgeHit {
+    tag: string;
+    text: string;
+    sourcePath: string;
+    chunkIndex: number;
+    similarity: number;
+}
+/** Result of an ingest call. */
+export interface IngestResult {
+    tag: string;
+    files: number;
+    chunks: number;
+    skipped: Array<{
+        path: string;
+        reason: string;
+    }>;
+}
+/** Options shared by ingest/query. */
+export interface KnowledgeOptions {
+    chunkTokens?: number;
+    overlapTokens?: number;
+    topK?: number;
+    /**
+     * Embedding function override. Defaults to the local embedder. Injectable so
+     * callers (and tests) can supply a deterministic/dummy vectorizer without
+     * downloading the ~130 MB model.
+     */
+    embedFn?: (text: string) => Promise<number[]>;
+}
+/**
+ * Normalize a user-supplied tag into the sandboxed form. `Dheeraj_Health_report`
+ * → `dheeraj-health-report`. This is deliberately forgiving: a human naming a
+ * tag should not have to know the namespace rules, and a tag is not a path.
+ */
+export declare function normalizeKnowledgeTag(tag: string): string;
+/** True when a (already-normalized) tag is valid and non-empty. */
+export declare function isValidKnowledgeTag(tag: string): boolean;
+/** The VectorStore namespace for a tag. Assumes a normalized tag. */
+export declare function namespaceForTag(tag: string): string;
+/** Read the tag manifest. Never throws — a missing/corrupt file yields empty. */
+export declare function readKnowledgeManifest(): KnowledgeManifest;
+/** Every tag with its recorded documents/chunk counts (sorted by recency). */
+export declare function listKnowledgeTags(): KnowledgeTagEntry[];
+/** One tag's manifest entry, or null. */
+export declare function getKnowledgeTag(tag: string): KnowledgeTagEntry | null;
+/** Recursively collect files under a path (bounded, ignores build/vendor dirs). */
+export declare function collectKnowledgeFiles(root: string, out?: string[], depth?: number): string[];
+/**
+ * Ingest raw text under a tag. Idempotent per `<tag>:<sourcePath>#<i>` chunk id,
+ * so re-ingesting a changed document overwrites its chunks rather than
+ * duplicating them.
+ */
+export declare function ingestKnowledgeText(tag: string, sourcePath: string, text: string, opts?: KnowledgeOptions): Promise<number>;
+/**
+ * Ingest one or more files/directories under a tag. Extraction, chunking and
+ * embedding happen ONCE here; later questions only embed a short query.
+ */
+export declare function ingestKnowledge(tag: string, paths: string[], opts?: KnowledgeOptions): Promise<IngestResult>;
+/** Embed the question and return the tag's top-k chunks. Never throws. */
+export declare function queryKnowledge(tag: string, question: string, opts?: KnowledgeOptions): Promise<KnowledgeHit[]>;
+/** Remove a tag's vectors and manifest entry. Returns true when something was removed. */
+export declare function forgetKnowledgeTag(tag: string): Promise<boolean>;
+/**
+ * Render retrieved chunks as context that ATTRIBUTES each part to the user's
+ * data. The model can then answer the data half from here and the generic half
+ * from its own knowledge / `web-research`, and say which is which.
+ */
+export declare function formatKnowledgeContext(tag: string, hits: KnowledgeHit[]): string;
+export { DEFAULT_CHUNK_TOKENS, DEFAULT_OVERLAP_TOKENS };
+//# sourceMappingURL=knowledge-base.d.ts.map

package/dist/learning/knowledge-base.d.ts.map

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

package/dist/learning/knowledge-base.js

@@ -0,0 +1,337 @@
+/**
+ * KnowledgeBase — tag-scoped, vectorized retrieval over a user's own documents.
+ *
+ * WHY THIS EXISTS. The retrieval engine (`src/learning/retrieval.ts`) vectorizes
+ * a REPO for token reduction and keys everything by file path; the tagged memory
+ * store (`src/tools/memory-tools.ts`) holds FACTS, not whole documents. Neither
+ * answers "I brought my documents, gave them a tag, and I want precise answers
+ * scoped to that tag." So a user asking about their own data had exactly one
+ * path — re-read the file into context on EVERY turn, which costs the document's
+ * tokens repeatedly and is slow on large files.
+ *
+ * This module pays that cost ONCE. A document is extracted, chunked and embedded
+ * a single time under a tag; each later question embeds a short query and
+ * retrieves its top-k chunks. The tag is a real scope: each tag gets its own
+ * vector namespace (`knowledge-<tag>`), so tags never bleed into each other and
+ * a tag can be forgotten without touching anything else.
+ *
+ * The retrieved chunks are USER DATA; the model supplies the generic half of an
+ * answer (and `web-research` supplies the net-based half). `formatKnowledgeContext`
+ * labels each chunk with its source file so the model can attribute precisely
+ * which part of an answer came from the user's data.
+ *
+ * Storage: vectors in the existing pluggable VectorStore (one JSON/FAISS file
+ * per namespace), a small manifest at `<memory>/knowledge-index.json` for
+ * listing/removal. Everything lives in the Nuvira data dir (`~/.nuvira/memory`),
+ * never in a repository or package.
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs';
+import { join, extname, basename } from 'node:path';
+import { envBuff, resolveNuviraHome } from '../config/paths.js';
+import { embed, RETRIEVAL_MODEL } from '../memory/embedder.js';
+import { getVectorStore } from '../memory/vector-store.js';
+import { chunkText, DEFAULT_CHUNK_TOKENS, DEFAULT_OVERLAP_TOKENS } from './retrieval.js';
+import { logger } from '../utils/logger.js';
+// ─── Constants ──────────────────────────────────────────────────────────────
+/** A tag is a sandboxed namespace segment: lowercase alphanumerics + hyphens, with at least one alphanumeric. */
+export const KNOWLEDGE_TAG_RE = /^[a-z0-9-]*[a-z0-9][a-z0-9-]*$/;
+/** Namespace prefix — keeps knowledge vectors apart from memory/history/repo. */
+export const KNOWLEDGE_NAMESPACE_PREFIX = 'knowledge-';
+/** Manifest of tags → documents (listing/removal only; vectors live elsewhere). */
+export const KNOWLEDGE_MANIFEST_FILE = 'knowledge-index.json';
+/** Default chunks returned per query. */
+export const DEFAULT_KNOWLEDGE_TOP_K = 6;
+/** Directories never walked when a tag is pointed at a folder. */
+const IGNORE_DIRS = new Set([
+    'node_modules', '.git', 'dist', 'build', '.next', '.cache', '.venv', 'venv',
+    '__pycache__', '.turbo', '.nx', 'coverage', '.idea', '.vscode',
+]);
+/** Cap a directory walk so a stray `.` cannot index an entire disk. */
+const MAX_FILES_PER_INGEST = 500;
+/** Per-chunk text kept in metadata (matches retrieval.ts's budget). */
+const MAX_EXTRACT_CHARS = 2_000_000;
+// ─── Paths (resolved per call so tests that set NUVIRA_MEMORY_DIR are hermetic) ──
+function memoryDir() {
+    return envBuff('MEMORY_DIR') || join(resolveNuviraHome(), 'memory');
+}
+function manifestPath() {
+    return join(memoryDir(), KNOWLEDGE_MANIFEST_FILE);
+}
+// ─── Tag handling ───────────────────────────────────────────────────────────
+/**
+ * Normalize a user-supplied tag into the sandboxed form. `Dheeraj_Health_report`
+ * → `dheeraj-health-report`. This is deliberately forgiving: a human naming a
+ * tag should not have to know the namespace rules, and a tag is not a path.
+ */
+export function normalizeKnowledgeTag(tag) {
+    return tag
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .replace(/-{2,}/g, '-');
+}
+/** True when a (already-normalized) tag is valid and non-empty. */
+export function isValidKnowledgeTag(tag) {
+    return KNOWLEDGE_TAG_RE.test(tag);
+}
+/** The VectorStore namespace for a tag. Assumes a normalized tag. */
+export function namespaceForTag(tag) {
+    return `${KNOWLEDGE_NAMESPACE_PREFIX}${tag}`;
+}
+// ─── Manifest ───────────────────────────────────────────────────────────────
+function emptyManifest() {
+    return { version: 1, tags: {} };
+}
+/** Read the tag manifest. Never throws — a missing/corrupt file yields empty. */
+export function readKnowledgeManifest() {
+    try {
+        if (!existsSync(manifestPath()))
+            return emptyManifest();
+        const data = JSON.parse(readFileSync(manifestPath(), 'utf-8'));
+        if (!data || typeof data !== 'object' || typeof data.tags !== 'object')
+            return emptyManifest();
+        return { version: data.version ?? 1, tags: data.tags ?? {} };
+    }
+    catch {
+        return emptyManifest();
+    }
+}
+function writeKnowledgeManifest(manifest) {
+    try {
+        if (!existsSync(memoryDir()))
+            mkdirSync(memoryDir(), { recursive: true });
+        writeFileSync(manifestPath(), JSON.stringify(manifest, null, 2), 'utf-8');
+    }
+    catch {
+        // Best-effort — the vectors are the source of truth; the manifest is an index.
+    }
+}
+/** Every tag with its recorded documents/chunk counts (sorted by recency). */
+export function listKnowledgeTags() {
+    return Object.values(readKnowledgeManifest().tags).sort((a, b) => b.updatedAt - a.updatedAt);
+}
+/** One tag's manifest entry, or null. */
+export function getKnowledgeTag(tag) {
+    const normalized = normalizeKnowledgeTag(tag);
+    return readKnowledgeManifest().tags[normalized] ?? null;
+}
+// ─── File collection ────────────────────────────────────────────────────────
+/** Recursively collect files under a path (bounded, ignores build/vendor dirs). */
+export function collectKnowledgeFiles(root, out = [], depth = 0) {
+    if (out.length >= MAX_FILES_PER_INGEST || depth > 8)
+        return out;
+    let stat;
+    try {
+        stat = statSync(root);
+    }
+    catch {
+        return out;
+    }
+    if (stat.isFile()) {
+        out.push(root);
+        return out;
+    }
+    if (!stat.isDirectory())
+        return out;
+    let entries = [];
+    try {
+        entries = readdirSync(root);
+    }
+    catch {
+        return out;
+    }
+    for (const entry of entries) {
+        if (out.length >= MAX_FILES_PER_INGEST)
+            break;
+        if (IGNORE_DIRS.has(entry))
+            continue;
+        collectKnowledgeFiles(join(root, entry), out, depth + 1);
+    }
+    return out;
+}
+// ─── Text extraction ────────────────────────────────────────────────────────
+/**
+ * Extract a file's text, reusing the `read_extract` manager so PDF/DOCX/XLSX/
+ * PPTX and text formats all work (and unsupported ones refuse with a reason
+ * instead of silently indexing a container's bytes).
+ */
+async function extractFileText(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    // Plain text-ish formats need no heavy reader — read directly.
+    if (['.txt', '.md', '.markdown', '.csv', '.tsv', '.json', '.yaml', '.yml', '.log'].includes(ext)) {
+        try {
+            const text = readFileSync(filePath, 'utf-8');
+            return { ok: true, text: text.length > MAX_EXTRACT_CHARS ? text.slice(0, MAX_EXTRACT_CHARS) : text };
+        }
+        catch (err) {
+            return { ok: false, reason: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    try {
+        const { getReadExtractManager } = await import('../tools/read-extract.js');
+        const result = await getReadExtractManager().extract(filePath);
+        if (!result.success || !result.text) {
+            return { ok: false, reason: result.error ?? result.code ?? 'extraction failed' };
+        }
+        return { ok: true, text: result.text };
+    }
+    catch (err) {
+        return { ok: false, reason: err instanceof Error ? err.message : String(err) };
+    }
+}
+// ─── Ingest ─────────────────────────────────────────────────────────────────
+/**
+ * Ingest raw text under a tag. Idempotent per `<tag>:<sourcePath>#<i>` chunk id,
+ * so re-ingesting a changed document overwrites its chunks rather than
+ * duplicating them.
+ */
+export async function ingestKnowledgeText(tag, sourcePath, text, opts = {}) {
+    const normalized = normalizeKnowledgeTag(tag);
+    const chunkTokens = opts.chunkTokens ?? DEFAULT_CHUNK_TOKENS;
+    const overlapTokens = opts.overlapTokens ?? DEFAULT_OVERLAP_TOKENS;
+    const embedFn = opts.embedFn ?? ((t) => embed(t, undefined, false, RETRIEVAL_MODEL));
+    const label = `${normalized}:${sourcePath}`;
+    const chunks = chunkText(text, label, chunkTokens, overlapTokens);
+    const store = getVectorStore(namespaceForTag(normalized));
+    for (const chunk of chunks) {
+        let vector;
+        try {
+            vector = await embedFn(chunk.text);
+        }
+        catch {
+            // A failed embed leaves a zero vector (never outranks a real match).
+            vector = new Array(384).fill(0);
+        }
+        await store.insert(chunk.id, vector, {
+            kind: 'knowledge-chunk',
+            tag: normalized,
+            sourcePath,
+            chunkIndex: chunk.chunkIndex,
+            text: chunk.text,
+            tokenCount: chunk.tokenCount,
+        });
+    }
+    return chunks.length;
+}
+/**
+ * Ingest one or more files/directories under a tag. Extraction, chunking and
+ * embedding happen ONCE here; later questions only embed a short query.
+ */
+export async function ingestKnowledge(tag, paths, opts = {}) {
+    const normalized = normalizeKnowledgeTag(tag);
+    if (!isValidKnowledgeTag(normalized)) {
+        throw new Error(`Invalid knowledge tag '${tag}' — it must contain at least one letter or digit.`);
+    }
+    const result = { tag: normalized, files: 0, chunks: 0, skipped: [] };
+    const manifest = readKnowledgeManifest();
+    const entry = manifest.tags[normalized] ?? {
+        tag: normalized,
+        updatedAt: Date.now(),
+        chunkCount: 0,
+        documents: [],
+    };
+    // Flatten dirs → files, bounded.
+    const files = [];
+    for (const p of paths) {
+        if (existsSync(p)) {
+            collectKnowledgeFiles(p, files);
+        }
+        else {
+            result.skipped.push({ path: p, reason: 'not found' });
+        }
+    }
+    for (const file of files) {
+        const extracted = await extractFileText(file);
+        if (!extracted.ok) {
+            result.skipped.push({ path: file, reason: extracted.reason });
+            continue;
+        }
+        try {
+            const chunks = await ingestKnowledgeText(normalized, file, extracted.text, opts);
+            result.files += 1;
+            result.chunks += chunks;
+            // Re-ingesting a changed document replaces its chunks; keep the recorded
+            // count in step by subtracting the previous contribution first.
+            const previous = entry.documents.find((d) => d.path === file);
+            if (previous)
+                entry.chunkCount -= previous.chunks;
+            entry.documents = entry.documents.filter((d) => d.path !== file);
+            entry.documents.push({ path: file, chunks, addedAt: Date.now() });
+            entry.chunkCount += chunks;
+        }
+        catch (err) {
+            result.skipped.push({ path: file, reason: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    entry.updatedAt = Date.now();
+    manifest.tags[normalized] = entry;
+    writeKnowledgeManifest(manifest);
+    return result;
+}
+// ─── Query ──────────────────────────────────────────────────────────────────
+/** Embed the question and return the tag's top-k chunks. Never throws. */
+export async function queryKnowledge(tag, question, opts = {}) {
+    const normalized = normalizeKnowledgeTag(tag);
+    const topK = opts.topK ?? DEFAULT_KNOWLEDGE_TOP_K;
+    const embedFn = opts.embedFn ?? ((t) => embed(t, undefined, false, RETRIEVAL_MODEL));
+    try {
+        const queryVector = await embedFn(question);
+        const store = getVectorStore(namespaceForTag(normalized));
+        const results = await store.search(queryVector, topK, (entry) => {
+            return entry.metadata?.kind === 'knowledge-chunk' && entry.metadata?.tag === normalized;
+        });
+        return results.map(({ entry, similarity }) => ({
+            tag: normalized,
+            text: String(entry.metadata?.text ?? ''),
+            sourcePath: String(entry.metadata?.sourcePath ?? entry.id),
+            chunkIndex: Number(entry.metadata?.chunkIndex ?? 0),
+            similarity,
+        }));
+    }
+    catch (err) {
+        logger.debug(`Knowledge query failed for tag '${normalized}': ${err instanceof Error ? err.message : err}`);
+        return [];
+    }
+}
+// ─── Forget ─────────────────────────────────────────────────────────────────
+/** Remove a tag's vectors and manifest entry. Returns true when something was removed. */
+export async function forgetKnowledgeTag(tag) {
+    const normalized = normalizeKnowledgeTag(tag);
+    const manifest = readKnowledgeManifest();
+    const existed = Boolean(manifest.tags[normalized]);
+    delete manifest.tags[normalized];
+    writeKnowledgeManifest(manifest);
+    try {
+        await getVectorStore(namespaceForTag(normalized)).clear();
+    }
+    catch {
+        // Best-effort — the manifest entry is already gone.
+    }
+    return existed;
+}
+// ─── Formatting for the model ───────────────────────────────────────────────
+/**
+ * Render retrieved chunks as context that ATTRIBUTES each part to the user's
+ * data. The model can then answer the data half from here and the generic half
+ * from its own knowledge / `web-research`, and say which is which.
+ */
+export function formatKnowledgeContext(tag, hits) {
+    const normalized = normalizeKnowledgeTag(tag);
+    if (hits.length === 0) {
+        return `No entries found for knowledge tag '${normalized}'. Ingest documents first with the knowledge tool (action: add).`;
+    }
+    const parts = hits.map((h) => {
+        const name = basename(h.sourcePath);
+        return `--- [from your data: ${name} · chunk ${h.chunkIndex + 1} · sim ${h.similarity.toFixed(3)}] ---\n${h.text}`;
+    });
+    return [
+        `Knowledge tag: ${normalized} (${hits.length} relevant chunk${hits.length === 1 ? '' : 's'} from the user's own data)`,
+        'Treat the following as USER DATA — quote it for facts about the user. For general advice, combine it with your own knowledge and, when current guidance is needed, the web-research tool, and say which part is which.',
+        '',
+        ...parts,
+    ].join('\n');
+}
+// Re-export for tests/callers that want the raw embedding defaults.
+export { DEFAULT_CHUNK_TOKENS, DEFAULT_OVERLAP_TOKENS };
+//# sourceMappingURL=knowledge-base.js.map

package/dist/learning/knowledge-base.js.map

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

package/dist/learning/model-harness.d.ts

@@ -59,6 +59,25 @@ export declare function resolveModelHarnessProfile(input: ModelHarnessInput): Mo
  * Exported because more than one seam needs the same answer.
  */
 export declare function isTinyModel(model: string | undefined): boolean;
+/**
+ * May this served model hold an AGENTIC software task?
+ *
+ * The single predicate behind every agentic capability gate, so the router's
+ * ranking floor and its LATER model-first override can never disagree. That
+ * divergence was a live bug (2026-10-04): the floor correctly removed a
+ * ≤4B local model from the ranking, but the model-first override — which runs
+ * afterwards — re-introduced `local/gemma4:e4b` for a Tauri build ask, and chat
+ * then fabricated tool output.
+ *
+ * Deliberately conservative, exactly like the floor it serves:
+ *   - an UNKNOWN model (`undefined`) is KEPT — never eliminate on ignorance;
+ *   - a ≤4B tiny tag is always out;
+ *   - a LOCAL provider whose served id is a placeholder (`default`, `unknown`)
+ *     is out — we cannot judge local compute with no real tag, and it is the
+ *     case that carried the failed build. A local 70B (`llama3:70b`) keeps
+ *     working.
+ */
+export declare function isAgenticCapableModel(model: string | undefined, provider: string): boolean;
 /**
  * Should this model skip a native tool-calling attempt entirely?
  *

package/dist/learning/model-harness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-harness.d.ts","sourceRoot":"","sources":["../../src/learning/model-harness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,sCAAsC;AACtC,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC3B,wEAAwE;IACxE,SAAS,EAAE,gBAAgB,CAAC;IAC5B,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,cAAc,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAClC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAmCD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,iBAAiB,GAAG,mBAAmB,CAoCxF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAG9D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAEvE"}
+{"version":3,"file":"model-harness.d.ts","sourceRoot":"","sources":["../../src/learning/model-harness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,sCAAsC;AACtC,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC3B,wEAAwE;IACxE,SAAS,EAAE,gBAAgB,CAAC;IAC5B,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,cAAc,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAClC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAmCD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,iBAAiB,GAAG,mBAAmB,CAoCxF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAG9D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK1F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAEvE"}

package/dist/learning/model-harness.js

@@ -100,6 +100,33 @@ export function isTinyModel(model) {
     const tag = (model ?? '').trim();
     return TINY_MODEL.test(tag) || TINY_FAMILY.test(tag);
 }
+/**
+ * May this served model hold an AGENTIC software task?
+ *
+ * The single predicate behind every agentic capability gate, so the router's
+ * ranking floor and its LATER model-first override can never disagree. That
+ * divergence was a live bug (2026-10-04): the floor correctly removed a
+ * ≤4B local model from the ranking, but the model-first override — which runs
+ * afterwards — re-introduced `local/gemma4:e4b` for a Tauri build ask, and chat
+ * then fabricated tool output.
+ *
+ * Deliberately conservative, exactly like the floor it serves:
+ *   - an UNKNOWN model (`undefined`) is KEPT — never eliminate on ignorance;
+ *   - a ≤4B tiny tag is always out;
+ *   - a LOCAL provider whose served id is a placeholder (`default`, `unknown`)
+ *     is out — we cannot judge local compute with no real tag, and it is the
+ *     case that carried the failed build. A local 70B (`llama3:70b`) keeps
+ *     working.
+ */
+export function isAgenticCapableModel(model, provider) {
+    if (model === undefined)
+        return true;
+    if (isTinyModel(model))
+        return false;
+    if (provider === 'local' && /^(?:default|unknown)$/i.test(String(model).trim()))
+        return false;
+    return true;
+}
 /**
  * Should this model skip a native tool-calling attempt entirely?
  *

package/dist/learning/model-harness.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-harness.js","sourceRoot":"","sources":["../../src/learning/model-harness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA6BH;;;;;GAKG;AACH,MAAM,UAAU,GAAG,uCAAuC,CAAC;AAE3D,sEAAsE;AACtE,gFAAgF;AAChF,6EAA6E;AAC7E,sEAAsE;AACtE,MAAM,WAAW,GAAG,6CAA6C,CAAC;AAElE;;;;GAIG;AACH,MAAM,oBAAoB,GACxB,8MAA8M,CAAC;AAEjN;;;;GAIG;AACH,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAExC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAChC,qFAAqF;AACrF,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAwB;IACjE,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,IAAI,QAAQ,CAAC;IACxD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,cAAc,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,cAAc,IAAI,CAAC,MAAM,CAAC;IAEzC,wEAAwE;IACxE,4EAA4E;IAC5E,MAAM,SAAS,GAAqB,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IAE/D,IAAI,QAAQ,GAAqB,QAAQ,CAAC;IAC1C,IAAI,MAAc,CAAC;IAEnB,IAAI,MAAM,EAAE,CAAC;QACX,QAAQ,GAAG,QAAQ,CAAC;QACpB,MAAM,GAAG,eAAe,KAAK,IAAI,SAAS,wBAAwB,SAAS,YAAY,CAAC;IAC1F,CAAC;SAAM,IAAI,cAAc,KAAK,KAAK,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC;QACnC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,IAAI,wBAAwB,EAAE,CAAC;YAC/D,QAAQ,GAAG,KAAK,CAAC;YACjB,MAAM,GAAG,uCAAuC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,UAAU,MAAM,OAAO,wBAAwB,EAAE,EAAE,CAAC;QACnJ,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,QAAQ,CAAC;YACpB,MAAM,GAAG,8CAA8C,MAAM,MAAM,wBAAwB,yCAAyC,CAAC;QACvI,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,oBAAoB,cAAc,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,SAAS,iDAAiD,EAAE,CAAC;IAClI,CAAC;IAED,OAAO;QACL,QAAQ;QACR,SAAS;QACT,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,qBAAqB;QACtE,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAyB;IACnD,MAAM,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAwB;IAC5D,OAAO,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"model-harness.js","sourceRoot":"","sources":["../../src/learning/model-harness.ts"],"names":[],"mappings":"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"}

package/dist/learning/model-selection.d.ts

@@ -54,7 +54,8 @@ export declare function hasCredentials(configManager: ConfigManager, provider: s
 export declare const MODEL_HEALTH_CEILING = 0.6;
 /**
  * Verified working models for a provider, ranked by learned health:
- * lowest error rate first, then lowest latency, then most recently verified.
+ * strongest verification source first, then lowest error rate, then lowest
+ * latency, then most recently verified.
  * Empty when nothing has been verified yet (cold start / no keys).
  *
  * MODELS AT/ABOVE `MODEL_HEALTH_CEILING` SORT AFTER THE HEALTHY ONES but are

package/dist/learning/model-selection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-selection.d.ts","sourceRoot":"","sources":["../../src/learning/model-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAU1D,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,qEAAsE,CAAC;AAErG;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,CAAC;AAMnE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAA6B,CAAC;AAEpE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOtF;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAuC7D;AAcD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,aAAa,GAAG,cAAc,EAAE,CAiErF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM,CAE3E;AAED,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,iBAAiB,EAC1B,aAAa,CAAC,EAAE,aAAa,GAC5B;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CA0BjD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxG;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAS1F;AAED,qFAAqF;AACrF,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM,CAa5E"}
+{"version":3,"file":"model-selection.d.ts","sourceRoot":"","sources":["../../src/learning/model-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAU1D,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,qEAAsE,CAAC;AAErG;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,CAAC;AAMnE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAA6B,CAAC;AAEpE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOtF;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAqBxC;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CA6C7D;AAcD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,aAAa,GAAG,cAAc,EAAE,CAuErF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM,CAE3E;AAED,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,iBAAiB,EAC1B,aAAa,CAAC,EAAE,aAAa,GAC5B;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CA0BjD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxG;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAS1F;AAED,qFAAqF;AACrF,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM,CAa5E"}