@linxin666/dsh-ssh 0.3.6 → 0.3.10

package/lib/index.js

@@ -1,4 +1,3 @@
-import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 import { closeSync, createReadStream, createWriteStream, existsSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from "node:fs";
 import { Client } from "ssh2";
 import { homedir, tmpdir } from "node:os";
@@ -3560,7 +3559,7 @@ const inject = [
 * surface edits. Spelled here rather than imported: the browser half spells
 * the same value and must not depend on a Host package.
 */
-const SSH_SETTINGS_NAMESPACE = settingsNamespace("dsh-ssh");
+const SSH_SETTINGS_NAMESPACE = "dsh-ssh";
 const Config = import_lib.default.object({
 	announceToAgent: import_lib.default.boolean().default(false),
 	enabled: import_lib.default.boolean().default(true),
@@ -3580,18 +3579,21 @@ const SSH_GUIDANCE = "本机已安装 dsh-ssh 插件（DSH 远程 SSH 运维）
 const apply = mountOnce("@linxin666/dsh-ssh", applyImpl);
 function applyImpl(ctx, config) {
 	let current = () => config ?? {};
+	let isSettingsBound = false;
+	const store = new HostStore();
+	const engine = new SshEngine(store);
+	ctx.effect(() => () => {
+		engine.dispose();
+	}, "dsh-ssh: engine");
 	const resolve = () => {
 		const value = current();
+		let enabled = value.enabled ?? true;
+		if (enabled === false && !isSettingsBound && store.list().length > 0) enabled = true;
 		return {
 			announceToAgent: value.announceToAgent ?? DEFAULT_ANNOUNCE,
-			enabled: value.enabled ?? true
+			enabled
 		};
 	};
-	const store = new HostStore();
-	const engine = new SshEngine(store);
-	ctx.effect(() => () => {
-		engine.dispose();
-	}, "dsh-ssh: engine");
 	const { routes, upgrade } = makeRoutes({
 		store,
 		engine
@@ -3642,12 +3644,15 @@ function applyImpl(ctx, config) {
 			};
 		}, "dsh-ssh: tools");
 	};
-	installSettingsSection(ctx, SSH_SETTINGS_NAMESPACE, Config, config ?? {}, {
-		setSource: (source) => {
-			current = source;
-			sync();
-		},
-		onChange: sync
+	ctx.inject(["settings"], (settingsCtx) => {
+		settingsCtx.settings.installSection(ctx, SSH_SETTINGS_NAMESPACE, Config, config ?? {}, {
+			setSource: (source) => {
+				isSettingsBound = true;
+				current = source;
+				sync();
+			},
+			onChange: sync
+		});
 	});
 	sync();
 }

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

@@ -10,7 +10,8 @@
  * Export discipline (packages/client rule): the /client surface carries what
  * cordis loading needs plus types only — all value exports stay internal.
  */
-import type { ClientContext, SettingsScope, SettingsScopeSpec } from '@deepseek-ai/dsh-client-runtime/client';
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+import type { SettingsScope, SettingsScopeSpec } from '@deepseek-ai/dsh-client-ui-settings/client';
 import { type SshKey } from './locales.ts';
 declare module '@deepseek-ai/cordis' {
     interface Context {

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

@@ -146,6 +146,7 @@ export declare const zh: {
     readonly 'common.error': "出错：{error}";
     readonly 'common.refresh': "刷新";
     readonly 'common.confirm': "确定";
+    readonly 'error.disabled': "SSH 插件在宿主端未启用。请前往「设置 → Web 插件 → SSH」打开 enabled 开关。";
 };
 export declare const en: Record<keyof typeof zh, string>;
 /** Locale key union. */

package/lib/types/client/mount.d.ts

@@ -1,6 +1,7 @@
 import type { SshApi } from './api.ts';
 import type { PanelController } from './panel/controller.ts';
 import type { TerminalFontSource } from './panel/helpers.ts';
+import type { LocaleRefreshSource } from './sidebar-entry.ts';
 /** The injected panel container (kept in the DOM, hidden when inactive). */
 export declare const PANEL_VIEW_SELECTOR = "[data-dsh-ssh-view]";
 /**
@@ -9,6 +10,8 @@ export declare const PANEL_VIEW_SELECTOR = "[data-dsh-ssh-view]";
  * @param controller - the panel controller driving the view.
  * @param api - the SSH API client the tabs operate through.
  * @param terminalFont - live terminal-font setting source (issue #577).
+ * @param locale - locale-change source; when given, re-renders an open panel
+ *   on a Language switch.
  * @returns disposer unmounting the tree and restoring the column.
  */
-export declare function mountPanel(controller: PanelController, api: SshApi, terminalFont?: TerminalFontSource): () => void;
+export declare function mountPanel(controller: PanelController, api: SshApi, terminalFont?: TerminalFontSource, locale?: LocaleRefreshSource): () => void;

package/lib/types/client/panel/helpers.d.ts

@@ -8,6 +8,8 @@ import { type SshKey } from '../locales.ts';
 export type TranslateValues = Record<string, string | number>;
 /** Active dictionary, picked by the document language at call time. */
 export declare function dictionary(): Record<string, string>;
+/** Wire the SDK translate seat; pass undefined to restore the document-language pick. */
+export declare function setRuntimeTranslate(t: ((key: SshKey, values?: TranslateValues) => string) | undefined): void;
 /** Translate a key with optional {name} template params (current language). */
 export declare function tt(key: SshKey, values?: TranslateValues): string;
 /** Human-readable error text from an unknown thrown value. */

package/lib/types/client/sidebar-entry-core.d.ts

@@ -34,6 +34,16 @@ export interface SidebarEntryOptions {
     label(): string;
     /** Optional localized tooltip (title attribute). */
     tooltip?(): string;
+    /**
+     * Optional locale-change subscription: re-applies label / aria-label /
+     * tooltip whenever the active locale changes. Plain-DOM rows would
+     * otherwise keep the label captured at mount; pass the SDK locale runtime
+     * subscription (ctx.locale.subscribe) so the row follows the language
+     * switch without a reload.
+     */
+    refresh?: {
+        subscribe(listener: () => void): () => void;
+    };
     /** Click action (open/toggle the owning panel). */
     onToggle(): void;
     /** Family-block position: 'before' inserts ahead of sibling plugin rows, 'after' behind them. */

package/lib/types/client/sidebar-entry.d.ts

@@ -11,10 +11,16 @@
 import type { PanelController } from './panel/controller.ts';
 /** Stable data attribute identifying the injected entry row. */
 export declare const ENTRY_SELECTOR = "[data-dsh-ssh-entry]";
+/** Locale-change subscription the shared core asks for (ctx.locale.subscribe shape). */
+export interface LocaleRefreshSource {
+    subscribe(listener: () => void): () => void;
+}
 /**
  * Mount the sidebar entry, waiting for the shell to render and self-healing
  * on later React re-renders.
  * @param controller - the panel controller the entry toggles.
+ * @param locale - locale-change source; when given, re-applies the label on
+ *   a Language switch (the plain-DOM row otherwise keeps the mount-time copy).
  * @returns disposer removing the entry and its observers.
  */
-export declare function mountSidebarEntry(controller: PanelController): () => void;
+export declare function mountSidebarEntry(controller: PanelController, locale?: LocaleRefreshSource): () => void;

package/lib/types/index.d.ts

@@ -8,6 +8,7 @@
  * no dsh source changes.
  */
 import type { Context } from '@deepseek-ai/cordis';
+import type { SettingsNamespace } from '@deepseek-ai/dsh-settings';
 import z from 'schemastery';
 /** Stable cordis plugin name. */
 export declare const name = "ssh";
@@ -18,7 +19,7 @@ export declare const inject: string[];
  * surface edits. Spelled here rather than imported: the browser half spells
  * the same value and must not depend on a Host package.
  */
-export declare const SSH_SETTINGS_NAMESPACE: import("@deepseek-ai/dsh-settings").SettingsNamespace;
+export declare const SSH_SETTINGS_NAMESPACE: SettingsNamespace;
 /** Plugin config, validated by the same-named schemastery schema. */
 export interface Config {
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@linxin666/dsh-ssh",
   "description": "Remote SSH operations for the dsh web GUI: host config store (~/.dsh/dsh-ssh.json, import from ~/.ssh/config), a persistent ssh2 connection pool with jump-host support, exec / PTY web terminal / SFTP transfer / local port-forward tunnels / cluster execution, plus agent tools (ssh_list, ssh_exec, ssh_upload, ssh_download, ssh_tunnel, ssh_cluster). Hot-pluggable — mounted via ~/.dsh/cordis.patch.yml + a profile node_modules symlink, no dsh source changes.",
-  "version": "0.3.6",
+  "version": "0.3.10",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
@@ -26,15 +26,15 @@
   },
   "dsh": {
     "engines": {
-      "dsh": ">=0.1.1-rc.1"
+      "dsh": ">=0.1.2-alpha.1"
     },
     "bundle": {
       "patch": "./cordis.patch.yml"
     },
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-renderer",
         "@deepseek-ai/dsh-client-ui-settings"
       ],
       "platform": "web"
@@ -51,19 +51,19 @@
     "react-dom": "^18.2.0"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-connection": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-scope": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-timeout": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-client-connection": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-scope": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-timeout": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-tools": "^0.1.2-alpha.2",
     "@types/node": "^22.20.0",
     "@types/react": "~18.3.1",
     "@types/react-dom": "^18.3.5",

package/src/client/api.ts

@@ -18,6 +18,7 @@ import {
   type TransferStreamLine,
   type TunnelInfo,
 } from '../protocol.ts'
+import { tt } from './panel/helpers.ts'
 
 /** Minimal File System Access API surface (not in all lib.dom versions). */
 interface WindowWithFileSystemAccess {
@@ -51,12 +52,15 @@ async function readJson<T>(response: Response): Promise<T> {
   try {
     body = await response.json()
   } catch {
+    if (response.status === 404) {
+      throw new SshApiError(tt('error.disabled'))
+    }
     throw new SshApiError(`HTTP ${response.status}: invalid JSON response`)
   }
   if (!response.ok) {
     const message = typeof body === 'object' && body !== null && typeof (body as { error?: unknown }).error === 'string'
       ? (body as { error: string }).error
-      : `HTTP ${response.status}`
+      : (response.status === 404 ? tt('error.disabled') : `HTTP ${response.status}`)
     throw new SshApiError(message)
   }
   return body as T

package/src/client/index.ts

@@ -10,11 +10,14 @@
  * Export discipline (packages/client rule): the /client surface carries what
  * cordis loading needs plus types only — all value exports stay internal.
  */
-import type { ClientContext, SettingsScope, SettingsScopeSpec } from '@deepseek-ai/dsh-client-runtime/client'
+import type { Context as ClientContext } from '@deepseek-ai/cordis'
+import type { SettingsScope, SettingsScopeSpec } from '@deepseek-ai/dsh-client-ui-settings/client'
 // Type-only: pulls the locale plugin's Context merge (ctx.locale).
 import type {} from '@deepseek-ai/dsh-client-locale/client'
 // Type-only: pulls the settings-surface Context merge (ctx.settingsScope).
 import type {} from '@deepseek-ai/dsh-client-ui-settings/client'
+// Type-only: pulls the ctx.slots merge (the renderer owns the slot registry since 0.1.2).
+import type {} from '@deepseek-ai/dsh-client-ui-renderer/client'
 // Type-only: pulls the LocaleNamespaceMap merge table.
 import type {} from '@deepseek-ai/dsh-client-ui-slots'
 import { SshApi } from './api.ts'
@@ -22,6 +25,7 @@ import { en, zh, type SshKey } from './locales.ts'
 import { mountPanel } from './mount.tsx'
 import { PanelController } from './panel/controller.ts'
 import type { TerminalFontSource } from './panel/helpers.ts'
+import { setRuntimeTranslate } from './panel/helpers.ts'
 import { mountSidebarEntry } from './sidebar-entry.ts'
 import { reportDailyHeartbeat } from './telemetry.ts'
 
@@ -86,6 +90,11 @@ export function apply(ctx: ClientContext): void {
     }
   }, 'dsh-ssh: dictionaries')
 
+  // Wire the SDK translate seat into the module-level tt (sidebar row and
+  // other plain-DOM callers): reads the active locale at call time, so they
+  // follow the Language setting without a reload.
+  try { setRuntimeTranslate(ctx.locale.bind(NS)) } catch { /* locale missing: document-language fallback stays */ }
+
   const controller = new PanelController()
   const api = new SshApi()
   // Live terminal-font preference (issue #577): the settings namespace is
@@ -102,8 +111,8 @@ export function apply(ctx: ClientContext): void {
   }
   const disposers: Array<() => void> = []
   try {
-    disposers.push(mountSidebarEntry(controller))
-    disposers.push(mountPanel(controller, api, terminalFont))
+    disposers.push(mountSidebarEntry(controller, ctx.locale))
+    disposers.push(mountPanel(controller, api, terminalFont, ctx.locale))
   } catch (error) {
     // DOM failures degrade the panel, never the GUI.
     console.warn('[dsh-ssh] mount failed:', error)

package/src/client/locales.ts

@@ -154,6 +154,7 @@ export const zh = {
   'common.error': '出错：{error}',
   'common.refresh': '刷新',
   'common.confirm': '确定',
+  'error.disabled': 'SSH 插件在宿主端未启用。请前往「设置 → Web 插件 → SSH」打开 enabled 开关。',
 } as const
 
 export const en: Record<keyof typeof zh, string> = {
@@ -301,6 +302,7 @@ export const en: Record<keyof typeof zh, string> = {
   'common.error': 'Error: {error}',
   'common.refresh': 'Refresh',
   'common.confirm': 'Confirm',
+  'error.disabled': 'The SSH plugin is disabled on the host. Please enable it in Settings → Web Plugins → SSH.',
 }
 
 /** Locale key union. */

package/src/client/mount.tsx

@@ -16,6 +16,7 @@ import type { SshApi } from './api.ts'
 import type { PanelController } from './panel/controller.ts'
 import type { TerminalFontSource } from './panel/helpers.ts'
 import { SshPanel } from './panel/SshPanel.tsx'
+import type { LocaleRefreshSource } from './sidebar-entry.ts'
 import css from './panel/panel.module.css'
 
 /** The injected panel container (kept in the DOM, hidden when inactive). */
@@ -40,11 +41,19 @@ function conversationColumn(): HTMLElement | undefined {
  * @param controller - the panel controller driving the view.
  * @param api - the SSH API client the tabs operate through.
  * @param terminalFont - live terminal-font setting source (issue #577).
+ * @param locale - locale-change source; when given, re-renders an open panel
+ *   on a Language switch.
  * @returns disposer unmounting the tree and restoring the column.
  */
-export function mountPanel(controller: PanelController, api: SshApi, terminalFont?: TerminalFontSource): () => void {
+export function mountPanel(controller: PanelController, api: SshApi, terminalFont?: TerminalFontSource, locale?: LocaleRefreshSource): () => void {
   let root: Root | undefined
   let container: HTMLDivElement | undefined
+  let unsubscribeLocale: (() => void) | undefined
+  try {
+    unsubscribeLocale = locale?.subscribe(() => {
+      if (root !== undefined) root.render(<SshPanel controller={controller} api={api} terminalFont={terminalFont} />)
+    })
+  } catch { /* locale service absent: the panel follows its next natural re-render */ }
 
   const ensure = (): void => {
     if (container !== undefined) {
@@ -110,6 +119,7 @@ export function mountPanel(controller: PanelController, api: SshApi, terminalFon
     document.removeEventListener(ACTIVATE_EVENT, onOtherActivate)
     waitObserver.disconnect()
     unsubscribe()
+    unsubscribeLocale?.()
     document.documentElement.removeAttribute(ACTIVE_ATTR)
     root?.unmount()
     root = undefined

package/src/client/panel/helpers.ts

@@ -14,8 +14,22 @@ export function dictionary(): Record<string, string> {
   return lang.toLowerCase().startsWith('en') ? { ...en } : { ...zh }
 }
 
+/**
+ * SDK translate seat wired by the browser apply() once ctx.locale is bound
+ * (setRuntimeTranslate): reads the ACTIVE locale at call time, so plain-DOM
+ * surfaces follow a runtime language switch. The document-language pick stays
+ * as the unwired fallback (locale service absent, module-scope early callers).
+ */
+let runtimeT: ((key: SshKey, values?: TranslateValues) => string) | undefined
+
+/** Wire the SDK translate seat; pass undefined to restore the document-language pick. */
+export function setRuntimeTranslate(t: ((key: SshKey, values?: TranslateValues) => string) | undefined): void {
+  runtimeT = t
+}
+
 /** Translate a key with optional {name} template params (current language). */
 export function tt(key: SshKey, values?: TranslateValues): string {
+  if (runtimeT !== undefined) return runtimeT(key, values)
   return t(dictionary(), key, values)
 }
 

package/src/client/sidebar-entry-core.ts

@@ -36,6 +36,14 @@ export interface SidebarEntryOptions {
   label(): string
   /** Optional localized tooltip (title attribute). */
   tooltip?(): string
+  /**
+   * Optional locale-change subscription: re-applies label / aria-label /
+   * tooltip whenever the active locale changes. Plain-DOM rows would
+   * otherwise keep the label captured at mount; pass the SDK locale runtime
+   * subscription (ctx.locale.subscribe) so the row follows the language
+   * switch without a reload.
+   */
+  refresh?: { subscribe(listener: () => void): () => void }
   /** Click action (open/toggle the owning panel). */
   onToggle(): void
   /** Family-block position: 'before' inserts ahead of sibling plugin rows, 'after' behind them. */
@@ -76,7 +84,7 @@ function newSessionButton(root: HTMLElement): HTMLButtonElement | undefined {
 }
 
 /** Build the entry row (a detached button; insert once the shell is up). */
-function createEntry(options: SidebarEntryOptions): HTMLButtonElement {
+function createEntry(options: SidebarEntryOptions): { entry: HTMLButtonElement; applyLabel: () => void } {
   const entry = document.createElement('button')
   entry.type = 'button'
   entry.setAttribute(options.rowAttribute, '')
@@ -85,12 +93,20 @@ function createEntry(options: SidebarEntryOptions): HTMLButtonElement {
     entry.setAttribute('data-dsh-part', 'sidebar-entry')
   }
   entry.className = options.css['entry'] ?? ''
-  entry.setAttribute('aria-label', options.label())
-  if (options.tooltip !== undefined) entry.setAttribute('title', options.tooltip())
-  entry.innerHTML = '<span class="' + (options.css['entryIcon'] ?? '') + '">' + options.icon
-    + '</span><span class="' + (options.css['entryLabel'] ?? '') + '">' + options.label() + '</span>'
+  const labelSpan = document.createElement('span')
+  labelSpan.className = options.css['entryLabel'] ?? ''
+  const iconSpan = document.createElement('span')
+  iconSpan.className = options.css['entryIcon'] ?? ''
+  iconSpan.innerHTML = options.icon
+  entry.append(iconSpan, labelSpan)
+  const applyLabel = (): void => {
+    entry.setAttribute('aria-label', options.label())
+    if (options.tooltip !== undefined) entry.setAttribute('title', options.tooltip())
+    labelSpan.textContent = options.label()
+  }
+  applyLabel()
   entry.addEventListener('click', options.onToggle)
-  return entry
+  return { entry, applyLabel }
 }
 
 /** Re-insert the entry after the New Session row (before the browser region). */
@@ -132,9 +148,18 @@ export function mountSidebarEntry(options: SidebarEntryOptions): () => void {
   if (typeof document !== 'undefined' && document.querySelector(options.rowSelector) !== null) {
     return () => {}
   }
-  const entry = createEntry(options)
+  const { entry, applyLabel } = createEntry(options)
   let root: HTMLElement | undefined
   let placed = false
+  let unsubscribeRefresh: (() => void) | undefined
+  if (options.refresh !== undefined) {
+    try {
+      unsubscribeRefresh = options.refresh.subscribe(applyLabel)
+    } catch {
+      // A throwing subscription must not break the mount; the label stays at
+      // its initial value and the next reload resolves it again.
+    }
+  }
 
   const tryPlace = (): void => {
     if (root !== undefined && !root.isConnected) {
@@ -202,6 +227,7 @@ export function mountSidebarEntry(options: SidebarEntryOptions): () => void {
   return () => {
     waitObserver.disconnect()
     rootObserver.disconnect()
+    unsubscribeRefresh?.()
     unsubscribeActive?.()
     entry.remove()
   }

package/src/client/sidebar-entry.ts

@@ -19,13 +19,18 @@ export const ENTRY_SELECTOR = '[data-dsh-ssh-entry]'
 /** Inline terminal glyph sized to the shell's current sidebar navigation icons. */
 const ICON = '<svg viewBox="0 0 16 16" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="1.75" y="2.25" width="12.5" height="11.5" rx="1.75"/><path d="M4.25 5.25l2.75 2.75-2.75 2.75"/><path d="M8.5 10.75h3.25"/></svg>'
 
+/** Locale-change subscription the shared core asks for (ctx.locale.subscribe shape). */
+export interface LocaleRefreshSource { subscribe(listener: () => void): () => void }
+
 /**
  * Mount the sidebar entry, waiting for the shell to render and self-healing
  * on later React re-renders.
  * @param controller - the panel controller the entry toggles.
+ * @param locale - locale-change source; when given, re-applies the label on
+ *   a Language switch (the plain-DOM row otherwise keeps the mount-time copy).
  * @returns disposer removing the entry and its observers.
  */
-export function mountSidebarEntry(controller: PanelController): () => void {
+export function mountSidebarEntry(controller: PanelController, locale?: LocaleRefreshSource): () => void {
   return mountSharedSidebarEntry({
     rowAttribute: 'data-dsh-ssh-entry',
     rowSelector: ENTRY_SELECTOR,
@@ -34,6 +39,7 @@ export function mountSidebarEntry(controller: PanelController): () => void {
     css,
     label: () => tt('entry.label'),
     tooltip: () => tt('entry.tooltip'),
+    refresh: locale === undefined ? undefined : { subscribe: (listener) => locale.subscribe(listener) },
     onToggle: () => { controller.toggle() },
     position: 'after',
     familySelectors: ['[data-dsh-taskboard-entry]', '[data-dsh-ssh-entry]'],

package/src/dsh-home.ts

@@ -39,4 +39,4 @@ export function resolveDshHome(env: NodeJS.ProcessEnv = process.env, home: strin
 /** Resolve the DSH home directory from the live environment. */
 export function dshHome(): string {
   return resolveDshHome()
-}
+}

package/src/index.ts

@@ -9,7 +9,7 @@
  */
 
 import type { Context } from '@deepseek-ai/cordis'
-import { installSettingsSection, settingsNamespace } from '@deepseek-ai/dsh-settings'
+import type { SettingsNamespace } from '@deepseek-ai/dsh-settings'
 import z from 'schemastery'
 import type {} from '@deepseek-ai/dsh-host-webserver'
 import type {} from '@deepseek-ai/dsh-system-prompt'
@@ -31,7 +31,7 @@ export const inject = ['webServer', 'tools', 'systemPrompt']
  * surface edits. Spelled here rather than imported: the browser half spells
  * the same value and must not depend on a Host package.
  */
-export const SSH_SETTINGS_NAMESPACE = settingsNamespace('dsh-ssh')
+export const SSH_SETTINGS_NAMESPACE = 'dsh-ssh' as SettingsNamespace
 
 /** Plugin config, validated by the same-named schemastery schema. */
 export interface Config {
@@ -77,18 +77,28 @@ function applyImpl(ctx: Context, config?: Config): void {
   // The live source the surfaces read: the settings section once the web
   // settings surface is served, the composition entry otherwise.
   let current: () => Config = () => config ?? {}
+  let isSettingsBound = false
+
+  const store = new HostStore()
+  const engine = new SshEngine(store)
+  ctx.effect(() => () => { engine.dispose() }, 'dsh-ssh: engine')
+
   const resolve = (): Config => {
     const value = current()
+    let enabled = value.enabled ?? true
+    // When dsh-ssh was seeded with enabled: false (e.g. from an aggregate profile line),
+    // but the user has never explicitly configured settings (not bound yet)
+    // AND already has active host records in dsh-ssh.json, keep the plugin enabled so
+    // existing users are not broken upon upgrade (#1250).
+    if (enabled === false && !isSettingsBound && store.list().length > 0) {
+      enabled = true
+    }
     return {
       announceToAgent: value.announceToAgent ?? DEFAULT_ANNOUNCE,
-      enabled: value.enabled ?? true,
+      enabled,
     }
   }
 
-  const store = new HostStore()
-  const engine = new SshEngine(store)
-  ctx.effect(() => () => { engine.dispose() }, 'dsh-ssh: engine')
-
   // The /api/dsh-ssh route family + terminal upgrade.
   const { routes, upgrade } = makeRoutes({ store, engine })
   let disposeRoutes: (() => void) | undefined
@@ -152,15 +162,18 @@ function applyImpl(ctx: Context, config?: Config): void {
     )
   }
 
-  installSettingsSection(ctx, SSH_SETTINGS_NAMESPACE, Config, config ?? {}, {
-    setSource: (source) => {
-      current = source
-      sync()
-    },
-    onChange: sync,
+  ctx.inject(['settings'], (settingsCtx) => {
+    settingsCtx.settings.installSection(ctx, SSH_SETTINGS_NAMESPACE, Config, config ?? {}, {
+      setSource: (source) => {
+        isSettingsBound = true
+        current = source
+        sync()
+      },
+      onChange: sync,
+    })
   })
 
   // Initial registration from the composition entry (covers deployments with
-  // no settings service, whose installSettingsSection never fires its hooks).
+  // no settings service, whose installSection never fires its hooks).
   sync()
 }