@namzu/cli 29.1.0 → 32.0.0

package/dist/tui/App.js

@@ -19,7 +19,7 @@ import { ToolOutputViewer } from './ToolOutputViewer.js';
 import { join, relative } from 'node:path';
 import { DEFAULT_MAX_GOAL_ROUNDS, DiskMessageFeedbackStore, GoalRoundLimitError, HostCommandRegistry, SessionGoalActivation, StaleGoalError, TurnCancelled, asSessionId, createAssistantMessage, createUserMessage, generateSessionId, generateTurnId, isCompactionMessage, kernelHostCommands, SKILL_TOOL_NAME, } from '@namzu/sdk';
 import { Box, Text, useApp, useInput, useStdout, useWindowSize } from 'ink';
-import { useCallback, useEffect, useRef, useState } from 'react';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { pinTrustedProjectPath, resolveTrustedProjectContext, } from '../config/trusted-project-context.js';
 import { visibleProjectInstructionPath } from '../context/project-path.js';
 import { runtimeContextLabel } from '../context/runtime-message.js';
@@ -43,8 +43,15 @@ import { BrandHeader } from './BrandHeader.js';
 import { ChoicePicker } from './ChoicePicker.js';
 import { emptyPluginReport, pluginDetails, pluginOption, pluginStartupState } from './plugin-view.js';
 import { Composer, suggestionWindowSize, } from './Composer.js';
+import { resolveComposerTriggers } from '../config/composer-triggers.js';
+import { triggerContextTexts, triggerEffort } from './triggers/context-text.js';
+import { transcriptTagLine } from './triggers/copy.js';
+import { unavailable as triggerUnavailable } from './triggers/detect.js';
+import { BUILTIN_TRIGGERS, compileRegistry, triggerDefinition, } from './triggers/registry.js';
+import { describeComposerTriggers, setComposerTriggers } from './triggers/setting.js';
 import { ComposerFrame } from './ComposerFrame.js';
 import { EffortSlider, effortSliderLayout } from './EffortSlider.js';
+import { HYPERMODE, HYPERMODE_SUMMARY, ORCHESTRATE_ALIAS_NOTICE, hypermodeEffort, hypermodeStopLabel, } from './hypermode.js';
 import { CopyPicker } from './CopyPicker.js';
 import { EditPromptPicker } from './EditPromptPicker.js';
 import { LiveActivity, formatElapsed } from './LiveActivity.js';
@@ -415,11 +422,11 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
     // A session setting layered above effort, not a level a provider publishes
     // — see docs/cli/slash-commands.md's /effort section. In-memory and
     // per-session like reasoningEffort above; no preferences file involved.
-    const [orchestrateMode, setOrchestrateModeState] = useState(false);
-    const orchestrateModeRef = useRef(false);
-    const setOrchestrateMode = useCallback((next) => {
-        orchestrateModeRef.current = next;
-        setOrchestrateModeState(next);
+    const [hypermode, setHypermodeState] = useState(false);
+    const hypermodeRef = useRef(false);
+    const setHypermode = useCallback((next) => {
+        hypermodeRef.current = next;
+        setHypermodeState(next);
     }, []);
     const [activeSkills, setActiveSkills] = useState([]);
     // Read when the session comes up rather than on every keystroke: the
@@ -871,8 +878,11 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
     const browserProfileRef = useRef(undefined);
     /** The current session's browser, for notices written from event handlers. */
     const browserControlRef = useRef(undefined);
+    /** The current session, for the review screen to name a computer-use control by its ref. */
+    const reviewSessionRef = useRef(null);
     useEffect(() => {
         browserControlRef.current = session?.browser;
+        reviewSessionRef.current = session;
     }, [session]);
     useEffect(() => {
         const source = session?.subagents;
@@ -980,7 +990,7 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
             ask: (question, signal) => scheduleLiveRef.current?.ask(question, signal) ?? Promise.resolve({ kind: 'skip' }),
             askPermission: (request) => scheduleLiveRef.current?.askPermission(request) ??
                 Promise.resolve({ kind: 'reject', feedback: 'Nobody can answer yet.' }),
-            submit: (text) => scheduleLiveRef.current?.submit(text),
+            submit: (text, createdBy) => scheduleLiveRef.current?.submit(text, createdBy),
         });
     }
     /**
@@ -1294,6 +1304,46 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
     const learningRef = useRef({ generation: -1, proposed: false, skillUsed: false });
     /** `/skills save off|on` in this session, over whatever the config files say. */
     const skillSuggestOverrideRef = useRef(undefined);
+    /** `/config triggers on|off` in this session, over whatever the config files say. */
+    const [composerTriggersOverride, setComposerTriggersOverride] = useState();
+    const composerTriggerSettings = useMemo(() => resolveComposerTriggers(ctx.composerTriggers), [ctx.composerTriggers]);
+    const composerTriggerRegistry = useMemo(() => compileRegistry(BUILTIN_TRIGGERS, {
+        arming: composerTriggerSettings.arming,
+        locales: composerTriggerSettings.languages,
+    }), [composerTriggerSettings]);
+    const composerTriggersOn = composerTriggersOverride ?? composerTriggerSettings.enabled;
+    /**
+     * Whether the model can run `skill-creator` here, which save-as-skill
+     * needs. Read once for the tag row; read again when a turn starts and when
+     * its follow-up would run, in case the skills changed meanwhile.
+     */
+    const readSkillCreator = useCallback(() => {
+        try {
+            const creator = discoverSkills({
+                cwd: ctx.cwd,
+                ...(ctx.skills ? { config: ctx.skills } : {}),
+            }).find((skill) => skill.name === SKILL_CREATOR_SKILL);
+            return Boolean(creator && !creator.problem && creator.invocation !== 'operator');
+        }
+        catch {
+            return false;
+        }
+    }, [ctx.cwd, ctx.skills]);
+    const skillCreatorAvailable = useMemo(() => readSkillCreator(), [readSkillCreator]);
+    /** The session as the triggers see it right now, for a check at a turn's start or end. */
+    const triggerContextNow = useCallback(() => ({
+        permissionMode: permissionModeRef.current,
+        sessionHypermode: hypermodeRef.current,
+        effortMenu: (session?.reasoningEffortLevels?.length ?? 0) > 0,
+        // The interactive session always mounts `Agent` and the `schedule`
+        // tool; only scheduled runs withhold them, and those never read
+        // composer triggers.
+        agentTool: true,
+        skillCreator: readSkillCreator(),
+        scheduleTool: true,
+    }), [readSkillCreator, session]);
+    /** A turn's hand-off to its after-turn triggers; assigned below, where the queue lives. */
+    const triggerFollowUpsRef = useRef(null);
     const conversationLearning = useCallback(() => {
         if (learningRef.current.generation !== conversationGenRef.current) {
             learningRef.current = {
@@ -1610,22 +1660,28 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
         pushMessage('system', `Reasoning: ${effort} (this session).`);
     }, [hasUnsettledTurn, pushMessage, session, setReasoningEffort, state]);
     /**
-     * Turn the session's orchestrate mode on or off.
+     * Turn the session's hypermode on or off.
      *
      * On: pins effort to the model's highest published level (last entry of
      * `reasoningEffortLevels`, which every provider publishes low-to-high) and
-     * strengthens delegation guidance for future turns via `SendOptions.orchestrate`
+     * strengthens delegation guidance for future turns via `SendOptions.hypermode`
      * — see `applyReasoningEffort` above for the mirrored guard shape. When the
      * model publishes no exact menu, effort is left alone and the notice says
      * so explicitly rather than silently doing nothing.
      */
-    const applyOrchestrateMode = useCallback((enabled, selectedSession) => {
+    /**
+     * The effort in force before hypermode pinned the highest level, and the
+     * level it pinned. Turning the mode off puts the effort back — unless the
+     * operator chose another level meanwhile, which then stays.
+     */
+    const hypermodePinRef = useRef(null);
+    const applyHypermode = useCallback((enabled, selectedSession) => {
         if (!session?.hasProvider) {
-            pushMessage('system', 'No active session — pick a provider before turning orchestrate mode on.');
+            pushMessage('system', 'No active session — pick a provider before turning hypermode on.');
             return;
         }
         if (selectedSession !== undefined && selectedSession !== session) {
-            pushMessage('system', 'Orchestrate mode was not changed: the selected model is no longer active.');
+            pushMessage('system', 'Hypermode was not changed: the selected model is no longer active.');
             return;
         }
         if (state !== 'idle' ||
@@ -1634,22 +1690,38 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
             (queuedRef.current.length > 0 && selectedSession !== session) ||
             permissionResolveRef.current !== null ||
             compactingRef.current) {
-            pushMessage('system', 'Orchestrate mode was not changed: wait for the active turn, prompt, compaction, and queued work to settle.');
+            pushMessage('system', 'Hypermode was not changed: wait for the active turn, prompt, compaction, and queued work to settle.');
+            return;
+        }
+        if (!enabled && !hypermodeRef.current) {
+            pushMessage('system', 'Hypermode is off.');
             return;
         }
-        setOrchestrateMode(enabled);
+        setHypermode(enabled);
         if (!enabled) {
-            pushMessage('system', 'Orchestrate mode is off.');
+            const pin = hypermodePinRef.current;
+            hypermodePinRef.current = null;
+            if (pin && reasoningEffortRef.current === pin.pinned) {
+                setReasoningEffort(pin.before);
+                pushMessage('system', `Hypermode is off — effort back to ${pin.before ?? 'the provider default'}.`);
+                return;
+            }
+            pushMessage('system', 'Hypermode is off.');
             return;
         }
-        const highest = highestReasoningEffort(session.reasoningEffortLevels);
-        if (highest !== undefined) {
-            setReasoningEffort(highest);
-            pushMessage('system', `Orchestrate mode is on — effort pinned to ${highest} for ${session.modelSummary ?? 'this model'}, and delegation guidance is strengthened for this session.`);
+        const pinned = hypermodeEffort(session.reasoningEffortLevels);
+        if (pinned !== undefined) {
+            // Turning it on twice keeps the effort from before the first time.
+            if (!hypermodePinRef.current)
+                hypermodePinRef.current = { before: reasoningEffortRef.current, pinned };
+            else
+                hypermodePinRef.current = { ...hypermodePinRef.current, pinned };
+            setReasoningEffort(pinned);
+            pushMessage('system', `Hypermode is on — effort pinned to ${pinned} for ${session.modelSummary ?? 'this model'}, and delegation guidance is strengthened for this session.`);
             return;
         }
-        pushMessage('system', `Orchestrate mode is on — ${session.modelSummary ?? 'this model'} does not publish an exact effort menu, so effort was left as is. Delegation guidance is still strengthened for this session.`);
-    }, [hasUnsettledTurn, pushMessage, session, setOrchestrateMode, setReasoningEffort, state]);
+        pushMessage('system', `Hypermode is on — ${session.modelSummary ?? 'this model'} does not publish an exact effort menu, so effort was left as is. Delegation guidance is still strengthened for this session.`);
+    }, [hasUnsettledTurn, pushMessage, session, setHypermode, setReasoningEffort, state]);
     const stepReasoningEffort = useCallback((direction) => {
         const levels = session?.reasoningEffortLevels;
         if (!session?.hasProvider || levels === undefined || levels.length === 0) {
@@ -2211,8 +2283,8 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
             removeStoredCredential(value);
             return;
         }
-        if (picker.kind === 'reasoning-effort' && value === ORCHESTRATE_MODE_VALUE) {
-            applyOrchestrateMode(!orchestrateModeRef.current, picker.selectedSession);
+        if (picker.kind === 'reasoning-effort' && value === HYPERMODE_VALUE) {
+            applyHypermode(!hypermodeRef.current, picker.selectedSession);
             return;
         }
         applyReasoningEffort(value, picker.selectedSession);
@@ -2220,7 +2292,7 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
         activateSkill,
         advanceQueueContinuation,
         appLifetime.signal,
-        applyOrchestrateMode,
+        applyHypermode,
         applyPermissionMode,
         applyReasoningEffort,
         archiveCurrentConversation,
@@ -2503,6 +2575,8 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
             // question when a decision is genuinely theirs.
             askUser: true,
             allowModelSwitch: true,
+            // The user is at this desktop, so the model may open a page for them.
+            openUrl: true,
         });
         if (signal?.aborted) {
             void s.close();
@@ -2541,11 +2615,15 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
         // A picker-owned provider/model change is one state transition. Clear the
         // old model's effort selection before publishing the replacement session
         // or releasing any paused queue. Failed and superseded candidates returned
-        // above, so they leave the current session selection untouched. Orchestrate
+        // above, so they leave the current session selection untouched. Hypermode
         // mode survives the switch: re-pin to the new model's highest published
         // level instead of clearing, exactly as it pinned when first turned on.
         if (signal !== undefined) {
-            setReasoningEffort(orchestrateModeRef.current ? highestReasoningEffort(s.reasoningEffortLevels) : undefined);
+            const repinned = hypermodeRef.current ? hypermodeEffort(s.reasoningEffortLevels) : undefined;
+            // A new model starts at its own default; that is what turning
+            // hypermode off returns to now.
+            hypermodePinRef.current = repinned ? { before: undefined, pinned: repinned } : null;
+            setReasoningEffort(repinned);
         }
         // Re-hydration (a provider switch via /model) builds a second session;
         // without this the first one's tool-server child processes stay alive
@@ -2554,9 +2632,9 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
         void previousSessionRef.current?.close();
         previousSessionRef.current = s;
         setSession(s);
-        // Orchestrate mode already re-pinned effort above; reopening this picker
+        // Hypermode already re-pinned effort above; reopening this picker
         // would ask the operator to redo a choice the mode just made for them.
-        if (!orchestrateModeRef.current && options.chooseReasoningEffort && s.reasoningEffortLevels?.length) {
+        if (!hypermodeRef.current && options.chooseReasoningEffort && s.reasoningEffortLevels?.length) {
             // Own input before publishing ready or releasing a paused queue. The
             // menu closes only after choosing an effort or keeping the new default.
             setSelectedChoice(0);
@@ -3279,7 +3357,10 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
             // only on its own.
             const kept = [];
             for (const pending of permissionQueueRef.current.splice(0)) {
-                if (releasedByApproveAll(pending.permission.toolCalls))
+                // Nor a question about sharing the screen, which only its own
+                // answer settles.
+                if (pending.permission.screenConsent !== true &&
+                    releasedByApproveAll(pending.permission.toolCalls))
                     pending.resolve(decision);
                 else
                     kept.push(pending);
@@ -3895,7 +3976,9 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
                 feedback: permissionReviewRefusal(review.reason),
             });
         }
-        const summary = buildPermissionSummary(review.text);
+        const summary = buildPermissionSummary(review.text, {
+            describeUiRef: (ref) => reviewSessionRef.current?.describeComputerUseRef?.(ref),
+        });
         const siteNotes = browserSiteNotes(req.toolCalls, browserControlRef.current?.status());
         return new Promise((resolve) => {
             if (permissionResolveRef.current) {
@@ -3951,6 +4034,9 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
                 ...question.options.map((option) => ({
                     label: option.label,
                     description: option.description ?? '',
+                    // A badge, not label text: the SDK already took any
+                    // "(Recommended)" the model wrote out of the label.
+                    ...(option.recommended === true ? { recommended: true } : {}),
                 })),
                 ...(question.allowFreeText
                     ? [{ label: 'Something else…', description: 'Answer in your own words' }]
@@ -4423,7 +4509,10 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
                     if (closing)
                         pushMessage('system', closing, false, '✻', undefined, theme.text.muted);
                 }
-                offerSkillSuggestion(st);
+                // A save the operator asked for in words takes the place of
+                // the proposal to save it.
+                if (!triggerFollowUpsRef.current?.(st, st.completed ? 'completed' : 'stopped'))
+                    offerSkillSuggestion(st);
                 break;
             }
             case 'paused':
@@ -4435,6 +4524,7 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
                 st.outcome = 'stopped';
                 st.queuePauseOutcome = 'paused';
                 st.notification = { kind: 'turn-settled', outcome: 'stopped' };
+                triggerFollowUpsRef.current?.(st, 'paused');
                 if (event.handoff) {
                     // Nothing failed and nothing needs approving: a tool needs the
                     // operator to do something first. Continuing is one key.
@@ -4455,6 +4545,7 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
             case 'error':
                 closeAssistant();
                 st.outcome = event.message === 'aborted' ? 'cancelled' : 'failed';
+                triggerFollowUpsRef.current?.(st, st.outcome);
                 if (event.message !== 'aborted') {
                     st.notification = { kind: 'turn-settled', outcome: 'failed' };
                     pushMessage('system', describeTurnInterruption(event), false, '!');
@@ -4571,11 +4662,29 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
         // Reserved before the turn begins, so everything that refers to this
         // turn — its goal-round authority above all — names it from the start.
         const turnId = generateTurnId();
+        // The composer triggers the operator armed for this message, checked
+        // again now: the mode or the session may have changed while it waited
+        // in the queue. None of them changes the operator's words.
+        const requestedTriggers = prompt.kind === 'human' ? (prompt.triggers ?? []) : [];
+        const triggerContext = triggerContextNow();
+        const turnTriggers = requestedTriggers.filter((id) => triggerUnavailable(id, triggerContext) === undefined);
+        const pinnedEffort = triggerEffort(turnTriggers, session.reasoningEffortLevels);
         if (goalRound) {
             pushMessage('system', `Goal round ${goalRound.round} / ${goalRound.maxGoalRounds}`, false, '◎', [`Objective: ${goalRound.objective}`]);
         }
         else {
             pushMessage('user', text, false, undefined, undefined, undefined, humanPromptMeta(attached.length, attachments));
+            const tagLine = transcriptTagLine(turnTriggers, {
+                effort: pinnedEffort,
+                steered: false,
+            });
+            if (tagLine)
+                pushMessage('system', tagLine, false, '✦', undefined, theme.accent.trigger);
+            for (const id of requestedTriggers) {
+                const reason = triggerUnavailable(id, triggerContext);
+                if (reason)
+                    pushMessage('system', `${triggerDefinition(id).label} · not applied: ${reason}`, false, '✧', undefined, theme.text.muted);
+            }
         }
         // A plan is scoped to the request it was made for. Cleared here, at
         // the start of the next one, rather than when the previous turn
@@ -4607,6 +4716,8 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
                     startedInPlanMode: permissionModeRef.current === 'plan',
                 }
                 : {}),
+            followUps: turnTriggers.filter((id) => triggerDefinition(id).scope === 'after-turn'),
+            contextTexts: triggerContextTexts(turnTriggers),
         };
         liveStreamRef.current = st;
         // A skill activated with /skills <name> stays in the prompt of every
@@ -4782,7 +4893,7 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
         activeTurnInboxRef.current = inbox;
         const turnPermissionMode = permissionModeRef.current;
         const turnReasoningEffort = reasoningEffortRef.current;
-        const turnOrchestrateMode = orchestrateModeRef.current;
+        const turnHypermode = hypermodeRef.current;
         const turnLimits = resolveTurnGuards(ctxRef.current.limits, turnLimitsOverrideRef.current);
         // Always carry the guarded callback. `auto` and `strict` decide before
         // calling it in makeResumeHandler; retaining it is what lets a session
@@ -4830,8 +4941,15 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
                     // while this turn runs, and the change governs what follows.
                     currentPermissionMode: () => permissionModeRef.current,
                     limits: turnLimits,
-                    ...(turnReasoningEffort !== undefined ? { effort: turnReasoningEffort } : {}),
-                    ...(turnOrchestrateMode ? { orchestrate: true } : {}),
+                    // A trigger that pins the highest effort does so for this
+                    // turn only; the session's own setting is untouched.
+                    ...((pinnedEffort ?? turnReasoningEffort) !== undefined
+                        ? { effort: pinnedEffort ?? turnReasoningEffort }
+                        : {}),
+                    ...(turnHypermode ? { hypermode: true } : {}),
+                    // Read at every iteration, so an after-turn trigger a steer
+                    // binds to this turn is said from the next one on.
+                    hostContext: () => st.contextTexts ?? [],
                     ...(goalRound ? { goalRound } : {}),
                     // The mode above decides whether this callback is consulted.
                     onPermission: askPermission,
@@ -5045,6 +5163,7 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
         sendTerminalNotification,
         session,
         setQueuePause,
+        triggerContextNow,
         wakeGoalDriver,
     ]);
     const selectModelIntent = useCallback(async (query) => {
@@ -5166,7 +5285,31 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
             pushMessage('system', `Could not save memory: ${err instanceof Error ? err.message : String(err)}`);
         }
     }, [ctx.cwd, pushMessage, session]);
-    const handleSubmit = useCallback((value, attachments, mode = 'submit') => {
+    /**
+     * Enter steered a message into the running turn. Its after-turn triggers
+     * (save as skill) bind to that turn and are told to the model from its next
+     * iteration; its turn triggers do not apply to a turn already running —
+     * the tag row said so before Enter, and Tab would have queued it instead.
+     */
+    const bindSteeredTriggers = useCallback((ids) => {
+        if (ids.length === 0)
+            return;
+        const live = liveStreamRef.current;
+        const afterTurn = ids.filter((id) => triggerDefinition(id).scope === 'after-turn');
+        const turnOnly = ids.filter((id) => triggerDefinition(id).scope === 'turn');
+        if (live && afterTurn.length > 0) {
+            live.followUps = [...new Set([...(live.followUps ?? []), ...afterTurn])];
+            live.contextTexts = [
+                ...new Set([...(live.contextTexts ?? []), ...triggerContextTexts(afterTurn)]),
+            ];
+            const line = transcriptTagLine(afterTurn, { effort: undefined, steered: true });
+            if (line)
+                pushMessage('system', line, false, '✦', undefined, theme.accent.trigger);
+        }
+        if (turnOnly.length > 0)
+            pushMessage('system', `${turnOnly.map((id) => triggerDefinition(id).label).join(', ')} · not applied: Enter steered this message into the running turn. Tab queues a message as a new turn with it.`, false, '✧', undefined, theme.text.muted);
+    }, [pushMessage]);
+    const handleSubmit = useCallback((value, attachments, mode, meta) => {
         if (goalCommandInFlightRef.current) {
             pushMessage('system', 'A goal command is still reaching durable session state. Wait for its result before sending another command or prompt.');
             return;
@@ -5190,8 +5333,19 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
         }
         // The operator moved on; a parked turn is still there for /resume.
         setHandoffPark(null);
-        setHistory((prev) => [...prev, value]);
-        const selectionIntent = !attachments?.length ? parseModelSelectionIntent(value) : undefined;
+        // A loop is not something the operator typed here, so it is not a line
+        // Up should bring back.
+        const fromLoop = meta.source === 'operator-loop' || meta.source === 'model-loop';
+        if (!fromLoop)
+            setHistory((prev) => [...prev, value]);
+        // What the model wrote is never the operator acting. A loop the model
+        // made (`session_loop`) fires this path on a timer, for up to a week,
+        // after one review of its creation — so its text must not reach the
+        // host-side meanings of `/`, `!`, `#` or a model switch: `!` runs on
+        // the host outside the sandbox with no review, and `#` writes memory
+        // every later turn reads. It is sent as the prompt it looks like.
+        const operatorText = meta.source !== 'model-loop';
+        const selectionIntent = operatorText && !attachments?.length ? parseModelSelectionIntent(value) : undefined;
         if (selectionIntent) {
             void selectModelIntent(selectionIntent.query);
             return;
@@ -5199,12 +5353,12 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
         // `#` remembers, `!` runs — neither is a prompt. Both are the
         // operator acting directly, the way other coding agents spell it,
         // and both leave a row the model reads on its next turn.
-        if (value.startsWith('#') && value.slice(1).trim().length > 0) {
+        if (operatorText && value.startsWith('#') && value.slice(1).trim().length > 0) {
             const note = value.slice(1).trim();
             void rememberProjectNote(note);
             return;
         }
-        const escaped = shellEscapeCommand(value);
+        const escaped = operatorText ? shellEscapeCommand(value) : null;
         if (escaped !== null) {
             pushMessage('user', value);
             const rowId = pushMessage('tool', `! ${escaped}`, true, '…');
@@ -5225,13 +5379,33 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
             });
             return;
         }
+        // Composer triggers (`./triggers/`). Only the composer's own submit
+        // carries them, so nothing a loop, a picker or the model sends can
+        // arm one. A message that is nothing but a trigger with a command of
+        // its own (`bunu skill olarak kaydet`) runs that command here, in this
+        // same call, so history holds the operator's words once; a trigger
+        // that needs a task and got none is not applied, and says so.
+        let armedTriggers = meta.source === 'composer' ? meta.triggers.map((trigger) => trigger.id) : [];
+        let dispatch = value;
+        if (meta.source === 'composer' && meta.onlyTriggers && armedTriggers.length > 0) {
+            const command = armedTriggers
+                .map((id) => triggerDefinition(id).standalone)
+                .find((standalone) => standalone !== undefined);
+            const needTask = armedTriggers.filter((id) => triggerDefinition(id).standalone === undefined);
+            if (needTask.length > 0)
+                pushMessage('system', `${needTask.map((id) => triggerDefinition(id).label).join(', ')} · not applied: the message has no task. Put the task in the same message${needTask.includes('hypermode') ? ', e.g. “hypermode fix the flaky test”' : ''}.`, false, '✧', undefined, theme.text.muted);
+            armedTriggers = [];
+            if (!command)
+                return;
+            dispatch = command;
+        }
         // What actually gets sent. A `prompt` action replaces it with text the
         // command composed, and then takes the ordinary send path below —
         // including the queue — so a command-driven turn is not a second way
         // to run one.
-        let outgoing = value;
+        let outgoing = dispatch;
         let skillFlow = false;
-        const slash = runSlash(value, slashCtx, hostCommands);
+        const slash = operatorText ? runSlash(dispatch, slashCtx, hostCommands) : null;
         if (slash) {
             switch (slash.kind) {
                 case 'message':
@@ -5370,6 +5544,13 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
                             description: `${session?.webSearchSummary ?? 'Not resolved'} · view tools, workspace and usage.`,
                         },
                         { name: 'setup', label: 'Provider setup', description: 'Check installed CLIs and access; connect or install without leaving Namzu.' },
+                        {
+                            name: `config triggers ${composerTriggersOn ? 'off' : 'on'}`,
+                            label: 'Composer triggers',
+                            description: composerTriggersOn
+                                ? 'On · hypermode and save-as-skill words act for their message. Select to turn off.'
+                                : 'Off · words in a message are only words. Select to turn on.',
+                        },
                         {
                             name: 'config sources',
                             label: 'Setting sources',
@@ -5387,7 +5568,7 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
                             description: command.description,
                             disabledReason: command.problem,
                         })),
-                        windowSize: 7,
+                        windowSize: 8,
                     });
                     return;
                 }
@@ -5621,7 +5802,7 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
                     const values = [undefined, ...levels];
                     const current = reasoningEffortRef.current;
                     setSelectedChoice(Math.max(0, values.findIndex((value) => value === current)));
-                    setChoicePicker(reasoningEffortPicker(session, current, false, orchestrateModeRef.current) ?? null);
+                    setChoicePicker(reasoningEffortPicker(session, current, false, hypermodeRef.current) ?? null);
                     return;
                 }
                 case 'login':
@@ -6143,9 +6324,25 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
                         : 'Raw output mode off — rich transcript rendering restored.');
                     return;
                 }
-                case 'orchestrate-mode': {
-                    const enabled = slash.enabled === 'toggle' ? !orchestrateModeRef.current : slash.enabled;
-                    applyOrchestrateMode(enabled);
+                case 'composer-triggers': {
+                    const profile = ctx.configDebug?.selectedProfile?.name;
+                    const cascade = { cwd: ctx.cwd, ...(profile ? { profile } : {}) };
+                    if (slash.setting === 'list') {
+                        pushMessage('system', describeComposerTriggers(composerTriggersOn, cascade));
+                        return;
+                    }
+                    const on = slash.setting === 'on';
+                    // The session follows the choice whatever the files say; the
+                    // message says whether a later start will too.
+                    setComposerTriggersOverride(on);
+                    pushMessage('system', setComposerTriggers(on, cascade));
+                    return;
+                }
+                case 'hypermode': {
+                    if (slash.via === 'orchestrate')
+                        pushMessage('system', ORCHESTRATE_ALIAS_NOTICE);
+                    const enabled = slash.enabled === 'toggle' ? !hypermodeRef.current : slash.enabled;
+                    applyHypermode(enabled);
                     return;
                 }
                 case 'export-picker': {
@@ -6215,6 +6412,7 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
             text: outgoing,
             ...(attachments && attachments.length > 0 ? { attachments: [...attachments] } : {}),
             ...(skillFlow ? { skillFlow: true } : {}),
+            ...(armedTriggers.length > 0 && !skillFlow ? { triggers: armedTriggers } : {}),
         };
         // `/skills save` and `/skills new` are turns of their own: steered into
         // a running turn, they would lose the flag that keeps the skill-making
@@ -6232,8 +6430,10 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
                     message: createUserMessage(expanded.sendText, prompt.attachments),
                     attachedFiles: expanded.attached.length,
                     queueBoundary: queuedRef.current.length,
-                }))
+                })) {
+                    bindSteeredTriggers(armedTriggers);
                     return;
+                }
             }
         }
         enqueueQueued(prompt);
@@ -6241,6 +6441,8 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
         activeSkills,
         advanceQueueContinuation,
         applyPermissionMode,
+        bindSteeredTriggers,
+        composerTriggersOn,
         conversationLearning,
         applyReasoningEffort,
         appLifetime,
@@ -6277,7 +6479,48 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
     // picker is also used by review/export flows. Keep only this dispatch hop in
     // a ref so selecting a help row re-enters the one ordinary slash-command
     // path instead of growing a second command executor.
-    commandPickerSubmitRef.current = handleSubmit;
+    commandPickerSubmitRef.current = (command) => handleSubmit(command, undefined, 'submit', { source: 'command-picker' });
+    // A turn's after-turn triggers, when it ends. Save as skill runs exactly the
+    // prompt `/skills save` sends, at the front of the queue, only when the
+    // turn completed, did tool work, did not already save a skill, and saving
+    // is still possible now. Otherwise one row says why, and `/skills save`
+    // still works. Returns whether the turn had one, so the proposal to save
+    // it is not also printed.
+    triggerFollowUpsRef.current = (st, ending) => {
+        const followUps = st.followUps ?? [];
+        st.followUps = [];
+        if (!followUps.includes('save-skill'))
+            return false;
+        const reason = ending === 'cancelled'
+            ? 'the turn was cancelled'
+            : ending === 'failed'
+                ? 'the turn failed'
+                : ending === 'paused'
+                    ? 'the turn paused'
+                    : ending === 'stopped'
+                        ? 'the turn stopped before it finished'
+                        : !st.learning || st.learning.steps < 1
+                            ? 'the turn did no tool work'
+                            : st.learning.savedSkill
+                                ? 'the turn already saved a skill'
+                                : triggerUnavailable('save-skill', triggerContextNow());
+        if (reason) {
+            pushMessage('system', `save as skill · not run: ${reason} · /skills save runs it anyway`, false, '✧', undefined, theme.text.muted);
+            return true;
+        }
+        // The proposal was taken up, as `/skills save` records it.
+        conversationLearning().proposed = true;
+        const home = resolveNamzuHome();
+        const ledger = readSuggestionLedger(home);
+        if (ledger.unanswered > 0)
+            writeSuggestionLedger(home, { ...ledger, unanswered: 0 });
+        replaceQueued([
+            { kind: 'human', text: learnSkillPrompt(), skillFlow: true },
+            ...queuedRef.current,
+        ]);
+        pushMessage('system', 'save as skill · running /skills save for this turn', false, '✦', undefined, theme.accent.trigger);
+        return true;
+    };
     saveSkillNotifyRef.current = () => sendTerminalNotification({ kind: 'approval-required' });
     scheduleLiveRef.current = {
         ...(scheduleLiveRef.current?.model ? { model: scheduleLiveRef.current.model } : {}),
@@ -6287,7 +6530,9 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
         },
         ask: askQuestion,
         askPermission: onPermission,
-        submit: (text) => handleSubmit(text),
+        submit: (text, createdBy) => handleSubmit(text, undefined, 'submit', {
+            source: createdBy === 'operator' ? 'operator-loop' : 'model-loop',
+        }),
     };
     // Scheduled work since the TUI last looked: one line, after the first
     // paint, never blocking it. Loops fire when a turn ends, and on their timer.
@@ -6738,7 +6983,10 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
             }
             if (permission && (key.upArrow || key.downArrow)) {
                 const current = permissionChoiceRef.current;
-                const last = permissionAnswers(permission.toolCalls, { batchOnly: permission.batchOnly === true }).length - 1;
+                const last = permissionAnswers(permission.toolCalls, {
+                    batchOnly: permission.batchOnly === true,
+                    screenConsent: permission.screenConsent === true,
+                }).length - 1;
                 const next = key.upArrow ? Math.max(0, current - 1) : Math.min(last, current + 1);
                 setPermissionChoice(next);
                 return;
@@ -6783,6 +7031,7 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
             // neither its `a` nor a `3` answers it.
             const answers = permissionAnswers(permission?.toolCalls ?? [], {
                 batchOnly: permission?.batchOnly === true,
+                screenConsent: permission?.screenConsent === true,
             });
             const numbered = /^[1-9]$/.test(ch) ? Number(ch) - 1 : null;
             const chosen = key.return ? permissionChoiceRef.current : numbered;
@@ -7278,6 +7527,24 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
             : `Session: ${permissionSource}`
         : undefined;
     const displayedPermissionMode = effectivePermissionMode(permissionMode, session?.approvalLatched() ?? false);
+    const highestEffort = highestReasoningEffort(session?.reasoningEffortLevels);
+    const hypermodeLevel = hypermodeEffort(session?.reasoningEffortLevels);
+    const composerTriggers = composerTriggersOn
+        ? {
+            registry: composerTriggerRegistry,
+            suggest: composerTriggerSettings.suggest,
+            context: {
+                permissionMode: displayedPermissionMode,
+                sessionHypermode: hypermode,
+                effortMenu: highestEffort !== undefined,
+                agentTool: true,
+                skillCreator: skillCreatorAvailable,
+                scheduleTool: true,
+            },
+            ...(highestEffort ? { highestEffort } : {}),
+            ...(hypermodeLevel ? { hypermodeEffort: hypermodeLevel } : {}),
+        }
+        : undefined;
     // True exactly when the phase ternary below renders its final branch — the
     // normal composer view, as opposed to provider setup or a lifecycle
     // picker/prompt. The agent rail is a feature of that view: computing this
@@ -7312,11 +7579,13 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
                                 saveSkillPrompt === null, thinking: thinking, tokens: turnTokens, waitingForYou: choicePicker !== null ||
                                 permission !== null ||
                                 textPrompt !== null ||
-                                saveSkillPrompt !== null })) : null, agentSurface === null && outputViewer === null && permission === null ? (_jsx(TaskList, { tasks: liveTasks })) : null, permission ? (_jsx(PermissionOverlay, { toolCalls: permission.toolCalls, review: permission.review, summary: permission.summary, detailsOpen: permissionDetailsOpen, reviewOffset: permissionReviewOffset, choice: permissionChoice, queuedCount: queuedPermissionCount, sourceLabel: permissionSourceLabel, columns: terminal.columns, rows: terminal.rows, batchOnly: permission.batchOnly === true, siteNotes: permission.siteNotes })) : null, saveSkillPrompt && permission === null ? (_jsx(SaveSkillOverlay, { request: saveSkillPrompt.request, cwd: ctx.cwd, columns: Math.max(1, (terminal.columns ?? 80) - 2), rows: terminal.rows, onAnswer: saveSkillPrompt.resolve }, saveSkillPrompt.request.markdown)) : null, textPrompt ? (_jsx(TextPrompt, { columns: Math.max(1, (terminal.columns ?? 80) - 2), title: textPrompt.title, placeholder: textPrompt.placeholder, initialValue: textPrompt.initialValue, emptyNotice: textPrompt.emptyNotice, hidden: permission !== null || (agentSurface !== null || outputViewer !== null), onSubmit: submitTextPrompt, onCancel: cancelTextPrompt }, textPrompt.token)) : permission === null &&
+                                saveSkillPrompt !== null })) : null, agentSurface === null && outputViewer === null && permission === null ? (_jsx(TaskList, { tasks: liveTasks })) : null, permission ? (_jsx(PermissionOverlay, { toolCalls: permission.toolCalls, review: permission.review, summary: permission.summary, detailsOpen: permissionDetailsOpen, reviewOffset: permissionReviewOffset, choice: permissionChoice, queuedCount: queuedPermissionCount, sourceLabel: permissionSourceLabel, columns: terminal.columns, rows: terminal.rows, batchOnly: permission.batchOnly === true, siteNotes: permission.siteNotes, ...(permission.screenConsent === true
+                                ? { screenConsent: { provider: session?.providerSummary ?? null } }
+                                : {}) })) : null, saveSkillPrompt && permission === null ? (_jsx(SaveSkillOverlay, { request: saveSkillPrompt.request, cwd: ctx.cwd, columns: Math.max(1, (terminal.columns ?? 80) - 2), rows: terminal.rows, onAnswer: saveSkillPrompt.resolve }, saveSkillPrompt.request.markdown)) : null, textPrompt ? (_jsx(TextPrompt, { columns: Math.max(1, (terminal.columns ?? 80) - 2), title: textPrompt.title, placeholder: textPrompt.placeholder, initialValue: textPrompt.initialValue, emptyNotice: textPrompt.emptyNotice, hidden: permission !== null || (agentSurface !== null || outputViewer !== null), onSubmit: submitTextPrompt, onCancel: cancelTextPrompt }, textPrompt.token)) : permission === null &&
                             agentSurface === null &&
                             outputViewer === null &&
                             choicePicker?.kind === 'reasoning-effort' &&
-                            effortSlider ? (_jsx(EffortSlider, { title: choicePicker.title, notice: choicePicker.notice, options: choicePicker.options, selected: selectedChoice, layout: effortSlider, columns: Math.max(1, (terminal.columns ?? 80) - 2), highest: choicePicker.options.at(-2)?.label === 'default' ? undefined : choicePicker.options.at(-2)?.label })) : permission === null && agentSurface === null && outputViewer === null && choicePicker ? (_jsx(ChoicePicker, { busy: 'busy' in choicePicker && choicePicker.busy === true, columns: Math.max(1, (terminal.columns ?? 80) - 2), title: choicePicker.title, notice: choicePicker.notice, options: filterChoiceOptions(choicePicker.options, choiceQuery), query: choicePickerSearchable(choicePicker) ? choiceQuery : undefined, selected: selectedChoice, windowSize: choicePicker.kind === 'command' ? choicePicker.windowSize : undefined })) : permission === null && agentSurface === null && outputViewer === null && copyPicker ? (_jsx(CopyPicker, { targets: copyPicker.targets, selected: selectedCopy })) : null, _jsxs(ComposerFrame, { working: state === 'thinking' || state === 'tool' || visibleActiveTools.length > 0, ...(orchestrateMode ? { mode: 'orchestrate' } : {}), focus: phase === 'ready' &&
+                            effortSlider ? (_jsx(EffortSlider, { title: choicePicker.title, notice: choicePicker.notice, options: choicePicker.options, selected: selectedChoice, layout: effortSlider, columns: Math.max(1, (terminal.columns ?? 80) - 2) })) : permission === null && agentSurface === null && outputViewer === null && choicePicker ? (_jsx(ChoicePicker, { busy: 'busy' in choicePicker && choicePicker.busy === true, columns: Math.max(1, (terminal.columns ?? 80) - 2), title: choicePicker.title, notice: choicePicker.notice, options: filterChoiceOptions(choicePicker.options, choiceQuery), query: choicePickerSearchable(choicePicker) ? choiceQuery : undefined, selected: selectedChoice, windowSize: choicePicker.kind === 'command' ? choicePicker.windowSize : undefined })) : permission === null && agentSurface === null && outputViewer === null && copyPicker ? (_jsx(CopyPicker, { targets: copyPicker.targets, selected: selectedCopy })) : null, _jsxs(ComposerFrame, { working: state === 'thinking' || state === 'tool' || visibleActiveTools.length > 0, ...(hypermode ? { mode: HYPERMODE } : {}), focus: phase === 'ready' &&
                                 state !== 'awaiting-permission' &&
                                 !compacting &&
                                 externalEditorRequest === null &&
@@ -7344,7 +7613,7 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
                                                 ? queuePause.outcome === 'paused'
                                                     ? 'held after a resumable turn paused; wait for recovery, change model, or send a message to release it'
                                                     : `paused after a ${queuePause.outcome} turn; send a message or change model to continue`
-                                                : 'sending when ready'] }) })) : null, _jsx(Composer, { reasoningEffortLevels: session?.reasoningEffortLevels, onCycleMode: cyclePermissionMode, disabled: outputViewer !== null ||
+                                                : 'sending when ready', queuedTriggerLabels(queued)] }) })) : null, _jsx(Composer, { reasoningEffortLevels: session?.reasoningEffortLevels, onCycleMode: cyclePermissionMode, disabled: outputViewer !== null ||
                                         phase !== 'ready' ||
                                         state === 'awaiting-permission' ||
                                         compacting ||
@@ -7365,7 +7634,7 @@ export function App({ ctx: initialCtx, onExitSummary, externalEditor = defaultEx
                                         (handoffPark !== null && state === 'idle'), onSubmit: handleSubmit, onNotice: (text) => pushMessage('system', text), onStepReasoningEffort: stepReasoningEffort, onExternalEdit: requestExternalEditor, onEditPrevious: openPromptEditor, draftToRestore: composerDraft, onDraftRestored: (token) => setComposerDraft((draft) => (draft?.token === token ? null : draft)), onDraftPresenceChange: setComposerHasDraft, onOpenAgentPanel: openAgentCockpit, userCommands: userCommands, builtins: hostCommands.map((command) => ({
                                         ...command,
                                         description: command.unavailable?.(slashCtx) ?? command.description,
-                                    })), mentionCandidates: mentionCandidates, history: history })] })] })), _jsx(StatusBar, { cwd: ctx.cwd, provider: session?.providerSummary ?? null, model: session?.modelSummary ?? null, effort: reasoningEffort, orchestrate: orchestrateMode, goal: statusGoal, state: state, hint: statusHint, permissionMode: displayedPermissionMode, canCycleMode: true }), showComposerSurface &&
+                                    })), mentionCandidates: mentionCandidates, history: history, ...(composerTriggers ? { triggers: composerTriggers } : {}), turnActive: !compacting && (state === 'thinking' || state === 'tool') })] })] })), _jsx(StatusBar, { cwd: ctx.cwd, provider: session?.providerSummary ?? null, model: session?.modelSummary ?? null, effort: reasoningEffort, hypermode: hypermode, goal: statusGoal, state: state, hint: statusHint, permissionMode: displayedPermissionMode, canCycleMode: true }), showComposerSurface &&
                     permission === null &&
                     agentSurface === null &&
                     outputViewer === null ? (_jsx(AgentNarrationBand, { lines: narration })) : null, showComposerSurface &&
@@ -7580,25 +7849,36 @@ function permissionPicker(mode, approvedAll, more = false) {
     };
 }
 /**
- * The picker's sentinel for the orchestrate-mode row, below the rule.
+ * The picker's sentinel for the hypermode row, below the rule.
  *
  * A plain string outside the `ReasoningEffort` union by construction — never
  * added to any model's published menu — so it can share the same picker
  * without ever being mistaken for a level `/effort <token>` could select.
  */
-const ORCHESTRATE_MODE_VALUE = 'orchestrate';
+const HYPERMODE_VALUE = 'hypermode';
+/** ` · ✦ save as skill` when queued messages carry composer triggers, so the queue line says so. */
+function queuedTriggerLabels(queued) {
+    const labels = new Set();
+    for (const prompt of queued) {
+        if (prompt.kind !== 'human')
+            continue;
+        for (const id of prompt.triggers ?? [])
+            labels.add(triggerDefinition(id).label);
+    }
+    return labels.size > 0 ? ` · ✦ ${[...labels].join(', ')}` : '';
+}
 /** Last entry of a low-to-high menu every provider publishes in that order; `undefined` when none is known. */
 function highestReasoningEffort(levels) {
     return levels && levels.length > 0 ? levels[levels.length - 1] : undefined;
 }
-function reasoningEffortPicker(session, current, afterModelSelection = false, orchestrateOn = false) {
+function reasoningEffortPicker(session, current, afterModelSelection = false, hypermodeOn = false) {
     const levels = session.reasoningEffortLevels;
     if (!session.hasProvider || levels === undefined)
         return undefined;
     const effortValues = [undefined, ...levels];
     const values = [
         ...effortValues,
-        ORCHESTRATE_MODE_VALUE,
+        HYPERMODE_VALUE,
     ];
     return {
         kind: 'reasoning-effort',
@@ -7619,12 +7899,11 @@ function reasoningEffortPicker(session, current, afterModelSelection = false, or
             })),
             {
                 // Below a rule, visually apart from the levels above: a session
-                // setting, not a sixth level the provider published.
-                label: 'orchestrate',
-                description: orchestrateOn
-                    ? 'On · highest level and delegate by default'
-                    : 'Off · highest level and delegate by default',
-                current: orchestrateOn,
+                // setting, not a sixth level the provider published. The label
+                // names the level it pins, then the mode.
+                label: hypermodeStopLabel(hypermodeEffort(levels)),
+                description: `${hypermodeOn ? 'On' : 'Off'} · ${HYPERMODE_SUMMARY}`,
+                current: hypermodeOn,
                 ruleBefore: true,
             },
         ],