@wenathlan/extension 1.1.48 → 1.1.50

package/dist/sessions.d.ts

@@ -0,0 +1,79 @@
+import type { autointerval, restoreplan, searchfield, searchquery, sessionchange, sessiondiff, sessionfile, sessionfolder, sessionmatch, sessionrecord, sessiontab, snapshotscope, snapshotplan, stepoutcome, taskstate } from "./types.js";
+/** The session kinds of the 1.1.49 memory family: task state persistence, session capture, restore, naming, diffing, search, export and import. */
+export declare const sessionkinds: string[];
+/** The format version of exported session files; imports of unknown versions are refused. */
+export declare const sessionfileversion = 1;
+/** The reviewed snapshot section toggles: tabs, scroll positions, form state, local storage and cookies. */
+export declare const snapshotsections: snapshotscope[];
+/** The searchable fields of a session search: urls, titles, record names and captured text. */
+export declare const searchfields: searchfield[];
+/** Checksums the run id, step cursor and recorded outputs of a task state so corruption is detected before a resume. */
+export declare function taskstatechecksum(runid: string, stepcursor: number, outputs: stepoutcome[]): string;
+/** Builds one persisted task state checkpoint of a run with its checksum. */
+export declare function taskstateof(input: {
+    runid: string;
+    stepcursor: number;
+    outputs: stepoutcome[];
+    checkpointat: number;
+}): taskstate;
+/** True when a persisted task state carries the intact checksum of its own payload; a corrupted checkpoint never resumes. */
+export declare function taskstatevalid(state: taskstate | undefined): boolean;
+/** Normalizes one captured tab of a saved session: url, title, index, scroll position and form state. */
+export declare function sessiontabof(value: unknown): sessiontab | undefined;
+/** Normalizes one reviewed auto snapshot interval: a positive period, a positive maximum snapshot count and a zero or positive expiry window; every value stays a user choice with no code ceiling. */
+export declare function autointervalof(value: unknown): autointerval | undefined;
+/** Normalizes one reviewed snapshot plan: the scope, the section toggles of the reviewed grammar, the capture link flag and the optional auto interval. */
+export declare function snapshotplanof(value: unknown): snapshotplan | undefined;
+/** Normalizes one reviewed restore plan: the tab, form and capture policies of the reviewed grammar. */
+export declare function restoreplanof(value: unknown): restoreplan | undefined;
+/** Normalizes one reviewed session search query: the non-empty term list, the searched fields of the reviewed grammar and the optional time window. */
+export declare function searchqueryof(value: unknown): searchquery | undefined;
+/** Normalizes one session folder: the name, the optional parent folder and the tag list. */
+export declare function sessionfolderof(value: unknown): sessionfolder | undefined;
+/** Builds one saved session record with its default tag list and capture linkage. */
+export declare function newsessionrecord(input: {
+    id: string;
+    name: string;
+    createdat: number;
+    tabs: sessiontab[];
+    captures: string[];
+    storage: Array<{
+        origin: string;
+        keys: string[];
+        values: string[];
+    }>;
+    cookies: Array<{
+        origin: string;
+        names: string[];
+    }>;
+    auto?: boolean;
+    folder?: string;
+    tags?: string[];
+}): sessionrecord;
+/** Classifies the tab, url, form and storage changes between two saved sessions by matching tabs on their recorded index. */
+export declare function diffsessionrecords(left: sessionrecord, right: sessionrecord): sessionchange[];
+/** Builds one stored session diff result of two compared records. */
+export declare function newsessiondiff(input: {
+    id: string;
+    left: sessionrecord;
+    right: sessionrecord;
+    at: number;
+}): sessiondiff;
+/** Searches across saved sessions: matches urls, titles, record names and captured form text inside the reviewed time window and returns every match with its session id. */
+export declare function searchsessionrecords(query: searchquery, records: sessionrecord[]): sessionmatch[];
+/** Packs saved session records into one versioned session file with its record ids, byte size and checksum. */
+export declare function exportsessionfile(records: sessionrecord[], now: number): sessionfile;
+/** Validates one imported session file: the format version must match, every record must carry intact sections and the checksum must verify before any record review begins. */
+export declare function importsessionfile(value: unknown): sessionfile | undefined;
+/** Expires the heavy sections of saved sessions after the reviewed retention window while the record metadata survives; an absent window keeps every section and no code ceiling applies. */
+export declare function expiresessions(records: sessionrecord[], retention: number | undefined, now: number): sessionrecord[];
+/** Lists saved sessions filtered by name substring, folder and time window; the filter stays a user choice with no result cap. */
+export declare function filteredsessions(records: sessionrecord[], filter: {
+    name?: string;
+    folder?: string;
+    from?: number;
+    to?: number;
+}): sessionrecord[];
+/** Marks one persisted task state interrupted by a browser restart when the cursor never reached the end of the plan. */
+export declare function crashinterrupted(state: taskstate | undefined, plansteps: number, now: number): taskstate | undefined;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../sessions.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1,9 +1,9 @@
-export declare const protocolversion: "1.1.48";
+export declare const protocolversion: "1.1.50";
 /** 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";
+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";
 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";
+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";
 /** Observation mode classes: passive capture, watched lifetimes and diffing passes. */
 export type observationmode = "passive" | "watching" | "diffing";
 export interface toolstep {
@@ -112,12 +112,16 @@ export interface capabilityreport {
     netwatch?: string[];
     /** Network control kinds listed among the available capabilities: blocking, mocking, cookies, auth and uploads stay behind the block, cookie and proxy gates. */
     control?: string[];
+    /** Session memory kinds listed among the available capabilities: persistence, capture, restore, naming, diffing, search, export and import stay behind the session consent gates. */
+    sessions?: string[];
     /** Debugging kinds listed among the available capabilities: console, error and task watching stays read only behind the timeline gate and the per origin console consent. */
     debug?: string[];
     /** Profiling kinds listed among the available capabilities: flow, heap, cpu, shift, trace and source map instruments stay behind the profiling target gate and the per origin consents. */
     profile?: string[];
     /** Emulation kinds listed among the available capabilities: device, network, location, agent and permission layers plus blackbox trace shaping stay behind the emulation gate and the per origin location consent. */
     emulation?: string[];
+    /** Workflow kinds listed among the available capabilities: composition, templates, runs, dry runs, delays, element waits, expressions and variable extraction stay inside the plan review gates. */
+    workflow?: string[];
     reportedat: number;
 }
 /** Structured result of one executed step, kept with configurable retention. */
@@ -168,6 +172,10 @@ export interface runsettings {
     breakpointceiling?: number;
     /** Retention window for stored reverted emulation layer states; an absent window keeps every prior state while the layer history itself always survives. */
     emulationretention?: number;
+    /** Retention window for stored session record sections such as tab form state, local storage and cookies; an absent window keeps every section while the record metadata always survives and the value stays a user choice with no code ceiling. */
+    sessionretention?: number;
+    /** Retention window for stored workflow runlog entries; an absent window keeps every entry while the run summaries always survive for the audit trail. */
+    runlogretention?: number;
 }
 export interface proposalrequest {
     objective: string;
@@ -2234,4 +2242,290 @@ export interface presetlibrary {
     agents: agentpreset[];
     exportedat: number;
 }
+/** The persisted task state of one run: the run id, the step cursor of the last completed step, the recorded outputs and the last checkpoint time; the checksum detects corruption before a resume. */
+export interface taskstate {
+    runid: string;
+    stepcursor: number;
+    outputs: stepoutcome[];
+    checkpointat: number;
+    /** Checksum of the run id, step cursor and outputs so a corrupted checkpoint never resumes. */
+    checksum: string;
+    /** True once a service worker or browser restart interrupted the run before the cursor reached the end. */
+    interrupted?: boolean;
+    /** Time the interrupted run was detected, set by the crash detector after a browser restart. */
+    crashat?: number;
+}
+/** One session history event of the run: the event kind, the time, the tab id and the detail; every session event lands in the history with its timestamp. */
+export interface sessionevent {
+    id: string;
+    kind: "persist" | "capture" | "restore" | "name" | "diff" | "search" | "export" | "import" | "auto" | "crash" | "resume" | "restart";
+    at: number;
+    tabid?: number;
+    detail: string;
+}
+/** One captured tab of a saved session: the url, title, index, scroll position and the form state captured through the page seam. */
+export interface sessiontab {
+    url: string;
+    title: string;
+    index: number;
+    scrollx: number;
+    scrolly: number;
+    forms: Array<{
+        selector: string;
+        value: string;
+    }>;
+}
+/** One saved browsing session record: the id, the reviewed name, the created time, the captured tabs and the linked capture records. */
+export interface sessionrecord {
+    id: string;
+    name: string;
+    createdat: number;
+    tabs: sessiontab[];
+    /** Capture record ids of the run linked to this session. */
+    captures: string[];
+    /** Local storage keys captured per granted origin. */
+    storage: Array<{
+        origin: string;
+        keys: string[];
+        values: string[];
+    }>;
+    /** Cookie names captured per granted origin; values stay on the page seam. */
+    cookies: Array<{
+        origin: string;
+        names: string[];
+    }>;
+    /** Folder name the record was filed under by a namedsessions step. */
+    folder?: string;
+    /** Tag list of the reviewed filing. */
+    tags: string[];
+    /** True when an auto snapshot interval produced the record instead of a reviewed capture step. */
+    auto?: boolean;
+    /** True once the retention window expired the heavy tab, storage and cookie sections while the record metadata survives. */
+    sectionsexpired?: boolean;
+    /** True once the record was restored so the sessions view marks it with the restored badge. */
+    restoredat?: number;
+}
+/** The reviewed section toggles of a session snapshot: tabs, scroll positions, form state, local storage and cookies; every toggle stays a user choice. */
+export type snapshotscope = "tabs" | "scroll" | "forms" | "storage" | "cookies";
+/** The reviewed snapshot plan of a session capture: the scope, the section toggles, the capture link flag and the optional auto snapshot interval. */
+export interface snapshotplan {
+    scope: "tab" | "run" | "all";
+    sections: snapshotscope[];
+    captures: boolean;
+    auto?: autointerval;
+}
+/** The reviewed restore plan of a session restore: the tab, form and capture policies the reviewed restore follows. */
+export interface restoreplan {
+    tabpolicy: "reopen" | "skip";
+    formpolicy: "restore" | "skip";
+    capturepolicy: "link" | "skip";
+}
+/** The reviewed auto snapshot interval: the period, the maximum snapshot count and the expiry window; every value stays a user choice with no code ceiling. */
+export interface autointerval {
+    period: number;
+    maxsnapshots: number;
+    expiry: number;
+}
+/** One session folder of the library: the name, the optional parent folder and the tag list. */
+export interface sessionfolder {
+    name: string;
+    parent?: string;
+    tags: string[];
+}
+/** One classified change of a session diff: the change class and the tab, url, form or storage subject with its detail. */
+export interface sessionchange {
+    class: "added" | "removed" | "changed";
+    subject: "tab" | "url" | "form" | "storage";
+    detail: string;
+}
+/** One session diff result: the two compared record ids, the classified changes and the diff time; stored for later review. */
+export interface sessiondiff {
+    id: string;
+    leftid: string;
+    rightid: string;
+    changes: sessionchange[];
+    at: number;
+}
+/** The searchable fields of a session search: urls, titles, record names and captured text. */
+export type searchfield = "urls" | "titles" | "names" | "text";
+/** One reviewed session search query: the term list, the searched fields and the optional time window. */
+export interface searchquery {
+    terms: string[];
+    fields: searchfield[];
+    from?: number;
+    to?: number;
+}
+/** One session search match: the session id, the matched field, the matched term and the record time window. */
+export interface sessionmatch {
+    sessionid: string;
+    field: searchfield;
+    term: string;
+    at: number;
+    excerpt: string;
+}
+/** One exported session file: the format version, the packed records, the record ids, the byte size and the checksum verified at import; every record is reviewed before an import adds it. */
+export interface sessionfile {
+    formatversion: number;
+    records: sessionrecord[];
+    recordids: string[];
+    bytesize: number;
+    checksum: string;
+    exportedat: number;
+}
+/** One provenance entry of a workflow run: an expression result or a regex capture with its name, value and time, stored for inspection after the run. */
+export interface workflowprovenance {
+    runid: string;
+    kind: "expression" | "regex" | "binding";
+    name: string;
+    value: string | number | boolean | string[];
+    at: number;
+}
+/** The persisted auto snapshot state of a run: the reviewed interval, the last snapshot time and the snapshot count inside the reviewed maximum. */
+export interface autosnapshotstate {
+    interval: autointerval;
+    lastat: number;
+    count: number;
+}
+/** One composed workflow record: the id, the reviewed name, the version, the origin grants the workflow stays inside, the frozen expanded step list and the reusable block definitions. */
+export interface workflowrecord {
+    id: string;
+    name: string;
+    version: number;
+    /** Origin grants the workflow steps must stay inside; composition refuses ungranted origins. */
+    origins: string[];
+    /** The frozen expanded step list reviewed before any run; blocks never hide steps from review. */
+    steps: workflowstep[];
+    /** Reusable block definitions the expanded list was flattened from. */
+    blocks: workflowblock[];
+    /** Derived review grade: a workflow that writes, submits or navigates is sensitive for review. */
+    risk: actionrisk;
+    createdat: number;
+}
+/** One workflow step: the action kind, the optional target and value, the reviewed JSON options, the output bindings and the human readable label. */
+export interface workflowstep {
+    id: string;
+    kind: actionkind;
+    label: string;
+    target?: string;
+    value?: string;
+    options?: string;
+    /** Bindings that link the outcome of this step to named variables of the following steps. */
+    bindings?: variablebinding[];
+    /** Expression evaluated inline before this step runs; the result lands in the named result variable. */
+    expression?: expressiontype;
+    /** Regex rule applied to the step text before this step runs; the named captures land in scope variables. */
+    extract?: regexrule;
+    /** Innermost reusable block the step expanded from so runs highlight the active block during nested execution. */
+    block?: string;
+}
+/** One reusable workflow block that nests child steps and further block invocations under a reusable name. */
+export interface workflowblock {
+    name: string;
+    label: string;
+    /** Child steps and nested block invocations in execution order. */
+    steps: Array<workflowstep | blockinvocation>;
+}
+/** One block invocation inside a workflow step list or a nested block. */
+export interface blockinvocation {
+    block: string;
+    label: string;
+}
+/** One shareable step template: a named workflow step marked as shareable across workflows. */
+export interface steptemplate {
+    id: string;
+    name: string;
+    origin: string;
+    step: workflowstep;
+    sharedat: number;
+}
+/** The variable kinds a typed scope holds: strings, numbers, booleans, lists and element references. */
+export type variablekind = "string" | "number" | "boolean" | "list" | "element";
+/** One variable value of a typed scope with its name, kind, value and set time. */
+export interface variablevalue {
+    name: string;
+    kind: variablekind;
+    value: string | number | boolean | string[];
+    setat: number;
+}
+/** One typed variable scope: the scope name, its variables and the optional parent scope it chains to for resolution. */
+export interface variablescope {
+    name: string;
+    variables: variablevalue[];
+    parent?: string;
+}
+/** One variable binding that links a step output path to a named variable of a typed kind. */
+export interface variablebinding {
+    variable: string;
+    kind: variablekind;
+    stepid: string;
+    /** Dotted path into the step outcome details; an absent path binds the summary. */
+    path?: string;
+}
+/** One expression operand: a variable reference resolved from the nearest scope outward or a literal value. */
+export interface expressionoperand {
+    ref?: string;
+    literal?: string | number | boolean;
+}
+/** The reviewed expression operators between variables: arithmetic, comparison and logic. */
+export type expressionoperator = "add" | "subtract" | "multiply" | "divide" | "modulo" | "equal" | "notequal" | "less" | "greater" | "lessequal" | "greaterequal" | "and" | "or" | "not" | "concat" | "contains" | "length";
+/** One reviewed expression: the operands, the operator and the result variable with its result kind. */
+export interface expressiontype {
+    left: expressionoperand;
+    right?: expressionoperand;
+    operator: expressionoperator;
+    result: string;
+    resultkind: variablekind;
+}
+/** One reviewed regex rule: the pattern, the flags and the named capture groups stored as variables. */
+export interface regexrule {
+    pattern: string;
+    flags: string;
+    groups: string[];
+}
+/** One reviewed delay: the base milliseconds and the jitter window the sampled delay stays inside. */
+export interface delaystep {
+    base: number;
+    jitter: number;
+}
+/** One reviewed element wait: the selector, the timeout and the poll interval; every value stays a user choice with no code ceiling. */
+export interface waitstep {
+    selector: string;
+    timeout: number;
+    poll: number;
+}
+/** The states of a workflow run: pending, running, paused, done, failed and cancelled. */
+export type runstate = "pending" | "running" | "paused" | "done" | "failed" | "cancelled";
+/** One workflow run: the id, the workflow id, the state, the step cursor of the last checkpoint and the start and end times. */
+export interface workflowrun {
+    id: string;
+    workflowid: string;
+    state: runstate;
+    /** Index of the next step to execute; every completed step checkpoints the cursor. */
+    cursor: number;
+    startedat: number;
+    endedat?: number;
+    /** True when the run evaluates every step with no browser mutation. */
+    dryrun?: boolean;
+    pausedat?: number;
+    cancelreason?: string;
+    failreason?: string;
+}
+/** One runlog entry: the step id, its label, the state, the duration and the outcome details with the bindings produced and consumed. */
+export interface runlogentry {
+    stepid: string;
+    label: string;
+    state: "running" | "done" | "failed" | "refused";
+    startedat: number;
+    duration: number;
+    summary: string;
+    /** Block name the step executed inside so nested runs highlight the active block. */
+    block?: string;
+    /** Variable names this step consumed from the scopes. */
+    consumed?: string[];
+    /** Variable names this step produced into the scopes. */
+    produced?: string[];
+    /** True once a checkpoint landed after this step so the timeline shows the checkpoint markers. */
+    checkpoint?: boolean;
+    details?: Record<string, unknown>;
+}
 //# sourceMappingURL=types.d.ts.map