@bill10/agent-007 0.12.2001 → 0.12.2003

package/.env.example

@@ -65,6 +65,9 @@
 # Settings > Accessibility > Spoken Content > System voice > Manage Voices),
 # else say's default. A voice that is not installed is logged and skipped.
 # SAY_VOICE=Ava (Premium)
+# How fast it speaks, in words per minute (120-300). Unset: 205, a little faster
+# than say's own 175.
+# SAY_RATE=205
 # Your voice notes are transcribed with whisper.cpp (brew install whisper-cpp).
 # WHISPER_MODEL is the full path to a ggml model, e.g. ggml-base.en.bin;
 # WHISPER_CPP_BIN only if whisper-cli is not on PATH. Unset: voice notes get a

package/VERSION

@@ -1 +1 @@
-0.12.2.1
+0.12.2.3

package/bin/agent-007.js

@@ -48,6 +48,7 @@ Settings (default in brackets):
                           voice (macOS say + ffmpeg) [mirror]
   SAY_VOICE               macOS voice for that, from say -v '?' [best
                           installed English Premium/Enhanced voice]
+  SAY_RATE                How fast it speaks, words per minute, 120-300 [205]
   WHISPER_MODEL           whisper.cpp model file; your voice notes are
                           transcribed locally [off]
   WHISPER_CPP_BIN         whisper.cpp CLI if not on PATH [whisper-cli]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bill10/agent-007",
-  "version": "0.12.2001",
+  "version": "0.12.2003",
   "description": "From web terminals for your coding agents to a self-running agent company: Claude Code and Codex in parallel git worktrees, a job board they pick work from, and one agent that runs the board from a goal.",
   "license": "MIT",
   "repository": {

package/server/owner.js

@@ -16,7 +16,7 @@ import { CONFIG_DIR } from './state.js';
 import { liveBillion } from './billion.js';
 import { sendText } from './messages.js';
 import {
-  chooseMode, voiceSetting, speechUnavailable, synthesize, sayVoice, whisperSetup, transcribe, MAX_NOTE_SECONDS, MAX_NOTE_BYTES,
+  chooseMode, voiceSetting, speechUnavailable, synthesize, sayVoice, sayRate, whisperSetup, transcribe, MAX_NOTE_SECONDS, MAX_NOTE_BYTES,
 } from './voice.js';
 
 export const MAX_NOTIFY_CHARS = 3000;          // Telegram's own limit is 4096
@@ -59,11 +59,17 @@ async function call(method, params, { env = process.env, signal } = {}) {
       ...(form ? { body: params } : { headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(params) }),
       signal,
     });
-    body = await res.json().catch(() => ({ ok: false, description: `HTTP ${res.status}` }));
+    body = await res.json().catch(() => ({ ok: false, error_code: res.status, description: `HTTP ${res.status}` }));
   } catch (err) {
-    throw new Error(redact(err.cause?.message || err.message, env));
+    // reason: a short label for the poll loop's offline line.
+    const reason = /ENOTFOUND|EAI_AGAIN/.test(err.cause?.code) ? 'DNS'
+      : err.name === 'TimeoutError' || /timeout/i.test(err.message) ? 'timeout' : 'no network';
+    throw Object.assign(new Error(redact(err.cause?.message || err.message, env)), { reason });
+  }
+  if (!body?.ok) {
+    const status = body?.error_code;
+    throw Object.assign(new Error(redact(body?.description || 'Telegram said no', env)), { status, reason: status ? `HTTP ${status}` : 'Telegram said no' });
   }
-  if (!body?.ok) throw new Error(redact(body?.description || 'Telegram said no', env));
   return body.result;
 }
 
@@ -414,6 +420,16 @@ export async function pollOnce(offset, { broadcast, env = process.env, signal }
 
 let stopper = null;
 
+// Failures that retrying will not fix, and what the owner should do about them.
+const POLL_HINTS = {
+  401: 'the bot token is wrong or revoked',
+  409: 'another process is polling this bot',
+};
+const OFFLINE_AFTER_MS = 60 * 1000;
+const OFFLINE_AFTER_FAILURES = 3;
+
+const since = ms => ms < 120e3 ? `${Math.round(ms / 1000)}s` : `${Math.round(ms / 60e3)}m`;
+
 const pause = (ms, signal) => new Promise(resolve => {
   const timer = setTimeout(resolve, ms);
   signal.addEventListener('abort', () => { clearTimeout(timer); resolve(); }, { once: true });
@@ -425,20 +441,34 @@ export function startTelegram({ broadcast, env = process.env } = {}) {
   if (!chatId) console.log('  Telegram: send any message to your bot, then set TELEGRAM_CHAT_ID=<id> (the id is shown here when it arrives)');
   else console.log('  Telegram: on');
   if (voiceSetting(env) !== 'never' && !speechUnavailable(env)) {
-    sayVoice(env).then(v => console.log(`  Telegram: speaking with ${v ? `the ${v} voice` : "say's default voice"}`));
+    sayVoice(env).then(v => console.log(`  Telegram: speaking with ${v ? `the ${v} voice` : "say's default voice"} at ${sayRate(env)} wpm`));
   }
   const controller = new AbortController();
   stopper = controller;
   (async () => {
     let offset = 0;
     let backoff = 1000;
+    // Sleep, wake and network changes fail a poll or two; log only going
+    // offline and coming back, not every retry.
+    let failures = 0, failingSince = 0, offline = false;
     while (!controller.signal.aborted) {
       try {
         offset = await pollOnce(offset, { broadcast, env, signal: controller.signal });
+        if (offline) console.log(`Telegram: back online after ${since(Date.now() - failingSince)}`);
+        failures = 0;
+        offline = false;
         backoff = 1000;
       } catch (err) {
         if (controller.signal.aborted) break;
-        console.error(`Telegram: getUpdates failed (${err.message}); retrying in ${backoff / 1000}s`);
+        if (!failures++) failingSince = Date.now();
+        const hint = POLL_HINTS[err.status];
+        // A hint logs even mid-outage: a token revoked while offline still needs saying.
+        if (hint ? offline !== hint : !offline && (failures >= OFFLINE_AFTER_FAILURES || Date.now() - failingSince > OFFLINE_AFTER_MS)) {
+          offline = hint || true;
+          console.error(hint
+            ? `Telegram: getUpdates failed (${err.message}): ${hint}; retrying quietly`
+            : `Telegram: offline (${err.reason || 'no network'}), retrying quietly`);
+        }
         await pause(backoff, controller.signal);
         backoff = Math.min(backoff * 2, MAX_BACKOFF_MS);
       }

package/server/voice.js

@@ -120,13 +120,26 @@ export function sayVoice(env = process.env) {
   return voicePick;
 }
 
+// SAY_RATE in words per minute, 120–300. Unset: 205, about 15% faster than
+// say's own 175, which the owner found a little slow on Ava (Premium).
+export const DEFAULT_SAY_RATE = 205;
+let ratePick;
+export function sayRate(env = process.env) {
+  if (ratePick) return ratePick;
+  const raw = (env.SAY_RATE || '').trim();
+  const n = Number(raw);
+  if (raw && !Number.isInteger(n)) console.log(`  Telegram: SAY_RATE "${raw}" is not a whole number of words per minute; using ${DEFAULT_SAY_RATE}`);
+  ratePick = raw && Number.isInteger(n) ? Math.min(300, Math.max(120, n)) : DEFAULT_SAY_RATE;
+  return ratePick;
+}
+
 // text → OGG/Opus bytes. URLs are said as "link"; the caption carries them.
 export function synthesize(text, env = process.env) {
   return inTempDir(async dir => {
     const txt = join(dir, 'say.txt'), aiff = join(dir, 'say.aiff'), ogg = join(dir, 'say.ogg');
     await writeFile(txt, text.replace(URL_RE, 'link'));
     const voice = await sayVoice(env);
-    await run('say', [...(voice ? ['-v', voice] : []), '-o', aiff, '-f', txt]);
+    await run('say', [...(voice ? ['-v', voice] : []), '-o', aiff, '-r', String(sayRate(env)), '-f', txt]);
     await run('ffmpeg', ['-y', '-loglevel', 'error', '-protocol_whitelist', 'file', '-i', aiff, '-c:a', 'libopus', '-b:a', '32k', ogg]);
     return readFile(ogg);
   });