@lhremote/mcp 0.0.0 → 0.1.0

package/dist/tools/stop-instance.js

@@ -0,0 +1,101 @@
+import { LauncherService, LinkedHelperNotRunningError, } from "@lhremote/core";
+import { z } from "zod";
+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)"),
+        cdpPort: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .default(9222)
+            .describe("CDP port (default: 9222)"),
+    }, async ({ accountId, cdpPort }) => {
+        const launcher = new LauncherService(cdpPort);
+        try {
+            await launcher.connect();
+        }
+        catch (error) {
+            if (error instanceof LinkedHelperNotRunningError) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: "LinkedHelper is not running. Use launch-app first.",
+                        },
+                    ],
+                };
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to connect to LinkedHelper: ${message}`,
+                    },
+                ],
+            };
+        }
+        try {
+            let resolvedId = accountId;
+            if (resolvedId === undefined) {
+                const accounts = await launcher.listAccounts();
+                if (accounts.length === 0) {
+                    return {
+                        isError: true,
+                        content: [
+                            {
+                                type: "text",
+                                text: "No accounts found.",
+                            },
+                        ],
+                    };
+                }
+                if (accounts.length > 1) {
+                    return {
+                        isError: true,
+                        content: [
+                            {
+                                type: "text",
+                                text: "Multiple accounts found. Specify accountId. Use list-accounts to see available accounts.",
+                            },
+                        ],
+                    };
+                }
+                resolvedId = accounts[0].id;
+            }
+            await launcher.stopInstance(resolvedId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Instance stopped for account ${String(resolvedId)}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to stop instance: ${message}`,
+                    },
+                ],
+            };
+        }
+        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":"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"}

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,177 @@
+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":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;IACjD,MAAM,MAAM,GAAG,MAAM,cAAc,EAAmC,CAAC;IACvE,OAAO;QACL,GAAG,MAAM;QACT,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE;KACzB,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,OAAO,EAEL,eAAe,EACf,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,SAAS,YAAY,CAAC,YAAqC,EAAE;IAC3D,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;IAC3B,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,kBAAkB,CAAC;QAC5C,OAAO;YACL,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;YAC7C,UAAU;YACV,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC3C,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;YAClD,GAAG,SAAS;SACiB,CAAC;IAClC,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC;AAED,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;QACtC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,CACtC,eAAe,EACf,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAClB,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAClB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CACrB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC1D,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;QAE/B,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/D,MAAM,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iCAAiC,EAAE;aAC1D;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,MAAM,QAAQ,GAAc;YAC1B,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;SACpC,CAAC;QAEF,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC1D,YAAY,CAAC;YACX,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC;YACjD,YAAY;SACb,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhD,MAAM,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iCAAiC,EAAE;aAC1D;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,YAAY,CAAC;YACX,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;SAC5C,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;SACxD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,MAAM,QAAQ,GAAc;YAC1B,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE;YACjC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE;SAChC,CAAC;QAEF,YAAY,CAAC;YACX,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC;SAClD,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,0FAA0F;iBACjG;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,kBAAkB,CAAC;YAC5C,OAAO;gBACL,OAAO,EAAE,EAAE;qBACR,EAAE,EAAE;qBACJ,iBAAiB,CAAC,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC;gBAC3D,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;aACU,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,oDAAoD;iBAC3D;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,YAAY,CAAC;YACX,YAAY,EAAE,EAAE;iBACb,EAAE,EAAE;iBACJ,iBAAiB,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;SACtD,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,6CAA6C;iBACpD;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,YAAY,EAAE,CAAC;QAEf,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhD,MAAM,CAAC,eAAe,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,MAAM,EAAE,UAAU,EAAE,GAAG,YAAY,EAAE,CAAC;QAEtC,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhD,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;QACvC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,MAAM,EAAE,UAAU,EAAE,GAAG,YAAY,CAAC;YAClC,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;SAC3D,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhD,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createMockServer(): {
+    server: McpServer;
+    getHandler: (name: string) => (...args: unknown[]) => Promise<unknown>;
+};
+//# 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":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,gBAAgB;;uBAgBJ,MAAM,eAbpB,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC;EAoB3C"}

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

@@ -0,0 +1,19 @@
+import { vi } from "vitest";
+export function createMockServer() {
+    const tools = new Map();
+    const server = {
+        tool: vi.fn((...args) => {
+            const name = args[0];
+            const handler = args[args.length - 1];
+            tools.set(name, handler);
+        }),
+    };
+    function getHandler(name) {
+        const handler = tools.get(name);
+        if (!handler)
+            throw new Error(`Tool "${name}" not registered`);
+        return handler;
+    }
+    return { server, getHandler };
+}
+//# 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":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE5B,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GAAG,IAAI,GAAG,EAGlB,CAAC;IAEJ,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,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC,CAAC;KACqB,CAAC;IAE1B,SAAS,UAAU,CAAC,IAAY;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,kBAAkB,CAAC,CAAC;QAC/D,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAChC,CAAC"}

package/dist/tools/visit-and-extract.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerVisitAndExtract(server: McpServer): void;
+//# sourceMappingURL=visit-and-extract.d.ts.map

package/dist/tools/visit-and-extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visit-and-extract.d.ts","sourceRoot":"","sources":["../../src/tools/visit-and-extract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAezE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsL/D"}

package/dist/tools/visit-and-extract.js

@@ -0,0 +1,183 @@
+import { DatabaseClient, discoverDatabase, discoverInstancePort, ExtractionTimeoutError, InstanceNotRunningError, InstanceService, LauncherService, LinkedHelperNotRunningError, ProfileService, } from "@lhremote/core";
+import { z } from "zod";
+export function registerVisitAndExtract(server) {
+    server.tool("visit-and-extract", "Visit a LinkedIn profile via LinkedHelper and extract all available data (name, positions, education, skills, emails). Requires a running instance.", {
+        profileUrl: z
+            .string()
+            .url()
+            .describe("LinkedIn profile URL (e.g., https://www.linkedin.com/in/username)"),
+        cdpPort: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .default(9222)
+            .describe("CDP port (default: 9222)"),
+    }, async ({ profileUrl, cdpPort }) => {
+        // Validate LinkedIn URL format
+        if (!isLinkedInProfileUrl(profileUrl)) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: "Invalid LinkedIn profile URL. Expected: https://www.linkedin.com/in/username",
+                    },
+                ],
+            };
+        }
+        // Connect to launcher to find running instance
+        const launcher = new LauncherService(cdpPort);
+        try {
+            await launcher.connect();
+        }
+        catch (error) {
+            if (error instanceof LinkedHelperNotRunningError) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: "LinkedHelper is not running. Use launch-app first.",
+                        },
+                    ],
+                };
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to connect to LinkedHelper: ${message}`,
+                    },
+                ],
+            };
+        }
+        let accountId;
+        try {
+            const accounts = await launcher.listAccounts();
+            if (accounts.length === 0) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: "No accounts found.",
+                        },
+                    ],
+                };
+            }
+            if (accounts.length > 1) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: "Multiple accounts found. Cannot determine which instance to use.",
+                        },
+                    ],
+                };
+            }
+            accountId = accounts[0].id;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to list accounts: ${message}`,
+                    },
+                ],
+            };
+        }
+        finally {
+            launcher.disconnect();
+        }
+        // Discover instance CDP port
+        const instancePort = await discoverInstancePort(cdpPort);
+        if (instancePort === null) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: "No LinkedHelper instance is running. Use start-instance first.",
+                    },
+                ],
+            };
+        }
+        // Connect to instance
+        const instance = new InstanceService(instancePort);
+        let db = null;
+        try {
+            await instance.connect();
+            // Discover and open database
+            const dbPath = discoverDatabase(accountId);
+            db = new DatabaseClient(dbPath);
+            // Run visit-and-extract workflow
+            const profileService = new ProfileService(instance, db);
+            const profile = await profileService.visitAndExtract(profileUrl);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(profile, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            if (error instanceof InstanceNotRunningError) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: "No LinkedHelper instance is running. Use start-instance first.",
+                        },
+                    ],
+                };
+            }
+            if (error instanceof ExtractionTimeoutError) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: "Profile extraction timed out. The profile may not have loaded correctly.",
+                        },
+                    ],
+                };
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to extract profile: ${message}`,
+                    },
+                ],
+            };
+        }
+        finally {
+            instance.disconnect();
+            db?.close();
+        }
+    });
+}
+function isLinkedInProfileUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return ((parsed.hostname === "www.linkedin.com" ||
+            parsed.hostname === "linkedin.com") &&
+            parsed.pathname.startsWith("/in/"));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=visit-and-extract.js.map

package/dist/tools/visit-and-extract.js.map

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

package/dist/tools/visit-and-extract.test.d.ts

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

package/dist/tools/visit-and-extract.test.d.ts.map

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