@contraagent/api 0.1.0 → 0.3.0

package/README.md

@@ -11,8 +11,14 @@ A `::code` line quotes a file of the package; the [documentation site](https://t
 
 ## Getting it
 
-The package is not in the npm registry; install it from a checkout of the
-repository. Every monitor also serves the client, the feeds and the store as
+Install the package from the npm registry:
+
+```
+npm install @contraagent/api
+```
+
+A checkout of the repository packs its own version ([Use it from a
+checkout](#use-it-from-a-checkout)). Every monitor also serves the client, the feeds and the store as
 exports of its `/app.js` (`@contraagent/ui`'s documentation).
 
 ## Use it from a checkout

package/dist/panels.d.ts

@@ -13,16 +13,20 @@ export type HBar = S['HBar'];
 export type StatusGridBody = S['StatusGridBody'];
 export type GridCell = S['GridCell'];
 export type NoteBody = S['NoteBody'];
+export type CodeBody = S['CodeBody'];
+export type TreeBody = S['TreeBody'];
+export type TreeNode = S['TreeNode'];
+export type TreeLink = S['TreeLink'];
 export type BlocksBody = S['BlocksBody'];
 export type ChartSeries = S['ChartSeries'];
 /** How a number of a body is written: `pct` is a fraction (0.97 is 97%), `duration` seconds, `datetime` an ISO time. */
 export type ValueFormat = NonNullable<TableColumn['format']>;
 /** A body with a `type`: drawn with the monitor's own elements. */
-export type TypedPanelBody = TilesBody | TableBody | ColumnsBody | LinesBody | HeatmapBody | HBarsBody | StatusGridBody | NoteBody | BlocksBody;
+export type TypedPanelBody = TilesBody | TableBody | ColumnsBody | LinesBody | HeatmapBody | HBarsBody | StatusGridBody | NoteBody | CodeBody | TreeBody | BlocksBody;
 /** What a panel returns: a typed body, or any JSON object. */
 export type PanelBody = TypedPanelBody | JsonObject;
 /** The `type` of each typed body. */
-export declare const PANEL_TYPES: readonly ["tiles", "table", "columns", "lines", "heatmap", "hbars", "status_grid", "note", "blocks"];
+export declare const PANEL_TYPES: readonly ["tiles", "table", "columns", "lines", "heatmap", "hbars", "status_grid", "note", "code", "tree", "blocks"];
 /** `body` as a typed body, or null when it is any other JSON object (a JSON tree). */
 export declare function typedBody(body: unknown): TypedPanelBody | null;
 /** A panel computed per run: a tab of each run, sent on its live feed (a trends panel is not). */

package/dist/panels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"panels.d.ts","sourceRoot":"","sources":["../src/panels.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExD,KAAK,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;AAE/B,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACvC,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACvC,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACvC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;AAC3C,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;AAC3C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACvC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;AAC3C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACvC,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7B,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;AACrC,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;AACrC,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;AACzC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;AAC3C,wHAAwH;AACxH,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE7D,mEAAmE;AACnE,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,SAAS,GACT,WAAW,GACX,SAAS,GACT,WAAW,GACX,SAAS,GACT,cAAc,GACd,QAAQ,GACR,UAAU,CAAC;AACf,8DAA8D;AAC9D,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,UAAU,CAAC;AAEpD,qCAAqC;AACrC,eAAO,MAAM,WAAW,sGAAuG,CAAC;AAEhI,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAI9D;AAED,kGAAkG;AAClG,eAAO,MAAM,UAAU,GAAI,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAG,OAAuC,CAAC"}
+{"version":3,"file":"panels.d.ts","sourceRoot":"","sources":["../src/panels.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExD,KAAK,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;AAE/B,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACvC,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACvC,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACvC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;AAC3C,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;AAC3C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACvC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;AAC3C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACvC,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7B,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;AACrC,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;AACrC,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;AACrC,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;AACrC,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;AACrC,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;AACrC,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;AACzC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;AAC3C,wHAAwH;AACxH,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE7D,mEAAmE;AACnE,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,SAAS,GACT,WAAW,GACX,SAAS,GACT,WAAW,GACX,SAAS,GACT,cAAc,GACd,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,UAAU,CAAC;AACf,8DAA8D;AAC9D,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,UAAU,CAAC;AAEpD,qCAAqC;AACrC,eAAO,MAAM,WAAW,sHAAuH,CAAC;AAEhJ,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAI9D;AAED,kGAAkG;AAClG,eAAO,MAAM,UAAU,GAAI,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAG,OAAuC,CAAC"}

package/dist/panels.js

@@ -1,5 +1,5 @@
 /** The `type` of each typed body. */
-export const PANEL_TYPES = ['tiles', 'table', 'columns', 'lines', 'heatmap', 'hbars', 'status_grid', 'note', 'blocks'];
+export const PANEL_TYPES = ['tiles', 'table', 'columns', 'lines', 'heatmap', 'hbars', 'status_grid', 'note', 'code', 'tree', 'blocks'];
 /** `body` as a typed body, or null when it is any other JSON object (a JSON tree). */
 export function typedBody(body) {
     if (!body || typeof body !== 'object' || Array.isArray(body))

package/dist/panels.js.map

@@ -1 +1 @@
-{"version":3,"file":"panels.js","sourceRoot":"","sources":["../src/panels.ts"],"names":[],"mappings":"AAuCA,qCAAqC;AACrC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAEhI,sFAAsF;AACtF,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1E,MAAM,IAAI,GAAI,IAA2B,CAAC,IAAI,CAAC;IAC/C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAK,WAAiC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAuB,CAAC,CAAC,CAAC,IAAI,CAAC;AACzH,CAAC;AAED,kGAAkG;AAClG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAA2B,EAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC"}
+{"version":3,"file":"panels.js","sourceRoot":"","sources":["../src/panels.ts"],"names":[],"mappings":"AA6CA,qCAAqC;AACrC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAEhJ,sFAAsF;AACtF,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1E,MAAM,IAAI,GAAI,IAA2B,CAAC,IAAI,CAAC;IAC/C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAK,WAAiC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAuB,CAAC,CAAC,CAAC,IAAI,CAAC;AACzH,CAAC;AAED,kGAAkG;AAClG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAA2B,EAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC"}

package/dist/schema.d.ts

@@ -400,6 +400,11 @@ export type components = {
              * @default false
              */
             collapsed?: boolean;
+            /**
+             * Anchor
+             * @description a name a tree node's link leads to: the body is scrolled into view (`TreeLink.anchor`)
+             */
+            anchor?: string | null;
             /**
              * Type
              * @default blocks
@@ -407,14 +412,16 @@ export type components = {
              */
             type?: "blocks";
             /** Blocks */
-            blocks: (components["schemas"]["TilesBody"] | components["schemas"]["TableBody"] | components["schemas"]["ColumnsBody"] | components["schemas"]["LinesBody"] | components["schemas"]["HeatmapBody"] | components["schemas"]["HBarsBody"] | components["schemas"]["StatusGridBody"] | components["schemas"]["NoteBody"] | components["schemas"]["BlocksBody"] | {
+            blocks: (components["schemas"]["TilesBody"] | components["schemas"]["TableBody"] | components["schemas"]["ColumnsBody"] | components["schemas"]["LinesBody"] | components["schemas"]["HeatmapBody"] | components["schemas"]["HBarsBody"] | components["schemas"]["StatusGridBody"] | components["schemas"]["NoteBody"] | components["schemas"]["CodeBody"] | components["schemas"]["TreeBody"] | components["schemas"]["BlocksBody"] | {
                 [key: string]: unknown;
             })[];
         };
         /**
          * Changes
          * @description The files one attempt changed under its task's `changes` patterns, as paths relative
-         *     to the working directory: those it `created`, `modified` and `deleted`.
+         *     to the working directory: those it `created`, `modified` and `deleted`. Of a failed
+         *     attempt's created files, `removed` lists those the runner removed, and `kept` those it
+         *     left in place because the kind keeps them (`keep_failed_changes`).
          */
         Changes: {
             /**
@@ -437,6 +444,11 @@ export type components = {
              * @default []
              */
             removed?: string[];
+            /**
+             * Kept
+             * @default []
+             */
+            kept?: string[];
         } & {
             [key: string]: unknown;
         };
@@ -450,6 +462,72 @@ export type components = {
             /** Values */
             values: (number | null)[];
         };
+        /**
+         * CodeBody
+         * @description A text shown as code: highlighted by its `language` (one of `LANGUAGES`, a file's
+         *     extension such as `py`, or anything else for plain text), with line numbers from
+         *     `start`. `highlight` marks lines in those numbers: a line (`7`) or a range of lines,
+         *     both included (`[10, 14]`). `path` names the file over it. Long lines scroll sideways
+         *     unless `wrap`. The monitor shows the first `CODE_LINES` lines (and at most
+         *     `CODE_CHARACTERS` characters) and says how many it left out.
+         */
+        CodeBody: {
+            /**
+             * Title
+             * @description a heading over the body
+             */
+            title?: string | null;
+            /**
+             * Collapsed
+             * @description shown folded, under its title
+             * @default false
+             */
+            collapsed?: boolean;
+            /**
+             * Anchor
+             * @description a name a tree node's link leads to: the body is scrolled into view (`TreeLink.anchor`)
+             */
+            anchor?: string | null;
+            /**
+             * Type
+             * @default code
+             * @constant
+             */
+            type?: "code";
+            /** Text */
+            text: string;
+            /**
+             * Language
+             * @description a name of `LANGUAGES` or a file extension; '': plain text
+             * @default
+             */
+            language?: string;
+            /**
+             * Start
+             * @description the number of the first line
+             * @default 1
+             */
+            start?: number;
+            /**
+             * Highlight
+             * @description lines marked: a line, or a range, both ends included
+             */
+            highlight?: (number | [
+                number,
+                number
+            ])[];
+            /**
+             * Path
+             * @description the file the text is, named over it
+             */
+            path?: string | null;
+            /**
+             * Wrap
+             * @description long lines wrap; otherwise they scroll sideways
+             * @default false
+             */
+            wrap?: boolean;
+        };
         /**
          * ColumnsBody
          * @description Vertical bars, one group per label of `x`; `stacked` puts the series of a label on one bar.
@@ -466,6 +544,11 @@ export type components = {
              * @default false
              */
             collapsed?: boolean;
+            /**
+             * Anchor
+             * @description a name a tree node's link leads to: the body is scrolled into view (`TreeLink.anchor`)
+             */
+            anchor?: string | null;
             /**
              * Type
              * @default columns
@@ -555,6 +638,11 @@ export type components = {
              * @description input: the key of the task whose output it is
              */
             producer?: string | null;
+            /**
+             * Format
+             * @description what the file holds: one JSON document, any text, or rows (JSON Lines, `fields` those of one line)
+             */
+            format?: ("json" | "text" | "jsonl") | null;
             /** Schema Name */
             schema_name: string;
             /**
@@ -811,8 +899,9 @@ export type components = {
         };
         /**
          * FileView
-         * @description A contract's file as it is now. `content` is the parsed JSON, else the
-         *     text (cut at 20 000 characters, `truncated`), else null when unreadable.
+         * @description A contract's file as it is now. `content` is the parsed JSON (for rows, the list of
+         *     the lines that parse), else the text (cut at 20 000 characters, `truncated`), else null
+         *     when unreadable.
          */
         FileView: {
             /** Exists */
@@ -939,6 +1028,11 @@ export type components = {
              * @default false
              */
             collapsed?: boolean;
+            /**
+             * Anchor
+             * @description a name a tree node's link leads to: the body is scrolled into view (`TreeLink.anchor`)
+             */
+            anchor?: string | null;
             /**
              * Type
              * @default hbars
@@ -971,6 +1065,11 @@ export type components = {
              * @default false
              */
             collapsed?: boolean;
+            /**
+             * Anchor
+             * @description a name a tree node's link leads to: the body is scrolled into view (`TreeLink.anchor`)
+             */
+            anchor?: string | null;
             /**
              * Type
              * @default heatmap
@@ -1233,6 +1332,8 @@ export type components = {
             rounds?: number | null;
             /** Round Errors */
             round_errors?: string[][];
+            /** Max Corrections */
+            max_corrections?: number | null;
             /** Hook Errors */
             hook_errors?: string[][];
             usage?: components["schemas"]["TokenUsage"] | null;
@@ -1259,6 +1360,16 @@ export type components = {
              * @default
              */
             fingerprint?: string;
+            /**
+             * Outside
+             * @default
+             */
+            outside?: string;
+            /**
+             * Rerun
+             * @default
+             */
+            rerun?: string;
             /** Flow Call */
             flow_call?: string | null;
             /**
@@ -1329,6 +1440,11 @@ export type components = {
              * @default false
              */
             collapsed?: boolean;
+            /**
+             * Anchor
+             * @description a name a tree node's link leads to: the body is scrolled into view (`TreeLink.anchor`)
+             */
+            anchor?: string | null;
             /**
              * Type
              * @default lines
@@ -1477,6 +1593,11 @@ export type components = {
              * @default false
              */
             collapsed?: boolean;
+            /**
+             * Anchor
+             * @description a name a tree node's link leads to: the body is scrolled into view (`TreeLink.anchor`)
+             */
+            anchor?: string | null;
             /**
              * Type
              * @default note
@@ -1615,7 +1736,7 @@ export type components = {
              */
             event: string;
             /** Data */
-            data: components["schemas"]["TilesBody"] | components["schemas"]["TableBody"] | components["schemas"]["ColumnsBody"] | components["schemas"]["LinesBody"] | components["schemas"]["HeatmapBody"] | components["schemas"]["HBarsBody"] | components["schemas"]["StatusGridBody"] | components["schemas"]["NoteBody"] | components["schemas"]["BlocksBody"] | {
+            data: components["schemas"]["TilesBody"] | components["schemas"]["TableBody"] | components["schemas"]["ColumnsBody"] | components["schemas"]["LinesBody"] | components["schemas"]["HeatmapBody"] | components["schemas"]["HBarsBody"] | components["schemas"]["StatusGridBody"] | components["schemas"]["NoteBody"] | components["schemas"]["CodeBody"] | components["schemas"]["TreeBody"] | components["schemas"]["BlocksBody"] | {
                 [key: string]: unknown;
             };
         };
@@ -1676,6 +1797,11 @@ export type components = {
              * @description each model the run's agent sessions ran on, in order of first use
              */
             models?: components["schemas"]["ModelUsage"][];
+            /**
+             * Services
+             * @description each start of a service of the run (`services.jsonl`), with its stop, in start order
+             */
+            services?: components["schemas"]["ServiceSpan"][];
             /** @description what the run's preflight did (`run.json`); null when its run.json records none */
             preflight?: components["schemas"]["PreflightRecord"] | null;
         };
@@ -1756,6 +1882,12 @@ export type components = {
              * @default 0
              */
             priority?: number;
+            /**
+             * Credential
+             * @description the credential its task call names (`credential=`), which every route of its kind ran it as; empty when it names none, or a run-wide override outranks it
+             * @default
+             */
+            credential?: string;
             /**
              * Executor
              * @default agent
@@ -1823,6 +1955,12 @@ export type components = {
             deferred?: string;
             /** @description the same as data; null when it was not deferred, or the run recorded no cause */
             deferred_cause?: components["schemas"]["DeferralCause"] | null;
+            /**
+             * Rerun
+             * @description why a resume ran it again although an earlier attempt of the run had finished it (its outside state changed, ...), from its last journal row; empty when no earlier attempt had
+             * @default
+             */
+            rerun?: string;
         } & {
             [key: string]: unknown;
         };
@@ -2166,6 +2304,62 @@ export type components = {
              */
             row_extras?: string[];
         };
+        /**
+         * ServiceSpan
+         * @description One start of the service a claim name stands for (`services.jsonl`), with its stop.
+         */
+        ServiceSpan: {
+            /**
+             * Name
+             * @description the claim name the service stands for
+             */
+            name: string;
+            /**
+             * Started At
+             * @description when its start ended, ISO 8601
+             */
+            started_at: string;
+            /**
+             * Key
+             * @description the task whose claim started it
+             * @default
+             */
+            key?: string;
+            /**
+             * Address
+             * @description what it gave its tasks to reach it; null for none
+             */
+            address?: string | null;
+            /**
+             * Start S
+             * @description how long its start took, in seconds
+             * @default 0
+             */
+            start_s?: number;
+            /**
+             * Start Error
+             * @description the exception of a start that failed (the service did not start); empty when it started
+             * @default
+             */
+            start_error?: string;
+            /**
+             * Stopped At
+             * @description when it stopped, ISO 8601; empty while it is up, or when the run ended with no stop recorded
+             * @default
+             */
+            stopped_at?: string;
+            /**
+             * Stop Cause
+             * @description why it stopped; null while it is up
+             */
+            stop_cause?: ("run_end" | "interrupted") | null;
+            /**
+             * Stop Error
+             * @description the exception its stop raised; empty when the stop went well
+             * @default
+             */
+            stop_error?: string;
+        };
         /**
          * SkippedHop
          * @description A hop of the failover chain an attempt passed over without a launch, because its
@@ -2244,6 +2438,11 @@ export type components = {
              * @default false
              */
             collapsed?: boolean;
+            /**
+             * Anchor
+             * @description a name a tree node's link leads to: the body is scrolled into view (`TreeLink.anchor`)
+             */
+            anchor?: string | null;
             /**
              * Type
              * @default status_grid
@@ -2316,6 +2515,11 @@ export type components = {
              * @default false
              */
             collapsed?: boolean;
+            /**
+             * Anchor
+             * @description a name a tree node's link leads to: the body is scrolled into view (`TreeLink.anchor`)
+             */
+            anchor?: string | null;
             /**
              * Type
              * @default table
@@ -2586,6 +2790,11 @@ export type components = {
              * @default false
              */
             collapsed?: boolean;
+            /**
+             * Anchor
+             * @description a name a tree node's link leads to: the body is scrolled into view (`TreeLink.anchor`)
+             */
+            anchor?: string | null;
             /**
              * Type
              * @default tiles
@@ -2774,6 +2983,93 @@ export type components = {
         } & {
             [key: string]: unknown;
         };
+        /**
+         * TreeBody
+         * @description A tree of nodes, folded and opened by the reader: files and directories, say. A
+         *     node's `code` is shown beside the tree when the node is selected, with no request
+         *     of its own: a panel of files returns their texts with the tree. `selected` is the
+         *     node selected first (its `id`; default: the first node with code).
+         */
+        TreeBody: {
+            /**
+             * Title
+             * @description a heading over the body
+             */
+            title?: string | null;
+            /**
+             * Collapsed
+             * @description shown folded, under its title
+             * @default false
+             */
+            collapsed?: boolean;
+            /**
+             * Anchor
+             * @description a name a tree node's link leads to: the body is scrolled into view (`TreeLink.anchor`)
+             */
+            anchor?: string | null;
+            /**
+             * Type
+             * @default tree
+             * @constant
+             */
+            type?: "tree";
+            /** Nodes */
+            nodes: components["schemas"]["TreeNode"][];
+            /** Selected */
+            selected?: string | null;
+        };
+        /**
+         * TreeLink
+         * @description Where a tree node leads, in the monitor: a run panel's tab (`panel`, its name), a
+         *     task (`task`, its key), each in `run` (default: the run shown), or a body of the same
+         *     panel (`anchor`, its `anchor`). Exactly one of `panel`, `task` and `anchor`.
+         */
+        TreeLink: {
+            /** Panel */
+            panel?: string | null;
+            /**
+             * Task
+             * @description a task's key
+             */
+            task?: string | null;
+            /**
+             * Run
+             * @description the run of `panel` or `task`; a trends panel names it
+             */
+            run?: string | null;
+            /** Anchor */
+            anchor?: string | null;
+        };
+        /**
+         * TreeNode
+         * @description One node of a tree: its `name`, and `children` under it. `id` names it (default: the
+         *     names from the top, joined by `/`). `icon` is `directory` for a node with children and
+         *     `file` for one without, unless given. `badge` is a word beside the name, coloured by
+         *     `tone`. A node shows its `code` beside the tree when
+         *     it is selected, or leads elsewhere by its `link`; not both. `open`: its children are
+         *     shown at first.
+         */
+        TreeNode: {
+            /** Name */
+            name: string;
+            /** Id */
+            id?: string | null;
+            /** Icon */
+            icon?: ("file" | "directory") | null;
+            /** Badge */
+            badge?: string | null;
+            /** Tone */
+            tone?: ("failed" | "attention" | "done" | "running" | "muted" | "neutral") | null;
+            /**
+             * Open
+             * @default true
+             */
+            open?: boolean;
+            /** Children */
+            children?: components["schemas"]["TreeNode"][];
+            code?: components["schemas"]["CodeBody"] | null;
+            link?: components["schemas"]["TreeLink"] | null;
+        };
         /**
          * TrendDay
          * @description One day: its attempts (by when they ended), and its cost per group (`Monitor(groups=)`; a kind in none is its own).
@@ -3312,7 +3608,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TilesBody"] | components["schemas"]["TableBody"] | components["schemas"]["ColumnsBody"] | components["schemas"]["LinesBody"] | components["schemas"]["HeatmapBody"] | components["schemas"]["HBarsBody"] | components["schemas"]["StatusGridBody"] | components["schemas"]["NoteBody"] | components["schemas"]["BlocksBody"] | {
+                    "application/json": components["schemas"]["TilesBody"] | components["schemas"]["TableBody"] | components["schemas"]["ColumnsBody"] | components["schemas"]["LinesBody"] | components["schemas"]["HeatmapBody"] | components["schemas"]["HBarsBody"] | components["schemas"]["StatusGridBody"] | components["schemas"]["NoteBody"] | components["schemas"]["CodeBody"] | components["schemas"]["TreeBody"] | components["schemas"]["BlocksBody"] | {
                         [key: string]: unknown;
                     };
                 };
@@ -3614,7 +3910,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TilesBody"] | components["schemas"]["TableBody"] | components["schemas"]["ColumnsBody"] | components["schemas"]["LinesBody"] | components["schemas"]["HeatmapBody"] | components["schemas"]["HBarsBody"] | components["schemas"]["StatusGridBody"] | components["schemas"]["NoteBody"] | components["schemas"]["BlocksBody"] | {
+                    "application/json": components["schemas"]["TilesBody"] | components["schemas"]["TableBody"] | components["schemas"]["ColumnsBody"] | components["schemas"]["LinesBody"] | components["schemas"]["HeatmapBody"] | components["schemas"]["HBarsBody"] | components["schemas"]["StatusGridBody"] | components["schemas"]["NoteBody"] | components["schemas"]["CodeBody"] | components["schemas"]["TreeBody"] | components["schemas"]["BlocksBody"] | {
                         [key: string]: unknown;
                     };
                 };