@stackfactor/agent-utils 1.0.12 → 1.0.14

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

@@ -1 +1 @@
-{"version":3,"file":"langChain.d.ts","sourceRoot":"","sources":["../../src/langChain.ts"],"names":[],"mappings":";wBAkSQ,MAAM,aACD,MAAM,gBACH,MAAM,SACb,GAAG,EAAE,kBACI,GAAG,UACX,GAAG,KACV,GAAG;sBAyBG,GAAG,UACF,MAAM,UACN,GAAG,eACC,QAAQ,GAAG,IAAI,KAC1B,OAAO,CAAC,GAAG,CAAC;wCAufF,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,KACpB,GAAG;oCA5YO,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,eACT,MAAM,eACN,MAAM,wBACG,OAAO,WACpB,GAAG,cACA,MAAM,UACV,GAAG,EAAE,KACX,OAAO,CAAC,GAAG,CAAC;sDAisBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,KACX,OAAO,CAAC,GAAG,CAAC;0CAjwB8B,GAAG,KAAG,MAAM;;AA4zBzD,wBAOE"}
+{"version":3,"file":"langChain.d.ts","sourceRoot":"","sources":["../../src/langChain.ts"],"names":[],"mappings":";wBAmVQ,MAAM,aACD,MAAM,gBACH,MAAM,SACb,GAAG,EAAE,kBACI,GAAG,UACX,GAAG,KACV,GAAG;sBAyBG,GAAG,UACF,MAAM,UACN,GAAG,eACC,QAAQ,GAAG,IAAI,KAC1B,OAAO,CAAC,GAAG,CAAC;wCAmfF,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,KACpB,GAAG;oCAxYO,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,eACT,MAAM,eACN,MAAM,wBACG,OAAO,WACpB,GAAG,cACA,MAAM,UACV,GAAG,EAAE,KACX,OAAO,CAAC,GAAG,CAAC;sDA6rBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,KACX,OAAO,CAAC,GAAG,CAAC;0CA7vB8B,GAAG,KAAG,MAAM;;AAwzBzD,wBAOE"}

package/dist/cjs/langChain.js

@@ -27,34 +27,36 @@ Do NOT include raw newlines, tabs, or unescaped quotes inside JSON string values
  * Each failing field is described with its dot-notation path and a contextual message
  * that depends on the Zod error code (e.g. `invalid_type`, `too_small`, `invalid_enum_value`).
  * The output is prefixed with `"Schema validation failed:"` followed by a bulleted list.
- * @param zodError - The Zod `ZodError` instance whose `errors` array will be formatted
+ * @param zodError - The Zod `ZodError` instance whose `issues` array will be formatted
  * @returns A formatted string describing all validation failures
  */
 const formatZodErrors = (zodError) => {
-    const errors = zodError.errors.map((err) => {
-        const path = err.path.length > 0 ? err.path.join(".") : "root";
-        // Provide more context based on error type
-        switch (err.code) {
-            case "invalid_type":
-                return `Field "${path}": Expected ${err.expected}, but received ${err.received}`;
-            case "invalid_literal":
-                return `Field "${path}": Expected literal value ${JSON.stringify(err.expected)}, but received ${JSON.stringify(err.received)}`;
-            case "unrecognized_keys":
-                return `Field "${path}": Unrecognized keys: ${err.keys.join(", ")}`;
-            case "invalid_union":
-                return `Field "${path}": Invalid union - none of the expected types matched`;
-            case "invalid_enum_value":
-                return `Field "${path}": Invalid enum value. Expected one of: ${err.options.join(", ")}`;
-            case "invalid_string":
-                return `Field "${path}": Invalid string format (${err.validation})`;
-            case "too_small":
-                return `Field "${path}": Value is too small (minimum: ${err.minimum})`;
-            case "too_big":
-                return `Field "${path}": Value is too large (maximum: ${err.maximum})`;
-            default:
-                return `Field "${path}": ${err.message}`;
-        }
-    });
+    const errors = zodError.issues
+        ? zodError.issues.map((err) => {
+            const path = err.path.length > 0 ? err.path.join(".") : "root";
+            // Provide more context based on error type
+            switch (err.code) {
+                case "invalid_type":
+                    return `Field "${path}": Expected ${err.expected}, but received ${err.received}`;
+                case "invalid_literal":
+                    return `Field "${path}": Expected literal value ${JSON.stringify(err.expected)}, but received ${JSON.stringify(err.received)}`;
+                case "unrecognized_keys":
+                    return `Field "${path}": Unrecognized keys: ${err.keys.join(", ")}`;
+                case "invalid_union":
+                    return `Field "${path}": Invalid union - none of the expected types matched`;
+                case "invalid_enum_value":
+                    return `Field "${path}": Invalid enum value. Expected one of: ${err.options.join(", ")}`;
+                case "invalid_string":
+                    return `Field "${path}": Invalid string format (${err.validation})`;
+                case "too_small":
+                    return `Field "${path}": Value is too small (minimum: ${err.minimum})`;
+                case "too_big":
+                    return `Field "${path}": Value is too large (maximum: ${err.maximum})`;
+                default:
+                    return `Field "${path}": ${err.message}`;
+            }
+        })
+        : [];
     return `Schema validation failed:\n  - ${errors.join("\n  - ")}`;
 };
 /**
@@ -189,17 +191,50 @@ const extractJSONFromResponse = (text) => {
     }
     return null;
 };
+/**
+ * Maps a model name prefix to its OpenAI-compatible provider configuration. DeepSeek,
+ * Kimi (Moonshot), and GLM (Zhipu) all expose OpenAI-compatible chat completion APIs
+ * and can be routed through `ChatOpenAI` with a custom base URL and API key.
+ * @param modelName - The model identifier to inspect
+ * @param config - Configuration object containing provider-specific API keys
+ * @returns An object with `apiKey` and `baseURL` when the model matches a known
+ *   OpenAI-compatible provider, or `null` otherwise
+ */
+const getOpenAICompatibleProvider = (modelName, config) => {
+    if (modelName.startsWith("deepseek-")) {
+        return {
+            apiKey: config.deepSeekAPIKey,
+            baseURL: "https://api.deepseek.com/v1",
+        };
+    }
+    if (modelName.startsWith("kimi-") || modelName.startsWith("moonshot-")) {
+        return {
+            apiKey: config.kimiAPIKey,
+            baseURL: "https://api.moonshot.ai/v1",
+        };
+    }
+    if (modelName.startsWith("glm-")) {
+        return {
+            apiKey: config.glmAPIKey,
+            baseURL: "https://open.bigmodel.cn/api/paas/v4/",
+        };
+    }
+    return null;
+};
 /**
  * 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`. When a Zod `schema` is
- * provided for a GPT model, native `response_format` with `json_schema` is configured
- * on the OpenAI instance for structured output. Throws a `BAD_REQUEST` error for
- * unrecognised model names.
+ * `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 for a GPT model, native `response_format` with `json_schema` is
+ * configured for structured output. 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"`
+ *   `"gemini-1.5-pro"`, `"deepseek-chat"`, `"kimi-k2-0905-preview"`, `"glm-4.6"`
  * @param config - Configuration object containing API keys (`openAIAPIKey`,
- *   `anthropicAPIKey`, `googleAPIKey`), optional `maxTokens`, and optional `temperature`
+ *   `anthropicAPIKey`, `googleAPIKey`, `deepSeekAPIKey`, `kimiAPIKey`, `glmAPIKey`),
+ *   optional `maxTokens`, and optional `temperature`
  * @param schema - Optional Zod schema used to configure structured JSON output for
  *   OpenAI GPT models via `response_format`; ignored for other providers
  * @returns A configured LangChain chat model instance
@@ -250,6 +285,17 @@ const getLLMModel = (modelName, config, schema = null) => {
         }
         return new openai_1.ChatOpenAI(openAISettings);
     }
+    // OpenAI-compatible providers: DeepSeek, Kimi (Moonshot), GLM (Zhipu)
+    const openAICompatible = getOpenAICompatibleProvider(modelName, config);
+    if (openAICompatible) {
+        return new openai_1.ChatOpenAI({
+            apiKey: openAICompatible.apiKey,
+            maxTokens: config.maxTokens || 200000,
+            modelName: modelName,
+            configuration: { baseURL: openAICompatible.baseURL },
+            ...modelSettings,
+        });
+    }
     throw errorHandling_js_1.default.create(const_js_1.default.HTTP_CODES.BAD_REQUEST, const_js_1.default.ERROR.UNSUPPORTED_MODEL + ": " + modelName);
 };
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"langChain.d.ts","sourceRoot":"","sources":["../../src/langChain.ts"],"names":[],"mappings":";wBAkSQ,MAAM,aACD,MAAM,gBACH,MAAM,SACb,GAAG,EAAE,kBACI,GAAG,UACX,GAAG,KACV,GAAG;sBAyBG,GAAG,UACF,MAAM,UACN,GAAG,eACC,QAAQ,GAAG,IAAI,KAC1B,OAAO,CAAC,GAAG,CAAC;wCAufF,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,KACpB,GAAG;oCA5YO,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,eACT,MAAM,eACN,MAAM,wBACG,OAAO,WACpB,GAAG,cACA,MAAM,UACV,GAAG,EAAE,KACX,OAAO,CAAC,GAAG,CAAC;sDAisBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,KACX,OAAO,CAAC,GAAG,CAAC;0CAjwB8B,GAAG,KAAG,MAAM;;AA4zBzD,wBAOE"}
+{"version":3,"file":"langChain.d.ts","sourceRoot":"","sources":["../../src/langChain.ts"],"names":[],"mappings":";wBAmVQ,MAAM,aACD,MAAM,gBACH,MAAM,SACb,GAAG,EAAE,kBACI,GAAG,UACX,GAAG,KACV,GAAG;sBAyBG,GAAG,UACF,MAAM,UACN,GAAG,eACC,QAAQ,GAAG,IAAI,KAC1B,OAAO,CAAC,GAAG,CAAC;wCAmfF,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,KACpB,GAAG;oCAxYO,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,eACT,MAAM,eACN,MAAM,wBACG,OAAO,WACpB,GAAG,cACA,MAAM,UACV,GAAG,EAAE,KACX,OAAO,CAAC,GAAG,CAAC;sDA6rBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,KACX,OAAO,CAAC,GAAG,CAAC;0CA7vB8B,GAAG,KAAG,MAAM;;AAwzBzD,wBAOE"}

package/dist/esm/langChain.js

@@ -22,34 +22,36 @@ Do NOT include raw newlines, tabs, or unescaped quotes inside JSON string values
  * Each failing field is described with its dot-notation path and a contextual message
  * that depends on the Zod error code (e.g. `invalid_type`, `too_small`, `invalid_enum_value`).
  * The output is prefixed with `"Schema validation failed:"` followed by a bulleted list.
- * @param zodError - The Zod `ZodError` instance whose `errors` array will be formatted
+ * @param zodError - The Zod `ZodError` instance whose `issues` array will be formatted
  * @returns A formatted string describing all validation failures
  */
 const formatZodErrors = (zodError) => {
-    const errors = zodError.errors.map((err) => {
-        const path = err.path.length > 0 ? err.path.join(".") : "root";
-        // Provide more context based on error type
-        switch (err.code) {
-            case "invalid_type":
-                return `Field "${path}": Expected ${err.expected}, but received ${err.received}`;
-            case "invalid_literal":
-                return `Field "${path}": Expected literal value ${JSON.stringify(err.expected)}, but received ${JSON.stringify(err.received)}`;
-            case "unrecognized_keys":
-                return `Field "${path}": Unrecognized keys: ${err.keys.join(", ")}`;
-            case "invalid_union":
-                return `Field "${path}": Invalid union - none of the expected types matched`;
-            case "invalid_enum_value":
-                return `Field "${path}": Invalid enum value. Expected one of: ${err.options.join(", ")}`;
-            case "invalid_string":
-                return `Field "${path}": Invalid string format (${err.validation})`;
-            case "too_small":
-                return `Field "${path}": Value is too small (minimum: ${err.minimum})`;
-            case "too_big":
-                return `Field "${path}": Value is too large (maximum: ${err.maximum})`;
-            default:
-                return `Field "${path}": ${err.message}`;
-        }
-    });
+    const errors = zodError.issues
+        ? zodError.issues.map((err) => {
+            const path = err.path.length > 0 ? err.path.join(".") : "root";
+            // Provide more context based on error type
+            switch (err.code) {
+                case "invalid_type":
+                    return `Field "${path}": Expected ${err.expected}, but received ${err.received}`;
+                case "invalid_literal":
+                    return `Field "${path}": Expected literal value ${JSON.stringify(err.expected)}, but received ${JSON.stringify(err.received)}`;
+                case "unrecognized_keys":
+                    return `Field "${path}": Unrecognized keys: ${err.keys.join(", ")}`;
+                case "invalid_union":
+                    return `Field "${path}": Invalid union - none of the expected types matched`;
+                case "invalid_enum_value":
+                    return `Field "${path}": Invalid enum value. Expected one of: ${err.options.join(", ")}`;
+                case "invalid_string":
+                    return `Field "${path}": Invalid string format (${err.validation})`;
+                case "too_small":
+                    return `Field "${path}": Value is too small (minimum: ${err.minimum})`;
+                case "too_big":
+                    return `Field "${path}": Value is too large (maximum: ${err.maximum})`;
+                default:
+                    return `Field "${path}": ${err.message}`;
+            }
+        })
+        : [];
     return `Schema validation failed:\n  - ${errors.join("\n  - ")}`;
 };
 /**
@@ -184,17 +186,50 @@ const extractJSONFromResponse = (text) => {
     }
     return null;
 };
+/**
+ * Maps a model name prefix to its OpenAI-compatible provider configuration. DeepSeek,
+ * Kimi (Moonshot), and GLM (Zhipu) all expose OpenAI-compatible chat completion APIs
+ * and can be routed through `ChatOpenAI` with a custom base URL and API key.
+ * @param modelName - The model identifier to inspect
+ * @param config - Configuration object containing provider-specific API keys
+ * @returns An object with `apiKey` and `baseURL` when the model matches a known
+ *   OpenAI-compatible provider, or `null` otherwise
+ */
+const getOpenAICompatibleProvider = (modelName, config) => {
+    if (modelName.startsWith("deepseek-")) {
+        return {
+            apiKey: config.deepSeekAPIKey,
+            baseURL: "https://api.deepseek.com/v1",
+        };
+    }
+    if (modelName.startsWith("kimi-") || modelName.startsWith("moonshot-")) {
+        return {
+            apiKey: config.kimiAPIKey,
+            baseURL: "https://api.moonshot.ai/v1",
+        };
+    }
+    if (modelName.startsWith("glm-")) {
+        return {
+            apiKey: config.glmAPIKey,
+            baseURL: "https://open.bigmodel.cn/api/paas/v4/",
+        };
+    }
+    return null;
+};
 /**
  * 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`. When a Zod `schema` is
- * provided for a GPT model, native `response_format` with `json_schema` is configured
- * on the OpenAI instance for structured output. Throws a `BAD_REQUEST` error for
- * unrecognised model names.
+ * `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 for a GPT model, native `response_format` with `json_schema` is
+ * configured for structured output. 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"`
+ *   `"gemini-1.5-pro"`, `"deepseek-chat"`, `"kimi-k2-0905-preview"`, `"glm-4.6"`
  * @param config - Configuration object containing API keys (`openAIAPIKey`,
- *   `anthropicAPIKey`, `googleAPIKey`), optional `maxTokens`, and optional `temperature`
+ *   `anthropicAPIKey`, `googleAPIKey`, `deepSeekAPIKey`, `kimiAPIKey`, `glmAPIKey`),
+ *   optional `maxTokens`, and optional `temperature`
  * @param schema - Optional Zod schema used to configure structured JSON output for
  *   OpenAI GPT models via `response_format`; ignored for other providers
  * @returns A configured LangChain chat model instance
@@ -245,6 +280,17 @@ const getLLMModel = (modelName, config, schema = null) => {
         }
         return new ChatOpenAI(openAISettings);
     }
+    // OpenAI-compatible providers: DeepSeek, Kimi (Moonshot), GLM (Zhipu)
+    const openAICompatible = getOpenAICompatibleProvider(modelName, config);
+    if (openAICompatible) {
+        return new ChatOpenAI({
+            apiKey: openAICompatible.apiKey,
+            maxTokens: config.maxTokens || 200000,
+            modelName: modelName,
+            configuration: { baseURL: openAICompatible.baseURL },
+            ...modelSettings,
+        });
+    }
     throw errorHandlingHelper.create(constants.HTTP_CODES.BAD_REQUEST, constants.ERROR.UNSUPPORTED_MODEL + ": " + modelName);
 };
 /**

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "restricted"
   },
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",