@wenathlan/extension 1.1.64 → 1.1.66

package/dist/types.d.ts

@@ -1,9 +1,9 @@
-export declare const protocolversion: "1.1.64";
+export declare const protocolversion: "1.1.66";
 /** Every reviewed action kind. Read kinds observe, interaction kinds move focus, sensitive kinds change page or browser state. */
 export type actionkind = "observe" | "inspect" | "extract" | "wait" | "waitfor" | "waittext" | "readattribute" | "readstyle" | "readgeometry" | "readvalue" | "readtext" | "readhtml" | "countelements" | "readtable" | "readlinks" | "readimages" | "readmeta" | "readforms" | "readstorage" | "highlight" | "tablist" | "windowlist" | "tabsnapshot" | "focus" | "scroll" | "hover" | "clickdeep" | "rightclick" | "doubleclick" | "scrollpage" | "scrollby" | "scrollend" | "scrolltop" | "fullscreen" | "zoomset" | "click" | "type" | "navigate" | "select" | "presskey" | "drag" | "drop" | "upload" | "clear" | "check" | "uncheck" | "toggle" | "submit" | "reload" | "back" | "forward" | "writestorage" | "setattribute" | "removeattribute" | "evaluate" | "tabcreate" | "tabactivate" | "tabclose" | "tabreload" | "windowcreate" | "windowclose" | "windowresize" | "downloadfile" | "movepointer" | "clickpoint" | "shiftclick" | "clicktext" | "clickaria" | "clickname" | "resolvexpath" | "typetime" | "appendtext" | "setvalue" | "typeedit" | "keyhold" | "keyrelease" | "submitsearch" | "selectmulti" | "chooseradio" | "setslider" | "setdate" | "setcolor" | "expanddetails" | "dismissdialog" | "pierceshadow" | "enterframe" | "retryaction" | "mapclicks" | "verifyvisible" | "verifyenabled" | "a11ytree" | "readvisible" | "readertree" | "detectlists" | "detecttables" | "readjson" | "watchmutate" | "waitquiet" | "watchbanner" | "detectinfinitescroll" | "detectvirtual" | "detectlazy" | "readscrollpos" | "readlang" | "readoutline" | "countpages" | "listshadow" | "listframes" | "classifypage" | "fingerprintsection" | "diffsnapshots" | "readselection" | "watchfocus" | "detectsticky" | "detectscrolllock" | "readopengraph" | "detectlanguage" | "deriveselector" | "openlink" | "openprivate" | "reloadcache" | "stopnav" | "waitload" | "waiturl" | "followlink" | "spanav" | "spawait" | "rewritequery" | "setfragment" | "navlist" | "navprofile" | "detecthttp" | "readredirects" | "readfinalurl" | "handleauth" | "printpdf" | "prefetch" | "preconnect" | "deeplink" | "reopentab" | "trailaudit" | "pausenav" | "navintent" | "navrate" | "openclipboard" | "checksafe" | "batchopen" | "querytabs" | "duplicatetab" | "closepattern" | "pintab" | "mutetab" | "movetab" | "movetabwindow" | "grouptabs" | "colorgroup" | "collapsegroup" | "discardtab" | "reloadtabs" | "zoomin" | "zoomout" | "watchtab" | "switchtab" | "maximizewindow" | "minimizewindow" | "restorewindow" | "focuswindow" | "scratchwindow" | "incognitowindow" | "restoretab" | "savelayout" | "restorelayout" | "findclones" | "searchtabs" | "badgetab" | "attachmeta" | "listaudio" | "reopenrun" | "snapshotsession" | "fillform" | "filllabel" | "fillplaceholder" | "detectfields" | "generatevalues" | "saveprofiles" | "asksubmit" | "submitform" | "readerrors" | "retryform" | "runwizard" | "selectchain" | "picktypeahead" | "pickdate" | "attachfile" | "handoffcaptcha" | "fillcard" | "fillcode" | "consentpassword" | "skiphoneypot" | "detectlogin" | "detecttemplate" | "scrapetable" | "exportcsv" | "exportjson" | "exportexcel" | "copytable" | "pushsheets" | "importcsv" | "looprows" | "transformvalues" | "deduperows" | "paginateextract" | "mergepages" | "stamplerows" | "previewgrid" | "streamdisk" | "resumeextract" | "logprovenance" | "batchdownload" | "pausedownload" | "resumedownload" | "verifydownload" | "interceptmime" | "exportnetlog" | "readclipboard" | "writeclipboard" | "copyscreen" | "quarantinedownload" | "scanvirus" | "namecaptures" | "cleanupartifacts" | "shotview" | "shotfullpage" | "shotelement" | "shotregion" | "contactsheet" | "capturepdf" | "recordscreen" | "captureaudio" | "captureframe" | "downloadimages" | "shotcanvas" | "probestream" | "readmedia" | "readassets" | "timelapse" | "convertimage" | "makethumbs" | "fetchurl" | "parsejson" | "parsehtml" | "callrest" | "callgraphql" | "opensocket" | "sendmessage" | "waitmessage" | "watchrequests" | "readheaders" | "capturebodies" | "subscribesse" | "longpoll" | "mapapi" | "extractapi" | "blockrequest" | "mockresponse" | "rewriteheaders" | "setcookies" | "readcookies" | "clearcookies" | "authflow" | "saveapikey" | "routeproxy" | "postform" | "postfiles" | "watchconsole" | "watcherrors" | "watchtasks" | "attachcdp" | "detachcdp" | "cdpcmd" | "watchcdp" | "setbreakpoint" | "stepcode" | "watchexpr" | "overridescript" | "measureflow" | "heapshot" | "trackmemory" | "profilecpu" | "watchshifts" | "traceload" | "annotatetrace" | "replaytrace" | "capturesourcemaps" | "emulatedevice" | "emulatenetwork" | "emulatelocate" | "setuseragent" | "overridepermission" | "blackboxscripts" | "persiststate" | "capturesession" | "restoresession" | "namedsessions" | "diffsessions" | "searchsessions" | "exportsessions" | "importsessions" | "composeworkflow" | "savetemplate" | "runworkflow" | "dryrun" | "delay" | "waitelement" | "compute" | "extractvars" | "listruns" | "condition" | "branch" | "loop" | "repeatuntil" | "whileloop" | "foreach" | "parallel" | "trycatch" | "visitrule" | "urlrule" | "menurule" | "keyrule" | "buttonrule" | "cronrule" | "intervalrule" | "urllistrule" | "webhookrule" | "eventrule";
 export type actionrisk = "read" | "interaction" | "sensitive";
 export type planstate = "draft" | "pending" | "approved" | "rejected" | "expired" | "completed" | "cancelled";
-export type auditkind = "configure" | "session" | "observe" | "proposal" | "approval" | "action" | "error" | "stop" | "pause" | "resume" | "complete" | "capability" | "tab" | "window" | "download" | "pointer" | "dialog" | "hold" | "retry" | "observation" | "watch" | "diff" | "navigation" | "redirect" | "auth" | "prefetch" | "rate" | "group" | "layout" | "discard" | "badge" | "fill" | "submit" | "consent" | "handoff" | "scrape" | "export" | "stream" | "provenance" | "resume" | "intercept" | "clipboard" | "quarantine" | "cleanup" | "capture" | "media" | "call" | "socket" | "replay" | "control" | "timeline" | "debugger" | "profile" | "emulation" | "workflow" | "trigger" | "protocol" | "tool" | "model" | "swarm" | "environment" | "worker" | "sandbox" | "grant" | "expiry" | "revoke" | "deny" | "seal" | "mask" | "vault" | "gate" | "phish" | "defer" | "schema" | "inbound" | "transparency" | "notes" | "scratchpad" | "summary" | "recall" | "correction" | "consentmemory" | "cancel" | "search" | "palette" | "surface" | "onboarding" | "logstream";
+export type auditkind = "configure" | "session" | "observe" | "proposal" | "approval" | "action" | "error" | "stop" | "pause" | "resume" | "complete" | "capability" | "tab" | "window" | "download" | "pointer" | "dialog" | "hold" | "retry" | "observation" | "watch" | "diff" | "navigation" | "redirect" | "auth" | "prefetch" | "rate" | "group" | "layout" | "discard" | "badge" | "fill" | "submit" | "consent" | "handoff" | "scrape" | "export" | "stream" | "provenance" | "resume" | "intercept" | "clipboard" | "quarantine" | "cleanup" | "capture" | "media" | "call" | "socket" | "replay" | "control" | "timeline" | "debugger" | "profile" | "emulation" | "workflow" | "trigger" | "protocol" | "tool" | "model" | "swarm" | "environment" | "worker" | "sandbox" | "grant" | "expiry" | "revoke" | "deny" | "seal" | "mask" | "vault" | "gate" | "phish" | "defer" | "schema" | "inbound" | "transparency" | "notes" | "scratchpad" | "summary" | "recall" | "correction" | "consentmemory" | "cancel" | "search" | "palette" | "surface" | "onboarding" | "logstream" | "datagrid" | "quickaction" | "shortcut" | "omnibox" | "notify" | "picker" | "shotpanel" | "compare" | "siteprofile" | "theme" | "locale" | "importexport" | "tour" | "a11y" | "pagechip" | "toast" | "recent" | "dropimport" | "library" | "syncbridge" | "attention" | "backgroundrun" | "runreplay" | "outputcompare";
 /** Observation mode classes: passive capture, watched lifetimes and diffing passes. */
 export type observationmode = "passive" | "watching" | "diffing";
 export interface toolstep {
@@ -254,6 +254,20 @@ export interface runsettings {
     paletteshortcut?: string;
     /** The byte ceiling above which diffpreview generation offloads to the offscreen worker pool when the user granted the offscreen capability; an absent ceiling keeps every diff inline. */
     diffpreviewbytes?: number;
+    /** The recenttray depth: the number of latest runs the popup tray keeps; an absent depth keeps every run. */
+    recenttraydepth?: number;
+    /** True when the user consents to notifications that carry page content; an absent value keeps every notification body content free so no consent is needed. */
+    notifyconsent?: boolean;
+    /** True when the user turns the done and attention notifications on; an absent value keeps them on with content free bodies only. */
+    notifyenabled?: boolean;
+    /** The manual darklight override: dark or light forces the theme while system follows the os preference; an absent value follows the os preference alone. */
+    themepreference?: "dark" | "light" | "system";
+    /** The language of the interface strings; an absent value keeps english with the locale fallback. */
+    uilanguage?: string;
+    /** The steteoast live count: the number of newest step toasts the live stack keeps while the full history stays queryable; an absent count keeps every toast live. */
+    toastlivecount?: number;
+    /** Retention window for stored attentionfeed entries; an absent window keeps every entry while the resolution events always survive in the audit trail. */
+    attentionretention?: number;
 }
 export interface proposalrequest {
     objective: string;
@@ -3021,6 +3035,8 @@ export interface workflowimport {
     record: workflowrecord;
     importedat: number;
     filename?: string;
+    /** The flowlibrary manifest version the record resolved from; an absent version marks a plain file import outside the library. */
+    libraryversion?: string;
 }
 /** One per site policy override of a workflow: the origin pattern and the reviewed policy knobs it adjusts. */
 export interface siteoverride {
@@ -4331,7 +4347,7 @@ export interface sealedrunstate {
 /** The sensitive classes of the 1.1.61 family: payment, credential, delete and publish steps each need one fresh consent prompt per class per origin. */
 export type sensitiveclass = "payment" | "credential" | "delete" | "publish";
 /** The event kinds of the immutable run log: step transitions, grants, window expiries, revocations, denials, suspensions, resumes and the completion seal. */
-export type logeventkind = "step" | "grant" | "expiry" | "revoke" | "deny" | "suspend" | "resume" | "seal" | "gate" | "phish" | "schema" | "inbound" | "cancel" | "review";
+export type logeventkind = "step" | "grant" | "expiry" | "revoke" | "deny" | "suspend" | "resume" | "seal" | "gate" | "phish" | "schema" | "inbound" | "cancel" | "review" | "library" | "background";
 /** The hash chain fields of one immutable log entry: the hash of its predecessor, the entry hash written at append time and the algorithm that derives both. */
 export interface loghash {
     previous: string;
@@ -4805,8 +4821,8 @@ export interface tabsessionref {
  * The interface becomes a family of five surfaces here: the popup grows into a command surface, the sidepanel becomes the workspace with plan, run and review tabs, the dashboardpage opens a full page view in a new tab, the optionspage gathers every setting in one place and the onboarding walks a first run. The commandpalette registers entries from every module at startup, lists only the actions the current capability set allows and ranks fuzzy matches with the recent commands first; the taskinput submits natural language goals through the same proposal flow as the api with the active origin and page outline attached; plancards render one card per proposed step with kind, risk class, environment and options grouped by risk class with the sensitive classes expanded by default; stepapprove resolves one step per human action with approve, reject and edit provenance written into the immutable log; diffpreview compares the observed before state with the predicted after state of write class steps only with masked values carrying their mask verdicts; the stepstimeline derives its nodes from progress records with no new state; and the logstream renders live events with level, source and step ref while the single broadcast channel carries run state to every surface.
  * The consent gates do not move: every surface action rides the same policy gates, the command bus records each routing in the audit trail, and no interface surface ever bypasses the human review.
  */
-/** The five interface surfaces of the 1.1.64 family: the popup command surface, the sidepanel workspace, the dashboardpage, the optionspage and the onboarding walkthrough. */
-export type uisurface = "popup" | "sidepanel" | "dashboardpage" | "optionspage" | "onboarding";
+/** The interface surfaces of the 1.1.64 and 1.1.65 families: the popup command surface, the sidepanel workspace, the dashboardpage, the optionspage, the onboarding walkthrough, the omnibox entry point and the inline page surface of the pagechips. */
+export type uisurface = "popup" | "sidepanel" | "dashboardpage" | "optionspage" | "onboarding" | "omnibox" | "page";
 /** One commandpalette action: the command it routes, the surface it opens on, the optional permission it needs granted and whether it needs an active session. */
 export interface paletteaction {
     command: string;
@@ -4925,6 +4941,8 @@ export interface onboardingstep {
     title: string;
     body: string;
     completion: string;
+    /** True when the walkthrough stop is optional: the completion of every mandatory stop alone finishes the walkthrough while the optional stop enriches it. */
+    optional?: boolean;
 }
 /** The onboarding state: the completed steps, the done mark, the single consent scoped event a full completion writes and the timestamps. */
 export interface onboardingstate {
@@ -4968,4 +4986,425 @@ export interface paletteuserecord {
     count: number;
     lastusedat: number;
 }
+/**
+ * Interface surface contracts of the 1.1.65 family, part two.
+ * This family finishes the interface layer: the datagrid arranges extraction results into columns and rows with inferred types and the exportmenu ships them as csv, json or clipboard in masked form only; quickactions, shortcutkeys and the omniboxtask shorten the path to a run behind the same gates; the statusbadge, the done and attention notifications, the recenttray and the stetoasts keep the user informed without watching; the pickeroverlay, the targethalo, the guidedtips, the shotpanel, the compareviewer and the pagechips cover selection and evidence; and the siteprofiles, the darklight theme tokens, the locale bundles, the importexport payloads, the dropimport sessions, the featuretour stops and the a11ylabels round out the surface.
+ * The consent gates do not move: every quickaction rides the origin allowlist of the clicked tab, every omnibox goal routes through the proposal flow, every notification with page content needs its consent, every picker read stays inside the granted origin, no bundle ever ships a secretvault value or an unmasked log, and no interface element ever bypasses the human review.
+ */
+/** One datagrid column with its type inferred from the observed values: text, number, boolean, date or an all empty column. */
+export interface datagridcolumn {
+    field: string;
+    label: string;
+    type: "text" | "number" | "boolean" | "date" | "empty";
+    /** True when the type was inferred from the values rather than declared by the extraction. */
+    inferred: boolean;
+}
+/** One datagrid row: its original order as index, its field values and its selected mark of a partial export range. */
+export interface datagridrow {
+    index: number;
+    values: Record<string, string>;
+    /** True when the row sits inside the selected range of a partial export. */
+    selected?: boolean;
+}
+/** One datagrid view of an extraction result: the title, the origin, the run, the inferred columns, the rows and the build time. */
+export interface datagridview {
+    id: string;
+    title: string;
+    origin: string;
+    runid: string;
+    columns: datagridcolumn[];
+    rows: datagridrow[];
+    at: number;
+}
+/** One exportmenu descriptor: the csv, json or clipboard format, the selection, step or run scope and the download, clipboard or memory destination. */
+export interface exportmenudescriptor {
+    format: "csv" | "json" | "clipboard";
+    scope: "selection" | "step" | "run";
+    destination: "download" | "clipboard" | "memory";
+}
+/** One quickaction bound to a context menu entry: the command it routes, the surface it opens on, the optional permission it needs granted and whether it needs an active session. */
+export interface quickaction {
+    id: string;
+    label: string;
+    command: string;
+    surface: uisurface;
+    /** The optional capability the quickaction needs granted before it registers; an absent permission needs none. */
+    permission?: string;
+    /** True when the quickaction needs an active browser session before it registers. */
+    session?: boolean;
+}
+/** One shortcutkeys binding: the command it triggers, the key, the modifiers, the user editable mark and the surface it binds on; the palette command binds on every surface. */
+export interface shortcutbinding {
+    command: string;
+    key: string;
+    modifiers: string[];
+    editable: boolean;
+    surface: uisurface;
+}
+/** One omniboxtask submission parsed from the omnibox keyword: the natural language goal after the keyword, the active origin and the time. */
+export interface omniboxtasksubmission {
+    id: string;
+    text: string;
+    origin: string;
+    surface: "omnibox";
+    at: number;
+}
+/** One statusbadge state of the toolbar icon: idle, running, waiting or attention with the count of waiting gates that need a human. */
+export interface statusbadgestate {
+    state: "idle" | "running" | "waiting" | "attention";
+    waitingcount: number;
+    runid?: string;
+}
+/** One notification payload: the done or attention kind, the title, the body, the deep link, the optional step ref and whether the body carries page content that needs its consent. */
+export interface notificationpayload {
+    id: string;
+    kind: "done" | "attention";
+    title: string;
+    body: string;
+    deeplink: string;
+    runid?: string;
+    stepid?: string;
+    /** True when the notification body carries page content; the content consent gate must allow before it shows. */
+    content: boolean;
+    at: number;
+}
+/** One recenttray entry: the run id, the origin, the outcome, the title, the time and the resume and reopen offers. */
+export interface recenttrayentry {
+    runid: string;
+    origin: string;
+    outcome: "running" | "completed" | "halted" | "failed";
+    title: string;
+    at: number;
+    resumable: boolean;
+    reopenable: boolean;
+}
+/** One pickeroverlay candidate: the selector, the optional text and role anchors, the stability score and the plain language reason the score stands. */
+export interface pickercandidate {
+    selector: string;
+    text?: string;
+    role?: string;
+    stabilityscore: number;
+    reason: string;
+}
+/** One pickeroverlay session: the granted origin it reads, the ranked candidates, the locked step and selector and the start time. */
+export interface pickersession {
+    id: string;
+    origin: string;
+    candidates: pickercandidate[];
+    /** The step the locked candidate binds to; one session locks one candidate. */
+    lockedstepid?: string;
+    lockedselector?: string;
+    startedat: number;
+}
+/** One targethalo geometry descriptor: the step it outlines, the target selector, the pixel rect and the step state that colors the outline. */
+export interface targethalo {
+    stepid: string;
+    selector: string;
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    state: "pending" | "running" | "waiting" | "done" | "failed" | "halted";
+}
+/** One guidedtip: the surface it teaches, the title, the body and the picker step it binds to. */
+export interface guidedtip {
+    id: string;
+    surface: uisurface;
+    title: string;
+    body: string;
+    pickerstep?: string;
+}
+/** One shotpanel view: the step, the run, the capture id, the capture provenance, the origin, the redaction verdicts, the zoom and pan the user set and the build time. */
+export interface shotpanelview {
+    id: string;
+    stepid: string;
+    runid: string;
+    captureid: string;
+    provenance: "viewport" | "fullpage" | "element" | "region";
+    origin: string;
+    redactions: Array<{
+        region: string;
+        verdict: string;
+    }>;
+    zoom: number;
+    pan: {
+        x: number;
+        y: number;
+    };
+    at: number;
+}
+/** One compareviewer pair: the step it compares, the before capture, the after capture and the slider position of the overlay. */
+export interface compareviewerpair {
+    id: string;
+    stepid: string;
+    beforecaptureid: string;
+    aftercaptureid: string;
+    slidervalue: number;
+}
+/** One siteprofile: the per site interface preferences (the theme, the shortcutkeys and the default view) stored beside the originprofiles policy preferences of its origin. */
+export interface siteprofile {
+    origin: string;
+    theme?: "dark" | "light" | "system";
+    shortcuts?: shortcutbinding[];
+    defaultview?: string;
+    updatedat: number;
+}
+/** One darklight theme token set: the mode and the token values every surface, including the dashboardpage, reads; the source names whether the os preference, the user override or the siteprofile decided. */
+export interface darklighttokens {
+    mode: "dark" | "light";
+    tokens: Record<string, string>;
+    source?: "os" | "user" | "site";
+}
+/** One locale bundle: the language and its interface strings; english ships as the fallback base. */
+export interface localebundle {
+    language: string;
+    strings: Record<string, string>;
+}
+/** One importexport payload: the settings and data bundle of one profile with its originprofiles, siteprofiles, notes and preferences and the honest exclusion list; secretvault values and unmasked logs never enter any bundle under any flag. */
+export interface importexportpayload {
+    version: number;
+    kind: "settings" | "data";
+    profile: string;
+    exportedat: number;
+    contents: {
+        originprofiles: Array<Record<string, unknown>>;
+        siteprofiles: Array<Record<string, unknown>>;
+        notes: Array<Record<string, unknown>>;
+        preferences: Record<string, unknown>;
+        /** Present only when a bundle wrongly carries log entries; the validation refuses such bundles in full. */
+        unmaskedlogs?: Array<Record<string, unknown>>;
+    };
+    exclusions: string[];
+}
+/** One dropimport session: the dropped filename, the detected csv, json or workflow kind, the byte size, the accepted mark and the time. */
+export interface dropimportsession {
+    id: string;
+    filename: string;
+    kind: "csv" | "json" | "workflow";
+    bytes: number;
+    accepted: boolean;
+    at: number;
+}
+/** One featuretour stop: the surface it walks, the focus selector it highlights, the title, the body and the stop order. */
+export interface featuretourstop {
+    id: string;
+    surface: uisurface;
+    focus: string;
+    title: string;
+    body: string;
+    order: number;
+}
+/** One a11ylabel: the control it names, its role, its accessible name and its optional state and value for screen readers, resolved through the locale bundles so labels follow the language of the interface. */
+export interface a11ylabel {
+    control: string;
+    role: "button" | "textbox" | "tab" | "table" | "list" | "slider" | "switch" | "radiogroup" | "combobox" | "group" | "region" | "search" | "dialog";
+    name: string;
+    state?: string;
+    value?: string;
+}
+/** One pagechip confirmation: the gated step, the anchor selector, the origin, the approve or reject resolution, the resolved time and the build time. */
+export interface pagechipconfirmation {
+    id: string;
+    stepid: string;
+    selector: string;
+    origin: string;
+    resolution?: "approve" | "reject";
+    resolvedat?: number;
+    at: number;
+}
+/** One steteoast: the step completion confirmation with the step kind, its duration in milliseconds and the time. */
+export interface stetoast {
+    id: string;
+    stepid: string;
+    kind: string;
+    durationms: number;
+    at: number;
+}
+/**
+ * Ecosystem contracts of the 1.1.66 family.
+ * This family opens the ecosystem layer: the flowlibrary entries with their manifests, required grants, data expectations and publisher provenance share workflow templates behind the same review; the syncbridge hooks move manifests between machines behind an explicit opt in; the attentionfeed collects every gate wait, phishguard block, deferral and failure with its deep link; the background run queue keeps workflows executing with the keepalive signal held; the runreplay walks a sealed chain step by step for audit; and the outputcompare sessions set two runs beside each other under a recorded metric set.
+ * The consent gates do not move: every library import lands as a proposal that still passes the plan review, no hook ever defaults on, the replay reads sealed logs only and the comparison never executes a step.
+ */
+/** One flowlibrary manifest: the shared workflow template with its steps, kinds, required grants, data expectations with minimization hints and the optional publisher signature. */
+export interface flowlibrarymanifest {
+    id: string;
+    title: string;
+    description: string;
+    version: string;
+    /** The publisher identity of the manifest; every registry origin stays a user configured value with nothing hardcoded. */
+    publisher: string;
+    /** The user configured registry origin the entry was browsed from; an absent origin marks a local export. */
+    registry?: string;
+    steps: flowlibrarystep[];
+    /** The action kinds the manifest steps use; the import refuses kinds the installed capability set lacks. */
+    kinds: string[];
+    /** The origin grants the manifest needs before any import completes; the grant diff shows them before the import lands. */
+    requiredgrants: string[];
+    /** The data expectations of the manifest with the minimization hints each step declares. */
+    dataexpectations: dataexpectation[];
+    /** True when the entry is marked sensitive and needs a fresh consent prompt before any import. */
+    sensitive: boolean;
+    /** The publish descriptor with the publisher signature and provenance when the publisher signed the manifest. */
+    publish?: publishdescriptor;
+}
+/** One flowlibrary manifest step: the action kind, its label, the optional target and value and the selector namespace the installer rewrites for the local profile. */
+export interface flowlibrarystep {
+    id: string;
+    kind: string;
+    label: string;
+    target?: string;
+    value?: string;
+    /** The selector namespace of the step target: the install prefixes it onto the local selector so shared templates address the local profile. */
+    namespace?: string;
+}
+/** One data expectation of a manifest step: the data family the step touches and the fields it limits itself to as its minimization hint. */
+export interface dataexpectation {
+    stepid: string;
+    /** The data family the step reads or writes such as form values, text content or captures. */
+    family: string;
+    /** The minimization hint: the exact fields the step needs and nothing broader. */
+    fields: string[];
+}
+/** One publish descriptor: the publisher signature over the manifest digest with its provenance; the verification refuses a signature over any other body in full. */
+export interface publishdescriptor {
+    publisher: string;
+    signature: string;
+    /** The manifest digest the signature covers. */
+    digest: string;
+    /** The provenance chain of the publish: where the entry came from. */
+    provenance: string;
+    publishedat: number;
+}
+/** One flowlibrary entry: the manifest with its digest, its state and its provenance; the store deduplicates entries by manifest digest and quarantines unverified publishers. */
+export interface flowlibraryentry {
+    id: string;
+    manifest: flowlibrarymanifest;
+    /** The sha-256 digest of the manifest body; the store deduplicates and the syncbridge detects conflicts by this value. */
+    digest: string;
+    /** The entry state: quarantined entries never install until the user verifies their publisher. */
+    state: "available" | "installed" | "quarantined";
+    installedat?: number;
+    /** The provenance attached to every entry: where it came from and what its signature verification said. */
+    provenance: string;
+    addedat: number;
+}
+/** One library lifecycle event of the store and the immutable log: every install, update and removal records with its entry provenance. */
+export interface libraryevent {
+    id: string;
+    kind: "install" | "update" | "remove";
+    entryid: string;
+    title: string;
+    version: string;
+    detail: string;
+    at: number;
+}
+/** One syncbridge hook: the provider, the direction and the state of one manifest sync hook behind its explicit opt in with no default on. */
+export interface syncbridgehook {
+    id: string;
+    provider: "file" | "web";
+    direction: "pull" | "push" | "both";
+    /** True only after the user opts in; no hook ever defaults on. */
+    optin: boolean;
+    /** The user configured endpoint of the provider: a registry url for the web provider or a file label for the file provider; nothing is hardcoded. */
+    endpoint: string;
+    state: "idle" | "syncing" | "error";
+    lastsyncat?: number;
+    createdat: number;
+}
+/** One syncbridge conflict: both manifest versions surface instead of a silent overwrite, with the resolution the user picked. */
+export interface syncbridgeconflict {
+    id: string;
+    hookid: string;
+    manifestid: string;
+    local: {
+        digest: string;
+        version: string;
+    };
+    remote: {
+        digest: string;
+        version: string;
+    };
+    resolution?: "local" | "remote" | "merge";
+    resolvedat?: number;
+    detectedat: number;
+}
+/** The attention causes the feed collects: gate waits, phishguard blocks, deferrals and failures. */
+export type attentioncause = "gatewait" | "phishguard" | "deferral" | "failure";
+/** One attentionfeed entry: the cause, the run ref, the gate ref, the severity rank and the deep link to the waiting surface that resolves the cause. */
+export interface attentionentry {
+    id: string;
+    cause: attentioncause;
+    severity: "critical" | "warning" | "info";
+    runid: string;
+    /** The gate the run waits at when the cause is a gate wait. */
+    gateref?: string;
+    origin: string;
+    summary: string;
+    /** The deep link that opens the exact waiting surface. */
+    deeplink: string;
+    at: number;
+}
+/** One background run queue entry: the reviewed workflow the queue runs with no surface open, holding the keepalive signal for its duration. */
+export interface backgroundqueueentry {
+    id: string;
+    workflowid: string;
+    state: "queued" | "running" | "done" | "failed";
+    /** True while the run holds the keepalive signal of the run state family for its whole duration. */
+    keepaliveheld: boolean;
+    queuedat: number;
+    startedat?: number;
+    endedat?: number;
+    summary: string;
+}
+/** One runreplay step: the log entry it restores with its observation and capture refs and the gate resolutions the step annotates. */
+export interface runreplaystep {
+    stepid: string;
+    index: number;
+    summary: string;
+    /** The observation version the step restored when the sealed log carries it. */
+    observationversion?: number;
+    /** The capture id the step restored when the sealed log carries it. */
+    captureid?: string;
+    gateresolutions: Array<{
+        gateid: string;
+        kind: string;
+        resolution: string;
+        at: number;
+    }>;
+}
+/** One runreplay session: the recorded run id, the cursor, the play state, the replay steps and the viewer actions the audit trail records. */
+export interface runreplaysession {
+    id: string;
+    runid: string;
+    /** The step index the viewer stands on. */
+    cursor: number;
+    playing: boolean;
+    steps: runreplaystep[];
+    openedat: number;
+    actions: Array<{
+        kind: "play" | "pause" | "step" | "jump";
+        stepid?: string;
+        at: number;
+    }>;
+}
+/** One outputcompare session: the two run ids, the metric set the session used, the per step grades and the first divergence. */
+export interface outputcomparesession {
+    id: string;
+    runids: [string, string];
+    /** The metric set the comparison used, recorded in the audit trail. */
+    metrics: string[];
+    steps: Array<{
+        stepid: string;
+        index: number;
+        agreement: "agree" | "diverge" | "onlyone";
+        summarya: string;
+        summaryb: string;
+        durationdelta: number;
+    }>;
+    /** The index of the first divergent step; an absent index marks agreement across the whole sequence. */
+    firstdivergence?: number;
+    openedat: number;
+}
 //# sourceMappingURL=types.d.ts.map