agent-repl 0.1.0 → 0.1.3

package/CHANGELOG.md

@@ -4,6 +4,34 @@ All notable changes to `agent-repl` are documented here.
 
 ## [Unreleased]
 
+## [0.1.3] — 2026-10-19
+
+### Changed
+- Generated from pi-repl 0.8.4.
+
+### Fixed
+- In the Summary and Full displays, output that doesn't end its line no longer runs into the done marker in Python, IPython, Julia, R and Clojure. The marker then stayed in the clean output, as in `c── done · id: … ──`.
+
+## [0.1.2] — 2026-10-19
+
+### Changed
+- Generated from pi-repl 0.8.3.
+
+### Fixed
+- agent-repl works when the locale is not UTF-8, for example with `LANG` unset. Commands and tools failed with "no panes found", because tmux printed the tabs in its pane listings as `_`.
+
+## [0.1.1] — 2026-10-19
+
+### Changed
+- Generated from pi-repl 0.8.2.
+
+### Fixed
+- `agent-repl stop` no longer refuses to run on macOS when a process of `nobody` (uid -2) is running.
+- IPython shows an expression's value once, as `Out[N]: …`. It used to be printed again as a bare `repr`.
+
+### Documentation
+- Set `PI_REPL_AGENT_LABEL` in the OpenCode configuration example: OpenCode 2 identifies itself to MCP servers only as `cli`.
+
 ## [0.1.0] — 2026-09-25
 
 First public release.

package/README.md

@@ -73,7 +73,12 @@ codex mcp add agent-repl -- agent-repl mcp
 ```json
 {
   "mcp": {
-    "agent-repl": { "type": "local", "command": ["agent-repl", "mcp"], "enabled": true }
+    "agent-repl": {
+      "type": "local",
+      "command": ["agent-repl", "mcp"],
+      "environment": { "PI_REPL_AGENT_LABEL": "OpenCode" },
+      "enabled": true
+    }
   }
 }
 ```
@@ -125,7 +130,7 @@ An agent can also pass `echoMode` for a single `repl_send`. Full mode keeps long
 
 ## Agent names in the record
 
-Entries in the clean record, and in `agent-repl export`, are labelled with the name the agent gives when it connects: `Claude Code`, `Codex` or `OpenCode`, or the raw client name for other agents. To choose the label yourself, set `PI_REPL_AGENT_LABEL` in the server's environment, as for the echo setting. Submissions from Pi are labelled `Pi`.
+Entries in the clean record, and in `agent-repl export`, are labelled with the name the agent gives when it connects: `Claude Code` and `Codex` name themselves, and other agents are labelled with whatever name they send. To choose the label yourself, set `PI_REPL_AGENT_LABEL` in the server's environment, as for the echo setting. OpenCode 2 identifies itself only as `cli`, so the OpenCode configuration above sets the label. Submissions from Pi are labelled `Pi`.
 
 ## Privacy and safety
 

package/dist/pi-repl.js

@@ -1,4 +1,4 @@
-// GENERATED by scripts/sync-from-pi-repl.mjs from pi-repl 0.8.1 (0926b0b). Do not edit by hand:
+// GENERATED by scripts/sync-from-pi-repl.mjs from pi-repl 0.8.4 (6d9234a). Do not edit by hand:
 // change pi-repl and re-sync. Identical to pi-repl's index.ts except that its Pi
 // imports come from ./pi-compat/index.js.
 import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, truncateHead, truncateTail, } from "./pi-compat/index.js";
@@ -459,7 +459,9 @@ async function commandExists(pi, command, cwd) {
     }
 }
 async function execTmux(pi, args, cwd, timeout = 5_000) {
-    const result = await pi.exec("tmux", args, { cwd, timeout });
+    // Unless the locale is UTF-8 (LANG is unset in some terminals), tmux prints
+    // the tabs in -F output as `_`; -u keeps them, so pane listings parse.
+    const result = await pi.exec("tmux", ["-u", ...args], { cwd, timeout });
     return {
         code: result.code ?? 1,
         stdout: result.stdout ?? "",
@@ -885,9 +887,34 @@ function buildClojureDisplayStatements(display, indent = "") {
         return [];
     return display.prefixLines.map((line) => `${indent}(clojure.core/println ${JSON.stringify(line)})`);
 }
+// Prints the pane's cursor column, or exits non-zero; tmux gets 500 ms. A
+// wrapper runs it with Node and ends a line before its footer unless it
+// prints 0. Only the wrapper reads its output, so it never reaches the pane.
+const CURSOR_COLUMN_QUERY = 'try { process.stdout.write(require("node:child_process").execFileSync("tmux", ["-N", "display-message", "-p", "-t", process.env.TMUX_PANE, "#{cursor_x}"], { encoding: "utf8", timeout: 500, killSignal: "SIGKILL", maxBuffer: 128, stdio: ["ignore", "pipe", "ignore"] }).trim()); } catch { process.exitCode = 1; }';
+function buildPythonFooter(display) {
+    if (!display.enabled)
+        return [];
+    return [
+        "    import subprocess as __pi_repl_subprocess",
+        "    import sys as __pi_repl_sys",
+        "    __pi_repl_column = ''",
+        "    try:",
+        "        __pi_repl_sys.stdout.flush()",
+        "        __pi_repl_sys.stderr.flush()",
+        `        __pi_repl_query = __pi_repl_subprocess.run([${JSON.stringify(process.execPath)}, '-e', ${JSON.stringify(CURSOR_COLUMN_QUERY)}], stdin=__pi_repl_subprocess.DEVNULL, stdout=__pi_repl_subprocess.PIPE, stderr=__pi_repl_subprocess.DEVNULL, timeout=5)`,
+        "        if __pi_repl_query.returncode == 0:",
+        "            __pi_repl_column = __pi_repl_query.stdout.decode('utf-8', 'replace').strip()",
+        // run() kills the query on any exception. Ctrl-C here must not skip the done file.
+        "    except BaseException:",
+        "        pass",
+        "    if __pi_repl_column != '0':",
+        "        __pi_repl_builtins.print()",
+        ...display.suffixLines.map((line) => `    __pi_repl_builtins.print(${JSON.stringify(line)})`),
+    ];
+}
 function buildPythonControlSource(runtime, code, doneFile, display) {
     const prefix = buildPythonDisplayStatements(display);
-    const completion = display.suffixLines.map((line) => `    __pi_repl_builtins.print(${JSON.stringify(line)})`);
+    const completion = buildPythonFooter(display);
     if (runtime === "ipython") {
         return [
             "from pathlib import Path as __pi_repl_path",
@@ -898,9 +925,8 @@ function buildPythonControlSource(runtime, code, doneFile, display) {
             "    __pi_repl_ip = get_ipython()",
             "    if __pi_repl_ip is None:",
             "        raise RuntimeError('Expected IPython session, but get_ipython() returned None.')",
-            `    __pi_repl_result = __pi_repl_ip.run_cell(${JSON.stringify(code)}, store_history=False)`,
-            "    if getattr(__pi_repl_result, 'error_in_exec', None) is None and getattr(__pi_repl_result, 'result', None) is not None:",
-            "        print(repr(__pi_repl_result.result))",
+            // run_cell shows the value itself (Out[N]: ...), so nothing more is printed here.
+            `    __pi_repl_ip.run_cell(${JSON.stringify(code)}, store_history=False)`,
             "except Exception:",
             "    __pi_repl_traceback.print_exc()",
             "finally:",
@@ -922,8 +948,25 @@ function buildPythonControlSource(runtime, code, doneFile, display) {
         `    __pi_repl_path(${JSON.stringify(doneFile)}).write_text('done\\n', encoding='utf-8')`,
     ].join("\n");
 }
+function buildJuliaFooter(display) {
+    if (!display.enabled)
+        return [];
+    const query = `Cmd([${juliaStringLiteral(process.execPath)}, "-e", ${juliaStringLiteral(CURSOR_COLUMN_QUERY)}])`;
+    return [
+        '    local __pi_repl_column = ""',
+        // read throws if the query fails; catch also takes an interrupt here.
+        "    try",
+        "        flush(stdout)",
+        "        flush(stderr)",
+        `        __pi_repl_column = strip(read(pipeline(${query}, stdin=devnull, stderr=devnull), String))`,
+        "    catch",
+        "    end",
+        '    __pi_repl_column == "0" || Base.println()',
+        ...display.suffixLines.map((line) => `    Base.println(${juliaStringLiteral(line)})`),
+    ];
+}
 function buildJuliaControlSource(code, doneFile, display) {
-    const completion = display.suffixLines.map((line) => `    Base.println(${juliaStringLiteral(line)})`);
+    const completion = buildJuliaFooter(display);
     return [
         ...buildJuliaDisplayStatements(display),
         "try",
@@ -939,8 +982,20 @@ function buildJuliaControlSource(code, doneFile, display) {
         "end",
     ].join("\n");
 }
+function buildRFooter(display) {
+    if (!display.enabled)
+        return [];
+    return [
+        "    try({ flush(stdout()); flush(stderr()) }, silent = TRUE)",
+        // system2 quotes the command but not its arguments. A failed query
+        // sets a status; an error or Ctrl-C here gives NULL, not a lost done file.
+        `    .__pi_repl_column <- tryCatch(suppressWarnings(system2(${JSON.stringify(process.execPath)}, c("-e", ${JSON.stringify(shellQuote(CURSOR_COLUMN_QUERY))}), stdout = TRUE, stderr = FALSE)), error = function(e) NULL, interrupt = function(e) NULL)`,
+        '    if (!is.null(attr(.__pi_repl_column, "status")) || !identical(trimws(paste(.__pi_repl_column, collapse = "")), "0")) base::cat("\\n")',
+        ...display.suffixLines.map((line) => `    base::cat(${JSON.stringify(`${line}\n`)})`),
+    ];
+}
 function buildRControlSource(code, doneFile, display) {
-    const completion = display.suffixLines.map((line) => `    base::cat(${JSON.stringify(`${line}\n`)})`);
+    const completion = buildRFooter(display);
     return [
         "local({",
         ...buildRDisplayStatements(display, "  "),
@@ -1064,8 +1119,33 @@ function buildJavaControlSource(code, doneFile, display) {
     // stays in the outer driver, outside this source file's parser state.
     return [...prefix, code.replace(/\r/g, "").trimEnd(), ""].join("\n");
 }
+function buildClojureFooter(display) {
+    if (!display.enabled)
+        return [];
+    const builder = `(java.lang.ProcessBuilder. ^java.util.List [${JSON.stringify(process.execPath)} "-e" ${JSON.stringify(CURSOR_COLUMN_QUERY)}])`;
+    return [
+        "      (try (.flush *out*) (.flush *err*) (catch Throwable _))",
+        // An interrupt left pending by the code would end the wait at once, so
+        // it is cleared for the query and restored afterwards, as is one that
+        // arrives during the wait. The query is killed on every path.
+        "      (let [pi-repl-interrupted (volatile! (Thread/interrupted))",
+        `            pi-repl-query (try (.start (.redirectError ${builder} java.lang.ProcessBuilder$Redirect/DISCARD)) (catch Throwable _ nil))`,
+        "            pi-repl-column (when pi-repl-query",
+        "                             (try",
+        "                               (.close (.getOutputStream pi-repl-query))",
+        "                               (when (and (.waitFor pi-repl-query 5 java.util.concurrent.TimeUnit/SECONDS) (zero? (.exitValue pi-repl-query)))",
+        "                                 (.trim ^String (slurp (.getInputStream pi-repl-query))))",
+        "                               (catch InterruptedException _ (vreset! pi-repl-interrupted true) nil)",
+        "                               (catch Throwable _ nil)",
+        "                               (finally (.destroyForcibly pi-repl-query))))]",
+        "        (when @pi-repl-interrupted (.interrupt (Thread/currentThread)))",
+        '        (when-not (= pi-repl-column "0") (clojure.core/println))',
+        ...display.suffixLines.map((line) => `        (clojure.core/println ${JSON.stringify(line)})`),
+        "        nil)",
+    ];
+}
 function buildClojureControlSource(code, doneFile, display) {
-    const completion = display.suffixLines.map((line) => `      (clojure.core/println ${JSON.stringify(line)})`);
+    const completion = buildClojureFooter(display);
     return [
         "(let [code " + JSON.stringify(code) + "]",
         ...buildClojureDisplayStatements(display, "  "),

package/dist/shared/repl-session-stop.js

@@ -12,7 +12,8 @@ const paneFormat = "#{pid}\t#{session_id}\t#{session_name}\t#{session_created}\t
 export function parseStopProcessTable(text) {
 	return text.split("\n").filter((line) => line.trim()).map((line) => {
 		const f = line.trim().split(/\s+/);
-		if (f.length !== 11 || !f.slice(0, 4).every((v) => /^\d+$/.test(v) && Number.isSafeInteger(Number(v)))) throw new Error("Could not parse process ownership data; refusing unsafe shutdown.");
+		// macOS lists processes of `nobody` with uid -2; it never matches ours.
+		if (f.length !== 11 || !f.slice(0, 4).every((v, i) => (i === 3 ? /^-?\d+$/ : /^\d+$/).test(v) && Number.isSafeInteger(Number(v)))) throw new Error("Could not parse process ownership data; refusing unsafe shutdown.");
 		return { pid: Number(f[0]), ppid: Number(f[1]), pgid: Number(f[2]), uid: Number(f[3]), tty: f[4], startedAt: f.slice(5, 10).join(" "), state: f[10] };
 	});
 }
@@ -152,9 +153,16 @@ export class SessionStopProcesses {
 	}
 }
 
-/** Explicit stop only. Never used by send, startup, reload, or shutdown hooks. */
-export async function stopVerifiedReplSession({ tmux, sessionName, snapshot = readStopProcessTable, signal = (pid, value) => process.kill(pid, value), currentPid = process.pid, uid = process.getuid?.(), graceMs = 500, termMs = 1000, killMs = 2000, findMarked = findOwnedGnuplotProcesses, snapshotSockets = snapshotGnuplotSockets, cleanupSockets = cleanupGnuplotSockets }) {
-	if (typeof uid !== "number" || !/^pi-repl-(python|julia|r|ghci|clojure|ruby|java|octave|matlab|gnuplot|cpp)$/.test(sessionName)) throw new Error("Verified REPL shutdown requires a supported local Unix session.");
+export const PI_REPL_STOP_SESSION_NAME = /^pi-repl-(python|julia|r|ghci|clojure|ruby|java|octave|matlab|gnuplot|cpp)$/;
+
+/**
+ * Explicit stop only. Never used by send, startup, reload, or shutdown hooks.
+ * sessionNamePattern names the sessions this host owns; pi-studio passes its own.
+ */
+export async function stopVerifiedReplSession({ tmux, sessionName, sessionNamePattern = PI_REPL_STOP_SESSION_NAME, snapshot = readStopProcessTable, signal = (pid, value) => process.kill(pid, value), currentPid = process.pid, uid = process.getuid?.(), graceMs = 500, termMs = 1000, killMs = 2000, findMarked = findOwnedGnuplotProcesses, snapshotSockets = snapshotGnuplotSockets, cleanupSockets = cleanupGnuplotSockets }) {
+	// A global or sticky pattern keeps state between tests; refuse it rather than misjudge a name.
+	if (!(sessionNamePattern instanceof RegExp) || sessionNamePattern.global || sessionNamePattern.sticky) throw new Error("Verified REPL shutdown needs a plain session-name pattern.");
+	if (typeof uid !== "number" || typeof sessionName !== "string" || !sessionNamePattern.test(sessionName)) throw new Error("Verified REPL shutdown requires a supported local Unix session.");
 	const panes = await readPanes(tmux);
 	const selected = panes.filter((p) => p.sessionName === sessionName);
 	if (!selected.length) throw new Error("The selected session ended or changed before shutdown; no processes were signalled.");

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "agent-repl",
-	"version": "0.1.0",
+	"version": "0.1.3",
 	"description": "pi-repl's shared tmux REPLs (Python, Julia, R and more) for Claude Code, Codex, OpenCode and other agents, over MCP and a CLI.",
 	"keywords": [
 		"repl",