v2-refactor-temp/docs/breaking-changes/2026-05-20-agent-session-config-flattened-to-agent.md
Cognitive config (mcps, allowedTools, configuration — permission
mode, max turns, env vars, soul/scheduler/heartbeat toggles) now lives on
the agent, not the session. v1 stored these on every session row;
the v1 → v2 migration carries them forward only on the parent agent and
drops every per-session override.
agent_session keeps just identity + naming + workspace binding +
ordering — no MCP allowlist, no tool allowlist, no permission mode, no
scheduler config.
If a user customized MCP servers, allowed tools, permission mode, or the soul/scheduler/heartbeat settings on a specific session (not on the parent agent), that override does not survive the upgrade. Every migrated session falls back to whatever the parent agent has configured.
Visible places:
claude-code invocation: the session inherits the agent's settings.Pair with 2026-05-19-agent-session-primary-workspace.md
in the release note — both are the "session is now a thin handle around
its parent agent" theme.
If the migrator emits warnings for non-empty per-session overrides that were dropped, surface the count so the user knows whether to audit.