tutti/docs/conventions/troubleshooting/agent-runtime.md

# Troubleshooting: Agent Runtime

[Back to troubleshooting index](./README.md)

Open only the area that matches the symptom:

## [Agent Providers And Setup](./agent-provider-setup.md)

Provider discovery, installation, authentication, models, configuration, and runtime reachability.

- [Hermes is ready but a new Windows session reports Agent failed to start](./agent-provider-setup.md#hermes-is-ready-but-a-new-windows-session-reports-agent-failed-to-start)
- [An extension Agent is installed in the terminal but Tutti cannot detect it](./agent-provider-setup.md#an-extension-agent-is-installed-in-the-terminal-but-tutti-cannot-detect-it)
- [Codex `/status` shows a 5h limit for a weekly-only account window](./agent-provider-setup.md#codex-status-shows-a-5h-limit-for-a-weekly-only-account-window)
- [Codex is installed but Tutti keeps asking to connect or install it](./agent-provider-setup.md#codex-is-installed-but-tutti-keeps-asking-to-connect-or-install-it)
- [Bun-installed Codex works in a terminal but Tutti cannot use it](./agent-provider-setup.md#bun-installed-codex-works-in-a-terminal-but-tutti-cannot-use-it)
- [Agent provider picker shows only Claude Code and Codex](./agent-provider-setup.md#agent-provider-picker-shows-only-claude-code-and-codex)
- [Claude composer model list stays stale after credential switch](./agent-provider-setup.md#claude-composer-model-list-stays-stale-after-credential-switch)
- [Claude SDK context window shows 200k for 1M models](./agent-provider-setup.md#claude-sdk-context-window-shows-200k-for-1m-models)
- [Codex npm install misses the platform package](./agent-provider-setup.md#codex-npm-install-misses-the-platform-package)
- [Tutti Agent npm install misses the platform package](./agent-provider-setup.md#tutti-agent-npm-install-misses-the-platform-package)
- [Managed npm install fails before reaching every registry](./agent-provider-setup.md#managed-npm-install-fails-before-reaching-every-registry)
- [Tutti Agent unexpectedly loses login after a host auth read failure](./agent-provider-setup.md#tutti-agent-unexpectedly-loses-login-after-a-host-auth-read-failure)
- [Tutti Agent stays on login while the desktop account is signed in](./agent-provider-setup.md#tutti-agent-stays-on-login-while-the-desktop-account-is-signed-in)
- [Agent sandbox cannot reach local daemon](./agent-provider-setup.md#agent-sandbox-cannot-reach-local-daemon)
- [Codex provider install fails with missing npm](./agent-provider-setup.md#codex-provider-install-fails-with-missing-npm)
- [Codex ACP warns about user-level config as project-local config](./agent-provider-setup.md#codex-acp-warns-about-user-level-config-as-project-local-config)
- [Cursor sessions create project `.cursor/skills` or `AGENTS.md` changes](./agent-provider-setup.md#cursor-sessions-create-project-cursorskills-or-agentsmd-changes)
- [Cursor ACP Glob/Grep fails for absolute Windows search roots](./agent-provider-setup.md#cursor-acp-globgrep-fails-for-absolute-windows-search-roots)
- [Cursor read-only mode still creates files without approval](./agent-provider-setup.md#cursor-read-only-mode-still-creates-files-without-approval)
- [Codex provider shows login required when global service tier is legacy](./agent-provider-setup.md#codex-provider-shows-login-required-when-global-service-tier-is-legacy)
- [Codex provider shows login required when only an API key is configured](./agent-provider-setup.md#codex-provider-shows-login-required-when-only-an-api-key-is-configured)
- [Codex session fails with not connected when config file dependencies are relative](./agent-provider-setup.md#codex-session-fails-with-not-connected-when-config-file-dependencies-are-relative)
- [Codex composer model and reasoning selectors stay loading](./agent-provider-setup.md#codex-composer-model-and-reasoning-selectors-stay-loading)
- [Codex custom model_provider mixes models, duplicates replies, or shows metadata warnings](./agent-provider-setup.md#codex-custom-modelprovider-mixes-models-duplicates-replies-or-shows-metadata-warnings)
- [Claude SDK Grep or Glob unavailable despite Claude Code preset](./agent-provider-setup.md#claude-sdk-grep-or-glob-unavailable-despite-claude-code-preset)
- [Provider process loses final stdout or a sidecar fails during startup](./agent-provider-setup.md#provider-process-loses-final-stdout-or-a-sidecar-fails-during-startup)
- [Concurrent agent CLI installs corrupt shared npm global state](./agent-provider-setup.md#concurrent-agent-cli-installs-corrupt-shared-npm-global-state)
- [Agent provider install looks idle while a non-Codex installer is running](./agent-provider-setup.md#agent-provider-install-looks-idle-while-a-non-codex-installer-is-running)
- [Legacy Claude ACP adapter appears stale after external registry migration](./agent-provider-setup.md#legacy-claude-acp-adapter-appears-stale-after-external-registry-migration)
- [Cursor ACP context ring stays empty or usage looks wrong](./agent-provider-setup.md#cursor-acp-context-ring-stays-empty-or-usage-looks-wrong)
- [Cursor free plan shows a red error on the next send after upgrade copy](./agent-provider-setup.md#cursor-free-plan-shows-a-red-error-on-the-next-send-after-upgrade-copy)
- [Claude SDK model aliases resolve to configured Anthropic defaults](./agent-provider-setup.md#claude-sdk-model-aliases-resolve-to-configured-anthropic-defaults)
- [Claude SDK rejects live bypassPermissions mode](./agent-provider-setup.md#claude-sdk-rejects-live-bypasspermissions-mode)
- [Claude Code logs out after sending a message (invalid_grant, credentials wiped)](./agent-provider-setup.md#claude-code-logs-out-after-sending-a-message-invalidgrant-credentials-wiped)
- [Claude Code `Not logged in` renders as a file link instead of sign-in guidance](./agent-provider-setup.md#claude-code-not-logged-in-renders-as-a-file-link-instead-of-sign-in-guidance)
- [Model Plan check succeeds but Kimi Claude Code turns wait and then return 401](./agent-provider-setup.md#model-plan-check-succeeds-but-kimi-claude-code-turns-wait-and-then-return-401)
- [Codex Model Plan turns fail or stay waiting against a Chat-only endpoint](./agent-provider-setup.md#codex-model-plan-turns-fail-or-stay-waiting-against-a-chat-only-endpoint)
- [Claude Code sessions fail with `effectiveSource: "none"` when CC-Switch or similar proxy tools are used](./agent-provider-setup.md#claude-code-sessions-fail-with-effectivesource-none-when-cc-switch-or-similar-proxy-tools-are-used)
- [Tutti Agent retries a 402 and shows generic provider setup](./agent-provider-setup.md#tutti-agent-retries-a-402-and-shows-generic-provider-setup)
- [OpenCode effort changes fail with `effort not found`](./agent-provider-setup.md#opencode-effort-changes-fail-with-effort-not-found)
- [OpenCode model picker has fewer models than the terminal](./agent-provider-setup.md#opencode-model-picker-has-fewer-models-than-the-terminal)
- [Provider setup notice flashes after switching to an already-connected agent](./agent-provider-setup.md#provider-setup-notice-flashes-after-switching-to-an-already-connected-agent)
- [Extension uv runtime install selects an incompatible system Python](./agent-provider-setup.md#extension-uv-runtime-install-selects-an-incompatible-system-python)
- [Extension runtime installation stays failed after restart](./agent-provider-setup.md#extension-runtime-installation-stays-failed-after-restart)
- [Extension slash palette is empty or ignores its command filter](./agent-provider-setup.md#extension-slash-palette-is-empty-or-ignores-its-command-filter)

## [Agent Sessions And Lifecycle](./agent-session-lifecycle.md)

Turn state, loading, cancel, restore, rail projection, event updates, imports, and performance.

- [AgentGUI turn actions return plain-text route 404s](./agent-session-lifecycle.md#agentgui-turn-actions-return-plain-text-route-404s)
- [One hung provider startup blocks unrelated Agent sessions](./agent-session-lifecycle.md#one-hung-provider-startup-blocks-unrelated-agent-sessions)
- [Existing Session shows Tutti active but the Agent reports Default mode](./agent-session-lifecycle.md#existing-session-shows-tutti-active-but-the-agent-reports-default-mode)
- [Tutti Mode review only offers request changes after preference drift](./agent-session-lifecycle.md#tutti-mode-review-only-offers-request-changes-after-preference-drift)
- [Many stopped Tutti Mode conversations start again when the app opens](./agent-session-lifecycle.md#many-stopped-tutti-mode-conversations-start-again-when-the-app-opens)
- [A new Tutti conversation briefly reports session not found after submit](./agent-session-lifecycle.md#a-new-tutti-conversation-briefly-reports-session-not-found-after-submit)
- [AgentGUI rail shows a failed Turn but the detail has no error](./agent-session-lifecycle.md#agentgui-rail-shows-a-failed-turn-but-the-detail-has-no-error)
- [AgentGUI Stop reports no active turn after cancel succeeds](./agent-session-lifecycle.md#agentgui-stop-reports-no-active-turn-after-cancel-succeeds)
- [AgentGUI send blocked by active_turn after settled snapshot](./agent-session-lifecycle.md#agentgui-send-blocked-by-activeturn-after-settled-snapshot)
- [AgentGUI rejects a pasted image as unsupported before send](./agent-session-lifecycle.md#agentgui-rejects-a-pasted-image-as-unsupported-before-send)
- [New extension conversation renders a pasted image as a file](./agent-session-lifecycle.md#new-extension-conversation-renders-a-pasted-image-as-a-file)
- [Remote Agent image reaches the provider as an unsupported URL](./agent-session-lifecycle.md#remote-agent-image-reaches-the-provider-as-an-unsupported-url)
- [Goal banner shows Delete but no Restart action](./agent-session-lifecycle.md#goal-banner-shows-delete-but-no-restart-action)
- [AgentGUI loading disappears before active turn settles](./agent-session-lifecycle.md#agentgui-loading-disappears-before-active-turn-settles)
- [Queued AgentGUI prompt stalls after no-active-turn failure](./agent-session-lifecycle.md#queued-agentgui-prompt-stalls-after-no-active-turn-failure)
- [Agent session stays loading after a completed turn](./agent-session-lifecycle.md#agent-session-stays-loading-after-a-completed-turn)
- [Remote session stays planning while the provider already replied](./agent-session-lifecycle.md#remote-session-stays-planning-while-the-provider-already-replied)
- [AgentGUI model switch changes defaults but not the active session](./agent-session-lifecycle.md#agentgui-model-switch-changes-defaults-but-not-the-active-session)
- [New Agent conversation rejects a model that is no longer offered](./agent-session-lifecycle.md#new-agent-conversation-rejects-a-model-that-is-no-longer-offered)
- [AgentGUI shows the selected settings but a new session does not inherit them](./agent-session-lifecycle.md#agentgui-shows-the-selected-settings-but-a-new-session-does-not-inherit-them)
- [Historical AgentGUI permission changes time out or stop responding](./agent-session-lifecycle.md#historical-agentgui-permission-changes-time-out-or-stop-responding)
- [AgentGUI pin or unpin appears stuck for a live session](./agent-session-lifecycle.md#agentgui-pin-or-unpin-appears-stuck-for-a-live-session)
- [AgentGUI Batch delete sessions does nothing](./agent-session-lifecycle.md#agentgui-batch-delete-sessions-does-nothing)
- [Agent GUI provider tab shows fused or stale conversations](./agent-session-lifecycle.md#agent-gui-provider-tab-shows-fused-or-stale-conversations)
- [Agent GUI sessions appear under the wrong user project](./agent-session-lifecycle.md#agent-gui-sessions-appear-under-the-wrong-user-project)
- [AgentGUI new conversation does nothing after leaving a Chats session](./agent-session-lifecycle.md#agentgui-new-conversation-does-nothing-after-leaving-a-chats-session)
- [AgentGUI restores a provisional conversation after creation fails](./agent-session-lifecycle.md#agentgui-restores-a-provisional-conversation-after-creation-fails)
- [Agent GUI context usage is absent or has the wrong total](./agent-session-lifecycle.md#agent-gui-context-usage-is-absent-or-has-the-wrong-total)
- [Older extension session fails because its launch identity is incomplete](./agent-session-lifecycle.md#older-extension-session-fails-because-its-launch-identity-is-incomplete)
- [Extension history becomes non-resumable after daemon restart](./agent-session-lifecycle.md#extension-history-becomes-non-resumable-after-daemon-restart)
- [Agent session restore breaks when durable snapshot ownership is split](./agent-session-lifecycle.md#agent-session-restore-breaks-when-durable-snapshot-ownership-is-split)
- [Agent activity live updates fail after event schema changes](./agent-session-lifecycle.md#agent-activity-live-updates-fail-after-event-schema-changes)
- [AgentGUI file-change undo reports a generic failure](./agent-session-lifecycle.md#agentgui-file-change-undo-reports-a-generic-failure)
- [AgentGUI changed-files summary shows negative lines for a new file](./agent-session-lifecycle.md#agentgui-changed-files-summary-shows-negative-lines-for-a-new-file)
- [Cursor deleted files appear as created or modified](./agent-session-lifecycle.md#cursor-deleted-files-appear-as-created-or-modified)
- [AgentGUI compaction timer keeps running after compaction completed](./agent-session-lifecycle.md#agentgui-compaction-timer-keeps-running-after-compaction-completed)
- [Claude `/compact` finishes without a compaction divider](./agent-session-lifecycle.md#claude-compact-finishes-without-a-compaction-divider)
- [AgentActivity replication repeatedly rejects message batches as invalid](./agent-session-lifecycle.md#agentactivity-replication-repeatedly-rejects-message-batches-as-invalid)
- [Remote agent cancel does not stop the local turn](./agent-session-lifecycle.md#remote-agent-cancel-does-not-stop-the-local-turn)
- [Claude Code cancel leaves Write/tool cards stuck in progress](./agent-session-lifecycle.md#claude-code-cancel-leaves-writetool-cards-stuck-in-progress)
- [Claude Code starts another command after Stop](./agent-session-lifecycle.md#claude-code-starts-another-command-after-stop)
- [AgentGUI freezes when session history is large](./agent-session-lifecycle.md#agentgui-freezes-when-session-history-is-large)
- [AgentGUI @ Sessions tab is empty](./agent-session-lifecycle.md#agentgui--sessions-tab-is-empty)
- [AgentGUI @ browse fails after reopening](./agent-session-lifecycle.md#agentgui--browse-fails-after-reopening)
- [Fork reports only `agent_session_fork_conflict`](./agent-session-lifecycle.md#fork-reports-only-agent_session_fork_conflict)
- [Agent diagnostics flood while a turn is streaming](./agent-session-lifecycle.md#agent-diagnostics-flood-while-a-turn-is-streaming)
- [Codex turn stays working before any reply or tool activity](./agent-session-lifecycle.md#codex-turn-stays-working-before-any-reply-or-tool-activity)
- [Codex WebSocket reconnect rejects a long prompt metadata header](./agent-session-lifecycle.md#codex-websocket-reconnect-rejects-a-long-prompt-metadata-header)
- [Imported sessions trigger fresh-completion indicators](./agent-session-lifecycle.md#imported-sessions-trigger-fresh-completion-indicators)
- [Realtime agent completion does not show unread attention](./agent-session-lifecycle.md#realtime-agent-completion-does-not-show-unread-attention)
- [Completed agent session stays activating and disables the composer](./agent-session-lifecycle.md#completed-agent-session-stays-activating-and-disables-the-composer)
- [Shared Agent composer stays disabled after the target connects](./agent-session-lifecycle.md#shared-agent-composer-stays-disabled-after-the-target-connects)
- [Goal clear stays planning and leaves the session running](./agent-session-lifecycle.md#goal-clear-stays-planning-and-leaves-the-session-running)
- [Goal loops after pause/resume and never reaches complete](./agent-session-lifecycle.md#goal-loops-after-pause-resume-and-never-reaches-complete)
- [Goal resume fails with permanently ambiguous generation fingerprint](./agent-session-lifecycle.md#goal-resume-fails-with-permanently-ambiguous-generation-fingerprint)
- [Cursor session/new is canceled before its 30-second timeout](./agent-session-lifecycle.md#cursor-sessionnew-is-canceled-before-its-30-second-timeout)
- [Claude Code keeps returning ConnectionRefused after network recovery](./agent-session-lifecycle.md#claude-code-keeps-returning-connectionrefused-after-network-recovery)
- [Cursor auto-continue invents interrupted work after a network drop](./agent-session-lifecycle.md#cursor-auto-continue-invents-interrupted-work-after-a-network-drop)

## [Agent Approvals And Sub-Agents](./agent-approvals-subagents.md)

Approval gates, plan exits, root/parent/child event attribution, child sessions, and Message Center.

- [External PR review approvals do not refresh gate status](./agent-approvals-subagents.md#external-pr-review-approvals-do-not-refresh-gate-status)
- [Cursor approval card shows only title and options, no command/path detail](./agent-approvals-subagents.md#cursor-approval-card-shows-only-title-and-options-no-commandpath-detail)
- [Kimi Code AskUserQuestion waits without showing a question card](./agent-approvals-subagents.md#kimi-code-askuserquestion-waits-without-showing-a-question-card)
- [Agent approval controls submit stale permission requests after restart](./agent-approvals-subagents.md#agent-approval-controls-submit-stale-permission-requests-after-restart)
- [Claude SDK ExitPlanMode fails as interrupted after plan is ready](./agent-approvals-subagents.md#claude-sdk-exitplanmode-fails-as-interrupted-after-plan-is-ready)
- [Codex app-server subagent output appears as the parent reply](./agent-approvals-subagents.md#codex-app-server-subagent-output-appears-as-the-parent-reply)
- [Claude SDK subagent events overwrite or complete the parent turn](./agent-approvals-subagents.md#claude-sdk-subagent-events-overwrite-or-complete-the-parent-turn)
- [Claude child card shows a generic Agent title and no task detail](./agent-approvals-subagents.md#claude-child-card-shows-a-generic-agent-title-and-no-task-detail)
- [Claude SDK subagent approval stuck in Message Center](./agent-approvals-subagents.md#claude-sdk-subagent-approval-stuck-in-message-center)
- [Root remains active after all child turns settle](./agent-approvals-subagents.md#root-remains-active-after-all-child-turns-settle)
- [Provider terminal report replays a settled root as running](./agent-approvals-subagents.md#provider-terminal-report-replays-a-settled-root-as-running)
- [Cursor or OpenCode turn settles before late ACP activity arrives](./agent-session-lifecycle.md#cursor-or-opencode-turn-settles-before-late-acp-activity-arrives)