dsh-ssh-tui 0.5.1 → 0.5.3

package/lib/types/approval-reviewer.d.ts

@@ -1,3 +1,15 @@
+/**
+ * AI reviewer for /approval auto mode: commands whose shape the rule table
+ * cannot classify are judged by the subagent-configured model with compact
+ * context (latest user message, recent model output, the pending tool call)
+ * instead of paging the human.
+ *
+ * Injection hardening: everything inside the marked data regions is review
+ * MATERIAL, never instructions — the system prompt says so, and material that
+ * tries to instruct is treated as an injection attempt and rejected. The
+ * caller also enforces its own floor: `high` risk or `authorization: no`
+ * is never approved, whatever the model claims.
+ */
 export interface ReviewInput {
     userText: string;
     segments: string[];
@@ -13,8 +25,4 @@ export interface ReviewVerdict {
 export declare const REVIEW_SYSTEM_PROMPT: string;
 /** Assemble the compact, fence-marked user message for the reviewer. */
 export declare function buildReviewUserMessage(input: ReviewInput): string;
-/**
- * Parse the reviewer's one-line JSON verdict. Anything unreadable, missing
- * fields, or with invalid enum values returns undefined (fail-safe).
- */
 export declare function parseReviewOutput(text: string): ReviewVerdict | undefined;

package/lib/types/auto-approval.d.ts

@@ -12,8 +12,9 @@
 export type AutoApprovalMode = 'off' | 'auto';
 export type ApprovalDecision = 'allow' | 'deny' | 'ask';
 /**
- * Whole-command danger patterns, checked before anything else. A match keeps
- * the interactive prompt regardless of what else the command contains.
+ * Whole-command danger patterns, checked before anything else. A match
+ * auto-rejects. This is a UX heuristic, not a security boundary: obfuscated
+ * or interpreter-wrapped damage still has to be contained by the sandbox.
  */
 export declare const DANGER_PATTERNS: RegExp[];
 /**
@@ -38,5 +39,27 @@ export declare function classifyApproval(toolName: string, command: string | und
  * Returns undefined for non-shell tools or unparseable args.
  */
 export declare function commandFromArgs(toolName: string, args: string): string | undefined;
+/**
+ * Pull a shell command out of an approval-request `reason` when the
+ * classifier never saw the tool-call JSON (sandbox escalation, missing
+ * callId, or a card whose args were not recorded).
+ */
+export declare function commandFromApprovalReason(reason: string | undefined): string | undefined;
+/**
+ * Resolve the command the classifier should see for one approval request.
+ * Prefer the streamed bash/pwsh card, then a command already decoded on the
+ * card, then the request's reason text.
+ */
+export declare function commandForApprovalRequest(input: {
+    toolName: string;
+    reason?: string;
+    row?: {
+        name: string;
+        args: string;
+        command?: string;
+    };
+}): string | undefined;
 /** Parse the /approval argument into a mode. */
 export declare function parseAutoApprovalMode(raw: string): AutoApprovalMode | undefined;
+/** True when `/approval <arg>` should print the current mode and counters. */
+export declare function isApprovalStatusArg(raw: string): boolean;

package/lib/types/i18n/index.d.ts

@@ -15,11 +15,13 @@ export declare const UI_LOCALE_SCHEMA: z<Schemastery.ObjectS<{
     skipUpdate: z<string, string>;
     view: z<string, string>;
     disconnect: z<string, string>;
+    autoApproval: z<string, string>;
 }>, Schemastery.ObjectT<{
     language: z<string, string>;
     skipUpdate: z<string, string>;
     view: z<string, string>;
     disconnect: z<string, string>;
+    autoApproval: z<string, string>;
 }>>;
 export declare function localeFromTag(tag: string): Locale | undefined;
 /** Pick zh/en from env, optionally after a saved settings value. */

package/lib/types/tui.d.ts

@@ -17,6 +17,7 @@ import { SessionId, type SessionEvent } from '@deepseek-ai/dsh-session';
 import type { SubagentRunEndInfo, SubagentRunInfo } from '@deepseek-ai/dsh-subagent';
 import { type SubagentSelectionRef } from './subagent-model.js';
 import { type AskUserQuestionAnswer, type AskUserQuestionRequest } from '@deepseek-ai/dsh-user-questions';
+import type { ApprovalOutcome, ApprovalRequest } from '@deepseek-ai/dsh-user-approval';
 export type DisconnectPolicyName = 'pause' | 'continue';
 /** Presentation configuration for the terminal channel. */
 export interface TuiConfig {
@@ -112,6 +113,8 @@ type Row = {
     expanded: boolean;
     /** Consecutive same-path reads/edits folded into this card. */
     repeats?: number;
+    /** Call ids folded into this card; results still match after merge. */
+    mergedCallIds?: string[];
     /** Sum of output characters across folded reads. */
     totalChars?: number;
     /** Sum of output lines across folded reads. */
@@ -223,6 +226,50 @@ export interface TuiController {
 export type PaintLinkKind = 'local' | 'ssh';
 /** Compact token count, matching the web stats line (517 / 12.2K / 1.2M). */
 export declare function formatTokens(n: number): string;
+/**
+ * Prompt occupancy of the next request, from DSH `contextPressure`.
+ * Provider-agnostic: uses the routed model's advertised window, not a
+ * hardcoded xAI size. Compaction-basic still owns in-turn pressure at 80%.
+ */
+export declare const CONTEXT_PRESSURE_WARN_RATIO = 0.8;
+export declare const CONTEXT_PRESSURE_DANGER_RATIO = 0.95;
+/** Idle auto-compact starts here so recovery finishes before the 80% in-turn trigger. */
+export declare const CONTEXT_IDLE_COMPACT_RATIO = 0.72;
+export interface ContextPressureSample {
+    usedTokens: number;
+    contextWindow: number;
+}
+export interface ContextPressureView {
+    usedTokens: number;
+    contextWindow: number;
+    percent: number;
+    level: 'ok' | 'warn' | 'danger';
+}
+/** Prompt-side occupancy of one usage sample: uncached input plus cache traffic. */
+export declare function promptPressureTokens(usage: {
+    inputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+}): number;
+/** Prefer the next-request projection; fall back to last-request pressure. */
+export declare function contextPressureUsedTokens(pressure: {
+    projectedTokens?: number;
+    pressureTokens?: number;
+} | undefined): number | undefined;
+export declare function parseContextPressure(value: unknown): ContextPressureSample | undefined;
+export declare function contextPressureView(sample: ContextPressureSample): ContextPressureView;
+/**
+ * 8-segment Braille ring. Empty `⣀`; full `⣿`. Width is always 1 cell.
+ * Index is `ceil(percent / 12.5)` clamped to 0..8.
+ */
+export declare const CONTEXT_RING_EMPTY = "\u28C0";
+export declare const CONTEXT_RING_SEGMENTS: readonly ["⣀", "⠉", "⠋", "⠛", "⠞", "⠟", "⠿", "⡿", "⣿"];
+export declare function formatContextPressureRing(percent: number): string;
+export declare function contextPressureRingColor(level: ContextPressureView['level']): string;
+export declare function formatContextPressureChip(view: ContextPressureView, color?: boolean): string;
+export declare function formatContextPressureStatusLine(view: ContextPressureView | undefined): string;
+export declare function contextPressureAlertText(view: ContextPressureView): string;
+export declare function shouldIdleAutoCompact(view: ContextPressureView | undefined): boolean;
 /** Compact duration, matching the web stats line (45.2s / 2m42s). */
 export declare function formatDuration(ms: number): string;
 export declare function formatTokensPerSecond(tokensPerSecond: number): string;
@@ -306,6 +353,7 @@ export interface FooterStatusInput {
     subDiffers: boolean;
     quotaCode?: string;
     quotaPercent?: number;
+    contextChip?: string;
     balanceText?: string;
     search?: {
         index: number;
@@ -359,6 +407,7 @@ export interface StatusReportInput {
     disconnect?: DisconnectPolicyName;
     waitingQuestions: number;
     quota?: QuotaSnapshot;
+    context?: ContextPressureView;
     parentModel?: string;
     subProvider?: string;
     subModel: string;
@@ -573,6 +622,15 @@ export declare function countDiffAddDel(hunks: readonly ToolDiffHunk[] | undefin
  */
 export declare function diffStatToken(add: number, del: number): string;
 export declare function toolTargetPath(name: string, args: string, fallback?: string): string;
+/** Path shown on a compact single-file edit summary. */
+export declare function compactEditPath(item: {
+    name: string;
+    args: string;
+    summary?: string;
+    diff?: readonly {
+        path?: string;
+    }[];
+}): string;
 export declare function countOutputLines(text: string): number;
 /**
  * Consecutive same-path reads (or edits) collapse onto one card.
@@ -642,6 +700,8 @@ export declare function parseFindQuery(raw: string): {
 export declare function promptInjectionSources(text: string, plugin?: string): string[];
 export declare function promptInjectionTitle(sources: readonly string[]): string;
 export declare function isPromptInjectionMessage(sourceKind: string, text: string, plugin?: string): boolean;
+/** Official `/compact` idle-only failures, mapped to a local sentence. */
+export declare function formatCompactCommandError(text: string): string;
 export declare function compactionHeaderText(row: {
     status: 'running' | 'ok' | 'error';
     pruneCount: number;
@@ -822,6 +882,8 @@ export declare class SshTui {
     private activeSubagents;
     private subagentSessions;
     private openToolCalls;
+    /** Survives result settlement so a card-less result can still be labelled. */
+    private toolCallNames;
     private readonly stats;
     private openStepStats;
     private readonly pendingToolTimes;
@@ -859,6 +921,10 @@ export declare class SshTui {
     private quotaAlerted;
     private quotaStepsSinceRefresh;
     private quotaRefreshInFlight;
+    private contextPressure;
+    private contextAlertLevel;
+    private idleCompactInFlight;
+    private lastIdleCompactAt;
     private searchHits;
     private searchIndex;
     private searchQuery;
@@ -936,6 +1002,8 @@ export declare class SshTui {
     private markDirty;
     private toolCardSummary;
     private mergeIntoToolCard;
+    private findToolRowByCallId;
+    private findMergeableToolRow;
     /** Append one transcript row, bounding memory on long sessions. */
     private pushRow;
     /** The transcript rows that support per-row expand/collapse. */
@@ -959,8 +1027,8 @@ export declare class SshTui {
     private upsertPlanRow;
     /** Whether the live plan strip should occupy the workspace footer. */
     private shouldDockPlan;
-    /** One follow-up per leftover list; replay and cancelled turns stay quiet. */
-    private queuePlanCloseNudge;
+    /** Send the leftover-todo nudge only from true idle, so /compact is not blocked. */
+    private flushPlanCloseNudge;
     /** Compact web-style plan strip pinned above the input, not in the transcript. */
     private paintPlanDock;
     private paintToolBodyLine;
@@ -1022,6 +1090,11 @@ export declare class SshTui {
     private handleExtensionEvent;
     private findCompactionRow;
     private handleCompactionEvent;
+    private readContextPressure;
+    private refreshContextPressure;
+    private canRunCompactCommand;
+    private maybeIdleAutoCompact;
+    private dispatchCompactCommand;
     private handleCommandRun;
     private formatCommandText;
     private handleCommandDone;
@@ -1047,7 +1120,8 @@ export declare class SshTui {
      * output was unusable (caller falls back to prompt/reject).
      */
     private reviewUnknownWithModel;
-    private readonly handleApproval;
+    private recordAutoApproval;
+    readonly handleApproval: (request: ApprovalRequest, _next: () => Promise<ApprovalOutcome>) => Promise<ApprovalOutcome>;
     readonly handleUserQuestions: (request: AskUserQuestionRequest) => Promise<AskUserQuestionAnswer>;
     /** Queue one dialog behind an already-open one instead of overwriting it. */
     private openDialog;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ssh-tui",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "SSH-friendly interactive terminal TUI plugin for DeepSeek Harness",
   "keywords": [
     "deepseek-harness",
@@ -56,12 +56,12 @@
       "patch": "./cordis.patch.yml"
     },
     "compatibility": {
-      "dsh": ">=0.1.1-rc.2 <0.2.0",
+      "dsh": ">=0.1.1-rc.2 <0.1.3",
       "dshReleases": {
         "0.1.2-rc.1": "compatible",
         "0.1.3-alpha.1": "unknown",
-        "0.1.3-alpha.2": "unknown",
-        "0.1.5-alpha.1": "unknown"
+        "0.1.3-alpha.2": "incompatible",
+        "0.1.5-alpha.1": "incompatible"
       },
       "profiles": ["tui"]
     }