@opencoven/coven-code 0.0.4 → 0.0.6

package/src/cli/execute.mjs

@@ -1,452 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { readFileSync } from 'node:fs';
-import path from 'node:path';
-import { estimateUsage, fixtureAgentResponse } from '../agent/fixture.mjs';
-import {
-  loadPlugins,
-  runPluginEventHandlers,
-} from '../plugins/discover.mjs';
-import { discoverAgentFiles, firstGuidanceInDir } from '../commands/agents.mjs';
-import { executePromptToolRequest } from '../tools/builtin/index.mjs';
-import { toolResultContent } from '../tools/builtin/runtime.mjs';
-import { persistThreadMessages, threadContinuationPrompt } from '../threads/store.mjs';
-import { readEffectiveSettings } from '../settings/load.mjs';
-import { expandFileReferences, expandThreadReferences } from './refs.mjs';
-import { UsageError } from './parse.mjs';
-import { notifyAgentComplete } from './notifications.mjs';
-import { globToRegex } from '../util/glob.mjs';
-import { emitJson } from '../util/fs.mjs';
-import {
-  emitStreamJsonInit,
-  emitStreamJsonTurn,
-  streamJsonInputMessages,
-  streamJsonOutputUserContent,
-  streamJsonPermissionDenials,
-  streamJsonResultMessage,
-  streamJsonTurnCount,
-  toolRunParent,
-} from './stream-json.mjs';
-
-const MAX_AGENT_CONTINUATIONS = 8;
-
-export async function runExecute(parsed, stdin, options = {}) {
-  const started = Date.now();
-  if (parsed.streamJsonInput && parsed.streamJson) {
-    return runStreamJsonInputExecute(parsed, stdin, options, started);
-  }
-
-  const prompt = combinePrompt(parsed.prompt, stdin, parsed.streamJsonInput);
-  const sessionId = options.thread?.id ?? `T-${randomUUID()}`;
-  const plugins = await loadPlugins(process.cwd());
-  await runSessionStartHandlers(plugins, sessionId);
-  const sequence = await runExecuteTurnSequence({
-    initialPrompt: prompt,
-    stdin,
-    sessionId,
-    parsed,
-    plugins,
-    thread: options.thread,
-  });
-  const { turns, errorSubtype } = sequence;
-  const result = turns.at(-1)?.result ?? '';
-
-  if (parsed.streamJson) {
-    await emitStreamJsonInit({
-      parsed,
-      plugins,
-      sessionId,
-      promptForMcpDiscovery: turns.map((turn) => turn.prompt).join('\n\n'),
-    });
-    for (const turn of turns) {
-      emitStreamJsonTurn({
-        userContent: [{ type: 'text', text: turn.prompt }],
-        promptText: turn.prompt,
-        toolRun: turn.toolRun,
-        result: turn.result,
-        parsed,
-        sessionId,
-        assistantParentToolUseId: turn.toolRun ? toolRunParent(turn.toolRun, 'finalParentToolUseId', null) : null,
-      });
-    }
-    emitJson(streamJsonResultMessage({
-      started,
-      isError: errorSubtype !== undefined || turns.some((turn) => (turn.toolRun?.exitCode ?? 0) !== 0),
-      errorSubtype,
-      numTurns: streamJsonTurnCount(turns),
-      result: errorSubtype === 'error_max_turns' ? 'Maximum agent continuation turns exceeded' : result,
-      sessionId,
-      usage: estimateUsage(turns.map((turn) => turn.prompt).join('\n'), result),
-      permissionDenials: streamJsonPermissionDenials(turns.flatMap((turn) => turn.toolRun?.permissionDenials ?? [])),
-    }));
-    const thread = await persistThreadMessages(sessionId, turnMessages(turns), parsed.mode, options.thread, parsed);
-    notifyAgentComplete(parsed);
-    return thread;
-  }
-
-  if (!options.silent) {
-    process.stdout.write(result.endsWith('\n') ? result : `${result}\n`);
-  }
-  const thread = await persistThreadMessages(sessionId, turnMessages(turns), parsed.mode, options.thread, parsed);
-  notifyAgentComplete(parsed);
-  return thread;
-}
-
-async function runExecuteTurnSequence({ initialPrompt, stdin, sessionId, parsed, plugins, thread }) {
-  const turns = [];
-  let prompt = initialPrompt;
-  let continuationCount = 0;
-  let errorSubtype;
-  while (prompt !== undefined) {
-    const turnStdin = turns.length === 0 ? stdin : '';
-    const turn = await runExecuteTurn(prompt, turnStdin, sessionId, parsed, plugins, thread, turns);
-    turns.push(turn);
-    const nextPrompt = agentContinuationMessage(turn.endDecision);
-    if (!nextPrompt) break;
-    continuationCount += 1;
-    if (continuationCount > MAX_AGENT_CONTINUATIONS) {
-      errorSubtype = 'error_max_turns';
-      process.exitCode = 1;
-      break;
-    }
-    prompt = nextPrompt;
-  }
-  return { turns, errorSubtype };
-}
-
-async function runExecuteTurn(prompt, stdin, sessionId, parsed, plugins, thread, priorTurns = []) {
-  const messageId = createThreadMessageID();
-  const startDecision = await runPluginEventHandlers(plugins.handlers['agent.start'], {
-    message: prompt,
-    id: messageId,
-    thread: { id: sessionId },
-  });
-  const promptWithPluginContext = appendAgentStartMessage(prompt, startDecision);
-  const expandedPrompt = expandFileReferences(promptWithPluginContext, { parsed });
-  const guidancePrompt = expandAgentGuidanceReferences(expandedPrompt, parsed);
-  const turnPrompt = guidancePrompt ? `${guidancePrompt}\n${expandedPrompt}` : expandedPrompt;
-  const contextThread = threadContextForTurn(thread, sessionId, priorTurns);
-  const modelPrompt = contextThread
-    ? threadContinuationPrompt(contextThread, turnPrompt)
-    : expandThreadReferences(turnPrompt);
-  const toolRun = await executePromptToolRequest(prompt, stdin, sessionId, parsed, plugins);
-  const result = toolRun?.output ?? fixtureAgentResponse(applySystemPrompt(modelPrompt, parsed), stdin);
-  const endDecision = await runPluginEventHandlers(plugins.handlers['agent.end'], {
-    message: prompt,
-    id: messageId,
-    result,
-    status: agentTurnStatus(toolRun),
-    messages: pluginMessagesForTurn(prompt, result, toolRun, messageId),
-    thread: { id: sessionId },
-  });
-  return { prompt, result, toolRun, endDecision };
-}
-
-function agentTurnStatus(toolRun) {
-  return (toolRun?.exitCode ?? 0) === 0 ? 'done' : 'error';
-}
-
-function createThreadMessageID() {
-  return `msg_${randomUUID()}`;
-}
-
-function appendAgentStartMessage(prompt, decision = {}) {
-  validateAgentStartDecision(decision);
-  const content = decision.message?.content.trim() ?? '';
-  if (!content) return prompt;
-  return prompt ? `${prompt}\n\n${content}` : content;
-}
-
-function validateAgentStartDecision(decision = {}) {
-  if (!decision || typeof decision !== 'object' || !Object.hasOwn(decision, 'message')) return;
-  if (Object.keys(decision).some((key) => key !== 'message')) {
-    throw new Error('plugin agent.start fields must match the documented shape');
-  }
-  if (!decision.message || typeof decision.message !== 'object' || Array.isArray(decision.message)) {
-    throw new Error('plugin agent.start message must be an object');
-  }
-  if (Object.keys(decision.message).some((key) => key !== 'content' && key !== 'display')) {
-    throw new Error('plugin agent.start message fields must be content and display');
-  }
-  if (typeof decision.message?.content !== 'string') {
-    throw new Error('plugin agent.start message content must be a string');
-  }
-  if (decision.message.display !== true) {
-    throw new Error('plugin agent.start message display must be true');
-  }
-}
-
-function threadContextForTurn(thread, sessionId, priorTurns = []) {
-  if (!thread && priorTurns.length === 0) return undefined;
-  return {
-    id: thread?.id ?? sessionId,
-    messages: [
-      ...(thread?.messages ?? []),
-      ...turnMessages(priorTurns),
-    ],
-  };
-}
-
-function turnMessages(turns) {
-  return turns.flatMap((turn) => [
-    { role: 'user', content: turn.prompt },
-    { role: 'assistant', content: turn.result },
-  ]);
-}
-
-function pluginMessagesForTurn(prompt, result, toolRun, messageId = createThreadMessageID()) {
-  const messages = [{ role: 'user', id: messageId, content: textContent(prompt) }];
-  if (toolRun?.toolUse) {
-    messages.push({ role: 'assistant', id: createThreadMessageID(), content: [toolRun.toolUse] });
-    messages.push({
-      role: 'user',
-      id: createThreadMessageID(),
-      content: [{
-        type: 'tool_result',
-        toolUseID: toolRun.toolUse.id,
-        output: toolResultContent(toolRun),
-        status: toolRun.exitCode !== 0 ? 'error' : 'done',
-      }],
-    });
-  }
-  messages.push({ role: 'assistant', id: createThreadMessageID(), content: textContent(result) });
-  return messages;
-}
-
-function textContent(text) {
-  return [{ type: 'text', text: String(text ?? '') }];
-}
-
-function agentContinuationMessage(decision) {
-  validateAgentEndDecision(decision);
-  if (decision?.action !== 'continue') return undefined;
-  return typeof decision.userMessage === 'string' && decision.userMessage.trim()
-    ? decision.userMessage
-    : undefined;
-}
-
-function validateAgentEndDecision(decision) {
-  if (decision === undefined) return;
-  if (decision?.action === 'allow') return;
-  if (!decision || typeof decision !== 'object' || decision.action !== 'continue') {
-    throw new Error('plugin agent.end action must be continue');
-  }
-  if (typeof decision.userMessage !== 'string') {
-    throw new Error('plugin agent.end continue userMessage must be a string');
-  }
-}
-
-async function runStreamJsonInputExecute(parsed, stdin, options = {}, started = Date.now()) {
-  const sessionId = options.thread?.id ?? `T-${randomUUID()}`;
-  const inputMessages = streamJsonInputMessages(parsed.prompt, stdin);
-  const combinedPrompt = inputMessages.map((message) => message.text).filter(Boolean).join('\n\n');
-  const plugins = await loadPlugins(process.cwd());
-  await runSessionStartHandlers(plugins, sessionId);
-  await emitStreamJsonInit({
-    parsed,
-    plugins,
-    sessionId,
-    promptForMcpDiscovery: combinedPrompt,
-  });
-
-  const transcript = [];
-  const persistedMessages = [];
-  const permissionDenials = [];
-  let result = '';
-  let parentToolUseId = null;
-  let numTurns = 0;
-  let isError = false;
-
-  for (const input of inputMessages) {
-    const messageId = createThreadMessageID();
-    const startDecision = await runPluginEventHandlers(plugins.handlers['agent.start'], {
-      message: input.text,
-      id: messageId,
-      thread: { id: sessionId },
-    });
-    const inputTextWithPluginContext = appendAgentStartMessage(input.text, startDecision);
-    const expandedPrompt = expandFileReferences(inputTextWithPluginContext, { parsed });
-    const guidancePrompt = expandAgentGuidanceReferences(expandedPrompt, parsed);
-    const turnPrompt = guidancePrompt ? `${guidancePrompt}\n${expandedPrompt}` : expandedPrompt;
-    const modelPrompt = modelPromptWithTranscript(turnPrompt, transcript, options.thread, parsed);
-    const toolRun = await executePromptToolRequest(input.text, '', sessionId, parsed, plugins);
-    result = toolRun?.output ?? fixtureAgentResponse(modelPrompt, '');
-    numTurns += streamJsonTurnCount([{ toolRun }]);
-    if (toolRun?.permissionDenials) permissionDenials.push(...toolRun.permissionDenials);
-    if ((toolRun?.exitCode ?? 0) !== 0) isError = true;
-
-    if (toolRun?.toolUse) {
-      parentToolUseId = toolRunParent(toolRun, 'finalParentToolUseId', null);
-    }
-    emitStreamJsonTurn({
-      userContent: streamJsonOutputUserContent(input.content),
-      steer: input.steer,
-      promptText: input.text,
-      toolRun,
-      result,
-      parsed,
-      sessionId,
-      assistantParentToolUseId: parentToolUseId,
-    });
-    await runPluginEventHandlers(plugins.handlers['agent.end'], {
-      message: input.text,
-      id: messageId,
-      result,
-      status: agentTurnStatus(toolRun),
-      messages: pluginMessagesForTurn(input.text, result, toolRun, messageId),
-      thread: { id: sessionId },
-    });
-    transcript.push({ user: input.text, assistant: result });
-    persistedMessages.push(
-      { role: 'user', content: input.text },
-      { role: 'assistant', content: result },
-    );
-  }
-
-  emitJson(streamJsonResultMessage({
-    started,
-    isError,
-    numTurns,
-    result,
-    sessionId,
-    usage: estimateUsage(combinedPrompt, result),
-    permissionDenials: streamJsonPermissionDenials(permissionDenials),
-  }));
-  const thread = await persistThreadMessages(sessionId, persistedMessages, parsed.mode, options.thread, parsed);
-  notifyAgentComplete(parsed);
-  return thread;
-}
-
-async function runSessionStartHandlers(plugins, sessionId) {
-  await runPluginEventHandlers(plugins.handlers['session.start'], {
-    thread: { id: sessionId },
-  });
-}
-
-function modelPromptWithTranscript(turnPrompt, transcript, thread, parsed = {}) {
-  const context = transcript.length > 0
-    ? `[conversation:${thread?.id ?? 'stream-json-input'}]\n${transcript
-      .map((entry) => `user: ${entry.user}\nassistant: ${entry.assistant}`)
-      .join('\n')}\n[/conversation]\n`
-    : '';
-  const prompt = `${context}${turnPrompt}`;
-  const modelPrompt = thread ? threadContinuationPrompt(thread, prompt) : expandThreadReferences(prompt);
-  return applySystemPrompt(modelPrompt, parsed);
-}
-
-function applySystemPrompt(prompt, parsed = {}) {
-  const systemPrompt = readEffectiveSettings(parsed)['covenCode.systemPrompt'];
-  if (typeof systemPrompt !== 'string' || systemPrompt.trim() === '') return prompt;
-  return `[system]\n${systemPrompt.trim()}\n[/system]\n${prompt}`;
-}
-
-function expandAgentGuidanceReferences(expandedPrompt, parsed = {}) {
-  const readFiles = filesInPrompt(expandedPrompt);
-  const agentFiles = [
-    ...discoverAgentFiles(process.cwd()),
-    ...discoverSubtreeAgentFiles(readFiles),
-  ];
-  const blocks = [...new Set(agentFiles)]
-    .map((filePath) => guidanceBlock(filePath, readFiles, parsed))
-    .filter(Boolean);
-  return blocks.join('\n');
-}
-
-function discoverSubtreeAgentFiles(readFiles) {
-  const cwd = path.resolve(process.cwd());
-  const files = [];
-  for (const filePath of readFiles) {
-    let current = path.dirname(path.resolve(filePath));
-    while (current.startsWith(cwd) && current !== cwd && current !== path.dirname(current)) {
-      const guidance = firstGuidanceInDir(current);
-      if (guidance) files.push(guidance);
-      current = path.dirname(current);
-    }
-  }
-  return files;
-}
-
-function guidanceBlock(filePath, readFiles, parsed = {}) {
-  try {
-    const content = readFileSync(filePath, 'utf8');
-    const expandable = stripFencedCodeBlocks(content);
-    const expanded = expandFileReferences(expandable, {
-      baseDir: path.dirname(filePath),
-      parsed,
-      includeFile: (mentionedFile, mentionedContent) => guidanceMentionApplies(mentionedFile, mentionedContent, readFiles),
-    });
-    return `[agent:${filePath}]\n${expanded}\n[/agent]`;
-  } catch {
-    return undefined;
-  }
-}
-
-function filesInPrompt(prompt) {
-  return [...prompt.matchAll(/\[file:([^\]\r\n]+)\]/g)].map((match) => path.resolve(match[1]));
-}
-
-function guidanceMentionApplies(mentionedFile, content, readFiles) {
-  const globs = frontmatterGlobs(content);
-  if (globs.length === 0) return true;
-  return readFiles.some((filePath) => globs.some((glob) => guidanceGlobMatches(glob, filePath, mentionedFile)));
-}
-
-function frontmatterGlobs(content) {
-  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!match) return [];
-  const frontmatter = match[1];
-  const inline = frontmatter.match(/^globs:\s*\[(.*)\]\s*$/m);
-  if (inline) {
-    return inline[1]
-      .split(',')
-      .map((entry) => entry.trim().replace(/^["']|["']$/g, ''))
-      .filter(Boolean);
-  }
-  const lines = frontmatter.split(/\r?\n/);
-  const globs = [];
-  let inGlobs = false;
-  for (const line of lines) {
-    if (/^globs:\s*$/.test(line)) {
-      inGlobs = true;
-      continue;
-    }
-    if (inGlobs) {
-      const entry = line.match(/^\s*-\s*(.+?)\s*$/);
-      if (entry) globs.push(entry[1].replace(/^["']|["']$/g, ''));
-      else if (/^\S/.test(line)) break;
-    }
-  }
-  return globs.filter(Boolean);
-}
-
-function guidanceGlobMatches(pattern, readFile, guidanceFile) {
-  const normalized = path.normalize(pattern);
-  if (normalized.startsWith(`..${path.sep}`) || normalized.startsWith(`.${path.sep}`)) {
-    const absolutePattern = path.resolve(path.dirname(guidanceFile), normalized);
-    return globToRegex(path.normalize(absolutePattern)).test(path.normalize(readFile));
-  }
-  const relative = path.relative(process.cwd(), readFile);
-  const candidates = normalized.startsWith(`**${path.sep}`)
-    ? [normalized]
-    : [normalized, `**${path.sep}${normalized}`];
-  return candidates.some((candidate) => globToRegex(path.normalize(candidate)).test(path.normalize(relative)));
-}
-
-function stripFencedCodeBlocks(text) {
-  return text.replace(/```[\s\S]*?```/g, '');
-}
-
-function combinePrompt(prompt, stdin, streamJsonInput) {
-  if (streamJsonInput && stdin.trim()) {
-    return streamJsonInputMessages(prompt, stdin)
-      .map((message) => message.text)
-      .filter(Boolean)
-      .join('\n');
-  }
-
-  const processedStdin = stdin;
-  if (prompt && processedStdin.trim()) return `${prompt}\n\n${processedStdin.trimEnd()}`;
-  if (prompt) return prompt;
-  return processedStdin.trimEnd();
-}
-
-export { UsageError };

package/src/cli/help.mjs

@@ -1,58 +0,0 @@
-import { CLI_NAME, PRODUCT_NAME } from '../constants.mjs';
-
-export function printHelp() {
-  console.log(`${PRODUCT_NAME}
-
-Usage: ${CLI_NAME} [options] [command]
-
-Run with no arguments in a terminal to enter the panel TUI. Set
-COVEN_CODE_REPL=1 to use the classic readline REPL. Piped stdin becomes the
-first interactive message when stdout is a TTY. Pass --execute or redirect
-stdout to run a single turn and exit.
-
-Options:
-      --execute, -x [prompt]   Run one agent turn, print the final answer, and exit
-      --stream-json            Emit structured JSONL in execute mode
-      --stream-json-thinking   Include thinking blocks in stream JSON output
-      --stream-json-input      Read one or more user messages as JSONL from stdin
-      --dangerously-allow-all  Allow tool calls that would otherwise require approval
-      --mcp-config <json>      Add an inline MCP server config for this run
-      --settings-file <path>   Read user settings from a specific file
-      --mode <name>            Agent mode: smart, deep, rush, or large
-      --reasoning-effort <level>
-                               Set reasoning effort for the active mode
-      --label <name>           Add a label to the created or continued thread
-      --visibility <level>     Thread visibility: private, public, workspace, group, or unlisted
-      --archive                Archive the thread after the execute turn
-      --continue [thread-id]   Continue the latest active thread or the specified thread
-      --toolbox <path>         Use a PATH-like toolbox root for this run
-      --skills <path>          Use a PATH-like skill root for this run
-      --jetbrains              Connect to a JetBrains IDE
-  -h, --help                   Show help
-  -v, --version                Show version
-
-Commands:
-  login                        Print local login instructions
-  update                       Check for updates
-  usage                        Show local usage estimates
-  review                       Run configured local review checks
-  tools list|make|show|use     Manage built-in and toolbox tools
-  permissions list             Show permission policy rules
-  config edit [--workspace]    Open settings in $EDITOR
-  ide connect                  Connect or inspect local IDE integration
-  mcp add|list|doctor|approve|oauth
-                               Manage MCP server settings
-  skill list|show              Inspect discovered Coven Code agent skills
-  plugins list|reload          Show and reload project and user plugin files
-  threads list|show|search|archive|visibility|continue|map|report
-                               Manage local thread records
-  agents-md list               Show AGENTS.md guidance files used for this cwd
-  agents list                  Alias for agents-md list
-
-TUI lane commands:
-  /lane refresh                Refresh worktree, branch, changed files, and diff summary
-  /lane harness <name|next>    Select smart, deep, rush, or large for the lane
-  /lane verify                 Run the detected verification command for the lane
-  /lane status|diff            Show lane status or diff summary
-`);
-}

package/src/cli/interactive-core.mjs

@@ -1,28 +0,0 @@
-import { runCommand } from './dispatch.mjs';
-import { runExecute } from './execute.mjs';
-import { readEditorPrompt, submitPromptAndQueue } from './interactive-io.mjs';
-import { handleSlashCommand, sessionSlashHelpLines } from './interactive-slash.mjs';
-
-export function createInteractiveSession(parsed, options = {}) {
-  return {
-    parsed,
-    thread: options.thread,
-    cwd: options.cwd ?? process.cwd(),
-    queuedMessages: [],
-    silent: options.silent ?? false,
-    commandRunner: options.commandRunner ?? runCommand,
-    executeRunner: options.executeRunner ?? runExecute,
-    editorReader: options.editorReader ?? readEditorPrompt,
-  };
-}
-
-export async function handleInteractiveInput(session, text) {
-  if (!text) return { kind: 'empty', lines: [] };
-  if (text === '/exit' || text === '/quit') return { kind: 'exit', lines: [] };
-  if (text === '/help') return { kind: 'help', lines: await sessionSlashHelpLines(session) };
-  if (!text.startsWith('/')) {
-    await submitPromptAndQueue(session, text);
-    return { kind: 'turn', lines: [] };
-  }
-  return handleSlashCommand(session, text);
-}

package/src/cli/interactive-io.mjs

@@ -1,101 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { spawnSync } from 'node:child_process';
-import { appendFile, mkdir, readFile, unlink, writeFile } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import path from 'node:path';
-import { CLI_NAME, CONFIG_SUBDIR, REPL_HISTORY_LIMIT } from '../constants.mjs';
-import { configDir } from '../settings/paths.mjs';
-import { shellQuote } from '../util/shell.mjs';
-import { latestActiveThread, requireThread } from '../threads/store.mjs';
-import { runExecute } from './execute.mjs';
-
-export async function runInteractiveTurn(parsed, text, thread, executeRunner = runExecute, options = {}) {
-  try {
-    return await executeRunner(
-      { ...parsed, execute: true, prompt: text, streamJson: false, streamJsonThinking: false, streamJsonInput: false },
-      '',
-      { thread, ...options },
-    );
-  } catch (error) {
-    console.error(`${CLI_NAME}: ${error?.message ?? error}`);
-    return thread;
-  }
-}
-
-export async function submitPromptAndQueue(session, text) {
-  session.thread = await runInteractiveTurn(session.parsed, text, session.thread, session.executeRunner, { silent: session.silent });
-  while (session.queuedMessages.length > 0) {
-    session.thread = await runInteractiveTurn(session.parsed, session.queuedMessages.shift(), session.thread, session.executeRunner, { silent: session.silent });
-  }
-}
-
-export async function readEditorPrompt(initialText = '') {
-  const editor = process.env.EDITOR || process.env.VISUAL;
-  if (!editor) {
-    console.error(`${CLI_NAME}: /editor requires $EDITOR or $VISUAL`);
-    return '';
-  }
-  const file = path.join(tmpdir(), `${CONFIG_SUBDIR}-prompt-${process.pid}-${Date.now()}.md`);
-  try {
-    await writeFile(file, initialText);
-    const result = spawnSync(`${editor} ${shellQuote(file)}`, {
-      stdio: 'inherit',
-      shell: true,
-    });
-    if (result.error) {
-      console.error(`${CLI_NAME}: Unable to run editor: ${result.error.message}`);
-      return '';
-    }
-    if ((result.status ?? 0) !== 0) {
-      console.error(`${CLI_NAME}: Editor exited with status ${result.status}`);
-      return '';
-    }
-    return (await readFile(file, 'utf8')).trim();
-  } finally {
-    await unlink(file).catch(() => {});
-  }
-}
-
-export function editablePreviousPrompt(thread) {
-  const index = (thread.messages ?? []).findLastIndex((message) => (
-    message.role === 'user' && typeof message.content === 'string'
-  ));
-  if (index === -1) throw new Error('No previous user prompt to edit');
-  return { index, prompt: thread.messages[index].content };
-}
-
-export function interactiveContinuationThread(threadId) {
-  if (threadId) return requireThread(threadId);
-  const thread = latestActiveThread();
-  if (!thread) throw new Error('No active thread to continue');
-  return thread;
-}
-
-export function replHistoryFile() {
-  return process.env.COVEN_CODE_REPL_HISTORY_FILE
-    || path.join(configDir(), CONFIG_SUBDIR, 'repl_history');
-}
-
-export function loadReplHistory() {
-  if (process.env.COVEN_CODE_REPL_HISTORY === '0') return [];
-  try {
-    return readFileSync(replHistoryFile(), 'utf8')
-      .split(/\r?\n/)
-      .filter(Boolean)
-      .slice(-REPL_HISTORY_LIMIT)
-      .reverse();
-  } catch {
-    return [];
-  }
-}
-
-export async function appendReplHistory(line) {
-  if (process.env.COVEN_CODE_REPL_HISTORY === '0') return;
-  try {
-    const file = replHistoryFile();
-    await mkdir(path.dirname(file), { recursive: true });
-    await appendFile(file, `${line}\n`);
-  } catch {
-    // history must never break the REPL
-  }
-}