@wenathlan/extension 1.1.58 → 1.1.60

package/dist/types.d.ts

@@ -1,9 +1,9 @@
-export declare const protocolversion: "1.1.58";
+export declare const protocolversion: "1.1.60";
 /** Every reviewed action kind. Read kinds observe, interaction kinds move focus, sensitive kinds change page or browser state. */
 export type actionkind = "observe" | "inspect" | "extract" | "wait" | "waitfor" | "waittext" | "readattribute" | "readstyle" | "readgeometry" | "readvalue" | "readtext" | "readhtml" | "countelements" | "readtable" | "readlinks" | "readimages" | "readmeta" | "readforms" | "readstorage" | "highlight" | "tablist" | "windowlist" | "tabsnapshot" | "focus" | "scroll" | "hover" | "clickdeep" | "rightclick" | "doubleclick" | "scrollpage" | "scrollby" | "scrollend" | "scrolltop" | "fullscreen" | "zoomset" | "click" | "type" | "navigate" | "select" | "presskey" | "drag" | "drop" | "upload" | "clear" | "check" | "uncheck" | "toggle" | "submit" | "reload" | "back" | "forward" | "writestorage" | "setattribute" | "removeattribute" | "evaluate" | "tabcreate" | "tabactivate" | "tabclose" | "tabreload" | "windowcreate" | "windowclose" | "windowresize" | "downloadfile" | "movepointer" | "clickpoint" | "shiftclick" | "clicktext" | "clickaria" | "clickname" | "resolvexpath" | "typetime" | "appendtext" | "setvalue" | "typeedit" | "keyhold" | "keyrelease" | "submitsearch" | "selectmulti" | "chooseradio" | "setslider" | "setdate" | "setcolor" | "expanddetails" | "dismissdialog" | "pierceshadow" | "enterframe" | "retryaction" | "mapclicks" | "verifyvisible" | "verifyenabled" | "a11ytree" | "readvisible" | "readertree" | "detectlists" | "detecttables" | "readjson" | "watchmutate" | "waitquiet" | "watchbanner" | "detectinfinitescroll" | "detectvirtual" | "detectlazy" | "readscrollpos" | "readlang" | "readoutline" | "countpages" | "listshadow" | "listframes" | "classifypage" | "fingerprintsection" | "diffsnapshots" | "readselection" | "watchfocus" | "detectsticky" | "detectscrolllock" | "readopengraph" | "detectlanguage" | "deriveselector" | "openlink" | "openprivate" | "reloadcache" | "stopnav" | "waitload" | "waiturl" | "followlink" | "spanav" | "spawait" | "rewritequery" | "setfragment" | "navlist" | "navprofile" | "detecthttp" | "readredirects" | "readfinalurl" | "handleauth" | "printpdf" | "prefetch" | "preconnect" | "deeplink" | "reopentab" | "trailaudit" | "pausenav" | "navintent" | "navrate" | "openclipboard" | "checksafe" | "batchopen" | "querytabs" | "duplicatetab" | "closepattern" | "pintab" | "mutetab" | "movetab" | "movetabwindow" | "grouptabs" | "colorgroup" | "collapsegroup" | "discardtab" | "reloadtabs" | "zoomin" | "zoomout" | "watchtab" | "switchtab" | "maximizewindow" | "minimizewindow" | "restorewindow" | "focuswindow" | "scratchwindow" | "incognitowindow" | "restoretab" | "savelayout" | "restorelayout" | "findclones" | "searchtabs" | "badgetab" | "attachmeta" | "listaudio" | "reopenrun" | "snapshotsession" | "fillform" | "filllabel" | "fillplaceholder" | "detectfields" | "generatevalues" | "saveprofiles" | "asksubmit" | "submitform" | "readerrors" | "retryform" | "runwizard" | "selectchain" | "picktypeahead" | "pickdate" | "attachfile" | "handoffcaptcha" | "fillcard" | "fillcode" | "consentpassword" | "skiphoneypot" | "detectlogin" | "detecttemplate" | "scrapetable" | "exportcsv" | "exportjson" | "exportexcel" | "copytable" | "pushsheets" | "importcsv" | "looprows" | "transformvalues" | "deduperows" | "paginateextract" | "mergepages" | "stamplerows" | "previewgrid" | "streamdisk" | "resumeextract" | "logprovenance" | "batchdownload" | "pausedownload" | "resumedownload" | "verifydownload" | "interceptmime" | "exportnetlog" | "readclipboard" | "writeclipboard" | "copyscreen" | "quarantinedownload" | "scanvirus" | "namecaptures" | "cleanupartifacts" | "shotview" | "shotfullpage" | "shotelement" | "shotregion" | "contactsheet" | "capturepdf" | "recordscreen" | "captureaudio" | "captureframe" | "downloadimages" | "shotcanvas" | "probestream" | "readmedia" | "readassets" | "timelapse" | "convertimage" | "makethumbs" | "fetchurl" | "parsejson" | "parsehtml" | "callrest" | "callgraphql" | "opensocket" | "sendmessage" | "waitmessage" | "watchrequests" | "readheaders" | "capturebodies" | "subscribesse" | "longpoll" | "mapapi" | "extractapi" | "blockrequest" | "mockresponse" | "rewriteheaders" | "setcookies" | "readcookies" | "clearcookies" | "authflow" | "saveapikey" | "routeproxy" | "postform" | "postfiles" | "watchconsole" | "watcherrors" | "watchtasks" | "attachcdp" | "detachcdp" | "cdpcmd" | "watchcdp" | "setbreakpoint" | "stepcode" | "watchexpr" | "overridescript" | "measureflow" | "heapshot" | "trackmemory" | "profilecpu" | "watchshifts" | "traceload" | "annotatetrace" | "replaytrace" | "capturesourcemaps" | "emulatedevice" | "emulatenetwork" | "emulatelocate" | "setuseragent" | "overridepermission" | "blackboxscripts" | "persiststate" | "capturesession" | "restoresession" | "namedsessions" | "diffsessions" | "searchsessions" | "exportsessions" | "importsessions" | "composeworkflow" | "savetemplate" | "runworkflow" | "dryrun" | "delay" | "waitelement" | "compute" | "extractvars" | "listruns" | "condition" | "branch" | "loop" | "repeatuntil" | "whileloop" | "foreach" | "parallel" | "trycatch" | "visitrule" | "urlrule" | "menurule" | "keyrule" | "buttonrule" | "cronrule" | "intervalrule" | "urllistrule" | "webhookrule" | "eventrule";
 export type actionrisk = "read" | "interaction" | "sensitive";
 export type planstate = "draft" | "pending" | "approved" | "rejected" | "expired" | "completed" | "cancelled";
-export type auditkind = "configure" | "session" | "observe" | "proposal" | "approval" | "action" | "error" | "stop" | "pause" | "resume" | "complete" | "capability" | "tab" | "window" | "download" | "pointer" | "dialog" | "hold" | "retry" | "observation" | "watch" | "diff" | "navigation" | "redirect" | "auth" | "prefetch" | "rate" | "group" | "layout" | "discard" | "badge" | "fill" | "submit" | "consent" | "handoff" | "scrape" | "export" | "stream" | "provenance" | "resume" | "intercept" | "clipboard" | "quarantine" | "cleanup" | "capture" | "media" | "call" | "socket" | "replay" | "control" | "timeline" | "debugger" | "profile" | "emulation" | "workflow" | "trigger" | "protocol" | "tool" | "model" | "swarm";
+export type auditkind = "configure" | "session" | "observe" | "proposal" | "approval" | "action" | "error" | "stop" | "pause" | "resume" | "complete" | "capability" | "tab" | "window" | "download" | "pointer" | "dialog" | "hold" | "retry" | "observation" | "watch" | "diff" | "navigation" | "redirect" | "auth" | "prefetch" | "rate" | "group" | "layout" | "discard" | "badge" | "fill" | "submit" | "consent" | "handoff" | "scrape" | "export" | "stream" | "provenance" | "resume" | "intercept" | "clipboard" | "quarantine" | "cleanup" | "capture" | "media" | "call" | "socket" | "replay" | "control" | "timeline" | "debugger" | "profile" | "emulation" | "workflow" | "trigger" | "protocol" | "tool" | "model" | "swarm" | "environment" | "worker" | "sandbox";
 /** Observation mode classes: passive capture, watched lifetimes and diffing passes. */
 export type observationmode = "passive" | "watching" | "diffing";
 export interface toolstep {
@@ -15,6 +15,8 @@ export interface toolstep {
     options?: string;
     summary: string;
     risk: actionrisk;
+    /** The execution environment this step names: pagecontext, isolatedworld, offscreenworker or sandboxframe; an absent field routes to the default environment of the kind. */
+    environment?: environmentkind;
 }
 export interface agentplan {
     id: string;
@@ -37,6 +39,8 @@ export interface agentsession {
     pausedat?: number;
     /** Origins granted to this session; prepared for multi origin work. */
     grants?: string[];
+    /** Execution environments granted to this session beside the origin grants: pagecontext, isolatedworld, offscreenworker and sandboxframe; an absent list keeps the documented default posture while a configured list narrows every step to its entries. */
+    environmentgrants?: environmentkind[];
 }
 export interface endpointconfig {
     endpoint: string;
@@ -62,6 +66,8 @@ export interface observation {
         label: string;
     }>;
     capturedat: number;
+    /** The execution environment of the capture: pagecontext snapshots read the live page while offscreenworker parses hand the heavy shaping to the worker pool. */
+    environment?: environmentkind;
     /** Observation mode of this capture: passive, watching or diffing. */
     mode?: observationmode;
     /** Accessibility tree section captured by the page walker. */
@@ -130,6 +136,8 @@ export interface stepoutcome {
     ok: boolean;
     summary: string;
     details?: Record<string, unknown>;
+    /** The execution environment the step ran in, reported beside the outcome. */
+    environment?: environmentkind;
     at: number;
 }
 /** User chosen retention windows; an absent value keeps everything forever. */
@@ -188,6 +196,28 @@ export interface runsettings {
     claimwindow?: number;
     /** Retention window for stored agent mailbox messages; an absent window keeps every message while the unread counters always survive. */
     mailboxretention?: number;
+    /** User configured consensus quorum of the swarm: the number of yes votes a consensus round needs to carry; an absent value leaves the quorum to the round the user opens. */
+    swarmquorum?: number;
+    /** User configured ceiling on the worker lane of the leader worker topology; an absent value stays unbounded because the worker scale stays a user choice with no engine cap. */
+    swarmworkers?: number;
+    /** Retention window for stored progressboard snapshots; an absent window keeps every snapshot while the board itself always rebuilds from the live swarm state. */
+    boardretention?: number;
+    /** The verification methods the user allows the verifier agents to use; an empty or absent list keeps every method open as the documented user choice. */
+    verifiermethods?: string[];
+    /** True when the user turns the parse offload on: heavy parsing steps route into the offscreen worker pool instead of the page; an absent value keeps every parse inside the page. */
+    parseoffload?: boolean;
+    /** The worker pool size of the offscreen document as a user choice with no hard cap; an absent value lets the pool follow the pending parse queue alone. */
+    workerpoolsize?: number;
+    /** Retention window for stored run state records; an absent window keeps every run state while the keepalive summaries always survive. */
+    runstateretention?: number;
+    /** The origins the user allows to render untrusted markup inside the sandboxframe; an absent list keeps every origin open as the documented user choice. */
+    sandboxorigins?: string[];
+    /** The keepalive heartbeat interval in milliseconds; the roadmap documents thirty seconds while the interval stays the user's choice. */
+    keepaliveinterval?: number;
+    /** The number of silent heartbeat intervals the zombie reaper tolerates before it reaps a run; the roadmap documents three while the number stays the user's choice. */
+    zombieintervals?: number;
+    /** User configured byte ceiling for the stored run state; an absent value never prunes because the pressure response stays a user choice only. */
+    runstatebytes?: number;
 }
 export interface proposalrequest {
     objective: string;
@@ -210,6 +240,10 @@ export interface planprogress {
     outcomes?: stepoutcome[];
     /** Tabs assigned to the running task so progress tracks work across its tabs. */
     tasktabs?: number[];
+    /** The execution environment of every completed step by step id. */
+    environments?: Record<string, environmentkind>;
+    /** The worker turnaround of every offloaded step by step id, in milliseconds. */
+    turnarounds?: Record<string, number>;
     /** Prior progress snapshots preserved when a new plan replaces the tracked one. */
     prior?: planprogress[];
     updatedat: number;
@@ -3669,8 +3703,8 @@ export interface tokenstream {
  */
 /** The lifecycle states of one agent of the swarm: active, paused by the user or stopped. */
 export type agentstate = "active" | "paused" | "stopped";
-/** The role an agent plays. The three internal roles carry their documented defaults while the user may attach any custom role name; a custom role grades with the worker defaults until the user narrows its scope. */
-export type agentrole = "planner" | "worker" | "observer" | (string & {});
+/** The role an agent plays. The five internal roles carry their documented defaults while the user may attach any custom role name; a custom role grades with the worker defaults until the user narrows its scope. */
+export type agentrole = "planner" | "worker" | "observer" | "critic" | "verifier" | (string & {});
 /** One agent identity of the swarm: the id, the user chosen name for dashboards and audit, the role, the bound tab and session, the parent of a sub agent with its depth, the lifecycle state and the per agent budget and scope the user configured. */
 export interface agentidentity {
     id: string;
@@ -3841,4 +3875,410 @@ export interface swarmstate {
     mailboxes: agentmailbox[];
     killswitch: killswitch;
 }
+/**
+ * Multi agent part two contracts of the 1.1.59 family: the leader worker topology with worker assignments, critic reviews and verifier checks over agent outputs, the planner executor split, tab handoffs between agents mid run, resource locks keyed by origin and selector with conflict scans, result merging with provenance into one report, the progressboard layout, review requests between agents, escalations that lift an agent decision to the user, arbitration rules that order competing resource claims and consensus rounds with quorum.
+ * Every value here stays a user choice: the election rule, the worker scale bound, the quorum, the lock kinds and the merge rules carry no code default, and coordination never bypasses the human review.
+ */
+/** The verdict of one critic review: approve passes the output, changes demands the listed rework and reject refuses the output. */
+export type reviewverdict = "approve" | "changes" | "reject";
+/** The leader worker topology of one swarm: the leader agent id, the worker, critic and verifier lanes and every worker assignment; the rule names how the leader was elected. */
+export interface leaderworker {
+    id: string;
+    leaderid: string;
+    workerids: string[];
+    criticids: string[];
+    verifierids: string[];
+    assignments: workerassignment[];
+    /** The user configured election rule that picked the leader: `first` takes the first registration while `named` takes the agent the user named. */
+    rule: {
+        kind: "first" | "named";
+        agentid?: string;
+    };
+    electedat: number;
+}
+/** One assignment linking a worker to a task slice: the worker id, the task id, the slice description in plain language and the assignment time. */
+export interface workerassignment {
+    workerid: string;
+    taskid: string;
+    /** The slice of the task this worker owns, in plain language; the review reads it exactly as typed. */
+    slice: string;
+    assignedat: number;
+}
+/** One critic review of an agent output: the critic agent, the reviewed agent and task, the verdict, the issues found and the changes the output requires. */
+export interface criticreview {
+    id: string;
+    reviewerid: string;
+    subjectagentid: string;
+    taskid?: string;
+    verdict: reviewverdict;
+    issues: string[];
+    requiredchanges: string[];
+    reviewedat: number;
+}
+/** The outcome of one verifier check: pass confirms the claim against the page while fail refutes it. */
+export type verifieroutcome = "pass" | "fail";
+/** One verifier check of a result claim: the verifier agent, the agent whose claim is checked, the claim in plain language, the method the verifier used and the pass or fail outcome with its evidence. */
+export interface verifiercheck {
+    id: string;
+    verifierid: string;
+    claimagentid: string;
+    taskid?: string;
+    claim: string;
+    /** The verification method the verifier used, named by the user; the method grade reads it. */
+    method: string;
+    outcome: verifieroutcome;
+    evidence?: string;
+    checkedat: number;
+}
+/** The planner executor split of one task: the plan owner agent drafts while the run owner agent executes, and the executor reports every step outcome back to the planner. */
+export interface plannerexecutor {
+    id: string;
+    planownerid: string;
+    runownerid: string;
+    taskid?: string;
+    stepreports: executorreport[];
+    splitat: number;
+}
+/** One step outcome an executor reports back to the planner agent: the step id, the outcome, the detail in plain language and the report time. */
+export interface executorreport {
+    stepid: string;
+    outcome: "done" | "failed";
+    detail: string;
+    reportedat: number;
+}
+/** The states of one tab handoff: prepared packages the transfer, transferred moved the tab binding and resumed continued the task from the packaged state. */
+export type handoffstate = "prepared" | "transferred" | "resumed";
+/** One handoff request: the transferring agent, the receiving agent, the tab id and the packaged task state with the reason; the transfer preserves the original session grants. */
+export interface handoffrequest {
+    id: string;
+    fromagentid: string;
+    toagentid: string;
+    tabid?: number;
+    /** The packaged task state in plain language; the resume continues exactly from it. */
+    taskstate: string;
+    reason?: string;
+    createdat: number;
+}
+/** One handoff record: from and to agents, the tab, the packaged task state, the handoff state and the transfer and resume times. */
+export interface handoffrecord {
+    id: string;
+    fromagentid: string;
+    toagentid: string;
+    tabid?: number;
+    taskstate: string;
+    state: handoffstate;
+    reason?: string;
+    createdat: number;
+    transferredat?: number;
+    resumedat?: number;
+}
+/** The kinds of one resource lock: exclusive holds the resource alone while shared admits further shared holders only. */
+export type lockkind = "exclusive" | "shared";
+/** One resource lock of the swarm: the key composed of exactly one origin and one selector so a lock never spans unrelated origins, the holder agent, the kind and the expiry. */
+export interface resourcelock {
+    /** The lock key composed of the origin and the selector; the scope gate refuses keys that span more than one origin. */
+    key: string;
+    holder: string;
+    kind: lockkind;
+    origin: string;
+    selector: string;
+    acquiredat: number;
+    /** User configured expiry time; a lock past its expiry returns to the pool on the sweep. */
+    expiresat?: number;
+}
+/** One writer of a conflict scan: the agent, the origin and selector it targets and its task. */
+export interface conflictwriter {
+    agentid: string;
+    origin: string;
+    selector: string;
+    taskid?: string;
+}
+/** One conflict scan result: the writers examined, the overlapping targets with their writers, the suggested ordering and the clean marker when no writes overlap. */
+export interface conflictscan {
+    id: string;
+    writers: conflictwriter[];
+    overlaps: Array<{
+        origin: string;
+        selector: string;
+        writers: string[];
+    }>;
+    /** The suggested ordering of the writers for the overlapping targets, by agent id so the suggestion stays deterministic. */
+    suggestedorder: string[];
+    clean: boolean;
+    scannedat: number;
+}
+/** The merge rules for duplicate rows and conflicting values: first keeps the earliest value, last keeps the latest, preferagent keeps the value of the agent the user named and fail refuses the merge. */
+export type mergerule = "first" | "last" | "preferagent" | "fail";
+/** One merge entry mapping a parallel result into the final report: the agent, its task, the key and value and the conflict resolution note when other agents wrote the same key. */
+export interface mergeentry {
+    id: string;
+    agentid: string;
+    taskid?: string;
+    key: string;
+    value: string;
+    /** The conflict resolution note in plain language; an entry without a conflict carries none. */
+    conflict?: string;
+    mergedat: number;
+}
+/** One section of a result report: the title, the merged entries and the agents that sourced them. */
+export interface reportsection {
+    title: string;
+    entries: mergeentry[];
+    sources: string[];
+}
+/** One result report across agents: the sections, the contributing agent sources and the confidence the user reviews; every merged value keeps its provenance. */
+export interface resultreport {
+    id: string;
+    title: string;
+    sections: reportsection[];
+    sources: string[];
+    /** The confidence in the report stated in plain language; the value stays what the agents reported, never an engine score. */
+    confidence?: string;
+    createdat: number;
+}
+/** One milestone of a progressboard lane: the label, the done marker and the time the milestone completed. */
+export interface boardmilestone {
+    label: string;
+    done: boolean;
+    at?: number;
+}
+/** One lane of the progressboard: the agent, its role, its lifecycle state, its lane name, the current task and the milestones of its run. */
+export interface boardlane {
+    agentid: string;
+    name: string;
+    role: string;
+    state: string;
+    lane: string;
+    currenttask?: string;
+    milestones: boardmilestone[];
+}
+/** The progressboard layout of one swarm: one lane per agent so the user reads every agent at once, with the milestones each agent reported. */
+export interface progressboard {
+    id: string;
+    lanes: boardlane[];
+    builtat: number;
+}
+/** The states of one review request between agents: open waits, acked confirms receipt, answered carries the verdict and timeout expired unanswered. */
+export type reviewrequeststate = "open" | "acked" | "answered" | "timeout";
+/** One review request routed between agents: the requesting agent, the reviewing agent, the subject and payload and the ack, answer and timeout times. */
+export interface reviewrequest {
+    id: string;
+    fromagentid: string;
+    toagentid: string;
+    subject: string;
+    payload: string;
+    state: reviewrequeststate;
+    requestedat: number;
+    ackedat?: number;
+    answeredat?: number;
+    /** The user configured answer deadline; a request past it without an answer times out on the sweep. */
+    timeoutat?: number;
+}
+/** One escalation that lifts an agent decision to the user: the agent, the subject, the full context and the decision only the user writes. */
+export interface escalationrecord {
+    id: string;
+    agentid: string;
+    subject: string;
+    context: string;
+    state: "open" | "decided";
+    /** The decision the user wrote; an open escalation carries none because escalations stay human decided. */
+    decision?: string;
+    raisedat: number;
+    decidedat?: number;
+}
+/** The arbitration strategies that order competing resource claims: priority follows the user ordered agent list, age gives the oldest claim the resource and leader lets the elected leader decide. */
+export type arbitrationstrategy = "priority" | "age" | "leader";
+/** One arbitration rule the user configures: the strategy and, for the priority strategy, the agent order that wins competing claims. */
+export interface arbitrationrule {
+    id: string;
+    strategy: arbitrationstrategy;
+    /** The user ordered agent ids of the priority strategy; the first named agent wins a competing claim. */
+    priorityorder: string[];
+    configuredat: number;
+}
+/** One vote of a consensus round: yes, no or abstain with the voting agent and the time. */
+export type consensusvote = "yes" | "no" | "abstain";
+/** One consensus round: the subject, the collected votes, the user configured quorum and the state the votes resolve. */
+export interface consensusround {
+    id: string;
+    subject: string;
+    votes: Array<{
+        agentid: string;
+        vote: consensusvote;
+        votedat: number;
+    }>;
+    /** The number of yes votes the round needs to carry; a user configured value with no engine default. */
+    quorum: number;
+    state: "open" | "carried" | "failed";
+    openedat: number;
+    closedat?: number;
+}
+/** One interleaved action of the swarm timeline: the kind, the agent it names, the summary in plain language and the time. */
+export interface swarmaction {
+    id: string;
+    kind: string;
+    agentid?: string;
+    summary: string;
+    at: number;
+}
+/** The shared cost accounting of one swarm: the per agent usage summed into the swarm totals of tokens, cost and steps. */
+export interface swarmcost {
+    agents: number;
+    tokens: number;
+    cost: number;
+    steps: number;
+    currency?: string;
+    computedat: number;
+}
+/** One comparison of competing agent outputs for the user: the subject, the outputs per agent and the differences the comparison names. */
+export interface outputcomparison {
+    id: string;
+    subject: string;
+    outputs: Array<{
+        agentid: string;
+        value: string;
+    }>;
+    differences: string[];
+    comparedat: number;
+}
+/**
+ * Execution environment contracts of the 1.1.60 family.
+ * Every reviewed step names the concrete environment it executes in: pagecontext runs inside the live page, isolatedworld runs injected logic that page scripts cannot touch, offscreenworker moves heavy parsing into an offscreen document worker pool and sandboxframe renders untrusted markup inside a sandboxed page with no extension privileges.
+ * The consent gates do not move: every environment executes only reviewed steps against granted origins, and no environment ever bypasses the human review.
+ */
+/** The execution environments of the 1.1.60 family: the live page, the isolated world of the scripting api, the offscreen document worker pool and the sandboxed frame. */
+export type environmentkind = "pagecontext" | "isolatedworld" | "offscreenworker" | "sandboxframe";
+/** The per kind environment profile the policy exposes: the environments the kind may run in and the default the executor routes to. */
+export interface environmentrequirement {
+    kind: actionkind;
+    environments: environmentkind[];
+    defaultenvironment: environmentkind;
+}
+/** One executor traffic envelope for the offscreen worker pool: the parse family, the payload reference and the keys the executor moves as transferable buffers. */
+export interface workerrequest {
+    id: string;
+    runid: string;
+    stepid: string;
+    /** The parse family the worker executes such as htmlsnapshot, jsonpayload, tablerows, a11ytree, complexselector or stitchshots. */
+    task: string;
+    payload: string;
+    /** The payload keys the executor moves as transferable buffers where the payload carries them. */
+    transferables: string[];
+    sentat: number;
+}
+/** One worker answer to the executor: the finished result or one streamed partial chunk with its sequence number. */
+export interface workerresponse {
+    id: string;
+    requestid: string;
+    ok: boolean;
+    /** The finished result payload; a partial answer carries its chunk in the partial field instead. */
+    result?: string;
+    /** The sequence number of one streamed partial result; the final answer carries none. */
+    partial?: number;
+    summary: string;
+    receivedat: number;
+}
+/** One sandbox render descriptor: the sanitized markup, the per render nonce and the source origin of the untrusted markup. */
+export interface sandboxrender {
+    id: string;
+    nonce: string;
+    markup: string;
+    sourceorigin: string;
+    stepid: string;
+    renderedat: number;
+}
+/** The result of one sandbox render posted back through postmessage: the nonce it answers, the sanitized text and the render facts. */
+export interface sandboxrenderresult {
+    nonce: string;
+    ok: boolean;
+    text: string;
+    summary: string;
+    at: number;
+}
+/** One keepalive run state with start and stop events: the typed run state that holds a runtime port open while a run stays active and emits a heartbeat on every interval. */
+export interface keepalivestate {
+    runid: string;
+    sessionid: string;
+    state: "active" | "stopped";
+    startedat: number;
+    stoppedat?: number;
+    /** The user configured heartbeat interval in milliseconds; the roadmap documents thirty seconds while the interval stays the user's choice. */
+    interval: number;
+    beats: number;
+    lastbeatat: number;
+    portopen: boolean;
+    events: keepaliveevent[];
+}
+/** One keepalive lifecycle event: the start, a heartbeat, the stop or the reattach after a service worker restart. */
+export interface keepaliveevent {
+    kind: "start" | "heartbeat" | "stop" | "reattach";
+    at: number;
+    detail?: string;
+}
+/** One url history entry of a run: the url, the step that navigated and the time it landed in the run record. */
+export interface urlhistoryentry {
+    url: string;
+    stepid: string;
+    at: number;
+}
+/** The provenance attached to every persisted environment event: the origin, the step and the environment it names. */
+export interface environmentprovenance {
+    origin: string;
+    stepid: string;
+    environment: environmentkind;
+}
+/** The persisted run state of one run: the pending step for restart recovery, the url history, the environment and worker turnaround of every step, the keepalive trail and the zombie view. */
+export interface runstaterecord {
+    runid: string;
+    sessionid: string;
+    planid: string;
+    profileid: string;
+    state: "active" | "recovered" | "reaped" | "completed" | "expired";
+    /** The step that waits when a service worker restart interrupts the run; the executor resumes exactly it. */
+    pendingstepid?: string;
+    urlhistory: urlhistoryentry[];
+    /** The execution environment of every executed step by step id. */
+    environments: Record<string, environmentkind>;
+    /** The worker turnaround of every offloaded step by step id, in milliseconds. */
+    turnarounds: Record<string, number>;
+    keepalive: keepalivestate;
+    /** The provenance of the last persisted environment event. */
+    lastprovenance?: environmentprovenance;
+    updatedat: number;
+}
+/** One worker spawn or teardown event recorded beside step outcomes: the worker count of the pool and the reason of the change. */
+export interface workerevent {
+    id: string;
+    runid: string;
+    kind: "spawn" | "teardown";
+    workers: number;
+    reason: string;
+    provenance: environmentprovenance;
+    at: number;
+}
+/** One spawned offscreen document registry entry: the document, its reasons, its justification and its close time. */
+export interface offscreenregistryentry {
+    document: string;
+    runid: string;
+    reasons: string[];
+    justification: string;
+    createdat: number;
+    closedat?: number;
+}
+/** One storage level run lock that holds a session against concurrent runs. */
+export interface runlock {
+    sessionid: string;
+    runid: string;
+    holder: string;
+    acquiredat: number;
+    /** The user configured lock expiry; an absent expiry keeps the lock until its run releases it. */
+    expiresat?: number;
+}
+/** The sealed persistence envelope of one run state: the payload beside its sha-256 integrity digest so tampering with the persisted run state stays detectable at rest. */
+export interface sealedrunstate {
+    payload: string;
+    algorithm: "sha-256";
+    digest: string;
+    sealedat: number;
+}
 //# sourceMappingURL=types.d.ts.map