@lhremote/mcp 0.0.0 → 0.2.0

package/dist/tools/check-replies.js

@@ -0,0 +1,24 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { checkReplies, } from "@lhremote/core";
+import { z } from "zod";
+import { cdpConnectionSchema, mcpCatchAll, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#check-replies | check-replies} MCP tool. */
+export function registerCheckReplies(server) {
+    server.tool("check-replies", "Trigger LinkedHelper to check for new message replies on LinkedIn, then return any new messages found. If `since` is omitted, returns messages from the last 24 hours.", {
+        since: z
+            .string()
+            .optional()
+            .describe("ISO timestamp; only return messages after this time. If omitted, returns messages from the last 24 hours"),
+        ...cdpConnectionSchema,
+    }, async ({ since, cdpPort, cdpHost, allowRemote }) => {
+        try {
+            const result = await checkReplies({ since, cdpPort, cdpHost, allowRemote });
+            return mcpSuccess(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to check replies");
+        }
+    });
+}
+//# sourceMappingURL=check-replies.js.map

package/dist/tools/check-replies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-replies.js","sourceRoot":"","sources":["../../src/tools/check-replies.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,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7E,6GAA6G;AAC7G,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,eAAe,EACf,wKAAwK,EACxK;QACE,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,0GAA0G,CAC3G;QACH,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QACjD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YAC5E,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/check-replies.test.d.ts

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

package/dist/tools/check-replies.test.d.ts.map

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

package/dist/tools/check-replies.test.js

@@ -0,0 +1,192 @@
+// 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,
+        checkReplies: vi.fn(),
+    };
+});
+import { AccountResolutionError, checkReplies, } from "@lhremote/core";
+import { registerCheckReplies } from "./check-replies.js";
+import { describeInfrastructureErrors } from "./testing/infrastructure-errors.js";
+import { createMockServer } from "./testing/mock-server.js";
+const MOCK_CONVERSATIONS = [
+    {
+        chatId: 123,
+        personId: 456,
+        personName: "Jane Doe",
+        messages: [
+            {
+                id: 789,
+                type: "MEMBER_TO_MEMBER",
+                text: "Thanks for reaching out!",
+                subject: null,
+                sendAt: "2025-01-15T10:30:00Z",
+                attachmentsCount: 0,
+                senderPersonId: 456,
+                senderFirstName: "Jane",
+                senderLastName: "Doe",
+            },
+        ],
+    },
+    {
+        chatId: 124,
+        personId: 790,
+        personName: "John Smith",
+        messages: [
+            {
+                id: 791,
+                type: "MEMBER_TO_MEMBER",
+                text: "Let's schedule a call",
+                subject: null,
+                sendAt: "2025-01-15T11:00:00Z",
+                attachmentsCount: 0,
+                senderPersonId: 790,
+                senderFirstName: "John",
+                senderLastName: "Smith",
+            },
+            {
+                id: 792,
+                type: "MEMBER_TO_MEMBER",
+                text: "How about Thursday?",
+                subject: null,
+                sendAt: "2025-01-15T11:05:00Z",
+                attachmentsCount: 0,
+                senderPersonId: 790,
+                senderFirstName: "John",
+                senderLastName: "Smith",
+            },
+        ],
+    },
+];
+describe("registerCheckReplies", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named check-replies", () => {
+        const { server } = createMockServer();
+        registerCheckReplies(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("check-replies", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("returns new messages on success", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCheckReplies(server);
+        vi.mocked(checkReplies).mockResolvedValue({
+            newMessages: MOCK_CONVERSATIONS,
+            totalNew: 3,
+            checkedAt: "2025-01-15T12:00:00.000Z",
+        });
+        const handler = getHandler("check-replies");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        newMessages: MOCK_CONVERSATIONS,
+                        totalNew: 3,
+                        checkedAt: "2025-01-15T12:00:00.000Z",
+                    }, null, 2),
+                },
+            ],
+        });
+    });
+    it("passes correct arguments to operation", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCheckReplies(server);
+        vi.mocked(checkReplies).mockResolvedValue({
+            newMessages: [],
+            totalNew: 0,
+            checkedAt: "2025-01-15T12:00:00.000Z",
+        });
+        const handler = getHandler("check-replies");
+        await handler({ since: "2025-01-14T00:00:00Z", cdpPort: 9222 });
+        expect(checkReplies).toHaveBeenCalledWith(expect.objectContaining({ since: "2025-01-14T00:00:00Z", cdpPort: 9222 }));
+    });
+    it("passes since as undefined when omitted", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCheckReplies(server);
+        vi.mocked(checkReplies).mockResolvedValue({
+            newMessages: [],
+            totalNew: 0,
+            checkedAt: "2025-01-15T12:00:00.000Z",
+        });
+        const handler = getHandler("check-replies");
+        await handler({ cdpPort: 9222 });
+        expect(checkReplies).toHaveBeenCalledWith(expect.objectContaining({ cdpPort: 9222 }));
+    });
+    it("returns empty results when no new messages", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCheckReplies(server);
+        vi.mocked(checkReplies).mockResolvedValue({
+            newMessages: [],
+            totalNew: 0,
+            checkedAt: "2025-01-15T12:00:00.000Z",
+        });
+        const handler = getHandler("check-replies");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        newMessages: [],
+                        totalNew: 0,
+                        checkedAt: "2025-01-15T12:00:00.000Z",
+                    }, null, 2),
+                },
+            ],
+        });
+    });
+    it("returns error when no accounts found", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCheckReplies(server);
+        vi.mocked(checkReplies).mockRejectedValue(new AccountResolutionError("no-accounts"));
+        const handler = getHandler("check-replies");
+        const result = await handler({ 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();
+        registerCheckReplies(server);
+        vi.mocked(checkReplies).mockRejectedValue(new AccountResolutionError("multiple-accounts"));
+        const handler = getHandler("check-replies");
+        const result = await handler({ 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();
+        registerCheckReplies(server);
+        vi.mocked(checkReplies).mockRejectedValue(new Error("action timed out"));
+        const handler = getHandler("check-replies");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Failed to check replies: action timed out",
+                },
+            ],
+        });
+    });
+    describeInfrastructureErrors(registerCheckReplies, "check-replies", () => ({ cdpPort: 9222 }), (error) => vi.mocked(checkReplies).mockRejectedValue(error), "Failed to check replies");
+});
+//# sourceMappingURL=check-replies.test.js.map

package/dist/tools/check-replies.test.js.map

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

package/dist/tools/check-status.d.ts

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

package/dist/tools/check-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-status.d.ts","sourceRoot":"","sources":["../../src/tools/check-status.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,2GAA2G;AAC3G,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiB3D"}

package/dist/tools/check-status.js

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { checkStatus } from "@lhremote/core";
+import { buildCdpOptions, cdpConnectionSchema, mcpCatchAll, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#check-status | check-status} MCP tool. */
+export function registerCheckStatus(server) {
+    server.tool("check-status", "Check LinkedHelper connection status, running instances, and database health", {
+        ...cdpConnectionSchema,
+    }, async ({ cdpPort, cdpHost, allowRemote }) => {
+        try {
+            const report = await checkStatus(cdpPort, buildCdpOptions({ cdpHost, allowRemote }));
+            return mcpSuccess(JSON.stringify(report, null, 2));
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to check status");
+        }
+    });
+}
+//# sourceMappingURL=check-status.js.map

package/dist/tools/check-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-status.js","sourceRoot":"","sources":["../../src/tools/check-status.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE9F,2GAA2G;AAC3G,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,IAAI,CACT,cAAc,EACd,8EAA8E,EAC9E;QACE,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;YAErF,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,wBAAwB,CAAC,CAAC;QACtD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/check-status.test.d.ts

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

package/dist/tools/check-status.test.d.ts.map

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

package/dist/tools/check-status.test.js

@@ -0,0 +1,88 @@
+// 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,
+        checkStatus: vi.fn(),
+    };
+});
+import { checkStatus } from "@lhremote/core";
+import { registerCheckStatus } from "./check-status.js";
+import { createMockServer } from "./testing/mock-server.js";
+const mockedCheckStatus = vi.mocked(checkStatus);
+describe("registerCheckStatus", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named check-status", () => {
+        const { server } = createMockServer();
+        registerCheckStatus(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("check-status", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("returns status report as JSON", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCheckStatus(server);
+        const report = {
+            launcher: { reachable: true, port: 9222 },
+            instances: [
+                { accountId: 1, accountName: "Alice", cdpPort: 54321 },
+            ],
+            databases: [
+                { accountId: 1, path: "/path/to/db.db", profileCount: 100 },
+            ],
+        };
+        mockedCheckStatus.mockResolvedValue(report);
+        const handler = getHandler("check-status");
+        const result = (await handler({ cdpPort: 9222 }));
+        expect(JSON.parse(result.content[0].text)).toEqual(report);
+    });
+    it("returns status when launcher is not reachable", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCheckStatus(server);
+        const report = {
+            launcher: { reachable: false, port: 9222 },
+            instances: [],
+            databases: [],
+        };
+        mockedCheckStatus.mockResolvedValue(report);
+        const handler = getHandler("check-status");
+        const result = (await handler({ cdpPort: 9222 }));
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.launcher.reachable).toBe(false);
+    });
+    it("passes cdpPort to checkStatus", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCheckStatus(server);
+        mockedCheckStatus.mockResolvedValue({
+            launcher: { reachable: false, port: 4567 },
+            instances: [],
+            databases: [],
+        });
+        const handler = getHandler("check-status");
+        await handler({ cdpPort: 4567 });
+        expect(mockedCheckStatus).toHaveBeenCalledWith(4567, {});
+    });
+    it("returns error when checkStatus throws", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCheckStatus(server);
+        mockedCheckStatus.mockRejectedValue(new Error("unexpected failure"));
+        const handler = getHandler("check-status");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Failed to check status: unexpected failure",
+                },
+            ],
+        });
+    });
+});
+//# sourceMappingURL=check-status.test.js.map

package/dist/tools/check-status.test.js.map

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

package/dist/tools/describe-actions.d.ts

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

package/dist/tools/describe-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-actions.d.ts","sourceRoot":"","sources":["../../src/tools/describe-actions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,mHAAmH;AACnH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+B/D"}

package/dist/tools/describe-actions.js

@@ -0,0 +1,30 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { getActionTypeCatalog, getActionTypeInfo } from "@lhremote/core";
+import { z } from "zod";
+import { mcpError, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#describe-actions | describe-actions} MCP tool. */
+export function registerDescribeActions(server) {
+    server.tool("describe-actions", "List available LinkedHelper action types with descriptions and configuration schemas. Use this to discover what actions can be included in campaigns.", {
+        category: z
+            .enum(["people", "messaging", "engagement", "crm", "workflow", "all"])
+            .optional()
+            .default("all")
+            .describe("Filter by action category"),
+        actionType: z
+            .string()
+            .optional()
+            .describe("Get detailed info for a specific action type"),
+    }, async ({ category, actionType }) => {
+        if (actionType !== undefined) {
+            const info = getActionTypeInfo(actionType);
+            if (info === undefined) {
+                return mcpError(`Unknown action type: ${actionType}`);
+            }
+            return mcpSuccess(JSON.stringify(info, null, 2));
+        }
+        const catalog = getActionTypeCatalog(category === "all" ? undefined : category);
+        return mcpSuccess(JSON.stringify(catalog, null, 2));
+    });
+}
+//# sourceMappingURL=describe-actions.js.map

package/dist/tools/describe-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-actions.js","sourceRoot":"","sources":["../../src/tools/describe-actions.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAErD,mHAAmH;AACnH,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,uJAAuJ,EACvJ;QACE,QAAQ,EAAE,CAAC;aACR,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;aACrE,QAAQ,EAAE;aACV,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CAAC,2BAA2B,CAAC;QACxC,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,8CAA8C,CAAC;KAC5D,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QACjC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAC3C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO,QAAQ,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAC;YACxD,CAAC;YACD,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,OAAO,GAAG,oBAAoB,CAClC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAC1C,CAAC;QAEF,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/describe-actions.test.d.ts

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

package/dist/tools/describe-actions.test.d.ts.map

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

package/dist/tools/describe-actions.test.js

@@ -0,0 +1,120 @@
+// 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,
+        getActionTypeCatalog: vi.fn(),
+        getActionTypeInfo: vi.fn(),
+    };
+});
+import { getActionTypeCatalog, getActionTypeInfo, } from "@lhremote/core";
+import { registerDescribeActions } from "./describe-actions.js";
+import { createMockServer } from "./testing/mock-server.js";
+const mockedGetActionTypeCatalog = vi.mocked(getActionTypeCatalog);
+const mockedGetActionTypeInfo = vi.mocked(getActionTypeInfo);
+describe("registerDescribeActions", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named describe-actions", () => {
+        const { server } = createMockServer();
+        registerDescribeActions(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("describe-actions", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("returns full catalog when no params", async () => {
+        const { server, getHandler } = createMockServer();
+        registerDescribeActions(server);
+        const catalog = {
+            actionTypes: [
+                {
+                    name: "VisitAndExtract",
+                    description: "Visit a LinkedIn profile and extract data.",
+                    category: "people",
+                    configSchema: {},
+                },
+                {
+                    name: "Follow",
+                    description: "Follow a LinkedIn profile.",
+                    category: "engagement",
+                    configSchema: {},
+                },
+            ],
+        };
+        mockedGetActionTypeCatalog.mockReturnValue(catalog);
+        const handler = getHandler("describe-actions");
+        const result = (await handler({ category: "all" }));
+        expect(mockedGetActionTypeCatalog).toHaveBeenCalledWith(undefined);
+        expect(JSON.parse(result.content[0].text)).toEqual(catalog);
+    });
+    it("filters by category", async () => {
+        const { server, getHandler } = createMockServer();
+        registerDescribeActions(server);
+        const catalog = {
+            actionTypes: [
+                {
+                    name: "Follow",
+                    description: "Follow a LinkedIn profile.",
+                    category: "engagement",
+                    configSchema: {},
+                },
+            ],
+        };
+        mockedGetActionTypeCatalog.mockReturnValue(catalog);
+        const handler = getHandler("describe-actions");
+        const result = (await handler({ category: "engagement" }));
+        expect(mockedGetActionTypeCatalog).toHaveBeenCalledWith("engagement");
+        expect(JSON.parse(result.content[0].text)).toEqual(catalog);
+    });
+    it("returns specific action type info", async () => {
+        const { server, getHandler } = createMockServer();
+        registerDescribeActions(server);
+        const info = {
+            name: "VisitAndExtract",
+            description: "Visit a LinkedIn profile and extract data.",
+            category: "people",
+            configSchema: {
+                extractCurrentOrganizations: {
+                    type: "boolean",
+                    required: false,
+                    description: "Whether to extract full profile data.",
+                    default: true,
+                },
+            },
+            example: { extractCurrentOrganizations: true },
+        };
+        mockedGetActionTypeInfo.mockReturnValue(info);
+        const handler = getHandler("describe-actions");
+        const result = (await handler({
+            category: "all",
+            actionType: "VisitAndExtract",
+        }));
+        expect(mockedGetActionTypeInfo).toHaveBeenCalledWith("VisitAndExtract");
+        expect(JSON.parse(result.content[0].text)).toEqual(info);
+    });
+    it("returns error for unknown action type", async () => {
+        const { server, getHandler } = createMockServer();
+        registerDescribeActions(server);
+        mockedGetActionTypeInfo.mockReturnValue(undefined);
+        const handler = getHandler("describe-actions");
+        const result = await handler({
+            category: "all",
+            actionType: "NonExistent",
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Unknown action type: NonExistent",
+                },
+            ],
+        });
+    });
+});
+//# sourceMappingURL=describe-actions.test.js.map

package/dist/tools/describe-actions.test.js.map

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

package/dist/tools/find-app.d.ts

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

package/dist/tools/find-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-app.d.ts","sourceRoot":"","sources":["../../src/tools/find-app.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,mGAAmG;AACnG,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmBvD"}

package/dist/tools/find-app.js

@@ -0,0 +1,20 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { findApp } from "@lhremote/core";
+import { mcpCatchAll, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#find-app | find-app} MCP tool. */
+export function registerFindApp(server) {
+    server.tool("find-app", "Detect running LinkedHelper application instances and their CDP connection details", {}, async () => {
+        try {
+            const apps = await findApp();
+            if (apps.length === 0) {
+                return mcpSuccess("No running LinkedHelper instances found");
+            }
+            return mcpSuccess(JSON.stringify(apps, null, 2));
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to find LinkedHelper");
+        }
+    });
+}
+//# sourceMappingURL=find-app.js.map

package/dist/tools/find-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-app.js","sourceRoot":"","sources":["../../src/tools/find-app.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAExD,mGAAmG;AACnG,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,IAAI,CACT,UAAU,EACV,oFAAoF,EACpF,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAC;YAE7B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,UAAU,CAAC,yCAAyC,CAAC,CAAC;YAC/D,CAAC;YAED,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,EAAE,6BAA6B,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/find-app.test.d.ts

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

package/dist/tools/find-app.test.d.ts.map

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