@dudousxd/nestjs-agent-dashboard 0.21.0 → 0.23.0

package/dist/server/index.cjs

@@ -35,16 +35,24 @@ __export(index_exports, {
   AGENT_ACTOR_DIRECTORY: () => AGENT_ACTOR_DIRECTORY,
   AGENT_ACTOR_RESOLVER: () => AGENT_ACTOR_RESOLVER,
   AGENT_APPROVAL_PORT: () => AGENT_APPROVAL_PORT,
+  AGENT_CONSOLE_ID: () => AGENT_CONSOLE_ID,
+  AGENT_DASHBOARD_CONFIG_ID: () => AGENT_DASHBOARD_CONFIG_ID,
   AGENT_GOVERNANCE_QUERIES: () => AGENT_GOVERNANCE_QUERIES,
+  AGENT_OPTIONS: () => AGENT_OPTIONS,
   AGENT_PRICING_STORE: () => AGENT_PRICING_STORE,
+  AVIARY_CONSOLES_SLOT: () => AVIARY_CONSOLES_SLOT,
   AgentApiController: () => AgentApiController,
   AgentApiModule: () => AgentApiModule,
+  AgentConsoleRegistration: () => AgentConsoleRegistration,
+  AgentConsolesController: () => AgentConsolesController,
   AgentDashboardModule: () => AgentDashboardModule,
   AgentDevToolsRegistration: () => AgentDevToolsRegistration,
   AgentUiController: () => AgentUiController,
   CONSOLE_AUTHORIZE_MISSING_WARNING: () => CONSOLE_AUTHORIZE_MISSING_WARNING,
   CONSOLE_GATE: () => CONSOLE_GATE,
   CONSOLE_PAGE_METADATA: () => CONSOLE_PAGE_METADATA,
+  CONSOLE_PROBE_TIMEOUT_MS: () => CONSOLE_PROBE_TIMEOUT_MS,
+  CONTEXT_ACCESSOR: () => CONTEXT_ACCESSOR,
   ConsoleAccessDenied: () => ConsoleAccessDenied,
   ConsoleAuthorizeFilter: () => ConsoleAuthorizeFilter,
   ConsoleAuthorizeGuard: () => ConsoleAuthorizeGuard,
@@ -61,8 +69,10 @@ __export(index_exports, {
   agentDevTools: () => agentDevTools,
   anyAuthorize: () => anyAuthorize,
   authorizeByToken: () => authorizeByToken,
+  listVisibleConsoles: () => listVisibleConsoles,
   normalizeConsoleResult: () => normalizeConsoleResult,
   parsePriceInput: () => parsePriceInput,
+  registerAviaryConsole: () => registerAviaryConsole,
   resolveConsoleAuthorize: () => resolveConsoleAuthorize
 });
 module.exports = __toCommonJS(index_exports);
@@ -139,12 +149,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");
@@ -180,6 +215,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",
@@ -203,19 +239,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 import_common3.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 {
@@ -229,16 +283,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,
@@ -249,19 +304,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.
@@ -269,11 +324,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
@@ -281,7 +336,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 import_common3.NotFoundException(`No run "${runId}".`);
     }
@@ -298,7 +353,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 import_common3.NotFoundException(`No thread "${query.threadId}".`);
     }
@@ -315,7 +370,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
@@ -324,10 +379,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 import_common3.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
@@ -358,7 +414,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);
   }
   /**
@@ -366,7 +422,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,
@@ -455,12 +511,18 @@ DashboardService = _ts_decorate([
   _ts_param(2, (0, import_common3.Inject)(AGENT_PRICING_STORE)),
   _ts_param(3, (0, import_common3.Optional)()),
   _ts_param(3, (0, import_common3.Inject)(AGENT_APPROVAL_PORT)),
+  _ts_param(4, (0, import_common3.Optional)()),
+  _ts_param(4, (0, import_common3.Inject)(AGENT_OPTIONS)),
+  _ts_param(5, (0, import_common3.Optional)()),
+  _ts_param(5, (0, import_common3.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);
 
@@ -1109,17 +1171,17 @@ function agentDashboardMountPaths(options) {
 __name(agentDashboardMountPaths, "agentDashboardMountPaths");
 
 // src/server/agent-dashboard.module.ts
-var import_nestjs_agent_core3 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core4 = require("@dudousxd/nestjs-agent-core");
 var import_reflect_metadata = require("reflect-metadata");
-var import_common10 = require("@nestjs/common");
+var import_common11 = require("@nestjs/common");
 var import_core3 = 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_nestjs_agent_core2 = require("@dudousxd/nestjs-agent-core");
-var import_common8 = require("@nestjs/common");
+var import_nestjs_agent_core3 = require("@dudousxd/nestjs-agent-core");
+var import_common9 = require("@nestjs/common");
 
 // src/server/console-authorize.guard.ts
 var import_common7 = require("@nestjs/common");
@@ -1508,7 +1570,9 @@ function UseConsoleAuthorize() {
 }
 __name(UseConsoleAuthorize, "UseConsoleAuthorize");
 
-// src/server/agent-ui.controller.ts
+// src/server/console-switcher.ts
+var import_nestjs_agent_core2 = require("@dudousxd/nestjs-agent-core");
+var import_common8 = require("@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") {
@@ -1535,7 +1599,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 import_common8.Logger("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([
+  (0, import_common8.Injectable)(),
+  _ts_param4(0, (0, import_common8.Inject)(DASHBOARD_BASE_PATH)),
+  _ts_metadata4("design:type", Function),
+  _ts_metadata4("design:paramtypes", [
+    String,
+    typeof DashboardConsoleAccess === "undefined" ? Object : DashboardConsoleAccess
+  ])
+], AgentConsoleRegistration);
+var CurrentExecutionContext = (0, import_common8.createParamDecorator)((_data, context) => ({
+  context
+}));
+var AgentConsolesController = class {
+  static {
+    __name(this, "AgentConsolesController");
+  }
+  consoles(current) {
+    return listVisibleConsoles(readAviaryConsoles(), AGENT_CONSOLE_ID, current.context);
+  }
+};
+_ts_decorate4([
+  (0, import_common8.Get)("consoles"),
+  (0, import_common8.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([
+  (0, import_nestjs_agent_core2.CanAnyone)(),
+  (0, import_common8.Controller)()
+], 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 (0, import_node_url.fileURLToPath)(new URL("../spa", __importMetaUrl));
 }
@@ -1570,67 +1813,81 @@ var AgentUiController = class {
     }
     const indexPath = (0, import_node_path.join)(this.dir, "index.html");
     if (!(0, import_node_fs.existsSync)(indexPath)) {
-      throw new import_common8.NotFoundException("Dashboard is not built. Run the package build.");
+      throw new import_common9.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>`;
+    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 = (0, import_node_path.basename)(file);
-    if (safe !== file) throw new import_common8.NotFoundException();
+    if (safe !== file) throw new import_common9.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_common8.NotFoundException();
+      throw new import_common9.NotFoundException();
     }
     const type = CONTENT_TYPES[(0, import_node_path.extname)(safe)] ?? "application/octet-stream";
-    return new import_common8.StreamableFile((0, import_node_fs.readFileSync)(assetPath), {
+    return new import_common9.StreamableFile((0, import_node_fs.readFileSync)(assetPath), {
       type
     });
   }
 };
-_ts_decorate4([
-  (0, import_common8.Get)(),
+_ts_decorate5([
+  (0, import_common9.Get)(),
   ConsolePage(),
-  (0, import_common8.Header)("Content-Type", "text/html; charset=utf-8"),
-  (0, import_common8.Header)("Cache-Control", "no-store, must-revalidate"),
-  _ts_param4(0, (0, import_common8.Req)()),
-  _ts_param4(1, (0, import_common8.Res)({
+  (0, import_common9.Header)("Content-Type", "text/html; charset=utf-8"),
+  (0, import_common9.Header)("Cache-Control", "no-store, must-revalidate"),
+  _ts_param5(0, (0, import_common9.Req)()),
+  _ts_param5(1, (0, import_common9.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([
-  (0, import_common8.Get)("assets/:file"),
-  (0, import_common8.Header)("Cache-Control", "public, max-age=31536000, immutable"),
-  _ts_param4(0, (0, import_common8.Param)("file")),
-  _ts_metadata4("design:type", Function),
-  _ts_metadata4("design:paramtypes", [
+_ts_decorate5([
+  (0, import_common9.Get)("assets/:file"),
+  (0, import_common9.Header)("Cache-Control", "public, max-age=31536000, immutable"),
+  _ts_param5(0, (0, import_common9.Param)("file")),
+  _ts_metadata5("design:type", Function),
+  _ts_metadata5("design:paramtypes", [
     String
   ]),
-  _ts_metadata4("design:returntype", typeof import_common8.StreamableFile === "undefined" ? Object : import_common8.StreamableFile)
+  _ts_metadata5("design:returntype", typeof import_common9.StreamableFile === "undefined" ? Object : import_common9.StreamableFile)
 ], AgentUiController.prototype, "asset", null);
-AgentUiController = _ts_decorate4([
-  (0, import_nestjs_agent_core2.CanAnyone)(),
-  (0, import_common8.Controller)(),
-  _ts_param4(0, (0, import_common8.Inject)(DASHBOARD_BASE_PATH)),
-  _ts_param4(1, (0, import_common8.Inject)(DASHBOARD_API_PATH)),
-  _ts_metadata4("design:type", Function),
-  _ts_metadata4("design:paramtypes", [
+AgentUiController = _ts_decorate5([
+  (0, import_nestjs_agent_core3.CanAnyone)(),
+  (0, import_common9.Controller)(),
+  _ts_param5(0, (0, import_common9.Inject)(DASHBOARD_BASE_PATH)),
+  _ts_param5(1, (0, import_common9.Inject)(DASHBOARD_API_PATH)),
+  _ts_metadata5("design:type", Function),
+  _ts_metadata5("design:paramtypes", [
     String,
     String
   ])
 ], AgentUiController);
 
 // src/server/dev-tools.ts
-var import_common9 = require("@nestjs/common");
-function _ts_decorate5(decorators, target, key, desc) {
+var import_common10 = require("@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);
@@ -1643,19 +1900,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;
@@ -1821,7 +2078,7 @@ function agentDevTools(dashboard) {
         try {
           detail = await dashboard.runDetail(String(input.id));
         } catch (error) {
-          if (error instanceof import_common9.NotFoundException) throw new Error(`run ${String(input.id)} not found`);
+          if (error instanceof import_common10.NotFoundException) throw new Error(`run ${String(input.id)} not found`);
           throw error;
         }
         if (input.includeMessages !== true) return detail;
@@ -1989,7 +2246,7 @@ function agentDevTools(dashboard) {
   ];
 }
 __name(agentDevTools, "agentDevTools");
-var logger2 = new import_common9.Logger("AgentDashboardModule");
+var logger3 = new import_common10.Logger("AgentDashboardModule");
 var AgentDevToolsRegistration = class {
   static {
     __name(this, "AgentDevToolsRegistration");
@@ -2015,7 +2272,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() {
@@ -2023,11 +2280,11 @@ var AgentDevToolsRegistration = class {
     this.#unregister = void 0;
   }
 };
-AgentDevToolsRegistration = _ts_decorate5([
-  (0, import_common9.Injectable)(),
-  _ts_param5(0, (0, import_common9.Inject)(DASHBOARD_DEV_TOOLS)),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+AgentDevToolsRegistration = _ts_decorate6([
+  (0, import_common10.Injectable)(),
+  _ts_param6(0, (0, import_common10.Inject)(DASHBOARD_DEV_TOOLS)),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("design:paramtypes", [
     Boolean,
     typeof DashboardService === "undefined" ? Object : DashboardService,
     typeof DashboardConsoleAccess === "undefined" ? Object : DashboardConsoleAccess
@@ -2035,7 +2292,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);
@@ -2048,7 +2305,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);
 }
@@ -2056,8 +2313,8 @@ __name(normalize, "normalize");
 function consoleDecorators(decorators) {
   return [
     ...decorators ?? [],
-    (0, import_common10.UseGuards)(ConsoleAuthorizeGuard),
-    (0, import_common10.UseFilters)(ConsoleAuthorizeFilter)
+    (0, import_common11.UseGuards)(ConsoleAuthorizeGuard),
+    (0, import_common11.UseFilters)(ConsoleAuthorizeFilter)
   ];
 }
 __name(consoleDecorators, "consoleDecorators");
@@ -2076,8 +2333,9 @@ var AgentApiModule = class _AgentApiModule {
       imports: [
         ...options.imports ?? []
       ],
-      controllers: options.routes === false ? [] : (0, import_nestjs_agent_core3.withControllerDecorators)([
-        AgentApiController
+      controllers: options.routes === false ? [] : (0, import_nestjs_agent_core4.withControllerDecorators)([
+        AgentApiController,
+        AgentConsolesController
       ], consoleDecorators(options.decorators)),
       providers: [
         DashboardService,
@@ -2108,8 +2366,8 @@ var AgentApiModule = class _AgentApiModule {
     };
   }
 };
-AgentApiModule = _ts_decorate6([
-  (0, import_common10.Module)({})
+AgentApiModule = _ts_decorate7([
+  (0, import_common11.Module)({})
 ], AgentApiModule);
 var AgentDashboardModule = class _AgentDashboardModule {
   static {
@@ -2156,7 +2414,7 @@ var AgentDashboardModule = class _AgentDashboardModule {
           ])
         ]
       ],
-      controllers: options.routes === false ? [] : (0, import_nestjs_agent_core3.withControllerDecorators)([
+      controllers: options.routes === false ? [] : (0, import_nestjs_agent_core4.withControllerDecorators)([
         AgentUiController
       ], consoleDecorators(options.decorators)),
       providers: [
@@ -2167,7 +2425,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.
@@ -2179,24 +2441,32 @@ var AgentDashboardModule = class _AgentDashboardModule {
     };
   }
 };
-AgentDashboardModule = _ts_decorate6([
-  (0, import_common10.Module)({})
+AgentDashboardModule = _ts_decorate7([
+  (0, import_common11.Module)({})
 ], AgentDashboardModule);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   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,
@@ -2213,8 +2483,10 @@ AgentDashboardModule = _ts_decorate6([
   agentDevTools,
   anyAuthorize,
   authorizeByToken,
+  listVisibleConsoles,
   normalizeConsoleResult,
   parsePriceInput,
+  registerAviaryConsole,
   resolveConsoleAuthorize
 });
 //# sourceMappingURL=index.cjs.map