slackhive 0.1.37 → 0.1.39

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

@@ -0,0 +1,402 @@
+"use strict";
+/**
+ * @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
+ */
+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.ClaudeHandler = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+const claude_agent_sdk_1 = require("@anthropic-ai/claude-agent-sdk");
+const db_1 = require("./db");
+const logger_1 = require("./logger");
+const mcp_process_manager_js_1 = require("./mcp-process-manager.js");
+const SESSION_MAX_AGE_MS = 30 * 60 * 1_000;
+const SESSION_CLEANUP_INTERVAL_MS = 10 * 60 * 1_000;
+class ClaudeHandler {
+    agent;
+    mcpServers;
+    permissions;
+    workDir;
+    sessionsDir;
+    log;
+    envVarValues;
+    mcpManager;
+    /** In-memory cache: sessionKey → Claude session ID */
+    sessionCache = new Map();
+    cleanupTimer = null;
+    /**
+     * @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, mcpServers, permissions, workDir, envVarValues = {}) {
+        this.agent = agent;
+        this.mcpServers = mcpServers;
+        this.permissions = permissions;
+        this.workDir = workDir;
+        this.sessionsDir = path.join(workDir, 'sessions');
+        this.log = (0, logger_1.agentLogger)(agent.slug);
+        this.envVarValues = envVarValues;
+        // Allocate a stable port range per agent (14000 + slot * 50)
+        const slugHash = agent.slug.split('').reduce((acc, c) => acc + c.charCodeAt(0), 0);
+        const basePort = 14000 + (slugHash % 200) * 50;
+        this.mcpManager = new mcp_process_manager_js_1.McpProcessManager(agent.slug, workDir, basePort);
+    }
+    /**
+     * Sets up the sessions directory and starts the periodic stale-session cleanup timer.
+     * Must be called once before any `streamQuery` calls.
+     *
+     * @returns {void}
+     */
+    initialize() {
+        fs.mkdirSync(this.sessionsDir, { recursive: true });
+        this.cleanupTimer = setInterval(() => this.runSessionCleanup(), SESSION_CLEANUP_INTERVAL_MS);
+        this.log.debug('ClaudeHandler initialized', { workDir: this.workDir, sessionsDir: this.sessionsDir });
+        // Start persistent MCP proxies for all stdio servers
+        this.startMcpProxies().catch((err) => this.log.error('Failed to start MCP proxies', { error: err.message }));
+    }
+    async startMcpProxies() {
+        const stdioServers = this.mcpServers.filter((s) => s.type === 'stdio' || (!('url' in s.config) && ('command' in s.config)));
+        await Promise.all(stdioServers.map((s) => this.mcpManager
+            .startServer(s.name, s.config, this.envVarValues)
+            .catch((err) => this.log.error('MCP proxy start failed', { server: s.name, error: err.message }))));
+        this.log.info('Agent started', {
+            mcpServers: this.mcpServers.map((s) => s.name),
+        });
+    }
+    /**
+     * Stops the cleanup timer and clears the in-memory session cache.
+     * Called when the agent is stopped or reloaded.
+     *
+     * @returns {void}
+     */
+    destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        this.sessionCache.clear();
+        this.mcpManager.stopAll().catch(() => { });
+    }
+    /**
+     * 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, channelId, threadTs) {
+        return `${userId}-${channelId}-${threadTs ?? 'direct'}`;
+    }
+    /**
+     * Returns the isolated working directory for a session.
+     * Creates it on first access and copies CLAUDE.md from the agent root.
+     */
+    getSessionWorkDir(sessionKey) {
+        // Sanitize key for use as a directory name
+        const safeName = sessionKey.replace(/[^a-zA-Z0-9_-]/g, '_');
+        const sessionDir = path.join(this.sessionsDir, safeName);
+        if (!fs.existsSync(sessionDir)) {
+            fs.mkdirSync(sessionDir, { recursive: true });
+            // Copy CLAUDE.md into the session dir so the SDK reads it as project instructions
+            const agentClaudeMd = path.join(this.workDir, 'CLAUDE.md');
+            if (fs.existsSync(agentClaudeMd)) {
+                fs.copyFileSync(agentClaudeMd, path.join(sessionDir, 'CLAUDE.md'));
+            }
+            // Copy .claude/commands/ (skill slash commands) into the session dir
+            const agentCommandsDir = path.join(this.workDir, '.claude', 'commands');
+            if (fs.existsSync(agentCommandsDir)) {
+                const sessionCommandsDir = path.join(sessionDir, '.claude', 'commands');
+                fs.mkdirSync(sessionCommandsDir, { recursive: true });
+                for (const file of fs.readdirSync(agentCommandsDir)) {
+                    fs.copyFileSync(path.join(agentCommandsDir, file), path.join(sessionCommandsDir, file));
+                }
+            }
+            // Create memory dir for per-thread memory files (outside .claude/ to avoid SDK sensitive-file blocking)
+            fs.mkdirSync(path.join(sessionDir, 'memory'), { recursive: true });
+            this.log.debug('Session work dir created', { sessionKey, sessionDir });
+        }
+        return sessionDir;
+    }
+    /**
+     * 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).
+     */
+    async *streamQuery(prompt, sessionKey, abortController) {
+        // Compute current MCP hash to detect config changes
+        const currentMcpHash = crypto
+            .createHash('sha1')
+            .update(JSON.stringify(this.mcpServers.map((s) => ({ name: s.name, config: s.config }))))
+            .digest('hex');
+        // Resolve existing Claude session ID — invalidate if MCPs changed
+        let claudeSessionId = this.sessionCache.get(sessionKey);
+        if (!claudeSessionId) {
+            const persisted = await (0, db_1.getSession)(this.agent.id, sessionKey);
+            if (persisted?.claudeSessionId) {
+                if (persisted.mcpHash && persisted.mcpHash !== currentMcpHash) {
+                    this.log.info('MCP config changed, starting fresh session', { sessionKey });
+                }
+                else {
+                    claudeSessionId = persisted.claudeSessionId;
+                    this.sessionCache.set(sessionKey, claudeSessionId);
+                }
+            }
+        }
+        const sessionWorkDir = this.getSessionWorkDir(sessionKey);
+        const options = this.buildSdkOptions(sessionWorkDir, claudeSessionId, abortController);
+        this.log.debug('Streaming query', {
+            sessionKey,
+            resume: claudeSessionId ? 'yes' : 'new',
+            cwd: sessionWorkDir,
+            mcpServers: this.mcpServers.map((m) => m.name),
+        });
+        let newSessionId;
+        // Wrap array content into an AsyncIterable<SDKUserMessage> for multimodal prompts
+        const sdkPrompt = Array.isArray(prompt)
+            ? (async function* () {
+                yield {
+                    type: 'user',
+                    message: { role: 'user', content: prompt },
+                    parent_tool_use_id: null,
+                };
+            })()
+            : prompt;
+        // Stream directly for real-time progressive updates.
+        // If the session is stale, we catch the error before any messages are yielded
+        // and transparently retry as a fresh session.
+        const stream = async function* (opts) {
+            yield* (0, claude_agent_sdk_1.query)({ prompt: sdkPrompt, options: opts });
+        };
+        let activeOptions = options;
+        let retried = false;
+        outer: while (true) {
+            try {
+                for await (const message of stream(activeOptions)) {
+                    if (message.type === 'system' && message.subtype === 'init') {
+                        newSessionId = message.session_id;
+                        if (newSessionId) {
+                            this.sessionCache.set(sessionKey, newSessionId);
+                            await (0, db_1.upsertSession)(this.agent.id, sessionKey, newSessionId, currentMcpHash);
+                            this.log.debug('Session created', { sessionKey, sessionId: newSessionId, cwd: sessionWorkDir });
+                        }
+                    }
+                    yield message;
+                }
+                break; // completed successfully
+            }
+            catch (err) {
+                const errMsg = err instanceof Error ? err.message : String(err);
+                // Retry once on stale session — only if we haven't already retried
+                if (!retried && claudeSessionId && (errMsg.includes('No conversation found') || errMsg.includes('session') || errMsg.includes('exited with code 1'))) {
+                    this.log.warn('Stale session, retrying as new', { sessionKey, staleSessionId: claudeSessionId });
+                    this.sessionCache.delete(sessionKey);
+                    claudeSessionId = undefined;
+                    newSessionId = undefined;
+                    const freshOptions = { ...activeOptions };
+                    delete freshOptions.resume;
+                    activeOptions = freshOptions;
+                    retried = true;
+                    continue outer;
+                }
+                this.log.error('Claude query failed', { sessionKey, error: errMsg });
+                throw err;
+            }
+        }
+        await (0, db_1.upsertSession)(this.agent.id, sessionKey, newSessionId ?? claudeSessionId, currentMcpHash);
+    }
+    /**
+     * 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.
+     */
+    resolveServerConfig(serverName, config, serverType) {
+        const c = config;
+        if (c.tsSource) {
+            const scriptDir = path.join(this.workDir, '.mcp-scripts');
+            const scriptPath = path.join(scriptDir, `${serverName}.ts`);
+            fs.mkdirSync(scriptDir, { recursive: true });
+            fs.writeFileSync(scriptPath, c.tsSource, 'utf8');
+            const resolvedEnv = this.resolveEnvRefs(c);
+            return {
+                command: '/app/node_modules/.bin/tsx',
+                args: [scriptPath],
+                env: { NODE_PATH: '/app/node_modules', ...resolvedEnv },
+            };
+        }
+        if (c.envRefs && Object.keys(c.envRefs).length > 0) {
+            const resolvedEnv = this.resolveEnvRefs(c);
+            const { envRefs: _, tsSource: __, ...rest } = c;
+            const resolved = { ...rest };
+            // Inject type so the SDK can distinguish HTTP/SSE from stdio
+            if (serverType === 'http' || serverType === 'sse')
+                resolved.type = serverType;
+            // For HTTP/SSE servers, resolve envRefs into headers
+            if (resolved.headers && typeof resolved.headers === 'object') {
+                const resolvedHeaders = {};
+                for (const [key, value] of Object.entries(resolved.headers)) {
+                    const envKey = c.envRefs[key];
+                    if (envKey && this.envVarValues[envKey]) {
+                        resolvedHeaders[key] = value ? `${value}${this.envVarValues[envKey]}` : this.envVarValues[envKey];
+                    }
+                    else {
+                        resolvedHeaders[key] = value;
+                    }
+                }
+                resolved.headers = resolvedHeaders;
+            }
+            if (Object.keys(resolvedEnv).length > 0)
+                resolved.env = resolvedEnv;
+            return resolved;
+        }
+        // Passthrough — inject type for HTTP/SSE so SDK recognises the transport
+        if (serverType === 'http' || serverType === 'sse') {
+            return { ...config, type: serverType };
+        }
+        return config;
+    }
+    /**
+     * Merges inline env with resolved envRefs into a single env object.
+     */
+    resolveEnvRefs(c) {
+        const merged = { ...(c.env ?? {}) };
+        const refs = (c.envRefs ?? {});
+        for (const [subKey, storeKey] of Object.entries(refs)) {
+            const val = this.envVarValues[storeKey];
+            if (val !== undefined) {
+                merged[subKey] = val;
+            }
+            else {
+                this.log.warn('MCP envRef not found in env vars store', { serverName: 'unknown', storeKey, subKey });
+            }
+        }
+        return merged;
+    }
+    /**
+     * 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 })`.
+     */
+    buildSdkOptions(sessionWorkDir, claudeSessionId, abortController) {
+        const options = {
+            permissionMode: 'acceptEdits',
+            settingSources: ['project'],
+            cwd: sessionWorkDir,
+            abortController: abortController ?? new AbortController(),
+        };
+        const baseAllowed = this.permissions?.allowedTools?.length
+            ? this.permissions.allowedTools
+            : [];
+        const denied = this.permissions?.deniedTools ?? [];
+        const mcpToolPrefixes = this.mcpServers.map((s) => `mcp__${s.name}`);
+        // Read and Write are always available — Read for reading memory/skill files, Write for saving memories.
+        // These cannot be overridden by agent permissions.
+        const alwaysAllowed = ['Read', 'Write'];
+        const availableTools = [...new Set([...alwaysAllowed, ...baseAllowed, ...mcpToolPrefixes])].filter((tool) => !denied.includes(tool));
+        // `tools` controls which tools the model can see/use; `allowedTools` controls auto-execution.
+        options.tools = availableTools;
+        options.allowedTools = availableTools;
+        if (this.mcpServers.length > 0) {
+            options.mcpServers = Object.fromEntries(this.mcpServers.map((server) => [server.name, this.resolveServerConfig(server.name, server.config, server.type)]));
+            this.log.debug('MCP servers configured', { servers: this.mcpServers.map((s) => s.name) });
+        }
+        if (claudeSessionId) {
+            options.resume = claudeSessionId;
+        }
+        return options;
+    }
+    /**
+     * 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>}
+     */
+    async runSessionCleanup() {
+        try {
+            const deleted = await (0, db_1.cleanupStaleSessions)(this.agent.id, SESSION_MAX_AGE_MS);
+            if (deleted > 0) {
+                this.log.info('Cleaned up stale sessions', { count: deleted });
+                this.sessionCache.clear();
+            }
+        }
+        catch (error) {
+            this.log.warn('Session cleanup failed', { error });
+        }
+    }
+}
+exports.ClaudeHandler = ClaudeHandler;
+//# sourceMappingURL=claude-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claude-handler.js","sourceRoot":"","sources":["../src/claude-handler.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AAEzB,2CAA6B;AAC7B,+CAAiC;AACjC,qEAA6F;AAG7F,6BAIc;AACd,qCAAuC;AACvC,qEAA6D;AAG7D,MAAM,kBAAkB,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;AAC3C,MAAM,2BAA2B,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;AAEpD,MAAa,aAAa;IACP,KAAK,CAAQ;IACb,UAAU,CAAc;IACxB,WAAW,CAAoB;IAC/B,OAAO,CAAS;IAChB,WAAW,CAAS;IACpB,GAAG,CAAS;IACZ,YAAY,CAAyB;IACrC,UAAU,CAAoB;IAE/C,sDAAsD;IAC9C,YAAY,GAAwB,IAAI,GAAG,EAAE,CAAC;IAE9C,YAAY,GAA0B,IAAI,CAAC;IAEnD;;;;;;OAMG;IACH,YACE,KAAY,EACZ,UAAuB,EACvB,WAA8B,EAC9B,OAAe,EACf,eAAuC,EAAE;QAEzC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,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;QACnC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,6DAA6D;QAC7D,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnF,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;QAC/C,IAAI,CAAC,UAAU,GAAG,IAAI,0CAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACzE,CAAC;IAED;;;;;OAKG;IACH,UAAU;QACR,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,2BAA2B,CAAC,CAAC;QAC7F,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACtG,qDAAqD;QACrD,IAAI,CAAC,eAAe,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CACnC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC,CACjF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,eAAe;QAC3B,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CACzC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,IAAK,CAAC,CAAC,MAAiB,CAAC,IAAI,CAAC,SAAS,IAAK,CAAC,CAAC,MAAiB,CAAC,CAAC,CACvG,CAAC;QACF,MAAM,OAAO,CAAC,GAAG,CACf,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACrB,IAAI,CAAC,UAAU;aACZ,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAwB,EAAE,IAAI,CAAC,YAAY,CAAC;aAClE,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAC/G,CACF,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAC/C,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;OAQG;IACH,aAAa,CAAC,MAAc,EAAE,SAAiB,EAAE,QAAiB;QAChE,OAAO,GAAG,MAAM,IAAI,SAAS,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACK,iBAAiB,CAAC,UAAkB;QAC1C,2CAA2C;QAC3C,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAEzD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE9C,kFAAkF;YAClF,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAC3D,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBACjC,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;YACrE,CAAC;YAED,qEAAqE;YACrE,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;YACxE,IAAI,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACpC,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;gBACxE,EAAE,CAAC,SAAS,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtD,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,WAAW,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBACpD,EAAE,CAAC,YAAY,CACb,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,EACjC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,CACpC,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,wGAAwG;YACxG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACnE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,0BAA0B,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,CAAC,WAAW,CAChB,MAAoC,EACpC,UAAkB,EAClB,eAAiC;QAEjC,oDAAoD;QACpD,MAAM,cAAc,GAAG,MAAM;aAC1B,UAAU,CAAC,MAAM,CAAC;aAClB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;aACxF,MAAM,CAAC,KAAK,CAAC,CAAC;QAEjB,kEAAkE;QAClE,IAAI,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,SAAS,GAAG,MAAM,IAAA,eAAU,EAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;YAC9D,IAAI,SAAS,EAAE,eAAe,EAAE,CAAC;gBAC/B,IAAI,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,OAAO,KAAK,cAAc,EAAE,CAAC;oBAC9D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,4CAA4C,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;gBAC9E,CAAC;qBAAM,CAAC;oBACN,eAAe,GAAG,SAAS,CAAC,eAAe,CAAC;oBAC5C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC;QAEvF,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,EAAE;YAChC,UAAU;YACV,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;YACvC,GAAG,EAAE,cAAc;YACnB,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAC/C,CAAC,CAAC;QAEH,IAAI,YAAgC,CAAC;QAErC,kFAAkF;QAClF,MAAM,SAAS,GAA2C,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAC7E,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;gBACd,MAAM;oBACJ,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,MAAM,EAAE;oBACnD,kBAAkB,EAAE,IAAI;iBACzB,CAAC;YACJ,CAAC,CAAC,EAAE;YACN,CAAC,CAAC,MAAM,CAAC;QAEX,qDAAqD;QACrD,8EAA8E;QAC9E,8CAA8C;QAC9C,MAAM,MAAM,GAAG,KAAK,SAAS,CAAC,EAAE,IAA6B;YAC3D,KAAK,CAAC,CAAC,IAAA,wBAAK,EAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC,CAAC;QAEF,IAAI,aAAa,GAAG,OAAO,CAAC;QAC5B,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC;YACnB,IAAI,CAAC;gBACH,IAAI,KAAK,EAAE,MAAM,OAAO,IAAI,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;oBAClD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAK,OAAe,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;wBACrE,YAAY,GAAI,OAAe,CAAC,UAAU,CAAC;wBAC3C,IAAI,YAAY,EAAE,CAAC;4BACjB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;4BAChD,MAAM,IAAA,kBAAa,EAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;4BAC7E,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC,CAAC;wBAClG,CAAC;oBACH,CAAC;oBACD,MAAM,OAAO,CAAC;gBAChB,CAAC;gBACD,MAAM,CAAC,yBAAyB;YAClC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChE,mEAAmE;gBACnE,IAAI,CAAC,OAAO,IAAI,eAAe,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC;oBACrJ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gCAAgC,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,CAAC,CAAC;oBACjG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;oBACrC,eAAe,GAAG,SAAS,CAAC;oBAC5B,YAAY,GAAG,SAAS,CAAC;oBACzB,MAAM,YAAY,GAAG,EAAE,GAAG,aAAa,EAAE,CAAC;oBAC1C,OAAO,YAAY,CAAC,MAAM,CAAC;oBAC3B,aAAa,GAAG,YAAY,CAAC;oBAC7B,OAAO,GAAG,IAAI,CAAC;oBACf,SAAS,KAAK,CAAC;gBACjB,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;gBACrE,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QAED,MAAM,IAAA,kBAAa,EAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,YAAY,IAAI,eAAe,EAAE,cAAc,CAAC,CAAC;IAClG,CAAC;IAED;;;;;;;;;OASG;IACK,mBAAmB,CAAC,UAAkB,EAAE,MAAuB,EAAE,UAAyB;QAChG,MAAM,CAAC,GAAG,MAAkD,CAAC;QAE7D,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,UAAU,KAAK,CAAC,CAAC;YAC5D,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC,CAAC,QAAkB,EAAE,MAAM,CAAC,CAAC;YAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;YAC3C,OAAO;gBACL,OAAO,EAAE,4BAA4B;gBACrC,IAAI,EAAE,CAAC,UAAU,CAAC;gBAClB,GAAG,EAAE,EAAE,SAAS,EAAE,mBAAmB,EAAE,GAAG,WAAW,EAAE;aACrC,CAAC;QACvB,CAAC;QAED,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAiB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;YAC3C,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC;YAChD,MAAM,QAAQ,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;YAEtD,6DAA6D;YAC7D,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,KAAK;gBAAE,QAAQ,CAAC,IAAI,GAAG,UAAU,CAAC;YAE9E,qDAAqD;YACrD,IAAI,QAAQ,CAAC,OAAO,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC7D,MAAM,eAAe,GAA2B,EAAE,CAAC;gBACnD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAiC,CAAC,EAAE,CAAC;oBACtF,MAAM,MAAM,GAAI,CAAC,CAAC,OAAkC,CAAC,GAAG,CAAC,CAAC;oBAC1D,IAAI,MAAM,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;wBACxC,eAAe,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;oBACpG,CAAC;yBAAM,CAAC;wBACN,eAAe,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;oBAC/B,CAAC;gBACH,CAAC;gBACD,QAAQ,CAAC,OAAO,GAAG,eAAe,CAAC;YACrC,CAAC;YAED,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC;gBAAE,QAAQ,CAAC,GAAG,GAAG,WAAW,CAAC;YACpE,OAAO,QAAsC,CAAC;QAChD,CAAC;QAED,yEAAyE;QACzE,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;YAClD,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,UAAU,EAAgC,CAAC;QACvE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,CAA2C;QAChE,MAAM,MAAM,GAA2B,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAA2B,CAAC;QACzD,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACtD,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,wCAAwC,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YACvG,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;OAWG;IACK,eAAe,CACrB,cAAsB,EACtB,eAAmC,EACnC,eAAiC;QAEjC,MAAM,OAAO,GAA4B;YACvC,cAAc,EAAE,aAAa;YAC7B,cAAc,EAAE,CAAC,SAAS,CAAC;YAC3B,GAAG,EAAE,cAAc;YACnB,eAAe,EAAE,eAAe,IAAI,IAAI,eAAe,EAAE;SAC1D,CAAC;QAEF,MAAM,WAAW,GAAa,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,MAAM;YAClE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY;YAC/B,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,MAAM,GAAa,IAAI,CAAC,WAAW,EAAE,WAAW,IAAI,EAAE,CAAC;QAC7D,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAErE,wGAAwG;QACxG,mDAAmD;QACnD,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACxC,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,aAAa,EAAE,GAAG,WAAW,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM,CAChG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CACjC,CAAC;QACF,8FAA8F;QAC9F,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC;QAC/B,OAAO,CAAC,YAAY,GAAG,cAAc,CAAC;QAEtC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,WAAW,CACrC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAClH,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5F,CAAC;QAED,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,CAAC,MAAM,GAAG,eAAe,CAAC;QACnC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,iBAAiB;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAA,yBAAoB,EAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC;YAC9E,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC/D,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;YAC5B,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;CACF;AAhZD,sCAgZC"}

package/apps/runner/dist/compile-claude-md.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @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
+ */
+import type { Agent, Memory } from '@slackhive/shared';
+/**
+ * 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.
+ */
+export declare function getAgentWorkDir(slug: string): string;
+/**
+ * Returns the path to the CLAUDE.md file for an agent.
+ *
+ * @param {string} slug - Agent slug.
+ * @returns {string} Absolute path to CLAUDE.md.
+ */
+export declare function getClaudeMdPath(slug: string): string;
+/**
+ * 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.
+ */
+export declare function compileClaudeMd(agent: Agent, overrideClaudeMd?: string): Promise<string>;
+/**
+ * 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.
+ */
+export declare function materializeMemoryFiles(agent: Agent, memories: Memory[]): void;