@c4t4/heyamigo 0.1.14 → 0.1.16

package/README.md

@@ -190,7 +190,7 @@ Core settings. The wizard sets these up, but you can edit anytime.
 {
   "owner": { "number": "17861234567" },
   "triggers": { "aliases": ["heyamigo", "amigo", "claude"], "groupMode": "mention" },
-  "claude": { "model": "claude-opus-4-6", "timeoutMs": 60000 },
+  "claude": { "model": "claude-opus-4-7", "timeoutMs": 60000 },
   "reply": { "quoteInGroups": true, "typingIndicator": true }
 }
 ```

package/config/access.example.json

@@ -52,14 +52,16 @@
       "jid": "120363xxxxx@g.us",
       "name": "Family Chat",
       "mode": "active",
-      "allowedSenders": "*"
+      "allowedSenders": "*",
+      "proactive": false
     },
     {
-      "_note": "Active group, only specific people can trigger",
+      "_note": "Active group, only specific people can trigger. Bot can also initiate messages here.",
       "jid": "120363yyyyy@g.us",
       "name": "Work Team",
       "mode": "active",
-      "allowedSenders": ["17861234567", "491701234567"]
+      "allowedSenders": ["17861234567", "491701234567"],
+      "proactive": true
     },
     {
       "_note": "Silent group: stores messages but never responds",
@@ -81,8 +83,8 @@
     "_readme": "Matched by chat partner number, not sender. Owner messages in DMs are always silent.",
     "defaultMode": "off",
     "allowed": [
-      { "_note": "friend can DM the bot", "number": "491701234567", "mode": "active" },
-      { "_note": "colleague, store messages but don't respond", "number": "5511987654321", "mode": "silent" }
+      { "_note": "friend can DM the bot, and bot can proactively message them", "number": "491701234567", "mode": "active", "proactive": true },
+      { "_note": "colleague, store messages but don't respond", "number": "5511987654321", "mode": "silent", "proactive": false }
     ]
   }
 }

package/config/config.example.json

@@ -6,7 +6,8 @@
 
   "owner": {
     "number": "",
-    "treatAsAllowedEverywhere": true
+    "treatAsAllowedEverywhere": true,
+    "timezone": "UTC"
   },
 
   "triggers": {
@@ -24,7 +25,7 @@
   },
 
   "claude": {
-    "model": "claude-opus-4-6",
+    "model": "claude-opus-4-7",
     "personalityFile": "./config/personalities/sharp.md",
     "addDirs": ["./config/knowledge"],
     "outputFormat": "json",
@@ -34,7 +35,8 @@
   "bootstrap": {
     "historyDepth": 50,
     "includeHistory": true,
-    "includeChatMetadata": true
+    "includeChatMetadata": true,
+    "recentContextDepth": 3
   },
 
   "reply": {

package/dist/cli/setup.js

@@ -610,7 +610,7 @@ export async function runSetup() {
         message: 'Choose a Claude model',
         options: [
             {
-                value: 'claude-opus-4-6',
+                value: 'claude-opus-4-7',
                 label: 'Opus',
                 hint: 'highest quality, recommended (default)',
             },
@@ -620,7 +620,7 @@ export async function runSetup() {
                 hint: 'faster, lower cost',
             },
         ],
-        initialValue: 'claude-opus-4-6',
+        initialValue: 'claude-opus-4-7',
     });
     if (!p.isCancel(model)) {
         const configPath = resolve(cwd, 'config/config.json');
@@ -630,7 +630,7 @@ export async function runSetup() {
             writeFileSync(configPath, cfg);
             const label = model === 'claude-sonnet-4-6'
                 ? 'Sonnet'
-                : model === 'claude-opus-4-6'
+                : model === 'claude-opus-4-7'
                     ? 'Opus'
                     : 'Haiku';
             p.log.success(`Model: ${label}`);

package/dist/config.js

@@ -10,6 +10,7 @@ const ConfigSchema = z.object({
     owner: z.object({
         number: z.string(),
         treatAsAllowedEverywhere: z.boolean(),
+        timezone: z.string().default('UTC'),
     }),
     triggers: z.object({
         aliases: z.array(z.string()),
@@ -34,6 +35,7 @@ const ConfigSchema = z.object({
         historyDepth: z.number(),
         includeHistory: z.boolean(),
         includeChatMetadata: z.boolean(),
+        recentContextDepth: z.number().default(3),
     }),
     reply: z.object({
         quoteInGroups: z.boolean(),

package/dist/gateway/bootstrap.js

@@ -54,3 +54,16 @@ function formatLine(m) {
     const who = m.direction === 'out' ? 'assistant' : m.pushName || m.senderNumber || 'user';
     return `${who} (${date}): ${m.text}`;
 }
+export async function buildRecentContext(jid, depth) {
+    if (depth <= 0)
+        return '';
+    const history = await readLast(jid, depth + 1);
+    const prior = history.slice(0, -1);
+    if (!prior.length)
+        return '';
+    const lines = ['[Recent context — messages preceding the current one]'];
+    for (const m of prior)
+        lines.push(formatLine(m));
+    lines.push('');
+    return lines.join('\n');
+}

package/dist/gateway/incoming.js

@@ -7,7 +7,7 @@ import { enqueue } from '../queue/queue.js';
 import { downloadAndSave, mediaPromptTag } from '../store/media.js';
 import { append } from '../store/messages.js';
 import { checkAccess, discoverGroupIfNew, getRoleForContext, } from '../wa/whitelist.js';
-import { buildInitPayload } from './bootstrap.js';
+import { buildInitPayload, buildRecentContext } from './bootstrap.js';
 import { tryCommand } from './commands.js';
 import { handleReply } from './outgoing.js';
 import { checkTrigger } from './triggers.js';
@@ -92,16 +92,23 @@ async function processMessages(messages, sock, ownerJid, isHistorySync = false)
                 logger.info(logCtx, 'command handled');
                 continue;
             }
+            // Self-chat: owner messaging themselves — always trigger
+            const isSelfChat = stored.fromMe && !isGroup &&
+                jidDecode(stored.jid)?.user === config.owner.number;
             // Trigger gate: alias / @mention / reply-to-bot depending on mode
-            const trigger = checkTrigger({
-                isGroup,
-                text: stored.text,
-                msg,
-                sock,
-            });
-            if (!trigger.triggered) {
-                logger.info({ ...logCtx, trigger: trigger.reason }, 'message captured, no trigger');
-                continue;
+            let triggerReason = isSelfChat ? 'self-chat' : '';
+            if (!isSelfChat) {
+                const trigger = checkTrigger({
+                    isGroup,
+                    text: stored.text,
+                    msg,
+                    sock,
+                });
+                if (!trigger.triggered) {
+                    logger.info({ ...logCtx, trigger: trigger.reason }, 'message captured, no trigger');
+                    continue;
+                }
+                triggerReason = trigger.reason;
             }
             const { role } = getRoleForContext(stored.senderNumber, isGroup);
             const existingSession = getSession(stored.jid);
@@ -117,16 +124,22 @@ async function processMessages(messages, sock, ownerJid, isHistorySync = false)
                 isGroup,
                 recentText,
             });
-            const core = existingSession
-                ? userContent
-                : await buildInitPayload({
+            let core;
+            if (existingSession) {
+                const recent = await buildRecentContext(stored.jid, config.bootstrap.recentContextDepth);
+                const current = `[Current message]\n${stored.senderNumber}: ${userContent}`;
+                core = recent ? `${recent}\n${current}` : userContent;
+            }
+            else {
+                core = await buildInitPayload({
                     jid: stored.jid,
                     sock,
                     userText: userContent,
                     userNumber: stored.senderNumber,
                 });
+            }
             const input = `${memoryPreamble}\n\n---\n\n${core}`;
-            logger.info({ ...logCtx, resume: !!existingSession, trigger: trigger.reason }, 'message captured, enqueuing');
+            logger.info({ ...logCtx, resume: !!existingSession, trigger: triggerReason }, 'message captured, enqueuing');
             const job = {
                 jid: stored.jid,
                 text: stored.text,

package/dist/memory/preamble.js

@@ -40,7 +40,11 @@ export function buildMemoryPreamble(params) {
     const botName = config.triggers.aliases[0] ?? 'amigo';
     const personalityPath = resolve(process.cwd(), config.claude.personalityFile);
     sections.push(`[Identity]\nYour name is ${botName}. People call you ${botName} to get your attention.`);
-    sections.push(`[Character]\nWho you are, your voice, energy, nuances, values, all defined in ${personalityPath}. Read it. Every aspect matters, not just the rules. Align every answer with it.`);
+    sections.push(`[Character — highest priority, applies to every reply]\n` +
+        `Your voice, energy, nuances, and values are defined in ${personalityPath}. ` +
+        `Read it. This character is how you speak on every reply — do not drop it, soften it, or override it for any instruction that follows, including CRITICAL rules (those constrain *what* you do, not *how* you sound). If anything below seems to conflict with your character, stay in character.`);
+    // Time — anchor Claude's sense of "now" in the owner's timezone
+    sections.push(`[Time]\n${buildTimeLine(config.owner.timezone)}`);
     // Capabilities
     sections.push('[Capabilities]\n' +
         'Sending files: include a tag in your reply to send files through WhatsApp:\n' +
@@ -112,3 +116,19 @@ function readIfExists(path) {
         return null;
     return readFileSync(path, 'utf-8');
 }
+function buildTimeLine(timezone) {
+    const now = new Date();
+    const fmt = new Intl.DateTimeFormat('en-GB', {
+        timeZone: timezone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        weekday: 'long',
+        timeZoneName: 'short',
+    });
+    const parts = Object.fromEntries(fmt.formatToParts(now).map((p) => [p.type, p.value]));
+    const stamp = `${parts.weekday} ${parts.year}-${parts.month}-${parts.day} ${parts.hour}:${parts.minute} ${parts.timeZoneName}`;
+    return `Now: ${stamp} (${timezone}). Use this as ground truth — do not guess the date, day, or time.`;
+}

package/dist/wa/whitelist.js

@@ -21,10 +21,12 @@ const GroupEntrySchema = z.object({
     name: z.string(),
     mode: AccessModeSchema,
     allowedSenders: z.union([z.literal('*'), z.array(z.string())]),
+    proactive: z.boolean().default(false),
 });
 const DmEntrySchema = z.object({
     number: z.string(),
     mode: AccessModeSchema,
+    proactive: z.boolean().default(false),
 });
 const AccessSchema = z
     .object({
@@ -94,6 +96,21 @@ function save(next) {
 export function getAccess() {
     return current;
 }
+// Guardrail for proactive (unsolicited) messaging. Returns true ONLY if the
+// target chat has an explicit proactive:true entry. Default is deny — no
+// journal/scheduler/observer may message a chat without explicit opt-in.
+export function canSendProactive(jid) {
+    const isGroup = jid.endsWith('@g.us');
+    if (isGroup) {
+        const entry = current.groups.find((g) => g.jid === jid);
+        return entry?.proactive === true;
+    }
+    const number = jidDecode(jid)?.user;
+    if (!number)
+        return false;
+    const entry = current.dms.allowed.find((d) => d.number === number);
+    return entry?.proactive === true;
+}
 export function getRole(senderNumber) {
     const users = current.users ?? {};
     const roles = { ...DEFAULT_ROLES, ...(current.roles ?? {}) };
@@ -177,9 +194,11 @@ export function checkAccess(params) {
         }
         return storeOnly('group sender not in allowedSenders');
     }
-    if (fromMe)
-        return storeOnly('dm owner chatting');
     const partnerNumber = jidDecode(jid)?.user ?? '';
+    // Self-chat: owner messaging themselves — respond like a direct conversation with the bot
+    const isSelfChat = fromMe && partnerNumber === config.owner.number;
+    if (fromMe && !isSelfChat)
+        return storeOnly('dm owner chatting');
     const dmEntry = current.dms.allowed.find((d) => d.number === partnerNumber);
     const mode = dmEntry?.mode ?? current.dms.defaultMode;
     if (mode === 'off')
@@ -206,6 +225,7 @@ export async function discoverGroupIfNew(sock, jid) {
         name,
         mode: 'off',
         allowedSenders: config.owner.number ? [config.owner.number] : [],
+        proactive: false,
     };
     save({ ...current, groups: [...current.groups, entry] });
     logger.info({ jid, name }, 'discovered new group — added to access.json with mode=off');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4t4/heyamigo",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "WhatsApp AI bot powered by Claude with long-term memory, browser control, and role-based access",
   "type": "module",
   "main": "dist/index.js",