@cursor/july 0.1.111 → 0.1.112

package/dist/channels/slack/dispatch.js

@@ -13,6 +13,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { continuationSource, normalizeIdentity, } from "../../internal/continuation-identity.js";
 import { isDeferredChannelSession } from "../../internal/deferred-channel-session.js";
 import { routeLocalIngressContinuation } from "../../internal/local-ingress.js";
+import { mapThrownRequestError } from "../../internal/request-error-status.js";
 import { isSlackImChannel } from "../../internal/slack-thread-key.js";
 import { steeringEnabled } from "../../internal/steering.js";
 import { buildSlackBinding, slackContinuationKey } from "./api.js";
@@ -23,7 +24,7 @@ import { isExternalSlackSender } from "./external-policy.js";
 import { describeSlackEventShape, formatSlackContextBlock, parseAppHomeOpened, parseAppMentionEvent, parseAssistantThreadStarted, parseChannelMessageEvent, parseDirectMessageEvent, parseReactionAddedEvent, } from "./inbound.js";
 import { defaultSlackLog } from "./log.js";
 import { paintTurnStart, retractTurnStart } from "./paint-start.js";
-import { startPlaceholder } from "./placeholder.js";
+import { adoptPlaceholder, retractPlaceholderMessage, retractPlaceholderSlot, startPlaceholder, } from "./placeholder.js";
 import { isWholeMessageStop } from "./stop.js";
 import { loadSlackThreadContextBlock, loadSlackThreadDeltaBlock, } from "./thread-context.js";
 const FOLLOWUP_TYPING = "Saw your follow-up…";
@@ -104,7 +105,9 @@ function inboundContinuation(deps) {
         : { interruptContinuation: deps.interruptContinuation }));
 }
 function scheduleInbound(deps, log, args) {
-    deps.waitUntil(dispatchInboundMessage(Object.assign(Object.assign({ kind: args.kind, message: args.message, handler: args.handler, propagateHandlerErrors: deps.propagateHandlerErrors, send: deps.send, credentials: deps.credentials, host: deps.host, artifacts: deps.artifacts, log, evalCommandsEnabled: args.evalCommandsEnabled, followUpStatus: deps.followUpStatus, ack: deps.ack, placeholder: deps.placeholder, blockExternals: deps.blockExternals }, inboundContinuation(deps)), (args.eventId === undefined ? {} : { eventId: args.eventId }))));
+    deps.waitUntil(dispatchInboundMessage(Object.assign(Object.assign(Object.assign({ kind: args.kind, message: args.message, handler: args.handler, propagateHandlerErrors: deps.propagateHandlerErrors, send: deps.send, credentials: deps.credentials, host: deps.host, artifacts: deps.artifacts, log, evalCommandsEnabled: args.evalCommandsEnabled, followUpStatus: deps.followUpStatus, ack: deps.ack, placeholder: deps.placeholder, blockExternals: deps.blockExternals }, inboundContinuation(deps)), (args.eventId === undefined ? {} : { eventId: args.eventId })), (args.platformHandoff === undefined
+        ? {}
+        : { platformHandoff: args.platformHandoff }))));
 }
 function slackSessionContinuation(identity, channelId, threadTs) {
     if (continuationSource(identity, "slack") === "engine") {
@@ -125,10 +128,10 @@ function slackSessionContinuation(identity, channelId, threadTs) {
 }
 export function dispatchInboundMessage(args) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0;
-        var _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2;
+        var _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16, _17;
         const { message, kind } = args;
-        const log = (_1 = args.log) !== null && _1 !== void 0 ? _1 : defaultSlackLog;
+        const log = (_3 = args.log) !== null && _3 !== void 0 ? _3 : defaultSlackLog;
         const binding = buildSlackBinding({
             botToken: (_a = args.credentials) === null || _a === void 0 ? void 0 : _a.botToken,
             channelId: message.channelId,
@@ -147,10 +150,72 @@ export function dispatchInboundMessage(args) {
             user: (_b = message.author) === null || _b === void 0 ? void 0 : _b.userId,
             team: message.teamId,
         });
-        const userId = (_2 = (_c = message.author) === null || _c === void 0 ? void 0 : _c.userId) !== null && _2 !== void 0 ? _2 : "";
+        const handoff = (_c = args.platformHandoff) === null || _c === void 0 ? void 0 : _c.slackPlaceholder;
+        const matchedHandoff = args.placeholder !== undefined &&
+            kind !== "channel_post" &&
+            handoff !== undefined &&
+            handoff.channelId === message.channelId &&
+            handoff.threadTs === message.threadTs
+            ? handoff
+            : undefined;
+        let adoptedPlaceholder = false;
+        let handoffRetracted = false;
+        const retractUnadoptedHandoff = () => __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            if (matchedHandoff === undefined || handoffRetracted) {
+                return;
+            }
+            handoffRetracted = true;
+            yield retractPlaceholderMessage({
+                botToken: (_a = args.credentials) === null || _a === void 0 ? void 0 : _a.botToken,
+                channelId: matchedHandoff.channelId,
+                ts: matchedHandoff.messageTs,
+                streamed: matchedHandoff.streamed,
+                log,
+            });
+        });
+        const adoptMatchedHandoff = () => __awaiter(this, void 0, void 0, function* () {
+            if (matchedHandoff === undefined) {
+                return;
+            }
+            const adoption = adoptPlaceholder({
+                channelId: matchedHandoff.channelId,
+                threadTs: matchedHandoff.threadTs,
+                ts: matchedHandoff.messageTs,
+                streamed: matchedHandoff.streamed,
+            });
+            if (adoption === "adopted") {
+                adoptedPlaceholder = true;
+                log.info("placeholder adopted from control-plane handoff", {
+                    channel: message.channelId,
+                    thread_ts: message.threadTs,
+                    message_ts: matchedHandoff.messageTs,
+                });
+                return;
+            }
+            if (adoption === "occupied") {
+                // Another delivery owns this thread's slot. Remove only this delivery's
+                // redundant CP post.
+                yield retractUnadoptedHandoff();
+            }
+        });
+        const retractAdoptedPlaceholder = () => __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            if (!adoptedPlaceholder) {
+                return;
+            }
+            adoptedPlaceholder = false;
+            yield retractPlaceholderSlot({
+                channelId: message.channelId,
+                threadTs: message.threadTs,
+                botToken: (_a = args.credentials) === null || _a === void 0 ? void 0 : _a.botToken,
+                log,
+            });
+        });
+        const userId = (_4 = (_d = message.author) === null || _d === void 0 ? void 0 : _d.userId) !== null && _4 !== void 0 ? _4 : "";
         const teamId = message.teamId;
         let membership;
-        if (args.blockExternals !== false && ((_d = message.author) === null || _d === void 0 ? void 0 : _d.isBot) !== true) {
+        if (args.blockExternals !== false && ((_e = message.author) === null || _e === void 0 ? void 0 : _e.isBot) !== true) {
             if (teamId === undefined || teamId === "") {
                 log.info("inbound dropped (missing team)", {
                     kind,
@@ -159,10 +224,11 @@ export function dispatchInboundMessage(args) {
                     user: userId,
                     event_id: args.eventId,
                 });
+                yield retractUnadoptedHandoff();
                 return;
             }
             membership = isExternalSlackSender({
-                botToken: (_e = args.credentials) === null || _e === void 0 ? void 0 : _e.botToken,
+                botToken: (_f = args.credentials) === null || _f === void 0 ? void 0 : _f.botToken,
                 slackTeamId: teamId,
                 userId,
             });
@@ -188,6 +254,7 @@ export function dispatchInboundMessage(args) {
             isWholeMessageStop(message.markdown)) {
             if (membership !== undefined && (yield membership)) {
                 dropExternal();
+                yield retractUnadoptedHandoff();
                 return;
             }
             log.info("stop directive", {
@@ -197,16 +264,17 @@ export function dispatchInboundMessage(args) {
                 continuation,
                 event_id: args.eventId,
             });
-            yield (_f = args.host.slackNudges) === null || _f === void 0 ? void 0 : _f.clear(continuation);
+            yield (_g = args.host.slackNudges) === null || _g === void 0 ? void 0 : _g.clear(continuation);
             const interrupted = args.interruptContinuation === undefined
                 ? false
                 : yield args.interruptContinuation(continuation);
             try {
                 yield binding.thread.startTyping(interrupted ? "Stopped." : "Nothing to stop.");
             }
-            catch (_16) {
+            catch (_18) {
                 // best-effort status
             }
+            yield retractUnadoptedHandoff();
             return;
         }
         // Built-in eval directive: run playground batches without an agent turn.
@@ -215,11 +283,12 @@ export function dispatchInboundMessage(args) {
         const evalCommandsEnabled = args.evalCommandsEnabled !== false &&
             (kind === "app_mention" || kind === "direct_message");
         const evalDirective = evalCommandsEnabled && args.host.evals !== undefined
-            ? ((_3 = parseSlackEvalDirective(message.text)) !== null && _3 !== void 0 ? _3 : parseSlackEvalDirective(message.markdown))
+            ? ((_5 = parseSlackEvalDirective(message.text)) !== null && _5 !== void 0 ? _5 : parseSlackEvalDirective(message.markdown))
             : null;
         if (evalDirective !== null && args.host.evals !== undefined) {
             if (membership !== undefined && (yield membership)) {
                 dropExternal();
+                yield retractUnadoptedHandoff();
                 return;
             }
             log.info("eval directive", {
@@ -235,6 +304,7 @@ export function dispatchInboundMessage(args) {
                 evals: args.host.evals,
                 binding,
             });
+            yield retractUnadoptedHandoff();
             return;
         }
         let decision;
@@ -249,8 +319,12 @@ export function dispatchInboundMessage(args) {
                 event_id: args.eventId,
             });
             if (args.propagateHandlerErrors === true) {
+                if (((_h = mapThrownRequestError(error)) === null || _h === void 0 ? void 0 : _h.retry) !== "transient") {
+                    yield retractUnadoptedHandoff();
+                }
                 throw error;
             }
+            yield retractUnadoptedHandoff();
             return;
         }
         if (decision === null || decision === undefined) {
@@ -260,10 +334,11 @@ export function dispatchInboundMessage(args) {
                 thread_ts: message.threadTs,
                 event_id: args.eventId,
             });
+            yield retractUnadoptedHandoff();
             return;
         }
         // Reply-once / delayed parent: claim channel:ts after the handler accepts.
-        const claimed = yield (_g = args.host.slackNudges) === null || _g === void 0 ? void 0 : _g.tryClaimAsk(message.channelId, message.ts);
+        const claimed = yield (_j = args.host.slackNudges) === null || _j === void 0 ? void 0 : _j.tryClaimAsk(message.channelId, message.ts);
         if (claimed === false) {
             log.info("inbound ask dedupe drop", {
                 kind,
@@ -274,10 +349,11 @@ export function dispatchInboundMessage(args) {
             });
             return;
         }
+        yield adoptMatchedHandoff();
         const painted = args.ack === undefined
             ? undefined
             : paintTurnStart({
-                botToken: (_h = args.credentials) === null || _h === void 0 ? void 0 : _h.botToken,
+                botToken: (_k = args.credentials) === null || _k === void 0 ? void 0 : _k.botToken,
                 channelId: message.channelId,
                 threadTs: message.threadTs,
                 ack: args.ack,
@@ -285,7 +361,7 @@ export function dispatchInboundMessage(args) {
             });
         if (message.ts === message.threadTs && !isSlackImChannel(message.channelId)) {
             void maybeSetThreadTitle({
-                botToken: (_j = args.credentials) === null || _j === void 0 ? void 0 : _j.botToken,
+                botToken: (_l = args.credentials) === null || _l === void 0 ? void 0 : _l.botToken,
                 channelId: message.channelId,
                 threadTs: message.threadTs,
                 title: firstLineTitle(message.markdown),
@@ -294,13 +370,13 @@ export function dispatchInboundMessage(args) {
         }
         const excludeThreadTimestamps = [
             message.ts,
-            ...((_4 = decision.excludeThreadTimestamps) !== null && _4 !== void 0 ? _4 : []),
+            ...((_6 = decision.excludeThreadTimestamps) !== null && _6 !== void 0 ? _6 : []),
         ];
         const mergeMessages = [triggeringMergeMessage(message)];
         const mediaTask = slackTurnMedia({
             message,
             decision,
-            botToken: (_k = args.credentials) === null || _k === void 0 ? void 0 : _k.botToken,
+            botToken: (_m = args.credentials) === null || _m === void 0 ? void 0 : _m.botToken,
             log,
         });
         const continuationExists = existsP === undefined ? false : yield existsP;
@@ -314,10 +390,10 @@ export function dispatchInboundMessage(args) {
         const threadTask = !loadThread
             ? Promise.resolve(undefined)
             : hasSession
-                ? loadSlackThreadDeltaBlock(Object.assign(Object.assign({ botToken: (_l = args.credentials) === null || _l === void 0 ? void 0 : _l.botToken, channelId: message.channelId, threadTs: message.threadTs }, (afterTs === undefined ? {} : { afterTs })), { excludeTs: excludeThreadTimestamps, mergeMessages,
+                ? loadSlackThreadDeltaBlock(Object.assign(Object.assign({ botToken: (_o = args.credentials) === null || _o === void 0 ? void 0 : _o.botToken, channelId: message.channelId, threadTs: message.threadTs }, (afterTs === undefined ? {} : { afterTs })), { excludeTs: excludeThreadTimestamps, mergeMessages,
                     log }))
                 : loadSlackThreadContextBlock({
-                    botToken: (_m = args.credentials) === null || _m === void 0 ? void 0 : _m.botToken,
+                    botToken: (_p = args.credentials) === null || _p === void 0 ? void 0 : _p.botToken,
                     channelId: message.channelId,
                     threadTs: message.threadTs,
                     excludeTs: excludeThreadTimestamps,
@@ -334,14 +410,15 @@ export function dispatchInboundMessage(args) {
             if (painted !== undefined) {
                 yield painted;
                 yield retractTurnStart({
-                    botToken: (_o = args.credentials) === null || _o === void 0 ? void 0 : _o.botToken,
+                    botToken: (_q = args.credentials) === null || _q === void 0 ? void 0 : _q.botToken,
                     channelId: message.channelId,
                     threadTs: message.threadTs,
-                    ack: (_5 = args.ack) !== null && _5 !== void 0 ? _5 : "",
+                    ack: (_7 = args.ack) !== null && _7 !== void 0 ? _7 : "",
                     log,
                 });
             }
-            yield (_p = args.host.slackNudges) === null || _p === void 0 ? void 0 : _p.releaseAsk(message.channelId, message.ts);
+            yield (_r = args.host.slackNudges) === null || _r === void 0 ? void 0 : _r.releaseAsk(message.channelId, message.ts);
+            yield retractAdoptedPlaceholder();
             return;
         }
         if (message.files !== undefined && message.files.length > 0) {
@@ -349,8 +426,8 @@ export function dispatchInboundMessage(args) {
                 kind,
                 channel: message.channelId,
                 thread_ts: message.threadTs,
-                images: (_6 = (_q = media.images) === null || _q === void 0 ? void 0 : _q.length) !== null && _6 !== void 0 ? _6 : 0,
-                workspace_files: Object.keys((_7 = media.workspaceFiles) !== null && _7 !== void 0 ? _7 : {}).length,
+                images: (_8 = (_s = media.images) === null || _s === void 0 ? void 0 : _s.length) !== null && _8 !== void 0 ? _8 : 0,
+                workspace_files: Object.keys((_9 = media.workspaceFiles) !== null && _9 !== void 0 ? _9 : {}).length,
                 event_id: args.eventId,
             });
         }
@@ -358,11 +435,11 @@ export function dispatchInboundMessage(args) {
             log.info(hasSession ? "thread delta loaded" : "thread context loaded", Object.assign({ kind, channel: message.channelId, thread_ts: message.threadTs, chars: threadContext.length, event_id: args.eventId }, (afterTs === undefined ? {} : { after_ts: afterTs })));
         }
         const prompt = [
-            formatSlackContextBlock(Object.assign(Object.assign({ userId: (_8 = (_r = message.author) === null || _r === void 0 ? void 0 : _r.userId) !== null && _8 !== void 0 ? _8 : "", channelId: message.channelId, threadTs: message.threadTs }, (((_s = message.author) === null || _s === void 0 ? void 0 : _s.userName) === undefined
+            formatSlackContextBlock(Object.assign(Object.assign({ userId: (_10 = (_t = message.author) === null || _t === void 0 ? void 0 : _t.userId) !== null && _10 !== void 0 ? _10 : "", channelId: message.channelId, threadTs: message.threadTs }, (((_u = message.author) === null || _u === void 0 ? void 0 : _u.userName) === undefined
                 ? {}
                 : { userName: message.author.userName })), (message.teamId === undefined ? {} : { teamId: message.teamId }))),
             ...(threadContext === undefined ? [] : [threadContext]),
-            ...((_9 = decision.context) !== null && _9 !== void 0 ? _9 : []),
+            ...((_11 = decision.context) !== null && _11 !== void 0 ? _11 : []),
             "",
             media.userText,
         ]
@@ -374,34 +451,36 @@ export function dispatchInboundMessage(args) {
         const hostedFollowup = hosted &&
             hasPlaceholder &&
             (message.ts !== message.threadTs || continuationExists);
-        const placeholder = hasPlaceholder && (!hosted || hostedFollowup)
+        // Adopted slots already exist in Slack; skip a second post. Cold hosted
+        // without a handoff still defers to `turn.started`.
+        const placeholder = !adoptedPlaceholder && hasPlaceholder && (!hosted || hostedFollowup)
             ? startPlaceholder({
                 line: placeholderLine,
-                botToken: (_t = args.credentials) === null || _t === void 0 ? void 0 : _t.botToken,
+                botToken: (_v = args.credentials) === null || _v === void 0 ? void 0 : _v.botToken,
                 channelId: message.channelId,
                 threadTs: message.threadTs,
                 log,
-                recipientUserId: (_u = message.author) === null || _u === void 0 ? void 0 : _u.userId,
+                recipientUserId: (_w = message.author) === null || _w === void 0 ? void 0 : _w.userId,
                 recipientTeamId: message.teamId,
             })
             : undefined;
-        const posted = placeholder !== undefined;
+        const posted = adoptedPlaceholder || placeholder !== undefined;
         const state = emptySlackChannelState({
             channelId: message.channelId,
             threadTs: message.threadTs,
-            teamId: (_10 = message.teamId) !== null && _10 !== void 0 ? _10 : null,
-            triggeringUserId: (_11 = (_v = message.author) === null || _v === void 0 ? void 0 : _v.userId) !== null && _11 !== void 0 ? _11 : null,
+            teamId: (_12 = message.teamId) !== null && _12 !== void 0 ? _12 : null,
+            triggeringUserId: (_13 = (_x = message.author) === null || _x === void 0 ? void 0 : _x.userId) !== null && _13 !== void 0 ? _13 : null,
             startPainted: paintedStart,
             placeholderPosted: posted,
         });
         const sendOptions = Object.assign(Object.assign({ auth: decision.auth }, sendPatch), { admission: "coalesce", coalesceSourceTs: message.ts, state: state, refreshState: slackWakeChannelState({
                 channelId: message.channelId,
                 threadTs: message.threadTs,
-                teamId: (_12 = message.teamId) !== null && _12 !== void 0 ? _12 : null,
-                triggeringUserId: (_13 = (_w = message.author) === null || _w === void 0 ? void 0 : _w.userId) !== null && _13 !== void 0 ? _13 : null,
+                teamId: (_14 = message.teamId) !== null && _14 !== void 0 ? _14 : null,
+                triggeringUserId: (_15 = (_y = message.author) === null || _y === void 0 ? void 0 : _y.userId) !== null && _15 !== void 0 ? _15 : null,
                 startPainted: paintedStart,
                 placeholderPosted: posted,
-            }), title: (_14 = decision.title) !== null && _14 !== void 0 ? _14 : `slack:${message.channelId}:${message.threadTs}`, workspaceDir: decision.workspaceDir, workspaceFiles: media.workspaceFiles, images: media.images, cloud: decision.cloud, sdkAgentId: decision.sdkAgentId });
+            }), title: (_16 = decision.title) !== null && _16 !== void 0 ? _16 : `slack:${message.channelId}:${message.threadTs}`, workspaceDir: decision.workspaceDir, workspaceFiles: media.workspaceFiles, images: media.images, cloud: decision.cloud, sdkAgentId: decision.sdkAgentId });
         try {
             const session = yield args.send(prompt, sendOptions);
             if (isDeferredChannelSession(session)) {
@@ -438,11 +517,11 @@ export function dispatchInboundMessage(args) {
                 });
                 if (!steeringEnabled()) {
                     try {
-                        yield (_x = args.host.slackNudges) === null || _x === void 0 ? void 0 : _x.append({
+                        yield (_z = args.host.slackNudges) === null || _z === void 0 ? void 0 : _z.append({
                             continuationKey: continuation,
                             sourceTs: message.ts,
                             text: media.userText,
-                            author: (_y = message.author) === null || _y === void 0 ? void 0 : _y.userName,
+                            author: (_0 = message.author) === null || _0 === void 0 ? void 0 : _0.userName,
                         });
                     }
                     catch (nudgeError) {
@@ -472,17 +551,18 @@ export function dispatchInboundMessage(args) {
             }
         }
         catch (error) {
-            yield (_z = args.host.slackNudges) === null || _z === void 0 ? void 0 : _z.releaseAsk(message.channelId, message.ts);
+            yield (_1 = args.host.slackNudges) === null || _1 === void 0 ? void 0 : _1.releaseAsk(message.channelId, message.ts);
             if (placeholder !== undefined) {
                 yield placeholder.retract();
             }
+            yield retractAdoptedPlaceholder();
             if (painted !== undefined) {
                 yield painted;
                 yield retractTurnStart({
-                    botToken: (_0 = args.credentials) === null || _0 === void 0 ? void 0 : _0.botToken,
+                    botToken: (_2 = args.credentials) === null || _2 === void 0 ? void 0 : _2.botToken,
                     channelId: message.channelId,
                     threadTs: message.threadTs,
-                    ack: (_15 = args.ack) !== null && _15 !== void 0 ? _15 : "",
+                    ack: (_17 = args.ack) !== null && _17 !== void 0 ? _17 : "",
                     log,
                 });
             }
@@ -510,12 +590,27 @@ export function dispatchInboundFromEventBody(body, deps) {
     var _e, _f, _g, _h, _j;
     const log = (_e = deps.log) !== null && _e !== void 0 ? _e : defaultSlackLog;
     let eventId;
+    const retractUnscheduledHandoff = () => {
+        var _a, _b;
+        const placeholder = (_a = deps.platformHandoff) === null || _a === void 0 ? void 0 : _a.slackPlaceholder;
+        if (placeholder === undefined) {
+            return;
+        }
+        deps.waitUntil(retractPlaceholderMessage({
+            botToken: (_b = deps.credentials) === null || _b === void 0 ? void 0 : _b.botToken,
+            channelId: placeholder.channelId,
+            ts: placeholder.messageTs,
+            streamed: placeholder.streamed,
+            log,
+        }));
+    };
     if (body !== null && typeof body === "object" && !Array.isArray(body)) {
         const root = body;
         if (typeof root.event_id === "string" && root.event_id.length > 0) {
             eventId = root.event_id;
             if (!deps.eventIds.tryHandle(root.event_id)) {
                 log.debug("inbound dedupe drop", { event_id: eventId });
+                retractUnscheduledHandoff();
                 return false;
             }
         }
@@ -526,6 +621,7 @@ export function dispatchInboundFromEventBody(body, deps) {
     if (mention !== null) {
         if (deps.mentionsEnabled === false) {
             log.debug("inbound ignored (mentions disabled)", { event_id: eventId });
+            retractUnscheduledHandoff();
             return false;
         }
         if (((_a = mention.author) === null || _a === void 0 ? void 0 : _a.isBot) === true) {
@@ -543,6 +639,7 @@ export function dispatchInboundFromEventBody(body, deps) {
                     from_bot: (_g = mention.author.botId) !== null && _g !== void 0 ? _g : mention.author.userId,
                     reason: verdict.reason,
                 });
+                retractUnscheduledHandoff();
                 return false;
             }
         }
@@ -552,6 +649,7 @@ export function dispatchInboundFromEventBody(body, deps) {
             handler: deps.onAppMention,
             evalCommandsEnabled: deps.evalCommandsEnabled,
             eventId,
+            platformHandoff: deps.platformHandoff,
         });
         return true;
     }
@@ -561,6 +659,7 @@ export function dispatchInboundFromEventBody(body, deps) {
             log.debug("inbound ignored (direct messages disabled)", {
                 event_id: eventId,
             });
+            retractUnscheduledHandoff();
             return false;
         }
         scheduleInbound(deps, log, {
@@ -569,11 +668,13 @@ export function dispatchInboundFromEventBody(body, deps) {
             handler: deps.onDirectMessage,
             evalCommandsEnabled: deps.evalCommandsEnabled,
             eventId,
+            platformHandoff: deps.platformHandoff,
         });
         return true;
     }
     const reaction = parseReactionAddedEvent(body);
     if (reaction !== null && deps.onReactionAdded !== undefined) {
+        retractUnscheduledHandoff();
         scheduleInbound(deps, log, {
             kind: "reaction_added",
             message: reaction,
@@ -631,9 +732,11 @@ export function dispatchInboundFromEventBody(body, deps) {
             includeBotAuthored: true,
         });
         if (channelEvent !== null) {
+            retractUnscheduledHandoff();
             return deps.channelWatch.handle(channelEvent, eventId);
         }
     }
     log.debug("inbound ignored (unhandled event shape)", Object.assign(Object.assign({}, describeSlackEventShape(body)), { event_id: eventId }));
+    retractUnscheduledHandoff();
     return false;
 }

package/dist/channels/slack/placeholder.d.ts

@@ -9,6 +9,13 @@
 import { type SlackLog } from "./log.js";
 import type { SlackBotToken } from "./types.js";
 export declare function resetPlaceholderSlots(): void;
+/** Retract only one thread's slot; admission cleanup must not sweep DM peers. */
+export declare function retractPlaceholderSlot(args: {
+    channelId: string;
+    threadTs: string;
+    botToken: SlackBotToken | undefined;
+    log?: SlackLog;
+}): Promise<void>;
 export declare function finishPlaceholder(args: {
     channelId: string;
     threadTs: string;
@@ -27,6 +34,25 @@ export declare function startPlaceholder(args: {
     done: Promise<void>;
     retract: () => Promise<void>;
 } | undefined;
+/**
+ * Seed the in-process placeholder slot with a control-plane-posted message
+ * ts so the first agentic update overlays that exact Slack message.
+ */
+export type PlaceholderAdoption = "adopted" | "already_adopted" | "occupied";
+export declare function adoptPlaceholder(args: {
+    channelId: string;
+    threadTs: string;
+    ts: string;
+    streamed?: boolean;
+}): PlaceholderAdoption;
+/** Delete a control-plane placeholder that this process could not adopt. */
+export declare function retractPlaceholderMessage(args: {
+    botToken: SlackBotToken | undefined;
+    channelId: string;
+    ts: string;
+    streamed: boolean;
+    log?: SlackLog;
+}): Promise<void>;
 export declare function overlayPlaceholder(args: {
     channelId: string;
     threadTs: string;

package/dist/channels/slack/placeholder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"placeholder.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/placeholder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAyChD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AA+DD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAAG,SAAS,CAUpE;AAkFD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO9B"}
+{"version":3,"file":"placeholder.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/placeholder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAyChD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AA+DD,iFAAiF;AACjF,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAAG,SAAS,CAUpE;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,iBAAiB,GAAG,UAAU,CAAC;AAE7E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,mBAAmB,CAiBtB;AAED,4EAA4E;AAC5E,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhB;AAkFD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO9B"}

package/dist/channels/slack/placeholder.js

@@ -86,6 +86,12 @@ function retractKey(key, args) {
         });
     });
 }
+/** Retract only one thread's slot; admission cleanup must not sweep DM peers. */
+export function retractPlaceholderSlot(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield retractKey(slotKey(args.channelId, args.threadTs), args);
+    });
+}
 export function finishPlaceholder(args) {
     return __awaiter(this, void 0, void 0, function* () {
         const first = slotKey(args.channelId, args.threadTs);
@@ -107,6 +113,28 @@ export function startPlaceholder(args) {
         retract: () => retractKey(key, Object.assign(Object.assign({}, args), { log })),
     };
 }
+export function adoptPlaceholder(args) {
+    const key = slotKey(args.channelId, args.threadTs);
+    const existing = slots.get(key);
+    if (existing !== undefined &&
+        !existing.claimed &&
+        existing.ts === args.ts &&
+        existing.streamed === (args.streamed === true)) {
+        return "already_adopted";
+    }
+    if (!openPlaceholder(key)) {
+        return "occupied";
+    }
+    return rememberPlaceholder(key, args.ts, args.streamed === true)
+        ? "adopted"
+        : "occupied";
+}
+/** Delete a control-plane placeholder that this process could not adopt. */
+export function retractPlaceholderMessage(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield retractPosted(args);
+    });
+}
 function postPlaceholder(args) {
     return __awaiter(this, void 0, void 0, function* () {
         try {

package/dist/channels/slack/slack-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slack-channel.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/slack-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH,OAAO,KAAK,EAEV,iBAAiB,EAMlB,MAAM,gBAAgB,CAAC;AA+CxB,OAAO,KAAK,EAEV,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAQpB;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,GACjB,mBAAmB,GAAG,SAAS,CAEjC;AAED,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,aAAa,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GAC9C,uBAAuB,GAAG,SAAS,CAYrC;AAaD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,GAAE,mBAAwB,GACjC,iBAAiB,CAAC,iBAAiB,CAAC,CA6gBtC"}
+{"version":3,"file":"slack-channel.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/slack-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH,OAAO,KAAK,EAEV,iBAAiB,EAMlB,MAAM,gBAAgB,CAAC;AA+CxB,OAAO,KAAK,EAEV,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAQpB;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,GACjB,mBAAmB,GAAG,SAAS,CAEjC;AAED,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,aAAa,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GAC9C,uBAAuB,GAAG,SAAS,CAYrC;AAaD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,GAAE,mBAAwB,GACjC,iBAAiB,CAAC,iBAAiB,CAAC,CAohBtC"}

package/dist/channels/slack/slack-channel.js

@@ -163,11 +163,13 @@ export function slackChannel(authored = {}) {
     let botMentionGate;
     function inboundDeps(args) {
         var _a;
-        return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ send: args.send, continuation: options.continuation, waitUntil: args.waitUntil, onAppMention,
+        return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ send: args.send, continuation: options.continuation, waitUntil: args.waitUntil, onAppMention,
             onDirectMessage }, (onReactionAdded === undefined ? {} : { onReactionAdded })), { credentials, eventIds: (_a = args.eventIds) !== null && _a !== void 0 ? _a : eventIds, propagateHandlerErrors: args.propagateHandlerErrors, host: args.host, artifacts: args.artifacts, log: getLog(), mentionsEnabled,
             directMessagesEnabled,
             evalCommandsEnabled,
-            followUpStatus, ack: reply.ack, placeholder: reply.placeholder, blockExternals }), (args.hasContinuationSession === undefined
+            followUpStatus, ack: reply.ack, placeholder: reply.placeholder, blockExternals }), (args.platformHandoff === undefined
+            ? {}
+            : { platformHandoff: args.platformHandoff })), (args.hasContinuationSession === undefined
             ? {}
             : { hasContinuationSession: args.hasContinuationSession })), (args.isContinuationBusy === undefined
             ? {}
@@ -190,7 +192,9 @@ export function slackChannel(authored = {}) {
             ? {
                 slackReply: Object.assign({ mode: "agentic", ack: (_g = reply.ack) !== null && _g !== void 0 ? _g : DEFAULT_ACK }, (reply.placeholder === undefined
                     ? {}
-                    : { placeholder: reply.placeholder })),
+                    : {
+                        placeholder: reply.placeholder,
+                    })),
             }
             : {})), (channelPosts === undefined
             ? {}
@@ -449,19 +453,8 @@ export function slackChannel(authored = {}) {
         // claim already dedupes Slack retries, and on a warm pod the local set
         // would otherwise swallow the control plane's own retry of a delivery
         // that failed after the id was marked handled.
-        dispatch: (_a) => __awaiter(this, [_a], void 0, function* ({ payload, args }) {
-            const dispatched = dispatchInboundFromEventBody(payload, inboundDeps({
-                send: args.send,
-                waitUntil: args.waitUntil,
-                host: args.host,
-                artifacts: args.artifacts,
-                eventIds: createEventIdDedupe(),
-                propagateHandlerErrors: true,
-                hasContinuationSession: args.hasContinuationSession,
-                isContinuationBusy: args.isContinuationBusy,
-                getContinuationLastBotMessageTs: args.getContinuationLastBotMessageTs,
-                interruptContinuation: args.interruptContinuation,
-            }));
+        dispatch: (_a) => __awaiter(this, [_a], void 0, function* ({ payload, args, platformHandoff }) {
+            const dispatched = dispatchInboundFromEventBody(payload, inboundDeps(Object.assign({ send: args.send, waitUntil: args.waitUntil, host: args.host, artifacts: args.artifacts, eventIds: createEventIdDedupe(), propagateHandlerErrors: true, hasContinuationSession: args.hasContinuationSession, isContinuationBusy: args.isContinuationBusy, getContinuationLastBotMessageTs: args.getContinuationLastBotMessageTs, interruptContinuation: args.interruptContinuation }, (platformHandoff === undefined ? {} : { platformHandoff }))));
             return skipped(dispatched ? "not_engaged" : "not_dispatchable");
         }),
     });