@wenathlan/extension 1.1.62 → 1.1.63

package/dist/sessioninterface.d.ts

@@ -0,0 +1,213 @@
+import type { agentplan, cancelrunaction, consentmemoryentry, correctionentry, emptystatesurface, errorsurface, errorcause, historyindexentry, historysearchhit, historysearchquery, planprogress, recallindexentry, recallmatch, recallquery, rollbackdescriptor, runsummary, scratchpadentry, sessiongridrow, sitenote, stepoutcome, storedrunlog, tabsessionref } from "./types.js";
+/** Seals one sensitive note body at rest with a local keystream; the sealed text persists while the plain body never does. */
+export declare function sealnotebody(id: string, body: string): string;
+/** Opens one sealed note body for the reading surface; the plain body leaves storage only through this reader. */
+export declare function opennotebody(id: string, sealedbody: string): string;
+/** Builds one site note record per origin: the title, the body, the author provenance and the timestamps; a sensitive note seals its body at rest while a plain note keeps its body readable. */
+export declare function sitenoteof(input: {
+    origin: string;
+    title: string;
+    body: string;
+    author: string;
+    sensitive?: boolean;
+    now: number;
+    id?: string;
+}): sitenote;
+/** Reads the display body of one site note: a sensitive note opens its sealed body for the reader while a plain note returns its body. */
+export declare function notebodyof(note: sitenote): string;
+/** Applies one edit to a site note: the edit keeps the author provenance of the writer and the updated timestamp while the created timestamp stays. */
+export declare function editnote(note: sitenote, input: {
+    title: string;
+    body: string;
+    author: string;
+    now: number;
+}): sitenote;
+/** Expires the site notes past the user configured window: an absent window keeps every note while the expired notes leave the store at the user boundary only. */
+export declare function expirnotes(notes: sitenote[], retention: number | undefined, now: number): sitenote[];
+/** Builds one append only scratchpad entry of one task with its step provenance; the scratchpad never rewrites a written entry. */
+export declare function scratchentryof(input: {
+    taskid: string;
+    sessionid: string;
+    text: string;
+    stepid?: string;
+    author: string;
+    now: number;
+    id?: string;
+}): scratchpadentry;
+/** Reads the scratchpad of one task only: entries of another task never cross the owning task session boundary. */
+export declare function scratchpadof(entries: scratchpadentry[], taskid: string, sessionid: string): scratchpadentry[];
+/** Prunes the scratchpad entries past the user configured window: an absent window keeps every entry while the pruned entries leave the pad only at the user boundary. */
+export declare function prunescratchpad(entries: scratchpadentry[], window: number | undefined, now: number): scratchpadentry[];
+/** Distills one run summary from the completed run: the origins visited, the kinds executed and the per step outcomes inside the user configured window with no fixed cap; the distillation names its provenance. */
+export declare function distillrunsummary(input: {
+    plan: agentplan;
+    outcomes: stepoutcome[];
+    origins: string[];
+    sessionid: string;
+    window?: number;
+    provenance: "offscreenworker" | "inline";
+    now: number;
+}): runsummary;
+/** Builds the runsummary search corpus entry of one distilled summary so historysearch indexes every summary beside the notes and the session metadata. */
+export declare function summaryhistoryentry(summary: runsummary): historyindexentry;
+/** Builds the sitenote search corpus entry of one note; a sensitive note indexes its title and origin only so the sealed body never enters the corpus. */
+export declare function notehistoryentry(note: sitenote): historyindexentry;
+/** Builds one recall index entry from a past extraction record: the fingerprint deduplicates repeated extractions while the run and step provenance stays readable. */
+export declare function recallentryof(input: {
+    origin: string;
+    runid: string;
+    stepid: string;
+    text: string;
+    at: number;
+}): recallindexentry;
+/** Adds one recall index entry with fingerprint deduplication: a repeated extraction keeps its first index entry while later duplicates never double rank. */
+export declare function addrecallentry(index: recallindexentry[], entry: recallindexentry): recallindexentry[];
+/** Ranks the indexed extractions by local text similarity inside the worker: the jaccard overlap of the query terms and the entry terms, scoped to the origins of the run scope, with the provenance of every match. */
+export declare function rankrecall(index: recallindexentry[], query: recallquery, scope: {
+    origins: string[];
+}): recallmatch[];
+/** Expires the recall index entries past the user configured window: the live index keeps the window while the extraction records themselves stay for the audit trail. */
+export declare function expirerecallindex(index: recallindexentry[], window: number | undefined, now: number): recallindexentry[];
+/** Builds one correction memory entry from a plan review edit: the step shape before and after the edit with the reason in plain language. */
+export declare function editedcorrectionof(input: {
+    origin: string;
+    kind: string;
+    stepid: string;
+    original: string;
+    corrected: string;
+    reason: string;
+    now: number;
+    id?: string;
+}): correctionentry;
+/** Builds one correction memory entry from a rejected step: the step shape it refused with the rejection reason. */
+export declare function rejectedcorrectionof(input: {
+    origin: string;
+    kind: string;
+    stepid: string;
+    original: string;
+    reason: string;
+    now: number;
+    id?: string;
+}): correctionentry;
+/** Reads the past corrections that match a proposed step by origin and kind so proposal requests feed the matching history in. */
+export declare function matchingcorrections(corrections: correctionentry[], proposal: {
+    origin: string;
+    kind: string;
+}): correctionentry[];
+/** Expires the correction memory entries past the user configured window: an absent window keeps every correction. */
+export declare function expirecorrections(corrections: correctionentry[], window: number | undefined, now: number): correctionentry[];
+/** Builds one consent memory entry per origin: every grant, denial, expiry and revocation lands with its boundary and kinds while the record stays advisory. */
+export declare function consentmemoryof(input: {
+    origin: string;
+    decision: "grant" | "deny" | "expire" | "revoke";
+    boundary: string;
+    kinds: string[];
+    expiresat?: number;
+    now: number;
+    id?: string;
+}): consentmemoryentry;
+/** Reads the prior consent decisions of one origin for the prompt surface: the history stays advisory, the denial records carry the same weight as the grants and no entry ever auto grants. */
+export declare function consentadvisory(entries: consentmemoryentry[], origin: string, now: number): consentmemoryentry[];
+/** Reads the advisory verdict of the consent memory for a new prompt: the latest decision names itself, a refusal keeps its refusal and no history widens a boundary. */
+export declare function consentadvisoryverdict(entries: consentmemoryentry[], origin: string, kind: string): {
+    advisory: boolean;
+    reason: string;
+};
+/** Computes the queued and the executed steps of one run from the plan and its progress: the queued steps never executed while the executed steps stay in the sealed log. */
+export declare function rollbacksplit(plan: agentplan | undefined, progress: planprogress | undefined): {
+    executedstepids: string[];
+    queuedstepids: string[];
+};
+/** Builds the rollback option descriptor of one cancelrun: the queued scope rolls the queued steps back only while the executed steps stay untouched in the immutable log. */
+export declare function rollbackof(plan: agentplan | undefined, progress: planprogress | undefined, preference: "queued" | "none" | undefined): rollbackdescriptor;
+/** Builds one cancelrun action with its rollback option descriptor; the action never touches the sealed log of the executed steps. */
+export declare function cancelrunactionof(input: {
+    runid: string;
+    sessionid: string;
+    plan: agentplan | undefined;
+    progress: planprogress | undefined;
+    preference: "queued" | "none" | undefined;
+}): cancelrunaction;
+/** Builds one error surface payload of a failed step: the cause class, the message, the retry hint with the policy verdict and the context facts. */
+export declare function errorsurfaceof(input: {
+    stepid: string;
+    runid: string;
+    message: string;
+    cause: errorcause;
+    retryallowed: boolean;
+    retryreason: string;
+    context: Record<string, string>;
+    now: number;
+}): errorsurface;
+/** Classifies the cause of one failed step: a policy refusal and a gate wait carry their own classes, a network shaped message names the network and every other failure stays with the page. */
+export declare function classifyfailure(input: {
+    message: string;
+    policyrefused: boolean;
+    gatewait: boolean;
+}): errorcause;
+/** Reads the retry hint of one error surface: a retry passes only through a new reviewed dispatch, so the verdict names the reviewed path instead of an automatic one. */
+export declare function retryhintof(surface: errorsurface): {
+    allowed: boolean;
+    reason: string;
+};
+/** Derives the session grid rows from the existing session stores with no new state: the live run derives from the session, the plan and its progress, the saved runs derive from the sealed logs and their summaries, and the per tab lock state names the concurrent holder. */
+export declare function sessiongridrows(input: {
+    session?: {
+        id: string;
+        tabid: number;
+        origin: string;
+        stoppedat?: number;
+        pausedat?: number;
+        grants?: string[];
+    };
+    plan?: agentplan;
+    progress?: planprogress;
+    logs: storedrunlog[];
+    summaries: runsummary[];
+    locks: Array<{
+        runid: string;
+    }>;
+    tabsessions: tabsessionref[];
+}): sessiongridrow[];
+/** Normalizes one history search query: the non empty text with the optional origin, time range and outcome filters. */
+export declare function historyqueryof(value: unknown): historysearchquery | undefined;
+/** Adds one corpus entry to the incremental history index: each store write lands in the index at once so the search reads a growing corpus with no rebuild. */
+export declare function addhistoryentry(corpus: historyindexentry[], entry: historyindexentry): historyindexentry[];
+/** Extracts the matched terms of one query inside one text, case insensitive, for the result highlighting. */
+export declare function highlightterms(text: string, query: string): string[];
+/** Searches the one corpus of session metadata, notes and run summaries: the text matches with the matched terms highlighted, filtered by origin, time range and outcome. */
+export declare function historysearch(corpus: historyindexentry[], query: historysearchquery): historysearchhit[];
+/** Serves the empty state guidance of one session interface surface in plain language: the grid explains the first run, the search box suggests a first query, the notes explain the note flow and the scratchpad explains how the agent writes. */
+export declare function emptystatemessage(surface: emptystatesurface, origin?: string): string;
+/** Builds the per tab isolation key of one tab so parallel tabs never collide inside the session stores. */
+export declare function tabsessionkey(tabid: number): string;
+/** Builds one per tab session reference that isolates the session state per tab: parallel tabs keep their own session, run and origin references. */
+export declare function tabsessionrefof(input: {
+    tabid: number;
+    sessionid: string;
+    runid?: string;
+    origin: string;
+    now: number;
+}): tabsessionref;
+/** Exports the site notes, the run summaries and the correction memory as one audit bundle: every record carries its provenance while sensitive note bodies stay sealed. */
+export declare function sessionbundleof(input: {
+    notes: sitenote[];
+    summaries: runsummary[];
+    corrections: correctionentry[];
+    exportedat: number;
+}): {
+    kind: "sessionbundle";
+    notes: sitenote[];
+    summaries: runsummary[];
+    corrections: correctionentry[];
+    exportedat: number;
+};
+/**
+ * The recall seam the memory adapter documents for the future remote recall backend: today the local fingerprint index answers every semanticrecall query inside the extension, and the seam keeps the query and answer shapes stable so a reviewed remote backend can take the calls later without touching the callers.
+ */
+export interface recallseam {
+    recall(query: recallquery, scope: {
+        origins: string[];
+    }): Promise<recallmatch[]>;
+}
+//# sourceMappingURL=sessioninterface.d.ts.map

package/dist/sessioninterface.d.ts.map

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

package/dist/types.d.ts

@@ -1,9 +1,9 @@
-export declare const protocolversion: "1.1.62";
+export declare const protocolversion: "1.1.63";
 /** 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";
+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";
 /** Observation mode classes: passive capture, watched lifetimes and diffing passes. */
 export type observationmode = "passive" | "watching" | "diffing";
 export interface toolstep {
@@ -228,6 +228,22 @@ export interface runsettings {
     phishfreshness?: number;
     /** User configured mask shapes for sensitive field shapes beyond the documented password, token, card and secret families; per origin mask rules extend this list. */
     maskshapes?: string[];
+    /** Retention window for stored site notes; an absent window keeps every note. */
+    noteretention?: number;
+    /** Retention window for scratchpad entries; an absent window keeps every entry. */
+    scratchpadretention?: number;
+    /** Retention window for stored run summaries; an absent window keeps every summary. */
+    summaryretention?: number;
+    /** Retention window for stored correction memory entries; an absent window keeps every correction. */
+    correctionretention?: number;
+    /** The semantic recall index window in milliseconds; an entry older than the window leaves the live index while its records stay. */
+    recallwindow?: number;
+    /** True when historysearch index building stays on; an absent value keeps the incremental index on. */
+    historyindex?: boolean;
+    /** The user cancelrun rollback preference: queued rolls the queued steps back while none stops the run without a rollback. */
+    cancelrollback?: "queued" | "none";
+    /** The runsummary length window in steps the distillation keeps; an absent window keeps every step with no fixed cap. */
+    summarywindow?: number;
 }
 export interface proposalrequest {
     objective: string;
@@ -4305,7 +4321,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";
+export type logeventkind = "step" | "grant" | "expiry" | "revoke" | "deny" | "suspend" | "resume" | "seal" | "gate" | "phish" | "schema" | "inbound" | "cancel";
 /** 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;
@@ -4595,4 +4611,183 @@ export interface transparencygrant {
     boundary: string;
     grantedat: number;
 }
+/**
+ * Session interface contracts of the 1.1.63 family.
+ * The session becomes the primary interface here: sitenotes keep one note record per origin with title, body and author provenance while sensitive bodies seal at rest, the scratchpad holds append only entries per task with step provenance, runsummary distills a completed run into the origins visited, the kinds executed and the per step outcomes inside the user configured window, semanticrecall embeds past extraction records into a local fingerprint indexed corpus ranked by text similarity with run and step provenance, correctionmemory captures every plan review edit and rejection per origin and kind, consentmemory keeps every grant, denial, expiry and revocation per origin as advisory history that never auto grants, sessiongrid rows derive from the existing session stores with no new state, historysearch indexes session metadata, notes and summaries into one incremental corpus, errorsurface classifies every failed step cause as page, network, policy or gate with a retry hint carrying the policy verdict, and cancelrun rolls the queued steps back only while the executed steps stay untouched in the sealed log.
+ * The consent gates do not move: every interface action rides the same session, plan and origin review, and no interface surface ever bypasses the human review.
+ */
+/** One site note per origin: the title, the plain or sealed body, the author provenance and the timestamps; a sensitive note seals its body at rest so the plain text never persists. */
+export interface sitenote {
+    id: string;
+    origin: string;
+    title: string;
+    /** The plain body of a non sensitive note; a sensitive note carries its sealedbody instead. */
+    body?: string;
+    /** The locally sealed body of a sensitive note; the sealing stays an at rest measure and never replaces the user keychain. */
+    sealedbody?: string;
+    author: string;
+    sensitive: boolean;
+    createdat: number;
+    updatedat: number;
+}
+/** One append only scratchpad entry of one task: the text, its optional step provenance and the timestamp. */
+export interface scratchpadentry {
+    id: string;
+    taskid: string;
+    sessionid: string;
+    text: string;
+    /** The step the entry was written beside; an entry the user writes carries none. */
+    stepid?: string;
+    author: string;
+    at: number;
+}
+/** One distilled run summary of a completed run: the origins visited, the kinds executed, the per step outcomes inside the user configured window and the distillation provenance that names the offscreen worker task. */
+export interface runsummary {
+    runid: string;
+    sessionid: string;
+    origins: string[];
+    kinds: string[];
+    steps: Array<{
+        stepid: string;
+        kind: string;
+        ok: boolean;
+        summary: string;
+    }>;
+    /** The user configured step window the summary keeps; an absent window keeps every step with no fixed cap. */
+    window?: number;
+    task: "runsummary";
+    /** The distillation provenance: the offscreen worker pool or the inline fallback beside the page. */
+    provenance: "offscreenworker" | "inline";
+    distilledat: number;
+}
+/** One semantic recall query: the text to recall and the optional origin scope that stays inside the run scope. */
+export interface recallquery {
+    text: string;
+    origin?: string;
+    /** The user chosen match limit; an absent limit keeps every ranked match. */
+    limit?: number;
+}
+/** One semantic recall index entry: the extraction fingerprint, the origin, the run and step provenance and the indexed text. */
+export interface recallindexentry {
+    fingerprint: string;
+    origin: string;
+    runid: string;
+    stepid: string;
+    text: string;
+    at: number;
+}
+/** One ranked semantic recall match: the indexed entry, the text similarity score and the plain language reason. */
+export interface recallmatch {
+    entry: recallindexentry;
+    score: number;
+    reason: string;
+}
+/** One correction memory entry: the plan review edit or rejection captured per origin and kind, linking the step to its correction. */
+export interface correctionentry {
+    id: string;
+    origin: string;
+    kind: string;
+    stepid: string;
+    source: "edited" | "rejected";
+    /** The step shape before the correction. */
+    original: string;
+    /** The corrected step shape; a rejected step carries none. */
+    corrected?: string;
+    reason: string;
+    at: number;
+}
+/** One consent memory entry per origin: the grant, denial, expiry or revocation decision with its boundary, its kinds and its optional expiry; the record stays advisory and never auto grants. */
+export interface consentmemoryentry {
+    id: string;
+    origin: string;
+    decision: "grant" | "deny" | "expire" | "revoke";
+    boundary: string;
+    kinds: string[];
+    at: number;
+    /** The expiry the decision carried; an absent expiry keeps the record as history only. */
+    expiresat?: number;
+}
+/** One session grid row derived from the session stores with no new state: the session and run ids, the origin set, the live or saved state, the outcome, the step counts, the per tab lock state, the seal hash link of the sealed log chain and the actions the row offers. */
+export interface sessiongridrow {
+    sessionid: string;
+    runid: string;
+    origins: string[];
+    state: "live" | "saved";
+    outcome: string;
+    steps: number;
+    completed: number;
+    lock: "held" | "free";
+    tabid?: number;
+    sealhash?: string;
+    updatedat: number;
+    actions: Array<"resume" | "cancelrun" | "reopen">;
+}
+/** One history search query: the text with the optional origin, time range and outcome filters. */
+export interface historysearchquery {
+    text: string;
+    origin?: string;
+    from?: number;
+    to?: number;
+    outcome?: string;
+}
+/** The corpus sources historysearch indexes: session metadata, site notes and run summaries in one corpus. */
+export type historysource = "session" | "note" | "summary";
+/** One history search corpus entry written incrementally on each store write. */
+export interface historyindexentry {
+    source: historysource;
+    id: string;
+    origin?: string;
+    title: string;
+    text: string;
+    outcome?: string;
+    at: number;
+}
+/** One history search hit with the matched terms highlighted and the sealed run link. */
+export interface historysearchhit {
+    source: historysource;
+    id: string;
+    title: string;
+    excerpt: string;
+    highlights: string[];
+    origin?: string;
+    outcome?: string;
+    at: number;
+}
+/** The cause classes of one error surface: the page, the network, the policy or a confirm gate. */
+export type errorcause = "page" | "network" | "policy" | "gate";
+/** One error surface payload of a failed step: the cause class, the message in plain language, the retry hint with its policy verdict and the context facts. */
+export interface errorsurface {
+    stepid: string;
+    runid: string;
+    cause: errorcause;
+    message: string;
+    retry: {
+        allowed: boolean;
+        reason: string;
+    };
+    context: Record<string, string>;
+    at: number;
+}
+/** The rollback option descriptor of a cancelrun action: the queued steps it rolls back while the executed steps stay untouched. */
+export interface rollbackdescriptor {
+    scope: "queued" | "none";
+    label: string;
+    queuedstepids: string[];
+}
+/** The cancelrun action of one run: the run and the session it stops with its rollback option descriptor. */
+export interface cancelrunaction {
+    runid: string;
+    sessionid: string;
+    rollback: rollbackdescriptor;
+}
+/** The empty state surfaces of the session interface: the session grid, the history search box, the site notes and the scratchpad. */
+export type emptystatesurface = "sessiongrid" | "historysearch" | "sitenotes" | "scratchpad";
+/** One per tab session reference that isolates parallel tabs: the tab, its session, its optional run and its origin. */
+export interface tabsessionref {
+    tabid: number;
+    sessionid: string;
+    runid?: string;
+    origin: string;
+    updatedat: number;
+}
 //# sourceMappingURL=types.d.ts.map