slack-axi 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jarvus Innovations
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+# slack-axi
+
+An [AXI](https://github.com/JarvusInnovations) (Agent eXperience Interface) CLI for Slack — built for
+agents to drive over the shell. Read, search, sweep, and safely draft Slack with token-efficient
+[TOON](https://toonformat.dev/) output. It replaces the flaky Slack MCP with a stored long-lived user
+token (no logouts, works headless), human date ranges (no epoch math), threads inlined, and
+ready-to-cite permalinks.
+
+## Why
+
+The Slack MCP it replaces failed in recurring ways; slack-axi fixes each at the root:
+
+| Pain | Fix |
+| --- | --- |
+| Constant logouts / breaks headless | long-lived `xoxp` user token, resolvable from env — no session, no daemon |
+| Can't find private channels / group DMs | `channels` lists all conversation types you belong to by default |
+| Wrong-year timestamps | human dates in; the resolved range is **echoed back with explicit year + tz** |
+| Oldest-first / dropped messages | reads paginate to completion with a `complete:` marker; windows tile losslessly |
+| Threads are a second call | thread replies are inlined under their parent |
+| Hand-built permalinks | a compact `ts` handle per row + a stateless `cite` command |
+| name ↔ id friction | `#name`, bare name, or id accepted everywhere |
+
+See [`specs/`](specs/) for the full specification and [`specs/motivation.md`](specs/motivation.md) for
+the evidence behind each fix.
+
+## Install
+
+```sh
+npm install -g slack-axi        # or: bun add -g slack-axi
+slack-axi auth setup            # guided: create a Slack app from a manifest, then paste the token
+```
+
+`auth setup` generates an app manifest with all required user-token scopes pre-filled (and token
+rotation disabled), walks you through creating + installing the app, then `auth login --token xoxp-…`.
+Run `slack-axi doctor` to verify auth and scope coverage.
+
+## Commands
+
+```
+slack-axi                       # home: active workspace + channel count
+slack-axi channels [--match q] [--type ...] [--all]   # discover (all conversation types)
+slack-axi dms                   # DMs + group DMs
+slack-axi members <channel>     # channel members
+slack-axi read <channel> [--since 7d | --from <d> --to <d>] [--threads ...]  # the primary verb
+slack-axi thread <channel> <ts> # one thread, fully
+slack-axi search "<query>" [--in #c] [--from @u] [--with @u] [--after <d>]   # find a thing
+slack-axi catchup [--since 1d] [--match q] [--in ...]   # scoped multi-channel sweep
+slack-axi catchup --every 1w …  # plan a month+ catch-up as weekly batches
+slack-axi cite <channel> <ts…>  # permalinks + the { channel, ts, permalink } citation shape
+slack-axi react <channel> <ts> :emoji:                  # reactions:write
+slack-axi draft <channel> "<text>" [--reply <ts>]       # prepare a message (does NOT send)
+slack-axi draft send <id>       # the explicit, separate step that posts
+slack-axi setup hooks           # install the SessionStart ambient-context hook
+```
+
+Every command supports `--help`. Channel args accept `#name` / name / id. Output is TOON with
+contextual `help[]` next steps; errors are structured with actionable suggestions.
+
+### Capabilities
+
+Read + **safe-draft**: full read/search/sweep, plus reactions and message *drafts you approve*. Nothing
+posts without an explicit `draft send`.
+
+## Development
+
+```sh
+bun install
+bun run build        # tsc → dist/
+bun test             # vitest (time/window math is unit-tested)
+```
+
+The project is spec-driven — specs in [`specs/`](specs/) are the source of truth; work is tracked as
+plans in [`plans/`](plans/). Requires Node ≥ 20 (built/run with bun; published to run under node).
+
+## License
+
+MIT © Jarvus Innovations

package/dist/bin/slack-axi.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/slack-axi.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { main } from "../src/cli.js";
+main();
+//# sourceMappingURL=slack-axi.js.map

package/dist/bin/slack-axi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-axi.js","sourceRoot":"","sources":["../../bin/slack-axi.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErC,IAAI,EAAE,CAAC"}

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

@@ -0,0 +1,39 @@
+/** Where to start "Create an app from a manifest". */
+export declare const NEW_APP_URL = "https://api.slack.com/apps?new_app=1";
+interface StepState {
+    done: boolean;
+    at?: string;
+}
+interface SetupState {
+    version: number;
+    app_name: string;
+    steps: {
+        app_created: StepState;
+    };
+}
+export declare function readSetupState(): SetupState;
+export declare function markAppCreated(): void;
+export declare function resetSetup(): void;
+export declare function setAppName(name: string): void;
+export interface SetupProgress {
+    appCreated: boolean;
+    tokenStored: boolean;
+    done: number;
+    total: number;
+    complete: boolean;
+    /** The next incomplete step key, or undefined when complete. */
+    next?: "app_created" | "token_stored";
+}
+/**
+ * token_stored is derived from a successful `auth login` (a stored workspace), never confirmed
+ * manually. A stored token is proof the app was created and installed, so it subsumes the
+ * app_created waypoint: once a token exists, setup is complete regardless of the manual confirm.
+ */
+export declare function setupProgress(): SetupProgress;
+/** Build a Slack app manifest (YAML) pre-filled with the user-token scopes slack-axi needs. */
+export declare function buildManifest(appName: string): string;
+/** Write the manifest YAML to the config dir; returns its path. */
+export declare function writeManifestFile(appName: string): string;
+/** Write a local setup.html with the new-app link and a copy-paste manifest box; returns its path. */
+export declare function writeSetupHtmlFile(appName: string): string;
+export {};

package/dist/src/auth/setup.js

@@ -0,0 +1,119 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { listWorkspaceIds, manifestPath, setupHtmlPath, setupStatePath, } from "../config.js";
+import { REQUIRED_SCOPES } from "../slack/scopes.js";
+/** Where to start "Create an app from a manifest". */
+export const NEW_APP_URL = "https://api.slack.com/apps?new_app=1";
+const DEFAULT_APP_NAME = "slack-axi";
+function defaultState() {
+    return { version: 1, app_name: DEFAULT_APP_NAME, steps: { app_created: { done: false } } };
+}
+export function readSetupState() {
+    if (!existsSync(setupStatePath()))
+        return defaultState();
+    try {
+        const parsed = JSON.parse(readFileSync(setupStatePath(), "utf-8"));
+        return {
+            version: parsed.version ?? 1,
+            app_name: parsed.app_name ?? DEFAULT_APP_NAME,
+            steps: { app_created: parsed.steps?.app_created ?? { done: false } },
+        };
+    }
+    catch {
+        return defaultState();
+    }
+}
+function writeState(state) {
+    mkdirSync(dirname(setupStatePath()), { recursive: true });
+    writeFileSync(setupStatePath(), `${JSON.stringify(state, null, 2)}\n`);
+}
+export function markAppCreated() {
+    const state = readSetupState();
+    state.steps.app_created = { done: true, at: new Date().toISOString() };
+    writeState(state);
+}
+export function resetSetup() {
+    writeState(defaultState());
+}
+export function setAppName(name) {
+    const state = readSetupState();
+    state.app_name = name;
+    writeState(state);
+}
+/**
+ * token_stored is derived from a successful `auth login` (a stored workspace), never confirmed
+ * manually. A stored token is proof the app was created and installed, so it subsumes the
+ * app_created waypoint: once a token exists, setup is complete regardless of the manual confirm.
+ */
+export function setupProgress() {
+    const appCreated = readSetupState().steps.app_created.done;
+    const tokenStored = listWorkspaceIds().length > 0;
+    if (tokenStored) {
+        return { appCreated: true, tokenStored, done: 2, total: 2, complete: true, next: undefined };
+    }
+    const done = appCreated ? 1 : 0;
+    return { appCreated, tokenStored, done, total: 2, complete: false, next: appCreated ? "token_stored" : "app_created" };
+}
+/** Build a Slack app manifest (YAML) pre-filled with the user-token scopes slack-axi needs. */
+export function buildManifest(appName) {
+    const scopeLines = REQUIRED_SCOPES.map((s) => `      - ${s}`).join("\n");
+    return `display_information:
+  name: ${appName}
+  description: Agent-ergonomic Slack CLI — read, search, and draft
+oauth_config:
+  scopes:
+    user:
+${scopeLines}
+settings:
+  org_deploy_enabled: false
+  socket_mode_enabled: false
+  token_rotation_enabled: false
+`;
+}
+/** Write the manifest YAML to the config dir; returns its path. */
+export function writeManifestFile(appName) {
+    const path = manifestPath();
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, buildManifest(appName));
+    return path;
+}
+/** Write a local setup.html with the new-app link and a copy-paste manifest box; returns its path. */
+export function writeSetupHtmlFile(appName) {
+    const path = setupHtmlPath();
+    const manifest = buildManifest(appName);
+    const escaped = manifest.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+    const html = `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>slack-axi setup</title>
+<style>
+  body { font: 15px/1.5 system-ui, sans-serif; max-width: 760px; margin: 2rem auto; padding: 0 1rem; }
+  ol { padding-left: 1.2rem; } li { margin: 0.6rem 0; }
+  a.btn { display: inline-block; background: #4a154b; color: #fff; padding: 0.5rem 0.9rem; border-radius: 6px; text-decoration: none; }
+  textarea { width: 100%; height: 22rem; font-family: ui-monospace, monospace; font-size: 13px; }
+  code { background: #f2f2f2; padding: 0.1rem 0.3rem; border-radius: 4px; }
+  button { font: inherit; padding: 0.35rem 0.7rem; }
+</style>
+</head>
+<body>
+<h1>slack-axi setup</h1>
+<ol>
+  <li><a class="btn" href="${NEW_APP_URL}" target="_blank" rel="noopener">Create a Slack app</a> — choose <strong>“From an app manifest”</strong>, pick your workspace.</li>
+  <li>Paste this manifest (all user-token scopes pre-filled; token rotation disabled):
+    <p><button onclick="navigator.clipboard.writeText(document.getElementById('m').value)">Copy manifest</button></p>
+    <textarea id="m" readonly>${escaped}</textarea>
+  </li>
+  <li>On the app’s <strong>OAuth &amp; Permissions</strong> page, click <strong>Install to Workspace</strong> and authorize.</li>
+  <li>Copy the <strong>User OAuth Token</strong> (<code>xoxp-…</code>) and run:<br>
+    <code>slack-axi auth login --token xoxp-…</code></li>
+</ol>
+</body>
+</html>
+`;
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, html);
+    return path;
+}
+//# sourceMappingURL=setup.js.map

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

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

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+export declare const TOP_HELP = "usage: slack-axi [command] [args] [flags]\ncommands[14]:\n  (none)=home, auth, doctor, channels, dms, members, read, thread, cite, search, catchup, react, draft, setup\nflags[2]:\n  --team <id> (per-command), --help, -v/--version\nexamples:\n  slack-axi channels --match bid\n  slack-axi read #bid-rtd-analytics --since 7d\n  slack-axi catchup --from 2026-05-01 --to 2026-06-07 --every 1w --match bid\n  slack-axi react #eng <ts> :eyes:\n  slack-axi draft #eng \"message\"   (then: slack-axi draft send <id>)";
+export declare function main(): Promise<void>;

package/dist/src/cli.js

@@ -0,0 +1,66 @@
+import { runAxiCli } from "axi-sdk-js";
+import { authCommand, AUTH_HELP } from "./commands/auth.js";
+import { cacheCommand, CACHE_HELP } from "./commands/cache.js";
+import { channelsCommand, CHANNELS_HELP, dmsCommand, DMS_HELP, membersCommand, MEMBERS_HELP, } from "./commands/channels.js";
+import { catchupCommand, CATCHUP_HELP } from "./commands/catchup.js";
+import { citeCommand, CITE_HELP } from "./commands/cite.js";
+import { doctorCommand, DOCTOR_HELP } from "./commands/doctor.js";
+import { homeCommand } from "./commands/home.js";
+import { readCommand, READ_HELP, threadCommand, THREAD_HELP } from "./commands/read.js";
+import { searchCommand, SEARCH_HELP } from "./commands/search.js";
+import { setupCommand, SETUP_HELP } from "./commands/setup.js";
+import { draftCommand, DRAFT_HELP, reactCommand, REACT_HELP } from "./commands/write.js";
+import { DESCRIPTION, readVersion } from "./meta.js";
+export const TOP_HELP = `usage: slack-axi [command] [args] [flags]
+commands[14]:
+  (none)=home, auth, doctor, channels, dms, members, read, thread, cite, search, catchup, react, draft, setup
+flags[2]:
+  --team <id> (per-command), --help, -v/--version
+examples:
+  slack-axi channels --match bid
+  slack-axi read #bid-rtd-analytics --since 7d
+  slack-axi catchup --from 2026-05-01 --to 2026-06-07 --every 1w --match bid
+  slack-axi react #eng <ts> :eyes:
+  slack-axi draft #eng "message"   (then: slack-axi draft send <id>)`;
+const COMMAND_HELP = {
+    auth: AUTH_HELP,
+    doctor: DOCTOR_HELP,
+    channels: CHANNELS_HELP,
+    dms: DMS_HELP,
+    members: MEMBERS_HELP,
+    cache: CACHE_HELP,
+    read: READ_HELP,
+    thread: THREAD_HELP,
+    cite: CITE_HELP,
+    search: SEARCH_HELP,
+    catchup: CATCHUP_HELP,
+    react: REACT_HELP,
+    draft: DRAFT_HELP,
+    setup: SETUP_HELP,
+};
+export async function main() {
+    await runAxiCli({
+        description: DESCRIPTION,
+        version: readVersion(),
+        topLevelHelp: TOP_HELP,
+        home: () => homeCommand(),
+        commands: {
+            auth: (args) => authCommand(args),
+            doctor: (args) => doctorCommand(args),
+            channels: (args) => channelsCommand(args),
+            dms: (args) => dmsCommand(args),
+            members: (args) => membersCommand(args),
+            cache: (args) => cacheCommand(args),
+            read: (args) => readCommand(args),
+            thread: (args) => threadCommand(args),
+            cite: (args) => citeCommand(args),
+            search: (args) => searchCommand(args),
+            catchup: (args) => catchupCommand(args),
+            react: (args) => reactCommand(args),
+            draft: (args) => draftCommand(args),
+            setup: (args) => setupCommand(args),
+        },
+        getCommandHelp: (command) => COMMAND_HELP[command],
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

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

@@ -0,0 +1,2 @@
+export declare const AUTH_HELP = "usage: slack-axi auth <subcommand> [flags]\nsubcommands[5]:\n  setup                    Progressive guided setup: create an app from a manifest, then log in\n  login --token <xoxp-...> Validate and store a token (derives team/user/scopes)\n  workspaces               List authenticated workspaces (default marked)\n  use <team>               Set the default workspace\n  revoke <team>            Delete a workspace's stored token\nsetup flags[4]:\n  --name <name>            App display name in the manifest (default: slack-axi)\n  --confirm-step <step>    Mark a manual step done (step: app_created)\n  --show-manifest          Also print the manifest YAML inline\n  --reset                  Clear setup state (e.g. to set up another workspace)\nflags[2]:\n  --team <id>              Target a specific workspace (login/use/revoke)\n  --token <xoxp-...>       The user token to store (login)\nexamples:\n  slack-axi auth setup\n  slack-axi auth setup --confirm-step app_created\n  slack-axi auth login --token xoxp-...\n  slack-axi auth workspaces";
+export declare function authCommand(args: string[]): Promise<string>;

package/dist/src/commands/auth.js

@@ -0,0 +1,192 @@
+import { AxiError } from "axi-sdk-js";
+import { getDefaultTeam, listWorkspaces, removeWorkspace, setDefaultTeam, writeStoredToken, } from "../config.js";
+import { takeBool, takeFlag } from "../flags.js";
+import { collapseHome, encodeBlock, joinBlocks, renderHelp, renderList } from "../output.js";
+import { buildManifest, markAppCreated, NEW_APP_URL, readSetupState, resetSetup, setAppName, setupProgress, writeManifestFile, writeSetupHtmlFile, } from "../auth/setup.js";
+import { validateToken } from "../slack/client.js";
+import { toAxiError } from "../slack/errors.js";
+import { missingScopes } from "../slack/scopes.js";
+export const AUTH_HELP = `usage: slack-axi auth <subcommand> [flags]
+subcommands[5]:
+  setup                    Progressive guided setup: create an app from a manifest, then log in
+  login --token <xoxp-...> Validate and store a token (derives team/user/scopes)
+  workspaces               List authenticated workspaces (default marked)
+  use <team>               Set the default workspace
+  revoke <team>            Delete a workspace's stored token
+setup flags[4]:
+  --name <name>            App display name in the manifest (default: slack-axi)
+  --confirm-step <step>    Mark a manual step done (step: app_created)
+  --show-manifest          Also print the manifest YAML inline
+  --reset                  Clear setup state (e.g. to set up another workspace)
+flags[2]:
+  --team <id>              Target a specific workspace (login/use/revoke)
+  --token <xoxp-...>       The user token to store (login)
+examples:
+  slack-axi auth setup
+  slack-axi auth setup --confirm-step app_created
+  slack-axi auth login --token xoxp-...
+  slack-axi auth workspaces`;
+export async function authCommand(args) {
+    if (args.includes("--help") || args.length === 0)
+        return AUTH_HELP;
+    const sub = args[0];
+    const rest = args.slice(1);
+    switch (sub) {
+        case "setup":
+            return setup(rest);
+        case "login":
+            return login(rest);
+        case "workspaces":
+            return workspaces();
+        case "use":
+            return use(rest);
+        case "revoke":
+            return revoke(rest);
+        default:
+            throw new AxiError(`Unknown auth subcommand: ${sub}`, "USAGE", [
+                "Subcommands: setup, login, workspaces, use, revoke",
+            ]);
+    }
+}
+function setup(args) {
+    let rest = args;
+    const reset = takeBool(rest, "--reset");
+    rest = reset.rest;
+    if (reset.present)
+        resetSetup();
+    const showManifest = takeBool(rest, "--show-manifest");
+    rest = showManifest.rest;
+    const nameFlag = takeFlag(rest, "--name");
+    rest = nameFlag.rest;
+    if (nameFlag.value)
+        setAppName(nameFlag.value);
+    const confirm = takeFlag(rest, "--confirm-step");
+    rest = confirm.rest;
+    if (confirm.value) {
+        if (confirm.value !== "app_created") {
+            throw new AxiError(`Unknown setup step: ${confirm.value}`, "USAGE", [
+                "The only manual step is `app_created`",
+            ]);
+        }
+        markAppCreated();
+    }
+    // Always refresh the generated artifacts so they reflect the current app name + scopes.
+    const appName = readSetupState().app_name;
+    const manifestFile = writeManifestFile(appName);
+    const htmlFile = writeSetupHtmlFile(appName);
+    const progress = setupProgress();
+    const head = encodeBlock("setup", {
+        progress: `${progress.done} of ${progress.total} steps complete`,
+        ...(progress.complete ? { status: "complete" } : { next_step: progress.next }),
+    });
+    let help;
+    let blocks = [head];
+    if (progress.next === "app_created") {
+        blocks.push(encodeBlock("files", { manifest: collapseHome(manifestFile), setup_page: collapseHome(htmlFile) }));
+        help = [
+            `Open ${collapseHome(htmlFile)} (or ${NEW_APP_URL}) → "From an app manifest" → pick your workspace → paste the manifest from ${collapseHome(manifestFile)}`,
+            "Token rotation is disabled in the manifest, so the resulting token won't expire",
+            "Once the app exists, run `slack-axi auth setup --confirm-step app_created`",
+        ];
+    }
+    else if (progress.next === "token_stored") {
+        help = [
+            'On the app\'s "OAuth & Permissions" page, click "Install to Workspace" and authorize',
+            "Copy the User OAuth Token (xoxp-...) and run `slack-axi auth login --token xoxp-...`",
+        ];
+    }
+    else {
+        help = [
+            "Run `slack-axi doctor` to verify scopes + read access",
+            "To set up another workspace, run `slack-axi auth setup --reset`",
+        ];
+    }
+    if (showManifest.present)
+        blocks.push(`manifest_yaml: |\n${indent(buildManifest(appName), 2)}`);
+    blocks.push(renderHelp(help));
+    return joinBlocks(...blocks);
+}
+function indent(text, spaces) {
+    const pad = " ".repeat(spaces);
+    return text
+        .split("\n")
+        .map((line) => (line.length > 0 ? pad + line : line))
+        .join("\n");
+}
+async function login(args) {
+    const { value: token, rest } = takeFlag(args, "--token");
+    const { value: teamFlag } = takeFlag(rest, "--team");
+    if (!token) {
+        throw new AxiError("--token is required", "USAGE", [
+            "slack-axi auth login --token xoxp-...",
+            "Run `slack-axi auth setup` to obtain a token",
+        ]);
+    }
+    let identity;
+    try {
+        identity = await validateToken(token);
+    }
+    catch (err) {
+        throw toAxiError(err, teamFlag ? { team: teamFlag } : {});
+    }
+    if (teamFlag && teamFlag !== identity.teamId) {
+        throw new AxiError(`Token belongs to workspace ${identity.teamId} (${identity.teamName}), not ${teamFlag}`, "TEAM_MISMATCH", ["Re-run without --team, or pass the matching workspace id"]);
+    }
+    writeStoredToken({
+        team_id: identity.teamId,
+        team_name: identity.teamName,
+        user_id: identity.userId,
+        user_name: identity.userName,
+        token,
+        scopes: identity.scopes,
+        obtained_at: new Date().toISOString(),
+    });
+    const missing = missingScopes(identity.scopes);
+    const summary = encodeBlock("authenticated", {
+        workspace: `${identity.teamName} (${identity.teamId})`,
+        user: identity.userName ? `${identity.userName} (${identity.userId})` : identity.userId,
+        scopes: missing.length === 0 ? "all required scopes granted" : `missing ${missing.length}`,
+        default: getDefaultTeam() === identity.teamId,
+    });
+    const help = missing.length > 0
+        ? renderHelp([`Add missing scopes (${missing.join(", ")}) via \`slack-axi auth setup\`, then re-install + re-login`])
+        : "";
+    return joinBlocks(summary, help);
+}
+function workspaces() {
+    const stored = listWorkspaces();
+    if (stored.length === 0) {
+        return joinBlocks(encodeBlock("workspaces", "0 workspaces authenticated"), renderHelp(["Run `slack-axi auth setup` to create an app and store a token"]));
+    }
+    const def = getDefaultTeam();
+    const rows = stored.map((w) => ({
+        team: w.team_id,
+        name: w.team_name,
+        user: w.user_name ?? w.user_id,
+        default: w.team_id === def,
+    }));
+    return joinBlocks(renderList("workspaces", rows), renderHelp(["Run `slack-axi auth use <team>` to change the default"]));
+}
+function use(args) {
+    const team = args.find((a) => !a.startsWith("-"));
+    if (!team)
+        throw new AxiError("usage: slack-axi auth use <team>", "USAGE", []);
+    const known = listWorkspaces().some((w) => w.team_id === team);
+    if (!known) {
+        throw new AxiError(`Workspace ${team} is not authenticated`, "TEAM_NOT_FOUND", [
+            `Authenticated: ${listWorkspaces().map((w) => w.team_id).join(", ") || "(none)"}`,
+        ]);
+    }
+    if (getDefaultTeam() === team)
+        return encodeBlock("default", `${team} already default (no-op)`);
+    setDefaultTeam(team);
+    return encodeBlock("default", team);
+}
+function revoke(args) {
+    const team = args.find((a) => !a.startsWith("-"));
+    if (!team)
+        throw new AxiError("usage: slack-axi auth revoke <team>", "USAGE", []);
+    const existed = removeWorkspace(team);
+    return encodeBlock("revoked", existed ? team : `${team} (was not stored — no-op)`);
+}
+//# sourceMappingURL=auth.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare const CACHE_HELP = "usage: slack-axi cache refresh [--team <id>]\nRebuilds the local channel + user caches used for name<->id and user resolution.";
+export declare function cacheCommand(args: string[]): Promise<string>;

package/dist/src/commands/cache.js

@@ -0,0 +1,25 @@
+import { AxiError } from "axi-sdk-js";
+import { takeFlag } from "../flags.js";
+import { encodeBlock } from "../output.js";
+import { activeSession } from "../session.js";
+import { refreshMemberChannels, refreshUsers } from "../slack/cache.js";
+export const CACHE_HELP = `usage: slack-axi cache refresh [--team <id>]
+Rebuilds the local channel + user caches used for name<->id and user resolution.`;
+export async function cacheCommand(args) {
+    if (args.includes("--help") || args.length === 0)
+        return CACHE_HELP;
+    const sub = args[0];
+    const team = takeFlag(args.slice(1), "--team");
+    if (sub !== "refresh") {
+        throw new AxiError(`Unknown cache subcommand: ${sub}`, "USAGE", ["Only `cache refresh` is supported"]);
+    }
+    const session = await activeSession({ teamFlag: team.value });
+    const channels = await refreshMemberChannels(session);
+    await refreshUsers(session);
+    return encodeBlock("cache", {
+        workspace: `${session.teamName ?? session.teamId} (${session.teamId})`,
+        channels: channels.length,
+        refreshed: "channels + users",
+    });
+}
+//# sourceMappingURL=cache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/commands/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAExE,MAAM,CAAC,MAAM,UAAU,GAAG;iFACuD,CAAC;AAElF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAc;IAC/C,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IACpE,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC/C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,QAAQ,CAAC,6BAA6B,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,mCAAmC,CAAC,CAAC,CAAC;IACzG,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,WAAW,CAAC,OAAO,EAAE;QAC1B,SAAS,EAAE,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG;QACtE,QAAQ,EAAE,QAAQ,CAAC,MAAM;QACzB,SAAS,EAAE,kBAAkB;KAC9B,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare const CATCHUP_HELP = "usage: slack-axi catchup [flags]\nSweeps a SCOPED set of channels over a time window and returns everything posted \u2014 a multi-channel read.\nSlack has no cross-conversation history endpoint, so this fans out per channel; scope keeps it bounded.\nflags[10]:\n  --since <span>      Window ending now: 1d, 12h, 90m (default: 1d)\n  --from <when>       Window start (date / datetime / span); --to end (default now)\n  --tz <zone>         Timezone (default America/New_York)\n  --every <span>      PLAN MODE: emit batch windows (e.g. 1w) instead of fetching \u2014 for big catch-ups\n  --type <a,b>        Conversation types to sweep (default: public,private)\n  --match <q>         Only channels whose name contains <q>\n  --in <c1,c2,...>    Explicit channel list (#name/name/id), overrides --type/--match\n  --limit-per <n>     Max messages per channel (default 50)\n  --max-channels <n>  Refuse to sweep more than this many (default 40)\n  --exclude-bots      Drop bot/automation messages\n  --cite              Add a permalink column\nThreads are not inlined here (kept cheap across many channels); a [+N replies] note marks threads \u2014\nexpand one with `read <channel>` or `thread <channel> <ts>`.\nexamples:\n  slack-axi catchup --since 1d --match bid\n  slack-axi catchup --from 2026-05-01 --to 2026-06-07 --every 1w --match bid   (plan a month, weekly)\n  slack-axi catchup --from 2026-06-06T09:00 --in bid-rtd-analytics,transit-lake";
+export declare function catchupCommand(args: string[]): Promise<string>;