agentp 0.4.0 → 0.5.0

package/AGENTS.md

@@ -1,23 +1,56 @@
 # agentp — agent notes
 
-## Two binaries, both registered
+## Three binaries, all registered
 
 - `bin/agentp` (Node.js) — registered in `package.json` `"bin"` — pipes stdin → opencode TUI
 - `bin/ocmux` (Node.js) — registered in `package.json` `"bin"` — manages opencode tmux sessions
+- `bin/tgagentp` (Node.js) — registered in `package.json` `"bin"` — bridges Telegram bot ↔ opencode TUI
 
 ## Package facts
 
-- **Zero npm dependencies.** Both scripts use only Node.js stdlib (`http`, `readline`, `url`, `child_process`, `fs`, `path`, `crypto`, `os`).
+- **Zero npm dependencies.** All scripts use only Node.js stdlib (`http`, `https`, `readline`, `url`, `child_process`, `fs`, `path`, `crypto`, `os`).
 - **No tests, no CI, no lint, no formatter.** `npm test` is a stub that exits 1.
 - **No lockfile.** Versions resolve at install time.
 - **`"type": "commonjs"`**, requires Node >= 18.
-- **Linux and macOS compatible.** Both tools use portable Node.js APIs only.
+- **Linux and macOS compatible.** All tools use portable Node.js APIs only.
 
 ## `.ocmux.json`
 
 Runtime state file created by `bin/ocmux` (contains URL, log path, and window index). **Not in `.gitignore`** — avoid committing it.
 
-## OpenCode HTTP protocol (agentp)
+## Shared `lib/opencode.js`
+
+Extracted from `bin/agentp`; used by both `agentp` and `tgagentp`:
+
+- `getAuthHeaders()` — reads `OPENCODE_SERVER_PASSWORD` / `OPENCODE_SERVER_USERNAME`
+- `makeRequest(options, data)` — thin `http.request` wrapper returning a Promise
+- `buildJsonRequest(url, method, body)` — builds request options for JSON POST/GET (no Content-Type/Length for bodyless requests)
+- `clearPrompt(server)`, `appendPrompt(server, text)`, `submitPrompt(server)` — TUI prompt endpoints
+- `sendText(server, text)` — convenience: clear + append + submit in one call
+- `listenForFinalAnswer(server, onText?, cancelRef?)` — SSE event stream listener; `cancelRef` allows true server-side abort via `req.destroy()`
+- `listSessions(server, directory?)` — `GET /session`; returns parsed JSON array; optional `?directory=` filter
+- `createSession(server, title?)` — `POST /session`; returns the created `Session` object; optional `title`
+- `updateSession(server, sessionId, title)` — `PATCH /session/:id`; returns the updated `Session` object
+- `sendToSession(server, sessionId, text, agent?)` — `POST /session/:id/message`; returns concatenated text parts from response; optional `agent` to handle the message
+- `selectSession(server, sessionId)` — `POST /session/:id/select`; tells the TUI to navigate to the given session (silently ignores 404 if the endpoint isn't available in older opencode versions)
+- `listAgents(server)` — `GET /agent`; returns parsed JSON array of agent objects
+- `listProviders(server)` — `GET /provider`; returns parsed JSON array of provider objects
+
+## Shared `lib/ocmux.js`
+
+Shared ocmux session discovery; used by both `bin/ocmux` and `bin/tgagentp`:
+
+- `readState(file)` — parses `.ocmux.json`, returns `null` on error
+- `statefileFor(dir)` — `path.join(dir, '.ocmux.json')`
+- `tuiPaneId(windowIndex)` — returns pane ID if TUI process (`node`) is running, `null` if dead
+- `windowByDir(dir)` — returns window index by name match
+- `windowNameByIndex(idx)` — reverse: name from index
+- `activeWindowIndex()` — returns index of currently selected tmux window
+- `paneCount(windowIndex)` — number of panes in a window
+- `listServers()` — scans all tmux windows for `.ocmux.json` state files; returns `{ url, dir, index, status }` array
+- `activateServer(dir, index, url)` — pin window name, restart dead TUI pane, select window, zoom pane
+
+## OpenCode HTTP protocol
 
 These endpoints are consumed but not documented elsewhere in the repo:
 
@@ -25,24 +58,83 @@ These endpoints are consumed but not documented elsewhere in the repo:
 - `POST /tui/append-prompt`
 - `POST /tui/submit-prompt`
 - `GET /event` (SSE stream)
+- `GET /session` — list sessions (optional `?directory=` filter)
+- `POST /session` — create a new session (optional `{ title? }` body)
+- `PATCH /session/:id` — update session properties (`{ title }`)
+- `POST /session/:id/select` — tell the TUI to navigate to a session (only with TUI attached)
+- `POST /session/:id/message` — send message to session (returns parts synchronously; optional `agent` field)
+- `GET /agent` — list available agents
+- `GET /provider` — list connected providers/models
 
 ## OpenCode tmux session model (ocmux)
 
 - Single tmux session named `"Opencode"`
 - Windows named by full project directory path
-- Server pane runs `opencode serve --port 0`, TUI pane runs `opencode attach --continue`
+- Server pane runs `opencode serve --port 0` (via send-keys → interactive shell for env var support), TUI pane runs `opencode attach --continue`
+- Log file per project: `/tmp/opencode-serve-<hashDir(dir)>.log` — captured via `tee`, read by ocmux polling loop
 - Per-project `.ocmux.json` with upward directory search (git-like)
-- Auto-restarts dead TUI panes on switch
+- Auto-restarts dead TUI panes on switch (respawn-pane or split-window)
 - Auto-zooms TUI pane on switch/create
 
 ## Commands
 
 | Command | What |
-|---|---|
+|---|---|---|
 | `npm link` | local dev install |
 | `npm install -g .` | alternative local install |
 | `agentp [--qa] [port]` | pipe stdin → opencode TUI, stream answer to stdout |
-| `ocmux new [dir]` | start opencode serve in a tmux window |
+| `tgagentp [port]` | bridge Telegram bot ↔ opencode TUI (needs `TELEGRAM_BOT_TOKEN`) |
+| `tgagentp --dev` | enable `/shutdown` command for remote restart |
+| `ocmux serve [dir]` | start opencode serve in a tmux window (primary verb) |
+| `ocmux new [dir]` | alias for `serve` (backwards compat, to be removed in 1.0) |
 | `ocmux kill [dir]` | kill server + tmux window |
 | `ocmux list [-l]` | list running servers |
 | `ocmux [dir]` | switch to existing opencode tmux window |
+
+## TODO
+
+### Pending
+
+*(none)*
+
+### Done
+
+- /agents switch <name> — switch active agent on the active session
+- /sessions new [name] — create a new session, TUI follows via /session/:id/select
+- /sessions rename <name> — rename the current active session
+- Merge /session into /sessions (keep /session as alias)
+- Case-insensitive matching for all switch subcommands (/servers, /sessions, /agents)
+- Fix: /sessions filter includes sessions with directory (TUI sessions) + active session exception
+- Fix: /sessions now shows the active session even without agent set (exception in filter)
+- Fix: /sessions switch and /sessions new call selectSession (TUI navigation doesn't work — see With Issues)
+- Fix: active session highlighted with ▶ bullet in session list
+- Message splitting (>4096 chars, breaks at newlines)
+- lib/ocmux.js shared session discovery, refactor ocmux + tgagentp
+- /cancel with true server-side SSE abort via cancelRef
+- /shutdown (--dev mode) with Telegram offset acknowledgment
+
+### With Issues
+
+- `/sessions switch` and `/sessions new` — `selectSession` tries `POST /session/:id/select` and `POST /tui/select-session` but the TUI pane doesn't navigate to the session. Message routing (via `activeSessionId` + `sendToSession`) works correctly in the background. This is a known limitation — the TUI must be navigated manually to see the conversation in the UI. The underlying opencode API may lack the needed TUI navigation endpoints.
+
+### Verified
+
+- Password auth support (OPENCODE_SERVER_PASSWORD) for agentp, ocmux, tgagentp
+- agentp HTTP Basic Auth headers on all requests (POST and SSE)
+- agentp clear 401 error reporting
+- ocmux interactive shells (send-keys) for env var propagation
+- tgagentp Telegram bridge bot with long-polling
+- Markdown→HTML converter (**bold**, *italic*, `code`, code blocks, headings, tables)
+- Chat allowlist (TGAGENTP_ALLOWED_CHAT_IDS)
+- Slash command system (/help, /servers, /sessions, /session, /agents, /agents switch, /models, /status, /cancel, /shutdown)
+- Per-server state tracking (busy/idle, pendingResponse, activeSessionId, activeAgentName, taskId)
+- Background async processing (non-commands fire without await)
+- /servers switch activates tmux window (pin, restart TUI, select, zoom)
+- Startup greeting with /status-style info persisted via temp file
+- Fix port mismatch bug: truncate stale log file before send-keys in doNew
+- Update README with full tgagentp features (slash commands, --dev, env vars)
+- Update AGENTS.md with lib/ocmux.js, missing API endpoints, current architecture
+- Single-user lock: first chat to connect owns the session
+- Fix startup greeting markdown not being converted to HTML
+
+*(Keep this TODO up to date: move items between categories as their status changes.)*

package/CHANGELOG.md

@@ -5,6 +5,8 @@ All notable changes to this project will be documented in this file.
 ## [Unreleased]
 
 - Rename package and CLI command from `aprompt` to `agentp`.
+- Extract shared OpenCode client logic into `lib/opencode.js`.
+- Add `tgagentp` — bridge a Telegram bot chat with an OpenCode TUI session.
 
 ## [0.1.0] - 2026-05-08
 

package/README.md

@@ -5,10 +5,11 @@
 [![npm downloads](https://img.shields.io/npm/dm/agentp.svg)](https://www.npmjs.com/package/agentp)
 [![node version](https://img.shields.io/node/v/agentp.svg)](https://www.npmjs.com/package/agentp)
 
-This package provides two CLI tools:
+This package provides three CLI tools:
 
 - **`agentp`** — pipes prompt text into a running OpenCode TUI session and streams the assistant final answer back to stdout
 - **`ocmux`** — manages OpenCode server + TUI sessions in tmux (create, switch, kill, list)
+- **`tgagentp`** — bridges a Telegram bot chat with all running OpenCode TUI sessions (receives messages from Telegram, routes them to the active server, sends answers back). Supports slash commands for multi-server management, session switching, agent/model listing, and remote restart.
 
 It is designed for prompt-driven workflows where you want to do things like:
 
@@ -122,7 +123,7 @@ Without arguments, searches upward from `<directory>` (default: `$PWD`) for `.oc
 
 Subcommands:
 
-- **`serve [--git|--GIT] [dir]`** — Create a server in `dir` (default: `$PWD`) and attach a TUI pane. Aliased as `new` for backwards compatibility. Errors if one already exists there. Warns if a parent directory already has a server.
+- **`serve [--git|--GIT] [dir]`** — Create a server in `dir` (default: `$PWD`) and attach a TUI pane. Aliased as `new` for backwards compatibility (to be removed in 1.0). Errors if one already exists there. Warns if a parent directory already has a server.
   - `--git` resolves `dir` to the nearest parent with a `.git` entry (file or dir); errors if none is found.
   - `--GIT` resolves `dir` to the nearest parent with a `.git` directory only; errors if none is found.
 - **`kill [dir]`** — Kill the server found upward from `dir`. Removes its tmux window and state file.
@@ -162,6 +163,70 @@ Operational hint:
 
 - You can keep a separate `opencode attach` view open to see the full run context while `agentp` is used from shell scripts or editor buffers.
 
+## tgagentp
+
+Bridge a Telegram bot chat with OpenCode TUI sessions managed by `ocmux`.
+
+```bash
+tgagentp [options]
+```
+
+Keeps running indefinitely. On each text message from Telegram it:
+
+1. Routes non-command messages to the current active server's TUI (same protocol as `agentp`).
+2. Waits for the assistant to finish (background async — commands remain responsive).
+3. Sends the full answer back to the same Telegram chat.
+
+Non-text Telegram updates (photos, stickers, etc.) are silently ignored.
+
+### Slash commands
+
+| Command | Action |
+|---|---|
+| `/help [topic]` | Show general help or help for a topic (`servers`, `sessions`, `agents`, `models`) |
+| `/servers` | List all running ocmux-served projects with URL + status (✅ idle / ⏳ busy) |
+| `/servers switch <name>` | Switch active server; matches by full path, basename, or substring |
+| `/sessions` | List recent sessions for the current server (max 50, with date headings) |
+| `/sessions switch <number\|name>` | Switch active session by position or partial name match |
+| `/agents` | List available agents (name, mode, model, description) |
+| `/models` | List connected providers with model counts, context limits, and costs |
+| `/status` | Show current server path, URL, busy status, and active session |
+| `/cancel` | Cancel the current AI response for the active server |
+| `/shutdown` | (requires `--dev`) Stop tgagentp gracefully; acknowledge offset and exit |
+
+### Per-server state
+
+`tgagentp` tracks state independently per server URL: busy/idle status, pending response, active session ID, and cancellation token. Switching servers while one is busy stores the answer as pending — switching back delivers it.
+
+### Setup
+
+1. Create a bot with [@BotFather](https://t.me/BotFather) on Telegram and copy the token.
+2. Export the token and start `tgagentp`:
+
+```bash
+export TELEGRAM_BOT_TOKEN="your-bot-token-here"
+tgagentp
+```
+
+### Options
+
+- `--version`: show version
+- `--help`: show help message
+- `--dev`: enable `/shutdown` command for remote restart (run via `while true; do tgagentp --dev; done`)
+
+### Telemetry
+
+A startup greeting is sent to the last known chat on boot — includes /status-style server info. The chat ID is persisted at `/tmp/tgagentp-startup-chat`.
+
+### Environment variables
+
+| Variable | Description |
+|---|---|
+| `TELEGRAM_BOT_TOKEN` | **Required.** Telegram bot token from @BotFather. |
+| `OPENCODE_SERVER_PASSWORD` | Optional. OpenCode server HTTP Basic Auth password. |
+| `OPENCODE_SERVER_USERNAME` | Optional. OpenCode server username (default: `opencode`). |
+| `TGAGENTP_ALLOWED_CHAT_IDS` | Optional. Comma-separated Telegram chat IDs that are allowed to use the bot. |
+
 ## License
 
 MIT

package/bin/agentp

@@ -1,73 +1,19 @@
 #!/usr/bin/env node
 
-const http = require('http');
-const { URL } = require('url');
+const readline = require('readline');
 const { version } = require('../package.json');
-
-function getAuthHeaders() {
-  const password = process.env.OPENCODE_SERVER_PASSWORD;
-  if (!password) return {};
-  const username = process.env.OPENCODE_SERVER_USERNAME || 'opencode';
-  const encoded = Buffer.from(`${username}:${password}`).toString('base64');
-  return { 'Authorization': `Basic ${encoded}` };
-}
-
-function makeRequest(options, data) {
-  return new Promise((resolve, reject) => {
-    const req = http.request(options, (res) => {
-      let body = '';
-      res.on('data', (chunk) => { body += chunk; });
-      res.on('end', () => {
-        if (res.statusCode === 401) {
-          reject(new Error('OpenCode server authentication failed. Set OPENCODE_SERVER_PASSWORD to match the server password.'));
-        } else {
-          resolve({ status: res.statusCode, body });
-        }
-      });
-    });
-    req.on('error', reject);
-    if (data) req.write(data);
-    req.end();
-  });
-}
-
-function buildJsonRequest(url, method, body) {
-  const parsed = new URL(url);
-  return {
-    hostname: parsed.hostname,
-    port: parsed.port,
-    path: parsed.pathname,
-    method: method,
-    headers: {
-      'Content-Type': 'application/json',
-      'Content-Length': Buffer.byteLength(body),
-      ...getAuthHeaders()
-    }
-  };
-}
-
-async function clearPrompt(server) {
-  const url = `${server}/tui/clear-prompt`;
-  await makeRequest(buildJsonRequest(url, 'POST', '{}'), '{}');
-}
-
-async function appendPrompt(server, text) {
-  const url = `${server}/tui/append-prompt`;
-  const body = JSON.stringify({ text });
-  await makeRequest(buildJsonRequest(url, 'POST', body), body);
-}
-
-async function submitPrompt(server) {
-  const url = `${server}/tui/submit-prompt`;
-  await makeRequest(buildJsonRequest(url, 'POST', '{}'), '{}');
-}
+const {
+  clearPrompt,
+  appendPrompt,
+  submitPrompt,
+  listenForFinalAnswer,
+} = require('../lib/opencode');
 
 async function sendPrompt(server) {
   let promptText = '';
 
   await clearPrompt(server);
 
-  const readline = require('readline');
   const rl = readline.createInterface({ input: process.stdin });
 
   for await (const line of rl) {
@@ -85,94 +31,6 @@ const HUMAN_ROW = '👤: ￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣
 const AGENT_ROW = '🤖: ￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣\n'
 const FINAL_ROW = '￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣\n';
 
-function listenForFinalAnswer(server, showFinalRow) {
-  return new Promise((resolve, reject) => {
-    const url = `${server}/event`;
-    const parsed = new URL(url);
-
-    const req = http.request({
-      hostname: parsed.hostname,
-      port: parsed.port,
-      path: parsed.pathname,
-      method: 'GET',
-      headers: { 'Accept': 'text/event-stream', ...getAuthHeaders() }
-    }, (res) => {
-      if (res.statusCode === 401) {
-        res.resume();
-        reject(new Error('OpenCode server authentication failed. Set OPENCODE_SERVER_PASSWORD to match the server password.'));
-        return;
-      }
-      let buffer = '';
-      const userMessageIDs = new Set();
-
-      res.on('data', (chunk) => {
-        buffer += chunk.toString();
-
-        // Split by double newline (SSE event separator)
-        while (buffer.includes('\n\n')) {
-          const eventEnd = buffer.indexOf('\n\n');
-          const eventData = buffer.slice(0, eventEnd);
-          buffer = buffer.slice(eventEnd + 2);
-
-          // Extract data lines
-          const lines = eventData.split('\n');
-
-          let jsonStr = '';
-
-          for (const line of lines) {
-            if (line.startsWith('data: ')) {
-              jsonStr += line.slice(6);
-            }
-          }
-
-          if (!jsonStr.trim()) continue;
-
-          try {
-            const event = JSON.parse(jsonStr);
-
-            // Track user message IDs
-            if (event.type === 'message.updated' && event.properties?.info?.role === 'user') {
-              userMessageIDs.add(event.properties.info.id);
-            }
-
-            // Check for session.idle to detect completion
-            if (event.type === 'session.idle') {
-              process.stdout.write('\n');
-              if (showFinalRow) {
-                process.stdout.write(`${FINAL_ROW}`);
-              }
-              req.destroy();
-              res.destroy();
-              resolve();
-              return;
-            }
-
-            const part = event.properties?.part;
-            if (!part) continue;
-
-            // Filter out user input by checking messageID
-            if (part.messageID && userMessageIDs.has(part.messageID)) {
-              continue;
-            }
-
-            if (part.type === 'text' && part.text != null && part.text !== '') {
-              process.stdout.write(part.text);
-            }
-          } catch (e) {
-          }
-        }
-      });
-
-      res.on('end', () => {
-        resolve();
-      });
-    });
-
-    req.on('error', reject);
-    req.end();
-  });
-}
-
 async function main() {
   let serverBase = 'http://localhost:4096';
   let qaMode = false;
@@ -221,7 +79,11 @@ async function main() {
     process.stdout.write(AGENT_ROW);
   }
 
-  await listenForFinalAnswer(serverBase, qaMode);
+  await listenForFinalAnswer(serverBase, (chunk) => process.stdout.write(chunk));
+  process.stdout.write('\n');
+  if (qaMode) {
+    process.stdout.write(FINAL_ROW);
+  }
 
   if (!process.env.OPENCODE_SERVER_PASSWORD) {
     process.stderr.write('\n');

package/bin/ocmux

@@ -6,6 +6,16 @@ const crypto = require('crypto');
 const readline = require('readline');
 const { spawnSync, execSync } = require('child_process');
 const os = require('os');
+const {
+  readState,
+  statefileFor,
+  tuiPaneId,
+  windowByDir,
+  windowNameByIndex,
+  activeWindowIndex,
+  paneCount,
+  listServers,
+} = require('../lib/ocmux');
 
 // ---------------------------------------------------------------------------
 // Constants
@@ -43,18 +53,6 @@ function logfileFor(dir) {
   return `/tmp/opencode-serve-${hashDir(dir)}.log`;
 }
 
-function statefileFor(dir) {
-  return path.join(dir, '.ocmux.json');
-}
-
-function readState(file) {
-  try {
-    return JSON.parse(fs.readFileSync(file, 'utf8'));
-  } catch {
-    return null;
-  }
-}
-
 function findParentStatefile(startDir) {
   let dir = path.resolve(startDir);
   while (true) {
@@ -112,52 +110,6 @@ function resolveGitDir(startDir, requireDir, flagLabel) {
   return result.dir;
 }
 
-function windowByDir(dir) {
-  const r = tmux(['list-windows', '-t', SESSION, '-F', '#{window_index}\t#{window_name}']);
-  if (r.status !== 0) return null;
-  for (const line of r.stdout.trim().split('\n').filter(Boolean)) {
-    const [idx, name] = line.split('\t');
-    if (name === dir) return parseInt(idx, 10);
-  }
-  return null;
-}
-
-function windowNameByIndex(idx) {
-  const r = tmux(['list-windows', '-t', SESSION, '-F', '#{window_index}\t#{window_name}']);
-  if (r.status !== 0) return null;
-  for (const line of r.stdout.trim().split('\n').filter(Boolean)) {
-    const [wi, name] = line.split('\t');
-    if (parseInt(wi, 10) === idx) return name;
-  }
-  return null;
-}
-
-function activeWindowIndex() {
-  const r = tmux(['list-windows', '-t', SESSION, '-F', '#{window_index} #{window_active}']);
-  if (r.status !== 0) return null;
-  for (const line of r.stdout.trim().split('\n').filter(Boolean)) {
-    const [idx, active] = line.split(' ');
-    if (active === '1') return parseInt(idx, 10);
-  }
-  return null;
-}
-
-function tuiPaneId(windowIndex) {
-  const r = tmux(['list-panes', '-t', `${SESSION}:${windowIndex}`, '-F', '#{pane_id}\t#{pane_current_command}']);
-  if (r.status !== 0) return null;
-  for (const line of r.stdout.trim().split('\n').filter(Boolean)) {
-    const [paneId, cmd] = line.split('\t');
-    if (cmd === 'node') return paneId;
-  }
-  return null;
-}
-
-function paneCount(windowIndex) {
-  const r = tmux(['list-panes', '-t', `${SESSION}:${windowIndex}`, '-F', '#{pane_id}']);
-  if (r.status !== 0) return 0;
-  return r.stdout.trim().split('\n').filter(Boolean).length;
-}
-
 function findWindowsByBasename(name) {
   const r = tmux(['list-windows', '-t', SESSION, '-F', '#{window_name}']);
   if (r.status !== 0) return [];
@@ -316,29 +268,7 @@ function cmdSwitch(statefile, longMode) {
 // ---------------------------------------------------------------------------
 
 function cmdList() {
-  const sessionR = tmux(['has-session', '-t', SESSION]);
-  if (sessionR.status !== 0) {
-    console.log('No opencode servers running.');
-    return;
-  }
-
-  const listR = tmux(['list-windows', '-t', SESSION, '-F', '#{window_index}\t#{window_name}']);
-  if (listR.status !== 0 || !listR.stdout.trim()) {
-    console.log('No opencode servers running.');
-    return;
-  }
-
-  const rows = [];
-  for (const line of listR.stdout.trim().split('\n').filter(Boolean)) {
-    const [idx, dir] = line.split('\t');
-    const sf = path.join(dir, '.ocmux.json');
-    if (!fs.existsSync(sf)) continue;
-    const state = readState(sf);
-    if (!state || !state.url) continue;
-    const tui = tuiPaneId(parseInt(idx, 10));
-    rows.push({ url: state.url, dir, status: tui ? 'alive' : 'dead' });
-  }
-
+  const rows = listServers();
   if (rows.length === 0) {
     console.log('No opencode servers running.');
     return;
@@ -409,6 +339,9 @@ function doNew(targetDir, longMode) {
 
   pinWindowName(winIdx);
 
+  // Truncate log file so stale URL from previous run can't be matched by polling
+  try { fs.truncateSync(lf); } catch { /* may not exist yet */ }
+
   // Send the command to the interactive shell (like typing it manually)
   tmux(['send-keys', '-t', `${SESSION}:${winIdx}.0`,
     `opencode serve --port 0 2>&1 | tee '${lf}'`, 'Enter']);