slackhive 0.1.37 → 0.1.39

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

@@ -0,0 +1,241 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CorrectionManager = void 0;
+const claude_agent_sdk_1 = require("@anthropic-ai/claude-agent-sdk");
+const db_1 = require("./db");
+const compile_claude_md_1 = require("./compile-claude-md");
+const logger_1 = require("./logger");
+const CORRECTIONS_CATEGORY = '99-corrections';
+const CORRECTIONS_FILENAME = 'corrections.md';
+const CORRECTIONS_SORT_ORDER = 99;
+const MAX_CORRECTIONS = 30;
+class CorrectionManager {
+    agent;
+    log;
+    writeChain = Promise.resolve();
+    constructor(agent) {
+        this.agent = agent;
+        this.log = (0, logger_1.agentLogger)(agent.slug);
+    }
+    /**
+     * Reads the current corrections content from the database.
+     */
+    async readCorrections() {
+        try {
+            const skills = await (0, db_1.getAgentSkills)(this.agent.id);
+            const correctionSkill = skills.find((s) => s.category === CORRECTIONS_CATEGORY && s.filename === CORRECTIONS_FILENAME);
+            return correctionSkill?.content ?? '';
+        }
+        catch (error) {
+            this.log.error('Failed to read corrections from DB', { error });
+            return '';
+        }
+    }
+    /**
+     * Counts the number of corrections (lines starting with digits followed by a dot).
+     */
+    async getCount() {
+        const content = await this.readCorrections();
+        if (!content)
+            return 0;
+        const matches = content.match(/^\d+\.\s/gm);
+        return matches ? matches.length : 0;
+    }
+    /**
+     * Adds a new correction, using Claude to consolidate and deduplicate.
+     * Serializes writes to prevent race conditions.
+     */
+    async addCorrection(text, reviewerId, threadContext) {
+        const result = await new Promise((resolve) => {
+            this.writeChain = this.writeChain.then(async () => {
+                resolve(await this._addCorrection(text, reviewerId, threadContext));
+            }).catch((error) => {
+                this.log.error('Write chain error', { error });
+                resolve({ success: false, message: 'Internal error adding correction.', count: 0 });
+            });
+        });
+        return result;
+    }
+    async _addCorrection(text, reviewerId, threadContext) {
+        const existing = await this.readCorrections();
+        const count = await this.getCount();
+        const slug = this.agent.slug;
+        if (count >= MAX_CORRECTIONS) {
+            return {
+                success: false,
+                message: `At capacity (${MAX_CORRECTIONS}/${MAX_CORRECTIONS}). Remove an old correction first with \`${slug}:corrections remove <N>\`.`,
+                count,
+            };
+        }
+        const today = new Date().toLocaleDateString('en-SG', {
+            timeZone: 'Asia/Singapore', year: 'numeric', month: 'short', day: 'numeric',
+        });
+        const agentDesc = this.agent.description
+            ? `a ${this.agent.description} bot`
+            : `the ${this.agent.name} bot`;
+        const threadContextBlock = threadContext
+            ? `\nTHREAD CONTEXT (the conversation that prompted this correction):\n${threadContext}\n`
+            : '';
+        const threadContextTask = threadContext
+            ? `\n7. Use the thread context to understand what went wrong, but write the correction as a GENERAL rule\n   (not specific to this one question). The correction should help the bot handle ALL similar cases.`
+            : '';
+        const consolidationPrompt = `You maintain a corrections file for ${agentDesc}.
+
+CURRENT FILE:
+---
+${existing || '(empty)'}
+---
+
+NEW CORRECTION (submitted by reviewer):
+"${text}"
+${threadContextBlock}
+Reviewer ID: @${reviewerId}
+Date: ${today}
+
+Tasks:
+1. If this duplicates an existing correction, respond with ONLY: DUPLICATE: <number>
+2. If this supersedes/updates an existing one, replace it
+3. If it's new, add it to the appropriate category (create a new category if needed)
+4. Keep corrections numbered sequentially across all categories
+5. Keep each correction as a single concise line
+6. Add attribution: (@${reviewerId}, ${today})${threadContextTask}
+
+Respond with the FULL updated file content (including the # heading and ## categories).
+If duplicate, respond with ONLY: DUPLICATE: <number>`;
+        try {
+            let responseText = '';
+            for await (const message of (0, claude_agent_sdk_1.query)({
+                prompt: consolidationPrompt,
+                options: {
+                    permissionMode: 'bypassPermissions',
+                    tools: [],
+                    maxTurns: 1,
+                },
+            })) {
+                if (message.type === 'assistant' && message.message.content) {
+                    for (const part of message.message.content) {
+                        if (part.type === 'text') {
+                            responseText += part.text;
+                        }
+                    }
+                }
+                else if (message.type === 'result' && message.result) {
+                    responseText = message.result;
+                }
+            }
+            responseText = responseText.trim();
+            // Check for duplicate
+            if (responseText.startsWith('DUPLICATE:')) {
+                const dupNum = responseText.replace('DUPLICATE:', '').trim();
+                return {
+                    success: false,
+                    message: `This duplicates correction #${dupNum}. No changes made.`,
+                    count,
+                };
+            }
+            // Store as a skill in the database
+            await (0, db_1.upsertSkill)(this.agent.id, CORRECTIONS_CATEGORY, CORRECTIONS_FILENAME, responseText, CORRECTIONS_SORT_ORDER);
+            // Recompile CLAUDE.md so corrections take effect immediately
+            await (0, compile_claude_md_1.compileClaudeMd)(this.agent);
+            const newCount = await this.getCount();
+            this.log.info('Correction added', { reviewerId, newCount });
+            return {
+                success: true,
+                message: `Correction added (${newCount}/${MAX_CORRECTIONS} slots used).`,
+                count: newCount,
+            };
+        }
+        catch (error) {
+            this.log.error('Failed to consolidate correction via Claude', { error });
+            return {
+                success: false,
+                message: 'Failed to process correction. Please try again.',
+                count,
+            };
+        }
+    }
+    /**
+     * Removes a correction by its number and renumbers the rest.
+     */
+    async removeCorrection(index) {
+        const content = await this.readCorrections();
+        if (!content) {
+            return { success: false, message: 'No corrections on file.' };
+        }
+        const lines = content.split('\n');
+        const targetPattern = new RegExp(`^${index}\\.\\s`);
+        const lineIndex = lines.findIndex((line) => targetPattern.test(line));
+        if (lineIndex === -1) {
+            return { success: false, message: `Correction #${index} not found.` };
+        }
+        // Remove the line
+        lines.splice(lineIndex, 1);
+        // Renumber all remaining numbered items sequentially
+        let num = 1;
+        const renumbered = lines.map((line) => {
+            if (/^\d+\.\s/.test(line)) {
+                const replaced = line.replace(/^\d+\./, `${num}.`);
+                num++;
+                return replaced;
+            }
+            return line;
+        });
+        // Clean up empty category sections
+        const cleaned = [];
+        for (let i = 0; i < renumbered.length; i++) {
+            const line = renumbered[i];
+            if (line.startsWith('## ')) {
+                let nextContentIdx = i + 1;
+                while (nextContentIdx < renumbered.length && renumbered[nextContentIdx].trim() === '') {
+                    nextContentIdx++;
+                }
+                if (nextContentIdx >= renumbered.length || renumbered[nextContentIdx].startsWith('## ') || renumbered[nextContentIdx].startsWith('# ')) {
+                    i = nextContentIdx - 1;
+                    continue;
+                }
+            }
+            cleaned.push(line);
+        }
+        const result = cleaned.join('\n').replace(/\n{3,}/g, '\n\n').trim();
+        if (result === '# Verified Corrections' || result === '') {
+            // All corrections removed — delete the skill
+            await (0, db_1.deleteSkill)(this.agent.id, CORRECTIONS_CATEGORY, CORRECTIONS_FILENAME);
+        }
+        else {
+            await (0, db_1.upsertSkill)(this.agent.id, CORRECTIONS_CATEGORY, CORRECTIONS_FILENAME, result + '\n', CORRECTIONS_SORT_ORDER);
+        }
+        // Recompile CLAUDE.md
+        await (0, compile_claude_md_1.compileClaudeMd)(this.agent);
+        const newCount = await this.getCount();
+        return {
+            success: true,
+            message: newCount > 0
+                ? `Correction #${index} removed. ${newCount} correction(s) remaining.`
+                : `Correction #${index} removed. No corrections remaining.`,
+        };
+    }
+    /**
+     * Returns the raw corrections content.
+     */
+    async getRaw() {
+        return this.readCorrections();
+    }
+}
+exports.CorrectionManager = CorrectionManager;
+//# sourceMappingURL=correction-manager.js.map

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

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

package/apps/runner/dist/db.d.ts

@@ -0,0 +1,193 @@
+/**
+ * @fileoverview PostgreSQL database client for the runner service.
+ *
+ * Provides a singleton Pool instance and typed query helpers for all
+ * tables used by the runner: agents, mcp_servers, agent_mcps, skills,
+ * permissions, memories, and sessions.
+ *
+ * @module runner/db
+ */
+import { Pool } from 'pg';
+import type { Agent, McpServer, ScheduledJob, Skill, Permission, Restriction, Memory, Session, AgentStatus } from '@slackhive/shared';
+/**
+ * Returns the singleton Postgres connection pool.
+ * Creates the pool on first call using DATABASE_URL from environment.
+ *
+ * @returns {Pool} The Postgres connection pool.
+ * @throws {Error} If DATABASE_URL is not set.
+ */
+export declare function getPool(): Pool;
+/**
+ * Closes the Postgres connection pool.
+ * Should be called on graceful shutdown.
+ *
+ * @returns {Promise<void>}
+ */
+export declare function closePool(): Promise<void>;
+/**
+ * Fetches all agents from the database.
+ *
+ * @returns {Promise<Agent[]>} All registered agents.
+ */
+export declare function getAllAgents(): Promise<Agent[]>;
+/**
+ * Fetches a single agent by ID.
+ *
+ * @param {string} id - Agent UUID.
+ * @returns {Promise<Agent | null>} The agent, or null if not found.
+ */
+export declare function getAgentById(id: string): Promise<Agent | null>;
+/**
+ * Updates the runtime status of an agent.
+ *
+ * @param {string} id - Agent UUID.
+ * @param {AgentStatus} status - New status value.
+ * @returns {Promise<void>}
+ */
+export declare function updateAgentStatus(id: string, status: AgentStatus): Promise<void>;
+/**
+ * Updates the Slack bot user ID for an agent after successful auth.test.
+ *
+ * @param {string} id - Agent UUID.
+ * @param {string} slackBotUserId - The bot's Slack user ID (e.g., "U12345678").
+ * @returns {Promise<void>}
+ */
+export declare function updateAgentSlackUserId(id: string, slackBotUserId: string): Promise<void>;
+/**
+ * Fetches all MCP servers assigned to an agent, in catalog order.
+ *
+ * @param {string} agentId - Agent UUID.
+ * @returns {Promise<McpServer[]>} MCP servers assigned to this agent.
+ */
+export declare function getAgentMcpServers(agentId: string): Promise<McpServer[]>;
+/**
+ * Fetches all skills for an agent, ordered for CLAUDE.md compilation.
+ * Skills are ordered by category (alphabetical) then sort_order (ascending).
+ *
+ * @param {string} agentId - Agent UUID.
+ * @returns {Promise<Skill[]>} Ordered skill files for this agent.
+ */
+export declare function getAgentSkills(agentId: string): Promise<Skill[]>;
+/**
+ * Upserts a skill for an agent.
+ * Conflicts on (agent_id, category, filename) update content and sort_order.
+ *
+ * @param {string} agentId - Agent UUID.
+ * @param {string} category - Skill category directory (e.g. `'99-corrections'`).
+ * @param {string} filename - Skill filename (e.g. `'corrections.md'`).
+ * @param {string} content - Full markdown content of the skill.
+ * @param {number} [sortOrder=0] - Sort order within the category.
+ * @returns {Promise<Skill>} The upserted skill.
+ */
+export declare function upsertSkill(agentId: string, category: string, filename: string, content: string, sortOrder?: number): Promise<Skill>;
+/**
+ * Deletes a skill by agent_id, category, and filename.
+ *
+ * @param {string} agentId - Agent UUID.
+ * @param {string} category - Skill category directory.
+ * @param {string} filename - Skill filename.
+ * @returns {Promise<boolean>} True if a row was deleted.
+ */
+export declare function deleteSkill(agentId: string, category: string, filename: string): Promise<boolean>;
+/**
+ * Fetches the tool permissions for an agent.
+ *
+ * @param {string} agentId - Agent UUID.
+ * @returns {Promise<Permission | null>} The permission record, or null if not set.
+ */
+export declare function getAgentPermissions(agentId: string): Promise<Permission | null>;
+/**
+ * Fetches the channel restrictions for an agent.
+ *
+ * @param {string} agentId - Agent UUID.
+ * @returns {Promise<Restriction | null>} The restriction record, or null if not configured.
+ */
+export declare function getAgentRestrictions(agentId: string): Promise<Restriction | null>;
+/**
+ * Fetches all memory entries for an agent, ordered by type then created_at.
+ *
+ * @param {string} agentId - Agent UUID.
+ * @returns {Promise<Memory[]>} All memory entries for this agent.
+ */
+export declare function getAgentMemories(agentId: string): Promise<Memory[]>;
+/**
+ * Upserts a memory entry for an agent.
+ * If a memory with the same agent_id and name already exists, it is updated.
+ * Otherwise a new entry is created.
+ *
+ * This is called by the memory watcher when the agent writes new memory files
+ * to disk during a conversation.
+ *
+ * @param {string} agentId - Agent UUID.
+ * @param {Memory['type']} type - Memory type classification.
+ * @param {string} name - Unique name/identifier for this memory.
+ * @param {string} content - Full markdown content of the memory.
+ * @returns {Promise<Memory>} The upserted memory record.
+ */
+export declare function upsertMemory(agentId: string, type: Memory['type'], name: string, content: string): Promise<Memory>;
+/**
+ * Upserts a memory entry by agent_id and name (no unique constraint version).
+ * Uses a safe upsert pattern compatible with the current schema.
+ *
+ * @param {string} agentId - Agent UUID.
+ * @param {Memory['type']} type - Memory type classification.
+ * @param {string} name - Memory name (used as identifier).
+ * @param {string} content - Full markdown content.
+ * @returns {Promise<void>}
+ */
+export declare function upsertMemorySafe(agentId: string, type: Memory['type'], name: string, content: string): Promise<void>;
+/**
+ * Fetches a conversation session by agent and session key.
+ *
+ * @param {string} agentId - Agent UUID.
+ * @param {string} sessionKey - Composite key: {userId}-{channelId}-{threadTs|'direct'}.
+ * @returns {Promise<Session | null>} The session, or null if not found.
+ */
+export declare function getSession(agentId: string, sessionKey: string): Promise<Session | null>;
+/**
+ * Creates or updates a conversation session.
+ * Updates last_activity on conflict.
+ *
+ * @param {string} agentId - Agent UUID.
+ * @param {string} sessionKey - Composite session key.
+ * @param {string | undefined} claudeSessionId - Claude Code SDK session ID.
+ * @returns {Promise<Session>} The upserted session.
+ */
+export declare function upsertSession(agentId: string, sessionKey: string, claudeSessionId?: string, mcpHash?: string): Promise<Session>;
+/**
+ * Deletes sessions for an agent that have been inactive for longer than maxAgeMs.
+ *
+ * @param {string} agentId - Agent UUID.
+ * @param {number} maxAgeMs - Maximum session age in milliseconds.
+ * @returns {Promise<number>} Number of sessions deleted.
+ */
+export declare function cleanupStaleSessions(agentId: string, maxAgeMs: number): Promise<number>;
+/**
+ * Returns all enabled scheduled jobs.
+ *
+ * @returns {Promise<ScheduledJob[]>}
+ */
+export declare function getAllEnabledJobs(): Promise<ScheduledJob[]>;
+/**
+ * Inserts a new job run record with status 'running'.
+ *
+ * @param {string} jobId - The scheduled job ID.
+ * @returns {Promise<string>} The new run ID.
+ */
+export declare function insertJobRun(jobId: string): Promise<string>;
+/**
+ * Updates a job run with final status, output, and error.
+ *
+ * @param {string} runId - The run ID.
+ * @param {'success' | 'error'} status - Final status.
+ * @param {string | null} output - Truncated output text.
+ * @param {string | null} error - Error message if failed.
+ */
+export declare function updateJobRun(runId: string, status: 'success' | 'error', output?: string | null, error?: string | null): Promise<void>;
+/**
+ * Returns all env vars as a key→value map. Used by the runner to resolve
+ * envRefs in MCP stdio configs at agent start time.
+ *
+ * @returns {Promise<Record<string, string>>}
+ */
+export declare function getAllEnvVarValues(): Promise<Record<string, string>>;