@intentface/latch-channels 0.9.1

package/dist/slack/api.js

@@ -0,0 +1,249 @@
+/**
+ * Minimal Slack Web API client — just the methods a channel needs.
+ *
+ * Form-encoded POSTs with a bearer bot token (Slack accepts form on every
+ * method used here, including the streaming ones; complex values like
+ * `blocks`/`chunks`/`metadata` go as JSON-in-form fields). Typed errors, a
+ * bounded retry policy, and an injectable fetch for tests:
+ *
+ *   429            → honor `Retry-After` (capped) and retry ONCE
+ *   5xx            → retry once after a beat
+ *   ok:false, 4xx  → throw {@link SlackApiError} immediately (the caller
+ *                    decides what's fatal — e.g. `stopped_by_user` on a
+ *                    streaming append is a signal, not a failure)
+ */
+export class SlackApiError extends Error {
+    /** The Slack method that failed (`chat.postMessage`). */
+    method;
+    /** HTTP status of the response (200 for ok:false payload errors). */
+    status;
+    /** Slack's error code (`channel_not_found`, `stopped_by_user`, …) if any. */
+    code;
+    /** Seconds Slack asked us to wait, when it said. */
+    retryAfterS;
+    /**
+     * Slack's `response_metadata.messages`, when present — for
+     * `invalid_arguments` it names the offending field as a JSON pointer,
+     * which is the difference between a fix and a guessing game.
+     */
+    detail;
+    constructor(method, status, code, retryAfterS, detail) {
+        super(`slack:${method} failed: ${code ?? status}${detail ? ` (${detail})` : ""}`);
+        this.name = "SlackApiError";
+        this.method = method;
+        this.status = status;
+        if (code !== undefined)
+            this.code = code;
+        if (retryAfterS !== undefined)
+            this.retryAfterS = retryAfterS;
+        if (detail !== undefined)
+            this.detail = detail;
+    }
+}
+const defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));
+const MAX_RETRY_AFTER_S = 10;
+async function resolveToken(token) {
+    return typeof token === "function" ? token() : token;
+}
+/** A bot-scoped client bound to one token. */
+export function slackApi(token, options = {}) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const baseUrl = options.baseUrl ?? "https://slack.com/api";
+    const sleep = options.sleep ?? defaultSleep;
+    const timeoutMs = options.timeoutMs ?? 10_000;
+    /** Methods whose nested payloads (chunks/blocks) go as real JSON. */
+    const JSON_METHODS = new Set(["chat.startStream", "chat.appendStream", "chat.stopStream"]);
+    async function once(method, params) {
+        const auth = `Bearer ${await resolveToken(token)}`;
+        if (JSON_METHODS.has(method)) {
+            const body = {};
+            for (const [k, v] of Object.entries(params)) {
+                if (v !== undefined && v !== null)
+                    body[k] = v;
+            }
+            return fetchImpl(`${baseUrl}/${method}`, {
+                method: "POST",
+                headers: { authorization: auth, "content-type": "application/json; charset=utf-8" },
+                body: JSON.stringify(body),
+                signal: AbortSignal.timeout(timeoutMs),
+            });
+        }
+        const form = new URLSearchParams();
+        for (const [k, v] of Object.entries(params)) {
+            if (v === undefined || v === null)
+                continue;
+            form.set(k, typeof v === "string" ? v : JSON.stringify(v));
+        }
+        return fetchImpl(`${baseUrl}/${method}`, {
+            method: "POST",
+            headers: {
+                authorization: auth,
+                "content-type": "application/x-www-form-urlencoded; charset=utf-8",
+            },
+            body: form,
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+    }
+    async function call(method, params) {
+        let retried = false;
+        for (;;) {
+            const res = await once(method, params);
+            if (res.status === 429 && !retried) {
+                retried = true;
+                const after = Number(res.headers.get("retry-after") ?? 1);
+                await sleep(Math.min(Number.isFinite(after) ? after : 1, MAX_RETRY_AFTER_S) * 1000);
+                continue;
+            }
+            if (res.status >= 500 && !retried) {
+                retried = true;
+                await sleep(1000);
+                continue;
+            }
+            if (res.status === 429 || res.status >= 500) {
+                throw new SlackApiError(method, res.status, undefined, Number(res.headers.get("retry-after") ?? 0) || undefined);
+            }
+            const json = (await res.json());
+            if (json.ok !== true) {
+                const meta = json.response_metadata?.messages;
+                throw new SlackApiError(method, res.status, String(json.error ?? "unknown_error"), undefined, meta?.length ? meta.join("; ").slice(0, 500) : undefined);
+            }
+            return json;
+        }
+    }
+    return {
+        /**
+         * Post a message. NOTE: `markdown_text` is EXCLUSIVE with `text`/`blocks`
+         * (`markdown_text_conflict`) — for markdown with a notification fallback,
+         * use `markdown` blocks + `text` instead.
+         */
+        async postMessage(input) {
+            const r = await call("chat.postMessage", { unfurl_links: false, ...input });
+            return { ts: String(r.ts), channel: String(r.channel) };
+        },
+        /** Edit a previously posted message in place (e.g. resolve an approval card). */
+        async update(input) {
+            await call("chat.update", input);
+        },
+        /** Delete one of the bot's own messages (dead-stream cleanup). */
+        async deleteMessage(input) {
+            await call("chat.delete", input);
+        },
+        /** Post a message only the given user sees (sign-in links, refusals). */
+        async postEphemeral(input) {
+            await call("chat.postEphemeral", input);
+        },
+        // ── Streaming (AI apps) ──────────────────────────────────────────────────
+        /**
+         * Open a streamed message. In a CHANNEL Slack requires `recipient_team_id`
+         * (`missing_recipient_team_id` otherwise); in the bot's DM it's optional.
+         */
+        async startStream(input) {
+            const r = await call("chat.startStream", input);
+            return { ts: String(r.ts), channel: String(r.channel) };
+        },
+        /**
+         * Append to a live stream. Throws `SlackApiError` with code
+         * `stopped_by_user` when the viewer pressed the native Stop button —
+         * callers treat that as a stop signal, not a failure.
+         */
+        async appendStream(input) {
+            await call("chat.appendStream", input);
+        },
+        /** Close a stream, optionally with final content and (≤50) blocks. */
+        async stopStream(input) {
+            await call("chat.stopStream", input);
+        },
+        // ── Agent sessions ───────────────────────────────────────────────────────
+        /**
+         * Set a session's lifecycle status (`processing` shows the working UI and,
+         * with the `agent_session_stopped` subscription, the Stop button). Creates
+         * the session if it doesn't exist. Status does NOT auto-clear.
+         */
+        async sessionsSetStatus(input) {
+            await call("agents.sessions.setStatus", input);
+        },
+        // ── Conversations ────────────────────────────────────────────────────────
+        /** Fetch a thread's messages (oldest first) — for seeding prior context. */
+        async threadReplies(channel, ts, limit = 50) {
+            const r = await call("conversations.replies", { channel, ts, limit: String(limit) });
+            const msgs = r.messages ?? [];
+            return msgs.map((m) => ({
+                userId: m.user ? String(m.user) : undefined,
+                text: typeof m.text === "string" ? m.text : "",
+                isBot: Boolean(m.bot_id) || m.subtype === "bot_message",
+                ts: String(m.ts),
+            }));
+        },
+        /** Channel history (newest first, as Slack returns it). */
+        async conversationsHistory(input) {
+            const r = await call("conversations.history", {
+                channel: input.channel,
+                limit: String(input.limit ?? 50),
+                ...(input.oldest ? { oldest: input.oldest } : {}),
+                ...(input.latest ? { latest: input.latest } : {}),
+            });
+            const msgs = r.messages ?? [];
+            return msgs.map((m) => ({
+                userId: m.user ? String(m.user) : undefined,
+                text: typeof m.text === "string" ? m.text : "",
+                isBot: Boolean(m.bot_id) || m.subtype === "bot_message",
+                ts: String(m.ts),
+                threadTs: m.thread_ts ? String(m.thread_ts) : undefined,
+            }));
+        },
+        /**
+         * ALL member ids of a conversation, paginated. `maxPages` bounds the walk;
+         * hitting the bound throws (callers gating access must fail CLOSED, never
+         * conclude "not a member" from a truncated list).
+         */
+        async conversationsMembers(channel, maxPages = 25) {
+            const members = [];
+            let cursor;
+            for (let page = 0; page < maxPages; page++) {
+                const r = await call("conversations.members", {
+                    channel,
+                    limit: "1000",
+                    ...(cursor ? { cursor } : {}),
+                });
+                for (const id of r.members ?? [])
+                    members.push(id);
+                cursor = r.response_metadata?.next_cursor;
+                if (!cursor)
+                    return members;
+            }
+            throw new SlackApiError("conversations.members", 200, "member_list_truncated");
+        },
+        /** Open (or fetch) a DM channel with a user; returns the IM channel id. */
+        async openDm(user) {
+            const r = await call("conversations.open", { users: user });
+            return String(r.channel?.id ?? "");
+        },
+        /**
+         * The channels this bot can post to, for pickers. PUBLIC channels only:
+         * the manifest asks for `channels:read` but deliberately not `groups:read`
+         * for listing purposes — a private channel never appears here and has to
+         * be entered by id. One page — a picker doesn't need to paginate a
+         * workspace, and Slack caps `limit` at 1000 anyway.
+         */
+        async conversationsList(limit = 200) {
+            const r = await call("conversations.list", {
+                exclude_archived: "true",
+                types: "public_channel",
+                limit: String(limit),
+            });
+            const channels = r.channels ?? [];
+            return channels.map((c) => ({ id: String(c.id), name: String(c.name ?? c.id) }));
+        },
+        /**
+         * v1 compatibility — the free-text assistant status line. Superseded by
+         * `sessionsSetStatus`; removed with the v1 channel.
+         * @deprecated
+         */
+        async setStatus(input) {
+            await call("assistant.threads.setStatus", input).catch(() => {
+                /* not an assistant thread / missing scope — status is best-effort */
+            });
+        },
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/slack/api.js.map

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

package/dist/slack/blocks.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Hand-rolled Slack Block Kit builders for the small surface a Latch channel
+ * needs. Answer text ships as native `markdown` blocks (Slack renders GFM —
+ * headings, tables, fenced code — itself); approval buttons carry SIGNED
+ * payloads built in payloads.ts. Hand-rolled to keep the package
+ * dependency-free — no Chat SDK runtime.
+ */
+export declare const APPROVE_ACTION = "latch_approve";
+export declare const DENY_ACTION = "latch_deny";
+/** The settled-approval card shown after a decision (replaces the buttons). */
+export declare function approvalResolvedBlocks(toolName: string, approved: boolean): unknown[];
+/** Ephemeral OAuth sign-in prompt for a `connect_<name>` approval. */
+export declare function connectBlocks(connectionName: string, authorizeUrl: string): unknown[];
+/** Slack's `markdown` block cap. */
+export declare const MARKDOWN_BLOCK_LIMIT = 12000;
+/**
+ * Split answer text into native `markdown` blocks — Slack renders headings,
+ * tables, fenced code and task lists itself, so the text goes through verbatim.
+ * Splits prefer a blank line, then a newline, then a space near the limit, so
+ * a boundary almost never lands mid-word (mid-code-fence remains possible for
+ * a single 12k+ fence — unsplittable by construction).
+ */
+export declare function markdownBlocks(text: string): unknown[];
+/** The plain-notification `text` fallback Slack shows in pings/previews. */
+export declare function notificationText(text: string): string;
+/** v2 approval card — same shape as v1 but the button value is a SIGNED payload. */
+export declare function approvalBlocksV2(signedValue: string, toolName: string, input: unknown): unknown[];
+/** Ephemeral sign-in card for a user who hasn't linked a Latch account. */
+export declare function signInCard(linkUrl: string, message?: string): unknown[];
+/**
+ * Error surface for a failed run. A plain section, deliberately: the 2026
+ * `alert` block would be nicer but its exact JSON shape isn't verifiable
+ * without a live workspace — swap in once confirmed in the dev workspace.
+ */
+export declare function errorBlocks(message: string): unknown[];
+//# sourceMappingURL=blocks.d.ts.map

package/dist/slack/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../src/slack/blocks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAC9C,eAAO,MAAM,WAAW,eAAe,CAAC;AAYxC,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,EAAE,CAYrF;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,EAAE,CAmBrF;AAED,oCAAoC;AACpC,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAmBtD;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,CA8BjG;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAsBvE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAOtD"}

package/dist/slack/blocks.js

@@ -0,0 +1,161 @@
+/**
+ * Hand-rolled Slack Block Kit builders for the small surface a Latch channel
+ * needs. Answer text ships as native `markdown` blocks (Slack renders GFM —
+ * headings, tables, fenced code — itself); approval buttons carry SIGNED
+ * payloads built in payloads.ts. Hand-rolled to keep the package
+ * dependency-free — no Chat SDK runtime.
+ */
+const SECTION_LIMIT = 2900; // Slack section text hard limit is 3000.
+export const APPROVE_ACTION = "latch_approve";
+export const DENY_ACTION = "latch_deny";
+function truncateJson(value, max = 2500) {
+    let s;
+    try {
+        s = JSON.stringify(value, null, 2) ?? String(value);
+    }
+    catch {
+        s = String(value);
+    }
+    return s.length > max ? `${s.slice(0, max)}\n… (truncated)` : s;
+}
+/** The settled-approval card shown after a decision (replaces the buttons). */
+export function approvalResolvedBlocks(toolName, approved) {
+    return [
+        {
+            type: "section",
+            text: {
+                type: "mrkdwn",
+                text: approved
+                    ? `:white_check_mark: Approved *${toolName}*`
+                    : `:x: Denied *${toolName}*`,
+            },
+        },
+    ];
+}
+/** Ephemeral OAuth sign-in prompt for a `connect_<name>` approval. */
+export function connectBlocks(connectionName, authorizeUrl) {
+    return [
+        {
+            type: "section",
+            text: { type: "mrkdwn", text: `Connect *${connectionName}* to continue.` },
+        },
+        {
+            type: "actions",
+            elements: [
+                {
+                    type: "button",
+                    action_id: "latch_connect_noop", // link button: handled by url, no callback
+                    style: "primary",
+                    text: { type: "plain_text", text: `Sign in to ${connectionName}` },
+                    url: authorizeUrl,
+                },
+            ],
+        },
+    ];
+}
+/** Slack's `markdown` block cap. */
+export const MARKDOWN_BLOCK_LIMIT = 12_000;
+/**
+ * Split answer text into native `markdown` blocks — Slack renders headings,
+ * tables, fenced code and task lists itself, so the text goes through verbatim.
+ * Splits prefer a blank line, then a newline, then a space near the limit, so
+ * a boundary almost never lands mid-word (mid-code-fence remains possible for
+ * a single 12k+ fence — unsplittable by construction).
+ */
+export function markdownBlocks(text) {
+    const blocks = [];
+    let rest = text;
+    while (rest.length > MARKDOWN_BLOCK_LIMIT) {
+        const window = rest.slice(0, MARKDOWN_BLOCK_LIMIT);
+        const cut = (() => {
+            const para = window.lastIndexOf("\n\n");
+            if (para > MARKDOWN_BLOCK_LIMIT / 2)
+                return para;
+            const line = window.lastIndexOf("\n");
+            if (line > MARKDOWN_BLOCK_LIMIT / 2)
+                return line;
+            const space = window.lastIndexOf(" ");
+            if (space > MARKDOWN_BLOCK_LIMIT / 2)
+                return space;
+            return MARKDOWN_BLOCK_LIMIT;
+        })();
+        blocks.push({ type: "markdown", text: rest.slice(0, cut) });
+        rest = rest.slice(cut).replace(/^\s+/, "");
+    }
+    blocks.push({ type: "markdown", text: rest.length ? rest : " " });
+    return blocks;
+}
+/** The plain-notification `text` fallback Slack shows in pings/previews. */
+export function notificationText(text) {
+    return text.replace(/\s+/g, " ").trim().slice(0, 200) || "New message";
+}
+/** v2 approval card — same shape as v1 but the button value is a SIGNED payload. */
+export function approvalBlocksV2(signedValue, toolName, input) {
+    const blocks = [
+        { type: "section", text: { type: "mrkdwn", text: `:lock: Approve *${toolName}*?` } },
+    ];
+    if (input !== undefined) {
+        blocks.push({
+            type: "section",
+            text: { type: "mrkdwn", text: "```" + truncateJson(input) + "```" },
+        });
+    }
+    blocks.push({
+        type: "actions",
+        elements: [
+            {
+                type: "button",
+                action_id: APPROVE_ACTION,
+                style: "primary",
+                text: { type: "plain_text", text: "Approve" },
+                value: signedValue,
+            },
+            {
+                type: "button",
+                action_id: DENY_ACTION,
+                style: "danger",
+                text: { type: "plain_text", text: "Deny" },
+                value: signedValue,
+            },
+        ],
+    });
+    return blocks;
+}
+/** Ephemeral sign-in card for a user who hasn't linked a Latch account. */
+export function signInCard(linkUrl, message) {
+    return [
+        {
+            type: "section",
+            text: {
+                type: "mrkdwn",
+                text: message ?? "Sign in to Latch to use this agent — takes a few seconds.",
+            },
+        },
+        {
+            type: "actions",
+            elements: [
+                {
+                    type: "button",
+                    action_id: "latch_link_noop", // link button: handled by url, no callback
+                    style: "primary",
+                    text: { type: "plain_text", text: "Sign in to Latch" },
+                    url: linkUrl,
+                },
+            ],
+        },
+    ];
+}
+/**
+ * Error surface for a failed run. A plain section, deliberately: the 2026
+ * `alert` block would be nicer but its exact JSON shape isn't verifiable
+ * without a live workspace — swap in once confirmed in the dev workspace.
+ */
+export function errorBlocks(message) {
+    return [
+        {
+            type: "section",
+            text: { type: "mrkdwn", text: `:warning: ${message.slice(0, SECTION_LIMIT - 20)}` },
+        },
+    ];
+}
+//# sourceMappingURL=blocks.js.map

package/dist/slack/blocks.js.map

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

package/dist/slack/ids.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Chat-id scheme v2 — `slack2_<app>_<channel>_<root>`.
+ *
+ * One Latch chat is one Slack conversation anchor:
+ *
+ *   slack2_A123_C456_1712345678.000100   a thread (channel thread OR a session
+ *                                        in the Agents pane — the pane is just
+ *                                        threads in the bot's DM channel)
+ *   slack2_A123_D789_dm                  the ONE chat for un-threaded messages
+ *                                        in a DM channel — plain DMs keep their
+ *                                        history instead of forking a new chat
+ *                                        per message
+ *
+ * The app id is mandatory: two bots in the same channel can never share a chat,
+ * by construction. The `agent_session_stopped` event carries `channel` +
+ * `thread_ts`, so a stop maps to its chat with a pure function — no reverse
+ * index.
+ *
+ * v1 ids (`slack_…`) deliberately do NOT parse. The v1 scheme had an unscoped
+ * legacy form whose "adopt the old chat" fallback carried a documented
+ * cross-app hole; v2 is a clean break.
+ */
+/** Root marker for the per-DM-channel chat (un-threaded messages). */
+export declare const DM_ROOT = "dm";
+export interface SlackChatRef {
+    /** Slack app id (`A…`) — the namespace. */
+    app: string;
+    /** Slack conversation id (`C…`/`G…`/`D…`). */
+    channel: string;
+    /** Thread root ts, or {@link DM_ROOT} for the un-threaded DM chat. */
+    root: string;
+}
+/** Build a v2 chat id. Throws on a malformed root — a bad id must never be minted. */
+export declare function slackChatId(app: string, channel: string, root: string): string;
+/**
+ * Parse a v2 chat id, or null for anything else — including every v1
+ * (`slack_…`) id, which is the clean break.
+ */
+export declare function parseSlackChatId(id: string): SlackChatRef | null;
+//# sourceMappingURL=ids.d.ts.map

package/dist/slack/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/slack/ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,sEAAsE;AACtE,eAAO,MAAM,OAAO,OAAO,CAAC;AAK5B,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAIhE"}

package/dist/slack/ids.js

@@ -0,0 +1,47 @@
+/**
+ * Chat-id scheme v2 — `slack2_<app>_<channel>_<root>`.
+ *
+ * One Latch chat is one Slack conversation anchor:
+ *
+ *   slack2_A123_C456_1712345678.000100   a thread (channel thread OR a session
+ *                                        in the Agents pane — the pane is just
+ *                                        threads in the bot's DM channel)
+ *   slack2_A123_D789_dm                  the ONE chat for un-threaded messages
+ *                                        in a DM channel — plain DMs keep their
+ *                                        history instead of forking a new chat
+ *                                        per message
+ *
+ * The app id is mandatory: two bots in the same channel can never share a chat,
+ * by construction. The `agent_session_stopped` event carries `channel` +
+ * `thread_ts`, so a stop maps to its chat with a pure function — no reverse
+ * index.
+ *
+ * v1 ids (`slack_…`) deliberately do NOT parse. The v1 scheme had an unscoped
+ * legacy form whose "adopt the old chat" fallback carried a documented
+ * cross-app hole; v2 is a clean break.
+ */
+/** Reversible segment escaping: `_` is the id separator, `%` the escape. */
+const encodeSeg = (v) => v.replace(/%/g, "%25").replace(/_/g, "%5F");
+const decodeSeg = (v) => v.replace(/%5F/g, "_").replace(/%25/g, "%");
+/** Root marker for the per-DM-channel chat (un-threaded messages). */
+export const DM_ROOT = "dm";
+/** A Slack message timestamp (`1712345678.000100`) — the only other root form. */
+const THREAD_ROOT = /^\d+\.\d+$/;
+/** Build a v2 chat id. Throws on a malformed root — a bad id must never be minted. */
+export function slackChatId(app, channel, root) {
+    if (root !== DM_ROOT && !THREAD_ROOT.test(root)) {
+        throw new Error(`slack chat id: invalid root ${JSON.stringify(root)}`);
+    }
+    return `slack2_${encodeSeg(app)}_${encodeSeg(channel)}_${root}`;
+}
+/**
+ * Parse a v2 chat id, or null for anything else — including every v1
+ * (`slack_…`) id, which is the clean break.
+ */
+export function parseSlackChatId(id) {
+    const m = /^slack2_([^_]+)_([^_]+)_(\d+\.\d+|dm)$/.exec(id);
+    if (!m)
+        return null;
+    return { app: decodeSeg(m[1]), channel: decodeSeg(m[2]), root: m[3] };
+}
+//# sourceMappingURL=ids.js.map

package/dist/slack/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/slack/ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,4EAA4E;AAC5E,MAAM,SAAS,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC7E,MAAM,SAAS,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE7E,sEAAsE;AACtE,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC;AAE5B,kFAAkF;AAClF,MAAM,WAAW,GAAG,YAAY,CAAC;AAWjC,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,OAAe,EAAE,IAAY;IACpE,IAAI,IAAI,KAAK,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,UAAU,SAAS,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,MAAM,CAAC,GAAG,wCAAwC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5D,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC;AAC3E,CAAC"}

package/dist/slack/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @intentface/latch-channels/slack
+ *
+ * The Slack adapter, v2: `slackChannel(...)` drives one agent's dedicated app
+ * (own-app-per-agent) — agent sessions, native streaming with task cards,
+ * initiator-owned threads, atomic turn admission. All hand-rolled Block Kit,
+ * no Chat SDK runtime dependency.
+ */
+export { slackChannel } from "./slackChannel.js";
+export type { SlackChannelConfig, SlackChatMeta, SlackThreadStore } from "./slackChannel.js";
+export { slackChatId, parseSlackChatId, DM_ROOT } from "./ids.js";
+export type { SlackChatRef } from "./ids.js";
+export { normalizeSlackText, isRenderableUserMessage } from "./normalize.js";
+export { encodeAction, decodeAction } from "./payloads.js";
+export type { ActionPayload } from "./payloads.js";
+export { renderSlackStream } from "./stream.js";
+export type { SlackStreamOptions, SlackStreamResult } from "./stream.js";
+export { slackManifest, createFromManifestUrl, SLACK_BOT_SCOPES } from "./manifest.js";
+export type { SlackManifestInput } from "./manifest.js";
+export { verifySlackSignature } from "./verify.js";
+export { slackApi, SlackApiError } from "./api.js";
+export type { SlackClient, SlackToken, SlackApiOptions, StreamChunk } from "./api.js";
+export { markdownBlocks, notificationText, approvalBlocksV2, approvalResolvedBlocks, connectBlocks, signInCard, errorBlocks, APPROVE_ACTION, DENY_ACTION, } from "./blocks.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/slack/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/slack/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAClE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACvF,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACtF,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,UAAU,EACV,WAAW,EACX,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/slack/index.js

@@ -0,0 +1,18 @@
+/**
+ * @intentface/latch-channels/slack
+ *
+ * The Slack adapter, v2: `slackChannel(...)` drives one agent's dedicated app
+ * (own-app-per-agent) — agent sessions, native streaming with task cards,
+ * initiator-owned threads, atomic turn admission. All hand-rolled Block Kit,
+ * no Chat SDK runtime dependency.
+ */
+export { slackChannel } from "./slackChannel.js";
+export { slackChatId, parseSlackChatId, DM_ROOT } from "./ids.js";
+export { normalizeSlackText, isRenderableUserMessage } from "./normalize.js";
+export { encodeAction, decodeAction } from "./payloads.js";
+export { renderSlackStream } from "./stream.js";
+export { slackManifest, createFromManifestUrl, SLACK_BOT_SCOPES } from "./manifest.js";
+export { verifySlackSignature } from "./verify.js";
+export { slackApi, SlackApiError } from "./api.js";
+export { markdownBlocks, notificationText, approvalBlocksV2, approvalResolvedBlocks, connectBlocks, signInCard, errorBlocks, APPROVE_ACTION, DENY_ACTION, } from "./blocks.js";
+//# sourceMappingURL=index.js.map

package/dist/slack/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/slack/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEnD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,UAAU,EACV,WAAW,EACX,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/slack/manifest.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Generate the Slack **app manifest** for a single agent's dedicated app. Used
+ * both ways: posted to `apps.manifest.create` (config-token / "one-button"
+ * flow), or shown to the user with a "Create from manifest" deep-link (manual
+ * flow). One app per agent → its own bot user and @-handle.
+ */
+export interface SlackManifestInput {
+    /** Display name + handle of the bot (the agent's title). */
+    displayName: string;
+    /** Short description shown in Slack's app directory. */
+    description?: string;
+    /** The single webhook URL Slack sends events + interactions + commands to. */
+    requestUrl: string;
+    /** OAuth redirect URL (the install callback) — required for install flow. */
+    redirectUrl?: string;
+}
+/** Bot scopes for the supported feature set (mentions, DMs, posting, status). */
+export declare const SLACK_BOT_SCOPES: string[];
+/** Build the Slack manifest object (JSON-serializable). */
+export declare function slackManifest(input: SlackManifestInput): Record<string, unknown>;
+/** A pre-filled "Create New App → From a manifest" deep-link for the manual flow. */
+export declare function createFromManifestUrl(manifest: Record<string, unknown>): string;
+//# sourceMappingURL=manifest.d.ts.map