agent-nuvira 3.3.13 → 3.3.14

package/dist/cli/hooks.js

@@ -0,0 +1,224 @@
+/**
+ * HooksCommand — `nuvira hooks` — the declarative lifecycle hooks, from the CLI.
+ *
+ * A hook here is a RULE, not code: it binds to one of nuvira's four lifecycle
+ * seams (`before_tool_call`, `after_tool_call`, `failed_tool_call`,
+ * `on_session_end`) and its only possible actions are `deny`, `notify` and
+ * `scan-args` — a fixed, native allow-list. Installing one can therefore never
+ * execute third-party code. See `docs/HOOKS.md` and
+ * `src/gateway/hook-contract.ts`.
+ *
+ * This is the CLI face of the same `<config-dir>/hooks.json` the dashboard's
+ * Hooks page edits, and the same contract the runtime reads live. Both surfaces
+ * share `hook-contract.ts`, so the vocabulary cannot drift.
+ *
+ * Subcommands:
+ *   nuvira hooks list                       — built-in + user hooks, with state
+ *   nuvira hooks add --id … --label … …     — declare a hook
+ *   nuvira hooks remove <id>                — remove a user hook
+ *   nuvira hooks enable <id>                — turn a hook on (also a built-in)
+ *   nuvira hooks disable <id>               — turn a hook off
+ *
+ * The built-in starter set (block `rm -rf`, catch secrets in writes/commands)
+ * ships DISABLED; `enable` on a built-in materializes it into the file.
+ */
+import { Command } from 'commander';
+import { BaseCommand } from './commands.js';
+import { logger } from '../utils/logger.js';
+import { HOOK_ACTION_KINDS, HOOK_EVENTS, builtinHookById, hookDeclarationsFile, listHookDeclarations, readHookDeclarations, setHookDeclarations, } from '../gateway/hook-contract.js';
+/** Repeatable `--arg key=glob` collector. */
+function collectArg(value, previous) {
+    previous.push(value);
+    return previous;
+}
+/** `key=glob` lines → the `argsMatch` record. Blank / malformed entries drop. */
+function parseArgsMatch(values) {
+    const out = {};
+    for (const raw of values) {
+        const eq = raw.indexOf('=');
+        if (eq <= 0)
+            continue;
+        const key = raw.slice(0, eq).trim();
+        const glob = raw.slice(eq + 1).trim();
+        if (key && glob)
+            out[key] = glob;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+/** A one-line, human summary of what a declaration matches and does. */
+function describeHook(hook) {
+    const when = hook.when ?? {};
+    const parts = [];
+    if (when.tool)
+        parts.push(`tool ${when.tool}`);
+    if (when.surface)
+        parts.push(`surface ${when.surface}`);
+    if (when.cwdPrefix)
+        parts.push(`cwd ${when.cwdPrefix}*`);
+    if (when.argsMatch)
+        for (const [k, v] of Object.entries(when.argsMatch))
+            parts.push(`${k}=${v}`);
+    const target = parts.length > 0 ? parts.join(' · ') : 'every call';
+    switch (hook.action.kind) {
+        case 'deny':
+            return `${target} → deny${hook.action.reason ? `: ${hook.action.reason}` : ''}`;
+        case 'notify':
+            return `${target} → notify: ${hook.action.message}`;
+        case 'scan-args':
+            return `${target} → scan args for secrets${hook.action.denyOnHit ? ' (deny on hit)' : ''}`;
+    }
+}
+export class HooksCommand extends BaseCommand {
+    create() {
+        const cmd = new Command('hooks')
+            .description('Declarative lifecycle hooks — list/add/remove the rules that deny, notify or secret-scan tool calls (the same hooks.json the dashboard Hooks page edits; a hook is data, never code)')
+            .option('-v, --verbose', 'verbose output');
+        cmd
+            .command('list')
+            .description('List built-in and user hooks with their seam, action and state')
+            .action(() => {
+            const all = listHookDeclarations();
+            logger.highlight('\n🪝 Hooks');
+            if (all.length === 0) {
+                logger.info('   No hooks declared.');
+                console.log('');
+                return;
+            }
+            for (const hook of all) {
+                const state = hook.enabled ? '✅ enabled ' : '⭕ disabled';
+                const source = hook.source === 'builtin' ? 'builtin' : 'user';
+                console.log(`   ${state}  ${hook.id} [${source}] (${hook.event})`);
+                console.log(`        ${hook.label}`);
+                console.log(`        ${describeHook(hook)}`);
+            }
+            console.log('');
+            logger.info(`   File: ${hookDeclarationsFile()}`);
+            console.log('');
+        });
+        cmd
+            .command('add')
+            .description('Declare a new hook (it is enabled unless --disabled is given)')
+            .requiredOption('--id <id>', 'unique id: lowercase letters, digits and hyphens')
+            .requiredOption('--label <label>', 'human label')
+            .requiredOption('--event <event>', `seam: ${HOOK_EVENTS.join(' | ')}`)
+            .requiredOption('--action <kind>', `action: ${HOOK_ACTION_KINDS.join(' | ')}`)
+            .option('--tool <glob>', 'tool-name glob to match (e.g. run_terminal, run_*)')
+            .option('--surface <glob>', 'surface glob to match (e.g. cli-chat)')
+            .option('--cwd <prefix>', 'only match calls whose cwd starts with this prefix')
+            .option('--arg <key=glob>', 'shallow arg matcher, repeatable (e.g. --arg "command=*rm -rf*")', collectArg, [])
+            .option('--reason <text>', 'reason shown when a deny (or deny-on-hit) blocks the call')
+            .option('--message <text>', 'notify message ({tool} / {surface} / {event} interpolated)')
+            .option('--deny-on-hit', 'scan-args: block the call when a secret shape is found')
+            .option('--disabled', 'add it switched off (the dashboard adds them on by default)')
+            .action((opts) => {
+            const id = String(opts.id ?? '');
+            const label = String(opts.label ?? '');
+            const event = String(opts.event ?? '');
+            const kind = String(opts.action ?? '');
+            if (!HOOK_EVENTS.includes(event)) {
+                logger.error(`Unknown --event '${event}'. Choose one of: ${HOOK_EVENTS.join(', ')}`);
+                return;
+            }
+            if (!HOOK_ACTION_KINDS.includes(kind)) {
+                logger.error(`Unknown --action '${kind}'. Choose one of: ${HOOK_ACTION_KINDS.join(', ')}`);
+                return;
+            }
+            const when = {
+                ...(typeof opts.tool === 'string' && opts.tool ? { tool: opts.tool } : {}),
+                ...(typeof opts.surface === 'string' && opts.surface ? { surface: opts.surface } : {}),
+                ...(typeof opts.cwd === 'string' && opts.cwd ? { cwdPrefix: opts.cwd } : {}),
+                ...(parseArgsMatch(opts.arg ?? []) ? { argsMatch: parseArgsMatch(opts.arg ?? []) } : {}),
+            };
+            const reason = typeof opts.reason === 'string' && opts.reason ? opts.reason : undefined;
+            const message = typeof opts.message === 'string' && opts.message ? opts.message : undefined;
+            const action = kind === 'deny'
+                ? { kind: 'deny', ...(reason ? { reason } : {}) }
+                : kind === 'notify'
+                    ? { kind: 'notify', message: message ?? 'hook fired: {tool}' }
+                    : { kind: 'scan-args', denyOnHit: Boolean(opts.denyOnHit), ...(reason ? { reason } : {}) };
+            const declaration = {
+                id,
+                label,
+                event,
+                enabled: !opts.disabled,
+                ...(Object.keys(when).length > 0 ? { when } : {}),
+                action,
+                source: 'user',
+                updatedAt: Date.now(),
+            };
+            const user = readHookDeclarations();
+            if (user.some((h) => h.id === id)) {
+                logger.error(`A hook with id '${id}' already exists. Remove it, or use 'enable'/'disable'.`);
+                console.log('');
+                return;
+            }
+            const saved = setHookDeclarations([...user, declaration]);
+            if (!saved.ok) {
+                logger.error(`Rejected: ${saved.error}`);
+                console.log('');
+                return;
+            }
+            logger.success(`➕ Added hook '${id}' (${declaration.enabled ? 'enabled' : 'disabled'}).`);
+            logger.info(`   In force on the next tool call. Inspect it: nuvira hooks list`);
+            console.log('');
+        });
+        cmd
+            .command('remove <id>')
+            .description('Remove a user hook (a built-in cannot be deleted — disable it instead)')
+            .action((id) => {
+            const user = readHookDeclarations();
+            if (!user.some((h) => h.id === id)) {
+                if (builtinHookById(id)) {
+                    logger.warn(`'${id}' is a built-in default and cannot be removed. Turn it off with: nuvira hooks disable ${id}`);
+                }
+                else {
+                    logger.warn(`No user hook '${id}'.`);
+                }
+                console.log('');
+                return;
+            }
+            const isBuiltin = Boolean(builtinHookById(id));
+            const saved = setHookDeclarations(user.filter((h) => h.id !== id));
+            if (!saved.ok) {
+                logger.error(saved.error);
+                console.log('');
+                return;
+            }
+            logger.success(isBuiltin
+                ? `↺ Reset built-in '${id}' to its default (disabled).`
+                : `🗑️  Removed hook '${id}'.`);
+            console.log('');
+        });
+        const setEnabled = (enabled) => (id) => {
+            const user = readHookDeclarations();
+            const existing = user.find((h) => h.id === id);
+            let next;
+            if (existing) {
+                next = user.map((h) => (h.id === id ? { ...h, enabled, updatedAt: Date.now() } : h));
+            }
+            else {
+                const builtin = builtinHookById(id);
+                if (!builtin) {
+                    logger.warn(`No hook '${id}'. Declare it first: nuvira hooks add --id ${id} …`);
+                    console.log('');
+                    return;
+                }
+                // Enabling a built-in materializes it into the file so the runtime —
+                // which follows the user set — actually sees it.
+                next = [...user, { ...builtin, enabled, updatedAt: Date.now() }];
+            }
+            const saved = setHookDeclarations(next);
+            if (!saved.ok) {
+                logger.error(saved.error);
+                console.log('');
+                return;
+            }
+            logger.success(`${enabled ? '✅ Enabled' : '⭕ Disabled'} '${id}'.`);
+            console.log('');
+        };
+        cmd.command('enable <id>').description('Turn a hook on (works on a built-in too)').action(setEnabled(true));
+        cmd.command('disable <id>').description('Turn a hook off').action(setEnabled(false));
+        return cmd;
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/cli/hooks.js.map

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

package/dist/cli/knowledge.d.ts

@@ -10,10 +10,18 @@
  *
  * Subcommands:
  *   nuvira knowledge add <tag> <path...>      — ingest files/folders under a tag
+ *   nuvira knowledge sync <tag> <path...>     — re-sync folders (hash-gated; prunes vanished files)
  *   nuvira knowledge query <tag> "<question>" — retrieve the tag's relevant passages
+ *   nuvira knowledge toc <tag> [doc]          — documents and their headings
+ *   nuvira knowledge read <tag> <doc>         — one document or section, VERBATIM
+ *   nuvira knowledge remove <tag> <doc>       — remove one document from a tag
  *   nuvira knowledge list                     — list tags, documents and chunk counts
  *   nuvira knowledge stats <tag>              — details for one tag
- *   nuvira knowledge forget <tag>             — remove a tag's vectors
+ *   nuvira knowledge forget <tag>             — remove a tag's vectors and stored text
+ *
+ * `query` answers "where is it mentioned"; `read` answers "what does it say".
+ * They are different jobs — a spec-driven build needs a section verbatim, not
+ * the six most similar paragraphs of it.
  */
 import { Command } from 'commander';
 import { BaseCommand } from './commands.js';

package/dist/cli/knowledge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/cli/knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAY5C,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,MAAM,IAAI,OAAO;CA6GlB"}
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/cli/knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAiB5C,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,MAAM,IAAI,OAAO;CAiMlB"}

package/dist/cli/knowledge.js

@@ -10,10 +10,18 @@
  *
  * Subcommands:
  *   nuvira knowledge add <tag> <path...>      — ingest files/folders under a tag
+ *   nuvira knowledge sync <tag> <path...>     — re-sync folders (hash-gated; prunes vanished files)
  *   nuvira knowledge query <tag> "<question>" — retrieve the tag's relevant passages
+ *   nuvira knowledge toc <tag> [doc]          — documents and their headings
+ *   nuvira knowledge read <tag> <doc>         — one document or section, VERBATIM
+ *   nuvira knowledge remove <tag> <doc>       — remove one document from a tag
  *   nuvira knowledge list                     — list tags, documents and chunk counts
  *   nuvira knowledge stats <tag>              — details for one tag
- *   nuvira knowledge forget <tag>             — remove a tag's vectors
+ *   nuvira knowledge forget <tag>             — remove a tag's vectors and stored text
+ *
+ * `query` answers "where is it mentioned"; `read` answers "what does it say".
+ * They are different jobs — a spec-driven build needs a section verbatim, not
+ * the six most similar paragraphs of it.
  */
 import { Command } from 'commander';
 import { basename } from 'node:path';
@@ -21,7 +29,7 @@ import { existsSync } from 'node:fs';
 import { BaseCommand } from './commands.js';
 import { logger } from '../utils/logger.js';
 import { formatCount } from '../utils/format.js';
-import { ingestKnowledge, queryKnowledge, listKnowledgeTags, getKnowledgeTag, forgetKnowledgeTag, normalizeKnowledgeTag, } from '../learning/knowledge-base.js';
+import { ingestKnowledge, queryKnowledge, listKnowledgeTags, getKnowledgeTag, forgetKnowledgeTag, normalizeKnowledgeTag, listKnowledgeSections, readKnowledgeDocument, removeKnowledgeDocument, syncKnowledgeTag, MAX_READ_CHARS, } from '../learning/knowledge-base.js';
 export class KnowledgeCommand extends BaseCommand {
     create() {
         const cmd = new Command('knowledge')
@@ -42,6 +50,9 @@ export class KnowledgeCommand extends BaseCommand {
             try {
                 const result = await ingestKnowledge(tag, paths);
                 logger.success(`   Ingested ${result.files} document(s) / ${result.chunks} chunk(s) under '${result.tag}'.`);
+                if (result.unchanged > 0) {
+                    logger.info(`   ${result.unchanged} document(s) unchanged — not re-embedded (use 'sync' to prune removed files).`);
+                }
                 for (const s of result.skipped) {
                     logger.warn(`   Skipped ${basename(s.path)}: ${s.reason}`);
                 }
@@ -75,6 +86,86 @@ export class KnowledgeCommand extends BaseCommand {
             logger.info('The data part of an answer comes from these passages; the general part from the model / web-research.');
             console.log('');
         });
+        cmd
+            .command('toc <tag> [doc]')
+            .description("List a tag's documents and the headings in each")
+            .action(async (tag, doc) => {
+            const docs = listKnowledgeSections(tag, doc);
+            if (docs.length === 0) {
+                logger.warn(`No documents under '${normalizeKnowledgeTag(tag)}'. Add some: nuvira knowledge add <tag> <files...>`);
+                console.log('');
+                return;
+            }
+            logger.highlight(`\n📚 ${normalizeKnowledgeTag(tag)}`);
+            for (const d of docs) {
+                console.log(`   📄 ${d.title} (${d.chunks} chunk${d.chunks === 1 ? '' : 's'}) — ${d.path}`);
+                if (d.sections.length === 0) {
+                    console.log('       (no headings — read the whole document)');
+                    continue;
+                }
+                for (const s of d.sections) {
+                    console.log(`       ${'  '.repeat(Math.max(0, s.level - 1))}§ ${s.headingPath ? `${s.headingPath} > ` : ''}${s.title}`);
+                }
+            }
+            console.log('');
+            logger.info("Read one verbatim: nuvira knowledge read <tag> <doc> --section \"<heading>\"");
+            console.log('');
+        });
+        cmd
+            .command('read <tag> <doc>')
+            .description('Print a document, or one named section, VERBATIM (not a summary)')
+            .option('-s, --section <heading>', 'section heading to read (default: the whole document)')
+            .action(async (tag, doc, opts) => {
+            const read = readKnowledgeDocument(tag, doc, opts.section);
+            if (!read.ok) {
+                logger.warn(read.reason);
+                console.log('');
+                return;
+            }
+            logger.highlight(`\n📖 ${read.path}${read.headingPath ? ` — §${read.headingPath}` : ''}`);
+            console.log('');
+            console.log(read.text);
+            if (read.truncated) {
+                console.log('');
+                logger.warn(`   [truncated at ${MAX_READ_CHARS} characters — read a section instead]`);
+            }
+            console.log('');
+        });
+        cmd
+            .command('remove <tag> <doc>')
+            .description('Remove ONE document from a tag (its chunks, stored text and manifest row)')
+            .action(async (tag, doc) => {
+            const removed = await removeKnowledgeDocument(tag, doc);
+            if (removed)
+                logger.success(`🗑️  Removed '${doc}' from '${normalizeKnowledgeTag(tag)}'.`);
+            else
+                logger.warn(`No document '${doc}' under '${normalizeKnowledgeTag(tag)}'.`);
+            console.log('');
+        });
+        cmd
+            .command('sync <tag> <paths...>')
+            .description("Bring a tag up to date with its folders — hash-gated, prunes files that vanished")
+            .action(async (tag, paths) => {
+            const missing = paths.filter((p) => !existsSync(p));
+            if (missing.length > 0) {
+                logger.error(`Path not found: ${missing.join(', ')}`);
+                return;
+            }
+            const normalized = normalizeKnowledgeTag(tag);
+            logger.info(`🔄 Syncing '${normalized}' from ${paths.length} path(s) ...`);
+            try {
+                const result = await syncKnowledgeTag(tag, paths);
+                logger.success(`   ${result.added} added, ${result.changed} changed, ${result.unchanged} unchanged, ${result.chunks} chunk(s) written.`);
+                for (const p of result.removed)
+                    logger.warn(`   Removed ${basename(p)}: no longer present under a synced path.`);
+                for (const s of result.skipped)
+                    logger.warn(`   Skipped ${basename(s.path)}: ${s.reason}`);
+            }
+            catch (err) {
+                logger.error(`Failed to sync: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            console.log('');
+        });
         cmd
             .command('list')
             .description('List knowledge tags with document and chunk counts')

package/dist/cli/knowledge.js.map

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

package/dist/cli/loop-executor.d.ts.map

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

package/dist/cli/loop-executor.js

@@ -45,6 +45,13 @@ import { noteServedRoute } from '../tools/loop-route-feed.js';
 import { getAutoRouter, isAutoProvider, governanceVerdict, adminBudgetVerdict } from '../learning/auto-router.js';
 import { buildDeepFailoverPool, createFailoverExclusionFilter } from '../learning/resilient-call.js';
 import { recordActionFailure } from '../learning/failure-bookkeeping.js';
+// P1/P2 (fix_model_routing) — the shared definition of "this response carries
+// nothing usable". An empty completion is a FAILURE, not an answer, and must
+// advance the candidate walk instead of being returned to the caller.
+import { assertUsableModelResponse, isUnusableModelResponseError } from '../learning/response-usability.js';
+// P6 (fix_model_routing) — the bandit is told about step-level failures too, so
+// an arm that answers with nothing stops being sampled back up.
+import { getRouterBandit } from '../learning/router-bandit.js';
 import { recordRegistrySuccess, getProviderFallback, classifyFallbackError, isRetryableError, } from '../learning/provider-fallback.js';
 import { resolveThreadBudgetChars } from '../learning/context-budget.js';
 import { buildLoopProjectContext } from '../tools/loop-project-context.js';
@@ -533,29 +540,35 @@ export async function runLoopExecutor(goal, configManager, opts = {}) {
         }
     }
     // ── Skill hint (chat/execute parity) ────────────────────────────────────
-    // MODE-DEPENDENT (see resolveSkillHintMode): `match` (default) injects ONE
-    // keyword-matched skill only when the goal really matches; `catalog`
-    // (opt-in — ~24K chars) hands the model the full list to choose from; `off`
-    // injects nothing. Best-effort: a failure returns '' and the prompt is
-    // unchanged.
+    // MODE-DEPENDENT (see resolveSkillHintMode): `pointer` (default) injects a
+    // bounded discovery pointer (the MODEL picks a skill via the skill tool /
+    // capability search — the harness no longer keyword-matches); `catalog`
+    // (opt-in — ~24K chars) hands the model the full list; `off` injects nothing.
+    // Best-effort: a failure returns '' and the prompt is unchanged.
     let skillHint = '';
     if (!opts.skipSkillHint) {
         try {
-            const { buildConfiguredSkillHint, markLoopSkillUsed } = await import('../tools/loop-skill-hint.js');
-            const injected = {
-                value: null,
-            };
-            skillHint = await buildConfiguredSkillHint(goal, configManager, injected);
-            await markLoopSkillUsed(injected.value);
+            const { buildConfiguredSkillHint } = await import('../tools/loop-skill-hint.js');
+            skillHint = await buildConfiguredSkillHint(configManager);
         }
         catch {
             skillHint = ''; // best-effort — never breaks the turn
         }
     }
+    // Machine facts — the host stated once (OS / arch / shell / installed package
+    // managers). One detection per process; best-effort (a failure injects nothing).
+    let machineBlock = '';
+    try {
+        const { buildMachineFactsBlock } = await import('../learning/machine-facts.js');
+        machineBlock = buildMachineFactsBlock();
+    }
+    catch {
+        machineBlock = '';
+    }
     const { runToolLoop } = await import('../tools/tool-loop.js');
     const { getTool, TOOL_CONTRACT_JSON } = await import('../tools/registry.js');
     const head = [
-        { role: 'system', content: buildExecuteLoopSystemPrompt(TOOL_CONTRACT_JSON) + skillHint },
+        { role: 'system', content: buildExecuteLoopSystemPrompt(TOOL_CONTRACT_JSON) + machineBlock + skillHint },
         ...(projectContext ? [{ role: 'user', content: `[Project context]\n${projectContext}` }] : []),
     ];
     let thread = [...head, { role: 'user', content: goal }];
@@ -723,6 +736,16 @@ export async function runLoopExecutor(goal, configManager, opts = {}) {
                 // it several steps earlier.
                 servedRoute = noteServedRoute(servedRoute, servedRouteFrom(route));
                 const resp = await tryOnce(prov, mdl, nextMessages, schemas, abort);
+                // ── P1/P2 — AN UNUSABLE RESPONSE IS A FAILURE, NOT AN ANSWER ─────
+                // A provider that resolves HTTP 200 with neither answer text nor a tool
+                // call used to be returned from here as the step's response: the walk
+                // only reacts to THROWN errors, so the SAME model was re-asked and the
+                // turn eventually ended as "bounded" with zero work done while healthy
+                // models sat configured and unused. Validating here turns that into what
+                // it is — a candidate-level failure — so the catch below books it
+                // (`empty-response`: the pair rests, its siblings stay routable) and the
+                // walk continues to a DIFFERENT model IN THIS SAME STEP.
+                assertUsableModelResponse(resp);
                 // ── ANSWER-QUALITY GATE ──────────────────────────────────────────
                 // A reply that is the model's own REASONING, or its narration of the
                 // tool contract, is not a deliverable — and it never THROWS, so this
@@ -791,6 +814,18 @@ export async function runLoopExecutor(goal, configManager, opts = {}) {
                     catch {
                         // Best-effort — bookkeeping must never mask the generation error.
                     }
+                    // P6 — an empty completion is NEGATIVE evidence for the arm itself, at
+                    // a granularity the task-level reward can never reach: the turn does
+                    // not fail, it just moves on, so without this the prior kept sampling
+                    // the same dead model back to the top of the ranking.
+                    if (isUnusableModelResponseError(err)) {
+                        try {
+                            getRouterBandit().penalizeModel(cand.model !== 'default' ? cand.model : model);
+                        }
+                        catch {
+                            // Best-effort — learning must never mask the generation error.
+                        }
+                    }
                     // ── PINNED-RUN GATE ──────────────────────────────────────────────
                     // Leaving a provider the user EXPLICITLY asked for is only justified
                     // by a failure another provider can plausibly answer — the same