fastbrowse 0.5.19 → 0.5.20

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.
@@ -18,7 +18,7 @@ export type JsonValue = unknown;
18
18
  * What the server sends without being asked.
19
19
  */
20
20
  export type ServerMethod = 'run/event' | 'run/frame' | 'run/until' | 'secrets/resolve';
21
- export type Operation = 'click' | 'hover' | 'drag' | 'fill' | 'select' | 'enter' | 'escape' | 'scroll' | 'scroll_up' | 'back' | 'switch_tab' | 'upload' | 'dialog' | 'read' | 'done' | 'escalate';
21
+ export type Operation = 'click' | 'hover' | 'drag' | 'fill' | 'select' | 'enter' | 'escape' | 'scroll' | 'scroll_up' | 'back' | 'switch_tab' | 'upload' | 'dialog' | 'read' | 'done' | 'escalate' | 'navigate';
22
22
  export type StepOutcome = 'executed' | 'covered' | 'stale' | 'failed';
23
23
  export type Status = 'complete' | 'unverified' | 'needs_confirmation' | 'needs_login' | 'blocked' | 'needs_input' | 'stuck' | 'budget_exceeded' | 'observation_limit' | 'unavailable' | 'error';
24
24
  export type Tripwire = 'no_progress' | 'action_repetition' | 'plan_stagnation';
@@ -102,11 +102,25 @@ export interface Evidence {
102
102
  start: number;
103
103
  end: number;
104
104
  quote: string;
105
+ /**
106
+ * The quote covers an entire downloaded text file, apart from surrounding whitespace.
107
+ */
108
+ complete_source: boolean;
109
+ control_context: SourceControl | null;
110
+ /**
111
+ * False for typed DOM observations whose quote is not literal rendered page text.
112
+ */
113
+ rendered_text: boolean;
105
114
  /**
106
115
  * The headings the quote sits under on the page: which record a bare "£10.69" is the price of.
107
116
  */
108
117
  heading_path: string[];
109
118
  }
119
+ export interface SourceControl {
120
+ role: string;
121
+ label: string;
122
+ context: string | null;
123
+ }
110
124
  /**
111
125
  * The client's side of the handshake.
112
126
  *
@@ -125,17 +139,20 @@ export interface Limits {
125
139
  * Steps that reached the page. A click whose element was redrawn before it landed dispatched nothing and is
126
140
  * not counted; the stall budget ends a page that keeps redrawing.
127
141
  */
128
- max_steps?: number;
142
+ max_steps?: number | null;
129
143
  /**
130
144
  * Logical Jev evaluations. A hedged or retried request adds cost but not a call.
131
145
  */
132
- max_jev_calls?: number;
133
- max_llm_calls?: number;
146
+ max_jev_calls?: number | null;
147
+ max_llm_calls?: number | null;
134
148
  /**
135
149
  * Bounds Jev and LLM spend as it happens. A cloud browser bills when it stops, after the run, so its
136
150
  * cost is reported in the result but cannot stop the run that incurred it.
137
151
  */
138
152
  max_dollars?: number | null;
153
+ /**
154
+ * Stops active work at the time budget. Returning also waits for owned request and browser cleanup.
155
+ */
139
156
  max_seconds?: number | null;
140
157
  }
141
158
  export interface LocalChrome {
@@ -281,6 +298,7 @@ export interface RunParams {
281
298
  until?: boolean;
282
299
  downloads?: string | null;
283
300
  record?: string | null;
301
+ cursor?: boolean;
284
302
  local?: boolean;
285
303
  chrome?: LocalChrome | null;
286
304
  cloud_profile?: string | null;
package/dist/run.d.ts CHANGED
@@ -66,6 +66,8 @@ export interface RunOptions extends PerRun<BrowserOptions> {
66
66
  downloads?: string;
67
67
  /** Where to write a video of the run. The server needs ffmpeg for it. */
68
68
  record?: string;
69
+ /** Draw visual cursor feedback for visible local Chrome on Linux X11 with Cua Driver. */
70
+ cursor?: boolean;
69
71
  secrets?: Secrets;
70
72
  /** Called with the address the run ended on. Anything but true keeps the run from `complete`. */
71
73
  until?: (url: string) => MaybePromise<boolean>;
package/dist/run.js CHANGED
@@ -51,6 +51,7 @@ export function runParams(runId, task, defaults, options) {
51
51
  output_schema: options.output && wireSchema(options.output),
52
52
  downloads: options.downloads,
53
53
  record: options.record,
54
+ cursor: options.cursor,
54
55
  secrets: options.secrets?.refs,
55
56
  // The wire carries whether a callback is held, and the callback stays here.
56
57
  frames: options.onFrame && true,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "fastbrowse",
3
- "version": "0.5.19",
3
+ "version": "0.5.20",
4
4
  "description": "Browser automation with cited answers, structured output and code-controlled credentials and authorization.",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -27,10 +27,10 @@
27
27
  "test": "npm run build && node --test \"test/*.test.ts\""
28
28
  },
29
29
  "optionalDependencies": {
30
- "@fastbrowse/darwin-arm64": "0.5.19",
31
- "@fastbrowse/darwin-x64": "0.5.19",
32
- "@fastbrowse/linux-arm64": "0.5.19",
33
- "@fastbrowse/linux-x64": "0.5.19",
34
- "@fastbrowse/win32-x64": "0.5.19"
30
+ "@fastbrowse/darwin-arm64": "0.5.20",
31
+ "@fastbrowse/darwin-x64": "0.5.20",
32
+ "@fastbrowse/linux-arm64": "0.5.20",
33
+ "@fastbrowse/linux-x64": "0.5.20",
34
+ "@fastbrowse/win32-x64": "0.5.20"
35
35
  }
36
36
  }