agent-policy-kit 0.3.0 → 0.4.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/AGENT_INSTALL.md +126 -42
- package/CHANGELOG.md +52 -3
- package/README.md +17 -10
- package/docs/README.md +46 -0
- package/docs/design/2026-11-01-documentation-structure.md +58 -0
- package/docs/guide/commands.md +375 -0
- package/docs/guide/configurator.md +163 -0
- package/docs/guide/getting-started.md +119 -0
- package/docs/guide/preferences.md +168 -0
- package/docs/guide/privacy.md +76 -0
- package/docs/guide/updates-and-removal.md +188 -0
- package/docs/maintainers/architecture.md +71 -0
- package/docs/maintainers/development.md +93 -0
- package/docs/maintainers/model-review.md +101 -0
- package/docs/maintainers/release.md +114 -0
- package/docs/maintainers/verification.md +95 -0
- package/docs/maintainers/website.md +112 -0
- package/docs/reference/assistants.md +165 -0
- package/docs/reference/model-catalog.md +194 -0
- package/docs/reference/ownership.md +177 -0
- package/docs/reference/presets.md +128 -0
- package/docs/reference/roles.md +157 -0
- package/docs/research/2026-11-01-model-review.md +341 -0
- package/docs/research/limits-evidence.md +28 -0
- package/models/README.md +2 -6
- package/models/catalog.json +51 -20
- package/package.json +2 -2
- package/policies/balanced.json +1 -1
- package/policies/fast.json +1 -11
- package/policies/quality.json +2 -12
- package/site/index.html +28 -19
- package/src/inspect.mjs +2 -1
- package/src/install.mjs +14 -8
- package/src/release.mjs +1 -1
- package/src/share.mjs +4 -4
- package/docs/architecture.md +0 -17
- package/docs/compatibility.md +0 -39
- package/docs/configuration-page.md +0 -44
- package/docs/deployment.md +0 -33
- package/docs/development.md +0 -31
- package/docs/installation.md +0 -23
- package/docs/limits-evidence.md +0 -24
- package/docs/model-catalog.md +0 -102
- package/docs/model-updates.md +0 -22
- package/docs/npm-release.md +0 -27
- package/docs/policy.md +0 -16
- package/docs/privacy.md +0 -9
- package/docs/recovery.md +0 -13
- package/docs/releases.md +0 -40
- package/docs/use-cases.md +0 -25
- package/docs/verification.md +0 -61
package/models/catalog.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
|
-
"reviewedAt": "2026-
|
|
3
|
+
"reviewedAt": "2026-11-01",
|
|
4
4
|
"scope": "Documented/native coding-tool selectors at this release; account access and custom deployment IDs vary.",
|
|
5
5
|
"clients": {
|
|
6
6
|
"chatgpt": {
|
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
"max"
|
|
16
16
|
],
|
|
17
17
|
"observedClientVersion": "0.166.0",
|
|
18
|
-
"observation": "codex debug models --bundled: 9 visible selectors; 3 hidden specialized/utility entries excluded",
|
|
18
|
+
"observation": "codex debug models --bundled: 9 visible selectors; 3 hidden specialized/utility entries excluded. The signed-in server catalog (2026-11-01) lists 8 visible selectors without GPT-5.5, the hidden gpt-reserve entry and a medium default for GPT-6 Astra.",
|
|
19
19
|
"models": [
|
|
20
20
|
{
|
|
21
21
|
"id": "gpt-6-astra",
|
|
@@ -27,7 +27,7 @@
|
|
|
27
27
|
"xhigh",
|
|
28
28
|
"max"
|
|
29
29
|
],
|
|
30
|
-
"defaultEffort": "
|
|
30
|
+
"defaultEffort": "medium",
|
|
31
31
|
"source": "https://developers.openai.com/api/docs/models/gpt-6-astra",
|
|
32
32
|
"kind": "model",
|
|
33
33
|
"apiEfforts": [
|
|
@@ -41,7 +41,8 @@
|
|
|
41
41
|
"nativeSource": "https://learn.chatgpt.com/docs/models",
|
|
42
42
|
"delegationModes": [
|
|
43
43
|
"ultra"
|
|
44
|
-
]
|
|
44
|
+
],
|
|
45
|
+
"bundledDefaultEffort": "low"
|
|
45
46
|
},
|
|
46
47
|
{
|
|
47
48
|
"id": "gpt-6.1-sol",
|
|
@@ -227,7 +228,7 @@
|
|
|
227
228
|
},
|
|
228
229
|
{
|
|
229
230
|
"id": "gpt-5.5",
|
|
230
|
-
"label": "GPT-5.5",
|
|
231
|
+
"label": "GPT-5.5 (API key only)",
|
|
231
232
|
"efforts": [
|
|
232
233
|
"low",
|
|
233
234
|
"medium",
|
|
@@ -245,7 +246,13 @@
|
|
|
245
246
|
"xhigh"
|
|
246
247
|
],
|
|
247
248
|
"apiDefaultEffort": "medium",
|
|
248
|
-
"nativeSource": "https://learn.chatgpt.com/docs/models"
|
|
249
|
+
"nativeSource": "https://learn.chatgpt.com/docs/models",
|
|
250
|
+
"lifecycle": {
|
|
251
|
+
"status": "retired",
|
|
252
|
+
"retirementDate": "2026-10-14",
|
|
253
|
+
"scope": "Codex with ChatGPT sign-in; API-key sign-in keeps access",
|
|
254
|
+
"source": "https://learn.chatgpt.com/docs/models"
|
|
255
|
+
}
|
|
249
256
|
}
|
|
250
257
|
],
|
|
251
258
|
"excluded": [
|
|
@@ -260,9 +267,13 @@
|
|
|
260
267
|
{
|
|
261
268
|
"id": "codex-auto-review",
|
|
262
269
|
"reason": "hidden internal utility selector"
|
|
270
|
+
},
|
|
271
|
+
{
|
|
272
|
+
"id": "gpt-reserve",
|
|
273
|
+
"reason": "hidden undocumented selector in the server catalog"
|
|
263
274
|
}
|
|
264
275
|
],
|
|
265
|
-
"note": "Efforts
|
|
276
|
+
"note": "Efforts follow the bundled Codex CLI 0.166.0 catalog. Defaults follow the signed-in server catalog of 2026-11-01 where it differs (bundledDefaultEffort keeps the bundled value). API capabilities are separate apiEfforts/apiDefaultEffort metadata. Ultra is a delegating execution mode, recorded separately and not offered as ordinary subagent effort. An API-supported level absent from the native catalog is unverified for manual per-role configuration, not proven runtime-rejected. GPT-5.5 left Codex for ChatGPT sign-in on 2026-10-14 and remains for API-key sign-in."
|
|
266
277
|
},
|
|
267
278
|
"claude": {
|
|
268
279
|
"label": "Claude",
|
|
@@ -273,7 +284,7 @@
|
|
|
273
284
|
"xhigh",
|
|
274
285
|
"max"
|
|
275
286
|
],
|
|
276
|
-
"observedClientVersion": "2.1.
|
|
287
|
+
"observedClientVersion": "2.1.316",
|
|
277
288
|
"models": [
|
|
278
289
|
{
|
|
279
290
|
"id": "sonnet",
|
|
@@ -500,7 +511,12 @@
|
|
|
500
511
|
"high"
|
|
501
512
|
],
|
|
502
513
|
"apiDefaultEffort": null,
|
|
503
|
-
"apiSource": "https://platform.claude.com/docs/en/build-with-claude/effort"
|
|
514
|
+
"apiSource": "https://platform.claude.com/docs/en/build-with-claude/effort",
|
|
515
|
+
"lifecycle": {
|
|
516
|
+
"status": "active",
|
|
517
|
+
"earliestRetirement": "2026-11-24",
|
|
518
|
+
"source": "https://platform.claude.com/docs/en/about-claude/model-deprecations"
|
|
519
|
+
}
|
|
504
520
|
},
|
|
505
521
|
{
|
|
506
522
|
"id": "claude-sonnet-4-5-20250929",
|
|
@@ -522,7 +538,12 @@
|
|
|
522
538
|
"efforts": [],
|
|
523
539
|
"defaultEffort": null,
|
|
524
540
|
"source": "https://code.claude.com/docs/en/model-config",
|
|
525
|
-
"kind": "model"
|
|
541
|
+
"kind": "model",
|
|
542
|
+
"lifecycle": {
|
|
543
|
+
"status": "active",
|
|
544
|
+
"earliestRetirement": "2026-10-15",
|
|
545
|
+
"source": "https://platform.claude.com/docs/en/about-claude/model-deprecations"
|
|
546
|
+
}
|
|
526
547
|
},
|
|
527
548
|
{
|
|
528
549
|
"id": "inherit",
|
|
@@ -540,7 +561,7 @@
|
|
|
540
561
|
"effortResolution": "Depends on the resolved model and provider; requested levels can be clamped or ignored by Claude Code."
|
|
541
562
|
}
|
|
542
563
|
],
|
|
543
|
-
"note": "Full model IDs use the current Claude Code native effort table, which differs from API support for Opus 4.5. Alias/inherit efforts are possible requested levels, not a guarantee for every resolved provider model; unsupported levels can clamp or be ignored. Current account access and provider alias resolution vary.",
|
|
564
|
+
"note": "Full model IDs use the current Claude Code native effort table, which differs from API support for Opus 4.5. Alias/inherit efforts are possible requested levels, not a guarantee for every resolved provider model; unsupported levels can clamp or be ignored. Current account access and provider alias resolution vary. Claude Code 2.1.316 adds CLAUDE_CODE_SUBAGENT_EFFORT for subagents that name no effort; earlier versions ignore it. CLAUDE_CODE_EFFORT_LEVEL still overrides subagent effort frontmatter.",
|
|
544
565
|
"excluded": [
|
|
545
566
|
{
|
|
546
567
|
"id": "best",
|
|
@@ -613,7 +634,8 @@
|
|
|
613
634
|
"defaultEffort": "high",
|
|
614
635
|
"source": "https://www.kimi.com/code/docs/en/kimi-code/models",
|
|
615
636
|
"kind": "native-alias",
|
|
616
|
-
"upstreamModelId": "k3"
|
|
637
|
+
"upstreamModelId": "k3",
|
|
638
|
+
"planRequirement": "Plus (Moderato) or higher; 1M context requires Pro (Allegretto) or higher"
|
|
617
639
|
},
|
|
618
640
|
{
|
|
619
641
|
"id": "kimi-code/k3-256k",
|
|
@@ -651,14 +673,14 @@
|
|
|
651
673
|
"upstreamModelId": "kimi-for-coding-highspeed"
|
|
652
674
|
}
|
|
653
675
|
],
|
|
654
|
-
"note": "Current Kimi Code docs list six model IDs; the older kimi.ai/help page still lists four. K3.1 Pro and Highspeed require thinking and support low/high/max, default high. These are preferred native aliases: setup resolves a missing preferred alias only to a unique provisioned match; no provider identity is invented. Account tier controls access.",
|
|
655
|
-
"observedClientVersion": "2.4.
|
|
656
|
-
"observation": "Kimi Code CLI 2.4.0: all six documented preferred aliases and native effort/default capabilities corroborated through whitelisted provisioned metadata; no credentials or custom account aliases retained."
|
|
676
|
+
"note": "Current Kimi Code docs list six model IDs; the older kimi.ai/help page still lists four. K3.1 Pro and Highspeed require thinking and support low/high/max, default high. These are preferred native aliases: setup resolves a missing preferred alias only to a unique provisioned match; no provider identity is invented. Account tier controls access. K3 and K3.1 Pro require the Plus (Moderato) plan or higher. The 1M context of K3 and every Highspeed model require Pro (Allegretto) or higher; on Plus, k3 stays at 256K context and uses about twice the quota of k3-256k. K2.7 Code HighSpeed uses about three times the quota.",
|
|
677
|
+
"observedClientVersion": "2.4.1",
|
|
678
|
+
"observation": "Kimi Code CLI 2.4.0 and 2.4.1: all six documented preferred aliases and native effort/default capabilities corroborated through whitelisted provisioned metadata; no credentials or custom account aliases retained."
|
|
657
679
|
},
|
|
658
680
|
"gemini": {
|
|
659
681
|
"label": "Gemini",
|
|
660
682
|
"efforts": [],
|
|
661
|
-
"observedClientVersion": "1.4.
|
|
683
|
+
"observedClientVersion": "1.4.12",
|
|
662
684
|
"models": [
|
|
663
685
|
{
|
|
664
686
|
"id": "pro",
|
|
@@ -682,7 +704,9 @@
|
|
|
682
704
|
"efforts": [],
|
|
683
705
|
"defaultEffort": null,
|
|
684
706
|
"source": "https://antigravity.google/docs/subagents?tab=cli",
|
|
685
|
-
"kind": "tier"
|
|
707
|
+
"kind": "tier",
|
|
708
|
+
"documented": false,
|
|
709
|
+
"nativeSource": "Antigravity CLI 1.4.12 agent-file parser"
|
|
686
710
|
},
|
|
687
711
|
{
|
|
688
712
|
"id": "inherit",
|
|
@@ -693,7 +717,7 @@
|
|
|
693
717
|
"kind": "tier"
|
|
694
718
|
}
|
|
695
719
|
],
|
|
696
|
-
"note": "Native per-subagent selectors are tiers, not the session model inventory. CLI 1.4.
|
|
720
|
+
"note": "Native per-subagent selectors are tiers, not the session model inventory. The CLI 1.4.12 parser accepts inherit/flash_lite/flash/pro; the public subagent documentation lists only inherit, flash and pro, so flash_lite is undocumented. Google does not document which Gemini model each tier uses; the server sets it per account. Per-role effort is not exposed by the agent-file schema; --effort and /effort apply to the whole session."
|
|
697
721
|
},
|
|
698
722
|
"grok": {
|
|
699
723
|
"label": "Grok",
|
|
@@ -707,7 +731,14 @@
|
|
|
707
731
|
"defaultEffort": null,
|
|
708
732
|
"source": "https://docs.x.ai/developers/models",
|
|
709
733
|
"nativeSource": "https://github.com/xai-org/grok-build/blob/main/crates/codegen/xai-grok-pager/docs/user-guide/16-subagents.md",
|
|
710
|
-
"kind": "model"
|
|
734
|
+
"kind": "model",
|
|
735
|
+
"apiEfforts": [
|
|
736
|
+
"low",
|
|
737
|
+
"medium",
|
|
738
|
+
"high",
|
|
739
|
+
"xhigh"
|
|
740
|
+
],
|
|
741
|
+
"apiDefaultEffort": "high"
|
|
711
742
|
},
|
|
712
743
|
{
|
|
713
744
|
"id": "grok-4.6",
|
|
@@ -737,7 +768,7 @@
|
|
|
737
768
|
"kind": "model"
|
|
738
769
|
}
|
|
739
770
|
],
|
|
740
|
-
"note": "Per-subagent models are set in config.toml [subagents.models]; model IDs follow the documented xAI model list and account access varies.
|
|
771
|
+
"note": "Per-subagent models are set in config.toml [subagents.models]; model IDs follow the documented xAI model list and account access varies. Grok 4.7 supports low/medium/high/xhigh reasoning effort and Grok Build resolves subagent effort from a spawn override, role default, persona default and then the parent session. The [subagents.models] entries that APK writes carry only a model, so APK leaves effort to the main session. [subagents] max_concurrent is a native cap."
|
|
741
772
|
}
|
|
742
773
|
}
|
|
743
774
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-policy-kit",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "Configure native subagent settings across AI assistants, then exit",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -65,5 +65,5 @@
|
|
|
65
65
|
"bugs": {
|
|
66
66
|
"url": "https://github.com/automatis-tools/agent-policy-kit/issues"
|
|
67
67
|
},
|
|
68
|
-
"homepage": "https://agent-policy-kit.trymenow.io/v/0.
|
|
68
|
+
"homepage": "https://agent-policy-kit.trymenow.io/v/0.4.0/"
|
|
69
69
|
}
|
package/policies/balanced.json
CHANGED
package/policies/fast.json
CHANGED
|
@@ -5,22 +5,12 @@
|
|
|
5
5
|
"chatgpt": {
|
|
6
6
|
"code": {
|
|
7
7
|
"model": "gpt-6-luna",
|
|
8
|
-
"effort": "
|
|
8
|
+
"effort": "high"
|
|
9
9
|
},
|
|
10
10
|
"light": {
|
|
11
11
|
"model": "gpt-6-luna",
|
|
12
12
|
"effort": "low"
|
|
13
13
|
},
|
|
14
|
-
"roles": {
|
|
15
|
-
"reviewer": {
|
|
16
|
-
"model": "gpt-6-luna",
|
|
17
|
-
"effort": "high"
|
|
18
|
-
},
|
|
19
|
-
"tester": {
|
|
20
|
-
"model": "gpt-6-luna",
|
|
21
|
-
"effort": "high"
|
|
22
|
-
}
|
|
23
|
-
},
|
|
24
14
|
"avoidModels": []
|
|
25
15
|
},
|
|
26
16
|
"claude": {
|
package/policies/quality.json
CHANGED
|
@@ -11,16 +11,6 @@
|
|
|
11
11
|
"model": "gpt-6.1-sol",
|
|
12
12
|
"effort": "medium"
|
|
13
13
|
},
|
|
14
|
-
"roles": {
|
|
15
|
-
"explorer": {
|
|
16
|
-
"model": "gpt-6.1-sol",
|
|
17
|
-
"effort": "high"
|
|
18
|
-
},
|
|
19
|
-
"writer": {
|
|
20
|
-
"model": "gpt-6.1-sol",
|
|
21
|
-
"effort": "high"
|
|
22
|
-
}
|
|
23
|
-
},
|
|
24
14
|
"avoidModels": []
|
|
25
15
|
},
|
|
26
16
|
"claude": {
|
|
@@ -35,11 +25,11 @@
|
|
|
35
25
|
"roles": {
|
|
36
26
|
"explorer": {
|
|
37
27
|
"model": "claude-opus-5-5",
|
|
38
|
-
"effort": "
|
|
28
|
+
"effort": "medium"
|
|
39
29
|
},
|
|
40
30
|
"writer": {
|
|
41
31
|
"model": "claude-opus-5-5",
|
|
42
|
-
"effort": "
|
|
32
|
+
"effort": "medium"
|
|
43
33
|
}
|
|
44
34
|
},
|
|
45
35
|
"avoidModels": []
|