dsh-code 1.3.0 → 1.5.0

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

@@ -86,8 +86,15 @@ export declare const en: {
     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)";
@@ -132,7 +139,7 @@ export declare const en: {
     readonly 'cmd.theme': "switch the color theme";
     readonly 'cmd.language': "switch the interface language (/language [en|zh])";
     readonly 'cmd.rainbow': "reroll or pin the rainbow palette (/rainbow [seed])";
-    readonly 'cmd.animation': "toggle timed animations (/animation [on|off])";
+    readonly 'cmd.animation': "toggle decorative animations; shimmer and activity stay live (/animation [on|off])";
     readonly 'cmd.history': "search and recall past prompts";
     readonly 'cmd.queue': "manage messages queued for the next turn";
     readonly 'cmd.usage': "show this session token usage";
@@ -268,12 +275,12 @@ export declare const en: {
     readonly 'notice.imageCancelled': "image submission cancelled";
     readonly 'notice.themeConfigUnreadable': "theme config unreadable, using dark: {message}";
     readonly 'notice.languageConfigUnreadable': "language config unreadable, using english: {message}";
-    readonly 'notice.animationsConfigUnreadable': "animations config unreadable, animations stay on: {message}";
+    readonly 'notice.animationsConfigUnreadable': "decorative animation config unreadable, effects stay on: {message}";
     readonly 'notice.statuslineConfigUnreadable': "statusline config unreadable, using defaults: {message}";
     readonly 'notice.sessionSearchUnavailable': "session search is unavailable in this deployment";
     readonly 'notice.subagentsReadOnly': "subagent conversations are read-only";
     readonly 'notice.statuslineSaveFailed': "statusline save failed: {message}";
-    readonly 'notice.animationsSaveFailed': "animations save failed: {message}";
+    readonly 'notice.animationsSaveFailed': "decorative animation save failed: {message}";
     readonly 'notice.commandRegistryMissing': "no command registry is mounted in this composition";
     readonly 'notice.commandFallbackFailed': "command fallback failed: {message}";
     readonly 'notice.commandFailed': "command failed: {message}";
@@ -324,7 +331,7 @@ export declare const en: {
     readonly 'notice.commandAttachments': "commands cannot carry attachments; the line will be sent to the model as a prompt";
     readonly 'notice.copyFailed': "copy failed: {message}";
     readonly 'notice.vscodeKeysFailed': "vscode-keys failed: {message}";
-    readonly 'notice.animationState': "animations {state}";
+    readonly 'notice.animationState': "decorative animations {state}; activity indicators stay live";
     readonly 'notice.deleteFailed': "delete failed: {message}";
     readonly 'notice.modelChangedPlaceholder': "model → {model} · image history will be sent as text placeholders";
     readonly 'notice.modelNextStep': "model → next step uses {model}";
@@ -417,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";
@@ -432,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";
@@ -460,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[]>;
@@ -110,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
@@ -182,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,7 +9,7 @@
  * here.
  */
 import { type ReactElement } from 'react';
-import type { LauncherUpdatePlan, 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. */

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

@@ -1,4 +1,12 @@
 /** Pure viewport, selection, and scrolling rules for exclusive TUI panels. */
+import type { TranscriptEntry } from './projection.ts';
+/**
+ * Remove assistant settlements that contain reasoning but no final response.
+ * They remain in the durable transcript and in the Ctrl/Alt+R fold; excluding
+ * them only from Ctrl+O navigation prevents short progress thoughts from
+ * appearing as a long run of misleading `reply` entries.
+ */
+export declare function inspectableTranscriptEntries(entries: readonly TranscriptEntry[]): readonly TranscriptEntry[];
 /** Terminal-space allocation for the inspector's one dynamic screen. */
 export interface InspectorViewport {
     /** Maximum dynamic rows, kept strictly below the terminal height. */
@@ -48,6 +56,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/projection-events.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Explicit compatibility policy for durable session events entering the TUI.
+ *
+ * The Harness event map is merge-extensible, so a reducer default branch is
+ * unavoidable: deployments may mount plugins this bundle does not know. The
+ * default must not, however, let a NEW first-party event silently bypass
+ * review. Tests compare this policy with `KNOWN_SESSION_EVENT_TYPES`; every
+ * kernel event must be deliberately classified before a Harness-line bump.
+ *
+ * @module @deepseek-ai/dsh-tui/render/projection-events
+ */
+/** How one durable event relates to the terminal transcript projection. */
+export type SessionEventDisposition = 'transcript' | 'other-surface' | 'ignored' | 'unknown';
+/** Events folded directly into `TranscriptView`. */
+export declare const TRANSCRIPT_SESSION_EVENT_TYPES: readonly ["agent/inbox/spliced", "assistant/attempt", "assistant/message", "command/done", "command/run", "compaction/end", "compaction/prune", "compaction/summary", "goal/change", "llm/retry", "llm/retry-started", "permission/preset", "plan/mode", "request/context", "request/header", "sandbox/mode", "schedule/change", "session/title", "step/start", "system/message", "todo/write", "tool-workflow/agent-end", "tool-workflow/agent-start", "tool-workflow/run-end", "tool-workflow/run-start", "tool/call", "tool/ptc-dispatch", "tool/ptc-dispatch-start", "tool/result", "turn/end", "turn/start", "user/message"];
+/**
+ * Events consumed by another TUI adapter rather than the transcript fold.
+ * Keeping these separate documents that they are visible behavior, not
+ * accidental no-ops.
+ */
+export declare const OTHER_SURFACE_SESSION_EVENT_TYPES: readonly ["agent-preset/selected", "model/selection", "subagent/catalog"];
+/**
+ * Kernel events deliberately omitted from terminal presentation. Their
+ * model-visible consequences arrive through projected message/tool/session
+ * events, while audit-only facts do not need a second transcript row.
+ */
+export declare const IGNORED_SESSION_EVENT_TYPES: readonly ["approval/asked", "approval/decided", "approval/policy", "compaction/start", "deliverables/presented", "feedback/message-delete", "feedback/message-put", "feedback/record", "hook/invoked", "hook/result", "session-log-deepseek/delivery-accepted", "session/end-seed", "session/title-llm-request", "step/end", "subagent/descriptor", "subagent/model-selection-policy", "team/member", "team/message/delivered", "team/message/queued", "team/task", "web/deepseek-search-llm-request"];
+/**
+ * Classify a durable event without rejecting merge-extensible plugin events.
+ * `unknown` remains a runtime no-op for forward/plugin compatibility; the
+ * known-event coverage test is what makes a first-party addition fail CI.
+ */
+export declare function sessionEventDisposition(type: string): SessionEventDisposition;

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/render/transcript-viewport.d.ts

@@ -0,0 +1,32 @@
+/** Physical-row viewport state for native scrollback plus a bottom-anchored tail. */
+export interface TranscriptViewportCursor {
+    readonly sessionKey: string;
+    readonly epoch: number;
+    readonly flushedRows: number;
+}
+export interface TranscriptViewportInput {
+    readonly sessionKey: string;
+    readonly epoch: number;
+    /** Physical durable transcript rows in the current rendered-history window. */
+    readonly totalRows: number;
+    /** Maximum durable rows retained outside Static for the live viewport. */
+    readonly retainedRows: number;
+}
+export interface TranscriptViewportStep {
+    readonly cursor: TranscriptViewportCursor;
+    /** Durable physical rows emitted through Static. */
+    readonly staticRows: number;
+    /** Durable physical rows still available to the live viewport. */
+    readonly liveRows: number;
+}
+/**
+ * Advance the monotonic physical-row flush cursor.
+ *
+ * Ordinary renders never pull a row back out of native scrollback. A source-
+ * backed replay (epoch change) flushes the complete durable window exactly
+ * once after the caller clears/remounts Static; subsequent durable rows start
+ * a fresh retained tail. Session/reset shrink starts from the new source.
+ */
+export declare function advanceTranscriptViewport(previous: TranscriptViewportCursor, input: TranscriptViewportInput): TranscriptViewportStep;
+/** Real history rows that fit beside the currently painted stream/tool rows. */
+export declare function visibleTranscriptRows(historyRows: number, occupiedRows: number, capacity: number): number;

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;

package/lib/types/runner/input-history.d.ts

@@ -0,0 +1,31 @@
+/** Global input recall: the appended prompts and their durable JSONL file.
+ *
+ * One JSONL file under the DSH home. A missing file means an empty history and
+ * unreadable or corrupt content degrades to the valid lines it could parse,
+ * silently — recall is a convenience surface, never a gate.
+ *
+ * @module @deepseek-ai/dsh-code/input-history
+ */
+/** Live recall state plus its serialized durable writes. */
+export interface InputHistoryStore {
+    /** The recall list, newest last; read live by the composer. */
+    readonly entries: () => readonly string[];
+    /** Append one submitted line and persist it; '' is ignored. */
+    readonly record: (text: string) => void;
+    /** Await the pending writes (the quit flush). */
+    readonly flush: () => Promise<void>;
+}
+/**
+ * Load the recall history and return its live store.
+ *
+ * Serialized history writes: each submission appends one JSON line at the end
+ * of the file, so concurrent terminals add entries after each other instead of
+ * overwriting snapshots they read at their own boot. A multi-line draft still
+ * occupies one physical line (JSON escapes the newline), and a regular-length
+ * line reaches the disk as one positioned write; an oversized paste may
+ * interleave mid-line, which the next parse simply drops.
+ *
+ * @param path - absolute path of the JSONL recall file.
+ * @param onFailure - receives the write failure message for a bounded notice.
+ */
+export declare function createInputHistory(path: string, onFailure: (message: string) => void): InputHistoryStore;