@wenathlan/extension 1.1.52 → 1.1.54

package/dist/types.d.ts

@@ -1,9 +1,9 @@
-export declare const protocolversion: "1.1.52";
+export declare const protocolversion: "1.1.54";
 /** Every reviewed action kind. Read kinds observe, interaction kinds move focus, sensitive kinds change page or browser state. */
-export type actionkind = "observe" | "inspect" | "extract" | "wait" | "waitfor" | "waittext" | "readattribute" | "readstyle" | "readgeometry" | "readvalue" | "readtext" | "readhtml" | "countelements" | "readtable" | "readlinks" | "readimages" | "readmeta" | "readforms" | "readstorage" | "highlight" | "tablist" | "windowlist" | "tabsnapshot" | "focus" | "scroll" | "hover" | "clickdeep" | "rightclick" | "doubleclick" | "scrollpage" | "scrollby" | "scrollend" | "scrolltop" | "fullscreen" | "zoomset" | "click" | "type" | "navigate" | "select" | "presskey" | "drag" | "drop" | "upload" | "clear" | "check" | "uncheck" | "toggle" | "submit" | "reload" | "back" | "forward" | "writestorage" | "setattribute" | "removeattribute" | "evaluate" | "tabcreate" | "tabactivate" | "tabclose" | "tabreload" | "windowcreate" | "windowclose" | "windowresize" | "downloadfile" | "movepointer" | "clickpoint" | "shiftclick" | "clicktext" | "clickaria" | "clickname" | "resolvexpath" | "typetime" | "appendtext" | "setvalue" | "typeedit" | "keyhold" | "keyrelease" | "submitsearch" | "selectmulti" | "chooseradio" | "setslider" | "setdate" | "setcolor" | "expanddetails" | "dismissdialog" | "pierceshadow" | "enterframe" | "retryaction" | "mapclicks" | "verifyvisible" | "verifyenabled" | "a11ytree" | "readvisible" | "readertree" | "detectlists" | "detecttables" | "readjson" | "watchmutate" | "waitquiet" | "watchbanner" | "detectinfinitescroll" | "detectvirtual" | "detectlazy" | "readscrollpos" | "readlang" | "readoutline" | "countpages" | "listshadow" | "listframes" | "classifypage" | "fingerprintsection" | "diffsnapshots" | "readselection" | "watchfocus" | "detectsticky" | "detectscrolllock" | "readopengraph" | "detectlanguage" | "deriveselector" | "openlink" | "openprivate" | "reloadcache" | "stopnav" | "waitload" | "waiturl" | "followlink" | "spanav" | "spawait" | "rewritequery" | "setfragment" | "navlist" | "navprofile" | "detecthttp" | "readredirects" | "readfinalurl" | "handleauth" | "printpdf" | "prefetch" | "preconnect" | "deeplink" | "reopentab" | "trailaudit" | "pausenav" | "navintent" | "navrate" | "openclipboard" | "checksafe" | "batchopen" | "querytabs" | "duplicatetab" | "closepattern" | "pintab" | "mutetab" | "movetab" | "movetabwindow" | "grouptabs" | "colorgroup" | "collapsegroup" | "discardtab" | "reloadtabs" | "zoomin" | "zoomout" | "watchtab" | "switchtab" | "maximizewindow" | "minimizewindow" | "restorewindow" | "focuswindow" | "scratchwindow" | "incognitowindow" | "restoretab" | "savelayout" | "restorelayout" | "findclones" | "searchtabs" | "badgetab" | "attachmeta" | "listaudio" | "reopenrun" | "snapshotsession" | "fillform" | "filllabel" | "fillplaceholder" | "detectfields" | "generatevalues" | "saveprofiles" | "asksubmit" | "submitform" | "readerrors" | "retryform" | "runwizard" | "selectchain" | "picktypeahead" | "pickdate" | "attachfile" | "handoffcaptcha" | "fillcard" | "fillcode" | "consentpassword" | "skiphoneypot" | "detectlogin" | "detecttemplate" | "scrapetable" | "exportcsv" | "exportjson" | "exportexcel" | "copytable" | "pushsheets" | "importcsv" | "looprows" | "transformvalues" | "deduperows" | "paginateextract" | "mergepages" | "stamplerows" | "previewgrid" | "streamdisk" | "resumeextract" | "logprovenance" | "batchdownload" | "pausedownload" | "resumedownload" | "verifydownload" | "interceptmime" | "exportnetlog" | "readclipboard" | "writeclipboard" | "copyscreen" | "quarantinedownload" | "scanvirus" | "namecaptures" | "cleanupartifacts" | "shotview" | "shotfullpage" | "shotelement" | "shotregion" | "contactsheet" | "capturepdf" | "recordscreen" | "captureaudio" | "captureframe" | "downloadimages" | "shotcanvas" | "probestream" | "readmedia" | "readassets" | "timelapse" | "convertimage" | "makethumbs" | "fetchurl" | "parsejson" | "parsehtml" | "callrest" | "callgraphql" | "opensocket" | "sendmessage" | "waitmessage" | "watchrequests" | "readheaders" | "capturebodies" | "subscribesse" | "longpoll" | "mapapi" | "extractapi" | "blockrequest" | "mockresponse" | "rewriteheaders" | "setcookies" | "readcookies" | "clearcookies" | "authflow" | "saveapikey" | "routeproxy" | "postform" | "postfiles" | "watchconsole" | "watcherrors" | "watchtasks" | "attachcdp" | "detachcdp" | "cdpcmd" | "watchcdp" | "setbreakpoint" | "stepcode" | "watchexpr" | "overridescript" | "measureflow" | "heapshot" | "trackmemory" | "profilecpu" | "watchshifts" | "traceload" | "annotatetrace" | "replaytrace" | "capturesourcemaps" | "emulatedevice" | "emulatenetwork" | "emulatelocate" | "setuseragent" | "overridepermission" | "blackboxscripts" | "persiststate" | "capturesession" | "restoresession" | "namedsessions" | "diffsessions" | "searchsessions" | "exportsessions" | "importsessions" | "composeworkflow" | "savetemplate" | "runworkflow" | "dryrun" | "delay" | "waitelement" | "compute" | "extractvars" | "condition" | "branch" | "loop" | "repeatuntil" | "whileloop" | "foreach" | "parallel" | "trycatch" | "visitrule" | "urlrule" | "menurule" | "keyrule" | "buttonrule" | "cronrule" | "intervalrule" | "urllistrule" | "webhookrule" | "eventrule";
+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";
+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";
 /** Observation mode classes: passive capture, watched lifetimes and diffing passes. */
 export type observationmode = "passive" | "watching" | "diffing";
 export interface toolstep {
@@ -178,6 +178,10 @@ export interface runsettings {
     triggerretention?: number;
     /** Retention window for stored workflow runlog entries; an absent window keeps every entry while the run summaries always survive for the audit trail. */
     runlogretention?: number;
+    /** Retention window for stored run history entries; an absent window keeps every entry of every execution. */
+    runhistoryretention?: number;
+    /** Watchdog configuration of the workflow editor: the stall threshold and the recovery action stay user configured values with no code ceiling. */
+    watchdog?: watchdogconfig;
 }
 export interface proposalrequest {
     objective: string;
@@ -2401,6 +2405,8 @@ export interface workflowrecord {
     blocks: workflowblock[];
     /** Derived review grade: a workflow that writes, submits or navigates is sensitive for review. */
     risk: actionrisk;
+    /** Review state of an imported workflow or a version rollback: pending stays unrunnable until the user approves the reviewed step list. */
+    reviewstate?: "pending" | "approved";
     createdat: number;
 }
 /** One workflow step: the action kind, the optional target and value, the reviewed JSON options, the output bindings and the human readable label. */
@@ -2419,6 +2425,10 @@ export interface workflowstep {
     extract?: regexrule;
     /** Innermost reusable block the step expanded from so runs highlight the active block during nested execution. */
     block?: string;
+    /** Breakpoint marker of editor debugging: a debug run pauses before this step. */
+    breakpoint?: boolean;
+    /** Nested parameters the enclosing block invocation binds into the block scope; expansion stamps them on the first step of the invocation region. */
+    params?: nestedparam[];
 }
 /** One reusable workflow block that nests child steps and further block invocations under a reusable name. */
 export interface workflowblock {
@@ -2431,6 +2441,8 @@ export interface workflowblock {
 export interface blockinvocation {
     block: string;
     label: string;
+    /** Nested parameters the invocation binds into the block scope before its first step runs. */
+    params?: nestedparam[];
 }
 /** One shareable step template: a named workflow step marked as shareable across workflows. */
 export interface steptemplate {
@@ -2511,6 +2523,10 @@ export interface workflowrun {
     pausedat?: number;
     cancelreason?: string;
     failreason?: string;
+    /** True when the run keeps executing in the service worker with no panel open; checkpoints restore it on every worker wake. */
+    background?: boolean;
+    /** Why the run paused: a user pause, a watchdog recovery or a browser interruption the startup hook marked. */
+    pausekind?: "user" | "watchdog" | "interrupt";
 }
 /** One runlog entry: the step id, its label, the state, the duration and the outcome details with the bindings produced and consumed. */
 export interface runlogentry {
@@ -2775,4 +2791,340 @@ export interface manualrun {
     decidedat?: number;
     at: number;
 }
+/** One canvas node of the workflow editor: the workflow step or the block invocation it renders with its canvas position. */
+export interface editornode {
+    /** The canvas node id: the step id, or the invocation id of a loaded block invocation which stays unique even when one block is invoked many times. */
+    id?: string;
+    /** The workflow step this node renders; absent on a block invocation node. */
+    step?: workflowstep;
+    /** The block invocation this node renders; absent on a plain step node. */
+    invocation?: blockinvocation;
+    x: number;
+    y: number;
+}
+/** One canvas edge of the workflow editor: a typed binding socket that links the output of one step into the input of a later step. */
+export interface editoredge {
+    from: string;
+    to: string;
+    variable: string;
+    kind: variablekind;
+    /** Dotted path into the source step outcome details; an absent path binds the summary. */
+    path?: string;
+}
+/** The layout state of the canvas: the canvas size, the viewport origin and the zoom factor. */
+export interface editorlayout {
+    width: number;
+    height: number;
+    viewportx: number;
+    viewporty: number;
+    zoom: number;
+}
+/** The mini map state: the mini canvas size, the projection scale from canvas coordinates and the viewport rectangle inside it. */
+export interface minimapstate {
+    width: number;
+    height: number;
+    /** Projection scale from canvas coordinates to mini map coordinates. */
+    scale: number;
+    zoom: number;
+    /** The viewport rectangle in mini map coordinates. */
+    viewport: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+/** The full canvas model the editor edits: the nodes, the typed edges, the block definitions, the layout, the mini map, the undo and redo stacks and the dirty marker. */
+export interface editormodel {
+    workflowid: string;
+    name: string;
+    version: number;
+    origins: string[];
+    nodes: editornode[];
+    edges: editoredge[];
+    blocks: workflowblock[];
+    layout: editorlayout;
+    minimap: minimapstate;
+    /** Undo snapshots, newest last; a snapshot never carries its own nested history. */
+    undo?: editormodel[];
+    /** Redo snapshots, newest last; a new edit clears them. */
+    redo?: editormodel[];
+    dirty: boolean;
+}
+/** The five categories of the block palette: actions, control flow, waits, variables and triggers. */
+export type palettecategory = "actions" | "controlflow" | "waits" | "variables" | "triggers";
+/** One palette descriptor of the block palette: the drop kind, its label, its category and its description. */
+export interface palettenode {
+    kind: string;
+    label: string;
+    category: palettecategory;
+    description: string;
+}
+/** One step library entry: the action kind, its palette category and its reviewed option schema. */
+export interface steplibraryentry {
+    kind: string;
+    category: palettecategory;
+    optionschema: Array<{
+        name: string;
+        kind: "string" | "number" | "boolean";
+        required?: boolean;
+    }>;
+}
+/** One local workflow version: the version number, its timestamp and the change note beside the step count and risk grade. */
+export interface workflowversion {
+    workflowid: string;
+    version: number;
+    createdat: number;
+    note: string;
+    steps: number;
+    risk?: actionrisk;
+    /** True when the version was created by rolling an older version back; the rollback review gates its first run. */
+    rollback?: boolean;
+}
+/** One version diff result: the added, removed and changed steps between two workflow versions. */
+export interface versiondiff {
+    workflowid: string;
+    from: number;
+    to: number;
+    added: Array<{
+        stepid: string;
+        kind: string;
+        label: string;
+    }>;
+    removed: Array<{
+        stepid: string;
+        kind: string;
+        label: string;
+    }>;
+    changed: Array<{
+        stepid: string;
+        kind: string;
+        label: string;
+        changes: string[];
+    }>;
+    at: number;
+}
+/** One run history entry: the outcome, the executed step count, the duration and the trigger cause of one execution. */
+export interface runhistoryentry {
+    runid: string;
+    workflowid: string;
+    outcome: string;
+    steps: number;
+    total: number;
+    duration: number;
+    cause: string;
+    startedat: number;
+    endedat: number;
+    dryrun?: boolean;
+}
+/** The export formats of a workflow file: json or yaml. */
+export type exportformat = "json" | "yaml";
+/** One exported workflow file: the file format version, the export time, the workflow record, the change note and the packed step templates. */
+export interface workflowfile {
+    format: 1;
+    exportedat: number;
+    workflow: workflowrecord;
+    note?: string;
+    templates: steptemplate[];
+}
+/** One nested parameter of a block invocation: the name, the variable kind and the default value bound into the block scope. */
+export interface nestedparam {
+    name: string;
+    kind: variablekind;
+    default?: string | number | boolean | string[];
+}
+/** One pending workflow import held for review: the parsed record stays unrunnable until the user approves it. */
+export interface workflowimport {
+    id: string;
+    record: workflowrecord;
+    importedat: number;
+    filename?: string;
+}
+/** One per site policy override of a workflow: the origin pattern and the reviewed policy knobs it adjusts. */
+export interface siteoverride {
+    id: string;
+    workflowid: string;
+    pattern: string;
+    deltas: Record<string, number>;
+    createdat: number;
+}
+/** The watchdog configuration: the stall threshold and the recovery action, both user configured values with no code ceiling. */
+export interface watchdogconfig {
+    enabled: boolean;
+    /** Milliseconds without a completed step after which a running run grades stalled. */
+    stallthreshold: number;
+    action: "retry" | "pause" | "cancel";
+    /** Window after which a running run with no live executor reaps as a zombie of a browser shutdown. */
+    zombiewindow?: number;
+}
+/** One watchdog event: the run it touched, the verdict and the recovery outcome. */
+export interface watchdogrecord {
+    id: string;
+    runid: string;
+    verdict: "stalled" | "zombie" | "healthy";
+    action: "retry" | "pause" | "cancel" | "reap" | "none";
+    outcome: string;
+    at: number;
+}
+/**
+ * Agent protocol contracts of the 1.1.54 family: the mcp tool catalog, json rpc frames, capability sets, client records, the stdio bridge and the server config.
+ * Every tool call lands behind the same consent gates that govern the panels, and no endpoint, provider or key is ever hardcoded — the protocol speaks to any client the user pairs.
+ */
+/** The tool namespaces of the mcp server: every tool name carries its domain prefix so clients address `browser.click`, `workflow.run`, `memory.audit` or `system.status` without collisions. */
+export type toolnamespace = "browser" | "workflow" | "memory" | "system";
+/** The transports an mcp client may ride: the stdio bridge for local client processes and the http listener for posted envelopes. */
+export type transportkind = "stdio" | "http";
+/** The lifecycle states of the mcp server: stopped by default, running once the user enables it, idle between paired client sessions. */
+export type serverstate = "stopped" | "running" | "idle";
+/** The json rpc error codes of the agent protocol: parse, method, params, internal and consentrefused map onto the classic json rpc numbers with consentrefused reserved for gate refusals. */
+export type rpcerrorcode = "parse" | "method" | "params" | "internal" | "consentrefused";
+/** One json rpc error payload: the code name, the human readable message and optional structured data. */
+export interface rpcerror {
+    code: rpcerrorcode;
+    message: string;
+    data?: unknown;
+}
+/** One json rpc frame: a request carries the id, method and params while a response carries the same id with either a result or an error; notifications omit the id. */
+export interface jsonrpcframe {
+    jsonrpc: "2.0";
+    id?: number | string | null;
+    method?: string;
+    params?: Record<string, unknown>;
+    result?: unknown;
+    error?: rpcerror;
+}
+/** One typed property of a tool input schema: the json schema type, the plain language description, the required flag and the reviewed default value. */
+export interface toolschemaproperty {
+    type: "string" | "number" | "boolean" | "object" | "array";
+    description: string;
+    required?: boolean;
+    /** Reviewed default value the server applies when a client omits the property. */
+    default?: string | number | boolean | Record<string, unknown>;
+}
+/** The json schema of one tool input: typed properties, the required property names and the default values the server applies when a client omits them. */
+export interface toolschema {
+    type: "object";
+    properties: Record<string, toolschemaproperty>;
+    required: string[];
+}
+/** The consent metadata of a sensitive tool: the plain language review requirement the panel renders before the tool may run. */
+export interface consentmeta {
+    review: string;
+}
+/** One mcp tool definition: the namespaced name, the version appended for compatibility checks, the description that states the consent class and side effects in plain language, the json schema of its inputs, the reviewed action kind it wraps, its risk grade and the consent metadata of tools with side effects. */
+export interface tooldef {
+    name: string;
+    version: number;
+    description: string;
+    inputschema: toolschema;
+    /** The reviewed action kind this tool wraps; policy validates it against the action kind grammar. */
+    kind: actionkind;
+    /** The risk grade of the wrapped action kind; policy re-derives it and refuses a mismatch. */
+    risk: actionrisk;
+    /** Consent metadata required on every tool with side effects. */
+    consentmeta?: consentmeta;
+}
+/** One tool domain of the catalog: the namespace that prefixes its tool names, the domain version and the tools it exposes. */
+export interface tooldomain {
+    namespace: toolnamespace;
+    version: number;
+    tools: tooldef[];
+}
+/** The mcp tool catalog: the catalog version and the four tool domains with their versions and consent metadata. */
+export interface toolcatalog {
+    version: number;
+    domains: tooldomain[];
+}
+/** One result of a tool call: the human readable content, the structured payload and the error flag that carries tool failures inside a successful json rpc result. */
+export interface toolresult {
+    content: string;
+    payload?: Record<string, unknown>;
+    iserror: boolean;
+}
+/** The capability set exchanged during negotiation: the protocol version, the server identity, the tool compatibility floor, the offered tool count, the namespaces and the allowed transports. */
+export interface capabilityset {
+    protocolversion: string;
+    name: string;
+    version: string;
+    /** Tool compatibility floor: tools with a version below the negotiated floor are refused. */
+    toolversion: number;
+    tools: number;
+    namespaces: toolnamespace[];
+    transports: transportkind[];
+}
+/** One connected mcp client: the id, the transport it rides, the negotiated capability set, the pairing state the user approves and the connection timestamps. */
+export interface clientrecord {
+    id: string;
+    transport: transportkind;
+    /** The capability set negotiated with this client. */
+    capabilities?: capabilityset;
+    /** True once the user approved the session for this client; unpaired clients never dispatch tools. */
+    paired: boolean;
+    connectedat: number;
+    /** Approval decision time of the pairing prompt. */
+    pairedat?: number;
+    lastseenat?: number;
+    disconnectedat?: number;
+}
+/** One entry of the mcp server routing table: the json rpc method name, the plain language description and the internal handler the server routes matching frames to. */
+export interface methodentry {
+    method: string;
+    handler: "initialize" | "ping" | "listtools" | "negotiate" | "dispatch";
+    description: string;
+}
+/** The user configured mcp server state: the bind address with localhost as the documented default, the port, the allowed transports, the user configured frame size and queue depth with no code ceiling, the explicit user enablement flag and the reviewed flag a remote bind requires. */
+export interface mcpserverconfig {
+    bind?: string;
+    port: number;
+    transports: transportkind[];
+    /** User configured maximum serialized frame size; an absent value never refuses a frame. */
+    framesize?: number;
+    /** User configured request queue depth per client; an absent value keeps the queue unbounded. */
+    queuedepth?: number;
+    /** User configured retention window for stored tool call records; an absent window keeps every record while the audit trail always survives. */
+    callretention?: number;
+    /** True once the user enabled the server; the server never starts without it. */
+    enabled: boolean;
+    /** True once the user reviewed the remote bind; a bind outside localhost is refused without it. */
+    remote?: boolean;
+}
+/** The persisted runtime state of the mcp server: the server state, the stdio bridge status and the last transition times. */
+export interface mcpserverstate {
+    state: serverstate;
+    /** The stdio bridge status while the server runs. */
+    bridge?: stdiobridge;
+    startedat?: number;
+    stoppedat?: number;
+}
+/** The stdio bridge of one local client process: the native messaging host name, the connection state, the process id, the restart counter and the frame counters of both relay directions. */
+export interface stdiobridge {
+    id: string;
+    host: string;
+    connected: boolean;
+    /** Process id of the launched client process. */
+    pid?: number;
+    startedat: number;
+    restarts: number;
+    received: number;
+    sent: number;
+    lastframeat?: number;
+}
+/** One stdio bridge launch event: the host manifest, the process id, the restart marker and the time. */
+export interface bridgelaunch {
+    id: string;
+    host: string;
+    pid: number;
+    restart: boolean;
+    at: number;
+}
+/** One mcp tool call record: the calling client, the namespaced tool name, the origin the call ran under, the outcome flag, the json rpc error code when the call was refused and the time. */
+export interface toolcallrecord {
+    id: string;
+    clientid: string;
+    tool: string;
+    origin: string;
+    ok: boolean;
+    code?: rpcerrorcode;
+    at: number;
+}
 //# sourceMappingURL=types.d.ts.map