agent-policy-kit 0.0.0-stage → 0.2.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 (42) hide show
  1. package/AGENT_INSTALL.md +79 -0
  2. package/CHANGELOG.md +101 -0
  3. package/LICENSE +21 -0
  4. package/README.md +69 -2
  5. package/bin/agent-policy.mjs +157 -0
  6. package/docs/architecture.md +17 -0
  7. package/docs/compatibility.md +23 -0
  8. package/docs/configuration-page.md +44 -0
  9. package/docs/deployment.md +31 -0
  10. package/docs/design/2026-11-01-grok-build-support.md +30 -0
  11. package/docs/development.md +21 -0
  12. package/docs/installation.md +23 -0
  13. package/docs/model-catalog.md +102 -0
  14. package/docs/model-updates.md +22 -0
  15. package/docs/npm-release.md +27 -0
  16. package/docs/policy.md +16 -0
  17. package/docs/privacy.md +9 -0
  18. package/docs/recovery.md +13 -0
  19. package/docs/releases.md +40 -0
  20. package/docs/use-cases.md +25 -0
  21. package/docs/verification.md +45 -0
  22. package/examples/kimi-pool.toml +17 -0
  23. package/models/README.md +7 -0
  24. package/models/catalog.json +743 -0
  25. package/package.json +63 -4
  26. package/policies/balanced.json +119 -0
  27. package/policies/fast.json +81 -0
  28. package/policies/quality.json +111 -0
  29. package/schema/policy.schema.json +459 -0
  30. package/site/index.html +1049 -0
  31. package/src/detect.mjs +137 -0
  32. package/src/explicit.mjs +89 -0
  33. package/src/inspect.mjs +203 -0
  34. package/src/install.mjs +582 -0
  35. package/src/native.mjs +64 -0
  36. package/src/output.mjs +108 -0
  37. package/src/policy.mjs +45 -0
  38. package/src/release.mjs +19 -0
  39. package/src/roles.mjs +13 -0
  40. package/src/setup.mjs +66 -0
  41. package/src/share.mjs +172 -0
  42. package/src/toml.mjs +96 -0
package/schema/policy.schema.json ADDED
@@ -0,0 +1,459 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "title": "Agent Policy Kit configuration preferences",
4
+ "type": "object",
5
+ "additionalProperties": false,
6
+ "required": [
7
+ "schemaVersion",
8
+ "maxConcurrent",
9
+ "clients"
10
+ ],
11
+ "properties": {
12
+ "selectedRoles": {
13
+ "type": "array",
14
+ "minItems": 1,
15
+ "maxItems": 6,
16
+ "uniqueItems": true,
17
+ "items": {
18
+ "enum": [
19
+ "worker",
20
+ "reviewer",
21
+ "explorer",
22
+ "tester",
23
+ "writer",
24
+ "routine"
25
+ ]
26
+ },
27
+ "description": "Native subagent roles to configure. Omit to include all six roles in this release."
28
+ },
29
+ "schemaVersion": {
30
+ "const": 1
31
+ },
32
+ "maxConcurrent": {
33
+ "type": "integer",
34
+ "minimum": 1,
35
+ "maximum": 32
36
+ },
37
+ "clients": {
38
+ "type": "object",
39
+ "minProperties": 1,
40
+ "additionalProperties": false,
41
+ "properties": {
42
+ "codex": {
43
+ "$ref": "#/$defs/client"
44
+ },
45
+ "claude": {
46
+ "$ref": "#/$defs/claudeClient"
47
+ },
48
+ "kimi": {
49
+ "$ref": "#/$defs/kimiClient"
50
+ },
51
+ "agy": {
52
+ "$ref": "#/$defs/tierClient"
53
+ },
54
+ "grok": {
55
+ "$ref": "#/$defs/grokClient"
56
+ }
57
+ }
58
+ }
59
+ },
60
+ "$defs": {
61
+ "identifier": {
62
+ "type": "string",
63
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@/\\[\\]-]{0,127}$"
64
+ },
65
+ "profile": {
66
+ "type": "object",
67
+ "additionalProperties": false,
68
+ "required": [
69
+ "model",
70
+ "effort"
71
+ ],
72
+ "properties": {
73
+ "model": {
74
+ "$ref": "#/$defs/identifier"
75
+ },
76
+ "effort": {
77
+ "enum": [
78
+ null,
79
+ "none",
80
+ "minimal",
81
+ "low",
82
+ "medium",
83
+ "high",
84
+ "xhigh",
85
+ "max"
86
+ ]
87
+ }
88
+ }
89
+ },
90
+ "tierProfile": {
91
+ "type": "object",
92
+ "additionalProperties": false,
93
+ "required": [
94
+ "model",
95
+ "effort"
96
+ ],
97
+ "properties": {
98
+ "model": {
99
+ "enum": [
100
+ "pro",
101
+ "flash",
102
+ "flash_lite",
103
+ "inherit"
104
+ ]
105
+ },
106
+ "effort": {
107
+ "type": "null"
108
+ }
109
+ }
110
+ },
111
+ "client": {
112
+ "type": "object",
113
+ "additionalProperties": false,
114
+ "required": [
115
+ "code",
116
+ "light",
117
+ "avoidModels"
118
+ ],
119
+ "properties": {
120
+ "code": {
121
+ "$ref": "#/$defs/profile"
122
+ },
123
+ "light": {
124
+ "$ref": "#/$defs/profile"
125
+ },
126
+ "avoidModels": {
127
+ "type": "array",
128
+ "maxItems": 32,
129
+ "uniqueItems": true,
130
+ "items": {
131
+ "$ref": "#/$defs/identifier"
132
+ }
133
+ },
134
+ "roles": {
135
+ "type": "object",
136
+ "additionalProperties": false,
137
+ "properties": {
138
+ "worker": {
139
+ "$ref": "#/$defs/profile"
140
+ },
141
+ "reviewer": {
142
+ "$ref": "#/$defs/profile"
143
+ },
144
+ "explorer": {
145
+ "$ref": "#/$defs/profile"
146
+ },
147
+ "routine": {
148
+ "$ref": "#/$defs/profile"
149
+ },
150
+ "tester": {
151
+ "$ref": "#/$defs/profile"
152
+ },
153
+ "writer": {
154
+ "$ref": "#/$defs/profile"
155
+ }
156
+ }
157
+ },
158
+ "maxConcurrent": {
159
+ "type": "integer",
160
+ "minimum": 1,
161
+ "maximum": 32,
162
+ "description": "Overrides the shared maxConcurrent fallback for this tool."
163
+ }
164
+ }
165
+ },
166
+ "tierClient": {
167
+ "type": "object",
168
+ "additionalProperties": false,
169
+ "required": [
170
+ "code",
171
+ "light",
172
+ "avoidModels"
173
+ ],
174
+ "properties": {
175
+ "code": {
176
+ "$ref": "#/$defs/tierProfile"
177
+ },
178
+ "light": {
179
+ "$ref": "#/$defs/tierProfile"
180
+ },
181
+ "avoidModels": {
182
+ "type": "array",
183
+ "maxItems": 32,
184
+ "uniqueItems": true,
185
+ "items": {
186
+ "$ref": "#/$defs/identifier"
187
+ }
188
+ },
189
+ "roles": {
190
+ "type": "object",
191
+ "additionalProperties": false,
192
+ "properties": {
193
+ "worker": {
194
+ "$ref": "#/$defs/tierProfile"
195
+ },
196
+ "reviewer": {
197
+ "$ref": "#/$defs/tierProfile"
198
+ },
199
+ "explorer": {
200
+ "$ref": "#/$defs/tierProfile"
201
+ },
202
+ "routine": {
203
+ "$ref": "#/$defs/tierProfile"
204
+ },
205
+ "tester": {
206
+ "$ref": "#/$defs/tierProfile"
207
+ },
208
+ "writer": {
209
+ "$ref": "#/$defs/tierProfile"
210
+ }
211
+ }
212
+ },
213
+ "maxConcurrent": {
214
+ "type": "integer",
215
+ "minimum": 1,
216
+ "maximum": 32,
217
+ "description": "Overrides the shared maxConcurrent fallback for this tool."
218
+ }
219
+ }
220
+ },
221
+ "kimiProfile": {
222
+ "type": "object",
223
+ "additionalProperties": false,
224
+ "required": [
225
+ "model",
226
+ "effort"
227
+ ],
228
+ "properties": {
229
+ "model": {
230
+ "allOf": [
231
+ {
232
+ "$ref": "#/$defs/identifier"
233
+ },
234
+ {
235
+ "not": {
236
+ "const": "primary"
237
+ }
238
+ }
239
+ ]
240
+ },
241
+ "effort": {
242
+ "enum": [
243
+ null,
244
+ "low",
245
+ "medium",
246
+ "high",
247
+ "xhigh",
248
+ "max"
249
+ ]
250
+ }
251
+ }
252
+ },
253
+ "kimiClient": {
254
+ "type": "object",
255
+ "additionalProperties": false,
256
+ "required": [
257
+ "code",
258
+ "light",
259
+ "avoidModels"
260
+ ],
261
+ "properties": {
262
+ "code": {
263
+ "$ref": "#/$defs/kimiProfile"
264
+ },
265
+ "light": {
266
+ "$ref": "#/$defs/kimiProfile"
267
+ },
268
+ "avoidModels": {
269
+ "type": "array",
270
+ "maxItems": 32,
271
+ "uniqueItems": true,
272
+ "items": {
273
+ "$ref": "#/$defs/identifier"
274
+ }
275
+ },
276
+ "roles": {
277
+ "type": "object",
278
+ "additionalProperties": false,
279
+ "properties": {
280
+ "worker": {
281
+ "$ref": "#/$defs/kimiProfile"
282
+ },
283
+ "reviewer": {
284
+ "$ref": "#/$defs/kimiProfile"
285
+ },
286
+ "explorer": {
287
+ "$ref": "#/$defs/kimiProfile"
288
+ },
289
+ "routine": {
290
+ "$ref": "#/$defs/kimiProfile"
291
+ },
292
+ "tester": {
293
+ "$ref": "#/$defs/kimiProfile"
294
+ },
295
+ "writer": {
296
+ "$ref": "#/$defs/kimiProfile"
297
+ }
298
+ }
299
+ },
300
+ "maxConcurrent": {
301
+ "type": "integer",
302
+ "minimum": 1,
303
+ "maximum": 32,
304
+ "description": "Overrides the shared maxConcurrent fallback for this tool."
305
+ }
306
+ }
307
+ },
308
+ "claudeProfile": {
309
+ "type": "object",
310
+ "additionalProperties": false,
311
+ "required": [
312
+ "model",
313
+ "effort"
314
+ ],
315
+ "properties": {
316
+ "model": {
317
+ "$ref": "#/$defs/identifier"
318
+ },
319
+ "effort": {
320
+ "enum": [
321
+ null,
322
+ "low",
323
+ "medium",
324
+ "high",
325
+ "xhigh",
326
+ "max"
327
+ ]
328
+ }
329
+ }
330
+ },
331
+ "claudeClient": {
332
+ "type": "object",
333
+ "additionalProperties": false,
334
+ "required": [
335
+ "code",
336
+ "light",
337
+ "avoidModels"
338
+ ],
339
+ "properties": {
340
+ "code": {
341
+ "$ref": "#/$defs/claudeProfile"
342
+ },
343
+ "light": {
344
+ "$ref": "#/$defs/claudeProfile"
345
+ },
346
+ "avoidModels": {
347
+ "type": "array",
348
+ "maxItems": 32,
349
+ "uniqueItems": true,
350
+ "items": {
351
+ "$ref": "#/$defs/identifier"
352
+ }
353
+ },
354
+ "roles": {
355
+ "type": "object",
356
+ "additionalProperties": false,
357
+ "properties": {
358
+ "worker": {
359
+ "$ref": "#/$defs/claudeProfile"
360
+ },
361
+ "reviewer": {
362
+ "$ref": "#/$defs/claudeProfile"
363
+ },
364
+ "explorer": {
365
+ "$ref": "#/$defs/claudeProfile"
366
+ },
367
+ "routine": {
368
+ "$ref": "#/$defs/claudeProfile"
369
+ },
370
+ "tester": {
371
+ "$ref": "#/$defs/claudeProfile"
372
+ },
373
+ "writer": {
374
+ "$ref": "#/$defs/claudeProfile"
375
+ }
376
+ }
377
+ },
378
+ "maxConcurrent": {
379
+ "type": "integer",
380
+ "minimum": 1,
381
+ "maximum": 32,
382
+ "description": "Overrides the shared maxConcurrent fallback for this tool."
383
+ }
384
+ }
385
+ },
386
+ "grokProfile": {
387
+ "type": "object",
388
+ "additionalProperties": false,
389
+ "required": [
390
+ "model",
391
+ "effort"
392
+ ],
393
+ "properties": {
394
+ "model": {
395
+ "$ref": "#/$defs/identifier"
396
+ },
397
+ "effort": {
398
+ "type": "null"
399
+ }
400
+ }
401
+ },
402
+ "grokClient": {
403
+ "type": "object",
404
+ "additionalProperties": false,
405
+ "required": [
406
+ "code",
407
+ "light",
408
+ "avoidModels"
409
+ ],
410
+ "properties": {
411
+ "code": {
412
+ "$ref": "#/$defs/grokProfile"
413
+ },
414
+ "light": {
415
+ "$ref": "#/$defs/grokProfile"
416
+ },
417
+ "avoidModels": {
418
+ "type": "array",
419
+ "maxItems": 32,
420
+ "uniqueItems": true,
421
+ "items": {
422
+ "$ref": "#/$defs/identifier"
423
+ }
424
+ },
425
+ "roles": {
426
+ "type": "object",
427
+ "additionalProperties": false,
428
+ "properties": {
429
+ "worker": {
430
+ "$ref": "#/$defs/grokProfile"
431
+ },
432
+ "reviewer": {
433
+ "$ref": "#/$defs/grokProfile"
434
+ },
435
+ "explorer": {
436
+ "$ref": "#/$defs/grokProfile"
437
+ },
438
+ "routine": {
439
+ "$ref": "#/$defs/grokProfile"
440
+ },
441
+ "tester": {
442
+ "$ref": "#/$defs/grokProfile"
443
+ },
444
+ "writer": {
445
+ "$ref": "#/$defs/grokProfile"
446
+ }
447
+ }
448
+ },
449
+ "maxConcurrent": {
450
+ "type": "integer",
451
+ "minimum": 1,
452
+ "maximum": 32,
453
+ "description": "Overrides the shared maxConcurrent fallback for this tool."
454
+ }
455
+ }
456
+ }
457
+ },
458
+ "$comment": "Model-specific supported effort is checked against the release catalog; null means no explicit effort override. Only conflicting non-null Kimi alias pins are invalid."
459
+ }