minicode-ai 0.13.0 → 0.14.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 (83) hide show
  1. package/CHANGELOG.md +23 -0
  2. package/LICENSE +21 -21
  3. package/README.md +4 -0
  4. package/cli/args.ts +50 -2
  5. package/cli/commands/acp.ts +18 -3
  6. package/cli/commands/daemon.ts +114 -19
  7. package/cli/commands/exec.ts +95 -7
  8. package/cli/commands/mcp.ts +66 -5
  9. package/cli/commands/memory.ts +46 -14
  10. package/cli/commands.ts +5 -0
  11. package/cli/index.ts +30 -5
  12. package/cli/minicode.js +6 -0
  13. package/cli/setup.ts +365 -24
  14. package/cli/tui.ts +72 -27
  15. package/docs/TERMINAL_CONTRACT.md +91 -24
  16. package/docs/agents.md +2 -2
  17. package/docs/cli.md +1 -0
  18. package/docs/environment.md +1 -0
  19. package/docs/memory-sessions.md +5 -0
  20. package/package.json +3 -2
  21. package/src/app/session.ts +153 -35
  22. package/src/app/tool-layer.ts +67 -61
  23. package/src/daemon/approvals.ts +25 -1
  24. package/src/daemon/client.ts +51 -1
  25. package/src/daemon/control.ts +8 -0
  26. package/src/daemon/protocol.ts +47 -1
  27. package/src/daemon/server.ts +45 -9
  28. package/src/daemon/subscription.ts +25 -1
  29. package/src/daemon/telemetry.ts +4 -0
  30. package/src/hooks/run.ts +5 -1
  31. package/src/mcp/client.ts +349 -90
  32. package/src/mcp/http-transport.ts +7 -0
  33. package/src/mcp/transport.ts +5 -0
  34. package/src/memory/files.ts +69 -3
  35. package/src/memory/vector.ts +556 -160
  36. package/src/policy/approval-binding.ts +199 -0
  37. package/src/policy/context.ts +20 -1
  38. package/src/policy/executor.ts +44 -5
  39. package/src/policy/permission.ts +243 -26
  40. package/src/policy/tool-contract.ts +77 -0
  41. package/src/policy/usage.ts +3 -1
  42. package/src/policy/work-mode.ts +49 -1
  43. package/src/presentation/adapter.ts +157 -7
  44. package/src/presentation/events.ts +173 -1
  45. package/src/presentation/model.ts +37 -0
  46. package/src/presentation/projection.ts +107 -18
  47. package/src/presentation/reducer.ts +134 -10
  48. package/src/sandbox/os.ts +18 -1
  49. package/src/session/persistence.ts +153 -11
  50. package/src/task/store.ts +43 -3
  51. package/src/tools/memory.ts +70 -10
  52. package/src/tools/task.ts +7 -1
  53. package/src/tools/todo.ts +14 -4
  54. package/src/ui/approval/prompt.ts +52 -7
  55. package/src/ui/assistant/simple.ts +160 -57
  56. package/src/ui/contract.ts +46 -0
  57. package/src/ui/footer.ts +14 -5
  58. package/src/ui/i18n/en.ts +9 -0
  59. package/src/ui/i18n/id.ts +9 -0
  60. package/src/ui/render/collapse.ts +24 -52
  61. package/src/ui/render/detail.ts +14 -9
  62. package/src/ui/render/errors.ts +8 -0
  63. package/src/ui/render/reasoning.ts +13 -8
  64. package/src/ui/session-state.ts +243 -0
  65. package/src/ui/tui/app.ts +7 -3
  66. package/src/ui/tui/transcript.ts +271 -30
  67. package/vendor/minicore/src/core/budget.ts +25 -25
  68. package/vendor/minicore/src/core/compact.ts +75 -75
  69. package/vendor/minicore/src/core/errors.ts +59 -59
  70. package/vendor/minicore/src/core/events.ts +73 -73
  71. package/vendor/minicore/src/core/executor.ts +139 -139
  72. package/vendor/minicore/src/core/history.ts +31 -31
  73. package/vendor/minicore/src/core/index.ts +41 -41
  74. package/vendor/minicore/src/core/loop.ts +355 -355
  75. package/vendor/minicore/src/core/permission.ts +22 -22
  76. package/vendor/minicore/src/core/provider.ts +39 -39
  77. package/vendor/minicore/src/core/recovery.ts +35 -35
  78. package/vendor/minicore/src/core/session.ts +327 -327
  79. package/vendor/minicore/src/core/snapshot.ts +146 -146
  80. package/vendor/minicore/src/core/tokens.ts +107 -107
  81. package/vendor/minicore/src/core/tool.ts +115 -115
  82. package/vendor/minicore/src/core/types.ts +50 -50
  83. package/vendor/minicore/src/providers/openai-compat.ts +417 -417
@@ -0,0 +1,199 @@
1
+ // [Area B · PROMPT 06] Pengikatan persetujuan ↔ operasi yang BENAR-BENAR
2
+ // dieksekusi.
3
+ //
4
+ // Masalah yang ditutup: `edit`/`apply_patch` MEMBACA ULANG file saat eksekusi,
5
+ // sementara preview yang dilihat user berasal dari state SAAT approval. Bila
6
+ // file berubah di antara keduanya (proses lain, tool paralel, sub-agent),
7
+ // operasi yang dijalankan bukan yang disetujui — persetujuan jadi basi.
8
+ //
9
+ // Mekanisme (dua titik, satu objek state):
10
+ // · CAPTURE (sebelum prompt): sidik jari argumen (SHA-256 kanonis) + isi file
11
+ // target — "apa yang dilihat user".
12
+ // · GRANT (setelah user setuju): simpan sidik jari itu untuk operasi ini saja.
13
+ // · VERIFY (batas eksekusi): hitung ulang; beda ⇒ basi ⇒ TOLAK (fail-closed).
14
+ //
15
+ // Kenapa verifikasi di barrier efek (`src/app/session.ts` `beforeToolEffect`):
16
+ // antara `permissions.check()` dan `tool.execute` kernel hanya menjalankan
17
+ // langkah sinkron, TAPI aplikasi menambah await (intent jurnal + no-progress)
18
+ // di dalam handler. Barrier adalah titik terakhir sesudah semua await itu dan
19
+ // sebelum "allow" kembali ke kernel — efektif batas eksekusi, tanpa membungkus
20
+ // tool (yang merusak identitas array tool live milik WorkMode).
21
+ //
22
+ // Lapis pertama diverifikasi SAAT user menyetujui supaya persetujuan basi
23
+ // ditolak sebelum intent jurnal ditulis.
24
+ //
25
+ // Batas jujur: efek `bash` tak bisa difingerprint — yang terikat hanya
26
+ // argumennya. Pada `always`/allowlist tak ada prompt ⇒ tak ada grant yang bisa
27
+ // diverifikasi untuk call berikutnya; grant tetap dibuat untuk call berjalan.
28
+
29
+ import { createHash } from "node:crypto"
30
+ import { readFileSync, statSync } from "node:fs"
31
+ import { resolve } from "node:path"
32
+ import { canonicalArgsHash } from "./no-progress.ts"
33
+
34
+ /** Tool yang TARGET-nya file di workspace — satu-satunya yang bisa di-fingerprint. */
35
+ const FILE_TARGET_TOOLS = new Set(["write_file", "edit", "apply_patch", "delete_file", "move_file"])
36
+
37
+ /**
38
+ * Batas fingerprint KONTEN. File lebih besar dari ini di-fingerprint lewat
39
+ * size+mtime (bukan hash isi): approval untuk file raksasa tetap bisa
40
+ * dideteksi berubah, tanpa membaca ratusan MB dua kali per prompt.
41
+ */
42
+ export const MAX_CONTENT_FINGERPRINT_BYTES = 2 * 1024 * 1024
43
+
44
+ /** Sidik jari "file tidak ada" — BEDA dari hash file kosong. */
45
+ export const MISSING_TARGET = "missing"
46
+ /** Sidik jari "path ada tapi bukan file biasa" (mis. direktori). */
47
+ export const NOT_A_FILE = "not-a-file"
48
+
49
+ /** Sidik jari satu target file. */
50
+ export interface ApprovalTarget {
51
+ /** Path absolut target. */
52
+ readonly path: string
53
+ /** Hash isi (file kecil) / size+mtime (file besar) / MISSING_TARGET. */
54
+ readonly fingerprint: string
55
+ }
56
+
57
+ /** Bukti persetujuan untuk SATU operasi. */
58
+ export interface ApprovalBinding {
59
+ /** Nama tool yang disetujui. */
60
+ readonly tool: string
61
+ /** SHA-256 argumen kanonis (identik dengan `hashArgs`/`canonicalArgsHash`). */
62
+ readonly argsHash: string
63
+ /** Target file yang jadi bukti (kosong untuk tool tanpa target file). */
64
+ readonly targets: readonly ApprovalTarget[]
65
+ }
66
+
67
+ /**
68
+ * Path absolut target file untuk tool tertentu.
69
+ *
70
+ * `move_file` punya DUA ujung (from + to): keduanya jadi bukti, karena
71
+ * perubahan salah satu ujung mengubah operasi yang disetujui.
72
+ */
73
+ export function approvalTargetPaths(tool: string, args: unknown, root: string): string[] {
74
+ if (!FILE_TARGET_TOOLS.has(tool)) return []
75
+ const a = (args ?? {}) as Record<string, unknown>
76
+ const str = (v: unknown): string => (typeof v === "string" ? v : "")
77
+ if (tool === "move_file") {
78
+ const from = str(a.from)
79
+ const to = str(a.to)
80
+ return [from, to].filter((p) => p !== "").map((p) => resolve(root, p))
81
+ }
82
+ const p = str(a.path)
83
+ return p ? [resolve(root, p)] : []
84
+ }
85
+
86
+ /** Sidik jari target saat ini (hash isi / size+mtime / marker). */
87
+ export function fingerprintTarget(path: string): string {
88
+ try {
89
+ const st = statSync(path)
90
+ if (!st.isFile()) return NOT_A_FILE
91
+ if (st.size > MAX_CONTENT_FINGERPRINT_BYTES)
92
+ return `size:${st.size}:mtime:${Math.trunc(st.mtimeMs)}`
93
+ return createHash("sha256").update(readFileSync(path)).digest("hex")
94
+ } catch {
95
+ // Tidak ada / tak bisa dibaca = "missing" (bukan hash kosong).
96
+ return MISSING_TARGET
97
+ }
98
+ }
99
+
100
+ /**
101
+ * TANGKAP bukti persetujuan — dipanggil SEBELUM prompt.
102
+ *
103
+ * Ini adalah "apa yang dilihat user": argumen + isi file target pada saat
104
+ * preview dibuat. Menangkap SEBELUM prompt penting: prompt bisa berjalan
105
+ * lama (user berpikir), dan kalau sidik jari diambil SETELAH prompt kita
106
+ * memverifikasi state yang tidak pernah dilihat user.
107
+ */
108
+ export function captureApprovalBinding(tool: string, args: unknown, root: string): ApprovalBinding {
109
+ return {
110
+ tool,
111
+ argsHash: canonicalArgsHash(args),
112
+ targets: approvalTargetPaths(tool, args, root).map((path) => ({
113
+ path,
114
+ fingerprint: fingerprintTarget(path),
115
+ })),
116
+ }
117
+ }
118
+
119
+ /**
120
+ * Hasil verifikasi binding terhadap state target saat ini.
121
+ * `stale` = operasi yang disetujui tak lagi berlaku (fail-closed).
122
+ */
123
+ export type BindingVerdict =
124
+ | { kind: "ok" }
125
+ | { kind: "no-binding" }
126
+ | { kind: "stale"; reason: string }
127
+
128
+ /**
129
+ * Verifikasi binding approval terhadap state file target saat ini.
130
+ *
131
+ * `no-binding` = tak ada persetujuan yang tercatat untuk operasi ini (mis.
132
+ * mode auto/allowlist, atau handler permission terinjeksi) → tak ada yang bisa
133
+ * diverifikasi, dan tidak ada bukti basi → biarkan lewat.
134
+ */
135
+ export function verifyApprovalBinding(binding: ApprovalBinding | undefined): BindingVerdict {
136
+ if (!binding) return { kind: "no-binding" }
137
+ if (binding.targets.length === 0) return { kind: "ok" }
138
+ for (const t of binding.targets) {
139
+ const now = fingerprintTarget(t.path)
140
+ if (now === t.fingerprint) continue
141
+ return {
142
+ kind: "stale",
143
+ reason:
144
+ now === MISSING_TARGET
145
+ ? `target ${t.path} tidak ada lagi (hilang sejak approval)`
146
+ : `target ${t.path} berubah sejak approval — approval basi, minta ulang`,
147
+ }
148
+ }
149
+ return { kind: "ok" }
150
+ }
151
+
152
+ /**
153
+ * Penyimpanan binding persetujuan milik SATU sesi.
154
+ *
155
+ * Per-sesi, bukan global: dua sesi dalam satu proses tak boleh memakai
156
+ * bukti persetujuan milik satu sama lain (Area A — isolasi instance).
157
+ */
158
+ export class ApprovalBindingStore {
159
+ readonly root: string
160
+ /** Antre per (tool, argsHash) — FIFO agar urut grant = urut eksekusi. */
161
+ readonly #pending = new Map<string, ApprovalBinding[]>()
162
+
163
+ constructor(root: string) {
164
+ this.root = root
165
+ }
166
+
167
+ static key(tool: string, argsHash: string): string {
168
+ return `${tool}\u0000${argsHash}`
169
+ }
170
+
171
+ /** Catat persetujuan yang sudah diberikan user (SETELAH prompt selesai). */
172
+ grant(binding: ApprovalBinding): void {
173
+ const k = ApprovalBindingStore.key(binding.tool, binding.argsHash)
174
+ const arr = this.#pending.get(k)
175
+ if (arr) arr.push(binding)
176
+ else this.#pending.set(k, [binding])
177
+ }
178
+
179
+ /** Ambil satu binding untuk (tool, argsHash) — consume-once. */
180
+ take(tool: string, argsHash: string): ApprovalBinding | undefined {
181
+ const k = ApprovalBindingStore.key(tool, argsHash)
182
+ const arr = this.#pending.get(k)
183
+ if (!arr || arr.length === 0) return undefined
184
+ const first = arr.shift()!
185
+ if (arr.length === 0) this.#pending.delete(k)
186
+ return first
187
+ }
188
+
189
+ /** Jumlah binding yang masih tertunda (diagnostik/test). */
190
+ get size(): number {
191
+ let n = 0
192
+ for (const arr of this.#pending.values()) n += arr.length
193
+ return n
194
+ }
195
+
196
+ clear(): void {
197
+ this.#pending.clear()
198
+ }
199
+ }
@@ -82,11 +82,30 @@ export function createCalibratedEstimator(opts: { maxFactor?: number } = {}): Ca
82
82
  // (estimer vs provider aktual). Idempoten dan konservatif: factor tidak
83
83
  // pernah < 1, sehingga estimasi lokal tidak pernah dilemahkan; hanya naik
84
84
  // proporsional saat aktual > estimasi (mencegah under-budget kompaksi).
85
+ //
86
+ // [Live Hardening 0.13.x] Gerbang anti-sampel in-flight: selama turn berjalan
87
+ // host-visible `state.history` SENGAJA basi (kernel menulis ke turnStore
88
+ // privat dan menggabungkannya saat turn selesai), sementara beberapa gateway
89
+ // mengirim `usage` progresif-kumulatif per-chunk SSE. Sampel "actual naik,
90
+ // local beku" adalah artefak penghitungan intra-request — bukan drift
91
+ // tokenizer — dan sampel jauh di atas baseline lokal yang beku (actual >
92
+ // local × 3) bisa membangkaskan factor secara global (uji live tiprouter:
93
+ // local=5026 beku sementara input merambat 6413 → 28024 = 5.58× → seluruh
94
+ // estimasi konteks terinflasi → kompaksi palsu → turn dibunuh
95
+ // `context window exceeded after compaction`). Sampel demikian DIKIP yang
96
+ // merusak factor; drift nyata lintas-turn (local berubah setelah merge) dan
97
+ // drift CJK/tokenizer kecil (≤ ~2.5×, contoh pin: 100→180) tetap
98
+ // terkalibrasi normal. Batas cap 64 DIPERTAHANKAN (kontrak pin p15
99
+ // CTX-03: factor butuh headroom hingga ~33× bila estimasi lokal jauh
100
+ // lebih kecil dari prompt nyata system+schema).
85
101
  const applyCalibration = (local: number, actual: number): void => {
102
+ // Sampel dikhianati bila local TIDAK bergerak antar sampel (artefak
103
+ // in-flight) DAN actual melampaui 3× baseline lokal yang beku.
104
+ const inFlightSample = lastLocal !== null && local === lastLocal && actual > lastLocal * 3
86
105
  lastLocal = local > 0 ? Math.ceil(local) : null
87
106
  lastActual = actual > 0 ? Math.ceil(actual) : null
88
107
  drift = (lastActual ?? 0) - (lastLocal ?? 0)
89
- if (local > 0 && actual > 0) {
108
+ if (local > 0 && actual > 0 && !inFlightSample) {
90
109
  const observedRatio = actual / local
91
110
  factor = Math.min(maxFactor, Math.max(1, observedRatio))
92
111
  }
@@ -6,7 +6,7 @@ import type { ToolCall, ToolResult } from "#minicore/core/types.ts"
6
6
  import { LIMITS } from "../constants.ts"
7
7
  // [Fase 2 / TOOL-01] Klasifikasi konkurensi diturunkan dari SATU registry
8
8
  // kontrak tool — dulu dua Set manual di file ini yang bisa menyimpang.
9
- import { EXCLUSIVE_TOOLS, WRITE_TOOLS } from "./tool-contract.ts"
9
+ import { contractForTool, EXCLUSIVE_TOOLS, WRITE_TOOLS } from "./tool-contract.ts"
10
10
 
11
11
  function isWrite(call: ToolCall): boolean {
12
12
  return WRITE_TOOLS.has(call.name) || EXCLUSIVE_TOOLS.has(call.name)
@@ -87,9 +87,46 @@ export function parallelExecutor(
87
87
 
88
88
  async function runBatch(
89
89
  calls: readonly ToolCall[],
90
- deps: ExecutorDeps,
90
+ rawDeps: ExecutorDeps,
91
91
  ): Promise<readonly ToolResult[]> {
92
92
  if (calls.length === 0) return []
93
+ // P0.2 (G1 / Invariant #7): `createToolRegistry` vendor membekukan Map pada
94
+ // saat sesi dibuat sementara `list()` membaca array `visible` yang dimutasi
95
+ // in-place oleh `setWorkMode` / `setPermissionMode`. Resolusi live dari
96
+ // `list()` memastikan `callable === visible` di kedua arah transisi
97
+ // (DISCUSS→EXECUTE membuka tool tulis; EXECUTE→DISCUSS menutupnya).
98
+ const liveRegistry =
99
+ typeof rawDeps.registry.list === "function"
100
+ ? {
101
+ list: () => rawDeps.registry.list(),
102
+ get: (name: string) => rawDeps.registry.list().find((t) => t.name === name),
103
+ }
104
+ : rawDeps.registry
105
+ const getLiveWorkMode = (rawDeps.permissions as { __getWorkMode?: () => string } | undefined)
106
+ ?.__getWorkMode
107
+ const baseDeps: ExecutorDeps = { ...rawDeps, registry: liveRegistry }
108
+ // P0.2 (G-MEM-TRACK / Invariant #2 & #3): saat WorkMode DISCUSS atau PLAN,
109
+ // `read_memory` menerima `permissionMode: "readonly"` per-sesi agar tidak
110
+ // menaikkan `access_count` di SQLite walau PermissionMode dasar `auto`.
111
+ const depsFor = (call: ToolCall): ExecutorDeps => {
112
+ if (call.name === "read_memory") {
113
+ if (typeof getLiveWorkMode === "function") {
114
+ const wm = getLiveWorkMode.call(rawDeps.permissions)
115
+ if (wm === "DISCUSS" || wm === "PLAN") {
116
+ return { ...baseDeps, permissionMode: "readonly" }
117
+ }
118
+ }
119
+ const listed = typeof rawDeps.registry.list === "function" ? rawDeps.registry.list() : []
120
+ if (
121
+ listed.length > 0 &&
122
+ listed.every((t) => contractForTool(t.name)?.sideEffectTier === "PURE_READ")
123
+ ) {
124
+ return { ...baseDeps, permissionMode: "readonly" }
125
+ }
126
+ }
127
+ return baseDeps
128
+ }
129
+ const deps = baseDeps
93
130
  const results: (ToolResult | undefined)[] = new Array(calls.length)
94
131
 
95
132
  // write+baca campur → sekuensial urut input: read setelah write pada file
@@ -100,7 +137,8 @@ export function parallelExecutor(
100
137
  if (anyWrite && anyRead) {
101
138
  for (let i = 0; i < calls.length; i++) {
102
139
  if (deps.signal.aborted) throw abortError(deps.signal)
103
- results[i] = await runCall(calls[i]!, deps)
140
+ const c = calls[i]!
141
+ results[i] = await runCall(c, depsFor(c))
104
142
  }
105
143
  return results as ToolResult[]
106
144
  }
@@ -129,7 +167,8 @@ export function parallelExecutor(
129
167
  (async () => {
130
168
  for (let i = 0; i < calls.length; i++) {
131
169
  if (signal.aborted) throw abortError(signal)
132
- results[i] = await runCall(calls[i]!, deps)
170
+ const c = calls[i]!
171
+ results[i] = await runCall(c, depsFor(c))
133
172
  }
134
173
  })(),
135
174
  aborted,
@@ -225,7 +264,7 @@ export function parallelExecutor(
225
264
  throw e
226
265
  }
227
266
  }
228
- const res = await runCall(call, deps)
267
+ const res = await runCall(call, depsFor(call))
229
268
  results[idx] = res
230
269
  } finally {
231
270
  if (held) {