@sagmans/dsh-tui 0.6.0 → 0.7.0

package/lib/surface/model-choice.js

@@ -0,0 +1,325 @@
+import { ModelSwitch, createModelCatalog, parseModelArgument, readModelRouteKey, } from "../agent/model.js";
+import { stripControlCharacters } from "../text.js";
+import { EffortPicker, ModelPicker, PROVIDER_DEFAULT_EFFORT_ID, effortChoices } from "../ui/picker.js";
+// Adapter errors may contain credentials or request bodies, even in their messages.
+const MODEL_DISCOVERY_FAILURE = 'could not list models; check provider configuration and credentials, then retry /model';
+const PROVIDER_DISCOVERY_FAILURE = 'could not list providers; check provider configuration, then retry /model';
+/**
+ * Which model and reasoning effort this session runs with, and the two pickers
+ * that change them.
+ *
+ * The switch and the catalog are one owner because a choice only means
+ * something against the directory it was read from: the rows of the model list
+ * stream in as each provider's adapter answers, and the levels belong to the
+ * exact route. The route in force is resolved against the status facts as much
+ * as against the switch, because a session that has chosen nothing runs the
+ * settings-backed default the footer states.
+ */
+export function createModelChoice(ctx, ports) {
+    const modelSwitch = new ModelSwitch();
+    const catalog = createModelCatalog(ctx);
+    const runModelCommand = (argument) => {
+        if (catalog === undefined) {
+            ports.notice('this profile has no llm service, so models cannot be listed or switched');
+            ports.render();
+            return;
+        }
+        let providers;
+        try {
+            providers = catalog.providers();
+        }
+        catch {
+            ports.notice(PROVIDER_DISCOVERY_FAILURE);
+            ports.render();
+            return;
+        }
+        const command = parseModelArgument(argument, providers, modelSwitch.current());
+        switch (command.kind) {
+            case 'current':
+                // Choosing by eye is the point of a terminal selector; the picker
+                // heads itself with the route the next step will actually use.
+                void openModelPicker(providers);
+                return;
+            case 'list-models':
+                void catalog.models(command.provider).then(entries => {
+                    ports.notice(entries.length === 0
+                        ? `${command.provider} advertises no models; an id may still work`
+                        : `${command.provider}: ${entries.map(entry => entry.id).join(' ')}`);
+                    ports.render();
+                }).catch(() => {
+                    ports.notice(`${stripControlCharacters(command.provider)}: ${MODEL_DISCOVERY_FAILURE}`);
+                    ports.render();
+                });
+                return;
+            case 'switch': {
+                const choice = command.choice;
+                if (choice.reasoningEffort === undefined) {
+                    // Naming no level still leaves one in force, and the model the reader
+                    // is moving to decides whether it can take it: a level the request
+                    // path would refuse makes an otherwise usable model look broken.
+                    void (async () => {
+                        const carried = await carriedEffort(choice.provider, choice.model);
+                        modelSwitch.choose({
+                            provider: choice.provider,
+                            model: choice.model,
+                            ...(carried.effort === undefined ? {} : { reasoningEffort: carried.effort }),
+                        });
+                        ports.notice(`model set to ${choice.provider}/${choice.model} for the next step${droppedClause(carried.dropped)}`);
+                        ports.render();
+                    })();
+                    return;
+                }
+                // The route decides which efforts exist, so an explicit one is checked
+                // against the adapter before it is put in force: a typo must not become
+                // a request the provider rejects.
+                void (async () => {
+                    try {
+                        const info = await catalog.efforts(choice.provider, choice.model);
+                        const efforts = info?.efforts ?? [];
+                        if (!efforts.some(effort => effort.id === choice.reasoningEffort)) {
+                            ports.notice(efforts.length === 0
+                                ? `/model: ${choice.provider}/${choice.model} advertises no reasoning efforts`
+                                : `/model: ${choice.provider}/${choice.model} does not offer reasoning effort "${choice.reasoningEffort}" — offers: ${efforts.map(effort => effort.id).join(' ')}`);
+                            ports.render();
+                            return;
+                        }
+                        modelSwitch.choose(choice);
+                        ports.notice(`model set to ${choice.provider}/${choice.model} (${choice.reasoningEffort}) for the next step`);
+                    }
+                    catch (error) {
+                        ports.notice(`/model: could not read reasoning efforts: ${error instanceof Error ? error.message : String(error)}`);
+                    }
+                    ports.render();
+                })();
+                return;
+            }
+            case 'invalid':
+                ports.notice(`/model: ${command.reason}`);
+                ports.render();
+                return;
+        }
+    };
+    /** Whether a route's effort list is being read, so a second key cannot race it. */
+    let openingEfforts = false;
+    /** Put the reader's effort choice in force for the next step. */
+    const applyEffort = (provider, modelId, effortId) => {
+        modelSwitch.choose(effortId === PROVIDER_DEFAULT_EFFORT_ID
+            ? { provider, model: modelId }
+            : { provider, model: modelId, reasoningEffort: effortId });
+        ports.notice(`reasoning effort for ${provider}/${modelId} set to ${effortId === PROVIDER_DEFAULT_EFFORT_ID ? 'provider default' : effortId} for the next step`);
+        ports.render();
+    };
+    /** Whether a model picker's catalog is being read, so a second key cannot race it. */
+    let openingModels = false;
+    /**
+     * The route the next step would actually use.
+     *
+     * Without a choice of its own the surface reports the composition default,
+     * not that it has no opinion: the picker's heading and its marked row have to
+     * agree with the status line about the route in force.
+     */
+    const effectiveRoute = () => {
+        const chosen = modelSwitch.current();
+        if (chosen !== undefined)
+            return chosen;
+        const facts = ports.statusFacts();
+        if (facts.provider === undefined || facts.model === undefined)
+            return undefined;
+        return {
+            provider: facts.provider,
+            model: facts.model,
+            ...facts.effort === undefined ? {} : { reasoningEffort: facts.effort },
+        };
+    };
+    /**
+     * The effort a switch may carry onto the route it lands on.
+     *
+     * The levels belong to the exact route, so the level in force is checked
+     * against the model the reader moves to: the request path refuses an
+     * unsupported level before the provider sees it, and that refusal reads as
+     * the chosen model being broken. The model's own default is the fallback the
+     * picker's provider-default row also produces, and the level given up is
+     * named because silence would leave the reader reading a level that is no
+     * longer in force.
+     */
+    const carriedEffort = async (provider, modelId) => {
+        const inForce = effectiveRoute()?.reasoningEffort;
+        if (inForce === undefined || catalog === undefined)
+            return {};
+        try {
+            const efforts = (await catalog.efforts(provider, modelId))?.efforts ?? [];
+            return efforts.some(effort => effort.id === inForce) ? { effort: inForce } : { dropped: inForce };
+        }
+        catch {
+            // The directory is advisory here: a switch the reader asked for must not
+            // fail on it, and a route's default is the one state every model accepts.
+            return {};
+        }
+    };
+    /** The clause a switch adds when the effort in force could not travel with it. */
+    const droppedClause = (dropped) => dropped === undefined
+        ? ''
+        : ` — dropped reasoning effort "${dropped}" because this model does not offer it`;
+    /** Put the reader's route choice in force for the next step. */
+    const applyRoute = async (route) => {
+        const carried = await carriedEffort(route.provider, route.model);
+        modelSwitch.choose({
+            provider: route.provider,
+            model: route.model,
+            ...(carried.effort === undefined ? {} : { reasoningEffort: carried.effort }),
+        });
+        ports.notice(`model set to ${route.provider}/${route.model} for the next step${droppedClause(carried.dropped)}`);
+        ports.render();
+    };
+    /**
+     * Offer the levels a route advertises, after the route is already in force.
+     *
+     * Cancelling the list is a real choice — the reader keeps the model with the
+     * provider's own default — which is why the route is applied first. The list
+     * is read before the picker opens because the rows are the route's own
+     * metadata; a menu painted before that arrived could offer a level the
+     * request would then be refused for.
+     */
+    const offerRouteEfforts = async (route) => {
+        if (catalog === undefined)
+            return;
+        try {
+            const info = await catalog.efforts(route.provider, route.model);
+            const efforts = info?.efforts ?? [];
+            if (efforts.length === 0)
+                return;
+            const current = effectiveRoute();
+            const effective = current !== undefined && current.provider === route.provider && current.model === route.model
+                ? current.reasoningEffort
+                : undefined;
+            const picked = await ports.openPicker(new EffortPicker(() => effortChoices(efforts, effective), `reasoning effort · ${route.provider}/${route.model}`, ports.keymap));
+            if (picked !== undefined)
+                applyEffort(route.provider, route.model, picked);
+        }
+        catch (error) {
+            ports.notice(`could not read reasoning efforts: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        ports.render();
+    };
+    /**
+     * Offer every model the configured routes advertise.
+     *
+     * Rows come from the routes the llm service registered — the providers this
+     * deployment configured — and each provider's models join the open list as
+     * its catalog resolves, so the picker is filterable before the slowest
+     * adapter answers. A route whose catalog cannot be read stays reachable by
+     * name through the text form; a notice explains why its rows are missing.
+     */
+    const openModelPicker = async (providers) => {
+        if (catalog === undefined) {
+            ports.notice('this profile has no llm service, so models cannot be listed or switched');
+            ports.render();
+            return;
+        }
+        if (providers.length === 0) {
+            ports.notice('no provider is configured; add one before choosing a model');
+            ports.render();
+            return;
+        }
+        if (openingModels)
+            return;
+        openingModels = true;
+        try {
+            const routes = [];
+            for (const provider of providers) {
+                void catalog.models(provider.id).then(entries => {
+                    if (entries.length === 0)
+                        return;
+                    routes.push(...entries.map(entry => ({ provider: provider.id, model: entry.id, name: entry.name })));
+                    ports.render();
+                }).catch(() => {
+                    ports.notice(`${stripControlCharacters(provider.id)}: ${MODEL_DISCOVERY_FAILURE}`);
+                    ports.render();
+                });
+            }
+            const picked = await ports.openPicker(new ModelPicker(() => routes, effectiveRoute, ports.keymap));
+            if (picked === undefined)
+                return;
+            const route = readModelRouteKey(picked);
+            if (route === undefined)
+                return;
+            await applyRoute(route);
+            await offerRouteEfforts(route);
+        }
+        finally {
+            openingModels = false;
+            ports.render();
+        }
+    };
+    /**
+     * Offer the efforts the route in force advertises.
+     *
+     * The list is read before the picker opens because the rows are the route's
+     * own metadata; a menu painted before that arrived could offer a level the
+     * request would then be refused for.
+     */
+    const openEffortPicker = async () => {
+        if (catalog === undefined) {
+            ports.notice('this profile has no llm service, so reasoning efforts cannot be read');
+            ports.render();
+            return;
+        }
+        const facts = ports.statusFacts();
+        if (facts.provider === undefined || facts.model === undefined) {
+            ports.notice('no model route is in use; /model <provider>/<model> picks one first');
+            ports.render();
+            return;
+        }
+        if (openingEfforts)
+            return;
+        openingEfforts = true;
+        try {
+            const info = await catalog.efforts(facts.provider, facts.model);
+            const efforts = info?.efforts ?? [];
+            if (efforts.length === 0) {
+                ports.notice(`${facts.provider}/${facts.model} advertises no reasoning efforts`);
+                return;
+            }
+            const picked = await ports.openPicker(new EffortPicker(() => effortChoices(efforts, facts.effort), `reasoning effort · ${facts.provider}/${facts.model}`, ports.keymap));
+            if (picked !== undefined)
+                applyEffort(facts.provider, facts.model, picked);
+        }
+        catch (error) {
+            ports.notice(`could not read reasoning efforts: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        finally {
+            openingEfforts = false;
+            ports.render();
+        }
+    };
+    /**
+     * Put the deployment default in force before the first turn.
+     *
+     * The agent is created before the settings file has been read, so the route
+     * its loop captured is the composition placeholder; the reader's default —
+     * effort included — only exists by the time they can type. Adopting it here
+     * is what makes the status line's route the one the request actually uses.
+     */
+    const adoptDefault = () => {
+        if (modelSwitch.current() !== undefined)
+            return;
+        const facts = ports.statusFacts();
+        if (facts.provider === undefined || facts.model === undefined)
+            return;
+        modelSwitch.adopt({
+            provider: facts.provider,
+            model: facts.model,
+            ...(facts.effort === undefined ? {} : { reasoningEffort: facts.effort }),
+        });
+    };
+    return {
+        current: () => modelSwitch.current(),
+        setup: agentCtx => modelSwitch.install(agentCtx),
+        adoptDefault,
+        runModelCommand,
+        openEffortPicker: () => {
+            void openEffortPicker();
+        },
+    };
+}
+//# sourceMappingURL=model-choice.js.map

package/lib/surface/model-choice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-choice.js","sourceRoot":"","sources":["../../src/surface/model-choice.ts"],"names":[],"mappings":"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"}

package/lib/surface/preset-choice.d.ts

@@ -0,0 +1,78 @@
+import type { SessionId } from '@deepseek-ai/dsh-session';
+import type { ForkInheritance, TuiAgent } from '../agent/host.ts';
+import { type PresetRoster } from '../agent/presets.ts';
+import type { Keymap } from '../input/actions.ts';
+import type { Picker } from './modal-input.ts';
+/**
+ * What the mode owner needs from the surface that composes it.
+ *
+ * The roster arrives as a handle because the open path mounts through it as
+ * well, and the stored mode is a property of a log this surface only reads. The
+ * screen, the keyboard, the notice, and the session the reader is watching
+ * belong to the surface that owns them; the keys move with a settings edit, so
+ * they are read per press.
+ */
+export interface PresetChoicePorts {
+    readonly agentPresets: PresetRoster | undefined;
+    /** The mode named on the command line, which is the only one that may conflict. */
+    readonly requestedPreset: string | undefined;
+    /** The mode a stored session's own log recorded, absent when it recorded none. */
+    readonly storedPreset: (id: SessionId) => Promise<string | undefined>;
+    /** The mode a live session runs right now, which only its own projection knows. */
+    readonly livePreset: (id: SessionId) => string | undefined;
+    /**
+     * The agent this terminal drives, read at call time.
+     *
+     * Opening a session replaces it, so a command typed after that switch has to
+     * reach the agent now on screen rather than the one it replaced.
+     */
+    readonly drivingAgent: () => TuiAgent | undefined;
+    readonly keymap: () => Keymap;
+    /** Take the keyboard for a list and answer with the pick id it settled on. */
+    readonly openPicker: (picker: Picker) => Promise<string | undefined>;
+    readonly notice: (message: string) => void;
+    readonly render: () => void;
+    /**
+     * Show the session this terminal drives again.
+     *
+     * Navigation belongs to the surface that owns the view, so the mode owner only
+     * decides when a switch needs the reader looking at the session it landed on.
+     */
+    readonly returnToDrivenSession: () => Promise<void>;
+}
+/** The launch a run was started for, as the mode it named has to be read. */
+export interface PresetLaunch {
+    /** The session this run opens. */
+    readonly sessionId: SessionId;
+    readonly resume: boolean;
+    /**
+     * Whether a bare `--resume` still has to ask which session to open.
+     *
+     * The mode a stored session recorded can only be compared with the run's own
+     * flag once that pick lands, so the conflict waits for the chosen session.
+     */
+    readonly resumePicker: boolean;
+}
+/** The reads and operations the composing surface routes to the mode owner. */
+export interface PresetChoice {
+    /** The mode one agent joins. */
+    readonly presetFor: (id: SessionId, resume: boolean, fork: ForkInheritance | undefined) => Promise<string | undefined>;
+    /** Resolve the named mode and refuse a launch that cannot run it. */
+    readonly validateLaunch: (launch: PresetLaunch) => Promise<void>;
+    /** Show or choose the mode this session runs. */
+    readonly runPresetCommand: (argument: string) => void;
+    /** The mode a session starting now would take. */
+    readonly currentSeat: () => string | undefined;
+}
+/**
+ * Which mode a session runs — its seat in the roster — and the two ways it
+ * changes.
+ *
+ * The seat is one value for the whole run: a launch flag seeds it and a
+ * successful switch updates it, so `/new` and `/fork` land in the mode the
+ * reader last chose. A resumed session keeps the mode its own log recorded,
+ * because swapping it would leave logged tool calls the new composition cannot
+ * make — the same reason the harness refuses a switch once a turn has run.
+ */
+export declare function createPresetChoice(ports: PresetChoicePorts): PresetChoice;
+//# sourceMappingURL=preset-choice.d.ts.map

package/lib/surface/preset-choice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-choice.d.ts","sourceRoot":"","sources":["../../src/surface/preset-choice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AACjE,OAAO,EAAuB,KAAK,YAAY,EAAsB,MAAM,qBAAqB,CAAA;AAChG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAEjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAE9C;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,EAAE,YAAY,GAAG,SAAS,CAAA;IAC/C,mFAAmF;IACnF,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5C,kFAAkF;IAClF,QAAQ,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACrE,mFAAmF;IACnF,QAAQ,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,MAAM,GAAG,SAAS,CAAA;IAC1D;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,QAAQ,GAAG,SAAS,CAAA;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAA;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACpE,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAA;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,qBAAqB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACpD;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;CAC/B;AAED,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,GAAG,SAAS,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACtH,qEAAqE;IACrE,QAAQ,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE,iDAAiD;IACjD,QAAQ,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACrD,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;CAC/C;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAyJzE"}

package/lib/surface/preset-choice.js

@@ -0,0 +1,163 @@
+import { parsePresetArgument } from "../agent/presets.js";
+import { PresetPicker } from "../ui/picker.js";
+/**
+ * Which mode a session runs — its seat in the roster — and the two ways it
+ * changes.
+ *
+ * The seat is one value for the whole run: a launch flag seeds it and a
+ * successful switch updates it, so `/new` and `/fork` land in the mode the
+ * reader last chose. A resumed session keeps the mode its own log recorded,
+ * because swapping it would leave logged tool calls the new composition cannot
+ * make — the same reason the harness refuses a switch once a turn has run.
+ */
+export function createPresetChoice(ports) {
+    const requestedPreset = ports.requestedPreset;
+    /**
+     * The mode a session the reader starts from here on joins.
+     *
+     * A launch flag seeds it and a successful switch updates it, so `/new` and
+     * `/fork` land in the mode the reader last chose; nothing is written to
+     * settings, because the mode of a session is not a property of the machine.
+     * Unset means nobody chose, which is where the roster's default applies.
+     */
+    let seat = requestedPreset;
+    /**
+     * The mode a session takes its seat in: the reader's latest choice, or the
+     * roster's default read at this moment.
+     *
+     * The default cannot be captured when this row applies: it comes from the
+     * settings document, which may be read after that, so a captured copy would
+     * pin every later session to the mode the bundle happened to ship.
+     */
+    const seatMode = () => seat ?? ports.agentPresets?.defaultId;
+    /** The roster as the picker paints it, refreshed when the picker opens. */
+    let presetRows = [];
+    /** Choose the mode a session that has not started yet will run. */
+    const askForPreset = async (currentId) => {
+        const roster = ports.agentPresets;
+        if (roster === undefined)
+            return undefined;
+        presetRows = await roster.list();
+        return await ports.openPicker(new PresetPicker(() => presetRows, () => currentId, ports.keymap));
+    };
+    /** The stored mode's roster row, or undefined when the roster no longer offers it. */
+    const resolveStored = async (id, stored) => {
+        try {
+            return (await ports.agentPresets?.resolve(stored))?.id;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    /**
+     * The mode one agent joins.
+     *
+     * A resumed session keeps the composition its own log recorded, because
+     * swapping it would leave logged tool calls the new composition cannot make —
+     * the same reason the harness refuses a switch once a turn has run. A session
+     * that recorded none, which is every session written before modes existed,
+     * takes the seat; a branch inherits the mode its parent is running.
+     */
+    const presetFor = async (id, resume, fork) => {
+        const roster = ports.agentPresets;
+        if (roster === undefined)
+            return undefined;
+        if (fork !== undefined)
+            return ports.livePreset(fork.from) ?? seatMode();
+        if (!resume)
+            return seatMode();
+        const stored = await ports.storedPreset(id);
+        if (stored === undefined)
+            return seatMode();
+        const resolvedStored = await resolveStored(id, stored);
+        if (resolvedStored === undefined) {
+            // The composition this session recorded is gone. Naming one explicitly is
+            // the reader's only way forward, so that is the one case an override is
+            // taken for a stored session.
+            if (requestedPreset !== undefined)
+                return (await roster.resolve(requestedPreset)).id;
+            throw new Error(`session ${id} runs mode "${stored}", which this roster no longer offers; name another with --preset`);
+        }
+        if (requestedPreset !== undefined && requestedPreset !== resolvedStored) {
+            throw new Error(`session ${id} runs mode "${resolvedStored}", so --preset ${requestedPreset} does not apply; /preset ${requestedPreset} switches it before its first turn`);
+        }
+        return resolvedStored;
+    };
+    /** Join this session to another mode and remember it for the next session. */
+    const applyPreset = async (id) => {
+        const roster = ports.agentPresets;
+        const agent = ports.drivingAgent();
+        if (roster === undefined || agent === undefined)
+            return;
+        try {
+            const chosen = await roster.select(agent.agent, id);
+            seat = chosen;
+            // The durable selection is folded as a marker on the session it belongs
+            // to, so a reader watching a child has to come back to see it.
+            await ports.returnToDrivenSession();
+        }
+        catch (error) {
+            ports.notice(`could not switch the mode: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        ports.render();
+    };
+    /**
+     * Show or choose the mode this session runs.
+     *
+     * The mode decides which tools, prompt sections, and skills exist at all, so
+     * it is fixed once a turn has run: the harness refuses the swap and this
+     * surface explains why rather than pretending otherwise. Before the first
+     * turn the switch is recorded in the log, which is what keeps the transcript
+     * honest about the composition later turns ran under.
+     */
+    const runPresetCommand = (argument) => {
+        const roster = ports.agentPresets;
+        if (roster === undefined) {
+            ports.notice('this profile has no agent roster, so there is no mode to choose');
+            ports.render();
+            return;
+        }
+        const agent = ports.drivingAgent();
+        if (agent === undefined) {
+            ports.notice('the agent is still starting; try again in a moment');
+            ports.render();
+            return;
+        }
+        const session = agent.agent.session;
+        const current = roster.current(session);
+        const command = parsePresetArgument(argument);
+        if (command.kind === 'pick') {
+            if (roster.started(session)) {
+                ports.notice(`this session runs ${current === undefined ? 'a mode' : `"${current}"`} and has already started, so its mode is fixed — /new starts a fresh session`);
+                ports.render();
+                return;
+            }
+            void askForPreset(current).then(picked => picked === undefined ? undefined : applyPreset(picked));
+            return;
+        }
+        void applyPreset(command.id);
+    };
+    /**
+     * Resolve the mode named on the command line and refuse a launch that cannot
+     * run it.
+     *
+     * Raised while the launcher still owns the terminal, because the alternate
+     * screen closes over whatever was painted on it: a mode this roster does not
+     * offer has to be answered here rather than as a blank screen.
+     */
+    const validateLaunch = async (launch) => {
+        const roster = ports.agentPresets;
+        if (requestedPreset !== undefined && roster !== undefined) {
+            seat = (await roster.resolve(requestedPreset)).id;
+        }
+        if (!launch.resumePicker)
+            await presetFor(launch.sessionId, launch.resume, undefined);
+    };
+    return {
+        presetFor,
+        validateLaunch,
+        runPresetCommand,
+        currentSeat: seatMode,
+    };
+}
+//# sourceMappingURL=preset-choice.js.map

package/lib/surface/preset-choice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-choice.js","sourceRoot":"","sources":["../../src/surface/preset-choice.ts"],"names":[],"mappings":"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"}