@aiden-ade/sandbox-agent 0.1.59 → 0.1.60

package/dist/__tests__/mcp-readiness.test.js

@@ -0,0 +1,267 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { StreamableHTTPError } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { prepareAlanMcpForRun, probeAlanMcpReadiness, } from "../mcp-readiness.js";
+const registration = {
+    url: "https://api.alan.test/mcp",
+    headers: { "x-alan-run-reference": "alan_mcp_run_reference" },
+    requiredTools: ["create_plan", "create_document_artifact"],
+    contractVersion: 1,
+};
+let home;
+const originalReadinessMode = process.env.ALAN_MCP_READINESS_MODE;
+afterEach(() => {
+    if (home)
+        rmSync(home, { recursive: true, force: true });
+    home = undefined;
+    if (originalReadinessMode === undefined) {
+        delete process.env.ALAN_MCP_READINESS_MODE;
+    }
+    else {
+        process.env.ALAN_MCP_READINESS_MODE = originalReadinessMode;
+    }
+});
+function clientFactoryWithTools(toolNames) {
+    const close = vi.fn();
+    const client = {
+        listTools: vi.fn().mockResolvedValue({
+            tools: toolNames.map((name) => ({ name })),
+        }),
+        close,
+    };
+    return {
+        factory: vi.fn().mockResolvedValue(client),
+        close,
+    };
+}
+describe("probeAlanMcpReadiness", () => {
+    it("initializes, lists tools, validates the required subset, and closes", async () => {
+        const { factory, close } = clientFactoryWithTools([
+            "create_plan",
+            "create_document_artifact",
+            "search_code_context",
+        ]);
+        const result = await probeAlanMcpReadiness(registration, { clientFactory: factory });
+        expect(result).toMatchObject({
+            ok: true,
+            verification: "enforced",
+            toolCount: 3,
+        });
+        expect(factory).toHaveBeenCalledWith({
+            registration,
+            signal: expect.any(AbortSignal),
+        });
+        expect(close).toHaveBeenCalledTimes(1);
+    });
+    it("fails without retrying when required tools are missing", async () => {
+        const { factory } = clientFactoryWithTools(["create_plan"]);
+        const result = await probeAlanMcpReadiness(registration, { clientFactory: factory });
+        expect(result).toMatchObject({
+            ok: false,
+            code: "app.mcp.tools_missing",
+            stage: "tools",
+            retryable: false,
+            missingTools: ["create_document_artifact"],
+        });
+        expect(factory).toHaveBeenCalledTimes(1);
+    });
+    it.each([
+        401, 403,
+    ])("classifies HTTP %s as non-retryable run authentication failure", async (code) => {
+        const factory = vi
+            .fn()
+            .mockRejectedValue(new StreamableHTTPError(code, "request rejected"));
+        const result = await probeAlanMcpReadiness(registration, { clientFactory: factory });
+        expect(result).toMatchObject({
+            ok: false,
+            code: "app.mcp.auth_invalid",
+            retryable: false,
+        });
+        expect(factory).toHaveBeenCalledTimes(1);
+    });
+    it("retries one transient connection failure and then succeeds", async () => {
+        const { factory: healthyFactory } = clientFactoryWithTools([
+            "create_plan",
+            "create_document_artifact",
+        ]);
+        const factory = vi
+            .fn()
+            .mockRejectedValueOnce(new Error("ECONNRESET"))
+            .mockImplementation(healthyFactory);
+        const result = await probeAlanMcpReadiness(registration, { clientFactory: factory });
+        expect(result.ok).toBe(true);
+        expect(factory).toHaveBeenCalledTimes(2);
+    });
+    it.each([
+        429, 503,
+    ])("retries HTTP %s once and then returns endpoint unavailable", async (code) => {
+        const factory = vi
+            .fn()
+            .mockRejectedValue(new StreamableHTTPError(code, "temporarily unavailable"));
+        const result = await probeAlanMcpReadiness(registration, { clientFactory: factory });
+        expect(result).toMatchObject({
+            ok: false,
+            code: "app.mcp.endpoint_unavailable",
+            retryable: true,
+        });
+        expect(factory).toHaveBeenCalledTimes(2);
+    });
+    it("retries an aborted attempt once and then returns endpoint unavailable", async () => {
+        const timeout = new Error("readiness timed out");
+        timeout.name = "AbortError";
+        const factory = vi.fn().mockRejectedValue(timeout);
+        const result = await probeAlanMcpReadiness(registration, { clientFactory: factory });
+        expect(result).toMatchObject({
+            ok: false,
+            code: "app.mcp.endpoint_unavailable",
+            retryable: true,
+        });
+        expect(factory).toHaveBeenCalledTimes(2);
+    });
+    it("classifies an invalid MCP response as a non-retryable protocol failure", async () => {
+        const factory = vi
+            .fn()
+            .mockRejectedValue(new Error("unexpected JSON-RPC response"));
+        const result = await probeAlanMcpReadiness(registration, { clientFactory: factory });
+        expect(result).toMatchObject({
+            ok: false,
+            code: "app.mcp.protocol_invalid",
+            retryable: false,
+        });
+        expect(factory).toHaveBeenCalledTimes(1);
+    });
+    it("does not turn a successful probe into a failure when client cleanup fails", async () => {
+        const client = {
+            listTools: vi.fn().mockResolvedValue({
+                tools: registration.requiredTools.map((name) => ({ name })),
+            }),
+            close: vi.fn().mockRejectedValue(new Error("close failed")),
+        };
+        const result = await probeAlanMcpReadiness(registration, {
+            clientFactory: vi.fn().mockResolvedValue(client),
+        });
+        expect(result).toMatchObject({ ok: true, verification: "enforced" });
+    });
+});
+describe("prepareAlanMcpForRun", () => {
+    it("observes rather than blocks by default", async () => {
+        // Staged rollout: the direct probe must not gate run start until a
+        // deployment explicitly opts into enforce.
+        delete process.env.ALAN_MCP_READINESS_MODE;
+        home = mkdtempSync(join(tmpdir(), "alan-mcp-ready-"));
+        const factory = vi
+            .fn()
+            .mockRejectedValue(new StreamableHTTPError(401, "request rejected"));
+        const result = await prepareAlanMcpForRun("mystery_cli", registration, {
+            home,
+            clientFactory: factory,
+        });
+        expect(result).toMatchObject({ ok: true, verification: "observed" });
+        expect(JSON.stringify(result)).not.toContain("alan_mcp_run_reference");
+    });
+    it("reports an observed probe failure without delaying run start", async () => {
+        home = mkdtempSync(join(tmpdir(), "alan-mcp-ready-"));
+        let releaseProbe = () => undefined;
+        const probeGate = new Promise((resolve) => {
+            releaseProbe = resolve;
+        });
+        const factory = vi
+            .fn()
+            .mockImplementation(() => probeGate.then(() => Promise.reject(new StreamableHTTPError(401, "request rejected"))));
+        const observed = [];
+        let notified = () => undefined;
+        const gotFailure = new Promise((resolve) => {
+            notified = resolve;
+        });
+        const result = await prepareAlanMcpForRun("mystery_cli", registration, {
+            home,
+            mode: "observe",
+            clientFactory: factory,
+            onObservedResult: (failure) => {
+                observed.push(failure);
+                notified();
+            },
+        });
+        // The probe is still pending, proving run start did not wait on it.
+        expect(result).toMatchObject({
+            ok: true,
+            verification: "observed",
+            providerLoadStatus: "unsupported",
+        });
+        expect(observed).toHaveLength(0);
+        releaseProbe();
+        await gotFailure;
+        expect(observed).toMatchObject([{ code: "app.mcp.auth_invalid" }]);
+    });
+    it("skips the probe for a legacy registration that carries no readiness contract", async () => {
+        // An older API mints a run-scoped credential without the contract fields.
+        // The run is still properly scoped, so it must not be rejected.
+        home = mkdtempSync(join(tmpdir(), "alan-mcp-ready-"));
+        const factory = vi
+            .fn()
+            .mockRejectedValue(new Error("probe must not run"));
+        const result = await prepareAlanMcpForRun("mystery_cli", { url: registration.url, headers: registration.headers }, { home, mode: "enforce", clientFactory: factory });
+        expect(result).toMatchObject({ ok: true, verification: "legacy" });
+        expect(factory).not.toHaveBeenCalled();
+    });
+    it("still rejects a half-populated contract even in observe mode", async () => {
+        // Config-shaped failures block in every mode; only the probe is staged.
+        home = mkdtempSync(join(tmpdir(), "alan-mcp-ready-"));
+        const factory = vi.fn();
+        const result = await prepareAlanMcpForRun("mystery_cli", { url: registration.url, headers: registration.headers, requiredTools: ["create_plan"] }, { home, mode: "observe", clientFactory: factory });
+        expect(result).toMatchObject({ ok: false, code: "app.mcp.config_invalid" });
+        expect(factory).not.toHaveBeenCalled();
+    });
+    it("blocks the run on the same failure in enforce mode", async () => {
+        home = mkdtempSync(join(tmpdir(), "alan-mcp-ready-"));
+        const factory = vi
+            .fn()
+            .mockRejectedValue(new StreamableHTTPError(401, "request rejected"));
+        const result = await prepareAlanMcpForRun("mystery_cli", registration, {
+            home,
+            mode: "enforce",
+            clientFactory: factory,
+        });
+        expect(result).toMatchObject({
+            ok: false,
+            code: "app.mcp.auth_invalid",
+            retryable: false,
+        });
+    });
+    it("skips the direct probe only when off mode is explicitly selected", async () => {
+        home = mkdtempSync(join(tmpdir(), "alan-mcp-ready-"));
+        const factory = vi.fn();
+        const result = await prepareAlanMcpForRun("mystery_cli", registration, {
+            home,
+            mode: "off",
+            clientFactory: factory,
+        });
+        // "off" is an explicit opt-out with a full contract present — distinct from
+        // "legacy", which means the API never sent one.
+        expect(result).toMatchObject({ ok: true, verification: "off" });
+        expect(factory).not.toHaveBeenCalled();
+    });
+    it.each([
+        { ...registration, contractVersion: undefined },
+        { ...registration, contractVersion: 999 },
+        { ...registration, requiredTools: [] },
+    ])("rejects an invalid run contract before config or network work", async (candidate) => {
+        home = mkdtempSync(join(tmpdir(), "alan-mcp-ready-"));
+        const factory = vi.fn();
+        const result = await prepareAlanMcpForRun("mystery_cli", candidate, {
+            home,
+            clientFactory: factory,
+        });
+        expect(result).toMatchObject({
+            ok: false,
+            code: "app.mcp.config_invalid",
+            stage: "config",
+            retryable: false,
+            paths: [],
+        });
+        expect(factory).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=mcp-readiness.test.js.map

package/dist/__tests__/mcp-readiness.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-readiness.test.js","sourceRoot":"","sources":["../../src/__tests__/mcp-readiness.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAIL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,YAAY,GAAG;IACnB,GAAG,EAAE,2BAA2B;IAChC,OAAO,EAAE,EAAE,sBAAsB,EAAE,wBAAwB,EAAE;IAC7D,aAAa,EAAE,CAAC,aAAa,EAAE,0BAA0B,CAAC;IAC1D,eAAe,EAAE,CAAC;CACnB,CAAC;AAEF,IAAI,IAAwB,CAAC;AAC7B,MAAM,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;AAElE,SAAS,CAAC,GAAG,EAAE;IACb,IAAI,IAAI;QAAE,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,IAAI,GAAG,SAAS,CAAC;IACjB,IAAI,qBAAqB,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,qBAAqB,CAAC;IAC9D,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,SAAS,sBAAsB,CAAC,SAAmB;IAIjD,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;IACtB,MAAM,MAAM,GAAuB;QACjC,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YACnC,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;SAC3C,CAAC;QACF,KAAK;KACN,CAAC;IACF,OAAO;QACL,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC;QAC1C,KAAK;KACN,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,sBAAsB,CAAC;YAChD,aAAa;YACb,0BAA0B;YAC1B,qBAAqB;SACtB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;QAErF,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;YAC3B,EAAE,EAAE,IAAI;YACR,YAAY,EAAE,UAAU;YACxB,SAAS,EAAE,CAAC;SACb,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC;YACnC,YAAY;YACZ,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;SAChC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,EAAE,OAAO,EAAE,GAAG,sBAAsB,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;QAE5D,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;QAErF,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;YAC3B,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,uBAAuB;YAC7B,KAAK,EAAE,OAAO;YACd,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,CAAC,0BAA0B,CAAC;SAC3C,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC;QACN,GAAG,EAAE,GAAG;KACT,CAAC,CAAC,gEAAgE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAClF,MAAM,OAAO,GAA8B,EAAE;aAC1C,EAAE,EAAE;aACJ,iBAAiB,CAAC,IAAI,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC;QAExE,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;QAErF,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;YAC3B,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,sBAAsB;YAC5B,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,sBAAsB,CAAC;YACzD,aAAa;YACb,0BAA0B;SAC3B,CAAC,CAAC;QACH,MAAM,OAAO,GAA8B,EAAE;aAC1C,EAAE,EAAE;aACJ,qBAAqB,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;aAC9C,kBAAkB,CAAC,cAAc,CAAC,CAAC;QAEtC,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;QAErF,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC;QACN,GAAG,EAAE,GAAG;KACT,CAAC,CAAC,4DAA4D,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC9E,MAAM,OAAO,GAA8B,EAAE;aAC1C,EAAE,EAAE;aACJ,iBAAiB,CAAC,IAAI,mBAAmB,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC,CAAC;QAE/E,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;QAErF,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;YAC3B,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,8BAA8B;YACpC,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC;QAC5B,MAAM,OAAO,GAA8B,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAE9E,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;QAErF,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;YAC3B,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,8BAA8B;YACpC,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,OAAO,GAA8B,EAAE;aAC1C,EAAE,EAAE;aACJ,iBAAiB,CAAC,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC,CAAC;QAEhE,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;QAErF,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;YAC3B,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,0BAA0B;YAChC,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QACzF,MAAM,MAAM,GAAuB;YACjC,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;gBACnC,KAAK,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;aAC5D,CAAC;YACF,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;SAC5D,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,YAAY,EAAE;YACvD,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC;SACjD,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,mEAAmE;QACnE,2CAA2C;QAC3C,OAAO,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;QAC3C,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACtD,MAAM,OAAO,GAA8B,EAAE;aAC1C,EAAE,EAAE;aACJ,iBAAiB,CAAC,IAAI,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC;QAEvE,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,aAAa,EAAE,YAAY,EAAE;YACrE,IAAI;YACJ,aAAa,EAAE,OAAO;SACvB,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC;QACrE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACtD,IAAI,YAAY,GAAe,GAAG,EAAE,CAAC,SAAS,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC9C,YAAY,GAAG,OAAO,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAA8B,EAAE;aAC1C,EAAE,EAAE;aACJ,kBAAkB,CAAC,GAAG,EAAE,CACvB,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC,CACvF,CAAC;QAEJ,MAAM,QAAQ,GAA0B,EAAE,CAAC;QAC3C,IAAI,QAAQ,GAAe,GAAG,EAAE,CAAC,SAAS,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC/C,QAAQ,GAAG,OAAO,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,aAAa,EAAE,YAAY,EAAE;YACrE,IAAI;YACJ,IAAI,EAAE,SAAS;YACf,aAAa,EAAE,OAAO;YACtB,gBAAgB,EAAE,CAAC,OAAO,EAAE,EAAE;gBAC5B,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvB,QAAQ,EAAE,CAAC;YACb,CAAC;SACF,CAAC,CAAC;QAEH,oEAAoE;QACpE,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;YAC3B,EAAE,EAAE,IAAI;YACR,YAAY,EAAE,UAAU;YACxB,kBAAkB,EAAE,aAAa;SAClC,CAAC,CAAC;QACH,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAEjC,YAAY,EAAE,CAAC;QACf,MAAM,UAAU,CAAC;QACjB,MAAM,CAAC,QAAQ,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8EAA8E,EAAE,KAAK,IAAI,EAAE;QAC5F,0EAA0E;QAC1E,gEAAgE;QAChE,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACtD,MAAM,OAAO,GAA8B,EAAE;aAC1C,EAAE,EAAE;aACJ,iBAAiB,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CACvC,aAAa,EACb,EAAE,GAAG,EAAE,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,EACxD,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,CAClD,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,wEAAwE;QACxE,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACtD,MAAM,OAAO,GAA8B,EAAE,CAAC,EAAE,EAAE,CAAC;QAEnD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CACvC,aAAa,EACb,EAAE,GAAG,EAAE,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,CAAC,aAAa,CAAC,EAAE,EACxF,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,CAClD,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC,CAAC;QAC5E,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACtD,MAAM,OAAO,GAA8B,EAAE;aAC1C,EAAE,EAAE;aACJ,iBAAiB,CAAC,IAAI,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC;QAEvE,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,aAAa,EAAE,YAAY,EAAE;YACrE,IAAI;YACJ,IAAI,EAAE,SAAS;YACf,aAAa,EAAE,OAAO;SACvB,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;YAC3B,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,sBAAsB;YAC5B,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACtD,MAAM,OAAO,GAA8B,EAAE,CAAC,EAAE,EAAE,CAAC;QAEnD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,aAAa,EAAE,YAAY,EAAE;YACrE,IAAI;YACJ,IAAI,EAAE,KAAK;YACX,aAAa,EAAE,OAAO;SACvB,CAAC,CAAC;QAEH,4EAA4E;QAC5E,gDAAgD;QAChD,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;QAChE,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC;QACN,EAAE,GAAG,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE;QAC/C,EAAE,GAAG,YAAY,EAAE,eAAe,EAAE,GAAG,EAAE;QACzC,EAAE,GAAG,YAAY,EAAE,aAAa,EAAE,EAAE,EAAE;KACvC,CAAC,CAAC,+DAA+D,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;QACtF,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACtD,MAAM,OAAO,GAA8B,EAAE,CAAC,EAAE,EAAE,CAAC;QAEnD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,aAAa,EAAE,SAAS,EAAE;YAClE,IAAI;YACJ,aAAa,EAAE,OAAO;SACvB,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;YAC3B,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,wBAAwB;YAC9B,KAAK,EAAE,QAAQ;YACf,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,EAAE;SACV,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/mcp-registration-cli.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-registration-cli.test.d.ts.map

package/dist/__tests__/mcp-registration-cli.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-registration-cli.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/mcp-registration-cli.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/mcp-registration-cli.test.js

@@ -0,0 +1,71 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const cliMocks = vi.hoisted(() => ({
+    getDaemonCliEnvironment: vi.fn(() => ({ PATH: "/test/bin" })),
+    resolveBackendRuntimeCommand: vi.fn(() => "/test/bin/provider"),
+    runCliVersionProbeAsync: vi.fn(),
+}));
+vi.mock("../cli-executable.js", () => cliMocks);
+import { __resetMcpInspectCache, inspectAlanMcpThroughProviderCli } from "../mcp-registration.js";
+describe("provider CLI MCP inspection", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        __resetMcpInspectCache();
+        cliMocks.resolveBackendRuntimeCommand.mockReturnValue("/test/bin/provider");
+    });
+    it("checks the version before asking the provider for its effective Alan entry", async () => {
+        cliMocks.runCliVersionProbeAsync
+            .mockResolvedValueOnce({ status: 0, stdout: "codex-cli 1.2.3\n", stderr: "" })
+            .mockResolvedValueOnce({
+            status: 0,
+            stdout: "alan https://api.alan.test/mcp\n",
+            stderr: "",
+        });
+        const result = await inspectAlanMcpThroughProviderCli("codex_app_server", "https://api.alan.test/mcp", "/test/home");
+        expect(result).toEqual({
+            ok: true,
+            verification: {
+                method: "cli",
+                command: "codex mcp get alan",
+                providerVersion: "codex-cli 1.2.3",
+            },
+        });
+        expect(cliMocks.runCliVersionProbeAsync).toHaveBeenNthCalledWith(1, "/test/bin/provider", expect.objectContaining({ HOME: "/test/home", USERPROFILE: "/test/home" }));
+        expect(cliMocks.runCliVersionProbeAsync).toHaveBeenNthCalledWith(2, "/test/bin/provider", expect.any(Object), ["mcp", "get", "alan"], 
+        // The inspection probe carries its own generous timeout (network-bound,
+        // unlike the quick --version probe) so slow unrelated MCP servers don't
+        // false-fail the run.
+        expect.any(Number));
+    });
+    it("returns typed update guidance when the installed CLI lacks MCP inspection", async () => {
+        cliMocks.runCliVersionProbeAsync
+            .mockResolvedValueOnce({ status: 0, stdout: "opencode 0.9.0\n", stderr: "" })
+            .mockResolvedValueOnce({ status: 1, stdout: "", stderr: "unknown command mcp" });
+        const result = await inspectAlanMcpThroughProviderCli("opencode_cli", "https://api.alan.test/mcp", "/test/home");
+        expect(result).toMatchObject({
+            ok: false,
+            issue: { code: "provider_cli_update_required" },
+            verification: { method: "cli", providerVersion: "opencode 0.9.0" },
+        });
+    });
+    it("reuses a successful inspect within the TTL without spawning the CLI again", async () => {
+        cliMocks.runCliVersionProbeAsync
+            .mockResolvedValueOnce({ status: 0, stdout: "cursor-agent 1.0.0\n", stderr: "" })
+            .mockResolvedValueOnce({
+            status: 0,
+            stdout: "alan: ready\n",
+            stderr: "",
+        });
+        const first = await inspectAlanMcpThroughProviderCli("cursor_agent_cli", "https://api.alan.test/mcp", "/test/home");
+        const second = await inspectAlanMcpThroughProviderCli("cursor_agent_cli", "https://api.alan.test/mcp", "/test/home");
+        expect(first.ok).toBe(true);
+        expect(second).toEqual(first);
+        // One --version + one mcp list on the first call; cache skips the second.
+        expect(cliMocks.runCliVersionProbeAsync).toHaveBeenCalledTimes(2);
+    });
+    it("uses file verification when no provider inspection command is documented", async () => {
+        const result = await inspectAlanMcpThroughProviderCli("droid_cli", "https://api.alan.test/mcp", "/test/home");
+        expect(result).toEqual({ ok: true, verification: { method: "file" } });
+        expect(cliMocks.resolveBackendRuntimeCommand).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=mcp-registration-cli.test.js.map

package/dist/__tests__/mcp-registration-cli.test.js.map

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

package/dist/__tests__/mcp-registration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-registration.test.d.ts.map

package/dist/__tests__/mcp-registration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-registration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/mcp-registration.test.ts"],"names":[],"mappings":""}