@lhremote/mcp 0.6.0 → 0.8.0

package/dist/tools/send-invite.test.js

@@ -0,0 +1,80 @@
+// 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,
+        sendInvite: vi.fn(),
+    };
+});
+import { sendInvite, } from "@lhremote/core";
+import { registerSendInvite } from "./send-invite.js";
+import { describeInfrastructureErrors } from "./testing/infrastructure-errors.js";
+import { describeEphemeralActionErrors } from "./testing/ephemeral-action-errors.js";
+import { createMockServer } from "./testing/mock-server.js";
+const MOCK_RESULT = {
+    success: true,
+    personId: 100,
+    results: [{ id: 1, actionVersionId: 1, personId: 100, result: 1, platform: null, createdAt: "2026-01-01T00:00:00Z", profile: null }],
+};
+describe("registerSendInvite", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named send-invite", () => {
+        const { server } = createMockServer();
+        registerSendInvite(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("send-invite", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("sends invite on success with personId", async () => {
+        const { server, getHandler } = createMockServer();
+        registerSendInvite(server);
+        vi.mocked(sendInvite).mockResolvedValue(MOCK_RESULT);
+        const handler = getHandler("send-invite");
+        const result = await handler({ personId: 100, cdpPort: 9222 });
+        expect(sendInvite).toHaveBeenCalledWith(expect.objectContaining({ personId: 100, cdpPort: 9222 }));
+        expect(result).toEqual({
+            content: [{ type: "text", text: JSON.stringify(MOCK_RESULT, null, 2) }],
+        });
+    });
+    it("sends invite with url", async () => {
+        const { server, getHandler } = createMockServer();
+        registerSendInvite(server);
+        vi.mocked(sendInvite).mockResolvedValue(MOCK_RESULT);
+        const handler = getHandler("send-invite");
+        await handler({ url: "https://www.linkedin.com/in/jane-doe", cdpPort: 9222 });
+        expect(sendInvite).toHaveBeenCalledWith(expect.objectContaining({ url: "https://www.linkedin.com/in/jane-doe" }));
+    });
+    it("returns error when neither personId nor url provided", async () => {
+        const { server, getHandler } = createMockServer();
+        registerSendInvite(server);
+        const handler = getHandler("send-invite");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [{ type: "text", text: "Exactly one of personId or url must be provided." }],
+        });
+    });
+    it("returns error on invalid messageTemplate JSON", async () => {
+        const { server, getHandler } = createMockServer();
+        registerSendInvite(server);
+        const handler = getHandler("send-invite");
+        const result = await handler({
+            personId: 100,
+            messageTemplate: "not-json",
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [{ type: "text", text: "Invalid JSON in messageTemplate." }],
+        });
+    });
+    describeInfrastructureErrors(registerSendInvite, "send-invite", () => ({ personId: 100, cdpPort: 9222 }), (error) => vi.mocked(sendInvite).mockRejectedValue(error), "Failed to send invite");
+    describeEphemeralActionErrors(registerSendInvite, "send-invite", () => ({ personId: 100, cdpPort: 9222 }), (error) => vi.mocked(sendInvite).mockRejectedValue(error), "Failed to send invite");
+});
+//# sourceMappingURL=send-invite.test.js.map

package/dist/tools/send-invite.test.js.map

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

package/dist/tools/testing/ephemeral-action-errors.d.ts

@@ -0,0 +1,9 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Shared error tests for ephemeral-action-based MCP tools.
+ *
+ * Covers CampaignExecutionError and CampaignTimeoutError in addition to
+ * the infrastructure errors tested by describeInfrastructureErrors.
+ */
+export declare function describeEphemeralActionErrors(registerTool: (server: McpServer) => void, toolName: string, getArgs: () => Record<string, unknown>, mockOperation: (error: Error) => void, errorPrefix: string): void;
+//# sourceMappingURL=ephemeral-action-errors.d.ts.map

package/dist/tools/testing/ephemeral-action-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral-action-errors.d.ts","sourceRoot":"","sources":["../../../src/tools/testing/ephemeral-action-errors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,EACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EACrC,WAAW,EAAE,MAAM,GAClB,IAAI,CA0CN"}

package/dist/tools/testing/ephemeral-action-errors.js

@@ -0,0 +1,48 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { CampaignExecutionError, CampaignTimeoutError } from "@lhremote/core";
+import { describe, expect, it } from "vitest";
+import { createMockServer } from "./mock-server.js";
+/**
+ * Shared error tests for ephemeral-action-based MCP tools.
+ *
+ * Covers CampaignExecutionError and CampaignTimeoutError in addition to
+ * the infrastructure errors tested by describeInfrastructureErrors.
+ */
+export function describeEphemeralActionErrors(registerTool, toolName, getArgs, mockOperation, errorPrefix) {
+    describe("ephemeral action errors", () => {
+        it("returns error on campaign execution failure", async () => {
+            const { server, getHandler } = createMockServer();
+            registerTool(server);
+            mockOperation(new CampaignExecutionError("Person 100 not found in database"));
+            const handler = getHandler(toolName);
+            const result = await handler(getArgs());
+            expect(result).toEqual({
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `${errorPrefix}: Person 100 not found in database`,
+                    },
+                ],
+            });
+        });
+        it("returns error on campaign timeout", async () => {
+            const { server, getHandler } = createMockServer();
+            registerTool(server);
+            mockOperation(new CampaignTimeoutError("Ephemeral action did not complete within 300000ms", 42));
+            const handler = getHandler(toolName);
+            const result = await handler(getArgs());
+            expect(result).toEqual({
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `${errorPrefix}: Ephemeral action did not complete within 300000ms`,
+                    },
+                ],
+            });
+        });
+    });
+}
+//# sourceMappingURL=ephemeral-action-errors.js.map

package/dist/tools/testing/ephemeral-action-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral-action-errors.js","sourceRoot":"","sources":["../../../src/tools/testing/ephemeral-action-errors.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAC3C,YAAyC,EACzC,QAAgB,EAChB,OAAsC,EACtC,aAAqC,EACrC,WAAmB;IAEnB,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;YAC3D,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;YAClD,YAAY,CAAC,MAAM,CAAC,CAAC;YAErB,aAAa,CAAC,IAAI,sBAAsB,CAAC,kCAAkC,CAAC,CAAC,CAAC;YAE9E,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAExC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,GAAG,WAAW,oCAAoC;qBACzD;iBACF;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;YAClD,YAAY,CAAC,MAAM,CAAC,CAAC;YAErB,aAAa,CAAC,IAAI,oBAAoB,CAAC,mDAAmD,EAAE,EAAE,CAAC,CAAC,CAAC;YAEjG,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAExC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,GAAG,WAAW,qDAAqD;qBAC1E;iBACF;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

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

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

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

package/dist/tools/visit-profile.js

@@ -0,0 +1,37 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { visitProfile, } from "@lhremote/core";
+import { z } from "zod";
+import { cdpConnectionSchema, mcpCatchAll, mcpError, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#visit-profile | visit-profile} MCP tool. */
+export function registerVisitProfile(server) {
+    server.tool("visit-profile", "Visit a LinkedIn profile via LinkedHelper's VisitAndExtract action and return the extracted profile data. Accepts either a person ID or a LinkedIn profile URL. Deducts from the daily action budget.", {
+        personId: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Internal person ID to visit"),
+        url: z
+            .string()
+            .optional()
+            .describe("LinkedIn profile URL (e.g. https://www.linkedin.com/in/jane-doe-123). The person must already exist in the database."),
+        extractCurrentOrganizations: z
+            .boolean()
+            .optional()
+            .describe("Extract current company info during profile visit"),
+        ...cdpConnectionSchema,
+    }, async ({ personId, url, extractCurrentOrganizations, cdpPort, cdpHost, allowRemote }) => {
+        if ((personId == null) === (url == null)) {
+            return mcpError("Exactly one of personId or url must be provided.");
+        }
+        try {
+            const result = await visitProfile({ personId, url, extractCurrentOrganizations, cdpPort, cdpHost, allowRemote });
+            return mcpSuccess(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to visit profile");
+        }
+    });
+}
+//# sourceMappingURL=visit-profile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"visit-profile.js","sourceRoot":"","sources":["../../src/tools/visit-profile.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,YAAY,GACb,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,6GAA6G;AAC7G,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,eAAe,EACf,uMAAuM,EACvM;QACE,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,6BAA6B,CAAC;QAC1C,GAAG,EAAE,CAAC;aACH,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,sHAAsH,CACvH;QACH,2BAA2B,EAAE,CAAC;aAC3B,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CACP,mDAAmD,CACpD;QACH,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,2BAA2B,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QACtF,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;YACzC,OAAO,QAAQ,CACb,kDAAkD,CACnD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,2BAA2B,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YACjH,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,yBAAyB,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,164 @@
+// 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,
+        visitProfile: vi.fn(),
+    };
+});
+import { AccountResolutionError, visitProfile, } from "@lhremote/core";
+import { registerVisitProfile } from "./visit-profile.js";
+import { describeInfrastructureErrors } from "./testing/infrastructure-errors.js";
+import { createMockServer } from "./testing/mock-server.js";
+const MOCK_PROFILE = {
+    id: 100,
+    miniProfile: {
+        firstName: "Jane",
+        lastName: "Doe",
+        headline: "Software Engineer",
+        avatar: null,
+    },
+    externalIds: [{ externalId: "jane-doe-123", typeGroup: "public", isMemberId: false }],
+    currentPosition: { company: "Acme Corp", title: "Senior Engineer" },
+    education: [],
+    skills: [{ name: "TypeScript" }],
+    emails: [],
+};
+describe("registerVisitProfile", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named visit-profile", () => {
+        const { server } = createMockServer();
+        registerVisitProfile(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("visit-profile", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("returns profile on success with personId", async () => {
+        const { server, getHandler } = createMockServer();
+        registerVisitProfile(server);
+        vi.mocked(visitProfile).mockResolvedValue({
+            success: true,
+            actionType: "VisitAndExtract",
+            profile: MOCK_PROFILE,
+        });
+        const handler = getHandler("visit-profile");
+        const result = await handler({ personId: 100, cdpPort: 9222 });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        actionType: "VisitAndExtract",
+                        profile: MOCK_PROFILE,
+                    }, null, 2),
+                },
+            ],
+        });
+    });
+    it("returns profile on success with url", async () => {
+        const { server, getHandler } = createMockServer();
+        registerVisitProfile(server);
+        vi.mocked(visitProfile).mockResolvedValue({
+            success: true,
+            actionType: "VisitAndExtract",
+            profile: MOCK_PROFILE,
+        });
+        const handler = getHandler("visit-profile");
+        const result = await handler({ url: "https://www.linkedin.com/in/jane-doe-123", cdpPort: 9222 });
+        expect(visitProfile).toHaveBeenCalledWith(expect.objectContaining({ url: "https://www.linkedin.com/in/jane-doe-123", cdpPort: 9222 }));
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: expect.any(String),
+                },
+            ],
+        });
+    });
+    it("returns error when neither personId nor url provided", async () => {
+        const { server, getHandler } = createMockServer();
+        registerVisitProfile(server);
+        const handler = getHandler("visit-profile");
+        const result = await handler({ cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [{ type: "text", text: "Exactly one of personId or url must be provided." }],
+        });
+        expect(visitProfile).not.toHaveBeenCalled();
+    });
+    it("returns error when both personId and url provided", async () => {
+        const { server, getHandler } = createMockServer();
+        registerVisitProfile(server);
+        const handler = getHandler("visit-profile");
+        const result = await handler({ personId: 100, url: "https://www.linkedin.com/in/jane-doe", cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [{ type: "text", text: "Exactly one of personId or url must be provided." }],
+        });
+        expect(visitProfile).not.toHaveBeenCalled();
+    });
+    it("passes correct arguments to operation", async () => {
+        const { server, getHandler } = createMockServer();
+        registerVisitProfile(server);
+        vi.mocked(visitProfile).mockResolvedValue({
+            success: true,
+            actionType: "VisitAndExtract",
+            profile: MOCK_PROFILE,
+        });
+        const handler = getHandler("visit-profile");
+        await handler({ personId: 100, extractCurrentOrganizations: true, cdpPort: 9222 });
+        expect(visitProfile).toHaveBeenCalledWith(expect.objectContaining({ personId: 100, extractCurrentOrganizations: true, cdpPort: 9222 }));
+    });
+    it("returns error when no accounts found", async () => {
+        const { server, getHandler } = createMockServer();
+        registerVisitProfile(server);
+        vi.mocked(visitProfile).mockRejectedValue(new AccountResolutionError("no-accounts"));
+        const handler = getHandler("visit-profile");
+        const result = await handler({ personId: 100, 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();
+        registerVisitProfile(server);
+        vi.mocked(visitProfile).mockRejectedValue(new AccountResolutionError("multiple-accounts"));
+        const handler = getHandler("visit-profile");
+        const result = await handler({ personId: 100, 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();
+        registerVisitProfile(server);
+        vi.mocked(visitProfile).mockRejectedValue(new Error("action timed out"));
+        const handler = getHandler("visit-profile");
+        const result = await handler({ personId: 100, cdpPort: 9222 });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Failed to visit profile: action timed out",
+                },
+            ],
+        });
+    });
+    describeInfrastructureErrors(registerVisitProfile, "visit-profile", () => ({ personId: 100, cdpPort: 9222 }), (error) => vi.mocked(visitProfile).mockRejectedValue(error), "Failed to visit profile");
+});
+//# sourceMappingURL=visit-profile.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"visit-profile.test.js","sourceRoot":"","sources":["../../src/tools/visit-profile.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,gBAAgB,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;IACjD,MAAM,MAAM,GAAG,MAAM,cAAc,EAAmC,CAAC;IACvE,OAAO;QACL,GAAG,MAAM;QACT,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;KACtB,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,OAAO,EAEL,sBAAsB,EACtB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,YAAY,GAAY;IAC5B,EAAE,EAAE,GAAG;IACP,WAAW,EAAE;QACX,SAAS,EAAE,MAAM;QACjB,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,mBAAmB;QAC7B,MAAM,EAAE,IAAI;KACb;IACD,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IACrF,eAAe,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,iBAAiB,EAAE;IACnE,SAAS,EAAE,EAAE;IACb,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAChC,MAAM,EAAE,EAAE;CACX,CAAC;AAEF,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,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,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;QACtC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,CACtC,eAAe,EACf,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAClB,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAClB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CACrB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,iBAAiB,CAAC;YACxC,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,iBAAiB;YAC7B,OAAO,EAAE,YAAY;SACtB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,OAAO,EAAE,IAAI;wBACb,UAAU,EAAE,iBAAiB;wBAC7B,OAAO,EAAE,YAAY;qBACtB,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,iBAAiB,CAAC;YACxC,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,iBAAiB;YAC7B,OAAO,EAAE,YAAY;SACtB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,GAAG,EAAE,0CAA0C,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEjG,MAAM,CAAC,YAAY,CAAC,CAAC,oBAAoB,CACvC,MAAM,CAAC,gBAAgB,CAAC,EAAE,GAAG,EAAE,0CAA0C,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAC5F,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;iBACzB;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kDAAkD,EAAE,CAAC;SACtF,CAAC,CAAC;QACH,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,sCAAsC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAE5G,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kDAAkD,EAAE,CAAC;SACtF,CAAC,CAAC;QACH,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,iBAAiB,CAAC;YACxC,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,iBAAiB;YAC7B,OAAO,EAAE,YAAY;SACtB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,2BAA2B,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnF,MAAM,CAAC,YAAY,CAAC,CAAC,oBAAoB,CACvC,MAAM,CAAC,gBAAgB,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,2BAA2B,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAC7F,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,iBAAiB,CACvC,IAAI,sBAAsB,CAAC,aAAa,CAAC,CAC1C,CAAC;QAEF,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;SACxD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,iBAAiB,CACvC,IAAI,sBAAsB,CAAC,mBAAmB,CAAC,CAChD,CAAC;QAEF,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kEAAkE;iBACzE;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,iBAAiB,CACvC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAC9B,CAAC;QAEF,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,2CAA2C;iBAClD;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,4BAA4B,CAC1B,oBAAoB,EACpB,eAAe,EACf,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EACxC,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAC3D,yBAAyB,CAC1B,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lhremote/mcp",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "MCP server for LinkedHelper automation",
   "type": "module",
   "engines": {
@@ -46,7 +46,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
     "zod": "^4.3.6",
-    "@lhremote/core": "^0.6.0"
+    "@lhremote/core": "^0.8.0"
   },
   "devDependencies": {
     "@types/node": "^25",