helloagents 3.0.23 → 3.0.26

package/scripts/notify-route.mjs

@@ -38,6 +38,7 @@ function routeExplicitCommand({
   appendReplayEvent,
   buildRouteInstruction,
   suppress,
+  recordReplayEvents,
 }) {
   const cmdMatch = prompt.match(/^~(\w+)/)
   if (!cmdMatch) return false
@@ -50,14 +51,16 @@ function routeExplicitCommand({
     sourceSkillName: skillName,
     payload,
   })
-  appendReplayEvent(cwd, {
-    host,
-    event: 'command_route_selected',
-    source: 'route',
-    skillName: canonicalSkillName,
-    sourceSkillName: skillName,
-    payload,
-  })
+  if (recordReplayEvents !== false) {
+    appendReplayEvent(cwd, {
+      host,
+      event: 'command_route_selected',
+      source: 'route',
+      skillName: canonicalSkillName,
+      sourceSkillName: skillName,
+      payload,
+    })
+  }
   suppress(buildRouteInstruction({
     skillName,
     extraRules: buildHelpExtraRules(skillName),
@@ -84,6 +87,7 @@ export function handleRouteCommand({
   getWorkflowRecommendation,
   suppress,
   emptySuppress,
+  recordReplayEvents = true,
 }) {
   const prompt = (payload.prompt || '').trim()
   const cwd = payload.cwd || process.cwd()
@@ -105,6 +109,7 @@ export function handleRouteCommand({
     appendReplayEvent,
     buildRouteInstruction,
     suppress,
+    recordReplayEvents,
   })) {
     return
   }
@@ -112,13 +117,15 @@ export function handleRouteCommand({
   const bootstrapFile = resolveBootstrapFile(cwd, settings, host)
   if (bootstrapFile === 'bootstrap.md') {
     clearRouteContext({ cwd, payload })
-    appendReplayEvent(cwd, {
-      host,
-      event: 'semantic_route_prompted',
-      source: 'route',
-      recommendation: getWorkflowRecommendation(cwd, { payload }),
-      payload,
-    })
+    if (recordReplayEvents !== false) {
+      appendReplayEvent(cwd, {
+        host,
+        event: 'semantic_route_prompted',
+        source: 'route',
+        recommendation: getWorkflowRecommendation(cwd, { payload }),
+        payload,
+      })
+    }
     suppress(buildSemanticRouteInstruction(cwd, payload))
     return
   }

package/scripts/notify-sound.mjs

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { platform } from 'node:os'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const PKG_ROOT = join(__dirname, '..')
+const PLAT = platform()
+
+function shellQuote(value = '') {
+  return `'${String(value).replace(/'/g, `'\\''`)}'`
+}
+
+export function resolveSoundPath(event = '', pkgRoot = PKG_ROOT) {
+  const filePath = join(pkgRoot, 'assets', 'sounds', `${event}.wav`)
+  return existsSync(filePath) ? filePath : ''
+}
+
+export function buildWindowsSoundCommand(filePath = '') {
+  return `(New-Object System.Media.SoundPlayer '${String(filePath || '').replace(/'/g, "''")}').PlaySync()`
+}
+
+function playWindows(filePath) {
+  const result = spawnSync('powershell', [
+    '-NoProfile',
+    '-c',
+    buildWindowsSoundCommand(filePath),
+  ], {
+    encoding: 'utf-8',
+    windowsHide: true,
+  })
+
+  if (result.error) throw result.error
+  if (result.status !== 0) {
+    throw new Error((result.stderr || result.stdout || 'PowerShell sound playback failed').trim())
+  }
+}
+
+function playMac(filePath) {
+  const result = spawnSync('afplay', [filePath], {
+    encoding: 'utf-8',
+  })
+  if (result.error) throw result.error
+  if (result.status !== 0) {
+    throw new Error((result.stderr || result.stdout || 'afplay failed').trim())
+  }
+}
+
+function playLinux(filePath) {
+  const script = `if command -v aplay >/dev/null 2>&1; then aplay -q ${shellQuote(filePath)}; elif command -v paplay >/dev/null 2>&1; then paplay ${shellQuote(filePath)}; else printf '\\a'; fi`
+  const result = spawnSync('sh', ['-c', script], {
+    encoding: 'utf-8',
+  })
+  if (result.error) throw result.error
+  if (result.status !== 0) {
+    throw new Error((result.stderr || result.stdout || 'Linux sound playback failed').trim())
+  }
+}
+
+export function playSoundEvent(event = '', pkgRoot = PKG_ROOT) {
+  const soundPath = resolveSoundPath(event, pkgRoot)
+  if (!soundPath) {
+    process.stderr.write('\x07')
+    return false
+  }
+
+  if (PLAT === 'win32') {
+    playWindows(soundPath)
+    return true
+  }
+  if (PLAT === 'darwin') {
+    playMac(soundPath)
+    return true
+  }
+
+  playLinux(soundPath)
+  return true
+}
+
+function main() {
+  const event = process.argv[2] || 'complete'
+  try {
+    playSoundEvent(event)
+  } catch {
+    process.stderr.write('\x07')
+  }
+}
+
+if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
+  main()
+}

package/scripts/notify-ui.mjs

@@ -5,7 +5,7 @@
 import { platform } from 'node:os';
 import { join } from 'node:path';
 import { existsSync } from 'node:fs';
-import { spawnSync } from 'node:child_process';
+import { execFileSync, spawn } from 'node:child_process';
 
 const PLAT = platform();
 
@@ -55,33 +55,65 @@ function resolveWav(pkgRoot, event) {
   return existsSync(p) ? p : null;
 }
 
-function runSync(command, args) {
+function resolveSoundHelper(pkgRoot) {
+  const helperPath = join(pkgRoot, 'scripts', 'notify-sound.mjs');
+  return existsSync(helperPath) ? helperPath : '';
+}
+
+function runDetached(command, args) {
   try {
-    const result = spawnSync(command, args, {
+    const child = spawn(command, args, {
       stdio: 'ignore',
+      detached: true,
       windowsHide: true,
     });
-    return !result.error && result.status === 0;
+    child.on('error', () => {});
+    child.unref();
+    return true;
   } catch {
     return false;
   }
 }
 
-export function playSound(pkgRoot, event) {
+function shellQuote(value = '') {
+  return `'${String(value).replace(/'/g, `'\\''`)}'`
+}
+
+function runSoundHelper(pkgRoot, event, mode = 'background') {
+  const helperPath = resolveSoundHelper(pkgRoot);
+  if (!helperPath) return false;
+
+  if (mode === 'blocking') {
+    try {
+      execFileSync(process.execPath, [helperPath, event], {
+        stdio: 'ignore',
+        windowsHide: true,
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  return runDetached(process.execPath, [helperPath, event]);
+}
+
+export function playSound(pkgRoot, event, options = {}) {
   if (DISABLE_OS_NOTIFICATIONS) return;
   const wav = resolveWav(pkgRoot, event);
   if (!wav) { process.stderr.write('\x07'); return; }
+  if (runSoundHelper(pkgRoot, event, options.mode === 'blocking' ? 'blocking' : 'background')) return;
   try {
     if (PLAT === 'win32') {
-      runSync('powershell', [
+      runDetached('powershell', [
         '-NoProfile',
         '-c',
         `(New-Object Media.SoundPlayer '${wav.replace(/'/g, "''")}').PlaySync()`,
       ]);
     } else if (PLAT === 'darwin') {
-      runSync('afplay', [wav]);
+      runDetached('afplay', [wav]);
     } else {
-      if (!runSync('aplay', ['-q', wav]) && !runSync('paplay', [wav])) process.stderr.write('\x07');
+      runDetached('sh', ['-c', `if command -v aplay >/dev/null 2>&1; then aplay -q ${shellQuote(wav)}; elif command -v paplay >/dev/null 2>&1; then paplay ${shellQuote(wav)}; else printf '\\a'; fi`]);
     }
   } catch { process.stderr.write('\x07'); }
 }
@@ -124,16 +156,16 @@ export function desktopNotify(pkgRoot, event, extra) {
   try {
     if (PLAT === 'win32') {
       const iconPath = join(pkgRoot, 'assets', 'icons', 'icon.png').replace(/\//g, '\\');
-      runSync('powershell', ['-NoProfile', '-c', buildWindowsToastScript(notification, iconPath)]);
+      runDetached('powershell', ['-NoProfile', '-c', buildWindowsToastScript(notification, iconPath)]);
     } else if (PLAT === 'darwin') {
       const subtitle = notification.sourceLabel
         ? ` subtitle "${escapeAppleScriptText(notification.sourceLabel)}"`
         : '';
-      runSync('osascript', ['-e',
+      runDetached('osascript', ['-e',
         `display notification "${escapeAppleScriptText(notification.message)}" with title "${escapeAppleScriptText(notification.title)}"${subtitle}`],
       );
     } else {
-      if (!runSync('notify-send', [notification.title, notification.body])) process.stderr.write('\x07');
+      runDetached('sh', ['-c', `if command -v notify-send >/dev/null 2>&1; then notify-send ${shellQuote(notification.title)} ${shellQuote(notification.body)}; else printf '\\a'; fi`]);
     }
   } catch { process.stderr.write('\x07'); }
 }