Provider

An approval provider is the service that decides whether a proposed tool call may run. It receives requests from adapters, records their outcomes and makes those outcomes available for enforcement.

A single provider can serve many agent instances across different harnesses. This gives a deployment one place to apply approval policies and review proposed actions.

How decisions are made

AAP does not specify what a provider may do to get an approval, this is a choice to be made by the provider itself. This flexibility allows different AAP providers to cater to different needs.

For example, A provider can apply a policy automatically, ask a human to review the request or combine several steps. It might approve a routine lookup immediately and hold a refund for review.

AAP defines the request, the outcome and how they are exchanged. The provider chooses its review process and interface.

The provider records permission to execute. The adapter enforces that permission, and the harness or adapter tracks whether execution has happened.

flowchart TD
    accTitle: Multiple adapters share an approval provider
    accDescr: Adapters for different agent instances submit requests to one approval provider. The provider chooses its own review process, such as policy checks, human review or a combination, and records one terminal outcome per request. Each outcome is returned to the requesting adapter, which enforces it before execution.
    First[Instance A adapter] --> Review
    Second[Instance B adapter] --> Review
    subgraph Provider[Approval provider]
        Review[Provider's chosen review process] --> Outcome[Record one terminal outcome per request]
    end
    Outcome --> Enforce[Requesting adapter enforces the outcome]

Instances and access

The provider assigns each instance an identity and a credential. It derives the requesting instance's identity from that credential and authorizes access to its requests.

A separate provisioner token manages instances and their delivery configuration. This lets a platform create credentials for its agents without giving those agents instance management access.

Recording an outcome

The provider preserves the submitted tool and arguments and records one terminal outcome for each request. A request can be pending whilst review continues, then become approved, denied, expired or cancelled.

Two deadlines serve different purposes. deadline_at limits the time available to decide. An approved decision's expires_at limits the time available to start the call. Reading an approval again does not extend its validity.

Retries with the same idempotency key recover the existing request. They do not create another approval or authorize another execution attempt. See requests and decisions for the full lifecycle.

Returning the result

Every provider supports request creation, retrieval, long polling and cancellation. It can return a decision immediately or let the adapter wait through synchronous polling.

A provider that supports asynchronous mode also verifies configured receivers and sends signed webhook notifications when requests reach a terminal outcome. The notification prompts the adapter to retrieve the decision through the authenticated API; it carries no permission to execute.

Read the approval flow to see how a provider and adapter work together, or the provider requirements for the complete conformance rules.