@botbotgo/better-call 0.1.45 → 0.1.46

package/package.json

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

package/scripts/demo.mjs

@@ -65,6 +65,8 @@ function exitWithError(step, error) {
   process.exit(1);
 }
 
+// Demo tool definition: validates ticker and market arguments before returning
+// a normalized quote payload. Accepted markets are US, HK, and CN.
 const stockQuote = {
   name: "stock_quote",
   description: "Get a stock quote.",
@@ -100,6 +102,16 @@ const stockQuote = {
 // "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.
+ *
+ * @param {object} [repairInput={}] Optional repair payload that may include
+ *   `calls[0].args`.
+ * @returns {{ tool: string, args: { ticker: string, market: "US" | "HK" | "CN" } }[]}
+ *   A repaired `stock_quote` call with normalized arguments. Ticker input may
+ *   be provided as `ticker` or legacy `symbol`; missing values fall back to
+ *   AAPL, and unsupported markets fall back to US.
+ */
 function repairDemoStockCall(repairInput = {}) {
   const hasUsableArgsShape = (value) =>
     typeof value === "object" &&
@@ -108,7 +120,9 @@ function repairDemoStockCall(repairInput = {}) {
     ("ticker" in value || "symbol" in value || "market" in value);
 
   const attemptedArgs =
-    Array.isArray(repairInput?.calls) && hasUsableArgsShape(repairInput.calls[0]?.args)
+    Array.isArray(repairInput?.calls) &&
+    repairInput.calls.length > 0 &&
+    hasUsableArgsShape(repairInput.calls[0]?.args)
       ? repairInput.calls[0].args
       : intentionallyMalformedArgs;
 
@@ -118,8 +132,7 @@ function repairDemoStockCall(repairInput = {}) {
       : typeof attemptedArgs.symbol === "string"
         ? attemptedArgs.symbol
         : "AAPL";
-  const normalizedTicker =
-    typeof attemptedTicker === "string" ? attemptedTicker.trim().toLowerCase() : "aapl";
+  const normalizedTicker = attemptedTicker.trim().toLowerCase();
   // This demo falls back to AAPL when no ticker-like value is available.
   const ticker =
     normalizedTicker === ""