@mcpmesh/sdk 2.3.0 → 2.5.0

package/dist/__tests__/llm-provider-output-mode.test.js

@@ -0,0 +1,116 @@
+/**
+ * Provider-side honoring of the consumer-supplied output_mode override — #1112.
+ *
+ * The provider's effective output mode is:
+ *   effective = (model_params.output_mode is one of strict/hint/text)
+ *                 ? that override
+ *                 : handler.determineOutputMode(outputSchema)   // today's auto
+ *
+ * Observability seam: the strict path drives `generateObject()` while
+ * hint/text drive `generateText()` (useStructuredOutput === outputMode ===
+ * "strict"). For an OpenAI provider WITH a schema and NO tools, auto-selection
+ * is "strict" → generateObject. A "hint"/"text" override flips it to
+ * generateText. An absent/invalid override leaves auto (strict) intact.
+ *
+ * Also asserts output_mode is stripped from the params before they reach the
+ * vendor SDK call (generateObject/generateText options).
+ *
+ * The Vercel `ai` module is mocked — no real LLM is invoked.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+const generateObjectMock = vi.fn();
+const generateTextMock = vi.fn();
+vi.mock("ai", () => ({
+    generateText: (opts) => generateTextMock(opts),
+    generateObject: (opts) => generateObjectMock(opts),
+    jsonSchema: (schema) => schema,
+    tool: (config) => config,
+    stepCountIs: (n) => ({ steps }) => steps.length === n,
+}));
+// Keep tracing inert/deterministic (publishTraceSpan is best-effort anyway).
+vi.mock("../tracing.js", () => ({
+    generateTraceId: () => "trace-mock",
+    generateSpanId: () => "span-mock",
+    publishTraceSpan: vi.fn(async () => { }),
+    matchesPropagateHeader: () => false,
+}));
+import { llmProvider } from "../llm-provider.js";
+const SCHEMA = {
+    type: "object",
+    properties: { answer: { type: "string" } },
+    required: ["answer"],
+};
+function makeProvider() {
+    // OpenAI vendor: auto-selects "strict" when a schema is present.
+    return llmProvider({ model: "openai/gpt-4o", capability: "llm" });
+}
+function baseRequest(modelParams) {
+    return {
+        request: {
+            messages: [
+                { role: "system", content: "You are helpful." },
+                { role: "user", content: "hi" },
+            ],
+            model_params: {
+                output_schema: SCHEMA,
+                output_type_name: "Answer",
+                ...modelParams,
+            },
+        },
+    };
+}
+describe("provider output_mode override (#1112)", () => {
+    beforeEach(() => {
+        generateObjectMock.mockReset();
+        generateTextMock.mockReset();
+        generateObjectMock.mockResolvedValue({
+            object: { answer: "ok" },
+            usage: { inputTokens: 1, outputTokens: 1 },
+            finishReason: "stop",
+        });
+        generateTextMock.mockResolvedValue({
+            text: "ok",
+            toolCalls: [],
+            usage: { inputTokens: 1, outputTokens: 1 },
+            finishReason: "stop",
+        });
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("auto-selects strict (generateObject) when no override is present — byte-identical to today", async () => {
+        const tool = makeProvider();
+        await tool.execute(baseRequest({}));
+        expect(generateObjectMock).toHaveBeenCalledTimes(1);
+        expect(generateTextMock).not.toHaveBeenCalled();
+    });
+    it("honors a 'hint' override where it would auto-select strict (uses generateText)", async () => {
+        const tool = makeProvider();
+        await tool.execute(baseRequest({ output_mode: "hint" }));
+        expect(generateTextMock).toHaveBeenCalledTimes(1);
+        expect(generateObjectMock).not.toHaveBeenCalled();
+    });
+    it("honors a 'text' override (uses generateText)", async () => {
+        const tool = makeProvider();
+        await tool.execute(baseRequest({ output_mode: "text" }));
+        expect(generateTextMock).toHaveBeenCalledTimes(1);
+        expect(generateObjectMock).not.toHaveBeenCalled();
+    });
+    it("ignores an invalid override and falls back to auto (strict → generateObject)", async () => {
+        const tool = makeProvider();
+        await tool.execute(baseRequest({ output_mode: "bogus" }));
+        expect(generateObjectMock).toHaveBeenCalledTimes(1);
+        expect(generateTextMock).not.toHaveBeenCalled();
+    });
+    it("strips output_mode from the params reaching the vendor SDK call", async () => {
+        const tool = makeProvider();
+        await tool.execute(baseRequest({ output_mode: "hint" }));
+        // hint → generateText; assert the options object carries no output_mode.
+        expect(generateTextMock).toHaveBeenCalledTimes(1);
+        const opts = generateTextMock.mock.calls[0][0];
+        expect("output_mode" in opts).toBe(false);
+        // Nested guard: output_mode must not leak via providerOptions either.
+        expect(JSON.stringify(opts)).not.toContain("output_mode");
+    });
+});
+//# sourceMappingURL=llm-provider-output-mode.test.js.map

package/dist/__tests__/llm-provider-output-mode.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider-output-mode.test.js","sourceRoot":"","sources":["../../src/__tests__/llm-provider-output-mode.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/llm-provider-stopwhen.test.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Gemini SDK-managed agentic loop wiring — issue #1160.
+ *
+ * AI SDK v6 removed `maxSteps` from generateText; loop control is now
+ * `stopWhen` with a default of `stepCountIs(1)`. The provider previously set
+ * `requestOptions.maxSteps`, which landed in the `...settings` rest and was
+ * silently ignored — Gemini executed the tool-call step but never did the
+ * follow-up generation, returning an empty assistant message.
+ *
+ * These tests mock `generateText` (keeping the REAL `stepCountIs`/`tool`/
+ * `jsonSchema` via importOriginal) and assert the options object that reaches
+ * the AI SDK:
+ *
+ *  - Gemini + `_mesh_endpoint` tools: `stopWhen` is set to the result of
+ *    `stepCountIs(resolvedMaxIterations)`. `stepCountIs(n)` returns a
+ *    predicate `({ steps }) => steps.length === n`, so we assert the
+ *    predicate's behavior at the boundary (true at n steps, false at n-1).
+ *  - The removed `maxSteps` key is NOT present (regression guard).
+ *  - Non-Gemini vendors (manual provider-managed loop) do NOT set `stopWhen`.
+ */
+export {};
+//# sourceMappingURL=llm-provider-stopwhen.test.d.ts.map

package/dist/__tests__/llm-provider-stopwhen.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider-stopwhen.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/llm-provider-stopwhen.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/__tests__/llm-provider-stopwhen.test.js

@@ -0,0 +1,127 @@
+/**
+ * Gemini SDK-managed agentic loop wiring — issue #1160.
+ *
+ * AI SDK v6 removed `maxSteps` from generateText; loop control is now
+ * `stopWhen` with a default of `stepCountIs(1)`. The provider previously set
+ * `requestOptions.maxSteps`, which landed in the `...settings` rest and was
+ * silently ignored — Gemini executed the tool-call step but never did the
+ * follow-up generation, returning an empty assistant message.
+ *
+ * These tests mock `generateText` (keeping the REAL `stepCountIs`/`tool`/
+ * `jsonSchema` via importOriginal) and assert the options object that reaches
+ * the AI SDK:
+ *
+ *  - Gemini + `_mesh_endpoint` tools: `stopWhen` is set to the result of
+ *    `stepCountIs(resolvedMaxIterations)`. `stepCountIs(n)` returns a
+ *    predicate `({ steps }) => steps.length === n`, so we assert the
+ *    predicate's behavior at the boundary (true at n steps, false at n-1).
+ *  - The removed `maxSteps` key is NOT present (regression guard).
+ *  - Non-Gemini vendors (manual provider-managed loop) do NOT set `stopWhen`.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+const generateTextMock = vi.fn();
+const generateObjectMock = vi.fn();
+vi.mock("ai", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        generateText: (opts) => generateTextMock(opts),
+        generateObject: (opts) => generateObjectMock(opts),
+    };
+});
+// Keep tracing inert/deterministic (publishTraceSpan is best-effort anyway).
+vi.mock("../tracing.js", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        generateTraceId: () => "trace-mock",
+        generateSpanId: () => "span-mock",
+        publishTraceSpan: vi.fn(async () => false),
+        matchesPropagateHeader: () => false,
+    };
+});
+import { llmProvider } from "../llm-provider.js";
+function meshToolRequest(modelParams) {
+    return {
+        request: {
+            messages: [{ role: "user", content: "What's the weather in Paris?" }],
+            tools: [
+                {
+                    type: "function",
+                    function: {
+                        name: "get_weather",
+                        description: "Get the current weather for a city",
+                        parameters: {
+                            type: "object",
+                            properties: { city: { type: "string" } },
+                            required: ["city"],
+                        },
+                        // Mesh-enriched endpoint → provider-managed tool execution
+                        _mesh_endpoint: "http://weather-agent.local:9100",
+                    },
+                },
+            ],
+            model_params: { ...modelParams },
+        },
+    };
+}
+async function stepsAtCount(stopWhen, count) {
+    return await stopWhen({ steps: new Array(count).fill({}) });
+}
+describe("Gemini SDK-managed loop wires stopWhen (#1160)", () => {
+    beforeEach(() => {
+        generateTextMock.mockReset();
+        generateObjectMock.mockReset();
+        generateTextMock.mockResolvedValue({
+            text: "It is sunny in Paris.",
+            toolCalls: [],
+            usage: { inputTokens: 1, outputTokens: 1 },
+            finishReason: "stop",
+        });
+        // Model creation must not depend on real credentials at request time
+        // (generateText is mocked), but keep keys set for construction safety.
+        process.env.GOOGLE_GENERATIVE_AI_API_KEY = "test-key";
+        process.env.ANTHROPIC_API_KEY = "test-key";
+    });
+    afterEach(() => {
+        delete process.env.GOOGLE_GENERATIVE_AI_API_KEY;
+        delete process.env.ANTHROPIC_API_KEY;
+        vi.restoreAllMocks();
+    });
+    it("sets stopWhen=stepCountIs(max_iterations) and never the removed maxSteps", async () => {
+        const tool = llmProvider({ model: "gemini/gemini-2.5-flash", capability: "llm" });
+        await tool.execute(meshToolRequest({ max_iterations: 25 }));
+        expect(generateTextMock).toHaveBeenCalledTimes(1);
+        const opts = generateTextMock.mock.calls[0][0];
+        // AI SDK v6 removed maxSteps — it must not be passed at all.
+        expect("maxSteps" in opts).toBe(false);
+        // stopWhen must be the stepCountIs(25) predicate: stops exactly when the
+        // step count reaches the resolved cap.
+        const stopWhen = opts.stopWhen;
+        expect(typeof stopWhen).toBe("function");
+        expect(await stepsAtCount(stopWhen, 25)).toBe(true);
+        expect(await stepsAtCount(stopWhen, 24)).toBe(false);
+        expect(await stepsAtCount(stopWhen, 1)).toBe(false);
+    });
+    it("defaults stopWhen to stepCountIs(10) when no cap is forwarded", async () => {
+        delete process.env.MESH_LLM_MAX_ITERATIONS;
+        const tool = llmProvider({ model: "gemini/gemini-2.5-flash", capability: "llm" });
+        await tool.execute(meshToolRequest({}));
+        expect(generateTextMock).toHaveBeenCalledTimes(1);
+        const opts = generateTextMock.mock.calls[0][0];
+        expect("maxSteps" in opts).toBe(false);
+        const stopWhen = opts.stopWhen;
+        expect(typeof stopWhen).toBe("function");
+        expect(await stepsAtCount(stopWhen, 10)).toBe(true);
+        expect(await stepsAtCount(stopWhen, 9)).toBe(false);
+    });
+    it("non-Gemini vendors keep the manual loop: no stopWhen, no maxSteps", async () => {
+        const tool = llmProvider({ model: "anthropic/claude-sonnet-4-5", capability: "llm" });
+        await tool.execute(meshToolRequest({ max_iterations: 25 }));
+        expect(generateTextMock).toHaveBeenCalledTimes(1);
+        const opts = generateTextMock.mock.calls[0][0];
+        expect(opts.stopWhen).toBeUndefined();
+        expect("maxSteps" in opts).toBe(false);
+    });
+});
+//# sourceMappingURL=llm-provider-stopwhen.test.js.map

package/dist/__tests__/llm-provider-stopwhen.test.js.map

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

package/dist/__tests__/llm-provider-system-synthesis.test.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Provider synthesizes a system message when the consumer supplies none but
+ * structured-output (hint mode) instructions still need to reach the model —
+ * #1112 finding 6.
+ *
+ * Root cause: the request.messages transform only augmented an EXISTING system
+ * message with the schema/JSON hint instructions. A mesh-delegated consumer
+ * with a typed schema and NO systemPrompt produced no system message, so the
+ * hint instructions were silently dropped. In hint mode there is no native
+ * response_format backstop (strict-only), so the model returned prose and the
+ * consumer's ResponseParser threw "Could not extract JSON from response."
+ *
+ * Fix: when NO system message exists AND mode !== "text" AND a schema is
+ * present, synthesize a system message via formatSystemPrompt("", ...) and
+ * prepend it.
+ *
+ * The Vercel `ai` module is mocked — no real LLM is invoked.
+ */
+export {};
+//# sourceMappingURL=llm-provider-system-synthesis.test.d.ts.map

package/dist/__tests__/llm-provider-system-synthesis.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider-system-synthesis.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/llm-provider-system-synthesis.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/__tests__/llm-provider-system-synthesis.test.js

@@ -0,0 +1,168 @@
+/**
+ * Provider synthesizes a system message when the consumer supplies none but
+ * structured-output (hint mode) instructions still need to reach the model —
+ * #1112 finding 6.
+ *
+ * Root cause: the request.messages transform only augmented an EXISTING system
+ * message with the schema/JSON hint instructions. A mesh-delegated consumer
+ * with a typed schema and NO systemPrompt produced no system message, so the
+ * hint instructions were silently dropped. In hint mode there is no native
+ * response_format backstop (strict-only), so the model returned prose and the
+ * consumer's ResponseParser threw "Could not extract JSON from response."
+ *
+ * Fix: when NO system message exists AND mode !== "text" AND a schema is
+ * present, synthesize a system message via formatSystemPrompt("", ...) and
+ * prepend it.
+ *
+ * The Vercel `ai` module is mocked — no real LLM is invoked.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+const generateObjectMock = vi.fn();
+const generateTextMock = vi.fn();
+vi.mock("ai", () => ({
+    generateText: (opts) => generateTextMock(opts),
+    generateObject: (opts) => generateObjectMock(opts),
+    jsonSchema: (schema) => schema,
+    tool: (config) => config,
+    stepCountIs: (n) => ({ steps }) => steps.length === n,
+}));
+vi.mock("../tracing.js", () => ({
+    generateTraceId: () => "trace-mock",
+    generateSpanId: () => "span-mock",
+    publishTraceSpan: vi.fn(async () => { }),
+    matchesPropagateHeader: () => false,
+}));
+import { llmProvider } from "../llm-provider.js";
+const SCHEMA = {
+    type: "object",
+    properties: { answer: { type: "string" } },
+    required: ["answer"],
+};
+function makeProvider() {
+    // OpenAI vendor: auto-selects "strict" when a schema is present.
+    return llmProvider({ model: "openai/gpt-4o", capability: "llm" });
+}
+function systemMessages(opts) {
+    return opts.messages.filter((m) => m.role === "system");
+}
+beforeEach(() => {
+    generateObjectMock.mockReset();
+    generateTextMock.mockReset();
+    generateObjectMock.mockResolvedValue({
+        object: { answer: "ok" },
+        usage: { inputTokens: 1, outputTokens: 1 },
+        finishReason: "stop",
+    });
+    generateTextMock.mockResolvedValue({
+        text: '{"answer":"ok"}',
+        toolCalls: [],
+        usage: { inputTokens: 1, outputTokens: 1 },
+        finishReason: "stop",
+    });
+});
+afterEach(() => {
+    vi.restoreAllMocks();
+});
+describe("provider system-message synthesis (#1112 finding 6)", () => {
+    it("synthesizes a system message with schema/JSON hint instructions when none exists (hint + schema)", async () => {
+        const tool = makeProvider();
+        await tool.execute({
+            request: {
+                // NO system message — only a user turn.
+                messages: [{ role: "user", content: "hi" }],
+                model_params: {
+                    output_schema: SCHEMA,
+                    output_type_name: "Answer",
+                    output_mode: "hint",
+                },
+            },
+        });
+        // hint → generateText.
+        expect(generateTextMock).toHaveBeenCalledTimes(1);
+        const opts = generateTextMock.mock.calls[0][0];
+        const systems = systemMessages(opts);
+        // A system message was synthesized and prepended.
+        expect(systems).toHaveLength(1);
+        expect(opts.messages[0].role).toBe("system");
+        const content = systems[0].content;
+        // Carries the hint-mode JSON instructions + schema field.
+        expect(content).toContain("OUTPUT FORMAT:");
+        expect(content).toContain("ONLY valid JSON");
+        expect(content).toContain("answer");
+    });
+    it("augments an EXISTING system message (hint + schema) without double-adding", async () => {
+        const tool = makeProvider();
+        await tool.execute({
+            request: {
+                messages: [
+                    { role: "system", content: "You are helpful." },
+                    { role: "user", content: "hi" },
+                ],
+                model_params: {
+                    output_schema: SCHEMA,
+                    output_type_name: "Answer",
+                    output_mode: "hint",
+                },
+            },
+        });
+        expect(generateTextMock).toHaveBeenCalledTimes(1);
+        const opts = generateTextMock.mock.calls[0][0];
+        const systems = systemMessages(opts);
+        // Exactly one system message — the original, augmented (not double-added).
+        expect(systems).toHaveLength(1);
+        const content = systems[0].content;
+        expect(content).toContain("You are helpful.");
+        expect(content).toContain("OUTPUT FORMAT:");
+        expect(content).toContain("answer");
+    });
+    it("does NOT synthesize for strict mode with no system message (native response_format backstop)", async () => {
+        const tool = makeProvider();
+        await tool.execute({
+            request: {
+                messages: [{ role: "user", content: "hi" }],
+                model_params: {
+                    output_schema: SCHEMA,
+                    output_type_name: "Answer",
+                    // No override → OpenAI auto-selects strict (no tools, has schema).
+                },
+            },
+        });
+        // strict + schema + no tools → generateObject (structured output intact).
+        expect(generateObjectMock).toHaveBeenCalledTimes(1);
+        expect(generateTextMock).not.toHaveBeenCalled();
+        const opts = generateObjectMock.mock.calls[0][0];
+        // No system message was synthesized — strict relies on response_format.
+        expect(systemMessages(opts)).toHaveLength(0);
+    });
+    it("does NOT synthesize for text mode with no system message", async () => {
+        const tool = makeProvider();
+        await tool.execute({
+            request: {
+                messages: [{ role: "user", content: "hi" }],
+                model_params: {
+                    output_schema: SCHEMA,
+                    output_type_name: "Answer",
+                    output_mode: "text",
+                },
+            },
+        });
+        expect(generateTextMock).toHaveBeenCalledTimes(1);
+        const opts = generateTextMock.mock.calls[0][0];
+        expect(systemMessages(opts)).toHaveLength(0);
+    });
+    it("does NOT synthesize when there is no schema (hint mode, no system message)", async () => {
+        const tool = makeProvider();
+        await tool.execute({
+            request: {
+                messages: [{ role: "user", content: "hi" }],
+                model_params: {
+                    output_mode: "hint",
+                },
+            },
+        });
+        expect(generateTextMock).toHaveBeenCalledTimes(1);
+        const opts = generateTextMock.mock.calls[0][0];
+        expect(systemMessages(opts)).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=llm-provider-system-synthesis.test.js.map

package/dist/__tests__/llm-provider-system-synthesis.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider-system-synthesis.test.js","sourceRoot":"","sources":["../../src/__tests__/llm-provider-system-synthesis.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/llm-provider-vertex-settings.test.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Vertex AI provider settings resolution — issue #1181.
+ *
+ * The mesh contract (#834) is GOOGLE_CLOUD_PROJECT / GOOGLE_CLOUD_LOCATION
+ * (honored by the Python runtime). @ai-sdk/google-vertex's default `vertex`
+ * instance only reads GOOGLE_VERTEX_PROJECT / GOOGLE_VERTEX_LOCATION at call
+ * time, so identically-configured environments worked on Python and threw
+ * `AI_LoadSettingError` on TS.
+ *
+ * loadProvider("vertex_ai") must now ALWAYS construct the provider via
+ * createVertex() with explicitly resolved settings:
+ *  - mesh-standard names map through,
+ *  - the vendor-specific GOOGLE_VERTEX_* name wins when both are set,
+ *  - settings that resolve to nothing are OMITTED (the SDK surfaces its own
+ *    clear error), and the debug warn mentions BOTH accepted names.
+ */
+export {};
+//# sourceMappingURL=llm-provider-vertex-settings.test.d.ts.map

package/dist/__tests__/llm-provider-vertex-settings.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider-vertex-settings.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/llm-provider-vertex-settings.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/__tests__/llm-provider-vertex-settings.test.js

@@ -0,0 +1,128 @@
+/**
+ * Vertex AI provider settings resolution — issue #1181.
+ *
+ * The mesh contract (#834) is GOOGLE_CLOUD_PROJECT / GOOGLE_CLOUD_LOCATION
+ * (honored by the Python runtime). @ai-sdk/google-vertex's default `vertex`
+ * instance only reads GOOGLE_VERTEX_PROJECT / GOOGLE_VERTEX_LOCATION at call
+ * time, so identically-configured environments worked on Python and threw
+ * `AI_LoadSettingError` on TS.
+ *
+ * loadProvider("vertex_ai") must now ALWAYS construct the provider via
+ * createVertex() with explicitly resolved settings:
+ *  - mesh-standard names map through,
+ *  - the vendor-specific GOOGLE_VERTEX_* name wins when both are set,
+ *  - settings that resolve to nothing are OMITTED (the SDK surfaces its own
+ *    clear error), and the debug warn mentions BOTH accepted names.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+const createVertexMock = vi.fn((options) => {
+    // Mimic the real factory: returns a callable provider that resolves models.
+    return (modelId) => ({ modelId, options });
+});
+vi.mock("@ai-sdk/google-vertex", () => ({
+    createVertex: (options) => createVertexMock(options),
+    // The default instance reads GOOGLE_VERTEX_* env vars at call time and must
+    // never be used by the mesh provider path (#1181 regression guard).
+    vertex: () => {
+        throw new Error("default `vertex` instance must not be used");
+    },
+}));
+import { loadProvider, resolveVertexSettings } from "../llm-provider.js";
+const ENV_KEYS = [
+    "GOOGLE_VERTEX_PROJECT",
+    "GOOGLE_VERTEX_LOCATION",
+    "GOOGLE_CLOUD_PROJECT",
+    "GOOGLE_CLOUD_LOCATION",
+    "MCP_MESH_DEBUG_MODE",
+    "MCP_MESH_LOG_LEVEL",
+];
+describe("vertex_ai provider settings resolution (#1181)", () => {
+    let savedEnv;
+    beforeEach(() => {
+        createVertexMock.mockClear();
+        // Capture-and-restore: save current values, clear for a clean slate.
+        savedEnv = {};
+        for (const key of ENV_KEYS) {
+            savedEnv[key] = process.env[key];
+            delete process.env[key];
+        }
+    });
+    afterEach(() => {
+        for (const key of ENV_KEYS) {
+            if (savedEnv[key] === undefined) {
+                delete process.env[key];
+            }
+            else {
+                process.env[key] = savedEnv[key];
+            }
+        }
+        vi.restoreAllMocks();
+    });
+    it("maps mesh-standard GOOGLE_CLOUD_PROJECT/GOOGLE_CLOUD_LOCATION through to createVertex", async () => {
+        process.env.GOOGLE_CLOUD_PROJECT = "mesh-project";
+        process.env.GOOGLE_CLOUD_LOCATION = "us-central1";
+        const provider = await loadProvider("vertex_ai");
+        expect(createVertexMock).toHaveBeenCalledTimes(1);
+        expect(createVertexMock).toHaveBeenCalledWith({
+            project: "mesh-project",
+            location: "us-central1",
+        });
+        // The swap must be seamless: loadProvider returns the factory's provider,
+        // which resolves model IDs exactly like the previous default instance.
+        expect(typeof provider).toBe("function");
+        const model = provider("gemini-2.5-flash");
+        expect(model.modelId).toBe("gemini-2.5-flash");
+        expect(model.options).toEqual({
+            project: "mesh-project",
+            location: "us-central1",
+        });
+    });
+    it("prefers vendor-specific GOOGLE_VERTEX_* when both names are set", async () => {
+        process.env.GOOGLE_VERTEX_PROJECT = "vertex-project";
+        process.env.GOOGLE_VERTEX_LOCATION = "europe-west4";
+        process.env.GOOGLE_CLOUD_PROJECT = "cloud-project";
+        process.env.GOOGLE_CLOUD_LOCATION = "us-central1";
+        await loadProvider("vertex_ai");
+        expect(createVertexMock).toHaveBeenCalledWith({
+            project: "vertex-project",
+            location: "europe-west4",
+        });
+    });
+    it("resolves each setting independently (mixed naming)", async () => {
+        process.env.GOOGLE_VERTEX_PROJECT = "vertex-project";
+        process.env.GOOGLE_CLOUD_LOCATION = "us-east1";
+        await loadProvider("vertex_ai");
+        expect(createVertexMock).toHaveBeenCalledWith({
+            project: "vertex-project",
+            location: "us-east1",
+        });
+    });
+    it("omits unresolved settings and warns mentioning BOTH accepted names", async () => {
+        process.env.MCP_MESH_DEBUG_MODE = "true";
+        const logSpy = vi.spyOn(console, "log").mockImplementation(() => { });
+        await loadProvider("vertex_ai");
+        // Factory still called (single code path), but without project/location
+        // keys — the SDK throws its own clear LoadSettingError at call time.
+        expect(createVertexMock).toHaveBeenCalledTimes(1);
+        const opts = createVertexMock.mock.calls[0][0];
+        expect(opts).not.toHaveProperty("project");
+        expect(opts).not.toHaveProperty("location");
+        const logged = logSpy.mock.calls.map((call) => call.join(" ")).join("\n");
+        expect(logged).toContain("GOOGLE_VERTEX_PROJECT");
+        expect(logged).toContain("GOOGLE_CLOUD_PROJECT");
+        expect(logged).toContain("GOOGLE_VERTEX_LOCATION");
+        expect(logged).toContain("GOOGLE_CLOUD_LOCATION");
+    });
+    it("resolveVertexSettings treats empty string as unset (falls through, never blank)", () => {
+        process.env.GOOGLE_VERTEX_PROJECT = "";
+        process.env.GOOGLE_CLOUD_PROJECT = "cloud-project";
+        process.env.GOOGLE_VERTEX_LOCATION = "";
+        const settings = resolveVertexSettings();
+        // An empty vendor-specific name must not shadow-and-blank the setting: it
+        // falls through to the mesh-standard name, and a setting with no non-empty
+        // source is omitted entirely.
+        expect(settings).toEqual({ project: "cloud-project" });
+        expect(settings).not.toHaveProperty("location");
+    });
+});
+//# sourceMappingURL=llm-provider-vertex-settings.test.js.map