Answer: session.idle is always emitted when the tool-use loop ends and is ephemeral (not persisted to disk, not replayed on session resume), meaning "the agent has stopped processing and is ready for the next message"; session.task_complete is optionally emitted (requires the model to explicitly signal it) and is persisted to the session event log on disk, meaning "the agent considers the overall task fulfilled". Status: Confirmed Entry: tool/github-copilot/agents-and-automation/session-idle-vs-task-complete Revision: 2 Digest: sha256:802419d358ee948b (changes whenever the content changes) Timeline: Created: 2026-11-13T03:27:46Z Last changed: 2026-11-19T13:01:34Z (session.task_complete persistence: Persisted → Persisted : saved to the session event log on disk) Last verified: 2026-11-20T13:07:58Z Next check: 2026-11-21T13:07:58Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of session.idle emission | Always emitted when the tool-use loop ends | [1] | 2026-11-20 session.idle persistence | Ephemeral : not persisted to disk, not replayed on session resume | [1] | 2026-11-20 session.idle meaning | the agent has stopped processing and is ready for the next message | [1] | 2026-11-20 session.task_complete emission | Optionally emitted : requires the model to explicitly signal it | [1] | 2026-11-20 session.task_complete persistence | Persisted : saved to the session event log on disk | [1] | 2026-11-20 session.task_complete meaning | the agent considers the overall task fulfilled | [1] | 2026-11-20 Sources: [1] GitHub. "The agent loop - GitHub Docs". https://docs.github.com/en/copilot/how-tos/copilot-sdk/features/agent-loop Role: primary. Accessed: 2026-11-20T13:07:58Z Quote: "session.idle Always emitted when the tool-use loop ends" (Supports: session.idle emission) Quote: "Ephemeral : not persisted to disk, not replayed on session resume" (Supports: session.idle persistence) Quote: "Means: "the agent has stopped processing and is ready for the next message"" (Supports: session.idle meaning) Quote: "session.task_complete Optionally emitted : requires the model to explicitly signal it" (Supports: session.task_complete emission) Quote: "Persisted : saved to the session event log on disk" (Supports: session.task_complete persistence) Quote: "Means: "the agent considers the overall task fulfilled"" (Supports: session.task_complete meaning) Snapshot SHA-256: 129044a79258fe797fb5da7932fffdc0f526cfae7016d0657fb724f66daad3fc (captured 2026-11-18T13:02:58Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-18T13:02:58Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T13:07:58Z. No independent second source is configured for this entry Last successful check: 2026-11-20T13:07:58Z Last attempt: 2026-11-20T13:07:58Z Notes and limitations: Extracted automatically from a single official source (section "session.idle vs session.task_complete"). Related: https://latestn.com/tool/github-copilot/agents-and-automation/session-lifecycle-hooks-best-practices What are the best practices for using GitHub Copilot SDK session lifecycle hooks? https://latestn.com/tool/github-copilot/agents-and-automation/session-resume-persistence How do I resume a GitHub Copilot SDK session and keep it persistent? https://latestn.com/tool/github-copilot/agents-and-automation/session-start-add-project-context How do I add project context when a GitHub Copilot SDK session starts? https://latestn.com/tool/github-copilot/agents-and-automation/semantic-search-cloud-agent How does semantic code search work in the GitHub Copilot cloud agent? https://latestn.com/tool/github-copilot/agents-and-automation/send-errors-to-monitoring How do I send GitHub Copilot SDK errors to a monitoring service or alert on critical errors? https://latestn.com/tool/github-copilot/agents-and-automation/session-end-reasons What end reasons does the GitHub Copilot SDK session end hook receive? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-19T13:01:34Z | changed | session.task_complete persistence: Persisted → Persisted : saved to the session event log on disk | [1] 2026-11-19T13:01:34Z | changed | session.task_complete emission: Optionally emitted → Optionally emitted : requires the model to explicitly signal it | [1] 2026-11-19T13:01:34Z | changed | session.idle persistence: Ephemeral → Ephemeral : not persisted to disk, not replayed on session resume | [1] 2026-11-13T03:27:46Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/github-copilot/agents-and-automation/session-idle-vs-task-complete/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/github-copilot/agents-and-automation/session-idle-vs-task-complete POST: https://latestn.com/dispute/tool/github-copilot/agents-and-automation/session-idle-vs-task-complete with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/github-copilot/agents-and-automation/session-idle-vs-task-complete?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). What is the difference between session.idle and session.task_complete in the GitHub Copilot SDK? Revision 2, last verified 2026-11-20T13:07:58Z. https://latestn.com/tool/github-copilot/agents-and-automation/session-idle-vs-task-complete (accessed 2026-11-21T09:56:43Z). @misc{LatestN_tool_github_copilot_agents_and_automation_session_idle_vs_task_complete_r2, title = {What is the difference between session.idle and session.task_complete in the GitHub Copilot SDK?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/github-copilot/agents-and-automation/session-idle-vs-task-complete}}, note = {Revision 2; digest sha256:802419d358ee948b; last verified 2026-11-20T13:07:58Z; accessed 2026-11-21T09:56:43Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/github-copilot/agents-and-automation/session-idle-vs-task-complete