Marketplace & Discovery
The marketplace is the catalog layer for installable runtimes.
It is not the shared-tool source of truth. Shared tools are platform-managed. Marketplace items are installable runtimes and templates discovered from registries and tool metadata.
Discovery Flow
Core Endpoints
| Endpoint | Purpose |
|---|---|
GET /api/marketplace/tools | search catalog |
GET /api/marketplace/tools/:id | view one tool |
POST /api/marketplace/tools/:id/install | begin install |
POST /api/marketplace/refresh | refresh catalog |
Install Flow
Config Analysis
The platform supports extracting install-time configuration metadata from tool definitions and registry information. That metadata is used to build install forms and runtime config.
Relationship to Shared Tools
Do not confuse these two:
| Surface | Purpose |
|---|---|
| marketplace | installable user / tenant runtimes |
| shared tools | platform-managed shared integrations |
That split is intentional and is part of the security model.