@open-everywhere/provider-slack 0.1.0

package/dist/agent/channels/slack-wake-backscroll.js

@@ -0,0 +1,473 @@
+// Wake-time conversation backscroll.
+//
+// The MENTION path enriches a turn with surrounding conversation (slack-context.ts, via Eve's
+// `SlackContext` handle). The WAKE path — a name-drop that pulls the bot into a conversation it
+// was never mentioned in (slack-events.ts routeNameDropEvent) — used to hand the model ONLY the
+// triggering message, so:
+//   (a) a cold name-drop mid-thread arrived with no idea what's being discussed, and
+//   (b) a re-wake after auto-disengage resumed the SAME thread session, which has a GAP for
+//       everything said while the bot was disengaged.
+// This module closes both by fetching recent history at wake time and attaching it as the same
+// `context` strings the mention path uses.
+//
+// WHY A STANDALONE CALLER (not Eve's `ctx`): a wake fires from a raw HTTP route, not a live
+// session, so there's no `SlackContext`/`ctx.slack` to borrow. We call the Web API through OE's
+// `callSlackWebApi` seam (channels/slack-web-api.ts) with the bot token — the same seam every other
+// Slack Web API call uses, so this path inherits the 429 backoff. The message→line mapping,
+// the render, and the UNTRUSTED wrapping are REUSED from slack-context.ts (linesFromMessages /
+// renderContext / ContextLine), so wake context is attributed + fenced byte-identically to the
+// mention path — the untrusted framing is a security invariant (channel content is DATA, never
+// instructions), not decoration, so it must never diverge between the two paths.
+//
+// BOOTSTRAP BACKSCROLL is fail-soft: any error yields no context and never blocks the first wake.
+// SEAT CATCH-UP propagates the same read failure to core's shared fail-soft boundary, so the wake
+// still continues but its `seat.catch_up` row says `failed` rather than `empty` (OPE-1842).
+import { callSlackWebApi } from "./slack-web-api.js";
+import { RateLimitExhaustedError } from "@open-everywhere/core/agent/adapter-api.js";
+import { linesFromMessages, readMoreHint } from "./slack-context.js";
+import { renderContext, sinceLastAgentReply, WAKE_BACKSCROLL_MAX, fetchedBackscroll, catchUpSender, } from "@open-everywhere/core/agent/adapter-api.js";
+// Re-export the shared cap so this module's public surface (and its test, which imports it from
+// here) is unchanged after the extraction into context-render.ts (now reached via the barrel).
+export { WAKE_BACKSCROLL_MAX };
+/**
+ * The widest THREAD slice this module hands a caller that ADMITS BEFORE IT CAPS (OPE-1744,
+ * {@link WakeBackscrollInput.threadAdmissionSlice}). Five times {@link WAKE_BACKSCROLL_MAX}, so the
+ * policy can look past a long run of refused replies and still fill the ten-line slot; half the page
+ * the thread fetch buys, so the slice stays bounded.
+ * 🔴 IT IS A COST BOUND, AND THE COST IS THE CALLER'S PER-AUTHOR PROBE. Slack's hydration regrades
+ * every returned line before it admits, and that regrade runs one TTL-cached `users.info` per
+ * DISTINCT vouchable author. Handing back the whole 100-reply page would put that fan-out on a busy
+ * thread; the probe fails OPEN, so an exhausted burst demotes nobody and a guest keeps the tier a
+ * confirmed-internal channel gives. The slice is bounded here to keep that burst small.
+ */
+export const THREAD_ADMISSION_MAX = WAKE_BACKSCROLL_MAX * 5;
+// --- live (bot-token) implementations ---------------------------------------
+// Bot-token POST to the Slack Web API via OE's `callSlackWebApi` (channels/slack-web-api.ts), which
+// a wake path can't reach through `ctx` because it fires from a raw HTTP route with no live session.
+// Form-encodes `params` and resolves the token from `SLACK_BOT_TOKEN`. Fail-soft: a missing token
+// makes the seam throw, and any throw → undefined (backscroll never blocks a wake).
+const liveRequest = async (method, params) => {
+    try {
+        return (await callSlackWebApi({ botToken: undefined, operation: method, body: params }));
+    }
+    catch (err) {
+        // 🔴 LOG A RATE-LIMIT EXHAUSTION BEFORE SWALLOWING IT (OPE-1211). Fail-soft is right here — a
+        // backscroll must never block a wake — but an exhausted 429 retry with no trace is the silent
+        // drop the ticket exists to prevent. Every field is token-free.
+        if (err instanceof RateLimitExhaustedError) {
+            console.warn(`[open-everywhere:slack] rate limited: backscroll ${method} gave up after ${err.attempts} attempts (waited ${err.waitedMs} ms)`);
+        }
+        return undefined;
+    }
+};
+// The bot's (user_id, bot_id) via auth.test, resolved once (cached). Same shape as
+// slack-front.ts's resolveBotIdentity; a local copy avoids the import cycle noted above. Used
+// only to attribute the agent's own posts in the backscroll — best-effort, never a hard gate.
+let wakeBotIdentityPromise;
+function liveWakeBotIdentity() {
+    if (!wakeBotIdentityPromise) {
+        wakeBotIdentityPromise = (async () => {
+            const res = await liveRequest("auth.test", {});
+            if (res?.ok === true) {
+                return {
+                    userId: typeof res.user_id === "string" ? res.user_id : undefined,
+                    botId: typeof res.bot_id === "string" ? res.bot_id : undefined,
+                };
+            }
+            return {};
+        })();
+    }
+    return wakeBotIdentityPromise;
+}
+/** Reset the cached wake bot identity (tests only). */
+export function _resetWakeBotIdentity() {
+    wakeBotIdentityPromise = undefined;
+}
+const liveDeps = { request: liveRequest, identity: liveWakeBotIdentity };
+/**
+ * Fetch recent conversation history for a name-drop wake as RAW ContextLines + source + hint (W3) —
+ * the renderer wraps them (renderContext, inside renderWake). `null` = nothing to add OR any
+ * failure (always non-fatal).
+ *
+ * - IN-THREAD wake (`threadTs`): `conversations.replies`, sliced to "since the agent's last reply"
+ *   (see {@link sinceLastAgentReply}); the triggering message itself is excluded (the wake message
+ *   already carries its text). Capped at {@link WAKE_BACKSCROLL_MAX}, or at the wider
+ *   {@link THREAD_ADMISSION_MAX} when the caller asks for the admission slice
+ *   ({@link WakeBackscrollInput.threadAdmissionSlice}).
+ * - TOP-LEVEL wake (no `threadTs`): `conversations.history` with `latest = ts`, `inclusive: false`
+ *   → strictly-older messages only, most recent N.
+ */
+export async function fetchWakeBackscrollLines(input, deps = liveDeps) {
+    try {
+        const ids = await deps.identity().catch(() => ({}));
+        if (input.threadTs) {
+            const res = await deps.request("conversations.replies", {
+                channel: input.channelId,
+                ts: input.threadTs,
+                // A single (oldest-anchored) page — no cursor paging. Comfortably covers any realistic
+                // thread; a pathologically long one degrades to "older context only", still fail-soft.
+                limit: "100",
+            });
+            const raw = extractMessages(res);
+            if (!raw)
+                return null;
+            // Drop the trigger itself (its text rides on the wake message, not the backscroll).
+            const priorRaw = raw.filter((m) => (typeof m.ts === "string" ? m.ts : "") !== input.ts);
+            // conversations.replies is oldest-first already — no reverse.
+            const lines = sinceLastAgentReply(linesFromMessages(priorRaw, ids));
+            const source = `slack thread ${input.channelId}/${input.threadTs}`;
+            // The wider ADMISSION slice when the caller admits before it caps (OPE-1744), the render-cap
+            // slice otherwise — see {@link WakeBackscrollInput.threadAdmissionSlice}.
+            return input.threadAdmissionSlice ? backscrollEntry(lines.slice(-THREAD_ADMISSION_MAX), source) : cappedEntry(lines, source);
+        }
+        // Top-level: strictly-older backscroll of the channel (mirrors slack-context's channel path).
+        const res = await deps.request("conversations.history", {
+            channel: input.channelId,
+            latest: input.ts,
+            inclusive: "false",
+            limit: String(WAKE_BACKSCROLL_MAX),
+        });
+        const raw = extractMessages(res);
+        if (!raw)
+            return null;
+        const lines = linesFromMessages(raw, ids);
+        lines.reverse(); // conversations.history is newest-first → oldest-first for rendering
+        return cappedEntry(lines, `slack channel ${input.channelId}`);
+    }
+    catch {
+        return null; // fail-soft: a wake never depends on its backscroll
+    }
+}
+/**
+ * Fetch recent conversation history for a name-drop wake, rendered as `context` strings
+ * (untrusted-wrapped, oldest-first, capped at {@link WAKE_BACKSCROLL_MAX}). Empty array = nothing to
+ * add OR any failure. Thin wrapper over {@link fetchWakeBackscrollLines} + the shared renderContext,
+ * so its output stays byte-identical to before the W3 refactor (retained for its existing callers
+ * and byte-identity tests; the live name-drop path now uses the lines variant directly).
+ */
+export async function fetchWakeBackscroll(input, deps = liveDeps) {
+    const res = await fetchWakeBackscrollLines(input, deps);
+    if (!res)
+        return [];
+    const entry = renderContext(res.lines, res.source, { readMoreHint: res.readMoreHint });
+    return entry ? [entry] : [];
+}
+// Pull the `messages` array out of an ok response, or undefined (fail-soft on junk / not-ok).
+function extractMessages(res) {
+    if (!res || res.ok !== true || !Array.isArray(res.messages))
+        return undefined;
+    return res.messages;
+}
+// Return the RAW lines + source + hint — the renderer (renderContext, inside renderWake) does the
+// untrusted-wrap, so wrapping happens in exactly ONE place (W3). `lines` must be oldest-first.
+// Returns null when there's nothing to keep, so the caller renders no context block.
+// The hint is handed over unconditionally: `renderContext` appends it only when the RENDERED slice
+// fills MAX_MESSAGES, so it always describes what the model was shown, never what was fetched.
+function backscrollEntry(lines, source) {
+    if (lines.length === 0)
+        return null;
+    return { lines, source, readMoreHint: readMoreHint() };
+}
+// {@link backscrollEntry} with the WAKE_BACKSCROLL_MAX cap applied first (keep the most recent).
+function cappedEntry(lines, source) {
+    return backscrollEntry(lines.slice(-WAKE_BACKSCROLL_MAX), source);
+}
+// --- envelope-shaped first-wake backscroll (supervisor context hydration) — SLACK ADAPTER ----
+//
+// The channel-supervisor's FIRST wake on a generation (a brand-new session OR the fresh generation
+// minted by a rotation, slack-events.ts shouldRotate/routeSupervisorEvent) carries channel
+// backscroll rendered as the wake ENVELOPE's own non-trigger `<message>` siblings, grouped into
+// `<session>` blocks (wake-envelope.ts renderWakeEnvelope) — Claude Tag's observed first-wake shape
+// is individual attributed messages, oldest-first, ending at the trigger (claude-tag-behaviour.md
+// §4.1), and OE's is richer: idle-gap-clustered pseudo-sessions with count/time/token bounds
+//.
+//
+// THIS FILE IS THE SLACK FETCH ADAPTER behind the platform-NEUTRAL clustering/bounds core
+// (backscroll-window.ts). Its job: turn conversations.history (+ conversations.replies for thread
+// enrichment) into a visibility-GATED {@link NormalizedMessage}[] window, then hand it to
+// {@link fetchedBackscroll}. Discord/Teams later add their OWN fetch adapter with zero change to the
+// core. FAIL-SOFT ABSOLUTELY throughout, exactly like {@link fetchWakeBackscroll}.
+// --- fetch bounds (Slack-specific; the clustering/token bounds live in backscroll-window.ts) ---
+/** Reachback (hours) for the raw Slack window: how far back from the trigger conversations.history
+ *  is paginated. Generous enough that the SPINE (the most-recent cluster, exempt from the 36h
+ *  enrichment cap) can still reach across a weekend/overnight gap (~66h Fri-4pm→Mon-10am), yet a
+ *  hard floor that bounds the fetch. 7d default; overridable for ops/testing. */
+export const RAW_FETCH_REACHBACK_HOURS = Number(process.env.OE_SUPERVISOR_BACKSCROLL_REACHBACK_HOURS) || 168;
+/** conversations.history page size (Slack max is 1000; 200 keeps each page cheap). */
+const RAW_FETCH_PAGE_LIMIT = 200;
+/** Max history pages to paginate — bounds a busy channel's fetch at ≤600 messages so a burst can't
+ *  fan out into an unbounded loop. Combined with the reachback floor (whichever binds first). */
+const RAW_FETCH_MAX_PAGES = 3;
+/** Max in-window thread ROOTS to enrich via conversations.replies — bounds the reply fan-out so a
+ *  channel full of threads can't explode into unbounded API calls. */
+const MAX_THREADS_ENRICHED = 8;
+/** Single-page reply fetch per thread (mirrors the name-drop thread leg's own 100). */
+const THREAD_REPLIES_LIMIT = 100;
+/**
+ * The VISIBILITY / TRUST GATE (spec §Bounds — the load-bearing SECURITY filter): backscroll must
+ * never surface a message it can't ATTRIBUTE. The channel-internal confirmation
+ * (confirmChannelInternalWithMeta) fail-closes the restricted-area / at-rest-isolation dimension
+ * BEFORE this fetcher is ever called. So the per-message gate here KEEPS:
+ *   - the bot's OWN prior posts (`agent` → `self`);
+ *   - identifiable humans (`user` → `human`);
+ *   - ATTRIBUTABLE foreign bots (`bot` WITH a bot id → `bot`) — INCLUDED as MARKED AWARENESS
+ *     (clearly bot-flagged, CONTEXT-ONLY, never a wake trigger). Design intent: the supervisor
+ *     SHOULD see foreign-bot posts, and dropping them breaks CONVERSATIONAL COHERENCE — a human
+ *     replying to a bot's message would otherwise arrive with the bot message missing, so the agent
+ *     couldn't tell what the human is responding to.
+ * and DROPS ONLY:
+ *   - unattributable senders (`unknown`, or a `bot` with no id) — no auth'd author ⇒ fail closed.
+ * (System-subtype noise is already dropped upstream by linesFromMessages.) Foreign-bot messages are
+ * CONTEXT-ONLY on this path: the neutral core never sets `trigger` on backscroll, and the LIVE
+ * trigger gate (slack-events.ts shouldSupervisorWake) still drops bot-authored messages as triggers,
+ * so a bot post is awareness, never a response obligation. Wired explicitly + unit-tested
+ * (slack-wake-backscroll-test.ts) so it can't be forgotten.
+ */
+export function isBackscrollVisible(line) {
+    return (line.senderType === "agent" ||
+        line.senderType === "user" ||
+        (line.senderType === "bot" && line.senderId !== undefined) // attributable foreign bot: marked awareness
+    );
+}
+// Pull the pagination cursor from a conversations.history response, or undefined when there's no
+// next page (fail-soft on junk).
+function extractCursor(res) {
+    const meta = res?.response_metadata;
+    const cursor = meta?.next_cursor;
+    return typeof cursor === "string" && cursor.length > 0 ? cursor : undefined;
+}
+// Paginate conversations.history backward from `latest` (exclusive) down to `oldest`, bounded by
+// RAW_FETCH_MAX_PAGES. Returns the raw messages (newest-first across pages — the neutral core sorts
+// by ts anyway). Fail-soft: a not-ok/absent page ends pagination with whatever's in hand.
+async function fetchChannelWindow(request, channelId, latest, oldest) {
+    const all = [];
+    let cursor;
+    for (let page = 0; page < RAW_FETCH_MAX_PAGES; page++) {
+        const res = await request("conversations.history", {
+            channel: channelId,
+            latest,
+            inclusive: "false",
+            oldest,
+            limit: String(RAW_FETCH_PAGE_LIMIT),
+            ...(cursor ? { cursor } : {}),
+        });
+        const msgs = extractMessages(res);
+        if (!msgs)
+            break;
+        all.push(...msgs);
+        cursor = extractCursor(res);
+        if (!cursor)
+            break; // no more pages
+    }
+    return all;
+}
+// Enrich with thread replies for in-window thread ROOTS (conversations.history returns roots +
+// top-level messages, not the replies inside a thread). BOUNDED: only roots that actually have
+// replies, capped at MAX_THREADS_ENRICHED, one page each. Returns [{ root, msgs }]; fail-soft per
+// thread (a failed reply fetch just omits that thread's replies).
+async function fetchThreadReplies(request, channelId, channelMsgs) {
+    const roots = [];
+    for (const m of channelMsgs) {
+        if (roots.length >= MAX_THREADS_ENRICHED)
+            break;
+        const ts = typeof m.ts === "string" ? m.ts : undefined;
+        const threadTs = typeof m.thread_ts === "string" ? m.thread_ts : undefined;
+        const replyCount = typeof m.reply_count === "number" ? m.reply_count : 0;
+        // A thread root: it IS its own thread anchor (no thread_ts, or thread_ts === ts) and has replies.
+        if (ts && replyCount > 0 && (!threadTs || threadTs === ts))
+            roots.push(ts);
+    }
+    const out = [];
+    for (const root of roots) {
+        const res = await request("conversations.replies", { channel: channelId, ts: root, limit: String(THREAD_REPLIES_LIMIT) });
+        const msgs = extractMessages(res);
+        if (msgs)
+            out.push({ root, msgs });
+    }
+    return out;
+}
+// Read one KNOWN thread without first discovering its root through channel history. A standing
+// seat's catch-up window commonly starts after the thread root, so root discovery would answer an
+// empty channel page even when the thread has new replies inside the window (OPE-1920).
+async function fetchKnownThreadReplies(request, channelId, threadRoot, oldest, latest) {
+    const res = await request("conversations.replies", {
+        channel: channelId,
+        ts: threadRoot,
+        oldest,
+        latest,
+        // Keep both endpoints at the transport seam. Core removes the trigger by exact id and enforces
+        // the same bounds again after normalization.
+        inclusive: "true",
+        limit: String(THREAD_REPLIES_LIMIT),
+    });
+    const msgs = extractMessages(res);
+    return msgs ? [{ root: threadRoot, msgs }] : [];
+}
+// Normalize ONE raw Slack message → {@link NormalizedMessage}, reusing linesFromMessages for the
+// exact sender classification + system/empty drop, then applying the VISIBILITY GATE. Returns
+// undefined for a dropped (invisible / subtype / empty / unparseable-ts) message.
+function normalizeOne(m, ids, type, threadId) {
+    const [line] = linesFromMessages([m], ids);
+    if (!line)
+        return undefined; // system subtype / empty text (dropped upstream)
+    if (!isBackscrollVisible(line))
+        return undefined; // VISIBILITY GATE (unattributable sender only)
+    const seconds = Number.parseFloat(line.ts);
+    if (!Number.isFinite(seconds))
+        return undefined;
+    return {
+        id: line.ts,
+        ms: seconds * 1000,
+        // undefined for the bot's OWN posts (agent); the foreign bot's id for a `bot`; the user id for
+        // a human — kept raw for @-tagging / attribution.
+        authorId: line.senderId,
+        // THE SHARED SENDER RULE (OPE-1857): agent → self (our own post); bot → bot (attributable
+        // foreign bot, marked awareness); every other visible line is a `user` → human. `unknown` was
+        // already dropped by the gate above.
+        sender: catchUpSender({ self: line.senderType === "agent", bot: line.senderType === "bot" }),
+        type,
+        threadId,
+        text: line.text,
+    };
+}
+/**
+ * SLACK FETCH SEAM: fetch a bounded, visibility-GATED, NORMALIZED backscroll window (channel history
+ * + in-window thread replies) for a supervisor first wake. This is the platform boundary — the
+ * neutral core ({@link fetchedBackscroll}) consumes its output. FAIL-SOFT: any error/failure yields
+ * `[]`. Deduped by message id (a thread root appears in both history and its replies[0]).
+ */
+export async function fetchSlackBackscrollWindow(input, deps = liveDeps, failureMode = "soft") {
+    try {
+        const ids = await deps.identity().catch(() => ({}));
+        const latestSeconds = Number.parseFloat(input.ts);
+        if (!Number.isFinite(latestSeconds))
+            return [];
+        const reachbackHours = input.reachbackHours ?? RAW_FETCH_REACHBACK_HOURS;
+        // The reachback floor, then the seat's own last wake where it is LATER — never earlier, so the
+        // catch-up can only narrow the fetch (see {@link WakeEnvelopeBackscrollInput.sinceMs}).
+        const floorSeconds = latestSeconds - reachbackHours * 3600;
+        const sinceSeconds = typeof input.sinceMs === "number" && Number.isFinite(input.sinceMs) ? input.sinceMs / 1000 : undefined;
+        const oldestSeconds = sinceSeconds !== undefined ? Math.max(floorSeconds, sinceSeconds) : floorSeconds;
+        const oldest = String(oldestSeconds);
+        // A thread-bound catch-up already knows its root. Read it directly: the root can predate the
+        // lower bound, which makes it undiscoverable through the bounded channel-history page even
+        // though newer replies belong in this wake. Bootstrap/container reads still take the original
+        // channel-history + bounded enrichment path.
+        const channelMsgs = input.threadRoot === undefined ? await fetchChannelWindow(deps.request, input.channelId, input.ts, oldest) : [];
+        const threadGroups = input.threadRoot === undefined
+            ? await fetchThreadReplies(deps.request, input.channelId, channelMsgs)
+            : await fetchKnownThreadReplies(deps.request, input.channelId, input.threadRoot, oldest, input.ts);
+        if (channelMsgs.length === 0 && threadGroups.length === 0)
+            return [];
+        const seen = new Set();
+        const out = [];
+        const add = (n) => {
+            if (n && !seen.has(n.id)) {
+                seen.add(n.id);
+                out.push(n);
+            }
+        };
+        for (const m of channelMsgs)
+            add(normalizeOne(m, ids, "channel", undefined));
+        for (const g of threadGroups) {
+            for (const m of g.msgs) {
+                const ts = typeof m.ts === "string" ? m.ts : "";
+                // The root is already a channel message — and so is the TRIGGER when it is a reply inside a
+                // thread whose root is in the window: `conversations.replies` returns it, and the wake
+                // renderer would then show the seat the message that woke it twice, once as context and once
+                // as the live trigger. The channel fetch excludes the trigger with `inclusive: "false"`; this
+                // is the same exclusion on the enrichment leg (the precedent is `linesFromMessages`' own
+                // "drop the trigger itself").
+                // A discovered root is already present in `channelMsgs`; a directly-read root is not, so
+                // let the ordinary lower/upper bounds decide whether it belongs. The trigger always leaves
+                // exactly by id.
+                if ((input.threadRoot === undefined && ts === g.root) || ts === input.ts)
+                    continue;
+                const secs = Number.parseFloat(ts);
+                if (Number.isFinite(secs) && secs < oldestSeconds)
+                    continue; // reply older than the window
+                if (input.threadRoot !== undefined && Number.isFinite(secs) && secs > latestSeconds)
+                    continue; // reply after the trigger
+                add(normalizeOne(m, ids, "thread", g.root));
+            }
+        }
+        return out;
+    }
+    catch (err) {
+        if (failureMode === "throw")
+            throw err;
+        return []; // fail-soft: a first wake never depends on its backscroll
+    }
+}
+/**
+ * SLACK'S REGISTERED CATCH-UP FETCH (OPE-1726) — the one thing this surface contributes to the shared
+ * since-last-wake path (core channels/seat-catch-up.ts). It is the SAME window fetch the bootstrap
+ * arm takes ({@link fetchSlackBackscrollWindow}), addressed by the neutral request shape: the seat's
+ * container, bounded below by its last wake and above by the trigger.
+ * 🔴 THE UPPER BOUND IS RE-EXPRESSED AS A SLACK `ts`, because `conversations.history` takes `latest`
+ * in Slack's own seconds-with-fraction form and not epoch ms. `excludeId` IS that ts on this surface
+ * (a Slack ts is both a time and an id), so it is preferred over the derived string — a derived one
+ * can lose the trailing digits Slack's ordering depends on. With neither, the read falls back to
+ * `now`, which is the honest upper bound for a catch-up with no stated trigger.
+ * A transport/read failure propagates to core's shared boundary, which keeps the wake alive and
+ * records `failed` instead of reporting a quiet channel (OPE-1842). Bootstrap callers keep the
+ * window fetch's default fail-soft mode.
+ */
+export async function fetchSlackSeatCatchUp(req, deps = liveDeps) {
+    const latestTs = req.excludeId ?? (req.untilMs !== undefined ? String(req.untilMs / 1000) : String(Date.now() / 1000));
+    const strictDeps = {
+        ...deps,
+        request: async (method, params) => {
+            const res = await deps.request(method, params);
+            if (!res || res.ok !== true || !Array.isArray(res.messages)) {
+                throw new Error(`Slack catch-up ${method} failed`);
+            }
+            return res;
+        },
+    };
+    return fetchSlackBackscrollWindow({ channelId: req.container, ts: latestTs, sinceMs: req.sinceMs, ...(req.threadRoot ? { threadRoot: req.threadRoot } : {}) }, strictDeps, "throw");
+}
+/**
+ * A Slack `ts` is a second with a six-digit fraction, so it carries MILLISECOND grain (OPE-1847,
+ * `core/agent/channels/seat-catch-up.ts` {@link SeatCatchUpDeclaration.timestampPrecisionMs}).
+ * 🔴 ONE MILLISECOND IS NOT ZERO WIDENING. The road widens the LOWER bound by nothing here and the
+ * UPPER bound by exactly one millisecond, so a message stamped at the trigger's own instant is
+ * INSIDE the window and `excludeId` is the only thing that removes the trigger. That holds on this
+ * surface twice over: `conversations.history` is called with `inclusive: "false"`, so the trigger
+ * never reaches the fetch, and a message that did would carry its `ts` as its id — the same value
+ * the wake path passes as `excludeId`.
+ * 🔴 THE DECLARATION CANNOT EXPRESS THIS SURFACE'S SUB-MILLISECOND `ts`. The unit is a whole number
+ * of milliseconds, so the road's floor rounds Slack's fraction away. It costs nothing today: the
+ * bound is a bound, not an ordering, and the fetch orders by `ts` itself.
+ * 🔴 IT IS STILL DECLARED, and the parity test requires it. The declaration is what makes "this
+ * surface needs the finest unit" a CHECKED claim rather than an omission, and an omission is
+ * indistinguishable from the GitHub and Notion defect this whole mechanism exists to close.
+ */
+export const SLACK_TIMESTAMP_PRECISION_MS = 1;
+/** The registered form — the transport seam is fixed to the live one, so a caller cannot inject past
+ *  the bot token. Tests drive {@link fetchSlackSeatCatchUp} with a canned requester instead. */
+export const slackSeatCatchUpFetch = (req) => fetchSlackSeatCatchUp(req);
+/**
+ * Fetch + cluster a standing seat's channel backscroll into session-tagged
+ * {@link WakeMessageInput} entries (oldest-first, no `trigger`; per-message trust via
+ * `trustFor` when the caller supplies the resolver, the fail-closed per-sender default otherwise).
+ * Thin orchestration over the Slack fetch seam ({@link fetchSlackBackscrollWindow}) + the neutral
+ * capped core ({@link fetchedBackscroll}), which applies the domain's `admit` policy. Serves the
+ * BOOTSTRAP window ONLY — a fresh generation's first wake, the one read with no cross-surface twin.
+ * Since OPE-1726 the since-last-wake CATCH-UP is not this function's job: it runs through
+ * {@link fetchSlackSeatCatchUp}, registered into the shared core path (core channels/seat-catch-up.ts
+ * `seatCatchUp`), which owns the bounds, the admission policy and the cap for every surface. This
+ * function still ACCEPTS `input.sinceMs`, but no caller sets it. FAIL-SOFT ABSOLUTELY.
+ */
+export async function fetchWakeEnvelopeBackscroll(input, deps = liveDeps, trustFor, admit) {
+    try {
+        const window = await fetchSlackBackscrollWindow(input, deps);
+        if (window.length === 0)
+            return [];
+        return fetchedBackscroll(window, undefined, trustFor, admit);
+    }
+    catch {
+        return []; // fail-soft: a wake never depends on its backscroll
+    }
+}
+//# sourceMappingURL=slack-wake-backscroll.js.map

package/dist/agent/channels/slack-wake-backscroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-wake-backscroll.js","sourceRoot":"","sources":["../../../agent/channels/slack-wake-backscroll.ts"],"names":[],"mappings":"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"}

package/dist/agent/channels/slack-web-api.d.ts

@@ -0,0 +1,46 @@
+import { type RateLimitRetryOptions } from "@open-everywhere/core/agent/adapter-api.js";
+/** The Slack Web API JSON envelope. `ok` signals Slack's own verdict; callers inspect it. */
+export interface SlackWebApiResponse {
+    readonly ok?: boolean;
+    readonly error?: string;
+    readonly [key: string]: unknown;
+}
+/** The failure a non-2xx Slack response produces. Mirrors eve's `SlackApiError` field-for-field, so
+ *  a caller that reads `status` or `response` off a caught error keeps reading the same thing. */
+export declare class SlackWebApiError extends Error {
+    readonly method: string;
+    readonly status: number;
+    readonly response: unknown;
+    constructor(init: {
+        method: string;
+        status: number;
+        response: unknown;
+    });
+}
+/** The subset of the global `fetch` this module uses — injectable so tests drive it without Slack. */
+export type SlackFetchLike = (input: string, init: RequestInit) => Promise<Response>;
+/** Transport and retry seams. A test injects all of them; live code passes none. */
+export interface SlackWebApiDeps {
+    readonly fetch?: SlackFetchLike;
+    readonly sleep?: RateLimitRetryOptions["sleep"];
+    readonly now?: RateLimitRetryOptions["now"];
+    readonly maxAttempts?: number;
+    readonly capMs?: number;
+    readonly totalBudgetMs?: number;
+    readonly apiBase?: string;
+}
+/** Form-encode a Slack request body exactly as eve's `encodeSlackApiBody` does. */
+export declare function encodeSlackForm(body: unknown): string;
+/**
+ * POST one Slack Web API method, with the 429 backoff applied.
+ *
+ * Returns Slack's parsed JSON envelope on any 2xx, `ok:false` included. Throws
+ * {@link SlackWebApiError} on a non-2xx that is not a 429, and `RateLimitExhaustedError` when a 429
+ * outlasts the bounded attempts.
+ */
+export declare function callSlackWebApi(input: {
+    readonly botToken?: string;
+    readonly operation: string;
+    readonly body: unknown;
+}, deps?: SlackWebApiDeps): Promise<SlackWebApiResponse>;
+//# sourceMappingURL=slack-web-api.d.ts.map

package/dist/agent/channels/slack-web-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-web-api.d.ts","sourceRoot":"","sources":["../../../agent/channels/slack-web-api.ts"],"names":[],"mappings":"AAyCA,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAMxG,6FAA6F;AAC7F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED;kGACkG;AAClG,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B,YAAY,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,EAMtE;CACF;AAED,sGAAsG;AACtG,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAErF,oFAAoF;AACpF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAChD,QAAQ,CAAC,GAAG,CAAC,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAUrD;AA2CD;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,EACzF,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,mBAAmB,CAAC,CA6B9B"}