@wenathlan/extension 1.1.50 → 1.1.52

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.50";
+export declare const protocolversion: "1.1.52";
 /** 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";
+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,6 +174,8 @@ 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;
 }
@@ -2528,4 +2530,249 @@ export interface runlogentry {
     checkpoint?: boolean;
     details?: Record<string, unknown>;
 }
+/** One condition payload of the 1.1.51 control flow family: the expression tested over the extracted values with no page side effect. */
+export interface conditionstep {
+    expression: expressiontype;
+}
+/** One branch path of a branch step: the path name, the optional match expression over page state and extracted values, and the child steps of the path. */
+export interface branchpath {
+    name: string;
+    /** Expression a path must satisfy to be chosen; the else path carries none. */
+    when?: expressiontype;
+    steps: workflowstep[];
+}
+/** One branch payload: the named paths with their match expressions and the mandatory else path that terminates every branch. */
+export interface branchstep {
+    paths: branchpath[];
+    else: branchpath;
+}
+/** One loop payload: the list variable iterated, the item and index variables bound per iteration, the optional user configured safety bound and the child steps of the body. */
+export interface loopstep {
+    list: string;
+    item: string;
+    index: string;
+    /** User configured maximum iteration count; an absent bound keeps the documented default. */
+    bound?: number;
+    steps: workflowstep[];
+}
+/** One repeat until payload: the convergence expression, the optional user configured safety bound and the child steps of the body. */
+export interface repeatuntilstep {
+    until: expressiontype;
+    /** User configured maximum iteration count; an absent bound keeps the documented default. */
+    bound?: number;
+    steps: workflowstep[];
+}
+/** One while payload: the loop condition, the mandatory user configured safety bound and the child steps of the body. */
+export interface whilestep {
+    while: expressiontype;
+    /** User configured maximum iteration count; a while loop without a safety bound is refused. */
+    bound: number;
+    steps: workflowstep[];
+}
+/** One foreach payload: the selector resolved into element references, the item and index variables bound per iteration and the child steps of the body. */
+export interface foreachstep {
+    selector: string;
+    item: string;
+    index: string;
+    steps: workflowstep[];
+}
+/** One parallel branch: the branch id and its child steps executed concurrently in an isolated scope. */
+export interface parallelbranch {
+    id: string;
+    steps: workflowstep[];
+}
+/** The join policy of a parallel step: the reviewed merge strategy of conflicting variable writes and whether sibling branches cancel or continue on branch failure. */
+export interface joinstep {
+    strategy: "first" | "last" | "fail";
+    onfail: "cancel" | "continue";
+}
+/** One parallel payload: the concurrent branches and the join policy that merges their outcomes. */
+export interface parallelstep {
+    branches: parallelbranch[];
+    join: joinstep;
+}
+/** The retry policy of a fragile block: the user configured attempt count with no code ceiling, the backoff shape with base and jitter and the retryable error classes. */
+export interface retrypolicy {
+    attempts: number;
+    backoff: {
+        shape: "fixed" | "exponential";
+        base: number;
+        jitter: number;
+    };
+    retryable: string[];
+}
+/** The error handler of a try step: the catch steps executed on failure and the optional rerun of the body after the handler. */
+export interface errorhandler {
+    steps: workflowstep[];
+    /** True when the body reruns once after the handler steps. */
+    rerun?: boolean;
+}
+/** The timeout policy of a try step: the per step and per run millisecond budgets, both user configured positive values with no code ceiling. */
+export interface timeoutpolicy {
+    stepms?: number;
+    runms?: number;
+}
+/** One try payload: the fragile body steps, the error handler, the optional retry policy and the optional timeout policy. */
+export interface trystep {
+    steps: workflowstep[];
+    catch: errorhandler;
+    retry?: retrypolicy;
+    timeout?: timeoutpolicy;
+}
+/** One loop counter of a run: the step, the iteration path with its nested index trail, the outcome flag and the time, recorded for audit. */
+export interface loopcounter {
+    stepid: string;
+    path: string;
+    iteration: number;
+    ok: boolean;
+    at: number;
+}
+/** One branch outcome of a run: the step, the chosen path and the reason it was chosen. */
+export interface branchoutcome {
+    stepid: string;
+    path: string;
+    reason: string;
+    at: number;
+}
+/** One retry attempt of a run: the step, the attempt number, the backoff delay in milliseconds, the error class and the time. */
+export interface retryattempt {
+    stepid: string;
+    attempt: number;
+    delay: number;
+    errorclass: string;
+    at: number;
+}
+/** One timeout abort of a run: the step, the exceeded budget in milliseconds, the abort scope and the time. */
+export interface timeoutabort {
+    stepid: string;
+    budget: number;
+    scope: "step" | "run";
+    at: number;
+}
+/** One join record of a run: the step, the reviewed merge strategy, the conflicting variable names and the merged variable names. */
+export interface joinrecord {
+    stepid: string;
+    strategy: string;
+    conflicts: string[];
+    merged: string[];
+    at: number;
+}
+/** One parallel branch outcome: the branch id, its ok flag, its summary and the cancelled marker when the join policy cancelled it. */
+export interface paralleloutcome {
+    branchid: string;
+    ok: boolean;
+    summary: string;
+    cancelled?: boolean;
+}
+/** One control flow decision of a run stored for audit: the branch, loop, retry, timeout, join, parallel or catch decision of one control step. */
+export interface controlflowdecision {
+    runid: string;
+    stepid: string;
+    kind: "branch" | "loop" | "retry" | "timeout" | "join" | "parallel" | "catch";
+    at: number;
+    branch?: branchoutcome;
+    loops?: loopcounter[];
+    retries?: retryattempt[];
+    timeouts?: timeoutabort[];
+    join?: joinrecord;
+    branches?: paralleloutcome[];
+    catch?: {
+        errorclass: string;
+        message: string;
+        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;
+}
 //# sourceMappingURL=types.d.ts.map