agent-repl 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -4,6 +4,26 @@ All notable changes to `agent-repl` are documented here.
 
 ## [Unreleased]
 
+## [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.3 (45b5042). 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 ?? "",
@@ -898,9 +900,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:",

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.2",
 	"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",