@dudousxd/nestjs-agent-dashboard 0.15.4 → 0.16.0

package/dist/server/index.d.cts

@@ -1,4 +1,4 @@
-import { ActorSpendRow, AgentGovernanceQueries, ActorDirectory, AgentPricingStore, AgentApprovalPort, GovernanceRange, ModelSpendRow, UsageTrendPoint, ThreadSpendRow, RunMetrics, RunAgentBreakdownRow, RunErrorBreakdownRow, RunTrendPoint, RecentRunRow, ToolCallActivityRow, GovernancePageQuery, ToolCallWhere, GovernancePage, RunWhere, PendingApprovalRow, ApprovalWhere, GovernanceRunDetail, GovernanceThreadDetailQuery, GovernanceThreadDetail, ThreadActivityRow, ToolStatRow, ThreadWhere, CurrentModelPrice, ActorResolver, ModelPriceInput } from '@dudousxd/nestjs-agent-core';
+import { ActorSpendRow, AgentGovernanceQueries, ActorDirectory, AgentPricingStore, AgentApprovalPort, GovernanceRange, ModelSpendRow, UsageTrendPoint, ThreadSpendRow, RunMetrics, RunAgentBreakdownRow, RunErrorBreakdownRow, RunTrendPoint, RecentRunRow, ToolCallActivityRow, GovernancePageQuery, ToolCallWhere, GovernancePage, RunWhere, PendingApprovalRow, ApprovalWhere, GovernanceRunDetail, GovernanceThreadDetailQuery, GovernanceThreadDetail, ThreadActivityRow, ToolStatRow, GenuiStats, ThreadWhere, CurrentModelPrice, ActorResolver, ModelPriceInput } from '@dudousxd/nestjs-agent-core';
 export { ActorDirectory } from '@dudousxd/nestjs-agent-core';
 import { Observable } from 'rxjs';
 import { DynamicModule, Type, CanActivate, Provider, InjectionToken, OptionalFactoryDependency, StreamableFile } from '@nestjs/common';
@@ -95,6 +95,13 @@ declare class DashboardService {
     threadDetail(query: GovernanceThreadDetailQuery): Promise<ThreadDetailWithLabel>;
     /** Per-tool call/failure/rejection/latency rollup for a day range, for the Tools section. */
     toolStats(range: GovernanceRange): Promise<ToolStatRow[]>;
+    /**
+     * Generative-UI telemetry for a day range — first-try success per tool/model, common errors, UI
+     * cost per day/turn and time-to-frame. `genuiStats` is OPTIONAL on the read-model (a store that
+     * does not record UI calls leaves it out), so an unsupported store 501s with a clear message, the
+     * same posture as an unbound pricing store — the console renders that as its own state.
+     */
+    genuiStats(range: GovernanceRange): Promise<GenuiStats>;
     /**
      * Decide a pending HITL tool call from the console. Routes through the OPTIONAL
      * {@link AGENT_APPROVAL_PORT} — bound by `@dudousxd/nestjs-agent` to the SAME signal path chat
@@ -210,6 +217,12 @@ declare class AgentApiController {
     private deciderRef;
     /** Per-tool call/failure/rejection/latency rollup for a day range (defaults to the last 30 days). */
     tools(from?: string, to?: string): Promise<ToolStatRow[]>;
+    /**
+     * Generative-UI telemetry for a day range (defaults to the last 30 days): `{ totals, byToolModel,
+     * errors, byDay, costPerTurn, latency }`. 501s (via `DashboardService.genuiStats`) when the bound
+     * store does not implement `genuiStats`.
+     */
+    genui(from?: string, to?: string): Promise<GenuiStats>;
     /** Most recent threads (default 50, max 200) with rolled-up counts. */
     threads(limit?: string): Promise<ThreadActivityRowWithLabel[]>;
     /**

package/dist/server/index.d.ts

@@ -1,4 +1,4 @@
-import { ActorSpendRow, AgentGovernanceQueries, ActorDirectory, AgentPricingStore, AgentApprovalPort, GovernanceRange, ModelSpendRow, UsageTrendPoint, ThreadSpendRow, RunMetrics, RunAgentBreakdownRow, RunErrorBreakdownRow, RunTrendPoint, RecentRunRow, ToolCallActivityRow, GovernancePageQuery, ToolCallWhere, GovernancePage, RunWhere, PendingApprovalRow, ApprovalWhere, GovernanceRunDetail, GovernanceThreadDetailQuery, GovernanceThreadDetail, ThreadActivityRow, ToolStatRow, ThreadWhere, CurrentModelPrice, ActorResolver, ModelPriceInput } from '@dudousxd/nestjs-agent-core';
+import { ActorSpendRow, AgentGovernanceQueries, ActorDirectory, AgentPricingStore, AgentApprovalPort, GovernanceRange, ModelSpendRow, UsageTrendPoint, ThreadSpendRow, RunMetrics, RunAgentBreakdownRow, RunErrorBreakdownRow, RunTrendPoint, RecentRunRow, ToolCallActivityRow, GovernancePageQuery, ToolCallWhere, GovernancePage, RunWhere, PendingApprovalRow, ApprovalWhere, GovernanceRunDetail, GovernanceThreadDetailQuery, GovernanceThreadDetail, ThreadActivityRow, ToolStatRow, GenuiStats, ThreadWhere, CurrentModelPrice, ActorResolver, ModelPriceInput } from '@dudousxd/nestjs-agent-core';
 export { ActorDirectory } from '@dudousxd/nestjs-agent-core';
 import { Observable } from 'rxjs';
 import { DynamicModule, Type, CanActivate, Provider, InjectionToken, OptionalFactoryDependency, StreamableFile } from '@nestjs/common';
@@ -95,6 +95,13 @@ declare class DashboardService {
     threadDetail(query: GovernanceThreadDetailQuery): Promise<ThreadDetailWithLabel>;
     /** Per-tool call/failure/rejection/latency rollup for a day range, for the Tools section. */
     toolStats(range: GovernanceRange): Promise<ToolStatRow[]>;
+    /**
+     * Generative-UI telemetry for a day range — first-try success per tool/model, common errors, UI
+     * cost per day/turn and time-to-frame. `genuiStats` is OPTIONAL on the read-model (a store that
+     * does not record UI calls leaves it out), so an unsupported store 501s with a clear message, the
+     * same posture as an unbound pricing store — the console renders that as its own state.
+     */
+    genuiStats(range: GovernanceRange): Promise<GenuiStats>;
     /**
      * Decide a pending HITL tool call from the console. Routes through the OPTIONAL
      * {@link AGENT_APPROVAL_PORT} — bound by `@dudousxd/nestjs-agent` to the SAME signal path chat
@@ -210,6 +217,12 @@ declare class AgentApiController {
     private deciderRef;
     /** Per-tool call/failure/rejection/latency rollup for a day range (defaults to the last 30 days). */
     tools(from?: string, to?: string): Promise<ToolStatRow[]>;
+    /**
+     * Generative-UI telemetry for a day range (defaults to the last 30 days): `{ totals, byToolModel,
+     * errors, byDay, costPerTurn, latency }`. 501s (via `DashboardService.genuiStats`) when the bound
+     * store does not implement `genuiStats`.
+     */
+    genui(from?: string, to?: string): Promise<GenuiStats>;
     /** Most recent threads (default 50, max 200) with rolled-up counts. */
     threads(limit?: string): Promise<ThreadActivityRowWithLabel[]>;
     /**

package/dist/server/index.js

@@ -490,6 +490,7 @@ function _ts_param2(paramIndex, decorator) {
 __name(_ts_param2, "_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 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",
   "message",
@@ -621,6 +622,18 @@ var DashboardService = class {
     return this.queries.toolStats(range);
   }
   /**
+  * Generative-UI telemetry for a day range — first-try success per tool/model, common errors, UI
+  * cost per day/turn and time-to-frame. `genuiStats` is OPTIONAL on the read-model (a store that
+  * does not record UI calls leaves it out), so an unsupported store 501s with a clear message, the
+  * same posture as an unbound pricing store — the console renders that as its own state.
+  */
+  async genuiStats(range) {
+    if (this.queries.genuiStats === void 0) {
+      throw new NotImplementedException(GENUI_STATS_UNSUPPORTED_MESSAGE);
+    }
+    return this.queries.genuiStats(range);
+  }
+  /**
   * Decide a pending HITL tool call from the console. Routes through the OPTIONAL
   * {@link AGENT_APPROVAL_PORT} — bound by `@dudousxd/nestjs-agent` to the SAME signal path chat
   * approvals use — so a 501 here (checked BEFORE body validation, same ordering as
@@ -1095,6 +1108,14 @@ var AgentApiController = class {
   tools(from, to) {
     return this.dashboard.toolStats(resolveRange(from, to));
   }
+  /**
+  * Generative-UI telemetry for a day range (defaults to the last 30 days): `{ totals, byToolModel,
+  * errors, byDay, costPerTurn, latency }`. 501s (via `DashboardService.genuiStats`) when the bound
+  * store does not implement `genuiStats`.
+  */
+  genui(from, to) {
+    return this.dashboard.genuiStats(resolveRange(from, to));
+  }
   /** Most recent threads (default 50, max 200) with rolled-up counts. */
   threads(limit) {
     return this.dashboard.recentThreads(parseLimit(limit, 50));
@@ -1285,6 +1306,17 @@ _ts_decorate3([
   ]),
   _ts_metadata3("design:returntype", typeof Promise === "undefined" ? Object : Promise)
 ], AgentApiController.prototype, "tools", null);
+_ts_decorate3([
+  Get("genui"),
+  _ts_param3(0, Query("from")),
+  _ts_param3(1, Query("to")),
+  _ts_metadata3("design:type", Function),
+  _ts_metadata3("design:paramtypes", [
+    String,
+    String
+  ]),
+  _ts_metadata3("design:returntype", typeof Promise === "undefined" ? Object : Promise)
+], AgentApiController.prototype, "genui", null);
 _ts_decorate3([
   Get("threads"),
   _ts_param3(0, Query("limit")),