Python
import { useEffect, useRef, useState } from "react";
import { useTranslation } from "react-i18next";
import {
getMachineSessionsList,
getPersonasIndex,
getSessions,
installPersona,
updatePersona,
type Machine,
type Persona,
type PersonaConsent,
} from "../api";
import { useMachineData } from "../useMachineData";
import { CachedNote, LoadingRow, UnreachableRow } from "./ScopedStatus";
import { chooseFolder } from "../tauri";
import type { SessionInfo } from "../types";
import { Icon } from "./Icon";
import { Toggle } from "./Toggle";
import { listPersonaName } from "../personaScope";
// Personas management (UX-035): grouped General/Security lists with ONE toggle per row
// (enable implies picker); in-picker nuance, set-default, export and delete live on the
// per-coworker detail page. Unshipped coworkers (ships:false) and the installer are quiet
// text disclosures at the bottom; Folder/Zip install through native pickers.
const CARD = "rounded-xl2 border border-line bg-panel";
const SELECT = "px-2.5 py-2 rounded-lg border border-line bg-paper text-ui text-ink shrink-0";
const INPUT =
"flex-1 min-w-0 px-3 py-2 rounded-lg border border-line bg-paper text-ui text-ink outline-none focus:border-accent";
const BTN_ACCENT = "text-ui px-3 py-2 rounded-lg bg-accent text-white shrink-0 disabled:opacity-40";
const BTN_BORDERED =
"text-ui px-2.5 py-1.5 rounded-lg border border-line bg-paper hover:border-lineStrong shrink-0 disabled:opacity-40 disabled:hover:border-line";
const QUIET_ROW =
"w-full flex items-center gap-2 px-4 pt-2 mt-6 text-ui text-muted select-none";
export function PersonasTab({
onOpenPersona,
machine,
}: {
onOpenPersona?: (id: string) => void;
// UX-046 machine scope: manage THIS machine's coworkers through the proxy.
machine?: Machine | null;
}) {
const { t } = useTranslation();
const mid = machine?.id ?? null;
const [personas, setPersonas] = useState<Persona[]>([]);
const [internal, setInternal] = useState(false);
const [mode, setMode] = useState<"git" | "dir" | "zip">("git");
const [src, setSrc] = useState("");
const [busy, setBusy] = useState(false);
const [msg, setMsg] = useState<string | null>(null);
const [consent, setConsent] = useState<PersonaConsent[] | null>(null);
const [showUnshipped, setShowUnshipped] = useState(false);
const [showInstall, setShowInstall] = useState(false);
// Disabling archives the persona's conversations (server-side), so when there are any we
// arm an inline confirm (same two-step idiom as delete) instead of flipping immediately.
const [confirmOff, setConfirmOff] = useState<string | null>(null);
const [sessions, setSessions] = useState<SessionInfo[]>([]);
// The picker's "Import coworker…" door lands here and asks us to put the Add section
// front and center (sharing v1).
const addRef = useRef<HTMLDivElement | null>(null);
useEffect(() => {
const focus = () => {
setShowInstall(true); // the installer is a collapsed disclosure — open it first
setTimeout(
() => addRef.current?.scrollIntoView({ behavior: "smooth", block: "center" }),
0,
);
};
window.addEventListener("ocw-focus-import", focus);
return () => window.removeEventListener("ocw-focus-import", focus);
}, []);
const index = useMachineData(`personas:${mid ?? "local"}`, () => getPersonasIndex(mid));
useEffect(() => {
if (index.data) {
setPersonas(index.data.personas);
setInternal(index.data.internal);
}
}, [index.data]);
const reload = index.refresh;
const reloadSessions = () =>
(mid ? getMachineSessionsList(mid) : getSessions()).then(setSessions).catch(() => {});
useEffect(() => {
reloadSessions();
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [mid]);
// Real conversations the disable would archive (unarchived; run sessions are server-hidden).
const liveCount = (id: string) =>
sessions.filter((s) => s.agent === id && !s.archived).length;
const toggle = async (
id: string,
body: { enabled?: boolean; surfaced?: boolean; default?: boolean },
) => {
const r = await updatePersona(id, body, mid);
if (r.personas) setPersonas(r.personas);
else reload();
if (body.enabled === false) reloadSessions(); // counts just changed
};
const requestDisable = (p: Persona) => {
if (liveCount(p.id) > 0) setConfirmOff(p.id);
else toggle(p.id, { enabled: false });
};
const finishInstall = (r: Awaited<ReturnType<typeof installPersona>>) => {
setBusy(false);
if (!r.ok) {
setMsg(r.error || t("personas.install_failed"));
return;
}
setConsent(r.consent || []);
if (r.personas) setPersonas(r.personas);
setMsg(t("personas.installed", { count: (r.consent || []).length }));
setSrc("");
};
// Folder installs go through the native picker — no path typing (owner, 2026-08-21).
const installDir = async () => {
const dir = await chooseFolder();
if (!dir) return;
setBusy(true);
setMsg(null);
setConsent(null);
finishInstall(await installPersona({ dir }, mid));
};
const installZip = async (file: File) => {
setBusy(true);
setMsg(null);
setConsent(null);
const buf = new Uint8Array(await file.arrayBuffer());
let bin = "";
for (let i = 0; i < buf.length; i += 0x8000)
bin += String.fromCharCode(...buf.subarray(i, i + 0x8000));
finishInstall(await installPersona({ zip_b64: btoa(bin), filename: file.name }, mid));
};
const install = async () => {
if (!src.trim()) return;
setBusy(true);
setMsg(null);
setConsent(null);
const r = await installPersona({ git_url: src.trim() }, mid);
setBusy(false);
if (!r.ok) {
setMsg(r.error || t("personas.install_failed"));
return;
}
setConsent(r.consent || []);
if (r.personas) setPersonas(r.personas);
setMsg(t("personas.installed", { count: (r.consent || []).length }));
setSrc("");
};
const unshipped = personas.filter((p) => p.ships === false);
const group = (title: string | null, list: Persona[]) => {
if (list.length === 0) return null;
return (
<div className={title ? "mt-7" : "mt-1.5"}>
{title && (
<div className="text-meta font-semibold text-muted px-4 mb-1.5">{title}</div>
)}
<div className={CARD + " divide-y divide-line"}>
{list.map((p) => (
<div key={p.id} className="px-[18px] py-4">
<div className="flex items-center gap-3">
{/* T3-12: the name opens the coworker's page (its settings and "How it's
been doing"), the default coworker's too */}
{onOpenPersona ? (
<button
className="min-w-0 flex-1 text-left cursor-pointer group"
title={t("personas.open_title", { name: listPersonaName(p.name, p.id, t) })}
data-testid={`persona-open-${p.id}`}
onClick={() => onOpenPersona(p.id)}
>
<div className="text-body font-medium truncate group-hover:underline">{listPersonaName(p.name, p.id, t)}</div>
<div className="text-meta text-faint truncate mt-0.5">{p.tagline}</div>
</button>
) : (
<div className="min-w-0 flex-1">
<div className="text-body font-medium truncate">{listPersonaName(p.name, p.id, t)}</div>
<div className="text-meta text-faint truncate mt-0.5">{p.tagline}</div>
</div>
)}
{p.default ? (
/* The default coworker cannot be disabled or hidden — no toggle, no
configure; a quiet tag says why (owner 2026-08-21). It regains its
controls the moment another coworker is made default. */
<span
className="text-label font-medium px-2 py-0.5 rounded-full bg-paper border border-lineStrong text-muted shrink-0"
title={t("personas.default_for_new")}
data-testid="persona-default-tag"
>
{t("personas.default_tag")}
</span>
) : (
<>
<Toggle
checked={p.enabled}
onChange={(next) =>
next ? toggle(p.id, { enabled: true }) : requestDisable(p)
}
title={p.enabled ? t("personas.disable_coworker") : t("personas.enable_coworker")}
/>
{onOpenPersona && (
<button
className="text-faint hover:text-ink shrink-0 p-1"
title={t("personas.configure_title", { name: p.name })}
aria-label={t("personas.configure_title", { name: p.name })}
data-testid={`persona-configure-${p.id}`}
onClick={() => onOpenPersona(p.id)}
>
<Icon name="sliders" size={15} />
</button>
)}
</>
)}
</div>
{confirmOff === p.id && (
<div
className="mt-2 flex items-center gap-2.5 text-meta text-muted"
data-testid={`persona-disable-warning-${p.id}`}
>
<span className="min-w-0">
{t("personas.disable_warning", { count: liveCount(p.id) })}
</span>
<button
className="text-meta px-2.5 py-1.5 rounded-lg bg-accent text-white shrink-0"
data-testid={`persona-disable-confirm-${p.id}`}
onClick={() => {
setConfirmOff(null);
toggle(p.id, { enabled: false });
}}
>
{t("personas.disable")}
</button>
<button className={BTN_BORDERED} onClick={() => setConfirmOff(null)}>
{t("personas.keep_enabled")}
</button>
</div>
)}
</div>
))}
</div>
</div>
);
};
return (
<div>
{index.cachedAt ? <CachedNote at={index.cachedAt} /> : null}
{index.loading && !index.data ? (
<LoadingRow
what={
machine
? t("settingsx.personas.loading_what_on", { name: machine.name })
: t("settingsx.personas.loading_what")
}
/>
) : index.error && !index.data && machine ? (
<UnreachableRow machineName={machine.name} />
) : null}
{/* One toggle per row (enable implies picker); ★ marks the default. Everything
else — in-picker nuance, default, export, delete — lives on the detail page. */}
{group(t("personas.group_general"), personas.filter((p) => p.ships !== false && !["engineering", "security"].includes(p.group || "")))}
{group(t("personas.group_engineering"), personas.filter((p) => p.ships !== false && p.group === "engineering"))}
{group(t("personas.group_security"), personas.filter((p) => p.ships !== false && p.group === "security"))}
{unshipped.length > 0 && (
<>
<button
className={QUIET_ROW}
data-testid="unshipped-disclosure"
onClick={() => setShowUnshipped((v) => !v)}
>
<Icon
name="chevronRight"
size={12}
className={"transition-transform" + (showUnshipped ? " rotate-90" : "")}
/>
<span>{t("personas.unshipped_row", { count: unshipped.length })}</span>
<span className="ml-auto text-faint text-meta">
{internal ? t("personas.internal_build") : t("personas.not_in_release")}
</span>
</button>
{showUnshipped && group(null, unshipped)}
</>
)}
<button
ref={addRef as any}
className={QUIET_ROW}
data-testid="install-disclosure"
onClick={() => setShowInstall((v) => !v)}
>
<Icon
name="chevronRight"
size={12}
className={"transition-transform" + (showInstall ? " rotate-90" : "")}
/>
<span>{t("personas.install_coworker")}</span>
<span className="ml-auto text-faint text-meta">
{machine ? t("settingsx.personas.install_sources_machine") : t("personas.install_sources")}
</span>
</button>
{showInstall && (
<div className={CARD + " mt-1.5 p-4"}>
<div className="flex items-center gap-2">
<select
className={SELECT}
value={mode}
onChange={(e) => setMode(e.target.value as "git" | "dir" | "zip")}
>
<option value="git">{t("personas.mode_github")}</option>
{!machine && <option value="dir">{t("personas.mode_local")}</option>}
<option value="zip">{t("personas.mode_zip")}</option>
</select>
{mode === "git" ? (
<>
<input
className={INPUT}
placeholder={t("personas.placeholder_github")}
value={src}
onChange={(e) => setSrc(e.target.value)}
onKeyDown={(e) => e.key === "Enter" && install()}
/>
<button className={BTN_ACCENT} disabled={busy || !src.trim()} onClick={install}>
{busy ? t("personas.installing") : t("personas.install")}
</button>
</>
) : mode === "dir" ? (
<>
<button
className={BTN_BORDERED}
disabled={busy}
data-testid="persona-dir-choose"
onClick={() => void installDir()}
>
{busy ? t("personas.installing") : t("personas.choose_folder")}
</button>
<span className="text-meta text-faint">
{t("personas.dir_picker_note")}
</span>
</>
) : (
<label className={BTN_BORDERED + " cursor-pointer"}>
{busy ? t("personas.installing") : t("personas.choose_zip")}
<input
type="file"
accept=".zip"
className="hidden"
data-testid="persona-zip-input"
disabled={busy}
onChange={(e) => {
const f = e.target.files?.[0];
if (f) void installZip(f);
e.target.value = "";
}}
/>
</label>
)}
</div>
<div className="flex items-start gap-2 mt-3 text-meta text-muted leading-relaxed">
<span className="text-warnInk shrink-0">⚠</span>
<span>{t("personas.install_trust_note")}</span>
</div>
</div>
)}
{msg && <div className="text-ui text-muted mt-2.5">{msg}</div>}
{consent && consent.length > 0 && (
<div className="mt-4 space-y-2" data-testid="consent-review">
{/* Trust first (owner design, 2026-08-11): the source warning leads; capabilities
are a one-line summary with the exact tools under a collapsed chevron. A
coworker runs no third-party code, so this list is complete — but a prompt
still steers an agent, so who it came from genuinely matters. */}
<div className="flex items-start gap-2.5 rounded-xl border border-warnInk/30 bg-warnSoft px-3.5 py-2.5 text-ui text-warnInk">
<Icon name="shield" size={15} className="shrink-0 mt-0.5" />
<span>{t("personas.install_shield_warning")}</span>
</div>
{consent.map((c) => (
<ConsentCard
key={c.id}
c={c}
enabled={personas.find((p) => p.id === c.id)?.enabled ?? false}
onEnable={async () => {
await toggle(c.id, { enabled: true, surfaced: true });
}}
/>
))}
</div>
)}
</div>
);
}
// One phrase per risk class — the plain-language capability summary the consent card leads
// with; unknown classes fall back to their raw id so nothing is silently omitted.
// Values are i18n keys resolved at render time.
const RISK_PHRASE: Record<string, string> = {
read: "personas.risk.read",
write_local: "personas.risk.write_local",
exec: "personas.risk.exec",
network: "personas.risk.network",
write_remote: "personas.risk.write_remote",
};
function ConsentCard({
c,
enabled,
onEnable,
}: {
c: PersonaConsent;
enabled: boolean;
onEnable: () => Promise<void>;
}) {
const { t } = useTranslation();
const [showTools, setShowTools] = useState(false);
const [busy, setBusy] = useState(false);
const phrases = (c.risk.length ? c.risk : ["read"]).map((r) => (RISK_PHRASE[r] ? t(RISK_PHRASE[r]) : r));
const summary = phrases.join(", ").replace(/, ([^,]*)$/, " " + t("personas.risk_join_and") + " $1");
const recommends = c.recommends || [];
return (
<div className={CARD + " p-3.5"} data-testid={`consent-${c.id}`}>
<div className="text-ui font-medium flex items-center gap-2">
<span>{c.name}</span>
{c.version && <span className="text-label text-faint font-normal">v{c.version}</span>}
</div>
{c.description && <div className="text-meta text-muted mt-0.5">{c.description}</div>}
{c.replaces && (
<div className="text-meta text-muted mt-1.5" data-testid="replaces-note">
{t("personas.consent_replaces", { name: c.name })}
{c.replaces.version ? ` v${c.replaces.version}` : ""}
{c.replaces.installed_at ? " " + t("personas.consent_installed_at", { date: c.replaces.installed_at }) : ""}.
{c.replaces.capabilities_grew
? " " + t("personas.consent_caps_grew")
: " " + t("personas.consent_caps_same")}
</div>
)}
<div className="text-ui text-ink mt-2">
{t("personas.consent_can", { summary })}
{c.connectors === "all"
? " " + t("personas.consent_all_connectors")
: c.connectors.length
? " " + t("personas.consent_use_connectors", { list: c.connectors.join(", ") })
: ""}
{c.messaging ? " " + t("personas.consent_send_messages") : ""}
{c.mcp.length ? " " + t("personas.consent_use_mcp", { list: c.mcp.join(", ") }) : ""}
<button
className="ml-2 text-accent text-meta hover:underline"
data-testid="consent-tools-toggle"
onClick={() => setShowTools((v) => !v)}
>
{showTools ? t("personas.consent_hide_tools") : t("personas.consent_exact_tools", { n: c.tools.length })}
</button>
</div>
{showTools && (
<div className="text-meta text-muted mt-1 font-mono">{c.tools.join(" · ") || "—"}</div>
)}
{recommends.length > 0 && (
<div className="mt-2 space-y-0.5">
{recommends.map((r) => (
<div key={r.kind + r.ref} className="text-meta text-muted">
<span className="text-ink">{r.ref}</span>
{r.tier === "core"
? " " + t("personas.consent_recommended_tag")
: " " + t("personas.consent_optional_tag")}{" "}
— {r.reason}
</div>
))}
</div>
)}
<div className="flex items-center gap-3 mt-2.5">
{/* Enable right here (owner ask 2026-08-11) — the old "enable it above" copy
sent the user hunting back up the list. */}
{enabled ? (
<span className="text-ui text-muted" data-testid="consent-enabled">
{t("personas.consent_enabled_note")}
</span>
) : (
<button
className={BTN_ACCENT}
data-testid={`consent-enable-${c.id}`}
disabled={busy}
onClick={() => {
setBusy(true);
void onEnable().finally(() => setBusy(false));
}}
>
{busy ? t("personas.enabling") : t("personas.enable_coworker")}
</button>
)}
<span className="text-meta text-faint">
{t("personas.consent_recommended_mode", { mode: c.recommended_mode })}
</span>
</div>
</div>
);
}