agentp 0.10.0 → 0.11.1

package/package.json

@@ -1,12 +1,19 @@
 {
   "name": "agentp",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "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,182 +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`.
-- Gateway response includes `{ buffered: [...] }` — recorded conversation messages (see `/record` command) flushed on each POST.
-- agentp `--qa` prepends the buffered context to stdout; `--flush` bypasses prepending but still triggers the flush.
-
-## 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] [--flush] [--getLast n] [port]` | pipe stdin → opencode session, stream answer to stdout (uses session API); `--tg` forwards answer to Telegram; `--flush` clears recorded buffer; `--getLast n` retrieves last n answers |
-| `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
-
-*(none)*
-
-### In Progress
-
-*(none)*
-
-### Done
-
-- `/queue` command: queue messages when server is busy, auto-sent after current task finishes preserves replyTo chain — 0.10.0
-- `agentp --getLast n` — retrieve last n answers from session history — 0.10.0
-- `/record` command with ring buffer (100 msgs / 100KB), gateway returns `{ buffered }`, agentp `--qa` prepends recorded context, `--flush` flushes without prepending — 0.10.0
-- 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,36 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-## [0.10.0] - 2026-06-04
-
-- `/queue` command: queue messages when server is busy, auto-sent after current task finishes, preserves replyTo chain.
-- `/record` command with ring buffer (100 msgs / 100KB), `/record stop` to clear; gateway returns `{ buffered }` JSON.
-- agentp `--flush`: flush tgagentp's recorded buffer without prepending to stdout.
-- agentp `--getLast n`: retrieve last n assistant answers from session history.
-- agentp `--qa` prepends recorded Telegram context (with rulers) to stdout.
-- `getSession()` in lib/opencode: `GET /session/:id` with fallback to session list.
-- `makeRequest` optional timeout parameter (used only for getSession; all other calls wait indefinitely).
-- Minimum 3-backtick code fence for reply quoting.
-
-## [0.9.0] - 2026-06-04
-
-- agentp `--tg`/`--no-tg` flags: gateway forwards answer to Telegram; auto mode silently degrades.
-- Agentp resilience: 5s HTTP timeout, pre-send gate check, post-send warning.
-- Full `--qa` output (rulers + prompt + answer) forwarded to Telegram.
-- Rulers changed from `—` to `─`, shortened to 17 chars.
-
-## [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.

package/devto-article.md

@@ -1,121 +0,0 @@
-# Agentp: Turn OpenCode Into a Headless AI Engine for Your Editor, Terminal, and Telegram
-
-OpenCode is great, but its TUI locks you in. You type in one window, watch it stream, and that's it. What if you could:
-
-- Pipe a prompt straight from Vim and replace your selection with the answer?
-- Queue messages from Telegram while it's busy and get replies threaded?
-- Keep a permanent tmux server per project and switch between them?
-- Pull the last N answers from session history without sending a new prompt?
-- Record your Telegram conversation and inject it as context into your next `agentp` call?
-
-That's what **agentp** — a set of three zero-dependency Node.js CLI tools — does.
-
----
-
-## The Three Tools
-
-### `agentp` — The Pipe
-
-Stdin in, answer out. That's the core loop.
-
-```bash
-printf "Summarize this file" | agentp
-cat prompt.txt | agentp 4096
-```
-
-From Vim/Neovim:
-
-```vim
-:'<,'>!agentp --qa
-```
-
-This replaces your visual selection with the answer. `--qa` preserves the prompt + answer with labels, so you keep the full context.
-
-### `ocmux` — The Project Manager
-
-Each project gets its own tmux window with a dedicated `opencode serve` + TUI pane. Auto-restarts dead panes, pins window names, stores state in `.ocmux.json` (discovered upward like `.git`).
-
-```bash
-ocmux serve ~/projects/myapp   # create
-ocmux list                      # list all
-ocmux ~/projects/myapp          # switch
-ocmux kill ~/projects/myapp     # remove
-```
-
-### `tgagentp` — The Telegram Bridge
-
-A Telegram bot that routes messages to your OpenCode servers. Multi-server aware, slash-commands for everything.
-
-**Slash commands:**
-
-| Command | What it does |
-|---|---|
-| `/servers` | List/switch between ocmux projects |
-| `/sessions` | List/switch/create/rename sessions |
-| `/agents` | List/switch active agent |
-| `/models` | List providers and models |
-| `/queue <msg>` | Queue message when busy — auto-sent after current task finishes (replies chain!) |
-| `/record` | Record conversation for `agentp` context injection |
-| `/think` | Toggle real-time thinking message forwarding |
-| `/cancel` | Abort the running prompt |
-
----
-
-## The Agentp Gateway
-
-The killer integration: `agentp` and `tgagentp` talk to each other through a tiny HTTP gateway.
-
-- **`agentp --tg`** forwards the answer to your Telegram chat after every pipe.
-- **`agentp --qa`** auto-detects tgagentp and sends the full QA pair (rulers + prompt + answer).
-- **`/record`** buffers the Telegram conversation. On the next `agentp` call, the gateway returns the buffer, and `--qa` prepends it to stdout with rulers — so OpenCode sees the full Telegram thread as context.
-- **`agentp --flush`** clears the buffer without prepending.
-- **`agentp --getLast 5`** retrieves the last 5 assistant answers from session history.
-
-```vim
-:'<,'>!agentp --qa --tg          " answer in editor + Telegram
-:'<,'>!agentp --qa --flush       " flush recorded buffer
-```
-
-All of this with **zero npm dependencies** — just Node.js 18+ stdlib.
-
----
-
-## Why This Setup Works
-
-1. **Session API, not TUI hooks** — messages go through `POST /session/:id/message`, which returns synchronously. No fragile TUI scraping.
-2. **Per-project tmux isolation** — each project gets its own `opencode serve` process. Switch with a single command.
-3. **Graceful degradation** — `--tg` in auto mode silently skips Telegram if tgagentp isn't running. Explicit `--tg` errors pre-send, warns post-send.
-4. **10s HTTP timeout on every request** — nothing ever hangs.
-5. **Async processing** — tgagentp never blocks the polling loop. Commands stay responsive even while a prompt runs.
-
----
-
-## Quick Start
-
-```bash
-npm install -g agentp
-
-# Start a project server
-ocmux serve ~/projects/myapp
-
-# Pipe a prompt
-printf "Explain this codebase" | agentp
-
-# With Telegram (set up a bot with @BotFather first)
-export TELEGRAM_BOT_TOKEN="your-token"
-tgagentp
-```
-
-If your OpenCode server is password-protected, set `OPENCODE_SERVER_PASSWORD`.
-
----
-
-## Links
-
-- **GitHub:** [github.com/bitifet/agentp](https://github.com/bitifet/agentp)
-- **npm:** [npmjs.com/package/agentp](https://www.npmjs.com/package/agentp)
-- **OpenCode:** [github.com/anthropics/claude-code](https://github.com/anthropics/claude-code)
-
----
-
-*Feedback? Issues? PRs welcome.*