@dudousxd/nestjs-agent-dashboard 0.21.0 → 0.22.0

package/dist/server/index.js

@@ -1052,8 +1052,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 +1442,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 +1471,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 +1688,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 +1719,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 +1772,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 +2118,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 +2144,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 +2152,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 +2164,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 +2177,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 +2206,8 @@ var AgentApiModule = class _AgentApiModule {
         ...options.imports ?? []
       ],
       controllers: options.routes === false ? [] : withControllerDecorators([
-        AgentApiController
+        AgentApiController,
+        AgentConsolesController
       ], consoleDecorators(options.decorators)),
       providers: [
         DashboardService,
@@ -2042,7 +2238,7 @@ var AgentApiModule = class _AgentApiModule {
     };
   }
 };
-AgentApiModule = _ts_decorate6([
+AgentApiModule = _ts_decorate7([
   Module({})
 ], AgentApiModule);
 var AgentDashboardModule = class _AgentDashboardModule {
@@ -2101,7 +2297,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 +2313,29 @@ 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_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,
   ConsoleAccessDenied,
   ConsoleAuthorizeFilter,
   ConsoleAuthorizeGuard,
@@ -2146,8 +2352,10 @@ export {
   agentDevTools,
   anyAuthorize,
   authorizeByToken,
+  listVisibleConsoles,
   normalizeConsoleResult,
   parsePriceInput,
+  registerAviaryConsole,
   resolveConsoleAuthorize
 };
 //# sourceMappingURL=index.js.map