minicode-ai 0.9.26

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 (162) hide show
  1. package/CHANGELOG.md +935 -0
  2. package/LICENSE +21 -0
  3. package/README.md +200 -0
  4. package/cli/args.ts +195 -0
  5. package/cli/auto-update.ts +108 -0
  6. package/cli/commands/auth.ts +166 -0
  7. package/cli/commands/config.ts +382 -0
  8. package/cli/commands/doctor.ts +128 -0
  9. package/cli/commands/exec.ts +179 -0
  10. package/cli/commands/mcp.ts +35 -0
  11. package/cli/commands/memory.ts +107 -0
  12. package/cli/commands/pricing.ts +100 -0
  13. package/cli/commands/providers.ts +162 -0
  14. package/cli/commands/sessions.ts +128 -0
  15. package/cli/commands/skills.ts +61 -0
  16. package/cli/commands/stats.ts +82 -0
  17. package/cli/commands.ts +317 -0
  18. package/cli/index.ts +539 -0
  19. package/cli/model-manager.ts +112 -0
  20. package/cli/provider-manager.ts +111 -0
  21. package/cli/repl.ts +734 -0
  22. package/cli/router.ts +124 -0
  23. package/cli/setup.ts +780 -0
  24. package/cli/wizard.ts +21 -0
  25. package/docs/ARCHITECTURE.html +1222 -0
  26. package/docs/README.md +109 -0
  27. package/docs/architecture.md +44 -0
  28. package/docs/changelog.md +3 -0
  29. package/package.json +91 -0
  30. package/src/agents/pool.ts +43 -0
  31. package/src/app/mentions.ts +50 -0
  32. package/src/app/provider-layer.ts +118 -0
  33. package/src/app/rag-layer.ts +105 -0
  34. package/src/app/session.ts +154 -0
  35. package/src/app/tool-layer.ts +56 -0
  36. package/src/config.ts +372 -0
  37. package/src/constants.ts +119 -0
  38. package/src/hooks/run.ts +89 -0
  39. package/src/lib/atomic-write.ts +88 -0
  40. package/src/lib/db-path.ts +36 -0
  41. package/src/lib/git-hardening.ts +91 -0
  42. package/src/lib/ignore.ts +58 -0
  43. package/src/lib/keystore.ts +202 -0
  44. package/src/lib/net.ts +70 -0
  45. package/src/lib/safe-open.ts +138 -0
  46. package/src/lib/session-id.ts +23 -0
  47. package/src/lib/trash.ts +38 -0
  48. package/src/lib/trusted-exec.ts +81 -0
  49. package/src/lsp/client.ts +395 -0
  50. package/src/mcp/client.ts +400 -0
  51. package/src/mcp/http-transport.ts +344 -0
  52. package/src/mcp/server.ts +538 -0
  53. package/src/mcp/transport.ts +150 -0
  54. package/src/memory/files.ts +159 -0
  55. package/src/memory/vector.ts +775 -0
  56. package/src/policy/allowlist.ts +67 -0
  57. package/src/policy/bash-guard.ts +465 -0
  58. package/src/policy/compaction.ts +271 -0
  59. package/src/policy/context.ts +161 -0
  60. package/src/policy/executor.ts +199 -0
  61. package/src/policy/jail.ts +127 -0
  62. package/src/policy/permission.ts +517 -0
  63. package/src/policy/pricing.ts +336 -0
  64. package/src/policy/ratelimit.ts +54 -0
  65. package/src/policy/sandbox-policy.ts +157 -0
  66. package/src/policy/scrub.ts +138 -0
  67. package/src/policy/update-check.ts +200 -0
  68. package/src/policy/usage.ts +292 -0
  69. package/src/policy/verifier.ts +181 -0
  70. package/src/providers/anthropic.ts +401 -0
  71. package/src/providers/auth-store.ts +139 -0
  72. package/src/providers/build.ts +136 -0
  73. package/src/providers/detect.ts +126 -0
  74. package/src/providers/effort.ts +165 -0
  75. package/src/providers/guards.ts +107 -0
  76. package/src/providers/oauth.ts +326 -0
  77. package/src/providers/presets.ts +122 -0
  78. package/src/providers/provision.ts +298 -0
  79. package/src/providers/responses.ts +371 -0
  80. package/src/providers/router.ts +247 -0
  81. package/src/repo/repomap.ts +470 -0
  82. package/src/sandbox/docker.ts +129 -0
  83. package/src/sandbox/os.ts +193 -0
  84. package/src/session/checkpoint.ts +543 -0
  85. package/src/session/journal.ts +1347 -0
  86. package/src/session/persistence.ts +446 -0
  87. package/src/session/shadow-git.ts +351 -0
  88. package/src/session/turn-marker.ts +118 -0
  89. package/src/skills/loader.ts +117 -0
  90. package/src/telemetry/trace.ts +283 -0
  91. package/src/tools/ask_user.ts +54 -0
  92. package/src/tools/bash.ts +400 -0
  93. package/src/tools/code_run.ts +96 -0
  94. package/src/tools/delete_file.ts +31 -0
  95. package/src/tools/edit.ts +204 -0
  96. package/src/tools/git.ts +301 -0
  97. package/src/tools/glob.ts +90 -0
  98. package/src/tools/grep.ts +281 -0
  99. package/src/tools/hashline.ts +66 -0
  100. package/src/tools/index.ts +103 -0
  101. package/src/tools/lsp.ts +346 -0
  102. package/src/tools/mcp_call.ts +163 -0
  103. package/src/tools/memory.ts +144 -0
  104. package/src/tools/move_file.ts +47 -0
  105. package/src/tools/patch.ts +86 -0
  106. package/src/tools/read_file.ts +130 -0
  107. package/src/tools/read_image.ts +80 -0
  108. package/src/tools/submit_result.ts +49 -0
  109. package/src/tools/task.ts +346 -0
  110. package/src/tools/todo.ts +201 -0
  111. package/src/tools/web_fetch.ts +161 -0
  112. package/src/tools/web_search.ts +156 -0
  113. package/src/tools/write_file.ts +42 -0
  114. package/src/ui/approval/prompt.ts +76 -0
  115. package/src/ui/assistant/simple.ts +568 -0
  116. package/src/ui/assistant/turn-status.ts +303 -0
  117. package/src/ui/contract.ts +55 -0
  118. package/src/ui/footer.ts +105 -0
  119. package/src/ui/input/input.ts +805 -0
  120. package/src/ui/input/prompt-engine.ts +606 -0
  121. package/src/ui/render/collapse.ts +84 -0
  122. package/src/ui/render/detail.ts +24 -0
  123. package/src/ui/render/diff.ts +181 -0
  124. package/src/ui/render/errors.ts +239 -0
  125. package/src/ui/render/format.ts +54 -0
  126. package/src/ui/render/highlight.ts +294 -0
  127. package/src/ui/render/markdown.ts +120 -0
  128. package/src/ui/render/money.ts +12 -0
  129. package/src/ui/render/reasoning.ts +20 -0
  130. package/src/ui/render/sanitize.ts +80 -0
  131. package/src/ui/render/table.ts +88 -0
  132. package/src/ui/render/theme.ts +339 -0
  133. package/src/ui/render/width.ts +256 -0
  134. package/src/ui/render/wrap.ts +120 -0
  135. package/src/ui/runtime/bus-debug.ts +83 -0
  136. package/src/ui/runtime/chrome.ts +301 -0
  137. package/src/ui/runtime/spinner.ts +77 -0
  138. package/src/ui/runtime/statusline.ts +227 -0
  139. package/src/ui/screens/model-manager.ts +434 -0
  140. package/src/ui/screens/overlay.ts +61 -0
  141. package/src/ui/screens/picker.ts +307 -0
  142. package/src/ui/screens/provider-manager.ts +450 -0
  143. package/src/ui/screens/wizard.ts +132 -0
  144. package/vendor/minicore/VENDOR.md +29 -0
  145. package/vendor/minicore/package.json +21 -0
  146. package/vendor/minicore/src/core/budget.ts +26 -0
  147. package/vendor/minicore/src/core/compact.ts +76 -0
  148. package/vendor/minicore/src/core/errors.ts +60 -0
  149. package/vendor/minicore/src/core/events.ts +74 -0
  150. package/vendor/minicore/src/core/executor.ts +139 -0
  151. package/vendor/minicore/src/core/history.ts +32 -0
  152. package/vendor/minicore/src/core/index.ts +42 -0
  153. package/vendor/minicore/src/core/loop.ts +344 -0
  154. package/vendor/minicore/src/core/permission.ts +24 -0
  155. package/vendor/minicore/src/core/provider.ts +39 -0
  156. package/vendor/minicore/src/core/recovery.ts +34 -0
  157. package/vendor/minicore/src/core/session.ts +327 -0
  158. package/vendor/minicore/src/core/snapshot.ts +142 -0
  159. package/vendor/minicore/src/core/tokens.ts +111 -0
  160. package/vendor/minicore/src/core/tool.ts +118 -0
  161. package/vendor/minicore/src/core/types.ts +50 -0
  162. package/vendor/minicore/src/providers/openai-compat.ts +366 -0
@@ -0,0 +1,303 @@
1
+ import type { UiBus } from "../contract.ts"
2
+ import { sanitizeAnsiLine } from "../render/sanitize.ts"
3
+ import { c, glyphs } from "../render/theme.ts"
4
+ import { displayWidth, truncateToWidth } from "../render/width.ts"
5
+ import { acquireTransientPaint, paintWrite, registerStatusLine } from "../runtime/statusline.ts"
6
+
7
+ // Turn status line — satu baris transient di stderr, hidup hanya pada fase
8
+ // turn yang TIDAK memproduksi teks (berpikir / tool berjalan). Teks model
9
+ // adalah output utama; garis status tidak pernah menimpa area teks.
10
+ //
11
+ // Garis memakai ikon + titik animasi sebagai heartbeat — sinyal "masih
12
+ // hidup" tanpa teks panjang. Tanpa ini turn yang stall terlihat mati diam.
13
+ //
14
+ // Lifecycle deterministik:
15
+ // turn:started → state nyala, BELUM melukis. Lukisan mulai pada
16
+ // reasoning/execution pertama, ATAU grace 250ms bila
17
+ // belum ada event (keheningan total terasa macet).
18
+ // reasoning (extension) → "Thinking", KECUALI fase menulis sudah dimulai
19
+ // (latch textSeen) — interleave reasoning/teks model
20
+ // reasoning takkan strobo on/off.
21
+ // execution:started → label kerja nyata (nama tool + target), latch dibuka
22
+ // provider:text → garis HILANG + latch (teks mengalir)
23
+ // execution:completed → kembali "Thinking" bila masih fase sunyi
24
+ // turn:completed → bersih + reset
25
+ // endTurn() → bersih + reset, DIPANGGIL DRIVER setelah turn
26
+ // settle apa pun (kernel TIDAK emit turn:completed
27
+ // pada gagal/abort — tanpa ini garis status basi
28
+ // melukis di atas prompt idle setelah error/Ctrl+C)
29
+ // Output lain memakai runWithoutStatus() (suspend sesaat → resume bila aturan
30
+ // masih terpenuhi), jadi garis tidak pernah tertinggal di scrollback.
31
+ // Kursor disembunyikan selama garis melukis agar tak terbaca sebagai bagian
32
+ // indikator (pola spinner.ts). Didaftarkan sekali per proses — aman
33
+ // dipanggil berulang karena tiap attach me-restore di stopPaint/endTurn.
34
+ process.on("exit", () => {
35
+ try {
36
+ if (process.stderr.isTTY) process.stderr.write("\x1b[?25h")
37
+ } catch {}
38
+ })
39
+
40
+ export interface TurnStatusHandle {
41
+ detach(): void
42
+ /** Bersihkan + reset garis; aman dipanggil kapan pun (idempotent). */
43
+ endTurn(): void
44
+ }
45
+
46
+ /** Durasi ringkas — dipertahankan untuk kompatibilitas test eksternal. */
47
+ export function formatElapsed(ms: number): string {
48
+ const s = Math.max(0, Math.floor(ms / 1000))
49
+ if (s < 60) return `${s}s`
50
+ const m = Math.floor(s / 60)
51
+ if (m < 60) return `${m}m${String(s % 60).padStart(2, "0")}s`
52
+ return `${Math.floor(m / 60)}h${String(m % 60).padStart(2, "0")}m`
53
+ }
54
+
55
+ export function attachTurnStatus(
56
+ bus: UiBus,
57
+ opts: {
58
+ initialModel?: string
59
+ getModel?: () => string | undefined
60
+ /**
61
+ * Teks statistik tambahan (mis. token/biaya sesi) — DI dari composition
62
+ * root agar UI tak perlu impor lapisan policy/usage. Undefined = mati
63
+ * (default hemat: shell tetap bersih).
64
+ */
65
+ getStats?: () => string | undefined
66
+ } = {},
67
+ ): TurnStatusHandle {
68
+ if (!process.stderr.isTTY) return { detach: () => {}, endTurn: () => {} }
69
+ const isWinLegacy =
70
+ process.platform === "win32" &&
71
+ !(
72
+ process.env.WT_SESSION ||
73
+ process.env.TERM_PROGRAM ||
74
+ process.env.ANSICON ||
75
+ process.env.ConEmuANSI
76
+ )
77
+ if (isWinLegacy) return { detach: () => {}, endTurn: () => {} }
78
+
79
+ let intervalId: ReturnType<typeof setInterval> | undefined
80
+ let fi = 0
81
+ // State mesin garis — interval hanya menulis ulang label terkini.
82
+ let turnOn = false
83
+ let textOn = false
84
+ // Latch fase: sekali teks mengalir, reasoning susulan (interleave chunk
85
+ // model reasoning) TIDAK menghidupkan garis lagi sampai tool berikutnya.
86
+ // Tanpa ini garis strobo on/off mengikuti alternasi chunk — terlihat
87
+ // "kebalik": berisik saat menulis, padahal harusnya hening.
88
+ let textSeen = false
89
+ // Grace timer: turn:started tidak langsung melukis (jendela catatan router),
90
+ // tapi keheningan total >250ms terasa macet — tampilkan Thinking bila belum
91
+ // ada event kerja. Turn cepat (<250ms) tak pernah nge-flash.
92
+ let graceTimer: ReturnType<typeof setTimeout> | undefined
93
+ let label = "Thinking"
94
+ // Kecepatan reasoning: diukur dari frekuensi chunk reasoning yang masuk.
95
+ // Interval animasi mengikuti — cepat bila model berpikir cepat.
96
+ let intervalMs = 150
97
+ let lastReasoningMs: number | null = null
98
+ const recentDeltas: number[] = []
99
+ // Kepemilikan transient stderr selama interval hidup — lihat statusline.ts.
100
+ let owned: { release(): void } | null = null
101
+
102
+ const shouldPaint = (): boolean => turnOn && !textOn
103
+ const paint = () => {
104
+ let extra = ""
105
+ try {
106
+ const s = opts.getStats?.()
107
+ if (s) extra = ` · ${s}`
108
+ } catch {}
109
+ // Titik animasi eksplisit, ganti tiap 3 tick (~0,4 detik pada 120ms):
110
+ // sinyal "masih hidup" yang tak ambigu tapi tenang. Tak pernah bare:
111
+ // selalu ≥1 titik. Titik dipisah spasi ("· · ·") agar tak mepet ikon.
112
+ // Ikon thinking SPARKLE ✦ kelip lambat: putih ↔ abu tiap 3 tick
113
+ // (glow halus, bukan strobo) — glyph monokrom jadi warna ANSI terlihat;
114
+ // kecepatan refresh mengikuti intervalMs yang adaptif terhadap
115
+ // kecepatan reasoning model (minimum 120ms).
116
+ const tickGroup = Math.floor(fi / 3)
117
+ const dots = Array(1 + (tickGroup % 3))
118
+ .fill(glyphs.dot)
119
+ .join(" ")
120
+ const cols = process.stdout.columns || 80
121
+ // Sinyal "alive" (spark pulse) kini MILIK FOOTER, bukan thinking line:
122
+ // satu sumber agar tak ada dua denyut. Thinking = titik saja; tool line
123
+ // tetap pakai spinner braille (itu progres, bukan spark).
124
+ const body =
125
+ label === "Thinking"
126
+ ? `${dots}`
127
+ : `${c.info(glyphs.spinnerFrames[fi % glyphs.spinnerFrames.length]!)} ${label} ${dots}`
128
+ const full = body + extra
129
+ // Terminal sangat sempit: potongan label bisa tinggal 1 huruf ("t") —
130
+ // dalam kasus itu tampilkan titiknya saja daripada label rusak.
131
+ // Terminal normal: potong biasa (label terpotong tetap informatif).
132
+ const maxW = Math.max(4, cols - 1)
133
+ const shown =
134
+ displayWidth(full) <= maxW ? full : maxW <= 12 ? dots : truncateToWidth(full, maxW)
135
+ paintWrite(`\r\x1b[2K${shown}`)
136
+ fi++
137
+ }
138
+ const stopPaint = () => {
139
+ if (owned) {
140
+ owned.release()
141
+ owned = null
142
+ }
143
+ if (intervalId) {
144
+ clearInterval(intervalId)
145
+ intervalId = undefined
146
+ }
147
+ paintWrite("\r\x1b[2K")
148
+ // Kembalikan kursor yang disembunyikan saat acquire — tanpa ini terminal
149
+ // terlihat mati (kursor hilang permanen lebih buruk dari flicker).
150
+ try {
151
+ paintWrite("\x1b[?25h")
152
+ } catch {}
153
+ }
154
+ const restartInterval = () => {
155
+ if (!intervalId) return
156
+ clearInterval(intervalId)
157
+ intervalId = setInterval(paint, intervalMs)
158
+ }
159
+
160
+ const clearGrace = () => {
161
+ if (graceTimer) {
162
+ clearTimeout(graceTimer)
163
+ graceTimer = undefined
164
+ }
165
+ }
166
+ const startPaint = (next: string) => {
167
+ label = next
168
+ if (!shouldPaint()) return
169
+ clearGrace()
170
+ if (!intervalId) {
171
+ fi = 0
172
+ // Repaint segera setelah tulis asing dikomit (lihat statusline.ts).
173
+ owned = acquireTransientPaint("turn", () => {
174
+ if (shouldPaint()) startPaint(label)
175
+ })
176
+ // Sembunyikan kursor selama melukis agar tak terbaca sebagai bagian
177
+ // indikator ("✦···|"); dikembalikan di stopPaint.
178
+ try {
179
+ paintWrite("\x1b[?25l")
180
+ } catch {}
181
+ paint()
182
+ intervalId = setInterval(paint, intervalMs)
183
+ } else paint()
184
+ }
185
+ const resetTurn = () => {
186
+ turnOn = false
187
+ textOn = false
188
+ textSeen = false
189
+ label = "Thinking"
190
+ intervalMs = 150
191
+ lastReasoningMs = null
192
+ recentDeltas.length = 0
193
+ clearGrace()
194
+ stopPaint()
195
+ }
196
+
197
+ // Dipakai renderer via runWithoutStatus: hentikan repaint sebentar, lalu
198
+ // hidupkan lagi bila aturan masih terpenuhi. Saat garis SEDANG TIDAK melukis
199
+ // (mis. teks mengalir), suspend tidak menulis apa pun — \r\x1b[2K yang
200
+ // serampangan bisa memotong baris parsial milik penulis lain.
201
+ let paused = false
202
+ const handle = {
203
+ suspend() {
204
+ paused = !!intervalId
205
+ if (intervalId) stopPaint()
206
+ },
207
+ resume() {
208
+ if (paused && shouldPaint()) startPaint(label)
209
+ paused = false
210
+ },
211
+ }
212
+ registerStatusLine(handle)
213
+
214
+ const toolLabel = (e: { execution: { call: { name: string; args?: unknown } } }): string => {
215
+ const name = e.execution.call.name
216
+ const args = (e.execution.call.args ?? {}) as Record<string, unknown>
217
+ let target = ""
218
+ if (typeof args.path === "string") target = args.path
219
+ else if (typeof args.file === "string") target = args.file
220
+ else if (typeof args.cmd === "string") target = args.cmd.slice(0, 80)
221
+ else if (typeof args.command === "string") target = args.command.slice(0, 80)
222
+ // Potong panjang (bukan lebar) di sini; pemotongan LEBAR terjadi per-paint
223
+ // agar resize langsung berefek.
224
+ // Nama + argumen datang dari model (tak terpercaya): sanitasi sebelum
225
+ // masuk paintWrite — truncateToWidth memotong lebar, bukan sekuens kontrol.
226
+ const cleanName = sanitizeAnsiLine(name)
227
+ const label2 = target ? `${cleanName} ${sanitizeAnsiLine(target)}` : cleanName
228
+ return label2.length > 200 ? label2.slice(0, 200) : label2
229
+ }
230
+
231
+ const detach = [
232
+ bus.on("turn:started", () => {
233
+ turnOn = true
234
+ textOn = false
235
+ textSeen = false
236
+ label = "Thinking"
237
+ // Sengaja tidak langsung melukis — jendela sebelum event pertama (mis.
238
+ // catatan [router] di awal stream) dibiarkan polos agar tidak ada tulis
239
+ // asing yang bisa tertimpa/terhapus garis ini. Grace 250ms menutup
240
+ // lubangnya: keheningan lebih lama terasa macet, bukan sopan.
241
+ clearGrace()
242
+ graceTimer = setTimeout(() => {
243
+ graceTimer = undefined
244
+ // Hanya bila belum ada yang melukis (tool duluan menang) dan masih
245
+ // dalam fase sunyi — jangan timpa label tool / fase teks.
246
+ if (!intervalId && shouldPaint() && label === "Thinking") startPaint("Thinking")
247
+ }, 250)
248
+ }),
249
+ bus.on("provider:text", () => {
250
+ // Teks model = output utama; garis status tidak boleh menimpa area teks.
251
+ // Latch: reasoning susulan (interleave) tidak menghidupkan lagi.
252
+ textOn = true
253
+ textSeen = true
254
+ clearGrace()
255
+ stopPaint()
256
+ }),
257
+ bus.on("provider:extension", (e: { kind: string }) => {
258
+ if (e.kind === "reasoning") {
259
+ // Fase menulis sudah dimulai → tetap sembunyi (anti-strobo).
260
+ if (textSeen) return
261
+ // Adaptasi kecepatan: ukur jarak antar chunk reasoning
262
+ const now = Date.now()
263
+ if (lastReasoningMs != null) {
264
+ const d = now - lastReasoningMs
265
+ if (d > 10 && d < 2000) {
266
+ recentDeltas.push(d)
267
+ if (recentDeltas.length > 6) recentDeltas.shift()
268
+ const avg = recentDeltas.reduce((a, b) => a + b, 0) / recentDeltas.length
269
+ const nextMs = avg < 120 ? 120 : avg < 250 ? 150 : avg < 500 ? 220 : 320
270
+ if (nextMs !== intervalMs) {
271
+ intervalMs = nextMs
272
+ restartInterval()
273
+ }
274
+ }
275
+ }
276
+ lastReasoningMs = now
277
+ textOn = false
278
+ startPaint("Thinking")
279
+ } else if (e.kind === "error") stopPaint()
280
+ }),
281
+ bus.on("execution:started", (e: { execution: { call: { name: string; args?: unknown } } }) => {
282
+ // Fase kerja baru: latch teks dibuka lagi (thinking antar-tool tampil).
283
+ textOn = false
284
+ textSeen = false
285
+ startPaint(toolLabel(e))
286
+ }),
287
+ bus.on("execution:completed", () => {
288
+ // Tool selesai: kembali ke "Thinking" selama model belum mengeluarkan teks.
289
+ textSeen = false
290
+ if (shouldPaint()) startPaint("Thinking")
291
+ }),
292
+ bus.on("turn:completed", resetTurn),
293
+ ]
294
+
295
+ return {
296
+ endTurn: resetTurn,
297
+ detach: () => {
298
+ resetTurn()
299
+ registerStatusLine(null)
300
+ for (const d of detach) d()
301
+ },
302
+ }
303
+ }
@@ -0,0 +1,55 @@
1
+ // Kontrak presentasi — satu-satunya jendela komunikasi antara lapisan UI dan
2
+ // sistem di luarnya.
3
+ //
4
+ // Aturan arah dependensi (dijaga test/ui-boundary.test.ts):
5
+ // - src/ui/ TIDAK BOLEH mengimpor cli/, src/ non-ui, atau #minicore.
6
+ // - src/ non-ui TIDAK BOLEH mengimpor src/ui/ — komunikasi lewat kontrak ini
7
+ // dan callback yang di-inject dari cli/ (composition root).
8
+ //
9
+ // Semua event kernel dipetakan ke tipe STRUKTURAL di sini. EventBus kernel
10
+ // (#minicore) kompatibel secara struktural dengan UiBus, jadi cli/ bisa
11
+ // menyerahkan bus kernel apa adanya tanpa adapter runtime.
12
+
13
+ export interface UiToolCallRef {
14
+ name: string
15
+ args?: unknown
16
+ }
17
+
18
+ export interface UiStep {
19
+ index: number
20
+ toolCalls: readonly UiToolCallRef[]
21
+ }
22
+
23
+ export interface UiExecution {
24
+ call: UiToolCallRef
25
+ result: { isError?: boolean; content?: unknown }
26
+ }
27
+
28
+ /**
29
+ * Subset event agen yang dikonsumsi lapisan presentasi. Field meniru bentuk
30
+ * payload kernel (flat, ber-`type`) tetapi didefinisikan ulang di sini supaya
31
+ * UI tidak pernah menyentuh tipe vendor.
32
+ */
33
+ export type UiEvent =
34
+ | { type: "turn:started"; turn: number }
35
+ | { type: "turn:completed"; result?: unknown }
36
+ | { type: "step:started"; step: UiStep }
37
+ | { type: "step:completed"; step: UiStep }
38
+ | { type: "execution:started"; execution: UiExecution }
39
+ | { type: "execution:completed"; execution: UiExecution }
40
+ | { type: "provider:text"; text: string }
41
+ | { type: "provider:extension"; kind: string; data: unknown }
42
+ | { type: "context:compacted"; reason: string }
43
+
44
+ export type UiEventType = UiEvent["type"]
45
+
46
+ /**
47
+ * Bus event yang dibaca lapisan presentasi. Handler dilonggarkan ke `any`
48
+ * dengan sengaja: `on` milik EventBus kernel bersifat generik-kondisional, dan
49
+ * versi bertipe ketat (`handler: (event: Extract<UiEvent, {type: K}>) => void`)
50
+ * membuat kernel TIDAK assignable karena kontravariansi parameter. Tiap view
51
+ * menganotasi bentuk payload yang ia render sendiri (lihat assistant/*).
52
+ */
53
+ export interface UiBus {
54
+ on(type: UiEventType, handler: (event: any) => void): () => void
55
+ }
@@ -0,0 +1,105 @@
1
+ // Footer status REPL: 1 baris status (tanpa garis — keputusan clean).
2
+ //
3
+ // Dipakai dua mekanisme dengan KONTEN yang sama: mode cetak (idle, dicetak di
4
+ // atas prompt sebagai scrollback biasa) dan mode lengket (chrome DECSTBM,
5
+ // dilukis di 2 baris dasar terminal: blank + status). Modul ini murni render
6
+ // tanpa IO, tanpa timer, tanpa tahu mekanisme mana yang memakainya. Frame
7
+ // animasi spark dan angka konteks DIKIRIM pemanggil lewat FooterStatus, jadi
8
+ // render tetap deterministik dan bisa diuji tanpa menunggu waktu.
9
+ //
10
+ // Gaya (keputusan produk): footer hampir tak terlihat — garis + teks status
11
+ // abu-abu gelap; SATU-SATUNYA yang berwarna adalah token mode (mapping sama
12
+ // dengan prompt lama: plan kuning, ask biru, sisanya hijau).
13
+ //
14
+ // Tata letak: `✦ mode • model • cwd ……… 14.2k` — konteks rata kanan. Mode
15
+ // di-pad ke lebar tetap agar teks di kanannya TIDAK bergeser saat mode berganti
16
+ // (Shift+Tab): tanpa padding, `auto`→`allowlist` menggeser seluruh baris.
17
+ import { sanitizeAnsi } from "./render/sanitize.ts"
18
+ import { c, glyphs } from "./render/theme.ts"
19
+ import { displayWidth, padToWidth, truncateToWidth } from "./render/width.ts"
20
+
21
+ export interface FooterStatus {
22
+ mode: string
23
+ model: string
24
+ cwd: string
25
+ /** Jumlah konteks polos (mis. "14.2k"). Kosong = tak ditampilkan. */
26
+ context?: string
27
+ /**
28
+ * Frame animasi spark: 0 = idle (spark redup statis), >0 = busy (pulse
29
+ * putih↔abu). Chrome yang menaikkan frame saat turn berjalan; render hanya
30
+ * memetakan frame → glyph berwarna.
31
+ */
32
+ sparkFrame?: number
33
+ }
34
+
35
+ /** Lebar tetap kolom mode — `allowlist`/`allow-all` (9) adalah yang terpanjang. */
36
+ const MODE_WIDTH = 9
37
+
38
+ /** Buang prefix provider (`acme::deepseek-v4` → `deepseek-v4`). */
39
+ export function shortModel(id: string): string {
40
+ const i = id.lastIndexOf("::")
41
+ return i >= 0 ? id.slice(i + 2) : id
42
+ }
43
+
44
+ /**
45
+ * Warna + PAD token mode. Padding dilakukan sebelum pewarnaan supaya lebar
46
+ * kolom mode tetap sama untuk semua mode (anti-geser), sementara warna tetap
47
+ * dipilih dari nama mode asli.
48
+ */
49
+ export function paintFooterMode(mode: string): string {
50
+ // Padding per KOLOM (bukan padEnd karakter): CJK/emoji = 2 kolom, dan
51
+ // displayWidth sudah dipakai di bawah — konsisten satu penggaris.
52
+ const padded = padToWidth(sanitizeAnsi(mode), MODE_WIDTH)
53
+ return mode === "plan" ? c.warning(padded) : mode === "ask" ? c.info(padded) : c.success(padded)
54
+ }
55
+
56
+ /** Spark glyph: redup saat idle, pulse putih↔abu saat busy (frame genap/ganjil). */
57
+ function sparkGlyph(frame: number): string {
58
+ const g = glyphs.thinkingIcon
59
+ if (frame <= 0) return c.faint(g)
60
+ return frame % 2 === 0 ? c.white(g) : c.gray(g)
61
+ }
62
+
63
+ /**
64
+ * Render 1 baris footer untuk lebar `columns` (+ 1 baris kosong di atasnya
65
+ * bila dilukis lengket). Tanpa garis separator — clean (keputusan user).
66
+ * Non-TTY/dimati diputuskan pemanggil (mekanisme), bukan di sini.
67
+ */
68
+ export function renderFooter(s: FooterStatus, columns: number): string[] {
69
+ const cols = Math.max(10, Math.floor(columns) || 80)
70
+
71
+ const spark = sparkGlyph(s.sparkFrame ?? 0)
72
+ const mode = paintFooterMode(s.mode)
73
+ const dot = c.gray("•")
74
+ const sep = ` ${dot} `
75
+ const model = c.gray(sanitizeAnsi(shortModel(s.model)))
76
+ const cwdTxt = c.gray(sanitizeAnsi(s.cwd))
77
+
78
+ const full = `${spark} ${mode}${sep}${model}${sep}${cwdTxt}`
79
+ const mid = `${spark} ${mode}${sep}${model}`
80
+ const lean = `${spark} ${mode}`
81
+
82
+ const target = Math.max(4, cols - 1)
83
+ const ctx = s.context ? sanitizeAnsi(s.context) : ""
84
+ const ctxW = ctx ? displayWidth(ctx) : 0
85
+
86
+ // Rata kanan: konteks didorong ke kolom `target` dengan gap ideal ≥6
87
+ // agar rapi dan tidak mepet (keluhan: terlalu rapat → 1→2→4→6).
88
+ // Bila tak muat, konteks diprioritaskan — kiri dipotong duluan lewat
89
+ // tangga di bawah, bukan konteks yang dilepas.
90
+ const align = (left: string): string => {
91
+ const lw = displayWidth(left)
92
+ if (!ctx) return left
93
+ if (lw + ctxW + 2 > target) return left
94
+ const gap = Math.max(6, target - lw - ctxW)
95
+ return `${left}${" ".repeat(gap)}${c.gray(ctx)}`
96
+ }
97
+
98
+ // Tangga prioritas buang saat sempit: cwd → model (spark+mode+context kekal).
99
+ for (const left of [full, mid, lean]) {
100
+ const line = align(left)
101
+ if (displayWidth(line) <= target) return [line]
102
+ }
103
+ // Bahkan `lean` tak muat (terminal sangat sempit): potong keras.
104
+ return [truncateToWidth(align(lean), target, "…")]
105
+ }