@wenathlan/extension 1.1.57 → 1.1.59

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.57";
+export declare const protocolversion: "1.1.59";
 /** 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";
+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,20 @@ 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;
+    /** User configured consensus quorum of the swarm: the number of yes votes a consensus round needs to carry; an absent value leaves the quorum to the round the user opens. */
+    swarmquorum?: number;
+    /** User configured ceiling on the worker lane of the leader worker topology; an absent value stays unbounded because the worker scale stays a user choice with no engine cap. */
+    swarmworkers?: number;
+    /** Retention window for stored progressboard snapshots; an absent window keeps every snapshot while the board itself always rebuilds from the live swarm state. */
+    boardretention?: number;
+    /** The verification methods the user allows the verifier agents to use; an empty or absent list keeps every method open as the documented user choice. */
+    verifiermethods?: string[];
 }
 export interface proposalrequest {
     objective: string;
@@ -3657,4 +3671,448 @@ export interface tokenstream {
     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 five 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" | "critic" | "verifier" | (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;
+}
+/**
+ * Multi agent part two contracts of the 1.1.59 family: the leader worker topology with worker assignments, critic reviews and verifier checks over agent outputs, the planner executor split, tab handoffs between agents mid run, resource locks keyed by origin and selector with conflict scans, result merging with provenance into one report, the progressboard layout, review requests between agents, escalations that lift an agent decision to the user, arbitration rules that order competing resource claims and consensus rounds with quorum.
+ * Every value here stays a user choice: the election rule, the worker scale bound, the quorum, the lock kinds and the merge rules carry no code default, and coordination never bypasses the human review.
+ */
+/** The verdict of one critic review: approve passes the output, changes demands the listed rework and reject refuses the output. */
+export type reviewverdict = "approve" | "changes" | "reject";
+/** The leader worker topology of one swarm: the leader agent id, the worker, critic and verifier lanes and every worker assignment; the rule names how the leader was elected. */
+export interface leaderworker {
+    id: string;
+    leaderid: string;
+    workerids: string[];
+    criticids: string[];
+    verifierids: string[];
+    assignments: workerassignment[];
+    /** The user configured election rule that picked the leader: `first` takes the first registration while `named` takes the agent the user named. */
+    rule: {
+        kind: "first" | "named";
+        agentid?: string;
+    };
+    electedat: number;
+}
+/** One assignment linking a worker to a task slice: the worker id, the task id, the slice description in plain language and the assignment time. */
+export interface workerassignment {
+    workerid: string;
+    taskid: string;
+    /** The slice of the task this worker owns, in plain language; the review reads it exactly as typed. */
+    slice: string;
+    assignedat: number;
+}
+/** One critic review of an agent output: the critic agent, the reviewed agent and task, the verdict, the issues found and the changes the output requires. */
+export interface criticreview {
+    id: string;
+    reviewerid: string;
+    subjectagentid: string;
+    taskid?: string;
+    verdict: reviewverdict;
+    issues: string[];
+    requiredchanges: string[];
+    reviewedat: number;
+}
+/** The outcome of one verifier check: pass confirms the claim against the page while fail refutes it. */
+export type verifieroutcome = "pass" | "fail";
+/** One verifier check of a result claim: the verifier agent, the agent whose claim is checked, the claim in plain language, the method the verifier used and the pass or fail outcome with its evidence. */
+export interface verifiercheck {
+    id: string;
+    verifierid: string;
+    claimagentid: string;
+    taskid?: string;
+    claim: string;
+    /** The verification method the verifier used, named by the user; the method grade reads it. */
+    method: string;
+    outcome: verifieroutcome;
+    evidence?: string;
+    checkedat: number;
+}
+/** The planner executor split of one task: the plan owner agent drafts while the run owner agent executes, and the executor reports every step outcome back to the planner. */
+export interface plannerexecutor {
+    id: string;
+    planownerid: string;
+    runownerid: string;
+    taskid?: string;
+    stepreports: executorreport[];
+    splitat: number;
+}
+/** One step outcome an executor reports back to the planner agent: the step id, the outcome, the detail in plain language and the report time. */
+export interface executorreport {
+    stepid: string;
+    outcome: "done" | "failed";
+    detail: string;
+    reportedat: number;
+}
+/** The states of one tab handoff: prepared packages the transfer, transferred moved the tab binding and resumed continued the task from the packaged state. */
+export type handoffstate = "prepared" | "transferred" | "resumed";
+/** One handoff request: the transferring agent, the receiving agent, the tab id and the packaged task state with the reason; the transfer preserves the original session grants. */
+export interface handoffrequest {
+    id: string;
+    fromagentid: string;
+    toagentid: string;
+    tabid?: number;
+    /** The packaged task state in plain language; the resume continues exactly from it. */
+    taskstate: string;
+    reason?: string;
+    createdat: number;
+}
+/** One handoff record: from and to agents, the tab, the packaged task state, the handoff state and the transfer and resume times. */
+export interface handoffrecord {
+    id: string;
+    fromagentid: string;
+    toagentid: string;
+    tabid?: number;
+    taskstate: string;
+    state: handoffstate;
+    reason?: string;
+    createdat: number;
+    transferredat?: number;
+    resumedat?: number;
+}
+/** The kinds of one resource lock: exclusive holds the resource alone while shared admits further shared holders only. */
+export type lockkind = "exclusive" | "shared";
+/** One resource lock of the swarm: the key composed of exactly one origin and one selector so a lock never spans unrelated origins, the holder agent, the kind and the expiry. */
+export interface resourcelock {
+    /** The lock key composed of the origin and the selector; the scope gate refuses keys that span more than one origin. */
+    key: string;
+    holder: string;
+    kind: lockkind;
+    origin: string;
+    selector: string;
+    acquiredat: number;
+    /** User configured expiry time; a lock past its expiry returns to the pool on the sweep. */
+    expiresat?: number;
+}
+/** One writer of a conflict scan: the agent, the origin and selector it targets and its task. */
+export interface conflictwriter {
+    agentid: string;
+    origin: string;
+    selector: string;
+    taskid?: string;
+}
+/** One conflict scan result: the writers examined, the overlapping targets with their writers, the suggested ordering and the clean marker when no writes overlap. */
+export interface conflictscan {
+    id: string;
+    writers: conflictwriter[];
+    overlaps: Array<{
+        origin: string;
+        selector: string;
+        writers: string[];
+    }>;
+    /** The suggested ordering of the writers for the overlapping targets, by agent id so the suggestion stays deterministic. */
+    suggestedorder: string[];
+    clean: boolean;
+    scannedat: number;
+}
+/** The merge rules for duplicate rows and conflicting values: first keeps the earliest value, last keeps the latest, preferagent keeps the value of the agent the user named and fail refuses the merge. */
+export type mergerule = "first" | "last" | "preferagent" | "fail";
+/** One merge entry mapping a parallel result into the final report: the agent, its task, the key and value and the conflict resolution note when other agents wrote the same key. */
+export interface mergeentry {
+    id: string;
+    agentid: string;
+    taskid?: string;
+    key: string;
+    value: string;
+    /** The conflict resolution note in plain language; an entry without a conflict carries none. */
+    conflict?: string;
+    mergedat: number;
+}
+/** One section of a result report: the title, the merged entries and the agents that sourced them. */
+export interface reportsection {
+    title: string;
+    entries: mergeentry[];
+    sources: string[];
+}
+/** One result report across agents: the sections, the contributing agent sources and the confidence the user reviews; every merged value keeps its provenance. */
+export interface resultreport {
+    id: string;
+    title: string;
+    sections: reportsection[];
+    sources: string[];
+    /** The confidence in the report stated in plain language; the value stays what the agents reported, never an engine score. */
+    confidence?: string;
+    createdat: number;
+}
+/** One milestone of a progressboard lane: the label, the done marker and the time the milestone completed. */
+export interface boardmilestone {
+    label: string;
+    done: boolean;
+    at?: number;
+}
+/** One lane of the progressboard: the agent, its role, its lifecycle state, its lane name, the current task and the milestones of its run. */
+export interface boardlane {
+    agentid: string;
+    name: string;
+    role: string;
+    state: string;
+    lane: string;
+    currenttask?: string;
+    milestones: boardmilestone[];
+}
+/** The progressboard layout of one swarm: one lane per agent so the user reads every agent at once, with the milestones each agent reported. */
+export interface progressboard {
+    id: string;
+    lanes: boardlane[];
+    builtat: number;
+}
+/** The states of one review request between agents: open waits, acked confirms receipt, answered carries the verdict and timeout expired unanswered. */
+export type reviewrequeststate = "open" | "acked" | "answered" | "timeout";
+/** One review request routed between agents: the requesting agent, the reviewing agent, the subject and payload and the ack, answer and timeout times. */
+export interface reviewrequest {
+    id: string;
+    fromagentid: string;
+    toagentid: string;
+    subject: string;
+    payload: string;
+    state: reviewrequeststate;
+    requestedat: number;
+    ackedat?: number;
+    answeredat?: number;
+    /** The user configured answer deadline; a request past it without an answer times out on the sweep. */
+    timeoutat?: number;
+}
+/** One escalation that lifts an agent decision to the user: the agent, the subject, the full context and the decision only the user writes. */
+export interface escalationrecord {
+    id: string;
+    agentid: string;
+    subject: string;
+    context: string;
+    state: "open" | "decided";
+    /** The decision the user wrote; an open escalation carries none because escalations stay human decided. */
+    decision?: string;
+    raisedat: number;
+    decidedat?: number;
+}
+/** The arbitration strategies that order competing resource claims: priority follows the user ordered agent list, age gives the oldest claim the resource and leader lets the elected leader decide. */
+export type arbitrationstrategy = "priority" | "age" | "leader";
+/** One arbitration rule the user configures: the strategy and, for the priority strategy, the agent order that wins competing claims. */
+export interface arbitrationrule {
+    id: string;
+    strategy: arbitrationstrategy;
+    /** The user ordered agent ids of the priority strategy; the first named agent wins a competing claim. */
+    priorityorder: string[];
+    configuredat: number;
+}
+/** One vote of a consensus round: yes, no or abstain with the voting agent and the time. */
+export type consensusvote = "yes" | "no" | "abstain";
+/** One consensus round: the subject, the collected votes, the user configured quorum and the state the votes resolve. */
+export interface consensusround {
+    id: string;
+    subject: string;
+    votes: Array<{
+        agentid: string;
+        vote: consensusvote;
+        votedat: number;
+    }>;
+    /** The number of yes votes the round needs to carry; a user configured value with no engine default. */
+    quorum: number;
+    state: "open" | "carried" | "failed";
+    openedat: number;
+    closedat?: number;
+}
+/** One interleaved action of the swarm timeline: the kind, the agent it names, the summary in plain language and the time. */
+export interface swarmaction {
+    id: string;
+    kind: string;
+    agentid?: string;
+    summary: string;
+    at: number;
+}
+/** The shared cost accounting of one swarm: the per agent usage summed into the swarm totals of tokens, cost and steps. */
+export interface swarmcost {
+    agents: number;
+    tokens: number;
+    cost: number;
+    steps: number;
+    currency?: string;
+    computedat: number;
+}
+/** One comparison of competing agent outputs for the user: the subject, the outputs per agent and the differences the comparison names. */
+export interface outputcomparison {
+    id: string;
+    subject: string;
+    outputs: Array<{
+        agentid: string;
+        value: string;
+    }>;
+    differences: string[];
+    comparedat: number;
+}
 //# sourceMappingURL=types.d.ts.map