@botbotgo/better-call 0.1.46 → 0.1.48

package/package.json

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

package/scripts/demo.mjs

@@ -52,6 +52,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,13 +111,12 @@ 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 intentionallyMalformedArgs = { symbol: "Apple", market: "NASDAQ" };
-
 /**
  * Repairs malformed stock quote tool-call input into one schema-valid call.
  *
+ * Diagnostics, when present, come from the surrounding reliableToolCalls run
+ * and explain validation/repair decisions such as fallback ticker or market values.
+ *
  * @param {object} [repairInput={}] Optional repair payload that may include
  *   `calls[0].args`.
  * @returns {{ tool: string, args: { ticker: string, market: "US" | "HK" | "CN" } }[]}
@@ -113,18 +125,12 @@ const intentionallyMalformedArgs = { 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
-      : intentionallyMalformedArgs;
+      : createDemoMalformedInput();
 
   const attemptedTicker =
     typeof attemptedArgs.ticker === "string"
@@ -133,7 +139,7 @@ function repairDemoStockCall(repairInput = {}) {
         ? attemptedArgs.symbol
         : "AAPL";
   const normalizedTicker = attemptedTicker.trim().toLowerCase();
-  // This demo falls back to AAPL when no ticker-like value is available.
+  // This demo maps empty input and the "apple" alias to AAPL.
   const ticker =
     normalizedTicker === ""
       ? "AAPL"
@@ -162,13 +168,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(intentionallyMalformedArgs);
+  wrappedOutput = await wrappedStockQuote.invoke(demoMalformedInput);
 } catch (error) {
-  const context = `tool=stock_quote args=${JSON.stringify(intentionallyMalformedArgs)}`;
+  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);
@@ -181,9 +197,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"; intentionallyMalformedArgs uses
+    // "stock_price" should be "stock_quote"; demoMalformedInput uses
     // "symbol"/"NASDAQ" instead of schema-valid stock_quote args.
-    calls: [{ tool: "stock_price", args: intentionallyMalformedArgs }],
+    calls: [{ tool: "stock_price", args: demoMalformedInput }],
     repair: repairDemoStockCall,
   });
 } catch (error) {
@@ -240,12 +256,13 @@ const repairedCall =
 
 const report = {
   wrappedTool: {
-    before: intentionallyMalformedArgs,
+    before: demoMalformedInput,
     after: wrappedOutput,
   },
   reliableToolCalls: {
-    before: { tool: "stock_price", args: intentionallyMalformedArgs },
+    before: { tool: "stock_price", args: demoMalformedInput },
     repaired: repairedCall,
+    // Optional validation/repair metadata; null means this run returned none.
     diagnostics: reliableResult?.diagnostics ?? null,
   },
   gatewayRepair: gatewayRepairResult,