File size: 11,847 Bytes
8cbc29f
19b91ce
 
 
 
 
8cbc29f
19b91ce
 
 
 
 
 
 
 
8cbc29f
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
19b91ce
8cbc29f
19b91ce
 
 
 
 
 
 
 
 
dec006b
 
19b91ce
 
 
 
dec006b
19b91ce
 
 
 
 
dec006b
 
 
 
 
19b91ce
 
dec006b
19b91ce
 
 
 
 
 
 
 
 
 
 
 
 
 
8cbc29f
 
 
 
 
19b91ce
 
 
 
8cbc29f
 
 
 
 
19b91ce
 
 
 
 
 
dec006b
 
 
 
19b91ce
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
dec006b
19b91ce
103a492
19b91ce
dec006b
19b91ce
 
 
 
dec006b
103a492
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
dec006b
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
import { useEffect, useRef, useState } from "react";
import {
  AutomationError, createOperatorGrant, getOperatorAudit, getOperatorSetup,
  getOperatorVoiceSetup, getSystemData, type OperatorAudit, type OperatorGrant,
  type OperatorSetup, type OperatorSetupField, type OperatorVoiceSetup, type SystemData,
} from "../automation/automationApi";
import { API_V1, CREDENTIALS, TOAST_EVENT, UNAUTHORIZED_EVENT, checkTenant, signal } from "../apiContract";
import "./operator.css";

export interface OperatorPageProps { platformAdmin: boolean }

const SAFE_SETUP_FIELDS: OperatorSetupField[] = [
  "displayName", "timezone", "voicePurpose", "consentPolicy", "queryEnabled", "providerLabel",
];

function useRefusalToast() {
  const [messages, setMessages] = useState<{ id: number; text: string }[]>([]);
  const sequence = useRef(0);
  const delivered = useRef(0);
  useEffect(() => {
    if (!messages.length) return;
    const through = messages[messages.length - 1].id;
    for (const message of messages) {
      if (message.id <= delivered.current) continue;
      delivered.current = message.id;
      const text = message.text;
      window.dispatchEvent(new CustomEvent(TOAST_EVENT, { detail: { text, tone: "error" } }));
    }
    setMessages((current) => current.filter((message) => message.id > through));
  }, [messages]);
  return (text: string) => {
    if (!text) return;
    const message = { id: ++sequence.current, text };
    setMessages((current) => [...current, message]);
  };
}

export default function OperatorPage({ platformAdmin }: OperatorPageProps) {
  const refuse = useRefusalToast();
  const [audit, setAudit] = useState<OperatorAudit[] | null>(null);
  const [system, setSystem] = useState<SystemData | null>(null);
  const [tenant, setTenant] = useState("");
  const [setup, setSetup] = useState<OperatorSetup | null>(null);
  const [voice, setVoice] = useState<OperatorVoiceSetup | null>(null);
  const [grant, setGrant] = useState<OperatorGrant | null>(null);
  const [problem, setProblem] = useState("");
  const [busy, setBusy] = useState(false);
  const [inspectorOpen, setInspectorOpen] = useState(false);
  const [loadError, setLoadError] = useState<{ sentence: string; detail: string } | null>(null);
  const [loadAttempt, setLoadAttempt] = useState(0);

  useEffect(() => {
    if (!platformAdmin) return;
    const controller = new AbortController();
    setLoadError(null); setAudit(null); setSystem(null);
    void Promise.all([getOperatorAudit(controller.signal), getSystemData(controller.signal)])
      .then(([a, s]) => { setAudit(a.audit); setSystem(s); })
      .catch((error) => {
        if (controller.signal.aborted) return;
        const refused = error instanceof AutomationError && (error.status === 403 || error.status === 404);
        // S74-T13: a failed read is one plain sentence with Retry; the server text stays in the tooltip.
        setLoadError({
          sentence: refused ? "Operator is unavailable for this account." : "Could not load the audit history and system data.",
          detail: error instanceof Error ? error.message : "",
        });
      });
    return () => controller.abort();
  }, [platformAdmin, loadAttempt]);

  if (!platformAdmin) return null;

  async function inspectTenant() {
    const target = tenant.trim().toLowerCase();
    if (!target) return;
    setBusy(true); setProblem(""); setSetup(null); setVoice(null); setGrant(null);
    try {
      const granted = await createOperatorGrant(target, ["tenant.read", "voice.read"]);
      setGrant(granted.grant);
      const tenantSetup = await getOperatorSetup(target, granted.token);
      const voiceSetup = await getOperatorVoiceSetup(target, granted.token);
      setSetup(tenantSetup); setVoice(voiceSetup);
    } catch (error) {
      const refused = error instanceof AutomationError && [401, 403, 404].includes(error.status);
      const text = (refused ? "That tenant or capability is unavailable. " : "")
        + (error instanceof Error ? error.message : "Tenant setup unavailable.");
      if (refused) refuse(text);
      else setProblem(text);
    } finally {
      // Both allowed and refused inspections append an audit result. Refresh after either path so
      // the visible receipt is the final server outcome, not the preflight list.
      try { setAudit((await getOperatorAudit()).audit); }
      catch (error) {
        const text = error instanceof Error ? error.message : "Audit refresh unavailable.";
        if (error instanceof AutomationError && [401, 403, 404].includes(error.status)) refuse(text);
        else setLoadError({ sentence: "Could not refresh the audit history.", detail: text });
      }
      setBusy(false);
    }
  }

  return <section className="op-page" aria-labelledby="operator-heading">
    <header className="op-head"><div><p className="op-kicker">Platform admin</p><h3 id="operator-heading">Operator</h3></div><span className="op-mask">Secrets masked</span></header>
    {loadError ? <div className="set-error" role="alert">
      <span title={loadError.detail || undefined}>{loadError.sentence}</span>
      <button type="button" className="set-secondary" onClick={() => setLoadAttempt((n) => n + 1)}>Retry</button>
    </div> : null}
    {problem ? <p className="set-error" role="alert">{problem}</p> : null}
    <section className="op-section" aria-labelledby="operator-access-heading"><h4 id="operator-access-heading">Tenant setup</h4>
      <label className="set-field"><span>Exact tenant slug</span><input value={tenant} onChange={(event) => setTenant(event.currentTarget.value)} /></label>
      <button type="button" className="op-quiet" disabled={busy || !tenant.trim()} onClick={() => void inspectTenant()}>{busy ? "Authorizing…" : "Inspect with read grant"}</button>
      {grant ? <dl className="op-facts" aria-label="Minted read grant">
        <div><dt>Capabilities</dt><dd>{grant.capabilities.join(", ")}</dd></div>
        <div><dt>Expires</dt><dd><time dateTime={new Date(grant.expiresAt * 1000).toISOString()}>{new Date(grant.expiresAt * 1000).toLocaleString()}</time></dd></div>
      </dl> : null}
      {setup ? <dl className="op-facts" aria-label="Safe tenant setup">{SAFE_SETUP_FIELDS
        .filter((field) => setup.setup[field] !== undefined)
        .map((field) => <div key={field}><dt>{field}</dt><dd>{String(setup.setup[field])}</dd></div>)}</dl> : null}
      {voice ? <>
        <dl className="op-facts" aria-label="Safe Voice setup">
          <div><dt>Schema</dt><dd>{voice.voice.schemaVersion}</dd></div>
          <div><dt>Recipient ceiling</dt><dd>{voice.voice.maxRecipientsCeiling}</dd></div>
          <div><dt>Providers</dt><dd>{voice.voice.providers.map((provider) => provider.label).join(", ") || "None reported"}</dd></div>
        </dl>
        <p className="w45-safe">Secrets present: {String(voice.secretsPresent)}. Raw provider bindings: {String(voice.rawProviderBindings)}.</p>
      </> : null}
    </section>
    <section className="op-section" aria-labelledby="operator-audit-heading"><h4 id="operator-audit-heading">Audit history</h4>
      {audit === null ? (loadError ? null : <ReadSkeleton label="Loading audit history" />) : <ol className="op-audit">{audit.map((entry, index) => <li key={entry.id || `${entry.action}-${index}`}><span>{entry.action} · {entry.outcome}</span><small>{entry.actor}, {entry.tenant}</small></li>)}</ol>}
    </section>
    <OperatorIntents />
    <section className="op-section" aria-labelledby="system-data-heading"><div className="op-section-head"><h4 id="system-data-heading">System data</h4><button type="button" className="op-quiet" disabled={!system} aria-expanded={inspectorOpen} onClick={() => setInspectorOpen((open) => !open)}>{inspectorOpen ? "Close inspector" : "Open inspector"}</button></div>
      {system === null && !loadError ? <ReadSkeleton label="Loading system data" /> : null}
      {inspectorOpen && system ? <dl className="op-facts op-system-data" aria-label="Read-only system data inspector">{system.databases.map((row) => <div key={row.key}><dt>{row.label || row.key}</dt><dd>{row.fields.length} field definitions · read only</dd></div>)}</dl> : null}
    </section>
  </section>;
}

interface IntentRow { ts: number; tenant: string; tool: string; action: string; outcome: string; intent: string }
interface IntentList { rows: IntentRow[]; tools: string[]; total: number; unavailableTenants: string[] }

function OperatorIntents() {
  const [data, setData] = useState<IntentList | null>(null);
  const [tool, setTool] = useState("");
  const [problem, setProblem] = useState("");
  const [attempt, setAttempt] = useState(0);

  useEffect(() => {
    const controller = new AbortController();
    setData(null); setProblem("");
    void (async () => {
      try {
        const response = await fetch(`${API_V1}/feedback/intents?tool=${encodeURIComponent(tool)}`, {
          credentials: CREDENTIALS, cache: "no-store", signal: controller.signal,
        });
        if (checkTenant(response)) return;
        if (response.status === 401) signal(UNAUTHORIZED_EVENT);
        if (!response.ok) {
          throw new Error(response.status === 403
            ? "Intents are unavailable for this account." : "Could not load intents.");
        }
        const body: IntentList = await response.json();
        if (!controller.signal.aborted) setData(body);
      } catch (error) {
        if (!controller.signal.aborted) setProblem(error instanceof Error ? error.message : "Could not load intents.");
      }
    })();
    return () => controller.abort();
  }, [tool, attempt]);

  return <section className="op-section" aria-labelledby="operator-intents-heading">
    <h4 id="operator-intents-heading">Intents</h4>
    <div className="set-field">
      <label className="set-label" htmlFor="operator-intents-tool">Tool</label>
      <select id="operator-intents-tool" className="pg-select" value={tool} onChange={(event) => setTool(event.currentTarget.value)}>
        <option value="">All tools</option>
        {Array.from(new Set([...(data?.tools ?? []), ...(tool ? [tool] : [])])).sort().map((name) => <option key={name} value={name}>{name}</option>)}
      </select>
    </div>
    {problem || data?.unavailableTenants.length ? <div className="set-error" role="alert">
      <span>{problem || "Some intent history could not be loaded."}</span>
      <button type="button" className="set-secondary" onClick={() => setAttempt((value) => value + 1)}>Retry</button>
    </div> : null}
    {data === null ? (problem ? null : <ReadSkeleton label="Loading intents" />) : data.rows.length ? <div className="padmin-tablewrap" role="region" aria-label="Intent history" tabIndex={0}><table className="set-table" aria-label="Intents">
      <thead><tr>{["Time", "Tenant", "Tool", "Action", "Outcome", "Intent"].map((heading) => <th key={heading} scope="col">{heading}</th>)}</tr></thead>
      <tbody>{data.rows.map((row, index) => <tr key={`${row.tenant}-${row.ts}-${index}`} data-intent-row>
        <td><time dateTime={new Date(row.ts * 1000).toISOString()}>{new Date(row.ts * 1000).toLocaleString()}</time></td>
        <td>{row.tenant}</td><td>{row.tool}</td><td>{row.action}</td><td>{row.outcome}</td><td>{row.intent || "Not provided"}</td>
      </tr>)}</tbody>
    </table></div> : data.unavailableTenants.length ? null : <p className="set-help">{tool ? "No calls for this tool." : "No calls yet."}</p>}
  </section>;
}

/** The shared Settings skeleton while a protected read is in flight. */
function ReadSkeleton({ label }: { label: string }) {
  return <div className="set-skeleton" role="status" aria-label={label} aria-busy="true">
    <span className="set-skeleton-line" aria-hidden="true" />
    <span className="set-skeleton-line" aria-hidden="true" />
    <span className="set-skeleton-line" aria-hidden="true" />
  </div>;
}