@wenathlan/extension 1.1.65 → 1.1.66

package/dist/syncbridge.d.ts

@@ -0,0 +1,80 @@
+import type { flowlibrarymanifest, syncbridgeconflict, syncbridgehook } from "./types.js";
+/** Computes the sync digest of one manifest: the canonical body the conflict detection compares across machines. */
+export declare function syncdigestof(manifest: flowlibrarymanifest): Promise<string>;
+/** Builds one syncbridge hook with its opt in off: no hook ever defaults on, the user flips the opt in from the optionspage. */
+export declare function syncbridgehookof(input: {
+    provider: "file" | "web";
+    direction: "pull" | "push" | "both";
+    endpoint: string;
+    now: number;
+}): syncbridgehook;
+/** Flips the explicit opt in of one hook: only the user turns a hook on or off and the state resets to idle. */
+export declare function syncbridgeoptinflip(hook: syncbridgehook, optin: boolean): syncbridgehook;
+/** Reads the provider registry the optionspage lists: the file provider with its manual import and export and the web provider stub behind the opt in gate. */
+export declare function syncbridgeproviders(): Array<{
+    provider: "file" | "web";
+    label: string;
+    operations: string[];
+    note: string;
+}>;
+/** Exports one manifest list as the syncbridge file payload: the manifests travel with their digests while secrets and logs never enter the payload under any flag. */
+export declare function syncbridgeexportpayload(manifests: flowlibrarymanifest[]): Promise<{
+    version: 1;
+    kind: "syncbridge";
+    manifests: flowlibrarymanifest[];
+    digests: string[];
+    exclusions: string[];
+}>;
+/** Validates one syncbridge payload for import: the scope gate refuses a payload that carries secrets or log entries in full while a manifest only payload validates with its digest list. */
+export declare function syncbridgevalidate(payload: {
+    kind?: string;
+    manifests?: unknown;
+    digests?: unknown;
+    exclusions?: unknown;
+    secrets?: unknown;
+    logs?: unknown;
+}): {
+    ok: boolean;
+    reason: string;
+};
+/** Runs one pull or push scan of a hook and returns its conflict records instead of a silent overwrite: the digest comparison of every manifest id surfaces both versions whenever the digests differ. */
+export declare function syncbridgescan(input: {
+    hook: syncbridgehook;
+    local: Array<{
+        manifestid: string;
+        version: string;
+        digest: string;
+    }>;
+    remote: Array<{
+        manifestid: string;
+        version: string;
+        digest: string;
+    }>;
+    now: number;
+}): Promise<{
+    conflicts: syncbridgeconflict[];
+    synced: string[];
+    reason: string;
+}>;
+/** Resolves one syncbridge conflict with a distinct user action: local keeps the local manifest, remote takes the remote one and merge defers the union to the user editor. */
+export declare function resolveconflict(conflict: syncbridgeconflict, resolution: "local" | "remote" | "merge", now: number): syncbridgeconflict;
+/** Lists the conflicts of one hook the optionspage shows with their resolve actions. */
+export declare function conflictsfor(conflicts: syncbridgeconflict[], hookid?: string): syncbridgeconflict[];
+/** Reads the web provider stub descriptor: the stub names its operations and stays honest that no network call ships before its backend exists. */
+export declare function webproviderstub(hook: syncbridgehook): {
+    hookid: string;
+    endpoint: string;
+    optin: boolean;
+    operations: string[];
+    stub: true;
+    reason: string;
+};
+/** Reads the file provider adapter of one hook: pull parses a dropped sync payload, push serializes the manifest list and list reads the local manifests; every operation moves manifests only. */
+export declare function fileproviderof(hook: syncbridgehook): {
+    hookid: string;
+    operations: Array<{
+        kind: "pull" | "push" | "list";
+        label: string;
+    }>;
+};
+//# sourceMappingURL=syncbridge.d.ts.map

package/dist/syncbridge.d.ts.map

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

package/dist/types.d.ts

@@ -1,9 +1,9 @@
-export declare const protocolversion: "1.1.65";
+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" | "datagrid" | "quickaction" | "shortcut" | "omnibox" | "notify" | "picker" | "shotpanel" | "compare" | "siteprofile" | "theme" | "locale" | "importexport" | "tour" | "a11y" | "pagechip" | "toast" | "recent" | "dropimport";
+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 {
@@ -266,6 +266,8 @@ export interface runsettings {
     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;
@@ -3033,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 {
@@ -4343,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;
@@ -4937,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 {
@@ -5216,4 +5222,189 @@ export interface stetoast {
     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