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.
- package/README.md +8 -2
- package/docs/contracts.md +54 -8
- package/docs/release-notes/0.1.0-alpha.35.md +27 -0
- package/docs/upgrade.md +35 -0
- package/lib/agents/cli-adapter.d.ts +10 -1
- package/lib/agents/cli-adapter.js +38 -7
- package/lib/agents/usage.d.ts +9 -0
- package/lib/agents/usage.js +22 -1
- package/lib/contracts/cli.d.ts +49 -1
- package/lib/contracts/cli.js +1 -0
- package/lib/contracts/diagnosis.d.ts +3 -1
- package/lib/contracts/diagnosis.js +1 -0
- package/lib/contracts/errors.d.ts +3 -1
- package/lib/contracts/errors.js +2 -0
- package/lib/contracts/events.d.ts +15 -0
- package/lib/contracts/execution.d.ts +32 -1
- package/lib/contracts/execution.js +19 -0
- package/lib/contracts/failure.d.ts +7 -3
- package/lib/contracts/failure.js +6 -2
- package/lib/contracts/handoff.d.ts +9 -0
- package/lib/contracts/planning.d.ts +2 -0
- package/lib/contracts/ports.d.ts +10 -2
- package/lib/contracts/published.d.ts +28 -0
- package/lib/contracts/repair-policy.d.ts +10 -1
- package/lib/contracts/repair-policy.js +18 -0
- package/lib/contracts/report.d.ts +2 -0
- package/lib/contracts/result.d.ts +2 -0
- package/lib/control/harness.d.ts +10 -10
- package/lib/control/recovery.d.ts +1 -1
- package/lib/control/status.d.ts +8 -8
- package/lib/engine/classify.js +1 -1
- package/lib/engine/engine.d.ts +9 -7
- package/lib/engine/engine.js +3 -0
- package/lib/engine/failure.d.ts +1 -1
- package/lib/engine/failure.js +1 -1
- package/lib/engine/prompt.js +11 -1
- package/lib/engine/property-recovery.js +2 -0
- package/lib/engine/repair.js +4 -2
- package/lib/engine/reuse.js +2 -0
- package/lib/engine/runner.js +9 -0
- package/lib/explain/state.d.ts +1 -1
- package/lib/explain/state.js +10 -4
- package/lib/index.d.ts +1 -1
- package/lib/index.js +1 -1
- package/lib/projections/stop.d.ts +3 -1
- package/lib/projections/stop.js +30 -2
- package/lib/report/compute.js +1 -0
- package/lib/report/document.js +1 -1
- package/lib/storage/document.d.ts +8 -6
- package/package.json +1 -1
- package/schemas/execution-document.schema.json +11 -0
- package/schemas/handoff-pack.schema.json +9 -0
- package/schemas/result-envelope.schema.json +1 -0
- package/schemas/run-event.schema.json +3 -0
- package/schemas/run-result.schema.json +1 -0
- package/schemas/stop-diagnosis.schema.json +2 -0
- 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.
|
|
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.
|
|
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`, `
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
387
|
-
|
|
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(
|
|
422
|
+
diagnostics: diagnostics(redact(typeof last.result === 'string' ? last.result : 'ошибка runtime').slice(0, 300)),
|
|
392
423
|
};
|
|
393
|
-
output =
|
|
424
|
+
output = claudeResult.parse(last).structured_output;
|
|
394
425
|
}
|
|
395
426
|
}
|
|
396
427
|
catch (error) {
|
package/lib/agents/usage.d.ts
CHANGED
|
@@ -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
|
};
|
package/lib/agents/usage.js
CHANGED
|
@@ -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
|
}
|