@wenathlan/extension 1.1.55 → 1.1.57

package/dist/types.d.ts

@@ -1,9 +1,9 @@
-export declare const protocolversion: "1.1.55";
+export declare const protocolversion: "1.1.57";
 /** 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";
+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";
 /** Observation mode classes: passive capture, watched lifetimes and diffing passes. */
 export type observationmode = "passive" | "watching" | "diffing";
 export interface toolstep {
@@ -3047,7 +3047,7 @@ export interface toolresult {
     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. */
+/** 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; the 1.1.56 family adds the client declared model capabilities of sampling, prompt rendering and streaming. */
 export interface capabilityset {
     protocolversion: string;
     name: string;
@@ -3057,6 +3057,12 @@ export interface capabilityset {
     tools: number;
     namespaces: toolnamespace[];
     transports: transportkind[];
+    /** True when the client model accepts sampling callbacks. */
+    sampling?: boolean;
+    /** True when the client renders prompt tools. */
+    prompts?: boolean;
+    /** True when the client consumes streamed result chunks. */
+    streaming?: boolean;
 }
 /** 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 {
@@ -3079,7 +3085,7 @@ export interface clientrecord {
 /** 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";
+    handler: "initialize" | "ping" | "listtools" | "negotiate" | "dispatch" | "listprompts" | "callprompt" | "cancel";
     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. */
@@ -3133,7 +3139,7 @@ export interface bridgelaunch {
     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. */
+/** 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; the 1.1.56 family adds the call id, the idempotency key, the dry run, mock and batch markers and the replay marker so the audit trail names every call without exception. */
 export interface toolcallrecord {
     id: string;
     clientid: string;
@@ -3142,6 +3148,18 @@ export interface toolcallrecord {
     ok: boolean;
     code?: rpcerrorcode;
     at: number;
+    /** The call context id of the 1.1.56 family when the call ran through the call runtime. */
+    callid?: string;
+    /** The idempotency key the client attached; a repeated key replays the stored result. */
+    idempotencykey?: idempotencykey;
+    /** True when the call ran as a tool dry run with no side effects. */
+    dryrun?: boolean;
+    /** True when a tool mock answered the call without touching the browser. */
+    mocked?: boolean;
+    /** The batch call id when the call ran as a batch member. */
+    batchid?: string;
+    /** True when the answer replayed a stored idempotent result instead of executing. */
+    replayed?: boolean;
 }
 /**
  * Agent protocol part two contracts of the 1.1.55 family: the http stream transport with tls, session tokens, pairing codes, client allowlists, approval gates and the auth handshake for remote clients.
@@ -3274,4 +3292,369 @@ export interface streamchannel {
     lasteventat?: number;
     closedat?: number;
 }
+/**
+ * Agent protocol part three contracts of the 1.1.56 family: event subscriptions, resource watchers, sampling callbacks, prompt tools, streaming chunks, progress notices, in flight cancellation, per client rate limits, structured errors with retry hints, idempotency keys, batch calls, tool dry runs, tool mocks and the call contexts that isolate concurrent clients.
+ * Every frame still passes the same consent gates — the protocol layer never bypasses review — and every window, budget and ceiling stays a user choice with no code ceiling and no hardcoded endpoint, provider or key.
+ */
+/** The protocol event kinds a client may subscribe to: callstarted mirrors every tool call including calls with side effects while the rest stay observation kinds. */
+export type eventkind = "callstarted" | "callresult" | "streamchunk" | "progress" | "resourcedelta" | "sampling" | "cancellation";
+/** One event subscription of a paired client: the event kinds it listens to, the optional origin and tool filters that narrow delivery and the lifecycle times. */
+export interface protocoleventsubscription {
+    id: string;
+    clientid: string;
+    kinds: eventkind[];
+    /** Optional origin filter: only events of this origin reach the subscriber. */
+    origin?: string;
+    /** Optional tool name filter: only events of this namespaced tool reach the subscriber. */
+    tool?: string;
+    createdat: number;
+    lastdeliveredat?: number;
+    canceledat?: number;
+}
+/** One resource watcher of a paired client: the watched page state resource, the page state baseline at watch time and the lifecycle times. */
+export interface resourcewatch {
+    id: string;
+    clientid: string;
+    /** The watched resource name of the page state, for example the page snapshot resource of the session tab. */
+    resource: string;
+    /** The page state baseline captured at watch time; deltas compare against it. */
+    baseline: Record<string, unknown>;
+    createdat: number;
+    lastdeliveredat?: number;
+    canceledat?: number;
+}
+/** One sampling callback to a client model: the prompt that leaves the browser, the optional system text, the page content the user granted, the lifecycle state and the provenance times. */
+export interface samplingrequest {
+    id: string;
+    clientid: string;
+    prompt: string;
+    system?: string;
+    /** Page content the user granted for this callback; stripped before the prompt leaves when the user granted none. */
+    pagecontent?: string;
+    /** User granted maximum tokens of the callback completion; an absent value leaves the size to the client. */
+    maxtokens?: number;
+    state: "pending" | "answered" | "refused";
+    requestedat: number;
+    answeredat?: number;
+    /** The client answer once it arrives; the provenance records the client and the times. */
+    answer?: string;
+}
+/** One prompt def exposed as a callable tool: the prompt name, the plain language description, the declared arguments and the render template. */
+export interface promptdef {
+    name: string;
+    description: string;
+    /** Declared arguments of the prompt with their descriptions, required markers and reviewed defaults. */
+    arguments: Array<{
+        name: string;
+        description: string;
+        required?: boolean;
+        default?: string;
+    }>;
+    /** The render template; every double braced argument placeholder substitutes its value. */
+    template: string;
+}
+/** One stream chunk of a progressive tool result: the call it belongs to, the sequence number, the content slice, the done marker and the time. */
+export interface streamchunk {
+    callid: string;
+    seq: number;
+    content: string;
+    done: boolean;
+    at: number;
+}
+/** One progress notice of a long tool call: the call it belongs to, the optional percent, the plain language message, the cancellable hint and the time. */
+export interface progressnotice {
+    callid: string;
+    percent?: number;
+    message: string;
+    /** True when the user may cancel the in flight call. */
+    cancellable: boolean;
+    at: number;
+}
+/** One cancellation frame that aborts an in flight tool call: the call id, the reason in plain language and the time. */
+export interface cancelframe {
+    callid: string;
+    reason?: string;
+    at: number;
+}
+/** One per client rate limit of tool calls: the counting window, the user configured call budget inside it and the live counters; an absent budget keeps the client unbounded. */
+export interface callratelimit {
+    clientid: string;
+    windowms: number;
+    /** User configured call budget per window; an absent value documents the unbounded choice instead of a silent default. */
+    budget?: number;
+    windowstartedat: number;
+    used: number;
+}
+/** The retry hints of a structured error: retry marks retryable failures, wait marks busy windows with their retry after and none marks consent refusals that never retry. */
+export type retryhint = "retry" | "wait" | "none";
+/** One structured error answer of a tool call: the error code, the message in plain language, the retry hint and the optional retry after window. */
+export interface structurederror {
+    code: string;
+    message: string;
+    retryhint: retryhint;
+    retryafter?: number;
+}
+/** The idempotency key of a tool call: the client chosen key that replays the stored result for a repeated call. */
+export type idempotencykey = string;
+/** One stored idempotency record: the key, the calling client, the tool, the stored result for replay and the expiry of the user configured window. */
+export interface idempotencyrecord {
+    key: idempotencykey;
+    clientid: string;
+    tool: string;
+    result: toolresult;
+    createdat: number;
+    expiresat: number;
+}
+/** One member of a batch call: the member id, the namespaced tool name and the call arguments. */
+export interface batchmember {
+    id: string;
+    name: string;
+    params: Record<string, unknown>;
+}
+/** One batch call of a paired client: the ordered tool calls, the stop on first error flag, the per call outcomes and the lifecycle times. */
+export interface batchcall {
+    id: string;
+    clientid: string;
+    calls: batchmember[];
+    stoponerror: boolean;
+    state: "pending" | "running" | "done" | "stopped";
+    createdat: number;
+    finishedat?: number;
+    outcomes: batchoutcome[];
+}
+/** One outcome of a batch member: the member id, the tool, the outcome flag, the result or the structured error and the time. */
+export interface batchoutcome {
+    callid: string;
+    tool: string;
+    ok: boolean;
+    result?: toolresult;
+    error?: structurederror;
+    at: number;
+}
+/** One tool dry run result: the tool, the argument validation findings, the consent evaluation, the executed marker that stays false and the mutation list that stays empty. */
+export interface tooldryrun {
+    callid: string;
+    tool: string;
+    argsvalid: boolean;
+    consentok: boolean;
+    findings: string[];
+    /** A dry run never executes anything; the purity gate refuses any record that claims otherwise. */
+    executed: boolean;
+    /** A dry run leaves no page mutation; the purity gate refuses any record that claims one. */
+    mutations: string[];
+    at: number;
+}
+/** One tool mock for client testing: the namespaced tool it stands in for, the canned result it returns, the test context flag and the creation time. */
+export interface toolmock {
+    tool: string;
+    result: toolresult;
+    /** True only in test contexts; policy refuses mocks outside them. */
+    testcontext: boolean;
+    createdat: number;
+}
+/** One call context that isolates concurrent client state: the call id, the client, the tool, the lifecycle state, the idempotency key, the dry run and batch markers, the chunk counter and the partial result a cancellation preserves. */
+export interface callcontext {
+    callid: string;
+    clientid: string;
+    tool: string;
+    state: "inflight" | "done" | "cancelled" | "failed";
+    startedat: number;
+    endedat?: number;
+    idempotencykey?: idempotencykey;
+    dryrun?: boolean;
+    batchid?: string;
+    chunks: number;
+    errorcode?: string;
+    /** The partial result preserved when a cancellation aborts the call in flight. */
+    partial?: toolresult;
+}
+/**
+ * Llm integration contracts of the 1.1.57 family: provider configs with endpoint url, auth reference and model list, model routes that map task kinds to provider models, local model endpoints, openapi style tool briefs, natural language command parsing with intents, model drafted plans with replans and reflection, cost budgets with usage records, the prompt template library and the parse guardrails that keep model output honest.
+ * Nothing here hardcodes a provider, an endpoint, a model or a key: every gateway url, base url, model name and parameter is a user configured value, the protocol styles are wire shapes the user picks for interoperability, api keys live behind storage id references and every model drafted plan still passes the same human review the local plans pass.
+ */
+/** The protocol request shapes a user may pick for a provider endpoint: the openai compatible chat completions shape, the openai responses shape, the anthropic messages shape and the google gemini shape. These are wire shapes for interoperability, never provider names, and any gateway speaking one of them works. */
+export type protocolstyle = "chatcompletions" | "responses" | "messages" | "gemini";
+/** One message of a model conversation: the system, user or assistant role with its content. */
+export interface modelmessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+/** One user configured provider of model completions: the endpoint url the user typed, the protocol shape it speaks, the model list the user maintains, the api key reference (never the key material), the extra headers the user reviewed and the availability status of the last test call. */
+export interface providerconfig {
+    id: string;
+    name: string;
+    /** The user configured endpoint url; no default and no built-in provider endpoint ever applies. */
+    endpoint: string;
+    style: protocolstyle;
+    /** The user configured model list; every entry is a free text model name. */
+    models: string[];
+    /** Reference to the stored api key record; the key material lives in the browser credential store behind its storage id, never in memory files or audit trails. */
+    authref?: apikeyref;
+    /** Extra headers the user reviewed for gateways that need them; merged over the protocol shape headers. */
+    headers?: Record<string, string>;
+    status: "available" | "unavailable";
+    lastcheckedat?: number;
+    /** Optional user configured price per million tokens and its currency unit for the cost accounting of the usage records; absent pricing keeps the recorded cost at zero. */
+    costpermilliontokens?: number;
+    currency?: string;
+    createdat: number;
+}
+/** One model route entry: the task kind it routes, the provider and model it prefers and the user configured fallback pair for refusals and outages; the revision history tracks every change. */
+export interface modelroute {
+    id: string;
+    /** The task kind of the route: the internal kinds parsecommand, classifyintent, draftplan, replan, reflect and summarize plus any user defined task kind. */
+    kind: string;
+    providerid: string;
+    model: string;
+    fallbackproviderid?: string;
+    fallbackmodel?: string;
+    revision: number;
+    updatedat: number;
+}
+/** One browser reachable local model endpoint: the endpoint url, the model name, the protocol shape and the optional key reference of gateways that ask one; the health block carries the last check. */
+export interface localmodelconfig {
+    endpoint: string;
+    model: string;
+    style: protocolstyle;
+    authref?: apikeyref;
+    health?: {
+        checkedat: number;
+        ok: boolean;
+        detail?: string;
+    };
+}
+/** One openapi style tool brief for model consumption: the tool name, the summary, the description, the risk class and the typed parameter list. */
+export interface toolbrief {
+    tool: string;
+    summary: string;
+    description: string;
+    risk: string;
+    parameters: Array<{
+        name: string;
+        type: string;
+        description: string;
+        required: boolean;
+    }>;
+}
+/** The intent kinds a natural language command may carry: navigate, extract, fill, monitor, automate and ask. */
+export type intentkind = "navigate" | "extract" | "fill" | "monitor" | "automate" | "ask";
+/** One entity of a parsed command: the entity name and its value. */
+export interface commandentity {
+    name: string;
+    value: string;
+}
+/** One parsed natural language command: the source text, the classified intent, the extracted entities, the confidence between zero and one, the model that parsed it and the parse time. */
+export interface commandparse {
+    text: string;
+    intent: intentkind;
+    entities: commandentity[];
+    confidence: number;
+    model?: string;
+    providerid?: string;
+    parsedat: number;
+}
+/** One model drafted step: the action kind, the optional target and value, the summary and the fresh review marker a replan sets on revised steps. */
+export interface draftstep {
+    id: string;
+    kind: string;
+    target?: string;
+    value?: string;
+    summary: string;
+    /** True on the revised steps of a replan; every marked step needs the fresh human review before it executes. */
+    freshreview?: boolean;
+}
+/** One model drafted plan: the goal, the drafted steps, the open questions the model could not resolve, the lint findings of the grammar check, the model provenance and the review state. A draft never executes until the human review approves it and the plan review approves the plan it produces. */
+export interface plandraft {
+    id: string;
+    goal: string;
+    steps: draftstep[];
+    openquestions: string[];
+    providerid: string;
+    model: string;
+    state: "draft" | "approved" | "rejected";
+    lintfindings: string[];
+    createdat: number;
+}
+/** One replan record of a failed run: the draft it revises, the completed steps it keeps, the failed steps it replaces, the revised tail that needs fresh review, the failure reason and the model provenance. */
+export interface replanrecord {
+    id: string;
+    draftid: string;
+    completedstepids: string[];
+    failedstepids: string[];
+    tail: draftstep[];
+    reason: string;
+    providerid: string;
+    model: string;
+    state: "pending" | "approved" | "rejected";
+    createdat: number;
+}
+/** One reflection note of an executed step: the step outcome, the lesson learned, the advice for the next step and the model provenance; the running lessons feed the next prompt. */
+export interface reflectnote {
+    id: string;
+    runid: string;
+    stepid: string;
+    outcome: string;
+    lesson: string;
+    advice: string;
+    providerid: string;
+    model: string;
+    createdat: number;
+}
+/** One cost budget of a run: the optional token ceiling, the optional currency ceiling with its currency and the configuration time; every ceiling is a user choice and an absent ceiling stays unbounded. */
+export interface costbudget {
+    runid?: string;
+    maxtokens?: number;
+    maxcost?: number;
+    currency?: string;
+    configuredat: number;
+}
+/** One usage record of a model call: the run and step it belongs to, the provider, the endpoint and the model called, the prompt, completion and total token counts, the cost in the user configured currency and the local marker. */
+export interface usagerecord {
+    id: string;
+    runid?: string;
+    stepid?: string;
+    providerid: string;
+    endpoint: string;
+    model: string;
+    prompttokens: number;
+    completiontokens: number;
+    totaltokens: number;
+    cost: number;
+    /** True when the call went to the local model endpoint. */
+    local?: boolean;
+    at: number;
+}
+/** One prompt template of the library: the name, the body with double braced variables, the declared variable list, the version and the change notes of the version. */
+export interface prompttemplate {
+    id: string;
+    name: string;
+    body: string;
+    variables: string[];
+    version: number;
+    notes?: string;
+    createdat: number;
+}
+/** One parse guard of model output: the expected schema of the parsed payload, the retry count before refusal and the refusal markers the user reviews. */
+export interface parseguard {
+    schema: Record<string, {
+        type: "string" | "number" | "boolean" | "object" | "array";
+        required?: boolean;
+    }>;
+    retries: number;
+    refusalmarkers?: string[];
+}
+/** One model output after the guardrails: the raw text, the parsed payload when it validated, the guard verdict of valid, invalid or refused, the verdict reason and the attempt count. */
+export interface modeloutput {
+    raw: string;
+    parsed?: Record<string, unknown>;
+    verdict: "valid" | "invalid" | "refused";
+    reason?: string;
+    attempts: number;
+}
+/** One token of a streamed model answer: the sequence number, the token text and the done marker. */
+export interface tokenstream {
+    seq: number;
+    text: string;
+    done: boolean;
+}
 //# sourceMappingURL=types.d.ts.map