DocsWorkflowsComponentsMachinemachine:extension:replay

machine:extension:replay

Runs an already-authored fragment and says whether to trust what it returned. Authoring a fragment costs a model call per turn and a live browser session, so a workflow that authors on every run is paying that on every run for a page it already worked out. This is the fast path. It runs what was authored, holds the result against the contract that fragment promised, and reports a miss or a break rather than failing, because the caller's answer to both is the same and it is to author. A step error is the easy failure. The one that matters is the fragment that runs clean and returns nothing, which is what a site's redesign looks like from here. Every step reports ok, the run reports ok, and the rows are gone. The contract is the only thing standing between that and a workflow that quietly reads zero rows forever.

Options

Name	Type	Description
`workflow`	`Workflow`	The fragment authored for this intent, absent when none has been authored yet
↳ `id`	`string`	Uniquely names the workflow. Sequences reference library fragments by it.
↳ `name`	`string`	Is the human-readable title shown in the extension UI.
↳ `target`	`TargetConfig`	Locates the page the workflow runs against and controls tab reuse.
↳ `url`	`string`	Is the address to open when no existing tab matches.
↳ `match_url`	`string`	Is a substring an existing tab's URL must contain for the run to reuse that tab instead of opening URL.
↳ `reuse_tab`	`bool`	Reuses a matching open tab instead of opening a new one. Nil means the extension default (true).
↳ `activate`	`bool`	Brings the target tab to the foreground. Nil means the extension default (true).
↳ `reload`	`bool`	Forces a page reload on a reused tab before the first step runs.
↳ `steps`	`[]Step`	Are the actions to perform, in order.
↳ `id`	`string`	Uniquely names the step within its workflow, echoed on its StepResult.
↳ `type`	`string`	Is the action to perform (click, fill, select, captureUrl, ...).
↳ `label`	`string`	Is a human-readable description shown in run progress UIs.
↳ `selector`	`Selector`	Picks the DOM node(s) the step acts on.
↳ `css`	`string`	Is a CSS selector.
↳ `path`	`string`	Is an explicit DOM path, used when CSS cannot express the target.
↳ `indexes`	`[]int`	Narrows a multi-match selector to these positions.
↳ `enter`	`[]string`	Names the subtrees CSS has to resolve inside, outermost first. Each entry selects a shadow host or an iframe, resolved in the tree the previous entry opened, so a control inside a web component inside a same-origin frame is reachable by one Selector. Empty runs CSS against the top document.
↳ `index`	`int`	Narrows a multi-match selector to a single position.
↳ `all`	`bool`	Expands the step to act on every match instead of the first.
↳ `value`	`string`	Is the input for value-taking steps such as fill and select. It may contain {{ variable }} placeholders.
↳ `format`	`string`	Names the shape extraction steps return their data in.
↳ `attribute`	`string`	Names the DOM attribute an extraction step reads.
↳ `fields`	`ExtractField`	Are the named columns an extractList step reads out of each item its selector matched. Key order is the column order, and every returned item carries every key.
↳ `limit`	`int`	Caps how many items an extractList step returns. The extension applies its own bound when this is zero, so a listing that lazily grew to ten thousand rows truncates and says so.
↳ `url`	`string`	Is the address for navigation steps.
↳ `fn`	`string`	Names the page function an eval step invokes.
↳ `args`	`[]any`	Are the arguments passed to Fn.
↳ `body_params`	`map[string]string`	Overrides or adds form fields on the request a captureDownload re-issues, and carries the parameters a captureUrl sends, in the query for a GET and form-encoded otherwise.
↳ `method`	`string`	Is the HTTP method a captureUrl step fetches its URL with, defaulting to GET.
↳ `filename`	`string`	Renames a captured file (captureDownload, captureUrl and capturePageFile). It may contain {{ variable }} placeholders.
↳ `output`	`string`	Chooses where a captured file goes, and the controlling client is its only destination.
↳ `wait`	`WaitConfig`	Blocks the step until a page condition holds.
↳ `selector`	`string`	Waits for a matching element to appear (or disappear, see Absent).
↳ `text`	`string`	Waits for this text to be present on the page.
↳ `url_includes`	`string`	Waits for the page URL to contain this substring.
↳ `absent`	`bool`	Flips the wait to expect the selector to disappear rather than appear.
↳ `delay_ms`	`int`	Is a fixed pause in milliseconds, applied on top of any condition.
↳ `timeout_ms`	`int`	Bounds the wait, in milliseconds.
↳ `prompt`	`string`	Is the text shown at a user gate asking for manual input.
↳ `continue_on`	`ContinueCondition`	Holds the step until a user gate is cleared or a page condition is met.
↳ `manual`	`bool`	Pauses the run for an explicit user continue.
↳ `selector`	`string`	Resumes when a matching element appears.
↳ `text`	`string`	Resumes when this text is present on the page.
↳ `url_includes`	`string`	Resumes when the page URL contains this substring.
↳ `timeout_ms`	`int`	Bounds the hold, in milliseconds.
↳ `timeout_ms`	`int`	Overrides the workflow's default step timeout, in milliseconds.
↳ `optional`	`bool`	Lets the run continue when this step fails.
↳ `condition`	`Condition`	Condition, when set, gates the step. If it does not hold, the step is skipped rather than failed.
↳ `selector`	`string`	Holds when a matching element exists on the page.
↳ `text`	`string`	Holds when the page (or the selected element) contains this text.
↳ `url_includes`	`string`	Holds when the page URL contains this substring.
↳ `match`	`string`	Decides how the set predicates combine, "any" or "all".
↳ `negate`	`bool`	Inverts the combined result.
↳ `store`	`string`	Names a slot the step's data is saved under, readable by later steps and returned on the WorkflowResult.
↳ `resume`	`ResumePoint`	Resume, when set, marks this step as a point a re-run may start at, and carries the predicate recognizing a browser already standing there.
↳ `id`	`string`	Names this point so a later point's Rewind can reach it. It is unique within one workflow.
↳ `when`	`Condition`	Recognizes the browser standing at this point.
↳ `selector`	`string`	Holds when a matching element exists on the page.
↳ `text`	`string`	Holds when the page (or the selected element) contains this text.
↳ `url_includes`	`string`	Holds when the page URL contains this substring.
↳ `match`	`string`	Decides how the set predicates combine, "any" or "all".
↳ `negate`	`bool`	Inverts the combined result.
↳ `rewind`	`Rewind`	Rewind, when set, is how the browser leaves this point for an earlier one.
↳ `to`	`string`	Names the resume point this reaches, which must sit earlier in the step list than the point declaring it.
↳ `url`	`string`	Navigates the tab back to the earlier point.
↳ `selector`	`string`	Clicks a control on the current page that leads back, for a flow whose way back is a button rather than an address.
↳ `wait`	`WaitConfig`	Holds until the page has settled after the rewind, before the target point's own predicate is checked again.
↳ `selector`	`string`	Waits for a matching element to appear (or disappear, see Absent).
↳ `text`	`string`	Waits for this text to be present on the page.
↳ `url_includes`	`string`	Waits for the page URL to contain this substring.
↳ `absent`	`bool`	Flips the wait to expect the selector to disappear rather than appear.
↳ `delay_ms`	`int`	Is a fixed pause in milliseconds, applied on top of any condition.
↳ `timeout_ms`	`int`	Bounds the wait, in milliseconds.
↳ `always`	`bool`	Runs the step even when re-entry starts the run past it, for work the page cannot report as already done.
↳ `options`	`WorkflowOptions`	Carries run-wide defaults such as the step timeout and the tab contention policy.
↳ `default_timeout_ms`	`int`	Is the per-step timeout in milliseconds for steps that do not set their own.
↳ `continue_on_error`	`bool`	Keeps the run going past a failed step instead of stopping at the first failure.
↳ `concurrency`	`string`	Is the contention policy when another run already holds the target tab, one of "queue" (default), "parallel", or "reject".
↳ `reentry`	`bool`	Lets a run start at a resume point the live page matches instead of replaying from the first step. Nil means the extension default (true), and an explicit false forces a clean run of a fragment that declares points.
↳ `condition`	`Condition`	Condition, when set, gates the whole workflow. If it does not hold, the run is skipped rather than failed.
↳ `selector`	`string`	Holds when a matching element exists on the page.
↳ `text`	`string`	Holds when the page (or the selected element) contains this text.
↳ `url_includes`	`string`	Holds when the page URL contains this substring.
↳ `match`	`string`	Decides how the set predicates combine, "any" or "all".
↳ `negate`	`bool`	Inverts the combined result.
`contract`	`ExtContract`	What the fragment promised to return, which is how a run that reported success and read nothing is told from one that worked
↳ `store`	`string`	Names the slot the rows land in, which is the store of the fragment's own extractList step.
↳ `fields`	`[]string`	Are the columns every healthy row carries. A column no row answers is a selector that stopped matching, whatever the run reported.
↳ `min_rows`	`int`	Is the fewest rows a healthy run returns, one by default. A listing that answers with nothing is the case this is here for.
↳ `file`	`bool`	Says the fragment's read is a captured file rather than a listing, so a healthy run is one that came back with bytes under a name. It is the same silence in a different shape, since a capture whose form moved answers with nothing and reports success.
`variables`	`map[string]string`	Per-run values injected into the fragment
`client_id`	`string`	The extension client to replay through, a hint the host may honour; empty leaves the choice of browser to the host
`timeout_ms`	`int`	How long to wait for the browser before giving up on the replay

Outputs

Name	Type	Description
`ok`	`bool`	Whether the fragment ran and honored its contract
`rows`	`[]map[string]any`	What it read, empty when it read nothing or never ran
`count`	`int`	How many rows came back
`stored`	`map[string]any`	Every slot the fragment filled, for a fragment that stores more than its rows
`missing`	`bool`	Whether there was no fragment to replay, which is the first run for an intent
`broken`	`bool`	Whether a fragment ran and did not hold up, either by failing a step or by honoring none of what it promised
`reason`	`string`	Why the replay did not hold up, in the words a repair reads
`failed_step`	`string`	The id of the step that errored, empty when nothing errored and the fragment simply read nothing
`author`	`bool`	Whether the caller has to reach for the authoring loop, which is a miss or a break and nothing else
`steps`	`[]Step`	The fragment's own steps, handed on so a repair starts from what was authored rather than from nothing
↳ `id`	`string`	Uniquely names the step within its workflow, echoed on its StepResult.
↳ `type`	`string`	Is the action to perform (click, fill, select, captureUrl, ...).
↳ `label`	`string`	Is a human-readable description shown in run progress UIs.
↳ `selector`	`Selector`	Picks the DOM node(s) the step acts on.
↳ `css`	`string`	Is a CSS selector.
↳ `path`	`string`	Is an explicit DOM path, used when CSS cannot express the target.
↳ `indexes`	`[]int`	Narrows a multi-match selector to these positions.
↳ `enter`	`[]string`	Names the subtrees CSS has to resolve inside, outermost first. Each entry selects a shadow host or an iframe, resolved in the tree the previous entry opened, so a control inside a web component inside a same-origin frame is reachable by one Selector. Empty runs CSS against the top document.
↳ `index`	`int`	Narrows a multi-match selector to a single position.
↳ `all`	`bool`	Expands the step to act on every match instead of the first.
↳ `value`	`string`	Is the input for value-taking steps such as fill and select. It may contain {{ variable }} placeholders.
↳ `format`	`string`	Names the shape extraction steps return their data in.
↳ `attribute`	`string`	Names the DOM attribute an extraction step reads.
↳ `fields`	`ExtractField`	Are the named columns an extractList step reads out of each item its selector matched. Key order is the column order, and every returned item carries every key.
↳ `limit`	`int`	Caps how many items an extractList step returns. The extension applies its own bound when this is zero, so a listing that lazily grew to ten thousand rows truncates and says so.
↳ `url`	`string`	Is the address for navigation steps.
↳ `fn`	`string`	Names the page function an eval step invokes.
↳ `args`	`[]any`	Are the arguments passed to Fn.
↳ `body_params`	`map[string]string`	Overrides or adds form fields on the request a captureDownload re-issues, and carries the parameters a captureUrl sends, in the query for a GET and form-encoded otherwise.
↳ `method`	`string`	Is the HTTP method a captureUrl step fetches its URL with, defaulting to GET.
↳ `filename`	`string`	Renames a captured file (captureDownload, captureUrl and capturePageFile). It may contain {{ variable }} placeholders.
↳ `output`	`string`	Chooses where a captured file goes, and the controlling client is its only destination.
↳ `wait`	`WaitConfig`	Blocks the step until a page condition holds.
↳ `selector`	`string`	Waits for a matching element to appear (or disappear, see Absent).
↳ `text`	`string`	Waits for this text to be present on the page.
↳ `url_includes`	`string`	Waits for the page URL to contain this substring.
↳ `absent`	`bool`	Flips the wait to expect the selector to disappear rather than appear.
↳ `delay_ms`	`int`	Is a fixed pause in milliseconds, applied on top of any condition.
↳ `timeout_ms`	`int`	Bounds the wait, in milliseconds.
↳ `prompt`	`string`	Is the text shown at a user gate asking for manual input.
↳ `continue_on`	`ContinueCondition`	Holds the step until a user gate is cleared or a page condition is met.
↳ `manual`	`bool`	Pauses the run for an explicit user continue.
↳ `selector`	`string`	Resumes when a matching element appears.
↳ `text`	`string`	Resumes when this text is present on the page.
↳ `url_includes`	`string`	Resumes when the page URL contains this substring.
↳ `timeout_ms`	`int`	Bounds the hold, in milliseconds.
↳ `timeout_ms`	`int`	Overrides the workflow's default step timeout, in milliseconds.
↳ `optional`	`bool`	Lets the run continue when this step fails.
↳ `condition`	`Condition`	Condition, when set, gates the step. If it does not hold, the step is skipped rather than failed.
↳ `selector`	`string`	Holds when a matching element exists on the page.
↳ `text`	`string`	Holds when the page (or the selected element) contains this text.
↳ `url_includes`	`string`	Holds when the page URL contains this substring.
↳ `match`	`string`	Decides how the set predicates combine, "any" or "all".
↳ `negate`	`bool`	Inverts the combined result.
↳ `store`	`string`	Names a slot the step's data is saved under, readable by later steps and returned on the WorkflowResult.
↳ `resume`	`ResumePoint`	Resume, when set, marks this step as a point a re-run may start at, and carries the predicate recognizing a browser already standing there.
↳ `id`	`string`	Names this point so a later point's Rewind can reach it. It is unique within one workflow.
↳ `when`	`Condition`	Recognizes the browser standing at this point.
↳ `selector`	`string`	Holds when a matching element exists on the page.
↳ `text`	`string`	Holds when the page (or the selected element) contains this text.
↳ `url_includes`	`string`	Holds when the page URL contains this substring.
↳ `match`	`string`	Decides how the set predicates combine, "any" or "all".
↳ `negate`	`bool`	Inverts the combined result.
↳ `rewind`	`Rewind`	Rewind, when set, is how the browser leaves this point for an earlier one.
↳ `to`	`string`	Names the resume point this reaches, which must sit earlier in the step list than the point declaring it.
↳ `url`	`string`	Navigates the tab back to the earlier point.
↳ `selector`	`string`	Clicks a control on the current page that leads back, for a flow whose way back is a button rather than an address.
↳ `wait`	`WaitConfig`	Holds until the page has settled after the rewind, before the target point's own predicate is checked again.
↳ `selector`	`string`	Waits for a matching element to appear (or disappear, see Absent).
↳ `text`	`string`	Waits for this text to be present on the page.
↳ `url_includes`	`string`	Waits for the page URL to contain this substring.
↳ `absent`	`bool`	Flips the wait to expect the selector to disappear rather than appear.
↳ `delay_ms`	`int`	Is a fixed pause in milliseconds, applied on top of any condition.
↳ `timeout_ms`	`int`	Bounds the wait, in milliseconds.
↳ `always`	`bool`	Runs the step even when re-entry starts the run past it, for work the page cannot report as already done.
`selector`	`string`	The css matching one item of the listing the fragment reads
`fields`	`ExtractField`	The columns the fragment reads out of each item
`store`	`string`	The slot the fragment's rows land in
`status`	`string`	How this replay is written down against the fragment it ran, `ok` for one that honored its contract and `failed` for one that did not, empty where there was nothing to replay and so nothing to record

Edit or read the source on GitHub