@dsh-cc/tui 0.5.0

package/lib/harness/driver-hud.js

@@ -0,0 +1,204 @@
+/**
+ * Statusline HUD + sessionProjections feed for the TUI driver.
+ *
+ * Migrated out of createDriver (harness/driver.ts) as a free-function
+ * collaborator so the factory stays under the line budget. Receives a
+ * structural {@link DriverHudCtx} instead of importing the factory (no cycle).
+ *
+ * Owned state: the git-branch probe result, the sessionProjections handle, and
+ * the derived HUD patch path. Exposes back to createDriver the pieces the
+ * factory (runLocal usage panel) and switchSession still need: applyUsage,
+ * projections, statusLineOf, seedHud, seedTodos, refreshBranch.
+ * @module @dsh-cc/tui/harness/driver-hud
+ */
+import { setHud, setTodos, setTurnActive, setUsage, } from "../store.js";
+import { breakdownOf, occupancyOf, percentOf, sameTodos, sameUsage, todosOf, tokensOf, totalsOf, usageViewOf, } from "./usage-view.js";
+import { formatModeLine, formatStatusLine } from "../statusline.js";
+import { truncateToWidth } from '@dsh-cc/pi-tui';
+/**
+ * Build the statusline HUD section. Runs the boot sequence on construction —
+ * in original order: branch probe, seed HUD/todos from live projections, anchor
+ * the working line if busy, then subscribe to the change feed — so createDriver
+ * needs no extra call.
+ */
+export function createHudSection(rt) {
+    const { state, emit, ctx, cwd, current, selection, branchProbe, statusline } = rt;
+    // --- Branch: one best-effort probe at boot and after each switchSession (the
+    // cwd may differ per session). Async is fine — a late landing re-emits so
+    // the footer picks it up; a probe superseded by a switch is dropped by the
+    // sequence check. The probe never throws; failures just omit the segment.
+    // No timer, one probe per (re)bind — zero polling.
+    let branch;
+    let branchSeq = 0;
+    const refreshBranch = () => {
+        const seq = ++branchSeq;
+        const dir = current.agent.session.header.cwd ?? cwd;
+        void Promise.resolve(branchProbe(dir))
+            .catch(() => undefined)
+            .then(next => {
+            if (seq !== branchSeq || next === branch)
+                return;
+            branch = next;
+            // Same-reference emit: re-notifies subscribers so root re-reads the
+            // statusline getter with the fresh branch.
+            emit(state());
+        });
+    };
+    refreshBranch();
+    // Projections: seed once from stateOf (a resumed session may already be
+    // populated), then keep the hud fresh from the change feed — event-driven,
+    // filtered to the live session so late events from a disposed session are
+    // dropped by the id mismatch.
+    const projections = ctx.get('sessionProjections');
+    const applyHud = (patch) => {
+        const hud = state().hud;
+        const percentSame = patch.contextPercent === undefined || hud?.contextPercent === patch.contextPercent;
+        const tokens = patch.tokens;
+        const tokensSame = tokens === undefined
+            || (hud?.tokens !== undefined && hud.tokens.input === tokens.input && hud.tokens.output === tokens.output);
+        const detail = patch.contextTokens;
+        const detailSame = detail === undefined
+            || (hud?.contextTokens !== undefined
+                && hud.contextTokens.used === detail.used
+                && hud.contextTokens.window === detail.window);
+        if (percentSame && tokensSame && detailSame)
+            return; // emit only on an actual change
+        emit(setHud(state(), patch));
+    };
+    const applyUsage = (patch) => {
+        if (patch === undefined)
+            return;
+        const s = state();
+        const merged = { ...s.usage, ...patch };
+        if (sameUsage(s.usage, merged))
+            return;
+        emit(setUsage(s, merged));
+    };
+    const seedHud = () => {
+        statusline?.onRebind();
+        const s = state();
+        const patch = {};
+        if (projections !== undefined) {
+            const tokens = tokensOf(projections.stateOf(current.agent.session, 'tokenUsage'));
+            if (tokens !== undefined)
+                patch.tokens = tokens;
+            const pressure = projections.stateOf(current.agent.session, 'contextPressure');
+            const percent = percentOf(pressure);
+            if (percent !== undefined)
+                patch.contextPercent = percent;
+            const occupancy = occupancyOf(pressure);
+            if (occupancy !== undefined)
+                patch.contextTokens = occupancy;
+        }
+        // Replace wholesale: clear first so stale fields from a previous session
+        // never leak, then apply whatever the new session actually has.
+        let next = setHud(s, undefined);
+        if (patch.contextPercent !== undefined || patch.tokens !== undefined || patch.contextTokens !== undefined) {
+            next = setHud(next, patch);
+        }
+        if (next !== s)
+            emit(next);
+    };
+    // Todos: same seeding contract as the HUD — stateOf at (re)bind, then the
+    // change feed. Absent (`null` before the first write) clears the strip so
+    // no cross-session leak survives a switch.
+    const seedTodos = () => {
+        const s = state();
+        const value = projections === undefined
+            ? undefined
+            : projections.stateOf(current.agent.session, 'todos');
+        const todos = todosOf(value);
+        if (sameTodos(s.todos, todos))
+            return;
+        emit(setTodos(s, todos));
+    };
+    seedHud();
+    seedTodos();
+    // Boot may resume a log that ended mid-turn (crashed process): the setBusy
+    // sync above flipped busy from the ground-truth agent status, so anchor the
+    // working line here — deliberately after seedHud, so outputBase reads the
+    // seeded token totals instead of pinning an unseeded baseline.
+    if (state().busy) {
+        emit(setTurnActive(state(), { startedAt: Date.now(), outputBase: state().hud?.tokens?.output }));
+    }
+    if (projections !== undefined) {
+        projections.onChanged((session, key, value) => {
+            if (session.id !== current.agent.session.id)
+                return;
+            statusline?.onProjection(key);
+            if (key === 'tokenUsage') {
+                const usage = value;
+                const tokens = tokensOf(usage);
+                if (tokens !== undefined)
+                    applyHud({ tokens });
+                applyUsage(usageViewOf(totalsOf(usage), undefined, undefined));
+                // Working-line rebase guard: an anchor created before the HUD was
+                // seeded carries outputBase === undefined; the first tokenUsage
+                // change pins it. Strictly turn-MODIFYING (turn must already exist) —
+                // a tokenUsage emit while idle must never conjure a phantom anchor.
+                // setTurnActive re-derives verbIndex deterministically from the
+                // unchanged startedAt, so this is a pure baseline pin; the live
+                // stepStartedAt passes through so pinning never resets a mid-step
+                // clock.
+                const turn = state().turn;
+                if (turn !== undefined && turn.outputBase === undefined && tokens !== undefined) {
+                    emit(setTurnActive(state(), { startedAt: turn.startedAt, outputBase: tokens.output, stepStartedAt: turn.stepStartedAt }));
+                }
+            }
+            else if (key === 'contextPressure') {
+                const pressure = value;
+                const percent = percentOf(pressure);
+                const occupancy = occupancyOf(pressure);
+                if (percent === undefined && occupancy === undefined)
+                    return;
+                applyHud({
+                    ...percent === undefined ? {} : { contextPercent: percent },
+                    ...occupancy === undefined ? {} : { contextTokens: occupancy },
+                });
+                applyUsage(usageViewOf(undefined, occupancy, undefined));
+            }
+            else if (key === 'todos') {
+                const todos = todosOf(value);
+                if (sameTodos(state().todos, todos))
+                    return;
+                emit(setTodos(state(), todos));
+            }
+            else if (key === 'contextBreakdown') {
+                applyUsage(usageViewOf(undefined, undefined, breakdownOf(value)));
+            }
+        });
+    }
+    const statusLineOf = (width) => {
+        // Custom statusLine (plan §3.2/D3/D4): active → the command's rows with
+        // padding plus a client-drawn mode row below; inactive → today's built-in
+        // line, byte-identical.
+        const custom = statusline?.override();
+        if (custom !== undefined) {
+            // Blank detection must trim: with padding > 0 an all-blank settle is
+            // whitespace, not ''. Blank → the mode row alone.
+            if (custom.trim().length === 0)
+                return formatModeLine(state().permissionMode);
+            const rows = custom.split('\n');
+            const clipped = width === undefined
+                ? rows
+                : rows.map(row => truncateToWidth(row, width));
+            return `${clipped.join('\n')}\n${formatModeLine(state().permissionMode)}`;
+        }
+        const effort = selection.current?.reasoningEffort;
+        const s = state();
+        return formatStatusLine({
+            cwd: current.agent.session.header.cwd ?? cwd,
+            sessionId: String(current.agent.session.id),
+            permissionMode: s.permissionMode,
+            ...selection.current === undefined ? {} : { model: selection.current.model },
+            ...effort === undefined ? {} : { effort },
+            ...branch === undefined ? {} : { branch },
+            ...s.hud?.contextPercent === undefined ? {} : { contextPercent: s.hud.contextPercent },
+            ...s.hud?.contextTokens === undefined ? {} : { contextTokens: s.hud.contextTokens },
+            ...s.hud?.tokens === undefined ? {} : { tokens: s.hud.tokens },
+            busy: s.busy,
+        }, width === undefined ? {} : { width });
+    };
+    return { refreshBranch, seedHud, seedTodos, applyUsage, projections, statusLineOf };
+}
+//# sourceMappingURL=driver-hud.js.map

package/lib/harness/driver-hud.js.map

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

package/lib/harness/driver-live.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Live session folds shared by the driver factory and its sections: the
+ * effective permission mode (plan overlay, else the durable override) and the
+ * LIVE session working directory (the session-cwd plugin's durable
+ * `worktree/entered` fold, then the boot-time header cwd).
+ *
+ * @module @dsh-cc/tui/harness/driver-live
+ */
+import type { Agent } from '@deepseek-ai/dsh-agent';
+export declare function liveMode(agent: Agent, fallback: string): string;
+/** Duck-typed face of the host context carrying the permission-rules engine. */
+type RulesHostCtx = {
+    get(key: string): unknown;
+};
+/**
+ * The LIVE merged settings `permissions.defaultMode` (the engine rebuilds it
+ * on settings reload), falling back to the literal `'default'` when the
+ * permission-rules engine is not mounted. Structural on purpose: the driver
+ * must not depend on the engine's class shape.
+ */
+export declare function liveDefaultMode(ctx: RulesHostCtx): string;
+/**
+ * `liveMode` with the F1 fallback bound to the host context: sections call
+ * `liveMode(agent)` and the fallback resolves to the permission-rules
+ * engine's LIVE merged settings defaultMode (literal `'default'` when the
+ * engine is not mounted). An explicit `fallback` still wins.
+ */
+export declare function liveModeWithDefault(ctx: RulesHostCtx): (agent: Agent, fallback?: string) => string;
+/**
+ * The LIVE session working directory: the session-cwd plugin's durable
+ * `worktree/entered` fold first (authoritative across EnterWorktree/
+ * ExitWorktree moves), then the boot-time header cwd.
+ */
+export declare function liveSessionCwd(agent: Agent, fallback: string): string;
+export {};
+//# sourceMappingURL=driver-live.d.ts.map

package/lib/harness/driver-live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-live.d.ts","sourceRoot":"","sources":["../../src/harness/driver-live.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAKnD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,gFAAgF;AAChF,KAAK,YAAY,GAAG;IAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAA;AAEjD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAGzD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,YAAY,GAChB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/lib/harness/driver-live.js

@@ -0,0 +1,44 @@
+/**
+ * Live session folds shared by the driver factory and its sections: the
+ * effective permission mode (plan overlay, else the durable override) and the
+ * LIVE session working directory (the session-cwd plugin's durable
+ * `worktree/entered` fold, then the boot-time header cwd).
+ *
+ * @module @dsh-cc/tui/harness/driver-live
+ */
+import { foldPlanMode } from '@deepseek-ai/dsh-plan-mode';
+import { foldPermissionMode } from '@dsh-cc/permission-rules';
+import { foldSessionCwd } from '@dsh-cc/session-cwd';
+export function liveMode(agent, fallback) {
+    if (foldPlanMode(agent.session.events))
+        return 'plan';
+    return foldPermissionMode(agent.session.events) ?? fallback;
+}
+/**
+ * The LIVE merged settings `permissions.defaultMode` (the engine rebuilds it
+ * on settings reload), falling back to the literal `'default'` when the
+ * permission-rules engine is not mounted. Structural on purpose: the driver
+ * must not depend on the engine's class shape.
+ */
+export function liveDefaultMode(ctx) {
+    const rules = ctx.get('permissionRules');
+    return rules?.defaultMode ?? 'default';
+}
+/**
+ * `liveMode` with the F1 fallback bound to the host context: sections call
+ * `liveMode(agent)` and the fallback resolves to the permission-rules
+ * engine's LIVE merged settings defaultMode (literal `'default'` when the
+ * engine is not mounted). An explicit `fallback` still wins.
+ */
+export function liveModeWithDefault(ctx) {
+    return (agent, fallback) => liveMode(agent, fallback ?? liveDefaultMode(ctx));
+}
+/**
+ * The LIVE session working directory: the session-cwd plugin's durable
+ * `worktree/entered` fold first (authoritative across EnterWorktree/
+ * ExitWorktree moves), then the boot-time header cwd.
+ */
+export function liveSessionCwd(agent, fallback) {
+    return foldSessionCwd(agent.session.events) ?? agent.session.header.cwd ?? fallback;
+}
+//# sourceMappingURL=driver-live.js.map

package/lib/harness/driver-live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-live.js","sourceRoot":"","sources":["../../src/harness/driver-live.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD,MAAM,UAAU,QAAQ,CAAC,KAAY,EAAE,QAAgB;IACrD,IAAI,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAA;IACrD,OAAO,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAA;AAC7D,CAAC;AAKD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAiB;IAC/C,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAyC,CAAA;IAChF,OAAO,KAAK,EAAE,WAAW,IAAI,SAAS,CAAA;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAiB;IAEjB,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC,CAAA;AAC/E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,QAAgB;IAC3D,OAAO,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,QAAQ,CAAA;AACrF,CAAC"}

package/lib/harness/driver-modal.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Modal pipeline (approvals + questions sharing one FIFO) extracted from
+ * harness/driver.ts. Free-function collaborator: `createModalQueue` takes a
+ * {@link DriverModalCtx} instead of closing over createDriver's locals, so the
+ * harness factory stays out of this leaf. Emits re-read the current view-model
+ * via `rt.state()` after every emit (createDriver rebinds `state` on emit).
+ * @module @dsh-cc/tui/harness/driver-modal
+ */
+import { type ApprovalPreview, type ApprovalView, type QuestionView } from '../store.ts';
+import type { ApprovalOutcome } from '@deepseek-ai/dsh-user-approval';
+import type { AskUserQuestionAnswer } from '@deepseek-ai/dsh-user-questions';
+import type { DriverModalCtx } from './driver-ctx.ts';
+export type ApprovalEntry = {
+    kind: 'approval';
+    view: ApprovalView;
+    resolve: (outcome: ApprovalOutcome) => void;
+    /** The requesting agent — carries the session a 'session' grant scopes to. */
+    agent?: unknown;
+    signal?: AbortSignal;
+};
+export type QuestionEntry = {
+    kind: 'question';
+    id: string;
+    view: QuestionView;
+    resolve: (answer: AskUserQuestionAnswer) => void;
+    reject: (error: unknown) => void;
+    signal?: AbortSignal;
+};
+export type ModalEntry = ApprovalEntry | QuestionEntry;
+/** Deps `answerApproval` threads through to createDriver's persistence layer. */
+export interface ModalAnswerDeps {
+    writeAllowRule(toolName: string, preview: ApprovalPreview | undefined): Promise<void>;
+    /** Grant the derived rule to the requesting session's allowlist (WS4-PR-B). */
+    addSessionRule(agent: unknown, toolName: string, preview: ApprovalPreview | undefined): void;
+    showNotice(text: string): void;
+}
+/**
+ * Build the modal FIFO. Only the head renders (exactly one of the approval and
+ * question slots is set); answering or aborting the head promotes the next
+ * entry, and `ask()` during an active modal queues behind it instead of
+ * stacking a second box.
+ */
+export declare function createModalQueue(rt: DriverModalCtx): {
+    push(entry: ModalEntry): void;
+    dequeue(entry: ModalEntry): void;
+    publishHead(): void;
+    shiftHead(): ModalEntry | undefined;
+    peekHead(): ModalEntry | undefined;
+    spliceAll(): ModalEntry[];
+    answerApproval(kind: 'once' | 'always' | 'session' | 'reject', deps: ModalAnswerDeps): void;
+};
+//# sourceMappingURL=driver-modal.d.ts.map

package/lib/harness/driver-modal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-modal.d.ts","sourceRoot":"","sources":["../../src/harness/driver-modal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AACrE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAA;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,UAAU,CAAA;IAChB,IAAI,EAAE,YAAY,CAAA;IAClB,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAA;IAC3C,8EAA8E;IAC9E,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,CAAA;AACD,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,UAAU,CAAA;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,YAAY,CAAA;IAClB,OAAO,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAA;IAChD,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAChC,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,CAAA;AACD,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,aAAa,CAAA;AAEtD,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrF,+EAA+E;IAC/E,cAAc,CACZ,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,GAAG,SAAS,GACnC,IAAI,CAAA;IACP,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,cAAc,GAAG;IACpD,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IAC7B,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IAChC,WAAW,IAAI,IAAI,CAAA;IACnB,SAAS,IAAI,UAAU,GAAG,SAAS,CAAA;IACnC,QAAQ,IAAI,UAAU,GAAG,SAAS,CAAA;IAClC,SAAS,IAAI,UAAU,EAAE,CAAA;IACzB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,EAAE,IAAI,EAAE,eAAe,GAAG,IAAI,CAAA;CAC5F,CA6DA"}

package/lib/harness/driver-modal.js

@@ -0,0 +1,78 @@
+/**
+ * Modal pipeline (approvals + questions sharing one FIFO) extracted from
+ * harness/driver.ts. Free-function collaborator: `createModalQueue` takes a
+ * {@link DriverModalCtx} instead of closing over createDriver's locals, so the
+ * harness factory stays out of this leaf. Emits re-read the current view-model
+ * via `rt.state()` after every emit (createDriver rebinds `state` on emit).
+ * @module @dsh-cc/tui/harness/driver-modal
+ */
+import { setApproval, setQuestion, } from "../store.js";
+/**
+ * Build the modal FIFO. Only the head renders (exactly one of the approval and
+ * question slots is set); answering or aborting the head promotes the next
+ * entry, and `ask()` during an active modal queues behind it instead of
+ * stacking a second box.
+ */
+export function createModalQueue(rt) {
+    const modalQueue = [];
+    /** Publish the queue head into exactly one of the two modal slots. */
+    const publishHead = () => {
+        const head = modalQueue[0];
+        const behind = modalQueue.length - 1;
+        if (head === undefined || head.kind !== 'approval')
+            rt.emit(setApproval(rt.state(), undefined));
+        if (head === undefined || head.kind !== 'question')
+            rt.emit(setQuestion(rt.state(), undefined));
+        if (head === undefined)
+            return;
+        if (head.kind === 'approval') {
+            rt.emit(setApproval(rt.state(), { ...head.view, ...(behind === 0 ? {} : { pendingCount: behind }) }));
+        }
+        else {
+            rt.emit(setQuestion(rt.state(), head.view));
+        }
+    };
+    /** Remove an entry from the queue (no-op if already gone) and republish. */
+    const dequeue = (entry) => {
+        const index = modalQueue.indexOf(entry);
+        if (index < 0)
+            return;
+        modalQueue.splice(index, 1);
+        publishHead();
+    };
+    const peekHead = () => modalQueue[0];
+    const shiftHead = () => modalQueue.shift();
+    const spliceAll = () => modalQueue.splice(0);
+    const answerApproval = (kind, deps) => {
+        const head = modalQueue[0];
+        if (head === undefined || head.kind !== 'approval')
+            return;
+        // Advance the queue BEFORE resolving: a resolution can immediately fire
+        // the next approval/request, which must enqueue behind the survivors.
+        modalQueue.shift();
+        publishHead();
+        head.resolve(kind === 'reject' ? 'rejected' : 'allowed-once');
+        if (kind === 'always') {
+            // Fire-and-forget: the call proceeds while the rule persists; a write
+            // failure surfaces as a notice, never as an answer error.
+            void deps.writeAllowRule(head.view.toolName, head.view.preview).catch((error) => {
+                const message = error instanceof Error ? error.message : String(error);
+                deps.showNotice(`Allowed once only — saving the allow rule failed: ${message}`);
+            });
+        }
+        if (kind === 'session') {
+            // Fire-and-forget like 'always': the call proceeds while the derived
+            // rule is granted to the requesting session's allowlist (WS4-PR-B,
+            // never global settings); a failure surfaces as a notice.
+            try {
+                deps.addSessionRule(head.agent, head.view.toolName, head.view.preview);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                deps.showNotice(`Allowed once only — adding the session rule failed: ${message}`);
+            }
+        }
+    };
+    return { push: (e) => modalQueue.push(e), dequeue, publishHead, shiftHead, peekHead, spliceAll, answerApproval };
+}
+//# sourceMappingURL=driver-modal.js.map

package/lib/harness/driver-modal.js.map

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

package/lib/harness/driver-mode.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Plan/mode switching cluster for the in-process driver: the `/plan` channel
+ * seam and permission-mode cycling. Verbatim extraction from harness/driver.ts
+ * (applyMode / applyModeInner / cyclePermissionMode), reading shared state
+ * through a DriverModeCtx instead of createDriver's closures.
+ *
+ * Plan is owned by plan-mode inside the preset's isolate realm; the ONLY
+ * cross-plane write seam is the `/plan` command channel — dispatched bare,
+ * never '/plan on' (the upstream handler steers any non-'off' argument into
+ * the conversation as a user message).
+ * @module @dsh-cc/tui/harness/driver-mode
+ */
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import { type PermissionCommandMode } from '../mode-cycle.ts';
+import type { TuiState } from '../store.ts';
+import type { DriverModeCtx } from './driver-ctx.ts';
+/** Returns the current permission-rules engine's setMode seam (duck-typed). */
+type PermissionRulesSeam = {
+    setMode(agent: Agent, mode: string): void;
+};
+/**
+ * Free-function collaborator implementing the plan/mode writepath. Reads all
+ * shared state/functions off `rt` (DriverModeCtx) so it never imports the
+ * createDriver factory. `modeWrites` is a serialization gate held here; each
+ * call chains onto the previous write so concurrent mode switches cannot
+ * interleave.
+ */
+export declare function createModeSection(rt: DriverModeCtx): {
+    applyMode(mode: PermissionCommandMode): void;
+    cyclePermissionMode(): Promise<void>;
+    get modeWrites(): Promise<void>;
+};
+export type { PermissionRulesSeam };
+export type { TuiState };
+//# sourceMappingURL=driver-mode.d.ts.map

package/lib/harness/driver-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-mode.d.ts","sourceRoot":"","sources":["../../src/harness/driver-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAwC,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAGnG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,+EAA+E;AAC/E,KAAK,mBAAmB,GAAG;IAAE,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAA;AAExE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,aAAa,GAAG;IACpD,SAAS,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAA;IAC5C,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,IAAI,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAChC,CA8DA;AAED,YAAY,EAAE,mBAAmB,EAAE,CAAA;AACnC,YAAY,EAAE,QAAQ,EAAE,CAAA"}

package/lib/harness/driver-mode.js

@@ -0,0 +1,84 @@
+/**
+ * Plan/mode switching cluster for the in-process driver: the `/plan` channel
+ * seam and permission-mode cycling. Verbatim extraction from harness/driver.ts
+ * (applyMode / applyModeInner / cyclePermissionMode), reading shared state
+ * through a DriverModeCtx instead of createDriver's closures.
+ *
+ * Plan is owned by plan-mode inside the preset's isolate realm; the ONLY
+ * cross-plane write seam is the `/plan` command channel — dispatched bare,
+ * never '/plan on' (the upstream handler steers any non-'off' argument into
+ * the conversation as a user message).
+ * @module @dsh-cc/tui/harness/driver-mode
+ */
+import { isPermissionMode, nextPermissionMode } from "../mode-cycle.js";
+import { PERMISSION_COMMAND_MODES, planPhaseOf } from '@dsh-cc/command-permissions';
+import { setPermissionMode } from "../store.js";
+/**
+ * Free-function collaborator implementing the plan/mode writepath. Reads all
+ * shared state/functions off `rt` (DriverModeCtx) so it never imports the
+ * createDriver factory. `modeWrites` is a serialization gate held here; each
+ * call chains onto the previous write so concurrent mode switches cannot
+ * interleave.
+ */
+export function createModeSection(rt) {
+    let modeWrites = Promise.resolve();
+    const applyMode = (mode) => {
+        modeWrites = modeWrites.then(() => applyModeInner(mode)).catch((error) => {
+            rt.showNotice(error instanceof Error ? error.message : String(error));
+        });
+    };
+    const applyModeInner = async (mode) => {
+        if (mode === 'plan') {
+            const result = await rt.runHarness('/plan');
+            if (result === undefined)
+                rt.showNotice('plan mode is not mounted in this composition');
+            // No optimistic emit: the display re-folds from the committed plan/mode
+            // event (see the session/event listener), so a queued mid-turn entry
+            // stays truthful until it applies.
+            return;
+        }
+        const phase = planPhaseOf(rt.current.agent.session.events, rt.projections?.stateOf(rt.current.agent.session, 'plan'));
+        if (phase !== 'off') {
+            const exit = await rt.runHarness('/plan off');
+            if (exit === null)
+                return; // no command registry — runHarness already noticed
+            if (exit === undefined) {
+                rt.showNotice('plan mode is not mounted in this composition');
+                return;
+            }
+            // A failed exit must not strand the switch half-done.
+            if (exit.kind === 'error')
+                return;
+        }
+        const rules = rt.getRules();
+        if (rules === undefined) {
+            rt.showNotice('The permission-rules engine is not mounted in this composition.');
+            return;
+        }
+        rules.setMode(rt.current.agent, mode);
+        // rebind-proof: emit reassigns createDriver's `state`, so read through the
+        // getter for a fresh snapshot to drive setPermissionMode.
+        const live = rt.state();
+        rt.emit(setPermissionMode(live, mode));
+    };
+    return {
+        applyMode,
+        cyclePermissionMode() {
+            // F1: the cycle start follows the live settings default when no fold
+            // exists — but a settings defaultMode outside PERMISSION_COMMAND_MODES
+            // must not become the start (one Tab press would never reach it and the
+            // shown mode would be "lost"), so clamp non-members to 'default' first.
+            const live = rt.liveMode(rt.current.agent);
+            const start = isPermissionMode(live) ? live : 'default';
+            const next = nextPermissionMode(start);
+            if (!PERMISSION_COMMAND_MODES.includes(next))
+                return modeWrites;
+            applyMode(next);
+            return modeWrites;
+        },
+        get modeWrites() {
+            return modeWrites;
+        },
+    };
+}
+//# sourceMappingURL=driver-mode.js.map

package/lib/harness/driver-mode.js.map

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

package/lib/harness/driver-pickers.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Model / effort / permission pickers for the in-process driver. Verbatim
+ * extraction from harness/driver.ts (openModelPicker / applyModelSwitch /
+ * openEffortPicker / openPermissionPicker plus the return-literal picker
+ * bodies), reading shared state through a DriverPickersCtx instead of
+ * createDriver's closures.
+ *
+ * The pickers are stateless overlays: each open parks picker state and each
+ * submit reads-then-closes before validating. The bare model switch writes
+ * synchronously; a carried effort validates detached via resolveEfforts /
+ * stalePair, kept in createDriver and passed in.
+ * @module @dsh-cc/tui/harness/driver-pickers
+ */
+import { type TuiState } from '../store.ts';
+import { type CatalogEntry } from '../model-catalog.ts';
+import type { DriverPickersCtx } from './driver-ctx.ts';
+/** A single selection route, matching what selection.current holds. */
+type SelectionRoute = {
+    provider: string;
+    model: string;
+    reasoningEffort?: string;
+};
+/**
+ * Free-function collaborator implementing the three pickers. Reads all shared
+ * state/functions off `rt` (DriverPickersCtx) so it never imports the
+ * createDriver factory. `selection` is passed by reference so writes land on
+ * createDriver's live ref across switchSession; resolveEfforts / stalePair /
+ * loadCatalog stay in createDriver and arrive on the ctx.
+ */
+export declare function createPickersSection(rt: DriverPickersCtx): {
+    openModelPicker(): Promise<void>;
+    applyModelSwitch(provider: string, model: string): Promise<void>;
+    openEffortPicker(): Promise<void>;
+    openPermissionPicker(): void;
+    modelPickerMove(delta: -1 | 1): void;
+    modelPickerSubmit(): Promise<void>;
+    modelPickerCancel(): void;
+    effortPickerMove(delta: -1 | 1): void;
+    effortPickerSubmit(): Promise<void>;
+    effortPickerCancel(): void;
+    permissionPickerMove(delta: -1 | 1): void;
+    permissionPickerSubmit(): Promise<void>;
+    permissionPickerCancel(): void;
+    loadModelCatalog(): Promise<CatalogEntry[]>;
+    loadModelEfforts(): Promise<string[]>;
+};
+export type { SelectionRoute, CatalogEntry, TuiState };
+//# sourceMappingURL=driver-pickers.d.ts.map

package/lib/harness/driver-pickers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-pickers.d.ts","sourceRoot":"","sources":["../../src/harness/driver-pickers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EASL,KAAK,QAAQ,EACd,MAAM,aAAa,CAAA;AACpB,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,uEAAuE;AACvE,KAAK,cAAc,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,gBAAgB,GAAG;IAC1D,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAChC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACjC,oBAAoB,IAAI,IAAI,CAAA;IAC5B,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;IACpC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,iBAAiB,IAAI,IAAI,CAAA;IACzB,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;IACrC,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACnC,kBAAkB,IAAI,IAAI,CAAA;IAC1B,oBAAoB,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;IACzC,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACvC,sBAAsB,IAAI,IAAI,CAAA;IAC9B,gBAAgB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAC3C,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;CACtC,CAyNA;AAED,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAA"}