@lhremote/mcp 0.6.0 → 0.8.0

package/dist/tools/dismiss-errors.d.ts

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

package/dist/tools/dismiss-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismiss-errors.d.ts","sourceRoot":"","sources":["../../src/tools/dismiss-errors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,+GAA+G;AAC/G,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgB7D"}

package/dist/tools/dismiss-errors.js

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { dismissErrors } from "@lhremote/core";
+import { cdpConnectionSchema, mcpCatchAll, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#dismiss-errors | dismiss-errors} MCP tool. */
+export function registerDismissErrors(server) {
+    server.tool("dismiss-errors", "Dismiss closable error popups in LinkedHelper instance UI by clicking their close/OK buttons. Use this tool when operations fail with UI errors or when get-errors reports closable popups. Recommended after UIBlockedError.", {
+        ...cdpConnectionSchema,
+    }, async ({ cdpPort, cdpHost, allowRemote }) => {
+        try {
+            const result = await dismissErrors({ cdpPort, cdpHost, allowRemote });
+            return mcpSuccess(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to dismiss errors");
+        }
+    });
+}
+//# sourceMappingURL=dismiss-errors.js.map

package/dist/tools/dismiss-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismiss-errors.js","sourceRoot":"","sources":["../../src/tools/dismiss-errors.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7E,+GAA+G;AAC/G,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,+NAA+N,EAC/N;QACE,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YACtE,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,0BAA0B,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/dismiss-errors.test.d.ts

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

package/dist/tools/dismiss-errors.test.d.ts.map

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

package/dist/tools/dismiss-errors.test.js

@@ -0,0 +1,74 @@
+// 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,
+        dismissErrors: vi.fn(),
+    };
+});
+import { dismissErrors } from "@lhremote/core";
+import { registerDismissErrors } from "./dismiss-errors.js";
+import { createMockServer } from "./testing/mock-server.js";
+const mockedDismissErrors = vi.mocked(dismissErrors);
+describe("registerDismissErrors", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named dismiss-errors", () => {
+        const { server } = createMockServer();
+        registerDismissErrors(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("dismiss-errors", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("returns result as JSON", async () => {
+        const { server, getHandler } = createMockServer();
+        registerDismissErrors(server);
+        const output = {
+            accountId: 1,
+            dismissed: 2,
+            nonDismissable: 0,
+        };
+        mockedDismissErrors.mockResolvedValue(output);
+        const handler = getHandler("dismiss-errors");
+        const result = (await handler({ cdpPort: 9222 }));
+        expect(JSON.parse(result.content[0].text)).toEqual(output);
+    });
+    it("returns error when dismissErrors throws", async () => {
+        const { server, getHandler } = createMockServer();
+        registerDismissErrors(server);
+        mockedDismissErrors.mockRejectedValue(new Error("unexpected failure"));
+        const handler = getHandler("dismiss-errors");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Failed to dismiss errors: unexpected failure",
+                },
+            ],
+        });
+    });
+    it("passes cdpPort to dismissErrors", async () => {
+        const { server, getHandler } = createMockServer();
+        registerDismissErrors(server);
+        mockedDismissErrors.mockResolvedValue({
+            accountId: 1,
+            dismissed: 0,
+            nonDismissable: 0,
+        });
+        const handler = getHandler("dismiss-errors");
+        await handler({ cdpPort: 4567 });
+        expect(mockedDismissErrors).toHaveBeenCalledWith({
+            cdpPort: 4567,
+            cdpHost: undefined,
+            allowRemote: undefined,
+        });
+    });
+});
+//# sourceMappingURL=dismiss-errors.test.js.map

package/dist/tools/dismiss-errors.test.js.map

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

package/dist/tools/endorse-skills.d.ts

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

package/dist/tools/endorse-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endorse-skills.d.ts","sourceRoot":"","sources":["../../src/tools/endorse-skills.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,+GAA+G;AAC/G,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkD7D"}

package/dist/tools/endorse-skills.js

@@ -0,0 +1,53 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { endorseSkills } from "@lhremote/core";
+import { z } from "zod";
+import { cdpConnectionSchema, mcpCatchAll, mcpError, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#endorse-skills | endorse-skills} MCP tool. */
+export function registerEndorseSkills(server) {
+    server.tool("endorse-skills", "Endorse skills on a LinkedIn profile via an ephemeral campaign. Accepts a person ID or LinkedIn profile URL. Deducts from the daily action budget.", {
+        personId: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Internal person ID"),
+        url: z
+            .string()
+            .optional()
+            .describe("LinkedIn profile URL (e.g. https://www.linkedin.com/in/jane-doe)"),
+        skillNames: z
+            .array(z.string())
+            .optional()
+            .describe("Specific skill names to endorse (mutually exclusive with limit)"),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Max number of skills to endorse (mutually exclusive with skillNames)"),
+        skipIfNotEndorsable: z
+            .boolean()
+            .optional()
+            .describe("Skip if person has no endorsable skills (default: true)"),
+        keepCampaign: z
+            .boolean()
+            .optional()
+            .describe("Archive the ephemeral campaign instead of deleting it"),
+        ...cdpConnectionSchema,
+    }, async ({ personId, url, skillNames, limit, skipIfNotEndorsable, keepCampaign, cdpPort, cdpHost, allowRemote }) => {
+        if ((personId == null) === (url == null)) {
+            return mcpError("Exactly one of personId or url must be provided.");
+        }
+        try {
+            const result = await endorseSkills({
+                personId, url, skillNames, limit, skipIfNotEndorsable, keepCampaign, cdpPort, cdpHost, allowRemote,
+            });
+            return mcpSuccess(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to endorse skills");
+        }
+    });
+}
+//# sourceMappingURL=endorse-skills.js.map

package/dist/tools/endorse-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endorse-skills.js","sourceRoot":"","sources":["../../src/tools/endorse-skills.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEvF,+GAA+G;AAC/G,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,oJAAoJ,EACpJ;QACE,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,oBAAoB,CAAC;QACjC,GAAG,EAAE,CAAC;aACH,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,kEAAkE,CAAC;QAC/E,UAAU,EAAE,CAAC;aACV,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,EAAE;aACV,QAAQ,CAAC,iEAAiE,CAAC;QAC9E,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,sEAAsE,CAAC;QACnF,mBAAmB,EAAE,CAAC;aACnB,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,yDAAyD,CAAC;QACtE,YAAY,EAAE,CAAC;aACZ,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,uDAAuD,CAAC;QACpE,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QAC/G,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;YACzC,OAAO,QAAQ,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;gBACjC,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW;aACnG,CAAC,CAAC;YACH,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,0BAA0B,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/endorse-skills.test.d.ts

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

package/dist/tools/endorse-skills.test.d.ts.map

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

package/dist/tools/endorse-skills.test.js

@@ -0,0 +1,58 @@
+// 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,
+        endorseSkills: vi.fn(),
+    };
+});
+import { endorseSkills, } from "@lhremote/core";
+import { registerEndorseSkills } from "./endorse-skills.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("registerEndorseSkills", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named endorse-skills", () => {
+        const { server } = createMockServer();
+        registerEndorseSkills(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("endorse-skills", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("endorses skills on success", async () => {
+        const { server, getHandler } = createMockServer();
+        registerEndorseSkills(server);
+        vi.mocked(endorseSkills).mockResolvedValue(MOCK_RESULT);
+        const handler = getHandler("endorse-skills");
+        const result = await handler({ personId: 100, limit: 3, cdpPort: 9222 });
+        expect(endorseSkills).toHaveBeenCalledWith(expect.objectContaining({ personId: 100, limit: 3, cdpPort: 9222 }));
+        expect(result).toEqual({
+            content: [{ type: "text", text: JSON.stringify(MOCK_RESULT, null, 2) }],
+        });
+    });
+    it("returns error when neither personId nor url provided", async () => {
+        const { server, getHandler } = createMockServer();
+        registerEndorseSkills(server);
+        const handler = getHandler("endorse-skills");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [{ type: "text", text: "Exactly one of personId or url must be provided." }],
+        });
+    });
+    describeInfrastructureErrors(registerEndorseSkills, "endorse-skills", () => ({ personId: 100, cdpPort: 9222 }), (error) => vi.mocked(endorseSkills).mockRejectedValue(error), "Failed to endorse skills");
+    describeEphemeralActionErrors(registerEndorseSkills, "endorse-skills", () => ({ personId: 100, cdpPort: 9222 }), (error) => vi.mocked(endorseSkills).mockRejectedValue(error), "Failed to endorse skills");
+});
+//# sourceMappingURL=endorse-skills.test.js.map

package/dist/tools/endorse-skills.test.js.map

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

package/dist/tools/enrich-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#enrich-profile | enrich-profile} MCP tool. */
+export declare function registerEnrichProfile(server: McpServer): void;
+//# sourceMappingURL=enrich-profile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enrich-profile.d.ts","sourceRoot":"","sources":["../../src/tools/enrich-profile.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWzE,+GAA+G;AAC/G,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoD7D"}

package/dist/tools/enrich-profile.js

@@ -0,0 +1,60 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { enrichProfile } from "@lhremote/core";
+import { z } from "zod";
+import { cdpConnectionSchema, mcpCatchAll, mcpError, mcpSuccess } from "../helpers.js";
+const enrichmentCategorySchema = z.object({
+    shouldEnrich: z.boolean(),
+    actualDate: z.number().int().nonnegative().optional(),
+    types: z.array(z.string()).optional(),
+});
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#enrich-profile | enrich-profile} MCP tool. */
+export function registerEnrichProfile(server) {
+    server.tool("enrich-profile", "Enrich a LinkedIn profile by extracting additional data (emails, phones, socials, company info) via an ephemeral campaign. Accepts a person ID or LinkedIn profile URL. Deducts from the daily action budget.", {
+        personId: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Internal person ID"),
+        url: z
+            .string()
+            .optional()
+            .describe("LinkedIn profile URL (e.g. https://www.linkedin.com/in/jane-doe)"),
+        profileInfo: enrichmentCategorySchema
+            .optional()
+            .describe("Enrich profile info"),
+        phones: enrichmentCategorySchema
+            .optional()
+            .describe("Enrich phone numbers"),
+        emails: enrichmentCategorySchema
+            .optional()
+            .describe("Enrich email addresses"),
+        socials: enrichmentCategorySchema
+            .optional()
+            .describe("Enrich social profiles"),
+        companies: enrichmentCategorySchema
+            .optional()
+            .describe("Enrich company data"),
+        keepCampaign: z
+            .boolean()
+            .optional()
+            .describe("Archive the ephemeral campaign instead of deleting it"),
+        ...cdpConnectionSchema,
+    }, async ({ personId, url, profileInfo, phones, emails, socials, companies, keepCampaign, cdpPort, cdpHost, allowRemote }) => {
+        if ((personId == null) === (url == null)) {
+            return mcpError("Exactly one of personId or url must be provided.");
+        }
+        try {
+            const result = await enrichProfile({
+                personId, url, profileInfo, phones, emails, socials, companies,
+                keepCampaign, cdpPort, cdpHost, allowRemote,
+            });
+            return mcpSuccess(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to enrich profile");
+        }
+    });
+}
+//# sourceMappingURL=enrich-profile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enrich-profile.js","sourceRoot":"","sources":["../../src/tools/enrich-profile.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEvF,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE;IACzB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACrD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAEH,+GAA+G;AAC/G,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,+MAA+M,EAC/M;QACE,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,oBAAoB,CAAC;QACjC,GAAG,EAAE,CAAC;aACH,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,kEAAkE,CAAC;QAC/E,WAAW,EAAE,wBAAwB;aAClC,QAAQ,EAAE;aACV,QAAQ,CAAC,qBAAqB,CAAC;QAClC,MAAM,EAAE,wBAAwB;aAC7B,QAAQ,EAAE;aACV,QAAQ,CAAC,sBAAsB,CAAC;QACnC,MAAM,EAAE,wBAAwB;aAC7B,QAAQ,EAAE;aACV,QAAQ,CAAC,wBAAwB,CAAC;QACrC,OAAO,EAAE,wBAAwB;aAC9B,QAAQ,EAAE;aACV,QAAQ,CAAC,wBAAwB,CAAC;QACrC,SAAS,EAAE,wBAAwB;aAChC,QAAQ,EAAE;aACV,QAAQ,CAAC,qBAAqB,CAAC;QAClC,YAAY,EAAE,CAAC;aACZ,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,uDAAuD,CAAC;QACpE,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QACxH,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;YACzC,OAAO,QAAQ,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;gBACjC,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS;gBAC9D,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW;aAC5C,CAAC,CAAC;YACH,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,0BAA0B,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,66 @@
+// 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,
+        enrichProfile: vi.fn(),
+    };
+});
+import { enrichProfile, } from "@lhremote/core";
+import { registerEnrichProfile } from "./enrich-profile.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("registerEnrichProfile", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named enrich-profile", () => {
+        const { server } = createMockServer();
+        registerEnrichProfile(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("enrich-profile", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("enriches profile on success", async () => {
+        const { server, getHandler } = createMockServer();
+        registerEnrichProfile(server);
+        vi.mocked(enrichProfile).mockResolvedValue(MOCK_RESULT);
+        const handler = getHandler("enrich-profile");
+        const result = await handler({
+            personId: 100,
+            companies: { shouldEnrich: true },
+            cdpPort: 9222,
+        });
+        expect(enrichProfile).toHaveBeenCalledWith(expect.objectContaining({
+            personId: 100,
+            companies: { shouldEnrich: true },
+            cdpPort: 9222,
+        }));
+        expect(result).toEqual({
+            content: [{ type: "text", text: JSON.stringify(MOCK_RESULT, null, 2) }],
+        });
+    });
+    it("returns error when neither personId nor url provided", async () => {
+        const { server, getHandler } = createMockServer();
+        registerEnrichProfile(server);
+        const handler = getHandler("enrich-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." }],
+        });
+    });
+    describeInfrastructureErrors(registerEnrichProfile, "enrich-profile", () => ({ personId: 100, cdpPort: 9222 }), (error) => vi.mocked(enrichProfile).mockRejectedValue(error), "Failed to enrich profile");
+    describeEphemeralActionErrors(registerEnrichProfile, "enrich-profile", () => ({ personId: 100, cdpPort: 9222 }), (error) => vi.mocked(enrichProfile).mockRejectedValue(error), "Failed to enrich profile");
+});
+//# sourceMappingURL=enrich-profile.test.js.map

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

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

package/dist/tools/follow-person.d.ts

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

package/dist/tools/follow-person.d.ts.map

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

package/dist/tools/follow-person.js

@@ -0,0 +1,47 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { followPerson } from "@lhremote/core";
+import { z } from "zod";
+import { cdpConnectionSchema, mcpCatchAll, mcpError, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#follow-person | follow-person} MCP tool. */
+export function registerFollowPerson(server) {
+    server.tool("follow-person", "Follow or unfollow a LinkedIn profile via an ephemeral campaign. Accepts a person ID or LinkedIn profile URL. Deducts from the daily action budget.", {
+        personId: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Internal person ID"),
+        url: z
+            .string()
+            .optional()
+            .describe("LinkedIn profile URL (e.g. https://www.linkedin.com/in/jane-doe)"),
+        mode: z
+            .enum(["follow", "unfollow"])
+            .optional()
+            .describe('Follow or unfollow (default: "follow")'),
+        skipIfUnfollowable: z
+            .boolean()
+            .optional()
+            .describe("Skip if person cannot be unfollowed (default: true)"),
+        keepCampaign: z
+            .boolean()
+            .optional()
+            .describe("Archive the ephemeral campaign instead of deleting it"),
+        ...cdpConnectionSchema,
+    }, async ({ personId, url, mode, skipIfUnfollowable, keepCampaign, cdpPort, cdpHost, allowRemote }) => {
+        if ((personId == null) === (url == null)) {
+            return mcpError("Exactly one of personId or url must be provided.");
+        }
+        try {
+            const result = await followPerson({
+                personId, url, mode, skipIfUnfollowable, keepCampaign, cdpPort, cdpHost, allowRemote,
+            });
+            return mcpSuccess(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to follow person");
+        }
+    });
+}
+//# sourceMappingURL=follow-person.js.map

package/dist/tools/follow-person.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow-person.js","sourceRoot":"","sources":["../../src/tools/follow-person.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,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,qJAAqJ,EACrJ;QACE,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,oBAAoB,CAAC;QACjC,GAAG,EAAE,CAAC;aACH,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,kEAAkE,CAAC;QAC/E,IAAI,EAAE,CAAC;aACJ,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;aAC5B,QAAQ,EAAE;aACV,QAAQ,CAAC,wCAAwC,CAAC;QACrD,kBAAkB,EAAE,CAAC;aAClB,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,qDAAqD,CAAC;QAClE,YAAY,EAAE,CAAC;aACZ,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,uDAAuD,CAAC;QACpE,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,kBAAkB,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QACjG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;YACzC,OAAO,QAAQ,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;gBAChC,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,kBAAkB,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW;aACrF,CAAC,CAAC;YACH,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/follow-person.test.d.ts

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

package/dist/tools/follow-person.test.d.ts.map

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

package/dist/tools/follow-person.test.js

@@ -0,0 +1,66 @@
+// 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,
+        followPerson: vi.fn(),
+    };
+});
+import { followPerson, } from "@lhremote/core";
+import { registerFollowPerson } from "./follow-person.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("registerFollowPerson", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named follow-person", () => {
+        const { server } = createMockServer();
+        registerFollowPerson(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("follow-person", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("follows person on success", async () => {
+        const { server, getHandler } = createMockServer();
+        registerFollowPerson(server);
+        vi.mocked(followPerson).mockResolvedValue(MOCK_RESULT);
+        const handler = getHandler("follow-person");
+        const result = await handler({ personId: 100, cdpPort: 9222 });
+        expect(followPerson).toHaveBeenCalledWith(expect.objectContaining({ personId: 100, cdpPort: 9222 }));
+        expect(result).toEqual({
+            content: [{ type: "text", text: JSON.stringify(MOCK_RESULT, null, 2) }],
+        });
+    });
+    it("passes mode parameter", async () => {
+        const { server, getHandler } = createMockServer();
+        registerFollowPerson(server);
+        vi.mocked(followPerson).mockResolvedValue(MOCK_RESULT);
+        const handler = getHandler("follow-person");
+        await handler({ personId: 100, mode: "unfollow", cdpPort: 9222 });
+        expect(followPerson).toHaveBeenCalledWith(expect.objectContaining({ personId: 100, mode: "unfollow" }));
+    });
+    it("returns error when neither personId nor url provided", async () => {
+        const { server, getHandler } = createMockServer();
+        registerFollowPerson(server);
+        const handler = getHandler("follow-person");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [{ type: "text", text: "Exactly one of personId or url must be provided." }],
+        });
+    });
+    describeInfrastructureErrors(registerFollowPerson, "follow-person", () => ({ personId: 100, cdpPort: 9222 }), (error) => vi.mocked(followPerson).mockRejectedValue(error), "Failed to follow person");
+    describeEphemeralActionErrors(registerFollowPerson, "follow-person", () => ({ personId: 100, cdpPort: 9222 }), (error) => vi.mocked(followPerson).mockRejectedValue(error), "Failed to follow person");
+});
+//# sourceMappingURL=follow-person.test.js.map

package/dist/tools/follow-person.test.js.map

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

package/dist/tools/get-action-budget.d.ts

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

package/dist/tools/get-action-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-action-budget.d.ts","sourceRoot":"","sources":["../../src/tools/get-action-budget.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,qHAAqH;AACrH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgB/D"}

package/dist/tools/get-action-budget.js

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { getActionBudget } from "@lhremote/core";
+import { cdpConnectionSchema, mcpCatchAll, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#get-action-budget | get-action-budget} MCP tool. */
+export function registerGetActionBudget(server) {
+    server.tool("get-action-budget", "Get daily action budget showing limit types, thresholds, and today's usage from LH campaigns and CDP-direct actions.", {
+        ...cdpConnectionSchema,
+    }, async ({ cdpPort, cdpHost, allowRemote }) => {
+        try {
+            const result = await getActionBudget({ cdpPort, cdpHost, allowRemote });
+            return mcpSuccess(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to get action budget");
+        }
+    });
+}
+//# sourceMappingURL=get-action-budget.js.map

package/dist/tools/get-action-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-action-budget.js","sourceRoot":"","sources":["../../src/tools/get-action-budget.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7E,qHAAqH;AACrH,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,sHAAsH,EACtH;QACE,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YACxE,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,6BAA6B,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-action-budget.test.d.ts

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

package/dist/tools/get-action-budget.test.d.ts.map

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