Toolsets

Toolsets group related tools so AGH can expose a coherent operating surface without forcing every agent or operator to reason about hundreds of individual tool IDs first.

Use toolsets when you need to understand why a session can see one family of tools, why a tool is missing, or how a catalog expands into concrete tool IDs.

In one sentence

A toolset is a named bundle of registry tools with expansion diagnostics.

Inspect toolsets

List known toolsets:

agh toolsets list -o json

Inspect one expansion:

agh toolsets info agh__catalog -o json

What happened: AGH resolved the toolset through the registry and returned the expanded tool IDs plus diagnostics. Use diagnostics when an expected tool is missing or unavailable in the current scope.

Default catalog shape

The default discovery surface is intentionally small:

Toolset or tool	Job
`agh__bootstrap`	Gives a managed agent enough initial runtime context to orient itself.
`agh__catalog`	Exposes the high-level registry catalog.
`agh__tool_search`	Searches for tools by descriptor text.
`agh__tool_info`	Returns one descriptor, schema, and diagnostics before invocation.

The goal is progressive disclosure. Agents should not load every tool schema into context on every turn. They search, inspect, then invoke.

Operational toolsets

AGH groups runtime capabilities by owning subsystem. These toolsets are canonical IDs that can be granted through agent definitions or inspected through agh toolsets info.

Toolset	Includes
`agh__tasks`	Task CRUD, task runs, reviews, execution profiles, and notifications.
`agh__provider_models`	Provider model catalog list, refresh, and source-status tools.
`agh__memory`	Memory list, show, search, proposal, and ad-hoc note tools.
`agh__memory_admin`	Memory health, history, reindex, dream, provider, extractor, and ledger tools.
`agh__bridges`	Bridge instance, route, secret-binding, and status diagnostics.
`agh__automation`	Automation job, trigger, and run management.
`agh__extensions`	Extension marketplace, install, update, enable, disable, and remove tools.
`agh__bundles`	Extension bundle catalog, activation, deactivation, and network-default status.
`agh__resources`	Desired-state resource list, info, and snapshot inspection tools.
`agh__mcp`	MCP server probe/status diagnostics without login or logout tool calls.
`agh__mcp_auth`	Redacted MCP OAuth status for configured servers.

Toolsets expose current canonical tool IDs only. For Memory administration, agh__memory_admin includes agh__memory_admin_history for operation-history inspection.

How toolsets help operators

Toolsets answer practical questions:

Which tools are exposed by default?
Which concrete tool IDs are in this catalog?
Is a tool unavailable because of scope, policy, missing daemon state, or configuration?
Which tools should a managed agent inspect first?

How toolsets help agents

Agents should treat toolsets as navigation, not as permission to call everything blindly.

Recommended flow:

Use the bootstrap/catalog surface.
Search for the task-specific tool family.
Inspect the descriptor and input schema.
Invoke only after the target and required fields are clear.
Report the result or failure using the owning task/session surface.

Tool Registry explains the registry model.
Policy and Invocation explains what happens at call time.
Toolsets CLI Reference is the generated command reference.