@dudousxd/nestjs-agent-telescope 0.5.0 → 0.6.0

package/dist/index.cjs

@@ -90,15 +90,18 @@ function col(key, label, href) {
   };
 }
 __name(col, "col");
+var DEFAULT_TRACE_HREF = "#/traces/{runId}";
 function agentDashboard(opts = {}) {
+  const runHref = opts.runHref ?? DEFAULT_TRACE_HREF;
   return {
     id: "agent.overview",
     label: "Agent",
     panels: [],
     sections: [
       {
+        // Lean: the headline runs/tokens/success numbers only — Reliability below has the detail.
         title: "Overview",
-        cols: 2,
+        cols: 3,
         panels: [
           {
             kind: "stat",
@@ -113,19 +116,6 @@ function agentDashboard(opts = {}) {
             data: {
               provider: "agent.tokens"
             }
-          }
-        ]
-      },
-      {
-        title: "Reliability",
-        cols: 4,
-        panels: [
-          {
-            kind: "stat",
-            title: "Runs",
-            data: {
-              provider: "agent.runs.total"
-            }
           },
           {
             kind: "stat",
@@ -134,143 +124,12 @@ function agentDashboard(opts = {}) {
               provider: "agent.runs.successRate"
             },
             format: "percent"
-          },
-          {
-            kind: "stat",
-            title: "Failed",
-            data: {
-              provider: "agent.runs.failed"
-            }
-          },
-          {
-            kind: "stat",
-            title: "Retries",
-            data: {
-              provider: "agent.runs.retries"
-            }
-          }
-        ]
-      },
-      {
-        title: "Run trends",
-        cols: 4,
-        panels: [
-          {
-            kind: "timeseries",
-            title: "Runs & failures",
-            data: {
-              provider: "agent.runs.trend"
-            },
-            series: [
-              "runs",
-              "failed"
-            ],
-            style: "stacked"
-          },
-          // Two duration stats, not a `distribution` panel: RunMetrics carries only p50/p95 (no
-          // raw samples to bucket), so a histogram here would be a permanently-empty box.
-          {
-            kind: "stat",
-            title: "Duration p50",
-            data: {
-              provider: "agent.runs.duration",
-              query: {
-                metric: "p50"
-              }
-            },
-            format: "duration"
-          },
-          {
-            kind: "stat",
-            title: "Duration p95",
-            data: {
-              provider: "agent.runs.duration",
-              query: {
-                metric: "p95"
-              }
-            },
-            format: "duration"
-          },
-          {
-            kind: "breakdown",
-            title: "Run errors",
-            data: {
-              provider: "agent.runs.errors"
-            },
-            style: "donut"
-          }
-        ]
-      },
-      {
-        title: "Runs",
-        panels: [
-          {
-            kind: "table",
-            title: "Runs by agent",
-            data: {
-              provider: "agent.runs.byAgent"
-            },
-            columns: [
-              {
-                key: "agentName",
-                label: "Agent"
-              },
-              {
-                key: "runs",
-                label: "Runs"
-              },
-              {
-                key: "failed",
-                label: "Failed"
-              },
-              {
-                key: "retries",
-                label: "Retries"
-              }
-            ]
-          },
-          {
-            kind: "table",
-            title: "Recent runs",
-            data: {
-              provider: "agent.runs.recent"
-            },
-            // A deliberate SUBSET of the provider's row shape: the full 11-field row overflows the
-            // card horizontally. Thread/actor/retries/errorCode detail lives in the standalone
-            // agent dashboard; the provider keeps returning the full row for other consumers.
-            columns: [
-              {
-                key: "startedAt",
-                label: "Started"
-              },
-              col("runId", "Run", opts.runHref),
-              {
-                key: "agentName",
-                label: "Agent"
-              },
-              {
-                key: "status",
-                label: "Status"
-              },
-              {
-                key: "durationMs",
-                label: "Duration (ms)"
-              },
-              {
-                key: "errorMessage",
-                label: "Error"
-              },
-              {
-                key: "promptHash",
-                label: "Prompt"
-              }
-            ]
           }
         ]
       },
       {
         title: "Spend",
-        cols: 2,
+        cols: 4,
         panels: [
           {
             kind: "stat",
@@ -307,12 +166,7 @@ function agentDashboard(opts = {}) {
               "totalTokens"
             ],
             style: "area"
-          }
-        ]
-      },
-      {
-        title: "Models",
-        panels: [
+          },
           {
             kind: "table",
             title: "Usage & cost by model",
@@ -341,13 +195,7 @@ function agentDashboard(opts = {}) {
                 label: "Cost (USD)"
               }
             ]
-          }
-        ]
-      },
-      {
-        title: "Actors",
-        cols: 2,
-        panels: [
+          },
           {
             kind: "breakdown",
             title: "Spend share by actor",
@@ -380,13 +228,7 @@ function agentDashboard(opts = {}) {
                 label: "Cost (USD)"
               }
             ]
-          }
-        ]
-      },
-      {
-        title: "Threads",
-        cols: 2,
-        panels: [
+          },
           {
             kind: "table",
             title: "Top threads by cost",
@@ -415,12 +257,192 @@ function agentDashboard(opts = {}) {
                 label: "Cost (USD)"
               }
             ]
+          }
+        ]
+      },
+      {
+        title: "Reliability",
+        cols: 3,
+        panels: [
+          {
+            kind: "stat",
+            title: "Runs",
+            data: {
+              provider: "agent.runs.total"
+            }
+          },
+          {
+            kind: "stat",
+            title: "Success rate",
+            data: {
+              provider: "agent.runs.successRate"
+            },
+            format: "percent"
+          },
+          {
+            kind: "stat",
+            title: "Failed",
+            data: {
+              provider: "agent.runs.failed"
+            }
+          },
+          {
+            kind: "stat",
+            title: "Retries",
+            data: {
+              provider: "agent.runs.retries"
+            }
+          },
+          {
+            kind: "stat",
+            title: "Duration p50",
+            data: {
+              provider: "agent.runs.duration",
+              query: {
+                metric: "p50"
+              }
+            },
+            format: "duration"
+          },
+          {
+            kind: "stat",
+            title: "Duration p95",
+            data: {
+              provider: "agent.runs.duration",
+              query: {
+                metric: "p95"
+              }
+            },
+            format: "duration"
+          },
+          // Two duration stats above, not a `distribution` panel: RunMetrics carries only p50/p95
+          // (no raw samples to bucket), so a histogram here would be a permanently-empty box.
+          {
+            kind: "timeseries",
+            title: "Runs & failures",
+            data: {
+              provider: "agent.runs.trend"
+            },
+            series: [
+              "runs",
+              "failed"
+            ],
+            style: "stacked"
+          },
+          {
+            kind: "breakdown",
+            title: "Run errors",
+            data: {
+              provider: "agent.runs.errors"
+            },
+            style: "donut"
+          },
+          {
+            kind: "table",
+            title: "Runs by agent",
+            data: {
+              provider: "agent.runs.byAgent"
+            },
+            columns: [
+              {
+                key: "agentName",
+                label: "Agent"
+              },
+              {
+                key: "runs",
+                label: "Runs"
+              },
+              {
+                key: "failed",
+                label: "Failed"
+              },
+              {
+                key: "retries",
+                label: "Retries"
+              }
+            ]
+          }
+        ]
+      },
+      {
+        // The paged list tables: tool calls, threads, runs — each reads the paged SPI
+        // (toolCallsPage/threadsPage/runsPage via `agent.*.paged`) and opts into the renderer's
+        // pagination (`paged: true`, telescope >= 1.18): prev/next + "Page X of Y".
+        title: "Activity",
+        cols: 3,
+        panels: [
+          {
+            kind: "table",
+            title: "Recent runs",
+            paged: true,
+            data: {
+              provider: "agent.runs.paged"
+            },
+            // A deliberate SUBSET of the provider's row shape: the full 11-field row overflows the
+            // card horizontally. Thread/actor/retries/errorCode detail lives in the standalone
+            // agent dashboard; the provider keeps returning the full row for other consumers.
+            columns: [
+              {
+                key: "startedAt",
+                label: "Started"
+              },
+              col("runId", "Run", runHref),
+              {
+                key: "agentName",
+                label: "Agent"
+              },
+              {
+                key: "status",
+                label: "Status"
+              },
+              {
+                key: "durationMs",
+                label: "Duration (ms)"
+              },
+              {
+                key: "errorMessage",
+                label: "Error"
+              },
+              {
+                key: "promptHash",
+                label: "Prompt"
+              }
+            ]
+          },
+          {
+            kind: "table",
+            title: "Recent tool calls",
+            paged: true,
+            data: {
+              provider: "agent.tools.paged"
+            },
+            columns: [
+              {
+                key: "createdAt",
+                label: "When"
+              },
+              {
+                key: "toolName",
+                label: "Tool"
+              },
+              {
+                key: "toolType",
+                label: "Type"
+              },
+              {
+                key: "status",
+                label: "Status"
+              },
+              col("runId", "Run", runHref),
+              col("threadId", "Thread", opts.threadHref)
+            ]
           },
           {
             kind: "table",
             title: "Recently active threads",
+            paged: true,
             data: {
-              provider: "agent.threads.recent"
+              provider: "agent.threads.paged"
             },
             columns: [
               col("threadId", "Thread", opts.threadHref),
@@ -450,7 +472,7 @@ function agentDashboard(opts = {}) {
       },
       {
         title: "Approvals",
-        cols: 3,
+        cols: 2,
         panels: [
           {
             kind: "stat",
@@ -479,6 +501,7 @@ function agentDashboard(opts = {}) {
                 label: "Thread"
               },
               col("threadId", "Thread id", opts.threadHref),
+              col("runId", "Run", runHref),
               {
                 key: "actorRef",
                 label: "Actor"
@@ -535,32 +558,6 @@ function agentDashboard(opts = {}) {
                 label: "p95 (ms)"
               }
             ]
-          },
-          {
-            kind: "table",
-            title: "Recent tool calls",
-            data: {
-              provider: "agent.tools.recent"
-            },
-            columns: [
-              {
-                key: "createdAt",
-                label: "When"
-              },
-              {
-                key: "toolName",
-                label: "Tool"
-              },
-              {
-                key: "toolType",
-                label: "Type"
-              },
-              {
-                key: "status",
-                label: "Status"
-              },
-              col("threadId", "Thread", opts.threadHref)
-            ]
           }
         ]
       }
@@ -661,7 +658,7 @@ function isRecord(value) {
 }
 __name(isRecord, "isRecord");
 function isGovernanceQueries(value) {
-  return isRecord(value) && typeof value.spendByModel === "function" && typeof value.spendByActor === "function" && typeof value.spendByThread === "function" && typeof value.usageTrend === "function" && typeof value.recentToolCalls === "function" && typeof value.recentThreads === "function" && typeof value.runMetrics === "function" && typeof value.runsByAgent === "function" && typeof value.runErrors === "function" && typeof value.runTrend === "function" && typeof value.recentRuns === "function" && typeof value.pendingApprovals === "function" && typeof value.toolStats === "function";
+  return isRecord(value) && typeof value.spendByModel === "function" && typeof value.spendByActor === "function" && typeof value.spendByThread === "function" && typeof value.usageTrend === "function" && typeof value.recentToolCalls === "function" && typeof value.recentThreads === "function" && typeof value.runMetrics === "function" && typeof value.runsByAgent === "function" && typeof value.runErrors === "function" && typeof value.runTrend === "function" && typeof value.recentRuns === "function" && typeof value.pendingApprovals === "function" && typeof value.toolStats === "function" && typeof value.toolCallsPage === "function" && typeof value.threadsPage === "function" && typeof value.runsPage === "function";
 }
 __name(isGovernanceQueries, "isGovernanceQueries");
 function resolveGovernanceQueries(ctx) {
@@ -830,7 +827,8 @@ function toPendingApprovalTableRows(rows) {
     threadTitle: row.threadTitle,
     actorRef: row.actorRef,
     agentName: row.agentName ?? NO_VALUE,
-    requestedAt: row.requestedAt
+    requestedAt: row.requestedAt,
+    runId: row.runId
   }));
 }
 __name(toPendingApprovalTableRows, "toPendingApprovalTableRows");
@@ -999,6 +997,41 @@ function governanceLimitProvider(name, defaultLimit, fetch, format) {
   };
 }
 __name(governanceLimitProvider, "governanceLimitProvider");
+function resolvePage(query) {
+  const raw = query?.page;
+  const value = typeof raw === "number" && Number.isFinite(raw) ? raw : 1;
+  return Math.max(1, Math.trunc(value));
+}
+__name(resolvePage, "resolvePage");
+function governancePagedTableProvider(name, defaultLimit, fetch, format) {
+  return {
+    name,
+    async resolve(query, ctx) {
+      const queries = resolveGovernanceQueries(ctx);
+      const page = resolvePage(query);
+      const limit = resolveLimit(query, defaultLimit);
+      if (!queries) {
+        return {
+          rows: [],
+          total: 0,
+          page,
+          limit
+        };
+      }
+      const resolved = await fetch(queries, {
+        page,
+        pageSize: limit
+      });
+      return {
+        rows: format(resolved.rows),
+        total: resolved.total,
+        page: resolved.page,
+        limit: resolved.pageSize
+      };
+    }
+  };
+}
+__name(governancePagedTableProvider, "governancePagedTableProvider");
 function agentRecentRunsTableProvider() {
   return governanceLimitProvider("agent.runs.recent", DEFAULT_RECENT_LIMIT, (queries, limit) => queries.recentRuns(limit), (rows) => ({
     rows: toRecentRunTableRows(rows)
@@ -1017,6 +1050,18 @@ function agentRecentThreadsTableProvider() {
   }));
 }
 __name(agentRecentThreadsTableProvider, "agentRecentThreadsTableProvider");
+function agentToolCallsPagedTableProvider() {
+  return governancePagedTableProvider("agent.tools.paged", DEFAULT_RECENT_LIMIT, (queries, query) => queries.toolCallsPage(query), toRecentToolCallRows);
+}
+__name(agentToolCallsPagedTableProvider, "agentToolCallsPagedTableProvider");
+function agentThreadsPagedTableProvider() {
+  return governancePagedTableProvider("agent.threads.paged", DEFAULT_RECENT_LIMIT, (queries, query) => queries.threadsPage(query), toRecentThreadTableRows);
+}
+__name(agentThreadsPagedTableProvider, "agentThreadsPagedTableProvider");
+function agentRunsPagedTableProvider() {
+  return governancePagedTableProvider("agent.runs.paged", DEFAULT_RECENT_LIMIT, (queries, query) => queries.runsPage(query), toRecentRunTableRows);
+}
+__name(agentRunsPagedTableProvider, "agentRunsPagedTableProvider");
 var PENDING_APPROVALS_COUNT_LIMIT = 500;
 function agentPendingApprovalsCountProvider() {
   return {
@@ -1121,6 +1166,9 @@ function agentTelescopeExtension(opts = {}) {
       agentRecentRunsTableProvider(),
       agentRecentToolCallsTableProvider(),
       agentRecentThreadsTableProvider(),
+      agentRunsPagedTableProvider(),
+      agentToolCallsPagedTableProvider(),
+      agentThreadsPagedTableProvider(),
       agentPendingApprovalsCountProvider(),
       agentPendingApprovalsTableProvider(),
       agentToolStatsTableProvider()