state_migration

Directory for user-level Deep Agents configuration (~/.deepagents).

Directory for CLI-managed internal state (~/.deepagents/.state).

Holds files the CLI writes for its own bookkeeping — OAuth tokens, the sessions database, version-check caches, input history. Kept separate from top-level user-facing config and agent directories so listing/iterating ~/.deepagents doesn't conflate state with agents.

Move legacy state entries from config_dir into state_dir.

Idempotent: each entry is skipped when the destination already exists (the migration ran on a prior invocation) or when the source does not exist (nothing to move). Errors on individual entries are logged and swallowed so a single unmovable file does not block the rest.