devcontour-harness 0.1.0-alpha.31 → 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 (84) hide show
  1. package/README.md +28 -3
  2. package/docs/architecture.md +12 -0
  3. package/docs/compatibility.md +21 -18
  4. package/docs/contracts.md +189 -21
  5. package/docs/release-notes/0.1.0-alpha.32.md +33 -0
  6. package/docs/release-notes/0.1.0-alpha.33.md +29 -0
  7. package/docs/release-notes/0.1.0-alpha.34.md +32 -0
  8. package/docs/release-notes/0.1.0-alpha.35.md +27 -0
  9. package/docs/upgrade.md +172 -0
  10. package/lib/agents/cli-adapter.d.ts +10 -1
  11. package/lib/agents/cli-adapter.js +38 -7
  12. package/lib/agents/usage.d.ts +9 -0
  13. package/lib/agents/usage.js +22 -1
  14. package/lib/cli.js +2 -2
  15. package/lib/contracts/cli.d.ts +344 -6
  16. package/lib/contracts/cli.js +1 -0
  17. package/lib/contracts/diagnosis.d.ts +3 -1
  18. package/lib/contracts/diagnosis.js +1 -0
  19. package/lib/contracts/errors.d.ts +3 -1
  20. package/lib/contracts/errors.js +2 -0
  21. package/lib/contracts/events.d.ts +365 -4
  22. package/lib/contracts/events.js +63 -2
  23. package/lib/contracts/execution.d.ts +32 -1
  24. package/lib/contracts/execution.js +19 -0
  25. package/lib/contracts/failure.d.ts +12 -3
  26. package/lib/contracts/failure.js +10 -2
  27. package/lib/contracts/handoff.d.ts +17 -0
  28. package/lib/contracts/handoff.js +17 -3
  29. package/lib/contracts/planning.d.ts +2 -0
  30. package/lib/contracts/ports.d.ts +10 -2
  31. package/lib/contracts/published.d.ts +205 -3
  32. package/lib/contracts/repair-policy.d.ts +10 -1
  33. package/lib/contracts/repair-policy.js +18 -0
  34. package/lib/contracts/report.d.ts +118 -2
  35. package/lib/contracts/report.js +61 -3
  36. package/lib/contracts/result.d.ts +2 -0
  37. package/lib/control/base-move.d.ts +7 -2
  38. package/lib/control/base-move.js +14 -1
  39. package/lib/control/harness.d.ts +54 -18
  40. package/lib/control/harness.js +8 -96
  41. package/lib/control/recovery.d.ts +1 -1
  42. package/lib/control/status.d.ts +235 -0
  43. package/lib/control/status.js +101 -0
  44. package/lib/engine/budget.d.ts +78 -0
  45. package/lib/engine/budget.js +13 -2
  46. package/lib/engine/classify.d.ts +14 -1
  47. package/lib/engine/classify.js +34 -0
  48. package/lib/engine/engine.d.ts +25 -11
  49. package/lib/engine/engine.js +78 -5
  50. package/lib/engine/failure.d.ts +1 -1
  51. package/lib/engine/failure.js +1 -1
  52. package/lib/engine/prompt.js +11 -1
  53. package/lib/engine/property-recovery.js +2 -0
  54. package/lib/engine/repair.js +4 -2
  55. package/lib/engine/reuse.js +2 -0
  56. package/lib/engine/runner.js +13 -5
  57. package/lib/environment/isolation.d.ts +67 -3
  58. package/lib/environment/isolation.js +148 -5
  59. package/lib/environment/lifecycle.js +1 -1
  60. package/lib/explain/state.d.ts +26 -5
  61. package/lib/explain/state.js +39 -4
  62. package/lib/handoff/index.d.ts +1 -1
  63. package/lib/handoff/markdown.js +4 -2
  64. package/lib/handoff/pack.d.ts +38 -8
  65. package/lib/handoff/pack.js +57 -18
  66. package/lib/index.d.ts +19 -4
  67. package/lib/index.js +19 -3
  68. package/lib/integrations/connector/testing.js +1 -1
  69. package/lib/projections/next.d.ts +3 -1
  70. package/lib/projections/next.js +4 -1
  71. package/lib/projections/stop.d.ts +14 -1
  72. package/lib/projections/stop.js +68 -11
  73. package/lib/report/compute.js +229 -21
  74. package/lib/report/document.js +32 -8
  75. package/lib/storage/document.d.ts +8 -6
  76. package/lib/verification/gates.js +20 -4
  77. package/package.json +1 -1
  78. package/schemas/execution-document.schema.json +11 -0
  79. package/schemas/handoff-pack.schema.json +15 -0
  80. package/schemas/result-envelope.schema.json +1 -0
  81. package/schemas/run-event.schema.json +322 -0
  82. package/schemas/run-result.schema.json +1 -0
  83. package/schemas/stop-diagnosis.schema.json +2 -0
  84. package/schemas/value-report.schema.json +236 -3
@@ -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
@@ -357,6 +357,178 @@ install|fetch` или `yarn install`;
357
357
  **Откат.** Ниже этой версии команды `handoff` нет; состояние она не меняла,
358
358
  поэтому откат пакета копии не требует.
359
359
 
360
+ ### alpha.32: пакет передачи контекста для хоста
361
+
362
+ Только чтение и только аддитивно: формат состояния, политики, событий и
363
+ `HandoffPack` (`handoffVersion: 1`, `schemas/handoff-pack.schema.json`) не
364
+ меняется. Новое в корне пакета:
365
+
366
+ - `handoffPack(source, options)` принимает `HandoffSource`
367
+ (`{ engine, policy, workflows: { list, continues } }`) — `Harness` ему
368
+ удовлетворяет, прежние вызовы не меняются; хосту со своим `Engine` больше
369
+ не нужен экземпляр `Harness`. `statusOf(source, graphId?, { detail })` —
370
+ состояние доски над движком и политикой (`Harness.status` вызывает её же),
371
+ типы `HandoffSource`, `StatusSource`, `StopSource` (`stopInputsOf`
372
+ принимает тот же источник).
373
+ - Параметры `maxBytes` (от `HANDOFF_MIN_BYTES` = 4096 до `HANDOFF_MAX_BYTES`)
374
+ и `measure` (`json` | `markdown`) — тот же порядок отбрасывания под
375
+ меньший предел ответа хоста.
376
+ - `policySecrets(policy, env?)` экспортирован: маску хоста можно составить
377
+ из секретов политики тем же обходом (`composeRedactors`).
378
+
379
+ Строка Markdown об урезании теперь «Пакет урезан по пределу размера» без
380
+ числа: предел задаёт вызывающий.
381
+
382
+ **Откат.** Состояние не меняется, копия не нужна. Хост, вызвавший
383
+ `handoffPack` с узким источником, `maxBytes` или `measure`, либо
384
+ импортировавший `statusOf`, `policySecrets` или `HANDOFF_MIN_BYTES`, при
385
+ откате возвращается к прежнему коду (экземпляр `Harness`, свой обход
386
+ секретов и своя подгонка размера).
387
+
388
+ ### alpha.32: запись файла отчёта для хоста
389
+
390
+ Только аддитивно: форматы не меняются. Из корня пакета экспортированы
391
+ `writeReportFile(out, stateDir, text)`, `REPORT_FILE_MODE` и тип
392
+ `ReportFileIo` — та же запись, что у `harness report --out`. В
393
+ `devcontour-harness/report` её нет: модуль остаётся без `node:*`.
394
+
395
+ **Откат.** Состояние не меняется. Хост, импортировавший `writeReportFile`,
396
+ при откате возвращается к своей копии записи.
397
+
398
+ ### alpha.32: песочница при глубоком TMPDIR
399
+
400
+ Форматы не меняются. Раньше при глубоком TMPDIR процесса controller путь
401
+ unix-сокета sandbox-runtime превышал предел (104 байта на macOS, 108 на
402
+ Linux), srt падал до запуска команды (`listen EINVAL`), и проверка не
403
+ стартовала. Теперь srt в этом случае получает короткий каталог
404
+ `/tmp/dc-srt-<pid>-*` (`0700`, удаляется после проверки; брошенные упавшим controller каталоги, где ничего не менялось дольше суток и процесса создателя нет, убираются при создании нового). Если и он недоступен —
405
+ отказ среды (`environment`) с TMPDIR в тексте.
406
+
407
+ **Откат.** Состояние не меняется. На прежней версии при глубоком TMPDIR
408
+ проверки в песочнице снова не стартуют: задайте короткий TMPDIR.
409
+
410
+ ### alpha.33: отменённые без ждущих и расход ревью плана в пакете передачи
411
+
412
+ Форматы состояния, политики и событий прежние; `handoffVersion` — 1.
413
+
414
+ - Отменённая работа (и упавшая с классом `cancelled`) — решение ведущего
415
+ (`CANCELLED`, `replan-dependents`), только пока от неё прямо зависит
416
+ незавершённая работа (не `done` и не `cancelled`); сообщение называет
417
+ ждущих. Отменённая без таких работ в общий `explain` и в `stops`/`next`
418
+ пакета передачи не входит (как принятая); `explain --work` этой работы
419
+ показывает её с `action: none`. Упавшая отменой без ждущих — решение
420
+ человека (user `user-decision`: `harness retry` или отмена), а не повтор:
421
+ `nextAction` для неё — `user-decision` на шаге `cancelled`. Диагноз упавшей
422
+ работы, чью группу движок не восстанавливает из-за отмены, называет
423
+ отменённую.
424
+ Раньше доска, где все зависимые отменённых тоже отменены или приняты,
425
+ начиналась с решения «перепланировать», которое нечего было делать.
426
+ - Вызов о группе (ревью и проверка плана) по-прежнему засчитывается целиком
427
+ бюджету каждого её открытого поручения — так действует ограничение
428
+ поручения; в строках группы и `total` он учтён один раз, суммы не
429
+ завышены. Пакет передачи больше не перечисляет бюджеты поручений, весь
430
+ расход которых — такие вызовы, кроме тех, что держат выдачу (превышены
431
+ или не определены при `onUnknown: stop`): их число — новое поле
432
+ `truncated.budgetsShared` (в схеме необязательное, по умолчанию 0: пакеты
433
+ прежних версий разбираются). `handoffVersion` остаётся 1, поэтому внешний
434
+ валидатор со строгой прежней схемой пакета
435
+ (`schemas/handoff-pack.schema.json`) обновляется вместе с harness: прежняя
436
+ схема новое поле отклонит. `status` бюджеты поручений показывает как
437
+ прежде.
438
+
439
+ **Откат.** Состояние не меняется; прежняя версия снова показывает такие
440
+ отменённые как решение и повторяет строку бюджета у каждого поручения.
441
+
442
+ ### alpha.34: события вмешательств и причин отказа
443
+
444
+ Формат состояния (`stateVersion: 1`), политики и её digest прежние: в документ
445
+ состояния не добавлено ни одного поля. Новое в журнале (`docs/contracts.md`,
446
+ `RunEvent`):
447
+
448
+ - `work.retried {by, reset, spent?, reasonLength?}` — повтор поручения.
449
+ `engine.retry(workId, reset?, by?)` принимает актёра: CLI `retry` —
450
+ `operator`, восстановление очереди — `recovery`, по умолчанию `host`.
451
+ Текста причины сброса в событии нет, только длина.
452
+ - `work.cancelled {by, hadAttempt}` — отмена поручения, в том числе без
453
+ активной попытки и новой редакцией графа (`by: graph`).
454
+ `engine.cancel(workId, reason?, by?)`; CLI `cancel` — `operator`.
455
+ - `base.moved {by}` — сдвиг ref базы `fencedRefMove(store, fence, timeoutMs?,
456
+ by?)`, `by` — `operator`, `controller` или `host` (по умолчанию). Хост,
457
+ сдвигающий базу перемоткой очереди, передаёт `controller`, ручной перенос —
458
+ `operator`. Транзакция `base.moved` теперь пишет событие: адаптер хоста,
459
+ выполнявший её без событий, должен записать его так же, как другие
460
+ нейтральные события без изменения документа.
461
+ - `attempt.diagnosed {failureKind, cause, counted}` — причина отказа попытки
462
+ рядом с `attempt.failed` и `attempt.expired`. Хост, вызывающий
463
+ `engine.fail` сам, может передать `options.cause`; `TaskFailure` принимает
464
+ причину четвёртым аргументом (`diagnosis`).
465
+
466
+ Отчёт (`ValueReport`, `reportVersion: 1`): `autonomy.actions.recorded`
467
+ (актёры вмешательств по событиям или `null`), суммы `retries`/`resets` по
468
+ событиям — только точные (иначе `null`), `baseMoves` — всегда `null` (сдвиг
469
+ вне `fencedRefMove` не пишется, число по актёрам — нижняя граница),
470
+ `withAction`/`withoutAction` с записью — точные или нижняя граница
471
+ (удержанные поручения — неизвестны); `environment.causes` — подпричины или
472
+ `null`; предел `limitations` — 40. Засчитанные попытки (первая попытка,
473
+ попыток на принятое) считаются по правилу движка: зависание (`stalled`)
474
+ теперь засчитано. Без новых событий отчёт прежний, кроме поля `recorded:
475
+ null` и этого правила засчитанных попыток: история с зависаниями даёт
476
+ другие числа первой попытки и попыток на принятое. Читатель, проверявший отчёт
477
+ строгой схемой прежней версии, отклонит новое поле и непустые `causes`:
478
+ обновить схему вместе с пакетом.
479
+
480
+ **Откат.** Версии с терпимым чтением событий (alpha.30 – alpha.33) читают
481
+ новые события как `{type: 'unknown', original}` без нагрузки: очередь,
482
+ `status`, `result`, `events` и `report` работают, а отчёт снова показывает
483
+ вмешательства как «не записано». Ниже alpha.30 `harness events` и чтение
484
+ журнала хостом отказывают на первой странице с новым событием — путь тот же,
485
+ что для `attempt.stage` (alpha.30): восстановить копию каталога состояния,
486
+ снятую до обновления. Удалять или переписывать события ради отката нельзя.
487
+ Хост, передававший `by` в `retry`, `cancel` или `fencedRefMove`, при откате
488
+ убирает аргумент (прежние версии его игнорируют только в JavaScript без
489
+ проверки типов).
490
+
491
+ Откат с последующим повторным обновлением оставляет пробел записи: повторы,
492
+ отмены и сдвиги базы, сделанные прежней версией, событий не имеют. Отчёт
493
+ находит пробел, только если он оставил новую попытку после отказа или отмены
494
+ без записанного повтора (`recorded.gaps`, ограничение `recording-gap`); иной
495
+ пробел не виден, и отчёт всегда называет это ограничением (`rollback-gap`).
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
+
360
532
  ## Перед обновлением
361
533
 
362
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
  }
package/lib/cli.js CHANGED
@@ -477,8 +477,8 @@ async function run(argv) {
477
477
  data: await h.deliver(need('work'), sinkOf(need('sink'), h, b.baseDir)),
478
478
  };
479
479
  const result = command === 'cancel'
480
- ? h.engine.cancel(need('work'), v.reason)
481
- : h.engine.retry(need('work'), v.reset ? { reason: need('reason') } : undefined);
480
+ ? h.engine.cancel(need('work'), v.reason, 'operator')
481
+ : h.engine.retry(need('work'), v.reset ? { reason: need('reason') } : undefined, 'operator');
482
482
  return {
483
483
  command,
484
484
  data: {