wisp-agents 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog
+
+All notable changes to `wisp-agents` are documented here.
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project uses [Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+## [0.2.1] - 2026-10-16
+
+### Added
+
+- Desktop app: native right-click menu with spelling suggestions, Copy Link, undo/redo, cut/copy/paste and select all. Inspect Element appears only in dev mode.
+
+### Fixed
+
+- macOS: the Dock shows "wisp" with the wisp icon instead of "Electron". The app now launches from a renamed clone of `Electron.app`, cached per Electron version under `~/Library/Caches/wisp`.
+
+## [0.2.0] - 2026-10-16
+
+### Added
+
+- `npx wisp-agents` opens the desktop app. Electron is now an optional dependency that is fetched on first launch. The CLI starts the app detached and falls back to the browser when Electron isn't available.
+- `--browser` flag to keep the browser-only behaviour.
+
+### Fixed
+
+- Parsing of the `wisp` fence is more robust: malformed blocks are salvaged instead of dropped, and the raw turn text is kept.
+
+## [0.1.0] - 2026-10-16
+
+### Added
+
+- First public release on npm as `wisp-agents`, with `wisp` and `wisp-agents` bins and a `--version` / `-v` flag.
+- Launch Claude Code agents in the background and read the presentation they hand back: diffs, tests, commits, flows and questions.
+- Session queue with follow-ups, answers to agent questions, terminal takeover and mark-as-done.
+- Older turns are folded, with a floating collapse-all button and back-to-top.
+
+[Unreleased]: https://github.com/M0xoo/wisp/compare/v0.2.1...HEAD
+[0.2.1]: https://github.com/M0xoo/wisp/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/M0xoo/wisp/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/M0xoo/wisp/releases/tag/v0.1.0

package/bin/mac-app.js

@@ -0,0 +1,64 @@
+// macOS names the Dock tile, menu bar and Cmd-Tab entry after the running .app bundle's
+// Info.plist, not app.setName(). So run Electron from a clone of Electron.app renamed to wisp
+// (APFS clone: instant, no extra disk), cached per Electron version.
+
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, renameSync, rmSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const REV = 1; // bump when the patching below changes
+const ICON = fileURLToPath(new URL('../electron/icon.png', import.meta.url));
+
+// electronBin: …/Electron.app/Contents/MacOS/Electron → the same binary inside wisp.app, or the
+// original path if anything goes wrong (worst case the Dock says "Electron" again).
+export function wispAppBinary(electronBin) {
+  try {
+    const src = path.resolve(electronBin, '../../..');
+    if (!src.endsWith('.app')) return electronBin;
+    const version = readFileSync(path.join(src, '../version'), 'utf8').trim();
+    const root = path.join(os.homedir(), 'Library/Caches/wisp');
+    const app = path.join(root, `electron-${version}-r${REV}`, 'wisp.app');
+    const bin = path.join(app, 'Contents/MacOS', path.basename(electronBin));
+    if (existsSync(bin)) return bin;
+
+    mkdirSync(root, { recursive: true });
+    const tmp = mkdtempSync(path.join(root, 'build-'));
+    const out = path.join(tmp, 'wisp.app');
+    try {
+      execFileSync('cp', ['-cR', src, out], { stdio: 'ignore' });
+    } catch {
+      execFileSync('cp', ['-R', src, out], { stdio: 'ignore' }); // not APFS
+    }
+    const plist = path.join(out, 'Contents/Info.plist');
+    const set = (key, value) => execFileSync('/usr/libexec/PlistBuddy', ['-c', `Set :${key} ${value}`, plist]);
+    set('CFBundleName', 'wisp');
+    set('CFBundleDisplayName', 'wisp');
+    set('CFBundleIdentifier', 'dev.wisp.app');
+    try {
+      makeIcns(path.join(out, 'Contents/Resources/wisp.icns'), tmp);
+      set('CFBundleIconFile', 'wisp.icns');
+    } catch {}
+
+    mkdirSync(path.dirname(app), { recursive: true });
+    rmSync(app, { recursive: true, force: true });
+    renameSync(out, app);
+    rmSync(tmp, { recursive: true, force: true });
+    return bin;
+  } catch {
+    return electronBin;
+  }
+}
+
+function makeIcns(dest, tmp) {
+  const set = path.join(tmp, 'wisp.iconset');
+  mkdirSync(set);
+  for (const s of [16, 32, 128, 256, 512]) {
+    for (const [scale, suffix] of [[1, ''], [2, '@2x']]) {
+      const px = String(s * scale);
+      execFileSync('sips', ['-z', px, px, ICON, '--out', path.join(set, `icon_${s}x${s}${suffix}.png`)], { stdio: 'ignore' });
+    }
+  }
+  execFileSync('iconutil', ['-c', 'icns', set, '-o', dest], { stdio: 'ignore' });
+}

package/bin/wisp.js

@@ -14,6 +14,7 @@ import { existsSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { wispAppBinary } from './mac-app.js';
 
 const argv = process.argv.slice(2);
 const flags = { open: true, browser: false, port: Number(process.env.WISP_PORT) || 4477, mode: null };
@@ -94,7 +95,8 @@ if (flags.open) {
 function electronBinary() {
   try {
     const bin = createRequire(import.meta.url)('electron'); // the electron package exports its binary path
-    return typeof bin === 'string' && existsSync(bin) ? bin : null;
+    if (typeof bin !== 'string' || !existsSync(bin)) return null;
+    return process.platform === 'darwin' ? wispAppBinary(bin) : bin;
   } catch {
     return null;
   }

package/electron/main.js

@@ -1,7 +1,7 @@
 // wisp desktop shell. The Node server runs inside Electron's main process and
 // the window loads the same UI the browser mode serves.
 
-import { app, BrowserWindow, shell, nativeTheme, Menu, dialog, ipcMain } from 'electron';
+import { app, BrowserWindow, shell, nativeTheme, Menu, dialog, ipcMain, clipboard } from 'electron';
 import { execFileSync } from 'node:child_process';
 import fs from 'node:fs';
 import path from 'node:path';
@@ -76,6 +76,23 @@ function createWindow() {
     app.setBadgeCount(n);
   });
 
+  // Electron has no right-click menu by default: give text and links the usual one.
+  win.webContents.on('context-menu', (_, p) => {
+    const f = p.editFlags;
+    const items = [
+      ...p.dictionarySuggestions.map((w) => ({ label: w, click: () => win.webContents.replaceMisspelling(w) })),
+      ...(p.misspelledWord ? [{ type: 'separator' }] : []),
+      ...(p.linkURL ? [{ label: 'Copy Link', click: () => clipboard.writeText(p.linkURL) }, { type: 'separator' }] : []),
+      ...(p.isEditable ? [{ role: 'undo', enabled: f.canUndo }, { role: 'redo', enabled: f.canRedo }, { type: 'separator' }] : []),
+      ...(p.isEditable ? [{ role: 'cut', enabled: f.canCut }] : []),
+      ...(p.isEditable || p.selectionText ? [{ role: 'copy', enabled: f.canCopy }] : []),
+      ...(p.isEditable ? [{ role: 'paste', enabled: f.canPaste }, { role: 'pasteAndMatchStyle', enabled: f.canPaste }] : []),
+      { role: 'selectAll', enabled: f.canSelectAll },
+      ...(DEV ? [{ type: 'separator' }, { label: 'Inspect Element', click: () => win.webContents.inspectElement(p.x, p.y) }] : []),
+    ];
+    Menu.buildFromTemplate(items).popup({ window: win });
+  });
+
   win.on('closed', () => (win = null));
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wisp-agents",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Launch coding agents, skip the transcript, read the presentation.",
   "type": "module",
   "bin": {
@@ -9,16 +9,17 @@
   },
   "files": [
     "bin/",
+    "CHANGELOG.md",
     "electron/",
     "server/",
     "web/"
   ],
   "scripts": {
     "start": "node bin/wisp.js",
-    "app": "electron .",
-    "dev": "WISP_DEV=1 electron .",
+    "app": "node bin/wisp.js",
+    "dev": "WISP_DEV=1 node bin/wisp.js",
     "dev:web": "node --watch-path=server bin/wisp.js --no-open",
-    "prepublishOnly": "node --check bin/wisp.js && node -e \"import('./server/index.js')\" && node --check electron/main.js"
+    "prepublishOnly": "node --check bin/wisp.js && node --check bin/mac-app.js && node -e \"import('./server/index.js')\" && node --check electron/main.js"
   },
   "engines": {
     "node": ">=20"