@graph8/sdk 0.370.0 → 0.373.0

package/blocks/agents/block.json

@@ -18,33 +18,89 @@
   "operations": [
     "attach_skills_to_agent_voice_agents__agent_id__skills_post",
     "cancel_agent_run_agent_runs__run_id__cancel_post",
+    "clone_agent_voice_agents_clone_post",
     "create_agent_run_agent_runs_post",
+    "create_agent_session_agent_sessions_post",
     "create_agent_test_case_voice_agents__agent_id__test_cases_post",
+    "create_authored_knowledge_amendment_knowledge_authored__concept_id__amendments_post",
+    "create_authored_knowledge_knowledge_authored_post",
+    "create_from_template_skills_from_template_post",
     "create_skill_skills_post",
     "create_voice_agent_voice_agents_post",
     "decide_agent_approval_agent_approvals__approval_id__decide_post",
     "delete_agent_document_voice_agent_documents__document_id__delete",
+    "delete_agent_session_agent_sessions__session_id__delete",
+    "delete_agent_test_case_voice_agents__agent_id__test_cases__test_case_id__delete",
+    "delete_chat_agent_conversation_voice_chat_agent_conversations__chat_id__delete",
+    "delete_skill_skills__action_id__delete",
     "delete_voice_agent_voice_agents__agent_id__delete",
+    "deprecate_authored_knowledge_knowledge_authored__concept_id__deprecate_post",
     "detach_skill_from_agent_voice_agents__agent_id__skills__action_id__delete",
+    "ensure_receptionist_agent_voice_agents_receptionist_post",
     "execute_skill_skills__action_id__execute_post",
+    "export_knowledge_knowledge_export_get",
+    "extract_variables_skills__action_id__variables_get",
+    "get_agent_activity_voice_agents__agent_id__activity_get",
+    "get_agent_approval_receipts_agent_approvals__approval_id__receipts_get",
+    "get_agent_operators_summary_agent_operators_summary_get",
+    "get_agent_oversight_agent_oversight_get",
     "get_agent_run_agent_runs__run_id__get",
+    "get_agent_session_state_agent_sessions__session_id__state_get",
+    "get_agent_skill_stats_voice_agents__agent_id__skill_stats_get",
     "get_agent_test_suite_status_voice_agents__agent_id__test_suite_status_get",
+    "get_chat_agent_history_voice_chat_agent_history_post",
+    "get_knowledge_history_knowledge__concept_id__history_get",
+    "get_knowledge_knowledge__concept_id__get",
+    "get_knowledge_status_knowledge_status_get",
+    "get_skill_skills__action_id__get",
     "get_voice_agent_voice_agents__agent_id__get",
+    "knowledge_sources_knowledge__concept_id__sources_get",
+    "list_agent_approval_history_agent_approvals_history_get",
     "list_agent_approvals_agent_approvals_get",
     "list_agent_documents_voice_agents__agent_id__documents_get",
+    "list_agent_operator_activity_agent_operators__operator__activity_get",
+    "list_agent_operator_findings_agent_operators__operator__findings_get",
+    "list_agent_operator_skills_agent_operators__operator__skills_get",
+    "list_agent_operators_agent_operators_get",
     "list_agent_runs_agent_runs_get",
+    "list_agent_sessions_agent_sessions_get",
     "list_agent_skills_voice_agents__agent_id__skills_get",
     "list_agent_specialists_agent_specialists_get",
+    "list_agent_templates_voice_agent_templates_get",
     "list_agent_test_cases_voice_agents__agent_id__test_cases_get",
+    "list_agent_test_runs_voice_agents__agent_id__test_runs_get",
+    "list_chat_agent_conversations_voice_chat_agent_conversations_post",
+    "list_knowledge_knowledge_get",
     "list_models_skills_models_get",
     "list_preset_voices_voice_voice_library_presets_get",
     "list_skills_skills_get",
+    "list_templates_skills_templates_get",
     "list_voice_agents_voice_agents_get",
+    "mark_agent_session_read_agent_sessions__session_id__read_put",
+    "pin_agent_session_agent_sessions__session_id__pin_post",
+    "post_agent_chat_agent_chat_post",
+    "post_agent_session_message_agent_sessions__session_id__messages_post",
+    "related_knowledge_knowledge__concept_id__related_get",
+    "rename_agent_session_agent_sessions__session_id__rename_post",
+    "rename_chat_agent_conversation_voice_chat_agent_conversations__chat_id__name_put",
+    "request_agent_approval_changes_agent_approvals__approval_id__request_changes_post",
     "run_agent_test_voice_agents__agent_id__test_post",
     "run_all_agent_tests_voice_agents__agent_id__test_run_all_post",
+    "save_agent_as_template_voice_agents__agent_id__save_as_template_post",
     "search_knowledge_knowledge_search_get",
+    "send_chat_agent_message_voice_chat_agent_messages_post",
+    "set_agent_operator_enabled_agent_operators__operator__enabled_put",
+    "set_agent_operator_trust_dial_agent_operators__operator__skills__skill_key__put",
+    "steer_agent_work_item_agent_work_items__work_item_id__steer_post",
+    "toggle_receptionist_agent_voice_agents_receptionist_patch",
+    "transfer_chat_agent_conversation_voice_chat_agent_conversations__chat_id__transfer_to_human_post",
+    "update_agent_test_case_voice_agents__agent_id__test_cases__test_case_id__put",
+    "update_authored_knowledge_draft_knowledge_authored__concept_id__patch",
+    "update_skill_skills__action_id__put",
     "update_voice_agent_voice_agents__agent_id__put",
-    "upload_agent_documents_voice_agents__agent_id__documents_upload_post"
+    "upload_agent_documents_voice_agents__agent_id__documents_upload_post",
+    "validate_template_skills_validate_post",
+    "verify_authored_knowledge_knowledge_authored__concept_id__verify_post"
   ],
   "components": [
     {
@@ -70,7 +126,8 @@
         "get_agent_run_agent_runs__run_id__get",
         "list_agent_approvals_agent_approvals_get",
         "decide_agent_approval_agent_approvals__approval_id__decide_post",
-        "cancel_agent_run_agent_runs__run_id__cancel_post"
+        "cancel_agent_run_agent_runs__run_id__cancel_post",
+        "steer_agent_work_item_agent_work_items__work_item_id__steer_post"
       ],
       "tiers": [
         "read",
@@ -169,6 +226,241 @@
         "write",
         "destructive"
       ]
+    },
+    {
+      "name": "AgentActivity",
+      "file": "components/agent-activity.tsx",
+      "purpose": "An agent's recent calls, skill runs, workflow runs and chats over 7, 30 or 90 days, with how its skills performed.",
+      "operations": [
+        "get_agent_activity_voice_agents__agent_id__activity_get",
+        "get_agent_skill_stats_voice_agents__agent_id__skill_stats_get"
+      ],
+      "tiers": [
+        "read"
+      ]
+    },
+    {
+      "name": "AgentConversations",
+      "file": "components/agent-conversations.tsx",
+      "purpose": "An agent's chat history: conversations, their messages, rename, hand over to a human, delete, and a message box (billable, confirmed).",
+      "operations": [
+        "get_chat_agent_history_voice_chat_agent_history_post",
+        "list_chat_agent_conversations_voice_chat_agent_conversations_post",
+        "rename_chat_agent_conversation_voice_chat_agent_conversations__chat_id__name_put",
+        "transfer_chat_agent_conversation_voice_chat_agent_conversations__chat_id__transfer_to_human_post",
+        "delete_chat_agent_conversation_voice_chat_agent_conversations__chat_id__delete",
+        "send_chat_agent_message_voice_chat_agent_messages_post"
+      ],
+      "tiers": [
+        "read",
+        "write",
+        "billable",
+        "destructive"
+      ]
+    },
+    {
+      "name": "AgentTestHistory",
+      "file": "components/agent-test-history.tsx",
+      "purpose": "Saved test cases (edit, delete) and every test run of one agent.",
+      "operations": [
+        "update_agent_test_case_voice_agents__agent_id__test_cases__test_case_id__put",
+        "list_agent_test_cases_voice_agents__agent_id__test_cases_get",
+        "list_agent_test_runs_voice_agents__agent_id__test_runs_get",
+        "delete_agent_test_case_voice_agents__agent_id__test_cases__test_case_id__delete"
+      ],
+      "tiers": [
+        "read",
+        "write",
+        "destructive"
+      ]
+    },
+    {
+      "name": "NameDialog",
+      "file": "components/name-dialog.tsx",
+      "purpose": "A small dialog that asks for one name; used by the duplicate and save-as-template buttons.",
+      "operations": [],
+      "tiers": []
+    },
+    {
+      "name": "DuplicateAgentButton",
+      "file": "components/duplicate-agent-button.tsx",
+      "purpose": "Copy an agent under a new name (retry-safe).",
+      "operations": [
+        "clone_agent_voice_agents_clone_post"
+      ],
+      "tiers": [
+        "write"
+      ]
+    },
+    {
+      "name": "SaveAsTemplateButton",
+      "file": "components/save-as-template-button.tsx",
+      "purpose": "Keep an agent as a reusable workspace template.",
+      "operations": [
+        "save_agent_as_template_voice_agents__agent_id__save_as_template_post"
+      ],
+      "tiers": [
+        "write"
+      ]
+    },
+    {
+      "name": "FromTemplateButton",
+      "file": "components/from-template-button.tsx",
+      "purpose": "Start a new agent from a graph8 or workspace template.",
+      "operations": [
+        "list_agent_templates_voice_agent_templates_get",
+        "clone_agent_voice_agents_clone_post"
+      ],
+      "tiers": [
+        "read",
+        "write"
+      ]
+    },
+    {
+      "name": "ReceptionistButton",
+      "file": "components/receptionist-button.tsx",
+      "purpose": "Set up the workspace receptionist and switch it on or off (confirmed).",
+      "operations": [
+        "ensure_receptionist_agent_voice_agents_receptionist_post",
+        "toggle_receptionist_agent_voice_agents_receptionist_patch"
+      ],
+      "tiers": [
+        "write"
+      ]
+    },
+    {
+      "name": "SkillLibrary",
+      "file": "components/skill-library.tsx",
+      "purpose": "Every skill in one list: search, filter by kind and state, open to edit, write a new LLM or API skill, or start from a template.",
+      "operations": [
+        "list_templates_skills_templates_get",
+        "create_from_template_skills_from_template_post",
+        "list_skills_skills_get"
+      ],
+      "tiers": [
+        "read",
+        "write"
+      ]
+    },
+    {
+      "name": "SkillEditor",
+      "file": "components/skill-editor.tsx",
+      "purpose": "Create or edit one skill in a side sheet: loaded first, only changed fields saved, placeholders, template check, enable/disable, delete (confirmed).",
+      "operations": [
+        "get_skill_skills__action_id__get",
+        "extract_variables_skills__action_id__variables_get",
+        "list_models_skills_models_get",
+        "create_skill_skills_post",
+        "update_skill_skills__action_id__put",
+        "delete_skill_skills__action_id__delete",
+        "validate_template_skills_validate_post"
+      ],
+      "tiers": [
+        "read",
+        "write",
+        "destructive"
+      ]
+    },
+    {
+      "name": "KnowledgeBrowser",
+      "file": "components/knowledge-browser.tsx",
+      "purpose": "Company knowledge agents draw on: status, search or browse by type and lifecycle, open an entry, write a new one, export.",
+      "operations": [
+        "get_knowledge_status_knowledge_status_get",
+        "list_knowledge_knowledge_get",
+        "search_knowledge_knowledge_search_get",
+        "export_knowledge_knowledge_export_get"
+      ],
+      "tiers": [
+        "read"
+      ]
+    },
+    {
+      "name": "KnowledgeDetail",
+      "file": "components/knowledge-detail.tsx",
+      "purpose": "One knowledge entry: content, history, sources, related; edit a draft, propose a new version, verify, deprecate (confirmed).",
+      "operations": [
+        "get_knowledge_history_knowledge__concept_id__history_get",
+        "get_knowledge_knowledge__concept_id__get",
+        "knowledge_sources_knowledge__concept_id__sources_get",
+        "related_knowledge_knowledge__concept_id__related_get",
+        "verify_authored_knowledge_knowledge_authored__concept_id__verify_post",
+        "deprecate_authored_knowledge_knowledge_authored__concept_id__deprecate_post"
+      ],
+      "tiers": [
+        "read",
+        "write"
+      ]
+    },
+    {
+      "name": "KnowledgeForm",
+      "file": "components/knowledge-form.tsx",
+      "purpose": "Write a knowledge entry in a side sheet: new, edit a draft, or propose an amendment.",
+      "operations": [
+        "create_authored_knowledge_knowledge_authored_post",
+        "update_authored_knowledge_draft_knowledge_authored__concept_id__patch",
+        "create_authored_knowledge_amendment_knowledge_authored__concept_id__amendments_post"
+      ],
+      "tiers": [
+        "write"
+      ]
+    },
+    {
+      "name": "AgentApprovals",
+      "file": "components/agent-approvals.tsx",
+      "purpose": "The approvals inbox: oversight, pending approvals (approve, reject, request changes) and decided history with receipts.",
+      "operations": [
+        "get_agent_approval_receipts_agent_approvals__approval_id__receipts_get",
+        "get_agent_oversight_agent_oversight_get",
+        "list_agent_approvals_agent_approvals_get",
+        "list_agent_approval_history_agent_approvals_history_get",
+        "decide_agent_approval_agent_approvals__approval_id__decide_post",
+        "request_agent_approval_changes_agent_approvals__approval_id__request_changes_post"
+      ],
+      "tiers": [
+        "read",
+        "write"
+      ]
+    },
+    {
+      "name": "AgentOperators",
+      "file": "components/agent-operators.tsx",
+      "purpose": "Autonomous operators: summary, turn each on or off, trust dials per skill, findings, activity, health and scorecard (billable actions confirmed).",
+      "operations": [
+        "list_agent_operator_skills_agent_operators__operator__skills_get",
+        "list_agent_operator_activity_agent_operators__operator__activity_get",
+        "list_agent_operator_findings_agent_operators__operator__findings_get",
+        "get_agent_operators_summary_agent_operators_summary_get",
+        "list_agent_operators_agent_operators_get",
+        "set_agent_operator_enabled_agent_operators__operator__enabled_put",
+        "set_agent_operator_trust_dial_agent_operators__operator__skills__skill_key__put"
+      ],
+      "tiers": [
+        "read",
+        "billable"
+      ]
+    },
+    {
+      "name": "AssistantSessions",
+      "file": "components/assistant-sessions.tsx",
+      "purpose": "Sessions with the graph8 assistant: list, open, rename, pin, delete, add a note, and ask a live turn (billable, confirmed).",
+      "operations": [
+        "get_agent_session_state_agent_sessions__session_id__state_get",
+        "mark_agent_session_read_agent_sessions__session_id__read_put",
+        "list_agent_sessions_agent_sessions_get",
+        "create_agent_session_agent_sessions_post",
+        "rename_agent_session_agent_sessions__session_id__rename_post",
+        "pin_agent_session_agent_sessions__session_id__pin_post",
+        "delete_agent_session_agent_sessions__session_id__delete",
+        "post_agent_session_message_agent_sessions__session_id__messages_post",
+        "post_agent_chat_agent_chat_post"
+      ],
+      "tiers": [
+        "read",
+        "write",
+        "billable",
+        "destructive"
+      ]
     }
   ],
   "hooks": [],
@@ -176,6 +468,22 @@
     {
       "file": "lib/agent-types.ts",
       "purpose": "Response shapes (agent, persona, skill, run) and small readers for the enveloped and un-enveloped bodies voice and skills return."
+    },
+    {
+      "file": "lib/load-more.tsx",
+      "purpose": "Paging helpers (useLoadMoreList, useGrowingList, LoadMore) so no list stops silently at a cap."
+    },
+    {
+      "file": "lib/skill-utils.ts",
+      "purpose": "Skill shapes, form drafts and the changed-fields-only update body."
+    },
+    {
+      "file": "lib/knowledge-utils.ts",
+      "purpose": "Knowledge entry shapes and the body helpers for authoring."
+    },
+    {
+      "file": "lib/facts.tsx",
+      "purpose": "FactList: renders an open-shaped API object as labelled facts."
     }
   ],
   "recipes": [
@@ -217,6 +525,7 @@
   ],
   "scopes": [
     "knowledge:read",
+    "knowledge:write",
     "voice:delete",
     "voice:read",
     "voice:run",

package/blocks/agents/components/agent-activity.tsx

@@ -0,0 +1,112 @@
+"use client";
+
+/**
+ * AgentActivity: what an agent has done lately. A time window (7, 30, 90 days), the headline numbers (calls, skill runs,
+ * workflow runs, chats), how its skills performed (executions, success rate, speed, cost) and the latest rows of each kind.
+ * Every list says how many exist when it shows fewer, and "Show more" fetches a longer feed (up to the API's 200 per kind).
+ * All reads are free.
+ *
+ * SDK operations, in order:
+ *   1. getAgentActivity   GET /voice/agents/{agent_id}/activity?days&limit   (read)  calls, skill runs, workflow runs, chats + summary
+ *   2. getAgentSkillStats GET /voice/agents/{agent_id}/skill-stats?days      (read)  executions, success rate, duration, tokens, cost
+ */
+import { useState } from "react";
+import { Button, Skeleton } from "@graph8/sdk/ui";
+import { ApiError } from "@/g8/components/api-error";
+import { EmptyState } from "@/g8/components/empty-state";
+import { SectionCard } from "@/g8/components/screen/section-card";
+import { StatStrip } from "@/g8/components/screen/stat-strip";
+import { StatusPill, toneForStatus } from "@/g8/components/screen/status-pill";
+import { useG8Query } from "@/g8/hooks/use-g8-query";
+import { g8Get } from "@/g8/lib/g8-client";
+import { bodyOf } from "../lib/agent-types";
+
+export interface AgentActivityProps {
+  agentId: string;
+  className?: string;
+}
+
+interface Row { id?: string | number; execution_id?: string; [k: string]: unknown }
+interface Feed { calls?: Row[]; actions?: Row[]; workflows?: Row[]; chats?: Row[]; summary?: Record<string, number> }
+interface Stats { total_actions?: number; total_executions?: number; completed?: number; failed?: number; success_rate?: number; avg_duration_ms?: number; total_cost_usd?: number }
+
+const WINDOWS = [7, 30, 90];
+const LIMITS = [50, 100, 200];
+const when = (v: unknown): string => { const d = typeof v === "string" ? new Date(v) : null; return d && !Number.isNaN(d.getTime()) ? d.toLocaleString() : ""; };
+const ms = (v: unknown): string => (typeof v === "number" ? (v >= 1000 ? `${(v / 1000).toFixed(1)}s` : `${Math.round(v)}ms`) : "");
+const rowKey = (r: Row, i: number): string => String(r.execution_id ?? r.id ?? i);
+
+function Feeds({ title, rows, total, empty, children }: { title: string; rows: Row[]; total?: number; empty: string; children: (r: Row) => React.ReactNode }) {
+  return (
+    <SectionCard title={title} description={total != null && total > rows.length ? `Showing the latest ${rows.length} of ${total}` : undefined} flush>
+      {rows.length === 0 ? <p className="px-4 py-3 text-sm text-muted-foreground">{empty}</p> : (
+        <ul className="divide-y">{rows.map((r, i) => <li key={rowKey(r, i)} className="flex flex-wrap items-center justify-between gap-2 px-4 py-2 text-sm">{children(r)}</li>)}</ul>
+      )}
+    </SectionCard>
+  );
+}
+
+export function AgentActivity({ agentId, className }: AgentActivityProps) {
+  const [days, setDays] = useState(30);
+  const [limitIx, setLimitIx] = useState(0);
+  const limit = LIMITS[limitIx];
+  const feed = useG8Query((signal) => g8Get(`/voice/agents/${encodeURIComponent(agentId)}/activity`, { days, limit }, { signal }), [agentId, days, limit]);
+  const stats = useG8Query((signal) => g8Get(`/voice/agents/${encodeURIComponent(agentId)}/skill-stats`, { days }, { signal }), [agentId, days]);
+  const f = bodyOf<Feed>(feed.data);
+  const s = bodyOf<Stats>(stats.data);
+  const sum = f.summary ?? {};
+  const calls = f.calls ?? [], actions = f.actions ?? [], workflows = f.workflows ?? [], chats = f.chats ?? [];
+  const truncated = [[calls.length, sum.total_calls], [actions.length, sum.total_actions], [workflows.length, sum.total_workflows]].some(([n, t]) => t != null && (t as number) > (n as number)) && limitIx < LIMITS.length - 1;
+
+  return (
+    <div className={`flex flex-col gap-4 ${className ?? ""}`}>
+      <div role="group" aria-label="Time window" className="flex items-center gap-1">
+        {WINDOWS.map((d) => <Button key={d} size="sm" variant={days === d ? "default" : "outline"} onClick={() => { setDays(d); setLimitIx(0); }}>{d} days</Button>)}
+      </div>
+      {feed.error ? <ApiError error={feed.error} title="Could not load the activity" onRetry={() => void feed.refetch()} /> : null}
+      {feed.loading && !feed.data ? <Skeleton className="h-24 w-full" aria-label="Loading activity" /> : null}
+      {feed.data ? (
+        <>
+          <StatStrip items={[
+            { label: "Calls", value: String(sum.total_calls ?? calls.length), hint: `${sum.inbound_calls ?? 0} inbound, ${sum.outbound_calls ?? 0} outbound` },
+            { label: "Skill runs", value: String(sum.total_actions ?? actions.length), hint: `${sum.successful_actions ?? 0} succeeded, ${sum.failed_actions ?? 0} failed` },
+            { label: "Workflow runs", value: String(sum.total_workflows ?? workflows.length) },
+            { label: "Chats", value: String(sum.total_chats ?? chats.length) },
+          ]} />
+          <Feeds title="Calls" rows={calls} total={sum.total_calls} empty="No calls in this window.">
+            {(r) => <>
+              <span>{[r.first_name, r.last_name].filter(Boolean).join(" ") || String(r.to ?? r.from ?? "Call")}<span className="ml-2 text-xs text-muted-foreground">{String(r.call_type ?? "")} {ms(typeof r.call_duration === "number" ? r.call_duration * 1000 : undefined)}</span></span>
+              <span className="flex items-center gap-2">{r.disposition ? <StatusPill tone="neutral">{String(r.disposition)}</StatusPill> : null}{r.recording_url ? <a className="text-xs underline" href={String(r.recording_url)} target="_blank" rel="noreferrer">Recording</a> : null}<span className="text-xs text-muted-foreground">{when(r.created_at)}</span></span>
+            </>}
+          </Feeds>
+          <Feeds title="Skill runs" rows={actions} total={sum.total_actions} empty="No skill runs in this window.">
+            {(r) => <>
+              <span>{String(r.action_name ?? "Skill")}{r.error_message ? <span className="block text-xs text-error-foreground">{String(r.error_message)}</span> : null}</span>
+              <span className="flex items-center gap-2"><StatusPill tone={toneForStatus(String(r.status ?? ""))} dot>{String(r.status ?? "")}</StatusPill><span className="text-xs text-muted-foreground">{ms(r.duration_ms)} {when(r.created_at)}</span></span>
+            </>}
+          </Feeds>
+          <Feeds title="Workflow runs" rows={workflows} total={sum.total_workflows} empty="No workflow runs in this window.">
+            {(r) => <><span>{String(r.action_name ?? "Workflow")}</span><span className="flex items-center gap-2"><StatusPill tone={toneForStatus(String(r.status ?? ""))} dot>{String(r.status ?? "")}</StatusPill><span className="text-xs text-muted-foreground">{when(r.created_at)}</span></span></>}
+          </Feeds>
+          <Feeds title="Chats" rows={chats} empty="No chats in this window.">
+            {(r) => <><span>{String(r.name ?? "Chat")}</span><span className="text-xs text-muted-foreground">{String(r.message_count ?? 0)} messages, {when(r.updated_at ?? r.created_at)}</span></>}
+          </Feeds>
+          {truncated ? <Button size="sm" variant="outline" className="self-center" onClick={() => setLimitIx((i) => i + 1)}>Show more</Button> : null}
+          {!calls.length && !actions.length && !workflows.length && !chats.length ? <EmptyState compact title="No activity yet" description="Calls, skill runs and chats appear here once the agent is in use." /> : null}
+        </>
+      ) : null}
+      <SectionCard title="Skill performance" description={`Across every attached skill, last ${days} days`}>
+        {stats.error ? <ApiError error={stats.error} title="Could not load skill statistics" onRetry={() => void stats.refetch()} /> : null}
+        {stats.loading && !stats.data ? <Skeleton className="h-10 w-full" /> : null}
+        {stats.data ? (
+          <dl className="grid grid-cols-2 gap-3 text-sm sm:grid-cols-4" data-testid="skill-stats">
+            <div><dt className="text-xs text-muted-foreground">Executions</dt><dd>{s.total_executions ?? 0}</dd></div>
+            <div><dt className="text-xs text-muted-foreground">Success rate</dt><dd>{Math.round(s.success_rate ?? 0)}%</dd></div>
+            <div><dt className="text-xs text-muted-foreground">Average time</dt><dd>{ms(s.avg_duration_ms) || "n/a"}</dd></div>
+            <div><dt className="text-xs text-muted-foreground">Cost</dt><dd>${(s.total_cost_usd ?? 0).toFixed(2)}</dd></div>
+          </dl>
+        ) : null}
+      </SectionCard>
+    </div>
+  );
+}

package/blocks/agents/components/agent-approvals.tsx

@@ -0,0 +1,135 @@
+"use client";
+
+/**
+ * AgentApprovals: the approvals inbox for everything agents ask permission for. Three parts:
+ *   Oversight  what needs you now (approvals, blockers) and what agents fixed on their own.
+ *   Waiting    each pending approval with Approve (lets the agent act: external, ConfirmSpendDialog), Reject, or Request changes
+ *              (sends your feedback back instead of deciding).
+ *   History    decided approvals, filterable by decision, each with its signed receipts (who contributed what).
+ * Approvals that gate a Work coordination action cannot be decided with an API key; the error is shown as is.
+ *
+ * SDK operations, in order:
+ *   1. getAgentOversight           GET  /agent/oversight?limit=20                              (read)
+ *   2. listAgentApprovals          GET  /agent/approvals                                       (read)  pending
+ *   3. decideAgentApproval         POST /agent/approvals/{approval_id}/decide { decision }     (write; approving is confirmed as external)
+ *   4. requestAgentApprovalChanges POST /agent/approvals/{approval_id}/request-changes { feedback }   (write)
+ *   5. listAgentApprovalHistory    GET  /agent/approvals/history?decision                      (read)
+ *   6. getAgentApprovalReceipts    GET  /agent/approvals/{approval_id}/receipts                (read)
+ */
+import { useState } from "react";
+import { Button, Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, Skeleton, Textarea } from "@graph8/sdk/ui";
+import { ApiError } from "@/g8/components/api-error";
+import { ConfirmSpendDialog } from "@/g8/components/confirm-spend-dialog";
+import { EmptyState } from "@/g8/components/empty-state";
+import { SectionCard } from "@/g8/components/screen/section-card";
+import { StatusPill, toneForStatus } from "@/g8/components/screen/status-pill";
+import { useG8Mutation } from "@/g8/hooks/use-g8-mutation";
+import { useG8Query } from "@/g8/hooks/use-g8-query";
+import { g8Get, g8Post } from "@/g8/lib/g8-client";
+import { bodyOf, listOf } from "../lib/agent-types";
+
+export interface AgentApprovalsProps {
+  /** Open the run an approval belongs to. */
+  onOpenRun?: (runId: string) => void;
+  className?: string;
+}
+
+interface Approval { id: string; summary: string; risk_level: string; work_item_id: string; decision?: string | null; is_expired?: boolean; decided_at?: string | null; decided_by?: string | null; requested_at?: string | null }
+interface Receipt { id: string; action: string; entity_type: string; entity_id: string; contributed_by_user_id?: string | null; contributed_by_role_at_time?: string | null }
+// The only decision words the history filter accepts (agent_router.py).
+const DECISIONS: Array<[string, string]> = [["", "Any decision"], ["approve", "Approved"], ["reject", "Rejected"], ["edit_and_approve", "Edited and approved"], ["dismiss", "Dismissed"]];
+/** Rows per kind the oversight feed returns; a full kind means there may be more. */
+const OVERSIGHT_LIMIT = 20;
+const when = (v?: string | null): string => (v ? new Date(v).toLocaleString() : "");
+const enc = encodeURIComponent;
+
+function Receipts({ approvalId }: { approvalId: string }) {
+  const q = useG8Query((signal) => g8Get(`/agent/approvals/${enc(approvalId)}/receipts`, undefined, { signal }), [approvalId]);
+  const rows = bodyOf<{ receipts?: Receipt[] }>(q.data).receipts ?? [];
+  if (q.error) return <ApiError error={q.error} compact title="Could not load the receipts" onRetry={() => void q.refetch()} />;
+  if (q.loading && !q.data) return <Skeleton className="h-8 w-full" />;
+  if (rows.length === 0) return <p className="text-xs text-muted-foreground">No receipts were signed for this approval.</p>;
+  return <ul className="divide-y rounded-md border text-xs" aria-label="Receipts">{rows.map((r) => <li key={r.id} className="px-3 py-1.5">{r.action} on {r.entity_type} {r.entity_id}<span className="ml-2 text-muted-foreground">{r.contributed_by_user_id ?? "system"}{r.contributed_by_role_at_time ? `, ${r.contributed_by_role_at_time}` : ""}</span></li>)}</ul>;
+}
+
+export function AgentApprovals({ onOpenRun, className }: AgentApprovalsProps) {
+  const [decision, setDecision] = useState("");
+  const [approving, setApproving] = useState<Approval | null>(null);
+  const [changes, setChanges] = useState<{ approval: Approval; feedback: string } | null>(null);
+  const [showReceipts, setShowReceipts] = useState<string | null>(null);
+  const oversight = useG8Query((signal) => g8Get("/agent/oversight", { limit: OVERSIGHT_LIMIT }, { signal }), []);
+  const pending = useG8Query((signal) => g8Get("/agent/approvals", undefined, { signal }), []);
+  const history = useG8Query((signal) => g8Get("/agent/approvals/history", { decision: decision || undefined }, { signal }), [decision]);
+  const waiting = listOf<Approval>(pending.data).filter((a) => !a.decision && !a.is_expired);
+  const decided = listOf<Approval>(history.data);
+  const ov = bodyOf<{ approvals?: unknown[]; blockers?: Array<{ title?: string; summary?: string }>; autonomous_fixes?: Array<{ title?: string; summary?: string }> }>(oversight.data);
+  const refresh = () => { void pending.refetch(); void history.refetch(); void oversight.refetch(); };
+
+  const decide = useG8Mutation((v: { id: string; decision: "approve" | "reject" }) => g8Post(`/agent/approvals/${enc(v.id)}/decide`, { decision: v.decision }), { onSuccess: () => { setApproving(null); refresh(); }, onError: () => setApproving(null) });
+  const ask = useG8Mutation((v: { id: string; feedback: string }) => g8Post(`/agent/approvals/${enc(v.id)}/request-changes`, { feedback: v.feedback }), { onSuccess: () => { setChanges(null); refresh(); } });
+
+  return (
+    <div className={`flex flex-col gap-4 ${className ?? ""}`}>
+      <SectionCard title="Needs you" description="Approvals and blockers across all agents, and what agents fixed themselves">
+        {oversight.error ? <ApiError error={oversight.error} title="Could not load the oversight feed" onRetry={() => void oversight.refetch()} /> : null}
+        {oversight.loading && !oversight.data ? <Skeleton className="h-10 w-full" /> : null}
+        {oversight.data ? (
+          <dl className="grid grid-cols-3 gap-3 text-sm" data-testid="oversight">
+            <div><dt className="text-xs text-muted-foreground">Approvals</dt><dd>{(ov.approvals ?? []).length}</dd></div>
+            <div><dt className="text-xs text-muted-foreground">Blockers</dt><dd>{(ov.blockers ?? []).length}</dd></div>
+            <div><dt className="text-xs text-muted-foreground">Fixed on their own</dt><dd>{(ov.autonomous_fixes ?? []).length}</dd></div>
+          </dl>
+        ) : null}
+        {[ov.approvals, ov.blockers, ov.autonomous_fixes].some((l) => (l ?? []).length >= OVERSIGHT_LIMIT) ? <p className="mt-2 text-xs text-muted-foreground">Showing the first {OVERSIGHT_LIMIT} of each kind. Older items are in the history below.</p> : null}
+        {(ov.blockers ?? []).length ? <ul className="mt-3 list-disc pl-5 text-sm">{(ov.blockers ?? []).map((b, i) => <li key={i}>{b.title ?? b.summary}</li>)}</ul> : null}
+      </SectionCard>
+
+      <SectionCard title={`Waiting for a decision (${waiting.length})`} flush>
+        {pending.error ? <div className="p-3"><ApiError error={pending.error} title="Could not load the approvals" onRetry={() => void pending.refetch()} /></div> : null}
+        {pending.loading && !pending.data ? <Skeleton className="m-3 h-10" /> : null}
+        <ul className="divide-y">
+          {waiting.map((a) => (
+            <li key={a.id} data-testid={`approval-${a.id}`} className="flex flex-wrap items-center justify-between gap-2 px-4 py-2 text-sm">
+              <span>{a.summary}<span className="ml-2 text-xs text-muted-foreground">risk: {a.risk_level}</span>{onOpenRun ? <button type="button" className="ml-2 text-xs underline" onClick={() => onOpenRun(a.work_item_id)}>Open run</button> : null}</span>
+              <span className="flex gap-2">
+                <Button size="sm" variant="ghost" onClick={() => setChanges({ approval: a, feedback: "" })}>Request changes</Button>
+                <Button size="sm" variant="outline" disabled={decide.loading} onClick={() => void decide.mutate({ id: a.id, decision: "reject" })}>Reject</Button>
+                <Button size="sm" disabled={decide.loading} onClick={() => setApproving(a)}>Approve</Button>
+              </span>
+            </li>
+          ))}
+        </ul>
+        {!pending.loading && !pending.error && waiting.length === 0 ? <EmptyState compact title="Nothing is waiting" description="When an agent needs permission to act, it shows up here." /> : null}
+        {decide.error ? <div className="p-3"><ApiError error={decide.error} title="Could not record the decision" /></div> : null}
+      </SectionCard>
+
+      <SectionCard title="History" flush actions={<select aria-label="Decision" className="h-8 rounded-md border bg-background px-2 text-sm" value={decision} onChange={(e) => setDecision(e.target.value)}>{DECISIONS.map(([v, l]) => <option key={v} value={v}>{l}</option>)}</select>}>
+        {history.error ? <div className="p-3"><ApiError error={history.error} title="Could not load the history" onRetry={() => void history.refetch()} /></div> : null}
+        {history.loading && !history.data ? <Skeleton className="m-3 h-10" /> : null}
+        <ul className="divide-y">
+          {decided.map((a) => (
+            <li key={a.id} className="px-4 py-2 text-sm">
+              <div className="flex flex-wrap items-center justify-between gap-2">
+                <span>{a.summary}</span>
+                <span className="flex items-center gap-2"><StatusPill tone={toneForStatus(a.decision ?? "")} dot>{a.decision ?? "undecided"}</StatusPill><span className="text-xs text-muted-foreground">{when(a.decided_at ?? a.requested_at)}</span><Button size="sm" variant="ghost" aria-expanded={showReceipts === a.id} onClick={() => setShowReceipts(showReceipts === a.id ? null : a.id)}>Receipts</Button></span>
+              </div>
+              {showReceipts === a.id ? <div className="mt-2"><Receipts approvalId={a.id} /></div> : null}
+            </li>
+          ))}
+        </ul>
+        {!history.loading && !history.error && decided.length === 0 ? <EmptyState compact title="No decisions yet" /> : null}
+      </SectionCard>
+
+      <Dialog open={changes != null} onOpenChange={(o) => !o && setChanges(null)}>
+        <DialogContent>
+          <DialogHeader><DialogTitle>Request changes</DialogTitle><DialogDescription>{changes?.approval.summary}</DialogDescription></DialogHeader>
+          <Textarea aria-label="Feedback" rows={4} placeholder="What should the agent change?" value={changes?.feedback ?? ""} onChange={(e) => setChanges((c) => c && { ...c, feedback: e.target.value })} />
+          {ask.error ? <ApiError error={ask.error} title="Could not send the feedback" /> : null}
+          <DialogFooter><Button variant="ghost" onClick={() => setChanges(null)}>Cancel</Button><Button loading={ask.loading} disabled={!changes?.feedback.trim()} onClick={() => changes && void ask.mutate({ id: changes.approval.id, feedback: changes.feedback.trim() })}>Send feedback</Button></DialogFooter>
+        </DialogContent>
+      </Dialog>
+      <ConfirmSpendDialog open={approving != null} tier="external" title="Approve this action" description={approving?.summary}
+        confirmLabel="Approve" confirming={decide.loading} onConfirm={() => approving && void decide.mutate({ id: approving.id, decision: "approve" })} onCancel={() => setApproving(null)} />
+    </div>
+  );
+}