@adonis-agora/agent-dashboard 0.1.0

package/dist/spa/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>agent · governance console</title>
+    <script type="module" crossorigin src="./assets/index-DR5D-Xzw.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-BYLm0nq8.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/dist/src/client/agent-client.d.ts

@@ -0,0 +1,55 @@
+import type { ActorSpendRow, GovernanceRange, ListRunsFilter, ListRunsResult, ModelSpendRow, PendingApprovalRow, PendingApprovalsFilter, PerToolStatRow, QuotaToday, RunDetail, RunReliability, ThreadActivityRow, ToolCallActivityRow, ToolStatsRange, UsageTrendPoint } from './types.js';
+/** Thrown on a non-2xx governance response, carrying the HTTP status for the UI to branch on. */
+export declare class AgentApiError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+type FetchLike = typeof fetch;
+export interface AgentClientOptions {
+    /** Agent API base (e.g. `/agent`). Defaults to the injected/derived base for the current page. */
+    baseUrl?: string;
+    /** Injectable `fetch` (tests pass a stub). Defaults to the global. */
+    fetch?: FetchLike;
+    /** Cap for the `recent*` feeds; the server clamps to 200. Defaults to 50. */
+    limit?: number;
+}
+/**
+ * A framework-free browser client for the `@adonis-agora/agent` provider's READ surface: the five
+ * `/agent/governance/*` rollups plus the per-actor `quota/today`. Same-origin, `credentials:
+ * 'same-origin'` so the host's actor/auth cookie gates every call exactly as it gates the routes
+ * server-side. No third-party HTTP dependency.
+ */
+export declare class AgentClient {
+    private readonly base;
+    private readonly doFetch;
+    private readonly limit;
+    constructor(options?: AgentClientOptions);
+    private get;
+    private post;
+    spendByModel(range: GovernanceRange): Promise<ModelSpendRow[]>;
+    spendByActor(range: GovernanceRange): Promise<ActorSpendRow[]>;
+    usageTrend(range: GovernanceRange): Promise<UsageTrendPoint[]>;
+    recentToolCalls(limit?: number): Promise<ToolCallActivityRow[]>;
+    recentThreads(limit?: number): Promise<ThreadActivityRow[]>;
+    quotaToday(): Promise<QuotaToday>;
+    /** `GET /agent/governance/runs` — filterable, cursor-paginated run list, newest-first. */
+    listRuns(filter?: ListRunsFilter): Promise<ListRunsResult>;
+    /** `GET /agent/governance/runs/:id` — one run's full trace, or `null` if unknown. */
+    runDetail(runId: string): Promise<RunDetail | null>;
+    /** `GET /agent/governance/approvals/pending` — cross-thread HITL inbox, oldest first. */
+    pendingApprovals(filter?: PendingApprovalsFilter): Promise<PendingApprovalRow[]>;
+    /** `GET /agent/governance/tools/stats` — per-tool call/failure/rejection/latency rollup. */
+    perToolStats(range?: ToolStatsRange): Promise<PerToolStatRow[]>;
+    /** `GET /agent/governance/reliability` — success/failure/cancel rates + mean settled duration. */
+    runReliability(range?: ToolStatsRange): Promise<RunReliability>;
+    /** `POST /agent/tool-call/approve` — release a `pending_approval` tool call. */
+    approveToolCall(runId: string, toolCallId: string): Promise<{
+        ok: boolean;
+    }>;
+    /** `POST /agent/tool-call/reject` — deny a `pending_approval` tool call, with an optional reason. */
+    rejectToolCall(runId: string, toolCallId: string, reason?: string): Promise<{
+        ok: boolean;
+    }>;
+}
+export {};
+//# sourceMappingURL=agent-client.d.ts.map

package/dist/src/client/agent-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-client.d.ts","sourceRoot":"","sources":["../../../src/client/agent-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,UAAU,EACV,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,iGAAiG;AACjG,qBAAa,aAAc,SAAQ,KAAK;IAGpC,QAAQ,CAAC,MAAM,EAAE,MAAM;gBADvB,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM;CAK1B;AAED,KAAK,SAAS,GAAG,OAAO,KAAK,CAAC;AAE9B,MAAM,WAAW,kBAAkB;IACjC,kGAAkG;IAClG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,GAAE,kBAAuB;YAM9B,GAAG;YAcH,IAAI;IAalB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAO9D,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAO9D,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAO9D,eAAe,CAAC,KAAK,SAAa,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAMnE,aAAa,CAAC,KAAK,SAAa,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAI/D,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAMjC,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,GAAE,cAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAW9D,qFAAqF;IACrF,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAInD,yFAAyF;IACzF,gBAAgB,CAAC,MAAM,GAAE,sBAA2B,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAMpF,4FAA4F;IAC5F,YAAY,CAAC,KAAK,GAAE,cAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAOnE,kGAAkG;IAClG,cAAc,CAAC,KAAK,GAAE,cAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IASnE,gFAAgF;IAChF,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;IAI5E,qGAAqG;IACrG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;CAO7F"}

package/dist/src/client/agent-client.js

@@ -0,0 +1,141 @@
+import { resolveApiBase } from './api-base.js';
+/** Thrown on a non-2xx governance response, carrying the HTTP status for the UI to branch on. */
+export class AgentApiError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = 'AgentApiError';
+    }
+}
+/**
+ * A framework-free browser client for the `@adonis-agora/agent` provider's READ surface: the five
+ * `/agent/governance/*` rollups plus the per-actor `quota/today`. Same-origin, `credentials:
+ * 'same-origin'` so the host's actor/auth cookie gates every call exactly as it gates the routes
+ * server-side. No third-party HTTP dependency.
+ */
+export class AgentClient {
+    base;
+    doFetch;
+    limit;
+    constructor(options = {}) {
+        this.base = (options.baseUrl ?? resolveApiBase()).replace(/\/+$/, '');
+        this.doFetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.limit = options.limit ?? 50;
+    }
+    async get(path, query = {}) {
+        const search = new URLSearchParams(query).toString();
+        const url = `${this.base}${path}${search ? `?${search}` : ''}`;
+        const response = await this.doFetch(url, {
+            method: 'GET',
+            headers: { accept: 'application/json' },
+            credentials: 'same-origin',
+        });
+        if (!response.ok) {
+            throw new AgentApiError(`GET ${path} failed (${response.status})`, response.status);
+        }
+        return (await response.json());
+    }
+    async post(path, body) {
+        const response = await this.doFetch(`${this.base}${path}`, {
+            method: 'POST',
+            headers: { accept: 'application/json', 'content-type': 'application/json' },
+            credentials: 'same-origin',
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            throw new AgentApiError(`POST ${path} failed (${response.status})`, response.status);
+        }
+        return (await response.json());
+    }
+    spendByModel(range) {
+        return this.get('/governance/spend/model', {
+            from: range.fromDay,
+            to: range.toDay,
+        });
+    }
+    spendByActor(range) {
+        return this.get('/governance/spend/actor', {
+            from: range.fromDay,
+            to: range.toDay,
+        });
+    }
+    usageTrend(range) {
+        return this.get('/governance/usage/trend', {
+            from: range.fromDay,
+            to: range.toDay,
+        });
+    }
+    recentToolCalls(limit = this.limit) {
+        return this.get('/governance/tool-calls/recent', {
+            limit: String(limit),
+        });
+    }
+    recentThreads(limit = this.limit) {
+        return this.get('/governance/threads/recent', { limit: String(limit) });
+    }
+    quotaToday() {
+        return this.get('/quota/today');
+    }
+    // ── Run lifecycle governance (the run-tracking read-model). ─────────────────
+    /** `GET /agent/governance/runs` — filterable, cursor-paginated run list, newest-first. */
+    listRuns(filter = {}) {
+        const query = { limit: String(filter.limit ?? this.limit) };
+        if (filter.actor)
+            query.actor = filter.actor;
+        if (filter.agent)
+            query.agent = filter.agent;
+        if (filter.status)
+            query.status = filter.status;
+        if (filter.from)
+            query.from = filter.from;
+        if (filter.to)
+            query.to = filter.to;
+        if (filter.cursor)
+            query.cursor = filter.cursor;
+        return this.get('/governance/runs', query);
+    }
+    /** `GET /agent/governance/runs/:id` — one run's full trace, or `null` if unknown. */
+    runDetail(runId) {
+        return this.get(`/governance/runs/${encodeURIComponent(runId)}`);
+    }
+    /** `GET /agent/governance/approvals/pending` — cross-thread HITL inbox, oldest first. */
+    pendingApprovals(filter = {}) {
+        const query = { limit: String(filter.limit ?? this.limit) };
+        if (filter.actor)
+            query.actor = filter.actor;
+        return this.get('/governance/approvals/pending', query);
+    }
+    /** `GET /agent/governance/tools/stats` — per-tool call/failure/rejection/latency rollup. */
+    perToolStats(range = {}) {
+        const query = {};
+        if (range.from)
+            query.from = range.from;
+        if (range.to)
+            query.to = range.to;
+        return this.get('/governance/tools/stats', query);
+    }
+    /** `GET /agent/governance/reliability` — success/failure/cancel rates + mean settled duration. */
+    runReliability(range = {}) {
+        const query = {};
+        if (range.from)
+            query.from = range.from;
+        if (range.to)
+            query.to = range.to;
+        return this.get('/governance/reliability', query);
+    }
+    // ── HITL decisions — the EXISTING mutating routes the approvals inbox wires to. ──
+    /** `POST /agent/tool-call/approve` — release a `pending_approval` tool call. */
+    approveToolCall(runId, toolCallId) {
+        return this.post('/tool-call/approve', { runId, toolCallId });
+    }
+    /** `POST /agent/tool-call/reject` — deny a `pending_approval` tool call, with an optional reason. */
+    rejectToolCall(runId, toolCallId, reason) {
+        return this.post('/tool-call/reject', {
+            runId,
+            toolCallId,
+            ...(reason ? { reason } : {}),
+        });
+    }
+}
+//# sourceMappingURL=agent-client.js.map

package/dist/src/client/agent-client.js.map

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

package/dist/src/client/api-base.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Resolve the base URL of the agent routes the SPA calls. The provider injects the exact base it
+ * mounted the agent under as `window.__AGENT_DASHBOARD_BASE__` when it serves `index.html`; when that
+ * is absent (e.g. the standalone `vite dev` preview) we derive it from the page's own location by
+ * stripping the trailing `/dashboard` mount segment. Either way the SPA never hard-codes `/agent`.
+ */
+declare global {
+    interface Window {
+        __AGENT_DASHBOARD_BASE__?: string;
+    }
+}
+/**
+ * Derive the agent API base from the dashboard's own `pathname`. The dashboard is mounted at
+ * `<agentBase>/dashboard`, so we drop that last segment: `/agent/dashboard` → `/agent`,
+ * `/api/agent/dashboard/` → `/api/agent`. A pathname that does not end in `/dashboard` is returned
+ * cleaned (trailing slash removed) as a best-effort base.
+ */
+export declare function deriveApiBase(pathname: string): string;
+/** The resolved agent API base for this page (injected value wins, else location-derived). */
+export declare function resolveApiBase(win?: Pick<Window, 'location'> & {
+    __AGENT_DASHBOARD_BASE__?: string;
+}): string;
+//# sourceMappingURL=api-base.d.ts.map

package/dist/src/client/api-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-base.d.ts","sourceRoot":"","sources":["../../../src/client/api-base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,wBAAwB,CAAC,EAAE,MAAM,CAAC;KACnC;CACF;AAOD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED,8FAA8F;AAC9F,wBAAgB,cAAc,CAC5B,GAAG,GAAE,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG;IAAE,wBAAwB,CAAC,EAAE,MAAM,CAAA;CAAW,GAC7E,MAAM,CAIR"}

package/dist/src/client/api-base.js

@@ -0,0 +1,32 @@
+/**
+ * Resolve the base URL of the agent routes the SPA calls. The provider injects the exact base it
+ * mounted the agent under as `window.__AGENT_DASHBOARD_BASE__` when it serves `index.html`; when that
+ * is absent (e.g. the standalone `vite dev` preview) we derive it from the page's own location by
+ * stripping the trailing `/dashboard` mount segment. Either way the SPA never hard-codes `/agent`.
+ */
+/** Strip a trailing `/` (but never reduce `/` itself to `''`). */
+function stripTrailingSlash(path) {
+    return path.length > 1 ? path.replace(/\/+$/, '') : path;
+}
+/**
+ * Derive the agent API base from the dashboard's own `pathname`. The dashboard is mounted at
+ * `<agentBase>/dashboard`, so we drop that last segment: `/agent/dashboard` → `/agent`,
+ * `/api/agent/dashboard/` → `/api/agent`. A pathname that does not end in `/dashboard` is returned
+ * cleaned (trailing slash removed) as a best-effort base.
+ */
+export function deriveApiBase(pathname) {
+    const clean = stripTrailingSlash(pathname);
+    if (clean.endsWith('/dashboard')) {
+        const base = clean.slice(0, -'/dashboard'.length);
+        return base === '' ? '/' : base;
+    }
+    return clean === '' ? '/' : clean;
+}
+/** The resolved agent API base for this page (injected value wins, else location-derived). */
+export function resolveApiBase(win = window) {
+    const injected = win.__AGENT_DASHBOARD_BASE__;
+    if (typeof injected === 'string' && injected !== '')
+        return stripTrailingSlash(injected);
+    return deriveApiBase(win.location.pathname);
+}
+//# sourceMappingURL=api-base.js.map

package/dist/src/client/api-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-base.js","sourceRoot":"","sources":["../../../src/client/api-base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,kEAAkE;AAClE,SAAS,kBAAkB,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AACpC,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,cAAc,CAC5B,MAAwE,MAAM;IAE9E,MAAM,QAAQ,GAAG,GAAG,CAAC,wBAAwB,CAAC;IAC9C,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACzF,OAAO,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC"}

package/dist/src/client/default-range.d.ts

@@ -0,0 +1,10 @@
+import type { GovernanceRange } from './types.js';
+/** `YYYY-MM-DD` for the UTC day `offsetDays` before `now` (negative → past). */
+export declare function utcDay(now: Date, offsetDays?: number): string;
+/** True for a well-formed `YYYY-MM-DD` calendar day. */
+export declare function isIsoDay(value: string): boolean;
+/** The default range: the trailing `days` UTC days ending today (inclusive), default 7. */
+export declare function defaultRange(now?: Date, days?: number): GovernanceRange;
+/** Coerce a possibly-invalid range into a valid one, falling back to {@link defaultRange}. */
+export declare function normalizeRange(range: Partial<GovernanceRange>, now?: Date): GovernanceRange;
+//# sourceMappingURL=default-range.d.ts.map

package/dist/src/client/default-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-range.d.ts","sourceRoot":"","sources":["../../../src/client/default-range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,gFAAgF;AAChF,wBAAgB,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,SAAI,GAAG,MAAM,CAGxD;AAED,wDAAwD;AACxD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAI/C;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,GAAG,GAAE,IAAiB,EAAE,IAAI,SAAI,GAAG,eAAe,CAG9E;AAED,8FAA8F;AAC9F,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,EAC/B,GAAG,GAAE,IAAiB,GACrB,eAAe,CAMjB"}

package/dist/src/client/default-range.js

@@ -0,0 +1,26 @@
+/** `YYYY-MM-DD` for the UTC day `offsetDays` before `now` (negative → past). */
+export function utcDay(now, offsetDays = 0) {
+    const d = new Date(now.getTime() + offsetDays * 86_400_000);
+    return d.toISOString().slice(0, 10);
+}
+/** True for a well-formed `YYYY-MM-DD` calendar day. */
+export function isIsoDay(value) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value))
+        return false;
+    const time = Date.parse(`${value}T00:00:00.000Z`);
+    return !Number.isNaN(time) && value === new Date(time).toISOString().slice(0, 10);
+}
+/** The default range: the trailing `days` UTC days ending today (inclusive), default 7. */
+export function defaultRange(now = new Date(), days = 7) {
+    const span = Math.max(1, Math.floor(days));
+    return { fromDay: utcDay(now, -(span - 1)), toDay: utcDay(now, 0) };
+}
+/** Coerce a possibly-invalid range into a valid one, falling back to {@link defaultRange}. */
+export function normalizeRange(range, now = new Date()) {
+    const fallback = defaultRange(now);
+    const fromDay = range.fromDay && isIsoDay(range.fromDay) ? range.fromDay : fallback.fromDay;
+    const toDay = range.toDay && isIsoDay(range.toDay) ? range.toDay : fallback.toDay;
+    // Guard an inverted range (from after to) by swapping.
+    return fromDay <= toDay ? { fromDay, toDay } : { fromDay: toDay, toDay: fromDay };
+}
+//# sourceMappingURL=default-range.js.map

package/dist/src/client/default-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-range.js","sourceRoot":"","sources":["../../../src/client/default-range.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,MAAM,UAAU,MAAM,CAAC,GAAS,EAAE,UAAU,GAAG,CAAC;IAC9C,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC;IAC5D,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,gBAAgB,CAAC,CAAC;IAClD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACpF,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,YAAY,CAAC,MAAY,IAAI,IAAI,EAAE,EAAE,IAAI,GAAG,CAAC;IAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,cAAc,CAC5B,KAA+B,EAC/B,MAAY,IAAI,IAAI,EAAE;IAEtB,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC5F,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;IAClF,uDAAuD;IACvD,OAAO,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACpF,CAAC"}

package/dist/src/client/format.d.ts

@@ -0,0 +1,22 @@
+/** Compact number / currency / model-label formatting for the console. All pure; unit-tested. */
+/** Format a USD amount. Small amounts keep precision; large ones read as `$1.20k` / `$3.40M`. */
+export declare function formatUsd(amount: number): string;
+/** Format a token/count with compact suffixes (`1.2k`, `3.4M`, `1.1B`). */
+export declare function formatCount(value: number): string;
+/** Format a 0..1 ratio as an integer percent (`0.1234` -> `12%`). */
+export declare function formatPercent(ratio: number): string;
+/**
+ * Format a millisecond duration compactly (`820ms`, `3.4s`, `2.1m`, `1.3h`). `null`/`undefined`/
+ * non-finite → `—` (used for still-running runs and tools that never recorded a latency).
+ */
+export declare function formatDuration(ms: number | null | undefined): string;
+/**
+ * Shorten a raw model id for display. Bedrock inference-profile ARNs
+ * (`arn:aws:bedrock:…:inference-profile/<region>.<provider>.<model>`) overflow cards, so we keep the
+ * distinguishing `<model>` and drop the ARN prefix plus the region/provider qualifiers. Non-ARN ids
+ * (e.g. `gpt-4o`) pass through unchanged; the full id is surfaced via a `title` tooltip at call sites.
+ */
+export declare function formatModelLabel(modelId: string): string;
+/** Format an ISO timestamp as a short, locale-stable `MMM D, HH:MM` label; `''`/invalid → `—`. */
+export declare function formatTimestamp(iso: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/src/client/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/client/format.ts"],"names":[],"mappings":"AAAA,iGAAiG;AAEjG,iGAAiG;AACjG,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAQpE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED,kGAAkG;AAClG,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASnD"}

package/dist/src/client/format.js

@@ -0,0 +1,76 @@
+/** Compact number / currency / model-label formatting for the console. All pure; unit-tested. */
+/** Format a USD amount. Small amounts keep precision; large ones read as `$1.20k` / `$3.40M`. */
+export function formatUsd(amount) {
+    if (!Number.isFinite(amount))
+        return '$0.00';
+    const abs = Math.abs(amount);
+    if (abs >= 1_000_000)
+        return `$${(amount / 1_000_000).toFixed(2)}M`;
+    if (abs >= 1_000)
+        return `$${(amount / 1_000).toFixed(2)}k`;
+    if (abs > 0 && abs < 0.01)
+        return '<$0.01';
+    return `$${amount.toFixed(2)}`;
+}
+/** Format a token/count with compact suffixes (`1.2k`, `3.4M`, `1.1B`). */
+export function formatCount(value) {
+    if (!Number.isFinite(value))
+        return '0';
+    const abs = Math.abs(value);
+    if (abs >= 1_000_000_000)
+        return `${(value / 1_000_000_000).toFixed(1)}B`;
+    if (abs >= 1_000_000)
+        return `${(value / 1_000_000).toFixed(1)}M`;
+    if (abs >= 1_000)
+        return `${(value / 1_000).toFixed(1)}k`;
+    return `${Math.round(value)}`;
+}
+/** Format a 0..1 ratio as an integer percent (`0.1234` -> `12%`). */
+export function formatPercent(ratio) {
+    if (!Number.isFinite(ratio))
+        return '0%';
+    return `${Math.round(ratio * 100)}%`;
+}
+/**
+ * Format a millisecond duration compactly (`820ms`, `3.4s`, `2.1m`, `1.3h`). `null`/`undefined`/
+ * non-finite → `—` (used for still-running runs and tools that never recorded a latency).
+ */
+export function formatDuration(ms) {
+    if (ms === null || ms === undefined || !Number.isFinite(ms))
+        return '—';
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    const seconds = ms / 1000;
+    if (seconds < 60)
+        return `${seconds.toFixed(1)}s`;
+    const minutes = seconds / 60;
+    if (minutes < 60)
+        return `${minutes.toFixed(1)}m`;
+    return `${(minutes / 60).toFixed(1)}h`;
+}
+/**
+ * Shorten a raw model id for display. Bedrock inference-profile ARNs
+ * (`arn:aws:bedrock:…:inference-profile/<region>.<provider>.<model>`) overflow cards, so we keep the
+ * distinguishing `<model>` and drop the ARN prefix plus the region/provider qualifiers. Non-ARN ids
+ * (e.g. `gpt-4o`) pass through unchanged; the full id is surfaced via a `title` tooltip at call sites.
+ */
+export function formatModelLabel(modelId) {
+    if (!modelId.includes('/'))
+        return modelId;
+    const profile = modelId.slice(modelId.lastIndexOf('/') + 1);
+    return profile.replace(/^[a-z]{2}[a-z-]*\.[a-z0-9]+\./, '');
+}
+/** Format an ISO timestamp as a short, locale-stable `MMM D, HH:MM` label; `''`/invalid → `—`. */
+export function formatTimestamp(iso) {
+    if (iso === '')
+        return '—';
+    const date = new Date(iso);
+    if (Number.isNaN(date.getTime()))
+        return '—';
+    const month = date.toLocaleString('en-US', { month: 'short', timeZone: 'UTC' });
+    const day = date.getUTCDate();
+    const hh = String(date.getUTCHours()).padStart(2, '0');
+    const mm = String(date.getUTCMinutes()).padStart(2, '0');
+    return `${month} ${day}, ${hh}:${mm}`;
+}
+//# sourceMappingURL=format.js.map

package/dist/src/client/format.js.map

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

package/dist/src/client/index.d.ts

@@ -0,0 +1,9 @@
+export * from './types.js';
+export * from './format.js';
+export * from './default-range.js';
+export * from './spend-summary.js';
+export * from './trend-path.js';
+export * from './api-base.js';
+export { AgentClient, AgentApiError } from './agent-client.js';
+export type { AgentClientOptions } from './agent-client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/client/index.js

@@ -0,0 +1,8 @@
+export * from './types.js';
+export * from './format.js';
+export * from './default-range.js';
+export * from './spend-summary.js';
+export * from './trend-path.js';
+export * from './api-base.js';
+export { AgentClient, AgentApiError } from './agent-client.js';
+//# sourceMappingURL=index.js.map

package/dist/src/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/client/spend-summary.d.ts

@@ -0,0 +1,43 @@
+import type { ActorSpendRow, ModelSpendRow } from './types.js';
+/** Headline totals for a range, summed across every model row. */
+export interface SpendTotals {
+    costUsd: number;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    requests: number;
+}
+/** A model row enriched with its share (0..1) of total cost — for share bars / donut segments. */
+export interface ModelSpendShare extends ModelSpendRow {
+    totalTokens: number;
+    /** Fraction of total cost (0..1); falls back to token share when nothing is priced. */
+    costShare: number;
+}
+/** One donut arc segment: a normalized 0..1 slice with its cumulative offset (also 0..1). */
+export interface DonutSegment {
+    key: string;
+    value: number;
+    fraction: number;
+    offset: number;
+}
+/** Sum the by-model rows into the headline totals. */
+export declare function summarizeSpend(rows: ModelSpendRow[]): SpendTotals;
+/**
+ * Enrich each model row with its cost share, sorted by cost descending. When nothing has a cost
+ * (every model unpriced) the share falls back to token share so bars/donut still convey the usage
+ * mix instead of collapsing to zero.
+ */
+export declare function withShares(rows: ModelSpendRow[]): ModelSpendShare[];
+/**
+ * Build donut segments from the shared rows: each `fraction` is the row's `costShare` and `offset`
+ * is the running cumulative fraction (so an SVG can lay arcs end-to-end). Zero-share rows are dropped
+ * so the donut has no invisible slices.
+ */
+export declare function donutSegments(rows: ModelSpendShare[]): DonutSegment[];
+/** Total spend + tokens across the by-actor rows (headline for the actor panel). */
+export declare function summarizeActors(rows: ActorSpendRow[]): {
+    costUsd: number;
+    totalTokens: number;
+    requests: number;
+};
+//# sourceMappingURL=spend-summary.d.ts.map

package/dist/src/client/spend-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-summary.d.ts","sourceRoot":"","sources":["../../../src/client/spend-summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,kGAAkG;AAClG,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6FAA6F;AAC7F,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,WAAW,CAgBjE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,eAAe,EAAE,CAWnE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,YAAY,EAAE,CASrE;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,CASA"}

package/dist/src/client/spend-summary.js

@@ -0,0 +1,59 @@
+/** Sum the by-model rows into the headline totals. */
+export function summarizeSpend(rows) {
+    const totals = {
+        costUsd: 0,
+        inputTokens: 0,
+        outputTokens: 0,
+        totalTokens: 0,
+        requests: 0,
+    };
+    for (const row of rows) {
+        totals.costUsd += row.costUsd;
+        totals.inputTokens += row.inputTokens;
+        totals.outputTokens += row.outputTokens;
+        totals.requests += row.requests;
+    }
+    totals.totalTokens = totals.inputTokens + totals.outputTokens;
+    return totals;
+}
+/**
+ * Enrich each model row with its cost share, sorted by cost descending. When nothing has a cost
+ * (every model unpriced) the share falls back to token share so bars/donut still convey the usage
+ * mix instead of collapsing to zero.
+ */
+export function withShares(rows) {
+    const totalCost = rows.reduce((sum, row) => sum + row.costUsd, 0);
+    const totalTokens = rows.reduce((sum, row) => sum + row.inputTokens + row.outputTokens, 0);
+    return rows
+        .map((row) => {
+        const rowTokens = row.inputTokens + row.outputTokens;
+        const costShare = totalCost > 0 ? row.costUsd / totalCost : totalTokens > 0 ? rowTokens / totalTokens : 0;
+        return { ...row, totalTokens: rowTokens, costShare };
+    })
+        .sort((a, b) => b.costUsd - a.costUsd || b.totalTokens - a.totalTokens);
+}
+/**
+ * Build donut segments from the shared rows: each `fraction` is the row's `costShare` and `offset`
+ * is the running cumulative fraction (so an SVG can lay arcs end-to-end). Zero-share rows are dropped
+ * so the donut has no invisible slices.
+ */
+export function donutSegments(rows) {
+    const segments = [];
+    let offset = 0;
+    for (const row of rows) {
+        if (row.costShare <= 0)
+            continue;
+        segments.push({ key: row.modelId, value: row.costUsd, fraction: row.costShare, offset });
+        offset += row.costShare;
+    }
+    return segments;
+}
+/** Total spend + tokens across the by-actor rows (headline for the actor panel). */
+export function summarizeActors(rows) {
+    return rows.reduce((acc, row) => ({
+        costUsd: acc.costUsd + row.costUsd,
+        totalTokens: acc.totalTokens + row.totalTokens,
+        requests: acc.requests + row.requests,
+    }), { costUsd: 0, totalTokens: 0, requests: 0 });
+}
+//# sourceMappingURL=spend-summary.js.map

package/dist/src/client/spend-summary.js.map

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

package/dist/src/client/trend-path.d.ts

@@ -0,0 +1,27 @@
+import type { UsageTrendPoint } from './types.js';
+/** Which series a trend chart plots. */
+export type TrendMetric = 'costUsd' | 'totalTokens';
+/** A plotted point in SVG user space. */
+export interface TrendVertex {
+    day: string;
+    value: number;
+    x: number;
+    y: number;
+}
+/** Everything an SVG needs to draw a normalized area/line trend inside `width`x`height`. */
+export interface TrendGeometry {
+    /** `M..L..` polyline through every vertex (empty when there is nothing to plot). */
+    line: string;
+    /** Closed area path (line + baseline) for a filled gradient; empty when nothing to plot. */
+    area: string;
+    vertices: TrendVertex[];
+    /** Series max used to normalize the y-axis (floored to 1 so a flat/empty series still draws). */
+    max: number;
+}
+/**
+ * Project a daily trend series into SVG geometry. The x-axis spreads points evenly across `width`;
+ * the y-axis is normalized against the series max (inverted, since SVG y grows downward). A single
+ * point renders centered; an empty series yields empty paths and `max: 1`. Pure — no DOM.
+ */
+export declare function buildTrendGeometry(points: UsageTrendPoint[], metric: TrendMetric, width: number, height: number): TrendGeometry;
+//# sourceMappingURL=trend-path.d.ts.map

package/dist/src/client/trend-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trend-path.d.ts","sourceRoot":"","sources":["../../../src/client/trend-path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wCAAwC;AACxC,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;AAEpD,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,4FAA4F;AAC5F,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,4FAA4F;IAC5F,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,iGAAiG;IACjG,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,eAAe,EAAE,EACzB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,aAAa,CAsBf"}