@lhremote/mcp 0.0.0 → 0.2.0

package/dist/tools/start-instance.test.js

@@ -0,0 +1,234 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("@lhremote/core", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        LauncherService: vi.fn(),
+        startInstanceWithRecovery: vi.fn(),
+    };
+});
+import { LauncherService, LinkedHelperNotRunningError, startInstanceWithRecovery, } from "@lhremote/core";
+import { registerStartInstance } from "./start-instance.js";
+import { createMockServer } from "./testing/mock-server.js";
+function mockLauncher(overrides = {}) {
+    const disconnect = vi.fn();
+    vi.mocked(LauncherService).mockImplementation(function () {
+        return {
+            connect: vi.fn().mockResolvedValue(undefined),
+            disconnect,
+            listAccounts: vi.fn().mockResolvedValue([]),
+            startInstance: vi.fn().mockResolvedValue(undefined),
+            stopInstance: vi.fn().mockResolvedValue(undefined),
+            ...overrides,
+        };
+    });
+    return { disconnect };
+}
+describe("registerStartInstance", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named start-instance", () => {
+        const { server } = createMockServer();
+        registerStartInstance(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("start-instance", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("returns success with account and port", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStartInstance(server);
+        mockLauncher();
+        vi.mocked(startInstanceWithRecovery).mockResolvedValue({
+            status: "started",
+            port: 55123,
+        });
+        const handler = getHandler("start-instance");
+        const result = await handler({ accountId: 42, cdpPort: 9222 });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: "Instance started for account 42 on CDP port 55123",
+                },
+            ],
+        });
+    });
+    it("auto-selects single account when accountId omitted", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStartInstance(server);
+        const accounts = [
+            { id: 42, liId: 42, name: "Alice" },
+        ];
+        mockLauncher({
+            listAccounts: vi.fn().mockResolvedValue(accounts),
+        });
+        vi.mocked(startInstanceWithRecovery).mockResolvedValue({
+            status: "started",
+            port: 55123,
+        });
+        const handler = getHandler("start-instance");
+        const result = await handler({ cdpPort: 9222 });
+        expect(startInstanceWithRecovery).toHaveBeenCalledWith(expect.anything(), 42, 9222);
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: "Instance started for account 42 on CDP port 55123",
+                },
+            ],
+        });
+    });
+    it("returns error when no accounts and accountId omitted", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStartInstance(server);
+        mockLauncher({
+            listAccounts: vi.fn().mockResolvedValue([]),
+        });
+        const handler = getHandler("start-instance");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [{ type: "text", text: "No accounts found." }],
+        });
+    });
+    it("returns error when multiple accounts and accountId omitted", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStartInstance(server);
+        const accounts = [
+            { id: 1, liId: 1, name: "Alice" },
+            { id: 2, liId: 2, name: "Bob" },
+        ];
+        mockLauncher({
+            listAccounts: vi.fn().mockResolvedValue(accounts),
+        });
+        const handler = getHandler("start-instance");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Multiple accounts found. Specify accountId. Use list-accounts to see available accounts.",
+                },
+            ],
+        });
+    });
+    it("returns error when LinkedHelper not running", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStartInstance(server);
+        vi.mocked(LauncherService).mockImplementation(function () {
+            return {
+                connect: vi
+                    .fn()
+                    .mockRejectedValue(new LinkedHelperNotRunningError(9222)),
+                disconnect: vi.fn(),
+            };
+        });
+        const handler = getHandler("start-instance");
+        const result = await handler({ accountId: 42, cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "LinkedHelper is not running. Use launch-app first.",
+                },
+            ],
+        });
+    });
+    it("treats 'already running' as idempotent success when port is discoverable", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStartInstance(server);
+        mockLauncher();
+        vi.mocked(startInstanceWithRecovery).mockResolvedValue({
+            status: "already_running",
+            port: 55123,
+        });
+        const handler = getHandler("start-instance");
+        const result = await handler({ accountId: 42, cdpPort: 9222 });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: "Instance already running for account 42 on CDP port 55123",
+                },
+            ],
+        });
+    });
+    it("returns error when instance fails to initialize within timeout", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStartInstance(server);
+        mockLauncher();
+        vi.mocked(startInstanceWithRecovery).mockResolvedValue({
+            status: "timeout",
+        });
+        const handler = getHandler("start-instance");
+        const result = await handler({ accountId: 42, cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Instance started but failed to initialize within timeout.",
+                },
+            ],
+        });
+    });
+    it("returns error on unexpected error", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStartInstance(server);
+        mockLauncher();
+        vi.mocked(startInstanceWithRecovery).mockRejectedValue(new Error("unexpected failure"));
+        const handler = getHandler("start-instance");
+        const result = await handler({ accountId: 42, cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Failed to start instance: unexpected failure",
+                },
+            ],
+        });
+    });
+    it("passes cdpPort to LauncherService", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStartInstance(server);
+        mockLauncher();
+        vi.mocked(startInstanceWithRecovery).mockResolvedValue({
+            status: "started",
+            port: 55123,
+        });
+        const handler = getHandler("start-instance");
+        await handler({ accountId: 42, cdpPort: 4567 });
+        expect(LauncherService).toHaveBeenCalledWith(4567, {});
+    });
+    it("disconnects after successful call", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStartInstance(server);
+        const { disconnect } = mockLauncher();
+        vi.mocked(startInstanceWithRecovery).mockResolvedValue({
+            status: "started",
+            port: 55123,
+        });
+        const handler = getHandler("start-instance");
+        await handler({ accountId: 42, cdpPort: 9222 });
+        expect(disconnect).toHaveBeenCalledOnce();
+    });
+    it("disconnects after error", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStartInstance(server);
+        const { disconnect } = mockLauncher({
+            listAccounts: vi.fn().mockResolvedValue([]),
+        });
+        const handler = getHandler("start-instance");
+        await handler({ cdpPort: 9222 });
+        expect(disconnect).toHaveBeenCalledOnce();
+    });
+});
+//# sourceMappingURL=start-instance.test.js.map

package/dist/tools/start-instance.test.js.map

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

package/dist/tools/stop-instance.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#stop-instance | stop-instance} MCP tool. */
+export declare function registerStopInstance(server: McpServer): void;
+//# sourceMappingURL=stop-instance.d.ts.map

package/dist/tools/stop-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-instance.d.ts","sourceRoot":"","sources":["../../src/tools/stop-instance.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,6GAA6G;AAC7G,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoD5D"}

package/dist/tools/stop-instance.js

@@ -0,0 +1,47 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { LauncherService, } from "@lhremote/core";
+import { z } from "zod";
+import { buildCdpOptions, cdpConnectionSchema, mcpCatchAll, mcpError, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#stop-instance | stop-instance} MCP tool. */
+export function registerStopInstance(server) {
+    server.tool("stop-instance", "Stop a running LinkedHelper instance", {
+        accountId: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Account ID (omit to stop the only running instance)"),
+        ...cdpConnectionSchema,
+    }, async ({ accountId, cdpPort, cdpHost, allowRemote }) => {
+        const launcher = new LauncherService(cdpPort, buildCdpOptions({ cdpHost, allowRemote }));
+        try {
+            await launcher.connect();
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to connect to LinkedHelper");
+        }
+        try {
+            let resolvedId = accountId;
+            if (resolvedId === undefined) {
+                const accounts = await launcher.listAccounts();
+                if (accounts.length === 0) {
+                    return mcpError("No accounts found.");
+                }
+                if (accounts.length > 1) {
+                    return mcpError("Multiple accounts found. Specify accountId. Use list-accounts to see available accounts.");
+                }
+                resolvedId = accounts[0].id;
+            }
+            await launcher.stopInstance(resolvedId);
+            return mcpSuccess(`Instance stopped for account ${String(resolvedId)}`);
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to stop instance");
+        }
+        finally {
+            launcher.disconnect();
+        }
+    });
+}
+//# sourceMappingURL=stop-instance.js.map

package/dist/tools/stop-instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-instance.js","sourceRoot":"","sources":["../../src/tools/stop-instance.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAEL,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAExG,6GAA6G;AAC7G,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,eAAe,EACf,sCAAsC,EACtC;QACE,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CACP,qDAAqD,CACtD;QACH,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QACrD,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;QAEzF,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,EAAE,mCAAmC,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,CAAC;YACH,IAAI,UAAU,GAAG,SAAS,CAAC;YAE3B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,CAAC;gBAC/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC1B,OAAO,QAAQ,CAAC,oBAAoB,CAAC,CAAC;gBACxC,CAAC;gBACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxB,OAAO,QAAQ,CACb,0FAA0F,CAC3F,CAAC;gBACJ,CAAC;gBACD,UAAU,GAAI,QAAQ,CAAC,CAAC,CAAa,CAAC,EAAE,CAAC;YAC3C,CAAC;YAED,MAAM,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;YAExC,OAAO,UAAU,CACf,gCAAgC,MAAM,CAAC,UAAU,CAAC,EAAE,CACrD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;QACvD,CAAC;gBAAS,CAAC;YACT,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/stop-instance.test.d.ts

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

package/dist/tools/stop-instance.test.d.ts.map

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

package/dist/tools/stop-instance.test.js

@@ -0,0 +1,179 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("@lhremote/core", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        LauncherService: vi.fn(),
+    };
+});
+import { LauncherService, LinkedHelperNotRunningError, } from "@lhremote/core";
+import { registerStopInstance } from "./stop-instance.js";
+import { createMockServer } from "./testing/mock-server.js";
+function mockLauncher(overrides = {}) {
+    const disconnect = vi.fn();
+    vi.mocked(LauncherService).mockImplementation(function () {
+        return {
+            connect: vi.fn().mockResolvedValue(undefined),
+            disconnect,
+            listAccounts: vi.fn().mockResolvedValue([]),
+            stopInstance: vi.fn().mockResolvedValue(undefined),
+            ...overrides,
+        };
+    });
+    return { disconnect };
+}
+describe("registerStopInstance", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named stop-instance", () => {
+        const { server } = createMockServer();
+        registerStopInstance(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("stop-instance", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("returns success when instance stopped", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStopInstance(server);
+        const stopInstance = vi.fn().mockResolvedValue(undefined);
+        mockLauncher({ stopInstance });
+        const handler = getHandler("stop-instance");
+        const result = await handler({ accountId: 42, cdpPort: 9222 });
+        expect(stopInstance).toHaveBeenCalledWith(42);
+        expect(result).toEqual({
+            content: [
+                { type: "text", text: "Instance stopped for account 42" },
+            ],
+        });
+    });
+    it("auto-selects single account when accountId omitted", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStopInstance(server);
+        const accounts = [
+            { id: 42, liId: 42, name: "Alice" },
+        ];
+        const stopInstance = vi.fn().mockResolvedValue(undefined);
+        mockLauncher({
+            listAccounts: vi.fn().mockResolvedValue(accounts),
+            stopInstance,
+        });
+        const handler = getHandler("stop-instance");
+        const result = await handler({ cdpPort: 9222 });
+        expect(stopInstance).toHaveBeenCalledWith(42);
+        expect(result).toEqual({
+            content: [
+                { type: "text", text: "Instance stopped for account 42" },
+            ],
+        });
+    });
+    it("returns error when no accounts and accountId omitted", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStopInstance(server);
+        mockLauncher({
+            listAccounts: vi.fn().mockResolvedValue([]),
+        });
+        const handler = getHandler("stop-instance");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [{ type: "text", text: "No accounts found." }],
+        });
+    });
+    it("returns error when multiple accounts and accountId omitted", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStopInstance(server);
+        const accounts = [
+            { id: 1, liId: 1, name: "Alice" },
+            { id: 2, liId: 2, name: "Bob" },
+        ];
+        mockLauncher({
+            listAccounts: vi.fn().mockResolvedValue(accounts),
+        });
+        const handler = getHandler("stop-instance");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Multiple accounts found. Specify accountId. Use list-accounts to see available accounts.",
+                },
+            ],
+        });
+    });
+    it("returns error when LinkedHelper not running", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStopInstance(server);
+        vi.mocked(LauncherService).mockImplementation(function () {
+            return {
+                connect: vi
+                    .fn()
+                    .mockRejectedValue(new LinkedHelperNotRunningError(9222)),
+                disconnect: vi.fn(),
+            };
+        });
+        const handler = getHandler("stop-instance");
+        const result = await handler({ accountId: 42, cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "LinkedHelper is not running. Use launch-app first.",
+                },
+            ],
+        });
+    });
+    it("returns error on unexpected error", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStopInstance(server);
+        mockLauncher({
+            stopInstance: vi
+                .fn()
+                .mockRejectedValue(new Error("unexpected failure")),
+        });
+        const handler = getHandler("stop-instance");
+        const result = await handler({ accountId: 42, cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Failed to stop instance: unexpected failure",
+                },
+            ],
+        });
+    });
+    it("passes cdpPort to LauncherService", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStopInstance(server);
+        mockLauncher();
+        const handler = getHandler("stop-instance");
+        await handler({ accountId: 42, cdpPort: 4567 });
+        expect(LauncherService).toHaveBeenCalledWith(4567, {});
+    });
+    it("disconnects after successful call", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStopInstance(server);
+        const { disconnect } = mockLauncher();
+        const handler = getHandler("stop-instance");
+        await handler({ accountId: 42, cdpPort: 9222 });
+        expect(disconnect).toHaveBeenCalledOnce();
+    });
+    it("disconnects after error", async () => {
+        const { server, getHandler } = createMockServer();
+        registerStopInstance(server);
+        const { disconnect } = mockLauncher({
+            stopInstance: vi.fn().mockRejectedValue(new Error("fail")),
+        });
+        const handler = getHandler("stop-instance");
+        await handler({ accountId: 42, cdpPort: 9222 });
+        expect(disconnect).toHaveBeenCalledOnce();
+    });
+});
+//# sourceMappingURL=stop-instance.test.js.map

package/dist/tools/stop-instance.test.js.map

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

package/dist/tools/testing/infrastructure-errors.d.ts

@@ -0,0 +1,18 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Shared infrastructure error tests for MCP tools that delegate to core operations.
+ *
+ * Covers the two error paths common to all such tools:
+ * - `LinkedHelperNotRunningError` → fixed "LinkedHelper is not running" message
+ * - Generic connection error → `"${connectionErrorPrefix}: <message>"` message
+ *
+ * @param registerTool - Function that registers the tool under test on an MCP server.
+ * @param toolName - The registered tool name (used to look up the handler).
+ * @param getArgs - Returns the arguments to invoke the handler with.
+ * @param mockOperation - A function that configures the mocked operation to reject with the given error.
+ * @param connectionErrorPrefix - The expected prefix in the generic connection error message
+ *   (e.g. `"Failed to connect to LinkedHelper"`). If omitted, the generic connection error
+ *   test is skipped (some tools only test the `LinkedHelperNotRunningError` path).
+ */
+export declare function describeInfrastructureErrors(registerTool: (server: McpServer) => void, toolName: string, getArgs: () => Record<string, unknown>, mockOperation: (error: Error) => void, connectionErrorPrefix?: string): void;
+//# sourceMappingURL=infrastructure-errors.d.ts.map

package/dist/tools/testing/infrastructure-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infrastructure-errors.d.ts","sourceRoot":"","sources":["../../../src/tools/testing/infrastructure-errors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,EACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EACrC,qBAAqB,CAAC,EAAE,MAAM,GAC7B,IAAI,CA4CN"}

package/dist/tools/testing/infrastructure-errors.js

@@ -0,0 +1,59 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { LinkedHelperNotRunningError } from "@lhremote/core";
+import { describe, expect, it } from "vitest";
+import { createMockServer } from "./mock-server.js";
+/**
+ * Shared infrastructure error tests for MCP tools that delegate to core operations.
+ *
+ * Covers the two error paths common to all such tools:
+ * - `LinkedHelperNotRunningError` → fixed "LinkedHelper is not running" message
+ * - Generic connection error → `"${connectionErrorPrefix}: <message>"` message
+ *
+ * @param registerTool - Function that registers the tool under test on an MCP server.
+ * @param toolName - The registered tool name (used to look up the handler).
+ * @param getArgs - Returns the arguments to invoke the handler with.
+ * @param mockOperation - A function that configures the mocked operation to reject with the given error.
+ * @param connectionErrorPrefix - The expected prefix in the generic connection error message
+ *   (e.g. `"Failed to connect to LinkedHelper"`). If omitted, the generic connection error
+ *   test is skipped (some tools only test the `LinkedHelperNotRunningError` path).
+ */
+export function describeInfrastructureErrors(registerTool, toolName, getArgs, mockOperation, connectionErrorPrefix) {
+    describe("infrastructure errors", () => {
+        it("returns error when LinkedHelper is not running", async () => {
+            const { server, getHandler } = createMockServer();
+            registerTool(server);
+            mockOperation(new LinkedHelperNotRunningError(9222));
+            const handler = getHandler(toolName);
+            const result = await handler(getArgs());
+            expect(result).toEqual({
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: "LinkedHelper is not running. Use launch-app first.",
+                    },
+                ],
+            });
+        });
+        if (connectionErrorPrefix) {
+            it("returns error when connection fails", async () => {
+                const { server, getHandler } = createMockServer();
+                registerTool(server);
+                mockOperation(new Error("connection refused"));
+                const handler = getHandler(toolName);
+                const result = await handler(getArgs());
+                expect(result).toEqual({
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: `${connectionErrorPrefix}: connection refused`,
+                        },
+                    ],
+                });
+            });
+        }
+    });
+}
+//# sourceMappingURL=infrastructure-errors.js.map

package/dist/tools/testing/infrastructure-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infrastructure-errors.js","sourceRoot":"","sources":["../../../src/tools/testing/infrastructure-errors.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,4BAA4B,CAC1C,YAAyC,EACzC,QAAgB,EAChB,OAAsC,EACtC,aAAqC,EACrC,qBAA8B;IAE9B,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;QACrC,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;YAC9D,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;YAClD,YAAY,CAAC,MAAM,CAAC,CAAC;YAErB,aAAa,CAAC,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC;YAErD,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAExC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,oDAAoD;qBAC3D;iBACF;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,qBAAqB,EAAE,CAAC;YAC1B,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;gBACnD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;gBAClD,YAAY,CAAC,MAAM,CAAC,CAAC;gBAErB,aAAa,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;gBAE/C,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACrC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;gBAExC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;oBACrB,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,GAAG,qBAAqB,sBAAsB;yBACrD;qBACF;iBACF,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/testing/mock-server.d.ts

@@ -0,0 +1,10 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+export declare function createMockServer(): {
+    server: McpServer;
+    getHandler: (name: string) => (...args: unknown[]) => Promise<unknown>;
+    getSchema: (name: string) => z.ZodObject<Readonly<{
+        [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    }>, z.core.$strip> | undefined;
+};
+//# sourceMappingURL=mock-server.d.ts.map

package/dist/tools/testing/mock-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-server.d.ts","sourceRoot":"","sources":["../../../src/tools/testing/mock-server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,wBAAgB,gBAAgB;;uBAmBJ,MAAM,eAvBb,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC;sBA6BxB,MAAM;;;EAOhC"}

package/dist/tools/testing/mock-server.js

@@ -0,0 +1,33 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { vi } from "vitest";
+import { z } from "zod";
+export function createMockServer() {
+    const tools = new Map();
+    const server = {
+        tool: vi.fn((...args) => {
+            const name = args[0];
+            const handler = args[args.length - 1];
+            // server.tool(name, description, schema, handler)
+            const rawSchema = args.length >= 4
+                ? args[2]
+                : undefined;
+            const schema = rawSchema ? z.object(rawSchema) : undefined;
+            tools.set(name, { handler, schema });
+        }),
+    };
+    function getHandler(name) {
+        const entry = tools.get(name);
+        if (!entry)
+            throw new Error(`Tool "${name}" not registered`);
+        return entry.handler;
+    }
+    function getSchema(name) {
+        const entry = tools.get(name);
+        if (!entry)
+            throw new Error(`Tool "${name}" not registered`);
+        return entry.schema;
+    }
+    return { server, getHandler, getSchema };
+}
+//# sourceMappingURL=mock-server.js.map

package/dist/tools/testing/mock-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-server.js","sourceRoot":"","sources":["../../../src/tools/testing/mock-server.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE3C,MAAM,MAAM,GAAG;QACb,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAe,EAAE,EAAE;YACjC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAW,CAAC;YAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAEf,CAAC;YACtB,kDAAkD;YAClD,MAAM,SAAS,GACb,IAAI,CAAC,MAAM,IAAI,CAAC;gBACd,CAAC,CAAE,IAAI,CAAC,CAAC,CAA6B;gBACtC,CAAC,CAAC,SAAS,CAAC;YAChB,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3D,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACvC,CAAC,CAAC;KACqB,CAAC;IAE1B,SAAS,UAAU,CAAC,IAAY;QAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,kBAAkB,CAAC,CAAC;QAC7D,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,SAAS,SAAS,CAAC,IAAY;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,kBAAkB,CAAC,CAAC;QAC7D,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AAC3C,CAAC"}