@meetquinn/animactl 0.1.26 → 0.1.27

package/dist/server/inbox/slack-ingest.d.ts

@@ -8,12 +8,10 @@ export interface SlackIngestInput {
     envelope?: SlackMessageEnvelope;
     event: RoutableSlackMessage;
     profiles?: SlackProfileResolver;
+    previewClient?: (signal: AbortSignal) => Pick<WebClient, 'conversations'>;
+    previewTimeoutMs?: number;
+    previewRetryDelaysMs?: readonly number[];
     warn?: (message: string) => void;
 }
-export interface SlackInboxBuildResult {
-    item: SlackInboxItem;
-    latePreview?: (item: SlackInboxItem) => Promise<SlackInboxItem | undefined>;
-}
 export declare function buildSlackInboxItem(input: SlackIngestInput): Promise<SlackInboxItem>;
-export declare function buildSlackInboxItemWithLatePreview(input: SlackIngestInput): Promise<SlackInboxBuildResult>;
 //# sourceMappingURL=slack-ingest.d.ts.map

package/dist/server/inbox/slack-ingest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slack-ingest.d.ts","sourceRoot":"","sources":["../../../server/inbox/slack-ingest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAShD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;CAC7E;AAQD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAE1F;AAED,wBAAsB,kCAAkC,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA8ChH"}
+{"version":3,"file":"slack-ingest.d.ts","sourceRoot":"","sources":["../../../server/inbox/slack-ingest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAQhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AASD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CA0C1F"}

package/dist/server/inbox/slack-ingest.js

@@ -1,18 +1,16 @@
 import { errorMessage } from '../ids.js';
-import { attachmentsHaveSlackMessagePreviews, slackMessagePreviewsFromAttachments, slackMessageAttachments, waitForSlackMessagePreviewAttachments, } from '../slack/message-previews.js';
+import { attachmentsHaveSlackMessagePreviews, slackPermalinkMentioned, waitForSlackMessagePreviewAttachments, } from '../slack/message-previews.js';
 import { SlackProfileResolver } from '../slack/profiles.js';
 import { slackVisibleMessageText } from '../slack/message-text.js';
 import { normalizeSlackMessage, slackEventTeamId, } from './slack-events.js';
 // Turns one routable Slack event into a fully enriched inbox item: sender and
 // channel profiles, readable mention text, permalink, unfurl previews, and file
-// metadata. Every Slack lookup is best-effort — a failure degrades that field
-// and never blocks the wake. Privacy boundary: the only message-content read is
+// metadata. Every Slack lookup is best-effort; a failure degrades that field
+// without dropping the wake. Slack-link preview reads finish (or exhaust a
+// bounded budget) BEFORE enqueue. Privacy boundary: the only message-content read is
 // the containing message itself (for late unfurls); linked channels and DMs are
 // never fetched, previews come only from what Slack attached to this event.
 export async function buildSlackInboxItem(input) {
-    return (await buildSlackInboxItemWithLatePreview(input)).item;
-}
-export async function buildSlackInboxItemWithLatePreview(input) {
     const warn = input.warn ?? ((message) => console.warn(message));
     const profiles = input.profiles ?? new SlackProfileResolver();
     const client = input.client;
@@ -26,7 +24,18 @@ export async function buildSlackInboxItemWithLatePreview(input) {
         profiles.conversation({ channelId: event.channel, client, teamId }),
         profiles.displayText({ client, teamId, text: event.text }),
         slackPermalink(event, client, warn),
-        slackFastUnfurlAttachments(event, client, warn),
+        attachmentsHaveSlackMessagePreviews(event.attachments)
+            ? Promise.resolve(event.attachments)
+            : waitForSlackMessagePreviewAttachments({
+                channelId: event.channel,
+                client,
+                createClient: input.previewClient,
+                messageTs: event.ts,
+                retryDelaysMs: input.previewRetryDelaysMs,
+                timeoutMs: input.previewTimeoutMs,
+                text: event.text,
+                warn,
+            }),
     ]);
     const item = normalizeSlackMessage({
         ...(attachments ? { attachments } : {}),
@@ -38,24 +47,9 @@ export async function buildSlackInboxItemWithLatePreview(input) {
         text,
         ...(userProfile ? { userProfile } : {}),
     });
-    if (attachmentsHaveSlackMessagePreviews(attachments))
-        return { item };
-    return {
-        item,
-        latePreview: async (queuedItem) => {
-            const delayedAttachments = await waitForSlackMessagePreviewAttachments({
-                channelId: event.channel,
-                client,
-                messageTs: event.ts,
-                text: event.text,
-                warn,
-            });
-            const previews = slackMessagePreviewsFromAttachments(delayedAttachments);
-            if (!previews.length)
-                return undefined;
-            return { ...queuedItem, previews };
-        },
-    };
+    if (slackPermalinkMentioned(event.text) && !item.previews?.length)
+        item.previewStatus = 'unavailable';
+    return item;
 }
 async function slackPermalink(event, client, warn) {
     try {
@@ -70,17 +64,3 @@ async function slackPermalink(event, client, warn) {
         return undefined;
     }
 }
-// Unfurl attachments for the containing message: prefer what the realtime event
-// carried; otherwise do one immediate re-read of the containing message. The
-// delayed retry ladder runs after enqueue.
-async function slackFastUnfurlAttachments(event, client, warn) {
-    return event.attachments?.length
-        ? event.attachments
-        : slackMessageAttachments({
-            channelId: event.channel,
-            client,
-            messageTs: event.ts,
-            text: event.text,
-            warn,
-        });
-}

package/dist/server/inbox/slack-subscriber.d.ts

@@ -1,4 +1,3 @@
-import type { SlackInboxItem } from '../../shared/inbox.js';
 import { WakeQueueService } from './wake-queue.service.js';
 export interface SlackInboxSubscriberOptions {
     agentRuntimeKind: string;
@@ -25,9 +24,4 @@ export declare class SlackInboxSubscriber {
     private handleSlackEvent;
     private maybeSyncBotDisplayInfo;
 }
-export declare function applyLateSlackPreviewToQueuedItem(input: {
-    item: SlackInboxItem;
-    latePreview: (item: SlackInboxItem) => Promise<SlackInboxItem | undefined>;
-    queue: Pick<WakeQueueService, 'replaceQueuedItem'>;
-}): Promise<void>;
 //# sourceMappingURL=slack-subscriber.d.ts.map

package/dist/server/inbox/slack-subscriber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slack-subscriber.d.ts","sourceRoot":"","sources":["../../../server/inbox/slack-subscriber.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAoC5D,OAAO,EAAE,gBAAgB,EAA+B,MAAM,yBAAyB,CAAC;AAExF,MAAM,WAAW,2BAA2B;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,uGAAuG;IACvG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,qBAAa,oBAAoB;IAQnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;IACvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAG5D,OAAO,CAAC,0BAA0B,CAAS;gBAEd,OAAO,EAAE,2BAA2B;IAO3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,OAAO,CAAC,SAAS;YAgFH,oBAAoB;YASpB,qBAAqB;YAOrB,0BAA0B;YA2C1B,kCAAkC;YAYlC,gBAAgB;IA2E9B,OAAO,CAAC,uBAAuB;CAYhC;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAC3E,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;CACpD,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhB"}
+{"version":3,"file":"slack-subscriber.d.ts","sourceRoot":"","sources":["../../../server/inbox/slack-subscriber.ts"],"names":[],"mappings":"AAuCA,OAAO,EAAE,gBAAgB,EAA+B,MAAM,yBAAyB,CAAC;AAExF,MAAM,WAAW,2BAA2B;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,uGAAuG;IACvG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,qBAAa,oBAAoB;IAQnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;IACvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAG5D,OAAO,CAAC,0BAA0B,CAAS;gBAEd,OAAO,EAAE,2BAA2B;IAO3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,OAAO,CAAC,SAAS;YAgFH,oBAAoB;YASpB,qBAAqB;YAOrB,0BAA0B;YA2C1B,kCAAkC;YAYlC,gBAAgB;IAgE9B,OAAO,CAAC,uBAAuB;CAYhC"}

package/dist/server/inbox/slack-subscriber.js

@@ -3,7 +3,7 @@ import { activityServiceForAgent } from '../activities/activity.service.js';
 import { agentSlackServiceForAgent } from '../agents/agent-slack.service.js';
 import { interactiveAskServiceForAgent } from '../asks/interactive-ask.service.js';
 import { errorMessage, slackMessageEventId } from '../ids.js';
-import { createSlackWebClient } from '../slack/client.js';
+import { createSlackWebClient, createSlackPreviewWebClient } from '../slack/client.js';
 import { ResilientSocketModeReceiver } from '../slack/resilient-socket-mode-receiver.js';
 import { SlackShortcutService, userIdFromShortcutBody, } from '../slack-interactions/shortcut.service.js';
 import { SLACK_STOP_CONFIRM_VIEW_CALLBACK_ID, SLACK_VIEW_REMINDER_DETAIL_ACTION_ID, SLACK_VIEW_REMINDERS_ACTION_ID, } from '../slack-interactions/shortcut-ids.js';
@@ -14,7 +14,7 @@ import { isSlackEvent, isRoutableSlackMessage, slackEventTeamId, slackSurfaceFor
 import { slackAttentionSuggestionPayload, } from './attention-suggestion-activity.js';
 import { runIngestPipeline } from './ingest-pipeline.js';
 import { observeSlackEventAtIngress } from './observed-conversation.js';
-import { buildSlackInboxItemWithLatePreview } from './slack-ingest.js';
+import { buildSlackInboxItem } from './slack-ingest.js';
 import { slackShortcutHandoffServiceForAgent } from './slack-shortcut-handoff.service.js';
 import { slackRuntimeDecision } from './slack-subscription.service.js';
 export class SlackInboxSubscriber {
@@ -206,7 +206,6 @@ export class SlackInboxSubscriber {
         if (!isRoutableSlackMessage(rawEvent))
             return;
         const teamId = slackEventTeamId(envelope, rawEvent);
-        let latePreview;
         await runIngestPipeline({
             agentId: this.options.queue.agentId,
             attentionSuggestionPayload: slackAttentionSuggestionPayload,
@@ -218,25 +217,15 @@ export class SlackInboxSubscriber {
             enrich: async () => {
                 const webClient = client ?? createSlackWebClient(this.options.botToken);
                 this.maybeSyncBotDisplayInfo(webClient);
-                const buildResult = await buildSlackInboxItemWithLatePreview({
+                return buildSlackInboxItem({
                     client: webClient,
+                    previewClient: (signal) => createSlackPreviewWebClient(this.options.botToken, signal),
                     envelope,
                     event: rawEvent,
                     profiles: this.slackProfiles,
                 });
-                latePreview = buildResult.latePreview;
-                return buildResult.item;
             },
             itemId: slackMessageEventId(teamId, rawEvent.channel, rawEvent.ts),
-            onAfterEnqueue: ({ item, result }) => {
-                if (result.queued && latePreview) {
-                    applyLateSlackPreviewToQueuedItem({
-                        item,
-                        latePreview,
-                        queue: this.options.queue,
-                    });
-                }
-            },
             onAfterAttentionSuggestion: ({ decision, item, result }) => {
                 if (decision.reason === 'mention' && decision.subscription && !result.duplicate) {
                     activityServiceForAgent(this.options.queue.agentId).record({
@@ -273,15 +262,6 @@ export class SlackInboxSubscriber {
         });
     }
 }
-export function applyLateSlackPreviewToQueuedItem(input) {
-    return input.latePreview(input.item).then(async (updatedItem) => {
-        if (!updatedItem)
-            return;
-        await input.queue.replaceQueuedItem(updatedItem);
-    }).catch((error) => {
-        console.warn(`Slack late preview update failed for ${input.item.id}: ${errorMessage(error)}`);
-    });
-}
 // Refresh the bot's own Slack display info at most once every 6h while handling
 // messages — frequent enough to pick up an avatar/name change soon after it
 // happens, rare enough to add no meaningful Slack API load.

package/dist/server/runtime/delivery-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delivery-prompt.d.ts","sourceRoot":"","sources":["../../../server/runtime/delivery-prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAKV,SAAS,EAKT,cAAc,EACf,MAAM,uBAAuB,CAAC;AAY/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AASzD,MAAM,WAAW,sBAAsB;IACrC,eAAe,CAAC,EAAE;QAChB,2BAA2B,CAAC,EAAE,MAAM,CAAC;QACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAwC3G;AAED,0FAA0F;AAC1F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAIrE;AA4ND,wBAAgB,6CAA6C,CAAC,KAAK,EAAE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAWT;AAED,wBAAgB,oCAAoC,CAAC,KAAK,EAAE;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAWT;AAED,wBAAgB,qCAAqC,CAAC,KAAK,EAAE;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAcT;AAED,wBAAgB,yCAAyC,CAAC,KAAK,EAAE;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAcT;AAED,wBAAgB,0CAA0C,CAAC,KAAK,EAAE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAWT"}
+{"version":3,"file":"delivery-prompt.d.ts","sourceRoot":"","sources":["../../../server/runtime/delivery-prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAKV,SAAS,EAKT,cAAc,EACf,MAAM,uBAAuB,CAAC;AAY/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AASzD,MAAM,WAAW,sBAAsB;IACrC,eAAe,CAAC,EAAE;QAChB,2BAA2B,CAAC,EAAE,MAAM,CAAC;QACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAwC3G;AAED,0FAA0F;AAC1F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAIrE;AAkOD,wBAAgB,6CAA6C,CAAC,KAAK,EAAE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAWT;AAED,wBAAgB,oCAAoC,CAAC,KAAK,EAAE;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAWT;AAED,wBAAgB,qCAAqC,CAAC,KAAK,EAAE;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAcT;AAED,wBAAgB,yCAAyC,CAAC,KAAK,EAAE;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAcT;AAED,wBAAgB,0CAA0C,CAAC,KAAK,EAAE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAWT"}

package/dist/server/runtime/delivery-prompt.js

@@ -74,7 +74,7 @@ export function buildCodeAgentDeliveryPrompt(event, context = {}) {
 }
 /** Render Slack unfurl previews + attached_files for inclusion in the cursor envelope. */
 export function renderSlackCursorExtras(event) {
-    return [formatSlackMessagePreviews(event.previews), formatAttachedFiles(event.files)]
+    return [formatSlackPreviewContent(event), formatAttachedFiles(event.files)]
         .filter(Boolean)
         .join('\n\n');
 }
@@ -82,12 +82,17 @@ function buildSlackMessageDeliveryPrompt(event) {
     const envelope = `${messageEnvelope(event)} ${actorLabel(event)}: ${event.text}`;
     return buildDeliveryEventPrompt({
         attentionSuggestion: event.attentionSuggestion,
-        body: formatSlackMessagePreviews(event.previews),
+        body: formatSlackPreviewContent(event),
         envelope,
         files: event.files,
         title: 'New Slack message',
     });
 }
+function formatSlackPreviewContent(event) {
+    return event.previewStatus === 'unavailable' && !event.previews?.length
+        ? '<slack_message_previews status="unavailable">\nPreview not yet obtained within the bounded lookup. This does not establish that the shared message has no preview or that the linked channel is accessible. If needed, re-read the containing message using this envelope\'s channel and message timestamp; do not infer permission to read the linked target.\n</slack_message_previews>'
+        : formatSlackMessagePreviews(event.previews);
+}
 function buildFeishuMessageDeliveryPrompt(event) {
     const envelope = event.quotedMessage
         ? `${feishuMessageEnvelope(event)} ${feishuActorLabel(event)}:\n${formatFeishuQuotedMessage(event.quotedMessage)}\n${event.text}`

package/dist/server/slack/client.d.ts

@@ -1,3 +1,4 @@
 import { WebClient } from '@slack/web-api';
 export declare function createSlackWebClient(token: string): WebClient;
+export declare function createSlackPreviewWebClient(token: string, signal: AbortSignal): WebClient;
 //# sourceMappingURL=client.d.ts.map

package/dist/server/slack/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../server/slack/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAyB,MAAM,gBAAgB,CAAC;AAElE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE7D"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../server/slack/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAyB,MAAM,gBAAgB,CAAC;AAElE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE7D;AAID,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,CAQzF"}

package/dist/server/slack/client.js

@@ -2,6 +2,17 @@ import { WebClient } from '@slack/web-api';
 export function createSlackWebClient(token) {
     return new WebClient(token, slackWebClientOptions());
 }
+// Preview enrichment has its own deadline. Never leave SDK retries or a 429
+// backoff running after the original message has been delivered without it.
+export function createSlackPreviewWebClient(token, signal) {
+    return new WebClient(token, {
+        ...slackWebClientOptions(),
+        timeout: 1_000,
+        retryConfig: { retries: 0 },
+        rejectRateLimitedCalls: true,
+        requestInterceptor: (config) => ({ ...config, signal }),
+    });
+}
 function slackWebClientOptions() {
     return process.env.ANIMA_SLACK_API_URL ? { slackApiUrl: process.env.ANIMA_SLACK_API_URL } : {};
 }

package/dist/server/slack/message-previews.d.ts

@@ -5,8 +5,10 @@ type SlackPreviewWebClient = Pick<WebClient, 'conversations'>;
 export interface SlackMessagePreviewRetryInput {
     channelId: string;
     client: SlackPreviewWebClient;
+    createClient?: (signal: AbortSignal) => SlackPreviewWebClient;
     messageTs: string;
     retryDelaysMs?: readonly number[];
+    timeoutMs?: number;
     text?: string;
     sleep?: (ms: number) => Promise<void>;
     warn?: (message: string) => void;

package/dist/server/slack/message-previews.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-previews.d.ts","sourceRoot":"","sources":["../../../server/slack/message-previews.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,KAAK,EAAE,mBAAmB,EAA2B,MAAM,uBAAuB,CAAC;AAS1F,wBAAgB,mCAAmC,CAAC,cAAc,EAAE,OAAO,GAAG,mBAAmB,EAAE,CAwDlG;AAuBD,KAAK,qBAAqB,GAAG,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AAE9D,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAKD,wBAAsB,qCAAqC,CACzD,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,CAiBhC;AAID,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,CAkBjC;AAED,wBAAgB,mCAAmC,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAEjF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEzE"}
+{"version":3,"file":"message-previews.d.ts","sourceRoot":"","sources":["../../../server/slack/message-previews.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,KAAK,EAAE,mBAAmB,EAA2B,MAAM,uBAAuB,CAAC;AAS1F,wBAAgB,mCAAmC,CAAC,cAAc,EAAE,OAAO,GAAG,mBAAmB,EAAE,CAwDlG;AAyBD,KAAK,qBAAqB,GAAG,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AAE9D,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,qBAAqB,CAAC;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAKD,wBAAsB,qCAAqC,CACzD,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,CAyChC;AAID,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,CAkBjC;AAED,wBAAgB,mCAAmC,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAEjF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEzE"}

package/dist/server/slack/message-previews.js

@@ -81,7 +81,9 @@ function slackMessagePreviewFiles(rawFiles) {
     }
     return files;
 }
-const SLACK_MESSAGE_PREVIEW_RETRY_DELAYS_MS = [2_000, 5_000];
+// Immediate read, then retries at ~2s and ~7s; network time shares the 8s budget.
+const SLACK_MESSAGE_PREVIEW_RETRY_DELAYS_MS = [0, 2_000, 5_000];
+const SLACK_MESSAGE_PREVIEW_TIMEOUT_MS = 8_000;
 // Unfurl attachments for shared Slack permalinks are added by Slack after the
 // realtime event fires, so an immediate read can miss them. Re-read the
 // containing message a couple of times before giving up.
@@ -89,22 +91,48 @@ export async function waitForSlackMessagePreviewAttachments(input) {
     if (!slackPermalinkMentioned(input.text))
         return undefined;
     const retryDelaysMs = input.retryDelaysMs ?? SLACK_MESSAGE_PREVIEW_RETRY_DELAYS_MS;
-    const sleep = input.sleep ?? sleepMs;
-    for (const delayMs of retryDelaysMs) {
-        if (delayMs > 0)
-            await sleep(delayMs);
-        const attachments = await slackMessageAttachments({
-            channelId: input.channelId,
-            client: input.client,
-            messageTs: input.messageTs,
-            text: input.text,
-            warn: input.warn,
-        });
-        if (!attachmentsHaveSlackMessagePreviews(attachments))
-            continue;
-        return attachments;
+    const controller = new AbortController();
+    const startedAt = performance.now();
+    const timeoutMs = input.timeoutMs ?? SLACK_MESSAGE_PREVIEW_TIMEOUT_MS;
+    let timer;
+    let sleepTimer;
+    const expired = new Promise((resolve) => {
+        timer = setTimeout(() => {
+            controller.abort();
+            resolve(undefined);
+        }, timeoutMs);
+    });
+    const client = input.createClient?.(controller.signal) ?? input.client;
+    const lookup = async () => {
+        let nextAttemptAt = startedAt;
+        for (const delayMs of retryDelaysMs) {
+            nextAttemptAt += delayMs;
+            const waitMs = Math.max(0, nextAttemptAt - performance.now());
+            if (waitMs > 0) {
+                await (input.sleep?.(waitMs) ?? new Promise((resolve) => {
+                    sleepTimer = setTimeout(resolve, waitMs);
+                }));
+            }
+            if (controller.signal.aborted || performance.now() - startedAt >= timeoutMs)
+                return undefined;
+            const attachments = await slackMessageAttachments({ ...input, client });
+            if (controller.signal.aborted)
+                return undefined;
+            if (attachmentsHaveSlackMessagePreviews(attachments))
+                return attachments;
+        }
+        return undefined;
+    };
+    try {
+        // Also bounds injected/non-cooperative clients. No late result mutates a
+        // queued item; the production transport is aborted at this same boundary.
+        return await Promise.race([lookup(), expired]);
+    }
+    finally {
+        clearTimeout(timer);
+        clearTimeout(sleepTimer);
+        controller.abort();
     }
-    return undefined;
 }
 // Re-reads ONLY the containing message (the message that just arrived) to pick
 // up its Slack-provided unfurl attachments. Never fetches the linked target.
@@ -133,9 +161,6 @@ export function attachmentsHaveSlackMessagePreviews(attachments) {
 export function slackPermalinkMentioned(text) {
     return Boolean(text && /https:\/\/[^\s|>]+\.slack\.com\/archives\/[A-Z0-9]+\/p\d{10,}/.test(text));
 }
-function sleepMs(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
 function stringField(record, key) {
     const value = record[key];
     if (typeof value !== 'string')

package/dist/server/storage/schema/wake-queue.store.d.ts

@@ -86,6 +86,7 @@ export declare const WakeQueueFileSchema: z.ZodPreprocess<z.ZodObject<{
             messageTs: z.ZodOptional<z.ZodString>;
             text: z.ZodString;
         }, z.core.$strip>>>;
+        previewStatus: z.ZodOptional<z.ZodLiteral<"unavailable">>;
         teamId: z.ZodString;
         text: z.ZodString;
         threadTs: z.ZodOptional<z.ZodString>;

package/dist/server/storage/schema/wake-queue.store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wake-queue.store.d.ts","sourceRoot":"","sources":["../../../../server/storage/schema/wake-queue.store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wake-queue.store.d.ts","sourceRoot":"","sources":["../../../../server/storage/schema/wake-queue.store.ts"],"names":[],"mappings":"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"}

package/dist/server/tests/slack-ingest.test.js

@@ -3,11 +3,17 @@ import assert from 'node:assert/strict';
 import { mkdtemp, rm } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { buildSlackInboxItem, buildSlackInboxItemWithLatePreview } from '../inbox/slack-ingest.js';
-import { applyLateSlackPreviewToQueuedItem } from '../inbox/slack-subscriber.js';
+import { createServer } from 'node:http';
+import { buildSlackInboxItem } from '../inbox/slack-ingest.js';
+import { runIngestPipeline } from '../inbox/ingest-pipeline.js';
+import { SlackInboxItem } from '../../shared/inbox.js';
+import { buildCodeAgentDeliveryPrompt, renderSlackCursorExtras } from '../runtime/delivery-prompt.js';
 import { WakeQueueService } from '../inbox/wake-queue.service.js';
 import { slackMessageContentForText } from '../tools/slack-message-format.js';
 import { withAnimaHome } from './anima-home.js';
+import { withTempAnimaHome, writeAgentConfigs, withTimeout } from './helpers/harness.js';
+import { SlackInboxSubscriber } from '../inbox/slack-subscriber.js';
+import { SlackProfileResolver } from '../slack/profiles.js';
 function fakeIngestClient(input) {
     return {
         chat: {
@@ -390,109 +396,182 @@ test('buildSlackInboxItem re-reads only the containing message for late unfurls,
         }
     });
 });
-test('Slack ingest enqueue does not wait for the delayed unfurl retry ladder', async () => {
+const sharedLink = 'https://demo.slack.com/archives/C0PRIVATE1/p1770000100000001';
+const linkEvent = {
+    attachments: [{ fallback: 'ordinary attachment must not suppress lookup' }],
+    channel: 'D-owner',
+    channel_type: 'im',
+    text: `<${sharedLink}> can you see this?`,
+    ts: '1770000300.000001',
+    type: 'message',
+    user: 'UALICE1',
+};
+const previewAttachment = {
+    channel_id: 'C0PRIVATE1', from_url: sharedLink, is_msg_unfurl: true,
+    text: 'Late shared preview', ts: '1770000100.000001',
+};
+test('ingest holds enqueue until preview completes, then an immediate claim contains it; duplicates stay deduped', { timeout: 3_000 }, async () => {
     await withIngestHome(async () => {
-        const link = 'https://demo.slack.com/archives/C0PRIVATE1/p1770000100000001';
         const calls = emptyCalls();
         const client = fakeIngestClient({ calls });
-        client.conversations.history = async () => new Promise(() => { });
-        const result = await buildSlackInboxItemWithLatePreview({
-            client,
-            envelope: { team_id: 'T-ingest' },
-            event: {
-                attachments: [{ fallback: 'ordinary attachment' }],
-                channel: 'D-owner',
-                channel_type: 'im',
-                text: `<${link}> can you see this?`,
-                ts: '1770000300.000001',
-                type: 'message',
-                user: 'UALICE1',
+        let finishLookup;
+        const held = new Promise((resolve) => { finishLookup = resolve; });
+        let lookupStarted;
+        const started = new Promise((resolve) => { lookupStarted = resolve; });
+        client.conversations.history = async (args) => {
+            calls.history.push(args);
+            if (calls.history.length === 1)
+                return { ok: true, messages: [] };
+            lookupStarted();
+            await held;
+            return { ok: true, messages: [{ ts: linkEvent.ts, attachments: [previewAttachment] }] };
+        };
+        const queue = new WakeQueueService('anima');
+        let enrichCount = 0;
+        const ingest = () => runIngestPipeline({
+            agentId: 'anima',
+            itemId: 'slack:T-ingest:D-owner:' + linkEvent.ts,
+            decide: async ({ duplicate }) => ({ shouldStartRuntime: !duplicate, reason: 'dm' }),
+            enrich: async () => {
+                enrichCount++;
+                return buildSlackInboxItem({
+                    client, envelope: { team_id: 'T-ingest' }, event: linkEvent,
+                    previewRetryDelaysMs: [0, 0], warn: () => { },
+                });
             },
-            warn: () => { },
+            queue,
+            surfaceLog: () => ({}),
         });
-        assert.ok(result.latePreview);
+        const pending = ingest();
+        await Promise.race([
+            started,
+            pending.then(() => { throw new Error('wake was published before preview retry'); }),
+        ]);
+        assert.equal(await queue.takeNextRunnable({ isWorkerAlive: () => true, workerId: 'worker-1' }), undefined);
+        finishLookup();
+        await pending;
+        const claimed = await queue.takeNextRunnable({ isWorkerAlive: () => true, workerId: 'worker-1' });
+        assert.equal(claimed?.kind, 'slack');
+        if (claimed?.kind !== 'slack')
+            throw new Error('missing Slack item');
+        assert.equal(claimed.previews?.[0]?.text, 'Late shared preview');
+        assert.equal(claimed.previewStatus, undefined);
+        assert.match(buildCodeAgentDeliveryPrompt(claimed), /Late shared preview/);
+        await ingest();
+        assert.equal(enrichCount, 1);
+        assert.equal(await queue.takeNextRunnable({ isWorkerAlive: () => true, workerId: 'worker-2' }), undefined);
+        assert.equal(calls.history.length, 2);
+        for (const call of calls.history) {
+            assert.equal(call.channel, 'D-owner');
+            assert.equal(call.latest, linkEvent.ts);
+            assert.equal(call.oldest, linkEvent.ts);
+        }
+    });
+});
+test('subscriber waits for the production preview client before publishing a claimable wake', async () => {
+    await withTempAnimaHome(async (home) => {
+        await writeAgentConfigs(home);
+        let finish;
+        let started;
+        const lookupStarted = new Promise((resolve) => { started = resolve; });
+        const requests = [];
+        const server = createServer((request, response) => {
+            let body = '';
+            request.on('data', (chunk) => { body += String(chunk); });
+            request.on('end', () => {
+                requests.push({ url: request.url, body });
+                finish = () => {
+                    if (!response.writableEnded)
+                        response.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify({
+                            ok: true, messages: [{ ts: linkEvent.ts, attachments: [previewAttachment] }],
+                        }));
+                };
+                started();
+            });
+        });
+        await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve));
+        const previousUrl = process.env.ANIMA_SLACK_API_URL;
+        process.env.ANIMA_SLACK_API_URL = `http://127.0.0.1:${server.address().port}/api/`;
         const queue = new WakeQueueService('anima');
-        const decision = await queue.enqueue(result.item);
-        assert.equal(decision.queued, true);
-        assert.equal((await queue.find(result.item.id))?.id, result.item.id);
+        const subscriber = Object.create(SlackInboxSubscriber.prototype);
+        subscriber['options'] = { agentRuntimeKind: 'codex-cli', botToken: 'test-only-token', botUserId: 'U-bot', queue };
+        subscriber['slackProfiles'] = new SlackProfileResolver();
+        subscriber['botDisplayInfoSyncInFlight'] = true;
+        const handle = () => subscriber.handleSlackEvent({ team_id: 'T-ingest' }, linkEvent, fakeIngestClient({ calls: emptyCalls() }));
+        let pending;
+        try {
+            pending = handle();
+            await withTimeout(lookupStarted, 1_000);
+            assert.equal(await queue.takeNextRunnable({ isWorkerAlive: () => true, workerId: 'fast-worker' }), undefined);
+            finish();
+            await pending;
+            const claimed = await queue.takeNextRunnable({ isWorkerAlive: () => true, workerId: 'fast-worker' });
+            assert.equal(claimed?.kind, 'slack');
+            if (claimed?.kind === 'slack')
+                assert.equal(claimed.previews?.[0]?.text, 'Late shared preview');
+            assert.equal(requests.length, 1);
+            assert.equal(requests[0]?.url, '/api/conversations.history');
+            const body = new URLSearchParams(requests[0]?.body);
+            assert.equal(body.get('channel'), 'D-owner');
+            assert.equal(body.get('oldest'), linkEvent.ts);
+            assert.equal(body.get('latest'), linkEvent.ts);
+        }
+        finally {
+            finish?.();
+            // Join ingress before deleting its scoped home, including on assertion failure.
+            await pending;
+            if (previousUrl === undefined)
+                delete process.env.ANIMA_SLACK_API_URL;
+            else
+                process.env.ANIMA_SLACK_API_URL = previousUrl;
+            server.closeAllConnections();
+            await new Promise((resolve) => server.close(() => resolve()));
+        }
     });
 });
-test('late Slack previews replace queued items and leave claimed items untouched', async () => {
+test('hanging preview request times out before enqueue; late results cannot mutate the delivered item', async () => {
     await withIngestHome(async () => {
-        const queuedQueue = new WakeQueueService('anima');
-        const queuedItem = await buildSlackInboxItem({
-            client: fakeIngestClient({ calls: emptyCalls() }),
-            envelope: { team_id: 'T-ingest' },
-            event: {
-                channel: 'D-owner',
-                channel_type: 'im',
-                text: 'queued preview',
-                ts: '1770000400.000001',
-                type: 'message',
-                user: 'UALICE1',
-            },
-            warn: () => { },
-        });
-        await queuedQueue.enqueue(queuedItem);
-        await applyLateSlackPreviewToQueuedItem({
-            item: queuedItem,
-            latePreview: async (item) => ({
-                ...item,
-                previews: [{ text: 'late preview while queued' }],
-            }),
-            queue: queuedQueue,
-        });
-        const updatedQueuedItem = await queuedQueue.find(queuedItem.id);
-        assert.equal(updatedQueuedItem?.kind, 'slack');
-        assert.deepEqual(updatedQueuedItem.previews, [{ text: 'late preview while queued' }]);
-        await queuedQueue.complete(queuedItem.id);
-        const claimedQueue = new WakeQueueService('anima');
-        let runningItemId;
-        const claimedItem = await buildSlackInboxItem({
-            client: fakeIngestClient({ calls: emptyCalls() }),
-            envelope: { team_id: 'T-ingest' },
-            event: {
-                channel: 'D-owner',
-                channel_type: 'im',
-                text: 'claimed preview',
-                ts: '1770000500.000001',
-                type: 'message',
-                user: 'UALICE1',
-            },
-            warn: () => { },
-        });
-        await claimedQueue.enqueue(claimedItem);
-        await applyLateSlackPreviewToQueuedItem({
-            item: claimedItem,
-            latePreview: async (item) => ({
-                ...item,
-                previews: [{ text: 'late preview after claim' }],
-            }),
-            queue: {
-                replaceQueuedItem: async (item) => {
-                    const running = await claimedQueue.takeNextRunnable({
-                        isWorkerAlive: () => true,
-                        workerId: 'worker-1',
-                    });
-                    runningItemId = running?.id;
-                    return claimedQueue.replaceQueuedItem(item);
-                },
-            },
-        });
-        assert.equal(runningItemId, claimedItem.id);
-        const updatedClaimedItem = await claimedQueue.find(claimedItem.id);
-        assert.equal(updatedClaimedItem?.kind, 'slack');
-        assert.equal(updatedClaimedItem.handling.status, 'running');
-        assert.equal(updatedClaimedItem.previews, undefined);
-        await claimedQueue.complete(claimedItem.id);
-        await applyLateSlackPreviewToQueuedItem({
-            item: claimedItem,
-            latePreview: async (item) => ({
-                ...item,
-                previews: [{ text: 'late preview after settle' }],
-            }),
-            queue: claimedQueue,
+        const client = fakeIngestClient({ calls: emptyCalls() });
+        let resolveLookup;
+        client.conversations.history = (() => new Promise((resolve) => { resolveLookup = resolve; }));
+        const startedAt = performance.now();
+        const item = await buildSlackInboxItem({
+            client, envelope: { team_id: 'T-ingest' }, event: linkEvent,
+            previewTimeoutMs: 30, previewRetryDelaysMs: [0, 0], warn: () => { },
         });
-        assert.equal(await claimedQueue.find(claimedItem.id), undefined);
+        assert.ok(performance.now() - startedAt < 1_000);
+        assert.equal(item.previewStatus, 'unavailable');
+        assert.equal(item.text, linkEvent.text);
+        const parsed = SlackInboxItem.parse(item);
+        assert.equal(parsed.previewStatus, 'unavailable');
+        assert.match(buildCodeAgentDeliveryPrompt(parsed), /Preview not yet obtained/);
+        assert.match(renderSlackCursorExtras(parsed), /status="unavailable"/);
+        const queue = new WakeQueueService('anima');
+        assert.equal((await queue.enqueue(item)).queued, true);
+        resolveLookup({ ok: true, messages: [{ ts: linkEvent.ts, attachments: [previewAttachment] }] });
+        await new Promise((resolve) => setImmediate(resolve));
+        const claimed = await queue.takeNextRunnable({ isWorkerAlive: () => true, workerId: 'worker-1' });
+        assert.equal(claimed?.kind, 'slack');
+        if (claimed?.kind === 'slack') {
+            assert.equal(claimed.previewStatus, 'unavailable');
+            assert.equal(claimed.previews, undefined);
+        }
+    });
+});
+test('ordinary messages and already attached previews do not create a preview client or wait', async () => {
+    await withIngestHome(async () => {
+        for (const event of [
+            { ...linkEvent, text: 'plain message', attachments: undefined },
+            { ...linkEvent, attachments: [previewAttachment] },
+        ]) {
+            const calls = emptyCalls();
+            const item = await buildSlackInboxItem({
+                client: fakeIngestClient({ calls }), event,
+                previewClient: () => { throw new Error('unexpected preview client'); },
+                warn: () => { },
+            });
+            assert.deepEqual(calls.history, []);
+            assert.equal(item.previewStatus, undefined);
+        }
     });
 });

package/dist/server/tests/slack-message-previews.test.js

@@ -1,5 +1,7 @@
 import test from 'node:test';
 import assert from 'node:assert/strict';
+import { createServer } from 'node:http';
+import { createSlackPreviewWebClient } from '../slack/client.js';
 import { waitForSlackMessagePreviewAttachments } from '../slack/message-previews.js';
 import { normalizeSlackMessage } from '../inbox/slack-events.js';
 test('delayed Slack preview wait returns containing-message unfurl attachments before enqueue', async () => {
@@ -78,3 +80,98 @@ test('delayed Slack preview wait skips messages without Slack permalinks', async
     assert.equal(attachments, undefined);
     assert.equal(calls, 0);
 });
+test('preview budget bounds a hung initial read and aborts its client without another retry', async () => {
+    let calls = 0;
+    let signal;
+    const client = {
+        conversations: { history: async () => { calls++; return new Promise(() => { }); } },
+    };
+    const start = performance.now();
+    assert.equal(await waitForSlackMessagePreviewAttachments({
+        channelId: 'D-containing', messageTs: '1782810200.000001', client,
+        createClient: (value) => { signal = value; return client; },
+        text: 'https://demo.slack.com/archives/C0PRIVATE1/p1770000100000001',
+        timeoutMs: 30, retryDelaysMs: [0, 0, 0],
+    }), undefined);
+    assert.ok(performance.now() - start < 1_000);
+    assert.equal(signal?.aborted, true);
+    assert.equal(calls, 1);
+});
+test('preview budget includes retry sleeps and leaves no later lookup', async () => {
+    let calls = 0;
+    const client = {
+        conversations: { history: async () => { calls++; return { messages: [] }; } },
+    };
+    assert.equal(await waitForSlackMessagePreviewAttachments({
+        channelId: 'D-containing', messageTs: '1782810200.000001', client,
+        text: 'https://demo.slack.com/archives/C0PRIVATE1/p1770000100000001',
+        timeoutMs: 20, retryDelaysMs: [0, 40],
+    }), undefined);
+    await new Promise((resolve) => setTimeout(resolve, 60));
+    assert.equal(calls, 1);
+});
+test('lookup errors degrade without losing the message or reading a target channel', async () => {
+    const channels = [];
+    const client = {
+        conversations: { history: async (args) => {
+                channels.push(args.channel);
+                throw new Error('channel_not_found');
+            } },
+    };
+    assert.equal(await waitForSlackMessagePreviewAttachments({
+        channelId: 'D-containing', messageTs: '1782810200.000001', client,
+        text: 'https://demo.slack.com/archives/C0PRIVATE1/p1770000100000001',
+        retryDelaysMs: [0, 0, 0], warn: () => { },
+    }), undefined);
+    assert.deepEqual(channels, ['D-containing', 'D-containing', 'D-containing']);
+});
+test('production preview transport aborts hanging HTTP and rejects rate-limit backoff', async () => {
+    let requests = 0;
+    let mode = 'hang';
+    let closed;
+    const socketClosed = new Promise((resolve) => { closed = resolve; });
+    const server = createServer((_request, response) => {
+        requests++;
+        if (mode === 'hang')
+            response.on('close', closed);
+        else
+            response.writeHead(429, { 'retry-after': '60' }).end();
+    });
+    await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve));
+    const previousUrl = process.env.ANIMA_SLACK_API_URL;
+    process.env.ANIMA_SLACK_API_URL = `http://127.0.0.1:${server.address().port}/api/`;
+    const unusedClient = {};
+    const input = {
+        client: unusedClient,
+        createClient: (signal) => createSlackPreviewWebClient('test-only-token', signal),
+        channelId: 'D-containing', messageTs: '1782810200.000001',
+        text: 'https://demo.slack.com/archives/C0PRIVATE1/p1770000100000001',
+        retryDelaysMs: [0], timeoutMs: 200, warn: () => { },
+    };
+    try {
+        assert.equal(await waitForSlackMessagePreviewAttachments(input), undefined);
+        let timer;
+        try {
+            await Promise.race([socketClosed, new Promise((_, reject) => {
+                    timer = setTimeout(() => reject(new Error('preview socket was not aborted')), 500);
+                })]);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        assert.equal(requests, 1);
+        mode = 'rate-limit';
+        const start = performance.now();
+        assert.equal(await waitForSlackMessagePreviewAttachments({ ...input, timeoutMs: 1_000 }), undefined);
+        assert.ok(performance.now() - start < 800, '429 must not wait for SDK backoff or total deadline');
+        assert.equal(requests, 2);
+    }
+    finally {
+        if (previousUrl === undefined)
+            delete process.env.ANIMA_SLACK_API_URL;
+        else
+            process.env.ANIMA_SLACK_API_URL = previousUrl;
+        server.closeAllConnections();
+        await new Promise((resolve) => server.close(() => resolve()));
+    }
+});

package/dist/shared/inbox.d.ts

@@ -182,6 +182,7 @@ export declare const SlackInboxItem: z.ZodObject<{
         messageTs: z.ZodOptional<z.ZodString>;
         text: z.ZodString;
     }, z.core.$strip>>>;
+    previewStatus: z.ZodOptional<z.ZodLiteral<"unavailable">>;
     teamId: z.ZodString;
     text: z.ZodString;
     threadTs: z.ZodOptional<z.ZodString>;
@@ -553,6 +554,7 @@ export declare const InboxItemSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         messageTs: z.ZodOptional<z.ZodString>;
         text: z.ZodString;
     }, z.core.$strip>>>;
+    previewStatus: z.ZodOptional<z.ZodLiteral<"unavailable">>;
     teamId: z.ZodString;
     text: z.ZodString;
     threadTs: z.ZodOptional<z.ZodString>;

package/dist/shared/inbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inbox.d.ts","sourceRoot":"","sources":["../../shared/inbox.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"inbox.d.ts","sourceRoot":"","sources":["../../shared/inbox.ts"],"names":[],"mappings":"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"}

package/dist/shared/inbox.js

@@ -96,6 +96,8 @@ export const SlackInboxItem = InboxItemBase.extend({
     messageTs: z.string(),
     permalink: z.string().optional(),
     previews: z.array(SlackMessagePreview).optional(),
+    /** Bounded lookup did not obtain a preview; not proof that none exists. */
+    previewStatus: z.literal('unavailable').optional(),
     teamId: z.string(),
     text: z.string(),
     threadTs: z.string().optional(),

package/docs/architecture/internals.md

@@ -39,7 +39,7 @@ Slack event filtering and normalization live in `server/inbox/slack-events.ts`.
 
 `server/inbox/slack-subscriber.ts` calls `isRoutableSlackMessage` before doing any queue work. For routable events, it derives a stable item id with `slackMessageEventId` from `server/ids.ts`.
 
-`server/inbox/slack-ingest.ts` turns the Slack event into a `SlackInboxItem` from `shared/inbox.ts`. `buildSlackInboxItemWithLatePreview` adds sender profile data, channel profile data, readable mention text, permalink, file metadata, and Slack unfurl previews. If Slack has not attached message previews yet, the returned `latePreview` callback updates the queued item after enqueue with `WakeQueueService.replaceQueuedItem`.
+`server/inbox/slack-ingest.ts` turns the Slack event into a `SlackInboxItem` from `shared/inbox.ts`. `buildSlackInboxItem` adds sender profile data, channel profile data, readable mention text, permalink, file metadata, and Slack unfurl previews. Messages containing Slack permalinks wait for preview enrichment before enqueue: an immediate read and retries around 2 and 7 seconds share an 8-second total preview budget. Existing previews and ordinary messages skip that wait. Reads target only the containing message, never the linked channel or DM. The preview client disables SDK retries and rate-limit backoff, bounds each request, and aborts at the budget boundary. If no preview is obtained, the original wake proceeds with `previewStatus=unavailable`; both delivery paths explain that this is not evidence of an absent preview or permission to read the linked target. No post-enqueue callback mutates a claimed item or starts a second wake.
 
 ### 3. Ingest decision pipeline
 
@@ -52,7 +52,7 @@ The shared decision skeleton is `server/inbox/ingest-pipeline.ts`.
 3. `enrich`, which builds the final inbox item;
 4. tag the item with `attentionSuggestion` and parsed `wakeReason`;
 5. `enqueue` through `WakeQueueService`;
-6. optional post-enqueue effects such as late previews and subscription activity;
+6. optional post-enqueue effects such as subscription activity;
 7. optional attention-suggestion activity;
 8. structured ingest log output.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meetquinn/animactl",
-  "version": "0.1.26",
+  "version": "0.1.27",
   "license": "Apache-2.0",
   "private": false,
   "description": "Operator CLI for installing and running Anima.",