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,247 @@
1
+ import { Buffer } from "node:buffer"
2
+ import { ProviderError } from "#minicore/core/errors.ts"
3
+ import type { ModelProvider, ProviderEvent, StreamRequest } from "#minicore/core/provider.ts"
4
+ import type { Message } from "#minicore/core/types.ts"
5
+ import { LIMITS } from "../constants.ts"
6
+ import type { RateLimiter } from "../policy/ratelimit.ts"
7
+
8
+ export interface RouterConfig {
9
+ providers: ModelProvider[]
10
+ defaultProviderId?: string
11
+ // P2 cap
12
+ maxRetryAfterMs?: number // default LIMITS.RETRY_AFTER_MAX_MS
13
+ // Token bucket rate limiter (opsional) — cegah request beruntun kena 429
14
+ limiter?: RateLimiter
15
+ }
16
+
17
+ // C4 fix: convert Uint8Array tool content to base64 before an openai-compat
18
+ // provider sees it. Anthropic handles Uint8Array natively (image →
19
+ // source.base64 + media_type in toAnthropicMessages) — converting up-front
20
+ // broke that image path, so the fix is applied per-provider below.
21
+ function fixRequest(req: StreamRequest): StreamRequest {
22
+ const messages = req.messages.map((m) => {
23
+ if (m.role === "tool" && (m as unknown as { content: unknown }).content instanceof Uint8Array) {
24
+ const c = (m as unknown as { content: Uint8Array }).content
25
+ return { ...m, content: Buffer.from(c).toString("base64") } as unknown as typeof m
26
+ }
27
+ return m
28
+ })
29
+ return { ...req, messages }
30
+ }
31
+
32
+ function needsBinaryFix(p: ModelProvider): boolean {
33
+ return (p as unknown as { kind?: string }).kind !== "anthropic"
34
+ }
35
+
36
+ // P0 konteks: adapter openai-compat (vendor, frozen) TIDAK mengirim
37
+ // request.system ke wire (buildBody-nya tak membaca field itu), dan bertipe
38
+ // kernel tanpa role "system" (toMessages me-null-kan role tak dikenal).
39
+ // Akibatnya seluruh system prompt (MEMORY, repomap, AGENTS.md, recovery)
40
+ // hilang diam-diam pada semua provider non-Anthropic/non-Responses.
41
+ // Perbaikan di router (satu-satunya seam app-layer sebelum wire): selipkan
42
+ // system sebagai pesan user PERTAMA. Bukan developer/system role (vendor
43
+ // me-null-kan), bukan merge ke user pertama (provenance lebih buruk).
44
+ // Anthropic mengirim system native; Responses diurus via `instructions`
45
+ // di adapter-nya sendiri — keduanya dilewati di sini.
46
+ function needsSystemMessage(p: ModelProvider): boolean {
47
+ const kind = (p as unknown as { kind?: string }).kind
48
+ return kind !== "anthropic" && kind !== "responses"
49
+ }
50
+
51
+ function withSystemMessage(req: StreamRequest): StreamRequest {
52
+ if (!req.system?.trim()) return req
53
+ if (req.messages.length > 0 && (req.messages[0] as { role?: string }).role === "system")
54
+ return req
55
+ return {
56
+ ...req,
57
+ messages: [{ role: "user", content: req.system } as Message, ...req.messages],
58
+ }
59
+ }
60
+
61
+ // Fallback provider mungkin tidak mendukung nama model request asli (mis. gpt-4o
62
+ // dipakai ke Anthropic). Substitusi ke model default provider agar tidak 400.
63
+ // Return model efektif untuk cost attribution.
64
+ function requestFor(
65
+ current: ModelProvider,
66
+ fixed: StreamRequest,
67
+ ): { req: StreamRequest; effectiveModel?: string; substituted: boolean } {
68
+ if (fixed.model && !current.models.includes(fixed.model) && current.models[0]) {
69
+ return {
70
+ req: { ...fixed, model: current.models[0] },
71
+ effectiveModel: current.models[0],
72
+ substituted: true,
73
+ }
74
+ }
75
+ return { req: fixed, substituted: false }
76
+ }
77
+
78
+ export function createRouterProvider(config: RouterConfig): ModelProvider {
79
+ const maxRetry = config.maxRetryAfterMs ?? LIMITS.RETRY_AFTER_MAX_MS
80
+ // byId dan defaultId dihitung per-stream agar provider yang baru ditambah via /provider
81
+ // langsung dikenali tanpa restart. Provider list bisa berubah mid-session.
82
+ const getById = () => new Map(config.providers.map((p) => [p.id, p]))
83
+ const getDefaultId = () => config.defaultProviderId ?? config.providers[0]?.id ?? "router"
84
+ const getModels = () => config.providers.flatMap((p) => [...p.models])
85
+
86
+ const router: ModelProvider & { updateProviders: (list: ModelProvider[]) => void } = {
87
+ id: "router",
88
+ get models() {
89
+ return getModels()
90
+ },
91
+ updateProviders(list: ModelProvider[]) {
92
+ config.providers.splice(0, config.providers.length, ...list)
93
+ },
94
+ async *stream(request: StreamRequest, signal: AbortSignal): AsyncIterable<ProviderEvent> {
95
+ // route by model name — first match wins (default/daftar urutan provider)
96
+ // Format "providerId::modelName" = PIN eksplisit (kontrak): provider itu
97
+ // saja, tanpa fallback lintas provider dan tanpa substitusi diam-diam.
98
+ // Gagal = error jujur dari provider yang dipilih agar user memilih
99
+ // model lanjutannya sendiri (keputusan: no-auto-switch, terutama ke
100
+ // model berbayar). Model bare (tanpa `::`) tetap perilaku lama.
101
+ let target: ModelProvider | undefined
102
+ let model: string | undefined = request.model
103
+ let pinned = false
104
+ if (model?.includes("::")) {
105
+ const sep = model.indexOf("::")
106
+ const pid = model.slice(0, sep)
107
+ const m = model.slice(sep + 2)
108
+ target = getById().get(pid)
109
+ if (!target)
110
+ throw new ProviderError(
111
+ "invalid_request",
112
+ `unknown provider "${pid}" in model "${request.model}" — see: minicode providers`,
113
+ )
114
+ pinned = true
115
+ model = m || undefined
116
+ }
117
+ if (!target && model) {
118
+ for (const p of config.providers)
119
+ if (p.models.includes(model)) {
120
+ target = p
121
+ break
122
+ }
123
+ }
124
+ target ??= getById().get(getDefaultId()) ?? config.providers[0]
125
+ if (!target) throw new ProviderError("unknown", "no provider configured")
126
+
127
+ // Pin: model harus ada di provider itu — bukan substitusi diam-diam
128
+ // (yang dulu melempar user ke model berbayar provider lain).
129
+ if (pinned && model && !target.models.includes(model)) {
130
+ const avail = target.models.slice(0, 8).join(", ")
131
+ const more = target.models.length > 8 ? ` (+${target.models.length - 8} more)` : ""
132
+ throw new ProviderError(
133
+ "invalid_request",
134
+ `model "${model}" not on ${target.id} (${target.models.length} models: ${avail}${more}) — pick one via /model`,
135
+ )
136
+ }
137
+
138
+ // fallback on rate_limit/server/network
139
+ const tried = new Set<string>()
140
+ const retried429For = new Set<string>()
141
+ let current: ModelProvider | undefined = target
142
+ while (current) {
143
+ tried.add(current.id)
144
+ try {
145
+ // rate limit: tunggu token bucket sebelum tiap request
146
+ if (config.limiter) await config.limiter.acquire()
147
+ const fixed = needsBinaryFix(current) ? fixRequest(request) : request
148
+ const withSys = needsSystemMessage(current) ? withSystemMessage(fixed) : fixed
149
+ const { req, effectiveModel, substituted } = requestFor(current, { ...withSys, model })
150
+ if (substituted && effectiveModel) {
151
+ // Tampilkan nama model SETELAH strip prefix `provider::` — versi
152
+ // lama mencetak request.model mentah sehingga terbaca seolah user
153
+ // yang memilih provider fallback ("not on openrouter").
154
+ process.stderr.write(
155
+ `[router] model "${model}" not on ${current.id} → substituting "${effectiveModel}"\n`,
156
+ )
157
+ yield {
158
+ type: "extension",
159
+ kind: "effective-model",
160
+ data: { requested: request.model, effective: effectiveModel, provider: current.id },
161
+ }
162
+ } else if (current !== target) {
163
+ // Fallback provider (non-substitusi) — model sama tapi provider beda.
164
+ // Label spinner/status harus tahu provider mana yang dipakai.
165
+ yield {
166
+ type: "extension",
167
+ kind: "effective-model",
168
+ data: { requested: model, effective: model, provider: current.id },
169
+ }
170
+ }
171
+ for await (const ev of current.stream(req, signal)) {
172
+ yield ev
173
+ }
174
+ return
175
+ } catch (e) {
176
+ if (e instanceof ProviderError) {
177
+ // cap retryAfter without mutating original
178
+ let err: ProviderError = e
179
+ if (e.retryAfterMs != null && e.retryAfterMs > maxRetry) {
180
+ err = new ProviderError(e.category, e.message, maxRetry)
181
+ }
182
+ // P11 P1.3 — honori retry-after. Audit #14: fallback DULU bila ada
183
+ // alternatif — jangan bakar sleep (maks 30 dtk) saat provider
184
+ // berikutnya menganggur; tunggu hanya bila tidak ada alternatif
185
+ // (atau ter-pin), lalu ulangi provider sama di tempat. retried429For
186
+ // mencegah loop: tiap provider hanya pernah menunggu sekali.
187
+ // Sleep abort-aware: Ctrl+C/timeout tidak boleh hang 30 dtk.
188
+ if (
189
+ err.category === "rate_limit" &&
190
+ err.retryAfterMs != null &&
191
+ !retried429For.has(current.id)
192
+ ) {
193
+ retried429For.add(current.id)
194
+ if (!pinned) {
195
+ const next = config.providers.find((p) => !tried.has(p.id))
196
+ if (next) {
197
+ current = next
198
+ continue
199
+ }
200
+ }
201
+ const waitMs = Math.min(err.retryAfterMs, maxRetry)
202
+ if (signal.aborted) throw new DOMException("Aborted", "AbortError")
203
+ let onAbort: (() => void) | undefined
204
+ try {
205
+ await Promise.race([
206
+ Bun.sleep(waitMs),
207
+ new Promise<void>((_, rej) => {
208
+ onAbort = () => rej(new DOMException("Aborted", "AbortError"))
209
+ if (signal.aborted) onAbort()
210
+ else signal.addEventListener("abort", onAbort, { once: true })
211
+ }),
212
+ ])
213
+ } finally {
214
+ if (onAbort) signal.removeEventListener("abort", onAbort)
215
+ }
216
+ // Pin: tetap di provider yang dipilih (tunggu lalu ulangi di
217
+ // tempat) — jangan pindah ke provider lain.
218
+ if (pinned) continue
219
+ // tunggu-di-tempat: ulangi provider sama sekali
220
+ continue
221
+ }
222
+ const canFallback =
223
+ !pinned &&
224
+ (err.category === "server" || err.category === "network") &&
225
+ tried.size < config.providers.length
226
+ // rate_limit tanpa retryAfter → fallback ke provider lain (bakar-daftar hanya bila tanpa retryAfter)
227
+ const canFallbackRateLimit =
228
+ !pinned &&
229
+ err.category === "rate_limit" &&
230
+ err.retryAfterMs == null &&
231
+ tried.size < config.providers.length
232
+ if (canFallback || canFallbackRateLimit) {
233
+ const next = config.providers.find((p) => !tried.has(p.id))
234
+ if (next) {
235
+ current = next
236
+ continue
237
+ }
238
+ }
239
+ throw err
240
+ }
241
+ throw e
242
+ }
243
+ }
244
+ },
245
+ }
246
+ return router as ModelProvider
247
+ }