@zenalexa/unicli 0.216.3 → 0.217.3

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 (379) hide show
  1. package/AGENTS.md +7 -6
  2. package/README.md +67 -19
  3. package/README.zh-CN.md +44 -16
  4. package/crates/unicli-atspi/Cargo.toml +47 -0
  5. package/crates/unicli-atspi/README.md +6 -0
  6. package/crates/unicli-atspi/src/errors.rs +213 -0
  7. package/crates/unicli-atspi/src/input.rs +1004 -0
  8. package/crates/unicli-atspi/src/invoke.rs +1132 -0
  9. package/crates/unicli-atspi/src/main.rs +130 -0
  10. package/crates/unicli-atspi/src/refs.rs +24 -0
  11. package/crates/unicli-atspi/src/screenshot.rs +756 -0
  12. package/crates/unicli-atspi/src/tree.rs +2319 -0
  13. package/crates/unicli-shared/Cargo.toml +13 -0
  14. package/crates/unicli-shared/src/lib.rs +77 -0
  15. package/crates/unicli-uia/Cargo.toml +29 -0
  16. package/crates/unicli-uia/README.md +6 -0
  17. package/crates/unicli-uia/src/errors.rs +179 -0
  18. package/crates/unicli-uia/src/input.rs +790 -0
  19. package/crates/unicli-uia/src/invoke.rs +977 -0
  20. package/crates/unicli-uia/src/main.rs +130 -0
  21. package/crates/unicli-uia/src/refs.rs +24 -0
  22. package/crates/unicli-uia/src/screenshot.rs +685 -0
  23. package/crates/unicli-uia/src/tree.rs +2135 -0
  24. package/dist/adapters/_electron/desktop-shared.d.ts.map +1 -1
  25. package/dist/adapters/_electron/desktop-shared.js +13 -0
  26. package/dist/adapters/_electron/desktop-shared.js.map +1 -1
  27. package/dist/adapters/_electron/shared.d.ts +1 -0
  28. package/dist/adapters/_electron/shared.d.ts.map +1 -1
  29. package/dist/adapters/_electron/shared.js +49 -2
  30. package/dist/adapters/_electron/shared.js.map +1 -1
  31. package/dist/adapters/macos/actions.d.ts +9 -0
  32. package/dist/adapters/macos/actions.d.ts.map +1 -0
  33. package/dist/adapters/macos/actions.js +55 -0
  34. package/dist/adapters/macos/actions.js.map +1 -0
  35. package/dist/browser/bridge.d.ts +5 -1
  36. package/dist/browser/bridge.d.ts.map +1 -1
  37. package/dist/browser/bridge.js +86 -23
  38. package/dist/browser/bridge.js.map +1 -1
  39. package/dist/browser/cdp-client.d.ts +2 -0
  40. package/dist/browser/cdp-client.d.ts.map +1 -1
  41. package/dist/browser/cdp-client.js +7 -0
  42. package/dist/browser/cdp-client.js.map +1 -1
  43. package/dist/browser/page.d.ts +2 -0
  44. package/dist/browser/page.d.ts.map +1 -1
  45. package/dist/browser/page.js +35 -0
  46. package/dist/browser/page.js.map +1 -1
  47. package/dist/cli.d.ts.map +1 -1
  48. package/dist/cli.js +17 -2
  49. package/dist/cli.js.map +1 -1
  50. package/dist/commands/approvals.d.ts +3 -0
  51. package/dist/commands/approvals.d.ts.map +1 -0
  52. package/dist/commands/approvals.js +123 -0
  53. package/dist/commands/approvals.js.map +1 -0
  54. package/dist/commands/browser-operator-runtime.d.ts.map +1 -1
  55. package/dist/commands/browser-operator-runtime.js +5 -2
  56. package/dist/commands/browser-operator-runtime.js.map +1 -1
  57. package/dist/commands/browser-operator.d.ts.map +1 -1
  58. package/dist/commands/browser-operator.js +182 -38
  59. package/dist/commands/browser-operator.js.map +1 -1
  60. package/dist/commands/compute.d.ts +3 -0
  61. package/dist/commands/compute.d.ts.map +1 -0
  62. package/dist/commands/compute.js +324 -0
  63. package/dist/commands/compute.js.map +1 -0
  64. package/dist/commands/describe.d.ts.map +1 -1
  65. package/dist/commands/describe.js +20 -1
  66. package/dist/commands/describe.js.map +1 -1
  67. package/dist/commands/dispatch.d.ts +3 -0
  68. package/dist/commands/dispatch.d.ts.map +1 -1
  69. package/dist/commands/dispatch.js +76 -4
  70. package/dist/commands/dispatch.js.map +1 -1
  71. package/dist/commands/doctor-compute.d.ts +38 -0
  72. package/dist/commands/doctor-compute.d.ts.map +1 -0
  73. package/dist/commands/doctor-compute.js +376 -0
  74. package/dist/commands/doctor-compute.js.map +1 -0
  75. package/dist/commands/lint.d.ts.map +1 -1
  76. package/dist/commands/lint.js +69 -1
  77. package/dist/commands/lint.js.map +1 -1
  78. package/dist/commands/mcp.d.ts.map +1 -1
  79. package/dist/commands/mcp.js +4 -0
  80. package/dist/commands/mcp.js.map +1 -1
  81. package/dist/commands/runs.d.ts +3 -0
  82. package/dist/commands/runs.d.ts.map +1 -0
  83. package/dist/commands/runs.js +367 -0
  84. package/dist/commands/runs.js.map +1 -0
  85. package/dist/core/envelope.d.ts +8 -0
  86. package/dist/core/envelope.d.ts.map +1 -1
  87. package/dist/core/envelope.js +1 -0
  88. package/dist/core/envelope.js.map +1 -1
  89. package/dist/core/schema-v2.d.ts +2 -2
  90. package/dist/discovery/aliases.d.ts.map +1 -1
  91. package/dist/discovery/aliases.js +15 -0
  92. package/dist/discovery/aliases.js.map +1 -1
  93. package/dist/discovery/loader.d.ts.map +1 -1
  94. package/dist/discovery/loader.js +11 -0
  95. package/dist/discovery/loader.js.map +1 -1
  96. package/dist/discovery/macos-dynamic.d.ts +58 -0
  97. package/dist/discovery/macos-dynamic.d.ts.map +1 -0
  98. package/dist/discovery/macos-dynamic.js +429 -0
  99. package/dist/discovery/macos-dynamic.js.map +1 -0
  100. package/dist/discovery/search.d.ts.map +1 -1
  101. package/dist/discovery/search.js +152 -3
  102. package/dist/discovery/search.js.map +1 -1
  103. package/dist/electron-apps.d.ts +1 -0
  104. package/dist/electron-apps.d.ts.map +1 -1
  105. package/dist/electron-apps.js +1 -0
  106. package/dist/electron-apps.js.map +1 -1
  107. package/dist/engine/approval-store.d.ts +43 -0
  108. package/dist/engine/approval-store.d.ts.map +1 -0
  109. package/dist/engine/approval-store.js +193 -0
  110. package/dist/engine/approval-store.js.map +1 -0
  111. package/dist/engine/browser/action-evidence.d.ts +30 -0
  112. package/dist/engine/browser/action-evidence.d.ts.map +1 -0
  113. package/dist/engine/browser/action-evidence.js +354 -0
  114. package/dist/engine/browser/action-evidence.js.map +1 -0
  115. package/dist/engine/browser/evidence.d.ts +85 -0
  116. package/dist/engine/browser/evidence.d.ts.map +1 -0
  117. package/dist/engine/browser/evidence.js +373 -0
  118. package/dist/engine/browser/evidence.js.map +1 -0
  119. package/dist/engine/browser/session-lease.d.ts +53 -0
  120. package/dist/engine/browser/session-lease.d.ts.map +1 -0
  121. package/dist/engine/browser/session-lease.js +100 -0
  122. package/dist/engine/browser/session-lease.js.map +1 -0
  123. package/dist/engine/browser/session-lock.d.ts +17 -0
  124. package/dist/engine/browser/session-lock.d.ts.map +1 -0
  125. package/dist/engine/browser/session-lock.js +114 -0
  126. package/dist/engine/browser/session-lock.js.map +1 -0
  127. package/dist/engine/browser/session-runtime.d.ts +10 -0
  128. package/dist/engine/browser/session-runtime.d.ts.map +1 -0
  129. package/dist/engine/browser/session-runtime.js +87 -0
  130. package/dist/engine/browser/session-runtime.js.map +1 -0
  131. package/dist/engine/capability-policy.d.ts +50 -0
  132. package/dist/engine/capability-policy.d.ts.map +1 -0
  133. package/dist/engine/capability-policy.js +305 -0
  134. package/dist/engine/capability-policy.js.map +1 -0
  135. package/dist/engine/executor.d.ts +8 -3
  136. package/dist/engine/executor.d.ts.map +1 -1
  137. package/dist/engine/executor.js +9 -2
  138. package/dist/engine/executor.js.map +1 -1
  139. package/dist/engine/kernel/execute.d.ts +5 -1
  140. package/dist/engine/kernel/execute.d.ts.map +1 -1
  141. package/dist/engine/kernel/execute.js +215 -11
  142. package/dist/engine/kernel/execute.js.map +1 -1
  143. package/dist/engine/kernel/types.d.ts +15 -0
  144. package/dist/engine/kernel/types.d.ts.map +1 -1
  145. package/dist/engine/operation-policy.d.ts +60 -0
  146. package/dist/engine/operation-policy.d.ts.map +1 -0
  147. package/dist/engine/operation-policy.js +364 -0
  148. package/dist/engine/operation-policy.js.map +1 -0
  149. package/dist/engine/permission-rules.d.ts +43 -0
  150. package/dist/engine/permission-rules.d.ts.map +1 -0
  151. package/dist/engine/permission-rules.js +401 -0
  152. package/dist/engine/permission-rules.js.map +1 -0
  153. package/dist/engine/permission-runtime.d.ts +11 -0
  154. package/dist/engine/permission-runtime.d.ts.map +1 -0
  155. package/dist/engine/permission-runtime.js +21 -0
  156. package/dist/engine/permission-runtime.js.map +1 -0
  157. package/dist/engine/repair/remedies.d.ts +4 -0
  158. package/dist/engine/repair/remedies.d.ts.map +1 -0
  159. package/dist/engine/repair/remedies.js +169 -0
  160. package/dist/engine/repair/remedies.js.map +1 -0
  161. package/dist/engine/runtime-resource-guard.d.ts +23 -0
  162. package/dist/engine/runtime-resource-guard.d.ts.map +1 -0
  163. package/dist/engine/runtime-resource-guard.js +85 -0
  164. package/dist/engine/runtime-resource-guard.js.map +1 -0
  165. package/dist/engine/session/args.d.ts +3 -0
  166. package/dist/engine/session/args.d.ts.map +1 -0
  167. package/dist/engine/session/args.js +17 -0
  168. package/dist/engine/session/args.js.map +1 -0
  169. package/dist/engine/session/compare.d.ts +92 -0
  170. package/dist/engine/session/compare.d.ts.map +1 -0
  171. package/dist/engine/session/compare.js +324 -0
  172. package/dist/engine/session/compare.js.map +1 -0
  173. package/dist/engine/session/environment.d.ts +4 -0
  174. package/dist/engine/session/environment.d.ts.map +1 -0
  175. package/dist/engine/session/environment.js +25 -0
  176. package/dist/engine/session/environment.js.map +1 -0
  177. package/dist/engine/session/events.d.ts +24 -0
  178. package/dist/engine/session/events.d.ts.map +1 -0
  179. package/dist/engine/session/events.js +78 -0
  180. package/dist/engine/session/events.js.map +1 -0
  181. package/dist/engine/session/query.d.ts +47 -0
  182. package/dist/engine/session/query.d.ts.map +1 -0
  183. package/dist/engine/session/query.js +299 -0
  184. package/dist/engine/session/query.js.map +1 -0
  185. package/dist/engine/session/replay.d.ts +35 -0
  186. package/dist/engine/session/replay.d.ts.map +1 -0
  187. package/dist/engine/session/replay.js +144 -0
  188. package/dist/engine/session/replay.js.map +1 -0
  189. package/dist/engine/session/run-loop.d.ts +11 -0
  190. package/dist/engine/session/run-loop.d.ts.map +1 -0
  191. package/dist/engine/session/run-loop.js +212 -0
  192. package/dist/engine/session/run-loop.js.map +1 -0
  193. package/dist/engine/session/store.d.ts +26 -0
  194. package/dist/engine/session/store.d.ts.map +1 -0
  195. package/dist/engine/session/store.js +214 -0
  196. package/dist/engine/session/store.js.map +1 -0
  197. package/dist/engine/session/types.d.ts +39 -0
  198. package/dist/engine/session/types.d.ts.map +1 -0
  199. package/dist/engine/session/types.js +2 -0
  200. package/dist/engine/session/types.js.map +1 -0
  201. package/dist/engine/steps/compute.d.ts +41 -0
  202. package/dist/engine/steps/compute.d.ts.map +1 -0
  203. package/dist/engine/steps/compute.js +55 -0
  204. package/dist/engine/steps/compute.js.map +1 -0
  205. package/dist/engine/steps/desktop-ax.d.ts +8 -0
  206. package/dist/engine/steps/desktop-ax.d.ts.map +1 -1
  207. package/dist/engine/steps/desktop-ax.js +16 -0
  208. package/dist/engine/steps/desktop-ax.js.map +1 -1
  209. package/dist/engine/steps/desktop-sidecar.d.ts +49 -0
  210. package/dist/engine/steps/desktop-sidecar.d.ts.map +1 -0
  211. package/dist/engine/steps/desktop-sidecar.js +50 -0
  212. package/dist/engine/steps/desktop-sidecar.js.map +1 -0
  213. package/dist/engine/steps/download.d.ts +1 -1
  214. package/dist/engine/steps/download.d.ts.map +1 -1
  215. package/dist/engine/steps/download.js +24 -2
  216. package/dist/engine/steps/download.js.map +1 -1
  217. package/dist/engine/steps/exec.d.ts +1 -1
  218. package/dist/engine/steps/exec.d.ts.map +1 -1
  219. package/dist/engine/steps/exec.js +23 -7
  220. package/dist/engine/steps/exec.js.map +1 -1
  221. package/dist/engine/steps/fetch-text.d.ts +2 -2
  222. package/dist/engine/steps/fetch-text.d.ts.map +1 -1
  223. package/dist/engine/steps/fetch-text.js +61 -19
  224. package/dist/engine/steps/fetch-text.js.map +1 -1
  225. package/dist/engine/steps/fetch.d.ts +3 -1
  226. package/dist/engine/steps/fetch.d.ts.map +1 -1
  227. package/dist/engine/steps/fetch.js +36 -7
  228. package/dist/engine/steps/fetch.js.map +1 -1
  229. package/dist/engine/steps/index.d.ts +2 -0
  230. package/dist/engine/steps/index.d.ts.map +1 -1
  231. package/dist/engine/steps/index.js +2 -0
  232. package/dist/engine/steps/index.js.map +1 -1
  233. package/dist/engine/steps/navigate.d.ts +1 -1
  234. package/dist/engine/steps/navigate.d.ts.map +1 -1
  235. package/dist/engine/steps/navigate.js +29 -2
  236. package/dist/engine/steps/navigate.js.map +1 -1
  237. package/dist/engine/steps/parse-rss.d.ts.map +1 -1
  238. package/dist/engine/steps/parse-rss.js +9 -4
  239. package/dist/engine/steps/parse-rss.js.map +1 -1
  240. package/dist/engine/template.d.ts.map +1 -1
  241. package/dist/engine/template.js +2 -1
  242. package/dist/engine/template.js.map +1 -1
  243. package/dist/engine/text-normalize.d.ts +6 -0
  244. package/dist/engine/text-normalize.d.ts.map +1 -0
  245. package/dist/engine/text-normalize.js +63 -0
  246. package/dist/engine/text-normalize.js.map +1 -0
  247. package/dist/fast-path.d.ts.map +1 -1
  248. package/dist/fast-path.js +291 -8
  249. package/dist/fast-path.js.map +1 -1
  250. package/dist/main.d.ts +1 -1
  251. package/dist/main.js +1 -1
  252. package/dist/manifest-compact.txt +2 -2
  253. package/dist/manifest-search.json +1 -1
  254. package/dist/manifest.json +4313 -533
  255. package/dist/mcp/dispatch.d.ts +3 -3
  256. package/dist/mcp/dispatch.d.ts.map +1 -1
  257. package/dist/mcp/dispatch.js +6 -5
  258. package/dist/mcp/dispatch.js.map +1 -1
  259. package/dist/mcp/handler.d.ts +2 -2
  260. package/dist/mcp/handler.d.ts.map +1 -1
  261. package/dist/mcp/handler.js +59 -5
  262. package/dist/mcp/handler.js.map +1 -1
  263. package/dist/mcp/profiles/computer-use.d.ts +4 -0
  264. package/dist/mcp/profiles/computer-use.d.ts.map +1 -0
  265. package/dist/mcp/profiles/computer-use.js +305 -0
  266. package/dist/mcp/profiles/computer-use.js.map +1 -0
  267. package/dist/mcp/server.d.ts.map +1 -1
  268. package/dist/mcp/server.js +30 -6
  269. package/dist/mcp/server.js.map +1 -1
  270. package/dist/mcp/tools.d.ts +9 -0
  271. package/dist/mcp/tools.d.ts.map +1 -1
  272. package/dist/mcp/tools.js +20 -0
  273. package/dist/mcp/tools.js.map +1 -1
  274. package/dist/output/envelope.d.ts +6 -0
  275. package/dist/output/envelope.d.ts.map +1 -1
  276. package/dist/output/envelope.js.map +1 -1
  277. package/dist/output/error-map.d.ts.map +1 -1
  278. package/dist/output/error-map.js +25 -0
  279. package/dist/output/error-map.js.map +1 -1
  280. package/dist/protocol/acp-helpers.d.ts +2 -2
  281. package/dist/protocol/acp-helpers.d.ts.map +1 -1
  282. package/dist/protocol/acp-helpers.js +5 -4
  283. package/dist/protocol/acp-helpers.js.map +1 -1
  284. package/dist/registry.d.ts +4 -1
  285. package/dist/registry.d.ts.map +1 -1
  286. package/dist/registry.js +7 -0
  287. package/dist/registry.js.map +1 -1
  288. package/dist/transport/adapters/cdp-browser.d.ts +38 -2
  289. package/dist/transport/adapters/cdp-browser.d.ts.map +1 -1
  290. package/dist/transport/adapters/cdp-browser.js +349 -22
  291. package/dist/transport/adapters/cdp-browser.js.map +1 -1
  292. package/dist/transport/adapters/desktop-atspi.d.ts +23 -17
  293. package/dist/transport/adapters/desktop-atspi.d.ts.map +1 -1
  294. package/dist/transport/adapters/desktop-atspi.js +143 -32
  295. package/dist/transport/adapters/desktop-atspi.js.map +1 -1
  296. package/dist/transport/adapters/desktop-ax-helpers.d.ts +24 -0
  297. package/dist/transport/adapters/desktop-ax-helpers.d.ts.map +1 -0
  298. package/dist/transport/adapters/desktop-ax-helpers.js +190 -0
  299. package/dist/transport/adapters/desktop-ax-helpers.js.map +1 -0
  300. package/dist/transport/adapters/desktop-ax-swift.d.ts +13 -0
  301. package/dist/transport/adapters/desktop-ax-swift.d.ts.map +1 -1
  302. package/dist/transport/adapters/desktop-ax-swift.js +176 -2
  303. package/dist/transport/adapters/desktop-ax-swift.js.map +1 -1
  304. package/dist/transport/adapters/desktop-ax.d.ts +11 -2
  305. package/dist/transport/adapters/desktop-ax.d.ts.map +1 -1
  306. package/dist/transport/adapters/desktop-ax.js +131 -16
  307. package/dist/transport/adapters/desktop-ax.js.map +1 -1
  308. package/dist/transport/adapters/desktop-sidecar-errors.d.ts +3 -0
  309. package/dist/transport/adapters/desktop-sidecar-errors.d.ts.map +1 -0
  310. package/dist/transport/adapters/desktop-sidecar-errors.js +34 -0
  311. package/dist/transport/adapters/desktop-sidecar-errors.js.map +1 -0
  312. package/dist/transport/adapters/desktop-sidecar-snapshot.d.ts +10 -0
  313. package/dist/transport/adapters/desktop-sidecar-snapshot.d.ts.map +1 -0
  314. package/dist/transport/adapters/desktop-sidecar-snapshot.js +89 -0
  315. package/dist/transport/adapters/desktop-sidecar-snapshot.js.map +1 -0
  316. package/dist/transport/adapters/desktop-uia.d.ts +23 -17
  317. package/dist/transport/adapters/desktop-uia.d.ts.map +1 -1
  318. package/dist/transport/adapters/desktop-uia.js +142 -32
  319. package/dist/transport/adapters/desktop-uia.js.map +1 -1
  320. package/dist/transport/adapters/subprocess.d.ts +7 -0
  321. package/dist/transport/adapters/subprocess.d.ts.map +1 -1
  322. package/dist/transport/adapters/subprocess.js +64 -0
  323. package/dist/transport/adapters/subprocess.js.map +1 -1
  324. package/dist/transport/bus.d.ts +2 -0
  325. package/dist/transport/bus.d.ts.map +1 -1
  326. package/dist/transport/bus.js +7 -11
  327. package/dist/transport/bus.js.map +1 -1
  328. package/dist/transport/capability.d.ts.map +1 -1
  329. package/dist/transport/capability.js +123 -98
  330. package/dist/transport/capability.js.map +1 -1
  331. package/dist/transport/cascade.d.ts +5 -0
  332. package/dist/transport/cascade.d.ts.map +1 -0
  333. package/dist/transport/cascade.js +550 -0
  334. package/dist/transport/cascade.js.map +1 -0
  335. package/dist/transport/cdp-session.d.ts +11 -0
  336. package/dist/transport/cdp-session.d.ts.map +1 -0
  337. package/dist/transport/cdp-session.js +52 -0
  338. package/dist/transport/cdp-session.js.map +1 -0
  339. package/dist/transport/refs.d.ts +51 -0
  340. package/dist/transport/refs.d.ts.map +1 -0
  341. package/dist/transport/refs.js +135 -0
  342. package/dist/transport/refs.js.map +1 -0
  343. package/dist/transport/sidecar-binary.d.ts +18 -0
  344. package/dist/transport/sidecar-binary.d.ts.map +1 -0
  345. package/dist/transport/sidecar-binary.js +55 -0
  346. package/dist/transport/sidecar-binary.js.map +1 -0
  347. package/dist/transport/sidecar.d.ts +35 -0
  348. package/dist/transport/sidecar.d.ts.map +1 -0
  349. package/dist/transport/sidecar.js +134 -0
  350. package/dist/transport/sidecar.js.map +1 -0
  351. package/dist/transport/snapshot-encoder.d.ts +34 -0
  352. package/dist/transport/snapshot-encoder.d.ts.map +1 -0
  353. package/dist/transport/snapshot-encoder.js +139 -0
  354. package/dist/transport/snapshot-encoder.js.map +1 -0
  355. package/dist/transport/types.d.ts +6 -1
  356. package/dist/transport/types.d.ts.map +1 -1
  357. package/dist/types.d.ts +11 -1
  358. package/dist/types.d.ts.map +1 -1
  359. package/dist/types.js.map +1 -1
  360. package/docs/mcp/clients/claude-code.md +29 -0
  361. package/docs/mcp/clients/claude-desktop.md +47 -0
  362. package/docs/mcp/clients/codex.md +29 -0
  363. package/docs/mcp/clients/cursor.md +38 -0
  364. package/docs/mcp/clients/gemini-cli.md +38 -0
  365. package/docs/operate/compute.md +172 -0
  366. package/docs/operate/electron.md +87 -0
  367. package/docs/operate/focus-behavior.md +40 -0
  368. package/docs/operate/troubleshooting.md +379 -0
  369. package/package.json +44 -19
  370. package/src/adapters/36kr/news.yaml +4 -1
  371. package/src/adapters/_electron/desktop-shared.ts +14 -0
  372. package/src/adapters/_electron/shared.ts +54 -2
  373. package/src/adapters/juejin/hot.test.ts +25 -0
  374. package/src/adapters/juejin/hot.yaml +52 -0
  375. package/src/adapters/juejin/search.test.ts +27 -0
  376. package/src/adapters/juejin/search.yaml +58 -0
  377. package/src/adapters/leetcode/discuss-search.test.ts +29 -0
  378. package/src/adapters/leetcode/discuss-search.yaml +56 -0
  379. package/src/adapters/macos/actions.ts +63 -0
@@ -1,26 +1,27 @@
1
1
  /**
2
- * DesktopAtspiTransport — Linux AT-SPI transport stub.
3
- *
4
- * v0.214 ships this adapter as a declared-but-unimplemented transport.
5
- * Registering it with the bus makes capability queries honest (agents
6
- * can see that `atspi_activate` exists on linux) without pretending the
7
- * bodies work. Every call returns a structured `service_unavailable`
8
- * envelope whose `minimum_capability` tells the self-repair loop what
9
- * to build next.
10
- *
11
- * Design contract:
12
- * - `open()` NEVER throws
13
- * - `action()` always returns an `ok:false` envelope with `exit_code: 69`
14
- * - `minimum_capability: "desktop-atspi.<verb>"` so agents can route
2
+ * DesktopAtspiTransport — Linux AT-SPI transport.
15
3
  */
16
4
  import { err, exitCodeFor } from "../../core/envelope.js";
5
+ import { ok } from "../../core/envelope.js";
6
+ import { resolveSidecarBinary } from "../sidecar-binary.js";
7
+ import { isSidecarError, StdioSidecarClient } from "../sidecar.js";
8
+ import { normalizeDesktopSidecarError } from "./desktop-sidecar-errors.js";
9
+ import { snapshotFromSidecarRaw, } from "./desktop-sidecar-snapshot.js";
17
10
  const ATSPI_STEPS = [
18
- "atspi_activate",
19
- "ax_focus",
20
- "focus_window",
11
+ "atspi_apps",
12
+ "atspi_windows",
13
+ "atspi_snapshot",
14
+ "atspi_find",
15
+ "atspi_invoke",
16
+ "atspi_set_value",
17
+ "atspi_focus",
18
+ "atspi_press",
19
+ "atspi_scroll",
20
+ "atspi_screenshot",
21
+ "atspi_wait",
22
+ "atspi_observe",
23
+ "atspi_assert",
21
24
  "launch_app",
22
- "clipboard_read",
23
- "clipboard_write",
24
25
  ];
25
26
  const ATSPI_CAPABILITY = {
26
27
  steps: ATSPI_STEPS,
@@ -28,38 +29,148 @@ const ATSPI_CAPABILITY = {
28
29
  platforms: ["linux"],
29
30
  mutatesHost: true,
30
31
  };
31
- const NOT_IMPLEMENTED_REASON = "Linux AT-SPI transport is a declared stub in v0.214";
32
- const CONTRIBUTE_HINT = "Contribute a PR — see contributing/transport.md for the AT-SPI backend recipe";
32
+ const LINUX_ONLY_SUGGESTION = "run on Linux with the native AT-SPI backend available, or fall back to CUA";
33
33
  export class DesktopAtspiTransport {
34
34
  kind = "desktop-atspi";
35
35
  capability = ATSPI_CAPABILITY;
36
- async open(_ctx) {
37
- // Accept the context so capability queries route through the bus, but
38
- // don't spawn anything — we can't even attempt AT-SPI without a backend.
36
+ platform;
37
+ sidecarCommand;
38
+ sidecar;
39
+ refs;
40
+ closed = false;
41
+ constructor(opts = {}) {
42
+ this.platform = opts.platform ?? process.platform;
43
+ this.sidecar = opts.sidecar;
44
+ this.sidecarCommand =
45
+ opts.sidecarCommand ??
46
+ resolveSidecarBinary("unicli-atspi", {
47
+ platform: this.platform,
48
+ env: process.env,
49
+ }).command;
39
50
  }
40
- async snapshot(_opts) {
51
+ async open(ctx) {
52
+ this.refs = ctx.refs ?? ctx.bus.refs;
53
+ if (this.platform !== "linux" || this.sidecar)
54
+ return;
55
+ this.sidecar = new StdioSidecarClient(this.sidecarCommand, [], {
56
+ env: process.env,
57
+ });
58
+ }
59
+ async snapshot(opts) {
60
+ if (this.platform !== "linux")
61
+ return this.unavailableSnapshot();
62
+ try {
63
+ const params = opts?.format ? { format: opts.format } : {};
64
+ const data = await this.requireSidecar().call("atspi_snapshot", params);
65
+ return snapshotFromSidecarRaw(data, {
66
+ format: opts?.format,
67
+ transport: this.kind,
68
+ refs: this.refs,
69
+ });
70
+ }
71
+ catch (error) {
72
+ return {
73
+ format: "json",
74
+ data: JSON.stringify(this.snapshotError(error)),
75
+ };
76
+ }
77
+ }
78
+ async action(req) {
79
+ if (this.platform !== "linux")
80
+ return this.unavailable(req.kind);
81
+ try {
82
+ const data = await this.requireSidecar().call(req.kind, req.params);
83
+ return ok(data);
84
+ }
85
+ catch (error) {
86
+ return this.errorFromSidecar(req.kind, error);
87
+ }
88
+ }
89
+ async close() {
90
+ if (this.closed)
91
+ return;
92
+ this.closed = true;
93
+ await this.sidecar?.close();
94
+ }
95
+ requireSidecar() {
96
+ if (!this.sidecar) {
97
+ this.sidecar = new StdioSidecarClient(this.sidecarCommand, [], {
98
+ env: process.env,
99
+ });
100
+ }
101
+ return this.sidecar;
102
+ }
103
+ unavailableSnapshot() {
41
104
  return {
42
105
  format: "json",
43
106
  data: JSON.stringify({
44
107
  transport: "desktop-atspi",
45
108
  ok: false,
46
- reason: NOT_IMPLEMENTED_REASON,
109
+ reason: `desktop-atspi is only available on Linux; current platform is ${this.platform}`,
47
110
  }),
48
111
  };
49
112
  }
50
- async action(req) {
113
+ unavailable(action) {
51
114
  return err({
52
115
  transport: "desktop-atspi",
53
116
  step: 0,
54
- action: req.kind,
55
- reason: NOT_IMPLEMENTED_REASON,
56
- suggestion: CONTRIBUTE_HINT,
57
- minimum_capability: `desktop-atspi.${req.kind === "open" ? "open" : req.kind}`,
117
+ action,
118
+ reason: `desktop-atspi is only available on Linux; current platform is ${this.platform}`,
119
+ suggestion: LINUX_ONLY_SUGGESTION,
120
+ minimum_capability: `desktop-atspi.${action}`,
58
121
  exit_code: exitCodeFor("service_unavailable"),
59
122
  });
60
123
  }
61
- async close() {
62
- // Idempotent no-op — nothing to release.
124
+ errorFromSidecar(action, error) {
125
+ if (isSidecarError(error)) {
126
+ const normalized = normalizeDesktopSidecarError("desktop-atspi", error);
127
+ return err({
128
+ transport: "desktop-atspi",
129
+ step: 0,
130
+ action: normalized.action || action,
131
+ reason: normalized.reason,
132
+ suggestion: normalized.suggestion,
133
+ minimum_capability: normalized.minimum_capability,
134
+ exit_code: normalized.exit_code,
135
+ });
136
+ }
137
+ const message = error instanceof Error ? error.message : String(error);
138
+ if (isSidecarProcessCrash(message)) {
139
+ return err({
140
+ transport: "desktop-atspi",
141
+ step: 0,
142
+ action,
143
+ reason: message,
144
+ suggestion: "retry the action; if the sidecar keeps crashing, run UNICLI_TRACE=1 unicli doctor compute",
145
+ minimum_capability: "desktop-atspi.sidecar_crashed",
146
+ retryable: true,
147
+ exit_code: exitCodeFor("temp_failure"),
148
+ });
149
+ }
150
+ return err({
151
+ transport: "desktop-atspi",
152
+ step: 0,
153
+ action,
154
+ reason: message,
155
+ suggestion: "inspect the unicli-atspi sidecar process and retry",
156
+ minimum_capability: `desktop-atspi.${action}`,
157
+ exit_code: exitCodeFor("service_unavailable"),
158
+ });
63
159
  }
160
+ snapshotError(error) {
161
+ if (isSidecarError(error)) {
162
+ return { ok: false, error };
163
+ }
164
+ return {
165
+ ok: false,
166
+ error: {
167
+ transport: "desktop-atspi",
168
+ reason: error instanceof Error ? error.message : String(error),
169
+ },
170
+ };
171
+ }
172
+ }
173
+ function isSidecarProcessCrash(message) {
174
+ return /sidecar (?:exited|closed)|EPIPE|ECONNRESET/i.test(message);
64
175
  }
65
176
  //# sourceMappingURL=desktop-atspi.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"desktop-atspi.js","sourceRoot":"","sources":["../../../src/transport/adapters/desktop-atspi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAY1D,MAAM,WAAW,GAAG;IAClB,gBAAgB;IAChB,UAAU;IACV,cAAc;IACd,YAAY;IACZ,gBAAgB;IAChB,iBAAiB;CACT,CAAC;AAEX,MAAM,gBAAgB,GAAe;IACnC,KAAK,EAAE,WAAW;IAClB,eAAe,EAAE,CAAC,OAAO,CAA8B;IACvD,SAAS,EAAE,CAAC,OAAO,CAAU;IAC7B,WAAW,EAAE,IAAI;CAClB,CAAC;AAEF,MAAM,sBAAsB,GAC1B,qDAAqD,CAAC;AACxD,MAAM,eAAe,GACnB,+EAA+E,CAAC;AAElF,MAAM,OAAO,qBAAqB;IACvB,IAAI,GAAkB,eAAe,CAAC;IACtC,UAAU,GAAe,gBAAgB,CAAC;IAEnD,KAAK,CAAC,IAAI,CAAC,IAAsB;QAC/B,sEAAsE;QACtE,yEAAyE;IAC3E,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAmC;QAChD,OAAO;YACL,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,SAAS,EAAE,eAAe;gBAC1B,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,sBAAsB;aAC/B,CAAC;SACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAc,GAAkB;QAC1C,OAAO,GAAG,CAAC;YACT,SAAS,EAAE,eAAe;YAC1B,IAAI,EAAE,CAAC;YACP,MAAM,EAAE,GAAG,CAAC,IAAI;YAChB,MAAM,EAAE,sBAAsB;YAC9B,UAAU,EAAE,eAAe;YAC3B,kBAAkB,EAAE,iBAAiB,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE;YAC9E,SAAS,EAAE,WAAW,CAAC,qBAAqB,CAAC;SAC9C,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACT,yCAAyC;IAC3C,CAAC;CACF"}
1
+ {"version":3,"file":"desktop-atspi.js","sourceRoot":"","sources":["../../../src/transport/adapters/desktop-atspi.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Internal helpers for `DesktopAxTransport`.
3
+ *
4
+ * Pure utilities and Swift-script binary lifecycle. Carved out of
5
+ * `desktop-ax.ts` to keep the main transport file under the
6
+ * god-file-guard threshold and to give these helpers a stable home for
7
+ * future direct unit testing.
8
+ */
9
+ import type { RawAxNode } from "../snapshot-encoder.js";
10
+ import type { AxShell } from "./desktop-ax.js";
11
+ import { type AxWindowsScriptOptions, type ResolvedAxTarget } from "./desktop-ax-swift.js";
12
+ export declare const SWIFT_SCRIPT_CACHE_VERSION = "v1";
13
+ export declare function ensureSwiftScriptBinary(script: string, shell: AxShell): Promise<string>;
14
+ export declare function swiftScriptCacheDir(): string;
15
+ export declare function launchOpenArgs(target: ResolvedAxTarget, params: Record<string, unknown>): string[];
16
+ export declare function readAxWindowsFilter(params: Record<string, unknown>): AxWindowsScriptOptions;
17
+ export declare function normalizeAxSnapshot(input: Record<string, unknown>, path?: string, scope?: string, inherited?: {
18
+ app?: string;
19
+ pid?: number;
20
+ }): RawAxNode;
21
+ export declare function readStringParam(value: unknown): string | undefined;
22
+ /** Escape an AppleScript string literal used inside `osascript -e`. */
23
+ export declare function escapeAs(s: string): string;
24
+ //# sourceMappingURL=desktop-ax-helpers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"desktop-ax-helpers.d.ts","sourceRoot":"","sources":["../../../src/transport/adapters/desktop-ax-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAI/C,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAgBD,wBAAgB,mBAAmB,IAAI,MAAM,CAK5C;AAWD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,EAAE,CAgBV;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,sBAAsB,CAcxB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,SAA4C,EAChD,KAAK,SAAmB,EACxB,SAAS,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7C,SAAS,CAoBX;AAoFD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIlE;AAMD,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1C"}
@@ -0,0 +1,190 @@
1
+ /**
2
+ * Internal helpers for `DesktopAxTransport`.
3
+ *
4
+ * Pure utilities and Swift-script binary lifecycle. Carved out of
5
+ * `desktop-ax.ts` to keep the main transport file under the
6
+ * god-file-guard threshold and to give these helpers a stable home for
7
+ * future direct unit testing.
8
+ */
9
+ import { createHash } from "node:crypto";
10
+ import { access, chmod, mkdir, writeFile } from "node:fs/promises";
11
+ import { homedir } from "node:os";
12
+ import { join } from "node:path";
13
+ import { resolveAxTarget, } from "./desktop-ax-swift.js";
14
+ export const SWIFT_SCRIPT_CACHE_VERSION = "v1";
15
+ const swiftScriptCompileLocks = new Map();
16
+ export async function ensureSwiftScriptBinary(script, shell) {
17
+ const digest = createHash("sha256")
18
+ .update(SWIFT_SCRIPT_CACHE_VERSION)
19
+ .update("\0")
20
+ .update(script)
21
+ .digest("hex");
22
+ const root = swiftScriptCacheDir();
23
+ const sourcePath = join(root, `${digest}.swift`);
24
+ const binaryPath = join(root, digest);
25
+ if (await fileExists(binaryPath))
26
+ return binaryPath;
27
+ let lock = swiftScriptCompileLocks.get(binaryPath);
28
+ if (!lock) {
29
+ lock = compileSwiftScript(shell, sourcePath, binaryPath, script);
30
+ swiftScriptCompileLocks.set(binaryPath, lock);
31
+ }
32
+ try {
33
+ await lock;
34
+ }
35
+ finally {
36
+ swiftScriptCompileLocks.delete(binaryPath);
37
+ }
38
+ return binaryPath;
39
+ }
40
+ async function compileSwiftScript(shell, sourcePath, binaryPath, script) {
41
+ await mkdir(swiftScriptCacheDir(), { recursive: true });
42
+ await writeFile(sourcePath, script, "utf8");
43
+ await shell.run("swiftc", [sourcePath, "-O", "-o", binaryPath], {
44
+ timeoutMs: 30_000,
45
+ });
46
+ await chmod(binaryPath, 0o755);
47
+ }
48
+ export function swiftScriptCacheDir() {
49
+ return (process.env.UNICLI_AX_SWIFT_CACHE_DIR ??
50
+ join(homedir(), ".unicli", "cache", "swift", SWIFT_SCRIPT_CACHE_VERSION));
51
+ }
52
+ async function fileExists(path) {
53
+ try {
54
+ await access(path);
55
+ return true;
56
+ }
57
+ catch {
58
+ return false;
59
+ }
60
+ }
61
+ export function launchOpenArgs(target, params) {
62
+ const debugPort = typeof params.debugPort === "number"
63
+ ? params.debugPort
64
+ : typeof params.debugPort === "string"
65
+ ? Number(params.debugPort)
66
+ : undefined;
67
+ if (typeof debugPort !== "number" || !Number.isFinite(debugPort)) {
68
+ return [...target.openArgs];
69
+ }
70
+ return [
71
+ "-a",
72
+ target.appName,
73
+ "--args",
74
+ `--remote-debugging-port=${debugPort}`,
75
+ ];
76
+ }
77
+ export function readAxWindowsFilter(params) {
78
+ const resolved = resolveAxTarget(params);
79
+ if (resolved) {
80
+ return {
81
+ appName: resolved.appName,
82
+ bundleId: resolved.bundleId,
83
+ processName: resolved.processName,
84
+ };
85
+ }
86
+ return {
87
+ appName: readStringParam(params.app),
88
+ bundleId: readStringParam(params.bundleId),
89
+ processName: readStringParam(params.processName),
90
+ };
91
+ }
92
+ export function normalizeAxSnapshot(input, path = String(input.role ?? "AXUnknown") + "[0]", scope = readScope(input), inherited = {}) {
93
+ const role = typeof input.role === "string" ? input.role : "AXUnknown";
94
+ const app = typeof input.app === "string" ? input.app : inherited.app;
95
+ const pid = typeof input.pid === "number" ? input.pid : inherited.pid;
96
+ const children = Array.isArray(input.children)
97
+ ? normalizeChildren(input.children, path, scope, { app, pid })
98
+ : undefined;
99
+ return {
100
+ role,
101
+ name: readName(input),
102
+ value: typeof input.value === "string" ? input.value : undefined,
103
+ bounds: readBounds(input),
104
+ screenIndex: readScreenIndex(input),
105
+ states: readStates(input),
106
+ children,
107
+ path,
108
+ scope,
109
+ app,
110
+ pid,
111
+ };
112
+ }
113
+ function normalizeChildren(children, parentPath, scope, inherited) {
114
+ const roleCounts = new Map();
115
+ const nodes = [];
116
+ for (const child of children) {
117
+ if (!isRecord(child))
118
+ continue;
119
+ const role = typeof child.role === "string" ? child.role : "AXUnknown";
120
+ const index = roleCounts.get(role) ?? 0;
121
+ roleCounts.set(role, index + 1);
122
+ nodes.push(normalizeAxSnapshot(child, `${parentPath}/${role}[${index}]`, scope, inherited));
123
+ }
124
+ return nodes;
125
+ }
126
+ function readScope(input) {
127
+ if (typeof input.scope === "string" && input.scope)
128
+ return input.scope;
129
+ if (typeof input.pid === "number")
130
+ return String(input.pid);
131
+ return "focusedWindow";
132
+ }
133
+ function readName(input) {
134
+ for (const key of ["name", "title", "label", "description"]) {
135
+ const value = input[key];
136
+ if (typeof value === "string" && value)
137
+ return value;
138
+ }
139
+ return undefined;
140
+ }
141
+ function readBounds(input) {
142
+ const bounds = input.bounds;
143
+ if (!isRecord(bounds))
144
+ return undefined;
145
+ const x = readNumber(bounds.x);
146
+ const y = readNumber(bounds.y);
147
+ const w = readNumber(bounds.w ?? bounds.width);
148
+ const h = readNumber(bounds.h ?? bounds.height);
149
+ if (x === undefined ||
150
+ y === undefined ||
151
+ w === undefined ||
152
+ h === undefined) {
153
+ return undefined;
154
+ }
155
+ return { x, y, w, h };
156
+ }
157
+ function readScreenIndex(input) {
158
+ const value = input.screenIndex;
159
+ return typeof value === "number" && Number.isFinite(value)
160
+ ? Math.trunc(value)
161
+ : undefined;
162
+ }
163
+ function readStates(input) {
164
+ if (!Array.isArray(input.states))
165
+ return undefined;
166
+ return input.states.filter((state) => typeof state === "string");
167
+ }
168
+ function readNumber(value) {
169
+ return typeof value === "number" && Number.isFinite(value)
170
+ ? value
171
+ : undefined;
172
+ }
173
+ export function readStringParam(value) {
174
+ if (typeof value !== "string")
175
+ return undefined;
176
+ const trimmed = value.trim();
177
+ return trimmed ? trimmed : undefined;
178
+ }
179
+ function isRecord(value) {
180
+ return typeof value === "object" && value !== null && !Array.isArray(value);
181
+ }
182
+ /** Escape an AppleScript string literal used inside `osascript -e`. */
183
+ export function escapeAs(s) {
184
+ return s
185
+ .replace(/\\/g, "\\\\")
186
+ .replace(/"/g, '\\"')
187
+ .replace(/[\r\n]/g, " ")
188
+ .replaceAll("\0", "");
189
+ }
190
+ //# sourceMappingURL=desktop-ax-helpers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"desktop-ax-helpers.js","sourceRoot":"","sources":["../../../src/transport/adapters/desktop-ax-helpers.ts"],"names":[],"mappings":"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"}
@@ -29,9 +29,11 @@ export interface AxElementQuery {
29
29
  maxDepth: number;
30
30
  roles: readonly string[];
31
31
  subroles: readonly string[];
32
+ names: readonly string[];
32
33
  titles: readonly string[];
33
34
  descriptions: readonly string[];
34
35
  identifiers: readonly string[];
36
+ namePrefix: boolean;
35
37
  titlePrefix: boolean;
36
38
  descriptionPrefix: boolean;
37
39
  }
@@ -42,11 +44,22 @@ export interface AxSetValueScriptOptions extends AxElementQuery {
42
44
  export interface AxPressScriptOptions extends AxElementQuery {
43
45
  actionName: string;
44
46
  }
47
+ export interface AxScrollScriptOptions extends AxElementQuery {
48
+ actionName: string;
49
+ }
50
+ export interface AxWindowsScriptOptions {
51
+ appName?: string;
52
+ bundleId?: string;
53
+ processName?: string;
54
+ }
55
+ export declare function buildAxAppsScript(): string;
56
+ export declare function buildAxWindowsScript(opts?: AxWindowsScriptOptions): string;
45
57
  export declare function buildElectronAxWarmupScript(target: ResolvedAxTarget, waitMs: number): string;
46
58
  export declare function buildAxSnapshotScript(target: ResolvedAxTarget, opts: AxSnapshotScriptOptions): string;
47
59
  export declare function buildAxFocusedReadScript(target: ResolvedAxTarget, query: AxElementQuery): string;
48
60
  export declare function buildAxSetValueScript(target: ResolvedAxTarget, opts: AxSetValueScriptOptions): string;
49
61
  export declare function buildAxPressScript(target: ResolvedAxTarget, opts: AxPressScriptOptions): string;
62
+ export declare function buildAxScrollScript(target: ResolvedAxTarget, opts: AxScrollScriptOptions): string;
50
63
  export declare function swiftStringLiteral(value: string): string;
51
64
  export declare function swiftStringArray(values: readonly string[]): string;
52
65
  export declare function resolveAxTarget(params: Record<string, unknown>): ResolvedAxTarget | null;
@@ -1 +1 @@
1
- {"version":3,"file":"desktop-ax-swift.d.ts","sourceRoot":"","sources":["../../../src/transport/adapters/desktop-ax-swift.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"desktop-ax-swift.d.ts","sourceRoot":"","sources":["../../../src/transport/adapters/desktop-ax-swift.ts"],"names":[],"mappings":"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"}