devcontour-harness 0.1.0-alpha.34 → 0.1.0-alpha.35

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/README.md +8 -2
  2. package/docs/contracts.md +54 -8
  3. package/docs/release-notes/0.1.0-alpha.35.md +27 -0
  4. package/docs/upgrade.md +35 -0
  5. package/lib/agents/cli-adapter.d.ts +10 -1
  6. package/lib/agents/cli-adapter.js +38 -7
  7. package/lib/agents/usage.d.ts +9 -0
  8. package/lib/agents/usage.js +22 -1
  9. package/lib/contracts/cli.d.ts +49 -1
  10. package/lib/contracts/cli.js +1 -0
  11. package/lib/contracts/diagnosis.d.ts +3 -1
  12. package/lib/contracts/diagnosis.js +1 -0
  13. package/lib/contracts/errors.d.ts +3 -1
  14. package/lib/contracts/errors.js +2 -0
  15. package/lib/contracts/events.d.ts +15 -0
  16. package/lib/contracts/execution.d.ts +32 -1
  17. package/lib/contracts/execution.js +19 -0
  18. package/lib/contracts/failure.d.ts +7 -3
  19. package/lib/contracts/failure.js +6 -2
  20. package/lib/contracts/handoff.d.ts +9 -0
  21. package/lib/contracts/planning.d.ts +2 -0
  22. package/lib/contracts/ports.d.ts +10 -2
  23. package/lib/contracts/published.d.ts +28 -0
  24. package/lib/contracts/repair-policy.d.ts +10 -1
  25. package/lib/contracts/repair-policy.js +18 -0
  26. package/lib/contracts/report.d.ts +2 -0
  27. package/lib/contracts/result.d.ts +2 -0
  28. package/lib/control/harness.d.ts +10 -10
  29. package/lib/control/recovery.d.ts +1 -1
  30. package/lib/control/status.d.ts +8 -8
  31. package/lib/engine/classify.js +1 -1
  32. package/lib/engine/engine.d.ts +9 -7
  33. package/lib/engine/engine.js +3 -0
  34. package/lib/engine/failure.d.ts +1 -1
  35. package/lib/engine/failure.js +1 -1
  36. package/lib/engine/prompt.js +11 -1
  37. package/lib/engine/property-recovery.js +2 -0
  38. package/lib/engine/repair.js +4 -2
  39. package/lib/engine/reuse.js +2 -0
  40. package/lib/engine/runner.js +9 -0
  41. package/lib/explain/state.d.ts +1 -1
  42. package/lib/explain/state.js +10 -4
  43. package/lib/index.d.ts +1 -1
  44. package/lib/index.js +1 -1
  45. package/lib/projections/stop.d.ts +3 -1
  46. package/lib/projections/stop.js +30 -2
  47. package/lib/report/compute.js +1 -0
  48. package/lib/report/document.js +1 -1
  49. package/lib/storage/document.d.ts +8 -6
  50. package/package.json +1 -1
  51. package/schemas/execution-document.schema.json +11 -0
  52. package/schemas/handoff-pack.schema.json +9 -0
  53. package/schemas/result-envelope.schema.json +1 -0
  54. package/schemas/run-event.schema.json +3 -0
  55. package/schemas/run-result.schema.json +1 -0
  56. package/schemas/stop-diagnosis.schema.json +2 -0
  57. package/schemas/value-report.schema.json +1 -0
package/README.md CHANGED
@@ -5,7 +5,7 @@ Headless-движок исполнения инженерных поручени
5
5
  интеграция с принятой веткой через compare-and-swap и машинный результат с SHA
6
6
  и доказательствами.
7
7
 
8
- > Статус: `0.1.0-alpha.34` — предварительный выпуск (alpha). Договоры
8
+ > Статус: `0.1.0-alpha.35` — предварительный выпуск (alpha). Договоры
9
9
  > `v1alpha1` могут измениться между alpha-версиями; закрепляйте точную версию.
10
10
  > Файл → ревью плана → кандидат → интеграция → принятие → результат JSON, с
11
11
  > ограниченным восстановлением, повторным использованием кандидата, бюджетами,
@@ -28,7 +28,7 @@ Headless-движок исполнения инженерных поручени
28
28
  Из npm — точная версия (воспроизводимо) или последняя alpha по тегу:
29
29
 
30
30
  ```sh
31
- npm install --save-exact devcontour-harness@0.1.0-alpha.34 # точная версия
31
+ npm install --save-exact devcontour-harness@0.1.0-alpha.35 # точная версия
32
32
  # или: npm install --save-exact devcontour-harness@alpha # текущая alpha
33
33
  npx harness --version
34
34
  ```
@@ -148,6 +148,12 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
148
148
  `devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
149
149
  Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
150
150
 
151
+ ## Выпуск 0.1.0-alpha.35
152
+
153
+ Нехватка окна контекста claude — отдельный класс отказа `context-exhausted`
154
+ с кодом `CONTEXT_EXHAUSTED` и короткой политикой повторов. Подробно —
155
+ [заметки выпуска](docs/release-notes/0.1.0-alpha.35.md).
156
+
151
157
  ## Выпуск 0.1.0-alpha.34
152
158
 
153
159
  События повторов, отмен, сдвигов базы и причин отказа среды; отчёт об
package/docs/contracts.md CHANGED
@@ -660,6 +660,50 @@ fencing; само состояние между переходами не пер
660
660
  причину `stalled` у работающего поручения: при `report` действует человек
661
661
  (`fix-environment`), при `stop` — controller.
662
662
 
663
+ ### Нехватка окна контекста
664
+
665
+ Отказ класса `context-exhausted` — исполнителю или reviewer не хватило окна
666
+ контекста модели внутри попытки. Класс ставится по признаку, который сообщил
667
+ сам runtime, а не по тексту причины: адаптер claude читает `terminal_reason`
668
+ итогового события `result` потока `stream-json` и выставляет
669
+ `RuntimeResponse.diagnostics.contextExhausted` — предел окна
670
+ (`ContextLimit`). Записанные на живом CLI признаки:
671
+
672
+ - `prompt_too_long` на первом ходе (`num_turns` ≤ 1) → `prompt-too-long` —
673
+ запрос отклонён: уже подсказка с контекстом больше окна, сжимать нечего.
674
+ Тот же признак после ходов работы или без `num_turns` (не записан, вывод
675
+ инструментов заполнил окно) → `blocking-limit`;
676
+ - `blocking_limit` → `blocking-limit` — CLI сам остановил ход у предела окна.
677
+ Записан с выключенным автоматическим сжатием через `DISABLE_AUTO_COMPACT=1`.
678
+ `autoCompactEnabled: false` в `--settings` сжатие тоже выключает (проверено),
679
+ но исход у предела окна с ним не записан; путь «сжатие включено, но не
680
+ помогло» не проверен.
681
+
682
+ В обоих случаях CLI выходил с кодом 1, `is_error: true`, текст `result`
683
+ начинался с `Prompt is too long`; признак учитывается и при коде 0. Текст
684
+ отказа попытки постоянный (`claude: не хватило окна контекста модели`), предел
685
+ — данными (`AttemptState.contextLimit`), текст runtime — в журнале вызова:
686
+ отпечаток один при любом пределе и любых числах токенов, а «401» или «429» в
687
+ числах токенов текстовый разбор принял бы за отказ провайдера. Успешное
688
+ автоматическое сжатие (`system`/`compact_boundary`) — не отказ: вызов
689
+ продолжается и завершается своим исходом; число сжатий и `terminal_reason`
690
+ пишутся в `runtime.json` вызова (`compactions`, `terminalReason`). У codex
691
+ признак пока не распознаётся: его отказ классифицируется как прежде.
692
+
693
+ Попытка засчитывается в `maxAttempts`: отказ говорит о размере задачи, а не
694
+ об окружении, и выдачу не останавливает. Повторы (`repairRepeats`): у
695
+ `blocking-limit` — один (`repairPolicy['context-exhausted'].repeats`), и
696
+ следующая попытка writer получает в подсказке указание держать контекст малым
697
+ (читать только нужные файлы и строки, не выводить большие файлы и длинный
698
+ вывод команд); у `prompt-too-long` — ни одного: повтор только удлинил бы
699
+ подсказку. Предел берётся у последней попытки с отказом
700
+ (`lastContextLimit`); отпечаток у обоих пределов один. Дальше задачу нужно разделить или сократить её контекст:
701
+ код остановки `CONTEXT_EXHAUSTED` (класс `refused`), `explain` — ведущий,
702
+ `diagnose-failure`. Корзина отчёта — `incomplete`; разбор свойства
703
+ (`property-recovery`) такой отказ не считает, кандидат после отказа reviewer
704
+ переиспользуется (`reusableFailures`). Причина `attempt.diagnosed` — `none`,
705
+ `counted: true`.
706
+
663
707
  ### RunEvent
664
708
 
665
709
  `{apiVersion, seq, at, type, graphId?, workId?, runId?, attempt?, payload}`.
@@ -816,7 +860,7 @@ data:`), светлая и тёмная схема по `prefers-color-scheme`,
816
860
  `WorkState.attempt` (сброс возвращает счётчик к 0).
817
861
  - Корзины отказа попытки (`failureBucketOf`): `defect` (`gate`, `review`,
818
862
  `scope-violation`), `incomplete` (`empty-result`, `unfinished`,
819
- `needs-lead`), `integration` (`stale-base`, `merge`), `environment`
863
+ `needs-lead`, `context-exhausted`), `integration` (`stale-base`, `merge`), `environment`
820
864
  (`environment`, `provider-auth`, `blocked`, истёкшее владение), `time-limit`
821
865
  (`timeout`), `tool` (`review-protocol`), `operator` (`cancelled`), `budget`,
822
866
  `unknown`, `unclassified` (попытка без класса — записана до
@@ -1102,7 +1146,9 @@ git хоста над checkout с чужим кодом (`hostGitArgs`, `assertT
1102
1146
  `binding`, его дополнительные границы — `boundary`), проверка
1103
1147
  переносимого результата (`resultProblems`), классы и правила отказов
1104
1148
  (`BlockedError`, `TaskFailure`, `classifyFailure`, `failureFingerprint`,
1105
- `repairPolicy`, `repairDecision`), раунд технического ревью
1149
+ `repairPolicy`, `repairRepeats` — повторы одного отпечатка с учётом предела
1150
+ окна контекста, `lastContextLimit` — предел последней попытки с отказом,
1151
+ `repairDecision`), раунд технического ревью
1106
1152
  (`technicalReview`), точка сбоя подтверждения корпуса для тестов
1107
1153
  (`caseHooks`). Глубокие импорты `lib/...` не поддерживаются.
1108
1154
 
@@ -1118,12 +1164,12 @@ subjects)`: `subjects.input(kind, id, view)` задаёт digest входа и
1118
1164
  `HarnessError {code, class, message, issues[{path, message}]}`; класс задаёт
1119
1165
  exit code CLI.
1120
1166
 
1121
- | Exit | Класс | Коды |
1122
- | ---- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1123
- | 0 | успех | — |
1124
- | 2 | `input` | `INVALID_INPUT`, `UNSUPPORTED_COMMAND`, `UNSUPPORTED_VERSION`, `GRAPH_*`, `GATE_*`, `REVIEWER_*`, `RESPONSE_TOO_LARGE` |
1125
- | 3 | `refused` | `APPROVAL_STALE`, `APPROVAL_REQUIRED`, `LEASE_STALE`, `CONTROLLER_BUSY`, `PAUSED`, `NOT_READY`, `SCOPE_VIOLATION`, `GATE_FAILED`, `REVIEW_REJECTED`, `BUDGET_EXHAUSTED`, `BUDGET_UNKNOWN`, `ATTEMPTS_EXHAUSTED`, `REVISION_CONFLICT`, `CANCELLED`, `NOT_FOUND`, `PATH_CONFLICT` |
1126
- | 4 | `infrastructure` | `STATE_VERSION_UNSUPPORTED`, `RUNTIME_UNAVAILABLE`, `REVIEW_PROTOCOL_INVALID`, `SANDBOX_UNAVAILABLE`, `GIT_FAILED`, `STORAGE_FAILED`, `DELIVERY_FAILED`, `INTERNAL` |
1167
+ | Exit | Класс | Коды |
1168
+ | ---- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1169
+ | 0 | успех | — |
1170
+ | 2 | `input` | `INVALID_INPUT`, `UNSUPPORTED_COMMAND`, `UNSUPPORTED_VERSION`, `GRAPH_*`, `GATE_*`, `REVIEWER_*`, `RESPONSE_TOO_LARGE` |
1171
+ | 3 | `refused` | `APPROVAL_STALE`, `APPROVAL_REQUIRED`, `LEASE_STALE`, `CONTROLLER_BUSY`, `PAUSED`, `NOT_READY`, `SCOPE_VIOLATION`, `GATE_FAILED`, `REVIEW_REJECTED`, `BUDGET_EXHAUSTED`, `BUDGET_UNKNOWN`, `ATTEMPTS_EXHAUSTED`, `CONTEXT_EXHAUSTED`, `REVISION_CONFLICT`, `CANCELLED`, `NOT_FOUND`, `PATH_CONFLICT` |
1172
+ | 4 | `infrastructure` | `STATE_VERSION_UNSUPPORTED`, `RUNTIME_UNAVAILABLE`, `REVIEW_PROTOCOL_INVALID`, `SANDBOX_UNAVAILABLE`, `GIT_FAILED`, `STORAGE_FAILED`, `DELIVERY_FAILED`, `INTERNAL` |
1127
1173
 
1128
1174
  Exit 1 не используется: им Node завершает процесс при необработанном
1129
1175
  исключении.
@@ -0,0 +1,27 @@
1
+ # devcontour-harness 0.1.0-alpha.35
2
+
3
+ Нехватка окна контекста claude — свой класс отказа `context-exhausted`
4
+ вместо `unknown`: короткая политика повторов, собственный код остановки и
5
+ понятная причина. `stateVersion` и `policyVersion` прежние.
6
+
7
+ ## Изменения
8
+
9
+ - **Класс отказа.** `context-exhausted` распознаётся по `terminal_reason`
10
+ результата claude. `prompt_too_long` на первом ходе (`num_turns` ≤ 1) —
11
+ `contextLimit: prompt-too-long`, без повтора: поручение не помещается в
12
+ окно, повтор того же входа бесполезен. `blocking_limit` или переполнение
13
+ после ходов работы — `blocking-limit`, один повтор. Попытка засчитывается.
14
+ - **Остановка.** Код `CONTEXT_EXHAUSTED` (класс `refused`, exit code 3) в
15
+ `stopReason`, `explain` и пакете передачи; в отчёте — корзина `incomplete`.
16
+ Сообщение стабильное; подсказка о сокращении поручения — только у writer.
17
+ - **API.** `repairRepeats` и `lastContextLimit` экспортированы рядом с
18
+ `repairPolicy`; порт runtime получил необязательное
19
+ `RuntimeResponse.diagnostics.contextExhausted`.
20
+
21
+ ## Обновление
22
+
23
+ Новые значения аддитивны, но документ состояния разбирается строго:
24
+ alpha.34 и ниже не читают состояние с отказом `context-exhausted`. Откат —
25
+ вместе с копией каталога состояния, снятой до обновления. Строгие внешние
26
+ валидаторы `RunResult`, отчёта, пакета передачи и диагноза остановки
27
+ обновляются вместе с harness. Подробнее — `docs/upgrade.md`.
package/docs/upgrade.md CHANGED
@@ -494,6 +494,41 @@ null` и этого правила засчитанных попыток: ист
494
494
  без записанного повтора (`recorded.gaps`, ограничение `recording-gap`); иной
495
495
  пробел не виден, и отчёт всегда называет это ограничением (`rollback-gap`).
496
496
 
497
+ ### alpha.35: нехватка окна контекста
498
+
499
+ Номера форматов прежние (`stateVersion: 1`, `policyVersion: 1`), новое —
500
+ аддитивно:
501
+
502
+ - **Состояние и журнал.** Класс отказа `context-exhausted` в `failureKind`
503
+ (попытка, поручение, `attempt.failed`, `attempt.diagnosed`, причина
504
+ `explain`, пакет передачи и отчёт — корзина `incomplete`) и необязательное
505
+ поле `AttemptState.contextLimit` (`prompt-too-long` | `blocking-limit`).
506
+ - **Коды.** `CONTEXT_EXHAUSTED` (класс `refused`, exit code 3) — код
507
+ остановки этого класса (`stopReason` результата, `explain`, пакет передачи;
508
+ в `cliCommands.run.refusals`).
509
+ - **Политика.** `repairPolicy['context-exhausted']`: один повтор у
510
+ `blocking-limit`, ни одного у `prompt-too-long` (`repairRepeats`); попытка
511
+ засчитывается. `prompt-too-long` — только `prompt_too_long` на первом ходе
512
+ (`num_turns` ≤ 1); тот же признак после ходов работы — `blocking-limit`.
513
+ - **API.** `repairRepeats` и `lastContextLimit` экспортированы рядом с
514
+ `repairPolicy`.
515
+ - **Порт runtime.** Необязательное поле
516
+ `RuntimeResponse.diagnostics.contextExhausted` (предел окна); адаптер без
517
+ него — прежняя классификация. В `runtime.json` вызова claude —
518
+ `terminalReason` и `compactions` (диагностика, не договор).
519
+
520
+ Прежде такой отказ claude получал класс `unknown` (у reviewer — `review`).
521
+ Читатель, проверявший строгой схемой прежней версии `ValueReport`, пакет
522
+ передачи (`handoff-pack`), диагноз остановки (`stop-diagnosis`) или
523
+ `RunResult`, отклонит новые значения `context-exhausted` и
524
+ `CONTEXT_EXHAUSTED`: обновить схему вместе с пакетом.
525
+
526
+ **Откат.** Документ состояния разбирается строго: alpha.34 и ниже отказывают
527
+ на документе с отказом `context-exhausted` или полем `contextLimit`. Путь —
528
+ строка «Новая версия уже изменила формат» таблицы [«Откат»](#откат):
529
+ остановить writers и восстановить копию каталога состояния, снятую до
530
+ обновления, вместе с прежней версией пакета.
531
+
497
532
  ## Перед обновлением
498
533
 
499
534
  1. **Остановить записывающих.** Запретить новые выдачи (`harness pause`),
@@ -1,5 +1,14 @@
1
1
  import type { z } from 'zod';
2
- import type { ProbeServer, RuntimeAdapter, toolProfileSchema } from '../contracts/index.ts';
2
+ import type { ContextLimit, ProbeServer, RuntimeAdapter, toolProfileSchema } from '../contracts/index.ts';
3
+ /**
4
+ * Предел окна контекста по итоговому событию claude. `prompt_too_long` на
5
+ * первом ходе (`num_turns` ≤ 1, записанный случай: подсказка сама больше
6
+ * окна) — `prompt-too-long`, повтор только удлинит подсказку. Тот же признак
7
+ * после ходов работы (окно заполнил вывод инструментов) и без `num_turns` —
8
+ * `blocking-limit`, как остановка CLI у предела окна: повтор может читать
9
+ * меньше.
10
+ */
11
+ export declare function claudeContextLimit(terminalReason: string | undefined, numTurns: number | undefined): ContextLimit | undefined;
3
12
  type ToolProfile = z.infer<typeof toolProfileSchema>;
4
13
  /**
5
14
  * Предел файла ответа codex: вдвое выше хвоста stdout, в котором приходит ответ
@@ -10,6 +10,21 @@ import { inspectReview } from "./inspect.js";
10
10
  import { probeCallMs, probeServer, probeTool } from "./review-probe.js";
11
11
  import { claudeResult, runtimeEvents } from "./runtime-events.js";
12
12
  import { runtimeVersion, unknownUsage, usageStream } from "./usage.js";
13
+ /**
14
+ * Предел окна контекста по итоговому событию claude. `prompt_too_long` на
15
+ * первом ходе (`num_turns` ≤ 1, записанный случай: подсказка сама больше
16
+ * окна) — `prompt-too-long`, повтор только удлинит подсказку. Тот же признак
17
+ * после ходов работы (окно заполнил вывод инструментов) и без `num_turns` —
18
+ * `blocking-limit`, как остановка CLI у предела окна: повтор может читать
19
+ * меньше.
20
+ */
21
+ export function claudeContextLimit(terminalReason, numTurns) {
22
+ if (terminalReason === 'blocking_limit')
23
+ return 'blocking-limit';
24
+ if (terminalReason !== 'prompt_too_long')
25
+ return undefined;
26
+ return numTurns !== undefined && numTurns <= 1 ? 'prompt-too-long' : 'blocking-limit';
27
+ }
13
28
  /**
14
29
  * Предел файла ответа codex: вдвое выше хвоста stdout, в котором приходит ответ
15
30
  * claude (2 000 000 символов). Ответ модели на порядки меньше, а разбор
@@ -328,9 +343,20 @@ export function cliAdapter(runtime, options = {}) {
328
343
  }
329
344
  const usage = telemetry.usage(result.code === 0 && !result.timedOut && !signal.aborted);
330
345
  const model = telemetry.model();
346
+ const terminalReason = telemetry.terminalReason();
347
+ const compactions = telemetry.compactions();
331
348
  // Сообщённые runtime счётчики и стоимость — и в диагностике вызова:
332
- // runtime.log ограничен и итоговой строки может не содержать.
333
- await writeFile(join(dir, 'runtime.json'), JSON.stringify({ ...result.diagnostics, usage }, null, 2));
349
+ // runtime.log ограничен и итоговой строки может не содержать. Там же
350
+ // исход хода claude и число сжатий контекста (успешное сжатие — не отказ).
351
+ await writeFile(join(dir, 'runtime.json'), JSON.stringify({
352
+ ...result.diagnostics,
353
+ usage,
354
+ ...(terminalReason ? { terminalReason } : {}),
355
+ ...(compactions ? { compactions } : {}),
356
+ }, null, 2));
357
+ // Нехватка окна контекста — по `terminal_reason` итогового события
358
+ // claude, а не по тексту причины (в нём числа токенов).
359
+ const contextExhausted = runtime === 'claude' ? claudeContextLimit(terminalReason, telemetry.numTurns()) : undefined;
334
360
  const bookkeeping = ['system', 'result', 'error', 'session.created', 'thread.started'];
335
361
  const started = result.timedOut ||
336
362
  runtimeEvents(result.stdout).events.some((e) => !bookkeeping.includes(String(e.type)));
@@ -359,6 +385,7 @@ export function cliAdapter(runtime, options = {}) {
359
385
  exitCode: result.code,
360
386
  ...(why ? { reason: why } : {}),
361
387
  log: logPath,
388
+ ...(contextExhausted ? { contextExhausted } : {}),
362
389
  });
363
390
  const expired = signal.aborted && signal.reason?.name === 'TimeoutError';
364
391
  if (result.timedOut || expired)
@@ -372,7 +399,8 @@ export function cliAdapter(runtime, options = {}) {
372
399
  if (result.code !== 0)
373
400
  return {
374
401
  ...base,
375
- status: started ? 'failed' : 'unavailable',
402
+ // Нехватка окна — ответ runtime о запросе, а не недоступный runtime.
403
+ status: started || contextExhausted ? 'failed' : 'unavailable',
376
404
  diagnostics: diagnostics(`код ${result.code}${reason() ? ': ' + reason() : ''}`),
377
405
  };
378
406
  let output;
@@ -383,14 +411,17 @@ export function cliAdapter(runtime, options = {}) {
383
411
  output = JSON.parse(cleaned);
384
412
  }
385
413
  else {
386
- const final = claudeResult.parse(runtimeEvents(result.stdout).events.findLast((e) => e.type === 'result'));
387
- if (final.is_error)
414
+ const last = runtimeEvents(result.stdout).events.findLast((e) => e.type === 'result');
415
+ // `is_error` проверяется до разбора: `claudeResult` требует поле
416
+ // `structured_output`, которого у такого `result` нет, и отказ
417
+ // runtime при коде 0 читался как непрочитанный ответ.
418
+ if (last?.is_error === true)
388
419
  return {
389
420
  ...base,
390
421
  status: 'failed',
391
- diagnostics: diagnostics(redact(final.result ?? 'ошибка runtime').slice(0, 300)),
422
+ diagnostics: diagnostics(redact(typeof last.result === 'string' ? last.result : 'ошибка runtime').slice(0, 300)),
392
423
  };
393
- output = final.structured_output;
424
+ output = claudeResult.parse(last).structured_output;
394
425
  }
395
426
  }
396
427
  catch (error) {
@@ -16,6 +16,9 @@ export declare const LINE_LIMIT = 8000000;
16
16
  * учитывалась неполной. Здесь каждая строка разбирается сразу; хранятся
17
17
  * только поля телеметрии — последнее событие `result`, события
18
18
  * `turn.completed` и первая сообщённая модель, — а не текст вывода.
19
+ * У claude также — `terminal_reason` и `num_turns` последнего `result` (по
20
+ * ним адаптер узнаёт нехватку окна контекста) и число автоматических и ручных сжатий
21
+ * контекста (`system`/`compact_boundary`): успешное сжатие не отказ.
19
22
  */
20
23
  export declare function usageStream(runtime: 'codex' | 'claude'): {
21
24
  /**
@@ -27,4 +30,10 @@ export declare function usageStream(runtime: 'codex' | 'claude'): {
27
30
  /** Телеметрия всего потока; `completed` — вызов завершился штатно. */
28
31
  usage(completed: boolean): Usage;
29
32
  model: () => string | null;
33
+ /** `terminal_reason` последнего `result` claude; нет — runtime не сообщил. */
34
+ terminalReason: () => string | undefined;
35
+ /** `num_turns` последнего `result` claude; нет — runtime не сообщил. */
36
+ numTurns: () => number | undefined;
37
+ /** Сколько раз runtime сжал контекст за вызов (`compact_boundary`). */
38
+ compactions: () => number;
30
39
  };
@@ -106,9 +106,12 @@ const flatUsage = (usage) => usage && typeof usage === 'object' && !Array.isArra
106
106
  * учитывалась неполной. Здесь каждая строка разбирается сразу; хранятся
107
107
  * только поля телеметрии — последнее событие `result`, события
108
108
  * `turn.completed` и первая сообщённая модель, — а не текст вывода.
109
+ * У claude также — `terminal_reason` и `num_turns` последнего `result` (по
110
+ * ним адаптер узнаёт нехватку окна контекста) и число автоматических и ручных сжатий
111
+ * контекста (`system`/`compact_boundary`): успешное сжатие не отказ.
109
112
  */
110
113
  export function usageStream(runtime) {
111
- let partial = '', overflow = false, malformed = false, model = null, result;
114
+ let partial = '', overflow = false, malformed = false, model = null, result, terminalReason, numTurns, compactions = 0;
112
115
  const turns = [];
113
116
  const line = (text) => {
114
117
  if (!text.trim())
@@ -127,6 +130,12 @@ export function usageStream(runtime) {
127
130
  }
128
131
  const e = event;
129
132
  model ??= eventModel(e);
133
+ if (runtime === 'claude' && e.type === 'system' && e.subtype === 'compact_boundary')
134
+ compactions++;
135
+ if (runtime === 'claude' && e.type === 'result')
136
+ terminalReason = typeof e.terminal_reason === 'string' ? e.terminal_reason : undefined;
137
+ if (runtime === 'claude' && e.type === 'result')
138
+ numTurns = typeof e.num_turns === 'number' ? e.num_turns : undefined;
130
139
  if (runtime === 'claude' && e.type === 'result')
131
140
  result = JSON.stringify({
132
141
  type: e.type,
@@ -185,5 +194,17 @@ export function usageStream(runtime) {
185
194
  return parseUsage(runtime, [...turns, ...(result ? [result] : [])].join('\n'), completed && !malformed);
186
195
  },
187
196
  model: () => model,
197
+ /** `terminal_reason` последнего `result` claude; нет — runtime не сообщил. */
198
+ terminalReason: () => {
199
+ flush();
200
+ return terminalReason;
201
+ },
202
+ /** `num_turns` последнего `result` claude; нет — runtime не сообщил. */
203
+ numTurns: () => {
204
+ flush();
205
+ return numTurns;
206
+ },
207
+ /** Сколько раз runtime сжал контекст за вызов (`compact_boundary`). */
208
+ compactions: () => compactions,
188
209
  };
189
210
  }