pi-link 0.5.0 → 0.5.2

package/CHANGELOG.md

@@ -6,6 +6,32 @@ This changelog is based on the git history from `2026-03-21` (initial commit) th
 
 ---
 
+## 0.5.2 — 2026-09-29
+
+### Fixed
+
+- **Session-directory errors no longer look like an empty session history.** If the CLI cannot enumerate the session root for a reason other than a missing directory, it reports the error and exits with code `1`. The launcher no longer starts a new session on that false absence, `--list` no longer reports no sessions, and `--resolve` no longer reports the name as not found. A missing root still means no sessions yet; handling of individual session files and subdirectories is unchanged.
+
+- **A terminal named `__proto__` keeps its status, cwd and context snapshots.** The name-keyed records in the initial welcome and `link_list` details now use dictionaries without a prototype, so that accepted name is copied into those records and serialized as an ordinary own property rather than lost through JavaScript's inherited setter. No names are newly reserved.
+
+- **`pi-link --version` fails explicitly when package metadata cannot supply a version.** An unreadable or malformed `package.json`, or a missing version, now produces an error and a nonzero exit instead of printing `unknown` and exiting successfully. A healthy installation still prints only its version.
+
+### Changed
+
+- **Internal cleanup reuses existing status and delivery helpers.** Status formatting uses the existing identity formatter, disconnect relies on the inbox scheduler's existing timer guard, and client status updates use the shared hub broadcast path instead of duplicating it. Those updates keep their authoritative sender name, recipients and context rules; the hub now stores them through self-delivery after sending to peers, as the shared path already does. Two unreachable CLI `break` statements after `process.exit(0)` were also removed.
+
+---
+
+## 0.5.1 — 2026-09-22
+
+### Fixed
+
+- **pi-link's tools are callable directly under Oh My Pi.** The three tools are registered with `loadMode: "essential"`, so harnesses that hide extension tools by default, such as Oh My Pi, list them with the other callable tools instead of behind a discovery path. Pi has no such field and ignores it.
+
+- **Peers see a terminal's context usage change after a model switch or tree navigation.** A terminal now republishes its context when its model changes or it moves to another branch of the session tree. Before, an idle terminal kept showing its previous figure until its next run.
+
+---
+
 ## 0.5.0 — 2026-09-16
 
 ### Added

package/README.md

@@ -663,11 +663,13 @@ The extension hooks into Pi's agent lifecycle events:
 - **`tool_execution_end`** → Drops that one call. The display stays `tool:<name>` while other calls remain, moves to the next call when the displayed one ends, and returns to `thinking` after the last one while the agent run continues.
 - **`session_before_compact`** → For a manual compaction, raises the gate that holds inbox delivery. Automatic (threshold/overflow) compaction is left alone: it runs inside the agent run, where Pi already queues and drains steered messages itself.
 - **`session_compact`** → Clears the local compaction gate and force-pushes a `status_update` so peers see the new (post-compaction) context usage immediately.
+- **`model_select`** → Force-pushes a `status_update`: the context window, and so the usage percentage, belongs to the model.
+- **`session_tree`** → Force-pushes a `status_update`: context usage belongs to the active branch.
 - **`session_shutdown`** → Full cleanup via `cleanup()`: closes all sockets, resolves pending promises, and disposes the extension.
 
-The five agent and tool handlers — `agent_start`, `agent_end`, `agent_settled` (when Pi still reports the session idle), `tool_execution_start` and `tool_execution_end` — each recompute the status and hand it to `pushStatus()`, which publishes only when the display identity changed since the last publish: a second concurrent tool starting behind the one already shown is silent, and so is a mutation that leaves a raised compaction gate on display. The session handlers keep the separate paths described in their own bullets, and `session_shutdown` cleans up rather than pushing. `disconnect()` is the only thing that clears the stored baseline, and `pushStatus()` returns immediately while the terminal is disconnected, so handler events in that interval restore nothing; once connected again, either a client's forced `welcome` push or the first of those ordinary handler events restores it. `session_compact` always pushes, whether the identity changed or not — including while a remote request's gate still holds the displayed identity.
+The five agent and tool handlers — `agent_start`, `agent_end`, `agent_settled` (when Pi still reports the session idle), `tool_execution_start` and `tool_execution_end` — each recompute the status and hand it to `pushStatus()`, which publishes only when the display identity changed since the last publish: a second concurrent tool starting behind the one already shown is silent, and so is a mutation that leaves a raised compaction gate on display. The session handlers keep the separate paths described in their own bullets, and `session_shutdown` cleans up rather than pushing. `disconnect()` is the only thing that clears the stored baseline, and `pushStatus()` returns immediately while the terminal is disconnected, so handler events in that interval restore nothing; once connected again, either a client's forced `welcome` push or the first of those ordinary handler events restores it. `session_compact`, `model_select` and `session_tree` always push, whether the identity changed or not — including while a remote request's gate still holds the displayed identity.
 
-Status updates are push-based: each terminal broadcasts changes to the hub, which fans them out. New joiners receive a status snapshot for all terminals in the `welcome` message. Context updates reuse the same status path, including a forced post-compaction update.
+Status updates are push-based: each terminal broadcasts changes to the hub, which fans them out. New joiners receive a status snapshot for all terminals in the `welcome` message. Context updates reuse the same status path, including forced updates after a compaction, a model change and tree navigation.
 
 ### Inbox
 

package/bin/pi-link.mjs

@@ -183,14 +183,17 @@ async function loadSessionRecord(filePath, scopeCwd) {
 // Returns meta + mtime + path for every readable session in `dir`, or only
 // those from `scopeCwd` when it is given. Custom layout is flat
 // (<dir>/*.jsonl); default layout has one subdir level per encoded cwd
-// (<dir>/<sub>/*.jsonl). Errors on individual files/dirs are silently skipped
-// — active or partially-written sessions are tolerated.
+// (<dir>/<sub>/*.jsonl). A missing `dir` means no sessions yet; any other
+// failure to read it is fatal, since reporting no sessions would be a lie.
+// Errors on individual files/dirs are silently skipped — active or
+// partially-written sessions are tolerated.
 async function scanSessions(dir, isCustom, scopeCwd) {
   let entries;
   try {
     entries = await readdir(dir, { withFileTypes: true });
-  } catch {
-    return [];
+  } catch (err) {
+    if (err.code === "ENOENT") return [];
+    fail(`cannot read session directory: ${err.message}`);
   }
 
   const tasks = [];
@@ -315,14 +318,14 @@ function printHelp() {
 }
 
 function printVersion() {
+  let pkg;
   try {
-    const pkg = JSON.parse(
-      readFileSync(new URL("../package.json", import.meta.url), "utf-8"),
-    );
-    console.log(pkg.version ?? "unknown");
-  } catch {
-    console.log("unknown");
+    pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
+  } catch (err) {
+    fail(`cannot read pi-link's package.json: ${err.message}`);
   }
+  if (!pkg.version) fail("pi-link's package.json has no version");
+  console.log(pkg.version);
 }
 
 function describeMode(mode) {
@@ -515,11 +518,9 @@ switch (state.mode) {
   case "help":
     printHelp();
     process.exit(0);
-    break; // unreachable; present to satisfy no-fallthrough lints
   case "version":
     printVersion();
     process.exit(0);
-    break; // unreachable; present to satisfy no-fallthrough lints
   case "list":
     await runList(state);
     break;

package/index.ts

@@ -44,6 +44,9 @@ const BATCH_MAX_ITEMS = 20;
 const BATCH_MAX_CHARS = 16_000;
 // Visual rows of an incoming message kept while Pi's global expansion is off.
 const PREVIEW_ROWS = 6;
+// Consumed by harnesses that hide extension tools by default (Oh My Pi);
+// ignored by Pi, whose ToolDefinition has no such field.
+const TOP_LEVEL_TOOL = { loadMode: "essential" } as const;
 
 // ─── Protocol ────────────────────────────────────────────────────────────────
 
@@ -418,9 +421,7 @@ export default function (pi: ExtensionAPI) {
   }
 
   function formatStatus(s: LinkStatus): string {
-    const dur = formatDuration(s.since);
-    if (s.kind === "tool") return `tool:${s.toolName} (${dur})`;
-    return `${s.kind} (${dur})`;
+    return `${statusIdentity(s)} (${formatDuration(s.since)})`;
   }
 
   function formatTokens(n: number): string {
@@ -960,14 +961,15 @@ export default function (pi: ExtensionAPI) {
         hubClients.set(clientWs, clientName);
         const list = terminalList();
 
-        // Confirm to the new client (with status, cwd and context snapshots)
-        const statuses: Record<string, LinkStatus> = {};
+        // Confirm to the new client (with status, cwd and context snapshots).
+        // Keyed by terminal name, so no prototype: a plain {} would swallow "__proto__".
+        const statuses: Record<string, LinkStatus> = Object.create(null);
         statuses[terminalName] = deriveStatus(); // hub's own status
         for (const [name, status] of terminalStatuses) statuses[name] = status;
-        const cwds: Record<string, string> = {};
+        const cwds: Record<string, string> = Object.create(null);
         if (currentCwd) cwds[terminalName] = currentCwd; // hub's own cwd
         for (const [name, cwd] of terminalCwds) cwds[name] = cwd;
-        const contexts: Record<string, ContextSnapshot> = {};
+        const contexts: Record<string, ContextSnapshot> = Object.create(null);
         const hubContext = captureContext();
         if (hubContext) contexts[terminalName] = hubContext; // hub's own context
         for (const [name, c] of terminalContexts) contexts[name] = c;
@@ -998,21 +1000,16 @@ export default function (pi: ExtensionAPI) {
       // Ignore messages from unregistered clients
       if (!clientName) return;
 
-      // Status update — store and fan out to other clients only (not back to hub)
+      // Status update: rebuilt under the authoritative name, fanned out to the other
+      // clients, and stored by the hub through its own self-delivery.
       if (msg.type === "status_update") {
-        terminalStatuses.set(clientName, msg.status);
-        if (msg.context) terminalContexts.set(clientName, msg.context);
-        else if (msg.context === null) terminalContexts.delete(clientName);
         const normalized: StatusUpdateMsg = {
           type: "status_update",
           name: clientName,
           status: msg.status,
           context: msg.context, // undefined omitted by JSON; null forwarded to clear
         };
-        const json = JSON.stringify(normalized);
-        for (const [otherWs, name] of hubClients) {
-          if (name !== clientName) otherWs.send(json);
-        }
+        hubBroadcast(normalized, clientName);
         return;
       }
 
@@ -1337,7 +1334,7 @@ export default function (pi: ExtensionAPI) {
     updateStatus();
 
     // Inbox survives disconnect; flush unless a local /compact still gates it.
-    if (!flushTimer) releaseInbox();
+    releaseInbox();
   }
 
   function cleanup() {
@@ -1469,6 +1466,14 @@ export default function (pi: ExtensionAPI) {
     pushStatus(true);
   });
 
+  pi.on("model_select", async () => {
+    pushStatus(true); // the window, and so the usage percentage, belongs to the model
+  });
+
+  pi.on("session_tree", async () => {
+    pushStatus(true); // context usage belongs to the active branch
+  });
+
   pi.on("tool_execution_start", async (event) => {
     const before = statusIdentity(deriveStatus());
     activeTools.set(event.toolCallId, event.toolName);
@@ -1566,6 +1571,7 @@ export default function (pi: ExtensionAPI) {
   // ── Tools ────────────────────────────────────────────────────────────────
 
   pi.registerTool({
+    ...TOP_LEVEL_TOOL,
     name: "link_send",
     label: "Link Send",
     description: [
@@ -1630,6 +1636,7 @@ export default function (pi: ExtensionAPI) {
   });
 
   pi.registerTool({
+    ...TOP_LEVEL_TOOL,
     name: "link_compact",
     label: "Link Compact",
     description: [
@@ -1742,6 +1749,7 @@ export default function (pi: ExtensionAPI) {
   });
 
   pi.registerTool({
+    ...TOP_LEVEL_TOOL,
     name: "link_list",
     label: "Link List",
     description: "List the Pi terminals in your group currently connected to the link.",
@@ -1751,9 +1759,10 @@ export default function (pi: ExtensionAPI) {
     async execute() {
       if (role === "disconnected") return notConnectedResult();
 
-      const statuses: Record<string, string> = {};
-      const cwds: Record<string, string> = {};
-      const contexts: Record<string, ContextSnapshot> = {};
+      // Keyed by terminal name, so no prototype (see the welcome snapshots).
+      const statuses: Record<string, string> = Object.create(null);
+      const cwds: Record<string, string> = Object.create(null);
+      const contexts: Record<string, ContextSnapshot> = Object.create(null);
       const visible = visibleTerminals();
       const list = visible
         .map((name) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-link",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "WebSocket-based inter-terminal communication for Pi. Connect multiple Pi terminals over a local link network.",
   "author": "alvivar",
   "license": "MIT",