diff --git a/ts/docs/architecture/agents/agentServerConversations.md b/ts/docs/architecture/agents/agentServerConversations.md
index ab0083a143..4d24a655cc 100644
--- a/ts/docs/architecture/agents/agentServerConversations.md
+++ b/ts/docs/architecture/agents/agentServerConversations.md
@@ -121,6 +121,7 @@ type ConversationInfo = {
   name: string;
   clientCount: number;
   createdAt: string;
+  messageCount: number; // user requests recorded in the display log
 };
 ```
 
diff --git a/ts/docs/architecture/core/dispatcher.md b/ts/docs/architecture/core/dispatcher.md
index a3e8549108..04d4719eeb 100644
--- a/ts/docs/architecture/core/dispatcher.md
+++ b/ts/docs/architecture/core/dispatcher.md
@@ -734,8 +734,10 @@ The system agent also has sub-agents with LLM-translated action schemas:
   "describe the play action"). `executeDescribeAction` forwards to the equivalent `@describe`
   command (same convention as `system.config`/`system.history`), which resolves the agent/action
   against `getAgentSchemas()` (agentSchemaInfo.ts) and renders a deterministic markdown summary,
-  optionally polished by a fast LLM call when one is configured (falls back to the deterministic
-  text on missing/failed model — see `describeCore.ts`).
+  optionally polished by a fast structured-output LLM call when one is configured — the model
+  returns a schema-validated JSON object (summary / explanation + example) that is rendered to
+  markdown deterministically, falling back to the deterministic text on a missing/failed model
+  (see `describeCore.ts`).
 - **`system.config`** — Natural language configuration changes.
 - **`system.conversation`** — Natural language management of **agentServer client-connection
   conversations** (the named, GUID-keyed sessions described in
diff --git a/ts/docs/overview/action-browser.html b/ts/docs/overview/action-browser.html
index db38b02809..dadce99a7c 100644
--- a/ts/docs/overview/action-browser.html
+++ b/ts/docs/overview/action-browser.html
@@ -43,7 +43,9 @@
 .cell.k-action,.cell.k-command{cursor:pointer;}
 .lbl{position:absolute;inset:0;padding:10px 12px;display:flex;flex-direction:column;gap:3px;
   justify-content:flex-start;color:#fff;text-shadow:0 1px 3px rgba(0,0,0,.6);pointer-events:none;}
-.lbl-name{font-weight:650;line-height:1.15;word-break:break-word;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden;}
+/* line-height leaves room for emoji glyphs (taller than text); flex-shrink:0 keeps the
+   name at full line height on short tiles instead of squashing and clipping the glyphs. */
+.lbl-name{font-weight:650;line-height:1.3;flex-shrink:0;word-break:break-word;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden;}
 .lbl-sub{opacity:.85;font-weight:500;}
 .cell.sm .lbl{padding:4px 6px;gap:1px;}
 .cell.tiny .lbl{display:none;}
@@ -79,6 +81,14 @@
 .p-list{margin:0;padding-left:18px;}
 .p-list li{margin:3px 0;}
 .p-list code{background:#0c111b;padding:1px 5px;border-radius:5px;}
+/* cross-links between a command and its equivalent action */
+.p-xlink{display:flex;align-items:center;flex-wrap:wrap;gap:8px;margin:0 0 12px;}
+.p-xlabel{font-size:11px;text-transform:uppercase;letter-spacing:.05em;color:var(--muted);}
+.p-link{appearance:none;border:1px solid var(--line);background:var(--chip);color:var(--chip-fg);font-family:ui-monospace,Consolas,monospace;font-size:13px;padding:3px 10px;border-radius:999px;cursor:pointer;}
+.p-link:hover{border-color:var(--accent);}
+.p-xnote{color:var(--muted);font-family:ui-monospace,Consolas,monospace;font-size:13px;}
+.cov-chip{margin-left:auto;font-size:12px;color:var(--muted);white-space:nowrap;align-self:center;}
+.cell.linked::after{content:'\21c4';position:absolute;top:4px;right:6px;font-size:11px;color:#fff;opacity:.75;pointer-events:none;text-shadow:0 1px 2px rgba(0,0,0,.6);}
 /* nested containers (root view: agents shown inside their category) */
 .cell.container{cursor:pointer;}
 .cell .lbl.hdr{position:absolute;left:0;right:0;top:0;bottom:auto;height:auto;flex-direction:row;flex-wrap:nowrap;align-items:baseline;gap:8px;padding:5px 11px;overflow:hidden;}
@@ -134,12 +144,12 @@
 <header>
 <div class="titlebar">
 <h1>🧭 TypeAgent Action Browser</h1>
-<span class="meta">32 agents · 553 actions · 325 system commands · generated 2026-07-17 18:06:54 UTC</span>
+<span class="meta">33 agents · 557 actions · 411 commands · generated 2026-07-29 14:39:02 UTC</span>
 </div>
 <div class="controls">
 <div class="tabs">
 <button class="tab active" data-mode="agents">Agents</button>
-<button class="tab" data-mode="commands">System commands</button>
+<button class="tab" data-mode="commands">Commands</button>
 </div>
 <nav id="breadcrumb" class="breadcrumb"></nav>
 <input id="q" class="search" type="search" autocomplete="off" placeholder="Search actions, parameters, phrasings…" />
@@ -157,7 +167,7 @@ <h1>🧭 TypeAgent Action Browser</h1>
 </div>
 <div id="dlgBody" class="dlg-body"></div>
 </div>
-<script id="data" type="application/json">{"generatedAt":"2026-07-17T18:06:54.320Z","counts":{"agents":32,"actions":553,"commands":325},"agents":{"kind":"root","name":"Agents","children":[{"kind":"category","name":"Music & Entertainment","emoji":"🎵","children":[{"kind":"agent","name":"localPlayer","emoji":"🎵","description":"Agent to play local music files","children":[{"kind":"action","name":"addToQueue","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Add a file or files to the playback queue","parameters":[{"name":"fileName","type":"string","optional":false,"description":"File name or path to add to queue"}],"phrasings":[]},{"kind":"action","name":"changeVolume","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Change volume by a relative amount","parameters":[{"name":"amount","type":"number","optional":false,"description":"Amount to change volume by (can be negative)"}],"phrasings":["turn down volume","turn up volume"]},{"kind":"action","name":"clearQueue","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Clear the playback queue","parameters":[],"phrasings":["clear queue"]},{"kind":"action","name":"listFiles","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"List audio files in the music folder or a specified folder","parameters":[{"name":"folderPath","type":"string","optional":true,"description":"Folder to list (defaults to music folder)"}],"phrasings":[]},{"kind":"action","name":"mute","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Mute or unmute audio","parameters":[{"name":"isMuted","type":"boolean","optional":false,"description":"true to mute, false to unmute"}],"phrasings":["unmute","mute"]},{"kind":"action","name":"next","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Skip to next track","parameters":[],"phrasings":["next"]},{"kind":"action","name":"pause","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Pause playback","parameters":[],"phrasings":["pause"]},{"kind":"action","name":"playFile","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Play a specific audio file by path or name","parameters":[{"name":"fileName","type":"string","optional":false,"description":"File name or path to play (can be partial match)"}],"phrasings":[]},{"kind":"action","name":"playFolder","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Play all audio files in a folder","parameters":[{"name":"folderPath","type":"string","optional":true,"description":"Folder path to play from"},{"name":"shuffle","type":"boolean","optional":true,"description":"Whether to shuffle the tracks"}],"phrasings":[]},{"kind":"action","name":"playFromQueue","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Play a specific track from the current queue by index","parameters":[{"name":"trackNumber","type":"number","optional":false,"description":"1-based index of the track in the queue"}],"phrasings":[]},{"kind":"action","name":"previous","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Go to previous track","parameters":[],"phrasings":["previous"]},{"kind":"action","name":"repeat","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Set repeat mode","parameters":[{"name":"mode","type":"\"off\" | \"one\" | \"all\"","optional":false,"description":"Repeat mode: \"off\", \"one\" (repeat current track), \"all\" (repeat queue)"}],"phrasings":[]},{"kind":"action","name":"resume","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Resume playback","parameters":[],"phrasings":["resume"]},{"kind":"action","name":"searchFiles","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Search for audio files by name","parameters":[{"name":"query","type":"string","optional":false,"description":"Search query to match against file names"}],"phrasings":[]},{"kind":"action","name":"setMusicFolder","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Set the default music folder path","parameters":[{"name":"folderPath","type":"string","optional":false,"description":"Path to the music folder"}],"phrasings":[]},{"kind":"action","name":"setVolume","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Set volume to a specific level (0-100)","parameters":[{"name":"level","type":"number","optional":false,"description":"New volume level (0-100)"}],"phrasings":[]},{"kind":"action","name":"showMusicFolder","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Show the current music folder path","parameters":[],"phrasings":[]},{"kind":"action","name":"showQueue","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Show the current playback queue","parameters":[],"phrasings":["show queue"]},{"kind":"action","name":"shuffle","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Turn shuffle on or off","parameters":[{"name":"on","type":"boolean","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"status","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Show now playing status including track information and playback state","parameters":[],"phrasings":["what 's"]},{"kind":"action","name":"stop","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Stop playback completely","parameters":[],"phrasings":["stop"]}]},{"kind":"agent","name":"player","emoji":"🎧","description":"Agent to play music","children":[{"kind":"action","name":"addCurrentTrackToPlaylist","agent":"player","schema":"player","enabled":true,"transient":false,"description":"add the currently playing track to a playlist","parameters":[{"name":"name","type":"string","optional":false,"description":"name of playlist to add the current track to"}],"phrasings":[]},{"kind":"action","name":"addSongsToPlaylist","agent":"player","schema":"player","enabled":true,"transient":false,"description":"add songs to a playlist by specifying track names and optional artists this action searches for each song and adds it to the playlist","parameters":[{"name":"name","type":"string","optional":false,"description":"name of playlist to add songs to"},{"name":"songs","type":"{ … }[]","optional":false,"description":"list of songs to add, each specified by track name and optional artist/album"}],"phrasings":[]},{"kind":"action","name":"addToPlaylistFromCurrentTrackList","agent":"player","schema":"player","enabled":true,"transient":false,"description":"add to the named playlist one or more tracks starting at index 'trackNumber' in the current track list","parameters":[{"name":"name","type":"string","optional":false,"description":"name of playlist to add the track to"},{"name":"trackNumber","type":"number","optional":false,"description":"1-based index of the first track to add"},{"name":"trackCount","type":"number","optional":true,"description":"number of tracks to add (default 1) if specified, adds this many tracks starting from trackNumber; for example, to add tracks 3,4,5 set trackNumber=3 and trackCount=3"}],"phrasings":[]},{"kind":"action","name":"changeVolume","agent":"player","schema":"player","enabled":true,"transient":false,"description":"change volume plus or minus a specified percentage","parameters":[{"name":"volumeChangePercentage","type":"number","optional":false,"description":"volume change percentage"}],"phrasings":[]},{"kind":"action","name":"createPlaylist","agent":"player","schema":"player","enabled":true,"transient":false,"description":"create a new playlist, optionally with a list of songs specified by title and artist","parameters":[{"name":"name","type":"string","optional":false,"description":"name of playlist to create"},{"name":"songs","type":"{ … }[]","optional":true,"description":"optional list of songs to add to the playlist when creating it"}],"phrasings":[]},{"kind":"action","name":"deletePlaylist","agent":"player","schema":"player","enabled":true,"transient":false,"description":"delete a playlist","parameters":[{"name":"name","type":"string","optional":false,"description":"name of playlist to delete"}],"phrasings":[]},{"kind":"action","name":"findMusic","agent":"player","schema":"player","enabled":true,"transient":false,"description":"Find / search for / look up music and show it as the current track list WITHOUT starting playback. Use this for \"find\", \"look for\", \"search for\", \"show me\" music — a specific song, artist, album, genre, a free-form description (e.g. \"the best guitar solos\"), or playlists. To start playing immediately instead, use PlayMusicAction.","parameters":[{"name":"target","type":"PlayByTrack | PlayByArtist | PlayByAlbum | PlayByGenre | PlayByPlaylist | PlayByDescription | PlayAnyMusic","optional":false,"description":"What music to look for. Same choices as PlayMusicAction's target."},{"name":"play","type":"boolean","optional":true,"description":"Set true ONLY when the user asks to find something AND play it in the same breath (e.g. \"find some Bach and play it\"). Leave unset for a plain search / \"show me\"."},{"name":"quantity","type":"number","optional":true,"description":"number of tracks when the user asks for a specific amount"}],"phrasings":[]},{"kind":"action","name":"getAlbum","agent":"player","schema":"player","enabled":true,"transient":false,"description":"get currently playing album set the current track list the tracks in the album","parameters":[],"phrasings":[]},{"kind":"action","name":"getFavorites","agent":"player","schema":"player","enabled":true,"transient":false,"description":"result of this action is an entity of type 'track-list' with the user's favorites","parameters":[{"name":"count","type":"number","optional":true,"description":"number of favorites to get"}],"phrasings":[]},{"kind":"action","name":"getFromCurrentPlaylistList","agent":"player","schema":"player","enabled":true,"transient":false,"description":"","parameters":[{"name":"playlistNumber","type":"number","optional":false,"description":"1-base index of playlist in the current playlist list to get"}],"phrasings":[]},{"kind":"action","name":"getPlaylist","agent":"player","schema":"player","enabled":true,"transient":false,"description":"get playlist by name","parameters":[{"name":"name","type":"string","optional":false,"description":"name of playlist to get"}],"phrasings":[]},{"kind":"action","name":"getQueue","agent":"player","schema":"player","enabled":true,"transient":false,"description":"set the current track list to the queue of upcoming tracks","parameters":[],"phrasings":[]},{"kind":"action","name":"listDevices","agent":"player","schema":"player","enabled":true,"transient":false,"description":"list available playback devices","parameters":[],"phrasings":[]},{"kind":"action","name":"listPlaylists","agent":"player","schema":"player","enabled":true,"transient":false,"description":"list all playlists","parameters":[],"phrasings":[]},{"kind":"action","name":"next","agent":"player","schema":"player","enabled":true,"transient":false,"description":"next track","parameters":[],"phrasings":["skip track","skip","next"]},{"kind":"action","name":"pause","agent":"player","schema":"player","enabled":true,"transient":false,"description":"pause playback","parameters":[],"phrasings":["pause the music","pause music","pause"]},{"kind":"action","name":"playFromCurrentTrackList","agent":"player","schema":"player","enabled":true,"transient":false,"description":"play the track single track at index 'trackNumber' in the current track list report if there is no current track list","parameters":[{"name":"trackNumber","type":"number","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"playMusic","agent":"player","schema":"player","enabled":true,"transient":false,"description":"Start playing music now. Use this when the user wants to play / put on / start / listen to music — a specific song, artist, album, genre, a free-form description (e.g. \"chill music for studying\"), or just \"some music\". To search for or browse music WITHOUT starting playback, use FindMusicAction.","parameters":[{"name":"target","type":"PlayByTrack | PlayByArtist | PlayByAlbum | PlayByGenre | PlayByPlaylist | PlayByDescription | PlayAnyMusic","optional":false,"description":"What music to select. Pick the ONE variant that best matches what the user named. If it isn't clearly one artist / album / genre, use { kind: \"description\" } with the user's own words as the query."},{"name":"quantity","type":"number","optional":true,"description":"number of tracks when the user asks for a specific amount"}],"phrasings":[]},{"kind":"action","name":"playPlaylist","agent":"player","schema":"player","enabled":true,"transient":false,"description":"play the named play list","parameters":[{"name":"name","type":"string","optional":false,"description":"name of playlist to play"}],"phrasings":[]},{"kind":"action","name":"previous","agent":"player","schema":"player","enabled":true,"transient":false,"description":"previous track User: play the last song again","parameters":[],"phrasings":[]},{"kind":"action","name":"resumePlayback","agent":"player","schema":"player","enabled":true,"transient":false,"description":"Resume or continue playback of the current track after it was paused or stopped. This simply un-pauses and keeps the current music going; it does not select a new song, so no specific song needs to be identified.","parameters":[],"phrasings":["resume the music","resume music","resume"]},{"kind":"action","name":"selectDevice","agent":"player","schema":"player","enabled":true,"transient":false,"description":"select playback device by keyword","parameters":[{"name":"deviceName","type":"string","optional":false,"description":"device name such as \"bedroom\", \"living room\", \"whole house\", \"office computer\", etc."}],"phrasings":[]},{"kind":"action","name":"setDefaultDevice","agent":"player","schema":"player","enabled":true,"transient":false,"description":"","parameters":[{"name":"deviceName","type":"string","optional":true,"description":"device name.  If not specified, the current selected device is set as the default."}],"phrasings":[]},{"kind":"action","name":"setMaxVolume","agent":"player","schema":"player","enabled":true,"transient":false,"description":"set max volume for the current device","parameters":[{"name":"newMaxVolumeLevel","type":"number","optional":false,"description":"new volume level"}],"phrasings":[]},{"kind":"action","name":"setVolume","agent":"player","schema":"player","enabled":true,"transient":false,"description":"set volume","parameters":[{"name":"newVolumeLevel","type":"number","optional":false,"description":"new volume level"}],"phrasings":[]},{"kind":"action","name":"showSelectedDevice","agent":"player","schema":"player","enabled":true,"transient":false,"description":"show the selected playback device","parameters":[],"phrasings":[]},{"kind":"action","name":"shuffle","agent":"player","schema":"player","enabled":true,"transient":false,"description":"turn shuffle on or off","parameters":[{"name":"on","type":"boolean","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"status","agent":"player","schema":"player","enabled":true,"transient":false,"description":"show now playing including track information, and playback status including playback device","parameters":[],"phrasings":[]}]}]},{"kind":"category","name":"Creative & Media","emoji":"🎨","children":[{"kind":"agent","name":"image","emoji":"🖼️","description":"Agent to create AI images","children":[{"kind":"action","name":"createImageAction","agent":"image","schema":"image","enabled":true,"transient":false,"description":"creates an image based on the supplied description","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"},{"name":"caption","type":"string","optional":false,"description":"the image caption"},{"name":"numImages","type":"number","optional":false,"description":"the number of images to generate"}],"phrasings":[]},{"kind":"action","name":"editImageAction","agent":"image","schema":"image","enabled":true,"transient":false,"description":"Edits / transforms an image the user has already supplied (typically the most recent attachment). Use this for requests like \"cartoonize that image\", \"make a watercolor version of this photo\", \"stylize this as a pencil sketch\", etc.","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"},{"name":"editPrompt","type":"string","optional":false,"description":"The natural-language description of the edit to perform (e.g. \"cartoonize\", \"make this a watercolor painting\")."},{"name":"sourceImage","type":"string","optional":false,"description":"The file name of the source image to edit. This MUST be the exact name of an image that is either (a) attached to the current request, or (b) listed as an image entity from a recent turn (e.g. `generated_images/\u003cuuid>.png` from a prior editImageAction / createImageAction result). NEVER invent a filename — if no such image is available, do not emit this action; ask the user to attach an image instead."}],"phrasings":[]}]},{"kind":"agent","name":"markdown","emoji":"🗎","description":"Agent to create and update markdown files","children":[{"kind":"action","name":"createDocument","agent":"markdown","schema":"markdown","enabled":true,"transient":false,"description":"creates a new markdown document","parameters":[{"name":"name","type":"string","optional":false,"description":"the name to use for the document"}],"phrasings":[]},{"kind":"action","name":"openDocument","agent":"markdown","schema":"markdown","enabled":true,"transient":false,"description":"opens an existing markdown document","parameters":[{"name":"name","type":"string","optional":false,"description":"the name to use for the document"}],"phrasings":[]},{"kind":"action","name":"streamingUpdateDocument","agent":"markdown","schema":"markdown","enabled":true,"transient":false,"description":"Updates the document with streaming support for real-time AI operations","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"},{"name":"cursorPosition","type":"number","optional":true,"description":"cursor position where the user invoked the command"},{"name":"context","type":"string","optional":true,"description":"additional context information from the editor (serialized as JSON string)"},{"name":"generatedContent","type":"string","optional":true,"description":"Stream-friendly properties that can be updated incrementally"},{"name":"progressStatus","type":"string","optional":true,"description":""},{"name":"validationResults","type":"string","optional":true,"description":""},{"name":"aiCommand","type":"\"continue\" | \"diagram\" | \"augment\" | \"research\"","optional":true,"description":"AI command type for specialized processing"}],"phrasings":[]},{"kind":"action","name":"updateDocument","agent":"markdown","schema":"markdown","enabled":true,"transient":false,"description":"Updates the document by adding, removing or editing parts of the document.","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"},{"name":"cursorPosition","type":"number","optional":true,"description":"cursor position where the user invoked the command"},{"name":"context","type":"string","optional":true,"description":"additional context information from the editor (serialized as JSON string)"}],"phrasings":[]}]},{"kind":"agent","name":"montage","emoji":"🎞","description":"Agent to create photo montages.","children":[{"kind":"action","name":"addPhotos","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"add photos to the montage","parameters":[{"name":"title","type":"string","optional":false,"description":"title of the montage"},{"name":"files","type":"string[]","optional":true,"description":"placeholder for images to be populated later"},{"name":"search_filters","type":"string[]","optional":true,"description":"always empty"}],"phrasings":[]},{"kind":"action","name":"changeTitle","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Changes the montage title","parameters":[{"name":"title","type":"string","optional":false,"description":"current title of the montage to change"},{"name":"newTitle","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"clearSelectedPhotos","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Clears the currently selected images","parameters":[{"name":"title","type":"string","optional":false,"description":"title of the montage"}],"phrasings":[]},{"kind":"action","name":"createNewMontage","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Creates a new montage","parameters":[{"name":"title","type":"string","optional":false,"description":"Montage title, defaults to \"Untitled\""},{"name":"search_filters","type":"string[]","optional":true,"description":"any search terms to use to seed the montage based off of the title"},{"name":"focus","type":"boolean","optional":false,"description":"a flag indicating if the UI should immediately switch to this montage, defaults to true"},{"name":"files","type":"string[]","optional":true,"description":"placeholder for images to be populated later"}],"phrasings":[]},{"kind":"action","name":"deleteAllMontages","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"deleteMontage","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Deletes the identified montage","parameters":[{"name":"title","type":"string","optional":false,"description":"The title of the montage to delete"}],"phrasings":[]},{"kind":"action","name":"listMontages","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Lists all montages by name","parameters":[],"phrasings":[]},{"kind":"action","name":"mergeMontages","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Merges two or more montages together","parameters":[{"name":"mergedMontageTitle","type":"string","optional":false,"description":"The title of the merged montage"},{"name":"titles","type":"string[]","optional":true,"description":"The titles of the montages to merge"},{"name":"ids","type":"number[]","optional":true,"description":"THe ids of the montages to merge"}],"phrasings":[]},{"kind":"action","name":"openMontage","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Open a montage for viewing and editing","parameters":[{"name":"title","type":"string","optional":false,"description":"title of the montage"}],"phrasings":[]},{"kind":"action","name":"removePhotos","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Removes the images that match the supplied criteria","parameters":[{"name":"title","type":"string","optional":false,"description":"title of the montage"},{"name":"search_filters","type":"string[]","optional":true,"description":"any search terms to use indicating the photos to remove"},{"name":"indices","type":"number[]","optional":true,"description":"any indices provided indicating the photos to remove from the set of available images"},{"name":"selected","type":"\"selected\" | \"inverse\" | \"all\"","optional":true,"description":"flag indicating if we are remove selected images or inverse"},{"name":"files","type":"string[]","optional":true,"description":"placeholder for images to be populated later"}],"phrasings":[]},{"kind":"action","name":"selectPhotos","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Select images in an existing montage","parameters":[{"name":"title","type":"string","optional":false,"description":"title of the montage"},{"name":"search_filters","type":"string[]","optional":true,"description":"any search terms to use indicating the photos to remove"},{"name":"indices","type":"number[]","optional":true,"description":"any indices provided indicating the photos to remove from the set of available images"},{"name":"files","type":"string[]","optional":true,"description":"placeholder for images to be populated later"}],"phrasings":[]},{"kind":"action","name":"setMontageViewMode","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"","parameters":[{"name":"viewMode","type":"\"grid\" | \"filmstrip\"","optional":false,"description":"The view mode to set"}],"phrasings":[]},{"kind":"action","name":"setSearchParameters","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Update search parameters","parameters":[{"name":"minSearchScore","type":"number","optional":true,"description":"search score value starts at 0"},{"name":"exactMatch","type":"boolean","optional":true,"description":"only return exact matches?"}],"phrasings":[]},{"kind":"action","name":"showSearchParameters","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Shows search parameters","parameters":[],"phrasings":[]},{"kind":"action","name":"startSlideShow","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Starts a slide show with the images in the active montage","parameters":[{"name":"title","type":"string","optional":false,"description":""}],"phrasings":[]}]},{"kind":"agent","name":"photo","emoji":"📷","description":"Agent to take and upload photos","children":[{"kind":"action","name":"takePhoto","agent":"photo","schema":"photo","enabled":true,"transient":false,"description":"uses a camera attached to the system to take a photo","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"}],"phrasings":[]}]},{"kind":"agent","name":"screencapture","emoji":"🎥","description":"Take screenshots and record the screen or specific application windows","children":[{"kind":"action","name":"listWindows","agent":"screencapture","schema":"screencapture","enabled":true,"transient":false,"description":"List all currently visible windows so the user can target them by name.","parameters":[],"phrasings":["programs are running","windows are open","show me open windows","open windows","windows"]},{"kind":"action","name":"recording","agent":"screencapture","schema":"screencapture","enabled":true,"transient":false,"description":"Activity type tracked while a recording is in progress.","parameters":[{"name":"target","type":"string","optional":true,"description":""},{"name":"outputPath","type":"string","optional":false,"description":""},{"name":"startedAtMs","type":"number","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"startRecording","agent":"screencapture","schema":"screencapture","enabled":true,"transient":false,"description":"Start a screen recording. Same `target` semantics as takeScreenshot. Only one recording can be active at a time.","parameters":[{"name":"target","type":"string","optional":true,"description":""}],"phrasings":["record {target}","begin recording {target}","start recording {target}","desktop","screen","begin recording screen","a screen recording","recording"]},{"kind":"action","name":"stopRecording","agent":"screencapture","schema":"screencapture","enabled":true,"transient":false,"description":"Stop the currently active screen recording.","parameters":[],"phrasings":["finish recording","end recording","the recording","recording"]},{"kind":"action","name":"takeScreenshot","agent":"screencapture","schema":"screencapture","enabled":true,"transient":false,"description":"Take a screenshot. If `target` is omitted the whole primary screen is captured; otherwise `target` is a program or window name to fuzzy-match against the currently visible windows (e.g. \"Chrome\", \"Visual Studio\").","parameters":[{"name":"target","type":"string","optional":true,"description":""}],"phrasings":["screenshot {target}","capture {target}","take a screenshot of {target}","desktop","screen","capture screen","take a screenshot"]}]},{"kind":"agent","name":"video","emoji":"📹","description":"Agent to create AI videos","children":[{"kind":"action","name":"createVideoAction","agent":"video","schema":"video","enabled":true,"transient":false,"description":"creates a video based on the supplied description","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"},{"name":"caption","type":"string","optional":false,"description":"the video caption"},{"name":"relatedFiles","type":"string[]","optional":true,"description":"The file names of any attachments the user provided"},{"name":"duration","type":"\"4\" | \"8\" | \"12\"","optional":true,"description":"The duration in seconds (default is 4 seconds)"}],"phrasings":[]}]}]},{"kind":"category","name":"Productivity","emoji":"📅","children":[{"kind":"agent","name":"calendar","emoji":"📅","description":"Agent integration with MS Graph's calendar","children":[{"kind":"action","name":"addParticipant","agent":"calendar","schema":"calendar","enabled":true,"transient":false,"description":"Add a participant to an event Examples: \"add John to the meeting\", \"invite Sarah to lunch\"","parameters":[{"name":"description","type":"string","optional":false,"description":"Which event to add to (required) - plain string"},{"name":"participant","type":"string","optional":false,"description":"Who to add (required) - plain string"}],"phrasings":["include {participant} in {description}"]},{"kind":"action","name":"findEvents","agent":"calendar","schema":"calendar","enabled":true,"transient":false,"description":"Find events on the calendar Examples: \"find my meetings today\", \"show meetings with Bob\"","parameters":[{"name":"date","type":"string","optional":true,"description":"When to search (optional, defaults to future events) Use the user's EXACT words like \"today\", \"tomorrow\", \"this week\" - do NOT convert to ISO date"},{"name":"description","type":"string","optional":true,"description":"What type of event to find (optional, finds all if not specified) - plain string"},{"name":"participant","type":"string","optional":true,"description":"Find events with a specific participant (optional) - plain string"}],"phrasings":["what events do I have with {participant} on {date} about {description}","show me meetings about {description} scheduled for {date}","find all events on {date} that include {participant}"]},{"kind":"action","name":"findThisWeeksEvents","agent":"calendar","schema":"calendar","enabled":true,"transient":false,"description":"Find all events happening this week Examples: \"what do I have this week\", \"show my week\"","parameters":[],"phrasings":["find what I have scheduled this week","show me all my events for this week starting {startDay}","what's happening this week"]},{"kind":"action","name":"findTodaysEvents","agent":"calendar","schema":"calendar","enabled":true,"transient":false,"description":"Find all events happening today Examples: \"what do I have today\", \"show me today's schedule\"","parameters":[],"phrasings":["what I have scheduled for today","show me all my appointments and meetings for {date}","what's on my calendar {date}"]},{"kind":"action","name":"removeEvent","agent":"calendar","schema":"calendar","enabled":true,"transient":false,"description":"Remove an event from the calendar Examples: \"delete my meeting\", \"remove the dentist appointment\", \"cancel lunch with Bob\" Behavior based on number of matches: - 1 match: prompts for confirmation - 2-5 matches: prompts with list to select which event to delete - More than 5 matches: returns error asking user to be more specific","parameters":[{"name":"description","type":"string","optional":false,"description":"What event to remove (required) - plain string describing the event"},{"name":"date","type":"string","optional":true,"description":"Optional date filter to narrow down which event to remove Use the user's EXACT words like \"today\", \"tomorrow\", \"this week\" - do NOT convert to ISO date"}],"phrasings":[]},{"kind":"action","name":"scheduleEvent","agent":"calendar","schema":"calendar","enabled":true,"transient":false,"description":"Schedule a new event on the calendar Examples: \"schedule a meeting tomorrow at 2pm\", \"add dentist appointment on Friday at 3pm\"","parameters":[{"name":"description","type":"string","optional":false,"description":"What the event is about (required) - plain string, not an entity type"},{"name":"date","type":"string","optional":false,"description":"When the event occurs (required) - use the user's EXACT words like \"today\", \"tomorrow\", \"Friday\", \"next week\" Do NOT convert to ISO date format - the handler will parse temporal expressions"},{"name":"time","type":"string","optional":true,"description":"What time the event starts (optional, defaults to all-day if not specified) Use the user's EXACT words like \"2pm\", \"3:30\", \"noon\" - do NOT convert formats"},{"name":"location","type":"string","optional":true,"description":"Where the event takes place (optional) - plain string, not an entity type"},{"name":"participant","type":"string","optional":true,"description":"Who else should attend (optional, single participant) - plain string, not an entity type"}],"phrasings":["book {description} with {participant} at {location} {date} at {time}","set up {description} on {date} at {time}","schedule a {description} for {date} at {time} in {location} with {participant}"]}]},{"kind":"agent","name":"email","emoji":"📩","description":"Agent integration with MS Graph's email","children":[{"kind":"action","name":"findEmail","agent":"email","schema":"email","enabled":true,"transient":false,"description":"Type for finding an email message (search for emails)","parameters":[{"name":"messageRef","type":"{ senders, subject, content, receivedDateTime, srcFolder, destfolder }","optional":false,"description":"Reference to the email message to find"}],"phrasings":[]},{"kind":"action","name":"forwardEmail","agent":"email","schema":"email","enabled":true,"transient":false,"description":"Type for forwarding an email","parameters":[{"name":"to","type":"string[]","optional":false,"description":"Recipients"},{"name":"cc","type":"string[]","optional":true,"description":"Carbon copy recipients (optional)"},{"name":"bcc","type":"string[]","optional":true,"description":"Blind carbon copy recipients (optional)"},{"name":"additionalMessage","type":"string","optional":true,"description":"Additional message (optional), can be plain text or HTML and inferred from the user request"},{"name":"messageRef","type":"{ senders, subject, content, receivedDateTime, srcFolder, destfolder }","optional":false,"description":"Reference to the email message to forward"}],"phrasings":[]},{"kind":"action","name":"replyEmail","agent":"email","schema":"email","enabled":true,"transient":false,"description":"Type for replying to an email","parameters":[{"name":"body","type":"string","optional":true,"description":"Body content of the reply email (optional), can be plain text or HTML, generate the body based on the user input"},{"name":"cc","type":"string[]","optional":true,"description":"Carbon copy recipients (optional)"},{"name":"bcc","type":"string[]","optional":true,"description":"Blind carbon copy recipients (optional)"},{"name":"attachments","type":"string[]","optional":true,"description":"File paths or URLs of attachments (optional)"},{"name":"messageRef","type":"{ senders, subject, content, receivedDateTime, srcFolder, destfolder }","optional":false,"description":"Reference to the email message to reply to"}],"phrasings":[]},{"kind":"action","name":"sendEmail","agent":"email","schema":"email","enabled":true,"transient":false,"description":"Type for sending a simple email","parameters":[{"name":"subject","type":"string","optional":false,"description":"Subject of the email, infer the subject based on the user input"},{"name":"body","type":"string","optional":true,"description":"Body content of the email, can be plain text or HTML, generate the body based on the user input"},{"name":"to","type":"string[]","optional":false,"description":"Recipients, infer the recipients based on the user input but don't change strings so if the user types \"send email to Jen\" don't change it to an email address, just infer that \"Jen\" is one of the recipients"},{"name":"cc","type":"string[]","optional":true,"description":"Carbon copy recipients (optional), infere CC recipients based on the user input"},{"name":"bcc","type":"string[]","optional":true,"description":"Blind carbon copy recipients (optional), infer the BCC recipients based on the user input"},{"name":"attachments","type":"string[]","optional":true,"description":"File paths or URLs of attachments (optional)"},{"name":"genContent","type":"{ generateBody, bodySearchQuery }","optional":false,"description":"Information needed to generate the body content based on the user input"}],"phrasings":[]}]},{"kind":"agent","name":"list","emoji":"📝","description":"Agent to create and manage lists","children":[{"kind":"action","name":"addItems","agent":"list","schema":"list","enabled":true,"transient":false,"description":"add one or more items to a list; if the list does not exist, create it","parameters":[{"name":"items","type":"string[]","optional":false,"description":""},{"name":"listName","type":"string","optional":false,"description":"name of the list such as \"grocery\", \"to do\", \"shopping\", \"packing\", \"gift\",\"book\",\"idea\",\"movie\",\"garden task\",\"place to visit\" names should be lower case and should be stemmed to the singular form (e.g., \"movies\" should be \"movie\") IMPORTANT: Do not invent a list name. If the user uses a reference phrase (\"the list\", \"that list\",etc.) we should clarify with the user which list they meant unless it is obvious from the conversation history."}],"phrasings":[]},{"kind":"action","name":"clearList","agent":"list","schema":"list","enabled":true,"transient":false,"description":"","parameters":[{"name":"listName","type":"string","optional":false,"description":""}],"phrasings":["delete from {listName} list","empty {listName}","clear {listName} list"]},{"kind":"action","name":"createList","agent":"list","schema":"list","enabled":true,"transient":false,"description":"","parameters":[{"name":"listName","type":"string","optional":false,"description":""}],"phrasings":["start {listName} list","make {listName} list","create {listName} list"]},{"kind":"action","name":"getList","agent":"list","schema":"list","enabled":true,"transient":false,"description":"use this action to show the user what's on the list, for example, \"What's on my grocery list?\" or \"what are the contents of my to do list?\"","parameters":[{"name":"listName","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"removeItems","agent":"list","schema":"list","enabled":true,"transient":false,"description":"remove one or more items from a list","parameters":[{"name":"items","type":"string[]","optional":false,"description":""},{"name":"listName","type":"string","optional":false,"description":""}],"phrasings":["take {item} off {listName}","delete {item} from {listName}","remove {item} from {listName} list"]},{"kind":"action","name":"startEditList","agent":"list","schema":"list","enabled":true,"transient":false,"description":"","parameters":[{"name":"listName","type":"string","optional":false,"description":""}],"phrasings":[]}]},{"kind":"agent","name":"timer","emoji":"⏰","description":"Agent for setting reminders that fire as agent-initiated messages","children":[{"kind":"action","name":"cancelReminder","agent":"timer","schema":"timer","enabled":true,"transient":false,"description":"Cancel a pending reminder by id, or all reminders.","parameters":[{"name":"id","type":"string","optional":false,"description":"The reminder id (returned from setReminder), or \"all\" to cancel every pending reminder."}],"phrasings":["clear reminders","all reminders"]},{"kind":"action","name":"listReminders","agent":"timer","schema":"timer","enabled":true,"transient":false,"description":"List all pending reminders.","parameters":[],"phrasings":["what reminders","reminders"]},{"kind":"action","name":"repeatReminder","agent":"timer","schema":"timer","enabled":true,"transient":false,"description":"Set a repeating reminder. Fires every `every` interval until cancelled (or until `count` fires have elapsed if specified). Useful for stress testing rapid-fire / back-to-back agent-initiated messages.","parameters":[{"name":"message","type":"string","optional":false,"description":"What to remind the user about."},{"name":"every","type":"string","optional":false,"description":"Interval between fires. Same format as SetReminder.when — a duration like \"5s\", \"10m\", \"1h\"."},{"name":"kind","type":"\"bubble\" | \"toast\" | \"inline\"","optional":true,"description":"Render style for each fire. Defaults to \"bubble\"."},{"name":"count","type":"number","optional":true,"description":"Optional max number of times to fire. If omitted, fires until explicitly cancelled."}],"phrasings":["inline","toast"]},{"kind":"action","name":"setReminder","agent":"timer","schema":"timer","enabled":true,"transient":false,"description":"Set a reminder. When it fires, the timer agent pushes a message to the user via SessionContext.beginAgentThread (an agent-initiated thread, not a response to a user request).","parameters":[{"name":"message","type":"string","optional":false,"description":"What to remind the user about."},{"name":"when","type":"string","optional":false,"description":"When to fire. Either a duration like \"5s\", \"10m\", \"1h\", \"30 minutes\", or an absolute ISO 8601 timestamp like \"2026-05-04T15:30:00\"."},{"name":"kind","type":"\"bubble\" | \"toast\" | \"inline\"","optional":true,"description":"How the fired reminder should render. Defaults to \"bubble\"."}],"phrasings":["bubble","inline","toast"]}]}]},{"kind":"category","name":"Communication","emoji":"💬","children":[{"kind":"agent","name":"chat","emoji":"💬","description":"Agent for conversation and information lookup","children":[{"kind":"action","name":"generateResponse","agent":"chat","schema":"chat","enabled":true,"transient":false,"description":"this is the way to handle requests for known information that is not stored in application memory or conversation memory, such as facts, definitions, explanations, captioning, or other information that can be generated without a lookup if the user request is a known phrase that is unrelated to the context, use this action to generate an explanation for the known phrase. this action is never used when the request is for private information from past conversations including private events, plans, projects in progress, and other items from discussions with team members or the assistant, unless the information is present in the chat history","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request from the user"},{"name":"generatedText","type":"string","optional":false,"description":"the generated text to show the user; this should be a complete response to the user's request"},{"name":"userRequestEntities","type":"{ … }[]","optional":false,"description":"ALL the actions and entities present in the text of the user's request including attachments"},{"name":"generatedTextEntities","type":"{ … }[]","optional":false,"description":"ALL the actions and entities present in the generated text"},{"name":"relatedFiles","type":"string[]","optional":true,"description":"The file names of any attachments"}],"phrasings":[]},{"kind":"action","name":"showImageFile","agent":"chat","schema":"chat","enabled":true,"transient":false,"description":"","parameters":[{"name":"files","type":"string[]","optional":false,"description":"file entities."}],"phrasings":[]}]},{"kind":"agent","name":"discord","emoji":"💬","description":"Discord chat agent — send messages, draft messages from intent, list channels, browse channel history, manage server/channel invites.","children":[{"kind":"action","name":"addThreadMember","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Add another member to a thread.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the thread."},{"name":"user_id","type":"string","optional":false,"description":"The ID of the user to add."}],"phrasings":["bring {user_id} into thread {channel_id}","include {user_id} in thread {channel_id}","invite {user_id} to thread {channel_id}","add user {user_id} to thread {channel_id}"]},{"kind":"action","name":"craftMessage","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Drafts a message via LLM from a high-level intent, then posts it. Use when the user describes what the message should convey (\"that ...\", \"to ...\", \"about ...\", \"reminding ...\", \"asking ...\") instead of supplying literal content. Sample phrases: - \"Send a message to #general that welcomes everyone to the discord\" - \"Send a message to #general to remind everyone about tonight's plans\" - \"Post a message in #announcements about the new release\" - \"Write a message in #random asking who's free tomorrow\" - \"Send a message in #events reminding people to RSVP\"","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"Single channel token (ID, bare name, or \"#name\"). Must not contain spaces — anything after the channel belongs in `intent`."},{"name":"intent","type":"string","optional":false,"description":"What the message should convey — everything the user said about the message after the channel and connector word."},{"name":"tts","type":"boolean","optional":true,"description":"Whether the message should be sent as text-to-speech."}],"phrasings":["create a message in {channel_id} that {intent}","write a message to {channel_id} that {intent}","post a message to {channel_id} that {intent}","send a message to {channel_id} that {intent}"]},{"kind":"action","name":"createChannelInvite","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Create a new invite for a channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID or name of the channel."},{"name":"max_age","type":"number","optional":true,"description":"Duration of invite in seconds (0 = never expires)."},{"name":"never_expires","type":"boolean","optional":true,"description":"If true, the invite never expires (sets max_age to 0)."},{"name":"max_uses","type":"number","optional":true,"description":"Max number of uses (0 = unlimited)."},{"name":"temporary","type":"boolean","optional":true,"description":"Whether the invite is temporary."},{"name":"unique","type":"boolean","optional":true,"description":"Whether the invite is unique."}],"phrasings":["I need an invite for channel {channel_id}","generate a invite for channel {channel_id}","make a invite for {channel_id} that doesn't expire","make a invite for channel {channel_id}","create a permanent invite for {channel_id}","create a invite for {channel_id} that doesn't expire","create a invite for channel {channel_id}"]},{"kind":"action","name":"createDM","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Create a new DM channel with a user. Returns a DM channel object. Sample phrases: - \"Can you start a direct message with user ID 123456?\" - \"I'd like to create a DM channel with the user whose ID is 123456.\" - \"Please open a new DM with the user having the ID 123456.\"","parameters":[{"name":"recipient_id","type":"string","optional":false,"description":"The ID of the recipient user."}],"phrasings":["message user {recipient_id}","DM user {recipient_id}","create a DM with user {recipient_id}","start a direct message with {recipient_id}"]},{"kind":"action","name":"createGroupDM","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Create a new group DM channel with multiple users. Returns a DM channel object. Sample phrases: - \"Can you start a new group DM with these friends?\" - \"Create a group chat with these people, please.\" - \"I'd like to set up a group DM with my buddies.\"","parameters":[{"name":"access_tokens","type":"string[]","optional":true,"description":"The access tokens for the users to be added to the group DM."},{"name":"nicks","type":"string","optional":true,"description":"Comma-separated nickname mappings (e.g. \"userId1:nick1,userId2:nick2\")."}],"phrasings":["make a group DM","start a group direct message {access_tokens}","set up a group chat {access_tokens}","start a group DM"]},{"kind":"action","name":"createGuild","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Creates a new guild. Sample phrases: - \"Can you create a new guild for me called 'Knights of Valor' in the US region with this icon?\" - \"I need a new guild named 'Dragon Slayers' in the EU region. Use this icon for it.\" - \"Please set up a guild called 'Mystic Warriors' in the Asia region and use this icon.\"","parameters":[{"name":"name","type":"string","optional":false,"description":"The name of the guild."},{"name":"region","type":"string","optional":true,"description":"The region where the guild will be created."},{"name":"icon","type":"string","optional":true,"description":"The icon for the guild."}],"phrasings":["make a guild called {name}","I need a new guild called {name}","set up a guild called {name}","create a guild called {name}"]},{"kind":"action","name":"createMessage","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Creates a new message in a specified channel. Sample phrases: - \"Send a message to the general channel saying 'Hello everyone!'\" - \"Post 'Meeting starts at 3 PM' in the announcements channel, please.\" - \"Can you create a new message in the #updates channel with the text 'New features are live!'?\"","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel where the message will be sent."},{"name":"content","type":"string","optional":false,"description":"The content of the message."},{"name":"nonce","type":"string","optional":true,"description":"A unique identifier for the message."},{"name":"tts","type":"boolean","optional":true,"description":"Whether the message should be sent as text-to-speech."}],"phrasings":[]},{"kind":"action","name":"createWebhook","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Creates a new webhook in a specified channel. Sample phrases: - \"Can you set up a new webhook in the channel with ID 12345? Name it 'Updates' and use the avatar image from this link.\" - \"Please create a webhook named 'Alerts' in the channel 67890 and use this avatar for it.\" - \"I need a new webhook in channel 54321 called 'Notifications'. Use this avatar image for it.\"","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel where the webhook will be created."},{"name":"name","type":"string","optional":false,"description":"The name of the webhook."},{"name":"avatar","type":"string","optional":true,"description":"The avatar for the webhook."}],"phrasings":["add a webhook called {name} to channel {channel_id}","I need a webhook called {name} in channel {channel_id}","make a webhook called {name} in channel {channel_id}","create a webhook called {name} in channel {channel_id}"]},{"kind":"action","name":"deleteChannel","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Delete a channel or close a private message.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel to delete."}],"phrasings":["destroy channel {channel_id}","I want to delete channel {channel_id}","remove channel {channel_id}","delete channel {channel_id}"]},{"kind":"action","name":"deleteChannelPermission","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Delete a permission overwrite from a channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel."},{"name":"overwrite_id","type":"string","optional":false,"description":"The ID of the overwrite to delete."}],"phrasings":["clear permission {overwrite_id} from channel {channel_id}","revoke permission {overwrite_id} from channel {channel_id}","remove permission override {overwrite_id} from channel {channel_id}","delete permission {overwrite_id} from channel {channel_id}"]},{"kind":"action","name":"deleteInvite","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Delete an invite. Requires the MANAGE_CHANNELS permission on the channel this invite belongs to, or MANAGE_GUILD to remove any invite across the guild. Sample phrases: - \"Can you delete the invite with code ABC123?\" - \"Please remove the invite link with the code XYZ789.\" - \"I need you to delete the invite that has the code LMN456.\"","parameters":[{"name":"invite_code","type":"string","optional":false,"description":"The code of the invite to delete."}],"phrasings":["revoke invite {invite_code}","I need you to delete invite {invite_code}","remove invite {invite_code}","delete invite {invite_code}"]},{"kind":"action","name":"editChannelPermissions","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Edit the permissions of a channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel."},{"name":"overwrite_id","type":"string","optional":true,"description":"The ID of the overwrite (user or role)."},{"name":"allow","type":"string","optional":true,"description":"The allow permission bitfield."},{"name":"deny","type":"string","optional":true,"description":"The deny permission bitfield."},{"name":"type","type":"number","optional":true,"description":"The type of the overwrite (0 = role, 1 = member)."}],"phrasings":["configure permissions for channel {channel_id}","set permissions for channel {channel_id}","update permissions for channel {channel_id}","edit permissions for channel {channel_id}"]},{"kind":"action","name":"executeWebhook","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Executes a webhook, sending a message to the channel. Sample phrases: - \"Send a message using the webhook with ID 12345 and token abcde. The content should be 'Hello everyone!', and use the username 'Bot' with the avatar URL 'http://example.com/avatar.png'. Make it a TTS message.\" - \"Can you execute the webhook with ID 12345 and token abcde? The message should say 'Hello everyone!', and use the username 'Bot' with the avatar 'http://example.com/avatar.png'. Also, make it a TTS message.\" - \"Please trigger the webhook with ID 12345 and token abcde to send a message saying 'Hello everyone!'. Use 'Bot' as the username and 'http://example.com/avatar.png' as the avatar. Enable TTS for this message.\"","parameters":[{"name":"webhook_id","type":"string","optional":false,"description":"The ID of the webhook to execute."},{"name":"webhook_token","type":"string","optional":false,"description":"The token for the webhook."},{"name":"content","type":"string","optional":true,"description":"The content of the message."},{"name":"username","type":"string","optional":true,"description":"The username to use for the message."},{"name":"avatar_url","type":"string","optional":true,"description":"The avatar URL to use for the message."},{"name":"tts","type":"boolean","optional":true,"description":"Whether the message should be sent as text-to-speech."}],"phrasings":["fire webhook {webhook_id} token {webhook_token} with message {content}","trigger webhook {webhook_id} token {webhook_token} to send {content}","send a message using webhook {webhook_id} token {webhook_token} saying {content}","execute webhook {webhook_id} with token {webhook_token} saying {content}"]},{"kind":"action","name":"followAnnouncementChannel","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Follow an announcement channel to receive crossposted messages.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the announcement channel to follow."},{"name":"webhook_channel_id","type":"string","optional":false,"description":"The ID of the channel to receive crossposted messages."}],"phrasings":["crosspost announcement channel {channel_id} to {webhook_channel_id}","forward announcements from {channel_id} to {webhook_channel_id}","subscribe to announcement channel {channel_id} sending to {webhook_channel_id}","follow announcement channel {channel_id} in {webhook_channel_id}"]},{"kind":"action","name":"getChannel","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Get a channel by ID. Returns a channel object.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel to fetch."}],"phrasings":["look up channel {channel_id}","I need channel details for {channel_id}","show me channel {channel_id}","get details for channel {channel_id}"]},{"kind":"action","name":"getChannelInvites","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Get all invites for a channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel."}],"phrasings":["what invites are there for channel {channel_id}","get invites for channel {channel_id}","list invites on channel {channel_id}","show channel {channel_id} invites"]},{"kind":"action","name":"getChannelMessages","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Fetches messages from a specified channel. Sample phrases: - \"Can you show me the latest messages from the channel with ID 12345?\" - \"Fetch the last 50 messages from the channel 67890, please.\" - \"Get messages from the channel 54321, but only those sent after yesterday.\"","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel from which to fetch messages."},{"name":"limit","type":"number","optional":true,"description":"The maximum number of messages to return."},{"name":"before","type":"string","optional":true,"description":"Get messages before this message ID."},{"name":"after","type":"string","optional":true,"description":"Get messages after this message ID."}],"phrasings":[]},{"kind":"action","name":"getCurrentUser","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Returns the user object of the requester's account. Sample phrases: - \"Can you show me my account details?\" - \"What's my user info?\" - \"Get my profile information, please.\"","parameters":[],"phrasings":["who am I","get my profile","what's my user info","show me my account"]},{"kind":"action","name":"getCurrentUserApplicationRoleConnection","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Returns the application role connection for the user. Sample phrases: - \"Can you show me my role connection for the app with ID 123456?\" - \"What's my application role connection for the app with ID 123456?\" - \"Please get my role connection for the application with ID 123456.\"","parameters":[{"name":"application_id","type":"string","optional":false,"description":"The ID of the application to fetch the role connection for."}],"phrasings":["fetch my role connection for app {application_id}","get my role connection for application {application_id}","what's my role connection for app {application_id}","show me my role connection for app {application_id}"]},{"kind":"action","name":"getCurrentUserConnections","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Returns a list of connection objects. Sample phrases: - \"Can you show me my current connections?\" - \"What are my linked accounts right now?\" - \"I'd like to see my active connections, please.\"","parameters":[],"phrasings":["list my connections","see my connections","what are my linked accounts","show me my connections"]},{"kind":"action","name":"getCurrentUserGuildMember","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Returns a guild member object for the current user. Sample phrases: - \"Can you show me my member details for the server with ID 123456?\" - \"Get my guild member info for the server 123456, please.\" - \"I need my member object for the guild with ID 123456.\"","parameters":[{"name":"guild_id","type":"string","optional":false,"description":"The ID of the guild to fetch the member object from."}],"phrasings":["what's my role in server {guild_id}","I need my member object for guild {guild_id}","get my guild member info for server {guild_id}","show me my member details for server {guild_id}"]},{"kind":"action","name":"getCurrentUserGuilds","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Returns a list of partial guild objects the current user is a member of. Sample phrases: - \"Can you show me the servers I'm part of?\" - \"List all the guilds I'm currently in, please.\" - \"What are the Discord servers I belong to?\"","parameters":[{"name":"before","type":"string","optional":true,"description":"Get guilds before this ID."},{"name":"after","type":"string","optional":true,"description":"Get guilds after this ID."},{"name":"limit","type":"number","optional":true,"description":"The maximum number of guilds to return."},{"name":"with_counts","type":"boolean","optional":true,"description":"Whether to include member counts."}],"phrasings":["what servers I belong to","list guilds I'm in","show my server list","show me servers I'm part of"]},{"kind":"action","name":"getGuild","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Fetches a guild object for a given guild ID. Sample phrases: - \"Can you get the details for the guild with ID 12345?\" - \"Fetch the guild information for guild ID 67890, please.\" - \"I need the guild object for the guild with ID abcdef.\"","parameters":[{"name":"guild_id","type":"string","optional":false,"description":"The ID of the guild to fetch."}],"phrasings":["I need guild object for ID {guild_id}","show me guild {guild_id}","fetch guild info for {guild_id}","get details for guild {guild_id}"]},{"kind":"action","name":"getInvite","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Returns an invite object for the given code. Sample phrases: - \"Can you fetch the invite details for the code ABC123?\" - \"I need the invite info for code XYZ789, please.\" - \"Get me the invite object for the code DEF456, and include the counts.\"","parameters":[{"name":"invite_code","type":"string","optional":false,"description":"The code of the invite to fetch."},{"name":"with_counts","type":"boolean","optional":true,"description":"Whether to include member counts."},{"name":"guild_scheduled_event_id","type":"string","optional":true,"description":"The ID of the scheduled event for the invite."}],"phrasings":["look up invite {invite_code}","I need invite info for code {invite_code}","show me invite code {invite_code}","get invite details for {invite_code}"]},{"kind":"action","name":"getTargetUsers","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Gets the users allowed to see and accept this invite. Response is a CSV file with the header user_id and each user ID from the original file passed to invite create on its own line. Requires the caller to be the inviter, or have MANAGE_GUILD permission, or have VIEW_AUDIT_LOG permission. Sample phrases: - \"Can you show me the list of users who can accept this invite?\" - \"Get me the users allowed to see this invite, please.\" - \"I need the user IDs for the invite with code [invite.code].\"","parameters":[{"name":"invite_code","type":"string","optional":false,"description":"The code of the invite to fetch target users for."}],"phrasings":["who can accept invite {invite_code}","I need user IDs for invite {invite_code}","get users allowed to see invite {invite_code}","show me users who can accept invite {invite_code}"]},{"kind":"action","name":"getTargetUsersJobStatus","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Processing target users from a CSV when creating or updating an invite is done asynchronously. This endpoint allows you to check the status of that job. Requires the caller to be the inviter, or have MANAGE_GUILD permission, or have VIEW_AUDIT_LOG permission. Sample phrases: - \"Can you check the status of the job for the invite with code ABC123?\" - \"What's the current status of the processing job for the invite code ABC123?\" - \"Please tell me the job status for the invite code ABC123.\"","parameters":[{"name":"invite_code","type":"string","optional":false,"description":"The code of the invite to check the job status for."}],"phrasings":["is target users processing done for invite {invite_code}","tell me job status for invite {invite_code}","what's job for invite {invite_code}","check job for invite {invite_code}"]},{"kind":"action","name":"getThreadMember","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Get a thread member.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the thread."},{"name":"user_id","type":"string","optional":false,"description":"The ID of the user."}],"phrasings":["is {user_id} in thread {channel_id}","fetch thread member {user_id} from thread {channel_id}","show me member {user_id} in thread {channel_id}","get member info for {user_id} in thread {channel_id}"]},{"kind":"action","name":"getUser","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Returns a user object for a given user ID. Sample phrases: - \"Can you fetch the user details for ID 123456?\" - \"I need information on the user with ID 123456.\" - \"Please get me the user object for ID 123456.\"","parameters":[{"name":"user_id","type":"string","optional":false,"description":"The ID of the user to fetch."}],"phrasings":["look up user {user_id}","I need information on user {user_id}","show me user {user_id}","get user details for {user_id}"]},{"kind":"action","name":"getWebhook","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Fetches a webhook object for a given webhook ID. Sample phrases: - \"Can you fetch the webhook details for ID 12345?\" - \"I need the webhook information for webhook ID 12345.\" - \"Please get the webhook object for the ID 12345.\"","parameters":[{"name":"webhook_id","type":"string","optional":false,"description":"The ID of the webhook to fetch."}],"phrasings":["get webhook {webhook_id}","I need webhook object for {webhook_id}","show me webhook {webhook_id}","get webhook details for {webhook_id}"]},{"kind":"action","name":"groupDmAddRecipient","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Add a recipient to a Group DM.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the group DM channel."},{"name":"user_id","type":"string","optional":false,"description":"The ID of the user to add."},{"name":"access_token","type":"string","optional":true,"description":"The access token of the user."},{"name":"nick","type":"string","optional":true,"description":"The nickname for the user in the group DM."}],"phrasings":["bring {user_id} into group chat {channel_id}","include {user_id} in group DM {channel_id}","invite {user_id} to group DM {channel_id}","add user {user_id} to group DM {channel_id}"]},{"kind":"action","name":"groupDmRemoveRecipient","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Remove a recipient from a Group DM.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the group DM channel."},{"name":"user_id","type":"string","optional":false,"description":"The ID of the user to remove."}],"phrasings":["exclude {user_id} from group chat {channel_id}","take {user_id} out of group DM {channel_id}","kick {user_id} from group DM {channel_id}","remove user {user_id} from group DM {channel_id}"]},{"kind":"action","name":"joinThread","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Join a thread.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the thread to join."}],"phrasings":["enter thread {channel_id}","I want to join thread {channel_id}","add me to thread {channel_id}","join thread {channel_id}"]},{"kind":"action","name":"leaveGuild","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Leave a guild. Returns a 204 empty response on success. Sample phrases: - \"I want to leave the server with ID 123456789.\" - \"Please remove me from the guild with ID 123456789.\" - \"Can you help me exit the guild? The ID is 123456789.\"","parameters":[{"name":"guild_id","type":"string","optional":false,"description":"The ID of the guild to leave."}],"phrasings":["quit server {guild_id}","exit guild {guild_id}","remove me from guild {guild_id}","I want to leave server {guild_id}"]},{"kind":"action","name":"leaveThread","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Leave a thread.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the thread to leave."}],"phrasings":["exit thread {channel_id}","remove me from thread {channel_id}","I want to leave thread {channel_id}","leave thread {channel_id}"]},{"kind":"action","name":"listChannels","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"List all channels in the current Discord server.","parameters":[],"phrasings":["what channels","list channels"]},{"kind":"action","name":"listJoinedPrivateArchivedThreads","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"List private archived threads joined by the current user.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel."},{"name":"before","type":"string","optional":true,"description":"Returns threads before this timestamp."},{"name":"limit","type":"number","optional":true,"description":"Maximum number of threads to return."}],"phrasings":["what private archived threads have I joined in channel {channel_id}","get my joined private archived threads from channel {channel_id}","show me private archived threads I'm in for channel {channel_id}","list private archived threads I've joined in channel {channel_id}"]},{"kind":"action","name":"listPrivateArchivedThreads","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"List private archived threads in a channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel."},{"name":"before","type":"string","optional":true,"description":"Returns threads before this timestamp."},{"name":"limit","type":"number","optional":true,"description":"Maximum number of threads to return."}],"phrasings":["what private threads are archived in channel {channel_id}","get archived private threads from channel {channel_id}","show me private archived threads in channel {channel_id}","list private archived threads in channel {channel_id}"]},{"kind":"action","name":"listPublicArchivedThreads","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"List public archived threads in a channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel."},{"name":"before","type":"string","optional":true,"description":"Returns threads before this timestamp."},{"name":"limit","type":"number","optional":true,"description":"Maximum number of threads to return."}],"phrasings":["what public threads are archived in channel {channel_id}","get archived public threads from channel {channel_id}","show me public archived threads in channel {channel_id}","list public archived threads in channel {channel_id}"]},{"kind":"action","name":"listThreadMembers","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"List members of a thread.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the thread."}],"phrasings":["get member list for thread {channel_id}","who is in thread {channel_id}","show me members of thread {channel_id}","list members of thread {channel_id}"]},{"kind":"action","name":"modifyChannel","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Update a channel's settings.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel to modify."},{"name":"name","type":"string","optional":true,"description":"The new name for the channel."},{"name":"topic","type":"string","optional":true,"description":"The new topic for the channel."},{"name":"nsfw","type":"boolean","optional":true,"description":"Whether the channel is NSFW."}],"phrasings":["rename channel {channel_id} to {name}","modify channel {channel_id} name to {name}","change settings of channel {channel_id}","update channel {channel_id}"]},{"kind":"action","name":"modifyCurrentUser","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Modify the requester's user account settings. Returns a user object on success. Sample phrases: - \"Can you update my username and profile picture?\" - \"I'd like to change my username and avatar, please.\" - \"Please modify my account settings with a new username and banner image.\"","parameters":[{"name":"username","type":"string","optional":true,"description":"The new username for the account."},{"name":"avatar","type":"string","optional":true,"description":"The new avatar for the account."},{"name":"banner","type":"string","optional":true,"description":"The new banner image for the account."}],"phrasings":["update my account settings","set my username to {username}","change my profile username {username}","update my username to {username}"]},{"kind":"action","name":"refreshChannels","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Refresh the channel cache from the Discord server.","parameters":[],"phrasings":["update channel cache","refresh cache"]},{"kind":"action","name":"removeThreadMember","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Remove another member from a thread.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the thread."},{"name":"user_id","type":"string","optional":false,"description":"The ID of the user to remove."}],"phrasings":["exclude {user_id} from thread {channel_id}","take {user_id} out of thread {channel_id}","kick {user_id} from thread {channel_id}","remove user {user_id} from thread {channel_id}"]},{"kind":"action","name":"setGuild","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Set the default Discord server (guild) for all operations.","parameters":[{"name":"guild_id","type":"string","optional":false,"description":"The Discord server ID to use as default"}],"phrasings":["use server {guild_id}","my discord server {guild_id}","set my discord server {guild_id}"]},{"kind":"action","name":"setVoiceChannelStatus","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Set the status of a voice channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the voice channel."},{"name":"status","type":"string","optional":false,"description":"The new status for the voice channel."}],"phrasings":["put {status} as status for voice channel {channel_id}","change status of voice channel {channel_id} to {status}","update voice channel {channel_id} status to {status}","set channel {channel_id} status to {status}"]},{"kind":"action","name":"startThreadFromMessage","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Start a thread from an existing message.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel containing the message."},{"name":"message_id","type":"string","optional":false,"description":"The ID of the message to start a thread from."},{"name":"name","type":"string","optional":true,"description":"The name of the thread."}],"phrasings":["make a thread from message {message_id} in channel {channel_id}","open a thread on message {message_id} in channel {channel_id} called {name}","create a thread called {name} from message {message_id} in channel {channel_id}","start a thread from message {message_id} in channel {channel_id} called {name}"]},{"kind":"action","name":"startThreadInForumOrMediaChannel","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Start a thread in a forum or media channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the forum or media channel."},{"name":"name","type":"string","optional":false,"description":"The name of the thread."},{"name":"message","type":"string","optional":true,"description":"The initial message for the thread."}],"phrasings":["make a forum post called {name} in channel {channel_id}","post a forum thread called {name} in channel {channel_id}","create a forum post called {name} in channel {channel_id}","start a forum thread called {name} in channel {channel_id}"]},{"kind":"action","name":"startThreadWithoutMessage","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Start a thread without an existing message.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel to start the thread in."},{"name":"name","type":"string","optional":false,"description":"The name of the thread."},{"name":"auto_archive_duration","type":"number","optional":true,"description":"Duration in minutes to automatically archive the thread."},{"name":"type","type":"number","optional":true,"description":"The type of thread to create."}],"phrasings":["make a thread called {name} in channel {channel_id}","open a thread in channel {channel_id} called {name}","create a thread called {name} in channel {channel_id}","start a thread called {name} in channel {channel_id}"]},{"kind":"action","name":"triggerTypingIndicator","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Trigger the typing indicator in a channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel."}],"phrasings":["send typing indicator to channel {channel_id}","start typing in channel {channel_id}","show typing in channel {channel_id}","trigger typing indicator in channel {channel_id}"]},{"kind":"action","name":"updateCurrentUserApplicationRoleConnection","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Updates and returns the application role connection for the user. Sample phrases: - \"Can you update my role connection for the app with my new username?\" - \"Please change my application role connection details to reflect my updated platform name and username.\" - \"I need to update my role connection for the app. My platform name is [platform_name] and my username is [platform_username].\"","parameters":[{"name":"application_id","type":"string","optional":true,"description":"The ID of the application."},{"name":"platform_name","type":"string","optional":true,"description":"The new platform name for the role connection."},{"name":"platform_username","type":"string","optional":true,"description":"The new platform username for the role connection."},{"name":"metadata","type":"string","optional":true,"description":"The metadata for the role connection (JSON string)."}],"phrasings":["modify my role connection for app {application_id}","update my role connection for app {application_id} {platform_name}","change my role connection for app {application_id}","update my role connection for app {application_id}"]},{"kind":"action","name":"updateTargetUsers","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Updates the users allowed to see and accept this invite. Uploading a file with invalid user IDs will result in a 400 with the invalid IDs described. Requires the caller to be the inviter or have the MANAGE_GUILD permission. Sample phrases: - \"Can you update the invite with these new target users? Here's the file.\" - \"Please refresh the list of users who can access this invite using this file.\" - \"I'd like to change the allowed users for this invite. Uploading the file now.\"","parameters":[{"name":"invite_code","type":"string","optional":false,"description":"The code of the invite to update target users for."},{"name":"target_users_file","type":"string","optional":true,"description":"The file containing the new target users (file path or URL)."}],"phrasings":["set target users for invite {invite_code}","change allowed users for invite {invite_code}","refresh users who can access invite {invite_code}","update users for invite {invite_code}"]}]}]},{"kind":"category","name":"Web & Knowledge","emoji":"🌐","children":[{"kind":"agent","name":"browser","emoji":"🌐","description":"Agent that allows you control an existing browser window","children":[{"kind":"action","name":"addToBookmarks","agent":"browser","schema":"browser.external","enabled":false,"transient":true,"description":"","parameters":[{"name":"url","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"captureScreenshot","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["screenshot","capture screen","take screenshot"]},{"kind":"action","name":"changeSearchProvider","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"change the default search provider","parameters":[{"name":"name","type":"string","optional":false,"description":"The name of the search provider to switch to"}],"phrasings":[]},{"kind":"action","name":"changeTab","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Make another tab the active tab","parameters":[{"name":"tabDescription","type":"string","optional":false,"description":""},{"name":"tabIndex","type":"number","optional":true,"description":"The numerical index referred to by the description if applicable.  (i.e. first = 1, second = 2, etc.)"}],"phrasings":["next tab","go to tab {tabDescription}","switch to tab {tabDescription}"]},{"kind":"action","name":"closeAllWebPages","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Close all web page views","parameters":[],"phrasings":["tabs","pages"]},{"kind":"action","name":"closeTab","agent":"browser","schema":"browser.external","enabled":false,"transient":true,"description":"This closes a tab in an existing browser window. IMPORTANT: This does NOT close browser programs.","parameters":[{"name":"title","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"closeWebPage","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Close the current web site view","parameters":[],"phrasings":["close tab","close page"]},{"kind":"action","name":"closeWindow","agent":"browser","schema":"browser.external","enabled":false,"transient":true,"description":"","parameters":[{"name":"title","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"createInferredFlow","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Create WebFlows from previously inferred actions. Used after @browser actions infer to select which actions to create.","parameters":[{"name":"selection","type":"string","optional":false,"description":"The indices of the inferred actions to create (1-based), or \"all\" to create all"}],"phrasings":["all flows"]},{"kind":"action","name":"createInferredFlows","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[{"name":"selectedIndices","type":"number[]","optional":false,"description":""},{"name":"inferredActions","type":"{ … }[]","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"createWebFlowFromRecording","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[{"name":"actionName","type":"string","optional":false,"description":""},{"name":"actionDescription","type":"string","optional":false,"description":""},{"name":"recordedSteps","type":"string","optional":false,"description":""},{"name":"existingActionNames","type":"string[]","optional":true,"description":""},{"name":"startUrl","type":"string","optional":false,"description":""},{"name":"screenshots","type":"string[]","optional":true,"description":""},{"name":"fragments","type":"{ … }[]","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"deleteWebFlow","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[{"name":"name","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"deleteWebFlow","agent":"browser","schema":"browser.webFlows","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"detectPageActions","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[{"name":"registerAgent","type":"boolean","optional":true,"description":""},{"name":"agentName","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"editWebFlow","agent":"browser","schema":"browser.webFlows","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":false,"description":""},{"name":"script","type":"string","optional":false,"description":""},{"name":"description","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"editWebFlowScope","agent":"browser","schema":"browser.webFlows","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":false,"description":""},{"name":"scopeType","type":"\"site\" | \"global\"","optional":false,"description":""},{"name":"domains","type":"string[]","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"executeAdHocScript","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Execute an ad-hoc WebFlow script. The script must be a valid async function using the WebFlow browser API (browser.click, browser.enterText, etc.). Used by reasoning agents to perform browser interactions without a saved WebFlow.","parameters":[{"name":"script","type":"string","optional":false,"description":"The JavaScript source for an async function: async function execute(browser, params) { ... }"},{"name":"params","type":"string","optional":true,"description":"JSON-encoded parameters to pass to the script"},{"name":"timeout","type":"number","optional":true,"description":"Execution timeout in milliseconds (default: 120000)"}],"phrasings":[]},{"kind":"action","name":"followLinkByPosition","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[{"name":"position","type":"number","optional":false,"description":""},{"name":"openInNewTab","type":"boolean","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"followLinkByText","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"follow a link on the page to open a related page or article Example: user: Open the Haiti link agent: { \"actionName\": \"followLinkByText\", \"parameters\": { \"keywords\": \"Haiti\" } }","parameters":[{"name":"keywords","type":"string","optional":false,"description":""},{"name":"openInNewTab","type":"boolean","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"generateWebFlow","agent":"browser","schema":"browser.webFlows","enabled":true,"transient":false,"description":"Generate a reusable WebFlow script from a saved trace","parameters":[{"name":"traceId","type":"string","optional":false,"description":"Trace ID (from a previous goal-driven task) to generate a script from"},{"name":"name","type":"string","optional":true,"description":"Optional name for the generated flow"},{"name":"description","type":"string","optional":true,"description":"Optional description override"}],"phrasings":[]},{"kind":"action","name":"generateWebFlowFromRecording","agent":"browser","schema":"browser.webFlows","enabled":true,"transient":false,"description":"Generate a WebFlow from recorded user interactions","parameters":[{"name":"description","type":"string","optional":false,"description":"Description of what the recording does"},{"name":"name","type":"string","optional":true,"description":"Optional name for the generated flow"}],"phrasings":[]},{"kind":"action","name":"getAllWebFlows","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"getWebFlowsForDomain","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[{"name":"domain","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"getWebsiteStats","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Get statistics about imported website data","parameters":[{"name":"groupBy","type":"\"domain\" | \"pageType\" | \"source\"","optional":true,"description":"Group stats by domain, pageType, or source"},{"name":"limit","type":"number","optional":true,"description":"Limit number of groups returned"}],"phrasings":[]},{"kind":"action","name":"goBack","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["back"]},{"kind":"action","name":"goForward","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["forward"]},{"kind":"action","name":"inferActions","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"listWebFlows","agent":"browser","schema":"browser.webFlows","enabled":true,"transient":false,"description":"","parameters":[{"name":"scope","type":"\"site\" | \"global\" | \"all\"","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"lookupAndAnswerInternet","agent":"browser","schema":"browser.lookupAndAnswer","enabled":true,"transient":false,"description":"The user request is a question about general knowledge that can be found from the internet. (e.g. \"what is the current price of Microsoft stock?\") look up for contemporary internet information including sports scores, news events, or current commerce offerings, use the lookups parameter to request a lookup of the information on the user's behalf; the assistant will generate a response based on the lookup results Lookup *facts* you don't know or if your facts are out of date. E.g. stock prices, time sensitive data, etc the search strings to look up on the user's behalf should be specific enough to return the correct information it is recommended to include the same entities as in the user request","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"},{"name":"internetLookups","type":"string[]","optional":false,"description":"the internet search terms to use"},{"name":"sites","type":"string[]","optional":true,"description":"specific sites to look up in."}],"phrasings":[]},{"kind":"action","name":"openFromBookmarks","agent":"browser","schema":"browser.external","enabled":false,"transient":true,"description":"","parameters":[{"name":"keywords","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"openFromHistory","agent":"browser","schema":"browser.external","enabled":false,"transient":true,"description":"","parameters":[{"name":"keywords","type":"string","optional":false,"description":""},{"name":"startDate","type":"{ displayText, timestamp }","optional":true,"description":""},{"name":"endDate","type":"{ displayText, timestamp }","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"openSearchResult","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Open a specific search result from previous search","parameters":[{"name":"position","type":"number","optional":true,"description":"Position/index of the search result (1-based)"},{"name":"title","type":"string","optional":true,"description":"Name or title of the search result to open"},{"name":"url","type":"string","optional":true,"description":"URL of the search result to open (if user specifies exact URL)"},{"name":"openInNewTab","type":"boolean","optional":true,"description":"Open in new tab (default: false)"}],"phrasings":[]},{"kind":"action","name":"openTab","agent":"browser","schema":"browser.external","enabled":false,"transient":true,"description":"This opens a new tab in an existing browser window. IMPORTANT: This does NOT launch new browser windows.","parameters":[{"name":"url","type":"string","optional":true,"description":""},{"name":"query","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"openWebPage","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"show/open/display web page in the current view.","parameters":[{"name":"site","type":"\"paleobiodb\" | \"crossword\" | \"commerce\" | \"montage\" | \"markdown\" | \"turtleGraphics\" | \"annotationsLibrary\" | \"knowledgeLibrary\" | …","optional":false,"description":"Name/Description/search terms of the site to open"},{"name":"tab","type":"\"new\" | \"current\" | \"existing\"","optional":true,"description":"Enum indicating if the page to open in the new tab or the current tab. Default value is \"current\""}],"phrasings":["visit {site}","browse to {site}","navigate to {site}","go to {site}","open {site}"]},{"kind":"action","name":"readPageContent","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Read the web page contents aloud","parameters":[],"phrasings":["page"]},{"kind":"action","name":"registerPageDynamicAgent","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[{"name":"agentName","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"reloadPage","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["refresh page","reload page"]},{"kind":"action","name":"scrollDown","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["down"]},{"kind":"action","name":"scrollUp","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["up"]},{"kind":"action","name":"searchImageAction","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Searches (finds) for images on the internet to show the user if the user asks doesn't specify a quantity, randomly select anywhere between 3 and 10 images","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"},{"name":"searchTerm","type":"string","optional":false,"description":"the search term for the image(s) to find"},{"name":"numImages","type":"number","optional":false,"description":"the number of images to show the user"}],"phrasings":[]},{"kind":"action","name":"startGoalDrivenTask","agent":"browser","schema":"browser.webFlows","enabled":true,"transient":false,"description":"Goal-driven mode: describe what you want and a reasoning model completes it","parameters":[{"name":"goal","type":"string","optional":false,"description":"The goal to achieve (e.g. \"search for wireless headphones and add the cheapest to cart\")"},{"name":"startUrl","type":"string","optional":true,"description":"Optional starting URL; uses current page if not specified"},{"name":"maxSteps","type":"number","optional":true,"description":"Maximum reasoning steps (default 30)"}],"phrasings":[]},{"kind":"action","name":"stopReadPageContent","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["stop reading"]},{"kind":"action","name":"summarizePage","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"switchToTabByPosition","agent":"browser","schema":"browser.external","enabled":false,"transient":true,"description":"","parameters":[{"name":"position","type":"number","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"switchToTabByText","agent":"browser","schema":"browser.external","enabled":false,"transient":true,"description":"Switch to an open tab, based on the tab's title Example: user: Switch to the Haiti tab agent: { \"actionName\": \"switchToTabByText\", \"parameters\": { \"keywords\": \"Haiti\" } }","parameters":[{"name":"keywords","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"zoomIn","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["in"]},{"kind":"action","name":"zoomOut","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["out"]},{"kind":"action","name":"zoomReset","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["reset zoom"]}]},{"kind":"agent","name":"weather","emoji":"⛅","description":"Agent to get weather information including current conditions, forecasts, and alerts","children":[{"kind":"action","name":"getAlerts","agent":"weather","schema":"weather","enabled":true,"transient":false,"description":"","parameters":[{"name":"location","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"getCurrentConditions","agent":"weather","schema":"weather","enabled":true,"transient":false,"description":"","parameters":[{"name":"location","type":"string","optional":false,"description":""},{"name":"units","type":"\"celsius\" | \"fahrenheit\"","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"getForecast","agent":"weather","schema":"weather","enabled":true,"transient":false,"description":"","parameters":[{"name":"location","type":"string","optional":false,"description":""},{"name":"days","type":"number","optional":true,"description":""},{"name":"units","type":"\"celsius\" | \"fahrenheit\"","optional":true,"description":""}],"phrasings":[]}]}]},{"kind":"category","name":"Development & Automation","emoji":"💻","children":[{"kind":"agent","name":"code","emoji":"⚛️","description":"Agent for VSCode integration","children":[{"kind":"action","name":"changeColorScheme","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Change the VS Code editor's color theme. Example: User: change my vscode color theme to Monokai Agent: { actionName: \"changeColorScheme\", parameters: { theme: \"Monokai\" } }","parameters":[{"name":"theme","type":"\"Default Light+\" | \"Default Dark+\" | \"Monokai\" | \"Monokai Dimmed\" | \"Solarized Dark\" | \"Solarized Light\" | \"Quiet Light\" | \"Red\" | …","optional":false,"description":"The VS Code color theme name, e.g. \"Monokai\", \"Solarized Dark\", \"Dark+\"."}],"phrasings":[]},{"kind":"action","name":"changeEditorLayout","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Change the editor layout to single, double or three column layout","parameters":[{"name":"columnCount","type":"\"single\" | \"double\" | \"three\"","optional":true,"description":"e.g., \"single\", \"double\", \"three\" column editor layout. Fill only if specified by the user"}],"phrasings":[]},{"kind":"action","name":"checkExtensionAvailable","agent":"code","schema":"code.code-extension","enabled":false,"transient":false,"description":"The action checks/searches if an extension is available based on user requests like is the copilot extension available? or Show me all extensions related to AI","parameters":[{"name":"filterByUserQuery","type":"string","optional":true,"description":"Free text (e.g. \"copilot\")"},{"name":"filterByKnownQuery","type":"\"@updates\" | \"@recentlyPublished\" | \"@workspaceUnsupported\" | \"@builtin\" | \"@installed\" | \"@popular\" | \"@recommended\" | \"@enabled\" | …","optional":true,"description":"Known query (e.g. \"@installed\")"},{"name":"filterByCategory","type":"\"ai\" | \"azure\" | \"data science\" | \"formatters\" | \"programming languages\" | \"extension packs\" | \"machine learning\" | \"education\" | …","optional":true,"description":"Category filter (e.g. \"@category:ai\")"}],"phrasings":[]},{"kind":"action","name":"closeEditor","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Close the current editor","parameters":[],"phrasings":["'close' 'editor'"]},{"kind":"action","name":"createCodeBlock","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"","parameters":[{"name":"language","type":"string","optional":false,"description":""},{"name":"docstring","type":"string","optional":true,"description":"A short natural language prompt or description of what the code block should do. Used for generating context-aware completions (e.g., via Copilot). Example: \"Loop over x in descending order\""},{"name":"declaration","type":"string","optional":true,"description":"The starting line of a structured code block, such as a for-loop, if-statement, etc. Example: \"for (let i = 0; i \u003c arr.length; i++) {\""},{"name":"body","type":"string","optional":true,"description":"Optional body of the code block, excluding the closing brace. Can be omitted if Copilot or the agent will generate it."},{"name":"codeSnippet","type":"string","optional":true,"description":"A short or one-liner code expression to insert directly or use as a Copilot prompt. Example: \"const total = prices.reduce(...)\" If provided, takes precedence over declaration/body."},{"name":"isPartial","type":"boolean","optional":true,"description":"True if the request is partial or uncertain (e.g., from speech). Used to guide how much the agent or Copilot should infer."},{"name":"file","type":"{ fileName, folderName, folderRelativeTo, createIfNotExists, fallbackToActiveFile }","optional":true,"description":"Optional target file where the code should be inserted. Only emit the file if specified by the user. If omitted, defaults to the active editor."},{"name":"position","type":"{ … }","optional":true,"description":"Position in the file where the code block should be inserted. Defaults to { type: \"atCursor\" }."}],"phrasings":[]},{"kind":"action","name":"createFile","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"@deprecated Use `NewCodeFileAction`, `NewMarkdownFileAction`, or `NewTextFileAction` instead.","parameters":[{"name":"fileName","type":"string","optional":true,"description":""},{"name":"folderName","type":"string","optional":true,"description":"Name of the folder to create the file in (e.g., \"src\")"},{"name":"folderRelativeTo","type":"string","optional":true,"description":"Optional: restrict to folders under this path or name"},{"name":"language","type":"string","optional":true,"description":""},{"name":"untitled","type":"boolean","optional":true,"description":""},{"name":"openInEditor","type":"boolean","optional":true,"description":""},{"name":"content","type":"string","optional":true,"description":""},{"name":"overwriteIfExists","type":"boolean","optional":true,"description":""},{"name":"focusExistingIfOpen","type":"boolean","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"createFunction","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"Schema to generate a function","parameters":[{"name":"language","type":"\"typescript\" | \"python\" | \"javascript\" | string","optional":false,"description":"Programming language of the function (determines syntax rules and formatting)"},{"name":"functionDeclaration","type":"string","optional":false,"description":"The full function declaration or signature line (e.g., \"function foo(x: number): number {\") This must include the opening brace (for JS/TS) or colon (for Python) and match the language's syntax"},{"name":"body","type":"string","optional":true,"description":"Function implementation body (excluding the closing brace or dedent, if applicable) This should contain valid code that performs the intended task. If left as an empty string (\"\"), the extension will attempt to trigger GitHub Copilot to complete the body. Prefer generating this value if the function behavior is well understood."},{"name":"docstring","type":"string","optional":true,"description":"A one-line docstring or comment that explains what the function does. This should describe the function’s intent based on the declaration and user request. Used to improve readability and may help tools like Copilot complete the function more accurately."},{"name":"name","type":"string","optional":true,"description":"Optional: the name of the function. If omitted, may be inferred from the declaration."},{"name":"args","type":"{ … }[]","optional":true,"description":"Optional: an array of function parameters with their names and types (for display or analysis)"},{"name":"returnType","type":"string","optional":true,"description":"Optional: the function's return type (e.g., \"string\", \"void\", \"Promise\u003cboolean>\")"},{"name":"isAsync","type":"boolean","optional":true,"description":"Optional: whether the function should be marked as async"},{"name":"file","type":"{ fileName, folderName, folderRelativeTo, createIfNotExists, fallbackToActiveFile }","optional":true,"description":"Optional: the target file where the function should be inserted"},{"name":"position","type":"{ … }","optional":true,"description":"Optional: where in the file to insert the function. Defaults to current cursor location if not provided."}],"phrasings":[]},{"kind":"action","name":"deleteConversation","agent":"code","schema":"code.code-vscode-shell","enabled":false,"transient":false,"description":"Delete a TypeAgent Shell conversation by display name. The current active conversation cannot be deleted. The extension will prompt the user for confirmation before deleting. Example: User: delete the \"design review\" conversation Agent: { actionName: \"deleteConversation\", parameters: { name: \"design review\" } } Example: User: delete a conversation Agent: { actionName: \"deleteConversation\", parameters: {} }","parameters":[{"name":"name","type":"string","optional":true,"description":"The display name of the conversation to delete. If omitted, the user will be shown a picker in the extension UI."}],"phrasings":["'delete' 'chat'"]},{"kind":"action","name":"disableExtension","agent":"code","schema":"code.code-extension","enabled":false,"transient":false,"description":"","parameters":[{"name":"extensionQuery","type":"string","optional":false,"description":"e.g. \"prettier\", \"azure functions\""},{"name":"promptUser","type":"boolean","optional":true,"description":"whether to prompt user for confirmation before disabling, default: true"},{"name":"autoReload","type":"boolean","optional":true,"description":"whether to automatically reload the window after disabling, default: false"}],"phrasings":[]},{"kind":"action","name":"enableExtension","agent":"code","schema":"code.code-extension","enabled":false,"transient":false,"description":"","parameters":[{"name":"extensionQuery","type":"string","optional":false,"description":"e.g. \"prettier\", \"azure functions\""},{"name":"promptUser","type":"boolean","optional":true,"description":"whether to prompt user for confirmation before enabling, default: true"},{"name":"autoReload","type":"boolean","optional":true,"description":"whether to automatically reload the window after enabling, default: false"}],"phrasings":[]},{"kind":"action","name":"fixCodeProblem","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"schema to fix a problem (diagnostic) in the code. The target can be the first problem, the next one, all, or a specific location/index in the file. Optional hints from the user (e.g. \"fix the second error\") or file scoping may guide the choice. Used when the user requests: \"fix this problem\", \"fix the second error\", \"fix all issues in this file\".","parameters":[{"name":"target","type":"{ … }","optional":false,"description":"Which problem to fix (e.g., \"first\", \"next\", \"atCursor\", or \"second problem in file\")"},{"name":"hint","type":"string","optional":true,"description":"Optional context hint from the agent (parsed from user request)"},{"name":"file","type":"{ fileName, folderName, folderRelativeTo, createIfNotExists, fallbackToActiveFile }","optional":true,"description":"File scope (defaults to active editor)"}],"phrasings":[]},{"kind":"action","name":"fontZoomReset","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Zoom reset","parameters":[],"phrasings":["'zoom' 'reset'","'reset' 'zoom'"]},{"kind":"action","name":"generateWithCopilot","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"","parameters":[{"name":"strategy","type":"\"inlineCompletion\" | \"commentToCode\" | \"generateFix\" | \"generateInsideFunction\" | \"suggestAlternatives\"","optional":false,"description":"The generation strategy to use"},{"name":"position","type":"{ … }","optional":false,"description":"Where to generate the code"},{"name":"language","type":"string","optional":true,"description":"Optional language hint"},{"name":"prompt","type":"string","optional":true,"description":"Optional: natural language guidance (if not using inline)"},{"name":"context","type":"{ … }[]","optional":true,"description":"Optional: provide surrounding code or references"},{"name":"attemptLimit","type":"number","optional":true,"description":"Optional: how many suggestions to try (default: 1)"},{"name":"autoAccept","type":"boolean","optional":true,"description":"Optional: whether to auto-accept Copilot's first suggestion"},{"name":"explanationMode","type":"boolean","optional":true,"description":"Optional: let agent explain what Copilot might generate"}],"phrasings":[]},{"kind":"action","name":"getActiveEditor","agent":"code","schema":"code","enabled":false,"transient":false,"description":"── Read / introspection actions ──────────────────────────────────────────── These return the current VS Code editor state to the caller and modify nothing. They are meant to be invoked by the reasoning agent (via discover_actions/execute_action) to inspect what the user is looking at. Results are returned as JSON in the action's display output. Get a coarse snapshot of the active editor: file path, language, dirty state, cursor position, selection range, visible range, workspace folders, open editor count, and diagnostic counts. Does NOT include file or selection text.","parameters":[],"phrasings":[]},{"kind":"action","name":"getDiagnostics","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Get the diagnostics (errors, warnings, info, hints) for a file. Defaults to the active file when fileName is omitted.","parameters":[{"name":"fileName","type":"string","optional":true,"description":"Workspace-relative path or file name. Omit to use the active file."}],"phrasings":[]},{"kind":"action","name":"getFileContent","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Read the contents of a workspace file. Optionally restrict to a line range (0-based, inclusive). The file must be inside an open workspace folder.","parameters":[{"name":"fileName","type":"string","optional":false,"description":"Workspace-relative path or file name to read."},{"name":"startLine","type":"number","optional":true,"description":"Optional 0-based start line (inclusive)."},{"name":"endLine","type":"number","optional":true,"description":"Optional 0-based end line (inclusive)."}],"phrasings":[]},{"kind":"action","name":"getSelection","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Get the text currently selected in the active editor, along with its range. Returns an empty selection marker when nothing is selected.","parameters":[],"phrasings":[]},{"kind":"action","name":"getWorkspaceChanges","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Get a summary of pending source-control (git) changes in the workspace: per-repository branch, working-tree changes, and staged changes.","parameters":[],"phrasings":[]},{"kind":"action","name":"gotoFileOrLineOrSymbol","agent":"code","schema":"code.code-general","enabled":false,"transient":false,"description":"Quick option to access a file, alternate way to search a file by name using keyboard shortcuts search by file name, or append : go to line, or  @ to go to symbol If the user request is open/show the search pane this action should not be triggered","parameters":[{"name":"goto","type":"\"file\" | \"line\" | \"symbol\"","optional":true,"description":""},{"name":"ref","type":"string","optional":true,"description":"file name, line number, or symbol name, don't fill this property if the file name, line number or symbol name is not provided in the user request"}],"phrasings":["'symbol'","'line'","'file'"]},{"kind":"action","name":"insertComment","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"","parameters":[{"name":"text","type":"string","optional":false,"description":"The comment content, excluding the comment syntax itself"},{"name":"language","type":"string","optional":true,"description":"Optional, helps format comments (e.g., // vs #)"},{"name":"commentStyle","type":"\"line\" | \"block\"","optional":true,"description":"Comment style (default: \"line\")"},{"name":"position","type":"{ … }","optional":false,"description":"Where to insert the comment"},{"name":"newlineBefore","type":"boolean","optional":true,"description":"Whether to add a blank line before the comment"},{"name":"newlineAfter","type":"boolean","optional":true,"description":"Whether to add a blank line after the comment"}],"phrasings":[]},{"kind":"action","name":"insertOrDeleteLines","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"Action for inserting or deleting lines in a file.","parameters":[{"name":"operation","type":"\"insert\" | \"delete\"","optional":false,"description":"Operation to perform: \"insert\": add new empty lines at the target position \"delete\": remove lines starting from the target position"},{"name":"count","type":"number","optional":true,"description":"Number of lines to insert or delete (default: 1)."},{"name":"position","type":"{ … }","optional":true,"description":"Position where the operation should happen. Examples: { type: \"atCursor\" } { type: \"afterLine\", line: 10 } { type: \"atEndOfFile\" }"},{"name":"file","type":"{ fileName, folderName, folderRelativeTo, createIfNotExists, fallbackToActiveFile }","optional":true,"description":"Optional target file (defaults to the active editor)."},{"name":"force","type":"boolean","optional":true,"description":"When deleting: - true: allow deleting non-empty lines (default) - false: only delete if lines are empty/whitespace"}],"phrasings":[]},{"kind":"action","name":"installExtension","agent":"code","schema":"code.code-extension","enabled":false,"transient":false,"description":"","parameters":[{"name":"extensionQuery","type":"string","optional":false,"description":"natural language query, e.g. \"copilot\""},{"name":"promptUser","type":"boolean","optional":true,"description":"whether to prompt user for confirmation before installing, default: true"},{"name":"autoReload","type":"boolean","optional":true,"description":"whether to automatically reload the window after installation, default: false"}],"phrasings":[]},{"kind":"action","name":"launchCopilotChat","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"Hand the current TypeAgent conversation (and optional developer-mode captures + a screenshot) to native GitHub Copilot Chat in VS Code so it can diagnose and fix the underlying problem, via `workbench.action.chat.open`. By default it starts a fresh chat session in a new chat editor and submits the request automatically.","parameters":[{"name":"query","type":"string","optional":false,"description":"The prompt to send to the Copilot Chat input."},{"name":"mode","type":"\"agent\" | \"ask\"","optional":true,"description":"Copilot chat mode. \"agent\" lets Copilot edit the workspace to apply a fix; \"ask\" is conversational only. Defaults to \"agent\"."},{"name":"isPartialQuery","type":"boolean","optional":true,"description":"When true, the query is pre-filled but not auto-submitted so the user can review the attached context first. When false (default for `@copilot fix`), the request is submitted automatically."},{"name":"attachScreenshot","type":"boolean","optional":true,"description":"When true, attach a screenshot of the focused VS Code window as an image (no temp file, no file-permission prompt)."},{"name":"attachFiles","type":"string[]","optional":true,"description":"Absolute paths to files (e.g., conversation.json and dev-capture JSON) to attach to the chat request."},{"name":"newSession","type":"boolean","optional":true,"description":"When true (default), start a fresh chat session for the handoff instead of appending to whatever chat is already open."},{"name":"newSessionLocation","type":"\"view\" | \"editor\" | \"window\"","optional":true,"description":"Where to open the new session (only when newSession is true): \"editor\" (a new chat editor in the editor area, the default), \"view\" (the chat panel/side view), or \"window\" (a separate chat window)."}],"phrasings":[]},{"kind":"action","name":"launchVSCode","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Launch or Start VSCode","parameters":[{"name":"mode","type":"\"last\" | \"folder\" | \"workspace\"","optional":false,"description":""},{"name":"path","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"listOpenEditors","agent":"code","schema":"code","enabled":false,"transient":false,"description":"List the open editor tabs across all editor groups (path, label, active, dirty). Does not include file contents.","parameters":[],"phrasings":[]},{"kind":"action","name":"moveCursorInFile","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"ACTION: Move the cursor to a specific position within a file (for navigation or editing preparation). This moves the cursor position, NOT split/duplicate the editor view. USE THIS for: \"go to file X\", \"jump to line 50\", \"go to function foo\", \"move cursor to X\" DO NOT USE for: \"split editor\", \"split X\", \"duplicate editor\" (use splitEditor action instead) Examples: - \"go to line 50\" → { target: { type: \"onLine\", line: 50 } } - \"jump to function main\" → { target: { type: \"insideFunction\", name: \"main\" } } - \"go to app.tsx\" → { target: { type: \"inFile\", filePath: \"app.tsx\" } } - \"move cursor to the end of file\" → { target: { type: \"atEndOfFile\" } }","parameters":[{"name":"target","type":"{ … }","optional":false,"description":"Target position for the cursor. Supports symbolic locations, line-based positions, or file-relative positions."},{"name":"file","type":"{ fileName, folderName, folderRelativeTo, createIfNotExists, fallbackToActiveFile }","optional":true,"description":"Optional file where the cursor should be moved. Defaults to the active editor if not provided."},{"name":"hint","type":"string","optional":true,"description":"Optional user or agent hint to clarify ambiguous positioning. Example: \"after function declaration\", \"before import statements\"."}],"phrasings":[]},{"kind":"action","name":"newCodeFile","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Create a new code file (Python, JavaScript, TypeScript, HTML, CSS, JSON, etc.) in the editor. Example: User: create a new typescript file called scratch.ts with a hello world function Agent: { actionName: \"newCodeFile\", parameters: { fileName: \"scratch.ts\", language: \"typeScript\", content: \"function helloWorld() { console.log('Hello, World!'); }\\n\" } }","parameters":[{"name":"fileName","type":"string | \"untitled\"","optional":false,"description":"The file name; if omitted or empty, \"untitled\" is used."},{"name":"language","type":"\"html\" | \"css\" | \"json\" | \"python\" | \"javaScript\" | \"typeScript\"","optional":false,"description":"The programming language of the file."},{"name":"content","type":"string","optional":false,"description":"Initial file content; empty string for an empty scratch file."}],"phrasings":[]},{"kind":"action","name":"newConversation","agent":"code","schema":"code.code-vscode-shell","enabled":false,"transient":false,"description":"Create a brand-new TypeAgent Shell conversation (a new chat tab in the TypeAgent Shell VS Code extension) and switch the current tab to it. Example: User: start a new conversation Agent: { actionName: \"newConversation\", parameters: {} } Example: User: new conversation called \"design review\" Agent: { actionName: \"newConversation\", parameters: { name: \"design review\" } }","parameters":[{"name":"name","type":"string","optional":true,"description":"Optional display name for the new conversation. If omitted, the user will be prompted in the extension UI."}],"phrasings":["'new' 'chat'"]},{"kind":"action","name":"newMarkdownFile","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Create a new Markdown (.md) file in the editor. Example: User: create a markdown file with a list of top ten AI papers Agent: { actionName: \"newMarkdownFile\", parameters: { fileName: \"papers.md\", content: \"# Top 10 AI Papers\\n...\" } }","parameters":[{"name":"fileName","type":"string | \"untitled\"","optional":false,"description":"The file name; if omitted or empty, \"untitled\" is used."},{"name":"content","type":"string","optional":false,"description":"Initial Markdown content; empty string for an empty scratch file."}],"phrasings":[]},{"kind":"action","name":"newTextFile","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Create a new plain text (.txt) file in the editor. Example: User: make a new text file called notes Agent: { actionName: \"newTextFile\", parameters: { fileName: \"notes.txt\", content: \"\" } }","parameters":[{"name":"fileName","type":"string | \"untitled\"","optional":false,"description":"The file name; if omitted or empty, \"untitled\" is used."},{"name":"content","type":"string","optional":false,"description":"Initial text content; empty string for an empty scratch file."}],"phrasings":[]},{"kind":"action","name":"openInIntegratedTerminal","agent":"code","schema":"code.code-workbench","enabled":false,"transient":false,"description":"","parameters":[{"name":"folderName","type":"string","optional":true,"description":"Optional: folder to open terminal in"},{"name":"commandToExecute","type":"string","optional":true,"description":"Optional: command to execute immediately"},{"name":"commandRiskLevel","type":"\"low\" | \"medium\" | \"high\"","optional":true,"description":"Optional: risk of command"},{"name":"reuseExistingTerminal","type":"boolean","optional":true,"description":"Optional: reuse current terminal or open new one, default is true"}],"phrasings":["'open' 'terminal'"]},{"kind":"action","name":"openMarkdownPreview","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Open markdown preview","parameters":[],"phrasings":["'open' 'markdown preview'"]},{"kind":"action","name":"openMarkdownPreviewToSide","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Open markdown preview to the side","parameters":[],"phrasings":["'open' 'markdown preview' 'to' 'side'"]},{"kind":"action","name":"openSettings","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Open settings","parameters":[],"phrasings":["'open' 'settings'"]},{"kind":"action","name":"reloadWindow","agent":"code","schema":"code.code-extension","enabled":false,"transient":false,"description":"","parameters":[],"phrasings":["'reload' 'window'"]},{"kind":"action","name":"removeAllBreakpoints","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"","parameters":[],"phrasings":["'remove' 'all' 'breakpoints'"]},{"kind":"action","name":"removeBreakpoint","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"","parameters":[{"name":"line","type":"number","optional":false,"description":"Line number where to remove the breakpoint"},{"name":"fileName","type":"string","optional":true,"description":"Optional: target file"},{"name":"folderName","type":"string","optional":true,"description":"Optional: folder relative to workspace"}],"phrasings":[]},{"kind":"action","name":"renameConversation","agent":"code","schema":"code.code-vscode-shell","enabled":false,"transient":false,"description":"Rename the TypeAgent Shell conversation that is currently active in this chat tab. Example: User: rename this conversation to \"vscode shell PR\" Agent: { actionName: \"renameConversation\", parameters: { newName: \"vscode shell PR\" } }","parameters":[{"name":"newName","type":"string","optional":false,"description":"The new display name to apply to the current conversation."}],"phrasings":[]},{"kind":"action","name":"replaceInFiles","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Replace in files","parameters":[],"phrasings":["'replace in' 'files'"]},{"kind":"action","name":"saveAllFiles","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"","parameters":[{"name":"onlyDirty","type":"boolean","optional":true,"description":""},{"name":"excludeUntitled","type":"boolean","optional":true,"description":""},{"name":"logResult","type":"boolean","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"saveCurrentFile","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"","parameters":[{"name":"showErrorIfNoActiveEditor","type":"boolean","optional":true,"description":""},{"name":"onlyDirty","type":"boolean","optional":true,"description":""},{"name":"excludeUntitled","type":"boolean","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"setBreakpoint","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"","parameters":[{"name":"line","type":"number","optional":false,"description":"Line number where to set the breakpoint"},{"name":"fileName","type":"string","optional":true,"description":"Optional: target file"},{"name":"folderName","type":"string","optional":true,"description":"Optional: folder relative to workspace"}],"phrasings":[]},{"kind":"action","name":"showCommandPalette","agent":"code","schema":"code.code-general","enabled":false,"transient":false,"description":"Show or open the command palette that allows to search and execute commands Trigger this action only when asked to show/open the command palette explicitly","parameters":[],"phrasings":["'show' 'command palette'"]},{"kind":"action","name":"showDebugPanel","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"Show debug panel or window in the editor or code window, if not already visible","parameters":[],"phrasings":["'show' 'debug' 'panel'"]},{"kind":"action","name":"showExplorer","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Show explorer/show the file explorer","parameters":[],"phrasings":["'show' 'explorer'"]},{"kind":"action","name":"showExtensions","agent":"code","schema":"code.code-extension","enabled":false,"transient":false,"description":"Show the extensions panel","parameters":[],"phrasings":["'show' 'extensions'"]},{"kind":"action","name":"showHover","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"Show hover","parameters":[],"phrasings":["'show' 'hover'"]},{"kind":"action","name":"showKeyboardShortcuts","agent":"code","schema":"code.code-general","enabled":false,"transient":false,"description":"Show keyboard shortcuts","parameters":[],"phrasings":["'show' 'keyboard shortcuts'"]},{"kind":"action","name":"showOutputPanel","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Show output panel","parameters":[],"phrasings":["'show' 'output'"]},{"kind":"action","name":"showSearch","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Show search or replace pane/window in the sidebar to search for text in the files Note that this is not for searching or finding files","parameters":[],"phrasings":["'show' 'search'"]},{"kind":"action","name":"showSourceControl","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Show source control","parameters":[],"phrasings":["'show' 'source control'"]},{"kind":"action","name":"showUserSettings","agent":"code","schema":"code.code-general","enabled":false,"transient":false,"description":"Show user settings","parameters":[],"phrasings":["'show' 'settings'"]},{"kind":"action","name":"splitEditor","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Split an editor window into multiple panes showing the same file or different files side-by-side. Example: User: split editor to the right Agent: { actionName: \"splitEditor\", parameters: { direction: \"right\" } } Example: User: split the editor with utils.ts Agent: { actionName: \"splitEditor\", parameters: { fileName: \"utils.ts\" } }","parameters":[{"name":"direction","type":"\"right\" | \"left\" | \"up\" | \"down\"","optional":true,"description":"Direction to split: \"right\", \"left\", \"up\", \"down\". Only include if user specifies direction."},{"name":"editorPosition","type":"\"first\" | \"last\" | \"active\" | number","optional":true,"description":"Which editor to split by position: \"first\" (leftmost), \"last\" (rightmost), \"active\" (current), or a 0-based index."},{"name":"fileName","type":"string","optional":true,"description":"Which editor to split by file name. Extract the file name or pattern from user request."}],"phrasings":[]},{"kind":"action","name":"startDebugging","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"Start/Continue debugging","parameters":[{"name":"configurationName","type":"string","optional":true,"description":"Name of the launch configuration to start"},{"name":"noDebug","type":"boolean","optional":true,"description":"Optional: run without debugging"}],"phrasings":["'debug'","'start' 'debugging'"]},{"kind":"action","name":"step","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"Step into/out/over","parameters":[{"name":"stepType","type":"\"into\" | \"out\" | \"over\"","optional":false,"description":""}],"phrasings":["'over'","'out'","'into'","'step in'"]},{"kind":"action","name":"stopDebugging","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"Stop debugging","parameters":[],"phrasings":["'stop' 'debugging'"]},{"kind":"action","name":"switchConversation","agent":"code","schema":"code.code-vscode-shell","enabled":false,"transient":false,"description":"Switch the current TypeAgent Shell chat tab to a different existing conversation, identified by its display name. If no conversation with that name exists, a new one will be created with that name and the current tab will switch to it. Example: User: switch to the \"design review\" conversation Agent: { actionName: \"switchConversation\", parameters: { name: \"design review\" } } Example: User: switch conversation Agent: { actionName: \"switchConversation\", parameters: {} }","parameters":[{"name":"name","type":"string","optional":true,"description":"The display name of the conversation to switch to. If omitted, the user will be shown a picker in the extension UI. If the named conversation does not exist, a new one will be created."}],"phrasings":["'switch' 'chat'"]},{"kind":"action","name":"toggleBreakpoint","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"","parameters":[{"name":"line","type":"number","optional":false,"description":"Line number where to toggle the breakpoint"},{"name":"fileName","type":"string","optional":true,"description":"Optional: target file"},{"name":"folderName","type":"string","optional":true,"description":"Optional: folder relative to workspace"}],"phrasings":[]},{"kind":"action","name":"toggleSearchDetails","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Toggle search details","parameters":[],"phrasings":["'toggle' 'search details'"]},{"kind":"action","name":"workbenchBuildRelatedTask","agent":"code","schema":"code.code-workbench","enabled":false,"transient":false,"description":"","parameters":[{"name":"task","type":"\"build\" | \"rebuild\" | \"clean\"","optional":false,"description":""},{"name":"folderName","type":"string","optional":true,"description":""},{"name":"taskSelection","type":"string | number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"workbenchCreateFolderFromExplorer","agent":"code","schema":"code.code-workbench","enabled":false,"transient":false,"description":"","parameters":[{"name":"folderName","type":"string","optional":false,"description":""},{"name":"relativeTo","type":"string","optional":true,"description":""},{"name":"resolutionHint","type":"\"inferFromName\" | \"workspaceRoot\" | \"activeSelection\"","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"workbenchOpenFile","agent":"code","schema":"code.code-workbench","enabled":false,"transient":false,"description":"","parameters":[{"name":"fileName","type":"string","optional":false,"description":"The name of the file to open (e.g., \"main.ts\")"},{"name":"matchStrategy","type":"\"exact\" | \"fuzzy\"","optional":true,"description":"Optional: control how strict the match is (default: \"exact\")"},{"name":"extensions","type":"string[]","optional":true,"description":"Optional: restrict to certain extensions (e.g., [\".ts\", \".js\"])"},{"name":"includeGenerated","type":"boolean","optional":true,"description":"Optional: whether to include files in dist/build/etc (default: false)"}],"phrasings":[]},{"kind":"action","name":"workbenchOpenFolder","agent":"code","schema":"code.code-workbench","enabled":false,"transient":false,"description":"","parameters":[{"name":"folderName","type":"string","optional":false,"description":"Name of the folder to reveal in Explorer"},{"name":"folderRelativeTo","type":"string","optional":true,"description":"Optional: restrict to folders under this path or name"},{"name":"includeGenerated","type":"boolean","optional":true,"description":"Optional: whether to include folders in node_modules, dist, etc. default: false"}],"phrasings":[]},{"kind":"action","name":"zenMode","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Code in Zen Mode","parameters":[],"phrasings":["'zen mode'"]},{"kind":"action","name":"zoomIn","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Zoom in the editor","parameters":[],"phrasings":["in'"]},{"kind":"action","name":"zoomOut","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Zoom out the editor","parameters":[],"phrasings":["out'"]}]},{"kind":"agent","name":"github-cli","emoji":"🐙","description":"Agent for github-cli","children":[{"kind":"action","name":"agentTaskRun","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"task","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"aliasSet","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""},{"name":"command","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"apiRequest","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"method","type":"string","optional":true,"description":""},{"name":"endpoint","type":"string","optional":true,"description":""},{"name":"limit","type":"number","optional":true,"description":""}],"phrasings":["top {limit} contributors to {endpoint}","list contributors to {endpoint}"]},{"kind":"action","name":"attestationCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"artifact","type":"string","optional":true,"description":""},{"name":"type","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"authLogin","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"hostname","type":"string","optional":true,"description":""},{"name":"web","type":"boolean","optional":true,"description":""},{"name":"token","type":"string","optional":true,"description":""}],"phrasings":["into GitHub"]},{"kind":"action","name":"authLogout","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"hostname","type":"string","optional":true,"description":""}],"phrasings":["out of GitHub"]},{"kind":"action","name":"authStatus","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"hostname","type":"string","optional":true,"description":""},{"name":"showToken","type":"boolean","optional":true,"description":""}],"phrasings":["check my GitHub authentication"]},{"kind":"action","name":"browseIssue","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"browsePr","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"browseRepo","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"branch","type":"string","optional":true,"description":""},{"name":"commit","type":"string","optional":true,"description":""},{"name":"tag","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"cacheDelete","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"id","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"cacheList","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"codespaceCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":""},{"name":"branch","type":"string","optional":true,"description":""},{"name":"location","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"codespaceDelete","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"codespaceList","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"completionGenerate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"shell","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"configSet","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""},{"name":"value","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"copilotRun","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"task","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"dependabotAlerts","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":"owner/repo"},{"name":"severity","type":"string","optional":true,"description":"Filter by severity: critical, high, medium, low"},{"name":"state","type":"string","optional":true,"description":"Filter by state: open, dismissed, fixed"}],"phrasings":[]},{"kind":"action","name":"extensionInstall","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"gistCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"public","type":"boolean","optional":true,"description":""},{"name":"description","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"gistDelete","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"id","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"gistList","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"public","type":"boolean","optional":true,"description":""}],"phrasings":["my gists"]},{"kind":"action","name":"gpgKeyAdd","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"key","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"issueAddLabel","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":false,"description":""},{"name":"label","type":"string","optional":false,"description":""},{"name":"repo","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"issueClose","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"issueCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":"owner/repo"},{"name":"title","type":"string","optional":true,"description":""},{"name":"body","type":"string","optional":true,"description":""},{"name":"assignee","type":"string","optional":true,"description":""},{"name":"label","type":"string","optional":true,"description":""}],"phrasings":["file an issue about {title}","create issue {title}"]},{"kind":"action","name":"issueDelete","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"Permanently delete a GitHub issue (uses `gh issue delete --yes`).","parameters":[{"name":"number","type":"number","optional":false,"description":""},{"name":"repo","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"issueList","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":""},{"name":"state","type":"string","optional":true,"description":""},{"name":"label","type":"string","optional":true,"description":""},{"name":"author","type":"string","optional":true,"description":"Filter by author (issue creator): a GitHub login (e.g. \"octocat\") or \"@me\" for the current user. Use this for \"issues I opened\"."},{"name":"assignee","type":"string","optional":true,"description":"Filter by assignee: a GitHub login (e.g. \"octocat\"), \"@me\" for the current user, or \"none\" to list only unassigned issues. Use this for \"issues assigned to me\"."},{"name":"limit","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"issueReopen","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"issueView","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"View / open a specific GitHub issue by number. Example: User: show issue 2222 Agent: { actionName: \"issueView\", parameters: { number: 2222 } } Example: User: view issue #42 in microsoft/TypeAgent Agent: { actionName: \"issueView\", parameters: { number: 42, repo: \"microsoft/TypeAgent\" } }","parameters":[{"name":"number","type":"number","optional":true,"description":"The issue number. Omit when the user references an issue via entity resolution (\"that issue\", \"the issue we just opened\") — the dispatcher will substitute it."},{"name":"repo","type":"string","optional":true,"description":"OWNER/REPO slug (e.g. \"microsoft/TypeAgent\"). Omit unless the user names the repo."}],"phrasings":[]},{"kind":"action","name":"labelCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""},{"name":"color","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"licensesView","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"myAssignedIssues","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"List issues assigned to the current authenticated user across all repositories. Maps to `gh search issues --assignee @me --state open`.","parameters":[{"name":"limit","type":"number","optional":true,"description":"Maximum number of issues to return (default 20)"}],"phrasings":["what issues are assigned to me","show issues assigned to me","show my assigned issues"]},{"kind":"action","name":"myPullRequests","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"List the current user's own pull requests across ALL repositories — the PRs they authored. Maps to `gh search prs --author @me`. Use this for \"my PRs\", \"PRs I opened\", or \"my open PRs everywhere\" when no specific repo is named. For PRs within a single repo, use `prList` with author: \"@me\" instead.","parameters":[{"name":"state","type":"string","optional":true,"description":"Filter by state: \"open\" (default) or \"closed\"."},{"name":"owner","type":"string","optional":true,"description":"Scope the search to a single org/user's repositories (e.g. \"microsoft\"). Omit to search every repository the user can see."},{"name":"limit","type":"number","optional":true,"description":"Maximum number of pull requests to return (default 20)."}],"phrasings":["what pull requests have I opened","show pull requests I opened","show my pull requests","show my open pull requests"]},{"kind":"action","name":"orgList","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"orgView","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"prCheckout","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":true,"description":""},{"name":"branch","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"prChecks","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":false,"description":""},{"name":"repo","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"prClose","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"prCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"title","type":"string","optional":true,"description":""},{"name":"body","type":"string","optional":true,"description":""},{"name":"base","type":"string","optional":true,"description":""},{"name":"head","type":"string","optional":true,"description":""},{"name":"draft","type":"boolean","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"previewExecute","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"feature","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"prList","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"List pull requests, optionally filtered by repo, state, label, author, or assignee. A PR is \"mine\" when the user *authored* it. On GitHub the owner of a PR is its author, not its assignee (self-assignment is rare), so \"my PRs\", \"PRs I opened\", and \"are any of those mine?\" map to author: \"@me\" — NOT assignee. Example: User: are any of those mine?  (after listing open PRs in microsoft/TypeAgent) Agent: { actionName: \"prList\", parameters: { repo: \"microsoft/TypeAgent\", state: \"open\", author: \"@me\" } } Example: User: show my open pull requests Agent: { actionName: \"prList\", parameters: { state: \"open\", author: \"@me\" } }","parameters":[{"name":"repo","type":"string","optional":true,"description":""},{"name":"state","type":"string","optional":true,"description":""},{"name":"label","type":"string","optional":true,"description":""},{"name":"author","type":"string","optional":true,"description":"Filter by author (PR creator): a GitHub login (e.g. \"octocat\") or \"@me\" for the current user. Use this for \"my PRs\" / \"PRs I opened\"."},{"name":"assignee","type":"string","optional":true,"description":"Filter by assignee: a GitHub login (e.g. \"octocat\"), \"@me\" for the current user, or \"none\" to list only unassigned pull requests. Most PRs have no assignee — prefer `author` for \"my PRs\"."},{"name":"limit","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"prMerge","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":true,"description":""},{"name":"mergeMethod","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"projectCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""},{"name":"body","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"projectDelete","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"id","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"projectList","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"prView","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"View / open a specific GitHub pull request by number. Example: User: show PR 2196 Agent: { actionName: \"prView\", parameters: { number: 2196 } } Example: User: view pull request #42 in microsoft/TypeAgent Agent: { actionName: \"prView\", parameters: { number: 42, repo: \"microsoft/TypeAgent\" } }","parameters":[{"name":"number","type":"number","optional":true,"description":"The pull request number. Omit when the user references a PR via entity resolution (\"that PR\", \"the PR we just opened\") — the dispatcher will substitute it."},{"name":"repo","type":"string","optional":true,"description":"OWNER/REPO slug (e.g. \"microsoft/TypeAgent\"). Omit unless the user names the repo."}],"phrasings":[]},{"kind":"action","name":"releaseCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"tag","type":"string","optional":true,"description":""},{"name":"title","type":"string","optional":true,"description":""},{"name":"notes","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"releaseDelete","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"id","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"releaseList","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"repoClone","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":""},{"name":"branch","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"repoCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""},{"name":"description","type":"string","optional":true,"description":""},{"name":"public","type":"boolean","optional":true,"description":""},{"name":"private","type":"boolean","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"repoDelete","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"repoFork","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":""},{"name":"name","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"repoView","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":""},{"name":"field","type":"string","optional":true,"description":""}],"phrasings":["how many stars does {repo} have","show repository {repo}"]},{"kind":"action","name":"rulesetView","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"runView","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"id","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"searchRepos","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"query","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"secretCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""},{"name":"value","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"sshKeyAdd","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"key","type":"string","optional":true,"description":""}],"phrasings":["add an SSH key for me"]},{"kind":"action","name":"starRepo","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":""},{"name":"unstar","type":"boolean","optional":true,"description":""}],"phrasings":["unstar {repo}","star {repo}"]},{"kind":"action","name":"statusPrint","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["summary of issues and pull requests","print latest updates on my repositories","show status of issues and pull requests","show my GitHub status"]},{"kind":"action","name":"variableCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""},{"name":"value","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"workflowView","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"id","type":"string","optional":true,"description":""}],"phrasings":[]}]},{"kind":"agent","name":"onboarding","emoji":"🛠️","description":"Agent for onboarding new applications and APIs into TypeAgent","children":[{"kind":"action","name":"addPhrase","agent":"onboarding","schema":"onboarding.onboarding-phrasegen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name"},{"name":"actionName","type":"string","optional":false,"description":"The action name this phrase should map to"},{"name":"phrase","type":"string","optional":false,"description":"The natural language phrase to add"}],"phrasings":["add phrase {phrase} for {actionName} in {integrationName}"]},{"kind":"action","name":"approveApiSurface","agent":"onboarding","schema":"onboarding.onboarding-discovery","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to approve"},{"name":"includeActions","type":"string[]","optional":true,"description":"If provided, only these action names are included in the approved surface (excludes all others)"},{"name":"excludeActions","type":"string[]","optional":true,"description":"Action names to exclude from the approved surface"}],"phrasings":["confirm {integrationName} surface","approve surface for {integrationName}"]},{"kind":"action","name":"approveGrammar","agent":"onboarding","schema":"onboarding.onboarding-grammargen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to approve grammar for"}],"phrasings":["confirm {integrationName} grammar","approve {integrationName} grammar"]},{"kind":"action","name":"approvePhrases","agent":"onboarding","schema":"onboarding.onboarding-phrasegen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to approve phrases for"}],"phrasings":["confirm {integrationName} phrases","approve phrases for {integrationName}"]},{"kind":"action","name":"approveRepair","agent":"onboarding","schema":"onboarding.onboarding-testing","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to approve the proposed repair for"}],"phrasings":["apply {integrationName} repair","approve {integrationName} repair"]},{"kind":"action","name":"approveSchema","agent":"onboarding","schema":"onboarding.onboarding-schemagen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to approve schema for"}],"phrasings":["confirm {integrationName} schema","approve {integrationName} schema"]},{"kind":"action","name":"compileGrammar","agent":"onboarding","schema":"onboarding.onboarding-grammargen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name whose grammar to compile and validate"}],"phrasings":["validate {integrationName} grammar","compile {integrationName} grammar"]},{"kind":"action","name":"crawlCliHelp","agent":"onboarding","schema":"onboarding.onboarding-discovery","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Name of the integration being onboarded"},{"name":"command","type":"string","optional":false,"description":"The CLI command to crawl (e.g. \"gh\", \"az\", \"kubectl\")"},{"name":"maxDepth","type":"number","optional":true,"description":"Maximum recursion depth into subcommands (default: 4)"}],"phrasings":["discover {command} cli as {integrationName}","crawl cli help {command} as {integrationName}"]},{"kind":"action","name":"crawlDocUrl","agent":"onboarding","schema":"onboarding.onboarding-discovery","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Name of the integration being onboarded"},{"name":"url","type":"string","optional":false,"description":"URL of the API documentation page to crawl (e.g. \"https://api.slack.com/methods\")"},{"name":"maxDepth","type":"number","optional":true,"description":"Maximum link-follow depth (default: 2)"}],"phrasings":["fetch {integrationName} docs {url}","crawl docs {url} for {integrationName}"]},{"kind":"action","name":"generateDemo","agent":"onboarding","schema":"onboarding.onboarding-packaging","enabled":true,"transient":false,"description":"Generates a demo script and narration for the onboarded agent","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Name of the integration"},{"name":"durationMinutes","type":"string","optional":true,"description":"Duration target in minutes (default: 3-5)"}],"phrasings":["create demo for {integrationName}","generate demo for {integrationName}"]},{"kind":"action","name":"generateGrammar","agent":"onboarding","schema":"onboarding.onboarding-grammargen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to generate grammar for"}],"phrasings":["create {integrationName} grammar","generate grammar for {integrationName}"]},{"kind":"action","name":"generatePhrases","agent":"onboarding","schema":"onboarding.onboarding-phrasegen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to generate phrases for"},{"name":"phrasesPerAction","type":"number","optional":true,"description":"Number of phrases to generate per action (default: 5)"},{"name":"forActions","type":"string[]","optional":true,"description":"Generate phrases only for these specific action names (generates for all if omitted)"}],"phrasings":[]},{"kind":"action","name":"generateReadme","agent":"onboarding","schema":"onboarding.onboarding-packaging","enabled":true,"transient":false,"description":"Generates a README.md for the onboarded agent","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Name of the integration"}],"phrasings":["create readme for {integrationName}","generate readme for {integrationName}"]},{"kind":"action","name":"generateSchema","agent":"onboarding","schema":"onboarding.onboarding-schemagen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to generate schema for"}],"phrasings":["create schema for {integrationName}","generate schema for {integrationName}"]},{"kind":"action","name":"generateTests","agent":"onboarding","schema":"onboarding.onboarding-testing","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to generate tests for"}],"phrasings":["create test cases for {integrationName}","generate tests for {integrationName}"]},{"kind":"action","name":"getOnboardingStatus","agent":"onboarding","schema":"onboarding","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to check status for"}],"phrasings":["how far along is {integrationName}","show {integrationName} onboarding status","what's status {integrationName} onboarding"]},{"kind":"action","name":"getTestResults","agent":"onboarding","schema":"onboarding.onboarding-testing","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to get test results for"},{"name":"filter","type":"\"passing\" | \"failing\"","optional":true,"description":"Filter to show only passing or failing tests"}],"phrasings":["what are results for {integrationName}","get {integrationName} test results"]},{"kind":"action","name":"listDiscoveredActions","agent":"onboarding","schema":"onboarding.onboarding-discovery","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to list discovered actions for"}],"phrasings":["show actions {integrationName}","list actions for {integrationName}"]},{"kind":"action","name":"listIntegrations","agent":"onboarding","schema":"onboarding","enabled":true,"transient":false,"description":"","parameters":[{"name":"status","type":"\"in-progress\" | \"complete\"","optional":true,"description":"Filter by phase status; omit to list all"}],"phrasings":["what integrations","show integrations","list integrations"]},{"kind":"action","name":"listPatterns","agent":"onboarding","schema":"onboarding.onboarding-scaffolder","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["what patterns","show patterns","list patterns"]},{"kind":"action","name":"listTemplates","agent":"onboarding","schema":"onboarding.onboarding-scaffolder","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["show templates","list templates"]},{"kind":"action","name":"packageAgent","agent":"onboarding","schema":"onboarding.onboarding-packaging","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to package"},{"name":"register","type":"boolean","optional":true,"description":"If true, also register the agent with the local TypeAgent dispatcher config"}],"phrasings":["build {integrationName}","package {integrationName} agent"]},{"kind":"action","name":"parseOpenApiSpec","agent":"onboarding","schema":"onboarding.onboarding-discovery","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Name of the integration being onboarded"},{"name":"specSource","type":"string","optional":false,"description":"URL or absolute file path to the OpenAPI 3.x or Swagger 2.x spec"}],"phrasings":["load {integrationName} openapi spec {specSource}","parse openapi spec {specSource} for {integrationName}"]},{"kind":"action","name":"proposeRepair","agent":"onboarding","schema":"onboarding.onboarding-testing","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to propose repairs for"},{"name":"forActions","type":"string[]","optional":true,"description":"If provided, propose repairs only for these specific failing action names"}],"phrasings":["suggest fix for {integrationName} failures","propose repair for {integrationName}"]},{"kind":"action","name":"refineSchema","agent":"onboarding","schema":"onboarding.onboarding-schemagen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name"},{"name":"instructions","type":"string","optional":false,"description":"Specific instructions for the LLM about what to change e.g. \"make the listName parameter optional\" or \"add a sortOrder parameter to sortAction\""}],"phrasings":["update {integrationName} schema {instructions}","refine {integrationName} schema {instructions}"]},{"kind":"action","name":"removePhrase","agent":"onboarding","schema":"onboarding.onboarding-phrasegen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name"},{"name":"actionName","type":"string","optional":false,"description":"The action name to remove the phrase from"},{"name":"phrase","type":"string","optional":false,"description":"The exact phrase to remove"}],"phrasings":["remove phrase {phrase} from {actionName} in {integrationName}"]},{"kind":"action","name":"resumeOnboarding","agent":"onboarding","schema":"onboarding","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Name of the integration to resume"},{"name":"fromPhase","type":"\"discovery\" | \"phraseGen\" | \"schemaGen\" | \"grammarGen\" | \"scaffolder\" | \"testing\" | \"packaging\"","optional":true,"description":"Optional: override which phase to start from (defaults to current phase in state.json)"}],"phrasings":["continue {integrationName} onboarding","resume onboarding {integrationName}"]},{"kind":"action","name":"runTests","agent":"onboarding","schema":"onboarding.onboarding-testing","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to run tests for"},{"name":"forActions","type":"string[]","optional":true,"description":"Run only tests for these specific action names"},{"name":"limit","type":"number","optional":true,"description":"Maximum number of tests to run (runs all if omitted)"}],"phrasings":["execute {integrationName} tests","run tests for {integrationName}"]},{"kind":"action","name":"scaffoldAgent","agent":"onboarding","schema":"onboarding.onboarding-scaffolder","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to scaffold agent for"},{"name":"pattern","type":"\"schema-grammar\" | \"external-api\" | \"llm-streaming\" | \"sub-agent-orchestrator\" | \"websocket-bridge\" | \"state-machine\" | \"native-platform\" | \"view-ui\" | …","optional":true,"description":"Architectural pattern to use (defaults to \"schema-grammar\")"},{"name":"outputDir","type":"string","optional":true,"description":"Target directory for the agent package (defaults to ts/packages/agents/\u003cname>)"},{"name":"emojiChar","type":"string","optional":true,"description":"Emoji character for the agent icon (defaults to \"🔎\")"}],"phrasings":[]},{"kind":"action","name":"scaffoldPlugin","agent":"onboarding","schema":"onboarding.onboarding-scaffolder","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to scaffold the host-side plugin for"},{"name":"template","type":"\"office-addin\" | \"vscode-extension\" | \"electron-app\" | \"browser-extension\" | \"rest-client\"","optional":false,"description":"Template to use for the plugin side"},{"name":"outputDir","type":"string","optional":true,"description":"Target directory for the plugin (defaults to ts/packages/agents/\u003cname>/plugin)"}],"phrasings":["create {integrationName} plugin","scaffold {integrationName} plugin"]},{"kind":"action","name":"startOnboarding","agent":"onboarding","schema":"onboarding","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Unique name for this integration (e.g. \"slack\", \"jira\", \"my-rest-api\"). Used as the workspace folder name — lowercase, no spaces."},{"name":"description","type":"string","optional":true,"description":"Human-readable description of what the integration does"},{"name":"apiType","type":"\"rest\" | \"graphql\" | \"websocket\" | \"ipc\" | \"sdk\"","optional":true,"description":"The type of API being integrated; helps select appropriate templates and bridge patterns"}],"phrasings":["begin {integrationName} integration","onboard {integrationName}","start onboarding {integrationName}"]},{"kind":"action","name":"validatePackage","agent":"onboarding","schema":"onboarding.onboarding-packaging","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name whose package to validate"}],"phrasings":["check {integrationName} package","validate {integrationName} package"]}]},{"kind":"agent","name":"powershell","emoji":"📜","description":"Agent to create and execute PowerShell workflows","children":[{"kind":"action","name":"createPowerShellFlow","agent":"powershell","schema":"powershell","enabled":true,"transient":false,"description":"Create a new PowerShell flow with grammar rules for future reuse","parameters":[{"name":"actionName","type":"string","optional":false,"description":"camelCase identifier for the new flow"},{"name":"description","type":"string","optional":false,"description":"What this script does"},{"name":"displayName","type":"string","optional":false,"description":"Human-readable name"},{"name":"script","type":"string","optional":false,"description":"PowerShell script body (should include param() block)"},{"name":"scriptParameters","type":"{ name, type, required, description, default }[]","optional":false,"description":"Script parameters"},{"name":"grammarPatterns","type":"{ pattern, isAlias }[]","optional":false,"description":"Grammar patterns for matching"},{"name":"allowedCmdlets","type":"string[]","optional":false,"description":"PowerShell cmdlets the script uses"},{"name":"allowedModules","type":"string[]","optional":true,"description":"PowerShell modules to import for the script's cmdlets (e.g. [\"NetTCPIP\"] for Get-NetTCPConnection). Include every module required by allowedCmdlets — use the same list that made testPowerShellFlow pass, or the flow will fail at invocation with \"not recognized\"."}],"phrasings":[]},{"kind":"action","name":"deletePowerShellFlow","agent":"powershell","schema":"powershell","enabled":true,"transient":false,"description":"Delete a PowerShell flow by name","parameters":[{"name":"name","type":"string","optional":false,"description":"Name of the PowerShell flow to delete"}],"phrasings":["delete powershell flow {name}"]},{"kind":"action","name":"editPowerShellFlow","agent":"powershell","schema":"powershell","enabled":true,"transient":false,"description":"Edit an existing PowerShell flow's script body (preserves grammar patterns and parameters)","parameters":[{"name":"flowName","type":"string","optional":false,"description":"Name of the PowerShell flow to edit"},{"name":"script","type":"string","optional":false,"description":"New PowerShell script body (should include param() block matching existing parameters)"},{"name":"allowedCmdlets","type":"string[]","optional":false,"description":"Updated list of PowerShell cmdlets the script uses"},{"name":"allowedModules","type":"string[]","optional":true,"description":"Updated list of PowerShell modules to import (optional; preserved if omitted)"}],"phrasings":[]},{"kind":"action","name":"executePowerShellFlow","agent":"powershell","schema":"powershell","enabled":true,"transient":false,"description":"Execute a registered PowerShell flow by name with parameters","parameters":[{"name":"flowName","type":"string","optional":false,"description":"Name of the PowerShell flow to execute (use listPowerShellFlows to see available flows)"},{"name":"flowArgs","type":"string","optional":true,"description":"Captured arguments from the user's request (e.g. a path or filter)"},{"name":"flowParametersJson","type":"string","optional":true,"description":"JSON string of named parameters e.g. '{\"Directory\":\"C:\\\\Users\",\"Pattern\":\"*.txt\"}'"}],"phrasings":[]},{"kind":"action","name":"importPowerShellFlow","agent":"powershell","schema":"powershell","enabled":true,"transient":false,"description":"Import an existing PowerShell script file as a new PowerShell flow","parameters":[{"name":"filePath","type":"string","optional":false,"description":"Absolute or relative path to the .ps1 file to import"},{"name":"actionName","type":"string","optional":true,"description":"Optional: override the generated action name"}],"phrasings":["import script {filePath}"]},{"kind":"action","name":"listPowerShellFlows","agent":"powershell","schema":"powershell","enabled":true,"transient":false,"description":"Lists all registered PowerShell flows","parameters":[],"phrasings":["show me powershell flows"]}]},{"kind":"agent","name":"studio","emoji":"🎨","description":"TypeAgent Studio agent — the AI / conversational presenter of TypeAgent Studio, driving the author → tune → validate developer loop over the Studio engine. Today it surfaces inspection of Studio's environment, grammar collisions, and event stream; the rest of the loop (sandboxes, run, validate, author) is being added.","children":[{"kind":"action","name":"getStudioInfo","agent":"studio","schema":"studio","enabled":true,"transient":false,"description":"Report Studio's environment: the repository root it is inspecting and the directories (\"agent locations\") it scans for agents, with how many agent packages each contains. Use this to confirm Studio is pointed at the right place. Read-only.","parameters":[],"phrasings":[]},{"kind":"action","name":"listCollisions","agent":"studio","schema":"studio","enabled":true,"transient":false,"description":"List the cross-schema grammar collisions Studio currently knows about (newest first). These are populated by collision scans; the list is empty until a scan has run. Read-only.","parameters":[],"phrasings":[]},{"kind":"action","name":"queryEvents","agent":"studio","schema":"studio","enabled":true,"transient":false,"description":"Show the most recent entries from Studio's structured event stream (sandbox/collision/replay/feedback events), oldest-to-newest. Read-only.","parameters":[{"name":"limit","type":"number","optional":true,"description":"Maximum number of recent events to return (default 20)."}],"phrasings":[]}]},{"kind":"agent","name":"taskflow","emoji":"🔁","description":"User-taught macros over TypeAgent actions","children":[{"kind":"action","name":"deleteTaskFlow","agent":"taskflow","schema":"taskflow","enabled":true,"transient":false,"description":"Delete a task flow by name","parameters":[{"name":"name","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"listTaskFlows","agent":"taskflow","schema":"taskflow","enabled":true,"transient":false,"description":"Lists all registered task flows","parameters":[],"phrasings":[]}]},{"kind":"agent","name":"utility","emoji":"🔧","description":"Utility agent — web search, web fetch, and file I/O for compiled task flows","children":[{"kind":"action","name":"claudeTask","agent":"utility","schema":"utility","enabled":true,"transient":false,"description":"","parameters":[{"name":"goal","type":"string","optional":false,"description":"Goal or question for Claude to accomplish using its tools (web search, fetch, etc.)"},{"name":"parseJson","type":"boolean","optional":true,"description":"Parse the result as JSON and store in historyText (default: false)"},{"name":"model","type":"string","optional":true,"description":"Claude model ID (default: claude-haiku-4-5-20251001)"},{"name":"maxTurns","type":"number","optional":true,"description":"Maximum agentic turns (default: 10)"}],"phrasings":[]},{"kind":"action","name":"llmTransform","agent":"utility","schema":"utility","enabled":true,"transient":false,"description":"","parameters":[{"name":"input","type":"string","optional":false,"description":"Text or HTML to transform"},{"name":"prompt","type":"string","optional":false,"description":"Instructions for the transformation"},{"name":"parseJson","type":"boolean","optional":true,"description":"Parse the result as JSON and store in historyText (default: false)"},{"name":"htmlOutput","type":"boolean","optional":true,"description":"When true, LLM is asked to return HTML; result is stored in historyText as HTML (default: false)"},{"name":"model","type":"string","optional":true,"description":"Claude model ID (default: claude-haiku-4-5-20251001)"}],"phrasings":[]},{"kind":"action","name":"readFile","agent":"utility","schema":"utility","enabled":true,"transient":false,"description":"","parameters":[{"name":"path","type":"string","optional":false,"description":"Absolute or relative path to the file"}],"phrasings":["get {path}","read {path}"]},{"kind":"action","name":"webFetch","agent":"utility","schema":"utility","enabled":true,"transient":false,"description":"","parameters":[{"name":"url","type":"string","optional":false,"description":"URL to fetch"}],"phrasings":["get {url}","fetch {url}"]},{"kind":"action","name":"webSearch","agent":"utility","schema":"utility","enabled":true,"transient":false,"description":"","parameters":[{"name":"query","type":"string","optional":false,"description":"Search query text"},{"name":"numResults","type":"number","optional":true,"description":"Number of results to return (default: 5)"}],"phrasings":["look up {query} online","find {query} on the web","web search {query}","search web for {query}"]},{"kind":"action","name":"writeFile","agent":"utility","schema":"utility","enabled":true,"transient":false,"description":"","parameters":[{"name":"path","type":"string","optional":false,"description":"Absolute or relative path to the file"},{"name":"content","type":"string","optional":false,"description":"Text content to write"}],"phrasings":[]}]},{"kind":"agent","name":"visualStudio","emoji":"💻","description":"Visual Studio integration for editor, solution, build, and debug actions via the EnvDTE automation API","children":[{"kind":"action","name":"addBreakpoint","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Adds a new breakpoint to the debugger. IMPORTANT: Ensure the file path and line number are correct. User: \"Can you add a breakpoint at line 42 in main.cpp?\" Agent: \"Adding a breakpoint at line 42 in main.cpp.\"","parameters":[{"name":"file","type":"string","optional":false,"description":"The file where the breakpoint will be added."},{"name":"line","type":"string","optional":false,"description":"The line number where the breakpoint will be added (as a string; handler parses to int)."},{"name":"condition","type":"string","optional":true,"description":"Optional condition for the breakpoint."}],"phrasings":[]},{"kind":"action","name":"break","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Causes the given process to pause its execution so that its current state can be analyzed. User: \"Pause the process right now.\" Agent: \"Pausing the process immediately.\"","parameters":[],"phrasings":["halt the process instantly","stop the current process for debugging","break the execution immediately","pause the process right now"]},{"kind":"action","name":"build","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Causes the active solution configuration to begin building. User: \"Can you start building the solution, please?\" Agent: \"Starting to build the solution.\"","parameters":[{"name":"waitForCompletion","type":"boolean","optional":true,"description":"Whether to wait for the build to complete."}],"phrasings":["begin building the solution","initiate the build process for the current solution","build the active solution configuration","start building the solution"]},{"kind":"action","name":"clean","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Deletes all compiler-generated support files for marked projects. User: \"Can you clean the solution, please?\" Agent: \"Cleaning the solution.\"","parameters":[{"name":"waitForCompletion","type":"boolean","optional":true,"description":"Whether to wait for the clean operation to complete."}],"phrasings":["delete all the build files for the projects","clean up the compiler generated files","marked projects","solution"]},{"kind":"action","name":"closeAll","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Closes all open documents in the environment and optionally saves them. User: \"Close all open files, please.\" Agent: \"Closing all open files.\"","parameters":[{"name":"saveChanges","type":"boolean","optional":true,"description":"Whether to save changes before closing."}],"phrasings":["shut all the documents","close everything that's open and save any changes","the open documents","open files"]},{"kind":"action","name":"debug","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Starts debugging the solution. User: \"Can you start debugging the solution?\" Agent: \"Starting to debug the solution.\"","parameters":[],"phrasings":["debug the solution","begin debugging the project","the debug process for the solution","debugging the solution"]},{"kind":"action","name":"executeCommand","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Executes a command in the Visual Studio environment. User: \"Can you run the command in Visual Studio for me?\" Agent: \"Executing the command in Visual Studio.\"","parameters":[{"name":"commandName","type":"string","optional":false,"description":"The name of the command to execute."},{"name":"commandArgs","type":"string","optional":true,"description":"Optional arguments for the command."}],"phrasings":[]},{"kind":"action","name":"findInFiles","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Performs a search operation across files in the solution. User: \"Can you search for 'searchTerm' in all the files with 'fileTypes' extensions?\" Agent: \"Searching for 'searchTerm' in files with 'fileTypes' extensions.\"","parameters":[{"name":"searchTerm","type":"string","optional":false,"description":"The term to search for in the files."},{"name":"fileTypes","type":"string","optional":true,"description":"Optional file types to limit the search."}],"phrasings":[]},{"kind":"action","name":"findText","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Searches for the given text from the active point to the end of the document. User: \"Can you search for the text 'example' from here to the end of the document?\" Agent: \"Searching for 'example' from the current position to the end of the document.\"","parameters":[{"name":"text","type":"string","optional":false,"description":"The text to search for in the document."},{"name":"caseSensitive","type":"boolean","optional":true,"description":"Optional flags for the search operation."},{"name":"wholeWord","type":"boolean","optional":true,"description":""},{"name":"useRegex","type":"boolean","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"go","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Starts executing the program from the current statement. User: \"Run the program from here.\" Agent: \"Starting execution from the current statement.\"","parameters":[],"phrasings":["begin execution from the current statement","go ahead and run the program from the current line","start executing the code from this point","run the program from here"]},{"kind":"action","name":"gotoLine","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Moves to the beginning of the indicated line and selects the line if requested. User: \"Can you go to line 42 and select it?\" Agent: \"Going to line 42 and selecting it.\"","parameters":[{"name":"line","type":"string","optional":false,"description":"The line number to go to (as a string; handler parses to int)."},{"name":"select","type":"boolean","optional":true,"description":"Whether to select the line after moving to it."}],"phrasings":["navigate to line {line} without selecting it","jump to line {line} and highlight it","move to line {line}, but don't select it","go to line {line} and select it"]},{"kind":"action","name":"openFile","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Opens a file in the Visual Studio environment. User: \"Can you open the file located at [filePath] in Visual Studio?\" Agent: \"Opening the file at [filePath] in Visual Studio.\"","parameters":[{"name":"filePath","type":"string","optional":false,"description":"The path of the file to open."},{"name":"viewKind","type":"\"text\" | \"code\" | \"designer\" | \"debug\"","optional":true,"description":"Default behavior is \"text\". Valid values: \"text\" | \"code\" | \"designer\" | \"debug\". The view kind to use when opening the file."}],"phrasings":[]},{"kind":"action","name":"redo","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Re-executes the last action that was undone by the Undo() method or the user. User: \"Can you redo the last change I undid?\" Agent: \"Redoing the last undone change.\"","parameters":[],"phrasings":["reapply the last undone action","redo the previous action","thing I reversed","change I undid"]},{"kind":"action","name":"removeBreakpoint","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Removes an existing breakpoint from the debugger. User: \"Please remove the breakpoint with ID 12345.\" Agent: \"Removing the breakpoint with ID 12345.\"","parameters":[{"name":"breakpointId","type":"string","optional":true,"description":"One of {breakpointId} or {file+line} must be provided. The ID of the breakpoint to be removed."},{"name":"file","type":"string","optional":true,"description":"The file where the breakpoint is located."},{"name":"line","type":"string","optional":true,"description":"The line number where the breakpoint is located (as a string; handler parses to int)."}],"phrasings":[]},{"kind":"action","name":"run","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Causes the active solution configuration to execute. User: \"Can you run the current solution for me?\" Agent: \"Running the current solution.\"","parameters":[],"phrasings":["start running the solution","execute the active solution configuration","active configuration","current solution"]},{"kind":"action","name":"saveAll","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Saves all documents currently open in the environment. User: \"Can you save all my open files, please?\" Agent: \"Saving all open files.\"","parameters":[],"phrasings":["save everything I'm working on","the files","documents currently open","my open files"]},{"kind":"action","name":"stepInto","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Steps into the next function call, if possible. User: \"Can you step into the next function call, please?\" Agent: \"Stepping into the next function call.\"","parameters":[],"phrasings":["function","function call"]},{"kind":"action","name":"stepOut","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Steps out of the current function. User: \"Can you step out of the current function, please?\" Agent: \"Stepping out of the current function.\"","parameters":[],"phrasings":["step out of this function","step out of the function","function"]},{"kind":"action","name":"stepOver","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Steps over the next function call. User: \"Can you step over the next function call, please?\" Agent: \"Stepping over the next function call.\"","parameters":[],"phrasings":["call"]},{"kind":"action","name":"stop","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Stops debugging, terminating, or detaching from all attached processes. User: \"Please stop the debugging process.\" Agent: \"Stopping the debugging process.\"","parameters":[],"phrasings":["end the current debugging session","terminate all attached processes","debugging and detach from everything","the debugging process"]},{"kind":"action","name":"undo","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Reverses the action last performed by the user in the document. User: \"Can you undo my last change?\" Agent: \"Undoing the last change.\"","parameters":[],"phrasings":["reverse the last action I did","last thing I did","previous edit","undo my last change"]}]},{"kind":"agent","name":"workflow","emoji":"🔄","description":"Run automated developer workflows via chat","children":[{"kind":"action","name":"noWorkflowsLoaded","agent":"workflow","schema":"workflow","enabled":false,"transient":false,"description":"Placeholder: replaced at runtime by getDynamicSchema() with per-workflow action types derived from discovered workflow files.","parameters":[],"phrasings":[]}]}]},{"kind":"category","name":"System & Devices","emoji":"⚙️","children":[{"kind":"agent","name":"desktop","emoji":"🪟","description":"Agent to control the desktop","children":[{"kind":"action","name":"AdjustColorTemperature","agent":"desktop","schema":"desktop.desktop-display","enabled":false,"transient":false,"description":"Adjusts the color temperature for Night Light","parameters":[{"name":"filterEffect","type":"\"reduce\" | \"increase\"","optional":true,"description":""}],"phrasings":["cooler colors","warmer colors","increase blue light","reduce blue light","adjust color temperature"]},{"kind":"action","name":"AdjustMousePointerSize","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Adjusts mouse pointer size","parameters":[{"name":"sizeAdjustment","type":"\"increase\" | \"decrease\"","optional":false,"description":""}],"phrasings":["smaller cursor","bigger cursor","smaller","bigger","decrease pointer size","increase pointer size"]},{"kind":"action","name":"AdjustScreenBrightness","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Adjusts screen brightness (increase or decrease)","parameters":[{"name":"brightnessLevel","type":"\"increase\" | \"decrease\"","optional":false,"description":""}],"phrasings":["brighten screen","dim screen","screen dimmer","screen brighter","decrease brightness","increase brightness"]},{"kind":"action","name":"AdjustScreenOrientation","agent":"desktop","schema":"desktop.desktop-display","enabled":false,"transient":false,"description":"Adjusts screen orientation between portrait and landscape","parameters":[{"name":"orientation","type":"\"portrait\" | \"landscape\"","optional":false,"description":""}],"phrasings":["portrait","landscape","orientation to portrait","orientation to landscape"]},{"kind":"action","name":"AdjustVolume","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Adjusts system volume up or down by a relative amount","parameters":[{"name":"direction","type":"\"up\" | \"down\"","optional":false,"description":""},{"name":"amount","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"ApplyColorToTitleBar","agent":"desktop","schema":"desktop.desktop-personalization","enabled":false,"transient":false,"description":"Applies accent color to title bars","parameters":[{"name":"enableColor","type":"boolean","optional":false,"description":""}],"phrasings":["remove title bar color","disable title bar color","enable title bar color","show accent color on title bars","apply color to title bar"]},{"kind":"action","name":"ApplyTheme","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Apply a Windows desktop theme by name (e.g. \"Captured Motion\", \"Glow\", \"Sunrise\") or .theme file path. Affects the Windows wallpaper / sounds / cursors / window chrome. Example: User: change my windows theme to Glow Agent: { actionName: \"ApplyTheme\", parameters: { filePath: \"Glow\", themeName: \"Glow\" } }","parameters":[{"name":"filePath","type":"string","optional":false,"description":"The Windows theme name or .theme file path to apply (use \"previous\" to revert)."},{"name":"themeName","type":"string","optional":true,"description":"Optional theme name parroted by the LLM when the user mentions a specific theme; never read by the action — exists only to give the model a slot for the name so it doesn't squeeze a VS Code editor theme into `filePath`."}],"phrasings":[]},{"kind":"action","name":"AutoHideTaskbar","agent":"desktop","schema":"desktop.desktop-taskbar","enabled":false,"transient":false,"description":"Auto-hides the taskbar","parameters":[{"name":"hideWhenNotUsing","type":"boolean","optional":false,"description":""},{"name":"alwaysShow","type":"boolean","optional":false,"description":""}],"phrasings":["show taskbar","hide taskbar","always show taskbar","automatically hide taskbar","auto hide taskbar"]},{"kind":"action","name":"AutomaticDSTAdjustment","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables automatic DST adjustment","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["automatically adjust for dst","disable automatic dst","daylight saving time adjustment","automatic dst"]},{"kind":"action","name":"AutomaticTimeSettingAction","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables automatic time synchronization","parameters":[{"name":"enableAutoTimeSync","type":"boolean","optional":false,"description":""}],"phrasings":["sync time automatically","automatically set time","disable automatic time sync","enable automatic time sync"]},{"kind":"action","name":"BatterySaverActivationLevel","agent":"desktop","schema":"desktop.desktop-power","enabled":false,"transient":false,"description":"Sets the battery saver activation threshold","parameters":[{"name":"thresholdValue","type":"number","optional":false,"description":""}],"phrasings":["turn on battery saver at {level}","activate battery saver at {level}","battery saver at {level}","set battery saver to {level}"]},{"kind":"action","name":"BluetoothToggle","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"===== Common Settings Actions ===== Toggles Bluetooth radio on or off","parameters":[{"name":"enableBluetooth","type":"boolean","optional":true,"description":""}],"phrasings":["toggle bluetooth","disable bluetooth","enable bluetooth","off bluetooth","on bluetooth"]},{"kind":"action","name":"CloseProgram","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Closes a program window on a Windows Desktop","parameters":[{"name":"name","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""}],"phrasings":["exit {program}","quit {program}","close {program}"]},{"kind":"action","name":"ConnectWifi","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[{"name":"ssid","type":"string","optional":false,"description":""},{"name":"password","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"CreateDesktop","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"creates a new Windows Desktop","parameters":[{"name":"names","type":"string[]","optional":false,"description":""}],"phrasings":["desktop"]},{"kind":"action","name":"CursorTrail","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Enables or disables the mouse cursor trail and sets its length","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""},{"name":"length","type":"number","optional":true,"description":""}],"phrasings":["off cursor trail","on cursor trail","mouse trail","cursor trail"]},{"kind":"action","name":"Debug","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Attaches the debugger to the AutoShell process","parameters":[],"phrasings":[]},{"kind":"action","name":"DisconnectWifi","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Disconnects from the current wifi network","parameters":[],"phrasings":["disconnect wifi"]},{"kind":"action","name":"DisplayResolutionAndAspectRatio","agent":"desktop","schema":"desktop.desktop-display","enabled":false,"transient":false,"description":"Opens display settings to adjust resolution and aspect ratio","parameters":[],"phrasings":["open display settings","adjust resolution","aspect ratio","resolution"]},{"kind":"action","name":"DisplayScaling","agent":"desktop","schema":"desktop.desktop-display","enabled":false,"transient":false,"description":"Sets display scaling percentage (100, 125, 150, 175, 200)","parameters":[{"name":"sizeOverride","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"DisplaySecondsInSystrayClock","agent":"desktop","schema":"desktop.desktop-taskbar","enabled":false,"transient":false,"description":"Shows seconds in the system tray clock","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["disable seconds in clock","turn off seconds in clock","display seconds in clock","hide seconds in clock","only hours and minutes","seconds in clock"]},{"kind":"action","name":"DisplayTaskbarOnAllMonitors","agent":"desktop","schema":"desktop.desktop-taskbar","enabled":false,"transient":false,"description":"Shows taskbar on all monitors","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["hide taskbar from other monitors","show taskbar only on main monitor","displays","monitors"]},{"kind":"action","name":"EnableBlueLightFilterSchedule","agent":"desktop","schema":"desktop.desktop-display","enabled":false,"transient":false,"description":"Enables or disables blue light filter schedule (Night Light)","parameters":[{"name":"schedule","type":"string","optional":false,"description":""},{"name":"nightLightScheduleDisabled","type":"boolean","optional":false,"description":""}],"phrasings":["off night light","on night light","blue light filter","night light"]},{"kind":"action","name":"EnableFilterKeysAction","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables Filter Keys","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["off filter keys","on filter keys","disable filter keys","enable filter keys"]},{"kind":"action","name":"EnableGameMode","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables Game Mode","parameters":[],"phrasings":["turn on game mode","open game mode","enable game mode"]},{"kind":"action","name":"EnableMagnifier","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables Magnifier","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["off magnifier","on magnifier","stop magnifier","start magnifier","disable magnifier","enable magnifier"]},{"kind":"action","name":"EnableMeteredConnections","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables metered connection settings","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":["off metered connection","on metered connection","disable metered connection","enable metered connection"]},{"kind":"action","name":"EnableNarratorAction","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables Narrator","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["off narrator","on narrator","stop narrator","start narrator","disable narrator","enable narrator"]},{"kind":"action","name":"EnableQuietHours","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables Focus Assist (Quiet Hours)","parameters":[{"name":"startHour","type":"number","optional":true,"description":""},{"name":"endHour","type":"number","optional":true,"description":""}],"phrasings":["do not disturb","open focus assist","turn on quiet hours","focus assist","quiet hours"]},{"kind":"action","name":"EnableStickyKeys","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables Sticky Keys","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":["off sticky keys","on sticky keys","disable sticky keys","enable sticky keys"]},{"kind":"action","name":"EnableTouchPad","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Enables or disables the touchpad","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":["off touchpad","on touchpad","disable touchpad","enable touchpad"]},{"kind":"action","name":"EnableTransparency","agent":"desktop","schema":"desktop.desktop-personalization","enabled":false,"transient":false,"description":"Enables or disables transparency effects","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":["off transparency","on transparency","disable transparency","enable transparency"]},{"kind":"action","name":"EnableWifi","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Enables or disables WiFi adapter","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":["disable wifi","enable wifi","wi-fi","wifi"]},{"kind":"action","name":"EnhancePointerPrecision","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Enables or disables enhanced pointer precision (mouse acceleration)","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["off mouse acceleration","on mouse acceleration","mouse acceleration","enhanced pointer precision"]},{"kind":"action","name":"HighContrastTheme","agent":"desktop","schema":"desktop.desktop-personalization","enabled":false,"transient":false,"description":"Opens the high contrast accessibility settings page. Only use when the user explicitly asks for high contrast settings.","parameters":[],"phrasings":["use high contrast","open high contrast","turn on high contrast","enable high contrast"]},{"kind":"action","name":"LaunchProgram","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Launches a new program window on a Windows Desktop Example: user: Launch edge agent: { \"actionName\": \"LaunchProgram\", \"parameters\": { \"name\": \"edge\" } }","parameters":[{"name":"name","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""}],"phrasings":["run {program}","start {program}","open {program}","launch {program}"]},{"kind":"action","name":"ListResolutions","agent":"desktop","schema":"desktop.desktop-display","enabled":false,"transient":false,"description":"Lists available display resolutions for the current monitor","parameters":[],"phrasings":["what resolutions","show resolutions","list resolutions"]},{"kind":"action","name":"ListThemes","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Lists all installed Windows themes","parameters":[],"phrasings":[]},{"kind":"action","name":"ListWifiNetworks","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Lists available WiFi networks","parameters":[],"phrasings":["what wifi networks","show wifi networks","list wifi networks"]},{"kind":"action","name":"ManageCameraAccess","agent":"desktop","schema":"desktop.desktop-privacy","enabled":false,"transient":false,"description":"Manages camera access for apps","parameters":[{"name":"accessSetting","type":"\"allow\" | \"deny\"","optional":true,"description":""}],"phrasings":["off camera","on camera","disable camera","enable camera","deny camera access","allow camera access"]},{"kind":"action","name":"ManageLocationAccess","agent":"desktop","schema":"desktop.desktop-privacy","enabled":false,"transient":false,"description":"Manages location access for apps","parameters":[{"name":"accessSetting","type":"\"allow\" | \"deny\"","optional":true,"description":""}],"phrasings":["off location","on location","disable location","enable location","deny location access","allow location access"]},{"kind":"action","name":"ManageMicrophoneAccess","agent":"desktop","schema":"desktop.desktop-privacy","enabled":false,"transient":false,"description":"Manages microphone access for apps","parameters":[{"name":"accessSetting","type":"\"allow\" | \"deny\"","optional":false,"description":""}],"phrasings":["off microphone","on microphone","disable microphone","enable microphone","deny microphone access","allow microphone access"]},{"kind":"action","name":"Maximize","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Maximizes a program window on a Windows Desktop","parameters":[{"name":"name","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""}],"phrasings":["make {program} full screen","maximize {program}"]},{"kind":"action","name":"Minimize","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Minimizes a program window on a Windows Desktop","parameters":[{"name":"name","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""}],"phrasings":["hide {program}","minimize {program}"]},{"kind":"action","name":"MinimizeWindowsOnMonitorDisconnectAction","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Minimizes windows when a monitor is disconnected","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["keep windows when monitor disconnects","when monitor disconnects","on disconnect"]},{"kind":"action","name":"MonoAudioToggle","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables mono audio","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["off mono audio","on mono audio","disable mono audio","enable mono audio"]},{"kind":"action","name":"MouseCursorSpeed","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Adjusts mouse cursor speed","parameters":[{"name":"speedLevel","type":"number","optional":false,"description":""},{"name":"reduceSpeed","type":"boolean","optional":true,"description":""}],"phrasings":["mouse speed {level}","change mouse sensitivity to {level}","adjust mouse speed to {level}","set mouse speed to {level}"]},{"kind":"action","name":"MousePointerCustomization","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Customizes mouse pointer color","parameters":[{"name":"color","type":"string","optional":false,"description":""},{"name":"style","type":"string","optional":true,"description":""}],"phrasings":["set mouse pointer color to {color}","change mouse pointer to {color}","customize mouse pointer to {color}"]},{"kind":"action","name":"MouseWheelScrollLines","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Sets the number of lines to scroll per mouse wheel notch","parameters":[{"name":"scrollLines","type":"number","optional":false,"description":""}],"phrasings":["scroll {lines} lines","set scroll lines to {lines}"]},{"kind":"action","name":"MoveWindowToDesktop","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[{"name":"name","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""},{"name":"desktopId","type":"number","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"Mute","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[{"name":"on","type":"boolean","optional":false,"description":""}],"phrasings":["unmute","mute"]},{"kind":"action","name":"NextDesktop","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"switches to the next Windows Desktop","parameters":[],"phrasings":["next desktop"]},{"kind":"action","name":"PinWindow","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[{"name":"name","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"PreviousDesktop","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"switches to the previous Windows Desktop","parameters":[],"phrasings":["previous desktop"]},{"kind":"action","name":"RememberWindowLocations","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Remembers window locations based on monitor configuration","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":["forget window locations","positions","locations"]},{"kind":"action","name":"RestartService","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Restarts a Windows service (stops it and starts it again). The target can be identified either by its service name / display name, or by a phrase found in the service's description. Example: User: restart the print spooler service Agent: { actionName: \"RestartService\", parameters: { service: \"Print Spooler\", matchBy: \"name\" } } Example: User: restart the service that manages windows updates Agent: { actionName: \"RestartService\", parameters: { service: \"windows update\", matchBy: \"description\" } }","parameters":[{"name":"service","type":"string","optional":false,"description":"The Windows service name or display name (e.g. \"Spooler\" or \"Print Spooler\") when matchBy is \"name\"; or a phrase to search for within service descriptions when matchBy is \"description\"."},{"name":"matchBy","type":"\"name\" | \"description\"","optional":true,"description":"How to locate the service. \"name\" (the default) matches the service name or display name; \"description\" searches each service's description text for the provided phrase."},{"name":"elevate","type":"boolean","optional":true,"description":"Internal use only: set to true by the agent after the user has agreed to run the restart with administrator privileges. Never set this from the user's initial request — leave it unset so the agent asks for consent first."}],"phrasings":[]},{"kind":"action","name":"RestoreVolume","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[],"phrasings":["restore volume"]},{"kind":"action","name":"RotationLock","agent":"desktop","schema":"desktop.desktop-display","enabled":false,"transient":false,"description":"Locks or unlocks screen rotation","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["disable rotation lock","enable rotation lock","unlock rotation","lock rotation"]},{"kind":"action","name":"SetPowerModeOnBattery","agent":"desktop","schema":"desktop.desktop-power","enabled":false,"transient":false,"description":"Sets power mode when on battery","parameters":[{"name":"mode","type":"string","optional":true,"description":""}],"phrasings":["power saver","best performance","set battery power mode to balanced","power efficiency","performance"]},{"kind":"action","name":"SetPowerModePluggedIn","agent":"desktop","schema":"desktop.desktop-power","enabled":false,"transient":false,"description":"Sets power mode when plugged in","parameters":[{"name":"powerMode","type":"\"bestPerformance\" | \"balanced\" | \"bestPowerEfficiency\"","optional":false,"description":""}],"phrasings":["use best performance","power saver mode","balanced mode","best performance mode","set power mode to balanced","power efficiency","performance"]},{"kind":"action","name":"SetPrimaryMouseButton","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Sets the primary mouse button","parameters":[{"name":"primaryButton","type":"\"left\" | \"right\"","optional":false,"description":""}],"phrasings":["right handed mouse","left handed mouse","swap mouse buttons","right","left"]},{"kind":"action","name":"SetScreenResolution","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Change screen resolution","parameters":[{"name":"width","type":"number","optional":false,"description":""},{"name":"height","type":"number","optional":false,"description":""},{"name":"refreshRate","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"SetTextSize","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Changes the text size that appears throughout Windows and your apps","parameters":[{"name":"size","type":"number","optional":false,"description":"small changes are 5% increments, large changes are 25% increments"}],"phrasings":[]},{"kind":"action","name":"SetThemeMode","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Sets the theme mode of the current [windows] desktop","parameters":[{"name":"mode","type":"\"light\" | \"dark\" | \"toggle\"","optional":false,"description":""}],"phrasings":["light","dark","light mode","dark mode","toggle mode"]},{"kind":"action","name":"SetWallpaper","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[{"name":"filePath","type":"string","optional":true,"description":""},{"name":"url","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"ShowBadgesOnTaskbar","agent":"desktop","schema":"desktop.desktop-taskbar","enabled":false,"transient":false,"description":"Shows or hides badges on taskbar icons","parameters":[{"name":"enableBadging","type":"boolean","optional":true,"description":""}],"phrasings":["disable taskbar badges","enable taskbar badges","hide taskbar badges","show taskbar badges"]},{"kind":"action","name":"ShowFileExtensions","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Shows or hides file extensions in File Explorer","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["display file extensions","hide file extensions","show file extensions"]},{"kind":"action","name":"ShowHiddenAndSystemFiles","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Shows or hides hidden and system files in File Explorer","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["display hidden files","hide hidden files","system files","hidden files"]},{"kind":"action","name":"SwitchDesktop","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[{"name":"desktopId","type":"number","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"SwitchTo","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Sets focus to a program window on a Windows Desktop. Example: User: switch to Chrome Agent: { actionName: \"SwitchTo\", parameters: { name: \"Chrome\" } }","parameters":[{"name":"name","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""}],"phrasings":["go to {program}","focus {program}","switch to {program}"]},{"kind":"action","name":"SystemThemeMode","agent":"desktop","schema":"desktop.desktop-personalization","enabled":false,"transient":false,"description":"Sets the system-wide theme mode to light or dark (affects apps, taskbar, and Start menu). Only for light/dark mode, not for named themes.","parameters":[{"name":"mode","type":"\"light\" | \"dark\"","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"TaskbarAlignment","agent":"desktop","schema":"desktop.desktop-taskbar","enabled":false,"transient":false,"description":"Sets taskbar alignment (left or center)","parameters":[{"name":"alignment","type":"\"left\" | \"center\"","optional":false,"description":""}],"phrasings":["left align taskbar","left","center","center taskbar"]},{"kind":"action","name":"TaskViewVisibility","agent":"desktop","schema":"desktop.desktop-taskbar","enabled":false,"transient":false,"description":"Shows or hides the Task View button","parameters":[{"name":"visibility","type":"boolean","optional":false,"description":""}],"phrasings":["disable task view","enable task view","hide task view","show task view"]},{"kind":"action","name":"Tile","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Positions program windows on a program window on a Windows Desktop","parameters":[{"name":"leftWindow","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""},{"name":"rightWindow","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"ToggleAirplaneMode","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":["off airplane mode","on airplane mode","disable airplane mode","enable airplane mode"]},{"kind":"action","name":"ToggleMouseSonar","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Enables or disables the \"Find my pointer\" sonar ring when pressing Ctrl","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"ToggleNotifications","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Shows/hides windows notification center","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":["toggle notifications","hide notifications","show notifications"]},{"kind":"action","name":"ToggleWidgetsButtonVisibility","agent":"desktop","schema":"desktop.desktop-taskbar","enabled":false,"transient":false,"description":"Shows or hides the Widgets button","parameters":[{"name":"visibility","type":"\"show\" | \"hide\"","optional":false,"description":""}],"phrasings":["disable widgets","enable widgets","hide widgets","show widgets"]},{"kind":"action","name":"TouchpadCursorSpeed","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Adjusts touchpad cursor speed","parameters":[{"name":"speed","type":"number","optional":true,"description":""}],"phrasings":["touchpad speed {speed}","adjust touchpad sensitivity","set touchpad speed to {speed}"]},{"kind":"action","name":"Volume","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[{"name":"targetVolume","type":"number","optional":false,"description":""}],"phrasings":["volume {level}","set volume to {level}"]}]},{"kind":"agent","name":"ipconfig","emoji":"🔎","description":"Windows IP configuration command-line tool that displays and manages network adapter settings","children":[{"kind":"action","name":"displayDHCPClassIDs","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Can you show me the DHCP class IDs for the adapter?\" Agent: \"Displaying the DHCP class IDs for the adapter.\" User: \"Please display the DHCP class IDs for the network adapter.\" Agent: \"Displaying the DHCP class IDs for the network adapter.\" User: \"I need to see the DHCP class IDs for my adapter.\" Agent: \"Displaying the DHCP class IDs for the adapter.\" Displays all the DHCP class IDs allowed for the adapter.","parameters":[],"phrasings":["what are the dhcp class ids for the specified adapter","i need to see the dhcp class ids for my adapter","please display the dhcp class ids for the network adapter","can you show me the dhcp class ids for the adapter"]},{"kind":"action","name":"displayDNSResolverCacheContents","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Show me the DNS cache contents.\" Agent: \"Displaying the contents of the DNS resolver cache.\" User: \"Can you display the DNS resolver cache?\" Agent: \"Displaying the contents of the DNS resolver cache.\" User: \"I'd like to see the DNS resolver cache details.\" Agent: \"Displaying the contents of the DNS resolver cache.\" Displays the contents of the DNS Resolver Cache.","parameters":[],"phrasings":["please provide the contents of the dns cache","i'd like to see the dns resolver cache details","can you display the dns resolver cache","show me the dns cache contents"]},{"kind":"action","name":"displayFullConfigurationInformation","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Show me the full network configuration details.\" Agent: \"Displaying full network configuration details.\" User: \"Can you display all the configuration information for my network?\" Agent: \"Displaying full network configuration details.\" User: \"I need to see the complete IP configuration.\" Agent: \"Displaying full network configuration details.\" Displays full configuration information.","parameters":[],"phrasings":["please provide the full configuration info for my network adapters","i need to see the complete ip configuration","what is my ip address","what's my ip address","can you display all the configuration information for my network","show me the full network configuration details"]},{"kind":"action","name":"displayHelpMessage","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Can you show me the help message for ipconfig?\" Agent: \"Displaying the help message for ipconfig.\" User: \"I need some help with ipconfig, please display the help message.\" Agent: \"Displaying the help message for ipconfig.\" User: \"What's the help message for ipconfig?\" Agent: \"Displaying the help message for ipconfig.\" Displays the help message for ipconfig.","parameters":[],"phrasings":["could you display the ipconfig help message","what's the help message for ipconfig","i need some help with ipconfig please display the help message","can you show me the help message for ipconfig"]},{"kind":"action","name":"displayIPv6DHCPClassIDs","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Can you show me the IPv6 DHCP class IDs for the adapter?\" Agent: \"Displaying the IPv6 DHCP class IDs for the adapter.\" User: \"Please display the IPv6 DHCP class IDs for the network adapter.\" Agent: \"Displaying the IPv6 DHCP class IDs for the network adapter.\" User: \"What are the IPv6 DHCP class IDs allowed for the adapter?\" Agent: \"Displaying the IPv6 DHCP class IDs for the adapter.\" Displays all the IPv6 DHCP class IDs allowed for the adapter.","parameters":[],"phrasings":["i'd like to see the ipv6 dhcp class ids for my adapter","what are the ipv6 dhcp class ids allowed for the adapter","please display the ipv6 dhcp class ids for the network adapter","can you show me the ipv6 dhcp class ids for the adapter"]},{"kind":"action","name":"modifyDHCPClassID","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Can you change the DHCP class ID for the Ethernet adapter to 'newClassID'?\" Agent: \"Modifying the DHCP class ID for the Ethernet adapter to 'newClassID'.\" User: \"Please update the DHCP class ID on the Wi-Fi adapter to 'newClassID'.\" Agent: \"Modifying the DHCP class ID for the Wi-Fi adapter to 'newClassID'.\" User: \"Set the DHCP class ID for the 'Local Area Connection' adapter to 'newClassID'.\" Agent: \"Modifying the DHCP class ID for the 'Local Area Connection' adapter to 'newClassID'.\" Modifies the DHCP class ID.","parameters":[{"name":"adapter","type":"string","optional":false,"description":"The name of the network adapter."},{"name":"classID","type":"string","optional":true,"description":"The new DHCP class ID."}],"phrasings":["i'd like to modify the dhcp class id for the {adapter} adapter use {classID}","set the dhcp class id for the {adapter} adapter to {classID}","please update the dhcp class id on the {adapter} adapter to {classID}","can you change the dhcp class id for the {adapter} adapter to {classID}"]},{"kind":"action","name":"modifyIPv6DHCPClassID","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Can you change the IPv6 DHCP class ID for the adapter named 'Ethernet' to 'newClassID'?\" Agent: \"Modifying the IPv6 DHCP class ID for the 'Ethernet' adapter to 'newClassID'.\" User: \"Please update the IPv6 DHCP class ID for my Wi-Fi adapter to 'classID123'.\" Agent: \"Modifying the IPv6 DHCP class ID for the Wi-Fi adapter to 'classID123'.\" User: \"Set the IPv6 DHCP class ID to 'classID456' for the network adapter 'Local Area Connection'.\" Agent: \"Modifying the IPv6 DHCP class ID for the 'Local Area Connection' adapter to 'classID456'.\" Modifies the IPv6 DHCP class ID.","parameters":[{"name":"adapter","type":"string","optional":false,"description":"The name of the network adapter."},{"name":"classID","type":"string","optional":true,"description":"The new IPv6 DHCP class ID."}],"phrasings":["i'd like to modify the ipv6 dhcp class id for {adapter} adapter to {classID}","set the ipv6 dhcp class id to {classID} for the network adapter {adapter}","please update the ipv6 dhcp class id for my {adapter} adapter to {classID}","can you change the ipv6 dhcp class id for the adapter named {adapter} to {classID}"]},{"kind":"action","name":"purgeDNSResolverCache","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Clear the DNS cache, please.\" Agent: \"Purging the DNS resolver cache.\" User: \"Can you purge the DNS resolver cache?\" Agent: \"Purging the DNS resolver cache.\" User: \"I need to flush the DNS cache.\" Agent: \"Purging the DNS resolver cache.\" Purges the DNS Resolver cache.","parameters":[],"phrasings":["please empty the dns resolver cache","i need to flush the dns cache","can you purge the dns resolver cache","clear the dns cache please"]},{"kind":"action","name":"refreshDHCPLeasesAndReRegisterDNSNames","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Can you refresh the DHCP leases and re-register the DNS names for me?\" Agent: \"Refreshing all DHCP leases and re-registering DNS names.\" User: \"Please update the DHCP leases and DNS registrations.\" Agent: \"Refreshing all DHCP leases and re-registering DNS names.\" User: \"I need to refresh all DHCP leases and re-register the DNS names.\" Agent: \"Refreshing all DHCP leases and re-registering DNS names.\" Refreshes all DHCP leases and re-registers DNS names.","parameters":[],"phrasings":["could you refresh the dhcp leases and re register the dns names","i need to refresh all dhcp leases and re register the dns names","please update the dhcp leases and dns registrations","can you refresh the dhcp leases and re register the dns names for me"]},{"kind":"action","name":"releaseIPv4Address","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Please release the IPv4 address for the Ethernet adapter.\" Agent: \"Releasing the IPv4 address for the Ethernet adapter.\" User: \"Can you release the IPv4 address on my Wi-Fi adapter?\" Agent: \"Releasing the IPv4 address for the Wi-Fi adapter.\" User: \"Release the IPv4 address for the network adapter named 'Local Area Connection'.\" Agent: \"Releasing the IPv4 address for the 'Local Area Connection' adapter.\" Releases the IPv4 address for the specified adapter.","parameters":[{"name":"adapter","type":"string","optional":true,"description":"The name of the network adapter."}],"phrasings":["i need to release the ipv4 address for the adapter called {adapter}","release the ipv4 address for the network adapter named {adapter}","can you release the ipv4 address on my {adapter} adapter","please release the ipv4 address for the {adapter} adapter"]},{"kind":"action","name":"releaseIPv6Address","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Please release the IPv6 address for the adapter named 'Ethernet'.\" Agent: \"Releasing the IPv6 address for the 'Ethernet' adapter.\" User: \"Can you release the IPv6 address on my Wi-Fi adapter?\" Agent: \"Releasing the IPv6 address for the Wi-Fi adapter.\" User: \"I need to release the IPv6 address for the 'Local Area Connection' adapter.\" Agent: \"Releasing the IPv6 address for the 'Local Area Connection' adapter.\" Releases the IPv6 address for the specified adapter.","parameters":[{"name":"adapter","type":"string","optional":true,"description":"The name of the network adapter."}],"phrasings":["release the ipv6 address for the {adapter} please","i need to release the ipv6 address for the {adapter} adapter","can you release the ipv6 address on my {adapter} adapter","please release the ipv6 address for the adapter named {adapter}"]},{"kind":"action","name":"renewIPv4Address","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Can you renew the IPv4 address for the Ethernet adapter?\" Agent: \"Renewing the IPv4 address for the Ethernet adapter.\" User: \"Please refresh the IPv4 address for my Wi-Fi adapter.\" Agent: \"Renewing the IPv4 address for the Wi-Fi adapter.\" User: \"Renew the IPv4 address for the network adapter named 'Local Area Connection'.\" Agent: \"Renewing the IPv4 address for the 'Local Area Connection' adapter.\" Renews the IPv4 address for the specified adapter.","parameters":[{"name":"adapter","type":"string","optional":true,"description":"The name of the network adapter."}],"phrasings":["i need to renew the ipv4 address for the {adapter}","renew the ipv4 address for the network adapter named {adapter}","please refresh the ipv4 address for my {adapter} adapter","can you renew the ipv4 address for the {adapter} adapter"]},{"kind":"action","name":"renewIPv6Address","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Can you renew the IPv6 address for the adapter named 'Ethernet'?\" Agent: \"Renewing the IPv6 address for the 'Ethernet' adapter.\" User: \"Please refresh the IPv6 address for my Wi-Fi adapter.\" Agent: \"Renewing the IPv6 address for the Wi-Fi adapter.\" User: \"Renew the IPv6 address for the 'Local Area Connection' adapter.\" Agent: \"Renewing the IPv6 address for the 'Local Area Connection' adapter.\" Renews the IPv6 address for the specified adapter.","parameters":[{"name":"adapter","type":"string","optional":true,"description":"The name of the network adapter."}],"phrasings":["i need to update the ipv6 address for the {adapter}","renew the ipv6 address for the {adapter} adapter","please refresh the ipv6 address for my {adapter} adapter","can you renew the ipv6 address for the adapter named {adapter}"]}]},{"kind":"agent","name":"osNotifications","emoji":"🔔","description":"Forwards OS-level notifications (Windows Action Center, Linux freedesktop) into chat. Off by default; opt in via @config agent enable osNotifications.","children":[{"kind":"action","name":"syncOsNotifications","agent":"osNotifications","schema":"osNotifications","enabled":false,"transient":false,"description":"Re-emit currently-present OS notifications through the agent pipeline. Triggers the build prompt (yes/no card) when the helper exe is missing. Windows only; surfaces a warning on Linux/macOS.","parameters":[],"phrasings":["'sync' 'notification' 's'?"]},{"kind":"action","name":"testOsNotification","agent":"osNotifications","schema":"osNotifications","enabled":false,"transient":false,"description":"Inject a synthetic notification through the agent pipeline (filters, rate limit, dismiss tracking) — useful for verifying the agent end-to-end without an OS notification source.","parameters":[{"name":"message","type":"string","optional":false,"description":"Notification body text."},{"name":"app","type":"string","optional":true,"description":"Optional app name to attach (matched against allowList/blockList)."},{"name":"title","type":"string","optional":true,"description":"Optional notification title."}],"phrasings":[]}]},{"kind":"agent","name":"settings","emoji":"⚙️","description":"Agent to manipulate system settings","children":[{"kind":"action","name":"adjustMultiMonitorLayoutAction","agent":"settings","schema":"settings","enabled":true,"transient":false,"description":"An action to adjust multi-monitor layout","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"}],"phrasings":[]},{"kind":"action","name":"dimBrightNessAction","agent":"settings","schema":"settings","enabled":true,"transient":false,"description":"An action to dim or brighten the screen","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"}],"phrasings":[]}]},{"kind":"agent","name":"windowsClock","emoji":"⏰","description":"Windows Clock agent — set alarms, start timers, run the stopwatch, and add world clocks via the built-in Windows Alarms & Clock app.","children":[{"kind":"action","name":"addWorldClock","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Add a new world clock by searching for a city and selecting it from suggestions.","parameters":[{"name":"cityQuery","type":"string","optional":false,"description":"Text to search for a matching city in the Add Clock box."},{"name":"suggestionItem","type":"string","optional":false,"description":"The specific suggestion to select from the list (city, country)."}],"phrasings":[]},{"kind":"action","name":"createAlarm","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Create a new alarm with a specified name and time.","parameters":[{"name":"alarmName","type":"string","optional":false,"description":"Displayed name of the alarm."},{"name":"hour","type":"number","optional":false,"description":"Hour component of the alarm time."},{"name":"minute","type":"number","optional":false,"description":"Minute component of the alarm time."}],"phrasings":[]},{"kind":"action","name":"navigateToAlarmTab","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Switch to the Alarms tab in the app.","parameters":[],"phrasings":[]},{"kind":"action","name":"navigateToFocusTab","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Switch to the Focus tab from the app's navigation.","parameters":[],"phrasings":[]},{"kind":"action","name":"navigateToStopwatchTab","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Switch to the Stopwatch tab.","parameters":[],"phrasings":[]},{"kind":"action","name":"navigateToTimerTab","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Switch to the Timer tab from another section.","parameters":[],"phrasings":[]},{"kind":"action","name":"navigateToWorldClockTab","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Switch to the World Clock tab from another tab.","parameters":[],"phrasings":[]},{"kind":"action","name":"recordLap","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Record a lap while the stopwatch continues running.","parameters":[],"phrasings":[]},{"kind":"action","name":"renameTimer","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Rename an existing timer and save the changes.","parameters":[{"name":"name","type":"string","optional":false,"description":"The new name to assign to the timer."}],"phrasings":[]},{"kind":"action","name":"setAlarmEnabled","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Turn on an existing alarm.  [merged from: enableAlarm, disableAlarm]","parameters":[{"name":"enabled","type":"boolean","optional":false,"description":"Distinguishes enableAlarm / disableAlarm variants."}],"phrasings":[]},{"kind":"action","name":"setFocusSessionRunning","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Start the focus session when it is paused.  [merged from: startFocusSession, pauseFocusSession]","parameters":[{"name":"running","type":"boolean","optional":false,"description":"Distinguishes startFocusSession / pauseFocusSession variants."}],"phrasings":[]},{"kind":"action","name":"setStopwatchRunning","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Pause the running stopwatch.  [merged from: pauseStopwatch, resumeStopwatch]","parameters":[{"name":"running","type":"boolean","optional":false,"description":"Distinguishes pauseStopwatch / resumeStopwatch variants."}],"phrasings":[]},{"kind":"action","name":"setTimerViewMode","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Expand the timer into its alternate/compact view.  [merged from: expandTimerView, restoreTimerView]","parameters":[{"name":"mode","type":"\"compact\" | \"full\"","optional":false,"description":"Distinguishes expandTimerView / restoreTimerView variants."}],"phrasings":[]},{"kind":"action","name":"startTimer","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Start or resume the timer from list or paused states.","parameters":[],"phrasings":[]}]}]},{"kind":"category","name":"Core","emoji":"🧠","children":[{"kind":"agent","name":"dispatcher","emoji":"🤖","description":"","children":[{"kind":"action","name":"clarifyMissingParameter","agent":"dispatcher","schema":"dispatcher.clarify","enabled":true,"transient":false,"description":"The user request is for an action, but some of the parameter is not specified or cannot be infer from the context. Ask the user for clarification for the missing parameter of an known action. Don't clarify unknown action.","parameters":[{"name":"request","type":"string","optional":false,"description":"the current understood user request that needs to be clarified"},{"name":"actionName","type":"string","optional":false,"description":"A known actionName to be clarify.  Don't clarify \"unknown\" action."},{"name":"parameterName","type":"string","optional":false,"description":""},{"name":"clarifyingQuestion","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"clarifyMultipleAgentMatches","agent":"dispatcher","schema":"dispatcher.clarify","enabled":true,"transient":false,"description":"The user request was matched by more than one agent's schema/grammar simultaneously (a cross-agent action collision). List the candidate (schemaName, actionName) pairs so the user can disambiguate. This differs from ClarifyMultiplePossibleActionName, which only lists action names within a single schema.","parameters":[{"name":"request","type":"string","optional":false,"description":"the current understood user request that needs to be clarified"},{"name":"candidates","type":"{ … }[]","optional":false,"description":""},{"name":"clarifyingQuestion","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"clarifyMultiplePossibleActionName","agent":"dispatcher","schema":"dispatcher.clarify","enabled":true,"transient":false,"description":"Ask the user for clarification for ambiguous request that have multiple possible known action as interpretation. Don't clarify \"unknown\" action.","parameters":[{"name":"request","type":"string","optional":false,"description":"the current understood user request that needs to be clarified"},{"name":"possibleActionNames","type":"string[]","optional":false,"description":"Known actionNames to be clarify.  Don't clarify \"unknown\" action."},{"name":"clarifyingQuestion","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"clarifyUnresolvedReference","agent":"dispatcher","schema":"dispatcher.clarify","enabled":true,"transient":false,"description":"The user request is for an action, but parameters are referring to unresolved pronouns or references that is not found in the request or recent chat context.","parameters":[{"name":"request","type":"string","optional":false,"description":"the current understood user request that needs to be clarified"},{"name":"actionName","type":"string","optional":false,"description":""},{"name":"parameterName","type":"string","optional":false,"description":""},{"name":"reference","type":"string","optional":false,"description":""},{"name":"clarifyingQuestion","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"exitActivity","agent":"dispatcher","schema":"dispatcher.activity","enabled":true,"transient":true,"description":"Exit the current activity.","parameters":[],"phrasings":[]},{"kind":"action","name":"lookupAndAnswerConversation","agent":"dispatcher","schema":"dispatcher.lookup","enabled":true,"transient":false,"description":"The user request is a question about previous conversations. (e.g. \"what did we say about the project last week?\") The user expects only the answer, and not an action to be taken.","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request from the user"},{"name":"question","type":"string","optional":false,"description":"The question to get answer for."},{"name":"conversationLookupFilters","type":"{ … }[]","optional":false,"description":"look up for private information from past conversations (i.e. chat history) including private events, plans, projects in progress, attachments, files, file names, and other items from discussions with team members or the assistant, use the conversation lookup filters"}],"phrasings":[]},{"kind":"action","name":"reasoningAction","agent":"dispatcher","schema":"dispatcher.reasoning","enabled":true,"transient":false,"description":"If the user requests requires multiple action or steps, use the reasoning action.","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"The original user request"},{"name":"attemptedAction","type":"string","optional":true,"description":"JSON-serialized action object — agents populate this when redirecting a translated action so the reasoning loop knows what was intended."},{"name":"contextEntities","type":"string","optional":true,"description":"JSON-serialized entities on the stack at the time of redirect."}],"phrasings":[]},{"kind":"action","name":"startLookup","agent":"dispatcher","schema":"dispatcher.lookup","enabled":true,"transient":false,"description":"The user want to start looking information for a specific source without specifying what to look for. Don't use this action if the request includes what to look for.","parameters":[{"name":"lookup","type":"{ … }","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"unknown","agent":"dispatcher","schema":"dispatcher","enabled":true,"transient":false,"description":"Use UnknownAction when all the available actions in the schema is not relevant to the user request","parameters":[{"name":"request","type":"string","optional":false,"description":"user request that couldn't be matched to any action or schema group to look up from."},{"name":"reason","type":"string","optional":false,"description":"Why none of the available actions fit this request. Name the action(s) that came closest and say what was missing. Be specific: this is used to find gaps in the action schemas."}],"phrasings":[]}]},{"kind":"agent","name":"system","emoji":"🔧","description":"","children":[{"kind":"action","name":"clearHistory","agent":"system","schema":"system.history","enabled":true,"transient":false,"description":"Clears the chat history","parameters":[],"phrasings":[]},{"kind":"action","name":"clearNotifications","agent":"system","schema":"system.notify","enabled":true,"transient":false,"description":"Clears the notifications","parameters":[],"phrasings":[]},{"kind":"action","name":"clearRules","agent":"system","schema":"system.grammar","enabled":true,"transient":false,"description":"","parameters":[{"name":"agentName","type":"string","optional":true,"description":"Agent/schema name to clear rules for (e.g. \"player\", \"calendar\", \"email\"). Omit to clear ALL rules across all agents."}],"phrasings":[]},{"kind":"action","name":"deleteConversation","agent":"system","schema":"system.conversation","enabled":true,"transient":false,"description":"Delete a conversation by name. Use this when the user wants to remove, delete, or destroy a conversation. Examples: \"delete conversation test\", \"remove the work conversation\", \"delete test2\".","parameters":[{"name":"name","type":"string","optional":false,"description":"The name of the conversation to delete"}],"phrasings":["{polite} delete conversation {name}","{polite} delete {name} conversation"]},{"kind":"action","name":"deleteHistory","agent":"system","schema":"system.history","enabled":true,"transient":false,"description":"Deletes a specific message from the chat history","parameters":[{"name":"messageNumber","type":"number","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"deleteRule","agent":"system","schema":"system.grammar","enabled":true,"transient":false,"description":"","parameters":[{"name":"id","type":"number","optional":false,"description":"Numeric ID of the rule to delete, as shown in listRules output"}],"phrasings":[]},{"kind":"action","name":"describeAction","agent":"system","schema":"system.describe","enabled":true,"transient":false,"description":"Explain a single action in detail, beyond its one-line schema description. Examples: \"what does the play action do\", \"describe spotify's play action\", \"describe the play action from spotify\".","parameters":[{"name":"actionName","type":"string","optional":false,"description":"the action to describe"},{"name":"agentName","type":"string","optional":true,"description":"optional owning agent, when the user names one"}],"phrasings":[]},{"kind":"action","name":"describeAgent","agent":"system","schema":"system.describe","enabled":true,"transient":false,"description":"Describe what an agent can do: a natural-language summary plus its actions. Works for installed-but-disabled agents too — describing is informational and does not require the agent to be enabled. Examples: \"what can the spotify agent do\", \"describe spotify\", \"show me all of spotify's actions\", \"list everything calendar can do\".","parameters":[{"name":"agentName","type":"string","optional":false,"description":"the agent to describe"},{"name":"all","type":"boolean","optional":true,"description":"true when the user asks for ALL actions, not the default set"}],"phrasings":[]},{"kind":"action","name":"enterAgentPriorityMode","agent":"system","schema":"system.config","enabled":true,"transient":false,"description":"Puts a specific agent into priority mode","parameters":[{"name":"agentName","type":"string","optional":false,"description":"the agent name or wildcard match string (* to match all agents)"}],"phrasings":[]},{"kind":"action","name":"exitAgentPriorityMode","agent":"system","schema":"system.config","enabled":true,"transient":false,"description":"Leaves agent priority mode","parameters":[],"phrasings":[]},{"kind":"action","name":"listAgents","agent":"system","schema":"system.config","enabled":true,"transient":false,"description":"Shows the list of available agents","parameters":[],"phrasings":[]},{"kind":"action","name":"listConversation","agent":"system","schema":"system.conversation","enabled":true,"transient":false,"description":"List all conversations in this TypeAgent shell session. Use this when the user wants to see, show, or list their TypeAgent conversations (NOT files, songs, or any other kind of list). Examples: \"list our conversations\", \"list my conversations\", \"show all conversations\", \"what conversations do I have\", \"show me my conversations\", \"show conversation list\".","parameters":[],"phrasings":["{polite} list conversations","{polite} what conversations have"]},{"kind":"action","name":"listHistory","agent":"system","schema":"system.history","enabled":true,"transient":false,"description":"Shows the chat history","parameters":[],"phrasings":[]},{"kind":"action","name":"listRules","agent":"system","schema":"system.grammar","enabled":true,"transient":false,"description":"","parameters":[{"name":"agentName","type":"string","optional":true,"description":"Agent/schema name to filter by (e.g. \"player\", \"calendar\", \"email\", \"browser\"). Omit to list all rules across all agents. Use the short agent name, not the npm package name (e.g. \"player\" not \"music\")."}],"phrasings":[]},{"kind":"action","name":"newConversation","agent":"system","schema":"system.conversation","enabled":true,"transient":false,"description":"Create a new conversation and optionally give it a name. Use this when the user wants to create, start, make, or open a brand-new conversation. Examples: \"create a new conversation\", \"start a new conversation called test\", \"make a new conversation\", \"new conversation named work\", \"open a new conversation test\". IMPORTANT: use this only when the user is creating something new, not switching to an existing one.","parameters":[{"name":"name","type":"string","optional":true,"description":"Optional name for the new conversation"}],"phrasings":["{polite} create new conversation called {name}","{polite} create new conversation","{polite} new conversation"]},{"kind":"action","name":"nextConversation","agent":"system","schema":"system.conversation","enabled":true,"transient":false,"description":"Switch to the NEXT TypeAgent conversation in the list (cycles around). Use this when the user wants to advance to the next TypeAgent shell conversation (NOT the next song, next track, next page, or any other kind of \"next\"). Examples: \"switch to next conversation\", \"next conversation\", \"go to the next conversation\", \"cycle to the next conversation\".","parameters":[],"phrasings":["{polite} next conversation","{polite} advance to next conversation"]},{"kind":"action","name":"prevConversation","agent":"system","schema":"system.conversation","enabled":true,"transient":false,"description":"Switch to the PREVIOUS TypeAgent conversation in the list (cycles around). Use this when the user wants to go to the previous TypeAgent shell conversation (NOT the previous song, previous track, or any other kind of \"previous\"). Examples: \"switch to previous conversation\", \"previous conversation\", \"go to the previous conversation\", \"cycle to the previous conversation\".","parameters":[],"phrasings":["{polite} previous conversation","{polite} back to previous conversation"]},{"kind":"action","name":"renameConversation","agent":"system","schema":"system.conversation","enabled":true,"transient":false,"description":"Rename a conversation. Use this when the user wants to rename, relabel, or give a new name to a conversation. If the user specifies which conversation to rename, capture it as 'name'. If the user only says \"rename this conversation\" or \"rename current conversation\", omit 'name'. Examples: \"rename this conversation to work\", \"rename test7 to test5\", \"call this conversation research\", \"rename current conversation to my project\".","parameters":[{"name":"name","type":"string","optional":true,"description":"Optional: the current name of the conversation to rename. Omit to rename the active conversation."},{"name":"newName","type":"string","optional":false,"description":"The new name for the conversation"}],"phrasings":["{polite} rename this conversation to {newName}","{polite} call this conversation {newName}","{polite} rename conversation {name} to {newName}"]},{"kind":"action","name":"setAutoComplete","agent":"system","schema":"system.settings","enabled":true,"transient":false,"description":"Enable or disable inline autocomplete suggestions in the CLI input. Use when the user says things like \"turn off autocomplete\", \"disable tab completion\", \"stop showing completions\", \"enable autocomplete\", \"turn on inline suggestions\".","parameters":[{"name":"enable","type":"boolean","optional":false,"description":"true = show inline completions as the user types; false = disable autocomplete"}],"phrasings":[]},{"kind":"action","name":"setConversationResume","agent":"system","schema":"system.settings","enabled":true,"transient":false,"description":"Set whether to resume the last conversation on startup. Use when the user says things like \"always resume my last conversation\", \"pick up where I left off\", \"don't resume my last conversation\", \"start fresh each time\".","parameters":[{"name":"enable","type":"boolean","optional":false,"description":"true = resume the last conversation on startup; false = always start with the default conversation"}],"phrasings":[]},{"kind":"action","name":"setIdleTimeout","agent":"system","schema":"system.settings","enabled":true,"transient":false,"description":"Set the idle timeout for the agent server in seconds (0 = disabled). Use when the user says things like \"shut down the server after 5 minutes of inactivity\", \"set idle timeout to 300 seconds\", \"disable idle timeout\", \"never shut down automatically\".","parameters":[{"name":"seconds","type":"number","optional":false,"description":"Timeout in seconds. 0 means the server never shuts down automatically due to inactivity."}],"phrasings":[]},{"kind":"action","name":"setServerHidden","agent":"system","schema":"system.settings","enabled":true,"transient":false,"description":"Set whether the agent server starts as a hidden background process. Use when the user says things like \"start the server hidden\", \"run the server in the background\", \"don't show a server window\", \"show the server window on startup\".","parameters":[{"name":"enable","type":"boolean","optional":false,"description":"true = server starts as hidden background process; false = server starts with a visible window"}],"phrasings":[]},{"kind":"action","name":"showConversationInfo","agent":"system","schema":"system.conversation","enabled":true,"transient":false,"description":"Show information about the current conversation. Use this when the user asks about the current conversation info. Examples: \"show conversation info\", \"what conversation am I in\", \"current conversation info\".","parameters":[],"phrasings":["{polite} show conversation info","{polite} what conversation am i in","{polite} current conversation info"]},{"kind":"action","name":"showNotifications","agent":"system","schema":"system.notify","enabled":true,"transient":false,"description":"Shows notifications based on the supplied filter","parameters":[{"name":"filter","type":"\"all\" | \"unread\"","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"showNotificationSummary","agent":"system","schema":"system.notify","enabled":true,"transient":false,"description":"Shows notification summary","parameters":[],"phrasings":[]},{"kind":"action","name":"showRule","agent":"system","schema":"system.grammar","enabled":true,"transient":false,"description":"","parameters":[{"name":"id","type":"number","optional":false,"description":"Numeric ID of the rule to inspect, as shown in listRules output"}],"phrasings":[]},{"kind":"action","name":"switchConversation","agent":"system","schema":"system.conversation","enabled":true,"transient":false,"description":"Switch to an existing conversation by name. Use this when the user wants to switch to, go to, open, or change to an EXISTING conversation identified by name.  For \"next\"/\"previous\" without a specific name, use NextConversationAction or PrevConversationAction instead. Examples: \"switch to conversation test\", \"go to my work conversation\", \"switch to test\", \"open conversation named work\", \"change to the test conversation\". IMPORTANT: use this only when switching to an already-existing conversation, not creating a new one.","parameters":[{"name":"name","type":"string","optional":false,"description":"The name of the conversation to switch to"}],"phrasings":["{polite} switch to conversation {name}","{polite} switch conversation to {name}","{polite} switch to {name} conversation","{polite} open conversation {name}"]},{"kind":"action","name":"toggleAgent","agent":"system","schema":"system.config","enabled":true,"transient":false,"description":"Toggle use of LLM, agent or AI.","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""},{"name":"agentNames","type":"string[]","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"toggleDeveloperMode","agent":"system","schema":"system.config","enabled":true,"transient":false,"description":"Toggle developer mode.","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"toggleExplanation","agent":"system","schema":"system.config","enabled":true,"transient":false,"description":"Toggle explanation.","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":[]}]}]}]},"commands":{"kind":"root","name":"System commands","children":[{"kind":"group","name":"action","children":[{"kind":"command","name":"action","description":"Execute an action","group":false,"args":[{"name":"schemaName","optional":false,"description":"Action schema name"},{"name":"actionName","optional":false,"description":"Action name"}],"flags":[{"name":"parameters","char":"","default":"","description":"Action parameter"},{"name":"naturalLanguage","char":"","default":"","description":"Natural language phrase to associate with this action for cache population"}]}]},{"kind":"group","name":"clear","children":[{"kind":"command","name":"clear","description":"Clear the console","group":true,"args":[],"flags":[]},{"kind":"command","name":"clear deep","description":"Clear the console and wipe chat history, reasoning, activity, and persistent display log so nothing replays on rejoin","group":false,"args":[],"flags":[]}]},{"kind":"group","name":"collision","children":[{"kind":"command","name":"collision","description":"Inspect collision detection telemetry and run static collision analyses","group":true,"args":[],"flags":[]},{"kind":"command","name":"collision corpus","description":"Generate phrase corpora, probe through the embedding ranker, and build the collision-hotspot visualizations","group":true,"args":[],"flags":[]},{"kind":"command","name":"collision corpus generate","description":"Generate an LLM-authored phrase corpus for every action in this dispatcher's loaded schemas (slow: ~12 min for the full set)","group":false,"args":[],"flags":[{"name":"schemas","char":"","default":"","description":"Comma-separated schemas to scan. Empty = all loaded schemas."},{"name":"models","char":"","default":"","description":"Comma-separated chat-model names from ts/.env. Default: GPT_4_1,GPT_5,GPT_5_NANO"},{"name":"styles","char":"","default":"","description":"Comma-separated phrase styles to generate. Available: imperative,conversational,casual,polite,curt,slang,typos. Default: imperative,conversational,casual."},{"name":"concurrency","char":"","default":"8","description":"Concurrent LLM calls (default 8)"},{"name":"out","char":"","default":"","description":"Output corpus JSON file path (file name, not directory — use --workdir to choose the directory). Default: \u003cinstanceDir>/collisions/corpus.json"},{"name":"workdir","char":"","default":"","description":"Directory for default-named output files. Default: \u003cinstanceDir>/collisions"}]},{"kind":"command","name":"collision corpus probe","description":"Replay a phrase corpus through the embedding ranker and classify each phrase as CLEAN / TIGHT / MISROUTE","group":false,"args":[],"flags":[{"name":"in","char":"","default":"","description":"Input corpus JSON path. Default: \u003cworkdir>/corpus.json"},{"name":"out","char":"","default":"","description":"Output probe-results JSON path. Default: \u003cworkdir>/probe-results.json"},{"name":"top","char":"","default":"5","description":"Candidate rows kept per probe (default 5)"},{"name":"delta","char":"","default":"0.05","description":"Tight-vs-clean threshold (default 0.05)"},{"name":"concurrency","char":"","default":"8","description":"Concurrent probes (default 8)"},{"name":"workdir","char":"","default":"","description":"Directory for default-named files. Default: \u003cinstanceDir>/collisions"}]},{"kind":"command","name":"collision corpus reanalyze","description":"Re-classify saved probe results with prefix-aware action matching (recovers misroutes that were just naming differences)","group":false,"args":[],"flags":[{"name":"in","char":"","default":"","description":"Input probe-results JSON. Default: \u003cworkdir>/probe-results.json"},{"name":"out","char":"","default":"","description":"Output reclassified JSON. Default: \u003cworkdir>/probe-results-reclassified.json"},{"name":"delta","char":"","default":"0.05","description":"Tight-vs-clean threshold (default 0.05)"},{"name":"workdir","char":"","default":"","description":"Directory for default-named files. Default: \u003cinstanceDir>/collisions"}]},{"kind":"command","name":"collision corpus recovery","description":"Decompose MISROUTE results by where the correct target ranks among the top-K candidates (which fix lever applies?)","group":false,"args":[],"flags":[{"name":"in","char":"","default":"","description":"Input reclassified probe-results JSON. Default: \u003cworkdir>/probe-results-reclassified.json"},{"name":"workdir","char":"","default":"","description":"Directory for default-named files. Default: \u003cinstanceDir>/collisions"},{"name":"delta","char":"","default":"0.05","description":"llmSelect threshold for the rank-2 tight/wide split (default 0.05)"}]},{"kind":"command","name":"collision corpus run","description":"Run the full corpus pipeline (generate → probe → reanalyze → visualize) with consistent file naming","group":false,"args":[],"flags":[{"name":"from","char":"","default":"generate","description":"Resume from a step: generate | probe | reanalyze | visualize (default generate)"},{"name":"workdir","char":"","default":"","description":"Directory for intermediate files. Default: \u003cinstanceDir>/collisions"},{"name":"schemas","char":"","default":"","description":"Comma-separated schemas (corpus only)"},{"name":"models","char":"","default":"","description":"Comma-separated model names (corpus only)"},{"name":"styles","char":"","default":"","description":"Comma-separated phrase styles (corpus only). Available: imperative,conversational,casual,polite,curt,slang,typos. Default: imperative,conversational,casual."},{"name":"concurrency","char":"","default":"8","description":"LLM concurrency (corpus only, default 8)"},{"name":"delta","char":"","default":"0.05","description":"Tight-vs-clean threshold (probe + reanalyze, default 0.05)"},{"name":"top","char":"","default":"5","description":"Probe candidate rows (default 5)"},{"name":"sankey-top","char":"","default":"60","description":"Sankey edge count (default 60)"}]},{"kind":"command","name":"collision corpus translate","description":"Replay a phrase corpus through the LLM translator (cache/grammar/exec/fuzzy off) and classify each phrase as CLEAN / MISROUTE / CLARIFY / INVALID / ERROR. Distinct from 'corpus probe' — that one runs the embedding ranker; this runs the actual translator.","group":false,"args":[],"flags":[{"name":"in","char":"","default":"","description":"Input corpus JSON path. Default: \u003cworkdir>/corpus.json"},{"name":"out","char":"","default":"","description":"Output translation-results JSON file path (file name, not directory — use --workdir to choose the directory). Default: \u003cworkdir>/translation-results.json (or translation-results-\u003csuffix>.json when --output-suffix is set)."},{"name":"concurrency","char":"","default":"4","description":"Concurrent translator calls (default 4 — chat completions are expensive)"},{"name":"strategy","char":"","default":"first-match","description":"llmSelect strategy to force during the run. Default 'first-match' (suppresses user-clarify short-circuit). Reserved: future runs will sweep multiple strategies in one go."},{"name":"max-phrases","char":"","default":"","description":"Cap the run to N phrases (deterministic prefix). Useful for smoke tests."},{"name":"model-label","char":"","default":"","description":"Label recorded in each row's `model` field. Reserved for future multi-model sweeps; defaults to 'default'."},{"name":"user-context-mode","char":"","default":"none","description":"How userContext is attached per phrase: 'none' (baseline, no injection), 'expected-schema' (derive from each phrase's expected schema via manifest), 'fixed' (use --user-context-json for every phrase)."},{"name":"user-context-json","char":"","default":"","description":"JSON object parsed as UserContext when --user-context-mode=fixed. E.g. '{\"activeApp\":\"spotify\",\"activeAppDescription\":\"Spotify music agent\"}'."},{"name":"output-suffix","char":"","default":"","description":"When set and --out is not given, write to \u003cworkdir>/translation-results-\u003csuffix>.json so baseline and context runs coexist in one workdir."},{"name":"workdir","char":"","default":"","description":"Directory for default-named files. Default: \u003cinstanceDir>/collisions"}]},{"kind":"command","name":"collision corpus visualize","description":"Build an interactive HTML visualization of misroute hotspots from reclassified probe results, overlaid with a cross-schema similarity scan","group":false,"args":[],"flags":[{"name":"in","char":"","default":"","description":"Input reclassified probe-results JSON. Default: \u003cworkdir>/probe-results-reclassified.json"},{"name":"out","char":"","default":"","description":"Output HTML path. Default: \u003cworkdir>/collisions-viz.html"},{"name":"top","char":"","default":"60","description":"Sankey edge count (default 60)"},{"name":"similarity-strategy","char":"","default":"","description":"Similarity strategy for the overlay (default balanced)"},{"name":"similarity-threshold","char":"","default":"","description":"Similarity threshold for the overlay, decimal in [0,1] (default 0.85)"},{"name":"no-similarity","char":"","default":"false","description":"Skip the similarity overlay; produce a corpus-only viz"},{"name":"translator","char":"","default":"","description":"Translator-probe results JSON to overlay (enables the 'translator-confirmed' source filter). Default: \u003cworkdir>/translation-results.json when present. Use --no-translator to skip."},{"name":"no-translator","char":"","default":"false","description":"Skip the translator overlay even if translation-results.json is present"},{"name":"workdir","char":"","default":"","description":"Directory for default-named files. Default: \u003cinstanceDir>/collisions"}]},{"kind":"command","name":"collision corpus visualize-recovery","description":"Build an interactive HTML visualization of recovery-rank analysis (which fix lever applies, per action and per agent)","group":false,"args":[],"flags":[{"name":"in","char":"","default":"","description":"Input reclassified probe-results JSON. Default: \u003cworkdir>/probe-results-reclassified.json"},{"name":"out","char":"","default":"","description":"Output HTML path. Default: \u003cworkdir>/recovery-viz.html"},{"name":"delta","char":"","default":"0.05","description":"llmSelect threshold for the rank-2 tight/wide split (default 0.05)"},{"name":"workdir","char":"","default":"","description":"Directory for default-named files. Default: \u003cinstanceDir>/collisions"}]},{"kind":"command","name":"collision events","description":"Show recent collision events captured in the current session's ring buffer","group":false,"args":[],"flags":[{"name":"limit","char":"n","default":"10","description":"Maximum number of events to show (default 10)"},{"name":"kind","char":"k","default":"","description":"Filter by detection point (one of: static, grammarMatch, llmSelect, fuzzy)"}]},{"kind":"command","name":"collision keywords","description":"Inspect/tune contextSelector keyword vectors, or backfill the committed keyword files.","group":true,"args":[{"name":"tokens","optional":true,"description":"e.g. \"list.addItems\", \"list.addItems add grocery shopping\", or omit to list all overrides."}],"flags":[]},{"kind":"command","name":"collision keywords backfill","description":"Backfill/refresh committed keyword files for agent actions. Lexical by default; --llm uses the preferred LLM distillation pass.","group":false,"args":[{"name":"schemas","optional":true,"description":"Schema names to backfill; omit to backfill every loaded schema."}],"flags":[{"name":"llm","char":"","default":"false","description":"Use LLM distillation (the preferred producer) instead of the deterministic lexical floor."},{"name":"force","char":"","default":"false","description":"Overwrite an existing LLM-distilled file with a lexical one (a lexical backfill preserves llm files by default)."}]},{"kind":"command","name":"collision list-strategies","description":"List the named strategies available for `@collision similar -s \u003cname>`","group":false,"args":[],"flags":[]},{"kind":"command","name":"collision neighborhoods","description":"Build neighborhoods directly from translator misroute edges and write a persisted JSON index plus an HTML viz.","group":false,"args":[],"flags":[{"name":"corpus","char":"","default":"","description":"Translator probe results JSON (default \u003cworkdir>/translation-results.json)"},{"name":"min-misroute","char":"","default":"2","description":"Drop edges below this count (default 2)"},{"name":"include-same-schema","char":"","default":"true","description":"Include same-schema misroute edges (e.g. email.send + email.reply). Default: true"},{"name":"samples-per-category","char":"","default":"5","description":"Per-category cap on edge sample phrases (default 5)."},{"name":"out","char":"","default":"","description":"Output JSON path (default \u003cworkdir>/neighborhoods.json)"},{"name":"out-html","char":"","default":"","description":"Output HTML path (default \u003cworkdir>/neighborhoods.html)"},{"name":"workdir","char":"","default":"","description":"Directory for default-named files. Default: \u003cinstanceDir>/collisions"}]},{"kind":"command","name":"collision optimize","description":"Optimize translator-collision neighborhoods: propose verified schema/manifest fixes, accumulate cross-run evidence about which lever and mechanism work for which collision class.","group":true,"args":[],"flags":[]},{"kind":"command","name":"collision optimize browse","description":"Generate browse.html for one or more optimization-run-* directories. Walks the run, writes a sortable case index plus a self-contained case.html per case showing every attempt with before/after diffs.","group":false,"args":[],"flags":[{"name":"run","char":"","default":"","description":"Run timestamp suffix (the \u003cts> in optimization-run-\u003cts>/). Default: latest run under \u003cworkdir>."},{"name":"all","char":"","default":"false","description":"Generate browse.html for ALL optimization-run-* directories under \u003cworkdir>. Overrides --run."},{"name":"workdir","char":"","default":"","description":"Directory containing optimization-run-* subdirectories. Default: \u003cinstanceDir>/collisions."}]},{"kind":"command","name":"collision optimize distill","description":"Distill winning attempts in patterns.jsonl into candidate schemaGuidelines additions. Groups winners by (mechanism, guidelineHook), calls the LLM with the current schemaGuidelines as context, writes schemaGuidelines.candidates.md for operator review.","group":false,"args":[],"flags":[{"name":"min-attempts","char":"","default":"10","description":"Minimum winners in patterns.jsonl before distill runs (default 10)."},{"name":"workdir","char":"","default":"","description":"Workdir containing patterns.jsonl."}]},{"kind":"command","name":"collision optimize explore","description":"Run the optimize loop on the top-N collision neighborhoods. Writes an attempts archive under \u003cworkdir>/optimization-run-\u003cts>/.","group":false,"args":[],"flags":[{"name":"corpus","char":"","default":"","description":"Path to neighborhoods.json (default \u003cworkdir>/neighborhoods.json)"},{"name":"baseline","char":"","default":"","description":"Path to translation-results.json (default \u003cworkdir>/translation-results.json)"},{"name":"top","char":"","default":"5","description":"Top-N cases by gravity to run (default 5)"},{"name":"hypotheses-per-lever","char":"","default":"3","description":"K hypotheses per lever per case (default 3). Reserved — levers pick K from this flag in a future revision."},{"name":"depth","char":"","default":"2","description":"Recursion depth budget (default 2). When all hypotheses at depth N regress, the case loop re-prompts the LLM with the failed mechanisms and asks for a different approach."},{"name":"lever","char":"","default":"","description":"Comma-separated lever names. Default: all registered levers."},{"name":"severity","char":"","default":"blocker,leaky","description":"Comma-separated severity tiers to include (default blocker,leaky). Allowed: blocker, leaky, minor."},{"name":"workdir","char":"","default":"","description":"Directory for default-named files. Default: \u003cinstanceDir>/collisions"},{"name":"dry-run","char":"","default":"false","description":"Write attempt scaffolding only — no LLM calls, no apply, no probe."},{"name":"concurrency","char":"","default":"8","description":"Reserved for future per-case parallelism."}]},{"kind":"command","name":"collision optimize list-levers","description":"List all registered optimization levers with their description, consumes, and probeType.","group":false,"args":[],"flags":[]},{"kind":"command","name":"collision optimize patterns","description":"Mine patterns.jsonl across all accumulated optimize runs. Emits patterns.{json,html} with three groupings (mechanism × pattern, per-lever, lever-effectiveness) plus classifier agreement.","group":false,"args":[],"flags":[{"name":"patterns-file","char":"","default":"","description":"Path to patterns.jsonl. Default: \u003cworkdir>/patterns.jsonl"},{"name":"min-attempts","char":"","default":"5","description":"Cells with fewer attempts than this render as '—' (default 5)."},{"name":"surface-disagreement","char":"","default":"0.5","description":"Highlight classifier-disagreement cells above this rate (0-1, default 0.5)."},{"name":"out","char":"","default":"","description":"Output JSON path (default \u003cworkdir>/patterns.json)."},{"name":"out-html","char":"","default":"","description":"Output HTML path (default \u003cworkdir>/patterns.html)."},{"name":"workdir","char":"","default":"","description":"Directory containing patterns.jsonl. Default: \u003cinstanceDir>/collisions."}]},{"kind":"command","name":"collision optimize run","description":"Run the full optimize pipeline (neighborhoods → explore → validate → patterns → distill) with --from gating. Each step's predecessor must exist before it runs.","group":false,"args":[],"flags":[{"name":"from","char":"","default":"neighborhoods","description":"Resume from a step: neighborhoods | explore | validate | patterns | distill (default neighborhoods)"},{"name":"top","char":"","default":"5","description":"Top-N cases (forwarded to explore, default 5)"},{"name":"depth","char":"","default":"2","description":"Recursion depth (forwarded to explore, default 2)."},{"name":"lever","char":"","default":"","description":"Lever filter (forwarded to explore)"},{"name":"severity","char":"","default":"blocker,leaky","description":"Severity tiers (forwarded to explore, default blocker,leaky)"},{"name":"dry-run","char":"","default":"false","description":"Dry-run mode (forwarded to explore)."},{"name":"skip-distill","char":"","default":"false","description":"Skip the distill step regardless of attempt count."},{"name":"distill-min-attempts","char":"","default":"10","description":"Minimum winners in patterns.jsonl before distill runs (default 10)."},{"name":"workdir","char":"","default":"","description":"Directory for pipeline intermediates. Default: \u003cinstanceDir>/collisions."}]},{"kind":"command","name":"collision optimize validate","description":"Stack all winners from an optimization run and re-probe the full baseline corpus. Emits optimization-impact.{json,html} with cross-neighborhood regression flags.","group":false,"args":[],"flags":[{"name":"run","char":"","default":"","description":"Run timestamp (the \u003cts> in optimization-run-\u003cts>/). Default: latest under \u003cworkdir>."},{"name":"phrases","char":"","default":"","description":"Restrict re-probing to phrases for a single neighborhood id. Faster for targeted iteration."},{"name":"baseline","char":"","default":"","description":"Override the baseline path recorded in optimization-run.json (useful when the original baseline moved)."},{"name":"workdir","char":"","default":"","description":"Directory containing optimization-run-* subdirectories. Default: \u003cinstanceDir>/collisions."},{"name":"winners","char":"","default":"","description":"Comma-separated attemptIds to include. Stacks ONLY these winners. Mutually exclusive with --leave-one-out."},{"name":"leave-one-out","char":"","default":"","description":"Comma-separated attemptIds to EXCLUDE. Stacks every winner except these. Useful for ablation — drop a suspected harmful winner and see whether the global numbers improve."}]},{"kind":"command","name":"collision preferences","description":"Inspect and edit Tier-1 collision preferences (used by the preference-clarify strategy)","group":true,"args":[],"flags":[]},{"kind":"command","name":"collision preferences clear","description":"Remove every stored collision preference","group":false,"args":[],"flags":[]},{"kind":"command","name":"collision preferences list","description":"List stored collision preferences (Tier-1)","group":false,"args":[],"flags":[]},{"kind":"command","name":"collision preferences remove","description":"Remove a stored collision preference by key (see `@collision preferences list`)","group":false,"args":[{"name":"key","optional":false,"description":"The preference key to remove."}],"flags":[]},{"kind":"command","name":"collision preferences set","description":"Set an explicit collision preference: among a candidate set, always pick the chosen option","group":false,"args":[{"name":"candidates","optional":false,"description":"Comma-separated competing options as schema.action, e.g. \"player.play,list.play\"."},{"name":"chosen","optional":false,"description":"The option to always pick, as schema.action. Must be one of the candidates."}],"flags":[]},{"kind":"command","name":"collision probe","description":"Probe what action(s) a hand-crafted utterance would route to via the embedding ranker (top-K with cosine deltas)","group":false,"args":[{"name":"phrase","optional":false,"description":"The utterance to probe, e.g. \"turn on wifi\""}],"flags":[{"name":"top","char":"n","default":"5","description":"Top-K candidates to render (default 5)"},{"name":"expected","char":"e","default":"","description":"Expected target as \"schema.actionName\" — flagged in the output if the top-1 candidate matches"},{"name":"delta","char":"","default":"0.05","description":"Score delta below which the top two are flagged ambiguous (default 0.05, matches llmSelect.scoreDeltaThreshold)"},{"name":"include-inactive","char":"","default":"false","description":"Include schemas that aren't currently active in this session"}]},{"kind":"command","name":"collision similar","description":"Find semantically similar actions across agents (multi-vector embedding similarity, clusters by default)","group":false,"args":[],"flags":[{"name":"threshold","char":"t","default":"0.85","description":"Per-strategy score threshold (default 0.85; raw cosine scale)"},{"name":"strategy","char":"s","default":"balanced","description":"Named scoring strategy (use `@collision similar list-strategies` to see all). Default: balanced"},{"name":"all-strategies","char":"","default":"false","description":"Run every strategy and render a comparison view"},{"name":"pairs","char":"","default":"false","description":"Render pairwise (legacy view) instead of clusters"},{"name":"top","char":"n","default":"50","description":"Maximum clusters / pairs to render (default 50)"},{"name":"json","char":"","default":"","description":"Write the structured scan result + applied-strategy data to this path as JSON"},{"name":"no-cache","char":"","default":"false","description":"Skip the on-disk embedding cache (forces re-embed)"}]}]},{"kind":"group","name":"config","children":[{"kind":"command","name":"config","description":"Configuration commands","group":true,"args":[],"flags":[]},{"kind":"command","name":"config action","description":"Toggle agent actions","group":false,"args":[{"name":"agentNames","optional":true,"description":"enable pattern"}],"flags":[{"name":"reset","char":"r","default":"false","description":"reset to default"},{"name":"off","char":"x","default":"","description":"disable pattern"},{"name":"priority","char":"f","default":"","description":"priority pattern"}]},{"kind":"command","name":"config agent","description":"Manage agents (enable/disable, setup, refresh)","group":true,"args":[{"name":"agentNames","optional":true,"description":"enable pattern"}],"flags":[{"name":"reset","char":"r","default":"false","description":"reset to default"},{"name":"off","char":"x","default":"","description":"disable pattern"},{"name":"priority","char":"f","default":"","description":"priority pattern"}]},{"kind":"command","name":"config agent refresh","description":"Re-check an agent's readiness state (or all agents)","group":false,"args":[{"name":"agentName","optional":true,"description":"agent to refresh (omit for all enabled agents)"}],"flags":[]},{"kind":"command","name":"config agent setup","description":"Run setup for an agent that needs configuration before use","group":false,"args":[{"name":"agentName","optional":true,"description":"agent to set up (omit to list agents that need setup)"}],"flags":[]},{"kind":"command","name":"config cache","description":"Configure cache behavior","group":true,"args":[],"flags":[]},{"kind":"command","name":"config cache grammarSystem","description":"Set grammar system (completionBased or nfa)","group":false,"args":[{"name":"system","optional":false,"description":"Grammar system to use"}],"flags":[]},{"kind":"command","name":"config cache useDFA","description":"Enable or disable DFA matching within the NFA grammar system (faster; requires grammarSystem=nfa)","group":false,"args":[{"name":"enabled","optional":false,"description":"true or false"}],"flags":[]},{"kind":"command","name":"config collision","description":"Configure action collision detection","group":true,"args":[],"flags":[]},{"kind":"command","name":"config collision contextSelector","description":"Configure the context-weighted resolution tier (deterministic topical tiebreaker on the grammar path)","group":true,"args":[],"flags":[]},{"kind":"command","name":"config collision contextSelector decay","description":"Get/set contextSelector decay (per-turn recency decay lambda (0 \u003c lambda \u003c= 1))","group":false,"args":[{"name":"value","optional":true,"description":"New value; omit to show the current value."}],"flags":[]},{"kind":"command","name":"config collision contextSelector detect","description":"Toggle context-weighted resolution (contextSelector)","group":true,"args":[],"flags":[]},{"kind":"command","name":"config collision contextSelector detect off","description":"Turn off context-weighted resolution (contextSelector)","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision contextSelector detect on","description":"Turn on context-weighted resolution (contextSelector)","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision contextSelector margin","description":"Get/set contextSelector margin (clear-winner margin the winner must beat the runner-up by)","group":false,"args":[{"name":"value","optional":true,"description":"New value; omit to show the current value."}],"flags":[]},{"kind":"command","name":"config collision contextSelector minMass","description":"Get/set contextSelector minMass (evidence gate: min winner matched mass)","group":false,"args":[{"name":"value","optional":true,"description":"New value; omit to show the current value."}],"flags":[]},{"kind":"command","name":"config collision contextSelector minUniqueTokens","description":"Get/set contextSelector minUniqueTokens (evidence gate: min distinct distinguishing tokens the winner must match)","group":false,"args":[{"name":"value","optional":true,"description":"New value; omit to show the current value."}],"flags":[]},{"kind":"command","name":"config collision contextSelector windowTurns","description":"Get/set contextSelector windowTurns (ring-buffer look-back N over recent user turns)","group":false,"args":[{"name":"value","optional":true,"description":"New value; omit to show the current value."}],"flags":[]},{"kind":"command","name":"config collision fuzzy","description":"Configure fuzzy collision detection","group":true,"args":[],"flags":[]},{"kind":"command","name":"config collision fuzzy detect","description":"Toggle fuzzy collision detection","group":true,"args":[],"flags":[]},{"kind":"command","name":"config collision fuzzy detect off","description":"Turn off fuzzy collision detection","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision fuzzy detect on","description":"Turn on fuzzy collision detection","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision fuzzy strategy","description":"Set fuzzy resolution strategy (one of: first-match, score-rank, priority, user-clarify, preference-clarify)","group":false,"args":[{"name":"strategy","optional":false,"description":"strategy name"}],"flags":[]},{"kind":"command","name":"config collision grammarMatch","description":"Configure grammarMatch collision detection","group":true,"args":[],"flags":[]},{"kind":"command","name":"config collision grammarMatch detect","description":"Toggle grammarMatch collision detection","group":true,"args":[],"flags":[]},{"kind":"command","name":"config collision grammarMatch detect off","description":"Turn off grammarMatch collision detection","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision grammarMatch detect on","description":"Turn on grammarMatch collision detection","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision grammarMatch strategy","description":"Set grammarMatch resolution strategy (one of: first-match, score-rank, priority, user-clarify, preference-clarify)","group":false,"args":[{"name":"strategy","optional":false,"description":"strategy name"}],"flags":[]},{"kind":"command","name":"config collision llmSelect","description":"Configure llmSelect collision detection","group":true,"args":[],"flags":[]},{"kind":"command","name":"config collision llmSelect detect","description":"Toggle llmSelect collision detection","group":true,"args":[],"flags":[]},{"kind":"command","name":"config collision llmSelect detect off","description":"Turn off llmSelect collision detection","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision llmSelect detect on","description":"Turn on llmSelect collision detection","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision llmSelect strategy","description":"Set llmSelect resolution strategy (one of: first-match, score-rank, priority, user-clarify, preference-clarify)","group":false,"args":[{"name":"strategy","optional":false,"description":"strategy name"}],"flags":[]},{"kind":"command","name":"config collision preference","description":"Configure the preference-clarify strategy (Tier-1 preferences + Tier-2 registry)","group":true,"args":[],"flags":[]},{"kind":"command","name":"config collision preference enabled","description":"Toggle preference-clarify resolution","group":true,"args":[],"flags":[]},{"kind":"command","name":"config collision preference enabled off","description":"Turn off preference-clarify resolution","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision preference enabled on","description":"Turn on preference-clarify resolution","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision preference registry","description":"Set the filesystem path to the known-ambiguous neighborhoods registry (neighborhoods.json). Empty string clears it.","group":false,"args":[{"name":"path","optional":true,"description":"Absolute path to neighborhoods.json. Use the empty string \"\" to clear."}],"flags":[]},{"kind":"command","name":"config collision preference registryFirst","description":"Toggle registry-first detection (scan all embedding candidates against the neighborhood registry, independent of the score-delta detector)","group":true,"args":[],"flags":[]},{"kind":"command","name":"config collision preference registryFirst off","description":"Turn off registry-first detection (scan all embedding candidates against the neighborhood registry, independent of the score-delta detector)","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision preference registryFirst on","description":"Turn on registry-first detection (scan all embedding candidates against the neighborhood registry, independent of the score-delta detector)","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision preference remember","description":"Set how learned preferences are captured for the `preference-clarify` strategy. Empty argument shows the current value.","group":false,"args":[{"name":"mode","optional":true,"description":"One of: prompt, always, never."}],"flags":[]},{"kind":"command","name":"config collision preference source","description":"Set which ambiguity source feeds the `preference-clarify` strategy. Empty argument shows the current value.","group":false,"args":[{"name":"source","optional":true,"description":"One of: runtime, registry, both."}],"flags":[]},{"kind":"command","name":"config collision priority","description":"Set priorityOrder (comma-separated agent names) used by the `priority` resolution strategy. Empty argument shows the current value.","group":false,"args":[{"name":"order","optional":true,"description":"Comma-separated agent names, e.g. \"list,player,calendar\". Use the empty string \"\" to clear."}],"flags":[]},{"kind":"command","name":"config collision show","description":"Show the current collision detection config","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision static","description":"Configure static collision detection","group":true,"args":[],"flags":[]},{"kind":"command","name":"config collision static detect","description":"Toggle static collision detection","group":true,"args":[],"flags":[]},{"kind":"command","name":"config collision static detect off","description":"Turn off static collision detection","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision static detect on","description":"Turn on static collision detection","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision static strategy","description":"Set static resolution strategy (one of: warn, error)","group":false,"args":[{"name":"strategy","optional":false,"description":"strategy name"}],"flags":[]},{"kind":"command","name":"config collision telemetry","description":"Configure collision telemetry","group":true,"args":[],"flags":[]},{"kind":"command","name":"config collision telemetry debugLog","description":"Toggle collision telemetry debug log","group":true,"args":[],"flags":[]},{"kind":"command","name":"config collision telemetry debugLog off","description":"Turn off collision telemetry debug log","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision telemetry debugLog on","description":"Turn on collision telemetry debug log","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision telemetry emit","description":"Toggle collision telemetry ring buffer","group":true,"args":[],"flags":[]},{"kind":"command","name":"config collision telemetry emit off","description":"Turn off collision telemetry ring buffer","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision telemetry emit on","description":"Turn on collision telemetry ring buffer","group":false,"args":[],"flags":[]},{"kind":"command","name":"config collision telemetry experimentId","description":"Set the experimentId tag attached to every emitted collision event. Empty string clears it.","group":false,"args":[{"name":"id","optional":true,"description":"Experiment tag, e.g. \"E1.2-2026-05-12\". Empty string \"\" clears."}],"flags":[]},{"kind":"command","name":"config command","description":"Toggle agent commands","group":false,"args":[{"name":"agentNames","optional":true,"description":"enable pattern"}],"flags":[{"name":"reset","char":"r","default":"false","description":"reset to default"},{"name":"off","char":"x","default":"","description":"disable pattern"},{"name":"priority","char":"f","default":"","description":"priority pattern"}]},{"kind":"command","name":"config dev","description":"Toggle development mode","group":true,"args":[],"flags":[]},{"kind":"command","name":"config dev off","description":"Turn off development mode","group":false,"args":[],"flags":[]},{"kind":"command","name":"config dev on","description":"Turn on development mode (records conversation + translation data)","group":false,"args":[],"flags":[{"name":"confirm","char":"c","default":"false","description":"Also confirm each translated action via the client before running it"}]},{"kind":"command","name":"config execution","description":"Execution configuration","group":true,"args":[],"flags":[]},{"kind":"command","name":"config execution activity","description":"Toggle activity context","group":true,"args":[],"flags":[]},{"kind":"command","name":"config execution activity off","description":"Turn off activity context","group":false,"args":[],"flags":[]},{"kind":"command","name":"config execution activity on","description":"Turn on activity context","group":false,"args":[],"flags":[]},{"kind":"command","name":"config execution conversationAnswer","description":"How conversation questions are answered: 'lookup' (conversation-memory lookup, reasoning as fallback), 'reasoning-first' (reasoning agent primary, lookup as fallback), or 'reasoning-only' (remove the lookup action; reasoning handles conversation Q&A)","group":false,"args":[{"name":"strategy","optional":true,"description":"'lookup' (default), 'reasoning-first', or 'reasoning-only'. Omit to show the current strategy."}],"flags":[]},{"kind":"command","name":"config execution entityPromptShape","description":"Shape used when serializing Entity objects into LLM prompts","group":false,"args":[{"name":"shape","optional":true,"description":"'facets' (default, name+value array), 'flat' (collapse facets into a properties object), or 'facets-with-schema' (facets + append the Entity TS type to the reasoning system prompt). Omit to show the current value."}],"flags":[]},{"kind":"command","name":"config execution planReuse","description":"Enable or disable workflow plan reuse for reasoning actions","group":false,"args":[{"name":"mode","optional":true,"description":"Plan reuse mode: 'enabled' to cache and reuse workflow plans, 'disabled' for standard reasoning. Omit to show the current value."}],"flags":[]},{"kind":"command","name":"config execution reasoning","description":"Set reasoning engine","group":false,"args":[{"name":"engine","optional":true,"description":"Reasoning engine to use (claude, copilot, or none). Omit to show the current engine."}],"flags":[]},{"kind":"command","name":"config execution reasoningEffort","description":"Set the Copilot reasoning effort (low, medium, high, xhigh). Only applies to models that support it. Omit to show the current value.","group":false,"args":[{"name":"effort","optional":true,"description":"'low', 'medium', 'high', or 'xhigh'. Omit to show the current value."}],"flags":[]},{"kind":"command","name":"config execution reasoningHistory","description":"Number of recent conversation turns included as context in the reasoning prompt","group":false,"args":[{"name":"turns","optional":true,"description":"Number of recent conversation turns to include (e.g. 4). 0 disables history. Omit to show the current value."}],"flags":[]},{"kind":"command","name":"config execution reasoningModel","description":"Set the Copilot reasoning model (e.g. claude-opus-4.8). Omit to show the current value.","group":false,"args":[{"name":"model","optional":true,"description":"Model identifier for Copilot reasoning. Omit to show the current value."}],"flags":[]},{"kind":"command","name":"config execution recordUserMessages","description":"Toggle record the user's own messages in the conversation transcript (chat history)","group":true,"args":[],"flags":[]},{"kind":"command","name":"config execution recordUserMessages off","description":"Turn off record the user's own messages in the conversation transcript (chat history)","group":false,"args":[],"flags":[]},{"kind":"command","name":"config execution recordUserMessages on","description":"Turn on record the user's own messages in the conversation transcript (chat history)","group":false,"args":[],"flags":[]},{"kind":"command","name":"config execution scriptReuse","description":"Enable or disable PowerShell script reuse for reasoning actions","group":false,"args":[{"name":"mode","optional":true,"description":"Script reuse mode: 'enabled' to capture and reuse PowerShell scripts, 'disabled' for standard reasoning. Omit to show the current value."}],"flags":[]},{"kind":"command","name":"config execution setupOnFirstUse","description":"Toggle auto-run agent setup on first use (otherwise emit a hint to run @config agent setup)","group":true,"args":[],"flags":[]},{"kind":"command","name":"config execution setupOnFirstUse off","description":"Turn off auto-run agent setup on first use (otherwise emit a hint to run @config agent setup)","group":false,"args":[],"flags":[]},{"kind":"command","name":"config execution setupOnFirstUse on","description":"Turn on auto-run agent setup on first use (otherwise emit a hint to run @config agent setup)","group":false,"args":[],"flags":[]},{"kind":"command","name":"config explainer","description":"Explainer configuration","group":true,"args":[],"flags":[]},{"kind":"command","name":"config explainer async","description":"Toggle asynchronous explanation","group":true,"args":[],"flags":[]},{"kind":"command","name":"config explainer async off","description":"Turn off asynchronous explanation","group":false,"args":[],"flags":[]},{"kind":"command","name":"config explainer async on","description":"Turn on asynchronous explanation","group":false,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter","description":"Toggle explanation filter","group":true,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter multiple","description":"Toggle explanation filter multiple actions","group":true,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter multiple off","description":"Turn off explanation filter multiple actions","group":false,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter multiple on","description":"Turn on explanation filter multiple actions","group":false,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter off","description":"Turn off all explanation filters","group":false,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter on","description":"Turn on all explanation filters","group":false,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter reference","description":"Toggle reference filter","group":true,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter reference list","description":"Toggle explainer filter reference using word lists","group":true,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter reference list off","description":"Turn off explainer filter reference using word lists","group":false,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter reference list on","description":"Turn on explainer filter reference using word lists","group":false,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter reference off","description":"Turn off all explanation reference filters","group":false,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter reference on","description":"Turn on all explanation reference filters","group":false,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter reference translate","description":"Toggle explainer filter reference by translate without context","group":true,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter reference translate off","description":"Turn off explainer filter reference by translate without context","group":false,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter reference translate on","description":"Turn on explainer filter reference by translate without context","group":false,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter reference value","description":"Toggle explainer filter reference by value in the request","group":true,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter reference value off","description":"Turn off explainer filter reference by value in the request","group":false,"args":[],"flags":[]},{"kind":"command","name":"config explainer filter reference value on","description":"Turn on explainer filter reference by value in the request","group":false,"args":[],"flags":[]},{"kind":"command","name":"config explainer model","description":"Set model","group":false,"args":[{"name":"model","optional":true,"description":"Model name"}],"flags":[{"name":"reset","char":"r","default":"false","description":"Reset to default model"}]},{"kind":"command","name":"config explainer name","description":"Set explainer","group":false,"args":[{"name":"explainerName","optional":false,"description":"name of the explainer"}],"flags":[]},{"kind":"command","name":"config explainer off","description":"Turn off explanation","group":false,"args":[],"flags":[]},{"kind":"command","name":"config explainer on","description":"Turn on explanation","group":false,"args":[],"flags":[]},{"kind":"command","name":"config log","description":"Toggle logging","group":true,"args":[],"flags":[]},{"kind":"command","name":"config log db","description":"Toggle logging","group":true,"args":[],"flags":[]},{"kind":"command","name":"config log db off","description":"Turn off logging","group":false,"args":[],"flags":[]},{"kind":"command","name":"config log db on","description":"Turn on logging","group":false,"args":[],"flags":[]},{"kind":"command","name":"config match","description":"Configure match behavior","group":true,"args":[],"flags":[]},{"kind":"command","name":"config match grammar","description":"Toggle grammar cache usage","group":true,"args":[],"flags":[]},{"kind":"command","name":"config match grammar off","description":"Turn off grammar cache usage","group":false,"args":[],"flags":[]},{"kind":"command","name":"config match grammar on","description":"Turn on grammar cache usage","group":false,"args":[],"flags":[]},{"kind":"command","name":"config modelProvider","description":"Show or set the active model provider (azure | openai | ollama | copilot)","group":false,"args":[{"name":"name","optional":true,"description":"Provider to activate (azure | openai | ollama | copilot)"},{"name":"action","optional":true,"description":"Optional 'list' to list provider's models"}],"flags":[]},{"kind":"command","name":"config request","description":"Set the agent that handle natural language requests","group":false,"args":[{"name":"appAgentName","optional":false,"description":"name of the agent"}],"flags":[]},{"kind":"command","name":"config schema","description":"Toggle agent schemas","group":false,"args":[{"name":"agentNames","optional":true,"description":"enable pattern"}],"flags":[{"name":"reset","char":"r","default":"false","description":"reset to default"},{"name":"off","char":"x","default":"","description":"disable pattern"},{"name":"priority","char":"f","default":"","description":"priority pattern"}]},{"kind":"command","name":"config scrub","description":"Toggle outbound secret scrubbing","group":true,"args":[],"flags":[]},{"kind":"command","name":"config scrub off","description":"Turn off outbound secret scrubbing","group":false,"args":[],"flags":[]},{"kind":"command","name":"config scrub on","description":"Turn on outbound secret scrubbing","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation","description":"Translation configuration","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation entity","description":"Entity translation configuration","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation entity clarify","description":"Toggle entity clarification","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation entity clarify off","description":"Turn off entity clarification","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation entity clarify on","description":"Turn on entity clarification","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation entity filter","description":"Toggle entity filter using LLM","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation entity filter off","description":"Turn off entity filter using LLM","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation entity filter on","description":"Turn on entity filter using LLM","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation entity resolve","description":"Toggle entity resolution","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation entity resolve off","description":"Turn off entity resolution","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation entity resolve on","description":"Turn on entity resolution","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation history","description":"Configure chat history usage in translation","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation history limit","description":"Set the limit of chat history usage in translation","group":false,"args":[{"name":"limit","optional":false,"description":"Number of actions"}],"flags":[]},{"kind":"command","name":"config translation history off","description":"Turn off history","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation history on","description":"Turn on history","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation model","description":"Set model","group":false,"args":[{"name":"model","optional":true,"description":"Model name"}],"flags":[{"name":"reset","char":"r","default":"false","description":"Reset to default model"}]},{"kind":"command","name":"config translation multi","description":"multiple actions","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation multi off","description":"Turn off multiple action translation","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation multi on","description":"Turn on multiple action translation","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation multi pending","description":"Toggle pending request in multiple action","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation multi pending off","description":"Turn off pending request in multiple action","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation multi pending on","description":"Turn on pending request in multiple action","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation multi result","description":"Toggle result id in multiple action","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation multi result off","description":"Turn off result id in multiple action","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation multi result on","description":"Turn on result id in multiple action","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation off","description":"Turn off translation","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation on","description":"Turn on translation","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation schema","description":"Action schema configuration","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation schema generation","description":"Generated action schema","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation schema generation json","description":"Toggle use generate json schema if model supports it","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation schema generation json off","description":"Turn off use generate json schema if model supports it","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation schema generation json on","description":"Turn on use generate json schema if model supports it","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation schema generation jsonFunc","description":"Toggle use generate json schema function if model supports it","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation schema generation jsonFunc off","description":"Turn off use generate json schema function if model supports it","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation schema generation jsonFunc on","description":"Turn on use generate json schema function if model supports it","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation schema generation off","description":"Turn off generated action schema","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation schema generation on","description":"Turn on generated action schema","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation schema optimize","description":"Optimize schema","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation schema optimize actions","description":"Set number of actions to use for initial translation","group":false,"args":[{"name":"count","optional":false,"description":"Number of actions"}],"flags":[]},{"kind":"command","name":"config translation schema optimize off","description":"Turn off schema optimization","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation schema optimize on","description":"Turn on schema optimization","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation stream","description":"Toggle streaming translation","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation stream off","description":"Turn off streaming translation","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation stream on","description":"Turn on streaming translation","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation switch","description":"auto switch schemas","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation switch embedding","description":"Toggle Use embedding for initial pick of schema","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation switch embedding off","description":"Turn off Use embedding for initial pick of schema","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation switch embedding on","description":"Turn on Use embedding for initial pick of schema","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation switch fix","description":"Set a fixed schema disable switching","group":false,"args":[{"name":"schemaName","optional":false,"description":"name of the schema"}],"flags":[]},{"kind":"command","name":"config translation switch inline","description":"Toggle inject inline switch","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation switch inline off","description":"Turn off inject inline switch","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation switch inline on","description":"Turn on inject inline switch","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation switch off","description":"Turn off switch schema","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation switch on","description":"Turn on switch schema","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation switch search","description":"Toggle search switch","group":true,"args":[],"flags":[]},{"kind":"command","name":"config translation switch search off","description":"Turn off search switch","group":false,"args":[],"flags":[]},{"kind":"command","name":"config translation switch search on","description":"Turn on search switch","group":false,"args":[],"flags":[]}]},{"kind":"group","name":"const","children":[{"kind":"command","name":"const","description":"Command to manage the construction store","group":true,"args":[],"flags":[]},{"kind":"command","name":"const auto","description":"Toggle construction auto save","group":true,"args":[],"flags":[]},{"kind":"command","name":"const auto off","description":"Turn off construction auto save","group":false,"args":[],"flags":[]},{"kind":"command","name":"const auto on","description":"Turn on construction auto save","group":false,"args":[],"flags":[]},{"kind":"command","name":"const builtin","description":"Toggle construction built-in cache","group":true,"args":[],"flags":[]},{"kind":"command","name":"const builtin off","description":"Turn off construction built-in cache","group":false,"args":[],"flags":[]},{"kind":"command","name":"const builtin on","description":"Turn on construction built-in cache","group":false,"args":[],"flags":[]},{"kind":"command","name":"const delete","description":"Delete a construction by id","group":false,"args":[{"name":"namespace","optional":false,"description":"namespace the construction in"},{"name":"id","optional":false,"description":"construction id to delete"}],"flags":[]},{"kind":"command","name":"const import","description":"Import constructions from test data","group":false,"args":[{"name":"file","optional":true,"description":"Path to the construction file to import from. Load host specified test files if not specified."}],"flags":[{"name":"extended","char":"t","default":"false","description":"Load host specified extended test files if no file argument is specified"}]},{"kind":"command","name":"const info","description":"Show current construction store info","group":false,"args":[],"flags":[]},{"kind":"command","name":"const list","description":"List constructions","group":false,"args":[],"flags":[{"name":"verbose","char":"v","default":"false","description":"Verbose only.  Includes part index, and list all string in match set"},{"name":"all","char":"a","default":"false","description":"List all string in match set"},{"name":"builtin","char":"b","default":"false","description":"List the construction in the built-in cache"},{"name":"match","char":"m","default":"","description":"Filter to constructions that has the string in the match set"},{"name":"part","char":"p","default":"","description":"Filter to constructions that has the string match in the part name"},{"name":"id","char":"","default":"","description":"Construction id to list"}]},{"kind":"command","name":"const load","description":"Load a construction store from disk","group":false,"args":[{"name":"file","optional":true,"description":"Construction file in the session directory or path to file"}],"flags":[]},{"kind":"command","name":"const merge","description":"Toggle construction merge","group":true,"args":[],"flags":[]},{"kind":"command","name":"const merge off","description":"Turn off construction merge","group":false,"args":[],"flags":[]},{"kind":"command","name":"const merge on","description":"Turn on construction merge","group":false,"args":[],"flags":[]},{"kind":"command","name":"const new","description":"Create a new construction store","group":false,"args":[{"name":"file","optional":true,"description":"File name to be created in the session directory or path to the file to be created."}],"flags":[]},{"kind":"command","name":"const off","description":"Disable construction store","group":false,"args":[],"flags":[]},{"kind":"command","name":"const prune","description":"Prune out of date construction from the cache","group":false,"args":[],"flags":[]},{"kind":"command","name":"const save","description":"Save construction store to disk","group":false,"args":[{"name":"file","optional":true,"description":"Construction file in the session directory or path to file"}],"flags":[]},{"kind":"command","name":"const wildcard","description":"wildcard matching","group":true,"args":[],"flags":[]},{"kind":"command","name":"const wildcard entity","description":"Toggle entity wildcard matching","group":true,"args":[],"flags":[]},{"kind":"command","name":"const wildcard entity off","description":"Turn off entity wildcard matching","group":false,"args":[],"flags":[]},{"kind":"command","name":"const wildcard entity on","description":"Turn on entity wildcard matching","group":false,"args":[],"flags":[]},{"kind":"command","name":"const wildcard off","description":"Turn off wildcard matching","group":false,"args":[],"flags":[]},{"kind":"command","name":"const wildcard on","description":"Turn on wildcard matching","group":false,"args":[],"flags":[]}]},{"kind":"group","name":"conversation","children":[{"kind":"command","name":"conversation","description":"Conversation management commands","group":true,"args":[],"flags":[]},{"kind":"command","name":"conversation delete","description":"Delete a conversation by name","group":false,"args":[{"name":"name","optional":false,"description":"Name of the conversation to delete"}],"flags":[]},{"kind":"command","name":"conversation help","description":"Show conversation command help","group":false,"args":[],"flags":[]},{"kind":"command","name":"conversation info","description":"Show info about the current conversation","group":false,"args":[],"flags":[]},{"kind":"command","name":"conversation list","description":"List all conversations","group":false,"args":[],"flags":[]},{"kind":"command","name":"conversation new","description":"Create a new conversation, optionally with a name","group":false,"args":[{"name":"name","optional":true,"description":"Name for the new conversation (optional)"}],"flags":[]},{"kind":"command","name":"conversation next","description":"Switch to the next conversation in the list (wraps around)","group":false,"args":[],"flags":[]},{"kind":"command","name":"conversation prev","description":"Switch to the previous conversation in the list (wraps around)","group":false,"args":[],"flags":[]},{"kind":"command","name":"conversation rename","description":"Rename a conversation. With one argument, renames the current conversation; with two, renames the named conversation.","group":false,"args":[{"name":"nameOrNewName","optional":false,"description":"New name (renames current) or existing name (when newName given)"},{"name":"newName","optional":true,"description":"New name when renaming a specific conversation"}],"flags":[]},{"kind":"command","name":"conversation switch","description":"Switch to a conversation by name (defaults to the next conversation in the list)","group":false,"args":[{"name":"name","optional":true,"description":"Name of the conversation to switch to (omit to cycle to the next)"}],"flags":[]}]},{"kind":"group","name":"copilot","children":[{"kind":"command","name":"copilot","description":"GitHub Copilot session commands","group":true,"args":[],"flags":[]},{"kind":"command","name":"copilot fix","description":"Hand the current conversation to GitHub Copilot Chat in VS Code to diagnose and fix","group":false,"args":[{"name":"instructions","optional":true,"description":"Optional extra instructions to include in the Copilot prompt"}],"flags":[{"name":"mode","char":"","default":"agent","description":"Copilot chat mode: 'agent' (can edit the workspace) or 'ask'"},{"name":"no-screenshot","char":"","default":"false","description":"Do not attach a screenshot of the VS Code window"},{"name":"dev-captures","char":"","default":"auto","description":"Include developer-mode translation captures: 'auto' (when developer mode is on), 'on', or 'off'"},{"name":"target","char":"","default":"native","description":"Copilot target (reserved; only native GitHub Copilot is supported)"},{"name":"no-send","char":"","default":"false","description":"Pre-fill the Copilot prompt but do not auto-submit it (review before sending)"},{"name":"reuse-session","char":"","default":"false","description":"Send into the current Copilot Chat session instead of starting a new one"},{"name":"location","char":"","default":"editor","description":"Where to open the new session: 'editor' (new chat editor), 'view' (chat panel), or 'window' (separate chat window)"}]},{"kind":"command","name":"copilot import","description":"Import GitHub Copilot Chat sessions as conversation mirrors","group":false,"args":[],"flags":[]}]},{"kind":"group","name":"debug","children":[{"kind":"command","name":"debug","description":"Start node inspector","group":false,"args":[],"flags":[]}]},{"kind":"group","name":"describe","children":[{"kind":"command","name":"describe","description":"Describe what an agent or action can do (installed-but-disabled agents included)","group":false,"args":[{"name":"name","optional":false,"description":"Agent name, or (if no action given) action name"},{"name":"actionName","optional":true,"description":"Action name, when `name` is an agent"}],"flags":[{"name":"all","char":"a","default":"false","description":"Show the full action table instead of the top 10"}]}]},{"kind":"group","name":"display","children":[{"kind":"command","name":"display","description":"Send text to display","group":false,"args":[{"name":"text","optional":false,"description":"text to display"}],"flags":[{"name":"speak","char":"","default":"false","description":"Speak the display for the host that supports TTS"},{"name":"type","char":"","default":"text","description":"Display type"},{"name":"inline","char":"","default":"false","description":"Display inline"}]}]},{"kind":"group","name":"env","children":[{"kind":"command","name":"env","description":"Environment variable commands","group":true,"args":[],"flags":[]},{"kind":"command","name":"env all","description":"Echos environment variables to the user interface.","group":false,"args":[],"flags":[]},{"kind":"command","name":"env get","description":"Echos the value of a named environment variable to the user interface","group":false,"args":[{"name":"name","optional":false,"description":"The name of the environment variable."}],"flags":[]}]},{"kind":"group","name":"exit","children":[{"kind":"command","name":"exit","description":"Exit the program","group":false,"args":[],"flags":[]}]},{"kind":"group","name":"feedback","children":[{"kind":"command","name":"feedback","description":"Inspect and export user-feedback entries","group":true,"args":[],"flags":[]},{"kind":"command","name":"feedback count","description":"Show the total number of feedback entries.","group":false,"args":[],"flags":[]},{"kind":"command","name":"feedback export","description":"Export user-feedback entries to a local file (JSON or JSONL).","group":false,"args":[{"name":"file","optional":false,"description":"Destination path (extension picks the format if --format is omitted: .jsonl → JSONL, anything else → JSON)"}],"flags":[{"name":"format","char":"","default":"","description":"json | jsonl (overrides the path extension)"},{"name":"all","char":"","default":"false","description":"Include every entry; otherwise only the latest rating per request"}]},{"kind":"command","name":"feedback filter","description":"Filter feedback by rating, category, and/or date range.","group":false,"args":[],"flags":[{"name":"rating","char":"","default":"","description":"up | down | cleared"},{"name":"category","char":"","default":"","description":"wrong-agent | didnt-understand | bad-response | other"},{"name":"since","char":"","default":"","description":"ISO date (YYYY-MM-DD) — entries on/after this date"},{"name":"until","char":"","default":"","description":"ISO date (YYYY-MM-DD) — entries on/before this date"},{"name":"limit","char":"","default":"50","description":"Maximum number of entries to show"},{"name":"all","char":"","default":"false","description":"Include every entry; otherwise only the latest rating per request"}]},{"kind":"command","name":"feedback list","description":"List recent user-feedback entries (most recent first).","group":false,"args":[],"flags":[{"name":"limit","char":"","default":"20","description":"Maximum number of entries to show"},{"name":"all","char":"","default":"false","description":"Include every entry; otherwise only the latest rating per request is shown"}]},{"kind":"command","name":"feedback top","description":"Aggregate user feedback — counts by rating and category.","group":false,"args":[],"flags":[{"name":"limit","char":"","default":"10","description":"Top-N depth for the per-category breakdown"}]}]},{"kind":"group","name":"grammar","children":[{"kind":"command","name":"grammar","description":"Grammar rule and collision commands","group":true,"args":[],"flags":[]},{"kind":"command","name":"grammar clear","description":"Clear stored grammar rules (optionally for a specific agent)","group":false,"args":[{"name":"agent","optional":true,"description":"Agent name to clear rules for. Omit to clear all stored rules."}],"flags":[]},{"kind":"command","name":"grammar collisions","description":"Scan all loaded agent grammars for cross-agent collisions, with concrete witness inputs","group":false,"args":[],"flags":[{"name":"json","char":"","default":"","description":"Write the structured scan result to this path as JSON (in addition to rendering the report)"}]},{"kind":"command","name":"grammar delete","description":"Delete a stored grammar rule by ID","group":false,"args":[{"name":"id","optional":false,"description":"Numeric ID of the rule to delete"}],"flags":[]},{"kind":"command","name":"grammar list","description":"List grammar rules learned at runtime (optionally filtered by agent)","group":false,"args":[{"name":"agent","optional":true,"description":"Agent name to filter by (e.g. 'list', 'player')"}],"flags":[]},{"kind":"command","name":"grammar show","description":"Show a stored grammar rule by ID","group":false,"args":[{"name":"id","optional":false,"description":"Numeric ID of the rule to inspect"}],"flags":[]}]},{"kind":"group","name":"help","children":[{"kind":"command","name":"help","description":"Show help","group":false,"args":[{"name":"command","optional":true,"description":"command to get help for"}],"flags":[{"name":"all","char":"a","default":"false","description":"shows all commands"}]}]},{"kind":"group","name":"history","children":[{"kind":"command","name":"history","description":"History commands","group":true,"args":[],"flags":[]},{"kind":"command","name":"history clear","description":"Clear the history","group":false,"args":[],"flags":[{"name":"activity","char":"","default":"true","description":"Clear the current activity context"}]},{"kind":"command","name":"history delete","description":"Delete a specific message from the chat history","group":false,"args":[{"name":"index","optional":false,"description":"Chat history index to delete."}],"flags":[]},{"kind":"command","name":"history entities","description":"History entity commands","group":true,"args":[],"flags":[]},{"kind":"command","name":"history entities delete","description":"Delete entities from the chat history (working memory).","group":false,"args":[{"name":"entityId","optional":false,"description":"The UniqueId of the entity"}],"flags":[]},{"kind":"command","name":"history entities list","description":"Shows all of the entities currently in 'working memory.'","group":false,"args":[],"flags":[]},{"kind":"command","name":"history insert","description":"Insert messages to chat history","group":false,"args":[{"name":"messages","optional":false,"description":"Chat history messages to insert"}],"flags":[]},{"kind":"command","name":"history list","description":"List history","group":false,"args":[],"flags":[]},{"kind":"command","name":"history save","description":"Save the chat history to a file","group":false,"args":[{"name":"file","optional":false,"description":"File to save the chat history to"}],"flags":[]}]},{"kind":"group","name":"index","children":[{"kind":"command","name":"index","description":"Indexing commands","group":true,"args":[],"flags":[]},{"kind":"command","name":"index create","description":"Create a new index","group":false,"args":[{"name":"type","optional":false,"description":"The type of index to create [image, email, website]"},{"name":"name","optional":false,"description":"Name of the index"},{"name":"location","optional":false,"description":"Location of the index"}],"flags":[]},{"kind":"command","name":"index delete","description":"Delete an index","group":false,"args":[{"name":"name","optional":false,"description":"Name of the index to delete"}],"flags":[]},{"kind":"command","name":"index info","description":"Show index details","group":false,"args":[{"name":"name","optional":false,"description":"Name of the index"}],"flags":[]},{"kind":"command","name":"index list","description":"List indexes","group":false,"args":[],"flags":[]}]},{"kind":"group","name":"memory","children":[{"kind":"command","name":"memory","description":"Memory commands","group":true,"args":[],"flags":[]},{"kind":"command","name":"memory answer","description":"Answer a question using conversation memory","group":false,"args":[{"name":"question","optional":false,"description":"Question to ask the conversation memory"}],"flags":[{"name":"asc","char":"","default":"true","description":"Sort results in ascending order"},{"name":"message","char":"","default":"false","description":"Display message"},{"name":"knowledge","char":"","default":"false","description":"Display knowledge"},{"name":"count","char":"","default":"25","description":"Display count of results"},{"name":"distinct","char":"","default":"false","description":"Display distinct results"}]},{"kind":"command","name":"memory legacy","description":"Toggle legacy","group":true,"args":[],"flags":[]},{"kind":"command","name":"memory legacy off","description":"Turn off legacy","group":false,"args":[],"flags":[]},{"kind":"command","name":"memory legacy on","description":"Turn on legacy","group":false,"args":[],"flags":[]},{"kind":"command","name":"memory query","description":"Search conversation memory","group":false,"args":[{"name":"terms","optional":false,"description":"Terms to search in conversation memory"}],"flags":[{"name":"asc","char":"","default":"true","description":"Sort results in ascending order"},{"name":"message","char":"","default":"true","description":"Display message"},{"name":"knowledge","char":"","default":"true","description":"Display knowledge"},{"name":"count","char":"","default":"25","description":"Display count of results"},{"name":"distinct","char":"","default":"false","description":"Display distinct results"}]},{"kind":"command","name":"memory search","description":"Answer a question using conversation memory","group":false,"args":[{"name":"question","optional":false,"description":"Question to ask the conversation memory"}],"flags":[{"name":"asc","char":"","default":"true","description":"Sort results in ascending order"},{"name":"message","char":"","default":"false","description":"Display message"},{"name":"knowledge","char":"","default":"false","description":"Display knowledge"},{"name":"count","char":"","default":"25","description":"Display count of results"},{"name":"distinct","char":"","default":"false","description":"Display distinct results"}]}]},{"kind":"group","name":"notify","children":[{"kind":"command","name":"notify","description":"Notify commands","group":true,"args":[],"flags":[]},{"kind":"command","name":"notify clear","description":"Clears notifications","group":false,"args":[],"flags":[]},{"kind":"command","name":"notify info","description":"Shows the number of notifications available","group":false,"args":[],"flags":[]},{"kind":"command","name":"notify show","description":"Show notifications","group":true,"args":[],"flags":[]},{"kind":"command","name":"notify show all","description":"Shows all notifications","group":false,"args":[],"flags":[]},{"kind":"command","name":"notify show unread","description":"Shows unread notifications","group":false,"args":[],"flags":[]},{"kind":"command","name":"notify test","description":"Fire a synthetic notification through the channel — for verifying chat rendering without an agent","group":false,"args":[{"name":"message","optional":false,"description":"Notification body text"}],"flags":[{"name":"mode","char":"","default":"toast","description":"Render mode: toast | inline | info | warning | error"}]}]},{"kind":"group","name":"open","children":[{"kind":"command","name":"open","description":"Shortcut for opening system related folders","group":false,"args":[{"name":"folder","optional":false,"description":"The name or path of the folder to open"}],"flags":[]}]},{"kind":"group","name":"ports","children":[{"kind":"command","name":"ports","description":"Lists ports registered by agents and the number of clients connected to each.","group":false,"args":[],"flags":[]}]},{"kind":"group","name":"random","children":[{"kind":"command","name":"random","description":"Random request commands","group":true,"args":[],"flags":[]},{"kind":"command","name":"random offline","description":"Issues a random request from a dataset of pre-generated requests.","group":false,"args":[],"flags":[]},{"kind":"command","name":"random online","description":"Uses the LLM to generate random requests.","group":false,"args":[],"flags":[]}]},{"kind":"group","name":"run","children":[{"kind":"command","name":"run","description":"Run a command script file","group":false,"args":[{"name":"input","optional":false,"description":"command script file path"}],"flags":[]}]},{"kind":"group","name":"session","children":[{"kind":"command","name":"session","description":"Session commands","group":true,"args":[],"flags":[]},{"kind":"command","name":"session clear","description":"Delete all data on the current sessions, keeping current settings","group":false,"args":[],"flags":[]},{"kind":"command","name":"session delete","description":"Delete a session. If no session is specified, delete the current session and start a new session.\n-a to delete all sessions","group":false,"args":[{"name":"session","optional":true,"description":"Session name to delete"}],"flags":[{"name":"all","char":"a","default":"","description":"Delete all sessions"}]},{"kind":"command","name":"session info","description":"Show info about the current session","group":false,"args":[],"flags":[]},{"kind":"command","name":"session list","description":"List all sessions. The current session is marked green.","group":false,"args":[],"flags":[]},{"kind":"command","name":"session new","description":"Create a new empty session","group":false,"args":[],"flags":[{"name":"keep","char":"","default":"false","description":"Copy the current session settings in the new session"},{"name":"persist","char":"","default":"","description":"Persist the new session.  Default to whether the current session is persisted."}]},{"kind":"command","name":"session open","description":"Open an existing session","group":false,"args":[{"name":"session","optional":false,"description":"Name of the session to open."}],"flags":[]},{"kind":"command","name":"session reset","description":"Reset config on session and keep the data","group":false,"args":[],"flags":[]}]},{"kind":"group","name":"settings","children":[{"kind":"command","name":"settings","description":"Persistent user settings","group":true,"args":[],"flags":[]},{"kind":"command","name":"settings conversation","description":"Conversation settings","group":true,"args":[],"flags":[]},{"kind":"command","name":"settings conversation resume","description":"Set whether to resume the last conversation on startup (true/false)","group":false,"args":[{"name":"value","optional":false,"description":"true or false"}],"flags":[]},{"kind":"command","name":"settings reset","description":"Reset all settings to defaults","group":false,"args":[],"flags":[]},{"kind":"command","name":"settings server","description":"Server startup settings","group":true,"args":[],"flags":[]},{"kind":"command","name":"settings server hidden","description":"Set whether the AgentServer starts hidden (true/false)","group":false,"args":[{"name":"value","optional":false,"description":"true or false"}],"flags":[]},{"kind":"command","name":"settings server idleTimeout","description":"Set idle timeout in seconds (0 to disable)","group":false,"args":[{"name":"seconds","optional":false,"description":"Timeout in seconds (0 = disabled)"}],"flags":[]},{"kind":"command","name":"settings show","description":"Show all persistent user settings","group":false,"args":[],"flags":[]},{"kind":"command","name":"settings ui","description":"UI settings","group":true,"args":[],"flags":[]},{"kind":"command","name":"settings ui autoComplete","description":"Set whether inline autocompletion is enabled in the CLI (true/false)","group":false,"args":[{"name":"value","optional":false,"description":"true or false"}],"flags":[]}]},{"kind":"group","name":"shutdown","children":[{"kind":"command","name":"shutdown","description":"Shut down the agent server and exit","group":false,"args":[],"flags":[]}]},{"kind":"group","name":"token","children":[{"kind":"command","name":"token","description":"Get LLM token usage statistics for this session.","group":true,"args":[],"flags":[]},{"kind":"command","name":"token details","description":"Gets detailed LLM usage statistics.","group":false,"args":[],"flags":[]},{"kind":"command","name":"token summary","description":"Get overall LLM usage statistics.","group":false,"args":[],"flags":[]}]},{"kind":"group","name":"trace","children":[{"kind":"command","name":"trace","description":"Enable or disable trace namespaces","group":false,"args":[{"name":"namespaces","optional":true,"description":"Namespaces to enable"}],"flags":[{"name":"clear","char":"*","default":"false","description":"Clear all trace namespaces"}]}]}]}}</script>
+<script id="data" type="application/json">{"generatedAt":"2026-07-29T14:39:02.927Z","counts":{"agents":33,"actions":557,"commands":411},"agents":{"kind":"root","name":"Agents","children":[{"kind":"category","name":"Music & Entertainment","emoji":"🎵","children":[{"kind":"agent","name":"localPlayer","emoji":"🎵","description":"Agent to play local music files","children":[{"kind":"action","name":"addToQueue","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Add a file or files to the playback queue","parameters":[{"name":"fileName","type":"string","optional":false,"description":"File name or path to add to queue"}],"phrasings":[]},{"kind":"action","name":"changeVolume","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Change volume by a relative amount","parameters":[{"name":"amount","type":"number","optional":false,"description":"Amount to change volume by (can be negative)"}],"phrasings":["turn down volume","turn up volume"]},{"kind":"action","name":"clearQueue","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Clear the playback queue","parameters":[],"phrasings":["clear queue"]},{"kind":"action","name":"listFiles","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"List audio files in the music folder or a specified folder","parameters":[{"name":"folderPath","type":"string","optional":true,"description":"Folder to list (defaults to music folder)"}],"phrasings":[]},{"kind":"action","name":"mute","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Mute or unmute audio","parameters":[{"name":"isMuted","type":"boolean","optional":false,"description":"true to mute, false to unmute"}],"phrasings":["unmute","mute"]},{"kind":"action","name":"next","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Skip to next track","parameters":[],"phrasings":["next"]},{"kind":"action","name":"pause","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Pause playback","parameters":[],"phrasings":["pause"]},{"kind":"action","name":"playFile","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Play a specific audio file by path or name","parameters":[{"name":"fileName","type":"string","optional":false,"description":"File name or path to play (can be partial match)"}],"phrasings":[]},{"kind":"action","name":"playFolder","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Play all audio files in a folder","parameters":[{"name":"folderPath","type":"string","optional":true,"description":"Folder path to play from"},{"name":"shuffle","type":"boolean","optional":true,"description":"Whether to shuffle the tracks"}],"phrasings":[]},{"kind":"action","name":"playFromQueue","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Play a specific track from the current queue by index","parameters":[{"name":"trackNumber","type":"number","optional":false,"description":"1-based index of the track in the queue"}],"phrasings":[]},{"kind":"action","name":"previous","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Go to previous track","parameters":[],"phrasings":["previous"]},{"kind":"action","name":"repeat","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Set repeat mode","parameters":[{"name":"mode","type":"\"off\" | \"one\" | \"all\"","optional":false,"description":"Repeat mode: \"off\", \"one\" (repeat current track), \"all\" (repeat queue)"}],"phrasings":[]},{"kind":"action","name":"resume","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Resume playback","parameters":[],"phrasings":["resume"]},{"kind":"action","name":"searchFiles","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Search for audio files by name","parameters":[{"name":"query","type":"string","optional":false,"description":"Search query to match against file names"}],"phrasings":[]},{"kind":"action","name":"setMusicFolder","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Set the default music folder path","parameters":[{"name":"folderPath","type":"string","optional":false,"description":"Path to the music folder"}],"phrasings":[]},{"kind":"action","name":"setVolume","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Set volume to a specific level (0-100)","parameters":[{"name":"level","type":"number","optional":false,"description":"New volume level (0-100)"}],"phrasings":[]},{"kind":"action","name":"showMusicFolder","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Show the current music folder path","parameters":[],"phrasings":[]},{"kind":"action","name":"showQueue","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Show the current playback queue","parameters":[],"phrasings":["show queue"]},{"kind":"action","name":"shuffle","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Turn shuffle on or off","parameters":[{"name":"on","type":"boolean","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"status","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Show now playing status including track information and playback state","parameters":[],"phrasings":["what 's"]},{"kind":"action","name":"stop","agent":"localPlayer","schema":"localPlayer","enabled":true,"transient":false,"description":"Stop playback completely","parameters":[],"phrasings":["stop"]}]},{"kind":"agent","name":"player","emoji":"🎧","description":"Agent to play music","children":[{"kind":"action","name":"addCurrentTrackToPlaylist","agent":"player","schema":"player","enabled":true,"transient":false,"description":"add the currently playing track to a playlist","parameters":[{"name":"name","type":"string","optional":false,"description":"name of playlist to add the current track to"}],"phrasings":[]},{"kind":"action","name":"addSongsToPlaylist","agent":"player","schema":"player","enabled":true,"transient":false,"description":"add songs to a playlist by specifying track names and optional artists this action searches for each song and adds it to the playlist","parameters":[{"name":"name","type":"string","optional":false,"description":"name of playlist to add songs to"},{"name":"songs","type":"{ … }[]","optional":false,"description":"list of songs to add, each specified by track name and optional artist/album"}],"phrasings":[]},{"kind":"action","name":"addToPlaylistFromCurrentTrackList","agent":"player","schema":"player","enabled":true,"transient":false,"description":"add to the named playlist one or more tracks starting at index 'trackNumber' in the current track list","parameters":[{"name":"name","type":"string","optional":false,"description":"name of playlist to add the track to"},{"name":"trackNumber","type":"number","optional":false,"description":"1-based index of the first track to add"},{"name":"trackCount","type":"number","optional":true,"description":"number of tracks to add (default 1) if specified, adds this many tracks starting from trackNumber; for example, to add tracks 3,4,5 set trackNumber=3 and trackCount=3"}],"phrasings":[]},{"kind":"action","name":"changeVolume","agent":"player","schema":"player","enabled":true,"transient":false,"description":"change volume plus or minus a specified percentage","parameters":[{"name":"volumeChangePercentage","type":"number","optional":false,"description":"volume change percentage"}],"phrasings":[]},{"kind":"action","name":"createPlaylist","agent":"player","schema":"player","enabled":true,"transient":false,"description":"create a new playlist, optionally with a list of songs specified by title and artist","parameters":[{"name":"name","type":"string","optional":false,"description":"name of playlist to create"},{"name":"songs","type":"{ … }[]","optional":true,"description":"optional list of songs to add to the playlist when creating it"}],"phrasings":[]},{"kind":"action","name":"deletePlaylist","agent":"player","schema":"player","enabled":true,"transient":false,"description":"delete a playlist","parameters":[{"name":"name","type":"string","optional":false,"description":"name of playlist to delete"}],"phrasings":[]},{"kind":"action","name":"findMusic","agent":"player","schema":"player","enabled":true,"transient":false,"description":"Find / search for / look up music and show it as the current track list WITHOUT starting playback. Use this for \"find\", \"look for\", \"search for\", \"show me\" music — a specific song, artist, album, genre, a free-form description (e.g. \"the best guitar solos\"), or playlists. To start playing immediately instead, use PlayMusicAction.","parameters":[{"name":"target","type":"PlayByTrack | PlayByArtist | PlayByAlbum | PlayByGenre | PlayByPlaylist | PlayByDescription | PlayAnyMusic","optional":false,"description":"What music to look for. Same choices as PlayMusicAction's target."},{"name":"play","type":"boolean","optional":true,"description":"Set true ONLY when the user asks to find something AND play it in the same breath (e.g. \"find some Bach and play it\"). Leave unset for a plain search / \"show me\"."},{"name":"quantity","type":"number","optional":true,"description":"number of tracks when the user asks for a specific amount"}],"phrasings":[]},{"kind":"action","name":"getAlbum","agent":"player","schema":"player","enabled":true,"transient":false,"description":"get currently playing album set the current track list the tracks in the album","parameters":[],"phrasings":[]},{"kind":"action","name":"getFavorites","agent":"player","schema":"player","enabled":true,"transient":false,"description":"result of this action is an entity of type 'track-list' with the user's favorites","parameters":[{"name":"count","type":"number","optional":true,"description":"number of favorites to get"}],"phrasings":[]},{"kind":"action","name":"getFromCurrentPlaylistList","agent":"player","schema":"player","enabled":true,"transient":false,"description":"","parameters":[{"name":"playlistNumber","type":"number","optional":false,"description":"1-base index of playlist in the current playlist list to get"}],"phrasings":[]},{"kind":"action","name":"getPlaylist","agent":"player","schema":"player","enabled":true,"transient":false,"description":"get playlist by name","parameters":[{"name":"name","type":"string","optional":false,"description":"name of playlist to get"}],"phrasings":[]},{"kind":"action","name":"getQueue","agent":"player","schema":"player","enabled":true,"transient":false,"description":"set the current track list to the queue of upcoming tracks","parameters":[],"phrasings":[]},{"kind":"action","name":"listDevices","agent":"player","schema":"player","enabled":true,"transient":false,"description":"list available playback devices","parameters":[],"phrasings":[]},{"kind":"action","name":"listPlaylists","agent":"player","schema":"player","enabled":true,"transient":false,"description":"list all playlists","parameters":[],"phrasings":[]},{"kind":"action","name":"next","agent":"player","schema":"player","enabled":true,"transient":false,"description":"next track","parameters":[],"phrasings":["skip track","skip","next"]},{"kind":"action","name":"pause","agent":"player","schema":"player","enabled":true,"transient":false,"description":"pause playback","parameters":[],"phrasings":["pause the music","pause music","pause"]},{"kind":"action","name":"playFromCurrentTrackList","agent":"player","schema":"player","enabled":true,"transient":false,"description":"play the track single track at index 'trackNumber' in the current track list report if there is no current track list","parameters":[{"name":"trackNumber","type":"number","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"playMusic","agent":"player","schema":"player","enabled":true,"transient":false,"description":"Start playing music now. Use this when the user wants to play / put on / start / listen to music — a specific song, artist, album, genre, a free-form description (e.g. \"chill music for studying\"), or just \"some music\". To search for or browse music WITHOUT starting playback, use FindMusicAction.","parameters":[{"name":"target","type":"PlayByTrack | PlayByArtist | PlayByAlbum | PlayByGenre | PlayByPlaylist | PlayByDescription | PlayAnyMusic","optional":false,"description":"What music to select. Pick the ONE variant that best matches what the user named. If it isn't clearly one artist / album / genre, use { kind: \"description\" } with the user's own words as the query."},{"name":"quantity","type":"number","optional":true,"description":"number of tracks when the user asks for a specific amount"}],"phrasings":[]},{"kind":"action","name":"playPlaylist","agent":"player","schema":"player","enabled":true,"transient":false,"description":"play the named play list","parameters":[{"name":"name","type":"string","optional":false,"description":"name of playlist to play"}],"phrasings":[]},{"kind":"action","name":"previous","agent":"player","schema":"player","enabled":true,"transient":false,"description":"previous track","parameters":[],"phrasings":[]},{"kind":"action","name":"resumePlayback","agent":"player","schema":"player","enabled":true,"transient":false,"description":"Resume or continue playback of the current track after it was paused or stopped. This simply un-pauses and keeps the current music going; it does not select a new song, so no specific song needs to be identified.","parameters":[],"phrasings":["resume the music","resume music","resume"]},{"kind":"action","name":"selectDevice","agent":"player","schema":"player","enabled":true,"transient":false,"description":"select playback device by keyword","parameters":[{"name":"deviceName","type":"string","optional":false,"description":"device name such as \"bedroom\", \"living room\", \"whole house\", \"office computer\", etc."}],"phrasings":[]},{"kind":"action","name":"setDefaultDevice","agent":"player","schema":"player","enabled":true,"transient":false,"description":"","parameters":[{"name":"deviceName","type":"string","optional":true,"description":"device name.  If not specified, the current selected device is set as the default."}],"phrasings":[]},{"kind":"action","name":"setMaxVolume","agent":"player","schema":"player","enabled":true,"transient":false,"description":"set max volume for the current device","parameters":[{"name":"newMaxVolumeLevel","type":"number","optional":false,"description":"new volume level"}],"phrasings":[]},{"kind":"action","name":"setVolume","agent":"player","schema":"player","enabled":true,"transient":false,"description":"set volume","parameters":[{"name":"newVolumeLevel","type":"number","optional":false,"description":"new volume level"}],"phrasings":[]},{"kind":"action","name":"showSelectedDevice","agent":"player","schema":"player","enabled":true,"transient":false,"description":"show the selected playback device","parameters":[],"phrasings":[]},{"kind":"action","name":"shuffle","agent":"player","schema":"player","enabled":true,"transient":false,"description":"turn shuffle on or off","parameters":[{"name":"on","type":"boolean","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"status","agent":"player","schema":"player","enabled":true,"transient":false,"description":"show now playing including track information, and playback status including playback device","parameters":[],"phrasings":[]}]}]},{"kind":"category","name":"Creative & Media","emoji":"🎨","children":[{"kind":"agent","name":"image","emoji":"🖼️","description":"Agent to create AI images","children":[{"kind":"action","name":"createImageAction","agent":"image","schema":"image","enabled":true,"transient":false,"description":"creates an image based on the supplied description","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"},{"name":"caption","type":"string","optional":false,"description":"the image caption"},{"name":"numImages","type":"number","optional":false,"description":"the number of images to generate"}],"phrasings":[]},{"kind":"action","name":"editImageAction","agent":"image","schema":"image","enabled":true,"transient":false,"description":"Edits / transforms an image the user has already supplied (typically the most recent attachment). Use this for requests like \"cartoonize that image\", \"make a watercolor version of this photo\", \"stylize this as a pencil sketch\", etc.","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"},{"name":"editPrompt","type":"string","optional":false,"description":"The natural-language description of the edit to perform (e.g. \"cartoonize\", \"make this a watercolor painting\")."},{"name":"sourceImage","type":"string","optional":false,"description":"The file name of the source image to edit. This MUST be the exact name of an image that is either (a) attached to the current request, or (b) listed as an image entity from a recent turn (e.g. `generated_images/\u003cuuid>.png` from a prior editImageAction / createImageAction result). NEVER invent a filename — if no such image is available, do not emit this action; ask the user to attach an image instead."}],"phrasings":[]}]},{"kind":"agent","name":"markdown","emoji":"🗎","description":"Agent to create and update markdown files","children":[{"kind":"action","name":"createDocument","agent":"markdown","schema":"markdown","enabled":true,"transient":false,"description":"creates a new markdown document","parameters":[{"name":"name","type":"string","optional":false,"description":"the name to use for the document"}],"phrasings":[]},{"kind":"action","name":"openDocument","agent":"markdown","schema":"markdown","enabled":true,"transient":false,"description":"opens an existing markdown document","parameters":[{"name":"name","type":"string","optional":false,"description":"the name to use for the document"}],"phrasings":[]},{"kind":"action","name":"streamingUpdateDocument","agent":"markdown","schema":"markdown","enabled":true,"transient":false,"description":"Updates the document with streaming support for real-time AI operations","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"},{"name":"cursorPosition","type":"number","optional":true,"description":"cursor position where the user invoked the command"},{"name":"context","type":"string","optional":true,"description":"additional context information from the editor (serialized as JSON string)"},{"name":"generatedContent","type":"string","optional":true,"description":"Stream-friendly properties that can be updated incrementally"},{"name":"progressStatus","type":"string","optional":true,"description":""},{"name":"validationResults","type":"string","optional":true,"description":""},{"name":"aiCommand","type":"\"continue\" | \"diagram\" | \"augment\" | \"research\"","optional":true,"description":"AI command type for specialized processing"}],"phrasings":[]},{"kind":"action","name":"updateDocument","agent":"markdown","schema":"markdown","enabled":true,"transient":false,"description":"Updates the document by adding, removing or editing parts of the document.","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"},{"name":"cursorPosition","type":"number","optional":true,"description":"cursor position where the user invoked the command"},{"name":"context","type":"string","optional":true,"description":"additional context information from the editor (serialized as JSON string)"}],"phrasings":[]}]},{"kind":"agent","name":"montage","emoji":"🎞","description":"Agent to create photo montages.","children":[{"kind":"action","name":"addPhotos","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"add photos to the montage","parameters":[{"name":"title","type":"string","optional":false,"description":"title of the montage"},{"name":"files","type":"string[]","optional":true,"description":"placeholder for images to be populated later"},{"name":"search_filters","type":"string[]","optional":true,"description":"always empty"}],"phrasings":[]},{"kind":"action","name":"changeTitle","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Changes the montage title","parameters":[{"name":"title","type":"string","optional":false,"description":"current title of the montage to change"},{"name":"newTitle","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"clearSelectedPhotos","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Clears the currently selected images","parameters":[{"name":"title","type":"string","optional":false,"description":"title of the montage"}],"phrasings":[]},{"kind":"action","name":"createNewMontage","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Creates a new montage","parameters":[{"name":"title","type":"string","optional":false,"description":"Montage title, defaults to \"Untitled\""},{"name":"search_filters","type":"string[]","optional":true,"description":"any search terms to use to seed the montage based off of the title"},{"name":"focus","type":"boolean","optional":false,"description":"a flag indicating if the UI should immediately switch to this montage, defaults to true"},{"name":"files","type":"string[]","optional":true,"description":"placeholder for images to be populated later"}],"phrasings":[]},{"kind":"action","name":"deleteAllMontages","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"deleteMontage","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Deletes the identified montage","parameters":[{"name":"title","type":"string","optional":false,"description":"The title of the montage to delete"}],"phrasings":[]},{"kind":"action","name":"listMontages","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Lists all montages by name","parameters":[],"phrasings":[]},{"kind":"action","name":"mergeMontages","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Merges two or more montages together","parameters":[{"name":"mergedMontageTitle","type":"string","optional":false,"description":"The title of the merged montage"},{"name":"titles","type":"string[]","optional":true,"description":"The titles of the montages to merge"},{"name":"ids","type":"number[]","optional":true,"description":"THe ids of the montages to merge"}],"phrasings":[]},{"kind":"action","name":"openMontage","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Open a montage for viewing and editing","parameters":[{"name":"title","type":"string","optional":false,"description":"title of the montage"}],"phrasings":[]},{"kind":"action","name":"removePhotos","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Removes the images that match the supplied criteria","parameters":[{"name":"title","type":"string","optional":false,"description":"title of the montage"},{"name":"search_filters","type":"string[]","optional":true,"description":"any search terms to use indicating the photos to remove"},{"name":"indices","type":"number[]","optional":true,"description":"any indices provided indicating the photos to remove from the set of available images"},{"name":"selected","type":"\"selected\" | \"inverse\" | \"all\"","optional":true,"description":"flag indicating if we are remove selected images or inverse"},{"name":"files","type":"string[]","optional":true,"description":"placeholder for images to be populated later"}],"phrasings":[]},{"kind":"action","name":"selectPhotos","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Select images in an existing montage","parameters":[{"name":"title","type":"string","optional":false,"description":"title of the montage"},{"name":"search_filters","type":"string[]","optional":true,"description":"any search terms to use indicating the photos to remove"},{"name":"indices","type":"number[]","optional":true,"description":"any indices provided indicating the photos to remove from the set of available images"},{"name":"files","type":"string[]","optional":true,"description":"placeholder for images to be populated later"}],"phrasings":[]},{"kind":"action","name":"setMontageViewMode","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"","parameters":[{"name":"viewMode","type":"\"grid\" | \"filmstrip\"","optional":false,"description":"The view mode to set"}],"phrasings":[]},{"kind":"action","name":"setSearchParameters","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Update search parameters","parameters":[{"name":"minSearchScore","type":"number","optional":true,"description":"search score value starts at 0"},{"name":"exactMatch","type":"boolean","optional":true,"description":"only return exact matches?"}],"phrasings":[]},{"kind":"action","name":"showSearchParameters","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Shows search parameters","parameters":[],"phrasings":[]},{"kind":"action","name":"startSlideShow","agent":"montage","schema":"montage","enabled":true,"transient":false,"description":"Starts a slide show with the images in the active montage","parameters":[{"name":"title","type":"string","optional":false,"description":""}],"phrasings":[]}]},{"kind":"agent","name":"photo","emoji":"📷","description":"Agent to take and upload photos","children":[{"kind":"action","name":"takePhoto","agent":"photo","schema":"photo","enabled":true,"transient":false,"description":"uses a camera attached to the system to take a photo","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"}],"phrasings":[]}]},{"kind":"agent","name":"screencapture","emoji":"🎥","description":"Take screenshots and record the screen or specific application windows","children":[{"kind":"action","name":"listWindows","agent":"screencapture","schema":"screencapture","enabled":true,"transient":false,"description":"List all currently visible windows so the user can target them by name.","parameters":[],"phrasings":["programs are running","windows are open","show me open windows","open windows","windows"]},{"kind":"action","name":"recording","agent":"screencapture","schema":"screencapture","enabled":true,"transient":false,"description":"Activity type tracked while a recording is in progress.","parameters":[{"name":"target","type":"string","optional":true,"description":""},{"name":"outputPath","type":"string","optional":false,"description":""},{"name":"startedAtMs","type":"number","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"startRecording","agent":"screencapture","schema":"screencapture","enabled":true,"transient":false,"description":"Start a screen recording. Same `target` semantics as takeScreenshot. Only one recording can be active at a time.","parameters":[{"name":"target","type":"string","optional":true,"description":""}],"phrasings":["record {target}","begin recording {target}","start recording {target}","desktop","screen","begin recording screen","a screen recording","recording"]},{"kind":"action","name":"stopRecording","agent":"screencapture","schema":"screencapture","enabled":true,"transient":false,"description":"Stop the currently active screen recording.","parameters":[],"phrasings":["finish recording","end recording","the recording","recording"]},{"kind":"action","name":"takeScreenshot","agent":"screencapture","schema":"screencapture","enabled":true,"transient":false,"description":"Take a screenshot. If `target` is omitted the whole primary screen is captured; otherwise `target` is a program or window name to fuzzy-match against the currently visible windows (e.g. \"Chrome\", \"Visual Studio\").","parameters":[{"name":"target","type":"string","optional":true,"description":""}],"phrasings":["screenshot {target}","capture {target}","take a screenshot of {target}","desktop","screen","capture screen","take a screenshot"]}]},{"kind":"agent","name":"video","emoji":"📹","description":"Agent to create AI videos","children":[{"kind":"action","name":"createVideoAction","agent":"video","schema":"video","enabled":true,"transient":false,"description":"creates a video based on the supplied description","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"},{"name":"caption","type":"string","optional":false,"description":"the video caption"},{"name":"relatedFiles","type":"string[]","optional":true,"description":"The file names of any attachments the user provided"},{"name":"duration","type":"\"4\" | \"8\" | \"12\"","optional":true,"description":"The duration in seconds (default is 4 seconds)"}],"phrasings":[]}]}]},{"kind":"category","name":"Productivity","emoji":"📅","children":[{"kind":"agent","name":"calendar","emoji":"📅","description":"Agent integration with MS Graph's calendar","children":[{"kind":"action","name":"addParticipant","agent":"calendar","schema":"calendar","enabled":true,"transient":false,"description":"Add a participant to an event Examples: \"add John to the meeting\", \"invite Sarah to lunch\"","parameters":[{"name":"description","type":"string","optional":false,"description":"Which event to add to (required) - plain string"},{"name":"participant","type":"string","optional":false,"description":"Who to add (required) - plain string"}],"phrasings":["include {participant} in {description}"]},{"kind":"action","name":"findEvents","agent":"calendar","schema":"calendar","enabled":true,"transient":false,"description":"Find events on the calendar Examples: \"find my meetings today\", \"show meetings with Bob\"","parameters":[{"name":"date","type":"string","optional":true,"description":"When to search (optional, defaults to future events) Use the user's EXACT words like \"today\", \"tomorrow\", \"this week\" - do NOT convert to ISO date"},{"name":"description","type":"string","optional":true,"description":"What type of event to find (optional, finds all if not specified) - plain string"},{"name":"participant","type":"string","optional":true,"description":"Find events with a specific participant (optional) - plain string"}],"phrasings":["what events do I have with {participant} on {date} about {description}","show me meetings about {description} scheduled for {date}","find all events on {date} that include {participant}"]},{"kind":"action","name":"findThisWeeksEvents","agent":"calendar","schema":"calendar","enabled":true,"transient":false,"description":"Find all events happening this week Examples: \"what do I have this week\", \"show my week\"","parameters":[],"phrasings":["find what I have scheduled this week","show me all my events for this week starting {startDay}","what's happening this week"]},{"kind":"action","name":"findTodaysEvents","agent":"calendar","schema":"calendar","enabled":true,"transient":false,"description":"Find all events happening today Examples: \"what do I have today\", \"show me today's schedule\"","parameters":[],"phrasings":["what I have scheduled for today","show me all my appointments and meetings for {date}","what's on my calendar {date}"]},{"kind":"action","name":"removeEvent","agent":"calendar","schema":"calendar","enabled":true,"transient":false,"description":"Remove an event from the calendar Examples: \"delete my meeting\", \"remove the dentist appointment\", \"cancel lunch with Bob\" Behavior based on number of matches: - 1 match: prompts for confirmation - 2-5 matches: prompts with list to select which event to delete - More than 5 matches: returns error asking user to be more specific","parameters":[{"name":"description","type":"string","optional":false,"description":"What event to remove (required) - plain string describing the event"},{"name":"date","type":"string","optional":true,"description":"Optional date filter to narrow down which event to remove Use the user's EXACT words like \"today\", \"tomorrow\", \"this week\" - do NOT convert to ISO date"}],"phrasings":[]},{"kind":"action","name":"scheduleEvent","agent":"calendar","schema":"calendar","enabled":true,"transient":false,"description":"Schedule a new event on the calendar Examples: \"schedule a meeting tomorrow at 2pm\", \"add dentist appointment on Friday at 3pm\"","parameters":[{"name":"description","type":"string","optional":false,"description":"What the event is about (required) - plain string, not an entity type"},{"name":"date","type":"string","optional":false,"description":"When the event occurs (required) - use the user's EXACT words like \"today\", \"tomorrow\", \"Friday\", \"next week\" Do NOT convert to ISO date format - the handler will parse temporal expressions"},{"name":"time","type":"string","optional":true,"description":"What time the event starts (optional, defaults to all-day if not specified) Use the user's EXACT words like \"2pm\", \"3:30\", \"noon\" - do NOT convert formats"},{"name":"location","type":"string","optional":true,"description":"Where the event takes place (optional) - plain string, not an entity type"},{"name":"participant","type":"string","optional":true,"description":"Who else should attend (optional, single participant) - plain string, not an entity type"}],"phrasings":["book {description} with {participant} at {location} {date} at {time}","set up {description} on {date} at {time}","schedule a {description} for {date} at {time} in {location} with {participant}"]}]},{"kind":"agent","name":"email","emoji":"📩","description":"Agent integration with MS Graph's email","children":[{"kind":"action","name":"findEmail","agent":"email","schema":"email","enabled":true,"transient":false,"description":"Type for finding an email message (search for emails)","parameters":[{"name":"messageRef","type":"{ senders, subject, content, receivedDateTime, srcFolder, destfolder }","optional":false,"description":"Reference to the email message to find"}],"phrasings":[]},{"kind":"action","name":"forwardEmail","agent":"email","schema":"email","enabled":true,"transient":false,"description":"Type for forwarding an email","parameters":[{"name":"to","type":"string[]","optional":false,"description":"Recipients"},{"name":"cc","type":"string[]","optional":true,"description":"Carbon copy recipients (optional)"},{"name":"bcc","type":"string[]","optional":true,"description":"Blind carbon copy recipients (optional)"},{"name":"additionalMessage","type":"string","optional":true,"description":"Additional message (optional), can be plain text or HTML and inferred from the user request"},{"name":"messageRef","type":"{ senders, subject, content, receivedDateTime, srcFolder, destfolder }","optional":false,"description":"Reference to the email message to forward"}],"phrasings":[]},{"kind":"action","name":"replyEmail","agent":"email","schema":"email","enabled":true,"transient":false,"description":"Type for replying to an email","parameters":[{"name":"body","type":"string","optional":true,"description":"Body content of the reply email (optional), can be plain text or HTML, generate the body based on the user input"},{"name":"cc","type":"string[]","optional":true,"description":"Carbon copy recipients (optional)"},{"name":"bcc","type":"string[]","optional":true,"description":"Blind carbon copy recipients (optional)"},{"name":"attachments","type":"string[]","optional":true,"description":"File paths or URLs of attachments (optional)"},{"name":"messageRef","type":"{ senders, subject, content, receivedDateTime, srcFolder, destfolder }","optional":false,"description":"Reference to the email message to reply to"}],"phrasings":[]},{"kind":"action","name":"sendEmail","agent":"email","schema":"email","enabled":true,"transient":false,"description":"Type for sending a simple email","parameters":[{"name":"subject","type":"string","optional":false,"description":"Subject of the email, infer the subject based on the user input"},{"name":"body","type":"string","optional":true,"description":"Body content of the email, can be plain text or HTML, generate the body based on the user input"},{"name":"to","type":"string[]","optional":false,"description":"Recipients, infer the recipients based on the user input but don't change strings so if the user types \"send email to Jen\" don't change it to an email address, just infer that \"Jen\" is one of the recipients"},{"name":"cc","type":"string[]","optional":true,"description":"Carbon copy recipients (optional), infere CC recipients based on the user input"},{"name":"bcc","type":"string[]","optional":true,"description":"Blind carbon copy recipients (optional), infer the BCC recipients based on the user input"},{"name":"attachments","type":"string[]","optional":true,"description":"File paths or URLs of attachments (optional)"},{"name":"genContent","type":"{ generateBody, bodySearchQuery }","optional":false,"description":"Information needed to generate the body content based on the user input"}],"phrasings":[]}]},{"kind":"agent","name":"list","emoji":"📝","description":"Agent to create and manage lists","children":[{"kind":"action","name":"addItems","agent":"list","schema":"list","enabled":true,"transient":false,"description":"add one or more items to a list; if the list does not exist, create it","parameters":[{"name":"items","type":"string[]","optional":false,"description":""},{"name":"listName","type":"string","optional":false,"description":"name of the list such as \"grocery\", \"to do\", \"shopping\", \"packing\", \"gift\",\"book\",\"idea\",\"movie\",\"garden task\",\"place to visit\" names should be lower case and should be stemmed to the singular form (e.g., \"movies\" should be \"movie\") IMPORTANT: Do not invent a list name. If the user uses a reference phrase (\"the list\", \"that list\",etc.) we should clarify with the user which list they meant unless it is obvious from the conversation history."}],"phrasings":[]},{"kind":"action","name":"clearList","agent":"list","schema":"list","enabled":true,"transient":false,"description":"","parameters":[{"name":"listName","type":"string","optional":false,"description":""}],"phrasings":["delete from {listName} list","empty {listName}","clear {listName} list"]},{"kind":"action","name":"createList","agent":"list","schema":"list","enabled":true,"transient":false,"description":"","parameters":[{"name":"listName","type":"string","optional":false,"description":""}],"phrasings":["start {listName} list","make {listName} list","create {listName} list"]},{"kind":"action","name":"getList","agent":"list","schema":"list","enabled":true,"transient":false,"description":"use this action to show the user what's on the list, for example, \"What's on my grocery list?\" or \"what are the contents of my to do list?\"","parameters":[{"name":"listName","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"listLists","agent":"list","schema":"list","enabled":true,"transient":false,"description":"use this action to show the user which lists exist, for example, \"what lists are there?\", \"show me my lists\", \"what lists do I have?\"","parameters":[],"phrasings":["what lists","list lists"]},{"kind":"action","name":"removeItems","agent":"list","schema":"list","enabled":true,"transient":false,"description":"remove one or more items from a list","parameters":[{"name":"items","type":"string[]","optional":false,"description":""},{"name":"listName","type":"string","optional":false,"description":""}],"phrasings":["take {item} off {listName}","delete {item} from {listName}","remove {item} from {listName} list"]},{"kind":"action","name":"startEditList","agent":"list","schema":"list","enabled":true,"transient":false,"description":"","parameters":[{"name":"listName","type":"string","optional":false,"description":""}],"phrasings":[]}]},{"kind":"agent","name":"timer","emoji":"⏰","description":"Agent for setting reminders that fire as agent-initiated messages","children":[{"kind":"action","name":"cancelReminder","agent":"timer","schema":"timer","enabled":true,"transient":false,"description":"Cancel a pending reminder by id, or all reminders.","parameters":[{"name":"id","type":"string","optional":false,"description":"The reminder id (returned from setReminder), or \"all\" to cancel every pending reminder."}],"phrasings":["clear reminders","all reminders"]},{"kind":"action","name":"listReminders","agent":"timer","schema":"timer","enabled":true,"transient":false,"description":"List all pending reminders.","parameters":[],"phrasings":["what reminders","reminders"]},{"kind":"action","name":"repeatReminder","agent":"timer","schema":"timer","enabled":true,"transient":false,"description":"Set a repeating reminder. Fires every `every` interval until cancelled (or until `count` fires have elapsed if specified). Useful for stress testing rapid-fire / back-to-back agent-initiated messages.","parameters":[{"name":"message","type":"string","optional":false,"description":"What to remind the user about."},{"name":"every","type":"string","optional":false,"description":"Interval between fires. Same format as SetReminder.when — a duration like \"5s\", \"10m\", \"1h\"."},{"name":"kind","type":"\"bubble\" | \"toast\" | \"inline\"","optional":true,"description":"Render style for each fire. Defaults to \"bubble\"."},{"name":"count","type":"number","optional":true,"description":"Optional max number of times to fire. If omitted, fires until explicitly cancelled."}],"phrasings":["inline","toast"]},{"kind":"action","name":"setReminder","agent":"timer","schema":"timer","enabled":true,"transient":false,"description":"Set a reminder. When it fires, the timer agent pushes a message to the user via SessionContext.beginAgentThread (an agent-initiated thread, not a response to a user request).","parameters":[{"name":"message","type":"string","optional":false,"description":"What to remind the user about."},{"name":"when","type":"string","optional":false,"description":"When to fire. Either a duration like \"5s\", \"10m\", \"1h\", \"30 minutes\", or an absolute ISO 8601 timestamp like \"2026-05-04T15:30:00\"."},{"name":"kind","type":"\"bubble\" | \"toast\" | \"inline\"","optional":true,"description":"How the fired reminder should render. Defaults to \"bubble\"."}],"phrasings":["bubble","inline","toast"]}]}]},{"kind":"category","name":"Communication","emoji":"💬","children":[{"kind":"agent","name":"chat","emoji":"💬","description":"Agent for conversation and information lookup","children":[{"kind":"action","name":"generateResponse","agent":"chat","schema":"chat","enabled":true,"transient":false,"description":"this is the way to handle requests for known information that is not stored in application memory or conversation memory, such as facts, definitions, explanations, captioning, or other information that can be generated without a lookup if the user request is a known phrase that is unrelated to the context, use this action to generate an explanation for the known phrase. this action is never used when the request is for private information from past conversations including private events, plans, projects in progress, and other items from discussions with team members or the assistant, unless the information is present in the chat history","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request from the user"},{"name":"generatedText","type":"string","optional":false,"description":"the generated text to show the user; this should be a complete response to the user's request"},{"name":"userRequestEntities","type":"{ … }[]","optional":false,"description":"ALL the actions and entities present in the text of the user's request including attachments"},{"name":"generatedTextEntities","type":"{ … }[]","optional":false,"description":"ALL the actions and entities present in the generated text"},{"name":"relatedFiles","type":"string[]","optional":true,"description":"The file names of any attachments"}],"phrasings":[]},{"kind":"action","name":"showImageFile","agent":"chat","schema":"chat","enabled":true,"transient":false,"description":"","parameters":[{"name":"files","type":"string[]","optional":false,"description":"file entities."}],"phrasings":[]}]},{"kind":"agent","name":"discord","emoji":"💬","description":"Discord chat agent — send messages, draft messages from intent, list channels, browse channel history, manage server/channel invites.","children":[{"kind":"action","name":"addThreadMember","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Add another member to a thread.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the thread."},{"name":"user_id","type":"string","optional":false,"description":"The ID of the user to add."}],"phrasings":["bring {user_id} into thread {channel_id}","include {user_id} in thread {channel_id}","invite {user_id} to thread {channel_id}","add user {user_id} to thread {channel_id}"]},{"kind":"action","name":"craftMessage","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Drafts a message via LLM from a high-level intent, then posts it. Use when the user describes what the message should convey (\"that ...\", \"to ...\", \"about ...\", \"reminding ...\", \"asking ...\") instead of supplying literal content. Sample phrases: - \"Send a message to #general that welcomes everyone to the discord\" - \"Send a message to #general to remind everyone about tonight's plans\" - \"Post a message in #announcements about the new release\" - \"Write a message in #random asking who's free tomorrow\" - \"Send a message in #events reminding people to RSVP\"","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"Single channel token (ID, bare name, or \"#name\"). Must not contain spaces — anything after the channel belongs in `intent`."},{"name":"intent","type":"string","optional":false,"description":"What the message should convey — everything the user said about the message after the channel and connector word."},{"name":"tts","type":"boolean","optional":true,"description":"Whether the message should be sent as text-to-speech."}],"phrasings":["create a message in {channel_id} that {intent}","write a message to {channel_id} that {intent}","post a message to {channel_id} that {intent}","send a message to {channel_id} that {intent}"]},{"kind":"action","name":"createChannelInvite","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Create a new invite for a channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID or name of the channel."},{"name":"max_age","type":"number","optional":true,"description":"Duration of invite in seconds (0 = never expires)."},{"name":"never_expires","type":"boolean","optional":true,"description":"If true, the invite never expires (sets max_age to 0)."},{"name":"max_uses","type":"number","optional":true,"description":"Max number of uses (0 = unlimited)."},{"name":"temporary","type":"boolean","optional":true,"description":"Whether the invite is temporary."},{"name":"unique","type":"boolean","optional":true,"description":"Whether the invite is unique."}],"phrasings":["I need an invite for channel {channel_id}","generate a invite for channel {channel_id}","make a invite for {channel_id} that doesn't expire","make a invite for channel {channel_id}","create a permanent invite for {channel_id}","create a invite for {channel_id} that doesn't expire","create a invite for channel {channel_id}"]},{"kind":"action","name":"createDM","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Create a new DM channel with a user. Returns a DM channel object. Sample phrases: - \"Can you start a direct message with user ID 123456?\" - \"I'd like to create a DM channel with the user whose ID is 123456.\" - \"Please open a new DM with the user having the ID 123456.\"","parameters":[{"name":"recipient_id","type":"string","optional":false,"description":"The ID of the recipient user."}],"phrasings":["message user {recipient_id}","DM user {recipient_id}","create a DM with user {recipient_id}","start a direct message with {recipient_id}"]},{"kind":"action","name":"createGroupDM","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Create a new group DM channel with multiple users. Returns a DM channel object. Sample phrases: - \"Can you start a new group DM with these friends?\" - \"Create a group chat with these people, please.\" - \"I'd like to set up a group DM with my buddies.\"","parameters":[{"name":"access_tokens","type":"string[]","optional":true,"description":"The access tokens for the users to be added to the group DM."},{"name":"nicks","type":"string","optional":true,"description":"Comma-separated nickname mappings (e.g. \"userId1:nick1,userId2:nick2\")."}],"phrasings":["make a group DM","start a group direct message {access_tokens}","set up a group chat {access_tokens}","start a group DM"]},{"kind":"action","name":"createGuild","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Creates a new guild. Sample phrases: - \"Can you create a new guild for me called 'Knights of Valor' in the US region with this icon?\" - \"I need a new guild named 'Dragon Slayers' in the EU region. Use this icon for it.\" - \"Please set up a guild called 'Mystic Warriors' in the Asia region and use this icon.\"","parameters":[{"name":"name","type":"string","optional":false,"description":"The name of the guild."},{"name":"region","type":"string","optional":true,"description":"The region where the guild will be created."},{"name":"icon","type":"string","optional":true,"description":"The icon for the guild."}],"phrasings":["make a guild called {name}","I need a new guild called {name}","set up a guild called {name}","create a guild called {name}"]},{"kind":"action","name":"createMessage","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Creates a new message in a specified channel. Sample phrases: - \"Send a message to the general channel saying 'Hello everyone!'\" - \"Post 'Meeting starts at 3 PM' in the announcements channel, please.\" - \"Can you create a new message in the #updates channel with the text 'New features are live!'?\"","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel where the message will be sent."},{"name":"content","type":"string","optional":false,"description":"The content of the message."},{"name":"nonce","type":"string","optional":true,"description":"A unique identifier for the message."},{"name":"tts","type":"boolean","optional":true,"description":"Whether the message should be sent as text-to-speech."}],"phrasings":[]},{"kind":"action","name":"createWebhook","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Creates a new webhook in a specified channel. Sample phrases: - \"Can you set up a new webhook in the channel with ID 12345? Name it 'Updates' and use the avatar image from this link.\" - \"Please create a webhook named 'Alerts' in the channel 67890 and use this avatar for it.\" - \"I need a new webhook in channel 54321 called 'Notifications'. Use this avatar image for it.\"","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel where the webhook will be created."},{"name":"name","type":"string","optional":false,"description":"The name of the webhook."},{"name":"avatar","type":"string","optional":true,"description":"The avatar for the webhook."}],"phrasings":["add a webhook called {name} to channel {channel_id}","I need a webhook called {name} in channel {channel_id}","make a webhook called {name} in channel {channel_id}","create a webhook called {name} in channel {channel_id}"]},{"kind":"action","name":"deleteChannel","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Delete a channel or close a private message.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel to delete."}],"phrasings":["destroy channel {channel_id}","I want to delete channel {channel_id}","remove channel {channel_id}","delete channel {channel_id}"]},{"kind":"action","name":"deleteChannelPermission","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Delete a permission overwrite from a channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel."},{"name":"overwrite_id","type":"string","optional":false,"description":"The ID of the overwrite to delete."}],"phrasings":["clear permission {overwrite_id} from channel {channel_id}","revoke permission {overwrite_id} from channel {channel_id}","remove permission override {overwrite_id} from channel {channel_id}","delete permission {overwrite_id} from channel {channel_id}"]},{"kind":"action","name":"deleteInvite","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Delete an invite. Requires the MANAGE_CHANNELS permission on the channel this invite belongs to, or MANAGE_GUILD to remove any invite across the guild. Sample phrases: - \"Can you delete the invite with code ABC123?\" - \"Please remove the invite link with the code XYZ789.\" - \"I need you to delete the invite that has the code LMN456.\"","parameters":[{"name":"invite_code","type":"string","optional":false,"description":"The code of the invite to delete."}],"phrasings":["revoke invite {invite_code}","I need you to delete invite {invite_code}","remove invite {invite_code}","delete invite {invite_code}"]},{"kind":"action","name":"editChannelPermissions","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Edit the permissions of a channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel."},{"name":"overwrite_id","type":"string","optional":true,"description":"The ID of the overwrite (user or role)."},{"name":"allow","type":"string","optional":true,"description":"The allow permission bitfield."},{"name":"deny","type":"string","optional":true,"description":"The deny permission bitfield."},{"name":"type","type":"number","optional":true,"description":"The type of the overwrite (0 = role, 1 = member)."}],"phrasings":["configure permissions for channel {channel_id}","set permissions for channel {channel_id}","update permissions for channel {channel_id}","edit permissions for channel {channel_id}"]},{"kind":"action","name":"executeWebhook","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Executes a webhook, sending a message to the channel. Sample phrases: - \"Send a message using the webhook with ID 12345 and token abcde. The content should be 'Hello everyone!', and use the username 'Bot' with the avatar URL 'http://example.com/avatar.png'. Make it a TTS message.\" - \"Can you execute the webhook with ID 12345 and token abcde? The message should say 'Hello everyone!', and use the username 'Bot' with the avatar 'http://example.com/avatar.png'. Also, make it a TTS message.\" - \"Please trigger the webhook with ID 12345 and token abcde to send a message saying 'Hello everyone!'. Use 'Bot' as the username and 'http://example.com/avatar.png' as the avatar. Enable TTS for this message.\"","parameters":[{"name":"webhook_id","type":"string","optional":false,"description":"The ID of the webhook to execute."},{"name":"webhook_token","type":"string","optional":false,"description":"The token for the webhook."},{"name":"content","type":"string","optional":true,"description":"The content of the message."},{"name":"username","type":"string","optional":true,"description":"The username to use for the message."},{"name":"avatar_url","type":"string","optional":true,"description":"The avatar URL to use for the message."},{"name":"tts","type":"boolean","optional":true,"description":"Whether the message should be sent as text-to-speech."}],"phrasings":["fire webhook {webhook_id} token {webhook_token} with message {content}","trigger webhook {webhook_id} token {webhook_token} to send {content}","send a message using webhook {webhook_id} token {webhook_token} saying {content}","execute webhook {webhook_id} with token {webhook_token} saying {content}"]},{"kind":"action","name":"followAnnouncementChannel","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Follow an announcement channel to receive crossposted messages.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the announcement channel to follow."},{"name":"webhook_channel_id","type":"string","optional":false,"description":"The ID of the channel to receive crossposted messages."}],"phrasings":["crosspost announcement channel {channel_id} to {webhook_channel_id}","forward announcements from {channel_id} to {webhook_channel_id}","subscribe to announcement channel {channel_id} sending to {webhook_channel_id}","follow announcement channel {channel_id} in {webhook_channel_id}"]},{"kind":"action","name":"getChannel","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Get a channel by ID. Returns a channel object.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel to fetch."}],"phrasings":["look up channel {channel_id}","I need channel details for {channel_id}","show me channel {channel_id}","get details for channel {channel_id}"]},{"kind":"action","name":"getChannelInvites","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Get all invites for a channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel."}],"phrasings":["what invites are there for channel {channel_id}","get invites for channel {channel_id}","list invites on channel {channel_id}","show channel {channel_id} invites"]},{"kind":"action","name":"getChannelMessages","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Fetches messages from a specified channel. Sample phrases: - \"Can you show me the latest messages from the channel with ID 12345?\" - \"Fetch the last 50 messages from the channel 67890, please.\" - \"Get messages from the channel 54321, but only those sent after yesterday.\"","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel from which to fetch messages."},{"name":"limit","type":"number","optional":true,"description":"The maximum number of messages to return."},{"name":"before","type":"string","optional":true,"description":"Get messages before this message ID."},{"name":"after","type":"string","optional":true,"description":"Get messages after this message ID."}],"phrasings":[]},{"kind":"action","name":"getCurrentUser","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Returns the user object of the requester's account. Sample phrases: - \"Can you show me my account details?\" - \"What's my user info?\" - \"Get my profile information, please.\"","parameters":[],"phrasings":["who am I","get my profile","what's my user info","show me my account"]},{"kind":"action","name":"getCurrentUserApplicationRoleConnection","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Returns the application role connection for the user. Sample phrases: - \"Can you show me my role connection for the app with ID 123456?\" - \"What's my application role connection for the app with ID 123456?\" - \"Please get my role connection for the application with ID 123456.\"","parameters":[{"name":"application_id","type":"string","optional":false,"description":"The ID of the application to fetch the role connection for."}],"phrasings":["fetch my role connection for app {application_id}","get my role connection for application {application_id}","what's my role connection for app {application_id}","show me my role connection for app {application_id}"]},{"kind":"action","name":"getCurrentUserConnections","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Returns a list of connection objects. Sample phrases: - \"Can you show me my current connections?\" - \"What are my linked accounts right now?\" - \"I'd like to see my active connections, please.\"","parameters":[],"phrasings":["list my connections","see my connections","what are my linked accounts","show me my connections"]},{"kind":"action","name":"getCurrentUserGuildMember","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Returns a guild member object for the current user. Sample phrases: - \"Can you show me my member details for the server with ID 123456?\" - \"Get my guild member info for the server 123456, please.\" - \"I need my member object for the guild with ID 123456.\"","parameters":[{"name":"guild_id","type":"string","optional":false,"description":"The ID of the guild to fetch the member object from."}],"phrasings":["what's my role in server {guild_id}","I need my member object for guild {guild_id}","get my guild member info for server {guild_id}","show me my member details for server {guild_id}"]},{"kind":"action","name":"getCurrentUserGuilds","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Returns a list of partial guild objects the current user is a member of. Sample phrases: - \"Can you show me the servers I'm part of?\" - \"List all the guilds I'm currently in, please.\" - \"What are the Discord servers I belong to?\"","parameters":[{"name":"before","type":"string","optional":true,"description":"Get guilds before this ID."},{"name":"after","type":"string","optional":true,"description":"Get guilds after this ID."},{"name":"limit","type":"number","optional":true,"description":"The maximum number of guilds to return."},{"name":"with_counts","type":"boolean","optional":true,"description":"Whether to include member counts."}],"phrasings":["what servers I belong to","list guilds I'm in","show my server list","show me servers I'm part of"]},{"kind":"action","name":"getGuild","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Fetches a guild object for a given guild ID. Sample phrases: - \"Can you get the details for the guild with ID 12345?\" - \"Fetch the guild information for guild ID 67890, please.\" - \"I need the guild object for the guild with ID abcdef.\"","parameters":[{"name":"guild_id","type":"string","optional":false,"description":"The ID of the guild to fetch."}],"phrasings":["I need guild object for ID {guild_id}","show me guild {guild_id}","fetch guild info for {guild_id}","get details for guild {guild_id}"]},{"kind":"action","name":"getInvite","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Returns an invite object for the given code. Sample phrases: - \"Can you fetch the invite details for the code ABC123?\" - \"I need the invite info for code XYZ789, please.\" - \"Get me the invite object for the code DEF456, and include the counts.\"","parameters":[{"name":"invite_code","type":"string","optional":false,"description":"The code of the invite to fetch."},{"name":"with_counts","type":"boolean","optional":true,"description":"Whether to include member counts."},{"name":"guild_scheduled_event_id","type":"string","optional":true,"description":"The ID of the scheduled event for the invite."}],"phrasings":["look up invite {invite_code}","I need invite info for code {invite_code}","show me invite code {invite_code}","get invite details for {invite_code}"]},{"kind":"action","name":"getTargetUsers","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Gets the users allowed to see and accept this invite. Response is a CSV file with the header user_id and each user ID from the original file passed to invite create on its own line. Requires the caller to be the inviter, or have MANAGE_GUILD permission, or have VIEW_AUDIT_LOG permission. Sample phrases: - \"Can you show me the list of users who can accept this invite?\" - \"Get me the users allowed to see this invite, please.\" - \"I need the user IDs for the invite with code [invite.code].\"","parameters":[{"name":"invite_code","type":"string","optional":false,"description":"The code of the invite to fetch target users for."}],"phrasings":["who can accept invite {invite_code}","I need user IDs for invite {invite_code}","get users allowed to see invite {invite_code}","show me users who can accept invite {invite_code}"]},{"kind":"action","name":"getTargetUsersJobStatus","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Processing target users from a CSV when creating or updating an invite is done asynchronously. This endpoint allows you to check the status of that job. Requires the caller to be the inviter, or have MANAGE_GUILD permission, or have VIEW_AUDIT_LOG permission. Sample phrases: - \"Can you check the status of the job for the invite with code ABC123?\" - \"What's the current status of the processing job for the invite code ABC123?\" - \"Please tell me the job status for the invite code ABC123.\"","parameters":[{"name":"invite_code","type":"string","optional":false,"description":"The code of the invite to check the job status for."}],"phrasings":["is target users processing done for invite {invite_code}","tell me job status for invite {invite_code}","what's job for invite {invite_code}","check job for invite {invite_code}"]},{"kind":"action","name":"getThreadMember","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Get a thread member.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the thread."},{"name":"user_id","type":"string","optional":false,"description":"The ID of the user."}],"phrasings":["is {user_id} in thread {channel_id}","fetch thread member {user_id} from thread {channel_id}","show me member {user_id} in thread {channel_id}","get member info for {user_id} in thread {channel_id}"]},{"kind":"action","name":"getUser","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Returns a user object for a given user ID. Sample phrases: - \"Can you fetch the user details for ID 123456?\" - \"I need information on the user with ID 123456.\" - \"Please get me the user object for ID 123456.\"","parameters":[{"name":"user_id","type":"string","optional":false,"description":"The ID of the user to fetch."}],"phrasings":["look up user {user_id}","I need information on user {user_id}","show me user {user_id}","get user details for {user_id}"]},{"kind":"action","name":"getWebhook","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Fetches a webhook object for a given webhook ID. Sample phrases: - \"Can you fetch the webhook details for ID 12345?\" - \"I need the webhook information for webhook ID 12345.\" - \"Please get the webhook object for the ID 12345.\"","parameters":[{"name":"webhook_id","type":"string","optional":false,"description":"The ID of the webhook to fetch."}],"phrasings":["get webhook {webhook_id}","I need webhook object for {webhook_id}","show me webhook {webhook_id}","get webhook details for {webhook_id}"]},{"kind":"action","name":"groupDmAddRecipient","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Add a recipient to a Group DM.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the group DM channel."},{"name":"user_id","type":"string","optional":false,"description":"The ID of the user to add."},{"name":"access_token","type":"string","optional":true,"description":"The access token of the user."},{"name":"nick","type":"string","optional":true,"description":"The nickname for the user in the group DM."}],"phrasings":["bring {user_id} into group chat {channel_id}","include {user_id} in group DM {channel_id}","invite {user_id} to group DM {channel_id}","add user {user_id} to group DM {channel_id}"]},{"kind":"action","name":"groupDmRemoveRecipient","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Remove a recipient from a Group DM.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the group DM channel."},{"name":"user_id","type":"string","optional":false,"description":"The ID of the user to remove."}],"phrasings":["exclude {user_id} from group chat {channel_id}","take {user_id} out of group DM {channel_id}","kick {user_id} from group DM {channel_id}","remove user {user_id} from group DM {channel_id}"]},{"kind":"action","name":"joinThread","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Join a thread.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the thread to join."}],"phrasings":["enter thread {channel_id}","I want to join thread {channel_id}","add me to thread {channel_id}","join thread {channel_id}"]},{"kind":"action","name":"leaveGuild","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Leave a guild. Returns a 204 empty response on success. Sample phrases: - \"I want to leave the server with ID 123456789.\" - \"Please remove me from the guild with ID 123456789.\" - \"Can you help me exit the guild? The ID is 123456789.\"","parameters":[{"name":"guild_id","type":"string","optional":false,"description":"The ID of the guild to leave."}],"phrasings":["quit server {guild_id}","exit guild {guild_id}","remove me from guild {guild_id}","I want to leave server {guild_id}"]},{"kind":"action","name":"leaveThread","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Leave a thread.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the thread to leave."}],"phrasings":["exit thread {channel_id}","remove me from thread {channel_id}","I want to leave thread {channel_id}","leave thread {channel_id}"]},{"kind":"action","name":"listChannels","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"List all channels in the current Discord server.","parameters":[],"phrasings":["what channels","list channels"]},{"kind":"action","name":"listJoinedPrivateArchivedThreads","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"List private archived threads joined by the current user.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel."},{"name":"before","type":"string","optional":true,"description":"Returns threads before this timestamp."},{"name":"limit","type":"number","optional":true,"description":"Maximum number of threads to return."}],"phrasings":["what private archived threads have I joined in channel {channel_id}","get my joined private archived threads from channel {channel_id}","show me private archived threads I'm in for channel {channel_id}","list private archived threads I've joined in channel {channel_id}"]},{"kind":"action","name":"listPrivateArchivedThreads","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"List private archived threads in a channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel."},{"name":"before","type":"string","optional":true,"description":"Returns threads before this timestamp."},{"name":"limit","type":"number","optional":true,"description":"Maximum number of threads to return."}],"phrasings":["what private threads are archived in channel {channel_id}","get archived private threads from channel {channel_id}","show me private archived threads in channel {channel_id}","list private archived threads in channel {channel_id}"]},{"kind":"action","name":"listPublicArchivedThreads","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"List public archived threads in a channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel."},{"name":"before","type":"string","optional":true,"description":"Returns threads before this timestamp."},{"name":"limit","type":"number","optional":true,"description":"Maximum number of threads to return."}],"phrasings":["what public threads are archived in channel {channel_id}","get archived public threads from channel {channel_id}","show me public archived threads in channel {channel_id}","list public archived threads in channel {channel_id}"]},{"kind":"action","name":"listThreadMembers","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"List members of a thread.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the thread."}],"phrasings":["get member list for thread {channel_id}","who is in thread {channel_id}","show me members of thread {channel_id}","list members of thread {channel_id}"]},{"kind":"action","name":"modifyChannel","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Update a channel's settings.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel to modify."},{"name":"name","type":"string","optional":true,"description":"The new name for the channel."},{"name":"topic","type":"string","optional":true,"description":"The new topic for the channel."},{"name":"nsfw","type":"boolean","optional":true,"description":"Whether the channel is NSFW."}],"phrasings":["rename channel {channel_id} to {name}","modify channel {channel_id} name to {name}","change settings of channel {channel_id}","update channel {channel_id}"]},{"kind":"action","name":"modifyCurrentUser","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Modify the requester's user account settings. Returns a user object on success. Sample phrases: - \"Can you update my username and profile picture?\" - \"I'd like to change my username and avatar, please.\" - \"Please modify my account settings with a new username and banner image.\"","parameters":[{"name":"username","type":"string","optional":true,"description":"The new username for the account."},{"name":"avatar","type":"string","optional":true,"description":"The new avatar for the account."},{"name":"banner","type":"string","optional":true,"description":"The new banner image for the account."}],"phrasings":["update my account settings","set my username to {username}","change my profile username {username}","update my username to {username}"]},{"kind":"action","name":"refreshChannels","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Refresh the channel cache from the Discord server.","parameters":[],"phrasings":["update channel cache","refresh cache"]},{"kind":"action","name":"removeThreadMember","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Remove another member from a thread.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the thread."},{"name":"user_id","type":"string","optional":false,"description":"The ID of the user to remove."}],"phrasings":["exclude {user_id} from thread {channel_id}","take {user_id} out of thread {channel_id}","kick {user_id} from thread {channel_id}","remove user {user_id} from thread {channel_id}"]},{"kind":"action","name":"setGuild","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Set the default Discord server (guild) for all operations.","parameters":[{"name":"guild_id","type":"string","optional":false,"description":"The Discord server ID to use as default"}],"phrasings":["use server {guild_id}","my discord server {guild_id}","set my discord server {guild_id}"]},{"kind":"action","name":"setVoiceChannelStatus","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Set the status of a voice channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the voice channel."},{"name":"status","type":"string","optional":false,"description":"The new status for the voice channel."}],"phrasings":["put {status} as status for voice channel {channel_id}","change status of voice channel {channel_id} to {status}","update voice channel {channel_id} status to {status}","set channel {channel_id} status to {status}"]},{"kind":"action","name":"startThreadFromMessage","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Start a thread from an existing message.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel containing the message."},{"name":"message_id","type":"string","optional":false,"description":"The ID of the message to start a thread from."},{"name":"name","type":"string","optional":true,"description":"The name of the thread."}],"phrasings":["make a thread from message {message_id} in channel {channel_id}","open a thread on message {message_id} in channel {channel_id} called {name}","create a thread called {name} from message {message_id} in channel {channel_id}","start a thread from message {message_id} in channel {channel_id} called {name}"]},{"kind":"action","name":"startThreadInForumOrMediaChannel","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Start a thread in a forum or media channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the forum or media channel."},{"name":"name","type":"string","optional":false,"description":"The name of the thread."},{"name":"message","type":"string","optional":true,"description":"The initial message for the thread."}],"phrasings":["make a forum post called {name} in channel {channel_id}","post a forum thread called {name} in channel {channel_id}","create a forum post called {name} in channel {channel_id}","start a forum thread called {name} in channel {channel_id}"]},{"kind":"action","name":"startThreadWithoutMessage","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Start a thread without an existing message.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel to start the thread in."},{"name":"name","type":"string","optional":false,"description":"The name of the thread."},{"name":"auto_archive_duration","type":"number","optional":true,"description":"Duration in minutes to automatically archive the thread."},{"name":"type","type":"number","optional":true,"description":"The type of thread to create."}],"phrasings":["make a thread called {name} in channel {channel_id}","open a thread in channel {channel_id} called {name}","create a thread called {name} in channel {channel_id}","start a thread called {name} in channel {channel_id}"]},{"kind":"action","name":"triggerTypingIndicator","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Trigger the typing indicator in a channel.","parameters":[{"name":"channel_id","type":"string","optional":false,"description":"The ID of the channel."}],"phrasings":["send typing indicator to channel {channel_id}","start typing in channel {channel_id}","show typing in channel {channel_id}","trigger typing indicator in channel {channel_id}"]},{"kind":"action","name":"updateCurrentUserApplicationRoleConnection","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Updates and returns the application role connection for the user. Sample phrases: - \"Can you update my role connection for the app with my new username?\" - \"Please change my application role connection details to reflect my updated platform name and username.\" - \"I need to update my role connection for the app. My platform name is [platform_name] and my username is [platform_username].\"","parameters":[{"name":"application_id","type":"string","optional":true,"description":"The ID of the application."},{"name":"platform_name","type":"string","optional":true,"description":"The new platform name for the role connection."},{"name":"platform_username","type":"string","optional":true,"description":"The new platform username for the role connection."},{"name":"metadata","type":"string","optional":true,"description":"The metadata for the role connection (JSON string)."}],"phrasings":["modify my role connection for app {application_id}","update my role connection for app {application_id} {platform_name}","change my role connection for app {application_id}","update my role connection for app {application_id}"]},{"kind":"action","name":"updateTargetUsers","agent":"discord","schema":"discord","enabled":true,"transient":false,"description":"Updates the users allowed to see and accept this invite. Uploading a file with invalid user IDs will result in a 400 with the invalid IDs described. Requires the caller to be the inviter or have the MANAGE_GUILD permission. Sample phrases: - \"Can you update the invite with these new target users? Here's the file.\" - \"Please refresh the list of users who can access this invite using this file.\" - \"I'd like to change the allowed users for this invite. Uploading the file now.\"","parameters":[{"name":"invite_code","type":"string","optional":false,"description":"The code of the invite to update target users for."},{"name":"target_users_file","type":"string","optional":true,"description":"The file containing the new target users (file path or URL)."}],"phrasings":["set target users for invite {invite_code}","change allowed users for invite {invite_code}","refresh users who can access invite {invite_code}","update users for invite {invite_code}"]}]}]},{"kind":"category","name":"Web & Knowledge","emoji":"🌐","children":[{"kind":"agent","name":"browser","emoji":"🌐","description":"Agent that allows you control an existing browser window","children":[{"kind":"action","name":"addToBookmarks","agent":"browser","schema":"browser.external","enabled":false,"transient":true,"description":"","parameters":[{"name":"url","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"captureScreenshot","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["screenshot","capture screen","take screenshot"]},{"kind":"action","name":"changeSearchProvider","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"change the default search provider","parameters":[{"name":"name","type":"string","optional":false,"description":"The name of the search provider to switch to"}],"phrasings":[]},{"kind":"action","name":"changeTab","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Make another tab the active tab","parameters":[{"name":"tabDescription","type":"string","optional":false,"description":""},{"name":"tabIndex","type":"number","optional":true,"description":"The numerical index referred to by the description if applicable.  (i.e. first = 1, second = 2, etc.)"}],"phrasings":["next tab","go to tab {tabDescription}","switch to tab {tabDescription}"]},{"kind":"action","name":"closeAllWebPages","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Close all web page views","parameters":[],"phrasings":["tabs","pages"]},{"kind":"action","name":"closeTab","agent":"browser","schema":"browser.external","enabled":false,"transient":true,"description":"This closes a tab in an existing browser window. IMPORTANT: This does NOT close browser programs.","parameters":[{"name":"title","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"closeWebPage","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Close the current web site view","parameters":[],"phrasings":["close tab","close page"]},{"kind":"action","name":"closeWindow","agent":"browser","schema":"browser.external","enabled":false,"transient":true,"description":"","parameters":[{"name":"title","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"createInferredFlow","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Create WebFlows from previously inferred actions. Used after @browser actions infer to select which actions to create.","parameters":[{"name":"selection","type":"string","optional":false,"description":"The indices of the inferred actions to create (1-based), or \"all\" to create all"}],"phrasings":["all flows"]},{"kind":"action","name":"createInferredFlows","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[{"name":"selectedIndices","type":"number[]","optional":false,"description":""},{"name":"inferredActions","type":"{ … }[]","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"createWebFlowFromRecording","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[{"name":"actionName","type":"string","optional":false,"description":""},{"name":"actionDescription","type":"string","optional":false,"description":""},{"name":"recordedSteps","type":"string","optional":false,"description":""},{"name":"existingActionNames","type":"string[]","optional":true,"description":""},{"name":"startUrl","type":"string","optional":false,"description":""},{"name":"screenshots","type":"string[]","optional":true,"description":""},{"name":"fragments","type":"{ … }[]","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"deleteWebFlow","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[{"name":"name","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"deleteWebFlow","agent":"browser","schema":"browser.webFlows","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"detectPageActions","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[{"name":"registerAgent","type":"boolean","optional":true,"description":""},{"name":"agentName","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"editWebFlow","agent":"browser","schema":"browser.webFlows","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":false,"description":""},{"name":"script","type":"string","optional":false,"description":""},{"name":"description","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"editWebFlowScope","agent":"browser","schema":"browser.webFlows","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":false,"description":""},{"name":"scopeType","type":"\"site\" | \"global\"","optional":false,"description":""},{"name":"domains","type":"string[]","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"executeAdHocScript","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Execute an ad-hoc WebFlow script. The script must be a valid async function using the WebFlow browser API (browser.click, browser.enterText, etc.). Used by reasoning agents to perform browser interactions without a saved WebFlow.","parameters":[{"name":"script","type":"string","optional":false,"description":"The JavaScript source for an async function: async function execute(browser, params) { ... }"},{"name":"params","type":"string","optional":true,"description":"JSON-encoded parameters to pass to the script"},{"name":"timeout","type":"number","optional":true,"description":"Execution timeout in milliseconds (default: 120000)"}],"phrasings":[]},{"kind":"action","name":"followLinkByPosition","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[{"name":"position","type":"number","optional":false,"description":""},{"name":"openInNewTab","type":"boolean","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"followLinkByText","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"follow a link on the page to open a related page or article Example: user: Open the Haiti link agent: { \"actionName\": \"followLinkByText\", \"parameters\": { \"keywords\": \"Haiti\" } }","parameters":[{"name":"keywords","type":"string","optional":false,"description":""},{"name":"openInNewTab","type":"boolean","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"generateWebFlow","agent":"browser","schema":"browser.webFlows","enabled":true,"transient":false,"description":"Generate a reusable WebFlow script from a saved trace","parameters":[{"name":"traceId","type":"string","optional":false,"description":"Trace ID (from a previous goal-driven task) to generate a script from"},{"name":"name","type":"string","optional":true,"description":"Optional name for the generated flow"},{"name":"description","type":"string","optional":true,"description":"Optional description override"}],"phrasings":[]},{"kind":"action","name":"generateWebFlowFromRecording","agent":"browser","schema":"browser.webFlows","enabled":true,"transient":false,"description":"Generate a WebFlow from recorded user interactions","parameters":[{"name":"description","type":"string","optional":false,"description":"Description of what the recording does"},{"name":"name","type":"string","optional":true,"description":"Optional name for the generated flow"}],"phrasings":[]},{"kind":"action","name":"getAllWebFlows","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"getWebFlowsForDomain","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[{"name":"domain","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"getWebsiteStats","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Get statistics about imported website data","parameters":[{"name":"groupBy","type":"\"domain\" | \"pageType\" | \"source\"","optional":true,"description":"Group stats by domain, pageType, or source"},{"name":"limit","type":"number","optional":true,"description":"Limit number of groups returned"}],"phrasings":[]},{"kind":"action","name":"goBack","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["back"]},{"kind":"action","name":"goForward","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["forward"]},{"kind":"action","name":"inferActions","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"listWebFlows","agent":"browser","schema":"browser.webFlows","enabled":true,"transient":false,"description":"","parameters":[{"name":"scope","type":"\"site\" | \"global\" | \"all\"","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"lookupAndAnswerInternet","agent":"browser","schema":"browser.lookupAndAnswer","enabled":true,"transient":false,"description":"The user request is a question about general knowledge that can be found from the internet. (e.g. \"what is the current price of Microsoft stock?\") look up for contemporary internet information including sports scores, news events, or current commerce offerings, use the lookups parameter to request a lookup of the information on the user's behalf; the assistant will generate a response based on the lookup results Lookup *facts* you don't know or if your facts are out of date. E.g. stock prices, time sensitive data, etc the search strings to look up on the user's behalf should be specific enough to return the correct information it is recommended to include the same entities as in the user request","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"},{"name":"internetLookups","type":"string[]","optional":false,"description":"the internet search terms to use"},{"name":"sites","type":"string[]","optional":true,"description":"specific sites to look up in."}],"phrasings":[]},{"kind":"action","name":"openFromBookmarks","agent":"browser","schema":"browser.external","enabled":false,"transient":true,"description":"","parameters":[{"name":"keywords","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"openFromHistory","agent":"browser","schema":"browser.external","enabled":false,"transient":true,"description":"","parameters":[{"name":"keywords","type":"string","optional":false,"description":""},{"name":"startDate","type":"{ displayText, timestamp }","optional":true,"description":""},{"name":"endDate","type":"{ displayText, timestamp }","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"openSearchResult","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Open a specific search result from previous search","parameters":[{"name":"position","type":"number","optional":true,"description":"Position/index of the search result (1-based)"},{"name":"title","type":"string","optional":true,"description":"Name or title of the search result to open"},{"name":"url","type":"string","optional":true,"description":"URL of the search result to open (if user specifies exact URL)"},{"name":"openInNewTab","type":"boolean","optional":true,"description":"Open in new tab (default: false)"}],"phrasings":[]},{"kind":"action","name":"openTab","agent":"browser","schema":"browser.external","enabled":false,"transient":true,"description":"This opens a new tab in an existing browser window. IMPORTANT: This does NOT launch new browser windows.","parameters":[{"name":"url","type":"string","optional":true,"description":""},{"name":"query","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"openWebPage","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"show/open/display web page in the current view.","parameters":[{"name":"site","type":"\"paleobiodb\" | \"crossword\" | \"commerce\" | \"montage\" | \"markdown\" | \"turtleGraphics\" | \"annotationsLibrary\" | \"knowledgeLibrary\" | …","optional":false,"description":"Name/Description/search terms of the site to open"},{"name":"tab","type":"\"new\" | \"current\" | \"existing\"","optional":true,"description":"Enum indicating if the page to open in the new tab or the current tab. Default value is \"current\""}],"phrasings":["visit {site}","browse to {site}","navigate to {site}","go to {site}","open {site}"]},{"kind":"action","name":"readPageContent","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Read the web page contents aloud","parameters":[],"phrasings":["page"]},{"kind":"action","name":"registerPageDynamicAgent","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[{"name":"agentName","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"reloadPage","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["refresh page","reload page"]},{"kind":"action","name":"scrollDown","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["down"]},{"kind":"action","name":"scrollUp","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["up"]},{"kind":"action","name":"searchImageAction","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"Searches (finds) for images on the internet to show the user if the user asks doesn't specify a quantity, randomly select anywhere between 3 and 10 images","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"},{"name":"searchTerm","type":"string","optional":false,"description":"the search term for the image(s) to find"},{"name":"numImages","type":"number","optional":false,"description":"the number of images to show the user"}],"phrasings":[]},{"kind":"action","name":"startGoalDrivenTask","agent":"browser","schema":"browser.webFlows","enabled":true,"transient":false,"description":"Goal-driven mode: describe what you want and a reasoning model completes it","parameters":[{"name":"goal","type":"string","optional":false,"description":"The goal to achieve (e.g. \"search for wireless headphones and add the cheapest to cart\")"},{"name":"startUrl","type":"string","optional":true,"description":"Optional starting URL; uses current page if not specified"},{"name":"maxSteps","type":"number","optional":true,"description":"Maximum reasoning steps (default 30)"}],"phrasings":[]},{"kind":"action","name":"stopReadPageContent","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["stop reading"]},{"kind":"action","name":"summarizePage","agent":"browser","schema":"browser.actionDiscovery","enabled":false,"transient":true,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"switchToTabByPosition","agent":"browser","schema":"browser.external","enabled":false,"transient":true,"description":"","parameters":[{"name":"position","type":"number","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"switchToTabByText","agent":"browser","schema":"browser.external","enabled":false,"transient":true,"description":"Switch to an open tab, based on the tab's title Example: user: Switch to the Haiti tab agent: { \"actionName\": \"switchToTabByText\", \"parameters\": { \"keywords\": \"Haiti\" } }","parameters":[{"name":"keywords","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"zoomIn","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["in"]},{"kind":"action","name":"zoomOut","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["out"]},{"kind":"action","name":"zoomReset","agent":"browser","schema":"browser","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["reset zoom"]}]},{"kind":"agent","name":"weather","emoji":"⛅","description":"Agent to get weather information including current conditions, forecasts, and alerts","children":[{"kind":"action","name":"getAlerts","agent":"weather","schema":"weather","enabled":true,"transient":false,"description":"","parameters":[{"name":"location","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"getCurrentConditions","agent":"weather","schema":"weather","enabled":true,"transient":false,"description":"","parameters":[{"name":"location","type":"string","optional":false,"description":""},{"name":"units","type":"\"celsius\" | \"fahrenheit\"","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"getForecast","agent":"weather","schema":"weather","enabled":true,"transient":false,"description":"","parameters":[{"name":"location","type":"string","optional":false,"description":""},{"name":"days","type":"number","optional":true,"description":""},{"name":"units","type":"\"celsius\" | \"fahrenheit\"","optional":true,"description":""}],"phrasings":[]}]}]},{"kind":"category","name":"Development & Automation","emoji":"💻","children":[{"kind":"agent","name":"code","emoji":"⚛️","description":"Agent for VSCode integration","children":[{"kind":"action","name":"changeColorScheme","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Change the VS Code editor's color theme. Example: User: change my vscode color theme to Monokai Agent: { actionName: \"changeColorScheme\", parameters: { theme: \"Monokai\" } }","parameters":[{"name":"theme","type":"\"Default Light+\" | \"Default Dark+\" | \"Monokai\" | \"Monokai Dimmed\" | \"Solarized Dark\" | \"Solarized Light\" | \"Quiet Light\" | \"Red\" | …","optional":false,"description":"The VS Code color theme name, e.g. \"Monokai\", \"Solarized Dark\", \"Dark+\"."}],"phrasings":[]},{"kind":"action","name":"changeEditorLayout","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Change the editor layout to single, double or three column layout","parameters":[{"name":"columnCount","type":"\"single\" | \"double\" | \"three\"","optional":true,"description":"e.g., \"single\", \"double\", \"three\" column editor layout. Fill only if specified by the user"}],"phrasings":[]},{"kind":"action","name":"checkExtensionAvailable","agent":"code","schema":"code.code-extension","enabled":false,"transient":false,"description":"The action checks/searches if an extension is available based on user requests like is the copilot extension available? or Show me all extensions related to AI","parameters":[{"name":"filterByUserQuery","type":"string","optional":true,"description":"Free text (e.g. \"copilot\")"},{"name":"filterByKnownQuery","type":"\"@updates\" | \"@recentlyPublished\" | \"@workspaceUnsupported\" | \"@builtin\" | \"@installed\" | \"@popular\" | \"@recommended\" | \"@enabled\" | …","optional":true,"description":"Known query (e.g. \"@installed\")"},{"name":"filterByCategory","type":"\"ai\" | \"azure\" | \"data science\" | \"formatters\" | \"programming languages\" | \"extension packs\" | \"machine learning\" | \"education\" | …","optional":true,"description":"Category filter (e.g. \"@category:ai\")"}],"phrasings":[]},{"kind":"action","name":"closeEditor","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Close the current editor","parameters":[],"phrasings":["'close' 'editor'"]},{"kind":"action","name":"createCodeBlock","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"","parameters":[{"name":"language","type":"string","optional":false,"description":""},{"name":"docstring","type":"string","optional":true,"description":"A short natural language prompt or description of what the code block should do. Used for generating context-aware completions (e.g., via Copilot). Example: \"Loop over x in descending order\""},{"name":"declaration","type":"string","optional":true,"description":"The starting line of a structured code block, such as a for-loop, if-statement, etc. Example: \"for (let i = 0; i \u003c arr.length; i++) {\""},{"name":"body","type":"string","optional":true,"description":"Optional body of the code block, excluding the closing brace. Can be omitted if Copilot or the agent will generate it."},{"name":"codeSnippet","type":"string","optional":true,"description":"A short or one-liner code expression to insert directly or use as a Copilot prompt. Example: \"const total = prices.reduce(...)\" If provided, takes precedence over declaration/body."},{"name":"isPartial","type":"boolean","optional":true,"description":"True if the request is partial or uncertain (e.g., from speech). Used to guide how much the agent or Copilot should infer."},{"name":"file","type":"{ fileName, folderName, folderRelativeTo, createIfNotExists, fallbackToActiveFile }","optional":true,"description":"Optional target file where the code should be inserted. Only emit the file if specified by the user. If omitted, defaults to the active editor."},{"name":"position","type":"{ … }","optional":true,"description":"Position in the file where the code block should be inserted. Defaults to { type: \"atCursor\" }."}],"phrasings":[]},{"kind":"action","name":"createFile","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"@deprecated Use `NewCodeFileAction`, `NewMarkdownFileAction`, or `NewTextFileAction` instead.","parameters":[{"name":"fileName","type":"string","optional":true,"description":""},{"name":"folderName","type":"string","optional":true,"description":"Name of the folder to create the file in (e.g., \"src\")"},{"name":"folderRelativeTo","type":"string","optional":true,"description":"Optional: restrict to folders under this path or name"},{"name":"language","type":"string","optional":true,"description":""},{"name":"untitled","type":"boolean","optional":true,"description":""},{"name":"openInEditor","type":"boolean","optional":true,"description":""},{"name":"content","type":"string","optional":true,"description":""},{"name":"overwriteIfExists","type":"boolean","optional":true,"description":""},{"name":"focusExistingIfOpen","type":"boolean","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"createFunction","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"Schema to generate a function","parameters":[{"name":"language","type":"\"typescript\" | \"python\" | \"javascript\" | string","optional":false,"description":"Programming language of the function (determines syntax rules and formatting)"},{"name":"functionDeclaration","type":"string","optional":false,"description":"The full function declaration or signature line (e.g., \"function foo(x: number): number {\") This must include the opening brace (for JS/TS) or colon (for Python) and match the language's syntax"},{"name":"body","type":"string","optional":true,"description":"Function implementation body (excluding the closing brace or dedent, if applicable) This should contain valid code that performs the intended task. If left as an empty string (\"\"), the extension will attempt to trigger GitHub Copilot to complete the body. Prefer generating this value if the function behavior is well understood."},{"name":"docstring","type":"string","optional":true,"description":"A one-line docstring or comment that explains what the function does. This should describe the function’s intent based on the declaration and user request. Used to improve readability and may help tools like Copilot complete the function more accurately."},{"name":"name","type":"string","optional":true,"description":"Optional: the name of the function. If omitted, may be inferred from the declaration."},{"name":"args","type":"{ … }[]","optional":true,"description":"Optional: an array of function parameters with their names and types (for display or analysis)"},{"name":"returnType","type":"string","optional":true,"description":"Optional: the function's return type (e.g., \"string\", \"void\", \"Promise\u003cboolean>\")"},{"name":"isAsync","type":"boolean","optional":true,"description":"Optional: whether the function should be marked as async"},{"name":"file","type":"{ fileName, folderName, folderRelativeTo, createIfNotExists, fallbackToActiveFile }","optional":true,"description":"Optional: the target file where the function should be inserted"},{"name":"position","type":"{ … }","optional":true,"description":"Optional: where in the file to insert the function. Defaults to current cursor location if not provided."}],"phrasings":[]},{"kind":"action","name":"deleteConversation","agent":"code","schema":"code.code-vscode-shell","enabled":false,"transient":false,"description":"Delete a TypeAgent Shell conversation by display name. The current active conversation cannot be deleted. The extension will prompt the user for confirmation before deleting. Example: User: delete the \"design review\" conversation Agent: { actionName: \"deleteConversation\", parameters: { name: \"design review\" } } Example: User: delete a conversation Agent: { actionName: \"deleteConversation\", parameters: {} }","parameters":[{"name":"name","type":"string","optional":true,"description":"The display name of the conversation to delete. If omitted, the user will be shown a picker in the extension UI."}],"phrasings":["'delete' 'chat'"]},{"kind":"action","name":"disableExtension","agent":"code","schema":"code.code-extension","enabled":false,"transient":false,"description":"","parameters":[{"name":"extensionQuery","type":"string","optional":false,"description":"e.g. \"prettier\", \"azure functions\""},{"name":"promptUser","type":"boolean","optional":true,"description":"whether to prompt user for confirmation before disabling, default: true"},{"name":"autoReload","type":"boolean","optional":true,"description":"whether to automatically reload the window after disabling, default: false"}],"phrasings":[]},{"kind":"action","name":"enableExtension","agent":"code","schema":"code.code-extension","enabled":false,"transient":false,"description":"","parameters":[{"name":"extensionQuery","type":"string","optional":false,"description":"e.g. \"prettier\", \"azure functions\""},{"name":"promptUser","type":"boolean","optional":true,"description":"whether to prompt user for confirmation before enabling, default: true"},{"name":"autoReload","type":"boolean","optional":true,"description":"whether to automatically reload the window after enabling, default: false"}],"phrasings":[]},{"kind":"action","name":"fixCodeProblem","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"schema to fix a problem (diagnostic) in the code. The target can be the first problem, the next one, all, or a specific location/index in the file. Optional hints from the user (e.g. \"fix the second error\") or file scoping may guide the choice. Used when the user requests: \"fix this problem\", \"fix the second error\", \"fix all issues in this file\".","parameters":[{"name":"target","type":"{ … }","optional":false,"description":"Which problem to fix (e.g., \"first\", \"next\", \"atCursor\", or \"second problem in file\")"},{"name":"hint","type":"string","optional":true,"description":"Optional context hint from the agent (parsed from user request)"},{"name":"file","type":"{ fileName, folderName, folderRelativeTo, createIfNotExists, fallbackToActiveFile }","optional":true,"description":"File scope (defaults to active editor)"}],"phrasings":[]},{"kind":"action","name":"fontZoomReset","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Zoom reset","parameters":[],"phrasings":["'zoom' 'reset'","'reset' 'zoom'"]},{"kind":"action","name":"generateWithCopilot","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"","parameters":[{"name":"strategy","type":"\"inlineCompletion\" | \"commentToCode\" | \"generateFix\" | \"generateInsideFunction\" | \"suggestAlternatives\"","optional":false,"description":"The generation strategy to use"},{"name":"position","type":"{ … }","optional":false,"description":"Where to generate the code"},{"name":"language","type":"string","optional":true,"description":"Optional language hint"},{"name":"prompt","type":"string","optional":true,"description":"Optional: natural language guidance (if not using inline)"},{"name":"context","type":"{ … }[]","optional":true,"description":"Optional: provide surrounding code or references"},{"name":"attemptLimit","type":"number","optional":true,"description":"Optional: how many suggestions to try (default: 1)"},{"name":"autoAccept","type":"boolean","optional":true,"description":"Optional: whether to auto-accept Copilot's first suggestion"},{"name":"explanationMode","type":"boolean","optional":true,"description":"Optional: let agent explain what Copilot might generate"}],"phrasings":[]},{"kind":"action","name":"getActiveEditor","agent":"code","schema":"code","enabled":false,"transient":false,"description":"── Read / introspection actions ──────────────────────────────────────────── These return the current VS Code editor state to the caller and modify nothing. They are meant to be invoked by the reasoning agent (via discover_actions/execute_action) to inspect what the user is looking at. Results are returned as JSON in the action's display output. Get a coarse snapshot of the active editor: file path, language, dirty state, cursor position, selection range, visible range, workspace folders, open editor count, and diagnostic counts. Does NOT include file or selection text.","parameters":[],"phrasings":[]},{"kind":"action","name":"getDiagnostics","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Get the diagnostics (errors, warnings, info, hints) for a file. Defaults to the active file when fileName is omitted.","parameters":[{"name":"fileName","type":"string","optional":true,"description":"Workspace-relative path or file name. Omit to use the active file."}],"phrasings":[]},{"kind":"action","name":"getFileContent","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Read the contents of a workspace file. Optionally restrict to a line range (0-based, inclusive). The file must be inside an open workspace folder.","parameters":[{"name":"fileName","type":"string","optional":false,"description":"Workspace-relative path or file name to read."},{"name":"startLine","type":"number","optional":true,"description":"Optional 0-based start line (inclusive)."},{"name":"endLine","type":"number","optional":true,"description":"Optional 0-based end line (inclusive)."}],"phrasings":[]},{"kind":"action","name":"getSelection","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Get the text currently selected in the active editor, along with its range. Returns an empty selection marker when nothing is selected.","parameters":[],"phrasings":[]},{"kind":"action","name":"getWorkspaceChanges","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Get a summary of pending source-control (git) changes in the workspace: per-repository branch, working-tree changes, and staged changes.","parameters":[],"phrasings":[]},{"kind":"action","name":"gotoFileOrLineOrSymbol","agent":"code","schema":"code.code-general","enabled":false,"transient":false,"description":"Quick option to access a file, alternate way to search a file by name using keyboard shortcuts search by file name, or append : go to line, or  @ to go to symbol If the user request is open/show the search pane this action should not be triggered","parameters":[{"name":"goto","type":"\"file\" | \"line\" | \"symbol\"","optional":true,"description":""},{"name":"ref","type":"string","optional":true,"description":"file name, line number, or symbol name, don't fill this property if the file name, line number or symbol name is not provided in the user request"}],"phrasings":["'symbol'","'line'","'file'"]},{"kind":"action","name":"insertComment","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"","parameters":[{"name":"text","type":"string","optional":false,"description":"The comment content, excluding the comment syntax itself"},{"name":"language","type":"string","optional":true,"description":"Optional, helps format comments (e.g., // vs #)"},{"name":"commentStyle","type":"\"line\" | \"block\"","optional":true,"description":"Comment style (default: \"line\")"},{"name":"position","type":"{ … }","optional":false,"description":"Where to insert the comment"},{"name":"newlineBefore","type":"boolean","optional":true,"description":"Whether to add a blank line before the comment"},{"name":"newlineAfter","type":"boolean","optional":true,"description":"Whether to add a blank line after the comment"}],"phrasings":[]},{"kind":"action","name":"insertOrDeleteLines","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"Action for inserting or deleting lines in a file.","parameters":[{"name":"operation","type":"\"insert\" | \"delete\"","optional":false,"description":"Operation to perform: \"insert\": add new empty lines at the target position \"delete\": remove lines starting from the target position"},{"name":"count","type":"number","optional":true,"description":"Number of lines to insert or delete (default: 1)."},{"name":"position","type":"{ … }","optional":true,"description":"Position where the operation should happen. Examples: { type: \"atCursor\" } { type: \"afterLine\", line: 10 } { type: \"atEndOfFile\" }"},{"name":"file","type":"{ fileName, folderName, folderRelativeTo, createIfNotExists, fallbackToActiveFile }","optional":true,"description":"Optional target file (defaults to the active editor)."},{"name":"force","type":"boolean","optional":true,"description":"When deleting: - true: allow deleting non-empty lines (default) - false: only delete if lines are empty/whitespace"}],"phrasings":[]},{"kind":"action","name":"installExtension","agent":"code","schema":"code.code-extension","enabled":false,"transient":false,"description":"","parameters":[{"name":"extensionQuery","type":"string","optional":false,"description":"natural language query, e.g. \"copilot\""},{"name":"promptUser","type":"boolean","optional":true,"description":"whether to prompt user for confirmation before installing, default: true"},{"name":"autoReload","type":"boolean","optional":true,"description":"whether to automatically reload the window after installation, default: false"}],"phrasings":[]},{"kind":"action","name":"launchCopilotChat","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Launch a new chat window with GitHub Copilot, Claude, or other chat providers This creates a new chat session in the specified location.","parameters":[{"name":"query","type":"string","optional":true,"description":"Optional initial query/prompt to send to the chat"},{"name":"provider","type":"\"copilot\" | \"claude\" | \"gpt\" | \"generic\"","optional":true,"description":"Chat provider: \"copilot\" (GitHub Copilot, default), \"claude\" (Claude/Anthropic), \"gpt\" (ChatGPT/OpenAI), or \"generic\" for any available chat extension"},{"name":"newSessionLocation","type":"\"window\" | \"editor\" | \"view\"","optional":true,"description":"Where to open the new session: \"window\" (new chat window, default), \"editor\" (new chat editor in editor area), or \"view\" (chat panel/side view)"},{"name":"mode","type":"\"agent\" | \"ask\"","optional":true,"description":"Copilot chat mode: \"agent\" (can edit workspace) or \"ask\" (conversational only) Note: not all providers support all modes"},{"name":"isPartialQuery","type":"boolean","optional":true,"description":"Whether to pre-fill but not auto-submit the query"},{"name":"attachScreenshot","type":"boolean","optional":true,"description":"Whether to attach a screenshot of focused VS Code window"},{"name":"attachFiles","type":"string[]","optional":true,"description":"Absolute paths to files to attach to the chat request"}],"phrasings":["'editor'","'view'","'window'","'create' 'chat'","'chat'","'chatgpt'","'claude'","'copilot'"]},{"kind":"action","name":"launchCopilotChat","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"Hand the current TypeAgent conversation (and optional developer-mode captures + a screenshot) to native GitHub Copilot Chat in VS Code so it can diagnose and fix the underlying problem, via `workbench.action.chat.open`. By default it starts a fresh chat session in a new chat editor and submits the request automatically.","parameters":[{"name":"query","type":"string","optional":false,"description":"The prompt to send to the Copilot Chat input."},{"name":"mode","type":"\"agent\" | \"ask\"","optional":true,"description":"Copilot chat mode. \"agent\" lets Copilot edit the workspace to apply a fix; \"ask\" is conversational only. Defaults to \"agent\"."},{"name":"isPartialQuery","type":"boolean","optional":true,"description":"When true, the query is pre-filled but not auto-submitted so the user can review the attached context first. When false (default for `@copilot fix`), the request is submitted automatically."},{"name":"attachScreenshot","type":"boolean","optional":true,"description":"When true, attach a screenshot of the focused VS Code window as an image (no temp file, no file-permission prompt)."},{"name":"attachFiles","type":"string[]","optional":true,"description":"Absolute paths to files (e.g., conversation.json and dev-capture JSON) to attach to the chat request."},{"name":"newSession","type":"boolean","optional":true,"description":"When true (default), start a fresh chat session for the handoff instead of appending to whatever chat is already open."},{"name":"newSessionLocation","type":"\"view\" | \"editor\" | \"window\"","optional":true,"description":"Where to open the new session (only when newSession is true): \"editor\" (a new chat editor in the editor area, the default), \"view\" (the chat panel/side view), or \"window\" (a separate chat window)."}],"phrasings":[]},{"kind":"action","name":"launchVSCode","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Launch or Start VSCode","parameters":[{"name":"mode","type":"\"last\" | \"folder\" | \"workspace\"","optional":false,"description":""},{"name":"path","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"listOpenEditors","agent":"code","schema":"code","enabled":false,"transient":false,"description":"List the open editor tabs across all editor groups (path, label, active, dirty). Does not include file contents.","parameters":[],"phrasings":[]},{"kind":"action","name":"moveCursorInFile","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"ACTION: Move the cursor to a specific position within a file (for navigation or editing preparation). This moves the cursor position, NOT split/duplicate the editor view. USE THIS for: \"go to file X\", \"jump to line 50\", \"go to function foo\", \"move cursor to X\" DO NOT USE for: \"split editor\", \"split X\", \"duplicate editor\" (use splitEditor action instead) Examples: - \"go to line 50\" → { target: { type: \"onLine\", line: 50 } } - \"jump to function main\" → { target: { type: \"insideFunction\", name: \"main\" } } - \"go to app.tsx\" → { target: { type: \"inFile\", filePath: \"app.tsx\" } } - \"move cursor to the end of file\" → { target: { type: \"atEndOfFile\" } }","parameters":[{"name":"target","type":"{ … }","optional":false,"description":"Target position for the cursor. Supports symbolic locations, line-based positions, or file-relative positions."},{"name":"file","type":"{ fileName, folderName, folderRelativeTo, createIfNotExists, fallbackToActiveFile }","optional":true,"description":"Optional file where the cursor should be moved. Defaults to the active editor if not provided."},{"name":"hint","type":"string","optional":true,"description":"Optional user or agent hint to clarify ambiguous positioning. Example: \"after function declaration\", \"before import statements\"."}],"phrasings":[]},{"kind":"action","name":"newCodeFile","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Create a new code file (Python, JavaScript, TypeScript, HTML, CSS, JSON, etc.) in the editor. Example: User: create a new typescript file called scratch.ts with a hello world function Agent: { actionName: \"newCodeFile\", parameters: { fileName: \"scratch.ts\", language: \"typeScript\", content: \"function helloWorld() { console.log('Hello, World!'); }\\n\" } }","parameters":[{"name":"fileName","type":"string | \"untitled\"","optional":false,"description":"The file name; if omitted or empty, \"untitled\" is used."},{"name":"language","type":"\"html\" | \"css\" | \"json\" | \"python\" | \"javaScript\" | \"typeScript\"","optional":false,"description":"The programming language of the file."},{"name":"content","type":"string","optional":false,"description":"Initial file content; empty string for an empty scratch file."}],"phrasings":[]},{"kind":"action","name":"newConversation","agent":"code","schema":"code.code-vscode-shell","enabled":false,"transient":false,"description":"Create a brand-new TypeAgent Shell conversation (a new chat tab in the TypeAgent Shell VS Code extension) and switch the current tab to it. Example: User: start a new conversation Agent: { actionName: \"newConversation\", parameters: {} } Example: User: new conversation called \"design review\" Agent: { actionName: \"newConversation\", parameters: { name: \"design review\" } }","parameters":[{"name":"name","type":"string","optional":true,"description":"Optional display name for the new conversation. If omitted, the user will be prompted in the extension UI."}],"phrasings":["'new' 'chat'"]},{"kind":"action","name":"newMarkdownFile","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Create a new Markdown (.md) file in the editor. Example: User: create a markdown file with a list of top ten AI papers Agent: { actionName: \"newMarkdownFile\", parameters: { fileName: \"papers.md\", content: \"# Top 10 AI Papers\\n...\" } }","parameters":[{"name":"fileName","type":"string | \"untitled\"","optional":false,"description":"The file name; if omitted or empty, \"untitled\" is used."},{"name":"content","type":"string","optional":false,"description":"Initial Markdown content; empty string for an empty scratch file."}],"phrasings":[]},{"kind":"action","name":"newTextFile","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Create a new plain text (.txt) file in the editor. Example: User: make a new text file called notes Agent: { actionName: \"newTextFile\", parameters: { fileName: \"notes.txt\", content: \"\" } }","parameters":[{"name":"fileName","type":"string | \"untitled\"","optional":false,"description":"The file name; if omitted or empty, \"untitled\" is used."},{"name":"content","type":"string","optional":false,"description":"Initial text content; empty string for an empty scratch file."}],"phrasings":[]},{"kind":"action","name":"openInIntegratedTerminal","agent":"code","schema":"code.code-workbench","enabled":false,"transient":false,"description":"","parameters":[{"name":"folderName","type":"string","optional":true,"description":"Optional: folder to open terminal in"},{"name":"commandToExecute","type":"string","optional":true,"description":"Optional: command to execute immediately"},{"name":"commandRiskLevel","type":"\"low\" | \"medium\" | \"high\"","optional":true,"description":"Optional: risk of command"},{"name":"reuseExistingTerminal","type":"boolean","optional":true,"description":"Optional: reuse current terminal or open new one, default is true"}],"phrasings":["'open' 'terminal'"]},{"kind":"action","name":"openMarkdownPreview","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Open markdown preview","parameters":[],"phrasings":["'open' 'markdown preview'"]},{"kind":"action","name":"openMarkdownPreviewToSide","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Open markdown preview to the side","parameters":[],"phrasings":["'open' 'markdown preview' 'to' 'side'"]},{"kind":"action","name":"openSettings","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Open settings","parameters":[],"phrasings":["'open' 'settings'"]},{"kind":"action","name":"reloadWindow","agent":"code","schema":"code.code-extension","enabled":false,"transient":false,"description":"","parameters":[],"phrasings":["'reload' 'window'"]},{"kind":"action","name":"removeAllBreakpoints","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"","parameters":[],"phrasings":["'remove' 'all' 'breakpoints'"]},{"kind":"action","name":"removeBreakpoint","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"","parameters":[{"name":"line","type":"number","optional":false,"description":"Line number where to remove the breakpoint"},{"name":"fileName","type":"string","optional":true,"description":"Optional: target file"},{"name":"folderName","type":"string","optional":true,"description":"Optional: folder relative to workspace"}],"phrasings":[]},{"kind":"action","name":"renameConversation","agent":"code","schema":"code.code-vscode-shell","enabled":false,"transient":false,"description":"Rename the TypeAgent Shell conversation that is currently active in this chat tab. Example: User: rename this conversation to \"vscode shell PR\" Agent: { actionName: \"renameConversation\", parameters: { newName: \"vscode shell PR\" } }","parameters":[{"name":"newName","type":"string","optional":false,"description":"The new display name to apply to the current conversation."}],"phrasings":[]},{"kind":"action","name":"replaceInFiles","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Replace in files","parameters":[],"phrasings":["'replace in' 'files'"]},{"kind":"action","name":"saveAllFiles","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"","parameters":[{"name":"onlyDirty","type":"boolean","optional":true,"description":""},{"name":"excludeUntitled","type":"boolean","optional":true,"description":""},{"name":"logResult","type":"boolean","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"saveCurrentFile","agent":"code","schema":"code.code-editor","enabled":false,"transient":false,"description":"","parameters":[{"name":"showErrorIfNoActiveEditor","type":"boolean","optional":true,"description":""},{"name":"onlyDirty","type":"boolean","optional":true,"description":""},{"name":"excludeUntitled","type":"boolean","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"setBreakpoint","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"","parameters":[{"name":"line","type":"number","optional":false,"description":"Line number where to set the breakpoint"},{"name":"fileName","type":"string","optional":true,"description":"Optional: target file"},{"name":"folderName","type":"string","optional":true,"description":"Optional: folder relative to workspace"}],"phrasings":[]},{"kind":"action","name":"showCommandPalette","agent":"code","schema":"code.code-general","enabled":false,"transient":false,"description":"Show or open the command palette that allows to search and execute commands Trigger this action only when asked to show/open the command palette explicitly","parameters":[],"phrasings":["'show' 'command palette'"]},{"kind":"action","name":"showDebugPanel","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"Show debug panel or window in the editor or code window, if not already visible","parameters":[],"phrasings":["'show' 'debug' 'panel'"]},{"kind":"action","name":"showExplorer","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Show explorer/show the file explorer","parameters":[],"phrasings":["'show' 'explorer'"]},{"kind":"action","name":"showExtensions","agent":"code","schema":"code.code-extension","enabled":false,"transient":false,"description":"Show the extensions panel","parameters":[],"phrasings":["'show' 'extensions'"]},{"kind":"action","name":"showHover","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"Show hover","parameters":[],"phrasings":["'show' 'hover'"]},{"kind":"action","name":"showKeyboardShortcuts","agent":"code","schema":"code.code-general","enabled":false,"transient":false,"description":"Show keyboard shortcuts","parameters":[],"phrasings":["'show' 'keyboard shortcuts'"]},{"kind":"action","name":"showOutputPanel","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Show output panel","parameters":[],"phrasings":["'show' 'output'"]},{"kind":"action","name":"showSearch","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Show search or replace pane/window in the sidebar to search for text in the files Note that this is not for searching or finding files","parameters":[],"phrasings":["'show' 'search'"]},{"kind":"action","name":"showSourceControl","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Show source control","parameters":[],"phrasings":["'show' 'source control'"]},{"kind":"action","name":"showUserSettings","agent":"code","schema":"code.code-general","enabled":false,"transient":false,"description":"Show user settings","parameters":[],"phrasings":["'show' 'settings'"]},{"kind":"action","name":"splitEditor","agent":"code","schema":"code","enabled":false,"transient":false,"description":"Split an editor window into multiple panes showing the same file or different files side-by-side. Example: User: split editor to the right Agent: { actionName: \"splitEditor\", parameters: { direction: \"right\" } } Example: User: split the editor with utils.ts Agent: { actionName: \"splitEditor\", parameters: { fileName: \"utils.ts\" } }","parameters":[{"name":"direction","type":"\"right\" | \"left\" | \"up\" | \"down\"","optional":true,"description":"Direction to split: \"right\", \"left\", \"up\", \"down\". Only include if user specifies direction."},{"name":"editorPosition","type":"\"first\" | \"last\" | \"active\" | number","optional":true,"description":"Which editor to split by position: \"first\" (leftmost), \"last\" (rightmost), \"active\" (current), or a 0-based index."},{"name":"fileName","type":"string","optional":true,"description":"Which editor to split by file name. Extract the file name or pattern from user request."}],"phrasings":[]},{"kind":"action","name":"startDebugging","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"Start/Continue debugging","parameters":[{"name":"configurationName","type":"string","optional":true,"description":"Name of the launch configuration to start"},{"name":"noDebug","type":"boolean","optional":true,"description":"Optional: run without debugging"}],"phrasings":["'debug'","'start' 'debugging'"]},{"kind":"action","name":"step","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"Step into/out/over","parameters":[{"name":"stepType","type":"\"into\" | \"out\" | \"over\"","optional":false,"description":""}],"phrasings":["'over'","'out'","'into'","'step in'"]},{"kind":"action","name":"stopDebugging","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"Stop debugging","parameters":[],"phrasings":["'stop' 'debugging'"]},{"kind":"action","name":"switchConversation","agent":"code","schema":"code.code-vscode-shell","enabled":false,"transient":false,"description":"Switch the current TypeAgent Shell chat tab to a different existing conversation, identified by its display name. If no conversation with that name exists, a new one will be created with that name and the current tab will switch to it. Example: User: switch to the \"design review\" conversation Agent: { actionName: \"switchConversation\", parameters: { name: \"design review\" } } Example: User: switch conversation Agent: { actionName: \"switchConversation\", parameters: {} }","parameters":[{"name":"name","type":"string","optional":true,"description":"The display name of the conversation to switch to. If omitted, the user will be shown a picker in the extension UI. If the named conversation does not exist, a new one will be created."}],"phrasings":["'switch' 'chat'"]},{"kind":"action","name":"toggleBreakpoint","agent":"code","schema":"code.code-debug","enabled":false,"transient":false,"description":"","parameters":[{"name":"line","type":"number","optional":false,"description":"Line number where to toggle the breakpoint"},{"name":"fileName","type":"string","optional":true,"description":"Optional: target file"},{"name":"folderName","type":"string","optional":true,"description":"Optional: folder relative to workspace"}],"phrasings":[]},{"kind":"action","name":"toggleSearchDetails","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Toggle search details","parameters":[],"phrasings":["'toggle' 'search details'"]},{"kind":"action","name":"workbenchBuildRelatedTask","agent":"code","schema":"code.code-workbench","enabled":false,"transient":false,"description":"","parameters":[{"name":"task","type":"\"build\" | \"rebuild\" | \"clean\"","optional":false,"description":""},{"name":"folderName","type":"string","optional":true,"description":""},{"name":"taskSelection","type":"string | number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"workbenchCreateFolderFromExplorer","agent":"code","schema":"code.code-workbench","enabled":false,"transient":false,"description":"","parameters":[{"name":"folderName","type":"string","optional":false,"description":""},{"name":"relativeTo","type":"string","optional":true,"description":""},{"name":"resolutionHint","type":"\"inferFromName\" | \"workspaceRoot\" | \"activeSelection\"","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"workbenchOpenFile","agent":"code","schema":"code.code-workbench","enabled":false,"transient":false,"description":"","parameters":[{"name":"fileName","type":"string","optional":false,"description":"The name of the file to open (e.g., \"main.ts\")"},{"name":"matchStrategy","type":"\"exact\" | \"fuzzy\"","optional":true,"description":"Optional: control how strict the match is (default: \"exact\")"},{"name":"extensions","type":"string[]","optional":true,"description":"Optional: restrict to certain extensions (e.g., [\".ts\", \".js\"])"},{"name":"includeGenerated","type":"boolean","optional":true,"description":"Optional: whether to include files in dist/build/etc (default: false)"}],"phrasings":[]},{"kind":"action","name":"workbenchOpenFolder","agent":"code","schema":"code.code-workbench","enabled":false,"transient":false,"description":"","parameters":[{"name":"folderName","type":"string","optional":false,"description":"Name of the folder to reveal in Explorer"},{"name":"folderRelativeTo","type":"string","optional":true,"description":"Optional: restrict to folders under this path or name"},{"name":"includeGenerated","type":"boolean","optional":true,"description":"Optional: whether to include folders in node_modules, dist, etc. default: false"}],"phrasings":[]},{"kind":"action","name":"zenMode","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Code in Zen Mode","parameters":[],"phrasings":["'zen mode'"]},{"kind":"action","name":"zoomIn","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Zoom in the editor","parameters":[],"phrasings":["in'"]},{"kind":"action","name":"zoomOut","agent":"code","schema":"code.code-display","enabled":false,"transient":false,"description":"Zoom out the editor","parameters":[],"phrasings":["out'"]}]},{"kind":"agent","name":"github-cli","emoji":"🐙","description":"Agent for github-cli","children":[{"kind":"action","name":"agentTaskRun","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"task","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"aliasSet","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""},{"name":"command","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"apiRequest","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"method","type":"string","optional":true,"description":""},{"name":"endpoint","type":"string","optional":true,"description":""},{"name":"limit","type":"number","optional":true,"description":""}],"phrasings":["top {limit} contributors to {endpoint}","list contributors to {endpoint}"]},{"kind":"action","name":"attestationCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"artifact","type":"string","optional":true,"description":""},{"name":"type","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"authLogin","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"hostname","type":"string","optional":true,"description":""},{"name":"web","type":"boolean","optional":true,"description":""},{"name":"token","type":"string","optional":true,"description":""}],"phrasings":["into GitHub"]},{"kind":"action","name":"authLogout","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"hostname","type":"string","optional":true,"description":""}],"phrasings":["out of GitHub"]},{"kind":"action","name":"authStatus","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"hostname","type":"string","optional":true,"description":""},{"name":"showToken","type":"boolean","optional":true,"description":""}],"phrasings":["check my GitHub authentication"]},{"kind":"action","name":"browseIssue","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"browsePr","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"browseRepo","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"branch","type":"string","optional":true,"description":""},{"name":"commit","type":"string","optional":true,"description":""},{"name":"tag","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"cacheDelete","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"id","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"cacheList","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"codespaceCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":""},{"name":"branch","type":"string","optional":true,"description":""},{"name":"location","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"codespaceDelete","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"codespaceList","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"completionGenerate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"shell","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"configSet","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""},{"name":"value","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"copilotRun","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"task","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"dependabotAlerts","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":"owner/repo"},{"name":"severity","type":"string","optional":true,"description":"Filter by severity: critical, high, medium, low"},{"name":"state","type":"string","optional":true,"description":"Filter by state: open, dismissed, fixed"}],"phrasings":[]},{"kind":"action","name":"extensionInstall","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"gistCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"public","type":"boolean","optional":true,"description":""},{"name":"description","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"gistDelete","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"id","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"gistList","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"public","type":"boolean","optional":true,"description":""}],"phrasings":["my gists"]},{"kind":"action","name":"gpgKeyAdd","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"key","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"issueAddLabel","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":false,"description":""},{"name":"label","type":"string","optional":false,"description":""},{"name":"repo","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"issueClose","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"issueCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":"owner/repo"},{"name":"title","type":"string","optional":true,"description":""},{"name":"body","type":"string","optional":true,"description":""},{"name":"assignee","type":"string","optional":true,"description":""},{"name":"label","type":"string","optional":true,"description":""}],"phrasings":["file an issue about {title}","create issue {title}"]},{"kind":"action","name":"issueDelete","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"Permanently delete a GitHub issue (uses `gh issue delete --yes`).","parameters":[{"name":"number","type":"number","optional":false,"description":""},{"name":"repo","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"issueList","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":"owner/repo. Omitting this defaults to the current repository."},{"name":"state","type":"string","optional":true,"description":""},{"name":"label","type":"string","optional":true,"description":""},{"name":"author","type":"string","optional":true,"description":"Filter by author (issue creator): a GitHub login (e.g. \"octocat\") or \"@me\" for the current user. Use this for \"issues I opened\"."},{"name":"assignee","type":"string","optional":true,"description":"Filter by assignee: a GitHub login (e.g. \"octocat\"), \"@me\" for the current user, or \"none\" to list only unassigned issues. Use this for \"issues assigned to me\"."},{"name":"limit","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"issueReopen","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"issueView","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"View / open a specific GitHub issue by number. Example: User: show issue 2222 Agent: { actionName: \"issueView\", parameters: { number: 2222 } } Example: User: view issue #42 in microsoft/TypeAgent Agent: { actionName: \"issueView\", parameters: { number: 42, repo: \"microsoft/TypeAgent\" } }","parameters":[{"name":"number","type":"number","optional":true,"description":"The issue number. Omit when the user references an issue via entity resolution (\"that issue\", \"the issue we just opened\") — the dispatcher will substitute it."},{"name":"repo","type":"string","optional":true,"description":"OWNER/REPO slug (e.g. \"microsoft/TypeAgent\"). Omit unless the user names the repo."}],"phrasings":[]},{"kind":"action","name":"labelCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""},{"name":"color","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"licensesView","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"myAssignedIssues","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"List issues assigned to the current authenticated user across all repositories. Maps to `gh search issues --assignee @me --state open`.","parameters":[{"name":"limit","type":"number","optional":true,"description":"Maximum number of issues to return (default 20)"}],"phrasings":["what issues are assigned to me","show issues assigned to me","show my assigned issues"]},{"kind":"action","name":"myPullRequests","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"List the current user's own pull requests across ALL repositories — the PRs they authored. Maps to `gh search prs --author @me`. Use this for \"my PRs\", \"PRs I opened\", or \"my open PRs everywhere\" when no specific repo is named. For PRs within a single repo, use `prList` with author: \"@me\" instead.","parameters":[{"name":"state","type":"string","optional":true,"description":"Filter by state: \"open\" (default) or \"closed\"."},{"name":"owner","type":"string","optional":true,"description":"Scope the search to a single org/user's repositories (e.g. \"microsoft\"). Omit to search every repository the user can see."},{"name":"limit","type":"number","optional":true,"description":"Maximum number of pull requests to return (default 20)."}],"phrasings":["what pull requests have I opened","show pull requests I opened","show my pull requests","show my open pull requests"]},{"kind":"action","name":"orgList","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"orgView","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"prCheckout","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":true,"description":""},{"name":"branch","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"prChecks","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":false,"description":""},{"name":"repo","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"prClose","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"prCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"title","type":"string","optional":true,"description":""},{"name":"body","type":"string","optional":true,"description":""},{"name":"base","type":"string","optional":true,"description":""},{"name":"head","type":"string","optional":true,"description":""},{"name":"draft","type":"boolean","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"previewExecute","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"feature","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"prList","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"List pull requests, optionally filtered by repo, state, label, author, or assignee. A PR is \"mine\" when the user *authored* it. On GitHub the owner of a PR is its author, not its assignee (self-assignment is rare), so \"my PRs\", \"PRs I opened\", and \"are any of those mine?\" map to author: \"@me\" — NOT assignee. Example: User: are any of those mine?  (after listing open PRs in microsoft/TypeAgent) Agent: { actionName: \"prList\", parameters: { repo: \"microsoft/TypeAgent\", state: \"open\", author: \"@me\" } } Example: User: show my open pull requests Agent: { actionName: \"prList\", parameters: { state: \"open\", author: \"@me\" } }","parameters":[{"name":"repo","type":"string","optional":true,"description":""},{"name":"state","type":"string","optional":true,"description":""},{"name":"label","type":"string","optional":true,"description":""},{"name":"author","type":"string","optional":true,"description":"Filter by author (PR creator): a GitHub login (e.g. \"octocat\") or \"@me\" for the current user. Use this for \"my PRs\" / \"PRs I opened\"."},{"name":"assignee","type":"string","optional":true,"description":"Filter by assignee: a GitHub login (e.g. \"octocat\"), \"@me\" for the current user, or \"none\" to list only unassigned pull requests. Most PRs have no assignee — prefer `author` for \"my PRs\"."},{"name":"limit","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"prMerge","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"number","type":"number","optional":true,"description":""},{"name":"mergeMethod","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"prMergedStatus","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"Check whether a branch has already been merged into a base branch. Example: User: did dev/robgruen/dogfooding7 get merged into main? Agent: { actionName: \"prMergedStatus\", parameters: { branch: \"dev/robgruen/dogfooding7\", base: \"main\" } }","parameters":[{"name":"branch","type":"string","optional":false,"description":"Source branch to check (PR head branch)."},{"name":"base","type":"string","optional":true,"description":"Target base branch. Defaults to \"main\" when omitted."},{"name":"repo","type":"string","optional":true,"description":"OWNER/REPO slug (e.g. \"microsoft/TypeAgent\"). Omit to use current repo."},{"name":"limit","type":"number","optional":true,"description":"Maximum number of merged PR matches to inspect."}],"phrasings":[]},{"kind":"action","name":"projectCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""},{"name":"body","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"projectDelete","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"id","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"projectList","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":[]},{"kind":"action","name":"prView","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"View / open a specific GitHub pull request by number. Example: User: show PR 2196 Agent: { actionName: \"prView\", parameters: { number: 2196 } } Example: User: view pull request #42 in microsoft/TypeAgent Agent: { actionName: \"prView\", parameters: { number: 42, repo: \"microsoft/TypeAgent\" } }","parameters":[{"name":"number","type":"number","optional":true,"description":"The pull request number. Omit when the user references a PR via entity resolution (\"that PR\", \"the PR we just opened\") — the dispatcher will substitute it."},{"name":"repo","type":"string","optional":true,"description":"OWNER/REPO slug (e.g. \"microsoft/TypeAgent\"). Omit unless the user names the repo."}],"phrasings":[]},{"kind":"action","name":"releaseCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"tag","type":"string","optional":true,"description":""},{"name":"title","type":"string","optional":true,"description":""},{"name":"notes","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"releaseDelete","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"id","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"releaseList","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"repoClone","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":""},{"name":"branch","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"repoCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""},{"name":"description","type":"string","optional":true,"description":""},{"name":"public","type":"boolean","optional":true,"description":""},{"name":"private","type":"boolean","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"repoDelete","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"repoFork","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":""},{"name":"name","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"repoView","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":""},{"name":"field","type":"string","optional":true,"description":""}],"phrasings":["how many stars does {repo} have","show repository {repo}"]},{"kind":"action","name":"rulesetView","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"runView","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"id","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"searchRepos","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"query","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"secretCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""},{"name":"value","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"sshKeyAdd","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"key","type":"string","optional":true,"description":""}],"phrasings":["add an SSH key for me"]},{"kind":"action","name":"starRepo","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"repo","type":"string","optional":true,"description":""},{"name":"unstar","type":"boolean","optional":true,"description":""}],"phrasings":["unstar {repo}","star {repo}"]},{"kind":"action","name":"statusPrint","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["summary of issues and pull requests","print latest updates on my repositories","show status of issues and pull requests","show my GitHub status"]},{"kind":"action","name":"variableCreate","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"name","type":"string","optional":true,"description":""},{"name":"value","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"workflowView","agent":"github-cli","schema":"github-cli","enabled":true,"transient":false,"description":"","parameters":[{"name":"id","type":"string","optional":true,"description":""}],"phrasings":[]}]},{"kind":"agent","name":"onboarding","emoji":"🛠️","description":"Agent for onboarding new applications and APIs into TypeAgent","children":[{"kind":"action","name":"addPhrase","agent":"onboarding","schema":"onboarding.onboarding-phrasegen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name"},{"name":"actionName","type":"string","optional":false,"description":"The action name this phrase should map to"},{"name":"phrase","type":"string","optional":false,"description":"The natural language phrase to add"}],"phrasings":["add phrase {phrase} for {actionName} in {integrationName}"]},{"kind":"action","name":"approveApiSurface","agent":"onboarding","schema":"onboarding.onboarding-discovery","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to approve"},{"name":"includeActions","type":"string[]","optional":true,"description":"If provided, only these action names are included in the approved surface (excludes all others)"},{"name":"excludeActions","type":"string[]","optional":true,"description":"Action names to exclude from the approved surface"}],"phrasings":["confirm {integrationName} surface","approve surface for {integrationName}"]},{"kind":"action","name":"approveGrammar","agent":"onboarding","schema":"onboarding.onboarding-grammargen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to approve grammar for"}],"phrasings":["confirm {integrationName} grammar","approve {integrationName} grammar"]},{"kind":"action","name":"approvePhrases","agent":"onboarding","schema":"onboarding.onboarding-phrasegen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to approve phrases for"}],"phrasings":["confirm {integrationName} phrases","approve phrases for {integrationName}"]},{"kind":"action","name":"approveRepair","agent":"onboarding","schema":"onboarding.onboarding-testing","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to approve the proposed repair for"}],"phrasings":["apply {integrationName} repair","approve {integrationName} repair"]},{"kind":"action","name":"approveSchema","agent":"onboarding","schema":"onboarding.onboarding-schemagen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to approve schema for"}],"phrasings":["confirm {integrationName} schema","approve {integrationName} schema"]},{"kind":"action","name":"compileGrammar","agent":"onboarding","schema":"onboarding.onboarding-grammargen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name whose grammar to compile and validate"}],"phrasings":["validate {integrationName} grammar","compile {integrationName} grammar"]},{"kind":"action","name":"crawlCliHelp","agent":"onboarding","schema":"onboarding.onboarding-discovery","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Name of the integration being onboarded"},{"name":"command","type":"string","optional":false,"description":"The CLI command to crawl (e.g. \"gh\", \"az\", \"kubectl\")"},{"name":"maxDepth","type":"number","optional":true,"description":"Maximum recursion depth into subcommands (default: 4)"}],"phrasings":["discover {command} cli as {integrationName}","crawl cli help {command} as {integrationName}"]},{"kind":"action","name":"crawlDocUrl","agent":"onboarding","schema":"onboarding.onboarding-discovery","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Name of the integration being onboarded"},{"name":"url","type":"string","optional":false,"description":"URL of the API documentation page to crawl (e.g. \"https://api.slack.com/methods\")"},{"name":"maxDepth","type":"number","optional":true,"description":"Maximum link-follow depth (default: 2)"}],"phrasings":["fetch {integrationName} docs {url}","crawl docs {url} for {integrationName}"]},{"kind":"action","name":"generateDemo","agent":"onboarding","schema":"onboarding.onboarding-packaging","enabled":true,"transient":false,"description":"Generates a demo script and narration for the onboarded agent","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Name of the integration"},{"name":"durationMinutes","type":"string","optional":true,"description":"Duration target in minutes (default: 3-5)"}],"phrasings":["create demo for {integrationName}","generate demo for {integrationName}"]},{"kind":"action","name":"generateGrammar","agent":"onboarding","schema":"onboarding.onboarding-grammargen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to generate grammar for"}],"phrasings":["create {integrationName} grammar","generate grammar for {integrationName}"]},{"kind":"action","name":"generatePhrases","agent":"onboarding","schema":"onboarding.onboarding-phrasegen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to generate phrases for"},{"name":"phrasesPerAction","type":"number","optional":true,"description":"Number of phrases to generate per action (default: 5)"},{"name":"forActions","type":"string[]","optional":true,"description":"Generate phrases only for these specific action names (generates for all if omitted)"}],"phrasings":[]},{"kind":"action","name":"generateReadme","agent":"onboarding","schema":"onboarding.onboarding-packaging","enabled":true,"transient":false,"description":"Generates a README.md for the onboarded agent","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Name of the integration"}],"phrasings":["create readme for {integrationName}","generate readme for {integrationName}"]},{"kind":"action","name":"generateSchema","agent":"onboarding","schema":"onboarding.onboarding-schemagen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to generate schema for"}],"phrasings":["create schema for {integrationName}","generate schema for {integrationName}"]},{"kind":"action","name":"generateTests","agent":"onboarding","schema":"onboarding.onboarding-testing","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to generate tests for"}],"phrasings":["create test cases for {integrationName}","generate tests for {integrationName}"]},{"kind":"action","name":"getOnboardingStatus","agent":"onboarding","schema":"onboarding","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to check status for"}],"phrasings":["how far along is {integrationName}","show {integrationName} onboarding status","what's status {integrationName} onboarding"]},{"kind":"action","name":"getTestResults","agent":"onboarding","schema":"onboarding.onboarding-testing","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to get test results for"},{"name":"filter","type":"\"passing\" | \"failing\"","optional":true,"description":"Filter to show only passing or failing tests"}],"phrasings":["what are results for {integrationName}","get {integrationName} test results"]},{"kind":"action","name":"listDiscoveredActions","agent":"onboarding","schema":"onboarding.onboarding-discovery","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to list discovered actions for"}],"phrasings":["show actions {integrationName}","list actions for {integrationName}"]},{"kind":"action","name":"listIntegrations","agent":"onboarding","schema":"onboarding","enabled":true,"transient":false,"description":"","parameters":[{"name":"status","type":"\"in-progress\" | \"complete\"","optional":true,"description":"Filter by phase status; omit to list all"}],"phrasings":["what integrations","show integrations","list integrations"]},{"kind":"action","name":"listPatterns","agent":"onboarding","schema":"onboarding.onboarding-scaffolder","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["what patterns","show patterns","list patterns"]},{"kind":"action","name":"listTemplates","agent":"onboarding","schema":"onboarding.onboarding-scaffolder","enabled":true,"transient":false,"description":"","parameters":[],"phrasings":["show templates","list templates"]},{"kind":"action","name":"packageAgent","agent":"onboarding","schema":"onboarding.onboarding-packaging","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to package"},{"name":"register","type":"boolean","optional":true,"description":"If true, also register the agent with the local TypeAgent dispatcher config"}],"phrasings":["build {integrationName}","package {integrationName} agent"]},{"kind":"action","name":"parseOpenApiSpec","agent":"onboarding","schema":"onboarding.onboarding-discovery","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Name of the integration being onboarded"},{"name":"specSource","type":"string","optional":false,"description":"URL or absolute file path to the OpenAPI 3.x or Swagger 2.x spec"}],"phrasings":["load {integrationName} openapi spec {specSource}","parse openapi spec {specSource} for {integrationName}"]},{"kind":"action","name":"proposeRepair","agent":"onboarding","schema":"onboarding.onboarding-testing","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to propose repairs for"},{"name":"forActions","type":"string[]","optional":true,"description":"If provided, propose repairs only for these specific failing action names"}],"phrasings":["suggest fix for {integrationName} failures","propose repair for {integrationName}"]},{"kind":"action","name":"refineSchema","agent":"onboarding","schema":"onboarding.onboarding-schemagen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name"},{"name":"instructions","type":"string","optional":false,"description":"Specific instructions for the LLM about what to change e.g. \"make the listName parameter optional\" or \"add a sortOrder parameter to sortAction\""}],"phrasings":["update {integrationName} schema {instructions}","refine {integrationName} schema {instructions}"]},{"kind":"action","name":"removePhrase","agent":"onboarding","schema":"onboarding.onboarding-phrasegen","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name"},{"name":"actionName","type":"string","optional":false,"description":"The action name to remove the phrase from"},{"name":"phrase","type":"string","optional":false,"description":"The exact phrase to remove"}],"phrasings":["remove phrase {phrase} from {actionName} in {integrationName}"]},{"kind":"action","name":"resumeOnboarding","agent":"onboarding","schema":"onboarding","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Name of the integration to resume"},{"name":"fromPhase","type":"\"discovery\" | \"phraseGen\" | \"schemaGen\" | \"grammarGen\" | \"scaffolder\" | \"testing\" | \"packaging\"","optional":true,"description":"Optional: override which phase to start from (defaults to current phase in state.json)"}],"phrasings":["continue {integrationName} onboarding","resume onboarding {integrationName}"]},{"kind":"action","name":"runTests","agent":"onboarding","schema":"onboarding.onboarding-testing","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to run tests for"},{"name":"forActions","type":"string[]","optional":true,"description":"Run only tests for these specific action names"},{"name":"limit","type":"number","optional":true,"description":"Maximum number of tests to run (runs all if omitted)"}],"phrasings":["execute {integrationName} tests","run tests for {integrationName}"]},{"kind":"action","name":"scaffoldAgent","agent":"onboarding","schema":"onboarding.onboarding-scaffolder","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to scaffold agent for"},{"name":"pattern","type":"\"schema-grammar\" | \"external-api\" | \"llm-streaming\" | \"sub-agent-orchestrator\" | \"websocket-bridge\" | \"state-machine\" | \"native-platform\" | \"view-ui\" | …","optional":true,"description":"Architectural pattern to use (defaults to \"schema-grammar\")"},{"name":"outputDir","type":"string","optional":true,"description":"Target directory for the agent package (defaults to ts/packages/agents/\u003cname>)"},{"name":"emojiChar","type":"string","optional":true,"description":"Emoji character for the agent icon (defaults to \"🔎\")"}],"phrasings":[]},{"kind":"action","name":"scaffoldPlugin","agent":"onboarding","schema":"onboarding.onboarding-scaffolder","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name to scaffold the host-side plugin for"},{"name":"template","type":"\"office-addin\" | \"vscode-extension\" | \"electron-app\" | \"browser-extension\" | \"rest-client\"","optional":false,"description":"Template to use for the plugin side"},{"name":"outputDir","type":"string","optional":true,"description":"Target directory for the plugin (defaults to ts/packages/agents/\u003cname>/plugin)"}],"phrasings":["create {integrationName} plugin","scaffold {integrationName} plugin"]},{"kind":"action","name":"startOnboarding","agent":"onboarding","schema":"onboarding","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Unique name for this integration (e.g. \"slack\", \"jira\", \"my-rest-api\"). Used as the workspace folder name — lowercase, no spaces."},{"name":"description","type":"string","optional":true,"description":"Human-readable description of what the integration does"},{"name":"apiType","type":"\"rest\" | \"graphql\" | \"websocket\" | \"ipc\" | \"sdk\"","optional":true,"description":"The type of API being integrated; helps select appropriate templates and bridge patterns"}],"phrasings":["begin {integrationName} integration","onboard {integrationName}","start onboarding {integrationName}"]},{"kind":"action","name":"validatePackage","agent":"onboarding","schema":"onboarding.onboarding-packaging","enabled":true,"transient":false,"description":"","parameters":[{"name":"integrationName","type":"string","optional":false,"description":"Integration name whose package to validate"}],"phrasings":["check {integrationName} package","validate {integrationName} package"]}]},{"kind":"agent","name":"powershell","emoji":"📜","description":"Agent to create and execute PowerShell workflows","children":[{"kind":"action","name":"createPowerShellFlow","agent":"powershell","schema":"powershell","enabled":true,"transient":false,"description":"Create a new PowerShell flow with grammar rules for future reuse","parameters":[{"name":"actionName","type":"string","optional":false,"description":"camelCase identifier for the new flow"},{"name":"description","type":"string","optional":false,"description":"What this script does"},{"name":"displayName","type":"string","optional":false,"description":"Human-readable name"},{"name":"script","type":"string","optional":false,"description":"PowerShell script body (should include param() block)"},{"name":"scriptParameters","type":"{ name, type, required, description, default }[]","optional":false,"description":"Script parameters"},{"name":"grammarPatterns","type":"{ pattern, isAlias }[]","optional":false,"description":"Grammar patterns for matching"},{"name":"allowedCmdlets","type":"string[]","optional":false,"description":"PowerShell cmdlets the script uses"},{"name":"allowedModules","type":"string[]","optional":true,"description":"PowerShell modules to import for the script's cmdlets (e.g. [\"NetTCPIP\"] for Get-NetTCPConnection). Include every module required by allowedCmdlets — use the same list that made testPowerShellFlow pass, or the flow will fail at invocation with \"not recognized\"."}],"phrasings":[]},{"kind":"action","name":"deletePowerShellFlow","agent":"powershell","schema":"powershell","enabled":true,"transient":false,"description":"Delete a PowerShell flow by name","parameters":[{"name":"name","type":"string","optional":false,"description":"Name of the PowerShell flow to delete"}],"phrasings":["delete powershell flow {name}"]},{"kind":"action","name":"editPowerShellFlow","agent":"powershell","schema":"powershell","enabled":true,"transient":false,"description":"Edit an existing PowerShell flow's script body (preserves grammar patterns and parameters)","parameters":[{"name":"flowName","type":"string","optional":false,"description":"Name of the PowerShell flow to edit"},{"name":"script","type":"string","optional":false,"description":"New PowerShell script body (should include param() block matching existing parameters)"},{"name":"allowedCmdlets","type":"string[]","optional":false,"description":"Updated list of PowerShell cmdlets the script uses"},{"name":"allowedModules","type":"string[]","optional":true,"description":"Updated list of PowerShell modules to import (optional; preserved if omitted)"}],"phrasings":[]},{"kind":"action","name":"executePowerShellFlow","agent":"powershell","schema":"powershell","enabled":true,"transient":false,"description":"Execute a registered PowerShell flow by name with parameters","parameters":[{"name":"flowName","type":"string","optional":false,"description":"Name of the PowerShell flow to execute (use listPowerShellFlows to see available flows)"},{"name":"flowArgs","type":"string","optional":true,"description":"Captured arguments from the user's request (e.g. a path or filter)"},{"name":"flowParametersJson","type":"string","optional":true,"description":"JSON string of named parameters e.g. '{\"Directory\":\"C:\\\\Users\",\"Pattern\":\"*.txt\"}'"}],"phrasings":[]},{"kind":"action","name":"importPowerShellFlow","agent":"powershell","schema":"powershell","enabled":true,"transient":false,"description":"Import an existing PowerShell script file as a new PowerShell flow","parameters":[{"name":"filePath","type":"string","optional":false,"description":"Absolute or relative path to the .ps1 file to import"},{"name":"actionName","type":"string","optional":true,"description":"Optional: override the generated action name"}],"phrasings":["import script {filePath}"]},{"kind":"action","name":"listPowerShellFlows","agent":"powershell","schema":"powershell","enabled":true,"transient":false,"description":"Lists all registered PowerShell flows","parameters":[],"phrasings":["show me powershell flows"]}]},{"kind":"agent","name":"studio","emoji":"🎨","description":"TypeAgent Studio agent — the AI / conversational presenter of TypeAgent Studio, driving the author → tune → validate developer loop over the Studio engine. Today it surfaces inspection of Studio's environment, grammar collisions, and event stream; the rest of the loop (sandboxes, run, validate, author) is being added.","children":[{"kind":"action","name":"getStudioInfo","agent":"studio","schema":"studio","enabled":true,"transient":false,"description":"Report Studio's environment: the repository root it is inspecting and the directories (\"agent locations\") it scans for agents, with how many agent packages each contains. Use this to confirm Studio is pointed at the right place. Read-only.","parameters":[],"phrasings":[]},{"kind":"action","name":"listCollisions","agent":"studio","schema":"studio","enabled":true,"transient":false,"description":"List the cross-schema grammar collisions Studio currently knows about (newest first). These are populated by collision scans; the list is empty until a scan has run. Read-only.","parameters":[],"phrasings":[]},{"kind":"action","name":"queryEvents","agent":"studio","schema":"studio","enabled":true,"transient":false,"description":"Show the most recent entries from Studio's structured event stream (sandbox/collision/replay/feedback events), oldest-to-newest. Read-only.","parameters":[{"name":"limit","type":"number","optional":true,"description":"Maximum number of recent events to return (default 20)."}],"phrasings":[]}]},{"kind":"agent","name":"taskflow","emoji":"🔁","description":"User-taught macros over TypeAgent actions","children":[{"kind":"action","name":"deleteTaskFlow","agent":"taskflow","schema":"taskflow","enabled":true,"transient":false,"description":"Delete a task flow by name","parameters":[{"name":"name","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"listTaskFlows","agent":"taskflow","schema":"taskflow","enabled":true,"transient":false,"description":"Lists all registered task flows","parameters":[],"phrasings":[]}]},{"kind":"agent","name":"utility","emoji":"🔧","description":"Utility agent — web search, web fetch, and file I/O for compiled task flows","children":[{"kind":"action","name":"claudeTask","agent":"utility","schema":"utility","enabled":true,"transient":false,"description":"","parameters":[{"name":"goal","type":"string","optional":false,"description":"Goal or question for Claude to accomplish using its tools (web search, fetch, etc.)"},{"name":"parseJson","type":"boolean","optional":true,"description":"Parse the result as JSON and store in historyText (default: false)"},{"name":"model","type":"string","optional":true,"description":"Claude model ID (default: claude-haiku-4-5-20251001)"},{"name":"maxTurns","type":"number","optional":true,"description":"Maximum agentic turns (default: 10)"}],"phrasings":[]},{"kind":"action","name":"llmTransform","agent":"utility","schema":"utility","enabled":true,"transient":false,"description":"","parameters":[{"name":"input","type":"string","optional":false,"description":"Text or HTML to transform"},{"name":"prompt","type":"string","optional":false,"description":"Instructions for the transformation"},{"name":"parseJson","type":"boolean","optional":true,"description":"Parse the result as JSON and store in historyText (default: false)"},{"name":"htmlOutput","type":"boolean","optional":true,"description":"When true, LLM is asked to return HTML; result is stored in historyText as HTML (default: false)"},{"name":"model","type":"string","optional":true,"description":"Claude model ID (default: claude-haiku-4-5-20251001)"}],"phrasings":[]},{"kind":"action","name":"readFile","agent":"utility","schema":"utility","enabled":true,"transient":false,"description":"","parameters":[{"name":"path","type":"string","optional":false,"description":"Absolute or relative path to the file"}],"phrasings":["get {path}","read {path}"]},{"kind":"action","name":"webFetch","agent":"utility","schema":"utility","enabled":true,"transient":false,"description":"","parameters":[{"name":"url","type":"string","optional":false,"description":"URL to fetch"}],"phrasings":["get {url}","fetch {url}"]},{"kind":"action","name":"webSearch","agent":"utility","schema":"utility","enabled":true,"transient":false,"description":"","parameters":[{"name":"query","type":"string","optional":false,"description":"Search query text"},{"name":"numResults","type":"number","optional":true,"description":"Number of results to return (default: 5)"}],"phrasings":["look up {query} online","find {query} on the web","web search {query}","search web for {query}"]},{"kind":"action","name":"writeFile","agent":"utility","schema":"utility","enabled":true,"transient":false,"description":"","parameters":[{"name":"path","type":"string","optional":false,"description":"Absolute or relative path to the file"},{"name":"content","type":"string","optional":false,"description":"Text content to write"}],"phrasings":[]}]},{"kind":"agent","name":"visualStudio","emoji":"💻","description":"Visual Studio integration for editor, solution, build, and debug actions via the EnvDTE automation API","children":[{"kind":"action","name":"addBreakpoint","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Adds a new breakpoint to the debugger. IMPORTANT: Ensure the file path and line number are correct. User: \"Can you add a breakpoint at line 42 in main.cpp?\" Agent: \"Adding a breakpoint at line 42 in main.cpp.\"","parameters":[{"name":"file","type":"string","optional":false,"description":"The file where the breakpoint will be added."},{"name":"line","type":"string","optional":false,"description":"The line number where the breakpoint will be added (as a string; handler parses to int)."},{"name":"condition","type":"string","optional":true,"description":"Optional condition for the breakpoint."}],"phrasings":[]},{"kind":"action","name":"break","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Causes the given process to pause its execution so that its current state can be analyzed. User: \"Pause the process right now.\" Agent: \"Pausing the process immediately.\"","parameters":[],"phrasings":["halt the process instantly","stop the current process for debugging","break the execution immediately","pause the process right now"]},{"kind":"action","name":"build","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Causes the active solution configuration to begin building. User: \"Can you start building the solution, please?\" Agent: \"Starting to build the solution.\"","parameters":[{"name":"waitForCompletion","type":"boolean","optional":true,"description":"Whether to wait for the build to complete."}],"phrasings":["begin building the solution","initiate the build process for the current solution","build the active solution configuration","start building the solution"]},{"kind":"action","name":"clean","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Deletes all compiler-generated support files for marked projects. User: \"Can you clean the solution, please?\" Agent: \"Cleaning the solution.\"","parameters":[{"name":"waitForCompletion","type":"boolean","optional":true,"description":"Whether to wait for the clean operation to complete."}],"phrasings":["delete all the build files for the projects","clean up the compiler generated files","marked projects","solution"]},{"kind":"action","name":"closeAll","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Closes all open documents in the environment and optionally saves them. User: \"Close all open files, please.\" Agent: \"Closing all open files.\"","parameters":[{"name":"saveChanges","type":"boolean","optional":true,"description":"Whether to save changes before closing."}],"phrasings":["shut all the documents","close everything that's open and save any changes","the open documents","open files"]},{"kind":"action","name":"debug","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Starts debugging the solution. User: \"Can you start debugging the solution?\" Agent: \"Starting to debug the solution.\"","parameters":[],"phrasings":["debug the solution","begin debugging the project","the debug process for the solution","debugging the solution"]},{"kind":"action","name":"executeCommand","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Executes a command in the Visual Studio environment. User: \"Can you run the command in Visual Studio for me?\" Agent: \"Executing the command in Visual Studio.\"","parameters":[{"name":"commandName","type":"string","optional":false,"description":"The name of the command to execute."},{"name":"commandArgs","type":"string","optional":true,"description":"Optional arguments for the command."}],"phrasings":[]},{"kind":"action","name":"findInFiles","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Performs a search operation across files in the solution. User: \"Can you search for 'searchTerm' in all the files with 'fileTypes' extensions?\" Agent: \"Searching for 'searchTerm' in files with 'fileTypes' extensions.\"","parameters":[{"name":"searchTerm","type":"string","optional":false,"description":"The term to search for in the files."},{"name":"fileTypes","type":"string","optional":true,"description":"Optional file types to limit the search."}],"phrasings":[]},{"kind":"action","name":"findText","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Searches for the given text from the active point to the end of the document. User: \"Can you search for the text 'example' from here to the end of the document?\" Agent: \"Searching for 'example' from the current position to the end of the document.\"","parameters":[{"name":"text","type":"string","optional":false,"description":"The text to search for in the document."},{"name":"caseSensitive","type":"boolean","optional":true,"description":"Optional flags for the search operation."},{"name":"wholeWord","type":"boolean","optional":true,"description":""},{"name":"useRegex","type":"boolean","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"go","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Starts executing the program from the current statement. User: \"Run the program from here.\" Agent: \"Starting execution from the current statement.\"","parameters":[],"phrasings":["begin execution from the current statement","go ahead and run the program from the current line","start executing the code from this point","run the program from here"]},{"kind":"action","name":"gotoLine","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Moves to the beginning of the indicated line and selects the line if requested. User: \"Can you go to line 42 and select it?\" Agent: \"Going to line 42 and selecting it.\"","parameters":[{"name":"line","type":"string","optional":false,"description":"The line number to go to (as a string; handler parses to int)."},{"name":"select","type":"boolean","optional":true,"description":"Whether to select the line after moving to it."}],"phrasings":["navigate to line {line} without selecting it","jump to line {line} and highlight it","move to line {line}, but don't select it","go to line {line} and select it"]},{"kind":"action","name":"openFile","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Opens a file in the Visual Studio environment. User: \"Can you open the file located at [filePath] in Visual Studio?\" Agent: \"Opening the file at [filePath] in Visual Studio.\"","parameters":[{"name":"filePath","type":"string","optional":false,"description":"The path of the file to open."},{"name":"viewKind","type":"\"text\" | \"code\" | \"designer\" | \"debug\"","optional":true,"description":"Default behavior is \"text\". Valid values: \"text\" | \"code\" | \"designer\" | \"debug\". The view kind to use when opening the file."}],"phrasings":[]},{"kind":"action","name":"redo","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Re-executes the last action that was undone by the Undo() method or the user. User: \"Can you redo the last change I undid?\" Agent: \"Redoing the last undone change.\"","parameters":[],"phrasings":["reapply the last undone action","redo the previous action","thing I reversed","change I undid"]},{"kind":"action","name":"removeBreakpoint","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Removes an existing breakpoint from the debugger. User: \"Please remove the breakpoint with ID 12345.\" Agent: \"Removing the breakpoint with ID 12345.\"","parameters":[{"name":"breakpointId","type":"string","optional":true,"description":"One of {breakpointId} or {file+line} must be provided. The ID of the breakpoint to be removed."},{"name":"file","type":"string","optional":true,"description":"The file where the breakpoint is located."},{"name":"line","type":"string","optional":true,"description":"The line number where the breakpoint is located (as a string; handler parses to int)."}],"phrasings":[]},{"kind":"action","name":"run","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Causes the active solution configuration to execute. User: \"Can you run the current solution for me?\" Agent: \"Running the current solution.\"","parameters":[],"phrasings":["start running the solution","execute the active solution configuration","active configuration","current solution"]},{"kind":"action","name":"saveAll","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Saves all documents currently open in the environment. User: \"Can you save all my open files, please?\" Agent: \"Saving all open files.\"","parameters":[],"phrasings":["save everything I'm working on","the files","documents currently open","my open files"]},{"kind":"action","name":"stepInto","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Steps into the next function call, if possible. User: \"Can you step into the next function call, please?\" Agent: \"Stepping into the next function call.\"","parameters":[],"phrasings":["function","function call"]},{"kind":"action","name":"stepOut","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Steps out of the current function. User: \"Can you step out of the current function, please?\" Agent: \"Stepping out of the current function.\"","parameters":[],"phrasings":["step out of this function","step out of the function","function"]},{"kind":"action","name":"stepOver","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Steps over the next function call. User: \"Can you step over the next function call, please?\" Agent: \"Stepping over the next function call.\"","parameters":[],"phrasings":["call"]},{"kind":"action","name":"stop","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Stops debugging, terminating, or detaching from all attached processes. User: \"Please stop the debugging process.\" Agent: \"Stopping the debugging process.\"","parameters":[],"phrasings":["end the current debugging session","terminate all attached processes","debugging and detach from everything","the debugging process"]},{"kind":"action","name":"undo","agent":"visualStudio","schema":"visualStudio","enabled":true,"transient":false,"description":"Reverses the action last performed by the user in the document. User: \"Can you undo my last change?\" Agent: \"Undoing the last change.\"","parameters":[],"phrasings":["reverse the last action I did","last thing I did","previous edit","undo my last change"]}]},{"kind":"agent","name":"workflow","emoji":"🔄","description":"Run automated developer workflows via chat","children":[{"kind":"action","name":"noWorkflowsLoaded","agent":"workflow","schema":"workflow","enabled":false,"transient":false,"description":"Placeholder: replaced at runtime by getDynamicSchema() with per-workflow action types derived from discovered workflow files.","parameters":[],"phrasings":[]}]}]},{"kind":"category","name":"System & Devices","emoji":"⚙️","children":[{"kind":"agent","name":"desktop","emoji":"🪟","description":"Agent to control the desktop","children":[{"kind":"action","name":"AdjustColorTemperature","agent":"desktop","schema":"desktop.desktop-display","enabled":false,"transient":false,"description":"Adjusts the color temperature for Night Light","parameters":[{"name":"filterEffect","type":"\"reduce\" | \"increase\"","optional":true,"description":""}],"phrasings":["cooler colors","warmer colors","increase blue light","reduce blue light","adjust color temperature"]},{"kind":"action","name":"AdjustMousePointerSize","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Adjusts mouse pointer size","parameters":[{"name":"sizeAdjustment","type":"\"increase\" | \"decrease\"","optional":false,"description":""}],"phrasings":["smaller cursor","bigger cursor","smaller","bigger","decrease pointer size","increase pointer size"]},{"kind":"action","name":"AdjustScreenBrightness","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Adjusts screen brightness (increase or decrease)","parameters":[{"name":"brightnessLevel","type":"\"increase\" | \"decrease\"","optional":false,"description":""}],"phrasings":["brighten screen","dim screen","screen dimmer","screen brighter","decrease brightness","increase brightness"]},{"kind":"action","name":"AdjustScreenOrientation","agent":"desktop","schema":"desktop.desktop-display","enabled":false,"transient":false,"description":"Adjusts screen orientation between portrait and landscape","parameters":[{"name":"orientation","type":"\"portrait\" | \"landscape\"","optional":false,"description":""}],"phrasings":["portrait","landscape","orientation to portrait","orientation to landscape"]},{"kind":"action","name":"AdjustVolume","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Adjusts system volume up or down by a relative amount","parameters":[{"name":"direction","type":"\"up\" | \"down\"","optional":false,"description":""},{"name":"amount","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"ApplyColorToTitleBar","agent":"desktop","schema":"desktop.desktop-personalization","enabled":false,"transient":false,"description":"Applies accent color to title bars","parameters":[{"name":"enableColor","type":"boolean","optional":false,"description":""}],"phrasings":["remove title bar color","disable title bar color","enable title bar color","show accent color on title bars","apply color to title bar"]},{"kind":"action","name":"ApplyTheme","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Apply a Windows desktop theme by name (e.g. \"Captured Motion\", \"Glow\", \"Sunrise\") or .theme file path. Affects the Windows wallpaper / sounds / cursors / window chrome. Example: User: change my windows theme to Glow Agent: { actionName: \"ApplyTheme\", parameters: { filePath: \"Glow\", themeName: \"Glow\" } }","parameters":[{"name":"filePath","type":"string","optional":false,"description":"The Windows theme name or .theme file path to apply (use \"previous\" to revert)."},{"name":"themeName","type":"string","optional":true,"description":"Optional theme name parroted by the LLM when the user mentions a specific theme; never read by the action — exists only to give the model a slot for the name so it doesn't squeeze a VS Code editor theme into `filePath`."}],"phrasings":[]},{"kind":"action","name":"AutoHideTaskbar","agent":"desktop","schema":"desktop.desktop-taskbar","enabled":false,"transient":false,"description":"Auto-hides the taskbar","parameters":[{"name":"hideWhenNotUsing","type":"boolean","optional":false,"description":""},{"name":"alwaysShow","type":"boolean","optional":false,"description":""}],"phrasings":["show taskbar","hide taskbar","always show taskbar","automatically hide taskbar","auto hide taskbar"]},{"kind":"action","name":"AutomaticDSTAdjustment","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables automatic DST adjustment","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["automatically adjust for dst","disable automatic dst","daylight saving time adjustment","automatic dst"]},{"kind":"action","name":"AutomaticTimeSettingAction","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables automatic time synchronization","parameters":[{"name":"enableAutoTimeSync","type":"boolean","optional":false,"description":""}],"phrasings":["sync time automatically","automatically set time","disable automatic time sync","enable automatic time sync"]},{"kind":"action","name":"BatterySaverActivationLevel","agent":"desktop","schema":"desktop.desktop-power","enabled":false,"transient":false,"description":"Sets the battery saver activation threshold","parameters":[{"name":"thresholdValue","type":"number","optional":false,"description":""}],"phrasings":["turn on battery saver at {level}","activate battery saver at {level}","battery saver at {level}","set battery saver to {level}"]},{"kind":"action","name":"BluetoothToggle","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"===== Common Settings Actions ===== Toggles Bluetooth radio on or off","parameters":[{"name":"enableBluetooth","type":"boolean","optional":true,"description":""}],"phrasings":["toggle bluetooth","disable bluetooth","enable bluetooth","off bluetooth","on bluetooth"]},{"kind":"action","name":"CloseProgram","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Closes a program window on a Windows Desktop","parameters":[{"name":"name","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""}],"phrasings":["exit {program}","quit {program}","close {program}"]},{"kind":"action","name":"ConnectWifi","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[{"name":"ssid","type":"string","optional":false,"description":""},{"name":"password","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"CreateDesktop","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"creates a new Windows Desktop","parameters":[{"name":"names","type":"string[]","optional":false,"description":""}],"phrasings":["desktop"]},{"kind":"action","name":"CursorTrail","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Enables or disables the mouse cursor trail and sets its length","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""},{"name":"length","type":"number","optional":true,"description":""}],"phrasings":["off cursor trail","on cursor trail","mouse trail","cursor trail"]},{"kind":"action","name":"Debug","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Attaches the debugger to the AutoShell process","parameters":[],"phrasings":[]},{"kind":"action","name":"DisconnectWifi","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Disconnects from the current wifi network","parameters":[],"phrasings":["disconnect wifi"]},{"kind":"action","name":"DisplayResolutionAndAspectRatio","agent":"desktop","schema":"desktop.desktop-display","enabled":false,"transient":false,"description":"Opens display settings to adjust resolution and aspect ratio","parameters":[],"phrasings":["open display settings","adjust resolution","aspect ratio","resolution"]},{"kind":"action","name":"DisplayScaling","agent":"desktop","schema":"desktop.desktop-display","enabled":false,"transient":false,"description":"Sets display scaling percentage (100, 125, 150, 175, 200)","parameters":[{"name":"sizeOverride","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"DisplaySecondsInSystrayClock","agent":"desktop","schema":"desktop.desktop-taskbar","enabled":false,"transient":false,"description":"Shows seconds in the system tray clock","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["disable seconds in clock","turn off seconds in clock","display seconds in clock","hide seconds in clock","only hours and minutes","seconds in clock"]},{"kind":"action","name":"DisplayTaskbarOnAllMonitors","agent":"desktop","schema":"desktop.desktop-taskbar","enabled":false,"transient":false,"description":"Shows taskbar on all monitors","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["hide taskbar from other monitors","show taskbar only on main monitor","displays","monitors"]},{"kind":"action","name":"EnableBlueLightFilterSchedule","agent":"desktop","schema":"desktop.desktop-display","enabled":false,"transient":false,"description":"Enables or disables blue light filter schedule (Night Light)","parameters":[{"name":"schedule","type":"string","optional":false,"description":""},{"name":"nightLightScheduleDisabled","type":"boolean","optional":false,"description":""}],"phrasings":["off night light","on night light","blue light filter","night light"]},{"kind":"action","name":"EnableFilterKeysAction","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables Filter Keys","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["off filter keys","on filter keys","disable filter keys","enable filter keys"]},{"kind":"action","name":"EnableGameMode","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables Game Mode","parameters":[],"phrasings":["turn on game mode","open game mode","enable game mode"]},{"kind":"action","name":"EnableMagnifier","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables Magnifier","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["off magnifier","on magnifier","stop magnifier","start magnifier","disable magnifier","enable magnifier"]},{"kind":"action","name":"EnableMeteredConnections","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables metered connection settings","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":["off metered connection","on metered connection","disable metered connection","enable metered connection"]},{"kind":"action","name":"EnableNarratorAction","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables Narrator","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["off narrator","on narrator","stop narrator","start narrator","disable narrator","enable narrator"]},{"kind":"action","name":"EnableQuietHours","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables Focus Assist (Quiet Hours)","parameters":[{"name":"startHour","type":"number","optional":true,"description":""},{"name":"endHour","type":"number","optional":true,"description":""}],"phrasings":["do not disturb","open focus assist","turn on quiet hours","focus assist","quiet hours"]},{"kind":"action","name":"EnableStickyKeys","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables Sticky Keys","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":["off sticky keys","on sticky keys","disable sticky keys","enable sticky keys"]},{"kind":"action","name":"EnableTouchPad","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Enables or disables the touchpad","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":["off touchpad","on touchpad","disable touchpad","enable touchpad"]},{"kind":"action","name":"EnableTransparency","agent":"desktop","schema":"desktop.desktop-personalization","enabled":false,"transient":false,"description":"Enables or disables transparency effects","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":["off transparency","on transparency","disable transparency","enable transparency"]},{"kind":"action","name":"EnableWifi","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Enables or disables WiFi adapter","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":["disable wifi","enable wifi","wi-fi","wifi"]},{"kind":"action","name":"EnhancePointerPrecision","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Enables or disables enhanced pointer precision (mouse acceleration)","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["off mouse acceleration","on mouse acceleration","mouse acceleration","enhanced pointer precision"]},{"kind":"action","name":"HighContrastTheme","agent":"desktop","schema":"desktop.desktop-personalization","enabled":false,"transient":false,"description":"Opens the high contrast accessibility settings page. Only use when the user explicitly asks for high contrast settings.","parameters":[],"phrasings":["use high contrast","open high contrast","turn on high contrast","enable high contrast"]},{"kind":"action","name":"LaunchProgram","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Launches a new program window on a Windows Desktop Example: user: Launch edge agent: { \"actionName\": \"LaunchProgram\", \"parameters\": { \"name\": \"edge\" } }","parameters":[{"name":"name","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""}],"phrasings":["run {program}","start {program}","open {program}","launch {program}"]},{"kind":"action","name":"ListResolutions","agent":"desktop","schema":"desktop.desktop-display","enabled":false,"transient":false,"description":"Lists available display resolutions for the current monitor","parameters":[],"phrasings":["what resolutions","show resolutions","list resolutions"]},{"kind":"action","name":"ListThemes","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Lists all installed Windows themes","parameters":[],"phrasings":[]},{"kind":"action","name":"ListWifiNetworks","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Lists available WiFi networks","parameters":[],"phrasings":["what wifi networks","show wifi networks","list wifi networks"]},{"kind":"action","name":"ManageCameraAccess","agent":"desktop","schema":"desktop.desktop-privacy","enabled":false,"transient":false,"description":"Manages camera access for apps","parameters":[{"name":"accessSetting","type":"\"allow\" | \"deny\"","optional":true,"description":""}],"phrasings":["off camera","on camera","disable camera","enable camera","deny camera access","allow camera access"]},{"kind":"action","name":"ManageLocationAccess","agent":"desktop","schema":"desktop.desktop-privacy","enabled":false,"transient":false,"description":"Manages location access for apps","parameters":[{"name":"accessSetting","type":"\"allow\" | \"deny\"","optional":true,"description":""}],"phrasings":["off location","on location","disable location","enable location","deny location access","allow location access"]},{"kind":"action","name":"ManageMicrophoneAccess","agent":"desktop","schema":"desktop.desktop-privacy","enabled":false,"transient":false,"description":"Manages microphone access for apps","parameters":[{"name":"accessSetting","type":"\"allow\" | \"deny\"","optional":false,"description":""}],"phrasings":["off microphone","on microphone","disable microphone","enable microphone","deny microphone access","allow microphone access"]},{"kind":"action","name":"Maximize","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Maximizes a program window on a Windows Desktop","parameters":[{"name":"name","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""}],"phrasings":["make {program} full screen","maximize {program}"]},{"kind":"action","name":"Minimize","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Minimizes a program window on a Windows Desktop","parameters":[{"name":"name","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""}],"phrasings":["hide {program}","minimize {program}"]},{"kind":"action","name":"MinimizeWindowsOnMonitorDisconnectAction","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Minimizes windows when a monitor is disconnected","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["keep windows when monitor disconnects","when monitor disconnects","on disconnect"]},{"kind":"action","name":"MonoAudioToggle","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Enables or disables mono audio","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["off mono audio","on mono audio","disable mono audio","enable mono audio"]},{"kind":"action","name":"MouseCursorSpeed","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Adjusts mouse cursor speed","parameters":[{"name":"speedLevel","type":"number","optional":false,"description":""},{"name":"reduceSpeed","type":"boolean","optional":true,"description":""}],"phrasings":["mouse speed {level}","change mouse sensitivity to {level}","adjust mouse speed to {level}","set mouse speed to {level}"]},{"kind":"action","name":"MousePointerCustomization","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Customizes mouse pointer color","parameters":[{"name":"color","type":"string","optional":false,"description":""},{"name":"style","type":"string","optional":true,"description":""}],"phrasings":["set mouse pointer color to {color}","change mouse pointer to {color}","customize mouse pointer to {color}"]},{"kind":"action","name":"MouseWheelScrollLines","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Sets the number of lines to scroll per mouse wheel notch","parameters":[{"name":"scrollLines","type":"number","optional":false,"description":""}],"phrasings":["scroll {lines} lines","set scroll lines to {lines}"]},{"kind":"action","name":"MoveWindowToDesktop","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[{"name":"name","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""},{"name":"desktopId","type":"number","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"Mute","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[{"name":"on","type":"boolean","optional":false,"description":""}],"phrasings":["unmute","mute"]},{"kind":"action","name":"NextDesktop","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"switches to the next Windows Desktop","parameters":[],"phrasings":["next desktop"]},{"kind":"action","name":"PinWindow","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[{"name":"name","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"PreviousDesktop","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"switches to the previous Windows Desktop","parameters":[],"phrasings":["previous desktop"]},{"kind":"action","name":"RememberWindowLocations","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Remembers window locations based on monitor configuration","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":["forget window locations","positions","locations"]},{"kind":"action","name":"RestartService","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Restarts a Windows service (stops it and starts it again). The target can be identified either by its service name / display name, or by a phrase found in the service's description. Example: User: restart the print spooler service Agent: { actionName: \"RestartService\", parameters: { service: \"Print Spooler\", matchBy: \"name\" } } Example: User: restart the service that manages windows updates Agent: { actionName: \"RestartService\", parameters: { service: \"windows update\", matchBy: \"description\" } }","parameters":[{"name":"service","type":"string","optional":false,"description":"The Windows service name or display name (e.g. \"Spooler\" or \"Print Spooler\") when matchBy is \"name\"; or a phrase to search for within service descriptions when matchBy is \"description\"."},{"name":"matchBy","type":"\"name\" | \"description\"","optional":true,"description":"How to locate the service. \"name\" (the default) matches the service name or display name; \"description\" searches each service's description text for the provided phrase."},{"name":"elevate","type":"boolean","optional":true,"description":"Internal use only: set to true by the agent after the user has agreed to run the restart with administrator privileges. Never set this from the user's initial request — leave it unset so the agent asks for consent first."}],"phrasings":[]},{"kind":"action","name":"RestoreVolume","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[],"phrasings":["restore volume"]},{"kind":"action","name":"RotationLock","agent":"desktop","schema":"desktop.desktop-display","enabled":false,"transient":false,"description":"Locks or unlocks screen rotation","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["disable rotation lock","enable rotation lock","unlock rotation","lock rotation"]},{"kind":"action","name":"SetPowerModeOnBattery","agent":"desktop","schema":"desktop.desktop-power","enabled":false,"transient":false,"description":"Sets power mode when on battery","parameters":[{"name":"mode","type":"string","optional":true,"description":""}],"phrasings":["power saver","best performance","set battery power mode to balanced","power efficiency","performance"]},{"kind":"action","name":"SetPowerModePluggedIn","agent":"desktop","schema":"desktop.desktop-power","enabled":false,"transient":false,"description":"Sets power mode when plugged in","parameters":[{"name":"powerMode","type":"\"bestPerformance\" | \"balanced\" | \"bestPowerEfficiency\"","optional":false,"description":""}],"phrasings":["use best performance","power saver mode","balanced mode","best performance mode","set power mode to balanced","power efficiency","performance"]},{"kind":"action","name":"SetPrimaryMouseButton","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Sets the primary mouse button","parameters":[{"name":"primaryButton","type":"\"left\" | \"right\"","optional":false,"description":""}],"phrasings":["right handed mouse","left handed mouse","swap mouse buttons","right","left"]},{"kind":"action","name":"SetScreenResolution","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Change screen resolution","parameters":[{"name":"width","type":"number","optional":false,"description":""},{"name":"height","type":"number","optional":false,"description":""},{"name":"refreshRate","type":"number","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"SetTextSize","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Changes the text size that appears throughout Windows and your apps","parameters":[{"name":"size","type":"number","optional":false,"description":"small changes are 5% increments, large changes are 25% increments"}],"phrasings":[]},{"kind":"action","name":"SetThemeMode","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Sets the theme mode of the current [windows] desktop","parameters":[{"name":"mode","type":"\"light\" | \"dark\" | \"toggle\"","optional":false,"description":""}],"phrasings":["light","dark","light mode","dark mode","toggle mode"]},{"kind":"action","name":"SetWallpaper","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[{"name":"filePath","type":"string","optional":true,"description":""},{"name":"url","type":"string","optional":true,"description":""}],"phrasings":[]},{"kind":"action","name":"ShowBadgesOnTaskbar","agent":"desktop","schema":"desktop.desktop-taskbar","enabled":false,"transient":false,"description":"Shows or hides badges on taskbar icons","parameters":[{"name":"enableBadging","type":"boolean","optional":true,"description":""}],"phrasings":["disable taskbar badges","enable taskbar badges","hide taskbar badges","show taskbar badges"]},{"kind":"action","name":"ShowFileExtensions","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Shows or hides file extensions in File Explorer","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["display file extensions","hide file extensions","show file extensions"]},{"kind":"action","name":"ShowHiddenAndSystemFiles","agent":"desktop","schema":"desktop.desktop-system","enabled":false,"transient":false,"description":"Shows or hides hidden and system files in File Explorer","parameters":[{"name":"enable","type":"boolean","optional":true,"description":""}],"phrasings":["display hidden files","hide hidden files","system files","hidden files"]},{"kind":"action","name":"SwitchDesktop","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[{"name":"desktopId","type":"number","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"SwitchTo","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Sets focus to a program window on a Windows Desktop. Example: User: switch to Chrome Agent: { actionName: \"SwitchTo\", parameters: { name: \"Chrome\" } }","parameters":[{"name":"name","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""}],"phrasings":["go to {program}","focus {program}","switch to {program}"]},{"kind":"action","name":"SystemThemeMode","agent":"desktop","schema":"desktop.desktop-personalization","enabled":false,"transient":false,"description":"Sets the system-wide theme mode to light or dark (affects apps, taskbar, and Start menu). Only for light/dark mode, not for named themes.","parameters":[{"name":"mode","type":"\"light\" | \"dark\"","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"TaskbarAlignment","agent":"desktop","schema":"desktop.desktop-taskbar","enabled":false,"transient":false,"description":"Sets taskbar alignment (left or center)","parameters":[{"name":"alignment","type":"\"left\" | \"center\"","optional":false,"description":""}],"phrasings":["left align taskbar","left","center","center taskbar"]},{"kind":"action","name":"TaskViewVisibility","agent":"desktop","schema":"desktop.desktop-taskbar","enabled":false,"transient":false,"description":"Shows or hides the Task View button","parameters":[{"name":"visibility","type":"boolean","optional":false,"description":""}],"phrasings":["disable task view","enable task view","hide task view","show task view"]},{"kind":"action","name":"Tile","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Positions program windows on a program window on a Windows Desktop","parameters":[{"name":"leftWindow","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""},{"name":"rightWindow","type":"\"chrome\" | \"word\" | \"excel\" | \"powerpoint\" | \"outlook\" | \"edge\" | \"visual studio\" | \"visual studio code\" | … | string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"ToggleAirplaneMode","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":["off airplane mode","on airplane mode","disable airplane mode","enable airplane mode"]},{"kind":"action","name":"ToggleMouseSonar","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Enables or disables the \"Find my pointer\" sonar ring when pressing Ctrl","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"ToggleNotifications","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"Shows/hides windows notification center","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":["toggle notifications","hide notifications","show notifications"]},{"kind":"action","name":"ToggleWidgetsButtonVisibility","agent":"desktop","schema":"desktop.desktop-taskbar","enabled":false,"transient":false,"description":"Shows or hides the Widgets button","parameters":[{"name":"visibility","type":"\"show\" | \"hide\"","optional":false,"description":""}],"phrasings":["disable widgets","enable widgets","hide widgets","show widgets"]},{"kind":"action","name":"TouchpadCursorSpeed","agent":"desktop","schema":"desktop.desktop-input","enabled":false,"transient":false,"description":"Adjusts touchpad cursor speed","parameters":[{"name":"speed","type":"number","optional":true,"description":""}],"phrasings":["touchpad speed {speed}","adjust touchpad sensitivity","set touchpad speed to {speed}"]},{"kind":"action","name":"Volume","agent":"desktop","schema":"desktop","enabled":false,"transient":false,"description":"","parameters":[{"name":"targetVolume","type":"number","optional":false,"description":""}],"phrasings":["volume {level}","set volume to {level}"]}]},{"kind":"agent","name":"ipconfig","emoji":"🔎","description":"Windows IP configuration command-line tool that displays and manages network adapter settings","children":[{"kind":"action","name":"displayDHCPClassIDs","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Can you show me the DHCP class IDs for the adapter?\" Agent: \"Displaying the DHCP class IDs for the adapter.\" User: \"Please display the DHCP class IDs for the network adapter.\" Agent: \"Displaying the DHCP class IDs for the network adapter.\" User: \"I need to see the DHCP class IDs for my adapter.\" Agent: \"Displaying the DHCP class IDs for the adapter.\" Displays all the DHCP class IDs allowed for the adapter.","parameters":[],"phrasings":["what are the dhcp class ids for the specified adapter","i need to see the dhcp class ids for my adapter","please display the dhcp class ids for the network adapter","can you show me the dhcp class ids for the adapter"]},{"kind":"action","name":"displayDNSResolverCacheContents","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Show me the DNS cache contents.\" Agent: \"Displaying the contents of the DNS resolver cache.\" User: \"Can you display the DNS resolver cache?\" Agent: \"Displaying the contents of the DNS resolver cache.\" User: \"I'd like to see the DNS resolver cache details.\" Agent: \"Displaying the contents of the DNS resolver cache.\" Displays the contents of the DNS Resolver Cache.","parameters":[],"phrasings":["please provide the contents of the dns cache","i'd like to see the dns resolver cache details","can you display the dns resolver cache","show me the dns cache contents"]},{"kind":"action","name":"displayFullConfigurationInformation","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Show me the full network configuration details.\" Agent: \"Displaying full network configuration details.\" User: \"Can you display all the configuration information for my network?\" Agent: \"Displaying full network configuration details.\" User: \"I need to see the complete IP configuration.\" Agent: \"Displaying full network configuration details.\" Displays full configuration information.","parameters":[],"phrasings":["please provide the full configuration info for my network adapters","i need to see the complete ip configuration","what is my ip address","what's my ip address","can you display all the configuration information for my network","show me the full network configuration details"]},{"kind":"action","name":"displayHelpMessage","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Can you show me the help message for ipconfig?\" Agent: \"Displaying the help message for ipconfig.\" User: \"I need some help with ipconfig, please display the help message.\" Agent: \"Displaying the help message for ipconfig.\" User: \"What's the help message for ipconfig?\" Agent: \"Displaying the help message for ipconfig.\" Displays the help message for ipconfig.","parameters":[],"phrasings":["could you display the ipconfig help message","what's the help message for ipconfig","i need some help with ipconfig please display the help message","can you show me the help message for ipconfig"]},{"kind":"action","name":"displayIPv6DHCPClassIDs","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Can you show me the IPv6 DHCP class IDs for the adapter?\" Agent: \"Displaying the IPv6 DHCP class IDs for the adapter.\" User: \"Please display the IPv6 DHCP class IDs for the network adapter.\" Agent: \"Displaying the IPv6 DHCP class IDs for the network adapter.\" User: \"What are the IPv6 DHCP class IDs allowed for the adapter?\" Agent: \"Displaying the IPv6 DHCP class IDs for the adapter.\" Displays all the IPv6 DHCP class IDs allowed for the adapter.","parameters":[],"phrasings":["i'd like to see the ipv6 dhcp class ids for my adapter","what are the ipv6 dhcp class ids allowed for the adapter","please display the ipv6 dhcp class ids for the network adapter","can you show me the ipv6 dhcp class ids for the adapter"]},{"kind":"action","name":"modifyDHCPClassID","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Can you change the DHCP class ID for the Ethernet adapter to 'newClassID'?\" Agent: \"Modifying the DHCP class ID for the Ethernet adapter to 'newClassID'.\" User: \"Please update the DHCP class ID on the Wi-Fi adapter to 'newClassID'.\" Agent: \"Modifying the DHCP class ID for the Wi-Fi adapter to 'newClassID'.\" User: \"Set the DHCP class ID for the 'Local Area Connection' adapter to 'newClassID'.\" Agent: \"Modifying the DHCP class ID for the 'Local Area Connection' adapter to 'newClassID'.\" Modifies the DHCP class ID.","parameters":[{"name":"adapter","type":"string","optional":false,"description":"The name of the network adapter."},{"name":"classID","type":"string","optional":true,"description":"The new DHCP class ID."}],"phrasings":["i'd like to modify the dhcp class id for the {adapter} adapter use {classID}","set the dhcp class id for the {adapter} adapter to {classID}","please update the dhcp class id on the {adapter} adapter to {classID}","can you change the dhcp class id for the {adapter} adapter to {classID}"]},{"kind":"action","name":"modifyIPv6DHCPClassID","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Can you change the IPv6 DHCP class ID for the adapter named 'Ethernet' to 'newClassID'?\" Agent: \"Modifying the IPv6 DHCP class ID for the 'Ethernet' adapter to 'newClassID'.\" User: \"Please update the IPv6 DHCP class ID for my Wi-Fi adapter to 'classID123'.\" Agent: \"Modifying the IPv6 DHCP class ID for the Wi-Fi adapter to 'classID123'.\" User: \"Set the IPv6 DHCP class ID to 'classID456' for the network adapter 'Local Area Connection'.\" Agent: \"Modifying the IPv6 DHCP class ID for the 'Local Area Connection' adapter to 'classID456'.\" Modifies the IPv6 DHCP class ID.","parameters":[{"name":"adapter","type":"string","optional":false,"description":"The name of the network adapter."},{"name":"classID","type":"string","optional":true,"description":"The new IPv6 DHCP class ID."}],"phrasings":["i'd like to modify the ipv6 dhcp class id for {adapter} adapter to {classID}","set the ipv6 dhcp class id to {classID} for the network adapter {adapter}","please update the ipv6 dhcp class id for my {adapter} adapter to {classID}","can you change the ipv6 dhcp class id for the adapter named {adapter} to {classID}"]},{"kind":"action","name":"purgeDNSResolverCache","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Clear the DNS cache, please.\" Agent: \"Purging the DNS resolver cache.\" User: \"Can you purge the DNS resolver cache?\" Agent: \"Purging the DNS resolver cache.\" User: \"I need to flush the DNS cache.\" Agent: \"Purging the DNS resolver cache.\" Purges the DNS Resolver cache.","parameters":[],"phrasings":["please empty the dns resolver cache","i need to flush the dns cache","can you purge the dns resolver cache","clear the dns cache please"]},{"kind":"action","name":"refreshDHCPLeasesAndReRegisterDNSNames","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Can you refresh the DHCP leases and re-register the DNS names for me?\" Agent: \"Refreshing all DHCP leases and re-registering DNS names.\" User: \"Please update the DHCP leases and DNS registrations.\" Agent: \"Refreshing all DHCP leases and re-registering DNS names.\" User: \"I need to refresh all DHCP leases and re-register the DNS names.\" Agent: \"Refreshing all DHCP leases and re-registering DNS names.\" Refreshes all DHCP leases and re-registers DNS names.","parameters":[],"phrasings":["could you refresh the dhcp leases and re register the dns names","i need to refresh all dhcp leases and re register the dns names","please update the dhcp leases and dns registrations","can you refresh the dhcp leases and re register the dns names for me"]},{"kind":"action","name":"releaseIPv4Address","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Please release the IPv4 address for the Ethernet adapter.\" Agent: \"Releasing the IPv4 address for the Ethernet adapter.\" User: \"Can you release the IPv4 address on my Wi-Fi adapter?\" Agent: \"Releasing the IPv4 address for the Wi-Fi adapter.\" User: \"Release the IPv4 address for the network adapter named 'Local Area Connection'.\" Agent: \"Releasing the IPv4 address for the 'Local Area Connection' adapter.\" Releases the IPv4 address for the specified adapter.","parameters":[{"name":"adapter","type":"string","optional":true,"description":"The name of the network adapter."}],"phrasings":["i need to release the ipv4 address for the adapter called {adapter}","release the ipv4 address for the network adapter named {adapter}","can you release the ipv4 address on my {adapter} adapter","please release the ipv4 address for the {adapter} adapter"]},{"kind":"action","name":"releaseIPv6Address","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Please release the IPv6 address for the adapter named 'Ethernet'.\" Agent: \"Releasing the IPv6 address for the 'Ethernet' adapter.\" User: \"Can you release the IPv6 address on my Wi-Fi adapter?\" Agent: \"Releasing the IPv6 address for the Wi-Fi adapter.\" User: \"I need to release the IPv6 address for the 'Local Area Connection' adapter.\" Agent: \"Releasing the IPv6 address for the 'Local Area Connection' adapter.\" Releases the IPv6 address for the specified adapter.","parameters":[{"name":"adapter","type":"string","optional":true,"description":"The name of the network adapter."}],"phrasings":["release the ipv6 address for the {adapter} please","i need to release the ipv6 address for the {adapter} adapter","can you release the ipv6 address on my {adapter} adapter","please release the ipv6 address for the adapter named {adapter}"]},{"kind":"action","name":"renewIPv4Address","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Can you renew the IPv4 address for the Ethernet adapter?\" Agent: \"Renewing the IPv4 address for the Ethernet adapter.\" User: \"Please refresh the IPv4 address for my Wi-Fi adapter.\" Agent: \"Renewing the IPv4 address for the Wi-Fi adapter.\" User: \"Renew the IPv4 address for the network adapter named 'Local Area Connection'.\" Agent: \"Renewing the IPv4 address for the 'Local Area Connection' adapter.\" Renews the IPv4 address for the specified adapter.","parameters":[{"name":"adapter","type":"string","optional":true,"description":"The name of the network adapter."}],"phrasings":["i need to renew the ipv4 address for the {adapter}","renew the ipv4 address for the network adapter named {adapter}","please refresh the ipv4 address for my {adapter} adapter","can you renew the ipv4 address for the {adapter} adapter"]},{"kind":"action","name":"renewIPv6Address","agent":"ipconfig","schema":"ipconfig","enabled":true,"transient":false,"description":"User: \"Can you renew the IPv6 address for the adapter named 'Ethernet'?\" Agent: \"Renewing the IPv6 address for the 'Ethernet' adapter.\" User: \"Please refresh the IPv6 address for my Wi-Fi adapter.\" Agent: \"Renewing the IPv6 address for the Wi-Fi adapter.\" User: \"Renew the IPv6 address for the 'Local Area Connection' adapter.\" Agent: \"Renewing the IPv6 address for the 'Local Area Connection' adapter.\" Renews the IPv6 address for the specified adapter.","parameters":[{"name":"adapter","type":"string","optional":true,"description":"The name of the network adapter."}],"phrasings":["i need to update the ipv6 address for the {adapter}","renew the ipv6 address for the {adapter} adapter","please refresh the ipv6 address for my {adapter} adapter","can you renew the ipv6 address for the adapter named {adapter}"]}]},{"kind":"agent","name":"osNotifications","emoji":"🔔","description":"Forwards OS-level notifications (Windows Action Center, Linux freedesktop) into chat. Off by default; opt in via @config agent enable osNotifications.","children":[{"kind":"action","name":"syncOsNotifications","agent":"osNotifications","schema":"osNotifications","enabled":false,"transient":false,"description":"Re-emit currently-present OS notifications through the agent pipeline. Triggers the build prompt (yes/no card) when the helper exe is missing. Windows only; surfaces a warning on Linux/macOS.","parameters":[],"phrasings":["'sync' 'notification' 's'?"]},{"kind":"action","name":"testOsNotification","agent":"osNotifications","schema":"osNotifications","enabled":false,"transient":false,"description":"Inject a synthetic notification through the agent pipeline (filters, rate limit, dismiss tracking) — useful for verifying the agent end-to-end without an OS notification source.","parameters":[{"name":"message","type":"string","optional":false,"description":"Notification body text."},{"name":"app","type":"string","optional":true,"description":"Optional app name to attach (matched against allowList/blockList)."},{"name":"title","type":"string","optional":true,"description":"Optional notification title."}],"phrasings":[]}]},{"kind":"agent","name":"settings","emoji":"⚙️","description":"Agent to manipulate system settings","children":[{"kind":"action","name":"adjustMultiMonitorLayoutAction","agent":"settings","schema":"settings","enabled":true,"transient":false,"description":"An action to adjust multi-monitor layout","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"}],"phrasings":[]},{"kind":"action","name":"dimBrightNessAction","agent":"settings","schema":"settings","enabled":true,"transient":false,"description":"An action to dim or brighten the screen","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request of the user"}],"phrasings":[]}]},{"kind":"agent","name":"windowsClock","emoji":"⏰","description":"Windows Clock agent — set alarms, start timers, run the stopwatch, and add world clocks via the built-in Windows Alarms & Clock app.","children":[{"kind":"action","name":"addWorldClock","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Add a new world clock by searching for a city and selecting it from suggestions.","parameters":[{"name":"cityQuery","type":"string","optional":false,"description":"Text to search for a matching city in the Add Clock box."},{"name":"suggestionItem","type":"string","optional":false,"description":"The specific suggestion to select from the list (city, country)."}],"phrasings":[]},{"kind":"action","name":"createAlarm","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Create a new alarm with a specified name and time.","parameters":[{"name":"alarmName","type":"string","optional":false,"description":"Displayed name of the alarm."},{"name":"hour","type":"number","optional":false,"description":"Hour component of the alarm time."},{"name":"minute","type":"number","optional":false,"description":"Minute component of the alarm time."}],"phrasings":[]},{"kind":"action","name":"navigateToAlarmTab","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Switch to the Alarms tab in the app.","parameters":[],"phrasings":[]},{"kind":"action","name":"navigateToFocusTab","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Switch to the Focus tab from the app's navigation.","parameters":[],"phrasings":[]},{"kind":"action","name":"navigateToStopwatchTab","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Switch to the Stopwatch tab.","parameters":[],"phrasings":[]},{"kind":"action","name":"navigateToTimerTab","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Switch to the Timer tab from another section.","parameters":[],"phrasings":[]},{"kind":"action","name":"navigateToWorldClockTab","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Switch to the World Clock tab from another tab.","parameters":[],"phrasings":[]},{"kind":"action","name":"recordLap","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Record a lap while the stopwatch continues running.","parameters":[],"phrasings":[]},{"kind":"action","name":"renameTimer","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Rename an existing timer and save the changes.","parameters":[{"name":"name","type":"string","optional":false,"description":"The new name to assign to the timer."}],"phrasings":[]},{"kind":"action","name":"setAlarmEnabled","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Turn on an existing alarm.  [merged from: enableAlarm, disableAlarm]","parameters":[{"name":"enabled","type":"boolean","optional":false,"description":"Distinguishes enableAlarm / disableAlarm variants."}],"phrasings":[]},{"kind":"action","name":"setFocusSessionRunning","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Start the focus session when it is paused.  [merged from: startFocusSession, pauseFocusSession]","parameters":[{"name":"running","type":"boolean","optional":false,"description":"Distinguishes startFocusSession / pauseFocusSession variants."}],"phrasings":[]},{"kind":"action","name":"setStopwatchRunning","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Pause the running stopwatch.  [merged from: pauseStopwatch, resumeStopwatch]","parameters":[{"name":"running","type":"boolean","optional":false,"description":"Distinguishes pauseStopwatch / resumeStopwatch variants."}],"phrasings":[]},{"kind":"action","name":"setTimerViewMode","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Expand the timer into its alternate/compact view.  [merged from: expandTimerView, restoreTimerView]","parameters":[{"name":"mode","type":"\"compact\" | \"full\"","optional":false,"description":"Distinguishes expandTimerView / restoreTimerView variants."}],"phrasings":[]},{"kind":"action","name":"startTimer","agent":"windowsClock","schema":"windowsClock","enabled":true,"transient":false,"description":"Start or resume the timer from list or paused states.","parameters":[],"phrasings":[]}]}]},{"kind":"category","name":"Core","emoji":"🧠","children":[{"kind":"agent","name":"dispatcher","emoji":"🤖","description":"","children":[{"kind":"action","name":"clarifyMissingParameter","agent":"dispatcher","schema":"dispatcher.clarify","enabled":true,"transient":false,"description":"The user request is for a known action, but a required parameter is missing entirely: the user gave no value for it, and no pronoun, reference, or memory points at one. Ask the user to supply the missing parameter. Don't clarify \"unknown\" action. If the value IS referred to but can't be resolved (e.g. \"the one we talked about\", \"it\", \"that file\", \"the one from before\"), use ClarifyUnresolvedReference instead.","parameters":[{"name":"request","type":"string","optional":false,"description":"the current understood user request that needs to be clarified"},{"name":"actionName","type":"string","optional":false,"description":"A known actionName to be clarify.  Don't clarify \"unknown\" action."},{"name":"parameterName","type":"string","optional":false,"description":""},{"name":"clarifyingQuestion","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"clarifyMultipleAgentMatches","agent":"dispatcher","schema":"dispatcher.clarify","enabled":true,"transient":false,"description":"The user request was matched by more than one agent's schema/grammar simultaneously (a cross-agent action collision). List the candidate (schemaName, actionName) pairs so the user can disambiguate. This differs from ClarifyMultiplePossibleActionName, which only lists action names within a single schema.","parameters":[{"name":"request","type":"string","optional":false,"description":"the current understood user request that needs to be clarified"},{"name":"candidates","type":"{ … }[]","optional":false,"description":""},{"name":"clarifyingQuestion","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"clarifyMultiplePossibleActionName","agent":"dispatcher","schema":"dispatcher.clarify","enabled":true,"transient":false,"description":"Ask the user for clarification for ambiguous request that have multiple possible known action as interpretation. Don't clarify \"unknown\" action.","parameters":[{"name":"request","type":"string","optional":false,"description":"the current understood user request that needs to be clarified"},{"name":"possibleActionNames","type":"string[]","optional":false,"description":"Known actionNames to be clarify.  Don't clarify \"unknown\" action."},{"name":"clarifyingQuestion","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"clarifyUnresolvedReference","agent":"dispatcher","schema":"dispatcher.clarify","enabled":true,"transient":false,"description":"The user request is for a known action and does not refer to the parameter's value directly, but rather through a pronoun, reference, or memory that can't be resolved directly from the request or chat history (e.g. \"from the movie we talked about yesterday\", \"print that file\", \"it\"). Ask the user what the reference points to.","parameters":[{"name":"request","type":"string","optional":false,"description":"the current understood user request that needs to be clarified"},{"name":"actionName","type":"string","optional":false,"description":""},{"name":"parameterName","type":"string","optional":false,"description":""},{"name":"reference","type":"string","optional":false,"description":""},{"name":"clarifyingQuestion","type":"string","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"exitActivity","agent":"dispatcher","schema":"dispatcher.activity","enabled":true,"transient":true,"description":"Exit the current activity.","parameters":[],"phrasings":[]},{"kind":"action","name":"lookupAndAnswerConversation","agent":"dispatcher","schema":"dispatcher.lookup","enabled":true,"transient":false,"description":"The user request is a question about previous conversations. (e.g. \"what did we say about the project last week?\") The user expects only the answer, and not an action to be taken.","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"the original request from the user"},{"name":"question","type":"string","optional":false,"description":"The question to get answer for."},{"name":"conversationLookupFilters","type":"{ … }[]","optional":false,"description":"look up for private information from past conversations (i.e. chat history) including private events, plans, projects in progress, attachments, files, file names, and other items from discussions with team members or the assistant, use the conversation lookup filters"}],"phrasings":[]},{"kind":"action","name":"reasoningAction","agent":"dispatcher","schema":"dispatcher.reasoning","enabled":true,"transient":false,"description":"If the user requests requires multiple action or steps, use the reasoning action.","parameters":[{"name":"originalRequest","type":"string","optional":false,"description":"The original user request"},{"name":"reason","type":"string","optional":true,"description":"Why this request needs multi-step reasoning instead of a single known action. Name the action(s) or schema that came closest and say what made a direct translation insufficient. Be specific: this is used to find gaps in the action schemas."},{"name":"attemptedAction","type":"string","optional":true,"description":"JSON-serialized action object — agents populate this when redirecting a translated action so the reasoning loop knows what was intended."},{"name":"contextEntities","type":"string","optional":true,"description":"JSON-serialized entities on the stack at the time of redirect."}],"phrasings":[]},{"kind":"action","name":"startLookup","agent":"dispatcher","schema":"dispatcher.lookup","enabled":true,"transient":false,"description":"The user want to start looking information for a specific source without specifying what to look for. Don't use this action if the request includes what to look for.","parameters":[{"name":"lookup","type":"{ … }","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"unknown","agent":"dispatcher","schema":"dispatcher","enabled":true,"transient":false,"description":"Use UnknownAction when all the available actions in the schema is not relevant to the user request","parameters":[{"name":"request","type":"string","optional":false,"description":"user request that couldn't be matched to any action or schema group to look up from."},{"name":"reason","type":"string","optional":false,"description":"Why none of the available actions fit this request. Name the action(s) that came closest and say what was missing. Be specific: this is used to find gaps in the action schemas."}],"phrasings":[]}]},{"kind":"agent","name":"system","emoji":"🔧","description":"","children":[{"kind":"action","name":"clearHistory","agent":"system","schema":"system.history","enabled":true,"transient":false,"description":"Clears the chat history","parameters":[],"phrasings":[]},{"kind":"action","name":"clearNotifications","agent":"system","schema":"system.notify","enabled":true,"transient":false,"description":"Clears the notifications","parameters":[],"phrasings":[]},{"kind":"action","name":"clearRules","agent":"system","schema":"system.grammar","enabled":true,"transient":false,"description":"","parameters":[{"name":"agentName","type":"string","optional":true,"description":"Agent/schema name to clear rules for (e.g. \"player\", \"calendar\", \"email\"). Omit to clear ALL rules across all agents."}],"phrasings":[]},{"kind":"action","name":"deleteConversation","agent":"system","schema":"system.conversation","enabled":true,"transient":false,"description":"Delete a conversation by name. Use this when the user wants to remove, delete, or destroy a conversation. Examples: \"delete conversation test\", \"remove the work conversation\", \"delete test2\".","parameters":[{"name":"name","type":"string","optional":false,"description":"The name of the conversation to delete"}],"phrasings":["{polite} delete conversation {name}","{polite} delete {name} conversation"]},{"kind":"action","name":"deleteHistory","agent":"system","schema":"system.history","enabled":true,"transient":false,"description":"Deletes a specific message from the chat history","parameters":[{"name":"messageNumber","type":"number","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"deleteRule","agent":"system","schema":"system.grammar","enabled":true,"transient":false,"description":"","parameters":[{"name":"id","type":"number","optional":false,"description":"Numeric ID of the rule to delete, as shown in listRules output"}],"phrasings":[]},{"kind":"action","name":"describeAction","agent":"system","schema":"system.describe","enabled":true,"transient":false,"description":"Explain a single action in detail, beyond its one-line schema description. Examples: \"what does the play action do\", \"describe spotify's play action\", \"describe the play action from spotify\".","parameters":[{"name":"actionName","type":"string","optional":false,"description":"the action to describe"},{"name":"agentName","type":"string","optional":true,"description":"optional owning agent, when the user names one"}],"phrasings":[]},{"kind":"action","name":"describeAgent","agent":"system","schema":"system.describe","enabled":true,"transient":false,"description":"Describe what an agent can do: a natural-language summary plus its actions. Works for installed-but-disabled agents too — describing is informational and does not require the agent to be enabled. Examples: \"what can the spotify agent do\", \"describe spotify\", \"show me all of spotify's actions\", \"list everything calendar can do\".","parameters":[{"name":"agentName","type":"string","optional":false,"description":"the agent to describe"},{"name":"all","type":"boolean","optional":true,"description":"true when the user asks for ALL actions, not the default set"}],"phrasings":[]},{"kind":"action","name":"enterAgentPriorityMode","agent":"system","schema":"system.config","enabled":true,"transient":false,"description":"Puts a specific agent into priority mode","parameters":[{"name":"agentName","type":"string","optional":false,"description":"the agent name or wildcard match string (* to match all agents)"}],"phrasings":[]},{"kind":"action","name":"exitAgentPriorityMode","agent":"system","schema":"system.config","enabled":true,"transient":false,"description":"Leaves agent priority mode","parameters":[],"phrasings":[]},{"kind":"action","name":"listAgents","agent":"system","schema":"system.config","enabled":true,"transient":false,"description":"Shows the list of available agents","parameters":[],"phrasings":[]},{"kind":"action","name":"listConversation","agent":"system","schema":"system.conversation","enabled":true,"transient":false,"description":"List all conversations in this TypeAgent shell session. Use this when the user wants to see, show, or list their TypeAgent conversations (NOT files, songs, or any other kind of list). Examples: \"list our conversations\", \"list my conversations\", \"show all conversations\", \"what conversations do I have\", \"show me my conversations\", \"show conversation list\".","parameters":[],"phrasings":["{polite} list conversations","{polite} what conversations have"]},{"kind":"action","name":"listHistory","agent":"system","schema":"system.history","enabled":true,"transient":false,"description":"Shows the chat history","parameters":[],"phrasings":[]},{"kind":"action","name":"listRules","agent":"system","schema":"system.grammar","enabled":true,"transient":false,"description":"Lists the active grammar rules for the supplied agent.","parameters":[{"name":"agentName","type":"string","optional":true,"description":"Agent/schema name to filter by (e.g. \"player\", \"calendar\", \"email\", \"browser\"). Omit to list all rules across all agents. Use the short agent name, not the npm package name (e.g. \"player\" not \"music\")."}],"phrasings":[]},{"kind":"action","name":"newConversation","agent":"system","schema":"system.conversation","enabled":true,"transient":false,"description":"Create a new conversation and optionally give it a name. Use this when the user wants to create, start, make, or open a brand-new conversation. Examples: \"create a new conversation\", \"start a new conversation called test\", \"make a new conversation\", \"new conversation named work\", \"open a new conversation test\". IMPORTANT: use this only when the user is creating something new, not switching to an existing one.","parameters":[{"name":"name","type":"string","optional":true,"description":"Optional name for the new conversation"}],"phrasings":["{polite} create new conversation called {name}","{polite} create new conversation","{polite} new conversation"]},{"kind":"action","name":"nextConversation","agent":"system","schema":"system.conversation","enabled":true,"transient":false,"description":"Switch to the NEXT TypeAgent conversation in the list (cycles around). Use this when the user wants to advance to the next TypeAgent shell conversation (NOT the next song, next track, next page, or any other kind of \"next\"). Examples: \"switch to next conversation\", \"next conversation\", \"go to the next conversation\", \"cycle to the next conversation\".","parameters":[],"phrasings":["{polite} next conversation","{polite} advance to next conversation"]},{"kind":"action","name":"prevConversation","agent":"system","schema":"system.conversation","enabled":true,"transient":false,"description":"Switch to the PREVIOUS TypeAgent conversation in the list (cycles around). Use this when the user wants to go to the previous TypeAgent shell conversation (NOT the previous song, previous track, or any other kind of \"previous\"). Examples: \"switch to previous conversation\", \"previous conversation\", \"go to the previous conversation\", \"cycle to the previous conversation\".","parameters":[],"phrasings":["{polite} previous conversation","{polite} back to previous conversation"]},{"kind":"action","name":"renameConversation","agent":"system","schema":"system.conversation","enabled":true,"transient":false,"description":"Rename a conversation. Use this when the user wants to rename, relabel, or give a new name to a conversation. If the user specifies which conversation to rename, capture it as 'name'. If the user only says \"rename this conversation\" or \"rename current conversation\", omit 'name'. Examples: \"rename this conversation to work\", \"rename test7 to test5\", \"call this conversation research\", \"rename current conversation to my project\".","parameters":[{"name":"name","type":"string","optional":true,"description":"Optional: the current name of the conversation to rename. Omit to rename the active conversation."},{"name":"newName","type":"string","optional":false,"description":"The new name for the conversation"}],"phrasings":["{polite} rename this conversation to {newName}","{polite} call this conversation {newName}","{polite} rename conversation {name} to {newName}"]},{"kind":"action","name":"setAutoComplete","agent":"system","schema":"system.settings","enabled":true,"transient":false,"description":"Enable or disable inline autocomplete suggestions in the CLI input. Use when the user says things like \"turn off autocomplete\", \"disable tab completion\", \"stop showing completions\", \"enable autocomplete\", \"turn on inline suggestions\".","parameters":[{"name":"enable","type":"boolean","optional":false,"description":"true = show inline completions as the user types; false = disable autocomplete"}],"phrasings":[]},{"kind":"action","name":"setConversationResume","agent":"system","schema":"system.settings","enabled":true,"transient":false,"description":"Set whether to resume the last conversation on startup. Use when the user says things like \"always resume my last conversation\", \"pick up where I left off\", \"don't resume my last conversation\", \"start fresh each time\".","parameters":[{"name":"enable","type":"boolean","optional":false,"description":"true = resume the last conversation on startup; false = always start with the default conversation"}],"phrasings":[]},{"kind":"action","name":"setIdleTimeout","agent":"system","schema":"system.settings","enabled":true,"transient":false,"description":"Set the idle timeout for the agent server in seconds (0 = disabled). Use when the user says things like \"shut down the server after 5 minutes of inactivity\", \"set idle timeout to 300 seconds\", \"disable idle timeout\", \"never shut down automatically\".","parameters":[{"name":"seconds","type":"number","optional":false,"description":"Timeout in seconds. 0 means the server never shuts down automatically due to inactivity."}],"phrasings":[]},{"kind":"action","name":"setServerHidden","agent":"system","schema":"system.settings","enabled":true,"transient":false,"description":"Set whether the agent server starts as a hidden background process. Use when the user says things like \"start the server hidden\", \"run the server in the background\", \"don't show a server window\", \"show the server window on startup\".","parameters":[{"name":"enable","type":"boolean","optional":false,"description":"true = server starts as hidden background process; false = server starts with a visible window"}],"phrasings":[]},{"kind":"action","name":"showConversationInfo","agent":"system","schema":"system.conversation","enabled":true,"transient":false,"description":"Show information about the current conversation. Use this when the user asks about the current conversation info. Examples: \"show conversation info\", \"what conversation am I in\", \"current conversation info\".","parameters":[],"phrasings":["{polite} show conversation info","{polite} what conversation am i in","{polite} current conversation info"]},{"kind":"action","name":"showNotifications","agent":"system","schema":"system.notify","enabled":true,"transient":false,"description":"Shows notifications based on the supplied filter","parameters":[{"name":"filter","type":"\"all\" | \"unread\"","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"showNotificationSummary","agent":"system","schema":"system.notify","enabled":true,"transient":false,"description":"Shows notification summary","parameters":[],"phrasings":[]},{"kind":"action","name":"showRule","agent":"system","schema":"system.grammar","enabled":true,"transient":false,"description":"","parameters":[{"name":"id","type":"number","optional":false,"description":"Numeric ID of the rule to inspect, as shown in listRules output"}],"phrasings":[]},{"kind":"action","name":"switchConversation","agent":"system","schema":"system.conversation","enabled":true,"transient":false,"description":"Switch to an existing conversation by name. Use this when the user wants to switch to, go to, open, or change to an EXISTING conversation identified by name.  For \"next\"/\"previous\" without a specific name, use NextConversationAction or PrevConversationAction instead. Examples: \"switch to conversation test\", \"go to my work conversation\", \"switch to test\", \"open conversation named work\", \"change to the test conversation\". IMPORTANT: use this only when switching to an already-existing conversation, not creating a new one.","parameters":[{"name":"name","type":"string","optional":false,"description":"The name of the conversation to switch to"}],"phrasings":["{polite} switch to conversation {name}","{polite} switch conversation to {name}","{polite} switch to {name} conversation","{polite} open conversation {name}"]},{"kind":"action","name":"toggleAgent","agent":"system","schema":"system.config","enabled":true,"transient":false,"description":"Toggle use of LLM, agent or AI.","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""},{"name":"agentNames","type":"string[]","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"toggleDeveloperMode","agent":"system","schema":"system.config","enabled":true,"transient":false,"description":"Toggle developer mode.","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":[]},{"kind":"action","name":"toggleExplanation","agent":"system","schema":"system.config","enabled":true,"transient":false,"description":"Toggle explanation.","parameters":[{"name":"enable","type":"boolean","optional":false,"description":""}],"phrasings":[]}]}]},{"kind":"category","name":"Other","emoji":"📦","children":[{"kind":"agent","name":"selfhelp","emoji":"💡","description":"Help agent that answers questions about TypeAgent itself: what it is, how it works, how to set up and use its agents, commands, and features.","children":[{"kind":"action","name":"answerTypeAgentQuestion","agent":"selfhelp","schema":"selfhelp","enabled":true,"transient":false,"description":"Answer a question the user is asking about TypeAgent itself - what it is, how it works, how to set up or use one of its agents/commands/features, or why a TypeAgent feature is behaving a certain way. Only use this for questions about the TypeAgent product; not for general knowledge or for performing a task in another domain.","parameters":[{"name":"question","type":"string","optional":false,"description":"The user's original question about TypeAgent, verbatim."}],"phrasings":[]}]}]}]},"commands":{"kind":"root","name":"Commands","children":[{"kind":"host","name":"system","children":[{"kind":"command","name":"action","host":"system","full":"action","description":"Execute an action","args":[{"name":"schemaName","optional":false,"description":"Action schema name"},{"name":"actionName","optional":false,"description":"Action name"}],"flags":[{"name":"parameters","char":"","default":"","description":"Action parameter"},{"name":"naturalLanguage","char":"","default":"","description":"Natural language phrase to associate with this action for cache population"}]},{"kind":"group","name":"clear","host":"system","full":"clear","children":[{"kind":"command","name":"deep","host":"system","full":"clear deep","description":"Clear the console and wipe chat history, reasoning, activity, and persistent display log so nothing replays on rejoin","args":[],"flags":[]}],"description":"Clear the console","args":[],"flags":[]},{"kind":"group","name":"collision","host":"system","full":"collision","children":[{"kind":"group","name":"corpus","host":"system","full":"collision corpus","children":[{"kind":"command","name":"generate","host":"system","full":"collision corpus generate","description":"Generate an LLM-authored phrase corpus for every action in this dispatcher's loaded schemas (slow: ~12 min for the full set)","args":[],"flags":[{"name":"schemas","char":"","default":"","description":"Comma-separated schemas to scan. Empty = all loaded schemas."},{"name":"models","char":"","default":"","description":"Comma-separated chat-model names from ts/.env. Default: GPT_4_1,GPT_5,GPT_5_NANO"},{"name":"styles","char":"","default":"","description":"Comma-separated phrase styles to generate. Available: imperative,conversational,casual,polite,curt,slang,typos. Default: imperative,conversational,casual."},{"name":"concurrency","char":"","default":"8","description":"Concurrent LLM calls (default 8)"},{"name":"out","char":"","default":"","description":"Output corpus JSON file path (file name, not directory — use --workdir to choose the directory). Default: \u003cinstanceDir>/collisions/corpus.json"},{"name":"workdir","char":"","default":"","description":"Directory for default-named output files. Default: \u003cinstanceDir>/collisions"}]},{"kind":"command","name":"probe","host":"system","full":"collision corpus probe","description":"Replay a phrase corpus through the embedding ranker and classify each phrase as CLEAN / TIGHT / MISROUTE","args":[],"flags":[{"name":"in","char":"","default":"","description":"Input corpus JSON path. Default: \u003cworkdir>/corpus.json"},{"name":"out","char":"","default":"","description":"Output probe-results JSON path. Default: \u003cworkdir>/probe-results.json"},{"name":"top","char":"","default":"5","description":"Candidate rows kept per probe (default 5)"},{"name":"delta","char":"","default":"0.05","description":"Tight-vs-clean threshold (default 0.05)"},{"name":"concurrency","char":"","default":"8","description":"Concurrent probes (default 8)"},{"name":"workdir","char":"","default":"","description":"Directory for default-named files. Default: \u003cinstanceDir>/collisions"}]},{"kind":"command","name":"reanalyze","host":"system","full":"collision corpus reanalyze","description":"Re-classify saved probe results with prefix-aware action matching (recovers misroutes that were just naming differences)","args":[],"flags":[{"name":"in","char":"","default":"","description":"Input probe-results JSON. Default: \u003cworkdir>/probe-results.json"},{"name":"out","char":"","default":"","description":"Output reclassified JSON. Default: \u003cworkdir>/probe-results-reclassified.json"},{"name":"delta","char":"","default":"0.05","description":"Tight-vs-clean threshold (default 0.05)"},{"name":"workdir","char":"","default":"","description":"Directory for default-named files. Default: \u003cinstanceDir>/collisions"}]},{"kind":"command","name":"recovery","host":"system","full":"collision corpus recovery","description":"Decompose MISROUTE results by where the correct target ranks among the top-K candidates (which fix lever applies?)","args":[],"flags":[{"name":"in","char":"","default":"","description":"Input reclassified probe-results JSON. Default: \u003cworkdir>/probe-results-reclassified.json"},{"name":"workdir","char":"","default":"","description":"Directory for default-named files. Default: \u003cinstanceDir>/collisions"},{"name":"delta","char":"","default":"0.05","description":"llmSelect threshold for the rank-2 tight/wide split (default 0.05)"}]},{"kind":"command","name":"run","host":"system","full":"collision corpus run","description":"Run the full corpus pipeline (generate → probe → reanalyze → visualize) with consistent file naming","args":[],"flags":[{"name":"from","char":"","default":"generate","description":"Resume from a step: generate | probe | reanalyze | visualize (default generate)"},{"name":"workdir","char":"","default":"","description":"Directory for intermediate files. Default: \u003cinstanceDir>/collisions"},{"name":"schemas","char":"","default":"","description":"Comma-separated schemas (corpus only)"},{"name":"models","char":"","default":"","description":"Comma-separated model names (corpus only)"},{"name":"styles","char":"","default":"","description":"Comma-separated phrase styles (corpus only). Available: imperative,conversational,casual,polite,curt,slang,typos. Default: imperative,conversational,casual."},{"name":"concurrency","char":"","default":"8","description":"LLM concurrency (corpus only, default 8)"},{"name":"delta","char":"","default":"0.05","description":"Tight-vs-clean threshold (probe + reanalyze, default 0.05)"},{"name":"top","char":"","default":"5","description":"Probe candidate rows (default 5)"},{"name":"sankey-top","char":"","default":"60","description":"Sankey edge count (default 60)"}]},{"kind":"command","name":"translate","host":"system","full":"collision corpus translate","description":"Replay a phrase corpus through the LLM translator (cache/grammar/exec/fuzzy off) and classify each phrase as CLEAN / MISROUTE / CLARIFY / INVALID / ERROR. Distinct from 'corpus probe' — that one runs the embedding ranker; this runs the actual translator.","args":[],"flags":[{"name":"in","char":"","default":"","description":"Input corpus JSON path. Default: \u003cworkdir>/corpus.json"},{"name":"out","char":"","default":"","description":"Output translation-results JSON file path (file name, not directory — use --workdir to choose the directory). Default: \u003cworkdir>/translation-results.json (or translation-results-\u003csuffix>.json when --output-suffix is set)."},{"name":"concurrency","char":"","default":"4","description":"Concurrent translator calls (default 4 — chat completions are expensive)"},{"name":"strategy","char":"","default":"first-match","description":"llmSelect strategy to force during the run. Default 'first-match' (suppresses user-clarify short-circuit). Reserved: future runs will sweep multiple strategies in one go."},{"name":"max-phrases","char":"","default":"","description":"Cap the run to N phrases (deterministic prefix). Useful for smoke tests."},{"name":"model-label","char":"","default":"","description":"Label recorded in each row's `model` field. Reserved for future multi-model sweeps; defaults to 'default'."},{"name":"user-context-mode","char":"","default":"none","description":"How userContext is attached per phrase: 'none' (baseline, no injection), 'expected-schema' (derive from each phrase's expected schema via manifest), 'fixed' (use --user-context-json for every phrase)."},{"name":"user-context-json","char":"","default":"","description":"JSON object parsed as UserContext when --user-context-mode=fixed. E.g. '{\"activeApp\":\"spotify\",\"activeAppDescription\":\"Spotify music agent\"}'."},{"name":"output-suffix","char":"","default":"","description":"When set and --out is not given, write to \u003cworkdir>/translation-results-\u003csuffix>.json so baseline and context runs coexist in one workdir."},{"name":"workdir","char":"","default":"","description":"Directory for default-named files. Default: \u003cinstanceDir>/collisions"}]},{"kind":"command","name":"visualize","host":"system","full":"collision corpus visualize","description":"Build an interactive HTML visualization of misroute hotspots from reclassified probe results, overlaid with a cross-schema similarity scan","args":[],"flags":[{"name":"in","char":"","default":"","description":"Input reclassified probe-results JSON. Default: \u003cworkdir>/probe-results-reclassified.json"},{"name":"out","char":"","default":"","description":"Output HTML path. Default: \u003cworkdir>/collisions-viz.html"},{"name":"top","char":"","default":"60","description":"Sankey edge count (default 60)"},{"name":"similarity-strategy","char":"","default":"","description":"Similarity strategy for the overlay (default balanced)"},{"name":"similarity-threshold","char":"","default":"","description":"Similarity threshold for the overlay, decimal in [0,1] (default 0.85)"},{"name":"no-similarity","char":"","default":"false","description":"Skip the similarity overlay; produce a corpus-only viz"},{"name":"translator","char":"","default":"","description":"Translator-probe results JSON to overlay (enables the 'translator-confirmed' source filter). Default: \u003cworkdir>/translation-results.json when present. Use --no-translator to skip."},{"name":"no-translator","char":"","default":"false","description":"Skip the translator overlay even if translation-results.json is present"},{"name":"workdir","char":"","default":"","description":"Directory for default-named files. Default: \u003cinstanceDir>/collisions"}]},{"kind":"command","name":"visualize-recovery","host":"system","full":"collision corpus visualize-recovery","description":"Build an interactive HTML visualization of recovery-rank analysis (which fix lever applies, per action and per agent)","args":[],"flags":[{"name":"in","char":"","default":"","description":"Input reclassified probe-results JSON. Default: \u003cworkdir>/probe-results-reclassified.json"},{"name":"out","char":"","default":"","description":"Output HTML path. Default: \u003cworkdir>/recovery-viz.html"},{"name":"delta","char":"","default":"0.05","description":"llmSelect threshold for the rank-2 tight/wide split (default 0.05)"},{"name":"workdir","char":"","default":"","description":"Directory for default-named files. Default: \u003cinstanceDir>/collisions"}]}],"description":"Generate phrase corpora, probe through the embedding ranker, and build the collision-hotspot visualizations","args":[],"flags":[]},{"kind":"command","name":"events","host":"system","full":"collision events","description":"Show recent collision events captured in the current session's ring buffer","args":[],"flags":[{"name":"limit","char":"n","default":"10","description":"Maximum number of events to show (default 10)"},{"name":"kind","char":"k","default":"","description":"Filter by detection point (one of: static, grammarMatch, llmSelect, fuzzy)"}]},{"kind":"group","name":"keywords","host":"system","full":"collision keywords","children":[{"kind":"command","name":"backfill","host":"system","full":"collision keywords backfill","description":"Backfill/refresh committed keyword files for agent actions. Lexical by default; --llm uses the preferred LLM distillation pass.","args":[{"name":"schemas","optional":true,"description":"Schema names to backfill; omit to backfill every loaded schema."}],"flags":[{"name":"llm","char":"","default":"false","description":"Use LLM distillation (the preferred producer) instead of the deterministic lexical floor."},{"name":"force","char":"","default":"false","description":"Overwrite an existing LLM-distilled file with a lexical one (a lexical backfill preserves llm files by default)."}]}],"description":"Inspect/tune contextSelector keyword vectors, or backfill the committed keyword files.","args":[{"name":"tokens","optional":true,"description":"e.g. \"list.addItems\", \"list.addItems add grocery shopping\", or omit to list all overrides."}],"flags":[]},{"kind":"command","name":"list-strategies","host":"system","full":"collision list-strategies","description":"List the named strategies available for `@collision similar -s \u003cname>`","args":[],"flags":[]},{"kind":"command","name":"neighborhoods","host":"system","full":"collision neighborhoods","description":"Build neighborhoods directly from translator misroute edges and write a persisted JSON index plus an HTML viz.","args":[],"flags":[{"name":"corpus","char":"","default":"","description":"Translator probe results JSON (default \u003cworkdir>/translation-results.json)"},{"name":"min-misroute","char":"","default":"2","description":"Drop edges below this count (default 2)"},{"name":"include-same-schema","char":"","default":"true","description":"Include same-schema misroute edges (e.g. email.send + email.reply). Default: true"},{"name":"samples-per-category","char":"","default":"5","description":"Per-category cap on edge sample phrases (default 5)."},{"name":"out","char":"","default":"","description":"Output JSON path (default \u003cworkdir>/neighborhoods.json)"},{"name":"out-html","char":"","default":"","description":"Output HTML path (default \u003cworkdir>/neighborhoods.html)"},{"name":"workdir","char":"","default":"","description":"Directory for default-named files. Default: \u003cinstanceDir>/collisions"}]},{"kind":"group","name":"optimize","host":"system","full":"collision optimize","children":[{"kind":"command","name":"browse","host":"system","full":"collision optimize browse","description":"Generate browse.html for one or more optimization-run-* directories. Walks the run, writes a sortable case index plus a self-contained case.html per case showing every attempt with before/after diffs.","args":[],"flags":[{"name":"run","char":"","default":"","description":"Run timestamp suffix (the \u003cts> in optimization-run-\u003cts>/). Default: latest run under \u003cworkdir>."},{"name":"all","char":"","default":"false","description":"Generate browse.html for ALL optimization-run-* directories under \u003cworkdir>. Overrides --run."},{"name":"workdir","char":"","default":"","description":"Directory containing optimization-run-* subdirectories. Default: \u003cinstanceDir>/collisions."}]},{"kind":"command","name":"distill","host":"system","full":"collision optimize distill","description":"Distill winning attempts in patterns.jsonl into candidate schemaGuidelines additions. Groups winners by (mechanism, guidelineHook), calls the LLM with the current schemaGuidelines as context, writes schemaGuidelines.candidates.md for operator review.","args":[],"flags":[{"name":"min-attempts","char":"","default":"10","description":"Minimum winners in patterns.jsonl before distill runs (default 10)."},{"name":"workdir","char":"","default":"","description":"Workdir containing patterns.jsonl."}]},{"kind":"command","name":"explore","host":"system","full":"collision optimize explore","description":"Run the optimize loop on the top-N collision neighborhoods. Writes an attempts archive under \u003cworkdir>/optimization-run-\u003cts>/.","args":[],"flags":[{"name":"corpus","char":"","default":"","description":"Path to neighborhoods.json (default \u003cworkdir>/neighborhoods.json)"},{"name":"baseline","char":"","default":"","description":"Path to translation-results.json (default \u003cworkdir>/translation-results.json)"},{"name":"top","char":"","default":"5","description":"Top-N cases by gravity to run (default 5)"},{"name":"hypotheses-per-lever","char":"","default":"3","description":"K hypotheses per lever per case (default 3). Reserved — levers pick K from this flag in a future revision."},{"name":"depth","char":"","default":"2","description":"Recursion depth budget (default 2). When all hypotheses at depth N regress, the case loop re-prompts the LLM with the failed mechanisms and asks for a different approach."},{"name":"lever","char":"","default":"","description":"Comma-separated lever names. Default: all registered levers."},{"name":"severity","char":"","default":"blocker,leaky","description":"Comma-separated severity tiers to include (default blocker,leaky). Allowed: blocker, leaky, minor."},{"name":"workdir","char":"","default":"","description":"Directory for default-named files. Default: \u003cinstanceDir>/collisions"},{"name":"dry-run","char":"","default":"false","description":"Write attempt scaffolding only — no LLM calls, no apply, no probe."},{"name":"concurrency","char":"","default":"8","description":"Reserved for future per-case parallelism."}]},{"kind":"command","name":"list-levers","host":"system","full":"collision optimize list-levers","description":"List all registered optimization levers with their description, consumes, and probeType.","args":[],"flags":[]},{"kind":"command","name":"patterns","host":"system","full":"collision optimize patterns","description":"Mine patterns.jsonl across all accumulated optimize runs. Emits patterns.{json,html} with three groupings (mechanism × pattern, per-lever, lever-effectiveness) plus classifier agreement.","args":[],"flags":[{"name":"patterns-file","char":"","default":"","description":"Path to patterns.jsonl. Default: \u003cworkdir>/patterns.jsonl"},{"name":"min-attempts","char":"","default":"5","description":"Cells with fewer attempts than this render as '—' (default 5)."},{"name":"surface-disagreement","char":"","default":"0.5","description":"Highlight classifier-disagreement cells above this rate (0-1, default 0.5)."},{"name":"out","char":"","default":"","description":"Output JSON path (default \u003cworkdir>/patterns.json)."},{"name":"out-html","char":"","default":"","description":"Output HTML path (default \u003cworkdir>/patterns.html)."},{"name":"workdir","char":"","default":"","description":"Directory containing patterns.jsonl. Default: \u003cinstanceDir>/collisions."}]},{"kind":"command","name":"run","host":"system","full":"collision optimize run","description":"Run the full optimize pipeline (neighborhoods → explore → validate → patterns → distill) with --from gating. Each step's predecessor must exist before it runs.","args":[],"flags":[{"name":"from","char":"","default":"neighborhoods","description":"Resume from a step: neighborhoods | explore | validate | patterns | distill (default neighborhoods)"},{"name":"top","char":"","default":"5","description":"Top-N cases (forwarded to explore, default 5)"},{"name":"depth","char":"","default":"2","description":"Recursion depth (forwarded to explore, default 2)."},{"name":"lever","char":"","default":"","description":"Lever filter (forwarded to explore)"},{"name":"severity","char":"","default":"blocker,leaky","description":"Severity tiers (forwarded to explore, default blocker,leaky)"},{"name":"dry-run","char":"","default":"false","description":"Dry-run mode (forwarded to explore)."},{"name":"skip-distill","char":"","default":"false","description":"Skip the distill step regardless of attempt count."},{"name":"distill-min-attempts","char":"","default":"10","description":"Minimum winners in patterns.jsonl before distill runs (default 10)."},{"name":"workdir","char":"","default":"","description":"Directory for pipeline intermediates. Default: \u003cinstanceDir>/collisions."}]},{"kind":"command","name":"validate","host":"system","full":"collision optimize validate","description":"Stack all winners from an optimization run and re-probe the full baseline corpus. Emits optimization-impact.{json,html} with cross-neighborhood regression flags.","args":[],"flags":[{"name":"run","char":"","default":"","description":"Run timestamp (the \u003cts> in optimization-run-\u003cts>/). Default: latest under \u003cworkdir>."},{"name":"phrases","char":"","default":"","description":"Restrict re-probing to phrases for a single neighborhood id. Faster for targeted iteration."},{"name":"baseline","char":"","default":"","description":"Override the baseline path recorded in optimization-run.json (useful when the original baseline moved)."},{"name":"workdir","char":"","default":"","description":"Directory containing optimization-run-* subdirectories. Default: \u003cinstanceDir>/collisions."},{"name":"winners","char":"","default":"","description":"Comma-separated attemptIds to include. Stacks ONLY these winners. Mutually exclusive with --leave-one-out."},{"name":"leave-one-out","char":"","default":"","description":"Comma-separated attemptIds to EXCLUDE. Stacks every winner except these. Useful for ablation — drop a suspected harmful winner and see whether the global numbers improve."}]}],"description":"Optimize translator-collision neighborhoods: propose verified schema/manifest fixes, accumulate cross-run evidence about which lever and mechanism work for which collision class.","args":[],"flags":[]},{"kind":"group","name":"preferences","host":"system","full":"collision preferences","children":[{"kind":"command","name":"clear","host":"system","full":"collision preferences clear","description":"Remove every stored collision preference","args":[],"flags":[]},{"kind":"command","name":"list","host":"system","full":"collision preferences list","description":"List stored collision preferences (Tier-1)","args":[],"flags":[]},{"kind":"command","name":"remove","host":"system","full":"collision preferences remove","description":"Remove a stored collision preference by key (see `@collision preferences list`)","args":[{"name":"key","optional":false,"description":"The preference key to remove."}],"flags":[]},{"kind":"command","name":"set","host":"system","full":"collision preferences set","description":"Set an explicit collision preference: among a candidate set, always pick the chosen option","args":[{"name":"candidates","optional":false,"description":"Comma-separated competing options as schema.action, e.g. \"player.play,list.play\"."},{"name":"chosen","optional":false,"description":"The option to always pick, as schema.action. Must be one of the candidates."}],"flags":[]}],"description":"Inspect and edit Tier-1 collision preferences (used by the preference-clarify strategy)","args":[],"flags":[]},{"kind":"command","name":"probe","host":"system","full":"collision probe","description":"Probe what action(s) a hand-crafted utterance would route to via the embedding ranker (top-K with cosine deltas)","args":[{"name":"phrase","optional":false,"description":"The utterance to probe, e.g. \"turn on wifi\""}],"flags":[{"name":"top","char":"n","default":"5","description":"Top-K candidates to render (default 5)"},{"name":"expected","char":"e","default":"","description":"Expected target as \"schema.actionName\" — flagged in the output if the top-1 candidate matches"},{"name":"delta","char":"","default":"0.05","description":"Score delta below which the top two are flagged ambiguous (default 0.05, matches llmSelect.scoreDeltaThreshold)"},{"name":"include-inactive","char":"","default":"false","description":"Include schemas that aren't currently active in this session"}]},{"kind":"command","name":"similar","host":"system","full":"collision similar","description":"Find semantically similar actions across agents (multi-vector embedding similarity, clusters by default)","args":[],"flags":[{"name":"threshold","char":"t","default":"0.85","description":"Per-strategy score threshold (default 0.85; raw cosine scale)"},{"name":"strategy","char":"s","default":"balanced","description":"Named scoring strategy (use `@collision similar list-strategies` to see all). Default: balanced"},{"name":"all-strategies","char":"","default":"false","description":"Run every strategy and render a comparison view"},{"name":"pairs","char":"","default":"false","description":"Render pairwise (legacy view) instead of clusters"},{"name":"top","char":"n","default":"50","description":"Maximum clusters / pairs to render (default 50)"},{"name":"json","char":"","default":"","description":"Write the structured scan result + applied-strategy data to this path as JSON"},{"name":"no-cache","char":"","default":"false","description":"Skip the on-disk embedding cache (forces re-embed)"}]}],"description":"Inspect collision detection telemetry and run static collision analyses","args":[],"flags":[]},{"kind":"group","name":"config","host":"system","full":"config","children":[{"kind":"command","name":"action","host":"system","full":"config action","description":"Toggle agent actions","args":[{"name":"agentNames","optional":true,"description":"enable pattern"}],"flags":[{"name":"reset","char":"r","default":"false","description":"reset to default"},{"name":"off","char":"x","default":"","description":"disable pattern"},{"name":"priority","char":"f","default":"","description":"priority pattern"}]},{"kind":"group","name":"agent","host":"system","full":"config agent","children":[{"kind":"command","name":"refresh","host":"system","full":"config agent refresh","description":"Re-check an agent's readiness state (or all agents)","args":[{"name":"agentName","optional":true,"description":"agent to refresh (omit for all enabled agents)"}],"flags":[]},{"kind":"command","name":"setup","host":"system","full":"config agent setup","description":"Run setup for an agent that needs configuration before use","args":[{"name":"agentName","optional":true,"description":"agent to set up (omit to list agents that need setup)"}],"flags":[]}],"description":"Manage agents (enable/disable, setup, refresh)","args":[{"name":"agentNames","optional":true,"description":"enable pattern"}],"flags":[{"name":"reset","char":"r","default":"false","description":"reset to default"},{"name":"off","char":"x","default":"","description":"disable pattern"},{"name":"priority","char":"f","default":"","description":"priority pattern"}]},{"kind":"group","name":"cache","host":"system","full":"config cache","children":[{"kind":"command","name":"grammarSystem","host":"system","full":"config cache grammarSystem","description":"Set grammar system (completionBased or nfa)","args":[{"name":"system","optional":false,"description":"Grammar system to use"}],"flags":[]},{"kind":"command","name":"useDFA","host":"system","full":"config cache useDFA","description":"Enable or disable DFA matching within the NFA grammar system (faster; requires grammarSystem=nfa)","args":[{"name":"enabled","optional":false,"description":"true or false"}],"flags":[]}],"description":"Configure cache behavior","args":[],"flags":[]},{"kind":"group","name":"collision","host":"system","full":"config collision","children":[{"kind":"group","name":"contextSelector","host":"system","full":"config collision contextSelector","children":[{"kind":"command","name":"decay","host":"system","full":"config collision contextSelector decay","description":"Get/set contextSelector decay (per-turn recency decay lambda (0 \u003c lambda \u003c= 1))","args":[{"name":"value","optional":true,"description":"New value; omit to show the current value."}],"flags":[]},{"kind":"group","name":"detect","host":"system","full":"config collision contextSelector detect","children":[{"kind":"command","name":"off","host":"system","full":"config collision contextSelector detect off","description":"Turn off context-weighted resolution (contextSelector)","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config collision contextSelector detect on","description":"Turn on context-weighted resolution (contextSelector)","args":[],"flags":[]}],"description":"Toggle context-weighted resolution (contextSelector)","args":[],"flags":[]},{"kind":"command","name":"margin","host":"system","full":"config collision contextSelector margin","description":"Get/set contextSelector margin (clear-winner margin the winner must beat the runner-up by)","args":[{"name":"value","optional":true,"description":"New value; omit to show the current value."}],"flags":[]},{"kind":"command","name":"minMass","host":"system","full":"config collision contextSelector minMass","description":"Get/set contextSelector minMass (evidence gate: min winner matched mass)","args":[{"name":"value","optional":true,"description":"New value; omit to show the current value."}],"flags":[]},{"kind":"command","name":"minUniqueTokens","host":"system","full":"config collision contextSelector minUniqueTokens","description":"Get/set contextSelector minUniqueTokens (evidence gate: min distinct distinguishing tokens the winner must match)","args":[{"name":"value","optional":true,"description":"New value; omit to show the current value."}],"flags":[]},{"kind":"command","name":"windowTurns","host":"system","full":"config collision contextSelector windowTurns","description":"Get/set contextSelector windowTurns (ring-buffer look-back N over recent user turns)","args":[{"name":"value","optional":true,"description":"New value; omit to show the current value."}],"flags":[]}],"description":"Configure the context-weighted resolution tier (deterministic topical tiebreaker on the grammar path)","args":[],"flags":[]},{"kind":"group","name":"fuzzy","host":"system","full":"config collision fuzzy","children":[{"kind":"group","name":"detect","host":"system","full":"config collision fuzzy detect","children":[{"kind":"command","name":"off","host":"system","full":"config collision fuzzy detect off","description":"Turn off fuzzy collision detection","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config collision fuzzy detect on","description":"Turn on fuzzy collision detection","args":[],"flags":[]}],"description":"Toggle fuzzy collision detection","args":[],"flags":[]},{"kind":"command","name":"strategy","host":"system","full":"config collision fuzzy strategy","description":"Set fuzzy resolution strategy (one of: first-match, score-rank, priority, user-clarify, preference-clarify)","args":[{"name":"strategy","optional":false,"description":"strategy name"}],"flags":[]}],"description":"Configure fuzzy collision detection","args":[],"flags":[]},{"kind":"group","name":"grammarMatch","host":"system","full":"config collision grammarMatch","children":[{"kind":"group","name":"detect","host":"system","full":"config collision grammarMatch detect","children":[{"kind":"command","name":"off","host":"system","full":"config collision grammarMatch detect off","description":"Turn off grammarMatch collision detection","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config collision grammarMatch detect on","description":"Turn on grammarMatch collision detection","args":[],"flags":[]}],"description":"Toggle grammarMatch collision detection","args":[],"flags":[]},{"kind":"command","name":"strategy","host":"system","full":"config collision grammarMatch strategy","description":"Set grammarMatch resolution strategy (one of: first-match, score-rank, priority, user-clarify, preference-clarify)","args":[{"name":"strategy","optional":false,"description":"strategy name"}],"flags":[]}],"description":"Configure grammarMatch collision detection","args":[],"flags":[]},{"kind":"group","name":"llmSelect","host":"system","full":"config collision llmSelect","children":[{"kind":"group","name":"detect","host":"system","full":"config collision llmSelect detect","children":[{"kind":"command","name":"off","host":"system","full":"config collision llmSelect detect off","description":"Turn off llmSelect collision detection","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config collision llmSelect detect on","description":"Turn on llmSelect collision detection","args":[],"flags":[]}],"description":"Toggle llmSelect collision detection","args":[],"flags":[]},{"kind":"command","name":"strategy","host":"system","full":"config collision llmSelect strategy","description":"Set llmSelect resolution strategy (one of: first-match, score-rank, priority, user-clarify, preference-clarify)","args":[{"name":"strategy","optional":false,"description":"strategy name"}],"flags":[]}],"description":"Configure llmSelect collision detection","args":[],"flags":[]},{"kind":"group","name":"preference","host":"system","full":"config collision preference","children":[{"kind":"group","name":"enabled","host":"system","full":"config collision preference enabled","children":[{"kind":"command","name":"off","host":"system","full":"config collision preference enabled off","description":"Turn off preference-clarify resolution","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config collision preference enabled on","description":"Turn on preference-clarify resolution","args":[],"flags":[]}],"description":"Toggle preference-clarify resolution","args":[],"flags":[]},{"kind":"command","name":"registry","host":"system","full":"config collision preference registry","description":"Set the filesystem path to the known-ambiguous neighborhoods registry (neighborhoods.json). Empty string clears it.","args":[{"name":"path","optional":true,"description":"Absolute path to neighborhoods.json. Use the empty string \"\" to clear."}],"flags":[]},{"kind":"group","name":"registryFirst","host":"system","full":"config collision preference registryFirst","children":[{"kind":"command","name":"off","host":"system","full":"config collision preference registryFirst off","description":"Turn off registry-first detection (scan all embedding candidates against the neighborhood registry, independent of the score-delta detector)","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config collision preference registryFirst on","description":"Turn on registry-first detection (scan all embedding candidates against the neighborhood registry, independent of the score-delta detector)","args":[],"flags":[]}],"description":"Toggle registry-first detection (scan all embedding candidates against the neighborhood registry, independent of the score-delta detector)","args":[],"flags":[]},{"kind":"command","name":"remember","host":"system","full":"config collision preference remember","description":"Set how learned preferences are captured for the `preference-clarify` strategy. Empty argument shows the current value.","args":[{"name":"mode","optional":true,"description":"One of: prompt, always, never."}],"flags":[]},{"kind":"command","name":"source","host":"system","full":"config collision preference source","description":"Set which ambiguity source feeds the `preference-clarify` strategy. Empty argument shows the current value.","args":[{"name":"source","optional":true,"description":"One of: runtime, registry, both."}],"flags":[]}],"description":"Configure the preference-clarify strategy (Tier-1 preferences + Tier-2 registry)","args":[],"flags":[]},{"kind":"command","name":"priority","host":"system","full":"config collision priority","description":"Set priorityOrder (comma-separated agent names) used by the `priority` resolution strategy. Empty argument shows the current value.","args":[{"name":"order","optional":true,"description":"Comma-separated agent names, e.g. \"list,player,calendar\". Use the empty string \"\" to clear."}],"flags":[]},{"kind":"command","name":"show","host":"system","full":"config collision show","description":"Show the current collision detection config","args":[],"flags":[]},{"kind":"group","name":"static","host":"system","full":"config collision static","children":[{"kind":"group","name":"detect","host":"system","full":"config collision static detect","children":[{"kind":"command","name":"off","host":"system","full":"config collision static detect off","description":"Turn off static collision detection","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config collision static detect on","description":"Turn on static collision detection","args":[],"flags":[]}],"description":"Toggle static collision detection","args":[],"flags":[]},{"kind":"command","name":"strategy","host":"system","full":"config collision static strategy","description":"Set static resolution strategy (one of: warn, error)","args":[{"name":"strategy","optional":false,"description":"strategy name"}],"flags":[]}],"description":"Configure static collision detection","args":[],"flags":[]},{"kind":"group","name":"telemetry","host":"system","full":"config collision telemetry","children":[{"kind":"group","name":"debugLog","host":"system","full":"config collision telemetry debugLog","children":[{"kind":"command","name":"off","host":"system","full":"config collision telemetry debugLog off","description":"Turn off collision telemetry debug log","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config collision telemetry debugLog on","description":"Turn on collision telemetry debug log","args":[],"flags":[]}],"description":"Toggle collision telemetry debug log","args":[],"flags":[]},{"kind":"group","name":"emit","host":"system","full":"config collision telemetry emit","children":[{"kind":"command","name":"off","host":"system","full":"config collision telemetry emit off","description":"Turn off collision telemetry ring buffer","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config collision telemetry emit on","description":"Turn on collision telemetry ring buffer","args":[],"flags":[]}],"description":"Toggle collision telemetry ring buffer","args":[],"flags":[]},{"kind":"command","name":"experimentId","host":"system","full":"config collision telemetry experimentId","description":"Set the experimentId tag attached to every emitted collision event. Empty string clears it.","args":[{"name":"id","optional":true,"description":"Experiment tag, e.g. \"E1.2-2026-05-12\". Empty string \"\" clears."}],"flags":[]}],"description":"Configure collision telemetry","args":[],"flags":[]}],"description":"Configure action collision detection","args":[],"flags":[]},{"kind":"command","name":"command","host":"system","full":"config command","description":"Toggle agent commands","args":[{"name":"agentNames","optional":true,"description":"enable pattern"}],"flags":[{"name":"reset","char":"r","default":"false","description":"reset to default"},{"name":"off","char":"x","default":"","description":"disable pattern"},{"name":"priority","char":"f","default":"","description":"priority pattern"}]},{"kind":"group","name":"dev","host":"system","full":"config dev","children":[{"kind":"command","name":"off","host":"system","full":"config dev off","description":"Turn off development mode","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config dev on","description":"Turn on development mode (records conversation + translation data)","args":[],"flags":[{"name":"confirm","char":"c","default":"false","description":"Also confirm each translated action via the client before running it"}]}],"description":"Toggle development mode","args":[],"flags":[]},{"kind":"group","name":"execution","host":"system","full":"config execution","children":[{"kind":"group","name":"activity","host":"system","full":"config execution activity","children":[{"kind":"command","name":"off","host":"system","full":"config execution activity off","description":"Turn off activity context","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config execution activity on","description":"Turn on activity context","args":[],"flags":[]}],"description":"Toggle activity context","args":[],"flags":[]},{"kind":"command","name":"conversationAnswer","host":"system","full":"config execution conversationAnswer","description":"How conversation questions are answered: 'lookup' (conversation-memory lookup, reasoning as fallback), 'reasoning-first' (reasoning agent primary, lookup as fallback), or 'reasoning-only' (remove the lookup action; reasoning handles conversation Q&A)","args":[{"name":"strategy","optional":true,"description":"'lookup' (default), 'reasoning-first', or 'reasoning-only'. Omit to show the current strategy."}],"flags":[]},{"kind":"command","name":"entityPromptShape","host":"system","full":"config execution entityPromptShape","description":"Shape used when serializing Entity objects into LLM prompts","args":[{"name":"shape","optional":true,"description":"'facets' (default, name+value array), 'flat' (collapse facets into a properties object), or 'facets-with-schema' (facets + append the Entity TS type to the reasoning system prompt). Omit to show the current value."}],"flags":[]},{"kind":"command","name":"planReuse","host":"system","full":"config execution planReuse","description":"Enable or disable workflow plan reuse for reasoning actions","args":[{"name":"mode","optional":true,"description":"Plan reuse mode: 'enabled' to cache and reuse workflow plans, 'disabled' for standard reasoning. Omit to show the current value."}],"flags":[]},{"kind":"command","name":"reasoning","host":"system","full":"config execution reasoning","description":"Set reasoning engine","args":[{"name":"engine","optional":true,"description":"Reasoning engine to use (claude, copilot, or none). Omit to show the current engine."}],"flags":[]},{"kind":"command","name":"reasoningEffort","host":"system","full":"config execution reasoningEffort","description":"Set the Copilot reasoning effort (low, medium, high, xhigh). Only applies to models that support it. Omit to show the current value.","args":[{"name":"effort","optional":true,"description":"'low', 'medium', 'high', or 'xhigh'. Omit to show the current value."}],"flags":[]},{"kind":"command","name":"reasoningHistory","host":"system","full":"config execution reasoningHistory","description":"Number of recent conversation turns included as context in the reasoning prompt","args":[{"name":"turns","optional":true,"description":"Number of recent conversation turns to include (e.g. 4). 0 disables history. Omit to show the current value."}],"flags":[]},{"kind":"command","name":"reasoningModel","host":"system","full":"config execution reasoningModel","description":"Set the Copilot reasoning model (e.g. claude-opus-4.8). Omit to show the current value.","args":[{"name":"model","optional":true,"description":"Model identifier for Copilot reasoning. Omit to show the current value."}],"flags":[]},{"kind":"group","name":"recordUserMessages","host":"system","full":"config execution recordUserMessages","children":[{"kind":"command","name":"off","host":"system","full":"config execution recordUserMessages off","description":"Turn off record the user's own messages in the conversation transcript (chat history)","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config execution recordUserMessages on","description":"Turn on record the user's own messages in the conversation transcript (chat history)","args":[],"flags":[]}],"description":"Toggle record the user's own messages in the conversation transcript (chat history)","args":[],"flags":[]},{"kind":"command","name":"scriptReuse","host":"system","full":"config execution scriptReuse","description":"Enable or disable PowerShell script reuse for reasoning actions","args":[{"name":"mode","optional":true,"description":"Script reuse mode: 'enabled' to capture and reuse PowerShell scripts, 'disabled' for standard reasoning. Omit to show the current value."}],"flags":[]},{"kind":"group","name":"setupOnFirstUse","host":"system","full":"config execution setupOnFirstUse","children":[{"kind":"command","name":"off","host":"system","full":"config execution setupOnFirstUse off","description":"Turn off auto-run agent setup on first use (otherwise emit a hint to run @config agent setup)","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config execution setupOnFirstUse on","description":"Turn on auto-run agent setup on first use (otherwise emit a hint to run @config agent setup)","args":[],"flags":[]}],"description":"Toggle auto-run agent setup on first use (otherwise emit a hint to run @config agent setup)","args":[],"flags":[]},{"kind":"group","name":"subagents","host":"system","full":"config execution subagents","children":[{"kind":"command","name":"off","host":"system","full":"config execution subagents off","description":"Turn off allow the reasoning loop to create and manage subagents (each with its own command-executor process)","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config execution subagents on","description":"Turn on allow the reasoning loop to create and manage subagents (each with its own command-executor process)","args":[],"flags":[]}],"description":"Toggle allow the reasoning loop to create and manage subagents (each with its own command-executor process)","args":[],"flags":[]}],"description":"Execution configuration","args":[],"flags":[]},{"kind":"group","name":"explainer","host":"system","full":"config explainer","children":[{"kind":"group","name":"async","host":"system","full":"config explainer async","children":[{"kind":"command","name":"off","host":"system","full":"config explainer async off","description":"Turn off asynchronous explanation","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config explainer async on","description":"Turn on asynchronous explanation","args":[],"flags":[]}],"description":"Toggle asynchronous explanation","args":[],"flags":[]},{"kind":"group","name":"filter","host":"system","full":"config explainer filter","children":[{"kind":"group","name":"multiple","host":"system","full":"config explainer filter multiple","children":[{"kind":"command","name":"off","host":"system","full":"config explainer filter multiple off","description":"Turn off explanation filter multiple actions","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config explainer filter multiple on","description":"Turn on explanation filter multiple actions","args":[],"flags":[]}],"description":"Toggle explanation filter multiple actions","args":[],"flags":[]},{"kind":"command","name":"off","host":"system","full":"config explainer filter off","description":"Turn off all explanation filters","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config explainer filter on","description":"Turn on all explanation filters","args":[],"flags":[]},{"kind":"group","name":"reference","host":"system","full":"config explainer filter reference","children":[{"kind":"group","name":"list","host":"system","full":"config explainer filter reference list","children":[{"kind":"command","name":"off","host":"system","full":"config explainer filter reference list off","description":"Turn off explainer filter reference using word lists","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config explainer filter reference list on","description":"Turn on explainer filter reference using word lists","args":[],"flags":[]}],"description":"Toggle explainer filter reference using word lists","args":[],"flags":[]},{"kind":"command","name":"off","host":"system","full":"config explainer filter reference off","description":"Turn off all explanation reference filters","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config explainer filter reference on","description":"Turn on all explanation reference filters","args":[],"flags":[]},{"kind":"group","name":"translate","host":"system","full":"config explainer filter reference translate","children":[{"kind":"command","name":"off","host":"system","full":"config explainer filter reference translate off","description":"Turn off explainer filter reference by translate without context","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config explainer filter reference translate on","description":"Turn on explainer filter reference by translate without context","args":[],"flags":[]}],"description":"Toggle explainer filter reference by translate without context","args":[],"flags":[]},{"kind":"group","name":"value","host":"system","full":"config explainer filter reference value","children":[{"kind":"command","name":"off","host":"system","full":"config explainer filter reference value off","description":"Turn off explainer filter reference by value in the request","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config explainer filter reference value on","description":"Turn on explainer filter reference by value in the request","args":[],"flags":[]}],"description":"Toggle explainer filter reference by value in the request","args":[],"flags":[]}],"description":"Toggle reference filter","args":[],"flags":[]}],"description":"Toggle explanation filter","args":[],"flags":[]},{"kind":"command","name":"model","host":"system","full":"config explainer model","description":"Set model","args":[{"name":"model","optional":true,"description":"Model name"}],"flags":[{"name":"reset","char":"r","default":"false","description":"Reset to default model"}]},{"kind":"command","name":"name","host":"system","full":"config explainer name","description":"Set explainer","args":[{"name":"explainerName","optional":false,"description":"name of the explainer"}],"flags":[]},{"kind":"command","name":"off","host":"system","full":"config explainer off","description":"Turn off explanation","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config explainer on","description":"Turn on explanation","args":[],"flags":[]}],"description":"Explainer configuration","args":[],"flags":[]},{"kind":"group","name":"log","host":"system","full":"config log","children":[{"kind":"group","name":"db","host":"system","full":"config log db","children":[{"kind":"command","name":"off","host":"system","full":"config log db off","description":"Turn off logging","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config log db on","description":"Turn on logging","args":[],"flags":[]}],"description":"Toggle logging","args":[],"flags":[]}],"description":"Toggle logging","args":[],"flags":[]},{"kind":"group","name":"match","host":"system","full":"config match","children":[{"kind":"group","name":"grammar","host":"system","full":"config match grammar","children":[{"kind":"command","name":"off","host":"system","full":"config match grammar off","description":"Turn off grammar cache usage","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config match grammar on","description":"Turn on grammar cache usage","args":[],"flags":[]}],"description":"Toggle grammar cache usage","args":[],"flags":[]}],"description":"Configure match behavior","args":[],"flags":[]},{"kind":"command","name":"modelProvider","host":"system","full":"config modelProvider","description":"Show or set the active model provider (azure | openai | ollama | copilot)","args":[{"name":"name","optional":true,"description":"Provider to activate (azure | openai | ollama | copilot)"},{"name":"action","optional":true,"description":"Optional 'list' to list provider's models"}],"flags":[]},{"kind":"command","name":"request","host":"system","full":"config request","description":"Set the agent that handle natural language requests","args":[{"name":"appAgentName","optional":false,"description":"name of the agent"}],"flags":[]},{"kind":"command","name":"schema","host":"system","full":"config schema","description":"Toggle agent schemas","args":[{"name":"agentNames","optional":true,"description":"enable pattern"}],"flags":[{"name":"reset","char":"r","default":"false","description":"reset to default"},{"name":"off","char":"x","default":"","description":"disable pattern"},{"name":"priority","char":"f","default":"","description":"priority pattern"}]},{"kind":"group","name":"scrub","host":"system","full":"config scrub","children":[{"kind":"command","name":"off","host":"system","full":"config scrub off","description":"Turn off outbound secret scrubbing","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config scrub on","description":"Turn on outbound secret scrubbing","args":[],"flags":[]}],"description":"Toggle outbound secret scrubbing","args":[],"flags":[]},{"kind":"group","name":"translation","host":"system","full":"config translation","children":[{"kind":"group","name":"entity","host":"system","full":"config translation entity","children":[{"kind":"group","name":"clarify","host":"system","full":"config translation entity clarify","children":[{"kind":"command","name":"off","host":"system","full":"config translation entity clarify off","description":"Turn off entity clarification","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation entity clarify on","description":"Turn on entity clarification","args":[],"flags":[]}],"description":"Toggle entity clarification","args":[],"flags":[]},{"kind":"group","name":"filter","host":"system","full":"config translation entity filter","children":[{"kind":"command","name":"off","host":"system","full":"config translation entity filter off","description":"Turn off entity filter using LLM","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation entity filter on","description":"Turn on entity filter using LLM","args":[],"flags":[]}],"description":"Toggle entity filter using LLM","args":[],"flags":[]},{"kind":"group","name":"resolve","host":"system","full":"config translation entity resolve","children":[{"kind":"command","name":"off","host":"system","full":"config translation entity resolve off","description":"Turn off entity resolution","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation entity resolve on","description":"Turn on entity resolution","args":[],"flags":[]}],"description":"Toggle entity resolution","args":[],"flags":[]}],"description":"Entity translation configuration","args":[],"flags":[]},{"kind":"group","name":"history","host":"system","full":"config translation history","children":[{"kind":"command","name":"limit","host":"system","full":"config translation history limit","description":"Set the limit of chat history usage in translation","args":[{"name":"limit","optional":false,"description":"Number of actions"}],"flags":[]},{"kind":"command","name":"off","host":"system","full":"config translation history off","description":"Turn off history","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation history on","description":"Turn on history","args":[],"flags":[]}],"description":"Configure chat history usage in translation","args":[],"flags":[]},{"kind":"command","name":"model","host":"system","full":"config translation model","description":"Set model","args":[{"name":"model","optional":true,"description":"Model name"}],"flags":[{"name":"reset","char":"r","default":"false","description":"Reset to default model"}]},{"kind":"group","name":"multi","host":"system","full":"config translation multi","children":[{"kind":"command","name":"off","host":"system","full":"config translation multi off","description":"Turn off multiple action translation","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation multi on","description":"Turn on multiple action translation","args":[],"flags":[]},{"kind":"group","name":"pending","host":"system","full":"config translation multi pending","children":[{"kind":"command","name":"off","host":"system","full":"config translation multi pending off","description":"Turn off pending request in multiple action","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation multi pending on","description":"Turn on pending request in multiple action","args":[],"flags":[]}],"description":"Toggle pending request in multiple action","args":[],"flags":[]},{"kind":"group","name":"result","host":"system","full":"config translation multi result","children":[{"kind":"command","name":"off","host":"system","full":"config translation multi result off","description":"Turn off result id in multiple action","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation multi result on","description":"Turn on result id in multiple action","args":[],"flags":[]}],"description":"Toggle result id in multiple action","args":[],"flags":[]}],"description":"multiple actions","args":[],"flags":[]},{"kind":"command","name":"off","host":"system","full":"config translation off","description":"Turn off translation","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation on","description":"Turn on translation","args":[],"flags":[]},{"kind":"group","name":"recentActions","host":"system","full":"config translation recentActions","children":[{"kind":"command","name":"limit","host":"system","full":"config translation recentActions limit","description":"Set the max number of recently executed actions included in translation history (0-100, 0 = off)","args":[{"name":"limit","optional":false,"description":"Number of actions (0-100, 0 = off)"}],"flags":[]},{"kind":"command","name":"off","host":"system","full":"config translation recentActions off","description":"Turn off recently executed actions in translation","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation recentActions on","description":"Turn on recently executed actions in translation","args":[],"flags":[]}],"description":"Include recently executed actions in translation history","args":[],"flags":[]},{"kind":"group","name":"schema","host":"system","full":"config translation schema","children":[{"kind":"group","name":"generation","host":"system","full":"config translation schema generation","children":[{"kind":"group","name":"json","host":"system","full":"config translation schema generation json","children":[{"kind":"command","name":"off","host":"system","full":"config translation schema generation json off","description":"Turn off use generate json schema if model supports it","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation schema generation json on","description":"Turn on use generate json schema if model supports it","args":[],"flags":[]}],"description":"Toggle use generate json schema if model supports it","args":[],"flags":[]},{"kind":"group","name":"jsonFunc","host":"system","full":"config translation schema generation jsonFunc","children":[{"kind":"command","name":"off","host":"system","full":"config translation schema generation jsonFunc off","description":"Turn off use generate json schema function if model supports it","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation schema generation jsonFunc on","description":"Turn on use generate json schema function if model supports it","args":[],"flags":[]}],"description":"Toggle use generate json schema function if model supports it","args":[],"flags":[]},{"kind":"command","name":"off","host":"system","full":"config translation schema generation off","description":"Turn off generated action schema","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation schema generation on","description":"Turn on generated action schema","args":[],"flags":[]}],"description":"Generated action schema","args":[],"flags":[]},{"kind":"group","name":"optimize","host":"system","full":"config translation schema optimize","children":[{"kind":"command","name":"actions","host":"system","full":"config translation schema optimize actions","description":"Set number of actions to use for initial translation","args":[{"name":"count","optional":false,"description":"Number of actions"}],"flags":[]},{"kind":"command","name":"off","host":"system","full":"config translation schema optimize off","description":"Turn off schema optimization","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation schema optimize on","description":"Turn on schema optimization","args":[],"flags":[]}],"description":"Optimize schema","args":[],"flags":[]}],"description":"Action schema configuration","args":[],"flags":[]},{"kind":"group","name":"stream","host":"system","full":"config translation stream","children":[{"kind":"command","name":"off","host":"system","full":"config translation stream off","description":"Turn off streaming translation","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation stream on","description":"Turn on streaming translation","args":[],"flags":[]}],"description":"Toggle streaming translation","args":[],"flags":[]},{"kind":"group","name":"switch","host":"system","full":"config translation switch","children":[{"kind":"group","name":"embedding","host":"system","full":"config translation switch embedding","children":[{"kind":"command","name":"off","host":"system","full":"config translation switch embedding off","description":"Turn off Use embedding for initial pick of schema","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation switch embedding on","description":"Turn on Use embedding for initial pick of schema","args":[],"flags":[]}],"description":"Toggle Use embedding for initial pick of schema","args":[],"flags":[]},{"kind":"command","name":"fix","host":"system","full":"config translation switch fix","description":"Set a fixed schema disable switching","args":[{"name":"schemaName","optional":false,"description":"name of the schema"}],"flags":[]},{"kind":"group","name":"inline","host":"system","full":"config translation switch inline","children":[{"kind":"command","name":"off","host":"system","full":"config translation switch inline off","description":"Turn off inject inline switch","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation switch inline on","description":"Turn on inject inline switch","args":[],"flags":[]}],"description":"Toggle inject inline switch","args":[],"flags":[]},{"kind":"command","name":"off","host":"system","full":"config translation switch off","description":"Turn off switch schema","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation switch on","description":"Turn on switch schema","args":[],"flags":[]},{"kind":"group","name":"search","host":"system","full":"config translation switch search","children":[{"kind":"command","name":"off","host":"system","full":"config translation switch search off","description":"Turn off search switch","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"config translation switch search on","description":"Turn on search switch","args":[],"flags":[]}],"description":"Toggle search switch","args":[],"flags":[]}],"description":"auto switch schemas","args":[],"flags":[]}],"description":"Translation configuration","args":[],"flags":[]}],"description":"Configuration commands","args":[],"flags":[]},{"kind":"group","name":"const","host":"system","full":"const","children":[{"kind":"group","name":"auto","host":"system","full":"const auto","children":[{"kind":"command","name":"off","host":"system","full":"const auto off","description":"Turn off construction auto save","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"const auto on","description":"Turn on construction auto save","args":[],"flags":[]}],"description":"Toggle construction auto save","args":[],"flags":[]},{"kind":"group","name":"builtin","host":"system","full":"const builtin","children":[{"kind":"command","name":"off","host":"system","full":"const builtin off","description":"Turn off construction built-in cache","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"const builtin on","description":"Turn on construction built-in cache","args":[],"flags":[]}],"description":"Toggle construction built-in cache","args":[],"flags":[]},{"kind":"command","name":"delete","host":"system","full":"const delete","description":"Delete a construction by id","args":[{"name":"namespace","optional":false,"description":"namespace the construction in"},{"name":"id","optional":false,"description":"construction id to delete"}],"flags":[]},{"kind":"command","name":"import","host":"system","full":"const import","description":"Import constructions from test data","args":[{"name":"file","optional":true,"description":"Path to the construction file to import from. Load host specified test files if not specified."}],"flags":[{"name":"extended","char":"t","default":"false","description":"Load host specified extended test files if no file argument is specified"}]},{"kind":"command","name":"info","host":"system","full":"const info","description":"Show current construction store info","args":[],"flags":[]},{"kind":"command","name":"list","host":"system","full":"const list","description":"List constructions","args":[],"flags":[{"name":"verbose","char":"v","default":"false","description":"Verbose only.  Includes part index, and list all string in match set"},{"name":"all","char":"a","default":"false","description":"List all string in match set"},{"name":"builtin","char":"b","default":"false","description":"List the construction in the built-in cache"},{"name":"match","char":"m","default":"","description":"Filter to constructions that has the string in the match set"},{"name":"part","char":"p","default":"","description":"Filter to constructions that has the string match in the part name"},{"name":"id","char":"","default":"","description":"Construction id to list"}]},{"kind":"command","name":"load","host":"system","full":"const load","description":"Load a construction store from disk","args":[{"name":"file","optional":true,"description":"Construction file in the session directory or path to file"}],"flags":[]},{"kind":"group","name":"merge","host":"system","full":"const merge","children":[{"kind":"command","name":"off","host":"system","full":"const merge off","description":"Turn off construction merge","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"const merge on","description":"Turn on construction merge","args":[],"flags":[]}],"description":"Toggle construction merge","args":[],"flags":[]},{"kind":"command","name":"new","host":"system","full":"const new","description":"Create a new construction store","args":[{"name":"file","optional":true,"description":"File name to be created in the session directory or path to the file to be created."}],"flags":[]},{"kind":"command","name":"off","host":"system","full":"const off","description":"Disable construction store","args":[],"flags":[]},{"kind":"command","name":"prune","host":"system","full":"const prune","description":"Prune out of date construction from the cache","args":[],"flags":[]},{"kind":"command","name":"save","host":"system","full":"const save","description":"Save construction store to disk","args":[{"name":"file","optional":true,"description":"Construction file in the session directory or path to file"}],"flags":[]},{"kind":"group","name":"wildcard","host":"system","full":"const wildcard","children":[{"kind":"group","name":"entity","host":"system","full":"const wildcard entity","children":[{"kind":"command","name":"off","host":"system","full":"const wildcard entity off","description":"Turn off entity wildcard matching","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"const wildcard entity on","description":"Turn on entity wildcard matching","args":[],"flags":[]}],"description":"Toggle entity wildcard matching","args":[],"flags":[]},{"kind":"command","name":"off","host":"system","full":"const wildcard off","description":"Turn off wildcard matching","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"const wildcard on","description":"Turn on wildcard matching","args":[],"flags":[]}],"description":"wildcard matching","args":[],"flags":[]}],"description":"Command to manage the construction store","args":[],"flags":[]},{"kind":"group","name":"conversation","host":"system","full":"conversation","children":[{"kind":"command","name":"delete","host":"system","full":"conversation delete","actionName":"deleteConversation","description":"Delete a conversation by name","args":[{"name":"name","optional":false,"description":"Name of the conversation to delete"}],"flags":[]},{"kind":"command","name":"help","host":"system","full":"conversation help","description":"Show conversation command help","args":[],"flags":[]},{"kind":"command","name":"info","host":"system","full":"conversation info","actionName":"showConversationInfo","description":"Show info about the current conversation","args":[],"flags":[]},{"kind":"command","name":"list","host":"system","full":"conversation list","actionName":"listConversation","description":"List all conversations","args":[],"flags":[]},{"kind":"command","name":"new","host":"system","full":"conversation new","actionName":"newConversation","description":"Create a new conversation, optionally with a name","args":[{"name":"name","optional":true,"description":"Name for the new conversation (optional)"}],"flags":[]},{"kind":"command","name":"next","host":"system","full":"conversation next","actionName":"nextConversation","description":"Switch to the next conversation in the list (wraps around)","args":[],"flags":[]},{"kind":"command","name":"prev","host":"system","full":"conversation prev","actionName":"prevConversation","description":"Switch to the previous conversation in the list (wraps around)","args":[],"flags":[]},{"kind":"command","name":"rename","host":"system","full":"conversation rename","actionName":"renameConversation","description":"Rename a conversation. With one argument, renames the current conversation; with two, renames the named conversation.","args":[{"name":"nameOrNewName","optional":false,"description":"New name (renames current) or existing name (when newName given)"},{"name":"newName","optional":true,"description":"New name when renaming a specific conversation"}],"flags":[]},{"kind":"command","name":"switch","host":"system","full":"conversation switch","actionName":"switchConversation","description":"Switch to a conversation by name (defaults to the next conversation in the list)","args":[{"name":"name","optional":true,"description":"Name of the conversation to switch to (omit to cycle to the next)"}],"flags":[]}],"description":"Conversation management commands","args":[],"flags":[]},{"kind":"group","name":"copilot","host":"system","full":"copilot","children":[{"kind":"command","name":"fix","host":"system","full":"copilot fix","description":"Hand the current conversation to GitHub Copilot Chat in VS Code to diagnose and fix","args":[{"name":"instructions","optional":true,"description":"Optional extra instructions to include in the Copilot prompt"}],"flags":[{"name":"mode","char":"","default":"agent","description":"Copilot chat mode: 'agent' (can edit the workspace) or 'ask'"},{"name":"no-screenshot","char":"","default":"false","description":"Do not attach a screenshot of the VS Code window"},{"name":"dev-captures","char":"","default":"auto","description":"Include developer-mode translation captures: 'auto' (when developer mode is on), 'on', or 'off'"},{"name":"target","char":"","default":"native","description":"Copilot target (reserved; only native GitHub Copilot is supported)"},{"name":"no-send","char":"","default":"false","description":"Pre-fill the Copilot prompt but do not auto-submit it (review before sending)"},{"name":"reuse-session","char":"","default":"false","description":"Send into the current Copilot Chat session instead of starting a new one"},{"name":"location","char":"","default":"editor","description":"Where to open the new session: 'editor' (new chat editor), 'view' (chat panel), or 'window' (separate chat window)"}]},{"kind":"command","name":"import","host":"system","full":"copilot import","description":"Import GitHub Copilot Chat sessions as conversation mirrors","args":[],"flags":[]},{"kind":"command","name":"login","host":"system","full":"copilot login","description":"Sign in to GitHub Copilot via the browser device flow","args":[],"flags":[{"name":"host","char":"","default":"https://github.com","description":"GitHub host URL (e.g. https://example.ghe.com for Enterprise Cloud with data residency)"},{"name":"no-open","char":"","default":"false","description":"Do not auto-open the verification URL in a browser (the code and URL are still shown in chat)"}]}],"description":"GitHub Copilot session commands","args":[],"flags":[]},{"kind":"command","name":"debug","host":"system","full":"debug","description":"Start node inspector","args":[],"flags":[]},{"kind":"group","name":"demo","host":"system","full":"demo","children":[{"kind":"command","name":"questionCards","host":"system","full":"demo questionCards","description":"Walk the interactive question types (single-select, multi-select, yes/no, free-text). Add --paged for a one-at-a-time Back/Next wizard.","args":[],"flags":[{"name":"paged","char":"p","default":"false","description":"Render one question at a time with Back / Next navigation"}]}],"description":"Interactive TypeAgent demos","args":[],"flags":[]},{"kind":"command","name":"describe","host":"system","full":"describe","description":"Describe what an agent or action can do (installed-but-disabled agents included)","args":[{"name":"name","optional":false,"description":"Agent name, or (if no action given) action name"},{"name":"actionName","optional":true,"description":"Action name, when `name` is an agent"}],"flags":[{"name":"all","char":"a","default":"false","description":"Show the full action table instead of the top 10"}]},{"kind":"command","name":"display","host":"system","full":"display","description":"Send text to display","args":[{"name":"text","optional":false,"description":"text to display"}],"flags":[{"name":"speak","char":"","default":"false","description":"Speak the display for the host that supports TTS"},{"name":"type","char":"","default":"text","description":"Display type"},{"name":"inline","char":"","default":"false","description":"Display inline"}]},{"kind":"group","name":"env","host":"system","full":"env","children":[{"kind":"command","name":"all","host":"system","full":"env all","description":"Echos environment variables to the user interface.","args":[],"flags":[]},{"kind":"command","name":"get","host":"system","full":"env get","description":"Echos the value of a named environment variable to the user interface","args":[{"name":"name","optional":false,"description":"The name of the environment variable."}],"flags":[]}],"description":"Environment variable commands","args":[],"flags":[]},{"kind":"command","name":"exit","host":"system","full":"exit","description":"Exit the program","args":[],"flags":[]},{"kind":"group","name":"feedback","host":"system","full":"feedback","children":[{"kind":"command","name":"count","host":"system","full":"feedback count","description":"Show the total number of feedback entries.","args":[],"flags":[]},{"kind":"command","name":"export","host":"system","full":"feedback export","description":"Export user-feedback entries to a local file (JSON or JSONL).","args":[{"name":"file","optional":false,"description":"Destination path (extension picks the format if --format is omitted: .jsonl → JSONL, anything else → JSON)"}],"flags":[{"name":"format","char":"","default":"","description":"json | jsonl (overrides the path extension)"},{"name":"all","char":"","default":"false","description":"Include every entry; otherwise only the latest rating per request"}]},{"kind":"command","name":"filter","host":"system","full":"feedback filter","description":"Filter feedback by rating, category, and/or date range.","args":[],"flags":[{"name":"rating","char":"","default":"","description":"up | down | cleared"},{"name":"category","char":"","default":"","description":"wrong-agent | didnt-understand | bad-response | other"},{"name":"since","char":"","default":"","description":"ISO date (YYYY-MM-DD) — entries on/after this date"},{"name":"until","char":"","default":"","description":"ISO date (YYYY-MM-DD) — entries on/before this date"},{"name":"limit","char":"","default":"50","description":"Maximum number of entries to show"},{"name":"all","char":"","default":"false","description":"Include every entry; otherwise only the latest rating per request"}]},{"kind":"command","name":"list","host":"system","full":"feedback list","description":"List recent user-feedback entries (most recent first).","args":[],"flags":[{"name":"limit","char":"","default":"20","description":"Maximum number of entries to show"},{"name":"all","char":"","default":"false","description":"Include every entry; otherwise only the latest rating per request is shown"}]},{"kind":"command","name":"top","host":"system","full":"feedback top","description":"Aggregate user feedback — counts by rating and category.","args":[],"flags":[{"name":"limit","char":"","default":"10","description":"Top-N depth for the per-category breakdown"}]}],"description":"Inspect and export user-feedback entries","args":[],"flags":[]},{"kind":"group","name":"grammar","host":"system","full":"grammar","children":[{"kind":"command","name":"clear","host":"system","full":"grammar clear","description":"Clear stored grammar rules (optionally for a specific agent)","args":[{"name":"agent","optional":true,"description":"Agent name to clear rules for. Omit to clear all stored rules."}],"flags":[]},{"kind":"command","name":"collisions","host":"system","full":"grammar collisions","description":"Scan all loaded agent grammars for cross-agent collisions, with concrete witness inputs","args":[],"flags":[{"name":"json","char":"","default":"","description":"Write the structured scan result to this path as JSON (in addition to rendering the report)"}]},{"kind":"command","name":"delete","host":"system","full":"grammar delete","description":"Delete a stored grammar rule by ID","args":[{"name":"id","optional":false,"description":"Numeric ID of the rule to delete"}],"flags":[]},{"kind":"command","name":"list","host":"system","full":"grammar list","description":"List grammar rules learned at runtime (optionally filtered by agent)","args":[{"name":"agent","optional":true,"description":"Agent name to filter by (e.g. 'list', 'player')"}],"flags":[]},{"kind":"command","name":"show","host":"system","full":"grammar show","description":"Show a stored grammar rule by ID","args":[{"name":"id","optional":false,"description":"Numeric ID of the rule to inspect"}],"flags":[]}],"description":"Grammar rule and collision commands","args":[],"flags":[]},{"kind":"command","name":"help","host":"system","full":"help","description":"Show help","args":[{"name":"command","optional":true,"description":"command to get help for"}],"flags":[{"name":"all","char":"a","default":"false","description":"shows all commands"}]},{"kind":"group","name":"history","host":"system","full":"history","children":[{"kind":"command","name":"clear","host":"system","full":"history clear","actionName":"clearHistory","description":"Clear the history","args":[],"flags":[{"name":"activity","char":"","default":"true","description":"Clear the current activity context"}]},{"kind":"command","name":"delete","host":"system","full":"history delete","actionName":"deleteHistory","description":"Delete a specific message from the chat history","args":[{"name":"index","optional":false,"description":"Chat history index to delete."}],"flags":[]},{"kind":"group","name":"entities","host":"system","full":"history entities","children":[{"kind":"command","name":"delete","host":"system","full":"history entities delete","description":"Delete entities from the chat history (working memory).","args":[{"name":"entityId","optional":false,"description":"The UniqueId of the entity"}],"flags":[]},{"kind":"command","name":"list","host":"system","full":"history entities list","description":"Shows all of the entities currently in 'working memory.'","args":[],"flags":[]}],"description":"History entity commands","args":[],"flags":[]},{"kind":"command","name":"insert","host":"system","full":"history insert","description":"Insert messages to chat history","args":[{"name":"messages","optional":false,"description":"Chat history messages to insert"}],"flags":[]},{"kind":"command","name":"list","host":"system","full":"history list","actionName":"listHistory","description":"List history","args":[],"flags":[]},{"kind":"command","name":"save","host":"system","full":"history save","description":"Save the chat history to a file","args":[{"name":"file","optional":false,"description":"File to save the chat history to"}],"flags":[]}],"description":"History commands","args":[],"flags":[]},{"kind":"group","name":"index","host":"system","full":"index","children":[{"kind":"command","name":"create","host":"system","full":"index create","description":"Create a new index","args":[{"name":"type","optional":false,"description":"The type of index to create [image, email, website]"},{"name":"name","optional":false,"description":"Name of the index"},{"name":"location","optional":false,"description":"Location of the index"}],"flags":[]},{"kind":"command","name":"delete","host":"system","full":"index delete","description":"Delete an index","args":[{"name":"name","optional":false,"description":"Name of the index to delete"}],"flags":[]},{"kind":"command","name":"info","host":"system","full":"index info","description":"Show index details","args":[{"name":"name","optional":false,"description":"Name of the index"}],"flags":[]},{"kind":"command","name":"list","host":"system","full":"index list","description":"List indexes","args":[],"flags":[]}],"description":"Indexing commands","args":[],"flags":[]},{"kind":"group","name":"memory","host":"system","full":"memory","children":[{"kind":"command","name":"answer","host":"system","full":"memory answer","description":"Answer a question using conversation memory","args":[{"name":"question","optional":false,"description":"Question to ask the conversation memory"}],"flags":[{"name":"asc","char":"","default":"true","description":"Sort results in ascending order"},{"name":"message","char":"","default":"false","description":"Display message"},{"name":"knowledge","char":"","default":"false","description":"Display knowledge"},{"name":"count","char":"","default":"25","description":"Display count of results"},{"name":"distinct","char":"","default":"false","description":"Display distinct results"}]},{"kind":"group","name":"legacy","host":"system","full":"memory legacy","children":[{"kind":"command","name":"off","host":"system","full":"memory legacy off","description":"Turn off legacy","args":[],"flags":[]},{"kind":"command","name":"on","host":"system","full":"memory legacy on","description":"Turn on legacy","args":[],"flags":[]}],"description":"Toggle legacy","args":[],"flags":[]},{"kind":"command","name":"query","host":"system","full":"memory query","description":"Search conversation memory","args":[{"name":"terms","optional":false,"description":"Terms to search in conversation memory"}],"flags":[{"name":"asc","char":"","default":"true","description":"Sort results in ascending order"},{"name":"message","char":"","default":"true","description":"Display message"},{"name":"knowledge","char":"","default":"true","description":"Display knowledge"},{"name":"count","char":"","default":"25","description":"Display count of results"},{"name":"distinct","char":"","default":"false","description":"Display distinct results"}]},{"kind":"command","name":"search","host":"system","full":"memory search","description":"Answer a question using conversation memory","args":[{"name":"question","optional":false,"description":"Question to ask the conversation memory"}],"flags":[{"name":"asc","char":"","default":"true","description":"Sort results in ascending order"},{"name":"message","char":"","default":"false","description":"Display message"},{"name":"knowledge","char":"","default":"false","description":"Display knowledge"},{"name":"count","char":"","default":"25","description":"Display count of results"},{"name":"distinct","char":"","default":"false","description":"Display distinct results"}]}],"description":"Memory commands","args":[],"flags":[]},{"kind":"group","name":"notify","host":"system","full":"notify","children":[{"kind":"command","name":"clear","host":"system","full":"notify clear","description":"Clears notifications","args":[],"flags":[]},{"kind":"command","name":"info","host":"system","full":"notify info","description":"Shows the number of notifications available","args":[],"flags":[]},{"kind":"group","name":"show","host":"system","full":"notify show","children":[{"kind":"command","name":"all","host":"system","full":"notify show all","description":"Shows all notifications","args":[],"flags":[]},{"kind":"command","name":"unread","host":"system","full":"notify show unread","description":"Shows unread notifications","args":[],"flags":[]}],"description":"Show notifications","args":[],"flags":[]},{"kind":"command","name":"status","host":"system","full":"notify status","description":"Fire a persistent status notice (a toast that collapses to the notification bell) to verify the chat-ui affordance without a stale server","args":[{"name":"message","optional":true,"description":"Notice body text"}],"flags":[{"name":"level","char":"","default":"warning","description":"Severity accent: info | warning | error"},{"name":"restart","char":"","default":"false","description":"Include a 'Restart server' action button (runs @server restart when clicked)"}]},{"kind":"command","name":"test","host":"system","full":"notify test","description":"Fire a synthetic notification through the channel — for verifying chat rendering without an agent","args":[{"name":"message","optional":false,"description":"Notification body text"}],"flags":[{"name":"mode","char":"","default":"toast","description":"Render mode: toast | inline | info | warning | error"}]}],"description":"Notify commands","args":[],"flags":[]},{"kind":"command","name":"open","host":"system","full":"open","description":"Shortcut for opening system related folders","args":[{"name":"folder","optional":false,"description":"The name or path of the folder to open"}],"flags":[]},{"kind":"command","name":"ports","host":"system","full":"ports","description":"Lists ports registered by agents and the number of clients connected to each.","args":[],"flags":[]},{"kind":"group","name":"random","host":"system","full":"random","children":[{"kind":"command","name":"offline","host":"system","full":"random offline","description":"Issues a random request from a dataset of pre-generated requests.","args":[],"flags":[]},{"kind":"command","name":"online","host":"system","full":"random online","description":"Uses the LLM to generate random requests.","args":[],"flags":[]}],"description":"Random request commands","args":[],"flags":[]},{"kind":"command","name":"run","host":"system","full":"run","description":"Run a command script file","args":[{"name":"input","optional":false,"description":"command script file path"}],"flags":[]},{"kind":"group","name":"server","host":"system","full":"server","children":[{"kind":"command","name":"restart","host":"system","full":"server restart","description":"Restart the agent server so it loads rebuilt code","args":[],"flags":[]}],"description":"Manage the agent server","args":[],"flags":[]},{"kind":"group","name":"session","host":"system","full":"session","children":[{"kind":"command","name":"clear","host":"system","full":"session clear","description":"Delete all data on the current sessions, keeping current settings","args":[],"flags":[]},{"kind":"command","name":"delete","host":"system","full":"session delete","description":"Delete a session. If no session is specified, delete the current session and start a new session.\n-a to delete all sessions","args":[{"name":"session","optional":true,"description":"Session name to delete"}],"flags":[{"name":"all","char":"a","default":"","description":"Delete all sessions"}]},{"kind":"command","name":"info","host":"system","full":"session info","description":"Show info about the current session","args":[],"flags":[]},{"kind":"command","name":"list","host":"system","full":"session list","description":"List all sessions. The current session is marked green.","args":[],"flags":[]},{"kind":"command","name":"new","host":"system","full":"session new","description":"Create a new empty session","args":[],"flags":[{"name":"keep","char":"","default":"false","description":"Copy the current session settings in the new session"},{"name":"persist","char":"","default":"","description":"Persist the new session.  Default to whether the current session is persisted."}]},{"kind":"command","name":"open","host":"system","full":"session open","description":"Open an existing session","args":[{"name":"session","optional":false,"description":"Name of the session to open."}],"flags":[]},{"kind":"command","name":"reset","host":"system","full":"session reset","description":"Reset config on session and keep the data","args":[],"flags":[]}],"description":"Session commands","args":[],"flags":[]},{"kind":"group","name":"settings","host":"system","full":"settings","children":[{"kind":"group","name":"conversation","host":"system","full":"settings conversation","children":[{"kind":"command","name":"resume","host":"system","full":"settings conversation resume","description":"Set whether to resume the last conversation on startup (true/false)","args":[{"name":"value","optional":false,"description":"true or false"}],"flags":[]}],"description":"Conversation settings","args":[],"flags":[]},{"kind":"command","name":"reset","host":"system","full":"settings reset","description":"Reset all settings to defaults","args":[],"flags":[]},{"kind":"group","name":"server","host":"system","full":"settings server","children":[{"kind":"command","name":"hidden","host":"system","full":"settings server hidden","description":"Set whether the AgentServer starts hidden (true/false)","args":[{"name":"value","optional":false,"description":"true or false"}],"flags":[]},{"kind":"command","name":"idleTimeout","host":"system","full":"settings server idleTimeout","description":"Set idle timeout in seconds (0 to disable)","args":[{"name":"seconds","optional":false,"description":"Timeout in seconds (0 = disabled)"}],"flags":[]}],"description":"Server startup settings","args":[],"flags":[]},{"kind":"command","name":"show","host":"system","full":"settings show","description":"Show all persistent user settings","args":[],"flags":[]},{"kind":"group","name":"ui","host":"system","full":"settings ui","children":[{"kind":"command","name":"autoComplete","host":"system","full":"settings ui autoComplete","description":"Set whether inline autocompletion is enabled in the CLI (true/false)","args":[{"name":"value","optional":false,"description":"true or false"}],"flags":[]}],"description":"UI settings","args":[],"flags":[]}],"description":"Persistent user settings","args":[],"flags":[]},{"kind":"command","name":"shutdown","host":"system","full":"shutdown","description":"Shut down the agent server and exit","args":[],"flags":[]},{"kind":"group","name":"token","host":"system","full":"token","children":[{"kind":"command","name":"details","host":"system","full":"token details","description":"Gets detailed LLM usage statistics.","args":[],"flags":[]},{"kind":"command","name":"summary","host":"system","full":"token summary","description":"Get overall LLM usage statistics.","args":[],"flags":[]}],"description":"Get LLM token usage statistics for this session.","args":[],"flags":[]},{"kind":"command","name":"trace","host":"system","full":"trace","description":"Enable or disable trace namespaces","args":[{"name":"namespaces","optional":true,"description":"Namespaces to enable"}],"flags":[{"name":"clear","char":"*","default":"false","description":"Clear all trace namespaces"}]}]},{"kind":"host","name":"browser","children":[{"kind":"group","name":"actions","host":"browser","full":"browser actions","children":[{"kind":"command","name":"infer","host":"browser","full":"browser actions infer","description":"Analyze page and infer new actions that can be automated","args":[],"flags":[]},{"kind":"command","name":"match","host":"browser","full":"browser actions match","description":"Discover available actions on the current web page","args":[],"flags":[]},{"kind":"command","name":"record","host":"browser","full":"browser actions record","description":"Record a new browser action by capturing user interactions","args":[{"name":"name","optional":false,"description":"Name for the action to record"}],"flags":[]},{"kind":"group","name":"stop","host":"browser","full":"browser actions stop","children":[{"kind":"command","name":"recording","host":"browser","full":"browser actions stop recording","description":"Stop recording and create a WebFlow","args":[{"name":"description","optional":true,"description":"Description of what the recorded action does"}],"flags":[]}],"description":"Stop operations","args":[],"flags":[]}],"description":"Manage page actions (match, record, infer, author)","args":[],"flags":[]},{"kind":"command","name":"ask","host":"browser","full":"browser ask","description":"Ask a question about the current web page using extracted knowledge","args":[{"name":"question","optional":false,"description":"Question to ask about the page"}],"flags":[]},{"kind":"group","name":"auto","host":"browser","full":"browser auto","children":[{"kind":"command","name":"close","host":"browser","full":"browser auto close","description":"Close the new Web Content view","args":[],"flags":[]},{"kind":"group","name":"launch","host":"browser","full":"browser auto launch","children":[{"kind":"command","name":"hidden","host":"browser","full":"browser auto launch hidden","description":"Open a hidden/headless browser instance","args":[],"flags":[]},{"kind":"command","name":"standalone","host":"browser","full":"browser auto launch standalone","description":"Open a standalone browser instance","args":[],"flags":[]}],"description":"Launch a browser session","args":[],"flags":[]}],"description":"Run the browser automation","args":[],"flags":[]},{"kind":"command","name":"close","host":"browser","full":"browser close","description":"Close the new Web Content view","args":[],"flags":[]},{"kind":"group","name":"external","host":"browser","full":"browser external","children":[{"kind":"command","name":"off","host":"browser","full":"browser external off","description":"Disable external browser control","args":[],"flags":[]},{"kind":"command","name":"on","host":"browser","full":"browser external on","description":"Enable external browser control","args":[],"flags":[]}],"description":"Toggle external browser control","args":[],"flags":[]},{"kind":"command","name":"extractKnowledge","host":"browser","full":"browser extractKnowledge","description":"Extract knowledge from the current web page","args":[],"flags":[]},{"kind":"command","name":"learn","host":"browser","full":"browser learn","description":"Learn a new action by demonstrating or describing it","args":[{"name":"goal","optional":false,"description":"The goal to accomplish (what the action should do)"}],"flags":[]},{"kind":"group","name":"lookup","host":"browser","full":"browser lookup","children":[{"kind":"command","name":"mode","host":"browser","full":"browser lookup mode","description":"Set the internet lookup mode: off (browser), api, or mcp","args":[{"name":"mode","optional":false,"description":"off | api | mcp"}],"flags":[]},{"kind":"command","name":"status","host":"browser","full":"browser lookup status","description":"Show the current internet lookup mode","args":[],"flags":[]}],"description":"Configure how internet lookups are answered (browser vs Azure AI Search)","args":[],"flags":[]},{"kind":"command","name":"open","host":"browser","full":"browser open","description":"Show a new Web Content view","args":[{"name":"site","optional":false,"description":"Alias or URL for the site of the open."}],"flags":[]},{"kind":"group","name":"resolver","host":"browser","full":"browser resolver","children":[{"kind":"command","name":"history","host":"browser","full":"browser resolver history","description":"Toggle history resolver","args":[],"flags":[]},{"kind":"command","name":"keyword","host":"browser","full":"browser resolver keyword","description":"Toggle keyword resolver","args":[],"flags":[]},{"kind":"command","name":"list","host":"browser","full":"browser resolver list","description":"List all available URL resolvers","args":[],"flags":[]}],"description":"Toggle URL resolver methods","args":[],"flags":[]},{"kind":"group","name":"search","host":"browser","full":"browser search","children":[{"kind":"command","name":"add","host":"browser","full":"browser search add","description":"Adds a new search provider","args":[{"name":"provider","optional":false,"description":"The name of the search provider to add."},{"name":"url","optional":false,"description":"The URL of the search provider to add. '%s' will be replaced with the search parameter."}],"flags":[]},{"kind":"command","name":"import","host":"browser","full":"browser search import","description":"Imports the search providers from the specified browser","args":[{"name":"browser","optional":false,"description":"The name of the browser to import search providers from: [Edge | Chrome]."}],"flags":[]},{"kind":"command","name":"list","host":"browser","full":"browser search list","description":"Lists browser agent search providers","args":[],"flags":[]},{"kind":"command","name":"remove","host":"browser","full":"browser search remove","description":"Removes the selected search provider","args":[{"name":"provider","optional":false,"description":"The name of the search provider to remove."}],"flags":[]},{"kind":"command","name":"set","host":"browser","full":"browser search set","description":"Sets the active search provider","args":[{"name":"provider","optional":false,"description":"The name of the search provider to set as active."}],"flags":[]},{"kind":"command","name":"show","host":"browser","full":"browser search show","description":"Shows the details of the selected search provider","args":[{"name":"provider","optional":false,"description":"The name of the search provider to show details for."}],"flags":[]}],"description":"List search providers","args":[],"flags":[]}]},{"kind":"host","name":"calendar","children":[{"kind":"command","name":"google-auth","host":"calendar","full":"calendar google-auth","description":"Complete Google Calendar OAuth flow with authorization code","args":[{"name":"code","optional":false,"description":"Authorization code from Google OAuth redirect"}],"flags":[]},{"kind":"command","name":"login","host":"calendar","full":"calendar login","description":"Log into calendar service","args":[],"flags":[]},{"kind":"command","name":"logout","host":"calendar","full":"calendar logout","description":"Log out of calendar service","args":[],"flags":[]}]},{"kind":"host","name":"dispatcher","children":[{"kind":"command","name":"explain","host":"dispatcher","full":"dispatcher explain","description":"Explain a translated request with action","args":[{"name":"requestAction","optional":false,"description":"Request to explain"}],"flags":[{"name":"repeat","char":"","default":"1","description":"Number of times to repeat the explanation"},{"name":"filterValueInRequest","char":"","default":"false","description":"Filter reference value for the explanation"},{"name":"filterReference","char":"","default":"false","description":"Filter reference words"},{"name":"concurrency","char":"","default":"5","description":"Number of concurrent requests"}]},{"kind":"command","name":"match","host":"dispatcher","full":"dispatcher match","description":"Match a request","args":[{"name":"request","optional":false,"description":"Request to match"}],"flags":[]},{"kind":"command","name":"reason","host":"dispatcher","full":"dispatcher reason","description":"Reason about a request","args":[{"name":"request","optional":false,"description":"Request to reason about"}],"flags":[{"name":"engine","char":"","default":"","description":"Reasoning engine to use: claude, copilot, or none"}]},{"kind":"command","name":"reasoning","host":"dispatcher","full":"dispatcher reasoning","description":"Reason about a request","args":[{"name":"request","optional":false,"description":"Request to reason about"}],"flags":[{"name":"engine","char":"","default":"","description":"Reasoning engine to use: claude, copilot, or none"}]},{"kind":"command","name":"request","host":"dispatcher","full":"dispatcher request","description":"Translate and explain a request","args":[{"name":"request","optional":true,"description":"Request to translate"}],"flags":[]},{"kind":"command","name":"translate","host":"dispatcher","full":"dispatcher translate","description":"Translate a request","args":[{"name":"request","optional":false,"description":"Request to translate"}],"flags":[{"name":"history","char":"","default":"false","description":"Use history in translation"}]}]},{"kind":"host","name":"email","children":[{"kind":"command","name":"google-auth","host":"email","full":"email google-auth","description":"Complete Google Gmail OAuth flow with authorization code","args":[{"name":"code","optional":false,"description":"Authorization code from Google OAuth redirect"}],"flags":[]},{"kind":"command","name":"index","host":"email","full":"email index","description":"Build keyword index from inbox emails for fast search","args":[],"flags":[]},{"kind":"command","name":"login","host":"email","full":"email login","description":"Log into email service","args":[],"flags":[]},{"kind":"command","name":"logout","host":"email","full":"email logout","description":"Log out of email service","args":[],"flags":[]}]},{"kind":"host","name":"localPlayer","children":[{"kind":"command","name":"clear","host":"localPlayer","full":"localPlayer clear","description":"Clear playback queue","args":[],"flags":[]},{"kind":"command","name":"folder","host":"localPlayer","full":"localPlayer folder","description":"Show current music folder","args":[],"flags":[]},{"kind":"command","name":"list","host":"localPlayer","full":"localPlayer list","description":"List audio files in music folder","args":[],"flags":[]},{"kind":"command","name":"mute","host":"localPlayer","full":"localPlayer mute","description":"Toggle mute","args":[],"flags":[]},{"kind":"command","name":"next","host":"localPlayer","full":"localPlayer next","description":"Play next track","args":[],"flags":[]},{"kind":"command","name":"pause","host":"localPlayer","full":"localPlayer pause","description":"Pause playback","args":[],"flags":[]},{"kind":"command","name":"play","host":"localPlayer","full":"localPlayer play","description":"Play an audio file or resume playback","args":[{"name":"file","optional":true,"description":"File name or path to play (optional - plays first file if not specified)"}],"flags":[]},{"kind":"command","name":"prev","host":"localPlayer","full":"localPlayer prev","description":"Play previous track","args":[],"flags":[]},{"kind":"command","name":"queue","host":"localPlayer","full":"localPlayer queue","description":"Show playback queue","args":[],"flags":[]},{"kind":"command","name":"resume","host":"localPlayer","full":"localPlayer resume","description":"Resume playback","args":[],"flags":[]},{"kind":"command","name":"setfolder","host":"localPlayer","full":"localPlayer setfolder","description":"Set the music folder path","args":[{"name":"path","optional":false,"description":"Path to the music folder"}],"flags":[]},{"kind":"command","name":"shuffle","host":"localPlayer","full":"localPlayer shuffle","description":"Toggle shuffle mode","args":[],"flags":[]},{"kind":"command","name":"status","host":"localPlayer","full":"localPlayer status","description":"Show local player status","args":[],"flags":[]},{"kind":"command","name":"stop","host":"localPlayer","full":"localPlayer stop","description":"Stop playback","args":[],"flags":[]},{"kind":"command","name":"volume","host":"localPlayer","full":"localPlayer volume","description":"Set volume level (0-100)","args":[{"name":"level","optional":false,"description":"Volume level (0-100)"}],"flags":[]}]},{"kind":"host","name":"osNotifications","children":[{"kind":"command","name":"sync","host":"osNotifications","full":"osNotifications sync","description":"Re-emit currently-present OS notifications through the agent pipeline. Windows only — Linux/macOS do not expose existing notifications.","args":[],"flags":[]},{"kind":"command","name":"test","host":"osNotifications","full":"osNotifications test","description":"Inject a synthetic notification through the agent pipeline (filters, rate limit, dismiss tracking) — useful for verifying the agent end-to-end without an OS notification source.","args":[{"name":"message","optional":true,"description":"Notification body text (defaults to 'Hello World!')"}],"flags":[{"name":"app","char":"","default":"test","description":"App name to attach to the synthetic notification (matched against allowList/blockList)"},{"name":"title","char":"","default":"Test","description":"Notification title (defaults to 'Test')"}]}]},{"kind":"host","name":"player","children":[{"kind":"group","name":"spotify","host":"player","full":"player spotify","children":[{"kind":"command","name":"load","host":"player","full":"player spotify load","description":"Load spotify user data","args":[{"name":"file","optional":false,"description":"File to load"}],"flags":[]},{"kind":"command","name":"login","host":"player","full":"player spotify login","description":"Login to Spotify","args":[],"flags":[]},{"kind":"command","name":"logout","host":"player","full":"player spotify logout","description":"Logout from Spotify","args":[],"flags":[]}],"description":"Configure spotify integration","args":[],"flags":[]}]},{"kind":"host","name":"powershell","children":[{"kind":"command","name":"delete","host":"powershell","full":"powershell delete","description":"Delete a PowerShell flow by name","args":[{"name":"name","optional":false,"description":"Name of the PowerShell flow to delete"}],"flags":[]},{"kind":"command","name":"import","host":"powershell","full":"powershell import","description":"Import a PowerShell script as a reusable PowerShell flow","args":[{"name":"filePath","optional":false,"description":"Path to the .ps1 file to import"}],"flags":[{"name":"actionName","char":"","default":"","description":"Override the generated action name"}]},{"kind":"command","name":"list","host":"powershell","full":"powershell list","description":"List all registered PowerShell flows","args":[],"flags":[]},{"kind":"command","name":"run","host":"powershell","full":"powershell run","description":"Execute a PowerShell flow by name","args":[{"name":"flowName","optional":false,"description":"Name of the PowerShell flow to execute"}],"flags":[{"name":"flowParametersJson","char":"","default":"","description":"JSON string of parameters, e.g. '{\"path\":\"C:\\\\Users\"}'"}]},{"kind":"command","name":"show","host":"powershell","full":"powershell show","description":"Show details of a PowerShell flow","args":[{"name":"flowName","optional":false,"description":"Name of the PowerShell flow to show"}],"flags":[]}]},{"kind":"host","name":"selfhelp","children":[{"kind":"command","name":"ask","host":"selfhelp","full":"selfhelp ask","description":"Ask a question about TypeAgent (what it is, how it works, how to set it up).","args":[{"name":"question","optional":false,"description":"Your question about TypeAgent."}],"flags":[]}]}]}}</script>
 <script>
 (function(){
   var DATA = JSON.parse(document.getElementById('data').textContent);
@@ -183,6 +193,15 @@ <h1>🧭 TypeAgent Action Browser</h1>
   computeValue(DATA.agents); computeValue(DATA.commands);
   assignHues(DATA.agents); assignHues(DATA.commands);
 
+  // Cross-reference actions with the commands declared equivalent to them, and
+  // tally how many commands carry a natural-language action.
+  var actionIndex={}, commandsForAction={}, commandLeafCount=0, commandLinkedCount=0;
+  (function walk(n){ if(n.kind==='action'){ actionIndex[n.agent+'\n'+n.name]=n; } if(n.children) n.children.forEach(walk); })(DATA.agents);
+  (function walk(n){
+    if(n.kind==='command'){ commandLeafCount++; if(n.actionName){ commandLinkedCount++; var k=n.host+'\n'+n.actionName; (commandsForAction[k]||(commandsForAction[k]=[])).push(n); } }
+    if(n.children) n.children.forEach(walk);
+  })(DATA.commands);
+
   var state = { mode:'agents', path:[DATA.agents], query:'' };
 
   function currentNode(){ return state.path[state.path.length-1]; }
@@ -190,7 +209,7 @@ <h1>🧭 TypeAgent Action Browser</h1>
   function colorFor(node, idx, n){
     var h = node._hue==null?210:node._hue;
     var sat = (node.kind==='action'||node.kind==='command')?40:58;
-    var base = (node.kind==='category'||node.kind==='group')?42:(node.kind==='agent')?52:66;
+    var base = (node.kind==='category'||node.kind==='host')?42:(node.kind==='agent'||node.kind==='group')?52:66;
     var jitter = n>1 ? ((idx/(n-1))-0.5)*12 : 0;
     return 'hsl('+h+','+sat+'%,'+(base+jitter)+'%)';
   }
@@ -232,15 +251,20 @@ <h1>🧭 TypeAgent Action Browser</h1>
   }
 
   function displayName(node){
-    if(node.kind==='command') return '@'+node.name;
+    if(node.kind==='command' || node.kind==='group'){
+      // Browsing shows the path segment (the breadcrumb carries the context);
+      // search shows the full '@command' since results have no breadcrumb.
+      return (state.query && node.full) ? '@'+node.full : node.name;
+    }
     if(node.kind==='action' && state.query && node.agent) return node.agent+' · '+node.name;
     return (node.emoji?node.emoji+' ':'')+node.name;
   }
   function subLabel(node){
     var c = node.children?node.children.length:0;
     if(node.kind==='category') return c+(c===1?' agent':' agents');
+    if(node.kind==='host'){ var n=node._value||c; return n+(n===1?' command':' commands'); }
     if(node.kind==='agent') return c+(c===1?' action':' actions');
-    if(node.kind==='group') return c+(c===1?' command':' commands');
+    if(node.kind==='group'){ var g=node._value||c; return g+(g===1?' command':' commands'); }
     return '';
   }
 
@@ -261,7 +285,7 @@ <h1>🧭 TypeAgent Action Browser</h1>
   function buildCell(c, role, idx, n){
     var node=c.node;
     var el=document.createElement('div');
-    el.className='cell '+role+' k-'+node.kind;
+    el.className='cell '+role+' k-'+node.kind+(node.actionName?' linked':'');
     el._layout=c;
     if(role==='container'){
       var h=node._hue==null?210:node._hue;
@@ -282,7 +306,8 @@ <h1>🧭 TypeAgent Action Browser</h1>
     var nameHtml='<span class="lbl-name" style="font-size:'+Math.round(sz.name)+'px">'+esc(displayName(node))+'</span>';
     var subHtml=(sub && sz.showSub)?'<span class="lbl-sub" style="font-size:'+Math.round(sz.sub)+'px">'+esc(sub)+'</span>':'';
     el.innerHTML='<div class="'+lblCls+'">'+nameHtml+subHtml+'</div>';
-    var t = node.kind==='action'&&node.agent ? node.agent+' · '+node.name : displayName(node);
+    var t = node.kind==='action'&&node.agent ? node.agent+' · '+node.name
+      : (node.full ? '@'+node.full : displayName(node));
     el.title = t + (node.description?' — '+node.description:'');
     if(role==='tile'){
       if(vertical){ el.classList.add('vert'); }
@@ -296,10 +321,10 @@ <h1>🧭 TypeAgent Action Browser</h1>
   }
 
   function onCellClick(node, el){
-    // Agents and command groups open a details dialog (a treemap of their
-    // actions/commands would be meaningless without usage data); categories
-    // zoom in; leaves (reached via search) open the side panel.
-    if(node.kind==='agent' || node.kind==='group'){ openActionsDialog(node); return; }
+    // Agents open a details dialog (their actions have no sub-structure to zoom
+    // into). Categories, command hosts, and command groups zoom in; leaves
+    // open the side panel.
+    if(node.kind==='agent'){ openActionsDialog(node); return; }
     if(node.children && node.children.length){
       var r=el._layout;
       state.path.push(node);
@@ -341,10 +366,13 @@ <h1>🧭 TypeAgent Action Browser</h1>
       e.textContent = state.query ? 'No matches for “'+state.query+'”.' : 'Nothing to show here.';
       mapEl.appendChild(e); renderBreadcrumb(); return;
     }
-    // At the top level (agents mode), promote agents: draw each category as a
-    // labelled container with its agent tiles nested inside (one level deep).
-    var nested = !state.query && state.path.length===1 && state.mode==='agents';
-    var HEADER=26, PAD=7;
+    // At the top level, promote the top grouping (categories in agents mode,
+    // hosts in commands mode): draw each as a labelled container with its
+    // child tiles nested inside (one level deep).
+    var nested = !state.query && state.path.length===1;
+    // HEADER must clear the container's rendered header label (~33px at the largest
+    // font/line-height) so the first row of nested tiles isn't drawn under it.
+    var HEADER=36, PAD=7;
     var top=squarify(kids.map(function(k){return {node:k,value:sizeValue(k._value||1)};}),0,0,W,H);
     var pending=[];
     function add(el,c){ startPlace(el,c,fromRect,W,H); pending.push({el:el,c:c}); }
@@ -381,10 +409,15 @@ <h1>🧭 TypeAgent Action Browser</h1>
       if(i<state.path.length-1 || state.query){ var s=document.createElement('span'); s.className='crumb-sep'; s.textContent='›'; crumbEl.appendChild(s); }
     });
     if(state.query){ var r=document.createElement('span'); r.className='crumb crumb-static'; r.textContent='Results: “'+state.query+'”'; crumbEl.appendChild(r); }
+    if(state.mode==='commands' && !state.query){
+      var cov=document.createElement('span'); cov.className='cov-chip';
+      cov.textContent=commandLinkedCount+' / '+commandLeafCount+' commands have an action';
+      crumbEl.appendChild(cov);
+    }
   }
 
   function buildHay(node){
-    var parts=[node.name, node.description||'', node.agent||''];
+    var parts=[node.name, node.full||'', node.description||'', node.agent||''];
     if(node.parameters) node.parameters.forEach(function(p){parts.push(p.name,p.description||'');});
     if(node.phrasings) parts=parts.concat(node.phrasings);
     if(node.args) node.args.forEach(function(a){parts.push(a.name,a.description||'');});
@@ -469,11 +502,35 @@ <h1>🧭 TypeAgent Action Browser</h1>
     return html;
   }
 
+  // Cross-link chips between a command and its equivalent action. Targets are
+  // stashed by index because the panel body is set via innerHTML.
+  var panelLinkTargets=[];
+  function panelLinkChip(node){
+    var i=panelLinkTargets.push(node)-1;
+    var label=node.kind==='command'?'@'+(node.full||node.name):node.name;
+    return '<button class="p-link" data-link="'+i+'">'+esc(label)+'</button>';
+  }
+  function crossLinkHtml(node){
+    if(node.kind==='command' && node.actionName){
+      var a=actionIndex[node.host+'\n'+node.actionName];
+      return '<div class="p-xlink"><span class="p-xlabel">Same as action</span>'+(a?panelLinkChip(a):'<span class="p-xnote">'+esc(node.actionName)+'</span>')+'</div>';
+    }
+    if(node.kind==='action'){
+      var cs=commandsForAction[node.agent+'\n'+node.name];
+      if(cs&&cs.length){
+        var chips=''; for(var i=0;i<cs.length;i++){ chips+=panelLinkChip(cs[i]); }
+        return '<div class="p-xlink"><span class="p-xlabel">Same as command'+(cs.length>1?'s':'')+'</span>'+chips+'</div>';
+      }
+    }
+    return '';
+  }
+
   function openPanel(node){
     if(node.kind!=='action' && node.kind!=='command') return;
-    var kicker = node.kind==='action' ? esc(node.agent||'')+' · '+esc(node.schema||'') : 'system command';
-    var title = node.kind==='command' ? '@'+esc(node.name) : esc(node.name);
-    document.getElementById('panelBody').innerHTML='<div class="p-kicker">'+kicker+'</div><h2 class="p-title">'+title+'</h2>'+detailHtml(node);
+    panelLinkTargets=[];
+    var kicker = node.kind==='action' ? esc(node.agent||'')+' · '+esc(node.schema||'') : esc(node.host||'system')+' command';
+    var title = node.kind==='command' ? '@'+esc(node.full||node.name) : esc(node.name);
+    document.getElementById('panelBody').innerHTML='<div class="p-kicker">'+kicker+'</div><h2 class="p-title">'+title+'</h2>'+crossLinkHtml(node)+detailHtml(node);
     document.getElementById('panel').classList.add('open');
     document.getElementById('backdrop').classList.add('show');
   }
@@ -555,6 +612,10 @@ <h1>🧭 TypeAgent Action Browser</h1>
 
   document.getElementById('panelClose').addEventListener('click', closePanel);
   document.getElementById('backdrop').addEventListener('click', closePanel);
+  document.getElementById('panelBody').addEventListener('click', function(ev){
+    var b=ev.target.closest?ev.target.closest('.p-link[data-link]'):null;
+    if(b){ var t=panelLinkTargets[+b.getAttribute('data-link')]; if(t) openPanel(t); }
+  });
 
   // actions dialog wiring
   document.getElementById('dlgClose').addEventListener('click', closeDialog);
diff --git a/ts/docs/overview/action-browser.json b/ts/docs/overview/action-browser.json
index eeaa43b177..610d257c1e 100644
--- a/ts/docs/overview/action-browser.json
+++ b/ts/docs/overview/action-browser.json
@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-07-17T18:06:54.320Z",
+  "generatedAt": "2026-07-29T14:39:02.927Z",
   "agents": [
     {
       "name": "browser",
@@ -1114,6 +1114,64 @@
               "parameters": [],
               "phrasings": []
             },
+            {
+              "actionName": "launchCopilotChat",
+              "description": "Launch a new chat window with GitHub Copilot, Claude, or other chat providers This creates a new chat session in the specified location.",
+              "parameters": [
+                {
+                  "name": "query",
+                  "type": "string",
+                  "optional": true,
+                  "description": "Optional initial query/prompt to send to the chat"
+                },
+                {
+                  "name": "provider",
+                  "type": "\"copilot\" | \"claude\" | \"gpt\" | \"generic\"",
+                  "optional": true,
+                  "description": "Chat provider: \"copilot\" (GitHub Copilot, default), \"claude\" (Claude/Anthropic), \"gpt\" (ChatGPT/OpenAI), or \"generic\" for any available chat extension"
+                },
+                {
+                  "name": "newSessionLocation",
+                  "type": "\"window\" | \"editor\" | \"view\"",
+                  "optional": true,
+                  "description": "Where to open the new session: \"window\" (new chat window, default), \"editor\" (new chat editor in editor area), or \"view\" (chat panel/side view)"
+                },
+                {
+                  "name": "mode",
+                  "type": "\"agent\" | \"ask\"",
+                  "optional": true,
+                  "description": "Copilot chat mode: \"agent\" (can edit workspace) or \"ask\" (conversational only) Note: not all providers support all modes"
+                },
+                {
+                  "name": "isPartialQuery",
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether to pre-fill but not auto-submit the query"
+                },
+                {
+                  "name": "attachScreenshot",
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether to attach a screenshot of focused VS Code window"
+                },
+                {
+                  "name": "attachFiles",
+                  "type": "string[]",
+                  "optional": true,
+                  "description": "Absolute paths to files to attach to the chat request"
+                }
+              ],
+              "phrasings": [
+                "'editor'",
+                "'view'",
+                "'window'",
+                "'create' 'chat'",
+                "'chat'",
+                "'chatgpt'",
+                "'claude'",
+                "'copilot'"
+              ]
+            },
             {
               "actionName": "launchVSCode",
               "description": "Launch or Start VSCode",
@@ -5149,7 +5207,7 @@
           "actions": [
             {
               "actionName": "clarifyMissingParameter",
-              "description": "The user request is for an action, but some of the parameter is not specified or cannot be infer from the context. Ask the user for clarification for the missing parameter of an known action. Don't clarify unknown action.",
+              "description": "The user request is for a known action, but a required parameter is missing entirely: the user gave no value for it, and no pronoun, reference, or memory points at one. Ask the user to supply the missing parameter. Don't clarify \"unknown\" action. If the value IS referred to but can't be resolved (e.g. \"the one we talked about\", \"it\", \"that file\", \"the one from before\"), use ClarifyUnresolvedReference instead.",
               "parameters": [
                 {
                   "name": "request",
@@ -5230,7 +5288,7 @@
             },
             {
               "actionName": "clarifyUnresolvedReference",
-              "description": "The user request is for an action, but parameters are referring to unresolved pronouns or references that is not found in the request or recent chat context.",
+              "description": "The user request is for a known action and does not refer to the parameter's value directly, but rather through a pronoun, reference, or memory that can't be resolved directly from the request or chat history (e.g. \"from the movie we talked about yesterday\", \"print that file\", \"it\"). Ask the user what the reference points to.",
               "parameters": [
                 {
                   "name": "request",
@@ -5329,6 +5387,12 @@
                   "optional": false,
                   "description": "The original user request"
                 },
+                {
+                  "name": "reason",
+                  "type": "string",
+                  "optional": true,
+                  "description": "Why this request needs multi-step reasoning instead of a single known action. Name the action(s) or schema that came closest and say what made a direct translation insufficient. Be specific: this is used to find gaps in the action schemas."
+                },
                 {
                   "name": "attemptedAction",
                   "type": "string",
@@ -6016,7 +6080,7 @@
                   "name": "repo",
                   "type": "string",
                   "optional": true,
-                  "description": ""
+                  "description": "owner/repo. Omitting this defaults to the current repository."
                 },
                 {
                   "name": "state",
@@ -6337,6 +6401,37 @@
               ],
               "phrasings": []
             },
+            {
+              "actionName": "prMergedStatus",
+              "description": "Check whether a branch has already been merged into a base branch. Example: User: did dev/robgruen/dogfooding7 get merged into main? Agent: { actionName: \"prMergedStatus\", parameters: { branch: \"dev/robgruen/dogfooding7\", base: \"main\" } }",
+              "parameters": [
+                {
+                  "name": "branch",
+                  "type": "string",
+                  "optional": false,
+                  "description": "Source branch to check (PR head branch)."
+                },
+                {
+                  "name": "base",
+                  "type": "string",
+                  "optional": true,
+                  "description": "Target base branch. Defaults to \"main\" when omitted."
+                },
+                {
+                  "name": "repo",
+                  "type": "string",
+                  "optional": true,
+                  "description": "OWNER/REPO slug (e.g. \"microsoft/TypeAgent\"). Omit to use current repo."
+                },
+                {
+                  "name": "limit",
+                  "type": "number",
+                  "optional": true,
+                  "description": "Maximum number of merged PR matches to inspect."
+                }
+              ],
+              "phrasings": []
+            },
             {
               "actionName": "projectCreate",
               "description": "",
@@ -7050,6 +7145,15 @@
               ],
               "phrasings": []
             },
+            {
+              "actionName": "listLists",
+              "description": "use this action to show the user which lists exist, for example, \"what lists are there?\", \"show me my lists\", \"what lists do I have?\"",
+              "parameters": [],
+              "phrasings": [
+                "what lists",
+                "list lists"
+              ]
+            },
             {
               "actionName": "removeItems",
               "description": "remove one or more items from a list",
@@ -8566,7 +8670,7 @@
       "schemas": [
         {
           "schemaName": "player",
-          "description": "Music Player agent that lets you search for, play and control music.",
+          "description": "Music Player agent to play and control music. Use it to play, start, put on, queue, or listen to a specific song, artist, album, genre, or playlist (named or described by mood, e.g. 'chill music for studying'); control playback (pause, resume, skip/next, previous, shuffle, repeat, volume); choose the playback device; and browse, search, or manage playlists and favorites.",
           "defaultEnabled": true,
           "transient": false,
           "actions": [
@@ -8827,7 +8931,7 @@
             },
             {
               "actionName": "previous",
-              "description": "previous track User: play the last song again",
+              "description": "previous track",
               "parameters": [],
               "phrasings": []
             },
@@ -9200,6 +9304,35 @@
         }
       ]
     },
+    {
+      "name": "selfhelp",
+      "category": "Other",
+      "emoji": "💡",
+      "description": "Help agent that answers questions about TypeAgent itself: what it is, how it works, how to set up and use its agents, commands, and features.",
+      "schemas": [
+        {
+          "schemaName": "selfhelp",
+          "description": "Answers questions the user is asking ABOUT the TypeAgent system they are using: what TypeAgent is, how it works, what its agents/commands/features do, how to install or configure something (e.g. the browser extension, internet lookup modes, enabling an agent), how to accomplish a task within TypeAgent, and why a TypeAgent feature is behaving a certain way. Use ONLY for meta questions about the TypeAgent product/app itself. Do NOT use for general-knowledge questions, web lookups, or performing a task in another domain such as playing music, sending email, editing code, or controlling a browser.",
+          "defaultEnabled": true,
+          "transient": false,
+          "actions": [
+            {
+              "actionName": "answerTypeAgentQuestion",
+              "description": "Answer a question the user is asking about TypeAgent itself - what it is, how it works, how to set up or use one of its agents/commands/features, or why a TypeAgent feature is behaving a certain way. Only use this for questions about the TypeAgent product; not for general knowledge or for performing a task in another domain.",
+              "parameters": [
+                {
+                  "name": "question",
+                  "type": "string",
+                  "optional": false,
+                  "description": "The user's original question about TypeAgent, verbatim."
+                }
+              ],
+              "phrasings": []
+            }
+          ]
+        }
+      ]
+    },
     {
       "name": "settings",
       "category": "System & Devices",
@@ -9566,7 +9699,7 @@
             },
             {
               "actionName": "listRules",
-              "description": "",
+              "description": "Lists the active grammar rules for the supplied agent.",
               "parameters": [
                 {
                   "name": "agentName",
@@ -10675,128 +10808,1012 @@
       ]
     }
   ],
-  "systemCommands": [
+  "commands": [
     {
-      "path": "action",
-      "description": "Execute an action",
+      "host": "browser",
+      "path": "actions",
+      "description": "Manage page actions (match, record, infer, author)",
+      "group": true,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "actions infer",
+      "description": "Analyze page and infer new actions that can be automated",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "actions match",
+      "description": "Discover available actions on the current web page",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "actions record",
+      "description": "Record a new browser action by capturing user interactions",
       "group": false,
       "args": [
         {
-          "name": "schemaName",
+          "name": "name",
           "type": "string",
           "optional": false,
-          "description": "Action schema name"
-        },
+          "description": "Name for the action to record"
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "actions stop",
+      "description": "Stop operations",
+      "group": true,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "actions stop recording",
+      "description": "Stop recording and create a WebFlow",
+      "group": false,
+      "args": [
         {
-          "name": "actionName",
+          "name": "description",
           "type": "string",
-          "optional": false,
-          "description": "Action name"
+          "optional": true,
+          "description": "Description of what the recorded action does"
         }
       ],
-      "flags": [
-        {
-          "name": "parameters",
-          "char": "",
-          "type": "json",
-          "default": "",
-          "description": "Action parameter"
-        },
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "ask",
+      "description": "Ask a question about the current web page using extracted knowledge",
+      "group": false,
+      "args": [
         {
-          "name": "naturalLanguage",
-          "char": "",
+          "name": "question",
           "type": "string",
-          "default": "",
-          "description": "Natural language phrase to associate with this action for cache population"
+          "optional": false,
+          "description": "Question to ask about the page"
         }
-      ]
+      ],
+      "flags": []
     },
     {
-      "path": "clear",
-      "description": "Clear the console",
+      "host": "browser",
+      "path": "auto",
+      "description": "Run the browser automation",
       "group": true,
       "args": [],
       "flags": []
     },
     {
-      "path": "clear deep",
-      "description": "Clear the console and wipe chat history, reasoning, activity, and persistent display log so nothing replays on rejoin",
+      "host": "browser",
+      "path": "auto close",
+      "description": "Close the new Web Content view",
       "group": false,
       "args": [],
       "flags": []
     },
     {
-      "path": "collision",
-      "description": "Inspect collision detection telemetry and run static collision analyses",
+      "host": "browser",
+      "path": "auto launch",
+      "description": "Launch a browser session",
       "group": true,
       "args": [],
       "flags": []
     },
     {
-      "path": "collision corpus",
-      "description": "Generate phrase corpora, probe through the embedding ranker, and build the collision-hotspot visualizations",
+      "host": "browser",
+      "path": "auto launch hidden",
+      "description": "Open a hidden/headless browser instance",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "auto launch standalone",
+      "description": "Open a standalone browser instance",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "close",
+      "description": "Close the new Web Content view",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "external",
+      "description": "Toggle external browser control",
       "group": true,
       "args": [],
       "flags": []
     },
     {
-      "path": "collision corpus generate",
-      "description": "Generate an LLM-authored phrase corpus for every action in this dispatcher's loaded schemas (slow: ~12 min for the full set)",
+      "host": "browser",
+      "path": "external off",
+      "description": "Disable external browser control",
       "group": false,
       "args": [],
-      "flags": [
-        {
-          "name": "schemas",
-          "char": "",
-          "type": "string",
-          "default": "",
-          "description": "Comma-separated schemas to scan. Empty = all loaded schemas."
-        },
-        {
-          "name": "models",
-          "char": "",
-          "type": "string",
-          "default": "",
-          "description": "Comma-separated chat-model names from ts/.env. Default: GPT_4_1,GPT_5,GPT_5_NANO"
-        },
-        {
-          "name": "styles",
-          "char": "",
-          "type": "string",
-          "default": "",
-          "description": "Comma-separated phrase styles to generate. Available: imperative,conversational,casual,polite,curt,slang,typos. Default: imperative,conversational,casual."
-        },
-        {
-          "name": "concurrency",
-          "char": "",
-          "type": "number",
-          "default": "8",
-          "description": "Concurrent LLM calls (default 8)"
-        },
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "external on",
+      "description": "Enable external browser control",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "extractKnowledge",
+      "description": "Extract knowledge from the current web page",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "learn",
+      "description": "Learn a new action by demonstrating or describing it",
+      "group": false,
+      "args": [
         {
-          "name": "out",
-          "char": "",
+          "name": "goal",
           "type": "string",
-          "default": "",
-          "description": "Output corpus JSON file path (file name, not directory — use --workdir to choose the directory). Default: <instanceDir>/collisions/corpus.json"
-        },
+          "optional": false,
+          "description": "The goal to accomplish (what the action should do)"
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "lookup",
+      "description": "Configure how internet lookups are answered (browser vs Azure AI Search)",
+      "group": true,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "lookup mode",
+      "description": "Set the internet lookup mode: off (browser), api, or mcp",
+      "group": false,
+      "args": [
         {
-          "name": "workdir",
-          "char": "",
+          "name": "mode",
           "type": "string",
-          "default": "",
-          "description": "Directory for default-named output files. Default: <instanceDir>/collisions"
+          "optional": false,
+          "description": "off | api | mcp"
         }
-      ]
+      ],
+      "flags": []
     },
     {
-      "path": "collision corpus probe",
-      "description": "Replay a phrase corpus through the embedding ranker and classify each phrase as CLEAN / TIGHT / MISROUTE",
+      "host": "browser",
+      "path": "lookup status",
+      "description": "Show the current internet lookup mode",
       "group": false,
       "args": [],
-      "flags": [
-        {
-          "name": "in",
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "open",
+      "description": "Show a new Web Content view",
+      "group": false,
+      "args": [
+        {
+          "name": "site",
+          "type": "string",
+          "optional": false,
+          "description": "Alias or URL for the site of the open."
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "resolver",
+      "description": "Toggle URL resolver methods",
+      "group": true,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "resolver history",
+      "description": "Toggle history resolver",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "resolver keyword",
+      "description": "Toggle keyword resolver",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "resolver list",
+      "description": "List all available URL resolvers",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "search",
+      "description": "List search providers",
+      "group": true,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "search add",
+      "description": "Adds a new search provider",
+      "group": false,
+      "args": [
+        {
+          "name": "provider",
+          "type": "string",
+          "optional": false,
+          "description": "The name of the search provider to add."
+        },
+        {
+          "name": "url",
+          "type": "string",
+          "optional": false,
+          "description": "The URL of the search provider to add. '%s' will be replaced with the search parameter."
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "search import",
+      "description": "Imports the search providers from the specified browser",
+      "group": false,
+      "args": [
+        {
+          "name": "browser",
+          "type": "string",
+          "optional": false,
+          "description": "The name of the browser to import search providers from: [Edge | Chrome]."
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "search list",
+      "description": "Lists browser agent search providers",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "search remove",
+      "description": "Removes the selected search provider",
+      "group": false,
+      "args": [
+        {
+          "name": "provider",
+          "type": "string",
+          "optional": false,
+          "description": "The name of the search provider to remove."
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "search set",
+      "description": "Sets the active search provider",
+      "group": false,
+      "args": [
+        {
+          "name": "provider",
+          "type": "string",
+          "optional": false,
+          "description": "The name of the search provider to set as active."
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "browser",
+      "path": "search show",
+      "description": "Shows the details of the selected search provider",
+      "group": false,
+      "args": [
+        {
+          "name": "provider",
+          "type": "string",
+          "optional": false,
+          "description": "The name of the search provider to show details for."
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "calendar",
+      "path": "google-auth",
+      "description": "Complete Google Calendar OAuth flow with authorization code",
+      "group": false,
+      "args": [
+        {
+          "name": "code",
+          "type": "string",
+          "optional": false,
+          "description": "Authorization code from Google OAuth redirect"
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "calendar",
+      "path": "login",
+      "description": "Log into calendar service",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "calendar",
+      "path": "logout",
+      "description": "Log out of calendar service",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "dispatcher",
+      "path": "explain",
+      "description": "Explain a translated request with action",
+      "group": false,
+      "args": [
+        {
+          "name": "requestAction",
+          "type": "string",
+          "optional": false,
+          "description": "Request to explain"
+        }
+      ],
+      "flags": [
+        {
+          "name": "repeat",
+          "char": "",
+          "type": "string",
+          "default": "1",
+          "description": "Number of times to repeat the explanation"
+        },
+        {
+          "name": "filterValueInRequest",
+          "char": "",
+          "type": "string",
+          "default": "false",
+          "description": "Filter reference value for the explanation"
+        },
+        {
+          "name": "filterReference",
+          "char": "",
+          "type": "string",
+          "default": "false",
+          "description": "Filter reference words"
+        },
+        {
+          "name": "concurrency",
+          "char": "",
+          "type": "string",
+          "default": "5",
+          "description": "Number of concurrent requests"
+        }
+      ]
+    },
+    {
+      "host": "dispatcher",
+      "path": "match",
+      "description": "Match a request",
+      "group": false,
+      "args": [
+        {
+          "name": "request",
+          "type": "string",
+          "optional": false,
+          "description": "Request to match"
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "dispatcher",
+      "path": "reason",
+      "description": "Reason about a request",
+      "group": false,
+      "args": [
+        {
+          "name": "request",
+          "type": "string",
+          "optional": false,
+          "description": "Request to reason about"
+        }
+      ],
+      "flags": [
+        {
+          "name": "engine",
+          "char": "",
+          "type": "string",
+          "default": "",
+          "description": "Reasoning engine to use: claude, copilot, or none"
+        }
+      ]
+    },
+    {
+      "host": "dispatcher",
+      "path": "reasoning",
+      "description": "Reason about a request",
+      "group": false,
+      "args": [
+        {
+          "name": "request",
+          "type": "string",
+          "optional": false,
+          "description": "Request to reason about"
+        }
+      ],
+      "flags": [
+        {
+          "name": "engine",
+          "char": "",
+          "type": "string",
+          "default": "",
+          "description": "Reasoning engine to use: claude, copilot, or none"
+        }
+      ]
+    },
+    {
+      "host": "dispatcher",
+      "path": "request",
+      "description": "Translate and explain a request",
+      "group": false,
+      "args": [
+        {
+          "name": "request",
+          "type": "string",
+          "optional": true,
+          "description": "Request to translate"
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "dispatcher",
+      "path": "translate",
+      "description": "Translate a request",
+      "group": false,
+      "args": [
+        {
+          "name": "request",
+          "type": "string",
+          "optional": false,
+          "description": "Request to translate"
+        }
+      ],
+      "flags": [
+        {
+          "name": "history",
+          "char": "",
+          "type": "string",
+          "default": "false",
+          "description": "Use history in translation"
+        }
+      ]
+    },
+    {
+      "host": "email",
+      "path": "google-auth",
+      "description": "Complete Google Gmail OAuth flow with authorization code",
+      "group": false,
+      "args": [
+        {
+          "name": "code",
+          "type": "string",
+          "optional": false,
+          "description": "Authorization code from Google OAuth redirect"
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "email",
+      "path": "index",
+      "description": "Build keyword index from inbox emails for fast search",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "email",
+      "path": "login",
+      "description": "Log into email service",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "email",
+      "path": "logout",
+      "description": "Log out of email service",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "localPlayer",
+      "path": "clear",
+      "description": "Clear playback queue",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "localPlayer",
+      "path": "folder",
+      "description": "Show current music folder",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "localPlayer",
+      "path": "list",
+      "description": "List audio files in music folder",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "localPlayer",
+      "path": "mute",
+      "description": "Toggle mute",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "localPlayer",
+      "path": "next",
+      "description": "Play next track",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "localPlayer",
+      "path": "pause",
+      "description": "Pause playback",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "localPlayer",
+      "path": "play",
+      "description": "Play an audio file or resume playback",
+      "group": false,
+      "args": [
+        {
+          "name": "file",
+          "type": "string",
+          "optional": true,
+          "description": "File name or path to play (optional - plays first file if not specified)"
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "localPlayer",
+      "path": "prev",
+      "description": "Play previous track",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "localPlayer",
+      "path": "queue",
+      "description": "Show playback queue",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "localPlayer",
+      "path": "resume",
+      "description": "Resume playback",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "localPlayer",
+      "path": "setfolder",
+      "description": "Set the music folder path",
+      "group": false,
+      "args": [
+        {
+          "name": "path",
+          "type": "string",
+          "optional": false,
+          "description": "Path to the music folder"
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "localPlayer",
+      "path": "shuffle",
+      "description": "Toggle shuffle mode",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "localPlayer",
+      "path": "status",
+      "description": "Show local player status",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "localPlayer",
+      "path": "stop",
+      "description": "Stop playback",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "localPlayer",
+      "path": "volume",
+      "description": "Set volume level (0-100)",
+      "group": false,
+      "args": [
+        {
+          "name": "level",
+          "type": "string",
+          "optional": false,
+          "description": "Volume level (0-100)"
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "osNotifications",
+      "path": "sync",
+      "description": "Re-emit currently-present OS notifications through the agent pipeline. Windows only — Linux/macOS do not expose existing notifications.",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "osNotifications",
+      "path": "test",
+      "description": "Inject a synthetic notification through the agent pipeline (filters, rate limit, dismiss tracking) — useful for verifying the agent end-to-end without an OS notification source.",
+      "group": false,
+      "args": [
+        {
+          "name": "message",
+          "type": "string",
+          "optional": true,
+          "description": "Notification body text (defaults to 'Hello World!')"
+        }
+      ],
+      "flags": [
+        {
+          "name": "app",
+          "char": "",
+          "type": "string",
+          "default": "test",
+          "description": "App name to attach to the synthetic notification (matched against allowList/blockList)"
+        },
+        {
+          "name": "title",
+          "char": "",
+          "type": "string",
+          "default": "Test",
+          "description": "Notification title (defaults to 'Test')"
+        }
+      ]
+    },
+    {
+      "host": "player",
+      "path": "spotify",
+      "description": "Configure spotify integration",
+      "group": true,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "player",
+      "path": "spotify load",
+      "description": "Load spotify user data",
+      "group": false,
+      "args": [
+        {
+          "name": "file",
+          "type": "string",
+          "optional": false,
+          "description": "File to load"
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "player",
+      "path": "spotify login",
+      "description": "Login to Spotify",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "player",
+      "path": "spotify logout",
+      "description": "Logout from Spotify",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "powershell",
+      "path": "delete",
+      "description": "Delete a PowerShell flow by name",
+      "group": false,
+      "args": [
+        {
+          "name": "name",
+          "type": "string",
+          "optional": false,
+          "description": "Name of the PowerShell flow to delete"
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "powershell",
+      "path": "import",
+      "description": "Import a PowerShell script as a reusable PowerShell flow",
+      "group": false,
+      "args": [
+        {
+          "name": "filePath",
+          "type": "string",
+          "optional": false,
+          "description": "Path to the .ps1 file to import"
+        }
+      ],
+      "flags": [
+        {
+          "name": "actionName",
+          "char": "",
+          "type": "string",
+          "default": "",
+          "description": "Override the generated action name"
+        }
+      ]
+    },
+    {
+      "host": "powershell",
+      "path": "list",
+      "description": "List all registered PowerShell flows",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "powershell",
+      "path": "run",
+      "description": "Execute a PowerShell flow by name",
+      "group": false,
+      "args": [
+        {
+          "name": "flowName",
+          "type": "string",
+          "optional": false,
+          "description": "Name of the PowerShell flow to execute"
+        }
+      ],
+      "flags": [
+        {
+          "name": "flowParametersJson",
+          "char": "",
+          "type": "string",
+          "default": "",
+          "description": "JSON string of parameters, e.g. '{\"path\":\"C:\\\\Users\"}'"
+        }
+      ]
+    },
+    {
+      "host": "powershell",
+      "path": "show",
+      "description": "Show details of a PowerShell flow",
+      "group": false,
+      "args": [
+        {
+          "name": "flowName",
+          "type": "string",
+          "optional": false,
+          "description": "Name of the PowerShell flow to show"
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "selfhelp",
+      "path": "ask",
+      "description": "Ask a question about TypeAgent (what it is, how it works, how to set it up).",
+      "group": false,
+      "args": [
+        {
+          "name": "question",
+          "type": "string",
+          "optional": false,
+          "description": "Your question about TypeAgent."
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "system",
+      "path": "action",
+      "description": "Execute an action",
+      "group": false,
+      "args": [
+        {
+          "name": "schemaName",
+          "type": "string",
+          "optional": false,
+          "description": "Action schema name"
+        },
+        {
+          "name": "actionName",
+          "type": "string",
+          "optional": false,
+          "description": "Action name"
+        }
+      ],
+      "flags": [
+        {
+          "name": "parameters",
+          "char": "",
+          "type": "json",
+          "default": "",
+          "description": "Action parameter"
+        },
+        {
+          "name": "naturalLanguage",
+          "char": "",
+          "type": "string",
+          "default": "",
+          "description": "Natural language phrase to associate with this action for cache population"
+        }
+      ]
+    },
+    {
+      "host": "system",
+      "path": "clear",
+      "description": "Clear the console",
+      "group": true,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "system",
+      "path": "clear deep",
+      "description": "Clear the console and wipe chat history, reasoning, activity, and persistent display log so nothing replays on rejoin",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "system",
+      "path": "collision",
+      "description": "Inspect collision detection telemetry and run static collision analyses",
+      "group": true,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "system",
+      "path": "collision corpus",
+      "description": "Generate phrase corpora, probe through the embedding ranker, and build the collision-hotspot visualizations",
+      "group": true,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "system",
+      "path": "collision corpus generate",
+      "description": "Generate an LLM-authored phrase corpus for every action in this dispatcher's loaded schemas (slow: ~12 min for the full set)",
+      "group": false,
+      "args": [],
+      "flags": [
+        {
+          "name": "schemas",
+          "char": "",
+          "type": "string",
+          "default": "",
+          "description": "Comma-separated schemas to scan. Empty = all loaded schemas."
+        },
+        {
+          "name": "models",
+          "char": "",
+          "type": "string",
+          "default": "",
+          "description": "Comma-separated chat-model names from ts/.env. Default: GPT_4_1,GPT_5,GPT_5_NANO"
+        },
+        {
+          "name": "styles",
+          "char": "",
+          "type": "string",
+          "default": "",
+          "description": "Comma-separated phrase styles to generate. Available: imperative,conversational,casual,polite,curt,slang,typos. Default: imperative,conversational,casual."
+        },
+        {
+          "name": "concurrency",
+          "char": "",
+          "type": "number",
+          "default": "8",
+          "description": "Concurrent LLM calls (default 8)"
+        },
+        {
+          "name": "out",
+          "char": "",
+          "type": "string",
+          "default": "",
+          "description": "Output corpus JSON file path (file name, not directory — use --workdir to choose the directory). Default: <instanceDir>/collisions/corpus.json"
+        },
+        {
+          "name": "workdir",
+          "char": "",
+          "type": "string",
+          "default": "",
+          "description": "Directory for default-named output files. Default: <instanceDir>/collisions"
+        }
+      ]
+    },
+    {
+      "host": "system",
+      "path": "collision corpus probe",
+      "description": "Replay a phrase corpus through the embedding ranker and classify each phrase as CLEAN / TIGHT / MISROUTE",
+      "group": false,
+      "args": [],
+      "flags": [
+        {
+          "name": "in",
           "char": "",
           "type": "string",
           "default": "",
@@ -10840,6 +11857,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "collision corpus reanalyze",
       "description": "Re-classify saved probe results with prefix-aware action matching (recovers misroutes that were just naming differences)",
       "group": false,
@@ -10876,6 +11894,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "collision corpus recovery",
       "description": "Decompose MISROUTE results by where the correct target ranks among the top-K candidates (which fix lever applies?)",
       "group": false,
@@ -10905,6 +11924,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "collision corpus run",
       "description": "Run the full corpus pipeline (generate → probe → reanalyze → visualize) with consistent file naming",
       "group": false,
@@ -10976,6 +11996,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "collision corpus translate",
       "description": "Replay a phrase corpus through the LLM translator (cache/grammar/exec/fuzzy off) and classify each phrase as CLEAN / MISROUTE / CLARIFY / INVALID / ERROR. Distinct from 'corpus probe' — that one runs the embedding ranker; this runs the actual translator.",
       "group": false,
@@ -11054,6 +12075,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "collision corpus visualize",
       "description": "Build an interactive HTML visualization of misroute hotspots from reclassified probe results, overlaid with a cross-schema similarity scan",
       "group": false,
@@ -11125,6 +12147,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "collision corpus visualize-recovery",
       "description": "Build an interactive HTML visualization of recovery-rank analysis (which fix lever applies, per action and per agent)",
       "group": false,
@@ -11161,6 +12184,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "collision events",
       "description": "Show recent collision events captured in the current session's ring buffer",
       "group": false,
@@ -11183,6 +12207,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "collision keywords",
       "description": "Inspect/tune contextSelector keyword vectors, or backfill the committed keyword files.",
       "group": true,
@@ -11197,6 +12222,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "collision keywords backfill",
       "description": "Backfill/refresh committed keyword files for agent actions. Lexical by default; --llm uses the preferred LLM distillation pass.",
       "group": false,
@@ -11226,6 +12252,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "collision list-strategies",
       "description": "List the named strategies available for `@collision similar -s <name>`",
       "group": false,
@@ -11233,6 +12260,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "collision neighborhoods",
       "description": "Build neighborhoods directly from translator misroute edges and write a persisted JSON index plus an HTML viz.",
       "group": false,
@@ -11290,6 +12318,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "collision optimize",
       "description": "Optimize translator-collision neighborhoods: propose verified schema/manifest fixes, accumulate cross-run evidence about which lever and mechanism work for which collision class.",
       "group": true,
@@ -11297,6 +12326,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "collision optimize browse",
       "description": "Generate browse.html for one or more optimization-run-* directories. Walks the run, writes a sortable case index plus a self-contained case.html per case showing every attempt with before/after diffs.",
       "group": false,
@@ -11326,6 +12356,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "collision optimize distill",
       "description": "Distill winning attempts in patterns.jsonl into candidate schemaGuidelines additions. Groups winners by (mechanism, guidelineHook), calls the LLM with the current schemaGuidelines as context, writes schemaGuidelines.candidates.md for operator review.",
       "group": false,
@@ -11348,6 +12379,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "collision optimize explore",
       "description": "Run the optimize loop on the top-N collision neighborhoods. Writes an attempts archive under <workdir>/optimization-run-<ts>/.",
       "group": false,
@@ -11426,6 +12458,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "collision optimize list-levers",
       "description": "List all registered optimization levers with their description, consumes, and probeType.",
       "group": false,
@@ -11433,6 +12466,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "collision optimize patterns",
       "description": "Mine patterns.jsonl across all accumulated optimize runs. Emits patterns.{json,html} with three groupings (mechanism × pattern, per-lever, lever-effectiveness) plus classifier agreement.",
       "group": false,
@@ -11483,6 +12517,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "collision optimize run",
       "description": "Run the full optimize pipeline (neighborhoods → explore → validate → patterns → distill) with --from gating. Each step's predecessor must exist before it runs.",
       "group": false,
@@ -11554,6 +12589,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "collision optimize validate",
       "description": "Stack all winners from an optimization run and re-probe the full baseline corpus. Emits optimization-impact.{json,html} with cross-neighborhood regression flags.",
       "group": false,
@@ -11604,6 +12640,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "collision preferences",
       "description": "Inspect and edit Tier-1 collision preferences (used by the preference-clarify strategy)",
       "group": true,
@@ -11611,6 +12648,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "collision preferences clear",
       "description": "Remove every stored collision preference",
       "group": false,
@@ -11618,6 +12656,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "collision preferences list",
       "description": "List stored collision preferences (Tier-1)",
       "group": false,
@@ -11625,6 +12664,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "collision preferences remove",
       "description": "Remove a stored collision preference by key (see `@collision preferences list`)",
       "group": false,
@@ -11639,6 +12679,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "collision preferences set",
       "description": "Set an explicit collision preference: among a candidate set, always pick the chosen option",
       "group": false,
@@ -11659,6 +12700,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "collision probe",
       "description": "Probe what action(s) a hand-crafted utterance would route to via the embedding ranker (top-K with cosine deltas)",
       "group": false,
@@ -11702,6 +12744,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "collision similar",
       "description": "Find semantically similar actions across agents (multi-vector embedding similarity, clusters by default)",
       "group": false,
@@ -11759,6 +12802,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "config",
       "description": "Configuration commands",
       "group": true,
@@ -11766,6 +12810,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config action",
       "description": "Toggle agent actions",
       "group": false,
@@ -11802,6 +12847,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "config agent",
       "description": "Manage agents (enable/disable, setup, refresh)",
       "group": true,
@@ -11838,6 +12884,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "config agent refresh",
       "description": "Re-check an agent's readiness state (or all agents)",
       "group": false,
@@ -11852,6 +12899,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config agent setup",
       "description": "Run setup for an agent that needs configuration before use",
       "group": false,
@@ -11866,6 +12914,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config cache",
       "description": "Configure cache behavior",
       "group": true,
@@ -11873,6 +12922,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config cache grammarSystem",
       "description": "Set grammar system (completionBased or nfa)",
       "group": false,
@@ -11887,6 +12937,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config cache useDFA",
       "description": "Enable or disable DFA matching within the NFA grammar system (faster; requires grammarSystem=nfa)",
       "group": false,
@@ -11901,6 +12952,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision",
       "description": "Configure action collision detection",
       "group": true,
@@ -11908,6 +12960,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision contextSelector",
       "description": "Configure the context-weighted resolution tier (deterministic topical tiebreaker on the grammar path)",
       "group": true,
@@ -11915,6 +12968,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision contextSelector decay",
       "description": "Get/set contextSelector decay (per-turn recency decay lambda (0 < lambda <= 1))",
       "group": false,
@@ -11929,6 +12983,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision contextSelector detect",
       "description": "Toggle context-weighted resolution (contextSelector)",
       "group": true,
@@ -11936,6 +12991,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision contextSelector detect off",
       "description": "Turn off context-weighted resolution (contextSelector)",
       "group": false,
@@ -11943,6 +12999,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision contextSelector detect on",
       "description": "Turn on context-weighted resolution (contextSelector)",
       "group": false,
@@ -11950,6 +13007,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision contextSelector margin",
       "description": "Get/set contextSelector margin (clear-winner margin the winner must beat the runner-up by)",
       "group": false,
@@ -11964,6 +13022,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision contextSelector minMass",
       "description": "Get/set contextSelector minMass (evidence gate: min winner matched mass)",
       "group": false,
@@ -11978,6 +13037,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision contextSelector minUniqueTokens",
       "description": "Get/set contextSelector minUniqueTokens (evidence gate: min distinct distinguishing tokens the winner must match)",
       "group": false,
@@ -11992,6 +13052,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision contextSelector windowTurns",
       "description": "Get/set contextSelector windowTurns (ring-buffer look-back N over recent user turns)",
       "group": false,
@@ -12006,6 +13067,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision fuzzy",
       "description": "Configure fuzzy collision detection",
       "group": true,
@@ -12013,6 +13075,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision fuzzy detect",
       "description": "Toggle fuzzy collision detection",
       "group": true,
@@ -12020,6 +13083,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision fuzzy detect off",
       "description": "Turn off fuzzy collision detection",
       "group": false,
@@ -12027,6 +13091,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision fuzzy detect on",
       "description": "Turn on fuzzy collision detection",
       "group": false,
@@ -12034,6 +13099,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision fuzzy strategy",
       "description": "Set fuzzy resolution strategy (one of: first-match, score-rank, priority, user-clarify, preference-clarify)",
       "group": false,
@@ -12048,6 +13114,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision grammarMatch",
       "description": "Configure grammarMatch collision detection",
       "group": true,
@@ -12055,6 +13122,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision grammarMatch detect",
       "description": "Toggle grammarMatch collision detection",
       "group": true,
@@ -12062,6 +13130,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision grammarMatch detect off",
       "description": "Turn off grammarMatch collision detection",
       "group": false,
@@ -12069,6 +13138,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision grammarMatch detect on",
       "description": "Turn on grammarMatch collision detection",
       "group": false,
@@ -12076,6 +13146,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision grammarMatch strategy",
       "description": "Set grammarMatch resolution strategy (one of: first-match, score-rank, priority, user-clarify, preference-clarify)",
       "group": false,
@@ -12090,6 +13161,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision llmSelect",
       "description": "Configure llmSelect collision detection",
       "group": true,
@@ -12097,6 +13169,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision llmSelect detect",
       "description": "Toggle llmSelect collision detection",
       "group": true,
@@ -12104,6 +13177,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision llmSelect detect off",
       "description": "Turn off llmSelect collision detection",
       "group": false,
@@ -12111,6 +13185,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision llmSelect detect on",
       "description": "Turn on llmSelect collision detection",
       "group": false,
@@ -12118,6 +13193,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision llmSelect strategy",
       "description": "Set llmSelect resolution strategy (one of: first-match, score-rank, priority, user-clarify, preference-clarify)",
       "group": false,
@@ -12132,6 +13208,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision preference",
       "description": "Configure the preference-clarify strategy (Tier-1 preferences + Tier-2 registry)",
       "group": true,
@@ -12139,6 +13216,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision preference enabled",
       "description": "Toggle preference-clarify resolution",
       "group": true,
@@ -12146,6 +13224,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision preference enabled off",
       "description": "Turn off preference-clarify resolution",
       "group": false,
@@ -12153,6 +13232,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision preference enabled on",
       "description": "Turn on preference-clarify resolution",
       "group": false,
@@ -12160,6 +13240,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision preference registry",
       "description": "Set the filesystem path to the known-ambiguous neighborhoods registry (neighborhoods.json). Empty string clears it.",
       "group": false,
@@ -12174,6 +13255,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision preference registryFirst",
       "description": "Toggle registry-first detection (scan all embedding candidates against the neighborhood registry, independent of the score-delta detector)",
       "group": true,
@@ -12181,6 +13263,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision preference registryFirst off",
       "description": "Turn off registry-first detection (scan all embedding candidates against the neighborhood registry, independent of the score-delta detector)",
       "group": false,
@@ -12188,6 +13271,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision preference registryFirst on",
       "description": "Turn on registry-first detection (scan all embedding candidates against the neighborhood registry, independent of the score-delta detector)",
       "group": false,
@@ -12195,6 +13279,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision preference remember",
       "description": "Set how learned preferences are captured for the `preference-clarify` strategy. Empty argument shows the current value.",
       "group": false,
@@ -12209,6 +13294,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision preference source",
       "description": "Set which ambiguity source feeds the `preference-clarify` strategy. Empty argument shows the current value.",
       "group": false,
@@ -12223,6 +13309,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision priority",
       "description": "Set priorityOrder (comma-separated agent names) used by the `priority` resolution strategy. Empty argument shows the current value.",
       "group": false,
@@ -12237,6 +13324,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision show",
       "description": "Show the current collision detection config",
       "group": false,
@@ -12244,6 +13332,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision static",
       "description": "Configure static collision detection",
       "group": true,
@@ -12251,6 +13340,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision static detect",
       "description": "Toggle static collision detection",
       "group": true,
@@ -12258,6 +13348,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision static detect off",
       "description": "Turn off static collision detection",
       "group": false,
@@ -12265,6 +13356,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision static detect on",
       "description": "Turn on static collision detection",
       "group": false,
@@ -12272,6 +13364,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision static strategy",
       "description": "Set static resolution strategy (one of: warn, error)",
       "group": false,
@@ -12286,6 +13379,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision telemetry",
       "description": "Configure collision telemetry",
       "group": true,
@@ -12293,6 +13387,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision telemetry debugLog",
       "description": "Toggle collision telemetry debug log",
       "group": true,
@@ -12300,6 +13395,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision telemetry debugLog off",
       "description": "Turn off collision telemetry debug log",
       "group": false,
@@ -12307,6 +13403,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision telemetry debugLog on",
       "description": "Turn on collision telemetry debug log",
       "group": false,
@@ -12314,6 +13411,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision telemetry emit",
       "description": "Toggle collision telemetry ring buffer",
       "group": true,
@@ -12321,6 +13419,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision telemetry emit off",
       "description": "Turn off collision telemetry ring buffer",
       "group": false,
@@ -12328,6 +13427,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision telemetry emit on",
       "description": "Turn on collision telemetry ring buffer",
       "group": false,
@@ -12335,6 +13435,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config collision telemetry experimentId",
       "description": "Set the experimentId tag attached to every emitted collision event. Empty string clears it.",
       "group": false,
@@ -12349,6 +13450,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config command",
       "description": "Toggle agent commands",
       "group": false,
@@ -12385,6 +13487,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "config dev",
       "description": "Toggle development mode",
       "group": true,
@@ -12392,6 +13495,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config dev off",
       "description": "Turn off development mode",
       "group": false,
@@ -12399,6 +13503,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config dev on",
       "description": "Turn on development mode (records conversation + translation data)",
       "group": false,
@@ -12414,6 +13519,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "config execution",
       "description": "Execution configuration",
       "group": true,
@@ -12421,6 +13527,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config execution activity",
       "description": "Toggle activity context",
       "group": true,
@@ -12428,6 +13535,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config execution activity off",
       "description": "Turn off activity context",
       "group": false,
@@ -12435,6 +13543,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config execution activity on",
       "description": "Turn on activity context",
       "group": false,
@@ -12442,6 +13551,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config execution conversationAnswer",
       "description": "How conversation questions are answered: 'lookup' (conversation-memory lookup, reasoning as fallback), 'reasoning-first' (reasoning agent primary, lookup as fallback), or 'reasoning-only' (remove the lookup action; reasoning handles conversation Q&A)",
       "group": false,
@@ -12456,6 +13566,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config execution entityPromptShape",
       "description": "Shape used when serializing Entity objects into LLM prompts",
       "group": false,
@@ -12470,6 +13581,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config execution planReuse",
       "description": "Enable or disable workflow plan reuse for reasoning actions",
       "group": false,
@@ -12484,6 +13596,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config execution reasoning",
       "description": "Set reasoning engine",
       "group": false,
@@ -12498,6 +13611,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config execution reasoningEffort",
       "description": "Set the Copilot reasoning effort (low, medium, high, xhigh). Only applies to models that support it. Omit to show the current value.",
       "group": false,
@@ -12512,6 +13626,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config execution reasoningHistory",
       "description": "Number of recent conversation turns included as context in the reasoning prompt",
       "group": false,
@@ -12526,6 +13641,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config execution reasoningModel",
       "description": "Set the Copilot reasoning model (e.g. claude-opus-4.8). Omit to show the current value.",
       "group": false,
@@ -12540,6 +13656,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config execution recordUserMessages",
       "description": "Toggle record the user's own messages in the conversation transcript (chat history)",
       "group": true,
@@ -12547,6 +13664,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config execution recordUserMessages off",
       "description": "Turn off record the user's own messages in the conversation transcript (chat history)",
       "group": false,
@@ -12554,6 +13672,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config execution recordUserMessages on",
       "description": "Turn on record the user's own messages in the conversation transcript (chat history)",
       "group": false,
@@ -12561,6 +13680,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config execution scriptReuse",
       "description": "Enable or disable PowerShell script reuse for reasoning actions",
       "group": false,
@@ -12575,6 +13695,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config execution setupOnFirstUse",
       "description": "Toggle auto-run agent setup on first use (otherwise emit a hint to run @config agent setup)",
       "group": true,
@@ -12582,6 +13703,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config execution setupOnFirstUse off",
       "description": "Turn off auto-run agent setup on first use (otherwise emit a hint to run @config agent setup)",
       "group": false,
@@ -12589,6 +13711,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config execution setupOnFirstUse on",
       "description": "Turn on auto-run agent setup on first use (otherwise emit a hint to run @config agent setup)",
       "group": false,
@@ -12596,6 +13719,31 @@
       "flags": []
     },
     {
+      "host": "system",
+      "path": "config execution subagents",
+      "description": "Toggle allow the reasoning loop to create and manage subagents (each with its own command-executor process)",
+      "group": true,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "system",
+      "path": "config execution subagents off",
+      "description": "Turn off allow the reasoning loop to create and manage subagents (each with its own command-executor process)",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "system",
+      "path": "config execution subagents on",
+      "description": "Turn on allow the reasoning loop to create and manage subagents (each with its own command-executor process)",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "system",
       "path": "config explainer",
       "description": "Explainer configuration",
       "group": true,
@@ -12603,6 +13751,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer async",
       "description": "Toggle asynchronous explanation",
       "group": true,
@@ -12610,6 +13759,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer async off",
       "description": "Turn off asynchronous explanation",
       "group": false,
@@ -12617,6 +13767,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer async on",
       "description": "Turn on asynchronous explanation",
       "group": false,
@@ -12624,6 +13775,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter",
       "description": "Toggle explanation filter",
       "group": true,
@@ -12631,6 +13783,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter multiple",
       "description": "Toggle explanation filter multiple actions",
       "group": true,
@@ -12638,6 +13791,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter multiple off",
       "description": "Turn off explanation filter multiple actions",
       "group": false,
@@ -12645,6 +13799,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter multiple on",
       "description": "Turn on explanation filter multiple actions",
       "group": false,
@@ -12652,6 +13807,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter off",
       "description": "Turn off all explanation filters",
       "group": false,
@@ -12659,6 +13815,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter on",
       "description": "Turn on all explanation filters",
       "group": false,
@@ -12666,6 +13823,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter reference",
       "description": "Toggle reference filter",
       "group": true,
@@ -12673,6 +13831,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter reference list",
       "description": "Toggle explainer filter reference using word lists",
       "group": true,
@@ -12680,6 +13839,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter reference list off",
       "description": "Turn off explainer filter reference using word lists",
       "group": false,
@@ -12687,6 +13847,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter reference list on",
       "description": "Turn on explainer filter reference using word lists",
       "group": false,
@@ -12694,6 +13855,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter reference off",
       "description": "Turn off all explanation reference filters",
       "group": false,
@@ -12701,6 +13863,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter reference on",
       "description": "Turn on all explanation reference filters",
       "group": false,
@@ -12708,6 +13871,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter reference translate",
       "description": "Toggle explainer filter reference by translate without context",
       "group": true,
@@ -12715,6 +13879,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter reference translate off",
       "description": "Turn off explainer filter reference by translate without context",
       "group": false,
@@ -12722,6 +13887,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter reference translate on",
       "description": "Turn on explainer filter reference by translate without context",
       "group": false,
@@ -12729,6 +13895,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter reference value",
       "description": "Toggle explainer filter reference by value in the request",
       "group": true,
@@ -12736,6 +13903,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter reference value off",
       "description": "Turn off explainer filter reference by value in the request",
       "group": false,
@@ -12743,6 +13911,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer filter reference value on",
       "description": "Turn on explainer filter reference by value in the request",
       "group": false,
@@ -12750,6 +13919,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer model",
       "description": "Set model",
       "group": false,
@@ -12772,6 +13942,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "config explainer name",
       "description": "Set explainer",
       "group": false,
@@ -12786,6 +13957,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer off",
       "description": "Turn off explanation",
       "group": false,
@@ -12793,6 +13965,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config explainer on",
       "description": "Turn on explanation",
       "group": false,
@@ -12800,6 +13973,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config log",
       "description": "Toggle logging",
       "group": true,
@@ -12807,6 +13981,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config log db",
       "description": "Toggle logging",
       "group": true,
@@ -12814,6 +13989,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config log db off",
       "description": "Turn off logging",
       "group": false,
@@ -12821,6 +13997,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config log db on",
       "description": "Turn on logging",
       "group": false,
@@ -12828,6 +14005,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config match",
       "description": "Configure match behavior",
       "group": true,
@@ -12835,6 +14013,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config match grammar",
       "description": "Toggle grammar cache usage",
       "group": true,
@@ -12842,6 +14021,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config match grammar off",
       "description": "Turn off grammar cache usage",
       "group": false,
@@ -12849,6 +14029,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config match grammar on",
       "description": "Turn on grammar cache usage",
       "group": false,
@@ -12856,6 +14037,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config modelProvider",
       "description": "Show or set the active model provider (azure | openai | ollama | copilot)",
       "group": false,
@@ -12876,6 +14058,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config request",
       "description": "Set the agent that handle natural language requests",
       "group": false,
@@ -12890,6 +14073,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config schema",
       "description": "Toggle agent schemas",
       "group": false,
@@ -12926,6 +14110,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "config scrub",
       "description": "Toggle outbound secret scrubbing",
       "group": true,
@@ -12933,6 +14118,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config scrub off",
       "description": "Turn off outbound secret scrubbing",
       "group": false,
@@ -12940,6 +14126,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config scrub on",
       "description": "Turn on outbound secret scrubbing",
       "group": false,
@@ -12947,6 +14134,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation",
       "description": "Translation configuration",
       "group": true,
@@ -12954,6 +14142,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation entity",
       "description": "Entity translation configuration",
       "group": true,
@@ -12961,6 +14150,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation entity clarify",
       "description": "Toggle entity clarification",
       "group": true,
@@ -12968,6 +14158,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation entity clarify off",
       "description": "Turn off entity clarification",
       "group": false,
@@ -12975,6 +14166,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation entity clarify on",
       "description": "Turn on entity clarification",
       "group": false,
@@ -12982,6 +14174,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation entity filter",
       "description": "Toggle entity filter using LLM",
       "group": true,
@@ -12989,6 +14182,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation entity filter off",
       "description": "Turn off entity filter using LLM",
       "group": false,
@@ -12996,6 +14190,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation entity filter on",
       "description": "Turn on entity filter using LLM",
       "group": false,
@@ -13003,6 +14198,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation entity resolve",
       "description": "Toggle entity resolution",
       "group": true,
@@ -13010,6 +14206,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation entity resolve off",
       "description": "Turn off entity resolution",
       "group": false,
@@ -13017,6 +14214,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation entity resolve on",
       "description": "Turn on entity resolution",
       "group": false,
@@ -13024,6 +14222,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation history",
       "description": "Configure chat history usage in translation",
       "group": true,
@@ -13031,6 +14230,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation history limit",
       "description": "Set the limit of chat history usage in translation",
       "group": false,
@@ -13045,6 +14245,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation history off",
       "description": "Turn off history",
       "group": false,
@@ -13052,6 +14253,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation history on",
       "description": "Turn on history",
       "group": false,
@@ -13059,6 +14261,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation model",
       "description": "Set model",
       "group": false,
@@ -13081,6 +14284,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "config translation multi",
       "description": "multiple actions",
       "group": true,
@@ -13088,6 +14292,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation multi off",
       "description": "Turn off multiple action translation",
       "group": false,
@@ -13095,6 +14300,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation multi on",
       "description": "Turn on multiple action translation",
       "group": false,
@@ -13102,6 +14308,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation multi pending",
       "description": "Toggle pending request in multiple action",
       "group": true,
@@ -13109,6 +14316,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation multi pending off",
       "description": "Turn off pending request in multiple action",
       "group": false,
@@ -13116,6 +14324,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation multi pending on",
       "description": "Turn on pending request in multiple action",
       "group": false,
@@ -13123,6 +14332,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation multi result",
       "description": "Toggle result id in multiple action",
       "group": true,
@@ -13130,6 +14340,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation multi result off",
       "description": "Turn off result id in multiple action",
       "group": false,
@@ -13137,6 +14348,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation multi result on",
       "description": "Turn on result id in multiple action",
       "group": false,
@@ -13144,6 +14356,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation off",
       "description": "Turn off translation",
       "group": false,
@@ -13151,6 +14364,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation on",
       "description": "Turn on translation",
       "group": false,
@@ -13158,6 +14372,46 @@
       "flags": []
     },
     {
+      "host": "system",
+      "path": "config translation recentActions",
+      "description": "Include recently executed actions in translation history",
+      "group": true,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "system",
+      "path": "config translation recentActions limit",
+      "description": "Set the max number of recently executed actions included in translation history (0-100, 0 = off)",
+      "group": false,
+      "args": [
+        {
+          "name": "limit",
+          "type": "number",
+          "optional": false,
+          "description": "Number of actions (0-100, 0 = off)"
+        }
+      ],
+      "flags": []
+    },
+    {
+      "host": "system",
+      "path": "config translation recentActions off",
+      "description": "Turn off recently executed actions in translation",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "system",
+      "path": "config translation recentActions on",
+      "description": "Turn on recently executed actions in translation",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "system",
       "path": "config translation schema",
       "description": "Action schema configuration",
       "group": true,
@@ -13165,6 +14419,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation schema generation",
       "description": "Generated action schema",
       "group": true,
@@ -13172,6 +14427,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation schema generation json",
       "description": "Toggle use generate json schema if model supports it",
       "group": true,
@@ -13179,6 +14435,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation schema generation json off",
       "description": "Turn off use generate json schema if model supports it",
       "group": false,
@@ -13186,6 +14443,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation schema generation json on",
       "description": "Turn on use generate json schema if model supports it",
       "group": false,
@@ -13193,6 +14451,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation schema generation jsonFunc",
       "description": "Toggle use generate json schema function if model supports it",
       "group": true,
@@ -13200,6 +14459,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation schema generation jsonFunc off",
       "description": "Turn off use generate json schema function if model supports it",
       "group": false,
@@ -13207,6 +14467,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation schema generation jsonFunc on",
       "description": "Turn on use generate json schema function if model supports it",
       "group": false,
@@ -13214,6 +14475,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation schema generation off",
       "description": "Turn off generated action schema",
       "group": false,
@@ -13221,6 +14483,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation schema generation on",
       "description": "Turn on generated action schema",
       "group": false,
@@ -13228,6 +14491,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation schema optimize",
       "description": "Optimize schema",
       "group": true,
@@ -13235,6 +14499,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation schema optimize actions",
       "description": "Set number of actions to use for initial translation",
       "group": false,
@@ -13249,6 +14514,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation schema optimize off",
       "description": "Turn off schema optimization",
       "group": false,
@@ -13256,6 +14522,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation schema optimize on",
       "description": "Turn on schema optimization",
       "group": false,
@@ -13263,6 +14530,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation stream",
       "description": "Toggle streaming translation",
       "group": true,
@@ -13270,6 +14538,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation stream off",
       "description": "Turn off streaming translation",
       "group": false,
@@ -13277,6 +14546,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation stream on",
       "description": "Turn on streaming translation",
       "group": false,
@@ -13284,6 +14554,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation switch",
       "description": "auto switch schemas",
       "group": true,
@@ -13291,6 +14562,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation switch embedding",
       "description": "Toggle Use embedding for initial pick of schema",
       "group": true,
@@ -13298,6 +14570,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation switch embedding off",
       "description": "Turn off Use embedding for initial pick of schema",
       "group": false,
@@ -13305,6 +14578,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation switch embedding on",
       "description": "Turn on Use embedding for initial pick of schema",
       "group": false,
@@ -13312,6 +14586,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation switch fix",
       "description": "Set a fixed schema disable switching",
       "group": false,
@@ -13326,6 +14601,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation switch inline",
       "description": "Toggle inject inline switch",
       "group": true,
@@ -13333,6 +14609,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation switch inline off",
       "description": "Turn off inject inline switch",
       "group": false,
@@ -13340,6 +14617,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation switch inline on",
       "description": "Turn on inject inline switch",
       "group": false,
@@ -13347,6 +14625,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation switch off",
       "description": "Turn off switch schema",
       "group": false,
@@ -13354,6 +14633,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation switch on",
       "description": "Turn on switch schema",
       "group": false,
@@ -13361,6 +14641,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation switch search",
       "description": "Toggle search switch",
       "group": true,
@@ -13368,6 +14649,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation switch search off",
       "description": "Turn off search switch",
       "group": false,
@@ -13375,6 +14657,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "config translation switch search on",
       "description": "Turn on search switch",
       "group": false,
@@ -13382,6 +14665,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const",
       "description": "Command to manage the construction store",
       "group": true,
@@ -13389,6 +14673,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const auto",
       "description": "Toggle construction auto save",
       "group": true,
@@ -13396,6 +14681,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const auto off",
       "description": "Turn off construction auto save",
       "group": false,
@@ -13403,6 +14689,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const auto on",
       "description": "Turn on construction auto save",
       "group": false,
@@ -13410,6 +14697,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const builtin",
       "description": "Toggle construction built-in cache",
       "group": true,
@@ -13417,6 +14705,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const builtin off",
       "description": "Turn off construction built-in cache",
       "group": false,
@@ -13424,6 +14713,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const builtin on",
       "description": "Turn on construction built-in cache",
       "group": false,
@@ -13431,6 +14721,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const delete",
       "description": "Delete a construction by id",
       "group": false,
@@ -13451,6 +14742,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const import",
       "description": "Import constructions from test data",
       "group": false,
@@ -13473,6 +14765,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "const info",
       "description": "Show current construction store info",
       "group": false,
@@ -13480,6 +14773,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const list",
       "description": "List constructions",
       "group": false,
@@ -13530,6 +14824,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "const load",
       "description": "Load a construction store from disk",
       "group": false,
@@ -13544,6 +14839,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const merge",
       "description": "Toggle construction merge",
       "group": true,
@@ -13551,6 +14847,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const merge off",
       "description": "Turn off construction merge",
       "group": false,
@@ -13558,6 +14855,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const merge on",
       "description": "Turn on construction merge",
       "group": false,
@@ -13565,6 +14863,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const new",
       "description": "Create a new construction store",
       "group": false,
@@ -13579,6 +14878,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const off",
       "description": "Disable construction store",
       "group": false,
@@ -13586,6 +14886,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const prune",
       "description": "Prune out of date construction from the cache",
       "group": false,
@@ -13593,6 +14894,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const save",
       "description": "Save construction store to disk",
       "group": false,
@@ -13607,6 +14909,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const wildcard",
       "description": "wildcard matching",
       "group": true,
@@ -13614,6 +14917,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const wildcard entity",
       "description": "Toggle entity wildcard matching",
       "group": true,
@@ -13621,6 +14925,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const wildcard entity off",
       "description": "Turn off entity wildcard matching",
       "group": false,
@@ -13628,6 +14933,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const wildcard entity on",
       "description": "Turn on entity wildcard matching",
       "group": false,
@@ -13635,6 +14941,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const wildcard off",
       "description": "Turn off wildcard matching",
       "group": false,
@@ -13642,6 +14949,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "const wildcard on",
       "description": "Turn on wildcard matching",
       "group": false,
@@ -13649,6 +14957,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "conversation",
       "description": "Conversation management commands",
       "group": true,
@@ -13656,6 +14965,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "conversation delete",
       "description": "Delete a conversation by name",
       "group": false,
@@ -13667,9 +14977,13 @@
           "description": "Name of the conversation to delete"
         }
       ],
-      "flags": []
+      "flags": [],
+      "action": {
+        "actionName": "deleteConversation"
+      }
     },
     {
+      "host": "system",
       "path": "conversation help",
       "description": "Show conversation command help",
       "group": false,
@@ -13677,20 +14991,29 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "conversation info",
       "description": "Show info about the current conversation",
       "group": false,
       "args": [],
-      "flags": []
+      "flags": [],
+      "action": {
+        "actionName": "showConversationInfo"
+      }
     },
     {
+      "host": "system",
       "path": "conversation list",
       "description": "List all conversations",
       "group": false,
       "args": [],
-      "flags": []
+      "flags": [],
+      "action": {
+        "actionName": "listConversation"
+      }
     },
     {
+      "host": "system",
       "path": "conversation new",
       "description": "Create a new conversation, optionally with a name",
       "group": false,
@@ -13702,23 +15025,35 @@
           "description": "Name for the new conversation (optional)"
         }
       ],
-      "flags": []
+      "flags": [],
+      "action": {
+        "actionName": "newConversation"
+      }
     },
     {
+      "host": "system",
       "path": "conversation next",
       "description": "Switch to the next conversation in the list (wraps around)",
       "group": false,
       "args": [],
-      "flags": []
+      "flags": [],
+      "action": {
+        "actionName": "nextConversation"
+      }
     },
     {
+      "host": "system",
       "path": "conversation prev",
       "description": "Switch to the previous conversation in the list (wraps around)",
       "group": false,
       "args": [],
-      "flags": []
+      "flags": [],
+      "action": {
+        "actionName": "prevConversation"
+      }
     },
     {
+      "host": "system",
       "path": "conversation rename",
       "description": "Rename a conversation. With one argument, renames the current conversation; with two, renames the named conversation.",
       "group": false,
@@ -13736,9 +15071,13 @@
           "description": "New name when renaming a specific conversation"
         }
       ],
-      "flags": []
+      "flags": [],
+      "action": {
+        "actionName": "renameConversation"
+      }
     },
     {
+      "host": "system",
       "path": "conversation switch",
       "description": "Switch to a conversation by name (defaults to the next conversation in the list)",
       "group": false,
@@ -13750,9 +15089,13 @@
           "description": "Name of the conversation to switch to (omit to cycle to the next)"
         }
       ],
-      "flags": []
+      "flags": [],
+      "action": {
+        "actionName": "switchConversation"
+      }
     },
     {
+      "host": "system",
       "path": "copilot",
       "description": "GitHub Copilot session commands",
       "group": true,
@@ -13760,6 +15103,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "copilot fix",
       "description": "Hand the current conversation to GitHub Copilot Chat in VS Code to diagnose and fix",
       "group": false,
@@ -13824,6 +15168,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "copilot import",
       "description": "Import GitHub Copilot Chat sessions as conversation mirrors",
       "group": false,
@@ -13831,6 +15176,30 @@
       "flags": []
     },
     {
+      "host": "system",
+      "path": "copilot login",
+      "description": "Sign in to GitHub Copilot via the browser device flow",
+      "group": false,
+      "args": [],
+      "flags": [
+        {
+          "name": "host",
+          "char": "",
+          "type": "string",
+          "default": "https://github.com",
+          "description": "GitHub host URL (e.g. https://example.ghe.com for Enterprise Cloud with data residency)"
+        },
+        {
+          "name": "no-open",
+          "char": "",
+          "type": "boolean",
+          "default": "false",
+          "description": "Do not auto-open the verification URL in a browser (the code and URL are still shown in chat)"
+        }
+      ]
+    },
+    {
+      "host": "system",
       "path": "debug",
       "description": "Start node inspector",
       "group": false,
@@ -13838,6 +15207,31 @@
       "flags": []
     },
     {
+      "host": "system",
+      "path": "demo",
+      "description": "Interactive TypeAgent demos",
+      "group": true,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "system",
+      "path": "demo questionCards",
+      "description": "Walk the interactive question types (single-select, multi-select, yes/no, free-text). Add --paged for a one-at-a-time Back/Next wizard.",
+      "group": false,
+      "args": [],
+      "flags": [
+        {
+          "name": "paged",
+          "char": "p",
+          "type": "boolean",
+          "default": "false",
+          "description": "Render one question at a time with Back / Next navigation"
+        }
+      ]
+    },
+    {
+      "host": "system",
       "path": "describe",
       "description": "Describe what an agent or action can do (installed-but-disabled agents included)",
       "group": false,
@@ -13866,6 +15260,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "display",
       "description": "Send text to display",
       "group": false,
@@ -13902,6 +15297,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "env",
       "description": "Environment variable commands",
       "group": true,
@@ -13909,6 +15305,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "env all",
       "description": "Echos environment variables to the user interface.",
       "group": false,
@@ -13916,6 +15313,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "env get",
       "description": "Echos the value of a named environment variable to the user interface",
       "group": false,
@@ -13930,6 +15328,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "exit",
       "description": "Exit the program",
       "group": false,
@@ -13937,6 +15336,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "feedback",
       "description": "Inspect and export user-feedback entries",
       "group": true,
@@ -13944,6 +15344,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "feedback count",
       "description": "Show the total number of feedback entries.",
       "group": false,
@@ -13951,6 +15352,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "feedback export",
       "description": "Export user-feedback entries to a local file (JSON or JSONL).",
       "group": false,
@@ -13980,6 +15382,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "feedback filter",
       "description": "Filter feedback by rating, category, and/or date range.",
       "group": false,
@@ -14030,6 +15433,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "feedback list",
       "description": "List recent user-feedback entries (most recent first).",
       "group": false,
@@ -14052,6 +15456,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "feedback top",
       "description": "Aggregate user feedback — counts by rating and category.",
       "group": false,
@@ -14067,6 +15472,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "grammar",
       "description": "Grammar rule and collision commands",
       "group": true,
@@ -14074,6 +15480,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "grammar clear",
       "description": "Clear stored grammar rules (optionally for a specific agent)",
       "group": false,
@@ -14088,6 +15495,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "grammar collisions",
       "description": "Scan all loaded agent grammars for cross-agent collisions, with concrete witness inputs",
       "group": false,
@@ -14103,6 +15511,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "grammar delete",
       "description": "Delete a stored grammar rule by ID",
       "group": false,
@@ -14117,6 +15526,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "grammar list",
       "description": "List grammar rules learned at runtime (optionally filtered by agent)",
       "group": false,
@@ -14131,6 +15541,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "grammar show",
       "description": "Show a stored grammar rule by ID",
       "group": false,
@@ -14145,6 +15556,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "help",
       "description": "Show help",
       "group": false,
@@ -14167,6 +15579,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "history",
       "description": "History commands",
       "group": true,
@@ -14174,6 +15587,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "history clear",
       "description": "Clear the history",
       "group": false,
@@ -14186,9 +15600,13 @@
           "default": "true",
           "description": "Clear the current activity context"
         }
-      ]
+      ],
+      "action": {
+        "actionName": "clearHistory"
+      }
     },
     {
+      "host": "system",
       "path": "history delete",
       "description": "Delete a specific message from the chat history",
       "group": false,
@@ -14200,9 +15618,13 @@
           "description": "Chat history index to delete."
         }
       ],
-      "flags": []
+      "flags": [],
+      "action": {
+        "actionName": "deleteHistory"
+      }
     },
     {
+      "host": "system",
       "path": "history entities",
       "description": "History entity commands",
       "group": true,
@@ -14210,6 +15632,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "history entities delete",
       "description": "Delete entities from the chat history (working memory).",
       "group": false,
@@ -14224,6 +15647,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "history entities list",
       "description": "Shows all of the entities currently in 'working memory.'",
       "group": false,
@@ -14231,6 +15655,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "history insert",
       "description": "Insert messages to chat history",
       "group": false,
@@ -14245,13 +15670,18 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "history list",
       "description": "List history",
       "group": false,
       "args": [],
-      "flags": []
+      "flags": [],
+      "action": {
+        "actionName": "listHistory"
+      }
     },
     {
+      "host": "system",
       "path": "history save",
       "description": "Save the chat history to a file",
       "group": false,
@@ -14266,6 +15696,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "index",
       "description": "Indexing commands",
       "group": true,
@@ -14273,6 +15704,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "index create",
       "description": "Create a new index",
       "group": false,
@@ -14299,6 +15731,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "index delete",
       "description": "Delete an index",
       "group": false,
@@ -14313,6 +15746,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "index info",
       "description": "Show index details",
       "group": false,
@@ -14327,6 +15761,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "index list",
       "description": "List indexes",
       "group": false,
@@ -14334,6 +15769,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "memory",
       "description": "Memory commands",
       "group": true,
@@ -14341,6 +15777,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "memory answer",
       "description": "Answer a question using conversation memory",
       "group": false,
@@ -14391,6 +15828,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "memory legacy",
       "description": "Toggle legacy",
       "group": true,
@@ -14398,6 +15836,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "memory legacy off",
       "description": "Turn off legacy",
       "group": false,
@@ -14405,6 +15844,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "memory legacy on",
       "description": "Turn on legacy",
       "group": false,
@@ -14412,6 +15852,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "memory query",
       "description": "Search conversation memory",
       "group": false,
@@ -14462,6 +15903,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "memory search",
       "description": "Answer a question using conversation memory",
       "group": false,
@@ -14512,6 +15954,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "notify",
       "description": "Notify commands",
       "group": true,
@@ -14519,6 +15962,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "notify clear",
       "description": "Clears notifications",
       "group": false,
@@ -14526,6 +15970,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "notify info",
       "description": "Shows the number of notifications available",
       "group": false,
@@ -14533,6 +15978,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "notify show",
       "description": "Show notifications",
       "group": true,
@@ -14540,6 +15986,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "notify show all",
       "description": "Shows all notifications",
       "group": false,
@@ -14547,6 +15994,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "notify show unread",
       "description": "Shows unread notifications",
       "group": false,
@@ -14554,6 +16002,37 @@
       "flags": []
     },
     {
+      "host": "system",
+      "path": "notify status",
+      "description": "Fire a persistent status notice (a toast that collapses to the notification bell) to verify the chat-ui affordance without a stale server",
+      "group": false,
+      "args": [
+        {
+          "name": "message",
+          "type": "string",
+          "optional": true,
+          "description": "Notice body text"
+        }
+      ],
+      "flags": [
+        {
+          "name": "level",
+          "char": "",
+          "type": "string",
+          "default": "warning",
+          "description": "Severity accent: info | warning | error"
+        },
+        {
+          "name": "restart",
+          "char": "",
+          "type": "boolean",
+          "default": "false",
+          "description": "Include a 'Restart server' action button (runs @server restart when clicked)"
+        }
+      ]
+    },
+    {
+      "host": "system",
       "path": "notify test",
       "description": "Fire a synthetic notification through the channel — for verifying chat rendering without an agent",
       "group": false,
@@ -14576,6 +16055,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "open",
       "description": "Shortcut for opening system related folders",
       "group": false,
@@ -14590,6 +16070,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "ports",
       "description": "Lists ports registered by agents and the number of clients connected to each.",
       "group": false,
@@ -14597,6 +16078,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "random",
       "description": "Random request commands",
       "group": true,
@@ -14604,6 +16086,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "random offline",
       "description": "Issues a random request from a dataset of pre-generated requests.",
       "group": false,
@@ -14611,6 +16094,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "random online",
       "description": "Uses the LLM to generate random requests.",
       "group": false,
@@ -14618,6 +16102,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "run",
       "description": "Run a command script file",
       "group": false,
@@ -14632,6 +16117,23 @@
       "flags": []
     },
     {
+      "host": "system",
+      "path": "server",
+      "description": "Manage the agent server",
+      "group": true,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "system",
+      "path": "server restart",
+      "description": "Restart the agent server so it loads rebuilt code",
+      "group": false,
+      "args": [],
+      "flags": []
+    },
+    {
+      "host": "system",
       "path": "session",
       "description": "Session commands",
       "group": true,
@@ -14639,6 +16141,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "session clear",
       "description": "Delete all data on the current sessions, keeping current settings",
       "group": false,
@@ -14646,6 +16149,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "session delete",
       "description": "Delete a session. If no session is specified, delete the current session and start a new session.\n-a to delete all sessions",
       "group": false,
@@ -14668,6 +16172,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "session info",
       "description": "Show info about the current session",
       "group": false,
@@ -14675,6 +16180,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "session list",
       "description": "List all sessions. The current session is marked green.",
       "group": false,
@@ -14682,6 +16188,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "session new",
       "description": "Create a new empty session",
       "group": false,
@@ -14704,6 +16211,7 @@
       ]
     },
     {
+      "host": "system",
       "path": "session open",
       "description": "Open an existing session",
       "group": false,
@@ -14718,6 +16226,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "session reset",
       "description": "Reset config on session and keep the data",
       "group": false,
@@ -14725,6 +16234,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "settings",
       "description": "Persistent user settings",
       "group": true,
@@ -14732,6 +16242,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "settings conversation",
       "description": "Conversation settings",
       "group": true,
@@ -14739,6 +16250,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "settings conversation resume",
       "description": "Set whether to resume the last conversation on startup (true/false)",
       "group": false,
@@ -14753,6 +16265,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "settings reset",
       "description": "Reset all settings to defaults",
       "group": false,
@@ -14760,6 +16273,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "settings server",
       "description": "Server startup settings",
       "group": true,
@@ -14767,6 +16281,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "settings server hidden",
       "description": "Set whether the AgentServer starts hidden (true/false)",
       "group": false,
@@ -14781,6 +16296,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "settings server idleTimeout",
       "description": "Set idle timeout in seconds (0 to disable)",
       "group": false,
@@ -14795,6 +16311,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "settings show",
       "description": "Show all persistent user settings",
       "group": false,
@@ -14802,6 +16319,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "settings ui",
       "description": "UI settings",
       "group": true,
@@ -14809,6 +16327,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "settings ui autoComplete",
       "description": "Set whether inline autocompletion is enabled in the CLI (true/false)",
       "group": false,
@@ -14823,6 +16342,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "shutdown",
       "description": "Shut down the agent server and exit",
       "group": false,
@@ -14830,6 +16350,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "token",
       "description": "Get LLM token usage statistics for this session.",
       "group": true,
@@ -14837,6 +16358,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "token details",
       "description": "Gets detailed LLM usage statistics.",
       "group": false,
@@ -14844,6 +16366,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "token summary",
       "description": "Get overall LLM usage statistics.",
       "group": false,
@@ -14851,6 +16374,7 @@
       "flags": []
     },
     {
+      "host": "system",
       "path": "trace",
       "description": "Enable or disable trace namespaces",
       "group": false,
@@ -14874,8 +16398,8 @@
     }
   ],
   "counts": {
-    "agents": 32,
-    "actions": 553,
-    "commands": 325
+    "agents": 33,
+    "actions": 557,
+    "commands": 411
   }
 }
\ No newline at end of file
diff --git a/ts/docs/overview/command-reference.md b/ts/docs/overview/command-reference.md
index bd04859c2e..89d73a7261 100644
--- a/ts/docs/overview/command-reference.md
+++ b/ts/docs/overview/command-reference.md
@@ -35,6 +35,27 @@ Usage: `@action [--naturalLanguage <string>] [--parameters <json>] <schemaName>
 - --parameters &lt;json&gt; : Action parameter
 - --naturalLanguage &lt;string&gt; : Natural language phrase to associate with this action for cache population
 
+## @describe - Describe what an agent or action can do (installed-but-disabled agents included)
+
+Usage: `@describe [-a|--all] <name> [<actionName>]`
+
+### Arguments:
+
+- &lt;name&gt; - Agent name, or (if no action given) action name (type: string)
+- &lt;actionName&gt; - (optional) Action name, when `name` is an agent (type: string)
+
+### Flags:
+
+- --all -a : Show the full action table instead of the top 10 (default: false)
+
+## @demo questionCards - Walk the interactive question types (single-select, multi-select, yes/no, free-text). Add --paged for a one-at-a-time Back/Next wizard.
+
+Usage: `@demo questionCards [-p|--paged]`
+
+### Flags:
+
+- --paged -p : Render one question at a time with Back / Next navigation (default: false)
+
 ## @session new - Create a new empty session
 
 Usage: `@session new [--persist] [--keep]`
@@ -86,6 +107,8 @@ Usage: `@session info`
 
 Usage: `@conversation new [<name>]`
 
+Equivalent action: [`system.conversation.newConversation`](../../packages/dispatcher/dispatcher/src/context/system/schema/conversationActionSchema.ts)
+
 ### Arguments:
 
 - &lt;name&gt; - (optional) Name for the new conversation (optional) (type: string)
@@ -94,14 +117,20 @@ Usage: `@conversation new [<name>]`
 
 Usage: `@conversation list`
 
+Equivalent action: [`system.conversation.listConversation`](../../packages/dispatcher/dispatcher/src/context/system/schema/conversationActionSchema.ts)
+
 ## @conversation info - Show info about the current conversation
 
 Usage: `@conversation info`
 
+Equivalent action: [`system.conversation.showConversationInfo`](../../packages/dispatcher/dispatcher/src/context/system/schema/conversationActionSchema.ts)
+
 ## @conversation switch - Switch to a conversation by name (defaults to the next conversation in the list)
 
 Usage: `@conversation switch [<name>]`
 
+Equivalent action: [`system.conversation.switchConversation`](../../packages/dispatcher/dispatcher/src/context/system/schema/conversationActionSchema.ts)
+
 ### Arguments:
 
 - &lt;name&gt; - (optional) Name of the conversation to switch to (omit to cycle to the next) (type: string)
@@ -110,14 +139,20 @@ Usage: `@conversation switch [<name>]`
 
 Usage: `@conversation prev`
 
+Equivalent action: [`system.conversation.prevConversation`](../../packages/dispatcher/dispatcher/src/context/system/schema/conversationActionSchema.ts)
+
 ## @conversation next - Switch to the next conversation in the list (wraps around)
 
 Usage: `@conversation next`
 
+Equivalent action: [`system.conversation.nextConversation`](../../packages/dispatcher/dispatcher/src/context/system/schema/conversationActionSchema.ts)
+
 ## @conversation rename - Rename a conversation. With one argument, renames the current conversation; with two, renames the named conversation.
 
 Usage: `@conversation rename <nameOrNewName> [<newName>]`
 
+Equivalent action: [`system.conversation.renameConversation`](../../packages/dispatcher/dispatcher/src/context/system/schema/conversationActionSchema.ts)
+
 ### Arguments:
 
 - &lt;nameOrNewName&gt; - New name (renames current) or existing name (when newName given) (type: string)
@@ -127,6 +162,8 @@ Usage: `@conversation rename <nameOrNewName> [<newName>]`
 
 Usage: `@conversation delete <name>`
 
+Equivalent action: [`system.conversation.deleteConversation`](../../packages/dispatcher/dispatcher/src/context/system/schema/conversationActionSchema.ts)
+
 ### Arguments:
 
 - &lt;name&gt; - Name of the conversation to delete (type: string)
@@ -139,6 +176,33 @@ Usage: `@conversation help`
 
 Usage: `@copilot import`
 
+## @copilot fix - Hand the current conversation to GitHub Copilot Chat in VS Code to diagnose and fix
+
+Usage: `@copilot fix [--location <string>] [--reuse-session] [--no-send] [--target <string>] [--dev-captures <string>] [--no-screenshot] [--mode <string>] [<instructions>]`
+
+### Arguments:
+
+- &lt;instructions&gt; - (optional) Optional extra instructions to include in the Copilot prompt (type: string)
+
+### Flags:
+
+- --mode &lt;string&gt; : Copilot chat mode: 'agent' (can edit the workspace) or 'ask' (default: agent)
+- --no-screenshot : Do not attach a screenshot of the VS Code window (default: false)
+- --dev-captures &lt;string&gt; : Include developer-mode translation captures: 'auto' (when developer mode is on), 'on', or 'off' (default: auto)
+- --target &lt;string&gt; : Copilot target (reserved; only native GitHub Copilot is supported) (default: native)
+- --no-send : Pre-fill the Copilot prompt but do not auto-submit it (review before sending) (default: false)
+- --reuse-session : Send into the current Copilot Chat session instead of starting a new one (default: false)
+- --location &lt;string&gt; : Where to open the new session: 'editor' (new chat editor), 'view' (chat panel), or 'window' (separate chat window) (default: editor)
+
+## @copilot login - Sign in to GitHub Copilot via the browser device flow
+
+Usage: `@copilot login [--no-open] [--host <string>]`
+
+### Flags:
+
+- --host &lt;string&gt; : GitHub host URL (e.g. https://example.ghe.com for Enterprise Cloud with data residency) (default: https://github.com)
+- --no-open : Do not auto-open the verification URL in a browser (the code and URL are still shown in chat) (default: false)
+
 ## @collision events - Show recent collision events captured in the current session's ring buffer
 
 Usage: `@collision events [-k|--kind <string>] [-n|--limit <number>]`
@@ -474,10 +538,14 @@ Usage: `@grammar collisions [--json <string>]`
 
 Usage: `@history list`
 
+Equivalent action: [`system.history.listHistory`](../../packages/dispatcher/dispatcher/src/context/system/schema/historyActionSchema.ts)
+
 ## @history clear - Clear the history
 
 Usage: `@history clear [--activity]`
 
+Equivalent action: [`system.history.clearHistory`](../../packages/dispatcher/dispatcher/src/context/system/schema/historyActionSchema.ts)
+
 ### Flags:
 
 - --activity : Clear the current activity context (default: true)
@@ -486,6 +554,8 @@ Usage: `@history clear [--activity]`
 
 Usage: `@history delete <index>`
 
+Equivalent action: [`system.history.deleteHistory`](../../packages/dispatcher/dispatcher/src/context/system/schema/historyActionSchema.ts)
+
 ### Arguments:
 
 - &lt;index&gt; - Chat history index to delete. (type: number)
@@ -764,6 +834,14 @@ Usage: `@config request <appAgentName>`
 
 - &lt;appAgentName&gt; - name of the agent (type: string)
 
+## @config scrub on - Turn on outbound secret scrubbing
+
+Usage: `@config scrub on`
+
+## @config scrub off - Turn off outbound secret scrubbing
+
+Usage: `@config scrub off`
+
 ## @config match grammar on - Turn on grammar cache usage
 
 Usage: `@config match grammar on`
@@ -888,6 +966,22 @@ Usage: `@config translation history limit <limit>`
 
 - &lt;limit&gt; - Number of actions (type: number)
 
+## @config translation recentActions on - Turn on recently executed actions in translation
+
+Usage: `@config translation recentActions on`
+
+## @config translation recentActions off - Turn off recently executed actions in translation
+
+Usage: `@config translation recentActions off`
+
+## @config translation recentActions limit - Set the max number of recently executed actions included in translation history (0-100, 0 = off)
+
+Usage: `@config translation recentActions limit <limit>`
+
+### Arguments:
+
+- &lt;limit&gt; - Number of actions (0-100, 0 = off) (type: number)
+
 ## @config translation stream on - Turn on streaming translation
 
 Usage: `@config translation stream on`
@@ -1054,27 +1148,43 @@ Usage: `@config execution activity off`
 
 ## @config execution reasoning - Set reasoning engine
 
-Usage: `@config execution reasoning <engine>`
+Usage: `@config execution reasoning [<engine>]`
+
+### Arguments:
+
+- &lt;engine&gt; - (optional) Reasoning engine to use (claude, copilot, or none). Omit to show the current engine. (type: string)
+
+## @config execution reasoningModel - Set the Copilot reasoning model (e.g. claude-opus-4.8). Omit to show the current value.
+
+Usage: `@config execution reasoningModel [<model>]`
 
 ### Arguments:
 
-- &lt;engine&gt; - Reasoning engine to use (claude, copilot, or none) (type: string)
+- &lt;model&gt; - (optional) Model identifier for Copilot reasoning. Omit to show the current value. (type: string)
+
+## @config execution reasoningEffort - Set the Copilot reasoning effort (low, medium, high, xhigh). Only applies to models that support it. Omit to show the current value.
+
+Usage: `@config execution reasoningEffort [<effort>]`
+
+### Arguments:
+
+- &lt;effort&gt; - (optional) 'low', 'medium', 'high', or 'xhigh'. Omit to show the current value. (type: string)
 
 ## @config execution conversationAnswer - How conversation questions are answered: 'lookup' (conversation-memory lookup, reasoning as fallback), 'reasoning-first' (reasoning agent primary, lookup as fallback), or 'reasoning-only' (remove the lookup action; reasoning handles conversation Q&A)
 
-Usage: `@config execution conversationAnswer <strategy>`
+Usage: `@config execution conversationAnswer [<strategy>]`
 
 ### Arguments:
 
-- &lt;strategy&gt; - 'lookup' (default), 'reasoning-first', or 'reasoning-only' (type: string)
+- &lt;strategy&gt; - (optional) 'lookup' (default), 'reasoning-first', or 'reasoning-only'. Omit to show the current strategy. (type: string)
 
 ## @config execution reasoningHistory - Number of recent conversation turns included as context in the reasoning prompt
 
-Usage: `@config execution reasoningHistory <turns>`
+Usage: `@config execution reasoningHistory [<turns>]`
 
 ### Arguments:
 
-- &lt;turns&gt; - Number of recent conversation turns to include (e.g. 4). 0 disables history. Larger values give the reasoning agent more context at the cost of a bigger prompt. (type: number)
+- &lt;turns&gt; - (optional) Number of recent conversation turns to include (e.g. 4). 0 disables history. Omit to show the current value. (type: number)
 
 ## @config execution recordUserMessages on - Turn on record the user's own messages in the conversation transcript (chat history)
 
@@ -1086,27 +1196,27 @@ Usage: `@config execution recordUserMessages off`
 
 ## @config execution planReuse - Enable or disable workflow plan reuse for reasoning actions
 
-Usage: `@config execution planReuse <mode>`
+Usage: `@config execution planReuse [<mode>]`
 
 ### Arguments:
 
-- &lt;mode&gt; - Plan reuse mode: 'enabled' to cache and reuse workflow plans, 'disabled' for standard reasoning (type: string)
+- &lt;mode&gt; - (optional) Plan reuse mode: 'enabled' to cache and reuse workflow plans, 'disabled' for standard reasoning. Omit to show the current value. (type: string)
 
 ## @config execution scriptReuse - Enable or disable PowerShell script reuse for reasoning actions
 
-Usage: `@config execution scriptReuse <mode>`
+Usage: `@config execution scriptReuse [<mode>]`
 
 ### Arguments:
 
-- &lt;mode&gt; - Script reuse mode: 'enabled' to capture and reuse PowerShell scripts, 'disabled' for standard reasoning (type: string)
+- &lt;mode&gt; - (optional) Script reuse mode: 'enabled' to capture and reuse PowerShell scripts, 'disabled' for standard reasoning. Omit to show the current value. (type: string)
 
 ## @config execution entityPromptShape - Shape used when serializing Entity objects into LLM prompts
 
-Usage: `@config execution entityPromptShape <shape>`
+Usage: `@config execution entityPromptShape [<shape>]`
 
 ### Arguments:
 
-- &lt;shape&gt; - 'facets' (default, name+value array), 'flat' (collapse facets into a properties object), or 'facets-with-schema' (facets + append the Entity TS type to the reasoning system prompt) (type: string)
+- &lt;shape&gt; - (optional) 'facets' (default, name+value array), 'flat' (collapse facets into a properties object), or 'facets-with-schema' (facets + append the Entity TS type to the reasoning system prompt). Omit to show the current value. (type: string)
 
 ## @config execution setupOnFirstUse on - Turn on auto-run agent setup on first use (otherwise emit a hint to run @config agent setup)
 
@@ -1116,6 +1226,14 @@ Usage: `@config execution setupOnFirstUse on`
 
 Usage: `@config execution setupOnFirstUse off`
 
+## @config execution subagents on - Turn on allow the reasoning loop to create and manage subagents (each with its own command-executor process)
+
+Usage: `@config execution subagents on`
+
+## @config execution subagents off - Turn off allow the reasoning loop to create and manage subagents (each with its own command-executor process)
+
+Usage: `@config execution subagents off`
+
 ## @config modelProvider - Show or set the active model provider (azure | openai | ollama | copilot)
 
 Usage: `@config modelProvider [<name>] [<action>]`
@@ -1446,6 +1564,10 @@ Usage: `@exit`
 
 Usage: `@shutdown`
 
+## @server restart - Restart the agent server so it loads rebuilt code
+
+Usage: `@server restart`
+
 ## @random online - Uses the LLM to generate random requests.
 
 Usage: `@random online`
@@ -1474,6 +1596,19 @@ Usage: `@notify test [--mode <string>] <message>`
 
 - --mode &lt;string&gt; : Render mode: toast | inline | info | warning | error (default: toast)
 
+## @notify status - Fire a persistent status notice (a toast that collapses to the notification bell) to verify the chat-ui affordance without a stale server
+
+Usage: `@notify status [--restart] [--level <string>] [<message>]`
+
+### Arguments:
+
+- &lt;message&gt; - (optional) Notice body text (type: string)
+
+### Flags:
+
+- --level &lt;string&gt; : Severity accent: info | warning | error (default: warning)
+- --restart : Include a 'Restart server' action button (runs @server restart when clicked) (default: false)
+
 ## @notify show unread - Shows unread notifications
 
 Usage: `@notify show unread`
@@ -1743,6 +1878,18 @@ Usage: `@browser actions stop recording [<description>]`
 
 - &lt;description&gt; - (optional) Description of what the recorded action does (type: string)
 
+## @browser lookup status - Show the current internet lookup mode
+
+Usage: `@browser lookup status`
+
+## @browser lookup mode - Set the internet lookup mode: off (browser), api, or mcp
+
+Usage: `@browser lookup mode <mode>`
+
+### Arguments:
+
+- &lt;mode&gt; - off | api | mcp (type: string)
+
 ## @browser search list - Lists browser agent search providers
 
 Usage: `@browser search list`
@@ -2094,3 +2241,19 @@ Usage: `@powershell import [--actionName <string>] <filePath>`
 ### Flags:
 
 - --actionName &lt;string&gt; : Override the generated action name
+
+## @selfhelp - Ask a question about TypeAgent (what it is, how it works, how to set it up).
+
+Usage: `@selfhelp <question>`
+
+### Arguments:
+
+- &lt;question&gt; - Your question about TypeAgent. (type: string)
+
+## @selfhelp ask - Ask a question about TypeAgent (what it is, how it works, how to set it up).
+
+Usage: `@selfhelp ask <question>`
+
+### Arguments:
+
+- &lt;question&gt; - Your question about TypeAgent. (type: string)
diff --git a/ts/packages/agentSdk/README.AUTOGEN.md b/ts/packages/agentSdk/README.AUTOGEN.md
index 4d1bd6c281..b093bae172 100644
--- a/ts/packages/agentSdk/README.AUTOGEN.md
+++ b/ts/packages/agentSdk/README.AUTOGEN.md
@@ -3,7 +3,7 @@
 
 <!-- AUTOGEN:DOCS:START -->
 
-<!-- AUTOGEN:DOCS:HASH:sha256=d66b00d28ad6b48d2ae6bac995f5cba92699a2a33854d4589450d6cbdd7c649c -->
+<!-- AUTOGEN:DOCS:HASH:sha256=f645528e0d3784aa3d5044bbe04320b56a087c38f3735b671a6e1ee2f5653220 -->
 <!-- AUTOGEN:DOCS:SOURCE: ./README.md (hand-written documentation; this file is the AI-generated companion) -->
 
 # @typeagent/agent-sdk — AI-generated documentation
@@ -12,15 +12,15 @@
 
 ## Overview
 
-The `@typeagent/agent-sdk` package is a TypeScript library that provides the core interfaces, types, and utilities required to build Dispatcher Agents within the TypeAgent ecosystem. Dispatcher Agents are responsible for handling user commands, executing actions, and managing their lifecycle and context. This package serves as a foundational dependency for many tools and agents in the ecosystem, ensuring consistency and extensibility in agent development.
+The `@typeagent/agent-sdk` package is a TypeScript library that provides the foundational interfaces, types, and utilities for building Dispatcher Agents in the TypeAgent ecosystem. Dispatcher Agents are responsible for handling user commands, executing actions, and managing their lifecycle and context. This package is a core dependency for many other TypeAgent tools and agents, ensuring a consistent and extensible framework for agent development.
 
 ## What it does
 
-The `@typeagent/agent-sdk` package supports the creation and management of Dispatcher Agents by offering the following capabilities:
+The `@typeagent/agent-sdk` package enables developers to create and manage Dispatcher Agents by providing the following key features:
 
 ### Manifest and Instantiation
 
-- **Manifest**: The `AppAgentManifest` defines metadata about the agent, such as its emoji, description, and translator configuration. This manifest is the first interaction point between the Dispatcher and the agent.
+- **Manifest**: The `AppAgentManifest` defines metadata about the agent, such as its emoji, description, and translator configuration. This manifest is the first point of interaction between the Dispatcher and the agent.
 - **Instantiation Entry Point**: The `AppAgent` interface is the primary contract that agents implement. The Dispatcher uses the `instantiate` function exported from the `./agent/handlers` module to create an instance of the agent.
 
 ### Lifecycle Management
@@ -160,16 +160,16 @@ External: `debug`, `type-fest`
 ### Used by
 
 - [@typeagent/action-browser](../../tools/actionBrowser/README.md)
+- [@typeagent/agent-cache](../../packages/cache/README.md)
 - [@typeagent/agent-rpc](../../packages/agentRpc/README.md)
 - [@typeagent/agent-server-client](../../packages/agentServer/client/README.md)
 - [@typeagent/agent-server-protocol](../../packages/agentServer/protocol/README.md)
+- [@typeagent/android-mobile-agent](../../packages/agents/androidMobile/README.md)
 - [@typeagent/azure-ai-foundry](../../packages/azure-ai-foundry/README.md)
 - [@typeagent/browser](../../packages/agents/browser/README.md)
 - [@typeagent/browser-extension](../../packages/agents/browserExtension/README.md)
-- [@typeagent/chat-ui](../../packages/chat-ui/README.md)
-- [@typeagent/code-agent](../../packages/agents/code/README.md)
-- [@typeagent/copilot-plugin](../../packages/copilot-plugin/README.md)
-- _…and 53 more workspace consumers._
+- [@typeagent/calendar](../../packages/agents/calendar/README.md)
+- _…and 54 more workspace consumers._
 
 ### Files of interest
 
@@ -187,6 +187,6 @@ External: `debug`, `type-fest`
 
 ---
 
-_Auto-generated against commit `fa4bb9b44db12e2d15b83e03e59f9c7147ed2b50` on `2026-07-27T19:08:36.121Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter @typeagent/agent-sdk docs:verify-links` to spot-check._
+_Auto-generated against commit `5018562335eded84b16dedcbb8e86d59b538a978` on `2026-07-30T06:29:20.146Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter @typeagent/agent-sdk docs:verify-links` to spot-check._
 
 <!-- AUTOGEN:DOCS:END -->
diff --git a/ts/packages/agentSdk/src/command.ts b/ts/packages/agentSdk/src/command.ts
index e555c702a1..d584b6ddc4 100644
--- a/ts/packages/agentSdk/src/command.ts
+++ b/ts/packages/agentSdk/src/command.ts
@@ -38,6 +38,11 @@ export type CommandDescriptor = {
     description: string;
     help?: string;
     parameters?: ParameterDefinitions | undefined;
+    // The agent action this command is equivalent to, if any. Lets tooling
+    // cross-reference a typed command with its natural-language action (and
+    // track which commands still lack one). `schema` is optional when the
+    // `actionName` is unambiguous within the agent.
+    action?: string | { schema: string; actionName: string } | undefined;
 };
 
 export type CommandDescriptorTable = {
diff --git a/ts/packages/agentServer/client/README.AUTOGEN.md b/ts/packages/agentServer/client/README.AUTOGEN.md
index 9656769f7b..e5c4e990c1 100644
--- a/ts/packages/agentServer/client/README.AUTOGEN.md
+++ b/ts/packages/agentServer/client/README.AUTOGEN.md
@@ -3,7 +3,7 @@
 
 <!-- AUTOGEN:DOCS:START -->
 
-<!-- AUTOGEN:DOCS:HASH:sha256=ac666c56240da8bdd30324f4c777c7eb743862cea02da6438bc1b4dd491c6deb -->
+<!-- AUTOGEN:DOCS:HASH:sha256=00e71435a343a317b408381bced5f9404512989c4cac02ab5280e43b62f8c830 -->
 <!-- AUTOGEN:DOCS:SOURCE: ./README.md (hand-written documentation; this file is the AI-generated companion) -->
 
 # @typeagent/agent-server-client — AI-generated documentation
@@ -12,17 +12,18 @@
 
 ## Overview
 
-The `@typeagent/agent-server-client` package is a TypeScript library that provides tools for interacting with a running `agentServer`. It is a core component of the TypeAgent ecosystem, enabling clients such as the Shell, CLI, and browser extensions to manage server connections, handle conversations, and ensure the server is running when needed.
+The `@typeagent/agent-server-client` package is a TypeScript library designed to facilitate interaction with a running `agentServer`. It provides tools for managing server connections, handling conversations, and ensuring the server is operational. This package is a critical component of the TypeAgent ecosystem, used by clients such as the Shell, CLI, and browser extensions.
 
 ## What it does
 
-This package offers a range of features to facilitate interaction with the `agentServer`:
+This package provides a comprehensive set of features for interacting with the `agentServer`:
 
 ### Server Connection Management
 
-- **`connectAgentServer`**: Establishes a WebSocket connection to an `agentServer` and returns an `AgentServerConnection` object. This object provides methods for managing conversations and interacting with the server.
+- **`connectAgentServer`**: Establishes a WebSocket connection to an `agentServer` and returns an `AgentServerConnection` object. This object enables full conversation management.
 - **`isServerRunning`**: Checks if an `agentServer` is already running at a specified WebSocket URL.
-- **`ensureAgentServer`**: Ensures that the `agentServer` is running, spawning it if necessary. Options include running the server in hidden mode and setting an idle timeout.
+- **`ensureAgentServer`**: Ensures the `agentServer` is running, spawning it if necessary. Options include running the server in hidden mode and setting an idle timeout.
+- **`stopAgentServer`**: Sends a shutdown RPC to a running server.
 
 ### Conversation Management
 
@@ -127,22 +128,22 @@ Workspace:
 - [@typeagent/agent-sdk](../../../packages/agentSdk/README.md)
 - [@typeagent/agent-server-protocol](../../../packages/agentServer/protocol/README.md)
 - [@typeagent/dispatcher-rpc](../../../packages/dispatcher/rpc/README.md)
-- [websocket-channel-server](../../../packages/utils/webSocketChannelServer/README.md)
+- [@typeagent/websocket-channel-server](../../../packages/utils/webSocketChannelServer/README.md)
 
 External: `debug`, `isomorphic-ws`
 
 ### Used by
 
+- [@typeagent/browser](../../../packages/agents/browser/README.md)
 - [@typeagent/browser-extension](../../../packages/agents/browserExtension/README.md)
 - [@typeagent/copilot-plugin](../../../packages/copilot-plugin/README.md)
+- [@typeagent/studio-service](../../../packages/studio-service/README.md)
 - [agent-cli](../../../packages/cli/README.md)
 - [agent-coda](../../../packages/coda/README.md)
 - [agent-server](../../../packages/agentServer/server/README.md)
 - [agent-shell](../../../packages/shell/README.md)
-- [browser-typeagent](../../../packages/agents/browser/README.md)
 - [coder-wrapper](../../../packages/coderWrapper/README.md)
 - [command-executor-mcp](../../../packages/commandExecutor/README.md)
-- [remote-client-example](../../../examples/remoteClient/README.md)
 - _…and 6 more workspace consumers._
 
 ### Files of interest
@@ -153,6 +154,7 @@ External: `debug`, `isomorphic-ws`
 - [./src/conversation/lifecycle.ts](./src/conversation/lifecycle.ts)
 - [./src/conversation/manage.ts](./src/conversation/manage.ts)
 - [./src/conversation/naming.ts](./src/conversation/naming.ts)
+- [./src/conversation/render.ts](./src/conversation/render.ts)
 - [./src/discovery.ts](./src/discovery.ts)
 - [./src/tsconfig.json](./src/tsconfig.json)
 
@@ -166,6 +168,6 @@ _3 environment variables referenced from `./src/` (set in `ts/.env` or your shel
 
 ---
 
-_Auto-generated against commit `8f591da77983db53fd4a3e0ca12b58d80aaa3628` on `2026-07-22T20:55:48.144Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter @typeagent/agent-server-client docs:verify-links` to spot-check._
+_Auto-generated against commit `5018562335eded84b16dedcbb8e86d59b538a978` on `2026-07-30T06:29:20.146Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter @typeagent/agent-server-client docs:verify-links` to spot-check._
 
 <!-- AUTOGEN:DOCS:END -->
diff --git a/ts/packages/agentServer/client/src/conversation/index.ts b/ts/packages/agentServer/client/src/conversation/index.ts
index 25ed3c4999..7bec6c973a 100644
--- a/ts/packages/agentServer/client/src/conversation/index.ts
+++ b/ts/packages/agentServer/client/src/conversation/index.ts
@@ -50,3 +50,5 @@ export {
     type ManageConversationContext,
     type ConversationActionResult,
 } from "./manage.js";
+
+export { renderConversationActionResult } from "./render.js";
diff --git a/ts/packages/agentServer/client/src/conversation/manage.ts b/ts/packages/agentServer/client/src/conversation/manage.ts
index 90f1607f06..4efe629fa3 100644
--- a/ts/packages/agentServer/client/src/conversation/manage.ts
+++ b/ts/packages/agentServer/client/src/conversation/manage.ts
@@ -454,14 +454,15 @@ export async function manageRename(
         );
     }
 
-    // Preserve original createdAt/clientCount so callers re-sorting by
-    // created time don't see zero placeholders.
+    // Preserve original createdAt/clientCount/messageCount so callers
+    // re-sorting by created time don't see zero placeholders.
     const original = all.find((c) => c.conversationId === targetId);
     const updated: ConversationInfo = {
         conversationId: targetId,
         name: trimmedNew,
         clientCount: original?.clientCount ?? 0,
         createdAt: original?.createdAt ?? "",
+        messageCount: original?.messageCount ?? 0,
     };
 
     if (isCurrent && ctx.onCurrentConversationUpdated !== undefined) {
diff --git a/ts/packages/agentServer/client/src/conversation/render.ts b/ts/packages/agentServer/client/src/conversation/render.ts
new file mode 100644
index 0000000000..651061e107
--- /dev/null
+++ b/ts/packages/agentServer/client/src/conversation/render.ts
@@ -0,0 +1,84 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+// Shared presentation for `manage-conversation` results. Produces structured
+// DisplayContent (blocks) so every host (Electron shell, VS Code shell) renders
+// the same thing inside the message bubble; non-UI clients still get the
+// auto-derived markdown/text fallback.
+
+import type { DisplayContent, StructuredBlock } from "@typeagent/agent-sdk";
+import { createStructuredContent } from "@typeagent/agent-sdk/helpers/display";
+import type { ConversationActionResult } from "./manage.js";
+
+// Bold quoted names for the markdown text blocks - parity with the shells'
+// previous HTML that bolded quoted conversation names.
+function boldQuoted(message: string): string {
+    return message.replace(/"([^"]+)"/g, (_, name) => `**${name}**`);
+}
+
+export function renderConversationActionResult(
+    result: ConversationActionResult,
+): DisplayContent {
+    switch (result.kind) {
+        case "ok":
+            return createStructuredContent([
+                { kind: "text", text: boldQuoted(result.message) },
+            ]);
+        case "warning":
+            return createStructuredContent(
+                [{ kind: "text", text: boldQuoted(result.message) }],
+                { kind: "warning" },
+            );
+        case "error":
+            return createStructuredContent(
+                [{ kind: "text", text: boldQuoted(result.message) }],
+                { kind: "error" },
+            );
+        case "cancelled":
+            return createStructuredContent([
+                { kind: "text", text: "Cancelled." },
+            ]);
+        case "info":
+            return createStructuredContent([
+                { kind: "heading", level: 3, text: "Current conversation" },
+                {
+                    kind: "keyValue",
+                    pairs: [
+                        { label: "Name", value: result.name },
+                        { label: "Id", value: result.conversationId },
+                    ],
+                },
+            ]);
+        case "list": {
+            if (result.conversations.length === 0) {
+                return createStructuredContent([
+                    { kind: "text", text: "No conversations found." },
+                ]);
+            }
+            const items = result.conversations.map((c) => {
+                const created = new Date(c.createdAt).toLocaleDateString();
+                const messages = `${c.messageCount} message${
+                    c.messageCount === 1 ? "" : "s"
+                }`;
+                const clients = `${c.clientCount} client${
+                    c.clientCount === 1 ? "" : "s"
+                }`;
+                const isCurrent =
+                    c.conversationId === result.currentConversationId;
+                return {
+                    text: isCurrent ? `${c.name} (current)` : c.name,
+                    subtitle: `${messages} · ${clients} · created ${created}`,
+                };
+            });
+            const blocks: StructuredBlock[] = [
+                {
+                    kind: "heading",
+                    level: 3,
+                    text: `Conversations (${result.conversations.length})`,
+                },
+                { kind: "list", items },
+            ];
+            return createStructuredContent(blocks);
+        }
+    }
+}
diff --git a/ts/packages/agentServer/client/test/conversation-manage.spec.ts b/ts/packages/agentServer/client/test/conversation-manage.spec.ts
index f2220afd7a..00a84e8620 100644
--- a/ts/packages/agentServer/client/test/conversation-manage.spec.ts
+++ b/ts/packages/agentServer/client/test/conversation-manage.spec.ts
@@ -682,7 +682,7 @@ describe("manageNew — collision against current", () => {
 });
 
 describe("manageRename — result fidelity", () => {
-    test("returned conversation preserves real createdAt + clientCount", async () => {
+    test("returned conversation preserves real createdAt + clientCount + messageCount", async () => {
         const conn = makeStubConnection({
             list: [
                 {
@@ -690,6 +690,7 @@ describe("manageRename — result fidelity", () => {
                     name: "Old",
                     createdAt: "2026-05-15T10:00:00Z",
                     clientCount: 7,
+                    messageCount: 42,
                 },
             ],
         });
@@ -706,6 +707,7 @@ describe("manageRename — result fidelity", () => {
         if (result.kind === "ok" && result.conversation) {
             expect(result.conversation.createdAt).toBe("2026-05-15T10:00:00Z");
             expect(result.conversation.clientCount).toBe(7);
+            expect(result.conversation.messageCount).toBe(42);
             // and the new Date parse works (no Invalid Date corruption)
             expect(
                 isNaN(new Date(result.conversation.createdAt).getTime()),
diff --git a/ts/packages/agentServer/client/test/conversation-render.spec.ts b/ts/packages/agentServer/client/test/conversation-render.spec.ts
new file mode 100644
index 0000000000..ad9cbbb93a
--- /dev/null
+++ b/ts/packages/agentServer/client/test/conversation-render.spec.ts
@@ -0,0 +1,51 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+import { renderConversationActionResult } from "../src/conversation/render.js";
+import type { ConversationActionResult } from "../src/conversation/manage.js";
+
+// The renderer returns structured DisplayContent; serialize it so tests can
+// assert on the rendered text without coupling to the block shape.
+function render(result: ConversationActionResult): string {
+    return JSON.stringify(renderConversationActionResult(result));
+}
+
+describe("renderConversationActionResult — list", () => {
+    test("shows a per-conversation message count, pluralized", () => {
+        const json = render({
+            kind: "list",
+            currentConversationId: "id2",
+            conversations: [
+                {
+                    conversationId: "id1",
+                    name: "Alpha",
+                    clientCount: 0,
+                    createdAt: "2026-01-01T00:00:00Z",
+                    messageCount: 1,
+                },
+                {
+                    conversationId: "id2",
+                    name: "Beta",
+                    clientCount: 1,
+                    createdAt: "2026-01-02T00:00:00Z",
+                    messageCount: 5,
+                },
+            ],
+        });
+
+        expect(json).toContain("Conversations (2)");
+        expect(json).toContain("1 message");
+        expect(json).toContain("5 messages");
+        // The current conversation is marked.
+        expect(json).toContain("Beta (current)");
+    });
+
+    test("empty list renders a friendly message", () => {
+        const json = render({
+            kind: "list",
+            currentConversationId: undefined,
+            conversations: [],
+        });
+        expect(json).toContain("No conversations found.");
+    });
+});
diff --git a/ts/packages/agentServer/client/test/conversation-stubConnection.ts b/ts/packages/agentServer/client/test/conversation-stubConnection.ts
index 895a0b4757..43eb11684a 100644
--- a/ts/packages/agentServer/client/test/conversation-stubConnection.ts
+++ b/ts/packages/agentServer/client/test/conversation-stubConnection.ts
@@ -19,8 +19,9 @@ export function makeInfo(
     name: string,
     createdAt: string = "2026-01-01T00:00:00Z",
     clientCount: number = 0,
+    messageCount: number = 0,
 ): ConversationInfo {
-    return { conversationId: id, name, createdAt, clientCount };
+    return { conversationId: id, name, createdAt, clientCount, messageCount };
 }
 
 export type StubCallLog = {
diff --git a/ts/packages/agentServer/protocol/README.AUTOGEN.md b/ts/packages/agentServer/protocol/README.AUTOGEN.md
index b79c03f0ef..9e6d6c8cab 100644
--- a/ts/packages/agentServer/protocol/README.AUTOGEN.md
+++ b/ts/packages/agentServer/protocol/README.AUTOGEN.md
@@ -3,7 +3,7 @@
 
 <!-- AUTOGEN:DOCS:START -->
 
-<!-- AUTOGEN:DOCS:HASH:sha256=fef7634b164bd54acb738dccddc0cb5aa490ec25f7e41f918d72ff96613dfe12 -->
+<!-- AUTOGEN:DOCS:HASH:sha256=ec0830ad5c7adc5d1867cda02358ddc00669f5db2c9553be8b0ba9f6c485dbae -->
 <!-- AUTOGEN:DOCS:SOURCE: ./README.md (hand-written documentation; this file is the AI-generated companion) -->
 
 # @typeagent/agent-server-protocol — AI-generated documentation
@@ -12,39 +12,38 @@
 
 ## Overview
 
-The `@typeagent/agent-server-protocol` package defines the WebSocket RPC contract between the agentServer and its clients. It provides the necessary types, channel names, and methods for managing conversations, client connections, and discovery mechanisms within the TypeAgent Server ecosystem.
+The `@typeagent/agent-server-protocol` package defines the WebSocket RPC protocol used by the TypeAgent Server and its clients. It provides the foundational types, channel names, and methods required for managing conversations, client connections, and discovery mechanisms within the TypeAgent ecosystem.
 
-## What it does
+This package is a core dependency for various components, including the `agent-server`, `agent-server-client`, and other TypeAgent-based agents and extensions. It ensures consistent communication patterns and data structures across the system.
 
-This package acts as the communication protocol layer for the agentServer and its clients. It standardizes the interaction between components in the TypeAgent ecosystem by defining:
+## What it does
 
-- **Channel Definitions**: Includes fixed channel names for conversation lifecycle and discovery RPC, as well as session-namespaced channel names for dispatcher and client IO communication.
-- **Conversation Metadata**: Provides types and structures such as `ConversationInfo` and `JoinConversationResult` to describe conversations and their participants.
-- **RPC Methods**: Implements methods for managing conversations, including `joinConversation`, `createConversation`, `listConversations`, `renameConversation`, and `deleteConversation`.
-- **Client-Type Registry**: Offers utilities to register, retrieve, and manage client types based on connection IDs, enabling client-specific behavior.
-- **Discovery Mechanism**: Exposes a read-only RPC channel for external clients to discover live ports of in-process app-agents.
+The package standardizes the communication between the agentServer and its clients by defining:
 
-This package is a core dependency for several other components in the TypeAgent ecosystem, such as `agent-server`, `agent-server-client`, and various extensions like VS Code and browser-based agents.
+- **Channel Names**: Fixed and session-namespaced channel names for conversation lifecycle and discovery RPC.
+- **Conversation Management**: Types and methods for creating, joining, renaming, deleting, and listing conversations.
+- **Client-Type Registry**: Utilities for registering, retrieving, and managing client types based on connection IDs.
+- **Discovery Mechanism**: A read-only RPC channel for external clients to discover live ports of in-process app-agents.
 
 ### Key Features
 
-1. **Channel Names**:
+1. **Channel Definitions**:
 
    - `AgentServerChannelName`: A fixed channel for conversation lifecycle RPC.
    - `DiscoveryChannelName`: A fixed channel for read-only port discovery.
    - Helper functions like `getDispatcherChannelName` and `getClientIOChannelName` to construct session-namespaced channels.
 
-2. **Conversation Management**:
+2. **Conversation Metadata**:
 
-   - Types such as `ConversationInfo` and `JoinConversationResult` provide structured data about conversations and their participants.
-   - RPC methods allow for creating, joining, renaming, and deleting conversations, as well as listing all active conversations.
+   - Types such as `ConversationInfo` and `JoinConversationResult` describe conversations and their participants.
+   - Methods like `joinConversation`, `createConversation`, `renameConversation`, and `deleteConversation` manage conversations.
 
 3. **Discovery Channel**:
 
-   - The `lookupPort` method enables external clients to query the live port of app-agents, facilitating dynamic connection management.
+   - The `lookupPort` method allows external clients to query the live port of app-agents, facilitating dynamic connection management.
 
 4. **Client-Type Registry**:
-   - Functions like `registerClientType`, `getClientType`, and `unregisterClient` allow the server to track and manage client types based on their connection IDs.
+   - Functions like `registerClientType`, `getClientType`, and `unregisterClient` enable the server to track and manage client types based on their connection IDs.
 
 ## Setup
 
@@ -54,16 +53,15 @@ This package does not require any special setup beyond installation. To include
 pnpm install
 ```
 
-For additional details on usage, refer to the hand-written README.
+For details on usage, refer to the hand-written README.
 
 ## Key Files
 
-The package is structured into several key files, each with a specific role in defining and implementing the protocol:
+The package is organized into several key files, each serving a specific purpose in defining and implementing the protocol:
 
 - **[index.ts](./src/index.ts)**: The main entry point, re-exporting all types, constants, and functions from other files.
 - **[protocol.ts](./src/protocol.ts)**: Contains the core protocol definitions, including channel names, conversation types, and RPC methods.
 - **[queue.ts](./src/queue.ts)**: Re-exports queue-related types and errors from `@typeagent/dispatcher-types` for use by clients.
-- **[tsconfig.json](./src/tsconfig.json)**: TypeScript configuration for the package.
 
 ### File Responsibilities
 
@@ -89,7 +87,7 @@ To extend the functionality of this package, follow these steps:
 
 1. **Understand the Existing Structure**:
 
-   - Begin by reviewing the `protocol.ts` file, which contains the core protocol definitions and RPC methods.
+   - Review the `protocol.ts` file for core protocol definitions and RPC methods.
    - Familiarize yourself with the exported types and functions in `index.ts`.
 
 2. **Add New Features**:
@@ -123,6 +121,8 @@ By following these steps, you can ensure that your contributions align with the
 
 Workspace:
 
+- [@typeagent/agent-rpc](../../../packages/agentRpc/README.md)
+- [@typeagent/agent-sdk](../../../packages/agentSdk/README.md)
 - [@typeagent/dispatcher-rpc](../../../packages/dispatcher/rpc/README.md)
 - [@typeagent/dispatcher-types](../../../packages/dispatcher/types/README.md)
 
@@ -131,10 +131,11 @@ External: _None at runtime._
 ### Used by
 
 - [@typeagent/agent-server-client](../../../packages/agentServer/client/README.md)
+- [@typeagent/browser](../../../packages/agents/browser/README.md)
+- [@typeagent/browser-extension](../../../packages/agents/browserExtension/README.md)
 - [agent-coda](../../../packages/coda/README.md)
 - [agent-server](../../../packages/agentServer/server/README.md)
 - [agent-shell](../../../packages/shell/README.md)
-- [browser-typeagent](../../../packages/agents/browser/README.md)
 - [remote-client-example](../../../examples/remoteClient/README.md)
 - visualstudio-extension-webview
 - [vscode-chat](../../../packages/vscode-chat/README.md)
@@ -146,6 +147,6 @@ External: _None at runtime._
 
 ---
 
-_Auto-generated against commit `b1b5bcafdde8ba2387d669eec198eb70e8fa5986` on `2026-07-17T23:52:55.795Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter @typeagent/agent-server-protocol docs:verify-links` to spot-check._
+_Auto-generated against commit `5018562335eded84b16dedcbb8e86d59b538a978` on `2026-07-30T06:29:20.146Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter @typeagent/agent-server-protocol docs:verify-links` to spot-check._
 
 <!-- AUTOGEN:DOCS:END -->
diff --git a/ts/packages/agentServer/protocol/src/protocol.ts b/ts/packages/agentServer/protocol/src/protocol.ts
index 3b847c6645..a3cc46d0ce 100644
--- a/ts/packages/agentServer/protocol/src/protocol.ts
+++ b/ts/packages/agentServer/protocol/src/protocol.ts
@@ -24,6 +24,12 @@ export type ConversationInfo = {
     name: string;
     clientCount: number;
     createdAt: string; // ISO 8601
+    /**
+     * Number of user requests recorded in the conversation's display log - a
+     * rough measure of how much activity it holds. Computed server-side; 0 for
+     * a brand-new conversation.
+     */
+    messageCount: number;
     /**
      * Where this conversation came from. Omitted for native TypeAgent
      * conversations; set to `"copilot"` for imported mirrors. Clients use it to
diff --git a/ts/packages/agentServer/server/README.AUTOGEN.md b/ts/packages/agentServer/server/README.AUTOGEN.md
index 2ecbea693b..692259cc68 100644
--- a/ts/packages/agentServer/server/README.AUTOGEN.md
+++ b/ts/packages/agentServer/server/README.AUTOGEN.md
@@ -3,7 +3,7 @@
 
 <!-- AUTOGEN:DOCS:START -->
 
-<!-- AUTOGEN:DOCS:HASH:sha256=da07518a7a40888acd4d6c8bc2bd3e95c7e667e7d15dd45326a7d6e52a75406f -->
+<!-- AUTOGEN:DOCS:HASH:sha256=699a22cf38727f060a3bc2436869a1c983600c3824d3a05c3033b36870e7953f -->
 <!-- AUTOGEN:DOCS:SOURCE: ./README.md (hand-written documentation; this file is the AI-generated companion) -->
 
 # agent-server — AI-generated documentation
@@ -12,7 +12,7 @@
 
 ## Overview
 
-The `agent-server` package is a TypeScript library that implements a long-running WebSocket server for hosting TypeAgent dispatchers. It acts as the central hub for managing client connections, orchestrating conversations, and facilitating communication between clients and agents. The server supports multiple clients and conversations simultaneously, with features such as conversation persistence, idle timeouts, and ephemeral conversation cleanup.
+The `agent-server` package is a TypeScript library that implements a long-running WebSocket server for hosting TypeAgent dispatchers. It serves as the central hub for managing client connections, orchestrating conversations, and facilitating communication between clients and agents. The server supports multiple clients and conversations simultaneously, with features such as conversation persistence, idle timeouts, and ephemeral conversation cleanup.
 
 ## What it does
 
@@ -171,6 +171,6 @@ _9 environment variables referenced from `./src/` (set in `ts/.env` or your shel
 
 ---
 
-_Auto-generated against commit `fa4bb9b44db12e2d15b83e03e59f9c7147ed2b50` on `2026-07-27T19:08:36.121Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter agent-server docs:verify-links` to spot-check._
+_Auto-generated against commit `5018562335eded84b16dedcbb8e86d59b538a978` on `2026-07-30T06:29:20.146Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter agent-server docs:verify-links` to spot-check._
 
 <!-- AUTOGEN:DOCS:END -->
diff --git a/ts/packages/agentServer/server/src/conversationManager.ts b/ts/packages/agentServer/server/src/conversationManager.ts
index 10322b8252..2749e57603 100644
--- a/ts/packages/agentServer/server/src/conversationManager.ts
+++ b/ts/packages/agentServer/server/src/conversationManager.ts
@@ -151,7 +151,7 @@ export type ConversationManager = {
         conversationId: string,
         connectionId: string,
     ): Promise<void>;
-    listConversations(name?: string): ConversationInfo[];
+    listConversations(name?: string): Promise<ConversationInfo[]>;
     renameConversation(
         conversationId: string,
         newName: string,
@@ -366,6 +366,33 @@ export async function createConversationManager(
         return path.join(conversationsDir, conversationId);
     }
 
+    // Count the user requests recorded in a conversation's persisted display
+    // log. Reads from disk so idle conversations (no live dispatcher) report a
+    // count too; the log is flushed after each turn, so this trails by at most
+    // the in-flight request. Returns 0 when the log is missing or unreadable.
+    async function countUserMessages(conversationId: string): Promise<number> {
+        const filePath = path.join(
+            getConversationPersistDir(conversationId),
+            DISPLAY_LOG_FILE_NAME,
+        );
+        try {
+            const data = await fs.promises.readFile(filePath, "utf-8");
+            const parsed = JSON.parse(data);
+            if (!Array.isArray(parsed)) {
+                return 0;
+            }
+            let count = 0;
+            for (const entry of parsed as DisplayLogEntry[]) {
+                if (entry?.type === "user-request") {
+                    count++;
+                }
+            }
+            return count;
+        } catch {
+            return 0;
+        }
+    }
+
     function ensureDispatcher(
         record: ConversationRecord,
     ): Promise<SharedDispatcher> {
@@ -631,6 +658,7 @@ export async function createConversationManager(
                 name: resolvedName,
                 clientCount: 0,
                 createdAt,
+                messageCount: 0,
             };
         },
 
@@ -893,7 +921,7 @@ export async function createConversationManager(
             );
         },
 
-        listConversations(name?: string): ConversationInfo[] {
+        async listConversations(name?: string): Promise<ConversationInfo[]> {
             const result: ConversationInfo[] = [];
             for (const record of conversations.values()) {
                 const recordName = record.name ?? "";
@@ -908,6 +936,9 @@ export async function createConversationManager(
                     name: recordName,
                     clientCount: record.sharedDispatcher?.clientCount ?? 0,
                     createdAt: record.createdAt,
+                    messageCount: await countUserMessages(
+                        record.conversationId,
+                    ),
                     ...(record.source !== undefined
                         ? { source: record.source }
                         : {}),
diff --git a/ts/packages/agentServer/server/test/conversationManager.spec.ts b/ts/packages/agentServer/server/test/conversationManager.spec.ts
index 51b15a5beb..5ea6725b0c 100644
--- a/ts/packages/agentServer/server/test/conversationManager.spec.ts
+++ b/ts/packages/agentServer/server/test/conversationManager.spec.ts
@@ -111,9 +111,9 @@ describe("ConversationManager renameConversation", () => {
         });
 
         expect(
-            manager
-                .listConversations()
-                .find((c) => c.conversationId === target.conversationId)?.name,
+            (await manager.listConversations()).find(
+                (c) => c.conversationId === target.conversationId,
+            )?.name,
         ).toBe("Project (6)");
         await manager.close();
     });
@@ -148,9 +148,9 @@ describe("ConversationManager renameConversation", () => {
         });
 
         expect(
-            manager
-                .listConversations()
-                .find((c) => c.conversationId === target.conversationId)?.name,
+            (await manager.listConversations()).find(
+                (c) => c.conversationId === target.conversationId,
+            )?.name,
         ).toBe("Project");
         await manager.close();
     });
diff --git a/ts/packages/agentServer/server/test/copilotImport.spec.ts b/ts/packages/agentServer/server/test/copilotImport.spec.ts
index 07c34aafa8..a25fec0e0b 100644
--- a/ts/packages/agentServer/server/test/copilotImport.spec.ts
+++ b/ts/packages/agentServer/server/test/copilotImport.spec.ts
@@ -469,12 +469,15 @@ describe("importCopilotSessions", () => {
             expect(result.imported).toBe(1);
             expect(result.skipped).toBe(0);
 
-            const conversations = manager.listConversations();
+            const conversations = await manager.listConversations();
             expect(conversations).toHaveLength(1);
             const mirror = conversations[0];
             expect(mirror.source).toBe("copilot");
             expect(mirror.readOnly).toBe(true);
             expect(mirror.name).toBe("add a login form");
+            // Message count is derived from the synthesized display log: one
+            // user-request per imported Copilot turn (this session has two).
+            expect(mirror.messageCount).toBe(2);
 
             // Display log persisted for normal replay on join.
             const logPath = path.join(
@@ -549,7 +552,7 @@ describe("importCopilotSessions", () => {
             expect(second.skipped).toBe(2);
 
             // Still exactly two conversations, no duplicates.
-            expect(manager.listConversations()).toHaveLength(2);
+            expect(await manager.listConversations()).toHaveLength(2);
         } finally {
             await manager.close();
         }
@@ -570,7 +573,7 @@ describe("importCopilotSessions", () => {
             const result = await importCopilotSessions(manager, { dbPath });
             expect(result.total).toBe(1);
             expect(result.imported).toBe(0);
-            expect(manager.listConversations()).toHaveLength(0);
+            expect(await manager.listConversations()).toHaveLength(0);
         } finally {
             await manager.close();
         }
@@ -620,7 +623,7 @@ describe("importCopilotMirror title reconciliation", () => {
             expect(second.conversationId).toBe(first.conversationId);
             expect(second.name).toBe("Branch change summary");
 
-            const conversations = manager.listConversations();
+            const conversations = await manager.listConversations();
             expect(conversations).toHaveLength(1);
             expect(conversations[0].name).toBe("Branch change summary");
         } finally {
diff --git a/ts/packages/agents/code/README.AUTOGEN.md b/ts/packages/agents/code/README.AUTOGEN.md
index 7aeab956f7..e556cb0bb3 100644
--- a/ts/packages/agents/code/README.AUTOGEN.md
+++ b/ts/packages/agents/code/README.AUTOGEN.md
@@ -3,20 +3,20 @@
 
 <!-- AUTOGEN:DOCS:START -->
 
-<!-- AUTOGEN:DOCS:HASH:sha256=dd198ff53607a677a579f0cca2add29021d07462af9f5e672fb5c9e1e9f3eeb6 -->
+<!-- AUTOGEN:DOCS:HASH:sha256=875a9ba71f7159b20afff0a1f7eb08f3d629d5c93a71d166bac8248b42ddb1a3 -->
 <!-- AUTOGEN:DOCS:SOURCE: ./README.md (hand-written documentation; this file is the AI-generated companion) -->
 
-# code-agent — AI-generated documentation
+# @typeagent/code-agent — AI-generated documentation
 
 > 🤖 **AI-authored documentation**, regenerated daily and validated for length, tone, and link integrity. Cross-check against the deterministic Reference section below before relying on specifics. Hand-written context from [`./README.md`](./README.md) was provided to the model as authoritative source. May lag the working tree by up to 24h — see the staleness footer at the end of this file.
 
 ## Overview
 
-The `code-agent` package is a TypeAgent application agent designed to automate tasks in Visual Studio Code (VSCode). It acts as a dispatcher for code-related actions, enabling users to interact with VSCode through natural language commands. This agent integrates with the [coda](../../coda/README.md) VSCode extension, which must be deployed for the `code-agent` to function. The agent is not enabled by default and requires explicit configuration to activate.
+The `@typeagent/code-agent` package is a TypeAgent application agent designed to automate tasks in Visual Studio Code (VSCode). It enables users to interact with VSCode through natural language commands, facilitating workflows such as launching the editor, managing files, and customizing the development environment. This agent integrates with the [coda](../../coda/README.md) VSCode extension, which must be deployed for the `code-agent` to function. The agent is not enabled by default and requires explicit configuration to activate.
 
 ## What it does
 
-The `code-agent` currently implements the `launchVSCode` action, which allows users to launch or start VSCode in different modes:
+The `code-agent` currently implements the `launchVSCode` action, which allows users to start or open VSCode in various modes:
 
 - **last**: Opens the last session.
 - **folder**: Opens a specific folder (requires a `path` parameter).
@@ -121,9 +121,9 @@ Workspace:
 - [@typeagent/action-grammar-compiler](../../../packages/actionGrammarCompiler/README.md)
 - [@typeagent/action-schema-compiler](../../../packages/actionSchemaCompiler/README.md)
 - [@typeagent/agent-sdk](../../../packages/agentSdk/README.md)
+- [@typeagent/telemetry](../../../packages/telemetry/README.md)
+- [@typeagent/websocket-channel-server](../../../packages/utils/webSocketChannelServer/README.md)
 - [@typeagent/websocket-utils](../../../packages/utils/webSocketUtils/README.md)
-- [telemetry](../../../packages/telemetry/README.md)
-- [websocket-channel-server](../../../packages/utils/webSocketChannelServer/README.md)
 
 External: `better-sqlite3`, `chalk`, `debug`, `ws`
 
@@ -150,7 +150,7 @@ _1 environment variable referenced from `./src/` (set in `ts/.env` or your shell
 
 ### Actions
 
-_1 action implemented by this agent, parsed deterministically from `./src/codeActionsSchema.ts`. Sample utterances and parameter shapes are illustrative; consult the schema for the full signature. 12 additional actions are declared in the schema but not yet implemented; not shown._
+_1 action implemented by this agent, parsed deterministically from `./src/codeActionsSchema.ts`. Sample utterances and parameter shapes are illustrative; consult the schema for the full signature. 13 additional actions are declared in the schema but not yet implemented; not shown._
 
 | User says                | Action                                |
 | ------------------------ | ------------------------------------- |
@@ -158,6 +158,6 @@ _1 action implemented by this agent, parsed deterministically from `./src/codeAc
 
 ---
 
-_Auto-generated against commit `6bea19a9ee02598644b1ac3ab67c705dcc495832` on `2026-07-22T11:19:17.632Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter code-agent docs:verify-links` to spot-check._
+_Auto-generated against commit `5a7bdd3625eef42d75702c9fd9f0dadb7cb10410` on `2026-07-29T05:15:39.538Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter @typeagent/code-agent docs:verify-links` to spot-check._
 
 <!-- AUTOGEN:DOCS:END -->
diff --git a/ts/packages/agents/code/src/codeActionsSchema.ts b/ts/packages/agents/code/src/codeActionsSchema.ts
index bb49f44f97..5980b86cea 100644
--- a/ts/packages/agents/code/src/codeActionsSchema.ts
+++ b/ts/packages/agents/code/src/codeActionsSchema.ts
@@ -13,7 +13,8 @@ export type CodeActions =
     | GetDiagnosticsAction
     | ListOpenEditorsAction
     | GetFileContentAction
-    | GetWorkspaceChangesAction;
+    | GetWorkspaceChangesAction
+    | LaunchCopilotChatAction;
 
 export type CodeActivity = LaunchVSCodeAction;
 
@@ -26,6 +27,31 @@ export type LaunchVSCodeAction = {
     };
 };
 
+// Launch a new chat window with GitHub Copilot, Claude, or other chat providers
+// This creates a new chat session in the specified location.
+export type LaunchCopilotChatAction = {
+    actionName: "launchCopilotChat";
+    parameters: {
+        // Optional initial query/prompt to send to the chat
+        query?: string;
+        // Chat provider: "copilot" (GitHub Copilot, default), "claude" (Claude/Anthropic),
+        // "gpt" (ChatGPT/OpenAI), or "generic" for any available chat extension
+        provider?: "copilot" | "claude" | "gpt" | "generic";
+        // Where to open the new session: "window" (new chat window, default),
+        // "editor" (new chat editor in editor area), or "view" (chat panel/side view)
+        newSessionLocation?: "window" | "editor" | "view";
+        // Copilot chat mode: "agent" (can edit workspace) or "ask" (conversational only)
+        // Note: not all providers support all modes
+        mode?: "agent" | "ask";
+        // Whether to pre-fill but not auto-submit the query
+        isPartialQuery?: boolean;
+        // Whether to attach a screenshot of focused VS Code window
+        attachScreenshot?: boolean;
+        // Absolute paths to files to attach to the chat request
+        attachFiles?: string[];
+    };
+};
+
 export type ColorTheme =
     | "Default Light+"
     | "Default Dark+"
diff --git a/ts/packages/agents/code/src/codeSchema.agr b/ts/packages/agents/code/src/codeSchema.agr
index cdae40ae24..6aa9bd88a7 100644
--- a/ts/packages/agents/code/src/codeSchema.agr
+++ b/ts/packages/agents/code/src/codeSchema.agr
@@ -17,7 +17,8 @@ import { CodeActions, CodeActivity } from "./codeActionsSchema.ts";
   | <newCodeFile>
   | <newMarkdownFile>
   | <newTextFile>
-  | <launchVSCode>;
+  | <launchVSCode>
+  | <launchCopilotChat>;
 
 // Theme name sub-rule — maps user-friendly tokens to canonical TS ColorTheme
 // literals. ColorTheme members contain '+' which isn't a valid literal token
@@ -95,4 +96,24 @@ import { CodeActions, CodeActivity } from "./codeActionsSchema.ts";
 <launchVSCode> = <Polite> ('launch' | 'open' | 'start') ('vs code' | 'vscode' | 'code') ('in')? $(mode:<LaunchMode>) ('mode')? ('at' | 'with' | 'for')? $(path:string) -> { actionName: "launchVSCode", parameters: { mode: mode, path: path } }
   | <Polite> ('launch' | 'open' | 'start') ('vs code' | 'vscode' | 'code') ('in')? $(mode:<LaunchMode>) ('mode')? -> { actionName: "launchVSCode", parameters: { mode: mode } };
 
+// Chat location — where to open the chat window
+<ChatLocation> = 'window' -> "window"
+  | ('view' | 'panel' | 'side') -> "view"
+  | 'editor' -> "editor";
+
+// Chat provider — which chat service to open
+<ChatProvider> = ('copilot' | 'github copilot' | 'gh copilot') -> "copilot"
+  | ('claude' | 'anthropic') -> "claude"
+  | ('chatgpt' | 'gpt' | 'openai') -> "gpt"
+  | ('chat' | 'ai') -> "generic";
+
+// Launch a new chat window
+// Examples: "create a new chat window", "open claude in a new window", "launch chat in the editor"
+<launchCopilotChat> = <Polite> ('create' | 'open' | 'launch' | 'start') ('a')? ('new')? $(provider:<ChatProvider>) ('chat' | 'chat session' | 'chat window') -> { actionName: "launchCopilotChat", parameters: { provider: provider, newSessionLocation: "window" } }
+  | <Polite> ('create' | 'open' | 'launch' | 'start') ('a')? ('new')? $(provider:<ChatProvider>) ('chat' | 'chat session' | 'chat window') ('in' | 'in a' | 'in the') $(location:<ChatLocation>) -> { actionName: "launchCopilotChat", parameters: { provider: provider, newSessionLocation: location } }
+  | <Polite> ('create' | 'open' | 'launch' | 'start') ('a')? ('new')? ('chat' | 'chat session' | 'chat window') ('for' | 'with') $(provider:<ChatProvider>) -> { actionName: "launchCopilotChat", parameters: { provider: provider, newSessionLocation: "window" } }
+  | <Polite> ('create' | 'open' | 'launch' | 'start') ('a')? ('new')? ('chat' | 'chat session' | 'chat window') ('for' | 'with') $(provider:<ChatProvider>) ('in' | 'in a' | 'in the') $(location:<ChatLocation>) -> { actionName: "launchCopilotChat", parameters: { provider: provider, newSessionLocation: location } }
+  | <Polite> ('create' | 'open' | 'launch' | 'start') ('a')? ('new')? ('copilot')? ('chat' | 'chat session' | 'chat window') -> { actionName: "launchCopilotChat", parameters: { newSessionLocation: "window" } }
+  | <Polite> ('create' | 'open' | 'launch' | 'start') ('a')? ('new')? ('copilot')? ('chat' | 'chat session' | 'chat window') ('in' | 'in a' | 'in the') $(location:<ChatLocation>) -> { actionName: "launchCopilotChat", parameters: { newSessionLocation: location } };
+
 <Polite> = ("can you" | "please" | "would you" | "i need" | "let's")?;
diff --git a/ts/packages/agents/github-cli/README.AUTOGEN.md b/ts/packages/agents/github-cli/README.AUTOGEN.md
index ff46a1eff7..f598e25662 100644
--- a/ts/packages/agents/github-cli/README.AUTOGEN.md
+++ b/ts/packages/agents/github-cli/README.AUTOGEN.md
@@ -3,24 +3,24 @@
 
 <!-- AUTOGEN:DOCS:START -->
 
-<!-- AUTOGEN:DOCS:HASH:sha256=4b0feb11883126073ede9b05521cba1dd3e0849974ad2afc44df61226fe17c37 -->
+<!-- AUTOGEN:DOCS:HASH:sha256=88a77c57bb6ad0162fbc75606a58139d13ff1c8c020e52460d1ae4eb7c69cdb9 -->
 <!-- AUTOGEN:DOCS:SOURCE: ./README.md (hand-written documentation; this file is the AI-generated companion) -->
 
-# github-cli-agent — AI-generated documentation
+# @typeagent/github-cli-agent — AI-generated documentation
 
 > 🤖 **AI-authored documentation**, regenerated daily and validated for length, tone, and link integrity. Cross-check against the deterministic Reference section below before relying on specifics. Hand-written context from [`./README.md`](./README.md) was provided to the model as authoritative source. May lag the working tree by up to 24h — see the staleness footer at the end of this file.
 
 ## Overview
 
-The `github-cli-agent` is a TypeAgent application agent that integrates with the GitHub CLI (`gh`) to enable natural language-driven interactions with GitHub. It provides a wide range of actions for managing repositories, issues, pull requests, workflows, and other GitHub features. By leveraging the GitHub CLI, the agent simplifies complex GitHub operations into intuitive commands.
+The `@typeagent/github-cli-agent` is a TypeAgent application agent designed to interface with the GitHub CLI (`gh`). It enables natural language-driven interactions with GitHub, allowing users to perform a wide range of GitHub operations such as managing repositories, issues, pull requests, workflows, and more. By leveraging the GitHub CLI, this agent simplifies complex GitHub tasks into intuitive, user-friendly commands.
 
 ## What it does
 
-The `github-cli-agent` supports 65 actions, grouped into the following categories:
+The `github-cli-agent` supports 66 actions, grouped into several categories:
 
-- **Authentication**: Manage GitHub authentication with actions like `authLogin`, `authLogout`, and `authStatus`. These actions allow users to log in, log out, and check their authentication status.
-- **Issues**: Create, close, reopen, delete, list, and view issues using actions such as `issueCreate`, `issueClose`, `issueReopen`, `issueDelete`, `issueList`, and `issueView`.
-- **Pull Requests**: Handle pull request workflows with actions like `prCreate`, `prClose`, `prMerge`, `prList`, `prView`, and `prCheckout`. These actions support creating, managing, and reviewing pull requests.
+- **Authentication**: Actions like `authLogin`, `authLogout`, and `authStatus` allow users to manage their GitHub authentication, including logging in, logging out, and checking the current authentication status.
+- **Issues**: Manage GitHub issues with actions such as `issueCreate`, `issueClose`, `issueReopen`, `issueDelete`, `issueList`, and `issueView`. These actions cover the full lifecycle of an issue, from creation to closure.
+- **Pull Requests**: Handle pull request workflows with actions like `prCreate`, `prClose`, `prMerge`, `prList`, `prView`, and `prCheckout`. These actions support creating, managing, and reviewing pull requests, including draft PRs and merging.
 - **Repositories**: Perform repository-related tasks with actions such as `repoCreate`, `repoClone`, `repoDelete`, `repoView`, `repoFork`, `starRepo`, and `searchRepos`. These actions allow users to manage repositories and retrieve specific information about them.
 - **Codespaces**: Manage GitHub Codespaces with actions like `codespaceCreate`, `codespaceDelete`, and `codespaceList`.
 - **Gists**: Create, delete, and list gists using `gistCreate`, `gistDelete`, and `gistList`.
@@ -35,7 +35,7 @@ The agent enhances usability by providing features such as clickable hyperlinks
 
 ## Setup
 
-To use the `github-cli-agent`, you need to complete the following setup steps:
+To use the `@typeagent/github-cli-agent`, follow these setup steps:
 
 1. **Install the GitHub CLI**: Download and install the GitHub CLI from `https://cli.github.com/`. Ensure it is available in your system's `PATH`.
 2. **Authenticate with GitHub**: Run `gh auth login` to authenticate with your GitHub account. This step is required for the agent to interact with GitHub on your behalf.
@@ -44,7 +44,7 @@ The agent performs a `gh auth status` readiness check at startup and before exec
 
 ## Key Files
 
-The `github-cli-agent` is organized into several key files that define its behavior and functionality:
+The `@typeagent/github-cli-agent` is structured around several key files that define its behavior and functionality:
 
 - **[github-cliManifest.json](./src/github-cliManifest.json)**: Contains metadata about the agent, including its description, emoji, and schema details.
 - **[github-cliSchema.ts](./src/github-cliSchema.ts)**: Defines the types and parameters for all supported actions. This file is the source of truth for the agent's capabilities.
@@ -56,7 +56,7 @@ These files work together to define the agent's capabilities, interpret user inp
 
 ## How to extend
 
-To add new functionality to the `github-cli-agent`, follow these steps:
+To add new functionality to the `@typeagent/github-cli-agent`, follow these steps:
 
 1. **Define the new action**:
 
@@ -80,7 +80,7 @@ To add new functionality to the `github-cli-agent`, follow these steps:
    - Update the grammar file ([github-cliSchema.agr](./src/github-cliSchema.agr)) with sample utterances for the new action.
    - Verify that the deterministic documentation generation process includes the new action.
 
-By following these steps, you can extend the `github-cli-agent` to support additional GitHub CLI commands or custom workflows.
+By following these steps, you can extend the `@typeagent/github-cli-agent` to support additional GitHub CLI commands or custom workflows.
 
 ## Reference
 
@@ -118,44 +118,44 @@ External: _None at runtime._
 
 ### Actions
 
-_65 actions implemented by this agent, parsed deterministically from `./src/github-cliSchema.ts`. Sample utterances and parameter shapes are illustrative; consult the schema for the full signature._
-
-| User says                                                                            | Action                            |
-| ------------------------------------------------------------------------------------ | --------------------------------- |
-| _(no sample)_                                                                        | `authLogin`                       |
-| _(no sample)_                                                                        | `authLogout`                      |
-| _(no sample)_                                                                        | `authStatus`                      |
-| _(no sample)_                                                                        | `browseRepo`                      |
-| _(no sample)_                                                                        | `browseIssue`                     |
-| _(no sample)_                                                                        | `browsePr`                        |
-| _(no sample)_                                                                        | `codespaceCreate`                 |
-| _(no sample)_                                                                        | `codespaceDelete`                 |
-| _(no sample)_                                                                        | `codespaceList`                   |
-| _(no sample)_                                                                        | `gistCreate`                      |
-| _(no sample)_                                                                        | `gistDelete`                      |
-| _(no sample)_                                                                        | `gistList`                        |
-| _(no sample)_                                                                        | `issueCreate`                     |
-| _(no sample)_                                                                        | `issueClose`                      |
-| _Permanently delete a GitHub issue (uses `gh issue delete --yes`)._                  | `issueDelete` → `{ "number": 0 }` |
-| _(no sample)_                                                                        | `issueReopen`                     |
-| _(no sample)_                                                                        | `issueList`                       |
-| _View / open a specific GitHub issue by number_                                      | `issueView`                       |
-| _(no sample)_                                                                        | `orgList`                         |
-| _(no sample)_                                                                        | `orgView`                         |
-| _(no sample)_                                                                        | `prCreate`                        |
-| _(no sample)_                                                                        | `prClose`                         |
-| _(no sample)_                                                                        | `prMerge`                         |
-| _List pull requests, optionally filtered by repo, state, label, author, or assignee_ | `prList`                          |
-| _View / open a specific GitHub pull request by number_                               | `prView`                          |
-| _(no sample)_                                                                        | `prCheckout`                      |
-| _(no sample)_                                                                        | `prChecks` → `{ "number": 0 }`    |
-| _(no sample)_                                                                        | `projectCreate`                   |
-| _(no sample)_                                                                        | `projectDelete`                   |
-| _(no sample)_                                                                        | `projectList`                     |
-| _…and 35 more actions not shown (cap: 30)._                                          |                                   |
+_66 actions implemented by this agent, parsed deterministically from `./src/github-cliSchema.ts`. Sample utterances and parameter shapes are illustrative; consult the schema for the full signature._
+
+| User says                                                                            | Action                                 |
+| ------------------------------------------------------------------------------------ | -------------------------------------- |
+| _(no sample)_                                                                        | `authLogin`                            |
+| _(no sample)_                                                                        | `authLogout`                           |
+| _(no sample)_                                                                        | `authStatus`                           |
+| _(no sample)_                                                                        | `browseRepo`                           |
+| _(no sample)_                                                                        | `browseIssue`                          |
+| _(no sample)_                                                                        | `browsePr`                             |
+| _(no sample)_                                                                        | `codespaceCreate`                      |
+| _(no sample)_                                                                        | `codespaceDelete`                      |
+| _(no sample)_                                                                        | `codespaceList`                        |
+| _(no sample)_                                                                        | `gistCreate`                           |
+| _(no sample)_                                                                        | `gistDelete`                           |
+| _(no sample)_                                                                        | `gistList`                             |
+| _(no sample)_                                                                        | `issueCreate`                          |
+| _(no sample)_                                                                        | `issueClose`                           |
+| _Permanently delete a GitHub issue (uses `gh issue delete --yes`)._                  | `issueDelete` → `{ "number": 0 }`      |
+| _(no sample)_                                                                        | `issueReopen`                          |
+| _(no sample)_                                                                        | `issueList`                            |
+| _View / open a specific GitHub issue by number_                                      | `issueView`                            |
+| _(no sample)_                                                                        | `orgList`                              |
+| _(no sample)_                                                                        | `orgView`                              |
+| _(no sample)_                                                                        | `prCreate`                             |
+| _(no sample)_                                                                        | `prClose`                              |
+| _Check whether a branch has already been merged into a base branch_                  | `prMergedStatus` → `{ "branch": "…" }` |
+| _(no sample)_                                                                        | `prMerge`                              |
+| _List pull requests, optionally filtered by repo, state, label, author, or assignee_ | `prList`                               |
+| _View / open a specific GitHub pull request by number_                               | `prView`                               |
+| _(no sample)_                                                                        | `prCheckout`                           |
+| _(no sample)_                                                                        | `prChecks` → `{ "number": 0 }`         |
+| _(no sample)_                                                                        | `projectCreate`                        |
+| _(no sample)_                                                                        | `projectDelete`                        |
+| _…and 36 more actions not shown (cap: 30)._                                          |                                        |
 
 ---
 
-_Auto-generated against commit `f928ce70269b7d0f8942977c29147b2c8832b722` on `2026-07-15T22:42:29.947Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter github-cli-agent docs:verify-links` to spot-check._
+_Auto-generated against commit `5a7bdd3625eef42d75702c9fd9f0dadb7cb10410` on `2026-07-29T05:15:39.538Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter @typeagent/github-cli-agent docs:verify-links` to spot-check._
 
 <!-- AUTOGEN:DOCS:END -->
diff --git a/ts/packages/agents/github-cli/src/github-cliActionHandler.ts b/ts/packages/agents/github-cli/src/github-cliActionHandler.ts
index 25f05b100f..d8efe97609 100644
--- a/ts/packages/agents/github-cli/src/github-cliActionHandler.ts
+++ b/ts/packages/agents/github-cli/src/github-cliActionHandler.ts
@@ -569,6 +569,19 @@ export function buildArgs(
             if (p.number) args.push(String(p.number));
             return args;
         }
+        case "prMergedStatus": {
+            const args = ["pr", "list"];
+            if (p.repo) args.push("--repo", String(p.repo));
+            if (p.base) args.push("--base", String(p.base));
+            if (p.branch) args.push("--head", String(p.branch));
+            args.push("--state", "merged");
+            args.push("--limit", String(p.limit ?? 20));
+            args.push(
+                "--json",
+                "number,title,url,mergedAt,headRefName,baseRefName",
+            );
+            return args;
+        }
         case "prMerge": {
             const args = ["pr", "merge"];
             if (p.number) args.push(String(p.number));
@@ -1994,6 +2007,36 @@ async function executeAction(
 
                 // Array results: issues, PRs, search repos
                 if (Array.isArray(data)) {
+                    if (action.actionName === "prMergedStatus") {
+                        const branch = String(p.branch ?? "");
+                        const base = String(p.base ?? "main");
+                        const matches = data as Array<{
+                            number?: number;
+                            title?: string;
+                            url?: string;
+                            mergedAt?: string;
+                        }>;
+
+                        if (matches.length === 0) {
+                            return createActionResultFromMarkdownDisplay(
+                                `No merged PR found from branch **${branch}** into **${base}**.`,
+                            );
+                        }
+
+                        const first = matches[0];
+                        const prLabel =
+                            first.number !== undefined
+                                ? `#${first.number}`
+                                : "matching PR";
+                        const mergedAt = first.mergedAt
+                            ? ` (merged at ${first.mergedAt})`
+                            : "";
+                        const link = first.url ? `\n\n${first.url}` : "";
+                        return createActionResultFromMarkdownDisplay(
+                            `Yes - branch **${branch}** was merged into **${base}** via PR **${prLabel}**${mergedAt}.${link}`,
+                        );
+                    }
+
                     const result = buildStructuredListResult(
                         data as Record<string, unknown>[],
                         action.actionName,
diff --git a/ts/packages/agents/github-cli/src/github-cliSchema.agr b/ts/packages/agents/github-cli/src/github-cliSchema.agr
index ae443243b2..c3fbd72312 100644
--- a/ts/packages/agents/github-cli/src/github-cliSchema.agr
+++ b/ts/packages/agents/github-cli/src/github-cliSchema.agr
@@ -141,6 +141,52 @@
     }
 };
 
+<PrMergedStatus> = did (the)? $(branch:word) (branch)? get merged into $(base:word) -> {
+    actionName: "prMergedStatus",
+    parameters: {
+        branch,
+        base
+    }
+}
+  | did (the)? $(branch:word) (branch)? get merged into $(base:word) in $(repo:wildcard) -> {
+    actionName: "prMergedStatus",
+    parameters: {
+        branch,
+        base,
+        repo
+    }
+}
+  | has (the)? $(branch:word) (branch)? been merged into $(base:word) -> {
+    actionName: "prMergedStatus",
+    parameters: {
+        branch,
+        base
+    }
+}
+  | has (the)? $(branch:word) (branch)? been merged into $(base:word) in $(repo:wildcard) -> {
+    actionName: "prMergedStatus",
+    parameters: {
+        branch,
+        base,
+        repo
+    }
+}
+  | is (the)? $(branch:word) (branch)? merged into $(base:word) -> {
+    actionName: "prMergedStatus",
+    parameters: {
+        branch,
+        base
+    }
+}
+  | is (the)? $(branch:word) (branch)? merged into $(base:word) in $(repo:wildcard) -> {
+    actionName: "prMergedStatus",
+    parameters: {
+        branch,
+        base,
+        repo
+    }
+};
+
 <PrMerge> = merge PR $(number:number) -> {
     actionName: "prMerge",
     parameters: {
@@ -446,6 +492,7 @@ import { GithubCliActions } from "./github-cliSchema.ts";
   | <IssueView>
   | <PrCreate>
   | <PrClose>
+  | <PrMergedStatus>
   | <PrMerge>
   | <PrList>
   | <PrView>
diff --git a/ts/packages/agents/github-cli/src/github-cliSchema.ts b/ts/packages/agents/github-cli/src/github-cliSchema.ts
index a9b304cafa..080dc3a585 100644
--- a/ts/packages/agents/github-cli/src/github-cliSchema.ts
+++ b/ts/packages/agents/github-cli/src/github-cliSchema.ts
@@ -24,6 +24,7 @@ export type GithubCliActions =
     | OrgViewAction
     | PrCreateAction
     | PrCloseAction
+    | PrMergedStatusAction
     | PrMergeAction
     | PrListAction
     | PrViewAction
@@ -284,6 +285,28 @@ export type PrCloseAction = {
     };
 };
 
+// Check whether a branch has already been merged into a base branch.
+//
+// Example:
+// User: did dev/robgruen/dogfooding7 get merged into main?
+// Agent: { actionName: "prMergedStatus", parameters: { branch: "dev/robgruen/dogfooding7", base: "main" } }
+export type PrMergedStatusAction = {
+    actionName: "prMergedStatus";
+    parameters: {
+        // Source branch to check (PR head branch).
+        branch: string;
+
+        // Target base branch. Defaults to "main" when omitted.
+        base?: string;
+
+        // OWNER/REPO slug (e.g. "microsoft/TypeAgent"). Omit to use current repo.
+        repo?: string;
+
+        // Maximum number of merged PR matches to inspect.
+        limit?: number;
+    };
+};
+
 export type PrMergeAction = {
     actionName: "prMerge";
     parameters: {
diff --git a/ts/packages/agents/github-cli/test/githubCliBuildArgs.spec.ts b/ts/packages/agents/github-cli/test/githubCliBuildArgs.spec.ts
index e7a6befb68..c7d9a801c0 100644
--- a/ts/packages/agents/github-cli/test/githubCliBuildArgs.spec.ts
+++ b/ts/packages/agents/github-cli/test/githubCliBuildArgs.spec.ts
@@ -135,6 +135,46 @@ describe("buildArgs — prList assignee handling", () => {
     });
 });
 
+describe("buildArgs — prMergedStatus", () => {
+    test("builds a merged PR lookup with head/base filters", () => {
+        const args = buildArgs(
+            action("prMergedStatus", {
+                repo: "microsoft/TypeAgent",
+                branch: "dev/robgruen/dogfooding7",
+                base: "main",
+            }),
+        )!;
+        const joined = args.join(" ");
+        expect(args.slice(0, 2)).toEqual(["pr", "list"]);
+        expect(joined).toContain("--repo microsoft/TypeAgent");
+        expect(joined).toContain("--head dev/robgruen/dogfooding7");
+        expect(joined).toContain("--base main");
+        expect(joined).toContain("--state merged");
+        expect(joined).toContain(
+            "--json number,title,url,mergedAt,headRefName,baseRefName",
+        );
+    });
+
+    test("defaults limit to 20 and honors explicit limit", () => {
+        const defaultLimit = buildArgs(
+            action("prMergedStatus", {
+                branch: "feature/x",
+                base: "main",
+            }),
+        )!;
+        expect(defaultLimit.join(" ")).toContain("--limit 20");
+
+        const customLimit = buildArgs(
+            action("prMergedStatus", {
+                branch: "feature/x",
+                base: "main",
+                limit: 3,
+            }),
+        )!;
+        expect(customLimit.join(" ")).toContain("--limit 3");
+    });
+});
+
 describe('buildArgs — author handling ("my PRs" / "issues I opened")', () => {
     test("maps prList author @me to --author, not --assignee", () => {
         const args = buildArgs(
diff --git a/ts/packages/agents/selfhelp/LICENSE b/ts/packages/agents/selfhelp/LICENSE
new file mode 100644
index 0000000000..22aed37e65
--- /dev/null
+++ b/ts/packages/agents/selfhelp/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Microsoft Corporation.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/ts/packages/agents/selfhelp/README.AUTOGEN.md b/ts/packages/agents/selfhelp/README.AUTOGEN.md
new file mode 100644
index 0000000000..6ec1134e4d
--- /dev/null
+++ b/ts/packages/agents/selfhelp/README.AUTOGEN.md
@@ -0,0 +1,121 @@
+<!-- Copyright (c) Microsoft Corporation. -->
+<!-- Licensed under the MIT License. -->
+
+<!-- AUTOGEN:DOCS:START -->
+
+<!-- AUTOGEN:DOCS:HASH:sha256=a838a56207c8e7a95217dfc4c278544f073f030d7ec5517e3acedd742c2566ed -->
+<!-- AUTOGEN:DOCS:SOURCE: ./README.md (hand-written documentation; this file is the AI-generated companion) -->
+
+# @typeagent/selfhelp-agent — AI-generated documentation
+
+> 🤖 **AI-authored documentation**, regenerated daily and validated for length, tone, and link integrity. Cross-check against the deterministic Reference section below before relying on specifics. Hand-written context from [`./README.md`](./README.md) was provided to the model as authoritative source. May lag the working tree by up to 24h — see the staleness footer at the end of this file.
+
+## Overview
+
+The `@typeagent/selfhelp-agent` package provides a Help agent for the TypeAgent ecosystem. Its primary purpose is to assist users by answering questions about how to perform tasks within TypeAgent. It translates natural-language queries, such as "how do I create a new conversation?", into actionable TypeAgent commands and their equivalent natural-language phrasings. This agent is enabled by default and can be invoked either implicitly through natural-language queries or explicitly using the `@selfhelp` prefix.
+
+This agent complements the built-in `@help` command by offering a natural-language interface grounded in the Action Browser catalog, which contains a comprehensive list of all available agent actions, `@`-commands, and their explicit links.
+
+## What it does
+
+The Help agent is designed to map user queries to the corresponding `@`-commands and natural-language phrasings. For example:
+
+- Query: "What's the command to create a new conversation?"
+- Response:
+  - `@conversation new [<name>]` — Create a new conversation, optionally with a name.
+  - Or say: "start a new conversation", "new conversation called design review".
+
+### Key Features
+
+1. **Natural-Language Query Support**: Users can ask questions in plain language, such as "how do I clear the chat history?".
+2. **Command and Action Mapping**: The agent identifies the relevant `@`-commands and their linked actions, providing both the command syntax and natural-language alternatives.
+3. **Grounded Responses**: All responses are based on the Action Browser catalog, ensuring accuracy and consistency.
+4. **Automatic Updates**: As new commands and actions are annotated in the catalog, they become available to the Help agent without requiring changes to its code.
+
+### Actions
+
+The agent implements the `answerTypeAgentQuestion` action, which takes a user's question as input and returns a structured response containing the relevant commands and phrasings. This action is grounded in the Action Browser catalog, ensuring that the responses are accurate and up-to-date.
+
+## Setup
+
+This package requires no special setup beyond the standard workspace build process. The Action Browser catalog, which serves as the foundation for the agent's responses, is generated by the `@typeagent/action-browser` package and copied into the `dist/` directory during the build process.
+
+To build and test the package, use the following commands:
+
+```bash
+pnpm --filter @typeagent/selfhelp-agent build
+pnpm --filter @typeagent/selfhelp-agent test
+```
+
+The build process compiles the TypeScript source files, generates the routing action schema, and copies the catalog into the `dist/` directory.
+
+## Key Files
+
+The functionality of the Help agent is implemented across several key files:
+
+- **[selfHelpManifest.json](./src/selfHelpManifest.json)**: Contains metadata about the agent, including its description, default enabled state, and schema details.
+- **[selfHelpActionHandler.ts](./src/selfHelpActionHandler.ts)**: Implements the main handler logic for processing user queries. It selects relevant catalog entries, queries the model via TypeChat, and renders the response.
+- **[commandHelpResponseSchema.ts](./src/commandHelpResponseSchema.ts)**: Defines the schema for the structured response returned by the agent. This includes the summary, commands, and natural-language phrasings.
+- **[catalog.ts](./src/catalog.ts)**: Manages loading and processing the Action Browser catalog. It selects relevant entries based on the user's query and prepares the grounding for the model.
+- **[render.ts](./src/render.ts)**: Converts the structured response into Markdown for display. It resolves command usage and phrasings from the catalog to ensure consistency.
+- **[selfHelpSchema.ts](./src/selfHelpSchema.ts)**: Defines the `SelfHelpAction` type, which specifies the input and output structure for the `answerTypeAgentQuestion` action.
+
+## How to extend
+
+To enhance the Help agent's functionality, follow these steps:
+
+1. **Update the Action Browser Catalog**: Add new commands, actions, or phrasings to the Action Browser catalog. This catalog is the primary source of truth for the agent's responses. Once updated, rebuild the catalog and copy it into the `dist/` directory.
+
+2. **Modify the Handler Logic**: If additional processing is required, update the handler in [selfHelpActionHandler.ts](./src/selfHelpActionHandler.ts). For example, you might add custom logic for handling specific types of queries.
+
+3. **Adjust the Response Schema**: If the structure of the agent's response needs to change, update the schema in [commandHelpResponseSchema.ts](./src/commandHelpResponseSchema.ts). Ensure that the changes are reflected in both the TypeScript types and the TypeChat schema text.
+
+4. **Test Your Changes**: Add or update tests to cover the new functionality. Run the test suite to ensure that everything works as expected:
+
+   ```bash
+   pnpm --filter @typeagent/selfhelp-agent test
+   ```
+
+5. **Build and Deploy**: Rebuild the package to generate the updated schema and copy the catalog. Verify that the changes are reflected in the agent's responses.
+
+By following these steps, you can extend the Help agent to support new commands, actions, or use cases.
+
+## Reference
+
+> ⚙️ **Auto-generated, no AI involvement.** Built deterministically from `package.json`, `src/`, and the workspace dependency graph at the commit recorded in the staleness footer at the end of this file. Hand edits to this file will be overwritten on the next run.
+
+### Entry points
+
+- `./agent/manifest` → [./src/selfHelpManifest.json](./src/selfHelpManifest.json)
+- `./agent/handlers` → [./dist/selfHelpActionHandler.js](./dist/selfHelpActionHandler.js)
+
+### Dependencies
+
+Workspace:
+
+- [@typeagent/action-schema-compiler](../../../packages/actionSchemaCompiler/README.md)
+- [@typeagent/agent-runtime](../../../packages/typeagent/README.md)
+- [@typeagent/agent-sdk](../../../packages/agentSdk/README.md)
+- [@typeagent/aiclient](../../../packages/aiclient/README.md)
+
+External: `debug`, `typechat`
+
+### Used by
+
+- [default-agent-provider](../../../packages/defaultAgentProvider/README.md)
+
+### Files of interest
+
+`./src/commandHelpResponseSchema.ts`, `./src/selfHelpActionHandler.ts`, `./src/selfHelpManifest.json`, …and 4 more under `./src/`.
+
+### Agent surface
+
+- Manifest: [./src/selfHelpManifest.json](./src/selfHelpManifest.json)
+- Schema: [./src/commandHelpResponseSchema.ts](./src/commandHelpResponseSchema.ts)
+- Handler: [./src/selfHelpActionHandler.ts](./src/selfHelpActionHandler.ts)
+
+---
+
+_Auto-generated against commit `95c8336eb7cd853020fc28cbc98b6380676e73f3` on `2026-07-30T17:32:13.295Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter @typeagent/selfhelp-agent docs:verify-links` to spot-check._
+
+<!-- AUTOGEN:DOCS:END -->
diff --git a/ts/packages/agents/selfhelp/README.md b/ts/packages/agents/selfhelp/README.md
new file mode 100644
index 0000000000..c1b78c29aa
--- /dev/null
+++ b/ts/packages/agents/selfhelp/README.md
@@ -0,0 +1,70 @@
+# @typeagent/selfhelp-agent
+
+The TypeAgent **Help** agent. It tells you the TypeAgent command - and the
+equivalent natural-language phrasing - for what you want to do, answering
+"what's the command for X" / "how do I X in TypeAgent".
+
+It ships enabled by default. Ask in natural language (no `@` prefix), for
+example:
+
+- "what's the command to create a new conversation?"
+- "how do I clear the chat history?"
+
+or invoke it explicitly:
+
+```
+@selfhelp create a new conversation
+```
+
+A typical answer shows both ways to do it - the `@`-command and the phrasing you
+can just say:
+
+- `@conversation new [<name>]` — Create a new conversation, optionally with a name
+  or say: "start a new conversation", "new conversation called design review"
+
+## Relationship to `@help`
+
+This agent does **not** replace the built-in `@help` command. `@help` is the
+deterministic command reference (usage, arguments, and flags). The Help agent
+maps a natural-language intent to the matching command(s)/action(s) and explains
+them.
+
+## How it works
+
+The agent is grounded on the **Action Browser catalog** (`action-browser.json`),
+which lists every agent action (with example phrasings) and every `@`-command,
+including the explicit command→action links (e.g. `@conversation new` ↔ the
+`newConversation` action). The catalog is generated by `@typeagent/action-browser`
+as part of the docs build and copied into this package's `dist/` at build time
+(see `scripts/copyCatalog.mjs`); nothing is fetched at runtime.
+
+For each question, the handler (`src/selfHelpActionHandler.ts`):
+
+1. selects the relevant slice of the catalog (`src/catalog.ts`), keeping each
+   command together with its linked action;
+2. asks the model, via **TypeChat**, to pick the matching capability as a typed
+   `CommandHelpResponse` (`src/commandHelpResponseSchema.ts`) - using only entries
+   from the catalog;
+3. renders the result to Markdown (`src/render.ts`), resolving each command's
+   usage and its paired phrasings from the catalog so the output stays grounded.
+
+Because the command→action links are read from the catalog, more commands light
+up automatically as they are annotated - no changes needed here.
+
+## Build & test
+
+```
+pnpm --filter @typeagent/selfhelp-agent build
+pnpm --filter @typeagent/selfhelp-agent test
+```
+
+Build compiles the handler (`tsc`), the routing action schema
+(`asc` -> `dist/selfHelpSchema.pas.json`), and copies the catalog into `dist/`.
+
+## Trademarks
+
+This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft
+trademarks or logos is subject to and must follow
+[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
+Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
+Any use of third-party trademarks or logos are subject to those third-party's policies.
diff --git a/ts/packages/agents/selfhelp/jest.config.cjs b/ts/packages/agents/selfhelp/jest.config.cjs
new file mode 100644
index 0000000000..f475768a12
--- /dev/null
+++ b/ts/packages/agents/selfhelp/jest.config.cjs
@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+module.exports = require("../../../jest.config.js");
diff --git a/ts/packages/agents/selfhelp/package.json b/ts/packages/agents/selfhelp/package.json
new file mode 100644
index 0000000000..9c8e488c6e
--- /dev/null
+++ b/ts/packages/agents/selfhelp/package.json
@@ -0,0 +1,75 @@
+{
+  "name": "@typeagent/selfhelp-agent",
+  "version": "0.0.1",
+  "description": "Help agent that answers questions about TypeAgent itself",
+  "keywords": [
+    "typeagent-agent"
+  ],
+  "homepage": "https://github.com/microsoft/TypeAgent#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/microsoft/TypeAgent.git",
+    "directory": "ts/packages/agents/selfhelp"
+  },
+  "license": "MIT",
+  "author": "Microsoft",
+  "type": "module",
+  "exports": {
+    "./agent/manifest": "./src/selfHelpManifest.json",
+    "./agent/handlers": "./dist/selfHelpActionHandler.js"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!dist/tsconfig.tsbuildinfo"
+  ],
+  "scripts": {
+    "asc": "asc -i ./src/selfHelpSchema.ts -o ./dist/selfHelpSchema.pas.json -t SelfHelpAction",
+    "build": "concurrently npm:tsc npm:asc npm:copy-catalog",
+    "clean": "rimraf --glob dist *.tsbuildinfo *.done.build.log",
+    "copy-catalog": "node scripts/copyCatalog.mjs",
+    "jest-esm": "node --no-warnings --experimental-vm-modules ./node_modules/jest/bin/jest.js",
+    "prettier": "prettier --check . --ignore-path ../../../.prettierignore",
+    "prettier:fix": "prettier --write . --ignore-path ../../../.prettierignore",
+    "test": "npm run test:local",
+    "test:local": "pnpm run jest-esm --testPathPattern=\".*[.]spec[.]js\"",
+    "tsc": "tsc -b"
+  },
+  "dependencies": {
+    "@typeagent/agent-runtime": "workspace:*",
+    "@typeagent/agent-sdk": "workspace:*",
+    "@typeagent/aiclient": "workspace:*",
+    "debug": "^4.4.0",
+    "typechat": "^0.1.1"
+  },
+  "devDependencies": {
+    "@typeagent/action-schema-compiler": "workspace:*",
+    "@types/debug": "^4.1.12",
+    "@types/jest": "^29.5.7",
+    "concurrently": "^9.1.2",
+    "jest": "^29.7.0",
+    "prettier": "^3.5.3",
+    "rimraf": "^6.0.1",
+    "typescript": "~5.4.5"
+  },
+  "fluidBuild": {
+    "tasks": {
+      "asc": {
+        "dependsOn": [
+          "@typeagent/action-schema-compiler#tsc"
+        ],
+        "files": {
+          "inputGlobs": [
+            "src/selfHelpSchema.ts"
+          ],
+          "outputGlobs": [
+            "dist/selfHelpSchema.pas.json"
+          ]
+        }
+      }
+    }
+  },
+  "typeagent": {
+    "defaultAgentName": "selfhelp"
+  }
+}
diff --git a/ts/packages/agents/selfhelp/scripts/copyCatalog.mjs b/ts/packages/agents/selfhelp/scripts/copyCatalog.mjs
new file mode 100644
index 0000000000..63520dae37
--- /dev/null
+++ b/ts/packages/agents/selfhelp/scripts/copyCatalog.mjs
@@ -0,0 +1,37 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+// Copies the generated Action Browser catalog into dist so it ships beside the
+// agent (the runtime reads ./action-browser.json relative to the built handler).
+// Runs as part of build. Tolerant of a missing source so a fresh checkout whose
+// docs have not been generated still builds; the runtime handles an absent
+// catalog gracefully.
+
+import { copyFileSync, existsSync, mkdirSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const src = resolve(
+    here,
+    "..",
+    "..",
+    "..",
+    "..",
+    "docs",
+    "overview",
+    "action-browser.json",
+);
+const destDir = resolve(here, "..", "dist");
+const dest = resolve(destDir, "action-browser.json");
+
+if (!existsSync(src)) {
+    console.warn(
+        `copyCatalog: source not found at ${src}; skipping (runtime handles an absent catalog).`,
+    );
+    process.exit(0);
+}
+
+mkdirSync(destDir, { recursive: true });
+copyFileSync(src, dest);
+console.warn(`copyCatalog: wrote ${dest}`);
diff --git a/ts/packages/agents/selfhelp/src/catalog.ts b/ts/packages/agents/selfhelp/src/catalog.ts
new file mode 100644
index 0000000000..be58738d58
--- /dev/null
+++ b/ts/packages/agents/selfhelp/src/catalog.ts
@@ -0,0 +1,472 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+// Loads the bundled Action Browser catalog (agent actions + @-commands, with the
+// explicit command->action links) and turns a user question into a compact,
+// host-grouped grounding for the LLM. The catalog file is copied into dist at
+// build time (see scripts/copyCatalog.mjs); nothing is fetched at runtime.
+
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+
+export type CatalogParam = {
+    name: string;
+    type: string;
+    optional: boolean;
+    description: string;
+};
+
+export type CatalogAction = {
+    actionName: string;
+    description: string;
+    parameters: CatalogParam[];
+    phrasings: string[];
+};
+
+export type CatalogSchema = {
+    schemaName: string;
+    description: string;
+    defaultEnabled: boolean;
+    transient: boolean;
+    actions: CatalogAction[];
+};
+
+export type CatalogAgent = {
+    name: string;
+    category: string;
+    emoji: string;
+    description: string;
+    schemas: CatalogSchema[];
+};
+
+export type CatalogCommandArg = {
+    name: string;
+    type: string;
+    optional: boolean;
+    description: string;
+};
+
+export type CatalogCommandFlag = {
+    name: string;
+    char: string;
+    type: string;
+    default: string;
+    description: string;
+};
+
+export type CatalogActionLink = { schema?: string; actionName: string };
+
+export type CatalogCommand = {
+    host: string;
+    path: string;
+    description: string;
+    group: boolean;
+    args: CatalogCommandArg[];
+    flags: CatalogCommandFlag[];
+    action?: CatalogActionLink;
+};
+
+export type Catalog = {
+    generatedAt: string;
+    agents: CatalogAgent[];
+    commands: CatalogCommand[];
+    counts: { agents: number; actions: number; commands: number };
+};
+
+export type CatalogIndex = {
+    catalog: Catalog;
+    // Actions keyed by `${host}\u0000${actionName}`. Scoped by host because the
+    // same actionName can appear under multiple agents (e.g. newConversation).
+    actionByKey: Map<string, CatalogAction>;
+    commandByKey: Map<string, CatalogCommand>;
+};
+
+function key(host: string, name: string): string {
+    return `${host}\u0000${name}`;
+}
+
+// Grammar phrasings carry tokens like {polite} (a politeness filler) and {name}
+// (a captured slot). Drop the filler and show remaining slots as <slot> so the
+// suggestions read as plain English.
+export function cleanPhrasing(phrasing: string): string {
+    return phrasing
+        .replace(/\{polite\}/gi, " ")
+        .replace(/\{([^}]+)\}/g, "<$1>")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+
+export function cleanPhrasings(phrasings: string[]): string[] {
+    const seen = new Set<string>();
+    const out: string[] = [];
+    for (const phrasing of phrasings) {
+        const cleaned = cleanPhrasing(phrasing);
+        if (cleaned.length > 0 && !seen.has(cleaned)) {
+            seen.add(cleaned);
+            out.push(cleaned);
+        }
+    }
+    return out;
+}
+
+// Descriptions in the catalog sometimes append few-shot examples ("Example:
+// User: ... Agent: { ... }"). Strip those and any JSON-ish blobs so the text
+// reads like something the agent would say.
+export function cleanDescription(description: string): string {
+    let text = description;
+    const exampleIndex = text.search(/\bExamples?:/i);
+    if (exampleIndex >= 0) {
+        text = text.slice(0, exampleIndex);
+    }
+    return text
+        .replace(/\{[^{}]*\}/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+
+let loaded = false;
+let cachedIndex: CatalogIndex | undefined;
+
+// Reads and indexes the bundled catalog once. Returns undefined when the file is
+// missing or unparseable; callers surface a friendly message instead.
+export function loadCatalogIndex(): CatalogIndex | undefined {
+    if (loaded) {
+        return cachedIndex;
+    }
+    loaded = true;
+    try {
+        const path = fileURLToPath(
+            new URL("./action-browser.json", import.meta.url),
+        );
+        const catalog = JSON.parse(readFileSync(path, "utf8")) as Catalog;
+        cachedIndex = indexCatalog(catalog);
+    } catch {
+        cachedIndex = undefined;
+    }
+    return cachedIndex;
+}
+
+export function indexCatalog(catalog: Catalog): CatalogIndex {
+    const actionByKey = new Map<string, CatalogAction>();
+    for (const agent of catalog.agents) {
+        for (const schema of agent.schemas) {
+            for (const action of schema.actions) {
+                // Normalize grammar phrasings and strip few-shot examples once
+                // so every consumer (scoring, grounding, rendering) gets clean
+                // text.
+                action.phrasings = cleanPhrasings(action.phrasings);
+                action.description = cleanDescription(action.description);
+                const k = key(agent.name, action.actionName);
+                // First definition wins; a name can repeat across an agent's
+                // schemas, and the description/phrasings are equivalent enough
+                // for grounding.
+                if (!actionByKey.has(k)) {
+                    actionByKey.set(k, action);
+                }
+            }
+        }
+    }
+    const commandByKey = new Map<string, CatalogCommand>();
+    for (const command of catalog.commands) {
+        command.description = cleanDescription(command.description);
+        commandByKey.set(key(command.host, command.path), command);
+    }
+    return { catalog, actionByKey, commandByKey };
+}
+
+export function lookupAction(
+    index: CatalogIndex,
+    host: string,
+    actionName: string,
+): CatalogAction | undefined {
+    return index.actionByKey.get(key(host, actionName));
+}
+
+export function lookupCommand(
+    index: CatalogIndex,
+    host: string,
+    path: string,
+): CatalogCommand | undefined {
+    return index.commandByKey.get(key(host, path));
+}
+
+export type HostGroup = {
+    host: string;
+    description: string;
+    commands: CatalogCommand[];
+    actions: CatalogAction[];
+};
+
+const STOPWORDS = new Set([
+    "the",
+    "a",
+    "an",
+    "to",
+    "of",
+    "in",
+    "on",
+    "for",
+    "how",
+    "do",
+    "i",
+    "what",
+    "whats",
+    "is",
+    "are",
+    "can",
+    "could",
+    "would",
+    "should",
+    "my",
+    "me",
+    "you",
+    "your",
+    "with",
+    "and",
+    "or",
+    "that",
+    "this",
+    "please",
+    "want",
+    "need",
+    "get",
+    "use",
+    "using",
+    "command",
+    "commands",
+    "typeagent",
+    "there",
+    "does",
+    "it",
+    "was",
+    "were",
+    "will",
+    "from",
+    "by",
+    "at",
+    "as",
+    "be",
+    "am",
+]);
+
+function tokenize(text: string): string[] {
+    return text
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((t) => t.length >= 2 && !STOPWORDS.has(t));
+}
+
+// A command's searchable text folds in its linked action's phrasings so a
+// naturally phrased question still matches the typed command.
+function commandText(index: CatalogIndex, cmd: CatalogCommand): string {
+    const parts = [cmd.path, cmd.description];
+    if (cmd.action) {
+        const action = lookupAction(index, cmd.host, cmd.action.actionName);
+        if (action) {
+            parts.push(action.description, action.phrasings.join(" "));
+        }
+    }
+    return parts.join(" ").toLowerCase();
+}
+
+function actionText(action: CatalogAction): string {
+    return [action.actionName, action.description, action.phrasings.join(" ")]
+        .join(" ")
+        .toLowerCase();
+}
+
+function score(queryTokens: string[], text: string): number {
+    let s = 0;
+    for (const token of queryTokens) {
+        if (text.includes(token)) {
+            s++;
+        }
+    }
+    return s;
+}
+
+type ScoredCommand = {
+    kind: "command";
+    host: string;
+    command: CatalogCommand;
+    s: number;
+};
+type ScoredAction = {
+    kind: "action";
+    host: string;
+    action: CatalogAction;
+    s: number;
+};
+
+type GroupSelection = {
+    commands: Map<string, CatalogCommand>;
+    actions: Map<string, CatalogAction>;
+};
+
+const MAX_ENTRIES = 24;
+
+function collectScoredEntries(
+    index: CatalogIndex,
+    queryTokens: string[],
+): (ScoredCommand | ScoredAction)[] {
+    const scored: (ScoredCommand | ScoredAction)[] = [];
+    const { catalog } = index;
+    for (const command of catalog.commands) {
+        const s = score(queryTokens, commandText(index, command));
+        if (s > 0) {
+            scored.push({ kind: "command", host: command.host, command, s });
+        }
+    }
+    for (const agent of catalog.agents) {
+        for (const schema of agent.schemas) {
+            for (const action of schema.actions) {
+                const s = score(queryTokens, actionText(action));
+                if (s > 0) {
+                    scored.push({
+                        kind: "action",
+                        host: agent.name,
+                        action,
+                        s,
+                    });
+                }
+            }
+        }
+    }
+    scored.sort((a, b) => b.s - a.s);
+    return scored;
+}
+
+function ensureGroup(
+    groups: Map<string, GroupSelection>,
+    host: string,
+): GroupSelection {
+    let group = groups.get(host);
+    if (!group) {
+        group = { commands: new Map(), actions: new Map() };
+        groups.set(host, group);
+    }
+    return group;
+}
+
+function addCommandSelection(
+    index: CatalogIndex,
+    groups: Map<string, GroupSelection>,
+    item: ScoredCommand,
+): void {
+    const group = ensureGroup(groups, item.host);
+    group.commands.set(item.command.path, item.command);
+    const link = item.command.action;
+    if (!link) {
+        return;
+    }
+    const action = lookupAction(index, item.host, link.actionName);
+    if (action) {
+        group.actions.set(action.actionName, action);
+    }
+}
+
+function addActionSelection(
+    index: CatalogIndex,
+    groups: Map<string, GroupSelection>,
+    item: ScoredAction,
+): void {
+    const group = ensureGroup(groups, item.host);
+    group.actions.set(item.action.actionName, item.action);
+    for (const command of index.catalog.commands) {
+        if (
+            command.host === item.host &&
+            command.action?.actionName === item.action.actionName
+        ) {
+            group.commands.set(command.path, command);
+        }
+    }
+}
+
+function describeHosts(catalog: Catalog): Map<string, string> {
+    return new Map(
+        catalog.agents.map((agent) => [agent.name, agent.description]),
+    );
+}
+
+// Keyword-overlap prefilter: the full catalog (~500 actions) is too large to
+// hand the model wholesale, so select the entries most relevant to the question,
+// keeping each command together with its linked action.
+export function selectRelevantGroups(
+    index: CatalogIndex,
+    question: string,
+): HostGroup[] {
+    const queryTokens = [...new Set(tokenize(question))];
+    const { catalog } = index;
+    const scored = collectScoredEntries(index, queryTokens);
+    const groups = new Map<string, GroupSelection>();
+
+    for (const item of scored.slice(0, MAX_ENTRIES)) {
+        if (item.kind === "command") {
+            addCommandSelection(index, groups, item);
+            continue;
+        }
+        addActionSelection(index, groups, item);
+    }
+
+    // Nothing matched: offer a compact list of every command so the model can
+    // still find one or state plainly that none apply.
+    if (groups.size === 0) {
+        for (const command of catalog.commands) {
+            ensureGroup(groups, command.host).commands.set(
+                command.path,
+                command,
+            );
+        }
+    }
+
+    const descByHost = describeHosts(catalog);
+    return [...groups.entries()].map(([host, g]) => ({
+        host,
+        description: descByHost.get(host) ?? "",
+        commands: [...g.commands.values()],
+        actions: [...g.actions.values()],
+    }));
+}
+
+const MAX_GROUNDING_PHRASINGS = 4;
+
+// Renders the selected capabilities as the compact text handed to the model.
+// Command and action identifiers are quoted so the model copies them verbatim.
+export function formatGrounding(groups: HostGroup[]): string {
+    const lines: string[] = [
+        "Available TypeAgent capabilities. Use ONLY these; copy host, commandPath, and actionName exactly.",
+    ];
+    for (const group of groups) {
+        lines.push("");
+        lines.push(
+            `## host: ${group.host}${group.description ? ` — ${group.description}` : ""}`,
+        );
+        if (group.commands.length > 0) {
+            lines.push("Commands:");
+            for (const cmd of group.commands) {
+                const args = cmd.args
+                    .map((a) => (a.optional ? `[${a.name}]` : `<${a.name}>`))
+                    .join(" ");
+                const link = cmd.action
+                    ? ` (action: ${cmd.action.actionName})`
+                    : "";
+                lines.push(
+                    `- commandPath: "${cmd.path}"${args ? ` ${args}` : ""}${link} — ${cmd.description}`,
+                );
+            }
+        }
+        if (group.actions.length > 0) {
+            lines.push("Actions (natural language):");
+            for (const action of group.actions) {
+                const phrasings = action.phrasings
+                    .slice(0, MAX_GROUNDING_PHRASINGS)
+                    .map((p) => `"${p}"`)
+                    .join("; ");
+                lines.push(
+                    `- actionName: "${action.actionName}" — ${action.description}${phrasings ? ` | e.g. ${phrasings}` : ""}`,
+                );
+            }
+        }
+    }
+    return lines.join("\n");
+}
diff --git a/ts/packages/agents/selfhelp/src/commandHelpResponseSchema.ts b/ts/packages/agents/selfhelp/src/commandHelpResponseSchema.ts
new file mode 100644
index 0000000000..b7d4441587
--- /dev/null
+++ b/ts/packages/agents/selfhelp/src/commandHelpResponseSchema.ts
@@ -0,0 +1,39 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+// The typed answer the Help agent gets back from TypeChat. The exported types
+// are used at compile time; `commandHelpResponseSchemaText` is the same shape as
+// TypeScript source the TypeChat validator parses at runtime. Keep them in sync.
+
+export type CommandHelpResponse = {
+    summary: string;
+    ways: CommandHelpWay[];
+};
+
+export type CommandHelpWay = {
+    host: string;
+    commandPath?: string;
+    actionName?: string;
+    does: string;
+};
+
+export const commandHelpResponseSchemaText = `export type CommandHelpResponse = {
+    // One or two sentences answering the user's question directly.
+    summary: string;
+    // The ways to do what the user asked, most relevant first.
+    // Empty when nothing in the provided capabilities matches.
+    ways: CommandHelpWay[];
+};
+
+export type CommandHelpWay = {
+    // The host/agent providing this, copied exactly from the capabilities list (e.g. "system", "browser").
+    host: string;
+    // The @-command path within the host, WITHOUT the leading '@', copied exactly (e.g. "conversation new").
+    // Omit when there is no command for this capability.
+    commandPath?: string;
+    // The equivalent action name, copied exactly (e.g. "newConversation"). Omit when none applies.
+    actionName?: string;
+    // A short description of what this does.
+    does: string;
+};
+`;
diff --git a/ts/packages/agents/selfhelp/src/render.ts b/ts/packages/agents/selfhelp/src/render.ts
new file mode 100644
index 0000000000..a4a0f48205
--- /dev/null
+++ b/ts/packages/agents/selfhelp/src/render.ts
@@ -0,0 +1,120 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+// Turns a validated CommandHelpResponse into structured display blocks: a short
+// summary followed by one card per way (command usage as the title, what it does
+// as the subtitle, and the natural-language phrasings under an "Or say" field).
+// Everything is resolved from the catalog so the output stays grounded. Pure and
+// side-effect free for testing.
+
+import {
+    CatalogCommand,
+    CatalogIndex,
+    cleanDescription,
+    lookupAction,
+    lookupCommand,
+} from "./catalog.js";
+import {
+    CommandHelpResponse,
+    CommandHelpWay,
+} from "./commandHelpResponseSchema.js";
+import { StructuredBlock } from "@typeagent/agent-sdk";
+
+const MAX_RENDERED_PHRASINGS = 3;
+
+export function formatCommandUsage(cmd: CatalogCommand): string {
+    const parts = [`@${cmd.path}`];
+    for (const arg of cmd.args) {
+        const token = `<${arg.name}>`;
+        parts.push(arg.optional ? `[${token}]` : token);
+    }
+    return parts.join(" ");
+}
+
+function quotePhrasings(phrasings: string[]): string {
+    return phrasings.map((p) => `“${p}”`).join(", ");
+}
+
+// CardBlock, without needing the type exported from the SDK. Optional props are
+// assigned only when present because the tsconfig uses exactOptionalPropertyTypes.
+type CardBlock = Extract<StructuredBlock, { kind: "card" }>;
+
+function renderWayCard(
+    way: CommandHelpWay,
+    index: CatalogIndex,
+): StructuredBlock | undefined {
+    const cmd = way.commandPath
+        ? lookupCommand(index, way.host, way.commandPath)
+        : undefined;
+    // Prefer the command's own declared action link over the model's guess.
+    const actionName = cmd?.action?.actionName ?? way.actionName;
+    const action = actionName
+        ? lookupAction(index, way.host, actionName)
+        : undefined;
+    const does = cleanDescription(
+        cmd?.description || action?.description || way.does || "",
+    );
+    const say = action
+        ? quotePhrasings(action.phrasings.slice(0, MAX_RENDERED_PHRASINGS))
+        : "";
+
+    if (cmd) {
+        const card: CardBlock = {
+            kind: "card",
+            title: formatCommandUsage(cmd),
+        };
+        if (does) card.subtitle = does;
+        if (say) card.fields = [{ label: "Or say", value: say }];
+        return card;
+    }
+    if (action) {
+        const card: CardBlock = {
+            kind: "card",
+            title: does || action.actionName,
+        };
+        if (say) card.fields = [{ label: "Say", value: say }];
+        return card;
+    }
+    // The model named a command path we couldn't resolve; show it as given.
+    if (way.commandPath) {
+        const card: CardBlock = { kind: "card", title: `@${way.commandPath}` };
+        if (does) card.subtitle = does;
+        return card;
+    }
+    return undefined;
+}
+
+export function renderStructured(
+    response: CommandHelpResponse,
+    index: CatalogIndex,
+): StructuredBlock[] {
+    const summary = response.summary?.trim();
+    const ways = Array.isArray(response.ways) ? response.ways : [];
+
+    if (ways.length === 0) {
+        return [
+            {
+                kind: "text",
+                text:
+                    summary ||
+                    "I couldn't find a matching TypeAgent command for that.",
+            },
+            {
+                kind: "text",
+                text: "Run `@help` to see all available commands.",
+            },
+        ];
+    }
+
+    const blocks: StructuredBlock[] = [];
+    if (summary) {
+        blocks.push({ kind: "text", text: summary });
+    }
+    for (const way of ways) {
+        const card = renderWayCard(way, index);
+        if (card) {
+            blocks.push(card);
+        }
+    }
+    return blocks;
+}
diff --git a/ts/packages/agents/selfhelp/src/selfHelpActionHandler.ts b/ts/packages/agents/selfhelp/src/selfHelpActionHandler.ts
new file mode 100644
index 0000000000..6b482c2e9b
--- /dev/null
+++ b/ts/packages/agents/selfhelp/src/selfHelpActionHandler.ts
@@ -0,0 +1,180 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+import {
+    ActionContext,
+    ActionResult,
+    AppAgent,
+    ParsedCommandParams,
+    TypeAgentAction,
+} from "@typeagent/agent-sdk";
+import {
+    createActionResultFromError,
+    createStructuredResult,
+} from "@typeagent/agent-sdk/helpers/action";
+import {
+    CommandHandler,
+    CommandHandlerTable,
+    getCommandInterface,
+} from "@typeagent/agent-sdk/helpers/command";
+import { createTypeChat } from "@typeagent/agent-runtime";
+import { openai } from "@typeagent/aiclient";
+import { SelfHelpAction } from "./selfHelpSchema.js";
+import {
+    CommandHelpResponse,
+    commandHelpResponseSchemaText,
+} from "./commandHelpResponseSchema.js";
+import {
+    formatGrounding,
+    loadCatalogIndex,
+    selectRelevantGroups,
+} from "./catalog.js";
+import { renderStructured } from "./render.js";
+import registerDebug from "debug";
+
+const debug = registerDebug("typeagent:selfhelp");
+
+export function instantiate(): AppAgent {
+    return {
+        executeAction,
+        ...getCommandInterface(handlers),
+    };
+}
+
+const answerInstructions = [
+    "You are the Help agent for TypeAgent. The user wants to know how to do something",
+    'in TypeAgent - usually "what\'s the command for X" or "how do I X".',
+    "You are given a list of available capabilities: each host's @-commands and the",
+    "equivalent natural-language actions. Identify the capability or capabilities that",
+    "satisfy the request and return them.",
+    "Rules:",
+    "- Use ONLY hosts, commandPath values, and actionName values that appear in the",
+    "  list. Never invent a command, path, host, or action.",
+    "- When the same thing can be done by a command AND a natural-language action, fill",
+    "  BOTH commandPath and actionName on the same way so the user sees both options.",
+    "- Order ways from most to least relevant.",
+    "- If nothing in the list matches, return an empty ways array and use summary to say",
+    "  so, suggesting the user run @help.",
+    "- Keep summary to one or two sentences.",
+].join("\n");
+
+type TokenUsage = {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+};
+
+async function answerCommandQuestion(
+    question: string,
+    context: ActionContext<unknown>,
+): Promise<ActionResult> {
+    const trimmed = question.trim();
+    if (trimmed.length === 0) {
+        return createActionResultFromError(
+            "Ask what you want to do in TypeAgent, e.g. 'what's the command to create a new conversation?'",
+        );
+    }
+
+    const index = loadCatalogIndex();
+    if (index === undefined) {
+        return createActionResultFromError(
+            "The TypeAgent command catalog isn't available. Try `@help` to list commands.",
+        );
+    }
+
+    // Let the user know work is happening while the model responds; cleared
+    // automatically when the final result is emitted.
+    context.actionIO.appendDisplay(
+        { type: "text", content: "Looking that up…", kind: "status" },
+        "temporary",
+    );
+
+    const grounding = formatGrounding(selectRelevantGroups(index, trimmed));
+
+    const tokenUsage: TokenUsage = {
+        prompt_tokens: 0,
+        completion_tokens: 0,
+        total_tokens: 0,
+    };
+    const chatModel = openai.createChatModel(
+        undefined,
+        { response_format: { type: "json_object" } },
+        undefined,
+        ["selfhelp"],
+    );
+    chatModel.completionCallback = (_params, data) => {
+        const usage = data?.usage;
+        if (usage) {
+            tokenUsage.prompt_tokens += usage.prompt_tokens ?? 0;
+            tokenUsage.completion_tokens += usage.completion_tokens ?? 0;
+            tokenUsage.total_tokens += usage.total_tokens ?? 0;
+        }
+    };
+
+    // maxPromptLength is large so the grounding preamble is never trimmed; there
+    // is no chat history to window.
+    const chat = createTypeChat<CommandHelpResponse>(
+        chatModel,
+        commandHelpResponseSchemaText,
+        "CommandHelpResponse",
+        answerInstructions,
+        [],
+        1_000_000,
+        30,
+    );
+
+    const response = await chat.translate(trimmed, grounding);
+    if (!response.success) {
+        debug(`translate failed: ${response.message}`);
+        return createActionResultFromError(
+            `Sorry, I couldn't answer that right now: ${response.message}`,
+        );
+    }
+
+    return {
+        ...createStructuredResult(renderStructured(response.data, index)),
+        tokenUsage,
+    };
+}
+
+async function executeAction(
+    action: TypeAgentAction<SelfHelpAction>,
+    context: ActionContext<unknown>,
+): Promise<ActionResult> {
+    switch (action.actionName) {
+        case "answerTypeAgentQuestion":
+            return answerCommandQuestion(action.parameters.question, context);
+        default:
+            throw new Error(
+                `Unknown SelfHelp action: ${(action as TypeAgentAction).actionName}`,
+            );
+    }
+}
+
+class AskCommandHandler implements CommandHandler {
+    public readonly description =
+        "Find the TypeAgent command for what you want to do (e.g. 'create a new conversation').";
+    public readonly parameters = {
+        args: {
+            question: {
+                description: "What you want to do in TypeAgent.",
+                implicitQuotes: true,
+            },
+        },
+    } as const;
+    public async run(
+        context: ActionContext<unknown>,
+        params: ParsedCommandParams<typeof this.parameters>,
+    ): Promise<ActionResult> {
+        return answerCommandQuestion(params.args.question, context);
+    }
+}
+
+const askHandler = new AskCommandHandler();
+const handlers: CommandHandlerTable = {
+    description: "Find the TypeAgent command for what you want to do",
+    defaultSubCommand: askHandler,
+    commands: {
+        ask: askHandler,
+    },
+};
diff --git a/ts/packages/agents/selfhelp/src/selfHelpManifest.json b/ts/packages/agents/selfhelp/src/selfHelpManifest.json
new file mode 100644
index 0000000000..89f2a208c6
--- /dev/null
+++ b/ts/packages/agents/selfhelp/src/selfHelpManifest.json
@@ -0,0 +1,13 @@
+{
+  "emojiChar": "💡",
+  "defaultEnabled": true,
+  "description": "Help agent that tells you the TypeAgent command or phrasing for what you want to do.",
+  "schema": {
+    "description": "Finds the TypeAgent command or action for what the user wants to do. Use for questions like 'what's the command for X', 'how do I X in TypeAgent', or 'is there a command to X'. Returns the matching @-command(s) and the equivalent natural-language phrasing(s). Do NOT use for general-knowledge questions, web lookups, or actually performing the task in another domain such as playing music, sending email, editing code, or controlling a browser.",
+    "originalSchemaFile": "./selfHelpSchema.ts",
+    "schemaFile": "../dist/selfHelpSchema.pas.json",
+    "schemaType": {
+      "action": "SelfHelpAction"
+    }
+  }
+}
diff --git a/ts/packages/agents/selfhelp/src/selfHelpSchema.ts b/ts/packages/agents/selfhelp/src/selfHelpSchema.ts
new file mode 100644
index 0000000000..86a9b8f638
--- /dev/null
+++ b/ts/packages/agents/selfhelp/src/selfHelpSchema.ts
@@ -0,0 +1,17 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+export type SelfHelpAction = AnswerTypeAgentQuestionAction;
+
+// Answer a user asking HOW TO DO SOMETHING in TypeAgent - especially "what's the
+// command for X" or "how do I X". The handler finds the matching @-command(s) and
+// equivalent natural-language action(s) from the TypeAgent command catalog. Use
+// only for questions about operating TypeAgent itself; not for general knowledge
+// or for performing a task in another domain.
+export interface AnswerTypeAgentQuestionAction {
+    actionName: "answerTypeAgentQuestion";
+    parameters: {
+        // The user's question about how to do something in TypeAgent, verbatim.
+        question: string;
+    };
+}
diff --git a/ts/packages/agents/selfhelp/src/tsconfig.json b/ts/packages/agents/selfhelp/src/tsconfig.json
new file mode 100644
index 0000000000..85efcd566d
--- /dev/null
+++ b/ts/packages/agents/selfhelp/src/tsconfig.json
@@ -0,0 +1,12 @@
+{
+  "extends": "../../../../tsconfig.base.json",
+  "compilerOptions": {
+    "composite": true,
+    "rootDir": ".",
+    "outDir": "../dist"
+  },
+  "include": ["./**/*"],
+  "ts-node": {
+    "esm": true
+  }
+}
diff --git a/ts/packages/agents/selfhelp/test/selfHelpCatalog.spec.ts b/ts/packages/agents/selfhelp/test/selfHelpCatalog.spec.ts
new file mode 100644
index 0000000000..674b28ea30
--- /dev/null
+++ b/ts/packages/agents/selfhelp/test/selfHelpCatalog.spec.ts
@@ -0,0 +1,204 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+// Unit tests for the deterministic core of the Help agent: catalog
+// projection/pairing (selectRelevantGroups, formatGrounding) and the markdown
+// renderer. No LLM is involved - a small synthetic catalog exercises the same
+// command<->action linking the real Action Browser catalog carries.
+
+import {
+    Catalog,
+    cleanDescription,
+    cleanPhrasing,
+    formatGrounding,
+    indexCatalog,
+    selectRelevantGroups,
+} from "../src/catalog.js";
+import { CommandHelpResponse } from "../src/commandHelpResponseSchema.js";
+import { renderStructured } from "../src/render.js";
+
+function makeCatalog(): Catalog {
+    return {
+        generatedAt: "test",
+        agents: [
+            {
+                name: "system",
+                category: "System",
+                emoji: "🔧",
+                description: "Built-in system agent",
+                schemas: [
+                    {
+                        schemaName: "system",
+                        description: "system",
+                        defaultEnabled: true,
+                        transient: false,
+                        actions: [
+                            {
+                                actionName: "newConversation",
+                                description: "Create a new conversation",
+                                parameters: [],
+                                phrasings: [
+                                    "start a new conversation",
+                                    "new conversation called design review",
+                                ],
+                            },
+                        ],
+                    },
+                ],
+            },
+        ],
+        commands: [
+            {
+                host: "system",
+                path: "conversation new",
+                description:
+                    "Create a new conversation, optionally with a name",
+                group: false,
+                args: [
+                    {
+                        name: "name",
+                        type: "string",
+                        optional: true,
+                        description: "Name for the new conversation",
+                    },
+                ],
+                flags: [],
+                action: { actionName: "newConversation" },
+            },
+            {
+                host: "system",
+                path: "history save",
+                description: "Save the chat history to a file",
+                group: false,
+                args: [
+                    {
+                        name: "file",
+                        type: "string",
+                        optional: false,
+                        description: "File to save to",
+                    },
+                ],
+                flags: [],
+            },
+        ],
+        counts: { agents: 1, actions: 1, commands: 2 },
+    };
+}
+
+describe("selectRelevantGroups", () => {
+    test("keeps a matched command together with its linked action", () => {
+        const index = indexCatalog(makeCatalog());
+        const groups = selectRelevantGroups(index, "create a new conversation");
+
+        const system = groups.find((g) => g.host === "system");
+        expect(system).toBeDefined();
+        expect(system!.commands.map((c) => c.path)).toContain(
+            "conversation new",
+        );
+        expect(system!.actions.map((a) => a.actionName)).toContain(
+            "newConversation",
+        );
+    });
+
+    test("matches via the linked action's phrasings, not just the command text", () => {
+        const index = indexCatalog(makeCatalog());
+        // "design review" only appears in the action's phrasings.
+        const groups = selectRelevantGroups(index, "new design review");
+        const system = groups.find((g) => g.host === "system");
+        expect(system?.commands.map((c) => c.path)).toContain(
+            "conversation new",
+        );
+    });
+
+    test("falls back to all commands when nothing matches", () => {
+        const index = indexCatalog(makeCatalog());
+        const groups = selectRelevantGroups(index, "xyzzy nothing matches");
+        const paths = groups.flatMap((g) => g.commands.map((c) => c.path));
+        expect(paths).toContain("conversation new");
+        expect(paths).toContain("history save");
+    });
+});
+
+describe("formatGrounding", () => {
+    test("surfaces the command's action link and the action's phrasings", () => {
+        const index = indexCatalog(makeCatalog());
+        const text = formatGrounding(
+            selectRelevantGroups(index, "create a new conversation"),
+        );
+        expect(text).toContain('commandPath: "conversation new"');
+        expect(text).toContain("(action: newConversation)");
+        expect(text).toContain('actionName: "newConversation"');
+        expect(text).toContain("start a new conversation");
+    });
+});
+
+describe("renderStructured", () => {
+    test("renders the command as a card with the paired phrasing from the link alone", () => {
+        const index = indexCatalog(makeCatalog());
+        // The model returned only the command; the phrasings come from the
+        // command's declared action link, not from the model.
+        const response: CommandHelpResponse = {
+            summary: "Use the conversation command.",
+            ways: [
+                { host: "system", commandPath: "conversation new", does: "" },
+            ],
+        };
+        const blocks = renderStructured(response, index);
+        expect(blocks[0]).toMatchObject({
+            kind: "text",
+            text: "Use the conversation command.",
+        });
+        const card = blocks.find((b) => b.kind === "card") as any;
+        expect(card).toBeDefined();
+        expect(card.title).toBe("@conversation new [<name>]");
+        expect(card.subtitle).toBe(
+            "Create a new conversation, optionally with a name",
+        );
+        expect(card.fields[0].label).toBe("Or say");
+        expect(card.fields[0].value).toContain("start a new conversation");
+    });
+
+    test("a command with no action link has no phrasing field", () => {
+        const index = indexCatalog(makeCatalog());
+        const response: CommandHelpResponse = {
+            summary: "Save it.",
+            ways: [{ host: "system", commandPath: "history save", does: "" }],
+        };
+        const card = renderStructured(response, index).find(
+            (b) => b.kind === "card",
+        ) as any;
+        expect(card.title).toBe("@history save <file>");
+        expect(card.fields).toBeUndefined();
+    });
+
+    test("empty ways points the user at @help", () => {
+        const index = indexCatalog(makeCatalog());
+        const blocks = renderStructured({ summary: "", ways: [] }, index);
+        const text = blocks
+            .filter((b) => b.kind === "text")
+            .map((b) => (b as any).text)
+            .join(" ");
+        expect(text).toContain("@help");
+    });
+});
+
+describe("cleanPhrasing", () => {
+    test("drops {polite} filler and shows slots as <slot>", () => {
+        expect(
+            cleanPhrasing("{polite} create new conversation called {name}"),
+        ).toBe("create new conversation called <name>");
+        expect(cleanPhrasing("{polite} new conversation")).toBe(
+            "new conversation",
+        );
+    });
+});
+
+describe("cleanDescription", () => {
+    test("drops few-shot examples and JSON blobs", () => {
+        expect(
+            cleanDescription(
+                'Create a new conversation. Example: User: new conversation Agent: { actionName: "newConversation", parameters: {} }',
+            ),
+        ).toBe("Create a new conversation.");
+    });
+});
diff --git a/ts/packages/agents/selfhelp/test/tsconfig.json b/ts/packages/agents/selfhelp/test/tsconfig.json
new file mode 100644
index 0000000000..895a6f0d21
--- /dev/null
+++ b/ts/packages/agents/selfhelp/test/tsconfig.json
@@ -0,0 +1,14 @@
+{
+  "extends": "../../../../tsconfig.base.json",
+  "compilerOptions": {
+    "composite": true,
+    "rootDir": ".",
+    "outDir": "../dist/test",
+    "types": ["node", "jest"]
+  },
+  "include": ["./**/*"],
+  "ts-node": {
+    "esm": true
+  },
+  "references": [{ "path": "../src" }]
+}
diff --git a/ts/packages/agents/selfhelp/tsconfig.json b/ts/packages/agents/selfhelp/tsconfig.json
new file mode 100644
index 0000000000..94dfc60bb1
--- /dev/null
+++ b/ts/packages/agents/selfhelp/tsconfig.json
@@ -0,0 +1,11 @@
+{
+  "extends": "../../../tsconfig.base.json",
+  "compilerOptions": {
+    "composite": true
+  },
+  "include": [],
+  "references": [{ "path": "./src" }, { "path": "./test" }],
+  "ts-node": {
+    "esm": true
+  }
+}
diff --git a/ts/packages/cache/README.AUTOGEN.md b/ts/packages/cache/README.AUTOGEN.md
index 081dc14b05..d1528496d1 100644
--- a/ts/packages/cache/README.AUTOGEN.md
+++ b/ts/packages/cache/README.AUTOGEN.md
@@ -3,28 +3,28 @@
 
 <!-- AUTOGEN:DOCS:START -->
 
-<!-- AUTOGEN:DOCS:HASH:sha256=e9d5c7a706c1e87cd03d30cca526aebe289f829885cd0345f27e0b3258cb14aa -->
+<!-- AUTOGEN:DOCS:HASH:sha256=e95b080714181f9d7cd1ee1d45d0d2f600d3e9164337a3e31e62fa836a6bbf3d -->
 <!-- AUTOGEN:DOCS:SOURCE: ./README.md (hand-written documentation; this file is the AI-generated companion) -->
 
-# agent-cache — AI-generated documentation
+# @typeagent/agent-cache — AI-generated documentation
 
 > 🤖 **AI-authored documentation**, regenerated daily and validated for length, tone, and link integrity. Cross-check against the deterministic Reference section below before relying on specifics. Hand-written context from [`./README.md`](./README.md) was provided to the model as authoritative source. May lag the working tree by up to 24h — see the staleness footer at the end of this file.
 
 ## Overview
 
-The `agent-cache` package is a TypeScript library that provides a construction cache for handling TypeAgent requests. It is designed to optimize the processing of user requests by caching parsed grammar and rules, referred to as "constructions." These constructions enable the system to perform local translations of user requests, bypassing the need for repeated interactions with external Large Language Models (LLMs). This reduces latency and improves overall system efficiency.
+The `@typeagent/agent-cache` package is a TypeScript library that provides a construction cache for TypeAgent requests. It is a core component of the TypeAgent ecosystem, designed to optimize the handling of user requests by caching parsed grammar and rules, referred to as "constructions." These constructions enable local processing of user requests, reducing reliance on external Large Language Models (LLMs) and improving system efficiency.
 
 ## What it does
 
-The `agent-cache` package plays a critical role in the TypeAgent ecosystem by managing the explanation and caching of user request transformations. Its primary capabilities include:
+The `agent-cache` package focuses on managing the explanation and caching of user request transformations. Its key functionalities include:
 
-- **Request Explanation**: The package uses actions like `explainRequest` to analyze and explain how user requests are transformed into actions. This explanation is then used to generate constructions.
+- **Request Explanation**: Actions like `explainRequest` analyze and explain how user requests are transformed into actions. These explanations are used to generate constructions.
 - **Construction Caching**: Constructions derived from user requests are stored using actions like `cacheConstruction`. These cached constructions can be reused for similar requests, reducing the need for repeated LLM queries.
 - **Local Request Translation**: Cached constructions allow the system to translate user requests locally, bypassing the LLM and improving response times.
-- **Cache Management**: The package provides tools for managing construction caches, such as loading pre-existing cache files with the `loadConstructionCacheFile` action.
-- **Support for Multiple Explainers**: The package supports multiple explainers, each with its own validator and construction creator. This enables experimentation with different explanation and translation approaches.
+- **Cache Management**: Tools are provided for managing construction caches, such as loading pre-existing cache files with the `loadConstructionCacheFile` action.
+- **Support for Multiple Explainers**: The package supports multiple explainers, each with its own validator and construction creator. This allows experimentation with different explanation and translation approaches.
 
-By leveraging these features, `agent-cache` enhances the efficiency and scalability of the TypeAgent system.
+By leveraging these features, `agent-cache` enhances the efficiency and scalability of the TypeAgent system, enabling faster and more reliable processing of user requests.
 
 ## Setup
 
@@ -39,9 +39,9 @@ To use the `agent-cache` package, follow these steps:
      - `@typeagent/agent-sdk`
      - `@typeagent/aiclient`
      - `@typeagent/common-utils`
-     - `telemetry`
+     - `@typeagent/telemetry`
+     - `@typeagent/typechat-utils`
      - `test-lib`
-     - `typechat-utils`
    - Ensure the following external dependencies are installed:
      - `async`
      - `chalk`
@@ -144,15 +144,16 @@ Workspace:
 - [@typeagent/agent-sdk](../../packages/agentSdk/README.md)
 - [@typeagent/aiclient](../../packages/aiclient/README.md)
 - [@typeagent/common-utils](../../packages/utils/commonUtils/README.md)
-- [telemetry](../../packages/telemetry/README.md)
+- [@typeagent/telemetry](../../packages/telemetry/README.md)
+- [@typeagent/typechat-utils](../../packages/utils/typechatUtils/README.md)
 - [test-lib](../../packages/testLib/README.md)
-- [typechat-utils](../../packages/utils/typechatUtils/README.md)
 
 External: `async`, `chalk`, `debug`, `regexp.escape`, `typechat`
 
 ### Used by
 
 - [@typeagent/core](../../packages/typeagent-core/README.md)
+- [@typeagent/desktop-automation](../../packages/agents/desktop/README.md)
 - [agent-api](../../packages/api/README.md)
 - [agent-cache-explorer](../../packages/cacheExplorer/README.md)
 - [agent-cli](../../packages/cli/README.md)
@@ -160,7 +161,6 @@ External: `async`, `chalk`, `debug`, `regexp.escape`, `typechat`
 - [agent-sdk-wrapper](../../packages/agentSdkWrapper/README.md)
 - [cache-rest-endpoint](../../examples/cacheRESTEndpoint/README.md)
 - [default-agent-provider](../../packages/defaultAgentProvider/README.md)
-- [desktop-automation](../../packages/agents/desktop/README.md)
 - schema-studio
 
 ### Files of interest
@@ -179,6 +179,6 @@ External: `async`, `chalk`, `debug`, `regexp.escape`, `typechat`
 
 ---
 
-_Auto-generated against commit `8192acc149ab6f52296dcc71202b20253b6a3089` on `2026-07-22T05:16:33.340Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter agent-cache docs:verify-links` to spot-check._
+_Auto-generated against commit `5018562335eded84b16dedcbb8e86d59b538a978` on `2026-07-30T06:29:20.146Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter @typeagent/agent-cache docs:verify-links` to spot-check._
 
 <!-- AUTOGEN:DOCS:END -->
diff --git a/ts/packages/cache/src/cache/cache.ts b/ts/packages/cache/src/cache/cache.ts
index 55fe869d1f..332b2c27ef 100644
--- a/ts/packages/cache/src/cache/cache.ts
+++ b/ts/packages/cache/src/cache/cache.ts
@@ -598,7 +598,10 @@ export class AgentCache {
                 // TODO: Move this in the construction store
                 return constructionMatches.map((m) => {
                     const { construction, ...rest } = m;
-                    return rest;
+                    // Keep a lightweight string of the matched construction
+                    // (not the heavy object) so callers can display the rule
+                    // that was triggered.
+                    return { ...rest, ruleText: construction.toString() };
                 });
             }
             if (!grammarStore.isEnabled()) {
diff --git a/ts/packages/cache/src/cache/types.ts b/ts/packages/cache/src/cache/types.ts
index a7e2d13125..06dd502a4e 100644
--- a/ts/packages/cache/src/cache/types.ts
+++ b/ts/packages/cache/src/cache/types.ts
@@ -15,6 +15,7 @@ export type MatchResult = {
     partialPartCount?: number | undefined; // Only used for partial match
     partialMatchedCurrent?: number | undefined; // Character offset where partial matching stopped
     matchedStarts?: readonly number[] | undefined; // Start position of each matched part (partial only; -1 = optional skipped)
+    ruleText?: string | undefined; // The matched construction/rule pattern, for display (construction store only)
 };
 
 export interface GrammarStore {
diff --git a/ts/packages/chat-ui/README.AUTOGEN.md b/ts/packages/chat-ui/README.AUTOGEN.md
index 81da66282e..de02db940b 100644
--- a/ts/packages/chat-ui/README.AUTOGEN.md
+++ b/ts/packages/chat-ui/README.AUTOGEN.md
@@ -3,7 +3,7 @@
 
 <!-- AUTOGEN:DOCS:START -->
 
-<!-- AUTOGEN:DOCS:HASH:sha256=15ee56d87e10ae7094dc91827e8bc977cba2da1d9941305c88572905f2c8dcad -->
+<!-- AUTOGEN:DOCS:HASH:sha256=4f66b584686aa5dfb38c578f68524186f16edc144eabd5397804088f714e1ee2 -->
 <!-- AUTOGEN:DOCS:SOURCE: ./README.md (hand-written documentation; this file is the AI-generated companion) -->
 
 # @typeagent/chat-ui — AI-generated documentation
@@ -12,19 +12,19 @@
 
 ## Overview
 
-The `@typeagent/chat-ui` package provides a shared, framework-free chat user interface for various TypeAgent applications. It is designed to deliver a consistent and interactive chat experience across multiple platforms, including the VS Code shell extension, the browser extension chat panel, and the Visual Studio extension webview. The package includes components for rendering chat messages, handling streaming updates, replaying chat history, managing connection status, and collecting user feedback.
+The `@typeagent/chat-ui` package provides a shared, framework-free chat user interface for TypeAgent applications. It is designed to deliver a consistent and interactive chat experience across multiple platforms, including the VS Code shell extension, the browser extension chat panel, and the Visual Studio extension webview. The package includes components for rendering chat messages, handling streaming updates, replaying chat history, managing connection status, and collecting user feedback.
 
-This package is a TypeScript library that ships with both TypeScript source files and CSS styles. It is designed to be integrated into host applications, which are responsible for managing the chat interface and its interactions with users and agents.
+This TypeScript library ships with both TypeScript source files and CSS styles, making it easy to integrate into host applications. Hosts are responsible for managing the chat interface and its interactions with users and agents.
 
 ## What it does
 
 The `@typeagent/chat-ui` package provides the following key features:
 
-- **ChatPanel**: The core component for rendering the chat interface. It supports:
+- **ChatPanel**: The primary component for rendering the chat interface. It supports:
 
-  - Adding user and agent messages using `addAgentMessage`.
+  - Adding user and agent messages via `addAgentMessage`.
   - Updating display metadata with `setDisplayInfo`.
-  - Replaying historical chat entries via `replayHistory`.
+  - Replaying historical chat entries using `replayHistory`.
   - Streaming updates for dynamic content display.
 
 - **FeedbackWidget**: A component for collecting user feedback, including thumbs-up/thumbs-down ratings, comments, and contextual information.
@@ -122,6 +122,6 @@ External: `ansi_up`, `dompurify`, `markdown-it`
 
 ---
 
-_Auto-generated against commit `fa4bb9b44db12e2d15b83e03e59f9c7147ed2b50` on `2026-07-27T19:08:36.121Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter @typeagent/chat-ui docs:verify-links` to spot-check._
+_Auto-generated against commit `5018562335eded84b16dedcbb8e86d59b538a978` on `2026-07-30T06:29:20.146Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter @typeagent/chat-ui docs:verify-links` to spot-check._
 
 <!-- AUTOGEN:DOCS:END -->
diff --git a/ts/packages/chat-ui/src/chatPanel.ts b/ts/packages/chat-ui/src/chatPanel.ts
index 4bf7377c65..913549daff 100644
--- a/ts/packages/chat-ui/src/chatPanel.ts
+++ b/ts/packages/chat-ui/src/chatPanel.ts
@@ -21,6 +21,8 @@ import type {
     PhaseTiming,
     CompletionUsageStats,
     NotifyExplainedData,
+    ExplainedDetail,
+    ExplainedSegment,
     RequestId,
     UserFeedbackCategory,
     UserFeedbackEntry,
@@ -101,6 +103,7 @@ export const DEFAULT_AVATAR_MAP: Readonly<Record<string, string>> = {
     calendar: "📅",
     chat: "💬",
     code: "⚛️",
+    conversation: "💬",
     desktop: "🪟",
     dispatcher: "🤖",
     email: "📩",
@@ -116,6 +119,7 @@ export const DEFAULT_AVATAR_MAP: Readonly<Record<string, string>> = {
     photo: "📷",
     player: "🎧",
     scriptflow: "🔁",
+    selfhelp: "💡",
     settings: "⚙️",
     shell: "🐚",
     spelunker: "⛏",
@@ -147,7 +151,12 @@ export interface DynamicDisplayResult {
 // pulling dispatcher-types in; the rationale is stale now that
 // dispatcher-types is a small types package with minimal dependencies (just
 // @typeagent/agent-sdk, which chat-ui already depends on).
-export type { PhaseTiming, CompletionUsageStats, NotifyExplainedData };
+export type {
+    PhaseTiming,
+    CompletionUsageStats,
+    NotifyExplainedData,
+    ExplainedDetail,
+};
 
 /**
  * One entry in a session history transcript replayed via
@@ -191,6 +200,7 @@ export type HistoryEntry =
           parsePhase?: PhaseTiming;
           firstMessageMs?: number;
       }
+    | { kind: "explained"; requestId: string; data: NotifyExplainedData }
     | { kind: "system"; text: string };
 
 /**
@@ -757,6 +767,12 @@ export class ChatPanel {
     // dispatcher reports back. Cleared by clear().
     private userMessageById = new Map<string, HTMLElement>();
 
+    // The most recent "explained" payload per requestId, captured by
+    // notifyExplained so the click-to-open roadrunner popover can render the
+    // triggered rule / generalized form and its parameter mapping. Cleared by
+    // clear().
+    private explainedById = new Map<string, NotifyExplainedData>();
+
     // The command actually submitted for each requestId, keyed by the id
     // stamped on the user bubble. `command` is what was sent to `onSend`
     // (may be an @-command); `displayText` is what the bubble shows (the
@@ -3761,6 +3777,12 @@ export class ChatPanel {
                     });
                 }
                 break;
+            case "explained":
+                // Re-attach the roadrunner icon + click-to-open popover to the
+                // replayed user bubble (the "explained" notify is persisted so
+                // it survives conversation rehydration).
+                this.notifyExplained(entry.requestId, entry.data);
+                break;
         }
     }
 
@@ -3853,6 +3875,7 @@ export class ChatPanel {
         this.pendingThreadDisplayInfo.clear();
         this.pendingThreadResult.clear();
         this.userMessageById.clear();
+        this.explainedById.clear();
         this.sentCommandByRequestId.clear();
         this.requestStartByRequestId.clear();
         this.firstMessageMsByRequestId.clear();
@@ -3893,6 +3916,10 @@ export class ChatPanel {
         const container = this.userMessageById.get(requestId);
         if (!container) return;
 
+        // Keep the payload so the click-to-open popover can render the
+        // triggered rule / generalized form and its parameter mapping.
+        this.explainedById.set(requestId, data);
+
         const cachePart = data.fromCache
             ? `Translated by ${data.fromCache}`
             : "Translated by model";
@@ -3925,15 +3952,444 @@ export class ChatPanel {
         iconHost.classList.add("chat-message-explained-host");
         tooltipHost.classList.add("chat-message-explained");
         tooltipHost.setAttribute("data-expl", message);
-        iconHost.appendChild(iconRoadrunner(color));
+
+        const icon = iconRoadrunner(color);
+        // The roadrunner is now an interactive control: clicking it opens a
+        // popover explaining how the phrase was resolved. Keep the hover
+        // tooltip (the provenance line) as a quick-glance affordance.
+        icon.setAttribute("role", "button");
+        icon.setAttribute("tabindex", "0");
+        icon.setAttribute("aria-label", "Show translation explanation");
+        icon.style.cursor = "pointer";
+        icon.addEventListener("click", (e) => {
+            e.stopPropagation();
+            this.toggleExplainedPopover(requestId, tooltipHost, icon);
+        });
+        icon.addEventListener("keydown", (e) => {
+            if (e.key === "Enter" || e.key === " ") {
+                e.preventDefault();
+                this.toggleExplainedPopover(requestId, tooltipHost, icon);
+            }
+        });
+        iconHost.appendChild(icon);
     }
 
     /**
-     * Update the roadrunner color and tooltip on the "grammarRule" follow-up
-     * notification. If a rule wasn't cached, recolors the icon and extends
-     * the tooltip; succeeded rules leave the icon as-is. Mirrors the shell's
-     * MessageContainer.updateGrammarResult.
+     * Toggle the explanation popover for a user bubble. Clicking the
+     * roadrunner opens a card describing how the phrase was resolved: either
+     * the triggered grammar rule / construction and the parameter mapping, or
+     * the generalized form the model produced. Clicking the icon again (or
+     * outside the popover, or pressing Escape) closes it.
      */
+    private toggleExplainedPopover(
+        requestId: string,
+        host: HTMLElement,
+        anchor: HTMLElement,
+    ) {
+        // The message container carries a `transform` (entrance animation),
+        // which traps the popover's z-index inside the bubble's own stacking
+        // context. Elevate the whole container while the popover is open so it
+        // paints above neighboring bubbles. Derive it from the DOM (not
+        // userMessageById, which is cleared after history replay).
+        const container = host.closest<HTMLElement>(
+            ".chat-message-container-user",
+        );
+        const existing = host.querySelector(".chat-explained-popover");
+        if (existing) {
+            existing.remove();
+            host.classList.remove("chat-explained-open");
+            container?.classList.remove("chat-explained-elevated");
+            return;
+        }
+        const data = this.explainedById.get(requestId);
+        if (!data) return;
+
+        const popover = this.buildExplainedPopover(data, host);
+        const close = () => {
+            popover.remove();
+            host.classList.remove("chat-explained-open");
+            container?.classList.remove("chat-explained-elevated");
+            document.removeEventListener("keydown", onKey, true);
+            document.removeEventListener("mousedown", onOutside, true);
+        };
+        const onKey = (e: KeyboardEvent) => {
+            if (e.key === "Escape") {
+                e.preventDefault();
+                close();
+            }
+        };
+        const onOutside = (e: MouseEvent) => {
+            const target = e.target as Node;
+            if (!popover.contains(target) && !anchor.contains(target)) {
+                close();
+            }
+        };
+
+        const closeBtn = popover.querySelector<HTMLElement>(
+            ".chat-explained-popover-close",
+        );
+        closeBtn?.addEventListener("click", (e) => {
+            e.stopPropagation();
+            close();
+        });
+
+        host.appendChild(popover);
+        host.classList.add("chat-explained-open");
+        container?.classList.add("chat-explained-elevated");
+        // Defer listener registration so the opening click doesn't
+        // immediately trigger the outside-click handler.
+        setTimeout(() => {
+            document.addEventListener("keydown", onKey, true);
+            document.addEventListener("mousedown", onOutside, true);
+        }, 0);
+    }
+
+    /**
+     * Render the explanation popover card for an "explained" payload. When the
+     * dispatcher supplied structured `detail`, show the phrase, the resolved
+     * action, the rule / generalized form, and the parameter mapping;
+     * otherwise fall back to the provenance line. `surface` is a themed,
+     * in-DOM element used to pick a light- or dark-appropriate category
+     * palette.
+     */
+    private buildExplainedPopover(
+        data: NotifyExplainedData,
+        surface: HTMLElement,
+    ): HTMLElement {
+        const dark = ChatPanel.isDarkSurface(surface);
+        const popover = document.createElement("div");
+        popover.className = "chat-explained-popover";
+
+        const header = document.createElement("div");
+        header.className = "chat-explained-popover-header";
+        const title = document.createElement("span");
+        title.className = "chat-explained-popover-title";
+        const detail = data.detail;
+        title.textContent =
+            detail === undefined || detail.source === "model"
+                ? "Generalized by the model"
+                : detail.source === "grammar"
+                  ? "Matched a grammar rule"
+                  : "Matched a cached construction";
+        header.appendChild(title);
+        const closeBtn = document.createElement("button");
+        closeBtn.className = "chat-explained-popover-close";
+        closeBtn.setAttribute("aria-label", "Close");
+        closeBtn.textContent = "×";
+        header.appendChild(closeBtn);
+        popover.appendChild(header);
+
+        const addRow = (label: string, value: string, mono = false) => {
+            const row = document.createElement("div");
+            row.className = "chat-explained-row";
+            const key = document.createElement("div");
+            key.className = "chat-explained-key";
+            key.textContent = label;
+            const val = document.createElement("div");
+            val.className = mono
+                ? "chat-explained-val chat-explained-mono"
+                : "chat-explained-val";
+            val.textContent = value;
+            row.appendChild(key);
+            row.appendChild(val);
+            popover.appendChild(row);
+        };
+
+        if (detail) {
+            // Assign a stable color per sub-phrase category (politeness,
+            // action, entity, ...) so a phrase word and its matching
+            // generalized-form marker share a color.
+            const colors = this.buildCategoryColors(
+                detail.segments,
+                detail.rule,
+                detail.generalizations,
+                dark,
+            );
+
+            const phraseRow = document.createElement("div");
+            phraseRow.className = "chat-explained-row";
+            const phraseKey = document.createElement("div");
+            phraseKey.className = "chat-explained-key";
+            phraseKey.textContent = "Phrase";
+            const phraseVal = document.createElement("div");
+            phraseVal.className = "chat-explained-val chat-explained-phrase";
+            if (detail.segments && detail.segments.length > 0) {
+                this.appendColoredSegments(phraseVal, detail.segments, colors);
+            } else {
+                phraseVal.textContent = detail.phrase;
+            }
+            phraseRow.appendChild(phraseKey);
+            phraseRow.appendChild(phraseVal);
+            popover.appendChild(phraseRow);
+
+            addRow("Action", detail.action, true);
+            if (detail.rule) {
+                const ruleRow = document.createElement("div");
+                ruleRow.className = "chat-explained-row";
+                const ruleKey = document.createElement("div");
+                ruleKey.className = "chat-explained-key";
+                ruleKey.textContent =
+                    detail.source === "model" ? "Generalized form" : "Rule";
+                const ruleVal = document.createElement("div");
+                ruleVal.className = "chat-explained-val chat-explained-mono";
+                // Each <...> marker is colored to match the phrase words it
+                // generalizes (same category color).
+                this.appendGeneralizedForm(ruleVal, detail.rule, colors);
+                ruleRow.appendChild(ruleKey);
+                ruleRow.appendChild(ruleVal);
+                popover.appendChild(ruleRow);
+
+                if (colors.size > 0) {
+                    const legend = document.createElement("div");
+                    legend.className = "chat-explained-legend";
+                    for (const [category, color] of colors) {
+                        const item = document.createElement("span");
+                        item.className = "chat-explained-legend-item";
+                        const swatch = document.createElement("span");
+                        swatch.className = "chat-explained-swatch";
+                        swatch.style.backgroundColor = color;
+                        item.appendChild(swatch);
+                        item.appendChild(document.createTextNode(category));
+                        legend.appendChild(item);
+                    }
+                    popover.appendChild(legend);
+                }
+            }
+
+            if (detail.mapping && detail.mapping.length > 0) {
+                const mapLabel = document.createElement("div");
+                mapLabel.className =
+                    "chat-explained-key chat-explained-maphead";
+                mapLabel.textContent = "Mapping";
+                popover.appendChild(mapLabel);
+                const table = document.createElement("div");
+                table.className = "chat-explained-map";
+                for (const m of detail.mapping) {
+                    const name = document.createElement("div");
+                    name.className = "chat-explained-mapname";
+                    name.textContent = m.name;
+                    const value = document.createElement("div");
+                    value.className = "chat-explained-mapval";
+                    value.textContent = m.value;
+                    table.appendChild(name);
+                    table.appendChild(value);
+                }
+                popover.appendChild(table);
+            }
+
+            if (detail.generalizations && detail.generalizations.length > 0) {
+                this.appendGeneralizations(
+                    popover,
+                    detail.generalizations,
+                    colors,
+                );
+            }
+        }
+
+        // Always include the provenance line at the foot for context.
+        const foot = document.createElement("div");
+        foot.className = "chat-explained-foot";
+        const cachePart = data.fromCache
+            ? `Translated by ${data.fromCache}`
+            : "Translated by model";
+        foot.textContent =
+            data.error === undefined
+                ? `${cachePart} · explained at ${data.time}`
+                : `${cachePart} · ${data.error}`;
+        popover.appendChild(foot);
+
+        return popover;
+    }
+
+    /**
+     * Category color palettes for the explained popover. The light palette is
+     * darker/saturated to read on light surfaces; the dark palette is brighter
+     * to read on dark surfaces. Same length so a category keeps its slot.
+     */
+    private static readonly EXPLAINED_PALETTE_LIGHT = [
+        "#1a7f37", // green
+        "#9126c4", // purple
+        "#1667b8", // blue
+        "#c2410c", // orange
+        "#0e7490", // teal
+        "#be185d", // magenta
+        "#8a6d00", // gold
+        "#5b21b6", // indigo
+    ];
+    private static readonly EXPLAINED_PALETTE_DARK = [
+        "#4ade80", // green
+        "#c084fc", // purple
+        "#60a5fa", // blue
+        "#fb923c", // orange
+        "#22d3ee", // cyan
+        "#f472b6", // pink
+        "#fcd34d", // yellow
+        "#a78bfa", // violet
+    ];
+
+    /**
+     * Whether `el` renders on a dark surface, by luminance of its resolved
+     * (themed) text color: light text implies a dark background. Used to pick
+     * the category palette so colors stay legible under both host themes.
+     */
+    private static isDarkSurface(el: HTMLElement): boolean {
+        const match = getComputedStyle(el).color.match(
+            /rgba?\(\s*(\d+)[,\s]+(\d+)[,\s]+(\d+)/i,
+        );
+        if (!match) return false;
+        const luminance =
+            (0.299 * +match[1] + 0.587 * +match[2] + 0.114 * +match[3]) / 255;
+        return luminance > 0.55;
+    }
+
+    /**
+     * The category name inside a generalized-form marker, e.g. "<M:action>" ->
+     * "action", "<politeness>?" -> "politeness".
+     */
+    private static markerCategory(token: string): string {
+        return token.replace(/^</, "").replace(/>\??$/, "").replace(/^M:/, "");
+    }
+
+    /**
+     * Assign a stable color per sub-phrase category, drawn first from the
+     * phrase segments (in order) then any extra categories that appear only in
+     * the rule markers or the sample rephrasings, so every place a category
+     * appears shares one color.
+     */
+    private buildCategoryColors(
+        segments: ExplainedDetail["segments"],
+        rule: string | undefined,
+        generalizations: ExplainedDetail["generalizations"],
+        dark: boolean,
+    ): Map<string, string> {
+        const palette = dark
+            ? ChatPanel.EXPLAINED_PALETTE_DARK
+            : ChatPanel.EXPLAINED_PALETTE_LIGHT;
+        const colors = new Map<string, string>();
+        const assign = (category: string | undefined) => {
+            if (category && !colors.has(category)) {
+                colors.set(category, palette[colors.size % palette.length]);
+            }
+        };
+        for (const seg of segments ?? []) assign(seg.category);
+        if (rule) {
+            for (const token of rule.match(/<[^>]+>\??/g) ?? []) {
+                assign(ChatPanel.markerCategory(token));
+            }
+        }
+        for (const gen of generalizations ?? []) {
+            if (Array.isArray(gen)) {
+                for (const seg of gen) assign(seg?.category);
+            }
+        }
+        return colors;
+    }
+
+    /**
+     * Render per-category-colored segment spans (a phrase or a sample
+     * rephrasing) into `container`, separated by spaces.
+     */
+    private appendColoredSegments(
+        container: HTMLElement,
+        segments: ExplainedSegment[],
+        colors: Map<string, string>,
+    ) {
+        segments.forEach((seg, i) => {
+            if (i > 0) container.appendChild(document.createTextNode(" "));
+            const span = document.createElement("span");
+            span.textContent = seg?.text ?? "";
+            span.style.color = colors.get(seg?.category) ?? "";
+            container.appendChild(span);
+        });
+    }
+
+    /**
+     * Render a generalized-form string into `container`, splitting `<...>`
+     * markers from the literal text and coloring each marker to match the
+     * phrase words it generalizes (via the category color map).
+     */
+    private appendGeneralizedForm(
+        container: HTMLElement,
+        form: string,
+        colors: Map<string, string>,
+    ) {
+        const markerRe = /<[^>]+>\??/g;
+        let last = 0;
+        let match: RegExpExecArray | null;
+        const addLiteral = (text: string) => {
+            if (!text) return;
+            const span = document.createElement("span");
+            span.className = "chat-explained-literal";
+            span.textContent = text;
+            container.appendChild(span);
+        };
+        while ((match = markerRe.exec(form)) !== null) {
+            addLiteral(form.slice(last, match.index));
+            const span = document.createElement("span");
+            span.className = "chat-explained-marker";
+            span.textContent = match[0];
+            span.style.color =
+                colors.get(ChatPanel.markerCategory(match[0])) ?? "";
+            container.appendChild(span);
+            last = match.index + match[0].length;
+        }
+        addLiteral(form.slice(last));
+    }
+
+    /**
+     * Render the "also matches" list of same-meaning rephrasings, each colored
+     * by category like the phrase. Shows the first few and reveals the rest
+     * behind a "load more" link.
+     */
+    private appendGeneralizations(
+        popover: HTMLElement,
+        gens: NonNullable<ExplainedDetail["generalizations"]>,
+        colors: Map<string, string>,
+    ) {
+        const INITIAL = 3;
+        const label = document.createElement("div");
+        label.className = "chat-explained-key chat-explained-maphead";
+        label.textContent = "Also matches";
+        popover.appendChild(label);
+
+        const list = document.createElement("div");
+        list.className = "chat-explained-gens";
+        popover.appendChild(list);
+
+        const moreLink = document.createElement("button");
+        moreLink.type = "button";
+        moreLink.className = "chat-explained-more";
+        popover.appendChild(moreLink);
+
+        let shown = 0;
+        const reveal = (count: number) => {
+            const end = Math.min(shown + count, gens.length);
+            for (let i = shown; i < end; i++) {
+                const item = document.createElement("div");
+                item.className = "chat-explained-gen";
+                const gen = gens[i];
+                if (typeof gen === "string") {
+                    item.textContent = gen;
+                } else if (Array.isArray(gen)) {
+                    this.appendColoredSegments(item, gen, colors);
+                }
+                list.appendChild(item);
+            }
+            shown = end;
+            const remaining = gens.length - shown;
+            if (remaining <= 0) {
+                moreLink.remove();
+            } else {
+                moreLink.textContent = `load ${remaining} more`;
+            }
+        };
+        moreLink.addEventListener("click", (e) => {
+            e.stopPropagation();
+            reveal(gens.length);
+        });
+        reveal(INITIAL);
+    }
+
     public updateGrammarResult(
         requestId: string,
         success: boolean,
diff --git a/ts/packages/chat-ui/styles/chat.css b/ts/packages/chat-ui/styles/chat.css
index a262dc6b1c..12bb80f56e 100644
--- a/ts/packages/chat-ui/styles/chat.css
+++ b/ts/packages/chat-ui/styles/chat.css
@@ -2130,10 +2130,205 @@ table.sc-kv-table.sc-card-fields {
   cursor: help;
 }
 
+/* =========================================================================
+   Explained popover (click the roadrunner)
+   ========================================================================= */
+
+/* While the popover is open, lift the whole message container above its
+   neighbors. The container's entrance-animation `transform` makes it a
+   stacking context, so the popover's own z-index can't escape it; elevating
+   the container is what actually puts the popover on top of sibling bubbles. */
+.chat-message-container-user.chat-explained-elevated {
+  z-index: 30;
+}
+
+/* Anchored to the bubble body (which doesn't clip overflow) and floated above
+   the bubble's top-right so it never covers the command text or the
+   bottom-anchored metrics strip. */
+.chat-explained-popover {
+  position: absolute;
+  bottom: calc(100% + 4px);
+  right: 0;
+  z-index: 20;
+  width: max-content;
+  max-width: 360px;
+  box-sizing: border-box;
+  padding: 8px 10px 9px;
+  border: 1px solid var(--chat-conversation-border, rgba(0, 0, 0, 0.2));
+  border-radius: 8px;
+  background-color: var(--chat-conversation-popover-background, #fffdf5);
+  color: var(--chat-conversation-foreground, #202020);
+  box-shadow: 0 4px 14px
+    var(--chat-conversation-popover-shadow, rgba(0, 0, 0, 0.18));
+  font-size: 12px;
+  text-align: left;
+  cursor: default;
+}
+
+.chat-explained-popover-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 10px;
+  margin-bottom: 6px;
+}
+
+.chat-explained-popover-title {
+  font-weight: 600;
+}
+
+.chat-explained-popover-close {
+  border: none;
+  background: transparent;
+  cursor: pointer;
+  font-size: 15px;
+  line-height: 1;
+  padding: 0 2px;
+  color: inherit;
+}
+
+.chat-explained-row {
+  display: grid;
+  grid-template-columns: 84px 1fr;
+  gap: 8px;
+  margin: 3px 0;
+}
+
+.chat-explained-key {
+  color: var(--chat-conversation-muted-foreground, gray);
+  font-weight: 600;
+}
+
+.chat-explained-maphead {
+  margin-top: 6px;
+}
+
+.chat-explained-val {
+  overflow-wrap: anywhere;
+}
+
+.chat-explained-mono {
+  font-family: var(--monospace-font, ui-monospace, Menlo, Consolas, monospace);
+  white-space: pre-wrap;
+}
+
+.chat-explained-map {
+  display: grid;
+  grid-template-columns: auto 1fr;
+  gap: 2px 8px;
+  margin-top: 3px;
+  padding: 4px 6px;
+  border-radius: 6px;
+  background-color: var(
+    --chat-conversation-list-hover-background,
+    rgba(0, 0, 0, 0.04)
+  );
+}
+
+.chat-explained-mapname {
+  font-family: var(--monospace-font, ui-monospace, Menlo, Consolas, monospace);
+  color: var(--chat-conversation-muted-foreground, #555);
+  overflow-wrap: anywhere;
+}
+
+.chat-explained-mapval {
+  overflow-wrap: anywhere;
+}
+
+.chat-explained-foot {
+  margin-top: 7px;
+  padding-top: 6px;
+  border-top: 1px solid
+    var(
+      --chat-conversation-separator-color,
+      var(--chat-conversation-border, rgba(0, 0, 0, 0.1))
+    );
+  color: var(--chat-conversation-muted-foreground, gray);
+  font-size: 11px;
+}
+
+/* Color language: each sub-phrase category (politeness, action, entity, ...)
+   gets a color (assigned inline from a palette). A phrase word and its
+   matching generalized-form marker share that color; construction literals
+   stay neutral. */
+.chat-explained-phrase {
+  color: inherit;
+}
+
+.chat-explained-literal {
+  color: var(--chat-conversation-muted-foreground, gray);
+}
+
+.chat-explained-marker {
+  font-weight: 600;
+}
+
+.chat-explained-legend {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px 12px;
+  margin: 4px 0 2px;
+  padding-left: 92px;
+  font-size: 10.5px;
+  color: var(--chat-conversation-muted-foreground, gray);
+}
+
+.chat-explained-legend-item {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+}
+
+.chat-explained-swatch {
+  width: 9px;
+  height: 9px;
+  border-radius: 2px;
+  display: inline-block;
+  box-shadow: 0 0 0 1px var(--chat-conversation-border, rgba(0, 0, 0, 0.15));
+}
+
+.chat-explained-gens {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 2px;
+  margin-top: 3px;
+  padding: 4px 6px;
+  border-radius: 6px;
+  max-height: 148px;
+  overflow: auto;
+  background-color: var(
+    --chat-conversation-list-hover-background,
+    rgba(0, 0, 0, 0.04)
+  );
+}
+
+.chat-explained-gen {
+  font-family: var(--monospace-font, ui-monospace, Menlo, Consolas, monospace);
+  color: var(--chat-conversation-foreground, #333);
+  white-space: nowrap;
+}
+
+.chat-explained-more {
+  margin-top: 5px;
+  padding: 0;
+  border: none;
+  background: transparent;
+  color: var(--chat-conversation-link-active-foreground, #1a73e8);
+  font: inherit;
+  font-size: 11px;
+  text-decoration: underline;
+  cursor: pointer;
+}
+
+.chat-explained-more:hover {
+  opacity: 0.8;
+}
+
 /* Tooltip is hosted on the bubble body (which doesn't clip overflow) and
    floats just above the bubble's top-right on hover so it never covers the
    command text or the bottom-anchored metrics strip. */
-.chat-message-explained[data-expl]:has(
+.chat-message-explained[data-expl]:not(.chat-explained-open):has(
     .chat-message-explained-icon:hover
   )::after {
   content: attr(data-expl);
diff --git a/ts/packages/chat-ui/test/chatPanel.spec.ts b/ts/packages/chat-ui/test/chatPanel.spec.ts
index 2231b17d16..59650cdb69 100644
--- a/ts/packages/chat-ui/test/chatPanel.spec.ts
+++ b/ts/packages/chat-ui/test/chatPanel.spec.ts
@@ -615,6 +615,313 @@ describe("roadrunner (explained) placement", () => {
     });
 });
 
+describe("roadrunner (explained) popover", () => {
+    it("opens a popover with the rule and mapping on click, toggles closed", () => {
+        const { root, panel } = makePanel();
+        panel.addUserMessage("play something by adele", "req-1");
+
+        panel.notifyExplained("req-1", {
+            fromCache: "construction",
+            fromUser: false,
+            time: "12:00:00 PM",
+            detail: {
+                source: "construction",
+                phrase: "play something by adele",
+                action: "player.playArtist",
+                rule: "play something by <artist>",
+                mapping: [{ name: "artist", value: "adele" }],
+            },
+        });
+
+        const bubble = userBubble(root, "req-1");
+        const icon = bubble.querySelector<HTMLElement>(
+            ".chat-message-explained-icon",
+        )!;
+        expect(icon.getAttribute("role")).toBe("button");
+
+        // No popover until clicked.
+        expect(bubble.querySelector(".chat-explained-popover")).toBeNull();
+
+        icon.click();
+        const popover = bubble.querySelector<HTMLElement>(
+            ".chat-explained-popover",
+        );
+        expect(popover).not.toBeNull();
+        expect(popover!.textContent).toContain("play something by <artist>");
+        expect(popover!.textContent).toContain("player.playArtist");
+        expect(popover!.textContent).toContain("artist");
+        expect(popover!.textContent).toContain("adele");
+        // The container is lifted above sibling bubbles while open so the
+        // popover isn't painted under a neighbor.
+        expect(bubble.classList.contains("chat-explained-elevated")).toBe(true);
+
+        // Clicking the icon again closes it.
+        icon.click();
+        expect(bubble.querySelector(".chat-explained-popover")).toBeNull();
+        expect(bubble.classList.contains("chat-explained-elevated")).toBe(
+            false,
+        );
+    });
+
+    it("shows the generalized form for a model translation", () => {
+        const { root, panel } = makePanel();
+        panel.addUserMessage("set a 5 minute timer", "req-2");
+
+        panel.notifyExplained("req-2", {
+            fromCache: false,
+            fromUser: false,
+            time: "12:01:00 PM",
+            detail: {
+                source: "model",
+                phrase: "set a 5 minute timer",
+                action: "timer.createTimer",
+                rule: "set a <duration> timer",
+                mapping: [{ name: "duration", value: "5 minutes" }],
+            },
+        });
+
+        const icon = userBubble(root, "req-2").querySelector<HTMLElement>(
+            ".chat-message-explained-icon",
+        )!;
+        icon.click();
+        const popover = userBubble(root, "req-2").querySelector<HTMLElement>(
+            ".chat-explained-popover",
+        )!;
+        expect(popover.textContent).toContain("Generalized by the model");
+        expect(popover.textContent).toContain("set a <duration> timer");
+
+        // The <duration> marker is colored distinctly from the literal words.
+        const markers = popover.querySelectorAll(".chat-explained-marker");
+        expect(markers.length).toBe(1);
+        expect(markers[0].textContent).toBe("<duration>");
+        expect(
+            popover.querySelectorAll(".chat-explained-literal").length,
+        ).toBeGreaterThan(0);
+    });
+
+    it("colors phrase words to match their generalized-form markers", () => {
+        const { root, panel } = makePanel();
+        panel.addUserMessage("please list all of the conversations", "req-c");
+
+        panel.notifyExplained("req-c", {
+            fromCache: false,
+            fromUser: false,
+            time: "12:04:00 PM",
+            detail: {
+                source: "model",
+                phrase: "please list all of the conversations",
+                action: "system.conversation.listConversation",
+                rule: "<politeness>?<M:action><politeness>?",
+                segments: [
+                    { text: "please", category: "politeness" },
+                    {
+                        text: "list all of the conversations",
+                        category: "action",
+                    },
+                ],
+            },
+        });
+
+        const bubble = userBubble(root, "req-c");
+        bubble
+            .querySelector<HTMLElement>(".chat-message-explained-icon")!
+            .click();
+        const popover = bubble.querySelector<HTMLElement>(
+            ".chat-explained-popover",
+        )!;
+
+        // Phrase words are split into per-category colored spans.
+        const phraseSpans = popover
+            .querySelector<HTMLElement>(".chat-explained-phrase")!
+            .querySelectorAll<HTMLElement>("span");
+        expect(phraseSpans.length).toBe(2);
+        const politenessColor = phraseSpans[0].style.color;
+        const actionColor = phraseSpans[1].style.color;
+        expect(politenessColor).toBeTruthy();
+        expect(actionColor).toBeTruthy();
+        expect(politenessColor).not.toBe(actionColor);
+
+        // Each marker matches the color of the phrase words it generalizes.
+        const markers = popover.querySelectorAll<HTMLElement>(
+            ".chat-explained-marker",
+        );
+        expect(markers.length).toBe(3);
+        expect(markers[0].style.color).toBe(politenessColor); // <politeness>?
+        expect(markers[1].style.color).toBe(actionColor); // <M:action>
+        expect(markers[2].style.color).toBe(politenessColor); // <politeness>?
+    });
+
+    it("picks a lighter category palette on a dark surface", () => {
+        const markerColorForSurface = (surfaceTextColor: string) => {
+            const { root, panel } = makePanel();
+            panel.addUserMessage("list all", "r");
+            // The popover picks its palette from the bubble's resolved text
+            // color (light text => dark theme).
+            userBubble(root, "r").querySelector<HTMLElement>(
+                ".chat-message-user",
+            )!.style.color = surfaceTextColor;
+            panel.notifyExplained("r", {
+                fromCache: false,
+                fromUser: false,
+                time: "t",
+                detail: {
+                    source: "model",
+                    phrase: "list all",
+                    action: "a.b",
+                    rule: "<M:action>",
+                    segments: [{ text: "list all", category: "action" }],
+                },
+            });
+            userBubble(root, "r")
+                .querySelector<HTMLElement>(".chat-message-explained-icon")!
+                .click();
+            return userBubble(root, "r").querySelector<HTMLElement>(
+                ".chat-explained-marker",
+            )!.style.color;
+        };
+
+        const onLight = markerColorForSurface("rgb(32, 32, 32)");
+        const onDark = markerColorForSurface("rgb(240, 240, 240)");
+        expect(onLight).toBeTruthy();
+        expect(onDark).toBeTruthy();
+        expect(onLight).not.toBe(onDark);
+    });
+
+    it("shows 3 generalizations then reveals the rest via load more", () => {
+        const { root, panel } = makePanel();
+        panel.addUserMessage("list all of the conversations", "req-g");
+
+        const action = {
+            text: "list all of the conversations",
+            category: "action",
+        };
+        panel.notifyExplained("req-g", {
+            fromCache: false,
+            fromUser: false,
+            time: "12:03:00 PM",
+            detail: {
+                source: "model",
+                phrase: "list all of the conversations",
+                action: "system.conversation.listConversation",
+                rule: "<politeness>?<M:action><politeness>?",
+                segments: [action],
+                generalizations: [
+                    [
+                        {
+                            text: "show all of the conversations",
+                            category: "action",
+                        },
+                    ],
+                    [
+                        {
+                            text: "display all of the conversations",
+                            category: "action",
+                        },
+                    ],
+                    [
+                        {
+                            text: "get all of the conversations",
+                            category: "action",
+                        },
+                    ],
+                    [{ text: "please", category: "politeness" }, action],
+                    [action, { text: "please", category: "politeness" }],
+                ],
+            },
+        });
+
+        const bubble = userBubble(root, "req-g");
+        bubble
+            .querySelector<HTMLElement>(".chat-message-explained-icon")!
+            .click();
+        const popover = bubble.querySelector<HTMLElement>(
+            ".chat-explained-popover",
+        )!;
+
+        // Only the first 3 are shown; the link offers the remaining 2.
+        const gens = () =>
+            popover.querySelectorAll<HTMLElement>(".chat-explained-gen");
+        expect(gens().length).toBe(3);
+        const more = popover.querySelector<HTMLElement>(
+            ".chat-explained-more",
+        )!;
+        expect(more.textContent).toBe("load 2 more");
+
+        more.click();
+        expect(gens().length).toBe(5);
+        expect(popover.querySelector(".chat-explained-more")).toBeNull();
+
+        // Samples are colored: the "please" politeness word and the action
+        // words carry distinct colors, matching the phrase legend.
+        const politenessSample = gens()[3];
+        const spans = politenessSample.querySelectorAll<HTMLElement>("span");
+        expect(spans.length).toBe(2);
+        expect(spans[0].style.color).toBeTruthy();
+        expect(spans[1].style.color).toBeTruthy();
+        expect(spans[0].style.color).not.toBe(spans[1].style.color);
+    });
+
+    it("still opens a popover with the provenance line when no detail is sent", () => {
+        const { root, panel } = makePanel();
+        panel.addUserMessage("what's on my calendar?", "req-3");
+
+        panel.notifyExplained("req-3", {
+            fromCache: "grammar",
+            fromUser: false,
+            time: "12:02:00 PM",
+        });
+
+        const icon = userBubble(root, "req-3").querySelector<HTMLElement>(
+            ".chat-message-explained-icon",
+        )!;
+        icon.click();
+        const popover = userBubble(root, "req-3").querySelector<HTMLElement>(
+            ".chat-explained-popover",
+        )!;
+        expect(popover).not.toBeNull();
+        expect(popover.textContent).toContain("Translated by grammar");
+    });
+
+    it("re-attaches the roadrunner on history replay", () => {
+        const { root, panel } = makePanel();
+        panel.replayHistory([
+            { kind: "user", text: "play adele", requestId: "req-h" },
+            {
+                kind: "explained",
+                requestId: "req-h",
+                data: {
+                    fromCache: "construction",
+                    fromUser: false,
+                    time: "12:00:00 PM",
+                    detail: {
+                        source: "construction",
+                        phrase: "play adele",
+                        action: "player.playArtist",
+                        rule: "play <artist>",
+                        mapping: [{ name: "artist", value: "adele" }],
+                    },
+                },
+            },
+        ]);
+
+        const bubble = userBubble(root, "req-h");
+        const icon = bubble.querySelector<HTMLElement>(
+            ".chat-message-explained-icon",
+        );
+        expect(icon).not.toBeNull();
+
+        // The click-to-open popover still works after replay clears the
+        // userMessageById map.
+        icon!.click();
+        const popover = bubble.querySelector<HTMLElement>(
+            ".chat-explained-popover",
+        );
+        expect(popover).not.toBeNull();
+        expect(popover!.textContent).toContain("play <artist>");
+        expect(bubble.classList.contains("chat-explained-elevated")).toBe(true);
+    });
+});
+
 describe("attachment send state", () => {
     it("keeps an image-only message sendable after leaving command history", async () => {
         const root = document.createElement("div");
diff --git a/ts/packages/cli/README.AUTOGEN.md b/ts/packages/cli/README.AUTOGEN.md
index 48265b1e2d..4e22e41aec 100644
--- a/ts/packages/cli/README.AUTOGEN.md
+++ b/ts/packages/cli/README.AUTOGEN.md
@@ -3,7 +3,7 @@
 
 <!-- AUTOGEN:DOCS:START -->
 
-<!-- AUTOGEN:DOCS:HASH:sha256=45c18858ee6c0f0a433dff0af65a553c61530c2c6e884ad0dac7a438fabb6704 -->
+<!-- AUTOGEN:DOCS:HASH:sha256=402c75d518f3752fec5f5e57bf92686274d704d2e707c96bc5869a8c7de4ad80 -->
 <!-- AUTOGEN:DOCS:SOURCE: ./README.md (hand-written documentation; this file is the AI-generated companion) -->
 
 # agent-cli — AI-generated documentation
@@ -129,18 +129,18 @@ Workspace:
 
 - [@typeagent/action-grammar](../../packages/actionGrammar/README.md)
 - [@typeagent/action-schema](../../packages/actionSchema/README.md)
+- [@typeagent/agent-cache](../../packages/cache/README.md)
 - [@typeagent/agent-sdk](../../packages/agentSdk/README.md)
 - [@typeagent/agent-server-client](../../packages/agentServer/client/README.md)
 - [@typeagent/aiclient](../../packages/aiclient/README.md)
 - [@typeagent/common-utils](../../packages/utils/commonUtils/README.md)
 - [@typeagent/config](../../packages/config/README.md)
 - [@typeagent/dispatcher-types](../../packages/dispatcher/types/README.md)
-- [agent-cache](../../packages/cache/README.md)
+- [@typeagent/telemetry](../../packages/telemetry/README.md)
+- [@typeagent/typechat-utils](../../packages/utils/typechatUtils/README.md)
 - [agent-dispatcher](../../packages/dispatcher/dispatcher/README.md)
 - [default-agent-provider](../../packages/defaultAgentProvider/README.md)
 - [interactive-app](../../packages/interactiveApp/README.md)
-- [telemetry](../../packages/telemetry/README.md)
-- [typechat-utils](../../packages/utils/typechatUtils/README.md)
 
 External: `@oclif/core`, `@oclif/plugin-help`, `chalk`, `debug`, `dotenv`, `html-to-text`, `marked`, `marked-terminal`, `open`, `ts-node`
 
@@ -150,6 +150,6 @@ External: `@oclif/core`, `@oclif/plugin-help`, `chalk`, `debug`, `dotenv`, `html
 
 ---
 
-_Auto-generated against commit `ff9101e00228c5d0ff34c8dd3f108f46af46b0a6` on `2026-07-23T00:41:03.476Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter agent-cli docs:verify-links` to spot-check._
+_Auto-generated against commit `513baf52ceffeed05addca6ca873c3e52edae019` on `2026-07-30T18:10:08.236Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter agent-cli docs:verify-links` to spot-check._
 
 <!-- AUTOGEN:DOCS:END -->
diff --git a/ts/packages/cli/src/commands/conversations/list.ts b/ts/packages/cli/src/commands/conversations/list.ts
index 4957d47c9f..f9b92c36b1 100644
--- a/ts/packages/cli/src/commands/conversations/list.ts
+++ b/ts/packages/cli/src/commands/conversations/list.ts
@@ -21,6 +21,10 @@ function formatTable(conversations: ConversationInfo[]): string {
         "NAME".length,
         ...conversations.map((s) => (s.name ?? "").length),
     );
+    const messagesWidth = Math.max(
+        "MESSAGES".length,
+        ...conversations.map((s) => String(s.messageCount).length),
+    );
     const clientsWidth = Math.max(
         "CLIENTS".length,
         ...conversations.map((s) => String(s.clientCount).length),
@@ -33,6 +37,7 @@ function formatTable(conversations: ConversationInfo[]): string {
     const header = [
         "CONVERSATION ID".padEnd(idWidth),
         "NAME".padEnd(nameWidth),
+        "MESSAGES".padEnd(messagesWidth),
         "CLIENTS".padEnd(clientsWidth),
         "CREATED AT",
     ].join("  ");
@@ -40,6 +45,7 @@ function formatTable(conversations: ConversationInfo[]): string {
     const separator = [
         "-".repeat(idWidth),
         "-".repeat(nameWidth),
+        "-".repeat(messagesWidth),
         "-".repeat(clientsWidth),
         "-".repeat(createdWidth),
     ].join("  ");
@@ -48,6 +54,7 @@ function formatTable(conversations: ConversationInfo[]): string {
         [
             s.conversationId.padEnd(idWidth),
             (s.name ?? "").padEnd(nameWidth),
+            String(s.messageCount).padEnd(messagesWidth),
             String(s.clientCount).padEnd(clientsWidth),
             s.createdAt,
         ].join("  "),
diff --git a/ts/packages/cli/src/conversationCommands.ts b/ts/packages/cli/src/conversationCommands.ts
index b0c607a1b8..d4f08c2424 100644
--- a/ts/packages/cli/src/conversationCommands.ts
+++ b/ts/packages/cli/src/conversationCommands.ts
@@ -214,9 +214,14 @@ function renderResult(result: ConversationActionResult): void {
                 "  " +
                 "NAME".padEnd(nameWidth + 2) +
                 "CREATED".padEnd(22) +
+                "MESSAGES".padEnd(10) +
                 "CLIENTS";
             const divider =
-                "  " + "─".repeat(nameWidth + 2) + "─".repeat(22) + "───────";
+                "  " +
+                "─".repeat(nameWidth + 2) +
+                "─".repeat(22) +
+                "─".repeat(10) +
+                "───────";
             console.log(chalk.bold("\nConversations:"));
             console.log(chalk.dim(header));
             console.log(chalk.dim(divider));
@@ -232,6 +237,7 @@ function renderResult(result: ConversationActionResult): void {
                     marker +
                     s.name.padEnd(nameWidth + 2) +
                     created.padEnd(22) +
+                    String(s.messageCount).padEnd(10) +
                     String(s.clientCount) +
                     suffix;
                 console.log(isCurrent ? chalk.green(line) : line);
diff --git a/ts/packages/cli/test/conversationCommands.spec.ts b/ts/packages/cli/test/conversationCommands.spec.ts
index 23a553c1a2..a6c97d36a3 100644
--- a/ts/packages/cli/test/conversationCommands.spec.ts
+++ b/ts/packages/cli/test/conversationCommands.spec.ts
@@ -68,6 +68,7 @@ function makeSession(
     return {
         clientCount: 1,
         createdAt: new Date().toISOString(),
+        messageCount: 0,
         ...overrides,
     };
 }
@@ -425,6 +426,25 @@ describe("@conversation list", () => {
 
         expect(capturedLog()).toContain("5");
     });
+
+    it("displays messageCount for each conversation", async () => {
+        const ctx = makeCtx({
+            getCurrentConversationId: () => "sess-1",
+        });
+        ctx.connection.listConversations.mockResolvedValue([
+            makeSession({
+                conversationId: "sess-1",
+                name: "Chat",
+                clientCount: 5,
+                messageCount: 42,
+                createdAt: "2026-01-15T10:00:00.000Z",
+            }),
+        ]);
+
+        await handleConversationCommand(ctx, "list");
+
+        expect(capturedLog()).toContain("42");
+    });
 });
 
 describe("@conversation rename", () => {
diff --git a/ts/packages/coda/README.AUTOGEN.md b/ts/packages/coda/README.AUTOGEN.md
index 060c771950..01d055d120 100644
--- a/ts/packages/coda/README.AUTOGEN.md
+++ b/ts/packages/coda/README.AUTOGEN.md
@@ -3,7 +3,7 @@
 
 <!-- AUTOGEN:DOCS:START -->
 
-<!-- AUTOGEN:DOCS:HASH:sha256=befe1c8082ea53aa9d982f95658c259667706633c2847803df894ca69206a534 -->
+<!-- AUTOGEN:DOCS:HASH:sha256=1929c79632767b3215b1a1857c4636951999a3e987817d54d748352259afcbbb -->
 <!-- AUTOGEN:DOCS:SOURCE: ./README.md (hand-written documentation; this file is the AI-generated companion) -->
 
 # agent-coda — AI-generated documentation
@@ -12,19 +12,19 @@
 
 ## Overview
 
-The `agent-coda` package is a TypeScript library that implements the Coda Operated Assistance (CODA) system, a voice-controlled coding assistant for Visual Studio Code (VSCode). It integrates with the TypeAgent shell or CLI to enable developers to perform coding tasks and manage their workspace using natural language commands. This package is designed to enhance accessibility and streamline workflows by enabling hands-free interaction with the VSCode environment.
+The `agent-coda` package is a TypeScript library that powers the Coda Operated Assistance (CODA) system, a voice-controlled coding assistant designed for Visual Studio Code (VSCode). It integrates with the TypeAgent shell or CLI to enable developers to perform coding tasks and manage their workspace using natural language commands. This package enhances accessibility and productivity by enabling hands-free interaction with the VSCode environment.
 
 ## What it does
 
-The `agent-coda` package provides a wide range of actions that allow users to interact with VSCode through voice commands. These actions are grouped into several categories:
+The `agent-coda` package provides a suite of actions that allow users to interact with VSCode through voice commands. These actions are categorized as follows:
 
-- **File and Code Management**: Actions like `createFile`, `openFile`, and `getFileContent` allow users to create, open, and manage files. Additional actions such as `getSelection` and `getDiagnostics` provide insights into the current state of the editor.
-- **Editor Layout and Navigation**: The `changeEditorColumns` action enables users to adjust the editor layout (e.g., single, double, or triple columns). Other actions facilitate navigation and management of open editors and workspace folders.
-- **Extension Management**: Actions such as `checkExtensionAvailable` and `fetchTopExtensions` allow users to search for, install, and manage VSCode extensions.
-- **Debugging**: The `startDebugging` action enables users to initiate debugging sessions with specific configurations.
-- **Workbench Operations**: Actions like `handleWorkBenchActions` allow users to manage workspace folders, open files, and perform other workbench-related tasks.
+- **File and Code Management**: Actions like `createFile`, `openFile`, and `getFileContent` enable users to create, open, and manage files. Additional actions such as `getSelection` and `getDiagnostics` provide insights into the current state of the editor.
+- **Editor Layout and Navigation**: The `changeEditorColumns` action allows users to adjust the editor layout (e.g., single, double, or triple columns). Other actions facilitate navigation and management of open editors and workspace folders.
+- **Extension Management**: Actions such as `checkExtensionAvailable` and `fetchTopExtensions` enable users to search for, install, and manage VSCode extensions.
+- **Debugging**: The `startDebugging` action allows users to initiate debugging sessions with specific configurations.
+- **Workbench Operations**: Actions like `handleWorkBenchActions` enable users to manage workspace folders, open files, and perform other workbench-related tasks.
 
-These capabilities enable developers to perform common development tasks hands-free, enhancing productivity and accessibility.
+These capabilities allow developers to perform common development tasks hands-free, improving accessibility and streamlining workflows.
 
 ## Setup
 
@@ -71,7 +71,7 @@ The `agent-coda` extension is designed to work in conjunction with the TypeAgent
 
 The `agent-coda` package is organized into several key files, each responsible for specific functionalities:
 
-- [codeUtils.ts](./src/codeUtils.ts): Contains utility functions for code manipulation, such as ensuring proper syntax closures and generating documentation comments.
+- [codeUtils.ts](./src/codeUtils.ts): Provides utility functions for code manipulation, such as ensuring proper syntax closures and generating documentation comments.
 - [commandAliasMgr.ts](./src/commandAliasMgr.ts): Manages command aliases to simplify the recognition and execution of voice commands.
 - [extension.ts](./src/extension.ts): The main entry point for the VSCode extension, responsible for activation, command registration, and initializing WebSocket connections.
 - [handleDebugActions.ts](./src/handleDebugActions.ts): Implements debugging-related actions, such as starting debugging sessions with specific configurations.
@@ -137,6 +137,6 @@ _2 environment variables referenced from `./src/` (set in `ts/.env` or your shel
 
 ---
 
-_Auto-generated against commit `6bea19a9ee02598644b1ac3ab67c705dcc495832` on `2026-07-22T11:19:17.632Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter agent-coda docs:verify-links` to spot-check._
+_Auto-generated against commit `95c8336eb7cd853020fc28cbc98b6380676e73f3` on `2026-07-30T17:32:13.295Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter agent-coda docs:verify-links` to spot-check._
 
 <!-- AUTOGEN:DOCS:END -->
diff --git a/ts/packages/coda/src/handleEditorCodeActions.ts b/ts/packages/coda/src/handleEditorCodeActions.ts
index 31d5188bdf..12ffe96cb5 100644
--- a/ts/packages/coda/src/handleEditorCodeActions.ts
+++ b/ts/packages/coda/src/handleEditorCodeActions.ts
@@ -955,6 +955,7 @@ function buildFallbackCopilotQuery(
 type LaunchCopilotChatAction = {
     parameters?: {
         query?: string;
+        provider?: "copilot" | "claude" | "gpt" | "generic";
         mode?: "agent" | "ask";
         isPartialQuery?: boolean;
         attachScreenshot?: boolean;
@@ -964,6 +965,42 @@ type LaunchCopilotChatAction = {
     };
 };
 
+type ChatSessionLocation = "view" | "editor" | "window";
+
+function resolveChatSessionLocation(value: unknown): ChatSessionLocation {
+    if (value === "editor" || value === "window") {
+        return value;
+    }
+    return "view";
+}
+
+function getChatOpenCommand(location: ChatSessionLocation): string {
+    switch (location) {
+        case "editor":
+            return "workbench.action.openChat";
+        case "window":
+            return "workbench.action.newChatWindow";
+        default:
+            return "workbench.action.chat.newChat";
+    }
+}
+
+function describeCopilotChatTarget(
+    newSession: boolean,
+    location: ChatSessionLocation,
+): string {
+    if (!newSession) {
+        return "GitHub Copilot Chat";
+    }
+    if (location === "editor") {
+        return "a new GitHub Copilot Chat editor";
+    }
+    if (location === "window") {
+        return "a new GitHub Copilot Chat window";
+    }
+    return "a new GitHub Copilot Chat session";
+}
+
 function getErrorMessage(error: unknown): string {
     return error instanceof Error ? error.message : String(error);
 }
@@ -978,30 +1015,45 @@ export async function handleLaunchCopilotChatAction(
     action: LaunchCopilotChatAction,
 ): Promise<ActionResult> {
     const params = action.parameters ?? {};
+    const provider: "copilot" | "claude" | "gpt" | "generic" =
+        params.provider === "claude" ||
+        params.provider === "gpt" ||
+        params.provider === "generic"
+            ? params.provider
+            : "copilot";
+
+    // Route to provider-specific handler
+    if (provider === "claude") {
+        return handleClaudeChatAction(params);
+    } else if (provider === "gpt") {
+        return handleGPTChatAction(params);
+    } else if (provider === "generic") {
+        return handleGenericChatAction(params);
+    } else {
+        // Default: GitHub Copilot
+        return handleCopilotChatAction(params);
+    }
+}
+
+// GitHub Copilot Chat handler — uses native VS Code Copilot Chat integration
+async function handleCopilotChatAction(
+    params: Record<string, unknown>,
+): Promise<ActionResult> {
     const query: string = typeof params.query === "string" ? params.query : "";
     const mode: string = params.mode === "ask" ? "ask" : "agent";
-    // isPartialQuery=false means auto-send; true means pre-fill only. We open
-    // the chat pre-filled either way and drive the submit ourselves (below),
-    // so this just controls whether the prompt is auto-sent.
     const autoSend: boolean = params.isPartialQuery !== true;
     const attachScreenshot: boolean = params.attachScreenshot === true;
     const attachFilePaths: string[] = Array.isArray(params.attachFiles)
-        ? params.attachFiles.filter((p: unknown) => typeof p === "string")
+        ? params.attachFiles.filter(
+              (p: unknown): p is string => typeof p === "string",
+          )
         : [];
-    // Whether to start a fresh session, and where to open it.
     const newSession: boolean = params.newSession !== false;
-    const newSessionLocation: "view" | "editor" | "window" =
-        params.newSessionLocation === "editor"
-            ? "editor"
-            : params.newSessionLocation === "window"
-              ? "window"
-              : "view";
+    const newSessionLocation = resolveChatSessionLocation(
+        params.newSessionLocation,
+    );
 
     if (!(await isCopilotChatAvailable())) {
-        // NOTE: `handled: true` marks that this handler recognized the action
-        // (see handleVSCodeActions' `results.find(r => r.handled)` selection) —
-        // it is not a success flag. Keep it true so this specific message is
-        // the one surfaced, rather than the generic "Did not handle" fallback.
         return {
             handled: true,
             message:
@@ -1009,42 +1061,22 @@ export async function handleLaunchCopilotChatAction(
         };
     }
 
-    // Optionally start a fresh chat session in the requested location BEFORE
-    // opening. `workbench.action.chat.open` targets the last-active chat widget
-    // (IChatWidgetService.revealWidget reveals the last active widget), so
-    // creating the new session first makes the handoff land there instead of
-    // appending to the user's current chat.
     if (newSession) {
-        const newSessionCommand =
-            newSessionLocation === "editor"
-                ? "workbench.action.openChat" // New Chat Editor (editor area)
-                : newSessionLocation === "window"
-                  ? "workbench.action.newChatWindow" // New Chat Window
-                  : "workbench.action.chat.newChat"; // New chat in the panel view
+        const newSessionCommand = getChatOpenCommand(newSessionLocation);
         try {
             await vscode.commands.executeCommand(newSessionCommand);
         } catch {
-            // Best-effort: older builds may lack the command. Fall through and
-            // open into the current/last chat instead of a new session.
+            // Best-effort: older builds may lack the command
         }
     }
 
     const attachFiles = attachFilePaths.map((p) => vscode.Uri.file(p));
 
-    const openedWhere = !newSession
-        ? "GitHub Copilot Chat"
-        : newSessionLocation === "editor"
-          ? "a new GitHub Copilot Chat editor"
-          : newSessionLocation === "window"
-            ? "a new GitHub Copilot Chat window"
-            : "a new GitHub Copilot Chat session";
-    // Open the chat pre-filled first — this reliably reveals the target widget
-    // and adds the input + attachments — then drive the submit ourselves. We do
-    // NOT use chat.open's own auto-submit (isPartialQuery:false → acceptInput):
-    // on a freshly created chat editor/window that submit races widget/agent
-    // initialization and often leaves the prompt sitting unsent. Running
-    // `workbench.action.chat.submit` as a separate step after the widget is
-    // revealed is reliable.
+    const openedWhere = describeCopilotChatTarget(
+        newSession,
+        newSessionLocation,
+    );
+
     let usedFallback = false;
     try {
         await vscode.commands.executeCommand("workbench.action.chat.open", {
@@ -1055,8 +1087,6 @@ export async function handleLaunchCopilotChatAction(
             attachFiles,
         });
     } catch {
-        // Older VS Code builds may not support attachScreenshot / attachFiles.
-        // Fall back to embedding the attachment paths in the query text.
         try {
             await vscode.commands.executeCommand("workbench.action.chat.open", {
                 query: buildFallbackCopilotQuery(query, attachFilePaths),
@@ -1074,8 +1104,6 @@ export async function handleLaunchCopilotChatAction(
         }
     }
 
-    // Submit the pre-filled prompt when auto-send is requested. Best-effort: if
-    // the submit command is unavailable, leave the prompt ready to send.
     let sent = false;
     if (autoSend) {
         try {
@@ -1084,7 +1112,7 @@ export async function handleLaunchCopilotChatAction(
             );
             sent = true;
         } catch {
-            // Couldn't auto-submit; the prompt stays pre-filled for the user.
+            // Couldn't auto-submit; prompt stays pre-filled
         }
     }
 
@@ -1102,6 +1130,139 @@ export async function handleLaunchCopilotChatAction(
     };
 }
 
+// Claude Chat handler — tries to open Claude extension if available
+async function handleClaudeChatAction(
+    params: Record<string, unknown>,
+): Promise<ActionResult> {
+    const query: string = typeof params.query === "string" ? params.query : "";
+    const newSessionLocation = resolveChatSessionLocation(
+        params.newSessionLocation,
+    );
+
+    // Try Anthropic Claude for VS Code extension command
+    const claudeCommands = [
+        "anthropic.claude.new-chat-window", // Possible Anthropic extension ID
+        "claude.openInNewWindow", // Alternative command
+        "continue.openChat", // Continue extension which often uses Claude
+    ];
+
+    for (const cmd of claudeCommands) {
+        try {
+            await vscode.commands.executeCommand(cmd, {
+                query,
+                location: newSessionLocation,
+            });
+            return {
+                handled: true,
+                message: `✅ Opened Claude chat${query ? " with your prompt" : ""}. If Claude extension is not installed, you can install it from the VS Code Extensions marketplace.`,
+            };
+        } catch {
+            // Try next command
+        }
+    }
+
+    // Fallback: open generic chat and mention Claude
+    try {
+        if (newSessionLocation === "window") {
+            await vscode.commands.executeCommand(
+                "workbench.action.chat.newChat",
+            );
+        } else if (newSessionLocation === "editor") {
+            await vscode.commands.executeCommand("workbench.action.openChat");
+        }
+        return {
+            handled: true,
+            message: `⚠️ Opened a chat window, but Claude extension was not found. Install "Claude for VS Code" or "Anthropic" from the Extensions marketplace to use Claude.${query ? " Your prompt is ready to paste." : ""}`,
+        };
+    } catch {
+        return {
+            handled: true,
+            message:
+                "❌ Claude extension not found and fallback chat window failed. Install a Claude extension (e.g., 'Anthropic' or 'Claude for VS Code') from the VS Code Extensions marketplace.",
+        };
+    }
+}
+
+// ChatGPT/OpenAI handler — tries to open ChatGPT extension if available
+async function handleGPTChatAction(
+    params: Record<string, unknown>,
+): Promise<ActionResult> {
+    const query: string = typeof params.query === "string" ? params.query : "";
+    const newSessionLocation = resolveChatSessionLocation(
+        params.newSessionLocation,
+    );
+
+    // Try various GPT/OpenAI related extension commands
+    const gptCommands = [
+        "openai.chatgpt.new-chat-window",
+        "gptChat.openInNewWindow",
+        "gpt4all.openChat",
+        "continue.openChat", // Continue also supports GPT models
+    ];
+
+    for (const cmd of gptCommands) {
+        try {
+            await vscode.commands.executeCommand(cmd, {
+                query,
+                location: newSessionLocation,
+            });
+            return {
+                handled: true,
+                message: `✅ Opened ChatGPT/GPT chat${query ? " with your prompt" : ""}. If GPT extension is not installed, install it from the VS Code Extensions marketplace.`,
+            };
+        } catch {
+            // Try next command
+        }
+    }
+
+    // Fallback: open generic chat
+    try {
+        if (newSessionLocation === "window") {
+            await vscode.commands.executeCommand(
+                "workbench.action.chat.newChat",
+            );
+        } else if (newSessionLocation === "editor") {
+            await vscode.commands.executeCommand("workbench.action.openChat");
+        }
+        return {
+            handled: true,
+            message: `⚠️ Opened a chat window, but ChatGPT/GPT extension was not found. Install a ChatGPT extension (e.g., 'ChatGPT' or 'Continue') from the VS Code Extensions marketplace to use ChatGPT.${query ? " Your prompt is ready to paste." : ""}`,
+        };
+    } catch {
+        return {
+            handled: true,
+            message:
+                "❌ ChatGPT extension not found and fallback chat window failed. Install a ChatGPT extension from the VS Code Extensions marketplace.",
+        };
+    }
+}
+
+// Generic chat handler — opens the default VS Code chat in the requested location
+async function handleGenericChatAction(
+    params: Record<string, unknown>,
+): Promise<ActionResult> {
+    const query: string = typeof params.query === "string" ? params.query : "";
+    const newSessionLocation = resolveChatSessionLocation(
+        params.newSessionLocation,
+    );
+
+    try {
+        await vscode.commands.executeCommand(
+            getChatOpenCommand(newSessionLocation),
+        );
+
+        return {
+            handled: true,
+            message: `✅ Opened a new chat${query ? " with your prompt" : ""}. The available chat providers depend on your installed extensions (GitHub Copilot, Claude, ChatGPT, etc.).`,
+        };
+    } catch (err: unknown) {
+        return {
+            handled: true,
+            message: `❌ Failed to open chat window: ${getErrorMessage(err)}`,
+        };
+    }
+}
+
 export async function handleEditorCodeActions(
     action: any,
 ): Promise<ActionResult> {
diff --git a/ts/packages/defaultAgentProvider/README.AUTOGEN.md b/ts/packages/defaultAgentProvider/README.AUTOGEN.md
index 94fd1511fa..4f8040bfa1 100644
--- a/ts/packages/defaultAgentProvider/README.AUTOGEN.md
+++ b/ts/packages/defaultAgentProvider/README.AUTOGEN.md
@@ -3,7 +3,7 @@
 
 <!-- AUTOGEN:DOCS:START -->
 
-<!-- AUTOGEN:DOCS:HASH:sha256=736a27e109662e5d56fe0f62cb933da28826a849d821581793389a7e46d283b5 -->
+<!-- AUTOGEN:DOCS:HASH:sha256=b28003e6c4c8501102f31e8885510564113a2d15c1675e91dbe5659772a10e75 -->
 <!-- AUTOGEN:DOCS:SOURCE: ./README.md (hand-written documentation; this file is the AI-generated companion) -->
 
 # default-agent-provider — AI-generated documentation
@@ -12,11 +12,11 @@
 
 ## Overview
 
-The `default-agent-provider` package is a TypeScript library that serves as the default agent provider for the TypeAgent framework. It is a core component used by the shell and CLI to initialize and manage both built-in agents and external agent providers. This package ensures that the necessary agents, configurations, and dispatcher options are available to support the TypeAgent ecosystem.
+The `default-agent-provider` package is a TypeScript library that serves as the default agent provider for the TypeAgent framework. It is a core component used by the TypeAgent shell and CLI to initialize, manage, and configure both built-in and external agents. This package ensures that the necessary agents and dispatcher configurations are available to support the broader TypeAgent ecosystem.
 
 ## What it does
 
-The `default-agent-provider` package provides a centralized mechanism for managing agents and their configurations. Its primary responsibilities include:
+The `default-agent-provider` package provides a centralized mechanism for managing agents, their configurations, and dispatcher settings. Its primary responsibilities include:
 
 - **Default Agent Providers**: Functions like `getDefaultAppAgentProviders` and `getDefaultConstructionProvider` supply pre-configured agent providers and construction mechanisms for initializing agents.
 - **Agent Source Management**: The `getDefaultAppAgentSource` function manages the connected app-agent source, including the installed-agent record store and the host-owned `@package` agent.
@@ -48,7 +48,7 @@ To set up and use the `default-agent-provider` package, follow these steps:
 
    - `CS_BENCH_MAX_OLD_SPACE_MB`: Configure this variable to control the maximum old space memory allocation for the V8 engine.
    - `CS_NEGATION_GUARD`: Set this variable to enable or disable negation guard functionality.
-   - `TYPEAGENT_FEED_DISCOVERY_REGISTRIES`: Specifies the registries for feed discovery. Ensure this variable is set appropriately for your environment.
+   - `TYPEAGENT_FEED_DISCOVERY_REGISTRIES`: Specifies the registries for feed discovery.
    - `TYPEAGENT_FEED_REGISTRY`: Specifies the registry for the agent feed. This value should be set in your environment. Refer to the hand-written README for details on how to configure this variable.
    - `TYPEAGENT_FEED_SCOPES`: Defines the scopes for the agent feed. Ensure this variable is set appropriately for your environment.
 
@@ -151,6 +151,7 @@ Workspace:
 - [@typeagent/photo-agent](../../packages/agents/photo/README.md)
 - [@typeagent/powershell-typeagent](../../packages/agents/powershell/README.md)
 - [@typeagent/screencapture-agent](../../packages/agents/screencapture/README.md)
+- [@typeagent/selfhelp-agent](../../packages/agents/selfhelp/README.md)
 - [@typeagent/studio-agent](../../packages/agents/studio/README.md)
 - [@typeagent/taskflow-typeagent](../../packages/agents/taskflow/README.md)
 - [@typeagent/telemetry](../../packages/telemetry/README.md)
@@ -198,6 +199,6 @@ _5 environment variables referenced from `./src/` (set in `ts/.env` or your shel
 
 ---
 
-_Auto-generated against commit `59cbbc5f415e861717a2bdb75ffa0459ceb5c4c7` on `2026-07-29T18:12:59.352Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter default-agent-provider docs:verify-links` to spot-check._
+_Auto-generated against commit `84e4ab4096d5c3ad29bc106810cdf15e6a3138f6` on `2026-07-30T20:00:37.259Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter default-agent-provider docs:verify-links` to spot-check._
 
 <!-- AUTOGEN:DOCS:END -->
diff --git a/ts/packages/defaultAgentProvider/data/config.json b/ts/packages/defaultAgentProvider/data/config.json
index 2e7f5e533a..21b273c1da 100644
--- a/ts/packages/defaultAgentProvider/data/config.json
+++ b/ts/packages/defaultAgentProvider/data/config.json
@@ -101,6 +101,10 @@
     },
     "ipconfig": {
       "name": "@typeagent/ipconfig-agent"
+    },
+    "selfhelp": {
+      "name": "@typeagent/selfhelp-agent",
+      "execMode": "dispatcher"
     }
   },
   "mcpServers": {
diff --git a/ts/packages/defaultAgentProvider/package.json b/ts/packages/defaultAgentProvider/package.json
index 0d199c3c40..a705459215 100644
--- a/ts/packages/defaultAgentProvider/package.json
+++ b/ts/packages/defaultAgentProvider/package.json
@@ -68,6 +68,7 @@
     "@typeagent/photo-agent": "workspace:*",
     "@typeagent/powershell-typeagent": "workspace:*",
     "@typeagent/screencapture-agent": "workspace:*",
+    "@typeagent/selfhelp-agent": "workspace:*",
     "@typeagent/studio-agent": "workspace:*",
     "@typeagent/taskflow-typeagent": "workspace:*",
     "@typeagent/telemetry": "workspace:*",
diff --git a/ts/packages/dispatcher/dispatcher/README.AUTOGEN.md b/ts/packages/dispatcher/dispatcher/README.AUTOGEN.md
index 121f213cf9..f06179df42 100644
--- a/ts/packages/dispatcher/dispatcher/README.AUTOGEN.md
+++ b/ts/packages/dispatcher/dispatcher/README.AUTOGEN.md
@@ -3,7 +3,7 @@
 
 <!-- AUTOGEN:DOCS:START -->
 
-<!-- AUTOGEN:DOCS:HASH:sha256=c42d73fb1a1f201ab835a0bcbc314df5e1da537ba2dbf798b07cc85b351a12df -->
+<!-- AUTOGEN:DOCS:HASH:sha256=0235c1840f25212e9e2da91130de2e1d4a6fa8640f1a9ab2f70d8cd8f4934fc2 -->
 <!-- AUTOGEN:DOCS:SOURCE: ./README.md (hand-written documentation; this file is the AI-generated companion) -->
 
 # agent-dispatcher — AI-generated documentation
@@ -12,7 +12,7 @@
 
 ## Overview
 
-The TypeAgent Dispatcher is a TypeScript library that serves as the core orchestration component of the TypeAgent ecosystem. It processes user inputs, translates natural language into structured actions using large language models (LLMs), and coordinates interactions across various application agents. The Dispatcher is designed to integrate with multiple front ends, such as the TypeAgent Shell and CLI, and supports an extensible architecture for building personal agents with natural language interfaces.
+The TypeAgent Dispatcher is a TypeScript library that acts as the central coordination hub within the TypeAgent ecosystem. It processes user inputs, translates natural language into structured actions using large language models (LLMs), and manages interactions across various application agents. The Dispatcher is designed to integrate with multiple front ends, such as the TypeAgent Shell and CLI, and supports an extensible architecture for building personal agents with natural language interfaces.
 
 ## What it does
 
@@ -172,6 +172,7 @@ Workspace:
 
 - [@typeagent/action-grammar](../../../packages/actionGrammar/README.md)
 - [@typeagent/action-schema](../../../packages/actionSchema/README.md)
+- [@typeagent/agent-cache](../../../packages/cache/README.md)
 - [@typeagent/agent-rpc](../../../packages/agentRpc/README.md)
 - [@typeagent/agent-runtime](../../../packages/typeagent/README.md)
 - [@typeagent/agent-sdk](../../../packages/agentSdk/README.md)
@@ -188,7 +189,6 @@ Workspace:
 - [@typeagent/telemetry](../../../packages/telemetry/README.md)
 - [@typeagent/typechat-utils](../../../packages/utils/typechatUtils/README.md)
 - [@typeagent/website-memory](../../../packages/memory/website/README.md)
-- [agent-cache](../../../packages/cache/README.md)
 - grammar-tools-core
 
 External: `@anthropic-ai/claude-agent-sdk`, `@azure/core-client`, `@azure/core-rest-pipeline`, `@azure/cosmos`, `@azure/identity`, `@github/copilot-sdk`, `@modelcontextprotocol/sdk`, `chalk`, `debug`, `exifreader`, `file-size`, `glob`, `html-to-text`, `open`, `proper-lockfile`, `string-width`, `typechat`, `zod`
@@ -238,6 +238,6 @@ _10 environment variables referenced from `./src/` (set in `ts/.env` or your she
 
 ---
 
-_Auto-generated against commit `33c83792f9a6ab6f17e52ca4856f765a2a056905` on `2026-07-27T20:21:59.625Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter agent-dispatcher docs:verify-links` to spot-check._
+_Auto-generated against commit `513baf52ceffeed05addca6ca873c3e52edae019` on `2026-07-30T18:10:08.236Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter agent-dispatcher docs:verify-links` to spot-check._
 
 <!-- AUTOGEN:DOCS:END -->
diff --git a/ts/packages/dispatcher/dispatcher/src/command/commandReference.ts b/ts/packages/dispatcher/dispatcher/src/command/commandReference.ts
index 68e754be01..51a0218aee 100644
--- a/ts/packages/dispatcher/dispatcher/src/command/commandReference.ts
+++ b/ts/packages/dispatcher/dispatcher/src/command/commandReference.ts
@@ -23,6 +23,9 @@ import {
 } from "@typeagent/agent-sdk/helpers/command";
 import { CommandHandlerContext } from "../context/commandHandlerContext.js";
 import { getDefaultSubCommandDescriptor } from "./command.js";
+import { getPackageFilePath } from "../utils/getPackageFilePath.js";
+import { getAppAgentName } from "../translation/agentTranslators.js";
+import type { ActionConfigProvider } from "../translation/actionConfigProvider.js";
 
 import registerDebug from "debug";
 const debug = registerDebug("typeagent:command:reference");
@@ -38,8 +41,18 @@ function escapeAngles(text: string): string {
 // Render a single command descriptor to a markdown section. Mirrors the
 // mechanical parts of getUsage() (commandHelp.ts) so the reference stays in
 // lockstep with interactive `@help`.
+// Resolve a command's declared actionName (already scoped to its agent) to a
+// fully-qualified name and an optional markdown link to its schema source.
+type ActionResolver = (
+    actionName: string,
+) => { qualifiedName: string; link?: string } | undefined;
+
 // code-complexity-allow: command usage markdown needs explicit branches for args/flags formatting
-function renderCommand(command: string, descriptor: CommandDescriptor): string {
+function renderCommand(
+    command: string,
+    descriptor: CommandDescriptor,
+    resolveAction?: ActionResolver,
+): string {
     // Usage tokens (flags first, unshifted in reverse like getUsage; then args).
     const usageParams: string[] = [];
     const argLines: string[] = [];
@@ -87,6 +100,23 @@ function renderCommand(command: string, descriptor: CommandDescriptor): string {
     out.push(`## @${command} - ${descriptor.description}`);
     out.push("");
     out.push(`Usage: \`${usage}\``);
+    // A command may declare the agent action it is equivalent to, so readers
+    // know the same thing is reachable via natural language. The declaration is
+    // just the actionName; the fully-qualified name and schema-source link are
+    // resolved from the dispatcher's action metadata.
+    const actionName =
+        typeof descriptor.action === "string"
+            ? descriptor.action
+            : descriptor.action?.actionName;
+    if (actionName !== undefined) {
+        const resolved = resolveAction?.(actionName);
+        const label = resolved?.qualifiedName ?? actionName;
+        const rendered = resolved?.link
+            ? `[\`${label}\`](${resolved.link})`
+            : `\`${label}\``;
+        out.push("");
+        out.push(`Equivalent action: ${rendered}`);
+    }
     if (argLines.length !== 0) {
         out.push("");
         out.push("### Arguments:");
@@ -110,20 +140,23 @@ function walkTable(
     table: CommandDescriptorTable,
     commandPrefix: string,
     sections: string[],
+    resolveAction?: ActionResolver,
 ): void {
     if (typeof table.defaultSubCommand !== "string" && commandPrefix !== "") {
         const defaultDescriptor = getDefaultSubCommandDescriptor(table);
         if (defaultDescriptor !== undefined) {
-            sections.push(renderCommand(commandPrefix, defaultDescriptor));
+            sections.push(
+                renderCommand(commandPrefix, defaultDescriptor, resolveAction),
+            );
         }
     }
 
     for (const [name, handler] of Object.entries(table.commands)) {
         const command = commandPrefix ? `${commandPrefix} ${name}` : name;
         if (isCommandDescriptorTable(handler)) {
-            walkTable(handler, command, sections);
+            walkTable(handler, command, sections, resolveAction);
         } else {
-            sections.push(renderCommand(command, handler));
+            sections.push(renderCommand(command, handler, resolveAction));
         }
     }
 }
@@ -144,8 +177,19 @@ function orderAgentNames(names: string[]): string[] {
 // agent's commands. The caller supplies the file's intro/header. Agents that
 // are not command-enabled (e.g. failed to initialize headlessly) are skipped
 // with a debug note, so the output reflects whatever agents booted.
+export interface CommandReferenceOptions {
+    // Resolve a command's declared action (given its agent and actionName) to a
+    // fully-qualified name and an optional markdown link. Returns undefined to
+    // fall back to the bare actionName.
+    resolveAction?: (
+        agentName: string,
+        actionName: string,
+    ) => { qualifiedName: string; link?: string } | undefined;
+}
+
 export async function collectCommandReferenceMarkdown(
     context: CommandHandlerContext,
+    options?: CommandReferenceOptions,
 ): Promise<string> {
     const sections: string[] = [];
     const agents = context.agents;
@@ -172,13 +216,57 @@ export async function collectCommandReferenceMarkdown(
         // agent prefix (`@action`). Every other agent prefixes its commands
         // with the agent name (`@dispatcher request`).
         const commandPrefix = agentName === "system" ? "" : agentName;
+        const resolveAction = options?.resolveAction
+            ? (actionName: string) =>
+                  options.resolveAction!(agentName, actionName)
+            : undefined;
         if (isCommandDescriptorTable(commands)) {
-            walkTable(commands, commandPrefix, sections);
+            walkTable(commands, commandPrefix, sections, resolveAction);
         } else if (commandPrefix !== "") {
             // Agent exposes a single `@<agentName>` command.
-            sections.push(renderCommand(commandPrefix, commands));
+            sections.push(
+                renderCommand(commandPrefix, commands, resolveAction),
+            );
         }
     }
 
     return sections.join("\n\n");
 }
+
+// (agent, actionName) -> the schema that declares it and its source file, so a
+// command reference can render a command's equivalent action as a fully-
+// qualified, linkable name. Keyed "<agent>\n<actionName>". Takes an
+// ActionConfigProvider (e.g. from getAllActionConfigProvider) rather than a
+// running context, so the lookup is independent of which schemas are enabled.
+export interface ActionReferenceEntry {
+    schemaName: string;
+    // Absolute path to the schema's TypeScript source, when resolvable.
+    sourceFile: string | undefined;
+}
+
+export function collectActionReference(
+    provider: ActionConfigProvider,
+): Map<string, ActionReferenceEntry> {
+    const map = new Map<string, ActionReferenceEntry>();
+    for (const config of provider.getActionConfigs()) {
+        const agentName = getAppAgentName(config.schemaName);
+        const relPath = config.originalSchemaFilePath ?? config.schemaFilePath;
+        const sourceFile =
+            relPath !== undefined ? getPackageFilePath(relPath) : undefined;
+        let actionSchemas: ReadonlyMap<string, unknown>;
+        try {
+            actionSchemas =
+                provider.getActionSchemaFileForConfig(config).parsedActionSchema
+                    .actionSchemas;
+        } catch {
+            continue;
+        }
+        for (const actionName of actionSchemas.keys()) {
+            map.set(`${agentName}\n${actionName}`, {
+                schemaName: config.schemaName,
+                sourceFile,
+            });
+        }
+    }
+    return map;
+}
diff --git a/ts/packages/dispatcher/dispatcher/src/context/dispatcher/handlers/requestCommandHandler.ts b/ts/packages/dispatcher/dispatcher/src/context/dispatcher/handlers/requestCommandHandler.ts
index 3dca4105eb..6488d25041 100644
--- a/ts/packages/dispatcher/dispatcher/src/context/dispatcher/handlers/requestCommandHandler.ts
+++ b/ts/packages/dispatcher/dispatcher/src/context/dispatcher/handlers/requestCommandHandler.ts
@@ -11,6 +11,11 @@ import {
     equalNormalizedObject,
     toFullActions,
 } from "@typeagent/agent-cache";
+import type {
+    ExplainedDetail,
+    ExplainedMapping,
+    ExplainedSegment,
+} from "@typeagent/dispatcher-types";
 
 import {
     type CommandHandlerContext,
@@ -297,6 +302,335 @@ function getExplainerOptions(
     };
 }
 
+// Flatten action parameters into dotted-path rows for the explained popover,
+// e.g. { artist: { name: "Adele" } } -> [{ name: "artist.name", value: "Adele" }].
+function flattenExplainedParams(
+    value: unknown,
+    prefix: string,
+    rows: ExplainedMapping[],
+) {
+    if (value !== null && typeof value === "object") {
+        if (Array.isArray(value)) {
+            value.forEach((v, i) =>
+                flattenExplainedParams(v, `${prefix}[${i}]`, rows),
+            );
+            return;
+        }
+        for (const [key, v] of Object.entries(value)) {
+            flattenExplainedParams(v, prefix ? `${prefix}.${key}` : key, rows);
+        }
+        return;
+    }
+    rows.push({ name: prefix, value: String(value) });
+}
+
+// Assemble the detail payload backing the roadrunner popover: the user phrase,
+// the resolved action(s), the rule/generalized-form text, and the extracted
+// parameter mapping.
+function buildExplainedDetail(
+    source: ExplainedDetail["source"],
+    requestAction: RequestAction,
+    rule: string | undefined,
+    segments?: ExplainedSegment[] | undefined,
+    generalizations?: ExplainedSegment[][] | undefined,
+): ExplainedDetail {
+    const actions = toFullActions(requestAction.actions);
+    const multi = actions.length > 1;
+    const mapping: ExplainedMapping[] = [];
+    actions.forEach((action, i) => {
+        if (action.parameters !== undefined) {
+            flattenExplainedParams(
+                action.parameters,
+                multi ? `[${i}]` : "",
+                mapping,
+            );
+        }
+    });
+    return {
+        source,
+        phrase: requestAction.request,
+        action: actions
+            .map((a) => `${a.schemaName}.${a.actionName}`)
+            .join(", "),
+        rule,
+        mapping: mapping.length > 0 ? mapping : undefined,
+        segments: segments && segments.length > 0 ? segments : undefined,
+        generalizations:
+            generalizations && generalizations.length > 0
+                ? generalizations
+                : undefined,
+    };
+}
+
+// Break a V5 explanation's sub-phrases into { text, category } segments so the
+// client can color each phrase word by its role and match it to the same-color
+// marker in the generalized form. Best-effort and shape-tolerant.
+function buildSegments(explanationData: unknown): ExplainedSegment[] {
+    const data = explanationData as {
+        subPhrases?: { text?: unknown; category?: unknown }[];
+    };
+    if (!Array.isArray(data?.subPhrases)) return [];
+    const segments: ExplainedSegment[] = [];
+    for (const sp of data.subPhrases) {
+        if (typeof sp?.text === "string" && typeof sp?.category === "string") {
+            segments.push({ text: sp.text, category: sp.category });
+        }
+    }
+    return segments;
+}
+
+// Derive example same-meaning rephrasings from a V5 explanation, each broken
+// into per-category segments (so the client can color them like the phrase):
+// substitute each non-property sub-phrase's synonyms, and add the explainer's
+// polite prefix/suffix variants. Best-effort and shape-tolerant.
+function buildGeneralizations(
+    phrase: string,
+    baseSegments: ExplainedSegment[],
+    explanationData: unknown,
+): ExplainedSegment[][] {
+    const data = explanationData as {
+        subPhrases?: { synonyms?: unknown }[];
+        politePrefixes?: unknown[];
+        politeSuffixes?: unknown[];
+    };
+    const variants: ExplainedSegment[][] = [];
+    baseSegments.forEach((segment, i) => {
+        const synonyms = Array.isArray(data?.subPhrases?.[i]?.synonyms)
+            ? (data.subPhrases[i].synonyms as unknown[])
+            : [];
+        for (const synonym of synonyms) {
+            if (typeof synonym !== "string" || synonym === segment.text) {
+                continue;
+            }
+            variants.push(
+                baseSegments.map((s, j) =>
+                    j === i ? { text: synonym, category: s.category } : s,
+                ),
+            );
+        }
+    });
+    for (const prefix of data?.politePrefixes ?? []) {
+        if (typeof prefix === "string" && prefix.trim()) {
+            variants.push([
+                { text: prefix.trim(), category: "politeness" },
+                ...baseSegments,
+            ]);
+        }
+    }
+    for (const suffix of data?.politeSuffixes ?? []) {
+        if (typeof suffix === "string" && suffix.trim()) {
+            variants.push([
+                ...baseSegments,
+                { text: suffix.trim(), category: "politeness" },
+            ]);
+        }
+    }
+    // Dedupe (case-insensitive by joined text) and drop the original.
+    const seen = new Set<string>([phrase.toLowerCase()]);
+    const result: ExplainedSegment[][] = [];
+    for (const variant of variants) {
+        const key = variant
+            .map((s) => s.text)
+            .join(" ")
+            .toLowerCase();
+        if (seen.has(key)) continue;
+        seen.add(key);
+        result.push(variant);
+        if (result.length >= 24) break; // cap persisted list size
+    }
+    return result;
+}
+
+async function cacheUserAttachments(
+    systemContext: CommandHandlerContext,
+    attachments?: string[],
+): Promise<CachedImageWithDetails[]> {
+    const cachedAttachments: CachedImageWithDetails[] = [];
+    if (!attachments || systemContext.session.sessionDirPath === undefined) {
+        return cachedAttachments;
+    }
+    for (const attachment of attachments) {
+        const [attachmentName, tags]: [string, ExifReader.Tags] =
+            await systemContext.session.storeUserSuppliedFile(attachment);
+        cachedAttachments.push(
+            new CachedImageWithDetails(tags, attachmentName, attachment),
+        );
+    }
+    return cachedAttachments;
+}
+
+function shouldBypassTranslationForReasoning(
+    request: string,
+    systemContext: CommandHandlerContext,
+): boolean {
+    if (systemContext.noReasoning) {
+        return false;
+    }
+    const reasoningPrefixes = ["learn:", "dev:", "remember how to ", "record "];
+    const lowerRequest = request.trimStart().toLowerCase();
+    return (
+        process.env.CLAUDE_FORCE_REASONING === "1" ||
+        reasoningPrefixes.some((prefix) => lowerRequest.startsWith(prefix))
+    );
+}
+
+function recordRequestContext(
+    context: ActionContext<CommandHandlerContext>,
+    systemContext: CommandHandlerContext,
+    request: string,
+    cachedAttachments: CachedImageWithDetails[],
+    history: ReturnType<typeof getHistoryContext>,
+): void {
+    context.actionIO.appendDiagnosticData({
+        type: "translationContext",
+        entities: history?.entities ?? [],
+        activityContext: history?.activityContext,
+    });
+    if (systemContext.session.getConfig().execution.recordUserMessages) {
+        addUserMessageToHistory(systemContext, request, cachedAttachments);
+    }
+    if (systemContext.userRequestKnowledgeExtraction === true) {
+        addRequestToMemory(systemContext, request);
+    }
+}
+
+async function interpretRequestWithLogging(
+    context: ActionContext<CommandHandlerContext>,
+    systemContext: CommandHandlerContext,
+    request: string,
+    cachedAttachments: CachedImageWithDetails[],
+    history: ReturnType<typeof getHistoryContext>,
+): Promise<InterpretResult> {
+    try {
+        return await interpretRequest(
+            context,
+            request,
+            cachedAttachments,
+            history,
+        );
+    } catch (e: any) {
+        if (systemContext.userRequestKnowledgeExtraction === true) {
+            addResultToMemory(
+                systemContext,
+                `Error translating request '${request}': ${e.message}`,
+                DispatcherName,
+            );
+        }
+        systemContext?.logger?.logEvent("request:exception", {
+            request,
+            message: e.message,
+            stack: e.stack,
+        });
+        throw e;
+    }
+}
+
+function canUseInteractiveCollisionClarify(
+    systemContext: CommandHandlerContext,
+): boolean {
+    return (
+        systemContext.session.getConfig().collision.preference.enabled &&
+        systemContext.session.getConfig().collision.preference.remember !==
+            "never"
+    );
+}
+
+function needsReasoningFallback(
+    requestAction: RequestAction,
+    systemContext: CommandHandlerContext,
+): boolean {
+    const interactiveCollisionClarify =
+        canUseInteractiveCollisionClarify(systemContext);
+    return requestAction.actions.some(
+        ({ action }) =>
+            isUnknownAction(action) ||
+            (action.schemaName === DispatcherClarifyName &&
+                !(
+                    interactiveCollisionClarify &&
+                    action.actionName === "clarifyMultipleAgentMatches"
+                )),
+    );
+}
+
+async function tryReasoningFallback(
+    systemContext: CommandHandlerContext,
+    context: ActionContext<CommandHandlerContext>,
+    request: string,
+    requestAction: RequestAction,
+): Promise<boolean> {
+    if (
+        systemContext.noReasoning ||
+        !needsReasoningFallback(requestAction, systemContext)
+    ) {
+        return false;
+    }
+    try {
+        await runConfiguredReasoning(request, context);
+        return true;
+    } catch (e: any) {
+        debugRequest(
+            `Reasoning fallback failed, using default handler: ${e.message}`,
+        );
+        return false;
+    }
+}
+
+function needsErrorReasoning(
+    systemContext: CommandHandlerContext,
+    requestAction: RequestAction,
+): boolean {
+    return requestAction.actions.some(({ action }) => {
+        try {
+            return (
+                systemContext.agents.getActionConfig(action.schemaName)
+                    .errorReasoning === true
+            );
+        } catch {
+            return false;
+        }
+    });
+}
+
+async function tryErrorReasoningFallback(
+    systemContext: CommandHandlerContext,
+    context: ActionContext<CommandHandlerContext>,
+    request: string,
+    requestAction: RequestAction,
+    execResult: NonNullable<Awaited<ReturnType<typeof executeActions>>>,
+): Promise<boolean> {
+    if (
+        systemContext.noReasoning ||
+        !execResult.fallbackToReasoning ||
+        !needsErrorReasoning(systemContext, requestAction)
+    ) {
+        return false;
+    }
+
+    const { error, failedAction } = execResult;
+    const augmentedRequest =
+        `[Context: A direct action dispatch failed.\n` +
+        `Action: ${JSON.stringify(failedAction.action, undefined, 2)}\n` +
+        `Error: "${error}"\n` +
+        `Please handle the following request using the available tools.]\n\n` +
+        request;
+    try {
+        displayStatus("Action failed — retrying with reasoning...", context);
+        await runConfiguredReasoning(augmentedRequest, context, {
+            fallbackContext: {
+                failedSchema: failedAction.action.schemaName,
+                failedAction: failedAction.action.actionName,
+                error,
+            },
+        });
+        return true;
+    } catch (e: any) {
+        debugRequest(
+            `Error-triggered reasoning failed, keeping original error: ${e.message}`,
+        );
+        return false;
+    }
+}
+
 async function requestExplain(
     context: CommandHandlerContext,
     attachments: CachedImageWithDetails[] | undefined,
@@ -307,7 +641,7 @@ async function requestExplain(
 
     const { fromCache, fromUser, requestAction } = translationResult;
 
-    const notifyExplained = (error?: string) => {
+    const notifyExplained = (error?: string, detail?: ExplainedDetail) => {
         context.clientIO.notify(
             requestId,
             "explained",
@@ -316,8 +650,13 @@ async function requestExplain(
                 fromCache,
                 fromUser,
                 error,
+                detail,
             },
             DispatcherName,
+            undefined,
+            // Persist so the roadrunner icon + popover survive conversation
+            // rehydration (replayed from the DisplayLog on rejoin/reload).
+            { persist: true },
         );
     };
 
@@ -326,7 +665,33 @@ async function requestExplain(
         const error = explanationResult.success
             ? undefined
             : explanationResult?.message;
-        notifyExplained(error);
+        // The generalized form the model produced: the newly generated grammar
+        // rule (NFA mode) or the construction string (construction mode).
+        const rule =
+            result.grammarResult?.generatedRule ??
+            (explanationResult.success
+                ? explanationResult.construction?.toString()
+                : undefined);
+        const segments = explanationResult.success
+            ? buildSegments(explanationResult.data)
+            : undefined;
+        const generalizations = explanationResult.success
+            ? buildGeneralizations(
+                  requestAction.request,
+                  segments ?? [],
+                  explanationResult.data,
+              )
+            : undefined;
+        notifyExplained(
+            error,
+            buildExplainedDetail(
+                "model",
+                requestAction,
+                rule,
+                segments,
+                generalizations,
+            ),
+        );
 
         // Notify about grammar result (success or rejection)
         if (result.grammarResult) {
@@ -354,7 +719,14 @@ async function requestExplain(
     }
     if (fromCache && !fromUser) {
         // If it is from cache, and not from the user, explanation is not necessary.
-        notifyExplained();
+        notifyExplained(
+            undefined,
+            buildExplainedDetail(
+                fromCache,
+                requestAction,
+                translationResult.ruleText,
+            ),
+        );
         return;
     }
 
@@ -417,26 +789,10 @@ export class RequestCommandHandler implements CommandHandler {
             }
 
             // store attachments for later reuse
-            const cachedAttachments: CachedImageWithDetails[] = [];
-            if (
-                attachments &&
-                systemContext.session.sessionDirPath !== undefined
-            ) {
-                for (let i = 0; i < attachments?.length; i++) {
-                    const [attachmentName, tags]: [string, ExifReader.Tags] =
-                        await systemContext.session.storeUserSuppliedFile(
-                            attachments![i],
-                        );
-
-                    cachedAttachments.push(
-                        new CachedImageWithDetails(
-                            tags,
-                            attachmentName,
-                            attachments![i],
-                        ),
-                    );
-                }
-            }
+            const cachedAttachments = await cacheUserAttachments(
+                systemContext,
+                attachments,
+            );
 
             // Make sure we clear any left over streaming context
             systemContext.streamingActionContext?.closeActionContext();
@@ -446,66 +802,27 @@ export class RequestCommandHandler implements CommandHandler {
 
             // Requests with recording/reasoning prefixes bypass translation entirely
             // and go straight to Claude reasoning.
-            const REASONING_PREFIXES = [
-                "learn:",
-                "dev:",
-                "remember how to ",
-                "record ",
-            ];
-            const lowerRequest = request.trimStart().toLowerCase();
-            const forceReasoningEnv =
-                process.env.CLAUDE_FORCE_REASONING === "1";
-            if (
-                !systemContext.noReasoning &&
-                (forceReasoningEnv ||
-                    REASONING_PREFIXES.some((p) => lowerRequest.startsWith(p)))
-            ) {
+            if (shouldBypassTranslationForReasoning(request, systemContext)) {
                 await runConfiguredReasoning(request, context);
                 return;
             }
 
             // Get the history context before adding the request to memory
             const history = getHistoryContext(systemContext);
-            context.actionIO.appendDiagnosticData({
-                type: "translationContext",
-                entities: history?.entities ?? [],
-                activityContext: history?.activityContext,
-            });
-            if (
-                systemContext.session.getConfig().execution.recordUserMessages
-            ) {
-                addUserMessageToHistory(
-                    systemContext,
-                    request,
-                    cachedAttachments,
-                );
-            }
-            if (systemContext.userRequestKnowledgeExtraction === true) {
-                addRequestToMemory(systemContext, request);
-            }
-            let interpretResult: InterpretResult;
-            try {
-                interpretResult = await interpretRequest(
-                    context,
-                    request,
-                    cachedAttachments,
-                    history,
-                );
-            } catch (e: any) {
-                if (systemContext.userRequestKnowledgeExtraction === true) {
-                    addResultToMemory(
-                        systemContext,
-                        `Error translating request '${request}': ${e.message}`,
-                        DispatcherName,
-                    );
-                }
-                systemContext?.logger?.logEvent("request:exception", {
-                    request,
-                    message: e.message,
-                    stack: e.stack,
-                });
-                throw e;
-            }
+            recordRequestContext(
+                context,
+                systemContext,
+                request,
+                cachedAttachments,
+                history,
+            );
+            const interpretResult = await interpretRequestWithLogging(
+                context,
+                systemContext,
+                request,
+                cachedAttachments,
+                history,
+            );
 
             const { requestAction, tokenUsage } = interpretResult;
 
@@ -540,31 +857,12 @@ export class RequestCommandHandler implements CommandHandler {
             // `preference-clarify` feature is meant to render its own
             // interactive pick + "remember" card via executeActions, so it
             // must NOT be diverted to reasoning.
-            const interactiveCollisionClarify =
-                systemContext.session.getConfig().collision.preference
-                    .enabled &&
-                systemContext.session.getConfig().collision.preference
-                    .remember !== "never";
-            const needsReasoning = requestAction.actions.some(
-                ({ action }) =>
-                    isUnknownAction(action) ||
-                    (action.schemaName === DispatcherClarifyName &&
-                        !(
-                            interactiveCollisionClarify &&
-                            action.actionName === "clarifyMultipleAgentMatches"
-                        )),
+            const reasoningHandled = await tryReasoningFallback(
+                systemContext,
+                context,
+                request,
+                requestAction,
             );
-            let reasoningHandled = false;
-            if (needsReasoning && !systemContext.noReasoning) {
-                try {
-                    await runConfiguredReasoning(request, context);
-                    reasoningHandled = true;
-                } catch (e: any) {
-                    debugRequest(
-                        `Reasoning fallback failed, using default handler: ${e.message}`,
-                    );
-                }
-            }
             if (!reasoningHandled) {
                 const execResult = await executeActions(
                     requestAction.actions,
@@ -575,62 +873,22 @@ export class RequestCommandHandler implements CommandHandler {
                 // Error-triggered reasoning: if an action failed and at least one
                 // schema in the request opts in via errorReasoning: true, give Claude
                 // a second chance using the same reasoning loop as UnknownAction.
-                if (
-                    !systemContext.noReasoning &&
-                    execResult !== undefined &&
-                    execResult.fallbackToReasoning
-                ) {
-                    const needsErrorReasoning = requestAction.actions.some(
-                        ({ action }) => {
-                            try {
-                                return (
-                                    systemContext.agents.getActionConfig(
-                                        action.schemaName,
-                                    ).errorReasoning === true
-                                );
-                            } catch {
-                                return false;
-                            }
-                        },
-                    );
-                    let errorReasoningResolved = false;
-                    if (needsErrorReasoning) {
-                        const { error, failedAction } = execResult;
-                        const augmentedRequest =
-                            `[Context: A direct action dispatch failed.\n` +
-                            `Action: ${JSON.stringify(failedAction.action, undefined, 2)}\n` +
-                            `Error: "${error}"\n` +
-                            `Please handle the following request using the available tools.]\n\n` +
-                            request;
-                        try {
-                            displayStatus(
-                                "Action failed — retrying with reasoning...",
-                                context,
-                            );
-                            await runConfiguredReasoning(
-                                augmentedRequest,
-                                context,
-                                {
-                                    fallbackContext: {
-                                        failedSchema:
-                                            failedAction.action.schemaName,
-                                        failedAction:
-                                            failedAction.action.actionName,
-                                        error,
-                                    },
-                                },
-                            );
-                            errorReasoningResolved = true;
-                        } catch (e: any) {
-                            debugRequest(
-                                `Error-triggered reasoning failed, keeping original error: ${e.message}`,
-                            );
-                        }
-                    }
+                if (execResult !== undefined) {
+                    const errorReasoningResolved =
+                        await tryErrorReasoningFallback(
+                            systemContext,
+                            context,
+                            request,
+                            requestAction,
+                            execResult,
+                        );
                     // If error-triggered reasoning did not run (schema opted out)
                     // or failed to resolve the failure, surface the original
                     // action error instead of silently reporting success.
-                    if (!errorReasoningResolved) {
+                    if (
+                        execResult.fallbackToReasoning &&
+                        !errorReasoningResolved
+                    ) {
                         displayError(execResult.error, context);
                     }
                 }
diff --git a/ts/packages/dispatcher/dispatcher/src/context/session.ts b/ts/packages/dispatcher/dispatcher/src/context/session.ts
index 6aa18d0003..6e0217773b 100644
--- a/ts/packages/dispatcher/dispatcher/src/context/session.ts
+++ b/ts/packages/dispatcher/dispatcher/src/context/session.ts
@@ -202,6 +202,12 @@ export type DispatcherConfig = {
         // "inline": each reasoning phase (thinking, tool call, result, text) gets its own chat bubble.
         // "block": all reasoning output is appended into a single chat bubble (legacy behavior).
         reasoningDisplay: "inline" | "block";
+        // When true, client-forwarding actions run inside the reasoning loop
+        // (e.g. @conversation switch, which hands a manage-conversation payload
+        // to the client) reach the real client instead of being captured and
+        // dropped as "not supported". Off restores the capture-only behavior.
+        // Toggle via `@config execution reasoningForwardActions off`.
+        reasoningForwardActions: boolean;
         // When true, the dispatcher's pre-flight readiness gate auto-invokes
         // `AppAgent.setup` on agents reporting `setup-required` — instead of
         // throwing the "needs setup" error. The setup hook's ActionResult is
@@ -464,6 +470,7 @@ const defaultSessionConfig: SessionConfig = {
         },
         reasoning: "copilot",
         reasoningDisplay: "inline",
+        reasoningForwardActions: true, // reasoning may forward client actions (e.g. @conversation) to the client
         conversationAnswer: "reasoning-first", // default: reasoning agent handles conversation Q&A; lookup kept as fallback
         reasoningHistoryTurns: 10, // recent chat turns injected into the reasoning prompt
         recordUserMessages: true, // record the user's own turns in the transcript
diff --git a/ts/packages/dispatcher/dispatcher/src/context/system/action/conversationActionHandler.ts b/ts/packages/dispatcher/dispatcher/src/context/system/action/conversationActionHandler.ts
index a24d2204a4..adf2dd8a15 100644
--- a/ts/packages/dispatcher/dispatcher/src/context/system/action/conversationActionHandler.ts
+++ b/ts/packages/dispatcher/dispatcher/src/context/system/action/conversationActionHandler.ts
@@ -1,31 +1,38 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
 
-import { getRequestId } from "../../commandHandlerContext.js";
+import { processCommandNoLock } from "../../../command/command.js";
 import { CommandHandlerContext } from "../../commandHandlerContext.js";
 import { ConversationAction } from "../schema/conversationActionSchema.js";
-import { ManageConversationPayload } from "../manageConversationPayload.js";
 import { ActionContext, TypeAgentAction } from "@typeagent/agent-sdk";
 
+// Quote a conversation name so the command parser keeps it as a single
+// argument; names often contain spaces (and, rarely, quotes).
+function quoteName(name: string): string {
+    const escaped = name.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    return `"${escaped}"`;
+}
+
+// Each conversation action runs its equivalent `@conversation` command, which
+// owns the actual work (forwarding the manage-conversation payload to the
+// client). This mirrors the history agent and keeps the command canonical, so
+// the two paths cannot drift.
 export async function executeConversationAction(
     action: TypeAgentAction<ConversationAction>,
     context: ActionContext<CommandHandlerContext>,
 ) {
-    const agentContext = context.sessionContext.agentContext;
-    const requestId = getRequestId(agentContext);
-    let payload: ManageConversationPayload;
-
+    const systemContext = context.sessionContext.agentContext;
     let resultEntity: { name: string; type: string[] } | undefined;
-
+    let command: string;
     switch (action.actionName) {
         case "newConversation": {
             // Grammar matches that emit `parameters: {}` are normalized away
             // by the grammar engine, so `action.parameters` may be missing on
             // grammar-cache hits even though the schema marks it required.
             const name = action.parameters?.name;
-            payload = name
-                ? { subcommand: "new", name }
-                : { subcommand: "new" };
+            command = name
+                ? `@conversation new ${quoteName(name)}`
+                : "@conversation new";
             resultEntity = {
                 name: name ?? "new conversation",
                 type: ["conversation"],
@@ -33,37 +40,33 @@ export async function executeConversationAction(
             break;
         }
         case "listConversation":
-            payload = { subcommand: "list" };
+            command = "@conversation list";
             break;
         case "showConversationInfo":
-            payload = { subcommand: "info" };
+            command = "@conversation info";
             break;
         case "switchConversation":
-            payload = { subcommand: "switch", name: action.parameters.name };
+            command = `@conversation switch ${quoteName(action.parameters.name)}`;
             break;
         case "nextConversation":
-            payload = { subcommand: "next" };
+            command = "@conversation next";
             break;
         case "prevConversation":
-            payload = { subcommand: "prev" };
+            command = "@conversation prev";
             break;
         case "renameConversation": {
-            const renameName = action.parameters.name;
-            payload = renameName
-                ? {
-                      subcommand: "rename",
-                      name: renameName,
-                      newName: action.parameters.newName,
-                  }
-                : { subcommand: "rename", newName: action.parameters.newName };
+            const { name, newName } = action.parameters;
+            command = name
+                ? `@conversation rename ${quoteName(name)} ${quoteName(newName)}`
+                : `@conversation rename ${quoteName(newName)}`;
             resultEntity = {
-                name: action.parameters.newName,
+                name: newName,
                 type: ["conversation"],
             };
             break;
         }
         case "deleteConversation":
-            payload = { subcommand: "delete", name: action.parameters.name };
+            command = `@conversation delete ${quoteName(action.parameters.name)}`;
             break;
         default:
             throw new Error(
@@ -71,6 +74,6 @@ export async function executeConversationAction(
             );
     }
 
-    agentContext.clientIO.takeAction(requestId, "manage-conversation", payload);
+    await processCommandNoLock(command, systemContext);
     return { entities: [], resultEntity };
 }
diff --git a/ts/packages/dispatcher/dispatcher/src/context/system/describe/describeCore.ts b/ts/packages/dispatcher/dispatcher/src/context/system/describe/describeCore.ts
index 76a822c122..0191c52a15 100644
--- a/ts/packages/dispatcher/dispatcher/src/context/system/describe/describeCore.ts
+++ b/ts/packages/dispatcher/dispatcher/src/context/system/describe/describeCore.ts
@@ -10,8 +10,10 @@ import type {
     AgentSchemaInfo,
     AgentSubSchemaInfo,
 } from "@typeagent/dispatcher-types";
-import { openai } from "@typeagent/aiclient";
-import type { ChatModelWithStreaming } from "@typeagent/aiclient";
+import {
+    createJsonTranslatorFromSchemaDef,
+    type TypeChatJsonTranslatorWithSignal,
+} from "@typeagent/typechat-utils";
 import type { CommandHandlerContext } from "../../commandHandlerContext.js";
 import { getAgentSchemas } from "./agentSchemaInfo.js";
 
@@ -406,23 +408,37 @@ export function extractActionParameters(
     return body === undefined ? [] : parseParameterFields(body);
 }
 
-export function renderActionView(match: ActionMatch): string {
+/** Render the bolded `emoji schema.action — summary` action heading line. */
+function renderActionHeader(match: ActionMatch, summaryText: string): string {
     const { agent, subSchema, action } = match;
-    const summary = action.description ? ` — ${action.description}` : "";
-    const lines: string[] = [
-        `**${agent.emoji} ${subSchema.schemaName}.${action.name}**${summary}`,
-    ];
+    const summary = summaryText ? ` — ${summaryText}` : "";
+    return `**${agent.emoji} ${subSchema.schemaName}.${action.name}**${summary}`;
+}
 
-    const params = extractActionParameters(subSchema.schemaText, action.name);
-    if (params.length > 0) {
-        lines.push("", "**Parameters**");
-        for (const p of params) {
-            const optionalTag = p.optional ? ", optional" : "";
-            const comment = p.comment ? ` — ${p.comment}` : "";
-            lines.push(`- \`${p.name}\` (${p.type}${optionalTag})${comment}`);
-        }
+/** Render the `**Parameters**` block lines, or `[]` when there are none. */
+function renderParameterLines(params: ActionParameter[]): string[] {
+    if (params.length === 0) return [];
+    const lines = ["**Parameters**"];
+    for (const p of params) {
+        const optionalTag = p.optional ? ", optional" : "";
+        const comment = p.comment ? ` — ${p.comment}` : "";
+        lines.push(`- \`${p.name}\` (${p.type}${optionalTag})${comment}`);
     }
+    return lines;
+}
 
+export function renderActionView(match: ActionMatch): string {
+    const params = extractActionParameters(
+        match.subSchema.schemaText,
+        match.action.name,
+    );
+    const lines: string[] = [
+        renderActionHeader(match, match.action.description),
+    ];
+    const paramLines = renderParameterLines(params);
+    if (paramLines.length > 0) {
+        lines.push("", ...paramLines);
+    }
     return lines.join("\n");
 }
 
@@ -495,36 +511,56 @@ export function renderCapabilitiesDiscoveryFallback(
 }
 
 // ---------------------------------------------------------------------------
-// LLM polish (always attempted when a model is configured; deterministic
-// rendering above is the fallback on missing/failed model — see G5).
+// Structured-output polish (always attempted when a model is configured;
+// deterministic rendering above is the fallback on a missing/failed model —
+// see G5).
+//
+// The model returns a typed JSON object validated against the schema text
+// below; describeCore renders the final markdown deterministically from it, so
+// the model only supplies prose (never markdown or formatting).
 // ---------------------------------------------------------------------------
 
-function tryCreateDescribeModel(): ChatModelWithStreaming | undefined {
-    try {
-        const apiSettings = openai.apiSettingsFromEnv();
-        return openai.createChatModel(
-            apiSettings,
-            { temperature: 0.7, max_tokens: 800 },
-            undefined,
-            ["describeAction"],
-        );
-    } catch {
-        return undefined;
-    }
-}
+// Structured description the model produces for an agent. Keep in sync with
+// `agentDescriptionSchema` below (the text handed to the JSON translator).
+export type AgentDescriptionView = {
+    // Fluent, friendly 2-3 sentence summary of what the agent does, based only
+    // on the provided facts. Plain prose: no markdown, headings, or emphasis.
+    summary: string;
+};
+
+// Structured description the model produces for a single action. Keep in sync
+// with `actionDescriptionSchema` below.
+export type ActionDescriptionView = {
+    // Fuller explanation (1-3 sentences) of what the action does, beyond its
+    // one-line summary. Plain prose: no markdown.
+    explanation: string;
+    // One short natural-language phrase a user might say to trigger the action.
+    example: string;
+};
 
-async function tryComplete(
-    model: ChatModelWithStreaming,
-    prompt: string,
-): Promise<string | undefined> {
+const agentDescriptionSchema = `export type AgentDescriptionView = {
+    // Fluent, friendly 2-3 sentence summary of what the agent does, based only
+    // on the provided facts. Plain prose: no markdown, headings, or emphasis.
+    summary: string;
+};`;
+
+const actionDescriptionSchema = `export type ActionDescriptionView = {
+    // Fuller explanation (1-3 sentences) of what the action does, beyond its
+    // one-line summary. Plain prose: no markdown.
+    explanation: string;
+    // One short natural-language phrase a user might say to trigger the action.
+    example: string;
+};`;
+
+function tryCreateDescribeTranslator<T extends object>(
+    typeName: string,
+    schema: string,
+): TypeChatJsonTranslatorWithSignal<T> | undefined {
     try {
-        const result = await model.complete(prompt);
-        if (!result.success) return undefined;
-        const text = result.data.trim();
-        // An empty completion isn't usable polish; let the caller fall back
-        // to the deterministic rendering instead of returning blank text.
-        return text.length > 0 ? text : undefined;
+        return createJsonTranslatorFromSchemaDef<T>(typeName, schema);
     } catch {
+        // createChatModel throws when no model provider is configured; the
+        // caller falls back to the deterministic rendering.
         return undefined;
     }
 }
@@ -539,27 +575,42 @@ export async function polishAgentView(
     agent: AgentSchemaInfo,
     deterministic: string,
 ): Promise<string> {
-    const model = tryCreateDescribeModel();
-    if (model === undefined) return deterministic;
+    const translator = tryCreateDescribeTranslator<AgentDescriptionView>(
+        "AgentDescriptionView",
+        agentDescriptionSchema,
+    );
+    if (translator === undefined) return deterministic;
 
     const actionList = agent.subSchemas
         .flatMap((s) => s.actions)
         .map((a) => `- ${a.name}: ${a.description}`)
         .join("\n");
-    const prompt =
-        `Write one fluent, friendly paragraph (2-3 sentences) describing what the "${agent.name}" agent does, ` +
-        `for a chat assistant's capability listing. Base it only on the facts below; do not invent features.\n\n` +
+    const request =
+        `Summarize what the "${agent.name}" agent does for a chat assistant's ` +
+        `capability listing. Base it only on these facts; do not invent features.\n\n` +
         `Agent description: ${agent.description}\n` +
-        `Actions:\n${actionList}\n\n` +
-        `Respond with just the paragraph, no heading or markdown emphasis.`;
-    const polished = await tryComplete(model, prompt);
-    if (polished === undefined) return deterministic;
-
-    // Splice the polished paragraph in place of the deterministic summary
-    // line (first line of `deterministic`), keeping the rest (table/footer)
-    // unchanged and always deterministic.
+        `Actions:\n${actionList}`;
+    const result = await translator.translate(request);
+    if (!result.success) return deterministic;
+
+    return renderPolishedAgentView(agent, deterministic, result.data);
+}
+
+/**
+ * Splice the model's summary in place of the deterministic summary line (the
+ * first line of `deterministic`), keeping the rest (table/footer) unchanged
+ * and always deterministic. Returns the deterministic rendering unchanged when
+ * the model produced an empty summary.
+ */
+export function renderPolishedAgentView(
+    agent: AgentSchemaInfo,
+    deterministic: string,
+    view: AgentDescriptionView,
+): string {
+    const summary = view.summary.trim();
+    if (summary.length === 0) return deterministic;
     const rest = deterministic.split("\n").slice(1).join("\n");
-    return `${agentTitle(agent)} ${polished}\n${rest}`;
+    return `${agentTitle(agent)} ${summary}\n${rest}`;
 }
 
 /**
@@ -572,8 +623,11 @@ export async function polishActionView(
     match: ActionMatch,
     deterministic: string,
 ): Promise<string> {
-    const model = tryCreateDescribeModel();
-    if (model === undefined) return deterministic;
+    const translator = tryCreateDescribeTranslator<ActionDescriptionView>(
+        "ActionDescriptionView",
+        actionDescriptionSchema,
+    );
+    if (translator === undefined) return deterministic;
 
     const params = extractActionParameters(
         match.subSchema.schemaText,
@@ -585,17 +639,44 @@ export async function polishActionView(
                 `- ${p.name} (${p.type}${p.optional ? ", optional" : ""})${p.comment ? `: ${p.comment}` : ""}`,
         )
         .join("\n");
-    const prompt =
-        `Explain what the "${match.action.name}" action of the "${match.agent.name}" agent does, in more ` +
-        `detail than a one-line summary, for a chat assistant's capability listing. Base it only on the facts ` +
-        `below; do not invent parameters or behavior. Include the parameters and one example natural-language ` +
-        `phrasing a user might say to trigger it.\n\n` +
+    const request =
+        `Explain what the "${match.action.name}" action of the "${match.agent.name}" agent does, ` +
+        `in more detail than a one-line summary, for a chat assistant's capability listing. ` +
+        `Base it only on the facts below; do not invent parameters or behavior.\n\n` +
         `Action summary: ${match.action.description}\n` +
-        `Parameters:\n${paramList || "(none)"}\n\n` +
-        `Format as markdown: a short paragraph, then a "**Parameters**" bullet list (if any), then a ` +
-        `"**Example:**" line with a quoted phrase.`;
-    const polished = await tryComplete(model, prompt);
-    return polished ?? deterministic;
+        `Parameters:\n${paramList || "(none)"}`;
+    const result = await translator.translate(request);
+    if (!result.success) return deterministic;
+
+    return renderPolishedActionView(match, result.data);
+}
+
+/**
+ * Render the detailed action view from the model's structured description: the
+ * heading (using the fuller explanation, falling back to the one-line
+ * description), the deterministic parameters block, and an example phrasing.
+ */
+export function renderPolishedActionView(
+    match: ActionMatch,
+    view: ActionDescriptionView,
+): string {
+    const explanation = view.explanation.trim() || match.action.description;
+    const lines: string[] = [renderActionHeader(match, explanation)];
+
+    const params = extractActionParameters(
+        match.subSchema.schemaText,
+        match.action.name,
+    );
+    const paramLines = renderParameterLines(params);
+    if (paramLines.length > 0) {
+        lines.push("", ...paramLines);
+    }
+
+    const example = view.example.trim();
+    if (example.length > 0) {
+        lines.push("", `**Example:** "${example}"`);
+    }
+    return lines.join("\n");
 }
 
 // ---------------------------------------------------------------------------
diff --git a/ts/packages/dispatcher/dispatcher/src/context/system/handlers/configCommandHandlers.ts b/ts/packages/dispatcher/dispatcher/src/context/system/handlers/configCommandHandlers.ts
index 15a0d6170b..89ba88428c 100644
--- a/ts/packages/dispatcher/dispatcher/src/context/system/handlers/configCommandHandlers.ts
+++ b/ts/packages/dispatcher/dispatcher/src/context/system/handlers/configCommandHandlers.ts
@@ -2146,6 +2146,15 @@ const configExecutionCommandHandlers: CommandHandlerTable = {
                 );
             },
         ),
+        reasoningForwardActions: getToggleHandlerTable(
+            "let the reasoning agent forward client actions (e.g. @conversation switch) to the client instead of capturing them",
+            async (context, enable) => {
+                await changeContextConfig(
+                    { execution: { reasoningForwardActions: enable } },
+                    context,
+                );
+            },
+        ),
     },
 };
 
diff --git a/ts/packages/dispatcher/dispatcher/src/context/system/handlers/conversationCommandHandlers.ts b/ts/packages/dispatcher/dispatcher/src/context/system/handlers/conversationCommandHandlers.ts
index 0a8d751709..e929af6323 100644
--- a/ts/packages/dispatcher/dispatcher/src/context/system/handlers/conversationCommandHandlers.ts
+++ b/ts/packages/dispatcher/dispatcher/src/context/system/handlers/conversationCommandHandlers.ts
@@ -18,9 +18,11 @@ import {
 } from "../../commandHandlerContext.js";
 import { ManageConversationPayload } from "../manageConversationPayload.js";
 
-// Each handler dispatches the same "manage-conversation" client action
-// emitted by the natural-language conversationActionHandler — so the CLI
-// and Shell already know how to render the result.
+// Forward the manage-conversation payload to the client, which performs the
+// actual switch/rename/etc. The equivalent conversation action runs these
+// commands (see conversationActionHandler), so the payload is built in exactly
+// one place. Each handler's `action` property records that equivalence for
+// tooling such as the action browser.
 function dispatchManageConversation(
     context: ActionContext<CommandHandlerContext>,
     payload: ManageConversationPayload,
@@ -64,6 +66,7 @@ function completeConversationName(
 class ConversationNewCommandHandler implements CommandHandler {
     public readonly description =
         "Create a new conversation, optionally with a name";
+    public readonly action = "newConversation";
     public readonly parameters = {
         args: {
             name: {
@@ -86,6 +89,7 @@ class ConversationNewCommandHandler implements CommandHandler {
 
 class ConversationListCommandHandler implements CommandHandlerNoParams {
     public readonly description = "List all conversations";
+    public readonly action = "listConversation";
     public async run(context: ActionContext<CommandHandlerContext>) {
         dispatchManageConversation(context, { subcommand: "list" });
     }
@@ -93,6 +97,7 @@ class ConversationListCommandHandler implements CommandHandlerNoParams {
 
 class ConversationInfoCommandHandler implements CommandHandlerNoParams {
     public readonly description = "Show info about the current conversation";
+    public readonly action = "showConversationInfo";
     public async run(context: ActionContext<CommandHandlerContext>) {
         dispatchManageConversation(context, { subcommand: "info" });
     }
@@ -101,6 +106,7 @@ class ConversationInfoCommandHandler implements CommandHandlerNoParams {
 class ConversationSwitchCommandHandler implements CommandHandler {
     public readonly description =
         "Switch to a conversation by name (defaults to the next conversation in the list)";
+    public readonly action = "switchConversation";
     public readonly parameters = {
         args: {
             name: {
@@ -115,6 +121,8 @@ class ConversationSwitchCommandHandler implements CommandHandler {
         params: ParsedCommandParams<typeof this.parameters>,
     ) {
         const { name } = params.args;
+        // With no name, cycle to the next conversation (a CLI convenience the
+        // switchConversation action does not have).
         dispatchManageConversation(
             context,
             name ? { subcommand: "switch", name } : { subcommand: "next" },
@@ -132,6 +140,7 @@ class ConversationSwitchCommandHandler implements CommandHandler {
 class ConversationPrevCommandHandler implements CommandHandlerNoParams {
     public readonly description =
         "Switch to the previous conversation in the list (wraps around)";
+    public readonly action = "prevConversation";
     public async run(context: ActionContext<CommandHandlerContext>) {
         dispatchManageConversation(context, { subcommand: "prev" });
     }
@@ -140,6 +149,7 @@ class ConversationPrevCommandHandler implements CommandHandlerNoParams {
 class ConversationNextCommandHandler implements CommandHandlerNoParams {
     public readonly description =
         "Switch to the next conversation in the list (wraps around)";
+    public readonly action = "nextConversation";
     public async run(context: ActionContext<CommandHandlerContext>) {
         dispatchManageConversation(context, { subcommand: "next" });
     }
@@ -148,6 +158,7 @@ class ConversationNextCommandHandler implements CommandHandlerNoParams {
 class ConversationRenameCommandHandler implements CommandHandler {
     public readonly description =
         "Rename a conversation. With one argument, renames the current conversation; with two, renames the named conversation.";
+    public readonly action = "renameConversation";
     public readonly parameters = {
         args: {
             nameOrNewName: {
@@ -167,11 +178,7 @@ class ConversationRenameCommandHandler implements CommandHandler {
         const { nameOrNewName, newName } = params.args;
         const payload: ManageConversationPayload =
             newName !== undefined
-                ? {
-                      subcommand: "rename",
-                      name: nameOrNewName,
-                      newName,
-                  }
+                ? { subcommand: "rename", name: nameOrNewName, newName }
                 : { subcommand: "rename", newName: nameOrNewName };
         dispatchManageConversation(context, payload);
     }
@@ -188,6 +195,7 @@ class ConversationRenameCommandHandler implements CommandHandler {
 
 class ConversationDeleteCommandHandler implements CommandHandler {
     public readonly description = "Delete a conversation by name";
+    public readonly action = "deleteConversation";
     public readonly parameters = {
         args: {
             name: {
diff --git a/ts/packages/dispatcher/dispatcher/src/context/system/handlers/historyCommandHandler.ts b/ts/packages/dispatcher/dispatcher/src/context/system/handlers/historyCommandHandler.ts
index 30064529c5..0544ea24d2 100644
--- a/ts/packages/dispatcher/dispatcher/src/context/system/handlers/historyCommandHandler.ts
+++ b/ts/packages/dispatcher/dispatcher/src/context/system/handlers/historyCommandHandler.ts
@@ -21,6 +21,7 @@ import { clearReasoningSession as clearCopilotReasoningSession } from "../../../
 
 class HistoryListCommandHandler implements CommandHandlerNoParams {
     public readonly description = "List history";
+    public readonly action = "listHistory";
     public async run(context: ActionContext<CommandHandlerContext>) {
         const systemContext = context.sessionContext.agentContext;
         const history = systemContext.chatHistory;
@@ -30,6 +31,7 @@ class HistoryListCommandHandler implements CommandHandlerNoParams {
 
 class HistoryClearCommandHandler implements CommandHandler {
     public readonly description = "Clear the history";
+    public readonly action = "clearHistory";
     public readonly parameters = {
         flags: {
             activity: {
@@ -59,6 +61,7 @@ class HistoryClearCommandHandler implements CommandHandler {
 class HistoryDeleteCommandHandler implements CommandHandler {
     public readonly description =
         "Delete a specific message from the chat history";
+    public readonly action = "deleteHistory";
     public readonly parameters = {
         args: {
             index: {
diff --git a/ts/packages/dispatcher/dispatcher/src/context/system/manageConversationPayload.ts b/ts/packages/dispatcher/dispatcher/src/context/system/manageConversationPayload.ts
index d26607d9b0..74d816587e 100644
--- a/ts/packages/dispatcher/dispatcher/src/context/system/manageConversationPayload.ts
+++ b/ts/packages/dispatcher/dispatcher/src/context/system/manageConversationPayload.ts
@@ -2,10 +2,10 @@
 // Licensed under the MIT License.
 
 /**
- * Payload for the "manage-conversation" client action, dispatched from
- * both the natural-language conversation action handler and the
- * @conversation command handlers.  Clients (Shell, CLI) read this to
- * render the appropriate result.
+ * Payload for the "manage-conversation" client action, built by the
+ * @conversation command handlers and forwarded to the client (Shell, CLI),
+ * which performs the switch/rename/etc.  The natural-language conversation
+ * actions run these commands, so this payload is constructed in one place.
  */
 export type ManageConversationPayload = {
     subcommand:
diff --git a/ts/packages/dispatcher/dispatcher/src/internal.ts b/ts/packages/dispatcher/dispatcher/src/internal.ts
index 93aa60e4d0..cf2964d0f0 100644
--- a/ts/packages/dispatcher/dispatcher/src/internal.ts
+++ b/ts/packages/dispatcher/dispatcher/src/internal.ts
@@ -9,7 +9,14 @@ export {
     prewarmReasoning,
 } from "./context/commandHandlerContext.js";
 export type { CommandHandlerContext } from "./context/commandHandlerContext.js";
-export { collectCommandReferenceMarkdown } from "./command/commandReference.js";
+export {
+    collectCommandReferenceMarkdown,
+    collectActionReference,
+} from "./command/commandReference.js";
+export type {
+    CommandReferenceOptions,
+    ActionReferenceEntry,
+} from "./command/commandReference.js";
 export { lockInstanceDir } from "./utils/fsUtils.js";
 export { DisplayLog } from "./displayLog.js";
 export type { DisplayLogEntry } from "./displayLog.js";
diff --git a/ts/packages/dispatcher/dispatcher/src/reasoning/claude.ts b/ts/packages/dispatcher/dispatcher/src/reasoning/claude.ts
index f73555cd6b..c2d6184543 100644
--- a/ts/packages/dispatcher/dispatcher/src/reasoning/claude.ts
+++ b/ts/packages/dispatcher/dispatcher/src/reasoning/claude.ts
@@ -516,6 +516,12 @@ function getClaudeOptions(
 
             const result: IAgentMessage[] = [];
             const savedClientIO = systemContext.clientIO;
+            // When enabled, client-forwarding actions (e.g. @conversation
+            // switch's manage-conversation) reach the real client instead of
+            // nullClientIO's "not supported"; off keeps capture-only.
+            const forwardActions =
+                systemContext.session.getConfig().execution
+                    .reasoningForwardActions;
             const capturingClientIO: ClientIO = {
                 ...nullClientIO,
                 setDisplay: (message) => {
@@ -534,6 +540,13 @@ function getClaudeOptions(
                 appendDiagnosticData: (requestId, data) => {
                     savedClientIO.appendDiagnosticData(requestId, data);
                 },
+                ...(forwardActions
+                    ? {
+                          takeAction: (
+                              ...args: Parameters<ClientIO["takeAction"]>
+                          ) => savedClientIO.takeAction(...args),
+                      }
+                    : {}),
             };
             systemContext.isInsideReasoningLoop = true;
             let actionResult: ActionResult | undefined;
diff --git a/ts/packages/dispatcher/dispatcher/src/reasoning/copilot.ts b/ts/packages/dispatcher/dispatcher/src/reasoning/copilot.ts
index ff00077b22..d620a7851b 100644
--- a/ts/packages/dispatcher/dispatcher/src/reasoning/copilot.ts
+++ b/ts/packages/dispatcher/dispatcher/src/reasoning/copilot.ts
@@ -743,6 +743,13 @@ function getCopilotSessionConfig(
 
                 // Capture action execution results (same as Claude)
                 const result: IAgentMessage[] = [];
+                const savedClientIO = systemContext.clientIO;
+                // When enabled, client-forwarding actions (e.g. @conversation
+                // switch's manage-conversation) reach the real client instead
+                // of nullClientIO's "not supported"; off keeps capture-only.
+                const forwardActions =
+                    systemContext.session.getConfig().execution
+                        .reasoningForwardActions;
                 const capturingClientIO: ClientIO = {
                     ...nullClientIO,
                     setDisplay: (message) => {
@@ -753,9 +760,15 @@ function getCopilotSessionConfig(
                             result.push(message);
                         }
                     },
+                    ...(forwardActions
+                        ? {
+                              takeAction: (
+                                  ...args: Parameters<ClientIO["takeAction"]>
+                              ) => savedClientIO.takeAction(...args),
+                          }
+                        : {}),
                 };
 
-                const savedClientIO = systemContext.clientIO;
                 try {
                     systemContext.clientIO = capturingClientIO;
                     const actionResult = await executeAction(
diff --git a/ts/packages/dispatcher/dispatcher/src/translation/interpretRequest.ts b/ts/packages/dispatcher/dispatcher/src/translation/interpretRequest.ts
index a479a92d4c..298da596ae 100644
--- a/ts/packages/dispatcher/dispatcher/src/translation/interpretRequest.ts
+++ b/ts/packages/dispatcher/dispatcher/src/translation/interpretRequest.ts
@@ -73,6 +73,9 @@ export type InterpretResult = {
     fromUser: boolean;
     fromCache: "construction" | "grammar" | false;
     tokenUsage?: ai.CompletionUsageStats | undefined;
+    // The matched construction/rule pattern text (cache hits only), surfaced
+    // for the explained popover.
+    ruleText?: string | undefined;
 };
 
 export function getCannotUseCacheReason(
@@ -333,5 +336,6 @@ export async function interpretRequest(
         fromCache:
             translateResult.type === "translate" ? false : translateResult.type,
         tokenUsage,
+        ruleText: translateResult.ruleText,
     };
 }
diff --git a/ts/packages/dispatcher/dispatcher/src/translation/matchRequest.ts b/ts/packages/dispatcher/dispatcher/src/translation/matchRequest.ts
index cb26bd8603..f2f99d8d4f 100644
--- a/ts/packages/dispatcher/dispatcher/src/translation/matchRequest.ts
+++ b/ts/packages/dispatcher/dispatcher/src/translation/matchRequest.ts
@@ -420,6 +420,7 @@ export async function matchRequest(
         type: chosen.type,
         requestAction: chosen.match,
         elapsedMs,
+        ruleText: chosen.ruleText,
         config: {
             ...matchConfig,
             explainerName: systemContext.agentCache.explainerName,
diff --git a/ts/packages/dispatcher/dispatcher/src/translation/translateRequest.ts b/ts/packages/dispatcher/dispatcher/src/translation/translateRequest.ts
index f8ab033d35..1436d04127 100644
--- a/ts/packages/dispatcher/dispatcher/src/translation/translateRequest.ts
+++ b/ts/packages/dispatcher/dispatcher/src/translation/translateRequest.ts
@@ -1188,6 +1188,9 @@ export type TranslationResult = {
     type: "translate" | "construction" | "grammar";
     config: any;
     allMatches?: any;
+    // The matched construction/rule pattern text (construction cache hits
+    // only), surfaced for the explained popover.
+    ruleText?: string | undefined;
 };
 
 // null means cancelled because of replacement parse error.
diff --git a/ts/packages/dispatcher/dispatcher/test/commandReference.spec.ts b/ts/packages/dispatcher/dispatcher/test/commandReference.spec.ts
index a5a34c2d11..26a8d62fd8 100644
--- a/ts/packages/dispatcher/dispatcher/test/commandReference.spec.ts
+++ b/ts/packages/dispatcher/dispatcher/test/commandReference.spec.ts
@@ -24,6 +24,7 @@ const handlers = {
     commands: {
         run: {
             description: "Run a task",
+            action: "runTask",
             parameters: {
                 args: {
                     task: {
@@ -165,6 +166,46 @@ describe("collectCommandReferenceMarkdown", () => {
         expect(markdown).toContain("## @doctest group leaf - A leaf command");
     });
 
+    it("renders the equivalent action when a command declares one", () => {
+        const runIdx = markdown.indexOf("## @doctest run - Run a task");
+        const nextSection = markdown.indexOf("\n## ", runIdx + 1);
+        const runBlock = markdown.slice(
+            runIdx,
+            nextSection === -1 ? undefined : nextSection,
+        );
+        expect(runBlock).toContain("Equivalent action: `runTask`");
+    });
+
+    it("omits the equivalent action line when a command declares none", () => {
+        const leafIdx = markdown.indexOf("## @doctest group leaf");
+        const nextSection = markdown.indexOf("\n## ", leafIdx + 1);
+        const leafBlock = markdown.slice(
+            leafIdx,
+            nextSection === -1 ? undefined : nextSection,
+        );
+        expect(leafBlock).not.toContain("Equivalent action:");
+    });
+
+    it("renders a fully-qualified, linked action when a resolver is supplied", async () => {
+        const resolved = await collectCommandReferenceMarkdown(context, {
+            resolveAction: (agentName, actionName) =>
+                agentName === "doctest" && actionName === "runTask"
+                    ? {
+                          qualifiedName: "doctest.tasks.runTask",
+                          link: "../foo/tasksSchema.ts",
+                      }
+                    : undefined,
+        });
+        const runIdx = resolved.indexOf("## @doctest run - Run a task");
+        const runBlock = resolved.slice(
+            runIdx,
+            resolved.indexOf("\n## ", runIdx + 1),
+        );
+        expect(runBlock).toContain(
+            "Equivalent action: [`doctest.tasks.runTask`](../foo/tasksSchema.ts)",
+        );
+    });
+
     it("omits Flags/Arguments sections for parameter-less commands", () => {
         const exitIndex = markdown.indexOf("## @exit -");
         expect(exitIndex).toBeGreaterThanOrEqual(0);
diff --git a/ts/packages/dispatcher/dispatcher/test/conversationActionHandler.spec.ts b/ts/packages/dispatcher/dispatcher/test/conversationActionHandler.spec.ts
index fa52f9e165..cbe67a54bf 100644
--- a/ts/packages/dispatcher/dispatcher/test/conversationActionHandler.spec.ts
+++ b/ts/packages/dispatcher/dispatcher/test/conversationActionHandler.spec.ts
@@ -2,257 +2,139 @@
 // Licensed under the MIT License.
 
 /**
- * Tests for executeConversationAction in sessionActionHandler.ts.
- *
- * getRequestId is mocked to return a stable RequestId, and
- * clientIO.takeAction is a mock on the context stub.
+ * Tests for executeConversationAction. Each conversation action delegates to
+ * the equivalent `@conversation` command via processCommandNoLock (matching the
+ * history agent), so these assert the command string it runs and the entity it
+ * returns.
  */
 
 import { describe, it, expect, jest } from "@jest/globals";
 
-// ── Mock getRequestId before importing the handler ──────────────────────────
-
-const mockRequestId = { requestId: "test-request-id" };
-
-jest.unstable_mockModule("../src/context/commandHandlerContext.js", () => ({
-    getRequestId: jest.fn(() => mockRequestId),
+// Capture the delegated command string by stubbing the command processor.
+const mockProcessCommandNoLock = jest.fn();
+jest.unstable_mockModule("../src/command/command.js", () => ({
+    processCommandNoLock: mockProcessCommandNoLock,
 }));
 
-// ── Dynamic import after mocks are installed ──────────────────────────────────
-
 const { executeConversationAction } = await import(
     "../src/context/system/action/conversationActionHandler.js"
 );
 
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-let mockTakeAction: jest.Mock;
-
-/** Minimal ActionContext stub — agentContext with clientIO.takeAction. */
+const agentContext = { id: "agent-context" } as any;
 function makeContext() {
-    mockTakeAction = jest.fn();
-    return {
-        sessionContext: {
-            agentContext: {
-                clientIO: {
-                    takeAction: mockTakeAction,
-                },
-                currentRequestId: mockRequestId,
-            },
-        },
-    } as any;
+    mockProcessCommandNoLock.mockClear();
+    return { sessionContext: { agentContext } } as any;
+}
+
+async function run(action: any) {
+    return executeConversationAction(
+        { schemaName: "system.conversation", ...action },
+        makeContext(),
+    );
 }
 
-// ── Tests ─────────────────────────────────────────────────────────────────────
+function expectCommand(command: string) {
+    expect(mockProcessCommandNoLock).toHaveBeenCalledWith(
+        command,
+        agentContext,
+    );
+}
 
-describe("executeConversationAction — newConversation", () => {
-    it("sends manage-conversation with subcommand new and name", async () => {
-        const ctx = makeContext();
-        await executeConversationAction(
-            {
-                schemaName: "system.conversation",
-                actionName: "newConversation",
-                parameters: { name: "research" },
-            },
-            ctx,
-        );
-        expect(mockTakeAction).toHaveBeenCalledWith(
-            mockRequestId,
-            "manage-conversation",
-            { subcommand: "new", name: "research" },
-        );
+describe("executeConversationAction delegates to @conversation commands", () => {
+    it("newConversation with a name runs a quoted new command", async () => {
+        const r = await run({
+            actionName: "newConversation",
+            parameters: { name: "research" },
+        });
+        expectCommand('@conversation new "research"');
+        expect(r.resultEntity).toEqual({
+            name: "research",
+            type: ["conversation"],
+        });
     });
 
-    it("sends manage-conversation with subcommand new without name when omitted", async () => {
-        const ctx = makeContext();
-        await executeConversationAction(
-            {
-                schemaName: "system.conversation",
-                actionName: "newConversation",
-                parameters: {},
-            },
-            ctx,
-        );
-        expect(mockTakeAction).toHaveBeenCalledWith(
-            mockRequestId,
-            "manage-conversation",
-            { subcommand: "new" },
-        );
+    it("newConversation without a name runs a bare new command", async () => {
+        const r = await run({ actionName: "newConversation", parameters: {} });
+        expectCommand("@conversation new");
+        expect(r.resultEntity).toEqual({
+            name: "new conversation",
+            type: ["conversation"],
+        });
     });
 
-    it("preserves conversation names that contain spaces", async () => {
-        const ctx = makeContext();
-        await executeConversationAction(
-            {
-                schemaName: "system.conversation",
-                actionName: "newConversation",
-                parameters: { name: "my work project" },
-            },
-            ctx,
-        );
-        expect(mockTakeAction).toHaveBeenCalledWith(
-            mockRequestId,
-            "manage-conversation",
-            { subcommand: "new", name: "my work project" },
-        );
+    it("quotes conversation names that contain spaces", async () => {
+        await run({
+            actionName: "newConversation",
+            parameters: { name: "my work project" },
+        });
+        expectCommand('@conversation new "my work project"');
     });
-});
 
-describe("executeConversationAction — listConversation", () => {
-    it("sends manage-conversation with subcommand list", async () => {
-        const ctx = makeContext();
-        await executeConversationAction(
-            {
-                schemaName: "system.conversation",
-                actionName: "listConversation",
-            },
-            ctx,
-        );
-        expect(mockTakeAction).toHaveBeenCalledWith(
-            mockRequestId,
-            "manage-conversation",
-            { subcommand: "list" },
-        );
+    it("escapes embedded quotes in conversation names", async () => {
+        await run({
+            actionName: "newConversation",
+            parameters: { name: 'fix "bug"' },
+        });
+        expectCommand('@conversation new "fix \\"bug\\""');
     });
-});
 
-describe("executeConversationAction — showConversationInfo", () => {
-    it("sends manage-conversation with subcommand info", async () => {
-        const ctx = makeContext();
-        await executeConversationAction(
-            {
-                schemaName: "system.conversation",
-                actionName: "showConversationInfo",
-            },
-            ctx,
-        );
-        expect(mockTakeAction).toHaveBeenCalledWith(
-            mockRequestId,
-            "manage-conversation",
-            { subcommand: "info" },
-        );
+    it("listConversation runs list", async () => {
+        await run({ actionName: "listConversation" });
+        expectCommand("@conversation list");
     });
-});
 
-describe("executeConversationAction — switchConversation", () => {
-    it("sends manage-conversation with subcommand switch", async () => {
-        const ctx = makeContext();
-        await executeConversationAction(
-            {
-                schemaName: "system.conversation",
-                actionName: "switchConversation",
-                parameters: { name: "work" },
-            },
-            ctx,
-        );
-        expect(mockTakeAction).toHaveBeenCalledWith(
-            mockRequestId,
-            "manage-conversation",
-            { subcommand: "switch", name: "work" },
-        );
+    it("showConversationInfo runs info", async () => {
+        await run({ actionName: "showConversationInfo" });
+        expectCommand("@conversation info");
     });
 
-    it("preserves conversation names that contain spaces", async () => {
-        const ctx = makeContext();
-        await executeConversationAction(
-            {
-                schemaName: "system.conversation",
-                actionName: "switchConversation",
-                parameters: { name: "my work project" },
-            },
-            ctx,
-        );
-        expect(mockTakeAction).toHaveBeenCalledWith(
-            mockRequestId,
-            "manage-conversation",
-            { subcommand: "switch", name: "my work project" },
-        );
+    it("switchConversation runs a quoted switch", async () => {
+        await run({
+            actionName: "switchConversation",
+            parameters: { name: "my work project" },
+        });
+        expectCommand('@conversation switch "my work project"');
     });
-});
 
-describe("executeConversationAction — renameConversation", () => {
-    it("sends manage-conversation with subcommand rename and newName (current conversation)", async () => {
-        const ctx = makeContext();
-        await executeConversationAction(
-            {
-                schemaName: "system.conversation",
-                actionName: "renameConversation",
-                parameters: { newName: "my project" },
-            },
-            ctx,
-        );
-        expect(mockTakeAction).toHaveBeenCalledWith(
-            mockRequestId,
-            "manage-conversation",
-            { subcommand: "rename", newName: "my project" },
-        );
+    it("nextConversation runs next", async () => {
+        await run({ actionName: "nextConversation" });
+        expectCommand("@conversation next");
     });
 
-    it("sends manage-conversation with subcommand rename, name, and newName (targeted conversation)", async () => {
-        const ctx = makeContext();
-        await executeConversationAction(
-            {
-                schemaName: "system.conversation",
-                actionName: "renameConversation",
-                parameters: { name: "test7", newName: "test5" },
-            },
-            ctx,
-        );
-        expect(mockTakeAction).toHaveBeenCalledWith(
-            mockRequestId,
-            "manage-conversation",
-            { subcommand: "rename", name: "test7", newName: "test5" },
-        );
+    it("prevConversation runs prev", async () => {
+        await run({ actionName: "prevConversation" });
+        expectCommand("@conversation prev");
     });
-});
 
-describe("executeConversationAction — deleteConversation", () => {
-    it("sends manage-conversation with subcommand delete", async () => {
-        const ctx = makeContext();
-        await executeConversationAction(
-            {
-                schemaName: "system.conversation",
-                actionName: "deleteConversation",
-                parameters: { name: "old-project" },
-            },
-            ctx,
-        );
-        expect(mockTakeAction).toHaveBeenCalledWith(
-            mockRequestId,
-            "manage-conversation",
-            { subcommand: "delete", name: "old-project" },
-        );
+    it("renameConversation (current) runs rename with one quoted arg", async () => {
+        const r = await run({
+            actionName: "renameConversation",
+            parameters: { newName: "my project" },
+        });
+        expectCommand('@conversation rename "my project"');
+        expect(r.resultEntity).toEqual({
+            name: "my project",
+            type: ["conversation"],
+        });
     });
 
-    it("preserves conversation names that contain spaces", async () => {
-        const ctx = makeContext();
-        await executeConversationAction(
-            {
-                schemaName: "system.conversation",
-                actionName: "deleteConversation",
-                parameters: { name: "old work project" },
-            },
-            ctx,
-        );
-        expect(mockTakeAction).toHaveBeenCalledWith(
-            mockRequestId,
-            "manage-conversation",
-            { subcommand: "delete", name: "old work project" },
-        );
+    it("renameConversation (targeted) runs rename with two quoted args", async () => {
+        const r = await run({
+            actionName: "renameConversation",
+            parameters: { name: "test7", newName: "test5" },
+        });
+        expectCommand('@conversation rename "test7" "test5"');
+        expect(r.resultEntity).toEqual({
+            name: "test5",
+            type: ["conversation"],
+        });
     });
-});
 
-describe("executeConversationAction — invalid action", () => {
-    it("throws on an unrecognized action name", async () => {
-        const ctx = makeContext();
-        await expect(
-            executeConversationAction(
-                {
-                    schemaName: "system.conversation",
-                    actionName: "unknownAction",
-                } as any,
-                ctx,
-            ),
-        ).rejects.toThrow("Invalid action name: unknownAction");
+    it("deleteConversation runs a quoted delete", async () => {
+        await run({
+            actionName: "deleteConversation",
+            parameters: { name: "old-project" },
+        });
+        expectCommand('@conversation delete "old-project"');
     });
 });
diff --git a/ts/packages/dispatcher/dispatcher/test/conversationCommandHandlers.spec.ts b/ts/packages/dispatcher/dispatcher/test/conversationCommandHandlers.spec.ts
new file mode 100644
index 0000000000..f4a76d93ad
--- /dev/null
+++ b/ts/packages/dispatcher/dispatcher/test/conversationCommandHandlers.spec.ts
@@ -0,0 +1,120 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+/**
+ * Tests for the @conversation command handlers. Each builds the
+ * manage-conversation payload and forwards it to the client. The commands are
+ * canonical (the conversation actions run them), so the payload mapping is
+ * verified here.
+ */
+
+import { describe, it, expect, jest } from "@jest/globals";
+
+// getRequestId is the only runtime value the handlers import from the context
+// module; stub it so the takeAction call is assertable.
+const mockRequestId = { requestId: "test-request-id" };
+jest.unstable_mockModule("../src/context/commandHandlerContext.js", () => ({
+    getRequestId: jest.fn(() => mockRequestId),
+}));
+
+const { getConversationCommandHandlers } = await import(
+    "../src/context/system/handlers/conversationCommandHandlers.js"
+);
+
+const commands = getConversationCommandHandlers().commands;
+
+let mockTakeAction: jest.Mock;
+function makeContext() {
+    mockTakeAction = jest.fn();
+    return {
+        sessionContext: {
+            agentContext: { clientIO: { takeAction: mockTakeAction } },
+        },
+    } as any;
+}
+
+async function runCommand(name: string, params: any) {
+    const handler = commands[name] as any;
+    await handler.run(makeContext(), params);
+}
+
+function expectPayload(payload: any) {
+    expect(mockTakeAction).toHaveBeenCalledWith(
+        mockRequestId,
+        "manage-conversation",
+        payload,
+    );
+}
+
+describe("@conversation command handlers build manage-conversation payloads", () => {
+    it("new with a name", async () => {
+        await runCommand("new", { args: { name: "research" } });
+        expectPayload({ subcommand: "new", name: "research" });
+    });
+
+    it("new without a name", async () => {
+        await runCommand("new", { args: {} });
+        expectPayload({ subcommand: "new" });
+    });
+
+    it("preserves names that contain spaces", async () => {
+        await runCommand("new", { args: { name: "my work project" } });
+        expectPayload({ subcommand: "new", name: "my work project" });
+    });
+
+    it("list", async () => {
+        await runCommand("list", undefined);
+        expectPayload({ subcommand: "list" });
+    });
+
+    it("info", async () => {
+        await runCommand("info", undefined);
+        expectPayload({ subcommand: "info" });
+    });
+
+    it("switch with a name", async () => {
+        await runCommand("switch", { args: { name: "work" } });
+        expectPayload({ subcommand: "switch", name: "work" });
+    });
+
+    it("switch without a name cycles to next", async () => {
+        await runCommand("switch", { args: {} });
+        expectPayload({ subcommand: "next" });
+    });
+
+    it("prev", async () => {
+        await runCommand("prev", undefined);
+        expectPayload({ subcommand: "prev" });
+    });
+
+    it("next", async () => {
+        await runCommand("next", undefined);
+        expectPayload({ subcommand: "next" });
+    });
+
+    it("rename the current conversation (one arg)", async () => {
+        await runCommand("rename", { args: { nameOrNewName: "my project" } });
+        expectPayload({ subcommand: "rename", newName: "my project" });
+    });
+
+    it("rename a named conversation (two args)", async () => {
+        await runCommand("rename", {
+            args: { nameOrNewName: "test7", newName: "test5" },
+        });
+        expectPayload({
+            subcommand: "rename",
+            name: "test7",
+            newName: "test5",
+        });
+    });
+
+    it("delete", async () => {
+        await runCommand("delete", { args: { name: "old-project" } });
+        expectPayload({ subcommand: "delete", name: "old-project" });
+    });
+
+    it("help", async () => {
+        await runCommand("help", undefined);
+        expectPayload({ subcommand: "help" });
+    });
+});
diff --git a/ts/packages/dispatcher/dispatcher/test/describeCore.spec.ts b/ts/packages/dispatcher/dispatcher/test/describeCore.spec.ts
index ab38495b7c..9973291b79 100644
--- a/ts/packages/dispatcher/dispatcher/test/describeCore.spec.ts
+++ b/ts/packages/dispatcher/dispatcher/test/describeCore.spec.ts
@@ -13,6 +13,8 @@ import {
     renderActionNotFoundMessage,
     polishAgentView,
     polishActionView,
+    renderPolishedAgentView,
+    renderPolishedActionView,
     isCapabilityDiscoveryAlias,
     renderCapabilitiesDiscoveryFallback,
 } from "../src/context/system/describe/describeCore.js";
@@ -447,6 +449,66 @@ describe("describeCore deterministic rendering", () => {
     });
 });
 
+describe("describeCore structured-output rendering", () => {
+    it("splices the model summary into the agent view, keeping the table", () => {
+        const agent = makeSpotifyAgent(3);
+        const deterministic = renderAgentView(agent, false, () => true);
+        const result = renderPolishedAgentView(agent, deterministic, {
+            summary: "It plays and controls your local music.",
+        });
+        expect(result).toContain(
+            "**🎵 The spotify agent** It plays and controls your local music.",
+        );
+        // The deterministic action table is preserved unchanged.
+        expect(result).toContain("| Action | What it does |");
+        expect(result).toContain("| play |");
+    });
+
+    it("returns the deterministic agent view when the summary is empty", () => {
+        const agent = makeSpotifyAgent(3);
+        const deterministic = renderAgentView(agent, false, () => true);
+        expect(
+            renderPolishedAgentView(agent, deterministic, { summary: "   " }),
+        ).toBe(deterministic);
+    });
+
+    it("renders the action view from the structured explanation and example", () => {
+        const agent = makeSpotifyAgent(3);
+        const match = {
+            agent,
+            subSchema: agent.subSchemas[0],
+            action: agent.subSchemas[0].actions[0],
+        };
+        const markdown = renderPolishedActionView(match, {
+            explanation: "Starts playback of the requested music.",
+            example: "play some jazz",
+        });
+        expect(markdown).toContain(
+            "**🎵 spotify.play** — Starts playback of the requested music.",
+        );
+        expect(markdown).toContain("**Parameters**");
+        expect(markdown).toContain("`query` (string)");
+        expect(markdown).toContain('**Example:** "play some jazz"');
+    });
+
+    it("falls back to the one-line description and omits an empty example", () => {
+        const agent = makeSpotifyAgent(3);
+        const match = {
+            agent,
+            subSchema: agent.subSchemas[0],
+            action: agent.subSchemas[0].actions[0],
+        };
+        const markdown = renderPolishedActionView(match, {
+            explanation: "   ",
+            example: "   ",
+        });
+        expect(markdown).toContain(
+            "**🎵 spotify.play** — Play a track, album, artist, or playlist",
+        );
+        expect(markdown).not.toContain("**Example:**");
+    });
+});
+
 describe("describeCore LLM fallback (no model configured)", () => {
     const originalEnv = { ...process.env };
 
diff --git a/ts/packages/dispatcher/types/README.AUTOGEN.md b/ts/packages/dispatcher/types/README.AUTOGEN.md
index e928627df9..86d56e31c5 100644
--- a/ts/packages/dispatcher/types/README.AUTOGEN.md
+++ b/ts/packages/dispatcher/types/README.AUTOGEN.md
@@ -3,7 +3,7 @@
 
 <!-- AUTOGEN:DOCS:START -->
 
-<!-- AUTOGEN:DOCS:HASH:sha256=0bf32cbdb49e9336393bacb2cb2cb723d41c23bfdaf9e2842854efc73545a683 -->
+<!-- AUTOGEN:DOCS:HASH:sha256=f6097e6f87a9ef275e44f397bedc21d9bbbecf3d0e59db29cce47c09f3d8ca70 -->
 <!-- AUTOGEN:DOCS:SOURCE: ./README.md (hand-written documentation; this file is the AI-generated companion) -->
 
 # @typeagent/dispatcher-types — AI-generated documentation
@@ -12,18 +12,18 @@
 
 ## Overview
 
-The `@typeagent/dispatcher-types` package provides a comprehensive set of TypeScript type definitions that are foundational to the TypeAgent ecosystem. These types are used to define the structure of data exchanged between the dispatcher, agents, and clients, ensuring type safety and consistency across the system. This package is a core dependency for many other packages in the TypeAgent monorepo, including `@typeagent/agent-server-protocol`, `@typeagent/copilot-plugin`, and `agent-dispatcher`.
+The `@typeagent/dispatcher-types` package provides a set of TypeScript type definitions that are central to the TypeAgent ecosystem. These types define the structure of data exchanged between the dispatcher, agents, and clients, ensuring type safety and consistency across the system. This package is widely used by other components in the TypeAgent monorepo, such as `@typeagent/agent-server-protocol`, `@typeagent/copilot-plugin`, and `agent-dispatcher`.
 
 ## What it does
 
-This package defines a wide range of types and utilities that support the functionality of the TypeAgent dispatcher and its interactions with other components. Key areas of functionality include:
+This package serves as the type definition backbone for the TypeAgent dispatcher and its interactions with other components. It includes:
 
-- **Dispatcher Communication**: Types such as `RequestId`, `DispatcherName`, and `DispatcherEmoji` define the identity and communication structure of the dispatcher.
-- **Client Input/Output**: Types like `IAgentMessage`, `TemplateEditConfig`, and `NotifyExplainedData` facilitate client interactions, including message formatting, template management, and data exchange.
-- **Pending Interactions**: Types such as `PendingInteractionRequest` and `PendingInteractionResponse` define the structure of interactions that require client input, such as questions, proposed actions, or forms.
-- **Queue Management**: Types like `QueuedRequest`, `QueueCancelReason`, and `QueueRequestState` define the lifecycle and management of server-side message queues.
-- **Logging and Display**: Types such as `SetDisplayEntry` and `AppendDisplayEntry` are used for managing and formatting log entries for display purposes.
-- **Dispatcher Status**: Helper functions like `getStatusSummary` in [status.ts](./src/helpers/status.ts) provide utilities for summarizing and representing the state of the dispatcher.
+- **Dispatcher Identity and Communication**: Types like `RequestId`, `DispatcherName`, and `DispatcherEmoji` define the identity and communication structure of the dispatcher.
+- **Client Input/Output**: Types such as `IAgentMessage`, `TemplateEditConfig`, and `NotifyExplainedData` facilitate client interactions, including message formatting, template management, and data exchange.
+- **Pending Interactions**: Types like `PendingInteractionRequest` and `PendingInteractionResponse` define the structure of interactions that require client input, such as questions, proposed actions, or forms.
+- **Queue Management**: Types such as `QueuedRequest`, `QueueCancelReason`, and `QueueRequestState` define the lifecycle and management of server-side message queues.
+- **Logging and Display**: Types like `SetDisplayEntry` and `AppendDisplayEntry` are used for managing and formatting log entries for display purposes.
+- **Dispatcher Status Utilities**: Helper functions like `getStatusSummary` in [status.ts](./src/helpers/status.ts) provide utilities for summarizing and representing the state of the dispatcher.
 
 These types are consumed by various packages in the TypeAgent ecosystem, enabling consistent and reliable communication between components.
 
@@ -87,15 +87,15 @@ External: _None at runtime._
 ### Used by
 
 - [@typeagent/agent-server-protocol](../../../packages/agentServer/protocol/README.md)
+- [@typeagent/browser](../../../packages/agents/browser/README.md)
 - [@typeagent/browser-extension](../../../packages/agents/browserExtension/README.md)
+- [@typeagent/chat-ui](../../../packages/chat-ui/README.md)
 - [@typeagent/copilot-plugin](../../../packages/copilot-plugin/README.md)
 - [@typeagent/dispatcher-rpc](../../../packages/dispatcher/rpc/README.md)
 - [agent-cli](../../../packages/cli/README.md)
 - [agent-dispatcher](../../../packages/dispatcher/dispatcher/README.md)
 - [agent-server](../../../packages/agentServer/server/README.md)
 - [agent-shell](../../../packages/shell/README.md)
-- [browser-typeagent](../../../packages/agents/browser/README.md)
-- [chat-ui](../../../packages/chat-ui/README.md)
 - _…and 8 more workspace consumers._
 
 ### Files of interest
@@ -104,6 +104,6 @@ External: _None at runtime._
 
 ---
 
-_Auto-generated against commit `8f591da77983db53fd4a3e0ca12b58d80aaa3628` on `2026-07-22T20:55:48.144Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter @typeagent/dispatcher-types docs:verify-links` to spot-check._
+_Auto-generated against commit `5018562335eded84b16dedcbb8e86d59b538a978` on `2026-07-30T06:29:20.146Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter @typeagent/dispatcher-types docs:verify-links` to spot-check._
 
 <!-- AUTOGEN:DOCS:END -->
diff --git a/ts/packages/dispatcher/types/src/clientIO.ts b/ts/packages/dispatcher/types/src/clientIO.ts
index 277650634c..2e916e6666 100644
--- a/ts/packages/dispatcher/types/src/clientIO.ts
+++ b/ts/packages/dispatcher/types/src/clientIO.ts
@@ -49,11 +49,46 @@ export interface IAgentMessage {
     kind?: AgentMessageKind | undefined;
 }
 
+// One row of the "how the phrase mapped to the action" table shown in the
+// explained popover: a parameter (dotted path) and the value extracted for it.
+export type ExplainedMapping = {
+    name: string;
+    value: string;
+};
+
+// One sub-phrase of the original request as the explainer broke it down: the
+// original words and the category the explainer assigned (e.g. "politeness",
+// "action", "entity"). Drives per-category coloring so a phrase word and its
+// matching generalized-form marker share a color.
+export type ExplainedSegment = {
+    text: string;
+    category: string;
+};
+
+// Rich detail backing the popover shown when the user clicks the roadrunner.
+// `source` distinguishes a cache hit (an existing construction/grammar rule
+// was triggered) from a fresh model translation the explainer generalized.
+// `rule` is the construction/grammar rule text (the generalized form for the
+// model case); `mapping` lists the extracted parameter values; `segments` is
+// the per-category sub-phrase breakdown; `generalizations` are example
+// same-meaning rephrasings, each broken into the same per-category segments so
+// they can be colored consistently.
+export type ExplainedDetail = {
+    source: "construction" | "grammar" | "model";
+    phrase: string;
+    action: string;
+    rule?: string | undefined;
+    mapping?: ExplainedMapping[] | undefined;
+    segments?: ExplainedSegment[] | undefined;
+    generalizations?: ExplainedSegment[][] | undefined;
+};
+
 export type NotifyExplainedData = {
     error?: string | undefined;
     fromCache: "construction" | "grammar" | false;
     fromUser: boolean;
     time: string;
+    detail?: ExplainedDetail | undefined;
 };
 
 // Options for ClientIO.notify. All notifications are ephemeral by default and
diff --git a/ts/packages/shell/README.AUTOGEN.md b/ts/packages/shell/README.AUTOGEN.md
index e313f95173..ec3913a4a3 100644
--- a/ts/packages/shell/README.AUTOGEN.md
+++ b/ts/packages/shell/README.AUTOGEN.md
@@ -3,7 +3,7 @@
 
 <!-- AUTOGEN:DOCS:START -->
 
-<!-- AUTOGEN:DOCS:HASH:sha256=2938fd8600e6c3e3f9e60156679305ccdbd0ffbdf8c782abb1ace6f9518b1f98 -->
+<!-- AUTOGEN:DOCS:HASH:sha256=8c952d590a62a02ef90658e1bd5b56dd130c885fffd22ac9ddd674ba15ce66a2 -->
 <!-- AUTOGEN:DOCS:SOURCE: ./README.md (hand-written documentation; this file is the AI-generated companion) -->
 
 # agent-shell — AI-generated documentation
@@ -12,7 +12,7 @@
 
 ## Overview
 
-The `agent-shell` package is a TypeScript library that provides the graphical user interface (GUI) for the TypeAgent ecosystem. Built on Electron, it serves as a personal agent interface, enabling users to interact with an extensible set of agents through natural language, perform actions, and manage conversations. The shell supports both local and remote operation modes and integrates with other TypeAgent components, such as the dispatcher and agent server.
+The `agent-shell` package is a TypeScript library that provides the graphical user interface (GUI) for the TypeAgent ecosystem. Built on Electron, it acts as a personal agent interface, enabling users to interact with an extensible set of agents through natural language, perform actions, and manage conversations. The shell supports both local and remote operation modes and integrates with other TypeAgent components, such as the dispatcher and agent server.
 
 ## What it does
 
@@ -176,6 +176,6 @@ _6 environment variables referenced from `./src/` (set in `ts/.env` or your shel
 
 ---
 
-_Auto-generated against commit `fa4bb9b44db12e2d15b83e03e59f9c7147ed2b50` on `2026-07-27T19:08:36.121Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter agent-shell docs:verify-links` to spot-check._
+_Auto-generated against commit `5018562335eded84b16dedcbb8e86d59b538a978` on `2026-07-30T06:29:20.146Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter agent-shell docs:verify-links` to spot-check._
 
 <!-- AUTOGEN:DOCS:END -->
diff --git a/ts/packages/shell/src/main/conversationManager.ts b/ts/packages/shell/src/main/conversationManager.ts
index b04a99a101..afebbf052b 100644
--- a/ts/packages/shell/src/main/conversationManager.ts
+++ b/ts/packages/shell/src/main/conversationManager.ts
@@ -19,18 +19,18 @@ import type {
 import type { AgentServerConnection } from "@typeagent/agent-server-client";
 import {
     manageConversation,
+    renderConversationActionResult,
     switchConversationSafe,
-    type ConversationActionResult,
     type ManageConversationContext,
     type ManageConversationPayload,
 } from "@typeagent/agent-server-client/conversation";
 import type { ClientIO, Dispatcher, QueueSnapshot } from "agent-dispatcher";
+import type { DisplayContent } from "@typeagent/agent-sdk";
 import { debugShell } from "./debug.js";
 import { saveUserSettings } from "agent-dispatcher/helpers/userSettings";
 
 export type ConversationManageResult = {
-    html: string;
-    kind: "info" | "warning" | "error";
+    content: DisplayContent;
     switched?: boolean;
 };
 
@@ -60,6 +60,7 @@ export function createLocalConversationBackend(): ConversationManagerBackend {
         name: "Default Conversation",
         clientCount: 1,
         createdAt: new Date().toISOString(),
+        messageCount: 0,
     };
 
     return {
@@ -107,8 +108,12 @@ export function createLocalConversationBackend(): ConversationManagerBackend {
         },
         async manageAction(): Promise<ConversationManageResult> {
             return {
-                html: "Conversation management is not supported in local mode. Connect to the Agent Server to use conversation management.",
-                kind: "warning",
+                content: {
+                    type: "text",
+                    content:
+                        "Conversation management is not supported in local mode. Connect to the Agent Server to use conversation management.",
+                    kind: "warning",
+                },
             };
         },
     };
@@ -384,81 +389,13 @@ export function createRemoteConversationBackend(
                     payload,
                 );
 
-                return renderConversationActionResult(result);
+                return {
+                    content: renderConversationActionResult(result),
+                    ...(result.kind === "ok" && result.switched
+                        ? { switched: true }
+                        : {}),
+                };
             });
         },
     };
 }
-
-function escapeHtml(s: string): string {
-    return s.replace(/[&<>"']/g, (c) => {
-        switch (c) {
-            case "&":
-                return "&amp;";
-            case "<":
-                return "&lt;";
-            case ">":
-                return "&gt;";
-            case '"':
-                return "&quot;";
-            default:
-                return "&#39;";
-        }
-    });
-}
-
-// Replace plain "<name>" runs in helper messages with bold-escaped HTML.
-function htmlizeMessage(message: string): string {
-    return message.replace(
-        /"([^"]+)"/g,
-        (_, name) => `"<b>${escapeHtml(name)}</b>"`,
-    );
-}
-
-function renderConversationActionResult(
-    result: ConversationActionResult,
-): ConversationManageResult {
-    switch (result.kind) {
-        case "ok":
-            return {
-                html: htmlizeMessage(result.message),
-                kind: "info",
-                ...(result.switched ? { switched: true } : {}),
-            };
-        case "warning":
-            return {
-                html: htmlizeMessage(result.message),
-                kind: "warning",
-            };
-        case "error":
-            return {
-                html: `❌ ${htmlizeMessage(result.message)}`,
-                kind: "error",
-            };
-        case "cancelled":
-            return { html: "Cancelled.", kind: "info" };
-        case "info":
-            return {
-                html:
-                    `<b>Current conversation:</b><br>` +
-                    `Name: ${escapeHtml(result.name)}<br>` +
-                    `<span style="font-family:monospace;font-size:smaller;">${escapeHtml(result.conversationId)}</span>`,
-                kind: "info",
-            };
-        case "list": {
-            if (result.conversations.length === 0) {
-                return { html: "<i>No conversations found.</i>", kind: "info" };
-            }
-            const items = result.conversations
-                .map((s) => {
-                    const cur =
-                        s.conversationId === result.currentConversationId
-                            ? "▸ "
-                            : "";
-                    return `<li>${cur}${escapeHtml(s.name)}</li>`;
-                })
-                .join("");
-            return { html: `<ul>${items}</ul>`, kind: "info" };
-        }
-    }
-}
diff --git a/ts/packages/shell/src/preload/electronTypes.ts b/ts/packages/shell/src/preload/electronTypes.ts
index e10c2f7f9f..b98d8d3a6a 100644
--- a/ts/packages/shell/src/preload/electronTypes.ts
+++ b/ts/packages/shell/src/preload/electronTypes.ts
@@ -11,6 +11,7 @@ import type {
 import type { ManageConversationPayload } from "@typeagent/agent-server-client/conversation";
 import type { ConversationInfo } from "@typeagent/agent-server-client";
 import type { ConnectionStatus } from "@typeagent/chat-ui";
+import type { DisplayContent } from "@typeagent/agent-sdk";
 
 export type { ShellUserSettings };
 
@@ -107,8 +108,7 @@ export interface ClientAPI {
         { conversationId: string; name: string } | undefined
     >;
     conversationManageAction(payload: ManageConversationPayload): Promise<{
-        html: string;
-        kind: "info" | "warning" | "error";
+        content: DisplayContent;
         switched?: boolean;
     }>;
 
diff --git a/ts/packages/shell/src/renderer/src/chatPanelBridge.ts b/ts/packages/shell/src/renderer/src/chatPanelBridge.ts
index ffe44c844a..b364706885 100644
--- a/ts/packages/shell/src/renderer/src/chatPanelBridge.ts
+++ b/ts/packages/shell/src/renderer/src/chatPanelBridge.ts
@@ -187,6 +187,19 @@ function toHistoryEntries(entries: any[]): HistoryEntry[] {
                     requestId: ridStr(e.requestId),
                 });
                 break;
+            case "notify": {
+                // Persisted "explained" notifications restore the roadrunner
+                // icon + click-to-open popover on replayed user bubbles.
+                const rid = ridStr(e.notificationId ?? e.requestId);
+                if (e.event === "explained" && rid) {
+                    out.push({
+                        kind: "explained",
+                        requestId: rid,
+                        data: e.data,
+                    });
+                }
+                break;
+            }
             case "command-result": {
                 const m = e.metrics;
                 const actions: any[] | undefined = m?.actions;
@@ -1105,8 +1118,8 @@ export function createChatPanelClient(
                 chatPanel.addSystemMessage("Interaction cancelled.");
             }
         },
-        takeAction: (_requestId, action, data) => {
-            handleTakeAction(action, data);
+        takeAction: (requestId, action, data) => {
+            handleTakeAction(requestId, action, data);
         },
         onUserFeedback: (entry) => {
             chatPanel.applyFeedback(entry);
@@ -1192,7 +1205,11 @@ export function createChatPanelClient(
         },
     };
 
-    function handleTakeAction(action: string, data: unknown) {
+    function handleTakeAction(
+        requestId: RequestId,
+        action: string,
+        data: unknown,
+    ) {
         try {
             const d: any = data;
             switch (action) {
@@ -1215,14 +1232,16 @@ export function createChatPanelClient(
                     getClientAPI().openFolder(data as string);
                     break;
                 case "manage-conversation":
-                    void handleManageConversation(d).catch((e) =>
-                        chatPanel.showInline(
+                    void handleManageConversation(requestId, d).catch((e) =>
+                        chatPanel.replaceAgentMessage(
                             {
-                                type: "html",
+                                type: "text",
                                 content: `❌ ${e?.message ?? String(e)}`,
                                 kind: "warning",
                             },
                             "conversation",
+                            chatPanel.iconForSource("conversation"),
+                            ridStr(requestId),
                         ),
                     );
                     break;
@@ -1237,12 +1256,15 @@ export function createChatPanelClient(
     }
 
     async function handleManageConversation(
+        requestId: RequestId,
         payload: ManageConversationPayload,
     ) {
         const result = await getClientAPI().conversationManageAction(payload);
-        chatPanel.showInline(
-            { type: "html", content: result.html, kind: result.kind },
+        chatPanel.replaceAgentMessage(
+            result.content,
             "conversation",
+            chatPanel.iconForSource("conversation"),
+            ridStr(requestId),
         );
     }
 
diff --git a/ts/packages/vscode-shell/README.AUTOGEN.md b/ts/packages/vscode-shell/README.AUTOGEN.md
index f2e46aafbd..fadcc5910d 100644
--- a/ts/packages/vscode-shell/README.AUTOGEN.md
+++ b/ts/packages/vscode-shell/README.AUTOGEN.md
@@ -3,7 +3,7 @@
 
 <!-- AUTOGEN:DOCS:START -->
 
-<!-- AUTOGEN:DOCS:HASH:sha256=49339682363669abb9eb1a2fce4052e99402d7ea3bf648113caa0803634d6b15 -->
+<!-- AUTOGEN:DOCS:HASH:sha256=aeedf2258b3938cabc8023661455e7f21c619634706020af10b1fca252d7bfbc -->
 <!-- AUTOGEN:DOCS:SOURCE: ./README.md (hand-written documentation; this file is the AI-generated companion) -->
 
 # vscode-shell — AI-generated documentation
@@ -174,6 +174,6 @@ External: `ansi_up`, `debug`, `dompurify`, `isomorphic-ws`, `markdown-it`, `micr
 
 ---
 
-_Auto-generated against commit `33c83792f9a6ab6f17e52ca4856f765a2a056905` on `2026-07-27T20:21:59.625Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter vscode-shell docs:verify-links` to spot-check._
+_Auto-generated against commit `95c8336eb7cd853020fc28cbc98b6380676e73f3` on `2026-07-30T17:32:13.295Z` by `docs-generate.yml`. Links validated at that commit; the working tree may have drifted by up to 24h. Re-run `pnpm --filter vscode-shell docs:verify-links` to spot-check._
 
 <!-- AUTOGEN:DOCS:END -->
diff --git a/ts/packages/vscode-shell/src/agentServerBridge.ts b/ts/packages/vscode-shell/src/agentServerBridge.ts
index 2fccbd35d5..5dcf3e7d6d 100644
--- a/ts/packages/vscode-shell/src/agentServerBridge.ts
+++ b/ts/packages/vscode-shell/src/agentServerBridge.ts
@@ -11,6 +11,7 @@ import {
 import {
     findOrCreateNamedConversation,
     manageConversation,
+    renderConversationActionResult,
     switchConversationSafe,
     type ConversationActionResult,
     type ManageConversationContext,
@@ -2150,7 +2151,8 @@ export class AgentServerBridge {
                   type: "html" | "markdown" | "text";
                   content: string;
                   kind?: "info" | "warning" | "error" | "success";
-              },
+              }
+            | ReturnType<typeof renderConversationActionResult>,
         source: string = "code.code-vscode-shell",
     ): void {
         this.broadcastToWebviews({
@@ -2879,101 +2881,27 @@ export class AgentServerBridge {
         await this.postSessionList();
     }
 
-    // Map a structured ConversationActionResult to the bridge's two
-    // display surfaces — inline action-bubble overwrite for non-switching
-    // results, conversation-notification banner for switching results
-    // (the request bubble belongs to the old conversation and gets
-    // cleared on sessionChanged).
+    // Render a ConversationActionResult into the message bubble as structured
+    // content (shared with the Electron shell). Switching results surface a
+    // notification banner instead - the request bubble belongs to the old
+    // conversation and gets cleared on sessionChanged.
     private renderManageResult(
         requestId: any,
         result: ConversationActionResult,
         _switchTargetName?: string,
     ): void {
-        switch (result.kind) {
-            case "ok":
-                if (result.switched) {
-                    this.displayConversationNotification(
-                        htmlizeManageMessage(result.message),
-                        "info",
-                    );
-                } else {
-                    this.overwriteActionBubble(
-                        requestId,
-                        {
-                            type: "html",
-                            content: htmlizeManageMessage(result.message),
-                            kind: "info",
-                        },
-                        "conversation",
-                    );
-                }
-                return;
-            case "warning":
-                this.overwriteActionBubble(
-                    requestId,
-                    {
-                        type: "html",
-                        content: htmlizeManageMessage(result.message),
-                        kind: "warning",
-                    },
-                    "conversation",
-                );
-                return;
-            case "error":
-                this.overwriteActionBubble(
-                    requestId,
-                    {
-                        type: "html",
-                        content: `❌ ${htmlizeManageMessage(result.message)}`,
-                        kind: "error",
-                    },
-                    "conversation",
-                );
-                return;
-            case "cancelled":
-                this.overwriteActionBubble(
-                    requestId,
-                    {
-                        type: "html",
-                        content: "Cancelled.",
-                        kind: "info",
-                    },
-                    "conversation",
-                );
-                return;
-            case "info":
-                this.overwriteActionBubble(
-                    requestId,
-                    {
-                        type: "html",
-                        content: `Current conversation: <b>${escapeHtml(result.name)}</b> (${escapeHtml(result.conversationId)})`,
-                        kind: "info",
-                    },
-                    "conversation",
-                );
-                return;
-            case "list": {
-                let html: string;
-                if (result.conversations.length === 0) {
-                    html = "No conversations found.";
-                } else {
-                    const rows = result.conversations.map((s) => {
-                        const isCurrent =
-                            s.conversationId === result.currentConversationId;
-                        const marker = isCurrent ? " ← <b>current</b>" : "";
-                        const date = new Date(s.createdAt).toLocaleDateString();
-                        return `• <b>${escapeHtml(s.name)}</b> (${escapeHtml(s.conversationId)}) — ${s.clientCount} client(s), created ${escapeHtml(date)}${marker}`;
-                    });
-                    html = `<b>Conversations (${result.conversations.length})</b><br>${rows.join("<br>")}`;
-                }
-                this.overwriteActionBubble(
-                    requestId,
-                    { type: "html", content: html, kind: "info" },
-                    "conversation",
-                );
-                return;
-            }
+        if (result.kind === "ok" && result.switched) {
+            this.displayConversationNotification(
+                htmlizeManageMessage(result.message),
+                "info",
+            );
+            return;
         }
+        this.overwriteActionBubble(
+            requestId,
+            renderConversationActionResult(result),
+            "conversation",
+        );
     }
 
     public notifyDemoState(
diff --git a/ts/packages/vscode-shell/src/bridge/historyReplay.ts b/ts/packages/vscode-shell/src/bridge/historyReplay.ts
index a5262300ef..2b2b75f9f3 100644
--- a/ts/packages/vscode-shell/src/bridge/historyReplay.ts
+++ b/ts/packages/vscode-shell/src/bridge/historyReplay.ts
@@ -61,6 +61,17 @@ export function toHistoryReplayMessage(
                         tokenUsage: (e as any).tokenUsage,
                         actionTokenUsage: (e as any).actionTokenUsage,
                     };
+                case "notify":
+                    // Persisted "explained" notifications restore the
+                    // roadrunner icon + popover on replayed user bubbles.
+                    return {
+                        type: "notify",
+                        seq: e.seq,
+                        timestamp: e.timestamp,
+                        notificationId: clientIdOf(e.notificationId),
+                        event: e.event,
+                        data: e.data,
+                    };
                 default:
                     return { type: "skip", seq: e.seq };
             }
diff --git a/ts/packages/vscode-shell/src/bridge/messages.ts b/ts/packages/vscode-shell/src/bridge/messages.ts
index cef0145c49..c3944e5bd5 100644
--- a/ts/packages/vscode-shell/src/bridge/messages.ts
+++ b/ts/packages/vscode-shell/src/bridge/messages.ts
@@ -208,6 +208,10 @@ export type BridgeToWebviewMessage =
               metrics?: any;
               tokenUsage?: any;
               actionTokenUsage?: any;
+              // notify (persisted "explained")
+              event?: string;
+              data?: unknown;
+              notificationId?: string;
           }>;
       }
     | {
diff --git a/ts/packages/vscode-shell/src/webview/main.ts b/ts/packages/vscode-shell/src/webview/main.ts
index 58e7e4d71f..85d2e0bb03 100644
--- a/ts/packages/vscode-shell/src/webview/main.ts
+++ b/ts/packages/vscode-shell/src/webview/main.ts
@@ -788,6 +788,19 @@ function toChatPanelHistory(entries: any[]): HistoryEntry[] {
                 });
                 break;
             }
+            case "notify": {
+                // Persisted "explained" notifications restore the roadrunner
+                // icon + click-to-open popover on replayed user bubbles.
+                const rid = e.notificationId ?? e.requestId;
+                if (e.event === "explained" && rid) {
+                    out.push({
+                        kind: "explained",
+                        requestId: rid,
+                        data: e.data,
+                    });
+                }
+                break;
+            }
         }
     }
     return out;
diff --git a/ts/pnpm-lock.yaml b/ts/pnpm-lock.yaml
index bf746a9ee9..d1baf5335e 100644
--- a/ts/pnpm-lock.yaml
+++ b/ts/pnpm-lock.yaml
@@ -3254,6 +3254,49 @@ importers:
         specifier: ~5.4.5
         version: 5.4.5
 
+  packages/agents/selfhelp:
+    dependencies:
+      '@typeagent/agent-runtime':
+        specifier: workspace:*
+        version: link:../../typeagent
+      '@typeagent/agent-sdk':
+        specifier: workspace:*
+        version: link:../../agentSdk
+      '@typeagent/aiclient':
+        specifier: workspace:*
+        version: link:../../aiclient
+      debug:
+        specifier: ^4.4.0
+        version: 4.4.3(supports-color@8.1.1)
+      typechat:
+        specifier: ^0.1.1
+        version: 0.1.1(typescript@5.4.5)(zod@3.25.76)
+    devDependencies:
+      '@typeagent/action-schema-compiler':
+        specifier: workspace:*
+        version: link:../../actionSchemaCompiler
+      '@types/debug':
+        specifier: ^4.1.12
+        version: 4.1.13
+      '@types/jest':
+        specifier: ^29.5.7
+        version: 29.5.14
+      concurrently:
+        specifier: ^9.1.2
+        version: 9.1.2
+      jest:
+        specifier: ^29.7.0
+        version: 29.7.0(@types/node@26.1.1)(ts-node@10.9.2(@types/node@26.1.1)(typescript@5.4.5))
+      prettier:
+        specifier: ^3.5.3
+        version: 3.5.3
+      rimraf:
+        specifier: ^6.0.1
+        version: 6.0.1
+      typescript:
+        specifier: ~5.4.5
+        version: 5.4.5
+
   packages/agents/settings:
     dependencies:
       '@typeagent/agent-runtime':
@@ -4546,6 +4589,9 @@ importers:
       '@typeagent/screencapture-agent':
         specifier: workspace:*
         version: link:../agents/screencapture
+      '@typeagent/selfhelp-agent':
+        specifier: workspace:*
+        version: link:../agents/selfhelp
       '@typeagent/studio-agent':
         specifier: workspace:*
         version: link:../agents/studio
@@ -20049,7 +20095,7 @@ snapshots:
     dependencies:
       '@opentelemetry/api': 1.9.0
       '@opentelemetry/core': 2.8.0(@opentelemetry/api@1.9.0)
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       hpagent: 1.2.0
       ms: 2.1.3
       secure-json-parse: 4.1.0
@@ -20080,7 +20126,7 @@ snapshots:
 
   '@electron/get@2.0.3(supports-color@8.1.1)':
     dependencies:
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       env-paths: 2.2.1
       fs-extra: 8.1.0
       got: 11.8.6
@@ -20121,7 +20167,7 @@ snapshots:
       fs-extra: 10.1.0
       isbinaryfile: 4.0.10
       minimist: 1.2.8
-      plist: 3.1.0
+      plist: 3.1.1
     transitivePeerDependencies:
       - supports-color
 
@@ -20144,14 +20190,14 @@ snapshots:
       dir-compare: 4.2.0
       fs-extra: 11.3.6
       minimatch: 9.0.9
-      plist: 3.1.0
+      plist: 3.1.1
     transitivePeerDependencies:
       - supports-color
 
   '@electron/windows-sign@1.2.2(supports-color@8.1.1)':
     dependencies:
       cross-dirname: 0.1.0
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       fs-extra: 11.3.6
       minimist: 1.2.8
       postject: 1.0.0-alpha.6
@@ -22823,7 +22869,7 @@ snapshots:
       '@secretlint/resolver': 9.3.2
       '@secretlint/types': 9.3.2
       ajv: 8.20.0
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       rc-config-loader: 4.1.3
     transitivePeerDependencies:
       - supports-color
@@ -22832,7 +22878,7 @@ snapshots:
     dependencies:
       '@secretlint/profiler': 9.3.2
       '@secretlint/types': 9.3.2
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       structured-source: 4.0.0
     transitivePeerDependencies:
       - supports-color
@@ -22845,7 +22891,7 @@ snapshots:
       '@textlint/module-interop': 14.7.1
       '@textlint/types': 14.7.1
       chalk: 4.1.2
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       pluralize: 8.0.0
       strip-ansi: 6.0.1
       table: 6.9.0
@@ -22861,7 +22907,7 @@ snapshots:
       '@secretlint/profiler': 9.3.2
       '@secretlint/source-creator': 9.3.2
       '@secretlint/types': 9.3.2
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       p-map: 4.0.0
     transitivePeerDependencies:
       - supports-color
@@ -23290,7 +23336,7 @@ snapshots:
       '@textlint/resolver': 14.7.1
       '@textlint/types': 14.7.1
       chalk: 4.1.2
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       js-yaml: 3.15.0
       lodash: 4.18.1
       pluralize: 2.0.0
@@ -24690,8 +24736,7 @@ snapshots:
 
   '@xmldom/xmldom@0.8.13': {}
 
-  '@xmldom/xmldom@0.9.10':
-    optional: true
+  '@xmldom/xmldom@0.9.10': {}
 
   '@xtuc/ieee754@1.2.0': {}
 
@@ -25329,14 +25374,14 @@ snapshots:
 
   builder-util-runtime@9.3.1(supports-color@8.1.1):
     dependencies:
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       sax: 1.6.0
     transitivePeerDependencies:
       - supports-color
 
   builder-util-runtime@9.5.1:
     dependencies:
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       sax: 1.6.0
     transitivePeerDependencies:
       - supports-color
@@ -26719,7 +26764,7 @@ snapshots:
   electron-winstaller@5.4.0(supports-color@8.1.1):
     dependencies:
       '@electron/asar': 3.4.1
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       fs-extra: 7.0.1
       lodash: 4.18.1
       temp: 0.9.4
@@ -27362,7 +27407,7 @@ snapshots:
 
   extract-zip@2.0.1:
     dependencies:
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       get-stream: 5.2.0
       yauzl: 2.10.0
     optionalDependencies:
@@ -28216,7 +28261,7 @@ snapshots:
   https-proxy-agent@5.0.1(supports-color@8.1.1):
     dependencies:
       agent-base: 6.0.2(supports-color@8.1.1)
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
     transitivePeerDependencies:
       - supports-color
 
@@ -29284,7 +29329,7 @@ snapshots:
 
   jest-worker@27.5.1:
     dependencies:
-      '@types/node': 26.1.1
+      '@types/node': 22.20.1
       merge-stream: 2.0.0
       supports-color: 8.1.1
 
@@ -30393,8 +30438,8 @@ snapshots:
 
   micromark@4.0.2(supports-color@8.1.1):
     dependencies:
-      '@types/debug': 4.1.12
-      debug: 4.4.1(supports-color@8.1.1)
+      '@types/debug': 4.1.13
+      debug: 4.4.3(supports-color@8.1.1)
       decode-named-character-reference: 1.1.0
       devlop: 1.1.0
       micromark-core-commonmark: 2.0.3
@@ -30541,7 +30586,7 @@ snapshots:
     dependencies:
       browser-stdout: 1.3.1
       chokidar: 4.0.3
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       diff: 7.0.0
       escape-string-regexp: 4.0.0
       find-up: 5.0.0
@@ -30658,7 +30703,7 @@ snapshots:
 
   node-abi@4.33.0:
     dependencies:
-      semver: 7.7.4
+      semver: 7.8.5
 
   node-addon-api@1.7.2:
     optional: true
@@ -30669,7 +30714,7 @@ snapshots:
 
   node-api-version@0.2.1:
     dependencies:
-      semver: 7.7.4
+      semver: 7.8.5
 
   node-domexception@1.0.0: {}
 
@@ -30698,7 +30743,7 @@ snapshots:
       graceful-fs: 4.2.11
       nopt: 9.0.0
       proc-log: 6.1.0
-      semver: 7.7.4
+      semver: 7.8.5
       tar: 7.5.21
       tinyglobby: 0.2.17
       undici: 6.27.0
@@ -31235,7 +31280,6 @@ snapshots:
       '@xmldom/xmldom': 0.9.10
       base64-js: 1.5.1
       xmlbuilder: 15.1.1
-    optional: true
 
   pluralize@2.0.0: {}
 
@@ -31646,7 +31690,7 @@ snapshots:
 
   puppeteer-extra-plugin-user-data-dir@2.4.1(puppeteer-extra@3.3.6(puppeteer-core@24.37.5)(puppeteer@24.37.5(typescript@5.4.5))(supports-color@8.1.1))(supports-color@8.1.1):
     dependencies:
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       fs-extra: 10.1.0
       puppeteer-extra-plugin: 3.2.3(puppeteer-extra@3.3.6(puppeteer-core@24.37.5)(puppeteer@24.37.5(typescript@5.4.5))(supports-color@8.1.1))(supports-color@8.1.1)
       rimraf: 3.0.2
@@ -31657,7 +31701,7 @@ snapshots:
 
   puppeteer-extra-plugin-user-data-dir@2.4.1(puppeteer-extra@3.3.6(puppeteer-core@24.37.5)(puppeteer@24.37.5(typescript@5.4.5))):
     dependencies:
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       fs-extra: 10.1.0
       puppeteer-extra-plugin: 3.2.3(puppeteer-extra@3.3.6(puppeteer-core@24.37.5)(puppeteer@24.37.5(typescript@5.4.5)))
       rimraf: 3.0.2
@@ -31668,7 +31712,7 @@ snapshots:
 
   puppeteer-extra-plugin-user-preferences@2.4.1(puppeteer-extra@3.3.6(puppeteer-core@24.37.5)(puppeteer@24.37.5(typescript@5.4.5))(supports-color@8.1.1))(supports-color@8.1.1):
     dependencies:
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       deepmerge: 4.3.1
       puppeteer-extra-plugin: 3.2.3(puppeteer-extra@3.3.6(puppeteer-core@24.37.5)(puppeteer@24.37.5(typescript@5.4.5))(supports-color@8.1.1))(supports-color@8.1.1)
       puppeteer-extra-plugin-user-data-dir: 2.4.1(puppeteer-extra@3.3.6(puppeteer-core@24.37.5)(puppeteer@24.37.5(typescript@5.4.5))(supports-color@8.1.1))(supports-color@8.1.1)
@@ -31679,7 +31723,7 @@ snapshots:
 
   puppeteer-extra-plugin-user-preferences@2.4.1(puppeteer-extra@3.3.6(puppeteer-core@24.37.5)(puppeteer@24.37.5(typescript@5.4.5))):
     dependencies:
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       deepmerge: 4.3.1
       puppeteer-extra-plugin: 3.2.3(puppeteer-extra@3.3.6(puppeteer-core@24.37.5)(puppeteer@24.37.5(typescript@5.4.5)))
       puppeteer-extra-plugin-user-data-dir: 2.4.1(puppeteer-extra@3.3.6(puppeteer-core@24.37.5)(puppeteer@24.37.5(typescript@5.4.5)))
@@ -31690,8 +31734,8 @@ snapshots:
 
   puppeteer-extra-plugin@3.2.3(puppeteer-extra@3.3.6(puppeteer-core@24.37.5)(puppeteer@24.37.5(typescript@5.4.5))(supports-color@8.1.1))(supports-color@8.1.1):
     dependencies:
-      '@types/debug': 4.1.12
-      debug: 4.4.1(supports-color@8.1.1)
+      '@types/debug': 4.1.13
+      debug: 4.4.3(supports-color@8.1.1)
       merge-deep: 3.0.3
     optionalDependencies:
       puppeteer-extra: 3.3.6(puppeteer-core@24.37.5)(puppeteer@24.37.5(typescript@5.4.5))(supports-color@8.1.1)
@@ -31700,8 +31744,8 @@ snapshots:
 
   puppeteer-extra-plugin@3.2.3(puppeteer-extra@3.3.6(puppeteer-core@24.37.5)(puppeteer@24.37.5(typescript@5.4.5))):
     dependencies:
-      '@types/debug': 4.1.12
-      debug: 4.4.1(supports-color@8.1.1)
+      '@types/debug': 4.1.13
+      debug: 4.4.3(supports-color@8.1.1)
       merge-deep: 3.0.3
     optionalDependencies:
       puppeteer-extra: 3.3.6(puppeteer-core@24.37.5)(puppeteer@24.37.5(typescript@5.4.5))(supports-color@8.1.1)
@@ -31781,7 +31825,7 @@ snapshots:
 
   rc-config-loader@4.1.3:
     dependencies:
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       js-yaml: 4.3.0
       json5: 2.2.3
       require-from-string: 2.0.2
@@ -32232,7 +32276,7 @@ snapshots:
       '@secretlint/formatter': 9.3.2
       '@secretlint/node': 9.3.2
       '@secretlint/profiler': 9.3.2
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       globby: 14.1.0
       read-pkg: 8.1.0
     transitivePeerDependencies:
@@ -32697,7 +32741,7 @@ snapshots:
 
   spdy-transport@3.0.0(supports-color@8.1.1):
     dependencies:
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       detect-node: 2.1.0
       hpack.js: 2.1.6
       obuf: 1.1.2
@@ -32708,7 +32752,7 @@ snapshots:
 
   spdy@4.0.2(supports-color@8.1.1):
     dependencies:
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
       handle-thing: 2.0.1
       http-deceiver: 1.2.7
       select-hose: 2.0.0
@@ -32895,7 +32939,7 @@ snapshots:
 
   sumchecker@3.0.1(supports-color@8.1.1):
     dependencies:
-      debug: 4.4.1(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@8.1.1)
     transitivePeerDependencies:
       - supports-color
 
diff --git a/ts/tools/actionBrowser/README.md b/ts/tools/actionBrowser/README.md
index 11655b26d6..dd7db768eb 100644
--- a/ts/tools/actionBrowser/README.md
+++ b/ts/tools/actionBrowser/README.md
@@ -1,6 +1,6 @@
 # @typeagent/action-browser
 
-Static generator for the TypeAgent Action Browser — a self-contained, interactive HTML catalog of every agent action, parameter, example phrasing, and system command. Produced as part of the documentation build.
+Static generator for the TypeAgent Action Browser — a self-contained, interactive HTML catalog of every agent action, parameter, example phrasing, and `@`-command. Produced as part of the documentation build.
 
 ## Trademarks
 
diff --git a/ts/tools/actionBrowser/package.json b/ts/tools/actionBrowser/package.json
index 2039c17e5f..28a7baba2f 100644
--- a/ts/tools/actionBrowser/package.json
+++ b/ts/tools/actionBrowser/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@typeagent/action-browser",
   "version": "0.0.1",
-  "description": "Static generator for the TypeAgent Action Browser — a self-contained, interactive HTML catalog of every agent action, parameter, example phrasing, and system command. Produced as part of the documentation build.",
+  "description": "Static generator for the TypeAgent Action Browser — a self-contained, interactive HTML catalog of every agent action, parameter, example phrasing, and @-command. Produced as part of the documentation build.",
   "homepage": "https://github.com/microsoft/TypeAgent#readme",
   "repository": {
     "type": "git",
diff --git a/ts/tools/actionBrowser/src/cli.ts b/ts/tools/actionBrowser/src/cli.ts
index 74170fe5b5..6e51cd2c42 100644
--- a/ts/tools/actionBrowser/src/cli.ts
+++ b/ts/tools/actionBrowser/src/cli.ts
@@ -21,10 +21,10 @@ Options:
   --json         Also write the raw catalog JSON next to the HTML output.
   --help         Show this message.
 
-The generator is fully static: it reads bundled agent manifests, action
-schemas, and grammar files from the workspace (no running dispatcher, no
-network, no LLM). Dynamic runtime capabilities (MCP tools, recorded web
-flows) are out of scope.
+The generator reads bundled agent manifests, action schemas, and grammar
+files from the workspace, and boots a headless read-only dispatcher to
+enumerate each host's @-commands (no network, no LLM, no API keys). Dynamic
+runtime capabilities (MCP tools, recorded web flows) are out of scope.
 `;
 
 function defaultOutPath(): string {
@@ -75,7 +75,7 @@ async function main(): Promise<void> {
     process.stdout.write(
         `Action browser: ${catalog.counts.agents} agents, ` +
             `${catalog.counts.actions} actions, ` +
-            `${catalog.counts.commands} system commands\n`,
+            `${catalog.counts.commands} commands\n`,
     );
     process.stdout.write(`wrote ${outPath}\n`);
 }
diff --git a/ts/tools/actionBrowser/src/collect.ts b/ts/tools/actionBrowser/src/collect.ts
index 94517eb4eb..5ffbf9e952 100644
--- a/ts/tools/actionBrowser/src/collect.ts
+++ b/ts/tools/actionBrowser/src/collect.ts
@@ -11,7 +11,7 @@ import type { ActionSchemaTypeDefinition } from "@typeagent/action-schema";
 import type { AppAgentManifest, GrammarContent } from "@typeagent/agent-sdk";
 import { extractParams } from "./paramTypes.js";
 import { extractPhrasings, extractCompiledPhrasings } from "./phrasings.js";
-import { collectSystemCommands } from "./systemCommands.js";
+import { collectCommands } from "./commands.js";
 import { categoryForAgent } from "./categories.js";
 import { joinComments } from "./util.js";
 import type { ActionInfo, AgentInfo, Catalog, SchemaInfo } from "./types.js";
@@ -19,11 +19,12 @@ import type { ActionInfo, AgentInfo, Catalog, SchemaInfo } from "./types.js";
 /**
  * Collect the full capability catalog from the workspace's bundled agents.
  *
- * This is a purely static enumeration — it reads agent manifests, action
- * schemas, and grammar files from disk (no running dispatcher, no network,
- * no LLM). Dynamic, runtime-only capabilities (MCP tools, recorded web flows)
- * are intentionally out of scope so the catalog can be generated during the
- * documentation build.
+ * Agents, action schemas, and grammar-derived phrasings are read statically
+ * from disk. Commands are enumerated by booting a headless, read-only
+ * dispatcher (no network, no LLM, no API keys) so each host's `@command` table
+ * is captured the way it is assembled at runtime. Dynamic, runtime-only
+ * capabilities (MCP tools, recorded web flows) are intentionally out of scope
+ * so the catalog stays reproducible for the documentation build.
  */
 export async function collectCatalog(): Promise<Catalog> {
     // `undefined` builds only the static bundled-agent provider (no instance
@@ -90,16 +91,16 @@ export async function collectCatalog(): Promise<Catalog> {
         });
     }
 
-    const systemCommands = collectSystemCommands();
+    const commands = await collectCommands();
 
     return {
         generatedAt: new Date().toISOString(),
         agents,
-        systemCommands,
+        commands,
         counts: {
             agents: agents.length,
             actions: actionCount,
-            commands: systemCommands.length,
+            commands: commands.length,
         },
     };
 }
diff --git a/ts/tools/actionBrowser/src/commands.ts b/ts/tools/actionBrowser/src/commands.ts
new file mode 100644
index 0000000000..d5a94e7886
--- /dev/null
+++ b/ts/tools/actionBrowser/src/commands.ts
@@ -0,0 +1,211 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+import {
+    initializeCommandHandlerContext,
+    closeCommandHandlerContext,
+    type CommandHandlerContext,
+} from "agent-dispatcher/internal";
+import { getDefaultAppAgentProviders } from "default-agent-provider";
+import type {
+    CommandActionLink,
+    CommandArg,
+    CommandFlag,
+    CommandInfo,
+} from "./types.js";
+
+// Command descriptor tables are walked structurally: each node may carry a
+// `description`, a `commands` map of sub-handlers, a `defaultSubCommand` (an
+// inline descriptor or a string reference), and a `parameters` block with
+// `args` / `flags`. We only read those fields, so a loose shape keeps this
+// decoupled from the agent-sdk's descriptor types.
+interface HandlerNode {
+    description?: unknown;
+    commands?: Record<string, HandlerNode> | undefined;
+    defaultSubCommand?: HandlerNode | string | undefined;
+    action?: string | { schema?: unknown; actionName?: unknown } | undefined;
+    parameters?:
+        | {
+              args?: Record<string, ParameterDef> | undefined;
+              flags?: Record<string, ParameterDef> | undefined;
+          }
+        | undefined;
+}
+
+interface ParameterDef {
+    type?: unknown;
+    optional?: unknown;
+    description?: unknown;
+    char?: unknown;
+    default?: unknown;
+}
+
+/**
+ * Enumerate every bundled agent's `@command` tree, tagged by host.
+ *
+ * The unprefixed commands (`@config`, `@session`, …) are hosted by the built-in
+ * "system" agent; every other agent hosts its own prefixed commands
+ * (`@dispatcher reason`). Unlike the rest of the catalog this boots a headless,
+ * read-only dispatcher (no API keys; translation, explanation, and caching are
+ * off) so agents that assemble their command tables at runtime are enumerated
+ * the same way the command-reference doc generator does. Best-effort: any
+ * failure yields an empty list so the rest of the catalog still generates.
+ */
+export async function collectCommands(): Promise<CommandInfo[]> {
+    let context: CommandHandlerContext;
+    try {
+        context = await initializeCommandHandlerContext("action-browser", {
+            appAgentProviders: getDefaultAppAgentProviders(undefined),
+            agents: { actions: false, schemas: false, commands: true },
+            translation: { enabled: false },
+            explainer: { enabled: false },
+            cache: { enabled: false },
+        });
+    } catch {
+        return [];
+    }
+
+    const out: CommandInfo[] = [];
+    try {
+        const agents = context.agents;
+        for (const host of agents.getAppAgentNames()) {
+            if (!agents.isCommandEnabled(host)) {
+                continue;
+            }
+            const appAgent = agents.getAppAgent(host);
+            if (appAgent.getCommands === undefined) {
+                continue;
+            }
+            let commands: HandlerNode;
+            try {
+                commands = (await appAgent.getCommands(
+                    agents.getSessionContext(host),
+                )) as unknown as HandlerNode;
+            } catch {
+                continue;
+            }
+            collectHostCommands(host, commands, out);
+        }
+    } finally {
+        await closeCommandHandlerContext(context);
+    }
+
+    return out.sort(
+        (a, b) => a.host.localeCompare(b.host) || a.path.localeCompare(b.path),
+    );
+}
+
+// A host either exposes a table of sub-commands (walked recursively) or a
+// single top-level command invoked as bare `@<host>` (path left empty).
+function collectHostCommands(
+    host: string,
+    node: HandlerNode,
+    out: CommandInfo[],
+): void {
+    if (node.commands !== undefined && typeof node.commands === "object") {
+        walk(host, node, [], out);
+    } else {
+        const action = normalizeActionLink(node.action);
+        out.push({
+            host,
+            path: "",
+            description:
+                typeof node.description === "string" ? node.description : "",
+            group: false,
+            args: extractArgs(node.parameters),
+            flags: extractFlags(node.parameters),
+            ...(action ? { action } : {}),
+        });
+    }
+}
+
+function walk(
+    host: string,
+    node: HandlerNode,
+    pathParts: string[],
+    out: CommandInfo[],
+): void {
+    const commands = node.commands;
+    if (commands === undefined || typeof commands !== "object") {
+        return;
+    }
+    for (const [name, child] of Object.entries(commands)) {
+        if (child === null || typeof child !== "object") {
+            continue;
+        }
+        const currentPath = [...pathParts, name];
+        const hasSub =
+            child.commands !== undefined &&
+            Object.keys(child.commands).length > 0;
+        // A string `defaultSubCommand` references another entry that the loop
+        // renders on its own; only an inline descriptor contributes parameters.
+        const defaultSub =
+            typeof child.defaultSubCommand === "object"
+                ? child.defaultSubCommand
+                : undefined;
+        const params = child.parameters ?? defaultSub?.parameters;
+        const action = normalizeActionLink(child.action);
+        out.push({
+            host,
+            path: currentPath.join(" "),
+            description:
+                typeof child.description === "string" ? child.description : "",
+            group: hasSub,
+            args: extractArgs(params),
+            flags: extractFlags(params),
+            ...(action ? { action } : {}),
+        });
+        if (hasSub) {
+            walk(host, child, currentPath, out);
+        }
+    }
+}
+
+// Normalize a handler's declared `action` (a bare actionName or a
+// {schema, actionName} pair) into the catalog's link shape.
+function normalizeActionLink(
+    action: HandlerNode["action"],
+): CommandActionLink | undefined {
+    if (typeof action === "string") {
+        return action ? { actionName: action } : undefined;
+    }
+    if (
+        action !== null &&
+        typeof action === "object" &&
+        typeof action.actionName === "string"
+    ) {
+        return typeof action.schema === "string"
+            ? { schema: action.schema, actionName: action.actionName }
+            : { actionName: action.actionName };
+    }
+    return undefined;
+}
+
+function extractArgs(params: HandlerNode["parameters"]): CommandArg[] {
+    const args = params?.args;
+    if (args === undefined) {
+        return [];
+    }
+    return Object.entries(args).map(([name, def]) => ({
+        name,
+        type: typeof def?.type === "string" ? def.type : "string",
+        optional: def?.optional === true,
+        description:
+            typeof def?.description === "string" ? def.description : "",
+    }));
+}
+
+function extractFlags(params: HandlerNode["parameters"]): CommandFlag[] {
+    const flags = params?.flags;
+    if (flags === undefined) {
+        return [];
+    }
+    return Object.entries(flags).map(([name, def]) => ({
+        name,
+        char: typeof def?.char === "string" ? def.char : "",
+        type: typeof def?.type === "string" ? def.type : "string",
+        default: def?.default === undefined ? "" : String(def.default),
+        description:
+            typeof def?.description === "string" ? def.description : "",
+    }));
+}
diff --git a/ts/tools/actionBrowser/src/render.ts b/ts/tools/actionBrowser/src/render.ts
index 6130f4129c..9f6d2b2ffe 100644
--- a/ts/tools/actionBrowser/src/render.ts
+++ b/ts/tools/actionBrowser/src/render.ts
@@ -1,7 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
 
-import type { Catalog } from "./types.js";
+import type { Catalog, CommandInfo } from "./types.js";
 import { orderedCategories } from "./categories.js";
 import { escapeHtml } from "./util.js";
 
@@ -10,14 +10,21 @@ import { escapeHtml } from "./util.js";
 //
 // The browser is a zoomable treemap over two hierarchies:
 //   Agents:   Category -> Agent -> Action (leaf)
-//   Commands: Group    -> Command (leaf)
+//   Commands: Host     -> Group -> Command (leaf)
 // We build plain data objects here and embed them as JSON; the client renders
 // and lays them out (a viewport-aware squarified treemap), so nothing here
 // depends on a DOM.
 // ---------------------------------------------------------------------------
 
 interface TreeNode {
-    kind: "root" | "category" | "agent" | "action" | "group" | "command";
+    kind:
+        | "root"
+        | "category"
+        | "agent"
+        | "action"
+        | "host"
+        | "group"
+        | "command";
     name: string;
     emoji?: string;
     description?: string;
@@ -34,7 +41,11 @@ interface TreeNode {
     }[];
     phrasings?: string[];
     // command-only
-    group?: boolean;
+    host?: string;
+    // Full invocation path minus the leading `@` (e.g. `config agent enable`).
+    full?: string;
+    // actionName of the equivalent agent action, when the handler declares one.
+    actionName?: string;
     args?: { name: string; optional: boolean; description: string }[];
     flags?: {
         name: string;
@@ -91,41 +102,114 @@ function buildAgentsTree(catalog: Catalog): TreeNode {
     return { kind: "root", name: "Agents", children };
 }
 
+// Order hosts so the layout is stable and readable: the built-in "system" host
+// leads, then every agent host alphabetically.
+function hostRank(host: string): number {
+    return host === "system" ? 0 : 1;
+}
+
+// Full invocation path (minus the leading `@`) for a command: system commands
+// stand alone (`config agent`); an agent's commands are prefixed with the host
+// (`dispatcher reason`), collapsing to just the host for a bare `@<host>`.
+function commandDisplayPath(host: string, path: string): string {
+    if (host === "system") {
+        return path;
+    }
+    return path ? `${host} ${path}` : host;
+}
+
 function buildCommandsTree(catalog: Catalog): TreeNode {
-    const groups = new Map<string, TreeNode[]>();
-    for (const command of catalog.systemCommands) {
-        const first = command.path.split(" ")[0] || command.path;
-        let list = groups.get(first);
+    // Group by host, then expand each host's flat command list into a deep tree
+    // keyed by the command path so `config` -> `agent` -> `enable` become
+    // nested, zoomable boxes instead of one flat wall of commands.
+    const byHost = new Map<string, CommandInfo[]>();
+    for (const command of catalog.commands) {
+        let list = byHost.get(command.host);
         if (list === undefined) {
             list = [];
-            groups.set(first, list);
+            byHost.set(command.host, list);
         }
-        list.push({
-            kind: "command",
-            name: command.path,
-            description: command.description,
-            group: command.group,
-            args: command.args.map((a) => ({
-                name: a.name,
-                optional: a.optional,
-                description: a.description,
-            })),
-            flags: command.flags.map((f) => ({
-                name: f.name,
-                char: f.char,
-                default: f.default,
-                description: f.description,
-            })),
-        });
+        list.push(command);
     }
-    const children: TreeNode[] = [...groups.entries()]
-        .sort((a, b) => a[0].localeCompare(b[0]))
-        .map(([name, commands]) => ({
-            kind: "group" as const,
-            name,
-            children: commands.sort((a, b) => a.name.localeCompare(b.name)),
+    const children = [...byHost.entries()]
+        .sort(
+            (a, b) =>
+                hostRank(a[0]) - hostRank(b[0]) || a[0].localeCompare(b[0]),
+        )
+        .map(([host, commands]) => buildHostTree(host, commands));
+    return { kind: "root", name: "Commands", children };
+}
+
+// Expand one host's commands into a nested tree. Each path segment becomes a
+// node; a node that ends up with sub-commands is a zoomable group, otherwise a
+// leaf command. The dispatcher also emits every intermediate node, so a group's
+// own description/parameters land on the matching node.
+function buildHostTree(host: string, commands: CommandInfo[]): TreeNode {
+    const hostNode: TreeNode = { kind: "host", name: host, children: [] };
+    const nodeByKey = new Map<string, TreeNode>([["", hostNode]]);
+
+    function ensureNode(segments: string[]): TreeNode {
+        if (segments.length === 0) {
+            return hostNode;
+        }
+        const key = segments.join("\n");
+        let node = nodeByKey.get(key);
+        if (node === undefined) {
+            node = {
+                kind: "command",
+                name: segments[segments.length - 1],
+                host,
+                full: commandDisplayPath(host, segments.join(" ")),
+                children: [],
+            };
+            nodeByKey.set(key, node);
+            ensureNode(segments.slice(0, -1)).children!.push(node);
+        }
+        return node;
+    }
+
+    for (const command of commands) {
+        // A bare `@<host>` command (no sub-path) becomes a single leaf named
+        // for the host.
+        const segments = command.path === "" ? [host] : command.path.split(" ");
+        const node = ensureNode(segments);
+        node.host = host;
+        node.full = commandDisplayPath(host, command.path);
+        if (command.action) {
+            node.actionName = command.action.actionName;
+        }
+        node.description = command.description;
+        node.args = command.args.map((a) => ({
+            name: a.name,
+            optional: a.optional,
+            description: a.description,
+        }));
+        node.flags = command.flags.map((f) => ({
+            name: f.name,
+            char: f.char,
+            default: f.default,
+            description: f.description,
         }));
-    return { kind: "root", name: "System commands", children };
+    }
+
+    // A node with children is a group; one without is a leaf command.
+    function finalize(node: TreeNode): void {
+        const kids = node.children;
+        if (kids !== undefined && kids.length > 0) {
+            if (node.kind !== "host") {
+                node.kind = "group";
+            }
+            kids.sort((a, b) => a.name.localeCompare(b.name));
+            kids.forEach(finalize);
+        } else {
+            if (node.kind !== "host") {
+                node.kind = "command";
+            }
+            delete node.children;
+        }
+    }
+    finalize(hostNode);
+    return hostNode;
 }
 
 // ---------------------------------------------------------------------------
@@ -169,7 +253,9 @@ h1{margin:0;font-size:17px;}
 .cell.k-action,.cell.k-command{cursor:pointer;}
 .lbl{position:absolute;inset:0;padding:10px 12px;display:flex;flex-direction:column;gap:3px;
   justify-content:flex-start;color:#fff;text-shadow:0 1px 3px rgba(0,0,0,.6);pointer-events:none;}
-.lbl-name{font-weight:650;line-height:1.15;word-break:break-word;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden;}
+/* line-height leaves room for emoji glyphs (taller than text); flex-shrink:0 keeps the
+   name at full line height on short tiles instead of squashing and clipping the glyphs. */
+.lbl-name{font-weight:650;line-height:1.3;flex-shrink:0;word-break:break-word;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden;}
 .lbl-sub{opacity:.85;font-weight:500;}
 .cell.sm .lbl{padding:4px 6px;gap:1px;}
 .cell.tiny .lbl{display:none;}
@@ -205,6 +291,14 @@ h1{margin:0;font-size:17px;}
 .p-list{margin:0;padding-left:18px;}
 .p-list li{margin:3px 0;}
 .p-list code{background:#0c111b;padding:1px 5px;border-radius:5px;}
+/* cross-links between a command and its equivalent action */
+.p-xlink{display:flex;align-items:center;flex-wrap:wrap;gap:8px;margin:0 0 12px;}
+.p-xlabel{font-size:11px;text-transform:uppercase;letter-spacing:.05em;color:var(--muted);}
+.p-link{appearance:none;border:1px solid var(--line);background:var(--chip);color:var(--chip-fg);font-family:ui-monospace,Consolas,monospace;font-size:13px;padding:3px 10px;border-radius:999px;cursor:pointer;}
+.p-link:hover{border-color:var(--accent);}
+.p-xnote{color:var(--muted);font-family:ui-monospace,Consolas,monospace;font-size:13px;}
+.cov-chip{margin-left:auto;font-size:12px;color:var(--muted);white-space:nowrap;align-self:center;}
+.cell.linked::after{content:'\\21c4';position:absolute;top:4px;right:6px;font-size:11px;color:#fff;opacity:.75;pointer-events:none;text-shadow:0 1px 2px rgba(0,0,0,.6);}
 /* nested containers (root view: agents shown inside their category) */
 .cell.container{cursor:pointer;}
 .cell .lbl.hdr{position:absolute;left:0;right:0;top:0;bottom:auto;height:auto;flex-direction:row;flex-wrap:nowrap;align-items:baseline;gap:8px;padding:5px 11px;overflow:hidden;}
@@ -281,6 +375,15 @@ const APP = `
   computeValue(DATA.agents); computeValue(DATA.commands);
   assignHues(DATA.agents); assignHues(DATA.commands);
 
+  // Cross-reference actions with the commands declared equivalent to them, and
+  // tally how many commands carry a natural-language action.
+  var actionIndex={}, commandsForAction={}, commandLeafCount=0, commandLinkedCount=0;
+  (function walk(n){ if(n.kind==='action'){ actionIndex[n.agent+'\\n'+n.name]=n; } if(n.children) n.children.forEach(walk); })(DATA.agents);
+  (function walk(n){
+    if(n.kind==='command'){ commandLeafCount++; if(n.actionName){ commandLinkedCount++; var k=n.host+'\\n'+n.actionName; (commandsForAction[k]||(commandsForAction[k]=[])).push(n); } }
+    if(n.children) n.children.forEach(walk);
+  })(DATA.commands);
+
   var state = { mode:'agents', path:[DATA.agents], query:'' };
 
   function currentNode(){ return state.path[state.path.length-1]; }
@@ -288,7 +391,7 @@ const APP = `
   function colorFor(node, idx, n){
     var h = node._hue==null?210:node._hue;
     var sat = (node.kind==='action'||node.kind==='command')?40:58;
-    var base = (node.kind==='category'||node.kind==='group')?42:(node.kind==='agent')?52:66;
+    var base = (node.kind==='category'||node.kind==='host')?42:(node.kind==='agent'||node.kind==='group')?52:66;
     var jitter = n>1 ? ((idx/(n-1))-0.5)*12 : 0;
     return 'hsl('+h+','+sat+'%,'+(base+jitter)+'%)';
   }
@@ -330,15 +433,20 @@ const APP = `
   }
 
   function displayName(node){
-    if(node.kind==='command') return '@'+node.name;
+    if(node.kind==='command' || node.kind==='group'){
+      // Browsing shows the path segment (the breadcrumb carries the context);
+      // search shows the full '@command' since results have no breadcrumb.
+      return (state.query && node.full) ? '@'+node.full : node.name;
+    }
     if(node.kind==='action' && state.query && node.agent) return node.agent+' · '+node.name;
     return (node.emoji?node.emoji+' ':'')+node.name;
   }
   function subLabel(node){
     var c = node.children?node.children.length:0;
     if(node.kind==='category') return c+(c===1?' agent':' agents');
+    if(node.kind==='host'){ var n=node._value||c; return n+(n===1?' command':' commands'); }
     if(node.kind==='agent') return c+(c===1?' action':' actions');
-    if(node.kind==='group') return c+(c===1?' command':' commands');
+    if(node.kind==='group'){ var g=node._value||c; return g+(g===1?' command':' commands'); }
     return '';
   }
 
@@ -359,7 +467,7 @@ const APP = `
   function buildCell(c, role, idx, n){
     var node=c.node;
     var el=document.createElement('div');
-    el.className='cell '+role+' k-'+node.kind;
+    el.className='cell '+role+' k-'+node.kind+(node.actionName?' linked':'');
     el._layout=c;
     if(role==='container'){
       var h=node._hue==null?210:node._hue;
@@ -380,7 +488,8 @@ const APP = `
     var nameHtml='<span class="lbl-name" style="font-size:'+Math.round(sz.name)+'px">'+esc(displayName(node))+'</span>';
     var subHtml=(sub && sz.showSub)?'<span class="lbl-sub" style="font-size:'+Math.round(sz.sub)+'px">'+esc(sub)+'</span>':'';
     el.innerHTML='<div class="'+lblCls+'">'+nameHtml+subHtml+'</div>';
-    var t = node.kind==='action'&&node.agent ? node.agent+' · '+node.name : displayName(node);
+    var t = node.kind==='action'&&node.agent ? node.agent+' · '+node.name
+      : (node.full ? '@'+node.full : displayName(node));
     el.title = t + (node.description?' — '+node.description:'');
     if(role==='tile'){
       if(vertical){ el.classList.add('vert'); }
@@ -394,10 +503,10 @@ const APP = `
   }
 
   function onCellClick(node, el){
-    // Agents and command groups open a details dialog (a treemap of their
-    // actions/commands would be meaningless without usage data); categories
-    // zoom in; leaves (reached via search) open the side panel.
-    if(node.kind==='agent' || node.kind==='group'){ openActionsDialog(node); return; }
+    // Agents open a details dialog (their actions have no sub-structure to zoom
+    // into). Categories, command hosts, and command groups zoom in; leaves
+    // open the side panel.
+    if(node.kind==='agent'){ openActionsDialog(node); return; }
     if(node.children && node.children.length){
       var r=el._layout;
       state.path.push(node);
@@ -439,10 +548,13 @@ const APP = `
       e.textContent = state.query ? 'No matches for “'+state.query+'”.' : 'Nothing to show here.';
       mapEl.appendChild(e); renderBreadcrumb(); return;
     }
-    // At the top level (agents mode), promote agents: draw each category as a
-    // labelled container with its agent tiles nested inside (one level deep).
-    var nested = !state.query && state.path.length===1 && state.mode==='agents';
-    var HEADER=26, PAD=7;
+    // At the top level, promote the top grouping (categories in agents mode,
+    // hosts in commands mode): draw each as a labelled container with its
+    // child tiles nested inside (one level deep).
+    var nested = !state.query && state.path.length===1;
+    // HEADER must clear the container's rendered header label (~33px at the largest
+    // font/line-height) so the first row of nested tiles isn't drawn under it.
+    var HEADER=36, PAD=7;
     var top=squarify(kids.map(function(k){return {node:k,value:sizeValue(k._value||1)};}),0,0,W,H);
     var pending=[];
     function add(el,c){ startPlace(el,c,fromRect,W,H); pending.push({el:el,c:c}); }
@@ -479,10 +591,15 @@ const APP = `
       if(i<state.path.length-1 || state.query){ var s=document.createElement('span'); s.className='crumb-sep'; s.textContent='›'; crumbEl.appendChild(s); }
     });
     if(state.query){ var r=document.createElement('span'); r.className='crumb crumb-static'; r.textContent='Results: “'+state.query+'”'; crumbEl.appendChild(r); }
+    if(state.mode==='commands' && !state.query){
+      var cov=document.createElement('span'); cov.className='cov-chip';
+      cov.textContent=commandLinkedCount+' / '+commandLeafCount+' commands have an action';
+      crumbEl.appendChild(cov);
+    }
   }
 
   function buildHay(node){
-    var parts=[node.name, node.description||'', node.agent||''];
+    var parts=[node.name, node.full||'', node.description||'', node.agent||''];
     if(node.parameters) node.parameters.forEach(function(p){parts.push(p.name,p.description||'');});
     if(node.phrasings) parts=parts.concat(node.phrasings);
     if(node.args) node.args.forEach(function(a){parts.push(a.name,a.description||'');});
@@ -567,11 +684,35 @@ const APP = `
     return html;
   }
 
+  // Cross-link chips between a command and its equivalent action. Targets are
+  // stashed by index because the panel body is set via innerHTML.
+  var panelLinkTargets=[];
+  function panelLinkChip(node){
+    var i=panelLinkTargets.push(node)-1;
+    var label=node.kind==='command'?'@'+(node.full||node.name):node.name;
+    return '<button class="p-link" data-link="'+i+'">'+esc(label)+'</button>';
+  }
+  function crossLinkHtml(node){
+    if(node.kind==='command' && node.actionName){
+      var a=actionIndex[node.host+'\\n'+node.actionName];
+      return '<div class="p-xlink"><span class="p-xlabel">Same as action</span>'+(a?panelLinkChip(a):'<span class="p-xnote">'+esc(node.actionName)+'</span>')+'</div>';
+    }
+    if(node.kind==='action'){
+      var cs=commandsForAction[node.agent+'\\n'+node.name];
+      if(cs&&cs.length){
+        var chips=''; for(var i=0;i<cs.length;i++){ chips+=panelLinkChip(cs[i]); }
+        return '<div class="p-xlink"><span class="p-xlabel">Same as command'+(cs.length>1?'s':'')+'</span>'+chips+'</div>';
+      }
+    }
+    return '';
+  }
+
   function openPanel(node){
     if(node.kind!=='action' && node.kind!=='command') return;
-    var kicker = node.kind==='action' ? esc(node.agent||'')+' · '+esc(node.schema||'') : 'system command';
-    var title = node.kind==='command' ? '@'+esc(node.name) : esc(node.name);
-    document.getElementById('panelBody').innerHTML='<div class="p-kicker">'+kicker+'</div><h2 class="p-title">'+title+'</h2>'+detailHtml(node);
+    panelLinkTargets=[];
+    var kicker = node.kind==='action' ? esc(node.agent||'')+' · '+esc(node.schema||'') : esc(node.host||'system')+' command';
+    var title = node.kind==='command' ? '@'+esc(node.full||node.name) : esc(node.name);
+    document.getElementById('panelBody').innerHTML='<div class="p-kicker">'+kicker+'</div><h2 class="p-title">'+title+'</h2>'+crossLinkHtml(node)+detailHtml(node);
     document.getElementById('panel').classList.add('open');
     document.getElementById('backdrop').classList.add('show');
   }
@@ -653,6 +794,10 @@ const APP = `
 
   document.getElementById('panelClose').addEventListener('click', closePanel);
   document.getElementById('backdrop').addEventListener('click', closePanel);
+  document.getElementById('panelBody').addEventListener('click', function(ev){
+    var b=ev.target.closest?ev.target.closest('.p-link[data-link]'):null;
+    if(b){ var t=panelLinkTargets[+b.getAttribute('data-link')]; if(t) openPanel(t); }
+  });
 
   // actions dialog wiring
   document.getElementById('dlgClose').addEventListener('click', closeDialog);
@@ -728,12 +873,12 @@ export function renderHtml(catalog: Catalog): string {
         "<header>",
         '<div class="titlebar">',
         "<h1>🧭 TypeAgent Action Browser</h1>",
-        `<span class="meta">${counts.agents} agents · ${counts.actions} actions · ${counts.commands} system commands · generated ${generated}</span>`,
+        `<span class="meta">${counts.agents} agents · ${counts.actions} actions · ${counts.commands} commands · generated ${generated}</span>`,
         "</div>",
         '<div class="controls">',
         '<div class="tabs">',
         '<button class="tab active" data-mode="agents">Agents</button>',
-        '<button class="tab" data-mode="commands">System commands</button>',
+        '<button class="tab" data-mode="commands">Commands</button>',
         "</div>",
         '<nav id="breadcrumb" class="breadcrumb"></nav>',
         '<input id="q" class="search" type="search" autocomplete="off" placeholder="Search actions, parameters, phrasings…" />',
diff --git a/ts/tools/actionBrowser/src/systemCommands.ts b/ts/tools/actionBrowser/src/systemCommands.ts
deleted file mode 100644
index ef8034f722..0000000000
--- a/ts/tools/actionBrowser/src/systemCommands.ts
+++ /dev/null
@@ -1,105 +0,0 @@
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT License.
-
-import { systemHandlers } from "agent-dispatcher/internal";
-import type { CommandArg, CommandFlag, CommandInfo } from "./types.js";
-
-// The command handler tables are walked structurally: each node may carry a
-// `description`, a `commands` map of sub-handlers, a `defaultSubCommand`, and a
-// `parameters` block with `args` / `flags`. We only read those fields, so a
-// loose shape keeps this decoupled from the dispatcher's internal handler types.
-interface HandlerNode {
-    description?: unknown;
-    commands?: Record<string, HandlerNode> | undefined;
-    defaultSubCommand?: HandlerNode | undefined;
-    parameters?:
-        | {
-              args?: Record<string, ParameterDef> | undefined;
-              flags?: Record<string, ParameterDef> | undefined;
-          }
-        | undefined;
-}
-
-interface ParameterDef {
-    type?: unknown;
-    optional?: unknown;
-    description?: unknown;
-    char?: unknown;
-    default?: unknown;
-}
-
-/**
- * Enumerate the TypeAgent system `@command` tree (help, config, session, …)
- * into a flat, sorted list. Best-effort: any failure yields an empty list so
- * the rest of the catalog still generates.
- */
-export function collectSystemCommands(): CommandInfo[] {
-    const out: CommandInfo[] = [];
-    try {
-        walk(systemHandlers as unknown as HandlerNode, [], out);
-    } catch {
-        return [];
-    }
-    return out.sort((a, b) => a.path.localeCompare(b.path));
-}
-
-function walk(
-    node: HandlerNode,
-    pathParts: string[],
-    out: CommandInfo[],
-): void {
-    const commands = node.commands;
-    if (commands === undefined || typeof commands !== "object") {
-        return;
-    }
-    for (const [name, child] of Object.entries(commands)) {
-        if (child === null || typeof child !== "object") {
-            continue;
-        }
-        const currentPath = [...pathParts, name];
-        const hasSub =
-            child.commands !== undefined &&
-            Object.keys(child.commands).length > 0;
-        const params = child.parameters ?? child.defaultSubCommand?.parameters;
-        out.push({
-            path: currentPath.join(" "),
-            description:
-                typeof child.description === "string" ? child.description : "",
-            group: hasSub,
-            args: extractArgs(params),
-            flags: extractFlags(params),
-        });
-        if (hasSub) {
-            walk(child, currentPath, out);
-        }
-    }
-}
-
-function extractArgs(params: HandlerNode["parameters"]): CommandArg[] {
-    const args = params?.args;
-    if (args === undefined) {
-        return [];
-    }
-    return Object.entries(args).map(([name, def]) => ({
-        name,
-        type: typeof def?.type === "string" ? def.type : "string",
-        optional: def?.optional === true,
-        description:
-            typeof def?.description === "string" ? def.description : "",
-    }));
-}
-
-function extractFlags(params: HandlerNode["parameters"]): CommandFlag[] {
-    const flags = params?.flags;
-    if (flags === undefined) {
-        return [];
-    }
-    return Object.entries(flags).map(([name, def]) => ({
-        name,
-        char: typeof def?.char === "string" ? def.char : "",
-        type: typeof def?.type === "string" ? def.type : "string",
-        default: def?.default === undefined ? "" : String(def.default),
-        description:
-            typeof def?.description === "string" ? def.description : "",
-    }));
-}
diff --git a/ts/tools/actionBrowser/src/types.ts b/ts/tools/actionBrowser/src/types.ts
index a026d925b6..66106f5226 100644
--- a/ts/tools/actionBrowser/src/types.ts
+++ b/ts/tools/actionBrowser/src/types.ts
@@ -60,14 +60,37 @@ export interface CommandFlag {
     description: string;
 }
 
+/** The agent action a command is equivalent to (declared on the handler). */
+export interface CommandActionLink {
+    /** Schema that declares the action; omitted when unambiguous in the agent. */
+    schema?: string;
+    actionName: string;
+}
+
 export interface CommandInfo {
-    /** Space-separated command path, e.g. "config agent". */
+    /**
+     * Host that provides the command: "system" for the built-in, unprefixed
+     * commands (`@config`) or an agent name for prefixed commands (`shell`
+     * for `@shell …`).
+     */
+    host: string;
+    /**
+     * Space-separated command path within the host's namespace, e.g.
+     * "config agent". Empty for a host that exposes a single bare `@<host>`
+     * command.
+     */
     path: string;
     description: string;
     /** True when the entry is a command group (has sub-commands). */
     group: boolean;
     args: CommandArg[];
     flags: CommandFlag[];
+    /**
+     * The agent action this command is equivalent to, when the handler declares
+     * one. Enables cross-linking a typed command with its natural-language
+     * action (and tracking which commands still lack one).
+     */
+    action?: CommandActionLink;
 }
 
 export interface CatalogCounts {
@@ -80,6 +103,7 @@ export interface Catalog {
     /** ISO timestamp of when the catalog was generated. */
     generatedAt: string;
     agents: AgentInfo[];
-    systemCommands: CommandInfo[];
+    /** Every `@command`, across the system host and each agent host. */
+    commands: CommandInfo[];
     counts: CatalogCounts;
 }
diff --git a/ts/tools/docsAutogen/src/cli.ts b/ts/tools/docsAutogen/src/cli.ts
index 950f1fd6ac..da32cd4196 100644
--- a/ts/tools/docsAutogen/src/cli.ts
+++ b/ts/tools/docsAutogen/src/cli.ts
@@ -322,7 +322,7 @@ async function runCommandReference(
         await import("./commandReference.js");
 
     if (opts.dryRun) {
-        const markdown = await generateCommandReferenceMarkdown();
+        const markdown = await generateCommandReferenceMarkdown(monorepoRoot);
         process.stdout.write(markdown);
         return 0;
     }
diff --git a/ts/tools/docsAutogen/src/commandReference.ts b/ts/tools/docsAutogen/src/commandReference.ts
index 127e0eb532..3531b435e8 100644
--- a/ts/tools/docsAutogen/src/commandReference.ts
+++ b/ts/tools/docsAutogen/src/commandReference.ts
@@ -21,12 +21,15 @@ import {
     initializeCommandHandlerContext,
     closeCommandHandlerContext,
     collectCommandReferenceMarkdown,
+    collectActionReference,
+    getAllActionConfigProvider,
 } from "agent-dispatcher/internal";
 import { getInstanceDir } from "agent-dispatcher/helpers/data";
 import {
     getDefaultAppAgentProviders,
     getDefaultAppAgentSource,
 } from "default-agent-provider";
+import { existsSync } from "node:fs";
 
 // Repo-relative location of the generated reference.
 export const COMMAND_REFERENCE_REL_PATH = path.join(
@@ -66,13 +69,40 @@ currently available.
 // command). Translation, explanation, and caching are disabled so the boot
 // needs no API keys; agents load regardless of missing runtime credentials
 // because credentials are only consulted at action-execution time.
-export async function generateCommandReferenceMarkdown(): Promise<string> {
+export async function generateCommandReferenceMarkdown(
+    monorepoRoot: string,
+): Promise<string> {
     const instanceDir = getInstanceDir();
     const appAgentProviders = getDefaultAppAgentProviders(instanceDir);
     // The @package management commands are provided by the install source
     // rather than a static provider; include it so they are documented too.
     const appAgentSources = [getDefaultAppAgentSource(instanceDir)];
 
+    // Resolve each command's declared action to a fully-qualified name and a
+    // link to its schema source. Built from the same providers, so it does not
+    // depend on which schemas the command context enables. The link is relative
+    // to the reference doc's own location.
+    const { provider } = await getAllActionConfigProvider(appAgentProviders);
+    const actionReference = collectActionReference(provider);
+    const docDir = path.dirname(
+        path.resolve(monorepoRoot, COMMAND_REFERENCE_REL_PATH),
+    );
+    const resolveAction = (agentName: string, actionName: string) => {
+        const entry = actionReference.get(`${agentName}\n${actionName}`);
+        if (entry === undefined) {
+            return undefined;
+        }
+        const qualifiedName = `${entry.schemaName}.${actionName}`;
+        if (entry.sourceFile === undefined || !existsSync(entry.sourceFile)) {
+            return { qualifiedName };
+        }
+        const link = path
+            .relative(docDir, entry.sourceFile)
+            .split(path.sep)
+            .join("/");
+        return { qualifiedName, link };
+    };
+
     const context = await initializeCommandHandlerContext(
         "docs-command-reference",
         {
@@ -85,7 +115,9 @@ export async function generateCommandReferenceMarkdown(): Promise<string> {
         },
     );
     try {
-        const body = await collectCommandReferenceMarkdown(context);
+        const body = await collectCommandReferenceMarkdown(context, {
+            resolveAction,
+        });
         // Format through prettier (markdown parser, repo defaults) so the
         // written file is idempotent and passes the repo's formatting check
         // without a follow-up `prettier --write` pass.
@@ -108,7 +140,7 @@ export interface CommandReferenceWriteResult {
 export async function writeCommandReference(
     monorepoRoot: string,
 ): Promise<CommandReferenceWriteResult> {
-    const markdown = await generateCommandReferenceMarkdown();
+    const markdown = await generateCommandReferenceMarkdown(monorepoRoot);
     const targetPath = path.join(monorepoRoot, COMMAND_REFERENCE_REL_PATH);
 
     let previous: string | undefined;
diff --git a/ts/tools/scripts/code/circular-baseline-exception.json b/ts/tools/scripts/code/circular-baseline-exception.json
index 4c29996b8a..e5e472520d 100644
--- a/ts/tools/scripts/code/circular-baseline-exception.json
+++ b/ts/tools/scripts/code/circular-baseline-exception.json
@@ -12,6 +12,9 @@
     {
       "key": "packages/dispatcher/dispatcher/src/execute/actionHandlers.ts > packages/dispatcher/dispatcher/src/context/memory.ts > packages/dispatcher/dispatcher/src/internal.ts > packages/dispatcher/dispatcher/src/context/inlineAgentProvider.ts > packages/dispatcher/dispatcher/src/context/system/systemAgent.ts > packages/dispatcher/dispatcher/src/context/system/handlers/copilotCommandHandlers.ts"
     },
+    {
+      "key": "packages/dispatcher/dispatcher/src/command/command.ts > packages/dispatcher/dispatcher/src/execute/actionHandlers.ts > packages/dispatcher/dispatcher/src/context/memory.ts > packages/dispatcher/dispatcher/src/internal.ts > packages/dispatcher/dispatcher/src/context/inlineAgentProvider.ts > packages/dispatcher/dispatcher/src/context/system/systemAgent.ts > packages/dispatcher/dispatcher/src/context/system/action/conversationActionHandler.ts"
+    },
     {
       "key": "packages/agents/browserExtension/src/extension/contentScript/recording/index.ts > packages/agents/browserExtension/src/extension/contentScript/recording/actions.ts > packages/agents/browserExtension/src/extension/contentScript/recording/capture.ts"
     },