@stackfactor/agent-utils 1.4.0 → 1.4.1

package/dist/cjs/langChain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"langChain.d.ts","sourceRoot":"","sources":["../../src/langChain.ts"],"names":[],"mappings":"AA4GA;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACvC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACtD,CAAC;AAkoBF;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,eAAO,MAAM,WAAW,GACtB,WAAW,MAAM,EACjB,QAAQ,GAAG,EACX,SAAQ,GAAU,KACjB,GAoHF,CAAC;;0CAhxB2C,GAAG,KAAG,IAAI;wBAmyB/C,MAAM,aACD,MAAM,gBACH,MAAM,SACb,GAAG,EAAE,kBACI,GAAG,UACX,GAAG,iBACG,YAAY,GAAG,IAAI,KAChC,GAAG;sBAoCG,GAAG,UACF,MAAM,UACN,GAAG,eACC,QAAQ,GAAG,IAAI,iBACb,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;oCAkYF,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,eACT,MAAM,eACN,MAAM,wBACG,OAAO,WACpB,GAAG,cACA,MAAM,UACV,GAAG,EAAE,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;sDA2tBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;sDAmTF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;0CA7zC8B,GAAG,KAAG,MAAM;+CA/wB9C,YAAY,GAAG,IAAI,GAAG,SAAS,aAC7B,MAAM,kBACD,MAAM,UACd,GAAG,KACV,IAAI;mCA+xBU,MAAM,mBACJ,MAAM,EAAE,KACxB,MAAM;;AAg2CT,wBAUE"}
+{"version":3,"file":"langChain.d.ts","sourceRoot":"","sources":["../../src/langChain.ts"],"names":[],"mappings":"AA4GA;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACvC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACtD,CAAC;AAmrBF;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,eAAO,MAAM,WAAW,GACtB,WAAW,MAAM,EACjB,QAAQ,GAAG,EACX,SAAQ,GAAU,KACjB,GAoHF,CAAC;;0CAj0B2C,GAAG,KAAG,IAAI;wBAo1B/C,MAAM,aACD,MAAM,gBACH,MAAM,SACb,GAAG,EAAE,kBACI,GAAG,UACX,GAAG,iBACG,YAAY,GAAG,IAAI,KAChC,GAAG;sBAoCG,GAAG,UACF,MAAM,UACN,GAAG,eACC,QAAQ,GAAG,IAAI,iBACb,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;oCAkYF,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,eACT,MAAM,eACN,MAAM,wBACG,OAAO,WACpB,GAAG,cACA,MAAM,UACV,GAAG,EAAE,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;sDA2tBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;sDAmTF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;0CA7zC8B,GAAG,KAAG,MAAM;+CAh0B9C,YAAY,GAAG,IAAI,GAAG,SAAS,aAC7B,MAAM,kBACD,MAAM,UACd,GAAG,KACV,IAAI;mCAg1BU,MAAM,mBACJ,MAAM,EAAE,KACxB,MAAM;;AAg2CT,wBAUE"}

package/dist/cjs/langChain.js

@@ -643,6 +643,46 @@ const resolveTemperatureSetting = (modelName, config) => {
     }
     return { temperature: clamped };
 };
+/**
+ * Gemini's ceiling on `maxOutputTokens`. The API validates the field and
+ * rejects the request outright rather than clamping it:
+ * "Unable to submit request because it has a maxOutputTokens value of N but the
+ * supported range is from 1 (inclusive) to 65537 (exclusive)" (HTTP 400,
+ * INVALID_ARGUMENT).
+ *
+ * Set to 64000 rather than that 65536 validation ceiling: the Pro models report
+ * a generation capacity of 64000, so 64000 is the value every model across the
+ * Gemini 3 line (3.1 Pro, 3.5/3.7/3.8 Flash) can both accept and actually
+ * produce. One safe constant beats a per-model table that would need editing
+ * every time Google ships a model — and the 1536 tokens of headroom given up on
+ * Flash are far beyond what any caller asks for.
+ *
+ * Deliberately Gemini-only. Anthropic and OpenAI take the caller's `maxTokens`
+ * unchanged, since neither rejects the values configured today.
+ */
+const GEMINI_MAX_OUTPUT_TOKENS = 64000;
+/**
+ * Resolves `maxOutputTokens` for a Gemini model. Callers share one `maxTokens`
+ * setting across every provider, and the other providers tolerate values far
+ * above what Gemini accepts, so anything above Gemini's ceiling is clamped here
+ * (with a warning) instead of being sent through to a guaranteed HTTP 400. With
+ * no caller value the ceiling itself is used, which is what the previous
+ * 200000 default was reaching for.
+ * @param modelName - The Gemini model identifier being routed
+ * @param config - Configuration object; only `maxTokens` is consulted
+ * @returns A token count within Gemini's supported range
+ */
+const resolveGeminiMaxOutputTokens = (modelName, config) => {
+    const maxTokens = config?.maxTokens;
+    if (typeof maxTokens !== "number" || !Number.isFinite(maxTokens)) {
+        return GEMINI_MAX_OUTPUT_TOKENS;
+    }
+    if (maxTokens > GEMINI_MAX_OUTPUT_TOKENS) {
+        logger_js_1.default.log(null, logger_js_1.default.levels.warn, `maxTokens ${maxTokens} exceeds the ${GEMINI_MAX_OUTPUT_TOKENS}-token output ceiling of "${modelName}"; clamping to ${GEMINI_MAX_OUTPUT_TOKENS}.`);
+        return GEMINI_MAX_OUTPUT_TOKENS;
+    }
+    return maxTokens;
+};
 /**
  * Flattens LangChain message content into plain text. Content is a string for
  * ordinary completions, but providers switch to an array of blocks whenever the
@@ -734,7 +774,7 @@ const getLLMModel = (modelName, config, schema = null) => {
     else if (modelName.startsWith("gemini-")) {
         const model = new google_genai_1.ChatGoogleGenerativeAI({
             apiKey: config.googleAPIKey,
-            maxOutputTokens: config.maxTokens || 200000,
+            maxOutputTokens: resolveGeminiMaxOutputTokens(modelName, config),
             model: modelName,
             // `json: true` forces responseMimeType=application/json, guaranteeing the
             // model returns valid JSON text (never prose) for the parse pipeline.

package/dist/esm/langChain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"langChain.d.ts","sourceRoot":"","sources":["../../src/langChain.ts"],"names":[],"mappings":"AA4GA;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACvC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACtD,CAAC;AAkoBF;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,eAAO,MAAM,WAAW,GACtB,WAAW,MAAM,EACjB,QAAQ,GAAG,EACX,SAAQ,GAAU,KACjB,GAoHF,CAAC;;0CAhxB2C,GAAG,KAAG,IAAI;wBAmyB/C,MAAM,aACD,MAAM,gBACH,MAAM,SACb,GAAG,EAAE,kBACI,GAAG,UACX,GAAG,iBACG,YAAY,GAAG,IAAI,KAChC,GAAG;sBAoCG,GAAG,UACF,MAAM,UACN,GAAG,eACC,QAAQ,GAAG,IAAI,iBACb,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;oCAkYF,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,eACT,MAAM,eACN,MAAM,wBACG,OAAO,WACpB,GAAG,cACA,MAAM,UACV,GAAG,EAAE,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;sDA2tBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;sDAmTF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;0CA7zC8B,GAAG,KAAG,MAAM;+CA/wB9C,YAAY,GAAG,IAAI,GAAG,SAAS,aAC7B,MAAM,kBACD,MAAM,UACd,GAAG,KACV,IAAI;mCA+xBU,MAAM,mBACJ,MAAM,EAAE,KACxB,MAAM;;AAg2CT,wBAUE"}
+{"version":3,"file":"langChain.d.ts","sourceRoot":"","sources":["../../src/langChain.ts"],"names":[],"mappings":"AA4GA;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACvC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACtD,CAAC;AAmrBF;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,eAAO,MAAM,WAAW,GACtB,WAAW,MAAM,EACjB,QAAQ,GAAG,EACX,SAAQ,GAAU,KACjB,GAoHF,CAAC;;0CAj0B2C,GAAG,KAAG,IAAI;wBAo1B/C,MAAM,aACD,MAAM,gBACH,MAAM,SACb,GAAG,EAAE,kBACI,GAAG,UACX,GAAG,iBACG,YAAY,GAAG,IAAI,KAChC,GAAG;sBAoCG,GAAG,UACF,MAAM,UACN,GAAG,eACC,QAAQ,GAAG,IAAI,iBACb,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;oCAkYF,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,eACT,MAAM,eACN,MAAM,wBACG,OAAO,WACpB,GAAG,cACA,MAAM,UACV,GAAG,EAAE,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;sDA2tBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;sDAmTF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;0CA7zC8B,GAAG,KAAG,MAAM;+CAh0B9C,YAAY,GAAG,IAAI,GAAG,SAAS,aAC7B,MAAM,kBACD,MAAM,UACd,GAAG,KACV,IAAI;mCAg1BU,MAAM,mBACJ,MAAM,EAAE,KACxB,MAAM;;AAg2CT,wBAUE"}

package/dist/esm/langChain.js

@@ -637,6 +637,46 @@ const resolveTemperatureSetting = (modelName, config) => {
     }
     return { temperature: clamped };
 };
+/**
+ * Gemini's ceiling on `maxOutputTokens`. The API validates the field and
+ * rejects the request outright rather than clamping it:
+ * "Unable to submit request because it has a maxOutputTokens value of N but the
+ * supported range is from 1 (inclusive) to 65537 (exclusive)" (HTTP 400,
+ * INVALID_ARGUMENT).
+ *
+ * Set to 64000 rather than that 65536 validation ceiling: the Pro models report
+ * a generation capacity of 64000, so 64000 is the value every model across the
+ * Gemini 3 line (3.1 Pro, 3.5/3.7/3.8 Flash) can both accept and actually
+ * produce. One safe constant beats a per-model table that would need editing
+ * every time Google ships a model — and the 1536 tokens of headroom given up on
+ * Flash are far beyond what any caller asks for.
+ *
+ * Deliberately Gemini-only. Anthropic and OpenAI take the caller's `maxTokens`
+ * unchanged, since neither rejects the values configured today.
+ */
+const GEMINI_MAX_OUTPUT_TOKENS = 64000;
+/**
+ * Resolves `maxOutputTokens` for a Gemini model. Callers share one `maxTokens`
+ * setting across every provider, and the other providers tolerate values far
+ * above what Gemini accepts, so anything above Gemini's ceiling is clamped here
+ * (with a warning) instead of being sent through to a guaranteed HTTP 400. With
+ * no caller value the ceiling itself is used, which is what the previous
+ * 200000 default was reaching for.
+ * @param modelName - The Gemini model identifier being routed
+ * @param config - Configuration object; only `maxTokens` is consulted
+ * @returns A token count within Gemini's supported range
+ */
+const resolveGeminiMaxOutputTokens = (modelName, config) => {
+    const maxTokens = config?.maxTokens;
+    if (typeof maxTokens !== "number" || !Number.isFinite(maxTokens)) {
+        return GEMINI_MAX_OUTPUT_TOKENS;
+    }
+    if (maxTokens > GEMINI_MAX_OUTPUT_TOKENS) {
+        logger.log(null, logger.levels.warn, `maxTokens ${maxTokens} exceeds the ${GEMINI_MAX_OUTPUT_TOKENS}-token output ceiling of "${modelName}"; clamping to ${GEMINI_MAX_OUTPUT_TOKENS}.`);
+        return GEMINI_MAX_OUTPUT_TOKENS;
+    }
+    return maxTokens;
+};
 /**
  * Flattens LangChain message content into plain text. Content is a string for
  * ordinary completions, but providers switch to an array of blocks whenever the
@@ -728,7 +768,7 @@ export const getLLMModel = (modelName, config, schema = null) => {
     else if (modelName.startsWith("gemini-")) {
         const model = new ChatGoogleGenerativeAI({
             apiKey: config.googleAPIKey,
-            maxOutputTokens: config.maxTokens || 200000,
+            maxOutputTokens: resolveGeminiMaxOutputTokens(modelName, config),
             model: modelName,
             // `json: true` forces responseMimeType=application/json, guaranteeing the
             // model returns valid JSON text (never prose) for the parse pipeline.

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",