A2A Editor WorkIQ Fork

This fork shows how your own software product can connect to your Microsoft 365 Copilot agents through Agent2Agent (A2A).

It is based on the upstream open-resource-discovery/a2a-editor project, which provides reusable UI components for editing, viewing, and testing A2A agent cards. This fork keeps that foundation and adds a Windows desktop experience for discovering and chatting with agents exposed by the Microsoft WorkIQ CLI.

Install

1. Install WorkIQ CLI

Install Microsoft WorkIQ CLI version 0.5.0 or newer. You'll need to be in an organization that allows it.

Follow the install instructions

Then be sure to sign in:

workiq auth login

Confirm WorkIQ is working to list your agents:

workiq agents list

2. Download the Windows app

Download the portable Windows x64 executable from the latest fork release:

Download A2A Editor WorkIQ Preview

Run A2A.Editor-0.3.0-win-x64.exe. No clone or local rebuild is required.

This preview build is unsigned, so Windows SmartScreen may warn that the publisher is unknown.

What is different in this fork?

• Adds an Electron desktop shell around the A2A editor experience.
• Uses WorkIQ CLI 0.5.0 commands to list your Microsoft 365 Copilot agents.
• Connects directly to each selected agent's downstream A2A agent card.
• Injects the WorkIQ bearer token in the desktop bridge so the app can call WorkIQ-hosted A2A endpoints.
• Includes smoke tests for listing WorkIQ agents and sending an end-to-end A2A message.

The goal is to demonstrate that a separate product can discover and call your M365 Copilot agents without requiring users to copy agent-card JSON, run a local relay manually, or rebuild the app from source.

How it works

1. The app asks WorkIQ CLI for the list of available agents.

2. Each WorkIQ agent is mapped to its A2A card URL:

   https://workiq.svc.cloud.microsoft/a2a/<agent-id>/.well-known/agent-card.json
   

3. The editor loads that downstream card and shows the actual selected agent, not a local wrapper agent.

4. Chat requests are sent through the desktop fetch bridge, which obtains a token from:

   workiq dev token

5. The request is sent to the WorkIQ-hosted A2A endpoint for the selected M365 Copilot agent.

Upstream project

For the general-purpose A2A editor library, web playground, Docker image, and package usage, see the upstream project:

https://github.com/open-resource-discovery/a2a-editor

This fork is intentionally focused on the WorkIQ/M365 Copilot desktop scenario.

Development

If you do want to build from source:

npm install
npm run build:desktop
npm run package:desktop

Useful checks:

npm run test
npm run lint

The packaged portable executable is written to release\.

License

This fork follows the license of the upstream project. See LICENSE for copyright and license information.

This is a hobby project and is not supported by Microsoft.