@botbotgo/better-call 0.1.47 → 0.1.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/better-call",
-  "version": "0.1.47",
+  "version": "0.1.49",
   "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,8 @@ import { betterTools, repairToolCall, reliableToolCalls } from "../dist/index.js
 
 const json = process.argv.includes("--json");
 const VALID_MARKETS = ["US", "HK", "CN"];
+// Intentionally incorrect tool name used to demonstrate tool-call repair behavior.
+const DEMO_INVALID_TOOL_NAME = "stock_price";
 
 function errorMessage(error) {
   return error instanceof Error ? error.message : String(error);
@@ -52,6 +54,19 @@ function displayValue(value) {
   return value == null ? "(none)" : String(value);
 }
 
+function hasUsableArgsShape(value) {
+  return (
+    typeof value === "object" &&
+    value != null &&
+    !Array.isArray(value) &&
+    ("ticker" in value || "symbol" in value || "market" in value)
+  );
+}
+
+function createDemoMalformedInput() {
+  return { symbol: "Apple", market: "NASDAQ" };
+}
+
 function exitWithError(step, error) {
   const message = errorMessage(error);
 
@@ -98,10 +113,6 @@ const stockQuote = {
   },
 };
 
-// Intentionally malformed repair input: "symbol" should be "ticker", and
-// "NASDAQ" is not one of the schema-valid markets ("US", "HK", or "CN").
-const DEMO_MALFORMED_INPUT = { symbol: "Apple", market: "NASDAQ" };
-
 /**
  * Repairs malformed stock quote tool-call input into one schema-valid call.
  *
@@ -116,33 +127,31 @@ const DEMO_MALFORMED_INPUT = { symbol: "Apple", market: "NASDAQ" };
  *   AAPL, and unsupported markets fall back to US.
  */
 function repairDemoStockCall(repairInput = {}) {
-  const hasUsableArgsShape = (value) =>
-    typeof value === "object" &&
-    value != null &&
-    !Array.isArray(value) &&
-    ("ticker" in value || "symbol" in value || "market" in value);
-
   const attemptedArgs =
     Array.isArray(repairInput?.calls) &&
     repairInput.calls.length > 0 &&
     hasUsableArgsShape(repairInput.calls[0]?.args)
       ? repairInput.calls[0].args
-      : DEMO_MALFORMED_INPUT;
+      : createDemoMalformedInput();
 
-  const attemptedTicker =
+  const rawAttemptedTicker =
     typeof attemptedArgs.ticker === "string"
       ? attemptedArgs.ticker
       : typeof attemptedArgs.symbol === "string"
         ? attemptedArgs.symbol
         : "AAPL";
+  const attemptedTicker =
+    typeof rawAttemptedTicker === "string" ? rawAttemptedTicker : "AAPL";
   const normalizedTicker = attemptedTicker.trim().toLowerCase();
   // This demo maps empty input and the "apple" alias to AAPL.
-  const ticker =
-    normalizedTicker === ""
-      ? "AAPL"
-      : normalizedTicker === "apple"
-        ? "AAPL"
-        : normalizedTicker.toUpperCase();
+  let ticker;
+  if (normalizedTicker === "") {
+    ticker = "AAPL";
+  } else if (normalizedTicker === "apple") {
+    ticker = "AAPL";
+  } else {
+    ticker = normalizedTicker.toUpperCase();
+  }
 
   const attemptedMarket = typeof attemptedArgs.market === "string" ? attemptedArgs.market : null;
   const market =
@@ -165,13 +174,23 @@ if (!Array.isArray(wrappedTools) || wrappedTools.length === 0) {
   );
 }
 
-const wrappedStockQuote = wrappedTools[0];
+const wrappedStockQuote = wrappedTools.find((tool) => tool?.name === "stock_quote");
+if (wrappedStockQuote == null) {
+  exitWithError(
+    "tool wrapping",
+    new Error("betterTools did not return a wrapped stock_quote tool")
+  );
+}
+
+// Intentionally malformed demo input: "symbol" should be "ticker", and
+// "NASDAQ" is not one of the schema-valid markets ("US", "HK", or "CN").
+const demoMalformedInput = createDemoMalformedInput();
 
 let wrappedOutput;
 try {
-  wrappedOutput = await wrappedStockQuote.invoke(DEMO_MALFORMED_INPUT);
+  wrappedOutput = await wrappedStockQuote.invoke(demoMalformedInput);
 } catch (error) {
-  const context = `tool=stock_quote args=${JSON.stringify(DEMO_MALFORMED_INPUT)}`;
+  const context = `tool=stock_quote args=${JSON.stringify(demoMalformedInput)}`;
   const message = `${errorMessage(error)} (${context})`;
   const contextualError =
     error instanceof Error ? new Error(message, { cause: error }) : new Error(message);
@@ -184,9 +203,9 @@ try {
     userInput: "Get Apple stock in the US market.",
     tools: [stockQuote],
     // Both the tool name and args are intentionally wrong to demonstrate repair:
-    // "stock_price" should be "stock_quote"; DEMO_MALFORMED_INPUT uses
+    // DEMO_INVALID_TOOL_NAME should be "stock_quote"; demoMalformedInput uses
     // "symbol"/"NASDAQ" instead of schema-valid stock_quote args.
-    calls: [{ tool: "stock_price", args: DEMO_MALFORMED_INPUT }],
+    calls: [{ tool: DEMO_INVALID_TOOL_NAME, args: demoMalformedInput }],
     repair: repairDemoStockCall,
   });
 } catch (error) {
@@ -243,11 +262,11 @@ const repairedCall =
 
 const report = {
   wrappedTool: {
-    before: DEMO_MALFORMED_INPUT,
+    before: demoMalformedInput,
     after: wrappedOutput,
   },
   reliableToolCalls: {
-    before: { tool: "stock_price", args: DEMO_MALFORMED_INPUT },
+    before: { tool: DEMO_INVALID_TOOL_NAME, args: demoMalformedInput },
     repaired: repairedCall,
     // Optional validation/repair metadata; null means this run returned none.
     diagnostics: reliableResult?.diagnostics ?? null,