minicode-ai 0.25.0 → 0.26.0
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 +3 -1
- package/cli/commands/config.ts +123 -0
- package/cli/setup.ts +107 -8
- package/docs/TERMINAL_CONTRACT.md +32 -1
- package/docs/config.md +13 -1
- package/docs/environment.md +1 -0
- package/docs/getting-started.md +11 -3
- package/package.json +1 -1
- package/src/app/session.ts +187 -17
- package/src/config.ts +19 -8
- package/src/constants.ts +14 -1
- package/src/lib/net.ts +6 -15
- package/src/lib/public-http.ts +128 -0
- package/src/policy/auto-resume.ts +63 -0
- package/src/policy/compaction.ts +354 -70
- package/src/policy/context-budget.ts +4 -6
- package/src/policy/context-window-assign.ts +114 -0
- package/src/policy/context-window-catalog.ts +4 -1
- package/src/policy/context-window-presets.ts +165 -0
- package/src/policy/context-window.ts +19 -4
- package/src/policy/context.ts +11 -9
- package/src/policy/executor.ts +69 -27
- package/src/policy/microcompact.ts +76 -15
- package/src/policy/recovery-budget.ts +281 -0
- package/src/policy/step-escalation.ts +82 -0
- package/src/policy/tokenizer-registry.ts +1 -0
- package/src/providers/detect.ts +13 -7
- package/src/providers/provision.ts +8 -0
- package/src/runtime/child-execution.ts +4 -2
- package/src/runtime/execution-backend.ts +3 -0
- package/src/sandbox/os.ts +53 -9
- package/src/session/context-assembly.ts +11 -7
- package/src/session/persistence.ts +19 -3
- package/src/tools/bash.ts +12 -9
- package/src/tools/code_run.ts +19 -20
- package/src/tools/task.ts +4 -1
- package/src/tools/web_fetch.ts +13 -19
- package/src/ui/assistant/simple.ts +61 -10
- package/src/ui/i18n/en.ts +3 -0
- package/src/ui/i18n/id.ts +3 -0
- package/src/ui/input/prompt-engine.ts +53 -21
- package/src/ui/render/activity-group.ts +8 -0
- package/src/ui/render/activity-panel.ts +20 -2
- package/src/ui/tui/app.ts +26 -11
- package/src/ui/tui/transcript.ts +175 -29
- package/vendor/minicore/src/core/loop.ts +20 -1
- package/vendor/minicore/src/core/session.ts +6 -0
|
@@ -0,0 +1,281 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Anggaran pemulihan bersama untuk SATU panggilan logis ke penyedia.
|
|
3
|
+
*
|
|
4
|
+
* ── Kenapa modul ini ada ────────────────────────────────────────────────────
|
|
5
|
+
* Insiden aslinya (sesi `17b6a5ff`, OBSERVATION.md T-009): satu gangguan
|
|
6
|
+
* penyedia yang berlangsung belasan detik mematikan sesi total, karena anggaran
|
|
7
|
+
* retry kernel hanya 3 percobaan (1+2+4 = 7 dtk).
|
|
8
|
+
*
|
|
9
|
+
* Perbaikan naif — "naikkan jumlah percobaan di retry, lalu tambahkan resume
|
|
10
|
+
* turn" — sudah dicoba dan salah secara struktural. Retry dan resume berada di
|
|
11
|
+
* dua lapisan berbeda, jadi biayanya BERKALI, bukan bertambah: 5 percobaan retry
|
|
12
|
+
* diulang untuk setiap resume menghasilkan 3 × 23 dtk + 13 dtk ≈ **82 detik**
|
|
13
|
+
* untuk provider yang mati permanen. Sebelum perubahan itu hanya 7 detik.
|
|
14
|
+
*
|
|
15
|
+
* Itu bukan bug angka, melainkan anti-pattern yang punya nama: *retry
|
|
16
|
+
* amplification* / *retry storm* (AWS Well-Architected REL05-BP03, "implement
|
|
17
|
+
* retries at only one level"). Setiap lapisan yang punya anggarannya sendiri
|
|
18
|
+
* mengalikan lapisan di bawahnya, dan hasilnya adalah penundaan raksasa tanpa
|
|
19
|
+
* tambahan kesembuhan.
|
|
20
|
+
*
|
|
21
|
+
* ── Yang dipakai sebagai gantinya (riset 2026) ──────────────────────────────
|
|
22
|
+
* Satu anggaran WAKTU TOTAL dipegang di puncak, dan setiap percobaan memakai
|
|
23
|
+
* sisa anggaran itu. Konsekuensinya: biaya total konstan berapa pun banyaknya
|
|
24
|
+
* lapisan yang mencoba. Ini pola "timeout budget" yang sama dipakai SDK AWS
|
|
25
|
+
* (retry quota), Google SRE, dan panduan agent-loop modern: *"a budget removes
|
|
26
|
+
* the multiplication by construction — the second attempt inherits what the
|
|
27
|
+
* first one left"*.
|
|
28
|
+
*
|
|
29
|
+
* Tiga mekanisme yang ikut dibawa dari praktik standar:
|
|
30
|
+
* 1. **Retry quota (token bucket)** — AWS standard mode. Token berkurang tiap
|
|
31
|
+
* percobaan dan pulih saat sukses. Saat habis, kita berhenti cepat alih-alih
|
|
32
|
+
* menunggu penuh untuk kegagalan yang sudah jelas tidak membaik. Inilah yang
|
|
33
|
+
* membuat provider mati total gagal dalam hitungan detik, bukan menit.
|
|
34
|
+
* 2. **Full jitter** — jeda acak pada `[0, delay]` (bukan delay pasti). Tanpa
|
|
35
|
+
* jitter, semua klien yang gagal bersamaan mencoba lagi bersamaan pula dan
|
|
36
|
+
* mengulang beban yang sama: *thundering herd* yang tertunda.
|
|
37
|
+
* 3. **`Retry-After` sebagai FLOOR, bukan target** — provider lebih tahu kapan
|
|
38
|
+
* jendelanya dibuka; kita tidak pernah menunggu lebih pendek dari itu.
|
|
39
|
+
*
|
|
40
|
+
* ── Apa yang TIDAK dilakukan ────────────────────────────────────────────────
|
|
41
|
+
* - Tidak ada penambahan jumlah percobaan tanpa batas. Anggaran waktu dan kuota
|
|
42
|
+
* token adalah dua pagar yang berbeda; keduanya wajib.
|
|
43
|
+
* - Tidak ada retry untuk kegagalan terminal (auth, request invalid, konteks
|
|
44
|
+
* kehabisan, anggaran habis). Mengulangnya tidak mengubah hasil.
|
|
45
|
+
*
|
|
46
|
+
* Modul ini MURNI (tanpa I/O, tanpa jam global) supaya kebijakan bisa diuji
|
|
47
|
+
* langsung: pemanggil memberi `nowMs`, bukan menyembunyikan `Date.now()`.
|
|
48
|
+
*/
|
|
49
|
+
|
|
50
|
+
/** Batas atas waktu yang boleh dipakai untuk memulihkan SATU panggilan logis.
|
|
51
|
+
*
|
|
52
|
+
* KENAPA 45 dtk: ini menutup gangguan penyedia yang nyata (insiden asli ~11 dtk;
|
|
53
|
+
* 529 "overloaded" Anthropic biasanya pulih dalam hitungan detik) dengan margin
|
|
54
|
+
* besar, sambil tetap jauh di bawah kesabaran user untuk perintah satu-shot dan
|
|
55
|
+
* deadline turn headless. Angka ini juga konsisten dengan praktik umum: panduan
|
|
56
|
+
* AWS menyarankan maksimum backoff 20 dtk, dan anggaran total harus beberapa kali
|
|
57
|
+
* lebih besar agar beberapa percobaan tetap masuk.
|
|
58
|
+
*/
|
|
59
|
+
export const RECOVERY_BUDGET_MS = 45_000
|
|
60
|
+
|
|
61
|
+
/** Kuota percobaan (token bucket). AWS standard mode memakai 3 percobaan total
|
|
62
|
+
* untuk satu request; kita memberi 6 slot karena satu panggilan di sini mencakup
|
|
63
|
+
* retry provider DAN resume turn (dua lapisan yang sekarang berbagi satu kuota).
|
|
64
|
+
*
|
|
65
|
+
* KENAPA tetap terbatas walau ada anggaran waktu: anggaran waktu saja akan
|
|
66
|
+
* menghabiskan 45 dtk penuh untuk provider yang mati. Kuota membuatnya berhenti
|
|
67
|
+
* cepat (≈10–15 dtk) begitu polanya jelas "gagal terus". */
|
|
68
|
+
export const RECOVERY_ATTEMPT_QUOTA = 6
|
|
69
|
+
|
|
70
|
+
/** Backoff dasar dan plafon per percobaan (ms).
|
|
71
|
+
*
|
|
72
|
+
* KENAPA 500 dan 8 dtk: AWS memakai base 50 ms untuk transient (sangat cepat
|
|
73
|
+
* karena panggilan HTTP-nya sendiri sudah cepat) dan 1 dtk untuk throttling.
|
|
74
|
+
* Panggilan LLM jauh lebih mahal dan lebih lambat, jadi base 500 ms masuk akal,
|
|
75
|
+
* dengan plafon 8 dtk yang sama dengan plafon backoff SDK Anthropic. */
|
|
76
|
+
export const RECOVERY_BASE_DELAY_MS = 500
|
|
77
|
+
export const RECOVERY_MAX_DELAY_MS = 8_000
|
|
78
|
+
|
|
79
|
+
/** Batas minimum jeda agar tidak menjadi hot loop (ms). */
|
|
80
|
+
export const RECOVERY_MIN_DELAY_MS = 50
|
|
81
|
+
|
|
82
|
+
/** Alasan berhenti — dipakai untuk pesan ke user, bukan sekadar dibuang. */
|
|
83
|
+
export type RecoveryStopReason =
|
|
84
|
+
/** Kategori/kind tidak akan membaik dengan diulang. */
|
|
85
|
+
| "not-transient"
|
|
86
|
+
/** Kuota percobaan habis (token bucket kosong). */
|
|
87
|
+
| "attempts-exhausted"
|
|
88
|
+
/** Anggaran waktu total habis. */
|
|
89
|
+
| "budget-exhausted"
|
|
90
|
+
/** User membatalkan (Ctrl+C / abort). */
|
|
91
|
+
| "user-abort"
|
|
92
|
+
/** Anggaran biaya/token model sudah habis — bukan gangguan penyedia. */
|
|
93
|
+
| "cost-budget"
|
|
94
|
+
/** Tidak ada prompt untuk dilanjutkan. */
|
|
95
|
+
| "no-prompt"
|
|
96
|
+
|
|
97
|
+
/** Kelanjutan yang diizinkan untuk sebuah kegagalan. */
|
|
98
|
+
export type RecoveryDecision =
|
|
99
|
+
| {
|
|
100
|
+
action: "retry"
|
|
101
|
+
/** Percobaan ke berapa (1-based) setelah keputusan ini dijalankan. */
|
|
102
|
+
attempt: number
|
|
103
|
+
/** Jeda sebelum percobaan itu (sudah termasuk jitter). */
|
|
104
|
+
delayMs: number
|
|
105
|
+
/** Sisa anggaran waktu setelah jeda (ms), untuk diagnostik/uji. */
|
|
106
|
+
remainingMs: number
|
|
107
|
+
}
|
|
108
|
+
| { action: "stop"; reason: RecoveryStopReason }
|
|
109
|
+
|
|
110
|
+
/** Keadaan anggaran pada satu titik waktu. */
|
|
111
|
+
export interface RecoveryState {
|
|
112
|
+
/** Waktu mulai percobaan pertama (epoch ms). */
|
|
113
|
+
startedAtMs: number
|
|
114
|
+
/** Waktu sekarang (epoch ms) — diberikan pemanggil, bukan diambil sendiri. */
|
|
115
|
+
nowMs: number
|
|
116
|
+
/** Percobaan yang SUDAH dipakai dari kuota. */
|
|
117
|
+
attemptsUsed: number
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
/** Sinyal kegagalan minimum, dipisah dari kelas error konkret agar murni. */
|
|
121
|
+
export interface FailureSignal {
|
|
122
|
+
/** Kategori provider bila kegagalannya berasal dari penyedia. */
|
|
123
|
+
category?: string
|
|
124
|
+
/** Kode kind AgentError (`max_steps_exceeded`, `aborted`, ...). */
|
|
125
|
+
kind?: string
|
|
126
|
+
/** True bila pembatalan datang dari user (bukan timeout internal). */
|
|
127
|
+
abortedByUser?: boolean
|
|
128
|
+
/** Petunjuk tunggu dari provider (`Retry-After`), ms. */
|
|
129
|
+
retryAfterMs?: number
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/** Kategori provider yang layak dicoba ulang: gangguan di sisi penyedia/jaringan.
|
|
133
|
+
*
|
|
134
|
+
* KENAPA `rate_limit` TIDAK ikut (riset 2026): 429 punya dua wajah yang tidak
|
|
135
|
+
* bisa dibedakan dari status saja. Yang biasa membawa `Retry-After` dan sudah
|
|
136
|
+
* ditangani lapisan retry (menghormati header, 3 percobaan) — mengulanginya di
|
|
137
|
+
* sini hanya menggandakan jeda. Yang kedua permanen: spend cap Anthropic (tanpa
|
|
138
|
+
* `Retry-After`) dan `credit_balance_exhausted`/spend-limit OpenAI, yang tidak
|
|
139
|
+
* pulih walau ditunggu. 5xx — termasuk 529 "overloaded" Anthropic yang dipetakan
|
|
140
|
+
* adapter ke `server` — tidak punya sinyal itu, dan di situlah pemulihan berguna.
|
|
141
|
+
*/
|
|
142
|
+
const TRANSIENT_CATEGORIES: ReadonlySet<string> = new Set(["server", "network"])
|
|
143
|
+
|
|
144
|
+
/** Kind kegagalan yang layak diulang ketika kategori tidak terbawa.
|
|
145
|
+
*
|
|
146
|
+
* KENAPA hanya `provider`: itu penanda "kegagalannya datang dari penyedia", dan
|
|
147
|
+
* kategori di atas yang memutuskan apakah sementaranya.
|
|
148
|
+
*
|
|
149
|
+
* KENAPA `budget_exceeded` TIDAK ikut (regresi nyata yang tertangkap tes):
|
|
150
|
+
* anggaran biaya yang habis bukan kondisi sementara. Mengulang turn justru
|
|
151
|
+
* MEMBAKAR lebih banyak uang untuk melewati pagar yang sama lalu gagal di titik
|
|
152
|
+
* yang sama. Gejalanya persis itu: `budget exceeded` → jeda → `budget exceeded`,
|
|
153
|
+
* dua kali membayar penuh lewat provider, dan bagi operator tampak seperti
|
|
154
|
+
* provider rusak padahal sistem sedang menghormati pagar yang ia sendiri pasang.
|
|
155
|
+
*
|
|
156
|
+
* `aborted`, `max_turns`, auth, dan request invalid juga TIDAK. `max_steps_exceeded`
|
|
157
|
+
* punya jalur sendiri (eskalasi batas langkah); kalau ikut di sini, turn diulang
|
|
158
|
+
* SEKALIGUS batasnya dinaikkan — biaya ganda untuk satu masalah.
|
|
159
|
+
*/
|
|
160
|
+
const RETRYABLE_KINDS: ReadonlySet<string> = new Set(["provider"])
|
|
161
|
+
|
|
162
|
+
/** Kategori yang secara eksplisit TIDAK akan membaik walau diulang. Didaftarkan
|
|
163
|
+
* supaya "tidak di-retry" menjadi keputusan yang disengaja, bukan efek samping
|
|
164
|
+
* dari daftar yang tak memuatnya. */
|
|
165
|
+
const TERMINAL_CATEGORIES: ReadonlySet<string> = new Set([
|
|
166
|
+
"auth",
|
|
167
|
+
"invalid_request",
|
|
168
|
+
"context_length_exceeded",
|
|
169
|
+
])
|
|
170
|
+
|
|
171
|
+
/** Kind yang terminal untuk tujuan pemulihan. */
|
|
172
|
+
const TERMINAL_KINDS: ReadonlySet<string> = new Set([
|
|
173
|
+
"aborted",
|
|
174
|
+
"budget_exceeded",
|
|
175
|
+
"max_turns",
|
|
176
|
+
"max_steps_exceeded",
|
|
177
|
+
])
|
|
178
|
+
|
|
179
|
+
/**
|
|
180
|
+
* Apakah kegagalan ini layak untuk dicoba lagi sama sekali.
|
|
181
|
+
*
|
|
182
|
+
* Dipisah dari {@link planRecovery} supaya daftar terminal bisa diuji sendiri —
|
|
183
|
+
* kesalahan di sini adalah kesalahan diagnosis, dan diagnosis yang salah membuat
|
|
184
|
+
* semua anggaran di bawahnya sia-sia.
|
|
185
|
+
*/
|
|
186
|
+
export function isRecoverable(failure: FailureSignal): boolean {
|
|
187
|
+
if (failure.abortedByUser === true) return false
|
|
188
|
+
if (failure.kind !== undefined && TERMINAL_KINDS.has(failure.kind)) return false
|
|
189
|
+
if (failure.category !== undefined) {
|
|
190
|
+
if (TERMINAL_CATEGORIES.has(failure.category)) return false
|
|
191
|
+
return TRANSIENT_CATEGORIES.has(failure.category)
|
|
192
|
+
}
|
|
193
|
+
// Kategori tidak terbawa: pakai kind sebagai cadangan.
|
|
194
|
+
return failure.kind !== undefined && RETRYABLE_KINDS.has(failure.kind)
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
/**
|
|
198
|
+
* Full jitter: nilai acak pada `[min, delay]`.
|
|
199
|
+
*
|
|
200
|
+
* KENAPA full jitter dan bukan "delay + sedikit acak": tujuan jitter adalah
|
|
201
|
+
* memecah klien yang gagal bersamaan agar tidak mencoba bersamaan lagi. Jeda
|
|
202
|
+
* deterministik menghasilkan thundering herd yang hanya tertunda. AWS
|
|
203
|
+
* Architecture Blog: `sleep = random_between(0, min(cap, base * 2^attempt))`.
|
|
204
|
+
*
|
|
205
|
+
* `min` dinaikkan dari 0 ke {@link RECOVERY_MIN_DELAY_MS} agar percobaan pertama
|
|
206
|
+
* tidak menjadi hot retry (dan agar `Retry-After` kecil tetap dihormati sebagai
|
|
207
|
+
* floor). `random` di-inject supaya uji deterministik.
|
|
208
|
+
*/
|
|
209
|
+
export function fullJitterDelay(delayMs: number, random: () => number = Math.random): number {
|
|
210
|
+
const cap = Math.max(RECOVERY_MIN_DELAY_MS, delayMs)
|
|
211
|
+
const spread = cap - RECOVERY_MIN_DELAY_MS
|
|
212
|
+
// random() bisa bernilai 1.0 pada implementasi lain; clamp agar tidak overflow.
|
|
213
|
+
const r = Math.min(1, Math.max(0, random()))
|
|
214
|
+
return Math.round(RECOVERY_MIN_DELAY_MS + spread * r)
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
/**
|
|
218
|
+
* Jeda eksponensial untuk percobaan ke-`attempt` (1-based), dengan plafon.
|
|
219
|
+
* `retryAfterMs` (bila wajar) diperlakukan sebagai FLOOR — kita tidak pernah
|
|
220
|
+
* menunggu lebih pendek daripada yang diminta provider, karena itu berarti
|
|
221
|
+
* membakar percobaan sebelum jendelanya dibuka.
|
|
222
|
+
*/
|
|
223
|
+
export function recoveryDelay(
|
|
224
|
+
attempt: number,
|
|
225
|
+
retryAfterMs?: number,
|
|
226
|
+
random: () => number = Math.random,
|
|
227
|
+
): number {
|
|
228
|
+
const exponential = Math.min(
|
|
229
|
+
RECOVERY_BASE_DELAY_MS * 2 ** Math.max(0, attempt - 1),
|
|
230
|
+
RECOVERY_MAX_DELAY_MS,
|
|
231
|
+
)
|
|
232
|
+
const floor =
|
|
233
|
+
retryAfterMs !== undefined && Number.isFinite(retryAfterMs) && retryAfterMs > 0
|
|
234
|
+
? Math.min(retryAfterMs, RECOVERY_MAX_DELAY_MS)
|
|
235
|
+
: 0
|
|
236
|
+
const target = Math.max(exponential, floor)
|
|
237
|
+
return fullJitterDelay(target, random)
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
/**
|
|
241
|
+
* Putuskan langkah pemulihan berikutnya untuk satu panggilan logis.
|
|
242
|
+
*
|
|
243
|
+
* Urutan pemeriksaan penting dan sengaja tetap:
|
|
244
|
+
* 1. Kendali user — abort tidak pernah dilanjutkan.
|
|
245
|
+
* 2. Diagnosis — terminal berhenti sebelum menghitung anggaran apa pun.
|
|
246
|
+
* 3. Anggaran biaya model — bukan gangguan, jadi tidak boleh "dipulihkan".
|
|
247
|
+
* 4. Kuota percobaan (fail fast saat pola sudah jelas).
|
|
248
|
+
* 5. Anggaran waktu total (pagar terakhir).
|
|
249
|
+
*/
|
|
250
|
+
export function planRecovery(
|
|
251
|
+
failure: FailureSignal,
|
|
252
|
+
state: RecoveryState,
|
|
253
|
+
opts: {
|
|
254
|
+
hasPrompt: boolean
|
|
255
|
+
costBudgetExhausted?: boolean
|
|
256
|
+
/** Di-inject untuk uji deterministik. */
|
|
257
|
+
random?: () => number
|
|
258
|
+
},
|
|
259
|
+
): RecoveryDecision {
|
|
260
|
+
if (!opts.hasPrompt) return { action: "stop", reason: "no-prompt" }
|
|
261
|
+
if (failure.abortedByUser === true || failure.kind === "aborted")
|
|
262
|
+
return { action: "stop", reason: "user-abort" }
|
|
263
|
+
if (opts.costBudgetExhausted === true) return { action: "stop", reason: "cost-budget" }
|
|
264
|
+
if (!isRecoverable(failure)) return { action: "stop", reason: "not-transient" }
|
|
265
|
+
|
|
266
|
+
// Kuota dulu, lalu waktu: kuota adalah pagar yang jauh lebih murah untuk
|
|
267
|
+
// diperiksa dan mencegah 45 dtk terpakai untuk pola "gagal terus".
|
|
268
|
+
if (state.attemptsUsed >= RECOVERY_ATTEMPT_QUOTA)
|
|
269
|
+
return { action: "stop", reason: "attempts-exhausted" }
|
|
270
|
+
|
|
271
|
+
const elapsed = state.nowMs - state.startedAtMs
|
|
272
|
+
const remainingMs = RECOVERY_BUDGET_MS - elapsed
|
|
273
|
+
const attempt = state.attemptsUsed + 1
|
|
274
|
+
const delayMs = recoveryDelay(attempt, failure.retryAfterMs, opts.random)
|
|
275
|
+
// Perlu sisa untuk jeda ini DAN untuk percobaan sesudahnya. Kalau jeda saja
|
|
276
|
+
// sudah melebihi sisa anggaran, menunggu lalu mencoba lagi hanya membuat user
|
|
277
|
+
// menunggu tanpa kesempatan berhasil.
|
|
278
|
+
if (delayMs >= remainingMs) return { action: "stop", reason: "budget-exhausted" }
|
|
279
|
+
|
|
280
|
+
return { action: "retry", attempt, delayMs, remainingMs: remainingMs - delayMs }
|
|
281
|
+
}
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Eskalasi adaptif batas langkah per turn.
|
|
3
|
+
*
|
|
4
|
+
* KENAPA: batas langkah adalah backstop anti-runaway, bukan anggaran kerja.
|
|
5
|
+
* Angka tunggal (dulu 50) salah di dua arah sekaligus — terlalu kecil untuk
|
|
6
|
+
* kerja nyata (pada sesi `17b6a5ff`, 4 dari 5 `turn.failed` adalah
|
|
7
|
+
* `exceeded 50 steps`), dan terlalu besar bila dipakai sebagai izin kerja
|
|
8
|
+
* tanpa batas. Solusinya bukan memilih satu angka ajaib, melainkan: mulai dari
|
|
9
|
+
* default yang waras, lalu NAIKKAN satu tangga ketika sesi terbukti mentok.
|
|
10
|
+
*
|
|
11
|
+
* KENAPA tangga, bukan "unlimited": tanpa batas atas, agent yang berputar
|
|
12
|
+
* (lihat LOOP_GUARD `READ_ONLY_THRASHING`) membakar token tanpa henti. Sesi
|
|
13
|
+
* yang sama sudah membakar ≈16,7 juta token. Tangga memberi ruang cukup
|
|
14
|
+
* sambil mempertahankan backstop yang terbatas dan dapat diramalkan.
|
|
15
|
+
*
|
|
16
|
+
* KENAPA satu tangga per kejadian: menaikkan langsung ke puncak menghapus
|
|
17
|
+
* sinyal "sesi ini memang rakus". Satu langkah per `max_steps_exceeded`
|
|
18
|
+
* membuat pertumbuhan sebanding dengan kebutuhan nyata.
|
|
19
|
+
*
|
|
20
|
+
* Modul ini murni (tanpa I/O, tanpa state global) agar bisa diuji langsung
|
|
21
|
+
* dan dipakai baik oleh sesi utama maupun sub-agent.
|
|
22
|
+
*/
|
|
23
|
+
|
|
24
|
+
/** Tangga batas langkah. 200 = default kerja nyata; 4× lipat per tangga. */
|
|
25
|
+
export const STEP_LIMIT_LADDER: readonly number[] = [200, 400, 800, 1_600, 3_200, 6_400] as const
|
|
26
|
+
|
|
27
|
+
/** Batas atas absolut. Di atas ini, "mentok langkah" bukan lagi masalah
|
|
28
|
+
* anggaran melainkan tanda agent berputar — harus berhenti, bukan naik. */
|
|
29
|
+
export const STEP_LIMIT_CEILING = 6_400
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* Batas langkah default untuk sesi utama.
|
|
33
|
+
*
|
|
34
|
+
* KENAPA 200 dan bukan 50: kerja nyata (baca, edit, jalankan tes, perbaiki)
|
|
35
|
+
* butuh ratusan langkah. 50 memaksa turn terputus di tengah tugas dan
|
|
36
|
+
* membuang langkah yang sudah dipakai.
|
|
37
|
+
*/
|
|
38
|
+
export const DEFAULT_SESSION_MAX_STEPS = 200
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* Batas langkah default untuk sub-agent.
|
|
42
|
+
*
|
|
43
|
+
* KENAPA tetap 50 sementara sesi utama 200: sub-agent berjalan PARALEL
|
|
44
|
+
* (`SUB_AGENT_POOL_SIZE`) dan tiap langkahnya memicu panggilan model sendiri.
|
|
45
|
+
* Naiknya biaya runaway di sini berlipat dengan jumlah sub-agent, sedangkan
|
|
46
|
+
* tugas sub-agent umumnya lebih sempit. Sub-agent tetap mendapat eskalasi
|
|
47
|
+
* adaptif yang sama ketika benar-benar mentok.
|
|
48
|
+
*/
|
|
49
|
+
export const DEFAULT_SUB_AGENT_MAX_STEPS = 50
|
|
50
|
+
|
|
51
|
+
/** Anak tangga berikutnya di atas `current`, atau `undefined` bila sudah di
|
|
52
|
+
* batas atas. Tidak melompat: satu langkah per kejadian. */
|
|
53
|
+
export function nextStepLadderStep(current: number): number | undefined {
|
|
54
|
+
const cur = Number.isFinite(current) && current > 0 ? current : 0
|
|
55
|
+
for (const step of STEP_LIMIT_LADDER) {
|
|
56
|
+
if (step > cur) return Math.min(step, STEP_LIMIT_CEILING)
|
|
57
|
+
}
|
|
58
|
+
return undefined
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* Hitung batas langkah baru setelah satu `max_steps_exceeded`.
|
|
63
|
+
*
|
|
64
|
+
* `observedSteps` = jumlah langkah yang benar-benar terpakai. Bila pengamatan
|
|
65
|
+
* sudah melampaui batas yang berlaku (mis. operator menaikkan batas manual di
|
|
66
|
+
* tengah jalan), naik dari pengamatan — bukan dari batas lama — supaya
|
|
67
|
+
* tangganya tidak "melewati" kebutuhan nyata.
|
|
68
|
+
*
|
|
69
|
+
* Mengembalikan `undefined` bila tidak ada kenaikan yang sah (sudah di puncak,
|
|
70
|
+
* atau hasilnya tidak lebih besar dari batas sekarang). Pemanggil WAJIB
|
|
71
|
+
* memperlakukan `undefined` sebagai "hentikan, jangan ulang" — bukan sebagai
|
|
72
|
+
* izin melanjutkan tanpa batas.
|
|
73
|
+
*/
|
|
74
|
+
export function nextStepLimit(currentLimit: number, observedSteps: number): number | undefined {
|
|
75
|
+
const base = Number.isFinite(currentLimit) && currentLimit > 0 ? Math.floor(currentLimit) : 0
|
|
76
|
+
const observed =
|
|
77
|
+
Number.isFinite(observedSteps) && observedSteps > 0 ? Math.floor(observedSteps) : 0
|
|
78
|
+
const from = Math.max(base, observed)
|
|
79
|
+
const next = nextStepLadderStep(from)
|
|
80
|
+
if (next === undefined || next <= base) return undefined
|
|
81
|
+
return next
|
|
82
|
+
}
|
|
@@ -72,6 +72,7 @@ export function getCachedTokenizer(modelId: string): BpeTokenizer | null {
|
|
|
72
72
|
* + fire-and-forget: gagal jaringan = null (fallback estimator densitas/usage).
|
|
73
73
|
*/
|
|
74
74
|
export async function loadTokenizer(modelId: string): Promise<BpeTokenizer | null> {
|
|
75
|
+
if (!tokenizersEnabled()) return null
|
|
75
76
|
const cached = getCachedTokenizer(modelId)
|
|
76
77
|
if (cached) return cached
|
|
77
78
|
const repo = findTokenizerRepo(modelId)
|
package/src/providers/detect.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { createHash } from "node:crypto"
|
|
1
2
|
import { LIMITS } from "../constants.ts"
|
|
2
3
|
|
|
3
4
|
export interface DetectedModel {
|
|
@@ -32,9 +33,7 @@ export interface DetectResult {
|
|
|
32
33
|
authFailed: boolean
|
|
33
34
|
}
|
|
34
35
|
|
|
35
|
-
//
|
|
36
|
-
// perlu re-deteksi network tiap kali. Key = url tanpa apiKey (secrets tidak
|
|
37
|
-
// pernah disimpan atau di-log).
|
|
36
|
+
// Scope cached metadata to endpoint and credential; never store plaintext keys.
|
|
38
37
|
const cache = new Map<string, { at: number; result: DetectResult }>()
|
|
39
38
|
const CACHE_TTL_MS = 30 * 60 * 1000
|
|
40
39
|
|
|
@@ -42,8 +41,14 @@ export function clearDetectCache(): void {
|
|
|
42
41
|
cache.clear()
|
|
43
42
|
}
|
|
44
43
|
|
|
45
|
-
export function cacheKey(baseUrl: string): string {
|
|
46
|
-
|
|
44
|
+
export function cacheKey(baseUrl: string, apiKey = ""): string {
|
|
45
|
+
let normalized = baseUrl.replace(/\/+$/, "")
|
|
46
|
+
try {
|
|
47
|
+
normalized = new URL(normalized).href.replace(/\/+$/, "")
|
|
48
|
+
} catch {
|
|
49
|
+
// Invalid URLs are handled by the fetch path; preserve their case here.
|
|
50
|
+
}
|
|
51
|
+
return `${normalized}#${createHash("sha256").update(apiKey).digest("hex")}`
|
|
47
52
|
}
|
|
48
53
|
|
|
49
54
|
function hybridHeaders(apiKey: string): Record<string, string>[] {
|
|
@@ -225,12 +230,13 @@ export async function detectModels(
|
|
|
225
230
|
signal?: AbortSignal,
|
|
226
231
|
): Promise<DetectResult> {
|
|
227
232
|
// serve dari cache bila masih segar (anti request redundant dalam 30 menit)
|
|
228
|
-
const key = cacheKey(baseUrl)
|
|
233
|
+
const key = cacheKey(baseUrl, apiKey)
|
|
229
234
|
const hit = cache.get(key)
|
|
230
235
|
if (hit && Date.now() - hit.at < CACHE_TTL_MS) return hit.result
|
|
231
236
|
|
|
232
237
|
// CAP global — jangan pernah biarkan user menunggu lama pada gateway offline
|
|
233
|
-
const
|
|
238
|
+
const timeout = AbortSignal.timeout(LIMITS.DETECT_GLOBAL_TIMEOUT_MS)
|
|
239
|
+
const sig = signal ? AbortSignal.any([signal, timeout]) : timeout
|
|
234
240
|
let everContacted = false
|
|
235
241
|
let everAuthFailed = false
|
|
236
242
|
for (const h of hybridHeaders(apiKey)) {
|
|
@@ -70,6 +70,14 @@ export async function saveProvider(
|
|
|
70
70
|
...(entry.contextWindows === undefined && previous.contextWindows
|
|
71
71
|
? { contextWindows: previous.contextWindows }
|
|
72
72
|
: {}),
|
|
73
|
+
// Sumber harus ikut diselamatkan bersama nilainya. Tanpa ini, entri
|
|
74
|
+
// yang ditulis tanpa `contextWindows` (mis. hasil `sync`) kehilangan
|
|
75
|
+
// label `user` sementara angkanya dipertahankan — nilai operator lalu
|
|
76
|
+
// dianggap milik endpoint dan boleh ditimpa pada sync berikutnya,
|
|
77
|
+
// yaitu persis hal yang label itu ada untuk mencegahnya.
|
|
78
|
+
...(entry.contextWindowSources === undefined && previous.contextWindowSources
|
|
79
|
+
? { contextWindowSources: previous.contextWindowSources }
|
|
80
|
+
: {}),
|
|
73
81
|
}
|
|
74
82
|
} else cfg.providers.push(entry)
|
|
75
83
|
await writeConfigAtomic(path, cfg)
|
|
@@ -106,9 +106,11 @@ export interface ChildAdmission {
|
|
|
106
106
|
}
|
|
107
107
|
|
|
108
108
|
function modeStepCap(mode: ChildMode): number {
|
|
109
|
-
// Evidence: SUB_AGENT_BUDGET_EXPLORE/PLAN + hard-cap
|
|
109
|
+
// Evidence: SUB_AGENT_BUDGET_EXPLORE/PLAN + hard-cap SUB_AGENT_MAX_STEPS (task.ts).
|
|
110
|
+
// [T-008] Memakai cap sub-agent SENDIRI, bukan DEFAULT_MAX_STEPS sesi utama:
|
|
111
|
+
// cap delegasi tidak boleh ikut naik saat default sesi utama berubah.
|
|
110
112
|
const cap = mode === "explore" ? LIMITS.SUB_AGENT_BUDGET_EXPLORE : LIMITS.SUB_AGENT_BUDGET_PLAN
|
|
111
|
-
return Math.min(cap, LIMITS.
|
|
113
|
+
return Math.min(cap, LIMITS.SUB_AGENT_MAX_STEPS)
|
|
112
114
|
}
|
|
113
115
|
|
|
114
116
|
/**
|
|
@@ -163,6 +163,7 @@ export interface BackendHandle {
|
|
|
163
163
|
}
|
|
164
164
|
|
|
165
165
|
export interface BackendExecRequest {
|
|
166
|
+
readonly signal?: AbortSignal
|
|
166
167
|
readonly cmd: string
|
|
167
168
|
readonly cwd?: string
|
|
168
169
|
readonly timeoutMs?: number
|
|
@@ -604,6 +605,7 @@ export function createBwrapBackend(): ExecutionBackend {
|
|
|
604
605
|
"bwrap unavailable on this platform",
|
|
605
606
|
(req) =>
|
|
606
607
|
runInOsSandbox(req.cmd, req.cwd ?? process.cwd(), {
|
|
608
|
+
...(req.signal ? { signal: req.signal } : {}),
|
|
607
609
|
...(req.timeoutMs !== undefined ? { timeoutMs: req.timeoutMs } : {}),
|
|
608
610
|
...(req.env ? { env: req.env } : {}),
|
|
609
611
|
}),
|
|
@@ -617,6 +619,7 @@ export function createSeatbeltBackend(): ExecutionBackend {
|
|
|
617
619
|
"seatbelt unavailable on this platform",
|
|
618
620
|
(req) =>
|
|
619
621
|
runInOsSandbox(req.cmd, req.cwd ?? process.cwd(), {
|
|
622
|
+
...(req.signal ? { signal: req.signal } : {}),
|
|
620
623
|
...(req.timeoutMs !== undefined ? { timeoutMs: req.timeoutMs } : {}),
|
|
621
624
|
...(req.env ? { env: req.env } : {}),
|
|
622
625
|
}),
|
package/src/sandbox/os.ts
CHANGED
|
@@ -59,6 +59,7 @@ export function osSandboxTypeName(): string {
|
|
|
59
59
|
}
|
|
60
60
|
|
|
61
61
|
export interface OsSandboxOptions {
|
|
62
|
+
signal?: AbortSignal
|
|
62
63
|
env?: Record<string, string>
|
|
63
64
|
timeoutMs?: number
|
|
64
65
|
network?: "none" | "bridge"
|
|
@@ -71,6 +72,7 @@ export function runInOsSandbox(
|
|
|
71
72
|
cwd: string,
|
|
72
73
|
opts: OsSandboxOptions = {},
|
|
73
74
|
): Promise<{ code: number | null; output: string }> {
|
|
75
|
+
if (opts.signal?.aborted) return Promise.reject(opts.signal.reason)
|
|
74
76
|
const { available, type } = detectOsSandbox()
|
|
75
77
|
if (!available) {
|
|
76
78
|
// Fail-closed seam: pemanggil (bash/code_run) wajib cek osSandboxAvailable
|
|
@@ -99,7 +101,7 @@ export function runInOsSandbox(
|
|
|
99
101
|
`
|
|
100
102
|
// Use sandbox-exec with inline profile via stdin? sandbox-exec needs file, write tmp
|
|
101
103
|
const args = ["-p", profile, "sh", "-c", command]
|
|
102
|
-
return runSpawn("sandbox-exec", args, abs, sanitizedEnv, timeout)
|
|
104
|
+
return runSpawn("sandbox-exec", args, abs, sanitizedEnv, timeout, opts.signal)
|
|
103
105
|
}
|
|
104
106
|
if (type === "bwrap") {
|
|
105
107
|
const args = [
|
|
@@ -139,7 +141,7 @@ export function runInOsSandbox(
|
|
|
139
141
|
const idx = args.indexOf("--unshare-net")
|
|
140
142
|
if (idx !== -1) args.splice(idx, 1)
|
|
141
143
|
}
|
|
142
|
-
return runSpawn("bwrap", args, abs, sanitizedEnv, timeout)
|
|
144
|
+
return runSpawn("bwrap", args, abs, sanitizedEnv, timeout, opts.signal)
|
|
143
145
|
}
|
|
144
146
|
return Promise.resolve({ code: null, output: "[os-sandbox] unknown type" })
|
|
145
147
|
}
|
|
@@ -150,8 +152,10 @@ function runSpawn(
|
|
|
150
152
|
cwd: string,
|
|
151
153
|
env: Record<string, string>,
|
|
152
154
|
timeoutMs: number,
|
|
155
|
+
signal?: AbortSignal,
|
|
153
156
|
): Promise<{ code: number | null; output: string }> {
|
|
154
|
-
return new Promise((resolveResult) => {
|
|
157
|
+
return new Promise((resolveResult, reject) => {
|
|
158
|
+
signal?.throwIfAborted()
|
|
155
159
|
// F-23: bin di-resolve absolut dari PATH terpercaya di sini (satu titik
|
|
156
160
|
// untuk seatbelt/bwrap) — spawn dengan cwd workspace di Windows bisa
|
|
157
161
|
// mengeksekusi <bin>.bat repo bila hanya nama telanjang.
|
|
@@ -185,7 +189,10 @@ function runSpawn(
|
|
|
185
189
|
}
|
|
186
190
|
p.stdout.on("data", (d) => appendCapped("out", d))
|
|
187
191
|
p.stderr.on("data", (d) => appendCapped("err", d))
|
|
188
|
-
|
|
192
|
+
let aborted = false
|
|
193
|
+
let timedOut = false
|
|
194
|
+
let settled = false
|
|
195
|
+
const killGroup = (): void => {
|
|
189
196
|
// SIGKILL ke seluruh process group (bwrap + child command). Fallback ke
|
|
190
197
|
// kill tunggal bila pid tak tersedia (spawn gagal sinkron).
|
|
191
198
|
try {
|
|
@@ -196,16 +203,53 @@ function runSpawn(
|
|
|
196
203
|
p.kill("SIGKILL")
|
|
197
204
|
} catch {}
|
|
198
205
|
}
|
|
199
|
-
}
|
|
200
|
-
|
|
206
|
+
}
|
|
207
|
+
const onAbort = (): void => {
|
|
208
|
+
if (settled || aborted) return
|
|
209
|
+
aborted = true
|
|
201
210
|
clearTimeout(t)
|
|
202
|
-
|
|
203
|
-
}
|
|
204
|
-
|
|
211
|
+
killGroup()
|
|
212
|
+
}
|
|
213
|
+
const cleanup = (): void => {
|
|
214
|
+
settled = true
|
|
205
215
|
clearTimeout(t)
|
|
216
|
+
signal?.removeEventListener("abort", onAbort)
|
|
217
|
+
}
|
|
218
|
+
const t = setTimeout(() => {
|
|
219
|
+
timedOut = true
|
|
220
|
+
killGroup()
|
|
221
|
+
}, timeoutMs)
|
|
222
|
+
p.once("error", (e) => {
|
|
223
|
+
cleanup()
|
|
224
|
+
if (aborted) reject(signal?.reason)
|
|
225
|
+
else resolveResult({ code: null, output: `[os-sandbox] ${e.message}` })
|
|
226
|
+
})
|
|
227
|
+
p.once("close", (code) => {
|
|
228
|
+
if (settled) return
|
|
229
|
+
cleanup()
|
|
230
|
+
if (aborted) {
|
|
231
|
+
reject(signal?.reason)
|
|
232
|
+
return
|
|
233
|
+
}
|
|
206
234
|
const marker = truncated ? "\n… [output truncated]" : ""
|
|
207
235
|
const output = (out + (err ? `\n[stderr]\n${err}` : "")).trim() + marker
|
|
236
|
+
if (timedOut) {
|
|
237
|
+
// Kontrak lapisan ini adalah RESOLVE (bukan reject): runner hanya
|
|
238
|
+
// melaporkan hasil proses (code/output), dan pemanggil yang memutuskan
|
|
239
|
+
// arti code=null. Dulu di sini `reject` untuk timeout, sementara abort
|
|
240
|
+
// `resolve` — kontraknya campur, sehingga `code_run` (yang tidak menangkap
|
|
241
|
+
// reject) meneruskan timeout sebagai error tak terduga. Docker runner
|
|
242
|
+
// sudah resolve untuk timeout; disamakan di sini.
|
|
243
|
+
resolveResult({
|
|
244
|
+
code: null,
|
|
245
|
+
output: `[os-sandbox] timed out after ${timeoutMs}ms; effects are UNKNOWN, inspect before retrying${marker ? `\n${marker}` : ""}${output ? `\n${output}` : ""}`,
|
|
246
|
+
})
|
|
247
|
+
return
|
|
248
|
+
}
|
|
208
249
|
resolveResult({ code, output })
|
|
209
250
|
})
|
|
251
|
+
signal?.addEventListener("abort", onAbort, { once: true })
|
|
252
|
+
// Close the race between the pre-spawn check and listener registration.
|
|
253
|
+
if (signal?.aborted) onAbort()
|
|
210
254
|
})
|
|
211
255
|
}
|
|
@@ -21,6 +21,7 @@
|
|
|
21
21
|
// seq, run_id, thread_id, migrated, …) dan tidak pernah ditulis balik ke histori.
|
|
22
22
|
|
|
23
23
|
import type { Message } from "#minicore/core/types.ts"
|
|
24
|
+
import { registerCompactionSummary } from "../policy/compaction.ts"
|
|
24
25
|
import {
|
|
25
26
|
getProjection,
|
|
26
27
|
getProjectionStatus,
|
|
@@ -67,12 +68,15 @@ export interface ContextView {
|
|
|
67
68
|
* (role+content). Field persistence-only DILARANG di sini.
|
|
68
69
|
*/
|
|
69
70
|
export function syntheticSummaryMessage(summary: string, coveredSeq: number): Message {
|
|
70
|
-
return
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
71
|
+
return registerCompactionSummary(
|
|
72
|
+
{
|
|
73
|
+
role: "user",
|
|
74
|
+
// Penanda cakupan eksplisit supaya model (dan pembaca log) tahu ini
|
|
75
|
+
// ringkasan prefix [0,N), bukan pesan kanonik.
|
|
76
|
+
content: `Previous context [0,${coveredSeq}):\n${summary}`,
|
|
77
|
+
},
|
|
78
|
+
summary,
|
|
79
|
+
)
|
|
76
80
|
}
|
|
77
81
|
|
|
78
82
|
/**
|
|
@@ -161,7 +165,7 @@ function assembleViewMessages(
|
|
|
161
165
|
const combined: ContextOnlyArtifact = { role: "user", content: combinedContent }
|
|
162
166
|
const rest = messages.slice(1) // buang synthetic lama (index 0)
|
|
163
167
|
return {
|
|
164
|
-
messages: [combined as Message, ...rest],
|
|
168
|
+
messages: [registerCompactionSummary(combined as Message, summaryArtifact.content), ...rest],
|
|
165
169
|
contextOnly: combined,
|
|
166
170
|
runtimeHeader: { role: "user", content: headerText },
|
|
167
171
|
}
|