@lhremote/mcp 0.7.0 → 0.9.0

package/dist/tools/send-invite.test.js

@@ -0,0 +1,80 @@
+// 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,
+        sendInvite: vi.fn(),
+    };
+});
+import { sendInvite, } from "@lhremote/core";
+import { registerSendInvite } from "./send-invite.js";
+import { describeInfrastructureErrors } from "./testing/infrastructure-errors.js";
+import { describeEphemeralActionErrors } from "./testing/ephemeral-action-errors.js";
+import { createMockServer } from "./testing/mock-server.js";
+const MOCK_RESULT = {
+    success: true,
+    personId: 100,
+    results: [{ id: 1, actionVersionId: 1, personId: 100, result: 1, platform: null, createdAt: "2026-01-01T00:00:00Z", profile: null }],
+};
+describe("registerSendInvite", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named send-invite", () => {
+        const { server } = createMockServer();
+        registerSendInvite(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("send-invite", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("sends invite on success with personId", async () => {
+        const { server, getHandler } = createMockServer();
+        registerSendInvite(server);
+        vi.mocked(sendInvite).mockResolvedValue(MOCK_RESULT);
+        const handler = getHandler("send-invite");
+        const result = await handler({ personId: 100, cdpPort: 9222 });
+        expect(sendInvite).toHaveBeenCalledWith(expect.objectContaining({ personId: 100, cdpPort: 9222 }));
+        expect(result).toEqual({
+            content: [{ type: "text", text: JSON.stringify(MOCK_RESULT, null, 2) }],
+        });
+    });
+    it("sends invite with url", async () => {
+        const { server, getHandler } = createMockServer();
+        registerSendInvite(server);
+        vi.mocked(sendInvite).mockResolvedValue(MOCK_RESULT);
+        const handler = getHandler("send-invite");
+        await handler({ url: "https://www.linkedin.com/in/jane-doe", cdpPort: 9222 });
+        expect(sendInvite).toHaveBeenCalledWith(expect.objectContaining({ url: "https://www.linkedin.com/in/jane-doe" }));
+    });
+    it("returns error when neither personId nor url provided", async () => {
+        const { server, getHandler } = createMockServer();
+        registerSendInvite(server);
+        const handler = getHandler("send-invite");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [{ type: "text", text: "Exactly one of personId or url must be provided." }],
+        });
+    });
+    it("returns error on invalid messageTemplate JSON", async () => {
+        const { server, getHandler } = createMockServer();
+        registerSendInvite(server);
+        const handler = getHandler("send-invite");
+        const result = await handler({
+            personId: 100,
+            messageTemplate: "not-json",
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [{ type: "text", text: "Invalid JSON in messageTemplate." }],
+        });
+    });
+    describeInfrastructureErrors(registerSendInvite, "send-invite", () => ({ personId: 100, cdpPort: 9222 }), (error) => vi.mocked(sendInvite).mockRejectedValue(error), "Failed to send invite");
+    describeEphemeralActionErrors(registerSendInvite, "send-invite", () => ({ personId: 100, cdpPort: 9222 }), (error) => vi.mocked(sendInvite).mockRejectedValue(error), "Failed to send invite");
+});
+//# sourceMappingURL=send-invite.test.js.map

package/dist/tools/send-invite.test.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"start-instance.d.ts","sourceRoot":"","sources":["../../src/tools/start-instance.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,+GAA+G;AAC/G,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmE7D"}
+{"version":3,"file":"start-instance.d.ts","sourceRoot":"","sources":["../../src/tools/start-instance.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE,+GAA+G;AAC/G,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwE7D"}

package/dist/tools/start-instance.js

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 // Copyright (C) 2026 Oleksii PELYKH
-import { LauncherService, startInstanceWithRecovery, } from "@lhremote/core";
+import { LauncherService, resolveLauncherPort, startInstanceWithRecovery, } 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#start-instance | start-instance} MCP tool. */
@@ -14,40 +14,46 @@ export function registerStartInstance(server) {
             .describe("Account ID (omit to auto-select if single account)"),
         ...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.");
+            const port = await resolveLauncherPort(cdpPort, cdpHost);
+            const launcher = new LauncherService(port, 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;
                 }
-                if (accounts.length > 1) {
-                    return mcpError("Multiple accounts found. Specify accountId. Use list-accounts to see available accounts.");
+                const outcome = await startInstanceWithRecovery(launcher, resolvedId, port);
+                if (outcome.status === "timeout") {
+                    return mcpError("Instance started but failed to initialize within timeout.");
                 }
-                resolvedId = accounts[0].id;
+                const verb = outcome.status === "already_running"
+                    ? "already running"
+                    : "started";
+                return mcpSuccess(`Instance ${verb} for account ${String(resolvedId)} on CDP port ${String(outcome.port)}`);
             }
-            const outcome = await startInstanceWithRecovery(launcher, resolvedId, cdpPort);
-            if (outcome.status === "timeout") {
-                return mcpError("Instance started but failed to initialize within timeout.");
+            catch (error) {
+                return mcpCatchAll(error, "Failed to start instance");
+            }
+            finally {
+                launcher.disconnect();
             }
-            const verb = outcome.status === "already_running"
-                ? "already running"
-                : "started";
-            return mcpSuccess(`Instance ${verb} for account ${String(resolvedId)} on CDP port ${String(outcome.port)}`);
         }
         catch (error) {
             return mcpCatchAll(error, "Failed to start instance");
         }
-        finally {
-            launcher.disconnect();
-        }
     });
 }
 //# sourceMappingURL=start-instance.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"start-instance.js","sourceRoot":"","sources":["../../src/tools/start-instance.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAEL,eAAe,EACf,yBAAyB,GAC1B,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,+GAA+G;AAC/G,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,qGAAqG,EACrG;QACE,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CACP,oDAAoD,CACrD;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,OAAO,GAAG,MAAM,yBAAyB,CAC7C,QAAQ,EACR,UAAU,EACV,OAAO,CACR,CAAC;YAEF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACjC,OAAO,QAAQ,CACb,2DAA2D,CAC5D,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GACR,OAAO,CAAC,MAAM,KAAK,iBAAiB;gBAClC,CAAC,CAAC,iBAAiB;gBACnB,CAAC,CAAC,SAAS,CAAC;YAEhB,OAAO,UAAU,CACf,YAAY,IAAI,gBAAgB,MAAM,CAAC,UAAU,CAAC,gBAAgB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CACzF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;QACxD,CAAC;gBAAS,CAAC;YACT,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"start-instance.js","sourceRoot":"","sources":["../../src/tools/start-instance.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAEL,eAAe,EACf,mBAAmB,EACnB,yBAAyB,GAC1B,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,+GAA+G;AAC/G,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,qGAAqG,EACrG;QACE,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CACP,oDAAoD,CACrD;QACH,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QACrD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACzD,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;YAEtF,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC3B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,WAAW,CAAC,KAAK,EAAE,mCAAmC,CAAC,CAAC;YACjE,CAAC;YAED,IAAI,CAAC;gBACH,IAAI,UAAU,GAAG,SAAS,CAAC;gBAE3B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;oBAC7B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,CAAC;oBAC/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAC1B,OAAO,QAAQ,CAAC,oBAAoB,CAAC,CAAC;oBACxC,CAAC;oBACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACxB,OAAO,QAAQ,CACb,0FAA0F,CAC3F,CAAC;oBACJ,CAAC;oBACD,UAAU,GAAI,QAAQ,CAAC,CAAC,CAAa,CAAC,EAAE,CAAC;gBAC3C,CAAC;gBAED,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAC7C,QAAQ,EACR,UAAU,EACV,IAAI,CACL,CAAC;gBAEF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBACjC,OAAO,QAAQ,CACb,2DAA2D,CAC5D,CAAC;gBACJ,CAAC;gBAED,MAAM,IAAI,GACR,OAAO,CAAC,MAAM,KAAK,iBAAiB;oBAClC,CAAC,CAAC,iBAAiB;oBACnB,CAAC,CAAC,SAAS,CAAC;gBAEhB,OAAO,UAAU,CACf,YAAY,IAAI,gBAAgB,MAAM,CAAC,UAAU,CAAC,gBAAgB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CACzF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,WAAW,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;YACxD,CAAC;oBAAS,CAAC;gBACT,QAAQ,CAAC,UAAU,EAAE,CAAC;YACxB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

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

@@ -1 +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"}
+{"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;AASzE,6GAA6G;AAC7G,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyD5D"}

package/dist/tools/stop-instance.js

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 // Copyright (C) 2026 Oleksii PELYKH
-import { LauncherService, } from "@lhremote/core";
+import { LauncherService, resolveLauncherPort, } 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. */
@@ -14,34 +14,40 @@ export function registerStopInstance(server) {
             .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.");
+            const port = await resolveLauncherPort(cdpPort, cdpHost);
+            const launcher = new LauncherService(port, 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;
                 }
-                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();
             }
-            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

@@ -1 +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"}
+{"version":3,"file":"stop-instance.js","sourceRoot":"","sources":["../../src/tools/stop-instance.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAEL,eAAe,EACf,mBAAmB,GACpB,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,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACzD,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;YAEtF,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC3B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,WAAW,CAAC,KAAK,EAAE,mCAAmC,CAAC,CAAC;YACjE,CAAC;YAED,IAAI,CAAC;gBACH,IAAI,UAAU,GAAG,SAAS,CAAC;gBAE3B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;oBAC7B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,CAAC;oBAC/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAC1B,OAAO,QAAQ,CAAC,oBAAoB,CAAC,CAAC;oBACxC,CAAC;oBACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACxB,OAAO,QAAQ,CACb,0FAA0F,CAC3F,CAAC;oBACJ,CAAC;oBACD,UAAU,GAAI,QAAQ,CAAC,CAAC,CAAa,CAAC,EAAE,CAAC;gBAC3C,CAAC;gBAED,MAAM,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;gBAExC,OAAO,UAAU,CACf,gCAAgC,MAAM,CAAC,UAAU,CAAC,EAAE,CACrD,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,WAAW,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;YACvD,CAAC;oBAAS,CAAC;gBACT,QAAQ,CAAC,UAAU,EAAE,CAAC;YACxB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/testing/ephemeral-action-errors.d.ts

@@ -0,0 +1,9 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Shared error tests for ephemeral-action-based MCP tools.
+ *
+ * Covers CampaignExecutionError and CampaignTimeoutError in addition to
+ * the infrastructure errors tested by describeInfrastructureErrors.
+ */
+export declare function describeEphemeralActionErrors(registerTool: (server: McpServer) => void, toolName: string, getArgs: () => Record<string, unknown>, mockOperation: (error: Error) => void, errorPrefix: string): void;
+//# sourceMappingURL=ephemeral-action-errors.d.ts.map

package/dist/tools/testing/ephemeral-action-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral-action-errors.d.ts","sourceRoot":"","sources":["../../../src/tools/testing/ephemeral-action-errors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,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,WAAW,EAAE,MAAM,GAClB,IAAI,CA0CN"}

package/dist/tools/testing/ephemeral-action-errors.js

@@ -0,0 +1,48 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { CampaignExecutionError, CampaignTimeoutError } from "@lhremote/core";
+import { describe, expect, it } from "vitest";
+import { createMockServer } from "./mock-server.js";
+/**
+ * Shared error tests for ephemeral-action-based MCP tools.
+ *
+ * Covers CampaignExecutionError and CampaignTimeoutError in addition to
+ * the infrastructure errors tested by describeInfrastructureErrors.
+ */
+export function describeEphemeralActionErrors(registerTool, toolName, getArgs, mockOperation, errorPrefix) {
+    describe("ephemeral action errors", () => {
+        it("returns error on campaign execution failure", async () => {
+            const { server, getHandler } = createMockServer();
+            registerTool(server);
+            mockOperation(new CampaignExecutionError("Person 100 not found in database"));
+            const handler = getHandler(toolName);
+            const result = await handler(getArgs());
+            expect(result).toEqual({
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `${errorPrefix}: Person 100 not found in database`,
+                    },
+                ],
+            });
+        });
+        it("returns error on campaign timeout", async () => {
+            const { server, getHandler } = createMockServer();
+            registerTool(server);
+            mockOperation(new CampaignTimeoutError("Ephemeral action did not complete within 300000ms", 42));
+            const handler = getHandler(toolName);
+            const result = await handler(getArgs());
+            expect(result).toEqual({
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `${errorPrefix}: Ephemeral action did not complete within 300000ms`,
+                    },
+                ],
+            });
+        });
+    });
+}
+//# sourceMappingURL=ephemeral-action-errors.js.map

package/dist/tools/testing/ephemeral-action-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral-action-errors.js","sourceRoot":"","sources":["../../../src/tools/testing/ephemeral-action-errors.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAC3C,YAAyC,EACzC,QAAgB,EAChB,OAAsC,EACtC,aAAqC,EACrC,WAAmB;IAEnB,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;YAC3D,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;YAClD,YAAY,CAAC,MAAM,CAAC,CAAC;YAErB,aAAa,CAAC,IAAI,sBAAsB,CAAC,kCAAkC,CAAC,CAAC,CAAC;YAE9E,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,GAAG,WAAW,oCAAoC;qBACzD;iBACF;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;YAClD,YAAY,CAAC,MAAM,CAAC,CAAC;YAErB,aAAa,CAAC,IAAI,oBAAoB,CAAC,mDAAmD,EAAE,EAAE,CAAC,CAAC,CAAC;YAEjG,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,GAAG,WAAW,qDAAqD;qBAC1E;iBACF;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/visit-profile.d.ts

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

package/dist/tools/visit-profile.d.ts.map

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

package/dist/tools/visit-profile.js

@@ -0,0 +1,37 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { visitProfile, } from "@lhremote/core";
+import { z } from "zod";
+import { cdpConnectionSchema, mcpCatchAll, mcpError, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#visit-profile | visit-profile} MCP tool. */
+export function registerVisitProfile(server) {
+    server.tool("visit-profile", "Visit a LinkedIn profile via LinkedHelper's VisitAndExtract action and return the extracted profile data. Accepts either a person ID or a LinkedIn profile URL. Deducts from the daily action budget.", {
+        personId: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Internal person ID to visit"),
+        url: z
+            .string()
+            .optional()
+            .describe("LinkedIn profile URL (e.g. https://www.linkedin.com/in/jane-doe-123). The person must already exist in the database."),
+        extractCurrentOrganizations: z
+            .boolean()
+            .optional()
+            .describe("Extract current company info during profile visit"),
+        ...cdpConnectionSchema,
+    }, async ({ personId, url, extractCurrentOrganizations, cdpPort, cdpHost, allowRemote }) => {
+        if ((personId == null) === (url == null)) {
+            return mcpError("Exactly one of personId or url must be provided.");
+        }
+        try {
+            const result = await visitProfile({ personId, url, extractCurrentOrganizations, cdpPort, cdpHost, allowRemote });
+            return mcpSuccess(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to visit profile");
+        }
+    });
+}
+//# sourceMappingURL=visit-profile.js.map

package/dist/tools/visit-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visit-profile.js","sourceRoot":"","sources":["../../src/tools/visit-profile.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEvF,6GAA6G;AAC7G,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,eAAe,EACf,uMAAuM,EACvM;QACE,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,6BAA6B,CAAC;QAC1C,GAAG,EAAE,CAAC;aACH,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,sHAAsH,CACvH;QACH,2BAA2B,EAAE,CAAC;aAC3B,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CACP,mDAAmD,CACpD;QACH,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,2BAA2B,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QACtF,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;YACzC,OAAO,QAAQ,CACb,kDAAkD,CACnD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,2BAA2B,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YACjH,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/visit-profile.test.d.ts

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

package/dist/tools/visit-profile.test.d.ts.map

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

package/dist/tools/visit-profile.test.js

@@ -0,0 +1,164 @@
+// 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,
+        visitProfile: vi.fn(),
+    };
+});
+import { AccountResolutionError, visitProfile, } from "@lhremote/core";
+import { registerVisitProfile } from "./visit-profile.js";
+import { describeInfrastructureErrors } from "./testing/infrastructure-errors.js";
+import { createMockServer } from "./testing/mock-server.js";
+const MOCK_PROFILE = {
+    id: 100,
+    miniProfile: {
+        firstName: "Jane",
+        lastName: "Doe",
+        headline: "Software Engineer",
+        avatar: null,
+    },
+    externalIds: [{ externalId: "jane-doe-123", typeGroup: "public", isMemberId: false }],
+    currentPosition: { company: "Acme Corp", title: "Senior Engineer" },
+    education: [],
+    skills: [{ name: "TypeScript" }],
+    emails: [],
+};
+describe("registerVisitProfile", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named visit-profile", () => {
+        const { server } = createMockServer();
+        registerVisitProfile(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("visit-profile", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("returns profile on success with personId", async () => {
+        const { server, getHandler } = createMockServer();
+        registerVisitProfile(server);
+        vi.mocked(visitProfile).mockResolvedValue({
+            success: true,
+            actionType: "VisitAndExtract",
+            profile: MOCK_PROFILE,
+        });
+        const handler = getHandler("visit-profile");
+        const result = await handler({ personId: 100, cdpPort: 9222 });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        actionType: "VisitAndExtract",
+                        profile: MOCK_PROFILE,
+                    }, null, 2),
+                },
+            ],
+        });
+    });
+    it("returns profile on success with url", async () => {
+        const { server, getHandler } = createMockServer();
+        registerVisitProfile(server);
+        vi.mocked(visitProfile).mockResolvedValue({
+            success: true,
+            actionType: "VisitAndExtract",
+            profile: MOCK_PROFILE,
+        });
+        const handler = getHandler("visit-profile");
+        const result = await handler({ url: "https://www.linkedin.com/in/jane-doe-123", cdpPort: 9222 });
+        expect(visitProfile).toHaveBeenCalledWith(expect.objectContaining({ url: "https://www.linkedin.com/in/jane-doe-123", cdpPort: 9222 }));
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: expect.any(String),
+                },
+            ],
+        });
+    });
+    it("returns error when neither personId nor url provided", async () => {
+        const { server, getHandler } = createMockServer();
+        registerVisitProfile(server);
+        const handler = getHandler("visit-profile");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [{ type: "text", text: "Exactly one of personId or url must be provided." }],
+        });
+        expect(visitProfile).not.toHaveBeenCalled();
+    });
+    it("returns error when both personId and url provided", async () => {
+        const { server, getHandler } = createMockServer();
+        registerVisitProfile(server);
+        const handler = getHandler("visit-profile");
+        const result = await handler({ personId: 100, url: "https://www.linkedin.com/in/jane-doe", cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [{ type: "text", text: "Exactly one of personId or url must be provided." }],
+        });
+        expect(visitProfile).not.toHaveBeenCalled();
+    });
+    it("passes correct arguments to operation", async () => {
+        const { server, getHandler } = createMockServer();
+        registerVisitProfile(server);
+        vi.mocked(visitProfile).mockResolvedValue({
+            success: true,
+            actionType: "VisitAndExtract",
+            profile: MOCK_PROFILE,
+        });
+        const handler = getHandler("visit-profile");
+        await handler({ personId: 100, extractCurrentOrganizations: true, cdpPort: 9222 });
+        expect(visitProfile).toHaveBeenCalledWith(expect.objectContaining({ personId: 100, extractCurrentOrganizations: true, cdpPort: 9222 }));
+    });
+    it("returns error when no accounts found", async () => {
+        const { server, getHandler } = createMockServer();
+        registerVisitProfile(server);
+        vi.mocked(visitProfile).mockRejectedValue(new AccountResolutionError("no-accounts"));
+        const handler = getHandler("visit-profile");
+        const result = await handler({ personId: 100, cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [{ type: "text", text: "No accounts found." }],
+        });
+    });
+    it("returns error when multiple accounts found", async () => {
+        const { server, getHandler } = createMockServer();
+        registerVisitProfile(server);
+        vi.mocked(visitProfile).mockRejectedValue(new AccountResolutionError("multiple-accounts"));
+        const handler = getHandler("visit-profile");
+        const result = await handler({ personId: 100, cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Multiple accounts found. Cannot determine which instance to use.",
+                },
+            ],
+        });
+    });
+    it("returns error on unexpected failure", async () => {
+        const { server, getHandler } = createMockServer();
+        registerVisitProfile(server);
+        vi.mocked(visitProfile).mockRejectedValue(new Error("action timed out"));
+        const handler = getHandler("visit-profile");
+        const result = await handler({ personId: 100, cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Failed to visit profile: action timed out",
+                },
+            ],
+        });
+    });
+    describeInfrastructureErrors(registerVisitProfile, "visit-profile", () => ({ personId: 100, cdpPort: 9222 }), (error) => vi.mocked(visitProfile).mockRejectedValue(error), "Failed to visit profile");
+});
+//# sourceMappingURL=visit-profile.test.js.map

package/dist/tools/visit-profile.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lhremote/mcp",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "MCP server for LinkedHelper automation",
   "type": "module",
   "engines": {
@@ -46,7 +46,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
     "zod": "^4.3.6",
-    "@lhremote/core": "^0.7.0"
+    "@lhremote/core": "^0.9.0"
   },
   "devDependencies": {
     "@types/node": "^25",