Add agent groups and disabled-agent recommendations

ts/docs/overview/command-reference.md

@@ -2144,6 +2144,33 @@ Usage: `@package install [-r|--refresh] [-n|--dry-run] [-s|--source <string>] <t
 - --dry-run -n : Preview how the target would resolve without installing. (default: false)
 - --refresh -r : Refresh cache-backed source metadata before resolving. (default: false)
 
+## @package group list - List available agent groups
+
+Usage: `@package group list`
+
+## @package group show - Show details and members of an agent group
+
+Usage: `@package group show <group>`
+
+### Arguments:
+
+- &lt;group&gt; - Name of the group to show (type: string)
+
+## @package group install - Install all missing agents in an agent group
+
+Usage: `@package group install [-y|--yes] [-r|--refresh] [-n|--dry-run] [-s|--source <string>] <group>`
+
+### Arguments:
+
+- &lt;group&gt; - Name of the group to install (type: string)
+
+### Flags:
+
+- --source -s &lt;string&gt; : Resolve only against this named source
+- --dry-run -n : Preview how the group would resolve without installing (default: false)
+- --refresh -r : Refresh cache-backed source metadata before resolving (default: false)
+- --yes -y : Skip confirmation prompt (default: false)
+
 ## @package update - Update an installed agent
 
 Usage: `@package update <name> [<range>]`

ts/packages/defaultAgentProvider/README.md

@@ -60,6 +60,35 @@ silently falling through to later sources.
   caches) before resolving; a fetch failure fails the command rather than acting
   on stale data.
 
+### `@package group list | show | install`
+
+```text
+@package group list
+@package group show <group>
+@package group install <group> [--source <sourceName>] [--dry-run] [--refresh] [--yes]
+```
+
+Agent groups bundle related agents together under a product-defined name (such
+as `developer` or `media`) for discovery and sequential installation.
+
+- `group list` lists configured groups. `group show` reports each member as
+  bundled, installed, installed but unavailable, transitioning, or missing.
+- `group install` refreshes the selected source once when `--refresh` is used,
+  previews every missing member, and makes no changes if any missing member
+  cannot resolve or any member is transitioning.
+- The plan displays the winning source, match identity, and lower-priority
+  source shadows. `--source` applies to every preview and install.
+- `--dry-run` stops after the plan. Otherwise one confirmation covers the whole
+  group; `--yes` skips that prompt.
+- Installation runs in catalog order. An isolated failure does not roll back
+  earlier successful installs, and rerunning safely skips completed members.
+  Cancellation stops new installs and reports remaining members as not
+  attempted.
+- An unresolved durable record is not installed again. It is reported as
+  installed but unavailable and requires repair or uninstall.
+- Installing a group does not enable its agents in the current session.
+  Provider propagation to other connected sessions is asynchronous.
+
 ### `@package update <name> [<range>]`
 
 Updates re-resolve the installed record against its recorded source. Feed agents

ts/packages/defaultAgentProvider/data/agentGroups.json

@@ -0,0 +1,14 @@
+{
+  "groups": {
+    "developer": {
+      "displayName": "Developer Tools",
+      "description": "Agents for coding and developer workflows",
+      "agents": ["code", "visualStudio", "github-cli", "powershell", "markdown"]
+    },
+    "media": {
+      "displayName": "Media Tools",
+      "description": "Agents for creating and working with media",
+      "agents": ["photo", "image", "montage", "video", "screencapture"]
+    }
+  }
+}