@wenathlan/extension 1.1.43 → 1.1.45

package/dist/runtimeline.d.ts

@@ -0,0 +1,122 @@
+import type { consolediff, consoleentry, errorrecord, exchangerecord, loglevel, loglevelset, longtaskentry, netfailureentry, rejectionrecord, rotationrule, spamrule, stackframe, timelineentry, timelinesource } from "./types.js";
+/**
+ * Run timeline logics for the 1.1.45 debugging family.
+ * Every correlated rule for console capture with reviewed depth bounds and secret redaction, stack frame parsing, error, rejection and resource failure capture, long task attribution windows, the timeline binding to one run and its step ids, spam collapse with reviewed thresholds, log rotation without entry loss, level and source filters, the blocking duration per step window and the console diff between two runs lives in this file.
+ * Console, error and task watching derives from page-injected listeners installed through the scripting api and the performance buffers, so no debugger permission exists anywhere in the manifest; redaction runs before any entry leaves the page bridge and captured text never carries reviewed secret patterns.
+ */
+/** The debugging kinds, listed among the available capabilities of every proposal request. */
+export declare const timelinekinds: string[];
+/** The reviewed level set, ordered from the most severe to the most verbose level. */
+export declare const loglevels: loglevel[];
+/** The reviewed timeline source grammar: page console output, script errors, promise rejections, resource failures, long tasks and failed network requests. */
+export declare const timelinesources: timelinesource[];
+/** Ranks one level inside the reviewed level set; lower ranks are more severe. */
+export declare function levelrank(level: loglevel): number;
+/** Redacts reviewed secret patterns from console text before any entry leaves the page bridge; matched patterns never survive into a stored entry. */
+export declare function redactconsoletext(text: string, patterns: string[]): string;
+/** Classifies the kind tag of one console argument for the consoleentry argument kinds. */
+export declare function argkind(value: unknown): string;
+/** Serializes one console argument through the reviewed depth bound; deeper objects collapse to their constructor tag so the bound stays a user choice with no code ceiling. */
+export declare function serializearg(value: unknown, depth: number): string;
+/** Builds one captured console entry from a forwarded console call: the level, the redacted text of every serialized argument and the argument kinds, with redaction applied before the entry exists. */
+export declare function consolecapture(input: {
+    level: loglevel;
+    args: unknown[];
+    depth: number;
+    redact: string[];
+}): consoleentry;
+/** Parses one stack trace text into stack frames with function names, urls, lines and columns; unparseable lines are skipped instead of crashing capture. */
+export declare function stackframes(stacktext: string): stackframe[];
+/** Builds one captured javascript error record body from an error event: the redacted message, the parsed stack frames, the source url and the line. */
+export declare function errorcapture(input: {
+    message: string;
+    sourceurl: string;
+    line: number;
+    stacktext?: string;
+    redact: string[];
+}): Pick<errorrecord, "message" | "frames" | "sourceurl" | "line">;
+/** Builds one captured unhandled rejection record body from the rejection reason text and its stack frames, with the reason redacted before capture. */
+export declare function rejectioncapture(input: {
+    reason: string;
+    stacktext?: string;
+    redact: string[];
+}): Pick<rejectionrecord, "reason" | "frames">;
+/** Builds the long task entry bodies of one watch window from performance longtask entries with their attribution names; the reviewed threshold filters entries below the user configured duration. */
+export declare function longtaskcapture(input: {
+    entries: Array<{
+        starttime: number;
+        duration: number;
+        attributions: string[];
+    }>;
+    threshold: number;
+}): Array<Pick<longtaskentry, "duration" | "starttime" | "attributions">>;
+/** One run timeline bound to its run and step ids. */
+export interface timeline {
+    runid: string;
+    origin: string;
+    stepids: string[];
+    attachedat: number;
+    entries: timelineentry[];
+}
+/** Binds one timeline to the run and its step ids; capture stays scoped to that run and every entry carries the run correlation id of its step. */
+export declare function attachtimeline(input: {
+    runid: string;
+    origin: string;
+    stepids: string[];
+    now: number;
+}): timeline;
+/** Applies the reviewed level set to timeline entries: per step level floors drop entries more verbose than the floor and source filters drop entries from unreviewed sources. */
+export declare function filterentries(entries: timelineentry[], levelset: loglevelset): timelineentry[];
+/** Collapses repeated identical messages inside the reviewed spam window into counts and flags the patterns that exceed the reviewed collapse threshold. */
+export declare function spamdetect(entries: timelineentry[], rule: spamrule): {
+    entries: Array<timelineentry & {
+        repeat: number;
+    }>;
+    flagged: Array<{
+        message: string;
+        count: number;
+    }>;
+};
+/** Rotates the timeline of one run: the newest entries stay inside the reviewed max entries window while every overflow entry moves to the rotation target store without data loss. */
+export declare function rotatelogs(entries: timelineentry[], rule: rotationrule): {
+    kept: timelineentry[];
+    overflow: timelineentry[];
+};
+/** Counts the timeline entries per level for the response envelope timeline block. */
+export declare function timelinecounts(entries: timelineentry[]): Record<string, number>;
+/** Sums the blocking duration of long task entries inside one step window; the window stays a reviewed value with no code ceiling. */
+export declare function blockingduration(tasks: Array<{
+    starttime: number;
+    duration: number;
+}>, stepid: string, window: {
+    startedat: number;
+    endedat: number;
+}): {
+    stepid: string;
+    blocking: number;
+    tasks: number;
+};
+/** Marks one failed request of the run in the timeline from its observed exchange: the url, status, error class and correlation id. */
+export declare function netfailureentryof(input: {
+    id: string;
+    exchange: exchangerecord;
+    at: number;
+}): netfailureentry | null;
+/** Decides whether a watcher detached early because the run tab navigated inside its watch window: navigation timestamps inside the window detach the watcher at the navigation time. */
+export declare function watcherdetached(input: {
+    startedat: number;
+    lifetime: number;
+    navigations: number[];
+}): {
+    detached: boolean;
+    at?: number;
+};
+/** Compares the console output of two runs and classifies every line as added, removed or repeated; repeated lines carry their repeat counts. */
+export declare function consolediff(input: {
+    baseid: string;
+    targetid: string;
+    baselines: string[];
+    targetlines: string[];
+    now: number;
+}): consolediff;
+//# sourceMappingURL=runtimeline.d.ts.map

package/dist/runtimeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeline.d.ts","sourceRoot":"","sources":["../runtimeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpO;;;;GAIG;AAEH,8FAA8F;AAC9F,eAAO,MAAM,aAAa,EAAE,MAAM,EAAkD,CAAC;AAErF,sFAAsF;AACtF,eAAO,MAAM,SAAS,EAAE,QAAQ,EAAuD,CAAC;AAExF,+JAA+J;AAC/J,eAAO,MAAM,eAAe,EAAE,cAAc,EAAyE,CAAC;AAEtH,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAEjD;AAED,sJAAsJ;AACtJ,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAO1E;AAED,2FAA2F;AAC3F,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAc9C;AAED,gLAAgL;AAChL,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAiBlE;AAED,yMAAyM;AACzM,wBAAgB,cAAc,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,YAAY,CAGzH;AAED,6JAA6J;AAC7J,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,CAkB3D;AAED,wJAAwJ;AACxJ,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC,CAE9L;AAED,wJAAwJ;AACxJ,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAE5I;AAED,uMAAuM;AACvM,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,WAAW,GAAG,cAAc,CAAC,CAAC,CAEpN;AAED,sDAAsD;AACtD,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,mJAAmJ;AACnJ,wBAAgB,cAAc,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAEjH;AAED,kLAAkL;AAClL,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,WAAW,GAAG,aAAa,EAAE,CAO9F;AAED,4JAA4J;AAC5J,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC,aAAa,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAkB/K;AAED,uLAAuL;AACvL,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,YAAY,GAAG;IAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,CAK7H;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAK/E;AAED,sIAAsI;AACtI,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAG3M;AAED,uIAAuI;AACvI,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,GAAG,IAAI,CAIrH;AAED,yLAAyL;AACzL,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAKzI;AAED,iJAAiJ;AACjJ,wBAAgB,WAAW,CAAC,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CA2B7I"}

package/dist/types.d.ts

@@ -1,9 +1,9 @@
-export declare const protocolversion: "1.1.43";
+export declare const protocolversion: "1.1.45";
 /** 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";
+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";
 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";
+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";
 /** Observation mode classes: passive capture, watched lifetimes and diffing passes. */
 export type observationmode = "passive" | "watching" | "diffing";
 export interface toolstep {
@@ -110,6 +110,10 @@ export interface capabilityreport {
     http?: string[];
     /** Network observation part two kinds listed among the available capabilities: sockets, streams and page api observation stay behind the socket, watch and origin gates. */
     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[];
+    /** 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[];
     reportedat: number;
 }
 /** Structured result of one executed step, kept with configurable retention. */
@@ -148,6 +152,8 @@ export interface runsettings {
     capturepolicy?: capturepolicy;
     /** True when the pinned control tab with the live task feed stays open. */
     controltab?: boolean;
+    /** Retention window for stored run timeline entries; an absent window keeps every entry while the level count summaries always survive. */
+    timelineretention?: number;
 }
 export interface proposalrequest {
     objective: string;
@@ -1576,4 +1582,284 @@ export interface bodyrecord {
     /** True once the retention window expired the body; the metadata stays for the audit trail. */
     bodyexpired?: boolean;
 }
+/** One reviewed request block rule of a run: a url pattern with its origin, an optional resource type list and the run only scope; every rule reverts the moment the run ends, fails or is cancelled. */
+export interface blockrule {
+    id: string;
+    runid: string;
+    stepid: string;
+    /** Url pattern of the rule: an origin prefix with an optional path pattern. */
+    urlpattern: string;
+    /** Resource types the rule matches; an absent list matches every resource type. */
+    resourcetypes?: string[];
+    /** Hit counter of the rule while it stays active; extension initiated requests that matched were refused. */
+    hits: number;
+    registeredat: number;
+    revertedat?: number;
+}
+/** One reviewed response mock fixture of a run: the served status, headers and body for matched urls, reviewed with its full body before it serves. */
+export interface mockspec {
+    id: string;
+    runid: string;
+    stepid: string;
+    /** Url pattern the fixture matches. */
+    urlpattern: string;
+    status: number;
+    headers?: Record<string, string>;
+    /** Reviewed body of the fixture, served verbatim for matched requests. */
+    body?: string;
+    /** Reference of a captured body of the 1.1.43 body store the fixture replays; the body resolves from the store and stays out of reports. */
+    bodyref?: string;
+    /** True once the user reviewed the fixture with its full body. */
+    reviewed: boolean;
+    /** Hit counter of the fixture while it stays active. */
+    hits: number;
+    registeredat: number;
+    revertedat?: number;
+}
+/** One reviewed header rewrite rule of a run: the url pattern, header name, operation and value with the provenance of every applied rule kept in the audit trail. */
+export interface headerule {
+    id: string;
+    runid: string;
+    stepid: string;
+    /** Url pattern the rule matches; the pattern must name its origin explicitly. */
+    urlpattern: string;
+    name: string;
+    operation: "set" | "append" | "remove";
+    value?: string;
+    /** Hit counter of the rule while it stays active. */
+    hits: number;
+    registeredat: number;
+    revertedat?: number;
+}
+/** One reviewed cookie of a granted domain: name, domain, path, value and expiry, written through the page bridge of the granted origin and mirrored in storage with timestamps. */
+export interface cookierecord {
+    name: string;
+    domain: string;
+    path: string;
+    value: string;
+    /** Expiry timestamp of the cookie; an absent expiry keeps a session cookie. */
+    expiresat?: number;
+}
+/** One stored cookie operation of a run: the write, read or clear of one cookie of a granted domain with its timestamp; values never enter the audit trail. */
+export interface cookieoperation {
+    id: string;
+    runid: string;
+    stepid: string;
+    kind: "write" | "read" | "clear";
+    domain: string;
+    names: string[];
+    at: number;
+}
+/** One reviewed external oauth flow: provider, authorize url, token url, scopes and the redirect origin the code capture watches. */
+export interface oauthflow {
+    provider: string;
+    authorizeurl: string;
+    tokenurl: string;
+    scopes: string[];
+    redirectorigin: string;
+}
+/** One stored token record of a provider: scopes, origin scope and expiry with the token ids behind storage ids; token values never persist in the record or the audit trail. */
+export interface tokenrecord {
+    id: string;
+    provider: string;
+    origin: string;
+    scopes: string[];
+    /** Storage id of the access token secret; the value stays behind the storage id. */
+    accessstorageid: string;
+    /** Storage id of the refresh token secret when the flow returned one. */
+    refreshstorageid?: string;
+    expiresat: number;
+    refreshedat?: number;
+    revokedat?: number;
+    at: number;
+}
+/** One stored api key entry: name, origin scope, header name and created time with the last use timestamp; the key material stays behind its storage id. */
+export interface apikeyentry {
+    name: string;
+    origins: string[];
+    header: string;
+    storageid: string;
+    createdat: number;
+    lastuse?: number;
+}
+/** One reviewed proxy route of a run: scheme, host, port and the bypass list of origins that stay direct; the route applies for the run only and restores the previous state at run end. */
+export interface proxyroute {
+    id: string;
+    runid: string;
+    stepid: string;
+    scheme: "http" | "https" | "socks4" | "socks5";
+    host: string;
+    port: number;
+    /** Origins that bypass the route and send direct; a non-empty list is required before the route applies. */
+    bypass: string[];
+    appliedat: number;
+    revertedat?: number;
+}
+/** One parsed rate limit read of a response: remaining, limit, reset time and origin; the state expires at its reset window. */
+export interface ratelimitread {
+    origin: string;
+    remaining?: number;
+    limit?: number;
+    /** Reset timestamp of the window in epoch milliseconds. */
+    resetat: number;
+    at: number;
+}
+/** One reviewed urlencoded form payload of a postform step: the field list and its urlencoded encoding. */
+export interface formpayload {
+    url: string;
+    fields: Array<{
+        name: string;
+        value: string;
+    }>;
+}
+/** One reviewed multipart upload payload of a postfiles step: the field list, the reviewed files and the boundary that streams the parts without buffering the whole payload. */
+export interface multipartpayload {
+    url: string;
+    fields: Array<{
+        name: string;
+        value: string;
+    }>;
+    /** Reviewed files of the upload; every file carries the explicit reviewed flag. */
+    files: Array<{
+        name: string;
+        filename: string;
+        mime: string;
+        content: string;
+        reviewed: boolean;
+    }>;
+    boundary?: string;
+}
+/** One reviewed token revocation rule: the token ids, the reason and the revoke time. */
+export interface revocationrule {
+    tokenids: string[];
+    reason: string;
+    revokedat: number;
+}
+/** Console and timeline levels of the reviewed level set, ordered from the most severe to the most verbose. */
+export type loglevel = "error" | "warn" | "info" | "log" | "debug" | "trace";
+/** One timeline source of the reviewed source grammar: page console output, script errors, promise rejections, resource failures, long tasks and failed network requests. */
+export type timelinesource = "console" | "error" | "rejection" | "resource" | "longtask" | "network";
+/** One run timeline entry: the time, level, source, step id, message and the run correlation id of its step. */
+export interface timelineentry {
+    id: string;
+    runid: string;
+    stepid: string;
+    time: number;
+    level: loglevel;
+    source: timelinesource;
+    message: string;
+    /** Repeat count after spam collapse collapsed identical messages into one entry. */
+    repeat?: number;
+}
+/** One captured console call: the level, the redacted text, the argument kinds and the repeat count. */
+export interface consoleentry {
+    level: loglevel;
+    text: string;
+    /** Kind tags of the serialized arguments, for example string, number, boolean, object or array. */
+    argkinds: string[];
+    repeat: number;
+}
+/** One stack frame of a captured error or rejection: the function name, the source url, the line and the column. */
+export interface stackframe {
+    functionname?: string;
+    url: string;
+    line: number;
+    column?: number;
+}
+/** One captured javascript error: the message, the stack frames, the source url and the line. */
+export interface errorrecord {
+    id: string;
+    runid: string;
+    stepid: string;
+    message: string;
+    frames: stackframe[];
+    sourceurl: string;
+    line: number;
+    at: number;
+}
+/** One captured unhandled promise rejection: the reason text and the stack frames. */
+export interface rejectionrecord {
+    id: string;
+    runid: string;
+    stepid: string;
+    reason: string;
+    frames: stackframe[];
+    at: number;
+}
+/** One failed request of the run marked in the timeline: the url, status, error class and the correlation id. */
+export interface netfailureentry {
+    id: string;
+    runid: string;
+    stepid: string;
+    url: string;
+    status: number;
+    errorclass: string;
+    correlationid: string;
+    at: number;
+}
+/** One captured long task timing: the duration, the start time and the attribution names. */
+export interface longtaskentry {
+    id: string;
+    runid: string;
+    stepid: string;
+    duration: number;
+    starttime: number;
+    attributions: string[];
+    at: number;
+}
+/** One reviewed spam rule: the pattern, the window size and the collapse threshold; every bound stays a user configured value with no code ceiling. */
+export interface spamrule {
+    pattern: string;
+    windowsize: number;
+    collapse: number;
+}
+/** One reviewed level set: per step level floors and source filters over the reviewed source grammar. */
+export interface loglevelset {
+    floors?: Record<string, loglevel>;
+    sources?: timelinesource[];
+}
+/** One reviewed log rotation rule: the max entries kept per run and the overflow target store; the entry count stays a user configured value with no code ceiling. */
+export interface rotationrule {
+    maxentries: number;
+    overflowtarget: string;
+}
+/** One classified console line of a consolediff: added, removed or repeated, with the repeat count of repeated lines. */
+export interface consoleline {
+    kind: "added" | "removed" | "repeated";
+    text: string;
+    count?: number;
+}
+/** One console diff result between two runs: the added, removed and repeated line classes with their counts. */
+export interface consolediff {
+    base: string;
+    target: string;
+    lines: consoleline[];
+    added: number;
+    removed: number;
+    repeated: number;
+    at: number;
+}
+/** One console capture consent decision persisted per origin; console watching on a new origin prompts once and the approved decision persists. */
+export interface consoleconsentrecord {
+    id: string;
+    prompt: string;
+    origin: string;
+    stepid: string;
+    approved?: boolean;
+    usedat?: number;
+    at: number;
+}
+/** One log rotation target record with the overflow entry counts moved out of the rolling window. */
+export interface rotationtargetrecord {
+    target: string;
+    runid: string;
+    entries: number;
+    at: number;
+}
+/** One run timeline level count summary that survives the entry retention window. */
+export interface levelsummary {
+    runid: string;
+    counts: Record<string, number>;
+    at: number;
+}
 //# sourceMappingURL=types.d.ts.map