agentp 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [Unreleased]
+
+- Rename package and CLI command from `aprompt` to `agentp`.
+
+## [0.1.0] - 2026-05-08
+
+- Initial release.
+- Add project documentation and usage examples.

package/README.md

@@ -0,0 +1,111 @@
+# agentp
+
+`agentp` is a tiny CLI that pipes prompt text into a running OpenCode TUI session and streams the assistant final answer back to stdout.
+
+It is designed for prompt-driven workflows where you want to do things like:
+
+- compose prompts with `cat`, `printf`, or heredocs
+- submit them to OpenCode from scripts
+- capture output in files or pipe to other tools
+- **drive prompts directly from editors** like Vim/Neovim
+
+## Install
+
+From npm:
+
+```bash
+npm install -g agentp
+```
+
+For local development in this repo:
+
+```bash
+npm link
+```
+
+## Requirements
+
+- Node.js 18+
+- An OpenCode server session listening locally (default port: `4096`)
+
+Notes:
+
+- `agentp` connects to the OpenCode event endpoint over HTTP.
+- In practice this means running `opencode --serve` (or equivalent serve mode) so the port is open.
+- `opencode --attach` is optional but useful to monitor the full conversation in another terminal/tmux pane.
+
+## Usage
+
+```bash
+agentp [options] [port]
+```
+
+Options:
+
+- `--qa`: print question/answer separators around the streamed answer
+- `--help`: show help message
+
+Arguments:
+
+- `port`: OpenCode TUI port (defaults to `4096`)
+
+## Examples
+
+Send a one-line prompt:
+
+```bash
+printf "Summarize the latest logs" | agentp
+```
+
+Type and send a multi-line prompt:
+
+```bash
+cat | agentp
+# (press Ctrl+D to end input)
+```
+
+Send a multi-line prompt from a file:
+
+```bash
+cat prompt.txt | agentp
+```
+
+Use QA separators and explicit port:
+
+```bash
+cat prompt.txt | agentp --qa 4096
+```
+
+Capture answer to a file:
+
+```bash
+cat prompt.txt | agentp > answer.txt
+```
+
+From Vim/Neovim, send the current visual selection and replace it in place with the assistant answer:
+
+```vim
+:'<,'>!agentp
+```
+
+From Vim/Neovim, send the current visual selection and keep QA separators in the same file:
+
+```vim
+:'<,'>!agentp --qa
+```
+
+## How It Works
+
+1. Clears the current TUI prompt input.
+2. Appends each line from stdin to the TUI prompt.
+3. Submits the prompt.
+4. Listens to the event stream and prints assistant text parts.
+5. Stops when the session reaches idle state.
+
+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.
+
+## License
+
+MIT

package/bin/agentp

@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+
+const http = require('http');
+const { URL } = require('url');
+
+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', () => 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)
+    }
+  };
+}
+
+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', '{}'), '{}');
+}
+
+async function sendPrompt(port) {
+  const server = `http://localhost:${port}`;
+  let promptText = '';
+
+  await clearPrompt(server);
+
+  const readline = require('readline');
+  const rl = readline.createInterface({ input: process.stdin });
+
+  for await (const line of rl) {
+    const promptLine = line + '\n';
+    promptText += promptLine;
+    await appendPrompt(server, promptLine);
+  }
+
+  rl.close();
+  await submitPrompt(server);
+  return promptText;
+}
+
+const HUMAN_ROW = '👤: ￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣\n'
+const AGENT_ROW = '🤖: ￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣\n'
+const FINAL_ROW = '￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣\n';
+
+function listenForFinalAnswer(port, showFinalRow) {
+  return new Promise((resolve, reject) => {
+    const url = `http://localhost:${port}/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' }
+    }, (res) => {
+      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 port = 4096;
+  let qaMode = false;
+
+  const args = process.argv.slice(2);
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--help') {
+      console.error('Usage: agentp [options] [port]');
+      console.error('');
+      console.error('Pipe prompt text to an OpenCode TUI session running on localhost.');
+      console.error('The assistant response is streamed to stdout.');
+      console.error('');
+      console.error('Options:');
+      console.error('  --qa       Print question/answer separators before streaming output');
+      console.error('  --help     Show this help message');
+      console.error('');
+      console.error('Arguments:');
+      console.error('  port       OpenCode TUI port (default: 4096)');
+      console.error('');
+      console.error('Examples:');
+      console.error('  printf "Summarize this file" | agentp');
+      console.error('  cat prompt.txt | agentp --qa 4096');
+      process.exit(0);
+    } else if (args[i] === '--qa') {
+      qaMode = true;
+    } else if (!isNaN(args[i]) && /^\d+$/.test(args[i])) {
+      port = parseInt(args[i], 10);
+    }
+  }
+
+  const promptText = await sendPrompt(port);
+
+  if (qaMode) {
+    process.stdout.write(HUMAN_ROW);
+    process.stdout.write(promptText);
+    process.stdout.write(AGENT_ROW);
+  }
+
+  await listenForFinalAnswer(port, qaMode);
+}
+
+main().catch((err) => {
+  console.error('Error:', err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "agentp",
+  "version": "0.1.0",
+  "description": "Pipe prompts into a running OpenCode TUI session and stream the final answer",
+  "bin": {
+    "agentp": "bin/agentp"
+  },
+  "keywords": [
+    "ai",
+    "cli",
+    "prompt",
+    "opencode"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "type": "commonjs"
+}