@yielded/agent 0.1.0-beta.173 → 0.1.0-beta.174

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 (226) hide show
  1. package/dist/{Admin-BX9ns28E.d.mts → Admin-BHmp2V9p.d.mts} +25 -16
  2. package/dist/{Agent-9aBoIi74.d.mts → Agent-B39jRnFv.d.mts} +2 -2
  3. package/dist/{Agent-0WvBWWbM.mjs → Agent-BiRbr73L.mjs} +7 -6
  4. package/dist/Agent-BiRbr73L.mjs.map +1 -0
  5. package/dist/{AgentRuntime-CQ-qcETl.mjs → AgentRuntime-B6qZlD3f.mjs} +199 -191
  6. package/dist/AgentRuntime-B6qZlD3f.mjs.map +1 -0
  7. package/dist/{AgentRuntime-BfP14534.d.mts → AgentRuntime-BD3ZHAMq.d.mts} +10 -10
  8. package/dist/{Digest-DCuPlhNk.mjs → Digest-EpeqWEdv.mjs} +41 -14
  9. package/dist/Digest-EpeqWEdv.mjs.map +1 -0
  10. package/dist/{DurableAgentRuntime-BAmSkWYr.mjs → DurableAgentRuntime-CBBjRNJN.mjs} +1447 -1424
  11. package/dist/DurableAgentRuntime-CBBjRNJN.mjs.map +1 -0
  12. package/dist/{EventSource-BwliwQz9.d.mts → EventSource-C9aaJaXT.d.mts} +2 -2
  13. package/dist/{MessageDelivery-B943ebI_.d.mts → MessageDelivery-BGDm-c46.d.mts} +42 -42
  14. package/dist/{Messaging-C_6OOg_s.d.mts → Messaging-SVu6rWV8.d.mts} +12 -6
  15. package/dist/{MessagingHost-B8oKM7AC.d.mts → MessagingHost-C6SOAcoG.d.mts} +2 -2
  16. package/dist/{Output-Dsx6k52t.d.mts → Output-CRamN1Fy.d.mts} +2 -2
  17. package/dist/{PreparedInputAdmission-CxSJSiTl.d.mts → PreparedInputAdmission-BvDqlgiP.d.mts} +3 -3
  18. package/dist/{RunContinuation-DHYNAQFi.mjs → RunContinuation-4ZATcVLB.mjs} +113 -56
  19. package/dist/RunContinuation-4ZATcVLB.mjs.map +1 -0
  20. package/dist/{RunContinuation-FHM7XPjq.d.mts → RunContinuation-CTJ1jGrO.d.mts} +6 -6
  21. package/dist/{RunJournal-kfKVxJj7.mjs → RunJournal-CNZqA3Ge.mjs} +33 -5
  22. package/dist/RunJournal-CNZqA3Ge.mjs.map +1 -0
  23. package/dist/{RunOptions-D8zxFIrZ.d.mts → RunOptions-Be77lKVZ.d.mts} +2 -2
  24. package/dist/{RunStorage-uqPxps09.mjs → RunStorage-BHjuuERI.mjs} +9 -6
  25. package/dist/RunStorage-BHjuuERI.mjs.map +1 -0
  26. package/dist/{Scheduling-CVyfXlBR.mjs → Scheduling-NG8slKdI.mjs} +11 -11
  27. package/dist/Scheduling-NG8slKdI.mjs.map +1 -0
  28. package/dist/{Subagent-vpffemql.mjs → Subagent-CTIpnzlB.mjs} +53 -40
  29. package/dist/Subagent-CTIpnzlB.mjs.map +1 -0
  30. package/dist/{Subagent-E6tvd7-k.d.mts → Subagent-DKhZA72u.d.mts} +19 -8
  31. package/dist/{SubagentHost-B6w2m-SI.d.mts → SubagentHost-D1xBgn9g.d.mts} +2 -2
  32. package/dist/{Subscription-DONig54Q.d.mts → Subscription-BNg9VCRl.d.mts} +2 -2
  33. package/dist/{SubscriptionInput-mJIRxWJM.d.mts → SubscriptionInput-BUoXv-_K.d.mts} +2 -2
  34. package/dist/{ThreadImport-DpHxjBrA.d.mts → ThreadImport-CMgzttvr.d.mts} +5 -5
  35. package/dist/{ThreadImport-DckUMEqJ.mjs → ThreadImport-CodYoJoa.mjs} +7 -7
  36. package/dist/ThreadImport-CodYoJoa.mjs.map +1 -0
  37. package/dist/{ThreadStore-CEekRa80.mjs → ThreadStore-59uDGXul.mjs} +163 -84
  38. package/dist/ThreadStore-59uDGXul.mjs.map +1 -0
  39. package/dist/{ThreadTransfer-B4gTQLIl.mjs → ThreadTransfer-3jigUl3g.mjs} +3 -3
  40. package/dist/{ThreadTransfer-B4gTQLIl.mjs.map → ThreadTransfer-3jigUl3g.mjs.map} +1 -1
  41. package/dist/{WorkerAdmission-DFVbbVh2.mjs → WorkerAdmission-DDYJdOsU.mjs} +4 -4
  42. package/dist/{WorkerAdmission-DFVbbVh2.mjs.map → WorkerAdmission-DDYJdOsU.mjs.map} +1 -1
  43. package/dist/{agent-registration-ByMZ_cK5.mjs → agent-registration-DRbyhAu-.mjs} +69 -56
  44. package/dist/agent-registration-DRbyhAu-.mjs.map +1 -0
  45. package/dist/capabilities/Approval.mjs +2 -2
  46. package/dist/capabilities/Approval.mjs.map +1 -1
  47. package/dist/capabilities/BrowserUse.d.mts +102 -1867
  48. package/dist/capabilities/BrowserUse.mjs +74 -798
  49. package/dist/capabilities/BrowserUse.mjs.map +1 -1
  50. package/dist/capabilities/Budget.mjs +3 -1
  51. package/dist/capabilities/Budget.mjs.map +1 -1
  52. package/dist/capabilities/CodeMode.d.mts +1 -1
  53. package/dist/capabilities/CodeMode.mjs +16 -9
  54. package/dist/capabilities/CodeMode.mjs.map +1 -1
  55. package/dist/capabilities/Commands.d.mts +1 -1
  56. package/dist/capabilities/McpClient.mjs +1 -1
  57. package/dist/capabilities/McpClient.mjs.map +1 -1
  58. package/dist/capabilities/Messaging.d.mts +1 -1
  59. package/dist/capabilities/Messaging.mjs +4 -4
  60. package/dist/capabilities/Messaging.mjs.map +1 -1
  61. package/dist/capabilities/ModelContext.mjs +7 -5
  62. package/dist/capabilities/ModelContext.mjs.map +1 -1
  63. package/dist/capabilities/Redaction.mjs +49 -19
  64. package/dist/capabilities/Redaction.mjs.map +1 -1
  65. package/dist/capabilities/RunHooks.d.mts +1 -1
  66. package/dist/capabilities/RunHooks.mjs +1 -1
  67. package/dist/capabilities/RunHooks.mjs.map +1 -1
  68. package/dist/capabilities/Subagent.d.mts +1 -1
  69. package/dist/capabilities/Subagent.mjs +1 -1
  70. package/dist/capabilities/SubagentReservations.mjs +3 -1
  71. package/dist/capabilities/SubagentReservations.mjs.map +1 -1
  72. package/dist/capabilities/WebCapture.mjs.map +1 -1
  73. package/dist/capabilities/WebSearch.mjs +7 -7
  74. package/dist/capabilities/WebSearch.mjs.map +1 -1
  75. package/dist/core/Agent.d.mts +1 -1
  76. package/dist/core/Agent.mjs +1 -1
  77. package/dist/core/AgentUpdates.mjs +8 -8
  78. package/dist/core/AgentUpdates.mjs.map +1 -1
  79. package/dist/core/Thread.mjs +1 -1
  80. package/dist/core/Thread.mjs.map +1 -1
  81. package/dist/core/Usage.mjs +2 -2
  82. package/dist/core/Usage.mjs.map +1 -1
  83. package/dist/durable/Admin.d.mts +1 -1
  84. package/dist/durable/AgentRegistration.d.mts +1 -1
  85. package/dist/durable/AgentRegistration.mjs +1 -1
  86. package/dist/durable/Certification.d.mts +1 -1
  87. package/dist/durable/CommittedActivity.d.mts +1 -1
  88. package/dist/durable/CommittedActivity.mjs +2 -2
  89. package/dist/durable/Digest.mjs +1 -1
  90. package/dist/durable/DurableAgentRuntime.d.mts +1 -1
  91. package/dist/durable/DurableAgentRuntime.mjs +2 -2
  92. package/dist/durable/EventSource.d.mts +1 -1
  93. package/dist/durable/EventSource.mjs +6 -6
  94. package/dist/durable/EventSource.mjs.map +1 -1
  95. package/dist/durable/GitHubWorkflowSource.d.mts +3 -3
  96. package/dist/durable/LifecyclePublication.d.mts +1 -1
  97. package/dist/durable/LifecyclePublication.mjs +1 -1
  98. package/dist/durable/MessageDelivery.d.mts +1 -1
  99. package/dist/durable/MessageDelivery.mjs +1 -1
  100. package/dist/durable/MessageDeliveryStoreConformance.d.mts +2 -2
  101. package/dist/durable/MessageDeliveryStoreConformance.mjs +1 -1
  102. package/dist/durable/PersistentHistory.d.mts +1 -1
  103. package/dist/durable/PersistentHistory.mjs +3 -3
  104. package/dist/durable/PreparedInputAdmission.d.mts +1 -1
  105. package/dist/durable/RecordFormat.mjs +2 -2
  106. package/dist/durable/RecordFormat.mjs.map +1 -1
  107. package/dist/durable/Recovery.d.mts +1 -1
  108. package/dist/durable/RunContinuation.d.mts +2 -2
  109. package/dist/durable/RunContinuation.mjs +2 -2
  110. package/dist/durable/RunJournal.d.mts +1 -1
  111. package/dist/durable/RunJournal.mjs +1 -1
  112. package/dist/durable/RunStorage.d.mts +1 -1
  113. package/dist/durable/RunStorage.mjs +1 -1
  114. package/dist/durable/Scheduling.d.mts +1 -1
  115. package/dist/durable/Scheduling.mjs +1 -1
  116. package/dist/durable/SettlementPublisher.d.mts +1 -1
  117. package/dist/durable/SettlementPublisher.mjs +2 -2
  118. package/dist/durable/SubmissionLedger.d.mts +1 -1
  119. package/dist/durable/SubmissionLedger.mjs +5 -1
  120. package/dist/durable/SubmissionLedger.mjs.map +1 -1
  121. package/dist/durable/SubmissionLedgerConformance.d.mts +1 -1
  122. package/dist/durable/SubmissionLedgerConformance.mjs +4 -4
  123. package/dist/durable/SubmissionStatus.d.mts +1 -1
  124. package/dist/durable/Subscription.d.mts +1 -1
  125. package/dist/durable/SubscriptionInput.d.mts +1 -1
  126. package/dist/durable/SubscriptionInput.mjs +3 -3
  127. package/dist/durable/SubscriptionInput.mjs.map +1 -1
  128. package/dist/durable/SubscriptionStoreConformance.d.mts +1 -1
  129. package/dist/durable/SubscriptionStoreConformance.mjs +2 -2
  130. package/dist/durable/SubscriptionStoreConformance.mjs.map +1 -1
  131. package/dist/durable/SubscriptionTools.d.mts +2 -2
  132. package/dist/durable/SubscriptionTransition.d.mts +1 -1
  133. package/dist/durable/Subscriptions.d.mts +5 -5
  134. package/dist/durable/Subscriptions.mjs +2 -2
  135. package/dist/durable/Subscriptions.mjs.map +1 -1
  136. package/dist/durable/ThreadArchiveRange.d.mts +1 -1
  137. package/dist/durable/ThreadContextHistory.d.mts +1 -1
  138. package/dist/durable/ThreadContextHistory.mjs +1 -1
  139. package/dist/durable/ThreadImport.d.mts +1 -1
  140. package/dist/durable/ThreadImport.mjs +1 -1
  141. package/dist/durable/ThreadInvariants.d.mts +3 -3
  142. package/dist/durable/ThreadInvariants.mjs +4 -4
  143. package/dist/durable/ThreadInvariants.mjs.map +1 -1
  144. package/dist/durable/ThreadProjectionMaintenance.d.mts +1 -1
  145. package/dist/durable/ThreadReader.d.mts +1 -1
  146. package/dist/durable/ThreadReader.mjs +1 -1
  147. package/dist/durable/ThreadStore.d.mts +1 -1
  148. package/dist/durable/ThreadStore.mjs +1 -1
  149. package/dist/durable/ThreadStoreConformance.d.mts +1 -1
  150. package/dist/durable/ThreadStoreConformance.mjs +3 -3
  151. package/dist/durable/ThreadTransfer.d.mts +1 -1
  152. package/dist/durable/ThreadTransfer.mjs +1 -1
  153. package/dist/durable/ThreadWork.d.mts +1 -1
  154. package/dist/durable/ThreadWork.mjs +4 -4
  155. package/dist/durable/ThreadWork.mjs.map +1 -1
  156. package/dist/durable/WorkerAdmission.d.mts +1 -1
  157. package/dist/durable/WorkerAdmission.mjs +1 -1
  158. package/dist/durable/WorkerHost.d.mts +2 -2
  159. package/dist/engine/AgentRuntime.d.mts +1 -1
  160. package/dist/engine/AgentRuntime.mjs +1 -1
  161. package/dist/engine/MessagingHost.d.mts +1 -1
  162. package/dist/engine/Output.d.mts +1 -1
  163. package/dist/engine/RunOptions.d.mts +1 -1
  164. package/dist/engine/SubagentHost.d.mts +1 -1
  165. package/dist/index.d.mts +19 -19
  166. package/dist/index.mjs +14 -14
  167. package/dist/{run-context-reader-OcsZr4bk.d.mts → run-context-reader-CC7ZD95F.d.mts} +2 -2
  168. package/package.json +1 -1
  169. package/src/capabilities/Approval.ts +58 -60
  170. package/src/capabilities/BrowserUse.ts +89 -944
  171. package/src/capabilities/Budget.ts +8 -1
  172. package/src/capabilities/CodeMode.ts +57 -33
  173. package/src/capabilities/McpClient.ts +2 -2
  174. package/src/capabilities/Messaging.ts +51 -55
  175. package/src/capabilities/ModelContext.ts +5 -2
  176. package/src/capabilities/Redaction.ts +64 -34
  177. package/src/capabilities/RunHooks.ts +52 -55
  178. package/src/capabilities/Subagent.ts +33 -33
  179. package/src/capabilities/SubagentReservations.ts +9 -1
  180. package/src/capabilities/WebCapture.ts +6 -0
  181. package/src/capabilities/WebSearch.ts +10 -7
  182. package/src/capabilities/internal/subagent-background.ts +202 -158
  183. package/src/core/Agent.ts +11 -6
  184. package/src/core/AgentUpdates.ts +8 -8
  185. package/src/core/Thread.ts +9 -10
  186. package/src/core/Usage.ts +7 -8
  187. package/src/core/internal/agent-updates.ts +1 -0
  188. package/src/durable/DurableAgentRuntime.ts +645 -625
  189. package/src/durable/EventSource.ts +15 -9
  190. package/src/durable/RecordFormat.ts +5 -3
  191. package/src/durable/RunContinuation.ts +233 -81
  192. package/src/durable/RunJournal.ts +10 -9
  193. package/src/durable/RunStorage.ts +122 -124
  194. package/src/durable/Scheduling.ts +639 -651
  195. package/src/durable/SubmissionLedger.ts +4 -0
  196. package/src/durable/SubscriptionInput.ts +5 -3
  197. package/src/durable/SubscriptionStoreConformance.ts +23 -23
  198. package/src/durable/Subscriptions.ts +18 -19
  199. package/src/durable/ThreadImport.ts +18 -19
  200. package/src/durable/ThreadInvariants.ts +2 -1
  201. package/src/durable/ThreadStore.ts +215 -111
  202. package/src/durable/ThreadWork.ts +1 -2
  203. package/src/durable/internal/StorageOwner.ts +10 -4
  204. package/src/durable/internal/agent-registration.ts +96 -89
  205. package/src/durable/internal/canonical-json.ts +61 -20
  206. package/src/durable/internal/prompt-history-cache.ts +13 -4
  207. package/src/durable/internal/record-encoding.ts +120 -64
  208. package/src/durable/internal/schedule-time.ts +6 -6
  209. package/src/durable/internal/usage-totals.ts +38 -0
  210. package/src/durable/internal/worker-host.ts +69 -74
  211. package/src/engine/internal/agent-runtime.ts +1067 -1018
  212. package/src/engine/internal/provisional-text.ts +12 -10
  213. package/src/engine/internal/tool-exposure.ts +22 -18
  214. package/src/engine/internal/tool-telemetry.ts +12 -7
  215. package/dist/Agent-0WvBWWbM.mjs.map +0 -1
  216. package/dist/AgentRuntime-CQ-qcETl.mjs.map +0 -1
  217. package/dist/Digest-DCuPlhNk.mjs.map +0 -1
  218. package/dist/DurableAgentRuntime-BAmSkWYr.mjs.map +0 -1
  219. package/dist/RunContinuation-DHYNAQFi.mjs.map +0 -1
  220. package/dist/RunJournal-kfKVxJj7.mjs.map +0 -1
  221. package/dist/RunStorage-uqPxps09.mjs.map +0 -1
  222. package/dist/Scheduling-CVyfXlBR.mjs.map +0 -1
  223. package/dist/Subagent-vpffemql.mjs.map +0 -1
  224. package/dist/ThreadImport-DckUMEqJ.mjs.map +0 -1
  225. package/dist/ThreadStore-CEekRa80.mjs.map +0 -1
  226. package/dist/agent-registration-ByMZ_cK5.mjs.map +0 -1
@@ -1,1933 +1,168 @@
1
+ import { CodeExecutionLimits } from "../sandbox/CodeExecutor.mjs";
2
+ import { CodeModeDefinition, t as CodeMode_d_exports } from "./CodeMode.mjs";
1
3
  import { Context, Effect, Schema } from "effect";
2
- import { DecisionModel, LanguageModel, Tool, Toolkit } from "effect/ai";
4
+ import { Tool } from "effect/ai";
3
5
  declare namespace BrowserUse_d_exports {
4
- export { ActOptions, Action, ActionResult, BrowserActions, BrowserControl, BrowserUseError, Control, DialogRequest, InspectRequest, JevOptions, JevResult, JevStep, JevStop, NavigateRequest, Observation, PageMetrics, PressRequest, Ref, Screenshot, ScrollRequest, TabRequest, WaitRequest, browserLayer, browserTools, make, runJev };
6
+ export { BrowserCdp, BrowserUseError, CloseTabRequest, FrameInfo, FramesRequest, SendRequest, Tab, TargetId, layer, make };
5
7
  }
6
- export declare const Ref: Schema.String;
7
- export declare const Action: Schema.Union<readonly [Schema.Struct<{
8
- readonly kind: Schema.Literal<"click">;
9
- readonly ref: Schema.String;
10
- }>, Schema.Struct<{
11
- readonly kind: Schema.Literal<"fill">;
12
- readonly ref: Schema.String;
13
- readonly value: Schema.String;
14
- }>, Schema.Struct<{
15
- readonly kind: Schema.Literal<"select">;
16
- readonly ref: Schema.String;
17
- readonly value: Schema.String;
18
- }>]>;
19
- export type Action = typeof Action.Type;
20
- export declare const Control: Schema.Struct<{
21
- readonly ref: Schema.String;
22
- readonly kind: Schema.String;
23
- readonly name: Schema.String;
24
- readonly value: Schema.String;
25
- readonly options: Schema.$Array<Schema.String>;
26
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
27
- readonly value: Schema.String;
28
- readonly label: Schema.String;
29
- readonly disabled: Schema.Boolean;
30
- readonly selected: Schema.Boolean;
31
- readonly index: Schema.optionalKey<Schema.Natural>;
32
- }>>>;
33
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
34
- readonly frame: Schema.optionalKey<Schema.String>;
35
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
36
- readonly editable: Schema.optionalKey<Schema.Boolean>;
37
- readonly checked: Schema.optionalKey<Schema.Boolean>;
38
- /** Observed CSS evidence, never a substitute for native input revalidation. */
39
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
40
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
41
- }>;
42
- /** Main-document metrics. Jev observations include them; scrolling is offered only when possible. */
43
- export declare const PageMetrics: Schema.Struct<{
8
+ export declare const TargetId: Schema.NonEmptyString;
9
+ export declare const SendRequest: Schema.Struct<{
10
+ readonly method: Schema.String;
11
+ readonly params: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
12
+ /** Omit to address the session's original page. Discover other pages with cdp.tabs(). */
13
+ readonly targetId: Schema.optionalKey<Schema.NonEmptyString>;
14
+ /** Route to a frame's CDP session, including out-of-process frames. Obtain IDs with cdp.frames(). */
15
+ readonly frameId: Schema.optionalKey<Schema.NonEmptyString>;
16
+ }>;
17
+ export declare const Tab: Schema.Struct<{
18
+ readonly targetId: Schema.NonEmptyString;
19
+ readonly url: Schema.String;
44
20
  readonly title: Schema.String;
45
- readonly scrollY: Schema.Number;
46
- readonly viewportHeight: Schema.Number;
47
- readonly documentHeight: Schema.Number;
48
21
  }>;
49
- export declare const Observation: Schema.Struct<{
50
- readonly text: Schema.String;
51
- readonly controls: Schema.$Array<Schema.Struct<{
52
- readonly ref: Schema.String;
53
- readonly kind: Schema.String;
54
- readonly name: Schema.String;
55
- readonly value: Schema.String;
56
- readonly options: Schema.$Array<Schema.String>;
57
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
58
- readonly value: Schema.String;
59
- readonly label: Schema.String;
60
- readonly disabled: Schema.Boolean;
61
- readonly selected: Schema.Boolean;
62
- readonly index: Schema.optionalKey<Schema.Natural>;
63
- }>>>;
64
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
65
- readonly frame: Schema.optionalKey<Schema.String>;
66
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
67
- readonly editable: Schema.optionalKey<Schema.Boolean>;
68
- readonly checked: Schema.optionalKey<Schema.Boolean>;
69
- /** Observed CSS evidence, never a substitute for native input revalidation. */
70
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
71
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
72
- }>>;
73
- readonly page: Schema.optionalKey<Schema.Struct<{
74
- readonly title: Schema.String;
75
- readonly scrollY: Schema.Number;
76
- readonly viewportHeight: Schema.Number;
77
- readonly documentHeight: Schema.Number;
78
- }>>;
79
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
80
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
81
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
82
- readonly ref: Schema.String;
83
- readonly name: Schema.String;
84
- readonly url: Schema.String;
85
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
86
- }>>>;
87
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
88
- readonly ref: Schema.String;
89
- readonly url: Schema.String;
90
- readonly active: Schema.Boolean;
91
- }>>>;
92
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
93
- readonly ref: Schema.String;
94
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
95
- readonly message: Schema.String;
96
- readonly defaultValue: Schema.String;
97
- }>>>;
22
+ export declare const CloseTabRequest: Schema.Struct<{
23
+ readonly targetId: Schema.NonEmptyString;
98
24
  }>;
99
- export declare const ActionResult: Schema.Struct<{
100
- readonly completed: Schema.Natural;
101
- readonly error: Schema.NullOr<Schema.String>;
102
- readonly observation: Schema.NullOr<Schema.Struct<{
103
- readonly text: Schema.String;
104
- readonly controls: Schema.$Array<Schema.Struct<{
105
- readonly ref: Schema.String;
106
- readonly kind: Schema.String;
107
- readonly name: Schema.String;
108
- readonly value: Schema.String;
109
- readonly options: Schema.$Array<Schema.String>;
110
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
111
- readonly value: Schema.String;
112
- readonly label: Schema.String;
113
- readonly disabled: Schema.Boolean;
114
- readonly selected: Schema.Boolean;
115
- readonly index: Schema.optionalKey<Schema.Natural>;
116
- }>>>;
117
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
118
- readonly frame: Schema.optionalKey<Schema.String>;
119
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
120
- readonly editable: Schema.optionalKey<Schema.Boolean>;
121
- readonly checked: Schema.optionalKey<Schema.Boolean>;
122
- /** Observed CSS evidence, never a substitute for native input revalidation. */
123
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
124
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
125
- }>>;
126
- readonly page: Schema.optionalKey<Schema.Struct<{
127
- readonly title: Schema.String;
128
- readonly scrollY: Schema.Number;
129
- readonly viewportHeight: Schema.Number;
130
- readonly documentHeight: Schema.Number;
131
- }>>;
132
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
133
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
134
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
135
- readonly ref: Schema.String;
136
- readonly name: Schema.String;
137
- readonly url: Schema.String;
138
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
139
- }>>>;
140
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
141
- readonly ref: Schema.String;
142
- readonly url: Schema.String;
143
- readonly active: Schema.Boolean;
144
- }>>>;
145
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
146
- readonly ref: Schema.String;
147
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
148
- readonly message: Schema.String;
149
- readonly defaultValue: Schema.String;
150
- }>>>;
151
- }>>;
152
- /** Input receipt is independent of the next observation and never authorizes replay. */
153
- readonly dispatch: Schema.optionalKey<Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>>;
154
- /** The same input may remain pending across successive dialog responses. Never replay it. */
155
- readonly pendingInput: Schema.optionalKey<Schema.Struct<{
156
- readonly ref: Schema.String;
157
- readonly reason: Schema.Literal<"dialog">;
158
- }>>;
159
- readonly settledInput: Schema.optionalKey<Schema.Struct<{
160
- readonly ref: Schema.String;
161
- readonly dispatch: Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>;
162
- }>>;
25
+ export declare const FramesRequest: Schema.Struct<{
26
+ readonly targetId: Schema.optionalKey<Schema.NonEmptyString>;
27
+ }>;
28
+ export declare const FrameInfo: Schema.Struct<{
29
+ readonly frameId: Schema.NonEmptyString;
30
+ readonly parentFrameId: Schema.NullOr<Schema.NonEmptyString>;
31
+ readonly url: Schema.String;
163
32
  }>;
164
33
  declare const BrowserUseError_base: Schema.Class<BrowserUseError, Schema.TaggedStruct<"BrowserUseError", {
165
34
  readonly code: Schema.Literals<readonly ["invalid", "browser"]>;
166
35
  readonly message: Schema.String;
167
- readonly dispatch: Schema.optionalKey<Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>>;
36
+ readonly dispatch: Schema.optionalKey<Schema.Literals<readonly ["not-dispatched", "possibly-dispatched"]>>;
168
37
  }>, import("effect/Cause").YieldableError>;
169
- /** Safe model-visible failure. Dispatch evidence belongs in ActionResult, never an automatic retry. */
38
+ /** A command may have changed the website even when its response is unavailable. Never replay it automatically. */
170
39
  export declare class BrowserUseError extends BrowserUseError_base {}
171
- /** Application-owned page adapter. Revalidate refs before input; stop a batch at its first failure.
172
- * Return acknowledged actions even if the following observation fails. Never replay uncertain input.
173
- */
174
- export interface ActOptions {
175
- /**
176
- * `false` skips the observation after input: the result's `observation` is null and every
177
- * observed ref is invalidated, so inspect before the next action. Defaults to `true`.
178
- */
179
- readonly observe?: boolean;
180
- }
181
- declare const BrowserActions_base: Context.ServiceClass<BrowserActions, "@effect-agent/BrowserUse/BrowserActions", {
182
- readonly observe: Effect.Effect<typeof Observation.Type, BrowserUseError>;
183
- readonly act: (actions: ReadonlyArray<Action>, options?: ActOptions) => Effect.Effect<typeof ActionResult.Type, BrowserUseError>;
184
- }>;
185
- export declare class BrowserActions extends BrowserActions_base {}
186
- export declare const InspectRequest: Schema.Struct<{
187
- readonly selector: Schema.optionalKey<Schema.NonEmptyString>;
188
- readonly frame: Schema.optionalKey<Schema.String>;
189
- /** Narrow select options by label or value while retaining current selections. */
190
- readonly optionFilter: Schema.optionalKey<Schema.NonEmptyString>;
191
- }>;
192
- export declare const WaitRequest: Schema.Struct<{
193
- readonly selector: Schema.NonEmptyString;
194
- readonly frame: Schema.optionalKey<Schema.String>;
195
- readonly state: Schema.Literals<readonly ["visible", "hidden", "enabled", "text"]>;
196
- /** Case-sensitive visible text qualifier for every state; required for `text`. */
197
- readonly text: Schema.optionalKey<Schema.String>;
198
- readonly timeoutMillis: Schema.Int;
199
- }>;
200
- export declare const ScrollRequest: Schema.Struct<{
201
- readonly ref: Schema.optionalKey<Schema.String>;
202
- readonly deltaX: Schema.Int;
203
- readonly deltaY: Schema.Int;
204
- }>;
205
- export declare const NavigateRequest: Schema.Struct<{
206
- readonly url: Schema.String;
207
- }>;
208
- export declare const Screenshot: Schema.Struct<{
209
- readonly mediaType: Schema.Literal<"image/png">;
210
- readonly base64: Schema.String;
211
- }>;
212
- export declare const PressRequest: Schema.Struct<{
213
- readonly ref: Schema.String;
214
- readonly key: Schema.Literals<readonly ["Enter", "Escape", "Tab", "ArrowDown", "ArrowUp", "ArrowLeft", "ArrowRight", "Home", "End", "Space", "Backspace", "Delete"]>;
215
- }>;
216
- export declare const TabRequest: Schema.Struct<{
217
- readonly ref: Schema.String;
218
- }>;
219
- export declare const DialogRequest: Schema.Struct<{
220
- readonly ref: Schema.String;
221
- readonly accept: Schema.Boolean;
222
- readonly text: Schema.optionalKey<Schema.String>;
223
- }>;
224
- declare const BrowserControl_base: Context.ServiceClass<BrowserControl, "@effect-agent/BrowserUse/BrowserControl", {
225
- readonly inspect: (request: typeof InspectRequest.Type) => Effect.Effect<typeof Observation.Type, BrowserUseError>;
226
- readonly navigate: (request: typeof NavigateRequest.Type) => Effect.Effect<typeof ActionResult.Type, BrowserUseError>;
227
- readonly scroll: (request: typeof ScrollRequest.Type) => Effect.Effect<typeof ActionResult.Type, BrowserUseError>;
228
- readonly wait: (request: typeof WaitRequest.Type) => Effect.Effect<typeof Observation.Type, BrowserUseError>;
229
- readonly screenshot: Effect.Effect<typeof Screenshot.Type, BrowserUseError>;
230
- readonly press: (request: typeof PressRequest.Type) => Effect.Effect<typeof ActionResult.Type, BrowserUseError>;
231
- readonly selectTab: (request: typeof TabRequest.Type) => Effect.Effect<typeof Observation.Type, BrowserUseError>;
232
- readonly respondDialog: (request: typeof DialogRequest.Type) => Effect.Effect<typeof ActionResult.Type, BrowserUseError>;
233
- }>;
234
- /** Bounded inspection and native operations, shared by ordinary tools and Code Mode.
235
- * Inspection accepts CSS, never page JavaScript. Host policy authorizes every call.
236
- */
237
- export declare class BrowserControl extends BrowserControl_base {}
238
- /** Add these tools to the same broker allowlist as act/observe for Code Mode. */
239
- export declare const browserTools: Toolkit.Toolkit<{
240
- readonly inspect: Tool.Tool<"inspect", {
40
+ declare const BrowserCdp_base: Context.ServiceClass<BrowserCdp, "@effect-agent/BrowserUse/BrowserCdp", {
41
+ readonly send: (request: typeof SendRequest.Type) => Effect.Effect<Schema.Json, BrowserUseError>;
42
+ readonly tabs: Effect.Effect<ReadonlyArray<typeof Tab.Type>, BrowserUseError>;
43
+ readonly frames: (request: typeof FramesRequest.Type) => Effect.Effect<ReadonlyArray<typeof FrameInfo.Type>, BrowserUseError>;
44
+ readonly newTab: Effect.Effect<typeof Tab.Type, BrowserUseError>;
45
+ readonly closeTab: (request: typeof CloseTabRequest.Type) => Effect.Effect<void, BrowserUseError>;
46
+ }>;
47
+ /** Host-owned CDP transport. The host authorizes every call and owns browser lifetime and limits. */
48
+ export declare class BrowserCdp extends BrowserCdp_base {}
49
+ /** Provide this layer to the Code Mode executor, backed by a scoped BrowserCdp adapter. */
50
+ export declare const layer: import("effect/Layer").Layer<Tool.HandlersFor<{
51
+ readonly browser_cdp_send: Tool.Tool<"browser_cdp_send", {
241
52
  readonly parameters: Schema.Struct<{
242
- readonly selector: Schema.optionalKey<Schema.NonEmptyString>;
243
- readonly frame: Schema.optionalKey<Schema.String>;
244
- /** Narrow select options by label or value while retaining current selections. */
245
- readonly optionFilter: Schema.optionalKey<Schema.NonEmptyString>;
246
- }>;
247
- readonly success: Schema.Struct<{
248
- readonly text: Schema.String;
249
- readonly controls: Schema.$Array<Schema.Struct<{
250
- readonly ref: Schema.String;
251
- readonly kind: Schema.String;
252
- readonly name: Schema.String;
253
- readonly value: Schema.String;
254
- readonly options: Schema.$Array<Schema.String>;
255
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
256
- readonly value: Schema.String;
257
- readonly label: Schema.String;
258
- readonly disabled: Schema.Boolean;
259
- readonly selected: Schema.Boolean;
260
- readonly index: Schema.optionalKey<Schema.Natural>;
261
- }>>>;
262
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
263
- readonly frame: Schema.optionalKey<Schema.String>;
264
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
265
- readonly editable: Schema.optionalKey<Schema.Boolean>;
266
- readonly checked: Schema.optionalKey<Schema.Boolean>;
267
- /** Observed CSS evidence, never a substitute for native input revalidation. */
268
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
269
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
270
- }>>;
271
- readonly page: Schema.optionalKey<Schema.Struct<{
272
- readonly title: Schema.String;
273
- readonly scrollY: Schema.Number;
274
- readonly viewportHeight: Schema.Number;
275
- readonly documentHeight: Schema.Number;
276
- }>>;
277
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
278
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
279
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
280
- readonly ref: Schema.String;
281
- readonly name: Schema.String;
282
- readonly url: Schema.String;
283
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
284
- }>>>;
285
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
286
- readonly ref: Schema.String;
287
- readonly url: Schema.String;
288
- readonly active: Schema.Boolean;
289
- }>>>;
290
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
291
- readonly ref: Schema.String;
292
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
293
- readonly message: Schema.String;
294
- readonly defaultValue: Schema.String;
295
- }>>>;
53
+ readonly method: Schema.String;
54
+ readonly params: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
55
+ /** Omit to address the session's original page. Discover other pages with cdp.tabs(). */
56
+ readonly targetId: Schema.optionalKey<Schema.NonEmptyString>;
57
+ /** Route to a frame's CDP session, including out-of-process frames. Obtain IDs with cdp.frames(). */
58
+ readonly frameId: Schema.optionalKey<Schema.NonEmptyString>;
296
59
  }>;
60
+ readonly success: Schema.Codec<Schema.Json, Schema.Json, never, never>;
297
61
  readonly failure: typeof BrowserUseError;
298
62
  readonly failureMode: "return";
299
63
  }, never>;
300
- readonly navigate: Tool.Tool<"navigate", {
64
+ readonly browser_close_tab: Tool.Tool<"browser_close_tab", {
301
65
  readonly parameters: Schema.Struct<{
302
- readonly url: Schema.String;
303
- }>;
304
- readonly success: Schema.Struct<{
305
- readonly completed: Schema.Natural;
306
- readonly error: Schema.NullOr<Schema.String>;
307
- readonly observation: Schema.NullOr<Schema.Struct<{
308
- readonly text: Schema.String;
309
- readonly controls: Schema.$Array<Schema.Struct<{
310
- readonly ref: Schema.String;
311
- readonly kind: Schema.String;
312
- readonly name: Schema.String;
313
- readonly value: Schema.String;
314
- readonly options: Schema.$Array<Schema.String>;
315
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
316
- readonly value: Schema.String;
317
- readonly label: Schema.String;
318
- readonly disabled: Schema.Boolean;
319
- readonly selected: Schema.Boolean;
320
- readonly index: Schema.optionalKey<Schema.Natural>;
321
- }>>>;
322
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
323
- readonly frame: Schema.optionalKey<Schema.String>;
324
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
325
- readonly editable: Schema.optionalKey<Schema.Boolean>;
326
- readonly checked: Schema.optionalKey<Schema.Boolean>;
327
- /** Observed CSS evidence, never a substitute for native input revalidation. */
328
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
329
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
330
- }>>;
331
- readonly page: Schema.optionalKey<Schema.Struct<{
332
- readonly title: Schema.String;
333
- readonly scrollY: Schema.Number;
334
- readonly viewportHeight: Schema.Number;
335
- readonly documentHeight: Schema.Number;
336
- }>>;
337
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
338
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
339
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
340
- readonly ref: Schema.String;
341
- readonly name: Schema.String;
342
- readonly url: Schema.String;
343
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
344
- }>>>;
345
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
346
- readonly ref: Schema.String;
347
- readonly url: Schema.String;
348
- readonly active: Schema.Boolean;
349
- }>>>;
350
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
351
- readonly ref: Schema.String;
352
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
353
- readonly message: Schema.String;
354
- readonly defaultValue: Schema.String;
355
- }>>>;
356
- }>>;
357
- /** Input receipt is independent of the next observation and never authorizes replay. */
358
- readonly dispatch: Schema.optionalKey<Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>>;
359
- /** The same input may remain pending across successive dialog responses. Never replay it. */
360
- readonly pendingInput: Schema.optionalKey<Schema.Struct<{
361
- readonly ref: Schema.String;
362
- readonly reason: Schema.Literal<"dialog">;
363
- }>>;
364
- readonly settledInput: Schema.optionalKey<Schema.Struct<{
365
- readonly ref: Schema.String;
366
- readonly dispatch: Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>;
367
- }>>;
368
- }>;
369
- readonly failure: typeof BrowserUseError;
370
- readonly failureMode: "return";
371
- }, never>;
372
- readonly press: Tool.Tool<"press", {
373
- readonly parameters: Schema.Struct<{
374
- readonly ref: Schema.String;
375
- readonly key: Schema.Literals<readonly ["Enter", "Escape", "Tab", "ArrowDown", "ArrowUp", "ArrowLeft", "ArrowRight", "Home", "End", "Space", "Backspace", "Delete"]>;
376
- }>;
377
- readonly success: Schema.Struct<{
378
- readonly completed: Schema.Natural;
379
- readonly error: Schema.NullOr<Schema.String>;
380
- readonly observation: Schema.NullOr<Schema.Struct<{
381
- readonly text: Schema.String;
382
- readonly controls: Schema.$Array<Schema.Struct<{
383
- readonly ref: Schema.String;
384
- readonly kind: Schema.String;
385
- readonly name: Schema.String;
386
- readonly value: Schema.String;
387
- readonly options: Schema.$Array<Schema.String>;
388
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
389
- readonly value: Schema.String;
390
- readonly label: Schema.String;
391
- readonly disabled: Schema.Boolean;
392
- readonly selected: Schema.Boolean;
393
- readonly index: Schema.optionalKey<Schema.Natural>;
394
- }>>>;
395
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
396
- readonly frame: Schema.optionalKey<Schema.String>;
397
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
398
- readonly editable: Schema.optionalKey<Schema.Boolean>;
399
- readonly checked: Schema.optionalKey<Schema.Boolean>;
400
- /** Observed CSS evidence, never a substitute for native input revalidation. */
401
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
402
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
403
- }>>;
404
- readonly page: Schema.optionalKey<Schema.Struct<{
405
- readonly title: Schema.String;
406
- readonly scrollY: Schema.Number;
407
- readonly viewportHeight: Schema.Number;
408
- readonly documentHeight: Schema.Number;
409
- }>>;
410
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
411
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
412
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
413
- readonly ref: Schema.String;
414
- readonly name: Schema.String;
415
- readonly url: Schema.String;
416
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
417
- }>>>;
418
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
419
- readonly ref: Schema.String;
420
- readonly url: Schema.String;
421
- readonly active: Schema.Boolean;
422
- }>>>;
423
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
424
- readonly ref: Schema.String;
425
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
426
- readonly message: Schema.String;
427
- readonly defaultValue: Schema.String;
428
- }>>>;
429
- }>>;
430
- /** Input receipt is independent of the next observation and never authorizes replay. */
431
- readonly dispatch: Schema.optionalKey<Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>>;
432
- /** The same input may remain pending across successive dialog responses. Never replay it. */
433
- readonly pendingInput: Schema.optionalKey<Schema.Struct<{
434
- readonly ref: Schema.String;
435
- readonly reason: Schema.Literal<"dialog">;
436
- }>>;
437
- readonly settledInput: Schema.optionalKey<Schema.Struct<{
438
- readonly ref: Schema.String;
439
- readonly dispatch: Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>;
440
- }>>;
66
+ readonly targetId: Schema.NonEmptyString;
441
67
  }>;
68
+ readonly success: Schema.Null;
442
69
  readonly failure: typeof BrowserUseError;
443
70
  readonly failureMode: "return";
444
71
  }, never>;
445
- readonly respond_dialog: Tool.Tool<"respond_dialog", {
72
+ readonly browser_frames: Tool.Tool<"browser_frames", {
446
73
  readonly parameters: Schema.Struct<{
447
- readonly ref: Schema.String;
448
- readonly accept: Schema.Boolean;
449
- readonly text: Schema.optionalKey<Schema.String>;
450
- }>;
451
- readonly success: Schema.Struct<{
452
- readonly completed: Schema.Natural;
453
- readonly error: Schema.NullOr<Schema.String>;
454
- readonly observation: Schema.NullOr<Schema.Struct<{
455
- readonly text: Schema.String;
456
- readonly controls: Schema.$Array<Schema.Struct<{
457
- readonly ref: Schema.String;
458
- readonly kind: Schema.String;
459
- readonly name: Schema.String;
460
- readonly value: Schema.String;
461
- readonly options: Schema.$Array<Schema.String>;
462
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
463
- readonly value: Schema.String;
464
- readonly label: Schema.String;
465
- readonly disabled: Schema.Boolean;
466
- readonly selected: Schema.Boolean;
467
- readonly index: Schema.optionalKey<Schema.Natural>;
468
- }>>>;
469
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
470
- readonly frame: Schema.optionalKey<Schema.String>;
471
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
472
- readonly editable: Schema.optionalKey<Schema.Boolean>;
473
- readonly checked: Schema.optionalKey<Schema.Boolean>;
474
- /** Observed CSS evidence, never a substitute for native input revalidation. */
475
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
476
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
477
- }>>;
478
- readonly page: Schema.optionalKey<Schema.Struct<{
479
- readonly title: Schema.String;
480
- readonly scrollY: Schema.Number;
481
- readonly viewportHeight: Schema.Number;
482
- readonly documentHeight: Schema.Number;
483
- }>>;
484
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
485
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
486
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
487
- readonly ref: Schema.String;
488
- readonly name: Schema.String;
489
- readonly url: Schema.String;
490
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
491
- }>>>;
492
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
493
- readonly ref: Schema.String;
494
- readonly url: Schema.String;
495
- readonly active: Schema.Boolean;
496
- }>>>;
497
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
498
- readonly ref: Schema.String;
499
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
500
- readonly message: Schema.String;
501
- readonly defaultValue: Schema.String;
502
- }>>>;
503
- }>>;
504
- /** Input receipt is independent of the next observation and never authorizes replay. */
505
- readonly dispatch: Schema.optionalKey<Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>>;
506
- /** The same input may remain pending across successive dialog responses. Never replay it. */
507
- readonly pendingInput: Schema.optionalKey<Schema.Struct<{
508
- readonly ref: Schema.String;
509
- readonly reason: Schema.Literal<"dialog">;
510
- }>>;
511
- readonly settledInput: Schema.optionalKey<Schema.Struct<{
512
- readonly ref: Schema.String;
513
- readonly dispatch: Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>;
514
- }>>;
74
+ readonly targetId: Schema.optionalKey<Schema.NonEmptyString>;
515
75
  }>;
76
+ readonly success: Schema.$Array<Schema.Struct<{
77
+ readonly frameId: Schema.NonEmptyString;
78
+ readonly parentFrameId: Schema.NullOr<Schema.NonEmptyString>;
79
+ readonly url: Schema.String;
80
+ }>>;
516
81
  readonly failure: typeof BrowserUseError;
517
82
  readonly failureMode: "return";
518
83
  }, never>;
519
- readonly screenshot: Tool.Tool<"screenshot", {
84
+ readonly browser_new_tab: Tool.Tool<"browser_new_tab", {
520
85
  readonly parameters: Tool.EmptyParams;
521
86
  readonly success: Schema.Struct<{
522
- readonly mediaType: Schema.Literal<"image/png">;
523
- readonly base64: Schema.String;
524
- }>;
525
- readonly failure: typeof BrowserUseError;
526
- readonly failureMode: "return";
527
- }, never>;
528
- readonly scroll: Tool.Tool<"scroll", {
529
- readonly parameters: Schema.Struct<{
530
- readonly ref: Schema.optionalKey<Schema.String>;
531
- readonly deltaX: Schema.Int;
532
- readonly deltaY: Schema.Int;
533
- }>;
534
- readonly success: Schema.Struct<{
535
- readonly completed: Schema.Natural;
536
- readonly error: Schema.NullOr<Schema.String>;
537
- readonly observation: Schema.NullOr<Schema.Struct<{
538
- readonly text: Schema.String;
539
- readonly controls: Schema.$Array<Schema.Struct<{
540
- readonly ref: Schema.String;
541
- readonly kind: Schema.String;
542
- readonly name: Schema.String;
543
- readonly value: Schema.String;
544
- readonly options: Schema.$Array<Schema.String>;
545
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
546
- readonly value: Schema.String;
547
- readonly label: Schema.String;
548
- readonly disabled: Schema.Boolean;
549
- readonly selected: Schema.Boolean;
550
- readonly index: Schema.optionalKey<Schema.Natural>;
551
- }>>>;
552
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
553
- readonly frame: Schema.optionalKey<Schema.String>;
554
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
555
- readonly editable: Schema.optionalKey<Schema.Boolean>;
556
- readonly checked: Schema.optionalKey<Schema.Boolean>;
557
- /** Observed CSS evidence, never a substitute for native input revalidation. */
558
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
559
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
560
- }>>;
561
- readonly page: Schema.optionalKey<Schema.Struct<{
562
- readonly title: Schema.String;
563
- readonly scrollY: Schema.Number;
564
- readonly viewportHeight: Schema.Number;
565
- readonly documentHeight: Schema.Number;
566
- }>>;
567
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
568
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
569
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
570
- readonly ref: Schema.String;
571
- readonly name: Schema.String;
572
- readonly url: Schema.String;
573
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
574
- }>>>;
575
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
576
- readonly ref: Schema.String;
577
- readonly url: Schema.String;
578
- readonly active: Schema.Boolean;
579
- }>>>;
580
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
581
- readonly ref: Schema.String;
582
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
583
- readonly message: Schema.String;
584
- readonly defaultValue: Schema.String;
585
- }>>>;
586
- }>>;
587
- /** Input receipt is independent of the next observation and never authorizes replay. */
588
- readonly dispatch: Schema.optionalKey<Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>>;
589
- /** The same input may remain pending across successive dialog responses. Never replay it. */
590
- readonly pendingInput: Schema.optionalKey<Schema.Struct<{
591
- readonly ref: Schema.String;
592
- readonly reason: Schema.Literal<"dialog">;
593
- }>>;
594
- readonly settledInput: Schema.optionalKey<Schema.Struct<{
595
- readonly ref: Schema.String;
596
- readonly dispatch: Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>;
597
- }>>;
598
- }>;
599
- readonly failure: typeof BrowserUseError;
600
- readonly failureMode: "return";
601
- }, never>;
602
- readonly select_tab: Tool.Tool<"select_tab", {
603
- readonly parameters: Schema.Struct<{
604
- readonly ref: Schema.String;
605
- }>;
606
- readonly success: Schema.Struct<{
607
- readonly text: Schema.String;
608
- readonly controls: Schema.$Array<Schema.Struct<{
609
- readonly ref: Schema.String;
610
- readonly kind: Schema.String;
611
- readonly name: Schema.String;
612
- readonly value: Schema.String;
613
- readonly options: Schema.$Array<Schema.String>;
614
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
615
- readonly value: Schema.String;
616
- readonly label: Schema.String;
617
- readonly disabled: Schema.Boolean;
618
- readonly selected: Schema.Boolean;
619
- readonly index: Schema.optionalKey<Schema.Natural>;
620
- }>>>;
621
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
622
- readonly frame: Schema.optionalKey<Schema.String>;
623
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
624
- readonly editable: Schema.optionalKey<Schema.Boolean>;
625
- readonly checked: Schema.optionalKey<Schema.Boolean>;
626
- /** Observed CSS evidence, never a substitute for native input revalidation. */
627
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
628
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
629
- }>>;
630
- readonly page: Schema.optionalKey<Schema.Struct<{
631
- readonly title: Schema.String;
632
- readonly scrollY: Schema.Number;
633
- readonly viewportHeight: Schema.Number;
634
- readonly documentHeight: Schema.Number;
635
- }>>;
636
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
637
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
638
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
639
- readonly ref: Schema.String;
640
- readonly name: Schema.String;
641
- readonly url: Schema.String;
642
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
643
- }>>>;
644
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
645
- readonly ref: Schema.String;
646
- readonly url: Schema.String;
647
- readonly active: Schema.Boolean;
648
- }>>>;
649
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
650
- readonly ref: Schema.String;
651
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
652
- readonly message: Schema.String;
653
- readonly defaultValue: Schema.String;
654
- }>>>;
655
- }>;
656
- readonly failure: typeof BrowserUseError;
657
- readonly failureMode: "return";
658
- }, never>;
659
- readonly wait: Tool.Tool<"wait", {
660
- readonly parameters: Schema.Struct<{
661
- readonly selector: Schema.NonEmptyString;
662
- readonly frame: Schema.optionalKey<Schema.String>;
663
- readonly state: Schema.Literals<readonly ["visible", "hidden", "enabled", "text"]>;
664
- /** Case-sensitive visible text qualifier for every state; required for `text`. */
665
- readonly text: Schema.optionalKey<Schema.String>;
666
- readonly timeoutMillis: Schema.Int;
667
- }>;
668
- readonly success: Schema.Struct<{
669
- readonly text: Schema.String;
670
- readonly controls: Schema.$Array<Schema.Struct<{
671
- readonly ref: Schema.String;
672
- readonly kind: Schema.String;
673
- readonly name: Schema.String;
674
- readonly value: Schema.String;
675
- readonly options: Schema.$Array<Schema.String>;
676
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
677
- readonly value: Schema.String;
678
- readonly label: Schema.String;
679
- readonly disabled: Schema.Boolean;
680
- readonly selected: Schema.Boolean;
681
- readonly index: Schema.optionalKey<Schema.Natural>;
682
- }>>>;
683
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
684
- readonly frame: Schema.optionalKey<Schema.String>;
685
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
686
- readonly editable: Schema.optionalKey<Schema.Boolean>;
687
- readonly checked: Schema.optionalKey<Schema.Boolean>;
688
- /** Observed CSS evidence, never a substitute for native input revalidation. */
689
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
690
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
691
- }>>;
692
- readonly page: Schema.optionalKey<Schema.Struct<{
693
- readonly title: Schema.String;
694
- readonly scrollY: Schema.Number;
695
- readonly viewportHeight: Schema.Number;
696
- readonly documentHeight: Schema.Number;
697
- }>>;
698
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
699
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
700
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
701
- readonly ref: Schema.String;
702
- readonly name: Schema.String;
703
- readonly url: Schema.String;
704
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
705
- }>>>;
706
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
707
- readonly ref: Schema.String;
708
- readonly url: Schema.String;
709
- readonly active: Schema.Boolean;
710
- }>>>;
711
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
712
- readonly ref: Schema.String;
713
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
714
- readonly message: Schema.String;
715
- readonly defaultValue: Schema.String;
716
- }>>>;
717
- }>;
718
- readonly failure: typeof BrowserUseError;
719
- readonly failureMode: "return";
720
- }, never>;
721
- }>;
722
- export declare const browserLayer: import("effect/Layer").Layer<Tool.HandlersFor<{
723
- readonly inspect: Tool.Tool<"inspect", {
724
- readonly parameters: Schema.Struct<{
725
- readonly selector: Schema.optionalKey<Schema.NonEmptyString>;
726
- readonly frame: Schema.optionalKey<Schema.String>;
727
- /** Narrow select options by label or value while retaining current selections. */
728
- readonly optionFilter: Schema.optionalKey<Schema.NonEmptyString>;
729
- }>;
730
- readonly success: Schema.Struct<{
731
- readonly text: Schema.String;
732
- readonly controls: Schema.$Array<Schema.Struct<{
733
- readonly ref: Schema.String;
734
- readonly kind: Schema.String;
735
- readonly name: Schema.String;
736
- readonly value: Schema.String;
737
- readonly options: Schema.$Array<Schema.String>;
738
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
739
- readonly value: Schema.String;
740
- readonly label: Schema.String;
741
- readonly disabled: Schema.Boolean;
742
- readonly selected: Schema.Boolean;
743
- readonly index: Schema.optionalKey<Schema.Natural>;
744
- }>>>;
745
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
746
- readonly frame: Schema.optionalKey<Schema.String>;
747
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
748
- readonly editable: Schema.optionalKey<Schema.Boolean>;
749
- readonly checked: Schema.optionalKey<Schema.Boolean>;
750
- /** Observed CSS evidence, never a substitute for native input revalidation. */
751
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
752
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
753
- }>>;
754
- readonly page: Schema.optionalKey<Schema.Struct<{
755
- readonly title: Schema.String;
756
- readonly scrollY: Schema.Number;
757
- readonly viewportHeight: Schema.Number;
758
- readonly documentHeight: Schema.Number;
759
- }>>;
760
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
761
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
762
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
763
- readonly ref: Schema.String;
764
- readonly name: Schema.String;
765
- readonly url: Schema.String;
766
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
767
- }>>>;
768
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
769
- readonly ref: Schema.String;
770
- readonly url: Schema.String;
771
- readonly active: Schema.Boolean;
772
- }>>>;
773
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
774
- readonly ref: Schema.String;
775
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
776
- readonly message: Schema.String;
777
- readonly defaultValue: Schema.String;
778
- }>>>;
779
- }>;
780
- readonly failure: typeof BrowserUseError;
781
- readonly failureMode: "return";
782
- }, never>;
783
- readonly navigate: Tool.Tool<"navigate", {
784
- readonly parameters: Schema.Struct<{
87
+ readonly targetId: Schema.NonEmptyString;
785
88
  readonly url: Schema.String;
786
- }>;
787
- readonly success: Schema.Struct<{
788
- readonly completed: Schema.Natural;
789
- readonly error: Schema.NullOr<Schema.String>;
790
- readonly observation: Schema.NullOr<Schema.Struct<{
791
- readonly text: Schema.String;
792
- readonly controls: Schema.$Array<Schema.Struct<{
793
- readonly ref: Schema.String;
794
- readonly kind: Schema.String;
795
- readonly name: Schema.String;
796
- readonly value: Schema.String;
797
- readonly options: Schema.$Array<Schema.String>;
798
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
799
- readonly value: Schema.String;
800
- readonly label: Schema.String;
801
- readonly disabled: Schema.Boolean;
802
- readonly selected: Schema.Boolean;
803
- readonly index: Schema.optionalKey<Schema.Natural>;
804
- }>>>;
805
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
806
- readonly frame: Schema.optionalKey<Schema.String>;
807
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
808
- readonly editable: Schema.optionalKey<Schema.Boolean>;
809
- readonly checked: Schema.optionalKey<Schema.Boolean>;
810
- /** Observed CSS evidence, never a substitute for native input revalidation. */
811
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
812
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
813
- }>>;
814
- readonly page: Schema.optionalKey<Schema.Struct<{
815
- readonly title: Schema.String;
816
- readonly scrollY: Schema.Number;
817
- readonly viewportHeight: Schema.Number;
818
- readonly documentHeight: Schema.Number;
819
- }>>;
820
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
821
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
822
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
823
- readonly ref: Schema.String;
824
- readonly name: Schema.String;
825
- readonly url: Schema.String;
826
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
827
- }>>>;
828
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
829
- readonly ref: Schema.String;
830
- readonly url: Schema.String;
831
- readonly active: Schema.Boolean;
832
- }>>>;
833
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
834
- readonly ref: Schema.String;
835
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
836
- readonly message: Schema.String;
837
- readonly defaultValue: Schema.String;
838
- }>>>;
839
- }>>;
840
- /** Input receipt is independent of the next observation and never authorizes replay. */
841
- readonly dispatch: Schema.optionalKey<Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>>;
842
- /** The same input may remain pending across successive dialog responses. Never replay it. */
843
- readonly pendingInput: Schema.optionalKey<Schema.Struct<{
844
- readonly ref: Schema.String;
845
- readonly reason: Schema.Literal<"dialog">;
846
- }>>;
847
- readonly settledInput: Schema.optionalKey<Schema.Struct<{
848
- readonly ref: Schema.String;
849
- readonly dispatch: Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>;
850
- }>>;
851
- }>;
852
- readonly failure: typeof BrowserUseError;
853
- readonly failureMode: "return";
854
- }, never>;
855
- readonly press: Tool.Tool<"press", {
856
- readonly parameters: Schema.Struct<{
857
- readonly ref: Schema.String;
858
- readonly key: Schema.Literals<readonly ["Enter", "Escape", "Tab", "ArrowDown", "ArrowUp", "ArrowLeft", "ArrowRight", "Home", "End", "Space", "Backspace", "Delete"]>;
859
- }>;
860
- readonly success: Schema.Struct<{
861
- readonly completed: Schema.Natural;
862
- readonly error: Schema.NullOr<Schema.String>;
863
- readonly observation: Schema.NullOr<Schema.Struct<{
864
- readonly text: Schema.String;
865
- readonly controls: Schema.$Array<Schema.Struct<{
866
- readonly ref: Schema.String;
867
- readonly kind: Schema.String;
868
- readonly name: Schema.String;
869
- readonly value: Schema.String;
870
- readonly options: Schema.$Array<Schema.String>;
871
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
872
- readonly value: Schema.String;
873
- readonly label: Schema.String;
874
- readonly disabled: Schema.Boolean;
875
- readonly selected: Schema.Boolean;
876
- readonly index: Schema.optionalKey<Schema.Natural>;
877
- }>>>;
878
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
879
- readonly frame: Schema.optionalKey<Schema.String>;
880
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
881
- readonly editable: Schema.optionalKey<Schema.Boolean>;
882
- readonly checked: Schema.optionalKey<Schema.Boolean>;
883
- /** Observed CSS evidence, never a substitute for native input revalidation. */
884
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
885
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
886
- }>>;
887
- readonly page: Schema.optionalKey<Schema.Struct<{
888
- readonly title: Schema.String;
889
- readonly scrollY: Schema.Number;
890
- readonly viewportHeight: Schema.Number;
891
- readonly documentHeight: Schema.Number;
892
- }>>;
893
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
894
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
895
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
896
- readonly ref: Schema.String;
897
- readonly name: Schema.String;
898
- readonly url: Schema.String;
899
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
900
- }>>>;
901
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
902
- readonly ref: Schema.String;
903
- readonly url: Schema.String;
904
- readonly active: Schema.Boolean;
905
- }>>>;
906
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
907
- readonly ref: Schema.String;
908
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
909
- readonly message: Schema.String;
910
- readonly defaultValue: Schema.String;
911
- }>>>;
912
- }>>;
913
- /** Input receipt is independent of the next observation and never authorizes replay. */
914
- readonly dispatch: Schema.optionalKey<Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>>;
915
- /** The same input may remain pending across successive dialog responses. Never replay it. */
916
- readonly pendingInput: Schema.optionalKey<Schema.Struct<{
917
- readonly ref: Schema.String;
918
- readonly reason: Schema.Literal<"dialog">;
919
- }>>;
920
- readonly settledInput: Schema.optionalKey<Schema.Struct<{
921
- readonly ref: Schema.String;
922
- readonly dispatch: Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>;
923
- }>>;
924
- }>;
925
- readonly failure: typeof BrowserUseError;
926
- readonly failureMode: "return";
927
- }, never>;
928
- readonly respond_dialog: Tool.Tool<"respond_dialog", {
929
- readonly parameters: Schema.Struct<{
930
- readonly ref: Schema.String;
931
- readonly accept: Schema.Boolean;
932
- readonly text: Schema.optionalKey<Schema.String>;
933
- }>;
934
- readonly success: Schema.Struct<{
935
- readonly completed: Schema.Natural;
936
- readonly error: Schema.NullOr<Schema.String>;
937
- readonly observation: Schema.NullOr<Schema.Struct<{
938
- readonly text: Schema.String;
939
- readonly controls: Schema.$Array<Schema.Struct<{
940
- readonly ref: Schema.String;
941
- readonly kind: Schema.String;
942
- readonly name: Schema.String;
943
- readonly value: Schema.String;
944
- readonly options: Schema.$Array<Schema.String>;
945
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
946
- readonly value: Schema.String;
947
- readonly label: Schema.String;
948
- readonly disabled: Schema.Boolean;
949
- readonly selected: Schema.Boolean;
950
- readonly index: Schema.optionalKey<Schema.Natural>;
951
- }>>>;
952
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
953
- readonly frame: Schema.optionalKey<Schema.String>;
954
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
955
- readonly editable: Schema.optionalKey<Schema.Boolean>;
956
- readonly checked: Schema.optionalKey<Schema.Boolean>;
957
- /** Observed CSS evidence, never a substitute for native input revalidation. */
958
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
959
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
960
- }>>;
961
- readonly page: Schema.optionalKey<Schema.Struct<{
962
- readonly title: Schema.String;
963
- readonly scrollY: Schema.Number;
964
- readonly viewportHeight: Schema.Number;
965
- readonly documentHeight: Schema.Number;
966
- }>>;
967
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
968
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
969
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
970
- readonly ref: Schema.String;
971
- readonly name: Schema.String;
972
- readonly url: Schema.String;
973
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
974
- }>>>;
975
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
976
- readonly ref: Schema.String;
977
- readonly url: Schema.String;
978
- readonly active: Schema.Boolean;
979
- }>>>;
980
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
981
- readonly ref: Schema.String;
982
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
983
- readonly message: Schema.String;
984
- readonly defaultValue: Schema.String;
985
- }>>>;
986
- }>>;
987
- /** Input receipt is independent of the next observation and never authorizes replay. */
988
- readonly dispatch: Schema.optionalKey<Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>>;
989
- /** The same input may remain pending across successive dialog responses. Never replay it. */
990
- readonly pendingInput: Schema.optionalKey<Schema.Struct<{
991
- readonly ref: Schema.String;
992
- readonly reason: Schema.Literal<"dialog">;
993
- }>>;
994
- readonly settledInput: Schema.optionalKey<Schema.Struct<{
995
- readonly ref: Schema.String;
996
- readonly dispatch: Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>;
997
- }>>;
89
+ readonly title: Schema.String;
998
90
  }>;
999
91
  readonly failure: typeof BrowserUseError;
1000
92
  readonly failureMode: "return";
1001
93
  }, never>;
1002
- readonly screenshot: Tool.Tool<"screenshot", {
94
+ readonly browser_tabs: Tool.Tool<"browser_tabs", {
1003
95
  readonly parameters: Tool.EmptyParams;
1004
- readonly success: Schema.Struct<{
1005
- readonly mediaType: Schema.Literal<"image/png">;
1006
- readonly base64: Schema.String;
1007
- }>;
1008
- readonly failure: typeof BrowserUseError;
1009
- readonly failureMode: "return";
1010
- }, never>;
1011
- readonly scroll: Tool.Tool<"scroll", {
1012
- readonly parameters: Schema.Struct<{
1013
- readonly ref: Schema.optionalKey<Schema.String>;
1014
- readonly deltaX: Schema.Int;
1015
- readonly deltaY: Schema.Int;
1016
- }>;
1017
- readonly success: Schema.Struct<{
1018
- readonly completed: Schema.Natural;
1019
- readonly error: Schema.NullOr<Schema.String>;
1020
- readonly observation: Schema.NullOr<Schema.Struct<{
1021
- readonly text: Schema.String;
1022
- readonly controls: Schema.$Array<Schema.Struct<{
1023
- readonly ref: Schema.String;
1024
- readonly kind: Schema.String;
1025
- readonly name: Schema.String;
1026
- readonly value: Schema.String;
1027
- readonly options: Schema.$Array<Schema.String>;
1028
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1029
- readonly value: Schema.String;
1030
- readonly label: Schema.String;
1031
- readonly disabled: Schema.Boolean;
1032
- readonly selected: Schema.Boolean;
1033
- readonly index: Schema.optionalKey<Schema.Natural>;
1034
- }>>>;
1035
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
1036
- readonly frame: Schema.optionalKey<Schema.String>;
1037
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
1038
- readonly editable: Schema.optionalKey<Schema.Boolean>;
1039
- readonly checked: Schema.optionalKey<Schema.Boolean>;
1040
- /** Observed CSS evidence, never a substitute for native input revalidation. */
1041
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
1042
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
1043
- }>>;
1044
- readonly page: Schema.optionalKey<Schema.Struct<{
1045
- readonly title: Schema.String;
1046
- readonly scrollY: Schema.Number;
1047
- readonly viewportHeight: Schema.Number;
1048
- readonly documentHeight: Schema.Number;
1049
- }>>;
1050
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
1051
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
1052
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1053
- readonly ref: Schema.String;
1054
- readonly name: Schema.String;
1055
- readonly url: Schema.String;
1056
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
1057
- }>>>;
1058
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1059
- readonly ref: Schema.String;
1060
- readonly url: Schema.String;
1061
- readonly active: Schema.Boolean;
1062
- }>>>;
1063
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1064
- readonly ref: Schema.String;
1065
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
1066
- readonly message: Schema.String;
1067
- readonly defaultValue: Schema.String;
1068
- }>>>;
1069
- }>>;
1070
- /** Input receipt is independent of the next observation and never authorizes replay. */
1071
- readonly dispatch: Schema.optionalKey<Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>>;
1072
- /** The same input may remain pending across successive dialog responses. Never replay it. */
1073
- readonly pendingInput: Schema.optionalKey<Schema.Struct<{
1074
- readonly ref: Schema.String;
1075
- readonly reason: Schema.Literal<"dialog">;
1076
- }>>;
1077
- readonly settledInput: Schema.optionalKey<Schema.Struct<{
1078
- readonly ref: Schema.String;
1079
- readonly dispatch: Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>;
1080
- }>>;
1081
- }>;
1082
- readonly failure: typeof BrowserUseError;
1083
- readonly failureMode: "return";
1084
- }, never>;
1085
- readonly select_tab: Tool.Tool<"select_tab", {
1086
- readonly parameters: Schema.Struct<{
1087
- readonly ref: Schema.String;
1088
- }>;
1089
- readonly success: Schema.Struct<{
1090
- readonly text: Schema.String;
1091
- readonly controls: Schema.$Array<Schema.Struct<{
1092
- readonly ref: Schema.String;
1093
- readonly kind: Schema.String;
1094
- readonly name: Schema.String;
1095
- readonly value: Schema.String;
1096
- readonly options: Schema.$Array<Schema.String>;
1097
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1098
- readonly value: Schema.String;
1099
- readonly label: Schema.String;
1100
- readonly disabled: Schema.Boolean;
1101
- readonly selected: Schema.Boolean;
1102
- readonly index: Schema.optionalKey<Schema.Natural>;
1103
- }>>>;
1104
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
1105
- readonly frame: Schema.optionalKey<Schema.String>;
1106
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
1107
- readonly editable: Schema.optionalKey<Schema.Boolean>;
1108
- readonly checked: Schema.optionalKey<Schema.Boolean>;
1109
- /** Observed CSS evidence, never a substitute for native input revalidation. */
1110
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
1111
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
1112
- }>>;
1113
- readonly page: Schema.optionalKey<Schema.Struct<{
1114
- readonly title: Schema.String;
1115
- readonly scrollY: Schema.Number;
1116
- readonly viewportHeight: Schema.Number;
1117
- readonly documentHeight: Schema.Number;
1118
- }>>;
1119
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
1120
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
1121
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1122
- readonly ref: Schema.String;
1123
- readonly name: Schema.String;
1124
- readonly url: Schema.String;
1125
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
1126
- }>>>;
1127
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1128
- readonly ref: Schema.String;
1129
- readonly url: Schema.String;
1130
- readonly active: Schema.Boolean;
1131
- }>>>;
1132
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1133
- readonly ref: Schema.String;
1134
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
1135
- readonly message: Schema.String;
1136
- readonly defaultValue: Schema.String;
1137
- }>>>;
1138
- }>;
1139
- readonly failure: typeof BrowserUseError;
1140
- readonly failureMode: "return";
1141
- }, never>;
1142
- readonly wait: Tool.Tool<"wait", {
1143
- readonly parameters: Schema.Struct<{
1144
- readonly selector: Schema.NonEmptyString;
1145
- readonly frame: Schema.optionalKey<Schema.String>;
1146
- readonly state: Schema.Literals<readonly ["visible", "hidden", "enabled", "text"]>;
1147
- /** Case-sensitive visible text qualifier for every state; required for `text`. */
1148
- readonly text: Schema.optionalKey<Schema.String>;
1149
- readonly timeoutMillis: Schema.Int;
1150
- }>;
1151
- readonly success: Schema.Struct<{
1152
- readonly text: Schema.String;
1153
- readonly controls: Schema.$Array<Schema.Struct<{
1154
- readonly ref: Schema.String;
1155
- readonly kind: Schema.String;
1156
- readonly name: Schema.String;
1157
- readonly value: Schema.String;
1158
- readonly options: Schema.$Array<Schema.String>;
1159
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1160
- readonly value: Schema.String;
1161
- readonly label: Schema.String;
1162
- readonly disabled: Schema.Boolean;
1163
- readonly selected: Schema.Boolean;
1164
- readonly index: Schema.optionalKey<Schema.Natural>;
1165
- }>>>;
1166
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
1167
- readonly frame: Schema.optionalKey<Schema.String>;
1168
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
1169
- readonly editable: Schema.optionalKey<Schema.Boolean>;
1170
- readonly checked: Schema.optionalKey<Schema.Boolean>;
1171
- /** Observed CSS evidence, never a substitute for native input revalidation. */
1172
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
1173
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
1174
- }>>;
1175
- readonly page: Schema.optionalKey<Schema.Struct<{
1176
- readonly title: Schema.String;
1177
- readonly scrollY: Schema.Number;
1178
- readonly viewportHeight: Schema.Number;
1179
- readonly documentHeight: Schema.Number;
1180
- }>>;
1181
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
1182
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
1183
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1184
- readonly ref: Schema.String;
1185
- readonly name: Schema.String;
1186
- readonly url: Schema.String;
1187
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
1188
- }>>>;
1189
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1190
- readonly ref: Schema.String;
1191
- readonly url: Schema.String;
1192
- readonly active: Schema.Boolean;
1193
- }>>>;
1194
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1195
- readonly ref: Schema.String;
1196
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
1197
- readonly message: Schema.String;
1198
- readonly defaultValue: Schema.String;
1199
- }>>>;
1200
- }>;
96
+ readonly success: Schema.$Array<Schema.Struct<{
97
+ readonly targetId: Schema.NonEmptyString;
98
+ readonly url: Schema.String;
99
+ readonly title: Schema.String;
100
+ }>>;
1201
101
  readonly failure: typeof BrowserUseError;
1202
102
  readonly failureMode: "return";
1203
103
  }, never>;
1204
- }>, never, BrowserControl>;
1205
- declare const single: {
1206
- toolkit: Toolkit.Toolkit<{
1207
- readonly act: Tool.Tool<"act", {
1208
- readonly parameters: Schema.Struct<{
1209
- readonly action: Schema.Union<readonly [Schema.Struct<{
1210
- readonly kind: Schema.Literal<"click">;
1211
- readonly ref: Schema.String;
1212
- }>, Schema.Struct<{
1213
- readonly kind: Schema.Literal<"fill">;
1214
- readonly ref: Schema.String;
1215
- readonly value: Schema.String;
1216
- }>, Schema.Struct<{
1217
- readonly kind: Schema.Literal<"select">;
1218
- readonly ref: Schema.String;
1219
- readonly value: Schema.String;
1220
- }>]>;
1221
- }>;
1222
- readonly success: Schema.Struct<{
1223
- readonly completed: Schema.Natural;
1224
- readonly error: Schema.NullOr<Schema.String>;
1225
- readonly observation: Schema.NullOr<Schema.Struct<{
1226
- readonly text: Schema.String;
1227
- readonly controls: Schema.$Array<Schema.Struct<{
1228
- readonly ref: Schema.String;
1229
- readonly kind: Schema.String;
1230
- readonly name: Schema.String;
1231
- readonly value: Schema.String;
1232
- readonly options: Schema.$Array<Schema.String>;
1233
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1234
- readonly value: Schema.String;
1235
- readonly label: Schema.String;
1236
- readonly disabled: Schema.Boolean;
1237
- readonly selected: Schema.Boolean;
1238
- readonly index: Schema.optionalKey<Schema.Natural>;
1239
- }>>>;
1240
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
1241
- readonly frame: Schema.optionalKey<Schema.String>;
1242
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
1243
- readonly editable: Schema.optionalKey<Schema.Boolean>;
1244
- readonly checked: Schema.optionalKey<Schema.Boolean>;
1245
- /** Observed CSS evidence, never a substitute for native input revalidation. */
1246
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
1247
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
1248
- }>>;
1249
- readonly page: Schema.optionalKey<Schema.Struct<{
1250
- readonly title: Schema.String;
1251
- readonly scrollY: Schema.Number;
1252
- readonly viewportHeight: Schema.Number;
1253
- readonly documentHeight: Schema.Number;
1254
- }>>;
1255
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
1256
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
1257
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1258
- readonly ref: Schema.String;
1259
- readonly name: Schema.String;
1260
- readonly url: Schema.String;
1261
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
1262
- }>>>;
1263
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1264
- readonly ref: Schema.String;
1265
- readonly url: Schema.String;
1266
- readonly active: Schema.Boolean;
1267
- }>>>;
1268
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1269
- readonly ref: Schema.String;
1270
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
1271
- readonly message: Schema.String;
1272
- readonly defaultValue: Schema.String;
1273
- }>>>;
1274
- }>>;
1275
- /** Input receipt is independent of the next observation and never authorizes replay. */
1276
- readonly dispatch: Schema.optionalKey<Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>>;
1277
- /** The same input may remain pending across successive dialog responses. Never replay it. */
1278
- readonly pendingInput: Schema.optionalKey<Schema.Struct<{
1279
- readonly ref: Schema.String;
1280
- readonly reason: Schema.Literal<"dialog">;
1281
- }>>;
1282
- readonly settledInput: Schema.optionalKey<Schema.Struct<{
1283
- readonly ref: Schema.String;
1284
- readonly dispatch: Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>;
1285
- }>>;
1286
- }>;
1287
- readonly failure: typeof BrowserUseError;
1288
- readonly failureMode: "return";
1289
- }, never>;
1290
- readonly observe: Tool.Tool<"observe", {
1291
- readonly parameters: Tool.EmptyParams;
1292
- readonly success: Schema.Struct<{
1293
- readonly text: Schema.String;
1294
- readonly controls: Schema.$Array<Schema.Struct<{
1295
- readonly ref: Schema.String;
1296
- readonly kind: Schema.String;
1297
- readonly name: Schema.String;
1298
- readonly value: Schema.String;
1299
- readonly options: Schema.$Array<Schema.String>;
1300
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1301
- readonly value: Schema.String;
1302
- readonly label: Schema.String;
1303
- readonly disabled: Schema.Boolean;
1304
- readonly selected: Schema.Boolean;
1305
- readonly index: Schema.optionalKey<Schema.Natural>;
1306
- }>>>;
1307
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
1308
- readonly frame: Schema.optionalKey<Schema.String>;
1309
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
1310
- readonly editable: Schema.optionalKey<Schema.Boolean>;
1311
- readonly checked: Schema.optionalKey<Schema.Boolean>;
1312
- /** Observed CSS evidence, never a substitute for native input revalidation. */
1313
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
1314
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
1315
- }>>;
1316
- readonly page: Schema.optionalKey<Schema.Struct<{
1317
- readonly title: Schema.String;
1318
- readonly scrollY: Schema.Number;
1319
- readonly viewportHeight: Schema.Number;
1320
- readonly documentHeight: Schema.Number;
1321
- }>>;
1322
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
1323
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
1324
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1325
- readonly ref: Schema.String;
1326
- readonly name: Schema.String;
1327
- readonly url: Schema.String;
1328
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
1329
- }>>>;
1330
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1331
- readonly ref: Schema.String;
1332
- readonly url: Schema.String;
1333
- readonly active: Schema.Boolean;
1334
- }>>>;
1335
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1336
- readonly ref: Schema.String;
1337
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
1338
- readonly message: Schema.String;
1339
- readonly defaultValue: Schema.String;
1340
- }>>>;
1341
- }>;
1342
- readonly failure: typeof BrowserUseError;
1343
- readonly failureMode: "return";
1344
- }, never>;
1345
- }>;
1346
- layer: () => import("effect/Layer").Layer<Tool.HandlersFor<{
1347
- readonly act: Tool.Tool<"act", {
104
+ }>, never, BrowserCdp>;
105
+ /** One Code Mode tool. Generated code chooses how to inspect and operate each website. */
106
+ export declare const make: (options?: {
107
+ readonly limits?: CodeExecutionLimits;
108
+ readonly maxEgressBytes?: number;
109
+ }) => CodeModeDefinition<"browser_execute", {
110
+ cdp: {
111
+ send: Tool.Tool<"browser_cdp_send", {
1348
112
  readonly parameters: Schema.Struct<{
1349
- readonly action: Schema.Union<readonly [Schema.Struct<{
1350
- readonly kind: Schema.Literal<"click">;
1351
- readonly ref: Schema.String;
1352
- }>, Schema.Struct<{
1353
- readonly kind: Schema.Literal<"fill">;
1354
- readonly ref: Schema.String;
1355
- readonly value: Schema.String;
1356
- }>, Schema.Struct<{
1357
- readonly kind: Schema.Literal<"select">;
1358
- readonly ref: Schema.String;
1359
- readonly value: Schema.String;
1360
- }>]>;
1361
- }>;
1362
- readonly success: Schema.Struct<{
1363
- readonly completed: Schema.Natural;
1364
- readonly error: Schema.NullOr<Schema.String>;
1365
- readonly observation: Schema.NullOr<Schema.Struct<{
1366
- readonly text: Schema.String;
1367
- readonly controls: Schema.$Array<Schema.Struct<{
1368
- readonly ref: Schema.String;
1369
- readonly kind: Schema.String;
1370
- readonly name: Schema.String;
1371
- readonly value: Schema.String;
1372
- readonly options: Schema.$Array<Schema.String>;
1373
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1374
- readonly value: Schema.String;
1375
- readonly label: Schema.String;
1376
- readonly disabled: Schema.Boolean;
1377
- readonly selected: Schema.Boolean;
1378
- readonly index: Schema.optionalKey<Schema.Natural>;
1379
- }>>>;
1380
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
1381
- readonly frame: Schema.optionalKey<Schema.String>;
1382
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
1383
- readonly editable: Schema.optionalKey<Schema.Boolean>;
1384
- readonly checked: Schema.optionalKey<Schema.Boolean>;
1385
- /** Observed CSS evidence, never a substitute for native input revalidation. */
1386
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
1387
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
1388
- }>>;
1389
- readonly page: Schema.optionalKey<Schema.Struct<{
1390
- readonly title: Schema.String;
1391
- readonly scrollY: Schema.Number;
1392
- readonly viewportHeight: Schema.Number;
1393
- readonly documentHeight: Schema.Number;
1394
- }>>;
1395
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
1396
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
1397
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1398
- readonly ref: Schema.String;
1399
- readonly name: Schema.String;
1400
- readonly url: Schema.String;
1401
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
1402
- }>>>;
1403
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1404
- readonly ref: Schema.String;
1405
- readonly url: Schema.String;
1406
- readonly active: Schema.Boolean;
1407
- }>>>;
1408
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1409
- readonly ref: Schema.String;
1410
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
1411
- readonly message: Schema.String;
1412
- readonly defaultValue: Schema.String;
1413
- }>>>;
1414
- }>>;
1415
- /** Input receipt is independent of the next observation and never authorizes replay. */
1416
- readonly dispatch: Schema.optionalKey<Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>>;
1417
- /** The same input may remain pending across successive dialog responses. Never replay it. */
1418
- readonly pendingInput: Schema.optionalKey<Schema.Struct<{
1419
- readonly ref: Schema.String;
1420
- readonly reason: Schema.Literal<"dialog">;
1421
- }>>;
1422
- readonly settledInput: Schema.optionalKey<Schema.Struct<{
1423
- readonly ref: Schema.String;
1424
- readonly dispatch: Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>;
1425
- }>>;
113
+ readonly method: Schema.String;
114
+ readonly params: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
115
+ /** Omit to address the session's original page. Discover other pages with cdp.tabs(). */
116
+ readonly targetId: Schema.optionalKey<Schema.NonEmptyString>;
117
+ /** Route to a frame's CDP session, including out-of-process frames. Obtain IDs with cdp.frames(). */
118
+ readonly frameId: Schema.optionalKey<Schema.NonEmptyString>;
1426
119
  }>;
120
+ readonly success: Schema.Codec<Schema.Json, Schema.Json, never, never>;
1427
121
  readonly failure: typeof BrowserUseError;
1428
122
  readonly failureMode: "return";
1429
123
  }, never>;
1430
- readonly observe: Tool.Tool<"observe", {
124
+ tabs: Tool.Tool<"browser_tabs", {
1431
125
  readonly parameters: Tool.EmptyParams;
1432
- readonly success: Schema.Struct<{
1433
- readonly text: Schema.String;
1434
- readonly controls: Schema.$Array<Schema.Struct<{
1435
- readonly ref: Schema.String;
1436
- readonly kind: Schema.String;
1437
- readonly name: Schema.String;
1438
- readonly value: Schema.String;
1439
- readonly options: Schema.$Array<Schema.String>;
1440
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1441
- readonly value: Schema.String;
1442
- readonly label: Schema.String;
1443
- readonly disabled: Schema.Boolean;
1444
- readonly selected: Schema.Boolean;
1445
- readonly index: Schema.optionalKey<Schema.Natural>;
1446
- }>>>;
1447
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
1448
- readonly frame: Schema.optionalKey<Schema.String>;
1449
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
1450
- readonly editable: Schema.optionalKey<Schema.Boolean>;
1451
- readonly checked: Schema.optionalKey<Schema.Boolean>;
1452
- /** Observed CSS evidence, never a substitute for native input revalidation. */
1453
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
1454
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
1455
- }>>;
1456
- readonly page: Schema.optionalKey<Schema.Struct<{
1457
- readonly title: Schema.String;
1458
- readonly scrollY: Schema.Number;
1459
- readonly viewportHeight: Schema.Number;
1460
- readonly documentHeight: Schema.Number;
1461
- }>>;
1462
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
1463
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
1464
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1465
- readonly ref: Schema.String;
1466
- readonly name: Schema.String;
1467
- readonly url: Schema.String;
1468
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
1469
- }>>>;
1470
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1471
- readonly ref: Schema.String;
1472
- readonly url: Schema.String;
1473
- readonly active: Schema.Boolean;
1474
- }>>>;
1475
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1476
- readonly ref: Schema.String;
1477
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
1478
- readonly message: Schema.String;
1479
- readonly defaultValue: Schema.String;
1480
- }>>>;
1481
- }>;
126
+ readonly success: Schema.$Array<Schema.Struct<{
127
+ readonly targetId: Schema.NonEmptyString;
128
+ readonly url: Schema.String;
129
+ readonly title: Schema.String;
130
+ }>>;
1482
131
  readonly failure: typeof BrowserUseError;
1483
132
  readonly failureMode: "return";
1484
133
  }, never>;
1485
- }>, never, BrowserActions>;
1486
- };
1487
- declare const batched: {
1488
- toolkit: Toolkit.Toolkit<{
1489
- readonly act: Tool.Tool<"act", {
134
+ frames: Tool.Tool<"browser_frames", {
1490
135
  readonly parameters: Schema.Struct<{
1491
- readonly actions: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
1492
- readonly kind: Schema.Literal<"click">;
1493
- readonly ref: Schema.String;
1494
- }>, Schema.Struct<{
1495
- readonly kind: Schema.Literal<"fill">;
1496
- readonly ref: Schema.String;
1497
- readonly value: Schema.String;
1498
- }>, Schema.Struct<{
1499
- readonly kind: Schema.Literal<"select">;
1500
- readonly ref: Schema.String;
1501
- readonly value: Schema.String;
1502
- }>]>>;
1503
- }>;
1504
- readonly success: Schema.Struct<{
1505
- readonly completed: Schema.Natural;
1506
- readonly error: Schema.NullOr<Schema.String>;
1507
- readonly observation: Schema.NullOr<Schema.Struct<{
1508
- readonly text: Schema.String;
1509
- readonly controls: Schema.$Array<Schema.Struct<{
1510
- readonly ref: Schema.String;
1511
- readonly kind: Schema.String;
1512
- readonly name: Schema.String;
1513
- readonly value: Schema.String;
1514
- readonly options: Schema.$Array<Schema.String>;
1515
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1516
- readonly value: Schema.String;
1517
- readonly label: Schema.String;
1518
- readonly disabled: Schema.Boolean;
1519
- readonly selected: Schema.Boolean;
1520
- readonly index: Schema.optionalKey<Schema.Natural>;
1521
- }>>>;
1522
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
1523
- readonly frame: Schema.optionalKey<Schema.String>;
1524
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
1525
- readonly editable: Schema.optionalKey<Schema.Boolean>;
1526
- readonly checked: Schema.optionalKey<Schema.Boolean>;
1527
- /** Observed CSS evidence, never a substitute for native input revalidation. */
1528
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
1529
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
1530
- }>>;
1531
- readonly page: Schema.optionalKey<Schema.Struct<{
1532
- readonly title: Schema.String;
1533
- readonly scrollY: Schema.Number;
1534
- readonly viewportHeight: Schema.Number;
1535
- readonly documentHeight: Schema.Number;
1536
- }>>;
1537
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
1538
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
1539
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1540
- readonly ref: Schema.String;
1541
- readonly name: Schema.String;
1542
- readonly url: Schema.String;
1543
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
1544
- }>>>;
1545
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1546
- readonly ref: Schema.String;
1547
- readonly url: Schema.String;
1548
- readonly active: Schema.Boolean;
1549
- }>>>;
1550
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1551
- readonly ref: Schema.String;
1552
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
1553
- readonly message: Schema.String;
1554
- readonly defaultValue: Schema.String;
1555
- }>>>;
1556
- }>>;
1557
- /** Input receipt is independent of the next observation and never authorizes replay. */
1558
- readonly dispatch: Schema.optionalKey<Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>>;
1559
- /** The same input may remain pending across successive dialog responses. Never replay it. */
1560
- readonly pendingInput: Schema.optionalKey<Schema.Struct<{
1561
- readonly ref: Schema.String;
1562
- readonly reason: Schema.Literal<"dialog">;
1563
- }>>;
1564
- readonly settledInput: Schema.optionalKey<Schema.Struct<{
1565
- readonly ref: Schema.String;
1566
- readonly dispatch: Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>;
1567
- }>>;
136
+ readonly targetId: Schema.optionalKey<Schema.NonEmptyString>;
1568
137
  }>;
138
+ readonly success: Schema.$Array<Schema.Struct<{
139
+ readonly frameId: Schema.NonEmptyString;
140
+ readonly parentFrameId: Schema.NullOr<Schema.NonEmptyString>;
141
+ readonly url: Schema.String;
142
+ }>>;
1569
143
  readonly failure: typeof BrowserUseError;
1570
144
  readonly failureMode: "return";
1571
145
  }, never>;
1572
- readonly observe: Tool.Tool<"observe", {
146
+ newTab: Tool.Tool<"browser_new_tab", {
1573
147
  readonly parameters: Tool.EmptyParams;
1574
148
  readonly success: Schema.Struct<{
1575
- readonly text: Schema.String;
1576
- readonly controls: Schema.$Array<Schema.Struct<{
1577
- readonly ref: Schema.String;
1578
- readonly kind: Schema.String;
1579
- readonly name: Schema.String;
1580
- readonly value: Schema.String;
1581
- readonly options: Schema.$Array<Schema.String>;
1582
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1583
- readonly value: Schema.String;
1584
- readonly label: Schema.String;
1585
- readonly disabled: Schema.Boolean;
1586
- readonly selected: Schema.Boolean;
1587
- readonly index: Schema.optionalKey<Schema.Natural>;
1588
- }>>>;
1589
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
1590
- readonly frame: Schema.optionalKey<Schema.String>;
1591
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
1592
- readonly editable: Schema.optionalKey<Schema.Boolean>;
1593
- readonly checked: Schema.optionalKey<Schema.Boolean>;
1594
- /** Observed CSS evidence, never a substitute for native input revalidation. */
1595
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
1596
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
1597
- }>>;
1598
- readonly page: Schema.optionalKey<Schema.Struct<{
1599
- readonly title: Schema.String;
1600
- readonly scrollY: Schema.Number;
1601
- readonly viewportHeight: Schema.Number;
1602
- readonly documentHeight: Schema.Number;
1603
- }>>;
1604
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
1605
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
1606
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1607
- readonly ref: Schema.String;
1608
- readonly name: Schema.String;
1609
- readonly url: Schema.String;
1610
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
1611
- }>>>;
1612
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1613
- readonly ref: Schema.String;
1614
- readonly url: Schema.String;
1615
- readonly active: Schema.Boolean;
1616
- }>>>;
1617
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1618
- readonly ref: Schema.String;
1619
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
1620
- readonly message: Schema.String;
1621
- readonly defaultValue: Schema.String;
1622
- }>>>;
149
+ readonly targetId: Schema.NonEmptyString;
150
+ readonly url: Schema.String;
151
+ readonly title: Schema.String;
1623
152
  }>;
1624
153
  readonly failure: typeof BrowserUseError;
1625
154
  readonly failureMode: "return";
1626
155
  }, never>;
1627
- }>;
1628
- layer: () => import("effect/Layer").Layer<Tool.HandlersFor<{
1629
- readonly act: Tool.Tool<"act", {
156
+ closeTab: Tool.Tool<"browser_close_tab", {
1630
157
  readonly parameters: Schema.Struct<{
1631
- readonly actions: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
1632
- readonly kind: Schema.Literal<"click">;
1633
- readonly ref: Schema.String;
1634
- }>, Schema.Struct<{
1635
- readonly kind: Schema.Literal<"fill">;
1636
- readonly ref: Schema.String;
1637
- readonly value: Schema.String;
1638
- }>, Schema.Struct<{
1639
- readonly kind: Schema.Literal<"select">;
1640
- readonly ref: Schema.String;
1641
- readonly value: Schema.String;
1642
- }>]>>;
1643
- }>;
1644
- readonly success: Schema.Struct<{
1645
- readonly completed: Schema.Natural;
1646
- readonly error: Schema.NullOr<Schema.String>;
1647
- readonly observation: Schema.NullOr<Schema.Struct<{
1648
- readonly text: Schema.String;
1649
- readonly controls: Schema.$Array<Schema.Struct<{
1650
- readonly ref: Schema.String;
1651
- readonly kind: Schema.String;
1652
- readonly name: Schema.String;
1653
- readonly value: Schema.String;
1654
- readonly options: Schema.$Array<Schema.String>;
1655
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1656
- readonly value: Schema.String;
1657
- readonly label: Schema.String;
1658
- readonly disabled: Schema.Boolean;
1659
- readonly selected: Schema.Boolean;
1660
- readonly index: Schema.optionalKey<Schema.Natural>;
1661
- }>>>;
1662
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
1663
- readonly frame: Schema.optionalKey<Schema.String>;
1664
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
1665
- readonly editable: Schema.optionalKey<Schema.Boolean>;
1666
- readonly checked: Schema.optionalKey<Schema.Boolean>;
1667
- /** Observed CSS evidence, never a substitute for native input revalidation. */
1668
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
1669
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
1670
- }>>;
1671
- readonly page: Schema.optionalKey<Schema.Struct<{
1672
- readonly title: Schema.String;
1673
- readonly scrollY: Schema.Number;
1674
- readonly viewportHeight: Schema.Number;
1675
- readonly documentHeight: Schema.Number;
1676
- }>>;
1677
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
1678
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
1679
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1680
- readonly ref: Schema.String;
1681
- readonly name: Schema.String;
1682
- readonly url: Schema.String;
1683
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
1684
- }>>>;
1685
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1686
- readonly ref: Schema.String;
1687
- readonly url: Schema.String;
1688
- readonly active: Schema.Boolean;
1689
- }>>>;
1690
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1691
- readonly ref: Schema.String;
1692
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
1693
- readonly message: Schema.String;
1694
- readonly defaultValue: Schema.String;
1695
- }>>>;
1696
- }>>;
1697
- /** Input receipt is independent of the next observation and never authorizes replay. */
1698
- readonly dispatch: Schema.optionalKey<Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>>;
1699
- /** The same input may remain pending across successive dialog responses. Never replay it. */
1700
- readonly pendingInput: Schema.optionalKey<Schema.Struct<{
1701
- readonly ref: Schema.String;
1702
- readonly reason: Schema.Literal<"dialog">;
1703
- }>>;
1704
- readonly settledInput: Schema.optionalKey<Schema.Struct<{
1705
- readonly ref: Schema.String;
1706
- readonly dispatch: Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>;
1707
- }>>;
1708
- }>;
1709
- readonly failure: typeof BrowserUseError;
1710
- readonly failureMode: "return";
1711
- }, never>;
1712
- readonly observe: Tool.Tool<"observe", {
1713
- readonly parameters: Tool.EmptyParams;
1714
- readonly success: Schema.Struct<{
1715
- readonly text: Schema.String;
1716
- readonly controls: Schema.$Array<Schema.Struct<{
1717
- readonly ref: Schema.String;
1718
- readonly kind: Schema.String;
1719
- readonly name: Schema.String;
1720
- readonly value: Schema.String;
1721
- readonly options: Schema.$Array<Schema.String>;
1722
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1723
- readonly value: Schema.String;
1724
- readonly label: Schema.String;
1725
- readonly disabled: Schema.Boolean;
1726
- readonly selected: Schema.Boolean;
1727
- readonly index: Schema.optionalKey<Schema.Natural>;
1728
- }>>>;
1729
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
1730
- readonly frame: Schema.optionalKey<Schema.String>;
1731
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
1732
- readonly editable: Schema.optionalKey<Schema.Boolean>;
1733
- readonly checked: Schema.optionalKey<Schema.Boolean>;
1734
- /** Observed CSS evidence, never a substitute for native input revalidation. */
1735
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
1736
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
1737
- }>>;
1738
- readonly page: Schema.optionalKey<Schema.Struct<{
1739
- readonly title: Schema.String;
1740
- readonly scrollY: Schema.Number;
1741
- readonly viewportHeight: Schema.Number;
1742
- readonly documentHeight: Schema.Number;
1743
- }>>;
1744
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
1745
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
1746
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1747
- readonly ref: Schema.String;
1748
- readonly name: Schema.String;
1749
- readonly url: Schema.String;
1750
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
1751
- }>>>;
1752
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1753
- readonly ref: Schema.String;
1754
- readonly url: Schema.String;
1755
- readonly active: Schema.Boolean;
1756
- }>>>;
1757
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1758
- readonly ref: Schema.String;
1759
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
1760
- readonly message: Schema.String;
1761
- readonly defaultValue: Schema.String;
1762
- }>>>;
158
+ readonly targetId: Schema.NonEmptyString;
1763
159
  }>;
160
+ readonly success: Schema.Null;
1764
161
  readonly failure: typeof BrowserUseError;
1765
162
  readonly failureMode: "return";
1766
163
  }, never>;
1767
- }>, never, BrowserActions>;
1768
- };
1769
- /**
1770
- * Define model-driven browser tools and their matching handlers together. Include `toolkit` in
1771
- * your Agent and provide `layer()` once per page/run. Requires BrowserActions; the library never
1772
- * chooses a provider or opens a browser. For decision-model control without an agent, use `runJev`.
1773
- */
1774
- export declare function make(options: {
1775
- mode: "batched";
1776
- }): typeof batched;
1777
- export declare function make(options?: {
1778
- mode?: "single";
1779
- }): typeof single;
1780
- export declare function make(options?: {
1781
- mode?: "single" | "batched";
1782
- }): typeof single | typeof batched;
1783
- /** One Jev decision as it reached the browser. Dispatch is the native input receipt. */
1784
- export declare const JevStep: Schema.Struct<{
1785
- readonly operation: Schema.Literals<readonly ["CLICK", "TYPE_TEXT", "SELECT", "SCROLL_UP", "SCROLL_DOWN", "WAIT", "DONE", "BLOCKED"]>;
1786
- readonly target: Schema.NullOr<Schema.String>;
1787
- readonly text: Schema.NullOr<Schema.String>;
1788
- readonly dispatch: Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>;
1789
- readonly pageChanged: Schema.Boolean;
1790
- }>;
1791
- /** Why the loop ended. `done` is Jev's claim; verify the requested outcome independently. */
1792
- export declare const JevStop: Schema.Literals<readonly ["done", "blocked", "unchanged", "looping", "wait-cap", "step-budget", "decision-failed", "text-failed", "observation-failed", "input-unresolved"]>;
1793
- export declare const JevResult: Schema.Struct<{
1794
- readonly stop: Schema.Literals<readonly ["done", "blocked", "unchanged", "looping", "wait-cap", "step-budget", "decision-failed", "text-failed", "observation-failed", "input-unresolved"]>;
1795
- readonly message: Schema.String;
1796
- readonly steps: Schema.$Array<Schema.Struct<{
1797
- readonly operation: Schema.Literals<readonly ["CLICK", "TYPE_TEXT", "SELECT", "SCROLL_UP", "SCROLL_DOWN", "WAIT", "DONE", "BLOCKED"]>;
1798
- readonly target: Schema.NullOr<Schema.String>;
1799
- readonly text: Schema.NullOr<Schema.String>;
1800
- readonly dispatch: Schema.Literals<readonly ["not-dispatched", "acknowledged", "unknown"]>;
1801
- readonly pageChanged: Schema.Boolean;
1802
- }>>;
1803
- }>;
1804
- export declare const JevOptions: Schema.Struct<{
1805
- readonly goal: Schema.NonEmptyString;
1806
- /** A current observation the host already read, so the loop starts without another read. */
1807
- readonly observation: Schema.optionalKey<Schema.Struct<{
1808
- readonly text: Schema.String;
1809
- readonly controls: Schema.$Array<Schema.Struct<{
1810
- readonly ref: Schema.String;
1811
- readonly kind: Schema.String;
1812
- readonly name: Schema.String;
1813
- readonly value: Schema.String;
1814
- readonly options: Schema.$Array<Schema.String>;
1815
- readonly optionDetails: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1816
- readonly value: Schema.String;
1817
- readonly label: Schema.String;
1818
- readonly disabled: Schema.Boolean;
1819
- readonly selected: Schema.Boolean;
1820
- readonly index: Schema.optionalKey<Schema.Natural>;
1821
- }>>>;
1822
- readonly optionCount: Schema.optionalKey<Schema.Natural>;
1823
- readonly frame: Schema.optionalKey<Schema.String>;
1824
- readonly disabled: Schema.optionalKey<Schema.Boolean>;
1825
- readonly editable: Schema.optionalKey<Schema.Boolean>;
1826
- readonly checked: Schema.optionalKey<Schema.Boolean>;
1827
- /** Observed CSS evidence, never a substitute for native input revalidation. */
1828
- readonly pointerEvents: Schema.optionalKey<Schema.String>;
1829
- readonly attributes: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
1830
- }>>;
1831
- readonly page: Schema.optionalKey<Schema.Struct<{
1832
- readonly title: Schema.String;
1833
- readonly scrollY: Schema.Number;
1834
- readonly viewportHeight: Schema.Number;
1835
- readonly documentHeight: Schema.Number;
1836
- }>>;
1837
- readonly readyState: Schema.optionalKey<Schema.Literals<readonly ["loading", "interactive", "complete"]>>;
1838
- readonly truncated: Schema.optionalKey<Schema.Boolean>;
1839
- readonly frames: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1840
- readonly ref: Schema.String;
1841
- readonly name: Schema.String;
1842
- readonly url: Schema.String;
1843
- readonly inspected: Schema.optionalKey<Schema.Boolean>;
1844
- }>>>;
1845
- readonly tabs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1846
- readonly ref: Schema.String;
1847
- readonly url: Schema.String;
1848
- readonly active: Schema.Boolean;
1849
- }>>>;
1850
- readonly dialogs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1851
- readonly ref: Schema.String;
1852
- readonly type: Schema.Literals<readonly ["alert", "confirm", "prompt", "beforeunload"]>;
1853
- readonly message: Schema.String;
1854
- readonly defaultValue: Schema.String;
1855
- }>>>;
1856
- }>>;
1857
- readonly maxSteps: Schema.optionalKey<Schema.Int>;
1858
- }>;
1859
- /**
1860
- * Drive the browser with a native DecisionModel such as TypeSafe Jev, without an agent or planner.
1861
- * Each step sends one request: an operation question plus one speculative target question per
1862
- * operation, built from the current observation only. The LanguageModel writes field text, and
1863
- * only for TYPE_TEXT; configure it for JSON output. Input stays on observed refs with native
1864
- * guards and receipts; uncertain input stops the loop and is never replayed. `done` is a claim.
1865
- */
1866
- export declare const runJev: (options: {
1867
- readonly goal: string;
1868
- readonly observation?: {
1869
- readonly text: string;
1870
- readonly controls: readonly {
1871
- readonly ref: string;
1872
- readonly kind: string;
1873
- readonly name: string;
1874
- readonly value: string;
1875
- readonly options: readonly string[];
1876
- readonly optionDetails?: readonly {
1877
- readonly value: string;
1878
- readonly label: string;
1879
- readonly disabled: boolean;
1880
- readonly selected: boolean;
1881
- readonly index?: number | undefined;
1882
- }[] | undefined;
1883
- readonly optionCount?: number | undefined;
1884
- readonly frame?: string | undefined;
1885
- readonly disabled?: boolean | undefined;
1886
- readonly editable?: boolean | undefined;
1887
- readonly checked?: boolean | undefined;
1888
- readonly pointerEvents?: string | undefined;
1889
- readonly attributes?: {
1890
- readonly [x: string]: string;
1891
- } | undefined;
1892
- }[];
1893
- readonly page?: {
1894
- readonly title: string;
1895
- readonly scrollY: number;
1896
- readonly viewportHeight: number;
1897
- readonly documentHeight: number;
1898
- } | undefined;
1899
- readonly readyState?: "complete" | "interactive" | "loading" | undefined;
1900
- readonly truncated?: boolean | undefined;
1901
- readonly frames?: readonly {
1902
- readonly ref: string;
1903
- readonly name: string;
1904
- readonly url: string;
1905
- readonly inspected?: boolean | undefined;
1906
- }[] | undefined;
1907
- readonly tabs?: readonly {
1908
- readonly ref: string;
1909
- readonly url: string;
1910
- readonly active: boolean;
1911
- }[] | undefined;
1912
- readonly dialogs?: readonly {
1913
- readonly ref: string;
1914
- readonly type: "alert" | "beforeunload" | "confirm" | "prompt";
1915
- readonly message: string;
1916
- readonly defaultValue: string;
1917
- }[] | undefined;
1918
- } | undefined;
1919
- readonly maxSteps?: number | undefined;
1920
- }) => Effect.Effect<{
1921
- readonly stop: "blocked" | "decision-failed" | "done" | "input-unresolved" | "looping" | "observation-failed" | "step-budget" | "text-failed" | "unchanged" | "wait-cap";
1922
- readonly message: string;
1923
- readonly steps: readonly {
1924
- readonly operation: "BLOCKED" | "CLICK" | "DONE" | "SCROLL_DOWN" | "SCROLL_UP" | "SELECT" | "TYPE_TEXT" | "WAIT";
1925
- readonly target: string | null;
1926
- readonly text: string | null;
1927
- readonly dispatch: "acknowledged" | "not-dispatched" | "unknown";
1928
- readonly pageChanged: boolean;
1929
- }[];
1930
- }, BrowserUseError, BrowserActions | BrowserControl | DecisionModel.DecisionModel | LanguageModel.LanguageModel>;
164
+ };
165
+ }, never>;
1931
166
  //#endregion
1932
167
  export { BrowserUse_d_exports as t };
1933
168
  //# sourceMappingURL=BrowserUse.d.mts.map