parallel-codex-tui 0.2.10 → 0.3.1

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);
@@ -240,7 +264,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
         && (config.workers[selectedTaskSessionDetailWorker.engine]?.interactive.forkArgs.length ?? 0) > 0);
     const featureCanCancel = busy && (selectedBoardFeature?.state === "actor_running"
         || selectedBoardFeature?.state === "critic_running");
-    const featureCanReassign = assignableProviderIds.length > 1
+    const featureCanReassign = assignableProviderIds.length > 0
         && !busy
         && canRetryTask
         && selectedBoardFeature?.state !== "approved";
@@ -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();
@@ -1182,6 +1396,24 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
                 const pendingAssignment = featureAssignmentPromptRef.current;
                 if (pendingAssignment) {
                     for (const featureChunk of featureChunks) {
+                        const modelEdit = featureAssignmentPromptRef.current?.modelEdit;
+                        if (modelEdit) {
+                            if (featureChunk === "\x1b") {
+                                updateFeatureAssignmentPrompt({ ...pendingAssignment, modelEdit: undefined });
+                                continue;
+                            }
+                            const update = applyChatInputChunk(modelEdit.value, featureChunk, modelEdit.cursor);
+                            if (update.submit !== null) {
+                                void reassignSelectedFeatureRef.current(pendingAssignment, modelEdit.role, update.submit);
+                            }
+                            else {
+                                updateFeatureAssignmentPrompt({
+                                    ...pendingAssignment,
+                                    modelEdit: { ...modelEdit, value: update.value, cursor: update.cursor }
+                                });
+                            }
+                            continue;
+                        }
                         if (featureChunk === "\x1b" || featureChunk === "m" || featureChunk === "M") {
                             updateFeatureAssignmentPrompt(null);
                             setFeatureBoardNotice(null);
@@ -1195,6 +1427,16 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
                             void reassignSelectedFeatureRef.current(pendingAssignment, "critic");
                             return;
                         }
+                        if (featureChunk === "1" || featureChunk === "2") {
+                            const feature = collaborationTimelineRef.current?.features.find((item) => item.id === pendingAssignment.featureId);
+                            const role = featureChunk === "1" ? "actor" : "critic";
+                            const value = role === "actor" ? feature?.actorModel ?? "" : feature?.criticModel ?? "";
+                            updateFeatureAssignmentPrompt({
+                                ...pendingAssignment,
+                                modelEdit: { role, value, cursor: Array.from(value).length }
+                            });
+                            return;
+                        }
                     }
                     return;
                 }
@@ -1254,7 +1496,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
                             featureId: feature.id,
                             title: feature.title
                         });
-                        setFeatureBoardNotice(`Reassign ${feature.title} · A Actor (${feature.actorEngine ?? config.pairing.actor}) · C Critic (${feature.criticEngine ?? config.pairing.critic})`);
+                        setFeatureBoardNotice(`Reassign ${feature.title} · A Actor (${featureTargetDisplay(config, feature.actorEngine ?? config.pairing.actor, feature.actorModel)}) · C Critic (${featureTargetDisplay(config, feature.criticEngine ?? config.pairing.critic, feature.criticModel)})`);
                         return;
                     }
                     if (featureChunk === "r" || featureChunk === "R") {
@@ -1841,6 +2083,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 +2438,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 +2447,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 +2462,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 +2475,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 +2523,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 +2533,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 +2562,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() {
@@ -2857,7 +3115,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
         featureAssignmentPromptRef.current = next;
         setFeatureAssignmentPrompt(next);
     }
-    async function reassignSelectedFeature(prompt, role) {
+    async function reassignSelectedFeature(prompt, role, model) {
         const feature = collaborationTimelineRef.current?.features.find((item) => item.id === prompt.featureId);
         if (!feature) {
             setFeatureBoardNotice(`Feature no longer exists: ${prompt.featureId}`);
@@ -2867,15 +3125,22 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
         const current = role === "actor"
             ? feature.actorEngine ?? config.pairing.actor
             : feature.criticEngine ?? config.pairing.critic;
-        const engine = nextAssignableFeatureEngine(current, assignableProviderIds);
+        const engine = model === undefined
+            ? nextAssignableFeatureEngine(current, assignableProviderIds)
+            : current;
         try {
-            await orchestrator.reassignFeature({
+            const result = await orchestrator.reassignFeature({
                 taskId: prompt.taskId,
                 featureId: prompt.featureId,
                 role,
-                engine
+                engine,
+                ...(model === undefined ? {} : { model })
             });
-            setFeatureBoardNotice(`${role === "actor" ? "Actor" : "Critic"} reassigned to ${featureEngineDisplay(config, engine)} · Ctrl+R resumes the task.`);
+            updateFeatureAssignmentPrompt({ ...prompt, modelEdit: undefined });
+            const assignedModel = role === "actor"
+                ? result.assignment.actor_model
+                : result.assignment.critic_model;
+            setFeatureBoardNotice(`${role === "actor" ? "Actor" : "Critic"} reassigned to ${featureTargetDisplay(config, engine, assignedModel)} · Ctrl+R resumes the task.`);
             await refreshCollaborationTimeline(false);
         }
         catch (error) {
@@ -3070,6 +3335,159 @@ 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");
+            }
+            if (typeof orchestrator.validateRoleConfiguration === "function") {
+                const validation = await orchestrator.validateRoleConfiguration(draft);
+                if (!validation.ok) {
+                    throw new Error(formatRoleConfigurationPreflightFailure(validation.lines));
+                }
+            }
+            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") {
@@ -3101,7 +3519,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
     if (view === "workspace") {
         return (_jsx(Box, { flexDirection: "column", height: terminalSize.rows, children: _jsx(WorkspacePicker, { cwd: cwd, choices: workspaceChoices, terminalHeight: terminalSize.rows, terminalWidth: terminalWidth, onCancel: closeWorkspacePicker, onSelect: (workspace) => void selectWorkspace(workspace) }) }));
     }
-    return (_jsx(AppShell, { view: view, cwd: cwd, taskId: activeTaskId, statusText: [visibleTaskStatus, visibleRouteSummary, configChange?.compact].filter(Boolean).join(" | "), contentHeight: contentHeight, showStatusBar: config.ui.showStatusBar, input: _jsx(InputBar, { mode: view === "worker" && workerSearch.open ? "worker-search" : view, ready: inputReady, busy: busy, routeFallback: Boolean(routeFallbackPrompt), collaborationDetail: collaborationDetailOpen, collaborationUnresolved: collaborationUnresolvedOnly, collaborationBack: collaborationReturnViewRef.current, featureCanCancel: featureCanCancel, featureCanPause: featureCanCancel, featureCanReassign: featureCanReassign, featureCancelConfirm: featureCancelPrompt?.action === "cancel", featurePauseConfirm: featureCancelPrompt?.action === "pause", featureAssignment: Boolean(featureAssignmentPrompt), taskSessionAction: sessionCenterMode === "conversations"
+    return (_jsx(AppShell, { view: view, cwd: cwd, taskId: activeTaskId, statusText: [visibleTaskStatus, visibleRouteSummary, configChange?.compact].filter(Boolean).join(" | "), contentHeight: contentHeight, showStatusBar: config.ui.showStatusBar, input: _jsx(InputBar, { mode: view === "worker" && workerSearch.open ? "worker-search" : view, ready: inputReady, busy: busy, routeFallback: Boolean(routeFallbackPrompt), collaborationDetail: collaborationDetailOpen, collaborationUnresolved: collaborationUnresolvedOnly, collaborationBack: collaborationReturnViewRef.current, featureCanCancel: featureCanCancel, featureCanPause: featureCanCancel, featureCanReassign: featureCanReassign, featureCancelConfirm: featureCancelPrompt?.action === "cancel", featurePauseConfirm: featureCancelPrompt?.action === "pause", featureAssignment: Boolean(featureAssignmentPrompt), featureEditingModel: featureAssignmentPrompt?.modelEdit ?? null, taskSessionAction: sessionCenterMode === "conversations"
                 ? mainConversationAction?.type === "rename"
                     ? { type: "rename", value: mainConversationAction.value, cursor: mainConversationAction.cursor }
                     : mainConversationAction?.type === "delete"
@@ -3113,11 +3531,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, roleConfigurationSnapshot: roleConfigurationSnapshot, 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 +3572,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)),
@@ -3963,6 +4397,10 @@ function sessionDetailWorkerLabel(worker) {
 function featureEngineDisplay(config, engine) {
     return workerProviderLabel(config, engine);
 }
+function featureTargetDisplay(config, engine, model) {
+    const effectiveModel = model?.trim() || config.workers[engine]?.model.name || "default";
+    return `${featureEngineDisplay(config, engine)}/${effectiveModel}`;
+}
 function compactChatText(text, maxLength) {
     if (maxLength <= 5) {
         return takeChatTextStartByDisplayWidth(text, maxLength);
@@ -4352,6 +4790,15 @@ function compactNativeAttachRole(label) {
 function compactNativeSessionForTitle(sessionId, maxLength) {
     return compactEndByDisplayWidth(sessionId, Math.min(maxLength, 16));
 }
+export function formatRoleConfigurationPreflightFailure(lines) {
+    const clean = lines
+        .map((line) => line.replace(/[\u0000-\u001f\u007f]/g, " ").replace(/\s+/g, " ").trim())
+        .filter(Boolean);
+    const actionable = clean.filter((line) => (/\b(?:denied|error|failed|invalid|missing|unavailable|unsupported)\b/i.test(line)
+        || /\bnot (?:found|supported|available)\b/i.test(line)));
+    const detail = (actionable.length > 0 ? actionable : clean).slice(0, 4);
+    return ["Provider preflight failed", ...detail].join(" · ");
+}
 function isAbortError(error) {
     return error instanceof Error && error.name === "AbortError";
 }