@mono-agent/slack-adapter 0.1.0

package/dist/config.js

@@ -0,0 +1,119 @@
+import { defineFieldGroup, layerJsonOntoEnv, readBoolean, readCsv, readJsonSection, readRequired, readSettingsJson, redactedSecret, } from "@mono-agent/settings";
+export class SlackAdapterConfigError extends Error {
+    code;
+    details;
+    constructor(code, message, details = {}) {
+        super(message);
+        this.name = "SlackAdapterConfigError";
+        this.code = code;
+        this.details = { ...details, code };
+    }
+}
+export const slackFieldGroup = defineFieldGroup({
+    id: "slack",
+    label: "Slack",
+    description: "Optional Slack Socket Mode adapter configuration. Tokens are write-only.",
+    fields: [
+        {
+            id: "slack.botToken",
+            label: "Bot token",
+            description: "Slack bot token used for chat.postMessage and chat.update.",
+            kind: "secret",
+            path: ["slack", "botToken"],
+        },
+        {
+            id: "slack.appToken",
+            label: "App token",
+            description: "Slack app-level token with connections:write for Socket Mode.",
+            kind: "secret",
+            path: ["slack", "appToken"],
+        },
+        {
+            id: "slack.allowedChannelIds",
+            label: "Allowed channel IDs",
+            description: "Comma-separated Slack channel or DM IDs the adapter may respond to.",
+            kind: "csv",
+            placeholder: "D123456, C123456",
+            path: ["slack", "allowedChannelIds"],
+        },
+        {
+            id: "slack.allowAllChannels",
+            label: "Allow all channels",
+            description: "Explicitly permit every channel delivered to the app.",
+            kind: "switch",
+            path: ["slack", "allowAllChannels"],
+        },
+        {
+            id: "slack.botUserIds",
+            label: "Bot user IDs",
+            description: "Comma-separated Slack user IDs that should count as this bot.",
+            kind: "csv",
+            placeholder: "U123456",
+            path: ["slack", "botUserIds"],
+        },
+        {
+            id: "slack.mentionTextAliases",
+            label: "Mention aliases",
+            description: "Comma-separated mention text aliases to strip before runtime calls.",
+            kind: "csv",
+            placeholder: "@agent, Assistant",
+            path: ["slack", "mentionTextAliases"],
+        },
+        {
+            id: "slack.stripMentionText",
+            label: "Strip mention text",
+            description: "Remove configured bot mentions and aliases before sending text to the responder.",
+            kind: "switch",
+            path: ["slack", "stripMentionText"],
+        },
+    ],
+});
+const missingConfig = (message, details) => new SlackAdapterConfigError("missing_required_config", message, details);
+const invalidConfig = (message, details) => new SlackAdapterConfigError("invalid_config", message, details);
+export async function loadSlackAdapterConfig(input) {
+    const json = input.json ?? (input.jsonPath === undefined ? {} : (await readSettingsJson(input.jsonPath)).json);
+    const env = layerSlackJsonOntoEnv(json, input.env);
+    const botToken = readRequired(env.MONO_AGENT_SLACK_BOT_TOKEN, "MONO_AGENT_SLACK_BOT_TOKEN", missingConfig);
+    const appToken = readRequired(env.MONO_AGENT_SLACK_APP_TOKEN, "MONO_AGENT_SLACK_APP_TOKEN", missingConfig);
+    const allowedChannelIds = readCsv(env.MONO_AGENT_SLACK_ALLOWED_CHANNEL_IDS);
+    const allowAllChannels = readBoolean(env.MONO_AGENT_SLACK_ALLOW_ALL_CHANNELS, "MONO_AGENT_SLACK_ALLOW_ALL_CHANNELS", false, invalidConfig);
+    const botUserIds = readCsv(env.MONO_AGENT_SLACK_BOT_USER_IDS);
+    const mentionTextAliases = readCsv(env.MONO_AGENT_SLACK_MENTION_TEXT_ALIASES);
+    const stripMentionText = readBoolean(env.MONO_AGENT_SLACK_STRIP_MENTION_TEXT, "MONO_AGENT_SLACK_STRIP_MENTION_TEXT", botUserIds.length > 0 || mentionTextAliases.length > 0, invalidConfig);
+    if (!allowAllChannels && allowedChannelIds.length === 0) {
+        throw missingConfig("Slack adapter requires MONO_AGENT_SLACK_ALLOWED_CHANNEL_IDS or MONO_AGENT_SLACK_ALLOW_ALL_CHANNELS=true.", { env: "MONO_AGENT_SLACK_ALLOWED_CHANNEL_IDS" });
+    }
+    return {
+        botToken,
+        appToken,
+        allowedChannelIds,
+        allowAllChannels,
+        botUserIds,
+        mentionTextAliases,
+        stripMentionText,
+    };
+}
+export function redactSlackAdapterConfig(config) {
+    return {
+        botToken: redactedSecret(config.botToken),
+        appToken: redactedSecret(config.appToken),
+        allowedChannelIds: { count: config.allowedChannelIds.length },
+        allowAllChannels: config.allowAllChannels,
+        botUserIds: { count: config.botUserIds.length },
+        mentionTextAliases: { count: config.mentionTextAliases.length },
+        stripMentionText: config.stripMentionText,
+    };
+}
+function layerSlackJsonOntoEnv(json, env) {
+    const section = readJsonSection(json, "slack");
+    return layerJsonOntoEnv(env, [
+        { env: "MONO_AGENT_SLACK_BOT_TOKEN", value: section.botToken },
+        { env: "MONO_AGENT_SLACK_APP_TOKEN", value: section.appToken },
+        { env: "MONO_AGENT_SLACK_ALLOWED_CHANNEL_IDS", value: section.allowedChannelIds, kind: "csv" },
+        { env: "MONO_AGENT_SLACK_ALLOW_ALL_CHANNELS", value: section.allowAllChannels, kind: "boolean" },
+        { env: "MONO_AGENT_SLACK_BOT_USER_IDS", value: section.botUserIds, kind: "csv" },
+        { env: "MONO_AGENT_SLACK_MENTION_TEXT_ALIASES", value: section.mentionTextAliases, kind: "csv" },
+        { env: "MONO_AGENT_SLACK_STRIP_MENTION_TEXT", value: section.stripMentionText, kind: "boolean" },
+    ]);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export type { SlackAppsConnectionsOpenResult, SlackAuthTestResult, SlackChannelId, SlackChatPostMessageParams, SlackChatPostMessageResult, SlackChatUpdateParams, SlackChatUpdateResult, SlackEventBase, SlackEventCallback, SlackMessageTs, SlackRequestOptions, SlackSocketModeEnvelope, SlackUserId, SlackWebApi, } from "./types.js";
+export { SlackApiError, SlackWebApiClient, } from "./slack-client.js";
+export type { SlackApiErrorDetails, SlackApiErrorKind, SlackWebApiClientOptions, } from "./slack-client.js";
+export { SlackMessageStream, } from "./message-stream.js";
+export type { AgentMessageStream, SlackMessageStreamLogger, SlackMessageStreamOptions, } from "./message-stream.js";
+export { SlackAdapter, } from "./adapter.js";
+export type { AgentRequest, AgentResponder, AgentResponse, SlackAdapterLogger, SlackAdapterMessages, SlackAdapterOptions, SlackAdapterStreamOptions, SlackEventHandlingResult, SlackEventIgnoredReason, SlackRequestMetadata, SlackTriggerKind, } from "./adapter.js";
+export { SlackSocketModeRunner, } from "./socket-mode-runner.js";
+export type { SlackEventCallbackHandler, SlackSocketModeRunnerBackoffOptions, SlackSocketModeRunnerLogger, SlackSocketModeRunnerOptions, SlackSocketModeRunnerStartOptions, SlackWebSocketFactory, SlackWebSocketLike, } from "./socket-mode-runner.js";
+export { startSlackAdapter, } from "./start.js";
+export type { SlackAdapterStartLogger, SlackAdapterStartOptions, SlackAdapterStartResult, SlackApiFactoryInput, } from "./start.js";
+export { loadSlackAdapterConfig, redactSlackAdapterConfig, SlackAdapterConfigError, slackFieldGroup, } from "./config.js";
+export type { LoadSlackAdapterConfigInput, RedactedSlackAdapterConfig, SlackAdapterConfig, SlackAdapterConfigErrorCode, SlackAdapterConfigErrorDetails, } from "./config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,8BAA8B,EAC9B,mBAAmB,EACnB,cAAc,EACd,0BAA0B,EAC1B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,EACb,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,yBAAyB,EACzB,mCAAmC,EACnC,2BAA2B,EAC3B,4BAA4B,EAC5B,iCAAiC,EACjC,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,kBAAkB,EAClB,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { SlackApiError, SlackWebApiClient, } from "./slack-client.js";
+export { SlackMessageStream, } from "./message-stream.js";
+export { SlackAdapter, } from "./adapter.js";
+export { SlackSocketModeRunner, } from "./socket-mode-runner.js";
+export { startSlackAdapter, } from "./start.js";
+export { loadSlackAdapterConfig, redactSlackAdapterConfig, SlackAdapterConfigError, slackFieldGroup, } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,aAAa,EACb,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EACL,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EACL,YAAY,GACb,MAAM,cAAc,CAAC;AActB,OAAO,EACL,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAUjC,OAAO,EACL,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAOpB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/message-stream.d.ts

@@ -0,0 +1,54 @@
+import type { AgentMessageStream as AgentMessageStreamBase } 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>;
+    finish(finalText?: string): Promise<void>;
+}
+export interface SlackMessageStreamOptions {
+    api: SlackWebApi;
+    channelId: SlackChannelId;
+    threadTs?: SlackMessageTs;
+    initialStatusText?: string;
+    editDebounceMs?: number;
+    maxMessageChars?: number;
+    logger?: SlackMessageStreamLogger;
+}
+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;
+}
+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;
+    constructor(options: SlackMessageStreamOptions);
+    status(text: string): Promise<void>;
+    append(delta: string): Promise<void>;
+    replace(text: string): 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;
+}
+//# sourceMappingURL=message-stream.d.ts.map

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

@@ -0,0 +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"}

package/dist/message-stream.js

@@ -0,0 +1,169 @@
+import { DEFAULT_EMPTY_FINAL_TEXT, DEFAULT_MAX_MESSAGE_CHARS, buildStreamingTailPreview, normalizeTrailing, splitTextByCodePoints, } from "@mono-agent/agent-contracts";
+import { formatMarkdownForSlack } from "./slack-markdown.js";
+const DEFAULT_INITIAL_STATUS_TEXT = "Thinking...";
+const DEFAULT_EDIT_DEBOUNCE_MS = 750;
+const EMPTY_FINAL_TEXT = DEFAULT_EMPTY_FINAL_TEXT;
+export class SlackMessageStream {
+    api;
+    channelId;
+    threadTs;
+    initialStatusText;
+    editDebounceMs;
+    maxMessageChars;
+    logger;
+    currentText = "";
+    statusText;
+    sentMessage;
+    sendMessagePromise;
+    editTimer;
+    inFlightUpdate;
+    lastAsyncError;
+    finished = 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.");
+        }
+    }
+    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) {
+            return;
+        }
+        this.currentText += delta;
+        await this.ensureMessage();
+        this.scheduleUpdate();
+    }
+    async replace(text) {
+        this.assertOpen();
+        await this.throwIfAsyncError();
+        this.currentText = text;
+        await this.ensureMessage();
+        this.scheduleUpdate();
+    }
+    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 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;
+    }
+    withThread(params) {
+        if (this.threadTs === undefined) {
+            return params;
+        }
+        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;
+        });
+        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,
+        });
+    }
+    cancelScheduledUpdate() {
+        if (this.editTimer !== undefined) {
+            clearTimeout(this.editTimer);
+            this.editTimer = undefined;
+        }
+    }
+    async awaitInFlightUpdate() {
+        if (this.inFlightUpdate !== undefined) {
+            await this.inFlightUpdate;
+            this.inFlightUpdate = undefined;
+        }
+    }
+    async throwIfAsyncError() {
+        if (this.inFlightUpdate !== undefined) {
+            await this.awaitInFlightUpdate();
+        }
+        if (this.lastAsyncError !== undefined) {
+            const error = this.lastAsyncError;
+            this.lastAsyncError = undefined;
+            throw error;
+        }
+    }
+    assertOpen() {
+        if (this.finished) {
+            throw new Error("Cannot write to a finished SlackMessageStream.");
+        }
+    }
+}
+//# sourceMappingURL=message-stream.js.map

package/dist/message-stream.js.map

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

package/dist/slack-client.d.ts

@@ -0,0 +1,44 @@
+import type { SlackAppsConnectionsOpenResult, SlackAuthTestResult, SlackChatPostMessageParams, SlackChatPostMessageResult, SlackChatUpdateParams, SlackChatUpdateResult, SlackRequestOptions, SlackWebApi } from "./types.js";
+export type SlackApiErrorKind = "http" | "slack" | "malformed" | "network" | "aborted";
+export interface SlackApiErrorDetails {
+    kind: SlackApiErrorKind;
+    method: string;
+    status?: number;
+    slackError?: string;
+    needed?: string;
+    provided?: string;
+    warning?: string;
+    cause?: unknown;
+}
+export declare class SlackApiError extends Error {
+    readonly kind: SlackApiErrorKind;
+    readonly method: string;
+    readonly status?: number;
+    readonly slackError?: string;
+    readonly needed?: string;
+    readonly provided?: string;
+    readonly warning?: string;
+    readonly cause?: unknown;
+    constructor(message: string, details: SlackApiErrorDetails);
+}
+export interface SlackWebApiClientOptions {
+    botToken: string;
+    appToken: string;
+    apiBaseUrl?: string;
+    fetchImpl?: typeof fetch;
+    requestTimeoutMs?: number;
+}
+export declare class SlackWebApiClient implements SlackWebApi {
+    private readonly botToken;
+    private readonly appToken;
+    private readonly apiBaseUrl;
+    private readonly fetchImpl;
+    private readonly requestTimeoutMs;
+    constructor(options: SlackWebApiClientOptions);
+    authTest(options?: SlackRequestOptions): Promise<SlackAuthTestResult>;
+    appsConnectionsOpen(options?: SlackRequestOptions): Promise<SlackAppsConnectionsOpenResult>;
+    chatPostMessage(params: SlackChatPostMessageParams, options?: SlackRequestOptions): Promise<SlackChatPostMessageResult>;
+    chatUpdate(params: SlackChatUpdateParams, options?: SlackRequestOptions): Promise<SlackChatUpdateResult>;
+    private request;
+}
+//# sourceMappingURL=slack-client.d.ts.map

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

@@ -0,0 +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"}

package/dist/slack-client.js

@@ -0,0 +1,204 @@
+export class SlackApiError extends Error {
+    kind;
+    method;
+    status;
+    slackError;
+    needed;
+    provided;
+    warning;
+    cause;
+    constructor(message, details) {
+        super(message);
+        this.name = "SlackApiError";
+        this.kind = details.kind;
+        this.method = details.method;
+        if (details.status !== undefined) {
+            this.status = details.status;
+        }
+        if (details.slackError !== undefined) {
+            this.slackError = details.slackError;
+        }
+        if (details.needed !== undefined) {
+            this.needed = details.needed;
+        }
+        if (details.provided !== undefined) {
+            this.provided = details.provided;
+        }
+        if (details.warning !== undefined) {
+            this.warning = details.warning;
+        }
+        if (details.cause !== undefined) {
+            this.cause = details.cause;
+        }
+    }
+}
+const DEFAULT_API_BASE_URL = "https://slack.com/api";
+const DEFAULT_REQUEST_TIMEOUT_MS = 45_000;
+export class SlackWebApiClient {
+    botToken;
+    appToken;
+    apiBaseUrl;
+    fetchImpl;
+    requestTimeoutMs;
+    constructor(options) {
+        const botToken = options.botToken.trim();
+        const appToken = options.appToken.trim();
+        if (botToken.length === 0) {
+            throw new TypeError("Slack bot token is required.");
+        }
+        if (appToken.length === 0) {
+            throw new TypeError("Slack app token is required.");
+        }
+        const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+        if (typeof fetchImpl !== "function") {
+            throw new TypeError("A fetch implementation is required to call the Slack Web API.");
+        }
+        this.botToken = botToken;
+        this.appToken = appToken;
+        this.apiBaseUrl = stripTrailingSlashes(options.apiBaseUrl ?? DEFAULT_API_BASE_URL);
+        this.fetchImpl = fetchImpl;
+        this.requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+    }
+    authTest(options) {
+        return this.request("auth.test", {}, this.botToken, options);
+    }
+    appsConnectionsOpen(options) {
+        return this.request("apps.connections.open", {}, this.appToken, options);
+    }
+    chatPostMessage(params, options) {
+        return this.request("chat.postMessage", params, this.botToken, options);
+    }
+    chatUpdate(params, options) {
+        return this.request("chat.update", params, this.botToken, options);
+    }
+    async request(method, params, token, options) {
+        const url = `${this.apiBaseUrl}/${method}`;
+        const { signal, cleanup } = createRequestSignal(options?.signal, this.requestTimeoutMs);
+        let response;
+        try {
+            const init = {
+                method: "POST",
+                headers: {
+                    authorization: `Bearer ${token}`,
+                    "content-type": "application/json; charset=utf-8",
+                },
+                body: JSON.stringify(params),
+            };
+            if (signal !== undefined) {
+                init.signal = signal;
+            }
+            response = await this.fetchImpl(url, init);
+        }
+        catch (error) {
+            cleanup();
+            if (isAbortError(error) || options?.signal?.aborted === true) {
+                throw new SlackApiError(`Slack API ${method} request was aborted.`, {
+                    kind: "aborted",
+                    method,
+                });
+            }
+            throw new SlackApiError(`Network failure while calling Slack API ${method}.`, {
+                kind: "network",
+                method,
+            });
+        }
+        cleanup();
+        if (!response.ok) {
+            await safelyDrainResponse(response);
+            throw new SlackApiError(`Slack API ${method} failed with HTTP ${response.status}.`, {
+                kind: "http",
+                method,
+                status: response.status,
+            });
+        }
+        let payload;
+        try {
+            payload = await response.json();
+        }
+        catch {
+            throw new SlackApiError(`Slack API ${method} returned malformed JSON.`, {
+                kind: "malformed",
+                method,
+            });
+        }
+        const envelope = parseSlackEnvelope(method, payload);
+        if (!envelope.ok) {
+            throw new SlackApiError(`Slack API ${method} rejected the request.`, {
+                kind: "slack",
+                method,
+                ...(typeof envelope.error === "string" ? { slackError: envelope.error } : {}),
+                ...(typeof envelope.needed === "string" ? { needed: envelope.needed } : {}),
+                ...(typeof envelope.provided === "string" ? { provided: envelope.provided } : {}),
+                ...(typeof envelope.warning === "string" ? { warning: envelope.warning } : {}),
+            });
+        }
+        return envelope;
+    }
+}
+function parseSlackEnvelope(method, payload) {
+    if (!isRecord(payload) || typeof payload.ok !== "boolean") {
+        throw new SlackApiError(`Slack API ${method} returned an unexpected response shape.`, {
+            kind: "malformed",
+            method,
+        });
+    }
+    if (payload.ok === false) {
+        return {
+            ok: false,
+            ...(typeof payload.error === "string" ? { error: payload.error } : {}),
+            ...(typeof payload.needed === "string" ? { needed: payload.needed } : {}),
+            ...(typeof payload.provided === "string" ? { provided: payload.provided } : {}),
+            ...(typeof payload.warning === "string" ? { warning: payload.warning } : {}),
+        };
+    }
+    return payload;
+}
+function createRequestSignal(externalSignal, timeoutMs) {
+    const shouldUseTimeout = Number.isFinite(timeoutMs) && timeoutMs > 0;
+    if (!shouldUseTimeout) {
+        if (externalSignal === undefined) {
+            return { cleanup: () => undefined };
+        }
+        return { signal: externalSignal, cleanup: () => undefined };
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => {
+        controller.abort(new Error("Slack API request timed out."));
+    }, timeoutMs);
+    const abortFromExternalSignal = () => {
+        controller.abort(externalSignal?.reason);
+    };
+    if (externalSignal !== undefined) {
+        if (externalSignal.aborted) {
+            abortFromExternalSignal();
+        }
+        else {
+            externalSignal.addEventListener("abort", abortFromExternalSignal, { once: true });
+        }
+    }
+    return {
+        signal: controller.signal,
+        cleanup: () => {
+            clearTimeout(timeout);
+            externalSignal?.removeEventListener("abort", abortFromExternalSignal);
+        },
+    };
+}
+function stripTrailingSlashes(value) {
+    return value.replace(/\/+$/u, "");
+}
+function isAbortError(value) {
+    return (value instanceof DOMException && value.name === "AbortError") || (value instanceof Error && value.name === "AbortError");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+async function safelyDrainResponse(response) {
+    try {
+        await response.text();
+    }
+    catch {
+        // Best effort only. Error messages intentionally avoid raw response bodies.
+    }
+}
+//# sourceMappingURL=slack-client.js.map