@event4u/agent-switch 2.3.0 → 2.3.1

package/dist/daemon.js

@@ -46,12 +46,29 @@ import { execFileSync } from "node:child_process";
  *  daemon-side OS notifications, fire a desktop notification too — marking the
  *  record so the GUI does not show it a second time. Deduped events (append
  *  returns null) never OS-notify. */
-function notify(event) {
+function notify(event, opts = {}) {
     const created = appendNotification(event);
-    if (created && readOsNotifications() && osNotify(event.title, event.message)) {
+    if (created && opts.os !== false && readOsNotifications() && osNotify(event.title, event.message)) {
         markOsNotified(created.id);
     }
 }
+/** How long reads must fail before it counts as an outage. A single failed read
+ *  is routine — a rate-limited endpoint answers again a minute later — and the
+ *  last known values keep being served meanwhile. */
+export const FETCH_OUTAGE_MS = 15 * 60_000;
+/** The notice for a profile whose reads have failed since `sinceMs`, or null
+ *  while it is still a blip. Kept off the desktop: a fetch failure is a
+ *  diagnostic for the app's log, not something to interrupt anyone for. */
+export function fetchFailureNotice(key, sinceMs, now) {
+    if (now - sinceMs < FETCH_OUTAGE_MS)
+        return null;
+    return {
+        kind: "warning",
+        title: "Usage fetch failed",
+        message: `Could not fetch usage limits for ${key} for ${Math.round((now - sinceMs) / 60_000)} min. Keeping the last known values.`,
+        os: false,
+    };
+}
 // Providers the daemon may suggest a switch for on threshold (they expose a
 // usage readout to base a headroom suggestion on). Antigravity has none.
 const AUTO_PROVIDERS = ["claude", "codex"];
@@ -319,24 +336,23 @@ async function pollProvider(provider, state, thresholds, notifiedReset, log) {
     let failures = 0;
     const polled = [];
     state.notifiedFetchFail = state.notifiedFetchFail ?? {};
+    state.fetchFailingSince = state.fetchFailingSince ?? {};
     for (const name of targets) {
         const key = `${provider}/${name}`;
         const snapshot = await snapshotFor(provider, name);
         if (!snapshot) {
             failures++;
             // Fail-safe: the last-known snapshot in state.profiles[key] is left intact
-            // (never overwritten with null), and we warn ONCE per outage rather than
-            // every cycle — the loop keeps serving the last good numbers meanwhile.
-            if (!state.notifiedFetchFail[key]) {
+            // (never overwritten with null). Only an outage is reported, once.
+            const since = state.fetchFailingSince[key] ?? (state.fetchFailingSince[key] = new Date().toISOString());
+            const notice = state.notifiedFetchFail[key] ? null : fetchFailureNotice(key, Date.parse(since), Date.now());
+            if (notice) {
                 state.notifiedFetchFail[key] = true;
-                notify({
-                    kind: "warning",
-                    title: "Usage fetch failed",
-                    message: `Could not fetch usage limits for ${provider}/${name}. Keeping the last known values.`,
-                });
+                notify(notice, { os: notice.os });
             }
             continue;
         }
+        delete state.fetchFailingSince[key];
         if (state.notifiedFetchFail[key]) {
             delete state.notifiedFetchFail[key];
             log(`recovered: ${provider}/${name} usage fetch succeeded again`);

package/dist/index.js

@@ -2058,8 +2058,11 @@ function cmdOsNotify(sub, json = false) {
     const enabled = readOsNotifications();
     if (json)
         console.log(JSON.stringify({ enabled }));
-    else
+    else {
         console.log(`Daemon OS notifications ${enabled ? "ON" : "OFF"}.`);
+        if (enabled && process.platform === "darwin")
+            console.log("On macOS the daemon shows none itself — the Agent Switch app shows them while it runs.");
+    }
 }
 /** `agent-switch notifications [clear] [--json]` — list the recent
  *  notifications (newest first) or clear the log. */
@@ -2521,7 +2524,7 @@ Run with no command to launch the tray/menubar GUI (single-instance).
   agent-switch service run|start|stop|status|install|uninstall   background usage daemon
   agent-switch notifications [clear] [--json]  recent notifications (usage-limit suggestions, fetch failures)
   agent-switch notify --kind K --title T --message M [--json]   record a notification event
-  agent-switch os-notify [on|off|status] [--json]   daemon-side OS desktop notifications (default off)
+  agent-switch os-notify [on|off|status] [--json]   daemon-side OS desktop notifications, Linux/Windows (default off; macOS: the app shows them)
   agent-switch uninstall [--force]             remove all agent-switch data + daemon
   agent-switch usage history [--provider P] [--profile <name>] [--json]   daemon-recorded usage samples per profile
   agent-switch tooling [--json]                ecosystem tool readout (agent-config, rtk, provider CLIs)

package/dist/os-notify.js

@@ -2,7 +2,9 @@
  * Best-effort OS desktop notifications for the background daemon, so an
  * auto-switch is visible even when the GUI is closed. Per-platform native
  * command, no external dependency:
- *   - macOS   → `osascript -e 'display notification …'`
+ *   - macOS   → nothing: an `osascript` notification is attributed to Script
+ *               Editor. The Agent Switch app shows the notice itself when it
+ *               runs (records not marked OS-notified), otherwise no one does.
  *   - Linux   → `notify-send <title> <body>`
  *   - Windows → PowerShell balloon tip via System.Windows.Forms.NotifyIcon
  *
@@ -10,10 +12,6 @@
  * testable; `osNotify` wraps it with a fire-and-forget spawn that never throws.
  */
 import { spawnSync } from "node:child_process";
-/** AppleScript string literal escaping: backslash and double-quote only. */
-function escAppleScript(s) {
-    return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
-}
 /** PowerShell single-quoted string literal escaping: double the single quote. */
 function escPowerShellSingle(s) {
     return s.replace(/'/g, "''");
@@ -23,10 +21,6 @@ function escPowerShellSingle(s) {
  * `platform` matches `process.platform` values (`darwin` / `linux` / `win32`).
  */
 export function buildOsNotifyCommand(platform, title, body) {
-    if (platform === "darwin") {
-        const script = `display notification "${escAppleScript(body)}" with title "${escAppleScript(title)}"`;
-        return { program: "osascript", args: ["-e", script] };
-    }
     if (platform === "linux") {
         // notify-send treats the first arg as summary, the second as body.
         return { program: "notify-send", args: [title, body] };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@event4u/agent-switch",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "Switch between multiple Claude Code accounts on macOS, Linux, and Windows via isolated CLAUDE_CONFIG_DIR profiles",
   "repository": {
     "type": "git",