Function formatReferencesForPrompt

src/session/references.js:108–135

* Format resolved files for injection into the conversation. * Returns a string to append to the user message. * Capped at ~2000 tokens (8000 chars) to prevent context overflow when * the user types @dir/ on a large directory.

(files)

 * the user types @dir/ on a large directory.
 */
function formatReferencesForPrompt(files) {
  if (files.length === 0) return '';

  const MAX_REF_CHARS = 8000; // ~2000 tokens
  let output = '\n\n--- Referenced files ---\n';
  let totalChars = output.length;

  for (const file of files) {
    let entry = '';
    if (file.type === 'file') {
      // Cap individual file content to 4000 chars
      const cappedContent = file.content.length > 4000
        ? file.content.slice(0, 4000) + `\n... (${file.lines} lines total, truncated)`
        : file.content;
      entry = `\n📄 ${file.path} (${file.lines} lines):\n\`\`\`\n${cappedContent}\n\`\`\`\n`;
    } else {
      entry = `\n📁 ${file.path}/:\n${file.content}\n`;
    }

    if (totalChars + entry.length > MAX_REF_CHARS) {
      output += `\n... (${files.length - files.indexOf(file)} more files truncated to fit context budget)\n`;
      break;
    }
    output += entry;
    totalChars += entry.length;
  }
  return output;
}

module.exports = { resolveReferences, formatReferencesForPrompt, FILE_REGEX };