@mono-agent/slack-adapter 0.3.0 → 0.4.1

package/dist/message-stream.d.ts

@@ -1,54 +1,103 @@
-import type { AgentMessageStream as AgentMessageStreamBase } from "@mono-agent/agent-contracts";
+import type { AgentMessageStream as AgentMessageStreamBase, AgentStreamEvent, ResilientMessageStreamLogger } from "@mono-agent/agent-contracts";
 import type { SlackChannelId, SlackMessageTs, SlackWebApi } from "./types.js";
 export interface AgentMessageStream extends AgentMessageStreamBase {
     status(text: string): Promise<void>;
     append(delta: string): Promise<void>;
     replace(text: string): Promise<void>;
+    event(event: AgentStreamEvent): Promise<void>;
     finish(finalText?: string): Promise<void>;
 }
+export type SlackMessageStreamLogger = ResilientMessageStreamLogger;
 export interface SlackMessageStreamOptions {
     api: SlackWebApi;
     channelId: SlackChannelId;
     threadTs?: SlackMessageTs;
+    /** Message ts to react to (👀 "seen") in final-only mode. */
+    reactToTs?: SlackMessageTs;
+    /**
+     * Deliver only the final answer: suppress interim edits and react 👀 ("seen")
+     * while the agent works. Default false.
+     */
+    finalOnly?: boolean;
     initialStatusText?: string;
     editDebounceMs?: number;
     maxMessageChars?: number;
+    /** Maximum retries for a *final* delivery before giving up. Default 3. */
+    maxSendRetries?: number;
+    /** Upper bound on any honored `retry-after`/backoff wait, in ms. Default 60000. */
+    retryCapMs?: number;
+    /** Base delay for exponential backoff between final-delivery retries. Default 500. */
+    retryBaseDelayMs?: number;
+    /** Render lightweight tool activity hints as the live status. Default true. */
+    showHints?: boolean;
+    /**
+     * Status shown via `assistant.threads.setStatus` ("App is <status>") while the
+     * agent works, when this is a Slack AI-assistant thread. Falls back to the 👀
+     * reaction in regular channels/DMs. Default "is thinking…".
+     */
+    assistantStatusText?: string;
+    /** Aborts in-flight retry waits (e.g. on /cancel). */
+    abortSignal?: AbortSignal;
     logger?: SlackMessageStreamLogger;
+    /**
+     * Notified with each message this stream posts. Used to link a posted message
+     * back to the conversation that produced it, so a later in-thread reply can
+     * resume that conversation (see `posted-message-index` in agent-app).
+     */
+    onPosted?: SlackPostedMessageListener;
 }
-export interface SlackMessageStreamLogger {
-    debug?(message: string, metadata?: Record<string, unknown>): void;
-    warn?(message: string, metadata?: Record<string, unknown>): void;
-    error?(message: string, metadata?: Record<string, unknown>): void;
+/** Notified with the channel + ts of a message a stream posted. */
+export type SlackPostedMessageListener = (ref: {
+    ts: SlackMessageTs;
+    channel: SlackChannelId;
+}) => void;
+/**
+ * Raised only when a *final* delivery cannot reach Slack after retries and the
+ * last-resort fresh post. The AI request itself already succeeded, so the
+ * adapter treats this as a degraded delivery — never as an agent failure.
+ *
+ * Retained as the adapter's public error type; the shared substrate raises a
+ * {@link ChannelDeliveryError}, which this class normalizes so callers continue
+ * to catch `SlackDeliveryError`.
+ */
+export declare class SlackDeliveryError extends Error {
+    readonly cause: unknown;
+    readonly attempts: number;
+    constructor(message: string, details: {
+        cause: unknown;
+        attempts: number;
+    });
 }
+/** How a failed Slack post/update should be handled. */
+export type SlackSendOutcome = {
+    kind: "recreate";
+} | {
+    kind: "reformat_plain";
+} | {
+    kind: "retry";
+    retryAfterMs?: number;
+} | {
+    kind: "fatal";
+};
+/**
+ * Thin wrapper over the shared {@link ResilientMessageStream}. It builds a
+ * {@link SlackChannelTransport} and delegates the streaming/resilience FSM,
+ * preserving the adapter's public surface: the `status/append/replace/event/
+ * finish` API, friendly tool hints, abort-aware retries, and a Slack-shaped
+ * delivery error.
+ */
 export declare class SlackMessageStream implements AgentMessageStream {
-    private readonly api;
-    private readonly channelId;
-    private readonly threadTs;
-    private readonly initialStatusText;
-    private readonly editDebounceMs;
-    private readonly maxMessageChars;
-    private readonly logger;
-    private currentText;
-    private statusText;
-    private sentMessage;
-    private sendMessagePromise;
-    private editTimer;
-    private inFlightUpdate;
-    private lastAsyncError;
-    private finished;
+    private readonly inner;
     constructor(options: SlackMessageStreamOptions);
     status(text: string): Promise<void>;
     append(delta: string): Promise<void>;
     replace(text: string): Promise<void>;
+    event(event: AgentStreamEvent): Promise<void>;
     finish(finalText?: string): Promise<void>;
-    private ensureMessage;
-    private withThread;
-    private scheduleUpdate;
-    private startInFlightUpdate;
-    private flushUpdate;
-    private cancelScheduledUpdate;
-    private awaitInFlightUpdate;
-    private throwIfAsyncError;
-    private assertOpen;
 }
+/**
+ * Classify a Slack post/update failure into a recovery strategy. Pure and
+ * exported so the recovery policy can be unit-tested directly.
+ */
+export declare function classifySlackError(error: unknown): SlackSendOutcome;
 //# sourceMappingURL=message-stream.d.ts.map

package/dist/message-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-stream.d.ts","sourceRoot":"","sources":["../src/message-stream.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAEhG,OAAO,KAAK,EACV,cAAc,EAEd,cAAc,EACd,WAAW,EACZ,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,kBAAmB,SAAQ,sBAAsB;IAChE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,WAAW,CAAC;IACjB,SAAS,EAAE,cAAc,CAAC;IAC1B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAClE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjE,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACnE;AAMD,qBAAa,kBAAmB,YAAW,kBAAkB;IAC3D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAE9D,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,kBAAkB,CAAkD;IAC5E,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,yBAAyB;IAqBxC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAiCjC,aAAa;IAiB3B,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,mBAAmB;YAgBb,WAAW;IAUzB,OAAO,CAAC,qBAAqB;YAOf,mBAAmB;YAOnB,iBAAiB;IAY/B,OAAO,CAAC,UAAU;CAKnB"}
+{"version":3,"file":"message-stream.d.ts","sourceRoot":"","sources":["../src/message-stream.ts"],"names":[],"mappings":"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"}

package/dist/message-stream.js

@@ -1,105 +1,104 @@
-import { DEFAULT_EMPTY_FINAL_TEXT, DEFAULT_MAX_MESSAGE_CHARS, buildStreamingTailPreview, normalizeTrailing, splitTextByCodePoints, } from "@mono-agent/agent-contracts";
+import { ChannelDeliveryError, DEFAULT_MAX_MESSAGE_CHARS, ResilientMessageStream, } from "@mono-agent/agent-contracts";
+import { SlackApiError } from "./slack-client.js";
 import { formatMarkdownForSlack } from "./slack-markdown.js";
+/**
+ * Raised only when a *final* delivery cannot reach Slack after retries and the
+ * last-resort fresh post. The AI request itself already succeeded, so the
+ * adapter treats this as a degraded delivery — never as an agent failure.
+ *
+ * Retained as the adapter's public error type; the shared substrate raises a
+ * {@link ChannelDeliveryError}, which this class normalizes so callers continue
+ * to catch `SlackDeliveryError`.
+ */
+export class SlackDeliveryError extends Error {
+    cause;
+    attempts;
+    constructor(message, details) {
+        super(message);
+        this.name = "SlackDeliveryError";
+        this.cause = details.cause;
+        this.attempts = details.attempts;
+    }
+}
 const DEFAULT_INITIAL_STATUS_TEXT = "Thinking...";
-const DEFAULT_EDIT_DEBOUNCE_MS = 750;
-const EMPTY_FINAL_TEXT = DEFAULT_EMPTY_FINAL_TEXT;
-export class SlackMessageStream {
+const DEFAULT_ASSISTANT_STATUS_TEXT = "is thinking…";
+/**
+ * Adapts a {@link SlackWebApi} to the transport-agnostic {@link ChannelTransport}
+ * the shared {@link ResilientMessageStream} drives. Posts/edits map to
+ * chat.postMessage / chat.update (preserving `thread_ts`), failures are mapped
+ * through {@link classifySlackError}, and markdown renders via
+ * {@link formatMarkdownForSlack}. `mrkdwn` mirrors the substrate's markdown flag
+ * so a `reformat_plain` retry drops to plain text.
+ */
+class SlackChannelTransport {
+    maxMessageChars;
     api;
     channelId;
     threadTs;
-    initialStatusText;
-    editDebounceMs;
-    maxMessageChars;
-    logger;
-    currentText = "";
-    statusText;
-    sentMessage;
-    sendMessagePromise;
-    editTimer;
-    inFlightUpdate;
-    lastAsyncError;
-    finished = false;
+    reactToTs;
+    assistantStatusText;
+    onPosted;
+    reacted = false;
+    assistantStatusUnavailable = false;
     constructor(options) {
         this.api = options.api;
         this.channelId = options.channelId;
         this.threadTs = options.threadTs;
-        this.initialStatusText = normalizeTrailing(options.initialStatusText ?? DEFAULT_INITIAL_STATUS_TEXT, EMPTY_FINAL_TEXT);
-        this.statusText = this.initialStatusText;
-        this.editDebounceMs = options.editDebounceMs ?? DEFAULT_EDIT_DEBOUNCE_MS;
-        this.maxMessageChars = options.maxMessageChars ?? DEFAULT_MAX_MESSAGE_CHARS;
-        this.logger = options.logger;
-        if (!Number.isInteger(this.maxMessageChars) || this.maxMessageChars < 32) {
-            throw new RangeError("maxMessageChars must be an integer of at least 32.");
-        }
-        if (!Number.isFinite(this.editDebounceMs) || this.editDebounceMs < 0) {
-            throw new RangeError("editDebounceMs must be a non-negative number.");
-        }
+        this.reactToTs = options.reactToTs;
+        this.assistantStatusText = options.assistantStatusText;
+        this.maxMessageChars = options.maxMessageChars;
+        this.onPosted = options.onPosted;
     }
-    async status(text) {
-        this.assertOpen();
-        await this.throwIfAsyncError();
-        this.statusText = normalizeTrailing(text, EMPTY_FINAL_TEXT);
-        const hadMessage = this.sentMessage !== undefined;
-        await this.ensureMessage();
-        if (hadMessage) {
-            await this.flushUpdate(this.statusText);
-        }
-    }
-    async append(delta) {
-        this.assertOpen();
-        await this.throwIfAsyncError();
-        if (delta.length === 0) {
+    async indicateActivity() {
+        // Prefer Slack's official assistant-thread status ("App is <status>"), which
+        // Slack auto-clears when the app posts its next message to the thread. It only
+        // works inside an AI-assistant thread (needs the assistant:write scope), so if
+        // it is unavailable or errors we stop trying for this stream and fall back to
+        // the 👀 reaction used in regular channels/DMs.
+        if (!this.assistantStatusUnavailable &&
+            this.threadTs !== undefined &&
+            this.api.setAssistantStatus !== undefined) {
+            try {
+                await this.api.setAssistantStatus({
+                    channelId: this.channelId,
+                    threadTs: this.threadTs,
+                    status: this.assistantStatusText,
+                });
+                return;
+            }
+            catch {
+                // Not an assistant thread (or missing scope): don't retry it this stream.
+                this.assistantStatusUnavailable = true;
+            }
+        }
+        // Slack has no bot "typing" indicator, so signal "seen" with a 👀 reaction on
+        // the triggering message — added once (Slack rejects duplicates).
+        if (this.reacted || this.reactToTs === undefined || this.api.reactionsAdd === undefined) {
             return;
         }
-        this.currentText += delta;
-        await this.ensureMessage();
-        this.scheduleUpdate();
+        this.reacted = true;
+        await this.api.reactionsAdd({ channel: this.channelId, timestamp: this.reactToTs, name: "eyes" });
     }
-    async replace(text) {
-        this.assertOpen();
-        await this.throwIfAsyncError();
-        this.currentText = text;
-        await this.ensureMessage();
-        this.scheduleUpdate();
+    async post(text, options) {
+        const sent = await this.api.chatPostMessage(this.withThread({ channel: this.channelId, text, mrkdwn: options.markdown }));
+        // Use `sent` (typed SlackChatPostMessageResult) rather than the transport-agnostic
+        // MessageRef, whose `channel` widens to `unknown`.
+        this.onPosted?.({ ts: sent.ts, channel: sent.channel });
+        return slackMessageRef(sent);
     }
-    async finish(finalText) {
-        if (this.finished) {
-            return;
-        }
-        this.finished = true;
-        if (finalText !== undefined) {
-            this.currentText = finalText;
-        }
-        this.cancelScheduledUpdate();
-        await this.throwIfAsyncError();
-        await this.awaitInFlightUpdate();
-        await this.throwIfAsyncError();
-        const finalMessageText = normalizeTrailing(this.currentText.length > 0 ? this.currentText : EMPTY_FINAL_TEXT, EMPTY_FINAL_TEXT);
-        const chunks = splitTextByCodePoints(finalMessageText, this.maxMessageChars);
-        const [firstChunk, ...remainingChunks] = chunks;
-        await this.ensureMessage();
-        await this.flushUpdate(firstChunk ?? EMPTY_FINAL_TEXT);
-        for (const chunk of remainingChunks) {
-            await this.api.chatPostMessage(this.withThread({
-                channel: this.channelId,
-                text: formatMarkdownForSlack(chunk),
-                mrkdwn: true,
-            }));
-        }
+    async edit(ref, text, options) {
+        await this.api.chatUpdate({
+            channel: this.channelId,
+            ts: ref.id,
+            text,
+            mrkdwn: options.markdown,
+        });
     }
-    async ensureMessage() {
-        if (this.sentMessage !== undefined) {
-            return this.sentMessage;
-        }
-        if (this.sendMessagePromise === undefined) {
-            this.sendMessagePromise = this.api.chatPostMessage(this.withThread({
-                channel: this.channelId,
-                text: formatMarkdownForSlack(this.statusText),
-                mrkdwn: true,
-            }));
-        }
-        this.sentMessage = await this.sendMessagePromise;
-        return this.sentMessage;
+    classifyError(error) {
+        return classifySlackError(error);
+    }
+    renderMarkdown(text) {
+        return formatMarkdownForSlack(text);
     }
     withThread(params) {
         if (this.threadTs === undefined) {
@@ -107,63 +106,112 @@ export class SlackMessageStream {
         }
         return { ...params, thread_ts: this.threadTs };
     }
-    scheduleUpdate() {
-        this.cancelScheduledUpdate();
-        if (this.editDebounceMs === 0) {
-            this.startInFlightUpdate();
-            return;
-        }
-        this.editTimer = setTimeout(() => {
-            this.editTimer = undefined;
-            this.startInFlightUpdate();
-        }, this.editDebounceMs);
-    }
-    startInFlightUpdate() {
-        const text = buildStreamingTailPreview(normalizeTrailing(this.currentText, EMPTY_FINAL_TEXT), this.maxMessageChars, "...\n");
-        this.inFlightUpdate = this.flushUpdate(text).catch((error) => {
-            this.lastAsyncError = error;
-            this.logger?.error?.("Slack stream update failed.", {
-                error: error instanceof Error ? error.message : String(error),
-            });
-            throw error;
+}
+function slackMessageRef(message) {
+    return { id: message.ts, channel: message.channel };
+}
+/**
+ * Thin wrapper over the shared {@link ResilientMessageStream}. It builds a
+ * {@link SlackChannelTransport} and delegates the streaming/resilience FSM,
+ * preserving the adapter's public surface: the `status/append/replace/event/
+ * finish` API, friendly tool hints, abort-aware retries, and a Slack-shaped
+ * delivery error.
+ */
+export class SlackMessageStream {
+    inner;
+    constructor(options) {
+        const maxMessageChars = options.maxMessageChars ?? DEFAULT_MAX_MESSAGE_CHARS;
+        const transport = new SlackChannelTransport({
+            api: options.api,
+            channelId: options.channelId,
+            ...(options.threadTs === undefined ? {} : { threadTs: options.threadTs }),
+            ...(options.reactToTs === undefined ? {} : { reactToTs: options.reactToTs }),
+            assistantStatusText: options.assistantStatusText ?? DEFAULT_ASSISTANT_STATUS_TEXT,
+            maxMessageChars,
+            ...(options.onPosted === undefined ? {} : { onPosted: options.onPosted }),
         });
-        void this.inFlightUpdate.catch(() => undefined);
-    }
-    async flushUpdate(text) {
-        const message = await this.ensureMessage();
-        await this.api.chatUpdate({
-            channel: this.channelId,
-            ts: message.ts,
-            text: formatMarkdownForSlack(normalizeTrailing(text, EMPTY_FINAL_TEXT)),
-            mrkdwn: true,
+        this.inner = new ResilientMessageStream({
+            transport,
+            initialStatusText: options.initialStatusText ?? DEFAULT_INITIAL_STATUS_TEXT,
+            maxMessageChars,
+            formatMarkdown: true,
+            ...(options.finalOnly === undefined ? {} : { finalOnly: options.finalOnly }),
+            ...(options.editDebounceMs === undefined ? {} : { editDebounceMs: options.editDebounceMs }),
+            ...(options.maxSendRetries === undefined ? {} : { maxSendRetries: options.maxSendRetries }),
+            ...(options.retryCapMs === undefined ? {} : { retryCapMs: options.retryCapMs }),
+            ...(options.retryBaseDelayMs === undefined ? {} : { retryBaseDelayMs: options.retryBaseDelayMs }),
+            ...(options.showHints === undefined ? {} : { showHints: options.showHints }),
+            ...(options.abortSignal === undefined ? {} : { abortSignal: options.abortSignal }),
+            ...(options.logger === undefined ? {} : { logger: options.logger }),
         });
     }
-    cancelScheduledUpdate() {
-        if (this.editTimer !== undefined) {
-            clearTimeout(this.editTimer);
-            this.editTimer = undefined;
-        }
+    status(text) {
+        return this.inner.status(text);
     }
-    async awaitInFlightUpdate() {
-        if (this.inFlightUpdate !== undefined) {
-            await this.inFlightUpdate;
-            this.inFlightUpdate = undefined;
-        }
+    append(delta) {
+        return this.inner.append(delta);
     }
-    async throwIfAsyncError() {
-        if (this.inFlightUpdate !== undefined) {
-            await this.awaitInFlightUpdate();
-        }
-        if (this.lastAsyncError !== undefined) {
-            const error = this.lastAsyncError;
-            this.lastAsyncError = undefined;
+    replace(text) {
+        return this.inner.replace(text);
+    }
+    event(event) {
+        return this.inner.event(event);
+    }
+    async finish(finalText) {
+        try {
+            await this.inner.finish(finalText);
+        }
+        catch (error) {
+            if (error instanceof ChannelDeliveryError) {
+                throw new SlackDeliveryError("Slack final delivery failed.", {
+                    cause: error.cause,
+                    attempts: error.attempts,
+                });
+            }
             throw error;
         }
     }
-    assertOpen() {
-        if (this.finished) {
-            throw new Error("Cannot write to a finished SlackMessageStream.");
-        }
+}
+/**
+ * Classify a Slack post/update failure into a recovery strategy. Pure and
+ * exported so the recovery policy can be unit-tested directly.
+ */
+export function classifySlackError(error) {
+    if (error instanceof SlackApiError) {
+        const slackError = (error.slackError ?? "").toLowerCase();
+        if (slackError === "message_not_found" ||
+            slackError === "cant_update_message" ||
+            slackError === "edit_window_closed") {
+            return { kind: "recreate" };
+        }
+        if (slackError === "invalid_blocks" ||
+            slackError === "invalid_block_id" ||
+            slackError === "msg_blocks_too_long" ||
+            slackError === "as_user_not_supported") {
+            return { kind: "reformat_plain" };
+        }
+        if (error.retryAfterMs !== undefined ||
+            error.status === 429 ||
+            slackError === "ratelimited" ||
+            slackError === "rate_limited") {
+            if (error.retryAfterMs !== undefined) {
+                return { kind: "retry", retryAfterMs: error.retryAfterMs };
+            }
+            return { kind: "retry" };
+        }
+        if (error.kind === "network") {
+            return { kind: "retry" };
+        }
+        if (error.kind === "aborted") {
+            return { kind: "fatal" };
+        }
+        if (error.status !== undefined && error.status >= 500) {
+            return { kind: "retry" };
+        }
+        return { kind: "fatal" };
     }
+    // Non-SlackApiError (e.g. a transient transport error or a test stub): retry
+    // conservatively rather than surfacing it as a hard failure.
+    return { kind: "retry" };
 }
 //# sourceMappingURL=message-stream.js.map

package/dist/message-stream.js.map

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

package/dist/slack-client.d.ts

@@ -1,4 +1,4 @@
-import type { SlackAppsConnectionsOpenResult, SlackAuthTestResult, SlackChatPostMessageParams, SlackChatPostMessageResult, SlackChatUpdateParams, SlackChatUpdateResult, SlackRequestOptions, SlackWebApi } from "./types.js";
+import type { SlackAppsConnectionsOpenResult, SlackAuthTestResult, SlackChatPostMessageParams, SlackChatPostMessageResult, SlackChatUpdateParams, SlackChatUpdateResult, SlackDownloadFileParams, SlackReactionsAddParams, SlackRequestOptions, SlackSetAssistantStatusParams, SlackViewsPublishParams, SlackWebApi } from "./types.js";
 export type SlackApiErrorKind = "http" | "slack" | "malformed" | "network" | "aborted";
 export interface SlackApiErrorDetails {
     kind: SlackApiErrorKind;
@@ -8,6 +8,13 @@ export interface SlackApiErrorDetails {
     needed?: string;
     provided?: string;
     warning?: string;
+    /**
+     * How long to wait before retrying, in milliseconds. Lifted from a Slack
+     * `Retry-After` response header (seconds) on a rate-limited (HTTP 429)
+     * response. Only the integer is carried — never a raw response body — so bot
+     * tokens cannot leak.
+     */
+    retryAfterMs?: number;
     cause?: unknown;
 }
 export declare class SlackApiError extends Error {
@@ -18,12 +25,13 @@ export declare class SlackApiError extends Error {
     readonly needed?: string;
     readonly provided?: string;
     readonly warning?: string;
+    readonly retryAfterMs?: number;
     readonly cause?: unknown;
     constructor(message: string, details: SlackApiErrorDetails);
 }
 export interface SlackWebApiClientOptions {
     botToken: string;
-    appToken: string;
+    appToken?: string;
     apiBaseUrl?: string;
     fetchImpl?: typeof fetch;
     requestTimeoutMs?: number;
@@ -38,7 +46,19 @@ export declare class SlackWebApiClient implements SlackWebApi {
     authTest(options?: SlackRequestOptions): Promise<SlackAuthTestResult>;
     appsConnectionsOpen(options?: SlackRequestOptions): Promise<SlackAppsConnectionsOpenResult>;
     chatPostMessage(params: SlackChatPostMessageParams, options?: SlackRequestOptions): Promise<SlackChatPostMessageResult>;
+    private requiredAppToken;
     chatUpdate(params: SlackChatUpdateParams, options?: SlackRequestOptions): Promise<SlackChatUpdateResult>;
+    reactionsAdd(params: SlackReactionsAddParams, options?: SlackRequestOptions): Promise<void>;
+    setAssistantStatus(params: SlackSetAssistantStatusParams, options?: SlackRequestOptions): Promise<void>;
+    viewsPublish(params: SlackViewsPublishParams, options?: SlackRequestOptions): Promise<void>;
+    /**
+     * Download a private Slack file. Slack serves `url_private` only with an
+     * `Authorization: Bearer <bot token>` header. The download is bounded by the
+     * caller's request timeout and any external abort signal, and reads at most
+     * `maxBytes` (rejecting once the cap is exceeded) so a hostile or oversized
+     * file cannot exhaust memory.
+     */
+    downloadFile(params: SlackDownloadFileParams, options?: SlackRequestOptions): Promise<Uint8Array>;
     private request;
 }
 //# sourceMappingURL=slack-client.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"slack-client.d.ts","sourceRoot":"","sources":["../src/slack-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,mBAAmB,EACnB,0BAA0B,EAC1B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,OAAO,GACP,WAAW,GACX,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB;CAwB3D;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAeD,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,OAAO,EAAE,wBAAwB;IAsB7C,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIrE,mBAAmB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,8BAA8B,CAAC;IAI3F,eAAe,CACb,MAAM,EAAE,0BAA0B,EAClC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,0BAA0B,CAAC;IAItC,UAAU,CACR,MAAM,EAAE,qBAAqB,EAC7B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;YAInB,OAAO;CAwEtB"}
+{"version":3,"file":"slack-client.d.ts","sourceRoot":"","sources":["../src/slack-client.ts"],"names":[],"mappings":"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"}