@lhremote/mcp 0.0.0 → 0.2.0

package/dist/tools/query-profiles.test.js

@@ -0,0 +1,239 @@
+// 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,
+        DatabaseClient: vi.fn(),
+        ProfileRepository: vi.fn(),
+        discoverAllDatabases: vi.fn(),
+    };
+});
+import { DatabaseClient, ProfileRepository, discoverAllDatabases, } from "@lhremote/core";
+import { registerQueryProfiles } from "./query-profiles.js";
+import { createMockServer } from "./testing/mock-server.js";
+const MOCK_SEARCH_RESULT = {
+    profiles: [
+        {
+            id: 1,
+            firstName: "Jane",
+            lastName: "Doe",
+            headline: "Engineering Manager",
+            company: "Acme Corp",
+            title: "Engineering Manager",
+        },
+        {
+            id: 2,
+            firstName: "John",
+            lastName: "Smith",
+            headline: "Software Engineer",
+            company: "Tech Inc",
+            title: "Senior Engineer",
+        },
+    ],
+    total: 150,
+};
+function mockDb() {
+    const close = vi.fn();
+    vi.mocked(DatabaseClient).mockImplementation(function () {
+        return { close, db: {} };
+    });
+    return { close };
+}
+function mockRepo(result = MOCK_SEARCH_RESULT) {
+    vi.mocked(ProfileRepository).mockImplementation(function () {
+        return {
+            search: vi.fn().mockReturnValue(result),
+        };
+    });
+}
+function setupSuccessPath() {
+    vi.mocked(discoverAllDatabases).mockReturnValue(new Map([[1, "/path/to/db"]]));
+    mockDb();
+    mockRepo();
+}
+describe("registerQueryProfiles", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named query-profiles", () => {
+        const { server } = createMockServer();
+        registerQueryProfiles(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("query-profiles", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("returns search results as JSON", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfiles(server);
+        setupSuccessPath();
+        const handler = getHandler("query-profiles");
+        const result = await handler({});
+        const response = JSON.parse(result.content[0].text);
+        expect(response.profiles).toHaveLength(2);
+        expect(response.total).toBe(150);
+        expect(response.limit).toBe(20);
+        expect(response.offset).toBe(0);
+    });
+    it("passes only filter parameters to repository (no limit/offset)", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfiles(server);
+        vi.mocked(discoverAllDatabases).mockReturnValue(new Map([[1, "/path/to/db"]]));
+        mockDb();
+        const searchFn = vi.fn().mockReturnValue({ profiles: [], total: 0 });
+        vi.mocked(ProfileRepository).mockImplementation(function () {
+            return { search: searchFn };
+        });
+        const handler = getHandler("query-profiles");
+        await handler({ query: "Jane", company: "Acme", limit: 10, offset: 5 });
+        expect(searchFn).toHaveBeenCalledWith({
+            query: "Jane",
+            company: "Acme",
+        });
+    });
+    it("returns error when no databases found", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfiles(server);
+        vi.mocked(discoverAllDatabases).mockReturnValue(new Map());
+        const handler = getHandler("query-profiles");
+        const result = await handler({});
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "No LinkedHelper databases found.",
+                },
+            ],
+        });
+    });
+    it("closes database after search", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfiles(server);
+        vi.mocked(discoverAllDatabases).mockReturnValue(new Map([[1, "/path/to/db"]]));
+        const { close } = mockDb();
+        mockRepo();
+        const handler = getHandler("query-profiles");
+        await handler({});
+        expect(close).toHaveBeenCalledOnce();
+    });
+    it("returns error on database failure", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfiles(server);
+        vi.mocked(discoverAllDatabases).mockReturnValue(new Map([[1, "/path/to/db"]]));
+        mockDb();
+        vi.mocked(ProfileRepository).mockImplementation(function () {
+            return {
+                search: vi.fn().mockImplementation(() => {
+                    throw new Error("database locked");
+                }),
+            };
+        });
+        const handler = getHandler("query-profiles");
+        const result = await handler({});
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Failed to query profiles: database locked",
+                },
+            ],
+        });
+    });
+    it("aggregates results from multiple databases", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfiles(server);
+        vi.mocked(discoverAllDatabases).mockReturnValue(new Map([
+            [1, "/path/to/db1"],
+            [2, "/path/to/db2"],
+        ]));
+        const close = vi.fn();
+        vi.mocked(DatabaseClient).mockImplementation(function () {
+            return { close, db: {} };
+        });
+        let callCount = 0;
+        vi.mocked(ProfileRepository).mockImplementation(function () {
+            callCount++;
+            if (callCount === 1) {
+                return {
+                    search: vi.fn().mockReturnValue({
+                        profiles: [{ id: 1, firstName: "Jane" }],
+                        total: 10,
+                    }),
+                };
+            }
+            return {
+                search: vi.fn().mockReturnValue({
+                    profiles: [{ id: 2, firstName: "John" }],
+                    total: 20,
+                }),
+            };
+        });
+        const handler = getHandler("query-profiles");
+        const result = await handler({});
+        const response = JSON.parse(result.content[0].text);
+        expect(response.profiles).toHaveLength(2);
+        expect(response.total).toBe(30);
+        expect(close).toHaveBeenCalledTimes(2);
+    });
+    it("applies limit/offset to merged results across databases", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfiles(server);
+        vi.mocked(discoverAllDatabases).mockReturnValue(new Map([
+            [1, "/path/to/db1"],
+            [2, "/path/to/db2"],
+        ]));
+        const close = vi.fn();
+        vi.mocked(DatabaseClient).mockImplementation(function () {
+            return { close, db: {} };
+        });
+        let callCount = 0;
+        vi.mocked(ProfileRepository).mockImplementation(function () {
+            callCount++;
+            if (callCount === 1) {
+                return {
+                    search: vi.fn().mockReturnValue({
+                        profiles: [
+                            { id: 1, firstName: "Alice" },
+                            { id: 2, firstName: "Bob" },
+                        ],
+                        total: 2,
+                    }),
+                };
+            }
+            return {
+                search: vi.fn().mockReturnValue({
+                    profiles: [
+                        { id: 3, firstName: "Carol" },
+                        { id: 4, firstName: "Dave" },
+                    ],
+                    total: 2,
+                }),
+            };
+        });
+        const handler = getHandler("query-profiles");
+        const result = await handler({ limit: 2, offset: 1 });
+        const response = JSON.parse(result.content[0].text);
+        expect(response.profiles).toHaveLength(2);
+        expect(response.profiles[0].firstName).toBe("Bob");
+        expect(response.profiles[1].firstName).toBe("Carol");
+        expect(response.total).toBe(4);
+        expect(response.limit).toBe(2);
+        expect(response.offset).toBe(1);
+    });
+    it("returns custom limit and offset in response", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfiles(server);
+        setupSuccessPath();
+        const handler = getHandler("query-profiles");
+        const result = await handler({ limit: 50, offset: 100 });
+        const response = JSON.parse(result.content[0].text);
+        expect(response.limit).toBe(50);
+        expect(response.offset).toBe(100);
+    });
+});
+//# sourceMappingURL=query-profiles.test.js.map

package/dist/tools/query-profiles.test.js.map

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

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

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

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

package/dist/tools/quit-app.js

@@ -0,0 +1,27 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { AppService, DEFAULT_CDP_PORT } from "@lhremote/core";
+import { z } from "zod";
+import { mcpCatchAll, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#quit-app | quit-app} MCP tool. */
+export function registerQuitApp(server) {
+    server.tool("quit-app", "Quit the LinkedHelper application", {
+        cdpPort: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .default(DEFAULT_CDP_PORT)
+            .describe("CDP port"),
+    }, async ({ cdpPort }) => {
+        const app = new AppService(cdpPort);
+        try {
+            await app.quit();
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to quit LinkedHelper");
+        }
+        return mcpSuccess("LinkedHelper quit successfully");
+    });
+}
+//# sourceMappingURL=quit-app.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quit-app.js","sourceRoot":"","sources":["../../src/tools/quit-app.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,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,mCAAmC,EACnC;QACE,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,OAAO,CAAC,gBAAgB,CAAC;aACzB,QAAQ,CAAC,UAAU,CAAC;KACxB,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;QAEpC,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,EAAE,6BAA6B,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,UAAU,CAAC,gCAAgC,CAAC,CAAC;IACtD,CAAC,CACF,CAAC;AACJ,CAAC"}

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

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

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

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

package/dist/tools/quit-app.test.js

@@ -0,0 +1,67 @@
+// 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,
+        AppService: vi.fn(),
+    };
+});
+import { AppService } from "@lhremote/core";
+import { registerQuitApp } from "./quit-app.js";
+import { createMockServer } from "./testing/mock-server.js";
+describe("registerQuitApp", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named quit-app", () => {
+        const { server } = createMockServer();
+        registerQuitApp(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("quit-app", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("returns success on successful quit", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQuitApp(server);
+        vi.mocked(AppService).mockImplementation(function () {
+            return { quit: vi.fn().mockResolvedValue(undefined) };
+        });
+        const handler = getHandler("quit-app");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            content: [{ type: "text", text: "LinkedHelper quit successfully" }],
+        });
+    });
+    it("passes cdpPort to AppService constructor", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQuitApp(server);
+        vi.mocked(AppService).mockImplementation(function () {
+            return { quit: vi.fn().mockResolvedValue(undefined) };
+        });
+        const handler = getHandler("quit-app");
+        await handler({ cdpPort: 4567 });
+        expect(AppService).toHaveBeenCalledWith(4567);
+    });
+    it("returns error response on failure", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQuitApp(server);
+        vi.mocked(AppService).mockImplementation(function () {
+            return {
+                quit: vi.fn().mockRejectedValue(new Error("SIGTERM failed")),
+            };
+        });
+        const handler = getHandler("quit-app");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                { type: "text", text: "Failed to quit LinkedHelper: SIGTERM failed" },
+            ],
+        });
+    });
+});
+//# sourceMappingURL=quit-app.test.js.map

package/dist/tools/quit-app.test.js.map

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

package/dist/tools/scrape-messaging-history.d.ts

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

package/dist/tools/scrape-messaging-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrape-messaging-history.d.ts","sourceRoot":"","sources":["../../src/tools/scrape-messaging-history.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,mIAAmI;AACnI,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgBtE"}

package/dist/tools/scrape-messaging-history.js

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { scrapeMessagingHistory, } from "@lhremote/core";
+import { cdpConnectionSchema, mcpCatchAll, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#scrape-messaging-history | scrape-messaging-history} MCP tool. */
+export function registerScrapeMessagingHistory(server) {
+    server.tool("scrape-messaging-history", "Trigger LinkedHelper to scrape all messaging history from LinkedIn into the local database, then return aggregate stats. This is a long-running operation that may take several minutes.", {
+        ...cdpConnectionSchema,
+    }, async ({ cdpPort, cdpHost, allowRemote }) => {
+        try {
+            const result = await scrapeMessagingHistory({ cdpPort, cdpHost, allowRemote });
+            return mcpSuccess(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to scrape messaging history");
+        }
+    });
+}
+//# sourceMappingURL=scrape-messaging-history.js.map

package/dist/tools/scrape-messaging-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrape-messaging-history.js","sourceRoot":"","sources":["../../src/tools/scrape-messaging-history.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7E,mIAAmI;AACnI,MAAM,UAAU,8BAA8B,CAAC,MAAiB;IAC9D,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,0LAA0L,EAC1L;QACE,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YAC/E,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,oCAAoC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/scrape-messaging-history.test.d.ts

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

package/dist/tools/scrape-messaging-history.test.d.ts.map

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

package/dist/tools/scrape-messaging-history.test.js

@@ -0,0 +1,114 @@
+// 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,
+        scrapeMessagingHistory: vi.fn(),
+    };
+});
+import { AccountResolutionError, scrapeMessagingHistory, } from "@lhremote/core";
+import { registerScrapeMessagingHistory } from "./scrape-messaging-history.js";
+import { describeInfrastructureErrors } from "./testing/infrastructure-errors.js";
+import { createMockServer } from "./testing/mock-server.js";
+const MOCK_STATS = {
+    totalMessages: 2500,
+    totalChats: 150,
+    earliestMessage: "2024-01-15T09:00:00Z",
+    latestMessage: "2025-01-15T12:00:00Z",
+};
+describe("registerScrapeMessagingHistory", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named scrape-messaging-history", () => {
+        const { server } = createMockServer();
+        registerScrapeMessagingHistory(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("scrape-messaging-history", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("returns stats on success", async () => {
+        const { server, getHandler } = createMockServer();
+        registerScrapeMessagingHistory(server);
+        vi.mocked(scrapeMessagingHistory).mockResolvedValue({
+            success: true,
+            actionType: "ScrapeMessagingHistory",
+            stats: MOCK_STATS,
+        });
+        const handler = getHandler("scrape-messaging-history");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        actionType: "ScrapeMessagingHistory",
+                        stats: MOCK_STATS,
+                    }, null, 2),
+                },
+            ],
+        });
+    });
+    it("passes correct arguments to operation", async () => {
+        const { server, getHandler } = createMockServer();
+        registerScrapeMessagingHistory(server);
+        vi.mocked(scrapeMessagingHistory).mockResolvedValue({
+            success: true,
+            actionType: "ScrapeMessagingHistory",
+            stats: MOCK_STATS,
+        });
+        const handler = getHandler("scrape-messaging-history");
+        await handler({ cdpPort: 9222 });
+        expect(scrapeMessagingHistory).toHaveBeenCalledWith(expect.objectContaining({ cdpPort: 9222 }));
+    });
+    it("returns error when no accounts found", async () => {
+        const { server, getHandler } = createMockServer();
+        registerScrapeMessagingHistory(server);
+        vi.mocked(scrapeMessagingHistory).mockRejectedValue(new AccountResolutionError("no-accounts"));
+        const handler = getHandler("scrape-messaging-history");
+        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();
+        registerScrapeMessagingHistory(server);
+        vi.mocked(scrapeMessagingHistory).mockRejectedValue(new AccountResolutionError("multiple-accounts"));
+        const handler = getHandler("scrape-messaging-history");
+        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();
+        registerScrapeMessagingHistory(server);
+        vi.mocked(scrapeMessagingHistory).mockRejectedValue(new Error("action timed out"));
+        const handler = getHandler("scrape-messaging-history");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Failed to scrape messaging history: action timed out",
+                },
+            ],
+        });
+    });
+    describeInfrastructureErrors(registerScrapeMessagingHistory, "scrape-messaging-history", () => ({ cdpPort: 9222 }), (error) => vi.mocked(scrapeMessagingHistory).mockRejectedValue(error), "Failed to scrape messaging history");
+});
+//# sourceMappingURL=scrape-messaging-history.test.js.map

package/dist/tools/scrape-messaging-history.test.js.map

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

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

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

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

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

package/dist/tools/start-instance.js

@@ -0,0 +1,53 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { LauncherService, startInstanceWithRecovery, } from "@lhremote/core";
+import { z } from "zod";
+import { buildCdpOptions, cdpConnectionSchema, mcpCatchAll, mcpError, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#start-instance | start-instance} MCP tool. */
+export function registerStartInstance(server) {
+    server.tool("start-instance", "Start a LinkedHelper instance for a LinkedIn account. Required before campaign or query operations.", {
+        accountId: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Account ID (omit to auto-select if single account)"),
+        ...cdpConnectionSchema,
+    }, async ({ accountId, cdpPort, cdpHost, allowRemote }) => {
+        const launcher = new LauncherService(cdpPort, buildCdpOptions({ cdpHost, allowRemote }));
+        try {
+            await launcher.connect();
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to connect to LinkedHelper");
+        }
+        try {
+            let resolvedId = accountId;
+            if (resolvedId === undefined) {
+                const accounts = await launcher.listAccounts();
+                if (accounts.length === 0) {
+                    return mcpError("No accounts found.");
+                }
+                if (accounts.length > 1) {
+                    return mcpError("Multiple accounts found. Specify accountId. Use list-accounts to see available accounts.");
+                }
+                resolvedId = accounts[0].id;
+            }
+            const outcome = await startInstanceWithRecovery(launcher, resolvedId, cdpPort);
+            if (outcome.status === "timeout") {
+                return mcpError("Instance started but failed to initialize within timeout.");
+            }
+            const verb = outcome.status === "already_running"
+                ? "already running"
+                : "started";
+            return mcpSuccess(`Instance ${verb} for account ${String(resolvedId)} on CDP port ${String(outcome.port)}`);
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to start instance");
+        }
+        finally {
+            launcher.disconnect();
+        }
+    });
+}
+//# sourceMappingURL=start-instance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start-instance.js","sourceRoot":"","sources":["../../src/tools/start-instance.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAEL,eAAe,EACf,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAExG,+GAA+G;AAC/G,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,qGAAqG,EACrG;QACE,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CACP,oDAAoD,CACrD;QACH,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QACrD,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;QAEzF,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,EAAE,mCAAmC,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,CAAC;YACH,IAAI,UAAU,GAAG,SAAS,CAAC;YAE3B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,CAAC;gBAC/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC1B,OAAO,QAAQ,CAAC,oBAAoB,CAAC,CAAC;gBACxC,CAAC;gBACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxB,OAAO,QAAQ,CACb,0FAA0F,CAC3F,CAAC;gBACJ,CAAC;gBACD,UAAU,GAAI,QAAQ,CAAC,CAAC,CAAa,CAAC,EAAE,CAAC;YAC3C,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAC7C,QAAQ,EACR,UAAU,EACV,OAAO,CACR,CAAC;YAEF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACjC,OAAO,QAAQ,CACb,2DAA2D,CAC5D,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GACR,OAAO,CAAC,MAAM,KAAK,iBAAiB;gBAClC,CAAC,CAAC,iBAAiB;gBACnB,CAAC,CAAC,SAAS,CAAC;YAEhB,OAAO,UAAU,CACf,YAAY,IAAI,gBAAgB,MAAM,CAAC,UAAU,CAAC,gBAAgB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CACzF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;QACxD,CAAC;gBAAS,CAAC;YACT,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

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

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

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

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