slackhive 0.1.37 → 0.1.39

package/apps/runner/dist/compile-claude-md.js

@@ -0,0 +1,291 @@
+"use strict";
+/**
+ * @fileoverview Agent workspace compiler for the runner service.
+ *
+ * Writes two things to the agent's temporary working directory:
+ *
+ *   1. CLAUDE.md — the agent's main instruction/identity file.
+ *      Source: agents.claude_md column (or auto-generated for boss agents).
+ *      Memories are appended at the end.
+ *
+ *   2. .claude/commands/{filename} — Claude Code slash commands.
+ *      Source: skills table rows for this agent.
+ *      Each skill becomes an invokable /<filename> command.
+ *
+ * Directory layout:
+ *   /tmp/agents/{slug}/
+ *     CLAUDE.md                   ← identity + memories
+ *     .claude/
+ *       commands/
+ *         {filename}.md           ← one file per skill
+ *       memory/
+ *         {type}_{name}.md        ← materialized memory files
+ *
+ * @module runner/compile-claude-md
+ */
+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.getAgentWorkDir = getAgentWorkDir;
+exports.getClaudeMdPath = getClaudeMdPath;
+exports.compileClaudeMd = compileClaudeMd;
+exports.materializeMemoryFiles = materializeMemoryFiles;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const db_1 = require("./db");
+const logger_1 = require("./logger");
+/** Base directory for ephemeral agent workspaces. */
+const AGENTS_TMP_DIR = process.env.AGENTS_TMP_DIR ?? '/tmp/agents';
+/**
+ * Built-in /recall skill — injected for every agent automatically.
+ * Reads memory files from the agent's memory directory on disk.
+ */
+const RECALL_SKILL = `Search your memory files for context relevant to: $ARGUMENTS
+
+Use the Read tool to read files from the \`memory/\` directory (relative to your working directory).
+First read \`memory/MEMORY.md\` to see the index, then read specific memory files that match the topic.
+Apply what you find — past preferences, corrections, and patterns — so you don't repeat previous mistakes or ask questions you've already had answered.
+If no relevant memories are found, say so briefly and continue.`;
+/**
+ * Memory system instructions injected into every agent's CLAUDE.md.
+ * Tells the agent to persist learned facts to .claude/memory/ in its cwd.
+ */
+/**
+ * Slack formatting rules injected into every agent's CLAUDE.md.
+ * Built-in at the framework level — not visible in the Skills tab.
+ */
+const SLACK_FORMATTING_SECTION = `# Slack Formatting
+
+You are responding in Slack. Follow these rules for every message:
+
+**Text formatting:**
+- Bold: \`*bold*\` — NOT \`**bold**\`
+- Italic: \`_italic_\` — NOT \`*italic*\`
+- Section headers: \`*Header Text*\` on its own line — NOT \`#\`, \`##\`, \`###\`
+- Inline code: \`` + '`' + `code\`` + '`' + `
+- Code blocks: triple backticks with language hint (\`\`\`sql ... \`\`\`)
+- Lists: \`- item\` or \`1. item\`
+- Links: \`<url|text>\`
+- Horizontal rules: just a blank line — NOT \`---\` or \`***\`
+- Blockquotes: use plain text or \`_italic_\` — NOT \`>\`
+
+**Tables — use standard Markdown pipe format:**
+- Every row MUST start and end with \`|\`
+- Always include a separator row: \`|---|---|---|\`
+- Do NOT wrap tables in code blocks
+
+Good:
+\`\`\`
+| Name | Count |
+|---|---|
+| Alpha | 42 |
+\`\`\`
+
+**Never use:** \`## headings\`, \`**double asterisks**\`, \`> blockquotes\`, \`---\` rules`;
+/**
+ * Returns the temporary working directory path for an agent.
+ *
+ * @param {string} slug - Agent slug (e.g., "gilfoyle").
+ * @returns {string} Absolute path to the agent's temp workspace.
+ */
+function getAgentWorkDir(slug) {
+    return path.join(AGENTS_TMP_DIR, slug);
+}
+/**
+ * Returns the path to the CLAUDE.md file for an agent.
+ *
+ * @param {string} slug - Agent slug.
+ * @returns {string} Absolute path to CLAUDE.md.
+ */
+function getClaudeMdPath(slug) {
+    return path.join(getAgentWorkDir(slug), 'CLAUDE.md');
+}
+/**
+ * Compiles the agent workspace: writes CLAUDE.md and skill command files.
+ *
+ * - CLAUDE.md = agent.claudeMd (identity/instructions) + memory system + memories
+ * - .claude/commands/{filename}.md = one file per skill (Claude Code slash commands)
+ *
+ * For boss agents, CLAUDE.md is auto-generated from the team registry instead of
+ * agent.claudeMd (the boss-registry.ts module sets this before calling compileClaudeMd).
+ *
+ * @param {Agent} agent - The agent to compile for.
+ * @param {string} [overrideClaudeMd] - Optional override for CLAUDE.md content (used by boss registry).
+ * @returns {Promise<string>} The path to the agent's working directory (pass as cwd to SDK).
+ * @throws {Error} If writing to the filesystem fails.
+ */
+async function compileClaudeMd(agent, overrideClaudeMd) {
+    const workDir = getAgentWorkDir(agent.slug);
+    const claudeMdPath = getClaudeMdPath(agent.slug);
+    fs.mkdirSync(workDir, { recursive: true });
+    const skills = await (0, db_1.getAgentSkills)(agent.id);
+    logger_1.logger.info('Compiling agent workspace', {
+        agent: agent.slug,
+        skills: skills.length,
+    });
+    // -------------------------------------------------------------------------
+    // 1. Write CLAUDE.md (identity + memory system instructions)
+    // -------------------------------------------------------------------------
+    const claudeMdContent = buildClaudeMd(agent, overrideClaudeMd);
+    fs.writeFileSync(claudeMdPath, claudeMdContent, 'utf-8');
+    logger_1.logger.debug('CLAUDE.md written', {
+        agent: agent.slug,
+        path: claudeMdPath,
+        bytes: Buffer.byteLength(claudeMdContent, 'utf-8'),
+    });
+    // -------------------------------------------------------------------------
+    // 2. Write skills as .claude/commands/{filename}.md
+    // -------------------------------------------------------------------------
+    const commandsDir = path.join(workDir, '.claude', 'commands');
+    fs.mkdirSync(commandsDir, { recursive: true });
+    // Remove old command files before rewriting (handles deleted skills)
+    for (const existing of fs.readdirSync(commandsDir)) {
+        fs.rmSync(path.join(commandsDir, existing), { force: true });
+    }
+    // Built-in recall skill — always injected, not user-visible in Skills tab
+    fs.writeFileSync(path.join(commandsDir, 'recall.md'), RECALL_SKILL, 'utf-8');
+    for (const skill of skills) {
+        const filename = skill.filename.endsWith('.md') ? skill.filename : `${skill.filename}.md`;
+        fs.writeFileSync(path.join(commandsDir, filename), skill.content, 'utf-8');
+    }
+    logger_1.logger.debug('Skill commands written', {
+        agent: agent.slug,
+        commands: skills.map(s => s.filename),
+        dir: commandsDir,
+    });
+    // -------------------------------------------------------------------------
+    // 3. Propagate updates to all existing per-session directories
+    // -------------------------------------------------------------------------
+    const sessionsDir = path.join(workDir, 'sessions');
+    if (fs.existsSync(sessionsDir)) {
+        for (const entry of fs.readdirSync(sessionsDir)) {
+            const sessionDir = path.join(sessionsDir, entry);
+            if (!fs.statSync(sessionDir).isDirectory())
+                continue;
+            // Update CLAUDE.md
+            fs.writeFileSync(path.join(sessionDir, 'CLAUDE.md'), claudeMdContent, 'utf8');
+            // Update .claude/commands/
+            const sessionCommandsDir = path.join(sessionDir, '.claude', 'commands');
+            fs.mkdirSync(sessionCommandsDir, { recursive: true });
+            for (const existing of fs.readdirSync(sessionCommandsDir)) {
+                fs.rmSync(path.join(sessionCommandsDir, existing), { force: true });
+            }
+            fs.writeFileSync(path.join(sessionCommandsDir, 'recall.md'), RECALL_SKILL, 'utf-8');
+            for (const skill of skills) {
+                const filename = skill.filename.endsWith('.md') ? skill.filename : `${skill.filename}.md`;
+                fs.writeFileSync(path.join(sessionCommandsDir, filename), skill.content, 'utf-8');
+            }
+        }
+    }
+    return workDir;
+}
+/**
+ * Materializes memory files from the database to the agent's temp workspace.
+ * These files are read by the /recall skill when the agent needs past context.
+ */
+function materializeMemoryFiles(agent, memories) {
+    const memoryDir = path.join(getAgentWorkDir(agent.slug), 'memory');
+    fs.mkdirSync(memoryDir, { recursive: true });
+    const index = ['# Memory Index', ''];
+    for (const memory of memories) {
+        const filename = `${memory.type}_${sanitizeFilename(memory.name)}.md`;
+        fs.writeFileSync(path.join(memoryDir, filename), memory.content, 'utf-8');
+        index.push(`- [${memory.name}](${filename}) — ${memory.type}`);
+    }
+    fs.writeFileSync(path.join(memoryDir, 'MEMORY.md'), index.join('\n'), 'utf-8');
+    logger_1.logger.debug('Memory files materialized', { agent: agent.slug, count: memories.length });
+}
+// =============================================================================
+// Private helpers
+// =============================================================================
+/**
+ * Builds the CLAUDE.md content for an agent.
+ * Structure: identity → Slack formatting rules → memory system instructions.
+ *
+ * @param {Agent} agent - The agent.
+ * @param {string} [overrideClaudeMd] - Override for identity content (boss registry use).
+ * @returns {string} Full CLAUDE.md content.
+ */
+function buildClaudeMd(agent, overrideClaudeMd) {
+    const sections = [];
+    // Identity / instructions
+    const identity = overrideClaudeMd ?? agent.claudeMd;
+    if (identity.trim()) {
+        sections.push(identity.trim());
+    }
+    else {
+        const lines = [`# ${agent.name}`];
+        if (agent.persona)
+            lines.push('', agent.persona);
+        if (agent.description)
+            lines.push('', agent.description);
+        sections.push(lines.join('\n'));
+    }
+    // Slack formatting rules (framework-level, not a skill)
+    sections.push(SLACK_FORMATTING_SECTION);
+    // Memory instructions — internal, not shown in UI
+    sections.push(`# Memory
+
+Use /recall <topic> proactively — at the start of each conversation and whenever the topic shifts. Don't wait to be asked. Past memories contain user preferences, corrections, and learned patterns that let you pick up where you left off instead of starting from scratch.
+
+**When to save a memory** — use the Write tool to create \`memory/{type}_{name}.md\` (IMPORTANT: you MUST actually call the Write tool — do not just say you saved it). Include this frontmatter at the top, followed by the memory content:
+\`\`\`
+---
+name: {name}
+type: {type}
+description: {one line summary}
+---
+{memory content}
+\`\`\`
+Valid types: user|feedback|project|reference. Save when:
+- User explicitly corrects or guides you ("don't do X", "always do Y")
+- You notice a recurring pattern: same question asked repeatedly, same mistake made, same preference shown — save it so you don't start from scratch next time
+- You learn something concrete about the user's role, goals, or working style
+- A project decision or constraint is established that will affect future work
+
+**When NOT to save** — one-off tasks, ephemeral state, things already in the code or git history.
+
+Keep memories concise and actionable. Bad memory: "user asked about SQL". Good memory: "user prefers CTEs over subqueries — confirmed multiple times".`);
+    return sections.join('\n\n---\n\n');
+}
+/**
+ * Sanitizes a string for use as a filename.
+ *
+ * @param {string} name - Raw name string.
+ * @returns {string} Filesystem-safe filename fragment.
+ */
+function sanitizeFilename(name) {
+    return name.toLowerCase().replace(/[^a-z0-9_-]/g, '_').slice(0, 64);
+}
+//# sourceMappingURL=compile-claude-md.js.map

package/apps/runner/dist/compile-claude-md.js.map

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

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

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Generic Slack command handler for agent corrections.
+ *
+ * Commands use the agent's slug as prefix so any agent can have corrections:
+ *   @GILFOYLE gilfoyle:correct "always use UTC"
+ *   @GILFOYLE gilfoyle:corrections
+ *   @GILFOYLE gilfoyle:corrections remove 3
+ *   @GILFOYLE gilfoyle:help
+ *
+ * Commands are intercepted before normal message processing in slack-handler.ts.
+ *
+ * Adapted from nlq-claude-slack-bot/src/correction-handler.ts.
+ * Key changes: NLQ-specific -> generic per-agent, slug-prefixed commands.
+ *
+ * @module runner/correction-handler
+ */
+import type { Agent } from '@slackhive/shared';
+interface SlackContext {
+    userId: string;
+    channelId: string;
+    threadTs?: string;
+    messageTs: string;
+}
+export declare class CorrectionHandler {
+    private correctionManager;
+    private agent;
+    private prefix;
+    private reviewerAllowlist;
+    private log;
+    constructor(agent: Agent);
+    /**
+     * Returns true if the given text is a command for this agent.
+     * Checks for `{slug}:correct`, `{slug}:corrections`, or `{slug}:help`.
+     */
+    isCommand(text: string): boolean;
+    /**
+     * Routes a command to the appropriate handler.
+     */
+    handle(ctx: SlackContext, text: string, client: any): Promise<void>;
+    private isAuthorized;
+    private fetchThreadContext;
+    private handleAdd;
+    private handleShow;
+    private handleRemove;
+}
+export {};

package/apps/runner/dist/correction-handler.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * @fileoverview Generic Slack command handler for agent corrections.
+ *
+ * Commands use the agent's slug as prefix so any agent can have corrections:
+ *   @GILFOYLE gilfoyle:correct "always use UTC"
+ *   @GILFOYLE gilfoyle:corrections
+ *   @GILFOYLE gilfoyle:corrections remove 3
+ *   @GILFOYLE gilfoyle:help
+ *
+ * Commands are intercepted before normal message processing in slack-handler.ts.
+ *
+ * Adapted from nlq-claude-slack-bot/src/correction-handler.ts.
+ * Key changes: NLQ-specific -> generic per-agent, slug-prefixed commands.
+ *
+ * @module runner/correction-handler
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CorrectionHandler = void 0;
+const correction_manager_1 = require("./correction-manager");
+const logger_1 = require("./logger");
+const MAX_CORRECTIONS = 30;
+class CorrectionHandler {
+    correctionManager;
+    agent;
+    prefix;
+    reviewerAllowlist;
+    log;
+    constructor(agent) {
+        this.agent = agent;
+        this.prefix = `${agent.slug}:`;
+        this.correctionManager = new correction_manager_1.CorrectionManager(agent);
+        this.reviewerAllowlist = (process.env.CORRECTION_REVIEWERS || '').split(',').filter(Boolean);
+        this.log = (0, logger_1.agentLogger)(agent.slug);
+    }
+    /**
+     * Returns true if the given text is a command for this agent.
+     * Checks for `{slug}:correct`, `{slug}:corrections`, or `{slug}:help`.
+     */
+    isCommand(text) {
+        return text.startsWith(`${this.prefix}correct`) || text.startsWith(`${this.prefix}help`);
+    }
+    /**
+     * Routes a command to the appropriate handler.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async handle(ctx, text, client) {
+        const threadTs = ctx.threadTs ?? ctx.messageTs;
+        const slug = this.agent.slug;
+        const postReply = async (msg) => {
+            await client.chat.postMessage({
+                channel: ctx.channelId,
+                thread_ts: threadTs,
+                text: msg,
+            });
+        };
+        // {slug}:help
+        if (text === `${this.prefix}help`) {
+            await postReply(`*${this.agent.name} Commands*\n\n` +
+                `\u2022 \`${slug}:correct <text>\` \u2014 Add a correction rule\n` +
+                `\u2022 \`${slug}:corrections\` \u2014 View all stored corrections\n` +
+                `\u2022 \`${slug}:corrections remove <N>\` \u2014 Remove correction #N\n` +
+                `\u2022 \`${slug}:help\` \u2014 Show this help message`);
+            return;
+        }
+        // {slug}:corrections (show all)
+        if (text === `${this.prefix}corrections` || text === `${this.prefix}correction`) {
+            return this.handleShow(postReply);
+        }
+        // {slug}:corrections remove N
+        const removePrefix = `${this.prefix}corrections remove `;
+        if (text.startsWith(removePrefix)) {
+            const numStr = text.slice(removePrefix.length).trim();
+            const num = parseInt(numStr, 10);
+            if (isNaN(num) || num < 1) {
+                await postReply(`Usage: \`${slug}:corrections remove <number>\``);
+                return;
+            }
+            return this.handleRemove(ctx, num, postReply);
+        }
+        // {slug}:correct <text>
+        const correctPrefix = `${this.prefix}correct `;
+        if (text.startsWith(correctPrefix)) {
+            const correctionText = text.slice(correctPrefix.length).trim();
+            if (!correctionText) {
+                await postReply(`Usage: \`${slug}:correct <correction text>\``);
+                return;
+            }
+            return this.handleAdd(ctx, correctionText, client, postReply);
+        }
+        // Unrecognized {slug}: command
+        await postReply(`Available commands:\n` +
+            `\u2022 \`${slug}:correct <text>\` \u2014 Add a correction\n` +
+            `\u2022 \`${slug}:corrections\` \u2014 Show current corrections\n` +
+            `\u2022 \`${slug}:corrections remove <N>\` \u2014 Remove correction #N`);
+    }
+    isAuthorized(userId) {
+        if (this.reviewerAllowlist.length === 0)
+            return true;
+        return this.reviewerAllowlist.includes(userId);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async fetchThreadContext(client, channelId, threadTs) {
+        try {
+            const result = await client.conversations.replies({
+                channel: channelId,
+                ts: threadTs,
+                limit: 20,
+            });
+            const messages = result.messages ?? [];
+            if (messages.length < 2)
+                return undefined;
+            const userQuestion = (messages[0].text || '').substring(0, 500);
+            const botReplyText = messages[1].text || '';
+            const sqlMatch = botReplyText.match(/```sql[\s\S]*?```/);
+            const botExcerpt = sqlMatch
+                ? sqlMatch[0].substring(0, 800)
+                : botReplyText.substring(0, 500);
+            return `User question: "${userQuestion}"\nBot answer (excerpt): ${botExcerpt}`;
+        }
+        catch (error) {
+            this.log.error('Failed to fetch thread context', { error });
+            return undefined;
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async handleAdd(ctx, correctionText, client, postReply) {
+        if (!this.isAuthorized(ctx.userId)) {
+            await postReply("You don't have permission to submit corrections.");
+            return;
+        }
+        this.log.info('Processing correction', { user: ctx.userId, text: correctionText.substring(0, 100) });
+        await postReply('_Processing correction..._');
+        let threadContext;
+        if (ctx.threadTs) {
+            threadContext = await this.fetchThreadContext(client, ctx.channelId, ctx.threadTs);
+        }
+        const result = await this.correctionManager.addCorrection(correctionText, ctx.userId, threadContext);
+        const emoji = result.success ? ':white_check_mark:' : ':warning:';
+        await postReply(`${emoji} ${result.message}`);
+    }
+    async handleShow(postReply) {
+        const raw = await this.correctionManager.getRaw();
+        if (!raw) {
+            await postReply('No corrections on file.');
+            return;
+        }
+        const count = await this.correctionManager.getCount();
+        await postReply(`*Current Corrections* (${count}/${MAX_CORRECTIONS}):\n\n${raw}`);
+    }
+    async handleRemove(ctx, index, postReply) {
+        if (!this.isAuthorized(ctx.userId)) {
+            await postReply("You don't have permission to modify corrections.");
+            return;
+        }
+        const result = await this.correctionManager.removeCorrection(index);
+        const emoji = result.success ? ':white_check_mark:' : ':warning:';
+        await postReply(`${emoji} ${result.message}`);
+    }
+}
+exports.CorrectionHandler = CorrectionHandler;
+//# sourceMappingURL=correction-handler.js.map

package/apps/runner/dist/correction-handler.js.map

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

package/apps/runner/dist/correction-manager.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview Generic correction manager for any SlackHive agent.
+ *
+ * Corrections are stored as a skill in the database (category: '99-corrections',
+ * filename: 'corrections.md') so they:
+ * - Persist across container restarts (Postgres)
+ * - Are visible/editable in the SlackHive web UI Skills tab
+ * - Are automatically compiled into the agent's CLAUDE.md
+ *
+ * Uses Claude to intelligently consolidate new corrections (dedup, categorize).
+ *
+ * Adapted from nlq-claude-slack-bot/src/correction-manager.ts.
+ * Key changes: flat file -> Postgres skill, NLQ-specific -> generic agent.
+ *
+ * @module runner/correction-manager
+ */
+import type { Agent } from '@slackhive/shared';
+export interface AddResult {
+    success: boolean;
+    message: string;
+    count: number;
+}
+export declare class CorrectionManager {
+    private agent;
+    private log;
+    private writeChain;
+    constructor(agent: Agent);
+    /**
+     * Reads the current corrections content from the database.
+     */
+    readCorrections(): Promise<string>;
+    /**
+     * Counts the number of corrections (lines starting with digits followed by a dot).
+     */
+    getCount(): Promise<number>;
+    /**
+     * Adds a new correction, using Claude to consolidate and deduplicate.
+     * Serializes writes to prevent race conditions.
+     */
+    addCorrection(text: string, reviewerId: string, threadContext?: string): Promise<AddResult>;
+    private _addCorrection;
+    /**
+     * Removes a correction by its number and renumbers the rest.
+     */
+    removeCorrection(index: number): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Returns the raw corrections content.
+     */
+    getRaw(): Promise<string>;
+}