pi-ssh-remote 0.1.8 → 0.1.10

package/CHANGELOG.md

@@ -18,6 +18,34 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Rel
 
 - None.
 
+## [0.1.10] - 2026-08-16
+
+### Added
+
+- None.
+
+### Changed
+
+- None.
+
+### Fixed
+
+- Prevented the agent-facing `memory` action from clearing or replacing server memory accidentally: omission now inspects the saved memory, non-empty text appends idempotently, empty text is rejected, and clearing requires an explicit `--clear` value.
+
+## [0.1.9] - 2026-08-12
+
+### Added
+
+- None.
+
+### Changed
+
+- Removed the redundant `SSH remote` prefix from footer status labels.
+
+### Fixed
+
+- Kept injected server memory as a single stable context prefix so tool continuations do not repeatedly move it to the end of the conversation or invalidate cached provider context.
+
 ## [0.1.8] - 2026-08-10
 
 ### Added
@@ -161,7 +189,9 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Rel
 
 - None.
 
-[Unreleased]: https://github.com/petrichor20211/pi-ssh-remote/compare/v0.1.8...HEAD
+[Unreleased]: https://github.com/petrichor20211/pi-ssh-remote/compare/v0.1.10...HEAD
+[0.1.10]: https://github.com/petrichor20211/pi-ssh-remote/compare/v0.1.9...v0.1.10
+[0.1.9]: https://github.com/petrichor20211/pi-ssh-remote/compare/v0.1.8...v0.1.9
 [0.1.8]: https://github.com/petrichor20211/pi-ssh-remote/compare/v0.1.7...v0.1.8
 [0.1.7]: https://github.com/petrichor20211/pi-ssh-remote/compare/v0.1.6...v0.1.7
 [0.1.6]: https://github.com/petrichor20211/pi-ssh-remote/compare/v0.1.5...v0.1.6

package/README.md

@@ -73,7 +73,7 @@ Requires Node.js 20+. The remote server must provide Bash, SFTP, and GNU `timeou
 From this point, normal Pi operations target `/srv/project` on the remote server. The footer makes that routing explicit:
 
 ```text
-SSH remote H100 training server (root@gpu-box.example.com:2202):/srv/project
+H100 training server (root@gpu-box.example.com:2202):/srv/project
 ```
 
 Return to local tools with:
@@ -164,7 +164,7 @@ Forward the remote service on port 8000 to localhost:8000, but keep my coding
 tools on the local repository.
 ```
 
-These requests are handled through the agent-facing `remote` tool; slash commands are optional.
+These requests are handled through the agent-facing `remote` tool; slash commands are optional. For safety, calling its `memory` action without a `memory` argument only reads the current server memory. Non-empty text is appended to the existing memory instead of replacing it; retrying the same final entry is a no-op. Clearing still requires the explicit `--clear` value.
 
 ## Command reference
 
@@ -215,13 +215,13 @@ The extension currently supports direct SSH commands with `-p`, `-l`, and `-i`.
 
 ## Releases
 
-Latest release: [v0.1.8](https://github.com/petrichor20211/pi-ssh-remote/releases/tag/v0.1.8)
+Latest release: [v0.1.10](https://github.com/petrichor20211/pi-ssh-remote/releases/tag/v0.1.10)
 
 | Version | Date | Highlights |
 |---|---|---|
+| [0.1.10](CHANGELOG.md#0110---2026-08-16) | 2026-08-16 | Safe inspect-by-default and append-only agent updates for server memory |
+| [0.1.9](CHANGELOG.md#019---2026-08-12) | 2026-08-12 | Stable deduplicated server-memory context and shorter footer labels |
 | [0.1.8](CHANGELOG.md#018---2026-08-10) | 2026-08-10 | Explicit private-key login, cross-port server memory, and the shorter `remote` tool name |
-| [0.1.7](CHANGELOG.md#017---2026-08-05) | 2026-08-05 | Session-aware SSH workspace restoration for new, forked, and resumed sessions |
-| [0.1.6](CHANGELOG.md#016---2026-08-05) | 2026-08-05 | Bounded remote reads, streamed command output, and per-turn output budgets |
 
 See [CHANGELOG.md](CHANGELOG.md) for the complete release history, including additions, behavior changes, and bug fixes.
 

package/README.zh-CN.md

@@ -39,7 +39,7 @@ ssh user@host "cd /path && ..."
 插件会把当前远程目录和服务器信息写入 Pi 的上下文，并显示在底部状态栏：
 
 ```text
-SSH remote H100 训练机 (root@gpu-box.example.com:2202):/srv/project
+H100 训练机 (root@gpu-box.example.com:2202):/srv/project
 ```
 
 这样无论是用户还是 Agent，都能随时确认当前操作发生在本地还是远端，减少误操作。
@@ -218,7 +218,7 @@ pi install npm:pi-ssh-remote
 把远端 8000 端口转发到本地 8000，但代码工具继续留在本地。
 ```
 
-Pi 会通过插件提供的 `remote` 工具完成这些操作。
+Pi 会通过插件提供的 `remote` 工具完成这些操作。为防止误删，调用 `memory` action 但不传 `memory` 参数时只会读取当前服务器记忆；传入非空内容时会追加到现有记忆，而不是覆盖，重复提交相同的末尾内容不会再次追加；清除时仍必须显式传入 `--clear`。
 
 ## 命令说明
 
@@ -294,13 +294,13 @@ Pi 会通过插件提供的 `remote` 工具完成这些操作。
 
 ## 版本发布
 
-最新版本：[v0.1.8](https://github.com/petrichor20211/pi-ssh-remote/releases/tag/v0.1.8)
+最新版本：[v0.1.10](https://github.com/petrichor20211/pi-ssh-remote/releases/tag/v0.1.10)
 
 | 版本 | 日期 | 主要内容 |
 |---|---|---|
+| [0.1.10](CHANGELOG.md#0110---2026-08-16) | 2026-08-16 | 默认安全读取且仅追加的服务器记忆 agent 更新逻辑 |
+| [0.1.9](CHANGELOG.md#019---2026-08-12) | 2026-08-12 | 稳定且去重的服务器记忆上下文与更短的状态栏标签 |
 | [0.1.8](CHANGELOG.md#018---2026-08-10) | 2026-08-10 | 显式私钥登录、跨端口服务器记忆与更短的 `remote` 工具名 |
-| [0.1.7](CHANGELOG.md#017---2026-08-05) | 2026-08-05 | 新建、分叉和恢复 session 时自动恢复对应 SSH 工作区 |
-| [0.1.6](CHANGELOG.md#016---2026-08-05) | 2026-08-05 | 有界远端读取、流式命令输出与每轮输出预算 |
 
 完整的新增内容、行为变更和 Bug 修复记录请查看 [CHANGELOG.md](CHANGELOG.md)。
 

package/index.ts

@@ -931,8 +931,8 @@ export default function sshRemoteExtension(pi: ExtensionAPI) {
   const status = (ctx: any) => {
     currentCtx = ctx;
     if (!remote) ctx.ui.setStatus("ssh-remote", undefined);
-    else if (routeRemoteTools) ctx.ui.setStatus("ssh-remote", ctx.ui.theme.fg("accent", `SSH remote ${endpointDisplayLabel(remote)}:${remote.cwd}`));
-    else ctx.ui.setStatus("ssh-remote", ctx.ui.theme.fg("accent", `SSH remote tunnel ${[...forwardServers.keys()].join(",") || endpointDisplayLabel(remote)}`));
+    else if (routeRemoteTools) ctx.ui.setStatus("ssh-remote", ctx.ui.theme.fg("accent", `${endpointDisplayLabel(remote)}:${remote.cwd}`));
+    else ctx.ui.setStatus("ssh-remote", ctx.ui.theme.fg("accent", `tunnel ${[...forwardServers.keys()].join(",") || endpointDisplayLabel(remote)}`));
   };
 
   const attachClient = (state: RemoteState) => {
@@ -940,7 +940,7 @@ export default function sshRemoteExtension(pi: ExtensionAPI) {
     client.on("close", () => {
       if (remote?.client !== client) return;
       if (currentCtx) {
-        currentCtx.ui.setStatus("ssh-remote", currentCtx.ui.theme.fg("warning", `SSH remote reconnecting ${endpointDisplayLabel(state)}…`));
+        currentCtx.ui.setStatus("ssh-remote", currentCtx.ui.theme.fg("warning", `reconnecting ${endpointDisplayLabel(state)}…`));
       }
       void reconnectRemote().catch((error) => {
         if (currentCtx) currentCtx.ui.notify(`SSH remote automatic reconnection failed: ${(error as Error).message}`, "error");
@@ -1055,7 +1055,7 @@ export default function sshRemoteExtension(pi: ExtensionAPI) {
     }
 
     let password = getCachedPassword(parsed);
-    ctx.ui.setStatus("ssh-remote", ctx.ui.theme.fg("warning", `SSH remote connecting ${endpointDisplayLabel(parsed)}…`));
+    ctx.ui.setStatus("ssh-remote", ctx.ui.theme.fg("warning", `connecting ${endpointDisplayLabel(parsed)}…`));
     try {
       let authentication = parsed.identityFile
         ? await privateKeyAuthentication(parsed, ctx)
@@ -1299,6 +1299,7 @@ export default function sshRemoteExtension(pi: ExtensionAPI) {
     promptGuidelines: [
       "Use remote when the user asks the agent to enter, reconnect, inspect, or leave a remote SSH environment.",
       "Use remote 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.",
+      "Use remote with action memory and no memory argument to inspect server memory. Non-empty memory text appends to the existing memory; clear it only by passing --clear explicitly.",
       `Always set timeout for remote exec commands; it defaults to ${DEFAULT_REMOTE_TIMEOUT_SECONDS} seconds when omitted.`,
       "Keep remote exec output narrow with tail, sed, rg limits, or similarly bounded commands; never cat large logs or emit broad file listings.",
       "Use remote with action disconnect after remote work when the user asks to return to the local environment.",
@@ -1307,7 +1308,7 @@ export default function sshRemoteExtension(pi: ExtensionAPI) {
       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 or ssh -i ~/.ssh/id_ed25519 root@host; 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 context shared by the endpoint's user@host across SSH ports; omit or use an empty string to clear it" })),
+      memory: Type.Optional(Type.String({ description: "Persistent context shared by the endpoint's user@host across SSH ports; omit to inspect, provide non-empty text to append without overwriting existing memory, or use --clear to clear explicitly" })),
       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" })),
@@ -1366,12 +1367,37 @@ export default function sshRemoteExtension(pi: ExtensionAPI) {
             details: { endpoint: label, note },
           };
         }
-        const memory = params.memory?.trim() || undefined;
-        const server = serverMemoryId(parseSshCommand(command));
+        const parsed = parseSshCommand(command);
+        const server = serverMemoryId(parsed);
+        if (params.memory === undefined) {
+          const memory = endpointMemory(parsed);
+          return {
+            content: [{ type: "text", text: memory ? `SSH remote server memory (${server}):\n${memory}` : `No SSH remote server memory is configured (${server}).` }],
+            details: { endpoint: label, server, memory },
+          };
+        }
+        const addition = params.memory.trim();
+        if (!addition) throw new Error("memory must contain text; omit it to inspect the current memory or use --clear to clear it explicitly");
+        if (addition.toLowerCase() === "--clear") {
+          saveServerMemory(command, undefined);
+          return {
+            content: [{ type: "text", text: `SSH remote server memory cleared (${server}).` }],
+            details: { endpoint: label, server, memory: undefined },
+          };
+        }
+        const currentMemory = endpointMemory(parsed);
+        const duplicate = currentMemory === addition || currentMemory?.endsWith(`\n\n${addition}`);
+        if (duplicate) {
+          return {
+            content: [{ type: "text", text: `SSH remote server memory already ends with this content (${server}); nothing was changed.` }],
+            details: { endpoint: label, server, memory: currentMemory, addedMemory: addition, changed: false },
+          };
+        }
+        const memory = currentMemory ? `${currentMemory}\n\n${addition}` : addition;
         saveServerMemory(command, memory);
         return {
-          content: [{ type: "text", text: memory ? `SSH remote server memory updated (${server}). It applies to every port for this user and host.` : `SSH remote server memory cleared (${server}).` }],
-          details: { endpoint: label, server, memory },
+          content: [{ type: "text", text: `SSH remote server memory appended (${server}). It applies to every port for this user and host.` }],
+          details: { endpoint: label, server, memory, addedMemory: addition, changed: true },
         };
       }
       if (params.action === "exec") {
@@ -1679,14 +1705,17 @@ export default function sshRemoteExtension(pi: ExtensionAPI) {
     if (!remote || !routeRemoteTools) return undefined;
     const content = serverMemoryContext(remote);
     if (!content) return undefined;
+    const messages = event.messages.filter((message) =>
+      message.role !== "custom" || message.customType !== "ssh-remote-server-memory"
+    );
     return {
-      messages: [...event.messages, {
+      messages: [{
         role: "custom",
         customType: "ssh-remote-server-memory",
         content,
         display: false,
         timestamp: Date.now(),
-      }],
+      }, ...messages],
     };
   });
 }

package/package.json

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