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.
- package/README.md +28 -3
- package/docs/architecture.md +12 -0
- package/docs/compatibility.md +21 -18
- package/docs/contracts.md +189 -21
- package/docs/release-notes/0.1.0-alpha.32.md +33 -0
- package/docs/release-notes/0.1.0-alpha.33.md +29 -0
- package/docs/release-notes/0.1.0-alpha.34.md +32 -0
- package/docs/release-notes/0.1.0-alpha.35.md +27 -0
- package/docs/upgrade.md +172 -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/cli.js +2 -2
- package/lib/contracts/cli.d.ts +344 -6
- 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 +365 -4
- package/lib/contracts/events.js +63 -2
- package/lib/contracts/execution.d.ts +32 -1
- package/lib/contracts/execution.js +19 -0
- package/lib/contracts/failure.d.ts +12 -3
- package/lib/contracts/failure.js +10 -2
- package/lib/contracts/handoff.d.ts +17 -0
- package/lib/contracts/handoff.js +17 -3
- package/lib/contracts/planning.d.ts +2 -0
- package/lib/contracts/ports.d.ts +10 -2
- package/lib/contracts/published.d.ts +205 -3
- package/lib/contracts/repair-policy.d.ts +10 -1
- package/lib/contracts/repair-policy.js +18 -0
- package/lib/contracts/report.d.ts +118 -2
- package/lib/contracts/report.js +61 -3
- package/lib/contracts/result.d.ts +2 -0
- package/lib/control/base-move.d.ts +7 -2
- package/lib/control/base-move.js +14 -1
- package/lib/control/harness.d.ts +54 -18
- package/lib/control/harness.js +8 -96
- package/lib/control/recovery.d.ts +1 -1
- package/lib/control/status.d.ts +235 -0
- package/lib/control/status.js +101 -0
- package/lib/engine/budget.d.ts +78 -0
- package/lib/engine/budget.js +13 -2
- package/lib/engine/classify.d.ts +14 -1
- package/lib/engine/classify.js +34 -0
- package/lib/engine/engine.d.ts +25 -11
- package/lib/engine/engine.js +78 -5
- 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 +13 -5
- package/lib/environment/isolation.d.ts +67 -3
- package/lib/environment/isolation.js +148 -5
- package/lib/environment/lifecycle.js +1 -1
- package/lib/explain/state.d.ts +26 -5
- package/lib/explain/state.js +39 -4
- package/lib/handoff/index.d.ts +1 -1
- package/lib/handoff/markdown.js +4 -2
- package/lib/handoff/pack.d.ts +38 -8
- package/lib/handoff/pack.js +57 -18
- package/lib/index.d.ts +19 -4
- package/lib/index.js +19 -3
- package/lib/integrations/connector/testing.js +1 -1
- package/lib/projections/next.d.ts +3 -1
- package/lib/projections/next.js +4 -1
- package/lib/projections/stop.d.ts +14 -1
- package/lib/projections/stop.js +68 -11
- package/lib/report/compute.js +229 -21
- package/lib/report/document.js +32 -8
- package/lib/storage/document.d.ts +8 -6
- package/lib/verification/gates.js +20 -4
- package/package.json +1 -1
- package/schemas/execution-document.schema.json +11 -0
- package/schemas/handoff-pack.schema.json +15 -0
- package/schemas/result-envelope.schema.json +1 -0
- package/schemas/run-event.schema.json +322 -0
- package/schemas/run-result.schema.json +1 -0
- package/schemas/stop-diagnosis.schema.json +2 -0
- package/schemas/value-report.schema.json +236 -3
package/lib/contracts/events.js
CHANGED
|
@@ -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
|
-
*
|
|
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';
|
package/lib/contracts/failure.js
CHANGED
|
@@ -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;
|
package/lib/contracts/handoff.js
CHANGED
|
@@ -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";
|
package/lib/contracts/ports.d.ts
CHANGED
|
@@ -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']>;
|