@stackfactor/agent-utils 1.3.1 → 1.3.2

package/dist/cjs/langChain.d.ts

@@ -20,6 +20,29 @@ export type UsageTracker = {
         title?: string;
     }[];
 };
+/**
+ * Instantiates and returns the appropriate LangChain chat model based on the model
+ * name prefix. `claude-` maps to `ChatAnthropic`, `gemini-` maps to
+ * `ChatGoogleGenerativeAI`, and `gpt-` maps to `ChatOpenAI`. DeepSeek (`deepseek-`),
+ * Kimi/Moonshot (`kimi-`, `moonshot-`), and GLM/Zhipu (`glm-`) models are routed
+ * through `ChatOpenAI` against each provider's OpenAI-compatible endpoint. When a Zod
+ * `schema` is provided, native structured output is configured per provider: OpenAI
+ * via `response_format` with `json_schema`, Anthropic via `output_config.format`, and
+ * Gemini via JSON mode (`json: true`) plus `responseSchema`. In every case the model
+ * emits JSON as the message text, so the caller's parse/validate pipeline is unchanged.
+ * The schema is ignored for the OpenAI-compatible providers (DeepSeek/Kimi/GLM), which
+ * have no native structured-output support here. Throws a `BAD_REQUEST` error for
+ * unrecognised model names.
+ * @param modelName - The model identifier, e.g. `"gpt-4o"`, `"claude-3-5-sonnet"`,
+ *   `"gemini-1.5-pro"`, `"deepseek-chat"`, `"kimi-k2-0905-preview"`, `"glm-4.6"`
+ * @param config - Configuration object containing API keys (`openAIAPIKey`,
+ *   `anthropicAPIKey`, `googleAPIKey`, `deepSeekAPIKey`, `kimiAPIKey`, `glmAPIKey`),
+ *   optional `maxTokens`, and optional `temperature`
+ * @param schema - Optional Zod schema used to configure native structured JSON output
+ *   for GPT / Claude / Gemini models; ignored for OpenAI-compatible providers
+ * @returns A configured LangChain chat model (or bound runnable) instance
+ */
+export declare const getLLMModel: (modelName: string, config: any, schema?: any) => any;
 declare const _default: {
     checkIfAIProviderConfigured: (config: any) => void;
     createAgent: (name: string, modelName: string, systemPrompt: string, tools: any[], responseFormat: any, config: any, usageTracker?: UsageTracker | null) => any;

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;;0CAE2C,GAAG,KAAG,IAAI;wBA6uB/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;sDA0tBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;0CApgC8B,GAAG,KAAG,MAAM;+CA1tB9C,YAAY,GAAG,IAAI,GAAG,SAAS,aAC7B,MAAM,kBACD,MAAM,UACd,GAAG,KACV,IAAI;mCA0uBU,MAAM,mBACJ,MAAM,EAAE,KACxB,MAAM;;AA2iCT,wBASE"}
+{"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;AA2lBF;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,eAAO,MAAM,WAAW,GACtB,WAAW,MAAM,EACjB,QAAQ,GAAG,EACX,SAAQ,GAAU,KACjB,GAoHF,CAAC;;0CAzuB2C,GAAG,KAAG,IAAI;wBA4vB/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;sDA0tBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;0CApgC8B,GAAG,KAAG,MAAM;+CAzuB9C,YAAY,GAAG,IAAI,GAAG,SAAS,aAC7B,MAAM,kBACD,MAAM,UACd,GAAG,KACV,IAAI;mCAyvBU,MAAM,mBACJ,MAAM,EAAE,KACxB,MAAM;;AA2iCT,wBASE"}

package/dist/cjs/langChain.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLLMModel = void 0;
 const openai_1 = require("@langchain/openai");
 const anthropic_1 = require("@langchain/anthropic");
 const google_genai_1 = require("@langchain/google-genai");
@@ -655,6 +656,8 @@ const extractTextContent = (content) => {
  *   for GPT / Claude / Gemini models; ignored for OpenAI-compatible providers
  * @returns A configured LangChain chat model (or bound runnable) instance
  */
+// Exported (but not re-exported from index.ts / the package's public entry
+// point) solely so unit tests can import it directly from source.
 const getLLMModel = (modelName, config, schema = null) => {
     // Resolve `temperature` with presence/support/range handling (see
     // resolveTemperatureSetting). Applied uniformly to every provider below.
@@ -724,11 +727,20 @@ const getLLMModel = (modelName, config, schema = null) => {
             modelName: modelName,
             ...modelSettings,
         };
+        // gpt-5.6's /v1/chat/completions endpoint 400s whenever function tools are
+        // bound, because it rejects the model's own server-side default reasoning
+        // effort in that combination ("use /v1/responses or set reasoning_effort
+        // to 'none'"); forcing it to "none" here avoids the collision. Scoped to
+        // exactly gpt-5.6 — sibling gpt-5.x models are not confirmed to share the
+        // bug.
+        const reasoningEffortOverride = modelName === "gpt-5.6" ? { reasoning_effort: "none" } : {};
         // Use native structured output with a JSON schema. `modelKwargs` is spread
-        // verbatim into the Chat Completions request.
+        // verbatim into the Chat Completions request. Merge (not overwrite) with
+        // the reasoning-effort override above, since both may apply at once.
         if (schema) {
             const jsonSchema = strictifyJsonSchema(buildJsonSchema(schema));
             openAISettings.modelKwargs = {
+                ...reasoningEffortOverride,
                 response_format: {
                     type: "json_schema",
                     json_schema: {
@@ -739,6 +751,9 @@ const getLLMModel = (modelName, config, schema = null) => {
                 },
             };
         }
+        else if (Object.keys(reasoningEffortOverride).length > 0) {
+            openAISettings.modelKwargs = { ...reasoningEffortOverride };
+        }
         return new openai_1.ChatOpenAI(openAISettings);
     }
     // OpenAI-compatible providers: DeepSeek, Kimi (Moonshot), GLM (Zhipu)
@@ -754,6 +769,7 @@ const getLLMModel = (modelName, config, schema = null) => {
     }
     throw errorHandling_js_1.default.create(const_js_1.default.HTTP_CODES.BAD_REQUEST, const_js_1.default.ERROR.UNSUPPORTED_MODEL + ": " + modelName);
 };
+exports.getLLMModel = getLLMModel;
 /**
  * Constructs a LangChain agent configured with a specified model, system prompt, and
  * set of tools.
@@ -783,7 +799,7 @@ const createAgent = (name, modelName, systemPrompt, tools = [], responseFormat,
     }
     const agent = (0, langchain_1.createAgent)({
         name: name,
-        model: getLLMModel(modelName, config),
+        model: (0, exports.getLLMModel)(modelName, config),
         systemPrompt: systemPrompt.trim(),
         tools: tavilyTools.length > 0 ? [...tools, ...tavilyTools] : tools,
         ...(responseFormat ? { responseFormat: responseFormat } : {}),
@@ -1246,7 +1262,7 @@ const runPromptWithModel = async (modelName, config, prompt, onProgressReport, m
     if (onProgressReport) {
         // Streaming mode: use server-side chunk-based progress for all models
         const useNativeSchema = expectsJsonResponse && !!schema && supportsNativeSchema(modelName);
-        const llm = getLLMModel(modelName, config, useNativeSchema ? schema : null);
+        const llm = (0, exports.getLLMModel)(modelName, config, useNativeSchema ? schema : null);
         // Build messages with JSON instructions if needed
         let messagesToSend;
         if (expectsJsonResponse) {
@@ -1395,7 +1411,7 @@ const runPromptWithModel = async (modelName, config, prompt, onProgressReport, m
         // supports it (OpenAI/Anthropic/Gemini); otherwise fall back to prompt
         // instructions + validation retry.
         const useNativeSchema = expectsJsonResponse && !!schema && supportsNativeSchema(modelName);
-        const llm = getLLMModel(modelName, config, useNativeSchema ? schema : null);
+        const llm = (0, exports.getLLMModel)(modelName, config, useNativeSchema ? schema : null);
         // Add escape instruction to help LLM produce valid JSON (only if expecting JSON).
         // When native structured output is in use the model is already constrained,
         // so a light instruction suffices and the schema is not re-injected.

package/dist/esm/langChain.d.ts

@@ -20,6 +20,29 @@ export type UsageTracker = {
         title?: string;
     }[];
 };
+/**
+ * Instantiates and returns the appropriate LangChain chat model based on the model
+ * name prefix. `claude-` maps to `ChatAnthropic`, `gemini-` maps to
+ * `ChatGoogleGenerativeAI`, and `gpt-` maps to `ChatOpenAI`. DeepSeek (`deepseek-`),
+ * Kimi/Moonshot (`kimi-`, `moonshot-`), and GLM/Zhipu (`glm-`) models are routed
+ * through `ChatOpenAI` against each provider's OpenAI-compatible endpoint. When a Zod
+ * `schema` is provided, native structured output is configured per provider: OpenAI
+ * via `response_format` with `json_schema`, Anthropic via `output_config.format`, and
+ * Gemini via JSON mode (`json: true`) plus `responseSchema`. In every case the model
+ * emits JSON as the message text, so the caller's parse/validate pipeline is unchanged.
+ * The schema is ignored for the OpenAI-compatible providers (DeepSeek/Kimi/GLM), which
+ * have no native structured-output support here. Throws a `BAD_REQUEST` error for
+ * unrecognised model names.
+ * @param modelName - The model identifier, e.g. `"gpt-4o"`, `"claude-3-5-sonnet"`,
+ *   `"gemini-1.5-pro"`, `"deepseek-chat"`, `"kimi-k2-0905-preview"`, `"glm-4.6"`
+ * @param config - Configuration object containing API keys (`openAIAPIKey`,
+ *   `anthropicAPIKey`, `googleAPIKey`, `deepSeekAPIKey`, `kimiAPIKey`, `glmAPIKey`),
+ *   optional `maxTokens`, and optional `temperature`
+ * @param schema - Optional Zod schema used to configure native structured JSON output
+ *   for GPT / Claude / Gemini models; ignored for OpenAI-compatible providers
+ * @returns A configured LangChain chat model (or bound runnable) instance
+ */
+export declare const getLLMModel: (modelName: string, config: any, schema?: any) => any;
 declare const _default: {
     checkIfAIProviderConfigured: (config: any) => void;
     createAgent: (name: string, modelName: string, systemPrompt: string, tools: any[], responseFormat: any, config: any, usageTracker?: UsageTracker | null) => any;

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;;0CAE2C,GAAG,KAAG,IAAI;wBA6uB/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;sDA0tBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;0CApgC8B,GAAG,KAAG,MAAM;+CA1tB9C,YAAY,GAAG,IAAI,GAAG,SAAS,aAC7B,MAAM,kBACD,MAAM,UACd,GAAG,KACV,IAAI;mCA0uBU,MAAM,mBACJ,MAAM,EAAE,KACxB,MAAM;;AA2iCT,wBASE"}
+{"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;AA2lBF;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,eAAO,MAAM,WAAW,GACtB,WAAW,MAAM,EACjB,QAAQ,GAAG,EACX,SAAQ,GAAU,KACjB,GAoHF,CAAC;;0CAzuB2C,GAAG,KAAG,IAAI;wBA4vB/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;sDA0tBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;0CApgC8B,GAAG,KAAG,MAAM;+CAzuB9C,YAAY,GAAG,IAAI,GAAG,SAAS,aAC7B,MAAM,kBACD,MAAM,UACd,GAAG,KACV,IAAI;mCAyvBU,MAAM,mBACJ,MAAM,EAAE,KACxB,MAAM;;AA2iCT,wBASE"}

package/dist/esm/langChain.js

@@ -650,7 +650,9 @@ const extractTextContent = (content) => {
  *   for GPT / Claude / Gemini models; ignored for OpenAI-compatible providers
  * @returns A configured LangChain chat model (or bound runnable) instance
  */
-const getLLMModel = (modelName, config, schema = null) => {
+// Exported (but not re-exported from index.ts / the package's public entry
+// point) solely so unit tests can import it directly from source.
+export const getLLMModel = (modelName, config, schema = null) => {
     // Resolve `temperature` with presence/support/range handling (see
     // resolveTemperatureSetting). Applied uniformly to every provider below.
     const modelSettings = resolveTemperatureSetting(modelName, config);
@@ -719,11 +721,20 @@ const getLLMModel = (modelName, config, schema = null) => {
             modelName: modelName,
             ...modelSettings,
         };
+        // gpt-5.6's /v1/chat/completions endpoint 400s whenever function tools are
+        // bound, because it rejects the model's own server-side default reasoning
+        // effort in that combination ("use /v1/responses or set reasoning_effort
+        // to 'none'"); forcing it to "none" here avoids the collision. Scoped to
+        // exactly gpt-5.6 — sibling gpt-5.x models are not confirmed to share the
+        // bug.
+        const reasoningEffortOverride = modelName === "gpt-5.6" ? { reasoning_effort: "none" } : {};
         // Use native structured output with a JSON schema. `modelKwargs` is spread
-        // verbatim into the Chat Completions request.
+        // verbatim into the Chat Completions request. Merge (not overwrite) with
+        // the reasoning-effort override above, since both may apply at once.
         if (schema) {
             const jsonSchema = strictifyJsonSchema(buildJsonSchema(schema));
             openAISettings.modelKwargs = {
+                ...reasoningEffortOverride,
                 response_format: {
                     type: "json_schema",
                     json_schema: {
@@ -734,6 +745,9 @@ const getLLMModel = (modelName, config, schema = null) => {
                 },
             };
         }
+        else if (Object.keys(reasoningEffortOverride).length > 0) {
+            openAISettings.modelKwargs = { ...reasoningEffortOverride };
+        }
         return new ChatOpenAI(openAISettings);
     }
     // OpenAI-compatible providers: DeepSeek, Kimi (Moonshot), GLM (Zhipu)

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -14,6 +14,7 @@
   "scripts": {
     "clean": "rm -rf dist",
     "build": "npm run clean && tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json && echo '{\"type\":\"module\"}' > dist/esm/package.json",
+    "test": "npm run build && node --test \"test/**/*.test.js\"",
     "work:start": "bash scripts/work-start.sh",
     "work:commit": "bash scripts/work-commit.sh",
     "work:release": "bash scripts/release.sh",
@@ -62,6 +63,7 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
+    "@langchain/core": "^1.2.9",
     "typescript": "^5.9.3"
   }
 }