@lhremote/mcp 0.0.0 → 0.2.0

package/dist/tools/list-accounts.js

@@ -0,0 +1,29 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { LauncherService } from "@lhremote/core";
+import { buildCdpOptions, cdpConnectionSchema, mcpCatchAll, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#list-accounts | list-accounts} MCP tool. */
+export function registerListAccounts(server) {
+    server.tool("list-accounts", "List available LinkedHelper accounts", {
+        ...cdpConnectionSchema,
+    }, async ({ 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 {
+            const accounts = await launcher.listAccounts();
+            return mcpSuccess(JSON.stringify(accounts, null, 2));
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to list accounts");
+        }
+        finally {
+            launcher.disconnect();
+        }
+    });
+}
+//# sourceMappingURL=list-accounts.js.map

package/dist/tools/list-accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-accounts.js","sourceRoot":"","sources":["../../src/tools/list-accounts.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE9F,6GAA6G;AAC7G,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,eAAe,EACf,sCAAsC,EACtC;QACE,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QAC1C,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,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,CAAC;YAC/C,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;QACvD,CAAC;gBAAS,CAAC;YACT,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/list-accounts.test.d.ts

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

package/dist/tools/list-accounts.test.d.ts.map

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

package/dist/tools/list-accounts.test.js

@@ -0,0 +1,101 @@
+// 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,
+        LauncherService: vi.fn(),
+    };
+});
+import { LauncherService, LinkedHelperNotRunningError, } from "@lhremote/core";
+import { registerListAccounts } from "./list-accounts.js";
+import { createMockServer } from "./testing/mock-server.js";
+function mockLauncher(overrides = {}) {
+    const disconnect = vi.fn();
+    vi.mocked(LauncherService).mockImplementation(function () {
+        return {
+            connect: vi.fn().mockResolvedValue(undefined),
+            disconnect,
+            listAccounts: vi.fn().mockResolvedValue([]),
+            ...overrides,
+        };
+    });
+    return { disconnect };
+}
+describe("registerListAccounts", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named list-accounts", () => {
+        const { server } = createMockServer();
+        registerListAccounts(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("list-accounts", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("returns accounts as JSON", async () => {
+        const { server, getHandler } = createMockServer();
+        registerListAccounts(server);
+        const accounts = [
+            { id: 1, liId: 100, name: "Alice" },
+            { id: 2, liId: 200, name: "Bob", email: "bob@example.com" },
+        ];
+        mockLauncher({
+            listAccounts: vi.fn().mockResolvedValue(accounts),
+        });
+        const handler = getHandler("list-accounts");
+        const result = (await handler({ cdpPort: 9222 }));
+        expect(JSON.parse(result.content[0].text)).toEqual(accounts);
+    });
+    it("returns empty array when no accounts", async () => {
+        const { server, getHandler } = createMockServer();
+        registerListAccounts(server);
+        mockLauncher({ listAccounts: vi.fn().mockResolvedValue([]) });
+        const handler = getHandler("list-accounts");
+        const result = (await handler({ cdpPort: 9222 }));
+        expect(JSON.parse(result.content[0].text)).toEqual([]);
+    });
+    it("returns error when LinkedHelper not running", async () => {
+        const { server, getHandler } = createMockServer();
+        registerListAccounts(server);
+        vi.mocked(LauncherService).mockImplementation(function () {
+            return {
+                connect: vi
+                    .fn()
+                    .mockRejectedValue(new LinkedHelperNotRunningError(9222)),
+                disconnect: vi.fn(),
+            };
+        });
+        const handler = getHandler("list-accounts");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "LinkedHelper is not running. Use launch-app first.",
+                },
+            ],
+        });
+    });
+    it("disconnects after successful call", async () => {
+        const { server, getHandler } = createMockServer();
+        registerListAccounts(server);
+        const { disconnect } = mockLauncher();
+        const handler = getHandler("list-accounts");
+        await handler({ cdpPort: 9222 });
+        expect(disconnect).toHaveBeenCalledOnce();
+    });
+    it("passes cdpPort to LauncherService", async () => {
+        const { server, getHandler } = createMockServer();
+        registerListAccounts(server);
+        mockLauncher();
+        const handler = getHandler("list-accounts");
+        await handler({ cdpPort: 4567 });
+        expect(LauncherService).toHaveBeenCalledWith(4567, {});
+    });
+});
+//# sourceMappingURL=list-accounts.test.js.map

package/dist/tools/list-accounts.test.js.map

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

package/dist/tools/query-messages.d.ts

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

package/dist/tools/query-messages.d.ts.map

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

package/dist/tools/query-messages.integration.test.d.ts

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

package/dist/tools/query-messages.integration.test.d.ts.map

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

package/dist/tools/query-messages.integration.test.js

@@ -0,0 +1,119 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const FIXTURE_PATH = join(__dirname, "../../../core/src/db/testing/fixture.db");
+vi.mock("@lhremote/core", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        queryMessages: vi.fn(),
+    };
+});
+import { ChatNotFoundError, DatabaseClient, MessageRepository, queryMessages, } from "@lhremote/core";
+import { registerQueryMessages } from "./query-messages.js";
+import { createMockServer } from "./testing/mock-server.js";
+/**
+ * Run the real query-messages logic against the fixture DB.
+ * This replaces the mock so the MCP tool handler exercises real DB queries.
+ */
+function fixtureQueryMessages(input) {
+    const client = new DatabaseClient(FIXTURE_PATH);
+    try {
+        const repo = new MessageRepository(client);
+        const limit = input.limit ?? 20;
+        const offset = input.offset ?? 0;
+        if (input.chatId != null) {
+            const thread = repo.getThread(input.chatId, { limit });
+            return { kind: "thread", thread };
+        }
+        if (input.search != null) {
+            const messages = repo.searchMessages(input.search, { limit });
+            return { kind: "search", messages, total: messages.length };
+        }
+        const conversations = repo.listChats({
+            ...(input.personId != null && { personId: input.personId }),
+            limit,
+            offset,
+        });
+        return { kind: "conversations", conversations, total: conversations.length };
+    }
+    finally {
+        client.close();
+    }
+}
+describe("registerQueryMessages (integration)", () => {
+    beforeEach(() => {
+        vi.mocked(queryMessages).mockImplementation(async (input) => fixtureQueryMessages(input));
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("lists conversations from the fixture database", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryMessages(server);
+        const handler = getHandler("query-messages");
+        const result = (await handler({ cdpPort: 9222 }));
+        expect(result.isError).toBeUndefined();
+        const body = JSON.parse(result.content[0].text);
+        expect(body.conversations.length).toBeGreaterThanOrEqual(3);
+    });
+    it("filters conversations by personId", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryMessages(server);
+        const handler = getHandler("query-messages");
+        // Person 1 (Ada) participates in chat 1, chat 2, and chat 4
+        const result = (await handler({ personId: 1, cdpPort: 9222 }));
+        const body = JSON.parse(result.content[0].text);
+        expect(body.conversations).toHaveLength(3);
+        const chatIds = body.conversations.map((c) => c.id);
+        expect(chatIds).toContain(1);
+        expect(chatIds).toContain(2);
+        expect(chatIds).toContain(4);
+    });
+    it("retrieves a conversation thread by chatId", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryMessages(server);
+        const handler = getHandler("query-messages");
+        const result = (await handler({ chatId: 1, cdpPort: 9222 }));
+        const body = JSON.parse(result.content[0].text);
+        expect(body.chat.id).toBe(1);
+        expect(body.chat.participants.length).toBeGreaterThanOrEqual(2);
+        expect(body.messages.length).toBeGreaterThanOrEqual(3);
+        // Messages should be in chronological order
+        const sendTimes = body.messages.map((m) => m.sendAt);
+        const sorted = [...sendTimes].sort();
+        expect(sendTimes).toEqual(sorted);
+    });
+    it("searches messages by text", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryMessages(server);
+        const handler = getHandler("query-messages");
+        const result = (await handler({ search: "compiler", cdpPort: 9222 }));
+        const body = JSON.parse(result.content[0].text);
+        expect(body.messages.length).toBeGreaterThanOrEqual(1);
+        for (const msg of body.messages) {
+            expect(msg.text.toLowerCase()).toContain("compiler");
+        }
+    });
+    it("returns error for nonexistent chatId", async () => {
+        vi.mocked(queryMessages).mockRejectedValue(new ChatNotFoundError(999));
+        const { server, getHandler } = createMockServer();
+        registerQueryMessages(server);
+        const handler = getHandler("query-messages");
+        const result = (await handler({ chatId: 999, cdpPort: 9222 }));
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toBe("Chat not found.");
+    });
+    it("respects limit parameter", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryMessages(server);
+        const handler = getHandler("query-messages");
+        const result = (await handler({ limit: 1, cdpPort: 9222 }));
+        const body = JSON.parse(result.content[0].text);
+        expect(body.conversations).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=query-messages.integration.test.js.map

package/dist/tools/query-messages.integration.test.js.map

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

package/dist/tools/query-messages.js

@@ -0,0 +1,55 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { ChatNotFoundError, queryMessages, } from "@lhremote/core";
+import { z } from "zod";
+import { cdpConnectionSchema, mcpCatchAll, mcpError, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#query-messages | query-messages} MCP tool. */
+export function registerQueryMessages(server) {
+    server.tool("query-messages", "Query messaging history from the local LinkedHelper database. List conversations, read threads, or search messages.", {
+        personId: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Filter conversations by person ID"),
+        chatId: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Get a specific conversation thread"),
+        search: z
+            .string()
+            .optional()
+            .describe("Search message text (LIKE match)"),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Max results (default: 20)"),
+        offset: z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Pagination offset (default: 0)"),
+        ...cdpConnectionSchema,
+    }, async ({ personId, chatId, search, limit, offset, cdpPort, cdpHost, allowRemote }) => {
+        try {
+            const result = await queryMessages({ personId, chatId, search, limit, offset, cdpPort, cdpHost, allowRemote });
+            if (result.kind === "thread")
+                return mcpSuccess(JSON.stringify(result.thread, null, 2));
+            if (result.kind === "search")
+                return mcpSuccess(JSON.stringify({ messages: result.messages, total: result.total }, null, 2));
+            return mcpSuccess(JSON.stringify({ conversations: result.conversations, total: result.total }, null, 2));
+        }
+        catch (error) {
+            if (error instanceof ChatNotFoundError) {
+                return mcpError("Chat not found.");
+            }
+            return mcpCatchAll(error, "Failed to query messages");
+        }
+    });
+}
+//# sourceMappingURL=query-messages.js.map

package/dist/tools/query-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-messages.js","sourceRoot":"","sources":["../../src/tools/query-messages.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,iBAAiB,EACjB,aAAa,GACd,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,+GAA+G;AAC/G,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,qHAAqH,EACrH;QACE,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,mCAAmC,CAAC;QAChD,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,oCAAoC,CAAC;QACjD,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,kCAAkC,CAAC;QAC/C,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,2BAA2B,CAAC;QACxC,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,EAAE;aACL,WAAW,EAAE;aACb,QAAQ,EAAE;aACV,QAAQ,CAAC,gCAAgC,CAAC;QAC7C,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QACnF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YAC/G,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACxF,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7H,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3G,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;gBACvC,OAAO,QAAQ,CAAC,iBAAiB,CAAC,CAAC;YACrC,CAAC;YACD,OAAO,WAAW,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/query-messages.test.d.ts

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

package/dist/tools/query-messages.test.d.ts.map

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

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

@@ -0,0 +1,211 @@
+// 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,
+        queryMessages: vi.fn(),
+    };
+});
+import { ChatNotFoundError, queryMessages, } from "@lhremote/core";
+import { registerQueryMessages } from "./query-messages.js";
+import { describeInfrastructureErrors } from "./testing/infrastructure-errors.js";
+import { createMockServer } from "./testing/mock-server.js";
+const MOCK_CHAT = {
+    id: 123,
+    type: "MEMBER_TO_MEMBER",
+    platform: "LINKEDIN",
+    participants: [
+        { personId: 456, firstName: "Jane", lastName: "Doe" },
+    ],
+    messageCount: 12,
+    lastMessage: {
+        text: "Thanks for reaching out!",
+        sendAt: "2025-01-15T10:30:00Z",
+    },
+};
+const MOCK_MESSAGE = {
+    id: 1,
+    type: "DEFAULT",
+    text: "Hi Jane, I saw your work on...",
+    subject: null,
+    sendAt: "2025-01-14T09:00:00Z",
+    attachmentsCount: 0,
+    senderPersonId: 789,
+    senderFirstName: "Alexey",
+    senderLastName: "Pelykh",
+};
+const MOCK_THREAD = {
+    chat: MOCK_CHAT,
+    messages: [MOCK_MESSAGE],
+};
+describe("registerQueryMessages", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named query-messages", () => {
+        const { server } = createMockServer();
+        registerQueryMessages(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("query-messages", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("returns conversations list when no filters provided", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryMessages(server);
+        vi.mocked(queryMessages).mockResolvedValue({
+            kind: "conversations",
+            conversations: [MOCK_CHAT],
+            total: 1,
+        });
+        const handler = getHandler("query-messages");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ conversations: [MOCK_CHAT], total: 1 }, null, 2),
+                },
+            ],
+        });
+    });
+    it("returns conversations filtered by personId", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryMessages(server);
+        vi.mocked(queryMessages).mockResolvedValue({
+            kind: "conversations",
+            conversations: [MOCK_CHAT],
+            total: 1,
+        });
+        const handler = getHandler("query-messages");
+        const result = await handler({ personId: 456, cdpPort: 9222 });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ conversations: [MOCK_CHAT], total: 1 }, null, 2),
+                },
+            ],
+        });
+    });
+    it("returns conversation thread when chatId provided", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryMessages(server);
+        vi.mocked(queryMessages).mockResolvedValue({
+            kind: "thread",
+            thread: MOCK_THREAD,
+        });
+        const handler = getHandler("query-messages");
+        const result = await handler({ chatId: 123, cdpPort: 9222 });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(MOCK_THREAD, null, 2),
+                },
+            ],
+        });
+    });
+    it("returns search results when search provided", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryMessages(server);
+        vi.mocked(queryMessages).mockResolvedValue({
+            kind: "search",
+            messages: [MOCK_MESSAGE],
+            total: 1,
+        });
+        const handler = getHandler("query-messages");
+        const result = await handler({ search: "reaching out", cdpPort: 9222 });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ messages: [MOCK_MESSAGE], total: 1 }, null, 2),
+                },
+            ],
+        });
+    });
+    it("returns error when chat not found", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryMessages(server);
+        vi.mocked(queryMessages).mockRejectedValue(new ChatNotFoundError(999));
+        const handler = getHandler("query-messages");
+        const result = await handler({ chatId: 999, cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Chat not found.",
+                },
+            ],
+        });
+    });
+    it("returns error on unexpected failure", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryMessages(server);
+        vi.mocked(queryMessages).mockRejectedValue(new Error("database locked"));
+        const handler = getHandler("query-messages");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Failed to query messages: database locked",
+                },
+            ],
+        });
+    });
+    describeInfrastructureErrors(registerQueryMessages, "query-messages", () => ({ cdpPort: 9222 }), (error) => vi.mocked(queryMessages).mockRejectedValue(error), "Failed to query messages");
+    it("chatId takes priority over search and personId", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryMessages(server);
+        vi.mocked(queryMessages).mockResolvedValue({
+            kind: "thread",
+            thread: MOCK_THREAD,
+        });
+        const handler = getHandler("query-messages");
+        const result = await handler({
+            chatId: 123,
+            search: "hello",
+            personId: 456,
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(MOCK_THREAD, null, 2),
+                },
+            ],
+        });
+    });
+    it("search takes priority over personId", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryMessages(server);
+        vi.mocked(queryMessages).mockResolvedValue({
+            kind: "search",
+            messages: [MOCK_MESSAGE],
+            total: 1,
+        });
+        const handler = getHandler("query-messages");
+        const result = await handler({
+            search: "reaching out",
+            personId: 456,
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ messages: [MOCK_MESSAGE], total: 1 }, null, 2),
+                },
+            ],
+        });
+    });
+});
+//# sourceMappingURL=query-messages.test.js.map

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

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

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

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

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