dsh-ssh-tui 0.1.6 → 0.1.7

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

@@ -0,0 +1,56 @@
+/**
+ * Subagent model defaults and the settings section the TUI edits with
+ * `/submodel` and `/subeffort`.
+ *
+ * The provider is deliberately inherited from the running parent session:
+ * the subagent selection only overrides the provider when the user stored an
+ * explicit route. The model defaults to the lightweight `deepseek-v4-flash`.
+ */
+import z from '@deepseek-ai/schemastery';
+import type { Context } from '@deepseek-ai/cordis';
+import { type ReasoningEffortId as ReasoningEffort } from '@deepseek-ai/dsh-llm';
+/** Settings namespace carrying the TUI's subagent model selection. */
+export declare const SUBAGENT_SETTINGS_NAMESPACE: import("@deepseek-ai/dsh-settings").SettingsNamespace;
+/** Lightweight default model used for subagent children. */
+export declare const DEFAULT_SUBAGENT_MODEL = "deepseek-v4-flash";
+/** Raw settings document shape. */
+export interface SubagentSettings {
+    /** Explicit provider override; omitted means "same provider as the parent". */
+    provider?: string;
+    /** Subagent model id. */
+    model?: string;
+    /** Adapter-owned reasoning effort id. */
+    reasoningEffort?: string;
+}
+/** Live, typed subagent selection. */
+export interface SubagentSelection {
+    /** Explicit provider override; undefined inherits the parent route. */
+    provider?: string;
+    /** Subagent model id. */
+    model: string;
+    /** Reasoning effort; undefined follows the provider/model default. */
+    reasoningEffort?: ReasoningEffort;
+}
+/** Mutable selection handle shared by the settings watcher and the TUI. */
+export interface SubagentSelectionRef {
+    current: SubagentSelection;
+}
+/** Settings schema for `$DSH_HOME/settings.yaml`. */
+export declare const SUBAGENT_SETTINGS_SCHEMA: z<Schemastery.ObjectS<{
+    provider: z<string, string>;
+    model: z<string, string>;
+    reasoningEffort: z<string, string>;
+}>, Schemastery.ObjectT<{
+    provider: z<string, string>;
+    model: z<string, string>;
+    reasoningEffort: z<string, string>;
+}>>;
+/** Normalize a raw settings section into a live typed selection. */
+export declare function normalizeSubagentSelection(value: unknown): SubagentSelection;
+/**
+ * Install the settings-backed subagent selection for one TUI plugin fiber.
+ * Returns the mutable ref the request waterfall and the slash commands share.
+ */
+export declare function createSubagentSelection(ctx: Context): SubagentSelectionRef;
+/** Serialize a live selection back into the settings document shape. */
+export declare function subagentSettingsValue(selection: SubagentSelection): SubagentSettings;

package/lib/types/tui.d.ts

@@ -11,6 +11,7 @@
  */
 import type { Agent, ModelSelection, ModelSelectionRef } from '@deepseek-ai/dsh-agent';
 import type { Context } from '@deepseek-ai/cordis';
+import { type SubagentSelectionRef } from './subagent-model.js';
 /** Presentation configuration for the terminal channel. */
 export interface TuiConfig {
     /** Exact shared agent/session identity driven by this terminal. */
@@ -33,6 +34,8 @@ export interface TuiConfig {
     model?: string;
     /** Live model-selection ref installed on the agent; mutated by /model. */
     selectionRef?: ModelSelectionRef;
+    /** Settings-backed model/effort selection applied to subagent requests. */
+    subagentSelection?: SubagentSelectionRef;
     /** Active agent-preset id (standard/code/minimal/cordis/...). */
     presetId?: string;
     /** Display name of the active preset. */
@@ -201,6 +204,7 @@ export declare class SshTui {
     private readonly resume;
     private readonly providerName;
     private readonly selectionRef;
+    private readonly subagentSelection;
     private readonly onSwitchSession;
     private readonly onSelectionChanged;
     private readonly resumePicker;
@@ -279,6 +283,13 @@ export declare class SshTui {
     private playCompletionSignal;
     private render;
     private styleLine;
+    /**
+     * Apply the TUI's subagent model selection to every child-agent request.
+     * The parent request is left untouched (its own `/model` waterfall already
+     * 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;
     private readonly handleStatus;
     private readonly handleError;
@@ -327,6 +338,16 @@ export declare class SshTui {
     private pickModelOption;
     /** /model: pick a model and reasoning effort for the current provider. */
     private runModelCommand;
+    /** Provider route the next subagent request should use. */
+    private effectiveSubagentProvider;
+    /** Persist one subagent selection and publish it to the live request waterfall. */
+    private saveSubagentSelection;
+    /** Resolve the picker model list for one provider (endpoint first, then catalog). */
+    private subagentModelOptions;
+    /** /submodel: pick (or set) the model subagent children use. */
+    private runSubmodelCommand;
+    /** /subeffort: pick the reasoning effort subagent children use. */
+    private runSubeffortCommand;
     /** /mode: pick an agent preset (standard / minimal / code / cordis / routing-suite / ...). */
     private runModeCommand;
     /** /resume: switch to a past session, or open a picker when no id is given. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ssh-tui",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "SSH-friendly interactive terminal TUI plugin for DeepSeek Harness",
   "keywords": [
     "deepseek-harness",
@@ -67,6 +67,7 @@
     "node": ">=22.19"
   },
   "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1",
     "commander": "^14.0.0"
   },
   "peerDependencies": {