Skip to content

Console — Marketplace

The Marketplace section of the operator console surfaces marketplace artifacts (ADR 0012) and their install-state for the current tenant.

Catalog (/marketplace)

views/marketplace/catalog/index.tsx lists one section per registered artifact kind (app, provider-config, harness, mcp-tool, skill, skillset, cloud-provider):

  • Apps — installed apps from the gateway installedApps query with status badges and Enable / Disable / Uninstall actions (backed by the enableApp / disableApp / uninstallApp mutations). Install new apps via the App Store at /store.
  • Harnesses — installed harness artifacts from listHarnesses; full import/create/delete management lives at /marketplace/harnesses.
  • Cloud providers — shows default-installed core adapters. Core artifacts (currently cloudflare) render a locked badge; uninstall and disable are unavailable for them because they are platform-managed.
  • Remaining kinds display a placeholder until the backend exposes per-kind listing queries.

Navigation: sidebar entry Marketplace → /marketplace, with links to the App Store and the harness manager.

Harnesses (/marketplace/harnesses)

Import harness JSON, create harnesses interactively, or delete installed harness artifacts. See ADR 0012 wave M-3-C.

Mounted apps (/apps/:appId)

Installed app-kind artifacts with a vendored console surface render at /apps/<appId> (sidebar group Applications). The artifact’s views are compiled into the console build (ADR 0013 build-time vendoring); the shell shows explanatory notices when an app id is not vendored or not installed. Lifecycle state (install/enable) is shared through the app-registry provider (providers/app-registry.tsx) backed by the availableApps / installedApps queries and the five lifecycle mutations including updateAppConfig.