slack-axi 0.1.0

package/dist/src/commands/read.js

@@ -0,0 +1,178 @@
+import { AxiError } from "axi-sdk-js";
+import { takeBool, takeFlag } from "../flags.js";
+import { encodeObject, joinBlocks, renderHelp, renderList, truncate } from "../output.js";
+import { activeSession } from "../session.js";
+import { allCachedUsers, ensureUsers } from "../slack/cache.js";
+import { formatText, userName } from "../slack/format.js";
+import { getPermalink } from "../slack/permalink.js";
+import { channelLabel, resolveChannel } from "../slack/resolve.js";
+import { fetchReplies, fetchThread, fetchWindow, isBot } from "../slack/threads.js";
+import { formatDate, formatDateTime, formatRange, formatTime, resolveWindow, tsToEpochMs } from "../slack/time.js";
+import { dottedTs, handle } from "../slack/ts.js";
+export const READ_HELP = `usage: slack-axi read <channel> [flags]
+Reads a channel over a time window, threads inlined, paginated to completion.
+flags[8]:
+  --since <span>   Relative window ending now: 7d, 24h, 90m (default: 7d)
+  --from <when>    Window start: date (2026-04-23), datetime (2026-04-23T14:00), or span
+  --to <when>      Window end (default: now)
+  --tz <zone>      Timezone for parsing + display (default: America/New_York)
+  --limit <n>      Max top-level messages to show (default: 50)
+  --threads <m>    full | summary | none (default: full)
+  --exclude-bots   Drop bot/automation messages
+  --cite           Add a permalink column (for bulk citation); else use ts + \`cite\`
+  --full           Don't truncate message text
+examples:
+  slack-axi read #bid-rtd-analytics
+  slack-axi read #eng --from 2026-04-23 --to 2026-04-29
+  slack-axi read #eng --since 24h --threads summary`;
+export const THREAD_HELP = `usage: slack-axi thread <channel> <ts>
+Reads a single thread fully (parent + all replies), names + permalinks resolved.`;
+const DEFAULT_LIMIT = 50;
+export async function readCommand(args) {
+    if (args.includes("--help"))
+        return READ_HELP;
+    const f = parseReadFlags(args);
+    if (!f.channel)
+        throw new AxiError("usage: slack-axi read <channel> [flags]", "USAGE", []);
+    const session = await activeSession({ teamFlag: f.team });
+    const channel = await resolveChannel(session, f.channel);
+    const window = resolveWindow({ since: f.since, from: f.from, to: f.to, tz: f.tz }, Date.now());
+    let parents = await fetchWindow(session, channel.id, window.oldestMs, window.endMs);
+    let botFiltered = 0;
+    if (f.excludeBots) {
+        const before = parents.length;
+        parents = parents.filter((m) => !isBot(m));
+        botFiltered = before - parents.length;
+    }
+    const label = await channelLabel(session, channel);
+    const header = {
+        workspace: `${session.teamName ?? session.teamId} (${session.teamId})`,
+        channel: `${label} (${channel.id}, ${channel.type})`,
+        range: formatRange(window),
+    };
+    if (parents.length === 0) {
+        header.messages = `0 messages in ${label} between ${formatDate(window.oldestMs, window.tz)} and ${formatDate(window.endMs - 1, window.tz)} (${window.tz})`;
+        return joinBlocks(encodeObject(header), renderHelp(["Widen the window with `--since 30d` or `--from <date>`"]));
+    }
+    const total = parents.length;
+    const complete = total <= f.limit;
+    const displayed = complete ? parents : parents.slice(-f.limit);
+    await ensureUsers(session);
+    const users = allCachedUsers(session.teamId);
+    // Build date-grouped blocks: each displayed parent followed by its inlined replies (a thread is a unit).
+    const groups = new Map();
+    for (const parent of displayed) {
+        const date = formatDate(tsToEpochMs(parent.ts), window.tz);
+        const rows = groups.get(date) ?? [];
+        rows.push(await buildRow(session, channel.id, parent, users, window.tz, f, false));
+        if (parent.replyCount > 0 && f.threads === "full") {
+            const replies = await fetchReplies(session, channel.id, parent.ts);
+            for (const r of replies)
+                rows.push(await buildRow(session, channel.id, r, users, window.tz, f, true));
+        }
+        else if (parent.replyCount > 0 && f.threads === "summary") {
+            rows.push({ time: "", author: "", text: `↳ ${parent.replyCount} repl${parent.replyCount === 1 ? "y" : "ies"} (use \`thread ${channel.id} ${parent.ts}\`)`, ts: "" });
+        }
+        groups.set(date, rows);
+    }
+    header.messages = `${displayed.length} of ${total} top-level (threads inlined below)`;
+    header.complete = complete;
+    if (botFiltered > 0)
+        header.bot_filtered = botFiltered;
+    const blocks = [encodeObject(header)];
+    for (const [date, rows] of groups)
+        blocks.push(`${date}:\n${indentLines(renderList("messages", rows), 2)}`);
+    const help = [
+        f.threads !== "full" ? `Run \`slack-axi thread ${channel.id} <ts>\` to expand a thread` : undefined,
+        !complete ? `Showing the most recent ${f.limit} of ${total}; raise \`--limit <n>\` or narrow the window` : undefined,
+        !f.cite ? `Run \`slack-axi cite ${channel.id} <ts...>\` for permalinks to messages you cite` : undefined,
+    ].filter((l) => Boolean(l));
+    return joinBlocks(...blocks, renderHelp(help));
+}
+export async function threadCommand(args) {
+    if (args.includes("--help"))
+        return THREAD_HELP;
+    const team = takeFlag(args, "--team");
+    const full = takeBool(team.rest, "--full");
+    const positional = full.rest.filter((a) => !a.startsWith("-"));
+    const [target, ts] = positional;
+    if (!target || !ts)
+        throw new AxiError("usage: slack-axi thread <channel> <ts>", "USAGE", []);
+    const session = await activeSession({ teamFlag: team.value });
+    const channel = await resolveChannel(session, target);
+    const msgs = await fetchThread(session, channel.id, dottedTs(ts));
+    if (msgs.length === 0)
+        throw new AxiError("Thread not found", "MESSAGE_NOT_FOUND", ["Check the ts and channel"]);
+    await ensureUsers(session);
+    const users = allCachedUsers(session.teamId);
+    const tz = "America/New_York";
+    const rows = await Promise.all(msgs.map(async (m, i) => ({
+        time: formatDateTime(tsToEpochMs(m.ts), tz),
+        author: authorName(m, users),
+        text: (i === 0 ? "" : "↳ ") + (full.present ? formatText(m.text, users) : truncate(formatText(m.text, users))),
+        ts: handle(m.ts),
+        permalink: await getPermalink(session, channel.id, m.ts),
+    })));
+    return joinBlocks(encodeObject({ channel: `${await channelLabel(session, channel)} (${channel.id})`, replies: msgs.length - 1 }), renderList("messages", rows));
+}
+function parseReadFlags(args) {
+    const team = takeFlag(args, "--team");
+    const since = takeFlag(team.rest, "--since");
+    const from = takeFlag(since.rest, "--from");
+    const to = takeFlag(from.rest, "--to");
+    const tz = takeFlag(to.rest, "--tz");
+    const limit = takeFlag(tz.rest, "--limit");
+    const threads = takeFlag(limit.rest, "--threads");
+    const excludeBots = takeBool(threads.rest, "--exclude-bots");
+    const cite = takeBool(excludeBots.rest, "--cite");
+    const full = takeBool(cite.rest, "--full");
+    const channel = full.rest.find((a) => !a.startsWith("-"));
+    const mode = (threads.value ?? "full");
+    if (!["full", "summary", "none"].includes(mode)) {
+        throw new AxiError(`Invalid --threads '${threads.value}'`, "USAGE", ["Use: full | summary | none"]);
+    }
+    const lim = limit.value ? Number.parseInt(limit.value, 10) : DEFAULT_LIMIT;
+    return {
+        team: team.value,
+        channel,
+        since: since.value,
+        from: from.value,
+        to: to.value,
+        tz: tz.value,
+        limit: Number.isFinite(lim) && lim > 0 ? lim : DEFAULT_LIMIT,
+        threads: mode,
+        excludeBots: excludeBots.present,
+        cite: cite.present,
+        full: full.present,
+    };
+}
+async function buildRow(session, channelId, msg, users, tz, f, reply) {
+    const text = formatText(msg.text, users);
+    // Replies can fall on a later day than their parent (the thread is grouped under the parent's date),
+    // so reply rows carry a full date+time to stay unambiguous; parents show just the time-of-day.
+    const epoch = tsToEpochMs(msg.ts);
+    const row = {
+        time: reply ? formatDateTime(epoch, tz) : formatTime(epoch, tz),
+        author: authorName(msg, users),
+        text: (reply ? "↳ " : "") + (f.full ? text : truncate(text)),
+        ts: handle(msg.ts),
+    };
+    if (f.cite)
+        row.permalink = await getPermalink(session, channelId, msg.ts);
+    return row;
+}
+function authorName(msg, users) {
+    if (msg.user)
+        return userName(msg.user, users);
+    if (msg.botId)
+        return "(bot)";
+    return "(system)";
+}
+function indentLines(text, spaces) {
+    const pad = " ".repeat(spaces);
+    return text
+        .split("\n")
+        .map((line) => (line.length > 0 ? pad + line : line))
+        .join("\n");
+}
+//# sourceMappingURL=read.js.map

package/dist/src/commands/read.js.map

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

package/dist/src/commands/search.d.ts

@@ -0,0 +1,2 @@
+export declare const SEARCH_HELP = "usage: slack-axi search \"<query>\" [flags]\nFinds messages across the workspace (search.messages). Use this to FIND a thing \u2014 to read a channel\nover a time window completely, use `read <channel> --from --to` instead.\nflags[6]:\n  --in <channel>   Limit to a channel (#name or id)\n  --from <@user>   Limit to a sender\n  --with <@user>   Limit to conversations that include this person (any sender)\n  --after <when>   On/after a date (2026-05-01) or span (7d)\n  --before <when>  On/before a date or span\n  --limit <n>      Max matches (default 20)\n  --cite           Add a permalink column\nexamples:\n  slack-axi search \"proposal loss\"\n  slack-axi search \"token refresh\" --in #eng --after 2026-05-01\n  slack-axi search \"deploy\" --from @alice";
+export declare function searchCommand(args: string[]): Promise<string>;

package/dist/src/commands/search.js

@@ -0,0 +1,135 @@
+import { AxiError } from "axi-sdk-js";
+import { takeBool, takeFlag } from "../flags.js";
+import { encodeObject, joinBlocks, renderHelp, renderList, truncate } from "../output.js";
+import { activeSession } from "../session.js";
+import { allCachedUsers, ensureUsers } from "../slack/cache.js";
+import { formatText } from "../slack/format.js";
+import { looksLikeId, normalizeChannelArg, resolveChannel } from "../slack/resolve.js";
+import { handle } from "../slack/ts.js";
+import { DEFAULT_TZ, formatDate, formatDateTime, parseSpanMs, tsToEpochMs } from "../slack/time.js";
+export const SEARCH_HELP = `usage: slack-axi search "<query>" [flags]
+Finds messages across the workspace (search.messages). Use this to FIND a thing — to read a channel
+over a time window completely, use \`read <channel> --from --to\` instead.
+flags[6]:
+  --in <channel>   Limit to a channel (#name or id)
+  --from <@user>   Limit to a sender
+  --with <@user>   Limit to conversations that include this person (any sender)
+  --after <when>   On/after a date (2026-05-01) or span (7d)
+  --before <when>  On/before a date or span
+  --limit <n>      Max matches (default 20)
+  --cite           Add a permalink column
+examples:
+  slack-axi search "proposal loss"
+  slack-axi search "token refresh" --in #eng --after 2026-05-01
+  slack-axi search "deploy" --from @alice`;
+const DEFAULT_LIMIT = 20;
+export async function searchCommand(args) {
+    if (args.includes("--help"))
+        return SEARCH_HELP;
+    const team = takeFlag(args, "--team");
+    const inFlag = takeFlag(team.rest, "--in");
+    const fromFlag = takeFlag(inFlag.rest, "--from");
+    const withFlag = takeFlag(fromFlag.rest, "--with");
+    const after = takeFlag(withFlag.rest, "--after");
+    const before = takeFlag(after.rest, "--before");
+    const limitFlag = takeFlag(before.rest, "--limit");
+    const citeFlag = takeBool(limitFlag.rest, "--cite");
+    const cite = citeFlag.present;
+    const positional = citeFlag.rest.filter((a) => !a.startsWith("-"));
+    const query = positional.join(" ").trim();
+    if (!query) {
+        throw new AxiError('usage: slack-axi search "<query>" [flags]', "USAGE", [
+            'Pass a search query, e.g. slack-axi search "proposal loss"',
+        ]);
+    }
+    const limit = limitFlag.value ? Number.parseInt(limitFlag.value, 10) : DEFAULT_LIMIT;
+    const session = await activeSession({ teamFlag: team.value });
+    const tz = DEFAULT_TZ;
+    // Translate friendly flags into Slack search modifiers.
+    const parts = [query];
+    if (inFlag.value)
+        parts.push(`in:#${await channelNameFor(session, inFlag.value)}`);
+    if (fromFlag.value)
+        parts.push(`from:${ensureAt(fromFlag.value)}`);
+    if (withFlag.value)
+        parts.push(`with:${ensureAt(withFlag.value)}`);
+    if (after.value)
+        parts.push(`after:${toSearchDate(after.value, tz)}`);
+    if (before.value)
+        parts.push(`before:${toSearchDate(before.value, tz)}`);
+    const fullQuery = parts.join(" ");
+    let res;
+    try {
+        res = await session.client.search.messages({
+            query: fullQuery,
+            count: Number.isFinite(limit) && limit > 0 ? limit : DEFAULT_LIMIT,
+            sort: "timestamp",
+        });
+    }
+    catch (err) {
+        // search.messages requires the user-only search:read scope.
+        const code = err?.data?.error;
+        if (code === "missing_scope") {
+            throw new AxiError("Token is missing the search:read scope", "SCOPE_MISSING", [
+                "Re-run `slack-axi auth setup`, add search:read, re-install the app, then `auth login`",
+            ]);
+        }
+        throw err;
+    }
+    const matches = res.messages?.matches ?? [];
+    const total = res.messages?.total ?? matches.length;
+    if (matches.length === 0) {
+        return joinBlocks(encodeObject({ workspace: `${session.teamName ?? session.teamId} (${session.teamId})`, query: fullQuery }), encodeObject({ matches: `0 matches for "${fullQuery}"` }), renderHelp(["Broaden the query, or use `slack-axi read <channel> --from --to` to sweep a window"]));
+    }
+    await ensureUsers(session);
+    const users = allCachedUsers(session.teamId);
+    const rows = matches.map((m) => {
+        const ts = String(m.ts ?? "");
+        const ch = m.channel;
+        const row = {
+            channel: formatMatchChannel(ch),
+            author: m.username || (m.user ? `@${m.user}` : "(unknown)"),
+            when: m.ts ? formatDateTime(tsToEpochMs(ts), tz) : "",
+            text: truncate(formatText(typeof m.text === "string" ? m.text : "", users)),
+            ts: handle(ts),
+        };
+        if (cite && typeof m.permalink === "string")
+            row.permalink = m.permalink;
+        return row;
+    });
+    const help = [
+        "To read a result's channel over a window completely, use `slack-axi read <channel> --from <date> --to <date>`",
+        rows.length < total ? `Showing ${rows.length} of ${total}; raise with \`--limit <n>\`` : undefined,
+        !cite ? "Add `--cite` (or run `slack-axi cite <channel> <ts>`) for permalinks to cite" : undefined,
+    ].filter((l) => Boolean(l));
+    return joinBlocks(encodeObject({ workspace: `${session.teamName ?? session.teamId} (${session.teamId})`, query: fullQuery }), renderList("matches", rows, { total }), renderHelp(help));
+}
+/** Resolve a `--in` channel argument to its bare name for the `in:#name` modifier. */
+async function channelNameFor(session, arg) {
+    if (looksLikeId(arg)) {
+        const ch = await resolveChannel(session, arg);
+        return ch.name || arg;
+    }
+    return normalizeChannelArg(arg);
+}
+/** Label a match's channel: `#name (id)` for channels/group DMs, `dm (id)` for a 1:1 (D…) id. */
+function formatMatchChannel(ch) {
+    if (!ch?.id)
+        return ch?.name ? `#${ch.name}` : "?";
+    if (ch.id.startsWith("D"))
+        return `dm (${ch.id})`;
+    return ch.name ? `#${ch.name} (${ch.id})` : ch.id;
+}
+/** Ensure a user reference has a leading `@` for `from:`/`with:` modifiers. */
+function ensureAt(user) {
+    return user.startsWith("@") ? user : `@${user}`;
+}
+/** Slack `after:`/`before:` take a YYYY-MM-DD date; accept a date passthrough or a relative span. */
+function toSearchDate(when, tz) {
+    const span = parseSpanMs(when);
+    if (span !== undefined)
+        return formatDate(Date.now() - span, tz);
+    const date = /^(\d{4}-\d{2}-\d{2})/.exec(when.trim());
+    return date ? date[1] : when;
+}
+//# sourceMappingURL=search.js.map

package/dist/src/commands/search.js.map

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

package/dist/src/commands/setup.d.ts

@@ -0,0 +1,2 @@
+export declare const SETUP_HELP = "usage: slack-axi setup hooks\nInstall or repair agent SessionStart hooks so each session starts with slack-axi's home view\n(workspace + channel count) as ambient context. Idempotent; repairs a stale executable path.\nexamples:\n  slack-axi setup hooks";
+export declare function setupCommand(args: string[]): Promise<string>;

package/dist/src/commands/setup.js

@@ -0,0 +1,21 @@
+import { AxiError, installSessionStartHooks } from "axi-sdk-js";
+import { encodeBlock, joinBlocks, renderHelp } from "../output.js";
+export const SETUP_HELP = `usage: slack-axi setup hooks
+Install or repair agent SessionStart hooks so each session starts with slack-axi's home view
+(workspace + channel count) as ambient context. Idempotent; repairs a stale executable path.
+examples:
+  slack-axi setup hooks`;
+export async function setupCommand(args) {
+    if (args.includes("--help"))
+        return SETUP_HELP;
+    if (args[0] !== "hooks") {
+        throw new AxiError(`Unknown setup action: ${args[0] ?? "(none)"}`, "USAGE", ["Run `slack-axi setup hooks`"]);
+    }
+    const errors = [];
+    installSessionStartHooks({ marker: "slack-axi", timeoutSeconds: 10, onError: (m) => errors.push(m) });
+    if (errors.length > 0) {
+        throw new AxiError("Hook installation reported problems", "HOOK_INSTALL_FAILED", errors);
+    }
+    return joinBlocks(encodeBlock("hooks", { status: "installed", integrations: "Claude Code, Codex, OpenCode", marker: "slack-axi" }), renderHelp(["Restart your agent session to receive slack-axi ambient context"]));
+}
+//# sourceMappingURL=setup.js.map

package/dist/src/commands/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/commands/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEnE,MAAM,CAAC,MAAM,UAAU,GAAG;;;;wBAIF,CAAC;AAEzB,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAc;IAC/C,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,UAAU,CAAC;IAC/C,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,QAAQ,CAAC,yBAAyB,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,6BAA6B,CAAC,CAAC,CAAC;IAC/G,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,wBAAwB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtG,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,QAAQ,CAAC,qCAAqC,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAC;IAC3F,CAAC;IAED,OAAO,UAAU,CACf,WAAW,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,8BAA8B,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,EAChH,UAAU,CAAC,CAAC,iEAAiE,CAAC,CAAC,CAChF,CAAC;AACJ,CAAC"}

package/dist/src/commands/write.d.ts

@@ -0,0 +1,4 @@
+export declare const REACT_HELP = "usage: slack-axi react <channel> <ts> <:emoji:>\nAdds an emoji reaction to a message. Idempotent \u2014 re-reacting is a no-op.\nexamples:\n  slack-axi react #eng 1717589640123456 :eyes:\n  slack-axi react C09GHV2RUSJ 1717589640.123456 tada";
+export declare const DRAFT_HELP = "usage: slack-axi draft <channel> \"<text>\" [--reply <ts>]\n       slack-axi draft send <draft-id>\n       slack-axi draft list\n       slack-axi draft discard <draft-id>\nPrepares a message for approval \u2014 `draft` does NOT send. Review it, then `draft send <id>` posts it.\nexamples:\n  slack-axi draft #eng \"Deploy is green \u2705\"\n  slack-axi draft #eng --reply 1717589640123456 \"confirmed\"\n  slack-axi draft send d_1a2b3c4d\n  slack-axi draft list";
+export declare function reactCommand(args: string[]): Promise<string>;
+export declare function draftCommand(args: string[]): Promise<string>;

package/dist/src/commands/write.js

@@ -0,0 +1,148 @@
+import { randomUUID } from "node:crypto";
+import { AxiError } from "axi-sdk-js";
+import { getDraft, getStoredToken, listDrafts, removeDraft, writeDraft, } from "../config.js";
+import { takeFlag } from "../flags.js";
+import { encodeObject, joinBlocks, renderHelp, renderList, truncate } from "../output.js";
+import { activeSession } from "../session.js";
+import { getPermalink } from "../slack/permalink.js";
+import { channelLabel, resolveChannel } from "../slack/resolve.js";
+import { toAxiError } from "../slack/errors.js";
+import { dottedTs, handle } from "../slack/ts.js";
+export const REACT_HELP = `usage: slack-axi react <channel> <ts> <:emoji:>
+Adds an emoji reaction to a message. Idempotent — re-reacting is a no-op.
+examples:
+  slack-axi react #eng 1717589640123456 :eyes:
+  slack-axi react C09GHV2RUSJ 1717589640.123456 tada`;
+export const DRAFT_HELP = `usage: slack-axi draft <channel> "<text>" [--reply <ts>]
+       slack-axi draft send <draft-id>
+       slack-axi draft list
+       slack-axi draft discard <draft-id>
+Prepares a message for approval — \`draft\` does NOT send. Review it, then \`draft send <id>\` posts it.
+examples:
+  slack-axi draft #eng "Deploy is green ✅"
+  slack-axi draft #eng --reply 1717589640123456 "confirmed"
+  slack-axi draft send d_1a2b3c4d
+  slack-axi draft list`;
+export async function reactCommand(args) {
+    if (args.includes("--help"))
+        return REACT_HELP;
+    const team = takeFlag(args, "--team");
+    const [channelArg, tsArg, emojiArg] = team.rest.filter((a) => !a.startsWith("-"));
+    if (!channelArg || !tsArg || !emojiArg) {
+        throw new AxiError("usage: slack-axi react <channel> <ts> <:emoji:>", "USAGE", []);
+    }
+    const name = emojiArg.replace(/:/g, "").trim();
+    const session = await activeSession({ teamFlag: team.value, mutation: true });
+    const channel = await resolveChannel(session, channelArg);
+    const ts = dottedTs(tsArg);
+    try {
+        await session.client.reactions.add({ channel: channel.id, timestamp: ts, name });
+    }
+    catch (err) {
+        const code = err?.data?.error;
+        if (code === "already_reacted") {
+            return encodeObject({ reaction: `:${name}: already on ${await channelLabel(session, channel)} message ${handle(ts)} (no-op)` });
+        }
+        throw toAxiError(err, { team: session.teamId, channel: channelArg });
+    }
+    return encodeObject({ reaction: `:${name}: added`, channel: `${await channelLabel(session, channel)} (${channel.id})`, ts: handle(ts) });
+}
+export async function draftCommand(args) {
+    if (args.includes("--help"))
+        return DRAFT_HELP;
+    const sub = args[0];
+    if (sub === "send")
+        return draftSend(args.slice(1));
+    if (sub === "list")
+        return draftList();
+    if (sub === "discard")
+        return draftDiscard(args.slice(1));
+    return draftCreate(args);
+}
+async function draftCreate(args) {
+    const team = takeFlag(args, "--team");
+    const reply = takeFlag(team.rest, "--reply");
+    const positional = reply.rest.filter((a) => !a.startsWith("-"));
+    const channelArg = positional[0];
+    const text = positional.slice(1).join(" ");
+    if (!channelArg || !text) {
+        throw new AxiError('usage: slack-axi draft <channel> "<text>" [--reply <ts>]', "USAGE", []);
+    }
+    // Creating a draft is local-only (no Slack write), but we resolve the channel to validate + label it.
+    const session = await activeSession({ teamFlag: team.value });
+    const channel = await resolveChannel(session, channelArg);
+    const label = await channelLabel(session, channel);
+    const draft = {
+        id: `d_${randomUUID().slice(0, 8)}`,
+        team: session.teamId,
+        channel_id: channel.id,
+        channel: label,
+        ...(reply.value ? { reply_to: dottedTs(reply.value) } : {}),
+        text,
+        created_at: new Date().toISOString(),
+    };
+    writeDraft(draft);
+    return joinBlocks(encodeObject({
+        draft: draft.id,
+        workspace: `${session.teamName ?? session.teamId} (${session.teamId})`,
+        channel: `${label} (${channel.id})`,
+        ...(draft.reply_to ? { reply_to: handle(draft.reply_to) } : {}),
+        text: draft.text,
+    }), renderHelp([`Review it, then post with \`slack-axi draft send ${draft.id}\` (or discard with \`draft discard ${draft.id}\`)`]));
+}
+async function draftSend(args) {
+    const id = args.find((a) => !a.startsWith("-"));
+    if (!id)
+        throw new AxiError("usage: slack-axi draft send <draft-id>", "USAGE", []);
+    const draft = getDraft(id);
+    if (!draft) {
+        throw new AxiError(`Draft ${id} not found`, "DRAFT_NOT_FOUND", ["Run `slack-axi draft list` to see pending drafts"]);
+    }
+    if (draft.sent) {
+        return encodeObject({ sent: `${id} already sent (no-op)`, ts: handle(draft.sent.ts), permalink: draft.sent.permalink });
+    }
+    if (!getStoredToken(draft.team)) {
+        throw new AxiError(`Draft's workspace ${draft.team} is no longer authenticated`, "TEAM_NOT_FOUND", [
+            "Re-auth with `slack-axi auth login`, or discard the draft",
+        ]);
+    }
+    // Send to the draft's own workspace (explicit team satisfies write-protection).
+    const session = await activeSession({ teamFlag: draft.team, mutation: true });
+    let posted;
+    try {
+        posted = await session.client.chat.postMessage({
+            channel: draft.channel_id,
+            text: draft.text,
+            ...(draft.reply_to ? { thread_ts: draft.reply_to } : {}),
+        });
+    }
+    catch (err) {
+        throw toAxiError(err, { team: draft.team, channel: draft.channel });
+    }
+    const ts = String(posted.ts ?? "");
+    const permalink = ts ? await getPermalink(session, draft.channel_id, ts) : "";
+    draft.sent = { ts, permalink, at: new Date().toISOString() };
+    writeDraft(draft);
+    return encodeObject({ sent: id, channel: `${draft.channel} (${draft.channel_id})`, ts: handle(ts), permalink });
+}
+function draftList() {
+    const drafts = listDrafts();
+    if (drafts.length === 0) {
+        return joinBlocks(encodeObject({ drafts: "0 drafts" }), renderHelp(['Create one with `slack-axi draft <channel> "<text>"`']));
+    }
+    const rows = drafts.map((d) => ({
+        id: d.id,
+        channel: d.channel,
+        status: d.sent ? "sent" : d.reply_to ? "reply (pending)" : "pending",
+        text: truncate(d.text, 80),
+    }));
+    return joinBlocks(renderList("drafts", rows), renderHelp(["Post a pending draft with `slack-axi draft send <id>`"]));
+}
+function draftDiscard(args) {
+    const id = args.find((a) => !a.startsWith("-"));
+    if (!id)
+        throw new AxiError("usage: slack-axi draft discard <draft-id>", "USAGE", []);
+    const existed = removeDraft(id);
+    return encodeObject({ discarded: existed ? id : `${id} (not found — no-op)` });
+}
+//# sourceMappingURL=write.js.map

package/dist/src/commands/write.js.map

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

package/dist/src/config.d.ts

@@ -0,0 +1,71 @@
+/** A stored user token for one workspace (team). Written at `auth login`. */
+export interface StoredToken {
+    team_id: string;
+    team_name: string;
+    user_id: string;
+    user_name?: string;
+    token: string;
+    scopes: string[];
+    obtained_at: string;
+}
+export interface UserConfig {
+    default_team?: string;
+}
+/** Result of resolving which token/workspace a command should act against. */
+export interface ActiveToken {
+    token: string;
+    teamId: string | undefined;
+    teamName: string | undefined;
+    scopes: string[] | undefined;
+    source: "env" | "flag" | "default" | "single";
+}
+/** Base config directory: $SLACK_AXI_CONFIG_DIR, else $XDG_CONFIG_HOME/slack-axi, else ~/.config/slack-axi. */
+export declare function configDir(): string;
+export declare function userConfigPath(): string;
+export declare function setupStatePath(): string;
+export declare function manifestPath(): string;
+export declare function setupHtmlPath(): string;
+export declare function workspaceDir(teamId: string): string;
+export declare function tokenPath(teamId: string): string;
+export declare function cacheChannelsPath(teamId: string): string;
+export declare function cacheUsersPath(teamId: string): string;
+/** A locally-stored message draft (prepare→approve; never auto-sent). */
+export interface Draft {
+    id: string;
+    team: string;
+    channel_id: string;
+    channel: string;
+    reply_to?: string;
+    text: string;
+    created_at: string;
+    sent?: {
+        ts: string;
+        permalink: string;
+        at: string;
+    };
+}
+export declare function getDraft(id: string): Draft | undefined;
+export declare function writeDraft(draft: Draft): void;
+export declare function removeDraft(id: string): boolean;
+export declare function listDrafts(): Draft[];
+export declare function readUserConfig(): UserConfig;
+export declare function writeUserConfig(config: UserConfig): void;
+export declare function getDefaultTeam(): string | undefined;
+export declare function setDefaultTeam(teamId: string): void;
+/** Team ids with a stored token, in directory order. */
+export declare function listWorkspaceIds(): string[];
+export declare function listWorkspaces(): StoredToken[];
+export declare function getStoredToken(teamId: string): StoredToken | undefined;
+/** Persist a token (mode 0600); first stored workspace becomes the default. */
+export declare function writeStoredToken(token: StoredToken): void;
+/** Delete a workspace's stored token + dir. Idempotent. Repairs a dangling default. */
+export declare function removeWorkspace(teamId: string): boolean;
+/**
+ * Resolve which token/workspace a command should act against, per
+ * specs/behaviors/auth-and-workspaces.md. Order: env → --team → default → single → error.
+ * Mutations with 2+ stored workspaces require an explicit team (env or flag).
+ */
+export declare function resolveActiveToken(options: {
+    teamFlag?: string;
+    mutation?: boolean;
+}): ActiveToken;