pi-link 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -6,6 +6,20 @@ This changelog is based on the git history from `2026-03-21` (initial commit) th
 
 ---
 
+## 0.4.1 — 2026-09-07
+
+### Added
+
+- **Received link messages now sit in Pi's own message panel.** A delivery is drawn in the same background panel Pi gives extension messages, indented by your configured output padding, so link traffic lines up with the rest of the transcript instead of standing outside it.
+
+- **A long delivery is collapsed to a preview.** It shows the first six content rows as they wrap at the available content width inside the panel, then `... (N more lines, ctrl+o to expand)`; a message that already fits shows whole, with no hint. The six counts content rows only — the panel's padding and the hint itself sit outside it, so the panel has no fixed height. Expanding is Pi's existing global toggle, `Ctrl+O` unless you have rebound `app.tools.expand`, and the hint names your actual binding when one is assigned. It expands every custom message at once, including ones restored from an earlier session; pi-link adds no toggle of its own. When the expansion shortcut is unbound, incoming and outgoing previews show `bind app.tools.expand to expand`. Only the display changes — the full text is still what reaches the model, what was delivered, and what the session file keeps.
+
+### Changed
+
+- **Outgoing `link_send` and `link_compact` calls now follow Pi's global expansion toggle.** Collapsed, the message — or the compaction instructions — has runs of whitespace collapsed to single spaces and keeps the first 60 characters of that result; on a narrow terminal that preview may still wrap onto more than one row. Expanded, the uncollapsed text is shown with its line breaks and spacing as rendered by Pi. Indentation of the surrounding call is unchanged, and the tool's own result line still reports send or compaction status — never the other terminal's reply.
+
+---
+
 ## 0.4.0 — 2026-09-04
 
 ### Added

package/README.md

@@ -717,3 +717,9 @@ Because a gated flush does not reschedule, the release path is load-bearing. `re
 ### Rendering
 
 Delivered link batches render with a styled `⚡ [link]` prefix using the theme's accent color; sender attribution lives in the `From "name":` blocks inside the message body, not in the prefix. The link status text in Pi's footer uses `theme.fg("dim", ...)` to match Pi's standard footer styling.
+
+Deliveries sit in the same background panel Pi draws around extension messages by default, indented by your configured output padding, so link messages line up with the rest of the transcript instead of standing outside it.
+
+A long delivery is previewed rather than printed whole. Collapsed, it shows the first six rows as they wrap at the current window width, followed by `... (N more lines, ctrl+o to expand)`; a message that already fits in six rows shows in full with no hint. Expanding is Pi's own global toggle — `Ctrl+O` unless you have rebound `app.tools.expand`, and the hint always names your actual binding — so it expands every custom message at once, including messages restored from an earlier session. If you have unbound `app.tools.expand` entirely there is no key to name, so both hints read `bind app.tools.expand to expand` instead. Only the display changes: the full text is what reaches the model, what `link_send` delivered, and what the session file keeps.
+
+The same toggle also expands outgoing calls: `link_send` and `link_compact` collapse the message or instructions into a one-line preview — runs of whitespace become single spaces — and keep its first 60 characters, which a narrow terminal may still wrap onto more than one row. Expanding reveals the uncollapsed text with its line breaks and spacing as rendered by Pi. Expanding a call says nothing about delivery — the tool's own result line reports that.

package/index.ts

@@ -12,10 +12,12 @@
 
 import {
   VERSION as PI_VERSION,
+  keyHint,
+  keyText,
   type ExtensionAPI,
   type ExtensionContext,
 } from "@earendil-works/pi-coding-agent";
-import { Text } from "@earendil-works/pi-tui";
+import { Box, Text, type Component } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
 import * as crypto from "node:crypto";
 import { createServer, type Server as HttpServer } from "node:http";
@@ -40,6 +42,8 @@ const CONNECT_HANDSHAKE_TIMEOUT_MS = 5_000;
 const FLUSH_DELAY_MS = 200;
 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;
 
 // ─── Protocol ────────────────────────────────────────────────────────────────
 
@@ -151,6 +155,49 @@ function piVersionSupported(version: string): boolean {
   return prerelease === undefined; // exactly the floor: only the release qualifies
 }
 
+// keyText is empty when app.tools.expand has no binding, and the native hint would then
+// read " to expand" with no key in it, naming nothing the reader can press.
+function expansionHint(dim: (text: string) => string): string {
+  return keyText("app.tools.expand")
+    ? keyHint("app.tools.expand", "to expand")
+    : dim("bind app.tools.expand to expand");
+}
+
+/**
+ * The first PREVIEW_ROWS rows of `content`, plus a hint when rows were dropped.
+ *
+ * The rows come from rendering `content` at the real width, not from splitting the
+ * raw string on newlines: one long logical line wraps into many visual rows, and
+ * the same message yields different rows in a narrow window. Rendering is Text's
+ * job here, cached by (text, width), so the preview stays a slice of the identical
+ * output the expanded view shows.
+ */
+function messagePreview(
+  content: Text,
+  dim: (text: string) => string,
+): Component {
+  const hint = new Text("", 0, 0);
+  return {
+    render(width: number): string[] {
+      const rows = content.render(width);
+      if (rows.length <= PREVIEW_ROWS) return rows;
+      // Rebuilt every render so a rebound key is never shown stale; it is one short
+      // line, and Text still caches the content rows, which are the expensive part.
+      hint.setText(
+        dim(`... (${rows.length - PREVIEW_ROWS} more lines, `) +
+          expansionHint(dim) +
+          dim(")"),
+      );
+      // The budget covers content only, so the hint may wrap rather than be cut off.
+      return [...rows.slice(0, PREVIEW_ROWS), ...hint.render(width)];
+    },
+    invalidate(): void {
+      content.invalidate();
+      hint.invalidate();
+    },
+  };
+}
+
 // ─── Extension ───────────────────────────────────────────────────────────────
 
 export default function (pi: ExtensionAPI) {
@@ -1490,8 +1537,19 @@ export default function (pi: ExtensionAPI) {
     return textResult("Not connected to link", { error: "not_connected" });
   }
 
-  function truncatePreview(text: string) {
-    return text.length > 60 ? text.slice(0, 60) + "..." : text;
+  // Collapsed one-line preview for the two outgoing tools. Whitespace is normalized so a
+  // multiline message stays on the tool's single preview line, then clipped to 60
+  // characters. The hint appears only when characters are actually hidden: expanding shows
+  // the original text, so collapsing whitespace alone is not something to advertise.
+  // Styling is applied per segment, like messagePreview above: the hint ends with a
+  // foreground reset, so punctuation appended after it would render undimmed.
+  function truncatePreview(text: string, dim: (text: string) => string) {
+    const preview = text.replace(/\s+/g, " ");
+    return preview.length > 60
+      ? dim(preview.slice(0, 60) + "... (") +
+          expansionHint(dim) +
+          dim(")")
+      : dim(preview);
   }
 
   // Shared "target not found" result for the send/compact tools.
@@ -1566,16 +1624,19 @@ export default function (pi: ExtensionAPI) {
       return textResult(`${verb} ${target}`, { to: params.to });
     },
 
-    renderCall(args, theme) {
+    renderCall(args, theme, context) {
+      const dim = (text: string) => theme.fg("dim", text);
       const preview =
         typeof args.message === "string"
-          ? truncatePreview(args.message)
-          : "...";
+          ? context.expanded
+            ? dim(args.message)
+            : truncatePreview(args.message, dim)
+          : dim("...");
       const text =
         theme.fg("toolTitle", theme.bold("link_send ")) +
         theme.fg("accent", args.to) +
         "\n  " +
-        theme.fg("dim", preview);
+        preview;
       return new Text(text, 0, 0);
     },
 
@@ -1679,11 +1740,16 @@ export default function (pi: ExtensionAPI) {
       });
     },
 
-    renderCall(args, theme) {
+    renderCall(args, theme, context) {
       let text = theme.fg("toolTitle", theme.bold("link_compact "));
       text += theme.fg("accent", String(args.to));
+      const dim = (t: string) => theme.fg("dim", t);
       if (typeof args.instructions === "string")
-        text += "\n  " + theme.fg("dim", truncatePreview(args.instructions));
+        text +=
+          "\n  " +
+          (context.expanded
+            ? dim(args.instructions)
+            : truncatePreview(args.instructions, dim));
       return new Text(text, 0, 0);
     },
 
@@ -1915,12 +1981,22 @@ export default function (pi: ExtensionAPI) {
 
   // ── Message renderer ─────────────────────────────────────────────────────
 
-  pi.registerMessageRenderer("link", (message, _options, theme) => {
+  pi.registerMessageRenderer("link", (message, options, theme) => {
     const from =
       (message.details as Record<string, unknown> | undefined)?.from ?? "link";
     const text =
       theme.fg("accent", `⚡ [${from}] `) +
       theme.fg("text", String(message.content));
-    return new Text(text, 0, 0);
+    const content = new Text(text, 0, 0);
+    // The same panel Pi draws around extension messages by default: returning our own
+    // component bypasses the host's box, so a link message would otherwise sit unframed
+    // among framed ones. `outputPad` is the user's configured output padding.
+    const box = new Box(options.outputPad, 1, (t) => theme.bg("customMessageBg", t));
+    box.addChild(
+      options.expanded
+        ? content
+        : messagePreview(content, (s) => theme.fg("muted", s)),
+    );
+    return box;
   });
 }

package/package.json

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