@dsh-cc/tui 0.5.0

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

@@ -0,0 +1,462 @@
+/**
+ * Driver cluster context: structural interface(s) that free-function
+ * collaborators (harness/driver-*.ts) use instead of importing the createDriver
+ * factory (which would be a cycle). This file is a type-only leaf — every new
+ * cluster that migrates out of driver.ts grows a `*.Ctx` here.
+ *
+ * All TS-only; erased at runtime.
+ * @module @dsh-cc/tui/harness/driver-ctx
+ */
+import type { TuiState, UsageView } from '../store.ts';
+import type { DriverConfig, SessionProjectionsLike, ShellExecutorLike } from '../state/driver-types.ts';
+import type { Agent, AgentHandle, AgentSetup, ModelSelectionRef } from '@deepseek-ai/dsh-agent';
+import type { Context } from '@deepseek-ai/cordis';
+import type { SessionId } from '@deepseek-ai/dsh-session';
+import type { CatalogEntry } from '../model-catalog.ts';
+import type { ModalEntry } from './driver-modal.ts';
+import type { StatusLineSectionHandle } from './statusline-wiring.ts';
+import type { SessionEventLike, ToolPresenters } from '../transcript.ts';
+/**
+ * The slice of createDriver's closed-over state that `!` shell-command
+ * execution needs. `state()` returns the CURRENT view-model value — createDriver
+ * rebinds `state` on every emit, so collaborators must read it through a getter
+ * rather than capturing a stale snapshot.
+ */
+export interface DriverBashCtx {
+    /** Publish the next view-model value (rebinds createDriver's `state`). */
+    emit(next: TuiState): void;
+    /** Read the current view-model value (fresh, not a snapshot). */
+    state(): TuiState;
+    /** Working directory for fallback `/bin/sh -c` runs. */
+    cwd: string;
+    /** Shell executor when mounted; undefined degrades to a direct child run. */
+    shell: ShellExecutorLike | undefined;
+    /** Record a command in bash-mode history (dedup + cap + persist). */
+    appendBashHistory(command: string): void;
+}
+/**
+ * Structural face of the permission-rules service the mode section reads:
+ * the merged rule set (for rule preview/derivation) and the durable mode
+ * write. Mirrors the service's public surface without importing its package.
+ */
+export type PermissionRulesLike = {
+    readonly ruleSet: {
+        readonly allow: readonly unknown[];
+        readonly deny: readonly unknown[];
+        readonly ask: readonly unknown[];
+        readonly bypassImmune: readonly unknown[];
+    };
+    setMode(agent: Agent, mode: string): void;
+};
+/**
+ * The slice of createDriver's closed-over state that the modal pipeline
+ * (approvals + questions sharing one FIFO) needs. `state()` returns the CURRENT
+ * view-model value — createDriver rebinds `state` on every emit, so the modal
+ * collaborator must read it through a getter rather than a stale snapshot.
+ */
+export interface DriverModalCtx {
+    /** Publish the next view-model value (rebinds createDriver's `state`). */
+    emit(next: TuiState): void;
+    /** Read the current view-model value (fresh, not a snapshot). */
+    state(): TuiState;
+}
+/**
+ * The slice of createDriver's closed-over state that the plan/mode writepath
+ * needs (driver-mode.ts). `state()` returns the CURRENT view-model value —
+ * createDriver rebinds `state` on every emit, so the collaborator must read it
+ * through a getter rather than a stale snapshot.
+ */
+export interface DriverModeCtx {
+    /** Publish the next view-model value (rebinds createDriver's `state`). */
+    emit(next: TuiState): void;
+    /** Read the current view-model value (fresh, not a snapshot). */
+    state(): TuiState;
+    /** The rebindable agent holder (switchSession replaces it in place). */
+    current: {
+        agent: Agent;
+    };
+    /** Plan-unit projector, when mounted. */
+    projections: {
+        stateOf(session: unknown, unit: string): unknown;
+    } | undefined;
+    /** Surface a transient notice line. */
+    showNotice(text: string): void;
+    /** Run a bare /plan channel command. Late-bound (defined after this ctx). */
+    runHarness(line: string): Promise<{
+        kind: string;
+        text?: string;
+    } | undefined | null>;
+    /** Returns the mounted permission-rules engine's setMode seam, if any. */
+    getRules(): PermissionRulesSeam | undefined;
+    /** Fold the current plan/permission mode (live, not a snapshot). */
+    liveMode(agent: Agent, fallback?: string): string;
+}
+/** Duck-typed surface for the permission-rules engine's mode writepath. */
+export interface PermissionRulesSeam {
+    setMode(agent: Agent, mode: string): void;
+}
+/**
+ * The slice of createDriver's closed-over state that the statusline HUD /
+ * sessionProjections feed needs (driver-hud.ts). `state()` returns the CURRENT
+ * view-model value — createDriver rebinds `state` on every emit, so the
+ * collaborator must read it through a getter rather than a stale snapshot.
+ * `current` and `selection` are passed by reference (createDriver rebinds them
+ * in place across switchSession), so the section always reads the live values.
+ */
+export interface DriverHudCtx {
+    /** Publish the next view-model value (rebinds createDriver's `state`). */
+    emit(next: TuiState): void;
+    /** Read the current view-model value (fresh, not a snapshot). */
+    state(): TuiState;
+    /** Host context for the sessionProjections service lookup. */
+    ctx: Context;
+    /** Working directory (process cwd, fallback for the branch probe). */
+    cwd: string;
+    /** The rebindable agent holder (switchSession replaces it in place). */
+    current: {
+        agent: Agent;
+    };
+    /** Model selection ref; statusline reads reasoningEffort/model from it. */
+    selection: ModelSelectionRef;
+    /** Best-effort git-branch probe for the statusline footer. */
+    branchProbe: (dir: string) => Promise<string | undefined>;
+    /**
+     * Custom statusLine wiring (statusline-wiring.ts), when created by the
+     * driver. `override()` returns the configured command's line while active,
+     * or undefined so the built-in HUD stays in charge.
+     */
+    statusline?: StatusLineSectionHandle;
+}
+/**
+ * The slice of createDriver's closed-over state that the slash-command
+ * catalog + subagent lifecycle section needs (driver-catalog.ts). `state()`
+ * returns the CURRENT view-model value — createDriver rebinds `state` on every
+ * emit, so the collaborator must read it through a getter rather than a stale
+ * snapshot. `current` is the rebindable agent holder (list() reads the live
+ * agent).
+ */
+export interface DriverCatalogCtx {
+    /** Publish the next view-model value (rebinds createDriver's `state`). */
+    emit(next: TuiState): void;
+    /** Read the current view-model value (fresh, not a snapshot). */
+    state(): TuiState;
+    /** The rebindable agent holder (switchSession replaces it in place). */
+    current: {
+        agent: Agent;
+    };
+    /** Host context for the commands/skills service lookups + event subscriptions. */
+    ctx: Context;
+}
+/**
+ * The slice of createDriver's closed-over state that the approval + user
+ * question pipeline needs (driver-approvals.ts). The section owns the modal
+ * FIFO (via createModalQueue) so approvals and questions share one queue.
+ * `state()` returns the CURRENT view-model value — createDriver rebinds
+ * `state` on every emit, so the collaborator must read it through a getter
+ * rather than a stale snapshot.
+ */
+export interface DriverApprovalsCtx {
+    /** Publish the next view-model value (rebinds createDriver's `state`). */
+    emit(next: TuiState): void;
+    /** Read the current view-model value (fresh, not a snapshot). */
+    state(): TuiState;
+    /** Host context: settings/userQuestions lookup + approval/request hook. */
+    ctx: Context;
+    /** The rebindable agent holder (approval listener reads the live id). */
+    current: {
+        agent: Agent;
+    };
+    /** Surface a transient notice line (rule-persist outcomes and failures). */
+    showNotice(text: string): void;
+}
+/**
+ * The slice of createDriver's closed-over state that the model/effort/
+ * permission pickers need (driver-pickers.ts). `state()` returns the CURRENT
+ * view-model value — createDriver rebinds `state` on every emit, so the
+ * section must read it through a getter rather than a stale snapshot.
+ * `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 (they read `llm` off the host ctx).
+ */
+export interface DriverPickersCtx {
+    /** Publish the next view-model value (rebinds createDriver's `state`). */
+    emit(next: TuiState): void;
+    /** Read the current view-model value (fresh, not a snapshot). */
+    state(): TuiState;
+    /** Model selection ref; the section reads current and rewrites it in place. */
+    selection: ModelSelectionRef;
+    /** The rebindable agent holder (openPermissionPicker reads the live agent). */
+    current: {
+        agent: Agent;
+    };
+    /** Fold the live plan/permission mode for the picker's focus row. */
+    liveMode(agent: Agent, fallback?: string): string;
+    /** Resolve a model's advertisement list (never a fabricated list). */
+    resolveEfforts(provider: string, model: string): Promise<readonly {
+        id: string;
+        name: string;
+    }[] | undefined>;
+    /** Stale-pair guard: refuse a detached write when the selection moved. */
+    stalePair(captured: {
+        provider: string;
+        model: string;
+    }): boolean;
+    /** Build the full model catalog for the `/model` picker. */
+    loadCatalog(): Promise<CatalogEntry[]>;
+    /** Run a bare /plan-/permissions channel command. Late-bound (after ini). */
+    runHarness(line: string): Promise<{
+        kind: string;
+        text?: string;
+    } | undefined | null>;
+}
+/**
+ * The slice of createDriver's closed-over state that the session switcher /
+ * /resume section needs (driver-sessions.ts). `state()` returns the CURRENT
+ * view-model value — createDriver rebinds `state` on every emit, so the
+ * collaborator must read it through a getter rather than a stale snapshot.
+ * `current` and `selection` are passed by reference (createDriver rebinds them
+ * in place across switchSession), and the section writes both in place.
+ */
+export interface DriverSessionsCtx {
+    /** Publish the next view-model value (rebinds createDriver's `state`). */
+    emit(next: TuiState): void;
+    /** Read the current view-model value (fresh, not a snapshot). */
+    state(): TuiState;
+    /** Host context for sessionPersistence/sessionQuery service lookup + agents.resume. */
+    ctx: Context;
+    /** Create a brand-new agent handle for a minted session id (local /clear). */
+    createHandle(id: SessionId, extras: {
+        cwd: string;
+        agentOptions?: {
+            provider: string;
+            model: string;
+        };
+    }): Promise<AgentHandle>;
+    /** Re-apply a captured permission mode on the NEW agent after bind. */
+    reapplyMode(mode: string): Promise<void>;
+    /** Working directory (fallback when the live header cwd is absent). */
+    cwd: string;
+    /** The rebindable agent holder (switchSession disposes old, binds new). */
+    current: {
+        handle: AgentHandle;
+        agent: Agent;
+    };
+    /** Model selection ref; switchSession reseeds it after the rebind. */
+    selection: ModelSelectionRef;
+    /** Fold the live plan/permission mode for the new session. */
+    liveMode(agent: Agent, fallback?: string): string;
+    /** Reset-and-reseed the model selection from the new agent's options. */
+    seedDefaultModel(reset?: boolean): Promise<void>;
+    /** Fold the new session's history into a fresh TuiState. */
+    foldHistory(): TuiState;
+    /** Re-seed the statusline HUD / todos / branch for the new session. */
+    seedHud(): void;
+    seedTodos(): void;
+    refreshBranch(): void;
+    /** Persist the resume marker for a session id (idempotent). */
+    writeResumeTarget(id: string): void;
+    /** Set the `markedContent` flag (createDriver owns the binding). */
+    setMarkedContent(value: boolean): void;
+    /**
+     * Rebind prompt/bash history onto the project of the switched session's
+     * cwd (reloads both from disk). No-op for same-project switches and when
+     * an explicit historyDir pins the bucket.
+     */
+    rebindHistory(sessionCwd: string | undefined): void;
+    /**
+     * Pin a session id in the sidecar index of the project that owns
+     * `sessionCwd` (falling back to the process cwd), so the /resume picker's
+     * project scope has an exact membership record. Best-effort.
+     */
+    recordProjectSession(sessionId: string, sessionCwd: string | undefined): void;
+    /** Drain the shared approval/question FIFO (returns parked entries). */
+    spliceAll(): ModalEntry[];
+    /**
+     * Rebuild the slash-command catalog for the (new) live agent: commands
+     * synchronously, skills via a fresh snapshot. Called after a successful
+     * session switch — `list()`/`snapshot()` are agent- and cwd-scoped and no
+     * change event fires on a switch.
+     */
+    refreshCatalog(): void;
+    /** The agent setup closure (wraps presetSetup + installModelSelection). */
+    withSelection: AgentSetup;
+    /** Explicit provider/model override, or undefined when unset. */
+    agentOptions: {
+        provider: string;
+        model: string;
+    } | undefined;
+}
+/**
+ * The slice of createDriver's closed-over state that the `/export-md`, `/copy`,
+ * runLocal (local slash-command) and runHarness (host command) pipeline needs
+ * (driver-run-local.ts). `state()` returns the CURRENT view-model value —
+ * createDriver rebinds `state` on every emit, so the collaborator must read it
+ * through a getter rather than a stale snapshot. `current`, `selection`, and
+ * `config` are passed by reference; `markedContent` is read through a getter
+ * because createDriver owns the live `let` binding.
+ */
+export interface DriverRunLocalCtx {
+    /** Publish the next view-model value (rebinds createDriver's `state`). */
+    emit(next: TuiState): void;
+    /** Read the current view-model value (fresh, not a snapshot). */
+    state(): TuiState;
+    /** Host context for the commands service lookup. */
+    ctx: Context;
+    /** Working directory (resolution base for export paths). */
+    cwd: string;
+    /** Driver configuration (exportDir, copyWrite, cwd, ...). */
+    config: DriverConfig;
+    /** The rebindable agent holder (exports/cost/usage read the live agent). */
+    current: {
+        handle: AgentHandle;
+        agent: Agent;
+    };
+    /** Model selection ref; /effort and /model read and rewrite it in place. */
+    selection: ModelSelectionRef;
+    /** Session projections feed for /cost and /usage (may be unmounted). */
+    projections: SessionProjectionsLike | undefined;
+    /** Apply a usage-panel patch (HUD section's live-projections update fn). */
+    applyUsage(patch: UsageView | undefined): void;
+    /** Surface a transient notice line. */
+    showNotice(text: string): void;
+    /** /resume with an explicit id; the switch engine lives in driver-sessions. */
+    switchSession(id: string): Promise<void>;
+    /** Bind a freshly created empty session (local /clear, /new, /reset). */
+    startFreshSession(): Promise<void>;
+    /** Open the /resume overlay (session switcher picker). */
+    openSessionSwitcher(): Promise<void>;
+    /** Open the model picker. */
+    openModelPicker(): Promise<void>;
+    /** Validate + apply a provider/model switch (never blocks on the switch). */
+    applyModelSwitch(provider: string, model: string): Promise<void>;
+    /** Open the effort picker. */
+    openEffortPicker(): Promise<void>;
+    /** Build the full model catalog for the /model path. */
+    loadCatalog(): Promise<CatalogEntry[]>;
+    /** Resolve a model's advertised reasoning-effort levels (or undefined). */
+    resolveEfforts(provider: string, model: string): Promise<readonly {
+        id: string;
+        name: string;
+    }[] | undefined>;
+    /** Persist the resume marker (idempotent) — after first real content. */
+    persistResumeTarget(): void;
+    /** Whether real content has been produced this boot (drives /quit resume). */
+    getMarkedContent(): boolean;
+    /**
+     * Set the `markedContent` flag (createDriver owns the binding). The
+     * worktree remove path sets it `false` so dispose() does not re-persist a
+     * resume marker pointing into the just-deleted worktree.
+     */
+    setMarkedContent(marked: boolean): void;
+    /** Await the boot default-model seed before /effort reads the selection. */
+    waitForModel(): Promise<void>;
+}
+/**
+ * The slice of createDriver's closed-over state that the queue/outbox +
+ * submit/interrupt pipeline needs (driver-queue.ts). `state()` returns the
+ * CURRENT view-model value — createDriver rebinds `state` on every emit, so the
+ * queue collaborator must read it through a getter rather than a stale snapshot.
+ */
+export interface DriverQueueCtx {
+    /** Publish the next view-model value (rebinds createDriver's `state`). */
+    emit(next: TuiState): void;
+    /** Read the current view-model value (fresh, not a snapshot). */
+    state(): TuiState;
+    /** The rebindable agent holder (switchSession replaces it in place). */
+    current: {
+        agent: Agent;
+    };
+    /** Host context for the optional ccPlugins service lookup. */
+    ctx: Context;
+    /** Dispatch a local slash command (run-local section). */
+    runLocal(name: string, rawInput: string): Promise<void>;
+    /** Dispatch a harness slash command (run-local section, late-bound). */
+    runHarness(line: string): Promise<{
+        kind: string;
+        text?: string;
+    } | undefined | null>;
+    /** Open the /permissions overlay picker (pickers section). */
+    openPermissionPicker(): void;
+    /** Surface a transient notice line (e.g. an empty slash command). */
+    showNotice(text: string): void;
+    /** Run a `!` bash-mode line (driver-bash section). */
+    runShellCommand(raw: string): Promise<void>;
+    /** Read the current composer prompt history (oldest→newest). */
+    getHistory(): string[];
+    /** Replace the composer prompt history after a submit persist. */
+    setHistory(next: string[]): void;
+    /** Directory backing prompt-history persistence (for saveHistory). */
+    historyDir: string | undefined;
+    /** Persist the resume marker (idempotent) — after first real content. */
+    persistResumeTarget(): void;
+    /** Mark/clear the session as having real content (drives /quit resume). */
+    setMarkedContent(value: boolean): void;
+    /**
+     * Await the boot default-model seed before dispatch/enqueue (W4): a turn
+     * must never run with an unresolved selection. Resolves even on seed
+     * failure (warned, never deadlocks submit).
+     */
+    waitForModel(): Promise<void>;
+}
+/**
+ * The slice of createDriver's closed-over state that the agent-model/history
+ * cluster needs: resolveEfforts, seedDefaultModel, persistResumeTarget, the
+ * prompt/bash histories, tool presenters, foldHistory, and loadCatalog all
+ * read `ctx`/`current`/`selection` off `rt` instead of createDriver's locals.
+ * The section returns handles createDriver threads into the other sections.
+ */
+export interface DriverAgentCtx {
+    /** Publish the next view-model value (rebinds createDriver's `state`). */
+    emit(next: TuiState): void;
+    /** Read the current view-model value (fresh, not a snapshot). */
+    state(): TuiState;
+    /** Host context for llm/shell/tools service lookup. */
+    ctx: Context;
+    /** The rebindable agent holder (re-read live at fire time). */
+    current: {
+        handle: AgentHandle;
+        agent: Agent;
+    };
+    /** Model selection ref; seeded by agent options / deployment default. */
+    selection: ModelSelectionRef;
+    /** Explicit provider/model override, or undefined when unset. */
+    agentOptions: {
+        provider: string;
+        model: string;
+    } | undefined;
+    /** Fold the live plan/permission mode for the agent. */
+    liveMode(agent: Agent, fallback?: string): string;
+    /** Directory backing prompt/bash-history persistence. */
+    historyDir: string | undefined;
+    /** Working directory the resume marker is keyed by. */
+    cwd: string;
+}
+/**
+ * The slice of createDriver's closed-over state the `session/event` listener
+ * needs. It only reads the live view-model and current agent; the queue flush
+ * is late-bound through a holder so the listener can be attached before the
+ * queue section is constructed.
+ */
+export interface DriverSessionEventsCtx {
+    /** Publish the next view-model value (rebinds createDriver's `state`). */
+    emit(next: TuiState): void;
+    /** Read the current view-model value (fresh, not a snapshot). */
+    state(): TuiState;
+    /** Host context the `session/event` listener subscribes through. */
+    ctx: Context;
+    /** The rebindable agent holder (re-read live at fire time). */
+    current: {
+        handle: AgentHandle;
+        agent: Agent;
+    };
+    /** Fold the live plan/permission mode. */
+    liveMode(agent: Agent, fallback?: string): string;
+    /** Tool presenters for folding replayed session events. */
+    presenters: ToolPresenters | undefined;
+    /** Late-bound queue flush (wired after createQueueSection). */
+    flushQueue(): void;
+    /** Transient user-visible notice (the classifier-breaker fallback hint). */
+    showNotice(text: string): void;
+}
+export type { SessionEventLike, ToolPresenters };
+//# sourceMappingURL=driver-ctx.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver-ctx.d.ts","sourceRoot":"","sources":["../../src/harness/driver-ctx.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,KAAK,EACV,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EACX,UAAU,EACV,iBAAiB,EAClB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAExE;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC1B,iEAAiE;IACjE,KAAK,IAAI,QAAQ,CAAA;IACjB,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAA;IACX,6EAA6E;IAC7E,KAAK,EAAE,iBAAiB,GAAG,SAAS,CAAA;IACpC,qEAAqE;IACrE,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACzC;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAA;QAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;QACjC,QAAQ,CAAC,GAAG,EAAE,SAAS,OAAO,EAAE,CAAA;QAChC,QAAQ,CAAC,YAAY,EAAE,SAAS,OAAO,EAAE,CAAA;KAC1C,CAAA;IACD,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1C,CAAA;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC1B,iEAAiE;IACjE,KAAK,IAAI,QAAQ,CAAA;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC1B,iEAAiE;IACjE,KAAK,IAAI,QAAQ,CAAA;IACjB,wEAAwE;IACxE,OAAO,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,CAAA;IACzB,yCAAyC;IACzC,WAAW,EAAE;QAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,SAAS,CAAA;IAC7E,uCAAuC;IACvC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,6EAA6E;IAC7E,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAAA;IACrF,0EAA0E;IAC1E,QAAQ,IAAI,mBAAmB,GAAG,SAAS,CAAA;IAC3C,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAClD;AAED,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC1B,iEAAiE;IACjE,KAAK,IAAI,QAAQ,CAAA;IACjB,8DAA8D;IAC9D,GAAG,EAAE,OAAO,CAAA;IACZ,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAA;IACX,wEAAwE;IACxE,OAAO,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,CAAA;IACzB,2EAA2E;IAC3E,SAAS,EAAE,iBAAiB,CAAA;IAC5B,8DAA8D;IAC9D,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACzD;;;;OAIG;IACH,UAAU,CAAC,EAAE,uBAAuB,CAAA;CACrC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC1B,iEAAiE;IACjE,KAAK,IAAI,QAAQ,CAAA;IACjB,wEAAwE;IACxE,OAAO,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,CAAA;IACzB,kFAAkF;IAClF,GAAG,EAAE,OAAO,CAAA;CACb;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC1B,iEAAiE;IACjE,KAAK,IAAI,QAAQ,CAAA;IACjB,2EAA2E;IAC3E,GAAG,EAAE,OAAO,CAAA;IACZ,yEAAyE;IACzE,OAAO,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,CAAA;IACzB,4EAA4E;IAC5E,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC1B,iEAAiE;IACjE,KAAK,IAAI,QAAQ,CAAA;IACjB,+EAA+E;IAC/E,SAAS,EAAE,iBAAiB,CAAA;IAC5B,+EAA+E;IAC/E,OAAO,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,CAAA;IACzB,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACjD,sEAAsE;IACtE,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,SAAS,CAAC,CAAA;IAC/D,0EAA0E;IAC1E,SAAS,CAAC,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAA;IACjE,4DAA4D;IAC5D,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IACtC,6EAA6E;IAC7E,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAAA;CACtF;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC1B,iEAAiE;IACjE,KAAK,IAAI,QAAQ,CAAA;IACjB,uFAAuF;IACvF,GAAG,EAAE,OAAO,CAAA;IACZ,8EAA8E;IAC9E,YAAY,CACV,EAAE,EAAE,SAAS,EACb,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAC1E,OAAO,CAAC,WAAW,CAAC,CAAA;IACvB,uEAAuE;IACvE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAA;IACX,2EAA2E;IAC3E,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAA;IAC9C,sEAAsE;IACtE,SAAS,EAAE,iBAAiB,CAAA;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACjD,yEAAyE;IACzE,gBAAgB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,4DAA4D;IAC5D,WAAW,IAAI,QAAQ,CAAA;IACvB,uEAAuE;IACvE,OAAO,IAAI,IAAI,CAAA;IACf,SAAS,IAAI,IAAI,CAAA;IACjB,aAAa,IAAI,IAAI,CAAA;IACrB,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,oEAAoE;IACpE,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IACtC;;;;OAIG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAA;IACnD;;;;OAIG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAA;IAC7E,wEAAwE;IACxE,SAAS,IAAI,UAAU,EAAE,CAAA;IACzB;;;;;OAKG;IACH,cAAc,IAAI,IAAI,CAAA;IACtB,2EAA2E;IAC3E,aAAa,EAAE,UAAU,CAAA;IACzB,iEAAiE;IACjE,YAAY,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CAC9D;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC1B,iEAAiE;IACjE,KAAK,IAAI,QAAQ,CAAA;IACjB,oDAAoD;IACpD,GAAG,EAAE,OAAO,CAAA;IACZ,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAA;IACX,6DAA6D;IAC7D,MAAM,EAAE,YAAY,CAAA;IACpB,4EAA4E;IAC5E,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAA;IAC9C,4EAA4E;IAC5E,SAAS,EAAE,iBAAiB,CAAA;IAC5B,wEAAwE;IACxE,WAAW,EAAE,sBAAsB,GAAG,SAAS,CAAA;IAC/C,4EAA4E;IAC5E,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAAA;IAC9C,uCAAuC;IACvC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,+EAA+E;IAC/E,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,yEAAyE;IACzE,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,0DAA0D;IAC1D,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,6BAA6B;IAC7B,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAChC,6EAA6E;IAC7E,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE,8BAA8B;IAC9B,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACjC,wDAAwD;IACxD,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IACtC,2EAA2E;IAC3E,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,SAAS,CAAC,CAAA;IAC/D,yEAAyE;IACzE,mBAAmB,IAAI,IAAI,CAAA;IAC3B,8EAA8E;IAC9E,gBAAgB,IAAI,OAAO,CAAA;IAC3B;;;;OAIG;IACH,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IACvC,4EAA4E;IAC5E,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC1B,iEAAiE;IACjE,KAAK,IAAI,QAAQ,CAAA;IACjB,wEAAwE;IACxE,OAAO,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,CAAA;IACzB,8DAA8D;IAC9D,GAAG,EAAE,OAAO,CAAA;IACZ,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvD,wEAAwE;IACxE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAAA;IACrF,8DAA8D;IAC9D,oBAAoB,IAAI,IAAI,CAAA;IAC5B,qEAAqE;IACrE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,sDAAsD;IACtD,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C,gEAAgE;IAChE,UAAU,IAAI,MAAM,EAAE,CAAA;IACtB,kEAAkE;IAClE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAChC,sEAAsE;IACtE,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,yEAAyE;IACzE,mBAAmB,IAAI,IAAI,CAAA;IAC3B,2EAA2E;IAC3E,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IACtC;;;;OAIG;IACH,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC1B,iEAAiE;IACjE,KAAK,IAAI,QAAQ,CAAA;IACjB,uDAAuD;IACvD,GAAG,EAAE,OAAO,CAAA;IACZ,+DAA+D;IAC/D,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAA;IAC9C,yEAAyE;IACzE,SAAS,EAAE,iBAAiB,CAAA;IAC5B,iEAAiE;IACjE,YAAY,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;IAC7D,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACjD,yDAAyD;IACzD,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC1B,iEAAiE;IACjE,KAAK,IAAI,QAAQ,CAAA;IACjB,oEAAoE;IACpE,GAAG,EAAE,OAAO,CAAA;IACZ,+DAA+D;IAC/D,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAA;IAC9C,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACjD,2DAA2D;IAC3D,UAAU,EAAE,cAAc,GAAG,SAAS,CAAA;IACtC,+DAA+D;IAC/D,UAAU,IAAI,IAAI,CAAA;IAClB,4EAA4E;IAC5E,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAID,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,CAAA"}

package/lib/harness/driver-ctx.js

@@ -0,0 +1,11 @@
+/**
+ * Driver cluster context: structural interface(s) that free-function
+ * collaborators (harness/driver-*.ts) use instead of importing the createDriver
+ * factory (which would be a cycle). This file is a type-only leaf — every new
+ * cluster that migrates out of driver.ts grows a `*.Ctx` here.
+ *
+ * All TS-only; erased at runtime.
+ * @module @dsh-cc/tui/harness/driver-ctx
+ */
+export {};
+//# sourceMappingURL=driver-ctx.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver-ctx.js","sourceRoot":"","sources":["../../src/harness/driver-ctx.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

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

@@ -0,0 +1,31 @@
+/**
+ * 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 { type UsageView } from '../store.ts';
+import { type SessionProjectionsLike } from '../state/driver-types.ts';
+import type { DriverHudCtx } from './driver-ctx.ts';
+/**
+ * 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 declare function createHudSection(rt: DriverHudCtx): {
+    refreshBranch: () => void;
+    seedHud: () => void;
+    seedTodos: () => void;
+    applyUsage: (patch: UsageView | undefined) => void;
+    projections: SessionProjectionsLike | undefined;
+    statusLineOf: (width?: number) => string;
+};
+//# sourceMappingURL=driver-hud.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver-hud.d.ts","sourceRoot":"","sources":["../../src/harness/driver-hud.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAML,KAAK,SAAS,EACf,MAAM,aAAa,CAAA;AAYpB,OAAO,EAEL,KAAK,sBAAsB,EAE5B,MAAM,0BAA0B,CAAA;AAGjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY;yBAUrB,IAAI;mBAyCV,IAAI;qBAwBF,IAAI;wBA/BC,SAAS,GAAG,SAAS,KAAG,IAAI;;2BA0FzB,MAAM,KAAG,MAAM;EAgC9C"}