@wenathlan/extension 1.1.51 → 1.1.53

package/dist/trigger.d.ts

@@ -0,0 +1,151 @@
+import type { manualrun, rulestats, triggerfamily, triggerfire, triggerstate, triggerule, workflowrecord } from "./types.js";
+/**
+ * Trigger and scheduling engine for the 1.1.52 family.
+ * Every correlated rule of the trigger phase lives in this file: the trigger family and kind lists, the family payload normalizers, the five field cron parser with named weekdays and months and its timezone aware next fire computation, the interval scheduler that spreads repeated fires with the configured seeded jitter, the glob url matcher with ports, the visit origin matcher, the cooldown suppressor, the dedupe and queue discipline that keeps one pending fire per rule while a run is active, the url list planner that starts one run per url, the webhook verifier of the shared secret and payload schema, the observed event catalog matcher, the pause and resume suspension with the resume drain, the trigger evaluation that skips disabled, paused, unreviewed or cooled down rules, the manual run step preview with its confirmation outcome and the rule summaries the review panel renders.
+ * The engine stays pure: the launch of a run flows through the injected launch seam so tests run on plain fixtures, and no trigger fires outside the consent gates — every rule is reviewed before it arms and every launch re-passes the session, plan and origin gates.
+ */
+/** The trigger kinds of the 1.1.52 family: one kind per trigger rule family, each arming its rule behind the explicit arm review. */
+export declare const triggerkinds: string[];
+/** The trigger rule families the engine matches, schedules and observes. */
+export declare const triggerfamilies: triggerfamily[];
+/** The observed page event catalog event rules subscribe to: the mutation, focus, banner, console, error and navigation observations the extension already watches. */
+export declare const triggereventcatalog: string[];
+/** The documented default cooldown window of the webhook and event families when the review configures none; it is a documented default, never a cap, and any user configured window wins. */
+export declare const defaulttriggercooldown = 10000;
+/** True when the kind belongs to the trigger family of the 1.1.52 release. */
+export declare function istriggerkind(kind: string): boolean;
+/** Maps one trigger action kind to its rule family. */
+export declare function triggerfamilyof(kind: string): triggerfamily | undefined;
+/** Normalizes one family payload of a trigger rule and returns the family specific fields; the shared workflowid, cooldown and review flag stay with the caller. */
+export declare function triggerpayloadof(family: triggerfamily, value: unknown): Partial<triggerule> | undefined;
+/** True when a webhook shared secret clears the documented entropy floor: at least twenty four characters mixing letters and digits; the floor is a floor, not a cap, and any longer secret wins. */
+export declare function webhooksecretok(secret: string): boolean;
+/** True when the timezone name resolves through the runtime timezone database. */
+export declare function timezonevalid(timezone: string): boolean;
+/** Builds one armed trigger rule from the reviewed arm payload: the family normalizer validates the match fields, the effective cooldown applies the documented default of the webhook and event families and the rule starts enabled with zeroed counters. */
+export declare function armrule(input: {
+    id?: string;
+    family: triggerfamily;
+    workflowid: string;
+    label?: string;
+    payload: unknown;
+    cooldown?: number;
+    now: number;
+}): triggerule | undefined;
+/** The shared state of one rule update so enable, disable, pause, resume and fire bookkeeping stay immutable. */
+export declare function updaterule(rule: triggerule, patch: {
+    state?: Partial<triggerstate>;
+    stats?: Partial<rulestats>;
+}): triggerule;
+/** Matches one glob url pattern against one navigation url: the schemes and hostnames must agree, an explicit pattern port must match while an absent port matches any port, and the path plus query glob accepts `*` inside one segment and `**` across segments. */
+export declare function matchurl(pattern: string, url: string): boolean;
+/** True when a navigation url lands on one of the reviewed origins of a visit rule. */
+export declare function visitmatch(origins: string[], url: string): boolean;
+/** The five field cron parser: minute, hour, day of month, month and day of week accept `*`, lists, ranges and steps, and named weekdays (sun to sat) and months (jan to dec); day of week accepts zero and seven as sunday. */
+export declare function cronparse(expression: string): {
+    minutes: number[];
+    hours: number[];
+    daysofmonth: number[];
+    months: number[];
+    daysofweek: number[];
+} | undefined;
+/** Computes the next fire time of a five field cron expression strictly after the given time: minute boundaries in UTC or the reviewed timezone; a schedule that never fires inside the four year horizon returns undefined so the honest no fire outcome travels on. */
+export declare function cronnext(expression: string, from: number, timezone?: string): number | undefined;
+/** Computes the next fire time of a cron rule strictly after the given time. */
+export declare function schedulecron(rule: {
+    cron: string;
+    timezone?: string;
+}, from: number): number | undefined;
+/** Computes the next fire time of an interval rule: the reviewed period after the last fire (or the arm time of the first pass) spread with the seeded jitter window so repeated fires never bunch at the minimum. */
+export declare function scheduleinterval(rule: {
+    period: number;
+    jitter?: number;
+}, lastfire: number | undefined, armedat: number, seed: number): number;
+/** Returns every scheduled rule whose next fire time has passed; the alarm wake and the opportunistic service worker wakes drain this list. */
+export declare function listdue(rules: triggerule[], now: number): Array<{
+    rule: triggerule;
+    overdueby: number;
+}>;
+/** Applies the cooldown window of one rule: a fire inside the window after the last fire is suppressed with the remaining window, a fire at or after it passes. */
+export declare function applycooldown(rule: triggerule, now: number): {
+    suppressed: boolean;
+    remaining: number;
+};
+/** The outcome of one trigger evaluation: the launch plan when the rule fires or the honest suppression reason. */
+export interface triggerdecision {
+    fired: boolean;
+    suppressed?: string;
+    remaining?: number;
+    fire?: triggerfire;
+}
+/** Evaluates one armed rule against one observation: disabled, paused and rules whose workflow lost its approved review never fire, a run of the same workflow already active dedupes, the cooldown window suppresses and every passing fire carries the triggering url, title and payload into the run context. */
+export declare function evaluatetrigger(input: {
+    rule: triggerule;
+    now: number;
+    cause: string;
+    url?: string;
+    title?: string;
+    payload?: Record<string, unknown>;
+    runactive: boolean;
+    workflowreviewed: boolean;
+}): triggerdecision;
+/** Queues one fire that arrived while the target run or tab was busy; the queue keeps one pending fire per rule so repeated observations dedupe instead of piling up. */
+export declare function queuefire(queue: triggerfire[], fire: triggerfire): {
+    queue: triggerfire[];
+    queued: boolean;
+    deduped: boolean;
+};
+/** Drains the queued fires in arrival order through the injected launch seam; a launch that throws leaves the failed fire and the remaining queue intact so the next wake retries it. */
+export declare function drainqueue(queue: triggerfire[], launch: (fire: triggerfire) => Promise<void>): Promise<{
+    launched: number;
+    remaining: triggerfire[];
+}>;
+/** Plans one run per url of a url list rule: every url becomes its own trigger fire carrying the url into the run context; nothing is capped in code. */
+export declare function runurllist(rule: triggerule, now: number): triggerfire[];
+/** Verifies one webhook delivery: the shared secret must equal the reviewed secret compared character by character without early exit and the payload must satisfy every required schema field of its reviewed kind; only verified payloads persist. */
+export declare function verifywebhook(input: {
+    rule: triggerule;
+    secret: string;
+    payload: unknown;
+}): {
+    verified: boolean;
+    reason?: string;
+};
+/** True when one observed page event name matches an event rule subscription of the observed event catalog. */
+export declare function eventrulematches(rule: triggerule, event: string): boolean;
+/** Subscribes the armed event rules to one observed page event: returns every enabled, unpaused event rule whose subscription list names the event of the observed catalog, so the page observation seam (watched mutations, focus shifts, banners, console output, captured errors and navigations) can fire exactly those rules. */
+export declare function observeevents(rules: triggerule[], event: string): triggerule[];
+/** Suspends every enabled rule by setting its pause marker so session pauses hold fires instead of losing them. */
+export declare function pauseall(rules: triggerule[], now: number): triggerule[];
+/** Clears the pause marker of every rule so the resume drains the queued fires through the same gates. */
+export declare function resumeall(rules: triggerule[]): triggerule[];
+/** Builds the manual run step preview of one composed workflow: every expanded step with its kind, label, block and control summary so a human always sees what a run will do before confirming it. */
+export declare function manualpreview(record: workflowrecord, now: number): manualrun;
+/** Records the confirmation outcome of one manual run preview; an undecided preview keeps its confirmation open. */
+export declare function confirmmanualrun(preview: manualrun, confirmed: boolean, now: number): manualrun;
+/** Builds the review summary of one armed rule for the trigger list: the family, the match fields, the workflow reference, the effective cooldown and the schedule. */
+export declare function triggersummary(rule: triggerule): {
+    kind: triggerfamily;
+    workflowid: string;
+    label: string;
+    origins?: string[];
+    pattern?: string;
+    title?: string;
+    command?: string;
+    key?: string;
+    cron?: string;
+    timezone?: string;
+    period?: number;
+    jitter?: number;
+    urls?: string[];
+    events?: string[];
+    fields?: number;
+    cooldown: number;
+    enabled: boolean;
+    nextfireat?: number;
+};
+/** Returns every origin a rule touches so the arm review and the fire gates can check them against the workflow grants: visit origins, the url pattern origin, the url list origins and the webhook delivery origin stay inside the workflow grant list. */
+export declare function ruleorigins(rule: triggerule): string[];
+/** True when every origin a rule touches stays inside the granted origin list of its workflow. */
+export declare function ruleoriginsgranted(rule: triggerule, workfloworigins: string[]): boolean;
+//# sourceMappingURL=trigger.d.ts.map

package/dist/trigger.d.ts.map

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

package/dist/types.d.ts

@@ -1,9 +1,9 @@
-export declare const protocolversion: "1.1.51";
+export declare const protocolversion: "1.1.53";
 /** 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" | "condition" | "branch" | "loop" | "repeatuntil" | "whileloop" | "foreach" | "parallel" | "trycatch";
+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" | "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";
+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";
 /** Observation mode classes: passive capture, watched lifetimes and diffing passes. */
 export type observationmode = "passive" | "watching" | "diffing";
 export interface toolstep {
@@ -174,8 +174,14 @@ export interface runsettings {
     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 trigger fire records; an absent window keeps every fire record and the rule counters always survive. */
+    triggerretention?: 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;
+    /** Retention window for stored run history entries; an absent window keeps every entry of every execution. */
+    runhistoryretention?: number;
+    /** Watchdog configuration of the workflow editor: the stall threshold and the recovery action stay user configured values with no code ceiling. */
+    watchdog?: watchdogconfig;
 }
 export interface proposalrequest {
     objective: string;
@@ -2399,6 +2405,8 @@ export interface workflowrecord {
     blocks: workflowblock[];
     /** Derived review grade: a workflow that writes, submits or navigates is sensitive for review. */
     risk: actionrisk;
+    /** Review state of an imported workflow or a version rollback: pending stays unrunnable until the user approves the reviewed step list. */
+    reviewstate?: "pending" | "approved";
     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. */
@@ -2417,6 +2425,10 @@ export interface workflowstep {
     extract?: regexrule;
     /** Innermost reusable block the step expanded from so runs highlight the active block during nested execution. */
     block?: string;
+    /** Breakpoint marker of editor debugging: a debug run pauses before this step. */
+    breakpoint?: boolean;
+    /** Nested parameters the enclosing block invocation binds into the block scope; expansion stamps them on the first step of the invocation region. */
+    params?: nestedparam[];
 }
 /** One reusable workflow block that nests child steps and further block invocations under a reusable name. */
 export interface workflowblock {
@@ -2429,6 +2441,8 @@ export interface workflowblock {
 export interface blockinvocation {
     block: string;
     label: string;
+    /** Nested parameters the invocation binds into the block scope before its first step runs. */
+    params?: nestedparam[];
 }
 /** One shareable step template: a named workflow step marked as shareable across workflows. */
 export interface steptemplate {
@@ -2509,6 +2523,10 @@ export interface workflowrun {
     pausedat?: number;
     cancelreason?: string;
     failreason?: string;
+    /** True when the run keeps executing in the service worker with no panel open; checkpoints restore it on every worker wake. */
+    background?: boolean;
+    /** Why the run paused: a user pause, a watchdog recovery or a browser interruption the startup hook marked. */
+    pausekind?: "user" | "watchdog" | "interrupt";
 }
 /** 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 {
@@ -2680,4 +2698,272 @@ export interface controlflowdecision {
         rerun: boolean;
     };
 }
+/** The trigger rule families of the 1.1.52 release: page visits, url patterns, context menu entries, keyboard shortcuts, the toolbar button, cron schedules, intervals, url lists, webhooks and page events. */
+export type triggerfamily = "visit" | "url" | "menu" | "key" | "button" | "cron" | "interval" | "urllist" | "webhook" | "event";
+/** One armed trigger rule: the family, the reviewed match payload, the workflow reference, the runtime state with its cooldown and the per rule counters; every rule passes the arm review before it can fire. */
+export interface triggerule {
+    id: string;
+    kind: triggerfamily;
+    /** The composed workflow this rule launches; evaluation skips the rule when the workflow is no longer composed. */
+    workflowid: string;
+    /** Human readable label of the rule shown in the trigger list. */
+    label: string;
+    /** Visited HTTPS origins a visit rule fires on. */
+    origins?: string[];
+    /** Glob url pattern a url rule matches against navigations. */
+    pattern?: string;
+    /** Context menu entry title of a menu rule. */
+    title?: string;
+    /** Command name of a keyboard shortcut rule plus the suggested key binding. */
+    command?: string;
+    key?: string;
+    /** Five field cron expression of a cron rule with its optional timezone name. */
+    cron?: string;
+    timezone?: string;
+    /** Interval period in milliseconds with the optional jitter window of an interval rule. */
+    period?: number;
+    jitter?: number;
+    /** Url list a urllist rule runs its workflow across. */
+    urls?: string[];
+    /** Shared secret of a webhook rule; it never leaves the store and only its verified payloads persist. */
+    secret?: string;
+    /** Payload schema of a webhook rule: named fields of reviewed primitive kinds, required ones enforced at verification. */
+    schema?: webhookfield[];
+    /** Observed page event names an event rule subscribes to, drawn from the observed event catalog. */
+    events?: string[];
+    /** User configured cooldown window in milliseconds; an absent value keeps the documented family default. */
+    cooldown?: number;
+    state: triggerstate;
+    stats: rulestats;
+    createdat: number;
+}
+/** One webhook payload schema field of a webhook rule: the field name, its primitive kind and whether verification requires it. */
+export interface webhookfield {
+    name: string;
+    kind: "string" | "number" | "boolean";
+    required?: boolean;
+}
+/** The runtime state of one armed trigger rule: the enabled flag, the effective cooldown window, the pause marker, the last and next fire times. */
+export interface triggerstate {
+    enabled: boolean;
+    /** Effective cooldown window in milliseconds between two fires of the rule. */
+    cooldown: number;
+    /** Time of the last fire; fires inside the cooldown window after it are suppressed. */
+    lastfireat?: number;
+    /** Next scheduled fire time of a cron or interval rule. */
+    nextfireat?: number;
+    /** Pause marker set while the session pauses; queued fires drain on resume. */
+    pausedat?: number;
+}
+/** The per rule counters of the trigger history view: fires, launches and cooldown or dedupe suppressions. */
+export interface rulestats {
+    fires: number;
+    launches: number;
+    suppressions: number;
+}
+/** One trigger fire record: the rule, the time, the cause, the triggering url, title and payload carried into the run context. */
+export interface triggerfire {
+    id: string;
+    ruleid: string;
+    at: number;
+    cause: string;
+    /** Triggering url of a visit, url, urllist or navigation driven fire. */
+    url?: string;
+    /** Triggering page title carried into the run context. */
+    title?: string;
+    /** Trigger payload such as the verified webhook body or the observed event name. */
+    payload?: Record<string, unknown>;
+}
+/** One manual run request with its step preview: the expanded step list rendered before confirmation so a human always sees what a run will do. */
+export interface manualrun {
+    id: string;
+    workflowid: string;
+    /** The rendered step preview shown before confirmation. */
+    preview: Array<{
+        stepid: string;
+        kind: string;
+        label: string;
+        block?: string;
+        control?: Record<string, unknown>;
+    }>;
+    /** The confirmation outcome after the user approved or cancelled; an undecided preview stays open. */
+    confirmed?: boolean;
+    decidedat?: number;
+    at: number;
+}
+/** One canvas node of the workflow editor: the workflow step or the block invocation it renders with its canvas position. */
+export interface editornode {
+    /** The canvas node id: the step id, or the invocation id of a loaded block invocation which stays unique even when one block is invoked many times. */
+    id?: string;
+    /** The workflow step this node renders; absent on a block invocation node. */
+    step?: workflowstep;
+    /** The block invocation this node renders; absent on a plain step node. */
+    invocation?: blockinvocation;
+    x: number;
+    y: number;
+}
+/** One canvas edge of the workflow editor: a typed binding socket that links the output of one step into the input of a later step. */
+export interface editoredge {
+    from: string;
+    to: string;
+    variable: string;
+    kind: variablekind;
+    /** Dotted path into the source step outcome details; an absent path binds the summary. */
+    path?: string;
+}
+/** The layout state of the canvas: the canvas size, the viewport origin and the zoom factor. */
+export interface editorlayout {
+    width: number;
+    height: number;
+    viewportx: number;
+    viewporty: number;
+    zoom: number;
+}
+/** The mini map state: the mini canvas size, the projection scale from canvas coordinates and the viewport rectangle inside it. */
+export interface minimapstate {
+    width: number;
+    height: number;
+    /** Projection scale from canvas coordinates to mini map coordinates. */
+    scale: number;
+    zoom: number;
+    /** The viewport rectangle in mini map coordinates. */
+    viewport: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+/** The full canvas model the editor edits: the nodes, the typed edges, the block definitions, the layout, the mini map, the undo and redo stacks and the dirty marker. */
+export interface editormodel {
+    workflowid: string;
+    name: string;
+    version: number;
+    origins: string[];
+    nodes: editornode[];
+    edges: editoredge[];
+    blocks: workflowblock[];
+    layout: editorlayout;
+    minimap: minimapstate;
+    /** Undo snapshots, newest last; a snapshot never carries its own nested history. */
+    undo?: editormodel[];
+    /** Redo snapshots, newest last; a new edit clears them. */
+    redo?: editormodel[];
+    dirty: boolean;
+}
+/** The five categories of the block palette: actions, control flow, waits, variables and triggers. */
+export type palettecategory = "actions" | "controlflow" | "waits" | "variables" | "triggers";
+/** One palette descriptor of the block palette: the drop kind, its label, its category and its description. */
+export interface palettenode {
+    kind: string;
+    label: string;
+    category: palettecategory;
+    description: string;
+}
+/** One step library entry: the action kind, its palette category and its reviewed option schema. */
+export interface steplibraryentry {
+    kind: string;
+    category: palettecategory;
+    optionschema: Array<{
+        name: string;
+        kind: "string" | "number" | "boolean";
+        required?: boolean;
+    }>;
+}
+/** One local workflow version: the version number, its timestamp and the change note beside the step count and risk grade. */
+export interface workflowversion {
+    workflowid: string;
+    version: number;
+    createdat: number;
+    note: string;
+    steps: number;
+    risk?: actionrisk;
+    /** True when the version was created by rolling an older version back; the rollback review gates its first run. */
+    rollback?: boolean;
+}
+/** One version diff result: the added, removed and changed steps between two workflow versions. */
+export interface versiondiff {
+    workflowid: string;
+    from: number;
+    to: number;
+    added: Array<{
+        stepid: string;
+        kind: string;
+        label: string;
+    }>;
+    removed: Array<{
+        stepid: string;
+        kind: string;
+        label: string;
+    }>;
+    changed: Array<{
+        stepid: string;
+        kind: string;
+        label: string;
+        changes: string[];
+    }>;
+    at: number;
+}
+/** One run history entry: the outcome, the executed step count, the duration and the trigger cause of one execution. */
+export interface runhistoryentry {
+    runid: string;
+    workflowid: string;
+    outcome: string;
+    steps: number;
+    total: number;
+    duration: number;
+    cause: string;
+    startedat: number;
+    endedat: number;
+    dryrun?: boolean;
+}
+/** The export formats of a workflow file: json or yaml. */
+export type exportformat = "json" | "yaml";
+/** One exported workflow file: the file format version, the export time, the workflow record, the change note and the packed step templates. */
+export interface workflowfile {
+    format: 1;
+    exportedat: number;
+    workflow: workflowrecord;
+    note?: string;
+    templates: steptemplate[];
+}
+/** One nested parameter of a block invocation: the name, the variable kind and the default value bound into the block scope. */
+export interface nestedparam {
+    name: string;
+    kind: variablekind;
+    default?: string | number | boolean | string[];
+}
+/** One pending workflow import held for review: the parsed record stays unrunnable until the user approves it. */
+export interface workflowimport {
+    id: string;
+    record: workflowrecord;
+    importedat: number;
+    filename?: string;
+}
+/** One per site policy override of a workflow: the origin pattern and the reviewed policy knobs it adjusts. */
+export interface siteoverride {
+    id: string;
+    workflowid: string;
+    pattern: string;
+    deltas: Record<string, number>;
+    createdat: number;
+}
+/** The watchdog configuration: the stall threshold and the recovery action, both user configured values with no code ceiling. */
+export interface watchdogconfig {
+    enabled: boolean;
+    /** Milliseconds without a completed step after which a running run grades stalled. */
+    stallthreshold: number;
+    action: "retry" | "pause" | "cancel";
+    /** Window after which a running run with no live executor reaps as a zombie of a browser shutdown. */
+    zombiewindow?: number;
+}
+/** One watchdog event: the run it touched, the verdict and the recovery outcome. */
+export interface watchdogrecord {
+    id: string;
+    runid: string;
+    verdict: "stalled" | "zombie" | "healthy";
+    action: "retry" | "pause" | "cancel" | "reap" | "none";
+    outcome: string;
+    at: number;
+}
 //# sourceMappingURL=types.d.ts.map