@damian87/omp 0.7.0 → 0.9.2

package/dist/src/env/init.js

@@ -0,0 +1,294 @@
+/**
+ * Interactive setup for `~/.omp/.env`.
+ *
+ * `omp env init` walks the user through getting their Slack tokens, prompts
+ * them, writes the file (chmod 600), and tells them what to run next. Anything
+ * that would prompt the user lives behind injectable I/O so unit tests can
+ * exercise the full happy path and the validation/abort paths without ever
+ * touching a real terminal.
+ */
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { OMP_ENV_DIRNAME, OMP_ENV_FILENAME } from "./dotenv.js";
+const BOT_TOKEN_PREFIX = "xoxb-";
+const APP_TOKEN_PREFIX = "xapp-";
+const SLACK_APP_URL = "https://api.slack.com/apps";
+/**
+ * Slack app manifest pre-configured for the omp gateway bridge. Includes the
+ * bot scopes Slack requires before letting you install the app, plus event
+ * subscriptions for DMs and @mentions, plus Socket Mode (no public URL).
+ *
+ * Keep this in sync with docs/slack-setup.md. If you change one, change both.
+ */
+export const SLACK_APP_MANIFEST_YAML = `display_information:
+  name: omp-copilot
+  description: Bridge to a local GitHub Copilot CLI session
+features:
+  bot_user:
+    display_name: omp-copilot
+    always_online: true
+  app_home:
+    messages_tab_enabled: true
+    messages_tab_read_only_enabled: false
+oauth_config:
+  scopes:
+    bot:
+      - app_mentions:read
+      - chat:write
+      - im:history
+      - im:read
+      - im:write
+settings:
+  event_subscriptions:
+    bot_events:
+      - app_mention
+      - message.im
+  interactivity:
+    is_enabled: false
+  org_deploy_enabled: false
+  socket_mode_enabled: true
+`;
+const INTRO_LINES = [
+    "",
+    "omp env init — set up ~/.omp/.env",
+    "",
+    "This writes your Slack tokens (and optional defaults) to ~/.omp/.env so",
+    "`omp gateway serve` works from any shell, without `source .env`.",
+    "Shell exports always win, so a one-off override still works.",
+    "",
+    "──────────────────────────────────────────────────────────────────────",
+    "STEP 1 — create the Slack app FROM AN APP MANIFEST (not from scratch).",
+    "──────────────────────────────────────────────────────────────────────",
+    `  • Open ${SLACK_APP_URL} → "Create New App" → "From an app manifest".`,
+    "  • Pick your workspace.",
+    `  • Choose YAML and paste the manifest below, then "Create" → "Install to Workspace".`,
+    "    (The manifest includes the required scopes so Slack will let you install it.",
+    "     Picking 'From scratch' leaves scopes empty — Slack then refuses to install.)",
+    "",
+    "── manifest (copy from here to the next dashed line) ──",
+    ...SLACK_APP_MANIFEST_YAML.trimEnd().split("\n"),
+    "── end of manifest ──",
+    "",
+    "──────────────────────────────────────────────────────────────────────",
+    "STEP 2 — grab the two tokens (≈1 min):",
+    "──────────────────────────────────────────────────────────────────────",
+    `  • Bot token (xoxb-…): "OAuth & Permissions" → "Bot User OAuth Token"`,
+    "    (visible after the 'Install to Workspace' step above).",
+    `  • App-level token (xapp-…): "Basic Information" → "App-Level Tokens"`,
+    "    → Generate, with scope `connections:write`.",
+    "",
+    "Then paste both tokens at the prompts below. Press ENTER on optional ones to skip.",
+    "",
+];
+/**
+ * Run the interactive setup. Idempotent — re-running shows masked existing
+ * values and offers to overwrite (or pass `force: true`).
+ *
+ * Validation:
+ *   - bot token must start with `xoxb-` (we re-prompt up to 2 times)
+ *   - app token must start with `xapp-` (we re-prompt up to 2 times)
+ *   - empty bot/app token in non-interactive mode is an error
+ */
+export async function runEnvInit(opts) {
+    const { io, force, answers } = opts;
+    const home = opts.homeDir ?? homedir();
+    const path = join(home, OMP_ENV_DIRNAME, OMP_ENV_FILENAME);
+    // Non-interactive path: take everything from `answers`. Used by the CLI
+    // when the user passes --bot-token / --app-token flags, or by tests.
+    const interactive = !answers;
+    if (interactive) {
+        for (const line of INTRO_LINES)
+            io.print(line);
+    }
+    if (existsSync(path) && !force) {
+        if (interactive) {
+            const existing = readExistingMasked(path);
+            io.print(`Existing config at ${path}:`);
+            for (const line of existing)
+                io.print(`  ${line}`);
+            io.print("");
+            const overwrite = await io.ask("Overwrite? [y/N] ");
+            if ((overwrite ?? "").trim().toLowerCase() !== "y") {
+                return { ok: false, path, reason: "aborted by user (no overwrite)" };
+            }
+        }
+        else {
+            return { ok: false, path, reason: `${path} already exists (use --force to overwrite)` };
+        }
+    }
+    const collected = {
+        slackBotToken: "",
+        slackAppToken: "",
+        copilotTmuxSession: "",
+        slackAllowedUsers: "",
+        slackHomeChannel: "",
+    };
+    if (answers) {
+        Object.assign(collected, answers);
+    }
+    else {
+        collected.slackBotToken = await promptForToken(io, "Slack BOT token", BOT_TOKEN_PREFIX);
+        collected.slackAppToken = await promptForToken(io, "Slack APP-LEVEL token", APP_TOKEN_PREFIX);
+        collected.copilotTmuxSession = (await io.ask("Pin Copilot tmux session (optional, e.g. omp-9999): ")) ?? "";
+        collected.slackAllowedUsers = (await io.ask("Slack user ID allowlist (optional, comma-separated, e.g. U0123ABCD): ")) ?? "";
+        collected.slackHomeChannel = (await io.ask("Default Slack target for notifications (optional, channel C…/G…/D… or user U…): ")) ?? "";
+    }
+    // Final validation — in both interactive and non-interactive modes the
+    // required tokens must be present and prefix-shaped, otherwise refuse to
+    // write a config that wouldn't pass `gateway doctor`.
+    const botToken = collected.slackBotToken.trim();
+    const appToken = collected.slackAppToken.trim();
+    if (!botToken || !botToken.startsWith(BOT_TOKEN_PREFIX)) {
+        return {
+            ok: false,
+            path,
+            reason: `Slack BOT token is required and must start with "${BOT_TOKEN_PREFIX}".`,
+        };
+    }
+    if (!appToken || !appToken.startsWith(APP_TOKEN_PREFIX)) {
+        return {
+            ok: false,
+            path,
+            reason: `Slack APP-LEVEL token is required and must start with "${APP_TOKEN_PREFIX}".`,
+        };
+    }
+    const session = collected.copilotTmuxSession.trim();
+    const users = collected.slackAllowedUsers.trim();
+    const homeChannel = collected.slackHomeChannel.trim();
+    // Light validation: looksLikeSlackId catches typos before they cause a
+    // bewildering BAD_HOME_CHANNEL error at notify-time.
+    if (homeChannel) {
+        const { looksLikeSlackId } = await import("../gateway/target-parser.js");
+        if (!looksLikeSlackId(homeChannel)) {
+            return {
+                ok: false,
+                path,
+                reason: `SLACK_HOME_CHANNEL "${homeChannel}" doesn't look like a Slack ID (C…/G…/D…/U… plus 8+ uppercase alphanumeric chars).`,
+            };
+        }
+    }
+    const content = renderEnvFile({
+        botToken,
+        appToken,
+        session: session || undefined,
+        users: users || undefined,
+        homeChannel: homeChannel || undefined,
+    });
+    mkdirSync(dirname(path), { recursive: true });
+    // Atomic, perm-safe write. mkdtempSync creates a brand-new sibling dir with
+    // a unique suffix (mode 0o700 on POSIX), so the temp file inside is always
+    // freshly created — `{ mode: 0o600 }` is guaranteed to apply, and there's
+    // no chance of stomping a pre-existing temp file with stale perms. The
+    // final rename then atomically installs the 0o600 file into place.
+    let tmpDir = null;
+    let tmpFile = null;
+    try {
+        tmpDir = mkdtempSync(join(dirname(path), ".env-init-"));
+        tmpFile = join(tmpDir, "env");
+        writeFileSync(tmpFile, content, { mode: 0o600, encoding: "utf8" });
+        // Defense-in-depth: confirm the perms we asked for are what we got
+        // before we publish the file. On Windows the check is a no-op.
+        if (process.platform !== "win32") {
+            const mode = statSync(tmpFile).mode & 0o777;
+            if (mode !== 0o600) {
+                throw new Error(`temp file mode is ${mode.toString(8)}, expected 600`);
+            }
+        }
+        renameSync(tmpFile, path);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { ok: false, path, reason: `failed to write ${path}: ${msg}` };
+    }
+    finally {
+        if (tmpDir) {
+            try {
+                rmSync(tmpDir, { recursive: true, force: true });
+            }
+            catch {
+                /* best effort */
+            }
+        }
+    }
+    // POSIX: file was created with mode 0o600 and that survives the rename.
+    // Windows: mode bits are largely meaningless. Either way, we never end up
+    // in a state where we'd need to apologize for the perms — if anything went
+    // wrong above we'd have returned the error already.
+    const lockedDown = process.platform !== "win32";
+    if (interactive) {
+        io.print("");
+        io.print(lockedDown ? `Wrote ${path} (chmod 600).` : `Wrote ${path}.`);
+        io.print("");
+        io.print("Next:");
+        io.print("  1. start a Copilot tmux session if one isn't running already");
+        io.print("     (any `omp-<digits>` name; e.g. `tmux new-session -d -s omp-9999`)");
+        io.print("  2. `omp gateway status`  — should report ready=true");
+        io.print("  3. `omp gateway serve`   — blocks; ^C to stop");
+        io.print("");
+    }
+    return { ok: true, path };
+}
+function renderEnvFile(k) {
+    const lines = [
+        "# Written by `omp env init`. Edit by hand or re-run the command.",
+        "# Precedence: shell exports always win over values in this file.",
+        "",
+        `SLACK_BOT_TOKEN=${k.botToken}`,
+        `SLACK_APP_TOKEN=${k.appToken}`,
+    ];
+    if (k.session)
+        lines.push(`COPILOT_TMUX_SESSION=${k.session}`);
+    if (k.users)
+        lines.push(`SLACK_ALLOWED_USERS=${k.users}`);
+    if (k.homeChannel)
+        lines.push(`SLACK_HOME_CHANNEL=${k.homeChannel}`);
+    lines.push("");
+    return lines.join("\n");
+}
+async function promptForToken(io, label, prefix) {
+    for (let attempt = 0; attempt < 3; attempt++) {
+        const value = ((await io.ask(`${label} (starts with ${prefix}): `)) ?? "").trim();
+        if (value.startsWith(prefix))
+            return value;
+        if (!value) {
+            io.print(`  ${label} is required.`);
+            continue;
+        }
+        io.print(`  That doesn't look like a ${label.toLowerCase()} (expected to start with "${prefix}").`);
+    }
+    // Caller's final validation will reject — we don't throw here so the call
+    // site can return a structured error.
+    return "";
+}
+/** Read an existing file and return user-visible lines with values masked. */
+function readExistingMasked(path) {
+    try {
+        return readFileSync(path, "utf8")
+            .split(/\r?\n/)
+            .filter((l) => l.trim() && !l.trim().startsWith("#"))
+            .map((line) => {
+            const i = line.indexOf("=");
+            if (i === -1)
+                return line;
+            const key = line.slice(0, i);
+            const val = line.slice(i + 1);
+            return `${key}=${maskValue(val)}`;
+        });
+    }
+    catch {
+        return ["(could not read existing file)"];
+    }
+}
+function maskValue(v) {
+    const trimmed = v.trim();
+    if (trimmed.length <= 4)
+        return "****";
+    // Show prefix (e.g. xoxb-) + 3 stars + last 4 chars to confirm identity
+    // without leaking the bulk of the secret.
+    const dashIndex = trimmed.indexOf("-");
+    const prefix = dashIndex >= 0 ? trimmed.slice(0, dashIndex + 1) : "";
+    const tail = trimmed.slice(-4);
+    return `${prefix}***${tail}`;
+}
+//# sourceMappingURL=init.js.map

package/dist/src/env/init.js.map

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

package/dist/src/gateway/connector.d.ts

@@ -0,0 +1,37 @@
+/**
+ * A Gateway Connector is a long-lived event source that the gateway runtime
+ * starts, watches for readiness, and stops cleanly on shutdown. Connectors are
+ * intentionally tiny: name + lifecycle + status snapshot. All transport-specific
+ * concerns (Bolt, HTTP, MCP, etc.) live inside the connector implementation.
+ *
+ * Why not just call `runSlackBot()`? Adding a second connector later (Telegram,
+ * Discord, webhook) becomes one file implementing this interface, not a new
+ * top-level command and a new lifecycle.
+ */
+export interface ConnectorStatus {
+    /** True when the connector is connected and ready to handle events. */
+    ready: boolean;
+    /** Optional human-readable detail — error message, "not started", etc. */
+    detail?: string;
+}
+export interface Connector {
+    /** Stable identifier, e.g. "slack". Used for `--only` filtering and status output. */
+    readonly name: string;
+    /** Open whatever long-lived resources are needed (sockets, listeners). */
+    start(): Promise<void>;
+    /** Close cleanly. Must be idempotent — calling stop() twice is a no-op. */
+    stop(): Promise<void>;
+    /** Synchronous readiness snapshot — never opens sockets or makes I/O calls. */
+    status(): ConnectorStatus;
+}
+/**
+ * Static (no-I/O) readiness check for the doctor command. Connectors expose
+ * this so `omp gateway status` can answer "is this startable?" without
+ * actually starting it.
+ */
+export interface ConnectorDoctor {
+    /** Same name as the Connector. */
+    readonly name: string;
+    /** Returns a snapshot reporting whether start() would currently succeed. */
+    doctor(): ConnectorStatus;
+}

package/dist/src/gateway/connector.js

@@ -0,0 +1,12 @@
+/**
+ * A Gateway Connector is a long-lived event source that the gateway runtime
+ * starts, watches for readiness, and stops cleanly on shutdown. Connectors are
+ * intentionally tiny: name + lifecycle + status snapshot. All transport-specific
+ * concerns (Bolt, HTTP, MCP, etc.) live inside the connector implementation.
+ *
+ * Why not just call `runSlackBot()`? Adding a second connector later (Telegram,
+ * Discord, webhook) becomes one file implementing this interface, not a new
+ * top-level command and a new lifecycle.
+ */
+export {};
+//# sourceMappingURL=connector.js.map

package/dist/src/gateway/connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../src/gateway/connector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/src/gateway/connectors/slack.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Slack {@link Connector} — wraps the @slack/bolt Socket Mode adapter that
+ * used to live in src/slack/serve.ts. Pure handler logic (handler.ts) and
+ * config loader (config.ts) are reused unchanged.
+ *
+ * Lifecycle:
+ *   start() → instantiate Bolt App, auth.test for botUserId, subscribe to
+ *             app.message (DMs) + app.event("app_mention"), then app.start().
+ *             If anything throws, state.error is recorded and status reports
+ *             not ready — the gateway runtime treats it as a failed start.
+ *   stop()  → idempotent app.stop().
+ *   status()→ derived from internal state; never opens sockets.
+ */
+import type { Connector, ConnectorDoctor } from "../connector.js";
+import type { SlackConfig } from "../../slack/config.js";
+import { type SlackHandlerDeps } from "../../slack/handler.js";
+export interface BoltLike {
+    client: {
+        auth: {
+            test: () => Promise<{
+                user_id?: string;
+            }>;
+        };
+    };
+    start: () => Promise<unknown>;
+    stop: () => Promise<unknown>;
+    message: (handler: (args: {
+        message: SlackMessage;
+        say: SaySig;
+    }) => Promise<void>) => void;
+    event: (name: "app_mention", handler: (args: {
+        event: SlackMessage;
+        say: SaySig;
+    }) => Promise<void>) => void;
+}
+export type AppFactory = (config: SlackConfig) => BoltLike;
+export type SaySig = (msg: {
+    text: string;
+    thread_ts?: string;
+}) => Promise<unknown>;
+export interface SlackMessage {
+    text?: string;
+    user?: string;
+    bot_id?: string;
+    subtype?: string;
+    channel_type?: string;
+    thread_ts?: string;
+    ts?: string;
+}
+export interface SlackConnectorOptions {
+    config: SlackConfig;
+    /** Inject an App factory for testing; default lazy-loads @slack/bolt. */
+    appFactory?: AppFactory;
+    /** Inject handler deps for testing; default wires comms resolveSession + commsAsk. */
+    handlerDeps?: Omit<SlackHandlerDeps, "allowedUsers" | "requireMention" | "sessionEnv">;
+    /** Logger; defaults to console.error. */
+    log?: (msg: string) => void;
+}
+export declare const SLACK_CONNECTOR_NAME = "slack";
+/**
+ * Build a Slack {@link Connector}. The factory is sync; all I/O happens in
+ * `start()`.
+ */
+export declare function createSlackConnector(opts: SlackConnectorOptions): Connector;
+/**
+ * Static readiness check (no sockets opened). True when both tokens are
+ * present in the loaded config AND a Copilot tmux session can be resolved.
+ */
+export declare function slackDoctor(config: SlackConfig | null, errorIfNoConfig?: string): ConnectorDoctor;

package/dist/src/gateway/connectors/slack.js

@@ -0,0 +1,159 @@
+import { handleSlackMessage, } from "../../slack/handler.js";
+import { resolveSession } from "../../comms/resolve-session.js";
+import { commsAsk } from "../../comms/index.js";
+export const SLACK_CONNECTOR_NAME = "slack";
+async function defaultAppFactory(config) {
+    const bolt = await import("@slack/bolt");
+    // Bolt is CJS; default-import under NodeNext.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const Mod = bolt;
+    const App = Mod.App ?? Mod.default?.App;
+    if (!App)
+        throw new Error("@slack/bolt: App export not found");
+    return new App({
+        token: config.botToken,
+        appToken: config.appToken,
+        socketMode: true,
+    });
+}
+/**
+ * Build a Slack {@link Connector}. The factory is sync; all I/O happens in
+ * `start()`.
+ */
+export function createSlackConnector(opts) {
+    const { config, appFactory, handlerDeps, log = (m) => console.error(m) } = opts;
+    let app;
+    let started = false;
+    let stopping = false;
+    let botUserId;
+    let lastError;
+    const baseDeps = {
+        resolve: handlerDeps?.resolve ?? ((o) => resolveSession(o)),
+        ask: handlerDeps?.ask ?? ((session, text) => commsAsk(session, text)),
+        allowedUsers: config.allowedUsers,
+        requireMention: config.requireMention,
+        sessionEnv: config.sessionEnv,
+    };
+    async function respond(input, say) {
+        try {
+            const res = await handleSlackMessage(input, baseDeps);
+            if (res.reply)
+                await say({ text: res.reply, thread_ts: res.threadTs });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            log(`omp slack: handler error: ${msg}`);
+            try {
+                await say({ text: ":warning: internal error handling your message.", thread_ts: input.threadTs });
+            }
+            catch {
+                /* best effort */
+            }
+        }
+    }
+    return {
+        name: SLACK_CONNECTOR_NAME,
+        async start() {
+            if (started)
+                return;
+            try {
+                app = appFactory ? appFactory(config) : await defaultAppFactory(config);
+                const auth = await app.client.auth.test();
+                botUserId = auth.user_id;
+                app.message(async ({ message, say }) => {
+                    if (message.subtype || message.bot_id || message.user === botUserId)
+                        return;
+                    if (message.channel_type !== "im")
+                        return; // DMs only
+                    await respond({
+                        text: message.text ?? "",
+                        userId: message.user,
+                        channelType: "im",
+                        isMention: false,
+                        // Only stay in-thread when the user wrote IN a thread. For top-level
+                        // DMs we post inline — Slack hides DM thread replies under a
+                        // "View thread" link, which makes the reply look like it never arrived.
+                        threadTs: message.thread_ts,
+                        botUserId,
+                    }, say);
+                });
+                app.event("app_mention", async ({ event, say }) => {
+                    if (event.bot_id || event.user === botUserId)
+                        return;
+                    await respond({
+                        text: event.text ?? "",
+                        userId: event.user,
+                        channelType: "channel",
+                        isMention: true,
+                        threadTs: event.thread_ts ?? event.ts,
+                        botUserId,
+                    }, say);
+                });
+                await app.start();
+                started = true;
+                lastError = undefined;
+                log(`omp slack: connected via Socket Mode as ${botUserId ?? "bot"} — listening for DMs and @mentions.`);
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err.message : String(err);
+                // Clean up partial state so a retry can proceed.
+                if (app) {
+                    try {
+                        await app.stop();
+                    }
+                    catch {
+                        /* ignore */
+                    }
+                }
+                app = undefined;
+                started = false;
+                throw err;
+            }
+        },
+        async stop() {
+            if (stopping)
+                return;
+            stopping = true;
+            try {
+                if (app && started) {
+                    try {
+                        await app.stop();
+                    }
+                    catch (err) {
+                        log(`omp slack: stop error (ignored): ${err instanceof Error ? err.message : String(err)}`);
+                    }
+                }
+            }
+            finally {
+                app = undefined;
+                started = false;
+                stopping = false;
+            }
+        },
+        status() {
+            if (started)
+                return { ready: true };
+            if (lastError)
+                return { ready: false, detail: lastError };
+            return { ready: false, detail: "not started" };
+        },
+    };
+}
+/**
+ * Static readiness check (no sockets opened). True when both tokens are
+ * present in the loaded config AND a Copilot tmux session can be resolved.
+ */
+export function slackDoctor(config, errorIfNoConfig) {
+    return {
+        name: SLACK_CONNECTOR_NAME,
+        doctor() {
+            if (!config)
+                return { ready: false, detail: errorIfNoConfig ?? "missing slack tokens" };
+            const resolved = resolveSession({ env: config.sessionEnv });
+            if (!resolved.ok)
+                return { ready: false, detail: resolved.error };
+            return { ready: true, detail: `session=${resolved.session}` };
+        },
+    };
+}
+//# sourceMappingURL=slack.js.map

package/dist/src/gateway/connectors/slack.js.map

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

package/dist/src/gateway/notify.d.ts

@@ -0,0 +1,35 @@
+export interface NotifyDeps {
+    /** Override env (tests). Defaults to process.env. */
+    env?: NodeJS.ProcessEnv;
+    /** Override fetch (tests). Defaults to global fetch. */
+    fetch?: typeof fetch;
+    /** Override sleep (tests bypass backoff). */
+    sleep?: (ms: number) => Promise<void>;
+}
+export interface NotifyOptions {
+    text: string;
+    /** Explicit target. When omitted, falls back to `SLACK_HOME_CHANNEL`. */
+    target?: string;
+    /** Optional thread to reply in (overrides target's :thread_ts suffix). */
+    threadTs?: string;
+    /** Max total wait incl. retries. Default 10s. */
+    timeoutMs?: number;
+}
+export type NotifyErrorCode = "MISSING_TOKEN" | "MISSING_TARGET" | "BAD_TARGET" | "BAD_HOME_CHANNEL" | "OPEN_FAILED" | "POST_FAILED" | "RATE_LIMITED" | "TIMEOUT" | "NETWORK_ERROR";
+export type NotifyResult = {
+    ok: true;
+    channel: string;
+    ts: string;
+    /** True when we had to call conversations.open to map U… → D…. */
+    openedIm: boolean;
+} | {
+    ok: false;
+    code: NotifyErrorCode;
+    reason: string;
+};
+/**
+ * Send a Slack message. Library entry point — never throws. Returns a
+ * structured result so callers (cron / `/slack send` skill / CLI) decide
+ * how to surface or persist failures.
+ */
+export declare function notify(opts: NotifyOptions, deps?: NotifyDeps): Promise<NotifyResult>;