Skip to content

Add basic VS Code Agent Host arch doc#10042

Draft
roblourens wants to merge 3 commits into
mainfrom
roblou/agent-host-architecture
Draft

Add basic VS Code Agent Host arch doc#10042
roblourens wants to merge 3 commits into
mainfrom
roblou/agent-host-architecture

Conversation

@roblourens

Copy link
Copy Markdown
Member

Summary

  • add an engineering overview of the VS Code Agent Host and Agent Host Protocol
  • explain the extension-host transition, client-provided tools, and local and remote deployment model
  • add editable Excalidraw source and exported transition and deployment diagrams
  • link the new article from the Agents concepts navigation and sitemap

Validation

  • validated internal article links
  • validated TOC JSON, sitemap XML, SVG XML, and Excalidraw source
  • checked workspace diagnostics and Git whitespace errors

(Written by Copilot)

(Written by Copilot)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@roblourens roblourens changed the title Document VS Code Agent Host architecture Add basic VS Code Agent Host arch doc Jul 15, 2026
@roblourens roblourens requested a review from Copilot July 15, 2026 00:14

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new “VS Code Agent Host architecture” concepts article to document the Agent Host and Agent Host Protocol (AHP), including diagrams, and wires the new page into the Agents concepts navigation and site sitemap.

Changes:

  • Add a new architecture article describing the Agent Host, AHP, session model, and local/remote deployment.
  • Add Excalidraw source and exported SVG diagrams for transition/deployment visuals used by the article.
  • Link the new article from Agents concepts navigation (TOC + related resources) and build/sitemap.xml.
Show a summary per file
File Description
docs/agents/toc.json Adds the new “Agent Host Architecture” entry to the Agents concepts navigation.
docs/agents/images/concepts/AHP-diagrams.excalidraw Adds editable Excalidraw source for the Agent Host diagrams.
docs/agents/images/concepts/agent-host-transition.svg Adds the exported transition diagram used in the new article.
docs/agents/images/concepts/agent-host-deployment.svg Adds the exported deployment diagram used in the new article.
docs/agents/concepts/overview.md Links to the new Agent Host architecture concept from the concepts overview.
docs/agents/concepts/agents.md Adds the new architecture page to “Related resources”.
docs/agents/concepts/agent-host.md Introduces the new Agent Host architecture documentation page.
build/sitemap.xml Adds the new documentation URL to the sitemap.

Review details

  • Files reviewed: 6/8 changed files
  • Comments generated: 1
  • Review effort level: Low

Comment thread docs/agents/concepts/agent-host.md Outdated
roblourens and others added 2 commits July 14, 2026 18:31
(Written by Copilot)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
(Written by Copilot)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants