agenter-app 1.1.0 → 1.3.0

package/lib/terminal.js

@@ -0,0 +1,127 @@
+'use strict';
+// The dashboard's terminal: one long-lived PowerShell per folder, so `cd` and variables
+// carry over between commands. It talks over plain pipes (a real pseudo-terminal would need
+// a native dependency), so a program that takes over the screen, like vim, won't work.
+// Each command ends by printing a marker with a per-shell secret, which is how we learn
+// it finished, its exit code and the folder it left us in.
+const crypto = require('node:crypto');
+const { spawn, execFile } = require('node:child_process');
+
+const KEEP_CHARS = 200 * 1024;
+const SHELL_ARGS = ['-NoLogo', '-NoProfile', '-ExecutionPolicy', 'Bypass', '-OutputFormat', 'Text', '-Command', '-'];
+const SETUP = "$ProgressPreference='SilentlyContinue'; [Console]::OutputEncoding=[Text.UTF8Encoding]::new($false); $OutputEncoding=[Console]::OutputEncoding\n";
+
+// One line, so nothing the command reads from stdin (Read-Host, say) can swallow the marker.
+// Base64 keeps quotes and newlines in what you typed from reaching this line at all.
+function commandLine(command, marker) {
+  const b64 = Buffer.from(command, 'utf8').toString('base64');
+  return `try { . ([scriptblock]::Create([Text.Encoding]::UTF8.GetString([Convert]::FromBase64String('${b64}')))) } catch { [Console]::Error.WriteLine(($_ | Out-String).Trim()) }; [Console]::Out.WriteLine("\`n${marker}\${LASTEXITCODE}:$($PWD.ProviderPath)>>")\n`;
+}
+
+// Pulls finished-command markers out of buffered output. Returns the output that's safe to
+// show now, what to keep for next time, and any markers found.
+function splitOutput(buf, marker) {
+  const done = [];
+  let shown = '';
+  for (;;) {
+    const i = buf.indexOf(marker);
+    if (i < 0) break;
+    const end = buf.indexOf('>>', i);
+    if (end < 0) return { shown: shown + buf.slice(0, i), rest: buf.slice(i), done };
+    const [code, ...cwd] = buf.slice(i + marker.length, end).split(':');
+    done.push({ code, cwd: cwd.join(':') });
+    shown += buf.slice(0, i).replace(/\r?\n$/, '');
+    buf = buf.slice(end + 2).replace(/^\r?\n/, '');
+  }
+  // The start of a marker may have landed at the very end of this chunk.
+  for (let n = Math.min(marker.length - 1, buf.length); n > 0; n--) {
+    if (buf.endsWith(marker.slice(0, n))) return { shown: shown + buf.slice(0, -n), rest: buf.slice(-n), done };
+  }
+  return { shown: shown + buf, rest: '', done };
+}
+
+function createTerminals(onEvent) {
+  const terms = new Map(); // id -> { id, cwd, child, running, marker, buf, output, onDone }
+
+  const emit = (t, data = '') => {
+    if (data) t.output = (t.output + data).slice(-KEEP_CHARS);
+    onEvent({ id: t.id, data, running: t.running, cwd: t.cwd });
+  };
+
+  function startShell(t) {
+    t.marker = `<<agenter:${crypto.randomBytes(8).toString('hex')}:`;
+    t.buf = '';
+    const child = spawn('powershell.exe', SHELL_ARGS, {
+      cwd: t.cwd,
+      windowsHide: true,
+      stdio: ['pipe', 'pipe', 'pipe'],
+      env: { ...process.env, NO_COLOR: '1', FORCE_COLOR: '0', npm_config_progress: 'false' },
+    });
+    t.child = child;
+    child.stdin.on('error', () => {});
+    child.stdout.setEncoding('utf8');
+    child.stderr.setEncoding('utf8');
+    child.stderr.on('data', (d) => emit(t, d));
+    child.stdout.on('data', (d) => {
+      const { shown, rest, done } = splitOutput(t.buf + d, t.marker);
+      t.buf = rest;
+      if (shown) emit(t, shown);
+      for (const { code, cwd } of done) {
+        t.running = false;
+        if (cwd) t.cwd = cwd;
+        emit(t, shown.endsWith('\n') || !shown ? '' : '\n');
+        const after = t.onDone;
+        t.onDone = null;
+        after?.(code);
+      }
+    });
+    child.on('error', (e) => emit(t, `Couldn't start PowerShell: ${e.message}\n`));
+    child.on('close', () => {
+      if (t.child !== child) return;
+      t.child = null;
+      t.running = false;
+      t.onDone = null;
+      emit(t, t.stopping ? '\n[stopped]\n' : '\n[shell exited]\n');
+      t.stopping = false;
+    });
+    child.stdin.write(SETUP);
+  }
+
+  return {
+    open(id, cwd) {
+      let t = terms.get(id);
+      if (!t) terms.set(id, (t = { id, cwd, child: null, running: false, marker: '', buf: '', output: '', onDone: null, stopping: false }));
+      return { id: t.id, cwd: t.cwd, running: t.running, output: t.output };
+    },
+    // Sends a command, or if one is running, a line to that command's stdin.
+    run(id, input, onDone) {
+      const t = terms.get(id);
+      if (!t) return false;
+      if (t.running) {
+        emit(t, `${input}\n`);
+        t.child.stdin.write(`${input}\n`);
+        return true;
+      }
+      if (!t.child) startShell(t);
+      t.running = true;
+      t.onDone = onDone || null;
+      emit(t, `PS ${t.cwd}> ${input}\n`);
+      t.child.stdin.write(commandLine(input, t.marker));
+      return true;
+    },
+    // PowerShell over pipes has no Ctrl+C, so this ends the shell along with what it's running.
+    // The next command starts a new one in the same folder.
+    stop(id) {
+      const t = terms.get(id);
+      if (!t?.child) return false;
+      t.stopping = true;
+      execFile('taskkill', ['/pid', String(t.child.pid), '/T', '/F'], { windowsHide: true }, (err) => err && t.child?.kill());
+      return true;
+    },
+    killAll() {
+      for (const t of terms.values()) t.child?.kill();
+    },
+  };
+}
+
+module.exports = { createTerminals, commandLine, splitOutput };

package/lib/update.js

@@ -0,0 +1,69 @@
+'use strict';
+// Is there a newer Agenter on npm? Used by the `agenter` command on every run and by the
+// server for the dashboard. The answer is cached in ~/.agenter/update.json so being offline
+// still shows the last one. AGENTER_UPDATE_CHECK=0 turns all of this off.
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+
+const PACKAGE = 'agenter-app';
+const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE}/latest`;
+const ROOT = path.join(__dirname, '..');
+
+const enabled = () => process.env.AGENTER_UPDATE_CHECK !== '0';
+const cacheFile = () => path.join(os.homedir(), '.agenter', 'update.json');
+// Also what makes a version safe to put on an npm command line.
+const isVersion = (v) => typeof v === 'string' && /^\d+\.\d+\.\d+$/.test(v);
+
+function isNewer(a, b) {
+  if (!isVersion(a) || !isVersion(b)) return false;
+  const [x, y] = [a, b].map((v) => v.split('.').map(Number));
+  for (let i = 0; i < 3; i++) if (x[i] !== y[i]) return x[i] > y[i];
+  return false;
+}
+
+function cachedLatest() {
+  try {
+    const { latest } = JSON.parse(fs.readFileSync(cacheFile(), 'utf8'));
+    return isVersion(latest) ? latest : null;
+  } catch {
+    return null;
+  }
+}
+
+// The newest published version, or the last one seen if npm can't be reached.
+async function checkLatest({ timeoutMs = 1500 } = {}) {
+  if (!enabled()) return null;
+  try {
+    const r = await fetch(process.env.AGENTER_UPDATE_URL || REGISTRY_URL, { signal: AbortSignal.timeout(timeoutMs) });
+    if (!r.ok) return cachedLatest();
+    const { version } = await r.json();
+    if (!isVersion(version)) return cachedLatest();
+    fs.mkdirSync(path.dirname(cacheFile()), { recursive: true });
+    fs.writeFileSync(cacheFile(), JSON.stringify({ latest: version, checkedAt: Date.now() }, null, 2));
+    return version;
+  } catch {
+    return cachedLatest();
+  }
+}
+
+// What's on disk now. A running server keeps the version it started with, so a difference
+// means an update was installed and it needs a restart.
+function installedVersion() {
+  try {
+    return JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8')).version;
+  } catch {
+    return null;
+  }
+}
+
+// A git clone updates with git. Installing over it from npm would land somewhere else.
+const canSelfUpdate = () => !fs.existsSync(path.join(ROOT, '.git'));
+
+const updateCommand = () => (canSelfUpdate() ? 'agenter update' : 'git pull');
+
+function notice(current, latest) {
+  return isNewer(latest, current) ? `Agenter ${latest} is available (you have ${current}). Run: ${updateCommand()}` : '';
+}
+
+module.exports = { PACKAGE, enabled, isVersion, isNewer, cachedLatest, checkLatest, installedVersion, canSelfUpdate, updateCommand, notice };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenter-app",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "One local dashboard to watch, approve and steer every Claude Code and Codex session on your machine.",
   "keywords": [
     "claude",