Visibility and scopes
Placement and visibility work together. Placement defines ownership; visibility defines the audience.
Visibility levels
| Visibility | Typical audience | Marketplace |
|---|---|---|
| Private | Owner or permitted organization members | No |
| Internal | Members of the owning organization | No |
| Public | Everyone; authenticated users can clone | Yes |
Personal agents support private and public visibility. Internal visibility requires an organization.
Team access is membership-based
A team agent is available only when the caller's active team matches and the caller belongs to that team. Organization membership alone does not grant participation in a team agent.
For organization agents without a team, Better Auth roles and agent:read determine access. Public agents remain readable regardless of scope.
Scope controls configuration and billing
Team agents resolve team configuration, organization agents resolve organization configuration, and personal agents resolve the creator's personal configuration. There is no fallback between scopes.
Personal usage is billed to the user. Organization and team agent usage is billed to the organization; the team is attribution, not a separate billing account.