@dudousxd/nestjs-agent-dashboard 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Davide Carvalho
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# @dudousxd/nestjs-agent-dashboard
+
+An embedded **AI-gateway governance console** for [`@dudousxd/nestjs-agent`](https://www.npmjs.com/package/@dudousxd/nestjs-agent) — the in-process analog of the Vercel AI Gateway dashboard, with governance already coupled (cost per model/actor, budgets, live tool-call/quota signals).
+
+A bundled **React SPA** served by a **NestJS module**, mounted at its own route (default `/ai-gateway`). It reads historical spend/usage from the shared governance read-model and tails live activity off the `aviary:agent:*` diagnostics channel over SSE. Mirrors [`@dudousxd/nestjs-durable-dashboard`](https://www.npmjs.com/package/@dudousxd/nestjs-durable-dashboard).
+
+## Install
+
+```bash
+pnpm add @dudousxd/nestjs-agent-dashboard
+```
+
+Peer deps: `@dudousxd/nestjs-agent-core`, `@nestjs/common`, `@nestjs/core`, `rxjs`.
+
+## Mount it
+
+Import `AgentDashboardModule.forRoot(...)` alongside your `@dudousxd/nestjs-agent` module (global), which must provide the `AGENT_GOVERNANCE_QUERIES` read-model (bound by a store adapter — `store-mikro-orm`, `store-drizzle`, or the in-memory testing adapter).
+
+```ts
+import { Module } from '@nestjs/common';
+import { AgentModule } from '@dudousxd/nestjs-agent';
+import { AgentDashboardModule } from '@dudousxd/nestjs-agent-dashboard';
+
+@Module({
+  imports: [
+    AgentModule.forRoot({ /* ... */ }), // provides AGENT_GOVERNANCE_QUERIES (global)
+    AgentDashboardModule.forRoot({
+      basePath: '/ai-gateway',        // UI route (default)
+      apiBasePath: '/api/ai-gateway', // JSON + SSE API (default: `<basePath>/api`)
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+The controllers are **path-relative and guard-frontable** — front `basePath`/`apiBasePath` with your own auth guard/middleware.
+
+### `forRoot` options
+
+```ts
+AgentDashboardModule.forRoot({
+  basePath?: string;    // where the SPA is served. Default '/ai-gateway'
+  apiBasePath?: string; // where the JSON/SSE API is mounted. Default '<basePath>/api'
+});
+```
+
+## JSON + SSE API
+
+Mounted at `apiBasePath`:
+
+| Method | Path | Response |
+| ------ | ---- | -------- |
+| `GET` | `/spend?from=YYYY-MM-DD&to=YYYY-MM-DD` | `{ byModel: ModelSpendRow[], byActor: ActorSpendRow[], trend: UsageTrendPoint[] }` (defaults to the last 30 days) |
+| `GET` | `/tool-calls?limit=` | `ToolCallActivityRow[]` (default 50, max 200) |
+| `GET` | `/threads?limit=` | `ThreadActivityRow[]` (default 50, max 200) |
+| `GET` | `/stream` | SSE of live `aviary:agent:*` events (`{ event, ts, payload }`) |
+
+## SPA sections
+
+- **Spend & usage** — headline $ + tokens, by-model donut + legend, daily trend (cost/tokens toggle).
+- **Models** — per-model requests / in+out tokens / cost / share.
+- **Actors & budgets** — spend per acting ref; usage-vs-budget bar when a daily limit is known.
+- **Runs & tools** — recent tool calls (with a denied/forbidden banner) and recent threads.
+- **Live** — the diagnostics SSE feed, newest-first, with quota/denied events flagged.
+
+## Typed client
+
+For your own front-end, `@dudousxd/nestjs-agent-dashboard/client` exports `agentClient` (`spend`, `toolCalls`, `threads`, `streamEvents`) with the response types — dependency-free.
+
+```ts
+import { agentClient } from '@dudousxd/nestjs-agent-dashboard/client';
+
+const overview = await agentClient.spend({ fromDay: '2026-06-01', toDay: '2026-06-30' });
+```
+
+## Build
+
+`vite build && tsup && tsc -p tsconfig.client.json` — the SPA compiles to `dist/spa`, the NestJS server to `dist/server` (dual ESM + CJS with decorator metadata + `import.meta.url` shim), and the client types to `dist/client`. The bundled SPA ships in the package, so the UI controller serves it with no extra assets.
+
+`preview.html` renders every section against mock data (no backend) for visual verification.
+
+## License
+
+MIT © Davide Carvalho

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

@@ -0,0 +1,78 @@
+/** Inclusive UTC day range, each `YYYY-MM-DD`. */
+export interface GovernanceRange {
+    fromDay: string;
+    toDay: string;
+}
+/** Spend + token totals for one model over a range. */
+export interface ModelSpendRow {
+    modelId: string;
+    requests: number;
+    inputTokens: number;
+    outputTokens: number;
+    costUsd: number;
+}
+/** Spend + token totals for one acting ref (user/tenant) over a range. */
+export interface ActorSpendRow {
+    actorRef: string;
+    requests: number;
+    totalTokens: number;
+    costUsd: number;
+}
+/** One point on the daily usage/cost trend. */
+export interface UsageTrendPoint {
+    day: string;
+    totalTokens: number;
+    costUsd: number;
+}
+/** A recent tool-call for the activity feed. */
+export interface ToolCallActivityRow {
+    toolCallId: string;
+    toolName: string;
+    toolType: string;
+    status: string;
+    threadId: string;
+    createdAt: string;
+}
+/** A recent thread with rolled-up activity. */
+export interface ThreadActivityRow {
+    threadId: string;
+    title: string;
+    actorRef: string;
+    messageCount: number;
+    totalTokens: number;
+    lastActivityAt: string;
+}
+/** The `GET <api>/spend` response. */
+export interface SpendOverview {
+    byModel: ModelSpendRow[];
+    byActor: ActorSpendRow[];
+    trend: UsageTrendPoint[];
+}
+/** One live agent event forwarded over SSE. */
+export interface LiveAgentEvent {
+    event: string;
+    ts: number;
+    payload: Record<string, unknown>;
+}
+declare global {
+    interface Window {
+        /** UI mount base (e.g. `/ai-gateway`) injected by the UI controller; falls back to `/ai-gateway`. */
+        __AGENT_BASE__?: string;
+        /** JSON API base (e.g. `/ai-gateway/api`) injected by the UI controller; falls back to `<base>/api`. */
+        __AGENT_API__?: string;
+    }
+}
+export declare const agentClient: {
+    /** Spend/usage overview for a day range: `{ byModel, byActor, trend }`. */
+    spend(range: GovernanceRange): Promise<SpendOverview>;
+    /** Most recent tool calls (default 50). */
+    toolCalls(limit?: number): Promise<ToolCallActivityRow[]>;
+    /** Most recent threads (default 50). */
+    threads(limit?: number): Promise<ThreadActivityRow[]>;
+    /**
+     * Live-tail `aviary:agent:*` events over SSE. Calls `onEvent` per event; returns a function that
+     * closes the stream.
+     */
+    streamEvents(onEvent: (event: LiveAgentEvent) => void): () => void;
+};
+//# sourceMappingURL=agent-client.d.ts.map

package/dist/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":"AAIA,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,qGAAqG;QACrG,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,wGAAwG;QACxG,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;CACF;AAcD,eAAO,MAAM,WAAW;IACtB,2EAA2E;iBAC9D,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IAIrD,2CAA2C;+BACpB,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAGrD,wCAAwC;6BACnB,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAGjD;;;OAGG;0BACmB,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI;CAWnE,CAAC"}

package/dist/client/agent-client.js

@@ -0,0 +1,47 @@
+// Typed API client for the AI-gateway console. Self-contained: the row shapes are re-declared here
+// (identical to core's `AgentGovernanceQueries` contract) so `@dudousxd/nestjs-agent-dashboard/client`
+// is dependency-free for an external front-end that only wants to call the API.
+function apiBase() {
+    if (typeof window !== 'undefined' && window.__AGENT_API__)
+        return window.__AGENT_API__;
+    const base = (typeof window !== 'undefined' && window.__AGENT_BASE__) || '/ai-gateway';
+    return `${base}/api`;
+}
+async function http(path, init) {
+    const res = await fetch(apiBase() + path, init);
+    if (!res.ok)
+        throw new Error(`${res.status} ${res.statusText}`);
+    return (await res.json());
+}
+export const agentClient = {
+    /** Spend/usage overview for a day range: `{ byModel, byActor, trend }`. */
+    spend(range) {
+        const q = new URLSearchParams({ from: range.fromDay, to: range.toDay });
+        return http(`/spend?${q.toString()}`);
+    },
+    /** Most recent tool calls (default 50). */
+    toolCalls(limit = 50) {
+        return http(`/tool-calls?limit=${limit}`);
+    },
+    /** Most recent threads (default 50). */
+    threads(limit = 50) {
+        return http(`/threads?limit=${limit}`);
+    },
+    /**
+     * Live-tail `aviary:agent:*` events over SSE. Calls `onEvent` per event; returns a function that
+     * closes the stream.
+     */
+    streamEvents(onEvent) {
+        const source = new EventSource(`${apiBase()}/stream`);
+        source.onmessage = (msg) => {
+            try {
+                onEvent(JSON.parse(msg.data));
+            }
+            catch {
+                /* ignore malformed event */
+            }
+        };
+        return () => source.close();
+    },
+};
+//# sourceMappingURL=agent-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-client.js","sourceRoot":"","sources":["../../src/client/agent-client.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,uGAAuG;AACvG,gFAAgF;AA2EhF,SAAS,OAAO;IACd,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,aAAa;QAAE,OAAO,MAAM,CAAC,aAAa,CAAC;IACvF,MAAM,IAAI,GAAG,CAAC,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,cAAc,CAAC,IAAI,aAAa,CAAC;IACvF,OAAO,GAAG,IAAI,MAAM,CAAC;AACvB,CAAC;AAED,KAAK,UAAU,IAAI,CAAI,IAAY,EAAE,IAAkB;IACrD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,2EAA2E;IAC3E,KAAK,CAAC,KAAsB;QAC1B,MAAM,CAAC,GAAG,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACxE,OAAO,IAAI,CAAgB,UAAU,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,2CAA2C;IAC3C,SAAS,CAAC,KAAK,GAAG,EAAE;QAClB,OAAO,IAAI,CAAwB,qBAAqB,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,wCAAwC;IACxC,OAAO,CAAC,KAAK,GAAG,EAAE;QAChB,OAAO,IAAI,CAAsB,kBAAkB,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD;;;OAGG;IACH,YAAY,CAAC,OAAwC;QACnD,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,GAAG,OAAO,EAAE,SAAS,CAAC,CAAC;QACtD,MAAM,CAAC,SAAS,GAAG,CAAC,GAAG,EAAE,EAAE;YACzB,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAmB,CAAC,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,4BAA4B;YAC9B,CAAC;QACH,CAAC,CAAC;QACF,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;CACF,CAAC"}

package/dist/client/budget-usage.d.ts

@@ -0,0 +1,23 @@
+import type { ActorSpendRow } from './agent-client';
+/** A configured per-actor daily token budget, keyed by `actorRef`. Empty when no budgets are known. */
+export type BudgetMap = Record<string, number>;
+/** An actor's spend joined with its budget (when one is configured). */
+export interface ActorBudget {
+    actorRef: string;
+    requests: number;
+    totalTokens: number;
+    costUsd: number;
+    /** Configured daily token limit, when known. */
+    limitTokens?: number;
+    /** `totalTokens / limitTokens` (0..N; can exceed 1). Present only when a limit is known. */
+    usageRatio?: number;
+    /** True when a known limit is met or exceeded. */
+    overBudget: boolean;
+}
+/**
+ * Join by-actor spend with the configured daily budgets. An actor with no configured limit keeps its
+ * spend but carries no `limitTokens`/`usageRatio` (the UI hides the bar — "usage vs limit when
+ * known"). Sorted by cost descending. Pure.
+ */
+export declare function joinBudgets(rows: ActorSpendRow[], budgets?: BudgetMap): ActorBudget[];
+//# sourceMappingURL=budget-usage.d.ts.map

package/dist/client/budget-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-usage.d.ts","sourceRoot":"","sources":["../../src/client/budget-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,uGAAuG;AACvG,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE/C,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,OAAO,GAAE,SAAc,GAAG,WAAW,EAAE,CAiBzF"}

package/dist/client/budget-usage.js

@@ -0,0 +1,24 @@
+/**
+ * Join by-actor spend with the configured daily budgets. An actor with no configured limit keeps its
+ * spend but carries no `limitTokens`/`usageRatio` (the UI hides the bar — "usage vs limit when
+ * known"). Sorted by cost descending. Pure.
+ */
+export function joinBudgets(rows, budgets = {}) {
+    return rows
+        .map((row) => {
+        const limit = budgets[row.actorRef];
+        const hasLimit = typeof limit === 'number' && limit > 0;
+        const usageRatio = hasLimit ? row.totalTokens / limit : undefined;
+        return {
+            actorRef: row.actorRef,
+            requests: row.requests,
+            totalTokens: row.totalTokens,
+            costUsd: row.costUsd,
+            overBudget: usageRatio !== undefined && usageRatio >= 1,
+            ...(hasLimit ? { limitTokens: limit } : {}),
+            ...(usageRatio !== undefined ? { usageRatio } : {}),
+        };
+    })
+        .sort((a, b) => b.costUsd - a.costUsd || b.totalTokens - a.totalTokens);
+}
+//# sourceMappingURL=budget-usage.js.map

package/dist/client/budget-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-usage.js","sourceRoot":"","sources":["../../src/client/budget-usage.ts"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAqB,EAAE,UAAqB,EAAE;IACxE,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAClE,OAAO;YACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,UAAU,EAAE,UAAU,KAAK,SAAS,IAAI,UAAU,IAAI,CAAC;YACvD,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpD,CAAC;IACJ,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AAC5E,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { GovernanceRange } from './agent-client';
+/** A `YYYY-MM-DD` UTC day string `daysAgo` days before `now` (0 = the `now` day). */
+export declare function utcDay(daysAgo: number, now?: number): string;
+/** The default range the console opens on: an inclusive `spanDays`-day window ending today (UTC). */
+export declare function defaultRange(spanDays?: number, now?: number): GovernanceRange;
+/** True for a well-formed `YYYY-MM-DD` day string. */
+export declare function isIsoDay(value: string): boolean;
+/**
+ * Number of inclusive days a range spans (`from` and `to` both counted). Returns 1 for a same-day
+ * range and clamps a reversed range to 1. Pure — assumes valid `YYYY-MM-DD` inputs.
+ */
+export declare function rangeDays(range: GovernanceRange): number;
+//# sourceMappingURL=default-range.d.ts.map

package/dist/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,gBAAgB,CAAC;AAKtD,qFAAqF;AACrF,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAExE;AAED,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,QAAQ,SAAK,EAAE,GAAG,GAAE,MAAmB,GAAG,eAAe,CAErF;AAED,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAKxD"}

package/dist/client/default-range.js

@@ -0,0 +1,26 @@
+const DAY_MS = 86_400_000;
+const ISO_DAY = /^\d{4}-\d{2}-\d{2}$/;
+/** A `YYYY-MM-DD` UTC day string `daysAgo` days before `now` (0 = the `now` day). */
+export function utcDay(daysAgo, now = Date.now()) {
+    return new Date(now - daysAgo * DAY_MS).toISOString().slice(0, 10);
+}
+/** The default range the console opens on: an inclusive `spanDays`-day window ending today (UTC). */
+export function defaultRange(spanDays = 30, now = Date.now()) {
+    return { fromDay: utcDay(spanDays - 1, now), toDay: utcDay(0, now) };
+}
+/** True for a well-formed `YYYY-MM-DD` day string. */
+export function isIsoDay(value) {
+    return ISO_DAY.test(value);
+}
+/**
+ * Number of inclusive days a range spans (`from` and `to` both counted). Returns 1 for a same-day
+ * range and clamps a reversed range to 1. Pure — assumes valid `YYYY-MM-DD` inputs.
+ */
+export function rangeDays(range) {
+    const from = Date.parse(`${range.fromDay}T00:00:00Z`);
+    const to = Date.parse(`${range.toDay}T00:00:00Z`);
+    if (!Number.isFinite(from) || !Number.isFinite(to))
+        return 1;
+    return Math.max(1, Math.round((to - from) / DAY_MS) + 1);
+}
+//# sourceMappingURL=default-range.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"default-range.js","sourceRoot":"","sources":["../../src/client/default-range.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG,UAAU,CAAC;AAC1B,MAAM,OAAO,GAAG,qBAAqB,CAAC;AAEtC,qFAAqF;AACrF,MAAM,UAAU,MAAM,CAAC,OAAe,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAC9D,OAAO,IAAI,IAAI,CAAC,GAAG,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,YAAY,CAAC,QAAQ,GAAG,EAAE,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAClE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAsB;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;IACtD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,YAAY,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/client/format-usd.d.ts

@@ -0,0 +1,8 @@
+/** Compact-number + currency formatting for the console. Pure; unit-tested. */
+/** Format a USD amount. Small amounts keep more precision; large ones read as `$1.2k` / `$3.4M`. */
+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;
+//# sourceMappingURL=format-usd.d.ts.map

package/dist/client/format-usd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-usd.d.ts","sourceRoot":"","sources":["../../src/client/format-usd.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,oGAAoG;AACpG,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"}

package/dist/client/format-usd.js

@@ -0,0 +1,34 @@
+/** Compact-number + currency formatting for the console. Pure; unit-tested. */
+/** Format a USD amount. Small amounts keep more precision; large ones read as `$1.2k` / `$3.4M`. */
+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)}%`;
+}
+//# sourceMappingURL=format-usd.js.map

package/dist/client/format-usd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-usd.js","sourceRoot":"","sources":["../../src/client/format-usd.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,oGAAoG;AACpG,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,GAAG,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACpE,IAAI,GAAG,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC5D,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,IAAI;QAAE,OAAO,QAAQ,CAAC;IAC3C,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AACjC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,GAAG,IAAI,aAAa;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1E,IAAI,GAAG,IAAI,SAAS;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAClE,IAAI,GAAG,IAAI,KAAK;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1D,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AAChC,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC;AACvC,CAAC"}

package/dist/client/merge-live-events.d.ts

@@ -0,0 +1,17 @@
+import type { LiveAgentEvent } from './agent-client';
+/** A live event with a stable client-assigned id, so React can key the feed without server ids. */
+export interface FeedEvent extends LiveAgentEvent {
+    /** Monotonic client id (`ts`-prefixed) — stable across re-renders, unique within a session. */
+    id: string;
+}
+/** Default number of live events the feed retains (a bounded ring so a long session can't grow unbounded). */
+export declare const DEFAULT_FEED_CAPACITY = 200;
+/**
+ * Prepend a freshly-received live event onto the feed (newest first) and cap the list at `capacity`.
+ * `seq` disambiguates two events sharing the same `ts` so the generated `id` stays unique. Pure —
+ * returns a new array, never mutates `prev`.
+ */
+export declare function pushLiveEvent(prev: FeedEvent[], event: LiveAgentEvent, seq: number, capacity?: number): FeedEvent[];
+/** True when a live event denotes a governance breach the Live feed should surface loudly. */
+export declare function isAlertEvent(event: LiveAgentEvent): boolean;
+//# sourceMappingURL=merge-live-events.d.ts.map

package/dist/client/merge-live-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-live-events.d.ts","sourceRoot":"","sources":["../../src/client/merge-live-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,mGAAmG;AACnG,MAAM,WAAW,SAAU,SAAQ,cAAc;IAC/C,+FAA+F;IAC/F,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,8GAA8G;AAC9G,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,EAAE,EACjB,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,MAA8B,GACvC,SAAS,EAAE,CAGb;AAED,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAI3D"}

package/dist/client/merge-live-events.js

@@ -0,0 +1,19 @@
+/** Default number of live events the feed retains (a bounded ring so a long session can't grow unbounded). */
+export const DEFAULT_FEED_CAPACITY = 200;
+/**
+ * Prepend a freshly-received live event onto the feed (newest first) and cap the list at `capacity`.
+ * `seq` disambiguates two events sharing the same `ts` so the generated `id` stays unique. Pure —
+ * returns a new array, never mutates `prev`.
+ */
+export function pushLiveEvent(prev, event, seq, capacity = DEFAULT_FEED_CAPACITY) {
+    const entry = { ...event, id: `${event.ts}-${seq}` };
+    return [entry, ...prev].slice(0, capacity);
+}
+/** True when a live event denotes a governance breach the Live feed should surface loudly. */
+export function isAlertEvent(event) {
+    if (event.event === 'quota.exceeded')
+        return true;
+    const status = event.payload.status;
+    return typeof status === 'string' && /forbidden|denied|error|failed/i.test(status);
+}
+//# sourceMappingURL=merge-live-events.js.map

package/dist/client/merge-live-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-live-events.js","sourceRoot":"","sources":["../../src/client/merge-live-events.ts"],"names":[],"mappings":"AAQA,8GAA8G;AAC9G,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAiB,EACjB,KAAqB,EACrB,GAAW,EACX,WAAmB,qBAAqB;IAExC,MAAM,KAAK,GAAc,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IAChE,OAAO,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,YAAY,CAAC,KAAqB;IAChD,IAAI,KAAK,CAAC,KAAK,KAAK,gBAAgB;QAAE,OAAO,IAAI,CAAC;IAClD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;IACpC,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,gCAAgC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACrF,CAAC"}

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

@@ -0,0 +1,37 @@
+import type { ModelSpendRow } from './agent-client';
+/** 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). 0 when there is no cost anywhere (falls back to token share). */
+    costShare: number;
+}
+/** One donut arc segment: a normalized 0..1 slice with its cumulative offset (also 0..1). */
+export interface DonutSegment {
+    modelId: 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 the bars/donut still convey 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[];
+//# sourceMappingURL=spend-summary.d.ts.map

package/dist/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,MAAM,gBAAgB,CAAC;AAEpD,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,mGAAmG;IACnG,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6FAA6F;AAC7F,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,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,CAYnE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,YAAY,EAAE,CAcrE"}

package/dist/client/spend-summary.js

@@ -0,0 +1,57 @@
+/** 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 the bars/donut still convey 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);
+    const denomCost = totalCost > 0 ? totalCost : 0;
+    return rows
+        .map((row) => {
+        const rowTokens = row.inputTokens + row.outputTokens;
+        const costShare = denomCost > 0 ? row.costUsd / denomCost : 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({
+            modelId: row.modelId,
+            value: row.costUsd,
+            fraction: row.costShare,
+            offset,
+        });
+        offset += row.costShare;
+    }
+    return segments;
+}
+//# sourceMappingURL=spend-summary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spend-summary.js","sourceRoot":"","sources":["../../src/client/spend-summary.ts"],"names":[],"mappings":"AA0BA,sDAAsD;AACtD,MAAM,UAAU,cAAc,CAAC,IAAqB;IAClD,MAAM,MAAM,GAAgB;QAC1B,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,CAAC;QACd,QAAQ,EAAE,CAAC;KACZ,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC;QAC9B,MAAM,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,CAAC;QACtC,MAAM,CAAC,YAAY,IAAI,GAAG,CAAC,YAAY,CAAC;QACxC,MAAM,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC;IAClC,CAAC;IACD,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC;IAC9D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAqB;IAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAClE,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAC3F,MAAM,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,YAAY,CAAC;QACrD,MAAM,SAAS,GACb,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1F,OAAO,EAAE,GAAG,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;IACvD,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AAC5E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAuB;IACnD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,SAAS,IAAI,CAAC;YAAE,SAAS;QACjC,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,KAAK,EAAE,GAAG,CAAC,OAAO;YAClB,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,MAAM;SACP,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,SAAS,CAAC;IAC1B,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { UsageTrendPoint } from './agent-client';
+/** 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 string when there is nothing to plot). */
+    line: string;
+    /** Closed area path (line + baseline) for a filled gradient; empty string when nothing to plot. */
+    area: string;
+    vertices: TrendVertex[];
+    /** The series max used to normalize the y-axis (never 0 — floored to 1 so a flat/empty series 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/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,gBAAgB,CAAC;AAEtD,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,2FAA2F;IAC3F,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,yGAAyG;IACzG,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"}

package/dist/client/trend-path.js

@@ -0,0 +1,25 @@
+/**
+ * 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 function buildTrendGeometry(points, metric, width, height) {
+    if (points.length === 0)
+        return { line: '', area: '', vertices: [], max: 1 };
+    const max = Math.max(1, ...points.map((point) => point[metric]));
+    const lastIndex = Math.max(1, points.length - 1);
+    const vertices = points.map((point, index) => {
+        const value = point[metric];
+        const x = points.length === 1 ? width / 2 : (index / lastIndex) * width;
+        const y = height - (value / max) * height;
+        return { day: point.day, value, x, y };
+    });
+    const line = vertices
+        .map((vertex, index) => `${index === 0 ? 'M' : 'L'}${vertex.x.toFixed(2)},${vertex.y.toFixed(2)}`)
+        .join(' ');
+    const firstX = vertices[0]?.x ?? 0;
+    const lastX = vertices[vertices.length - 1]?.x ?? width;
+    const area = `${line} L${lastX.toFixed(2)},${height} L${firstX.toFixed(2)},${height} Z`;
+    return { line, area, vertices, max };
+}
+//# sourceMappingURL=trend-path.js.map

package/dist/client/trend-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trend-path.js","sourceRoot":"","sources":["../../src/client/trend-path.ts"],"names":[],"mappings":"AAwBA;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAyB,EACzB,MAAmB,EACnB,KAAa,EACb,MAAc;IAEd,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IAE7E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAkB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,KAAK,CAAC;QACxE,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC;QAC1C,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,QAAQ;SAClB,GAAG,CACF,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAC7F;SACA,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC;IACxD,MAAM,IAAI,GAAG,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,IAAI,CAAC;IAExF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;AACvC,CAAC"}