@agentrq/acp-gateway 0.2.2 → 0.2.4

package/dist/__tests__/agentInstall.test.js

@@ -0,0 +1,342 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { execFileSync } from "node:child_process";
+import { mkdtemp, readFile, rm, stat, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { tmpdir } from "node:os";
+import * as path from "node:path";
+import { archiveKind, assertChecksum, assertVerifiable, defaultCacheDir, downloadArchive, extractArchive, installBinaryAgent, installDir, moveInto, resolveAgentLaunch, runExtractionTool, resolveExecutable, sha256, } from "../agentInstall.js";
+const agent = {
+    id: "demo-acp",
+    name: "Demo Agent",
+    version: "1.2.3",
+    description: "A demo agent",
+    distribution: {},
+};
+/** Builds a real .tar.gz containing an executable, so extraction is exercised for real. */
+async function makeTarball(cmdName, contents) {
+    const staging = await mkdtemp(path.join(tmpdir(), "acp-gateway-fixture-"));
+    try {
+        await writeFile(path.join(staging, cmdName), contents);
+        const archive = path.join(staging, "out.tar.gz");
+        execFileSync("tar", ["-czf", archive, "-C", staging, cmdName]);
+        return new Uint8Array(await readFile(archive));
+    }
+    finally {
+        await rm(staging, { recursive: true, force: true });
+    }
+}
+function okResponse(data) {
+    return {
+        ok: true,
+        status: 200,
+        statusText: "OK",
+        arrayBuffer: async () => data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength),
+    };
+}
+describe("agentInstall", () => {
+    let cacheDir;
+    let errorSpy;
+    beforeEach(async () => {
+        cacheDir = await mkdtemp(path.join(tmpdir(), "acp-gateway-cache-"));
+        errorSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+    });
+    afterEach(async () => {
+        errorSpy.mockRestore();
+        await rm(cacheDir, { recursive: true, force: true });
+    });
+    describe("defaultCacheDir", () => {
+        it("uses XDG_CACHE_HOME where it is set", () => {
+            expect(defaultCacheDir("linux", { XDG_CACHE_HOME: "/xdg" })).toBe(path.join("/xdg", "acp-gateway", "agents"));
+        });
+        it("falls back to the per-user cache on macOS and Linux", () => {
+            expect(defaultCacheDir("darwin", {})).toMatch(/\.cache[\\/]acp-gateway[\\/]agents$/);
+        });
+        it("uses LOCALAPPDATA on Windows", () => {
+            expect(defaultCacheDir("win32", { LOCALAPPDATA: "C:\\Users\\me\\AppData\\Local" })).toBe(path.join("C:\\Users\\me\\AppData\\Local", "acp-gateway", "agents"));
+            expect(defaultCacheDir("win32", {})).toMatch(/AppData[\\/]Local[\\/]acp-gateway/);
+        });
+    });
+    describe("archiveKind", () => {
+        it("recognises every format the registry allows", () => {
+            expect(archiveKind("https://x/y.zip")).toBe("zip");
+            expect(archiveKind("https://x/y.tar.gz")).toBe("tar.gz");
+            expect(archiveKind("https://x/y.tgz")).toBe("tar.gz");
+            expect(archiveKind("https://x/y.tar.bz2")).toBe("tar.bz2");
+            expect(archiveKind("https://x/y.tbz2")).toBe("tar.bz2");
+        });
+        it("ignores query strings and fragments", () => {
+            expect(archiveKind("https://x/y.ZIP?token=abc#frag")).toBe("zip");
+        });
+        it("treats anything else as a raw executable", () => {
+            expect(archiveKind("https://x/agent-darwin-arm64")).toBe("raw");
+        });
+    });
+    describe("installDir", () => {
+        it("keeps each version and platform apart", () => {
+            expect(installDir("/cache", "demo", "darwin-aarch64", "1.2.3")).toBe(path.join("/cache", "demo@1.2.3", "darwin-aarch64"));
+        });
+    });
+    describe("resolveExecutable", () => {
+        it("resolves the registry's cmd inside the install directory", () => {
+            expect(resolveExecutable("/cache/demo", "./bin/agent")).toBe(path.resolve("/cache/demo/bin/agent"));
+        });
+        it("refuses a cmd that climbs out of the install directory", () => {
+            expect(() => resolveExecutable("/cache/demo", "../../../usr/bin/curl")).toThrow(/points outside its install directory/);
+        });
+    });
+    describe("assertVerifiable", () => {
+        const unverifiable = { archive: "https://x/y.zip", cmd: "./demo" };
+        it("refuses an archive the registry publishes no checksum for", () => {
+            expect(() => assertVerifiable(agent, unverifiable, false)).toThrow(/publishes no sha256 for "demo-acp".*--allow-unverified-agent/s);
+        });
+        it("allows it once the user has explicitly opted in", () => {
+            expect(() => assertVerifiable(agent, unverifiable, true)).not.toThrow();
+        });
+        it("allows an archive that does publish a checksum", () => {
+            expect(() => assertVerifiable(agent, { ...unverifiable, sha256: "a".repeat(64) }, false)).not.toThrow();
+        });
+    });
+    describe("assertChecksum", () => {
+        const data = new Uint8Array([1, 2, 3]);
+        it("accepts a download that matches, whatever the case", () => {
+            const digest = sha256(data);
+            expect(() => assertChecksum(agent, { archive: "https://x/y", cmd: "./d", sha256: digest.toUpperCase() }, data)).not.toThrow();
+        });
+        it("refuses a download that does not match", () => {
+            expect(() => assertChecksum(agent, { archive: "https://x/y", cmd: "./d", sha256: "b".repeat(64) }, data)).toThrow(/Checksum mismatch for "demo-acp"/);
+        });
+        it("has nothing to check when the registry publishes no checksum", () => {
+            expect(() => assertChecksum(agent, { archive: "https://x/y", cmd: "./d" }, data)).not.toThrow();
+        });
+    });
+    describe("downloadArchive", () => {
+        it("returns the bytes", async () => {
+            const data = new Uint8Array([9, 8, 7]);
+            const fetchImpl = vi.fn().mockResolvedValue(okResponse(data));
+            expect(await downloadArchive("https://x/y.zip", fetchImpl)).toEqual(data);
+        });
+        it("reports a failed download", async () => {
+            const fetchImpl = vi
+                .fn()
+                .mockResolvedValue({ ok: false, status: 403, statusText: "Forbidden" });
+            await expect(downloadArchive("https://x/y.zip", fetchImpl)).rejects.toThrow(/Failed to download https:\/\/x\/y.zip: 403 Forbidden/);
+        });
+    });
+    describe("extractArchive", () => {
+        it("writes a raw download straight out as the executable", async () => {
+            const dir = path.join(cacheDir, "raw");
+            await extractArchive(new Uint8Array([1, 2]), "raw", dir, "./demo-agent");
+            expect(await readFile(path.join(dir, "demo-agent"))).toEqual(Buffer.from([1, 2]));
+        });
+        it("unpacks a real tarball and removes the archive afterwards", async () => {
+            const tarball = await makeTarball("demo", "#!/bin/sh\necho hi\n");
+            const dir = path.join(cacheDir, "tar");
+            await extractArchive(tarball, "tar.gz", dir, "./demo");
+            expect(await readFile(path.join(dir, "demo"), "utf8")).toContain("echo hi");
+            expect(existsSync(path.join(dir, "archive.tar.gz"))).toBe(false);
+        });
+        it("uses unzip for zips on Linux, where tar cannot read them", async () => {
+            const dir = path.join(cacheDir, "zip");
+            // `unzip` is not guaranteed on every machine, so assert on the failure
+            // message rather than on a successful extraction.
+            await expect(extractArchive(new Uint8Array([1]), "zip", dir, "./demo", "linux")).rejects.toThrow(/unzip/);
+        });
+        it("reports an extraction tool that is not installed", async () => {
+            await expect(runExtractionTool("acp-gateway-no-such-tool", [], cacheDir)).rejects.toThrow(/Could not run "acp-gateway-no-such-tool" to unpack the agent archive/);
+        });
+        it("reports a corrupt archive with the tool's own diagnostics", async () => {
+            const dir = path.join(cacheDir, "bad");
+            await expect(extractArchive(new Uint8Array([1, 2, 3]), "tar.gz", dir, "./demo", "darwin")).rejects.toThrow(/failed to unpack the agent archive/);
+        });
+    });
+    describe("moveInto", () => {
+        it("copies when the staged install cannot simply be renamed into place", async () => {
+            const from = await mkdtemp(path.join(tmpdir(), "acp-gateway-move-"));
+            await writeFile(path.join(from, "demo"), "binary");
+            // A destination whose parents do not exist: rename() fails, and the copy
+            // fallback — the same path taken when the temp dir is another mount —
+            // has to create the tree.
+            const to = path.join(cacheDir, "deep", "deeper", "install");
+            await moveInto(from, to);
+            expect(await readFile(path.join(to, "demo"), "utf8")).toBe("binary");
+            await rm(from, { recursive: true, force: true });
+        });
+    });
+    describe("installBinaryAgent", () => {
+        async function install(overrides = {}) {
+            const tarball = await makeTarball("demo", "#!/bin/sh\nexit 0\n");
+            const target = {
+                archive: "https://example.com/demo.tar.gz",
+                sha256: sha256(tarball),
+                cmd: "./demo",
+                args: ["--acp"],
+                ...overrides.target,
+            };
+            const fetchImpl = vi.fn().mockResolvedValue(okResponse(tarball));
+            const spec = await installBinaryAgent({
+                agent,
+                target,
+                platformTarget: "darwin-aarch64",
+                cacheDir,
+                fetchImpl: fetchImpl,
+                platform: "darwin",
+                ...overrides.options,
+            });
+            return { spec, fetchImpl, tarball };
+        }
+        it("downloads, verifies, unpacks and makes the agent executable", async () => {
+            const { spec } = await install();
+            expect(spec).toEqual({
+                command: path.join(cacheDir, "demo-acp@1.2.3", "darwin-aarch64", "demo"),
+                args: ["--acp"],
+                env: undefined,
+                kind: "binary",
+            });
+            expect(existsSync(spec.command)).toBe(true);
+            // 0o111 — executable by someone.
+            expect((await stat(spec.command)).mode & 0o111).toBeGreaterThan(0);
+        });
+        it("skips the executable bit on Windows, which has none", async () => {
+            const { spec } = await install({ options: { platform: "win32" } });
+            expect(existsSync(spec.command)).toBe(true);
+        });
+        it("reuses a cached install instead of downloading again", async () => {
+            await install();
+            const { fetchImpl } = await install();
+            expect(fetchImpl).not.toHaveBeenCalled();
+            expect(errorSpy.mock.calls.flat().join("\n")).toContain("Using cached demo-acp 1.2.3");
+        });
+        it("refuses an archive with no published checksum", async () => {
+            await expect(install({ target: { sha256: undefined } })).rejects.toThrow(/publishes no sha256/);
+        });
+        it("installs an unverified archive when explicitly allowed, and says so", async () => {
+            const { spec } = await install({
+                target: { sha256: undefined },
+                options: { allowUnverified: true },
+            });
+            expect(existsSync(spec.command)).toBe(true);
+            expect(errorSpy.mock.calls.flat().join("\n")).toContain("publishes no checksum");
+        });
+        it("refuses a download that does not match the checksum", async () => {
+            await expect(install({ target: { sha256: "c".repeat(64) } })).rejects.toThrow(/Checksum mismatch/);
+        });
+        it("leaves nothing cached when the archive lacks the promised command", async () => {
+            await expect(install({ target: { cmd: "./not-in-archive" } })).rejects.toThrow(/does not contain "\.\/not-in-archive"/);
+            expect(existsSync(installDir(cacheDir, agent.id, "darwin-aarch64", agent.version))).toBe(false);
+        });
+    });
+    describe("resolveAgentLaunch", () => {
+        const gemini = {
+            id: "gemini",
+            name: "Gemini CLI",
+            version: "0.58.0",
+            description: "Google's CLI",
+            distribution: { npx: { package: "@google/gemini-cli@0.58.0", args: ["--acp"] } },
+        };
+        const pyAgent = {
+            id: "fast-agent",
+            name: "fast-agent",
+            version: "1.0.0",
+            description: "A Python agent",
+            distribution: { uvx: { package: "fast-agent-mcp" } },
+        };
+        const binaryOnly = {
+            ...agent,
+            distribution: {
+                binary: {
+                    "linux-x86_64": { archive: "https://x/y.tar.gz", sha256: "a".repeat(64), cmd: "./demo" },
+                },
+            },
+        };
+        const registry = {
+            version: "1.0.0",
+            agents: [gemini, pyAgent, binaryOnly],
+        };
+        it("runs npm-distributed agents through npx without downloading anything", async () => {
+            const fetchImpl = vi.fn();
+            const spec = await resolveAgentLaunch({
+                id: "gemini",
+                registry,
+                platformTarget: "darwin-aarch64",
+                fetchImpl: fetchImpl,
+            });
+            expect(spec).toEqual({
+                command: "npx",
+                args: ["-y", "@google/gemini-cli@0.58.0", "--acp"],
+                env: undefined,
+                kind: "npx",
+            });
+            expect(fetchImpl).not.toHaveBeenCalled();
+        });
+        it("names npx explicitly on Windows, where a bare npx cannot be spawned", async () => {
+            const spec = await resolveAgentLaunch({
+                id: "gemini",
+                registry,
+                platformTarget: "windows-x86_64",
+                platform: "win32",
+            });
+            expect(spec.command).toBe("npx.cmd");
+        });
+        it("runs PyPI-distributed agents through uvx", async () => {
+            const spec = await resolveAgentLaunch({
+                id: "fast-agent",
+                registry,
+                platformTarget: "linux-x86_64",
+            });
+            expect(spec).toEqual({
+                command: "uvx",
+                args: ["fast-agent-mcp"],
+                env: undefined,
+                kind: "uvx",
+            });
+        });
+        it("installs the binary when that is the only distribution", async () => {
+            const tarball = await makeTarball("demo", "#!/bin/sh\nexit 0\n");
+            const registryWithDigest = {
+                version: "1.0.0",
+                agents: [
+                    {
+                        ...binaryOnly,
+                        distribution: {
+                            binary: {
+                                "linux-x86_64": {
+                                    archive: "https://x/y.tar.gz",
+                                    sha256: sha256(tarball),
+                                    cmd: "./demo",
+                                },
+                            },
+                        },
+                    },
+                ],
+            };
+            const fetchImpl = vi.fn().mockResolvedValue(okResponse(tarball));
+            const spec = await resolveAgentLaunch({
+                id: "demo-acp",
+                registry: registryWithDigest,
+                platformTarget: "linux-x86_64",
+                cacheDir,
+                fetchImpl: fetchImpl,
+                platform: "linux",
+            });
+            expect(spec.kind).toBe("binary");
+            expect(existsSync(spec.command)).toBe(true);
+        });
+        it("reports an id the registry does not list", async () => {
+            await expect(resolveAgentLaunch({ id: "nope", registry, platformTarget: "linux-x86_64" })).rejects.toThrow(/No agent "nope" in the ACP registry/);
+        });
+        it("reports an agent that has no build for this machine", async () => {
+            await expect(resolveAgentLaunch({ id: "demo-acp", registry, platformTarget: "windows-aarch64" })).rejects.toThrow(/publishes no build of "demo-acp" for windows-aarch64 \(it publishes: binary\)/);
+        });
+        it("says so when an agent publishes no distribution at all", async () => {
+            const empty = {
+                version: "1.0.0",
+                agents: [{ ...agent, distribution: {} }],
+            };
+            await expect(resolveAgentLaunch({ id: "demo-acp", registry: empty, platformTarget: "linux-x86_64" })).rejects.toThrow(/it publishes: nothing/);
+        });
+        it("reports an unsupported platform by name", async () => {
+            await expect(resolveAgentLaunch({ id: "demo-acp", registry, platformTarget: undefined })).rejects.toThrow(/publishes no build of "demo-acp" for/);
+        });
+    });
+});
+//# sourceMappingURL=agentInstall.test.js.map

package/dist/__tests__/agentInstall.test.js.map

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

package/dist/__tests__/auth.test.js

@@ -0,0 +1,283 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { EventEmitter } from "node:events";
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline/promises";
+import { AUTH_REQUIRED_CODE, authMethodType, describeAuthMethods, isAuthRequiredError, login, logout, pickAuthMethod, promptForAuthMethod, runAuthMethod, runTerminalAuth, supportsLogout, } from "../auth.js";
+vi.mock("node:child_process", () => ({ spawn: vi.fn() }));
+vi.mock("node:readline/promises", () => ({ createInterface: vi.fn() }));
+const spawnMock = vi.mocked(spawn);
+const createInterfaceMock = vi.mocked(createInterface);
+const agentMethod = {
+    id: "agent-login",
+    name: "Agent login",
+    description: "Sign in through the agent",
+};
+const terminalMethod = {
+    type: "terminal",
+    id: "cli-login",
+    name: "CLI login",
+    args: ["auth", "login"],
+    env: { AUTH_MODE: "interactive" },
+};
+const launch = { command: "gemini", args: ["--acp"], env: { FROM_CONFIG: "1" } };
+/** An `auth_required` refusal as the SDK surfaces it to the caller. */
+function authRequiredError() {
+    return Object.assign(new Error("Authentication required: run login first"), {
+        code: AUTH_REQUIRED_CODE,
+    });
+}
+describe("auth", () => {
+    let errorSpy;
+    let logSpy;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        errorSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+        logSpy = vi.spyOn(console, "log").mockImplementation(() => { });
+    });
+    afterEach(() => {
+        errorSpy.mockRestore();
+        logSpy.mockRestore();
+    });
+    describe("authMethodType", () => {
+        it("treats a missing type as the agent-driven default", () => {
+            expect(authMethodType(agentMethod)).toBe("agent");
+            expect(authMethodType({ ...agentMethod, type: "agent" })).toBe("agent");
+        });
+        it("recognises terminal methods", () => {
+            expect(authMethodType(terminalMethod)).toBe("terminal");
+        });
+    });
+    describe("describeAuthMethods", () => {
+        it("says so when the agent needs no login", () => {
+            expect(describeAuthMethods([])).toMatch(/no authentication methods/);
+            expect(describeAuthMethods(undefined)).toMatch(/no authentication methods/);
+            expect(describeAuthMethods(null)).toMatch(/no authentication methods/);
+        });
+        it("numbers the methods and marks terminal ones", () => {
+            const text = describeAuthMethods([agentMethod, terminalMethod]);
+            expect(text).toContain("1. Agent login (agent-login) — Sign in through the agent");
+            expect(text).toContain("2. CLI login (cli-login) [terminal login]");
+        });
+    });
+    describe("isAuthRequiredError", () => {
+        it("recognises the protocol's auth_required refusal", () => {
+            expect(isAuthRequiredError(authRequiredError())).toBe(true);
+        });
+        it("reads the error out of a nested JSON-RPC envelope", () => {
+            expect(isAuthRequiredError({
+                error: { code: AUTH_REQUIRED_CODE, message: "auth_required" },
+            })).toBe(true);
+        });
+        it("reads the top level when `error` is not an envelope", () => {
+            expect(isAuthRequiredError({
+                error: "auth_required",
+                code: AUTH_REQUIRED_CODE,
+                message: "Authentication required",
+            })).toBe(true);
+        });
+        it("ignores other failures that share the -32000 code", () => {
+            expect(isAuthRequiredError(Object.assign(new Error("permission failed"), { code: AUTH_REQUIRED_CODE }))).toBe(false);
+        });
+        it("ignores errors with a different code or no shape at all", () => {
+            expect(isAuthRequiredError(Object.assign(new Error("Authentication required"), { code: -32603 }))).toBe(false);
+            expect(isAuthRequiredError({ code: AUTH_REQUIRED_CODE })).toBe(false);
+            expect(isAuthRequiredError(new Error("Authentication required"))).toBe(false);
+            expect(isAuthRequiredError("nope")).toBe(false);
+            expect(isAuthRequiredError(null)).toBe(false);
+        });
+    });
+    describe("pickAuthMethod", () => {
+        it("returns nothing when the agent advertises no methods", () => {
+            expect(pickAuthMethod([])).toBeUndefined();
+            expect(pickAuthMethod(undefined)).toBeUndefined();
+        });
+        it("honours an explicitly named method, terminal included", () => {
+            expect(pickAuthMethod([agentMethod, terminalMethod], { preferredId: "cli-login" })).toBe(terminalMethod);
+        });
+        it("returns nothing when the named method is not advertised", () => {
+            expect(pickAuthMethod([agentMethod], { preferredId: "missing" })).toBeUndefined();
+        });
+        it("prefers agent-driven methods, which need no human", () => {
+            expect(pickAuthMethod([terminalMethod, agentMethod])).toBe(agentMethod);
+        });
+        it("falls back to a terminal method only when a terminal is available", () => {
+            expect(pickAuthMethod([terminalMethod])).toBeUndefined();
+            expect(pickAuthMethod([terminalMethod], { allowTerminal: true })).toBe(terminalMethod);
+        });
+    });
+    describe("promptForAuthMethod", () => {
+        it("returns nothing when there is nothing to choose from", async () => {
+            expect(await promptForAuthMethod([], vi.fn())).toBeUndefined();
+        });
+        it("does not ask when the agent offers a single method", async () => {
+            const ask = vi.fn();
+            expect(await promptForAuthMethod([agentMethod], ask)).toBe(agentMethod);
+            expect(ask).not.toHaveBeenCalled();
+        });
+        it("takes the first method when the user just hits enter", async () => {
+            const ask = vi.fn().mockResolvedValue("  ");
+            expect(await promptForAuthMethod([agentMethod, terminalMethod], ask)).toBe(agentMethod);
+        });
+        it("accepts a selection by number", async () => {
+            const ask = vi.fn().mockResolvedValue("2");
+            expect(await promptForAuthMethod([agentMethod, terminalMethod], ask)).toBe(terminalMethod);
+        });
+        it("accepts a selection by method id", async () => {
+            const ask = vi.fn().mockResolvedValue("cli-login");
+            expect(await promptForAuthMethod([agentMethod, terminalMethod], ask)).toBe(terminalMethod);
+        });
+        it("re-asks after an answer that matches nothing", async () => {
+            const ask = vi.fn().mockResolvedValueOnce("99").mockResolvedValueOnce("1");
+            expect(await promptForAuthMethod([agentMethod, terminalMethod], ask)).toBe(agentMethod);
+            expect(ask).toHaveBeenCalledTimes(2);
+            expect(errorSpy).toHaveBeenCalledWith('[auth] "99" is not one of the listed methods.');
+        });
+        it("gives up after three unusable answers", async () => {
+            const ask = vi.fn().mockResolvedValue("nonsense");
+            expect(await promptForAuthMethod([agentMethod, terminalMethod], ask)).toBeUndefined();
+            expect(ask).toHaveBeenCalledTimes(3);
+        });
+        it("asks on the terminal when no asker is supplied", async () => {
+            const close = vi.fn();
+            createInterfaceMock.mockReturnValue({
+                question: vi.fn().mockResolvedValue("2"),
+                close,
+            });
+            expect(await promptForAuthMethod([agentMethod, terminalMethod])).toBe(terminalMethod);
+            expect(createInterfaceMock).toHaveBeenCalledWith({
+                input: process.stdin,
+                output: process.stderr,
+            });
+            expect(close).toHaveBeenCalled();
+        });
+    });
+    describe("runTerminalAuth", () => {
+        it("re-runs the agent invocation with the method's args and env", async () => {
+            const child = new EventEmitter();
+            spawnMock.mockReturnValue(child);
+            const pending = runTerminalAuth(terminalMethod, launch);
+            child.emit("exit", 0, null);
+            await expect(pending).resolves.toBeUndefined();
+            expect(spawnMock).toHaveBeenCalledWith("gemini", ["--acp", "auth", "login"], expect.objectContaining({
+                stdio: "inherit",
+                env: expect.objectContaining({ FROM_CONFIG: "1", AUTH_MODE: "interactive" }),
+            }));
+        });
+        it("passes no extra args or env when the method declares none", async () => {
+            const child = new EventEmitter();
+            spawnMock.mockReturnValue(child);
+            const pending = runTerminalAuth({ ...agentMethod, type: "terminal" }, {
+                command: "gemini",
+                args: ["--acp"],
+            });
+            child.emit("exit", 0, null);
+            await pending;
+            expect(spawnMock).toHaveBeenCalledWith("gemini", ["--acp"], expect.anything());
+        });
+        it("fails when the login process exits non-zero", async () => {
+            const child = new EventEmitter();
+            spawnMock.mockReturnValue(child);
+            const pending = runTerminalAuth(terminalMethod, launch);
+            child.emit("exit", 1, null);
+            await expect(pending).rejects.toThrow(/Terminal login "cli-login" failed \(code=1/);
+        });
+        it("fails when the login process cannot start", async () => {
+            const child = new EventEmitter();
+            spawnMock.mockReturnValue(child);
+            const pending = runTerminalAuth(terminalMethod, launch);
+            child.emit("error", new Error("ENOENT"));
+            await expect(pending).rejects.toThrow(/failed to start: ENOENT/);
+        });
+    });
+    describe("runAuthMethod", () => {
+        it("asks the agent to authenticate for agent-driven methods", async () => {
+            const connection = { authenticate: vi.fn().mockResolvedValue({}), logout: vi.fn() };
+            await runAuthMethod(connection, agentMethod, launch);
+            expect(connection.authenticate).toHaveBeenCalledWith({ methodId: "agent-login" });
+        });
+        it("never sends a terminal method to authenticate", async () => {
+            const child = new EventEmitter();
+            spawnMock.mockReturnValue(child);
+            const connection = { authenticate: vi.fn(), logout: vi.fn() };
+            const pending = runAuthMethod(connection, terminalMethod, launch);
+            child.emit("exit", 0, null);
+            await pending;
+            expect(connection.authenticate).not.toHaveBeenCalled();
+            expect(spawnMock).toHaveBeenCalled();
+        });
+    });
+    describe("login", () => {
+        const connection = () => ({ authenticate: vi.fn().mockResolvedValue({}), logout: vi.fn() });
+        it("does nothing when the agent advertises no login", async () => {
+            const conn = connection();
+            expect(await login({ connection: conn, methods: [], launch })).toBeUndefined();
+            expect(conn.authenticate).not.toHaveBeenCalled();
+        });
+        it("logs in with the method the user named", async () => {
+            const conn = connection();
+            const used = await login({
+                connection: conn,
+                methods: [agentMethod, { ...agentMethod, id: "other", name: "Other" }],
+                launch,
+                preferredId: "other",
+            });
+            expect(used?.id).toBe("other");
+            expect(conn.authenticate).toHaveBeenCalledWith({ methodId: "other" });
+        });
+        it("rejects a method the agent does not advertise", async () => {
+            await expect(login({ connection: connection(), methods: [agentMethod], launch, preferredId: "nope" })).rejects.toThrow(/Unknown authentication method "nope"/);
+        });
+        it("picks an agent-driven method when running unattended", async () => {
+            const conn = connection();
+            const used = await login({ connection: conn, methods: [terminalMethod, agentMethod], launch });
+            expect(used).toBe(agentMethod);
+        });
+        it("asks the user which method to use when a terminal is available", async () => {
+            const conn = connection();
+            const ask = vi.fn().mockResolvedValue("1");
+            const used = await login({
+                connection: conn,
+                methods: [agentMethod, terminalMethod],
+                launch,
+                interactive: true,
+                ask,
+            });
+            expect(used).toBe(agentMethod);
+            expect(ask).toHaveBeenCalled();
+        });
+        it("fails when only a terminal login is offered and no terminal is available", async () => {
+            await expect(login({ connection: connection(), methods: [terminalMethod], launch })).rejects.toThrow(/No usable authentication method/);
+        });
+        it("fails when the user does not choose a method", async () => {
+            await expect(login({
+                connection: connection(),
+                methods: [agentMethod, terminalMethod],
+                launch,
+                interactive: true,
+                ask: vi.fn().mockResolvedValue("nonsense"),
+            })).rejects.toThrow(/No usable authentication method/);
+        });
+    });
+    describe("supportsLogout", () => {
+        it("is true only when the agent advertises the capability", () => {
+            expect(supportsLogout({ auth: { logout: {} } })).toBe(true);
+            expect(supportsLogout({ auth: { logout: null } })).toBe(false);
+            expect(supportsLogout({ auth: {} })).toBe(false);
+            expect(supportsLogout({})).toBe(false);
+            expect(supportsLogout(undefined)).toBe(false);
+        });
+    });
+    describe("logout", () => {
+        it("skips agents that do not implement logout", async () => {
+            const conn = { authenticate: vi.fn(), logout: vi.fn() };
+            expect(await logout(conn, {})).toBe(false);
+            expect(conn.logout).not.toHaveBeenCalled();
+        });
+        it("ends the authenticated state when supported", async () => {
+            const conn = { authenticate: vi.fn(), logout: vi.fn().mockResolvedValue({}) };
+            expect(await logout(conn, { auth: { logout: {} } })).toBe(true);
+            expect(conn.logout).toHaveBeenCalledWith({});
+        });
+    });
+});
+//# sourceMappingURL=auth.test.js.map