@wenathlan/extension 1.1.63 → 1.1.65

package/dist/types.d.ts

@@ -1,9 +1,9 @@
-export declare const protocolversion: "1.1.63";
+export declare const protocolversion: "1.1.65";
 /** 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" | "environment" | "worker" | "sandbox" | "grant" | "expiry" | "revoke" | "deny" | "seal" | "mask" | "vault" | "gate" | "phish" | "defer" | "schema" | "inbound" | "transparency" | "notes" | "scratchpad" | "summary" | "recall" | "correction" | "consentmemory" | "cancel" | "search";
+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" | "grant" | "expiry" | "revoke" | "deny" | "seal" | "mask" | "vault" | "gate" | "phish" | "defer" | "schema" | "inbound" | "transparency" | "notes" | "scratchpad" | "summary" | "recall" | "correction" | "consentmemory" | "cancel" | "search" | "palette" | "surface" | "onboarding" | "logstream" | "datagrid" | "quickaction" | "shortcut" | "omnibox" | "notify" | "picker" | "shotpanel" | "compare" | "siteprofile" | "theme" | "locale" | "importexport" | "tour" | "a11y" | "pagechip" | "toast" | "recent" | "dropimport";
 /** Observation mode classes: passive capture, watched lifetimes and diffing passes. */
 export type observationmode = "passive" | "watching" | "diffing";
 export interface toolstep {
@@ -244,6 +244,28 @@ export interface runsettings {
     cancelrollback?: "queued" | "none";
     /** The runsummary length window in steps the distillation keeps; an absent window keeps every step with no fixed cap. */
     summarywindow?: number;
+    /** The commandpalette recent window: the number of most used commands the ranking lifts first; an absent window ranks by match alone. */
+    paletterecents?: number;
+    /** The logstream live buffer bound: the number of newest events the live window keeps while the full history stays in memory; an absent bound keeps every event live. */
+    logstreambuffer?: number;
+    /** Retention window for stored taskinput history entries; an absent window keeps every entry. */
+    taskinputretention?: number;
+    /** The commandpalette keyboard shortcut every surface opens, such as "ctrl+."; an absent value keeps the documented default binding the surfaces ship. */
+    paletteshortcut?: string;
+    /** The byte ceiling above which diffpreview generation offloads to the offscreen worker pool when the user granted the offscreen capability; an absent ceiling keeps every diff inline. */
+    diffpreviewbytes?: number;
+    /** The recenttray depth: the number of latest runs the popup tray keeps; an absent depth keeps every run. */
+    recenttraydepth?: number;
+    /** True when the user consents to notifications that carry page content; an absent value keeps every notification body content free so no consent is needed. */
+    notifyconsent?: boolean;
+    /** True when the user turns the done and attention notifications on; an absent value keeps them on with content free bodies only. */
+    notifyenabled?: boolean;
+    /** The manual darklight override: dark or light forces the theme while system follows the os preference; an absent value follows the os preference alone. */
+    themepreference?: "dark" | "light" | "system";
+    /** The language of the interface strings; an absent value keeps english with the locale fallback. */
+    uilanguage?: string;
+    /** The steteoast live count: the number of newest step toasts the live stack keeps while the full history stays queryable; an absent count keeps every toast live. */
+    toastlivecount?: number;
 }
 export interface proposalrequest {
     objective: string;
@@ -4321,7 +4343,7 @@ export interface sealedrunstate {
 /** The sensitive classes of the 1.1.61 family: payment, credential, delete and publish steps each need one fresh consent prompt per class per origin. */
 export type sensitiveclass = "payment" | "credential" | "delete" | "publish";
 /** The event kinds of the immutable run log: step transitions, grants, window expiries, revocations, denials, suspensions, resumes and the completion seal. */
-export type logeventkind = "step" | "grant" | "expiry" | "revoke" | "deny" | "suspend" | "resume" | "seal" | "gate" | "phish" | "schema" | "inbound" | "cancel";
+export type logeventkind = "step" | "grant" | "expiry" | "revoke" | "deny" | "suspend" | "resume" | "seal" | "gate" | "phish" | "schema" | "inbound" | "cancel" | "review";
 /** The hash chain fields of one immutable log entry: the hash of its predecessor, the entry hash written at append time and the algorithm that derives both. */
 export interface loghash {
     previous: string;
@@ -4790,4 +4812,408 @@ export interface tabsessionref {
     origin: string;
     updatedat: number;
 }
+/**
+ * Interface surface contracts of the 1.1.64 family.
+ * The interface becomes a family of five surfaces here: the popup grows into a command surface, the sidepanel becomes the workspace with plan, run and review tabs, the dashboardpage opens a full page view in a new tab, the optionspage gathers every setting in one place and the onboarding walks a first run. The commandpalette registers entries from every module at startup, lists only the actions the current capability set allows and ranks fuzzy matches with the recent commands first; the taskinput submits natural language goals through the same proposal flow as the api with the active origin and page outline attached; plancards render one card per proposed step with kind, risk class, environment and options grouped by risk class with the sensitive classes expanded by default; stepapprove resolves one step per human action with approve, reject and edit provenance written into the immutable log; diffpreview compares the observed before state with the predicted after state of write class steps only with masked values carrying their mask verdicts; the stepstimeline derives its nodes from progress records with no new state; and the logstream renders live events with level, source and step ref while the single broadcast channel carries run state to every surface.
+ * The consent gates do not move: every surface action rides the same policy gates, the command bus records each routing in the audit trail, and no interface surface ever bypasses the human review.
+ */
+/** The interface surfaces of the 1.1.64 and 1.1.65 families: the popup command surface, the sidepanel workspace, the dashboardpage, the optionspage, the onboarding walkthrough, the omnibox entry point and the inline page surface of the pagechips. */
+export type uisurface = "popup" | "sidepanel" | "dashboardpage" | "optionspage" | "onboarding" | "omnibox" | "page";
+/** One commandpalette action: the command it routes, the surface it opens on, the optional permission it needs granted and whether it needs an active session. */
+export interface paletteaction {
+    command: string;
+    surface: uisurface;
+    /** The optional capability the command needs granted before the palette lists it; an absent permission needs none. */
+    permission?: string;
+    /** True when the command needs an active browser session before the palette lists it. */
+    session?: boolean;
+}
+/** One commandpalette entry: the id, the visible label, the keywords the fuzzy search matches and the action it routes through the command bus. */
+export interface paletteentry {
+    id: string;
+    label: string;
+    keywords: string[];
+    action: paletteaction;
+}
+/** One ranked commandpalette match: the entry, the fuzzy score and the plain language reason it ranked. */
+export interface palettematch {
+    entry: paletteentry;
+    score: number;
+    reason: string;
+}
+/** One taskinput submission: the natural language goal, the page outline context, the active origin scope and the surface it came from. */
+export interface taskinputsubmission {
+    id: string;
+    text: string;
+    context: string;
+    origin: string;
+    surface: uisurface;
+    at: number;
+}
+/** The proposal status the taskinput shows while a plan generates: idle, generating, ready or failed. */
+export type proposalstatus = "idle" | "generating" | "ready" | "failed";
+/** One stepstimeline node derived from progress records with no new state: the status, the duration, the environment badge, the active mark, the deep link anchor and the step result summary. */
+export interface stepstimelinenode {
+    stepid: string;
+    kind: string;
+    status: "pending" | "running" | "waiting" | "done" | "failed" | "halted";
+    durationms?: number;
+    environment?: environmentkind;
+    active: boolean;
+    anchor: string;
+    resultsummary?: string;
+}
+/** One logstream event of a live run: the level, the source that emitted it, the origin, the summary in plain language, the optional step ref, the mask verdict of its source payload and the hash chain link written at append time. */
+export interface logstreamevent {
+    id: string;
+    level: loglevel;
+    source: string;
+    origin: string;
+    summary: string;
+    stepid?: string;
+    masked: boolean;
+    maskverdict: string;
+    hash: loghash;
+    at: number;
+}
+/** One logstream filter: the level, origin or step ref the live view keeps. */
+export interface logstreamfilter {
+    level?: loglevel;
+    origin?: string;
+    stepid?: string;
+}
+/** One plancard of the plan review surface: the step id, the kind, the risk class, the execution environment, the reviewed options, the summary, the matching corrections from correctionmemory and the edit before approve offer. */
+export interface plancard {
+    stepid: string;
+    kind: string;
+    risk: actionrisk;
+    environment: environmentkind;
+    options: string;
+    summary: string;
+    corrections: Array<{
+        id: string;
+        source: string;
+        reason: string;
+    }>;
+    editable: boolean;
+}
+/** One plancard group of the plan review surface: the risk class of its cards and whether the group renders expanded; sensitive groups expand by default. */
+export interface plancardgroup {
+    risk: actionrisk;
+    cards: plancard[];
+    expanded: boolean;
+}
+/** One stepapprove resolution: the step it resolves, the plan it belongs to, the origin it ran on, the approve, reject or edit decision, the surface the distinct human action came from and the edited step shape an edit carries. */
+export interface stepapproveresolution {
+    stepid: string;
+    planid: string;
+    origin: string;
+    resolution: "approve" | "reject" | "edit";
+    surface: uisurface;
+    edited?: string;
+    at: number;
+}
+/** One diffpreview field change: the field name, the added, changed or removed class and the before and after values it carries. */
+export interface diffchange {
+    field: string;
+    kind: "added" | "changed" | "removed";
+    before?: string;
+    after?: string;
+}
+/** One diffpreview payload: the step it previews, the observed before state, the predicted after state, the field changes with added, changed and removed classes, the mask verdicts per field and the generation provenance. */
+export interface diffpreviewpayload {
+    stepid: string;
+    before: Record<string, string>;
+    after: Record<string, string>;
+    changes: diffchange[];
+    /** The mask verdict reason per field; an absent field carries no masked value. */
+    maskverdicts: Record<string, string>;
+    provenance: "inline" | "offscreenworker";
+}
+/** One onboarding step: the surface it walks, the title, the body and the completion event name its finish records. */
+export interface onboardingstep {
+    id: string;
+    surface: uisurface;
+    title: string;
+    body: string;
+    completion: string;
+}
+/** The onboarding state: the completed steps, the done mark, the single consent scoped event a full completion writes and the timestamps. */
+export interface onboardingstate {
+    stepscompleted: string[];
+    done: boolean;
+    consentevent?: string;
+    startedat?: number;
+    completedat?: number;
+}
+/** One surface action of the command bus: the surface it came from, the command it routes and the optional step and payload it carries. */
+export interface surfaceaction {
+    surface: uisurface;
+    command: string;
+    stepid?: string;
+    payload?: string;
+}
+/** One command bus routing verdict: whether the action dispatched, the gate that decided and the plain language reason. */
+export interface surfaceroute {
+    dispatched: boolean;
+    gate: string;
+    reason: string;
+}
+/** The broadcast channels of the single surface channel: run state, logstream events, session store updates and settings changes. */
+export type broadcastchannelkind = "runstate" | "logstream" | "sessions" | "settings";
+/** One broadcast frame of the single surface channel: the channel it rides, the emitting surface, the plain language summary and the time. */
+export interface broadcastframe {
+    channel: broadcastchannelkind;
+    surface: uisurface | "background";
+    summary: string;
+    at: number;
+}
+/** One per surface layout preference: the surface, the preference keys the user set and the update time; the preferences scope per profile workspace. */
+export interface surfacelayout {
+    surface: uisurface;
+    preferences: Record<string, string>;
+    updatedat: number;
+}
+/** One commandpalette usage record: the command, its use count and the last use time the recent first ranking reads. */
+export interface paletteuserecord {
+    command: string;
+    count: number;
+    lastusedat: number;
+}
+/**
+ * Interface surface contracts of the 1.1.65 family, part two.
+ * This family finishes the interface layer: the datagrid arranges extraction results into columns and rows with inferred types and the exportmenu ships them as csv, json or clipboard in masked form only; quickactions, shortcutkeys and the omniboxtask shorten the path to a run behind the same gates; the statusbadge, the done and attention notifications, the recenttray and the stetoasts keep the user informed without watching; the pickeroverlay, the targethalo, the guidedtips, the shotpanel, the compareviewer and the pagechips cover selection and evidence; and the siteprofiles, the darklight theme tokens, the locale bundles, the importexport payloads, the dropimport sessions, the featuretour stops and the a11ylabels round out the surface.
+ * The consent gates do not move: every quickaction rides the origin allowlist of the clicked tab, every omnibox goal routes through the proposal flow, every notification with page content needs its consent, every picker read stays inside the granted origin, no bundle ever ships a secretvault value or an unmasked log, and no interface element ever bypasses the human review.
+ */
+/** One datagrid column with its type inferred from the observed values: text, number, boolean, date or an all empty column. */
+export interface datagridcolumn {
+    field: string;
+    label: string;
+    type: "text" | "number" | "boolean" | "date" | "empty";
+    /** True when the type was inferred from the values rather than declared by the extraction. */
+    inferred: boolean;
+}
+/** One datagrid row: its original order as index, its field values and its selected mark of a partial export range. */
+export interface datagridrow {
+    index: number;
+    values: Record<string, string>;
+    /** True when the row sits inside the selected range of a partial export. */
+    selected?: boolean;
+}
+/** One datagrid view of an extraction result: the title, the origin, the run, the inferred columns, the rows and the build time. */
+export interface datagridview {
+    id: string;
+    title: string;
+    origin: string;
+    runid: string;
+    columns: datagridcolumn[];
+    rows: datagridrow[];
+    at: number;
+}
+/** One exportmenu descriptor: the csv, json or clipboard format, the selection, step or run scope and the download, clipboard or memory destination. */
+export interface exportmenudescriptor {
+    format: "csv" | "json" | "clipboard";
+    scope: "selection" | "step" | "run";
+    destination: "download" | "clipboard" | "memory";
+}
+/** One quickaction bound to a context menu entry: the command it routes, the surface it opens on, the optional permission it needs granted and whether it needs an active session. */
+export interface quickaction {
+    id: string;
+    label: string;
+    command: string;
+    surface: uisurface;
+    /** The optional capability the quickaction needs granted before it registers; an absent permission needs none. */
+    permission?: string;
+    /** True when the quickaction needs an active browser session before it registers. */
+    session?: boolean;
+}
+/** One shortcutkeys binding: the command it triggers, the key, the modifiers, the user editable mark and the surface it binds on; the palette command binds on every surface. */
+export interface shortcutbinding {
+    command: string;
+    key: string;
+    modifiers: string[];
+    editable: boolean;
+    surface: uisurface;
+}
+/** One omniboxtask submission parsed from the omnibox keyword: the natural language goal after the keyword, the active origin and the time. */
+export interface omniboxtasksubmission {
+    id: string;
+    text: string;
+    origin: string;
+    surface: "omnibox";
+    at: number;
+}
+/** One statusbadge state of the toolbar icon: idle, running, waiting or attention with the count of waiting gates that need a human. */
+export interface statusbadgestate {
+    state: "idle" | "running" | "waiting" | "attention";
+    waitingcount: number;
+    runid?: string;
+}
+/** One notification payload: the done or attention kind, the title, the body, the deep link, the optional step ref and whether the body carries page content that needs its consent. */
+export interface notificationpayload {
+    id: string;
+    kind: "done" | "attention";
+    title: string;
+    body: string;
+    deeplink: string;
+    runid?: string;
+    stepid?: string;
+    /** True when the notification body carries page content; the content consent gate must allow before it shows. */
+    content: boolean;
+    at: number;
+}
+/** One recenttray entry: the run id, the origin, the outcome, the title, the time and the resume and reopen offers. */
+export interface recenttrayentry {
+    runid: string;
+    origin: string;
+    outcome: "running" | "completed" | "halted" | "failed";
+    title: string;
+    at: number;
+    resumable: boolean;
+    reopenable: boolean;
+}
+/** One pickeroverlay candidate: the selector, the optional text and role anchors, the stability score and the plain language reason the score stands. */
+export interface pickercandidate {
+    selector: string;
+    text?: string;
+    role?: string;
+    stabilityscore: number;
+    reason: string;
+}
+/** One pickeroverlay session: the granted origin it reads, the ranked candidates, the locked step and selector and the start time. */
+export interface pickersession {
+    id: string;
+    origin: string;
+    candidates: pickercandidate[];
+    /** The step the locked candidate binds to; one session locks one candidate. */
+    lockedstepid?: string;
+    lockedselector?: string;
+    startedat: number;
+}
+/** One targethalo geometry descriptor: the step it outlines, the target selector, the pixel rect and the step state that colors the outline. */
+export interface targethalo {
+    stepid: string;
+    selector: string;
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    state: "pending" | "running" | "waiting" | "done" | "failed" | "halted";
+}
+/** One guidedtip: the surface it teaches, the title, the body and the picker step it binds to. */
+export interface guidedtip {
+    id: string;
+    surface: uisurface;
+    title: string;
+    body: string;
+    pickerstep?: string;
+}
+/** One shotpanel view: the step, the run, the capture id, the capture provenance, the origin, the redaction verdicts, the zoom and pan the user set and the build time. */
+export interface shotpanelview {
+    id: string;
+    stepid: string;
+    runid: string;
+    captureid: string;
+    provenance: "viewport" | "fullpage" | "element" | "region";
+    origin: string;
+    redactions: Array<{
+        region: string;
+        verdict: string;
+    }>;
+    zoom: number;
+    pan: {
+        x: number;
+        y: number;
+    };
+    at: number;
+}
+/** One compareviewer pair: the step it compares, the before capture, the after capture and the slider position of the overlay. */
+export interface compareviewerpair {
+    id: string;
+    stepid: string;
+    beforecaptureid: string;
+    aftercaptureid: string;
+    slidervalue: number;
+}
+/** One siteprofile: the per site interface preferences (the theme, the shortcutkeys and the default view) stored beside the originprofiles policy preferences of its origin. */
+export interface siteprofile {
+    origin: string;
+    theme?: "dark" | "light" | "system";
+    shortcuts?: shortcutbinding[];
+    defaultview?: string;
+    updatedat: number;
+}
+/** One darklight theme token set: the mode and the token values every surface, including the dashboardpage, reads; the source names whether the os preference, the user override or the siteprofile decided. */
+export interface darklighttokens {
+    mode: "dark" | "light";
+    tokens: Record<string, string>;
+    source?: "os" | "user" | "site";
+}
+/** One locale bundle: the language and its interface strings; english ships as the fallback base. */
+export interface localebundle {
+    language: string;
+    strings: Record<string, string>;
+}
+/** One importexport payload: the settings and data bundle of one profile with its originprofiles, siteprofiles, notes and preferences and the honest exclusion list; secretvault values and unmasked logs never enter any bundle under any flag. */
+export interface importexportpayload {
+    version: number;
+    kind: "settings" | "data";
+    profile: string;
+    exportedat: number;
+    contents: {
+        originprofiles: Array<Record<string, unknown>>;
+        siteprofiles: Array<Record<string, unknown>>;
+        notes: Array<Record<string, unknown>>;
+        preferences: Record<string, unknown>;
+        /** Present only when a bundle wrongly carries log entries; the validation refuses such bundles in full. */
+        unmaskedlogs?: Array<Record<string, unknown>>;
+    };
+    exclusions: string[];
+}
+/** One dropimport session: the dropped filename, the detected csv, json or workflow kind, the byte size, the accepted mark and the time. */
+export interface dropimportsession {
+    id: string;
+    filename: string;
+    kind: "csv" | "json" | "workflow";
+    bytes: number;
+    accepted: boolean;
+    at: number;
+}
+/** One featuretour stop: the surface it walks, the focus selector it highlights, the title, the body and the stop order. */
+export interface featuretourstop {
+    id: string;
+    surface: uisurface;
+    focus: string;
+    title: string;
+    body: string;
+    order: number;
+}
+/** One a11ylabel: the control it names, its role, its accessible name and its optional state and value for screen readers, resolved through the locale bundles so labels follow the language of the interface. */
+export interface a11ylabel {
+    control: string;
+    role: "button" | "textbox" | "tab" | "table" | "list" | "slider" | "switch" | "radiogroup" | "combobox" | "group" | "region" | "search" | "dialog";
+    name: string;
+    state?: string;
+    value?: string;
+}
+/** One pagechip confirmation: the gated step, the anchor selector, the origin, the approve or reject resolution, the resolved time and the build time. */
+export interface pagechipconfirmation {
+    id: string;
+    stepid: string;
+    selector: string;
+    origin: string;
+    resolution?: "approve" | "reject";
+    resolvedat?: number;
+    at: number;
+}
+/** One steteoast: the step completion confirmation with the step kind, its duration in milliseconds and the time. */
+export interface stetoast {
+    id: string;
+    stepid: string;
+    kind: string;
+    durationms: number;
+    at: number;
+}
 //# sourceMappingURL=types.d.ts.map