@dudousxd/nestjs-agent-dashboard 0.3.1 → 0.4.1

package/dist/server/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/server/index.ts","../../src/server/agent-api.controller.ts","../../src/server/dashboard.service.ts","../../src/server/tokens.ts","../../src/server/agent-dashboard.module.ts","../../src/server/agent-ui.controller.ts"],"sourcesContent":["export * from './agent-api.controller.js';\nexport * from './agent-dashboard.module.js';\nexport * from './agent-ui.controller.js';\nexport * from './dashboard.service.js';\nexport * from './tokens.js';\n","import type {\n  ThreadActivityRow,\n  ThreadSpendRow,\n  ToolCallActivityRow,\n} from '@dudousxd/nestjs-agent-core';\nimport { Controller, Get, Query, Sse } from '@nestjs/common';\nimport type { Observable } from 'rxjs';\nimport { DashboardService, type LiveAgentEvent, type SpendOverview } from './dashboard.service.js';\n\nconst DAY_MS = 86_400_000;\nconst ISO_DAY = /^\\d{4}-\\d{2}-\\d{2}$/;\n\n/** A `YYYY-MM-DD` UTC day string `daysAgo` days before now (0 = today). */\nfunction utcDay(daysAgo: number): string {\n  return new Date(Date.now() - daysAgo * DAY_MS).toISOString().slice(0, 10);\n}\n\n/** Accept a client-supplied `YYYY-MM-DD`, or fall back to `fallback`; guards against junk input. */\nfunction dayOr(value: string | undefined, fallback: string): string {\n  return value !== undefined && ISO_DAY.test(value) ? value : fallback;\n}\n\n/** Resolve the `from`/`to` query params into a validated range, defaulting to the last 30 days. */\nfunction resolveRange(\n  from: string | undefined,\n  to: string | undefined,\n): {\n  fromDay: string;\n  toDay: string;\n} {\n  return { fromDay: dayOr(from, utcDay(29)), toDay: dayOr(to, utcDay(0)) };\n}\n\n/** Parse a `limit` query param, clamped to a sane window; falls back to `fallback` when absent/junk. */\nfunction parseLimit(value: string | undefined, fallback: number): number {\n  const parsed = value === undefined ? Number.NaN : Number.parseInt(value, 10);\n  if (!Number.isFinite(parsed)) return fallback;\n  return Math.max(1, Math.min(200, parsed));\n}\n\n/**\n * JSON + SSE API consumed by the AI-gateway console SPA. Mounted at `apiBasePath` (set by\n * `RouterModule` in {@link AgentDashboardModule.forRoot}), so the controller routes are relative.\n */\n@Controller()\nexport class AgentApiController {\n  constructor(private readonly dashboard: DashboardService) {}\n\n  /** `{ byModel, byActor, trend }` for a day range (defaults to the last 30 days). */\n  @Get('spend')\n  spend(@Query('from') from?: string, @Query('to') to?: string): Promise<SpendOverview> {\n    return this.dashboard.spend(resolveRange(from, to));\n  }\n\n  /** Top threads by cost (default 10, max 200) for a day range (defaults to the last 30 days). */\n  @Get('top-threads')\n  topThreads(\n    @Query('from') from?: string,\n    @Query('to') to?: string,\n    @Query('limit') limit?: string,\n  ): Promise<ThreadSpendRow[]> {\n    return this.dashboard.topThreads(resolveRange(from, to), parseLimit(limit, 10));\n  }\n\n  /** Most recent tool calls (default 50, max 200) for the activity feed. */\n  @Get('tool-calls')\n  toolCalls(@Query('limit') limit?: string): Promise<ToolCallActivityRow[]> {\n    return this.dashboard.recentToolCalls(parseLimit(limit, 50));\n  }\n\n  /** Most recent threads (default 50, max 200) with rolled-up counts. */\n  @Get('threads')\n  threads(@Query('limit') limit?: string): Promise<ThreadActivityRow[]> {\n    return this.dashboard.recentThreads(parseLimit(limit, 50));\n  }\n\n  /** Server-Sent Events stream of live `aviary:agent:*` events — the Live feed tails it. */\n  @Sse('stream')\n  stream(): Observable<{ data: LiveAgentEvent }> {\n    return this.dashboard.streamEvents();\n  }\n}\n","import { subscribe, unsubscribe } from 'node:diagnostics_channel';\nimport type {\n  ActorSpendRow,\n  AgentGovernanceQueries,\n  GovernanceRange,\n  ModelSpendRow,\n  ThreadActivityRow,\n  ThreadSpendRow,\n  ToolCallActivityRow,\n  UsageTrendPoint,\n} from '@dudousxd/nestjs-agent-core';\nimport { channelName } from '@dudousxd/nestjs-diagnostics';\nimport { Inject, Injectable } from '@nestjs/common';\nimport { Observable } from 'rxjs';\nimport { AGENT_GOVERNANCE_QUERIES } from './tokens.js';\n\n/** The spend/usage overview the SPA renders on its headline section (`GET <api>/spend`). */\nexport interface SpendOverview {\n  byModel: ModelSpendRow[];\n  byActor: ActorSpendRow[];\n  trend: UsageTrendPoint[];\n}\n\n/** One live agent event forwarded over SSE, flattened from the `aviary:agent:*` diagnostics envelope. */\nexport interface LiveAgentEvent {\n  /** The event name, e.g. `run.started` / `tool-call` / `quota.exceeded`. */\n  event: string;\n  /** Epoch millis the event was emitted. */\n  ts: number;\n  /** The library-defined payload (see the `Agent*Event` shapes in core's diagnostics). */\n  payload: Record<string, unknown>;\n}\n\n/** The `aviary:agent:*` events the Live feed tails. Mirrors the telescope watcher's subscription. */\nconst AGENT_EVENTS = [\n  'run.started',\n  'message',\n  'tool-call',\n  'quota.exceeded',\n  'run.finished',\n  'delegated',\n] as const;\n\n/** The `node:diagnostics_channel` envelope `emit()` publishes (see `@dudousxd/nestjs-diagnostics`). */\ninterface AgentDiagnosticEnvelope {\n  event: string;\n  ts?: number;\n  payload?: Record<string, unknown>;\n}\n\n/** Narrow the untyped diagnostics-channel message to the envelope we forward. */\nfunction isAgentEnvelope(message: unknown): message is AgentDiagnosticEnvelope {\n  return (\n    typeof message === 'object' &&\n    message !== null &&\n    'event' in message &&\n    typeof (message as { event: unknown }).event === 'string'\n  );\n}\n\n/**\n * Read-model + live bridge backing the AI-gateway console.\n *\n * - Historical, restart-surviving spend/usage/threads come from the injected\n *   {@link AGENT_GOVERNANCE_QUERIES} read-model (backed by a store adapter). The host must provide\n *   that token — bind it via your `@dudousxd/nestjs-agent` module (global) alongside this dashboard.\n * - Live activity comes off the `aviary:agent:*` diagnostics channel, subscribed per SSE client and\n *   unsubscribed when the client disconnects.\n */\n@Injectable()\nexport class DashboardService {\n  constructor(@Inject(AGENT_GOVERNANCE_QUERIES) private readonly queries: AgentGovernanceQueries) {}\n\n  /** Spend/usage overview for a day range: by-model + by-actor spend and the daily trend, in parallel. */\n  async spend(range: GovernanceRange): Promise<SpendOverview> {\n    const [byModel, byActor, trend] = await Promise.all([\n      this.queries.spendByModel(range),\n      this.queries.spendByActor(range),\n      this.queries.usageTrend(range),\n    ]);\n    return { byModel, byActor, trend };\n  }\n\n  /** Top threads by cost for a day range (default 10, highest cost first). */\n  topThreads(range: GovernanceRange, limit = 10): Promise<ThreadSpendRow[]> {\n    return this.queries.spendByThread(range, limit);\n  }\n\n  /** Most recent tool calls (status/type/thread) for the Runs & tools activity feed. */\n  recentToolCalls(limit: number): Promise<ToolCallActivityRow[]> {\n    return this.queries.recentToolCalls(limit);\n  }\n\n  /** Most recent threads with rolled-up message/token counts. */\n  recentThreads(limit: number): Promise<ThreadActivityRow[]> {\n    return this.queries.recentThreads(limit);\n  }\n\n  /**\n   * Live SSE stream of `aviary:agent:*` diagnostics events. One subscription per SSE client:\n   * subscribing wires a handler onto each agent channel; the returned teardown removes them all when\n   * the client disconnects (or the observable is otherwise unsubscribed).\n   */\n  streamEvents(): Observable<{ data: LiveAgentEvent }> {\n    return new Observable<{ data: LiveAgentEvent }>((subscriber) => {\n      const bindings = AGENT_EVENTS.map((event) => {\n        const name = channelName('agent', event);\n        const handler = (message: unknown): void => {\n          if (!isAgentEnvelope(message)) return;\n          subscriber.next({\n            data: {\n              event: message.event,\n              ts: message.ts ?? Date.now(),\n              payload: message.payload ?? {},\n            },\n          });\n        };\n        subscribe(name, handler);\n        return { name, handler };\n      });\n      return () => {\n        for (const binding of bindings) unsubscribe(binding.name, binding.handler);\n      };\n    });\n  }\n}\n","/**\n * DI tokens for the standalone AI-gateway dashboard.\n *\n * All use `Symbol.for(...)` (the global symbol registry) on purpose: pnpm peer multiplexing + dual\n * ESM/CJS can load a package more than once, and a plain `Symbol()` would mint a distinct token per\n * copy and break DI across the ESM/CJS split. A registered symbol collapses every copy onto the same\n * token.\n */\n\n/**\n * The governance read-model, owned by `@dudousxd/nestjs-agent-core`. We re-declare it here BY VALUE\n * (not by import) so DI does not depend on a runtime value-import of core resolving — `Symbol.for`\n * with the identical key resolves to the SAME symbol instance as core's own\n * `packages/core/src/tokens.ts` export. The key MUST stay byte-identical with that export.\n */\nexport const AGENT_GOVERNANCE_QUERIES = Symbol.for('@dudousxd/nestjs-agent:governance-queries');\n\n/** DI token carrying the UI mount base (e.g. `/ai-gateway`). */\nexport const DASHBOARD_BASE_PATH = Symbol.for('@dudousxd/nestjs-agent-dashboard:base-path');\n\n/** DI token carrying the JSON API base the SPA fetches from (e.g. `/ai-gateway/api`). */\nexport const DASHBOARD_API_PATH = Symbol.for('@dudousxd/nestjs-agent-dashboard:api-path');\n","import { type DynamicModule, Module } from '@nestjs/common';\nimport { RouterModule } from '@nestjs/core';\nimport { AgentApiController } from './agent-api.controller.js';\nimport { AgentUiController } from './agent-ui.controller.js';\nimport { DashboardService } from './dashboard.service.js';\nimport { DASHBOARD_API_PATH, DASHBOARD_BASE_PATH } from './tokens.js';\n\nexport interface AgentDashboardOptions {\n  /**\n   * Where the SPA (UI) is served. Default `/ai-gateway`. This is a page route — keep it out of an\n   * `/api` prefix so it reads as a UI, not an endpoint.\n   */\n  basePath?: string;\n  /**\n   * Where the JSON API is mounted (what the SPA fetches). Default `<basePath>/api`. Set it under\n   * your app's `/api` prefix — e.g. `/api/ai-gateway` — so the API inherits the app's auth/proxy\n   * rules while the UI stays at `basePath`.\n   */\n  apiBasePath?: string;\n}\n\n/** Leading slash, no trailing slash. */\nfunction normalize(path: string): string {\n  return `/${path.replace(/^\\/+|\\/+$/g, '')}`;\n}\n\n/** Holds the JSON API + SSE controller and its read service, mounted on its own path by `forRoot`. */\n@Module({\n  controllers: [AgentApiController],\n  providers: [DashboardService],\n  exports: [DashboardService],\n})\nexport class AgentApiModule {}\n\n/**\n * Mounts the AI-gateway governance console: the bundled React SPA at `basePath` and its JSON + SSE\n * API at `apiBasePath` (default `<basePath>/api`).\n *\n * Import via `AgentDashboardModule.forRoot(...)` alongside your `@dudousxd/nestjs-agent` module\n * (global), which must provide `AGENT_GOVERNANCE_QUERIES` (bound by a store adapter). Front the\n * routes with your own guard — the controllers are path-relative and guard-frontable.\n */\n@Module({})\nexport class AgentDashboardModule {\n  static forRoot(options: AgentDashboardOptions = {}): DynamicModule {\n    const basePath = normalize(options.basePath ?? '/ai-gateway');\n    const apiBasePath = normalize(options.apiBasePath ?? `${basePath}/api`);\n    return {\n      module: AgentDashboardModule,\n      imports: [\n        AgentApiModule,\n        RouterModule.register([\n          { path: basePath, module: AgentDashboardModule }, // the UI controller below\n          { path: apiBasePath, module: AgentApiModule },\n        ]),\n      ],\n      controllers: [AgentUiController],\n      providers: [\n        { provide: DASHBOARD_BASE_PATH, useValue: basePath },\n        { provide: DASHBOARD_API_PATH, useValue: apiBasePath },\n      ],\n      // Re-export the API module so its DashboardService reaches importers (e.g. the host's own controllers).\n      exports: [AgentApiModule],\n    };\n  }\n}\n","import { existsSync, readFileSync } from 'node:fs';\nimport { basename, extname, join, resolve, sep } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport {\n  Controller,\n  Get,\n  Header,\n  Inject,\n  NotFoundException,\n  Param,\n  StreamableFile,\n} from '@nestjs/common';\nimport { DASHBOARD_API_PATH, DASHBOARD_BASE_PATH } from './tokens.js';\n\n/** The base the SPA bundle was built with (Vite `base`); rewritten to the configured base at serve time. */\nconst BUILD_BASE = '/ai-gateway';\n\n/** dist/server/agent-ui.controller.js -> ../spa (the Vite build output). */\nfunction spaDir(): string {\n  return fileURLToPath(new URL('../spa', import.meta.url));\n}\n\nconst CONTENT_TYPES: Record<string, string> = {\n  '.js': 'text/javascript; charset=utf-8',\n  '.css': 'text/css; charset=utf-8',\n  '.map': 'application/json; charset=utf-8',\n  '.svg': 'image/svg+xml',\n  '.json': 'application/json; charset=utf-8',\n  '.woff2': 'font/woff2',\n  '.ico': 'image/x-icon',\n};\n\n/**\n * Serves the bundled AI-gateway console SPA at the configured base (+ hashed assets at\n * `<base>/assets`). The path comes from `RouterModule` (set by\n * {@link AgentDashboardModule.forRoot}({ basePath })), so the controller routes are relative.\n */\n@Controller()\nexport class AgentUiController {\n  private readonly dir = spaDir();\n\n  constructor(\n    @Inject(DASHBOARD_BASE_PATH) private readonly basePath: string,\n    @Inject(DASHBOARD_API_PATH) private readonly apiBasePath: string,\n  ) {}\n\n  // index.html references hash-named bundles, so it MUST NOT be cached (stale bundle = the classic\n  // \"stuck loading after a deploy\"). The hashed assets below are immutable.\n  @Get()\n  @Header('Content-Type', 'text/html; charset=utf-8')\n  @Header('Cache-Control', 'no-store, must-revalidate')\n  index(): string {\n    const indexPath = join(this.dir, 'index.html');\n    if (!existsSync(indexPath)) {\n      throw new NotFoundException('Dashboard is not built. Run the package build.');\n    }\n    // The bundle was built with Vite base `/ai-gateway/`; rewrite asset URLs to the configured base\n    // so the SPA loads from `<base>/assets` wherever it's mounted, and tell the client its API base.\n    const html = readFileSync(indexPath, 'utf8').replaceAll(\n      `=\"${BUILD_BASE}/`,\n      `=\"${this.basePath}/`,\n    );\n    // __AGENT_BASE__ = where assets load; __AGENT_API__ = where the SPA fetches the JSON API.\n    const inject = `<script>window.__AGENT_BASE__='${this.basePath}';window.__AGENT_API__='${this.apiBasePath}';</script>`;\n    return html.includes('</head>') ? html.replace('</head>', `${inject}</head>`) : inject + html;\n  }\n\n  @Get('assets/:file')\n  @Header('Cache-Control', 'public, max-age=31536000, immutable')\n  asset(@Param('file') file: string): StreamableFile {\n    const safe = basename(file);\n    if (safe !== file) throw new NotFoundException();\n    const root = resolve(this.dir, 'assets');\n    const assetPath = resolve(root, safe);\n    if (!assetPath.startsWith(root + sep) || !existsSync(assetPath)) {\n      throw new NotFoundException();\n    }\n    const type = CONTENT_TYPES[extname(safe)] ?? 'application/octet-stream';\n    return new StreamableFile(readFileSync(assetPath), { type });\n  }\n}\n"],"mappings":"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","names":["import_common","AGENT_GOVERNANCE_QUERIES","Symbol","for","DASHBOARD_BASE_PATH","DASHBOARD_API_PATH","AGENT_EVENTS","isAgentEnvelope","message","event","DashboardService","queries","spend","range","byModel","byActor","trend","Promise","all","spendByModel","spendByActor","usageTrend","topThreads","limit","spendByThread","recentToolCalls","recentThreads","streamEvents","Observable","subscriber","bindings","map","name","channelName","handler","next","data","ts","Date","now","payload","subscribe","binding","unsubscribe","DAY_MS","ISO_DAY","utcDay","daysAgo","Date","now","toISOString","slice","dayOr","value","fallback","undefined","test","resolveRange","from","to","fromDay","toDay","parseLimit","parsed","Number","NaN","parseInt","isFinite","Math","max","min","AgentApiController","dashboard","spend","topThreads","limit","toolCalls","recentToolCalls","threads","recentThreads","stream","streamEvents","import_common","import_common","BUILD_BASE","spaDir","fileURLToPath","URL","CONTENT_TYPES","AgentUiController","dir","basePath","apiBasePath","index","indexPath","join","existsSync","NotFoundException","html","readFileSync","replaceAll","inject","includes","replace","asset","file","safe","basename","root","resolve","assetPath","startsWith","sep","type","extname","StreamableFile","normalize","path","replace","AgentApiModule","controllers","AgentApiController","providers","DashboardService","exports","AgentDashboardModule","forRoot","options","basePath","apiBasePath","module","imports","RouterModule","register","AgentUiController","provide","DASHBOARD_BASE_PATH","useValue","DASHBOARD_API_PATH"]}
+{"version":3,"sources":["../../src/server/index.ts","../../src/server/agent-api.controller.ts","../../src/server/dashboard.service.ts","../../src/server/parse-price-input.ts","../../src/server/tokens.ts","../../src/server/normalize-path.ts","../../src/server/agent-dashboard-mount-paths.ts","../../src/server/agent-dashboard.module.ts","../../src/server/agent-ui.controller.ts"],"sourcesContent":["export * from './actor-directory.js';\nexport * from './agent-api.controller.js';\nexport * from './agent-dashboard-mount-paths.js';\nexport * from './agent-dashboard.module.js';\nexport * from './agent-ui.controller.js';\nexport * from './dashboard.service.js';\nexport * from './parse-price-input.js';\nexport * from './tokens.js';\n","import type { CurrentModelPrice, ToolCallActivityRow } from '@dudousxd/nestjs-agent-core';\nimport { Body, Controller, Get, Post, Query, Sse } from '@nestjs/common';\nimport type { Observable } from 'rxjs';\nimport {\n  DashboardService,\n  type LiveAgentEvent,\n  type SpendOverview,\n  type ThreadActivityRowWithLabel,\n  type ThreadSpendRowWithLabel,\n} from './dashboard.service.js';\n\nconst DAY_MS = 86_400_000;\nconst ISO_DAY = /^\\d{4}-\\d{2}-\\d{2}$/;\n\n/** A `YYYY-MM-DD` UTC day string `daysAgo` days before now (0 = today). */\nfunction utcDay(daysAgo: number): string {\n  return new Date(Date.now() - daysAgo * DAY_MS).toISOString().slice(0, 10);\n}\n\n/** Accept a client-supplied `YYYY-MM-DD`, or fall back to `fallback`; guards against junk input. */\nfunction dayOr(value: string | undefined, fallback: string): string {\n  return value !== undefined && ISO_DAY.test(value) ? value : fallback;\n}\n\n/** Resolve the `from`/`to` query params into a validated range, defaulting to the last 30 days. */\nfunction resolveRange(\n  from: string | undefined,\n  to: string | undefined,\n): {\n  fromDay: string;\n  toDay: string;\n} {\n  return { fromDay: dayOr(from, utcDay(29)), toDay: dayOr(to, utcDay(0)) };\n}\n\n/** Parse a `limit` query param, clamped to a sane window; falls back to `fallback` when absent/junk. */\nfunction parseLimit(value: string | undefined, fallback: number): number {\n  const parsed = value === undefined ? Number.NaN : Number.parseInt(value, 10);\n  if (!Number.isFinite(parsed)) return fallback;\n  return Math.max(1, Math.min(200, parsed));\n}\n\n/**\n * JSON + SSE API consumed by the AI-gateway console SPA. Mounted at `apiBasePath` (set by\n * `RouterModule` in {@link AgentDashboardModule.forRoot}), so the controller routes are relative.\n */\n@Controller()\nexport class AgentApiController {\n  constructor(private readonly dashboard: DashboardService) {}\n\n  /** `{ byModel, byActor, trend }` for a day range (defaults to the last 30 days). */\n  @Get('spend')\n  spend(@Query('from') from?: string, @Query('to') to?: string): Promise<SpendOverview> {\n    return this.dashboard.spend(resolveRange(from, to));\n  }\n\n  /** Top threads by cost (default 10, max 200) for a day range (defaults to the last 30 days). */\n  @Get('top-threads')\n  topThreads(\n    @Query('from') from?: string,\n    @Query('to') to?: string,\n    @Query('limit') limit?: string,\n  ): Promise<ThreadSpendRowWithLabel[]> {\n    return this.dashboard.topThreads(resolveRange(from, to), parseLimit(limit, 10));\n  }\n\n  /** Most recent tool calls (default 50, max 200) for the activity feed. */\n  @Get('tool-calls')\n  toolCalls(@Query('limit') limit?: string): Promise<ToolCallActivityRow[]> {\n    return this.dashboard.recentToolCalls(parseLimit(limit, 50));\n  }\n\n  /** Most recent threads (default 50, max 200) with rolled-up counts. */\n  @Get('threads')\n  threads(@Query('limit') limit?: string): Promise<ThreadActivityRowWithLabel[]> {\n    return this.dashboard.recentThreads(parseLimit(limit, 50));\n  }\n\n  /**\n   * Current price row per model, for the pricing tab. 501s (via `DashboardService.listPrices`) when\n   * no `AGENT_PRICING_STORE` is bound.\n   */\n  @Get('pricing')\n  listPrices(): Promise<CurrentModelPrice[]> {\n    return this.dashboard.listPrices();\n  }\n\n  /**\n   * Set a model's current price. Body shape mirrors core's `ModelPriceInput`\n   * (`{ modelId, inputPricePer1m, outputPricePer1m, cacheWritePricePer1m?, cacheReadPricePer1m? }`).\n   * 501s when no `AGENT_PRICING_STORE` is bound; 400s on a malformed body.\n   */\n  @Post('pricing')\n  upsertPrice(@Body() body: unknown): Promise<void> {\n    return this.dashboard.upsertPrice(body);\n  }\n\n  /** Server-Sent Events stream of live `aviary:agent:*` events — the Live feed tails it. */\n  @Sse('stream')\n  stream(): Observable<{ data: LiveAgentEvent }> {\n    return this.dashboard.streamEvents();\n  }\n}\n","import { subscribe, unsubscribe } from 'node:diagnostics_channel';\nimport type {\n  ActorSpendRow,\n  AgentGovernanceQueries,\n  AgentPricingStore,\n  CurrentModelPrice,\n  GovernanceRange,\n  ModelSpendRow,\n  ThreadActivityRow,\n  ThreadSpendRow,\n  ToolCallActivityRow,\n  UsageTrendPoint,\n} from '@dudousxd/nestjs-agent-core';\nimport { channelName } from '@dudousxd/nestjs-diagnostics';\nimport { Inject, Injectable, NotImplementedException, Optional } from '@nestjs/common';\nimport { Observable } from 'rxjs';\nimport type { ActorDirectory } from './actor-directory.js';\nimport { parsePriceInput } from './parse-price-input.js';\nimport { AGENT_ACTOR_DIRECTORY, AGENT_GOVERNANCE_QUERIES, AGENT_PRICING_STORE } from './tokens.js';\n\n/** An actor-scoped row decorated with its resolved display label — `null` when unbound or unresolved. */\nexport interface WithActorLabel {\n  actorLabel: string | null;\n}\n\nexport type ActorSpendRowWithLabel = ActorSpendRow & WithActorLabel;\nexport type ThreadSpendRowWithLabel = ThreadSpendRow & WithActorLabel;\nexport type ThreadActivityRowWithLabel = ThreadActivityRow & WithActorLabel;\n\n/** The spend/usage overview the SPA renders on its headline section (`GET <api>/spend`). */\nexport interface SpendOverview {\n  byModel: ModelSpendRow[];\n  byActor: ActorSpendRowWithLabel[];\n  trend: UsageTrendPoint[];\n}\n\n/** The message returned as a 501 when no `AGENT_PRICING_STORE` is bound. */\nconst PRICING_STORE_UNBOUND_MESSAGE =\n  'Pricing CRUD is unavailable: no AGENT_PRICING_STORE is bound. Bind a pricing store (e.g. ' +\n  'MikroOrmPricingStore from @dudousxd/nestjs-agent-store-mikro-orm) to enable it.';\n\n/** One live agent event forwarded over SSE, flattened from the `aviary:agent:*` diagnostics envelope. */\nexport interface LiveAgentEvent {\n  /** The event name, e.g. `run.started` / `tool-call` / `quota.exceeded`. */\n  event: string;\n  /** Epoch millis the event was emitted. */\n  ts: number;\n  /** The library-defined payload (see the `Agent*Event` shapes in core's diagnostics). */\n  payload: Record<string, unknown>;\n}\n\n/** The `aviary:agent:*` events the Live feed tails. Mirrors the telescope watcher's subscription. */\nconst AGENT_EVENTS = [\n  'run.started',\n  'message',\n  'tool-call',\n  'quota.exceeded',\n  'run.finished',\n  'delegated',\n] as const;\n\n/** The `node:diagnostics_channel` envelope `emit()` publishes (see `@dudousxd/nestjs-diagnostics`). */\ninterface AgentDiagnosticEnvelope {\n  event: string;\n  ts?: number;\n  payload?: Record<string, unknown>;\n}\n\n/** Narrow the untyped diagnostics-channel message to the envelope we forward. */\nfunction isAgentEnvelope(message: unknown): message is AgentDiagnosticEnvelope {\n  return (\n    typeof message === 'object' &&\n    message !== null &&\n    'event' in message &&\n    typeof (message as { event: unknown }).event === 'string'\n  );\n}\n\n/**\n * Read-model + live bridge backing the AI-gateway console.\n *\n * - Historical, restart-surviving spend/usage/threads come from the injected\n *   {@link AGENT_GOVERNANCE_QUERIES} read-model (backed by a store adapter). The host must provide\n *   that token — bind it via your `@dudousxd/nestjs-agent` module (global) alongside this dashboard.\n * - Live activity comes off the `aviary:agent:*` diagnostics channel, subscribed per SSE client and\n *   unsubscribed when the client disconnects.\n * - `actorLabel` on actor-scoped rows comes from the OPTIONAL {@link AGENT_ACTOR_DIRECTORY} — `null`\n *   on every row when nothing is bound, so the console degrades to raw `actorRef`s instead of failing.\n * - Pricing CRUD (`listPrices`/`upsertPrice`) reads/writes the OPTIONAL {@link AGENT_PRICING_STORE} —\n *   a 501 with a clear message when nothing is bound.\n */\n@Injectable()\nexport class DashboardService {\n  constructor(\n    @Inject(AGENT_GOVERNANCE_QUERIES) private readonly queries: AgentGovernanceQueries,\n    @Optional()\n    @Inject(AGENT_ACTOR_DIRECTORY)\n    private readonly actorDirectory?: ActorDirectory,\n    @Optional()\n    @Inject(AGENT_PRICING_STORE)\n    private readonly pricingStore?: AgentPricingStore,\n  ) {}\n\n  /** Spend/usage overview for a day range: by-model + by-actor spend and the daily trend, in parallel. */\n  async spend(range: GovernanceRange): Promise<SpendOverview> {\n    const [byModel, byActorRaw, trend] = await Promise.all([\n      this.queries.spendByModel(range),\n      this.queries.spendByActor(range),\n      this.queries.usageTrend(range),\n    ]);\n    const byActor = await this.withActorLabels(byActorRaw);\n    return { byModel, byActor, trend };\n  }\n\n  /** Top threads by cost for a day range (default 10, highest cost first). */\n  async topThreads(range: GovernanceRange, limit = 10): Promise<ThreadSpendRowWithLabel[]> {\n    const rows = await this.queries.spendByThread(range, limit);\n    return this.withActorLabels(rows);\n  }\n\n  /** Most recent tool calls (status/type/thread) for the Runs & tools activity feed. */\n  recentToolCalls(limit: number): Promise<ToolCallActivityRow[]> {\n    return this.queries.recentToolCalls(limit);\n  }\n\n  /** Most recent threads with rolled-up message/token counts. */\n  async recentThreads(limit: number): Promise<ThreadActivityRowWithLabel[]> {\n    const rows = await this.queries.recentThreads(limit);\n    return this.withActorLabels(rows);\n  }\n\n  /**\n   * Decorate actor-scoped rows with `actorLabel`, batching the distinct `actorRef`s into ONE\n   * {@link ActorDirectory.resolveDisplay} call per response. `null` for every row when no directory\n   * is bound, or for a ref the directory didn't resolve.\n   */\n  private async withActorLabels<Row extends { actorRef: string }>(\n    rows: Row[],\n  ): Promise<(Row & WithActorLabel)[]> {\n    if (rows.length === 0) {\n      return [];\n    }\n    if (this.actorDirectory === undefined) {\n      return rows.map((row) => ({ ...row, actorLabel: null }));\n    }\n    const refs = [...new Set(rows.map((row) => row.actorRef))];\n    const resolved = await this.actorDirectory.resolveDisplay(refs);\n    return rows.map((row) => ({ ...row, actorLabel: resolved[row.actorRef] ?? null }));\n  }\n\n  /** Current price row per model, for the pricing tab. 501s when no `AGENT_PRICING_STORE` is bound. */\n  async listPrices(): Promise<CurrentModelPrice[]> {\n    if (this.pricingStore === undefined) {\n      throw new NotImplementedException(PRICING_STORE_UNBOUND_MESSAGE);\n    }\n    return this.pricingStore.listCurrentPrices();\n  }\n\n  /**\n   * Set a model's current price (`POST <api>/pricing` body). 501s when no `AGENT_PRICING_STORE` is\n   * bound (checked BEFORE body validation, so an unbound store always reports as unimplemented rather\n   * than as a validation error); otherwise the body is minimally validated via {@link parsePriceInput}.\n   */\n  async upsertPrice(body: unknown): Promise<void> {\n    if (this.pricingStore === undefined) {\n      throw new NotImplementedException(PRICING_STORE_UNBOUND_MESSAGE);\n    }\n    await this.pricingStore.upsertModelPrice(parsePriceInput(body));\n  }\n\n  /**\n   * Live SSE stream of `aviary:agent:*` diagnostics events. One subscription per SSE client:\n   * subscribing wires a handler onto each agent channel; the returned teardown removes them all when\n   * the client disconnects (or the observable is otherwise unsubscribed).\n   */\n  streamEvents(): Observable<{ data: LiveAgentEvent }> {\n    return new Observable<{ data: LiveAgentEvent }>((subscriber) => {\n      const bindings = AGENT_EVENTS.map((event) => {\n        const name = channelName('agent', event);\n        const handler = (message: unknown): void => {\n          if (!isAgentEnvelope(message)) return;\n          subscriber.next({\n            data: {\n              event: message.event,\n              ts: message.ts ?? Date.now(),\n              payload: message.payload ?? {},\n            },\n          });\n        };\n        subscribe(name, handler);\n        return { name, handler };\n      });\n      return () => {\n        for (const binding of bindings) unsubscribe(binding.name, binding.handler);\n      };\n    });\n  }\n}\n","import type { ModelPriceInput } from '@dudousxd/nestjs-agent-core';\nimport { BadRequestException } from '@nestjs/common';\n\n/**\n * Minimal shape guard for a `POST <api>/pricing` body — rejects junk before it reaches\n * `AgentPricingStore.upsertModelPrice`. Not a full schema validator (the store adapter owns real\n * constraints, e.g. uniqueness); this only checks the wire shape core's `ModelPriceInput` requires.\n */\nexport function parsePriceInput(body: unknown): ModelPriceInput {\n  if (typeof body !== 'object' || body === null) {\n    throw new BadRequestException('Expected a JSON object body.');\n  }\n  const { modelId, inputPricePer1m, outputPricePer1m, cacheWritePricePer1m, cacheReadPricePer1m } =\n    body as Record<string, unknown>;\n\n  if (typeof modelId !== 'string' || modelId.trim().length === 0) {\n    throw new BadRequestException('\"modelId\" must be a non-empty string.');\n  }\n  if (!isFiniteNonNegative(inputPricePer1m)) {\n    throw new BadRequestException('\"inputPricePer1m\" must be a non-negative number.');\n  }\n  if (!isFiniteNonNegative(outputPricePer1m)) {\n    throw new BadRequestException('\"outputPricePer1m\" must be a non-negative number.');\n  }\n  if (cacheWritePricePer1m !== undefined && !isFiniteNonNegative(cacheWritePricePer1m)) {\n    throw new BadRequestException(\n      '\"cacheWritePricePer1m\" must be a non-negative number when present.',\n    );\n  }\n  if (cacheReadPricePer1m !== undefined && !isFiniteNonNegative(cacheReadPricePer1m)) {\n    throw new BadRequestException(\n      '\"cacheReadPricePer1m\" must be a non-negative number when present.',\n    );\n  }\n\n  return {\n    modelId,\n    inputPricePer1m,\n    outputPricePer1m,\n    ...(cacheWritePricePer1m !== undefined ? { cacheWritePricePer1m } : {}),\n    ...(cacheReadPricePer1m !== undefined ? { cacheReadPricePer1m } : {}),\n  };\n}\n\nfunction isFiniteNonNegative(value: unknown): value is number {\n  return typeof value === 'number' && Number.isFinite(value) && value >= 0;\n}\n","/**\n * DI tokens for the standalone AI-gateway dashboard.\n *\n * All use `Symbol.for(...)` (the global symbol registry) on purpose: pnpm peer multiplexing + dual\n * ESM/CJS can load a package more than once, and a plain `Symbol()` would mint a distinct token per\n * copy and break DI across the ESM/CJS split. A registered symbol collapses every copy onto the same\n * token.\n */\n\n/**\n * The governance read-model, owned by `@dudousxd/nestjs-agent-core`. We re-declare it here BY VALUE\n * (not by import) so DI does not depend on a runtime value-import of core resolving — `Symbol.for`\n * with the identical key resolves to the SAME symbol instance as core's own\n * `packages/core/src/tokens.ts` export. The key MUST stay byte-identical with that export.\n */\nexport const AGENT_GOVERNANCE_QUERIES = Symbol.for('@dudousxd/nestjs-agent:governance-queries');\n\n/**\n * Optional actor→label resolver (see {@link ActorDirectory} in `./actor-directory.js`), owned by\n * `@dudousxd/nestjs-agent-core`. Re-declared here BY VALUE for the same reason as\n * {@link AGENT_GOVERNANCE_QUERIES} above — the key MUST stay byte-identical with core's own\n * `AGENT_ACTOR_DIRECTORY` export so both copies collapse onto the same registered symbol. Optional:\n * the dashboard works with actorRef-only rows when nothing is bound.\n */\nexport const AGENT_ACTOR_DIRECTORY = Symbol.for('@dudousxd/nestjs-agent:actor-directory');\n\n/**\n * The pricing WRITE side (`AgentPricingStore`), owned by `@dudousxd/nestjs-agent-core`. Re-declared\n * here BY VALUE for the same reason as {@link AGENT_GOVERNANCE_QUERIES} above. Optional: the pricing\n * tab/endpoints 501 with a clear message when nothing is bound.\n */\nexport const AGENT_PRICING_STORE = Symbol.for('@dudousxd/nestjs-agent:pricing-store');\n\n/** DI token carrying the UI mount base (e.g. `/ai-gateway`). */\nexport const DASHBOARD_BASE_PATH = Symbol.for('@dudousxd/nestjs-agent-dashboard:base-path');\n\n/** DI token carrying the JSON API base the SPA fetches from (e.g. `/ai-gateway/api`). */\nexport const DASHBOARD_API_PATH = Symbol.for('@dudousxd/nestjs-agent-dashboard:api-path');\n","/**\n * Leading slash, no trailing slash (`'ai-gateway/'` -> `'/ai-gateway'`). Shared by\n * {@link AgentDashboardModule.forRoot} and {@link agentDashboardMountPaths} so the mount-path math\n * behind the module and the pure helper that mirrors it can never drift apart.\n */\nexport function normalizeDashboardPath(path: string): string {\n  return `/${path.replace(/^\\/+|\\/+$/g, '')}`;\n}\n","import { normalizeDashboardPath } from './normalize-path.js';\n\n/** Same shape {@link AgentDashboardModule.forRoot} accepts — kept local so this stays a pure, DI-free helper. */\nexport interface AgentDashboardMountPathsOptions {\n  basePath?: string;\n  apiBasePath?: string;\n}\n\n/** Strip the leading slash `normalizeDashboardPath` adds — `setGlobalPrefix`'s `exclude` roots are unprefixed. */\nfunction unprefixed(path: string): string {\n  return path.replace(/^\\/+/, '');\n}\n\n/**\n * Route roots a host must EXCLUDE from a global prefix (`setGlobalPrefix('api', { exclude })`) so\n * the AI-gateway dashboard's SPA and JSON API keep resolving at their configured mount paths instead\n * of being shifted under the prefix.\n *\n * Unlike a single-surface dashboard (e.g. `telescopeMountPaths()`), this one mounts TWO route roots —\n * the UI at `basePath` and its JSON API at `apiBasePath` — so excluding only one leaves the other\n * shadowed. `options` mirrors {@link AgentDashboardOptions} and resolves through the exact same\n * defaulting (`apiBasePath` falls back to `<basePath>/api`) as {@link AgentDashboardModule.forRoot},\n * so the excluded roots always agree with what actually got mounted.\n *\n * @example\n * ```ts\n * // Raw defaults (basePath `/ai-gateway`, apiBasePath `/ai-gateway/api`):\n * app.setGlobalPrefix('api', { exclude: agentDashboardMountPaths() });\n * // -> ['ai-gateway', 'ai-gateway/{*splat}', 'ai-gateway/api', 'ai-gateway/api/{*splat}']\n *\n * // The recommended pattern — apiBasePath nested under the app's own `/api` prefix — MUST pass the\n * // same options given to `forRoot(...)`:\n * const dashboardOptions = { apiBasePath: '/api/ai-gateway' };\n * app.setGlobalPrefix('api', { exclude: agentDashboardMountPaths(dashboardOptions) });\n * // -> ['ai-gateway', 'ai-gateway/{*splat}', 'api/ai-gateway', 'api/ai-gateway/{*splat}']\n * ```\n */\nexport function agentDashboardMountPaths(options?: AgentDashboardMountPathsOptions): string[] {\n  const basePath = normalizeDashboardPath(options?.basePath ?? '/ai-gateway');\n  const apiBasePath = normalizeDashboardPath(options?.apiBasePath ?? `${basePath}/api`);\n  const base = unprefixed(basePath);\n  const api = unprefixed(apiBasePath);\n  return [base, `${base}/{*splat}`, api, `${api}/{*splat}`];\n}\n","import 'reflect-metadata';\nimport { type CanActivate, type DynamicModule, Module, type Type } from '@nestjs/common';\nimport { RouterModule } from '@nestjs/core';\nimport { AgentApiController } from './agent-api.controller.js';\nimport { AgentUiController } from './agent-ui.controller.js';\nimport { DashboardService } from './dashboard.service.js';\nimport { normalizeDashboardPath } from './normalize-path.js';\nimport { DASHBOARD_API_PATH, DASHBOARD_BASE_PATH } from './tokens.js';\n\n/**\n * `@nestjs/common`'s own `GUARDS_METADATA` key, INLINED rather than deep-imported from\n * '@nestjs/common/constants' — that subpath has no extension and a strict ESM resolver (which the\n * built dual ESM/CJS output of this package is loaded under) 404s on it. A drift spec imports the\n * real constant (via the resolvable `'@nestjs/common/constants.js'` subpath) and asserts this literal\n * stays byte-identical to it.\n */\nconst GUARDS_METADATA = '__guards__';\n\nexport interface AgentDashboardOptions {\n  /**\n   * Where the SPA (UI) is served. Default `/ai-gateway`. This is a page route — keep it out of an\n   * `/api` prefix so it reads as a UI, not an endpoint.\n   */\n  basePath?: string;\n  /**\n   * Where the JSON API is mounted (what the SPA fetches). Default `<basePath>/api`. Set it under\n   * your app's `/api` prefix — e.g. `/api/ai-gateway` — so the API inherits the app's auth/proxy\n   * rules while the UI stays at `basePath`.\n   */\n  apiBasePath?: string;\n  /**\n   * Guard classes fronting BOTH dashboard controllers (the SPA at `basePath` and its JSON API at\n   * `apiBasePath`). Stamped onto each controller via `@nestjs/common`'s own `@UseGuards` metadata key\n   * — REPLACE semantics, so a second `forRoot(...)` call overwrites (not appends to) whatever a prior\n   * call stamped, same as re-applying `@UseGuards` by hand. Omit to leave the routes unguarded (the\n   * host fronts them another way, e.g. a global guard or reverse-proxy auth).\n   *\n   * A guard's own DEPENDENCIES resolve from this module's `imports` (see {@link imports}) — the\n   * dashboard module has no application context of its own to pull them from otherwise.\n   */\n  guards?: Type<CanActivate>[];\n  /**\n   * Extra `imports` merged into the dashboard's dynamic module — the DI resolution path for a class\n   * passed to {@link guards} (or any other provider the controllers need reachable). Typically the\n   * host's own auth module, e.g. `imports: [AuthModule]` alongside `guards: [JwtAuthGuard]`.\n   */\n  imports?: DynamicModule['imports'];\n}\n\n/** Leading slash, no trailing slash. */\nfunction normalize(path: string): string {\n  return normalizeDashboardPath(path);\n}\n\n/** Stamp (or clear) `@UseGuards`-equivalent metadata on the dashboard controllers — REPLACE, not append. */\nfunction stampGuards(guards: Type<CanActivate>[] | undefined, ...controllers: Type[]): void {\n  for (const controller of controllers) {\n    Reflect.defineMetadata(GUARDS_METADATA, guards ?? [], controller);\n  }\n}\n\n/**\n * Holds the JSON API + SSE controller and its read service, mounted on its own path by `forRoot`.\n * Dynamic: guards are DI-instantiated by the CONTROLLER's host module, so this module — not the\n * outer wrapper — must carry the guard classes as providers plus the host's `imports` that resolve\n * their dependencies. A static module here made `guards: [SomeGuardWithDeps]` fail at boot with\n * \"Nest can't resolve dependencies ... in the AgentApiModule context\" even when the host passed\n * the right `imports` to `forRoot`.\n */\n@Module({})\nexport class AgentApiModule {\n  static register(options: {\n    imports?: DynamicModule['imports'];\n    guards?: Type<CanActivate>[];\n  }): DynamicModule {\n    return {\n      module: AgentApiModule,\n      imports: [...(options.imports ?? [])],\n      controllers: [AgentApiController],\n      providers: [DashboardService, ...(options.guards ?? [])],\n      exports: [DashboardService],\n    };\n  }\n}\n\n/**\n * Mounts the AI-gateway governance console: the bundled React SPA at `basePath` and its JSON + SSE\n * API at `apiBasePath` (default `<basePath>/api`).\n *\n * Import via `AgentDashboardModule.forRoot(...)` alongside your `@dudousxd/nestjs-agent` module\n * (global), which must provide `AGENT_GOVERNANCE_QUERIES` (bound by a store adapter). Front the\n * routes with the first-class `guards` option (plus `imports` for the guards' own dependencies) —\n * see {@link AgentDashboardOptions.guards}.\n */\n@Module({})\nexport class AgentDashboardModule {\n  static forRoot(options: AgentDashboardOptions = {}): DynamicModule {\n    const basePath = normalize(options.basePath ?? '/ai-gateway');\n    const apiBasePath = normalize(options.apiBasePath ?? `${basePath}/api`);\n    stampGuards(options.guards, AgentApiController, AgentUiController);\n    return {\n      module: AgentDashboardModule,\n      imports: [\n        ...(options.imports ?? []),\n        // Guards + host imports must reach the API controller's HOST module — enhancers resolve\n        // from their controller's own module, never from a parent (see AgentApiModule.register).\n        // Spread-only-when-set: exactOptionalPropertyTypes rejects an explicit `undefined`.\n        AgentApiModule.register({\n          ...(options.imports ? { imports: options.imports } : {}),\n          ...(options.guards ? { guards: options.guards } : {}),\n        }),\n        RouterModule.register([\n          { path: basePath, module: AgentDashboardModule }, // the UI controller below\n          { path: apiBasePath, module: AgentApiModule },\n        ]),\n      ],\n      controllers: [AgentUiController],\n      providers: [\n        { provide: DASHBOARD_BASE_PATH, useValue: basePath },\n        { provide: DASHBOARD_API_PATH, useValue: apiBasePath },\n        // AgentUiController is hosted HERE, so its guards DI-instantiate from this module.\n        ...(options.guards ?? []),\n      ],\n      // Re-export the API module so its DashboardService reaches importers (e.g. the host's own controllers).\n      exports: [AgentApiModule],\n    };\n  }\n}\n","import { existsSync, readFileSync } from 'node:fs';\nimport { basename, extname, join, resolve, sep } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport {\n  Controller,\n  Get,\n  Header,\n  Inject,\n  NotFoundException,\n  Param,\n  StreamableFile,\n} from '@nestjs/common';\nimport { DASHBOARD_API_PATH, DASHBOARD_BASE_PATH } from './tokens.js';\n\n/** The base the SPA bundle was built with (Vite `base`); rewritten to the configured base at serve time. */\nconst BUILD_BASE = '/ai-gateway';\n\n/** dist/server/agent-ui.controller.js -> ../spa (the Vite build output). */\nfunction spaDir(): string {\n  return fileURLToPath(new URL('../spa', import.meta.url));\n}\n\nconst CONTENT_TYPES: Record<string, string> = {\n  '.js': 'text/javascript; charset=utf-8',\n  '.css': 'text/css; charset=utf-8',\n  '.map': 'application/json; charset=utf-8',\n  '.svg': 'image/svg+xml',\n  '.json': 'application/json; charset=utf-8',\n  '.woff2': 'font/woff2',\n  '.ico': 'image/x-icon',\n};\n\n/**\n * Serves the bundled AI-gateway console SPA at the configured base (+ hashed assets at\n * `<base>/assets`). The path comes from `RouterModule` (set by\n * {@link AgentDashboardModule.forRoot}({ basePath })), so the controller routes are relative.\n */\n@Controller()\nexport class AgentUiController {\n  private readonly dir = spaDir();\n\n  constructor(\n    @Inject(DASHBOARD_BASE_PATH) private readonly basePath: string,\n    @Inject(DASHBOARD_API_PATH) private readonly apiBasePath: string,\n  ) {}\n\n  // index.html references hash-named bundles, so it MUST NOT be cached (stale bundle = the classic\n  // \"stuck loading after a deploy\"). The hashed assets below are immutable.\n  @Get()\n  @Header('Content-Type', 'text/html; charset=utf-8')\n  @Header('Cache-Control', 'no-store, must-revalidate')\n  index(): string {\n    const indexPath = join(this.dir, 'index.html');\n    if (!existsSync(indexPath)) {\n      throw new NotFoundException('Dashboard is not built. Run the package build.');\n    }\n    // The bundle was built with Vite base `/ai-gateway/`; rewrite asset URLs to the configured base\n    // so the SPA loads from `<base>/assets` wherever it's mounted, and tell the client its API base.\n    const html = readFileSync(indexPath, 'utf8').replaceAll(\n      `=\"${BUILD_BASE}/`,\n      `=\"${this.basePath}/`,\n    );\n    // __AGENT_BASE__ = where assets load; __AGENT_API__ = where the SPA fetches the JSON API.\n    const inject = `<script>window.__AGENT_BASE__='${this.basePath}';window.__AGENT_API__='${this.apiBasePath}';</script>`;\n    return html.includes('</head>') ? html.replace('</head>', `${inject}</head>`) : inject + html;\n  }\n\n  @Get('assets/:file')\n  @Header('Cache-Control', 'public, max-age=31536000, immutable')\n  asset(@Param('file') file: string): StreamableFile {\n    const safe = basename(file);\n    if (safe !== file) throw new NotFoundException();\n    const root = resolve(this.dir, 'assets');\n    const assetPath = resolve(root, safe);\n    if (!assetPath.startsWith(root + sep) || !existsSync(assetPath)) {\n      throw new NotFoundException();\n    }\n    const type = CONTENT_TYPES[extname(safe)] ?? 'application/octet-stream';\n    return new StreamableFile(readFileSync(assetPath), { type });\n  }\n}\n"],"mappings":"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","names":["import_common","import_common","parsePriceInput","body","BadRequestException","modelId","inputPricePer1m","outputPricePer1m","cacheWritePricePer1m","cacheReadPricePer1m","trim","length","isFiniteNonNegative","undefined","value","Number","isFinite","AGENT_GOVERNANCE_QUERIES","Symbol","for","AGENT_ACTOR_DIRECTORY","AGENT_PRICING_STORE","DASHBOARD_BASE_PATH","DASHBOARD_API_PATH","PRICING_STORE_UNBOUND_MESSAGE","AGENT_EVENTS","isAgentEnvelope","message","event","DashboardService","queries","actorDirectory","pricingStore","spend","range","byModel","byActorRaw","trend","Promise","all","spendByModel","spendByActor","usageTrend","byActor","withActorLabels","topThreads","limit","rows","spendByThread","recentToolCalls","recentThreads","length","undefined","map","row","actorLabel","refs","Set","actorRef","resolved","resolveDisplay","listPrices","NotImplementedException","listCurrentPrices","upsertPrice","body","upsertModelPrice","parsePriceInput","streamEvents","Observable","subscriber","bindings","name","channelName","handler","next","data","ts","Date","now","payload","subscribe","binding","unsubscribe","DAY_MS","ISO_DAY","utcDay","daysAgo","Date","now","toISOString","slice","dayOr","value","fallback","undefined","test","resolveRange","from","to","fromDay","toDay","parseLimit","parsed","Number","NaN","parseInt","isFinite","Math","max","min","AgentApiController","dashboard","spend","topThreads","limit","toolCalls","recentToolCalls","threads","recentThreads","listPrices","upsertPrice","body","stream","streamEvents","normalizeDashboardPath","path","replace","unprefixed","path","replace","agentDashboardMountPaths","options","basePath","normalizeDashboardPath","apiBasePath","base","api","import_common","import_common","BUILD_BASE","spaDir","fileURLToPath","URL","CONTENT_TYPES","AgentUiController","dir","basePath","apiBasePath","index","indexPath","join","existsSync","NotFoundException","html","readFileSync","replaceAll","inject","includes","replace","asset","file","safe","basename","root","resolve","assetPath","startsWith","sep","type","extname","StreamableFile","GUARDS_METADATA","normalize","path","normalizeDashboardPath","stampGuards","guards","controllers","controller","Reflect","defineMetadata","AgentApiModule","register","options","module","imports","AgentApiController","providers","DashboardService","exports","AgentDashboardModule","forRoot","basePath","apiBasePath","AgentUiController","RouterModule","provide","DASHBOARD_BASE_PATH","useValue","DASHBOARD_API_PATH"]}

package/dist/server/index.d.cts

@@ -1,11 +1,19 @@
-import { AgentGovernanceQueries, GovernanceRange, ModelSpendRow, ActorSpendRow, UsageTrendPoint, ThreadSpendRow, ToolCallActivityRow, ThreadActivityRow } from '@dudousxd/nestjs-agent-core';
+import { ActorSpendRow, AgentGovernanceQueries, ActorDirectory, AgentPricingStore, GovernanceRange, ModelSpendRow, UsageTrendPoint, ThreadSpendRow, ToolCallActivityRow, ThreadActivityRow, CurrentModelPrice, ModelPriceInput } from '@dudousxd/nestjs-agent-core';
+export { ActorDirectory } from '@dudousxd/nestjs-agent-core';
 import { Observable } from 'rxjs';
-import { DynamicModule, StreamableFile } from '@nestjs/common';
+import { DynamicModule, Type, CanActivate, StreamableFile } from '@nestjs/common';
 
+/** An actor-scoped row decorated with its resolved display label — `null` when unbound or unresolved. */
+interface WithActorLabel {
+    actorLabel: string | null;
+}
+type ActorSpendRowWithLabel = ActorSpendRow & WithActorLabel;
+type ThreadSpendRowWithLabel = ThreadSpendRow & WithActorLabel;
+type ThreadActivityRowWithLabel = ThreadActivityRow & WithActorLabel;
 /** The spend/usage overview the SPA renders on its headline section (`GET <api>/spend`). */
 interface SpendOverview {
     byModel: ModelSpendRow[];
-    byActor: ActorSpendRow[];
+    byActor: ActorSpendRowWithLabel[];
     trend: UsageTrendPoint[];
 }
 /** One live agent event forwarded over SSE, flattened from the `aviary:agent:*` diagnostics envelope. */
@@ -25,18 +33,38 @@ interface LiveAgentEvent {
  *   that token — bind it via your `@dudousxd/nestjs-agent` module (global) alongside this dashboard.
  * - Live activity comes off the `aviary:agent:*` diagnostics channel, subscribed per SSE client and
  *   unsubscribed when the client disconnects.
+ * - `actorLabel` on actor-scoped rows comes from the OPTIONAL {@link AGENT_ACTOR_DIRECTORY} — `null`
+ *   on every row when nothing is bound, so the console degrades to raw `actorRef`s instead of failing.
+ * - Pricing CRUD (`listPrices`/`upsertPrice`) reads/writes the OPTIONAL {@link AGENT_PRICING_STORE} —
+ *   a 501 with a clear message when nothing is bound.
  */
 declare class DashboardService {
     private readonly queries;
-    constructor(queries: AgentGovernanceQueries);
+    private readonly actorDirectory?;
+    private readonly pricingStore?;
+    constructor(queries: AgentGovernanceQueries, actorDirectory?: ActorDirectory | undefined, pricingStore?: AgentPricingStore | undefined);
     /** Spend/usage overview for a day range: by-model + by-actor spend and the daily trend, in parallel. */
     spend(range: GovernanceRange): Promise<SpendOverview>;
     /** Top threads by cost for a day range (default 10, highest cost first). */
-    topThreads(range: GovernanceRange, limit?: number): Promise<ThreadSpendRow[]>;
+    topThreads(range: GovernanceRange, limit?: number): Promise<ThreadSpendRowWithLabel[]>;
     /** Most recent tool calls (status/type/thread) for the Runs & tools activity feed. */
     recentToolCalls(limit: number): Promise<ToolCallActivityRow[]>;
     /** Most recent threads with rolled-up message/token counts. */
-    recentThreads(limit: number): Promise<ThreadActivityRow[]>;
+    recentThreads(limit: number): Promise<ThreadActivityRowWithLabel[]>;
+    /**
+     * Decorate actor-scoped rows with `actorLabel`, batching the distinct `actorRef`s into ONE
+     * {@link ActorDirectory.resolveDisplay} call per response. `null` for every row when no directory
+     * is bound, or for a ref the directory didn't resolve.
+     */
+    private withActorLabels;
+    /** Current price row per model, for the pricing tab. 501s when no `AGENT_PRICING_STORE` is bound. */
+    listPrices(): Promise<CurrentModelPrice[]>;
+    /**
+     * Set a model's current price (`POST <api>/pricing` body). 501s when no `AGENT_PRICING_STORE` is
+     * bound (checked BEFORE body validation, so an unbound store always reports as unimplemented rather
+     * than as a validation error); otherwise the body is minimally validated via {@link parsePriceInput}.
+     */
+    upsertPrice(body: unknown): Promise<void>;
     /**
      * Live SSE stream of `aviary:agent:*` diagnostics events. One subscription per SSE client:
      * subscribing wires a handler onto each agent channel; the returned teardown removes them all when
@@ -57,17 +85,59 @@ declare class AgentApiController {
     /** `{ byModel, byActor, trend }` for a day range (defaults to the last 30 days). */
     spend(from?: string, to?: string): Promise<SpendOverview>;
     /** Top threads by cost (default 10, max 200) for a day range (defaults to the last 30 days). */
-    topThreads(from?: string, to?: string, limit?: string): Promise<ThreadSpendRow[]>;
+    topThreads(from?: string, to?: string, limit?: string): Promise<ThreadSpendRowWithLabel[]>;
     /** Most recent tool calls (default 50, max 200) for the activity feed. */
     toolCalls(limit?: string): Promise<ToolCallActivityRow[]>;
     /** Most recent threads (default 50, max 200) with rolled-up counts. */
-    threads(limit?: string): Promise<ThreadActivityRow[]>;
+    threads(limit?: string): Promise<ThreadActivityRowWithLabel[]>;
+    /**
+     * Current price row per model, for the pricing tab. 501s (via `DashboardService.listPrices`) when
+     * no `AGENT_PRICING_STORE` is bound.
+     */
+    listPrices(): Promise<CurrentModelPrice[]>;
+    /**
+     * Set a model's current price. Body shape mirrors core's `ModelPriceInput`
+     * (`{ modelId, inputPricePer1m, outputPricePer1m, cacheWritePricePer1m?, cacheReadPricePer1m? }`).
+     * 501s when no `AGENT_PRICING_STORE` is bound; 400s on a malformed body.
+     */
+    upsertPrice(body: unknown): Promise<void>;
     /** Server-Sent Events stream of live `aviary:agent:*` events — the Live feed tails it. */
     stream(): Observable<{
         data: LiveAgentEvent;
     }>;
 }
 
+/** Same shape {@link AgentDashboardModule.forRoot} accepts — kept local so this stays a pure, DI-free helper. */
+interface AgentDashboardMountPathsOptions {
+    basePath?: string;
+    apiBasePath?: string;
+}
+/**
+ * Route roots a host must EXCLUDE from a global prefix (`setGlobalPrefix('api', { exclude })`) so
+ * the AI-gateway dashboard's SPA and JSON API keep resolving at their configured mount paths instead
+ * of being shifted under the prefix.
+ *
+ * Unlike a single-surface dashboard (e.g. `telescopeMountPaths()`), this one mounts TWO route roots —
+ * the UI at `basePath` and its JSON API at `apiBasePath` — so excluding only one leaves the other
+ * shadowed. `options` mirrors {@link AgentDashboardOptions} and resolves through the exact same
+ * defaulting (`apiBasePath` falls back to `<basePath>/api`) as {@link AgentDashboardModule.forRoot},
+ * so the excluded roots always agree with what actually got mounted.
+ *
+ * @example
+ * ```ts
+ * // Raw defaults (basePath `/ai-gateway`, apiBasePath `/ai-gateway/api`):
+ * app.setGlobalPrefix('api', { exclude: agentDashboardMountPaths() });
+ * // -> ['ai-gateway', 'ai-gateway/{*splat}', 'ai-gateway/api', 'ai-gateway/api/{*splat}']
+ *
+ * // The recommended pattern — apiBasePath nested under the app's own `/api` prefix — MUST pass the
+ * // same options given to `forRoot(...)`:
+ * const dashboardOptions = { apiBasePath: '/api/ai-gateway' };
+ * app.setGlobalPrefix('api', { exclude: agentDashboardMountPaths(dashboardOptions) });
+ * // -> ['ai-gateway', 'ai-gateway/{*splat}', 'api/ai-gateway', 'api/ai-gateway/{*splat}']
+ * ```
+ */
+declare function agentDashboardMountPaths(options?: AgentDashboardMountPathsOptions): string[];
+
 interface AgentDashboardOptions {
     /**
      * Where the SPA (UI) is served. Default `/ai-gateway`. This is a page route — keep it out of an
@@ -80,9 +150,37 @@ interface AgentDashboardOptions {
      * rules while the UI stays at `basePath`.
      */
     apiBasePath?: string;
+    /**
+     * Guard classes fronting BOTH dashboard controllers (the SPA at `basePath` and its JSON API at
+     * `apiBasePath`). Stamped onto each controller via `@nestjs/common`'s own `@UseGuards` metadata key
+     * — REPLACE semantics, so a second `forRoot(...)` call overwrites (not appends to) whatever a prior
+     * call stamped, same as re-applying `@UseGuards` by hand. Omit to leave the routes unguarded (the
+     * host fronts them another way, e.g. a global guard or reverse-proxy auth).
+     *
+     * A guard's own DEPENDENCIES resolve from this module's `imports` (see {@link imports}) — the
+     * dashboard module has no application context of its own to pull them from otherwise.
+     */
+    guards?: Type<CanActivate>[];
+    /**
+     * Extra `imports` merged into the dashboard's dynamic module — the DI resolution path for a class
+     * passed to {@link guards} (or any other provider the controllers need reachable). Typically the
+     * host's own auth module, e.g. `imports: [AuthModule]` alongside `guards: [JwtAuthGuard]`.
+     */
+    imports?: DynamicModule['imports'];
 }
-/** Holds the JSON API + SSE controller and its read service, mounted on its own path by `forRoot`. */
+/**
+ * Holds the JSON API + SSE controller and its read service, mounted on its own path by `forRoot`.
+ * Dynamic: guards are DI-instantiated by the CONTROLLER's host module, so this module — not the
+ * outer wrapper — must carry the guard classes as providers plus the host's `imports` that resolve
+ * their dependencies. A static module here made `guards: [SomeGuardWithDeps]` fail at boot with
+ * "Nest can't resolve dependencies ... in the AgentApiModule context" even when the host passed
+ * the right `imports` to `forRoot`.
+ */
 declare class AgentApiModule {
+    static register(options: {
+        imports?: DynamicModule['imports'];
+        guards?: Type<CanActivate>[];
+    }): DynamicModule;
 }
 /**
  * Mounts the AI-gateway governance console: the bundled React SPA at `basePath` and its JSON + SSE
@@ -90,7 +188,8 @@ declare class AgentApiModule {
  *
  * Import via `AgentDashboardModule.forRoot(...)` alongside your `@dudousxd/nestjs-agent` module
  * (global), which must provide `AGENT_GOVERNANCE_QUERIES` (bound by a store adapter). Front the
- * routes with your own guard — the controllers are path-relative and guard-frontable.
+ * routes with the first-class `guards` option (plus `imports` for the guards' own dependencies) —
+ * see {@link AgentDashboardOptions.guards}.
  */
 declare class AgentDashboardModule {
     static forRoot(options?: AgentDashboardOptions): DynamicModule;
@@ -110,6 +209,13 @@ declare class AgentUiController {
     asset(file: string): StreamableFile;
 }
 
+/**
+ * Minimal shape guard for a `POST <api>/pricing` body — rejects junk before it reaches
+ * `AgentPricingStore.upsertModelPrice`. Not a full schema validator (the store adapter owns real
+ * constraints, e.g. uniqueness); this only checks the wire shape core's `ModelPriceInput` requires.
+ */
+declare function parsePriceInput(body: unknown): ModelPriceInput;
+
 /**
  * DI tokens for the standalone AI-gateway dashboard.
  *
@@ -125,9 +231,23 @@ declare class AgentUiController {
  * `packages/core/src/tokens.ts` export. The key MUST stay byte-identical with that export.
  */
 declare const AGENT_GOVERNANCE_QUERIES: unique symbol;
+/**
+ * Optional actor→label resolver (see {@link ActorDirectory} in `./actor-directory.js`), owned by
+ * `@dudousxd/nestjs-agent-core`. Re-declared here BY VALUE for the same reason as
+ * {@link AGENT_GOVERNANCE_QUERIES} above — the key MUST stay byte-identical with core's own
+ * `AGENT_ACTOR_DIRECTORY` export so both copies collapse onto the same registered symbol. Optional:
+ * the dashboard works with actorRef-only rows when nothing is bound.
+ */
+declare const AGENT_ACTOR_DIRECTORY: unique symbol;
+/**
+ * The pricing WRITE side (`AgentPricingStore`), owned by `@dudousxd/nestjs-agent-core`. Re-declared
+ * here BY VALUE for the same reason as {@link AGENT_GOVERNANCE_QUERIES} above. Optional: the pricing
+ * tab/endpoints 501 with a clear message when nothing is bound.
+ */
+declare const AGENT_PRICING_STORE: unique symbol;
 /** DI token carrying the UI mount base (e.g. `/ai-gateway`). */
 declare const DASHBOARD_BASE_PATH: unique symbol;
 /** DI token carrying the JSON API base the SPA fetches from (e.g. `/ai-gateway/api`). */
 declare const DASHBOARD_API_PATH: unique symbol;
 
-export { AGENT_GOVERNANCE_QUERIES, AgentApiController, AgentApiModule, AgentDashboardModule, type AgentDashboardOptions, AgentUiController, DASHBOARD_API_PATH, DASHBOARD_BASE_PATH, DashboardService, type LiveAgentEvent, type SpendOverview };
+export { AGENT_ACTOR_DIRECTORY, AGENT_GOVERNANCE_QUERIES, AGENT_PRICING_STORE, type ActorSpendRowWithLabel, AgentApiController, AgentApiModule, AgentDashboardModule, type AgentDashboardMountPathsOptions, type AgentDashboardOptions, AgentUiController, DASHBOARD_API_PATH, DASHBOARD_BASE_PATH, DashboardService, type LiveAgentEvent, type SpendOverview, type ThreadActivityRowWithLabel, type ThreadSpendRowWithLabel, type WithActorLabel, agentDashboardMountPaths, parsePriceInput };

package/dist/server/index.d.ts

@@ -1,11 +1,19 @@
-import { AgentGovernanceQueries, GovernanceRange, ModelSpendRow, ActorSpendRow, UsageTrendPoint, ThreadSpendRow, ToolCallActivityRow, ThreadActivityRow } from '@dudousxd/nestjs-agent-core';
+import { ActorSpendRow, AgentGovernanceQueries, ActorDirectory, AgentPricingStore, GovernanceRange, ModelSpendRow, UsageTrendPoint, ThreadSpendRow, ToolCallActivityRow, ThreadActivityRow, CurrentModelPrice, ModelPriceInput } from '@dudousxd/nestjs-agent-core';
+export { ActorDirectory } from '@dudousxd/nestjs-agent-core';
 import { Observable } from 'rxjs';
-import { DynamicModule, StreamableFile } from '@nestjs/common';
+import { DynamicModule, Type, CanActivate, StreamableFile } from '@nestjs/common';
 
+/** An actor-scoped row decorated with its resolved display label — `null` when unbound or unresolved. */
+interface WithActorLabel {
+    actorLabel: string | null;
+}
+type ActorSpendRowWithLabel = ActorSpendRow & WithActorLabel;
+type ThreadSpendRowWithLabel = ThreadSpendRow & WithActorLabel;
+type ThreadActivityRowWithLabel = ThreadActivityRow & WithActorLabel;
 /** The spend/usage overview the SPA renders on its headline section (`GET <api>/spend`). */
 interface SpendOverview {
     byModel: ModelSpendRow[];
-    byActor: ActorSpendRow[];
+    byActor: ActorSpendRowWithLabel[];
     trend: UsageTrendPoint[];
 }
 /** One live agent event forwarded over SSE, flattened from the `aviary:agent:*` diagnostics envelope. */
@@ -25,18 +33,38 @@ interface LiveAgentEvent {
  *   that token — bind it via your `@dudousxd/nestjs-agent` module (global) alongside this dashboard.
  * - Live activity comes off the `aviary:agent:*` diagnostics channel, subscribed per SSE client and
  *   unsubscribed when the client disconnects.
+ * - `actorLabel` on actor-scoped rows comes from the OPTIONAL {@link AGENT_ACTOR_DIRECTORY} — `null`
+ *   on every row when nothing is bound, so the console degrades to raw `actorRef`s instead of failing.
+ * - Pricing CRUD (`listPrices`/`upsertPrice`) reads/writes the OPTIONAL {@link AGENT_PRICING_STORE} —
+ *   a 501 with a clear message when nothing is bound.
  */
 declare class DashboardService {
     private readonly queries;
-    constructor(queries: AgentGovernanceQueries);
+    private readonly actorDirectory?;
+    private readonly pricingStore?;
+    constructor(queries: AgentGovernanceQueries, actorDirectory?: ActorDirectory | undefined, pricingStore?: AgentPricingStore | undefined);
     /** Spend/usage overview for a day range: by-model + by-actor spend and the daily trend, in parallel. */
     spend(range: GovernanceRange): Promise<SpendOverview>;
     /** Top threads by cost for a day range (default 10, highest cost first). */
-    topThreads(range: GovernanceRange, limit?: number): Promise<ThreadSpendRow[]>;
+    topThreads(range: GovernanceRange, limit?: number): Promise<ThreadSpendRowWithLabel[]>;
     /** Most recent tool calls (status/type/thread) for the Runs & tools activity feed. */
     recentToolCalls(limit: number): Promise<ToolCallActivityRow[]>;
     /** Most recent threads with rolled-up message/token counts. */
-    recentThreads(limit: number): Promise<ThreadActivityRow[]>;
+    recentThreads(limit: number): Promise<ThreadActivityRowWithLabel[]>;
+    /**
+     * Decorate actor-scoped rows with `actorLabel`, batching the distinct `actorRef`s into ONE
+     * {@link ActorDirectory.resolveDisplay} call per response. `null` for every row when no directory
+     * is bound, or for a ref the directory didn't resolve.
+     */
+    private withActorLabels;
+    /** Current price row per model, for the pricing tab. 501s when no `AGENT_PRICING_STORE` is bound. */
+    listPrices(): Promise<CurrentModelPrice[]>;
+    /**
+     * Set a model's current price (`POST <api>/pricing` body). 501s when no `AGENT_PRICING_STORE` is
+     * bound (checked BEFORE body validation, so an unbound store always reports as unimplemented rather
+     * than as a validation error); otherwise the body is minimally validated via {@link parsePriceInput}.
+     */
+    upsertPrice(body: unknown): Promise<void>;
     /**
      * Live SSE stream of `aviary:agent:*` diagnostics events. One subscription per SSE client:
      * subscribing wires a handler onto each agent channel; the returned teardown removes them all when
@@ -57,17 +85,59 @@ declare class AgentApiController {
     /** `{ byModel, byActor, trend }` for a day range (defaults to the last 30 days). */
     spend(from?: string, to?: string): Promise<SpendOverview>;
     /** Top threads by cost (default 10, max 200) for a day range (defaults to the last 30 days). */
-    topThreads(from?: string, to?: string, limit?: string): Promise<ThreadSpendRow[]>;
+    topThreads(from?: string, to?: string, limit?: string): Promise<ThreadSpendRowWithLabel[]>;
     /** Most recent tool calls (default 50, max 200) for the activity feed. */
     toolCalls(limit?: string): Promise<ToolCallActivityRow[]>;
     /** Most recent threads (default 50, max 200) with rolled-up counts. */
-    threads(limit?: string): Promise<ThreadActivityRow[]>;
+    threads(limit?: string): Promise<ThreadActivityRowWithLabel[]>;
+    /**
+     * Current price row per model, for the pricing tab. 501s (via `DashboardService.listPrices`) when
+     * no `AGENT_PRICING_STORE` is bound.
+     */
+    listPrices(): Promise<CurrentModelPrice[]>;
+    /**
+     * Set a model's current price. Body shape mirrors core's `ModelPriceInput`
+     * (`{ modelId, inputPricePer1m, outputPricePer1m, cacheWritePricePer1m?, cacheReadPricePer1m? }`).
+     * 501s when no `AGENT_PRICING_STORE` is bound; 400s on a malformed body.
+     */
+    upsertPrice(body: unknown): Promise<void>;
     /** Server-Sent Events stream of live `aviary:agent:*` events — the Live feed tails it. */
     stream(): Observable<{
         data: LiveAgentEvent;
     }>;
 }
 
+/** Same shape {@link AgentDashboardModule.forRoot} accepts — kept local so this stays a pure, DI-free helper. */
+interface AgentDashboardMountPathsOptions {
+    basePath?: string;
+    apiBasePath?: string;
+}
+/**
+ * Route roots a host must EXCLUDE from a global prefix (`setGlobalPrefix('api', { exclude })`) so
+ * the AI-gateway dashboard's SPA and JSON API keep resolving at their configured mount paths instead
+ * of being shifted under the prefix.
+ *
+ * Unlike a single-surface dashboard (e.g. `telescopeMountPaths()`), this one mounts TWO route roots —
+ * the UI at `basePath` and its JSON API at `apiBasePath` — so excluding only one leaves the other
+ * shadowed. `options` mirrors {@link AgentDashboardOptions} and resolves through the exact same
+ * defaulting (`apiBasePath` falls back to `<basePath>/api`) as {@link AgentDashboardModule.forRoot},
+ * so the excluded roots always agree with what actually got mounted.
+ *
+ * @example
+ * ```ts
+ * // Raw defaults (basePath `/ai-gateway`, apiBasePath `/ai-gateway/api`):
+ * app.setGlobalPrefix('api', { exclude: agentDashboardMountPaths() });
+ * // -> ['ai-gateway', 'ai-gateway/{*splat}', 'ai-gateway/api', 'ai-gateway/api/{*splat}']
+ *
+ * // The recommended pattern — apiBasePath nested under the app's own `/api` prefix — MUST pass the
+ * // same options given to `forRoot(...)`:
+ * const dashboardOptions = { apiBasePath: '/api/ai-gateway' };
+ * app.setGlobalPrefix('api', { exclude: agentDashboardMountPaths(dashboardOptions) });
+ * // -> ['ai-gateway', 'ai-gateway/{*splat}', 'api/ai-gateway', 'api/ai-gateway/{*splat}']
+ * ```
+ */
+declare function agentDashboardMountPaths(options?: AgentDashboardMountPathsOptions): string[];
+
 interface AgentDashboardOptions {
     /**
      * Where the SPA (UI) is served. Default `/ai-gateway`. This is a page route — keep it out of an
@@ -80,9 +150,37 @@ interface AgentDashboardOptions {
      * rules while the UI stays at `basePath`.
      */
     apiBasePath?: string;
+    /**
+     * Guard classes fronting BOTH dashboard controllers (the SPA at `basePath` and its JSON API at
+     * `apiBasePath`). Stamped onto each controller via `@nestjs/common`'s own `@UseGuards` metadata key
+     * — REPLACE semantics, so a second `forRoot(...)` call overwrites (not appends to) whatever a prior
+     * call stamped, same as re-applying `@UseGuards` by hand. Omit to leave the routes unguarded (the
+     * host fronts them another way, e.g. a global guard or reverse-proxy auth).
+     *
+     * A guard's own DEPENDENCIES resolve from this module's `imports` (see {@link imports}) — the
+     * dashboard module has no application context of its own to pull them from otherwise.
+     */
+    guards?: Type<CanActivate>[];
+    /**
+     * Extra `imports` merged into the dashboard's dynamic module — the DI resolution path for a class
+     * passed to {@link guards} (or any other provider the controllers need reachable). Typically the
+     * host's own auth module, e.g. `imports: [AuthModule]` alongside `guards: [JwtAuthGuard]`.
+     */
+    imports?: DynamicModule['imports'];
 }
-/** Holds the JSON API + SSE controller and its read service, mounted on its own path by `forRoot`. */
+/**
+ * Holds the JSON API + SSE controller and its read service, mounted on its own path by `forRoot`.
+ * Dynamic: guards are DI-instantiated by the CONTROLLER's host module, so this module — not the
+ * outer wrapper — must carry the guard classes as providers plus the host's `imports` that resolve
+ * their dependencies. A static module here made `guards: [SomeGuardWithDeps]` fail at boot with
+ * "Nest can't resolve dependencies ... in the AgentApiModule context" even when the host passed
+ * the right `imports` to `forRoot`.
+ */
 declare class AgentApiModule {
+    static register(options: {
+        imports?: DynamicModule['imports'];
+        guards?: Type<CanActivate>[];
+    }): DynamicModule;
 }
 /**
  * Mounts the AI-gateway governance console: the bundled React SPA at `basePath` and its JSON + SSE
@@ -90,7 +188,8 @@ declare class AgentApiModule {
  *
  * Import via `AgentDashboardModule.forRoot(...)` alongside your `@dudousxd/nestjs-agent` module
  * (global), which must provide `AGENT_GOVERNANCE_QUERIES` (bound by a store adapter). Front the
- * routes with your own guard — the controllers are path-relative and guard-frontable.
+ * routes with the first-class `guards` option (plus `imports` for the guards' own dependencies) —
+ * see {@link AgentDashboardOptions.guards}.
  */
 declare class AgentDashboardModule {
     static forRoot(options?: AgentDashboardOptions): DynamicModule;
@@ -110,6 +209,13 @@ declare class AgentUiController {
     asset(file: string): StreamableFile;
 }
 
+/**
+ * Minimal shape guard for a `POST <api>/pricing` body — rejects junk before it reaches
+ * `AgentPricingStore.upsertModelPrice`. Not a full schema validator (the store adapter owns real
+ * constraints, e.g. uniqueness); this only checks the wire shape core's `ModelPriceInput` requires.
+ */
+declare function parsePriceInput(body: unknown): ModelPriceInput;
+
 /**
  * DI tokens for the standalone AI-gateway dashboard.
  *
@@ -125,9 +231,23 @@ declare class AgentUiController {
  * `packages/core/src/tokens.ts` export. The key MUST stay byte-identical with that export.
  */
 declare const AGENT_GOVERNANCE_QUERIES: unique symbol;
+/**
+ * Optional actor→label resolver (see {@link ActorDirectory} in `./actor-directory.js`), owned by
+ * `@dudousxd/nestjs-agent-core`. Re-declared here BY VALUE for the same reason as
+ * {@link AGENT_GOVERNANCE_QUERIES} above — the key MUST stay byte-identical with core's own
+ * `AGENT_ACTOR_DIRECTORY` export so both copies collapse onto the same registered symbol. Optional:
+ * the dashboard works with actorRef-only rows when nothing is bound.
+ */
+declare const AGENT_ACTOR_DIRECTORY: unique symbol;
+/**
+ * The pricing WRITE side (`AgentPricingStore`), owned by `@dudousxd/nestjs-agent-core`. Re-declared
+ * here BY VALUE for the same reason as {@link AGENT_GOVERNANCE_QUERIES} above. Optional: the pricing
+ * tab/endpoints 501 with a clear message when nothing is bound.
+ */
+declare const AGENT_PRICING_STORE: unique symbol;
 /** DI token carrying the UI mount base (e.g. `/ai-gateway`). */
 declare const DASHBOARD_BASE_PATH: unique symbol;
 /** DI token carrying the JSON API base the SPA fetches from (e.g. `/ai-gateway/api`). */
 declare const DASHBOARD_API_PATH: unique symbol;
 
-export { AGENT_GOVERNANCE_QUERIES, AgentApiController, AgentApiModule, AgentDashboardModule, type AgentDashboardOptions, AgentUiController, DASHBOARD_API_PATH, DASHBOARD_BASE_PATH, DashboardService, type LiveAgentEvent, type SpendOverview };
+export { AGENT_ACTOR_DIRECTORY, AGENT_GOVERNANCE_QUERIES, AGENT_PRICING_STORE, type ActorSpendRowWithLabel, AgentApiController, AgentApiModule, AgentDashboardModule, type AgentDashboardMountPathsOptions, type AgentDashboardOptions, AgentUiController, DASHBOARD_API_PATH, DASHBOARD_BASE_PATH, DashboardService, type LiveAgentEvent, type SpendOverview, type ThreadActivityRowWithLabel, type ThreadSpendRowWithLabel, type WithActorLabel, agentDashboardMountPaths, parsePriceInput };