@lobu/runtime-device 24.1.0 → 24.2.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 (159) hide show
  1. package/dist/component.json +1 -1
  2. package/dist/dependencies.bun.lock +26 -28
  3. package/npm-shrinkwrap.json +155 -172
  4. package/package.json +1 -1
  5. package/vendor/cli/dist/bundled-skills/lobu/SKILL.md +14 -5
  6. package/vendor/cli/dist/chrome-extension/accessibility-tree.js +834 -0
  7. package/vendor/cli/dist/chrome-extension/ambient-context.js +53 -0
  8. package/vendor/cli/dist/chrome-extension/auth-refresh.js +167 -0
  9. package/vendor/cli/dist/chrome-extension/automation-run.js +13 -0
  10. package/vendor/cli/dist/chrome-extension/background.js +1155 -0
  11. package/vendor/cli/dist/chrome-extension/bridge.js +140 -0
  12. package/vendor/cli/dist/chrome-extension/browser-origin-policy.js +62 -0
  13. package/vendor/cli/dist/chrome-extension/browser-recovery.js +260 -0
  14. package/vendor/cli/dist/chrome-extension/browser-url-sanitizer.js +284 -0
  15. package/vendor/cli/dist/chrome-extension/completion-response.js +12 -0
  16. package/vendor/cli/dist/chrome-extension/config.js +144 -0
  17. package/vendor/cli/dist/chrome-extension/connector-manifests/chrome.json +1516 -0
  18. package/vendor/cli/dist/chrome-extension/connector-manifests/chrome_bookmarks.json +84 -0
  19. package/vendor/cli/dist/chrome-extension/connector-manifests/chrome_downloads.json +86 -0
  20. package/vendor/cli/dist/chrome-extension/connector-manifests/chrome_history.json +78 -0
  21. package/vendor/cli/dist/chrome-extension/connector-manifests.js +1767 -0
  22. package/vendor/cli/dist/chrome-extension/console-capture.js +627 -0
  23. package/vendor/cli/dist/chrome-extension/control-activity.js +70 -0
  24. package/vendor/cli/dist/chrome-extension/debugger-lease.js +439 -0
  25. package/vendor/cli/dist/chrome-extension/feed-listener.js +488 -0
  26. package/vendor/cli/dist/chrome-extension/feed-transaction.js +48 -0
  27. package/vendor/cli/dist/chrome-extension/feeds.js +632 -0
  28. package/vendor/cli/dist/chrome-extension/focus-tab.js +25 -0
  29. package/vendor/cli/dist/chrome-extension/fonts/dm-mono-latin-500-normal.woff2 +0 -0
  30. package/vendor/cli/dist/chrome-extension/fonts/dm-sans-latin-400-normal.woff2 +0 -0
  31. package/vendor/cli/dist/chrome-extension/fonts/dm-sans-latin-600-normal.woff2 +0 -0
  32. package/vendor/cli/dist/chrome-extension/heartbeat.js +140 -0
  33. package/vendor/cli/dist/chrome-extension/icons/icon-128-rec.png +0 -0
  34. package/vendor/cli/dist/chrome-extension/icons/icon-128.png +0 -0
  35. package/vendor/cli/dist/chrome-extension/icons/icon-16-rec.png +0 -0
  36. package/vendor/cli/dist/chrome-extension/icons/icon-16.png +0 -0
  37. package/vendor/cli/dist/chrome-extension/icons/icon-32-rec.png +0 -0
  38. package/vendor/cli/dist/chrome-extension/icons/icon-32.png +0 -0
  39. package/vendor/cli/dist/chrome-extension/icons/icon-48-rec.png +0 -0
  40. package/vendor/cli/dist/chrome-extension/icons/icon-48.png +0 -0
  41. package/vendor/cli/dist/chrome-extension/lens-page.js +135 -0
  42. package/vendor/cli/dist/chrome-extension/lens-target.js +20 -0
  43. package/vendor/cli/dist/chrome-extension/manifest.json +76 -0
  44. package/vendor/cli/dist/chrome-extension/network-intercept.js +657 -0
  45. package/vendor/cli/dist/chrome-extension/page-activation.js +120 -0
  46. package/vendor/cli/dist/chrome-extension/page-dialogs.js +125 -0
  47. package/vendor/cli/dist/chrome-extension/page-url.js +11 -0
  48. package/vendor/cli/dist/chrome-extension/panel-session.js +184 -0
  49. package/vendor/cli/dist/chrome-extension/poll-auth.js +85 -0
  50. package/vendor/cli/dist/chrome-extension/poll-backoff.js +22 -0
  51. package/vendor/cli/dist/chrome-extension/run-fence.js +117 -0
  52. package/vendor/cli/dist/chrome-extension/setup-status.js +71 -0
  53. package/vendor/cli/dist/chrome-extension/side-panel-action-click.js +65 -0
  54. package/vendor/cli/dist/chrome-extension/sidepanel-context.js +50 -0
  55. package/vendor/cli/dist/chrome-extension/sidepanel.html +680 -0
  56. package/vendor/cli/dist/chrome-extension/sidepanel.js +1643 -0
  57. package/vendor/cli/dist/chrome-extension/tab-labels.js +233 -0
  58. package/vendor/cli/dist/chrome-extension/tools.js +3354 -0
  59. package/vendor/cli/dist/chrome-extension/watch-observer.js +354 -0
  60. package/vendor/cli/dist/chrome-extension/watch-redact.js +96 -0
  61. package/vendor/cli/dist/chrome-extension/watch.js +348 -0
  62. package/vendor/cli/dist/commands/_lib/apply/desired-state.d.ts +6 -4
  63. package/vendor/cli/dist/commands/_lib/apply/desired-state.js +5 -3
  64. package/vendor/cli/dist/commands/_lib/apply/diff.js +4 -3
  65. package/vendor/cli/dist/commands/_lib/apply/render.js +4 -14
  66. package/vendor/cli/dist/commands/_lib/chrome-for-testing.d.ts +13 -0
  67. package/vendor/cli/dist/commands/_lib/chrome-for-testing.js +226 -0
  68. package/vendor/cli/dist/commands/_lib/device-credential.d.ts +34 -0
  69. package/vendor/cli/dist/commands/_lib/device-credential.js +157 -0
  70. package/vendor/cli/dist/commands/_lib/device-wizard.d.ts +17 -0
  71. package/vendor/cli/dist/commands/_lib/device-wizard.js +11 -2
  72. package/vendor/cli/dist/commands/_lib/native-messaging.d.ts +7 -0
  73. package/vendor/cli/dist/commands/_lib/native-messaging.js +40 -0
  74. package/vendor/cli/dist/commands/browser.d.ts +23 -0
  75. package/vendor/cli/dist/commands/browser.js +492 -0
  76. package/vendor/cli/dist/commands/call.d.ts +12 -0
  77. package/vendor/cli/dist/commands/call.js +48 -26
  78. package/vendor/cli/dist/commands/context.d.ts +3 -1
  79. package/vendor/cli/dist/commands/context.js +13 -2
  80. package/vendor/cli/dist/commands/daemon.js +2 -152
  81. package/vendor/cli/dist/commands/memory/_lib/errors.d.ts +4 -1
  82. package/vendor/cli/dist/commands/memory/_lib/errors.js +9 -1
  83. package/vendor/cli/dist/commands/memory/_lib/mcp.d.ts +0 -9
  84. package/vendor/cli/dist/commands/memory/_lib/mcp.js +1 -23
  85. package/vendor/cli/dist/commands/memory/_lib/memory-auth.d.ts +20 -4
  86. package/vendor/cli/dist/commands/memory/_lib/memory-auth.js +21 -17
  87. package/vendor/cli/dist/commands/memory/_lib/seed-cmd.js +6 -17
  88. package/vendor/cli/dist/commands/memory/run.js +4 -25
  89. package/vendor/cli/dist/connectors/google_gmail.ts +70 -41
  90. package/vendor/cli/dist/connectors/google_gmail_references.ts +406 -0
  91. package/vendor/cli/dist/connectors/linkedin-inbox-adapter.js +107 -36
  92. package/vendor/cli/dist/connectors/linkedin-inbox.ts +13 -0
  93. package/vendor/cli/dist/connectors/linkedin.ts +1 -1
  94. package/vendor/cli/dist/connectors/postgres.ts +5 -3
  95. package/vendor/cli/dist/connectors/reddit.ts +171 -5
  96. package/vendor/cli/dist/connectors/whatsapp-web-adapter.js +147 -61
  97. package/vendor/cli/dist/connectors/whatsapp-web-helpers.ts +6 -2
  98. package/vendor/cli/dist/connectors/whatsapp_web.ts +48 -17
  99. package/vendor/cli/dist/connectors/x-dm-adapter.js +252 -35
  100. package/vendor/cli/dist/connectors/x.ts +189 -13
  101. package/vendor/cli/dist/index.js +46 -6
  102. package/vendor/cli/dist/internal/device-state.d.ts +2 -0
  103. package/vendor/cli/dist/internal/device-state.js +4 -0
  104. package/vendor/cli/dist/runtime-components.json +4 -4
  105. package/vendor/cli/dist/templates/AGENTS.md.tmpl +3 -1
  106. package/vendor/cli/dist/templates/TESTING.md.tmpl +8 -8
  107. package/vendor/cli/package.json +1 -1
  108. package/vendor/connector-sdk/dist/browser-requirement.js +1 -1
  109. package/vendor/connector-sdk/dist/connector-types.d.ts +5 -1
  110. package/vendor/connector-sdk/package.json +1 -1
  111. package/vendor/connector-worker/dist/agent-turn/gateway-tools.d.ts +9 -0
  112. package/vendor/connector-worker/dist/agent-turn/gateway-tools.js +23 -2
  113. package/vendor/connector-worker/dist/agent-turn/guest-entry.js +14 -6
  114. package/vendor/connector-worker/dist/agent-turn/guest.bundle.js +62 -25
  115. package/vendor/connector-worker/dist/agent-turn/media-tools.d.ts +1 -0
  116. package/vendor/connector-worker/dist/agent-turn/media-tools.js +5 -2
  117. package/vendor/connector-worker/dist/bin.js +2 -0
  118. package/vendor/connector-worker/dist/daemon/agent-turn.js +52 -17
  119. package/vendor/connector-worker/dist/daemon/automation.js +2 -12
  120. package/vendor/connector-worker/dist/daemon/client.d.ts +8 -2
  121. package/vendor/connector-worker/dist/daemon/client.js +8 -1
  122. package/vendor/connector-worker/dist/daemon/interactive-session.js +29 -6
  123. package/vendor/connector-worker/dist/daemon/poll-loop.js +23 -1
  124. package/vendor/connector-worker/dist/daemon/terminal-delivery.d.ts +5 -10
  125. package/vendor/connector-worker/dist/daemon/terminal-delivery.js +55 -23
  126. package/vendor/connector-worker/dist/daemon/terminal-failure.js +2 -2
  127. package/vendor/connector-worker/dist/executor/isolate.js +3 -0
  128. package/vendor/connector-worker/package.json +1 -1
  129. package/vendor/core/dist/agent-tooling.d.ts +8 -0
  130. package/vendor/core/dist/agent-tooling.js +9 -1
  131. package/vendor/core/dist/capabilities.d.ts +1 -1
  132. package/vendor/core/dist/capabilities.js +5 -0
  133. package/vendor/core/dist/contracts/entity-reference.d.ts +3 -0
  134. package/vendor/core/dist/contracts/entity-reference.js +31 -0
  135. package/vendor/core/dist/contracts/tools/manage-automations.d.ts +3 -0
  136. package/vendor/core/dist/contracts/tools/manage-automations.js +3 -0
  137. package/vendor/core/dist/contracts/tools/manage-connections.js +1 -1
  138. package/vendor/core/dist/contracts/tools/manage-entity-schema.js +1 -1
  139. package/vendor/core/dist/contracts/tools/manage-entity.d.ts +113 -34
  140. package/vendor/core/dist/contracts/tools/manage-entity.js +41 -14
  141. package/vendor/core/dist/contracts/tools/manage-operations.d.ts +13 -4
  142. package/vendor/core/dist/contracts/tools/manage-operations.js +19 -7
  143. package/vendor/core/dist/contracts/tools/read-knowledge.d.ts +6 -1
  144. package/vendor/core/dist/contracts/tools/read-knowledge.js +20 -1
  145. package/vendor/core/dist/contracts/tools/view-attach.d.ts +1 -1
  146. package/vendor/core/dist/contracts/tools/view-runtime.d.ts +2 -0
  147. package/vendor/core/dist/contracts/tools/view-runtime.js +3 -1
  148. package/vendor/core/dist/contracts/worker/device-automation.d.ts +4 -9
  149. package/vendor/core/dist/contracts/worker/device-automation.js +10 -15
  150. package/vendor/core/dist/contracts/worker/protocol.d.ts +20 -0
  151. package/vendor/core/dist/contracts/worker/protocol.js +20 -0
  152. package/vendor/core/dist/reserved.d.ts +6 -3
  153. package/vendor/core/dist/reserved.js +6 -3
  154. package/vendor/core/dist/worker/auth.d.ts +3 -2
  155. package/vendor/core/package.json +6 -1
  156. package/vendor/postgres/cf/src/query.js +3 -1
  157. package/vendor/postgres/cjs/src/query.js +3 -1
  158. package/vendor/postgres/src/query.js +3 -1
  159. /package/vendor/postgres/{.bun-tag-2f292c6554a8475e → .bun-tag-22d644c2873790db} +0 -0
@@ -0,0 +1,1516 @@
1
+ {
2
+ "key": "chrome",
3
+ "version": "0.5.5",
4
+ "name": "Chrome",
5
+ "description": "Paired Chrome profile. Tab snapshots + a fixed set of typed browser actions (navigate, click, type, press keys, hover, scroll, select, answer dialogs, wait, screenshot, accessibility snapshot, evaluate) that connectors compose without shipping per-connector code into the extension.",
6
+ "favicon_domain": "google.com",
7
+ "required_capability": "browser.debugger",
8
+ "runtime": {
9
+ "platforms": [
10
+ "chrome-extension"
11
+ ]
12
+ },
13
+ "auth_schema": {
14
+ "methods": [
15
+ {
16
+ "type": "none"
17
+ }
18
+ ]
19
+ },
20
+ "feeds_schema": {
21
+ "open_tabs": {
22
+ "key": "open_tabs",
23
+ "name": "Open tabs",
24
+ "operations": [
25
+ "sync"
26
+ ],
27
+ "description": "Snapshot of the tabs currently open in this Chrome profile.",
28
+ "configSchema": {
29
+ "type": "object",
30
+ "properties": {}
31
+ },
32
+ "eventKinds": {
33
+ "tab_snapshot": {
34
+ "description": "One row per tab observed in the active poll cycle.",
35
+ "metadataSchema": {
36
+ "type": "object",
37
+ "required": [
38
+ "source",
39
+ "origin_id",
40
+ "url"
41
+ ],
42
+ "properties": {
43
+ "source": {
44
+ "type": "string",
45
+ "const": "chrome_tabs"
46
+ },
47
+ "origin_id": {
48
+ "type": "string"
49
+ },
50
+ "url": {
51
+ "type": "string",
52
+ "format": "uri"
53
+ },
54
+ "title": {
55
+ "type": "string"
56
+ },
57
+ "window_id": {
58
+ "type": "integer"
59
+ },
60
+ "active": {
61
+ "type": "boolean"
62
+ },
63
+ "group_id": {
64
+ "type": [
65
+ "integer",
66
+ "null"
67
+ ],
68
+ "description": "Chrome tab-group id, or null when the tab is not grouped."
69
+ },
70
+ "group_title": {
71
+ "type": [
72
+ "string",
73
+ "null"
74
+ ],
75
+ "description": "Live title of the tab's group (may be empty), or null when ungrouped."
76
+ },
77
+ "group_color": {
78
+ "type": [
79
+ "string",
80
+ "null"
81
+ ],
82
+ "description": "Live Chrome group color, or null when ungrouped."
83
+ }
84
+ }
85
+ }
86
+ }
87
+ }
88
+ },
89
+ "tab_events": {
90
+ "key": "tab_events",
91
+ "name": "Tab events",
92
+ "operations": [
93
+ "sync"
94
+ ],
95
+ "description": "Live stream of tab creates / closes / URL changes / focus changes. Each event has a timestamp, so this is the lossless \"browsing timeline\" companion to the open_tabs snapshot. No extra permission required (baseline `tabs`).",
96
+ "configSchema": {
97
+ "type": "object",
98
+ "properties": {}
99
+ },
100
+ "eventKinds": {
101
+ "tab_event": {
102
+ "description": "One row per tab lifecycle event. event_type is one of: created, removed, updated, activated.",
103
+ "metadataSchema": {
104
+ "type": "object",
105
+ "required": [
106
+ "source",
107
+ "origin_id",
108
+ "event_type"
109
+ ],
110
+ "properties": {
111
+ "source": {
112
+ "type": "string",
113
+ "const": "chrome_tab_events"
114
+ },
115
+ "origin_id": {
116
+ "type": "string"
117
+ },
118
+ "event_type": {
119
+ "enum": [
120
+ "created",
121
+ "removed",
122
+ "updated",
123
+ "activated"
124
+ ]
125
+ },
126
+ "tab_id": {
127
+ "type": "integer"
128
+ },
129
+ "url": {
130
+ "type": "string"
131
+ },
132
+ "title": {
133
+ "type": "string"
134
+ },
135
+ "window_id": {
136
+ "type": "integer"
137
+ },
138
+ "from_url": {
139
+ "type": "string",
140
+ "description": "For updated events, the URL the tab was on before the change."
141
+ }
142
+ }
143
+ }
144
+ }
145
+ }
146
+ },
147
+ "watch_observations": {
148
+ "key": "watch_observations",
149
+ "name": "Watch observations",
150
+ "operations": [
151
+ "sync"
152
+ ],
153
+ "description": "Form input + submit events captured while the user has \"Live input context\" on (the extension toolbar icon shows a red recording dot). Follows the actively used tab as the user switches tabs. Streamed only while watch is active — empty otherwise. Sensitive fields (password, one-time-code, credit-card autocomplete) are redacted in the page before the value ever reaches the buffer. No extra permission required (baseline `scripting`).",
154
+ "configSchema": {
155
+ "type": "object",
156
+ "properties": {}
157
+ },
158
+ "eventKinds": {
159
+ "watch_observation": {
160
+ "description": "One row per observed input or form submit on a watched tab. event_type is one of: input, submit.",
161
+ "metadataSchema": {
162
+ "type": "object",
163
+ "required": [
164
+ "source",
165
+ "origin_id",
166
+ "event_type"
167
+ ],
168
+ "properties": {
169
+ "source": {
170
+ "type": "string",
171
+ "const": "chrome_watch"
172
+ },
173
+ "origin_id": {
174
+ "type": "string"
175
+ },
176
+ "event_type": {
177
+ "enum": [
178
+ "input",
179
+ "submit"
180
+ ]
181
+ },
182
+ "url": {
183
+ "type": "string"
184
+ },
185
+ "field_label": {
186
+ "type": "string",
187
+ "description": "For input events, the field the user typed into."
188
+ },
189
+ "tag": {
190
+ "type": "string"
191
+ },
192
+ "type": {
193
+ "type": "string"
194
+ },
195
+ "length": {
196
+ "type": "integer"
197
+ },
198
+ "form_action": {
199
+ "type": "string",
200
+ "description": "For submit events, the form action URL."
201
+ },
202
+ "fields": {
203
+ "type": "array",
204
+ "description": "For submit events, the form fields (sensitive values redacted).",
205
+ "items": {
206
+ "type": "object"
207
+ }
208
+ }
209
+ }
210
+ }
211
+ }
212
+ }
213
+ }
214
+ },
215
+ "actions_schema": {
216
+ "navigate": {
217
+ "key": "navigate",
218
+ "name": "Navigate",
219
+ "description": "Open a URL in an agent tab. Without tab_id it reuses before it creates: your session's tab on the same site first, then another session's tab on that site (the result then carries busy_by: who was using it and when; check it, or list_tabs, before taking over), and only then a new background tab. Pass new_tab to force a fresh tab, and group with a short descriptive title to keep your task's tabs together. Never act in the user's active tab. Nothing closes tabs automatically: call close_tab (tab_id or group) when your task is done.",
220
+ "inputSchema": {
221
+ "type": "object",
222
+ "required": [
223
+ "url"
224
+ ],
225
+ "properties": {
226
+ "url": {
227
+ "type": "string",
228
+ "format": "uri"
229
+ },
230
+ "tab_id": {
231
+ "type": "integer",
232
+ "description": "Tab to act on. Omit to reuse or open an agent tab. Acting on a user tab (one list_tabs shows without a label) needs the user's \"Manage open tabs\" grant."
233
+ },
234
+ "new_tab": {
235
+ "type": "boolean",
236
+ "description": "Always open a fresh tab instead of reusing one on the same site."
237
+ },
238
+ "group": {
239
+ "type": "string",
240
+ "description": "Put the tab in the tab group with exactly this title in its window, creating it if needed. Groups only organize; they do not restrict other agents."
241
+ },
242
+ "wait_for_load": {
243
+ "type": "boolean",
244
+ "description": "Wait for the navigated main-frame document to load, following client-side redirects. Default true."
245
+ },
246
+ "persistent": {
247
+ "type": "boolean",
248
+ "description": "Use the site's single warm tab (kept loaded, never discarded by Chrome) instead of a task tab. For connectors whose page state is expensive to rebuild."
249
+ },
250
+ "window_focused": {
251
+ "type": "boolean",
252
+ "description": "With persistent, bring the warm tab's window to the foreground."
253
+ },
254
+ "window_width": {
255
+ "type": "integer",
256
+ "description": "Width of the one-shot window a cs_scrape run opens."
257
+ },
258
+ "window_height": {
259
+ "type": "integer",
260
+ "description": "Height of the one-shot window a cs_scrape run opens."
261
+ }
262
+ }
263
+ },
264
+ "outputSchema": {
265
+ "type": "object",
266
+ "properties": {
267
+ "tab_id": {
268
+ "type": "integer"
269
+ },
270
+ "current_url": {
271
+ "type": "string"
272
+ },
273
+ "title": {
274
+ "type": "string"
275
+ },
276
+ "reused": {
277
+ "type": "boolean",
278
+ "description": "True when an existing agent tab was reused."
279
+ },
280
+ "busy_by": {
281
+ "type": "object",
282
+ "description": "Present when the reused tab was last used by another session.",
283
+ "properties": {
284
+ "agent": {
285
+ "type": [
286
+ "string",
287
+ "null"
288
+ ]
289
+ },
290
+ "session": {
291
+ "type": [
292
+ "string",
293
+ "null"
294
+ ]
295
+ },
296
+ "last_used_at": {
297
+ "type": [
298
+ "integer",
299
+ "null"
300
+ ]
301
+ }
302
+ }
303
+ },
304
+ "outcome": {
305
+ "enum": [
306
+ "confirmed",
307
+ "unverifiable",
308
+ "no_change"
309
+ ],
310
+ "description": "What a read-back after the action showed: confirmed (the effect is there), no_change (the page is as it was), unverifiable (nothing could be read back)."
311
+ }
312
+ }
313
+ }
314
+ },
315
+ "list_tabs": {
316
+ "key": "list_tabs",
317
+ "kind": "read",
318
+ "name": "List tabs",
319
+ "description": "List every open tab with Chrome's own fields (active, window_focused, last_accessed, opener_tab_id, group, status, discarded, frozen) and, for tabs an agent opened, a label: opened_by / last_used_by ({agent, session, run}), opened_at, last_used_at, kind (task or warm). A tab without a label is the user's: read it freely, but do not act in it (and never in the active tab of the focused window) without the user's grant. status \"unloaded\" or discarded: true means the tab has no live page (Chrome freed it, or has not restored it since a restart); reading it reloads it first, which needs an agent tab or the \"Manage open tabs\" grant. URLs and titles are redacted.",
320
+ "inputSchema": {
321
+ "type": "object",
322
+ "properties": {}
323
+ },
324
+ "outputSchema": {
325
+ "type": "object",
326
+ "properties": {
327
+ "tabs": {
328
+ "type": "array",
329
+ "items": {
330
+ "type": "object"
331
+ }
332
+ }
333
+ }
334
+ }
335
+ },
336
+ "focus_tab": {
337
+ "key": "focus_tab",
338
+ "name": "Focus tab",
339
+ "description": "Bring a tab and its window to the foreground. A user tab needs the \"Manage open tabs\" grant.",
340
+ "inputSchema": {
341
+ "type": "object",
342
+ "required": [
343
+ "tab_id"
344
+ ],
345
+ "properties": {
346
+ "tab_id": {
347
+ "type": "integer",
348
+ "description": "Tab to focus."
349
+ },
350
+ "draw_attention": {
351
+ "type": "boolean",
352
+ "description": "Pulse the target window when focusing it. Default true."
353
+ },
354
+ "recovery_id": {
355
+ "type": "string",
356
+ "description": "Expiring handoff from a failed source read. Requires its exact connection and tab."
357
+ },
358
+ "observation_id": {
359
+ "type": "string",
360
+ "description": "Fresh observation from this recovery, consumed once by each action."
361
+ }
362
+ }
363
+ },
364
+ "outputSchema": {
365
+ "type": "object",
366
+ "properties": {
367
+ "focused": {
368
+ "type": "boolean"
369
+ },
370
+ "tab_id": {
371
+ "type": "integer"
372
+ },
373
+ "window_id": {
374
+ "type": "integer"
375
+ },
376
+ "outcome": {
377
+ "enum": [
378
+ "confirmed",
379
+ "unverifiable",
380
+ "no_change"
381
+ ],
382
+ "description": "What a read-back after the action showed: confirmed (the effect is there), no_change (the page is as it was), unverifiable (nothing could be read back)."
383
+ }
384
+ }
385
+ }
386
+ },
387
+ "get_accessibility_tree": {
388
+ "key": "get_accessibility_tree",
389
+ "kind": "read",
390
+ "name": "Get accessibility tree",
391
+ "description": "Return a structured snapshot of the page's elements with refs for click_ref/type_ref. The default \"interactive\" filter lists visible interactive elements inside the current viewport. A ref is valid for this document until the next snapshot, and goes stale if the page rewrites its element into something else. Sensitive fields are redacted.",
392
+ "inputSchema": {
393
+ "type": "object",
394
+ "properties": {
395
+ "tab_id": {
396
+ "type": "integer",
397
+ "description": "Tab to act on. Defaults to the run-scoped scratch tab."
398
+ },
399
+ "filter": {
400
+ "enum": [
401
+ "interactive",
402
+ "visible",
403
+ "all"
404
+ ],
405
+ "description": "Default \"interactive\". \"all\" is for debugging only."
406
+ },
407
+ "recovery_id": {
408
+ "type": "string",
409
+ "description": "Expiring handoff from a failed source read. Requires its exact connection and tab."
410
+ },
411
+ "observation_id": {
412
+ "type": "string",
413
+ "description": "Fresh observation from this recovery, consumed once by each action."
414
+ }
415
+ }
416
+ },
417
+ "outputSchema": {
418
+ "type": "object",
419
+ "properties": {
420
+ "document_epoch": {
421
+ "type": "integer"
422
+ },
423
+ "current_url": {
424
+ "type": "string"
425
+ },
426
+ "title": {
427
+ "type": "string"
428
+ },
429
+ "tree": {
430
+ "type": "array"
431
+ }
432
+ }
433
+ }
434
+ },
435
+ "click_ref": {
436
+ "key": "click_ref",
437
+ "name": "Click element by ref",
438
+ "description": "Click the element identified by a ref from a prior accessibility snapshot of the same tab + document. On a tab in front, sends a real mouse press/release at the element's centre after checking that nothing covers that point; on a background tab, dispatches the click inside the page. Refuses an element that is covered, disabled, outside the viewport, or stale. Reports outcome: confirmed when the page changed (DOM, URL, focus or scroll), no_change when it did not. If the action opens a JS dialog (alert, confirm, prompt, beforeunload) it fails, and its failed result's output.dialog carries the dialog; answer it with handle_dialog.",
439
+ "inputSchema": {
440
+ "type": "object",
441
+ "required": [
442
+ "ref"
443
+ ],
444
+ "properties": {
445
+ "ref": {
446
+ "type": "object",
447
+ "required": [
448
+ "document_epoch",
449
+ "ref_id"
450
+ ],
451
+ "properties": {
452
+ "document_epoch": {
453
+ "type": "integer"
454
+ },
455
+ "ref_id": {
456
+ "type": "integer"
457
+ }
458
+ },
459
+ "description": "Element reference returned by a prior get_accessibility_tree call on the same tab + document. frame_id is reserved for future iframe support; v1 dispatches against the main frame."
460
+ },
461
+ "tab_id": {
462
+ "type": "integer",
463
+ "description": "Tab to act on. Defaults to the run-scoped scratch tab."
464
+ },
465
+ "button": {
466
+ "enum": [
467
+ "left",
468
+ "right",
469
+ "middle"
470
+ ],
471
+ "description": "Default \"left\"."
472
+ },
473
+ "click_count": {
474
+ "type": "integer",
475
+ "minimum": 1,
476
+ "maximum": 3,
477
+ "description": "Default 1. Use 2 for double-click, 3 for triple-click."
478
+ },
479
+ "recovery_id": {
480
+ "type": "string",
481
+ "description": "Expiring handoff from a failed source read. Requires its exact connection and tab."
482
+ },
483
+ "observation_id": {
484
+ "type": "string",
485
+ "description": "Fresh observation from this recovery, consumed once by each action."
486
+ }
487
+ }
488
+ },
489
+ "outputSchema": {
490
+ "type": "object",
491
+ "properties": {
492
+ "tab_id": {
493
+ "type": "integer"
494
+ },
495
+ "outcome": {
496
+ "enum": [
497
+ "confirmed",
498
+ "unverifiable",
499
+ "no_change"
500
+ ],
501
+ "description": "What a read-back after the action showed: confirmed (the effect is there), no_change (the page is as it was), unverifiable (nothing could be read back)."
502
+ }
503
+ }
504
+ }
505
+ },
506
+ "type_ref": {
507
+ "key": "type_ref",
508
+ "name": "Type into element by ref",
509
+ "description": "Focus the element identified by a ref and enter the text with Input.insertText (date, time, colour and range values are set directly). Existing value is replaced by default. Refuses elements that do not take typed text, such as a select or checkbox. Reads the field back and reports outcome: confirmed when it holds the text, no_change when it is as it was, unverifiable when the page reformatted it.",
510
+ "inputSchema": {
511
+ "type": "object",
512
+ "required": [
513
+ "ref",
514
+ "text"
515
+ ],
516
+ "properties": {
517
+ "ref": {
518
+ "type": "object",
519
+ "required": [
520
+ "document_epoch",
521
+ "ref_id"
522
+ ],
523
+ "properties": {
524
+ "document_epoch": {
525
+ "type": "integer"
526
+ },
527
+ "ref_id": {
528
+ "type": "integer"
529
+ }
530
+ },
531
+ "description": "Element reference returned by a prior get_accessibility_tree call on the same tab + document. frame_id is reserved for future iframe support; v1 dispatches against the main frame."
532
+ },
533
+ "tab_id": {
534
+ "type": "integer",
535
+ "description": "Tab to act on. Defaults to the run-scoped scratch tab."
536
+ },
537
+ "text": {
538
+ "type": "string"
539
+ },
540
+ "clear_first": {
541
+ "type": "boolean",
542
+ "description": "Default true: the new text replaces the current value. False appends to it."
543
+ }
544
+ }
545
+ },
546
+ "outputSchema": {
547
+ "type": "object",
548
+ "properties": {
549
+ "tab_id": {
550
+ "type": "integer"
551
+ },
552
+ "typed": {
553
+ "type": "integer"
554
+ },
555
+ "outcome": {
556
+ "enum": [
557
+ "confirmed",
558
+ "unverifiable",
559
+ "no_change"
560
+ ],
561
+ "description": "What a read-back after the action showed: confirmed (the effect is there), no_change (the page is as it was), unverifiable (nothing could be read back)."
562
+ }
563
+ }
564
+ }
565
+ },
566
+ "press_key": {
567
+ "key": "press_key",
568
+ "name": "Press key",
569
+ "description": "Press one key with trusted keyboard input, on the focused element or on ref after focusing it. Works on background tabs (the tab is treated as focused for the press, never brought to the front). Use it for Enter to submit, Escape to close, Tab or arrows to move, and page shortcuts with modifiers. Reports outcome: confirmed when the page changed. If the action opens a JS dialog (alert, confirm, prompt, beforeunload) it fails, and its failed result's output.dialog carries the dialog; answer it with handle_dialog.",
570
+ "inputSchema": {
571
+ "type": "object",
572
+ "required": [
573
+ "key"
574
+ ],
575
+ "properties": {
576
+ "key": {
577
+ "type": "string",
578
+ "description": "A single character, or one of Enter, Tab, Escape, Backspace, Delete, ArrowLeft, ArrowUp, ArrowRight, ArrowDown, Home, End, PageUp, PageDown, \" \" (space)."
579
+ },
580
+ "modifiers": {
581
+ "type": "array",
582
+ "items": {
583
+ "enum": [
584
+ "Alt",
585
+ "Control",
586
+ "Meta",
587
+ "Shift"
588
+ ]
589
+ },
590
+ "description": "Modifier keys held during the press. With Alt, Control or Meta held the key types no text."
591
+ },
592
+ "ref": {
593
+ "type": "object",
594
+ "required": [
595
+ "document_epoch",
596
+ "ref_id"
597
+ ],
598
+ "properties": {
599
+ "document_epoch": {
600
+ "type": "integer"
601
+ },
602
+ "ref_id": {
603
+ "type": "integer"
604
+ }
605
+ },
606
+ "description": "Element reference returned by a prior get_accessibility_tree call on the same tab + document."
607
+ },
608
+ "tab_id": {
609
+ "type": "integer",
610
+ "description": "Tab to act on. Defaults to the run-scoped scratch tab."
611
+ }
612
+ }
613
+ },
614
+ "outputSchema": {
615
+ "type": "object",
616
+ "properties": {
617
+ "tab_id": {
618
+ "type": "integer"
619
+ },
620
+ "key": {
621
+ "type": "string"
622
+ },
623
+ "modifiers": {
624
+ "type": "array"
625
+ },
626
+ "outcome": {
627
+ "enum": [
628
+ "confirmed",
629
+ "unverifiable",
630
+ "no_change"
631
+ ],
632
+ "description": "What a read-back after the action showed: confirmed (the effect is there), no_change (the page is as it was), unverifiable (nothing could be read back)."
633
+ }
634
+ }
635
+ }
636
+ },
637
+ "hover_ref": {
638
+ "key": "hover_ref",
639
+ "name": "Hover element by ref",
640
+ "description": "Move the mouse onto the element's centre with trusted input, so hover menus and tooltips open; works on background tabs. Refuses an element that is covered or stale. Reports outcome: confirmed when the element is hovered.",
641
+ "inputSchema": {
642
+ "type": "object",
643
+ "required": [
644
+ "ref"
645
+ ],
646
+ "properties": {
647
+ "ref": {
648
+ "type": "object",
649
+ "required": [
650
+ "document_epoch",
651
+ "ref_id"
652
+ ],
653
+ "properties": {
654
+ "document_epoch": {
655
+ "type": "integer"
656
+ },
657
+ "ref_id": {
658
+ "type": "integer"
659
+ }
660
+ },
661
+ "description": "Element reference returned by a prior get_accessibility_tree call on the same tab + document."
662
+ },
663
+ "tab_id": {
664
+ "type": "integer",
665
+ "description": "Tab to act on. Defaults to the run-scoped scratch tab."
666
+ }
667
+ }
668
+ },
669
+ "outputSchema": {
670
+ "type": "object",
671
+ "properties": {
672
+ "tab_id": {
673
+ "type": "integer"
674
+ },
675
+ "hovered": {
676
+ "type": "object"
677
+ },
678
+ "outcome": {
679
+ "enum": [
680
+ "confirmed",
681
+ "unverifiable",
682
+ "no_change"
683
+ ],
684
+ "description": "What a read-back after the action showed: confirmed (the effect is there), no_change (the page is as it was), unverifiable (nothing could be read back)."
685
+ }
686
+ }
687
+ }
688
+ },
689
+ "scroll": {
690
+ "key": "scroll",
691
+ "name": "Scroll",
692
+ "description": "Scroll the page, or with ref the scroll container holding it, by delta_x/delta_y CSS pixels; with only ref, bring that element into view. Works on background tabs and fires the page's scroll handlers. Reports moved and at_end, so a pager knows when to stop; outcome is no_change when nothing moved.",
693
+ "inputSchema": {
694
+ "type": "object",
695
+ "properties": {
696
+ "ref": {
697
+ "type": "object",
698
+ "required": [
699
+ "document_epoch",
700
+ "ref_id"
701
+ ],
702
+ "properties": {
703
+ "document_epoch": {
704
+ "type": "integer"
705
+ },
706
+ "ref_id": {
707
+ "type": "integer"
708
+ }
709
+ },
710
+ "description": "Element reference returned by a prior get_accessibility_tree call on the same tab + document."
711
+ },
712
+ "delta_x": {
713
+ "type": "number",
714
+ "description": "Pixels right (negative: left). Default 0."
715
+ },
716
+ "delta_y": {
717
+ "type": "number",
718
+ "description": "Pixels down (negative: up). Default 0."
719
+ },
720
+ "tab_id": {
721
+ "type": "integer",
722
+ "description": "Tab to act on. Defaults to the run-scoped scratch tab."
723
+ }
724
+ }
725
+ },
726
+ "outputSchema": {
727
+ "type": "object",
728
+ "properties": {
729
+ "tab_id": {
730
+ "type": "integer"
731
+ },
732
+ "moved": {
733
+ "type": "boolean"
734
+ },
735
+ "scroll_x": {
736
+ "type": "integer"
737
+ },
738
+ "scroll_y": {
739
+ "type": "integer"
740
+ },
741
+ "at_end": {
742
+ "type": "boolean"
743
+ },
744
+ "outcome": {
745
+ "enum": [
746
+ "confirmed",
747
+ "unverifiable",
748
+ "no_change"
749
+ ],
750
+ "description": "What a read-back after the action showed: confirmed (the effect is there), no_change (the page is as it was), unverifiable (nothing could be read back)."
751
+ }
752
+ }
753
+ }
754
+ },
755
+ "select_option": {
756
+ "key": "select_option",
757
+ "name": "Select option by ref",
758
+ "description": "Choose an option of a native <select> by value or by visible label, firing input and change as a user's pick does, and read the selection back. Refuses a custom dropdown (open it with click_ref and click its option), a multi-select, and disabled selects or options.",
759
+ "inputSchema": {
760
+ "type": "object",
761
+ "required": [
762
+ "ref"
763
+ ],
764
+ "properties": {
765
+ "ref": {
766
+ "type": "object",
767
+ "required": [
768
+ "document_epoch",
769
+ "ref_id"
770
+ ],
771
+ "properties": {
772
+ "document_epoch": {
773
+ "type": "integer"
774
+ },
775
+ "ref_id": {
776
+ "type": "integer"
777
+ }
778
+ },
779
+ "description": "Element reference returned by a prior get_accessibility_tree call on the same tab + document."
780
+ },
781
+ "value": {
782
+ "type": "string",
783
+ "description": "The option's value attribute. Give value or label, not both."
784
+ },
785
+ "label": {
786
+ "type": "string",
787
+ "description": "The option's visible text."
788
+ },
789
+ "tab_id": {
790
+ "type": "integer",
791
+ "description": "Tab to act on. Defaults to the run-scoped scratch tab."
792
+ }
793
+ }
794
+ },
795
+ "outputSchema": {
796
+ "type": "object",
797
+ "properties": {
798
+ "tab_id": {
799
+ "type": "integer"
800
+ },
801
+ "selected": {
802
+ "type": "object",
803
+ "properties": {
804
+ "value": {
805
+ "type": "string"
806
+ },
807
+ "label": {
808
+ "type": "string"
809
+ }
810
+ }
811
+ },
812
+ "outcome": {
813
+ "enum": [
814
+ "confirmed",
815
+ "unverifiable",
816
+ "no_change"
817
+ ],
818
+ "description": "What a read-back after the action showed: confirmed (the effect is there), no_change (the page is as it was), unverifiable (nothing could be read back)."
819
+ }
820
+ }
821
+ }
822
+ },
823
+ "handle_dialog": {
824
+ "key": "handle_dialog",
825
+ "name": "Answer JS dialog",
826
+ "description": "Accept or dismiss the JS dialog (alert, confirm, prompt, beforeunload) an earlier action reported, by its dialog_id. Nothing answers dialogs on the agent's behalf; until one is answered, every action on its tab fails, and the failed result's output carries tab_id and dialog ({dialog_id, type, message}). In run_sdk, catch the error from operations.execute and read error.details.output; do not parse the error text. An unanswered dialog is handed to the user after two minutes.",
827
+ "inputSchema": {
828
+ "type": "object",
829
+ "required": [
830
+ "dialog_id",
831
+ "accept"
832
+ ],
833
+ "properties": {
834
+ "dialog_id": {
835
+ "type": "string",
836
+ "description": "output.dialog.dialog_id from the failed action that reported the dialog."
837
+ },
838
+ "accept": {
839
+ "type": "boolean",
840
+ "description": "true for OK / Leave, false for Cancel / Stay."
841
+ },
842
+ "prompt_text": {
843
+ "type": "string",
844
+ "description": "Text to enter in a prompt() when accepting."
845
+ },
846
+ "tab_id": {
847
+ "type": "integer",
848
+ "description": "Tab the dialog is on: output.tab_id from the failed action. Defaults to the run-scoped scratch tab."
849
+ }
850
+ }
851
+ },
852
+ "outputSchema": {
853
+ "type": "object",
854
+ "properties": {
855
+ "tab_id": {
856
+ "type": "integer"
857
+ },
858
+ "dialog_id": {
859
+ "type": "string"
860
+ },
861
+ "accepted": {
862
+ "type": "boolean"
863
+ },
864
+ "outcome": {
865
+ "enum": [
866
+ "confirmed",
867
+ "unverifiable",
868
+ "no_change"
869
+ ],
870
+ "description": "What a read-back after the action showed: confirmed (the effect is there), no_change (the page is as it was), unverifiable (nothing could be read back)."
871
+ }
872
+ }
873
+ }
874
+ },
875
+ "upload_file": {
876
+ "key": "upload_file",
877
+ "name": "Upload file to input by ref",
878
+ "description": "Set one or more files on a file <input> element identified by a ref from a prior accessibility snapshot, via DOM.setFileInputFiles. file_paths are absolute paths on the machine running the extension.",
879
+ "inputSchema": {
880
+ "type": "object",
881
+ "required": [
882
+ "ref",
883
+ "file_paths"
884
+ ],
885
+ "properties": {
886
+ "ref": {
887
+ "type": "object",
888
+ "required": [
889
+ "document_epoch",
890
+ "ref_id"
891
+ ],
892
+ "properties": {
893
+ "document_epoch": {
894
+ "type": "integer"
895
+ },
896
+ "ref_id": {
897
+ "type": "integer"
898
+ }
899
+ },
900
+ "description": "Element reference returned by a prior get_accessibility_tree call on the same tab + document. Must resolve to a file <input>. frame_id is reserved for future iframe support; v1 dispatches against the main frame."
901
+ },
902
+ "tab_id": {
903
+ "type": "integer",
904
+ "description": "Tab to act on. Defaults to the run-scoped scratch tab."
905
+ },
906
+ "file_paths": {
907
+ "type": "array",
908
+ "minItems": 1,
909
+ "items": {
910
+ "type": "string"
911
+ },
912
+ "description": "Absolute file paths to attach. Multiple paths require the input to allow multiple files."
913
+ }
914
+ }
915
+ },
916
+ "outputSchema": {
917
+ "type": "object",
918
+ "properties": {
919
+ "tab_id": {
920
+ "type": "integer"
921
+ },
922
+ "file_count": {
923
+ "type": "integer"
924
+ },
925
+ "outcome": {
926
+ "enum": [
927
+ "confirmed",
928
+ "unverifiable",
929
+ "no_change"
930
+ ],
931
+ "description": "What a read-back after the action showed: confirmed (the effect is there), no_change (the page is as it was), unverifiable (nothing could be read back)."
932
+ }
933
+ }
934
+ }
935
+ },
936
+ "wait_for_selector": {
937
+ "key": "wait_for_selector",
938
+ "kind": "read",
939
+ "name": "Wait for selector",
940
+ "description": "Poll the page for the first match of a CSS selector and return when it appears.",
941
+ "inputSchema": {
942
+ "type": "object",
943
+ "required": [
944
+ "selector"
945
+ ],
946
+ "properties": {
947
+ "selector": {
948
+ "type": "string"
949
+ },
950
+ "tab_id": {
951
+ "type": "integer",
952
+ "description": "Tab to act on. Defaults to the run-scoped scratch tab."
953
+ },
954
+ "timeout_ms": {
955
+ "type": "integer",
956
+ "minimum": 100,
957
+ "maximum": 60000,
958
+ "description": "Default 10000."
959
+ }
960
+ }
961
+ }
962
+ },
963
+ "screenshot": {
964
+ "key": "screenshot",
965
+ "kind": "read",
966
+ "name": "Screenshot",
967
+ "description": "Capture the visible viewport as a PNG.",
968
+ "inputSchema": {
969
+ "type": "object",
970
+ "properties": {
971
+ "tab_id": {
972
+ "type": "integer",
973
+ "description": "Tab to act on. Defaults to the run-scoped scratch tab."
974
+ },
975
+ "recovery_id": {
976
+ "type": "string",
977
+ "description": "Expiring handoff from a failed source read. Requires its exact connection and tab."
978
+ },
979
+ "observation_id": {
980
+ "type": "string",
981
+ "description": "Fresh observation from this recovery, consumed once by each action."
982
+ }
983
+ }
984
+ },
985
+ "outputSchema": {
986
+ "type": "object",
987
+ "properties": {
988
+ "attachments": {
989
+ "type": "array",
990
+ "description": "One inline PNG. The server materializes it into the ArtifactStore and rewrites each entry to { artifact_id, download_url, sha256 }.",
991
+ "items": {
992
+ "type": "object",
993
+ "properties": {
994
+ "kind": {
995
+ "type": "string"
996
+ },
997
+ "filename": {
998
+ "type": "string"
999
+ },
1000
+ "mime_type": {
1001
+ "type": "string"
1002
+ },
1003
+ "size_bytes": {
1004
+ "type": "integer"
1005
+ },
1006
+ "data": {
1007
+ "type": "string",
1008
+ "description": "base64 PNG bytes — replaced by the artifact reference on ingest."
1009
+ }
1010
+ }
1011
+ }
1012
+ },
1013
+ "width": {
1014
+ "type": "integer"
1015
+ },
1016
+ "height": {
1017
+ "type": "integer"
1018
+ }
1019
+ }
1020
+ }
1021
+ },
1022
+ "close_tab": {
1023
+ "key": "close_tab",
1024
+ "name": "Close tab",
1025
+ "description": "Close an agent tab, or every tab in the groups with a given title. Close your tabs when your task is done; nothing closes them automatically. User tabs (no label in list_tabs) are refused unless the user granted \"Manage open tabs\".",
1026
+ "inputSchema": {
1027
+ "type": "object",
1028
+ "properties": {
1029
+ "tab_id": {
1030
+ "type": "integer"
1031
+ },
1032
+ "group": {
1033
+ "type": "string",
1034
+ "description": "Close the tabs in the tab groups with exactly this title."
1035
+ }
1036
+ }
1037
+ },
1038
+ "outputSchema": {
1039
+ "type": "object",
1040
+ "properties": {
1041
+ "closed": {},
1042
+ "outcome": {
1043
+ "enum": [
1044
+ "confirmed",
1045
+ "unverifiable",
1046
+ "no_change"
1047
+ ],
1048
+ "description": "What a read-back after the action showed: confirmed (the effect is there), no_change (the page is as it was), unverifiable (nothing could be read back)."
1049
+ }
1050
+ }
1051
+ }
1052
+ },
1053
+ "close_user_tabs": {
1054
+ "key": "close_user_tabs",
1055
+ "name": "Close user tabs",
1056
+ "description": "Close one or more tabs the user (or any site) opened — not only extension-owned scratch tabs. Requires the opt-in tabs.manage action grant (Owletto Permissions → Manage open tabs; extension-local, not a platform capability). Refuses the active tab unless allow_active=true, and refuses the last tab in a window. Prefer a fresh open_tabs snapshot for tab ids.",
1057
+ "inputSchema": {
1058
+ "type": "object",
1059
+ "properties": {
1060
+ "tab_ids": {
1061
+ "type": "array",
1062
+ "items": {
1063
+ "type": "integer"
1064
+ },
1065
+ "description": "Tab ids to close (from open_tabs / chrome.tabs). Prefer batching."
1066
+ },
1067
+ "tab_id": {
1068
+ "type": "integer",
1069
+ "description": "Single tab id (alternative to tab_ids)."
1070
+ },
1071
+ "allow_active": {
1072
+ "type": "boolean",
1073
+ "description": "Allow closing the currently active tab in its window. Default false."
1074
+ }
1075
+ }
1076
+ },
1077
+ "outputSchema": {
1078
+ "type": "object",
1079
+ "properties": {
1080
+ "closed": {
1081
+ "type": "array",
1082
+ "items": {
1083
+ "type": "integer"
1084
+ }
1085
+ },
1086
+ "refused": {
1087
+ "type": "array",
1088
+ "items": {
1089
+ "type": "object",
1090
+ "properties": {
1091
+ "tab_id": {
1092
+ "type": "integer"
1093
+ },
1094
+ "reason": {
1095
+ "type": "string"
1096
+ }
1097
+ }
1098
+ }
1099
+ },
1100
+ "outcome": {
1101
+ "enum": [
1102
+ "confirmed",
1103
+ "unverifiable",
1104
+ "no_change"
1105
+ ],
1106
+ "description": "What a read-back after the action showed: confirmed (the effect is there), no_change (the page is as it was), unverifiable (nothing could be read back)."
1107
+ }
1108
+ }
1109
+ }
1110
+ },
1111
+ "show_notification": {
1112
+ "key": "show_notification",
1113
+ "name": "Show desktop notification",
1114
+ "description": "Show an urgent Chrome desktop notification from Owletto. No-ops when the user has not granted the optional notifications permission.",
1115
+ "inputSchema": {
1116
+ "type": "object",
1117
+ "required": [
1118
+ "title"
1119
+ ],
1120
+ "properties": {
1121
+ "title": {
1122
+ "type": "string",
1123
+ "maxLength": 80
1124
+ },
1125
+ "message": {
1126
+ "type": "string",
1127
+ "maxLength": 240
1128
+ },
1129
+ "body": {
1130
+ "type": "string",
1131
+ "maxLength": 240
1132
+ },
1133
+ "notification_id": {
1134
+ "type": "string",
1135
+ "maxLength": 120
1136
+ },
1137
+ "tab_id": {
1138
+ "type": "integer",
1139
+ "description": "Tab to focus when the notification is clicked. Falls back to click_url if the tab is gone."
1140
+ },
1141
+ "click_url": {
1142
+ "type": "string",
1143
+ "format": "uri",
1144
+ "description": "URL to open when clicked if tab_id is absent or the tab no longer exists."
1145
+ },
1146
+ "landed_url": {
1147
+ "type": "string",
1148
+ "format": "uri"
1149
+ }
1150
+ }
1151
+ },
1152
+ "outputSchema": {
1153
+ "type": "object",
1154
+ "properties": {
1155
+ "shown": {
1156
+ "type": "boolean"
1157
+ },
1158
+ "reason": {
1159
+ "type": "string"
1160
+ },
1161
+ "notification_id": {
1162
+ "type": "string"
1163
+ },
1164
+ "outcome": {
1165
+ "enum": [
1166
+ "confirmed",
1167
+ "unverifiable",
1168
+ "no_change"
1169
+ ],
1170
+ "description": "What a read-back after the action showed: confirmed (the effect is there), no_change (the page is as it was), unverifiable (nothing could be read back)."
1171
+ }
1172
+ }
1173
+ }
1174
+ },
1175
+ "network_intercept_start": {
1176
+ "key": "network_intercept_start",
1177
+ "name": "Start network interception",
1178
+ "description": "Attach CDP Network and start buffering response bodies whose URL matches one of `patterns`. Returns a `session_id` the caller uses with drain/stop. Idempotent on resume — passing the same `session_id` is a no-op after a service-worker eviction. Survives SW eviction (buffer persisted to chrome.storage.session).",
1179
+ "inputSchema": {
1180
+ "type": "object",
1181
+ "required": [
1182
+ "patterns"
1183
+ ],
1184
+ "properties": {
1185
+ "tab_id": {
1186
+ "type": "integer",
1187
+ "description": "Tab to act on. Defaults to the run-scoped scratch tab."
1188
+ },
1189
+ "session_id": {
1190
+ "type": "string",
1191
+ "description": "Reuse an existing session id. Mints a fresh one when omitted."
1192
+ },
1193
+ "patterns": {
1194
+ "type": "array",
1195
+ "minItems": 1,
1196
+ "items": {
1197
+ "oneOf": [
1198
+ {
1199
+ "type": "string",
1200
+ "description": "URL glob (** = any path; * = path segment)."
1201
+ },
1202
+ {
1203
+ "type": "object",
1204
+ "required": [
1205
+ "regex"
1206
+ ],
1207
+ "properties": {
1208
+ "regex": {
1209
+ "type": "string"
1210
+ },
1211
+ "flags": {
1212
+ "type": "string"
1213
+ }
1214
+ },
1215
+ "description": "RegExp serialized for the wire."
1216
+ }
1217
+ ]
1218
+ },
1219
+ "description": "URL patterns to capture. Matched against response.url at receive time."
1220
+ },
1221
+ "max_buffer_responses": {
1222
+ "type": "integer",
1223
+ "minimum": 1,
1224
+ "maximum": 1000,
1225
+ "description": "FIFO buffer cap per session. Default 100."
1226
+ },
1227
+ "max_body_bytes": {
1228
+ "type": "integer",
1229
+ "minimum": 1024,
1230
+ "maximum": 10485760,
1231
+ "description": "Per-response body cap. Bodies above are truncated. Default 1 MiB."
1232
+ }
1233
+ }
1234
+ },
1235
+ "outputSchema": {
1236
+ "type": "object",
1237
+ "properties": {
1238
+ "session_id": {
1239
+ "type": "string"
1240
+ },
1241
+ "tab_id": {
1242
+ "type": "integer"
1243
+ },
1244
+ "resumed": {
1245
+ "type": "boolean"
1246
+ }
1247
+ }
1248
+ }
1249
+ },
1250
+ "network_intercept_drain": {
1251
+ "key": "network_intercept_drain",
1252
+ "name": "Drain buffered network responses",
1253
+ "description": "Return all buffered intercepted responses for a session, atomically clearing the buffer.",
1254
+ "inputSchema": {
1255
+ "type": "object",
1256
+ "required": [
1257
+ "session_id"
1258
+ ],
1259
+ "properties": {
1260
+ "session_id": {
1261
+ "type": "string"
1262
+ }
1263
+ }
1264
+ },
1265
+ "outputSchema": {
1266
+ "type": "object",
1267
+ "properties": {
1268
+ "session_id": {
1269
+ "type": "string"
1270
+ },
1271
+ "drained": {
1272
+ "type": "integer"
1273
+ },
1274
+ "missing": {
1275
+ "type": "boolean"
1276
+ },
1277
+ "responses": {
1278
+ "type": "array",
1279
+ "items": {
1280
+ "type": "object",
1281
+ "properties": {
1282
+ "url": {
1283
+ "type": "string"
1284
+ },
1285
+ "status": {
1286
+ "type": "integer"
1287
+ },
1288
+ "mime": {
1289
+ "type": "string"
1290
+ },
1291
+ "body": {
1292
+ "type": "string"
1293
+ },
1294
+ "base64_encoded": {
1295
+ "type": "boolean"
1296
+ },
1297
+ "truncated": {
1298
+ "type": "boolean"
1299
+ },
1300
+ "ts": {
1301
+ "type": "integer"
1302
+ }
1303
+ }
1304
+ }
1305
+ }
1306
+ }
1307
+ }
1308
+ },
1309
+ "network_intercept_replay": {
1310
+ "key": "network_intercept_replay",
1311
+ "name": "Replay intercepted GET",
1312
+ "description": "Replay the latest matching browser GET with a replacement URL. Authorization headers and cookies stay inside the signed-in browser; the response is captured by the session and returned by drain.",
1313
+ "inputSchema": {
1314
+ "type": "object",
1315
+ "required": [
1316
+ "session_id",
1317
+ "url"
1318
+ ],
1319
+ "properties": {
1320
+ "session_id": {
1321
+ "type": "string"
1322
+ },
1323
+ "url": {
1324
+ "type": "string",
1325
+ "format": "uri",
1326
+ "description": "HTTPS URL on the captured request's origin that still matches the session patterns."
1327
+ }
1328
+ }
1329
+ },
1330
+ "outputSchema": {
1331
+ "type": "object",
1332
+ "properties": {
1333
+ "session_id": {
1334
+ "type": "string"
1335
+ },
1336
+ "requested": {
1337
+ "type": "boolean"
1338
+ },
1339
+ "ok": {
1340
+ "type": "boolean"
1341
+ },
1342
+ "status": {
1343
+ "type": "integer"
1344
+ }
1345
+ }
1346
+ }
1347
+ },
1348
+ "network_intercept_stop": {
1349
+ "key": "network_intercept_stop",
1350
+ "name": "Stop network interception",
1351
+ "description": "Remove the CDP listener for the session and delete its buffer. Detaches the debugger when this is the last live session on the tab.",
1352
+ "inputSchema": {
1353
+ "type": "object",
1354
+ "required": [
1355
+ "session_id"
1356
+ ],
1357
+ "properties": {
1358
+ "session_id": {
1359
+ "type": "string"
1360
+ }
1361
+ }
1362
+ }
1363
+ },
1364
+ "console_capture_start": {
1365
+ "key": "console_capture_start",
1366
+ "name": "Start console capture",
1367
+ "description": "Attach CDP Runtime and start buffering console output (console.log/warn/error/... and uncaught exceptions) from the tab. Returns a `session_id` the caller uses with drain/stop. Idempotent on resume — passing the same `session_id` is a no-op after a service-worker eviction. Survives SW eviction (buffer persisted to chrome.storage.session).",
1368
+ "inputSchema": {
1369
+ "type": "object",
1370
+ "properties": {
1371
+ "tab_id": {
1372
+ "type": "integer",
1373
+ "description": "Tab to act on. Defaults to the run-scoped scratch tab."
1374
+ },
1375
+ "session_id": {
1376
+ "type": "string",
1377
+ "description": "Reuse an existing session id. Mints a fresh one when omitted."
1378
+ },
1379
+ "max_buffer_entries": {
1380
+ "type": "integer",
1381
+ "minimum": 1,
1382
+ "maximum": 2000,
1383
+ "description": "FIFO buffer cap per session. Default 200."
1384
+ },
1385
+ "max_message_bytes": {
1386
+ "type": "integer",
1387
+ "minimum": 256,
1388
+ "maximum": 1048576,
1389
+ "description": "Per-entry text cap. Longer messages are truncated. Default 8 KiB."
1390
+ }
1391
+ }
1392
+ },
1393
+ "outputSchema": {
1394
+ "type": "object",
1395
+ "properties": {
1396
+ "session_id": {
1397
+ "type": "string"
1398
+ },
1399
+ "tab_id": {
1400
+ "type": "integer"
1401
+ },
1402
+ "resumed": {
1403
+ "type": "boolean"
1404
+ }
1405
+ }
1406
+ }
1407
+ },
1408
+ "console_capture_drain": {
1409
+ "key": "console_capture_drain",
1410
+ "name": "Drain buffered console output",
1411
+ "description": "Return all buffered console entries for a session as text (one line per entry), atomically clearing the buffer.",
1412
+ "inputSchema": {
1413
+ "type": "object",
1414
+ "required": [
1415
+ "session_id"
1416
+ ],
1417
+ "properties": {
1418
+ "session_id": {
1419
+ "type": "string"
1420
+ }
1421
+ }
1422
+ },
1423
+ "outputSchema": {
1424
+ "type": "object",
1425
+ "properties": {
1426
+ "session_id": {
1427
+ "type": "string"
1428
+ },
1429
+ "text": {
1430
+ "type": "string"
1431
+ },
1432
+ "drained": {
1433
+ "type": "integer"
1434
+ },
1435
+ "missing": {
1436
+ "type": "boolean"
1437
+ }
1438
+ }
1439
+ }
1440
+ },
1441
+ "console_capture_stop": {
1442
+ "key": "console_capture_stop",
1443
+ "name": "Stop console capture",
1444
+ "description": "Remove the CDP listener for the session and delete its buffer. Detaches the debugger when this is the last live session on the tab.",
1445
+ "inputSchema": {
1446
+ "type": "object",
1447
+ "required": [
1448
+ "session_id"
1449
+ ],
1450
+ "properties": {
1451
+ "session_id": {
1452
+ "type": "string"
1453
+ }
1454
+ }
1455
+ }
1456
+ },
1457
+ "evaluate": {
1458
+ "key": "evaluate",
1459
+ "name": "Evaluate JS",
1460
+ "description": "Last-resort escape hatch: run a JS expression with Runtime.evaluate and return the JSON-serialised result. Prefer ref-based actions when possible — scripts are harder to audit. Its outcome is always unverifiable: read the effect back yourself.",
1461
+ "inputSchema": {
1462
+ "type": "object",
1463
+ "required": [
1464
+ "expression"
1465
+ ],
1466
+ "properties": {
1467
+ "expression": {
1468
+ "type": "string"
1469
+ },
1470
+ "tab_id": {
1471
+ "type": "integer",
1472
+ "description": "Tab to act on. Defaults to the run-scoped scratch tab."
1473
+ },
1474
+ "await_promise": {
1475
+ "type": "boolean",
1476
+ "description": "Default true."
1477
+ }
1478
+ }
1479
+ },
1480
+ "outputSchema": {
1481
+ "type": "object",
1482
+ "properties": {
1483
+ "value": {},
1484
+ "exception": {
1485
+ "type": "string"
1486
+ },
1487
+ "outcome": {
1488
+ "enum": [
1489
+ "confirmed",
1490
+ "unverifiable",
1491
+ "no_change"
1492
+ ],
1493
+ "description": "What a read-back after the action showed: confirmed (the effect is there), no_change (the page is as it was), unverifiable (nothing could be read back)."
1494
+ }
1495
+ }
1496
+ }
1497
+ },
1498
+ "feed_listen": {
1499
+ "name": "Listen to connector feed",
1500
+ "description": "Attach a connector-owned page observer transport and read its buffered records. Requires an active parent feed sync; source code and filtering belong to that connector.",
1501
+ "kind": "write",
1502
+ "inputSchema": {
1503
+ "type": "object",
1504
+ "required": [
1505
+ "tab_id"
1506
+ ],
1507
+ "properties": {
1508
+ "tab_id": {
1509
+ "type": "integer"
1510
+ }
1511
+ }
1512
+ }
1513
+ }
1514
+ },
1515
+ "manifest_hash": "eb5a47ee55ffa8ddcb026ccbb5118f78810c93daf5a1ad4d863c040243034884"
1516
+ }