tide-commander 1.92.0 → 1.93.0

package/dist/assets/{web-DZfyqisM.js → web-BbNfUMzK.js}

@@ -1 +1 @@
-import{ck as t}from"./main-jN7LzP4f.js";import"./vendor-react--Eh9ivFN.js";import"./vendor-three-Chj50gSY.js";class o extends t{constructor(){super(),this.handleVisibilityChange=()=>{const e={isActive:document.hidden!==!0};this.notifyListeners("appStateChange",e),document.hidden?this.notifyListeners("pause",null):this.notifyListeners("resume",null)},document.addEventListener("visibilitychange",this.handleVisibilityChange,!1)}exitApp(){throw this.unimplemented("Not implemented on web.")}async getInfo(){throw this.unimplemented("Not implemented on web.")}async getLaunchUrl(){return{url:""}}async getState(){return{isActive:document.hidden!==!0}}async minimizeApp(){throw this.unimplemented("Not implemented on web.")}async toggleBackButtonHandler(){throw this.unimplemented("Not implemented on web.")}async getAppLanguage(){return{value:navigator.language.split("-")[0].toLowerCase()}}}export{o as AppWeb};
+import{ck as t}from"./main-BUO6--48.js";import"./vendor-react--Eh9ivFN.js";import"./vendor-three-Chj50gSY.js";class o extends t{constructor(){super(),this.handleVisibilityChange=()=>{const e={isActive:document.hidden!==!0};this.notifyListeners("appStateChange",e),document.hidden?this.notifyListeners("pause",null):this.notifyListeners("resume",null)},document.addEventListener("visibilitychange",this.handleVisibilityChange,!1)}exitApp(){throw this.unimplemented("Not implemented on web.")}async getInfo(){throw this.unimplemented("Not implemented on web.")}async getLaunchUrl(){return{url:""}}async getState(){return{isActive:document.hidden!==!0}}async minimizeApp(){throw this.unimplemented("Not implemented on web.")}async toggleBackButtonHandler(){throw this.unimplemented("Not implemented on web.")}async getAppLanguage(){return{value:navigator.language.split("-")[0].toLowerCase()}}}export{o as AppWeb};

package/dist/assets/{web-CfwxlY8x.js → web-CQsQBSkQ.js}

@@ -1 +1 @@
-import{ck as s}from"./main-jN7LzP4f.js";import"./vendor-react--Eh9ivFN.js";import"./vendor-three-Chj50gSY.js";class l extends s{constructor(){super(...arguments),this.pending=[],this.deliveredNotifications=[],this.hasNotificationSupport=()=>{if(!("Notification"in window)||!Notification.requestPermission)return!1;if(Notification.permission!=="granted")try{new Notification("")}catch(i){if(i instanceof Error&&i.name==="TypeError")return!1}return!0}}async getDeliveredNotifications(){const i=[];for(const t of this.deliveredNotifications){const e={title:t.title,id:parseInt(t.tag),body:t.body};i.push(e)}return{notifications:i}}async removeDeliveredNotifications(i){for(const t of i.notifications){const e=this.deliveredNotifications.find(n=>n.tag===String(t.id));e==null||e.close(),this.deliveredNotifications=this.deliveredNotifications.filter(()=>!e)}}async removeAllDeliveredNotifications(){for(const i of this.deliveredNotifications)i.close();this.deliveredNotifications=[]}async createChannel(){throw this.unimplemented("Not implemented on web.")}async deleteChannel(){throw this.unimplemented("Not implemented on web.")}async listChannels(){throw this.unimplemented("Not implemented on web.")}async schedule(i){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");for(const t of i.notifications)this.sendNotification(t);return{notifications:i.notifications.map(t=>({id:t.id}))}}async getPending(){return{notifications:this.pending}}async registerActionTypes(){throw this.unimplemented("Not implemented on web.")}async cancel(i){this.pending=this.pending.filter(t=>!i.notifications.find(e=>e.id===t.id))}async areEnabled(){const{display:i}=await this.checkPermissions();return{value:i==="granted"}}async changeExactNotificationSetting(){throw this.unimplemented("Not implemented on web.")}async checkExactNotificationSetting(){throw this.unimplemented("Not implemented on web.")}async requestPermissions(){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");return{display:this.transformNotificationPermission(await Notification.requestPermission())}}async checkPermissions(){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");return{display:this.transformNotificationPermission(Notification.permission)}}transformNotificationPermission(i){switch(i){case"granted":return"granted";case"denied":return"denied";default:return"prompt"}}sendPending(){var i;const t=[],e=new Date().getTime();for(const n of this.pending)!((i=n.schedule)===null||i===void 0)&&i.at&&n.schedule.at.getTime()<=e&&(this.buildNotification(n),t.push(n));this.pending=this.pending.filter(n=>!t.find(o=>o===n))}sendNotification(i){var t;if(!((t=i.schedule)===null||t===void 0)&&t.at){const e=i.schedule.at.getTime()-new Date().getTime();this.pending.push(i),setTimeout(()=>{this.sendPending()},e);return}this.buildNotification(i)}buildNotification(i){const t=new Notification(i.title,{body:i.body,tag:String(i.id)});return t.addEventListener("click",this.onClick.bind(this,i),!1),t.addEventListener("show",this.onShow.bind(this,i),!1),t.addEventListener("close",()=>{this.deliveredNotifications=this.deliveredNotifications.filter(()=>!this)},!1),this.deliveredNotifications.push(t),t}onClick(i){const t={actionId:"tap",notification:i};this.notifyListeners("localNotificationActionPerformed",t)}onShow(i){this.notifyListeners("localNotificationReceived",i)}}export{l as LocalNotificationsWeb};
+import{ck as s}from"./main-BUO6--48.js";import"./vendor-react--Eh9ivFN.js";import"./vendor-three-Chj50gSY.js";class l extends s{constructor(){super(...arguments),this.pending=[],this.deliveredNotifications=[],this.hasNotificationSupport=()=>{if(!("Notification"in window)||!Notification.requestPermission)return!1;if(Notification.permission!=="granted")try{new Notification("")}catch(i){if(i instanceof Error&&i.name==="TypeError")return!1}return!0}}async getDeliveredNotifications(){const i=[];for(const t of this.deliveredNotifications){const e={title:t.title,id:parseInt(t.tag),body:t.body};i.push(e)}return{notifications:i}}async removeDeliveredNotifications(i){for(const t of i.notifications){const e=this.deliveredNotifications.find(n=>n.tag===String(t.id));e==null||e.close(),this.deliveredNotifications=this.deliveredNotifications.filter(()=>!e)}}async removeAllDeliveredNotifications(){for(const i of this.deliveredNotifications)i.close();this.deliveredNotifications=[]}async createChannel(){throw this.unimplemented("Not implemented on web.")}async deleteChannel(){throw this.unimplemented("Not implemented on web.")}async listChannels(){throw this.unimplemented("Not implemented on web.")}async schedule(i){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");for(const t of i.notifications)this.sendNotification(t);return{notifications:i.notifications.map(t=>({id:t.id}))}}async getPending(){return{notifications:this.pending}}async registerActionTypes(){throw this.unimplemented("Not implemented on web.")}async cancel(i){this.pending=this.pending.filter(t=>!i.notifications.find(e=>e.id===t.id))}async areEnabled(){const{display:i}=await this.checkPermissions();return{value:i==="granted"}}async changeExactNotificationSetting(){throw this.unimplemented("Not implemented on web.")}async checkExactNotificationSetting(){throw this.unimplemented("Not implemented on web.")}async requestPermissions(){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");return{display:this.transformNotificationPermission(await Notification.requestPermission())}}async checkPermissions(){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");return{display:this.transformNotificationPermission(Notification.permission)}}transformNotificationPermission(i){switch(i){case"granted":return"granted";case"denied":return"denied";default:return"prompt"}}sendPending(){var i;const t=[],e=new Date().getTime();for(const n of this.pending)!((i=n.schedule)===null||i===void 0)&&i.at&&n.schedule.at.getTime()<=e&&(this.buildNotification(n),t.push(n));this.pending=this.pending.filter(n=>!t.find(o=>o===n))}sendNotification(i){var t;if(!((t=i.schedule)===null||t===void 0)&&t.at){const e=i.schedule.at.getTime()-new Date().getTime();this.pending.push(i),setTimeout(()=>{this.sendPending()},e);return}this.buildNotification(i)}buildNotification(i){const t=new Notification(i.title,{body:i.body,tag:String(i.id)});return t.addEventListener("click",this.onClick.bind(this,i),!1),t.addEventListener("show",this.onShow.bind(this,i),!1),t.addEventListener("close",()=>{this.deliveredNotifications=this.deliveredNotifications.filter(()=>!this)},!1),this.deliveredNotifications.push(t),t}onClick(i){const t={actionId:"tap",notification:i};this.notifyListeners("localNotificationActionPerformed",t)}onShow(i){this.notifyListeners("localNotificationReceived",i)}}export{l as LocalNotificationsWeb};

package/dist/assets/{web-DbhP1mtF.js → web-bKiHKTT6.js}

@@ -1 +1 @@
-import{ck as a}from"./main-jN7LzP4f.js";import{ImpactStyle as i,NotificationType as r}from"./index-cK048gKM.js";import"./vendor-react--Eh9ivFN.js";import"./vendor-three-Chj50gSY.js";class h extends a{constructor(){super(...arguments),this.selectionStarted=!1}async impact(t){const e=this.patternForImpact(t==null?void 0:t.style);this.vibrateWithPattern(e)}async notification(t){const e=this.patternForNotification(t==null?void 0:t.type);this.vibrateWithPattern(e)}async vibrate(t){const e=(t==null?void 0:t.duration)||300;this.vibrateWithPattern([e])}async selectionStart(){this.selectionStarted=!0}async selectionChanged(){this.selectionStarted&&this.vibrateWithPattern([70])}async selectionEnd(){this.selectionStarted=!1}patternForImpact(t=i.Heavy){return t===i.Medium?[43]:t===i.Light?[20]:[61]}patternForNotification(t=r.Success){return t===r.Warning?[30,40,30,50,60]:t===r.Error?[27,45,50]:[35,65,21]}vibrateWithPattern(t){if(navigator.vibrate)navigator.vibrate(t);else throw this.unavailable("Browser does not support the vibrate API")}}export{h as HapticsWeb};
+import{ck as a}from"./main-BUO6--48.js";import{ImpactStyle as i,NotificationType as r}from"./index-mEu7CM6i.js";import"./vendor-react--Eh9ivFN.js";import"./vendor-three-Chj50gSY.js";class h extends a{constructor(){super(...arguments),this.selectionStarted=!1}async impact(t){const e=this.patternForImpact(t==null?void 0:t.style);this.vibrateWithPattern(e)}async notification(t){const e=this.patternForNotification(t==null?void 0:t.type);this.vibrateWithPattern(e)}async vibrate(t){const e=(t==null?void 0:t.duration)||300;this.vibrateWithPattern([e])}async selectionStart(){this.selectionStarted=!0}async selectionChanged(){this.selectionStarted&&this.vibrateWithPattern([70])}async selectionEnd(){this.selectionStarted=!1}patternForImpact(t=i.Heavy){return t===i.Medium?[43]:t===i.Light?[20]:[61]}patternForNotification(t=r.Success){return t===r.Warning?[30,40,30,50,60]:t===r.Error?[27,45,50]:[35,65,21]}vibrateWithPattern(t){if(navigator.vibrate)navigator.vibrate(t);else throw this.unavailable("Browser does not support the vibrate API")}}export{h as HapticsWeb};

package/dist/index.html

@@ -22,10 +22,10 @@
     <link rel="icon" type="image/png" sizes="16x16" href="/assets/icons/favicon-16x16.png" />
     <link rel="apple-touch-icon" sizes="180x180" href="/assets/icons/apple-touch-icon.png" />
     <title>Tide Commander</title>
-    <script type="module" crossorigin src="/assets/main-jN7LzP4f.js"></script>
+    <script type="module" crossorigin src="/assets/main-BUO6--48.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/vendor-react--Eh9ivFN.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-three-Chj50gSY.js">
-    <link rel="stylesheet" crossorigin href="/assets/main-CrGeO0Sc.css">
+    <link rel="stylesheet" crossorigin href="/assets/main-BfT_95fk.css">
   </head>
   <body>
     <div id="app"></div>

package/dist/locales/en/terminal.json

@@ -602,7 +602,8 @@
     "contextLabel": "Context",
     "percentFree": "{{percent}}% free",
     "msgsLabel": "msgs: {{tokens}}k",
-    "clickForContextStats": "Click for context stats"
+    "clickForContextStats": "Click for context stats",
+    "compactedLabel": "Context compacted"
   },
   "controls": {
     "title": "Controls",

package/dist/src/packages/server/integrations/gmail/gmail-client.js

@@ -339,13 +339,24 @@ function parseGmailMessage(msg) {
         }
     }
     extractParts(msg.payload);
-    // Check attachments
+    // Check attachments — capture filename AND the metadata we need to fetch
+    // the bytes later via gmail.users.messages.attachments.get.
     const attachmentNames = [];
+    const attachmentsMeta = [];
     function findAttachments(payload) {
         if (!payload)
             return;
         if (payload.filename && payload.filename.length > 0) {
             attachmentNames.push(payload.filename);
+            const attachmentId = payload.body?.attachmentId;
+            if (attachmentId) {
+                attachmentsMeta.push({
+                    attachmentId,
+                    filename: payload.filename,
+                    mimeType: payload.mimeType || 'application/octet-stream',
+                    size: payload.body?.size ?? 0,
+                });
+            }
         }
         if (payload.parts) {
             for (const part of payload.parts) {
@@ -369,8 +380,78 @@ function parseGmailMessage(msg) {
         labels: msg.labelIds || undefined,
         hasAttachments: attachmentNames.length > 0,
         attachmentNames: attachmentNames.length > 0 ? attachmentNames : undefined,
+        attachmentsMeta: attachmentsMeta.length > 0 ? attachmentsMeta : undefined,
     };
 }
+/**
+ * Download a single Gmail attachment by id and persist it to disk under
+ * `<TEMP_DIR>/triggers/gmail/<messageId>/<sanitized-filename>`. Mirrors what
+ * the WA/Slack pipelines do with `attachment-downloader.downloadAttachment`,
+ * but Gmail's binary doesn't come from a URL — it comes from the SDK call
+ * `gmail.users.messages.attachments.get` which returns base64url-encoded
+ * bytes. Hard 25 MB cap, idempotent, never throws.
+ */
+export async function downloadGmailAttachment(messageId, meta) {
+    if (!gmail) {
+        ctx?.log.warn('Gmail not authenticated — skipping attachment download');
+        return null;
+    }
+    // Lazy-import the shared cap + temp root so we keep one source of truth.
+    const { MAX_ATTACHMENT_BYTES, TRIGGER_ATTACHMENT_ROOT } = await import('../../services/attachment-downloader.js');
+    if (meta.size > MAX_ATTACHMENT_BYTES) {
+        ctx?.log.warn(`Gmail attachment ${meta.filename} (${meta.size}B) exceeds cap; skipping`);
+        return null;
+    }
+    const path = await import('path');
+    const fs = await import('fs/promises');
+    // Sanitize segments the same way attachment-downloader does — strip
+    // path separators / `..` / control chars so a hostile filename can't
+    // escape the trigger dir.
+    const safe = (s) => s.replace(/[\\/\x00-\x1f\x7f]/g, '_').replace(/\.{2,}/g, '_').slice(0, 200) || 'file';
+    const targetDir = path.join(TRIGGER_ATTACHMENT_ROOT, 'gmail', safe(messageId));
+    const finalName = safe(meta.filename) || 'file';
+    const targetPath = path.join(targetDir, finalName);
+    // Idempotency: if a file with the expected size already lives at the
+    // target path, skip the network round-trip.
+    try {
+        const st = await fs.stat(targetPath);
+        if (st.isFile() && (meta.size === 0 || st.size === meta.size)) {
+            return { path: targetPath, bytesOnDisk: st.size, filename: finalName, mimeType: meta.mimeType };
+        }
+    }
+    catch { /* not cached */ }
+    await fs.mkdir(targetDir, { recursive: true });
+    let res;
+    try {
+        res = await gmail.users.messages.attachments.get({
+            userId: 'me',
+            messageId,
+            id: meta.attachmentId,
+        });
+    }
+    catch (err) {
+        ctx?.log.warn(`Gmail attachments.get failed for ${meta.filename}: ${err}`);
+        return null;
+    }
+    const b64 = res.data?.data;
+    if (!b64) {
+        ctx?.log.warn(`Gmail attachment ${meta.filename} returned empty data`);
+        return null;
+    }
+    const buf = Buffer.from(b64, 'base64url');
+    if (buf.byteLength > MAX_ATTACHMENT_BYTES) {
+        ctx?.log.warn(`Gmail attachment ${meta.filename} decoded to ${buf.byteLength}B (exceeds cap)`);
+        return null;
+    }
+    try {
+        await fs.writeFile(targetPath, buf);
+    }
+    catch (err) {
+        ctx?.log.warn(`Gmail attachment write failed for ${targetPath}: ${err}`);
+        return null;
+    }
+    return { path: targetPath, bytesOnDisk: buf.byteLength, filename: finalName, mimeType: meta.mimeType };
+}
 export async function getThread(threadId) {
     if (!gmail)
         throw new Error('Gmail not authenticated');

package/dist/src/packages/server/integrations/gmail/gmail-trigger-handler.js

@@ -4,11 +4,37 @@
  * Delegates event listening to gmail-client's polling and onNewMessage callback.
  */
 import * as gmailClient from './gmail-client.js';
+import { formatAttachmentLine } from '../../services/attachment-downloader.js';
+/** Labels we always drop unless the trigger explicitly opts in. Gmail tags
+ *  these on messages the user has already classified as junk. */
+const ALWAYS_DROP_LABELS = new Set(['SPAM', 'TRASH']);
 let unsubscribe = null;
 export const gmailTriggerHandler = {
     triggerType: 'email',
     async startListening(onEvent) {
-        unsubscribe = gmailClient.onNewMessage((message) => {
+        unsubscribe = gmailClient.onNewMessage(async (message) => {
+            // Download any attachments BEFORE we hand the event to the trigger
+            // service so `{{email.attachmentsBlock}}` is populated when the
+            // template renders. Mirrors the WA/Slack pipelines — the agent gets
+            // a local path it can open with the Read tool, not just a filename.
+            if (message.attachmentsMeta && message.attachmentsMeta.length > 0) {
+                const downloaded = [];
+                for (const meta of message.attachmentsMeta) {
+                    const result = await gmailClient.downloadGmailAttachment(message.messageId, meta);
+                    if (result) {
+                        downloaded.push({
+                            ...meta,
+                            filename: result.filename,
+                            mimeType: result.mimeType,
+                            path: result.path,
+                            bytesOnDisk: result.bytesOnDisk,
+                        });
+                    }
+                }
+                if (downloaded.length > 0) {
+                    message.downloadedAttachments = downloaded;
+                }
+            }
             onEvent({
                 source: 'email',
                 type: 'message',
@@ -26,6 +52,24 @@ export const gmailTriggerHandler = {
     structuralMatch(trigger, event) {
         const msg = event.data;
         const config = trigger.config;
+        const labels = msg.labels ?? [];
+        // Always drop SPAM / TRASH unless this trigger explicitly opted in to
+        // spam delivery. Saves the cost of LLM evaluation / agent prompts for
+        // junk that the user has already classified.
+        if (!config.includeSpam) {
+            for (const lbl of labels) {
+                if (ALWAYS_DROP_LABELS.has(lbl))
+                    return false;
+            }
+        }
+        // Per-trigger extra exclusions (e.g. CATEGORY_PROMOTIONS).
+        if (config.excludeLabels?.length) {
+            const exclude = new Set(config.excludeLabels);
+            for (const lbl of labels) {
+                if (exclude.has(lbl))
+                    return false;
+            }
+        }
         if (config.fromFilter?.length) {
             const fromLower = msg.from.toLowerCase();
             if (!config.fromFilter.some(f => fromLower.includes(f.toLowerCase())))
@@ -51,6 +95,19 @@ export const gmailTriggerHandler = {
         // Gmail tags sent messages with the SENT label. Anything else is treated
         // as inbound (covers INBOX, drafts, all-mail, etc.).
         const direction = labels.includes('SENT') ? 'outbound' : 'inbound';
+        // Build the attachments block from the downloaded files. Each line is
+        // shaped the same way as the WA / Slack pipelines so the existing
+        // `AttachmentChip` parser on the frontend picks them up unchanged.
+        const downloaded = msg.downloadedAttachments ?? [];
+        const attachmentsBlock = downloaded
+            .map((a) => formatAttachmentLine({
+            path: a.path,
+            filename: a.filename,
+            mimetype: a.mimeType,
+            size: a.bytesOnDisk,
+            sourceUrl: `gmail://attachment/${msg.messageId}/${a.attachmentId}`,
+        }))
+            .join('\n');
         return {
             'email.from': msg.from,
             'email.to': msg.to.join(', '),
@@ -61,6 +118,9 @@ export const gmailTriggerHandler = {
             'email.date': new Date(msg.date).toISOString(),
             'email.hasAttachments': String(msg.hasAttachments),
             'email.attachments': msg.attachmentNames?.join(', ') || '',
+            // New: local downloaded paths + ready-to-render attachment chips block.
+            'email.filePaths': downloaded.map((a) => a.path).join(','),
+            'email.attachmentsBlock': attachmentsBlock,
             'email.direction': direction,
             'email.labels': labels.join(', '),
         };

package/dist/src/packages/server/integrations/slack/slack-config.js

@@ -17,6 +17,7 @@ const DEFAULT_CONFIG = {
     pollingChannelAllowlist: '',
     pollingDmsAlways: true,
     pollingMinMsBetweenCalls: 1500,
+    pollingUseSearch: false,
     mirrorOwnMessages: false,
     currentMode: 'none',
 };
@@ -184,6 +185,14 @@ export const slackConfigSchema = [
         defaultValue: true,
         group: 'Polling',
     },
+    {
+        key: 'pollingUseSearch',
+        label: 'Use search.messages (catches thread replies)',
+        type: 'boolean',
+        description: 'When on, polling uses a single search.messages call per cycle instead of one conversations.history per channel. Catches replies on old threads that the per-channel sweep misses. Allowlist + DM filter still apply. Requires the user (xoxp-) token to have the search:read scope. Default off.',
+        defaultValue: false,
+        group: 'Polling',
+    },
     {
         key: 'mirrorOwnMessages',
         label: 'Mirror messages I send too',
@@ -232,6 +241,7 @@ export function getConfigValues(secrets, instanceId = DEFAULT_INSTANCE_ID) {
         pollingChannelAllowlist: config.pollingChannelAllowlist ?? '',
         pollingDmsAlways: config.pollingDmsAlways ?? true,
         pollingMinMsBetweenCalls: config.pollingMinMsBetweenCalls ?? 1500,
+        pollingUseSearch: config.pollingUseSearch ?? false,
         mirrorOwnMessages: config.mirrorOwnMessages ?? false,
         currentMode: config.currentMode ?? 'none',
         // Mask secret values for UI display
@@ -280,6 +290,9 @@ export async function setConfigValues(values, secrets, instanceId = DEFAULT_INST
     if (typeof values.pollingMinMsBetweenCalls === 'number' && Number.isFinite(values.pollingMinMsBetweenCalls)) {
         updates.pollingMinMsBetweenCalls = Math.max(0, values.pollingMinMsBetweenCalls);
     }
+    if (typeof values.pollingUseSearch === 'boolean') {
+        updates.pollingUseSearch = values.pollingUseSearch;
+    }
     if (typeof values.mirrorOwnMessages === 'boolean') {
         updates.mirrorOwnMessages = values.mirrorOwnMessages;
     }

package/dist/src/packages/server/integrations/slack/slack-instance.js

@@ -184,6 +184,7 @@ export class SlackInstance {
             allowlistChannelIds,
             keepAllDms: config.pollingDmsAlways !== false,
             minMsBetweenCalls: config.pollingMinMsBetweenCalls ?? 1500,
+            useSearch: config.pollingUseSearch === true,
         });
         this.pollingClient.setOnFatalError((reason) => {
             updateConfig({ status: 'error', lastError: reason }, this.id);

package/dist/src/packages/server/integrations/slack/slack-polling-client.js

@@ -75,6 +75,7 @@ export class SlackPollingClient {
     allowlistChannelIds;
     keepAllDms;
     minMsBetweenCalls;
+    useSearch;
     scheduler;
     now;
     /** Token-bucket rate limiter shared by every paced API call. Concurrent
@@ -111,6 +112,7 @@ export class SlackPollingClient {
         this.allowlistChannelIds = new Set((opts.allowlistChannelIds ?? []).map((s) => s.trim()).filter(Boolean));
         this.keepAllDms = opts.keepAllDms !== false;
         this.minMsBetweenCalls = Math.max(0, opts.minMsBetweenCalls ?? 0);
+        this.useSearch = opts.useSearch === true;
         this.scheduler = opts.scheduler ?? DEFAULT_SCHEDULER;
         this.now = opts.now ?? Date.now;
         if (this.minMsBetweenCalls > 0) {
@@ -231,6 +233,25 @@ export class SlackPollingClient {
             return;
         this.cycleCount += 1;
         const cycleStart = this.now();
+        // Search-mode: one `search.messages` call replaces the entire per-channel
+        // history sweep. Covers thread replies for old parents that history would
+        // miss. Done in its own branch so the legacy per-channel path stays
+        // intact for tokens without `search:read` scope.
+        if (this.useSearch) {
+            try {
+                const { dispatched, pages } = await this.pollViaSearch();
+                const elapsed = this.now() - cycleStart;
+                log.log(`cycle=${this.cycleCount} via=search pages=${pages} dispatched=${dispatched} elapsedMs=${elapsed}`);
+            }
+            catch (err) {
+                if (isInvalidAuthError(err)) {
+                    this.handleFatal(`invalid_auth on search.messages (cycle=${this.cycleCount})`);
+                    return;
+                }
+                log.warn(`search-mode cycle failed (cycle=${this.cycleCount}): ${describeErr(err)}`);
+            }
+            return;
+        }
         // Refresh channel list on first cycle and every N cycles after.
         if (this.cycleCount === 1 || this.cycleCount % this.channelListRefreshEveryNCycles === 0) {
             try {
@@ -469,6 +490,131 @@ export class SlackPollingClient {
         }
         return dispatched;
     }
+    /**
+     * Search-mode cycle: pull every message (channels + DMs + thread replies)
+     * since "yesterday" with a single `search.messages` call (paginated). Each
+     * match is filtered against the allowlist (and keepAllDms for DMs), checked
+     * against the per-channel watermark, then dispatched. Watermark advances
+     * per channel just like the legacy path so a switch back to per-channel
+     * polling stays correct.
+     *
+     * Why "yesterday" and not the global watermark? Slack search's date
+     * operators are day-precision only (`after:YYYY-MM-DD`). We pick a 1-day
+     * lookback to make sure we always overlap with the last-seen ts. The
+     * per-channel watermark filter drops duplicates so we never re-dispatch.
+     */
+    async pollViaSearch() {
+        if (!this.webClient.search) {
+            log.error('useSearch=true but webClient has no `search.messages` method; bailing.');
+            return { dispatched: 0, pages: 0 };
+        }
+        const searchApi = this.webClient.search;
+        // Slack's date operators want YYYY-MM-DD. Use UTC; mismatched local TZ
+        // would shift the boundary by ≤1 day which is harmless (watermark filter
+        // dedupes anyway).
+        const yesterday = new Date(this.now() - 24 * 60 * 60 * 1000);
+        const y = yesterday.getUTCFullYear();
+        const m = String(yesterday.getUTCMonth() + 1).padStart(2, '0');
+        const d = String(yesterday.getUTCDate()).padStart(2, '0');
+        const query = `after:${y}-${m}-${d}`;
+        let dispatched = 0;
+        let page = 1;
+        const MAX_PAGES = 10; // ~1000 messages per cycle ceiling
+        // Track highest seen ts per channel so we advance watermark at the end.
+        const highestByChannel = new Map();
+        while (page <= MAX_PAGES) {
+            if (!this.running)
+                break;
+            let res;
+            try {
+                res = await this.paceCall(() => searchApi.messages({
+                    query,
+                    count: 100,
+                    page,
+                    sort: 'timestamp',
+                    sort_dir: 'asc',
+                }));
+            }
+            catch (err) {
+                if (isInvalidAuthError(err))
+                    throw err;
+                if (isRateLimitedError(err)) {
+                    const seconds = readRetryAfter(err) ?? 60;
+                    const until = this.now() + seconds * 1000;
+                    if (until > this.globalPauseUntil)
+                        this.globalPauseUntil = until;
+                    log.warn(`429 on search.messages page=${page}, deferred ${seconds}s`);
+                    break;
+                }
+                log.warn(`search.messages page=${page} failed: ${describeErr(err)}`);
+                break;
+            }
+            const matches = res.messages?.matches ?? [];
+            if (matches.length === 0)
+                break;
+            for (const match of matches) {
+                const channelId = match.channel?.id;
+                if (!channelId || !match.ts || typeof match.ts !== 'string')
+                    continue;
+                // Allowlist filter: respect the same rule as the legacy path so the
+                // user's "only these channels + DMs" config still gates everything.
+                if (this.allowlistChannelIds.size > 0) {
+                    const isDm = !!match.channel?.is_im || channelId.startsWith('D');
+                    const allowed = this.allowlistChannelIds.has(channelId) ||
+                        (this.keepAllDms && isDm);
+                    if (!allowed)
+                        continue;
+                }
+                // Watermark filter: drop anything we've already dispatched. Each
+                // channel keeps its own watermark so a switch back to per-channel
+                // polling later picks up exactly where search left off.
+                const wm = this.watermarkStore.get(channelId);
+                if (wm && tsLte(match.ts, wm.lastTs))
+                    continue;
+                const seen = highestByChannel.get(channelId);
+                if (seen && tsLte(match.ts, seen))
+                    continue;
+                const event = {
+                    ts: match.ts,
+                    thread_ts: match.thread_ts,
+                    channel: channelId,
+                    user: match.user,
+                    text: match.text,
+                    subtype: match.subtype,
+                    files: Array.isArray(match.files) ? match.files : undefined,
+                };
+                try {
+                    await this.dispatch(event);
+                    dispatched += 1;
+                }
+                catch (err) {
+                    log.error(`dispatch error (search) channel=${channelId} ts=${match.ts}: ${describeErr(err)}`);
+                }
+                if (!seen || tsGt(match.ts, seen)) {
+                    highestByChannel.set(channelId, match.ts);
+                }
+            }
+            // Pagination control. Slack returns `pagination.page_count` or the
+            // legacy `paging.pages`; bail when we're past the last page or when
+            // matches < count (no more left).
+            const total = res.messages?.pagination?.page_count
+                ?? res.messages?.paging?.pages
+                ?? page;
+            if (matches.length < 100)
+                break;
+            if (page >= total)
+                break;
+            page += 1;
+        }
+        // Persist per-channel watermarks for everything we dispatched this cycle.
+        for (const [channelId, highest] of highestByChannel) {
+            const existing = this.watermarkStore.get(channelId)?.lastTs;
+            if (!existing || tsGt(highest, existing)) {
+                await this.watermarkStore.set(channelId, highest);
+            }
+        }
+        return { dispatched, pages: page };
+    }
     handleFatal(reason) {
         this.fatalError = reason;
         this.running = false;

package/dist/src/packages/server/integrations/whatsapp/whatsapp-config.js

@@ -11,6 +11,9 @@ const DEFAULT_CONFIG = {
     baseUrl: 'http://localhost:3007',
     enrichContactName: true,
     showIncomingToasts: true,
+    transcribeAudio: true,
+    whisperModel: 'medium',
+    whisperLanguage: 'Spanish',
     updatedAt: 0,
     version: '1',
 };
@@ -82,6 +85,39 @@ export const whatsappConfigSchema = [
         defaultValue: true,
         group: 'General',
     },
+    {
+        key: 'transcribeAudio',
+        label: 'Transcribe inbound audio (whisper)',
+        type: 'boolean',
+        description: 'Run the local `whisper` CLI on inbound voice notes and audio attachments. Transcription is exposed as {{whatsapp.audioTranscription}} and appended to {{whatsapp.attachmentsBlock}}. Safe no-op if whisper is not installed.',
+        defaultValue: true,
+        group: 'Audio Transcription',
+    },
+    {
+        key: 'whisperModel',
+        label: 'Whisper model',
+        type: 'select',
+        description: 'Whisper model name. Larger models are more accurate but slower on CPU.',
+        defaultValue: 'medium',
+        options: [
+            { label: 'tiny (fastest)', value: 'tiny' },
+            { label: 'base', value: 'base' },
+            { label: 'small', value: 'small' },
+            { label: 'medium (default)', value: 'medium' },
+            { label: 'large', value: 'large' },
+            { label: 'turbo', value: 'turbo' },
+        ],
+        group: 'Audio Transcription',
+    },
+    {
+        key: 'whisperLanguage',
+        label: 'Whisper language',
+        type: 'text',
+        description: 'Hint for whisper (e.g. "Spanish", "English"). Leave blank to let whisper auto-detect — slower but works for mixed inboxes.',
+        defaultValue: 'Spanish',
+        placeholder: 'Spanish',
+        group: 'Audio Transcription',
+    },
     {
         key: 'baseUrl',
         label: 'WhatsApp API Base URL',
@@ -126,6 +162,9 @@ export function getConfigValues(secrets) {
         defaultSessionId: config.defaultSessionId || '',
         enrichContactName: config.enrichContactName !== false,
         showIncomingToasts: config.showIncomingToasts !== false,
+        transcribeAudio: config.transcribeAudio !== false,
+        whisperModel: config.whisperModel || 'medium',
+        whisperLanguage: config.whisperLanguage ?? 'Spanish',
         // Mask secret values for UI display
         whatsappApiKey: secrets.get(WHATSAPP_API_KEY_SECRET) ? '********' : '',
         webhookVerifyToken: config.webhookVerifyToken ? '********' : '',
@@ -151,6 +190,13 @@ export async function setConfigValues(values, secrets) {
         updates.enrichContactName = values.enrichContactName;
     if (typeof values.showIncomingToasts === 'boolean')
         updates.showIncomingToasts = values.showIncomingToasts;
+    if (typeof values.transcribeAudio === 'boolean')
+        updates.transcribeAudio = values.transcribeAudio;
+    if (typeof values.whisperModel === 'string' && values.whisperModel)
+        updates.whisperModel = values.whisperModel;
+    if (typeof values.whisperLanguage === 'string') {
+        updates.whisperLanguage = values.whisperLanguage;
+    }
     if (typeof values.webhookVerifyToken === 'string' &&
         values.webhookVerifyToken &&
         values.webhookVerifyToken !== '********') {