dsh-code 1.2.0 → 1.4.0

package/lib/types/locales/en.d.ts

@@ -51,13 +51,50 @@ export declare const en: {
     readonly 'search.compact.searching': "searching…";
     readonly 'search.compact.error': "error: {message}";
     readonly 'search.footer': "↑↓ move · enter search/resume · esc close";
+    readonly 'header.hint': "/help · Esc interrupt · Ctrl+C quit";
+    readonly 'header.hintResumed': "resumed · /help · Esc interrupt";
     readonly 'statusline.title': "/statusline · items apply to the live status line below";
+    readonly 'statusline.item.model': "model";
+    readonly 'statusline.item.model.desc': "provider/model serving this session";
+    readonly 'statusline.item.cwd': "cwd";
+    readonly 'statusline.item.cwd.desc': "working-directory basename";
+    readonly 'statusline.item.mode': "mode";
+    readonly 'statusline.item.mode.desc': "agent preset composing the session";
+    readonly 'statusline.item.branch': "branch";
+    readonly 'statusline.item.branch.desc': "git branch inside a repository";
+    readonly 'statusline.item.context': "context";
+    readonly 'statusline.item.context.desc': "context-window occupancy meter";
+    readonly 'statusline.item.permission': "permission";
+    readonly 'statusline.item.permission.desc': "permission preset badge with cycle hint";
+    readonly 'statusline.item.plan': "plan";
+    readonly 'statusline.item.plan.desc': "plan-mode state mark";
+    readonly 'statusline.item.turns': "turns";
+    readonly 'statusline.item.turns.desc': "turn and step counters";
+    readonly 'statusline.item.durations': "durations";
+    readonly 'statusline.item.durations.desc': "llm/ttft/decode/tool wall time";
+    readonly 'statusline.item.cache': "cache";
+    readonly 'statusline.item.cache.desc': "cache-hit share of billed input";
+    readonly 'statusline.item.tokens': "tokens";
+    readonly 'statusline.item.tokens.desc': "cumulative input/output tokens";
+    readonly 'statusline.item.title': "title";
+    readonly 'statusline.item.title.desc': "session title or short id";
+    readonly 'statusline.item.goal': "goal";
+    readonly 'statusline.item.goal.desc': "live goal phase and round progress";
+    readonly 'statusline.item.sandbox': "sandbox";
+    readonly 'statusline.item.sandbox.desc': "divergent sandbox-mode override";
     readonly 'schedule.title': "/schedule · {count} active reminder";
     readonly 'schedule.titlePlural': "/schedule · {count} active reminders";
     readonly 'schedule.empty': "no active reminders — the model creates them with schedule_create";
     readonly 'document.loading': "loading transcript…";
+    readonly 'attach.bar': "observing · {label} · r reload · esc/ctrl+d back";
+    readonly 'attach.loading': "loading {label}'s conversation…";
+    readonly 'attach.status': "subagent {label} · {id} · {turns} turns";
+    readonly 'notice.attachUnavailable': "subagent attachment is unavailable in this profile";
     readonly 'document.compact': "transcript · esc close";
-    readonly 'document.footer': "lines {from}-{to}/{total} · ↑↓/pg/g/G · t/esc close";
+    readonly 'document.expanded': "expanded";
+    readonly 'document.refreshHint': "r refresh";
+    readonly 'document.footerExpanded': "lines {from}-{to}/{total} · ↑↓/pg/g/G{refresh} · esc/ctrl+d back";
+    readonly 'document.footer': "lines {from}-{to}/{total} · ↑↓/pg/g/G · enter/f expand · t/esc close";
     readonly 'review.picker.title': "/review · choose a target";
     readonly 'review.picker.uncommitted': "Review uncommitted changes (staged / unstaged / new files)";
     readonly 'review.picker.branch': "Compare against a base branch (lists local branches)";
@@ -197,10 +234,16 @@ export declare const en: {
     readonly 'status.label.out': "out";
     readonly 'status.label.mode': "/mode";
     readonly 'status.label.context': "context";
+    readonly 'status.label.sandbox': "sandbox";
+    readonly 'status.plan.on': "plan on";
+    readonly 'status.plan.mark': "⧉ plan";
+    readonly 'status.goal.round': "◎ round {current}/{max}";
+    readonly 'status.goal.phase': "◎ {phase}";
     readonly 'frozen.keysGoTo': "keys go to {owner} · esc {action}";
     readonly 'frozen.action.rejects': "rejects";
     readonly 'frozen.action.cancels': "cancels";
     readonly 'frozen.action.closes': "closes";
+    readonly 'frozen.action.waits': "waits";
     readonly 'time.justNow': "now";
     readonly 'time.minutesAgo': "{n}m ago";
     readonly 'time.hoursAgo': "{n}h ago";
@@ -212,6 +255,7 @@ export declare const en: {
     readonly 'notice.themeSaveFailed': "theme save failed: {message}";
     readonly 'notice.languageSaveFailed': "language save failed: {message}";
     readonly 'notice.alreadyActive': "that session is already active";
+    readonly 'notice.permissionPresetsUnmounted': "permission presets are not mounted in this composition";
     readonly 'notice.queueCancelled': "queued message cancelled";
     readonly 'notice.queueActionFailed': "queue action failed: {message}";
     readonly 'notice.queueUnavailable': "queued message is no longer pending";
@@ -226,6 +270,8 @@ export declare const en: {
     readonly 'notice.usage.animation': "usage: /animation [on|off]";
     readonly 'notice.usage.language': "usage: /language [en|zh]";
     readonly 'notice.usage.rainbow': "usage: /rainbow [seed]";
+    readonly 'notice.usage.bareCommand': "usage: /{name}";
+    readonly 'notice.switchInProgress': "switching sessions — send again once the new session is up, or /resume cancel";
     readonly 'notice.imageCancelled': "image submission cancelled";
     readonly 'notice.themeConfigUnreadable': "theme config unreadable, using dark: {message}";
     readonly 'notice.languageConfigUnreadable': "language config unreadable, using english: {message}";
@@ -256,6 +302,13 @@ export declare const en: {
     readonly 'notice.resumeFailed': "resume failed: {message}";
     readonly 'notice.forkFailed': "fork failed: {message}";
     readonly 'notice.sessionSwitchFailed': "session switch failed: {message}";
+    readonly 'notice.sessionCreated': "created {id} · mode {mode}";
+    readonly 'notice.sessionResumed': "resumed {id} · mode {mode}";
+    readonly 'notice.sessionSwitchedDirty': "switched to {id}, but {detail}";
+    readonly 'notice.flushFailed': "previous session flush failed: {message}";
+    readonly 'notice.agentReleaseFailed': "previous agent release failed: {message}";
+    readonly 'notice.copyEmpty': "nothing to copy yet";
+    readonly 'notice.copied': "copied latest response";
     readonly 'notice.switchQueued': "will switch to {label} when the current turn finishes · /resume cancel to abort";
     readonly 'notice.reviewStarted': "review started under read-only permissions";
     readonly 'notice.reviewFailed': "review failed: {message}";
@@ -307,7 +360,8 @@ export declare const en: {
     readonly 'panel.footer.chooseSelect': "↑↓ choose · enter select · r refresh · esc close";
     readonly 'panel.footer.inspectDetails': "↑↓ inspect · enter details · r refresh · esc close";
     readonly 'panel.footer.inspectRefresh': "↑↓ inspect · r refresh · esc close";
-    readonly 'panel.footer.resume': "tab/←→ filters · ↑↓/pg navigate · ctrl+f search · e details · t transcript · d delete · enter resume";
+    readonly 'panel.footer.resume': "tab/←→ filters · ↑↓/pg navigate · ctrl+f search · e details · t transcript · enter resume";
+    readonly 'panel.footer.delete': "tab/←→ filters · ↑↓/pg navigate · ctrl+f search · e details · t transcript · enter delete · esc close";
     readonly 'panel.footer.transcript': "lines {from}-{to}/{total} · ↑↓/pg/g/G · t/esc close";
     readonly 'panel.footer.history': "↑↓ move · g/G ends · enter fill · esc close";
     readonly 'panel.footer.review': "↑↓ move · enter select · esc back · q close";
@@ -319,6 +373,7 @@ export declare const en: {
     readonly 'panel.jobs.title': "/jobs · background tasks · {count}";
     readonly 'panel.resume.deleteTitle': "permanently delete {target}? this cannot be undone · subagent threads go too";
     readonly 'panel.resume.title': "/resume{mode}{search} · {toolbar}";
+    readonly 'panel.delete.title': "/delete{search} · {toolbar}";
     readonly 'panel.noActiveReminders': "no active reminders — the model schedules via schedule_create";
     readonly 'panel.notMounted': "not mounted";
     readonly 'panel.broken': "broken: {message}";
@@ -369,7 +424,6 @@ export declare const en: {
     readonly 'panel.provider.notConfiguredDivider': "── not configured ──";
     readonly 'panel.provider.title': "/model — providers";
     readonly 'panel.provider.titleCount': "/model — providers · {index}/{total}";
-    readonly 'panel.provider.state': "{route} · {value}";
     readonly 'panel.provider.key': "key {value}";
     readonly 'panel.provider.authConfigured': "provider auth";
     readonly 'panel.provider.noKey': "key missing";
@@ -384,7 +438,7 @@ export declare const en: {
     readonly 'panel.provider.readOnlyLogin': "this login record is read-only";
     readonly 'panel.provider.notManaged': "this provider is not managed by Harness settings";
     readonly 'panel.providers.compact': "/model providers · enter configure · d remove key · esc back";
-    readonly 'panel.providers.footer': "↑↓ move · enter configure · l login · o logout · d remove key · x remove provider · r retry · esc back";
+    readonly 'panel.providers.footer': "↑↓ move · enter configure · d remove key · x remove provider · r retry · esc back";
     readonly 'panel.update.compact': "/update · {summary}";
     readonly 'panel.update.checking': "checking…";
     readonly 'panel.update.probeFailed': "probe failed";
@@ -412,8 +466,14 @@ export declare const en: {
     readonly 'panel.setup.copyInto': "copy verbatim into {id}";
     readonly 'panel.setup.copyTitle': "/model — copy efforts";
     readonly 'panel.setup.copyFooter': "↑↓ move · enter copy · esc back";
+    readonly 'panel.setup.mode.subscribe': "Subscription";
+    readonly 'panel.setup.mode.key': "Key";
+    readonly 'panel.setup.mode.login.plan': "signed in · plan";
+    readonly 'panel.setup.mode.login.none': "not signed in";
+    readonly 'panel.setup.mode.login.running': "signing in…";
+    readonly 'panel.setup.mode.overridden': "⚠ the settings key overrides the plan sign-in";
     readonly 'panel.setup.title': "/model — configure {provider}";
-    readonly 'panel.setup.footer': "↑↓ move · ←→ in/out · space remove · e efforts · c copy efforts · tab discover · enter save · esc back";
+    readonly 'panel.setup.footer': "↑↓ move · ←→ in/out · space remove · e efforts · c copy efforts · tab per channel (subscription = web sign-in, key = discover) · enter save · esc back";
     readonly 'panel.discovery.compact': "model discovery · terminal too small · esc back";
     readonly 'panel.discovery.loading': "discovering models…";
     readonly 'panel.discovery.empty': "the endpoint advertised no models; add ids by hand on the setup page";

package/lib/types/{authorization-panel.d.ts → panels/authorization-panel.d.ts}

@@ -2,9 +2,14 @@
 import { type ReactElement } from 'react';
 import { type AuthorizationInteraction, type AuthorizationStatus } from '@deepseek-ai/dsh-authorization';
 import type { CredentialKey } from '@deepseek-ai/dsh-credentials';
-import type { ProviderAuthorizationRow } from './authorization.ts';
+import type { ProviderAuthorizationRow } from '../authorization.ts';
 export interface ProviderAuthorizationPanelProps {
     readonly row: ProviderAuthorizationRow;
+    /**
+     * Start this method immediately instead of showing the picker: a
+     * single-method provider signs in with no extra step.
+     */
+    readonly autoStartMethod?: string;
     begin(row: ProviderAuthorizationRow, method: string, interaction: AuthorizationInteraction, signal: AbortSignal): Promise<AuthorizationStatus>;
     cancel(key: CredentialKey): void;
     openUrl(url: string): boolean;

package/lib/types/panels/completion-panel.d.ts

@@ -0,0 +1,13 @@
+/** Bounded slash-command and mention completion menu. */
+import { type ReactElement } from 'react';
+import type { CompletionCandidate } from '../completion.ts';
+/** Total physical rows occupied by the completion menu at this terminal height. */
+export declare function completionMenuRowCount(terminalRows: number, rowCount: number): number;
+/** Completion view anchored directly above the composer band. */
+export declare function CompletionMenu({ active, mention, index, rows, error }: {
+    active: boolean;
+    mention: boolean;
+    index: number;
+    rows: readonly CompletionCandidate[];
+    error?: string;
+}): ReactElement | undefined;

package/lib/types/panels/interaction-bars.d.ts

@@ -0,0 +1,38 @@
+/** Approval and structured-question keyboard-owned terminal surfaces. */
+import { type ReactElement } from 'react';
+import type { ApprovalSnapshot } from '../approval.ts';
+import type { QuestionSnapshot, QuestionStore } from '../questions.ts';
+import type { NoticeTone } from '../ui/ui-contract.ts';
+/**
+ * The approval dialog (Codex ApprovalOverlay contract): a bold question
+ * header, the bounded command body with an explicit overflow marker, a
+ * numbered option list with a `›` cursor, single-key shortcuts, and digits
+ * for direct selection. Askers queue FIFO — the count rides the header.
+ * The upstream answerer vocabulary stays binary (`allowed-once` /
+ * `rejected`): "tell it what to do differently" rejects and hands the
+ * composer back with a hint notice, exactly Codex's decline-then-type flow.
+ */
+export declare function ApprovalBar({ snapshot, locked, notify, interrupt, summarize }: {
+    snapshot: ApprovalSnapshot;
+    locked: boolean;
+    notify: (text: string, tone?: NoticeTone) => void;
+    /** Cancel the running turn (Ctrl+C), matching the composer's busy branch. */
+    interrupt: () => boolean;
+    /** Render as the bounded one-line form even on tall terminals (another
+     * human-asked surface already owns the full panel budget). */
+    summarize?: boolean;
+}): ReactElement | undefined;
+/**
+ * The ask_user_question bar: walks one request question by question,
+ * retaining an independent draft for every question. Options use Space/1-9
+ * to toggle a multi-select, Enter to confirm, and arrows/Ctrl+P/N to move
+ * between questions. Plan reviews arrive through the same service with a
+ * `plan-review` intent — the approve option gets a ✓ mark, the answer
+ * encoding stays identical.
+ */
+export declare function QuestionBar({ store, snapshot, locked }: {
+    store: QuestionStore;
+    snapshot: QuestionSnapshot;
+    locked: boolean;
+}): ReactElement | undefined;
+/** The /model panel: a scrolling list over the advisory model directory. */

package/lib/types/{kernel-panels.d.ts → panels/kernel-panels.d.ts}

@@ -1,24 +1,18 @@
 /** Bounded, composer-safe panels for preset, session, and plugin kernel views. */
 import { type ReactElement } from 'react';
-import type { ModelDirectory, ModelRow } from './models.ts';
-import type { SubagentRow } from './subagents.ts';
-import type { ScheduleRow } from './render/projection.ts';
-import type { PermissionRow } from './permissions.ts';
-import type { PresetRow } from './presets.ts';
-import type { PluginRow } from './plugin-inventory.ts';
-import type { SessionDirectoryOptions, SessionRow } from './session-directory.ts';
-import type { ReviewBranch, ReviewCommit, ReviewSelection } from './git-workflow.ts';
-import { type UsageView } from './render/usage.ts';
-import { type StatusItemId } from './render/status.ts';
-/**
- * Apply one keystroke to a panel search query. IME commits arrive as one
- * multi-character chunk, so the whole printable run is appended; paste
- * markers are stripped and control-laden chunks are ignored.
- */
-export declare function editQuery(query: string, input: string, key: {
-    backspace?: boolean;
-    delete?: boolean;
-}): string | undefined;
+import type { ModelDirectory, ModelRow } from '../models.ts';
+import type { SubagentRow } from '../session/subagents.ts';
+import type { SearchRow } from '../runner/search-rows.ts';
+export type { SearchRow } from '../runner/search-rows.ts';
+import type { ScheduleRow } from '../render/projection.ts';
+import type { PermissionRow } from '../permissions.ts';
+import type { PresetRow } from '../presets.ts';
+import type { PluginRow } from '../plugin-inventory.ts';
+import type { SessionDirectoryOptions, SessionRow } from '../session/session-directory.ts';
+import type { ReviewBranch, ReviewCommit, ReviewSelection } from '../git-workflow.ts';
+import { type UsageView } from '../render/usage.ts';
+import { type StatusItemId } from '../render/status.ts';
+export { editQuery } from '../ui/query-editor.ts';
 export declare function ModePanel({ current, load, select, close }: {
     current: string;
     load: () => Promise<readonly PresetRow[]>;
@@ -66,7 +60,7 @@ export declare function JobsPanel({ load, close }: {
     load: () => readonly JobRow[];
     close: () => void;
 }): ReactElement;
-export declare function ResumePanel({ currentCwd, load, readTranscript, select, requestDelete, deleteConfirmId, reloadToken, deleteMode, close }: {
+export declare function ResumePanel({ currentCwd, load, readTranscript, select, requestDelete, deleteConfirmId, reloadToken, deleteMode, presetId, close }: {
     currentCwd: string;
     load: (options: SessionDirectoryOptions, signal?: AbortSignal) => Promise<readonly SessionRow[]>;
     readTranscript: (id: string, signal?: AbortSignal) => Promise<string>;
@@ -79,6 +73,8 @@ export declare function ResumePanel({ currentCwd, load, readTranscript, select,
     reloadToken?: number;
     /** Opened via /delete: hint-first delete mode. */
     deleteMode?: boolean;
+    /** `/delete <id>` argument to resolve after the listing loads. */
+    presetId?: string;
     close: () => void;
 }): ReactElement;
 /**
@@ -108,23 +104,6 @@ export declare function ReviewPickerPanel({ loadBranches, loadCommits, choose, c
     choose: (selection: ReviewSelection) => void;
     close: () => void;
 }): ReactElement;
-/** One cross-session full-text search hit mapped from the session-query engine. */
-export interface SearchRow {
-    /** Session id (Enter resumes it through the switch machinery). */
-    readonly id: string;
-    /** Display label: session title or the short id form. */
-    readonly label: string;
-    /** Secondary facts line (workspace · preset markers). */
-    readonly detail: string;
-    /** Bounded plain-text excerpt around the strongest match. */
-    readonly snippet: string;
-    /** Match timestamp (relative labels derive from it). */
-    readonly updatedAt: number;
-    /** Whether the hit is a delegated subagent conversation (not resumable). */
-    readonly subagent: boolean;
-    /** Whether Enter may switch into it. */
-    readonly resumable: boolean;
-}
 /**
  * The /search panel: full-text search over every persisted session through
  * the in-process session-query engine (the same corpus the model's
@@ -180,13 +159,15 @@ export declare function EffortPanel({ row, current, select, back, onExit }: {
  * Enter/t opening the child's full transcript in the shared read-only
  * document view (the same projection the exporter uses).
  */
-export declare function AgentsPanel({ live, load, readTranscript, close }: {
+export declare function AgentsPanel({ live, load, readTranscript, attach, close }: {
     /** Live feed rows (child sessions observed this process). */
     live: readonly SubagentRow[];
     /** Load this session's persisted child sessions by lineage. */
     load: () => Promise<readonly SessionRow[]>;
     /** Read one child session's full transcript as markdown. */
     readTranscript: (id: string, signal?: AbortSignal) => Promise<string>;
+    /** Attach to one child as the whole view (the runner's live buses). */
+    attach: ((id: string, label: string) => void) | undefined;
     close: () => void;
 }): ReactElement;
 /**

package/lib/types/{language-panel.d.ts → panels/language-panel.d.ts}

@@ -4,7 +4,7 @@
  * repainting the whole screen so Static-region text switches too).
  */
 import { type ReactElement } from 'react';
-import { type LanguageName } from './i18n.ts';
+import { type LanguageName } from '../i18n.ts';
 export declare function LanguagePanel({ current, select, close }: {
     current: LanguageName;
     select: (name: LanguageName) => void;

package/lib/types/panels/model-panels.d.ts

@@ -0,0 +1,86 @@
+/** Model selection and provider-management panels for the terminal app. */
+import { type ReactElement } from 'react';
+import type { ModelDirectory, ModelRow } from '../models.ts';
+import { type DiscoveredModelView, type ProviderConfiguration, type ProviderSettingsDirectory, type ProviderTargetView } from '../provider-settings.ts';
+import { type ProviderAuthorizationDirectory, type ProviderAuthorizationRow } from '../authorization.ts';
+export declare function ModelPanel({ directory, error, current, onSelect, onProviders, onRetry, onClose }: {
+    directory: ModelDirectory | undefined;
+    error: string | undefined;
+    /** `provider/model` label of the applied model: the cursor lands on it once. */
+    current?: string;
+    onSelect: (row: ModelRow) => void;
+    onProviders?: () => void;
+    onRetry: () => void;
+    onClose: () => void;
+}): ReactElement;
+/** The provider-management stage reached from /model with `a`. */
+export declare function ProviderPanel({ directory, error, authorizations, authorizationError, onConfigure, onUnset, onRemove, onRetry, onBack, onExit }: {
+    directory: ProviderSettingsDirectory | undefined;
+    error: string | undefined;
+    authorizations: ProviderAuthorizationDirectory | undefined;
+    authorizationError: string | undefined;
+    onConfigure: (target: ProviderTargetView) => void;
+    onUnset: (target: ProviderTargetView) => void;
+    onRemove: (target: ProviderTargetView) => void;
+    onRetry: () => void;
+    onBack: () => void;
+    /** Leave the whole /model flow (Ctrl+C), not just this stage. */
+    onExit: () => void;
+}): ReactElement;
+/** Provider configuration editor: only explicit models are written to settings. */
+/**
+ * The unified provider setup page: API key, endpoint, and the explicit model
+ * list (with per-model context/output capacities) on ONE screen — the deep
+ * Tab menu and the separate key panel merged into a single discoverable
+ * surface. A saved key rides the same Enter as the endpoint and models; an
+ * empty endpoint keeps the provider's official default. Tab moves to the
+ * discovery page, which interrogates the real endpoint and returns checkable
+ * models for adoption; the last row also accepts hand-typed model ids.
+ */
+/** One declarable donor the setup page can copy reasoning efforts from verbatim. */
+export interface EffortDonor {
+    /** Provider route the declaration lives on. */
+    readonly provider: string;
+    /** Model id the declaration belongs to. */
+    readonly id: string;
+    /** The stored display-level to wire-value map, copied verbatim. */
+    readonly efforts: Record<string, string | null>;
+}
+export declare function ProviderSetupPanel({ target, authorization, onSubscribe, save, saveCredential, discover, effortDonors, done, back, onExit }: {
+    target: ProviderTargetView;
+    /**
+     * The provider's sign-in flow, when it offers a web (OAuth) channel: its
+     * presence adds the subscription/key mode layer at the top of the page.
+     */
+    authorization: ProviderAuthorizationRow | undefined;
+    /** Open the subscription channel: sign in when logged out, confirm sign-out when logged in. */
+    onSubscribe: (() => void) | undefined;
+    /** Models with declared efforts (settings first, catalog-advertised after) a model row can copy from. */
+    effortDonors: readonly EffortDonor[];
+    save: (target: ProviderTargetView, configuration: ProviderConfiguration) => Promise<void>;
+    saveCredential: ((target: ProviderTargetView, key: string) => Promise<void>) | undefined;
+    discover: (target: ProviderTargetView, request: {
+        readonly apiKey?: string;
+        readonly baseURL?: string;
+    }, signal?: AbortSignal) => Promise<readonly DiscoveredModelView[]>;
+    /** Report a successful save so the surface can notice the key rotation. */
+    done: (result: {
+        readonly key: boolean;
+    }) => void;
+    back: () => void;
+    /** Leave the whole /model flow (Ctrl+C), not just this page. */
+    onExit: () => void;
+}): ReactElement;
+/** Bounded destructive-action confirmation for credential or provider removal. */
+export declare function ProviderConfirmPanel({ target, kind, confirm, done, back }: {
+    target: ProviderTargetView;
+    kind: 'credential' | 'provider';
+    confirm: (target: ProviderTargetView) => Promise<void>;
+    done: () => void;
+    back: () => void;
+}): ReactElement;
+/**
+ * The /help overlay: one scrolling card with the keyboard map, the TUI-local
+ * commands, the live registry commands, and the user-invocable skills — the
+ * real command surface, replacing the one-line notice.
+ */

package/lib/types/{theme-panel.d.ts → panels/theme-panel.d.ts}

@@ -7,7 +7,7 @@
  * @module @deepseek-ai/dsh-tui/theme-panel
  */
 import { type ReactElement } from 'react';
-import { type ThemeName } from './theme.ts';
+import { type ThemeName } from '../theme.ts';
 /**
  * The /theme list: one row per theme, the current one marked with ●, the
  * focused one with ›. Enter applies the focused theme (the runner persists

package/lib/types/{update-panel.d.ts → panels/update-panel.d.ts}

@@ -9,11 +9,31 @@
  * here.
  */
 import { type ReactElement } from 'react';
-import type { LauncherUpdateStatus } from './update.ts';
+import type { LauncherUpdatePlan, LauncherUpdateStatus } from '../update.ts';
 /** Retained apply-progress lines (ring tail; npm output is ephemeral). */
 export declare const UPDATE_OUTPUT_CAP = 800;
 /** Keep the newest UPDATE_OUTPUT_CAP lines of streamed update output. */
 export declare function clipUpdateLines(lines: readonly string[]): readonly string[];
+/** One in-flight `update --apply`. Closing the panel must not start a second. */
+interface UpdateApplyJob {
+    readonly promise: Promise<number>;
+    readonly lines: string[];
+    readonly lineListeners: Set<(line: string) => void>;
+}
+/** True while an apply child is alive, even if the /update panel is closed. */
+export declare function isUpdateApplyRunning(): boolean;
+/** Subscribe to apply-running changes (frozen-hint "esc waits"). */
+export declare function subscribeUpdateApplyRunning(listener: (running: boolean) => void): () => void;
+/** The live apply job, if any: lines already streamed plus the shared promise. */
+export declare function currentUpdateApply(): UpdateApplyJob | undefined;
+/**
+ * Run `apply` once. A second call while the child is alive reuses the same
+ * promise and replays buffered lines — closing /update and opening it again
+ * must not spawn a second `npm install`.
+ */
+export declare function runUpdateApply(apply: (onLine: (line: string) => void, plan: LauncherUpdatePlan) => Promise<number>, plan: LauncherUpdatePlan, onLine?: (line: string) => void): Promise<number>;
+/** Drop a leftover job between tests. */
+export declare function resetUpdateApply(): void;
 /** One display row of the update surface. */
 export interface UpdateRow {
     readonly key: string;
@@ -47,3 +67,4 @@ export declare function UpdatePanel({ probe, apply, close, notify }: {
     /** One bounded cross-surface notice (phase completions). */
     notify: (text: string, tone?: 'info' | 'warning' | 'error') => void;
 }): ReactElement;
+export {};

package/lib/types/provider-settings.d.ts

@@ -197,6 +197,17 @@ export declare function loadProviderSettings(ctx: Context): Promise<ProviderSett
 export declare function saveProviderCredential(ctx: Context, target: ProviderTargetView, rawKey: string): Promise<void>;
 /** Save the endpoint and an explicit model allow-list without rebuilding the profile. */
 export declare function saveProviderConfiguration(ctx: Context, target: ProviderTargetView, configuration: ProviderConfiguration): Promise<void>;
+/**
+ * Switch one provider route to its subscription (plan sign-in) channel: the
+ * profile keeps neither a key reference nor an explicit model list, so the
+ * official catalog endpoint serves requests and the stored OAuth record — not
+ * a settings-named key override — authenticates them. Enabling a route that
+ * has no profile yet creates the empty profile that registers it.
+ * @param ctx - context carrying the `settings` service.
+ * @param target - provider row whose settings namespace owns the profile.
+ * @throws when the route is unmanaged or settings are read-only.
+ */
+export declare function enableProviderSubscription(ctx: Context, target: ProviderTargetView): Promise<void>;
 /**
  * Interrogate a provider endpoint for the models it really serves, through
  * the model-discovery capability the provider's settings namespace

package/lib/types/render/inspector.d.ts

@@ -48,6 +48,14 @@ export declare function liveRegionBudget(chrome: LiveRegionChrome): number;
  * accumulated `<Static>` output on every frame.
  */
 export declare function panelViewport(columns: number, rows: number): InspectorViewport;
+/**
+ * Viewport for an expanded (near-fullscreen) document overlay: the document
+ * replaces the transcript area entirely, so the half-screen overlay cap and
+ * the inter-section gaps drop away while the bottom live region (composer,
+ * status) and the Static-rewrite margin stay reserved. The result stays
+ * below terminal height, which is what keeps Ink off its full-rewrite path.
+ */
+export declare function expandedDocumentViewport(columns: number, rows: number): InspectorViewport;
 /** Backward-compatible name for the Ctrl+O-specific caller and tests. */
 export declare function inspectorViewport(columns: number, rows: number): InspectorViewport;
 /** Clamp a first-visible row to the range representable by one viewport. */

package/lib/types/render/status.d.ts

@@ -119,6 +119,8 @@ export interface StatusItemInfo {
 }
 /** The full item catalog in canonical order (the /statusline default). */
 export declare const STATUS_ITEMS: readonly StatusItemInfo[];
+/** Picker rows with labels/descriptions in the active interface language. */
+export declare function localizedStatusItems(): readonly StatusItemInfo[];
 /**
  * Default order: the whole catalog (matches the pre-customization bar).
  * The busy dot is not an item — it always leads the identity cluster.
@@ -178,7 +180,8 @@ export declare function permissionTone(permission: string): StatusTone;
 /**
  * Compose the two-row footer layout under a column budget. Row 1 keeps model,
  * cwd, mode, branch, context, then the right-pinned permission badge and cycle
- * hint. It drops hint, context, and permission before ellipsizing identity.
+ * hint. It shrinks the context bar, drops the hint, and peels trailing
+ * identity facts before removing the context group or the permission badge.
  * Row 2 fits all secondary figures and state within its own budget.
  * @param facts - identity facts resolved by the runner.
  * @param stats - session figures folded from the durable log.

package/lib/types/render/text.d.ts

@@ -11,6 +11,8 @@
  *
  * @module @deepseek-ai/dsh-code/render/text
  */
+import { stringWidth } from './width.ts';
+export { stringWidth };
 /**
  * Compact token count: exact below 1K, then one-decimal-ish K/M.
  * @param n - token count.
@@ -35,6 +37,8 @@ export declare function singleLineText(text: string): string;
  * combining sequences never split mid-cluster.
  */
 export declare function truncateColumns(text: string, columns: number): string;
+/** Sanitize, clip, and right-pad one cell to an exact terminal-column width. */
+export declare function padColumns(text: string, columns: number): string;
 /** A display-safe suffix bounded by terminal rows and columns. */
 export interface DisplayTail {
     /** Sanitized suffix suitable for direct terminal rendering. */

package/lib/types/runner/harness-gate.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Load-time DeepSeek Harness version gate.
+ *
+ * The terminal driver is validated against exactly one Harness snapshot, and
+ * the host resolves every bare `@deepseek-ai/*` import the plugin makes
+ * against ITS OWN installed copies (the profile's `HostResolvedRootInclude`
+ * redirects bare names to the installed-host base). No install-time or
+ * load-time check exists anywhere on that path, so a user who updates `dsh`
+ * would otherwise run this build against unvetted upstream code silently.
+ *
+ * This gate mirrors how the host itself reads its identity: the running CLI
+ * entry (`process.argv[1]`) sits inside the `@deepseek-ai/dsh` package, whose
+ * manifest version is released in lockstep with the Harness packages bundled
+ * beside it. When the probe can identify the host it compares the running
+ * versions against the one this build declares and fails fast with an
+ * actionable message; when it cannot identify the host it stays silent rather
+ * than brick a supported embedding on a false positive.
+ *
+ * @module @deepseek-ai/dsh-code/runner/harness-gate
+ */
+/** The one Harness release this build was validated against. */
+export declare const EXPECTED_HARNESS_VERSION = "0.1.5-rc.2";
+/** Host packages whose bundled copy the plugin binds to at runtime. */
+export declare const HARNESS_GATE_PACKAGES: readonly ["@deepseek-ai/dsh-agent", "@deepseek-ai/dsh-session"];
+/** Filesystem slice the probe needs; injectable so tests stay pure. */
+export interface HarnessFs {
+    /** Resolve a symlinked entry to its real path. */
+    realpathSync(path: string): string;
+    /** Read and parse one package.json; undefined when absent or unreadable. */
+    readManifest(path: string): {
+        name?: unknown;
+        version?: unknown;
+    } | undefined;
+}
+/** What the probe learned about the running host. */
+export interface HarnessProbe {
+    /** Installed-host package root, when identified. */
+    readonly hostRoot?: string;
+    /** Installed-host CLI version (`@deepseek-ai/dsh`). */
+    readonly hostVersion?: string;
+    /** Version of each gate package bundled beside the host, when present. */
+    readonly packages: Readonly<Record<string, string | undefined>>;
+}
+/**
+ * Identify the running host and the Harness versions it provides.
+ * @param argv1 - `process.argv[1]`, the running CLI entry path.
+ * @param fs - filesystem slice; defaults to the real one.
+ * @returns the probe result; `packages` is empty when the host is unknown.
+ */
+export declare function probeRunningHarness(argv1: string | undefined, fs?: HarnessFs): HarnessProbe;
+/** One host fact that disagrees with the version this build declares. */
+export interface HarnessMismatch {
+    /** What was compared: the host CLI or one bundled package. */
+    readonly source: string;
+    /** The version this build was validated against. */
+    readonly expected: string;
+    /** The version the running host actually provides. */
+    readonly provided: string;
+}
+/**
+ * Compare one probe against the expected snapshot. Unknown facts never
+ * mismatch: the gate must stay silent when it cannot judge, not brick a
+ * supported embedding on missing evidence.
+ * @param expected - the Harness version this build declares.
+ * @param probe - the running host's identified versions.
+ * @returns every concrete disagreement, empty when compatible or unknown.
+ */
+export declare function harnessVersionMismatches(expected: string, probe: HarnessProbe): readonly HarnessMismatch[];
+/**
+ * Render the gate failure the user sees on stderr.
+ * @param expected - the Harness version this build declares.
+ * @param mismatches - the disagreements to report.
+ * @param hostRoot - installed-host root, when identified, for the fix hint.
+ * @returns the multi-line diagnostic.
+ */
+export declare function harnessGateMessage(expected: string, mismatches: readonly HarnessMismatch[], hostRoot?: string): string;
+/**
+ * Refuse to run against an identified-but-incompatible host.
+ * @param expected - the Harness version this build declares.
+ * @param probe - the running host's identified versions.
+ * @throws an Error carrying the gate diagnostic when a version disagrees.
+ */
+export declare function requireHarnessVersion(expected: string, probe: HarnessProbe): void;