slack-axi 0.1.0

package/dist/src/slack/client.js

@@ -0,0 +1,39 @@
+import { WebClient } from "@slack/web-api";
+/** Build a Slack Web API client for a token. The SDK handles tiered rate-limit retry. */
+export function webClient(token) {
+    return new WebClient(token, { retryConfig: { retries: 3 } });
+}
+/**
+ * Validate a token via auth.test and capture granted scopes.
+ *
+ * Uses a direct fetch (not WebClient) because the granted scopes are returned in the
+ * `x-oauth-scopes` response header, which we want alongside the body in a single call —
+ * the reliable source for scope-coverage checks (see specs/behaviors/auth-and-workspaces.md).
+ * Throws the raw Slack error code (string) on failure for the caller to translate.
+ */
+export async function validateToken(token) {
+    const res = await fetch("https://slack.com/api/auth.test", {
+        method: "POST",
+        headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/x-www-form-urlencoded" },
+    });
+    const scopes = (res.headers.get("x-oauth-scopes") ?? "")
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    const body = (await res.json());
+    if (!body.ok) {
+        // Throw the bare Slack error code; callers translate via slackErrorToAxi.
+        throw Object.assign(new Error(body.error ?? "invalid_auth"), {
+            data: { error: body.error ?? "invalid_auth" },
+        });
+    }
+    return {
+        teamId: body.team_id ?? "",
+        teamName: body.team ?? "",
+        userId: body.user_id ?? "",
+        userName: body.user,
+        url: body.url,
+        scopes,
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/src/slack/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/slack/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAY3C,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,IAAI,SAAS,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAa;IAC/C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,iCAAiC,EAAE;QACzD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE;KACnG,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;SACrD,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAQ7B,CAAC;IAEF,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,0EAA0E;QAC1E,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,cAAc,CAAC,EAAE;YAC3D,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,cAAc,EAAE;SAC9C,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;QAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;QACzB,MAAM,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;QAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI;QACnB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/src/slack/errors.d.ts

@@ -0,0 +1,14 @@
+import { AxiError } from "axi-sdk-js";
+/**
+ * Translate a Slack API error code into a structured AxiError with an actionable suggestion.
+ * See specs/behaviors/errors.md. Raw Slack/SDK payloads never reach the agent.
+ */
+export declare function slackErrorToAxi(code: string, context?: {
+    team?: string;
+    channel?: string;
+}): AxiError;
+/** Coerce an unknown thrown value (incl. @slack/web-api errors) into an AxiError. */
+export declare function toAxiError(err: unknown, context?: {
+    team?: string;
+    channel?: string;
+}): AxiError;

package/dist/src/slack/errors.js

@@ -0,0 +1,54 @@
+import { AxiError } from "axi-sdk-js";
+/**
+ * Translate a Slack API error code into a structured AxiError with an actionable suggestion.
+ * See specs/behaviors/errors.md. Raw Slack/SDK payloads never reach the agent.
+ */
+export function slackErrorToAxi(code, context = {}) {
+    const teamFlag = context.team ? ` --team ${context.team}` : "";
+    switch (code) {
+        case "invalid_auth":
+        case "token_revoked":
+        case "token_expired":
+        case "account_inactive":
+            return new AxiError("Slack token is invalid or revoked", "AUTH_INVALID", [`Run \`slack-axi auth login${teamFlag} --token xoxp-...\` to store a valid token`]);
+        case "not_authed":
+            return new AxiError("No Slack token was supplied", "NO_TOKEN", ["Set SLACK_AXI_TOKEN or run `slack-axi auth login`"]);
+        case "missing_scope":
+            return new AxiError("Token is missing a required scope", "SCOPE_MISSING", ["Re-run `slack-axi auth setup`, add the missing scope, and re-install the app"]);
+        case "channel_not_found":
+            return new AxiError(context.channel ? `Channel '${context.channel}' not found` : "Channel not found", "CHANNEL_NOT_FOUND", [
+                "Run `slack-axi channels` to list your channels",
+                "Or `slack-axi search channels <query>` to find one by name",
+            ]);
+        case "not_in_channel":
+            return new AxiError(context.channel ? `You are not a member of '${context.channel}'` : "Not a member of that channel", "NOT_IN_CHANNEL", ["Join the channel in Slack, or use `slack-axi channels --all` to confirm the id"]);
+        case "thread_not_found":
+        case "message_not_found":
+            return new AxiError("Message or thread not found", "MESSAGE_NOT_FOUND", ["Check the ts; run `slack-axi read <channel>` to find the message"]);
+        case "ratelimited":
+            return new AxiError("Slack rate limit exceeded after retries", "RATE_LIMITED", ["Wait a moment and retry; narrow the time window or lower --limit"]);
+        default:
+            return new AxiError(`Slack API error: ${code}`, "SLACK_ERROR", ["Run `slack-axi doctor` to check auth and scopes"]);
+    }
+}
+/** Coerce an unknown thrown value (incl. @slack/web-api errors) into an AxiError. */
+export function toAxiError(err, context = {}) {
+    if (err instanceof AxiError)
+        return err;
+    const code = extractSlackErrorCode(err);
+    if (code)
+        return slackErrorToAxi(code, context);
+    const message = err instanceof Error ? err.message : String(err);
+    return new AxiError(`Unexpected error: ${message}`, "INTERNAL_ERROR", [
+        "Run `slack-axi doctor` to check auth and runtime health",
+    ]);
+}
+function extractSlackErrorCode(err) {
+    if (!err || typeof err !== "object")
+        return undefined;
+    const data = err.data;
+    if (data && typeof data.error === "string")
+        return data.error;
+    return undefined;
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/slack/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/slack/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,UAA+C,EAAE;IAC7F,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,cAAc,CAAC;QACpB,KAAK,eAAe,CAAC;QACrB,KAAK,eAAe,CAAC;QACrB,KAAK,kBAAkB;YACrB,OAAO,IAAI,QAAQ,CACjB,mCAAmC,EACnC,cAAc,EACd,CAAC,6BAA6B,QAAQ,4CAA4C,CAAC,CACpF,CAAC;QACJ,KAAK,YAAY;YACf,OAAO,IAAI,QAAQ,CACjB,6BAA6B,EAC7B,UAAU,EACV,CAAC,mDAAmD,CAAC,CACtD,CAAC;QACJ,KAAK,eAAe;YAClB,OAAO,IAAI,QAAQ,CACjB,mCAAmC,EACnC,eAAe,EACf,CAAC,8EAA8E,CAAC,CACjF,CAAC;QACJ,KAAK,mBAAmB;YACtB,OAAO,IAAI,QAAQ,CACjB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,OAAO,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,mBAAmB,EAChF,mBAAmB,EACnB;gBACE,gDAAgD;gBAChD,4DAA4D;aAC7D,CACF,CAAC;QACJ,KAAK,gBAAgB;YACnB,OAAO,IAAI,QAAQ,CACjB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,4BAA4B,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,8BAA8B,EACjG,gBAAgB,EAChB,CAAC,gFAAgF,CAAC,CACnF,CAAC;QACJ,KAAK,kBAAkB,CAAC;QACxB,KAAK,mBAAmB;YACtB,OAAO,IAAI,QAAQ,CACjB,6BAA6B,EAC7B,mBAAmB,EACnB,CAAC,kEAAkE,CAAC,CACrE,CAAC;QACJ,KAAK,aAAa;YAChB,OAAO,IAAI,QAAQ,CACjB,yCAAyC,EACzC,cAAc,EACd,CAAC,kEAAkE,CAAC,CACrE,CAAC;QACJ;YACE,OAAO,IAAI,QAAQ,CACjB,oBAAoB,IAAI,EAAE,EAC1B,aAAa,EACb,CAAC,iDAAiD,CAAC,CACpD,CAAC;IACN,CAAC;AACH,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,UAAU,CAAC,GAAY,EAAE,UAA+C,EAAE;IACxF,IAAI,GAAG,YAAY,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,MAAM,IAAI,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,IAAI;QAAE,OAAO,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,IAAI,QAAQ,CAAC,qBAAqB,OAAO,EAAE,EAAE,gBAAgB,EAAE;QACpE,yDAAyD;KAC1D,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,GAAY;IACzC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,IAAI,GAAI,GAAsC,CAAC,IAAI,CAAC;IAC1D,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC;IAC9D,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/slack/format.d.ts

@@ -0,0 +1,8 @@
+import type { UserMeta } from "./cache.js";
+/** A human label for a user id from a pre-loaded users map (display → real → handle → id). */
+export declare function userName(id: string, users: Record<string, UserMeta>): string;
+/**
+ * Resolve Slack markup to readable text: `<@U|name>` mentions, `<#C|name>` channels, `<url|label>`
+ * links, and basic entity decoding. Used by `read`, `thread`, and `search` output.
+ */
+export declare function formatText(text: string, users: Record<string, UserMeta>): string;

package/dist/src/slack/format.js

@@ -0,0 +1,20 @@
+/** A human label for a user id from a pre-loaded users map (display → real → handle → id). */
+export function userName(id, users) {
+    const u = users[id];
+    return u ? u.display_name || u.real_name || u.name || id : id;
+}
+/**
+ * Resolve Slack markup to readable text: `<@U|name>` mentions, `<#C|name>` channels, `<url|label>`
+ * links, and basic entity decoding. Used by `read`, `thread`, and `search` output.
+ */
+export function formatText(text, users) {
+    return text
+        .replace(/<@(U[A-Z0-9]+)(?:\|([^>]+))?>/g, (_m, id, name) => `@${name || userName(id, users)}`)
+        .replace(/<#C[A-Z0-9]+\|([^>]+)>/g, (_m, name) => `#${name}`)
+        .replace(/<(https?:[^|>]+)\|([^>]+)>/g, (_m, _url, label) => label)
+        .replace(/<(https?:[^>]+)>/g, (_m, url) => url)
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">");
+}
+//# sourceMappingURL=format.js.map

package/dist/src/slack/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/slack/format.ts"],"names":[],"mappings":"AAEA,8FAA8F;AAC9F,MAAM,UAAU,QAAQ,CAAC,EAAU,EAAE,KAA+B;IAClE,MAAM,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC;IACpB,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAA+B;IACtE,OAAO,IAAI;SACR,OAAO,CAAC,gCAAgC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC;SAC9F,OAAO,CAAC,yBAAyB,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;SAC5D,OAAO,CAAC,6BAA6B,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;SAClE,OAAO,CAAC,mBAAmB,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC;SAC9C,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAC3B,CAAC"}

package/dist/src/slack/permalink.d.ts

@@ -0,0 +1,7 @@
+import type { Session } from "../session.js";
+/**
+ * The canonical permalink for a message, via chat.getPermalink (handles thread replies and the
+ * workspace subdomain automatically). slack-axi owns this — the agent never assembles a permalink.
+ * See specs/behaviors/permalinks.md.
+ */
+export declare function getPermalink(session: Session, channel: string, ts: string): Promise<string>;

package/dist/src/slack/permalink.js

@@ -0,0 +1,10 @@
+/**
+ * The canonical permalink for a message, via chat.getPermalink (handles thread replies and the
+ * workspace subdomain automatically). slack-axi owns this — the agent never assembles a permalink.
+ * See specs/behaviors/permalinks.md.
+ */
+export async function getPermalink(session, channel, ts) {
+    const res = await session.client.chat.getPermalink({ channel, message_ts: ts });
+    return typeof res.permalink === "string" ? res.permalink : "";
+}
+//# sourceMappingURL=permalink.js.map

package/dist/src/slack/permalink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permalink.js","sourceRoot":"","sources":["../../../src/slack/permalink.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAgB,EAAE,OAAe,EAAE,EAAU;IAC9E,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IAChF,OAAO,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;AAChE,CAAC"}

package/dist/src/slack/resolve.d.ts

@@ -0,0 +1,22 @@
+import type { Session } from "../session.js";
+import { type ChannelMeta } from "./cache.js";
+export declare function looksLikeId(arg: string): boolean;
+/** Strip a leading `#` and surrounding whitespace from a channel argument. */
+export declare function normalizeChannelArg(arg: string): string;
+/**
+ * Resolve `#name`, bare `name`, or an id to a ChannelMeta. Cache-backed; on a name miss it refreshes
+ * (member channels, then the whole workspace) before giving up with fuzzy suggestions. See
+ * specs/behaviors/resolution-and-caching.md.
+ */
+export declare function resolveChannel(session: Session, arg: string): Promise<ChannelMeta>;
+/** Rank cached channels by name similarity to a query (substring/prefix), best first. */
+export declare function fuzzyChannelMatches(channels: ChannelMeta[], query: string, limit: number): ChannelMeta[];
+/** A human label for a user id (display name → real name → handle → id). Cache-backed. */
+export declare function userLabel(session: Session, id: string): Promise<string>;
+/** A human label for a channel: `#name` for channels, `@user` for a DM, participants for a group DM. */
+export declare function channelLabel(session: Session, meta: ChannelMeta): Promise<string>;
+/**
+ * Slack names group DMs `mpdm-<handle>--<handle>--<handle>-1`, so participants are derivable from the
+ * name with no API call. Falls back to the raw name if the pattern doesn't match.
+ */
+export declare function parseMpimName(name: string): string;

package/dist/src/slack/resolve.js

@@ -0,0 +1,118 @@
+import { AxiError } from "axi-sdk-js";
+import { cachedChannels, cachedUser, ensureUsers, fetchChannelInfo, getCachedChannel, getChannels, refreshAllChannels, } from "./cache.js";
+/** Slack channel ids start with C (public), G (private/mpim), or D (im), then uppercase alphanumerics. */
+const ID_RE = /^[CGD][A-Z0-9]{6,}$/;
+export function looksLikeId(arg) {
+    return ID_RE.test(arg);
+}
+/** Strip a leading `#` and surrounding whitespace from a channel argument. */
+export function normalizeChannelArg(arg) {
+    return arg.trim().replace(/^#/, "");
+}
+/**
+ * Resolve `#name`, bare `name`, or an id to a ChannelMeta. Cache-backed; on a name miss it refreshes
+ * (member channels, then the whole workspace) before giving up with fuzzy suggestions. See
+ * specs/behaviors/resolution-and-caching.md.
+ */
+export async function resolveChannel(session, arg) {
+    const raw = normalizeChannelArg(arg);
+    if (looksLikeId(raw)) {
+        const cached = getCachedChannel(session.teamId, raw);
+        if (cached)
+            return cached;
+        try {
+            return await fetchChannelInfo(session, raw);
+        }
+        catch {
+            throw new AxiError(`Channel id '${raw}' not found or inaccessible`, "CHANNEL_NOT_FOUND", [
+                "Run `slack-axi channels` to list your channels",
+            ]);
+        }
+    }
+    // Name lookup, refreshing the cache on a miss before failing.
+    const target = raw.toLowerCase();
+    let channels = await getChannels(session);
+    let hit = channels.find((c) => c.name.toLowerCase() === target);
+    if (!hit) {
+        channels = await refreshAllChannels(session);
+        channels = cachedChannels(session.teamId);
+        hit = channels.find((c) => c.name.toLowerCase() === target);
+    }
+    if (hit)
+        return hit;
+    throw new AxiError(`Channel '${raw}' not found`, "CHANNEL_NOT_FOUND", [
+        ...suggestionsFor(channels, target),
+        "Run `slack-axi channels` to list your channels, or `--all` to include unjoined ones",
+    ]);
+}
+function suggestionsFor(channels, target) {
+    const matches = suggestChannels(channels, target, 5);
+    return matches.length > 0 ? [`Did you mean: ${matches.map((c) => `#${c.name} (${c.id})`).join(", ")}`] : [];
+}
+function commonPrefixLen(a, b) {
+    const n = Math.min(a.length, b.length);
+    let i = 0;
+    while (i < n && a[i] === b[i])
+        i++;
+    return i;
+}
+/**
+ * Lenient "did you mean" ranking for a not-found name: substring either direction scores highest,
+ * otherwise shared-prefix length. Surfaces near-misses (`bid-rtd-xyz` → `bid-rtd-*`) that a strict
+ * substring filter would miss.
+ */
+function suggestChannels(channels, query, limit) {
+    const q = query.toLowerCase();
+    const scored = channels
+        .filter((c) => c.name)
+        .map((c) => {
+        const name = c.name.toLowerCase();
+        const contains = name.includes(q) || q.includes(name);
+        const score = (contains ? 1000 : 0) + commonPrefixLen(name, q);
+        return { c, score };
+    })
+        .filter((s) => s.score >= 3)
+        .sort((a, b) => b.score - a.score || a.c.name.length - b.c.name.length || a.c.name.localeCompare(b.c.name));
+    return scored.slice(0, limit).map((s) => s.c);
+}
+/** Rank cached channels by name similarity to a query (substring/prefix), best first. */
+export function fuzzyChannelMatches(channels, query, limit) {
+    const q = query.toLowerCase();
+    return channels
+        .filter((c) => c.name && c.name.toLowerCase().includes(q))
+        .sort((a, b) => {
+        const ap = a.name.toLowerCase().startsWith(q) ? 0 : 1;
+        const bp = b.name.toLowerCase().startsWith(q) ? 0 : 1;
+        return ap - bp || a.name.length - b.name.length || a.name.localeCompare(b.name);
+    })
+        .slice(0, limit);
+}
+/** A human label for a user id (display name → real name → handle → id). Cache-backed. */
+export async function userLabel(session, id) {
+    await ensureUsers(session);
+    const u = cachedUser(session.teamId, id);
+    if (!u)
+        return id;
+    return u.display_name || u.real_name || u.name || id;
+}
+/** A human label for a channel: `#name` for channels, `@user` for a DM, participants for a group DM. */
+export async function channelLabel(session, meta) {
+    if (meta.type === "im") {
+        const who = meta.user ? await userLabel(session, meta.user) : "unknown";
+        return `@${who}`;
+    }
+    if (meta.type === "mpim")
+        return parseMpimName(meta.name);
+    return `#${meta.name}`;
+}
+/**
+ * Slack names group DMs `mpdm-<handle>--<handle>--<handle>-1`, so participants are derivable from the
+ * name with no API call. Falls back to the raw name if the pattern doesn't match.
+ */
+export function parseMpimName(name) {
+    const m = name.match(/^mpdm-(.+)-\d+$/);
+    if (!m)
+        return name || "(group dm)";
+    return m[1].split("--").join(", ");
+}
+//# sourceMappingURL=resolve.js.map

package/dist/src/slack/resolve.js.map

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

package/dist/src/slack/scopes.d.ts

@@ -0,0 +1,7 @@
+/** User-token scopes slack-axi needs. See specs/behaviors/auth-and-workspaces.md. */
+export declare const READ_SCOPES: readonly ["channels:read", "groups:read", "im:read", "mpim:read", "channels:history", "groups:history", "im:history", "mpim:history", "search:read", "users:read", "reactions:read"];
+/** Scopes needed for reactions + drafts (read + safe-draft capability set). */
+export declare const WRITE_SCOPES: readonly ["reactions:write", "chat:write"];
+export declare const REQUIRED_SCOPES: string[];
+/** Granted scopes missing from the required set. */
+export declare function missingScopes(granted: string[]): string[];

package/dist/src/slack/scopes.js

@@ -0,0 +1,23 @@
+/** User-token scopes slack-axi needs. See specs/behaviors/auth-and-workspaces.md. */
+export const READ_SCOPES = [
+    "channels:read",
+    "groups:read",
+    "im:read",
+    "mpim:read",
+    "channels:history",
+    "groups:history",
+    "im:history",
+    "mpim:history",
+    "search:read",
+    "users:read",
+    "reactions:read",
+];
+/** Scopes needed for reactions + drafts (read + safe-draft capability set). */
+export const WRITE_SCOPES = ["reactions:write", "chat:write"];
+export const REQUIRED_SCOPES = [...READ_SCOPES, ...WRITE_SCOPES];
+/** Granted scopes missing from the required set. */
+export function missingScopes(granted) {
+    const have = new Set(granted);
+    return REQUIRED_SCOPES.filter((scope) => !have.has(scope));
+}
+//# sourceMappingURL=scopes.js.map

package/dist/src/slack/scopes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopes.js","sourceRoot":"","sources":["../../../src/slack/scopes.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,eAAe;IACf,aAAa;IACb,SAAS;IACT,WAAW;IACX,kBAAkB;IAClB,gBAAgB;IAChB,YAAY;IACZ,cAAc;IACd,aAAa;IACb,YAAY;IACZ,gBAAgB;CACR,CAAC;AAEX,+EAA+E;AAC/E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,iBAAiB,EAAE,YAAY,CAAU,CAAC;AAEvE,MAAM,CAAC,MAAM,eAAe,GAAa,CAAC,GAAG,WAAW,EAAE,GAAG,YAAY,CAAC,CAAC;AAE3E,oDAAoD;AACpD,MAAM,UAAU,aAAa,CAAC,OAAiB;IAC7C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/src/slack/threads.d.ts

@@ -0,0 +1,24 @@
+import type { Session } from "../session.js";
+/** A normalized Slack message (top-level or reply). */
+export interface Msg {
+    ts: string;
+    user?: string;
+    botId?: string;
+    subtype?: string;
+    text: string;
+    replyCount: number;
+    threadTs?: string;
+    latestReply?: string;
+}
+export declare function isBot(msg: Msg): boolean;
+/**
+ * All top-level messages in the half-open window `[oldestMs, endMs)`, paginated to completion, returned
+ * oldest→newest regardless of the API's native page order. The upper bound is exclusive (`latest` is
+ * one microsecond before `endMs`) so adjacent windows/batches tile with no gap and no overlap.
+ * See specs/behaviors/time-and-completeness.md.
+ */
+export declare function fetchWindow(session: Session, channelId: string, oldestMs: number, endMs: number): Promise<Msg[]>;
+/** A whole thread (parent + replies), paginated to completion, oldest→newest. */
+export declare function fetchThread(session: Session, channelId: string, parentTs: string): Promise<Msg[]>;
+/** Replies to a thread, excluding the parent. */
+export declare function fetchReplies(session: Session, channelId: string, parentTs: string): Promise<Msg[]>;

package/dist/src/slack/threads.js

@@ -0,0 +1,63 @@
+import { epochMsToTs, tsExclusiveBefore } from "./time.js";
+export function isBot(msg) {
+    return Boolean(msg.botId) || msg.subtype === "bot_message";
+}
+function toMsg(raw) {
+    return {
+        ts: String(raw.ts),
+        ...(typeof raw.user === "string" ? { user: raw.user } : {}),
+        ...(typeof raw.bot_id === "string" ? { botId: raw.bot_id } : {}),
+        ...(typeof raw.subtype === "string" ? { subtype: raw.subtype } : {}),
+        text: typeof raw.text === "string" ? raw.text : "",
+        replyCount: typeof raw.reply_count === "number" ? raw.reply_count : 0,
+        ...(typeof raw.thread_ts === "string" ? { threadTs: raw.thread_ts } : {}),
+        ...(typeof raw.latest_reply === "string" ? { latestReply: raw.latest_reply } : {}),
+    };
+}
+const byTsAsc = (a, b) => Number.parseFloat(a.ts) - Number.parseFloat(b.ts);
+/**
+ * All top-level messages in the half-open window `[oldestMs, endMs)`, paginated to completion, returned
+ * oldest→newest regardless of the API's native page order. The upper bound is exclusive (`latest` is
+ * one microsecond before `endMs`) so adjacent windows/batches tile with no gap and no overlap.
+ * See specs/behaviors/time-and-completeness.md.
+ */
+export async function fetchWindow(session, channelId, oldestMs, endMs) {
+    const messages = [];
+    let cursor;
+    do {
+        const res = await session.client.conversations.history({
+            channel: channelId,
+            oldest: epochMsToTs(oldestMs),
+            latest: tsExclusiveBefore(endMs),
+            inclusive: true,
+            limit: 200,
+            ...(cursor ? { cursor } : {}),
+        });
+        for (const m of res.messages ?? [])
+            messages.push(toMsg(m));
+        cursor = res.has_more ? res.response_metadata?.next_cursor || undefined : undefined;
+    } while (cursor);
+    return messages.sort(byTsAsc);
+}
+/** A whole thread (parent + replies), paginated to completion, oldest→newest. */
+export async function fetchThread(session, channelId, parentTs) {
+    const messages = [];
+    let cursor;
+    do {
+        const res = await session.client.conversations.replies({
+            channel: channelId,
+            ts: parentTs,
+            limit: 200,
+            ...(cursor ? { cursor } : {}),
+        });
+        for (const m of res.messages ?? [])
+            messages.push(toMsg(m));
+        cursor = res.has_more ? res.response_metadata?.next_cursor || undefined : undefined;
+    } while (cursor);
+    return messages.sort(byTsAsc);
+}
+/** Replies to a thread, excluding the parent. */
+export async function fetchReplies(session, channelId, parentTs) {
+    return (await fetchThread(session, channelId, parentTs)).filter((m) => m.ts !== parentTs);
+}
+//# sourceMappingURL=threads.js.map

package/dist/src/slack/threads.js.map

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

package/dist/src/slack/time.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Human time in, Slack ts out — the year-correctness guard. The agent never produces an epoch; we
+ * parse spans/dates in a timezone (Eastern by default) and echo the resolved window back with explicit
+ * year. See specs/behaviors/time-and-completeness.md. All functions are pure (now is injected).
+ */
+export declare const DEFAULT_TZ = "America/New_York";
+export interface ResolvedWindow {
+    /** Inclusive lower bound, epoch ms. */
+    oldestMs: number;
+    /** **Exclusive** upper bound, epoch ms — the window is the half-open `[oldestMs, endMs)`. */
+    endMs: number;
+    tz: string;
+}
+/** Parse a relative span like `90m`, `24h`, `7d`, `2w` into milliseconds; undefined if it doesn't match. */
+export declare function parseSpanMs(input: string): number | undefined;
+/** Resolve `--since` / `--from` / `--to` into an explicit window. Defaults to the last 7 days. */
+export declare function resolveWindow(opts: {
+    since?: string;
+    from?: string;
+    to?: string;
+    tz?: string;
+}, now: number): ResolvedWindow;
+/**
+ * Tile a window into half-open `[start, end)` batches of `everyMs`. Adjacent batches share a boundary
+ * instant (one batch's `endMs` == the next's `startMs`), so the set has no gap and no overlap; the
+ * final batch's `endMs` is exactly the window's end. See specs/commands/catchup.md.
+ */
+export declare function batchWindows(oldestMs: number, endMs: number, everyMs: number): Array<{
+    startMs: number;
+    endMs: number;
+}>;
+/** `YYYY-MM-DD` in tz. */
+export declare function formatDate(epochMs: number, tz: string): string;
+/** `HH:MM` in tz (24h). */
+export declare function formatTime(epochMs: number, tz: string): string;
+/** `YYYY-MM-DD HH:MM` in tz — used in the resolved-range echo so the year is always explicit. */
+export declare function formatDateTime(epochMs: number, tz: string): string;
+/** The resolved-range header value, e.g. `2026-05-30 09:14 → 2026-06-06 09:14 (America/New_York)`.
+ *  endMs is exclusive, so the displayed upper bound is `endMs − 1` (the last instant actually covered). */
+export declare function formatRange(w: ResolvedWindow): string;
+/** Slack ts (`1717589640.123456`) → epoch ms. */
+export declare function tsToEpochMs(ts: string): number;
+/** epoch ms → Slack ts string (seconds.microseconds), exact integer math. */
+export declare function epochMsToTs(epochMs: number): string;
+/** Slack ts one microsecond *before* an instant — the inclusive `latest` for a half-open `[…, endMs)`. */
+export declare function tsExclusiveBefore(endMs: number): string;