dsh-ssh-tui 0.1.8 → 0.3.0

package/lib/types/picker.d.ts

@@ -12,10 +12,13 @@ export type SessionPickerResult = {
     kind: 'new';
 } | null;
 /**
- * Show the picker and wait for one digit, Enter (new session), or Esc/Ctrl+C
- * (cancel). Restores the terminal before resolving.
+ * Show the picker and wait for one digit, Enter (new session), or a lone
+ * Esc/Ctrl+C (cancel). Incomplete CSI/SS3 sequences are buffered briefly so
+ * arrow keys are ignored instead of cancelling. Restores the terminal before
+ * resolving; an AbortSignal cancels and restores as well.
  * @param ctx - boot context supplying sessionPersistence.
  * @param color - whether to apply ANSI colors.
+ * @param signal - optional abort signal (fiber dispose) to cancel the picker.
  * @returns the selection, or null when cancelled.
  */
-export declare function showSessionPicker(ctx: Context, color: boolean): Promise<SessionPickerResult>;
+export declare function showSessionPicker(ctx: Context, color: boolean, signal?: AbortSignal): Promise<SessionPickerResult>;

package/lib/types/tui.d.ts

@@ -11,7 +11,11 @@
  */
 import type { Agent, ModelSelection, ModelSelectionRef } from '@deepseek-ai/dsh-agent';
 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 SubagentSelectionRef } from './subagent-model.js';
+import { type AskUserQuestionAnswer, type AskUserQuestionRequest } from '@deepseek-ai/dsh-user-questions';
 /** Presentation configuration for the terminal channel. */
 export interface TuiConfig {
     /** Exact shared agent/session identity driven by this terminal. */
@@ -47,6 +51,17 @@ export interface TuiConfig {
     /** Open the history-session picker immediately after mounting (--resume). */
     resumePicker?: boolean;
 }
+type SubagentLogKind = 'user' | 'assistant' | 'tool' | 'result' | 'turn' | 'approval' | 'team' | 'system';
+/** One child-session event folded into a parent-side subagent card. */
+export interface SubagentLogEntry {
+    kind: SubagentLogKind;
+    text: string;
+}
+/** One todo-list item as the plan card renders it. */
+export interface PlanTodoItem {
+    content: string;
+    status: 'pending' | 'in_progress' | 'completed';
+}
 type Row = {
     kind: 'user';
     text: string;
@@ -77,6 +92,42 @@ type Row = {
     exitCode?: number;
     signal?: string;
     expanded: boolean;
+} | {
+    kind: 'subagent';
+    sessionId: string;
+    runId: string;
+    provider: string;
+    local: boolean;
+    label: string;
+    status: 'running' | 'ok' | 'error' | 'aborted';
+    startedAt: number;
+    endedAt?: number;
+    stopReason?: string;
+    lastActivity: string;
+    logs: SubagentLogEntry[];
+    expanded: boolean;
+} | {
+    kind: 'plan';
+    active: boolean;
+    pending: boolean;
+    todos: PlanTodoItem[];
+    expanded: boolean;
+} | {
+    kind: 'question';
+    questionId: string;
+    title: string;
+    header?: string;
+    detail?: string;
+    intent: 'ask' | 'plan-review';
+    status: 'waiting' | 'answered' | 'cancelled';
+    summary: string;
+    expanded: boolean;
+} | {
+    kind: 'goal';
+    objective: string;
+    phase: 'active' | 'paused' | 'blocked' | 'complete' | 'cleared';
+    blockedReason?: string;
+    expanded: boolean;
 } | {
     kind: 'system';
     text: string;
@@ -95,6 +146,13 @@ interface ToolDiffHunk {
 export interface TuiController {
     dispose(): Promise<void>;
 }
+/** Human-facing kind for a live LLM route. */
+export declare function describeProviderRoute(provider: string): {
+    kind: string;
+    short: string;
+};
+/** Routes that authenticate without a harness API-key credential. */
+export declare function providerUsesLocalOAuth(provider: string): boolean;
 /**
  * Render workspace markdown into width-bounded terminal rows. Assistant
  * replies get a bold-white base; code blocks, headings, quotes, lists, rules,
@@ -132,6 +190,18 @@ export interface OpenCodeSource {
 export declare function openCodeSourceFor(provider: string, llmPiAiSection: unknown): OpenCodeSource | null;
 /** Render the OpenCode Go quota payload as a transcript block. */
 export declare function formatOpenCodeGoUsage(payload: unknown, source: OpenCodeSource): string;
+/** Whether `text` could still grow into a recognized escape sequence. */
+export declare function isEscapePrefix(text: string): boolean;
+/** Parse a todo_write payload into displayable plan items. */
+export declare function parsePlanTodos(value: unknown): PlanTodoItem[];
+/** Compact todo-list summary: done/total plus the first in-progress task. */
+export declare function todoSummary(value: unknown): string;
+/** Compact ask_user_question summary from tool arguments. */
+export declare function askSummary(value: unknown): string;
+/** One-line subagent card header used while collapsed. */
+export declare function subagentHeaderText(row: Extract<Row, {
+    kind: 'subagent';
+}>, now?: number): string;
 /** One-line friendly tool-call presentation (command / path / arg summary). */
 export declare function presentToolCall(name: string, args: string): {
     title: string;
@@ -263,6 +333,11 @@ export declare class SshTui {
     private pushRow;
     /** The transcript rows that support per-row expand/collapse. */
     private collapsibleRows;
+    private spinnerFrame;
+    private findSubagentRow;
+    private findLivePlanRow;
+    private upsertPlanRow;
+    private paintCollapsibleHeader;
     /** Move the expand/collapse focus among reasoning and tool rows. */
     private moveCollapsibleFocus;
     /** Toggle the focused block; without focus, toggle the most recent one. */
@@ -272,6 +347,7 @@ export declare class SshTui {
     private paint;
     private buildSuggestions;
     private suggestionsVisible;
+    private currentProviderId;
     private currentSelectionLabel;
     /** Replace one step's usage sample so a repeated report never double counts. */
     private recordUsage;
@@ -289,19 +365,27 @@ export declare class SshTui {
      * owns the route); direct children created by tool-subagent inherit the
      * parent provider unless `/submodel` stored an explicit subagent provider.
      */
-    private readonly handleAgentRequest;
-    private readonly handleSessionEvent;
+    readonly handleAgentRequest: ({ agent }: {
+        agent: Agent;
+    }, next: () => Promise<LlmCallConfig>) => Promise<LlmCallConfig>;
+    readonly handleSessionEvent: (session: {
+        id: SessionId;
+    }, event: SessionEvent) => void;
     private readonly handleStatus;
     private readonly handleError;
     private readonly handleInboxClaimed;
     private readonly handleInboxDiscarded;
     private readonly handleDisposed;
-    /** Render a live subagent's own session events so its progress is visible. */
-    private readonly handleSubagentSessionEvent;
-    private readonly handleSubagentStart;
-    private readonly handleSubagentEnd;
+    /** Plan-mode / command / team events that plugins merge into SessionEventMap. */
+    private handleExtensionEvent;
+    private handleGoalChange;
+    private handleSubagentExtensionEvent;
+    /** Fold a live subagent's own session events into that child's card. */
+    readonly handleSubagentSessionEvent: (sessionId: SessionId, event: SessionEvent) => void;
+    readonly handleSubagentStart: (info: SubagentRunInfo) => void;
+    readonly handleSubagentEnd: (info: SubagentRunEndInfo) => void;
     private readonly handleApproval;
-    private readonly handleUserQuestions;
+    readonly handleUserQuestions: (request: AskUserQuestionRequest) => Promise<AskUserQuestionAnswer>;
     /** Queue one dialog behind an already-open one instead of overwriting it. */
     private openDialog;
     private showNextDialog;
@@ -336,7 +420,9 @@ export declare class SshTui {
      * dialog so an endpoint with dozens of models stays selectable.
      */
     private pickModelOption;
-    /** /model: pick a model and reasoning effort for the current provider. */
+    /** Live adapter routes the TUI can switch to, plus the current selection. */
+    private listSelectableProviders;
+    /** /model: pick a provider, then a model and reasoning effort on that route. */
     private runModelCommand;
     /** Provider route the next subagent request should use. */
     private effectiveSubagentProvider;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ssh-tui",
-  "version": "0.1.8",
+  "version": "0.3.0",
   "description": "SSH-friendly interactive terminal TUI plugin for DeepSeek Harness",
   "keywords": [
     "deepseek-harness",
@@ -72,19 +72,20 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-agent-default-model": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-agent-loop": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-cmdline": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-commands": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-session": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-subagent": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-user-approval": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-user-questions": "^0.1.0-rc.6"
+    "@deepseek-ai/dsh-agent": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent-default-model": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent-loop": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-cmdline": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-commands": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-credentials": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-session": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-subagent": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-user-approval": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-user-questions": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.1-rc.2"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-user-approval": {
@@ -102,20 +103,21 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-agent-default-model": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-agent-loop": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-cmdline": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-commands": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-session": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-subagent": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-user-approval": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-user-questions": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-agent": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent-default-model": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent-loop": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-cmdline": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-commands": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-credentials": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-session": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-subagent": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-user-approval": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-user-questions": "^0.1.1-rc.2",
     "@types/node": "^24.0.0",
-    "typescript": "^5.9.0"
+    "typescript": "^5.9.0",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.1-rc.2"
   }
 }