openchrome-mcp 1.7.16 → 1.8.4

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 (169) hide show
  1. package/dist/cdp/client.d.ts +36 -1
  2. package/dist/cdp/client.d.ts.map +1 -1
  3. package/dist/cdp/client.js +212 -8
  4. package/dist/cdp/client.js.map +1 -1
  5. package/dist/cdp/tab-health-monitor.d.ts +63 -0
  6. package/dist/cdp/tab-health-monitor.d.ts.map +1 -0
  7. package/dist/cdp/tab-health-monitor.js +131 -0
  8. package/dist/cdp/tab-health-monitor.js.map +1 -0
  9. package/dist/chrome/launcher.d.ts +11 -0
  10. package/dist/chrome/launcher.d.ts.map +1 -1
  11. package/dist/chrome/launcher.js +17 -0
  12. package/dist/chrome/launcher.js.map +1 -1
  13. package/dist/chrome/pool.d.ts +17 -0
  14. package/dist/chrome/pool.d.ts.map +1 -1
  15. package/dist/chrome/pool.js +85 -2
  16. package/dist/chrome/pool.js.map +1 -1
  17. package/dist/chrome/process-watchdog.d.ts +63 -0
  18. package/dist/chrome/process-watchdog.d.ts.map +1 -0
  19. package/dist/chrome/process-watchdog.js +121 -0
  20. package/dist/chrome/process-watchdog.js.map +1 -0
  21. package/dist/cli/index.js +0 -0
  22. package/dist/config/defaults.d.ts +59 -0
  23. package/dist/config/defaults.d.ts.map +1 -1
  24. package/dist/config/defaults.js +62 -1
  25. package/dist/config/defaults.js.map +1 -1
  26. package/dist/config/tool-tiers.d.ts.map +1 -1
  27. package/dist/config/tool-tiers.js +3 -0
  28. package/dist/config/tool-tiers.js.map +1 -1
  29. package/dist/dom/dom-serializer.js +1 -1
  30. package/dist/dom/dom-serializer.js.map +1 -1
  31. package/dist/index.js +111 -0
  32. package/dist/index.js.map +1 -1
  33. package/dist/journal/task-journal.d.ts +79 -0
  34. package/dist/journal/task-journal.d.ts.map +1 -0
  35. package/dist/journal/task-journal.js +246 -0
  36. package/dist/journal/task-journal.js.map +1 -0
  37. package/dist/mcp-server.d.ts +3 -0
  38. package/dist/mcp-server.d.ts.map +1 -1
  39. package/dist/mcp-server.js +129 -7
  40. package/dist/mcp-server.js.map +1 -1
  41. package/dist/self-healing.d.ts +14 -0
  42. package/dist/self-healing.d.ts.map +1 -0
  43. package/dist/self-healing.js +17 -0
  44. package/dist/self-healing.js.map +1 -0
  45. package/dist/session-manager.d.ts +14 -3
  46. package/dist/session-manager.d.ts.map +1 -1
  47. package/dist/session-manager.js +98 -27
  48. package/dist/session-manager.js.map +1 -1
  49. package/dist/session-state-persistence.d.ts +92 -0
  50. package/dist/session-state-persistence.d.ts.map +1 -0
  51. package/dist/session-state-persistence.js +206 -0
  52. package/dist/session-state-persistence.js.map +1 -0
  53. package/dist/storage-state/storage-state-manager.d.ts +1 -1
  54. package/dist/storage-state/storage-state-manager.d.ts.map +1 -1
  55. package/dist/storage-state/storage-state-manager.js +40 -16
  56. package/dist/storage-state/storage-state-manager.js.map +1 -1
  57. package/dist/tools/click-element.d.ts.map +1 -1
  58. package/dist/tools/click-element.js +59 -2
  59. package/dist/tools/click-element.js.map +1 -1
  60. package/dist/tools/find.d.ts.map +1 -1
  61. package/dist/tools/find.js +27 -0
  62. package/dist/tools/find.js.map +1 -1
  63. package/dist/tools/index.d.ts.map +1 -1
  64. package/dist/tools/index.js +8 -0
  65. package/dist/tools/index.js.map +1 -1
  66. package/dist/tools/interact.d.ts.map +1 -1
  67. package/dist/tools/interact.js +93 -2
  68. package/dist/tools/interact.js.map +1 -1
  69. package/dist/tools/journal.d.ts +8 -0
  70. package/dist/tools/journal.d.ts.map +1 -0
  71. package/dist/tools/journal.js +112 -0
  72. package/dist/tools/journal.js.map +1 -0
  73. package/dist/tools/list-profiles.d.ts.map +1 -1
  74. package/dist/tools/list-profiles.js +2 -1
  75. package/dist/tools/list-profiles.js.map +1 -1
  76. package/dist/tools/navigate.d.ts.map +1 -1
  77. package/dist/tools/navigate.js +42 -7
  78. package/dist/tools/navigate.js.map +1 -1
  79. package/dist/tools/profile-status.d.ts.map +1 -1
  80. package/dist/tools/profile-status.js +18 -0
  81. package/dist/tools/profile-status.js.map +1 -1
  82. package/dist/tools/session-resume.d.ts +42 -0
  83. package/dist/tools/session-resume.d.ts.map +1 -0
  84. package/dist/tools/session-resume.js +248 -0
  85. package/dist/tools/session-resume.js.map +1 -0
  86. package/dist/tools/session-snapshot.d.ts +35 -0
  87. package/dist/tools/session-snapshot.d.ts.map +1 -0
  88. package/dist/tools/session-snapshot.js +232 -0
  89. package/dist/tools/session-snapshot.js.map +1 -0
  90. package/dist/tools/tabs-create.d.ts.map +1 -1
  91. package/dist/tools/tabs-create.js +13 -2
  92. package/dist/tools/tabs-create.js.map +1 -1
  93. package/dist/tools/wait-and-click.d.ts.map +1 -1
  94. package/dist/tools/wait-and-click.js +47 -4
  95. package/dist/tools/wait-and-click.js.map +1 -1
  96. package/dist/types/session.d.ts +2 -0
  97. package/dist/types/session.d.ts.map +1 -1
  98. package/dist/utils/ax-element-resolver.d.ts +96 -0
  99. package/dist/utils/ax-element-resolver.d.ts.map +1 -0
  100. package/dist/utils/ax-element-resolver.js +256 -0
  101. package/dist/utils/ax-element-resolver.js.map +1 -0
  102. package/dist/utils/element-discovery.d.ts.map +1 -1
  103. package/dist/utils/element-discovery.js +4 -0
  104. package/dist/utils/element-discovery.js.map +1 -1
  105. package/dist/utils/ralph/circuit-breaker.d.ts +99 -0
  106. package/dist/utils/ralph/circuit-breaker.d.ts.map +1 -0
  107. package/dist/utils/ralph/circuit-breaker.js +234 -0
  108. package/dist/utils/ralph/circuit-breaker.js.map +1 -0
  109. package/dist/utils/ralph/hitl-escalation.d.ts +51 -0
  110. package/dist/utils/ralph/hitl-escalation.d.ts.map +1 -0
  111. package/dist/utils/ralph/hitl-escalation.js +114 -0
  112. package/dist/utils/ralph/hitl-escalation.js.map +1 -0
  113. package/dist/utils/ralph/outcome-classifier.d.ts +44 -0
  114. package/dist/utils/ralph/outcome-classifier.d.ts.map +1 -0
  115. package/dist/utils/ralph/outcome-classifier.js +123 -0
  116. package/dist/utils/ralph/outcome-classifier.js.map +1 -0
  117. package/dist/utils/ralph/ralph-engine.d.ts +50 -0
  118. package/dist/utils/ralph/ralph-engine.d.ts.map +1 -0
  119. package/dist/utils/ralph/ralph-engine.js +341 -0
  120. package/dist/utils/ralph/ralph-engine.js.map +1 -0
  121. package/dist/utils/ralph/strategy-learner.d.ts +40 -0
  122. package/dist/utils/ralph/strategy-learner.d.ts.map +1 -0
  123. package/dist/utils/ralph/strategy-learner.js +80 -0
  124. package/dist/utils/ralph/strategy-learner.js.map +1 -0
  125. package/dist/utils/ralph/timeout-budget.d.ts +43 -0
  126. package/dist/utils/ralph/timeout-budget.d.ts.map +1 -0
  127. package/dist/utils/ralph/timeout-budget.js +80 -0
  128. package/dist/utils/ralph/timeout-budget.js.map +1 -0
  129. package/dist/watchdog/event-loop-monitor.d.ts +58 -0
  130. package/dist/watchdog/event-loop-monitor.d.ts.map +1 -0
  131. package/dist/watchdog/event-loop-monitor.js +85 -0
  132. package/dist/watchdog/event-loop-monitor.js.map +1 -0
  133. package/dist/watchdog/health-endpoint.d.ts +44 -0
  134. package/dist/watchdog/health-endpoint.d.ts.map +1 -0
  135. package/dist/watchdog/health-endpoint.js +119 -0
  136. package/dist/watchdog/health-endpoint.js.map +1 -0
  137. package/package.json +3 -2
  138. package/dist/chrome/sqlite-cookie-copy.d.ts +0 -46
  139. package/dist/chrome/sqlite-cookie-copy.d.ts.map +0 -1
  140. package/dist/chrome/sqlite-cookie-copy.js +0 -151
  141. package/dist/chrome/sqlite-cookie-copy.js.map +0 -1
  142. package/dist/config/config-recovery.d.ts +0 -69
  143. package/dist/config/config-recovery.d.ts.map +0 -1
  144. package/dist/config/config-recovery.js +0 -302
  145. package/dist/config/config-recovery.js.map +0 -1
  146. package/dist/config/session-isolator.d.ts +0 -76
  147. package/dist/config/session-isolator.d.ts.map +0 -1
  148. package/dist/config/session-isolator.js +0 -268
  149. package/dist/config/session-isolator.js.map +0 -1
  150. package/dist/tools/selector-query.d.ts +0 -6
  151. package/dist/tools/selector-query.d.ts.map +0 -1
  152. package/dist/tools/selector-query.js +0 -214
  153. package/dist/tools/selector-query.js.map +0 -1
  154. package/dist/tools/worker-create.d.ts +0 -7
  155. package/dist/tools/worker-create.d.ts.map +0 -1
  156. package/dist/tools/worker-create.js +0 -62
  157. package/dist/tools/worker-create.js.map +0 -1
  158. package/dist/tools/worker-delete.d.ts +0 -6
  159. package/dist/tools/worker-delete.d.ts.map +0 -1
  160. package/dist/tools/worker-delete.js +0 -80
  161. package/dist/tools/worker-delete.js.map +0 -1
  162. package/dist/tools/worker-list.d.ts +0 -6
  163. package/dist/tools/worker-list.d.ts.map +0 -1
  164. package/dist/tools/worker-list.js +0 -67
  165. package/dist/tools/worker-list.js.map +0 -1
  166. package/dist/tools/xpath-query.d.ts +0 -6
  167. package/dist/tools/xpath-query.d.ts.map +0 -1
  168. package/dist/tools/xpath-query.js +0 -225
  169. package/dist/tools/xpath-query.js.map +0 -1
@@ -1,80 +0,0 @@
1
- "use strict";
2
- /**
3
- * Worker Delete Tool - Delete a worker and close all its tabs
4
- */
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.registerWorkerDeleteTool = registerWorkerDeleteTool;
7
- const session_manager_1 = require("../session-manager");
8
- const definition = {
9
- name: 'worker_delete',
10
- description: 'Deletes a worker and closes all its tabs. Cannot delete the default worker.',
11
- inputSchema: {
12
- type: 'object',
13
- properties: {
14
- workerId: {
15
- type: 'string',
16
- description: 'The ID of the worker to delete',
17
- },
18
- },
19
- required: ['workerId'],
20
- },
21
- };
22
- const handler = async (sessionId, args) => {
23
- const sessionManager = (0, session_manager_1.getSessionManager)();
24
- const workerId = args.workerId;
25
- if (!workerId) {
26
- return {
27
- content: [
28
- {
29
- type: 'text',
30
- text: 'Error: workerId is required',
31
- },
32
- ],
33
- isError: true,
34
- };
35
- }
36
- try {
37
- const worker = sessionManager.getWorker(sessionId, workerId);
38
- if (!worker) {
39
- return {
40
- content: [
41
- {
42
- type: 'text',
43
- text: `Error: Worker ${workerId} not found`,
44
- },
45
- ],
46
- isError: true,
47
- };
48
- }
49
- const tabCount = worker.targets.size;
50
- await sessionManager.deleteWorker(sessionId, workerId);
51
- return {
52
- content: [
53
- {
54
- type: 'text',
55
- text: JSON.stringify({
56
- deleted: true,
57
- workerId,
58
- closedTabs: tabCount,
59
- message: `Worker "${workerId}" deleted with ${tabCount} tab(s) closed`,
60
- }, null, 2),
61
- },
62
- ],
63
- };
64
- }
65
- catch (error) {
66
- return {
67
- content: [
68
- {
69
- type: 'text',
70
- text: `Error deleting worker: ${error instanceof Error ? error.message : String(error)}`,
71
- },
72
- ],
73
- isError: true,
74
- };
75
- }
76
- };
77
- function registerWorkerDeleteTool(server) {
78
- server.registerTool('worker_delete', handler, definition);
79
- }
80
- //# sourceMappingURL=worker-delete.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"worker-delete.js","sourceRoot":"","sources":["../../src/tools/worker-delete.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAuFH,4DAEC;AArFD,wDAAuD;AAEvD,MAAM,UAAU,GAAsB;IACpC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,6EAA6E;IAC1F,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gCAAgC;aAC9C;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB;CACF,CAAC;AAEF,MAAM,OAAO,GAAgB,KAAK,EAChC,SAAiB,EACjB,IAA6B,EACT,EAAE;IACtB,MAAM,cAAc,GAAG,IAAA,mCAAiB,GAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAkB,CAAC;IAEzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,6BAA6B;iBACpC;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,iBAAiB,QAAQ,YAAY;qBAC5C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;QACrC,MAAM,cAAc,CAAC,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEvD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,OAAO,EAAE,IAAI;wBACb,QAAQ;wBACR,UAAU,EAAE,QAAQ;wBACpB,OAAO,EAAE,WAAW,QAAQ,kBAAkB,QAAQ,gBAAgB;qBACvE,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBACzF;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,SAAgB,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAC5D,CAAC"}
@@ -1,6 +0,0 @@
1
- /**
2
- * Worker List Tool - List all workers in the current session
3
- */
4
- import { MCPServer } from '../mcp-server';
5
- export declare function registerWorkerListTool(server: MCPServer): void;
6
- //# sourceMappingURL=worker-list.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"worker-list.d.ts","sourceRoot":"","sources":["../../src/tools/worker-list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAwE1C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAE9D"}
@@ -1,67 +0,0 @@
1
- "use strict";
2
- /**
3
- * Worker List Tool - List all workers in the current session
4
- */
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.registerWorkerListTool = registerWorkerListTool;
7
- const session_manager_1 = require("../session-manager");
8
- const definition = {
9
- name: 'worker_list',
10
- description: 'Lists all workers in the current session. Shows worker IDs, names, tab counts, and activity timestamps.',
11
- inputSchema: {
12
- type: 'object',
13
- properties: {},
14
- required: [],
15
- },
16
- };
17
- const handler = async (sessionId, _args) => {
18
- const sessionManager = (0, session_manager_1.getSessionManager)();
19
- try {
20
- const session = sessionManager.getSession(sessionId);
21
- if (!session) {
22
- return {
23
- content: [
24
- {
25
- type: 'text',
26
- text: JSON.stringify({ workers: [], message: 'No session found' }, null, 2),
27
- },
28
- ],
29
- };
30
- }
31
- const workers = sessionManager.getWorkers(sessionId);
32
- const defaultWorkerId = session.defaultWorkerId;
33
- const workerDetails = workers.map((w) => ({
34
- ...w,
35
- isDefault: w.id === defaultWorkerId,
36
- tabs: sessionManager.getWorkerTargetIds(sessionId, w.id),
37
- }));
38
- return {
39
- content: [
40
- {
41
- type: 'text',
42
- text: JSON.stringify({
43
- sessionId,
44
- workerCount: workers.length,
45
- defaultWorkerId,
46
- workers: workerDetails,
47
- }, null, 2),
48
- },
49
- ],
50
- };
51
- }
52
- catch (error) {
53
- return {
54
- content: [
55
- {
56
- type: 'text',
57
- text: `Error listing workers: ${error instanceof Error ? error.message : String(error)}`,
58
- },
59
- ],
60
- isError: true,
61
- };
62
- }
63
- };
64
- function registerWorkerListTool(server) {
65
- server.registerTool('worker_list', handler, definition);
66
- }
67
- //# sourceMappingURL=worker-list.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"worker-list.js","sourceRoot":"","sources":["../../src/tools/worker-list.ts"],"names":[],"mappings":";AAAA;;GAEG;;AA0EH,wDAEC;AAxED,wDAAuD;AAEvD,MAAM,UAAU,GAAsB;IACpC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,yGAAyG;IACtH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;CACF,CAAC;AAEF,MAAM,OAAO,GAAgB,KAAK,EAChC,SAAiB,EACjB,KAA8B,EACV,EAAE;IACtB,MAAM,cAAc,GAAG,IAAA,mCAAiB,GAAE,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC5E;iBACF;aACF,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACrD,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAEhD,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxC,GAAG,CAAC;YACJ,SAAS,EAAE,CAAC,CAAC,EAAE,KAAK,eAAe;YACnC,IAAI,EAAE,cAAc,CAAC,kBAAkB,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,SAAS;wBACT,WAAW,EAAE,OAAO,CAAC,MAAM;wBAC3B,eAAe;wBACf,OAAO,EAAE,aAAa;qBACvB,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBACzF;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,SAAgB,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAC1D,CAAC"}
@@ -1,6 +0,0 @@
1
- /**
2
- * XPath Query Tool - Query elements using XPath expressions
3
- */
4
- import { MCPServer } from '../mcp-server';
5
- export declare function registerXpathQueryTool(server: MCPServer): void;
6
- //# sourceMappingURL=xpath-query.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"xpath-query.d.ts","sourceRoot":"","sources":["../../src/tools/xpath-query.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAmR1C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAE9D"}
@@ -1,225 +0,0 @@
1
- "use strict";
2
- /**
3
- * XPath Query Tool - Query elements using XPath expressions
4
- */
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.registerXpathQueryTool = registerXpathQueryTool;
7
- const session_manager_1 = require("../session-manager");
8
- const definition = {
9
- name: 'xpath_query',
10
- description: `Query elements on the page using XPath expressions. Returns element information including tag, attributes, text, and position.`,
11
- inputSchema: {
12
- type: 'object',
13
- properties: {
14
- tabId: {
15
- type: 'string',
16
- description: 'Tab ID to query',
17
- },
18
- xpath: {
19
- type: 'string',
20
- description: 'XPath expression to evaluate',
21
- },
22
- multiple: {
23
- type: 'boolean',
24
- description: 'Whether to return multiple results (default: false)',
25
- },
26
- limit: {
27
- type: 'number',
28
- description: 'Maximum number of results to return (for multiple: true)',
29
- },
30
- },
31
- required: ['tabId', 'xpath'],
32
- },
33
- };
34
- const handler = async (sessionId, args) => {
35
- const tabId = args.tabId;
36
- const xpath = args.xpath;
37
- const multiple = args.multiple ?? false;
38
- const limit = args.limit ?? 50;
39
- const sessionManager = (0, session_manager_1.getSessionManager)();
40
- if (!tabId) {
41
- return {
42
- content: [{ type: 'text', text: 'Error: tabId is required' }],
43
- isError: true,
44
- };
45
- }
46
- if (!xpath) {
47
- return {
48
- content: [{ type: 'text', text: 'Error: xpath is required' }],
49
- isError: true,
50
- };
51
- }
52
- try {
53
- const page = await sessionManager.getPage(sessionId, tabId, undefined, 'xpath_query');
54
- if (!page) {
55
- return {
56
- content: [{ type: 'text', text: `Error: Tab ${tabId} not found` }],
57
- isError: true,
58
- };
59
- }
60
- if (multiple) {
61
- // Return multiple results
62
- const result = await page.evaluate((xpathExpr, maxResults) => {
63
- function extractElementInfo(element, xpathStr) {
64
- const tagName = element.tagName.toLowerCase();
65
- const id = element.id || undefined;
66
- const classNameAttr = element.getAttribute('class');
67
- const className = classNameAttr || undefined;
68
- const text = element.textContent?.trim().slice(0, 200) || undefined;
69
- const attributes = {};
70
- for (let i = 0; i < element.attributes.length; i++) {
71
- const attr = element.attributes[i];
72
- if (attr.name !== 'id' && attr.name !== 'class') {
73
- attributes[attr.name] = attr.value.slice(0, 100);
74
- }
75
- }
76
- const rect = element.getBoundingClientRect();
77
- return {
78
- tagName,
79
- id,
80
- className,
81
- text,
82
- attributes,
83
- rect: {
84
- x: Math.round(rect.x),
85
- y: Math.round(rect.y),
86
- width: Math.round(rect.width),
87
- height: Math.round(rect.height),
88
- },
89
- xpath: xpathStr,
90
- };
91
- }
92
- const xpathResult = document.evaluate(xpathExpr, document, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null);
93
- const elements = [];
94
- const count = Math.min(xpathResult.snapshotLength, maxResults);
95
- for (let i = 0; i < count; i++) {
96
- const node = xpathResult.snapshotItem(i);
97
- if (node instanceof Element) {
98
- const simpleXpath = `(${xpathExpr})[${i + 1}]`;
99
- elements.push(extractElementInfo(node, simpleXpath));
100
- }
101
- }
102
- return {
103
- elements,
104
- totalCount: xpathResult.snapshotLength,
105
- };
106
- }, xpath, limit);
107
- return {
108
- content: [
109
- {
110
- type: 'text',
111
- text: JSON.stringify({
112
- action: 'xpath_query',
113
- xpath,
114
- multiple: true,
115
- results: result.elements,
116
- count: result.elements.length,
117
- totalCount: result.totalCount,
118
- message: result.elements.length > 0
119
- ? `Found ${result.totalCount} element(s), returned ${result.elements.length}`
120
- : 'No elements found',
121
- }),
122
- },
123
- ],
124
- };
125
- }
126
- else {
127
- // Return single result
128
- const element = await page.evaluate((xpathExpr) => {
129
- function extractElementInfo(el, xpathStr) {
130
- const tagName = el.tagName.toLowerCase();
131
- const id = el.id || undefined;
132
- const classNameAttr = el.getAttribute('class');
133
- const className = classNameAttr || undefined;
134
- const text = el.textContent?.trim().slice(0, 200) || undefined;
135
- const attributes = {};
136
- for (let i = 0; i < el.attributes.length; i++) {
137
- const attr = el.attributes[i];
138
- if (attr.name !== 'id' && attr.name !== 'class') {
139
- attributes[attr.name] = attr.value.slice(0, 100);
140
- }
141
- }
142
- const rect = el.getBoundingClientRect();
143
- return {
144
- tagName,
145
- id,
146
- className,
147
- text,
148
- attributes,
149
- rect: {
150
- x: Math.round(rect.x),
151
- y: Math.round(rect.y),
152
- width: Math.round(rect.width),
153
- height: Math.round(rect.height),
154
- },
155
- xpath: xpathStr,
156
- };
157
- }
158
- const xpathResult = document.evaluate(xpathExpr, document, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null);
159
- const node = xpathResult.singleNodeValue;
160
- if (!node || !(node instanceof Element)) {
161
- return null;
162
- }
163
- return extractElementInfo(node, xpathExpr);
164
- }, xpath);
165
- if (!element) {
166
- return {
167
- content: [
168
- {
169
- type: 'text',
170
- text: JSON.stringify({
171
- action: 'xpath_query',
172
- xpath,
173
- multiple: false,
174
- result: null,
175
- message: 'No element found matching XPath',
176
- }),
177
- },
178
- ],
179
- };
180
- }
181
- return {
182
- content: [
183
- {
184
- type: 'text',
185
- text: JSON.stringify({
186
- action: 'xpath_query',
187
- xpath,
188
- multiple: false,
189
- result: element,
190
- message: `Found element: <${element.tagName}${element.id ? ` id="${element.id}"` : ''}>`,
191
- }),
192
- },
193
- ],
194
- };
195
- }
196
- }
197
- catch (error) {
198
- // Check for XPath syntax errors
199
- const errorMessage = error instanceof Error ? error.message : String(error);
200
- if (errorMessage.includes('XPath') || errorMessage.includes('syntax')) {
201
- return {
202
- content: [
203
- {
204
- type: 'text',
205
- text: `XPath syntax error: ${errorMessage}`,
206
- },
207
- ],
208
- isError: true,
209
- };
210
- }
211
- return {
212
- content: [
213
- {
214
- type: 'text',
215
- text: `XPath query error: ${errorMessage}`,
216
- },
217
- ],
218
- isError: true,
219
- };
220
- }
221
- };
222
- function registerXpathQueryTool(server) {
223
- server.registerTool('xpath_query', handler, definition);
224
- }
225
- //# sourceMappingURL=xpath-query.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"xpath-query.js","sourceRoot":"","sources":["../../src/tools/xpath-query.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAqRH,wDAEC;AAnRD,wDAAuD;AAiBvD,MAAM,UAAU,GAAsB;IACpC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,gIAAgI;IAC7I,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iBAAiB;aAC/B;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;aAC5C;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,qDAAqD;aACnE;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0DAA0D;aACxE;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;KAC7B;CACF,CAAC;AAEF,MAAM,OAAO,GAAgB,KAAK,EAChC,SAAiB,EACjB,IAA6B,EACT,EAAE;IACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;IACnC,MAAM,QAAQ,GAAI,IAAI,CAAC,QAAgC,IAAI,KAAK,CAAC;IACjE,MAAM,KAAK,GAAI,IAAI,CAAC,KAA4B,IAAI,EAAE,CAAC;IAEvD,MAAM,cAAc,GAAG,IAAA,mCAAiB,GAAE,CAAC;IAE3C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC;YAC7D,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC;YAC7D,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QACtF,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,KAAK,YAAY,EAAE,CAAC;gBAClE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,0BAA0B;YAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAChC,CAAC,SAAiB,EAAE,UAAkB,EAAE,EAAE;gBACxC,SAAS,kBAAkB,CAAC,OAAgB,EAAE,QAAgB;oBAC5D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;oBAC9C,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,SAAS,CAAC;oBACnC,MAAM,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;oBACpD,MAAM,SAAS,GAAG,aAAa,IAAI,SAAS,CAAC;oBAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC;oBAEpE,MAAM,UAAU,GAA2B,EAAE,CAAC;oBAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;wBACnD,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;wBACnC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;4BAChD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;wBACnD,CAAC;oBACH,CAAC;oBAED,MAAM,IAAI,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;oBAE7C,OAAO;wBACL,OAAO;wBACP,EAAE;wBACF,SAAS;wBACT,IAAI;wBACJ,UAAU;wBACV,IAAI,EAAE;4BACJ,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;4BACrB,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;4BACrB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;4BAC7B,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;yBAChC;wBACD,KAAK,EAAE,QAAQ;qBAChB,CAAC;gBACJ,CAAC;gBAED,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CACnC,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,WAAW,CAAC,0BAA0B,EACtC,IAAI,CACL,CAAC;gBAEF,MAAM,QAAQ,GAA4C,EAAE,CAAC;gBAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;gBAE/D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC/B,MAAM,IAAI,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;oBACzC,IAAI,IAAI,YAAY,OAAO,EAAE,CAAC;wBAC5B,MAAM,WAAW,GAAG,IAAI,SAAS,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;wBAC/C,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;oBACvD,CAAC;gBACH,CAAC;gBAED,OAAO;oBACL,QAAQ;oBACR,UAAU,EAAE,WAAW,CAAC,cAAc;iBACvC,CAAC;YACJ,CAAC,EACD,KAAK,EACL,KAAK,CACN,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,MAAM,EAAE,aAAa;4BACrB,KAAK;4BACL,QAAQ,EAAE,IAAI;4BACd,OAAO,EAAE,MAAM,CAAC,QAAQ;4BACxB,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;4BAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;4BAC7B,OAAO,EACL,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;gCACxB,CAAC,CAAC,SAAS,MAAM,CAAC,UAAU,yBAAyB,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;gCAC7E,CAAC,CAAC,mBAAmB;yBAC1B,CAAC;qBACH;iBACF;aACF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,uBAAuB;YACvB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,SAAiB,EAAE,EAAE;gBACxD,SAAS,kBAAkB,CAAC,EAAW,EAAE,QAAgB;oBACvD,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;oBACzC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,SAAS,CAAC;oBAC9B,MAAM,aAAa,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;oBAC/C,MAAM,SAAS,GAAG,aAAa,IAAI,SAAS,CAAC;oBAC7C,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC;oBAE/D,MAAM,UAAU,GAA2B,EAAE,CAAC;oBAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;wBAC9C,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;wBAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;4BAChD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;wBACnD,CAAC;oBACH,CAAC;oBAED,MAAM,IAAI,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAC;oBAExC,OAAO;wBACL,OAAO;wBACP,EAAE;wBACF,SAAS;wBACT,IAAI;wBACJ,UAAU;wBACV,IAAI,EAAE;4BACJ,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;4BACrB,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;4BACrB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;4BAC7B,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;yBAChC;wBACD,KAAK,EAAE,QAAQ;qBAChB,CAAC;gBACJ,CAAC;gBAED,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CACnC,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,WAAW,CAAC,uBAAuB,EACnC,IAAI,CACL,CAAC;gBAEF,MAAM,IAAI,GAAG,WAAW,CAAC,eAAe,CAAC;gBACzC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,YAAY,OAAO,CAAC,EAAE,CAAC;oBACxC,OAAO,IAAI,CAAC;gBACd,CAAC;gBAED,OAAO,kBAAkB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC7C,CAAC,EAAE,KAAK,CAAC,CAAC;YAEV,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,MAAM,EAAE,aAAa;gCACrB,KAAK;gCACL,QAAQ,EAAE,KAAK;gCACf,MAAM,EAAE,IAAI;gCACZ,OAAO,EAAE,iCAAiC;6BAC3C,CAAC;yBACH;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,MAAM,EAAE,aAAa;4BACrB,KAAK;4BACL,QAAQ,EAAE,KAAK;4BACf,MAAM,EAAE,OAAO;4BACf,OAAO,EAAE,mBAAmB,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG;yBACzF,CAAC;qBACH;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gCAAgC;QAChC,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,uBAAuB,YAAY,EAAE;qBAC5C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,sBAAsB,YAAY,EAAE;iBAC3C;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,SAAgB,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAC1D,CAAC"}