@contraagent/api 0.0.0-stage → 0.1.0

package/dist/store.js

@@ -0,0 +1,286 @@
+// The monitor's data, live: the run list, the selected run's feed folded into a
+// `RunState`, and a change notification. No UI framework: a Lit controller, a
+// React hook or plain code can subscribe alike.
+import { ApiError, createMonitorClient } from './client.js';
+import { openRunFeed } from './feed.js';
+import { emptyRunState, reduceRun, rowId } from './run-state.js';
+import { isRunPanel } from './panels.js';
+const DEFAULT_INFO = { title: 'contraagent', panels: [], api_version: '' };
+/** A client given in the options may throw something else: it counts as no response from `url`. */
+const asApiError = (e, url) => (e instanceof ApiError ? e : new ApiError(url, 'network'));
+export class MonitorStore {
+    constructor(opts = {}) {
+        this.snap = {
+            info: DEFAULT_INFO,
+            runs: [],
+            hosts: null,
+            run: '',
+            state: emptyRunState(),
+            connected: false,
+            fresh: new Set(),
+            runsLoaded: false,
+            error: null,
+            trends: null,
+        };
+        /** The trends asked for last (`loadTrends`), kept fresh with the run list; null: none. */
+        this.trendsQuery = null;
+        /** Counts the trend requests: an answer to an older one is dropped. */
+        this.trendsAsked = 0;
+        /** The run list's records (`runsKey`) the trends shown were asked over: a refresh asks again only when they changed. */
+        this.trendsOver = null;
+        /** A refresh is under way: a call meanwhile does nothing, and the next one is scheduled after it ends. */
+        this.refreshing = false;
+        /** A trends request a refresh started is under way: no second one until it ends. */
+        this.trendsBusy = false;
+        /** Why the last request for `info`, for `runs`, and for `hosts` got no answer. */
+        this.infoError = null;
+        this.runsError = null;
+        this.hostsError = null;
+        this.infoLoaded = false;
+        this.stopped = false;
+        this.listeners = new Set();
+        this.rowListeners = new Set();
+        this.closeFeed = null;
+        this.queue = [];
+        this.flushTimer = null;
+        this.pollTimer = null;
+        this.opts = { runsEveryMs: 5000, batchMs: 50, freshMs: 4000, ...opts };
+        this.client = opts.client ?? createMonitorClient(opts.baseUrl === undefined ? {} : { baseUrl: opts.baseUrl });
+    }
+    get snapshot() {
+        return this.snap;
+    }
+    /** Called on every change, with the new snapshot. */
+    subscribe(fn) {
+        this.listeners.add(fn);
+        return () => this.listeners.delete(fn);
+    }
+    /** Called for each journal row that arrives after the replay: a task that just finished. */
+    onNewRow(fn) {
+        this.rowListeners.add(fn);
+        return () => this.rowListeners.delete(fn);
+    }
+    /**
+     * Load the title, panels and run list, and keep the run list fresh. A request
+     * that gets no answer sets `error`; the title and panels are asked for again
+     * with each refresh until they arrive.
+     */
+    async start() {
+        this.stopped = false;
+        await this.refresh();
+        this.schedule();
+    }
+    /** The next refresh, `runsEveryMs` after this one ended: refreshes never overlap, however slow the answers. */
+    schedule() {
+        if (this.stopped || this.opts.runsEveryMs <= 0 || this.pollTimer)
+            return;
+        this.pollTimer = setTimeout(() => {
+            this.pollTimer = null;
+            void this.refresh().finally(() => this.schedule());
+        }, this.opts.runsEveryMs);
+    }
+    async refresh() {
+        if (this.refreshing)
+            return;
+        this.refreshing = true;
+        try {
+            if (!this.infoLoaded)
+                await this.loadInfo();
+            await this.refreshRuns();
+        }
+        finally {
+            this.refreshing = false;
+        }
+        // The trends are asked for again only when the runs' records or the trend panels (a
+        // panel list that arrived after them) changed, and not awaited here: a slow trend
+        // panel holds back no run list.
+        const query = this.trendsQuery;
+        if (query && !this.trendsBusy && !this.stopped && this.trendsKey() !== this.trendsOver) {
+            this.trendsBusy = true;
+            void this.fetchTrends(query).finally(() => (this.trendsBusy = false));
+        }
+    }
+    /** What the trends are made of, as far as the run list says: each run and its last record; and the trend panels asked for over them. */
+    trendsKey() {
+        const runs = this.snap.runs.map((r) => `${r.run}\t${r.last_ts}\t${r.attempts}`).join('\n');
+        return `${runs}\n\n${this.trendPanelNames().join('\n')}`;
+    }
+    trendPanelNames() {
+        return this.snap.info.panels.filter((p) => p.scope === 'trends').map((p) => p.name);
+    }
+    /**
+     * Load the trends of `query` (`/api/trends`) and the trend panels over it, and keep them
+     * fresh with the run list until `closeTrends`. The trends of another query stay shown
+     * until the new ones arrive (`loading`).
+     */
+    async loadTrends(query) {
+        const same = this.snap.trends && JSON.stringify(this.snap.trends.query) === JSON.stringify(query);
+        this.trendsQuery = query;
+        this.set({ trends: { query, data: same ? this.snap.trends.data : (this.snap.trends?.data ?? null), panels: same ? this.snap.trends.panels : {}, loading: true, error: null } });
+        await this.fetchTrends(query);
+    }
+    /** Stop keeping the trends fresh (the page left them). */
+    closeTrends() {
+        this.trendsQuery = null;
+    }
+    /**
+     * Ask for the trends of `query` and each trend panel over it. Each answer is shown as it
+     * arrives, so a slow panel holds back neither the trends nor another panel; an answer to
+     * an older request is dropped.
+     */
+    async fetchTrends(query) {
+        const asked = ++this.trendsAsked;
+        this.trendsOver = this.trendsKey();
+        const view = () => (asked === this.trendsAsked && !this.stopped ? this.snap.trends : null);
+        const names = this.trendPanelNames();
+        const trends = this.client.trends(query).then((data) => {
+            const v = view();
+            if (v)
+                this.set({ trends: { ...v, query, data, loading: false, error: null } });
+        }, (e) => {
+            const v = view();
+            if (v)
+                this.set({ trends: { ...v, query, loading: false, error: asApiError(e, `${this.client.baseUrl}/api/trends`) } });
+        });
+        const panel = (name, body) => {
+            const v = view();
+            if (v)
+                this.set({ trends: { ...v, panels: { ...v.panels, [name]: body } } });
+        };
+        const bodies = names.map((n) => this.client.trendsPanel(n, query).then((body) => panel(n, body), (e) => panel(n, { error: String(e) })));
+        await Promise.allSettled([trends, ...bodies]);
+    }
+    async loadInfo() {
+        try {
+            const before = this.panelNames();
+            const info = await this.client.info();
+            if (this.stopped)
+                return;
+            this.infoLoaded = true;
+            this.infoError = null;
+            this.set({ info });
+            // A run opened before the panel list arrived listens for no panel: open it again.
+            if (this.snap.run && this.panelNames() !== before)
+                this.reopen();
+        }
+        catch (e) {
+            this.infoError = asApiError(e, `${this.client.baseUrl}/api/info`);
+        }
+    }
+    /** Fetch the run list, and on a hub the host list beside it: both refresh together, so a run's host reads the same in both. */
+    async refreshRuns() {
+        const [runs, hosts] = await Promise.allSettled([this.client.runs(), this.snap.info.hosts ? this.client.hosts() : Promise.resolve(null)]);
+        if (this.stopped)
+            return;
+        // A failed request keeps the last list.
+        const patch = {};
+        if (runs.status === 'fulfilled') {
+            patch.runs = runs.value;
+            patch.runsLoaded = true;
+            this.runsError = null;
+        }
+        else
+            this.runsError = asApiError(runs.reason, `${this.client.baseUrl}/api/runs`);
+        if (hosts.status === 'fulfilled') {
+            patch.hosts = hosts.value;
+            this.hostsError = null;
+        }
+        else
+            this.hostsError = asApiError(hosts.reason, `${this.client.baseUrl}/api/hosts`);
+        const error = this.infoError ?? this.runsError ?? this.hostsError;
+        // The same failure again keeps the same `error`.
+        if (error?.message !== this.snap.error?.message)
+            patch.error = error;
+        if (Object.keys(patch).length)
+            this.set(patch);
+    }
+    panelNames() {
+        return this.snap.info.panels.filter(isRunPanel).map((p) => p.name).join('\n');
+    }
+    /** Open the current run's feed again (the server replays it from the start). */
+    reopen() {
+        const run = this.snap.run;
+        this.closeFeed?.();
+        this.closeFeed = null;
+        this.selectRun(run);
+    }
+    /** Open `run`'s feed (closing the previous one); '' closes it. */
+    selectRun(run) {
+        if (run === this.snap.run && (this.closeFeed || !run))
+            return;
+        this.closeFeed?.();
+        this.closeFeed = null;
+        this.queue = [];
+        this.set({ run, state: emptyRunState(), connected: false, fresh: new Set() });
+        if (!run)
+            return;
+        const panels = this.snap.info.panels.filter(isRunPanel).map((p) => p.name);
+        const on = {
+            open: () => {
+                this.push({ event: 'connected' });
+                this.set({ connected: true });
+            },
+            error: () => this.set({ connected: false }),
+            message: (msg) => this.push(msg),
+        };
+        this.closeFeed = this.opts.openRunFeed
+            ? this.opts.openRunFeed(run, panels, on)
+            : openRunFeed(run, panels, on, { ...(this.opts.baseUrl === undefined ? {} : { baseUrl: this.opts.baseUrl }), ...this.opts.feed });
+    }
+    /** Close the feed and stop refreshing; an answer that arrives later is dropped. */
+    stop() {
+        this.stopped = true;
+        this.closeFeed?.();
+        this.closeFeed = null;
+        if (this.pollTimer)
+            clearTimeout(this.pollTimer);
+        this.pollTimer = null;
+        if (this.flushTimer)
+            clearTimeout(this.flushTimer);
+        this.flushTimer = null;
+    }
+    push(a) {
+        this.queue.push(a);
+        this.flushTimer ??= setTimeout(() => this.flush(), this.opts.batchMs);
+    }
+    flush() {
+        this.flushTimer = null;
+        const batch = this.queue;
+        this.queue = [];
+        // Rows that arrive once the replay is over are new: announce them and mark them fresh.
+        let ready = this.snap.state.ready;
+        const fresh = [];
+        for (const a of batch) {
+            if (a.event === 'connected')
+                ready = false;
+            else if (a.event === 'ready')
+                ready = true;
+            else if (a.event === 'journal' && ready)
+                fresh.push(a.data);
+        }
+        const state = reduceRun(this.snap.state, batch);
+        if (!fresh.length) {
+            this.set({ state });
+            return;
+        }
+        const ids = new Set(this.snap.fresh);
+        for (const row of fresh)
+            ids.add(rowId(row));
+        this.set({ state, fresh: ids });
+        for (const row of fresh)
+            for (const fn of this.rowListeners)
+                fn(row);
+        setTimeout(() => {
+            const left = new Set(this.snap.fresh);
+            for (const row of fresh)
+                left.delete(rowId(row));
+            this.set({ fresh: left });
+        }, this.opts.freshMs);
+    }
+    set(patch) {
+        this.snap = { ...this.snap, ...patch };
+        for (const fn of this.listeners)
+            fn(this.snap);
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,112 @@
+import type { components } from './schema.js';
+import type { PanelBody } from './panels.js';
+type S = components['schemas'];
+export type { components, paths } from './schema.js';
+/** A JSON object whose keys a domain chooses (a panel's body, a contract file's content). */
+export type JsonObject = Record<string, unknown>;
+export type Info = S['Info'];
+/** What an export holds (`Info.export`): set only when the monitor reads one. */
+export type ExportInfo = S['ExportInfo'];
+export type PanelInfo = S['PanelInfo'];
+export type RunSummary = S['RunSummary'];
+export type Hosts = S['Hosts'];
+export type HostSummary = S['HostSummary'];
+export type AccountQuota = S['AccountQuota'];
+/** What the runs of a period add up to (`/api/trends`). */
+export type Trends = S['Trends'];
+export type TrendKind = S['TrendKind'];
+export type TrendQuota = S['TrendQuota'];
+export type TrendRun = S['TrendRun'];
+/** Which runs `/api/trends` sums: days `from` to `to` (YYYY-MM-DD) in the time zone `tz`, of one `run_group`. */
+export interface TrendsQuery {
+    from?: string;
+    to?: string;
+    tz?: string;
+    run_group?: string;
+}
+export type JournalRow = S['JournalRow'];
+/** How one attempt ended (`JournalRow.stop`): a `Stop` of the Python package, or `skipped`. */
+export type Stop = JournalRow['stop'];
+export type Hop = S['Hop'];
+export type SkippedHop = S['SkippedHop'];
+/** Why a credential rests (a cap or the quota rule): what a `SkippedHop` and a `CredentialRest` share. */
+export type Rest = Pick<S['SkippedHop'], 'credential' | 'window' | 'pct' | 'cap' | 'rule' | 'until'>;
+export type TokenUsage = S['TokenUsage'];
+export type QuotaReading = S['QuotaReading'];
+export type JournalPage = S['JournalPage'];
+export type Executor = NonNullable<S['PlanNode']['executor']>;
+export type Plan = S['Plan'];
+export type PlanNode = S['PlanNode'];
+export type PlanGroup = S['PlanGroup'];
+export type DeferralCause = S['DeferralCause'];
+export type QuotaCap = S['QuotaCap'];
+export type CredentialRest = S['CredentialRest'];
+export type ModelUsage = S['ModelUsage'];
+export type PreflightRecord = S['PreflightRecord'];
+export type DroppedRoute = S['DroppedRoute'];
+export type Substitution = S['Substitution'];
+export type KeptKind = S['KeptKind'];
+export type TaskState = PlanNode['state'];
+export type Frame = S['Frame'];
+export type Loop = S['Loop'];
+export type FlowCallNode = S['FlowCallNode'];
+export type FlowState = FlowCallNode['state'];
+export type TimeBoxRecord = S['TimeBoxRecord'];
+export type Outputs = S['Outputs'];
+export type OutputTally = S['OutputTally'];
+export type ContractRecord = S['ContractRecord'];
+export type ContractSpec = S['ContractSpec'];
+export type ContractField = S['ContractField'];
+export type ContractStatus = NonNullable<ContractSpec['status']>;
+export type FileView = S['FileView'];
+export type TaskDefinition = S['TaskDefinition'];
+export type DefinitionFile = S['DefinitionFile'];
+export type CursorView = S['CursorView'];
+export type UnitPosition = S['UnitPosition'];
+export type Procs = S['Procs'];
+export type ProcNode = S['ProcNode'];
+export type AgentProcess = S['AgentProcess'];
+export type InflightPythonTask = S['InflightPythonTask'];
+export type TaskDetail = S['TaskDetail'];
+export type TaskLaunch = S['TaskLaunch'];
+export type TaskIO = S['TaskIO'];
+export type UpstreamTask = S['UpstreamTask'];
+export type DownstreamTask = S['DownstreamTask'];
+export type StreamPage = S['StreamPage'];
+export type LaunchEvent = S['LaunchEvent'];
+export type MessageUpdateEvent = S['MessageUpdateEvent'];
+export type ToolStartEvent = S['ToolStartEvent'];
+export type ToolEndEvent = S['ToolEndEvent'];
+export type ToolCallEchoEvent = S['ToolCallEchoEvent'];
+export type ToolResultEchoEvent = S['ToolResultEchoEvent'];
+/** Named apart from the DOM's `MessageEvent`. */
+export type TranscriptMessageEvent = S['MessageEvent'];
+export type NoticeEvent = S['NoticeEvent'];
+export type RetryEvent = S['RetryEvent'];
+export type OtherEvent = S['OtherEvent'];
+/** One transcript event as the wire carries it: a known model, or an `OtherEvent`. */
+export type TranscriptEvent = StreamPage['events'][number];
+/** The transcript events the monitor renders, discriminated by `type`. */
+export type KnownTranscriptEvent = LaunchEvent | MessageUpdateEvent | ToolStartEvent | ToolEndEvent | ToolCallEchoEvent | ToolResultEchoEvent | TranscriptMessageEvent | NoticeEvent | RetryEvent;
+/** The event as one of the known models, or null for any other `type`. */
+export declare function knownEvent(e: TranscriptEvent): KnownTranscriptEvent | null;
+/** One message of `/events?run=`: `event` is the SSE event name, `data` its parsed JSON. */
+export type RunMessage = S['RunEvent'];
+type FixedRunMessage = RunMessage extends infer M ? M extends {
+    event: infer E;
+} ? string extends E ? never : M : never : never;
+export type PanelEventName = `panel:${string}`;
+/** A panel's message, with its event name typed. */
+export interface PanelMessage {
+    event: PanelEventName;
+    data: PanelBody;
+}
+/** A run feed message with every `event` name a literal (or `panel:<name>`). */
+export type RunFeedMessage = FixedRunMessage | PanelMessage;
+/** The SSE event names with a fixed meaning, and what each one carries. */
+export type RunEventData = {
+    [M in FixedRunMessage as M['event']]: M['data'];
+};
+export type RunEventName = keyof RunEventData;
+export type StreamMessage = S['StreamMessage'];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,19 @@
+const KNOWN_TYPES = new Set([
+    'launch',
+    'message_update',
+    'tool_execution_start',
+    'tool_execution_update',
+    'tool_execution_end',
+    'acall',
+    'aresult',
+    'message_start',
+    'message_end',
+    'turn_end',
+    'notice',
+    'auto_retry_start',
+]);
+/** The event as one of the known models, or null for any other `type`. */
+export function knownEvent(e) {
+    return KNOWN_TYPES.has(e.type) ? e : null;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAuHA,MAAM,WAAW,GAAwB,IAAI,GAAG,CAA+B;IAC7E,QAAQ;IACR,gBAAgB;IAChB,sBAAsB;IACtB,uBAAuB;IACvB,oBAAoB;IACpB,OAAO;IACP,SAAS;IACT,eAAe;IACf,aAAa;IACb,UAAU;IACV,QAAQ;IACR,kBAAkB;CACnB,CAAC,CAAC;AAEH,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,CAAkB;IAC3C,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,CAA0B,CAAC,CAAC,CAAC,IAAI,CAAC;AACtE,CAAC"}

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@contraagent/api",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Typed client for the contraagent monitor API: generated types, REST client, live feeds and the run state they fold into",
+  "license": "MIT",
+  "keywords": [
+    "contraagent",
+    "coding-agent",
+    "monitor",
+    "openapi",
+    "client",
+    "typescript"
+  ],
+  "homepage": "https://t-tani.github.io/contraagent/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/t-tani/contraagent.git",
+    "directory": "web/packages/api"
+  },
+  "bugs": {
+    "url": "https://github.com/t-tani/contraagent/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/__snapshots__"
+  ],
+  "devDependencies": {
+    "openapi-typescript": "^7.13.0"
+  },
+  "scripts": {
+    "gen": "node scripts/gen.mjs",
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/src/client.ts

@@ -0,0 +1,119 @@
+// The REST half of the monitor API, typed by the generated `paths`.
+import type {
+  Hosts,
+  Info,
+  JournalPage,
+  JsonObject,
+  RunSummary,
+  StreamPage,
+  TaskDefinition,
+  TaskDetail,
+  Trends,
+  TrendsQuery,
+  paths,
+} from './types.js';
+
+/**
+ * Why a request got no JSON answer: `network`, no response (a network error, a
+ * refused connection, or a cross-origin response the browser blocked);
+ * `status`, a status outside 2xx; `not-json`, a body that is not JSON (empty,
+ * or the HTML page a development server answers every path with).
+ */
+export type ApiFailure = 'network' | 'status' | 'not-json';
+
+/**
+ * A request to the monitor's API that got no JSON answer. Its message states
+ * the URL, the failure, the status and the media type
+ * ("No JSON answer from http://host/api/runs: not-json 200 text/html");
+ * `@contraagent/ui` words it for the reader.
+ */
+export class ApiError extends Error {
+  constructor(
+    /** The URL requested. */
+    readonly url: string,
+    readonly failure: ApiFailure,
+    /** The response's status; 0 with no response. */
+    readonly status = 0,
+    /** The response's media type, such as `text/html`; '' when it states none. */
+    readonly type = '',
+  ) {
+    super(`No JSON answer from ${url}: ${failure} ${status} ${type}`.trim());
+    this.name = 'ApiError';
+  }
+}
+
+export interface ClientOptions {
+  /** Where the monitor is served; '' (the default) is the page's own origin. */
+  baseUrl?: string;
+  fetch?: typeof globalThis.fetch;
+}
+
+/** Typed calls for every JSON endpoint of the monitor. Each throws `ApiError` when it gets no JSON answer. */
+export interface MonitorClient {
+  readonly baseUrl: string;
+  info(): Promise<Info>;
+  runs(): Promise<RunSummary[]>;
+  /** The hosts behind the runs (a hub: `Info.hosts`). */
+  hosts(): Promise<Hosts>;
+  journal(run: string, since?: number): Promise<JournalPage>;
+  definitions(run: string): Promise<TaskDefinition[]>;
+  task(run: string, key: string): Promise<TaskDetail>;
+  stream(run: string, key: string, since?: number): Promise<StreamPage>;
+  panel(run: string, name: string): Promise<JsonObject>;
+  /** What the runs of a period add up to. */
+  trends(query?: TrendsQuery): Promise<Trends>;
+  /** A trend panel's body over the runs of a period (`Panel(scope="trends")`). */
+  trendsPanel(name: string, query?: TrendsQuery): Promise<JsonObject>;
+}
+
+/** The monitor's GET endpoints. */
+type Endpoint = { [P in keyof paths]: paths[P] extends { get: object } ? P : never }[keyof paths];
+type Operation<P extends Endpoint> = paths[P] extends { get: infer O } ? O : never;
+/** An endpoint's parameters: `path` fills its `{name}` parts, `query` is its query string. */
+type Params<P extends Endpoint> = Operation<P> extends { parameters: infer X } ? X : never;
+/** An endpoint's JSON answer (status 200). */
+type Answer<P extends Endpoint> =
+  Operation<P> extends { responses: { 200: { content: { 'application/json': infer T } } } } ? T : never;
+
+export function createMonitorClient(options: ClientOptions = {}): MonitorClient {
+  const baseUrl = (options.baseUrl ?? '').replace(/\/$/, '');
+  const origin = (baseUrl || globalThis.location?.origin || '').replace(/\/$/, '');
+  const fetch = options.fetch ?? globalThis.fetch;
+  /** The JSON answer of GET `endpoint`; `ApiError` when there is none. */
+  async function get<P extends Endpoint>(endpoint: P, params?: Params<P>): Promise<Answer<P>> {
+    const { path = {}, query = {} } = (params ?? {}) as { path?: Record<string, string>; query?: Record<string, number> };
+    const url = origin + endpoint.replace(/\{(\w+)\}/g, (part, name: string) => (name in path ? encodeURIComponent(path[name]!) : part));
+    const search = Object.entries(query)
+      .filter(([, v]) => v !== undefined && v !== null)
+      .map(([k, v]) => `${k}=${encodeURIComponent(v)}`)
+      .join('&');
+    const target = search ? `${url}?${search}` : url;
+    let response: Response;
+    try {
+      response = await fetch(new Request(target));
+    } catch {
+      throw new ApiError(target, 'network');
+    }
+    const { status, ok } = response;
+    const type = (response.headers.get('Content-Type') ?? '').split(';')[0]!.trim().toLowerCase();
+    try {
+      if (ok) return (await response.json()) as Answer<P>;
+    } catch {
+      // An empty body, an HTML page, or text that is not JSON.
+    }
+    throw new ApiError(target, ok ? 'not-json' : 'status', status, type);
+  }
+  return {
+    baseUrl,
+    info: () => get('/api/info'),
+    runs: () => get('/api/runs'),
+    hosts: () => get('/api/hosts'),
+    journal: (run, since = 0) => get('/api/runs/{run}/journal', { path: { run }, query: { since } }),
+    definitions: (run) => get('/api/runs/{run}/definitions', { path: { run } }),
+    task: (run, key) => get('/api/runs/{run}/task/{key}', { path: { run, key } }),
+    stream: (run, key, since = 0) => get('/api/runs/{run}/stream/{key}', { path: { run, key }, query: { since } }),
+    panel: (run, name) => get('/api/runs/{run}/panels/{name}', { path: { run, name } }),
+    trends: (query = {}) => get('/api/trends', { query: { ...query } }),
+    trendsPanel: (name, query = {}) => get('/api/trends/panels/{name}', { path: { name }, query: { ...query } }),
+  };
+}