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
@@ -57,6 +57,15 @@ export interface ToolContractMetadata {
57
57
  readonly allowedInExplore: boolean
58
58
  /** Boleh dijalankan pada eksekusi otonom/background. */
59
59
  readonly allowedInAutonomous: boolean
60
+ /**
61
+ * Diizinkan tanpa persetujuan di mode permission `readonly`/`plan` (dan
62
+ * tanpa prompt di `ask`/`auto`): tool yang tidak mengubah workspace maupun
63
+ * state internal minicode — membaca saja. `bash_output` sengaja `false`
64
+ * (hanya bermakna bila ada job `bash` yang sedang berjalan, yang dilarang
65
+ * readonly); `web_fetch`/`web_search` sengaja `true` walau bertier eksternal
66
+ * karena efeknya baca-jaringan, bukan mutasi lokal/irreversibel arsip.
67
+ */
68
+ readonly allowedInReadonly: boolean
60
69
  /** Efek yang diulang dengan input sama tidak menggandakan hasil. */
61
70
  readonly idempotent: boolean
62
71
  /** Butuh pasangan intent/terminal di jurnal mutasi (lihat catatan di atas). */
@@ -78,6 +87,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
78
87
  gatedByDefault: false,
79
88
  allowedInExplore: true,
80
89
  allowedInAutonomous: true,
90
+ allowedInReadonly: true,
81
91
  idempotent: true,
82
92
  journalMutation: false,
83
93
  }),
@@ -88,6 +98,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
88
98
  gatedByDefault: false,
89
99
  allowedInExplore: false,
90
100
  allowedInAutonomous: true,
101
+ allowedInReadonly: true,
91
102
  idempotent: true,
92
103
  journalMutation: false,
93
104
  }),
@@ -98,6 +109,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
98
109
  gatedByDefault: false,
99
110
  allowedInExplore: true,
100
111
  allowedInAutonomous: true,
112
+ allowedInReadonly: true,
101
113
  idempotent: true,
102
114
  journalMutation: false,
103
115
  }),
@@ -108,6 +120,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
108
120
  gatedByDefault: false,
109
121
  allowedInExplore: true,
110
122
  allowedInAutonomous: true,
123
+ allowedInReadonly: true,
111
124
  idempotent: true,
112
125
  journalMutation: false,
113
126
  }),
@@ -118,6 +131,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
118
131
  gatedByDefault: false,
119
132
  allowedInExplore: true,
120
133
  allowedInAutonomous: true,
134
+ allowedInReadonly: true,
121
135
  idempotent: true,
122
136
  journalMutation: false,
123
137
  }),
@@ -128,6 +142,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
128
142
  gatedByDefault: false,
129
143
  allowedInExplore: false,
130
144
  allowedInAutonomous: true,
145
+ allowedInReadonly: true,
131
146
  idempotent: true,
132
147
  journalMutation: false,
133
148
  }),
@@ -138,6 +153,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
138
153
  gatedByDefault: false,
139
154
  allowedInExplore: true,
140
155
  allowedInAutonomous: true,
156
+ allowedInReadonly: true,
141
157
  idempotent: true,
142
158
  journalMutation: false,
143
159
  }),
@@ -148,6 +164,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
148
164
  gatedByDefault: false,
149
165
  allowedInExplore: true,
150
166
  allowedInAutonomous: true,
167
+ allowedInReadonly: true,
151
168
  idempotent: true,
152
169
  journalMutation: false,
153
170
  }),
@@ -158,6 +175,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
158
175
  gatedByDefault: false,
159
176
  allowedInExplore: true,
160
177
  allowedInAutonomous: true,
178
+ allowedInReadonly: true,
161
179
  idempotent: true,
162
180
  journalMutation: false,
163
181
  }),
@@ -168,6 +186,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
168
186
  gatedByDefault: false,
169
187
  allowedInExplore: true,
170
188
  allowedInAutonomous: true,
189
+ allowedInReadonly: true,
171
190
  idempotent: true,
172
191
  journalMutation: false,
173
192
  }),
@@ -178,6 +197,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
178
197
  gatedByDefault: false,
179
198
  allowedInExplore: true,
180
199
  allowedInAutonomous: true,
200
+ allowedInReadonly: true,
181
201
  idempotent: true,
182
202
  journalMutation: false,
183
203
  }),
@@ -188,6 +208,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
188
208
  gatedByDefault: false,
189
209
  allowedInExplore: true,
190
210
  allowedInAutonomous: true,
211
+ allowedInReadonly: true,
191
212
  idempotent: true,
192
213
  journalMutation: false,
193
214
  }),
@@ -198,6 +219,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
198
219
  gatedByDefault: false,
199
220
  allowedInExplore: false,
200
221
  allowedInAutonomous: true,
222
+ allowedInReadonly: true,
201
223
  idempotent: true,
202
224
  journalMutation: false,
203
225
  }),
@@ -208,6 +230,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
208
230
  gatedByDefault: false,
209
231
  allowedInExplore: true,
210
232
  allowedInAutonomous: true,
233
+ allowedInReadonly: true,
211
234
  idempotent: true,
212
235
  journalMutation: false,
213
236
  }),
@@ -218,6 +241,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
218
241
  gatedByDefault: false,
219
242
  allowedInExplore: false,
220
243
  allowedInAutonomous: true,
244
+ allowedInReadonly: true,
221
245
  idempotent: true,
222
246
  journalMutation: false,
223
247
  }),
@@ -228,6 +252,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
228
252
  gatedByDefault: false,
229
253
  allowedInExplore: true,
230
254
  allowedInAutonomous: true,
255
+ allowedInReadonly: true,
231
256
  idempotent: true,
232
257
  journalMutation: false,
233
258
  }),
@@ -238,6 +263,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
238
263
  gatedByDefault: false,
239
264
  allowedInExplore: false,
240
265
  allowedInAutonomous: false,
266
+ allowedInReadonly: false,
241
267
  idempotent: true,
242
268
  journalMutation: false,
243
269
  }),
@@ -250,6 +276,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
250
276
  gatedByDefault: false,
251
277
  allowedInExplore: false,
252
278
  allowedInAutonomous: false,
279
+ allowedInReadonly: false,
253
280
  idempotent: true,
254
281
  journalMutation: true,
255
282
  }),
@@ -260,6 +287,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
260
287
  gatedByDefault: false,
261
288
  allowedInExplore: false,
262
289
  allowedInAutonomous: false,
290
+ allowedInReadonly: false,
263
291
  idempotent: false,
264
292
  journalMutation: true,
265
293
  }),
@@ -270,6 +298,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
270
298
  gatedByDefault: false,
271
299
  allowedInExplore: false,
272
300
  allowedInAutonomous: false,
301
+ allowedInReadonly: false,
273
302
  idempotent: false,
274
303
  journalMutation: true,
275
304
  }),
@@ -280,6 +309,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
280
309
  gatedByDefault: false,
281
310
  allowedInExplore: false,
282
311
  allowedInAutonomous: false,
312
+ allowedInReadonly: false,
283
313
  idempotent: false,
284
314
  journalMutation: true,
285
315
  }),
@@ -290,6 +320,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
290
320
  gatedByDefault: false,
291
321
  allowedInExplore: false,
292
322
  allowedInAutonomous: false,
323
+ allowedInReadonly: false,
293
324
  idempotent: true,
294
325
  journalMutation: true,
295
326
  }),
@@ -302,6 +333,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
302
333
  gatedByDefault: false,
303
334
  allowedInExplore: false,
304
335
  allowedInAutonomous: false,
336
+ allowedInReadonly: false,
305
337
  idempotent: false,
306
338
  journalMutation: true,
307
339
  }),
@@ -312,6 +344,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
312
344
  gatedByDefault: false,
313
345
  allowedInExplore: false,
314
346
  allowedInAutonomous: false,
347
+ allowedInReadonly: false,
315
348
  idempotent: false,
316
349
  journalMutation: false,
317
350
  }),
@@ -323,6 +356,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
323
356
  gatedByDefault: false,
324
357
  allowedInExplore: false,
325
358
  allowedInAutonomous: false,
359
+ allowedInReadonly: false,
326
360
  idempotent: false,
327
361
  journalMutation: true,
328
362
  }),
@@ -333,6 +367,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
333
367
  gatedByDefault: false,
334
368
  allowedInExplore: false,
335
369
  allowedInAutonomous: false,
370
+ allowedInReadonly: false,
336
371
  idempotent: false,
337
372
  journalMutation: true,
338
373
  }),
@@ -343,6 +378,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
343
378
  gatedByDefault: false,
344
379
  allowedInExplore: false,
345
380
  allowedInAutonomous: false,
381
+ allowedInReadonly: false,
346
382
  idempotent: true,
347
383
  journalMutation: true,
348
384
  }),
@@ -353,6 +389,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
353
389
  gatedByDefault: false,
354
390
  allowedInExplore: false,
355
391
  allowedInAutonomous: false,
392
+ allowedInReadonly: false,
356
393
  idempotent: true,
357
394
  journalMutation: false,
358
395
  }),
@@ -363,6 +400,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
363
400
  gatedByDefault: false,
364
401
  allowedInExplore: false,
365
402
  allowedInAutonomous: false,
403
+ allowedInReadonly: false,
366
404
  idempotent: false,
367
405
  journalMutation: false,
368
406
  }),
@@ -373,6 +411,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
373
411
  gatedByDefault: true,
374
412
  allowedInExplore: false,
375
413
  allowedInAutonomous: false,
414
+ allowedInReadonly: false,
376
415
  idempotent: false,
377
416
  journalMutation: false,
378
417
  }),
@@ -385,6 +424,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
385
424
  gatedByDefault: true,
386
425
  allowedInExplore: false,
387
426
  allowedInAutonomous: false,
427
+ allowedInReadonly: false,
388
428
  idempotent: false,
389
429
  journalMutation: true,
390
430
  }),
@@ -395,6 +435,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
395
435
  gatedByDefault: true,
396
436
  allowedInExplore: false,
397
437
  allowedInAutonomous: false,
438
+ allowedInReadonly: false,
398
439
  idempotent: false,
399
440
  journalMutation: true,
400
441
  }),
@@ -405,6 +446,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
405
446
  gatedByDefault: true,
406
447
  allowedInExplore: false,
407
448
  allowedInAutonomous: false,
449
+ allowedInReadonly: false,
408
450
  idempotent: false,
409
451
  journalMutation: true,
410
452
  }),
@@ -415,6 +457,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
415
457
  gatedByDefault: true,
416
458
  allowedInExplore: false,
417
459
  allowedInAutonomous: false,
460
+ allowedInReadonly: false,
418
461
  idempotent: true,
419
462
  journalMutation: false,
420
463
  }),
@@ -425,6 +468,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
425
468
  gatedByDefault: true,
426
469
  allowedInExplore: false,
427
470
  allowedInAutonomous: false,
471
+ allowedInReadonly: false,
428
472
  idempotent: true,
429
473
  journalMutation: false,
430
474
  }),
@@ -435,6 +479,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
435
479
  gatedByDefault: false,
436
480
  allowedInExplore: false,
437
481
  allowedInAutonomous: false,
482
+ allowedInReadonly: true,
438
483
  idempotent: true,
439
484
  journalMutation: false,
440
485
  }),
@@ -445,6 +490,7 @@ export const TOOL_CONTRACTS: readonly ToolContractMetadata[] = [
445
490
  gatedByDefault: false,
446
491
  allowedInExplore: false,
447
492
  allowedInAutonomous: false,
493
+ allowedInReadonly: true,
448
494
  idempotent: true,
449
495
  journalMutation: false,
450
496
  }),
@@ -498,6 +544,37 @@ export const AUTONOMOUS_TOOL_NAMES: readonly string[] = TOOL_CONTRACTS.filter(
498
544
  (c) => c.allowedInAutonomous,
499
545
  ).map((c) => c.name)
500
546
 
547
+ /**
548
+ * Derivasi: tool yang diizinkan tanpa persetujuan di mode permission
549
+ * `readonly`/`plan` (dan tanpa prompt di `ask`/`auto`) — baca-saja, tanpa
550
+ * mutasi workspace maupun state internal. Sumber tunggal untuk `READONLY_TOOLS`
551
+ * di src/policy/permission.ts; menambah/mengganti tool berarti mengubah
552
+ * `allowedInReadonly` di registry ini, bukan mengedit dua daftar terpisah.
553
+ */
554
+ export const READONLY_TOOL_NAMES: ReadonlySet<string> = new Set(
555
+ TOOL_CONTRACTS.filter((c) => c.allowedInReadonly).map((c) => c.name),
556
+ )
557
+
558
+ /**
559
+ * Derivasi P0.2 (Q1/Q2): semua 16 tool `PURE_READ` lokal yang diizinkan pada
560
+ * ceiling `DISCUSS` (`visible === callable`, nol mutasi workspace/DB, nol
561
+ * network read). Diturunkan dari `TOOL_CONTRACTS` tanpa daftar manual kedua.
562
+ */
563
+ export const LOCAL_READONLY_TOOL_NAMES: readonly string[] = TOOL_CONTRACTS.filter(
564
+ (c) => c.allowedInReadonly && c.sideEffectTier === "PURE_READ",
565
+ ).map((c) => c.name)
566
+
567
+ /**
568
+ * Derivasi P0.2 (Q2): tool baca jaringan (`web_fetch`, `web_search`) —
569
+ * `allowedInReadonly` untuk `EXECUTE`, ditolak penuh di `DISCUSS`, dan wajib
570
+ * melewati gerbang approval prompt di `PLAN` (headless = deny).
571
+ */
572
+ export const NETWORK_READ_TOOL_NAMES: ReadonlySet<string> = new Set(
573
+ TOOL_CONTRACTS.filter((c) => c.allowedInReadonly && c.sideEffectTier !== "PURE_READ").map(
574
+ (c) => c.name,
575
+ ),
576
+ )
577
+
501
578
  /**
502
579
  * Derivasi klasifikasi jurnal. Tool tak dikenal = "unknown", dan pemanggil
503
580
  * (`isMutationTool`) memperlakukannya sebagai mutasi (fail-closed).
@@ -468,6 +468,8 @@ export function createUsageCollector(
468
468
  cacheReadTokens?: number
469
469
  cacheWriteTokens?: number
470
470
  cacheIncluded?: boolean
471
+ /** P1.4: model yang menghasilkan segmen ini (mis. compaction). */
472
+ model?: string
471
473
  }
472
474
  const input =
473
475
  Number.isFinite(d.inputTokens) && (d.inputTokens ?? 0) >= 0 ? (d.inputTokens ?? 0) : 0
@@ -505,7 +507,7 @@ export function createUsageCollector(
505
507
  requestBoundary += 1
506
508
  }
507
509
  lastRequestTotal = reportedTotal
508
- const segModel = effectiveModel ?? model
510
+ const segModel = d.model ?? effectiveModel ?? model
509
511
  const segCost = segModel
510
512
  ? costFor(segModel, input, output, cRead, cWrite, segCacheIncluded)
511
513
  : undefined
@@ -12,15 +12,33 @@
12
12
 
13
13
  import type { PermissionHandler, ToolCall } from "#minicore"
14
14
  import { createPermissionHandler, type PermissionMode } from "./permission.ts"
15
+ import { NETWORK_READ_TOOL_NAMES } from "./tool-contract.ts"
15
16
 
16
17
  export type WorkMode = "DISCUSS" | "PLAN" | "EXECUTE"
17
18
 
19
+ /**
20
+ * Error kebijakan startup saat `--verify` digabung dengan WorkMode non-EXECUTE
21
+ * (keputusan owner P0.2 Q4: fail-closed di startup, bukan diam-diam menjalankan
22
+ * shell verify atau menelannya tanpa penolakan).
23
+ */
24
+ export class VerifyWorkModeConflictError extends Error {
25
+ readonly workMode: Exclude<WorkMode, "EXECUTE">
26
+ constructor(workMode: Exclude<WorkMode, "EXECUTE">) {
27
+ super(
28
+ `[work-mode] --verify cannot be combined with WorkMode ${workMode} (verification runs shell commands and self-heal turns; use --work-mode EXECUTE or omit --verify)`,
29
+ )
30
+ this.name = "VerifyWorkModeConflictError"
31
+ this.workMode = workMode
32
+ }
33
+ }
34
+
18
35
  /** WorkMode yang memasang ceiling. EXECUTE = identitas (base dipakai apa adanya). */
19
36
  export type RestrictiveWorkMode = Exclude<WorkMode, "EXECUTE">
20
37
 
21
38
  type ModeControl = {
22
39
  __setMode(m: PermissionMode): void
23
40
  __getMode(): PermissionMode
41
+ __promptGated?(call: ToolCall, deps?: unknown): Promise<"allow" | "deny">
24
42
  }
25
43
 
26
44
  export type WorkModePermissionHandler = PermissionHandler &
@@ -78,6 +96,14 @@ export function createWorkModePermissionHandler(opts: {
78
96
  root: opts.root,
79
97
  }) as unknown as PermissionHandler,
80
98
  }
99
+ const discussNetworkDeny: PermissionHandler = {
100
+ async check() {
101
+ return "deny"
102
+ },
103
+ describeDenial() {
104
+ return "work-mode DISCUSS: network read disabled"
105
+ },
106
+ }
81
107
 
82
108
  // Pemilik keputusan deny per-call, supaya `describeDenial` membaca seam
83
109
  // handler yang benar (ceiling vs base) dengan semantik hapus-saat-baca.
@@ -121,6 +147,12 @@ export function createWorkModePermissionHandler(opts: {
121
147
  // awal EXECUTE (compose mengembalikan base) TIDAK menyediakan __setWorkMode —
122
148
  // jalur ini dipakai createMinicodeSession yang SELALU membungkus.
123
149
  if (wm === "EXECUTE") return opts.base.check(call, _deps as never)
150
+ // P0.2 (Q2): DISCUSS melarang network read (`web_fetch`, `web_search`) di
151
+ // SEMUA PermissionMode tanpa pernah menyentuh base (0 prompt).
152
+ if (wm === "DISCUSS" && NETWORK_READ_TOOL_NAMES.has(call.name)) {
153
+ rememberDeny(call, discussNetworkDeny)
154
+ return "deny"
155
+ }
124
156
  // Baca mode PM sekarang: `__setMode` runtime menggeser seleksi ceiling
125
157
  // (PLAN × allowlist/readonly = read-only), bukan membekukan yang lama.
126
158
  // Baca WorkMode sekarang (`wm` mutable) — __setWorkMode runtime menggeser
@@ -136,7 +168,23 @@ export function createWorkModePermissionHandler(opts: {
136
168
  // Di dalam ceiling: keputusan mutlak handler PM asli (termasuk prompt
137
169
  // gated `delegate_task` untuk PLAN × auto/ask — owner decision S2.1).
138
170
  const decision = await opts.base.check(call, _deps as never)
139
- if (decision !== "allow") rememberDeny(call, opts.base)
171
+ if (decision !== "allow") {
172
+ rememberDeny(call, opts.base)
173
+ return decision
174
+ }
175
+ // P0.2 (Q2): di PLAN, network read (`web_fetch`, `web_search`) hanya boleh
176
+ // berjalan lewat approval prompt eksplisit (headless/tanpa __promptGated =
177
+ // fail-closed deny). Dipasang SETELAH `opts.base.check` agar Invariant #1
178
+ // terjaga (WorkMode tak pernah melonggarkan penolakan base).
179
+ if (wm === "PLAN" && NETWORK_READ_TOOL_NAMES.has(call.name)) {
180
+ if (typeof ctrl.__promptGated !== "function") {
181
+ rememberDeny(call, discussNetworkDeny)
182
+ return "deny"
183
+ }
184
+ const gated = await ctrl.__promptGated(call, _deps)
185
+ if (gated !== "allow") rememberDeny(call, opts.base)
186
+ return gated
187
+ }
140
188
  return decision
141
189
  },
142
190
  __setMode(m: PermissionMode): void {