Skip to content

feat(examples): add A2A design review demo#1409

Draft
zredlined wants to merge 1 commit into
mainfrom
codex/a2a-design-review-example
Draft

feat(examples): add A2A design review demo#1409
zredlined wants to merge 1 commit into
mainfrom
codex/a2a-design-review-example

Conversation

@zredlined
Copy link
Copy Markdown
Collaborator

Summary

Add a getting-started A2A design-review example where multiple isolated agents review a GitHub issue over Agent2Agent-style HTTP endpoints. The demo shows Agent Card discovery, streamed task updates, iterative artifacts, and the OpenShell boundary around worker agents.

Related Issue

N/A

Changes

  • Added examples/a2a-design-review/ with a minimal A2A HTTP agent, host orchestrator, OpenShell runner script, restrictive worker policy, and offline issue fixture.
  • Added a getting-started tutorial page for running the A2A design review locally or through OpenShell service routing.
  • Added the tutorial card to the tutorials index.

Testing

  • bash -n examples/a2a-design-review/demo.sh
  • node --check examples/a2a-design-review/a2a-agent.mjs && node --check examples/a2a-design-review/orchestrator.mjs
  • DEMO_LOCAL_ONLY=1 DEMO_OUTPUT=/tmp/a2a-design-review-final-smoke.md bash examples/a2a-design-review/demo.sh
  • git diff --check
  • uv run python scripts/update_license_headers.py --check <new/modified files>
  • mise run pre-commit passes

mise run pre-commit ran the full suite and the repo checks/tests completed successfully, but the task exited nonzero because of an unrelated pre-existing untracked tmp.sh file missing an SPDX header. I did not modify that file. The live OpenShell sandbox path could not be completed in this workspace because the currently running local gateway fails openshell sandbox list with a protobuf UTF-8 decode error after syncing main; the demo now preflights that condition and reports it clearly.

Checklist

  • Follows Conventional Commits
  • Commits are signed off (DCO)

@github-actions
Copy link
Copy Markdown

Start a gateway, then run the sandboxed version:

```shell
mise run gateway:docker
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Is there a reason to specifically use mise here vs the direct installation methods we support?

@zredlined zredlined marked this pull request as draft May 15, 2026 19:41
@copy-pr-bot
Copy link
Copy Markdown

copy-pr-bot Bot commented May 15, 2026

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants