parallel-codex-tui 0.2.10 → 0.3.0

package/dist/tui/App.js

@@ -5,6 +5,7 @@ import { Box, Text, useApp, useInput, useStdin } from "ink";
 import { Lexer } from "marked";
 import { copyTextToClipboard } from "../core/clipboard.js";
 import { readJson } from "../core/file-store.js";
+import { CONFIGURABLE_ROLES, configuredRoleSelection } from "../core/role-configuration.js";
 import { WorkerStatusSchema } from "../domain/schemas.js";
 import { effectiveWorkerWatchdog, formatRoutePendingStatus, formatRoutePendingSummaryStatus, formatRouteStatus, formatRouteSummaryStatus, formatStatusLine, formatWorkerRuntimeStatus } from "./status-line.js";
 import { applyChatInputChunk, insertChatPaste } from "./chat-input.js";
@@ -19,7 +20,7 @@ import { TerminalOutput } from "./TerminalOutput.js";
 import { NativeTerminalScreen } from "./terminal-screen.js";
 import { WorkerOutputView } from "./WorkerOutputView.js";
 import { compactEndByDisplayWidth, displayWidth, wrapByDisplayWidth } from "./display-width.js";
-import { isAttachShortcut, isCopyShortcut, isDiagnosticsShortcut, isExitShortcut, isLogsShortcut, isNewConversationShortcut, isRouterDiagnosticsShortcut, isStatusDetailsShortcut, isTaskResultShortcut, isTaskSessionsShortcut, isWorkerOverviewShortcut, isWorkerSearchShortcut, isWorkspaceShortcut, mouseScrollDelta, rawChatScrollArrowDelta, rawHistoryDelta, rawPageScrollDelta, rawPlainArrowDelta, scrollDelta, workerLogJumpKind } from "./keyboard.js";
+import { isAttachShortcut, isCopyShortcut, isDiagnosticsShortcut, isExitShortcut, isLogsShortcut, isNewConversationShortcut, isRoleConfigurationShortcut, isRouterDiagnosticsShortcut, isStatusDetailsShortcut, isTaskResultShortcut, isTaskSessionsShortcut, isWorkerOverviewShortcut, isWorkerSearchShortcut, isWorkspaceShortcut, mouseScrollDelta, rawChatScrollArrowDelta, rawHistoryDelta, rawHorizontalArrowDelta, rawPageScrollDelta, rawPlainArrowDelta, scrollDelta, workerLogJumpKind } from "./keyboard.js";
 import { createRawInputDecoder, tokenizeRawInput } from "./raw-input-decoder.js";
 import { decodeHtmlEntities } from "./markdown-text.js";
 import { configureTuiTheme, TUI_THEME } from "./theme.js";
@@ -35,6 +36,8 @@ import { latestTaskResultMessageIndex, parseTaskResultSummary } from "./task-res
 import { buildNativeAttachLaunch, buildNativeForkLaunch, startNativeAttachProcess } from "../workers/native-attach.js";
 import { assignableWorkerProviderIds, workerProviderLabel, workerProviders } from "../workers/provider.js";
 import { StatusDetailView } from "./StatusDetailView.js";
+import { RoleConfigurationView } from "./RoleConfigurationView.js";
+import { cycleRoleProvider, moveRoleConfigurationSelection, nextRoleConfigurationScope, roleConfigurationScopeHasOverride, roleConfigurationSelectionForScope, selectedConfigurableRole, updateRoleModel } from "./role-configuration-state.js";
 import { runtimeConfigChange } from "./runtime-config-state.js";
 export function routeDecisionChatMessage(route) {
     return `route · ${route.mode} · ${route.source ?? "router"}\n${route.reason.trim()}`;
@@ -77,6 +80,15 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
     const [canRetryTask, setCanRetryTask] = useState(initialCanRetryTask);
     const [attachError, setAttachError] = useState(null);
     const [configChange, setConfigChange] = useState(null);
+    const [roleConfigurationSnapshot, setRoleConfigurationSnapshot] = useState(null);
+    const [roleConfigurationDraft, setRoleConfigurationDraft] = useState(null);
+    const [roleConfigurationScope, setRoleConfigurationScope] = useState("next");
+    const [roleConfigurationSelectedIndex, setRoleConfigurationSelectedIndex] = useState(0);
+    const [roleConfigurationLoading, setRoleConfigurationLoading] = useState(false);
+    const [roleConfigurationSaving, setRoleConfigurationSaving] = useState(false);
+    const [roleConfigurationNotice, setRoleConfigurationNotice] = useState(null);
+    const [roleConfigurationError, setRoleConfigurationError] = useState(null);
+    const [roleModelEdit, setRoleModelEdit] = useState(null);
     const [clipboardNotice, setClipboardNotice] = useState(null);
     const [nativeInput, setNativeInput] = useState("");
     const [workerScrollOffset, setWorkerScrollOffset] = useState(0);
@@ -169,6 +181,13 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
     const featureBoardSelectedIndexRef = useRef(0);
     const featureCancelPromptRef = useRef(null);
     const featureAssignmentPromptRef = useRef(null);
+    const roleConfigurationSnapshotRef = useRef(null);
+    const roleConfigurationDraftRef = useRef(null);
+    const roleConfigurationScopeRef = useRef("next");
+    const roleConfigurationSelectedIndexRef = useRef(0);
+    const roleConfigurationLoadingRef = useRef(false);
+    const roleConfigurationSavingRef = useRef(false);
+    const roleModelEditRef = useRef(null);
     const collaborationFeatureIndexRef = useRef(-1);
     const collaborationSelectedEventIdRef = useRef(null);
     const collaborationDetailOpenRef = useRef(false);
@@ -188,6 +207,9 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
     const confirmFeatureCancellationRef = useRef(confirmFeatureCancellation);
     const reassignSelectedFeatureRef = useRef(reassignSelectedFeature);
     const openCollaborationTimelineRef = useRef(openCollaborationTimeline);
+    const openRoleConfigurationRef = useRef(openRoleConfiguration);
+    const applyRoleConfigurationRef = useRef(applyRoleConfiguration);
+    const clearRoleConfigurationRef = useRef(clearRoleConfiguration);
     const refreshCollaborationTimelineRef = useRef(refreshCollaborationTimeline);
     const activateSelectedTaskSessionRef = useRef(activateSelectedTaskSession);
     const refreshTaskSessionsRef = useRef(refreshTaskSessions);
@@ -213,6 +235,8 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
     const taskSessionsReturnViewRef = useRef("chat");
     const collaborationReturnViewRef = useRef("workers");
     const statusReturnViewRef = useRef("chat");
+    const roleConfigurationReturnViewRef = useRef("chat");
+    const roleConfigurationLoadSequenceRef = useRef(0);
     const collaborationLoadSequenceRef = useRef(0);
     const routerLoadSequenceRef = useRef(0);
     const taskSessionsLoadSequenceRef = useRef(0);
@@ -256,6 +280,14 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
     const taskResultMessageIndex = useMemo(() => activeTaskId ? latestTaskResultMessageIndex(messages, activeTaskId) : -1, [activeTaskId, messages]);
     const visibleChatMessages = useMemo(() => routeAnnouncement ? [...messages, routeAnnouncement] : messages, [messages, routeAnnouncement]);
     const hasTaskResult = taskResultMessageIndex >= 0;
+    const activeRoleSelection = roleConfigurationSnapshot
+        ? activeTaskId
+            ? roleConfigurationSnapshot.activeTurn
+                ?? roleConfigurationSnapshot.task
+                ?? roleConfigurationSnapshot.future
+            : roleConfigurationSnapshot.future
+        : configuredRoleSelection(config);
+    const roleConfigurationHasOverride = roleConfigurationScopeHasOverride(roleConfigurationSnapshot, roleConfigurationScope);
     useEffect(() => {
         inputRef.current = input;
     }, [input]);
@@ -325,6 +357,54 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
     useEffect(() => {
         canRetryTaskRef.current = canRetryTask;
     }, [canRetryTask]);
+    useEffect(() => {
+        roleConfigurationSnapshotRef.current = roleConfigurationSnapshot;
+    }, [roleConfigurationSnapshot]);
+    useEffect(() => {
+        roleConfigurationDraftRef.current = roleConfigurationDraft;
+    }, [roleConfigurationDraft]);
+    useEffect(() => {
+        roleConfigurationScopeRef.current = roleConfigurationScope;
+    }, [roleConfigurationScope]);
+    useEffect(() => {
+        roleConfigurationSelectedIndexRef.current = roleConfigurationSelectedIndex;
+    }, [roleConfigurationSelectedIndex]);
+    useEffect(() => {
+        roleConfigurationLoadingRef.current = roleConfigurationLoading;
+    }, [roleConfigurationLoading]);
+    useEffect(() => {
+        roleConfigurationSavingRef.current = roleConfigurationSaving;
+    }, [roleConfigurationSaving]);
+    useEffect(() => {
+        roleModelEditRef.current = roleModelEdit;
+    }, [roleModelEdit]);
+    useEffect(() => {
+        let active = true;
+        const sequence = roleConfigurationLoadSequenceRef.current + 1;
+        roleConfigurationLoadSequenceRef.current = sequence;
+        const snapshotPromise = typeof orchestrator.roleConfigurationSnapshot === "function"
+            ? orchestrator.roleConfigurationSnapshot(activeTaskId)
+            : Promise.resolve(fallbackRoleConfigurationSnapshot(config));
+        void snapshotPromise.then((snapshot) => {
+            if (!active || roleConfigurationLoadSequenceRef.current !== sequence) {
+                return;
+            }
+            roleConfigurationSnapshotRef.current = snapshot;
+            setRoleConfigurationSnapshot(snapshot);
+            if (viewRef.current === "roles") {
+                const draft = roleConfigurationSelectionForScope(snapshot, roleConfigurationScopeRef.current);
+                roleConfigurationDraftRef.current = draft;
+                setRoleConfigurationDraft(draft);
+            }
+        }).catch((error) => {
+            if (active && roleConfigurationLoadSequenceRef.current === sequence) {
+                setRoleConfigurationError(error instanceof Error ? error.message : String(error));
+            }
+        });
+        return () => {
+            active = false;
+        };
+    }, [activeTaskId, orchestrator]);
     useEffect(() => {
         taskResultExpandedRef.current = taskResultExpanded;
     }, [taskResultExpanded]);
@@ -433,6 +513,9 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
         openWorkerOverviewRef.current = openWorkerOverview;
         openTaskSessionsRef.current = openTaskSessions;
         openFeatureBoardRef.current = openFeatureBoard;
+        openRoleConfigurationRef.current = openRoleConfiguration;
+        applyRoleConfigurationRef.current = applyRoleConfiguration;
+        clearRoleConfigurationRef.current = clearRoleConfiguration;
         confirmFeatureCancellationRef.current = confirmFeatureCancellation;
         openCollaborationTimelineRef.current = openCollaborationTimeline;
         refreshCollaborationTimelineRef.current = refreshCollaborationTimeline;
@@ -828,6 +911,137 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             if (currentView === "workspace") {
                 return;
             }
+            if (currentView !== "native"
+                && tokenizeRawInput(chunk).some((inputChunk) => isRoleConfigurationShortcut(inputChunk, {}))
+                && !busyRef.current) {
+                if (currentView === "roles") {
+                    roleModelEditRef.current = null;
+                    setRoleModelEdit(null);
+                    viewRef.current = roleConfigurationReturnViewRef.current;
+                    setView(roleConfigurationReturnViewRef.current);
+                }
+                else {
+                    void openRoleConfigurationRef.current();
+                }
+                return;
+            }
+            if (currentView === "roles") {
+                const roleChunks = tokenizeRawInput(chunk);
+                if (roleChunks.some((roleChunk) => isExitShortcut(roleChunk, {}))) {
+                    activeRunControllerRef.current?.abort();
+                    exitRef.current();
+                    return;
+                }
+                if (roleChunks.some((roleChunk) => isStatusDetailsShortcut(roleChunk, {}))) {
+                    statusReturnViewRef.current = "roles";
+                    viewRef.current = "status";
+                    setView("status");
+                    return;
+                }
+                for (const roleChunk of roleChunks) {
+                    const edit = roleModelEditRef.current;
+                    if (edit) {
+                        if (roleChunk === "\x1b") {
+                            roleModelEditRef.current = null;
+                            setRoleModelEdit(null);
+                            continue;
+                        }
+                        const update = applyChatInputChunk(edit.value, roleChunk, edit.cursor);
+                        if (update.submit !== null) {
+                            const draft = roleConfigurationDraftRef.current;
+                            if (draft) {
+                                const nextDraft = updateRoleModel(draft, edit.role, update.submit);
+                                roleConfigurationDraftRef.current = nextDraft;
+                                setRoleConfigurationDraft(nextDraft);
+                            }
+                            roleModelEditRef.current = null;
+                            setRoleModelEdit(null);
+                        }
+                        else {
+                            const nextEdit = { ...edit, value: update.value, cursor: update.cursor };
+                            roleModelEditRef.current = nextEdit;
+                            setRoleModelEdit(nextEdit);
+                        }
+                        continue;
+                    }
+                    if (roleChunk === "\x1b") {
+                        viewRef.current = roleConfigurationReturnViewRef.current;
+                        setView(roleConfigurationReturnViewRef.current);
+                        return;
+                    }
+                    if (roleConfigurationLoadingRef.current || roleConfigurationSavingRef.current) {
+                        continue;
+                    }
+                    if (roleChunk === "\t") {
+                        const nextScope = nextRoleConfigurationScope(roleConfigurationScopeRef.current, 1, Boolean(activeTaskIdRef.current));
+                        roleConfigurationScopeRef.current = nextScope;
+                        setRoleConfigurationScope(nextScope);
+                        const snapshot = roleConfigurationSnapshotRef.current;
+                        if (snapshot) {
+                            const draft = roleConfigurationSelectionForScope(snapshot, nextScope);
+                            roleConfigurationDraftRef.current = draft;
+                            setRoleConfigurationDraft(draft);
+                        }
+                        setRoleConfigurationNotice(null);
+                        setRoleConfigurationError(null);
+                        continue;
+                    }
+                    const selectionDelta = -(rawHistoryDelta(roleChunk)
+                        + rawPageScrollDelta(roleChunk, CONFIGURABLE_ROLES.length)
+                        + mouseScrollDelta(roleChunk, 1));
+                    if (selectionDelta !== 0) {
+                        const nextIndex = moveRoleConfigurationSelection(roleConfigurationSelectedIndexRef.current, selectionDelta);
+                        roleConfigurationSelectedIndexRef.current = nextIndex;
+                        setRoleConfigurationSelectedIndex(nextIndex);
+                        continue;
+                    }
+                    const providerDelta = rawHorizontalArrowDelta(roleChunk)
+                        || (roleChunk === "]" ? 1 : roleChunk === "[" ? -1 : 0);
+                    if (providerDelta !== 0) {
+                        const snapshot = roleConfigurationSnapshotRef.current;
+                        const draft = roleConfigurationDraftRef.current;
+                        if (snapshot && draft) {
+                            const nextDraft = cycleRoleProvider(draft, selectedConfigurableRole(roleConfigurationSelectedIndexRef.current), snapshot.providers, providerDelta);
+                            roleConfigurationDraftRef.current = nextDraft;
+                            setRoleConfigurationDraft(nextDraft);
+                            setRoleConfigurationNotice(null);
+                            setRoleConfigurationError(null);
+                        }
+                        continue;
+                    }
+                    if (roleChunk === "m" || roleChunk === "M") {
+                        const role = selectedConfigurableRole(roleConfigurationSelectedIndexRef.current);
+                        const value = roleConfigurationDraftRef.current?.[role].model ?? "";
+                        const editState = {
+                            role,
+                            value,
+                            cursor: Array.from(value).length
+                        };
+                        roleModelEditRef.current = editState;
+                        setRoleModelEdit(editState);
+                        continue;
+                    }
+                    if (roleChunk === "\r" || roleChunk === "\n") {
+                        void applyRoleConfigurationRef.current();
+                        return;
+                    }
+                    if (roleChunk === "x" || roleChunk === "X") {
+                        void clearRoleConfigurationRef.current();
+                        return;
+                    }
+                    if (roleChunk === "r" || roleChunk === "R") {
+                        const snapshot = roleConfigurationSnapshotRef.current;
+                        if (snapshot) {
+                            const draft = roleConfigurationSelectionForScope(snapshot, roleConfigurationScopeRef.current);
+                            roleConfigurationDraftRef.current = draft;
+                            setRoleConfigurationDraft(draft);
+                            setRoleConfigurationNotice("Draft restored from saved configuration");
+                            setRoleConfigurationError(null);
+                        }
+                    }
+                }
+                return;
+            }
             if (currentView === "status") {
                 if (isExitShortcut(chunk, {})) {
                     activeRunControllerRef.current?.abort();
@@ -1841,6 +2055,15 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
                     .join("\n")
             };
         }
+        if (currentView === "roles") {
+            const roles = roleConfigurationDraftRef.current;
+            return {
+                label: "role configuration",
+                text: roles
+                    ? CONFIGURABLE_ROLES.map((role) => `${role} · ${roles[role].engine} · ${roles[role].model || "default"}`).join("\n")
+                    : ""
+            };
+        }
         if (currentView === "workers") {
             return {
                 label: "workers",
@@ -2187,6 +2410,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
                     cwd,
                     taskId: target.taskId,
                     route: followUpRoute?.route,
+                    roleSelection: followUpRoute?.roleSelection,
                     ...callbacks
                 })
                 : target.kind === "task-question"
@@ -2195,6 +2419,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
                         cwd,
                         taskId: target.taskId,
                         route: followUpRoute?.route,
+                        roleSelection: followUpRoute?.roleSelection,
                         ...callbacks
                     })
                     : await orchestrator.handleRequest({
@@ -2209,6 +2434,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             setCanRetryTask(nextMemory.activeTaskId
                 ? await orchestrator.canRetryTask(nextMemory.activeTaskId)
                 : false);
+            await refreshRoleConfigurationState(nextMemory.activeTaskId);
             setRouteAnnouncement(null);
             await appendVisibleMessage({ from: "system", text: result.summary }, nextMemory.activeTaskId ?? undefined);
             if (result.mode === "complex" && parseTaskResultSummary(result.summary)) {
@@ -2221,6 +2447,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             if (retryTaskId) {
                 setCanRetryTask(await orchestrator.canRetryTask(retryTaskId));
             }
+            await refreshRoleConfigurationState(retryTaskId);
             await appendVisibleMessage({
                 from: "system",
                 text: isAbortError(error) ? "cancelled · request stopped" : error instanceof Error ? error.message : String(error)
@@ -2268,6 +2495,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             setActiveTaskId(taskId);
             setActiveMode("complex");
             setCanRetryTask(false);
+            await refreshRoleConfigurationState(taskId);
             setRouteAnnouncement(null);
             await appendVisibleMessage({ from: "system", text: result.summary }, taskId);
             if (parseTaskResultSummary(result.summary)) {
@@ -2277,6 +2505,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
         catch (error) {
             setRouteAnnouncement(null);
             setCanRetryTask(await orchestrator.canRetryTask(taskId));
+            await refreshRoleConfigurationState(taskId);
             await appendVisibleMessage({
                 from: "system",
                 text: isAbortError(error) ? "cancelled · retry stopped" : error instanceof Error ? error.message : String(error)
@@ -2305,6 +2534,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             return;
         }
         resetActiveTaskUiForMainConversation();
+        await refreshRoleConfigurationState(null);
         await appendVisibleMessage({ from: "system", text: "new conversation · ready" });
     }
     function resetActiveTaskUiForMainConversation() {
@@ -3070,6 +3300,153 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
         setAttachError(null);
         setView("workers");
     }
+    async function refreshRoleConfigurationState(taskId) {
+        try {
+            const snapshot = typeof orchestrator.roleConfigurationSnapshot === "function"
+                ? await orchestrator.roleConfigurationSnapshot(taskId)
+                : fallbackRoleConfigurationSnapshot(config);
+            roleConfigurationSnapshotRef.current = snapshot;
+            setRoleConfigurationSnapshot(snapshot);
+            if (viewRef.current === "roles") {
+                const draft = roleConfigurationSelectionForScope(snapshot, roleConfigurationScopeRef.current);
+                roleConfigurationDraftRef.current = draft;
+                setRoleConfigurationDraft(draft);
+            }
+        }
+        catch (error) {
+            setRoleConfigurationError(error instanceof Error ? error.message : String(error));
+        }
+    }
+    async function openRoleConfiguration() {
+        const currentView = viewRef.current;
+        if (busyRef.current || currentView === "native" || currentView === "workspace") {
+            return;
+        }
+        const returnView = currentView === "roles" ? roleConfigurationReturnViewRef.current : currentView;
+        roleConfigurationReturnViewRef.current = returnView;
+        const scope = roleConfigurationScopeRef.current === "task" && !activeTaskIdRef.current
+            ? "next"
+            : roleConfigurationScopeRef.current;
+        roleConfigurationScopeRef.current = scope;
+        setRoleConfigurationScope(scope);
+        roleModelEditRef.current = null;
+        setRoleModelEdit(null);
+        setRoleConfigurationNotice(null);
+        setRoleConfigurationError(null);
+        roleConfigurationLoadingRef.current = true;
+        setRoleConfigurationLoading(true);
+        viewRef.current = "roles";
+        setView("roles");
+        const sequence = roleConfigurationLoadSequenceRef.current + 1;
+        roleConfigurationLoadSequenceRef.current = sequence;
+        try {
+            const snapshot = typeof orchestrator.roleConfigurationSnapshot === "function"
+                ? await orchestrator.roleConfigurationSnapshot(activeTaskIdRef.current)
+                : fallbackRoleConfigurationSnapshot(config);
+            if (!mountedRef.current || roleConfigurationLoadSequenceRef.current !== sequence) {
+                return;
+            }
+            roleConfigurationSnapshotRef.current = snapshot;
+            setRoleConfigurationSnapshot(snapshot);
+            const draft = roleConfigurationSelectionForScope(snapshot, scope);
+            roleConfigurationDraftRef.current = draft;
+            setRoleConfigurationDraft(draft);
+        }
+        catch (error) {
+            if (mountedRef.current && roleConfigurationLoadSequenceRef.current === sequence) {
+                setRoleConfigurationError(error instanceof Error ? error.message : String(error));
+            }
+        }
+        finally {
+            if (mountedRef.current && roleConfigurationLoadSequenceRef.current === sequence) {
+                roleConfigurationLoadingRef.current = false;
+                setRoleConfigurationLoading(false);
+            }
+        }
+    }
+    async function applyRoleConfiguration() {
+        const draft = roleConfigurationDraftRef.current;
+        if (!draft || roleConfigurationSavingRef.current || roleConfigurationLoadingRef.current) {
+            return;
+        }
+        const scope = roleConfigurationScopeRef.current;
+        const taskId = activeTaskIdRef.current;
+        if (scope === "task" && !taskId) {
+            setRoleConfigurationError("No active Task · choose next request or future requests");
+            return;
+        }
+        roleConfigurationSavingRef.current = true;
+        setRoleConfigurationSaving(true);
+        setRoleConfigurationNotice(null);
+        setRoleConfigurationError(null);
+        try {
+            if (typeof orchestrator.updateRoleConfiguration !== "function") {
+                throw new Error("Role configuration is unavailable in this runtime");
+            }
+            const snapshot = await orchestrator.updateRoleConfiguration({
+                scope,
+                roles: draft,
+                taskId
+            });
+            roleConfigurationSnapshotRef.current = snapshot;
+            setRoleConfigurationSnapshot(snapshot);
+            const saved = roleConfigurationSelectionForScope(snapshot, scope);
+            roleConfigurationDraftRef.current = saved;
+            setRoleConfigurationDraft(saved);
+            setRoleConfigurationNotice(scope === "next"
+                ? "Saved · the next request will consume this matrix once"
+                : scope === "task"
+                    ? "Saved · current Task retries and follow-ups will use this matrix"
+                    : "Saved · future requests now use this default matrix");
+            if (scope === "task" && taskId) {
+                void refreshCollaborationTimelineRef.current(false);
+            }
+        }
+        catch (error) {
+            setRoleConfigurationError(error instanceof Error ? error.message : String(error));
+        }
+        finally {
+            roleConfigurationSavingRef.current = false;
+            setRoleConfigurationSaving(false);
+        }
+    }
+    async function clearRoleConfiguration() {
+        if (roleConfigurationSavingRef.current || roleConfigurationLoadingRef.current) {
+            return;
+        }
+        const scope = roleConfigurationScopeRef.current;
+        const taskId = activeTaskIdRef.current;
+        if (scope === "task" && !taskId) {
+            setRoleConfigurationError("No active Task · choose next request or future requests");
+            return;
+        }
+        roleConfigurationSavingRef.current = true;
+        setRoleConfigurationSaving(true);
+        setRoleConfigurationNotice(null);
+        setRoleConfigurationError(null);
+        try {
+            if (typeof orchestrator.clearRoleConfiguration !== "function") {
+                throw new Error("Role configuration is unavailable in this runtime");
+            }
+            const snapshot = await orchestrator.clearRoleConfiguration(scope, taskId);
+            roleConfigurationSnapshotRef.current = snapshot;
+            setRoleConfigurationSnapshot(snapshot);
+            const inherited = roleConfigurationSelectionForScope(snapshot, scope);
+            roleConfigurationDraftRef.current = inherited;
+            setRoleConfigurationDraft(inherited);
+            setRoleConfigurationNotice(scope === "future" ? "Reset · future requests inherit config.toml" : "Reset · scope now inherits future defaults");
+            if (scope === "task" && taskId) {
+                void refreshCollaborationTimelineRef.current(false);
+            }
+        }
+        catch (error) {
+            setRoleConfigurationError(error instanceof Error ? error.message : String(error));
+        }
+        finally {
+            roleConfigurationSavingRef.current = false;
+            setRoleConfigurationSaving(false);
+        }
+    }
     function openWorkspacePicker() {
         const currentView = viewRef.current;
         if (busyRef.current || !switchWorkspace || currentView === "native" || currentView === "workspace") {
@@ -3113,11 +3490,11 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
                         ? { type: "delete", title: taskSessionAction.title }
                         : null, taskSessionsIncludeArchived: sessionCenterMode === "conversations"
                 ? mainConversationsIncludeArchived
-                : taskSessionsIncludeArchived, mainConversationSessions: sessionCenterMode === "conversations" && !taskSessionDetails, taskSessionDetail: Boolean(taskSessionDetails), taskSessionDetailHasNative: taskSessionDetailHasNative, taskSessionDetailCanFork: taskSessionDetailCanFork, canRetry: canRetryTask, hasWorkers: workers.length > 0, hasActiveTask: Boolean(activeTaskId), hasTaskResult: hasTaskResult, taskResultExpanded: taskResultExpanded, chatScrollOffset: chatScrollOffset, chatMaxScrollOffset: chatMaxScrollOffset, nativeClosed: view === "native" && nativeAttach?.closedCode !== null, searchMatchIndex: workerSearch.matchIndex, searchMatchCount: workerNavigationTargets.searchOffsets.length, clipboardNotice: clipboardNotice, value: workerSearch.open && view === "worker"
+                : taskSessionsIncludeArchived, mainConversationSessions: sessionCenterMode === "conversations" && !taskSessionDetails, taskSessionDetail: Boolean(taskSessionDetails), taskSessionDetailHasNative: taskSessionDetailHasNative, taskSessionDetailCanFork: taskSessionDetailCanFork, canRetry: canRetryTask, hasWorkers: workers.length > 0, hasActiveTask: Boolean(activeTaskId), hasTaskResult: hasTaskResult, taskResultExpanded: taskResultExpanded, chatScrollOffset: chatScrollOffset, chatMaxScrollOffset: chatMaxScrollOffset, nativeClosed: view === "native" && nativeAttach?.closedCode !== null, searchMatchIndex: workerSearch.matchIndex, searchMatchCount: workerNavigationTargets.searchOffsets.length, clipboardNotice: clipboardNotice, roleScope: roleConfigurationScope, roleEditingModel: roleModelEdit, roleCanApply: roleConfigurationScope !== "task" || Boolean(activeTaskId), roleSaving: roleConfigurationSaving, roleHasOverride: roleConfigurationHasOverride, value: workerSearch.open && view === "worker"
                 ? workerSearch.query
-                : view === "native" || view === "router" || view === "workers" || view === "features" || view === "sessions" || view === "collaboration" || view === "status" ? "" : input, cursor: workerSearch.open && view === "worker"
+                : view === "native" || view === "router" || view === "workers" || view === "features" || view === "sessions" || view === "collaboration" || view === "status" || view === "roles" ? "" : input, cursor: workerSearch.open && view === "worker"
                 ? workerSearch.cursor
-                : view === "chat" ? inputCursor : undefined, terminalWidth: terminalWidth, onChange: view === "native" ? setNativeInput : setInput, onSubmit: view === "native" ? undefined : submit }), error: attachError, children: view === "status" ? (_jsx(StatusDetailView, { cwd: cwd, taskId: activeTaskId, mode: activeMode, busy: busy, canRetry: canRetryTask, taskStatus: visibleTaskStatus, routeStatus: visibleRouteStatus, routeReason: routePending ? undefined : lastRoute?.reason, pairing: config.pairing, configStatus: configChange?.detail, configRestartRequired: configChange?.kind === "restart", workers: workers, selectedWorkerIndex: selectedWorkerIndex, height: contentHeight, terminalWidth: terminalWidth })) : view === "native" ? (_jsx(NativeAttachView, { attach: nativeAttach, viewportHeight: contentHeight })) : view === "sessions" ? (taskSessionDetails ? (_jsx(TaskSessionDetailView, { details: taskSessionDetails, selectedWorkerIndex: taskSessionDetailSelectedWorkerIndex, loading: taskSessionsLoading, error: taskSessionsError, notice: taskSessionDetailNotice, height: contentHeight, terminalWidth: terminalWidth })) : sessionCenterMode === "conversations" ? (_jsx(MainConversationsView, { conversations: mainConversations, selectedIndex: selectedMainConversationIndex, includeArchived: mainConversationsIncludeArchived, notice: taskSessionsNotice, action: mainConversationAction?.type === "rename"
+                : view === "chat" ? inputCursor : undefined, terminalWidth: terminalWidth, onChange: view === "native" ? setNativeInput : setInput, onSubmit: view === "native" ? undefined : submit }), error: attachError, children: view === "roles" ? (_jsx(RoleConfigurationView, { snapshot: roleConfigurationSnapshot, draft: roleConfigurationDraft, scope: roleConfigurationScope, selectedRoleIndex: roleConfigurationSelectedIndex, loading: roleConfigurationLoading, saving: roleConfigurationSaving, notice: roleConfigurationNotice, error: roleConfigurationError, hasActiveTask: Boolean(activeTaskId), height: contentHeight, terminalWidth: terminalWidth })) : view === "status" ? (_jsx(StatusDetailView, { cwd: cwd, taskId: activeTaskId, mode: activeMode, busy: busy, canRetry: canRetryTask, taskStatus: visibleTaskStatus, routeStatus: visibleRouteStatus, routeReason: routePending ? undefined : lastRoute?.reason, pairing: config.pairing, roleSelection: activeRoleSelection, configStatus: configChange?.detail, configRestartRequired: configChange?.kind === "restart", workers: workers, selectedWorkerIndex: selectedWorkerIndex, height: contentHeight, terminalWidth: terminalWidth })) : view === "native" ? (_jsx(NativeAttachView, { attach: nativeAttach, viewportHeight: contentHeight })) : view === "sessions" ? (taskSessionDetails ? (_jsx(TaskSessionDetailView, { details: taskSessionDetails, selectedWorkerIndex: taskSessionDetailSelectedWorkerIndex, loading: taskSessionsLoading, error: taskSessionsError, notice: taskSessionDetailNotice, height: contentHeight, terminalWidth: terminalWidth })) : sessionCenterMode === "conversations" ? (_jsx(MainConversationsView, { conversations: mainConversations, selectedIndex: selectedMainConversationIndex, includeArchived: mainConversationsIncludeArchived, notice: taskSessionsNotice, action: mainConversationAction?.type === "rename"
                 ? { type: "rename", title: mainConversationAction.title }
                 : mainConversationAction?.type === "delete"
                     ? { type: "delete", title: mainConversationAction.title }
@@ -3154,6 +3531,22 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
                 }
             } })) }));
 }
+function fallbackRoleConfigurationSnapshot(config) {
+    const roles = configuredRoleSelection(config);
+    return {
+        baseline: roles,
+        future: configuredRoleSelection(config),
+        next: null,
+        task: null,
+        activeTurn: null,
+        providers: workerProviders(config).map(({ id, config: provider }) => ({
+            id,
+            model: provider.model.name,
+            modelProvider: provider.model.provider,
+            assignable: provider.assignable
+        }))
+    };
+}
 function readTerminalSize() {
     return {
         columns: Math.max(1, Math.trunc(process.stdout.columns || 120)),

package/dist/tui/AppShell.js

@@ -236,6 +236,9 @@ function viewLabel(view) {
     return shortViewLabel(view);
 }
 function shortcutHint(view) {
+    if (view === "roles") {
+        return "^E back";
+    }
     if (view === "status") {
         return "^S back";
     }
@@ -245,6 +248,9 @@ function shortcutHint(view) {
     return "^S status · ^C exit";
 }
 function shortViewLabel(view) {
+    if (view === "roles") {
+        return "roles";
+    }
     if (view === "status") {
         return "status";
     }
@@ -272,7 +278,7 @@ function shortViewLabel(view) {
     return "chat";
 }
 function shortShortcutHint(view) {
-    return view === "native" ? "^]" : view === "status" ? "^S" : "^C";
+    return view === "native" ? "^]" : view === "status" ? "^S" : view === "roles" ? "^E" : "^C";
 }
 function compactHeaderProject(cwd, maxLength) {
     const project = basename(cwd) || cwd;

package/dist/tui/InputBar.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { Box, Text } from "ink";
 import { compactEndByDisplayWidth, compactTailByDisplayWidth, displayWidth } from "./display-width.js";
 import { TUI_THEME } from "./theme.js";
-export function InputBar({ mode, ready = true, busy = false, routeFallback = false, collaborationDetail = false, collaborationUnresolved = false, collaborationBack = "workers", featureCanCancel = false, featureCanPause = false, featureCanReassign = false, featureCancelConfirm = false, featurePauseConfirm = false, featureAssignment = false, taskSessionAction = null, taskSessionsIncludeArchived = false, mainConversationSessions = false, taskSessionDetail = false, taskSessionDetailHasNative = false, taskSessionDetailCanFork = false, canRetry = false, hasWorkers = false, hasActiveTask = false, hasTaskResult = false, taskResultExpanded = false, chatScrollOffset = 0, chatMaxScrollOffset = 0, nativeClosed = false, searchMatchIndex = 0, searchMatchCount = 0, clipboardNotice = null, value, cursor, terminalWidth: providedTerminalWidth, onChange, onSubmit }) {
+export function InputBar({ mode, ready = true, busy = false, routeFallback = false, collaborationDetail = false, collaborationUnresolved = false, collaborationBack = "workers", featureCanCancel = false, featureCanPause = false, featureCanReassign = false, featureCancelConfirm = false, featurePauseConfirm = false, featureAssignment = false, taskSessionAction = null, taskSessionsIncludeArchived = false, mainConversationSessions = false, taskSessionDetail = false, taskSessionDetailHasNative = false, taskSessionDetailCanFork = false, canRetry = false, hasWorkers = false, hasActiveTask = false, hasTaskResult = false, taskResultExpanded = false, chatScrollOffset = 0, chatMaxScrollOffset = 0, nativeClosed = false, searchMatchIndex = 0, searchMatchCount = 0, clipboardNotice = null, roleScope = "next", roleEditingModel = null, roleCanApply = true, roleSaving = false, roleHasOverride = false, value, cursor, terminalWidth: providedTerminalWidth, onChange, onSubmit }) {
     const terminalWidth = providedTerminalWidth ?? process.stdout.columns ?? 120;
     const fillRail = providedTerminalWidth !== undefined || typeof process.stdout.columns === "number";
     if (clipboardNotice) {
@@ -19,6 +19,17 @@ export function InputBar({ mode, ready = true, busy = false, routeFallback = fal
         const textWidth = displayWidth(`${prefix}${display.before}|${display.after}${suffix}`);
         return (_jsxs(InputRail, { terminalWidth: terminalWidth, textWidth: textWidth, fill: fillRail, children: [_jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.accent, bold: true, children: prefix }), _jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.text, children: display.before }), _jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.accent, bold: true, children: "|" }), _jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.text, children: display.after }), suffix ? _jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.muted, children: suffix }) : null] }));
     }
+    if (mode === "roles") {
+        if (roleEditingModel) {
+            const prefix = `${roleEditingModel.role} model > `;
+            const valueWidth = Math.max(1, terminalWidth - displayWidth(prefix) - 3);
+            const display = chatInputDisplayParts(roleEditingModel.value, roleEditingModel.cursor, valueWidth);
+            const textWidth = displayWidth(`${prefix}${display.before}|${display.after}`);
+            return (_jsxs(InputRail, { terminalWidth: terminalWidth, textWidth: textWidth, fill: fillRail, children: [_jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.accent, bold: true, children: prefix }), _jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.text, children: display.before }), _jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.accent, bold: true, children: "|" }), _jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.text, children: display.after })] }));
+        }
+        const hints = roleConfigurationInputHints(terminalWidth, roleScope, roleCanApply, roleSaving, roleHasOverride);
+        return (_jsxs(InputRail, { terminalWidth: terminalWidth, textWidth: displayWidth(`${hints.label}${hints.detail}`), fill: fillRail, children: [_jsx(Text, { backgroundColor: TUI_THEME.rail, color: roleSaving ? TUI_THEME.warning : TUI_THEME.accent, bold: true, children: hints.label }), hints.detail ? _jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.muted, children: hints.detail }) : null] }));
+    }
     if (mode === "status") {
         const hints = statusDetailInputHints(terminalWidth);
         return (_jsxs(InputRail, { terminalWidth: terminalWidth, textWidth: displayWidth(`${hints.label}${hints.detail}`), fill: fillRail, children: [_jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.accent, bold: true, children: hints.label }), hints.detail ? _jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.muted, children: hints.detail }) : null] }));
@@ -422,14 +433,27 @@ function workerInputHints(width) {
 }
 function statusDetailInputHints(width) {
     return selectInputHints(width, [
-        { label: "status", detail: " · ^X diagnostics · ^S/Esc back · ^C exit" },
-        { label: "status", detail: " · ^X diag · ^S/Esc back · ^C exit" },
+        { label: "status", detail: " · ^E roles · ^X diagnostics · ^S/Esc back · ^C exit" },
+        { label: "status", detail: " · ^E roles · ^X diag · ^S/Esc back · ^C exit" },
         { label: "status", detail: " · ^S back · ^C exit" },
         { label: "status", detail: " · ^S back" },
         { label: "status", detail: "" },
         { label: "st", detail: "" }
     ]);
 }
+function roleConfigurationInputHints(width, scope, canApply, saving, hasOverride) {
+    const label = saving ? "roles · saving" : `roles · ${scope}`;
+    const apply = canApply ? "Enter apply" : "task unavailable";
+    const reset = hasOverride ? " · X reset" : "";
+    return selectInputHints(width, [
+        { label, detail: ` · Tab scope · Up/Dn role · Left/Right provider · M model · ${apply}${reset} · ^E/Esc back` },
+        { label, detail: ` · Tab scope · Up/Dn · Left/Right provider · M model · ${apply}${reset} · Esc back` },
+        { label, detail: ` · Tab · Up/Dn · Left/Right · M model · ${apply}${reset}` },
+        { label, detail: ` · Tab · arrows · M · ${canApply ? "Enter" : "no task"}` },
+        { label: "roles", detail: " · Tab · arrows · M · Enter" },
+        { label: "roles", detail: "" }
+    ]);
+}
 function workerOverviewInputHints(width) {
     if (width < 16) {
         return { label: "wrk", detail: "" };