dsh-ssh-tui 0.7.2 → 0.7.3

package/lib/types/tui.d.ts

@@ -20,6 +20,7 @@ import type { Context } from '@deepseek-ai/cordis';
 import { type LlmCallConfig } from '@deepseek-ai/dsh-llm';
 import { SessionId, type SessionEvent } from '@deepseek-ai/dsh-session';
 import type { SubagentRunEndInfo, SubagentRunInfo } from '@deepseek-ai/dsh-subagent';
+import { type TerminalCapabilities } from './terminal-caps.js';
 import { type SessionRoute } from './session-route.js';
 import { type SubagentSelectionRef } from './subagent-model.js';
 import { type AskUserQuestionAnswer, type AskUserQuestionRequest } from '@deepseek-ai/dsh-user-questions';
@@ -31,7 +32,7 @@ export { clipAnsiToWidth, cursorVisualPosition, displayWidth, foldInputView, hre
 export { captureHangupSignals, composePaintOutput, detectSshSession, formatLinkQualityChip, ignoreFurtherHangupSignals, isEscapePrefix, findCursorPositionReply, isHangupErrno, linkQualityOf, linkSignalPips, paintIntervalForRtt, paintLinkLabel, parseCursorPositionReply, pickerWindowStart, probeTerminalRttMs, releaseHangupSignals, resolvePaintIntervalMs, waitUntilIdleOrTimeout, writeBootSplash, type LinkQuality, type PaintLinkKind, } from './paint.js';
 export { CONTEXT_IDLE_COMPACT_RATIO, CONTEXT_PRESSURE_DANGER_RATIO, CONTEXT_PRESSURE_WARN_RATIO, CONTEXT_RING_EMPTY, CONTEXT_RING_SEGMENTS, contextPressureAlertText, contextPressureRingColor, contextPressureUsedTokens, contextPressureView, describeProviderRoute, dropFooterQuotaPlanName, fitFooterStatsLine, fitFooterStatusLine, footerActivity, footerIdentityParts, footerStatsGroups, footerSubagentForeign, paintFooterSubagentChip, formatContextPressureChip, formatContextPressureRing, formatContextPressureStatusLine, formatDuration, formatFooterQuota, formatQuotaBar, formatQuotaUnknown, formatStatusReport, providerHasQuotaSurface, quotaWindowTag, shortModelName, shortQuotaPlanName, formatTokens, formatTokensPerSecond, parseContextPressure, promptPressureTokens, providerShortCode, providerUsesLocalOAuth, shouldIdleAutoCompact, subagentRouteLabel, type ContextPressureSample, type ContextPressureView, type FooterActivityKind, type FooterStatsInput, type FooterStatusInput, type StatusReportInput, } from './footer.js';
 export { commandCodePeriodStart, commandCodeSourceFor, crossedQuotaThresholds, formatAccountBalance, formatFooterBalance, formatOpenCodeGoUsage, formatQuotaSnapshot, formatQuotaStatusLine, joinUrl, openCodeSourceFor, parseCommandCodeQuota, parseDeepSeekBalance, parseOpenAiCompatibleBalance, parseOpenCodeGoQuota, parseSuperGrokBilling, preferredQuotaWindow, quotaAlertText, quotaRefreshEverySteps, quotaRefreshEveryTurns, remainingPercentFromUsed, tightestQuotaWindow, type AccountBalanceLine, type AccountBalanceSnapshot, type CommandCodeSource, type OpenCodeFlavor, type OpenCodeSource, type QuotaPeriod, type QuotaSnapshot, type QuotaWindow, } from './quota.js';
-export { commandAcceptsAttachments, forEachSessionEvent, isAssistantStreamEvent, isTokenDeltaChunk, listPersistenceHeaders, inspectPersistenceSession, sessionEventType, sessionEvents, settingsNamespace, streamChunkOf, streamFirstTokenTime, streamFrameAttemptId, streamFrameOwner, } from './dsh-compat.js';
+export { commandAcceptsAttachments, forEachSessionEvent, isTokenDeltaChunk, listPersistenceHeaders, inspectPersistenceSession, sessionEvents, settingsNamespace, streamChunkOf, streamFirstTokenTime, streamFrameAttemptId, streamFrameOwner, } from './dsh-compat.js';
 export { applyTurnEndToPlan, askSummary, cardCategoryOf, compactionHeaderText, formatCompactCommandError, isPromptInjectionMessage, matchTranscriptRows, parseFindQuery, parsePlanTodos, planCloseNudgeText, planDockNote, planIsLive, planTitleFromMarkdown, planTurnLeftOpen, promptInjectionSources, promptInjectionTitle, buildSubagentHeader, clipSubagentActivity, describeSubagentFailure, subagentChipSummary, subagentDisplayName, subagentInspectLines, subagentRowFromSpawnTool, foldSubagentUserLog, todoProgressLabel, todoSummary, type CardCategory, } from './plan.js';
 export { buildToolHeader, canMergeToolCall, compactEditPath, compactToolBursts, compactToolGroups, countDiffAddDel, countDiffLines, countOutputLines, diffMetaDiffs, diffStatToken, friendlyJsonLines, parseExitStatus, presentToolCall, READ_TOOL_NAMES, renderToolDiff, toolBodyFitsWorkspace, toolBodyLines, toolStateColor, toolStateLabel, wrappedToolBodyLineCount, } from './tool-present.js';
 /** Presentation configuration for the terminal channel. */
@@ -78,6 +79,12 @@ export interface TuiConfig {
     selectionRef?: ModelSelectionRef;
     /** Settings-backed model/effort selection applied to subagent requests. */
     subagentSelection?: SubagentSelectionRef;
+    /**
+     * The terminal capabilities to act on. Defaults to reading the environment;
+     * tests pass their own so a suite does not change meaning with the terminal
+     * it happens to run in (`TERM=linux node --test` used to fail three cases).
+     */
+    terminalCaps?: TerminalCapabilities;
     /** Active agent-preset id (standard/code/minimal/cordis/...). */
     presetId?: string;
     /** Display name of the active preset. */
@@ -234,6 +241,14 @@ export declare class SshTui {
     /** Last route reported to the launcher; a repaint must not report it again. */
     private lastSessionRoute;
     private readonly useAlternateScreen;
+    /**
+     * What the terminal in front of us can do. Read from the environment at
+     * construction (see `terminal-caps.ts`): the mouse, bracketed paste and the
+     * alternate screen are only claimed where the terminal has them.
+     */
+    private readonly terminalCaps;
+    /** The OSC 52 caveat is worth saying once, not after every copy. */
+    private osc52HintShown;
     private agentGone;
     private onboarding;
     private commandSuggestions;
@@ -387,6 +402,15 @@ export declare class SshTui {
     constructor(ctx: Context, agent: Agent, config: TuiConfig);
     /** Enter raw mode, switch to the alternate screen, and start listening. */
     start(): void;
+    /**
+     * Take over the screen: alternate screen where it is safe, then the input
+     * modes the terminal actually supports, then hide the cursor.
+     *
+     * Joining the parts here (rather than at each call site) is what keeps
+     * `start`, a reattach and a teardown from drifting apart — the reattach path
+     * used to duplicate this string verbatim.
+     */
+    private enterScreenSequence;
     private bindAgentEvents;
     private bootBackgroundTasks;
     private notifyPluginUpdate;
@@ -748,15 +772,15 @@ export declare class SshTui {
      */
     private selectLine;
     /**
-     * Fold one live or durable stream chunk into the in-progress assistant
-     * row. 0.1.2 hosts append `assistant/chunk`; 0.1.5 emits the same chunk
-     * on `agent/assistant-stream` and never writes it to the log.
+     * Fold one live stream chunk into the in-progress assistant row. Hosts from
+     * 0.1.5 on emit the chunk on `agent/assistant-stream` and never write it to
+     * the log.
      */
     private applyStreamChunk;
     /**
-     * 0.1.5 live tokens arrive as process-local `agent/assistant-stream`
-     * frames (start / chunk / end). Chunk frames carry the same
-     * `StreamChunk` the 0.1.2 log used to store as `assistant/chunk`.
+     * 0.1.5 and 0.1.7 live tokens arrive as process-local
+     * `agent/assistant-stream` frames (start / chunk / end). Chunk frames carry
+     * the same `StreamChunk` the settled `assistant/message` embeds in `stream`.
      */
     readonly handleAssistantStream: (...args: unknown[]) => void;
     /**
@@ -1081,6 +1105,16 @@ export declare class SshTui {
      */
     /** Re-read the roster fact this process was composed with (cheap, no IO). */
     private refreshRosterHealth;
+    /** Which settings protocol this host speaks; decides what "missing" means. */
+    private get settingsGeneration();
+    /**
+     * The two lines `/mode` and `/preset` print when the preset service is absent.
+     *
+     * The reason differs by host line: 0.1.5 lost a roster the profile can mount,
+     * while 0.1.7 composes the agent process-wide and has no terminal presets at
+     * all — the repair there is the agent-plane rows, not a roster.
+     */
+    private missingPresetService;
     private repairRoster;
     /** Current provider route selected for the running agent. */
     private currentProvider;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ssh-tui",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "SSH-friendly interactive terminal TUI plugin for DeepSeek Harness",
   "keywords": [
     "deepseek-harness",
@@ -37,6 +37,14 @@
       "types": "./lib/types/startup.d.ts",
       "default": "./lib/startup.js"
     },
+    "./settings-routes": {
+      "types": "./lib/types/settings-routes.d.ts",
+      "default": "./lib/settings-routes.js"
+    },
+    "./settings-subagent": {
+      "types": "./lib/types/settings-subagent.d.ts",
+      "default": "./lib/settings-subagent.js"
+    },
     "./cordis.patch.yml": "./cordis.patch.yml",
     "./package.json": "./package.json"
   },
@@ -50,7 +58,8 @@
     "docs/screenshots/headless.png",
     "docs/screenshots/workspace.png",
     "docs/screenshots/slow-link.gif",
-    "LICENSE"
+    "LICENSE",
+    "docs/terminals.md"
   ],
   "license": "MIT",
   "dsh": {
@@ -58,15 +67,17 @@
       "patch": "./cordis.patch.yml"
     },
     "compatibility": {
-      "dsh": ">=0.1.2-rc.1 <0.1.6 || >=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6",
+      "dsh": ">=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6 || >=0.1.7-rc.1 <0.1.8",
       "dshReleases": {
-        "0.1.2-rc.1": "compatible",
+        "0.1.2-rc.1": "incompatible",
         "0.1.3-alpha.1": "unknown",
         "0.1.3-alpha.2": "compatible",
         "0.1.5-alpha.1": "compatible",
         "0.1.5-alpha.2": "compatible",
         "0.1.5-rc.1": "compatible",
-        "0.1.5-rc.2": "compatible"
+        "0.1.5-rc.2": "compatible",
+        "0.1.5-rc.3": "compatible",
+        "0.1.7-rc.1": "compatible"
       },
       "profiles": [
         "tui"
@@ -85,6 +96,8 @@
     "install:npm": "bash scripts/install-npm.sh",
     "uninstall:dsh": "bash scripts/uninstall.sh",
     "verify:dsh": "bash scripts/verify.sh",
+    "probe:home": "node scripts/probe-home.mjs --probe",
+    "probe:home:drop": "node scripts/probe-home.mjs --probe --script tui-drop-probe.mjs",
     "screenshots": "npm run build && node scripts/capture-readme-frames.mjs",
     "screenshots:slow": "npm run build && node scripts/capture-slow-link.mjs"
   },
@@ -92,31 +105,36 @@
     "node": ">=22.19"
   },
   "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.1",
+    "@deepseek-ai/schemastery": "3.18.2 || ~3.18.4",
     "commander": "^14.0.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": ">=0.1.2-rc.1 <0.1.6 || >=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6",
-    "@deepseek-ai/dsh-agent-default-model": ">=0.1.2-rc.1 <0.1.6 || >=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6",
-    "@deepseek-ai/dsh-agent-loop": ">=0.1.2-rc.1 <0.1.6 || >=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6",
-    "@deepseek-ai/dsh-agent-presets": ">=0.1.2-rc.1 <0.1.6 || >=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6",
-    "@deepseek-ai/dsh-cmdline": ">=0.1.2-rc.1 <0.1.6 || >=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6",
-    "@deepseek-ai/dsh-commands": ">=0.1.2-rc.1 <0.1.6 || >=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6",
-    "@deepseek-ai/dsh-credentials": ">=0.1.2-rc.1 <0.1.6 || >=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6",
-    "@deepseek-ai/dsh-llm": ">=0.1.2-rc.1 <0.1.6 || >=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6",
-    "@deepseek-ai/dsh-session": ">=0.1.2-rc.1 <0.1.6 || >=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6",
-    "@deepseek-ai/dsh-session-persistence": ">=0.1.2-rc.1 <0.1.6 || >=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6",
-    "@deepseek-ai/dsh-settings": ">=0.1.2-rc.1 <0.1.6 || >=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6",
-    "@deepseek-ai/dsh-subagent": ">=0.1.2-rc.1 <0.1.6 || >=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6",
-    "@deepseek-ai/dsh-user-approval": ">=0.1.2-rc.1 <0.1.6 || >=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6",
-    "@deepseek-ai/dsh-user-questions": ">=0.1.2-rc.1 <0.1.6 || >=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6"
+    "@deepseek-ai/dsh-agent": ">=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6 || >=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-agent-default-model": ">=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6 || >=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-agent-loop": ">=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6 || >=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-agent-preset": ">=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-agent-preset-registry": ">=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-agent-presets": ">=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6 || >=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-cmdline": ">=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6 || >=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-commands": ">=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6 || >=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-credentials": ">=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6 || >=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-llm": ">=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6 || >=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-session": ">=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6 || >=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-session-persistence": ">=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6 || >=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-settings": ">=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6 || >=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-subagent": ">=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6 || >=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-user-approval": ">=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6 || >=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-user-questions": ">=0.1.3-alpha.2 <0.1.6 || >=0.1.5-alpha.1 <0.1.6 || >=0.1.7-rc.1 <0.1.8"
   },
   "peerDependenciesMeta": {
-    "@deepseek-ai/dsh-user-approval": {
+    "@deepseek-ai/dsh-agent-preset": {
       "optional": true
     },
-    "@deepseek-ai/dsh-user-questions": {
+    "@deepseek-ai/dsh-agent-preset-registry": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent-presets": {
       "optional": true
     },
     "@deepseek-ai/dsh-credentials": {
@@ -124,42 +142,51 @@
     },
     "@deepseek-ai/dsh-settings": {
       "optional": true
+    },
+    "@deepseek-ai/dsh-user-approval": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-user-questions": {
+      "optional": true
     }
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
-    "@deepseek-ai/dsh": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-default-model": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-loop": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-agent-presets": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-atomic-write": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-attachment": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-brand": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-cmdline": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-commands": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-credentials": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-home-paths": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-invariants": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-jobs": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm-mock-server": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-sandbox": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-sandbox-policy": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-scope": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-persistence": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-projection": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-session-projection-cache": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-settings": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-subagent": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-timeout": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-user-approval": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-user-questions": "0.1.5-rc.2",
+    "@deepseek-ai/cordis": "4.0.2",
+    "@deepseek-ai/cordis-plugin-hmr": "1.0.17",
+    "@deepseek-ai/cordis-plugin-include": "1.0.7",
+    "@deepseek-ai/cordis-plugin-loader": "1.0.3",
+    "@deepseek-ai/cordis-plugin-timer": "1.1.4",
+    "@deepseek-ai/dsh": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-agent": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-agent-default-model": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-agent-loop": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-agent-presets": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-atomic-write": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-attachment": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-brand": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-cmdline": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-commands": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-credentials": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-home-paths": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-invariants": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-jobs": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-llm": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-llm-mock-server": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-sandbox": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-sandbox-policy": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-scope": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-session": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-session-persistence": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-session-projection": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-session-projection-cache": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-settings": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-subagent": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-system-prompt": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-timeout": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-tools": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-typert-protocol": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-user-approval": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-user-questions": "0.1.5-rc.3",
     "@types/node": "^24.0.0",
     "@xterm/headless": "^6.0.0",
     "semver": "^7.8.5",