a2a-wrapper logoa2a-wrapper
CommunityChangelog

a2a-copilot changelog

Release notes for a2a-copilot.

This page is generated from a2a-copilot/CHANGELOG.md and stays in sync with the repository.

1.8.2

Patch Changes

  • 4e2bd82: No code changes. A prior release run published every package's exact target version under the canary npm dist-tag instead of latest (the canary job's snapshot step no-ops when there are no pending changesets, which was the case immediately after that Version Packages PR merged — see the canary-job fix in a preceding commit). Since npm never allows republishing an already-used version string, the only way to get a latest-tagged release out is a fresh patch bump.
  • Updated dependencies [4e2bd82]

1.8.1

Minor Changes

  • d6c2701: Add native A2A protocol v1.0 support, built on @a2a-js/[email protected], while preserving full backward compatibility with A2A v0.3.x clients.

    @a2a-wrapper/core (breaking):

    • buildAgentCard() now produces the native v1.0 AgentCard shape (supportedInterfaces[] instead of url/additionalInterfaces/protocolVersion; capabilities.extendedAgentCard instead of supportsAuthenticatedExtendedCard; stateTransitionHistory removed). Callers reading the old v0.3 fields directly off the return value must update — the server itself still serves a fully v0.3-shaped card to legacy clients (see below).
    • createA2AServer()'s JSON-RPC/REST transports and the /.well-known/agent-card.json route now negotiate protocol version per-request via the A2A-Version header: 1.0/absent-with-recent-header gets the native v1.0 card and wire shapes, while 0.3/no-header-at-all (matching the SDK's own default) gets a fully v0.3-shaped card and JSON-RPC/REST translation via @a2a-js/sdk's compat/v0_3 layer.
    • ServerOptions.protocolVersion default changed from "0.3" to "1.0".
    • New ServerOptions.onListening hook and ServerOptions.agentCardSigning option (Signed Agent Cards, RFC 7515 JWS, opt-in via AgentCardConfig.signing or the programmatic option).
    • New extractUserText(message) export centralizing inbound Part parsing for the v1.0 proto-oneof Part shape.
    • TaskState is now re-exported as a value (real numeric enum in v1.0, was a string-literal type in v0.3).
    • @a2a-js/sdk peer/dev dependency bumped to ^1.0.0.

    Wrapper packages (a2a-claude, a2a-codex, a2a-copilot, a2a-opencode, a2a-antigravity):

    • Each wrapper's createA2AServer() public API is unchanged, but is now a thin delegate to @a2a-wrapper/core's createA2AServer instead of duplicating Express/SDK server wiring — restoring the "A2A protocol code lives only in core" design.
    • a2a-copilot and a2a-opencode no longer ship their own local event-publisher.ts; both now use @a2a-wrapper/core's (v1.0-aware) event publisher.
    • @a2a-js/sdk dependency bumped to ^1.0.0 (previously an inconsistent mix of ^0.3.9/^0.3.13).

Patch Changes

  • Updated dependencies [f3c7062]
  • Updated dependencies [41e2d82]
  • Updated dependencies [d6c2701]

1.7.0

Minor Changes

  • feat: add comprehensive LLM usage telemetry and tracking

Patch Changes

1.6.0 — 2026-06-03

Added

  • Bring Your Own Model (BYOK) — new copilot.provider config block lets you point the wrapper at any OpenAI-compatible endpoint instead of GitHub Copilot. Supports Ollama (local), OpenAI, Anthropic, Azure OpenAI, Azure AI Foundry, vLLM, LiteLLM, and any OpenAI-compatible API. The same COPILOT_PROVIDER_* env vars the gh copilot CLI uses are supported. No GitHub Copilot account required when using a custom provider.
  • New bundled example: agents/ollama/ — ready-to-run local agent backed by Ollama (verified with qwen3.6).
  • MCP custom headers — http and sse MCP server configs now accept a headers: Record<string, string> map. Use for auth tokens and API keys against hosted MCP servers (Linear, Notion, remote GitHub MCP, etc.).
  • Env-var substitution extended — ${ENV_VAR} (explicit, recommended) and $ENV_VAR (bare, backward-compatible) substitution now applies to stdio args, stdio env values, and http/sse headers values. Keeps secrets out of config.json.

Fixed

  • BYOK models emitting tool calls as plain text — when a BYOK provider is configured and the model outputs a raw {"name":...,"arguments":...} JSON blob instead of a proper response (common with small local models lacking native tool-calling support), the wrapper detects it and returns an actionable error message instead of leaking raw JSON to the caller.
  • Logger level propagation — level: "debug" in config now correctly reaches all child loggers. Previously, child loggers captured the level at module-import time before config was loaded.

Changed

  • @github/copilot-sdk upgraded 0.2.2 → 1.0.0 — migrated to the RuntimeConnection factory API; session.destroy() renamed to session.disconnect(). SDK 1.0.0 bumped CLI dependency to @github/[email protected].
  • @github/copilot CLI upgraded 1.0.39 → 1.0.59 — includes the v1.0.56 BYOK provider fix (custom providers now work correctly in headless SDK sessions), plus 20 versions of improvements.
  • Updated dependencies

1.5.0 — 2026-05-13

Added

  • A2A Sub-Agents — new subAgents config section lets the parent agent expose remote A2A agents as MCP tools to the Copilot LLM. The wrapper spawns a2a-mcp-skillmap as a stdio MCP server and registers it under the reserved a2a-subagents key. Each remote skill becomes a callable tool the LLM can dispatch like any other MCP tool. See agents/multi-agent/ for an example.
  • Pinned skillmap version — the synthesized MCP entry invokes npx -y a2a-mcp-skillmap@<pinned> rather than the unpinned package name, so a future skillmap release cannot silently change semantics.
  • JSON schema for config.json — schemas/agent-config.schema.json generated from the TypeScript types via npm run schema. Drift-detection and schema validation tests ship in CI.

Changed

1.4.0

Added

  • Memory Persistence — agents can now declare memory.instructions and memory.skills in their config.json. At startup, the executor materializes these files into the workspace at .github/copilot-instructions.md and .github/skills/<name>/, making them available to the Copilot LLM across sessions. Skills include SKILL.md manifests and optional resource directories (scripts/, references/, assets/).
  • configDir injection — the CLI now automatically derives and injects configDir from the config file path, enabling relative path resolution in memory configs.

Changed

1.3.0

Added

  • Event Transport Integration — executor and MCP hooks now route all trace events (tool calls, reasoning) through the new @a2a-wrapper/core event transport abstraction instead of calling publishTraceArtifact directly. Supports A2A sideband (default), HTTP collectors, and custom transports.
  • Agent card delegates to core — buildAgentCard() now delegates to @a2a-wrapper/core's shared implementation, eliminating duplicated card construction logic.
  • MCP hooks refactored — McpEvidenceHooks now uses AgentEventEmitter instead of raw ExecutionEventBus. Emits separate tool_call_start and tool_call_end events for better observability granularity.

Changed

  • Fix MCP tool permissions hang in headless environments — added approveAll from @github/copilot-sdk to SessionManager.getOrCreate() and CopilotExecutor.buildContext(). Without this, the SDK prompts for human approval on every MCP tool call and hangs indefinitely in Docker, Kubernetes, and CI environments.
  • Default events config — defaults now include events: { enabled: true, transport: "a2a" }.
  • Updated dependencies

1.2.2

Changed

  • Upgrade @github/copilot-sdk from ^0.1.25 to ^0.2.0 (stable release). vscode-jsonrpc is no longer a transitive dependency, resolving the Node 22 ESM crash upstream.

1.2.1

Changed

  • Fix post-release bugs: Node 22 ESM resolution (postinstall patch for vscode-jsonrpc), auth error message clarity (GITHUB_TOKEN guidance), README corrections (message/* method names, messageId in examples), and ResultManager race condition (publish task event before status-update in both executors).
  • Updated dependencies

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

1.2.0 - 2026-04-02

Changed

  • Migrated to monorepo structure with npm workspaces, Turborepo, and Changesets
  • Extracted shared infrastructure to @a2a-wrapper/core package (logging, config, events, server factory, session management, CLI scaffold)
  • Now depends on @a2a-wrapper/core for all shared functionality
  • Consolidated community docs (CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, LICENSE) to repository root
  • Unified CI/CD with Turborepo-powered GitHub Actions workflows
  • Switched test script to vitest --run for non-interactive CI execution

1.0.0 - 2025-02-23

Added

  • A2A v0.3.0 protocol implementation over Express HTTP server
  • Agent Card served at /.well-known/agent-card.json
  • JSON-RPC endpoint at /a2a/jsonrpc — message/send, message/stream, tasks/get, tasks/cancel
  • REST endpoint at /a2a/rest
  • GitHub Copilot SDK backend (@github/copilot-sdk) for LLM inference
  • Real-time SSE streaming of status updates and artifact chunks
  • Multi-turn conversation support via contextId → Copilot session mapping
  • MCP tool server support — HTTP and stdio transports
  • JSON config file with $comment annotations for easy customisation
  • Environment variable and CLI argument overrides (priority: defaults ← JSON ← ENV ← CLI)
  • example and filesystem-assistant bundled agent configurations
  • Docker support with multi-stage build and corporate proxy CA injection
  • server.sh lifecycle manager (start / stop / restart / status / logs / foreground)
  • Health check endpoint at /health
  • Context building endpoint at /context/build
  • --stream-artifacts / --no-stream-artifacts flag for SSE vs. buffered output
  • TypeScript public API exports for programmatic use
Edit this page on GitHub·Report an issue

@a2a-wrapper/core changelog

Release notes for @a2a-wrapper/core.

a2a-claude changelog

Release notes for a2a-claude.

On this page

1.8.2Patch Changes1.8.1Minor ChangesPatch Changes1.7.0Minor ChangesPatch Changes1.6.0 — 2026-06-03AddedFixedChanged1.5.0 — 2026-05-13AddedChanged1.4.0AddedChanged1.3.0AddedChanged1.2.2Changed1.2.1ChangedUnreleased1.2.0 - 2026-04-02Changed1.0.0 - 2025-02-23Added