@bill10/agent-007 0.13.0 → 0.14.0

package/VERSION

@@ -1 +1 @@
-0.13.0.0
+0.14.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bill10/agent-007",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "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

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