Function agentToToml

scripts/codex-compat.js:485–537

(fm, fullContent)

  // Per-agent override via frontmatter takes precedence — useful for an agent
  // whose definition really needs more room.
  if (fm.codex_max_chars !== undefined) {
    const n = Number(fm.codex_max_chars);
    if (Number.isFinite(n) && n >= 0) return n;
  }
  // Project-wide override via env var.
  const envVal = process.env.CITADEL_CODEX_AGENT_MAX_CHARS;
  if (envVal !== undefined && envVal !== '') {
    const n = Number(envVal);
    if (Number.isFinite(n) && n >= 0) return n;
  }
  return DEFAULT_AGENT_MAX_CHARS;
}

function translateAgents() {
  console.log('Translating agent definitions...');

  const agentsDir = path.join(CITADEL_ROOT, 'agents');
  if (!fs.existsSync(agentsDir)) {
    console.log('  No agents/ directory found, skipping.');
    return;
  }

  const agentFiles = fs.readdirSync(agentsDir).filter(f => f.endsWith('.md'));
  const agentConfig = loadCodexAgentConfig(PROJECT_ROOT);

  for (const file of agentFiles) {
    const content = fs.readFileSync(path.join(agentsDir, file), 'utf8');
    const fm = parseFrontmatter(content);
    if (!fm.name) continue;

    const toml = agentToToml(fm, content, agentConfig);
    writeFile(
      path.join(PROJECT_ROOT, '.codex', 'agents', `${fm.name}.toml`),
      toml
    );
    console.log(`  ${file} -> .codex/agents/${fm.name}.toml`);
  }
}

function agentToToml(fm, fullContent, agentConfig) {
  // Extract the body after frontmatter as developer_instructions
  const normalized = fullContent.replace(/\r\n/g, '\n');
  const bodyMatch = normalized.match(/^---\n[\s\S]*?\n---\n([\s\S]*)/);
  const body = bodyMatch ? bodyMatch[1].trim() : '';

  // Truncate instructions, but loudly. Set CITADEL_CODEX_AGENT_MAX_CHARS=0
  // (or higher than the body length) to disable.
  const maxChars = getAgentMaxChars(fm);
  if (maxChars > 0 && body.length > maxChars) {
    const droppedChars = body.length - maxChars;
    console.warn(
      `  warning: agent "${fm.name}" instructions truncated — dropped ${droppedChars} chars ` +
      `(body=${body.length}, cap=${maxChars}). Set codex_max_chars in frontmatter or ` +
      `CITADEL_CODEX_AGENT_MAX_CHARS env to raise the cap.`
    );
  }