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.
- package/CHANGELOG.md +23 -0
- package/LICENSE +21 -21
- package/README.md +4 -0
- package/cli/args.ts +50 -2
- package/cli/commands/acp.ts +18 -3
- package/cli/commands/daemon.ts +114 -19
- package/cli/commands/exec.ts +95 -7
- package/cli/commands/mcp.ts +66 -5
- package/cli/commands/memory.ts +46 -14
- package/cli/commands.ts +5 -0
- package/cli/index.ts +30 -5
- package/cli/minicode.js +6 -0
- package/cli/setup.ts +365 -24
- package/cli/tui.ts +72 -27
- package/docs/TERMINAL_CONTRACT.md +91 -24
- package/docs/agents.md +2 -2
- package/docs/cli.md +1 -0
- package/docs/environment.md +1 -0
- package/docs/memory-sessions.md +5 -0
- package/package.json +3 -2
- package/src/app/session.ts +153 -35
- package/src/app/tool-layer.ts +67 -61
- package/src/daemon/approvals.ts +25 -1
- package/src/daemon/client.ts +51 -1
- package/src/daemon/control.ts +8 -0
- package/src/daemon/protocol.ts +47 -1
- package/src/daemon/server.ts +45 -9
- package/src/daemon/subscription.ts +25 -1
- package/src/daemon/telemetry.ts +4 -0
- package/src/hooks/run.ts +5 -1
- package/src/mcp/client.ts +349 -90
- package/src/mcp/http-transport.ts +7 -0
- package/src/mcp/transport.ts +5 -0
- package/src/memory/files.ts +69 -3
- package/src/memory/vector.ts +556 -160
- package/src/policy/approval-binding.ts +199 -0
- package/src/policy/context.ts +20 -1
- package/src/policy/executor.ts +44 -5
- package/src/policy/permission.ts +243 -26
- package/src/policy/tool-contract.ts +77 -0
- package/src/policy/usage.ts +3 -1
- package/src/policy/work-mode.ts +49 -1
- package/src/presentation/adapter.ts +157 -7
- package/src/presentation/events.ts +173 -1
- package/src/presentation/model.ts +37 -0
- package/src/presentation/projection.ts +107 -18
- package/src/presentation/reducer.ts +134 -10
- package/src/sandbox/os.ts +18 -1
- package/src/session/persistence.ts +153 -11
- package/src/task/store.ts +43 -3
- package/src/tools/memory.ts +70 -10
- package/src/tools/task.ts +7 -1
- package/src/tools/todo.ts +14 -4
- package/src/ui/approval/prompt.ts +52 -7
- package/src/ui/assistant/simple.ts +160 -57
- package/src/ui/contract.ts +46 -0
- package/src/ui/footer.ts +14 -5
- package/src/ui/i18n/en.ts +9 -0
- package/src/ui/i18n/id.ts +9 -0
- package/src/ui/render/collapse.ts +24 -52
- package/src/ui/render/detail.ts +14 -9
- package/src/ui/render/errors.ts +8 -0
- package/src/ui/render/reasoning.ts +13 -8
- package/src/ui/session-state.ts +243 -0
- package/src/ui/tui/app.ts +7 -3
- package/src/ui/tui/transcript.ts +271 -30
- package/vendor/minicore/src/core/budget.ts +25 -25
- package/vendor/minicore/src/core/compact.ts +75 -75
- package/vendor/minicore/src/core/errors.ts +59 -59
- package/vendor/minicore/src/core/events.ts +73 -73
- package/vendor/minicore/src/core/executor.ts +139 -139
- package/vendor/minicore/src/core/history.ts +31 -31
- package/vendor/minicore/src/core/index.ts +41 -41
- package/vendor/minicore/src/core/loop.ts +355 -355
- package/vendor/minicore/src/core/permission.ts +22 -22
- package/vendor/minicore/src/core/provider.ts +39 -39
- package/vendor/minicore/src/core/recovery.ts +35 -35
- package/vendor/minicore/src/core/session.ts +327 -327
- package/vendor/minicore/src/core/snapshot.ts +146 -146
- package/vendor/minicore/src/core/tokens.ts +107 -107
- package/vendor/minicore/src/core/tool.ts +115 -115
- package/vendor/minicore/src/core/types.ts +50 -50
- package/vendor/minicore/src/providers/openai-compat.ts +417 -417
package/src/policy/permission.ts
CHANGED
|
@@ -1,9 +1,20 @@
|
|
|
1
1
|
import { resolve } from "node:path"
|
|
2
2
|
import { cwd } from "node:process"
|
|
3
3
|
import type { PermissionHandler, ToolCall } from "#minicore"
|
|
4
|
-
import type {
|
|
4
|
+
import type {
|
|
5
|
+
ApprovalEventHook,
|
|
6
|
+
ApprovalHookEvent,
|
|
7
|
+
SideEffectTierDisplay,
|
|
8
|
+
} from "../presentation/events.ts"
|
|
5
9
|
import { isMcpToolName } from "../presentation/label.ts"
|
|
6
10
|
import { loadAllowlist, matchAllowlist, saveAllowlist } from "./allowlist.ts"
|
|
11
|
+
// [Area B · PROMPT 06] Binding persetujuan ↔ operasi yang dieksekusi.
|
|
12
|
+
import {
|
|
13
|
+
type ApprovalBinding,
|
|
14
|
+
type ApprovalBindingStore,
|
|
15
|
+
captureApprovalBinding,
|
|
16
|
+
verifyApprovalBinding,
|
|
17
|
+
} from "./approval-binding.ts"
|
|
7
18
|
import { inspectBashCommand } from "./bash-guard.ts"
|
|
8
19
|
import {
|
|
9
20
|
isCwdOutsideRoot,
|
|
@@ -14,6 +25,9 @@ import {
|
|
|
14
25
|
isSensitive,
|
|
15
26
|
isTrashRestore,
|
|
16
27
|
} from "./jail.ts"
|
|
28
|
+
import { scrubSecrets } from "./scrub.ts"
|
|
29
|
+
// [Fase 2 / TOOL-01] Diimpor dari registry kontrak tool (satu sumber).
|
|
30
|
+
import { contractForTool, GATED_TOOLS, READONLY_TOOL_NAMES } from "./tool-contract.ts"
|
|
17
31
|
|
|
18
32
|
export type PermissionMode = "auto" | "readonly" | "plan" | "allow-all" | "ask" | "allowlist"
|
|
19
33
|
|
|
@@ -28,28 +42,33 @@ export type PermissionAsk = (call: {
|
|
|
28
42
|
args?: unknown
|
|
29
43
|
/** [Fase 2 / LOOP-INV-08] Identitas pemanggilan untuk pengikatan approval. */
|
|
30
44
|
id?: string
|
|
45
|
+
/** F-APPROVAL-1: tier risiko efek samping (dari kontrak tool). */
|
|
46
|
+
riskTier?: SideEffectTierDisplay
|
|
47
|
+
/** F-APPROVAL-1: pratinjau diff ringkas (sudah di-scrub secret). */
|
|
48
|
+
diffPreview?: string
|
|
49
|
+
/** P1.2: `always` tersedia hanya bila args dapat dipersist (≤ 2 KB JSON). */
|
|
50
|
+
canAlways?: boolean
|
|
31
51
|
}) => Promise<"allow" | "deny" | "always">
|
|
32
52
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
])
|
|
53
|
+
/** Batas args yang boleh dipersist sebagai grant `always` (fail-closed). */
|
|
54
|
+
const MAX_ALWAYS_ARGS_JSON = 2000
|
|
55
|
+
|
|
56
|
+
/** P1.2: satu sumber kebenaran untuk ketersediaan opsi `always`. */
|
|
57
|
+
export function canPersistAlways(args: unknown): boolean {
|
|
58
|
+
try {
|
|
59
|
+
return JSON.stringify(args).length <= MAX_ALWAYS_ARGS_JSON
|
|
60
|
+
} catch {
|
|
61
|
+
return false
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
// [Fase 2 / TOOL-01] Satu sumber kebenaran: `READONLY_TOOLS` kini diturunkan
|
|
66
|
+
// dari registry kontrak tool (`allowedInReadonly`) — bukan lagi daftar manual
|
|
67
|
+
// yang bisa menyimpang dari `tool-contract.ts`. Menambah/mengganti tool read
|
|
68
|
+
// berarti mengubah `allowedInReadonly` di registry; tidak ada daftar kedua
|
|
69
|
+
// untuk lupa. Membership (termasuk in/out `web_fetch`/`web_search`) dipegang
|
|
70
|
+
// test no-drift di p15-phase2-contracts-approval-recovery.test.ts.
|
|
71
|
+
const READONLY_TOOLS: ReadonlySet<string> = READONLY_TOOL_NAMES
|
|
53
72
|
// Tool yang menulis state internal minicode (bukan file workspace) — aman
|
|
54
73
|
// di semua mode kecuali readonly/plan. `bash_kill` menghentikan proses yang
|
|
55
74
|
// dimulai agent sendiri, jadi tidak menambah permukaan serangan.
|
|
@@ -84,8 +103,6 @@ const NO_PROMPT_TOOLS = new Set(["todo_write", "submit_result", "bash_output", "
|
|
|
84
103
|
// `ask_user` di-gate: model yang bisa bertanya tanpa batas bisa membanjiri
|
|
85
104
|
// user (atau memancing jawaban kredensial) — persetujuan sekali per sesi
|
|
86
105
|
// via `[a] Always` tetap tersedia.
|
|
87
|
-
// [Fase 2 / TOOL-01] Diimpor dari registry kontrak tool (satu sumber).
|
|
88
|
-
import { GATED_TOOLS } from "./tool-contract.ts"
|
|
89
106
|
|
|
90
107
|
// Denylist bash kini di src/policy/bash-guard.ts — pemeriksaan dilakukan pada
|
|
91
108
|
// bentuk TERNORMALISASI (quote dibuang, variabel sederhana disubstitusi), bukan
|
|
@@ -157,6 +174,112 @@ function matchBashAllowlist(cmd: string, pattern: string): boolean {
|
|
|
157
174
|
return re.test(trimmed)
|
|
158
175
|
}
|
|
159
176
|
|
|
177
|
+
// F-APPROVAL-1: pratinjau diff ringkas + representatif (satu baris) untuk kartu
|
|
178
|
+
// approval. Dikomputasi di policy — satu-satunya lapisan yang BOLEH memakai
|
|
179
|
+
// scrubSecrets (view tidak boleh impor src/policy). Bentuknya dipilih per-tool
|
|
180
|
+
// agar menggambarkan operasi NYATA (bash → perintah, tulis/edit → path + isi
|
|
181
|
+
// baru, hapus/pindah → tujuan, commit → pesan), bukan "ringkasan pendek" fiktif.
|
|
182
|
+
// Semua teks dibasuh secret; kegagalan apa pun = undefined (preview hanyalah
|
|
183
|
+
// informasi tambahan, bukan jalur keputusan gate).
|
|
184
|
+
function buildDiffPreview(name: string, args: unknown): string | undefined {
|
|
185
|
+
if (args === undefined || args === null) return undefined
|
|
186
|
+
const a = typeof args === "object" ? (args as Record<string, unknown>) : {}
|
|
187
|
+
const str = (v: unknown): string => (typeof v === "string" ? v : "")
|
|
188
|
+
const line = (v: unknown, max = 120): string => {
|
|
189
|
+
const s = typeof v === "string" ? v : String(v ?? "")
|
|
190
|
+
const first = s.split(/\r?\n/)[0] ?? ""
|
|
191
|
+
return first.length > max ? `${first.slice(0, max)}…` : first
|
|
192
|
+
}
|
|
193
|
+
const text = (content: unknown): string => {
|
|
194
|
+
if (typeof content === "string") return content
|
|
195
|
+
if (Array.isArray(content))
|
|
196
|
+
return content
|
|
197
|
+
.map((c) =>
|
|
198
|
+
typeof c === "string"
|
|
199
|
+
? c
|
|
200
|
+
: c && typeof c === "object" && "text" in c
|
|
201
|
+
? String((c as { text?: unknown }).text ?? "")
|
|
202
|
+
: "",
|
|
203
|
+
)
|
|
204
|
+
.filter(Boolean)
|
|
205
|
+
.join("\n")
|
|
206
|
+
if (content && typeof content === "object" && "text" in content)
|
|
207
|
+
return String((content as { text?: unknown }).text ?? "")
|
|
208
|
+
return ""
|
|
209
|
+
}
|
|
210
|
+
// Basuh secret SEKALI di jalur keluar — path pun bisa memuat token; preview
|
|
211
|
+
// tak pernah boleh membocorkannya ke kartu UI.
|
|
212
|
+
const out = (raw: string): string | undefined => {
|
|
213
|
+
const s = scrubSecrets(raw.trim()).trim()
|
|
214
|
+
return s ? s.slice(0, 300) : undefined
|
|
215
|
+
}
|
|
216
|
+
try {
|
|
217
|
+
switch (name) {
|
|
218
|
+
case "bash": {
|
|
219
|
+
const cmd = (str(a.cmd) || str(a.command)).trim()
|
|
220
|
+
return cmd ? out(`$ ${cmd}`) : undefined
|
|
221
|
+
}
|
|
222
|
+
case "write_file": {
|
|
223
|
+
const p = str(a.path)
|
|
224
|
+
const head = line(text(a.content))
|
|
225
|
+
return p ? out(`→ ${p}${head ? ` · ${head}` : ""}`) : undefined
|
|
226
|
+
}
|
|
227
|
+
case "edit": {
|
|
228
|
+
const p = str(a.path)
|
|
229
|
+
// Skema NYATA tool `edit` = `oldString`/`newString` (src/tools/edit.ts:133-142).
|
|
230
|
+
// `old_string`/`new_string` dipakai sebagai fallback legacy — bukan
|
|
231
|
+
// sebagai nama utama: memakai yang salah membuat preview kosong
|
|
232
|
+
// (menampilkan "hanya path") untuk operasi yang sebenarnya mengganti
|
|
233
|
+
// blok kode tertentu.
|
|
234
|
+
const oldv = line(str(a.oldString ?? a.old_string), 80)
|
|
235
|
+
const newv = line(str(a.newString ?? a.new_string), 80)
|
|
236
|
+
const delta = `${oldv ? ` -${oldv}` : ""}${newv ? ` +${newv}` : ""}`
|
|
237
|
+
return p ? out(`→ ${p}${delta}`) : undefined
|
|
238
|
+
}
|
|
239
|
+
case "apply_patch": {
|
|
240
|
+
const p = str(a.path)
|
|
241
|
+
// Skema NYATA tool `apply_patch` = `patches: [{search, replace}]`
|
|
242
|
+
// (src/tools/patch.ts:18-35) — BUKAN `patch`/`diff`.
|
|
243
|
+
const patches = Array.isArray(a.patches)
|
|
244
|
+
? (a.patches as { search?: unknown; replace?: unknown }[])
|
|
245
|
+
: []
|
|
246
|
+
if (patches.length > 0) {
|
|
247
|
+
const first = patches[0] ?? {}
|
|
248
|
+
const oldv = line(str(first.search), 80)
|
|
249
|
+
const newv = line(str(first.replace), 80)
|
|
250
|
+
const more = patches.length > 1 ? ` (+${patches.length - 1} blok)` : ""
|
|
251
|
+
const delta = `${oldv ? ` -${oldv}` : ""}${newv ? ` +${newv}` : ""}`
|
|
252
|
+
return p ? out(`→ ${p}${delta}${more}`) : undefined
|
|
253
|
+
}
|
|
254
|
+
const head = line(text(a.patch ?? a.diff))
|
|
255
|
+
return p ? out(`→ ${p}${head ? ` · ${head}` : ""}`) : undefined
|
|
256
|
+
}
|
|
257
|
+
case "delete_file":
|
|
258
|
+
return str(a.path) ? out(`- ${str(a.path)}`) : undefined
|
|
259
|
+
case "move_file":
|
|
260
|
+
return str(a.from) || str(a.to) ? out(`${str(a.from)} → ${str(a.to)}`) : undefined
|
|
261
|
+
case "git_commit": {
|
|
262
|
+
const m = line(str(a.message), 160)
|
|
263
|
+
return m ? out(`commit ${m}`) : undefined
|
|
264
|
+
}
|
|
265
|
+
default: {
|
|
266
|
+
// Generic: name + ringkasan key=value yang dibasuh — jangan JSON mentah
|
|
267
|
+
// (struktur/token yang tak dikenal scrub bisa bocor).
|
|
268
|
+
const keys = ["path", "file", "query", "pattern", "prompt", "url", "dir", "id", "name"]
|
|
269
|
+
const parts: string[] = []
|
|
270
|
+
for (const k of keys) {
|
|
271
|
+
const v = a[k]
|
|
272
|
+
if (typeof v === "string" && v) parts.push(`${k}=${line(v, 80)}`)
|
|
273
|
+
else if (typeof v === "number" || typeof v === "boolean") parts.push(`${k}=${v}`)
|
|
274
|
+
}
|
|
275
|
+
return parts.length ? out(`${name} ${parts.join(" ")}`) : undefined
|
|
276
|
+
}
|
|
277
|
+
}
|
|
278
|
+
} catch {
|
|
279
|
+
return undefined
|
|
280
|
+
}
|
|
281
|
+
}
|
|
282
|
+
|
|
160
283
|
export function createPermissionHandler(
|
|
161
284
|
opts: {
|
|
162
285
|
mode?: PermissionMode
|
|
@@ -169,10 +292,22 @@ export function createPermissionHandler(
|
|
|
169
292
|
* samping callback keputusan, bukan sebagai pengganti. Tanpa hook =
|
|
170
293
|
* perilaku gate identik seperti dulu. Hook tak boleh melempar ke gate. */
|
|
171
294
|
onApprovalEvent?: ApprovalEventHook
|
|
295
|
+
/**
|
|
296
|
+
* [Area B · PROMPT 06] Penyimpanan binding persetujuan milik SESI.
|
|
297
|
+
*
|
|
298
|
+
* Dipakai untuk dua hal: (1) menyimpan sidik jari args + file target
|
|
299
|
+
* SAAT preview dibuat (sebelum prompt), lalu (2) mengikatkannya ke
|
|
300
|
+
* keputusan "allow". Batas eksekusi (tool wrapper) memverifikasi ulang
|
|
301
|
+
* sidik jari file target dan menolak operasi yang basi.
|
|
302
|
+
*
|
|
303
|
+
* Tanpa store = perilaku lama persis (tanpa verifikasi tambahan).
|
|
304
|
+
*/
|
|
305
|
+
approvalBindings?: ApprovalBindingStore
|
|
172
306
|
} = {},
|
|
173
307
|
): PermissionHandler {
|
|
174
308
|
const state = { mode: (opts.mode ?? "auto") as PermissionMode }
|
|
175
309
|
const root = resolve(opts.root ?? cwd())
|
|
310
|
+
const approvalBindings = opts.approvalBindings
|
|
176
311
|
const askUser = opts.ask
|
|
177
312
|
const allowLocal = opts.allowLocalConfig === true
|
|
178
313
|
let allowlistCache: string[] | null = null
|
|
@@ -249,7 +384,8 @@ export function createPermissionHandler(
|
|
|
249
384
|
// Jawaban prompt yang dilaporkan ke observability. "headless" = jalur
|
|
250
385
|
// tanpa prompt (mantan early-return noTty): pemanggil memetakan ke
|
|
251
386
|
// keputusan deny-nya sendiri agar alasan deny tak berubah.
|
|
252
|
-
|
|
387
|
+
// "stale" = user menyetujui, tapi target berubah selama prompt → fail-closed.
|
|
388
|
+
type GatedAnswer = "allow" | "deny" | "always" | "aborted" | "headless" | "stale"
|
|
253
389
|
|
|
254
390
|
// Counter id persetujuan per handler (= per sesi): deterministik dan
|
|
255
391
|
// test-friendly (tak perlu randomUUID untuk observability).
|
|
@@ -260,8 +396,8 @@ export function createPermissionHandler(
|
|
|
260
396
|
// Arg raksasa (>2KB JSON, mis. write_file 1MB) tidak disimpan sama sekali
|
|
261
397
|
// (fail-closed, minta persetujuan tiap kali) — kalau tidak allowlist.json
|
|
262
398
|
// membengkak dan "always" menjadi blanket-allow untuk konten apa pun.
|
|
399
|
+
if (!canPersistAlways(call.args)) return Promise.resolve()
|
|
263
400
|
const argsJson = JSON.stringify(call.args)
|
|
264
|
-
if (argsJson.length > 2000) return Promise.resolve()
|
|
265
401
|
const key = `${call.name}:${argsJson}`
|
|
266
402
|
if (!sessionGrants.includes(key)) sessionGrants.push(key)
|
|
267
403
|
allowlistCache = null
|
|
@@ -335,6 +471,9 @@ export function createPermissionHandler(
|
|
|
335
471
|
}
|
|
336
472
|
const ans = await gatedPrompt(call, signal, askUser, false)
|
|
337
473
|
if (ans === "headless") return "deny"
|
|
474
|
+
// [Area B] "stale" = target berubah saat prompt → deny; alasan sudah
|
|
475
|
+
// dicatat di `deny()` (jangan timpa dengan "declined by user").
|
|
476
|
+
if (ans === "stale") return "deny"
|
|
338
477
|
if (ans === "always") {
|
|
339
478
|
await saveAlways(call)
|
|
340
479
|
return "allow"
|
|
@@ -509,11 +648,21 @@ export function createPermissionHandler(
|
|
|
509
648
|
describeDenial(call: ToolCall): string | undefined {
|
|
510
649
|
return takeDenyReason(call)
|
|
511
650
|
},
|
|
651
|
+
// Seam P0.2 (Q2): gerbang approval paksaan untuk network read (`web_fetch`,
|
|
652
|
+
// `web_search`) saat WorkMode PLAN aktif. Memakai jalur gated yang SAMA
|
|
653
|
+
// (`promptAskOr`: TTY + ask wajib, allowlist grant berlaku, headless = deny)
|
|
654
|
+
// sehingga observability persetujuan & alasan deny tetap kanonik.
|
|
655
|
+
async __promptGated(call: ToolCall, _deps?: unknown): Promise<"allow" | "deny"> {
|
|
656
|
+
const signal = (_deps as { signal?: AbortSignal } | null | undefined)?.signal
|
|
657
|
+
if (signal?.aborted) return "deny"
|
|
658
|
+
return promptAskOr(call, () => deny(call, "gated approval unavailable"), signal)
|
|
659
|
+
},
|
|
512
660
|
}
|
|
513
661
|
return returned as unknown as PermissionHandler & {
|
|
514
662
|
__setMode(m: PermissionMode): void
|
|
515
663
|
__getMode(): PermissionMode
|
|
516
664
|
describeDenial(call: ToolCall): string | undefined
|
|
665
|
+
__promptGated(call: ToolCall, deps?: unknown): Promise<"allow" | "deny">
|
|
517
666
|
}
|
|
518
667
|
|
|
519
668
|
// Balapan prompt melawan abort: jawaban yang tiba SETELAH sesi dibatalkan
|
|
@@ -555,18 +704,53 @@ export function createPermissionHandler(
|
|
|
555
704
|
const headless = signal?.aborted === true || !ask || (requireTTY && !process.stdin.isTTY)
|
|
556
705
|
const approvalId = `ap_${++approvalCounter}`
|
|
557
706
|
const callInfo = { id: call.id, name: call.name, args: call.args }
|
|
707
|
+
// F-APPROVAL-1: tier risiko efek samping dari kontrak tool — absen/kontrak
|
|
708
|
+
// tak dikenal = UNKNOWN (jelas, bukan tebakan). Tidak mengubah keputusan gate.
|
|
709
|
+
const riskTier = contractForTool(call.name)?.sideEffectTier ?? "UNKNOWN"
|
|
710
|
+
// F-APPROVAL-1: pratinjau diff yang REPRESENTATIF (per-tool) + sudah
|
|
711
|
+
// di-scrub secret — dihitung di policy karena hanya policy yang boleh
|
|
712
|
+
// memanggil scrubSecrets. Absen = tidak ada preview yang layak, kartu UI
|
|
713
|
+
// tetap menampilkan ringkasan args yang ada (fallback tak berubah).
|
|
714
|
+
const diffPreview = buildDiffPreview(call.name, call.args)
|
|
715
|
+
// [Area B · PROMPT 06] TANGKAP sidik jari operasi SEBELUM prompt. Ini
|
|
716
|
+
// "apa yang dilihat user": argumen + isi file target pada saat preview
|
|
717
|
+
// dibuat. Diambil sebelum `ask` karena `ask` bisa mengubah dunia (user
|
|
718
|
+
// sendiri atau proses lain bisa menulis file sementara prompt terbuka) —
|
|
719
|
+
// kalau sidik jari diambil SETELAH prompt, kita memverifikasi state yang
|
|
720
|
+
// tidak pernah dilihat user.
|
|
721
|
+
const capturedBinding: ApprovalBinding | null = approvalBindings
|
|
722
|
+
? captureApprovalBinding(call.name, call.args, root)
|
|
723
|
+
: null
|
|
558
724
|
emitApprovalSafe({
|
|
559
725
|
kind: "requested",
|
|
560
726
|
approvalId,
|
|
561
727
|
call: callInfo,
|
|
562
728
|
via: headless ? "system" : "prompt",
|
|
729
|
+
riskTier,
|
|
730
|
+
...(diffPreview ? { diffPreview } : {}),
|
|
563
731
|
})
|
|
564
732
|
let ans: "allow" | "deny" | "always" | "aborted"
|
|
565
733
|
try {
|
|
566
734
|
// Headless = tanpa prompt (ask tak tersedia / [gated: bukan TTY] / sudah
|
|
567
735
|
// abort): jawaban "deny" tanpa memanggil view — pemanggil memetakan ke
|
|
568
736
|
// keputusan deny-nya sendiri agar alasan deny tak berubah.
|
|
569
|
-
|
|
737
|
+
// F-APPROVAL-1: tier + diff diteruskan ke view agar kartu approval
|
|
738
|
+
// menunjukkan bukti yang SAMA dengan yang user setujui (bukan ringkasan
|
|
739
|
+
// terpisah yang bisa menyimpang dari operasi yang benar dieksekusi).
|
|
740
|
+
ans =
|
|
741
|
+
headless || !ask
|
|
742
|
+
? "deny"
|
|
743
|
+
: await raceAbort(
|
|
744
|
+
ask({
|
|
745
|
+
id: call.id,
|
|
746
|
+
name: call.name,
|
|
747
|
+
args: call.args,
|
|
748
|
+
riskTier,
|
|
749
|
+
diffPreview,
|
|
750
|
+
canAlways: canPersistAlways(call.args),
|
|
751
|
+
}),
|
|
752
|
+
signal,
|
|
753
|
+
)
|
|
570
754
|
} catch (e) {
|
|
571
755
|
emitApprovalSafe({
|
|
572
756
|
kind: "settled",
|
|
@@ -604,6 +788,29 @@ export function createPermissionHandler(
|
|
|
604
788
|
})
|
|
605
789
|
return "headless"
|
|
606
790
|
}
|
|
791
|
+
if (ans === "always" || ans === "allow") {
|
|
792
|
+
// [Area B · PROMPT 06] Verifikasi lapis-1: persetujuan diberikan user
|
|
793
|
+
// untuk state file TERTENTU. Bila target berubah selama prompt
|
|
794
|
+
// terbuka, operasi yang disetujui ≠ operasi yang akan dieksekusi →
|
|
795
|
+
// FAIL-CLOSED: tolak, jangan jalankan.
|
|
796
|
+
//
|
|
797
|
+
// Verifikasi ini terjadi SEBELUM intent jurnal ditulis (barrier efek
|
|
798
|
+
// ada di lapisan app), jadi jurnal tak pernah memuat intent untuk
|
|
799
|
+
// operasi yang memang ditolak.
|
|
800
|
+
if (capturedBinding) {
|
|
801
|
+
const verdict = verifyApprovalBinding(capturedBinding)
|
|
802
|
+
if (verdict.kind === "stale") {
|
|
803
|
+
emitApprovalSafe({
|
|
804
|
+
kind: "settled",
|
|
805
|
+
approvalId,
|
|
806
|
+
call: callInfo,
|
|
807
|
+
outcome: { decision: "deny", by: "system", reason: "approval-stale" },
|
|
808
|
+
})
|
|
809
|
+
deny(call, `approval stale: ${verdict.reason}`)
|
|
810
|
+
return "stale"
|
|
811
|
+
}
|
|
812
|
+
}
|
|
813
|
+
}
|
|
607
814
|
if (ans === "always") {
|
|
608
815
|
emitApprovalSafe({
|
|
609
816
|
kind: "settled",
|
|
@@ -611,6 +818,11 @@ export function createPermissionHandler(
|
|
|
611
818
|
call: callInfo,
|
|
612
819
|
outcome: { decision: "allow-always", by: "user" },
|
|
613
820
|
})
|
|
821
|
+
// [Area B] Grant dibuat untuk call yang SEDANG berjalan: allowlist
|
|
822
|
+
// membuat call berikutnya lolos tanpa prompt, jadi tak ada bukti baru
|
|
823
|
+
// yang bisa diverifikasi — call ini masih terikat ke bukti yang user
|
|
824
|
+
// benar-benar setujui.
|
|
825
|
+
if (capturedBinding) approvalBindings?.grant(capturedBinding)
|
|
614
826
|
return ans
|
|
615
827
|
}
|
|
616
828
|
emitApprovalSafe({
|
|
@@ -622,6 +834,8 @@ export function createPermissionHandler(
|
|
|
622
834
|
? { decision: "allow", by: "user" }
|
|
623
835
|
: { decision: "deny", by: "user", reason: "declined" },
|
|
624
836
|
})
|
|
837
|
+
// [Area B] Izin berlaku untuk operasi yang disetujui saja.
|
|
838
|
+
if (ans === "allow" && capturedBinding) approvalBindings?.grant(capturedBinding)
|
|
625
839
|
return ans
|
|
626
840
|
}
|
|
627
841
|
|
|
@@ -644,6 +858,9 @@ export function createPermissionHandler(
|
|
|
644
858
|
const ans = await gatedPrompt(call, signal, askUser, true)
|
|
645
859
|
if (ans === "headless") return noTty()
|
|
646
860
|
if (ans === "aborted") return "deny"
|
|
861
|
+
// [Area B] "stale" = target berubah saat prompt → deny; alasan sudah
|
|
862
|
+
// dicatat di `deny()` (jangan timpa dengan "declined by user").
|
|
863
|
+
if (ans === "stale") return "deny"
|
|
647
864
|
if (ans === "always") {
|
|
648
865
|
await saveAlways(call)
|
|
649
866
|
return "allow"
|