pi-agent-flow 2.2.14 → 2.2.16

package/dist/flow/settings-command.js

@@ -7,16 +7,17 @@
  * When called with no arguments, opens an interactive TUI overlay.
  */
 import { DynamicBorder } from "@earendil-works/pi-coding-agent";
-import { loadFlowSettings, writeFlowSetting, loadFlowModelConfigs, writeGlobalFlowMode, writeFlowModelConfig } from "../config/config.js";
+import { loadFlowSettings, writeFlowSetting } from "../config/config.js";
 import { configureSteering } from "../steering/sliding-prompt.js";
 import { configureStrategicHint } from "../steering/tool-utils.js";
 import { scrambleManager } from "../tui/scramble/index.js";
-import { getLoop } from "./loop.js";
-import { Container, Input, matchesKey, SelectList, Key, Spacer, Text, truncateToWidth, visibleWidth, wrapTextWithAnsi, } from "@earendil-works/pi-tui";
-// Module-level refs for submenu builders (set during handler call)
-let _modelRegistry = null;
-let _theme = null;
-let _keybindings = null;
+import { Container, matchesKey, SelectList, Key, Spacer, Text, truncateToWidth, visibleWidth, wrapTextWithAnsi, } from "@earendil-works/pi-tui";
+import { getMainMenuItems, getSteeringItems, getAnimationItems, getToolItems, getDebugItems, getSessionItems, getAskUserItems, getLoopItems, getModelConfigItems, _moduleRefs, } from "./settings-items.js";
+import { getCategoryHandler, handleTextCommand } from "./settings-handler.js";
+export { getMainMenuItems, getSteeringItems, getAnimationItems, getToolItems, getDebugItems, getSessionItems, getAskUserItems, getLoopItems, getModelConfigItems, buildInputSubmenu, buildModelPickerSubmenu, } from "./settings-items.js";
+// ---------------------------------------------------------------------------
+// SettingsList component (local implementation matching sub-core pattern)
+// ---------------------------------------------------------------------------
 export class SettingsList {
     items;
     theme;
@@ -190,368 +191,6 @@ export class SettingsList {
         lines.push(this.theme.hint("  ←/→ change • Enter/Space edit custom • Esc to cancel"));
     }
 }
-function getMainMenuItems(settings, cwd) {
-    const steeringEnabled = settings.steering?.enabled ?? true;
-    const animationEnabled = settings.animation?.enabled ?? true;
-    const toolOptimize = settings.toolOptimize ?? true;
-    const structuredOutput = settings.structuredOutput ?? true;
-    const complexity = settings.complexity ?? "moderate";
-    const askUserEnabled = settings.askUser?.enabled ?? false;
-    const askUserTimeout = settings.askUser?.timeout ?? 300;
-    const loaded = loadFlowModelConfigs(cwd);
-    const strategyName = loaded.selectedName;
-    const litePrimary = loaded.strategy.lite?.primary ?? "(default)";
-    const primaryModelShort = litePrimary.includes("/") ? litePrimary.split("/").pop() : litePrimary;
-    const loop = getLoop(cwd);
-    const loopDescription = loop ? `${loop.status} • ${loop.sessionCount} sessions` : "none";
-    return [
-        {
-            value: "steering",
-            label: "Steering Settings",
-            description: steeringEnabled ? "enabled" : "disabled",
-            tooltip: "Configure root state steering and strategic hints",
-        },
-        {
-            value: "animation",
-            label: "Animation Settings",
-            description: animationEnabled ? "enabled" : "disabled",
-            tooltip: "Toggle animation effects and glitch/scramble",
-        },
-        {
-            value: "tools",
-            label: "Tool Settings",
-            description: `tool-optimize: ${toolOptimize ? "on" : "off"}, structured-output: ${structuredOutput ? "on" : "off"}, trace: ${(settings.tools?.trace ?? true) ? "on" : "off"}, batch-read: ${(settings.tools?.batchRead ?? toolOptimize) ? "on" : "off"}`,
-            tooltip: "Configure tool optimization and structured output",
-        },
-        {
-            value: "session",
-            label: "Session Settings",
-            description: `complexity: ${complexity} · body: ${settings.bodyVerbosity ?? "lite"}`,
-            tooltip: "Set default complexity and concurrency",
-        },
-        {
-            value: "ask-user",
-            label: "Ask User Settings",
-            description: `enabled: ${askUserEnabled ? "on" : "off"}, timeout: ${askUserTimeout}s`,
-            tooltip: "Configure ask_user timeout and countdown",
-        },
-        {
-            value: "model-config",
-            label: "Model Config",
-            description: `${strategyName} ▸ lite: ${primaryModelShort}`,
-            tooltip: "Configure LLM models for lite, flash, and full flow tiers",
-        },
-        {
-            value: "loop",
-            label: "Loop Status",
-            description: loopDescription,
-            tooltip: "Endless loop state and statistics",
-        },
-        {
-            value: "debug",
-            label: "Debug Settings",
-            description: `debugMode: ${settings.debugMode ?? false ? "on" : "off"}`,
-            tooltip: "Write full child flow prompt to disk on every spawn",
-        },
-        {
-            value: "reset",
-            label: "Reset to Defaults",
-            description: "restore all settings",
-            tooltip: "Restore all flow settings to their default values",
-        },
-    ];
-}
-function getSteeringItems(settings) {
-    const steering = settings.steering ?? {};
-    return [
-        {
-            id: "steering.enabled",
-            label: "enabled",
-            description: "Toggle steering injection",
-            currentValue: (steering.enabled ?? true) ? "on" : "off",
-            values: ["on", "off"],
-        },
-        {
-            id: "steering.strategicHint",
-            label: "strategic-hint",
-            description: "Toggle [Hint: Plan next step...]",
-            currentValue: (steering.strategicHint ?? true) ? "on" : "off",
-            values: ["on", "off"],
-        },
-        {
-            id: "steering.customPrompt",
-            label: "custom-prompt",
-            description: "Enter custom steering prompt or type 'default' to reset",
-            currentValue: steering.customPrompt ?? "(default)",
-            submenu: buildInputSubmenu("Custom prompt (or 'default')", (v) => {
-                const trimmed = v.trim();
-                if (!trimmed || trimmed.toLowerCase() === "default")
-                    return "(default)";
-                return trimmed;
-            }),
-        },
-    ];
-}
-function getAnimationItems(settings) {
-    const animation = settings.animation ?? {};
-    return [
-        {
-            id: "animation.enabled",
-            label: "enabled",
-            description: "Master animation switch",
-            currentValue: (animation.enabled ?? true) ? "on" : "off",
-            values: ["on", "off"],
-        },
-        {
-            id: "animation.glitch",
-            label: "glitch",
-            description: "Glitch/scramble effect",
-            currentValue: (animation.glitch ?? true) ? "on" : "off",
-            values: ["on", "off"],
-        },
-    ];
-}
-function getToolItems(settings) {
-    return [
-        {
-            id: "toolOptimize",
-            label: "tool-optimize",
-            description: "Unified batch tool vs separate tools",
-            currentValue: (settings.toolOptimize ?? true) ? "on" : "off",
-            values: ["on", "off"],
-        },
-        {
-            id: "structuredOutput",
-            label: "structured-output",
-            description: "Structured JSON output from flows",
-            currentValue: (settings.structuredOutput ?? true) ? "on" : "off",
-            values: ["on", "off"],
-        },
-        {
-            id: "tools.trace",
-            label: "trace",
-            description: "Enable the trace tool",
-            currentValue: (settings.tools?.trace ?? true) ? "on" : "off",
-            values: ["on", "off"],
-        },
-        {
-            id: "tools.batchRead",
-            label: "batch-read",
-            description: "Enable the batch_read tool",
-            currentValue: (settings.tools?.batchRead ?? settings.toolOptimize ?? true) ? "on" : "off",
-            values: ["on", "off"],
-        },
-    ];
-}
-function getDebugItems(settings) {
-    return [
-        {
-            id: "debugMode",
-            label: "emit-flow-content",
-            description: "Write full child flow prompt to disk on every spawn",
-            currentValue: (settings.debugMode ?? false) ? "on" : "off",
-            values: ["on", "off"],
-        },
-    ];
-}
-function getSessionItems(settings) {
-    return [
-        {
-            id: "bodyVerbosity",
-            label: "body",
-            description: "Collapsed result verbosity",
-            currentValue: settings.bodyVerbosity ?? "lite",
-            values: ["lite", "full"],
-        },
-        {
-            id: "complexity",
-            label: "complexity",
-            description: "Complexity sets budget + review",
-            currentValue: settings.complexity ?? "moderate",
-            values: ["snap", "simple", "moderate", "complex", "intricate"],
-        },
-        {
-            id: "maxConcurrency",
-            label: "max-concurrency",
-            description: "Maximum concurrent flows",
-            currentValue: String(settings.maxConcurrency ?? 4),
-            values: ["1", "2", "3", "4", "5", "6", "7", "8"],
-            submenu: buildInputSubmenu("Max concurrency (1-20)", (v) => {
-                const n = Number(v.trim());
-                if (!Number.isSafeInteger(n) || n < 1 || n > 20)
-                    return null;
-                return String(n);
-            }),
-        },
-    ];
-}
-function getAskUserItems(settings) {
-    const askUser = settings.askUser ?? {};
-    return [
-        {
-            id: "askUser.enabled",
-            label: "enabled",
-            description: "Show countdown timer in ask_user prompt",
-            currentValue: (askUser.enabled ?? false) ? "on" : "off",
-            values: ["on", "off"],
-        },
-        {
-            id: "askUser.timeout",
-            label: "timeout",
-            description: "Auto-dismiss timeout in seconds",
-            currentValue: String(askUser.timeout ?? 300),
-            values: ["30", "60", "120", "300", "600"],
-            submenu: buildInputSubmenu("Timeout in seconds (10-3600)", (v) => {
-                const n = Number(v.trim());
-                if (!Number.isSafeInteger(n) || n < 10 || n > 3600)
-                    return null;
-                return String(n);
-            }),
-        },
-    ];
-}
-function getLoopItems(_settings, cwd) {
-    const loop = getLoop(cwd);
-    if (!loop) {
-        return [
-            {
-                id: "loop.status",
-                label: "status",
-                description: "No active loop",
-                currentValue: "none",
-            },
-        ];
-    }
-    return [
-        {
-            id: "loop.status",
-            label: "status",
-            description: "Current loop status",
-            currentValue: loop.status,
-        },
-        {
-            id: "loop.objective",
-            label: "objective",
-            description: "Loop objective",
-            currentValue: loop.objective,
-        },
-        {
-            id: "loop.sessions",
-            label: "sessions",
-            description: "Number of warped sessions",
-            currentValue: String(loop.sessionCount),
-        },
-        {
-            id: "loop.flows",
-            label: "flows",
-            description: "Total flows across sessions",
-            currentValue: String(loop.totalFlowsAcrossSessions),
-        },
-        {
-            id: "loop.tokens",
-            label: "tokens",
-            description: "Total tokens across sessions",
-            currentValue: String(loop.totalTokensAcrossSessions),
-        },
-    ];
-}
-function getModelConfigItems(settings, cwd) {
-    const loaded = loadFlowModelConfigs(cwd);
-    const strategyName = loaded.selectedName;
-    const strategy = loaded.strategy;
-    const items = [
-        {
-            id: "modelConfig.strategy",
-            label: "strategy",
-            description: "Active model strategy",
-            currentValue: strategyName,
-            values: Object.keys(loaded.configs).sort(),
-        },
-    ];
-    for (const tier of ["lite", "flash", "full"]) {
-        const tierConfig = strategy[tier];
-        const primary = tierConfig?.primary ?? "(default)";
-        const failover = tierConfig?.failover?.join(", ") ?? "(none)";
-        items.push({
-            id: `modelConfig.${tier}.primary`,
-            label: `${tier}: primary`,
-            description: `Primary model for ${tier} tier`,
-            currentValue: primary,
-            submenu: buildModelPickerSubmenu(primary, tier, "primary"),
-        });
-        items.push({
-            id: `modelConfig.${tier}.failover`,
-            label: `${tier}: failover`,
-            description: `Failover models for ${tier} tier`,
-            currentValue: failover,
-            submenu: buildModelPickerSubmenu(failover, tier, "failover"),
-        });
-    }
-    return items;
-}
-// ---------------------------------------------------------------------------
-// Submenu helpers
-// ---------------------------------------------------------------------------
-function buildInputSubmenu(label, parseValue) {
-    return (currentValue, done) => {
-        const input = new Input();
-        input.focused = true;
-        input.setValue(currentValue);
-        input.onSubmit = (value) => {
-            const parsed = parseValue(value);
-            if (parsed === null)
-                return;
-            done(parsed);
-        };
-        input.onEscape = () => {
-            done();
-        };
-        const container = new Container();
-        container.addChild(new Text(label, 1, 0));
-        container.addChild(new Spacer(1));
-        container.addChild(input);
-        return {
-            render: (width) => container.render(width),
-            invalidate: () => container.invalidate(),
-            handleInput: (data) => input.handleInput(data),
-        };
-    };
-}
-function buildModelPickerSubmenu(currentValue, tier, slot) {
-    return (_currentValue, done) => {
-        const models = _modelRegistry?.getAvailable() ?? [];
-        const items = models.map((m) => ({
-            value: `${m.provider}/${m.id}`,
-            label: `${m.provider}/${m.id}`,
-            description: m.name ?? "",
-        }));
-        items.unshift({ value: "(default)", label: "(default)", description: "Use the default model" });
-        const selectList = new SelectList(items, 15, {
-            selectedPrefix: (t) => _theme?.fg("accent", t) ?? t,
-            selectedText: (t) => _theme?.fg("accent", t) ?? t,
-            description: (t) => _theme?.fg("muted", t) ?? t,
-            scrollInfo: (t) => _theme?.fg("dim", t) ?? t,
-            noMatch: (t) => _theme?.fg("warning", t) ?? t,
-        });
-        selectList.onSelect = (item) => {
-            done(item.value);
-        };
-        selectList.onCancel = () => {
-            done();
-        };
-        return {
-            render(width) {
-                return selectList.render(width);
-            },
-            invalidate() {
-                selectList.invalidate?.();
-            },
-            handleInput(data) {
-                selectList.handleInput(data);
-            },
-        };
-    };
-}
 // ---------------------------------------------------------------------------
 // Command registration
 // ---------------------------------------------------------------------------
@@ -562,24 +201,22 @@ export function setupSettingsCommand(pi) {
             if (!ctx.ui) {
                 return;
             }
-            const cwd = ctx.cwd;
             const trimmed = args.trim().toLowerCase();
             const parts = trimmed.split(/\s+/);
             const sub = parts[0] ?? "";
-            const value = parts[1] ?? "";
             if (!sub) {
+                const cwd = ctx.cwd;
                 const settings = loadFlowSettings(cwd);
-                _modelRegistry = ctx.modelRegistry;
+                _moduleRefs.modelRegistry = ctx.modelRegistry;
                 await ctx.ui.custom((tui, theme, keybindings, done) => {
-                    _theme = theme;
-                    _keybindings = keybindings;
+                    _moduleRefs.theme = theme;
+                    _moduleRefs.keybindings = keybindings;
                     let currentCategory = "main";
                     let container = new Container();
                     let activeList = null;
                     function rebuild() {
                         container = new Container();
                         activeList = null;
-                        // Header
                         container.addChild(new DynamicBorder());
                         container.addChild(new Text(theme.fg("accent", theme.bold("Flow Settings")), 1, 0));
                         container.addChild(new Spacer(1));
@@ -630,169 +267,33 @@ export function setupSettingsCommand(pi) {
                         }
                         else {
                             let items;
-                            let handleChange;
                             const backCategory = "main";
                             if (currentCategory === "steering") {
                                 items = getSteeringItems(currentSettings);
-                                handleChange = (id, value) => {
-                                    if (id === "steering.enabled") {
-                                        const boolValue = value === "on";
-                                        writeFlowSetting(cwd, "steering.enabled", boolValue);
-                                        configureSteering({
-                                            enabled: boolValue,
-                                            customPrompt: currentSettings.steering?.customPrompt,
-                                        });
-                                    }
-                                    else if (id === "steering.strategicHint") {
-                                        const boolValue = value === "on";
-                                        writeFlowSetting(cwd, "steering.strategicHint", boolValue);
-                                        configureStrategicHint(boolValue);
-                                    }
-                                    else if (id === "steering.customPrompt") {
-                                        if (value === "(default)") {
-                                            writeFlowSetting(cwd, "steering.customPrompt", undefined);
-                                            configureSteering({
-                                                enabled: currentSettings.steering?.enabled ?? true,
-                                                customPrompt: undefined,
-                                            });
-                                        }
-                                        else {
-                                            writeFlowSetting(cwd, "steering.customPrompt", value);
-                                            configureSteering({
-                                                enabled: currentSettings.steering?.enabled ?? true,
-                                                customPrompt: value,
-                                            });
-                                        }
-                                    }
-                                    rebuild();
-                                    tui.requestRender();
-                                };
                             }
                             else if (currentCategory === "animation") {
                                 items = getAnimationItems(currentSettings);
-                                handleChange = (id, value) => {
-                                    if (id === "animation.enabled") {
-                                        const boolValue = value === "on";
-                                        writeFlowSetting(cwd, "animation.enabled", boolValue);
-                                        scrambleManager.setAnimationConfig({
-                                            enabled: boolValue,
-                                            glitch: currentSettings.animation?.glitch ?? true,
-                                        });
-                                    }
-                                    else if (id === "animation.glitch") {
-                                        const boolValue = value === "on";
-                                        writeFlowSetting(cwd, "animation.glitch", boolValue);
-                                        scrambleManager.setAnimationConfig({
-                                            enabled: currentSettings.animation?.enabled ?? true,
-                                            glitch: boolValue,
-                                        });
-                                    }
-                                    rebuild();
-                                    tui.requestRender();
-                                };
                             }
                             else if (currentCategory === "tools") {
                                 items = getToolItems(currentSettings);
-                                handleChange = (id, value) => {
-                                    if (id === "toolOptimize") {
-                                        writeFlowSetting(cwd, "toolOptimize", value === "on");
-                                    }
-                                    else if (id === "structuredOutput") {
-                                        writeFlowSetting(cwd, "structuredOutput", value === "on");
-                                    }
-                                    else if (id === "tools.trace") {
-                                        writeFlowSetting(cwd, "tools.trace", value === "on");
-                                    }
-                                    else if (id === "tools.batchRead") {
-                                        writeFlowSetting(cwd, "tools.batchRead", value === "on");
-                                    }
-                                    rebuild();
-                                    tui.requestRender();
-                                };
                             }
                             else if (currentCategory === "session") {
                                 items = getSessionItems(currentSettings);
-                                handleChange = (id, value) => {
-                                    if (id === "complexity") {
-                                        writeFlowSetting(cwd, "complexity", value);
-                                    }
-                                    else if (id === "maxConcurrency") {
-                                        writeFlowSetting(cwd, "maxConcurrency", Number(value));
-                                    }
-                                    rebuild();
-                                    tui.requestRender();
-                                };
                             }
                             else if (currentCategory === "ask-user") {
                                 items = getAskUserItems(currentSettings);
-                                handleChange = (id, value) => {
-                                    if (id === "askUser.enabled") {
-                                        writeFlowSetting(cwd, "askUser.enabled", value === "on");
-                                    }
-                                    else if (id === "askUser.timeout") {
-                                        writeFlowSetting(cwd, "askUser.timeout", Number(value));
-                                    }
-                                    rebuild();
-                                    tui.requestRender();
-                                };
                             }
                             else if (currentCategory === "model-config") {
                                 items = getModelConfigItems(currentSettings, cwd);
-                                handleChange = (id, value) => {
-                                    if (id === "modelConfig.strategy") {
-                                        try {
-                                            writeGlobalFlowMode(value);
-                                        }
-                                        catch (e) {
-                                            /* ignore */
-                                        }
-                                    }
-                                    else if (id.startsWith("modelConfig.")) {
-                                        const match = id.match(/^modelConfig\.(lite|flash|full)\.(primary|failover)$/);
-                                        if (match) {
-                                            const tier = match[1];
-                                            const slot = match[2];
-                                            const loaded = loadFlowModelConfigs(cwd);
-                                            const strategyName = loaded.selectedName;
-                                            if (slot === "primary") {
-                                                if (value === "(default)") {
-                                                    writeFlowModelConfig(cwd, strategyName, tier, { primary: null, failover: null });
-                                                }
-                                                else {
-                                                    writeFlowModelConfig(cwd, strategyName, tier, { primary: value });
-                                                }
-                                            }
-                                            else {
-                                                if (value === "(default)") {
-                                                    writeFlowModelConfig(cwd, strategyName, tier, { failover: [] });
-                                                }
-                                                else {
-                                                    writeFlowModelConfig(cwd, strategyName, tier, { failover: [value] });
-                                                }
-                                            }
-                                        }
-                                    }
-                                    rebuild();
-                                    tui.requestRender();
-                                };
                             }
                             else if (currentCategory === "loop") {
                                 items = getLoopItems(currentSettings, cwd);
-                                handleChange = () => { };
                             }
                             else if (currentCategory === "debug") {
                                 items = getDebugItems(currentSettings);
-                                handleChange = (id, value) => {
-                                    if (id === "debugMode") {
-                                        writeFlowSetting(cwd, "debugMode", value === "on");
-                                    }
-                                    rebuild();
-                                    tui.requestRender();
-                                };
                             }
                             else {
                                 items = [];
-                                handleChange = () => { };
                             }
                             const settingsTheme = {
                                 label: (text, selected) => selected ? theme.fg("accent", theme.bold(text)) : theme.fg("text", text),
@@ -801,7 +302,7 @@ export function setupSettingsCommand(pi) {
                                 cursor: theme.fg("accent", "▶ "),
                                 hint: (text) => theme.fg("dim", text),
                             };
-                            const settingsList = new SettingsList(items, Math.min(items.length + 2, 15), settingsTheme, keybindings, handleChange, () => {
+                            const settingsList = new SettingsList(items, Math.min(items.length + 2, 15), settingsTheme, keybindings, getCategoryHandler(currentCategory, cwd, currentSettings, rebuild, tui, ctx), () => {
                                 currentCategory = backCategory;
                                 rebuild();
                                 tui.requestRender();
@@ -829,210 +330,7 @@ export function setupSettingsCommand(pi) {
                 });
                 return;
             }
-            // -----------------------------------------------------------------
-            // Text-based fallback for subcommands with arguments
-            // -----------------------------------------------------------------
-            const parseOnOff = (v) => {
-                if (v === "on" || v === "true" || v === "1")
-                    return true;
-                if (v === "off" || v === "false" || v === "0")
-                    return false;
-                return null;
-            };
-            switch (sub) {
-                case "steering": {
-                    const parsed = parseOnOff(value);
-                    if (parsed === null) {
-                        ctx.ui.notify?.("Usage: /flow:settings steering <on|off>", "error");
-                        return;
-                    }
-                    writeFlowSetting(cwd, "steering.enabled", parsed);
-                    configureSteering({ enabled: parsed, customPrompt: undefined });
-                    ctx.ui.notify?.(`steering.enabled = ${parsed}`, "info");
-                    break;
-                }
-                case "strategic-hint": {
-                    const parsed = parseOnOff(value);
-                    if (parsed === null) {
-                        ctx.ui.notify?.("Usage: /flow:settings strategic-hint <on|off>", "error");
-                        return;
-                    }
-                    writeFlowSetting(cwd, "steering.strategicHint", parsed);
-                    configureStrategicHint(parsed);
-                    ctx.ui.notify?.(`steering.strategicHint = ${parsed}`, "info");
-                    break;
-                }
-                case "animation": {
-                    const parsed = parseOnOff(value);
-                    if (parsed === null) {
-                        ctx.ui.notify?.("Usage: /flow:settings animation <on|off>", "error");
-                        return;
-                    }
-                    writeFlowSetting(cwd, "animation.enabled", parsed);
-                    scrambleManager.setAnimationConfig({ enabled: parsed, glitch: true });
-                    ctx.ui.notify?.(`animation.enabled = ${parsed}`, "info");
-                    break;
-                }
-                case "glitch": {
-                    const parsed = parseOnOff(value);
-                    if (parsed === null) {
-                        ctx.ui.notify?.("Usage: /flow:settings glitch <on|off>", "error");
-                        return;
-                    }
-                    writeFlowSetting(cwd, "animation.glitch", parsed);
-                    scrambleManager.setAnimationConfig({ enabled: true, glitch: parsed });
-                    ctx.ui.notify?.(`animation.glitch = ${parsed}`, "info");
-                    break;
-                }
-                case "tool-optimize": {
-                    const parsed = parseOnOff(value);
-                    if (parsed === null) {
-                        ctx.ui.notify?.("Usage: /flow:settings tool-optimize <on|off>", "error");
-                        return;
-                    }
-                    writeFlowSetting(cwd, "toolOptimize", parsed);
-                    ctx.ui.notify?.(`toolOptimize = ${parsed}`, "info");
-                    break;
-                }
-                case "structured-output": {
-                    const parsed = parseOnOff(value);
-                    if (parsed === null) {
-                        ctx.ui.notify?.("Usage: /flow:settings structured-output <on|off>", "error");
-                        return;
-                    }
-                    writeFlowSetting(cwd, "structuredOutput", parsed);
-                    ctx.ui.notify?.(`structuredOutput = ${parsed}`, "info");
-                    break;
-                }
-                case "trace": {
-                    const parsed = parseOnOff(value);
-                    if (parsed === null) {
-                        ctx.ui.notify?.("Usage: /flow:settings trace <on|off>", "error");
-                        return;
-                    }
-                    writeFlowSetting(cwd, "tools.trace", parsed);
-                    ctx.ui.notify?.(`tools.trace = ${parsed}`, "info");
-                    break;
-                }
-                case "batch-read": {
-                    const parsed = parseOnOff(value);
-                    if (parsed === null) {
-                        ctx.ui.notify?.("Usage: /flow:settings batch-read <on|off>", "error");
-                        return;
-                    }
-                    writeFlowSetting(cwd, "tools.batchRead", parsed);
-                    ctx.ui.notify?.(`tools.batchRead = ${parsed}`, "info");
-                    break;
-                }
-                case "body": {
-                    if (args[0] === "lite" || args[0] === "full") {
-                        writeFlowSetting(cwd, "bodyVerbosity", args[0]);
-                        ctx.ui.notify?.(`bodyVerbosity = ${args[0]}`, "info");
-                    }
-                    else {
-                        ctx.ui.notify?.("Usage: /flow:settings body <lite|full>", "error");
-                    }
-                    break;
-                }
-                case "debug":
-                case "emit-flow-content": {
-                    const parsed = parseOnOff(value);
-                    if (parsed === null) {
-                        ctx.ui.notify?.("Usage: /flow:settings debug <on|off>", "error");
-                        return;
-                    }
-                    writeFlowSetting(cwd, "debugMode", parsed);
-                    ctx.ui.notify?.(`debugMode = ${parsed}`, "info");
-                    break;
-                }
-                case "complexity": {
-                    const validModes = ["snap", "simple", "moderate", "complex", "intricate"];
-                    if (!validModes.includes(value)) {
-                        ctx.ui.notify?.("Usage: /flow:settings complexity <snap|simple|moderate|complex|intricate>", "error");
-                        return;
-                    }
-                    writeFlowSetting(cwd, "complexity", value);
-                    ctx.ui.notify?.(`complexity = ${value}`, "info");
-                    break;
-                }
-                case "max-concurrency": {
-                    const n = Number(value);
-                    if (!Number.isSafeInteger(n) || n < 1) {
-                        ctx.ui.notify?.("Usage: /flow:settings max-concurrency <n>", "error");
-                        return;
-                    }
-                    writeFlowSetting(cwd, "maxConcurrency", n);
-                    ctx.ui.notify?.(`maxConcurrency = ${n}`, "info");
-                    break;
-                }
-                case "ask-user": {
-                    const askParts = trimmed.split(/\s+/);
-                    const askSub = askParts[1] ?? "";
-                    const askValue = askParts[2] ?? "";
-                    if (askSub === "enabled") {
-                        const parsed = parseOnOff(askValue);
-                        if (parsed === null) {
-                            ctx.ui.notify?.("Usage: /flow:settings ask-user enabled <on|off>", "error");
-                            return;
-                        }
-                        writeFlowSetting(cwd, "askUser.enabled", parsed);
-                        ctx.ui.notify?.(`askUser.enabled = ${parsed}`, "info");
-                    }
-                    else if (askSub === "timeout") {
-                        const n = Number(askValue);
-                        if (!Number.isSafeInteger(n) || n < 10) {
-                            ctx.ui.notify?.("Usage: /flow:settings ask-user timeout <seconds>", "error");
-                            return;
-                        }
-                        writeFlowSetting(cwd, "askUser.timeout", n);
-                        ctx.ui.notify?.(`askUser.timeout = ${n}`, "info");
-                    }
-                    else {
-                        ctx.ui.notify?.("Usage: /flow:settings ask-user {enabled <on|off> | timeout <seconds>}", "error");
-                    }
-                    break;
-                }
-                case "reset": {
-                    writeFlowSetting(cwd, "", {});
-                    ctx.ui.notify?.("Flow settings reset to defaults", "info");
-                    break;
-                }
-                case "show": {
-                    const currentSettings = loadFlowSettings(cwd);
-                    const loop = getLoop(cwd);
-                    const lines = [
-                        `bodyVerbosity: ${currentSettings.bodyVerbosity ?? "lite"}`,
-                        `toolOptimize: ${currentSettings.toolOptimize ?? true}`,
-                        `structuredOutput: ${currentSettings.structuredOutput ?? true}`,
-                        `complexity: ${currentSettings.complexity ?? "moderate"}`,
-                        `maxConcurrency: ${currentSettings.maxConcurrency ?? 4}`,
-                        `steering.enabled: ${currentSettings.steering?.enabled ?? true}`,
-                        `steering.strategicHint: ${currentSettings.steering?.strategicHint ?? true}`,
-                        `animation.enabled: ${currentSettings.animation?.enabled ?? true}`,
-                        `animation.glitch: ${currentSettings.animation?.glitch ?? true}`,
-                        `askUser.enabled: ${currentSettings.askUser?.enabled ?? false}`,
-                        `askUser.timeout: ${currentSettings.askUser?.timeout ?? 300}`,
-                        `debugMode: ${currentSettings.debugMode ?? false}`,
-                        `tools.trace: ${currentSettings.tools?.trace ?? true}`,
-                        `tools.batchRead: ${currentSettings.tools?.batchRead ?? currentSettings.toolOptimize ?? true}`,
-                    ];
-                    if (loop) {
-                        lines.push("");
-                        lines.push(`loop.status: ${loop.status}`);
-                        lines.push(`loop.objective: ${loop.objective}`);
-                        lines.push(`loop.sessions: ${loop.sessionCount}`);
-                        lines.push(`loop.flows: ${loop.totalFlowsAcrossSessions}`);
-                        lines.push(`loop.tokens: ${loop.totalTokensAcrossSessions}`);
-                        if (loop.terminationReason)
-                            lines.push(`loop.terminationReason: ${loop.terminationReason}`);
-                    }
-                    ctx.ui.notify?.(lines.join("\n"), "info");
-                    break;
-                }
-                default: {
-                    ctx.ui.notify?.("Unknown subcommand. Usage: /flow:settings {steering|strategic-hint|animation|glitch|tool-optimize|structured-output|body|complexity|max-concurrency|ask-user|debug|trace|batch-read|reset|show}", "error");
-                }
-            }
+            await handleTextCommand(args, ctx);
         },
     });
 }