@open-agent-toolkit/cli 0.3.4 → 0.3.5

package/assets/bundle-metadata.json

@@ -1,4 +1,4 @@
 {
   "schemaVersion": 1,
-  "oatVersion": "0.3.4"
+  "oatVersion": "0.3.5"
 }

package/assets/docs/cli-utilities/tool-packs.md

@@ -320,10 +320,11 @@ visibility, and recovery guidance. Human output names the provider on its own
 line and on any provider-attributed diagnostic. Reachability is never inferred
 from the presence of a provider directory on disk.
 
-The four inventory surfaces agree on managed user-scope roles. `list` and
-`info` resolve the same provider surface as `status` and `doctor`, so an
-active Codex or Cursor adapter that supplies managed roles suppresses the
-unmaterialized-user-agent report on all four rather than only two.
+The four inventory surfaces agree on user-scope agent coverage. `list` and
+`info` resolve the same provider surface as `status` and `doctor`, so any
+active adapter that entry-syncs or natively reads user-scope agents — every
+registered adapter does — suppresses the unmaterialized-user-agent report on
+all four rather than only two.
 
 Each provider state maps to exactly one row below. Pack evidence status and
 the lifecycle exit code derive from the **severity** column, never from the

package/assets/docs/reference/troubleshooting.md

@@ -167,14 +167,17 @@ Both commands report managed pack state with a scoped recovery command:
   place and your edits are gone. The finding is informational and carries no
   recovery command for exactly that reason.
 - `user-agent-unmaterialized` — the pack installed canonical agents into
-  `~/.agents/agents/`, but active native Codex/Cursor adapters materialize only
-  the bundled managed role files at user scope. Other pack-owned agents remain
-  unmaterialized; when neither adapter is active, the managed roles do too.
-  Provider access to canonical instructions through loaded, user, and project
-  reads is a separate contract and does not clear this native-role finding.
-  `oat tools update` cannot fix it. Install the pack at project scope
-  (`oat tools install <pack> --scope project`) when you need its native roles. See
-  [Tool packs](../cli-utilities/tool-packs.md) for the full limitation.
+  `~/.agents/agents/`, but no active provider projects them at user scope.
+  Every registered adapter (Claude, Cursor, Codex, Gemini, Copilot) syncs or
+  natively reads user-scope agents, so while any of them is active for user
+  sync the finding is suppressed. It appears when no provider is enabled for
+  user sync, in which case every installed agent is listed. Provider access to
+  canonical instructions through loaded, user, and project reads is a separate
+  contract and does not clear this finding. `oat tools update` cannot fix it.
+  Enable a provider with `oat providers set --scope user --enabled <provider>`
+  and run `oat sync --scope user`; reinstalling at project scope is not
+  required. See [Tool packs](../cli-utilities/tool-packs.md) for how
+  user-scope agents reach each provider.
 
 ## `status` or `doctor` reports `packs:inventory`
 

package/assets/public-package-versions.json

@@ -1,6 +1,6 @@
 {
-  "cli": "0.3.4",
-  "docs-config": "0.3.4",
-  "docs-theme": "0.3.4",
-  "docs-transforms": "0.3.4"
+  "cli": "0.3.5",
+  "docs-config": "0.3.5",
+  "docs-theme": "0.3.5",
+  "docs-transforms": "0.3.5"
 }

package/dist/commands/tools/shared/pack-inventory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pack-inventory.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/shared/pack-inventory.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACT,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,mBAAmB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EACA,uBAAuB,GACvB,iBAAiB,GACjB,0BAA0B,GAC1B,2BAA2B,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,iFAAiF;IACjF,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;IACvD,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAC1C;AAmRD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAwC9B;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAUT;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,aAAa,EAAE,GAC3B,aAAa,EAAE,CAgEjB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,aAAa,CAAC,CAiDxB"}
+{"version":3,"file":"pack-inventory.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/shared/pack-inventory.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACT,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,mBAAmB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EACA,uBAAuB,GACvB,iBAAiB,GACjB,0BAA0B,GAC1B,2BAA2B,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,iFAAiF;IACjF,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;IACvD,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAC1C;AAwRD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAwC9B;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAUT;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,aAAa,EAAE,GAC3B,aAAa,EAAE,CAgEjB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,aAAa,CAAC,CAiDxB"}

package/dist/commands/tools/shared/pack-inventory.js

@@ -173,12 +173,15 @@ function intentDiagnostic(diagnostic) {
 }
 /**
  * User-scope canonical agents are installed into `~/.agents/agents/`, while
- * native provider-role materialization is caller-resolved from the active
- * config-aware adapter set. When that capability is active, it supplies the
+ * provider coverage is caller-resolved from the active config-aware adapter
+ * set. Callers suppress this diagnostic when an active provider entry-syncs or
+ * natively reads user agents, which every registered adapter does. It remains
+ * for two cases: no active provider covers user agents (every present agent is
+ * listed), or only extension-backed coverage is active, which supplies the
  * bundled managed role file set plus explicitly user-materializable pack
- * agents. Completeness alone therefore cannot describe native materialization,
- * so the remaining gap is named here instead of staying silent. Canonical
- * instruction-read availability is a separate contract.
+ * agents. Completeness alone cannot describe either gap, so it is named here
+ * instead of staying silent. Canonical instruction-read availability is a
+ * separate contract.
  */
 function userAgentMaterializationDiagnostics(pack, scope, assets, managedRoleMaterialization) {
     if (scope !== 'user')
@@ -194,7 +197,9 @@ function userAgentMaterializationDiagnostics(pack, scope, assets, managedRoleMat
     return [
         {
             code: 'user-agent-unmaterialized',
-            message: `Pack ${pack} installs user-scope canonical agents without native provider-role materialization for the active provider set; canonical instruction reads are unaffected. Active Codex or Cursor materialization supplies only built-in managed roles and manifest-declared user-materializable agents. Install this pack at project scope to materialize the affected agents.`,
+            message: managedRoleMaterialization
+                ? `Pack ${pack} installs user-scope canonical agents that the active provider set does not project; canonical instruction reads are unaffected. The active providers cover user-scope agents only through materialization extensions, which supply built-in managed roles and manifest-declared user-materializable agents. Enable a provider that syncs or reads user-scope agents with \`oat providers set --scope user --enabled <provider>\`, then run \`oat sync --scope user\`.`
+                : `Pack ${pack} installs user-scope canonical agents, but no active provider projects user-scope agents; canonical instruction reads are unaffected. Enable a provider for user sync with \`oat providers set --scope user --enabled <provider>\`, then run \`oat sync --scope user\`.`,
             paths: unmaterialized.map(({ path }) => path),
         },
     ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-agent-toolkit/cli",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "private": false,
   "description": "Open Agent Toolkit CLI",
   "homepage": "https://github.com/voxmedia/open-agent-toolkit/tree/main/packages/cli",
@@ -34,7 +34,7 @@
     "ora": "^9.0.0",
     "yaml": "2.8.2",
     "zod": "^3.25.76",
-    "@open-agent-toolkit/control-plane": "0.3.4"
+    "@open-agent-toolkit/control-plane": "0.3.5"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",