Recipe

a2a-remote

An agent another party runs over the Agent2Agent (A2A) protocol, reached at the address infra.endpoint names, as a reference realization for local development via Docker Compose: no service is defined for it and nothing runs. The address reaches a consuming service through the injection context rather than through a service definition, because compose has no counterpart to an in-cluster alias. provides.endpoint is the address as written, protocol is its scheme, agent_card_url is where the agent's card is read, and credential_header is the request header the agent reads a caller's credential from, Authorization unless infra.credential_header names another. token_url, oidc_discovery_url and scopes are where and for what a caller obtains a token under the card's OAuth 2.0 or OpenID Connect scheme, as infra names them, and empty where it names none. No credential is held here: a consumer that needs one holds it on its own connection to the agent and presents it under that header, because the credential belongs to the consumer rather than to the address. infra.endpoint is the address without any part that carries a key, at least a scheme and a host. An address carrying a user name or password is refused, for infra.endpoint and infra.agent_card_url alike. infra.token_url and infra.oidc_discovery_url, where set, are each refused unless they are an https URL naming a host with no user name or password, since OAuth 2.0 sends a client secret only over TLS. Reach for this realization under Docker Compose; helm/a2a-remote is the same reference on Kubernetes.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:2d96ef4e05e3c8717e368ec5ad004f31fdd6b25105bb2f58587a868c0db74c9f
Published
2026-11-10T10:18:09Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:ea68f737c4d613c6c88acfaa19c01156f4e81cb41607b733bb9044a538d20dde

Reference at this version

oci://hub.aggrega.ai/recipe/compose/a2a-remote:1.0.0
Target
—
Implements
core/ai-agent/a2a-remote:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
endpoint{{ .locals.endpoint }}
agent_card_url{{ .locals.agent_card_url }}
protocol{{ .locals.scheme }}
credential_header{{ .infra.credential_header }}
token_url{{ optional .infra "token_url" "" }}
oidc_discovery_url{{ optional .infra "oidc_discovery_url" "" }}
scopes{{ optional .infra "scopes" "" }}

Workload

Workload · form: reference

Locals

NameTemplate
endpoint{{ optional .infra "endpoint" "" }}
scheme{{ (urlParse .locals.endpoint).scheme }}
port{{ $u := urlParse .locals.endpoint }}{{ $p := regexFind ":[0-9]+
quot; $u.host | trimPrefix ":" }}{{ if $p }}{{ $p }}{{ else if eq $u.scheme "http" }}80{{ else }}443{{ end }}
agent_card_url{{ $c := optional .infra "agent_card_url" "" }}{{ if $c }}{{ $c }}{{ else }}{{ $u := urlParse .locals.endpoint }}{{ $u.scheme }}://{{ $u.host }}/.well-known/agent-card.json{{ end }}

Values mapping

No values mapping declared.

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

  • implementsimplementscontract compatible

    core/ai-agent/a2a-remote:1.0.0

    All required outputs are satisfied and every provided output is named in the contract.

Used by

Nothing in the catalog depends on this entity.

Recipe concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy