Agent and listing lifecycle
The path from a draft workflow to a live listing, and what can change afterwards.
An agent moves through fixed stages. Each stage produces something that does not change afterwards, so buyers always know exactly what they are running.
Stages#
| Stage | What exists | Where |
|---|---|---|
| Draft | An editable workflow. Nothing is fixed. | Studio → Build |
| Version | A fixed copy of the workflow with a manifest hash. It never changes. | Studio → Versions |
| Tested version | A version with at least one completed private test run. | Studio → Test |
| Submitted | A tested version sent for review with its platform test results. | Studio → Review |
| Reviewed | Approved (or rejected, paused, revoked) by a platform operator. | Studio → Review |
| Listing | A published version with a price per currency, topics and a visibility. | Studio → Publish |
A version can be published without operator review; buyers then see it as Creator test only, without the Tested on listed cases badge.
Changing a live agent#
| You want to | Do this |
|---|---|
| Change what the agent reads or reports | Create a new version, test it, submit it, publish it. The old listing links to the new version. |
| Change the price | Revise the price on the listing. Quotes already issued keep their price. |
| Accept another currency | Add the currency to the listing with its own price. |
| Stop new runs for a while | Pause the listing, then Resume. |
| Remove it permanently | Delist it. This cannot be undone. |
| Hide it from browse and search | Set visibility to Unlisted or Hidden. |
| Update topics | Edit the listing's topics. |
Status changes need a reason, which is recorded. See Listing lifecycle for the creator's view.
What never changes#
- A saved version's manifest and hash.
- Reports, evidence and receipts of past runs.
- The terms of a quote once issued.