@dudousxd/nestjs-agent-dashboard 0.13.1 → 0.14.1

package/dist/server/index.cjs

@@ -590,10 +590,56 @@ var DashboardService = class {
   runsPage(query) {
     return this.queries.runsPage(query);
   }
-  /** Tool calls sitting `pending_approval`, oldest first, for the cross-thread approvals inbox. */
+  /**
+  * Tool calls sitting `pending_approval`, oldest first, for the cross-thread approvals inbox.
+  * Capped and totalless — kept because the SPA still calls `GET approvals`; new callers want
+  * {@link approvalsPage}, which reports how much of the backlog the cap hid.
+  */
   pendingApprovals(limit) {
     return this.queries.pendingApprovals(limit);
   }
+  /** Paged, filterable approvals inbox with a total — the backlog-safe read of the HITL queue. */
+  approvalsPage(query) {
+    return this.queries.approvalsPage(query);
+  }
+  /**
+  * One run with its thread and its tool calls. 404s on an unknown id rather than returning an empty
+  * detail: "this run does not exist" and "this run did nothing" are different answers, and a console
+  * that conflates them sends an operator looking for a bug that isn't there.
+  */
+  async runDetail(runId) {
+    const detail = await this.queries.runDetail(runId);
+    if (detail === null) {
+      throw new import_common4.NotFoundException(`No run "${runId}".`);
+    }
+    const [thread] = await this.withActorLabels([
+      detail.thread
+    ]);
+    return {
+      ...detail,
+      thread: thread ?? {
+        ...detail.thread,
+        actorLabel: null
+      }
+    };
+  }
+  /** 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);
+    if (detail === null) {
+      throw new import_common4.NotFoundException(`No thread "${query.threadId}".`);
+    }
+    const [thread] = await this.withActorLabels([
+      detail.thread
+    ]);
+    return {
+      ...detail,
+      thread: thread ?? {
+        ...detail.thread,
+        actorLabel: null
+      }
+    };
+  }
   /** Per-tool call/failure/rejection/latency rollup for a day range, for the Tools section. */
   toolStats(range) {
     return this.queries.toolStats(range);
@@ -827,6 +873,7 @@ var RUN_WHERE_FIELDS = [
   "agentName",
   "status",
   "errorCode",
+  "threadId",
   "fromDay",
   "toDay"
 ];
@@ -844,6 +891,9 @@ function parseRunWhere(raw) {
     ...raw.errorCode !== void 0 ? {
       errorCode: raw.errorCode
     } : {},
+    ...raw.threadId !== void 0 ? {
+      threadId: raw.threadId
+    } : {},
     ...raw.fromDay !== void 0 ? {
       fromDay: raw.fromDay
     } : {},
@@ -853,6 +903,40 @@ function parseRunWhere(raw) {
   };
 }
 __name(parseRunWhere, "parseRunWhere");
+var APPROVAL_WHERE_FIELDS = [
+  "toolName",
+  "threadId",
+  "actorRef",
+  "agentName",
+  "fromDay",
+  "toDay"
+];
+function parseApprovalWhere(raw) {
+  if (raw === void 0 || Object.keys(raw).length === 0) return void 0;
+  assertKnownFields(raw, APPROVAL_WHERE_FIELDS);
+  assertDayFields(raw, DAY_FIELDS);
+  return {
+    ...raw.toolName !== void 0 ? {
+      toolName: raw.toolName
+    } : {},
+    ...raw.threadId !== void 0 ? {
+      threadId: raw.threadId
+    } : {},
+    ...raw.actorRef !== void 0 ? {
+      actorRef: raw.actorRef
+    } : {},
+    ...raw.agentName !== void 0 ? {
+      agentName: raw.agentName
+    } : {},
+    ...raw.fromDay !== void 0 ? {
+      fromDay: raw.fromDay
+    } : {},
+    ...raw.toDay !== void 0 ? {
+      toDay: raw.toDay
+    } : {}
+  };
+}
+__name(parseApprovalWhere, "parseApprovalWhere");
 
 // src/server/agent-api.controller.ts
 function _ts_decorate3(decorators, target, key, desc) {
@@ -938,6 +1022,16 @@ var AgentApiController = class {
       } : {}
     });
   }
+  /**
+  * One run drill-down: the run, its owning thread's headline (actor-labeled) and its tool calls, in
+  * ONE round trip. 404s on an unknown run id.
+  *
+  * Declared AFTER `runs-page` so the literal route wins over this parameterised one regardless of
+  * how the router orders same-prefix paths.
+  */
+  runDetail(runId) {
+    return this.dashboard.runDetail(runId);
+  }
   /** Most recent tool calls (default 50, max 200) for the activity feed. */
   toolCalls(limit) {
     return this.dashboard.recentToolCalls(parseLimit(limit, 50));
@@ -957,11 +1051,34 @@ var AgentApiController = class {
       } : {}
     });
   }
-  /** Tool calls sitting `pending_approval` (default 50, max 200), oldest first — the approvals inbox. */
+  /**
+  * Tool calls sitting `pending_approval` (default 50, max 200), oldest first — the approvals inbox.
+  *
+  * Capped with NO total, so a backlog past `limit` is invisible from the response alone. Kept
+  * because the SPA still calls it; anything new should call `approvals-page` instead.
+  */
   approvals(limit) {
     return this.dashboard.pendingApprovals(parseLimit(limit, 50));
   }
   /**
+  * Paged, filterable approvals inbox, oldest first. `page` (default 1), `limit` (default 25, max
+  * 200), and `where[toolName]`/`where[threadId]`/`where[actorRef]`/`where[agentName]`/
+  * `where[fromDay]`/`where[toDay]` (`YYYY-MM-DD`) — an unknown `where` field 400s naming it.
+  *
+  * Unlike `GET approvals` this reports `total`, so the console can say "showing N of M" instead of
+  * silently hiding pending decisions behind a row cap.
+  */
+  approvalsPage(page, limit, where) {
+    const parsedWhere = parseApprovalWhere(where);
+    return this.dashboard.approvalsPage({
+      page: parsePageNumber(page),
+      pageSize: parseLimit(limit, 25),
+      ...parsedWhere !== void 0 ? {
+        where: parsedWhere
+      } : {}
+    });
+  }
+  /**
   * Decide a pending HITL tool call. Body `{ approved: boolean; reason?: string }`. 501s (via
   * `DashboardService.decideApproval`) when no `AGENT_APPROVAL_PORT` is bound. `executedByRef`
   * comes from {@link deciderRef} run against the live request.
@@ -1013,6 +1130,22 @@ var AgentApiController = class {
     });
   }
   /**
+  * One thread drill-down: the thread (actor-labeled), its lifetime token/cost rollup, its newest
+  * runs and its newest messages, in ONE round trip. `messages` (default 50, max 200) and `runs`
+  * (default 25, max 200) cap the two lists; `runTotal` and `thread.messageCount` report the true
+  * sizes so the console can say what the caps hid. 404s on an unknown thread id.
+  *
+  * A soft-deleted thread is still returned, flagged `deleted: true` — an audit needs the thread it
+  * just lost, and the alternative is a drill-down that 404s on exactly the interesting case.
+  */
+  threadDetail(threadId, messages, runs) {
+    return this.dashboard.threadDetail({
+      threadId,
+      messageLimit: parseLimit(messages, 50),
+      runLimit: parseLimit(runs, 25)
+    });
+  }
+  /**
   * Current price row per model, for the pricing tab. 501s (via `DashboardService.listPrices`) when
   * no `AGENT_PRICING_STORE` is bound.
   */
@@ -1089,6 +1222,15 @@ _ts_decorate3([
   ]),
   _ts_metadata3("design:returntype", typeof Promise === "undefined" ? Object : Promise)
 ], AgentApiController.prototype, "runsPage", null);
+_ts_decorate3([
+  (0, import_common6.Get)("runs/:runId"),
+  _ts_param3(0, (0, import_common6.Param)("runId")),
+  _ts_metadata3("design:type", Function),
+  _ts_metadata3("design:paramtypes", [
+    String
+  ]),
+  _ts_metadata3("design:returntype", typeof Promise === "undefined" ? Object : Promise)
+], AgentApiController.prototype, "runDetail", null);
 _ts_decorate3([
   (0, import_common6.Get)("tool-calls"),
   _ts_param3(0, (0, import_common6.Query)("limit")),
@@ -1120,6 +1262,19 @@ _ts_decorate3([
   ]),
   _ts_metadata3("design:returntype", typeof Promise === "undefined" ? Object : Promise)
 ], AgentApiController.prototype, "approvals", null);
+_ts_decorate3([
+  (0, import_common6.Get)("approvals-page"),
+  _ts_param3(0, (0, import_common6.Query)("page")),
+  _ts_param3(1, (0, import_common6.Query)("limit")),
+  _ts_param3(2, (0, import_common6.Query)("where")),
+  _ts_metadata3("design:type", Function),
+  _ts_metadata3("design:paramtypes", [
+    String,
+    String,
+    typeof Record === "undefined" ? Object : Record
+  ]),
+  _ts_metadata3("design:returntype", typeof Promise === "undefined" ? Object : Promise)
+], AgentApiController.prototype, "approvalsPage", null);
 _ts_decorate3([
   (0, import_common6.Post)("approvals/:toolCallId"),
   (0, import_common6.HttpCode)(204),
@@ -1167,6 +1322,19 @@ _ts_decorate3([
   ]),
   _ts_metadata3("design:returntype", typeof Promise === "undefined" ? Object : Promise)
 ], AgentApiController.prototype, "threadsPage", null);
+_ts_decorate3([
+  (0, import_common6.Get)("threads/:threadId"),
+  _ts_param3(0, (0, import_common6.Param)("threadId")),
+  _ts_param3(1, (0, import_common6.Query)("messages")),
+  _ts_param3(2, (0, import_common6.Query)("runs")),
+  _ts_metadata3("design:type", Function),
+  _ts_metadata3("design:paramtypes", [
+    String,
+    String,
+    String
+  ]),
+  _ts_metadata3("design:returntype", typeof Promise === "undefined" ? Object : Promise)
+], AgentApiController.prototype, "threadDetail", null);
 _ts_decorate3([
   (0, import_common6.Get)("pricing"),
   _ts_metadata3("design:type", Function),