dsh-ssh-manage 0.3.7 → 0.3.9

package/README.en.md

@@ -23,6 +23,7 @@
 `dsh-ssh-manage` is a Web plugin for [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness). It turns the hosts in `~/.ssh/config` into manageable objects in the DSH sidebar:
 
 - **Host management** — scan the config, groups, tags, favorites, notes, latency and host inspection; SSH aliases are globally unique, so use the repeatable Display name for same names across groups;
+- **DSH Agent integration** — a compact host catalog (alias/group/display name) is injected into the DSH system prompt to keep token use low; full details come from list_hosts on demand, and the Agent uses `ssh_manager` directly for exec, batch commands, inspection and SFTP;
 - **Interactive terminal** — ssh2 allocates a PTY, xterm.js renders it, with colors, arrow keys, full-screen programs such as `vim`/`top`, and window resizing;
 - **Backup and migration** — export/import hosts, groups, tags, notes, favorites and passwords from Settings; exports are re-encrypted with a passphrase (scrypt + AES-256-GCM) and imports merge by alias;
 - **Day-to-day operations** — batch commands, SFTP browse/mkdir/rename/delete/upload/download, connection tests;
@@ -97,16 +98,16 @@ Creating a host requires alias, hostname and password. The password is not writt
 
 ### From npm (recommended)
 
-npm package: [`dsh-ssh-manage`](https://www.npmjs.com/package/dsh-ssh-manage) (current version `0.3.7`).
+npm package: [`dsh-ssh-manage`](https://www.npmjs.com/package/dsh-ssh-manage) (current version `0.3.9`).
 
 ```text
-plugin_manager action=install_bundle target=dsh-ssh-manage@0.3.7
+plugin_manager action=install_bundle target=dsh-ssh-manage@0.3.9
 ```
 
 Or with the DSH CLI:
 
 ```bash
-dsh plugin add dsh-ssh-manage@0.3.7
+dsh plugin add dsh-ssh-manage@0.3.9
 ```
 
 After installation, refresh the Web page; the sidebar shows an "SSH Hosts" entry with id `dsh-ssh-manage`.

package/README.md

@@ -23,6 +23,7 @@
 `dsh-ssh-manage` 是 [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) 的 Web 插件。它把 `~/.ssh/config` 里的主机变成 DSH 侧边栏里可管理、可连接、可运维的对象：
 
 - **主机管理**：扫描配置、分组、标签、收藏、备注、连接延迟、主机巡检；SSH 别名全局唯一，不同分组如需同名请使用可重复的“显示名称”；
+- **DSH Agent 集成**：向 DSH 系统提示注入精简主机目录（别名/分组/显示名），地址等详情由 `list_hosts` 按需获取以控制 token；Agent 可直接用 `ssh_manager` 执行命令、批量命令、巡检和 SFTP 操作；
 - **交互式终端**：ssh2 分配 PTY，xterm.js 渲染，支持彩色输出、方向键、`vim`/`top` 等全屏程序和窗口自适应；
 - **备份迁移**：设置页可导出/导入主机、分组、标签、备注、收藏和密码；导出文件用自定义口令二次加密（scrypt + AES-256-GCM），导入按别名合并；
 - **日常运维**：批量命令、SFTP 目录浏览 / 新建 / 重命名 / 删除 / 上传 / 下载、测试连接；
@@ -99,16 +100,16 @@
 
 ### 从 npm 安装（推荐）
 
-npm 包：[`dsh-ssh-manage`](https://www.npmjs.com/package/dsh-ssh-manage)（当前版本 `0.3.7`）。
+npm 包：[`dsh-ssh-manage`](https://www.npmjs.com/package/dsh-ssh-manage)（当前版本 `0.3.9`）。
 
 ```text
-plugin_manager action=install_bundle target=dsh-ssh-manage@0.3.7
+plugin_manager action=install_bundle target=dsh-ssh-manage@0.3.9
 ```
 
 或使用 DSH CLI：
 
 ```bash
-dsh plugin add dsh-ssh-manage@0.3.7
+dsh plugin add dsh-ssh-manage@0.3.9
 ```
 
 安装后刷新 Web 页面，左侧栏会出现「SSH 主机」入口，入口 id 为 `dsh-ssh-manage`。

package/index.js

@@ -78,6 +78,43 @@ function errorMessage(error) {
   return error instanceof Error ? error.message : String(error)
 }
 
+let sshHostCatalogText = ''
+let sshHostCatalogRefresh = null
+
+function sshCatalogLine(host, metadata) {
+  const group = String(metadata?.group || '').replace(/[\r\n]+/g, ' ').trim()
+  const label = String(metadata?.label || '').replace(/[\r\n"']+/g, ' ').trim()
+  let line = `- ${host.host}`
+  if (group) line += ` [${group}]`
+  if (label && label !== host.host) line += ` "${label.slice(0, 60)}"`
+  return line
+}
+
+/** Refresh the host catalog injected into the DSH system prompt. */
+export async function refreshSshHostCatalog(paths) {
+  if (sshHostCatalogRefresh) return sshHostCatalogRefresh
+  sshHostCatalogRefresh = (async () => {
+    try {
+      const [{ hosts }, metadata] = await Promise.all([
+        listSshHosts(paths),
+        loadMetadata(paths).catch(() => ({ entries: {} })),
+      ])
+      const lines = hosts.slice(0, 40).map((host) => sshCatalogLine(host, metadata.entries[host.host]))
+      if (hosts.length > 40) lines.push(`- ... ${hosts.length - 40} more; call list_hosts`)
+      sshHostCatalogText = [
+        'SSH hosts available through the dsh-ssh-manage ssh_manager tool. When the user asks to inspect, run commands on, upload to or download from one of these servers, call ssh_manager with the exact alias.',
+        'Call action=list_hosts for user/address/port/group/password status. Use exec {host, command}, batch_exec {hosts, command}, inspect_host/test_connection and sftp_* for operations. Passwords are never returned.',
+        lines.length ? lines.join('\n') : '- No hosts configured yet; add them in the dsh-ssh-manage sidebar panel.',
+      ].join('\n').slice(0, 3000)
+    } catch {
+      sshHostCatalogText = 'SSH host catalog is temporarily unavailable; call ssh_manager action=list_hosts to read it.'
+    } finally {
+      sshHostCatalogRefresh = null
+    }
+  })()
+  return sshHostCatalogRefresh
+}
+
 async function state(paths) {
   const [current, metadataResult, passwordsResult] = await Promise.all([
     listSshHosts(paths),
@@ -93,6 +130,7 @@ async function state(paths) {
   else passwords = passwordsResult.value
   const passwordSet = new Set(passwords)
   const stateDir = storagePaths(paths).stateDir
+  void refreshSshHostCatalog(paths)
   return {
     ...current,
     stateDir,
@@ -253,7 +291,7 @@ export async function runAction(paths, action, params = {}) {
 function managerTool(paths) {
   return {
     name: 'ssh_manager',
-    description: 'Manage SSH hosts, encrypted local passwords, remote commands and SFTP operations. Passwords are never returned.',
+    description: 'Manage SSH hosts, encrypted local passwords, remote commands and SFTP operations. Hosts entered in the dsh-ssh-manage panel are listed in the system prompt; when the user asks to operate on a server, call this tool directly with its alias. Use action=exec for one command, batch_exec for several hosts, sftp_* for files. Passwords are never returned.',
     parameters: {
       type: 'object',
       additionalProperties: false,
@@ -262,7 +300,7 @@ function managerTool(paths) {
         action: { type: 'string', enum: ACTIONS, description: 'The operation to run.' },
         host: {
           oneOf: [{ type: 'string' }, { type: 'object' }],
-          description: 'Host alias as a string for every action except save_host, which takes a host object: { host, hostname, user, port, identityFile, proxyJump, forwardAgent }.',
+          description: 'Host alias as a string (see the SSH host catalog in the system prompt) for every action except save_host, which takes a host object: { host, hostname, user, port, identityFile, proxyJump, forwardAgent }.',
         },
         originalHost: { type: 'string', description: 'Existing alias when renaming a host.' },
         password: { type: 'string', description: 'Password to save for a host. It is write-only.' },
@@ -830,7 +868,7 @@ function registerAssetRoutes(ctx) {
   }
 }
 
-export const __test = { resolveSshPaths, listSshHosts, saveSshHost, deleteSshHost, runAction, managerTool, MAX_BODY_BYTES, PTY_ROUTE, PTY_EVENTS_ROUTE, PTY_OPEN_ROUTE, PTY_ATTACH_ROUTE, PTY_INPUT_ROUTE, PTY_RESIZE_ROUTE, PTY_CLOSE_ROUTE, PTY_CLEAR_ROUTE, PTY_TOUCH_ROUTE, PTY_IDLE_MS, sweepIdlePtySessions, MAX_PTY_SESSIONS, PTY_BUFFER_BYTES, ASSETS, handlePtyUpgrade, ptyTextSessions }
+export const __test = { resolveSshPaths, listSshHosts, saveSshHost, deleteSshHost, runAction, managerTool, refreshSshHostCatalog, getSshHostCatalog: () => sshHostCatalogText, MAX_BODY_BYTES, PTY_ROUTE, PTY_EVENTS_ROUTE, PTY_OPEN_ROUTE, PTY_ATTACH_ROUTE, PTY_INPUT_ROUTE, PTY_RESIZE_ROUTE, PTY_CLOSE_ROUTE, PTY_CLEAR_ROUTE, PTY_TOUCH_ROUTE, PTY_IDLE_MS, sweepIdlePtySessions, MAX_PTY_SESSIONS, PTY_BUFFER_BYTES, ASSETS, handlePtyUpgrade, ptyTextSessions }
 
 export const inject = ['webServer']
 
@@ -839,7 +877,12 @@ export function apply(ctx) {
     throw new Error('dsh-ssh-manage requires DeepSeek Harness >=0.2.1-rc.3: ctx.webServer.register is unavailable.')
   }
   const paths = resolveSshPaths(process.env)
+  void refreshSshHostCatalog(paths)
   const runtime = createPtyRuntime()
+  const catalogTimer = setInterval(() => {
+    if (runtime.active) void refreshSshHostCatalog(paths)
+  }, 30_000)
+  catalogTimer.unref?.()
   const runtimeIdleTimer = setInterval(() => {
     if (!runtime.active) return
     // Browser heartbeats (/pty/touch) keep attached sessions alive, so a session
@@ -934,6 +977,7 @@ export function apply(ctx) {
       }
       runtime.upgrades.clear()
       clearInterval(runtimeIdleTimer)
+      clearInterval(catalogTimer)
       for (const session of ptySessions) {
         try { session.close() } catch {}
       }
@@ -950,4 +994,15 @@ export function apply(ctx) {
   ctx.inject(['tools'], (child) => {
     child.effect(() => child.tools.register(managerTool(paths)), 'dsh-ssh-manage: agent tool')
   })
+  ctx.inject(['systemPrompt'], (child) => {
+    if (!child.systemPrompt || typeof child.systemPrompt.context !== 'function') return
+    child.effect(
+      () => child.systemPrompt.context({
+        name: 'dsh-ssh-manage-hosts',
+        order: 60,
+        text: () => sshHostCatalogText,
+      }),
+      'dsh-ssh-manage: host catalog prompt context',
+    )
+  })
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ssh-manage",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "A DSH sidebar plugin for managing SSH host profiles with a real interactive PTY terminal.",
   "license": "MIT",
   "private": false,