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
|
@@ -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).
|
package/src/policy/usage.ts
CHANGED
|
@@ -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
|
package/src/policy/work-mode.ts
CHANGED
|
@@ -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")
|
|
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 {
|