@gaunt-sloth/core 2.0.0-alpha.2 → 2.0.0-alpha.21

package/dist/providers/anthropic.js

@@ -1,5 +1,6 @@
 import { displayWarning } from '#src/utils/consoleUtils.js';
-import { writeFileIfNotExistsWithMessages } from '#src/utils/fileUtils.js';
+import { writeConfigFileWithMessages } from '#src/utils/fileUtils.js';
+import { buildInitConfigContent, getCuratedFallbackModel } from '#src/providers/modelDiscovery.js';
 import { env } from '#src/utils/systemUtils.js';
 /**
  * Function to process JSON config and create Anthropic LLM instance
@@ -12,22 +13,16 @@ export async function processJsonConfig(llmConfig) {
     return new anthropic.ChatAnthropic({
         ...llmConfig,
         apiKey: anthropicApiKey,
-        model: llmConfig.model || 'claude-sonnet-4-6',
+        model: llmConfig.model || getCuratedFallbackModel('anthropic'),
     });
 }
-const jsonContent = `{
-  "llm": {
-    "type": "anthropic",
-    "model": "claude-sonnet-4-6"
-  }
-}`;
 // noinspection JSUnusedGlobalSymbols
-export function init(configFileName) {
+export function init(configFileName, force = false, model) {
     // Determine which content to use based on file extension
     if (!configFileName.endsWith('.json')) {
         throw new Error('Only JSON config is supported.');
     }
-    writeFileIfNotExistsWithMessages(configFileName, jsonContent);
+    writeConfigFileWithMessages(configFileName, buildInitConfigContent('anthropic', model), force);
     displayWarning(`You need to update your ${configFileName} to add your Anthropic API key, ` +
         'or define ANTHROPIC_API_KEY environment variable.');
 }

package/dist/providers/anthropic.js.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAOhD;;GAEG;AACH,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAA+C;IAE/C,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IACvD,wEAAwE;IACxE,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,iBAAiB,CAAC;IAClE,OAAO,IAAI,SAAS,CAAC,aAAa,CAAC;QACjC,GAAG,SAAS;QACZ,MAAM,EAAE,eAAe;QACvB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,mBAAmB;KAC9C,CAAC,CAAC;AACL,CAAC;AAED,MAAM,WAAW,GAAG;;;;;EAKlB,CAAC;AAEH,qCAAqC;AACrC,MAAM,UAAU,IAAI,CAAC,cAAsB;IACzC,yDAAyD;IACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,gCAAgC,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAC9D,cAAc,CACZ,2BAA2B,cAAc,kCAAkC;QACzE,mDAAmD,CACtD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AACnG,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAOhD;;GAEG;AACH,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAA+C;IAE/C,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IACvD,wEAAwE;IACxE,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,iBAAiB,CAAC;IAClE,OAAO,IAAI,SAAS,CAAC,aAAa,CAAC;QACjC,GAAG,SAAS;QACZ,MAAM,EAAE,eAAe;QACvB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,uBAAuB,CAAC,WAAW,CAAC;KAC/D,CAAC,CAAC;AACL,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,IAAI,CAAC,cAAsB,EAAE,KAAK,GAAG,KAAK,EAAE,KAAc;IACxE,yDAAyD;IACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,2BAA2B,CAAC,cAAc,EAAE,sBAAsB,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/F,cAAc,CACZ,2BAA2B,cAAc,kCAAkC;QACzE,mDAAmD,CACtD,CAAC;AACJ,CAAC"}

package/dist/providers/deepseek.d.ts

@@ -1,4 +1,4 @@
 import type { BaseChatModel, BaseChatModelParams } from '@langchain/core/language_models/chat_models';
 import { ChatDeepSeekInput } from '@langchain/deepseek';
 export declare function processJsonConfig(llmConfig: ChatDeepSeekInput & BaseChatModelParams): Promise<BaseChatModel>;
-export declare function init(configFileName: string): void;
+export declare function init(configFileName: string, force?: boolean, model?: string): void;

package/dist/providers/deepseek.js

@@ -1,6 +1,7 @@
 import { displayWarning } from '#src/utils/consoleUtils.js';
 import { env } from '#src/utils/systemUtils.js';
-import { writeFileIfNotExistsWithMessages } from '#src/utils/fileUtils.js';
+import { writeConfigFileWithMessages } from '#src/utils/fileUtils.js';
+import { buildInitConfigContent, getCuratedFallbackModel } from '#src/providers/modelDiscovery.js';
 // Function to process JSON config and create DeepSeek LLM instance
 export async function processJsonConfig(llmConfig) {
     const deepseek = await import('@langchain/deepseek');
@@ -9,21 +10,15 @@ export async function processJsonConfig(llmConfig) {
     return new deepseek.ChatDeepSeek({
         ...llmConfig,
         apiKey: deepseekApiKey,
-        model: llmConfig.model || 'deepseek-v4-pro',
+        model: llmConfig.model || getCuratedFallbackModel('deepseek'),
     });
 }
-const jsonContent = `{
-  "llm": {
-    "type": "deepseek",
-    "model": "deepseek-v4-pro"
-  }
-}`;
-export function init(configFileName) {
+export function init(configFileName, force = false, model) {
     // Determine which content to use based on file extension
     if (!configFileName.endsWith('.json')) {
         throw new Error('Only JSON config is supported.');
     }
-    writeFileIfNotExistsWithMessages(configFileName, jsonContent);
+    writeConfigFileWithMessages(configFileName, buildInitConfigContent('deepseek', model), force);
     displayWarning(`You need to update your ${configFileName} to add your DeepSeek API key, ` +
         'or define DEEPSEEK_API_KEY environment variable.');
 }

package/dist/providers/deepseek.js.map

@@ -1 +1 @@
-{"version":3,"file":"deepseek.js","sourceRoot":"","sources":["../../src/providers/deepseek.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAOhD,OAAO,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AAE3E,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAkD;IAElD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACrD,yEAAyE;IACzE,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,gBAAgB,CAAC;IAChE,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC;QAC/B,GAAG,SAAS;QACZ,MAAM,EAAE,cAAc;QACtB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,iBAAiB;KAC5C,CAAC,CAAC;AACL,CAAC;AAED,MAAM,WAAW,GAAG;;;;;EAKlB,CAAC;AAEH,MAAM,UAAU,IAAI,CAAC,cAAsB;IACzC,yDAAyD;IACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,gCAAgC,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAC9D,cAAc,CACZ,2BAA2B,cAAc,iCAAiC;QACxE,kDAAkD,CACrD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"deepseek.js","sourceRoot":"","sources":["../../src/providers/deepseek.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAOhD,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAEnG,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAkD;IAElD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACrD,yEAAyE;IACzE,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,gBAAgB,CAAC;IAChE,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC;QAC/B,GAAG,SAAS;QACZ,MAAM,EAAE,cAAc;QACtB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,uBAAuB,CAAC,UAAU,CAAC;KAC9D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,cAAsB,EAAE,KAAK,GAAG,KAAK,EAAE,KAAc;IACxE,yDAAyD;IACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,2BAA2B,CAAC,cAAc,EAAE,sBAAsB,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9F,cAAc,CACZ,2BAA2B,cAAc,iCAAiC;QACxE,kDAAkD,CACrD,CAAC;AACJ,CAAC"}

package/dist/providers/geminiSchemaSanitizer.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @packageDocumentation
+ * GS2-58 — systemic Gemini tool-schema sanitizer at the `@langchain/google` provider boundary.
+ *
+ * Google Gemini's function-declaration schema is a SELECT SUBSET of OpenAPI 3.0. `@langchain/google`'s
+ * own `removeAdditionalProperties` strips only `additionalProperties`, so every other JSON-Schema-draft
+ * keyword the subset does not declare (`exclusiveMinimum`/`exclusiveMaximum`/`multipleOf`, `$defs`,
+ * `patternProperties`, `const`, `$ref`, `allOf`/`oneOf`/`not`, …) is passed straight to the wire, and
+ * Gemini 400s at tool-declaration send time — before any tool runs.
+ *
+ * This is the DURABLE fix (GS2-58, fix-cycle 1): rather than a denylist that is always one unknown
+ * keyword behind, {@link sanitizeGeminiToolSchema} is an ALLOWLIST — it keeps ONLY the fields the
+ * installed Gemini `Schema` type declares and drops everything else, so a future keyword in ANY tool
+ * (built-in, custom, or MCP — including schemas gaunt-sloth does not author) cannot re-break Gemini.
+ *
+ * The allowlist ({@link GEMINI_SUPPORTED_SCHEMA_KEYWORDS}) is derived DIRECTLY from the authoritative
+ * in-repo type — the `Gemini.Tools.Schema` interface in
+ * `node_modules/@langchain/google/dist/chat_models/api-types.d.{ts,cts}` (a `FunctionDeclaration`'s
+ * `parameters?: Schema`), "a select subset of an OpenAPI 3.0 schema object". Keeping it aligned with
+ * that type (not a remembered list) is what prevents a stale allowlist silently over-stripping.
+ *
+ * Scope is the google/gemini provider path ONLY: {@link applyGeminiToolSchemaSanitizer} is wired into
+ * the `google-genai` and `vertexai` presets' `processJsonConfig`. It leaves OpenAI/Anthropic/Ollama
+ * wiring untouched, and does not weaken the GS2-56/57 build-time denylist guard (that test still runs;
+ * this transform runs ahead of the wire send, so a sanitized tool is what Gemini sees).
+ */
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+/**
+ * The EXACT set of schema keywords Gemini's function-declaration schema accepts, transcribed field-
+ * for-field from the `Gemini.Tools.Schema` interface in
+ * `@langchain/google/dist/chat_models/api-types.d.ts`. Anything not in this set is dropped (allowlist).
+ *
+ * Note `anyOf` IS supported (unions / nullable) and MUST survive — only `allOf`/`oneOf`/`not` are
+ * absent from the type and therefore dropped. `exclusiveMinimum`/`exclusiveMaximum` are NOT in the type
+ * either; they are handled specially by rewriting them to `minimum`/`maximum` (see {@link sanitizeNode})
+ * before the allowlist filter runs.
+ */
+export declare const GEMINI_SUPPORTED_SCHEMA_KEYWORDS: ReadonlySet<string>;
+/**
+ * Pure, recursive allowlist normaliser: returns a cleaned DEEP COPY of a JSON-Schema containing only
+ * keywords Gemini's function-declaration `Schema` accepts, so its OpenAPI-3.0 subset accepts the tool.
+ * Does not mutate the input. See {@link sanitizeNode} for the transform; `anyOf` unions survive.
+ */
+export declare function sanitizeGeminiToolSchema<T = unknown>(schema: T): T;
+/**
+ * Wire the sanitizer into a ChatGoogle model at the tool-binding boundary. Overrides the instance's
+ * `bindTools` so every tool passed to it — built-in, custom, or MCP, via `createAgent`/`createDeepAgent`
+ * which both call `model.bindTools(tools)` — is sanitized before it reaches `@langchain/google`'s
+ * Gemini converter. Provider-scoped: only the google-genai/vertexai presets call this, so no other
+ * provider's tools are affected. Returns the same model instance for convenient chaining.
+ */
+export declare function applyGeminiToolSchemaSanitizer<T extends BaseChatModel>(model: T): T;

package/dist/providers/geminiSchemaSanitizer.js

@@ -0,0 +1,201 @@
+import { toJsonSchema } from '@langchain/core/utils/json_schema';
+import { isInteropZodSchema } from '@langchain/core/utils/types';
+import { isSerializableSchema } from '@langchain/core/utils/standard_schema';
+/**
+ * The EXACT set of schema keywords Gemini's function-declaration schema accepts, transcribed field-
+ * for-field from the `Gemini.Tools.Schema` interface in
+ * `@langchain/google/dist/chat_models/api-types.d.ts`. Anything not in this set is dropped (allowlist).
+ *
+ * Note `anyOf` IS supported (unions / nullable) and MUST survive — only `allOf`/`oneOf`/`not` are
+ * absent from the type and therefore dropped. `exclusiveMinimum`/`exclusiveMaximum` are NOT in the type
+ * either; they are handled specially by rewriting them to `minimum`/`maximum` (see {@link sanitizeNode})
+ * before the allowlist filter runs.
+ */
+export const GEMINI_SUPPORTED_SCHEMA_KEYWORDS = new Set([
+    'anyOf',
+    'default',
+    'description',
+    'enum',
+    'example',
+    'format',
+    'items',
+    'maxItems',
+    'maxLength',
+    'maxProperties',
+    'maximum',
+    'minItems',
+    'minLength',
+    'minProperties',
+    'minimum',
+    'nullable',
+    'pattern',
+    'properties',
+    'propertyOrdering',
+    'required',
+    'title',
+    'type',
+]);
+function isPlainObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/** Deep-clone a literal (JSON-schema data) value so the returned schema never aliases the input. */
+function cloneLiteral(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    try {
+        return structuredClone(value);
+    }
+    catch {
+        // Non-cloneable (functions/symbols) never appear in JSON-schema data; keep the reference.
+        return value;
+    }
+}
+/**
+ * Recursively normalise one schema node to Gemini's supported subset:
+ *  - rewrite `exclusiveMinimum`→`minimum` / `exclusiveMaximum`→`maximum` (Gemini has no exclusive
+ *    bound), keeping the TIGHTER bound when an inclusive one is also present;
+ *  - keep ONLY {@link GEMINI_SUPPORTED_SCHEMA_KEYWORDS}; drop everything else;
+ *  - recurse ONLY through real subschema positions — `properties` (map), `items` (schema or tuple),
+ *    and `anyOf` (array of schemas). Literal-data positions (`enum`, `default`, `example`, `required`,
+ *    `propertyOrdering`) are copied verbatim, so a keyword that merely appears as DATA is untouched.
+ */
+function sanitizeNode(node) {
+    if (Array.isArray(node)) {
+        return node.map(sanitizeNode);
+    }
+    if (!isPlainObject(node)) {
+        return node;
+    }
+    const out = {};
+    for (const [key, value] of Object.entries(node)) {
+        // Allowlist: silently drop any keyword Gemini's Schema type does not declare (this is where
+        // $defs / definitions / patternProperties / const / multipleOf / $ref / allOf / oneOf / not /
+        // additionalProperties / $schema / exclusive* are removed).
+        if (!GEMINI_SUPPORTED_SCHEMA_KEYWORDS.has(key)) {
+            continue;
+        }
+        if (key === 'properties' && isPlainObject(value)) {
+            const mapped = {};
+            for (const [name, sub] of Object.entries(value)) {
+                mapped[name] = sanitizeNode(sub);
+            }
+            out[key] = mapped;
+        }
+        else if (key === 'items') {
+            out[key] = Array.isArray(value) ? value.map(sanitizeNode) : sanitizeNode(value);
+        }
+        else if (key === 'anyOf' && Array.isArray(value)) {
+            out[key] = value.map(sanitizeNode);
+        }
+        else {
+            // Supported scalar / literal-data keyword (type, enum, required, description, default, …).
+            out[key] = cloneLiteral(value);
+        }
+    }
+    // exclusive* → inclusive of the SAME value. Gemini has no exclusive bound; args are hints, so the
+    // loosening is accepted. When both an exclusive and an inclusive bound are present, keep the TIGHTER
+    // one (higher lower-bound / lower upper-bound) rather than letting the exclusive value clobber it.
+    const exclusiveMinimum = node.exclusiveMinimum;
+    if (typeof exclusiveMinimum === 'number') {
+        out.minimum =
+            typeof out.minimum === 'number' ? Math.max(out.minimum, exclusiveMinimum) : exclusiveMinimum;
+    }
+    const exclusiveMaximum = node.exclusiveMaximum;
+    if (typeof exclusiveMaximum === 'number') {
+        out.maximum =
+            typeof out.maximum === 'number' ? Math.min(out.maximum, exclusiveMaximum) : exclusiveMaximum;
+    }
+    return out;
+}
+/**
+ * Pure, recursive allowlist normaliser: returns a cleaned DEEP COPY of a JSON-Schema containing only
+ * keywords Gemini's function-declaration `Schema` accepts, so its OpenAPI-3.0 subset accepts the tool.
+ * Does not mutate the input. See {@link sanitizeNode} for the transform; `anyOf` unions survive.
+ */
+export function sanitizeGeminiToolSchema(schema) {
+    return sanitizeNode(schema);
+}
+/**
+ * The SINGLE normalization pass. Converts a schema to JSON (zod → JSON via the same `@langchain/core`
+ * converter `@langchain/google` uses internally) and runs the allowlist. Every tool-shape branch in
+ * {@link sanitizeToolForGemini} routes its schema(s) through here — so no branch can filter
+ * inconsistently, and a future tool format is covered the moment it calls this.
+ */
+function normalizeSchema(rawSchema) {
+    const jsonSchema = isInteropZodSchema(rawSchema) || isSerializableSchema(rawSchema)
+        ? toJsonSchema(rawSchema)
+        : rawSchema;
+    return sanitizeGeminiToolSchema(jsonSchema);
+}
+/** Build a shallow copy of a tool that preserves its prototype (so it stays a recognisable
+ * LangChain tool) while overriding one own property (its schema) with the normalized value. */
+function cloneWithOverride(source, key, value) {
+    const clone = Object.assign(Object.create(Object.getPrototypeOf(source)), source);
+    Object.defineProperty(clone, key, {
+        value,
+        enumerable: true,
+        writable: true,
+        configurable: true,
+    });
+    return clone;
+}
+/**
+ * Normalise one tool's argument schema for Gemini. Handles the three shapes that reach a ChatGoogle
+ * model's `bindTools`: a LangChain structured tool (`.schema`, zod or JSON), an OpenAI-format tool
+ * (`.function.parameters`), and a Gemini-native `functionDeclarations` tool. Every schema position in
+ * every branch is passed through the SINGLE {@link normalizeSchema} pass; anything else is untouched.
+ */
+function sanitizeToolForGemini(tool) {
+    if (!tool || typeof tool !== 'object') {
+        return tool;
+    }
+    const record = tool;
+    // LangChain structured tool / StructuredToolParams — its arg schema is `.schema` (zod or JSON).
+    if ('schema' in record && record.schema != null) {
+        return cloneWithOverride(tool, 'schema', normalizeSchema(record.schema));
+    }
+    // OpenAI-format tool: { type: 'function', function: { parameters } }.
+    const fn = record.function;
+    if (fn && typeof fn === 'object' && 'parameters' in fn) {
+        const fnRecord = fn;
+        return {
+            ...record,
+            function: { ...fnRecord, parameters: normalizeSchema(fnRecord.parameters) },
+        };
+    }
+    // Gemini-native tool: { functionDeclarations: [{ parameters }, …] }.
+    if (Array.isArray(record.functionDeclarations)) {
+        return {
+            ...record,
+            functionDeclarations: record.functionDeclarations.map((decl) => {
+                if (decl && typeof decl === 'object' && 'parameters' in decl) {
+                    const declRecord = decl;
+                    return { ...declRecord, parameters: normalizeSchema(declRecord.parameters) };
+                }
+                return decl;
+            }),
+        };
+    }
+    return tool;
+}
+/**
+ * Wire the sanitizer into a ChatGoogle model at the tool-binding boundary. Overrides the instance's
+ * `bindTools` so every tool passed to it — built-in, custom, or MCP, via `createAgent`/`createDeepAgent`
+ * which both call `model.bindTools(tools)` — is sanitized before it reaches `@langchain/google`'s
+ * Gemini converter. Provider-scoped: only the google-genai/vertexai presets call this, so no other
+ * provider's tools are affected. Returns the same model instance for convenient chaining.
+ */
+export function applyGeminiToolSchemaSanitizer(model) {
+    const holder = model;
+    const original = holder.bindTools;
+    if (typeof original !== 'function') {
+        return model;
+    }
+    const bound = original.bind(model);
+    holder.bindTools = function sanitizedBindTools(tools, kwargs) {
+        const nextTools = Array.isArray(tools) ? tools.map(sanitizeToolForGemini) : tools;
+        return bound(nextTools, kwargs);
+    };
+    return model;
+}
+//# sourceMappingURL=geminiSchemaSanitizer.js.map

package/dist/providers/geminiSchemaSanitizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geminiSchemaSanitizer.js","sourceRoot":"","sources":["../../src/providers/geminiSchemaSanitizer.ts"],"names":[],"mappings":"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"}

package/dist/providers/google-genai.d.ts

@@ -4,4 +4,4 @@ export declare function processJsonConfig(llmConfig: ChatGoogleParams & {
     type?: string;
     apiKeyEnvironmentVariable?: string;
 }): Promise<BaseChatModel>;
-export declare function init(configFileName: string): void;
+export declare function init(configFileName: string, force?: boolean, model?: string): void;

package/dist/providers/google-genai.js

@@ -1,6 +1,8 @@
 import { displayWarning } from '#src/utils/consoleUtils.js';
 import { env } from '#src/utils/systemUtils.js';
-import { writeFileIfNotExistsWithMessages } from '#src/utils/fileUtils.js';
+import { writeConfigFileWithMessages } from '#src/utils/fileUtils.js';
+import { buildInitConfigContent, getCuratedFallbackModel } from '#src/providers/modelDiscovery.js';
+import { applyGeminiToolSchemaSanitizer } from '#src/providers/geminiSchemaSanitizer.js';
 // Function to process JSON config and create Google GenAI LLM instance
 export async function processJsonConfig(llmConfig) {
     const { ChatGoogle } = await import('@langchain/google/node');
@@ -9,25 +11,21 @@ export async function processJsonConfig(llmConfig) {
     const configFields = {
         ...llmConfig,
         apiKey: googleApiKey,
-        model: llmConfig.model || 'gemini-3.5-flash',
+        model: llmConfig.model || getCuratedFallbackModel('google-genai'),
         platformType: 'gai',
     };
     delete configFields.type;
     delete configFields.apiKeyEnvironmentVariable;
-    return new ChatGoogle(configFields);
+    // GS2-58: normalise every tool's JSON-Schema at the ChatGoogle boundary so Gemini's OpenAPI-3.0
+    // subset accepts built-in, custom, and MCP tools alike (see geminiSchemaSanitizer).
+    return applyGeminiToolSchemaSanitizer(new ChatGoogle(configFields));
 }
-const jsonContent = `{
-  "llm": {
-    "type": "google-genai",
-    "model": "gemini-3.5-flash"
-  }
-}`;
-export function init(configFileName) {
+export function init(configFileName, force = false, model) {
     // Determine which content to use based on file extension
     if (!configFileName.endsWith('.json')) {
         throw new Error('Only JSON config is supported.');
     }
-    writeFileIfNotExistsWithMessages(configFileName, jsonContent);
+    writeConfigFileWithMessages(configFileName, buildInitConfigContent('google-genai', model), force);
     displayWarning(`You need to update your ${configFileName} to add your Google GenAI API key, ` +
         'or define GOOGLE_API_KEY environment variable.');
 }

package/dist/providers/google-genai.js.map

@@ -1 +1 @@
-{"version":3,"file":"google-genai.js","sourceRoot":"","sources":["../../src/providers/google-genai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAIhD,OAAO,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AAE3E,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAmF;IAEnF,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAC9D,wEAAwE;IACxE,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,cAAc,CAAC;IAC5D,MAAM,YAAY,GAAG;QACnB,GAAG,SAAS;QACZ,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,kBAAkB;QAC5C,YAAY,EAAE,KAAc;KAC7B,CAAC;IACF,OAAO,YAAY,CAAC,IAAI,CAAC;IACzB,OAAO,YAAY,CAAC,yBAAyB,CAAC;IAC9C,OAAO,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,WAAW,GAAG;;;;;EAKlB,CAAC;AAEH,MAAM,UAAU,IAAI,CAAC,cAAsB;IACzC,yDAAyD;IACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,gCAAgC,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAC9D,cAAc,CACZ,2BAA2B,cAAc,qCAAqC;QAC5E,gDAAgD,CACnD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"google-genai.js","sourceRoot":"","sources":["../../src/providers/google-genai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAIhD,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AACnG,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAEzF,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAmF;IAEnF,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAC9D,wEAAwE;IACxE,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,cAAc,CAAC;IAC5D,MAAM,YAAY,GAAG;QACnB,GAAG,SAAS;QACZ,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,uBAAuB,CAAC,cAAc,CAAC;QACjE,YAAY,EAAE,KAAc;KAC7B,CAAC;IACF,OAAO,YAAY,CAAC,IAAI,CAAC;IACzB,OAAO,YAAY,CAAC,yBAAyB,CAAC;IAC9C,gGAAgG;IAChG,oFAAoF;IACpF,OAAO,8BAA8B,CAAC,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,cAAsB,EAAE,KAAK,GAAG,KAAK,EAAE,KAAc;IACxE,yDAAyD;IACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,2BAA2B,CAAC,cAAc,EAAE,sBAAsB,CAAC,cAAc,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAClG,cAAc,CACZ,2BAA2B,cAAc,qCAAqC;QAC5E,gDAAgD,CACnD,CAAC;AACJ,CAAC"}

package/dist/providers/groq.d.ts

@@ -1,4 +1,4 @@
 import { BaseChatModel } from '@langchain/core/language_models/chat_models';
 import { ChatGroqInput } from '@langchain/groq';
 export declare function processJsonConfig(llmConfig: ChatGroqInput): Promise<BaseChatModel>;
-export declare function init(configFileName: string): void;
+export declare function init(configFileName: string, force?: boolean, model?: string): void;

package/dist/providers/groq.js

@@ -1,6 +1,7 @@
 import { displayWarning } from '#src/utils/consoleUtils.js';
 import { env } from '#src/utils/systemUtils.js';
-import { writeFileIfNotExistsWithMessages } from '#src/utils/fileUtils.js';
+import { writeConfigFileWithMessages } from '#src/utils/fileUtils.js';
+import { buildInitConfigContent, getCuratedFallbackModel } from '#src/providers/modelDiscovery.js';
 // Function to process JSON config and create Groq LLM instance
 export async function processJsonConfig(llmConfig) {
     const groq = await import('@langchain/groq');
@@ -9,21 +10,15 @@ export async function processJsonConfig(llmConfig) {
     return new groq.ChatGroq({
         ...llmConfig,
         apiKey: groqApiKey,
-        model: llmConfig.model || 'openai/gpt-oss-120b',
+        model: llmConfig.model || getCuratedFallbackModel('groq'),
     });
 }
-const jsonContent = `{
-  "llm": {
-    "type": "groq",
-    "model": "openai/gpt-oss-120b"
-  }
-}`;
-export function init(configFileName) {
+export function init(configFileName, force = false, model) {
     // Determine which content to use based on file extension
     if (!configFileName.endsWith('.json')) {
         throw new Error('Only JSON config is supported.');
     }
-    writeFileIfNotExistsWithMessages(configFileName, jsonContent);
+    writeConfigFileWithMessages(configFileName, buildInitConfigContent('groq', model), force);
     displayWarning(`You need to edit your ${configFileName} to configure model, ` +
         'or define GROQ_API_KEY environment variable.');
 }

package/dist/providers/groq.js.map

@@ -1 +1 @@
-{"version":3,"file":"groq.js","sourceRoot":"","sources":["../../src/providers/groq.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAIhD,OAAO,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AAE3E,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAwB;IAC9D,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC7C,wEAAwE;IACxE,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,YAAY,CAAC;IACxD,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC;QACvB,GAAG,SAAS;QACZ,MAAM,EAAE,UAAU;QAClB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,qBAAqB;KAChD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,WAAW,GAAG;;;;;EAKlB,CAAC;AAEH,MAAM,UAAU,IAAI,CAAC,cAAsB;IACzC,yDAAyD;IACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,gCAAgC,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAC9D,cAAc,CACZ,yBAAyB,cAAc,uBAAuB;QAC5D,8CAA8C,CACjD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"groq.js","sourceRoot":"","sources":["../../src/providers/groq.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAIhD,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAEnG,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAwB;IAC9D,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC7C,wEAAwE;IACxE,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,YAAY,CAAC;IACxD,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC;QACvB,GAAG,SAAS;QACZ,MAAM,EAAE,UAAU;QAClB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,uBAAuB,CAAC,MAAM,CAAC;KAC1D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,cAAsB,EAAE,KAAK,GAAG,KAAK,EAAE,KAAc;IACxE,yDAAyD;IACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,2BAA2B,CAAC,cAAc,EAAE,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAC1F,cAAc,CACZ,yBAAyB,cAAc,uBAAuB;QAC5D,8CAA8C,CACjD,CAAC;AACJ,CAAC"}

package/dist/providers/huggingface.d.ts

@@ -0,0 +1,25 @@
+import { BaseChatModel, type BaseChatModelParams } from '@langchain/core/language_models/chat_models';
+import { OpenAIChatInput } from '@langchain/openai';
+import { ChatOpenAIFields } from '@langchain/openai';
+/**
+ * Hugging Face Inference Providers — OpenAI-compatible router.
+ *
+ * HF exposes a single OpenAI-compatible Chat Completions endpoint at
+ * `https://router.huggingface.co/v1` that fans requests out to the configured
+ * inference provider (Cerebras, Groq, Together, SambaNova, hf-inference, …). It
+ * supports tool/function calling, streaming and structured outputs, so we reuse
+ * LangChain's `ChatOpenAI` exactly like the OpenRouter provider — no dedicated
+ * `@langchain/huggingface` package is needed (the JS `@langchain/community`
+ * `HuggingFaceInference` is a text-completion LLM with no `bindTools`, so it is
+ * unusable for the agent loop).
+ *
+ * Auth uses a Hugging Face user access token with the "Inference Providers"
+ * permission, read from `HF_TOKEN` (canonical) or the `HUGGINGFACEHUB_API_TOKEN`
+ * / `HF_API_KEY` aliases.
+ *
+ * Model ids are Hub repo ids, e.g. `openai/gpt-oss-120b`. You may append a
+ * provider/policy suffix understood by the router (`:groq`, `:cheapest`,
+ * `:fastest`); it is part of the model id and passes straight through.
+ */
+export declare function processJsonConfig(llmConfig: OpenAIChatInput & ChatOpenAIFields & BaseChatModelParams): Promise<BaseChatModel>;
+export declare function init(configFileName: string, force?: boolean, model?: string): void;

package/dist/providers/huggingface.js

@@ -0,0 +1,69 @@
+import { displayWarning } from '#src/utils/consoleUtils.js';
+import { env } from '#src/utils/systemUtils.js';
+import { writeConfigFileWithMessages } from '#src/utils/fileUtils.js';
+import { buildInitConfigContent, getCuratedFallbackModel } from '#src/providers/modelDiscovery.js';
+/**
+ * Hugging Face Inference Providers — OpenAI-compatible router.
+ *
+ * HF exposes a single OpenAI-compatible Chat Completions endpoint at
+ * `https://router.huggingface.co/v1` that fans requests out to the configured
+ * inference provider (Cerebras, Groq, Together, SambaNova, hf-inference, …). It
+ * supports tool/function calling, streaming and structured outputs, so we reuse
+ * LangChain's `ChatOpenAI` exactly like the OpenRouter provider — no dedicated
+ * `@langchain/huggingface` package is needed (the JS `@langchain/community`
+ * `HuggingFaceInference` is a text-completion LLM with no `bindTools`, so it is
+ * unusable for the agent loop).
+ *
+ * Auth uses a Hugging Face user access token with the "Inference Providers"
+ * permission, read from `HF_TOKEN` (canonical) or the `HUGGINGFACEHUB_API_TOKEN`
+ * / `HF_API_KEY` aliases.
+ *
+ * Model ids are Hub repo ids, e.g. `openai/gpt-oss-120b`. You may append a
+ * provider/policy suffix understood by the router (`:groq`, `:cheapest`,
+ * `:fastest`); it is part of the model id and passes straight through.
+ */
+// Function to process JSON config and create Hugging Face LLM instance
+// noinspection JSUnusedGlobalSymbols
+export async function processJsonConfig(llmConfig) {
+    const { ChatOpenAI } = await import('@langchain/openai');
+    // Use environment variable if available, otherwise use the config value
+    const huggingFaceToken = getApiKey(llmConfig);
+    if (!huggingFaceToken) {
+        throw new Error('You need to define HF_TOKEN environment variable (a Hugging Face access token ' +
+            'with the "Inference Providers" permission), or set apiKey in your config file.');
+    }
+    const configFields = {
+        ...llmConfig,
+        apiKey: huggingFaceToken,
+        model: llmConfig.model || getCuratedFallbackModel('huggingface'),
+        configuration: {
+            baseURL: 'https://router.huggingface.co/v1',
+            ...(llmConfig.configuration || {}),
+        },
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    delete configFields.type;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    delete configFields.apiKeyEnvironmentVariable;
+    return new ChatOpenAI(configFields);
+}
+function getApiKey(llmConfig) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const conf = llmConfig;
+    if (conf.apiKeyEnvironmentVariable && env[conf.apiKeyEnvironmentVariable]) {
+        return env[conf.apiKeyEnvironmentVariable];
+    }
+    else {
+        return llmConfig.apiKey || env.HF_TOKEN || env.HUGGINGFACEHUB_API_TOKEN || env.HF_API_KEY;
+    }
+}
+export function init(configFileName, force = false, model) {
+    // Determine which content to use based on file extension
+    if (!configFileName.endsWith('.json')) {
+        throw new Error('Only JSON config is supported.');
+    }
+    writeConfigFileWithMessages(configFileName, buildInitConfigContent('huggingface', model), force);
+    displayWarning(`You need to edit your ${configFileName} to configure model, ` +
+        'or define HF_TOKEN environment variable.');
+}
+//# sourceMappingURL=huggingface.js.map

package/dist/providers/huggingface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"huggingface.js","sourceRoot":"","sources":["../../src/providers/huggingface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAQhD,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAEnG;;;;;;;;;;;;;;;;;;;GAmBG;AACH,uEAAuE;AACvE,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAmE;IAEnE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACzD,wEAAwE;IACxE,MAAM,gBAAgB,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IAC9C,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,gFAAgF;YAC9E,gFAAgF,CACnF,CAAC;IACJ,CAAC;IACD,MAAM,YAAY,GAAG;QACnB,GAAG,SAAS;QACZ,MAAM,EAAE,gBAAgB;QACxB,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,uBAAuB,CAAC,aAAa,CAAC;QAChE,aAAa,EAAE;YACb,OAAO,EAAE,kCAAkC;YAC3C,GAAG,CAAC,SAAS,CAAC,aAAa,IAAI,EAAE,CAAC;SACnC;KACF,CAAC;IACF,8DAA8D;IAC9D,OAAQ,YAAoB,CAAC,IAAI,CAAC;IAClC,8DAA8D;IAC9D,OAAQ,YAAoB,CAAC,yBAAyB,CAAC;IACvD,OAAO,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,SAAS,CAAC,SAAmE;IACpF,8DAA8D;IAC9D,MAAM,IAAI,GAAG,SAA0C,CAAC;IACxD,IAAI,IAAI,CAAC,yBAAyB,IAAI,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,EAAE,CAAC;QAC1E,OAAO,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,OAAO,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,wBAAwB,IAAI,GAAG,CAAC,UAAU,CAAC;IAC5F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,cAAsB,EAAE,KAAK,GAAG,KAAK,EAAE,KAAc;IACxE,yDAAyD;IACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,2BAA2B,CAAC,cAAc,EAAE,sBAAsB,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IACjG,cAAc,CACZ,yBAAyB,cAAc,uBAAuB;QAC5D,0CAA0C,CAC7C,CAAC;AACJ,CAAC"}