@botbotgo/better-call 0.1.18 → 0.1.20

package/README.md

@@ -4,9 +4,13 @@
 
 # BetterCall
 
-**A small runtime reliability layer for LangChain and LLM tool calls.**
+[![npm version](https://img.shields.io/npm/v/@botbotgo/better-call.svg)](https://www.npmjs.com/package/@botbotgo/better-call)
+[![license](https://img.shields.io/npm/l/@botbotgo/better-call.svg)](LICENSE)
+[![release](https://github.com/botbotgo/better-call/actions/workflows/release.yml/badge.svg)](https://github.com/botbotgo/better-call/actions/workflows/release.yml)
 
-BetterCall wraps existing LangChain-style tools, validates model-generated calls before execution, and can optionally ask a repair model to fix rejected calls. In full BFCL v4 remote Ollama runs, the best measured lift was `granite4.1:3b`: **73.4% raw -> 83.8% with BetterCall**.
+BetterCall is a small runtime reliability layer for LangChain and LLM tool calls.
+
+Wrap your existing tools, validate model-generated calls before execution, and optionally ask a repair model to fix rejected calls. In full BFCL v4 remote Ollama runs, the best measured lift was `granite4.1:3b`: **73.4% raw -> 83.8% with BetterCall**.
 
 ```ts
 import { betterTools } from "@botbotgo/better-call";
@@ -16,7 +20,17 @@ const tools = betterTools([searchTool, calculatorTool]);
 
 No model means validate and block only. Add `repairModel` when you want automatic repair.
 
-## Install
+## Why BetterCall?
+
+Small models often know that a tool is needed but still fail at the boundary: wrong tool names, malformed arguments, schema drift, extra fields, or raw tool-call-shaped text. BetterCall sits at that boundary and gives you a typed, auditable way to accept, repair, or reject the call before the real tool runs.
+
+- Use your existing LangChain-style tools.
+- Accept JSON Schema, Zod object schemas, or Zod-shaped records.
+- Block invalid calls when no repair model is configured.
+- Repair rejected calls with a LangChain chat model or custom callback.
+- Keep lower-level primitives available for custom runtimes and gateways.
+
+## Installation
 
 ```bash
 npm install @botbotgo/better-call
@@ -45,7 +59,6 @@ The same wrapper works for any tool with `name`, `schema`, and `invoke(input)`:
 ```ts
 import { betterTools } from "@botbotgo/better-call";
 
-// Validate and block bad calls before execution.
 const tools = betterTools([searchTool, calculatorTool]);
 ```
 
@@ -53,6 +66,7 @@ To repair rejected calls automatically, pass a LangChain chat model or any model
 
 ```ts
 import { ChatOpenAI } from "@langchain/openai";
+import { betterTools } from "@botbotgo/better-call";
 
 const repairModel = new ChatOpenAI({ model: "gpt-4.1-mini" });
 
@@ -124,10 +138,46 @@ const tools = betterTools([
 ]);
 ```
 
-Lower-level exports are available for custom runtimes:
+### `repairToolCall(input)`
+
+Use this at an upstream adapter or tool gateway boundary when the model emitted an invalid tool call, unavailable tool name, or raw tool-call-shaped text before execution:
+
+```ts
+import { repairToolCall } from "@botbotgo/better-call";
+
+const repaired = await repairToolCall({
+  userInput: "Research this market.",
+  visibleTools: [taskTool],
+  hiddenTools: blockedTools,
+  invalidToolName: "ls",
+  args: { name: "research", query: "Research this market." },
+  repairModel,
+});
+```
+
+The result is structured for runtime traces and audit decisions:
+
+```ts
+{
+  status: "repaired", // "repaired" | "rejected" | "unchanged"
+  toolName: "task",
+  args: { subagent_type: "research", description: "Research this market." },
+  confidence: 0.8,
+  reason: "repair function selected a visible tool and schema-compatible arguments",
+  originalToolName: "ls",
+  originalArgs: { name: "research", query: "Research this market." },
+  violations: []
+}
+```
+
+BetterCall only repairs an existing tool call or tool-call-shaped intent. It does not invent a tool call from an ordinary final answer.
+
+### Lower-level exports
 
 - `guardToolCalls(...)`
 - `reliableToolCalls(...)`
+- `repairToolCall(...)`
+- `parseToolIntent(...)`
 - `normalizeToolSchema(schema)`
 - `defaultRepair(model)`
 - `BetterToolValidationError`
@@ -180,6 +230,24 @@ Latest completed remote run artifact: `benchmarks/bfcl-real-remote-completed-sum
 | `qwen3.5:4b` | 3,625 | 43.6% | 43.4% | -0.2pp | 1,847 |
 | `gemma4:e2b` | 3,625 | 24.3% | 24.7% | +0.4pp | 2,641 |
 
+## Requirements
+
+BetterCall is an ESM package for modern Node.js runtimes. It has one runtime dependency: `zod`.
+
+## Contributing
+
+Install dependencies and run the local checks:
+
+```bash
+npm ci
+npm test
+npm run release:pack
+```
+
+## Security
+
+If you believe you have found a security issue, please do not include sensitive details in a public issue. Open a minimal report first, or contact the maintainers through the repository owner.
+
 ## License
 
 Apache-2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE).

package/dist/index.d.ts

@@ -2,8 +2,9 @@ export { guardToolCalls } from "./guard.js";
 export { buildRepairPrompt, buildReviewPrompt } from "./prompts.js";
 export { defaultRepair } from "./default-repair.js";
 export type { RepairModelLike } from "./default-repair.js";
+export { parseToolIntent, repairToolCall } from "./inventory-repair.js";
 export { extractSchemaDescriptor, normalizeArgsBySchema, normalizeToolSchema } from "./schema.js";
 export { reliableToolCalls } from "./reliable.js";
 export { BetterToolValidationError, betterTools } from "./better-tool.js";
 export type { BetterToolLike, BetterToolsOptions } from "./better-tool.js";
-export type { GuardPolicy, GuardResult, IssueKind, JsonSchema, ArgsNormalizationOptions, ArgsNormalizationResult, ReliableToolCallsInput, ReliableToolCallsResult, RepairDiagnostics, RepairFunction, RepairInput, RepairPolicy, RepairProposal, SchemaDescriptor, SemanticValidator, ToolCall, ToolCallIssue, ToolDefinition, ToolSchema, } from "./types.js";
+export type { GuardPolicy, GuardResult, InventoryRepairInput, InventoryRepairResult, InventoryRepairStatus, IssueKind, JsonSchema, ArgsNormalizationOptions, ArgsNormalizationResult, ReliableToolCallsInput, ReliableToolCallsResult, RepairDiagnostics, RepairFunction, RepairInput, RepairPolicy, RepairProposal, SchemaDescriptor, SemanticValidator, ToolCall, ToolCallIssue, ToolDefinition, ToolSchema, } from "./types.js";

package/dist/index.js

@@ -1,6 +1,7 @@
 export { guardToolCalls } from "./guard.js";
 export { buildRepairPrompt, buildReviewPrompt } from "./prompts.js";
 export { defaultRepair } from "./default-repair.js";
+export { parseToolIntent, repairToolCall } from "./inventory-repair.js";
 export { extractSchemaDescriptor, normalizeArgsBySchema, normalizeToolSchema } from "./schema.js";
 export { reliableToolCalls } from "./reliable.js";
 export { BetterToolValidationError, betterTools } from "./better-tool.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/inventory-repair.d.ts

@@ -0,0 +1,3 @@
+import type { InventoryRepairInput, InventoryRepairResult, ToolCall } from "./types.js";
+export declare function repairToolCall(input: InventoryRepairInput): Promise<InventoryRepairResult>;
+export declare function parseToolIntent(value: unknown): ToolCall | undefined;

package/dist/inventory-repair.js

@@ -0,0 +1,353 @@
+import { defaultRepair } from "./default-repair.js";
+import { guardToolCalls } from "./guard.js";
+import { normalizeArgsBySchema, normalizeToolSchema } from "./schema.js";
+export async function repairToolCall(input) {
+    const visibleTools = normalizeTools(input.visibleTools);
+    const hiddenTools = normalizeTools(input.hiddenTools ?? []);
+    const original = extractOriginalCall(input);
+    if (!original) {
+        return rejected("no tool-call intent was provided", undefined, undefined, [{
+                kind: "parse",
+                path: "$.rawIntent",
+                message: "could not extract a tool call from the provided intent",
+            }]);
+    }
+    const originalToolName = original.tool;
+    const originalArgs = original.args;
+    const hiddenTool = hiddenTools.find((tool) => tool.name === original.tool);
+    if (hiddenTool) {
+        return rejected("model selected a hidden or blocked tool", originalToolName, originalArgs, [{
+                kind: "blocked_tool",
+                path: "$.tool",
+                message: `blocked tool ${original.tool}`,
+                tool: original.tool,
+            }]);
+    }
+    const visibleTool = visibleTools.find((tool) => tool.name === original.tool);
+    if (visibleTool) {
+        return repairKnownTool(input, visibleTools, visibleTool, original, originalToolName, originalArgs);
+    }
+    const inventoryProposal = await repairUnavailableToolFromInventory(input, visibleTools, original, originalToolName, originalArgs);
+    if (inventoryProposal)
+        return inventoryProposal;
+    const modelProposal = await repairWithModelOrCallback(input, visibleTools, original, [{
+            kind: "unknown_tool",
+            path: "$.tool",
+            message: `unknown tool ${original.tool}`,
+            tool: original.tool,
+        }]);
+    if (modelProposal) {
+        return {
+            status: "repaired",
+            toolName: modelProposal.tool,
+            args: modelProposal.args,
+            confidence: 0.8,
+            reason: "repair function selected a visible tool and schema-compatible arguments",
+            originalToolName,
+            originalArgs,
+            violations: [],
+        };
+    }
+    return rejected("no unambiguous visible tool repair was found", originalToolName, originalArgs, [{
+            kind: "unknown_tool",
+            path: "$.tool",
+            message: `unknown tool ${original.tool}`,
+            tool: original.tool,
+        }]);
+}
+export function parseToolIntent(value) {
+    if (isRecord(value))
+        return toolCallFromRecord(value);
+    if (typeof value !== "string")
+        return undefined;
+    const text = stripToolCode(value.trim());
+    const jsonCall = parseJsonToolCall(text);
+    if (jsonCall)
+        return jsonCall;
+    return parseFunctionStyleToolCall(text);
+}
+async function repairKnownTool(input, visibleTools, tool, original, originalToolName, originalArgs) {
+    const first = await guardToolCalls({ tools: visibleTools, calls: [original] });
+    if (first.ok) {
+        return {
+            status: "unchanged",
+            toolName: original.tool,
+            args: original.args,
+            confidence: 1,
+            reason: "tool call already matched the visible inventory and selected schema",
+            originalToolName,
+            originalArgs,
+            violations: [],
+        };
+    }
+    const aliasArgs = repairArgumentAliases(tool.schema, original.args);
+    const normalizedArgs = normalizeArgsBySchema(tool.schema, aliasArgs, input.repairPolicy).args;
+    const proposed = { tool: original.tool, args: normalizedArgs };
+    const second = await guardToolCalls({ tools: visibleTools, calls: [proposed] });
+    if (second.ok && !sameCall(original, proposed)) {
+        return {
+            status: "repaired",
+            toolName: proposed.tool,
+            args: proposed.args,
+            confidence: 0.85,
+            reason: "arguments were repaired using the selected tool schema",
+            originalToolName,
+            originalArgs,
+            violations: first.issues,
+        };
+    }
+    const modelProposal = await repairWithModelOrCallback(input, visibleTools, original, first.issues);
+    if (modelProposal) {
+        return {
+            status: "repaired",
+            toolName: modelProposal.tool,
+            args: modelProposal.args,
+            confidence: 0.8,
+            reason: "repair function returned a schema-compatible visible tool call",
+            originalToolName,
+            originalArgs,
+            violations: first.issues,
+        };
+    }
+    return rejected("selected tool arguments could not be repaired", originalToolName, originalArgs, first.issues);
+}
+async function repairUnavailableToolFromInventory(input, visibleTools, original, originalToolName, originalArgs) {
+    const candidates = [];
+    for (const tool of visibleTools) {
+        const aliasArgs = repairArgumentAliases(tool.schema, original.args);
+        const normalizedArgs = normalizeArgsBySchema(tool.schema, aliasArgs, input.repairPolicy).args;
+        const proposed = { tool: tool.name, args: normalizedArgs };
+        const result = await guardToolCalls({ tools: visibleTools, calls: [proposed] });
+        if (result.ok)
+            candidates.push(proposed);
+    }
+    if (candidates.length !== 1)
+        return undefined;
+    const [candidate] = candidates;
+    return {
+        status: "repaired",
+        toolName: candidate.tool,
+        args: candidate.args,
+        confidence: 0.75,
+        reason: "exactly one visible tool accepted the repaired argument shape",
+        originalToolName,
+        originalArgs,
+        violations: [{
+                kind: "unknown_tool",
+                path: "$.tool",
+                message: `unknown tool ${original.tool}`,
+                tool: original.tool,
+            }],
+    };
+}
+async function repairWithModelOrCallback(input, visibleTools, original, issues) {
+    const repair = input.repair ?? (input.repairModel ? defaultRepair(input.repairModel) : undefined);
+    if (!repair)
+        return undefined;
+    const repaired = await repair({
+        userInput: input.userInput,
+        tools: visibleTools,
+        hiddenTools: normalizeTools(input.hiddenTools ?? []),
+        calls: [original],
+        issues,
+        runtimePolicy: input.runtimePolicy,
+    });
+    for (const call of repaired) {
+        if (!visibleTools.some((tool) => tool.name === call.tool))
+            continue;
+        const result = await guardToolCalls({ tools: visibleTools, calls: [call] });
+        if (result.ok)
+            return call;
+    }
+    return undefined;
+}
+function extractOriginalCall(input) {
+    const fromCall = input.call ? toolCallFromRecord(input.call) : undefined;
+    if (fromCall)
+        return fromCall;
+    const fromRaw = parseToolIntent(input.rawIntent);
+    if (fromRaw)
+        return fromRaw;
+    const name = input.invalidToolName;
+    if (name)
+        return { tool: name, args: input.args ?? {} };
+    return undefined;
+}
+function repairArgumentAliases(schema, args) {
+    const normalized = normalizeToolSchema(schema);
+    if (!normalized?.properties)
+        return args;
+    let next = { ...args };
+    const properties = normalized.properties;
+    for (const key of Object.keys(args)) {
+        const canonical = findCanonicalKey(key, properties);
+        if (canonical && canonical !== key && !(canonical in next)) {
+            next[canonical] = next[key];
+            delete next[key];
+        }
+    }
+    next = repairSingleRequiredString(normalized, next);
+    if (normalized.additionalProperties === false) {
+        for (const key of Object.keys(next)) {
+            if (!(key in properties))
+                delete next[key];
+        }
+    }
+    return next;
+}
+function repairSingleRequiredString(schema, args) {
+    const properties = schema.properties ?? {};
+    const missingRequired = (schema.required ?? []).filter((key) => !(key in args));
+    if (missingRequired.length !== 1)
+        return args;
+    const [missingKey] = missingRequired;
+    const missingSchema = properties[missingKey];
+    if (!missingSchema || !expectsString(missingSchema))
+        return args;
+    const extras = Object.entries(args).filter(([key, value]) => !(key in properties) && typeof value === "string");
+    if (extras.length !== 1)
+        return args;
+    const [[extraKey, extraValue]] = extras;
+    const next = { ...args, [missingKey]: extraValue };
+    delete next[extraKey];
+    return next;
+}
+function findCanonicalKey(key, properties) {
+    const normalizedKey = normalizeKey(key);
+    return Object.keys(properties).find((candidate) => normalizeKey(candidate) === normalizedKey);
+}
+function normalizeKey(value) {
+    return value.toLowerCase().replace(/[^a-z0-9]/gu, "");
+}
+function expectsString(schema) {
+    return schema.type === "string" || (Array.isArray(schema.type) && schema.type.includes("string")) || !schema.type;
+}
+function parseJsonToolCall(value) {
+    try {
+        return toolCallFromRecord(JSON.parse(stripCodeFence(value)));
+    }
+    catch {
+        return undefined;
+    }
+}
+function parseFunctionStyleToolCall(value) {
+    const match = /^\s*([A-Za-z_$][\w$.-]*)\s*\(([\s\S]*)\)\s*;?\s*$/u.exec(value);
+    if (!match)
+        return undefined;
+    return { tool: match[1], args: parseFunctionArgs(match[2]) };
+}
+function parseFunctionArgs(value) {
+    const args = {};
+    for (const part of splitTopLevelCommas(value)) {
+        const match = /^\s*([A-Za-z_$][\w$.-]*)\s*=\s*([\s\S]*?)\s*$/u.exec(part);
+        if (match)
+            args[match[1]] = parseScalar(match[2]);
+    }
+    return args;
+}
+function splitTopLevelCommas(value) {
+    const parts = [];
+    let current = "";
+    let quote;
+    let escaped = false;
+    for (const char of value) {
+        if (escaped) {
+            current += char;
+            escaped = false;
+            continue;
+        }
+        if (char === "\\") {
+            current += char;
+            escaped = true;
+            continue;
+        }
+        if (quote) {
+            current += char;
+            if (char === quote)
+                quote = undefined;
+            continue;
+        }
+        if (char === "\"" || char === "'") {
+            current += char;
+            quote = char;
+            continue;
+        }
+        if (char === ",") {
+            parts.push(current);
+            current = "";
+            continue;
+        }
+        current += char;
+    }
+    if (current.trim() !== "")
+        parts.push(current);
+    return parts;
+}
+function parseScalar(value) {
+    const trimmed = value.trim();
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return trimmed.replace(/^["']|["']$/gu, "");
+    }
+}
+function stripToolCode(value) {
+    const match = /<tool_code>\s*([\s\S]*?)\s*<\/tool_code>/iu.exec(value);
+    return match ? match[1].trim() : value;
+}
+function stripCodeFence(value) {
+    const match = /^```(?:json)?\s*([\s\S]*?)\s*```$/u.exec(value.trim());
+    return match ? match[1] : value;
+}
+function toolCallFromRecord(value) {
+    if (!isRecord(value))
+        return undefined;
+    if (typeof value.tool === "string" && isRecord(value.args))
+        return { tool: value.tool, args: value.args };
+    if (typeof value.name === "string" && isRecord(value.args))
+        return { tool: value.name, args: value.args };
+    if (typeof value.name === "string" && isRecord(value.arguments))
+        return { tool: value.name, args: value.arguments };
+    if (typeof value.name === "string" && typeof value.arguments === "string") {
+        const parsed = parseJsonObject(value.arguments);
+        if (parsed)
+            return { tool: value.name, args: parsed };
+    }
+    if (isRecord(value.function))
+        return toolCallFromRecord(value.function);
+    if (Array.isArray(value.calls))
+        return value.calls.map(toolCallFromRecord).find(Boolean);
+    if (Array.isArray(value.tool_calls))
+        return value.tool_calls.map(toolCallFromRecord).find(Boolean);
+    return undefined;
+}
+function parseJsonObject(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return isRecord(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function rejected(reason, originalToolName, originalArgs, violations) {
+    return {
+        status: "rejected",
+        confidence: 0,
+        reason,
+        originalToolName,
+        originalArgs,
+        violations,
+    };
+}
+function normalizeTools(tools) {
+    return tools.map((tool) => ({ ...tool, schema: normalizeToolSchema(tool.schema) }));
+}
+function sameCall(left, right) {
+    return left.tool === right.tool && JSON.stringify(left.args) === JSON.stringify(right.args);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=inventory-repair.js.map

package/dist/inventory-repair.js.map

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

package/dist/prompts.js

@@ -6,6 +6,8 @@ export function buildRepairPrompt(input) {
         "",
         `User request: ${input.userInput}`,
         `Tools: ${JSON.stringify(input.tools)}`,
+        `Hidden or blocked tools: ${JSON.stringify(input.hiddenTools ?? [])}`,
+        `Runtime policy: ${JSON.stringify(input.runtimePolicy ?? {})}`,
         `Rejected calls: ${JSON.stringify(input.calls)}`,
         `Issues: ${JSON.stringify(input.issues)}`,
     ].join("\n");
@@ -18,6 +20,8 @@ export function buildReviewPrompt(input) {
         "",
         `User request: ${input.userInput}`,
         `Tools: ${JSON.stringify(input.tools)}`,
+        `Hidden or blocked tools: ${JSON.stringify(input.hiddenTools ?? [])}`,
+        `Runtime policy: ${JSON.stringify(input.runtimePolicy ?? {})}`,
         `Previous calls: ${JSON.stringify(input.calls)}`,
         `Validation issues, if any: ${JSON.stringify(input.issues)}`,
     ].join("\n");

package/dist/prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,KAAkB;IAClD,OAAO;QACL,2DAA2D;QAC3D,8EAA8E;QAC9E,qDAAqD;QACrD,EAAE;QACF,iBAAiB,KAAK,CAAC,SAAS,EAAE;QAClC,UAAU,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QACvC,mBAAmB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QAChD,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;KAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAkB;IAClD,OAAO;QACL,sEAAsE;QACtE,8FAA8F;QAC9F,0EAA0E;QAC1E,EAAE;QACF,iBAAiB,KAAK,CAAC,SAAS,EAAE;QAClC,UAAU,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QACvC,mBAAmB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QAChD,8BAA8B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;KAC7D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,KAAkB;IAClD,OAAO;QACL,2DAA2D;QAC3D,8EAA8E;QAC9E,qDAAqD;QACrD,EAAE;QACF,iBAAiB,KAAK,CAAC,SAAS,EAAE;QAClC,UAAU,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QACvC,4BAA4B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE;QACrE,mBAAmB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE;QAC9D,mBAAmB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QAChD,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;KAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAkB;IAClD,OAAO;QACL,sEAAsE;QACtE,8FAA8F;QAC9F,0EAA0E;QAC1E,EAAE;QACF,iBAAiB,KAAK,CAAC,SAAS,EAAE;QAClC,UAAU,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QACvC,4BAA4B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE;QACrE,mBAAmB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE;QAC9D,mBAAmB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QAChD,8BAA8B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;KAC7D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/types.d.ts

@@ -39,7 +39,7 @@ export type ToolCall = {
     tool: string;
     args: Record<string, unknown>;
 };
-export type IssueKind = "unknown_tool" | "irrelevant_call" | "missing_call" | "schema" | "type" | "semantic";
+export type IssueKind = "unknown_tool" | "blocked_tool" | "irrelevant_call" | "missing_call" | "parse" | "schema" | "type" | "semantic";
 export type ToolCallIssue = {
     kind: IssueKind;
     path: string;
@@ -94,8 +94,10 @@ export type SemanticValidator = (input: {
 export type RepairInput = {
     userInput: string;
     tools: ToolDefinition[];
+    hiddenTools?: ToolDefinition[];
     calls: ToolCall[];
     issues: ToolCallIssue[];
+    runtimePolicy?: Record<string, unknown>;
 };
 export type RepairFunction = (input: RepairInput) => Promise<ToolCall[]> | ToolCall[];
 export type ReliableToolCallsInput = {
@@ -113,3 +115,32 @@ export type ReliableToolCallsResult = GuardResult & {
     original: ToolCall[];
     diagnostics?: RepairDiagnostics[];
 };
+export type InventoryRepairStatus = "repaired" | "rejected" | "unchanged";
+export type InventoryRepairInput = {
+    userInput: string;
+    visibleTools: ToolDefinition[];
+    hiddenTools?: ToolDefinition[];
+    call?: Partial<ToolCall> & {
+        name?: string;
+        arguments?: unknown;
+    };
+    rawIntent?: string;
+    invalidToolName?: string;
+    args?: Record<string, unknown>;
+    runtimePolicy?: Record<string, unknown>;
+    repairPolicy?: RepairPolicy;
+    repair?: RepairFunction;
+    repairModel?: {
+        invoke(input: unknown): Promise<unknown> | unknown;
+    };
+};
+export type InventoryRepairResult = {
+    status: InventoryRepairStatus;
+    toolName?: string;
+    args?: Record<string, unknown>;
+    confidence: number;
+    reason: string;
+    originalToolName?: string;
+    originalArgs?: Record<string, unknown>;
+    violations: ToolCallIssue[];
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/better-call",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "LLM tool-call reliability layer.",
   "type": "module",
   "license": "Apache-2.0",
@@ -46,7 +46,7 @@
     "prepack": "npm run test"
   },
   "devDependencies": {
-    "@types/node": "^24.10.1",
+    "@types/node": "^25.6.2",
     "typescript": "^5.9.3"
   },
   "dependencies": {