@adonis-agora/agent 0.20.0 → 0.22.0

package/dist/src/telescope/agent-governance-providers.js

@@ -0,0 +1,312 @@
+import { getTelescopeGovernanceQueries } from './governance-registry.js';
+/**
+ * Governance data providers for the "Agent" Telescope tab: spend/usage, run reliability, tool
+ * activity, and the pending-approvals inbox. Unlike `data-providers.ts` (which reads the ephemeral,
+ * capped `lib:agent` diagnostic entries Telescope's generic bridge records), these read the
+ * authoritative, restart-surviving read-model — `AgentGovernanceQueries` — via
+ * `governance-registry.ts` (see that file for why a module-internal registry stands in for Nest's
+ * DI-resolved `AGENT_GOVERNANCE_QUERIES`).
+ *
+ * ## Ported from the Nest reference with real gaps, not just renamed fields
+ *
+ * Adonis's `AgentGovernanceQueries` (`../spi/governance-queries.js`) is NOT the same interface as
+ * nestjs-agent-core's — it is a separately-designed SPI that happens to cover the same ground. Some
+ * of Nest's governance panels have no Adonis equivalent to bind to, and are deliberately NOT ported
+ * here rather than faked against a shape that doesn't exist:
+ *
+ *  - **Top threads by cost** (`spendByThread`) — no such query on `AgentGovernanceQueries`.
+ *  - **Run retries** — `RunReliability` has no retry counter at all (Nest's `RunMetrics.retries`
+ *    counts LLM-step retries; Adonis's read-model doesn't aggregate that dimension).
+ *  - **Run duration percentiles** — `RunReliability` exposes one `avgDurationMs`, not p50/p95; the
+ *    `agent.runs.duration` provider below returns the mean instead of a metric-selectable
+ *    percentile (Nest's `query.metric === 'p95'` switch has nothing to switch to here).
+ *  - **Failed-run breakdown by error code** — no `RunErrorBreakdownRow`-shaped query exists;
+ *    `RunSummaryRow.error` is a per-run message, not an aggregable code.
+ *  - **Paged tool-calls / threads / runs tables** (`{ rows, total, page, limit }`, `Panel.paged`) —
+ *    `AgentGovernanceQueries` has no page+total query for tool calls or threads at all
+ *    (`recentToolCalls`/`recentThreads` are capped lists with no total), and `listRuns` paginates by
+ *    an opaque CURSOR, not a page number, so it cannot answer "page 3 of 7" either. `agent.runs.recent`
+ *    below uses `listRuns` for its FIRST page only, same as Nest's `recentRuns(limit)` — the capped,
+ *    non-paged shape both ecosystems already had before A1's paged-table convention existed.
+ *  - **Exact pending-approvals count** — `pendingApprovals` returns an array with no `total`; unlike
+ *    Nest's `approvalsPage({ page: 1, pageSize: 1 }).total`, there is no cheap way to ask "how many,
+ *    without listing them". `agentPendingApprovalsCountProvider` below is therefore a real
+ *    approximation — see its own doc comment.
+ *
+ * Every provider still degrades to an empty-but-valid shape (0 / `[]`) when the read-model isn't
+ * bound, exactly like the Nest reference — governance is optional configuration
+ * (`config.governanceQueries`), and telescope must render something sane when it's off.
+ */
+/** Default trailing window (in days, inclusive) when a panel query omits an explicit range. */
+const DEFAULT_TREND_WINDOW_DAYS = 30;
+const ISO_DAY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+function isIsoDay(value) {
+    return typeof value === 'string' && ISO_DAY_PATTERN.test(value);
+}
+function todayUtcDay() {
+    return new Date().toISOString().slice(0, 10);
+}
+/** Shift a `YYYY-MM-DD` UTC day by `deltaDays` (negative goes back in time). */
+export function shiftUtcDay(day, deltaDays) {
+    const shifted = new Date(`${day}T00:00:00.000Z`);
+    shifted.setUTCDate(shifted.getUTCDate() + deltaDays);
+    return shifted.toISOString().slice(0, 10);
+}
+/**
+ * Derive the query range: honour explicit `fromDay`/`toDay` (validated ISO days), otherwise default
+ * to the trailing {@link DEFAULT_TREND_WINDOW_DAYS}-day window ending today (UTC).
+ */
+export function resolveRange(query) {
+    const toDay = query && isIsoDay(query.toDay) ? query.toDay : todayUtcDay();
+    const fromDay = query && isIsoDay(query.fromDay)
+        ? query.fromDay
+        : shiftUtcDay(toDay, -(DEFAULT_TREND_WINDOW_DAYS - 1));
+    return { fromDay, toDay };
+}
+function roundCents(value) {
+    return Math.round(value * 100) / 100;
+}
+/** Read a positive number out of a raw query value — panel queries reach a provider as strings. */
+function readPositiveNumber(raw) {
+    if (typeof raw === 'number')
+        return Number.isFinite(raw) && raw > 0 ? raw : undefined;
+    if (typeof raw !== 'string' || raw.trim() === '')
+        return undefined;
+    const parsed = Number(raw);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
+}
+/** Default row count for a "recent …" feed when a panel's query omits `limit`. */
+const DEFAULT_RECENT_LIMIT = 50;
+/** Hard ceiling on `limit`, regardless of what a panel's query requests. */
+const MAX_RECENT_LIMIT = 500;
+/** Clamp a panel-supplied `limit` into `[1, MAX_RECENT_LIMIT]`, defaulting when absent/invalid. */
+function resolveLimit(query, fallback) {
+    const value = readPositiveNumber(query?.limit) ?? fallback;
+    return Math.min(MAX_RECENT_LIMIT, Math.max(1, Math.trunc(value)));
+}
+/** Placeholder shown for a table cell whose source value is `null`/unmeasured. */
+const NO_VALUE = '—';
+/** Cap this many characters before an error message rides into a table cell (matches the DB column's practical display width). */
+const ERROR_MESSAGE_CAP = 500;
+/** Cap a run's error message to {@link ERROR_MESSAGE_CAP} characters. `resolve()` output bypasses
+ * Telescope's entry redaction pipeline (that only runs on Watcher-recorded entries) — this cap is a
+ * stopgap so an unbounded stack trace never rides straight into a table cell unbounded. */
+export function capErrorMessage(message) {
+    if (message === null)
+        return NO_VALUE;
+    return message.length > ERROR_MESSAGE_CAP ? `${message.slice(0, ERROR_MESSAGE_CAP)}…` : message;
+}
+/** Build a governance `DataProvider` from a fetch + a format step. Degrades to `format([])` when the
+ * read-model isn't bound — the empty-but-valid shape every formatter already yields for `[]`. */
+function governanceProvider(name, arg, fetch, format) {
+    return {
+        name,
+        async resolve(query, _ctx) {
+            const queries = getTelescopeGovernanceQueries();
+            const rows = queries ? await fetch(queries, arg(query)) : [];
+            return format(rows);
+        },
+    };
+}
+/** stat → authoritative total spend (USD) over the range. */
+export function agentSpendTotalProvider() {
+    return governanceProvider('agent.spend.totalCost', resolveRange, (queries, range) => queries.spendByModel(range), (rows) => ({
+        value: roundCents(rows.reduce((sum, row) => sum + row.costUsd, 0)),
+    }));
+}
+/** stat → authoritative total tokens (input + output) over the range. */
+export function agentTokensTotalProvider() {
+    return governanceProvider('agent.spend.totalTokens', resolveRange, (queries, range) => queries.spendByModel(range), (rows) => ({
+        value: rows.reduce((sum, row) => sum + row.inputTokens + row.outputTokens, 0),
+    }));
+}
+/** breakdown → spend share per model (models with zero cost dropped from the donut). */
+export function agentSpendByModelProvider() {
+    return governanceProvider('agent.spend.byModel', resolveRange, (queries, range) => queries.spendByModel(range), (rows) => ({
+        segments: rows
+            .filter((row) => row.costUsd > 0)
+            .map((row) => ({ label: row.modelId, value: roundCents(row.costUsd) })),
+    }));
+}
+/** table → per-model requests / in+out tokens / cost. */
+export function agentModelSpendTableProvider() {
+    return governanceProvider('agent.spend.byModelTable', resolveRange, (queries, range) => queries.spendByModel(range), (rows) => ({
+        rows: rows.map((row) => ({ ...row, costUsd: roundCents(row.costUsd) })),
+    }));
+}
+/** timeseries → daily spend + tokens trend. */
+export function agentUsageTrendProvider() {
+    return governanceProvider('agent.usage.trend', resolveRange, (queries, range) => queries.usageTrend(range), (points) => ({
+        rows: points.map((point) => ({
+            label: point.day,
+            costUsd: roundCents(point.costUsd),
+            totalTokens: point.totalTokens,
+        })),
+    }));
+}
+/** table → spend per acting ref (user/tenant). */
+export function agentActorSpendTableProvider() {
+    return governanceProvider('agent.spend.byActor', resolveRange, (queries, range) => queries.spendByActor(range), (rows) => ({
+        rows: rows.map((row) => ({ ...row, costUsd: roundCents(row.costUsd) })),
+    }));
+}
+/** breakdown → spend share per actor (actors with zero cost dropped). */
+export function agentSpendByActorProvider() {
+    return governanceProvider('agent.spend.byActorShare', resolveRange, (queries, range) => queries.spendByActor(range), (rows) => ({
+        segments: rows
+            .filter((row) => row.costUsd > 0)
+            .map((row) => ({ label: row.actorRef, value: roundCents(row.costUsd) })),
+    }));
+}
+/** Build a `DataProvider` off ONE range-scoped `runReliability` call + a format step — every
+ * reliability stat below reuses the same underlying query. Degrades to zeros when unbound. */
+function reliabilityProvider(name, format) {
+    return {
+        name,
+        async resolve(query, _ctx) {
+            const queries = getTelescopeGovernanceQueries();
+            const metrics = queries
+                ? await queries.runReliability(toToolStatsRange(query))
+                : EMPTY_RELIABILITY;
+            return format(metrics);
+        },
+    };
+}
+const EMPTY_RELIABILITY = {
+    runs: 0,
+    successRate: 0,
+    failed: 0,
+    avgDurationMs: null,
+};
+/** `runReliability`'s range is `{ from?, to? }` (both optional), not `resolveRange`'s `{ fromDay, toDay }`
+ * (both required) — a panel that omits `fromDay`/`toDay` here means "no lower/upper bound", not "default
+ * trailing 30 days", matching what an unscoped reliability query already means on the SPI. */
+function toToolStatsRange(query) {
+    const from = query && isIsoDay(query.fromDay) ? query.fromDay : undefined;
+    const to = query && isIsoDay(query.toDay) ? query.toDay : undefined;
+    return { ...(from !== undefined ? { from } : {}), ...(to !== undefined ? { to } : {}) };
+}
+/** stat → total runs over the range. */
+export function agentRunsTotalProvider() {
+    return reliabilityProvider('agent.runs.total', (metrics) => ({ value: metrics.runs }));
+}
+/** stat → completed/total success rate over the range. */
+export function agentRunsSuccessRateProvider() {
+    return reliabilityProvider('agent.runs.successRate', (metrics) => ({
+        value: metrics.successRate,
+    }));
+}
+/** stat → failed run count over the range. */
+export function agentRunsFailedProvider() {
+    return reliabilityProvider('agent.runs.failed', (metrics) => ({ value: metrics.failed }));
+}
+/**
+ * stat → MEAN settled-run duration over the range. Not a percentile: `RunReliability` exposes only
+ * `avgDurationMs` (see this file's header) — there is no p50/p95 to select between, unlike the Nest
+ * reference's `query.metric` switch. `null` (no settled runs) resolves to 0.
+ */
+export function agentRunsDurationProvider() {
+    return reliabilityProvider('agent.runs.duration', (metrics) => ({
+        value: metrics.avgDurationMs ?? 0,
+    }));
+}
+/** table → run/failure rollup per agent (empty when the adapter predates `byAgent`). */
+export function agentRunsByAgentTableProvider() {
+    return reliabilityProvider('agent.runs.byAgent', (metrics) => ({
+        rows: (metrics.byAgent ?? []).map((row) => ({
+            agentName: row.agentName ?? NO_VALUE,
+            runs: row.runs,
+            failed: row.failed,
+        })),
+    }));
+}
+/** timeseries → daily runs + failures trend (empty when the adapter predates `trend`). */
+export function agentRunsTrendProvider() {
+    return reliabilityProvider('agent.runs.trend', (metrics) => ({
+        rows: (metrics.trend ?? []).map((point) => ({ label: point.day, runs: point.runs, failed: point.failed })),
+    }));
+}
+/** table → most recent runs (newest first), via `listRuns`' first page — see this file's header for
+ * why this isn't the paged-table protocol. errorMessage capped per {@link capErrorMessage}. */
+export function agentRecentRunsTableProvider() {
+    return {
+        name: 'agent.runs.recent',
+        async resolve(query, _ctx) {
+            const queries = getTelescopeGovernanceQueries();
+            if (!queries)
+                return { rows: [] };
+            const limit = resolveLimit(query, DEFAULT_RECENT_LIMIT);
+            const { runs } = await queries.listRuns({ limit });
+            return {
+                rows: runs.map((row) => ({
+                    startedAt: row.startedAt,
+                    runId: row.runId,
+                    threadId: row.threadId,
+                    actorRef: row.actorRef,
+                    agentName: row.agentName ?? NO_VALUE,
+                    status: row.status,
+                    durationMs: row.durationMs ?? NO_VALUE,
+                    stepCount: row.stepCount,
+                    costUsd: row.costUsd ?? NO_VALUE,
+                    error: capErrorMessage(row.error),
+                })),
+            };
+        },
+    };
+}
+/** table → most recent tool calls (newest first), from the durable read-model. */
+export function agentRecentToolCallsTableProvider() {
+    return governanceProvider('agent.tools.recent', (query) => resolveLimit(query, DEFAULT_RECENT_LIMIT), (queries, limit) => queries.recentToolCalls(limit), (rows) => ({ rows }));
+}
+/** table → most recently active threads, with rolled-up message/token counts. */
+export function agentRecentThreadsTableProvider() {
+    return governanceProvider('agent.threads.recent', (query) => resolveLimit(query, DEFAULT_RECENT_LIMIT), (queries, limit) => queries.recentThreads(limit), (rows) => ({ rows }));
+}
+/**
+ * stat → an APPROXIMATE count of tool calls sitting `pending_approval`, capped at
+ * {@link MAX_RECENT_LIMIT}. `AgentGovernanceQueries.pendingApprovals` has no `total` — unlike the
+ * Nest reference's exact `approvalsPage({ page: 1, pageSize: 1 }).total`, there is no cheap "how
+ * many, without listing them" query on this SPI (see this file's header). A backlog past the cap
+ * undercounts here exactly the way Nest's OLD `pendingApprovals(500).length` did before it got an
+ * exact query — that regression is accepted, not fixed, until `AgentGovernanceQueries` grows one.
+ */
+export function agentPendingApprovalsCountProvider() {
+    return {
+        name: 'agent.approvals.pending',
+        async resolve(_query, _ctx) {
+            const queries = getTelescopeGovernanceQueries();
+            if (!queries)
+                return { value: 0 };
+            const rows = await queries.pendingApprovals({ limit: MAX_RECENT_LIMIT });
+            return { value: rows.length };
+        },
+    };
+}
+/** table → the pending-approvals inbox, oldest request first. */
+export function agentPendingApprovalsTableProvider() {
+    return governanceProvider('agent.approvals.recent', (query) => resolveLimit(query, DEFAULT_RECENT_LIMIT), (queries, limit) => queries.pendingApprovals({ limit }), (rows) => ({
+        rows: rows.map((row) => ({
+            toolCallId: row.toolCallId,
+            toolName: row.toolName,
+            threadId: row.threadId,
+            actorRef: row.actorRef,
+            requestedAt: row.requestedAt,
+            runId: row.runId,
+        })),
+    }));
+}
+/** table → per-tool call/failure/rejection/latency rollup over the range. Only ONE latency column
+ * (`avgDurationMs`) — `PerToolStatRow` has no p50/p95 split, unlike the Nest reference's table. */
+export function agentToolStatsTableProvider() {
+    return governanceProvider('agent.tools.stats', toToolStatsRange, (queries, range) => queries.perToolStats(range), (rows) => ({
+        rows: rows.map((row) => ({
+            toolName: row.toolName,
+            toolType: row.toolType,
+            calls: row.calls,
+            failed: row.failed,
+            rejected: row.rejected,
+            avgDurationMs: row.avgDurationMs ?? NO_VALUE,
+        })),
+    }));
+}
+//# sourceMappingURL=agent-governance-providers.js.map

package/dist/src/telescope/agent-governance-providers.js.map

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

package/dist/src/telescope/dashboard.d.ts

@@ -1,21 +1,41 @@
-import type { DashboardSpec } from './telescope-sdk.js';
+import type { DashboardSection, DashboardSpec } from './telescope-sdk.js';
 /** Options for the agent "Agent" dashboard. */
 export interface AgentDashboardOptions {
     /**
      * URL template for deep-linking a run row (a `LinkSpec.href` with `{key}` placeholders filled from the
-     * row, e.g. `/agent/runs/{runId}`). Applied to the `runId` column of the runs, tool-calls, approvals
-     * and delegations tables. Omit to render plain run ids with no link.
+     * row, e.g. `/agent/runs/{runId}`). Applied to the `runId` column of every table below that carries one
+     * (the entry-backed runs/tool-calls/approvals/delegations tables, AND the governance-backed
+     * runs/tool-calls/approvals tables). Omit to render plain run ids with no link.
      */
     runHref?: string;
-    /** URL template for deep-linking a thread from the recent-runs table, e.g. `/agent/threads/{thread}`. */
+    /**
+     * URL template for deep-linking a thread, e.g. `/agent/threads/{thread}`. Applied to the entry-backed
+     * recent-runs table's `thread` column and the governance-backed tables' `threadId` column (two
+     * different keys — see `data-providers.ts` vs `agent-governance-providers.ts` for why the entry-backed
+     * table renames the field and the governance-backed ones don't).
+     */
     threadHref?: string;
+    /**
+     * HOST-contributed dashboard sections, appended after the built-in ones. Bind their panels to a
+     * provider passed via `agentTelescopeExtension({ providers })`, or to any built-in `agent.*`
+     * provider. Size each section's panel count to an exact multiple of its `cols` where practical — the
+     * renderer lays a section out as a fixed grid with no `colSpan`, so an orphan panel leaves a visible
+     * hole beside it. That's a layout nicety, not something validated here.
+     */
+    sections?: DashboardSection[];
 }
 /**
- * The "Agent" overview dashboard — run health up top (active runs / token usage / tool-call success
- * rate), then run activity (runs over-time + recent finished runs), then tools & approvals (tool-call
- * volume by status, recent tool calls, recent approval decisions), then delegations & token throughput.
+ * The "Agent" overview dashboard. Four ENTRY-BACKED sections (unchanged from before this port — see
+ * `data-providers.ts`): run health, run activity, tools & approvals, delegations & tokens. Then two
+ * GOVERNANCE-BACKED sections reading the authoritative, restart-surviving read-model (see
+ * `agent-governance-providers.ts` for exactly what that read-model can and can't answer on this SPI):
+ * spend/usage and run reliability + governance activity feeds. Then RAG (see `rag-data-providers.ts`
+ * for the honest, partial scope: retrieval counts/zero-hit-rate/mean-chunks/trend only — no latency,
+ * scores, or store/collection breakdown, because the recorded event doesn't carry them).
+ *
  * Pure data: panels bind to the `agent.*` data providers by name; the `*Href` options add an optional
- * `LinkSpec` on the id columns so a host agent SPA can deep-link a row.
+ * `LinkSpec` on the id columns so a host agent SPA can deep-link a row. `opts.sections` appends
+ * host-contributed sections after the built-in ones (see `AgentDashboardOptions.sections`).
  */
 export declare function agentDashboard(opts?: AgentDashboardOptions): DashboardSpec;
 //# sourceMappingURL=dashboard.d.ts.map

package/dist/src/telescope/dashboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../../src/telescope/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEhE,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yGAAyG;IACzG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,qBAA0B,GAAG,aAAa,CAoI9E"}
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../../src/telescope/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAElF,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,qBAA0B,GAAG,aAAa,CAoW9E"}

package/dist/src/telescope/dashboard.js

@@ -1,15 +1,24 @@
 /**
- * The "Agent" overview dashboard — run health up top (active runs / token usage / tool-call success
- * rate), then run activity (runs over-time + recent finished runs), then tools & approvals (tool-call
- * volume by status, recent tool calls, recent approval decisions), then delegations & token throughput.
+ * The "Agent" overview dashboard. Four ENTRY-BACKED sections (unchanged from before this port — see
+ * `data-providers.ts`): run health, run activity, tools & approvals, delegations & tokens. Then two
+ * GOVERNANCE-BACKED sections reading the authoritative, restart-surviving read-model (see
+ * `agent-governance-providers.ts` for exactly what that read-model can and can't answer on this SPI):
+ * spend/usage and run reliability + governance activity feeds. Then RAG (see `rag-data-providers.ts`
+ * for the honest, partial scope: retrieval counts/zero-hit-rate/mean-chunks/trend only — no latency,
+ * scores, or store/collection breakdown, because the recorded event doesn't carry them).
+ *
  * Pure data: panels bind to the `agent.*` data providers by name; the `*Href` options add an optional
- * `LinkSpec` on the id columns so a host agent SPA can deep-link a row.
+ * `LinkSpec` on the id columns so a host agent SPA can deep-link a row. `opts.sections` appends
+ * host-contributed sections after the built-in ones (see `AgentDashboardOptions.sections`).
  */
 export function agentDashboard(opts = {}) {
     const runCol = (label) => opts.runHref ? { key: 'runId', label, link: { href: opts.runHref } } : { key: 'runId', label };
     const threadCol = opts.threadHref
         ? { key: 'thread', label: 'Thread', link: { href: opts.threadHref } }
         : { key: 'thread', label: 'Thread' };
+    const threadIdCol = opts.threadHref
+        ? { key: 'threadId', label: 'Thread', link: { href: opts.threadHref } }
+        : { key: 'threadId', label: 'Thread' };
     return {
         id: 'agent.overview',
         label: 'Agent',
@@ -134,6 +143,226 @@ export function agentDashboard(opts = {}) {
                     },
                 ],
             },
+            {
+                title: 'Spend & usage',
+                cols: 3,
+                panels: [
+                    {
+                        kind: 'stat',
+                        title: 'Total spend (USD)',
+                        data: { provider: 'agent.spend.totalCost' },
+                        format: 'number',
+                    },
+                    {
+                        kind: 'stat',
+                        title: 'Total tokens',
+                        data: { provider: 'agent.spend.totalTokens' },
+                        format: 'number',
+                    },
+                    {
+                        kind: 'breakdown',
+                        title: 'Spend by model',
+                        data: { provider: 'agent.spend.byModel' },
+                        style: 'donut',
+                    },
+                ],
+            },
+            {
+                title: 'Spend detail',
+                cols: 2,
+                panels: [
+                    {
+                        kind: 'table',
+                        title: 'Spend by model',
+                        data: { provider: 'agent.spend.byModelTable' },
+                        columns: [
+                            { key: 'modelId', label: 'Model' },
+                            { key: 'requests', label: 'Requests' },
+                            { key: 'inputTokens', label: 'Input tokens' },
+                            { key: 'outputTokens', label: 'Output tokens' },
+                            { key: 'costUsd', label: 'Cost (USD)' },
+                        ],
+                    },
+                    {
+                        kind: 'table',
+                        title: 'Spend by actor',
+                        data: { provider: 'agent.spend.byActor' },
+                        columns: [
+                            { key: 'actorRef', label: 'Actor' },
+                            { key: 'requests', label: 'Requests' },
+                            { key: 'totalTokens', label: 'Tokens' },
+                            { key: 'costUsd', label: 'Cost (USD)' },
+                        ],
+                    },
+                    {
+                        kind: 'breakdown',
+                        title: 'Spend by actor',
+                        data: { provider: 'agent.spend.byActorShare' },
+                        style: 'donut',
+                    },
+                    {
+                        kind: 'timeseries',
+                        title: 'Usage trend',
+                        data: { provider: 'agent.usage.trend' },
+                        series: ['costUsd', 'totalTokens'],
+                        style: 'area',
+                    },
+                ],
+            },
+            {
+                title: 'Run reliability',
+                cols: 3,
+                panels: [
+                    { kind: 'stat', title: 'Runs', data: { provider: 'agent.runs.total' }, format: 'number' },
+                    {
+                        kind: 'gauge',
+                        title: 'Success rate',
+                        data: { provider: 'agent.runs.successRate' },
+                        max: 1,
+                        format: 'percent',
+                        thresholds: { warn: 0.95, bad: 0.9, direction: 'down-bad' },
+                    },
+                    {
+                        kind: 'stat',
+                        title: 'Failed runs',
+                        data: { provider: 'agent.runs.failed' },
+                        format: 'number',
+                    },
+                    {
+                        kind: 'stat',
+                        title: 'Avg run duration',
+                        data: { provider: 'agent.runs.duration' },
+                        format: 'duration',
+                    },
+                    {
+                        kind: 'table',
+                        title: 'Runs by agent',
+                        data: { provider: 'agent.runs.byAgent' },
+                        columns: [
+                            { key: 'agentName', label: 'Agent' },
+                            { key: 'runs', label: 'Runs' },
+                            { key: 'failed', label: 'Failed' },
+                        ],
+                    },
+                    {
+                        kind: 'timeseries',
+                        title: 'Runs trend',
+                        data: { provider: 'agent.runs.trend' },
+                        series: ['runs', 'failed'],
+                        style: 'stacked',
+                    },
+                ],
+            },
+            {
+                title: 'Governance activity',
+                cols: 2,
+                panels: [
+                    {
+                        kind: 'table',
+                        title: 'Recent runs',
+                        data: { provider: 'agent.runs.recent' },
+                        columns: [
+                            { key: 'startedAt', label: 'Started' },
+                            runCol('Run'),
+                            threadIdCol,
+                            { key: 'actorRef', label: 'Actor' },
+                            { key: 'agentName', label: 'Agent' },
+                            { key: 'status', label: 'Status' },
+                            { key: 'durationMs', label: 'Duration (ms)' },
+                            { key: 'costUsd', label: 'Cost (USD)' },
+                            { key: 'error', label: 'Error' },
+                        ],
+                    },
+                    {
+                        kind: 'table',
+                        title: 'Recent tool calls',
+                        data: { provider: 'agent.tools.recent' },
+                        columns: [
+                            { key: 'createdAt', label: 'Time' },
+                            { key: 'toolName', label: 'Tool' },
+                            { key: 'toolType', label: 'Type' },
+                            { key: 'status', label: 'Status' },
+                            threadIdCol,
+                        ],
+                    },
+                    {
+                        kind: 'table',
+                        title: 'Recent threads',
+                        data: { provider: 'agent.threads.recent' },
+                        columns: [
+                            { key: 'lastActivityAt', label: 'Last activity' },
+                            { key: 'title', label: 'Title' },
+                            { key: 'actorRef', label: 'Actor' },
+                            { key: 'messageCount', label: 'Messages' },
+                            { key: 'totalTokens', label: 'Tokens' },
+                        ],
+                    },
+                    {
+                        kind: 'stat',
+                        title: 'Pending approvals',
+                        data: { provider: 'agent.approvals.pending' },
+                        format: 'number',
+                    },
+                    {
+                        kind: 'table',
+                        title: 'Approvals inbox',
+                        data: { provider: 'agent.approvals.recent' },
+                        columns: [
+                            { key: 'requestedAt', label: 'Requested' },
+                            runCol('Run'),
+                            { key: 'toolName', label: 'Tool' },
+                            threadIdCol,
+                            { key: 'actorRef', label: 'Actor' },
+                        ],
+                    },
+                    {
+                        kind: 'table',
+                        title: 'Tool stats',
+                        data: { provider: 'agent.tools.stats' },
+                        columns: [
+                            { key: 'toolName', label: 'Tool' },
+                            { key: 'toolType', label: 'Type' },
+                            { key: 'calls', label: 'Calls' },
+                            { key: 'failed', label: 'Failed' },
+                            { key: 'rejected', label: 'Rejected' },
+                            { key: 'avgDurationMs', label: 'Avg (ms)' },
+                        ],
+                    },
+                ],
+            },
+            {
+                title: 'RAG',
+                cols: 2,
+                panels: [
+                    {
+                        kind: 'stat',
+                        title: 'Retrievals',
+                        data: { provider: 'agent.rag.retrievals' },
+                        format: 'number',
+                    },
+                    {
+                        kind: 'stat',
+                        title: 'Zero-hit rate',
+                        data: { provider: 'agent.rag.zeroHitRate' },
+                        format: 'percent',
+                        thresholds: { warn: 0.1, bad: 0.25, direction: 'up-bad' },
+                    },
+                    {
+                        kind: 'stat',
+                        title: 'Mean chunks',
+                        data: { provider: 'agent.rag.chunks' },
+                        format: 'number',
+                    },
+                    {
+                        kind: 'timeseries',
+                        title: 'Retrieval trend',
+                        data: { provider: 'agent.rag.trend' },
+                        series: ['retrievals', 'zeroHits'],
+                        style: 'area',
+                    },
+                ],
+            },
+            ...(opts.sections ?? []),
         ],
     };
 }