feat(webapp): dashboard agent — chat, reports, investigate

.changeset/mint-token-cap-help.md

@@ -0,0 +1,5 @@
+---
+"trigger.dev": patch
+---
+
+`trigger mint-token --help` now says that a token minted without `--cap` is read-only, instead of claiming it carries your full role.

.changeset/report-json-and-period-units.md

@@ -0,0 +1,6 @@
+---
+"@trigger.dev/core": patch
+"trigger.dev": patch
+---
+
+Reports can be fetched as structured data with the `json` format. The shortest report period is now one minute (`30m`, `1h`, `7d`).

.gitignore

@@ -85,3 +85,5 @@ ailogger-output.log
 
 # observability-map CLI output artifact, not committed
 observability-map.json
+
+.claude/worktrees/

.server-changes/dashboard-agent.md

@@ -0,0 +1,16 @@
+---
+area: webapp
+type: feature
+---
+
+Meet the dashboard agent: a chat in every environment that answers questions about your runs, queues, errors and health with real data and links. It takes over from Ask AI everywhere that used to appear; on the Free plan you get 20 messages.
+
+**Investigate** on a failed run, an error, a backed-up queue or a run that hasn't started gets you a worked-through answer — what happened, why, and how to fix it, with every claim linked to the runs, errors and deploys behind it.
+
+The agent works on preview and dev branches, with that branch's own data.
+
+The health report reads the same everywhere — dashboard, terminal, editor. A very long chat keeps working: the agent summarises the earlier part and carries on. The agent's replies no longer show images.
+
+A sample of conversations is scored automatically so the agent keeps getting better. Only the score and a one-line summary are kept, never your messages, data or code, and we can switch it off for your organization on request.
+
+Separately: a queue's wait times, peak depth, throughput and throttling can now be read from the API, and the Docs button has been removed from page headers.

apps/webapp/.gitignore

@@ -7,6 +7,9 @@ node_modules
 /cypress/screenshots
 /cypress/videos
 
+# Output of `pnpm run agent-ui:screenshots`
+/screenshots
+
 /app/styles/tailwind.css
 
 # Ensure the .env symlink is not removed by accident
@@ -20,4 +23,4 @@ storybook-static
 
 /prisma/seed.js
 /prisma/populate.js
-.memory-snapshots
+.memory-snapshots

apps/webapp/app/components/AskAI.tsx

@@ -1,3 +1,9 @@
+/**
+ * @deprecated Superseded by the dashboard agent (`components/dashboard-agent`). Nothing mounts
+ * this any more — every Ask AI entry point now opens Ask Trigger. Kept until the agent has
+ * shipped, then removed along with `@kapaai/react-sdk` and `KAPA_AI_WEBSITE_ID`.
+ */
+
 import {
   ArrowPathIcon,
   ArrowUpIcon,
@@ -81,6 +87,8 @@ function useAskAIState() {
  * it around the popover, not inside, so the dialog and shortcut survive the popover closing.
  * `children` receives the open function, or undefined when Ask AI is unavailable (self-hosted, no
  * Kapa website id, or SSR).
+ *
+ * @deprecated See the note at the top of this file.
  */
 export function AskAIRoot({
   children,
@@ -137,6 +145,7 @@ function AskAIRootProvider({
   );
 }
 
+/** @deprecated See the note at the top of this file. */
 export function AskAI({ isCollapsed = false }: { isCollapsed?: boolean }) {
   const { isManagedCloud } = useFeatures();
   const websiteId = useKapaWebsiteId();

apps/webapp/app/components/dashboard-agent/ActionsBlock.tsx

@@ -0,0 +1,31 @@
+import type {
+  ActionsBlock as ActionsBlockPayload,
+  AgentIntent,
+} from "@internal/dashboard-agent-contracts";
+import { Button } from "~/components/primitives/Buttons";
+import { ChatActionsRow } from "./chat-layout";
+import { renderableActions } from "./view-actions";
+
+export function ActionsBlock({
+  block,
+  onIntent,
+}: {
+  block: ActionsBlockPayload;
+  onIntent?: (intent: AgentIntent) => void;
+}) {
+  const renderable = renderableActions(block.actions);
+  if (!onIntent || renderable.length === 0) return null;
+  return (
+    <ChatActionsRow>
+      {renderable.map((action, i) => (
+        <Button
+          key={i}
+          variant={i === 0 ? "primary/small" : "secondary/small"}
+          onClick={() => onIntent(action.intent as AgentIntent)}
+        >
+          {action.label}
+        </Button>
+      ))}
+    </ChatActionsRow>
+  );
+}

apps/webapp/app/components/dashboard-agent/DashboardAgentMessages.tsx

@@ -23,14 +23,65 @@ function viewSpecFor(part: UIMessage["parts"][number]): { blocks: unknown[] } |
   return Array.isArray(p.output?.blocks) ? { blocks: p.output!.blocks! } : null;
 }
 
+function hostViewBlocks(part: UIMessage["parts"][number]): unknown[] | null {
+  const p = part as { type: string; data?: { blocks?: unknown[] } };
+  if (p.type !== "data-view") return null;
+  return Array.isArray(p.data?.blocks) ? p.data!.blocks! : null;
+}
+
+function investigationBlocksFor(part: UIMessage["parts"][number]): unknown[] | null {
+  return viewSpecFor(part)?.blocks ?? hostViewBlocks(part);
+}
+
+type InvestigationRef = { id: string; revision: number };
+
+function investigationRef(block: unknown): InvestigationRef | null {
+  const b = block as { type?: string; id?: string; revision?: number };
+  if (b?.type !== "investigation" || typeof b.id !== "string") return null;
+  return { id: b.id, revision: typeof b.revision === "number" ? b.revision : 0 };
+}
+
+/** Per investigation id, the one `messageId:partIndex` allowed to render: highest revision. */
+export function winningInvestigationOccurrences(messages: UIMessage[]): Map<string, string> {
+  const best = new Map<string, { revision: number; occurrence: string }>();
+  for (const message of messages) {
+    (message.parts ?? []).forEach((part, partIndex) => {
+      for (const block of investigationBlocksFor(part) ?? []) {
+        const ref = investigationRef(block);
+        if (!ref) continue;
+        const current = best.get(ref.id);
+        if (!current || ref.revision >= current.revision) {
+          best.set(ref.id, { revision: ref.revision, occurrence: `${message.id}:${partIndex}` });
+        }
+      }
+    });
+  }
+  return new Map([...best.entries()].map(([id, w]) => [id, w.occurrence]));
+}
+
+function withoutSupersededInvestigations(
+  blocks: unknown[],
+  occurrence: string,
+  winners: Map<string, string> | undefined
+): unknown[] {
+  if (!winners) return blocks;
+  return blocks.filter((block) => {
+    const ref = investigationRef(block);
+    return !ref || winners.get(ref.id) === occurrence;
+  });
+}
+
 // Renders one message. Assistant messages that include a completed render_view
 // part get the catalog cards (plus the gather tool rows / lead-in text for
 // transparency); everything else uses the shared MessageBubble unchanged, so
 // its streaming memoization is preserved for the common case.
 const DashboardAgentMessageBubble = memo(function DashboardAgentMessageBubble({
   message,
+  investigationWinners,
 }: {
   message: UIMessage;
+  /** See {@link winningInvestigationOccurrences}. */
+  investigationWinners?: Map<string, string>;
 }) {
   if (message.role !== "assistant" || !message.parts?.some((p) => viewSpecFor(p))) {
     return <MessageBubble message={message} />;
@@ -39,8 +90,14 @@ const DashboardAgentMessageBubble = memo(function DashboardAgentMessageBubble({
     <div className="space-y-2">
       {message.parts.map((part, i) => {
         const spec = viewSpecFor(part);
-        if (spec) return <ViewBlocks key={i} blocks={spec.blocks as never} />;
-        return renderPart(part, i);
+        if (!spec) return renderPart(part, i);
+        const blocks = withoutSupersededInvestigations(
+          spec.blocks,
+          `${message.id}:${i}`,
+          investigationWinners
+        );
+        if (blocks.length === 0) return null;
+        return <ViewBlocks key={i} blocks={blocks as never} />;
       })}
     </div>
   );
@@ -60,12 +117,17 @@ export function DashboardAgentMessages({
   error?: Error;
 }) {
   const rootRef = useAutoScrollToBottom([messages, isThinking]);
+  const investigationWinners = winningInvestigationOccurrences(messages);
 
   return (
     <div className="flex-1 overflow-y-auto scrollbar-thin scrollbar-track-transparent scrollbar-thumb-surface-control">
       <div ref={rootRef} className="space-y-4 p-4">
         {messages.map((message) => (
-          <DashboardAgentMessageBubble key={message.id} message={stripStepParts(message)} />
+          <DashboardAgentMessageBubble
+            key={message.id}
+            message={stripStepParts(message)}
+            investigationWinners={investigationWinners}
+          />
         ))}
         {isThinking && (
           <div className="flex items-center gap-2 text-sm text-text-dimmed">

apps/webapp/app/components/dashboard-agent/InvestigationCard.test.ts

@@ -0,0 +1,41 @@
+import { readFileSync } from "node:fs";
+import { describe, expect, it } from "vitest";
+
+const source = readFileSync(new URL("./InvestigationCard.tsx", import.meta.url), "utf8");
+
+describe("InvestigationCard purity", () => {
+  it("imports nothing from Remix", () => {
+    expect(source).not.toMatch(/from\s+"@remix-run\//);
+  });
+
+  it("imports no app hooks and no server module", () => {
+    expect(source).not.toMatch(/from\s+"~\/hooks\//);
+    expect(source).not.toMatch(/\.server"/);
+  });
+
+  it("calls no hook other than useState", () => {
+    const hooks = [...source.matchAll(/\buse([A-Z]\w*)\(/g)].map((match) => `use${match[1]}`);
+    expect([...new Set(hooks)]).toEqual(["useState"]);
+  });
+
+  it("resolves evidence URIs through the host, never a route of its own", () => {
+    expect(source).toMatch(/resolveUri/);
+    expect(source).not.toMatch(/\/orgs\//);
+  });
+
+  it("hands its actions to the host as intents, and never composes its own", () => {
+    expect(source).toMatch(/capabilities\?\.actions/);
+    expect(source).toMatch(/onIntent\(action\.intent\)/);
+    expect(source).not.toMatch(/kind:\s*"(ask|navigate)"/);
+    expect(source).toMatch(/ChatActionsRow/);
+  });
+
+  it("renders no spinner — the transcript owns the one live progress element", () => {
+    // A spinner in the card would restart on every revision.
+    expect(source).not.toMatch(/AgentSpinner|ChatProgress|ChatPendingTool/);
+  });
+
+  it("renders nothing action-shaped without a host to hand intents to", () => {
+    expect(source).toMatch(/if \(!onIntent \|\| actions\.length === 0\) return null;/);
+  });
+});