@namzu/sdk 0.6.0 → 1.1.0

package/dist/registry/tool/execute.js

@@ -4,6 +4,37 @@ import { GENAI, NAMZU, toolSpanName } from '../../telemetry/attributes.js';
 import { getTracer } from '../../telemetry/runtime-accessors.js';
 import { toErrorMessage } from '../../utils/error.js';
 import { ManagedRegistry } from '../ManagedRegistry.js';
+// Tokens too generic to identify a tool by name — ignored when matching a
+// batched `search_tools` query so they can't activate the whole catalog
+// (every bridged tool name shares the `clawtool` prefix, for instance).
+// Generic CRUD verbs are stopped too: a query like "list deals" must rank
+// by "deals", not token-match every `list_*` tool in the deferred catalog.
+const SEARCH_STOP_TOKENS = new Set([
+    'clawtool',
+    'tool',
+    'tools',
+    'mcp',
+    'the',
+    'and',
+    'for',
+    'use',
+    'list',
+    'read',
+    'create',
+    'update',
+    'get',
+    'find',
+    'delete',
+    'search',
+]);
+// Weighted-scoring weights mirroring ToolCatalog.searchTools (the richer,
+// otherwise-unused catalog scorer): exact name 12, name substring 8,
+// description 5 — extended here with argument-name indexing (3), following
+// Anthropic's tool-search practice of searching argument names too.
+const SEARCH_WEIGHT_NAME_EXACT = 12;
+const SEARCH_WEIGHT_NAME_PARTIAL = 8;
+const SEARCH_WEIGHT_DESCRIPTION = 5;
+const SEARCH_WEIGHT_ARGUMENT = 3;
 export class ToolRegistry extends ManagedRegistry {
     availability = new Map();
     tierConfig;
@@ -80,9 +111,59 @@ export class ToolRegistry extends ManagedRegistry {
     getAvailability(name) {
         return this.availability.get(name) ?? 'active';
     }
+    /**
+     * Ranked lexical search over DEFERRED tools, score-descending (ties broken
+     * by name) so callers can cap activation at a top-k. Each meaningful query
+     * term (≥3 chars, not a stop token) is scored against the tool name
+     * (exact/substring), description, and argument names; only tools with a
+     * positive score are returned. Description matching is safe here precisely
+     * because the result is RANKED — the `search_tools` builtin activates only
+     * the top slice, so a shared word can no longer drag in the whole catalog.
+     *
+     * PARKED (phase 5 of the tool-loading plan): an embedding-backed semantic
+     * upgrade was evaluated and deliberately NOT built — at ≤~35 deferred
+     * in-house tools with distinct names, weighted lexical scoring sits inside
+     * the literature's safe zone, and a weak retriever underperforms no
+     * retriever at all. Revisit only when (a) the deferred catalog grows past
+     * ~75-100 tools (realistic driver: connector-MCP growth), or (b) telemetry
+     * shows a search_tools miss-rate above ~10%. Sticky activation is also
+     * deliberate: activating inserts the schema into the tools array at its
+     * registry position (a one-time prompt-cache prefix bust); re-defer/TTL
+     * would churn that prefix repeatedly and is rejected.
+     */
     searchDeferred(query) {
-        const q = query.toLowerCase();
-        return this.getByAvailability(['deferred']).filter((t) => t.name.toLowerCase().includes(q) || t.description.toLowerCase().includes(q));
+        const q = query.toLowerCase().trim();
+        if (q.length === 0)
+            return [];
+        const terms = q.split(/\s+/).filter((tok) => tok.length >= 3 && !SEARCH_STOP_TOKENS.has(tok));
+        if (terms.length === 0)
+            return [];
+        const scored = [];
+        for (const tool of this.getByAvailability(['deferred'])) {
+            const name = tool.name.toLowerCase();
+            const description = tool.description.toLowerCase();
+            const argumentNames = listArgumentNames(tool);
+            let score = 0;
+            for (const term of terms) {
+                if (name === term) {
+                    score += SEARCH_WEIGHT_NAME_EXACT;
+                }
+                else if (name.includes(term)) {
+                    score += SEARCH_WEIGHT_NAME_PARTIAL;
+                }
+                if (description.includes(term)) {
+                    score += SEARCH_WEIGHT_DESCRIPTION;
+                }
+                if (argumentNames.some((arg) => arg.includes(term))) {
+                    score += SEARCH_WEIGHT_ARGUMENT;
+                }
+            }
+            if (score > 0) {
+                scored.push({ tool, score });
+            }
+        }
+        scored.sort((a, b) => b.score - a.score || a.tool.name.localeCompare(b.tool.name));
+        return scored.map((entry) => entry.tool);
     }
     assignTiers(mapping) {
         for (const [toolName, tierId] of Object.entries(mapping)) {
@@ -108,17 +189,35 @@ export class ToolRegistry extends ManagedRegistry {
         const active = this.getByAvailability(['active'], toolNames);
         const deferred = this.getByAvailability(['deferred'], toolNames);
         const parts = [];
+        const contractNote = `<tool_runtime_contract>
+Executable tool names, descriptions, and JSON input schemas are attached through the runtime tools parameter. Treat that runtime schema as authoritative; this prompt section is a discoverability summary only.
+</tool_runtime_contract>`;
         if (active.length > 0) {
-            const entries = active.map((t) => `- ${t.name}: ${t.description}`).join('\n');
+            // Name-only: every active tool's full description + JSON schema
+            // already rides the runtime tools parameter on each request —
+            // repeating descriptions here double-bills the same tokens.
+            const entries = active.map((t) => `- ${t.name}`).join('\n');
             parts.push(`<available_tools>\n${entries}\n</available_tools>`);
         }
         if (deferred.length > 0) {
-            const entries = deferred.map((t) => `- ${t.name}`).join('\n');
-            parts.push(`<deferred_tools>\nUse search_tools to load these before use:\n${entries}\n</deferred_tools>`);
+            // Name + one-line hint: deferred schemas stay off the wire, so the
+            // hint is the model's only signal of what a deferred tool does. A
+            // bare name list caused a real discovery failure in production
+            // (the agent never found read_document behind search_tools).
+            const entries = deferred
+                .map((t) => {
+                const hint = toolDiscoveryHint(t.description);
+                return hint.length > 0 ? `- ${t.name}: ${hint}` : `- ${t.name}`;
+            })
+                .join('\n');
+            const deferredIntro = this.has('search_tools') && this.getAvailability('search_tools') === 'active'
+                ? 'Use search_tools to load these before use:'
+                : 'Deferred tools are discoverable but not executable until the runtime activates them:';
+            parts.push(`<deferred_tools>\n${deferredIntro}\n${entries}\n</deferred_tools>`);
         }
         if (parts.length === 0)
             return '';
-        return parts.join('\n\n');
+        return [contractNote, ...parts].join('\n\n');
     }
     toLLMTools(toolNames) {
         const toolsToConvert = this.getByAvailability(['active', 'suspended'], toolNames);
@@ -195,8 +294,29 @@ export class ToolRegistry extends ManagedRegistry {
                 const errorMessage = parseResult.error.issues
                     .map((i) => `${i.path.join('.')}: ${i.message}`)
                     .join('; ');
+                // Distinguish "model sent an empty/no-arg call" from
+                // "model sent partial args" — the first is most often a
+                // streaming hiccup or a definition-test ping (Anthropic
+                // occasionally pings tool surfaces with `{}` while the
+                // schema is still loading), the second is a genuine
+                // programming mistake by the model. The model self-
+                // corrects MUCH more reliably when the error tells it
+                // (a) which fields are required, (b) their types, and
+                // (c) a minimal example call. Without these hints the
+                // downstream UI just shows a red "Failed" row and the
+                // model rarely retries with the right args.
+                const isEmptyInput = rawInput === null ||
+                    rawInput === undefined ||
+                    (typeof rawInput === 'object' &&
+                        !Array.isArray(rawInput) &&
+                        Object.keys(rawInput).length === 0);
+                const requiredHint = describeRequiredInput(tool.inputSchema);
+                const enrichedMessage = isEmptyInput
+                    ? `Tool "${toolName}" was called with no arguments. ${requiredHint} Retry the call with the required parameters populated.`
+                    : `Validation failed for "${toolName}": ${errorMessage}. ${requiredHint}`;
                 this.log.error(`Tool input validation failed: ${toolName}`, {
                     errors: errorMessage,
+                    empty: isEmptyInput,
                 });
                 span.setAttributes({
                     [NAMZU.TOOL_SUCCESS]: false,
@@ -207,7 +327,7 @@ export class ToolRegistry extends ManagedRegistry {
                 return {
                     success: false,
                     output: '',
-                    error: `Invalid input for tool "${toolName}": ${errorMessage}`,
+                    error: enrichedMessage,
                 };
             }
             const finalInput = parseResult.data;
@@ -254,4 +374,69 @@ export class ToolRegistry extends ManagedRegistry {
         return candidates.filter((t) => states.includes(this.getAvailability(t.name)));
     }
 }
+/**
+ * One-line discoverability hint for a deferred tool: the first sentence of
+ * its description, capped at ~100 chars. Used for the `<deferred_tools>`
+ * prompt listing and for `search_tools` near-miss suggestions, where the
+ * full description would re-import the token weight deferral avoids.
+ */
+export function toolDiscoveryHint(description, maxLength = 100) {
+    const normalized = description.trim().replace(/\s+/g, ' ');
+    if (normalized.length === 0)
+        return '';
+    const sentenceMatch = normalized.match(/^.*?[.!?](?=\s|$)/);
+    const sentence = sentenceMatch ? sentenceMatch[0] : normalized;
+    if (sentence.length <= maxLength)
+        return sentence;
+    return `${sentence.slice(0, maxLength - 1).trimEnd()}…`;
+}
+/**
+ * Lower-cased argument (property) names of a tool's input schema, used by
+ * `searchDeferred` ranking. Walks the JSON-Schema rendering (already a
+ * registration dependency) instead of Zod internals; opaque schemas simply
+ * contribute no argument matches.
+ */
+function listArgumentNames(tool) {
+    try {
+        const json = zodToJsonSchema(tool.inputSchema, {
+            target: 'jsonSchema7',
+            $refStrategy: 'none',
+        });
+        return Object.keys(json.properties ?? {}).map((key) => key.toLowerCase());
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Build a one-sentence "Required: <field>: <type>, <field>: <type>"
+ * hint from a Zod schema, used to enrich tool-input validation
+ * errors so the model can self-correct without round-tripping the
+ * full JSON schema again. Walks the schema's JSON-Schema rendering
+ * (already a dependency for tool registration) so we don't have to
+ * branch over Zod's internal type tree.
+ *
+ * Returns a fallback string for opaque/non-object schemas — the
+ * caller still ships the raw Zod issues separately, so the hint
+ * here is bonus context, not the only signal.
+ */
+function describeRequiredInput(schema) {
+    try {
+        const json = zodToJsonSchema(schema);
+        const required = json.required ?? [];
+        if (required.length === 0)
+            return 'No required parameters known.';
+        const props = json.properties ?? {};
+        const lines = required.map((name) => {
+            const def = props[name] ?? {};
+            const type = def.type ?? 'value';
+            const desc = def.description ? ` — ${def.description}` : '';
+            return `${name}: ${type}${desc}`;
+        });
+        return `Required: ${lines.join(', ')}.`;
+    }
+    catch {
+        return 'Could not introspect required parameters.';
+    }
+}
 //# sourceMappingURL=execute.js.map

package/dist/registry/tool/execute.js.map

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

package/dist/registry/tool/execute.test.d.ts

@@ -20,16 +20,21 @@
  *     reports true iff at least one tool is suspended.
  *   - `getAvailability(name)` returns 'active' as a default even for
  *     unknown names (this is non-obvious but is the current behavior).
- *   - `searchDeferred(q)` is a case-insensitive filter against name OR
- *     description of every DEFERRED tool.
+ *   - `searchDeferred(q)` is a RANKED weighted search over DEFERRED tools:
+ *     per meaningful term (≥3 chars, not a stop token) the score is
+ *     exact-name 12 / name-substring 8 / description 5 / argument-name 3;
+ *     results sort score-descending with name ties broken alphabetically.
+ *     Generic/short tokens (`clawtool`, `tool`, CRUD verbs like `list`,
+ *     `read`, …) are stopped so they can't over-activate the catalog.
  *   - `assignTiers(mapping)` mutates `tool.tier` on existing tools;
  *     throws via `getOrThrow` on unknown name; throws if the tier id
  *     is not in `tierConfig.tiers`.
  *   - `toTierGuidance` returns null without a guidanceTemplate; calls
  *     the template with every defined tier otherwise.
  *   - `toPromptSection`: returns '' when no active or deferred tools;
- *     otherwise produces `<available_tools>` + `<deferred_tools>`
- *     fragments.
+ *     otherwise produces `<available_tools>` (name-only — descriptions
+ *     already ride the runtime tools param) + `<deferred_tools>` (name +
+ *     first-sentence hint ≤100 chars) fragments.
  *   - `toLLMTools`: converts active + suspended tools (filtered by
  *     `toolNames` if provided) into LLM tool schemas via
  *     `zodToJsonSchema`. When `tierConfig.labelInDescription` is true,

package/dist/registry/tool/execute.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.test.d.ts","sourceRoot":"","sources":["../../../src/registry/tool/execute.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG"}
+{"version":3,"file":"execute.test.d.ts","sourceRoot":"","sources":["../../../src/registry/tool/execute.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG"}

package/dist/registry/tool/execute.test.js

@@ -20,16 +20,21 @@
  *     reports true iff at least one tool is suspended.
  *   - `getAvailability(name)` returns 'active' as a default even for
  *     unknown names (this is non-obvious but is the current behavior).
- *   - `searchDeferred(q)` is a case-insensitive filter against name OR
- *     description of every DEFERRED tool.
+ *   - `searchDeferred(q)` is a RANKED weighted search over DEFERRED tools:
+ *     per meaningful term (≥3 chars, not a stop token) the score is
+ *     exact-name 12 / name-substring 8 / description 5 / argument-name 3;
+ *     results sort score-descending with name ties broken alphabetically.
+ *     Generic/short tokens (`clawtool`, `tool`, CRUD verbs like `list`,
+ *     `read`, …) are stopped so they can't over-activate the catalog.
  *   - `assignTiers(mapping)` mutates `tool.tier` on existing tools;
  *     throws via `getOrThrow` on unknown name; throws if the tier id
  *     is not in `tierConfig.tiers`.
  *   - `toTierGuidance` returns null without a guidanceTemplate; calls
  *     the template with every defined tier otherwise.
  *   - `toPromptSection`: returns '' when no active or deferred tools;
- *     otherwise produces `<available_tools>` + `<deferred_tools>`
- *     fragments.
+ *     otherwise produces `<available_tools>` (name-only — descriptions
+ *     already ride the runtime tools param) + `<deferred_tools>` (name +
+ *     first-sentence hint ≤100 chars) fragments.
  *   - `toLLMTools`: converts active + suspended tools (filtered by
  *     `toolNames` if provided) into LLM tool schemas via
  *     `zodToJsonSchema`. When `tierConfig.labelInDescription` is true,
@@ -74,6 +79,14 @@ describe('ToolRegistry — register + availability', () => {
         expect(r.getAvailability('a')).toBe('deferred');
         expect(r.getAvailability('b')).toBe('deferred');
     });
+    it('register overloads: array w/o state defaults active, (id, tool) form, bad id throws', () => {
+        const r = new ToolRegistry();
+        r.register([makeTool('arr')]);
+        expect(r.getAvailability('arr')).toBe('active');
+        r.register('byid', makeTool('byid'));
+        expect(r.get('byid')).toBeDefined();
+        expect(() => r.register('oops', 'not-a-tool')).toThrow(/requires a ToolDefinition/);
+    });
     it('getAvailability returns active for unknown names (current default)', () => {
         const r = new ToolRegistry();
         expect(r.getAvailability('never-registered')).toBe('active');
@@ -158,6 +171,68 @@ describe('ToolRegistry — searchDeferred', () => {
         expect(r.searchDeferred('does').map((t) => t.name)).toEqual(['alpha', 'beta']);
         expect(r.searchDeferred('gamma')).toEqual([]);
     });
+    it('tokenizes a multi-term query so a batch of tool names each match', () => {
+        const r = new ToolRegistry();
+        r.register([makeTool('clawtool_A2aCard')], 'deferred');
+        r.register([makeTool('clawtool_PeerRegister')], 'deferred');
+        r.register([makeTool('clawtool_PeerList')], 'deferred');
+        r.register([makeTool('clawtool_Unrelated')], 'deferred');
+        // A whole-phrase substring match would find none of these. Equal
+        // scores tie-break alphabetically by name (deterministic ranking).
+        expect(r.searchDeferred('A2aCard PeerRegister PeerList').map((t) => t.name)).toEqual([
+            'clawtool_A2aCard',
+            'clawtool_PeerList',
+            'clawtool_PeerRegister',
+        ]);
+        expect(r.searchDeferred('   ')).toEqual([]);
+    });
+    it('ranks exact name above name substring above description-only matches', () => {
+        const r = new ToolRegistry();
+        r.register([makeTool('release_notes', { description: 'Write deploy notes.' })], 'deferred');
+        r.register([makeTool('deploy_preview', { description: 'Stage a preview build.' })], 'deferred');
+        r.register([makeTool('deploy', { description: 'Ship the current build.' })], 'deferred');
+        expect(r.searchDeferred('deploy').map((t) => t.name)).toEqual([
+            'deploy', // exact name → 12
+            'deploy_preview', // name substring → 8
+            'release_notes', // description only → 5
+        ]);
+    });
+    it('indexes argument names so a parameter term can locate a tool', () => {
+        const r = new ToolRegistry();
+        r.register([
+            makeTool('send_invoice', {
+                inputSchema: z.object({ customerEmail: z.string(), amount: z.number() }),
+            }),
+        ], 'deferred');
+        r.register([makeTool('send_reminder')], 'deferred');
+        expect(r.searchDeferred('customerEmail').map((t) => t.name)).toEqual(['send_invoice']);
+    });
+    it('stops generic CRUD verbs so they cannot activate catalog slices', () => {
+        const r = new ToolRegistry();
+        r.register([makeTool('list_deals', { description: 'List the deals in an account.' })], 'deferred');
+        r.register([makeTool('list_workflows', { description: 'List workflows.' })], 'deferred');
+        r.register([makeTool('read_document', { description: 'Read a document body.' })], 'deferred');
+        // Bare CRUD verbs identify nothing.
+        expect(r.searchDeferred('list')).toEqual([]);
+        expect(r.searchDeferred('read')).toEqual([]);
+        expect(r.searchDeferred('create update delete')).toEqual([]);
+        // The non-generic remainder carries the query.
+        expect(r.searchDeferred('list deals').map((t) => t.name)).toEqual(['list_deals']);
+        expect(r.searchDeferred('read document').map((t) => t.name)).toEqual(['read_document']);
+    });
+    it('does not over-activate on generic/shared tokens', () => {
+        const r = new ToolRegistry();
+        r.register([makeTool('clawtool_A2aCard', { description: 'peer card' })], 'deferred');
+        r.register([makeTool('clawtool_PeerList', { description: 'list peers' })], 'deferred');
+        r.register([makeTool('clawtool_WebSearch', { description: 'search the web' })], 'deferred');
+        // The shared "clawtool" prefix token must not drag in every tool.
+        expect(r.searchDeferred('clawtool WebSearch').map((t) => t.name)).toEqual([
+            'clawtool_WebSearch',
+        ]);
+        // A bare generic token identifies nothing — must not activate the catalog.
+        expect(r.searchDeferred('clawtool')).toEqual([]);
+        expect(r.searchDeferred('tool')).toEqual([]);
+    });
 });
 describe('ToolRegistry — tier mutation + guidance', () => {
     const tierConfig = {
@@ -198,10 +273,44 @@ describe('ToolRegistry — toPromptSection + toLLMTools', () => {
         r.register(makeTool('a'));
         r.register([makeTool('b')], 'deferred');
         const s = r.toPromptSection();
+        expect(s).toContain('<tool_runtime_contract>');
+        expect(s).toContain('runtime tools parameter');
         expect(s).toContain('<available_tools>');
-        expect(s).toContain('- a: a tool');
+        // Active entries are NAME-ONLY: the description already rides the
+        // runtime tools param every request — repeating it double-bills.
+        expect(s).toContain('- a\n');
+        expect(s).not.toContain('- a: a tool');
         expect(s).toContain('<deferred_tools>');
-        expect(s).toContain('- b');
+        expect(s).toContain('Deferred tools are discoverable');
+        // Deferred entries carry a one-line hint — their schema is off the
+        // wire, so the hint is the model's only capability signal.
+        expect(s).toContain('- b: b tool');
+    });
+    it('toPromptSection truncates deferred hints to the first sentence, capped at 100 chars', () => {
+        const r = new ToolRegistry();
+        r.register([
+            makeTool('two_sentences', {
+                description: 'Reads the document. Second sentence that must not appear.',
+            }),
+            makeTool('long_sentence', {
+                description: `${'x'.repeat(150)} end`,
+            }),
+        ], 'deferred');
+        const s = r.toPromptSection();
+        expect(s).toContain('- two_sentences: Reads the document.');
+        expect(s).not.toContain('Second sentence');
+        const longLine = s.split('\n').find((line) => line.startsWith('- long_sentence:'));
+        expect(longLine).toBeDefined();
+        const hint = (longLine ?? '').replace('- long_sentence: ', '');
+        expect(hint.length).toBeLessThanOrEqual(100);
+        expect(hint.endsWith('…')).toBe(true);
+    });
+    it('toPromptSection references search_tools only when it is active', () => {
+        const r = new ToolRegistry();
+        r.register(makeTool('search_tools'));
+        r.register([makeTool('b')], 'deferred');
+        const s = r.toPromptSection();
+        expect(s).toContain('Use search_tools to load these before use');
     });
     it('toLLMTools: converts active + suspended tools', () => {
         const r = new ToolRegistry();
@@ -257,7 +366,36 @@ describe('ToolRegistry — execute', () => {
         }));
         const result = await r.execute('strict', { required: 123 }, makeContext());
         expect(result.success).toBe(false);
-        expect(result.error).toMatch(/Invalid input/);
+        expect(result.error).toMatch(/Validation failed for "strict"/);
+        expect(result.error).toContain('Expected string, received number');
+    });
+    it('empty-args validation lists required params with descriptions', async () => {
+        const r = new ToolRegistry();
+        r.register(makeTool('needs', {
+            inputSchema: z.object({ q: z.string().describe('the query'), n: z.number() }),
+        }));
+        const result = await r.execute('needs', {}, makeContext());
+        expect(result.success).toBe(false);
+        expect(result.error).toMatch(/called with no arguments/);
+        expect(result.error).toContain('q: string — the query');
+        expect(result.error).toContain('n: number');
+    });
+    it('validation hint reports when there are no required params', async () => {
+        const r = new ToolRegistry();
+        r.register(makeTool('opt', { inputSchema: z.object({ k: z.string().optional() }) }));
+        const result = await r.execute('opt', { k: 123 }, makeContext());
+        expect(result.success).toBe(false);
+        expect(result.error).toContain('No required parameters known.');
+    });
+    it('validation hint tolerates a schema it cannot introspect', async () => {
+        const r = new ToolRegistry();
+        const bogusSchema = {
+            safeParse: () => ({ success: false, error: { issues: [{ path: [], message: 'nope' }] } }),
+        };
+        r.register(makeTool('weird', { inputSchema: bogusSchema }));
+        const result = await r.execute('weird', { a: 1 }, makeContext());
+        expect(result.success).toBe(false);
+        expect(result.error).toContain('Could not introspect required parameters.');
     });
     it('wraps thrown errors in the execute function', async () => {
         const r = new ToolRegistry();
@@ -270,6 +408,39 @@ describe('ToolRegistry — execute', () => {
         expect(result.success).toBe(false);
         expect(result.error).toMatch(/execution failed: boom/);
     });
+    it('wraps a non-Error throw', async () => {
+        const r = new ToolRegistry();
+        r.register(makeTool('throws-string', {
+            async execute() {
+                throw 'plain string failure';
+            },
+        }));
+        const result = await r.execute('throws-string', {}, makeContext());
+        expect(result.success).toBe(false);
+        expect(result.error).toMatch(/execution failed/);
+    });
+    it('passes through a tool result that is unsuccessful with an error', async () => {
+        const r = new ToolRegistry();
+        r.register(makeTool('soft-fail', {
+            async execute() {
+                return { success: false, output: '', error: 'soft failure' };
+            },
+        }));
+        const result = await r.execute('soft-fail', {}, makeContext());
+        expect(result.success).toBe(false);
+        expect(result.error).toBe('soft failure');
+    });
+    it('blocks a non-read-only tool in plan mode (no isReadOnly hint)', async () => {
+        const r = new ToolRegistry();
+        const execute = vi.fn(async () => ({ success: true, output: 'ok' }));
+        r.register(makeTool('mutate', { execute }));
+        const result = await r.execute('mutate', {}, makeContext({
+            permissionContext: { mode: 'plan', runId: 'run_1', workingDirectory: '/tmp' },
+        }));
+        expect(result.success).toBe(false);
+        expect(result.error).toMatch(/plan mode/);
+        expect(execute).not.toHaveBeenCalled();
+    });
     it('returns the tool result on happy path', async () => {
         const r = new ToolRegistry();
         r.register(makeTool('good'));