agent-nuvira 2.6.14 → 2.7.0

package/dist/tools/loop-skill-hint.js

@@ -0,0 +1,266 @@
+/**
+ * Loop skill hint (`src/tools/loop-skill-hint.ts`) — AGENTIC_CAPABILITY_ASSESSMENT
+ * Addendum v4 Phase 3.2: "The loop never hears about the orchestrator's skill
+ * layer: the pipeline consults SkillStore.findMatch + the hub catalog before
+ * planning and injects the matched methodology, but a chat/execute-loop goal
+ * starts with zero knowledge that a first-party playbook exists."
+ *
+ * This module closes that parity gap DETERMINISTICALLY (no LLM call): given
+ * the user's goal, it finds the best available skill the SAME way the
+ * orchestrator does —
+ *
+ *   1. compiled SkillStore.findMatch (the first-party capability batch),
+ *   2. the hub catalog (findHubSkillMatch — installed SKILL.md skills),
+ *
+ * then returns a system-prompt block that hands the model the skill's
+ * methodology with an EXPLICIT escape hatch ("this is a recommendation —
+ * ignore it when it does not fit") and the exact load syntax
+ * (`skill` tool, {"skill":"<name>"}).
+ *
+ * Why an evidence filter on top of findMatch: the compiled store's threshold
+ * is intentionally low (score >= 1, "manual discovery") and its scoring adds
+ * a quality/usage bonus to EVERY skill — so a goal merely containing a generic
+ * pattern word ("goal", "task") can false-positive. The chat loop runs on
+ * EVERY message (not just pipeline goals), so the loop hint requires REAL
+ * goal evidence: a name-word or tag hit, or two pattern-word hits. The
+ * orchestrator does not need this (its planner only sees pipeline goals); the
+ * hub catalog's own scoring is keyword-based and needs no filter.
+ *
+ * Safety rails (mirroring the orchestrator's injection contract):
+ *   - skills.disabled[] gate — a dashboard/CLI-disabled skill is NEVER
+ *     injected (the same "the toggle is never cosmetic" rule the match gates
+ *     enforce elsewhere).
+ *   - Website-deploy activation gate — the orchestrator requires
+ *     hosting-specific intent before injecting website methodology; the loop
+ *     hint applies the identical regex so "deploy the API" does not drag in
+ *     static-site deployment steps.
+ *   - Side-effect-free matching: the match itself marks nothing; usage is
+ *     marked ONCE via markLoopSkillUsed by the caller (skillView()'s internal
+ *     markUsed is deliberately avoided so the hint builder is idempotent).
+ *   - Bounded injection: at most ONE methodology block per prompt, and the
+ *     methodology text itself is capped (compiled: 8 steps; hub: 2000 chars)
+ *     so a crowded catalog cannot balloon the system prompt.
+ *   - Best-effort by construction: any store/catalog failure returns '' /
+ *     null and the turn proceeds exactly as before (a hint must never break
+ *     a turn).
+ *
+ * Consumers: chat's runChatAnswer (system prompt) and the execute loop's
+ * runLoopExecutor — the two runToolLoop callers that had no skill knowledge.
+ */
+/**
+ * Website-deploy activation gate — IDENTICAL to the orchestrator's
+ * (src/agents/orchestrator.ts §3c): a website-deployment skill (bundled OR
+ * hub-installed) is only injected when the goal carries hosting-specific
+ * intent. A generic "deploy the API" goal does NOT get website methodology.
+ */
+const WEBSITE_DEPLOY_ID = /website[-_ ]?deploy/i;
+const HOSTING_INTENT = /cloudflare|netlify|vercel|github\s*pages|hosting|pages\.dev|web\s*site|website|static\s*site|landing\s*page/i;
+/**
+ * Meta-words that appear in generic goalPatterns but carry NO goal evidence
+ * ("compile a plan for this goal"). Excluded from pattern-word matching so a
+ * goal containing only meta-vocabulary can never match a skill.
+ */
+const PATTERN_STOPWORDS = new Set([
+    'goal', 'goals', 'task', 'tasks', 'skill', 'skills', 'step', 'steps',
+    'plan', 'plans', 'planning', 'when', 'with', 'this', 'that', 'from',
+    'into', 'user', 'users', 'want', 'wants', 'need', 'needs', 'request',
+    'requests', 'help', 'make', 'using', 'used', 'work', 'works', 'some',
+    'onto', 'over', 'your', 'their', 'them', 'then', 'also', 'each',
+]);
+/** Cap on hub SKILL.md body text injected into the prompt (chars). */
+const HUB_BODY_CAP = 2000;
+/** Cap on compiled methodology steps injected into the prompt. */
+const COMPILED_STEP_CAP = 8;
+/** Cap on any single description line (chars). */
+const LINE_CAP = 400;
+/** The skills.disabled[] gate: a disabled skill is never injected. */
+function isDisabled(id, cm) {
+    try {
+        const cfg = cm?.getAll?.();
+        const disabled = cfg?.skills?.disabled;
+        return Array.isArray(disabled) && disabled.includes(id);
+    }
+    catch {
+        return false; // config failure must not block matching (the injection is advisory)
+    }
+}
+/**
+ * Did the goal show REAL evidence for this skill — a name-word hit, a tag
+ * hit, or two pattern-word hits (meta-words excluded)? Guards the compiled
+ * store's intentionally loose threshold: findMatch adds a quality/usage bonus
+ * to every skill, so a generic word like "goal" alone must never inject
+ * methodology into a chat turn. Deterministic, no LLM.
+ */
+export function hasRealGoalEvidence(goal, skill) {
+    const q = goal.toLowerCase();
+    if (!q)
+        return false;
+    let nameHits = 0;
+    for (const word of skill.name.toLowerCase().split(/[^a-z0-9]+/)) {
+        if (word.length > 3 && q.includes(word))
+            nameHits++;
+    }
+    let tagHits = 0;
+    for (const tag of skill.tags) {
+        const t = tag.toLowerCase().trim();
+        if (t.length > 3 && q.includes(t))
+            tagHits++;
+    }
+    let patternHits = 0;
+    for (const word of skill.goalPattern.toLowerCase().split(/\s+/)) {
+        const w = word.trim();
+        if (w.length > 3 && !PATTERN_STOPWORDS.has(w) && q.includes(w))
+            patternHits++;
+    }
+    return nameHits >= 1 || tagHits >= 1 || patternHits >= 2;
+}
+/**
+ * Find the best skill for the goal across BOTH sources the orchestrator
+ * consults, honoring the disabled + website-deploy activation gates (+ the
+ * compiled evidence filter). Compiled wins ties (its id is the deterministic
+ * seed id). Returns null when nothing matches (never a forced match).
+ */
+export async function findLoopSkillMatch(goal, cm) {
+    const q = (goal || '').trim();
+    if (!q)
+        return null;
+    // 1. Compiled store (the first-party capability batch).
+    try {
+        const { getSkillStore } = await import('../learning/skill-store.js');
+        const match = getSkillStore().findMatch(q);
+        if (match && !isDisabled(match.id, cm) && hasRealGoalEvidence(q, match)) {
+            // Activation gate: website-deploy methodology needs hosting intent.
+            if (!(WEBSITE_DEPLOY_ID.test(match.id) || WEBSITE_DEPLOY_ID.test(match.name)) || HOSTING_INTENT.test(q)) {
+                return { name: match.name, id: match.id, source: 'compiled' };
+            }
+        }
+    }
+    catch {
+        // Fall through to the hub catalog — a store failure must not block it.
+    }
+    // 2. Hub catalog (installed SKILL.md skills — first-class runtime
+    //    capabilities; a fresh `nuvira skills install` is matchable with zero
+    //    recompilation, exactly like the orchestrator's fallback path). Its
+    //    scoring is pure keyword evidence (score >= 1), no filter needed.
+    try {
+        const { findHubSkillMatch } = await import('../learning/hub-skill-catalog.js');
+        const hub = findHubSkillMatch(q, cm);
+        if (hub && !isDisabled(hub.id, cm)) {
+            if (!(WEBSITE_DEPLOY_ID.test(hub.id) || WEBSITE_DEPLOY_ID.test(hub.name)) || HOSTING_INTENT.test(q)) {
+                return { name: hub.name, id: hub.id, source: 'hub' };
+            }
+        }
+    }
+    catch {
+        // Best-effort — a catalog failure leaves no hint.
+    }
+    return null;
+}
+/**
+ * Bounded, side-effect-free methodology text for a compiled skill (the full
+ * Skill shape is fetched via the public get(); step descriptions carry the
+ * Level-2 methodology). Deliberately NOT store.skillView() — that marks the
+ * skill used as a side effect and renders reference-doc/quality sections the
+ * prompt block does not need.
+ */
+function formatCompiledMethodology(skill) {
+    const lines = [];
+    if (skill.description)
+        lines.push(cap(skill.description));
+    if (skill.parameters.length > 0) {
+        lines.push('Parameters: ' +
+            skill.parameters
+                .map((p) => `${p.name}${p.required ? '' : ' (optional)'}`)
+                .join(', '));
+    }
+    const steps = skill.steps.slice(0, COMPILED_STEP_CAP);
+    steps.forEach((s, i) => {
+        lines.push(`Step ${i + 1} [${s.agentType}]: ${cap(s.description)}`);
+    });
+    if (skill.steps.length > steps.length) {
+        lines.push(`(+${skill.steps.length - steps.length} more steps — load the skill for the full methodology)`);
+    }
+    return lines.join('\n');
+}
+function cap(text, max = LINE_CAP) {
+    const t = text.trim();
+    return t.length > max ? t.slice(0, max - 1) + '…' : t;
+}
+/**
+ * Build the system-prompt block for a matched skill, or '' when there is no
+ * match. The block follows the orchestrator's injection contract:
+ *
+ *   - the skill is a RECOMMENDATION, the model still owns the plan (the
+ *     orchestrator's "model-selected activation" phrasing),
+ *   - the methodology rides in as Level-2 content (progressive disclosure —
+ *     the model sees the steps without paying a tool call for them),
+ *   - the exact load syntax is included so the model can refresh/parameterize
+ *     via the `skill` tool mid-turn,
+ *   - ONE block max (bounded system-prompt growth).
+ *
+ * Marks nothing: usage tracking belongs to markLoopSkillUsed (the caller
+ * decides when a match actually got USED — i.e. was injected).
+ *
+ * @param goal       the user's goal text (matched against skill triggers)
+ * @param cm         ConfigManager for the disabled-skills gate (optional)
+ * @param injected   out-param: when provided, receives the match that was
+ *                   injected (null when none).
+ */
+export async function buildLoopSkillHint(goal, cm, injected) {
+    const match = await findLoopSkillMatch(goal, cm).catch(() => null);
+    if (injected)
+        injected.value = match;
+    if (!match)
+        return '';
+    // Full methodology (Level 2). Compiled: the stored Skill (steps carry the
+    // methodology). Hub: the SKILL.md body.
+    let methodology = '';
+    if (match.source === 'hub') {
+        try {
+            const { findHubSkillMatch } = await import('../learning/hub-skill-catalog.js');
+            methodology = cap(findHubSkillMatch(goal, cm)?.body ?? '', HUB_BODY_CAP);
+        }
+        catch {
+            methodology = '';
+        }
+    }
+    else {
+        try {
+            const { getSkillStore } = await import('../learning/skill-store.js');
+            methodology = formatCompiledMethodology(getSkillStore().get(match.id));
+        }
+        catch {
+            methodology = '';
+        }
+    }
+    const lines = [
+        '',
+        '## Matched skill',
+        `A first-party skill matches this goal: **${match.name}** (${match.source} skill, id ${match.id}).`,
+        'This is a RECOMMENDATION — follow it when it fits the request; ignore it when it does not (you still own the plan).',
+    ];
+    if (methodology) {
+        lines.push('', 'Its methodology:', '', methodology);
+    }
+    lines.push('', `To (re)load it with parameters mid-turn, call the skill tool with {"skill":"${match.name}"}.`);
+    return lines.join('\n');
+}
+/**
+ * Mark an injected skill as used (usage tracking parity with the orchestrator
+ * — compiled skills only; hub skills have no compiled usage counter). The
+ * SINGLE usage marker for the loop hint path (the hint builder never marks).
+ * Best-effort, fire-and-forget: never throws, never awaited by callers on the
+ * hot path.
+ */
+export async function markLoopSkillUsed(match) {
+    if (!match || match.source !== 'compiled')
+        return;
+    try {
+        const { getSkillStore } = await import('../learning/skill-store.js');
+        getSkillStore().markUsed(match.id);
+    }
+    catch {
+        // Best-effort.
+    }
+}
+//# sourceMappingURL=loop-skill-hint.js.map

package/dist/tools/loop-skill-hint.js.map

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

package/dist/tools/registry.d.ts

@@ -122,6 +122,16 @@ export interface ToolContext {
      * throws).
      */
     planStore?: import('./plan-store.js').PlanStoreLike;
+    /**
+     * Tiered tool exposure (AGENTIC_CAPABILITY_ASSESSMENT Addendum v3/v4):
+     * when the loop runs in 'tiered' mode, tools outside the CORE set are
+     * hidden from the model's schema until loaded. A `tool_search` load action
+     * writes the loaded toolset names here; the tool loop reads this AFTER
+     * each tool execution and unions the loaded toolsets' tool schemas into
+     * the live set before the next model step. Optional — absent contexts
+     * (tests, non-tiered callers) simply never extend the schema set.
+     */
+    loadedExtraTools?: Set<string>;
 }
 /** A clarify-style choice. */
 export interface AskUserChoice {

package/dist/tools/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,EAAE,CAAC,EAAgB,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAKpD,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,CAAC;AAElE,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,IAAI;IACnB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,2EAA2E;IAC3E,WAAW,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB,qEAAqE;IACrE,GAAG,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3D;AAED,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,aAAa,EAAE,GAAG,CAAC;IACnB,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,4CAA4C;IAC5C,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,WAAW,EAAE,OAAO,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACvG,kEAAkE;IAClE,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,oBAAoB,EAAE,SAAS,CAAC;IACjD;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,qBAAqB,EAAE,YAAY,CAAC;IACvD;;;;;;OAMG;IACH,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACrD,SAAS,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE;YAAE,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;YAAC,IAAI,EAAE,UAAU,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/J,sFAAsF;QACtF,MAAM,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QACjD;;2EAEmE;QACnE,gBAAgB,CAAC,CAAC,KAAK,EAAE;YAAE,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;YAAC,IAAI,EAAE,UAAU,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACtJ,SAAS,EAAE;YAAE,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG;gBAAE,QAAQ,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,CAAA;aAAE,GAAG,IAAI,CAAA;SAAE,CAAC;KACxF,CAAC;IACF;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,iBAAiB,EAAE,aAAa,CAAC;CACrD;AAED,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC1C;AAyED,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB;;;;;;;;;iBAK5B,CAAC;AAKH,iGAAiG;AACjG,eAAO,MAAM,iBAAiB;;;;;iBAc5B,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,YAAY;;;iBAUvB,CAAC;AAEH,+DAA+D;AAC/D,eAAO,MAAM,aAAa;;;;;;;;;;;iBAMxB,CAAC;AAEH,yEAAyE;AACzE,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AAEH,kFAAkF;AAClF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;iBAgB1B,CAAC;AAEH,8EAA8E;AAC9E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;iBAczB,CAAC;AAkHH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;iBAejC,CAAC;AAMH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAE7C;AAED,8BAA8B;AAC9B,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAEtD;AAED,gFAAgF;AAChF,wBAAgB,SAAS,IAAI,IAAI,EAAE,CAElC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CAOtE;AAID;;;;;GAKG;AACH,eAAO,MAAM,aAAa,0iHAgB8R,CAAC;AAEzT,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,kyHAK2C,CAAC;AAgf3E;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAqBvE"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"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"}

package/dist/tools/registry.js

@@ -1598,24 +1598,81 @@ registerTool({
     }),
 });
 // ─── Batch 5: Infrastructure ──────────────────────────────────────────────
-// Tool search tool
+// Tool search tool — the tiered-exposure discovery surface. Two actions:
+// - search (default): fuzzy-find tools by query (the pre-existing behavior).
+// - load: LOAD a whole toolset's tools into the CURRENT turn's model schema
+//   (tiered exposure — assessment Addendum v3/v4). Writes the toolset's tool
+//   names into ctx.loadedExtraTools; the tool loop unions them into the live
+//   schema set before the next model step. Domain tools (media, browser,
+//   channels, docker, …) stay out of every turn's schema until this runs —
+//   ~85% of per-turn schema tokens saved, zero capability lost.
 registerTool({
     name: 'tool_search',
-    description: 'Search tools by query with fuzzy matching.',
+    description: 'Discover and load tools. Actions: "search" fuzzy-finds tools by query; ' +
+        '"load" activates a whole toolset (media, browser, channels, docker, ' +
+        'productivity, publish, core-pipeline, …) for THIS turn — call it before ' +
+        'using any tool outside the always-available core set. "load" returns ' +
+        'the toolset\'s tool names, which become callable immediately.',
     category: 'workflow',
     inputSchema: z.object({
-        query: z.string().describe('Search query'),
-        limit: z.number().optional().describe('Max results'),
+        action: z.enum(['search', 'load']).optional().describe('Defaults to "search".'),
+        query: z.string().optional().describe('Search query (action=search)'),
+        limit: z.number().optional().describe('Max results (action=search)'),
+        toolset: z.string().optional().describe('Toolset name to load (action=load) — e.g. "media", "browser", "channels"'),
     }),
     endsAgentStep: false,
-    run: (args) => import('./infra-tools.js').then((m) => {
-        const { query, limit } = args;
+    run: async (args, ctx) => {
+        const { action = 'search', query, limit, toolset } = args;
+        // ── load: activate a toolset for this turn (tiered exposure) ──
+        if (action === 'load') {
+            if (!toolset) {
+                // No toolset named — return the CATALOG so the model can pick one.
+                // All enabled toolsets are listed; loading one whose tools are
+                // already core-exposed is a harmless idempotent union.
+                const { getToolsetStatus } = await import('./toolsets.js');
+                const status = getToolsetStatus(ctx?.configManager)
+                    .filter((s) => s.enabled)
+                    .map((s) => ({ name: s.name, label: s.label, tools: s.tools }));
+                return JSON.stringify({
+                    loaded: false,
+                    message: 'No toolset named. Loadable toolsets (call again with action:"load", toolset:<name>):',
+                    toolsets: status,
+                });
+            }
+            const { TOOLSETS, isToolEnabled } = await import('./toolsets.js');
+            const def = TOOLSETS.find((t) => t.name === toolset);
+            if (!def) {
+                const names = TOOLSETS.map((t) => t.name).join(', ');
+                return `Error: unknown toolset "${toolset}". Available: ${names}.`;
+            }
+            // A user-disabled toolset must not resurrect through the load path —
+            // the I1 enablement gate stays the single source of truth.
+            if (!isToolEnabled(def.tools[0], ctx?.configManager)) {
+                return `Error: toolset "${toolset}" is disabled by configuration — enable it with \`nuvira tools toolsets\` first.`;
+            }
+            const already = ctx?.loadedExtraTools instanceof Set ? ctx.loadedExtraTools : undefined;
+            if (already) {
+                for (const name of def.tools)
+                    already.add(name);
+            }
+            return JSON.stringify({
+                loaded: true,
+                toolset: def.name,
+                label: def.label,
+                tools: def.tools,
+                note: already
+                    ? 'Tools are now callable this turn.'
+                    : 'Toolset recorded, but this context has no live schema loader (loop not in tiered mode) — tools remain governed by the standard enablement gate.',
+            });
+        }
+        // ── search: the pre-existing fuzzy find (unchanged behavior) ──
+        const m = await import('./infra-tools.js');
         const engine = m.getToolSearchEngine();
         // Index from registry
-        const { listTools } = require('./registry.js');
+        const { listTools } = await import('./registry.js');
         engine.index(listTools().map((t) => ({ name: t.name, description: t.description })));
-        return JSON.stringify(engine.search(query, limit || 10));
-    }),
+        return JSON.stringify(engine.search(query || '', limit || 10));
+    },
 });
 // Budget config tool
 registerTool({