@moxxy/plugin-channel-slack 0.27.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moxxy (moxxy.ai)
+
+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/dist/channel/slack-client.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Minimal hand-rolled Slack Web API client. The repo norm is hand-rolled
+ * `fetch` over a vendor SDK (only Telegram pulls in grammy), so there is NO
+ * `@slack/web-api` dependency: each method POSTs JSON to
+ * `https://slack.com/api/<method>` with `Authorization: Bearer <token>` and
+ * throws on a non-`ok` Slack response.
+ */
+export interface SlackClientOptions {
+    readonly token: string;
+    /** Override the API base (tests). */
+    readonly baseUrl?: string;
+    /** Injectable fetch (tests). Defaults to the global `fetch`. */
+    readonly fetchImpl?: typeof fetch;
+}
+export interface AuthTestResult {
+    /** The bot's own user id — used to drop the bot's own messages. */
+    readonly botUserId: string;
+    readonly teamId?: string;
+    readonly team?: string;
+    readonly url?: string;
+}
+export interface PostMessageResult {
+    readonly channel: string;
+    /** The new message ts — used as the edit target for streaming. */
+    readonly ts: string;
+}
+export declare class SlackClient {
+    private readonly token;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    constructor(opts: SlackClientOptions);
+    private call;
+    /** Validate the token and capture the bot's own user id. */
+    authTest(): Promise<AuthTestResult>;
+    /** Post a message into a channel/thread. Returns the channel + new ts. */
+    postMessage(args: {
+        channel: string;
+        text: string;
+        threadTs?: string;
+    }): Promise<PostMessageResult>;
+    /** Edit an existing message (the streaming-update path). */
+    updateMessage(args: {
+        channel: string;
+        ts: string;
+        text: string;
+    }): Promise<void>;
+    /** Optional: read a thread's replies (unused by v1 streaming, exposed for tools). */
+    conversationsReplies(args: {
+        channel: string;
+        ts: string;
+    }): Promise<ReadonlyArray<Record<string, unknown>>>;
+}
+//# sourceMappingURL=slack-client.d.ts.map

package/dist/channel/slack-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-client.d.ts","sourceRoot":"","sources":["../../src/channel/slack-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AASD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,IAAI,EAAE,kBAAkB;YAMtB,IAAI;IAqBlB,4DAA4D;IACtD,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC;IAYzC,0EAA0E;IACpE,WAAW,CAAC,IAAI,EAAE;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAY9B,4DAA4D;IACtD,aAAa,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvF,qFAAqF;IAC/E,oBAAoB,CAAC,IAAI,EAAE;QAC/B,OAAO,EAAE,MAAM,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;KACZ,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAQpD"}

package/dist/channel/slack-client.js

@@ -0,0 +1,82 @@
+/**
+ * Minimal hand-rolled Slack Web API client. The repo norm is hand-rolled
+ * `fetch` over a vendor SDK (only Telegram pulls in grammy), so there is NO
+ * `@slack/web-api` dependency: each method POSTs JSON to
+ * `https://slack.com/api/<method>` with `Authorization: Bearer <token>` and
+ * throws on a non-`ok` Slack response.
+ */
+const SLACK_API_BASE = 'https://slack.com/api';
+export class SlackClient {
+    token;
+    baseUrl;
+    fetchImpl;
+    constructor(opts) {
+        this.token = opts.token;
+        this.baseUrl = (opts.baseUrl ?? SLACK_API_BASE).replace(/\/+$/, '');
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+    }
+    async call(method, body) {
+        const res = await this.fetchImpl(`${this.baseUrl}/${method}`, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json; charset=utf-8',
+                authorization: `Bearer ${this.token}`,
+            },
+            body: JSON.stringify(body),
+        });
+        // Slack always returns 200 with `{ ok: false, error }` for app-level errors;
+        // a non-2xx is a transport/auth problem worth surfacing distinctly.
+        if (!res.ok) {
+            throw new Error(`Slack ${method} HTTP ${res.status}`);
+        }
+        const json = (await res.json());
+        if (!json.ok) {
+            throw new Error(`Slack ${method} failed: ${json.error ?? 'unknown_error'}`);
+        }
+        return json;
+    }
+    /** Validate the token and capture the bot's own user id. */
+    async authTest() {
+        const json = await this.call('auth.test', {});
+        const botUserId = typeof json['user_id'] === 'string' ? json['user_id'] : '';
+        if (!botUserId)
+            throw new Error('Slack auth.test returned no user_id');
+        return {
+            botUserId,
+            ...(typeof json['team_id'] === 'string' ? { teamId: json['team_id'] } : {}),
+            ...(typeof json['team'] === 'string' ? { team: json['team'] } : {}),
+            ...(typeof json['url'] === 'string' ? { url: json['url'] } : {}),
+        };
+    }
+    /** Post a message into a channel/thread. Returns the channel + new ts. */
+    async postMessage(args) {
+        const json = await this.call('chat.postMessage', {
+            channel: args.channel,
+            text: args.text,
+            ...(args.threadTs ? { thread_ts: args.threadTs } : {}),
+        });
+        const channel = typeof json['channel'] === 'string' ? json['channel'] : args.channel;
+        const ts = typeof json['ts'] === 'string' ? json['ts'] : '';
+        if (!ts)
+            throw new Error('Slack chat.postMessage returned no ts');
+        return { channel, ts };
+    }
+    /** Edit an existing message (the streaming-update path). */
+    async updateMessage(args) {
+        await this.call('chat.update', {
+            channel: args.channel,
+            ts: args.ts,
+            text: args.text,
+        });
+    }
+    /** Optional: read a thread's replies (unused by v1 streaming, exposed for tools). */
+    async conversationsReplies(args) {
+        const json = await this.call('conversations.replies', {
+            channel: args.channel,
+            ts: args.ts,
+        });
+        const messages = json['messages'];
+        return Array.isArray(messages) ? messages : [];
+    }
+}
+//# sourceMappingURL=slack-client.js.map

package/dist/channel/slack-client.js.map

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

package/dist/channel/turn-runner.d.ts

@@ -0,0 +1,39 @@
+import type { newTurnId } from '@moxxy/core';
+import type { ClientSession as Session } from '@moxxy/sdk';
+import type { SlackClient } from './slack-client.js';
+export interface TurnRunnerLogger {
+    warn?(msg: string, meta?: Record<string, unknown>): void;
+}
+export interface RunSlackTurnDeps {
+    readonly session: Session;
+    readonly client: SlackClient;
+    readonly editFrameMs: number;
+    readonly logger?: TurnRunnerLogger;
+}
+export interface RunSlackTurnOptions {
+    /** Channel the triggering event arrived in. */
+    readonly channel: string;
+    /** Thread root for the reply: `event.thread_ts ?? event.ts`. */
+    readonly threadTs: string;
+    readonly text: string;
+    readonly model?: string;
+    readonly controller: AbortController;
+    /** Pre-minted turn id; the channel records it as an own-turn id. */
+    readonly turnId: ReturnType<typeof newTurnId>;
+}
+/**
+ * Drive a single Slack turn end-to-end: subscribe the frame pump to THIS turn's
+ * events (filtered by turnId — `session.log` fans out to every listener, so a
+ * concurrent turn on the same Session would otherwise stream into this thread,
+ * AGENTS.md invariant #8), run the turn through `runTurn`, flush the final
+ * frame, and unwind in `finally`.
+ *
+ * The streaming loop is `@moxxy/channel-kit`'s {@link FramePump} ("post once
+ * via `chat.postMessage`, then edit THAT message via `chat.update`, throttled
+ * to `editFrameMs`") over a {@link PlainTurnRenderer} snapshot; only the Slack
+ * Web-API calls live here. The turnId is minted by the caller so the channel
+ * can also record it as an own-turn id (it filters foreign-turn mirroring on
+ * those).
+ */
+export declare function runSlackTurn(deps: RunSlackTurnDeps, opts: RunSlackTurnOptions): Promise<void>;
+//# sourceMappingURL=turn-runner.d.ts.map

package/dist/channel/turn-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-runner.d.ts","sourceRoot":"","sources":["../../src/channel/turn-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,IAAI,OAAO,EAAE,MAAM,YAAY,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;CAC/C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CA6Df"}

package/dist/channel/turn-runner.js

@@ -0,0 +1,81 @@
+import { FramePump, PlainTurnRenderer, driveTurn, subscribeTurn } from '@moxxy/channel-kit';
+/**
+ * Drive a single Slack turn end-to-end: subscribe the frame pump to THIS turn's
+ * events (filtered by turnId — `session.log` fans out to every listener, so a
+ * concurrent turn on the same Session would otherwise stream into this thread,
+ * AGENTS.md invariant #8), run the turn through `runTurn`, flush the final
+ * frame, and unwind in `finally`.
+ *
+ * The streaming loop is `@moxxy/channel-kit`'s {@link FramePump} ("post once
+ * via `chat.postMessage`, then edit THAT message via `chat.update`, throttled
+ * to `editFrameMs`") over a {@link PlainTurnRenderer} snapshot; only the Slack
+ * Web-API calls live here. The turnId is minted by the caller so the channel
+ * can also record it as an own-turn id (it filters foreign-turn mirroring on
+ * those).
+ */
+export async function runSlackTurn(deps, opts) {
+    const { session, client, editFrameMs, logger } = deps;
+    const { channel, threadTs, text, model, controller, turnId } = opts;
+    const renderer = new PlainTurnRenderer();
+    const pump = new FramePump({
+        editFrameMs,
+        frame: () => renderer.snapshot(),
+        // Guarantee at least one message even when the turn produced no text.
+        emptyFinalText: '_(no output)_',
+        sink: {
+            send: async (t) => {
+                try {
+                    const res = await client.postMessage({ channel, text: t, threadTs });
+                    return res.ts;
+                }
+                catch (err) {
+                    logger?.warn?.('slack chat.postMessage failed', { err: String(err) });
+                    return null;
+                }
+            },
+            edit: async (ts, t) => {
+                try {
+                    await client.updateMessage({ channel, ts, text: t });
+                }
+                catch (err) {
+                    logger?.warn?.('slack chat.update failed', { err: String(err) });
+                }
+            },
+        },
+    });
+    const unsubscribe = subscribeTurn(session, turnId, (event) => {
+        if (renderer.accept(event))
+            pump.scheduleEdit();
+    });
+    try {
+        await driveTurn(session, {
+            turnId,
+            prompt: text,
+            ...(model ? { model } : {}),
+            signal: controller.signal,
+        });
+        await pump.flush(true);
+    }
+    catch (err) {
+        logger?.warn?.('slack turn failed', {
+            err: err instanceof Error ? err.message : String(err),
+        });
+        // Surface the failure into the thread rather than leaving a dangling
+        // placeholder. Errors from this send are swallowed (best-effort).
+        try {
+            await client.postMessage({
+                channel,
+                threadTs,
+                text: `Turn failed: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    finally {
+        unsubscribe();
+        pump.dispose();
+    }
+}
+//# sourceMappingURL=turn-runner.js.map

package/dist/channel/turn-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-runner.js","sourceRoot":"","sources":["../../src/channel/turn-runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AA0B5F;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAsB,EACtB,IAAyB;IAEzB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACtD,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEpE,MAAM,QAAQ,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,SAAS,CAAS;QACjC,WAAW;QACX,KAAK,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE;QAChC,sEAAsE;QACtE,cAAc,EAAE,eAAe;QAC/B,IAAI,EAAE;YACJ,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;gBAChB,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;oBACrE,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,EAAE,IAAI,EAAE,CAAC,+BAA+B,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBACtE,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YACD,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;gBACpB,IAAI,CAAC;oBACH,MAAM,MAAM,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;gBACvD,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,EAAE,IAAI,EAAE,CAAC,0BAA0B,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACnE,CAAC;YACH,CAAC;SACF;KACF,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;QAC3D,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,YAAY,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,OAAO,EAAE;YACvB,MAAM;YACN,MAAM,EAAE,IAAI;YACZ,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,IAAI,EAAE,CAAC,mBAAmB,EAAE;YAClC,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACtD,CAAC,CAAC;QACH,qEAAqE;QACrE,kEAAkE;QAClE,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,WAAW,CAAC;gBACvB,OAAO;gBACP,QAAQ;gBACR,IAAI,EAAE,gBAAgB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;aACzE,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;YAAS,CAAC;QACT,WAAW,EAAE,CAAC;QACd,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/channel.d.ts

@@ -0,0 +1,100 @@
+import type { ClientSession as Session } from '@moxxy/sdk';
+import type { Channel, ChannelHandle, ChannelStartOptsBase, PermissionResolver, TunnelProviderDef } from '@moxxy/sdk';
+import type { VaultStore } from '@moxxy/plugin-vault';
+import { SlackClient } from './channel/slack-client.js';
+export interface SlackChannelLogger {
+    debug?(msg: string, meta?: Record<string, unknown>): void;
+    info?(msg: string, meta?: Record<string, unknown>): void;
+    warn?(msg: string, meta?: Record<string, unknown>): void;
+    error?(msg: string, meta?: Record<string, unknown>): void;
+}
+export interface SlackChannelOptions {
+    readonly vault: VaultStore;
+    /**
+     * Tunnel provider used to expose the local ingest server publicly. Defaults to
+     * the self-hosted `proxyTunnel` (imported directly, like the webhooks tunnel);
+     * tests pass a fake provider so they never hit the network.
+     */
+    readonly tunnelProvider?: TunnelProviderDef;
+    /** Tools the model may call autonomously. `['*']` allows every registered tool. */
+    readonly allowedTools?: ReadonlyArray<string>;
+    /** Debounce window for streaming `chat.update` edits (ms). Default 1000. */
+    readonly editFrameMs?: number;
+    /** Bind host for the local ingest server. Default 127.0.0.1. */
+    readonly host?: string;
+    readonly logger?: SlackChannelLogger;
+    /** Injectable Slack client factory (tests). */
+    readonly makeClient?: (token: string) => SlackClient;
+}
+export interface SlackStartOpts extends ChannelStartOptsBase {
+    readonly session: Session;
+    /**
+     * If true, arm a TOFU pairing window: the first verified inbound event from a
+     * team/channel is captured and (via `onPairConfirm`) persisted to the vault.
+     */
+    readonly pair?: boolean;
+    /** Override allowedTools at start (the CLI forwards channel config / flags). */
+    readonly allowedTools?: ReadonlyArray<string>;
+}
+/** Fires when a verified event lands during a pairing window. */
+export interface PairCandidate {
+    readonly teamId: string;
+    readonly channelId: string;
+}
+export declare class SlackChannel implements Channel<SlackStartOpts> {
+    readonly name = "slack";
+    /**
+     * Installed on the session by the CLI dispatcher. Replaced in `start()` once
+     * we can expand a `['*']` allow-list against the live tool registry; until
+     * then it denies everything (safe default before start).
+     */
+    permissionResolver: PermissionResolver;
+    private readonly opts;
+    private session;
+    private client;
+    private ingest;
+    private tunnel;
+    private handle;
+    private resolveRunning;
+    private botUserId;
+    private authorization;
+    private model;
+    private readonly turns;
+    private currentChannelId;
+    private currentThreadTs;
+    private lastChannelId;
+    private lastThreadTs;
+    private logUnsub;
+    private readonly tofu;
+    private publicUrl;
+    constructor(opts: SlackChannelOptions);
+    /** The public Request URL to paste into Slack's Event Subscriptions. */
+    get requestUrl(): string | null;
+    /** Subscribe to pairing candidates (the setup/pair flows use this). */
+    onPairCandidate(listener: (c: PairCandidate) => void): () => void;
+    /** Persist a team/channel as authorized (called by the pair flow on confirm). */
+    confirmPairing(candidate: PairCandidate): Promise<void>;
+    start(startOpts: SlackStartOpts): Promise<ChannelHandle>;
+    private openTunnel;
+    /**
+     * TOFU pairing hook: while a pairing window is armed, the first verified event
+     * captures the team/channel and notifies listeners. It's "consumed" (no turn)
+     * so the very first message just establishes trust. Returns true when consumed.
+     */
+    private handlePairingCandidate;
+    /**
+     * Fire-and-forget a turn for an authorized event. Single-flight (v1): if a
+     * turn is already running we drop the new event with a thread reply rather
+     * than corrupting the per-turn state. The ingest handler has already ACKed.
+     */
+    private dispatchTurn;
+    private runTurn;
+    /**
+     * Post the assistant's prose for a turn this channel did not initiate. Gated by
+     * `!busy` (our own turns stream via the frame pump) and by having served a
+     * thread at least once. Skipped for our own turnIds (robust to async ordering /
+     * replay, invariant #8).
+     */
+    private mirrorForeignTurn;
+}
+//# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

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