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
@@ -7,6 +7,35 @@ const sha = gitShaSchema;
7
7
  const text = z.string().max(4000);
8
8
  const runtime = runtimeNameSchema;
9
9
  const phase = z.enum(['candidate', 'integration']);
10
+ /**
11
+ * Причина отказа окружения (`attempt.diagnosed`): ставится в точке
12
+ * обнаружения (песочница gate, сеть установки зависимостей, провайдер,
13
+ * транспорт), а не разбором текста потом. `none` — отказ не окружения
14
+ * (код, ревью, область); `other` — отказ окружения без известной причины.
15
+ */
16
+ export const environmentCauses = [
17
+ 'sandbox-launch',
18
+ 'sandbox-network',
19
+ 'sandbox-filesystem',
20
+ 'sandbox-policy',
21
+ 'dependency-network',
22
+ 'provider-auth',
23
+ 'provider-limit',
24
+ 'transport',
25
+ 'preflight',
26
+ 'lease-expired',
27
+ 'stalled',
28
+ 'shutdown',
29
+ 'other',
30
+ 'none',
31
+ ];
32
+ export const environmentCauseSchema = z.enum(environmentCauses);
33
+ /** Кто повторил поручение (`work.retried`): `host` — хост не назвал актёра. */
34
+ export const retryActors = ['operator', 'recovery', 'host'];
35
+ /** Кто отменил поручение (`work.cancelled`): `graph` — новая редакция графа его убрала. */
36
+ export const cancelActors = ['operator', 'host', 'graph'];
37
+ /** Кто сдвинул ref базы (`base.moved`): `host` — хост не назвал актёра. */
38
+ export const baseMoveActors = ['operator', 'controller', 'host'];
10
39
  /** Предел имени стадии в событии `attempt.stage`. */
11
40
  export const STAGE_NAME_LIMIT = 300;
12
41
  const delivery = {
@@ -129,6 +158,16 @@ export const eventPayloads = {
129
158
  message: text,
130
159
  blocked: z.boolean(),
131
160
  }),
161
+ /**
162
+ * Причина отказа попытки: пишется в той же транзакции, что `attempt.failed`
163
+ * (и `attempt.expired`, причина `lease-expired`). `counted` — отказ
164
+ * засчитан в предел попыток поручения. Текста отказа здесь нет.
165
+ */
166
+ 'attempt.diagnosed': z.strictObject({
167
+ failureKind: failureKindSchema,
168
+ cause: environmentCauseSchema,
169
+ counted: z.boolean(),
170
+ }),
132
171
  'attempt.expired': z.strictObject({ leaseUntil: z.number().int().min(0) }),
133
172
  'attempt.cancelled': z.strictObject({ reason: text }),
134
173
  'attempt.recovered': z.strictObject({
@@ -137,6 +176,23 @@ export const eventPayloads = {
137
176
  reason: text.optional(),
138
177
  }),
139
178
  'work.accepted': z.strictObject({ resultSha: sha, integrationSha: sha }),
179
+ /**
180
+ * Поручение возвращено в очередь повтором (`engine.retry`). `reset` —
181
+ * сброс исчерпанного предела; `spent` — засчитанных попыток до сброса
182
+ * (сброс обнуляет счётчик). Причины сброса нет: только её длина.
183
+ */
184
+ 'work.retried': z.strictObject({
185
+ by: z.enum(retryActors),
186
+ reset: z.boolean(),
187
+ spent: z.number().int().min(0).optional(),
188
+ reasonLength: z.number().int().min(0).optional(),
189
+ }),
190
+ /**
191
+ * Поручение отменено (`engine.cancel` или новая редакция графа).
192
+ * `hadAttempt` — отменена и активная попытка (её `attempt.cancelled` — в
193
+ * той же транзакции).
194
+ */
195
+ 'work.cancelled': z.strictObject({ by: z.enum(cancelActors), hadAttempt: z.boolean() }),
140
196
  'work.blocked': z.strictObject({ code: z.string().min(1).max(60), message: text }),
141
197
  'control.paused': z.strictObject({
142
198
  reason: z.enum(['operator', 'shutdown', 'runtime', 'base-check', 'reconfigure']),
@@ -146,6 +202,11 @@ export const eventPayloads = {
146
202
  reason: z.enum(['operator', 'shutdown', 'runtime', 'base-check', 'reconfigure']),
147
203
  }),
148
204
  'controller.acquired': z.strictObject({ owner: z.string().min(1).max(300) }),
205
+ /**
206
+ * Ref базы сдвинут (`fencedRefMove`) — в той же транзакции, что проверка
207
+ * владения и `git update-ref`. Одно событие на репозиторий.
208
+ */
209
+ 'base.moved': z.strictObject({ by: z.enum(baseMoveActors) }),
149
210
  'controller.released': z.strictObject({ owner: z.string().min(1).max(300) }),
150
211
  'budget.blocked': z.strictObject({
151
212
  scope: z.enum(['work', 'group', 'total']),
@@ -333,8 +394,8 @@ export const transactionKinds = [
333
394
  'workspace.failed',
334
395
  'workspace.liveness',
335
396
  /**
336
- * Сдвиг ref базы операцией внутри транзакции проверки её владения: только
337
- * проверка и синхронный `git update-ref`, записей и событий нет.
397
+ * Сдвиг ref базы внутри транзакции проверки владения: проверка, синхронный
398
+ * `git update-ref` и событие `base.moved`; записей нет.
338
399
  */
339
400
  'base.moved',
340
401
  /** Только локальные записи технической очереди (`workflow-jobs`); событий журнала нет. */
@@ -24,7 +24,7 @@ export declare const workStatusSchema: z.ZodEnum<{
24
24
  done: "done";
25
25
  }>;
26
26
  export type WorkStatus = (typeof workStatuses)[number];
27
- export declare const failureKinds: readonly ["provider-auth", "environment", "timeout", "stalled", "stale-base", "empty-result", "unfinished", "scope-violation", "gate", "review", "review-protocol", "merge", "cancelled", "budget", "needs-lead", "unknown"];
27
+ export declare const failureKinds: readonly ["provider-auth", "environment", "timeout", "stalled", "context-exhausted", "stale-base", "empty-result", "unfinished", "scope-violation", "gate", "review", "review-protocol", "merge", "cancelled", "budget", "needs-lead", "unknown"];
28
28
  export declare const failureKindSchema: z.ZodEnum<{
29
29
  gate: "gate";
30
30
  unknown: "unknown";
@@ -34,6 +34,7 @@ export declare const failureKindSchema: z.ZodEnum<{
34
34
  timeout: "timeout";
35
35
  "provider-auth": "provider-auth";
36
36
  stalled: "stalled";
37
+ "context-exhausted": "context-exhausted";
37
38
  "stale-base": "stale-base";
38
39
  "empty-result": "empty-result";
39
40
  unfinished: "unfinished";
@@ -44,6 +45,19 @@ export declare const failureKindSchema: z.ZodEnum<{
44
45
  "needs-lead": "needs-lead";
45
46
  }>;
46
47
  export type FailureKind = (typeof failureKinds)[number];
48
+ /**
49
+ * Какой предел окна контекста сообщил runtime у отказа `context-exhausted`:
50
+ * `prompt-too-long` — запрос отклонён (claude `terminal_reason:
51
+ * prompt_too_long`, уже одна реплика больше окна; повтор только удлинит
52
+ * подсказку), `blocking-limit` — ход остановлен у предела окна (claude
53
+ * `blocking_limit`).
54
+ */
55
+ export declare const contextLimits: readonly ["prompt-too-long", "blocking-limit"];
56
+ export declare const contextLimitSchema: z.ZodEnum<{
57
+ "prompt-too-long": "prompt-too-long";
58
+ "blocking-limit": "blocking-limit";
59
+ }>;
60
+ export type ContextLimit = (typeof contextLimits)[number];
47
61
  /**
48
62
  * Живость исполняющейся попытки по периодическому обходу controller
49
63
  * (`stallSweep` политики): `active` — движение было недавно, `quiet` — нет
@@ -658,6 +672,7 @@ export declare const continuationSchema: z.ZodObject<{
658
672
  timeout: "timeout";
659
673
  "provider-auth": "provider-auth";
660
674
  stalled: "stalled";
675
+ "context-exhausted": "context-exhausted";
661
676
  "stale-base": "stale-base";
662
677
  "empty-result": "empty-result";
663
678
  unfinished: "unfinished";
@@ -744,6 +759,7 @@ export declare const attemptStateSchema: z.ZodObject<{
744
759
  timeout: "timeout";
745
760
  "provider-auth": "provider-auth";
746
761
  stalled: "stalled";
762
+ "context-exhausted": "context-exhausted";
747
763
  "stale-base": "stale-base";
748
764
  "empty-result": "empty-result";
749
765
  unfinished: "unfinished";
@@ -753,6 +769,10 @@ export declare const attemptStateSchema: z.ZodObject<{
753
769
  budget: "budget";
754
770
  "needs-lead": "needs-lead";
755
771
  }>>;
772
+ contextLimit: z.ZodOptional<z.ZodEnum<{
773
+ "prompt-too-long": "prompt-too-long";
774
+ "blocking-limit": "blocking-limit";
775
+ }>>;
756
776
  failureFingerprint: z.ZodOptional<z.ZodString>;
757
777
  requiredGates: z.ZodOptional<z.ZodArray<z.ZodString>>;
758
778
  consumers: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -857,6 +877,7 @@ export declare const attemptStateSchema: z.ZodObject<{
857
877
  timeout: "timeout";
858
878
  "provider-auth": "provider-auth";
859
879
  stalled: "stalled";
880
+ "context-exhausted": "context-exhausted";
860
881
  "stale-base": "stale-base";
861
882
  "empty-result": "empty-result";
862
883
  unfinished: "unfinished";
@@ -1347,6 +1368,7 @@ export declare const workStateSchema: z.ZodObject<{
1347
1368
  timeout: "timeout";
1348
1369
  "provider-auth": "provider-auth";
1349
1370
  stalled: "stalled";
1371
+ "context-exhausted": "context-exhausted";
1350
1372
  "stale-base": "stale-base";
1351
1373
  "empty-result": "empty-result";
1352
1374
  unfinished: "unfinished";
@@ -1624,6 +1646,7 @@ export declare const controlStateSchema: z.ZodObject<{
1624
1646
  timeout: "timeout";
1625
1647
  "provider-auth": "provider-auth";
1626
1648
  stalled: "stalled";
1649
+ "context-exhausted": "context-exhausted";
1627
1650
  "stale-base": "stale-base";
1628
1651
  "empty-result": "empty-result";
1629
1652
  unfinished: "unfinished";
@@ -2968,6 +2991,7 @@ export declare const executionDocumentSchema: z.ZodObject<{
2968
2991
  timeout: "timeout";
2969
2992
  "provider-auth": "provider-auth";
2970
2993
  stalled: "stalled";
2994
+ "context-exhausted": "context-exhausted";
2971
2995
  "stale-base": "stale-base";
2972
2996
  "empty-result": "empty-result";
2973
2997
  unfinished: "unfinished";
@@ -3185,6 +3209,7 @@ export declare const executionDocumentSchema: z.ZodObject<{
3185
3209
  timeout: "timeout";
3186
3210
  "provider-auth": "provider-auth";
3187
3211
  stalled: "stalled";
3212
+ "context-exhausted": "context-exhausted";
3188
3213
  "stale-base": "stale-base";
3189
3214
  "empty-result": "empty-result";
3190
3215
  unfinished: "unfinished";
@@ -3194,6 +3219,10 @@ export declare const executionDocumentSchema: z.ZodObject<{
3194
3219
  budget: "budget";
3195
3220
  "needs-lead": "needs-lead";
3196
3221
  }>>;
3222
+ contextLimit: z.ZodOptional<z.ZodEnum<{
3223
+ "prompt-too-long": "prompt-too-long";
3224
+ "blocking-limit": "blocking-limit";
3225
+ }>>;
3197
3226
  failureFingerprint: z.ZodOptional<z.ZodString>;
3198
3227
  requiredGates: z.ZodOptional<z.ZodArray<z.ZodString>>;
3199
3228
  consumers: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -3298,6 +3327,7 @@ export declare const executionDocumentSchema: z.ZodObject<{
3298
3327
  timeout: "timeout";
3299
3328
  "provider-auth": "provider-auth";
3300
3329
  stalled: "stalled";
3330
+ "context-exhausted": "context-exhausted";
3301
3331
  "stale-base": "stale-base";
3302
3332
  "empty-result": "empty-result";
3303
3333
  unfinished: "unfinished";
@@ -3866,6 +3896,7 @@ export declare const executionDocumentSchema: z.ZodObject<{
3866
3896
  timeout: "timeout";
3867
3897
  "provider-auth": "provider-auth";
3868
3898
  stalled: "stalled";
3899
+ "context-exhausted": "context-exhausted";
3869
3900
  "stale-base": "stale-base";
3870
3901
  "empty-result": "empty-result";
3871
3902
  unfinished: "unfinished";
@@ -40,6 +40,14 @@ export const failureKinds = [
40
40
  * controller остановил его. Действие — повтор или правка среды, не кода.
41
41
  */
42
42
  'stalled',
43
+ /**
44
+ * Исполнителю не хватило окна контекста модели внутри попытки: runtime
45
+ * сам сообщил, что запрос больше окна (claude: `terminal_reason`
46
+ * `prompt_too_long` или `blocking_limit`). Успешное автоматическое сжатие
47
+ * контекста отказом не является. Попытка засчитывается: задача не
48
+ * помещается в попытку — её нужно разделить или сократить контекст.
49
+ */
50
+ 'context-exhausted',
43
51
  'stale-base',
44
52
  'empty-result',
45
53
  /** Исполнитель сообщил `completed: false`: работа не доделана, черновик сохранён. */
@@ -60,6 +68,15 @@ export const failureKinds = [
60
68
  'unknown',
61
69
  ];
62
70
  export const failureKindSchema = z.enum(failureKinds);
71
+ /**
72
+ * Какой предел окна контекста сообщил runtime у отказа `context-exhausted`:
73
+ * `prompt-too-long` — запрос отклонён (claude `terminal_reason:
74
+ * prompt_too_long`, уже одна реплика больше окна; повтор только удлинит
75
+ * подсказку), `blocking-limit` — ход остановлен у предела окна (claude
76
+ * `blocking_limit`).
77
+ */
78
+ export const contextLimits = ['prompt-too-long', 'blocking-limit'];
79
+ export const contextLimitSchema = z.enum(contextLimits);
63
80
  /**
64
81
  * Живость исполняющейся попытки по периодическому обходу controller
65
82
  * (`stallSweep` политики): `active` — движение было недавно, `quiet` — нет
@@ -428,6 +445,8 @@ export const attemptStateSchema = z.strictObject({
428
445
  /** Отказ окружения: исполнителю не дали работать, попытка не засчитана. */
429
446
  blocked: z.boolean().optional(),
430
447
  failureKind: failureKindSchema.optional(),
448
+ /** Предел окна контекста — только у отказа `context-exhausted`. */
449
+ contextLimit: contextLimitSchema.optional(),
431
450
  failureFingerprint: z.string().optional(),
432
451
  /** Gates, которые попытка обязана пройти в обеих фазах (раскрытая область). */
433
452
  requiredGates: z.array(idSchema).optional(),
@@ -1,4 +1,5 @@
1
- import type { FailureKind } from './execution.ts';
1
+ import type { ContextLimit, FailureKind } from './execution.ts';
2
+ import type { EnvironmentCause } from './events.ts';
2
3
  /** Отказ окружения до начала работы: попытка не засчитывается. */
3
4
  export declare class BlockedError extends Error {
4
5
  name: string;
@@ -22,6 +23,10 @@ export declare class TaskFailure extends Error {
22
23
  inputClass: string;
23
24
  }[];
24
25
  } | undefined;
26
+ /** Причина отказа окружения, известная в точке обнаружения (`attempt.diagnosed`). */
27
+ readonly diagnosis?: EnvironmentCause | undefined;
28
+ /** Предел окна контекста у отказа `context-exhausted`, сообщённый runtime. */
29
+ readonly contextLimit?: ContextLimit | undefined;
25
30
  constructor(kind: FailureKind, message: string,
26
31
  /**
27
32
  * Свойства, с которыми связан отказ: `bound` — объявленные задачей
@@ -38,7 +43,11 @@ export declare class TaskFailure extends Error {
38
43
  property: string;
39
44
  inputClass: string;
40
45
  }[];
41
- } | undefined);
46
+ } | undefined,
47
+ /** Причина отказа окружения, известная в точке обнаружения (`attempt.diagnosed`). */
48
+ diagnosis?: EnvironmentCause | undefined,
49
+ /** Предел окна контекста у отказа `context-exhausted`, сообщённый runtime. */
50
+ contextLimit?: ContextLimit | undefined);
42
51
  }
43
52
  /**
44
53
  * Отпечаток отказа: одинаковые сбои должны совпадать, разные — расходиться.
@@ -49,4 +58,4 @@ export declare class TaskFailure extends Error {
49
58
  * повторов не сработал бы ни разу.
50
59
  */
51
60
  export declare function failureFingerprint(kind: FailureKind, message: string): string;
52
- export { MAX_NEUTRAL_FAILURES, repairPolicy, type RepairRule } from './repair-policy.ts';
61
+ export { MAX_NEUTRAL_FAILURES, lastContextLimit, repairPolicy, repairRepeats, type RepairRule, } from './repair-policy.ts';
@@ -7,6 +7,8 @@ export class BlockedError extends Error {
7
7
  export class TaskFailure extends Error {
8
8
  kind;
9
9
  properties;
10
+ diagnosis;
11
+ contextLimit;
10
12
  constructor(kind, message,
11
13
  /**
12
14
  * Свойства, с которыми связан отказ: `bound` — объявленные задачей
@@ -15,10 +17,16 @@ export class TaskFailure extends Error {
15
17
  * `classes` — классы входов, названные ревьюером; `pairs` — свойство и
16
18
  * класс одной находки.
17
19
  */
18
- properties) {
20
+ properties,
21
+ /** Причина отказа окружения, известная в точке обнаружения (`attempt.diagnosed`). */
22
+ diagnosis,
23
+ /** Предел окна контекста у отказа `context-exhausted`, сообщённый runtime. */
24
+ contextLimit) {
19
25
  super(message);
20
26
  this.kind = kind;
21
27
  this.properties = properties;
28
+ this.diagnosis = diagnosis;
29
+ this.contextLimit = contextLimit;
22
30
  this.name = 'TaskFailure';
23
31
  }
24
32
  }
@@ -52,4 +60,4 @@ export function failureFingerprint(kind, message) {
52
60
  .digest('hex')
53
61
  .slice(0, 16);
54
62
  }
55
- export { MAX_NEUTRAL_FAILURES, repairPolicy } from "./repair-policy.js";
63
+ export { MAX_NEUTRAL_FAILURES, lastContextLimit, repairPolicy, repairRepeats, } from "./repair-policy.js";
@@ -45,6 +45,13 @@ export declare const HANDOFF_LIMITS: {
45
45
  };
46
46
  /** Предел сериализованного пакета (JSON, UTF-8). */
47
47
  export declare const HANDOFF_MAX_BYTES: number;
48
+ /**
49
+ * Наименьший предел, который хост может задать пакету (`maxBytes` у
50
+ * `handoffPack`): ниже него не помещается даже обычный минимальный пакет.
51
+ * Это не гарантия: записи, которые не отбрасываются (сводка, очередь, идущие
52
+ * попытки, задания, следующий шаг), могут не уложиться и в больший предел.
53
+ */
54
+ export declare const HANDOFF_MIN_BYTES: number;
48
55
  export declare const handoffNextSteps: readonly ["accepted", "cancelled", "recovery-awaiting-lead", "recovery-analyzing", "recovery-applying", "recovery-retry-allowed", "recovery-retrying", "recovery-awaiting-user", "recovery-stopped", "corpus-adoption", "held", "plan-review", "attempt-running", "retry-within-budget", "attempts-exhausted", "awaiting-claim"];
49
56
  /** Команда harness, которая выполняет следующий шаг, когда он — запуск команды. */
50
57
  export declare const handoffCommands: readonly ["harness run", "harness resume"];
@@ -97,6 +104,7 @@ export declare const handoffPackSchema: z.ZodObject<{
97
104
  timeout: "timeout";
98
105
  "provider-auth": "provider-auth";
99
106
  stalled: "stalled";
107
+ "context-exhausted": "context-exhausted";
100
108
  "stale-base": "stale-base";
101
109
  "empty-result": "empty-result";
102
110
  unfinished: "unfinished";
@@ -131,6 +139,7 @@ export declare const handoffPackSchema: z.ZodObject<{
131
139
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
132
140
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
133
141
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
142
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
134
143
  REVISION_CONFLICT: "REVISION_CONFLICT";
135
144
  CANCELLED: "CANCELLED";
136
145
  NOT_FOUND: "NOT_FOUND";
@@ -251,6 +260,7 @@ export declare const handoffPackSchema: z.ZodObject<{
251
260
  timeout: "timeout";
252
261
  "provider-auth": "provider-auth";
253
262
  stalled: "stalled";
263
+ "context-exhausted": "context-exhausted";
254
264
  "stale-base": "stale-base";
255
265
  "empty-result": "empty-result";
256
266
  unfinished: "unfinished";
@@ -296,6 +306,7 @@ export declare const handoffPackSchema: z.ZodObject<{
296
306
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
297
307
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
298
308
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
309
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
299
310
  REVISION_CONFLICT: "REVISION_CONFLICT";
300
311
  CANCELLED: "CANCELLED";
301
312
  NOT_FOUND: "NOT_FOUND";
@@ -384,6 +395,7 @@ export declare const handoffPackSchema: z.ZodObject<{
384
395
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
385
396
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
386
397
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
398
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
387
399
  REVISION_CONFLICT: "REVISION_CONFLICT";
388
400
  CANCELLED: "CANCELLED";
389
401
  NOT_FOUND: "NOT_FOUND";
@@ -406,6 +418,7 @@ export declare const handoffPackSchema: z.ZodObject<{
406
418
  timeout: "timeout";
407
419
  "provider-auth": "provider-auth";
408
420
  stalled: "stalled";
421
+ "context-exhausted": "context-exhausted";
409
422
  "stale-base": "stale-base";
410
423
  "empty-result": "empty-result";
411
424
  unfinished: "unfinished";
@@ -507,6 +520,7 @@ export declare const handoffPackSchema: z.ZodObject<{
507
520
  timeout: "timeout";
508
521
  "provider-auth": "provider-auth";
509
522
  stalled: "stalled";
523
+ "context-exhausted": "context-exhausted";
510
524
  "stale-base": "stale-base";
511
525
  "empty-result": "empty-result";
512
526
  unfinished: "unfinished";
@@ -540,6 +554,7 @@ export declare const handoffPackSchema: z.ZodObject<{
540
554
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
541
555
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
542
556
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
557
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
543
558
  REVISION_CONFLICT: "REVISION_CONFLICT";
544
559
  CANCELLED: "CANCELLED";
545
560
  NOT_FOUND: "NOT_FOUND";
@@ -663,6 +678,7 @@ export declare const handoffPackSchema: z.ZodObject<{
663
678
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
664
679
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
665
680
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
681
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
666
682
  REVISION_CONFLICT: "REVISION_CONFLICT";
667
683
  CANCELLED: "CANCELLED";
668
684
  NOT_FOUND: "NOT_FOUND";
@@ -685,6 +701,7 @@ export declare const handoffPackSchema: z.ZodObject<{
685
701
  unfinished: z.ZodNumber;
686
702
  budgets: z.ZodNumber;
687
703
  budgetsWithin: z.ZodNumber;
704
+ budgetsShared: z.ZodDefault<z.ZodNumber>;
688
705
  repairs: z.ZodNumber;
689
706
  intentions: z.ZodNumber;
690
707
  intentionsDropped: z.ZodNumber;
@@ -49,6 +49,13 @@ export const HANDOFF_LIMITS = {
49
49
  };
50
50
  /** Предел сериализованного пакета (JSON, UTF-8). */
51
51
  export const HANDOFF_MAX_BYTES = 256 * 1024;
52
+ /**
53
+ * Наименьший предел, который хост может задать пакету (`maxBytes` у
54
+ * `handoffPack`): ниже него не помещается даже обычный минимальный пакет.
55
+ * Это не гарантия: записи, которые не отбрасываются (сводка, очередь, идущие
56
+ * попытки, задания, следующий шаг), могут не уложиться и в больший предел.
57
+ */
58
+ export const HANDOFF_MIN_BYTES = 4 * 1024;
52
59
  /** Строка, усечённая до `n` знаков с «…». */
53
60
  const clipped = (n) => z.string().max(n + 1);
54
61
  const text = clipped(HANDOFF_LIMITS.text);
@@ -229,7 +236,8 @@ export const handoffPackSchema = z.strictObject({
229
236
  * сообщённое runtime, `estimatedUsd` — оценка по тарифу; `complete: false`
230
237
  * — расход известен не полностью (вызовы без стоимости, незавершённые,
231
238
  * брошенные, попытки без учёта), сумма — нижняя граница, `remaining*` —
232
- * `null`. Бюджеты поручений в пределах и без расхода не перечисляются.
239
+ * `null`. Бюджеты поручений в пределах и без расхода не перечисляются, как
240
+ * и поручений, весь расход которых — вызовы о их группе (`truncated.budgetsShared`).
233
241
  * Нет поля — бюджеты не заданы.
234
242
  */
235
243
  budgets: z
@@ -271,10 +279,14 @@ export const handoffPackSchema = z.strictObject({
271
279
  /**
272
280
  * Сколько записей каждого списка не вошло в пакет (по пределу числа или
273
281
  * размера). `budgets` — строки бюджетов сверх предела, `budgetsWithin` —
274
- * бюджеты поручений в пределах и без расхода (не показаны намеренно);
282
+ * бюджеты поручений в пределах и без расхода (не показаны намеренно),
283
+ * `budgetsShared` — бюджеты поручений, весь расход которых — вызовы о их
284
+ * группе (ревью и проверка плана): этот расход один и уже есть в строках
285
+ * группы и total, а не повторяется у каждого поручения;
275
286
  * `intentions` — сколько намерений усечено по `intentionChars`,
276
287
  * `intentionsDropped` — отброшено ради предела размера; `bySize` — пакет
277
- * урезан до `HANDOFF_MAX_BYTES`.
288
+ * урезан до предела размера (`HANDOFF_MAX_BYTES` или меньший `maxBytes`
289
+ * хоста).
278
290
  */
279
291
  truncated: z.strictObject({
280
292
  works: count,
@@ -283,6 +295,8 @@ export const handoffPackSchema = z.strictObject({
283
295
  unfinished: count,
284
296
  budgets: count,
285
297
  budgetsWithin: count,
298
+ // Пакеты прежних версий поля не знают: при разборе — 0.
299
+ budgetsShared: count.default(0),
286
300
  repairs: count,
287
301
  intentions: count,
288
302
  intentionsDropped: count,
@@ -229,6 +229,7 @@ export declare const codedIssueSchema: z.ZodObject<{
229
229
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
230
230
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
231
231
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
232
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
232
233
  REVISION_CONFLICT: "REVISION_CONFLICT";
233
234
  CANCELLED: "CANCELLED";
234
235
  NOT_FOUND: "NOT_FOUND";
@@ -338,6 +339,7 @@ export declare const planCheckDataSchema: z.ZodObject<{
338
339
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
339
340
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
340
341
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
342
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
341
343
  REVISION_CONFLICT: "REVISION_CONFLICT";
342
344
  CANCELLED: "CANCELLED";
343
345
  NOT_FOUND: "NOT_FOUND";
@@ -5,7 +5,7 @@ import type { ContextSnapshot } from './context.ts';
5
5
  import type { ContractDocument } from './checks.ts';
6
6
  import type { RunResult } from './result.ts';
7
7
  import type { RunEvent, RunEventDraft, TransactionKind } from './events.ts';
8
- import type { AttemptState, CallRecord, EvidenceRecord, ControlState, ControllerLease, GraphState, JointVerificationState, LocalNamespace, LocalValue, Usage, WorkState } from './execution.ts';
8
+ import type { AttemptState, CallRecord, ContextLimit, EvidenceRecord, ControlState, ControllerLease, GraphState, JointVerificationState, LocalNamespace, LocalValue, Usage, WorkState } from './execution.ts';
9
9
  /** Чтение состояния исполнения из одного согласованного снимка. */
10
10
  export interface ExecutionView {
11
11
  control(): ControlState;
@@ -208,11 +208,19 @@ export interface RuntimeResponse {
208
208
  text: string;
209
209
  sessionId?: string;
210
210
  usage: Usage;
211
- /** Безопасная диагностика: код выхода, причина, путь сохранённого журнала. */
211
+ /**
212
+ * Безопасная диагностика: код выхода, причина, путь сохранённого журнала.
213
+ * `contextExhausted` — runtime сам сообщил, что запрос не помещается в окно
214
+ * контекста модели, и какой предел (у claude — `terminal_reason` итогового
215
+ * события); движок относит такой отказ к классу `context-exhausted`, а не
216
+ * к тексту причины. Необязательное поле: адаптер без него — прежняя
217
+ * семантика.
218
+ */
212
219
  diagnostics: {
213
220
  exitCode: number | null;
214
221
  reason?: string;
215
222
  log?: string;
223
+ contextExhausted?: ContextLimit;
216
224
  };
217
225
  /** Что reviewer выполнил по событиям runtime (только для ревью). */
218
226
  inspection?: NonNullable<EvidenceRecord['inspection']>;