[WIP] Overview of remoteCodingAgents API Proposal and Implementation

[Copilot]

TITLE: Overview of remoteCodingAgents API Proposal and Implementation

TASK DESCRIPTION: The user requested information on the remoteCodingAgents API proposal, its implementation in the VSCode codebase, and how to create a similar cloud action for prompt files.

COMPLETED: The assistant provided a detailed overview of the remoteCodingAgents API proposal, including its definition, interface, service implementation, current usage, and integration points. Additionally, the assistant identified the "Run prompt in new chat" action and its menu configuration.

PENDING: The user needs to implement the new cloud action for prompt files based on the provided guidance.

CODE STATE:

• Key files discussed include:
  • src/vs/platform/extensions/common/extensionsApiProposals.ts
  • src/vs/workbench/contrib/remoteCodingAgents/browser/remoteCodingAgents.contribution.ts
  • src/vs/workbench/contrib/remoteCodingAgents/common/remoteCodingAgentsService.ts
  • src/vs/workbench/contrib/chat/browser/actions/chatExecuteActions.ts
  • src/vs/workbench/contrib/chat/browser/promptSyntax/runPromptAction.ts

RELEVANT CODE/DOCUMENTATION SNIPPETS:

1. Extension Point Definition:

   const extensionPoint = ExtensionsRegistry.registerExtensionPoint<IRemoteCodingAgentExtensionPoint[]>({
       extensionPoint: 'remoteCodingAgents',
       jsonSchema: {
           description: 'Contributes remote coding agent integrations to the chat widget.',
           type: 'array',
           items: {
               type: 'object',
               properties: {
                   id: { type: 'string', description: 'A unique identifier for this item.' },
                   command: { type: 'string', description: 'Identifier of the command to execute.' },
                   displayName: { type: 'string', description: 'A user-friendly name for this item.' },
                   description: { type: 'string', description: 'Description of the remote agent.' },
                   when: { type: 'string', description: 'Condition to show this item.' }
               },
               required: ['command', 'displayName'],
           }
       }
   });

2. Current "Run Prompt in New Chat" Action Location:

   • Action ID: workbench.action.chat.run-in-new-chat.prompt.current
   • Menu: MenuId.EditorTitleRun
   • Group: navigation

CHANGES:

• The assistant outlined how to create a new cloud action for prompt files, including:
  1. Creating a new action similar to CreateRemoteAgentJobAction.
  2. Adding it to the MenuId.EditorTitleRun menu group.
  3. Specifying the appropriate conditions for visibility.
  4. Implementing the action's run method to handle the prompt file URI and call the contribution's command.

This summary encapsulates the key points of the conversation, providing a clear understanding of the remoteCodingAgents API proposal and the steps needed to implement a new cloud action.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.