@botbotgo/better-call 0.1.26 → 0.1.28

package/docs/marketing/launch-post.md

@@ -12,7 +12,7 @@ LLM tool calling has a boring failure mode that shows up constantly with small m
 
 The model knows a tool is needed, but the actual call is not executable.
 
-It may pick a near-miss tool name, send `symbol` instead of `ticker`, use an enum value the schema rejects, include extra fields, or emit raw tool-call-shaped text. If your runtime sends that straight to a real tool, the best case is a failed request. The worse case is the wrong operation reaching production code.
+It may pick a near-miss tool name, send `symbol` instead of `ticker`, use an enum value the schema rejects, include extra fields, or emit raw tool-call-shaped text. If your runtime sends that straight to a real tool, the best case is a failed request. The worst case is the wrong operation reaching production code.
 
 BetterCall is a small TypeScript reliability layer for that boundary.
 

package/docs/recipes/openai-compatible.md

@@ -10,10 +10,10 @@ const result = await reliableToolCalls({
   tools,
   calls,
   repair: async ({ userInput, tools, calls, issues }) => {
-    const response = await fetch(`${baseUrl}/chat/completions`, {
+    const response = await fetch(`${baseUrl}/v1/chat/completions`, {
       method: "POST",
       headers: {
-        "authorization": `Bearer ${apiKey}`,
+        "Authorization": `Bearer ${apiKey}`,
         "content-type": "application/json",
       },
       body: JSON.stringify({

package/examples/README.md

@@ -33,5 +33,5 @@ The Ollama and OpenAI-compatible examples expect local model endpoints:
 
 ```bash
 OLLAMA_BASE_URL=http://127.0.0.1:11434 OLLAMA_MODEL=granite4.1:3b node examples/ollama-small-model.mjs
-OPENAI_BASE_URL=http://127.0.0.1:8000/v1 OPENAI_MODEL=local-model node examples/adapters/openai-compatible-repair.mjs
+OPENAI_BASE_URL=http://127.0.0.1:8000 OPENAI_MODEL=local-model node examples/adapters/openai-compatible-repair.mjs
 ```

package/examples/adapters/openai-compatible-repair.mjs

@@ -1,6 +1,6 @@
 import { reliableToolCalls } from "../../dist/index.js";
 
-const baseUrl = process.env.OPENAI_BASE_URL ?? "http://127.0.0.1:8000/v1";
+const baseUrl = process.env.OPENAI_BASE_URL ?? "http://127.0.0.1:8000";
 const model = process.env.OPENAI_MODEL ?? "local-model";
 const apiKey = process.env.OPENAI_API_KEY ?? "not-needed-for-local";
 
@@ -23,10 +23,10 @@ const result = await reliableToolCalls({
   tools,
   calls: [{ tool: "stock_price", args: { symbol: "Apple", market: "NASDAQ" } }],
   repair: async ({ userInput, tools, calls, issues }) => {
-    const response = await fetch(`${baseUrl}/chat/completions`, {
+    const response = await fetch(`${baseUrl}/v1/chat/completions`, {
       method: "POST",
       headers: {
-        "authorization": `Bearer ${apiKey}`,
+        "Authorization": `Bearer ${apiKey}`,
         "content-type": "application/json",
       },
       body: JSON.stringify({

package/examples/ollama-small-model.mjs

@@ -17,12 +17,12 @@ const tools = [{
   },
 }];
 
-const badCall = { tool: "stock_price", args: { symbol: "Apple", market: "NASDAQ" } };
+const invalidToolCall = { tool: "stock_price", args: { symbol: "Apple", market: "NASDAQ" } };
 
 const result = await reliableToolCalls({
   userInput: "Get Apple stock in the US market.",
   tools,
-  calls: [badCall],
+  calls: [invalidToolCall],
   repair: async ({ userInput, tools, calls, issues }) => {
     const prompt = [
       "Return corrected JSON only as {\"calls\":[{\"tool\":\"name\",\"args\":{}}]}.",
@@ -43,4 +43,4 @@ const result = await reliableToolCalls({
   },
 });
 
-console.log(JSON.stringify({ model, badCall, result }, null, 2));
+console.log(JSON.stringify({ model, invalidToolCall, result }, null, 2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/better-call",
-  "version": "0.1.26",
+  "version": "0.1.28",
   "description": "Small-model tool-call reliability layer for LangChain and custom agent runtimes.",
   "type": "module",
   "license": "Apache-2.0",

package/scripts/demo.mjs

@@ -3,6 +3,23 @@ import { betterTools, repairToolCall, reliableToolCalls } from "../dist/index.js
 
 const json = process.argv.includes("--json");
 
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+function exitWithError(step, error) {
+  const message = errorMessage(error);
+
+  if (json) {
+    console.error(JSON.stringify({ error: step, message }, null, 2));
+  } else {
+    console.error(`BetterCall demo failed during ${step}.`);
+    console.error(message);
+  }
+
+  process.exit(1);
+}
+
 const stockQuote = {
   name: "stock_quote",
   description: "Get a stock quote.",
@@ -29,38 +46,59 @@ const [wrappedStockQuote] = betterTools([stockQuote], {
   },
 });
 
-const wrappedOutput = await wrappedStockQuote.invoke(badArgs);
+let wrappedOutput;
+try {
+  wrappedOutput = await wrappedStockQuote.invoke(badArgs);
+} catch (error) {
+  exitWithError("wrapped stock_quote invocation", error);
+}
 
-const reliableResult = await reliableToolCalls({
-  userInput: "Get Apple stock in the US market.",
-  tools: [stockQuote],
-  calls: [{ tool: "stock_price", args: badArgs }],
-  repair() {
-    return [{ tool: "stock_quote", args: { ticker: "AAPL", market: "US" } }];
-  },
-});
+let reliableResult;
+try {
+  reliableResult = await reliableToolCalls({
+    userInput: "Get Apple stock in the US market.",
+    tools: [stockQuote],
+    // The tool name is intentionally wrong to demonstrate repair to stock_quote.
+    calls: [{ tool: "stock_price", args: badArgs }],
+    repair() {
+      return [{ tool: "stock_quote", args: { ticker: "AAPL", market: "US" } }];
+    },
+  });
+} catch (error) {
+  exitWithError("tool-call repair", error);
+}
 
-const gatewayResult = await repairToolCall({
-  userInput: "Research the current market.",
-  visibleTools: [{
-    name: "task",
-    description: "Delegate a task to a visible specialist.",
-    schema: {
-      type: "object",
-      properties: {
-        subagent_type: { type: "string", enum: ["research", "ops"] },
-        description: { type: "string" },
+let gatewayResult;
+try {
+  gatewayResult = await repairToolCall({
+    userInput: "Research the current market.",
+    visibleTools: [{
+      name: "task",
+      description: "Delegate a task to a visible specialist.",
+      schema: {
+        type: "object",
+        properties: {
+          subagent_type: { type: "string", enum: ["research", "ops"] },
+          description: { type: "string" },
+        },
+        required: ["subagent_type", "description"],
+        additionalProperties: false,
       },
-      required: ["subagent_type", "description"],
-      additionalProperties: false,
+    }],
+    invalidToolName: "research",
+    args: {
+      subagent_type: "research",
+      description: "Research the current market.",
     },
-  }],
-  invalidToolName: "research",
-  args: {
-    subagent_type: "research",
-    description: "Research the current market.",
-  },
-});
+  });
+} catch (error) {
+  gatewayResult = {
+    status: "error",
+    originalToolName: "research",
+    toolName: null,
+    reason: `repairToolCall failed: ${errorMessage(error)}`,
+  };
+}
 
 const report = {
   wrappedTool: {