@lhremote/mcp 0.0.0 → 0.2.0

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

@@ -0,0 +1,115 @@
+// 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,
+        campaignStart: vi.fn(),
+    };
+});
+import { CampaignExecutionError, CampaignNotFoundError, CampaignTimeoutError, campaignStart, } from "@lhremote/core";
+import { registerCampaignStart } from "./campaign-start.js";
+import { describeInfrastructureErrors } from "./testing/infrastructure-errors.js";
+import { createMockServer } from "./testing/mock-server.js";
+const START_RESULT = {
+    success: true,
+    campaignId: 15,
+    personsQueued: 3,
+    message: "Campaign started. Use campaign-status to monitor progress.",
+};
+describe("registerCampaignStart", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named campaign-start", () => {
+        const { server } = createMockServer();
+        registerCampaignStart(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("campaign-start", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("successfully starts a campaign", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignStart(server);
+        vi.mocked(campaignStart).mockResolvedValue(START_RESULT);
+        const handler = getHandler("campaign-start");
+        const result = await handler({
+            campaignId: 15,
+            personIds: [100, 200, 300],
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(START_RESULT, null, 2),
+                },
+            ],
+        });
+    });
+    it("returns error for non-existent campaign", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignStart(server);
+        vi.mocked(campaignStart).mockRejectedValue(new CampaignNotFoundError(999));
+        const handler = getHandler("campaign-start");
+        const result = await handler({
+            campaignId: 999,
+            personIds: [1],
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Campaign 999 not found.",
+                },
+            ],
+        });
+    });
+    describeInfrastructureErrors(registerCampaignStart, "campaign-start", () => ({ campaignId: 15, personIds: [1], cdpPort: 9222 }), (error) => vi.mocked(campaignStart).mockRejectedValue(error), "Failed to start campaign");
+    it("returns error when campaign runner times out", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignStart(server);
+        vi.mocked(campaignStart).mockRejectedValue(new CampaignTimeoutError("Campaign runner did not reach idle state within 60000ms", 15));
+        const handler = getHandler("campaign-start");
+        const result = await handler({
+            campaignId: 15,
+            personIds: [1],
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Campaign start timed out: Campaign runner did not reach idle state within 60000ms",
+                },
+            ],
+        });
+    });
+    it("returns error when campaign execution fails", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignStart(server);
+        vi.mocked(campaignStart).mockRejectedValue(new CampaignExecutionError("Failed to unpause campaign 15: UI error", 15));
+        const handler = getHandler("campaign-start");
+        const result = await handler({
+            campaignId: 15,
+            personIds: [1],
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Failed to start campaign: Failed to unpause campaign 15: UI error",
+                },
+            ],
+        });
+    });
+});
+//# sourceMappingURL=campaign-start.test.js.map

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

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

package/dist/tools/campaign-statistics.d.ts

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

package/dist/tools/campaign-statistics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-statistics.d.ts","sourceRoot":"","sources":["../../src/tools/campaign-statistics.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,yHAAyH;AACzH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqClE"}

package/dist/tools/campaign-statistics.js

@@ -0,0 +1,41 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { ActionNotFoundError, campaignStatistics, } from "@lhremote/core";
+import { z } from "zod";
+import { cdpConnectionSchema, mcpCatchAll, mcpError, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#campaign-statistics | campaign-statistics} MCP tool. */
+export function registerCampaignStatistics(server) {
+    server.tool("campaign-statistics", "Get per-action success/failure/skip rates, top error codes with blame attribution, and processing timeline for a campaign.", {
+        campaignId: z
+            .number()
+            .int()
+            .positive()
+            .describe("Campaign ID"),
+        actionId: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Filter to a specific action ID"),
+        maxErrors: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .default(5)
+            .describe("Maximum number of top errors per action (default: 5)"),
+        ...cdpConnectionSchema,
+    }, async ({ campaignId, actionId, maxErrors, cdpPort, cdpHost, allowRemote }) => {
+        try {
+            const result = await campaignStatistics({ campaignId, actionId, maxErrors, cdpPort, cdpHost, allowRemote });
+            return mcpSuccess(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            if (error instanceof ActionNotFoundError) {
+                return mcpError(`Action ${String(actionId)} not found in campaign ${String(campaignId)}.`);
+            }
+            return mcpCatchAll(error, "Failed to get campaign statistics");
+        }
+    });
+}
+//# sourceMappingURL=campaign-statistics.js.map

package/dist/tools/campaign-statistics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-statistics.js","sourceRoot":"","sources":["../../src/tools/campaign-statistics.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,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,yHAAyH;AACzH,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,4HAA4H,EAC5H;QACE,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,CAAC,aAAa,CAAC;QAC1B,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,gCAAgC,CAAC;QAC7C,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,OAAO,CAAC,CAAC,CAAC;aACV,QAAQ,CAAC,sDAAsD,CAAC;QACnE,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QAC3E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YAC5G,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;gBACzC,OAAO,QAAQ,CAAC,UAAU,MAAM,CAAC,QAAQ,CAAC,0BAA0B,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAC7F,CAAC;YACD,OAAO,WAAW,CAAC,KAAK,EAAE,mCAAmC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/campaign-statistics.test.d.ts

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

package/dist/tools/campaign-statistics.test.d.ts.map

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

package/dist/tools/campaign-statistics.test.js

@@ -0,0 +1,177 @@
+// 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,
+        campaignStatistics: vi.fn(),
+    };
+});
+import { AccountResolutionError, ActionNotFoundError, CampaignNotFoundError, campaignStatistics, } from "@lhremote/core";
+import { registerCampaignStatistics } from "./campaign-statistics.js";
+import { describeInfrastructureErrors } from "./testing/infrastructure-errors.js";
+import { createMockServer } from "./testing/mock-server.js";
+const SAMPLE_STATISTICS = {
+    campaignId: 10,
+    actions: [
+        {
+            actionId: 1,
+            actionName: "Invite",
+            actionType: "InvitePerson",
+            successful: 50,
+            replied: 0,
+            failed: 5,
+            skipped: 0,
+            total: 55,
+            successRate: 90.9,
+            firstResultAt: "2026-01-01T00:00:00Z",
+            lastResultAt: "2026-01-15T00:00:00Z",
+            topErrors: [
+                { code: 270013, count: 3, isException: false, whoToBlame: "LinkedIn" },
+                { code: 271403, count: 2, isException: false, whoToBlame: "LinkedIn" },
+            ],
+        },
+    ],
+    totals: {
+        successful: 50,
+        replied: 0,
+        failed: 5,
+        skipped: 0,
+        total: 55,
+        successRate: 90.9,
+    },
+};
+describe("registerCampaignStatistics", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named campaign-statistics", () => {
+        const { server } = createMockServer();
+        registerCampaignStatistics(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("campaign-statistics", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("returns statistics for a campaign", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignStatistics(server);
+        vi.mocked(campaignStatistics).mockResolvedValue(SAMPLE_STATISTICS);
+        const handler = getHandler("campaign-statistics");
+        const result = await handler({
+            campaignId: 10,
+            cdpPort: 9222,
+            maxErrors: 5,
+        });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(SAMPLE_STATISTICS, null, 2),
+                },
+            ],
+        });
+    });
+    it("passes actionId and maxErrors to operation", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignStatistics(server);
+        vi.mocked(campaignStatistics).mockResolvedValue(SAMPLE_STATISTICS);
+        const handler = getHandler("campaign-statistics");
+        await handler({
+            campaignId: 10,
+            actionId: 42,
+            maxErrors: 3,
+            cdpPort: 9222,
+        });
+        expect(campaignStatistics).toHaveBeenCalledWith(expect.objectContaining({
+            campaignId: 10,
+            actionId: 42,
+            maxErrors: 3,
+        }));
+    });
+    it("returns error for non-existent campaign", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignStatistics(server);
+        vi.mocked(campaignStatistics).mockRejectedValue(new CampaignNotFoundError(999));
+        const handler = getHandler("campaign-statistics");
+        const result = await handler({
+            campaignId: 999,
+            cdpPort: 9222,
+            maxErrors: 5,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Campaign 999 not found.",
+                },
+            ],
+        });
+    });
+    it("returns error for non-existent action", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignStatistics(server);
+        vi.mocked(campaignStatistics).mockRejectedValue(new ActionNotFoundError(999, 10));
+        const handler = getHandler("campaign-statistics");
+        const result = await handler({
+            campaignId: 10,
+            actionId: 999,
+            cdpPort: 9222,
+            maxErrors: 5,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Action 999 not found in campaign 10.",
+                },
+            ],
+        });
+    });
+    describeInfrastructureErrors(registerCampaignStatistics, "campaign-statistics", () => ({ campaignId: 10, cdpPort: 9222, maxErrors: 5 }), (error) => vi.mocked(campaignStatistics).mockRejectedValue(error), "Failed to get campaign statistics");
+    it("returns error when no accounts found", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignStatistics(server);
+        vi.mocked(campaignStatistics).mockRejectedValue(new AccountResolutionError("no-accounts"));
+        const handler = getHandler("campaign-statistics");
+        const result = await handler({
+            campaignId: 10,
+            cdpPort: 9222,
+            maxErrors: 5,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "No accounts found.",
+                },
+            ],
+        });
+    });
+    it("returns error when multiple accounts found", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignStatistics(server);
+        vi.mocked(campaignStatistics).mockRejectedValue(new AccountResolutionError("multiple-accounts"));
+        const handler = getHandler("campaign-statistics");
+        const result = await handler({
+            campaignId: 10,
+            cdpPort: 9222,
+            maxErrors: 5,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Multiple accounts found. Cannot determine which instance to use.",
+                },
+            ],
+        });
+    });
+});
+//# sourceMappingURL=campaign-statistics.test.js.map

package/dist/tools/campaign-statistics.test.js.map

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-status.d.ts","sourceRoot":"","sources":["../../src/tools/campaign-status.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,iHAAiH;AACjH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4C9D"}

package/dist/tools/campaign-status.js

@@ -0,0 +1,47 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { CampaignExecutionError, campaignStatus, } from "@lhremote/core";
+import { z } from "zod";
+import { cdpConnectionSchema, mcpCatchAll, mcpError, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#campaign-status | campaign-status} MCP tool. */
+export function registerCampaignStatus(server) {
+    server.tool("campaign-status", "Check campaign execution status and results. Use after campaign-start to monitor progress.", {
+        campaignId: z
+            .number()
+            .int()
+            .positive()
+            .describe("Campaign ID"),
+        includeResults: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Include execution results"),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .default(20)
+            .describe("Max results to return"),
+        ...cdpConnectionSchema,
+    }, async ({ campaignId, includeResults, limit, cdpPort, cdpHost, allowRemote }) => {
+        try {
+            const result = await campaignStatus({
+                campaignId,
+                includeResults,
+                limit,
+                cdpPort,
+                cdpHost,
+                allowRemote,
+            });
+            return mcpSuccess(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            if (error instanceof CampaignExecutionError) {
+                return mcpError(`Failed to get campaign status: ${error.message}`);
+            }
+            return mcpCatchAll(error, "Failed to get campaign status");
+        }
+    });
+}
+//# sourceMappingURL=campaign-status.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-status.js","sourceRoot":"","sources":["../../src/tools/campaign-status.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,sBAAsB,EACtB,cAAc,GACf,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,iHAAiH;AACjH,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,4FAA4F,EAC5F;QACE,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,CAAC,aAAa,CAAC;QAC1B,cAAc,EAAE,CAAC;aACd,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CAAC,2BAA2B,CAAC;QACxC,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CAAC,uBAAuB,CAAC;QACpC,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QAC7E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;gBAClC,UAAU;gBACV,cAAc;gBACd,KAAK;gBACL,OAAO;gBACP,OAAO;gBACP,WAAW;aACZ,CAAC,CAAC;YAEH,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;gBAC5C,OAAO,QAAQ,CAAC,kCAAkC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACrE,CAAC;YACD,OAAO,WAAW,CAAC,KAAK,EAAE,+BAA+B,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

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

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

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

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