create-safest-tools 0.6.1 → 0.7.0

package/template/console/appeals/controller.ts

@@ -1,4 +1,4 @@
-import { errorMessage, requestJson } from "../lib/http";
+import { ApiRequestError, errorMessage, requestJson } from "../lib/http";
 import { dispatchReportRefresh } from "../reports/events";
 import { getShellSnapshot, subscribeToShell } from "../shell/store";
 import { appealEvents } from "./events";
@@ -19,7 +19,11 @@ const initialSnapshot = (): AppealWorkspaceSnapshot => ({
 });
 
 let actorId = "";
+let accessSignature = "";
 let started = false;
+let listVersion = 0;
+let detailVersion = 0;
+let decisionRetry: {appealId:string;actorId:string;key:string} | null = null;
 
 function permissions(snapshot: AppealWorkspaceSnapshot): AppealWorkspaceSnapshot {
   const session = getShellSnapshot().session;
@@ -27,6 +31,7 @@ function permissions(snapshot: AppealWorkspaceSnapshot): AppealWorkspaceSnapshot
 }
 
 async function loadAppeals(): Promise<void> {
+  const version = ++listVersion;
   const session = getShellSnapshot().session;
   if (!session?.permissions.reviewAppeals) {
     setAppealWorkspaceSnapshot(permissions({ ...initialSnapshot(), loading: false }));
@@ -36,26 +41,39 @@ async function loadAppeals(): Promise<void> {
   setAppealWorkspaceSnapshot(permissions({ ...current, error: "", refreshing: !current.loading }));
   try {
     const result = await requestJson<AppealListResponse>("/v1/admin/appeals?limit=100");
+    if (version !== listVersion || session.actor.id !== getShellSnapshot().session?.actor.id) return;
     setAppealWorkspaceSnapshot((snapshot) => {
       const appeals = result.appeals || [];
       const selected = snapshot.detail.appealId ? appeals.find((appeal) => appeal.id === snapshot.detail.appealId) || null : null;
-      return permissions({ ...snapshot, appeals, detail: selected ? { ...snapshot.detail, appeal: selected } : snapshot.detail });
+      return permissions({ ...snapshot, appeals, detail: selected ? { ...snapshot.detail, appeal: {...snapshot.detail.appeal,...selected} } : snapshot.detail });
     });
   } catch (cause) {
-    setAppealWorkspaceSnapshot((snapshot) => ({ ...snapshot, error: errorMessage(cause, "Appeals could not be loaded.") }));
+    if (version === listVersion) setAppealWorkspaceSnapshot((snapshot) => ({ ...snapshot, error: errorMessage(cause, "Appeals could not be loaded.") }));
   } finally {
-    setAppealWorkspaceSnapshot((snapshot) => permissions({ ...snapshot, loading: false, refreshing: false }));
+    if (version === listVersion) setAppealWorkspaceSnapshot((snapshot) => permissions({ ...snapshot, loading: false, refreshing: false }));
   }
 }
 
-function openAppeal(appealId: string): void {
+async function openAppeal(appealId: string, refresh = false): Promise<void> {
+  const current=getAppealWorkspaceSnapshot();
+  if (!current.canReview) return;
+  if (current.detail.appealId && current.detail.appealId !== appealId && !window.dispatchEvent(new Event(appealEvents.beforeClose,{cancelable:true}))) return;
+  const version=++detailVersion;
   setAppealWorkspaceSnapshot((snapshot) => {
     const appeal = snapshot.appeals.find((candidate) => candidate.id === appealId) || null;
-    return appeal ? permissions({ ...snapshot, detail: { appealId, appeal, error: "", pendingAction: null } }) : snapshot;
+    return refresh ? snapshot : permissions({ ...snapshot, detail: { appealId, appeal: snapshot.detail.appealId===appealId?snapshot.detail.appeal:appeal, error: "", pendingAction: null } });
   });
+  try {
+    const result = await requestJson<{ appeal: AppealRecord }>(`/v1/admin/appeals/${encodeURIComponent(appealId)}`);
+    if(version===detailVersion) setAppealWorkspaceSnapshot((snapshot) => snapshot.detail.appealId === appealId ? { ...snapshot, detail: { ...snapshot.detail, appeal: result.appeal } } : snapshot);
+  } catch (cause) {
+    if(version===detailVersion) setAppealWorkspaceSnapshot((snapshot) => snapshot.detail.appealId === appealId ? { ...snapshot, detail: { ...snapshot.detail, ...(cause instanceof ApiRequestError && [401,403,404].includes(cause.status)?{appeal:null}:{}), error: errorMessage(cause, "Appeal details could not be loaded.") } } : snapshot);
+  }
 }
 
-function closeAppeal(): void {
+function closeAppeal(committed = false): void {
+  if (!committed && !window.dispatchEvent(new Event(appealEvents.beforeClose,{cancelable:true}))) return;
+  detailVersion++;
   setAppealWorkspaceSnapshot((snapshot) => permissions({ ...snapshot, detail: { appealId: null, appeal: null, error: "", pendingAction: null } }));
 }
 
@@ -67,6 +85,7 @@ async function claimAppeal(): Promise<void> {
   try {
     await requestJson(`/v1/admin/appeals/${encodeURIComponent(appeal.id)}/claim`, { method: "POST" });
     await loadAppeals();
+    await openAppeal(appeal.id);
   } catch (cause) {
     setAppealWorkspaceSnapshot((current) => ({ ...current, detail: { ...current.detail, error: errorMessage(cause, "The appeal could not be claimed.") } }));
   } finally {
@@ -78,8 +97,9 @@ async function recordDecision(input: AppealDecisionInput): Promise<void> {
   const snapshot = getAppealWorkspaceSnapshot();
   const appeal = snapshot.detail.appeal;
   const activeClaim = Boolean(appeal && appeal.reviewerId === snapshot.actorId && appeal.claimExpiresAt && Date.parse(appeal.claimExpiresAt) > Date.now());
-  if (!appeal || !snapshot.canReview || snapshot.detail.pendingAction || !activeClaim) return;
-  const idempotencyKey = crypto.randomUUID();
+  if (!appeal || !getShellSnapshot().session?.permissions.decideAppeals || snapshot.detail.pendingAction || !activeClaim) return;
+  if (!decisionRetry || decisionRetry.appealId!==appeal.id || decisionRetry.actorId!==snapshot.actorId) decisionRetry={appealId:appeal.id,actorId:snapshot.actorId,key:crypto.randomUUID()};
+  const idempotencyKey = decisionRetry.key;
   setAppealWorkspaceSnapshot({ ...snapshot, detail: { ...snapshot.detail, error: "", pendingAction: "decision" } });
   try {
     await requestJson(`/v1/admin/appeals/${encodeURIComponent(appeal.id)}/decision`, {
@@ -87,10 +107,13 @@ async function recordDecision(input: AppealDecisionInput): Promise<void> {
       headers: { "content-type": "application/json", "idempotency-key": idempotencyKey },
       body: JSON.stringify({ idempotency_key: idempotencyKey, outcome: input.outcome, rationale: input.rationale, participant_notice: input.participantNotice }),
     });
-    closeAppeal();
+    decisionRetry=null;
+    if (getAppealWorkspaceSnapshot().detail.appealId!==appeal.id || getShellSnapshot().session?.actor.id!==snapshot.actorId) return;
+    closeAppeal(true);
     await loadAppeals();
     dispatchReportRefresh();
   } catch (cause) {
+    if (cause instanceof ApiRequestError && cause.status>=400 && cause.status<500) decisionRetry=null;
     setAppealWorkspaceSnapshot((current) => ({ ...current, detail: { ...current.detail, error: errorMessage(cause, "The appeal decision could not be recorded.") } }));
   } finally {
     setAppealWorkspaceSnapshot((current) => permissions({ ...current, detail: { ...current.detail, pendingAction: null } }));
@@ -103,19 +126,22 @@ export function startAppealController(): void {
   subscribeToShell(() => {
     const session = getShellSnapshot().session;
     const nextActorId = session?.actor.id || "";
-    if (nextActorId === actorId) {
+    const nextAccessSignature = JSON.stringify({permissions:session?.permissions,queueScope:session?.queueScope});
+    if (nextActorId === actorId && nextAccessSignature === accessSignature) {
       setAppealWorkspaceSnapshot((snapshot) => permissions(snapshot));
       return;
     }
     actorId = nextActorId;
+    accessSignature = nextAccessSignature;
+    listVersion++; detailVersion++; decisionRetry=null;
     setAppealWorkspaceSnapshot(initialSnapshot());
     if (session) void loadAppeals();
   });
-  window.addEventListener(appealEvents.refresh, () => { void loadAppeals(); });
+  window.addEventListener(appealEvents.refresh, () => { void loadAppeals(); const id=getAppealWorkspaceSnapshot().detail.appealId; if(id)void openAppeal(id,true); });
   window.addEventListener(appealEvents.open, (event) => {
-    if (event instanceof CustomEvent && typeof event.detail?.appealId === "string") openAppeal(event.detail.appealId);
+    if (event instanceof CustomEvent && typeof event.detail?.appealId === "string") void openAppeal(event.detail.appealId);
   });
-  window.addEventListener(appealEvents.close, closeAppeal);
+  window.addEventListener(appealEvents.close, () => closeAppeal());
   window.addEventListener(appealEvents.claim, () => { void claimAppeal(); });
   window.addEventListener(appealEvents.decision, (event) => {
     if (!(event instanceof CustomEvent) || !event.detail || !["upheld", "modified", "reversed"].includes(event.detail.outcome)) return;

package/template/console/appeals/events.ts

@@ -5,6 +5,7 @@ export const appealEvents = {
   refresh: "safest:appeals:refresh",
   open: "safest:appeals:open",
   close: "safest:appeals:close",
+  beforeClose: "safest:appeals:before-close",
   claim: "safest:appeals:claim",
   decision: "safest:appeals:decision",
 } as const;

package/template/console/appeals/types.ts

@@ -3,6 +3,12 @@ export type AppealPendingAction = "claim" | "decision" | null;
 
 export interface AppealRecord {
   id: string;
+  reportId?: string;
+  originalDecisionCode?: string;
+  originalPolicyCode?: string;
+  originalRationale?: string;
+  originalMakerId?: string;
+  decisions?: Array<{ id: string; outcome: string; rationale: string; reviewerId: string; completionState: string; correctionRequired: number; correctionReference: string | null; correctionNote: string | null; correctionConfirmedAt: string | null; correctionConfirmedBy: string | null; noticeState: string | null }>;
   reportReference: string;
   appellantAudience: string;
   submittedAt: string;

package/template/console/appeals/useAppealDraftGuard.ts

@@ -0,0 +1,12 @@
+import { useEffect } from "react";
+import { appealEvents } from "./events";
+
+export function useAppealDraftGuard(open:boolean,dirty:boolean,pending:boolean) {
+  useEffect(()=>{
+    if(!open)return;
+    const close=(event:Event)=>{if(pending || (dirty&&!window.confirm("Discard your unsent appeal changes?")))event.preventDefault();};
+    const unload=(event:BeforeUnloadEvent)=>{if(dirty||pending){event.preventDefault();event.returnValue="";}};
+    window.addEventListener(appealEvents.beforeClose,close); window.addEventListener("beforeunload",unload);
+    return()=>{window.removeEventListener(appealEvents.beforeClose,close);window.removeEventListener("beforeunload",unload);};
+  },[open,dirty,pending]);
+}

package/template/console/assistant/AssistantWorkspace.tsx

@@ -1,7 +1,7 @@
 import { useEffect, useRef, useState, useSyncExternalStore, type FormEvent, type KeyboardEvent } from "react";
 import { PageHeader } from "../components/PageHeader";
 import { relativeTime } from "../lib/format";
-import { errorMessage, mutationHeaders, requestJson } from "../lib/http";
+import { ApiRequestError, errorMessage, mutationHeaders, requestJson } from "../lib/http";
 import { dispatchOpenReport } from "../reports/events";
 import { dispatchNavigation } from "../shell/events";
 import { getShellSnapshot, subscribeToShell } from "../shell/store";
@@ -9,7 +9,7 @@ import type { AssistantHistory, AssistantMessage, AssistantSessionResponse } fro
 
 const prompts = [
   "How many phishing reports were resolved yesterday?",
-  "List unresolved workflow failures and show their current state.",
+  "Find spam",
 ] as const;
 const roleNames: Record<string, string> = { reviewer: "Analyst", appeal_reviewer: "Appeal analyst", administrator: "Administrator", owner: "Infrastructure owner", auditor: "Auditor" };
 const readable = (value: string): string => value.replaceAll("_", " ").replace(/^./u, (letter) => letter.toUpperCase());
@@ -28,14 +28,33 @@ export function AssistantWorkspace() {
   const [error, setError] = useState("");
   const inputRef = useRef<HTMLTextAreaElement>(null);
   const messagesRef = useRef<HTMLDivElement>(null);
+  const sendingRef = useRef(false);
   const canUse = shell.session?.permissions.useAssistant === true;
 
   useEffect(() => {
+    let current = true;
     setSessionId("");
     setHistory(null);
     setDraft("");
     setError("");
-  }, [shell.session?.actor.id]);
+    setPending("");
+    const actor = shell.session?.actor.id;
+    if (!actor || !canUse) return;
+    const key = `safest-assistant:${actor}`;
+    let saved = "";
+    try { saved = sessionStorage.getItem(key) || ""; } catch { /* Browser storage may be disabled. */ }
+    if (!saved) return;
+    setPending("new");
+    void requestJson<AssistantHistory>(`/v1/admin/assistant/sessions/${encodeURIComponent(saved)}`).then((result) => {
+      if (current) { setSessionId(saved); setHistory(result); }
+    }).catch((cause) => {
+      if (!current) return;
+      if (cause instanceof ApiRequestError && [404, 409].includes(cause.status)) {
+        try { sessionStorage.removeItem(key); } catch { /* Storage is optional. */ }
+      } else setError(errorMessage(cause, "Your conversation could not be restored. Refresh to try again."));
+    }).finally(() => { if (current) setPending(""); });
+    return () => { current = false; };
+  }, [shell.session?.actor.id, canUse]);
 
   useEffect(() => {
     const focus = (): void => { requestAnimationFrame(() => inputRef.current?.focus()); };
@@ -55,6 +74,7 @@ export function AssistantWorkspace() {
     try {
       const result = await requestJson<AssistantSessionResponse>("/v1/admin/assistant/sessions", { method: "POST", headers: mutationHeaders(false) });
       setSessionId(result.sessionId);
+      try { sessionStorage.setItem(`safest-assistant:${shell.session?.actor.id}`, result.sessionId); } catch { /* Conversation remains usable without browser storage. */ }
       setHistory({ session: { id: result.sessionId, timezone: result.timezone, expiresAt: result.expiresAt }, messages: [], toolCalls: [] });
       setDraft("");
       requestAnimationFrame(() => inputRef.current?.focus());
@@ -70,10 +90,11 @@ export function AssistantWorkspace() {
   const send = async (event: FormEvent<HTMLFormElement>): Promise<void> => {
     event.preventDefault();
     const body = draft.trim();
-    if (!body || !canUse) return;
+    if (!body || !canUse || sendingRef.current || pending) return;
+    sendingRef.current = true;
     let activeSessionId = sessionId;
     if (!activeSessionId) activeSessionId = await createConversation() ?? "";
-    if (!activeSessionId) return;
+    if (!activeSessionId) { sendingRef.current = false; return; }
     const optimistic: AssistantMessage = { id: crypto.randomUUID(), role: "user", body, citations: [], createdAt: new Date().toISOString() };
     setDraft("");
     setPending("send");
@@ -91,6 +112,7 @@ export function AssistantWorkspace() {
       setDraft(body);
       setError(errorMessage(cause, "Safest could not answer that question."));
     } finally {
+      sendingRef.current = false;
       setPending("");
     }
   };
@@ -103,6 +125,7 @@ export function AssistantWorkspace() {
   const onComposerKeyDown = (event: KeyboardEvent<HTMLTextAreaElement>): void => {
     if (event.key === "Enter" && !event.shiftKey) {
       event.preventDefault();
+      if (sendingRef.current || pending) return;
       event.currentTarget.form?.requestSubmit();
     }
   };

package/template/console/command/CommandCentre.tsx

@@ -1,6 +1,7 @@
 import { useSyncExternalStore } from "react";
 import { PageHeader } from "../components/PageHeader";
-import { dispatchOpenReport } from "../reports/events";
+import { CaseEscalations } from '../operations/CaseEscalations';
+import { dispatchOpenReport, dispatchReportFilters } from "../reports/events";
 import { dispatchNavigation } from "../shell/events";
 import { compactDuration } from "./presentation";
 import { getCommandSnapshot, subscribeToCommand } from "./store";
@@ -27,6 +28,10 @@ function EmptyReviewQueue() {
 }
 
 function Metrics({ metrics, loading }: { metrics: CommandMetricSnapshot; loading: boolean }) {
+  const openSummary = (label: string): void => {
+    dispatchReportFilters({ search: "", queueId: "", priority: label === "Urgent" ? "urgent" : "", age: "", state: "needs_review", sort: "priority", ownership: label === "Unassigned" ? "unassigned" : "" });
+    dispatchNavigation("reports");
+  };
   const values: Array<{ label: string; value: number; detail: string; tone: CommandStatusTone }> = [
     { label: "To review", value: metrics.awaitingReview, detail: "Ready for a decision", tone: metrics.awaitingReview ? "warning" : "positive" },
     { label: "Urgent", value: metrics.urgent, detail: "Highest priority", tone: metrics.urgent ? "danger" : "positive" },
@@ -36,7 +41,7 @@ function Metrics({ metrics, loading }: { metrics: CommandMetricSnapshot; loading
   return (
     <section className="command-signals" aria-label="Live review summary" aria-busy={loading}>
       {values.map((item) => (
-        <button className={`command-signal ${item.tone}`} type="button" key={item.label} onClick={() => dispatchNavigation("reports")}>
+        item.label === "Reviewers online" ? <article className={`command-signal ${item.tone}`} key={item.label}><span>{item.label}</span><strong>{loading ? "—" : item.value}</strong><small>{item.detail}</small></article> : <button className={`command-signal ${item.tone}`} type="button" key={item.label} onClick={() => openSummary(item.label)}>
           <span>{item.label}</span><strong>{loading ? "—" : item.value}</strong><small>{item.detail}</small>
         </button>
       ))}
@@ -94,15 +99,15 @@ export function CommandCentre() {
   const summary = snapshot.loading
     ? "Loading the live review queue."
     : reviewCount
-      ? `${reviewCount} report${reviewCount === 1 ? "" : "s"} awaiting review · oldest waiting ${compactDuration(snapshot.metrics.oldestWaitMinutes)}.`
+      ? `${reviewCount} case${reviewCount === 1 ? "" : "s"} awaiting review · oldest waiting ${compactDuration(snapshot.metrics.oldestWaitMinutes)}.`
       : "The review queue is clear. New work will appear here automatically.";
-  const nextReport = snapshot.attention[0];
+  const nextReport = snapshot.nextReview;
 
   return (
     <div data-react-slice="command-centre">
-      <PageHeader className="command-head" title="Command centre" description={summary}>
+      <PageHeader className="command-head" title="Today" description={summary}>
         <div className="surface-buttons command-actions">
-          {nextReport ? <button className="primary" type="button" onClick={() => performAction(nextReport.action)}><svg aria-hidden="true"><use href="#i-inbox" /></svg>Review next</button> : null}
+          {nextReport ? <button className="primary" type="button" onClick={() => dispatchOpenReport(nextReport.reportId, true)}><svg aria-hidden="true"><use href="#i-inbox" /></svg>{nextReport.mine ? "Continue review" : "Review next"}</button> : null}
           {snapshot.permissions.useAssistant ? <button className="secondary command-assistant-action" type="button" onClick={() => dispatchNavigation("assistant")}><svg aria-hidden="true"><use href="#i-spark" /></svg>Ask Safest</button> : null}
         </div>
       </PageHeader>
@@ -112,6 +117,7 @@ export function CommandCentre() {
       ) : null}
 
       <Metrics metrics={snapshot.metrics} loading={snapshot.loading} />
+      <CaseEscalations compact />
 
       <div className="command-workspace-grid">
         <section className="surface command-panel review-priority-panel">

package/template/console/command/controller.ts

@@ -1,3 +1,4 @@
+import { loadInbox } from "../reports/load-inbox";
 import { requestJson } from "../lib/http";
 import { readable, relativeTime } from "../lib/format";
 import { getOperationsWorkspaceSnapshot, subscribeToOperationsWorkspace } from "../operations/store";
@@ -19,7 +20,7 @@ interface CommandReport {
   state: string;
   priority: number;
   receivedAt: string;
-  claim?: { reviewerId?: string } | null;
+  assignment?: { reviewerId?: string; analyst?: { displayName?: string } } | null;
 }
 
 interface WorkflowRun {
@@ -34,7 +35,6 @@ interface WorkflowRun {
   createdAt: string;
 }
 
-interface ReportsResponse { reports?: CommandReport[] }
 interface QueuesResponse { queues?: QueueRecord[] }
 interface WorkflowRunsResponse { runs?: WorkflowRun[] }
 
@@ -55,7 +55,7 @@ let refreshScheduled = false;
 let started = false;
 
 function reportDataSignature(): string {
-  return reports.map((report) => `${report.id}:${report.state}:${report.priority}:${report.claim?.reviewerId || ""}`).sort().join("|");
+  return reports.map((report) => `${report.id}:${report.state}:${report.priority}:${report.assignment?.reviewerId || ""}`).sort().join("|");
 }
 
 function reportStoreSignature(): string {
@@ -112,7 +112,7 @@ function buildSnapshot(): CommandSnapshot {
     const rightBreached = slaStatus(reportAgeMinutes(right), rightTarget).breached;
     if (leftBreached !== rightBreached) return leftBreached ? -1 : 1;
     if (left.priority !== right.priority) return right.priority - left.priority;
-    if (Boolean(left.claim) !== Boolean(right.claim)) return left.claim ? 1 : -1;
+    if (Boolean(left.assignment) !== Boolean(right.assignment)) return left.assignment ? 1 : -1;
     return Date.parse(left.receivedAt) - Date.parse(right.receivedAt);
   });
 
@@ -125,7 +125,7 @@ function buildSnapshot(): CommandSnapshot {
       reference: report.reference,
       queueName: queue?.name || "Unrouted",
       age: relativeTime(report.receivedAt),
-      ownership: report.claim ? "Assigned" : "Unassigned",
+      ownership: report.assignment ? (report.assignment.reviewerId === actorId ? "Assigned to you" : `Assigned to ${report.assignment.analyst?.displayName || "another reviewer"}`) : "Unassigned",
       priorityLabel: priorityLabel(report.priority),
       slaLabel: sla.label,
       tone: report.priority >= 80 ? "danger" : sla.tone,
@@ -145,7 +145,7 @@ function buildSnapshot(): CommandSnapshot {
       name: queue.name,
       targetMinutes,
       openCount: queuedReports.length,
-      unassignedCount: queuedReports.filter((report) => !report.claim).length,
+      unassignedCount: queuedReports.filter((report) => !report.assignment).length,
       oldestMinutes,
       breachedCount,
       pressure,
@@ -155,7 +155,7 @@ function buildSnapshot(): CommandSnapshot {
 
   const optionalSetup = new Set(setup?.optional || []);
   const incompleteSetupCount = setup?.features.filter((feature) => feature.state !== "ready" && !optionalSetup.has(feature.featureKey)).length || 0;
-  const unassigned = needsHuman.filter((report) => !report.claim).length;
+  const unassigned = needsHuman.filter((report) => !report.assignment).length;
   const urgent = needsHuman.filter((report) => report.priority >= 80).length;
   const oldestWaitMinutes = needsHuman.length ? Math.max(...needsHuman.map(reportAgeMinutes)) : 0;
   const systemIssueCount = Number(incidentCount > 0) + Number(workflowIssueCount > 0) + Number(deliveryFailureCount > 0);
@@ -170,6 +170,10 @@ function buildSnapshot(): CommandSnapshot {
       oldestWaitMinutes,
     },
     attention,
+    nextReview: session?.permissions.claimReports ? (() => {
+      const next = sortedAttention.find(report => report.assignment?.reviewerId === actorId) || sortedAttention.find(report => !report.assignment);
+      return next ? { reportId: next.id, mine: next.assignment?.reviewerId === actorId } : null;
+    })() : null,
     queueLoads,
     systemHealth: {
       issueCount: systemIssueCount,
@@ -201,8 +205,8 @@ async function loadCommandData(): Promise<void> {
   loading = true;
   publish();
   const tasks: Promise<void>[] = [
-    requestJson<ReportsResponse>("/v1/admin/reports?limit=100")
-      .then((response) => { reports = response.reports || []; })
+    loadInbox<CommandReport>()
+      .then((response) => { reports = response; })
       .catch(() => { reports = []; }),
     requestJson<QueuesResponse>(`/v1/admin/queues${session.permissions.manageConfiguration ? "?include_archived=true" : ""}`)
       .then((response) => { queues = response.queues || []; })

package/template/console/command/presentation.ts

@@ -1,4 +1,5 @@
 import type { CommandStatusTone } from "./types";
+export { priorityLabel } from "../lib/priority";
 
 export function compactDuration(minutes: number): string {
   const rounded = Math.max(0, Math.floor(minutes));
@@ -9,12 +10,6 @@ export function compactDuration(minutes: number): string {
   return `${Math.floor(hours / 24)}d`;
 }
 
-export function priorityLabel(priority: number): string {
-  if (priority >= 80) return "Urgent";
-  if (priority >= 60) return "High";
-  return "Standard";
-}
-
 export function slaStatus(ageMinutes: number, targetMinutes: number | null): {
   label: string;
   tone: CommandStatusTone;

package/template/console/command/store.ts

@@ -8,6 +8,7 @@ let snapshot: CommandSnapshot = {
   generatedAt: new Date().toISOString(),
   metrics: { awaitingReview: 0, urgent: 0, unassigned: 0, onlineReviewers: 0, oldestWaitMinutes: 0 },
   attention: [],
+  nextReview: null,
   queueLoads: [],
   systemHealth: { issueCount: 0, incidentCount: 0, workflowIssueCount: 0, deliveryFailureCount: 0, activeRunCount: 0 },
   incompleteSetupCount: 0,

package/template/console/command/types.ts

@@ -54,6 +54,7 @@ export interface CommandPermissions {
 }
 
 export interface CommandSnapshot {
+  nextReview: { reportId: string; mine: boolean } | null;
   loading: boolean;
   generatedAt: string;
   metrics: CommandMetricSnapshot;

package/template/console/configuration/ConfigurationBuilders.tsx

@@ -0,0 +1,101 @@
+import type { JsonObject, JsonValue, QueueSummary } from "./types";
+
+interface BuilderProps { value: JsonObject; onChange: (value: JsonObject) => void; disabled: boolean }
+const objects = (value: JsonValue | undefined): JsonObject[] => Array.isArray(value) ? value.filter((item): item is JsonObject => Boolean(item) && typeof item === "object" && !Array.isArray(item)) : [];
+const string = (value: JsonValue | undefined): string => value == null ? "" : String(value);
+
+function QueueChoice({ label, help, value, queues, onChange, disabled, humanOnly = false }: {
+  label: string; help: string; value: string; queues: QueueSummary[]; onChange: (value: string) => void; disabled: boolean; humanOnly?: boolean;
+}) {
+  const choices = queues.filter(queue => queue.id === value || queue.status === "active" && (!humanOnly || queue.activePolicy?.managementMode === "human"));
+  return <label>{label}<small>{help}</small><select aria-label={label} required disabled={disabled} value={value} onChange={event => onChange(event.currentTarget.value)}>
+    <option value="" disabled>Choose a queue</option>
+    {value && !choices.some(queue => queue.id === value) ? <option value={value}>{value} · unavailable</option> : null}
+    {choices.map(queue => <option value={queue.id} key={queue.id}>{queue.name}{queue.status === "active" ? "" : ` · ${queue.status}`}</option>)}
+  </select></label>;
+}
+
+const fields = [["reason_code", "Report reason"], ["source", "Report source"], ["target_type", "Content type"], ["priority", "Case priority"], ["safeguard.requires_human", "Human review required"]];
+const operators = [["eq", "is"], ["neq", "is not"], ["in", "is one of"], ["not_in", "is not one of"], ["contains", "contains"], ["exists", "has a value"], ["gt", "is greater than"], ["gte", "is at least"], ["lt", "is less than"], ["lte", "is at most"]];
+
+function Condition({ value, onChange, onRemove, disabled, index }: { value: JsonObject; onChange: (value: JsonObject) => void; onRemove: () => void; disabled: boolean; index: number }) {
+  const field = string(value.field), operator = string(value.operator);
+  const list = operator === "in" || operator === "not_in";
+  const numeric = typeof value.value === "number" || Array.isArray(value.value) && value.value.some(item => typeof item === "number") || field === "priority" || ["gt", "gte", "lt", "lte"].includes(operator);
+  const boolean = typeof value.value === "boolean" || Array.isArray(value.value) && value.value.some(item => typeof item === "boolean") || field === "safeguard.requires_human";
+  const changeOperator = (next: string) => {
+    const { value: previous, ...rest } = value;
+    const initial = boolean ? true : numeric ? 0 : "";
+    onChange(next === "exists" ? { ...rest, operator: next } : { ...rest, operator: next, value: next === "in" || next === "not_in" ? Array.isArray(previous) ? previous : [previous ?? initial] : Array.isArray(previous) ? previous[0] ?? initial : previous ?? initial });
+  };
+  return <div className="routing-condition" role="group" aria-label={`Condition ${index + 1}`}>
+    <label>Field<select aria-label={`Condition ${index + 1} field`} value={fields.some(([key]) => key === field) ? field : "custom"} disabled={disabled} onChange={event => {
+      const next = event.currentTarget.value;
+      const initial = next === "priority" ? 0 : next === "safeguard.requires_human" ? true : "";
+      onChange({ ...value, field: next === "custom" ? "answer.details" : next, ...(operator === "exists" ? {} : { value: list ? [initial] : initial }) });
+    }}>{fields.map(([key, label]) => <option value={key} key={key}>{label}</option>)}<option value="custom">Answer, trusted fact, or enrichment</option></select></label>
+    {!fields.some(([key]) => key === field) ? <label>Field name<input aria-label={`Condition ${index + 1} field name`} value={field} disabled={disabled} required onChange={event => onChange({ ...value, field: event.currentTarget.value })} /></label> : null}
+    <label>Comparison<select aria-label={`Condition ${index + 1} comparison`} value={operator} disabled={disabled} onChange={event => changeOperator(event.currentTarget.value)}>{operators.map(([key, label]) => <option key={key} value={key}>{label}</option>)}</select></label>
+    {operator === "exists" ? null : boolean ? <label>{list ? "Values" : "Value"}<select required aria-label={`Condition ${index + 1} value`} value={list ? [true, false].filter(item => Array.isArray(value.value) && value.value.includes(item)).join(",") : String(value.value)} disabled={disabled} onChange={event => onChange({ ...value, value: list ? event.currentTarget.value.split(",").map(item => item === "true") : event.currentTarget.value === "true" })}><option value="" disabled>Choose a value</option><option value="true">Yes</option><option value="false">No</option>{list ? <option value="true,false">Yes or no</option> : null}</select></label> : <label>{list ? "Values, separated by commas" : "Value"}<input aria-label={`Condition ${index + 1} value`} type={numeric && !list ? "number" : "text"} step="any" pattern={numeric && list ? "-?\\d+(?:\\.\\d+)?(?:\\s*,\\s*-?\\d+(?:\\.\\d+)?)*" : undefined} disabled={disabled} required value={Array.isArray(value.value) ? value.value.join(", ") : string(value.value)} onChange={event => {
+      const input = event.currentTarget.value;
+      onChange({ ...value, value: list ? input.split(",").map(item => item.trim()).map(item => numeric && item !== "" && Number.isFinite(Number(item)) ? Number(item) : item) : numeric && input !== "" ? Number(input) : input });
+    }} /></label>}
+    <button type="button" className="secondary" disabled={disabled} aria-label={`Remove condition ${index + 1}`} onClick={onRemove}>Remove</button>
+  </div>;
+}
+
+export function RoutingBuilder({ value, onChange, queues, disabled }: BuilderProps & { queues: QueueSummary[] }) {
+  const rules = objects(value.rules).sort((a, b) => Number(b.priority) - Number(a.priority) || string(a.id).localeCompare(string(b.id)));
+  const update = (index: number, next: JsonObject) => onChange({ ...value, rules: rules.map((rule, i) => i === index ? next : rule) });
+  const reorder = (index: number, destination: number) => {
+    const next = [...rules];
+    next.splice(destination, 0, next.splice(index, 1)[0]!);
+    onChange({ ...value, rules: next.map((rule, i) => ({ ...rule, priority: 100_000 - i })) });
+  };
+  return <div className="configuration-builder">
+    <section className="configuration-section"><h3>Where should cases go?</h3><p>Choose who handles new cases and who handles cases that need a safety review.</p>
+      <QueueChoice label="Default queue" help="Receives cases that do not match a rule below." value={string(value.default_queue_id)} queues={queues} onChange={next => onChange({ ...value, default_queue_id: next })} disabled={disabled} />
+      <QueueChoice label="Safety review queue" help="Human reviewers handle cases flagged by safeguards, before any routing rule or AI." value={string(value.safeguard_queue_id)} queues={queues} humanOnly onChange={next => onChange({ ...value, safeguard_queue_id: next })} disabled={disabled} />
+    </section>
+    <section className="configuration-section"><div className="configuration-section-heading"><div><h3>Routing rules</h3><p>Checked from top to bottom. The first matching rule chooses the queue.</p></div><button className="secondary" type="button" disabled={disabled || rules.length >= 100} onClick={() => onChange({ ...value, rules: [...rules, { id: `rule-${crypto.randomUUID()}`, priority: 0, queue_id: value.default_queue_id || "", match: "all", conditions: [{ field: "reason_code", operator: "eq", value: "" }] }].map((rule, i) => ({ ...rule, priority: 100_000 - i })) })}>Add rule</button></div>
+      {!rules.length ? <p className="configuration-empty">All cases go to the default queue, unless a safeguard requires human review.</p> : rules.map((rule, index) => <fieldset className="routing-rule" key={string(rule.id)}><legend>Rule {index + 1}</legend>
+        <div className="configuration-rule-actions"><button type="button" className="secondary" aria-label={`Move rule ${index + 1} up`} disabled={disabled || index === 0} onClick={() => reorder(index, index - 1)}>Move up</button><button type="button" className="secondary" aria-label={`Move rule ${index + 1} down`} disabled={disabled || index === rules.length - 1} onClick={() => reorder(index, index + 1)}>Move down</button><button type="button" className="secondary" disabled={disabled} aria-label={`Remove rule ${index + 1}`} onClick={() => onChange({ ...value, rules: rules.filter((_, i) => i !== index) })}>Remove rule</button></div>
+        <label>Match<select aria-label={`Rule ${index + 1} match`} value={string(rule.match)} disabled={disabled} onChange={event => update(index, { ...rule, match: event.currentTarget.value })}><option value="all">All of these conditions</option><option value="any">Any of these conditions</option></select></label>
+        {objects(rule.conditions).map((condition, i) => <Condition key={i} index={i} value={condition} disabled={disabled} onChange={next => update(index, { ...rule, conditions: objects(rule.conditions).map((item, j) => i === j ? next : item) })} onRemove={() => update(index, { ...rule, conditions: objects(rule.conditions).filter((_, j) => i !== j) })} />)}
+        {!objects(rule.conditions).length ? <p>This rule matches {rule.match === "all" ? "every case" : "no cases"}.</p> : null}
+        <button className="secondary" type="button" disabled={disabled || objects(rule.conditions).length >= 50} onClick={() => update(index, { ...rule, conditions: [...objects(rule.conditions), { field: "reason_code", operator: "eq", value: "" }] })}>Add condition</button>
+        <QueueChoice label={`Rule ${index + 1} queue`} help="Send matching cases to this queue." queues={queues} value={string(rule.queue_id)} disabled={disabled} onChange={next => update(index, { ...rule, queue_id: next })} />
+      </fieldset>)}
+    </section>
+    {objects(value.fixtures).length || objects(value.intake_enrichments).length ? <p className="configuration-retained">{objects(value.fixtures).length} saved routing examples and {objects(value.intake_enrichments).length} intake enrichments are retained. Use Advanced configuration to inspect them.</p> : null}
+  </div>;
+}
+
+export function PolicyBuilder({ value, onChange, disabled }: BuilderProps) {
+  const rules = objects(value.rules);
+  return <div className="configuration-builder"><label>Policy title<input required minLength={3} maxLength={160} disabled={disabled} value={string(value.title)} onChange={event => onChange({ ...value, title: event.currentTarget.value })} /></label>
+    <section className="configuration-section"><h3>Decision rules</h3><p>Give reviewers clear rules to apply when deciding a case.</p>
+      {rules.map((rule, index) => <fieldset key={index}><legend>Rule {index + 1}</legend><label>Rule title<input aria-label={`Rule ${index + 1} title`} required minLength={3} maxLength={200} disabled={disabled} value={string(rule.title)} onChange={event => onChange({ ...value, rules: rules.map((item, i) => i === index ? { ...item, title: event.currentTarget.value } : item) })} /></label>
+        <label>Guidance for reviewers<textarea aria-label={`Rule ${index + 1} guidance`} rows={3} disabled={disabled} value={string(rule.description)} onChange={event => onChange({ ...value, rules: rules.map((item, i) => i === index ? { ...item, description: event.currentTarget.value } : item) })} /></label>
+        <button className="secondary" type="button" disabled={disabled || rules.length === 1} onClick={() => onChange({ ...value, rules: rules.filter((_, i) => i !== index) })}>Remove rule {index + 1}</button></fieldset>)}
+      <button className="secondary" type="button" disabled={disabled || rules.length >= 500} onClick={() => onChange({ ...value, rules: [...rules, { code: `rule-${crypto.randomUUID()}`, title: "" }] })}>Add rule</button>
+    </section></div>;
+}
+
+export function MessageBuilder({ value, onChange, disabled }: BuilderProps) {
+  const variables = value.variables_schema && typeof value.variables_schema === "object" && !Array.isArray(value.variables_schema) ? value.variables_schema : {};
+  const setBody = (body: string) => {
+    const next = { ...variables };
+    for (const match of body.matchAll(/\{\{\s*([A-Za-z][A-Za-z0-9_]*)\s*\}\}/gu)) if (!(match[1]! in next)) next[match[1]!] = { type: "string" };
+    onChange({ ...value, body_template: body, variables_schema: next });
+  };
+  return <div className="configuration-builder"><div className="form-grid">
+    <label>Send to<select disabled={disabled} value={string(value.audience)} onChange={event => onChange({ ...value, audience: event.currentTarget.value })}><option value="reporter">Person who reported</option><option value="affected_user">Person affected by the decision</option></select></label>
+    <label>When to use<select disabled={disabled} value={string(value.purpose)} onChange={event => onChange({ ...value, purpose: event.currentTarget.value })}><option value="follow_up">Request more information</option><option value="outcome">Share the case outcome</option><option value="affected_user_notice">Explain an action taken</option><option value="appeal_outcome">Share the appeal outcome</option></select></label>
+  </div><label>Language<small>Language code, such as en, fr, or en-GB.</small><input required pattern="[a-z]{2,3}(?:-[A-Z]{2})?" maxLength={6} disabled={disabled} value={string(value.locale)} onChange={event => onChange({ ...value, locale: event.currentTarget.value })} /></label>
+    <label>Message<textarea required rows={6} maxLength={10000} disabled={disabled} value={string(value.body_template)} onChange={event => setBody(event.currentTarget.value)} /></label>
+    <div className="message-variable-buttons"><span>Insert a detail:</span>{[...new Set(["report_reference", ...Object.keys(variables)])].map(name => <button className="secondary" type="button" disabled={disabled} key={name} onClick={() => setBody(`${string(value.body_template)} {{${name}}}`)}>{name.replaceAll("_", " ")}</button>)}</div>
+    <label className="checkbox"><input type="checkbox" disabled={disabled} checked={value.automation_allowed === true} onChange={event => onChange({ ...value, automation_allowed: event.currentTarget.checked })} /><span>Allow this template in automated messages</span></label>
+    <section className="message-preview" aria-label="Message preview"><h3>Preview</h3><p>{string(value.body_template).replace(/\{\{\s*([A-Za-z][A-Za-z0-9_]*)\s*\}\}/gu, (_, name: string) => name === "report_reference" ? "RPT-EXAMPLE" : `[${name.replaceAll("_", " ")}]`) || "Your message will appear here."}</p><small>Example details are replaced with the recipient’s case details when sent.</small></section>
+  </div>;
+}