@lhremote/core 0.0.0 → 0.2.0

package/dist/operations/campaign-start.js

@@ -0,0 +1,24 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { resolveAccount } from "../services/account-resolution.js";
+import { withInstanceDatabase } from "../services/instance-context.js";
+import { CampaignService } from "../services/campaign.js";
+import { DEFAULT_CDP_PORT } from "../constants.js";
+export async function campaignStart(input) {
+    const cdpPort = input.cdpPort ?? DEFAULT_CDP_PORT;
+    const accountId = await resolveAccount(cdpPort, {
+        ...(input.cdpHost !== undefined && { host: input.cdpHost }),
+        ...(input.allowRemote !== undefined && { allowRemote: input.allowRemote }),
+    });
+    return withInstanceDatabase(cdpPort, accountId, async ({ instance, db }) => {
+        const campaignService = new CampaignService(instance, db);
+        await campaignService.start(input.campaignId, input.personIds);
+        return {
+            success: true,
+            campaignId: input.campaignId,
+            personsQueued: input.personIds.length,
+            message: "Campaign started. Use campaign-status to monitor progress.",
+        };
+    });
+}
+//# sourceMappingURL=campaign-start.js.map

package/dist/operations/campaign-start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-start.js","sourceRoot":"","sources":["../../src/operations/campaign-start.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAenD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAyB;IAEzB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,gBAAgB,CAAC;IAElD,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE;QAC9C,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC3D,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;KAC3E,CAAC,CAAC;IAEH,OAAO,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE;QACzE,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC1D,MAAM,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAE/D,OAAO;YACL,OAAO,EAAE,IAAa;YACtB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM;YACrC,OAAO,EAAE,4DAA4D;SACtE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/operations/campaign-start.test.d.ts

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

package/dist/operations/campaign-start.test.d.ts.map

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

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

@@ -0,0 +1,96 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("../services/account-resolution.js", () => ({
+    resolveAccount: vi.fn(),
+}));
+vi.mock("../services/instance-context.js", () => ({
+    withInstanceDatabase: vi.fn(),
+}));
+vi.mock("../services/campaign.js", () => ({
+    CampaignService: vi.fn(),
+}));
+import { resolveAccount } from "../services/account-resolution.js";
+import { withInstanceDatabase } from "../services/instance-context.js";
+import { CampaignService } from "../services/campaign.js";
+import { campaignStart } from "./campaign-start.js";
+function setupMocks() {
+    vi.mocked(resolveAccount).mockResolvedValue(1);
+    vi.mocked(withInstanceDatabase).mockImplementation(async (_cdpPort, _accountId, callback) => callback({
+        accountId: 1,
+        instance: {},
+        db: {},
+    }));
+    vi.mocked(CampaignService).mockImplementation(function () {
+        return {
+            start: vi.fn().mockResolvedValue(undefined),
+        };
+    });
+}
+describe("campaignStart", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("returns success with campaignId and personsQueued", async () => {
+        setupMocks();
+        const result = await campaignStart({
+            campaignId: 42,
+            cdpPort: 9222,
+            personIds: [100, 101, 102],
+        });
+        expect(result.success).toBe(true);
+        expect(result.campaignId).toBe(42);
+        expect(result.personsQueued).toBe(3);
+        expect(result.message).toBe("Campaign started. Use campaign-status to monitor progress.");
+    });
+    it("passes connection options to resolveAccount", async () => {
+        setupMocks();
+        await campaignStart({
+            campaignId: 42,
+            cdpPort: 1234,
+            cdpHost: "192.168.1.1",
+            allowRemote: true,
+            personIds: [100],
+        });
+        expect(resolveAccount).toHaveBeenCalledWith(1234, {
+            host: "192.168.1.1",
+            allowRemote: true,
+        });
+    });
+    it("omits undefined connection options", async () => {
+        setupMocks();
+        await campaignStart({
+            campaignId: 42,
+            cdpPort: 9222,
+            personIds: [100],
+        });
+        expect(resolveAccount).toHaveBeenCalledWith(9222, {});
+    });
+    it("propagates resolveAccount errors", async () => {
+        vi.mocked(resolveAccount).mockRejectedValue(new Error("connection refused"));
+        await expect(campaignStart({ campaignId: 42, cdpPort: 9222, personIds: [100] })).rejects.toThrow("connection refused");
+    });
+    it("propagates withInstanceDatabase errors", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        vi.mocked(withInstanceDatabase).mockRejectedValue(new Error("instance not running"));
+        await expect(campaignStart({ campaignId: 42, cdpPort: 9222, personIds: [100] })).rejects.toThrow("instance not running");
+    });
+    it("propagates CampaignService errors", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        vi.mocked(withInstanceDatabase).mockImplementation(async (_cdpPort, _accountId, callback) => callback({
+            accountId: 1,
+            instance: {},
+            db: {},
+        }));
+        vi.mocked(CampaignService).mockImplementation(function () {
+            return {
+                start: vi.fn().mockRejectedValue(new Error("campaign not found")),
+            };
+        });
+        await expect(campaignStart({ campaignId: 42, cdpPort: 9222, personIds: [100] })).rejects.toThrow("campaign not found");
+    });
+});
+//# sourceMappingURL=campaign-start.test.js.map

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

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

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

@@ -0,0 +1,10 @@
+import type { CampaignStatistics } from "../types/index.js";
+import type { ConnectionOptions } from "./types.js";
+export interface CampaignStatisticsInput extends ConnectionOptions {
+    readonly campaignId: number;
+    readonly actionId?: number | undefined;
+    readonly maxErrors?: number | undefined;
+}
+export type CampaignStatisticsOutput = CampaignStatistics;
+export declare function campaignStatistics(input: CampaignStatisticsInput): Promise<CampaignStatisticsOutput>;
+//# sourceMappingURL=campaign-statistics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-statistics.d.ts","sourceRoot":"","sources":["../../src/operations/campaign-statistics.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAwB,MAAM,mBAAmB,CAAC;AAKlF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAE1D,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,CAenC"}

package/dist/operations/campaign-statistics.js

@@ -0,0 +1,23 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { resolveAccount } from "../services/account-resolution.js";
+import { withDatabase } from "../services/instance-context.js";
+import { CampaignStatisticsRepository } from "../db/index.js";
+import { DEFAULT_CDP_PORT } from "../constants.js";
+export async function campaignStatistics(input) {
+    const cdpPort = input.cdpPort ?? DEFAULT_CDP_PORT;
+    const accountId = await resolveAccount(cdpPort, {
+        ...(input.cdpHost !== undefined && { host: input.cdpHost }),
+        ...(input.allowRemote !== undefined && { allowRemote: input.allowRemote }),
+    });
+    return withDatabase(accountId, ({ db }) => {
+        const statisticsRepo = new CampaignStatisticsRepository(db);
+        const statsOptions = {};
+        if (input.actionId !== undefined)
+            statsOptions.actionId = input.actionId;
+        if (input.maxErrors !== undefined)
+            statsOptions.maxErrors = input.maxErrors;
+        return statisticsRepo.getStatistics(input.campaignId, statsOptions);
+    });
+}
+//# sourceMappingURL=campaign-statistics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-statistics.js","sourceRoot":"","sources":["../../src/operations/campaign-statistics.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAWnD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAA8B;IAE9B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,gBAAgB,CAAC;IAElD,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE;QAC9C,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC3D,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;KAC3E,CAAC,CAAC;IAEH,OAAO,YAAY,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;QACxC,MAAM,cAAc,GAAG,IAAI,4BAA4B,CAAC,EAAE,CAAC,CAAC;QAC5D,MAAM,YAAY,GAAyB,EAAE,CAAC;QAC9C,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;YAAE,YAAY,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACzE,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;YAAE,YAAY,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QAC5E,OAAO,cAAc,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC"}

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

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

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

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

package/dist/operations/campaign-statistics.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("../services/account-resolution.js", () => ({
+    resolveAccount: vi.fn(),
+}));
+vi.mock("../services/instance-context.js", () => ({
+    withDatabase: vi.fn(),
+}));
+vi.mock("../db/index.js", () => ({
+    CampaignStatisticsRepository: vi.fn(),
+}));
+import { resolveAccount } from "../services/account-resolution.js";
+import { withDatabase } from "../services/instance-context.js";
+import { CampaignStatisticsRepository } from "../db/index.js";
+import { campaignStatistics } from "./campaign-statistics.js";
+const MOCK_STATISTICS = {
+    campaignId: 42,
+    actions: [],
+    totals: {
+        successful: 70,
+        replied: 5,
+        failed: 10,
+        skipped: 3,
+        total: 88,
+        successRate: 79.5,
+    },
+};
+function setupMocks() {
+    vi.mocked(resolveAccount).mockResolvedValue(1);
+    vi.mocked(withDatabase).mockImplementation(async (_accountId, callback) => callback({ db: {} }));
+    vi.mocked(CampaignStatisticsRepository).mockImplementation(function () {
+        return {
+            getStatistics: vi.fn().mockReturnValue(MOCK_STATISTICS),
+        };
+    });
+}
+describe("campaignStatistics", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("returns campaign statistics", async () => {
+        setupMocks();
+        const result = await campaignStatistics({
+            campaignId: 42,
+            cdpPort: 9222,
+        });
+        expect(result.campaignId).toBe(42);
+        expect(result.totals.successful).toBe(70);
+        expect(result.totals.replied).toBe(5);
+        expect(result.totals.failed).toBe(10);
+        expect(result.totals.skipped).toBe(3);
+    });
+    it("passes actionId and maxErrors options to repository", async () => {
+        setupMocks();
+        await campaignStatistics({
+            campaignId: 42,
+            cdpPort: 9222,
+            actionId: 3,
+            maxErrors: 5,
+        });
+        const mockResult = vi.mocked(CampaignStatisticsRepository).mock.results[0];
+        expect(mockResult.value.getStatistics).toHaveBeenCalledWith(42, { actionId: 3, maxErrors: 5 });
+    });
+    it("omits undefined actionId and maxErrors from options", async () => {
+        setupMocks();
+        await campaignStatistics({
+            campaignId: 42,
+            cdpPort: 9222,
+        });
+        const mockResult = vi.mocked(CampaignStatisticsRepository).mock.results[0];
+        expect(mockResult.value.getStatistics).toHaveBeenCalledWith(42, {});
+    });
+    it("passes connection options to resolveAccount", async () => {
+        setupMocks();
+        await campaignStatistics({
+            campaignId: 42,
+            cdpPort: 1234,
+            cdpHost: "192.168.1.1",
+            allowRemote: true,
+        });
+        expect(resolveAccount).toHaveBeenCalledWith(1234, {
+            host: "192.168.1.1",
+            allowRemote: true,
+        });
+    });
+    it("omits undefined connection options", async () => {
+        setupMocks();
+        await campaignStatistics({
+            campaignId: 42,
+            cdpPort: 9222,
+        });
+        expect(resolveAccount).toHaveBeenCalledWith(9222, {});
+    });
+    it("propagates resolveAccount errors", async () => {
+        vi.mocked(resolveAccount).mockRejectedValue(new Error("connection refused"));
+        await expect(campaignStatistics({ campaignId: 42, cdpPort: 9222 })).rejects.toThrow("connection refused");
+    });
+    it("propagates withDatabase errors", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        vi.mocked(withDatabase).mockRejectedValue(new Error("database not found"));
+        await expect(campaignStatistics({ campaignId: 42, cdpPort: 9222 })).rejects.toThrow("database not found");
+    });
+    it("propagates CampaignStatisticsRepository errors", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        vi.mocked(withDatabase).mockImplementation(async (_accountId, callback) => callback({ db: {} }));
+        vi.mocked(CampaignStatisticsRepository).mockImplementation(function () {
+            return {
+                getStatistics: vi.fn().mockImplementation(() => {
+                    throw new Error("statistics error");
+                }),
+            };
+        });
+        await expect(campaignStatistics({ campaignId: 42, cdpPort: 9222 })).rejects.toThrow("statistics error");
+    });
+});
+//# sourceMappingURL=campaign-statistics.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-statistics.test.js","sourceRoot":"","sources":["../../src/operations/campaign-statistics.test.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,EAAE,CAAC,IAAI,CAAC,mCAAmC,EAAE,GAAG,EAAE,CAAC,CAAC;IAClD,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE;CACxB,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,iCAAiC,EAAE,GAAG,EAAE,CAAC,CAAC;IAChD,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;CACtB,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/B,4BAA4B,EAAE,EAAE,CAAC,EAAE,EAAE;CACtC,CAAC,CAAC,CAAC;AAGJ,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,eAAe,GAAG;IACtB,UAAU,EAAE,EAAE;IACd,OAAO,EAAE,EAAE;IACX,MAAM,EAAE;QACN,UAAU,EAAE,EAAE;QACd,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,EAAE;QACT,WAAW,EAAE,IAAI;KAClB;CACF,CAAC;AAEF,SAAS,UAAU;IACjB,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAE/C,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,kBAAkB,CACxC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,CAC7B,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,EAAgC,CAAC,CACrD,CAAC;IAEF,EAAE,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC,kBAAkB,CAAC;QACzD,OAAO;YACL,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,eAAe,CAAC;SACb,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAC3C,UAAU,EAAE,CAAC;QAEb,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC;YACtC,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,UAAU,EAAE,CAAC;QAEb,MAAM,kBAAkB,CAAC;YACvB,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,CAAC;YACX,SAAS,EAAE,CAAC;SACb,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,EAAE,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAiE,CAAC;QAC3I,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IACjG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,UAAU,EAAE,CAAC;QAEb,MAAM,kBAAkB,CAAC;YACvB,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,EAAE,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAiE,CAAC;QAC3I,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,UAAU,EAAE,CAAC;QAEb,MAAM,kBAAkB,CAAC;YACvB,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,aAAa;YACtB,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QAEH,MAAM,CAAC,cAAc,CAAC,CAAC,oBAAoB,CAAC,IAAI,EAAE;YAChD,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,UAAU,EAAE,CAAC;QAEb,MAAM,kBAAkB,CAAC;YACvB,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,MAAM,CAAC,cAAc,CAAC,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAE7E,MAAM,MAAM,CACV,kBAAkB,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CACtD,CAAC,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAC/C,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,iBAAiB,CACvC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAChC,CAAC;QAEF,MAAM,MAAM,CACV,kBAAkB,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CACtD,CAAC,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAC/C,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,kBAAkB,CACxC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,CAC7B,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,EAAgC,CAAC,CACrD,CAAC;QACF,EAAE,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC,kBAAkB,CAAC;YACzD,OAAO;gBACL,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE;oBAC7C,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;gBACtC,CAAC,CAAC;aACwC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,CACV,kBAAkB,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CACtD,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/operations/campaign-status.d.ts

@@ -0,0 +1,26 @@
+import type { CampaignActionResult, CampaignStatus } from "../types/index.js";
+import type { ConnectionOptions } from "./types.js";
+/**
+ * Input for the campaign-status operation.
+ */
+export interface CampaignStatusInput extends ConnectionOptions {
+    readonly campaignId: number;
+    readonly includeResults?: boolean | undefined;
+    readonly limit?: number | undefined;
+}
+/**
+ * Output from the campaign-status operation.
+ */
+export interface CampaignStatusOutput extends CampaignStatus {
+    readonly campaignId: number;
+    readonly results?: CampaignActionResult[];
+}
+/**
+ * Retrieve the execution status of a campaign, optionally including
+ * action results.
+ *
+ * This is the shared business logic used by both the CLI handler and
+ * the MCP tool.
+ */
+export declare function campaignStatus(input: CampaignStatusInput): Promise<CampaignStatusOutput>;
+//# sourceMappingURL=campaign-status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-status.d.ts","sourceRoot":"","sources":["../../src/operations/campaign-status.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAK9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAsB/B"}

package/dist/operations/campaign-status.js

@@ -0,0 +1,32 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { resolveAccount } from "../services/account-resolution.js";
+import { withInstanceDatabase } from "../services/instance-context.js";
+import { CampaignService } from "../services/campaign.js";
+import { DEFAULT_CDP_PORT } from "../constants.js";
+/**
+ * Retrieve the execution status of a campaign, optionally including
+ * action results.
+ *
+ * This is the shared business logic used by both the CLI handler and
+ * the MCP tool.
+ */
+export async function campaignStatus(input) {
+    const cdpPort = input.cdpPort ?? DEFAULT_CDP_PORT;
+    const limit = input.limit ?? 20;
+    const accountId = await resolveAccount(cdpPort, {
+        ...(input.cdpHost !== undefined && { host: input.cdpHost }),
+        ...(input.allowRemote !== undefined && { allowRemote: input.allowRemote }),
+    });
+    return withInstanceDatabase(cdpPort, accountId, async ({ instance, db }) => {
+        const campaignService = new CampaignService(instance, db);
+        const status = await campaignService.getStatus(input.campaignId);
+        const output = { campaignId: input.campaignId, ...status };
+        if (input.includeResults) {
+            const runResult = await campaignService.getResults(input.campaignId);
+            return { ...output, results: runResult.results.slice(0, limit) };
+        }
+        return output;
+    });
+}
+//# sourceMappingURL=campaign-status.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-status.js","sourceRoot":"","sources":["../../src/operations/campaign-status.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAoBnD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAA0B;IAE1B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,gBAAgB,CAAC;IAClD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;IAEhC,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE;QAC9C,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC3D,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;KAC3E,CAAC,CAAC;IAEH,OAAO,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE;QACzE,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAEjE,MAAM,MAAM,GAAyB,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,GAAG,MAAM,EAAE,CAAC;QAEjF,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACrE,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;QACnE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC"}

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

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

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

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

package/dist/operations/campaign-status.test.js

@@ -0,0 +1,142 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("../services/account-resolution.js", () => ({
+    resolveAccount: vi.fn(),
+}));
+vi.mock("../services/instance-context.js", () => ({
+    withInstanceDatabase: vi.fn(),
+}));
+vi.mock("../services/campaign.js", () => ({
+    CampaignService: vi.fn(),
+}));
+import { resolveAccount } from "../services/account-resolution.js";
+import { withInstanceDatabase } from "../services/instance-context.js";
+import { CampaignService } from "../services/campaign.js";
+import { campaignStatus } from "./campaign-status.js";
+const MOCK_STATUS = {
+    campaignState: "active",
+    isPaused: false,
+    runnerState: "campaigns",
+    actionCounts: [
+        { actionId: 1, queued: 10, processed: 5, successful: 4, failed: 1 },
+    ],
+};
+const MOCK_RESULTS = {
+    campaignId: 42,
+    results: [
+        { id: 1, actionVersionId: 1, personId: 100, result: 3, platform: "linkedin", createdAt: "2026-01-01T00:00:00Z" },
+        { id: 2, actionVersionId: 1, personId: 101, result: 3, platform: "linkedin", createdAt: "2026-01-01T00:01:00Z" },
+        { id: 3, actionVersionId: 1, personId: 102, result: 3, platform: "linkedin", createdAt: "2026-01-01T00:02:00Z" },
+    ],
+    actionCounts: MOCK_STATUS.actionCounts,
+};
+function setupMocks() {
+    vi.mocked(resolveAccount).mockResolvedValue(1);
+    vi.mocked(withInstanceDatabase).mockImplementation(async (_cdpPort, _accountId, callback) => callback({
+        accountId: 1,
+        instance: {},
+        db: {},
+    }));
+    vi.mocked(CampaignService).mockImplementation(function () {
+        return {
+            getStatus: vi.fn().mockResolvedValue(MOCK_STATUS),
+            getResults: vi.fn().mockResolvedValue(MOCK_RESULTS),
+        };
+    });
+}
+describe("campaignStatus", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("returns campaign status with campaignId", async () => {
+        setupMocks();
+        const result = await campaignStatus({
+            campaignId: 42,
+            cdpPort: 9222,
+        });
+        expect(result.campaignId).toBe(42);
+        expect(result.campaignState).toBe("active");
+        expect(result.isPaused).toBe(false);
+        expect(result.runnerState).toBe("campaigns");
+        expect(result.actionCounts).toHaveLength(1);
+        expect(result.results).toBeUndefined();
+    });
+    it("includes results when includeResults is true", async () => {
+        setupMocks();
+        const result = await campaignStatus({
+            campaignId: 42,
+            cdpPort: 9222,
+            includeResults: true,
+        });
+        expect(result.results).toHaveLength(3);
+    });
+    it("limits results to specified limit", async () => {
+        setupMocks();
+        const result = await campaignStatus({
+            campaignId: 42,
+            cdpPort: 9222,
+            includeResults: true,
+            limit: 1,
+        });
+        expect(result.results).toHaveLength(1);
+    });
+    it("defaults limit to 20", async () => {
+        setupMocks();
+        const result = await campaignStatus({
+            campaignId: 42,
+            cdpPort: 9222,
+            includeResults: true,
+        });
+        // All 3 results returned since 3 < default limit of 20
+        expect(result.results).toHaveLength(3);
+    });
+    it("passes connection options to resolveAccount", async () => {
+        setupMocks();
+        await campaignStatus({
+            campaignId: 42,
+            cdpPort: 1234,
+            cdpHost: "192.168.1.1",
+            allowRemote: true,
+        });
+        expect(resolveAccount).toHaveBeenCalledWith(1234, {
+            host: "192.168.1.1",
+            allowRemote: true,
+        });
+    });
+    it("omits undefined connection options", async () => {
+        setupMocks();
+        await campaignStatus({
+            campaignId: 42,
+            cdpPort: 9222,
+        });
+        expect(resolveAccount).toHaveBeenCalledWith(9222, {});
+    });
+    it("propagates resolveAccount errors", async () => {
+        vi.mocked(resolveAccount).mockRejectedValue(new Error("connection refused"));
+        await expect(campaignStatus({ campaignId: 42, cdpPort: 9222 })).rejects.toThrow("connection refused");
+    });
+    it("propagates withInstanceDatabase errors", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        vi.mocked(withInstanceDatabase).mockRejectedValue(new Error("instance not running"));
+        await expect(campaignStatus({ campaignId: 42, cdpPort: 9222 })).rejects.toThrow("instance not running");
+    });
+    it("propagates CampaignService errors", async () => {
+        vi.mocked(resolveAccount).mockResolvedValue(1);
+        vi.mocked(withInstanceDatabase).mockImplementation(async (_cdpPort, _accountId, callback) => callback({
+            accountId: 1,
+            instance: {},
+            db: {},
+        }));
+        vi.mocked(CampaignService).mockImplementation(function () {
+            return {
+                getStatus: vi.fn().mockRejectedValue(new Error("campaign not found")),
+            };
+        });
+        await expect(campaignStatus({ campaignId: 42, cdpPort: 9222 })).rejects.toThrow("campaign not found");
+    });
+});
+//# sourceMappingURL=campaign-status.test.js.map

package/dist/operations/campaign-status.test.js.map

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

package/dist/operations/campaign-stop.d.ts

@@ -0,0 +1,11 @@
+import type { ConnectionOptions } from "./types.js";
+export interface CampaignStopInput extends ConnectionOptions {
+    readonly campaignId: number;
+}
+export interface CampaignStopOutput {
+    readonly success: true;
+    readonly campaignId: number;
+    readonly message: string;
+}
+export declare function campaignStop(input: CampaignStopInput): Promise<CampaignStopOutput>;
+//# sourceMappingURL=campaign-stop.d.ts.map

package/dist/operations/campaign-stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-stop.d.ts","sourceRoot":"","sources":["../../src/operations/campaign-stop.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAkB7B"}

package/dist/operations/campaign-stop.js

@@ -0,0 +1,23 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { resolveAccount } from "../services/account-resolution.js";
+import { withInstanceDatabase } from "../services/instance-context.js";
+import { CampaignService } from "../services/campaign.js";
+import { DEFAULT_CDP_PORT } from "../constants.js";
+export async function campaignStop(input) {
+    const cdpPort = input.cdpPort ?? DEFAULT_CDP_PORT;
+    const accountId = await resolveAccount(cdpPort, {
+        ...(input.cdpHost !== undefined && { host: input.cdpHost }),
+        ...(input.allowRemote !== undefined && { allowRemote: input.allowRemote }),
+    });
+    return withInstanceDatabase(cdpPort, accountId, async ({ instance, db }) => {
+        const campaignService = new CampaignService(instance, db);
+        await campaignService.stop(input.campaignId);
+        return {
+            success: true,
+            campaignId: input.campaignId,
+            message: "Campaign paused",
+        };
+    });
+}
+//# sourceMappingURL=campaign-stop.js.map

package/dist/operations/campaign-stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-stop.js","sourceRoot":"","sources":["../../src/operations/campaign-stop.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAanD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAwB;IAExB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,gBAAgB,CAAC;IAElD,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE;QAC9C,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC3D,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;KAC3E,CAAC,CAAC;IAEH,OAAO,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE;QACzE,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC1D,MAAM,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAE7C,OAAO;YACL,OAAO,EAAE,IAAa;YACtB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,OAAO,EAAE,iBAAiB;SAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/operations/campaign-stop.test.d.ts

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

package/dist/operations/campaign-stop.test.d.ts.map

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