@bill10/agent-007 0.13.0 → 0.14.1

package/.env.example

@@ -65,8 +65,8 @@
 # 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.
+# How fast it speaks, in words per minute (120-300). Unset: no -r is passed, so
+# each voice speaks at its own system default speed.
 # 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;

package/VERSION

@@ -1 +1 @@
-0.13.0.0
+0.14.0.1

package/bin/agent-007.js

@@ -48,7 +48,8 @@ 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]
+  SAY_RATE                How fast it speaks, words per minute, 120-300
+                          [unset: the voice's own system speed]
   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.13.0",
+  "version": "0.14.1",
   "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/http.js

@@ -17,7 +17,7 @@ import { expandHome } from '../lib/helpers.js';
 import { requestApproval, answerApproval, readApproval } from './approvals.js';
 import { agentSummaries, sendMessage, flushMessages, pendingMessages, readAgentScreen } from './messages.js';
 import { handleMcpMessage } from './mcp.js';
-import { notifyOwner } from './owner.js';
+import { notifyOwner, tellOwner } from './owner.js';
 import { availableModels } from './models.js';
 
 // --- Origin Check Middleware (B2) ---
@@ -138,6 +138,9 @@ export function setupRoutes(app, staticDir, { broadcast, killSession, respawnAge
         notifyOwner: (text, { choices, recommended } = {}) => (req.agentSession.isBillion
           ? notifyOwner(text, { choices, recommended, broadcast })
           : { error: 'Only Billion can notify the owner.' }),
+        tellOwner: (text) => (req.agentSession.isBillion
+          ? tellOwner(text)
+          : { error: 'Only Billion can message the owner.' }),
         // Never logged: a screen can hold a secret that scrolled by.
         readAgentScreen: ({ name, lines }) => readAgentScreen({
           from: req.agentSession, name, lines, sessions,

package/server/mcp.js

@@ -382,6 +382,23 @@ export const NOTIFY_OWNER_TOOL = {
   },
 };
 
+export const TELL_OWNER_TOOL = {
+  name: 'tell_owner',
+  description:
+    'Send the owner a reply or status update that needs no answer ("Got it", '
+    + '"Restart looks clean") over Telegram. Unlike notify_owner it files nothing '
+    + 'under "Waiting on you". Use it to answer an [Owner via Telegram] message '
+    + 'that is not a question. Shares notify_owner\'s limit of a few per minute.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      text: { type: 'string', description: 'The message, written to be read on a phone.' },
+    },
+    required: ['text'],
+    additionalProperties: false,
+  },
+};
+
 // Billion's too: reading is narrower than messaging (server/messages.js,
 // readAgentScreen), so it is only for the workers on Billion's own cards.
 export const READ_AGENT_SCREEN_TOOL = {
@@ -428,7 +445,7 @@ export const RESPAWN_AGENT_TOOL = {
 };
 
 export const TOOLS = [POST_JOB_TOOL, LIST_JOBS_TOOL, READ_JOB_TOOL, EDIT_JOB_TOOL, FINISH_JOB_TOOL, LIST_AGENTS_TOOL, SEND_MESSAGE_TOOL];
-const BILLION_TOOLS = [BILLION_READY_TOOL, ADD_REPO_TOOL, CLOSE_JOB_TOOL, ANSWER_PERMISSION_TOOL, READ_APPROVAL_TOOL, NOTIFY_OWNER_TOOL, READ_AGENT_SCREEN_TOOL, RESPAWN_AGENT_TOOL];
+const BILLION_TOOLS = [BILLION_READY_TOOL, ADD_REPO_TOOL, CLOSE_JOB_TOOL, ANSWER_PERMISSION_TOOL, READ_APPROVAL_TOOL, NOTIFY_OWNER_TOOL, TELL_OWNER_TOOL, READ_AGENT_SCREEN_TOOL, RESPAWN_AGENT_TOOL];
 
 // `models` is { claude: [...], codex: [...] } as server/models.js last found them.
 export function toolsFor(session, models) {
@@ -670,6 +687,12 @@ const CALLS = {
     return toolText(`Sent to the owner on Telegram and put under "Waiting on you" as Q${result.n}. Keep working on everything else; their answer, if any, arrives here as [Owner via app] Q${result.n}: … or [Owner via Telegram] Q${result.n}: ….`);
   },
 
+  [TELL_OWNER_TOOL.name]: async (args, ctx) => {
+    const result = ctx.tellOwner ? await ctx.tellOwner(args.text) : { error: 'Only Billion can message the owner.' };
+    if (result.error) return toolText(result.error, true);
+    return toolText('Sent to the owner on Telegram.');
+  },
+
   // Quoted line by line, like a message body, so the screen cannot pass for
   // anything but a quote — nor close the block and carry on as the server.
   [READ_AGENT_SCREEN_TOOL.name]: (args, ctx) => {

package/server/owner.js

@@ -1,5 +1,5 @@
 // Reaching the owner when they are away from the terminal: Billion's
-// notify_owner tool, the "Waiting on you" tab it fills in the browser (where
+// notify_owner tool (questions) and tell_owner (replies that need no answer), the "Waiting on you" tab it fills in the browser (where
 // the owner can answer too), and a Telegram bot that carries both ways (docs/BILLION.md, "Telegram").
 //
 // Telegram is optional: with TELEGRAM_BOT_TOKEN unset nothing here talks to
@@ -320,6 +320,25 @@ export async function notifyOwner(text, { choices, recommended, broadcast, env =
   return { ok: true, n: item?.n };
 }
 
+// --- tell_owner: a reply or status update, no Waiting item, no badge ---
+
+export async function tellOwner(text, { env = process.env, now = Date.now(), platform = process.platform } = {}) {
+  const body = typeof text === 'string' ? text.trim() : '';
+  if (!body) return { error: 'The message is empty.' };
+  if (body.length > MAX_NOTIFY_CHARS) return { error: `The message is ${body.length} characters; keep it under ${MAX_NOTIFY_CHARS}.` };
+  const { token, chatId } = telegramSettings(env);
+  if (!token || !chatId) return { error: 'Telegram is not set up; say it in your terminal.' };
+  // Shares notify_owner's limit: both land on the same phone.
+  sent = sent.filter(t => now - t < NOTIFY_WINDOW_MS);
+  if (sent.length >= NOTIFY_LIMIT) {
+    return { error: `Not sent: you have messaged the owner ${NOTIFY_LIMIT} times in the last minute. Put the rest in one message later.` };
+  }
+  sent.push(now);
+  const result = await sendToOwner(`Billion: ${body}`, { env, platform });
+  if (result.error) return { error: `The Telegram send failed: ${result.error}` };
+  return { ok: true };
+}
+
 // --- Replies: long-polling getUpdates ---
 
 const discovered = new Set();   // chat ids already shown, so a stranger's first message cannot hide the owner's
@@ -441,7 +460,10 @@ 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"} at ${sayRate(env)} wpm`));
+    sayVoice(env).then(v => {
+      const rate = sayRate(env);
+      console.log(`  Telegram: speaking with ${v ? `the ${v} voice` : "say's default voice"} at ${rate ? `${rate} wpm` : 'the system default speed'}`);
+    });
   }
   const controller = new AbortController();
   stopper = controller;

package/server/voice.js

@@ -120,17 +120,19 @@ 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;
+// SAY_RATE in words per minute, 120–300. Unset (or invalid): null, so `say`
+// is not given `-r` at all and speaks at the voice's own system rate.
+let ratePick, ratePicked = false;
 export function sayRate(env = process.env) {
-  if (ratePick) return ratePick;
+  if (ratePicked) return ratePick;
+  ratePicked = true;
   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;
+  if (raw && !Number.isInteger(n)) {
+    console.log(`  Telegram: SAY_RATE "${raw}" is not a whole number of words per minute; using the system default speed`);
+    return ratePick = null;
+  }
+  return ratePick = raw ? Math.min(300, Math.max(120, n)) : null;
 }
 
 // text → OGG/Opus bytes. URLs are said as "link"; the caption carries them.
@@ -139,7 +141,8 @@ export function synthesize(text, env = process.env) {
     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, '-r', String(sayRate(env)), '-f', txt]);
+    const rate = sayRate(env);
+    await run('say', [...(voice ? ['-v', voice] : []), '-o', aiff, ...(rate ? ['-r', String(rate)] : []), '-f', txt]);
     await run('ffmpeg', ['-y', '-loglevel', 'error', '-protocol_whitelist', 'file', '-i', aiff, '-c:a', 'libopus', '-b:a', '32k', ogg]);
     return readFile(ogg);
   });

package/templates/billion/charter.md

@@ -233,6 +233,12 @@ owner's words too, transcribed by machine: read it as theirs but allow for
 transcription errors, and ask back if something is ambiguous and risky. A
 `(caption: ...)` at its end is text the owner typed on the note.
 
+`notify_owner` is for questions and decisions only: every call files a
+numbered item the owner has to clear. For replies and status updates that
+need no answer ("Got it, restart looks clean"), use `tell_owner`: it reaches
+the owner's phone the same way but files nothing. Answer an
+`[Owner via Telegram]` message that isn't a question with `tell_owner`.
+
 ## Tools and limits
 
 The `agent-007-board` MCP tools:
@@ -251,6 +257,8 @@ The `agent-007-board` MCP tools:
 - `billion_ready`: opens your inbox (see **Operating loop**).
 - `add_repo`: puts a repository on the board so cards can be posted in it.
 - `notify_owner`: puts a question in front of the owner (see **Escalate**).
+- `tell_owner`: a reply or status update to the owner's phone that needs no
+  answer; files no *Waiting on you* item (see **Escalate**).
 - `answer_permission`: your answer to a worker's permission request (see
   **Approvals**).
 - `read_approval`: a waiting permission request in full, so you can judge