Yuriy a88c34aa15 Protocol v2 schema plumbing (Commit 2)

- llm_response_schema_v2.json: object-only, PATCH_FILE, base_sha256
- PAPAYU_PROTOCOL_VERSION=1|2 (default 1)
- schema_version and schema_hash dynamic in trace/log
- compiled_response_schema uses v1 or v2 by protocol
- response_format sends v2 schema when protocol=2
- Tests: test_schema_v2_compiles, test_schema_hash_non_empty_v2
- trace_to_golden: schema_hash_for_version by trace schema_version

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-01-31 11:58:49 +03:00

2.6 KiB

Raw Blame History

План Protocol v2

Минимальный набор изменений для v2 — без «воды».

3.1. Главная цель v2

Снизить риск/стоимость «UPDATE_FILE целиком» и улучшить точность правок:

частичные патчи,
«операции редактирования» вместо полной перезаписи.

3.2. Минимальный набор изменений

A) Новый action kind: `PATCH_FILE`

Вместо полного content, передаётся unified diff:

{ "kind": "PATCH_FILE", "path": "src/app.py", "patch": "@@ -1,3 +1,4 @@\n..." }

Валидация патча локально.
Применение патча транзакционно.
Preview diff становится тривиальным.

B) Новый action kind: `REPLACE_RANGE`

Если unified diff сложен:

{
  "kind": "REPLACE_RANGE",
  "path": "src/app.py",
  "start_line": 120,
  "end_line": 180,
  "content": "новый блок"
}

Плюсы: проще валидировать. Минусы: зависит от line numbers (хрупко при изменениях).

C) «Base hash» для UPDATE/PATCH

Исключить race (файл изменился между plan/apply):

{ "kind": "PATCH_FILE", "path": "...", "base_sha256": "...", "patch": "..." }

Если hash не совпал → Err и переход в PLAN.

3.3. Совместимость v1/v2

schema_version=1 → нынешний формат (UPDATE_FILE, CREATE_FILE, …).
schema_version=2 → допускает PATCH_FILE / REPLACE_RANGE и расширенные поля.

В коде:

Компилировать обе схемы: llm_response_schema.json (v1), llm_response_schema_v2.json.
Выбор активной по env: PAPAYU_PROTOCOL_VERSION=1|2 (default 1).
Валидация/парсер: сначала проверить schema v2 (если включена), иначе v1.

3.4. Порядок внедрения v2 без риска

Добавить v2 schema + валидаторы + apply engine, не включая по умолчанию.
Добавить «LLM prompt v2» (рекомендовать PATCH_FILE вместо UPDATE_FILE).
Прогнать на своих проектах и собрать golden traces v2.
Когда стабильно — сделать v2 дефолтом, сохранив совместимость v1.

2.6 KiB Raw Blame History Unescape Escape