@dudousxd/nestjs-agent-dashboard 0.1.0

package/dist/server/index.cjs

@@ -0,0 +1,449 @@
+const __importMetaUrl = require('url').pathToFileURL(__filename).href;
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/server/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AGENT_GOVERNANCE_QUERIES: () => AGENT_GOVERNANCE_QUERIES,
+  AgentApiController: () => AgentApiController,
+  AgentApiModule: () => AgentApiModule,
+  AgentDashboardModule: () => AgentDashboardModule,
+  AgentUiController: () => AgentUiController,
+  DASHBOARD_API_PATH: () => DASHBOARD_API_PATH,
+  DASHBOARD_BASE_PATH: () => DASHBOARD_BASE_PATH,
+  DashboardService: () => DashboardService
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/server/agent-api.controller.ts
+var import_common2 = require("@nestjs/common");
+
+// src/server/dashboard.service.ts
+var import_node_diagnostics_channel = require("diagnostics_channel");
+var import_nestjs_diagnostics = require("@dudousxd/nestjs-diagnostics");
+var import_common = require("@nestjs/common");
+var import_rxjs = require("rxjs");
+
+// src/server/tokens.ts
+var AGENT_GOVERNANCE_QUERIES = Symbol.for("@dudousxd/nestjs-agent:governance-queries");
+var DASHBOARD_BASE_PATH = Symbol.for("@dudousxd/nestjs-agent-dashboard:base-path");
+var DASHBOARD_API_PATH = Symbol.for("@dudousxd/nestjs-agent-dashboard:api-path");
+
+// src/server/dashboard.service.ts
+function _ts_decorate(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate, "_ts_decorate");
+function _ts_metadata(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata, "_ts_metadata");
+function _ts_param(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param, "_ts_param");
+var AGENT_EVENTS = [
+  "run.started",
+  "message",
+  "tool-call",
+  "quota.exceeded",
+  "run.finished",
+  "delegated"
+];
+function isAgentEnvelope(message) {
+  return typeof message === "object" && message !== null && "event" in message && typeof message.event === "string";
+}
+__name(isAgentEnvelope, "isAgentEnvelope");
+var DashboardService = class {
+  static {
+    __name(this, "DashboardService");
+  }
+  queries;
+  constructor(queries) {
+    this.queries = queries;
+  }
+  /** Spend/usage overview for a day range: by-model + by-actor spend and the daily trend, in parallel. */
+  async spend(range) {
+    const [byModel, byActor, trend] = await Promise.all([
+      this.queries.spendByModel(range),
+      this.queries.spendByActor(range),
+      this.queries.usageTrend(range)
+    ]);
+    return {
+      byModel,
+      byActor,
+      trend
+    };
+  }
+  /** Most recent tool calls (status/type/thread) for the Runs & tools activity feed. */
+  recentToolCalls(limit) {
+    return this.queries.recentToolCalls(limit);
+  }
+  /** Most recent threads with rolled-up message/token counts. */
+  recentThreads(limit) {
+    return this.queries.recentThreads(limit);
+  }
+  /**
+  * 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
+  * the client disconnects (or the observable is otherwise unsubscribed).
+  */
+  streamEvents() {
+    return new import_rxjs.Observable((subscriber) => {
+      const bindings = AGENT_EVENTS.map((event) => {
+        const name = (0, import_nestjs_diagnostics.channelName)("agent", event);
+        const handler = /* @__PURE__ */ __name((message) => {
+          if (!isAgentEnvelope(message)) return;
+          subscriber.next({
+            data: {
+              event: message.event,
+              ts: message.ts ?? Date.now(),
+              payload: message.payload ?? {}
+            }
+          });
+        }, "handler");
+        (0, import_node_diagnostics_channel.subscribe)(name, handler);
+        return {
+          name,
+          handler
+        };
+      });
+      return () => {
+        for (const binding of bindings) (0, import_node_diagnostics_channel.unsubscribe)(binding.name, binding.handler);
+      };
+    });
+  }
+};
+DashboardService = _ts_decorate([
+  (0, import_common.Injectable)(),
+  _ts_param(0, (0, import_common.Inject)(AGENT_GOVERNANCE_QUERIES)),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", [
+    typeof AgentGovernanceQueries === "undefined" ? Object : AgentGovernanceQueries
+  ])
+], DashboardService);
+
+// src/server/agent-api.controller.ts
+function _ts_decorate2(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate2, "_ts_decorate");
+function _ts_metadata2(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata2, "_ts_metadata");
+function _ts_param2(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param2, "_ts_param");
+var DAY_MS = 864e5;
+var ISO_DAY = /^\d{4}-\d{2}-\d{2}$/;
+function utcDay(daysAgo) {
+  return new Date(Date.now() - daysAgo * DAY_MS).toISOString().slice(0, 10);
+}
+__name(utcDay, "utcDay");
+function dayOr(value, fallback) {
+  return value !== void 0 && ISO_DAY.test(value) ? value : fallback;
+}
+__name(dayOr, "dayOr");
+function resolveRange(from, to) {
+  return {
+    fromDay: dayOr(from, utcDay(29)),
+    toDay: dayOr(to, utcDay(0))
+  };
+}
+__name(resolveRange, "resolveRange");
+function parseLimit(value, fallback) {
+  const parsed = value === void 0 ? Number.NaN : Number.parseInt(value, 10);
+  if (!Number.isFinite(parsed)) return fallback;
+  return Math.max(1, Math.min(200, parsed));
+}
+__name(parseLimit, "parseLimit");
+var AgentApiController = class {
+  static {
+    __name(this, "AgentApiController");
+  }
+  dashboard;
+  constructor(dashboard) {
+    this.dashboard = dashboard;
+  }
+  /** `{ byModel, byActor, trend }` for a day range (defaults to the last 30 days). */
+  spend(from, to) {
+    return this.dashboard.spend(resolveRange(from, to));
+  }
+  /** Most recent tool calls (default 50, max 200) for the activity feed. */
+  toolCalls(limit) {
+    return this.dashboard.recentToolCalls(parseLimit(limit, 50));
+  }
+  /** Most recent threads (default 50, max 200) with rolled-up counts. */
+  threads(limit) {
+    return this.dashboard.recentThreads(parseLimit(limit, 50));
+  }
+  /** Server-Sent Events stream of live `aviary:agent:*` events — the Live feed tails it. */
+  stream() {
+    return this.dashboard.streamEvents();
+  }
+};
+_ts_decorate2([
+  (0, import_common2.Get)("spend"),
+  _ts_param2(0, (0, import_common2.Query)("from")),
+  _ts_param2(1, (0, import_common2.Query)("to")),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [
+    String,
+    String
+  ]),
+  _ts_metadata2("design:returntype", typeof Promise === "undefined" ? Object : Promise)
+], AgentApiController.prototype, "spend", null);
+_ts_decorate2([
+  (0, import_common2.Get)("tool-calls"),
+  _ts_param2(0, (0, import_common2.Query)("limit")),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [
+    String
+  ]),
+  _ts_metadata2("design:returntype", typeof Promise === "undefined" ? Object : Promise)
+], AgentApiController.prototype, "toolCalls", null);
+_ts_decorate2([
+  (0, import_common2.Get)("threads"),
+  _ts_param2(0, (0, import_common2.Query)("limit")),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [
+    String
+  ]),
+  _ts_metadata2("design:returntype", typeof Promise === "undefined" ? Object : Promise)
+], AgentApiController.prototype, "threads", null);
+_ts_decorate2([
+  (0, import_common2.Sse)("stream"),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", []),
+  _ts_metadata2("design:returntype", typeof Observable === "undefined" ? Object : Observable)
+], AgentApiController.prototype, "stream", null);
+AgentApiController = _ts_decorate2([
+  (0, import_common2.Controller)(),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [
+    typeof DashboardService === "undefined" ? Object : DashboardService
+  ])
+], AgentApiController);
+
+// src/server/agent-dashboard.module.ts
+var import_common4 = require("@nestjs/common");
+var import_core = require("@nestjs/core");
+
+// src/server/agent-ui.controller.ts
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+var import_node_url = require("url");
+var import_common3 = require("@nestjs/common");
+function _ts_decorate3(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate3, "_ts_decorate");
+function _ts_metadata3(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata3, "_ts_metadata");
+function _ts_param3(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param3, "_ts_param");
+var BUILD_BASE = "/ai-gateway";
+function spaDir() {
+  return (0, import_node_url.fileURLToPath)(new URL("../spa", __importMetaUrl));
+}
+__name(spaDir, "spaDir");
+var CONTENT_TYPES = {
+  ".js": "text/javascript; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".map": "application/json; charset=utf-8",
+  ".svg": "image/svg+xml",
+  ".json": "application/json; charset=utf-8",
+  ".woff2": "font/woff2",
+  ".ico": "image/x-icon"
+};
+var AgentUiController = class {
+  static {
+    __name(this, "AgentUiController");
+  }
+  basePath;
+  apiBasePath;
+  dir = spaDir();
+  constructor(basePath, apiBasePath) {
+    this.basePath = basePath;
+    this.apiBasePath = apiBasePath;
+  }
+  // index.html references hash-named bundles, so it MUST NOT be cached (stale bundle = the classic
+  // "stuck loading after a deploy"). The hashed assets below are immutable.
+  index() {
+    const indexPath = (0, import_node_path.join)(this.dir, "index.html");
+    if (!(0, import_node_fs.existsSync)(indexPath)) {
+      throw new import_common3.NotFoundException("Dashboard is not built. Run the package build.");
+    }
+    const html = (0, import_node_fs.readFileSync)(indexPath, "utf8").replaceAll(`="${BUILD_BASE}/`, `="${this.basePath}/`);
+    const inject = `<script>window.__AGENT_BASE__='${this.basePath}';window.__AGENT_API__='${this.apiBasePath}';</script>`;
+    return html.includes("</head>") ? html.replace("</head>", `${inject}</head>`) : inject + html;
+  }
+  asset(file) {
+    const safe = (0, import_node_path.basename)(file);
+    if (safe !== file) throw new import_common3.NotFoundException();
+    const root = (0, import_node_path.resolve)(this.dir, "assets");
+    const assetPath = (0, import_node_path.resolve)(root, safe);
+    if (!assetPath.startsWith(root + import_node_path.sep) || !(0, import_node_fs.existsSync)(assetPath)) {
+      throw new import_common3.NotFoundException();
+    }
+    const type = CONTENT_TYPES[(0, import_node_path.extname)(safe)] ?? "application/octet-stream";
+    return new import_common3.StreamableFile((0, import_node_fs.readFileSync)(assetPath), {
+      type
+    });
+  }
+};
+_ts_decorate3([
+  (0, import_common3.Get)(),
+  (0, import_common3.Header)("Content-Type", "text/html; charset=utf-8"),
+  (0, import_common3.Header)("Cache-Control", "no-store, must-revalidate"),
+  _ts_metadata3("design:type", Function),
+  _ts_metadata3("design:paramtypes", []),
+  _ts_metadata3("design:returntype", String)
+], AgentUiController.prototype, "index", null);
+_ts_decorate3([
+  (0, import_common3.Get)("assets/:file"),
+  (0, import_common3.Header)("Cache-Control", "public, max-age=31536000, immutable"),
+  _ts_param3(0, (0, import_common3.Param)("file")),
+  _ts_metadata3("design:type", Function),
+  _ts_metadata3("design:paramtypes", [
+    String
+  ]),
+  _ts_metadata3("design:returntype", typeof import_common3.StreamableFile === "undefined" ? Object : import_common3.StreamableFile)
+], AgentUiController.prototype, "asset", null);
+AgentUiController = _ts_decorate3([
+  (0, import_common3.Controller)(),
+  _ts_param3(0, (0, import_common3.Inject)(DASHBOARD_BASE_PATH)),
+  _ts_param3(1, (0, import_common3.Inject)(DASHBOARD_API_PATH)),
+  _ts_metadata3("design:type", Function),
+  _ts_metadata3("design:paramtypes", [
+    String,
+    String
+  ])
+], AgentUiController);
+
+// src/server/agent-dashboard.module.ts
+function _ts_decorate4(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate4, "_ts_decorate");
+function normalize(path) {
+  return `/${path.replace(/^\/+|\/+$/g, "")}`;
+}
+__name(normalize, "normalize");
+var AgentApiModule = class {
+  static {
+    __name(this, "AgentApiModule");
+  }
+};
+AgentApiModule = _ts_decorate4([
+  (0, import_common4.Module)({
+    controllers: [
+      AgentApiController
+    ],
+    providers: [
+      DashboardService
+    ],
+    exports: [
+      DashboardService
+    ]
+  })
+], AgentApiModule);
+var AgentDashboardModule = class _AgentDashboardModule {
+  static {
+    __name(this, "AgentDashboardModule");
+  }
+  static forRoot(options = {}) {
+    const basePath = normalize(options.basePath ?? "/ai-gateway");
+    const apiBasePath = normalize(options.apiBasePath ?? `${basePath}/api`);
+    return {
+      module: _AgentDashboardModule,
+      imports: [
+        AgentApiModule,
+        import_core.RouterModule.register([
+          {
+            path: basePath,
+            module: _AgentDashboardModule
+          },
+          {
+            path: apiBasePath,
+            module: AgentApiModule
+          }
+        ])
+      ],
+      controllers: [
+        AgentUiController
+      ],
+      providers: [
+        {
+          provide: DASHBOARD_BASE_PATH,
+          useValue: basePath
+        },
+        {
+          provide: DASHBOARD_API_PATH,
+          useValue: apiBasePath
+        }
+      ],
+      // Re-export the API module so its DashboardService reaches importers (e.g. the host's own controllers).
+      exports: [
+        AgentApiModule
+      ]
+    };
+  }
+};
+AgentDashboardModule = _ts_decorate4([
+  (0, import_common4.Module)({})
+], AgentDashboardModule);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AGENT_GOVERNANCE_QUERIES,
+  AgentApiController,
+  AgentApiModule,
+  AgentDashboardModule,
+  AgentUiController,
+  DASHBOARD_API_PATH,
+  DASHBOARD_BASE_PATH,
+  DashboardService
+});
+//# sourceMappingURL=index.cjs.map

package/dist/server/index.cjs.map

@@ -0,0 +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 { ThreadActivityRow, ToolCallActivityRow } 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  /** 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  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  /** 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","recentToolCalls","limit","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","toolCalls","limit","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"]}

package/dist/server/index.d.cts

@@ -0,0 +1,129 @@
+import { AgentGovernanceQueries, GovernanceRange, ModelSpendRow, ActorSpendRow, UsageTrendPoint, ToolCallActivityRow, ThreadActivityRow } from '@dudousxd/nestjs-agent-core';
+import { Observable } from 'rxjs';
+import { DynamicModule, StreamableFile } from '@nestjs/common';
+
+/** The spend/usage overview the SPA renders on its headline section (`GET <api>/spend`). */
+interface SpendOverview {
+    byModel: ModelSpendRow[];
+    byActor: ActorSpendRow[];
+    trend: UsageTrendPoint[];
+}
+/** One live agent event forwarded over SSE, flattened from the `aviary:agent:*` diagnostics envelope. */
+interface LiveAgentEvent {
+    /** The event name, e.g. `run.started` / `tool-call` / `quota.exceeded`. */
+    event: string;
+    /** Epoch millis the event was emitted. */
+    ts: number;
+    /** The library-defined payload (see the `Agent*Event` shapes in core's diagnostics). */
+    payload: Record<string, unknown>;
+}
+/**
+ * Read-model + live bridge backing the AI-gateway console.
+ *
+ * - Historical, restart-surviving spend/usage/threads come from the injected
+ *   {@link AGENT_GOVERNANCE_QUERIES} read-model (backed by a store adapter). The host must provide
+ *   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.
+ */
+declare class DashboardService {
+    private readonly queries;
+    constructor(queries: AgentGovernanceQueries);
+    /** Spend/usage overview for a day range: by-model + by-actor spend and the daily trend, in parallel. */
+    spend(range: GovernanceRange): Promise<SpendOverview>;
+    /** 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[]>;
+    /**
+     * 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
+     * the client disconnects (or the observable is otherwise unsubscribed).
+     */
+    streamEvents(): Observable<{
+        data: LiveAgentEvent;
+    }>;
+}
+
+/**
+ * JSON + SSE API consumed by the AI-gateway console SPA. Mounted at `apiBasePath` (set by
+ * `RouterModule` in {@link AgentDashboardModule.forRoot}), so the controller routes are relative.
+ */
+declare class AgentApiController {
+    private readonly dashboard;
+    constructor(dashboard: DashboardService);
+    /** `{ byModel, byActor, trend }` for a day range (defaults to the last 30 days). */
+    spend(from?: string, to?: string): Promise<SpendOverview>;
+    /** 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[]>;
+    /** Server-Sent Events stream of live `aviary:agent:*` events — the Live feed tails it. */
+    stream(): Observable<{
+        data: LiveAgentEvent;
+    }>;
+}
+
+interface AgentDashboardOptions {
+    /**
+     * Where the SPA (UI) is served. Default `/ai-gateway`. This is a page route — keep it out of an
+     * `/api` prefix so it reads as a UI, not an endpoint.
+     */
+    basePath?: string;
+    /**
+     * Where the JSON API is mounted (what the SPA fetches). Default `<basePath>/api`. Set it under
+     * your app's `/api` prefix — e.g. `/api/ai-gateway` — so the API inherits the app's auth/proxy
+     * rules while the UI stays at `basePath`.
+     */
+    apiBasePath?: string;
+}
+/** Holds the JSON API + SSE controller and its read service, mounted on its own path by `forRoot`. */
+declare class AgentApiModule {
+}
+/**
+ * Mounts the AI-gateway governance console: the bundled React SPA at `basePath` and its JSON + SSE
+ * API at `apiBasePath` (default `<basePath>/api`).
+ *
+ * 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.
+ */
+declare class AgentDashboardModule {
+    static forRoot(options?: AgentDashboardOptions): DynamicModule;
+}
+
+/**
+ * Serves the bundled AI-gateway console SPA at the configured base (+ hashed assets at
+ * `<base>/assets`). The path comes from `RouterModule` (set by
+ * {@link AgentDashboardModule.forRoot}({ basePath })), so the controller routes are relative.
+ */
+declare class AgentUiController {
+    private readonly basePath;
+    private readonly apiBasePath;
+    private readonly dir;
+    constructor(basePath: string, apiBasePath: string);
+    index(): string;
+    asset(file: string): StreamableFile;
+}
+
+/**
+ * DI tokens for the standalone AI-gateway dashboard.
+ *
+ * All use `Symbol.for(...)` (the global symbol registry) on purpose: pnpm peer multiplexing + dual
+ * ESM/CJS can load a package more than once, and a plain `Symbol()` would mint a distinct token per
+ * copy and break DI across the ESM/CJS split. A registered symbol collapses every copy onto the same
+ * token.
+ */
+/**
+ * The governance read-model, owned by `@dudousxd/nestjs-agent-core`. We re-declare it here BY VALUE
+ * (not by import) so DI does not depend on a runtime value-import of core resolving — `Symbol.for`
+ * with the identical key resolves to the SAME symbol instance as core's own
+ * `packages/core/src/tokens.ts` export. The key MUST stay byte-identical with that export.
+ */
+declare const AGENT_GOVERNANCE_QUERIES: 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 };