@dudousxd/nestjs-agent-dashboard 0.21.0 → 0.23.0

package/dist/server/index.js

@@ -73,12 +73,37 @@ function isFiniteNonNegative(value) {
 }
 __name(isFiniteNonNegative, "isFiniteNonNegative");
 
+// src/server/tenancy.ts
+var SLOT = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-diagnostics:accessor");
+function consoleTenantFilter(option = "inherit", accessor) {
+  const slot = globalThis[SLOT];
+  const a = accessor ?? slot?.current;
+  if (option === false || typeof a?.tenancy !== "function" || !a.tenantFilter) return void 0;
+  const own = typeof option === "object" ? option : {};
+  const inherit = own.enabled === void 0 || own.enabled === "inherit";
+  if (!(inherit ? a.tenancy().enabled : own.enabled)) return void 0;
+  const filter = a.tenantFilter(own.kinds ? {
+    kinds: own.kinds
+  } : void 0);
+  if (filter.mode === "system" || filter.mode === "all") return void 0;
+  if (filter.mode === "tenantless") return {
+    nulls: true
+  };
+  return {
+    tenant: filter.tenant.id,
+    nulls: own.nullRows === "shared"
+  };
+}
+__name(consoleTenantFilter, "consoleTenantFilter");
+
 // src/server/tokens.ts
 var AGENT_GOVERNANCE_QUERIES = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:governance-queries");
 var AGENT_ACTOR_DIRECTORY = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:actor-directory");
 var AGENT_PRICING_STORE = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:pricing-store");
 var AGENT_APPROVAL_PORT = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:approval-port");
 var AGENT_ACTOR_RESOLVER = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:actor-resolver");
+var AGENT_OPTIONS = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:options");
+var CONTEXT_ACCESSOR = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-context:accessor");
 var DASHBOARD_BASE_PATH = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent-dashboard:base-path");
 var DASHBOARD_API_PATH = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent-dashboard:api-path");
 var DASHBOARD_APPROVAL_ACTOR_REF = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent-dashboard:approval-actor-ref");
@@ -114,6 +139,7 @@ function _ts_param(paramIndex, decorator) {
 __name(_ts_param, "_ts_param");
 var PRICING_STORE_UNBOUND_MESSAGE = "Pricing CRUD is unavailable: no AGENT_PRICING_STORE is bound. Bind a pricing store (e.g. MikroOrmPricingStore from @dudousxd/nestjs-agent-store-mikro-orm) to enable it.";
 var APPROVAL_PORT_UNBOUND_MESSAGE = "Approve/reject is unavailable: no AGENT_APPROVAL_PORT is bound. Import AgentModule from @dudousxd/nestjs-agent alongside this dashboard to enable it \u2014 the approvals inbox stays read-only until then.";
+var TENANT_SCOPE_UNSUPPORTED_MESSAGE = "The agent console is tenant-scoped (AgentModule tenancy is on), and the bound AGENT_GOVERNANCE_QUERIES store does not implement forTenant. Use a store adapter that does (Drizzle, MikroORM, in-memory) or set AgentModule `tenancy: false`.";
 var GENUI_STATS_UNSUPPORTED_MESSAGE = "Generative UI telemetry is unavailable: the bound AGENT_GOVERNANCE_QUERIES store does not implement genuiStats. Use a store adapter that records generative-UI calls (recordGenuiCalls) to enable it.";
 var AGENT_EVENTS = [
   "run.started",
@@ -137,19 +163,37 @@ var DashboardService = class {
   actorDirectory;
   pricingStore;
   approvalPort;
-  constructor(queries, actorDirectory, pricingStore, approvalPort) {
+  agentOptions;
+  contextAccessor;
+  constructor(queries, actorDirectory, pricingStore, approvalPort, agentOptions, contextAccessor) {
     this.queries = queries;
     this.actorDirectory = actorDirectory;
     this.pricingStore = pricingStore;
     this.approvalPort = approvalPort;
+    this.agentOptions = agentOptions;
+    this.contextAccessor = contextAccessor;
+  }
+  /**
+  * The read-model for this request: with the agent's tenancy on, narrowed to the viewer's context
+  * tenant (another tenant's thread or run is not found). A store without `forTenant` cannot be
+  * narrowed, so the console refuses (`501`) rather than show every tenant's rows.
+  */
+  scoped() {
+    const filter = consoleTenantFilter(this.agentOptions?.tenancy ?? "inherit", this.contextAccessor);
+    if (filter === void 0) return this.queries;
+    if (typeof this.queries.forTenant !== "function") {
+      throw new NotImplementedException(TENANT_SCOPE_UNSUPPORTED_MESSAGE);
+    }
+    return this.queries.forTenant(filter);
   }
   /** Spend/usage overview for a day range: by-model + by-actor spend and the daily trend, in parallel. */
   async spend(range) {
+    const queries = this.scoped();
     const [byModel, byActorRaw, trend, byFeature] = await Promise.all([
-      this.queries.spendByModel(range),
-      this.queries.spendByActor(range),
-      this.queries.usageTrend(range),
-      this.queries.spendByFeature?.(range)
+      queries.spendByModel(range),
+      queries.spendByActor(range),
+      queries.usageTrend(range),
+      queries.spendByFeature?.(range)
     ]);
     const byActor = await this.withActorLabels(byActorRaw);
     return {
@@ -163,16 +207,17 @@ var DashboardService = class {
   }
   /** Top threads by cost for a day range (default 10, highest cost first). */
   async topThreads(range, limit2 = 10) {
-    const rows = await this.queries.spendByThread(range, limit2);
+    const rows = await this.scoped().spendByThread(range, limit2);
     return this.withActorLabels(rows);
   }
   /** Run reliability for a day range: metrics, by-agent/by-error breakdowns and the trend, in parallel. */
   async reliability(range) {
+    const queries = this.scoped();
     const [metrics, byAgent, errors, trend] = await Promise.all([
-      this.queries.runMetrics(range),
-      this.queries.runsByAgent(range),
-      this.queries.runErrors(range),
-      this.queries.runTrend(range)
+      queries.runMetrics(range),
+      queries.runsByAgent(range),
+      queries.runErrors(range),
+      queries.runTrend(range)
     ]);
     return {
       metrics,
@@ -183,19 +228,19 @@ var DashboardService = class {
   }
   /** Most recent runs (status/agent/duration/error) for the Reliability recent-runs table. */
   recentRuns(limit2) {
-    return this.queries.recentRuns(limit2);
+    return this.scoped().recentRuns(limit2);
   }
   /** Most recent tool calls (status/type/thread) for the Runs & tools activity feed. */
   recentToolCalls(limit2) {
-    return this.queries.recentToolCalls(limit2);
+    return this.scoped().recentToolCalls(limit2);
   }
   /** Paged, filterable tool calls for the Runs & tools activity table. */
   toolCallsPage(query) {
-    return this.queries.toolCallsPage(query);
+    return this.scoped().toolCallsPage(query);
   }
   /** Paged, filterable runs for the Reliability recent-runs table. */
   runsPage(query) {
-    return this.queries.runsPage(query);
+    return this.scoped().runsPage(query);
   }
   /**
   * Tool calls sitting `pending_approval`, oldest first, for the cross-thread approvals inbox.
@@ -203,11 +248,11 @@ var DashboardService = class {
   * {@link approvalsPage}, which reports how much of the backlog the cap hid.
   */
   pendingApprovals(limit2) {
-    return this.queries.pendingApprovals(limit2);
+    return this.scoped().pendingApprovals(limit2);
   }
   /** Paged, filterable approvals inbox with a total — the backlog-safe read of the HITL queue. */
   approvalsPage(query) {
-    return this.queries.approvalsPage(query);
+    return this.scoped().approvalsPage(query);
   }
   /**
   * One run with its thread and its tool calls. 404s on an unknown id rather than returning an empty
@@ -215,7 +260,7 @@ var DashboardService = class {
   * that conflates them sends an operator looking for a bug that isn't there.
   */
   async runDetail(runId) {
-    const detail = await this.queries.runDetail(runId);
+    const detail = await this.scoped().runDetail(runId);
     if (detail === null) {
       throw new NotFoundException(`No run "${runId}".`);
     }
@@ -232,7 +277,7 @@ var DashboardService = class {
   }
   /** One thread with its usage rollup, runs and messages. 404s on an unknown id, like {@link runDetail}. */
   async threadDetail(query) {
-    const detail = await this.queries.threadDetail(query);
+    const detail = await this.scoped().threadDetail(query);
     if (detail === null) {
       throw new NotFoundException(`No thread "${query.threadId}".`);
     }
@@ -249,7 +294,7 @@ var DashboardService = class {
   }
   /** Per-tool call/failure/rejection/latency rollup for a day range, for the Tools section. */
   toolStats(range) {
-    return this.queries.toolStats(range);
+    return this.scoped().toolStats(range);
   }
   /**
   * Generative-UI telemetry for a day range — first-try success per tool/model, common errors, UI
@@ -258,10 +303,11 @@ var DashboardService = class {
   * same posture as an unbound pricing store — the console renders that as its own state.
   */
   async genuiStats(range) {
-    if (this.queries.genuiStats === void 0) {
+    const queries = this.scoped();
+    if (queries.genuiStats === void 0) {
       throw new NotImplementedException(GENUI_STATS_UNSUPPORTED_MESSAGE);
     }
-    return this.queries.genuiStats(range);
+    return queries.genuiStats(range);
   }
   /**
   * Decide a pending HITL tool call from the console. Routes through the OPTIONAL
@@ -292,7 +338,7 @@ var DashboardService = class {
   }
   /** Most recent threads with rolled-up message/token counts. */
   async recentThreads(limit2) {
-    const rows = await this.queries.recentThreads(limit2);
+    const rows = await this.scoped().recentThreads(limit2);
     return this.withActorLabels(rows);
   }
   /**
@@ -300,7 +346,7 @@ var DashboardService = class {
   * {@link recentThreads} is.
   */
   async threadsPage(query) {
-    const page2 = await this.queries.threadsPage(query);
+    const page2 = await this.scoped().threadsPage(query);
     const rows = await this.withActorLabels(page2.rows);
     return {
       ...page2,
@@ -389,12 +435,18 @@ DashboardService = _ts_decorate([
   _ts_param(2, Inject(AGENT_PRICING_STORE)),
   _ts_param(3, Optional()),
   _ts_param(3, Inject(AGENT_APPROVAL_PORT)),
+  _ts_param(4, Optional()),
+  _ts_param(4, Inject(AGENT_OPTIONS)),
+  _ts_param(5, Optional()),
+  _ts_param(5, Inject(CONTEXT_ACCESSOR)),
   _ts_metadata("design:type", Function),
   _ts_metadata("design:paramtypes", [
     typeof AgentGovernanceQueries === "undefined" ? Object : AgentGovernanceQueries,
     typeof ActorDirectory === "undefined" ? Object : ActorDirectory,
     typeof AgentPricingStore === "undefined" ? Object : AgentPricingStore,
-    typeof AgentApprovalPort === "undefined" ? Object : AgentApprovalPort
+    typeof AgentApprovalPort === "undefined" ? Object : AgentApprovalPort,
+    Object,
+    Object
   ])
 ], DashboardService);
 
@@ -1052,8 +1104,8 @@ import { RouterModule } from "@nestjs/core";
 import { existsSync, readFileSync } from "fs";
 import { basename, extname, join, resolve, sep } from "path";
 import { fileURLToPath } from "url";
-import { CanAnyone as CanAnyone2 } from "@dudousxd/nestjs-agent-core";
-import { Controller as Controller2, Get as Get2, Header, Inject as Inject4, NotFoundException as NotFoundException2, Param as Param2, Req as Req2, Res, StreamableFile } from "@nestjs/common";
+import { CanAnyone as CanAnyone3 } from "@dudousxd/nestjs-agent-core";
+import { Controller as Controller3, Get as Get3, Header as Header2, Inject as Inject5, NotFoundException as NotFoundException2, Param as Param2, Req as Req2, Res, StreamableFile } from "@nestjs/common";
 
 // src/server/console-authorize.guard.ts
 import { Catch, HttpException, Inject as Inject3, Injectable as Injectable2, SetMetadata, UseFilters, UseGuards, applyDecorators } from "@nestjs/common";
@@ -1442,7 +1494,9 @@ function UseConsoleAuthorize() {
 }
 __name(UseConsoleAuthorize, "UseConsoleAuthorize");
 
-// src/server/agent-ui.controller.ts
+// src/server/console-switcher.ts
+import { CanAnyone as CanAnyone2 } from "@dudousxd/nestjs-agent-core";
+import { Controller as Controller2, Get as Get2, Header, Inject as Inject4, Injectable as Injectable3, Logger as Logger2, createParamDecorator } from "@nestjs/common";
 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") {
@@ -1469,7 +1523,186 @@ function _ts_param4(paramIndex, decorator) {
   };
 }
 __name(_ts_param4, "_ts_param");
+var AVIARY_CONSOLES_SLOT = /* @__PURE__ */ Symbol.for("@dudousxd/aviary:consoles");
+var ID = /^[a-z][a-z0-9-]*$/;
+var ICONS = /* @__PURE__ */ new Set([
+  "workflow",
+  "telescope",
+  "media",
+  "payments",
+  "agent",
+  "identity",
+  "generic"
+]);
+var CONSOLE_PROBE_TIMEOUT_MS = 300;
+function isSameOriginPath(path) {
+  return typeof path === "string" && path.startsWith("/") && !path.startsWith("//");
+}
+__name(isSameOriginPath, "isSameOriginPath");
+function readAviaryConsoles() {
+  const value = globalThis[AVIARY_CONSOLES_SLOT];
+  if (value?.version !== 1 || !Array.isArray(value.entries)) return void 0;
+  return value;
+}
+__name(readAviaryConsoles, "readAviaryConsoles");
+function registerAviaryConsole(entry, logger4) {
+  if (!ID.test(entry.id)) throw new Error(`console id ${JSON.stringify(entry.id)} is invalid`);
+  if (!isSameOriginPath(entry.path)) {
+    throw new Error(`console path ${JSON.stringify(entry.path)} must start with a single "/"`);
+  }
+  const holder = globalThis;
+  if (holder[AVIARY_CONSOLES_SLOT] === void 0) {
+    const fresh = {
+      version: 1,
+      entries: []
+    };
+    holder[AVIARY_CONSOLES_SLOT] = fresh;
+  }
+  const registry = readAviaryConsoles();
+  if (registry === void 0) return void 0;
+  if (registry.entries.some((existing) => existing.id === entry.id)) {
+    logger4?.warn(`console id "${entry.id}" is already registered`);
+    return void 0;
+  }
+  registry.entries.push(entry);
+  return () => {
+    const index = registry.entries.indexOf(entry);
+    if (index !== -1) registry.entries.splice(index, 1);
+  };
+}
+__name(registerAviaryConsole, "registerAviaryConsole");
+function consoleSwitcherConfig(selfId, endpoint) {
+  const registry = readAviaryConsoles();
+  if (!registry?.entries.some((entry) => entry.id === selfId)) return void 0;
+  const others = registry.entries.filter((entry) => entry.id !== selfId).length;
+  return others > 0 ? {
+    endpoint,
+    others
+  } : void 0;
+}
+__name(consoleSwitcherConfig, "consoleSwitcherConfig");
+async function allows(entry, context, ms) {
+  let timer;
+  const timeout = new Promise((resolve2) => {
+    timer = setTimeout(() => resolve2(false), ms);
+  });
+  try {
+    return await Promise.race([
+      Promise.resolve().then(() => entry.authorize(context)).then((decision) => decision?.allowed === true, () => false),
+      timeout
+    ]);
+  } finally {
+    clearTimeout(timer);
+  }
+}
+__name(allows, "allows");
+async function listVisibleConsoles(registry, selfId, context, timeoutMs = CONSOLE_PROBE_TIMEOUT_MS) {
+  const others = (registry?.entries ?? []).filter((entry) => entry.id !== selfId && isSameOriginPath(entry.path)).sort((a, b) => a.order - b.order || a.id.localeCompare(b.id));
+  const verdicts = await Promise.all(others.map((entry) => allows(entry, context, timeoutMs)));
+  return {
+    version: 1,
+    current: selfId,
+    consoles: others.filter((_, index) => verdicts[index]).map((entry) => ({
+      id: entry.id,
+      title: entry.title,
+      icon: ICONS.has(entry.icon) ? entry.icon : "generic",
+      href: entry.path
+    }))
+  };
+}
+__name(listVisibleConsoles, "listVisibleConsoles");
+var AGENT_CONSOLE_ID = "agent";
+var logger2 = new Logger2("AgentDashboardModule");
+var AgentConsoleRegistration = class {
+  static {
+    __name(this, "AgentConsoleRegistration");
+  }
+  basePath;
+  access;
+  #unregister;
+  constructor(basePath, access) {
+    this.basePath = basePath;
+    this.access = access;
+  }
+  onModuleInit() {
+    this.#unregister = registerAviaryConsole({
+      id: AGENT_CONSOLE_ID,
+      title: "Agents",
+      icon: "agent",
+      order: 30,
+      path: this.basePath === "" ? "/" : this.basePath,
+      authorize: /* @__PURE__ */ __name((context) => this.access.check(context), "authorize")
+    }, logger2);
+  }
+  onModuleDestroy() {
+    this.#unregister?.();
+    this.#unregister = void 0;
+  }
+};
+AgentConsoleRegistration = _ts_decorate4([
+  Injectable3(),
+  _ts_param4(0, Inject4(DASHBOARD_BASE_PATH)),
+  _ts_metadata4("design:type", Function),
+  _ts_metadata4("design:paramtypes", [
+    String,
+    typeof DashboardConsoleAccess === "undefined" ? Object : DashboardConsoleAccess
+  ])
+], AgentConsoleRegistration);
+var CurrentExecutionContext = createParamDecorator((_data, context) => ({
+  context
+}));
+var AgentConsolesController = class {
+  static {
+    __name(this, "AgentConsolesController");
+  }
+  consoles(current) {
+    return listVisibleConsoles(readAviaryConsoles(), AGENT_CONSOLE_ID, current.context);
+  }
+};
+_ts_decorate4([
+  Get2("consoles"),
+  Header("Cache-Control", "private, no-store"),
+  _ts_param4(0, CurrentExecutionContext()),
+  _ts_metadata4("design:type", Function),
+  _ts_metadata4("design:paramtypes", [
+    typeof CurrentContext === "undefined" ? Object : CurrentContext
+  ]),
+  _ts_metadata4("design:returntype", typeof Promise === "undefined" ? Object : Promise)
+], AgentConsolesController.prototype, "consoles", null);
+AgentConsolesController = _ts_decorate4([
+  CanAnyone2(),
+  Controller2()
+], AgentConsolesController);
+
+// src/server/agent-ui.controller.ts
+function _ts_decorate5(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_decorate5, "_ts_decorate");
+function _ts_metadata5(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
+}
+__name(_ts_metadata5, "_ts_metadata");
+function _ts_param5(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param5, "_ts_param");
 var BUILD_BASE = "/ai-gateway";
+var AGENT_DASHBOARD_CONFIG_ID = "agent-dashboard-config";
 function spaDir() {
   return fileURLToPath(new URL("../spa", import.meta.url));
 }
@@ -1507,9 +1740,23 @@ var AgentUiController = class {
       throw new NotFoundException2("Dashboard is not built. Run the package build.");
     }
     const html = readFileSync(indexPath, "utf8").replaceAll(`="${BUILD_BASE}/`, `="${this.basePath}/`);
-    const inject = `<script>window.__AGENT_BASE__='${this.basePath}';window.__AGENT_API__='${this.apiBasePath}';</script>`;
+    const inject = `<script>window.__AGENT_BASE__='${this.basePath}';window.__AGENT_API__='${this.apiBasePath}';</script>${this.configBlock()}`;
     return html.includes("</head>") ? html.replace("</head>", `${inject}</head>`) : inject + html;
   }
+  /**
+  * The page's JSON config block (`agent-dashboard-config`, CSP-safe: data, not script). It carries
+  * `switcher` only when another Aviary console is registered.
+  */
+  configBlock() {
+    const switcher = consoleSwitcherConfig(AGENT_CONSOLE_ID, `${this.apiBasePath}/consoles`);
+    const json = JSON.stringify({
+      apiBase: this.apiBasePath,
+      ...switcher !== void 0 ? {
+        switcher
+      } : {}
+    }).replaceAll("<", "\\u003c");
+    return `<script type="application/json" id="${AGENT_DASHBOARD_CONFIG_ID}">${json}</script>`;
+  }
   asset(file) {
     const safe = basename(file);
     if (safe !== file) throw new NotFoundException2();
@@ -1524,47 +1771,47 @@ var AgentUiController = class {
     });
   }
 };
-_ts_decorate4([
-  Get2(),
+_ts_decorate5([
+  Get3(),
   ConsolePage(),
-  Header("Content-Type", "text/html; charset=utf-8"),
-  Header("Cache-Control", "no-store, must-revalidate"),
-  _ts_param4(0, Req2()),
-  _ts_param4(1, Res({
+  Header2("Content-Type", "text/html; charset=utf-8"),
+  Header2("Cache-Control", "no-store, must-revalidate"),
+  _ts_param5(0, Req2()),
+  _ts_param5(1, Res({
     passthrough: true
   })),
-  _ts_metadata4("design:type", Function),
-  _ts_metadata4("design:paramtypes", [
+  _ts_metadata5("design:type", Function),
+  _ts_metadata5("design:paramtypes", [
     typeof UiPageRequest === "undefined" ? Object : UiPageRequest,
     typeof UiPageResponse === "undefined" ? Object : UiPageResponse
   ]),
-  _ts_metadata4("design:returntype", String)
+  _ts_metadata5("design:returntype", String)
 ], AgentUiController.prototype, "index", null);
-_ts_decorate4([
-  Get2("assets/:file"),
-  Header("Cache-Control", "public, max-age=31536000, immutable"),
-  _ts_param4(0, Param2("file")),
-  _ts_metadata4("design:type", Function),
-  _ts_metadata4("design:paramtypes", [
+_ts_decorate5([
+  Get3("assets/:file"),
+  Header2("Cache-Control", "public, max-age=31536000, immutable"),
+  _ts_param5(0, Param2("file")),
+  _ts_metadata5("design:type", Function),
+  _ts_metadata5("design:paramtypes", [
     String
   ]),
-  _ts_metadata4("design:returntype", typeof StreamableFile === "undefined" ? Object : StreamableFile)
+  _ts_metadata5("design:returntype", typeof StreamableFile === "undefined" ? Object : StreamableFile)
 ], AgentUiController.prototype, "asset", null);
-AgentUiController = _ts_decorate4([
-  CanAnyone2(),
-  Controller2(),
-  _ts_param4(0, Inject4(DASHBOARD_BASE_PATH)),
-  _ts_param4(1, Inject4(DASHBOARD_API_PATH)),
-  _ts_metadata4("design:type", Function),
-  _ts_metadata4("design:paramtypes", [
+AgentUiController = _ts_decorate5([
+  CanAnyone3(),
+  Controller3(),
+  _ts_param5(0, Inject5(DASHBOARD_BASE_PATH)),
+  _ts_param5(1, Inject5(DASHBOARD_API_PATH)),
+  _ts_metadata5("design:type", Function),
+  _ts_metadata5("design:paramtypes", [
     String,
     String
   ])
 ], AgentUiController);
 
 // src/server/dev-tools.ts
-import { Inject as Inject5, Injectable as Injectable3, Logger as Logger2, NotFoundException as NotFoundException3 } from "@nestjs/common";
-function _ts_decorate5(decorators, target, key, desc) {
+import { Inject as Inject6, Injectable as Injectable4, Logger as Logger3, NotFoundException as NotFoundException3 } from "@nestjs/common";
+function _ts_decorate6(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);
@@ -1577,19 +1824,19 @@ function _ts_decorate5(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate5, "_ts_decorate");
-function _ts_metadata5(metadataKey, metadataValue) {
+__name(_ts_decorate6, "_ts_decorate");
+function _ts_metadata6(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata5, "_ts_metadata");
-function _ts_param5(paramIndex, decorator) {
+__name(_ts_metadata6, "_ts_metadata");
+function _ts_param6(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param5, "_ts_param");
+__name(_ts_param6, "_ts_param");
 var DEV_TOOLS_SLOT = /* @__PURE__ */ Symbol.for("@dudousxd/aviary:dev-tools");
 function devToolsSlot() {
   const holder = globalThis;
@@ -1923,7 +2170,7 @@ function agentDevTools(dashboard) {
   ];
 }
 __name(agentDevTools, "agentDevTools");
-var logger2 = new Logger2("AgentDashboardModule");
+var logger3 = new Logger3("AgentDashboardModule");
 var AgentDevToolsRegistration = class {
   static {
     __name(this, "AgentDevToolsRegistration");
@@ -1949,7 +2196,7 @@ var AgentDevToolsRegistration = class {
         tools: agentDevTools(this.dashboard)
       });
     } catch (error) {
-      logger2.warn(`agent dev tools not registered: ${error instanceof Error ? error.message : String(error)}`);
+      logger3.warn(`agent dev tools not registered: ${error instanceof Error ? error.message : String(error)}`);
     }
   }
   onModuleDestroy() {
@@ -1957,11 +2204,11 @@ var AgentDevToolsRegistration = class {
     this.#unregister = void 0;
   }
 };
-AgentDevToolsRegistration = _ts_decorate5([
-  Injectable3(),
-  _ts_param5(0, Inject5(DASHBOARD_DEV_TOOLS)),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+AgentDevToolsRegistration = _ts_decorate6([
+  Injectable4(),
+  _ts_param6(0, Inject6(DASHBOARD_DEV_TOOLS)),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("design:paramtypes", [
     Boolean,
     typeof DashboardService === "undefined" ? Object : DashboardService,
     typeof DashboardConsoleAccess === "undefined" ? Object : DashboardConsoleAccess
@@ -1969,7 +2216,7 @@ AgentDevToolsRegistration = _ts_decorate5([
 ], AgentDevToolsRegistration);
 
 // src/server/agent-dashboard.module.ts
-function _ts_decorate6(decorators, target, key, desc) {
+function _ts_decorate7(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);
@@ -1982,7 +2229,7 @@ function _ts_decorate6(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate6, "_ts_decorate");
+__name(_ts_decorate7, "_ts_decorate");
 function normalize(path) {
   return normalizeDashboardPath(path);
 }
@@ -2011,7 +2258,8 @@ var AgentApiModule = class _AgentApiModule {
         ...options.imports ?? []
       ],
       controllers: options.routes === false ? [] : withControllerDecorators([
-        AgentApiController
+        AgentApiController,
+        AgentConsolesController
       ], consoleDecorators(options.decorators)),
       providers: [
         DashboardService,
@@ -2042,7 +2290,7 @@ var AgentApiModule = class _AgentApiModule {
     };
   }
 };
-AgentApiModule = _ts_decorate6([
+AgentApiModule = _ts_decorate7([
   Module({})
 ], AgentApiModule);
 var AgentDashboardModule = class _AgentDashboardModule {
@@ -2101,7 +2349,11 @@ var AgentDashboardModule = class _AgentDashboardModule {
         {
           provide: DASHBOARD_API_PATH,
           useValue: apiBasePath
-        }
+        },
+        // The console switcher lists this console only where it serves its own page.
+        ...options.routes === false ? [] : [
+          AgentConsoleRegistration
+        ]
       ],
       // Re-export the API module so its DashboardService reaches importers (e.g. the host's own
       // controllers), and the paths a self-mounted `AgentUiController` subclass injects.
@@ -2113,23 +2365,31 @@ var AgentDashboardModule = class _AgentDashboardModule {
     };
   }
 };
-AgentDashboardModule = _ts_decorate6([
+AgentDashboardModule = _ts_decorate7([
   Module({})
 ], AgentDashboardModule);
 export {
   AGENT_ACTOR_DIRECTORY,
   AGENT_ACTOR_RESOLVER,
   AGENT_APPROVAL_PORT,
+  AGENT_CONSOLE_ID,
+  AGENT_DASHBOARD_CONFIG_ID,
   AGENT_GOVERNANCE_QUERIES,
+  AGENT_OPTIONS,
   AGENT_PRICING_STORE,
+  AVIARY_CONSOLES_SLOT,
   AgentApiController,
   AgentApiModule,
+  AgentConsoleRegistration,
+  AgentConsolesController,
   AgentDashboardModule,
   AgentDevToolsRegistration,
   AgentUiController,
   CONSOLE_AUTHORIZE_MISSING_WARNING,
   CONSOLE_GATE,
   CONSOLE_PAGE_METADATA,
+  CONSOLE_PROBE_TIMEOUT_MS,
+  CONTEXT_ACCESSOR,
   ConsoleAccessDenied,
   ConsoleAuthorizeFilter,
   ConsoleAuthorizeGuard,
@@ -2146,8 +2406,10 @@ export {
   agentDevTools,
   anyAuthorize,
   authorizeByToken,
+  listVisibleConsoles,
   normalizeConsoleResult,
   parsePriceInput,
+  registerAviaryConsole,
   resolveConsoleAuthorize
 };
 //# sourceMappingURL=index.js.map