slackhive 0.1.37 → 0.1.39

package/apps/runner/dist/memory-watcher.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @fileoverview Memory watcher — the primary learning mechanism for agents.
+ *
+ * Watches the agent's memory directory (`/tmp/agents/{slug}/.claude/memory/`)
+ * for file changes made by the Claude Code SDK during conversations. When the
+ * SDK writes a new memory file or updates an existing one, this watcher reads
+ * the file, parses the frontmatter to extract the memory type and name, and
+ * upserts the record into the `memories` database table.
+ *
+ * This is how agents learn: every memory the SDK writes during a conversation
+ * is immediately persisted to Postgres. On the next agent restart, all memories
+ * are re-materialized to disk so the agent starts with full accumulated knowledge.
+ *
+ * Memory file format (frontmatter + markdown body):
+ * ```markdown
+ * ---
+ * name: feedback_avoid_mocking
+ * description: Don't mock the database in tests
+ * type: feedback
+ * ---
+ *
+ * Memory content here...
+ * ```
+ *
+ * @module runner/memory-watcher
+ */
+import type { Agent, Memory } from '@slackhive/shared';
+/**
+ * Watches an agent's memory directory for new or updated memory files,
+ * persisting changes to the database as they occur.
+ *
+ * @example
+ * const watcher = new MemoryWatcher(agent);
+ * watcher.start();
+ * // ... agent runs ...
+ * watcher.stop();
+ */
+export declare class MemoryWatcher {
+    private readonly agent;
+    private readonly memoryDir;
+    private readonly sessionsDir;
+    private watchers;
+    private debounceTimers;
+    private readonly log;
+    constructor(agent: Agent);
+    start(): void;
+    /** Watch the sessions root for new session directories being created. */
+    private watchSessionsRoot;
+    /** Watch a specific memory directory for .md file changes. */
+    private watchDir;
+    stop(): void;
+    private handleMemoryFileChange;
+}
+/**
+ * Parsed result from a memory file's YAML frontmatter.
+ */
+interface ParsedMemoryFrontmatter {
+    name: string;
+    type: Memory['type'];
+}
+/**
+ * Parses the YAML frontmatter from a memory file to extract `name` and `type`.
+ *
+ * Memory files written by the Claude Code SDK follow the format:
+ * ```
+ * ---
+ * name: some_memory_name
+ * type: feedback
+ * description: optional description
+ * ---
+ * Content...
+ * ```
+ *
+ * @param {string} content - Full file content including frontmatter.
+ * @returns {ParsedMemoryFrontmatter | null} Parsed frontmatter, or null if invalid.
+ */
+export declare function parseMemoryFile(content: string): ParsedMemoryFrontmatter | null;
+export {};

package/apps/runner/dist/memory-watcher.js

@@ -0,0 +1,220 @@
+"use strict";
+/**
+ * @fileoverview Memory watcher — the primary learning mechanism for agents.
+ *
+ * Watches the agent's memory directory (`/tmp/agents/{slug}/.claude/memory/`)
+ * for file changes made by the Claude Code SDK during conversations. When the
+ * SDK writes a new memory file or updates an existing one, this watcher reads
+ * the file, parses the frontmatter to extract the memory type and name, and
+ * upserts the record into the `memories` database table.
+ *
+ * This is how agents learn: every memory the SDK writes during a conversation
+ * is immediately persisted to Postgres. On the next agent restart, all memories
+ * are re-materialized to disk so the agent starts with full accumulated knowledge.
+ *
+ * Memory file format (frontmatter + markdown body):
+ * ```markdown
+ * ---
+ * name: feedback_avoid_mocking
+ * description: Don't mock the database in tests
+ * type: feedback
+ * ---
+ *
+ * Memory content here...
+ * ```
+ *
+ * @module runner/memory-watcher
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryWatcher = void 0;
+exports.parseMemoryFile = parseMemoryFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const db_1 = require("./db");
+const logger_1 = require("./logger");
+const compile_claude_md_1 = require("./compile-claude-md");
+/** Delay in ms after a file change before reading it (debounce). */
+const DEBOUNCE_MS = 200;
+/**
+ * Watches an agent's memory directory for new or updated memory files,
+ * persisting changes to the database as they occur.
+ *
+ * @example
+ * const watcher = new MemoryWatcher(agent);
+ * watcher.start();
+ * // ... agent runs ...
+ * watcher.stop();
+ */
+class MemoryWatcher {
+    agent;
+    memoryDir;
+    sessionsDir;
+    watchers = [];
+    debounceTimers = new Map();
+    log;
+    constructor(agent) {
+        this.agent = agent;
+        const workDir = (0, compile_claude_md_1.getAgentWorkDir)(agent.slug);
+        this.memoryDir = path.join(workDir, 'memory');
+        this.sessionsDir = path.join(workDir, 'sessions');
+        this.log = (0, logger_1.agentLogger)(agent.slug);
+    }
+    start() {
+        if (this.watchers.length > 0)
+            return;
+        // Only watch session memory dirs — root memory dir is read-only (materialized from DB on startup)
+        fs.mkdirSync(this.sessionsDir, { recursive: true });
+        this.watchSessionsRoot();
+        this.log.info('Memory watcher started', { sessionsDir: this.sessionsDir });
+    }
+    /** Watch the sessions root for new session directories being created. */
+    watchSessionsRoot() {
+        const watcher = fs.watch(this.sessionsDir, { persistent: false }, (eventType, filename) => {
+            if (!filename)
+                return;
+            const sessionDir = path.join(this.sessionsDir, filename);
+            const memDir = path.join(sessionDir, 'memory');
+            // When a new session dir appears, start watching its memory dir
+            if (fs.existsSync(sessionDir) && fs.statSync(sessionDir).isDirectory()) {
+                fs.mkdirSync(memDir, { recursive: true });
+                this.watchDir(memDir);
+            }
+        });
+        watcher.on('error', (err) => this.log.warn('Sessions root watcher error', { error: err.message }));
+        this.watchers.push(watcher);
+        // Also watch any existing session memory dirs
+        if (fs.existsSync(this.sessionsDir)) {
+            for (const entry of fs.readdirSync(this.sessionsDir)) {
+                const memDir = path.join(this.sessionsDir, entry, 'memory');
+                fs.mkdirSync(memDir, { recursive: true });
+                this.watchDir(memDir);
+            }
+        }
+    }
+    /** Watch a specific memory directory for .md file changes. */
+    watchDir(memDir) {
+        // Avoid duplicate watchers
+        const watcher = fs.watch(memDir, { persistent: false }, (eventType, filename) => {
+            if (!filename || !filename.endsWith('.md'))
+                return;
+            const filePath = path.join(memDir, filename);
+            const timerKey = filePath;
+            const existing = this.debounceTimers.get(timerKey);
+            if (existing)
+                clearTimeout(existing);
+            const timer = setTimeout(() => {
+                this.debounceTimers.delete(timerKey);
+                this.handleMemoryFileChange(filePath).catch((err) => {
+                    this.log.error('Failed to sync memory file', { filePath, error: err.message });
+                });
+            }, DEBOUNCE_MS);
+            this.debounceTimers.set(timerKey, timer);
+        });
+        watcher.on('error', (err) => this.log.warn('Memory dir watcher error', { dir: memDir, error: err.message }));
+        this.watchers.push(watcher);
+    }
+    stop() {
+        for (const w of this.watchers)
+            w.close();
+        this.watchers = [];
+        for (const timer of this.debounceTimers.values())
+            clearTimeout(timer);
+        this.debounceTimers.clear();
+        this.log.info('Memory watcher stopped');
+    }
+    async handleMemoryFileChange(filePath) {
+        if (!fs.existsSync(filePath)) {
+            // File was deleted — we keep the DB record (deletions are explicit via UI)
+            return;
+        }
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const parsed = parseMemoryFile(content);
+        if (!parsed) {
+            this.log.warn('Could not parse memory file, skipping', { filePath });
+            return;
+        }
+        await (0, db_1.upsertMemorySafe)(this.agent.id, parsed.type, parsed.name, content);
+        this.log.info('Memory synced to DB', {
+            filePath,
+            name: parsed.name,
+            type: parsed.type,
+        });
+    }
+}
+exports.MemoryWatcher = MemoryWatcher;
+/**
+ * Parses the YAML frontmatter from a memory file to extract `name` and `type`.
+ *
+ * Memory files written by the Claude Code SDK follow the format:
+ * ```
+ * ---
+ * name: some_memory_name
+ * type: feedback
+ * description: optional description
+ * ---
+ * Content...
+ * ```
+ *
+ * @param {string} content - Full file content including frontmatter.
+ * @returns {ParsedMemoryFrontmatter | null} Parsed frontmatter, or null if invalid.
+ */
+function parseMemoryFile(content) {
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!frontmatterMatch)
+        return null;
+    const frontmatter = frontmatterMatch[1];
+    const name = extractField(frontmatter, 'name');
+    const type = extractField(frontmatter, 'type');
+    if (!name || !type)
+        return null;
+    const validTypes = ['user', 'feedback', 'project', 'reference'];
+    if (!validTypes.includes(type))
+        return null;
+    return { name, type };
+}
+/**
+ * Extracts a single YAML field value from a frontmatter string.
+ * Only supports simple `key: value` pairs (no nested objects or arrays).
+ *
+ * @param {string} frontmatter - YAML frontmatter content.
+ * @param {string} field - Field name to extract.
+ * @returns {string | null} Trimmed field value, or null if not found.
+ */
+function extractField(frontmatter, field) {
+    const match = frontmatter.match(new RegExp(`^${field}:\\s*(.+)$`, 'm'));
+    return match ? match[1].trim() : null;
+}
+//# sourceMappingURL=memory-watcher.js.map

package/apps/runner/dist/memory-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-watcher.js","sourceRoot":"","sources":["../src/memory-watcher.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8JH,0CAcC;AA1KD,uCAAyB;AACzB,2CAA6B;AAE7B,6BAAwC;AACxC,qCAAuC;AACvC,2DAAsD;AAEtD,oEAAoE;AACpE,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB;;;;;;;;;GASG;AACH,MAAa,aAAa;IACP,KAAK,CAAQ;IACb,SAAS,CAAS;IAClB,WAAW,CAAS;IAC7B,QAAQ,GAAmB,EAAE,CAAC;IAC9B,cAAc,GAAgC,IAAI,GAAG,EAAE,CAAC;IAC/C,GAAG,CAAiC;IAErD,YAAY,KAAY;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,MAAM,OAAO,GAAG,IAAA,mCAAe,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,GAAG,GAAG,IAAA,oBAAW,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO;QAErC,kGAAkG;QAClG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,yEAAyE;IACjE,iBAAiB;QACvB,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;YACxF,IAAI,CAAC,QAAQ;gBAAE,OAAO;YACtB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YACzD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAC/C,gEAAgE;YAChE,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC1C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACnG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE5B,8CAA8C;QAC9C,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACpC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBACrD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;gBAC5D,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC1C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;IAED,8DAA8D;IACtD,QAAQ,CAAC,MAAc;QAC7B,2BAA2B;QAC3B,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;YAC9E,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,OAAO;YACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC7C,MAAM,QAAQ,GAAG,QAAQ,CAAC;YAE1B,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACnD,IAAI,QAAQ;gBAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;YAErC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACrC,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;oBAClD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,4BAA4B,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACjF,CAAC,CAAC,CAAC;YACL,CAAC,EAAE,WAAW,CAAC,CAAC;YAEhB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC7G,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI;QACF,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ;YAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACtE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAC1C,CAAC;IAEO,KAAK,CAAC,sBAAsB,CAAC,QAAgB;QAEnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,2EAA2E;YAC3E,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAExC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,uCAAuC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QAED,MAAM,IAAA,qBAAgB,EAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAEzE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE;YACnC,QAAQ;YACR,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC,CAAC;IACL,CAAC;CACF;AA1GD,sCA0GC;AAcD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,eAAe,CAAC,OAAe;IAC7C,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAChE,IAAI,CAAC,gBAAgB;QAAE,OAAO,IAAI,CAAC;IAEnC,MAAM,WAAW,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,EAAE,MAAM,CAA0B,CAAC;IAExE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,MAAM,UAAU,GAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAClF,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5C,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,YAAY,CAAC,WAAmB,EAAE,KAAa;IACtD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACxC,CAAC"}

package/apps/runner/dist/slack-handler.d.ts

@@ -0,0 +1,120 @@
+/**
+ * @fileoverview Slack event handler for a single agent's Bolt App.
+ *
+ * Key behaviours:
+ * - Abort/cancel: new message in same thread cancels the in-flight request
+ * - Tool status: shows friendly "Querying Redshift…" live in the status message
+ * - Fallback text: uses lastAssistantText if no messages were sent during stream
+ * - result message: extracts final result from SDK result.subtype === 'success'
+ * - Reaction cycling: thinking_face → gear → white_check_mark / x
+ * - Markdown→Slack formatting: **bold** → *bold*, headings, tables, code blocks
+ * - Block Kit: tables rendered as native Slack table blocks with section chunks
+ *
+ * @module runner/slack-handler
+ */
+import type { App } from '@slack/bolt';
+import type { Agent, Restriction } from '@slackhive/shared';
+import type { ClaudeHandler } from './claude-handler';
+import type { Logger } from 'winston';
+import type { ContentBlockParam } from '@anthropic-ai/sdk/resources';
+/**
+ * Registers all Slack event handlers for a single agent's Bolt App.
+ *
+ * Handles:
+ * - `app_mention` — responds when mentioned in a channel
+ * - `message` — responds to direct messages
+ * - `member_joined_channel` — posts a welcome message when added to a channel
+ *
+ * @param {App} app - The Slack Bolt App instance for this agent.
+ * @param {Agent} agent - The agent configuration record.
+ * @param {ClaudeHandler} claudeHandler - The Claude SDK session manager.
+ * @returns {void}
+ */
+export declare function registerSlackHandlers(app: App, agent: Agent, claudeHandler: ClaudeHandler, restrictions?: Restriction | null): void;
+export interface SlackFile {
+    id: string;
+    name?: string;
+    title?: string;
+    mimetype?: string;
+    filetype?: string;
+    url_private_download?: string;
+    size?: number;
+}
+/**
+ * Returns true if the channel is blocked by the agent's restrictions.
+ * If restrictions is null or allowedChannels is empty, the channel is allowed.
+ *
+ * @param {string} channelId - Slack channel ID of the incoming message.
+ * @param {Restriction | null} restrictions - Agent's restriction config.
+ * @returns {boolean} True if the message should be silently ignored.
+ */
+export declare function isChannelRestricted(channelId: string, restrictions: Restriction | null): boolean;
+/**
+ * Builds one or more Slack message payloads from Claude's response text.
+ * Each markdown table gets its own payload because Slack only supports
+ * one native table block per message.
+ *
+ * @param {string} text - Raw text from Claude.
+ * @param {boolean} isFinal - Whether this is the final message.
+ * @returns {{ text: string; blocks?: any[] }[]} Array of Slack-ready payloads.
+ */
+export declare function buildMessagePayloads(text: string, isFinal: boolean): {
+    text: string;
+    blocks?: any[];
+}[];
+/**
+ * Formats markdown text for Slack mrkdwn:
+ * - Preserves code blocks as-is (strips language hints)
+ * - Converts headings → *bold*
+ * - Removes HR lines
+ * - **bold** → *bold*
+ * - __italic__ → _italic_
+ * - Auto-wraps bare markdown tables in code blocks
+ */
+export declare function formatMessage(text: string, _isFinal: boolean): string;
+/** Splits text into ≤3000-char chunks for Slack section blocks. */
+export declare function splitTextForBlocks(text: string): string[];
+export declare function isSeparatorLine(line: string): boolean;
+export declare function extractFirstMarkdownTable(text: string): {
+    before: string;
+    tableLines: string[];
+    after: string;
+} | null;
+export declare function parseMarkdownTable(lines: string[]): {
+    headers: string[];
+    rows: string[][];
+    alignments: ('left' | 'center' | 'right')[];
+};
+export declare function buildSlackTableBlock(parsed: {
+    headers: string[];
+    rows: string[][];
+    alignments: ('left' | 'center' | 'right')[];
+}): Record<string, any>;
+/**
+ * Builds a human-readable status string for the first tool_use block in a
+ * Claude assistant message. Used to keep the user informed while a tool runs.
+ *
+ * Returns a Slack mrkdwn string like `*Querying Redshift*\n\`\`\`sql\n...\n\`\`\``
+ * for known tools, `*Working...*` for unknown tools, or null if no tool block.
+ *
+ * @param {unknown[]} content - The `content` array from a Claude assistant message.
+ * @returns {string | null} Slack-formatted status text, or null if no tool was used.
+ */
+export declare function formatToolStatus(content: any[]): string | null;
+export declare function getFileKind(file: SlackFile): 'text' | 'image' | 'pdf' | 'unsupported';
+export declare function downloadFile(client: any, file: SlackFile, log: Logger): Promise<{
+    kind: 'text';
+    content: string;
+} | {
+    kind: 'block';
+    block: ContentBlockParam;
+} | null>;
+export declare function buildPrompt(client: any, channelId: string, threadTs: string | undefined, userText: string, agent: Agent, log: Logger, files?: SlackFile[]): Promise<string | ContentBlockParam[]>;
+/**
+ * Removes `<@BOT_USER_ID>` mention tokens from a message string.
+ *
+ * @param {string} text - Raw Slack message text.
+ * @param {string} [botUserId] - The bot's Slack user ID. No-op if undefined.
+ * @returns {string} Text with all bot mention tokens stripped and trimmed.
+ */
+export declare function stripBotMention(text: string, botUserId?: string): string;