slackhive 0.1.41 → 0.1.43

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

@@ -1,78 +0,0 @@
-/**
- * @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

@@ -1,220 +0,0 @@
-"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

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

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

@@ -1,120 +0,0 @@
-/**
- * @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;