@lhremote/mcp 0.1.0 → 0.2.0

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"}

package/dist/tools/query-profile.js

@@ -0,0 +1,49 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { DatabaseClient, discoverAllDatabases, ProfileNotFoundError, ProfileRepository, } from "@lhremote/core";
+import { z } from "zod";
+import { mcpCatchAll, mcpError, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#query-profile | query-profile} MCP tool. */
+export function registerQueryProfile(server) {
+    server.tool("query-profile", "Look up a cached LinkedIn profile from the local database without visiting LinkedIn. Returns name, positions, education, skills, and emails.", {
+        personId: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Look up by internal person ID"),
+        publicId: z
+            .string()
+            .optional()
+            .describe("Look up by LinkedIn public ID (profile URL slug, e.g. jane-doe-12345)"),
+    }, async ({ personId, publicId }) => {
+        if ((personId == null) === (publicId == null)) {
+            return mcpError("Exactly one of personId or publicId must be provided.");
+        }
+        const databases = discoverAllDatabases();
+        if (databases.size === 0) {
+            return mcpError("No LinkedHelper databases found.");
+        }
+        for (const [, dbPath] of databases) {
+            const db = new DatabaseClient(dbPath);
+            try {
+                const repo = new ProfileRepository(db);
+                const profile = personId != null
+                    ? repo.findById(personId)
+                    : repo.findByPublicId(publicId);
+                return mcpSuccess(JSON.stringify(profile, null, 2));
+            }
+            catch (error) {
+                if (error instanceof ProfileNotFoundError) {
+                    continue;
+                }
+                return mcpCatchAll(error, "Failed to query profile");
+            }
+            finally {
+                db.close();
+            }
+        }
+        return mcpError("Profile not found.");
+    });
+}
+//# sourceMappingURL=query-profile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-profile.js","sourceRoot":"","sources":["../../src/tools/query-profile.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAElE,6GAA6G;AAC7G,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,eAAe,EACf,8IAA8I,EAC9I;QACE,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,+BAA+B,CAAC;QAC5C,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,uEAAuE,CACxE;KACJ,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC/B,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC;YAC9C,OAAO,QAAQ,CACb,uDAAuD,CACxD,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;QACzC,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,QAAQ,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAED,KAAK,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YACnC,MAAM,EAAE,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,iBAAiB,CAAC,EAAE,CAAC,CAAC;gBACvC,MAAM,OAAO,GACX,QAAQ,IAAI,IAAI;oBACd,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBACzB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,QAAkB,CAAC,CAAC;gBAE9C,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACtD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;oBAC1C,SAAS;gBACX,CAAC;gBACD,OAAO,WAAW,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;YACvD,CAAC;oBAAS,CAAC;gBACT,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC,CACF,CAAC;AACJ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,275 @@
+// 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, ProfileNotFoundError, ProfileRepository, discoverAllDatabases, } from "@lhremote/core";
+import { registerQueryProfile } from "./query-profile.js";
+import { createMockServer } from "./testing/mock-server.js";
+const MOCK_PROFILE = {
+    id: 1,
+    miniProfile: {
+        firstName: "Jane",
+        lastName: "Doe",
+        headline: "Engineering Manager",
+        avatar: null,
+    },
+    externalIds: [
+        { externalId: "jane-doe-12345", typeGroup: "public", isMemberId: false },
+        { externalId: "987654321", typeGroup: "member", isMemberId: true },
+    ],
+    currentPosition: { company: "Acme Corp", title: "Engineering Manager" },
+    positions: [
+        {
+            company: "Acme Corp",
+            title: "Engineering Manager",
+            startDate: "2020-01",
+            endDate: null,
+            isCurrent: true,
+        },
+    ],
+    education: [
+        {
+            school: "MIT",
+            degree: "BS",
+            field: "CS",
+            startDate: "2014",
+            endDate: "2018",
+        },
+    ],
+    skills: [{ name: "TypeScript" }, { name: "React" }],
+    emails: ["jane@acme.com"],
+};
+function mockDb() {
+    const close = vi.fn();
+    vi.mocked(DatabaseClient).mockImplementation(function () {
+        return { close, db: {} };
+    });
+    return { close };
+}
+function mockRepo(profile = MOCK_PROFILE) {
+    vi.mocked(ProfileRepository).mockImplementation(function () {
+        return {
+            findById: vi.fn().mockReturnValue(profile),
+            findByPublicId: vi.fn().mockReturnValue(profile),
+        };
+    });
+}
+function mockRepoNotFound() {
+    vi.mocked(ProfileRepository).mockImplementation(function () {
+        return {
+            findById: vi.fn().mockImplementation((id) => {
+                throw new ProfileNotFoundError(id);
+            }),
+            findByPublicId: vi.fn().mockImplementation((slug) => {
+                throw new ProfileNotFoundError(slug);
+            }),
+        };
+    });
+}
+function setupSuccessPath() {
+    vi.mocked(discoverAllDatabases).mockReturnValue(new Map([[1, "/path/to/db"]]));
+    mockDb();
+    mockRepo();
+}
+describe("registerQueryProfile", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named query-profile", () => {
+        const { server } = createMockServer();
+        registerQueryProfile(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("query-profile", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("returns profile as JSON when looking up by personId", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfile(server);
+        setupSuccessPath();
+        const handler = getHandler("query-profile");
+        const result = await handler({ personId: 1 });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(MOCK_PROFILE, null, 2),
+                },
+            ],
+        });
+    });
+    it("returns profile as JSON when looking up by publicId", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfile(server);
+        setupSuccessPath();
+        const handler = getHandler("query-profile");
+        const result = await handler({ publicId: "jane-doe-12345" });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(MOCK_PROFILE, null, 2),
+                },
+            ],
+        });
+    });
+    it("returns error when neither personId nor publicId provided", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfile(server);
+        const handler = getHandler("query-profile");
+        const result = await handler({});
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Exactly one of personId or publicId must be provided.",
+                },
+            ],
+        });
+    });
+    it("returns error when both personId and publicId provided", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfile(server);
+        const handler = getHandler("query-profile");
+        const result = await handler({ personId: 1, publicId: "jane-doe-12345" });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Exactly one of personId or publicId must be provided.",
+                },
+            ],
+        });
+    });
+    it("returns error when no databases found", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfile(server);
+        vi.mocked(discoverAllDatabases).mockReturnValue(new Map());
+        const handler = getHandler("query-profile");
+        const result = await handler({ personId: 1 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "No LinkedHelper databases found.",
+                },
+            ],
+        });
+    });
+    it("returns error when profile not found in any database", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfile(server);
+        vi.mocked(discoverAllDatabases).mockReturnValue(new Map([[1, "/path/to/db"]]));
+        mockDb();
+        mockRepoNotFound();
+        const handler = getHandler("query-profile");
+        const result = await handler({ personId: 999 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Profile not found.",
+                },
+            ],
+        });
+    });
+    it("searches multiple databases until profile found", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfile(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 {
+                    findById: vi.fn().mockImplementation((id) => {
+                        throw new ProfileNotFoundError(id);
+                    }),
+                    findByPublicId: vi.fn().mockImplementation((slug) => {
+                        throw new ProfileNotFoundError(slug);
+                    }),
+                };
+            }
+            return {
+                findById: vi.fn().mockReturnValue(MOCK_PROFILE),
+                findByPublicId: vi.fn().mockReturnValue(MOCK_PROFILE),
+            };
+        });
+        const handler = getHandler("query-profile");
+        const result = await handler({ personId: 1 });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(MOCK_PROFILE, null, 2),
+                },
+            ],
+        });
+        expect(close).toHaveBeenCalledTimes(2);
+    });
+    it("closes database after successful lookup", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfile(server);
+        vi.mocked(discoverAllDatabases).mockReturnValue(new Map([[1, "/path/to/db"]]));
+        const { close } = mockDb();
+        mockRepo();
+        const handler = getHandler("query-profile");
+        await handler({ personId: 1 });
+        expect(close).toHaveBeenCalledOnce();
+    });
+    it("closes database after failed lookup", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfile(server);
+        vi.mocked(discoverAllDatabases).mockReturnValue(new Map([[1, "/path/to/db"]]));
+        const { close } = mockDb();
+        mockRepoNotFound();
+        const handler = getHandler("query-profile");
+        await handler({ personId: 999 });
+        expect(close).toHaveBeenCalledOnce();
+    });
+    it("returns error on unexpected database failure", async () => {
+        const { server, getHandler } = createMockServer();
+        registerQueryProfile(server);
+        vi.mocked(discoverAllDatabases).mockReturnValue(new Map([[1, "/path/to/db"]]));
+        mockDb();
+        vi.mocked(ProfileRepository).mockImplementation(function () {
+            return {
+                findById: vi.fn().mockImplementation(() => {
+                    throw new Error("database locked");
+                }),
+            };
+        });
+        const handler = getHandler("query-profile");
+        const result = await handler({ personId: 1 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Failed to query profile: database locked",
+                },
+            ],
+        });
+    });
+});
+//# sourceMappingURL=query-profile.test.js.map

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

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

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

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

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

package/dist/tools/query-profiles.js

@@ -0,0 +1,67 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { DatabaseClient, discoverAllDatabases, ProfileRepository, } from "@lhremote/core";
+import { z } from "zod";
+import { mcpCatchAll, mcpError, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#query-profiles | query-profiles} MCP tool. */
+export function registerQueryProfiles(server) {
+    server.tool("query-profiles", "Search for profiles in the local LinkedHelper database by name, headline, or company. Returns a list of matching profiles with pagination.", {
+        query: z
+            .string()
+            .optional()
+            .describe("Search name or headline (LIKE match)"),
+        company: z
+            .string()
+            .optional()
+            .describe("Filter by company name (LIKE match)"),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Max results (default: 20)"),
+        offset: z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Pagination offset (default: 0)"),
+    }, async ({ query, company, limit, offset }) => {
+        const databases = discoverAllDatabases();
+        if (databases.size === 0) {
+            return mcpError("No LinkedHelper databases found.");
+        }
+        // Aggregate results from all databases
+        const allProfiles = [];
+        let totalCount = 0;
+        for (const [, dbPath] of databases) {
+            const db = new DatabaseClient(dbPath);
+            try {
+                const repo = new ProfileRepository(db);
+                const result = repo.search({
+                    ...(query !== undefined && { query }),
+                    ...(company !== undefined && { company }),
+                });
+                allProfiles.push(...result.profiles);
+                totalCount += result.total;
+            }
+            catch (error) {
+                return mcpCatchAll(error, "Failed to query profiles");
+            }
+            finally {
+                db.close();
+            }
+        }
+        const effectiveOffset = offset ?? 0;
+        const effectiveLimit = limit ?? 20;
+        const paginatedProfiles = allProfiles.slice(effectiveOffset, effectiveOffset + effectiveLimit);
+        const response = {
+            profiles: paginatedProfiles,
+            total: totalCount,
+            limit: effectiveLimit,
+            offset: effectiveOffset,
+        };
+        return mcpSuccess(JSON.stringify(response, null, 2));
+    });
+}
+//# sourceMappingURL=query-profiles.js.map