slackhive 0.1.37 → 0.1.39

package/apps/runner/dist/__tests__/thread-context.test.js.map

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

package/apps/runner/dist/agent-runner.d.ts

@@ -0,0 +1,118 @@
+/**
+ * @fileoverview Agent runner — manages the lifecycle of all Slack bot instances.
+ *
+ * The AgentRunner is the top-level orchestrator for the runner service.
+ * On startup it loads all active agents from the database, starts a Slack
+ * Bolt App for each one, and listens on Redis for reload signals from the
+ * web UI.
+ *
+ * Each agent gets:
+ * - Its own Bolt App instance (separate Slack socket connection)
+ * - Its own ClaudeHandler (session manager, MCP wiring, tool permissions)
+ * - Its own MemoryWatcher (syncs learned memories to the database)
+ * - A compiled CLAUDE.md in /tmp/agents/{slug}/ (skills + memories)
+ *
+ * Hot reload flow:
+ * 1. User edits skills/MCPs/permissions in the web UI
+ * 2. Web API publishes `{ type: 'reload', agentId }` to Redis channel
+ * 3. AgentRunner receives the event, stops the agent, recompiles, restarts
+ *
+ * @module runner/agent-runner
+ */
+import { App } from '@slack/bolt';
+/**
+ * Manages the lifecycle of all Claude Code Slack bot instances.
+ *
+ * @example
+ * const runner = new AgentRunner();
+ * await runner.start();
+ * // Ctrl+C triggers graceful shutdown
+ */
+export declare class AgentRunner {
+    /** Map of agent ID → running agent resources. */
+    private runningAgents;
+    /** Scheduled job executor. */
+    private jobScheduler;
+    /** Redis subscriber client for hot-reload events. */
+    private redisSubscriber;
+    constructor();
+    /**
+     * Returns any running agent by ID, or undefined if not running.
+     */
+    getRunningAgent(agentId: string): {
+        app: App;
+        claudeHandler: import('./claude-handler').ClaudeHandler;
+    } | undefined;
+    /**
+     * Starts the runner:
+     * 1. Connects to Redis for hot-reload events
+     * 2. Loads and starts all active agents from the database
+     * 3. Registers graceful shutdown handlers
+     *
+     * @returns {Promise<void>}
+     * @throws {Error} If Redis connection fails.
+     */
+    start(): Promise<void>;
+    /**
+     * Gracefully stops all running agents and disconnects from Redis.
+     *
+     * @returns {Promise<void>}
+     */
+    stop(): Promise<void>;
+    /**
+     * Loads all agents from the database and starts each one.
+     *
+     * @returns {Promise<void>}
+     */
+    private loadAllAgents;
+    /**
+     * Starts a single agent:
+     * 1. Loads its MCP servers and permissions from the database
+     * 2. Compiles CLAUDE.md from skills + memories
+     * 3. Materializes memory files to disk
+     * 4. Creates Bolt App + ClaudeHandler + MemoryWatcher
+     * 5. Registers Slack event handlers
+     * 6. Starts the Bolt App (opens Socket Mode connection)
+     *
+     * @param {Agent} agent - The agent to start.
+     * @returns {Promise<void>}
+     * @throws {Error} If Slack App fails to start.
+     */
+    private startAgent;
+    /**
+     * Stops a running agent and cleans up all its resources.
+     *
+     * @param {string} agentId - UUID of the agent to stop.
+     * @returns {Promise<void>}
+     */
+    private stopAgent;
+    /**
+     * Reloads an agent: stops it, re-fetches its config, recompiles, and restarts.
+     * Called when the web UI publishes a reload event.
+     *
+     * @param {string} agentId - UUID of the agent to reload.
+     * @returns {Promise<void>}
+     */
+    private reloadAgent;
+    /**
+     * Connects to Redis and subscribes to agent lifecycle events.
+     *
+     * @returns {Promise<void>}
+     * @throws {Error} If REDIS_URL is not set or connection fails.
+     */
+    private connectRedis;
+    /**
+     * Handles an agent lifecycle event received from Redis.
+     *
+     * @param {string} rawMessage - JSON-encoded AgentEvent.
+     * @returns {void}
+     */
+    private handleAgentEvent;
+    /**
+     * Registers SIGTERM and SIGINT handlers for graceful shutdown.
+     * Ensures all agents are cleanly stopped before the process exits.
+     *
+     * @returns {void}
+     */
+    private registerShutdownHandlers;
+}

package/apps/runner/dist/agent-runner.js

@@ -0,0 +1,352 @@
+"use strict";
+/**
+ * @fileoverview Agent runner — manages the lifecycle of all Slack bot instances.
+ *
+ * The AgentRunner is the top-level orchestrator for the runner service.
+ * On startup it loads all active agents from the database, starts a Slack
+ * Bolt App for each one, and listens on Redis for reload signals from the
+ * web UI.
+ *
+ * Each agent gets:
+ * - Its own Bolt App instance (separate Slack socket connection)
+ * - Its own ClaudeHandler (session manager, MCP wiring, tool permissions)
+ * - Its own MemoryWatcher (syncs learned memories to the database)
+ * - A compiled CLAUDE.md in /tmp/agents/{slug}/ (skills + memories)
+ *
+ * Hot reload flow:
+ * 1. User edits skills/MCPs/permissions in the web UI
+ * 2. Web API publishes `{ type: 'reload', agentId }` to Redis channel
+ * 3. AgentRunner receives the event, stops the agent, recompiles, restarts
+ *
+ * @module runner/agent-runner
+ */
+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.AgentRunner = void 0;
+const bolt_1 = require("@slack/bolt");
+const redis_1 = require("redis");
+const shared_1 = require("@slackhive/shared");
+const job_scheduler_1 = require("./job-scheduler");
+const db_1 = require("./db");
+const compile_claude_md_1 = require("./compile-claude-md");
+const claude_handler_1 = require("./claude-handler");
+const memory_watcher_1 = require("./memory-watcher");
+const slack_handler_1 = require("./slack-handler");
+const logger_1 = require("./logger");
+/**
+ * Manages the lifecycle of all Claude Code Slack bot instances.
+ *
+ * @example
+ * const runner = new AgentRunner();
+ * await runner.start();
+ * // Ctrl+C triggers graceful shutdown
+ */
+class AgentRunner {
+    /** Map of agent ID → running agent resources. */
+    runningAgents = new Map();
+    /** Scheduled job executor. */
+    jobScheduler;
+    /** Redis subscriber client for hot-reload events. */
+    redisSubscriber = null;
+    constructor() {
+        this.jobScheduler = new job_scheduler_1.JobScheduler((agentId) => this.getRunningAgent(agentId));
+    }
+    /**
+     * Returns any running agent by ID, or undefined if not running.
+     */
+    getRunningAgent(agentId) {
+        const ra = this.runningAgents.get(agentId);
+        return ra ? { app: ra.app, claudeHandler: ra.claudeHandler } : undefined;
+    }
+    /**
+     * Starts the runner:
+     * 1. Connects to Redis for hot-reload events
+     * 2. Loads and starts all active agents from the database
+     * 3. Registers graceful shutdown handlers
+     *
+     * @returns {Promise<void>}
+     * @throws {Error} If Redis connection fails.
+     */
+    async start() {
+        logger_1.logger.info('AgentRunner starting...');
+        await this.connectRedis();
+        await this.loadAllAgents();
+        await this.jobScheduler.start();
+        this.registerShutdownHandlers();
+        logger_1.logger.info('AgentRunner started', { agents: this.runningAgents.size });
+    }
+    /**
+     * Gracefully stops all running agents and disconnects from Redis.
+     *
+     * @returns {Promise<void>}
+     */
+    async stop() {
+        logger_1.logger.info('AgentRunner stopping...');
+        // Stop job scheduler
+        await this.jobScheduler.stop();
+        // Stop all agents concurrently
+        const stopPromises = Array.from(this.runningAgents.keys()).map((id) => this.stopAgent(id).catch((err) => logger_1.logger.warn('Error stopping agent during shutdown', { agentId: id, error: err.message })));
+        await Promise.all(stopPromises);
+        if (this.redisSubscriber) {
+            await this.redisSubscriber.unsubscribe();
+            await this.redisSubscriber.disconnect();
+            this.redisSubscriber = null;
+        }
+        logger_1.logger.info('AgentRunner stopped');
+    }
+    // ===========================================================================
+    // Agent lifecycle
+    // ===========================================================================
+    /**
+     * Loads all agents from the database and starts each one.
+     *
+     * @returns {Promise<void>}
+     */
+    async loadAllAgents() {
+        const agents = await (0, db_1.getAllAgents)();
+        logger_1.logger.info('Loading agents from database', { count: agents.length });
+        // Start agents sequentially to avoid overwhelming Slack's rate limits.
+        // Skip agents that are stopped or have placeholder/missing tokens.
+        for (const agent of agents) {
+            if (agent.enabled === false) {
+                logger_1.logger.info('Skipping disabled agent', { agent: agent.slug });
+                continue;
+            }
+            if (!agent.slackBotToken.startsWith('xoxb-') ||
+                !agent.slackAppToken.startsWith('xapp-') ||
+                agent.slackBotToken.includes('placeholder') ||
+                agent.slackAppToken.includes('placeholder')) {
+                logger_1.logger.warn('Skipping agent with invalid/placeholder tokens', { agent: agent.slug });
+                await (0, db_1.updateAgentStatus)(agent.id, 'stopped');
+                continue;
+            }
+            try {
+                await this.startAgent(agent);
+            }
+            catch (err) {
+                logger_1.logger.error('Failed to start agent', { agent: agent.slug, error: err.message });
+                await (0, db_1.updateAgentStatus)(agent.id, 'error');
+            }
+        }
+    }
+    /**
+     * Starts a single agent:
+     * 1. Loads its MCP servers and permissions from the database
+     * 2. Compiles CLAUDE.md from skills + memories
+     * 3. Materializes memory files to disk
+     * 4. Creates Bolt App + ClaudeHandler + MemoryWatcher
+     * 5. Registers Slack event handlers
+     * 6. Starts the Bolt App (opens Socket Mode connection)
+     *
+     * @param {Agent} agent - The agent to start.
+     * @returns {Promise<void>}
+     * @throws {Error} If Slack App fails to start.
+     */
+    async startAgent(agent) {
+        if (this.runningAgents.has(agent.id)) {
+            logger_1.logger.warn('Agent already running, skipping start', { agent: agent.slug });
+            return;
+        }
+        logger_1.logger.info('Starting agent', { agent: agent.slug });
+        // Load configuration from DB
+        const [mcpServers, permissions, restrictions, memories, envVarValues] = await Promise.all([
+            (0, db_1.getAgentMcpServers)(agent.id),
+            (0, db_1.getAgentPermissions)(agent.id),
+            (0, db_1.getAgentRestrictions)(agent.id),
+            (0, db_1.getAgentMemories)(agent.id),
+            (0, db_1.getAllEnvVarValues)(),
+        ]);
+        // Compile CLAUDE.md (identity + skills → temp workspace)
+        const workDir = await (0, compile_claude_md_1.compileClaudeMd)(agent);
+        // Materialize memory files so the /recall skill can read them
+        (0, compile_claude_md_1.materializeMemoryFiles)(agent, memories);
+        // Create Claude Code SDK handler
+        const claudeHandler = new claude_handler_1.ClaudeHandler(agent, mcpServers, permissions, workDir, envVarValues);
+        claudeHandler.initialize();
+        // Create memory watcher (persists SDK memory writes back to DB)
+        const memoryWatcher = new memory_watcher_1.MemoryWatcher(agent);
+        memoryWatcher.start();
+        // Create Slack Bolt App in Socket Mode
+        const app = new bolt_1.App({
+            token: agent.slackBotToken,
+            appToken: agent.slackAppToken,
+            signingSecret: agent.slackSigningSecret,
+            socketMode: true,
+            logLevel: process.env.LOG_LEVEL === 'debug' ? bolt_1.LogLevel.DEBUG : bolt_1.LogLevel.WARN,
+        });
+        // Register all Slack event listeners
+        (0, slack_handler_1.registerSlackHandlers)(app, agent, claudeHandler, restrictions);
+        // Start the Bolt App
+        await app.start();
+        // Fetch and store the bot's Slack user ID for @mention construction
+        try {
+            const authResult = await app.client.auth.test({ token: agent.slackBotToken });
+            if (authResult.user_id && authResult.user_id !== agent.slackBotUserId) {
+                await (0, db_1.updateAgentStatus)(agent.id, 'running'); // Will also trigger updateAgentSlackUserId below
+                const { updateAgentSlackUserId } = await Promise.resolve().then(() => __importStar(require('./db')));
+                await updateAgentSlackUserId(agent.id, authResult.user_id);
+                agent.slackBotUserId = authResult.user_id;
+            }
+        }
+        catch (err) {
+            logger_1.logger.warn('Failed to fetch bot user ID', { agent: agent.slug, error: err });
+        }
+        this.runningAgents.set(agent.id, { agent, app, claudeHandler, memoryWatcher });
+        await (0, db_1.updateAgentStatus)(agent.id, 'running');
+        logger_1.logger.info('Agent started', {
+            agent: agent.slug,
+            mcpServers: mcpServers.map((m) => m.name),
+        });
+    }
+    /**
+     * Stops a running agent and cleans up all its resources.
+     *
+     * @param {string} agentId - UUID of the agent to stop.
+     * @returns {Promise<void>}
+     */
+    async stopAgent(agentId) {
+        const running = this.runningAgents.get(agentId);
+        if (!running)
+            return;
+        const { agent, app, claudeHandler, memoryWatcher } = running;
+        logger_1.logger.info('Stopping agent', { agent: agent.slug });
+        memoryWatcher.stop();
+        claudeHandler.destroy();
+        try {
+            await app.stop();
+        }
+        catch (err) {
+            logger_1.logger.warn('Error stopping Bolt App', { agent: agent.slug, error: err });
+        }
+        this.runningAgents.delete(agentId);
+        await (0, db_1.updateAgentStatus)(agentId, 'stopped');
+        logger_1.logger.info('Agent stopped', { agent: agent.slug });
+    }
+    /**
+     * Reloads an agent: stops it, re-fetches its config, recompiles, and restarts.
+     * Called when the web UI publishes a reload event.
+     *
+     * @param {string} agentId - UUID of the agent to reload.
+     * @returns {Promise<void>}
+     */
+    async reloadAgent(agentId) {
+        logger_1.logger.info('Reloading agent', { agentId });
+        await this.stopAgent(agentId);
+        const agent = await (0, db_1.getAgentById)(agentId);
+        if (!agent) {
+            logger_1.logger.warn('Agent not found after reload event', { agentId });
+            return;
+        }
+        await this.startAgent(agent);
+    }
+    // ===========================================================================
+    // Redis pub/sub
+    // ===========================================================================
+    /**
+     * Connects to Redis and subscribes to agent lifecycle events.
+     *
+     * @returns {Promise<void>}
+     * @throws {Error} If REDIS_URL is not set or connection fails.
+     */
+    async connectRedis() {
+        const redisUrl = process.env.REDIS_URL;
+        if (!redisUrl) {
+            logger_1.logger.warn('REDIS_URL not set — hot reload disabled');
+            return;
+        }
+        this.redisSubscriber = (0, redis_1.createClient)({ url: redisUrl });
+        this.redisSubscriber.on('error', (err) => {
+            logger_1.logger.warn('Redis subscriber error', { error: err.message });
+        });
+        await this.redisSubscriber.connect();
+        await this.redisSubscriber.subscribe(shared_1.AGENT_EVENTS_CHANNEL, (message) => {
+            this.handleAgentEvent(message);
+        });
+        logger_1.logger.info('Redis subscriber connected', { channel: shared_1.AGENT_EVENTS_CHANNEL });
+    }
+    /**
+     * Handles an agent lifecycle event received from Redis.
+     *
+     * @param {string} rawMessage - JSON-encoded AgentEvent.
+     * @returns {void}
+     */
+    handleAgentEvent(rawMessage) {
+        let event;
+        try {
+            event = JSON.parse(rawMessage);
+        }
+        catch {
+            logger_1.logger.warn('Received malformed agent event', { rawMessage });
+            return;
+        }
+        logger_1.logger.info('Received agent event', { event });
+        switch (event.type) {
+            case 'reload':
+                this.reloadAgent(event.agentId).catch((err) => logger_1.logger.error('Failed to reload agent', { agentId: event.agentId, error: err.message }));
+                break;
+            case 'start':
+                (0, db_1.getAgentById)(event.agentId)
+                    .then((agent) => agent && this.startAgent(agent))
+                    .catch((err) => logger_1.logger.error('Failed to start agent', { agentId: event.agentId, error: err.message }));
+                break;
+            case 'stop':
+                this.stopAgent(event.agentId).catch((err) => logger_1.logger.error('Failed to stop agent', { agentId: event.agentId, error: err.message }));
+                break;
+            case 'reload-jobs':
+                this.jobScheduler.reload().catch((err) => logger_1.logger.error('Failed to reload jobs', { error: err.message }));
+                break;
+        }
+    }
+    // ===========================================================================
+    // Graceful shutdown
+    // ===========================================================================
+    /**
+     * Registers SIGTERM and SIGINT handlers for graceful shutdown.
+     * Ensures all agents are cleanly stopped before the process exits.
+     *
+     * @returns {void}
+     */
+    registerShutdownHandlers() {
+        const shutdown = async (signal) => {
+            logger_1.logger.info(`Received ${signal}, shutting down gracefully...`);
+            await this.stop();
+            process.exit(0);
+        };
+        process.on('SIGTERM', () => shutdown('SIGTERM'));
+        process.on('SIGINT', () => shutdown('SIGINT'));
+    }
+}
+exports.AgentRunner = AgentRunner;
+//# sourceMappingURL=agent-runner.js.map

package/apps/runner/dist/agent-runner.js.map

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

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

@@ -0,0 +1,122 @@
+/**
+ * @fileoverview Claude Code SDK session manager for a single agent.
+ *
+ * Each agent has ONE ClaudeHandler shared across all Slack conversations.
+ * Each Slack thread gets its own isolated working directory so Claude's
+ * memory files (written to .claude/memory/ inside cwd) are per-thread.
+ *
+ * Directory layout:
+ *   /tmp/agents/{slug}/                  ← agent root (CLAUDE.md lives here)
+ *   /tmp/agents/{slug}/sessions/{key}/   ← per-thread cwd
+ *     CLAUDE.md                          ← copy of agent CLAUDE.md (skills)
+ *     .claude/memory/                    ← per-thread memory files
+ *
+ * @module runner/claude-handler
+ */
+import { type SDKMessage } from '@anthropic-ai/claude-agent-sdk';
+import type { ContentBlockParam } from '@anthropic-ai/sdk/resources';
+import type { Agent, McpServer, Permission } from '@slackhive/shared';
+export declare class ClaudeHandler {
+    private readonly agent;
+    private readonly mcpServers;
+    private readonly permissions;
+    private readonly workDir;
+    private readonly sessionsDir;
+    private readonly log;
+    private readonly envVarValues;
+    private readonly mcpManager;
+    /** In-memory cache: sessionKey → Claude session ID */
+    private sessionCache;
+    private cleanupTimer;
+    /**
+     * @param {Agent} agent - The agent configuration record.
+     * @param {McpServer[]} mcpServers - MCP servers assigned to this agent.
+     * @param {Permission | null} permissions - Tool allow/deny lists, or null for defaults.
+     * @param {string} workDir - Root working directory for this agent (e.g. `/tmp/agents/{slug}`).
+     * @param {Record<string, string>} envVarValues - Platform env vars for resolving MCP envRefs.
+     */
+    constructor(agent: Agent, mcpServers: McpServer[], permissions: Permission | null, workDir: string, envVarValues?: Record<string, string>);
+    /**
+     * Sets up the sessions directory and starts the periodic stale-session cleanup timer.
+     * Must be called once before any `streamQuery` calls.
+     *
+     * @returns {void}
+     */
+    initialize(): void;
+    private startMcpProxies;
+    /**
+     * Stops the cleanup timer and clears the in-memory session cache.
+     * Called when the agent is stopped or reloaded.
+     *
+     * @returns {void}
+     */
+    destroy(): void;
+    /**
+     * Derives a deterministic session key from Slack identifiers.
+     * The key is used as both a DB lookup key and a working-directory name.
+     *
+     * @param {string} userId - Slack user ID (e.g. `U12345678`).
+     * @param {string} channelId - Slack channel or DM ID.
+     * @param {string} [threadTs] - Thread timestamp; omit for top-level DMs.
+     * @returns {string} Composite key: `{userId}-{channelId}-{threadTs|'direct'}`.
+     */
+    getSessionKey(userId: string, channelId: string, threadTs?: string): string;
+    /**
+     * Returns the isolated working directory for a session.
+     * Creates it on first access and copies CLAUDE.md from the agent root.
+     */
+    private getSessionWorkDir;
+    /**
+     * Streams a Claude Code SDK query for the given session and yields raw SDK messages.
+     *
+     * Session resumption: If a Claude session ID exists for this `sessionKey` (in-memory
+     * cache or persisted in DB), the query resumes that conversation. On a stale-session
+     * error the handler transparently retries once as a fresh session.
+     *
+     * Callers should check `abortController.signal.aborted` between yields and break early
+     * if the user has sent a new message (the Slack handler cancels in-flight requests this way).
+     *
+     * @param {string} prompt - The user message to send to Claude.
+     * @param {string} sessionKey - Session key from {@link getSessionKey}.
+     * @param {AbortController} [abortController] - Optional controller to cancel the stream.
+     * @yields {SDKMessage} Raw messages from the Claude Code SDK.
+     * @throws {Error} On unrecoverable SDK errors (re-thrown after logging).
+     */
+    streamQuery(prompt: string | ContentBlockParam[], sessionKey: string, abortController?: AbortController): AsyncGenerator<SDKMessage, void, unknown>;
+    /**
+     * Resolves a raw MCP server config from the DB into one ready for the SDK:
+     * - Merges envRefs (references to platform env vars) into the env object
+     * - For inline TypeScript MCPs (tsSource): writes the source to disk and
+     *   rewrites config to use `tsx <scriptPath>`
+     *
+     * @param {string} serverName - MCP server name, used for the script filename.
+     * @param {McpServerConfig} config - Raw config from the DB.
+     * @returns {McpServerConfig} Resolved config safe to pass to the SDK.
+     */
+    private resolveServerConfig;
+    /**
+     * Merges inline env with resolved envRefs into a single env object.
+     */
+    private resolveEnvRefs;
+    /**
+     * Builds the options object passed to the Claude Code SDK `query()` call.
+     *
+     * Merges agent permissions (allowed/denied tools) with MCP server prefixes
+     * so that only explicitly permitted tools are available to the agent.
+     * Default allowed tool is `['Read']` when no permissions are configured.
+     *
+     * @param {string} sessionWorkDir - Per-session working directory path.
+     * @param {string | undefined} claudeSessionId - Existing session ID to resume, or undefined for a new session.
+     * @param {AbortController} [abortController] - Optional abort controller injected into SDK options.
+     * @returns {Record<string, unknown>} Options object for `query({ prompt, options })`.
+     */
+    private buildSdkOptions;
+    /**
+     * Deletes sessions inactive longer than SESSION_MAX_AGE_MS from the DB
+     * and clears the in-memory cache so stale IDs are not accidentally reused.
+     * Runs on an interval set in {@link initialize}; failures are logged and swallowed.
+     *
+     * @returns {Promise<void>}
+     */
+    private runSessionCleanup;
+}