Coding Agents

// Цикл кодинг-агента
interface CodingTask {
  spec: string
  language: string
  existingCode?: string
}

interface CodeResult {
  files: Array<{ path: string; content: string }>
  testOutput: string
  passed: boolean
}

class CodingAgent {
  async run(task: CodingTask): Promise<CodeResult> {
    // 1. Understand — понять задачу
    const requirements = await this.analyze(task.spec)
    this.log("understand", requirements)

    // 2. Plan — спланировать решение
    const plan = await this.planImplementation(requirements, task)
    this.log("plan", plan)

    // 3. Code — написать код
    const files = await this.writeCode(plan)
    this.log("code", files)

    // 4. Test — запустить тесты
    const testOutput = await this.runTests(files)
    this.log("test", testOutput)

    // 5. Iterate — исправить ошибки
    if (!testOutput.passed && this.attempts < 3) {
      this.attempts++
      return this.fixAndRetry(task)
    }

    return { files, testOutput, passed: testOutput.passed }
  }

  private async analyze(spec: string) {
    // LLM: извлечь требования из описания
  }

  private async planImplementation(reqs: unknown, task: CodingTask) {
    // LLM: спланировать структуру файлов, API, типы
  }

  private async writeCode(plan: unknown) {
    // LLM + filesystem: написать и сохранить файлы
  }

  private async runTests(files: unknown) {
    // bash: запустить тесты и получить вывод
  }
}

// Инструменты кодинг-агента
const codingTools = [
  // Чтение и запись файлов
  {
    name: "read_file",
    description: "Читает содержимое файла по пути",
    parameters: { path: "string" },
  },
  {
    name: "write_file",
    description: "Записывает содержимое в файл",
    parameters: { path: "string", content: "string" },
  },
  {
    name: "list_files",
    description: "Список файлов в директории",
    parameters: { dir: "string" },
  },
  // Поиск по проекту
  {
    name: "search_code",
    description: "Поиск по тексту в проекте",
    parameters: { query: "string", pattern: "string" },
  },
  // Выполнение команд
  {
    name: "run_terminal",
    description: "Запускает команду в терминале",
    parameters: { command: "string", timeout: "number" },
  },
  // Установка зависимостей
  {
    name: "install_package",
    description: "Устанавливает npm-пакет",
    parameters: { name: "string", type: "string" },
  },
]

// Уровни безопасности для кодинг-агента
enum SafetyLevel {
  READ_ONLY,  // Только читать файлы, ничего не менять
  SANDBOX,    // Писать в изолированную директорию
  REVIEW,     // Писать, но каждое изменение требует утверждения
  FULL,       // Полный доступ (только для trusted окружений)
}

interface SafetyPolicy {
  level: SafetyLevel
  allowedCommands: string[]  // whitelist команд bash
  maxTimeout: number         // макс. время выполнения (мс)
  requireReview: boolean     // требовать ревью изменений
  allowedFiles: string[]     // glob-паттерны разрешённых файлов
}

const codingAgentPolicy: SafetyPolicy = {
  level: SafetyLevel.REVIEW,
  allowedCommands: [
    "npm test",
    "npx eslint",
    "npx tsc --noEmit",
    "node",
    "python3",
  ],
  maxTimeout: 30_000,
  requireReview: true,
  allowedFiles: ["src/**/*.ts", "src/**/*.tsx", "*.json", "*.md"],
}