A2A API

Generated from the typed public surface.

tesserix_adk.a2a.AgentCard

Stability: alpha

What a peer publishes about itself: who it is, what it does, what it takes.

class AgentCard(AdkModel) {rendered(self) -> 'bytes'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.AgentCardError

Stability: alpha

Raised when a card cannot be generated as published, naming the skill at fault.

class AgentCardError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.AgentLimits

Stability: alpha

What the agent will hold to, so a caller can size its own use before it is refused.

class AgentLimits(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.AgentProvider

Stability: alpha

Who publishes the agent, in terms a stranger can act on.

class AgentProvider(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.AgentSkill

Stability: alpha

One thing a peer may ask the agent to do.

class AgentSkill(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.CardEndpoint

Stability: alpha

Serves one card at the well-known path, on any ASGI application.

class CardEndpoint(object) {serve(self, card: 'AgentCard') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.DEFAULT_DISCOVERY_TIMEOUT_SECONDS

Stability: alpha

Convert a string or number to a floating-point number, if possible.

DEFAULT_DISCOVERY_TIMEOUT_SECONDS: float

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.DEFAULT_KEPT_BYTES

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

DEFAULT_KEPT_BYTES: int

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.DEFAULT_MAX_CONTENT_BYTES

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

DEFAULT_MAX_CONTENT_BYTES: int

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.DEFAULT_MAX_REPORTED_TOKENS

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

DEFAULT_MAX_REPORTED_TOKENS: int

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.DEFAULT_NEGATIVE_TTL_SECONDS

Stability: alpha

Convert a string or number to a floating-point number, if possible.

DEFAULT_NEGATIVE_TTL_SECONDS: float

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.DEFAULT_PEER_TIMEOUT_SECONDS

Stability: alpha

Convert a string or number to a floating-point number, if possible.

DEFAULT_PEER_TIMEOUT_SECONDS: float

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.DEFAULT_PEER_TTL_SECONDS

Stability: alpha

Convert a string or number to a floating-point number, if possible.

DEFAULT_PEER_TTL_SECONDS: float

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.DEFAULT_STALE_SECONDS

Stability: alpha

Convert a string or number to a floating-point number, if possible.

DEFAULT_STALE_SECONDS: float

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.DEFAULT_TTL_SECONDS

Stability: alpha

Convert a string or number to a floating-point number, if possible.

DEFAULT_TTL_SECONDS: float

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.DelegationChain

Stability: alpha

Which agents a piece of work passed through, outermost first.

class DelegationChain(AdkModel) {describe(self) -> 'str'; encoded(self) -> 'str'; extended(self, hop: 'DelegationHop') -> 'Self'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.DelegationClaims

Stability: alpha

What a peer is told, and the only thing it is allowed to act on.

class DelegationClaims(AdkModel) {attributes(self) -> 'dict[str, str]'; expired(self, now: 'float') -> 'bool'; meta(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.DelegationHop

Stability: alpha

One agent in a chain, and what it passed on.

class DelegationHop(AdkModel) {describe(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.MAX_CARD_BYTES

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

MAX_CARD_BYTES: int

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.MAX_CHAIN_DEPTH

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

MAX_CHAIN_DEPTH: int

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.MAX_SKILLS

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

MAX_SKILLS: int

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerActionError

Stability: alpha

A gated action was reached for with nothing behind it but a peer's answer.

class PeerActionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerBoundary

Stability: alpha

The one place a peer's answer becomes something the caller may read.

class PeerBoundary(object) {contain(self, result: 'PeerResult', *, tenant: 'str', card: 'str' = '') -> 'PeerContent'; permitted(self, content: 'PeerContent', action: 'ProposedAction', *, decided_by: 'str' = '') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerCall

Stability: alpha

One outbound call, as a transport receives it.

class PeerCall(object)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerClient

Stability: alpha

Calls one peer's skills, typed both ways and inside the caller's run.

class PeerClient(object) {invoke(self, skill: 'str', payload: 'Mapping[str, Any]', *, idempotency_key: 'str | None' = None, deadline_seconds: 'float | None' = None, cancellation: 'CancellationToken | None' = None) -> 'PeerResult'; stream(self, skill: 'str', payload: 'Mapping[str, Any]', *, idempotency_key: 'str | None' = None, cancellation: 'CancellationToken | None' = None) -> 'AsyncIterator[PeerProgress | PeerResult]'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerContent

Stability: alpha

One peer's answer, in the only form the caller passes to a model.

class PeerContent(AdkModel) {attributes(self) -> 'dict[str, str]'; source(self) -> 'ContentSource'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerDelegation

Stability: alpha

One outbound call to a peer: a credential to present, claims to send alongside.

class PeerDelegation(object) {headers(self) -> 'dict[str, str]'; meta(self) -> 'dict[str, str]'; span_attributes(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerDelegator

Stability: alpha

Mints a delegation for one peer call, narrowed on the way out.

class PeerDelegator(object) {delegate(self, *, identity: 'AgentIdentity', peer: 'AgentCard', needs: 'Iterable[str]', run_id: 'str', chain: 'DelegationChain | None' = None, agent_version: 'str' = '1.0.0') -> 'PeerDelegation'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerDiscovery

Stability: alpha · Kind: Protocol

How an agent finds a peer. Substitutable, so a test never needs a registry.

class PeerDiscovery(Protocol) {find(self, need: 'PeerNeed') -> 'PeerResolution'; invalidate(self, need: 'PeerNeed') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerDiscoveryError

Stability: alpha

Raised when no peer could be resolved, saying which of the refusals it was.

class PeerDiscoveryError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerDiscoveryReason

Stability: alpha

Why a peer could not be resolved. Every one of these fails closed.

class PeerDiscoveryReason(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerInvocationError

Stability: alpha

A peer call that did not produce an answer the caller may use.

class PeerInvocationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerInvocationReason

Stability: alpha

Why a peer call was refused, in terms the caller can act on.

class PeerInvocationReason(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerNeed

Stability: alpha

What a caller is looking for.

class PeerNeed(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerProgress

Stability: alpha

Something the peer said while it was still working.

class PeerProgress(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerRejection

Stability: alpha

One registry entry that was refused, kept so somebody can explain the refusal.

class PeerRejection(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerReply

Stability: alpha

What a transport read off the wire, before anything here has believed it.

class PeerReply(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerResolution

Stability: alpha

A peer that was found, and where the answer came from.

class PeerResolution(AdkModel) {attributes(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerResult

Stability: alpha

A peer's answer, validated against the schema the peer published for it.

class PeerResult(AdkModel) {attributes(self) -> 'dict[str, str]'; redacted(self, *, tenant: 'str' = '') -> 'dict[str, Any]'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerSuspicionError

Stability: alpha

An answer screened as instructions and this peer's policy is to fail closed.

class PeerSuspicionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerTransport

Stability: alpha · Kind: Protocol

How a call reaches the peer. Every transport the kit ships lives outside a2a.

class PeerTransport(Protocol) {cancel(self, call: 'PeerCall') -> 'None'; invoke(self, call: 'PeerCall') -> 'PeerReply'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerTrustPolicy

Stability: alpha

How much of another agent's word this run will take, per peer.

class PeerTrustPolicy(AdkModel) {for_peer(self, peer: 'str') -> 'TrustDecision'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.PeerVerifier

Stability: alpha

Checks an arriving delegation against what this agent published about itself.

class PeerVerifier(object) {accept(self, claims: 'DelegationClaims') -> 'AgentIdentity'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.ProposedAction

Stability: alpha

Something the run is about to do with a peer's answer in hand.

class ProposedAction(object) {gates(self) -> 'tuple[str, ...]'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.RegistryFetch

Stability: alpha

Type alias.

RegistryFetch: TypeAliasType

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.RegistryPeers

Stability: alpha

Discovery through the org registry, cached, pinned and bounded.

class RegistryPeers(object) {find(self, need: 'PeerNeed') -> 'PeerResolution'; invalidate(self, need: 'PeerNeed') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.SkillSource

Stability: alpha · Kind: Protocol

What a card reads off a tool. Any Tool satisfies it, and so may a hand-built skill.

class SkillSource(Protocol)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.StaticPeers

Stability: alpha

Discovery from configuration, for a deployment with no registry and for tests.

class StaticPeers(object) {find(self, need: 'PeerNeed') -> 'PeerResolution'; invalidate(self, need: 'PeerNeed') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.StreamingPeerTransport

Stability: alpha · Kind: Protocol

A transport that can also report progress while the peer works.

class StreamingPeerTransport(PeerTransport, Protocol) {stream(self, call: 'PeerCall') -> 'AsyncIterator[PeerProgress | PeerReply]'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.TraceCarrier

Stability: alpha · Kind: Protocol

Where the caller sits in a trace. observability.W3CContext satisfies it.

class TraceCarrier(Protocol) {carried(self) -> 'dict[str, str]'; child(self, name: 'str', *, attempt: 'int' = 1) -> 'Self'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.TrustDecision

Stability: alpha

What the caller does with an answer that screened as instructions.

class TrustDecision(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.UnsupportedSchemaError

Stability: alpha

A published schema uses a keyword conforms does not implement.

class UnsupportedSchemaError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.WELL_KNOWN_PATH

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

WELL_KNOWN_PATH: str

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.boundary.DEFAULT_KEPT_BYTES

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

DEFAULT_KEPT_BYTES: int

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.boundary.DEFAULT_MAX_CONTENT_BYTES

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

DEFAULT_MAX_CONTENT_BYTES: int

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.boundary.PeerActionError

Stability: alpha

A gated action was reached for with nothing behind it but a peer's answer.

class PeerActionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.boundary.PeerBoundary

Stability: alpha

The one place a peer's answer becomes something the caller may read.

class PeerBoundary(object) {contain(self, result: 'PeerResult', *, tenant: 'str', card: 'str' = '') -> 'PeerContent'; permitted(self, content: 'PeerContent', action: 'ProposedAction', *, decided_by: 'str' = '') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.boundary.PeerContent

Stability: alpha

One peer's answer, in the only form the caller passes to a model.

class PeerContent(AdkModel) {attributes(self) -> 'dict[str, str]'; source(self) -> 'ContentSource'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.boundary.PeerSuspicionError

Stability: alpha

An answer screened as instructions and this peer's policy is to fail closed.

class PeerSuspicionError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.boundary.PeerTrustPolicy

Stability: alpha

How much of another agent's word this run will take, per peer.

class PeerTrustPolicy(AdkModel) {for_peer(self, peer: 'str') -> 'TrustDecision'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.boundary.ProposedAction

Stability: alpha

Something the run is about to do with a peer's answer in hand.

class ProposedAction(object) {gates(self) -> 'tuple[str, ...]'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.boundary.TrustDecision

Stability: alpha

What the caller does with an answer that screened as instructions.

class TrustDecision(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.card.AgentCard

Stability: alpha

What a peer publishes about itself: who it is, what it does, what it takes.

class AgentCard(AdkModel) {rendered(self) -> 'bytes'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.card.AgentCardError

Stability: alpha

Raised when a card cannot be generated as published, naming the skill at fault.

class AgentCardError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.card.AgentLimits

Stability: alpha

What the agent will hold to, so a caller can size its own use before it is refused.

class AgentLimits(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.card.AgentProvider

Stability: alpha

Who publishes the agent, in terms a stranger can act on.

class AgentProvider(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.card.AgentSkill

Stability: alpha

One thing a peer may ask the agent to do.

class AgentSkill(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.card.CardEndpoint

Stability: alpha

Serves one card at the well-known path, on any ASGI application.

class CardEndpoint(object) {serve(self, card: 'AgentCard') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.card.MAX_CARD_BYTES

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

MAX_CARD_BYTES: int

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.card.MAX_SKILLS

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

MAX_SKILLS: int

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.card.SkillSource

Stability: alpha · Kind: Protocol

What a card reads off a tool. Any Tool satisfies it, and so may a hand-built skill.

class SkillSource(Protocol)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.card.WELL_KNOWN_PATH

Stability: alpha

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

WELL_KNOWN_PATH: str

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.card.card_for

Stability: alpha

Generate a card from an agent's declaration and the skills it deliberately publishes.

def card_for(definition: 'AgentDefinition[Any]', *, audience: 'str', exports: 'Iterable[SkillSource]' = (), accepted_issuers: 'Iterable[str]' = (), calls_per_minute: 'int | None' = None, available: 'bool' = True) -> 'AgentCard'

Typed errors: AgentCardError

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.card_for

Stability: alpha

Generate a card from an agent's declaration and the skills it deliberately publishes.

def card_for(definition: 'AgentDefinition[Any]', *, audience: 'str', exports: 'Iterable[SkillSource]' = (), accepted_issuers: 'Iterable[str]' = (), calls_per_minute: 'int | None' = None, available: 'bool' = True) -> 'AgentCard'

Typed errors: AgentCardError

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.checkable

Stability: alpha

Refuse a schema conforms could not hold a payload to, before anything relies on it.

def checkable(schema: 'Mapping[str, Any]', *, path: 'str' = '') -> 'None'

Typed errors: UnsupportedSchemaError

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.conforms

Stability: alpha

Whether value satisfies schema, as the empty string or the first violation.

def conforms(value: 'object', schema: 'Mapping[str, Any]') -> 'str'

Typed errors: UnsupportedSchemaError

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.delegation.AgentCard

Stability: alpha

What a peer publishes about itself: who it is, what it does, what it takes.

class AgentCard(AdkModel) {rendered(self) -> 'bytes'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.delegation.DEFAULT_TTL_SECONDS

Stability: alpha

Convert a string or number to a floating-point number, if possible.

DEFAULT_TTL_SECONDS: float

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.delegation.DelegationChain

Stability: alpha

Which agents a piece of work passed through, outermost first.

class DelegationChain(AdkModel) {describe(self) -> 'str'; encoded(self) -> 'str'; extended(self, hop: 'DelegationHop') -> 'Self'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.delegation.DelegationClaims

Stability: alpha

What a peer is told, and the only thing it is allowed to act on.

class DelegationClaims(AdkModel) {attributes(self) -> 'dict[str, str]'; expired(self, now: 'float') -> 'bool'; meta(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.delegation.DelegationHop

Stability: alpha

One agent in a chain, and what it passed on.

class DelegationHop(AdkModel) {describe(self) -> 'str'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.delegation.MAX_CHAIN_DEPTH

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

MAX_CHAIN_DEPTH: int

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.delegation.PeerDelegation

Stability: alpha

One outbound call to a peer: a credential to present, claims to send alongside.

class PeerDelegation(object) {headers(self) -> 'dict[str, str]'; meta(self) -> 'dict[str, str]'; span_attributes(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.delegation.PeerDelegator

Stability: alpha

Mints a delegation for one peer call, narrowed on the way out.

class PeerDelegator(object) {delegate(self, *, identity: 'AgentIdentity', peer: 'AgentCard', needs: 'Iterable[str]', run_id: 'str', chain: 'DelegationChain | None' = None, agent_version: 'str' = '1.0.0') -> 'PeerDelegation'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.delegation.PeerVerifier

Stability: alpha

Checks an arriving delegation against what this agent published about itself.

class PeerVerifier(object) {accept(self, claims: 'DelegationClaims') -> 'AgentIdentity'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.discovery.DEFAULT_DISCOVERY_TIMEOUT_SECONDS

Stability: alpha

Convert a string or number to a floating-point number, if possible.

DEFAULT_DISCOVERY_TIMEOUT_SECONDS: float

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.discovery.DEFAULT_NEGATIVE_TTL_SECONDS

Stability: alpha

Convert a string or number to a floating-point number, if possible.

DEFAULT_NEGATIVE_TTL_SECONDS: float

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.discovery.DEFAULT_PEER_TTL_SECONDS

Stability: alpha

Convert a string or number to a floating-point number, if possible.

DEFAULT_PEER_TTL_SECONDS: float

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.discovery.DEFAULT_STALE_SECONDS

Stability: alpha

Convert a string or number to a floating-point number, if possible.

DEFAULT_STALE_SECONDS: float

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.discovery.PeerDiscovery

Stability: alpha · Kind: Protocol

How an agent finds a peer. Substitutable, so a test never needs a registry.

class PeerDiscovery(Protocol) {find(self, need: 'PeerNeed') -> 'PeerResolution'; invalidate(self, need: 'PeerNeed') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.discovery.PeerDiscoveryError

Stability: alpha

Raised when no peer could be resolved, saying which of the refusals it was.

class PeerDiscoveryError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.discovery.PeerDiscoveryReason

Stability: alpha

Why a peer could not be resolved. Every one of these fails closed.

class PeerDiscoveryReason(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.discovery.PeerNeed

Stability: alpha

What a caller is looking for.

class PeerNeed(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.discovery.PeerRejection

Stability: alpha

One registry entry that was refused, kept so somebody can explain the refusal.

class PeerRejection(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.discovery.PeerResolution

Stability: alpha

A peer that was found, and where the answer came from.

class PeerResolution(AdkModel) {attributes(self) -> 'dict[str, str]'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.discovery.RegistryFetch

Stability: alpha

Type alias.

RegistryFetch: TypeAliasType

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.discovery.RegistryPeers

Stability: alpha

Discovery through the org registry, cached, pinned and bounded.

class RegistryPeers(object) {find(self, need: 'PeerNeed') -> 'PeerResolution'; invalidate(self, need: 'PeerNeed') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.discovery.StaticPeers

Stability: alpha

Discovery from configuration, for a deployment with no registry and for tests.

class StaticPeers(object) {find(self, need: 'PeerNeed') -> 'PeerResolution'; invalidate(self, need: 'PeerNeed') -> 'None'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.discovery.fingerprint

Stability: alpha

The digest of a card, for pinning a peer to the card that was reviewed.

def fingerprint(card: 'AgentCard') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.fingerprint

Stability: alpha

The digest of a card, for pinning a peer to the card that was reviewed.

def fingerprint(card: 'AgentCard') -> 'str'

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.invocation.DEFAULT_MAX_REPORTED_TOKENS

Stability: alpha

int([x]) -> integer int(x, base=10) -> integer

DEFAULT_MAX_REPORTED_TOKENS: int

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.invocation.DEFAULT_PEER_TIMEOUT_SECONDS

Stability: alpha

Convert a string or number to a floating-point number, if possible.

DEFAULT_PEER_TIMEOUT_SECONDS: float

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.invocation.PeerCall

Stability: alpha

One outbound call, as a transport receives it.

class PeerCall(object)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.invocation.PeerClient

Stability: alpha

Calls one peer's skills, typed both ways and inside the caller's run.

class PeerClient(object) {invoke(self, skill: 'str', payload: 'Mapping[str, Any]', *, idempotency_key: 'str | None' = None, deadline_seconds: 'float | None' = None, cancellation: 'CancellationToken | None' = None) -> 'PeerResult'; stream(self, skill: 'str', payload: 'Mapping[str, Any]', *, idempotency_key: 'str | None' = None, cancellation: 'CancellationToken | None' = None) -> 'AsyncIterator[PeerProgress | PeerResult]'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.invocation.PeerInvocationError

Stability: alpha

A peer call that did not produce an answer the caller may use.

class PeerInvocationError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.invocation.PeerInvocationReason

Stability: alpha

Why a peer call was refused, in terms the caller can act on.

class PeerInvocationReason(StrEnum)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.invocation.PeerProgress

Stability: alpha

Something the peer said while it was still working.

class PeerProgress(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.invocation.PeerReply

Stability: alpha

What a transport read off the wire, before anything here has believed it.

class PeerReply(AdkModel)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.invocation.PeerResult

Stability: alpha

A peer's answer, validated against the schema the peer published for it.

class PeerResult(AdkModel) {attributes(self) -> 'dict[str, str]'; redacted(self, *, tenant: 'str' = '') -> 'dict[str, Any]'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.invocation.PeerTransport

Stability: alpha · Kind: Protocol

How a call reaches the peer. Every transport the kit ships lives outside a2a.

class PeerTransport(Protocol) {cancel(self, call: 'PeerCall') -> 'None'; invoke(self, call: 'PeerCall') -> 'PeerReply'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.invocation.StreamingPeerTransport

Stability: alpha · Kind: Protocol

A transport that can also report progress while the peer works.

class StreamingPeerTransport(PeerTransport, Protocol) {stream(self, call: 'PeerCall') -> 'AsyncIterator[PeerProgress | PeerReply]'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.invocation.TraceCarrier

Stability: alpha · Kind: Protocol

Where the caller sits in a trace. observability.W3CContext satisfies it.

class TraceCarrier(Protocol) {carried(self) -> 'dict[str, str]'; child(self, name: 'str', *, attempt: 'int' = 1) -> 'Self'}

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.invocation.UnsupportedSchemaError

Stability: alpha

A published schema uses a keyword conforms does not implement.

class UnsupportedSchemaError(AdkError)

Typed errors: None declared.

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.invocation.checkable

Stability: alpha

Refuse a schema conforms could not hold a payload to, before anything relies on it.

def checkable(schema: 'Mapping[str, Any]', *, path: 'str' = '') -> 'None'

Typed errors: UnsupportedSchemaError

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.

tesserix_adk.a2a.invocation.conforms

Stability: alpha

Whether value satisfies schema, as the empty string or the first violation.

def conforms(value: 'object', schema: 'Mapping[str, Any]') -> 'str'

Typed errors: UnsupportedSchemaError

Runnable recipe: examples/peer_invocation.py — delegated authority only narrows.