@botbotgo/better-call 0.1.41 → 0.1.43

package/package.json

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

package/scripts/demo.mjs

@@ -8,6 +8,18 @@ function errorMessage(error) {
   return error instanceof Error ? error.message : String(error);
 }
 
+function createGatewayErrorResult(originalToolName, reason, details = {}) {
+  return {
+    status: "error",
+    originalToolName,
+    toolName: null,
+    reason,
+    errorType: details.type ?? null,
+    errorMessage: details.message ?? null,
+    errorCause: details.cause ?? null,
+  };
+}
+
 function errorDetails(error) {
   if (error instanceof Error) {
     const causeMessage =
@@ -86,13 +98,38 @@ 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 malformedRepairArgs = { symbol: "Apple", market: "NASDAQ" };
+const intentionallyMalformedArgs = { symbol: "Apple", market: "NASDAQ" };
+
+function repairDemoStockCall(repairInput = {}) {
+  const attemptedArgs =
+    Array.isArray(repairInput?.calls) && repairInput.calls[0]?.args != null
+      ? repairInput.calls[0].args
+      : intentionallyMalformedArgs;
+
+  const attemptedTicker =
+    typeof attemptedArgs.ticker === "string"
+      ? attemptedArgs.ticker
+      : typeof attemptedArgs.symbol === "string"
+        ? attemptedArgs.symbol
+        : "AAPL";
+  const normalizedTicker = attemptedTicker.trim().toLowerCase();
+  const ticker =
+    normalizedTicker === "apple" || normalizedTicker === ""
+      ? "AAPL"
+      : normalizedTicker.toUpperCase();
+
+  const attemptedMarket = typeof attemptedArgs.market === "string" ? attemptedArgs.market : null;
+  const market =
+    attemptedMarket != null && VALID_MARKETS.includes(attemptedMarket)
+      ? attemptedMarket
+      : "US";
+
+  return [{ tool: "stock_quote", args: { ticker, market } }];
+}
 
 const wrappedTools = betterTools([stockQuote], {
   userInput: "Get Apple stock in the US market.",
-  repair() {
-    return [{ tool: "stock_quote", args: { ticker: "AAPL", market: "US" } }];
-  },
+  repair: repairDemoStockCall,
 });
 
 if (!Array.isArray(wrappedTools) || wrappedTools.length === 0) {
@@ -106,9 +143,9 @@ const wrappedStockQuote = wrappedTools[0];
 
 let wrappedOutput;
 try {
-  wrappedOutput = await wrappedStockQuote.invoke(malformedRepairArgs);
+  wrappedOutput = await wrappedStockQuote.invoke(intentionallyMalformedArgs);
 } catch (error) {
-  const context = `tool=stock_quote args=${JSON.stringify(malformedRepairArgs)}`;
+  const context = `tool=stock_quote args=${JSON.stringify(intentionallyMalformedArgs)}`;
   const message = `${errorMessage(error)} (${context})`;
   const contextualError =
     error instanceof Error ? new Error(message, { cause: error }) : new Error(message);
@@ -121,12 +158,10 @@ 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"; malformedRepairArgs uses
+    // "stock_price" should be "stock_quote"; intentionallyMalformedArgs uses
     // "symbol"/"NASDAQ" instead of schema-valid stock_quote args.
-    calls: [{ tool: "stock_price", args: malformedRepairArgs }],
-    repair() {
-      return [{ tool: "stock_quote", args: { ticker: "AAPL", market: "US" } }];
-    },
+    calls: [{ tool: "stock_price", args: intentionallyMalformedArgs }],
+    repair: repairDemoStockCall,
   });
 } catch (error) {
   exitWithError("tool-call repair", error);
@@ -157,31 +192,21 @@ try {
   });
 } catch (error) {
   const details = errorDetails(error);
-  gatewayResult = {
-    status: "error",
-    originalToolName: "research",
-    toolName: null,
-    reason: `repairToolCall failed: ${details.message}`,
-    errorType: details.type,
-    errorMessage: details.message,
-    errorCause: details.cause,
-  };
+  gatewayResult = createGatewayErrorResult(
+    "research",
+    `repairToolCall failed: ${details.message}`,
+    details
+  );
 }
 
 const gatewayRepair =
   gatewayResult != null && typeof gatewayResult === "object"
     ? gatewayResult
-    : {
-        status: "error",
-        originalToolName: "research",
-        toolName: null,
-        reason: "repairToolCall returned no result.",
-        errorType: null,
-        errorMessage: null,
-        errorCause: null,
-      };
+    : createGatewayErrorResult("research", "repairToolCall returned no result.");
 
 // Missing or empty calls are expected in some demo/error paths; normalize to null for reporting.
+// This demo reports only the first repaired call so the summary stays compact and stable.
+// If multiple calls are present, subsequent calls are intentionally left out of this view.
 const repairedCall =
   Array.isArray(reliableResult?.calls) && reliableResult.calls.length > 0
     ? reliableResult.calls[0]
@@ -189,11 +214,11 @@ const repairedCall =
 
 const report = {
   wrappedTool: {
-    before: malformedRepairArgs,
+    before: intentionallyMalformedArgs,
     after: wrappedOutput,
   },
   reliableToolCalls: {
-    before: { tool: "stock_price", args: malformedRepairArgs },
+    before: { tool: "stock_price", args: intentionallyMalformedArgs },
     repaired: repairedCall,
     diagnostics: reliableResult?.diagnostics ?? null,
   },