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.
Files changed (47) hide show
  1. package/README.md +3 -1
  2. package/cli/commands/config.ts +123 -0
  3. package/cli/setup.ts +107 -8
  4. package/docs/TERMINAL_CONTRACT.md +32 -1
  5. package/docs/config.md +13 -1
  6. package/docs/environment.md +1 -0
  7. package/docs/getting-started.md +11 -3
  8. package/package.json +1 -1
  9. package/src/app/session.ts +187 -17
  10. package/src/config.ts +19 -8
  11. package/src/constants.ts +14 -1
  12. package/src/lib/net.ts +6 -15
  13. package/src/lib/public-http.ts +128 -0
  14. package/src/policy/auto-resume.ts +63 -0
  15. package/src/policy/compaction.ts +354 -70
  16. package/src/policy/context-budget.ts +4 -6
  17. package/src/policy/context-window-assign.ts +114 -0
  18. package/src/policy/context-window-catalog.ts +4 -1
  19. package/src/policy/context-window-presets.ts +165 -0
  20. package/src/policy/context-window.ts +19 -4
  21. package/src/policy/context.ts +11 -9
  22. package/src/policy/executor.ts +69 -27
  23. package/src/policy/microcompact.ts +76 -15
  24. package/src/policy/recovery-budget.ts +281 -0
  25. package/src/policy/step-escalation.ts +82 -0
  26. package/src/policy/tokenizer-registry.ts +1 -0
  27. package/src/providers/detect.ts +13 -7
  28. package/src/providers/provision.ts +8 -0
  29. package/src/runtime/child-execution.ts +4 -2
  30. package/src/runtime/execution-backend.ts +3 -0
  31. package/src/sandbox/os.ts +53 -9
  32. package/src/session/context-assembly.ts +11 -7
  33. package/src/session/persistence.ts +19 -3
  34. package/src/tools/bash.ts +12 -9
  35. package/src/tools/code_run.ts +19 -20
  36. package/src/tools/task.ts +4 -1
  37. package/src/tools/web_fetch.ts +13 -19
  38. package/src/ui/assistant/simple.ts +61 -10
  39. package/src/ui/i18n/en.ts +3 -0
  40. package/src/ui/i18n/id.ts +3 -0
  41. package/src/ui/input/prompt-engine.ts +53 -21
  42. package/src/ui/render/activity-group.ts +8 -0
  43. package/src/ui/render/activity-panel.ts +20 -2
  44. package/src/ui/tui/app.ts +26 -11
  45. package/src/ui/tui/transcript.ts +175 -29
  46. package/vendor/minicore/src/core/loop.ts +20 -1
  47. 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)
@@ -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
- // Cache in-memory per baseUrl (30 menit) — /sync yang sering dipanggil tidak
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
- return baseUrl.replace(/\/+$/, "").toLowerCase()
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 sig = signal ?? AbortSignal.timeout(LIMITS.DETECT_GLOBAL_TIMEOUT_MS)
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 DEFAULT_MAX_STEPS (task.ts).
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.DEFAULT_MAX_STEPS)
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
- const t = setTimeout(() => {
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
- }, timeoutMs)
200
- p.on("error", (e) => {
206
+ }
207
+ const onAbort = (): void => {
208
+ if (settled || aborted) return
209
+ aborted = true
201
210
  clearTimeout(t)
202
- resolveResult({ code: null, output: `[os-sandbox] ${e.message}` })
203
- })
204
- p.on("close", (code) => {
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
- role: "user",
72
- // Penanda cakupan eksplisit supaya model (dan pembaca log) tahu ini
73
- // ringkasan prefix [0,N), bukan pesan kanonik.
74
- content: `Previous context [0,${coveredSeq}):\n${summary}`,
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
  }