@lhremote/mcp 0.0.0 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (82) hide show
  1. package/LICENSE +661 -0
  2. package/dist/index.d.ts +1 -0
  3. package/dist/index.d.ts.map +1 -1
  4. package/dist/index.js +3 -1
  5. package/dist/index.js.map +1 -1
  6. package/dist/server.d.ts +6 -0
  7. package/dist/server.d.ts.map +1 -0
  8. package/dist/server.js +14 -0
  9. package/dist/server.js.map +1 -0
  10. package/dist/server.test.d.ts +2 -0
  11. package/dist/server.test.d.ts.map +1 -0
  12. package/dist/server.test.js +58 -0
  13. package/dist/server.test.js.map +1 -0
  14. package/dist/stdio.d.ts +7 -0
  15. package/dist/stdio.d.ts.map +1 -0
  16. package/dist/stdio.js +34 -0
  17. package/dist/stdio.js.map +1 -0
  18. package/dist/tools/check-status.d.ts +3 -0
  19. package/dist/tools/check-status.d.ts.map +1 -0
  20. package/dist/tools/check-status.js +35 -0
  21. package/dist/tools/check-status.js.map +1 -0
  22. package/dist/tools/check-status.test.d.ts +2 -0
  23. package/dist/tools/check-status.test.d.ts.map +1 -0
  24. package/dist/tools/check-status.test.js +86 -0
  25. package/dist/tools/check-status.test.js.map +1 -0
  26. package/dist/tools/index.d.ts +3 -0
  27. package/dist/tools/index.d.ts.map +1 -0
  28. package/dist/tools/index.js +17 -0
  29. package/dist/tools/index.js.map +1 -0
  30. package/dist/tools/launch-app.d.ts +3 -0
  31. package/dist/tools/launch-app.d.ts.map +1 -0
  32. package/dist/tools/launch-app.js +42 -0
  33. package/dist/tools/launch-app.js.map +1 -0
  34. package/dist/tools/launch-app.test.d.ts +2 -0
  35. package/dist/tools/launch-app.test.d.ts.map +1 -0
  36. package/dist/tools/launch-app.test.js +102 -0
  37. package/dist/tools/launch-app.test.js.map +1 -0
  38. package/dist/tools/list-accounts.d.ts +3 -0
  39. package/dist/tools/list-accounts.d.ts.map +1 -0
  40. package/dist/tools/list-accounts.js +62 -0
  41. package/dist/tools/list-accounts.js.map +1 -0
  42. package/dist/tools/list-accounts.test.d.ts +2 -0
  43. package/dist/tools/list-accounts.test.d.ts.map +1 -0
  44. package/dist/tools/list-accounts.test.js +99 -0
  45. package/dist/tools/list-accounts.test.js.map +1 -0
  46. package/dist/tools/quit-app.d.ts +3 -0
  47. package/dist/tools/quit-app.d.ts.map +1 -0
  48. package/dist/tools/quit-app.js +31 -0
  49. package/dist/tools/quit-app.js.map +1 -0
  50. package/dist/tools/quit-app.test.d.ts +2 -0
  51. package/dist/tools/quit-app.test.d.ts.map +1 -0
  52. package/dist/tools/quit-app.test.js +65 -0
  53. package/dist/tools/quit-app.test.js.map +1 -0
  54. package/dist/tools/start-instance.d.ts +3 -0
  55. package/dist/tools/start-instance.d.ts.map +1 -0
  56. package/dist/tools/start-instance.js +115 -0
  57. package/dist/tools/start-instance.js.map +1 -0
  58. package/dist/tools/start-instance.test.d.ts +2 -0
  59. package/dist/tools/start-instance.test.d.ts.map +1 -0
  60. package/dist/tools/start-instance.test.js +232 -0
  61. package/dist/tools/start-instance.test.js.map +1 -0
  62. package/dist/tools/stop-instance.d.ts +3 -0
  63. package/dist/tools/stop-instance.d.ts.map +1 -0
  64. package/dist/tools/stop-instance.js +101 -0
  65. package/dist/tools/stop-instance.js.map +1 -0
  66. package/dist/tools/stop-instance.test.d.ts +2 -0
  67. package/dist/tools/stop-instance.test.d.ts.map +1 -0
  68. package/dist/tools/stop-instance.test.js +177 -0
  69. package/dist/tools/stop-instance.test.js.map +1 -0
  70. package/dist/tools/testing/mock-server.d.ts +6 -0
  71. package/dist/tools/testing/mock-server.d.ts.map +1 -0
  72. package/dist/tools/testing/mock-server.js +19 -0
  73. package/dist/tools/testing/mock-server.js.map +1 -0
  74. package/dist/tools/visit-and-extract.d.ts +3 -0
  75. package/dist/tools/visit-and-extract.d.ts.map +1 -0
  76. package/dist/tools/visit-and-extract.js +183 -0
  77. package/dist/tools/visit-and-extract.js.map +1 -0
  78. package/dist/tools/visit-and-extract.test.d.ts +2 -0
  79. package/dist/tools/visit-and-extract.test.d.ts.map +1 -0
  80. package/dist/tools/visit-and-extract.test.js +399 -0
  81. package/dist/tools/visit-and-extract.test.js.map +1 -0
  82. package/package.json +29 -13
@@ -0,0 +1,99 @@
1
+ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
2
+ vi.mock("@lhremote/core", async (importOriginal) => {
3
+ const actual = await importOriginal();
4
+ return {
5
+ ...actual,
6
+ LauncherService: vi.fn(),
7
+ };
8
+ });
9
+ import { LauncherService, LinkedHelperNotRunningError, } from "@lhremote/core";
10
+ import { registerListAccounts } from "./list-accounts.js";
11
+ import { createMockServer } from "./testing/mock-server.js";
12
+ function mockLauncher(overrides = {}) {
13
+ const disconnect = vi.fn();
14
+ vi.mocked(LauncherService).mockImplementation(function () {
15
+ return {
16
+ connect: vi.fn().mockResolvedValue(undefined),
17
+ disconnect,
18
+ listAccounts: vi.fn().mockResolvedValue([]),
19
+ ...overrides,
20
+ };
21
+ });
22
+ return { disconnect };
23
+ }
24
+ describe("registerListAccounts", () => {
25
+ beforeEach(() => {
26
+ vi.clearAllMocks();
27
+ });
28
+ afterEach(() => {
29
+ vi.restoreAllMocks();
30
+ });
31
+ it("registers a tool named list-accounts", () => {
32
+ const { server } = createMockServer();
33
+ registerListAccounts(server);
34
+ expect(server.tool).toHaveBeenCalledOnce();
35
+ expect(server.tool).toHaveBeenCalledWith("list-accounts", expect.any(String), expect.any(Object), expect.any(Function));
36
+ });
37
+ it("returns accounts as JSON", async () => {
38
+ const { server, getHandler } = createMockServer();
39
+ registerListAccounts(server);
40
+ const accounts = [
41
+ { id: 1, liId: 100, name: "Alice" },
42
+ { id: 2, liId: 200, name: "Bob", email: "bob@example.com" },
43
+ ];
44
+ mockLauncher({
45
+ listAccounts: vi.fn().mockResolvedValue(accounts),
46
+ });
47
+ const handler = getHandler("list-accounts");
48
+ const result = (await handler({ cdpPort: 9222 }));
49
+ expect(JSON.parse(result.content[0].text)).toEqual(accounts);
50
+ });
51
+ it("returns empty array when no accounts", async () => {
52
+ const { server, getHandler } = createMockServer();
53
+ registerListAccounts(server);
54
+ mockLauncher({ listAccounts: vi.fn().mockResolvedValue([]) });
55
+ const handler = getHandler("list-accounts");
56
+ const result = (await handler({ cdpPort: 9222 }));
57
+ expect(JSON.parse(result.content[0].text)).toEqual([]);
58
+ });
59
+ it("returns error when LinkedHelper not running", async () => {
60
+ const { server, getHandler } = createMockServer();
61
+ registerListAccounts(server);
62
+ vi.mocked(LauncherService).mockImplementation(function () {
63
+ return {
64
+ connect: vi
65
+ .fn()
66
+ .mockRejectedValue(new LinkedHelperNotRunningError(9222)),
67
+ disconnect: vi.fn(),
68
+ };
69
+ });
70
+ const handler = getHandler("list-accounts");
71
+ const result = await handler({ cdpPort: 9222 });
72
+ expect(result).toEqual({
73
+ isError: true,
74
+ content: [
75
+ {
76
+ type: "text",
77
+ text: "LinkedHelper is not running. Use launch-app first.",
78
+ },
79
+ ],
80
+ });
81
+ });
82
+ it("disconnects after successful call", async () => {
83
+ const { server, getHandler } = createMockServer();
84
+ registerListAccounts(server);
85
+ const { disconnect } = mockLauncher();
86
+ const handler = getHandler("list-accounts");
87
+ await handler({ cdpPort: 9222 });
88
+ expect(disconnect).toHaveBeenCalledOnce();
89
+ });
90
+ it("passes cdpPort to LauncherService", async () => {
91
+ const { server, getHandler } = createMockServer();
92
+ registerListAccounts(server);
93
+ mockLauncher();
94
+ const handler = getHandler("list-accounts");
95
+ await handler({ cdpPort: 4567 });
96
+ expect(LauncherService).toHaveBeenCalledWith(4567);
97
+ });
98
+ });
99
+ //# sourceMappingURL=list-accounts.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"list-accounts.test.js","sourceRoot":"","sources":["../../src/tools/list-accounts.test.ts"],"names":[],"mappings":"AAAA,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,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE;KACzB,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,OAAO,EAEL,eAAe,EACf,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,SAAS,YAAY,CAAC,YAAsC,EAAE;IAC5D,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;IAC3B,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,kBAAkB,CAAC;QAC5C,OAAO;YACL,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;YAC7C,UAAU;YACV,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC3C,GAAG,SAAS;SACiB,CAAC;IAClC,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC;AAED,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,0BAA0B,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,MAAM,QAAQ,GAAc;YAC1B,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE;YACnC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE;SAC5D,CAAC;QAEF,YAAY,CAAC;YACX,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC;SAClD,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAE/C,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/D,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,YAAY,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAE9D,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAE/C,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,kBAAkB,CAAC;YAC5C,OAAO;gBACL,OAAO,EAAE,EAAE;qBACR,EAAE,EAAE;qBACJ,iBAAiB,CAAC,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC;gBAC3D,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;aACU,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,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;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,oDAAoD;iBAC3D;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,MAAM,EAAE,UAAU,EAAE,GAAG,YAAY,EAAE,CAAC;QAEtC,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEjC,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAE7B,YAAY,EAAE,CAAC;QAEf,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEjC,MAAM,CAAC,eAAe,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ export declare function registerQuitApp(server: McpServer): void;
3
+ //# sourceMappingURL=quit-app.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"quit-app.d.ts","sourceRoot":"","sources":["../../src/tools/quit-app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkCvD"}
@@ -0,0 +1,31 @@
1
+ import { AppService } from "@lhremote/core";
2
+ import { z } from "zod";
3
+ export function registerQuitApp(server) {
4
+ server.tool("quit-app", "Quit the LinkedHelper application", {
5
+ cdpPort: z
6
+ .number()
7
+ .int()
8
+ .positive()
9
+ .optional()
10
+ .default(9222)
11
+ .describe("CDP port (default: 9222)"),
12
+ }, async ({ cdpPort }) => {
13
+ const app = new AppService(cdpPort);
14
+ try {
15
+ await app.quit();
16
+ }
17
+ catch (error) {
18
+ const message = error instanceof Error ? error.message : String(error);
19
+ return {
20
+ isError: true,
21
+ content: [
22
+ { type: "text", text: `Failed to quit LinkedHelper: ${message}` },
23
+ ],
24
+ };
25
+ }
26
+ return {
27
+ content: [{ type: "text", text: "LinkedHelper quit successfully" }],
28
+ };
29
+ });
30
+ }
31
+ //# sourceMappingURL=quit-app.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"quit-app.js","sourceRoot":"","sources":["../../src/tools/quit-app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,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,IAAI,CAAC;aACb,QAAQ,CAAC,0BAA0B,CAAC;KACxC,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,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gCAAgC,OAAO,EAAE,EAAE;iBAClE;aACF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gCAAgC,EAAE,CAAC;SACpE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=quit-app.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"quit-app.test.d.ts","sourceRoot":"","sources":["../../src/tools/quit-app.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,65 @@
1
+ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
2
+ vi.mock("@lhremote/core", async (importOriginal) => {
3
+ const actual = await importOriginal();
4
+ return {
5
+ ...actual,
6
+ AppService: vi.fn(),
7
+ };
8
+ });
9
+ import { AppService } from "@lhremote/core";
10
+ import { registerQuitApp } from "./quit-app.js";
11
+ import { createMockServer } from "./testing/mock-server.js";
12
+ describe("registerQuitApp", () => {
13
+ beforeEach(() => {
14
+ vi.clearAllMocks();
15
+ });
16
+ afterEach(() => {
17
+ vi.restoreAllMocks();
18
+ });
19
+ it("registers a tool named quit-app", () => {
20
+ const { server } = createMockServer();
21
+ registerQuitApp(server);
22
+ expect(server.tool).toHaveBeenCalledOnce();
23
+ expect(server.tool).toHaveBeenCalledWith("quit-app", expect.any(String), expect.any(Object), expect.any(Function));
24
+ });
25
+ it("returns success on successful quit", async () => {
26
+ const { server, getHandler } = createMockServer();
27
+ registerQuitApp(server);
28
+ vi.mocked(AppService).mockImplementation(function () {
29
+ return { quit: vi.fn().mockResolvedValue(undefined) };
30
+ });
31
+ const handler = getHandler("quit-app");
32
+ const result = await handler({ cdpPort: 9222 });
33
+ expect(result).toEqual({
34
+ content: [{ type: "text", text: "LinkedHelper quit successfully" }],
35
+ });
36
+ });
37
+ it("passes cdpPort to AppService constructor", async () => {
38
+ const { server, getHandler } = createMockServer();
39
+ registerQuitApp(server);
40
+ vi.mocked(AppService).mockImplementation(function () {
41
+ return { quit: vi.fn().mockResolvedValue(undefined) };
42
+ });
43
+ const handler = getHandler("quit-app");
44
+ await handler({ cdpPort: 4567 });
45
+ expect(AppService).toHaveBeenCalledWith(4567);
46
+ });
47
+ it("returns error response on failure", async () => {
48
+ const { server, getHandler } = createMockServer();
49
+ registerQuitApp(server);
50
+ vi.mocked(AppService).mockImplementation(function () {
51
+ return {
52
+ quit: vi.fn().mockRejectedValue(new Error("SIGTERM failed")),
53
+ };
54
+ });
55
+ const handler = getHandler("quit-app");
56
+ const result = await handler({ cdpPort: 9222 });
57
+ expect(result).toEqual({
58
+ isError: true,
59
+ content: [
60
+ { type: "text", text: "Failed to quit LinkedHelper: SIGTERM failed" },
61
+ ],
62
+ });
63
+ });
64
+ });
65
+ //# sourceMappingURL=quit-app.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"quit-app.test.js","sourceRoot":"","sources":["../../src/tools/quit-app.test.ts"],"names":[],"mappings":"AAAA,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,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;KACpB,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,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,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;QACtC,eAAe,CAAC,MAAM,CAAC,CAAC;QAExB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,CACtC,UAAU,EACV,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,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,eAAe,CAAC,MAAM,CAAC,CAAC;QAExB,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,kBAAkB,CAAC;YACvC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAA2B,CAAC;QACjF,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gCAAgC,EAAE,CAAC;SACpE,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,eAAe,CAAC,MAAM,CAAC,CAAC;QAExB,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,kBAAkB,CAAC;YACvC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAA2B,CAAC;QACjF,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;QACvC,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEjC,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,eAAe,CAAC,MAAM,CAAC,CAAC;QAExB,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,kBAAkB,CAAC;YACvC,OAAO;gBACL,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;aACpC,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;QACvC,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;gBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,6CAA6C,EAAE;aACtE;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ export declare function registerStartInstance(server: McpServer): void;
3
+ //# sourceMappingURL=start-instance.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"start-instance.d.ts","sourceRoot":"","sources":["../../src/tools/start-instance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiI7D"}
@@ -0,0 +1,115 @@
1
+ import { LauncherService, LinkedHelperNotRunningError, startInstanceWithRecovery, } from "@lhremote/core";
2
+ import { z } from "zod";
3
+ export function registerStartInstance(server) {
4
+ server.tool("start-instance", "Start a LinkedHelper instance for a LinkedIn account. Required before visit-and-extract.", {
5
+ accountId: z
6
+ .number()
7
+ .int()
8
+ .positive()
9
+ .optional()
10
+ .describe("Account ID (omit to auto-select if single account)"),
11
+ cdpPort: z
12
+ .number()
13
+ .int()
14
+ .positive()
15
+ .optional()
16
+ .default(9222)
17
+ .describe("CDP port (default: 9222)"),
18
+ }, async ({ accountId, cdpPort }) => {
19
+ const launcher = new LauncherService(cdpPort);
20
+ try {
21
+ await launcher.connect();
22
+ }
23
+ catch (error) {
24
+ if (error instanceof LinkedHelperNotRunningError) {
25
+ return {
26
+ isError: true,
27
+ content: [
28
+ {
29
+ type: "text",
30
+ text: "LinkedHelper is not running. Use launch-app first.",
31
+ },
32
+ ],
33
+ };
34
+ }
35
+ const message = error instanceof Error ? error.message : String(error);
36
+ return {
37
+ isError: true,
38
+ content: [
39
+ {
40
+ type: "text",
41
+ text: `Failed to connect to LinkedHelper: ${message}`,
42
+ },
43
+ ],
44
+ };
45
+ }
46
+ try {
47
+ let resolvedId = accountId;
48
+ if (resolvedId === undefined) {
49
+ const accounts = await launcher.listAccounts();
50
+ if (accounts.length === 0) {
51
+ return {
52
+ isError: true,
53
+ content: [
54
+ {
55
+ type: "text",
56
+ text: "No accounts found.",
57
+ },
58
+ ],
59
+ };
60
+ }
61
+ if (accounts.length > 1) {
62
+ return {
63
+ isError: true,
64
+ content: [
65
+ {
66
+ type: "text",
67
+ text: "Multiple accounts found. Specify accountId. Use list-accounts to see available accounts.",
68
+ },
69
+ ],
70
+ };
71
+ }
72
+ resolvedId = accounts[0].id;
73
+ }
74
+ const outcome = await startInstanceWithRecovery(launcher, resolvedId, cdpPort);
75
+ if (outcome.status === "timeout") {
76
+ return {
77
+ isError: true,
78
+ content: [
79
+ {
80
+ type: "text",
81
+ text: `Instance started but failed to initialize within timeout.`,
82
+ },
83
+ ],
84
+ };
85
+ }
86
+ const verb = outcome.status === "already_running"
87
+ ? "already running"
88
+ : "started";
89
+ return {
90
+ content: [
91
+ {
92
+ type: "text",
93
+ text: `Instance ${verb} for account ${String(resolvedId)} on CDP port ${String(outcome.port)}`,
94
+ },
95
+ ],
96
+ };
97
+ }
98
+ catch (error) {
99
+ const message = error instanceof Error ? error.message : String(error);
100
+ return {
101
+ isError: true,
102
+ content: [
103
+ {
104
+ type: "text",
105
+ text: `Failed to start instance: ${message}`,
106
+ },
107
+ ],
108
+ };
109
+ }
110
+ finally {
111
+ launcher.disconnect();
112
+ }
113
+ });
114
+ }
115
+ //# sourceMappingURL=start-instance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"start-instance.js","sourceRoot":"","sources":["../../src/tools/start-instance.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=start-instance.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"start-instance.test.d.ts","sourceRoot":"","sources":["../../src/tools/start-instance.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,232 @@
1
+ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
2
+ vi.mock("@lhremote/core", async (importOriginal) => {
3
+ const actual = await importOriginal();
4
+ return {
5
+ ...actual,
6
+ LauncherService: vi.fn(),
7
+ startInstanceWithRecovery: vi.fn(),
8
+ };
9
+ });
10
+ import { LauncherService, LinkedHelperNotRunningError, startInstanceWithRecovery, } from "@lhremote/core";
11
+ import { registerStartInstance } from "./start-instance.js";
12
+ import { createMockServer } from "./testing/mock-server.js";
13
+ function mockLauncher(overrides = {}) {
14
+ const disconnect = vi.fn();
15
+ vi.mocked(LauncherService).mockImplementation(function () {
16
+ return {
17
+ connect: vi.fn().mockResolvedValue(undefined),
18
+ disconnect,
19
+ listAccounts: vi.fn().mockResolvedValue([]),
20
+ startInstance: vi.fn().mockResolvedValue(undefined),
21
+ stopInstance: vi.fn().mockResolvedValue(undefined),
22
+ ...overrides,
23
+ };
24
+ });
25
+ return { disconnect };
26
+ }
27
+ describe("registerStartInstance", () => {
28
+ beforeEach(() => {
29
+ vi.clearAllMocks();
30
+ });
31
+ afterEach(() => {
32
+ vi.restoreAllMocks();
33
+ });
34
+ it("registers a tool named start-instance", () => {
35
+ const { server } = createMockServer();
36
+ registerStartInstance(server);
37
+ expect(server.tool).toHaveBeenCalledOnce();
38
+ expect(server.tool).toHaveBeenCalledWith("start-instance", expect.any(String), expect.any(Object), expect.any(Function));
39
+ });
40
+ it("returns success with account and port", async () => {
41
+ const { server, getHandler } = createMockServer();
42
+ registerStartInstance(server);
43
+ mockLauncher();
44
+ vi.mocked(startInstanceWithRecovery).mockResolvedValue({
45
+ status: "started",
46
+ port: 55123,
47
+ });
48
+ const handler = getHandler("start-instance");
49
+ const result = await handler({ accountId: 42, cdpPort: 9222 });
50
+ expect(result).toEqual({
51
+ content: [
52
+ {
53
+ type: "text",
54
+ text: "Instance started for account 42 on CDP port 55123",
55
+ },
56
+ ],
57
+ });
58
+ });
59
+ it("auto-selects single account when accountId omitted", async () => {
60
+ const { server, getHandler } = createMockServer();
61
+ registerStartInstance(server);
62
+ const accounts = [
63
+ { id: 42, liId: 42, name: "Alice" },
64
+ ];
65
+ mockLauncher({
66
+ listAccounts: vi.fn().mockResolvedValue(accounts),
67
+ });
68
+ vi.mocked(startInstanceWithRecovery).mockResolvedValue({
69
+ status: "started",
70
+ port: 55123,
71
+ });
72
+ const handler = getHandler("start-instance");
73
+ const result = await handler({ cdpPort: 9222 });
74
+ expect(startInstanceWithRecovery).toHaveBeenCalledWith(expect.anything(), 42, 9222);
75
+ expect(result).toEqual({
76
+ content: [
77
+ {
78
+ type: "text",
79
+ text: "Instance started for account 42 on CDP port 55123",
80
+ },
81
+ ],
82
+ });
83
+ });
84
+ it("returns error when no accounts and accountId omitted", async () => {
85
+ const { server, getHandler } = createMockServer();
86
+ registerStartInstance(server);
87
+ mockLauncher({
88
+ listAccounts: vi.fn().mockResolvedValue([]),
89
+ });
90
+ const handler = getHandler("start-instance");
91
+ const result = await handler({ cdpPort: 9222 });
92
+ expect(result).toEqual({
93
+ isError: true,
94
+ content: [{ type: "text", text: "No accounts found." }],
95
+ });
96
+ });
97
+ it("returns error when multiple accounts and accountId omitted", async () => {
98
+ const { server, getHandler } = createMockServer();
99
+ registerStartInstance(server);
100
+ const accounts = [
101
+ { id: 1, liId: 1, name: "Alice" },
102
+ { id: 2, liId: 2, name: "Bob" },
103
+ ];
104
+ mockLauncher({
105
+ listAccounts: vi.fn().mockResolvedValue(accounts),
106
+ });
107
+ const handler = getHandler("start-instance");
108
+ const result = await handler({ cdpPort: 9222 });
109
+ expect(result).toEqual({
110
+ isError: true,
111
+ content: [
112
+ {
113
+ type: "text",
114
+ text: "Multiple accounts found. Specify accountId. Use list-accounts to see available accounts.",
115
+ },
116
+ ],
117
+ });
118
+ });
119
+ it("returns error when LinkedHelper not running", async () => {
120
+ const { server, getHandler } = createMockServer();
121
+ registerStartInstance(server);
122
+ vi.mocked(LauncherService).mockImplementation(function () {
123
+ return {
124
+ connect: vi
125
+ .fn()
126
+ .mockRejectedValue(new LinkedHelperNotRunningError(9222)),
127
+ disconnect: vi.fn(),
128
+ };
129
+ });
130
+ const handler = getHandler("start-instance");
131
+ const result = await handler({ accountId: 42, cdpPort: 9222 });
132
+ expect(result).toEqual({
133
+ isError: true,
134
+ content: [
135
+ {
136
+ type: "text",
137
+ text: "LinkedHelper is not running. Use launch-app first.",
138
+ },
139
+ ],
140
+ });
141
+ });
142
+ it("treats 'already running' as idempotent success when port is discoverable", async () => {
143
+ const { server, getHandler } = createMockServer();
144
+ registerStartInstance(server);
145
+ mockLauncher();
146
+ vi.mocked(startInstanceWithRecovery).mockResolvedValue({
147
+ status: "already_running",
148
+ port: 55123,
149
+ });
150
+ const handler = getHandler("start-instance");
151
+ const result = await handler({ accountId: 42, cdpPort: 9222 });
152
+ expect(result).toEqual({
153
+ content: [
154
+ {
155
+ type: "text",
156
+ text: "Instance already running for account 42 on CDP port 55123",
157
+ },
158
+ ],
159
+ });
160
+ });
161
+ it("returns error when instance fails to initialize within timeout", async () => {
162
+ const { server, getHandler } = createMockServer();
163
+ registerStartInstance(server);
164
+ mockLauncher();
165
+ vi.mocked(startInstanceWithRecovery).mockResolvedValue({
166
+ status: "timeout",
167
+ });
168
+ const handler = getHandler("start-instance");
169
+ const result = await handler({ accountId: 42, cdpPort: 9222 });
170
+ expect(result).toEqual({
171
+ isError: true,
172
+ content: [
173
+ {
174
+ type: "text",
175
+ text: "Instance started but failed to initialize within timeout.",
176
+ },
177
+ ],
178
+ });
179
+ });
180
+ it("returns error on unexpected error", async () => {
181
+ const { server, getHandler } = createMockServer();
182
+ registerStartInstance(server);
183
+ mockLauncher();
184
+ vi.mocked(startInstanceWithRecovery).mockRejectedValue(new Error("unexpected failure"));
185
+ const handler = getHandler("start-instance");
186
+ const result = await handler({ accountId: 42, cdpPort: 9222 });
187
+ expect(result).toEqual({
188
+ isError: true,
189
+ content: [
190
+ {
191
+ type: "text",
192
+ text: "Failed to start instance: unexpected failure",
193
+ },
194
+ ],
195
+ });
196
+ });
197
+ it("passes cdpPort to LauncherService", async () => {
198
+ const { server, getHandler } = createMockServer();
199
+ registerStartInstance(server);
200
+ mockLauncher();
201
+ vi.mocked(startInstanceWithRecovery).mockResolvedValue({
202
+ status: "started",
203
+ port: 55123,
204
+ });
205
+ const handler = getHandler("start-instance");
206
+ await handler({ accountId: 42, cdpPort: 4567 });
207
+ expect(LauncherService).toHaveBeenCalledWith(4567);
208
+ });
209
+ it("disconnects after successful call", async () => {
210
+ const { server, getHandler } = createMockServer();
211
+ registerStartInstance(server);
212
+ const { disconnect } = mockLauncher();
213
+ vi.mocked(startInstanceWithRecovery).mockResolvedValue({
214
+ status: "started",
215
+ port: 55123,
216
+ });
217
+ const handler = getHandler("start-instance");
218
+ await handler({ accountId: 42, cdpPort: 9222 });
219
+ expect(disconnect).toHaveBeenCalledOnce();
220
+ });
221
+ it("disconnects after error", async () => {
222
+ const { server, getHandler } = createMockServer();
223
+ registerStartInstance(server);
224
+ const { disconnect } = mockLauncher({
225
+ listAccounts: vi.fn().mockResolvedValue([]),
226
+ });
227
+ const handler = getHandler("start-instance");
228
+ await handler({ cdpPort: 9222 });
229
+ expect(disconnect).toHaveBeenCalledOnce();
230
+ });
231
+ });
232
+ //# sourceMappingURL=start-instance.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"start-instance.test.js","sourceRoot":"","sources":["../../src/tools/start-instance.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ export declare function registerStopInstance(server: McpServer): void;
3
+ //# sourceMappingURL=stop-instance.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stop-instance.d.ts","sourceRoot":"","sources":["../../src/tools/stop-instance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4G5D"}