@wenathlan/extension 1.1.56 → 1.1.58

package/dist/taskqueue.d.ts

@@ -0,0 +1,97 @@
+import type { taskitem, taskqueue } from "./types.js";
+/**
+ * Shared task queue logic of the 1.1.58 multi agent family.
+ * Every correlated rule for lanes, priorities, claims, work stealing with lane ownership, completion, heartbeats and the requeue of orphaned tasks lives in this file.
+ * The queue never executes anything: a claimed task only names the work whose proposal still passes the same human review every single agent proposal passes.
+ */
+/** One lane ownership rule the user configures: the lane name and the roles allowed to steal from it; a lane without a rule stays open to every agent of the approved swarm. */
+export interface laneownership {
+    lane: string;
+    roles: string[];
+}
+/** Builds one empty queue with the user configured lanes, priority scale and completion policy; the empty set of lanes accepts any lane name the user enqueues. */
+export declare function emptyqueue(input?: {
+    lanes?: string[];
+    priorities?: number[];
+    completionpolicy?: "all" | "any";
+}): taskqueue;
+/** Enqueues one task item into a lane with its priority; a configured lane list refuses unknown lanes and the payload stays the plain language text the user typed. */
+export declare function enqueue(input: {
+    queue: taskqueue;
+    id: string;
+    lane: string;
+    priority: number;
+    payload: string;
+    now: number;
+}): taskqueue;
+/** Lets one agent claim the highest priority queued task; the claim carries the heartbeat time that keeps it alive and an agent holds one task at a time. */
+export declare function claim(input: {
+    queue: taskqueue;
+    agentid: string;
+    now: number;
+}): {
+    queue: taskqueue;
+    task?: taskitem;
+};
+/** Lets one idle agent steal a queued task from a named lane; the lane ownership rules the user configures refuse agents whose role holds no grant for the lane. */
+export declare function steal(input: {
+    queue: taskqueue;
+    agentid: string;
+    role: string;
+    fromlane: string;
+    ownership?: laneownership[];
+    now: number;
+}): {
+    queue: taskqueue;
+    task?: taskitem;
+};
+/** Marks one task done and releases the claim of the agent that held it. */
+export declare function complete(input: {
+    queue: taskqueue;
+    taskid: string;
+    now: number;
+}): taskqueue;
+/** Cancels one queued or claimed task; the cancelled task releases its claim and leaves the queue. */
+export declare function canceltask(input: {
+    queue: taskqueue;
+    taskid: string;
+    now: number;
+}): taskqueue;
+/** Refreshes the heartbeats of every live claim of one agent so a working agent keeps its tasks. */
+export declare function claimheartbeat(input: {
+    queue: taskqueue;
+    agentid: string;
+    now: number;
+}): taskqueue;
+/** Returns the orphaned tasks to their lane: a claim whose heartbeat stayed silent past the user configured expiry window releases and the task waits as queued again; an absent window never expires a claim. */
+export declare function requeue(input: {
+    queue: taskqueue;
+    now: number;
+    window?: number;
+}): {
+    queue: taskqueue;
+    requeued: string[];
+};
+/** Reports every lane with its queued, claimed, done and cancelled task counts and the live claims, so the queue view reads the lanes at a glance. */
+export declare function lanereport(queue: taskqueue): Array<{
+    lane: string;
+    queued: number;
+    claimed: number;
+    done: number;
+    cancelled: number;
+    claims: Array<{
+        agentid: string;
+        taskid: string;
+        heartbeatat: number;
+    }>;
+}>;
+/** Evaluates the completion policy of the queue: all completes only when every task is done while any completes with the first done task. */
+export declare function queuecomplete(queue: taskqueue): boolean;
+/** Counts the tasks by claim state for the popup gauge: the claimed tasks are the active work of the swarm. */
+export declare function taskcounts(queue: taskqueue): {
+    queued: number;
+    claimed: number;
+    done: number;
+    cancelled: number;
+};
+//# sourceMappingURL=taskqueue.d.ts.map

package/dist/taskqueue.d.ts.map

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

package/dist/types.d.ts

@@ -1,9 +1,9 @@
-export declare const protocolversion: "1.1.56";
+export declare const protocolversion: "1.1.58";
 /** 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" | "swarm";
 /** Observation mode classes: passive capture, watched lifetimes and diffing passes. */
 export type observationmode = "passive" | "watching" | "diffing";
 export interface toolstep {
@@ -182,6 +182,12 @@ export interface runsettings {
     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;
+    /** User configured ceiling on sub agent recursion depth of the swarm; an absent value stays unbounded because the cap stays a user choice only. */
+    swarmdepth?: number;
+    /** User configured claim expiry window in milliseconds: a queue claim whose heartbeat stays silent past the window releases and its task requeues; an absent window never expires a claim. */
+    claimwindow?: number;
+    /** Retention window for stored agent mailbox messages; an absent window keeps every message while the unread counters always survive. */
+    mailboxretention?: number;
 }
 export interface proposalrequest {
     objective: string;
@@ -3468,4 +3474,371 @@ export interface callcontext {
     /** 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;
+}
+/**
+ * Multi agent part one contracts of the 1.1.58 family: agent identities bound to tabs with user named roles, the shared task queue with lanes, priorities, claims and work stealing, agent mailboxes with direct, broadcast and role addressed routing, the blackboard shared memory with its sections and entry kinds, per agent budgets and permission scopes, sub agent spawn requests with depth limits and the killswitch that halts every agent at once.
+ * Every value here stays a user choice: the agent count, the role names, the lane names, the priority scale, the freshness windows and the depth ceilings carry no code default and no hardcoded cap, and every agent proposal still passes the same human review the single agent passed.
+ */
+/** The lifecycle states of one agent of the swarm: active, paused by the user or stopped. */
+export type agentstate = "active" | "paused" | "stopped";
+/** The role an agent plays. The three internal roles carry their documented defaults while the user may attach any custom role name; a custom role grades with the worker defaults until the user narrows its scope. */
+export type agentrole = "planner" | "worker" | "observer" | (string & {});
+/** One agent identity of the swarm: the id, the user chosen name for dashboards and audit, the role, the bound tab and session, the parent of a sub agent with its depth, the lifecycle state and the per agent budget and scope the user configured. */
+export interface agentidentity {
+    id: string;
+    /** User chosen display name; the naming stays a user choice so dashboards and audit read the names the user typed. */
+    name: string;
+    role: agentrole;
+    /** The tab this agent is bound to; one tab holds at most one agent. */
+    tabid?: number;
+    /** The session the bound tab runs under when one is active. */
+    sessionid?: string;
+    /** The parent agent id of a sub agent; a root agent carries none. */
+    parentid?: string;
+    /** The recursion depth of this agent; root agents sit at zero and every spawn adds one. */
+    depth: number;
+    state: agentstate;
+    /** Per agent budget ceilings the user configured; absent ceilings stay unbounded. */
+    budget?: agentbudget;
+    /** Per agent permission scope; absent scope fields stay unbounded inside the session grants. */
+    scope?: agentscope;
+    /** Free form metadata the user attached for dashboards and audit. */
+    metadata?: Record<string, unknown>;
+    registeredat: number;
+    heartbeatat?: number;
+}
+/** The claim states of one task item: queued waits for a claim, claimed runs under one agent, done completed and cancelled left the queue. */
+export type taskstatekind = "queued" | "claimed" | "done" | "cancelled";
+/** One task of the shared queue: the id, the lane it waits in, the user configured priority, the payload in plain language and the claim state. */
+export interface taskitem {
+    id: string;
+    lane: string;
+    /** User configured priority; a higher number runs first inside the lane. */
+    priority: number;
+    /** The task payload in plain language; the review reads it exactly as typed. */
+    payload: string;
+    state: taskstatekind;
+    enqueuedat: number;
+}
+/** One claim of a task by an agent: the agent id, the task id and the heartbeat time that keeps the claim alive. */
+export interface claimrecord {
+    agentid: string;
+    taskid: string;
+    claimedat: number;
+    heartbeatat: number;
+}
+/** The completion policy of a queue: all requires every task to complete while any completes with the first finished task. */
+export type queuecompletionpolicy = "all" | "any";
+/** The shared task queue of the swarm: the user configured lane names, the user configured priority scale, the completion policy, the task items and the live claims. */
+export interface taskqueue {
+    /** Lane names the user configures; work stealing may cross lanes inside one approved swarm. */
+    lanes: string[];
+    /** The priority values the user configures; the scale itself stays a user choice. */
+    priorities: number[];
+    completionpolicy: queuecompletionpolicy;
+    items: taskitem[];
+    claims: claimrecord[];
+}
+/** The routing kinds of one agent message: direct to one agent, broadcast to every agent or addressed to a role. */
+export type messagerouting = "direct" | "broadcast" | "role";
+/** One message between agents: the sender id, the recipient (an agent id, the broadcast marker or a role name), the routing kind, the payload and the read tracking. */
+export interface agentmessage {
+    id: string;
+    senderid: string;
+    /** The agent id of a direct message, the role name of a role addressed message or the broadcast marker `*`. */
+    recipient: string;
+    routing: messagerouting;
+    payload: string;
+    sentat: number;
+    readat?: number;
+}
+/** One agent mailbox: the inbox of received messages, the outbox of sent messages and the unread count. */
+export interface agentmailbox {
+    agentid: string;
+    inbox: agentmessage[];
+    outbox: agentmessage[];
+    unread: number;
+}
+/** The blackboard sections the swarm shares: goals, facts, findings and scratch. */
+export type blackboardsection = "goals" | "facts" | "findings" | "scratch";
+/** The value kinds of one blackboard entry: plain text or a json payload. */
+export type blackboardvaluekind = "text" | "json";
+/** One blackboard entry: the key, the value kind and value, the author agent id or the user marker, the section, the consent class inherited from the source extraction and the retirement time. */
+export interface blackboardentry {
+    id: string;
+    key: string;
+    valuekind: blackboardvaluekind;
+    value: string;
+    /** The author agent id or `user` for entries the human posted. */
+    author: string;
+    section: blackboardsection;
+    /** The consent class of the source extraction this entry carries; every reader sees the class. */
+    consentclass: actionrisk;
+    postedat: number;
+    retiredat?: number;
+}
+/** The blackboard shared memory of one swarm: the sections in use, every entry and the user configured retirement window; an absent window keeps every entry. */
+export interface blackboard {
+    sections: blackboardsection[];
+    entries: blackboardentry[];
+    /** User configured freshness window in milliseconds; entries older than the window retire on the pass. */
+    retirementwindow?: number;
+}
+/** One per agent budget: the token, cost and step ceilings the user configured; every ceiling is a user choice and an absent ceiling stays unbounded. */
+export interface agentbudget {
+    agentid: string;
+    maxtokens?: number;
+    maxcost?: number;
+    /** Ceiling on executed steps; an absent value never refuses a step. */
+    maxsteps?: number;
+    currency?: string;
+    configuredat: number;
+}
+/** One per agent permission scope: the origins and the tool namespaces granted to the agent; the grants stay inside the session grant list. */
+export interface agentscope {
+    agentid: string;
+    origins: string[];
+    toolnamespaces: toolnamespace[];
+}
+/** One spawn request of a sub agent: the parent id, the requested role, the task in plain language and the depth of the child. */
+export interface spawnrequest {
+    parentid: string;
+    role: agentrole;
+    task: string;
+    depth: number;
+}
+/** The depth limit of sub agent recursion the user configures; the killswitch and the refusal message read it exactly. */
+export interface depthlimit {
+    /** User configured ceiling on sub agent recursion depth; an absent limit stays unbounded. */
+    maxdepth?: number;
+}
+/** The killswitch state: engaged halts every agent of the swarm at once; the switch stays available with no configuration barrier. */
+export interface killswitch {
+    engaged: boolean;
+    engagedat?: number;
+    reason?: string;
+}
+/** One recorded spawn of a sub agent with its depth for the audit history. */
+export interface spawnrecord {
+    id: string;
+    parentid: string;
+    childid: string;
+    role: agentrole;
+    depth: number;
+    at: number;
+}
+/** The per agent usage counters held against the agent budget: the accumulated tokens, cost and executed steps. */
+export interface agentusage {
+    agentid: string;
+    tokens: number;
+    cost: number;
+    steps: number;
+    updatedat: number;
+}
+/** The lifecycle event kinds of the swarm: registration, role assignment, tab binding, spawn, pause, resume, stop, the killswitch, the queue events, the mailbox delivery and the blackboard writes. */
+export type agenteventkind = "register" | "assign" | "bind" | "spawn" | "pause" | "resume" | "stop" | "killall" | "enqueued" | "claimed" | "stole" | "completed" | "requeued" | "cancelled" | "delivered" | "posted" | "retired";
+/** One agent lifecycle event notification: the event kind, the agent and task it names, the summary in plain language and the time. */
+export interface agentevent {
+    id: string;
+    kind: agenteventkind;
+    agentid?: string;
+    taskid?: string;
+    summary: string;
+    at: number;
+}
+/** One swarm state snapshot: every agent identity, the shared task queue with its items and claims, every mailbox and the killswitch state. */
+export interface swarmstate {
+    agents: agentidentity[];
+    queue: taskqueue;
+    mailboxes: agentmailbox[];
+    killswitch: killswitch;
+}
 //# sourceMappingURL=types.d.ts.map