digital-brain 1.1.18 → 1.1.23

package/docs/AUTOMATIONS.md

@@ -163,11 +163,12 @@ Guardrails:
 - with `--provider codex-app`, requires a Codex desktop bridge automation/thread that writes response files
 - requires `--allow "Name"` or `--contact "+15551234567"` unless `--allow-all` is explicitly passed
 - single-threads reply generation so multiple incoming chats do not trigger overlapping sends
+- debounces live messages per chat, default 4000ms, so message bursts get one combined reply; override with `--reply-debounce-ms <ms>`
 - skips likely business, notification, OTP, and service chats unless `--include-businesses` is passed or the chat is explicitly allowlisted by name or contact number
 - processes unread chats on startup unless `--no-process-unread` is passed
 - skips groups unless `--include-groups` is passed
 - uses a per-chat cooldown, default 20 minutes
-- caps replies per chat per run, default 5
+- no reply cap by default, so conversations can continue naturally; pass `--max-replies-per-chat <n>` to add one
 - logs metadata by default, not full sent text
 - enforces the AI disclosure rule after repeated AI-assisted sends, but does not repeat it after that chat has already received a disclosure
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "digital-brain",
-  "version": "1.1.18",
+  "version": "1.1.23",
   "description": "Your private digital imprint for AI assistants.",
   "type": "module",
   "bin": {

package/whatsapp-web/auto-reply.mjs

@@ -39,8 +39,9 @@ const includeBusinesses = Boolean(args["include-businesses"]);
 const sendEnabled = Boolean(args.yes) || config.outboundMode === "auto-send";
 const processUnreadOnStart = !Boolean(args["no-process-unread"]);
 const cooldownMinutes = numberArg("cooldown-minutes", 20);
-const maxRepliesPerChat = numberArg("max-replies-per-chat", 5);
+const maxRepliesPerChat = numberArg("max-replies-per-chat", 0);
 const maxContextChars = numberArg("max-context-chars", 12000);
+const replyDebounceMs = numberArg("reply-debounce-ms", 4000);
 const outboundLogMode = args["log-mode"] || config.outboundLogMode || "metadata";
 const state = loadState();
 const whitelist = loadWhitelist();
@@ -48,6 +49,7 @@ const hasStoredScope = Object.keys(whitelist.allowedChats || {}).length > 0;
 const hasInitialScope = allowAll || allow.length > 0 || contactNumbers.length > 0 || hasStoredScope;
 const interactiveTerminal = Boolean(input.isTTY && output.isTTY);
 let queueTail = Promise.resolve();
+const pendingLiveReplies = new Map();
 const rl = interactiveTerminal ? readline.createInterface({ input, output }) : null;
 
 fs.mkdirSync(outboundDir, { recursive: true });
@@ -88,6 +90,8 @@ client.on("ready", async () => {
   if (provider === "codex") console.log(`Codex command: ${codexCommand}`);
   if (provider === "codex-app") console.log(`Codex App bridge: ${codexAppBridgeDir}`);
   if (!includeBusinesses) console.log("Likely business, notification, OTP, and service chats are skipped by default.");
+  console.log(maxRepliesPerChat > 0 ? `Reply cap: ${maxRepliesPerChat} per chat per run.` : "Reply cap: unlimited.");
+  console.log(`Live reply debounce: ${replyDebounceMs}ms.`);
   try {
     if (processUnreadOnStart) {
       await processUnreadChats();
@@ -103,7 +107,7 @@ client.on("ready", async () => {
 client.on("message", async (message) => {
   try {
     console.log(`Received WhatsApp message event: ${summarize(message.body || "[non-text message]")}`);
-    enqueueMessage(message);
+    await scheduleLiveMessage(message);
   } catch (error) {
     console.error(`Auto-reply error: ${error.message}`);
   }
@@ -129,7 +133,7 @@ async function processUnreadChats() {
       console.log(`Skipping unread chat during cooldown: ${name}`);
       continue;
     }
-    if (replyCount(name) >= maxRepliesPerChat) {
+    if (isAtReplyCap(name)) {
       console.log(`Skipping unread chat at reply cap: ${name}`);
       continue;
     }
@@ -189,6 +193,20 @@ function enqueueMessage(message, knownChat = null) {
   return queueTail;
 }
 
+async function scheduleLiveMessage(message) {
+  if (message.fromMe || message.isStatus) return;
+  const chat = await message.getChat();
+  const key = chatKey(chat);
+  const existing = pendingLiveReplies.get(key);
+  if (existing?.timer) clearTimeout(existing.timer);
+  const timer = setTimeout(() => {
+    pendingLiveReplies.delete(key);
+    enqueueMessage(message, chat);
+  }, replyDebounceMs);
+  pendingLiveReplies.set(key, { message, chat, timer });
+  console.log(`Queued debounced reply for ${chatName(chat)} in ${replyDebounceMs}ms.`);
+}
+
 async function ensureChatApproved(chat, recentMessages) {
   const name = chatName(chat);
   if (isExplicitlyAllowed(chat) || isChatWhitelisted(chat)) return true;
@@ -245,7 +263,7 @@ async function handleMessage(message, knownChat = null) {
     console.log(`Skipping chat during cooldown: ${name}`);
     return;
   }
-  if (replyCount(name) >= maxRepliesPerChat) {
+  if (isAtReplyCap(name)) {
     console.log(`Skipping chat at reply cap: ${name}`);
     return;
   }
@@ -273,7 +291,7 @@ async function handleMessage(message, knownChat = null) {
   const reply = await generateReply(prompt);
   console.log(`Generated reply for ${name} in ${Date.now() - startedAt}ms: ${summarize(reply || "[empty reply]")}`);
   const finalReply = disclosure.required && !containsDisclosure(reply)
-    ? `Just flagging this is my AI assistant helping draft/send this. ${reply}`
+    ? `btw ai is helping me reply rn. ${reply}`
     : reply;
 
   if (!finalReply.trim()) return;
@@ -298,16 +316,23 @@ function buildPrompt({ chatName, incomingBody, recentMessages, disclosureRequire
   return [
     "You are helping the user reply on WhatsApp.",
     "Write exactly one message to send as the user.",
-    "Be natural, concise, and relationship-appropriate.",
+    "Be natural, terse, and relationship-appropriate.",
+    "Default to 1-12 words for casual chats unless the incoming message clearly requires detail.",
     "First infer the immediate intent of the current conversation from the recent chat. Continue that thread only.",
+    "If the other person sent multiple messages in a row, answer the combined latest intent once.",
+    "Do not repeat facts, plans, suggestions, or context that were already stated in the recent chat unless confirming them briefly.",
+    "If the chat includes a URL, do not pretend you opened or inspected it. React only to what the sender said, or ask if the user should check it.",
     "Do not start with hey/hi unless the recent chat itself uses that greeting pattern.",
     "Mirror the vocabulary, register, and pacing already present in this chat.",
     "Match the user's own communication style from My Communication Style. If it says lowercase-heavy or undercapitalized, prefer lowercase casual texting.",
     "Use lexical signals from My Communication Style: recurring style words, openers, short phrase shapes, punctuation habits, and lowercase-i behavior.",
+    "Do not overuse bro, lol, haha, emojis, or question marks. Only use them if the recent chat clearly does.",
+    "Avoid assistant-like niceness and filler such as sounds perfect, happy to, sure thing, smooth, quick, no worries, no demon stuff, digital prep chef, digital neil, spitting facts, living in the future, or let’s unless that exact energy is already in the chat.",
+    "If the recipient asks about AI, answer directly in the user's casual tone and do not overexplain.",
     "Do not sound like customer support, corporate email, or a generic AI assistant.",
     "Use the user's local memory context, but do not reveal private notes or say you read a vault.",
     "Do not invent facts, commitments, times, or promises.",
-    disclosureRequired ? "This send requires AI disclosure. Include a short clear disclosure in the message." : "Do not mention AI unless disclosure is required.",
+    disclosureRequired ? "This send requires AI disclosure. Use a short casual disclosure like: btw ai is helping me reply rn. Do not make it cute or apologetic." : "Do not mention AI unless the incoming message asks about it.",
     "",
     `Chat: ${chatName}`,
     "",
@@ -370,8 +395,8 @@ async function generateOpenAiReply(prompt) {
       body: JSON.stringify({
         model,
         input: prompt,
-        max_output_tokens: 160,
-        temperature: 0.35,
+        max_output_tokens: 80,
+        temperature: 0.25,
       }),
     });
   } catch (error) {
@@ -686,6 +711,10 @@ function replyCount(name) {
   return state.sentCountByChat[name] || 0;
 }
 
+function isAtReplyCap(name) {
+  return maxRepliesPerChat > 0 && replyCount(name) >= maxRepliesPerChat;
+}
+
 function markProcessed(message, name, options = { sent: true }) {
   state.processedMessageIds.push(message.id?._serialized);
   state.processedMessageIds = state.processedMessageIds.filter(Boolean).slice(-1000);