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
@@ -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,4 @@
1
- import type { FailureKind } from './execution.ts';
1
+ import type { ContextLimit, FailureKind } from './execution.ts';
2
2
  import type { EnvironmentCause } from './events.ts';
3
3
  /** Отказ окружения до начала работы: попытка не засчитывается. */
4
4
  export declare class BlockedError extends Error {
@@ -25,6 +25,8 @@ export declare class TaskFailure extends Error {
25
25
  } | undefined;
26
26
  /** Причина отказа окружения, известная в точке обнаружения (`attempt.diagnosed`). */
27
27
  readonly diagnosis?: EnvironmentCause | undefined;
28
+ /** Предел окна контекста у отказа `context-exhausted`, сообщённый runtime. */
29
+ readonly contextLimit?: ContextLimit | undefined;
28
30
  constructor(kind: FailureKind, message: string,
29
31
  /**
30
32
  * Свойства, с которыми связан отказ: `bound` — объявленные задачей
@@ -43,7 +45,9 @@ export declare class TaskFailure extends Error {
43
45
  }[];
44
46
  } | undefined,
45
47
  /** Причина отказа окружения, известная в точке обнаружения (`attempt.diagnosed`). */
46
- diagnosis?: EnvironmentCause | undefined);
48
+ diagnosis?: EnvironmentCause | undefined,
49
+ /** Предел окна контекста у отказа `context-exhausted`, сообщённый runtime. */
50
+ contextLimit?: ContextLimit | undefined);
47
51
  }
48
52
  /**
49
53
  * Отпечаток отказа: одинаковые сбои должны совпадать, разные — расходиться.
@@ -54,4 +58,4 @@ export declare class TaskFailure extends Error {
54
58
  * повторов не сработал бы ни разу.
55
59
  */
56
60
  export declare function failureFingerprint(kind: FailureKind, message: string): string;
57
- 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';
@@ -8,6 +8,7 @@ export class TaskFailure extends Error {
8
8
  kind;
9
9
  properties;
10
10
  diagnosis;
11
+ contextLimit;
11
12
  constructor(kind, message,
12
13
  /**
13
14
  * Свойства, с которыми связан отказ: `bound` — объявленные задачей
@@ -18,11 +19,14 @@ export class TaskFailure extends Error {
18
19
  */
19
20
  properties,
20
21
  /** Причина отказа окружения, известная в точке обнаружения (`attempt.diagnosed`). */
21
- diagnosis) {
22
+ diagnosis,
23
+ /** Предел окна контекста у отказа `context-exhausted`, сообщённый runtime. */
24
+ contextLimit) {
22
25
  super(message);
23
26
  this.kind = kind;
24
27
  this.properties = properties;
25
28
  this.diagnosis = diagnosis;
29
+ this.contextLimit = contextLimit;
26
30
  this.name = 'TaskFailure';
27
31
  }
28
32
  }
@@ -56,4 +60,4 @@ export function failureFingerprint(kind, message) {
56
60
  .digest('hex')
57
61
  .slice(0, 16);
58
62
  }
59
- export { MAX_NEUTRAL_FAILURES, repairPolicy } from "./repair-policy.js";
63
+ export { MAX_NEUTRAL_FAILURES, lastContextLimit, repairPolicy, repairRepeats, } from "./repair-policy.js";
@@ -104,6 +104,7 @@ export declare const handoffPackSchema: z.ZodObject<{
104
104
  timeout: "timeout";
105
105
  "provider-auth": "provider-auth";
106
106
  stalled: "stalled";
107
+ "context-exhausted": "context-exhausted";
107
108
  "stale-base": "stale-base";
108
109
  "empty-result": "empty-result";
109
110
  unfinished: "unfinished";
@@ -138,6 +139,7 @@ export declare const handoffPackSchema: z.ZodObject<{
138
139
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
139
140
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
140
141
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
142
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
141
143
  REVISION_CONFLICT: "REVISION_CONFLICT";
142
144
  CANCELLED: "CANCELLED";
143
145
  NOT_FOUND: "NOT_FOUND";
@@ -258,6 +260,7 @@ export declare const handoffPackSchema: z.ZodObject<{
258
260
  timeout: "timeout";
259
261
  "provider-auth": "provider-auth";
260
262
  stalled: "stalled";
263
+ "context-exhausted": "context-exhausted";
261
264
  "stale-base": "stale-base";
262
265
  "empty-result": "empty-result";
263
266
  unfinished: "unfinished";
@@ -303,6 +306,7 @@ export declare const handoffPackSchema: z.ZodObject<{
303
306
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
304
307
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
305
308
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
309
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
306
310
  REVISION_CONFLICT: "REVISION_CONFLICT";
307
311
  CANCELLED: "CANCELLED";
308
312
  NOT_FOUND: "NOT_FOUND";
@@ -391,6 +395,7 @@ export declare const handoffPackSchema: z.ZodObject<{
391
395
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
392
396
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
393
397
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
398
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
394
399
  REVISION_CONFLICT: "REVISION_CONFLICT";
395
400
  CANCELLED: "CANCELLED";
396
401
  NOT_FOUND: "NOT_FOUND";
@@ -413,6 +418,7 @@ export declare const handoffPackSchema: z.ZodObject<{
413
418
  timeout: "timeout";
414
419
  "provider-auth": "provider-auth";
415
420
  stalled: "stalled";
421
+ "context-exhausted": "context-exhausted";
416
422
  "stale-base": "stale-base";
417
423
  "empty-result": "empty-result";
418
424
  unfinished: "unfinished";
@@ -514,6 +520,7 @@ export declare const handoffPackSchema: z.ZodObject<{
514
520
  timeout: "timeout";
515
521
  "provider-auth": "provider-auth";
516
522
  stalled: "stalled";
523
+ "context-exhausted": "context-exhausted";
517
524
  "stale-base": "stale-base";
518
525
  "empty-result": "empty-result";
519
526
  unfinished: "unfinished";
@@ -547,6 +554,7 @@ export declare const handoffPackSchema: z.ZodObject<{
547
554
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
548
555
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
549
556
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
557
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
550
558
  REVISION_CONFLICT: "REVISION_CONFLICT";
551
559
  CANCELLED: "CANCELLED";
552
560
  NOT_FOUND: "NOT_FOUND";
@@ -670,6 +678,7 @@ export declare const handoffPackSchema: z.ZodObject<{
670
678
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
671
679
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
672
680
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
681
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
673
682
  REVISION_CONFLICT: "REVISION_CONFLICT";
674
683
  CANCELLED: "CANCELLED";
675
684
  NOT_FOUND: "NOT_FOUND";
@@ -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']>;
@@ -1035,6 +1035,7 @@ export declare const publishedSchemas: {
1035
1035
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
1036
1036
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
1037
1037
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
1038
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
1038
1039
  REVISION_CONFLICT: "REVISION_CONFLICT";
1039
1040
  CANCELLED: "CANCELLED";
1040
1041
  NOT_FOUND: "NOT_FOUND";
@@ -1438,6 +1439,7 @@ export declare const publishedSchemas: {
1438
1439
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
1439
1440
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
1440
1441
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
1442
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
1441
1443
  REVISION_CONFLICT: "REVISION_CONFLICT";
1442
1444
  CANCELLED: "CANCELLED";
1443
1445
  NOT_FOUND: "NOT_FOUND";
@@ -1802,6 +1804,7 @@ export declare const publishedSchemas: {
1802
1804
  timeout: "timeout";
1803
1805
  "provider-auth": "provider-auth";
1804
1806
  stalled: "stalled";
1807
+ "context-exhausted": "context-exhausted";
1805
1808
  "stale-base": "stale-base";
1806
1809
  "empty-result": "empty-result";
1807
1810
  unfinished: "unfinished";
@@ -1823,6 +1826,7 @@ export declare const publishedSchemas: {
1823
1826
  timeout: "timeout";
1824
1827
  "provider-auth": "provider-auth";
1825
1828
  stalled: "stalled";
1829
+ "context-exhausted": "context-exhausted";
1826
1830
  "stale-base": "stale-base";
1827
1831
  "empty-result": "empty-result";
1828
1832
  unfinished: "unfinished";
@@ -1896,6 +1900,7 @@ export declare const publishedSchemas: {
1896
1900
  timeout: "timeout";
1897
1901
  "provider-auth": "provider-auth";
1898
1902
  stalled: "stalled";
1903
+ "context-exhausted": "context-exhausted";
1899
1904
  "stale-base": "stale-base";
1900
1905
  "empty-result": "empty-result";
1901
1906
  unfinished: "unfinished";
@@ -2214,6 +2219,7 @@ export declare const publishedSchemas: {
2214
2219
  timeout: "timeout";
2215
2220
  "provider-auth": "provider-auth";
2216
2221
  stalled: "stalled";
2222
+ "context-exhausted": "context-exhausted";
2217
2223
  "stale-base": "stale-base";
2218
2224
  "empty-result": "empty-result";
2219
2225
  unfinished: "unfinished";
@@ -2235,6 +2241,7 @@ export declare const publishedSchemas: {
2235
2241
  timeout: "timeout";
2236
2242
  "provider-auth": "provider-auth";
2237
2243
  stalled: "stalled";
2244
+ "context-exhausted": "context-exhausted";
2238
2245
  "stale-base": "stale-base";
2239
2246
  "empty-result": "empty-result";
2240
2247
  unfinished: "unfinished";
@@ -2308,6 +2315,7 @@ export declare const publishedSchemas: {
2308
2315
  timeout: "timeout";
2309
2316
  "provider-auth": "provider-auth";
2310
2317
  stalled: "stalled";
2318
+ "context-exhausted": "context-exhausted";
2311
2319
  "stale-base": "stale-base";
2312
2320
  "empty-result": "empty-result";
2313
2321
  unfinished: "unfinished";
@@ -2873,6 +2881,7 @@ export declare const publishedSchemas: {
2873
2881
  timeout: "timeout";
2874
2882
  "provider-auth": "provider-auth";
2875
2883
  stalled: "stalled";
2884
+ "context-exhausted": "context-exhausted";
2876
2885
  "stale-base": "stale-base";
2877
2886
  "empty-result": "empty-result";
2878
2887
  unfinished: "unfinished";
@@ -3090,6 +3099,7 @@ export declare const publishedSchemas: {
3090
3099
  timeout: "timeout";
3091
3100
  "provider-auth": "provider-auth";
3092
3101
  stalled: "stalled";
3102
+ "context-exhausted": "context-exhausted";
3093
3103
  "stale-base": "stale-base";
3094
3104
  "empty-result": "empty-result";
3095
3105
  unfinished: "unfinished";
@@ -3099,6 +3109,10 @@ export declare const publishedSchemas: {
3099
3109
  budget: "budget";
3100
3110
  "needs-lead": "needs-lead";
3101
3111
  }>>;
3112
+ contextLimit: z.ZodOptional<z.ZodEnum<{
3113
+ "prompt-too-long": "prompt-too-long";
3114
+ "blocking-limit": "blocking-limit";
3115
+ }>>;
3102
3116
  failureFingerprint: z.ZodOptional<z.ZodString>;
3103
3117
  requiredGates: z.ZodOptional<z.ZodArray<z.ZodString>>;
3104
3118
  consumers: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -3203,6 +3217,7 @@ export declare const publishedSchemas: {
3203
3217
  timeout: "timeout";
3204
3218
  "provider-auth": "provider-auth";
3205
3219
  stalled: "stalled";
3220
+ "context-exhausted": "context-exhausted";
3206
3221
  "stale-base": "stale-base";
3207
3222
  "empty-result": "empty-result";
3208
3223
  unfinished: "unfinished";
@@ -3771,6 +3786,7 @@ export declare const publishedSchemas: {
3771
3786
  timeout: "timeout";
3772
3787
  "provider-auth": "provider-auth";
3773
3788
  stalled: "stalled";
3789
+ "context-exhausted": "context-exhausted";
3774
3790
  "stale-base": "stale-base";
3775
3791
  "empty-result": "empty-result";
3776
3792
  unfinished: "unfinished";
@@ -3977,6 +3993,7 @@ export declare const publishedSchemas: {
3977
3993
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
3978
3994
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
3979
3995
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
3996
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
3980
3997
  REVISION_CONFLICT: "REVISION_CONFLICT";
3981
3998
  CANCELLED: "CANCELLED";
3982
3999
  NOT_FOUND: "NOT_FOUND";
@@ -3999,6 +4016,7 @@ export declare const publishedSchemas: {
3999
4016
  timeout: "timeout";
4000
4017
  "provider-auth": "provider-auth";
4001
4018
  stalled: "stalled";
4019
+ "context-exhausted": "context-exhausted";
4002
4020
  "stale-base": "stale-base";
4003
4021
  "empty-result": "empty-result";
4004
4022
  unfinished: "unfinished";
@@ -4350,6 +4368,7 @@ export declare const publishedSchemas: {
4350
4368
  timeout: "timeout";
4351
4369
  "provider-auth": "provider-auth";
4352
4370
  stalled: "stalled";
4371
+ "context-exhausted": "context-exhausted";
4353
4372
  "stale-base": "stale-base";
4354
4373
  "empty-result": "empty-result";
4355
4374
  unfinished: "unfinished";
@@ -4732,6 +4751,7 @@ export declare const publishedSchemas: {
4732
4751
  timeout: "timeout";
4733
4752
  "provider-auth": "provider-auth";
4734
4753
  stalled: "stalled";
4754
+ "context-exhausted": "context-exhausted";
4735
4755
  "stale-base": "stale-base";
4736
4756
  "empty-result": "empty-result";
4737
4757
  unfinished: "unfinished";
@@ -4766,6 +4786,7 @@ export declare const publishedSchemas: {
4766
4786
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
4767
4787
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
4768
4788
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
4789
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
4769
4790
  REVISION_CONFLICT: "REVISION_CONFLICT";
4770
4791
  CANCELLED: "CANCELLED";
4771
4792
  NOT_FOUND: "NOT_FOUND";
@@ -4886,6 +4907,7 @@ export declare const publishedSchemas: {
4886
4907
  timeout: "timeout";
4887
4908
  "provider-auth": "provider-auth";
4888
4909
  stalled: "stalled";
4910
+ "context-exhausted": "context-exhausted";
4889
4911
  "stale-base": "stale-base";
4890
4912
  "empty-result": "empty-result";
4891
4913
  unfinished: "unfinished";
@@ -4931,6 +4953,7 @@ export declare const publishedSchemas: {
4931
4953
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
4932
4954
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
4933
4955
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
4956
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
4934
4957
  REVISION_CONFLICT: "REVISION_CONFLICT";
4935
4958
  CANCELLED: "CANCELLED";
4936
4959
  NOT_FOUND: "NOT_FOUND";
@@ -5019,6 +5042,7 @@ export declare const publishedSchemas: {
5019
5042
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
5020
5043
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
5021
5044
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
5045
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
5022
5046
  REVISION_CONFLICT: "REVISION_CONFLICT";
5023
5047
  CANCELLED: "CANCELLED";
5024
5048
  NOT_FOUND: "NOT_FOUND";
@@ -5041,6 +5065,7 @@ export declare const publishedSchemas: {
5041
5065
  timeout: "timeout";
5042
5066
  "provider-auth": "provider-auth";
5043
5067
  stalled: "stalled";
5068
+ "context-exhausted": "context-exhausted";
5044
5069
  "stale-base": "stale-base";
5045
5070
  "empty-result": "empty-result";
5046
5071
  unfinished: "unfinished";
@@ -5142,6 +5167,7 @@ export declare const publishedSchemas: {
5142
5167
  timeout: "timeout";
5143
5168
  "provider-auth": "provider-auth";
5144
5169
  stalled: "stalled";
5170
+ "context-exhausted": "context-exhausted";
5145
5171
  "stale-base": "stale-base";
5146
5172
  "empty-result": "empty-result";
5147
5173
  unfinished: "unfinished";
@@ -5175,6 +5201,7 @@ export declare const publishedSchemas: {
5175
5201
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
5176
5202
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
5177
5203
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
5204
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
5178
5205
  REVISION_CONFLICT: "REVISION_CONFLICT";
5179
5206
  CANCELLED: "CANCELLED";
5180
5207
  NOT_FOUND: "NOT_FOUND";
@@ -5298,6 +5325,7 @@ export declare const publishedSchemas: {
5298
5325
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
5299
5326
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
5300
5327
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
5328
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
5301
5329
  REVISION_CONFLICT: "REVISION_CONFLICT";
5302
5330
  CANCELLED: "CANCELLED";
5303
5331
  NOT_FOUND: "NOT_FOUND";
@@ -1,4 +1,4 @@
1
- import type { FailureKind } from './execution.ts';
1
+ import type { AttemptState, ContextLimit, FailureKind } from './execution.ts';
2
2
  export interface RepairRule {
3
3
  /** `retry` — новая попытка той же задачи; `stop` — звать человека. */
4
4
  action: 'retry' | 'stop';
@@ -36,3 +36,12 @@ export interface RepairRule {
36
36
  */
37
37
  export declare const MAX_NEUTRAL_FAILURES = 3;
38
38
  export declare const repairPolicy: Record<FailureKind, RepairRule>;
39
+ /**
40
+ * Повторы одного отпечатка, разрешённые классу, с учётом предела окна
41
+ * контекста последнего отказа: `prompt-too-long` — уже первая реплика больше
42
+ * окна, повтор только удлинит подсказку отказом прошлой попытки, поэтому
43
+ * повторов нет; `blocking-limit` — повтор по правилу класса.
44
+ */
45
+ export declare function repairRepeats(kind: FailureKind, contextLimit?: ContextLimit): number;
46
+ /** Предел окна контекста последнего завершившегося отказом попытки поручения. */
47
+ export declare const lastContextLimit: (attempts: readonly Pick<AttemptState, "status" | "contextLimit">[]) => "prompt-too-long" | "blocking-limit" | undefined;
@@ -36,6 +36,11 @@ export const repairPolicy = {
36
36
  repeats: 1,
37
37
  explain: 'Процесс попытки жив, но дольше порога не выводил, не расходовал процессор и не менял стадий; обход controller его остановил. Это зависание среды или внешнего ожидания, а не замечание к коду: однократный повтор оправдан, второй такой же отказ — повод чинить среду (сеть, сервис, блокировку) или поднять порог stallSweep осознанно. Снимок процессов и хвост вывода — в событии attempt.liveness.',
38
38
  },
39
+ 'context-exhausted': {
40
+ action: 'retry',
41
+ repeats: 1,
42
+ explain: 'Исполнителю не хватило окна контекста модели внутри попытки (runtime сообщил, что запрос больше окна). Успешное автоматическое сжатие контекста отказом не считается. Когда ход остановлен у предела окна (blocking-limit), однократный повтор оправдан: следующая попытка получает этот отказ в подсказке и может читать меньше. Когда окно превышено уже первым запросом (prompt-too-long), повтора нет: подсказка только вырастет. Второй такой же исход означает, что задача не помещается в попытку: её нужно разделить или сократить контекст (меньше файлов и вывода в подсказке, уже область).',
43
+ },
39
44
  'stale-base': {
40
45
  action: 'stop',
41
46
  repeats: 0,
@@ -97,3 +102,16 @@ export const repairPolicy = {
97
102
  explain: 'Класс отказа не определён. Автоматическое восстановление вслепую дороже и опаснее остановки.',
98
103
  },
99
104
  };
105
+ /**
106
+ * Повторы одного отпечатка, разрешённые классу, с учётом предела окна
107
+ * контекста последнего отказа: `prompt-too-long` — уже первая реплика больше
108
+ * окна, повтор только удлинит подсказку отказом прошлой попытки, поэтому
109
+ * повторов нет; `blocking-limit` — повтор по правилу класса.
110
+ */
111
+ export function repairRepeats(kind, contextLimit) {
112
+ return kind === 'context-exhausted' && contextLimit === 'prompt-too-long'
113
+ ? 0
114
+ : repairPolicy[kind].repeats;
115
+ }
116
+ /** Предел окна контекста последнего завершившегося отказом попытки поручения. */
117
+ export const lastContextLimit = (attempts) => attempts.findLast((a) => a.status === 'failed')?.contextLimit;
@@ -319,6 +319,7 @@ export declare const valueReportSchema: z.ZodObject<{
319
319
  timeout: "timeout";
320
320
  "provider-auth": "provider-auth";
321
321
  stalled: "stalled";
322
+ "context-exhausted": "context-exhausted";
322
323
  "stale-base": "stale-base";
323
324
  "empty-result": "empty-result";
324
325
  unfinished: "unfinished";
@@ -921,6 +922,7 @@ export declare const reportDataSchema: z.ZodUnion<readonly [z.ZodObject<{
921
922
  timeout: "timeout";
922
923
  "provider-auth": "provider-auth";
923
924
  stalled: "stalled";
925
+ "context-exhausted": "context-exhausted";
924
926
  "stale-base": "stale-base";
925
927
  "empty-result": "empty-result";
926
928
  unfinished: "unfinished";
@@ -366,6 +366,7 @@ export declare const runResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
366
366
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
367
367
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
368
368
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
369
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
369
370
  REVISION_CONFLICT: "REVISION_CONFLICT";
370
371
  CANCELLED: "CANCELLED";
371
372
  NOT_FOUND: "NOT_FOUND";
@@ -795,6 +796,7 @@ export declare const resultEnvelopeSchema: z.ZodObject<{
795
796
  BUDGET_EXHAUSTED: "BUDGET_EXHAUSTED";
796
797
  BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
797
798
  ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
799
+ CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
798
800
  REVISION_CONFLICT: "REVISION_CONFLICT";
799
801
  CANCELLED: "CANCELLED";
800
802
  NOT_FOUND: "NOT_FOUND";