Files
hermes-agent/website/docs
alt-glitch c3f85bc54f refactor(setup): delete profile role; the setup profile is a marked, plain profile
The setup toolset was reserved for `role: setup` in profile.yaml, resolved by
toolsets.profile_role_toolsets, and stripped from every other profile in
model_tools._select_tool_names. Onboarding also wrote that role into a user's
existing unmarked hermes-setup profile and adopted it, and cloned the literal
default profile.

Now there is no role anywhere. The setup profile carries a dot-file marker
(.setup-profile.json) at its root, and onboarding finds it by that marker. A
user's own unmarked hermes-setup is never touched: onboarding makes
hermes-setup-<word> instead. The new profile is cloned from the launch
profile, and its own config enables the setup toolset in
platform_toolsets.cli. The session resolver keeps the toolset only for
desktop sessions (toolsets.TOOLSET_SESSION_PLATFORMS). Copies (clone-all,
import, distribution install) drop the marker, as they dropped the role.

The role field also leaves ProfileInfo, the profiles.list and dashboard rows,
the onboarding.ensure_setup_profile result, the gateway contracts, and the
desktop ProfileInfo type. The desktop handoff recovery check no longer gates
on the roster role; the guide handoff receipt keyed by the stored session
already identifies the guide session.

Linear NS-1014.
2026-09-30 08:33:45 +05:30
..