slack-axi 0.1.0

package/dist/src/config.js

@@ -0,0 +1,184 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { AxiError } from "axi-sdk-js";
+/** Base config directory: $SLACK_AXI_CONFIG_DIR, else $XDG_CONFIG_HOME/slack-axi, else ~/.config/slack-axi. */
+export function configDir() {
+    if (process.env.SLACK_AXI_CONFIG_DIR)
+        return process.env.SLACK_AXI_CONFIG_DIR;
+    const xdg = process.env.XDG_CONFIG_HOME;
+    const base = xdg && xdg.length > 0 ? xdg : join(homedir(), ".config");
+    return join(base, "slack-axi");
+}
+export function userConfigPath() {
+    return join(configDir(), "config.json");
+}
+export function setupStatePath() {
+    return join(configDir(), "setup.json");
+}
+export function manifestPath() {
+    return join(configDir(), "manifest.yaml");
+}
+export function setupHtmlPath() {
+    return join(configDir(), "setup.html");
+}
+export function workspaceDir(teamId) {
+    return join(configDir(), "workspaces", teamId);
+}
+export function tokenPath(teamId) {
+    return join(workspaceDir(teamId), "token.json");
+}
+export function cacheChannelsPath(teamId) {
+    return join(configDir(), "cache", teamId, "channels.json");
+}
+export function cacheUsersPath(teamId) {
+    return join(configDir(), "cache", teamId, "users.json");
+}
+function draftsDir() {
+    return join(configDir(), "drafts");
+}
+function draftPath(id) {
+    return join(draftsDir(), `${id}.json`);
+}
+export function getDraft(id) {
+    return readJson(draftPath(id));
+}
+export function writeDraft(draft) {
+    writeJson(draftPath(draft.id), draft);
+}
+export function removeDraft(id) {
+    if (!existsSync(draftPath(id)))
+        return false;
+    rmSync(draftPath(id), { force: true });
+    return true;
+}
+export function listDrafts() {
+    const dir = draftsDir();
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir)
+        .filter((f) => f.endsWith(".json"))
+        .map((f) => readJson(join(dir, f)))
+        .filter((d) => d !== undefined)
+        .sort((a, b) => a.created_at.localeCompare(b.created_at));
+}
+function readJson(path) {
+    if (!existsSync(path))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+function writeJson(path, value, mode) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(value, null, 2)}\n`, mode ? { mode } : undefined);
+}
+export function readUserConfig() {
+    return readJson(userConfigPath()) ?? {};
+}
+export function writeUserConfig(config) {
+    writeJson(userConfigPath(), config);
+}
+export function getDefaultTeam() {
+    return readUserConfig().default_team;
+}
+export function setDefaultTeam(teamId) {
+    writeUserConfig({ ...readUserConfig(), default_team: teamId });
+}
+/** Team ids with a stored token, in directory order. */
+export function listWorkspaceIds() {
+    const dir = join(configDir(), "workspaces");
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory() && existsSync(tokenPath(entry.name)))
+        .map((entry) => entry.name);
+}
+export function listWorkspaces() {
+    return listWorkspaceIds()
+        .map((id) => readJson(tokenPath(id)))
+        .filter((t) => t !== undefined);
+}
+export function getStoredToken(teamId) {
+    return readJson(tokenPath(teamId));
+}
+/** Persist a token (mode 0600); first stored workspace becomes the default. */
+export function writeStoredToken(token) {
+    writeJson(tokenPath(token.team_id), token, 0o600);
+    if (getDefaultTeam() === undefined)
+        setDefaultTeam(token.team_id);
+}
+/** Delete a workspace's stored token + dir. Idempotent. Repairs a dangling default. */
+export function removeWorkspace(teamId) {
+    const dir = workspaceDir(teamId);
+    const existed = existsSync(tokenPath(teamId));
+    if (existsSync(dir))
+        rmSync(dir, { recursive: true, force: true });
+    if (getDefaultTeam() === teamId) {
+        const remaining = listWorkspaceIds();
+        const config = readUserConfig();
+        if (remaining.length > 0)
+            config.default_team = remaining[0];
+        else
+            delete config.default_team;
+        writeUserConfig(config);
+    }
+    return existed;
+}
+/**
+ * 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 function resolveActiveToken(options) {
+    const { teamFlag, mutation = false } = options;
+    const envToken = process.env.SLACK_AXI_TOKEN;
+    if (envToken && envToken.length > 0) {
+        const envTeam = process.env.SLACK_AXI_TEAM ?? teamFlag;
+        const stored = envTeam ? getStoredToken(envTeam) : undefined;
+        return {
+            token: envToken,
+            teamId: envTeam,
+            teamName: stored?.team_name,
+            scopes: stored?.scopes,
+            source: "env",
+        };
+    }
+    const ids = listWorkspaceIds();
+    if (ids.length === 0) {
+        throw new AxiError("No Slack token available", "NO_TOKEN", [
+            "Set SLACK_AXI_TOKEN, or run `slack-axi auth setup` to create an app and store a token",
+            "Then `slack-axi auth login --token xoxp-...`",
+        ]);
+    }
+    if (teamFlag)
+        return fromStored(teamFlag, "flag");
+    if (mutation && ids.length > 1) {
+        throw new AxiError("Multiple workspaces are stored; a mutation requires an explicit workspace", "TEAM_REQUIRED", [
+            `Pass --team <id> (one of: ${ids.join(", ")}) or set SLACK_AXI_TEAM`,
+        ]);
+    }
+    const def = getDefaultTeam();
+    if (def && getStoredToken(def))
+        return fromStored(def, "default");
+    if (ids.length === 1)
+        return fromStored(ids[0], "single");
+    throw new AxiError("No default workspace set and multiple are stored", "NO_DEFAULT_TEAM", [`Run \`slack-axi auth use <team>\` (one of: ${ids.join(", ")})`]);
+}
+function fromStored(teamId, source) {
+    const stored = getStoredToken(teamId);
+    if (!stored) {
+        throw new AxiError(`Workspace ${teamId} is not authenticated`, "TEAM_NOT_FOUND", [`Authenticated workspaces: ${listWorkspaceIds().join(", ") || "(none)"}`]);
+    }
+    return {
+        token: stored.token,
+        teamId: stored.team_id,
+        teamName: stored.team_name,
+        scopes: stored.scopes,
+        source,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

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

package/dist/src/flags.d.ts

@@ -0,0 +1,11 @@
+/** Minimal, lenient flag parsing shared by commands. Unknown flags are left in `rest`. */
+/** Extract a single string-valued flag (e.g. `--team T1`), returning the value and remaining args. */
+export declare function takeFlag(args: string[], name: string): {
+    value?: string;
+    rest: string[];
+};
+/** Whether a boolean flag is present, returning the remaining args. */
+export declare function takeBool(args: string[], name: string): {
+    present: boolean;
+    rest: string[];
+};

package/dist/src/flags.js

@@ -0,0 +1,21 @@
+/** Minimal, lenient flag parsing shared by commands. Unknown flags are left in `rest`. */
+/** Extract a single string-valued flag (e.g. `--team T1`), returning the value and remaining args. */
+export function takeFlag(args, name) {
+    const rest = [];
+    let value;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === name && i + 1 < args.length) {
+            value = args[i + 1];
+            i++;
+            continue;
+        }
+        rest.push(args[i]);
+    }
+    return { value, rest };
+}
+/** Whether a boolean flag is present, returning the remaining args. */
+export function takeBool(args, name) {
+    const rest = args.filter((a) => a !== name);
+    return { present: rest.length !== args.length, rest };
+}
+//# sourceMappingURL=flags.js.map

package/dist/src/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../src/flags.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,sGAAsG;AACtG,MAAM,UAAU,QAAQ,CAAC,IAAc,EAAE,IAAY;IACnD,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,KAAyB,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5C,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACpB,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,QAAQ,CAAC,IAAc,EAAE,IAAY;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;AACxD,CAAC"}

package/dist/src/meta.d.ts

@@ -0,0 +1,3 @@
+export declare const DESCRIPTION = "Read, search, and draft Slack across your workspaces";
+/** Read the package version from the nearest package.json (dist or src layout). */
+export declare function readVersion(): string;

package/dist/src/meta.js

@@ -0,0 +1,17 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+export const DESCRIPTION = "Read, search, and draft Slack across your workspaces";
+/** Read the package version from the nearest package.json (dist or src layout). */
+export function readVersion() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    for (const candidate of [join(here, "..", "package.json"), join(here, "..", "..", "package.json")]) {
+        if (!existsSync(candidate))
+            continue;
+        const parsed = JSON.parse(readFileSync(candidate, "utf-8"));
+        if (typeof parsed.version === "string" && parsed.version.length > 0)
+            return parsed.version;
+    }
+    return "0.0.0";
+}
+//# sourceMappingURL=meta.js.map

package/dist/src/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,WAAW,GAAG,sDAAsD,CAAC;AAElF,mFAAmF;AACnF,MAAM,UAAU,WAAW;IACzB,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,KAAK,MAAM,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;QACnG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,SAAS;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAA0B,CAAC;QACrF,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IAC7F,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/output.d.ts

@@ -0,0 +1,25 @@
+/** Collapse the user's home directory prefix to `~` for display. */
+export declare function collapseHome(path: string): string;
+/**
+ * Token-efficient TOON output helpers — the shared rendering boundary for every command.
+ * See specs/behaviors/output-format.md. Internal logic stays on JSON; commands convert here.
+ */
+/** Encode a labeled value as a TOON block, e.g. `encodeBlock("workspace", {...})`. */
+export declare function encodeBlock(label: string, value: unknown): string;
+/** Encode a flat key/value object as top-level TOON lines (no wrapping label). */
+export declare function encodeObject(value: Record<string, unknown>): string;
+/** Render a list of already-flat rows under a labeled TOON array with a count header. */
+export declare function renderList(label: string, rows: Array<Record<string, unknown>>, options?: {
+    total?: number;
+}): string;
+/**
+ * Render help suggestions. encode() inlines primitive arrays, so we format manually to get the
+ * multi-line `help[N]:` block the AXI standard uses.
+ */
+export declare function renderHelp(lines: string[]): string;
+/** Render a structured error as TOON on stdout, with optional fixing suggestions. */
+export declare function renderError(message: string, code: string, suggestions?: string[]): string;
+/** Join non-empty TOON blocks with single newlines. */
+export declare function joinBlocks(...blocks: Array<string | undefined>): string;
+/** Truncate free text to `max` chars, noting the original length. */
+export declare function truncate(text: string, max?: number): string;

package/dist/src/output.js

@@ -0,0 +1,52 @@
+import { homedir } from "node:os";
+import { encode } from "@toon-format/toon";
+/** Collapse the user's home directory prefix to `~` for display. */
+export function collapseHome(path) {
+    const home = homedir();
+    return path.startsWith(home) ? `~${path.slice(home.length)}` : path;
+}
+/**
+ * Token-efficient TOON output helpers — the shared rendering boundary for every command.
+ * See specs/behaviors/output-format.md. Internal logic stays on JSON; commands convert here.
+ */
+/** Encode a labeled value as a TOON block, e.g. `encodeBlock("workspace", {...})`. */
+export function encodeBlock(label, value) {
+    return encode({ [label]: value });
+}
+/** Encode a flat key/value object as top-level TOON lines (no wrapping label). */
+export function encodeObject(value) {
+    return encode(value);
+}
+/** Render a list of already-flat rows under a labeled TOON array with a count header. */
+export function renderList(label, rows, options = {}) {
+    const total = options.total ?? rows.length;
+    const header = total === rows.length ? `${label}[${rows.length}]` : `${label}[${rows.length} of ${total}]`;
+    // Encode under a placeholder label, then swap in our count-annotated header.
+    const encoded = encode({ [label]: rows });
+    return encoded.replace(new RegExp(`^${label}\\[${rows.length}\\]`), header);
+}
+/**
+ * Render help suggestions. encode() inlines primitive arrays, so we format manually to get the
+ * multi-line `help[N]:` block the AXI standard uses.
+ */
+export function renderHelp(lines) {
+    const items = lines.filter((l) => l && l.length > 0);
+    if (items.length === 0)
+        return "";
+    return `help[${items.length}]:\n${items.map((l) => `  ${l}`).join("\n")}`;
+}
+/** Render a structured error as TOON on stdout, with optional fixing suggestions. */
+export function renderError(message, code, suggestions = []) {
+    return joinBlocks(encode({ error: message, code }), renderHelp(suggestions));
+}
+/** Join non-empty TOON blocks with single newlines. */
+export function joinBlocks(...blocks) {
+    return blocks.filter((b) => Boolean(b && b.length > 0)).join("\n");
+}
+/** Truncate free text to `max` chars, noting the original length. */
+export function truncate(text, max = 500) {
+    if (text.length <= max)
+        return text;
+    return `${text.slice(0, max - 1)}… (truncated, ${text.length} chars total)`;
+}
+//# sourceMappingURL=output.js.map

package/dist/src/output.js.map

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

package/dist/src/session.d.ts

@@ -0,0 +1,17 @@
+import type { WebClient } from "@slack/web-api";
+/** An authenticated, ready-to-use Slack session for one workspace. */
+export interface Session {
+    token: string;
+    teamId: string;
+    teamName?: string;
+    client: WebClient;
+}
+/**
+ * Resolve the active workspace into a usable session. teamId is guaranteed: for a stored token it
+ * comes from token.json; for a bare SLACK_AXI_TOKEN env (no SLACK_AXI_TEAM) it's derived via a single
+ * auth.test. The teamId is the cache key, so it must be known before any read.
+ */
+export declare function activeSession(options?: {
+    teamFlag?: string;
+    mutation?: boolean;
+}): Promise<Session>;

package/dist/src/session.js

@@ -0,0 +1,25 @@
+import { resolveActiveToken } from "./config.js";
+import { validateToken, webClient } from "./slack/client.js";
+import { toAxiError } from "./slack/errors.js";
+/**
+ * Resolve the active workspace into a usable session. teamId is guaranteed: for a stored token it
+ * comes from token.json; for a bare SLACK_AXI_TOKEN env (no SLACK_AXI_TEAM) it's derived via a single
+ * auth.test. The teamId is the cache key, so it must be known before any read.
+ */
+export async function activeSession(options = {}) {
+    const active = resolveActiveToken(options);
+    let teamId = active.teamId;
+    let teamName = active.teamName;
+    if (!teamId) {
+        try {
+            const identity = await validateToken(active.token);
+            teamId = identity.teamId;
+            teamName = identity.teamName;
+        }
+        catch (err) {
+            throw toAxiError(err, options.teamFlag ? { team: options.teamFlag } : {});
+        }
+    }
+    return { token: active.token, teamId, teamName, client: webClient(active.token) };
+}
+//# sourceMappingURL=session.js.map

package/dist/src/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAU/C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAqD,EAAE;IACzF,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3B,IAAI,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnD,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YACzB,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACpF,CAAC"}

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

@@ -0,0 +1,40 @@
+import type { Session } from "../session.js";
+export type ChannelType = "public" | "private" | "mpim" | "im";
+export interface ChannelMeta {
+    id: string;
+    /** Channel name (no leading #). For `im` this is empty; use `user` to resolve a label. */
+    name: string;
+    type: ChannelType;
+    is_member: boolean;
+    is_archived: boolean;
+    /** For `im` channels: the other participant's user id. */
+    user?: string;
+    topic?: string;
+    purpose?: string;
+}
+export interface UserMeta {
+    id: string;
+    name: string;
+    real_name?: string;
+    display_name?: string;
+    is_bot: boolean;
+}
+/** Cache freshness window. Caches only map id↔name; message content is always fetched live. */
+export declare const CACHE_TTL_MS: number;
+/** Fetch the user's conversations across ALL types (paginate to completion) and update the cache. */
+export declare function refreshMemberChannels(session: Session): Promise<ChannelMeta[]>;
+/** Fetch every public+private channel in the workspace (paginate to completion) and update the cache. */
+export declare function refreshAllChannels(session: Session): Promise<ChannelMeta[]>;
+/** All cached channels, refreshing member channels first if the cache is stale or empty. */
+export declare function getChannels(session: Session): Promise<ChannelMeta[]>;
+export declare function cachedChannels(teamId: string): ChannelMeta[];
+export declare function getCachedChannel(teamId: string, id: string): ChannelMeta | undefined;
+/** Fetch a single channel by id via conversations.info and cache it. */
+export declare function fetchChannelInfo(session: Session, id: string): Promise<ChannelMeta>;
+/** Fetch the full user directory (paginate to completion) and replace the users cache. */
+export declare function refreshUsers(session: Session): Promise<void>;
+/** Ensure the users cache is populated and fresh. */
+export declare function ensureUsers(session: Session): Promise<void>;
+export declare function cachedUser(teamId: string, id: string): UserMeta | undefined;
+/** The whole users map (one file read) — for labeling many messages without repeated reads. */
+export declare function allCachedUsers(teamId: string): Record<string, UserMeta>;

package/dist/src/slack/cache.js

@@ -0,0 +1,161 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { cacheChannelsPath, cacheUsersPath } from "../config.js";
+/** Cache freshness window. Caches only map id↔name; message content is always fetched live. */
+export const CACHE_TTL_MS = 60 * 60 * 1000;
+function readJson(path) {
+    if (!existsSync(path))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+function writeJson(path, value) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(value, null, 2)}\n`);
+}
+function now() {
+    return Date.now();
+}
+// ---------------------------------------------------------------------------- channels
+function classify(c) {
+    if (c.is_im)
+        return "im";
+    if (c.is_mpim)
+        return "mpim";
+    if (c.is_private)
+        return "private";
+    return "public";
+}
+function toChannelMeta(c) {
+    const topic = c.topic?.value;
+    const purpose = c.purpose?.value;
+    return {
+        id: String(c.id),
+        name: typeof c.name === "string" ? c.name : "",
+        type: classify(c),
+        is_member: c.is_member === true,
+        is_archived: c.is_archived === true,
+        ...(typeof c.user === "string" ? { user: c.user } : {}),
+        ...(topic ? { topic } : {}),
+        ...(purpose ? { purpose } : {}),
+    };
+}
+function loadChannels(teamId) {
+    return readJson(cacheChannelsPath(teamId)) ?? { fetched_at: 0, channels: {} };
+}
+function saveChannels(teamId, cache) {
+    writeJson(cacheChannelsPath(teamId), cache);
+}
+/** Merge freshly-fetched channels into the cache (newer entries win). */
+function mergeChannels(teamId, fresh) {
+    const cache = loadChannels(teamId);
+    for (const ch of fresh)
+        cache.channels[ch.id] = ch;
+    cache.fetched_at = now();
+    saveChannels(teamId, cache);
+    return fresh;
+}
+/** Fetch the user's conversations across ALL types (paginate to completion) and update the cache. */
+export async function refreshMemberChannels(session) {
+    const result = [];
+    let cursor;
+    do {
+        const res = await session.client.users.conversations({
+            types: "public_channel,private_channel,mpim,im",
+            exclude_archived: false,
+            limit: 200,
+            ...(cursor ? { cursor } : {}),
+        });
+        for (const c of res.channels ?? [])
+            result.push(toChannelMeta({ ...c, is_member: true }));
+        cursor = res.response_metadata?.next_cursor || undefined;
+    } while (cursor);
+    return mergeChannels(session.teamId, result);
+}
+/** Fetch every public+private channel in the workspace (paginate to completion) and update the cache. */
+export async function refreshAllChannels(session) {
+    const result = [];
+    let cursor;
+    do {
+        const res = await session.client.conversations.list({
+            types: "public_channel,private_channel",
+            exclude_archived: false,
+            limit: 200,
+            ...(cursor ? { cursor } : {}),
+        });
+        for (const c of res.channels ?? [])
+            result.push(toChannelMeta(c));
+        cursor = res.response_metadata?.next_cursor || undefined;
+    } while (cursor);
+    return mergeChannels(session.teamId, result);
+}
+/** All cached channels, refreshing member channels first if the cache is stale or empty. */
+export async function getChannels(session) {
+    const cache = loadChannels(session.teamId);
+    if (now() - cache.fetched_at > CACHE_TTL_MS || Object.keys(cache.channels).length === 0) {
+        await refreshMemberChannels(session);
+    }
+    return Object.values(loadChannels(session.teamId).channels);
+}
+export function cachedChannels(teamId) {
+    return Object.values(loadChannels(teamId).channels);
+}
+export function getCachedChannel(teamId, id) {
+    return loadChannels(teamId).channels[id];
+}
+/** Fetch a single channel by id via conversations.info and cache it. */
+export async function fetchChannelInfo(session, id) {
+    const res = await session.client.conversations.info({ channel: id });
+    const [meta] = mergeChannels(session.teamId, [toChannelMeta(res.channel)]);
+    return meta;
+}
+// ---------------------------------------------------------------------------- users
+function toUserMeta(u) {
+    const profile = u.profile ?? {};
+    return {
+        id: String(u.id),
+        name: typeof u.name === "string" ? u.name : String(u.id),
+        ...(profile.real_name ? { real_name: profile.real_name } : {}),
+        ...(profile.display_name ? { display_name: profile.display_name } : {}),
+        is_bot: u.is_bot === true,
+    };
+}
+function loadUsers(teamId) {
+    return readJson(cacheUsersPath(teamId)) ?? { fetched_at: 0, users: {} };
+}
+function saveUsers(teamId, cache) {
+    writeJson(cacheUsersPath(teamId), cache);
+}
+/** Fetch the full user directory (paginate to completion) and replace the users cache. */
+export async function refreshUsers(session) {
+    const users = {};
+    let cursor;
+    do {
+        const res = await session.client.users.list({ limit: 200, ...(cursor ? { cursor } : {}) });
+        for (const u of res.members ?? []) {
+            const meta = toUserMeta(u);
+            users[meta.id] = meta;
+        }
+        cursor = res.response_metadata?.next_cursor || undefined;
+    } while (cursor);
+    saveUsers(session.teamId, { fetched_at: now(), users });
+}
+/** Ensure the users cache is populated and fresh. */
+export async function ensureUsers(session) {
+    const cache = loadUsers(session.teamId);
+    if (now() - cache.fetched_at > CACHE_TTL_MS || Object.keys(cache.users).length === 0) {
+        await refreshUsers(session);
+    }
+}
+export function cachedUser(teamId, id) {
+    return loadUsers(teamId).users[id];
+}
+/** The whole users map (one file read) — for labeling many messages without repeated reads. */
+export function allCachedUsers(teamId) {
+    return loadUsers(teamId).users;
+}
+//# sourceMappingURL=cache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/slack/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAoCjE,+FAA+F;AAC/F,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE3C,SAAS,QAAQ,CAAI,IAAY;IAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAM,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,KAAc;IAC7C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,GAAG;IACV,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;AACpB,CAAC;AAED,wFAAwF;AAExF,SAAS,QAAQ,CAAC,CAA0B;IAC1C,IAAI,CAAC,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC;IAC7B,IAAI,CAAC,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IACnC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CAAC,CAA0B;IAC/C,MAAM,KAAK,GAAI,CAAC,CAAC,KAAwC,EAAE,KAAK,CAAC;IACjE,MAAM,OAAO,GAAI,CAAC,CAAC,OAA0C,EAAE,KAAK,CAAC;IACrE,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;QAC9C,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QACjB,SAAS,EAAE,CAAC,CAAC,SAAS,KAAK,IAAI;QAC/B,WAAW,EAAE,CAAC,CAAC,WAAW,KAAK,IAAI;QACnC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,MAAc;IAClC,OAAO,QAAQ,CAAgB,iBAAiB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAC/F,CAAC;AAED,SAAS,YAAY,CAAC,MAAc,EAAE,KAAoB;IACxD,SAAS,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,yEAAyE;AACzE,SAAS,aAAa,CAAC,MAAc,EAAE,KAAoB;IACzD,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACnC,KAAK,MAAM,EAAE,IAAI,KAAK;QAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;IACnD,KAAK,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;IACzB,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC5B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,qGAAqG;AACrG,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAgB;IAC1D,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,IAAI,MAA0B,CAAC;IAC/B,GAAG,CAAC;QACF,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC;YACnD,KAAK,EAAE,wCAAwC;YAC/C,gBAAgB,EAAE,KAAK;YACvB,KAAK,EAAE,GAAG;YACV,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B,CAAC,CAAC;QACH,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1F,MAAM,GAAG,GAAG,CAAC,iBAAiB,EAAE,WAAW,IAAI,SAAS,CAAC;IAC3D,CAAC,QAAQ,MAAM,EAAE;IACjB,OAAO,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,yGAAyG;AACzG,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAgB;IACvD,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,IAAI,MAA0B,CAAC;IAC/B,GAAG,CAAC;QACF,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC;YAClD,KAAK,EAAE,gCAAgC;YACvC,gBAAgB,EAAE,KAAK;YACvB,KAAK,EAAE,GAAG;YACV,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B,CAAC,CAAC;QACH,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAA4B,CAAC,CAAC,CAAC;QAC7F,MAAM,GAAG,GAAG,CAAC,iBAAiB,EAAE,WAAW,IAAI,SAAS,CAAC;IAC3D,CAAC,QAAQ,MAAM,EAAE;IACjB,OAAO,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAgB;IAChD,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU,GAAG,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxF,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,EAAU;IACzD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAgB,EAAE,EAAU;IACjE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IACrE,MAAM,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,OAAkC,CAAC,CAAC,CAAC,CAAC;IACtG,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qFAAqF;AAErF,SAAS,UAAU,CAAC,CAA0B;IAC5C,MAAM,OAAO,GAAI,CAAC,CAAC,OAAqE,IAAI,EAAE,CAAC;IAC/F,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,MAAM,EAAE,CAAC,CAAC,MAAM,KAAK,IAAI;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,MAAc;IAC/B,OAAO,QAAQ,CAAa,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACtF,CAAC;AAED,SAAS,SAAS,CAAC,MAAc,EAAE,KAAiB;IAClD,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAgB;IACjD,MAAM,KAAK,GAA6B,EAAE,CAAC;IAC3C,IAAI,MAA0B,CAAC;IAC/B,GAAG,CAAC;QACF,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3F,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,UAAU,CAAC,CAA4B,CAAC,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,iBAAiB,EAAE,WAAW,IAAI,SAAS,CAAC;IAC3D,CAAC,QAAQ,MAAM,EAAE;IACjB,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAgB;IAChD,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU,GAAG,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrF,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,EAAU;IACnD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC;AACjC,CAAC"}

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

@@ -0,0 +1,21 @@
+import { WebClient } from "@slack/web-api";
+/** A validated token plus the workspace/user metadata derived from auth.test. */
+export interface TokenIdentity {
+    teamId: string;
+    teamName: string;
+    userId: string;
+    userName?: string;
+    url?: string;
+    scopes: string[];
+}
+/** Build a Slack Web API client for a token. The SDK handles tiered rate-limit retry. */
+export declare function webClient(token: string): WebClient;
+/**
+ * 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 declare function validateToken(token: string): Promise<TokenIdentity>;