Agent product reference
Every key of an agent product file and every Verb and Event of each customer's agent, for lookup.
An agent product is a product file with $type: and the Role it names. These tables list what each key holds and every Verb a customer's Agent answers to.
Definition
| Key | Type | Holds | Required | Status |
|---|---|---|---|---|
$type | list | One or more of App, API, Agent, Dataset, Service | required | live |
nouns | Noun names | The Nouns it exposes; a Dataset holds Things of exactly one | live | |
verbs | Verb ids | The Verbs a Customer may call | live | |
interfaces | list | The Interfaces it ships on; every kind by default | live | |
role | Role path | The Role in agents/ its agent fills: instructions, Limits, approvals, channels and eval cases | required | live |
The product file convention shows the keys in a working file.
The Role's own keys (limits, approvals, channels, schedule) are in the Role file reference. An Offer sells the product from an Offer file.
Verbs
| Verb | What it does | Event |
|---|---|---|
Agent.mint | Creates the Customer's agent in its Tenant | Agent.minted |
Agent.pause | Stops one agent, a Team's, or every customer-facing one from starting new Actions | Agent.paused |
Agent.resume | Restarts a paused agent with Memory, Mandates and Limits unchanged | Agent.resumed |
Agent.retire | Takes it out of every seat and keeps its history | Agent.retired |
Tenant.provision | Creates the Customer's Tenant with its Entitlements | Tenant.provisioned |
Mandate.authorize | Grants the agent a standing Mandate for the Customer, within a Limit | Mandate.authorized |
Action.evaluate | Grades one piece of work and records the verdict | Action.evaluated |
Approval.approve | Lets a waiting Action run | Approval.approved |
Each Verb is on the API, SDK, CLI and MCP server: API, SDK, CLI, MCP.
Capabilities without a Verb
| Capability | What it adds | Proposed Verb |
|---|---|---|
| Agent upgrades | A Customer's agent moves to a new Version after its own cases pass on it | Agent.upgrade |
| Tenant rules | A Customer teaches its own agent a rule that binds only that Tenant | Agent.teach |
| Agent-to-agent tasks | An outside agent hands a Task over the agent-to-agent protocol | None |
A capability with status planned has no Verb, so no guide offers it and no agent promises it.