@wenathlan/extension 1.1.64 → 1.1.65

package/dist/types.d.ts

@@ -1,9 +1,9 @@
-export declare const protocolversion: "1.1.64";
+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" | "palette" | "surface" | "onboarding" | "logstream";
+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 {
@@ -254,6 +254,18 @@ export interface runsettings {
     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;
@@ -4805,8 +4817,8 @@ export interface tabsessionref {
  * 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 five interface surfaces of the 1.1.64 family: the popup command surface, the sidepanel workspace, the dashboardpage, the optionspage and the onboarding walkthrough. */
-export type uisurface = "popup" | "sidepanel" | "dashboardpage" | "optionspage" | "onboarding";
+/** 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;
@@ -4968,4 +4980,240 @@ export interface paletteuserecord {
     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