agentp 0.9.0 → 0.11.0

package/lib/opencode.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const http = require('http');
+const https = require('https');
 const { URL } = require('url');
 
 function getAuthHeaders() {
@@ -11,7 +12,7 @@ function getAuthHeaders() {
   return { 'Authorization': `Basic ${encoded}` };
 }
 
-function makeRequest(options, data, cancelRef) {
+function makeRequest(options, data, cancelRef, timeoutMs) {
   return new Promise((resolve, reject) => {
     const req = http.request(options, (res) => {
       let body = '';
@@ -24,6 +25,12 @@ function makeRequest(options, data, cancelRef) {
         }
       });
     });
+    if (timeoutMs) {
+      req.setTimeout(timeoutMs, () => {
+        req.destroy();
+        reject(new Error('Request timed out'));
+      });
+    }
     req.on('error', reject);
     if (cancelRef) cancelRef.current = req;
     if (data) req.write(data);
@@ -243,6 +250,36 @@ async function selectSession(server, sessionId) {
   }
 }
 
+// Get a single session by ID, including its message history.
+// Tries GET /session/:id first; falls back to filtering the sessions list.
+async function getSession(server, sessionId) {
+  const encoded = encodeURIComponent(sessionId);
+  // Try several endpoint patterns that different opencode versions may expose
+  const urls = [
+    `${server}/session/${encoded}`,
+    `${server}/session/${encoded}/messages`,
+    `${server}/session/${encoded}/history`,
+    `${server}/session/${encoded}/conversation`,
+    `${server}/conversation/${encoded}`,
+  ];
+  for (const url of urls) {
+    try {
+      const { status, body } = await makeRequest(buildJsonRequest(url, 'GET'), null, null, 10000);
+      if (status === 200) {
+        try {
+          const parsed = JSON.parse(body);
+          if (parsed != null) return parsed;
+        } catch {}
+      }
+    } catch {}
+  }
+  // Fallback: get all sessions and find the one we need
+  const sessions = await listSessions(server);
+  const match = sessions.find(s => String(s.id) === String(sessionId));
+  if (match) return match;
+  throw new Error(`Session ${sessionId} not found`);
+}
+
 // List all agents from the OpenCode server.
 async function listAgents(server) {
   const url = `${server}/agent`;
@@ -283,8 +320,13 @@ async function respondToPermission(server, sessionId, permissionId, response, re
 // permission requests. Resolves with the full collected text when the session goes idle.
 // callbacks: { onText(chunk), onPermission(permission), onThinking(chunk), onConnected() }
 // cancelRef — allows aborting the SSE stream via req.destroy()
-function listenForSessionEvents(server, sessionId, callbacks, cancelRef) {
-  process.stderr.write(`  [SSE] connecting to ${server}/event for session ${sessionId}\n`);
+// logFn — optional logger; if provided, used instead of process.stderr.write
+function listenForSessionEvents(server, sessionId, callbacks, cancelRef, logFn) {
+  const sseLog = logFn || ((msg) => {
+    const ts = new Date().toISOString().replace('T', ' ').replace(/\.\d{3}Z$/, '');
+    process.stderr.write(`${ts} ${msg}`);
+  });
+  sseLog(`  [SSE] connecting to ${server}/event for session ${sessionId}\n`);
   return new Promise((resolve, reject) => {
     const url = `${server}/event`;
     const parsed = new URL(url);
@@ -301,7 +343,7 @@ function listenForSessionEvents(server, sessionId, callbacks, cancelRef) {
         reject(new Error('OpenCode server authentication failed. Set OPENCODE_SERVER_PASSWORD to match the server password.'));
         return;
       }
-      process.stderr.write(`  [SSE] connected for session ${sessionId}\n`);
+      sseLog(`  [SSE] connected for session ${sessionId}\n`);
       if (callbacks.onConnected) callbacks.onConnected();
       let buffer = '';
       const userMessageIDs = new Set();
@@ -312,7 +354,7 @@ function listenForSessionEvents(server, sessionId, callbacks, cancelRef) {
       const safetyTimer = setTimeout(() => {
         if (resolved) return;
         resolved = true;
-        process.stderr.write(`  [SSE] safety timeout (90s) for session ${sessionId}, collected ${collected.length} chars\n`);
+        sseLog(`  [SSE] safety timeout (90s) for session ${sessionId}, collected ${collected.length} chars\n`);
         cleanup();
         req.destroy();
         res.destroy();
@@ -338,9 +380,9 @@ function listenForSessionEvents(server, sessionId, callbacks, cancelRef) {
             const props = event.properties || {};
 
             if (event.type === 'session.status') {
-              process.stderr.write(`  [SSE] session.status: type=${props.status?.type} status=${JSON.stringify(props.status)}\n`);
+              sseLog(`  [SSE] session.status: type=${props.status?.type} status=${JSON.stringify(props.status)}\n`);
             } else {
-              process.stderr.write(`  [SSE] event type=${event.type} sessionID=${props.sessionID} waitSession=${sessionId}\n`);
+              sseLog(`  [SSE] event type=${event.type} sessionID=${props.sessionID} waitSession=${sessionId}\n`);
             }
 
             // Filter by sessionID when the event carries one (string-compare to handle type mismatches)
@@ -353,18 +395,18 @@ function listenForSessionEvents(server, sessionId, callbacks, cancelRef) {
 
             if (event.type === 'permission.asked') {
               const permStr = JSON.stringify(props);
-              process.stderr.write(`  [SSE] PERMISSION ASKED: ${permStr}\n`);
+              sseLog(`  [SSE] PERMISSION ASKED: ${permStr}\n`);
               if (callbacks.onPermission) {
-                process.stderr.write(`  [SSE] calling onPermission callback\n`);
+                sseLog(`  [SSE] calling onPermission callback\n`);
                 callbacks.onPermission(props);
               } else {
-                process.stderr.write(`  [SSE] WARNING: no onPermission callback registered\n`);
+                sseLog(`  [SSE] WARNING: no onPermission callback registered\n`);
               }
               continue;
             }
 
             if (event.type === 'permission.replied') {
-              process.stderr.write(`  [SSE] PERMISSION REPLIED: type=${props.type}\n`);
+              sseLog(`  [SSE] PERMISSION REPLIED: type=${props.type}\n`);
               if (callbacks.onPermissionReplied) {
                 callbacks.onPermissionReplied(props);
               }
@@ -426,7 +468,7 @@ function listenForSessionEvents(server, sessionId, callbacks, cancelRef) {
         if (resolved) return;
         resolved = true;
         cleanup();
-        process.stderr.write(`  [SSE] response stream error for session ${sessionId}: ${err.message}\n`);
+        sseLog(`  [SSE] response stream error for session ${sessionId}: ${err.message}\n`);
         resolve(collected);   // resolve with what we have
       });
     });
@@ -445,6 +487,29 @@ function listenForSessionEvents(server, sessionId, callbacks, cancelRef) {
   });
 }
 
+// Check if an OpenCode server is reachable by making a GET /session request.
+// Returns a Promise that resolves to `true` (any response) or `false` (connection error / timeout).
+function isServerAlive(url) {
+  return new Promise((resolve) => {
+    const mod = url.startsWith('https') ? https : http;
+    const parsed = new URL(url + '/session');
+    const opts = {
+      hostname: parsed.hostname,
+      port: parsed.port,
+      path: parsed.pathname,
+      method: 'GET',
+      headers: { ...getAuthHeaders() },
+    };
+    const req = mod.request(opts, (res) => {
+      res.resume();
+      resolve(true);
+    });
+    req.on('error', () => resolve(false));
+    req.setTimeout(5000, () => { req.destroy(); resolve(false); });
+    req.end();
+  });
+}
+
 module.exports = {
   getAuthHeaders,
   makeRequest,
@@ -455,6 +520,7 @@ module.exports = {
   sendText,
   listenForFinalAnswer,
   listSessions,
+  getSession,
   createSession,
   updateSession,
   selectSession,
@@ -464,4 +530,5 @@ module.exports = {
   listenForSessionEvents,
   listAgents,
   listProviders,
+  isServerAlive,
 };

package/package.json

@@ -1,12 +1,19 @@
 {
   "name": "agentp",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Pipe prompts into a running OpenCode TUI session and stream the final answer",
   "bin": {
     "agentp": "bin/agentp",
     "ocmux": "bin/ocmux",
     "tgagentp": "bin/tgagentp"
   },
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md",
+    "CONTRIBUTING.md",
+    "docs/"
+  ],
   "keywords": [
     "ai",
     "cli",
@@ -24,7 +31,7 @@
     "node": ">=18"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "node --test tests/*.test.js"
   },
   "type": "commonjs"
 }

package/AGENTS.md

@@ -1,177 +0,0 @@
-# agentp — agent notes
-
-## Three binaries, all registered
-
-- `bin/agentp` (Node.js) — registered in `package.json` `"bin"` — pipes stdin → opencode session
-- `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.** 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.** All tools use portable Node.js APIs only.
-
-## Logging conventions (tgagentp)
-
-- **stdout** — informational messages (startup, discovery, session switches)
-- **stderr** — errors (always shown) + trace/debug (only with `--verbose` flag)
-- Default usage for clean console: `tgagentp 2>/dev/null`
-- The `log` helper object at the top of `bin/tgagentp` provides `log.info()`, `log.error()`, and `log.debug()`.
-
-## `.ocmux.json`
-
-Runtime state file created by `bin/ocmux` (contains URL, log path, and window index). **Not in `.gitignore`** — avoid committing it.
-
-## 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, agent?)` — `PATCH /session/:id`; returns the updated `Session` object; optional `agent` to set the session's agent
-- `sendToSession(server, sessionId, text, agent?, cancelRef?)` — `POST /session/:id/message`; returns concatenated text parts from response; optional `agent`, optional `cancelRef` for aborting the request
-- `sendToSessionAsync(server, sessionId, text, agent?)` — `POST /session/:id/prompt_async`; returns 204; non-blocking, answer delivered via SSE
-- `respondToPermission(server, sessionId, permissionId, response)` — `POST /session/:id/permissions/:id`
-- `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
-- `listenForSessionEvents(server, sessionId, callbacks, cancelRef?)` — SSE listener for session events (text parts, permissions, thinking, session.idle)
-
-## 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 of the TUI pane (pane index != 0), `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:
-
-- `POST /tui/clear-prompt`
-- `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 }`, optional `{ agent }`)
-- `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)
-- `POST /session/:id/prompt_async` — send message to session (returns 204; answer via SSE)
-- `GET /agent` — list available agents
-- `GET /provider` — list connected providers/models
-
-## Agentp gateway (tgagentp ↔ agentp interop)
-
-- tgagentp starts a tiny HTTP server (POST /send) on `127.0.0.1`, port from `TGAGENTP_PORT` (default 0 = random).
-- Port is written to `/tmp/tgagentp-port` for agentp discovery.
-- Validates `Authorization` header against `OPENCODE_SERVER_PASSWORD`.
-- agentp `--tg` reads the port file and POSTs `{ text, server }` to the gateway.
-- Messages for the active server are delivered immediately; others are queued per-server.
-- Debounced Telegram notification (configurable via `TGAGENTP_DEBOUNCE_MS`, default 5000ms).
-- Queued messages are flushed on `/servers switch`.
-
-## OpenCode tmux session model (ocmux)
-
-- Single tmux session named `"Opencode"`
-- Windows named by full project directory path
-- Server pane runs `opencode serve --port 0` (via send-keys → interactive shell for env var support), TUI pane runs `opencode attach --continue`; `ocmux serve --print-logs` adds `--print-logs` to the serve command
-- 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 (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] [--tg|--no-tg] [port]` | pipe stdin → opencode session, stream answer to stdout (uses session API); `--tg` forwards answer to Telegram |
-| `tgagentp [port]` | bridge Telegram bot ↔ opencode TUI (needs `TELEGRAM_BOT_TOKEN`) |
-| `tgagentp --dev` | enable `/shutdown` command for remote restart |
-| `ocmux serve [--print-logs] [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
-
-- `agentp --getLast n` — retrieve last n answers from session history
-
-### In Progress
-
-*(none)*
-
-### Done
-
-- agentp `--qa` full context forwarding to Telegram (rulers, prompt, answer) — 0.9.0
-- agentp resilience: 5s HTTP timeout, pre-send gate check, post-send warning (not hard error) for `--tg`; auto mode silently degrades — 0.9.0
-- tgagentp: `lockedChatId` set at startup to fix race condition with agentp gateway — 0.9.0
-- tgagentp: server error handler + try-catch in gateway handler (no crash on socket errors) — 0.9.0
-- agentp `--tg`/`--no-tg` — gateway forwards answer to Telegram via tgagentp HTTP server; per-server queue with debounced notifications; auto-flush on server switch
-- agentp session API migration — uses `POST /session/:id/message` instead of TUI endpoints
-- ocmux `--print-logs` flag — pass-through to `opencode serve --print-logs` (prints server logs to stderr in the server pane)
-- /agents lists only primary agents with ▶ active marker
-- /agents switch calls `updateSession(agent)` to persist agent on session + `selectSession` to refresh TUI
-- Logging rebalance: stdout for info, stderr for errors/debug/trace, `--verbose` flag, `2>/dev/null` default usage
-- `/shutdown force` — refuses shutdown when busy unless `force` flag is given; goodbye message includes state
-- `/think [on|off|switch]` — toggle real-time forwarding of model thinking messages to the chat; `--think` CLI flag to start enabled
-- Event-driven permission handling (`POST /session/:id/prompt_async` + SSE listener + `/allow`, `/reject`, `/always` commands) — included in v0.7.0
-- TUI navigation on `/sessions switch` and `/sessions new` — `POST /tui/select-session` now works in opencode 1.15.13 (was: tried second, never reached)
-- /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 didn't work in opencode < 1.15.x)
-- Fix: active session highlighted with ▶ bullet in session list
-- Fix: discover TUI session on startup and server switch via `discoverActiveSession()`
-- Message splitting (>4096 chars, breaks at newlines)
-- Fix: tuiPaneId detects 'bun' (opencode 1.15.x) in addition to 'node'
-- Fix: URL polling in ocmux doNew takes last match, not first (more robust with bun startup)
-- 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
-
-### 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

@@ -1,24 +0,0 @@
-# Changelog
-
-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.8.0] - 2026-06-03
-
-- Fix `/servers` crash: `serverBase is not defined` error.
-- Logging rebalance: stdout for info, stderr for errors/debug with `--verbose` flag (`2>/dev/null` for clean console).
-- `/shutdown force`: refuse shutdown when busy unless `force` flag given.
-- `/think [on|off|switch]`: toggle real-time forwarding of model thinking messages; `--think` CLI flag.
-- Reply quoting: when replying to a Telegram message, prepend quoted text with safe backtick fencing.
-- Reply chaining: answers use `reply_to_message_id` to appear as replies.
-- TUI navigation: `POST /tui/select-session` tried first (works in opencode 1.15.13).
-
-## [0.1.0] - 2026-05-08
-
-- Initial release.
-- Add project documentation and usage examples.