pi-ssh-remote 0.1.4 → 0.1.5

package/README.md

@@ -31,7 +31,7 @@ The extension exposes `ssh_remote_control` for the agent and `/remote` for the u
 
 ### Stateful endpoints instead of disposable SSH commands
 
-Each `user@host:port` endpoint remembers its remote working directory, note, and port-forward configuration locally. Notes such as `H100 training`, `staging`, or `customer demo` appear in configuration, status messages, and Pi's footer, so the active execution environment stays visible.
+Each `user@host:port` endpoint remembers its remote working directory, note, server-specific memory, and port-forward configuration locally. Notes such as `H100 training`, `staging`, or `customer demo` appear in configuration, status messages, and Pi's footer, so the active execution environment stays visible. Server memory is automatically injected into the model context whenever that endpoint is connected as the active remote workspace.
 
 ### Resilient and bounded by default
 
@@ -66,6 +66,7 @@ Requires Node.js 20+. The remote server must provide Bash, SFTP, and GNU `timeou
 /remote ssh root@gpu-box.example.com -p 2202
 /remote cd /srv/project
 /remote config note H100 training server
+/remote config memory Use /opt/conda/bin/python and never stop shared jobs.
 /remote status
 ```
 
@@ -120,7 +121,7 @@ The default foreground timeout prevents an accidental long-running command from
 /remote
 ```
 
-Endpoint notes and working directories survive Pi restarts because they are stored in the local remote configuration.
+Endpoint notes, working directories, and server-specific memories survive Pi restarts because they are stored in the local remote configuration. When Pi connects to an endpoint, its memory is added to the system context on every agent run while remote tool routing remains active. Disconnecting or switching to tunnel-only mode removes it from subsequent model requests.
 
 ### 4. Expose a remote service while editing locally
 
@@ -165,6 +166,8 @@ These requests are handled through the agent-facing `ssh_remote_control` tool; s
 | `/remote use USER@HOST:PORT` | Select a saved endpoint |
 | `/remote config note TEXT` | Persist a note for the selected endpoint |
 | `/remote config note --clear` | Clear its note |
+| `/remote config memory TEXT` | Persist context that is injected while working on this endpoint |
+| `/remote config memory --clear` | Clear its server-specific memory |
 | `/remote config cwd PATH` | Persist its default remote working directory |
 | `/remote cd PATH` | Change the connected remote cwd and persist it |
 | `/remote config forward MAPPING...` | Persist port forwards such as `7860:127.0.0.1:7860` |
@@ -187,7 +190,7 @@ Endpoint configuration is stored locally in:
 ~/.pi/agent/ssh-remote-config.json
 ```
 
-Saved values include endpoints, active endpoint, notes, remote working directories, forwards, and preview settings. Passwords are **never written to this file**: SSH agent authentication is preferred, and prompted passwords remain only in process memory.
+Saved values include endpoints, active endpoint, notes, server-specific memories, remote working directories, forwards, and preview settings. Server memory is user-configured trusted context and is inserted into each model request only while that endpoint is the active remote workspace; it is not read from the remote server. Passwords are **never written to this file**: SSH agent authentication is preferred, and prompted passwords remain only in process memory.
 
 New or changed host keys require interactive confirmation and are stored separately from OpenSSH. Remote output sent to the model is limited to 2,000 lines or 50 KB; oversized complete output is written to a temporary local file. Preview-line settings affect only the collapsed UI.
 
@@ -195,4 +198,101 @@ New or changed host keys require interactive confirmation and are stored separat
 
 The extension currently supports direct SSH commands with `-p` and `-l`. It does not yet consume `~/.ssh/config`, `IdentityFile`, or ProxyJump settings.
 
+## Release history
+
+Release dates below are npm publication dates. Every release records user-visible additions, changes, and bug fixes; `None` means that category had no changes in that release.
+
+### 0.1.5 — 2026-08-04
+
+**Added**
+
+- Added persistent, endpoint-specific server memory through `/remote config memory TEXT` and the `ssh_remote_control` `memory` action.
+- Added automatic injection of that memory into every model request while the matching endpoint is the active remote workspace.
+
+**Changed**
+
+- Server memory is removed from subsequent model requests when remote tool routing is disabled, including disconnect and tunnel-only mode.
+- `/remote config` now shows the memory stored for each endpoint.
+
+**Fixed**
+
+- None.
+
+### 0.1.4 — 2026-07-31
+
+**Added**
+
+- Added persistent endpoint notes through `/remote config note TEXT` and the `ssh_remote_control` `note` action.
+- Added per-command timeout overrides through `/remote exec --timeout SECONDS` and the tool's `timeout` parameter.
+
+**Changed**
+
+- Remote commands now default to a 30-second timeout and endpoint notes appear in status, connection, reconnection, and footer labels.
+- Expanded the documentation around agent-first workflows, multi-server operation, background jobs, and tunnel mode.
+
+**Fixed**
+
+- Fixed remote commands that could run without a deadline by enforcing GNU `timeout` remotely and a local fallback timer.
+- Fixed timeout reporting for processes terminated with timeout-related exit codes 124 and 137.
+
+### 0.1.3 — 2026-07-24
+
+**Added**
+
+- Added configurable collapsed command previews with `/remote config display-lines N`, `/remote exec --lines N`, and the tool's `displayLines` parameter.
+- Added expandable custom rendering for remote command results.
+
+**Changed**
+
+- Remote command previews default to the last five visual lines while model-facing output remains limited to 2,000 lines or 50 KB.
+- Oversized complete output is saved to a permission-restricted local temporary file.
+
+**Fixed**
+
+- Fixed `/remote exec` truncating its notification to an arbitrary 4,000 characters without preserving or identifying the full output.
+
+### 0.1.2 — 2026-07-24
+
+**Added**
+
+- None.
+
+**Changed**
+
+- Republished the 0.1.1 runtime as 0.1.2 to align npm package version metadata; there were no runtime code changes.
+
+**Fixed**
+
+- None.
+
+### 0.1.1 — 2026-07-24
+
+**Added**
+
+- Added the shorter `/remote ssh USER@HOST [-p PORT]` connection command.
+
+**Changed**
+
+- `/remote ssh` now saves, selects, and immediately connects to the endpoint instead of only storing it.
+
+**Fixed**
+
+- Fixed help and error text that still instructed users to run the obsolete `/remote config ssh ssh ...` form.
+
+### 0.1.0 — 2026-07-24
+
+**Added**
+
+- Initial release with persistent multi-endpoint SSH workspaces and remote working directories.
+- Added transparent routing for Pi's `read`, `write`, `edit`, `bash`, and user shell operations.
+- Added SSH-agent/password authentication, interactive host-key verification, automatic reconnection, SFTP file access, bounded command output, and local TCP forwarding.
+
+**Changed**
+
+- None.
+
+**Fixed**
+
+- None.
+
 MIT licensed.

package/README.zh-CN.md

@@ -51,9 +51,10 @@ SSH remote H100 训练机 (root@gpu-box.example.com:2202):/srv/project
 - SSH 地址；
 - 默认工作目录；
 - 服务器备注；
+- 服务器特定记忆；
 - 端口转发配置。
 
-例如可以把几台机器分别备注为 `8xH100 训练机`、`预发布环境`、`线上只读机`。这些配置保存在本地，重启 Pi 后仍然存在。
+例如可以把几台机器分别备注为 `8xH100 训练机`、`预发布环境`、`线上只读机`。还可以为每个 `user@host:port` 保存独立记忆，例如指定 Python 环境、共享任务保护规则或部署约定。连接该 endpoint 并启用远端工具路由后，这段记忆会自动注入模型上下文；断开连接或切换到纯隧道模式后，后续请求不再注入。所有配置保存在本地，重启 Pi 后仍然存在。
 
 ### 断线后可以自动恢复
 
@@ -106,6 +107,7 @@ pi install npm:pi-ssh-remote
 ```text
 /remote cd /srv/project
 /remote config note H100 训练机
+/remote config memory 使用 /opt/conda/bin/python，不要停止其他用户的共享任务。
 ```
 
 查看当前状态：
@@ -218,6 +220,8 @@ Pi 会通过插件提供的 `ssh_remote_control` 工具完成这些操作。
 | `/remote use USER@HOST:PORT` | 切换到指定服务器 |
 | `/remote config note TEXT` | 给当前服务器添加或修改备注 |
 | `/remote config note --clear` | 清除当前服务器备注 |
+| `/remote config memory TEXT` | 保存连接该服务器时自动注入上下文的记忆 |
+| `/remote config memory --clear` | 清除当前服务器的特定记忆 |
 | `/remote config cwd PATH` | 设置默认远程工作目录 |
 | `/remote cd PATH` | 切换当前远程目录并保存 |
 | `/remote config forward MAPPING...` | 保存端口转发配置，例如 `7860:127.0.0.1:7860` |
@@ -245,10 +249,13 @@ Pi 会通过插件提供的 `ssh_remote_control` 工具完成这些操作。
 - 已保存的服务器；
 - 当前选中的服务器；
 - 服务器备注；
+- 服务器特定记忆；
 - 默认远程目录；
 - 端口转发配置；
 - 命令预览设置。
 
+服务器记忆是由用户在本地配置的可信上下文，不会从远程服务器自动读取；仅当对应 endpoint 作为远端工作区启用时才会加入每次模型请求。
+
 密码不会写入配置文件。插件会优先使用 SSH agent；如果需要手动输入密码，密码只会缓存在当前 Pi 进程的内存中。
 
 ## 安全与输出限制
@@ -264,4 +271,101 @@ Pi 会通过插件提供的 `ssh_remote_control` 工具完成这些操作。
 
 目前只支持 SSH 直连，以及 `-p`、`-l` 参数。暂不读取 `~/.ssh/config`，也不支持 `IdentityFile` 和 ProxyJump。
 
+## 版本更新记录
+
+以下日期均为 npm 发布时间。每次发布都记录用户可见的新增内容、行为变更和 Bug 修复；“无”表示该版本在对应类别没有变化。
+
+### 0.1.5 — 2026-08-04
+
+**新增**
+
+- 新增 endpoint 级持久化服务器记忆，支持 `/remote config memory TEXT` 和 `ssh_remote_control` 的 `memory` action。
+- 对应 endpoint 作为当前远程工作区时，在每次模型请求中自动注入服务器记忆。
+
+**变更**
+
+- 断开连接、关闭远端工具路由或进入纯隧道模式后，后续模型请求不再包含服务器记忆。
+- `/remote config` 现在会显示每个 endpoint 保存的记忆。
+
+**修复**
+
+- 无。
+
+### 0.1.4 — 2026-07-31
+
+**新增**
+
+- 新增 endpoint 备注，支持 `/remote config note TEXT` 和 `ssh_remote_control` 的 `note` action。
+- 新增单次命令超时覆盖，支持 `/remote exec --timeout SECONDS` 和工具的 `timeout` 参数。
+
+**变更**
+
+- 远程命令默认超时改为 30 秒；备注会显示在状态、连接、重连提示和底部状态栏中。
+- 扩充了 Agent 工作流、多服务器、后台任务和纯隧道模式文档。
+
+**修复**
+
+- 修复部分远程命令没有截止时间、可能一直占用 Agent 的问题：远端使用 GNU `timeout`，本地增加兜底定时器。
+- 修复退出码 124 和 137 未被统一识别为超时的问题。
+
+### 0.1.3 — 2026-07-24
+
+**新增**
+
+- 新增可配置的命令折叠预览，支持 `/remote config display-lines N`、`/remote exec --lines N` 和工具的 `displayLines` 参数。
+- 新增远程命令结果的展开显示。
+
+**变更**
+
+- 命令折叠预览默认显示最后 5 个视觉行；发送给模型的输出仍限制为 2,000 行或 50 KB。
+- 超限的完整输出会保存到权限受限的本地临时文件。
+
+**修复**
+
+- 修复 `/remote exec` 直接按 4,000 字符截断通知、且不保留或提示完整输出位置的问题。
+
+### 0.1.2 — 2026-07-24
+
+**新增**
+
+- 无。
+
+**变更**
+
+- 将 0.1.1 的运行时代码以 0.1.2 重新发布，用于对齐 npm 包版本元数据；没有运行时代码变化。
+
+**修复**
+
+- 无。
+
+### 0.1.1 — 2026-07-24
+
+**新增**
+
+- 新增简化命令 `/remote ssh USER@HOST [-p PORT]`。
+
+**变更**
+
+- `/remote ssh` 现在会保存、选中并立即连接 endpoint，而不只是保存配置。
+
+**修复**
+
+- 修复帮助和错误信息仍提示使用旧命令 `/remote config ssh ssh ...` 的问题。
+
+### 0.1.0 — 2026-07-24
+
+**新增**
+
+- 首次发布，支持持久化多 endpoint SSH 工作区和远程工作目录。
+- 新增 Pi `read`、`write`、`edit`、`bash` 和用户 Shell 操作的透明远端路由。
+- 新增 SSH agent/密码认证、交互式主机密钥校验、自动重连、SFTP 文件访问、命令输出限制和本地 TCP 端口转发。
+
+**变更**
+
+- 无。
+
+**修复**
+
+- 无。
+
 MIT License。

package/index.ts

@@ -55,6 +55,7 @@ interface RemoteEndpointConfig {
   remoteCwd?: string;
   forwards?: string[];
   note?: string;
+  memory?: string;
 }
 
 interface RemoteConfig {
@@ -252,6 +253,23 @@ function endpointDisplayLabel(endpoint: ParsedSsh, config = loadRemoteConfig()):
   return note ? `${note} (${endpoint.label})` : endpoint.label;
 }
 
+function endpointMemory(endpoint: ParsedSsh, config = loadRemoteConfig()): string | undefined {
+  return endpointConfig(config, endpoint.command).memory?.trim() || undefined;
+}
+
+function remoteSystemPrompt(systemPrompt: string, localCwd: string, remote: RemoteState): string {
+  return systemPrompt.replace(
+    `Current working directory: ${localCwd}`,
+    `Current working directory: ${remote.cwd} (via SSH ${endpointDisplayLabel(remote)}). All read, write, edit, bash, and user shell operations run on this remote server. Use ssh_remote_control with action disconnect to return to the local environment when requested.`,
+  );
+}
+
+function serverMemoryContext(remote: RemoteState): string | undefined {
+  const memory = endpointMemory(remote);
+  if (!memory) return undefined;
+  return `<ssh_remote_server_memory endpoint="${remote.label}">\nThe following is user-configured, persistent memory specific to this SSH server. Apply it while working on this server:\n${memory}\n</ssh_remote_server_memory>`;
+}
+
 function saveEndpointConfig(command: string, updates: RemoteEndpointConfig, makeActive = false): void {
   const config = loadRemoteConfig();
   const key = cacheId(parseSshCommand(command));
@@ -759,8 +777,8 @@ export default function sshRemoteExtension(pi: ExtensionAPI) {
   pi.registerTool({
     name: "ssh_remote_control",
     label: "SSH Remote Control",
-    description: "Connect, reconnect, annotate endpoints, change the persistent remote working directory, inspect, forward ports, run remote SSH commands, or disconnect the configured SSH environment. Exec output uses a configurable collapsed preview (5 visual lines by default), while model output is limited to 50KB or 2000 lines and saved to a local temporary file when truncated. Passwords are never accepted as arguments and are cached only in process memory.",
-    promptSnippet: "Control the configured remote SSH connection, endpoint note, working directory, and local port forwarding",
+    description: "Connect, reconnect, annotate endpoints, manage server-specific memory, change the persistent remote working directory, inspect, forward ports, run remote SSH commands, or disconnect the configured SSH environment. Exec output uses a configurable collapsed preview (5 visual lines by default), while model output is limited to 50KB or 2000 lines and saved to a local temporary file when truncated. Passwords are never accepted as arguments and are cached only in process memory.",
+    promptSnippet: "Control the configured remote SSH connection, endpoint note and memory, working directory, and local port forwarding",
     promptGuidelines: [
       "Use ssh_remote_control when the user asks the agent to enter, reconnect, inspect, or leave a remote SSH environment.",
       "Use ssh_remote_control with action chdir when the user asks to change the remote working directory; do not emulate a persistent directory change with action exec and a one-command cwd.",
@@ -768,9 +786,10 @@ export default function sshRemoteExtension(pi: ExtensionAPI) {
       "Use ssh_remote_control with action disconnect after remote work when the user asks to return to the local environment.",
     ],
     parameters: Type.Object({
-      action: StringEnum(["connect", "reconnect", "status", "disconnect", "forget", "forward", "unforward", "exec", "chdir", "note"] as const),
-      command: Type.Optional(Type.String({ description: "SSH command for connect, such as ssh root@host -p 22; optionally selects the endpoint for note" })),
+      action: StringEnum(["connect", "reconnect", "status", "disconnect", "forget", "forward", "unforward", "exec", "chdir", "note", "memory"] as const),
+      command: Type.Optional(Type.String({ description: "SSH command for connect, such as ssh root@host -p 22; optionally selects the endpoint for note or memory" })),
       note: Type.Optional(Type.String({ description: "Endpoint note for the note action; omit or use an empty string to clear it" })),
+      memory: Type.Optional(Type.String({ description: "Persistent server-specific context for the memory action; omit or use an empty string to clear it" })),
       cwd: Type.Optional(Type.String({ description: "Remote working directory; required for chdir, and a one-command override for exec" })),
       forwards: Type.Optional(Type.String({ description: "Space-separated LOCAL_PORT:REMOTE_HOST:REMOTE_PORT mappings; defaults to ssh-remote-config.json" })),
       remoteCommand: Type.Optional(Type.String({ description: "Remote shell command for the exec action" })),
@@ -813,16 +832,24 @@ export default function sshRemoteExtension(pi: ExtensionAPI) {
         const resolved = await changeRemoteCwd(params.cwd, ctx);
         return { content: [{ type: "text", text: `Remote working directory: ${resolved}` }], details: { connected: true, cwd: resolved } };
       }
-      if (params.action === "note") {
+      if (params.action === "note" || params.action === "memory") {
         const command = params.command || lastCommand || activeSshCommand();
         if (!command) throw new Error("No SSH endpoint configured; connect or select an endpoint first");
-        const note = params.note?.trim() || undefined;
-        saveEndpointConfig(command, { note });
-        if (remote && cacheId(remote) === cacheId(parseSshCommand(command)) && currentCtx) status(currentCtx);
         const label = parseSshCommand(command).label;
+        if (params.action === "note") {
+          const note = params.note?.trim() || undefined;
+          saveEndpointConfig(command, { note });
+          if (remote && cacheId(remote) === cacheId(parseSshCommand(command)) && currentCtx) status(currentCtx);
+          return {
+            content: [{ type: "text", text: note ? `SSH remote note updated (${label}): ${note}` : `SSH remote note cleared (${label})` }],
+            details: { endpoint: label, note },
+          };
+        }
+        const memory = params.memory?.trim() || undefined;
+        saveEndpointConfig(command, { memory });
         return {
-          content: [{ type: "text", text: note ? `SSH remote note updated (${label}): ${note}` : `SSH remote note cleared (${label})` }],
-          details: { endpoint: label, note },
+          content: [{ type: "text", text: memory ? `SSH remote server memory updated (${label}). It will be injected while this endpoint is the active remote workspace.` : `SSH remote server memory cleared (${label}).` }],
+          details: { endpoint: label, memory },
         };
       }
       if (params.action === "exec") {
@@ -867,7 +894,7 @@ export default function sshRemoteExtension(pi: ExtensionAPI) {
   });
 
   pi.registerCommand("remote", {
-    description: "Connect over SSH and manage endpoints: /remote | ssh USER@HOST [-p PORT] | config | use USER@HOST:PORT | config note TEXT|--clear | config cwd PATH | config display-lines N | forward [MAPPINGS] | unforward | exec [--timeout SECONDS] [--lines N] COMMAND | cd PATH | status | reload | off | forget",
+    description: "Connect over SSH and manage endpoints: /remote | ssh USER@HOST [-p PORT] | config | use USER@HOST:PORT | config note TEXT|--clear | config memory TEXT|--clear | config cwd PATH | config display-lines N | forward [MAPPINGS] | unforward | exec [--timeout SECONDS] [--lines N] COMMAND | cd PATH | status | reload | off | forget",
     handler: async (args, ctx) => {
       const input = args.trim().replace(/^\/?remote(?:\s+|$)/i, "").trim();
       const action = input.toLowerCase();
@@ -875,7 +902,7 @@ export default function sshRemoteExtension(pi: ExtensionAPI) {
         const config = loadRemoteConfig();
         const rows = Object.entries(config.endpoints ?? {}).map(([key, endpoint]) => {
           const active = key === config.activeEndpoint ? "*" : " ";
-          return `${active} ${key}\n    note: ${endpoint.note || "none"}\n    SSH: ${endpoint.sshCommand}\n    cwd: ${endpoint.remoteCwd || FALLBACK_REMOTE_CWD}\n    forward: ${endpoint.forwards?.join(", ") || "none"}`;
+          return `${active} ${key}\n    note: ${endpoint.note || "none"}\n    memory: ${endpoint.memory || "none"}\n    SSH: ${endpoint.sshCommand}\n    cwd: ${endpoint.remoteCwd || FALLBACK_REMOTE_CWD}\n    forward: ${endpoint.forwards?.join(", ") || "none"}`;
         });
         ctx.ui.notify(`SSH remote configuration: ${REMOTE_CONFIG_FILE}\nDisplay lines: ${configuredDisplayLines(config)}\n${rows.join("\n") || "No saved endpoints"}`, "info");
         return;
@@ -927,6 +954,16 @@ export default function sshRemoteExtension(pi: ExtensionAPI) {
         ctx.ui.notify(note ? `SSH remote note updated (${parseSshCommand(command).label}): ${note}` : `SSH remote note cleared (${parseSshCommand(command).label})`, "info");
         return;
       }
+      if (/^config\s+memory(?:\s+|$)/i.test(input)) {
+        const value = input.replace(/^config\s+memory\s*/i, "").trim();
+        if (!value) { ctx.ui.notify("Use /remote config memory TEXT or /remote config memory --clear", "error"); return; }
+        const command = lastCommand || activeSshCommand();
+        if (!command) { ctx.ui.notify("Configure an SSH endpoint first", "error"); return; }
+        const memory = value.toLowerCase() === "--clear" ? undefined : value;
+        saveEndpointConfig(command, { memory });
+        ctx.ui.notify(memory ? `SSH remote server memory updated (${parseSshCommand(command).label}); it will be injected while connected` : `SSH remote server memory cleared (${parseSshCommand(command).label})`, "info");
+        return;
+      }
       if (/^config\s+display-lines\s+/i.test(input)) {
         try {
           const displayLines = parseDisplayLines(input.replace(/^config\s+display-lines\s+/i, "").trim());
@@ -1055,9 +1092,20 @@ export default function sshRemoteExtension(pi: ExtensionAPI) {
     }
   });
   pi.on("before_agent_start", (event) => remote && routeRemoteTools ? {
-    systemPrompt: event.systemPrompt.replace(
-      `Current working directory: ${localCwd}`,
-      `Current working directory: ${remote.cwd} (via SSH ${endpointDisplayLabel(remote)}). All read, write, edit, bash, and user shell operations run on this remote server. Use ssh_remote_control with action disconnect to return to the local environment when requested.`,
-    ),
+    systemPrompt: remoteSystemPrompt(event.systemPrompt, localCwd, remote),
   } : undefined);
+  pi.on("context", (event) => {
+    if (!remote || !routeRemoteTools) return undefined;
+    const content = serverMemoryContext(remote);
+    if (!content) return undefined;
+    return {
+      messages: [...event.messages, {
+        role: "custom",
+        customType: "ssh-remote-server-memory",
+        content,
+        display: false,
+        timestamp: Date.now(),
+      }],
+    };
+  });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-ssh-remote",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Persistent remote SSH workspaces for Pi.",
   "type": "module",
   "author": "Yutong Bian",