@rozek/nanoclaw 1.2.17

package/dist/sender-allowlist.test.js

@@ -0,0 +1,186 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { isSenderAllowed, isTriggerAllowed, loadSenderAllowlist, shouldDropMessage, } from './sender-allowlist.js';
+let tmpDir;
+function cfgPath(name = 'sender-allowlist.json') {
+    return path.join(tmpDir, name);
+}
+function writeConfig(config, name) {
+    const p = cfgPath(name);
+    fs.writeFileSync(p, JSON.stringify(config));
+    return p;
+}
+beforeEach(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'allowlist-test-'));
+});
+afterEach(() => {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+});
+describe('loadSenderAllowlist', () => {
+    it('returns allow-all defaults when file is missing', () => {
+        const cfg = loadSenderAllowlist(cfgPath());
+        expect(cfg.default.allow).toBe('*');
+        expect(cfg.default.mode).toBe('trigger');
+        expect(cfg.logDenied).toBe(true);
+    });
+    it('loads allow=* config', () => {
+        const p = writeConfig({
+            default: { allow: '*', mode: 'trigger' },
+            chats: {},
+            logDenied: false,
+        });
+        const cfg = loadSenderAllowlist(p);
+        expect(cfg.default.allow).toBe('*');
+        expect(cfg.logDenied).toBe(false);
+    });
+    it('loads allow=[] (deny all)', () => {
+        const p = writeConfig({
+            default: { allow: [], mode: 'trigger' },
+            chats: {},
+        });
+        const cfg = loadSenderAllowlist(p);
+        expect(cfg.default.allow).toEqual([]);
+    });
+    it('loads allow=[list]', () => {
+        const p = writeConfig({
+            default: { allow: ['alice', 'bob'], mode: 'drop' },
+            chats: {},
+        });
+        const cfg = loadSenderAllowlist(p);
+        expect(cfg.default.allow).toEqual(['alice', 'bob']);
+        expect(cfg.default.mode).toBe('drop');
+    });
+    it('per-chat override beats default', () => {
+        const p = writeConfig({
+            default: { allow: '*', mode: 'trigger' },
+            chats: { 'group-a': { allow: ['alice'], mode: 'drop' } },
+        });
+        const cfg = loadSenderAllowlist(p);
+        expect(cfg.chats['group-a'].allow).toEqual(['alice']);
+        expect(cfg.chats['group-a'].mode).toBe('drop');
+    });
+    it('returns allow-all on invalid JSON', () => {
+        const p = cfgPath();
+        fs.writeFileSync(p, '{ not valid json }}}');
+        const cfg = loadSenderAllowlist(p);
+        expect(cfg.default.allow).toBe('*');
+    });
+    it('returns allow-all on invalid schema', () => {
+        const p = writeConfig({ default: { oops: true } });
+        const cfg = loadSenderAllowlist(p);
+        expect(cfg.default.allow).toBe('*');
+    });
+    it('rejects non-string allow array items', () => {
+        const p = writeConfig({
+            default: { allow: [123, null, true], mode: 'trigger' },
+            chats: {},
+        });
+        const cfg = loadSenderAllowlist(p);
+        expect(cfg.default.allow).toBe('*'); // falls back to default
+    });
+    it('skips invalid per-chat entries', () => {
+        const p = writeConfig({
+            default: { allow: '*', mode: 'trigger' },
+            chats: {
+                good: { allow: ['alice'], mode: 'trigger' },
+                bad: { allow: 123 },
+            },
+        });
+        const cfg = loadSenderAllowlist(p);
+        expect(cfg.chats['good']).toBeDefined();
+        expect(cfg.chats['bad']).toBeUndefined();
+    });
+});
+describe('isSenderAllowed', () => {
+    it('allow=* allows any sender', () => {
+        const cfg = {
+            default: { allow: '*', mode: 'trigger' },
+            chats: {},
+            logDenied: true,
+        };
+        expect(isSenderAllowed('g1', 'anyone', cfg)).toBe(true);
+    });
+    it('allow=[] denies any sender', () => {
+        const cfg = {
+            default: { allow: [], mode: 'trigger' },
+            chats: {},
+            logDenied: true,
+        };
+        expect(isSenderAllowed('g1', 'anyone', cfg)).toBe(false);
+    });
+    it('allow=[list] allows exact match only', () => {
+        const cfg = {
+            default: { allow: ['alice', 'bob'], mode: 'trigger' },
+            chats: {},
+            logDenied: true,
+        };
+        expect(isSenderAllowed('g1', 'alice', cfg)).toBe(true);
+        expect(isSenderAllowed('g1', 'eve', cfg)).toBe(false);
+    });
+    it('uses per-chat entry over default', () => {
+        const cfg = {
+            default: { allow: '*', mode: 'trigger' },
+            chats: { g1: { allow: ['alice'], mode: 'trigger' } },
+            logDenied: true,
+        };
+        expect(isSenderAllowed('g1', 'bob', cfg)).toBe(false);
+        expect(isSenderAllowed('g2', 'bob', cfg)).toBe(true);
+    });
+});
+describe('shouldDropMessage', () => {
+    it('returns false for trigger mode', () => {
+        const cfg = {
+            default: { allow: '*', mode: 'trigger' },
+            chats: {},
+            logDenied: true,
+        };
+        expect(shouldDropMessage('g1', cfg)).toBe(false);
+    });
+    it('returns true for drop mode', () => {
+        const cfg = {
+            default: { allow: '*', mode: 'drop' },
+            chats: {},
+            logDenied: true,
+        };
+        expect(shouldDropMessage('g1', cfg)).toBe(true);
+    });
+    it('per-chat mode override', () => {
+        const cfg = {
+            default: { allow: '*', mode: 'trigger' },
+            chats: { g1: { allow: '*', mode: 'drop' } },
+            logDenied: true,
+        };
+        expect(shouldDropMessage('g1', cfg)).toBe(true);
+        expect(shouldDropMessage('g2', cfg)).toBe(false);
+    });
+});
+describe('isTriggerAllowed', () => {
+    it('allows trigger for allowed sender', () => {
+        const cfg = {
+            default: { allow: ['alice'], mode: 'trigger' },
+            chats: {},
+            logDenied: false,
+        };
+        expect(isTriggerAllowed('g1', 'alice', cfg)).toBe(true);
+    });
+    it('denies trigger for disallowed sender', () => {
+        const cfg = {
+            default: { allow: ['alice'], mode: 'trigger' },
+            chats: {},
+            logDenied: false,
+        };
+        expect(isTriggerAllowed('g1', 'eve', cfg)).toBe(false);
+    });
+    it('logs when logDenied is true', () => {
+        const cfg = {
+            default: { allow: ['alice'], mode: 'trigger' },
+            chats: {},
+            logDenied: true,
+        };
+        isTriggerAllowed('g1', 'eve', cfg);
+        // Logger.debug is called — we just verify no crash; logger is a real pino instance
+    });
+});
+//# sourceMappingURL=sender-allowlist.test.js.map

package/dist/sender-allowlist.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender-allowlist.test.js","sourceRoot":"","sources":["../src/sender-allowlist.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAM,MAAM,QAAQ,CAAC;AAEzE,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EAEnB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAE/B,IAAI,MAAc,CAAC;AAEnB,SAAS,OAAO,CAAC,IAAI,GAAG,uBAAuB;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,WAAW,CAAC,MAAe,EAAE,IAAa;IACjD,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5C,OAAO,CAAC,CAAC;AACX,CAAC;AAED,UAAU,CAAC,GAAG,EAAE;IACd,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;AACrE,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,GAAG,GAAG,mBAAmB,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,GAAG,WAAW,CAAC;YACpB,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE;YACxC,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,GAAG,WAAW,CAAC;YACpB,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YACvC,KAAK,EAAE,EAAE;SACV,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,GAAG,WAAW,CAAC;YACpB,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;YAClD,KAAK,EAAE,EAAE;SACV,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,GAAG,WAAW,CAAC;YACpB,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE;YACxC,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;SACzD,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;QACpB,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,GAAG,WAAW,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,GAAG,WAAW,CAAC;YACpB,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;YACtD,KAAK,EAAE,EAAE;SACV,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,wBAAwB;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,GAAG,WAAW,CAAC;YACpB,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE;YACxC,KAAK,EAAE;gBACL,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;gBAC3C,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;aACpB;SACF,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,GAAG,GAA0B;YACjC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE;YACxC,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,IAAI;SAChB,CAAC;QACF,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,GAAG,GAA0B;YACjC,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YACvC,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,IAAI;SAChB,CAAC;QACF,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,GAAG,GAA0B;YACjC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;YACrD,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,IAAI;SAChB,CAAC;QACF,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,GAAG,GAA0B;YACjC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE;YACxC,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;YACpD,SAAS,EAAE,IAAI;SAChB,CAAC;QACF,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,GAAG,GAA0B;YACjC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE;YACxC,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,IAAI;SAChB,CAAC;QACF,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,GAAG,GAA0B;YACjC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE;YACrC,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,IAAI;SAChB,CAAC;QACF,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,GAAG,GAA0B;YACjC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE;YACxC,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;YAC3C,SAAS,EAAE,IAAI;SAChB,CAAC;QACF,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,GAAG,GAA0B;YACjC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;YAC9C,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,KAAK;SACjB,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,GAAG,GAA0B;YACjC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;YAC9C,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,KAAK;SACjB,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,GAAG,GAA0B;YACjC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;YAC9C,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,IAAI;SAChB,CAAC;QACF,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QACnC,mFAAmF;IACrF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/session-commands.d.ts

@@ -0,0 +1,47 @@
+import type { NewMessage } from './types.js';
+/**
+ * Extract a session slash command from a message, stripping the trigger prefix if present.
+ * Returns the slash command (e.g., '/compact') or null if not a session command.
+ */
+export declare function extractSessionCommand(content: string, triggerPattern: RegExp): string | null;
+/**
+ * Check if a session command sender is authorized.
+ * Allowed: main group (any sender), or trusted/admin sender (is_from_me) in any group.
+ */
+export declare function isSessionCommandAllowed(isMainGroup: boolean, isFromMe: boolean): boolean;
+/** Minimal agent result interface — matches the subset of ContainerOutput used here. */
+export interface AgentResult {
+    status: 'success' | 'error';
+    result?: string | object | null;
+}
+/** Dependencies injected by the orchestrator. */
+export interface SessionCommandDeps {
+    sendMessage: (text: string) => Promise<void>;
+    setTyping: (typing: boolean) => Promise<void>;
+    runAgent: (prompt: string, onOutput: (result: AgentResult) => Promise<void>) => Promise<'success' | 'error'>;
+    closeStdin: () => void;
+    advanceCursor: (timestamp: string) => void;
+    formatMessages: (msgs: NewMessage[], timezone: string) => string;
+    /** Whether the denied sender would normally be allowed to interact (for denial messages). */
+    canSenderInteract: (msg: NewMessage) => boolean;
+}
+/**
+ * Handle session command interception in processGroupMessages.
+ * Scans messages for a session command, handles auth + execution.
+ * Returns { handled: true, success } if a command was found; { handled: false } otherwise.
+ * success=false means the caller should retry (cursor was not advanced).
+ */
+export declare function handleSessionCommand(opts: {
+    missedMessages: NewMessage[];
+    isMainGroup: boolean;
+    groupName: string;
+    triggerPattern: RegExp;
+    timezone: string;
+    deps: SessionCommandDeps;
+}): Promise<{
+    handled: false;
+} | {
+    handled: true;
+    success: boolean;
+}>;
+//# sourceMappingURL=session-commands.d.ts.map

package/dist/session-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-commands.d.ts","sourceRoot":"","sources":["../src/session-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAExF;AAED,wFAAwF;AACxF,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,iDAAiD;AACjD,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,QAAQ,EAAE,CACR,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,KAC7C,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,cAAc,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACjE,6FAA6F;IAC7F,iBAAiB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC;CACjD;AAQD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,cAAc,EAAE,UAAU,EAAE,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,kBAAkB,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAgFpE"}

package/dist/session-commands.js

@@ -0,0 +1,102 @@
+import { logger } from './logger.js';
+/**
+ * Extract a session slash command from a message, stripping the trigger prefix if present.
+ * Returns the slash command (e.g., '/compact') or null if not a session command.
+ */
+export function extractSessionCommand(content, triggerPattern) {
+    let text = content.trim();
+    text = text.replace(triggerPattern, '').trim();
+    if (text === '/compact')
+        return '/compact';
+    return null;
+}
+/**
+ * Check if a session command sender is authorized.
+ * Allowed: main group (any sender), or trusted/admin sender (is_from_me) in any group.
+ */
+export function isSessionCommandAllowed(isMainGroup, isFromMe) {
+    return isMainGroup || isFromMe;
+}
+function resultToText(result) {
+    if (!result)
+        return '';
+    const raw = typeof result === 'string' ? result : JSON.stringify(result);
+    return raw.replace(/<internal>[\s\S]*?<\/internal>/g, '').trim();
+}
+/**
+ * Handle session command interception in processGroupMessages.
+ * Scans messages for a session command, handles auth + execution.
+ * Returns { handled: true, success } if a command was found; { handled: false } otherwise.
+ * success=false means the caller should retry (cursor was not advanced).
+ */
+export async function handleSessionCommand(opts) {
+    const { missedMessages, isMainGroup, groupName, triggerPattern, timezone, deps } = opts;
+    const cmdMsg = missedMessages.find((m) => extractSessionCommand(m.content, triggerPattern) !== null);
+    const command = cmdMsg ? extractSessionCommand(cmdMsg.content, triggerPattern) : null;
+    if (!command || !cmdMsg)
+        return { handled: false };
+    if (!isSessionCommandAllowed(isMainGroup, cmdMsg.is_from_me === true)) {
+        // DENIED: send denial if the sender would normally be allowed to interact,
+        // then silently consume the command by advancing the cursor past it.
+        // Trade-off: other messages in the same batch are also consumed (cursor is
+        // a high-water mark). Acceptable for this narrow edge case.
+        if (deps.canSenderInteract(cmdMsg)) {
+            await deps.sendMessage('Session commands require admin access.');
+        }
+        deps.advanceCursor(cmdMsg.timestamp);
+        return { handled: true, success: true };
+    }
+    // AUTHORIZED: process pre-compact messages first, then run the command
+    logger.info({ group: groupName, command }, 'Session command');
+    const cmdIndex = missedMessages.indexOf(cmdMsg);
+    const preCompactMsgs = missedMessages.slice(0, cmdIndex);
+    // Send pre-compact messages to the agent so they're in the session context.
+    if (preCompactMsgs.length > 0) {
+        const prePrompt = deps.formatMessages(preCompactMsgs, timezone);
+        let hadPreError = false;
+        let preOutputSent = false;
+        const preResult = await deps.runAgent(prePrompt, async (result) => {
+            if (result.status === 'error')
+                hadPreError = true;
+            const text = resultToText(result.result);
+            if (text) {
+                await deps.sendMessage(text);
+                preOutputSent = true;
+            }
+            // Close stdin on session-update marker — emitted after query completes,
+            // so all results (including multi-result runs) are already written.
+            if (result.status === 'success' && result.result === null) {
+                deps.closeStdin();
+            }
+        });
+        if (preResult === 'error' || hadPreError) {
+            logger.warn({ group: groupName }, 'Pre-compact processing failed, aborting session command');
+            await deps.sendMessage(`Failed to process messages before ${command}. Try again.`);
+            if (preOutputSent) {
+                // Output was already sent — don't retry or it will duplicate.
+                // Advance cursor past pre-compact messages, leave command pending.
+                deps.advanceCursor(preCompactMsgs[preCompactMsgs.length - 1].timestamp);
+                return { handled: true, success: true };
+            }
+            return { handled: true, success: false };
+        }
+    }
+    // Forward the literal slash command as the prompt (no XML formatting)
+    await deps.setTyping(true);
+    let hadCmdError = false;
+    const cmdOutput = await deps.runAgent(command, async (result) => {
+        if (result.status === 'error')
+            hadCmdError = true;
+        const text = resultToText(result.result);
+        if (text)
+            await deps.sendMessage(text);
+    });
+    // Advance cursor to the command — messages AFTER it remain pending for next poll.
+    deps.advanceCursor(cmdMsg.timestamp);
+    await deps.setTyping(false);
+    if (cmdOutput === 'error' || hadCmdError) {
+        await deps.sendMessage(`${command} failed. The session is unchanged.`);
+    }
+    return { handled: true, success: true };
+}
+//# sourceMappingURL=session-commands.js.map

package/dist/session-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-commands.js","sourceRoot":"","sources":["../src/session-commands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,cAAsB;IAC3E,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC1B,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,IAAI,IAAI,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAC3C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAoB,EAAE,QAAiB;IAC7E,OAAO,WAAW,IAAI,QAAQ,CAAC;AACjC,CAAC;AAuBD,SAAS,YAAY,CAAC,MAA0C;IAC9D,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO,GAAG,CAAC,OAAO,CAAC,iCAAiC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAO1C;IACC,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAExF,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,IAAI,CACjE,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEtF,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAEnD,IAAI,CAAC,uBAAuB,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,KAAK,IAAI,CAAC,EAAE,CAAC;QACtE,2EAA2E;QAC3E,qEAAqE;QACrE,2EAA2E;QAC3E,4DAA4D;QAC5D,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,CAAC,WAAW,CAAC,wCAAwC,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,uEAAuE;IACvE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAC;IAE9D,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,cAAc,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEzD,4EAA4E;IAC5E,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QAChE,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,IAAI,aAAa,GAAG,KAAK,CAAC;QAE1B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YAChE,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO;gBAAE,WAAW,GAAG,IAAI,CAAC;YAClD,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAC7B,aAAa,GAAG,IAAI,CAAC;YACvB,CAAC;YACD,wEAAwE;YACxE,oEAAoE;YACpE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;gBAC1D,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,SAAS,KAAK,OAAO,IAAI,WAAW,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,yDAAyD,CAAC,CAAC;YAC7F,MAAM,IAAI,CAAC,WAAW,CAAC,qCAAqC,OAAO,cAAc,CAAC,CAAC;YACnF,IAAI,aAAa,EAAE,CAAC;gBAClB,8DAA8D;gBAC9D,mEAAmE;gBACnE,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;gBACxE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC1C,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAE3B,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO;YAAE,WAAW,GAAG,IAAI,CAAC;QAClD,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,IAAI;YAAE,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,kFAAkF;IAClF,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAE5B,IAAI,SAAS,KAAK,OAAO,IAAI,WAAW,EAAE,CAAC;QACzC,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,OAAO,oCAAoC,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC"}

package/dist/session-commands.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-commands.test.d.ts.map

package/dist/session-commands.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-commands.test.d.ts","sourceRoot":"","sources":["../src/session-commands.test.ts"],"names":[],"mappings":""}

package/dist/session-commands.test.js

@@ -0,0 +1,190 @@
+import { describe, it, expect, vi } from 'vitest';
+import { extractSessionCommand, handleSessionCommand, isSessionCommandAllowed } from './session-commands.js';
+describe('extractSessionCommand', () => {
+    const trigger = /^@Andy\b/i;
+    it('detects bare /compact', () => {
+        expect(extractSessionCommand('/compact', trigger)).toBe('/compact');
+    });
+    it('detects /compact with trigger prefix', () => {
+        expect(extractSessionCommand('@Andy /compact', trigger)).toBe('/compact');
+    });
+    it('rejects /compact with extra text', () => {
+        expect(extractSessionCommand('/compact now please', trigger)).toBeNull();
+    });
+    it('rejects partial matches', () => {
+        expect(extractSessionCommand('/compaction', trigger)).toBeNull();
+    });
+    it('rejects regular messages', () => {
+        expect(extractSessionCommand('please compact the conversation', trigger)).toBeNull();
+    });
+    it('handles whitespace', () => {
+        expect(extractSessionCommand('  /compact  ', trigger)).toBe('/compact');
+    });
+    it('is case-sensitive for the command', () => {
+        expect(extractSessionCommand('/Compact', trigger)).toBeNull();
+    });
+});
+describe('isSessionCommandAllowed', () => {
+    it('allows main group regardless of sender', () => {
+        expect(isSessionCommandAllowed(true, false)).toBe(true);
+    });
+    it('allows trusted/admin sender (is_from_me) in non-main group', () => {
+        expect(isSessionCommandAllowed(false, true)).toBe(true);
+    });
+    it('denies untrusted sender in non-main group', () => {
+        expect(isSessionCommandAllowed(false, false)).toBe(false);
+    });
+    it('allows trusted sender in main group', () => {
+        expect(isSessionCommandAllowed(true, true)).toBe(true);
+    });
+});
+function makeMsg(content, overrides = {}) {
+    return {
+        id: 'msg-1',
+        chat_jid: 'group@test',
+        sender: 'user@test',
+        sender_name: 'User',
+        content,
+        timestamp: '100',
+        ...overrides,
+    };
+}
+function makeDeps(overrides = {}) {
+    return {
+        sendMessage: vi.fn().mockResolvedValue(undefined),
+        setTyping: vi.fn().mockResolvedValue(undefined),
+        runAgent: vi.fn().mockResolvedValue('success'),
+        closeStdin: vi.fn(),
+        advanceCursor: vi.fn(),
+        formatMessages: vi.fn().mockReturnValue('<formatted>'),
+        canSenderInteract: vi.fn().mockReturnValue(true),
+        ...overrides,
+    };
+}
+const trigger = /^@Andy\b/i;
+describe('handleSessionCommand', () => {
+    it('returns handled:false when no session command found', async () => {
+        const deps = makeDeps();
+        const result = await handleSessionCommand({
+            missedMessages: [makeMsg('hello')],
+            isMainGroup: true,
+            groupName: 'test',
+            triggerPattern: trigger,
+            timezone: 'UTC',
+            deps,
+        });
+        expect(result.handled).toBe(false);
+    });
+    it('handles authorized /compact in main group', async () => {
+        const deps = makeDeps();
+        const result = await handleSessionCommand({
+            missedMessages: [makeMsg('/compact')],
+            isMainGroup: true,
+            groupName: 'test',
+            triggerPattern: trigger,
+            timezone: 'UTC',
+            deps,
+        });
+        expect(result).toEqual({ handled: true, success: true });
+        expect(deps.runAgent).toHaveBeenCalledWith('/compact', expect.any(Function));
+        expect(deps.advanceCursor).toHaveBeenCalledWith('100');
+    });
+    it('sends denial to interactable sender in non-main group', async () => {
+        const deps = makeDeps();
+        const result = await handleSessionCommand({
+            missedMessages: [makeMsg('/compact', { is_from_me: false })],
+            isMainGroup: false,
+            groupName: 'test',
+            triggerPattern: trigger,
+            timezone: 'UTC',
+            deps,
+        });
+        expect(result).toEqual({ handled: true, success: true });
+        expect(deps.sendMessage).toHaveBeenCalledWith('Session commands require admin access.');
+        expect(deps.runAgent).not.toHaveBeenCalled();
+        expect(deps.advanceCursor).toHaveBeenCalledWith('100');
+    });
+    it('silently consumes denied command when sender cannot interact', async () => {
+        const deps = makeDeps({ canSenderInteract: vi.fn().mockReturnValue(false) });
+        const result = await handleSessionCommand({
+            missedMessages: [makeMsg('/compact', { is_from_me: false })],
+            isMainGroup: false,
+            groupName: 'test',
+            triggerPattern: trigger,
+            timezone: 'UTC',
+            deps,
+        });
+        expect(result).toEqual({ handled: true, success: true });
+        expect(deps.sendMessage).not.toHaveBeenCalled();
+        expect(deps.advanceCursor).toHaveBeenCalledWith('100');
+    });
+    it('processes pre-compact messages before /compact', async () => {
+        const deps = makeDeps();
+        const msgs = [
+            makeMsg('summarize this', { timestamp: '99' }),
+            makeMsg('/compact', { timestamp: '100' }),
+        ];
+        const result = await handleSessionCommand({
+            missedMessages: msgs,
+            isMainGroup: true,
+            groupName: 'test',
+            triggerPattern: trigger,
+            timezone: 'UTC',
+            deps,
+        });
+        expect(result).toEqual({ handled: true, success: true });
+        expect(deps.formatMessages).toHaveBeenCalledWith([msgs[0]], 'UTC');
+        // Two runAgent calls: pre-compact + /compact
+        expect(deps.runAgent).toHaveBeenCalledTimes(2);
+        expect(deps.runAgent).toHaveBeenCalledWith('<formatted>', expect.any(Function));
+        expect(deps.runAgent).toHaveBeenCalledWith('/compact', expect.any(Function));
+    });
+    it('allows is_from_me sender in non-main group', async () => {
+        const deps = makeDeps();
+        const result = await handleSessionCommand({
+            missedMessages: [makeMsg('/compact', { is_from_me: true })],
+            isMainGroup: false,
+            groupName: 'test',
+            triggerPattern: trigger,
+            timezone: 'UTC',
+            deps,
+        });
+        expect(result).toEqual({ handled: true, success: true });
+        expect(deps.runAgent).toHaveBeenCalledWith('/compact', expect.any(Function));
+    });
+    it('reports failure when command-stage runAgent returns error without streamed status', async () => {
+        // runAgent resolves 'error' but callback never gets status: 'error'
+        const deps = makeDeps({ runAgent: vi.fn().mockImplementation(async (prompt, onOutput) => {
+                await onOutput({ status: 'success', result: null });
+                return 'error';
+            }) });
+        const result = await handleSessionCommand({
+            missedMessages: [makeMsg('/compact')],
+            isMainGroup: true,
+            groupName: 'test',
+            triggerPattern: trigger,
+            timezone: 'UTC',
+            deps,
+        });
+        expect(result).toEqual({ handled: true, success: true });
+        expect(deps.sendMessage).toHaveBeenCalledWith(expect.stringContaining('failed'));
+    });
+    it('returns success:false on pre-compact failure with no output', async () => {
+        const deps = makeDeps({ runAgent: vi.fn().mockResolvedValue('error') });
+        const msgs = [
+            makeMsg('summarize this', { timestamp: '99' }),
+            makeMsg('/compact', { timestamp: '100' }),
+        ];
+        const result = await handleSessionCommand({
+            missedMessages: msgs,
+            isMainGroup: true,
+            groupName: 'test',
+            triggerPattern: trigger,
+            timezone: 'UTC',
+            deps,
+        });
+        expect(result).toEqual({ handled: true, success: false });
+        expect(deps.sendMessage).toHaveBeenCalledWith(expect.stringContaining('Failed to process'));
+    });
+});
+//# sourceMappingURL=session-commands.test.js.map

package/dist/session-commands.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-commands.test.js","sourceRoot":"","sources":["../src/session-commands.test.ts"],"names":[],"mappings":"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"}

package/dist/task-scheduler.d.ts

@@ -0,0 +1,22 @@
+import { ChildProcess } from 'child_process';
+import { GroupQueue } from './group-queue.js';
+import { RegisteredGroup, ScheduledTask } from './types.js';
+/**
+ * Compute the next run time for a recurring task, anchored to the
+ * task's scheduled time rather than Date.now() to prevent cumulative
+ * drift on interval-based tasks.
+ *
+ * Co-authored-by: @community-pr-601
+ */
+export declare function computeNextRun(task: ScheduledTask): string | null;
+export interface SchedulerDependencies {
+    registeredGroups: () => Record<string, RegisteredGroup>;
+    getSessions: () => Record<string, string>;
+    queue: GroupQueue;
+    onProcess: (groupJid: string, proc: ChildProcess, containerName: string, groupFolder: string) => void;
+    sendMessage: (jid: string, text: string) => Promise<void>;
+}
+export declare function startSchedulerLoop(deps: SchedulerDependencies): void;
+/** @internal - for tests only. */
+export declare function _resetSchedulerLoopForTests(): void;
+//# sourceMappingURL=task-scheduler.d.ts.map

package/dist/task-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-scheduler.d.ts","sourceRoot":"","sources":["../src/task-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAkB7C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAgCjE;AAED,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACxD,WAAW,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,CACT,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,YAAY,EAClB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,KAChB,IAAI,CAAC;IACV,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAkLD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAkCpE;AAED,kCAAkC;AAClC,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}