Setup card¶
A setup card is the public page for one catalog setup. A setup is the complete configuration of one harness: exact component pins, not a folder of current files. Replacing any pin is a new setup version.
The page shows that graph. It does not compose, update, or apply it.
URLs and who can see them¶
| Projection | URL | Who can see it |
|---|---|---|
| Human | /{locale}/catalog/setups/{stable_id} |
anyone |
| Machine | /{locale}/ai/catalog/setups/{stable_id} |
anyone |
| Human version | /{locale}/catalog/setups/{stable_id}/versions/{version} |
anyone |
| Machine version | /{locale}/ai/catalog/setups/{stable_id}/versions/{version} |
anyone |
{stable_id} must be a setup id. A component id 404s. Unknown,
blocked, or unpublished setups 404 without saying which.
Anyone can read a public setup. Like and report need a session. There is no presentation editor for setups on the website: bio and media edit is a component-owner flow.
What this screen is for¶
Use the card to inspect the composition you might later select:
- target harness;
- purpose, posture, target role (role may be absent);
- every pinned component with its exact
X.Y; - aggregated requirements of the setup plus its pins;
- potential context budget of the whole graph;
author_verifiedandcomponent_verifiedon the setup version.
The card does not:
- run
setup compose,select propose, orinstall apply; - substitute a newer component for you;
- write native files into the harness;
- treat listed regional services as exclusive markets.
A third-party component inside the graph keeps its own publisher. The setup author is not automatically the author of every pin.
What is on the screen¶
Back to catalog returns to
/{locale}/catalog?include_experimental=1&resource=setups.
Header¶
| Element | What it shows |
|---|---|
| Icon | setup artwork, not a component-type glyph |
| Title | latest_name |
| Badges | Setup, named harnesses |
| Version | v{latest_version} |
| GitHub stars / Archived | when metadata exists |
| View source | passport source when declared |
Actions match the component card: Like, Copy URL, Copy ID, Copy CLI
command, Report setup. The CLI line uses --kind setup. Report opens
/{locale}/reports?object_kind=setup&stable_id=…&version=…&digest=….
Relationships and body¶
Countries and linked services are related, not exclusive.
The main column:
| Block | Content |
|---|---|
| Description | passport or catalog text |
| Technical details | lifecycle, published at, primary harness, SPDX license |
| Composition | exact components this setup includes |
| Aggregated requirements | union of setup and pin requirements |
Each composition row names:
stable_idand pinnedversion;- component type;
- owner / author (may differ from the setup publisher);
- third-party source mark when the pin is not first-party;
- link to the public component card when the pin is in the catalog.
A pin that cannot be loaded is omitted from the live table rather than shown as a guessed type. That is a dead-end for that member, not a license to invent it.
The rail:
| Block | Content |
|---|---|
| Author | setup publisher, author_verified |
| Usage | detail views, artifact downloads |
| Context budget | potential tokens for always-loaded vs on-use members |
| CLI copy | everyday task start --intent install under Use via CLI; inspect copy of ai-stp registry version --kind setup --id … --version … |
| Version history | offered X.Y; gaps are intentional |
Public passport JSON is the setup passport, including the pin list. Copy it; do not paste secrets into it.
Context budget¶
The panel estimates potential context, not actual model usage. A rate you type for a cost estimate stays in the browser. No pricing API is called. Runtime-integrated members say that package bytes would be misleading.
Always-loaded members are included every time the setup loads. Conditional members are added only when the agent uses them.
Trust on a setup¶
author_verified on the setup is the setup publisher. Each pin has its
own pair of axes on its component card. A verified setup author does
not verify a third-party MCP inside the graph. The setup_pin_aggregate
check joins exact pins and their published check summaries; it is not
a substitute for reading a failed pin.
Matching CLI commands¶
Everyday install:
Expert catalog reads and local impact:
ai-stp registry show --kind setup --id <stable_id> --json
ai-stp registry version --kind setup --id <stable_id> --version <x.y> --json
ai-stp registry acquire --json
ai-stp select impact --setup-id <stable_id> --setup-version <x.y> --json
ai-stp link web --json
registry acquire fetches one exact published setup graph for local
offline compilation. select impact compares context, token cost, and
capabilities of exact local setup versions — the website only
copies the command.
Those pages: Setup commands, Select, Install.
Dead-ends¶
| What you see | What it means | What to do |
|---|---|---|
Page not found |
bad setup id or not public | Catalog with resource=setups |
| Composition row missing | that pin could not be read | open the version page; do not fill the hole from memory |
| No tokenized components | budget empty | run select impact locally |
| Context budget error | exact artifact unavailable | fetch first (registry acquire / registry fetch) |
| Report missing digest | no passport digest on latest | open /versions/{version} |
| Like requires sign-in | no session | Sign-in |
| Install from the browser | not offered | copy CLI, then task start --intent install |
Machine projection lists purpose, target role (or its absence), posture, pins, trust lane, and the two verified bits. It does not render the composition gallery.
Related pages¶
- Catalog — Both-mode shows setups first.
- Component card — each pin.
- Setups — how a graph is assembled in the CLI.
- Concepts — setup belongs to one harness.
- Trust and safety — pins do not inherit author verification.
- Registry — show, version, acquire.
- Provider — the only writer of native state.
A setup is a pin list
If the author updated one skill or disabled a hook, that is a
new X.Y. The card you are reading is one immutable graph.