opencode-enhancer 1.0.8 → 1.2.0

package/README.md

@@ -1,6 +1,6 @@
 # opencode-enhancer
 
-OpenCode enhancer for Codex accounts, usage tracking, plugin updates, and future automation.
+OpenCode enhancer for Codex accounts, usage tracking, plugin updates.
 
 ## What It Does
 
@@ -68,7 +68,7 @@ opencode-enhancer plugins update --dry-run
 
 Default paths:
 
-- store: `~/.config/opencode-enhancer/accounts.json`
+- store: `~/.config/opencode-enhancer/settings.json`
 - logs: `~/.config/opencode-enhancer/logs/codex-soft.log`
 - usage cache: `~/.cache/opencode-enhancer/usage-cache.json`
 
@@ -91,3 +91,95 @@ Examples:
 - `OPENCODE_ENHANCER_DEBUG`
 - `OPENCODE_ENHANCER_USAGE_BASE_URL`
 - `OPENCODE_ENHANCER_REFRESH_QUEUE_CONCURRENCY`
+
+Notification-specific examples:
+
+- `OPENCODE_ENHANCER_NOTIFY=1`
+- `OPENCODE_ENHANCER_NOTIFY_BACKEND=auto`
+- `OPENCODE_ENHANCER_NOTIFY_BACKEND=terminal`
+- `OPENCODE_ENHANCER_NOTIFY_BACKEND=system`
+- `OPENCODE_ENHANCER_NOTIFY_NTFY_URL=...`
+
+## Notification Settings JSON
+
+Per-event notification toggles live in the persisted store JSON (`~/.config/opencode-enhancer/settings.json`, key `settings.notifications`).
+
+Default values:
+
+```json
+{
+  "settings": {
+    "notifications": {
+      "permissionRequest": true,
+      "taskComplete": true,
+      "error": true,
+      "question": true
+    }
+  }
+}
+```
+
+These toggles control notifications when the agent:
+
+- asks for permissions
+- finishes a task
+- emits an error
+- asks the user a question
+
+## Terminal-native Notifications
+
+`opencode-enhancer` can now prefer terminal-native desktop notifications emitted through OSC escape sequences instead of AppleScript-style macOS notifications.
+
+Backend selection is controlled with:
+
+```bash
+OPENCODE_ENHANCER_NOTIFY_BACKEND=auto
+```
+
+Supported values:
+
+- `auto` - prefer terminal-native notifications when running in a supported terminal with access to a real TTY; otherwise fall back to the existing system backend
+- `terminal` - use terminal-native notifications only; do not fall back to the system backend
+- `system` - always use the existing system backend (`osascript` / `terminal-notifier` on macOS)
+
+Current terminal-native target matrix:
+
+- Ghostty - supported via `OSC 9`
+- iTerm2 - supported via `OSC 9`
+- kitty - supported via legacy `OSC 9`
+- WezTerm - supported via `OSC 9` (visibility depends on WezTerm notification settings)
+
+Notes and limitations:
+
+- Terminal-native notifications require the plugin process to reach the controlling terminal. The implementation first tries `/dev/tty`, then falls back to a TTY stderr/stdout stream.
+- `tmux`, `screen`, and `zellij` are not supported in this first slice; they may intercept OSC unless passthrough is configured.
+- On macOS/Linux, the terminal app itself must be allowed to show notifications by the OS.
+- In WezTerm, `notification_handling` must not be set to `NeverShow`.
+- Terminal-native notifications intentionally use a compact single-line payload. Click-to-open URLs are still only available through the existing system backend.
+
+Quick manual checks:
+
+```bash
+# Ghostty / iTerm2 / kitty / WezTerm
+printf '\e]9;OpenCode test notification\e\\'
+```
+
+Repo helper for a quick smoke test:
+
+```bash
+npm run notify:smoke
+npm run notify:smoke -- --check
+npm run notify:smoke -- --title "OpenCode smoke" --message "Ghostty/iTerm2/kitty/WezTerm"
+```
+
+What it does:
+
+- detects whether the current terminal matches the same support heuristic used by the plugin
+- prints TTY diagnostics (`/dev/tty`, `stderr.isTTY`, `stdout.isTTY`)
+- sends a single `OSC 9` notification when supported
+
+If you want the old behavior regardless of terminal support:
+
+```bash
+OPENCODE_ENHANCER_NOTIFY_BACKEND=system
+```

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { Plugin } from '@opencode-ai/plugin';
+import type { Plugin } from "@opencode-ai/plugin";
 /**
  * Multi-account OAuth plugin for OpenCode
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,qBAAqB,CAAA;AAqQ9D;;;;GAIG;AACH,QAAA,MAAM,eAAe,EAAE,MAy4BtB,CAAA;AAED,eAAe,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,qBAAqB,CAAC;AAkR/D;;;;GAIG;AACH,QAAA,MAAM,eAAe,EAAE,MA2tCtB,CAAC;AAEF,eAAe,eAAe,CAAC"}