Skip to content

Marketplace — workflows

Target

This page describes intended behaviour or structure. No implementation is claimed unless a section is explicitly marked Current implementation or Evidence.

Rewritten 2026-10-09 (design plan P14)

The June-2026 page (asset publishing flow, installation state machine) is archived under catalogs 2026-06; publishing is now the Control plane's publication flow, and installation is a scoped reference.

W1 — A publisher is certified

A partner organization applies with its agreement and identity; Platform admin certifies (publication class) with evidence; only then may it list publicly. ConnectSoft is the first certified publisher.

W2 — A Published release becomes a listing

sequenceDiagram
    participant M as Asset maintainer (publisher)
    participant AR as AgentRegistryService
    participant C as MarketplaceCatalogService
    participant RC as RunControlService
    AR-)C: AssetReleasePublished (agent 1.4.0 with evidence)
    M->>C: CreateListing (release, compatibility, documents, visibility Public)
    M->>C: SubmitListing
    C->>RC: approval (publication class, Platform admin)
    RC-)C: ApprovalDecided
    C-)M: ListingPublished
Hold "Alt" / "Option" to enable pan & zoom

W3 — A tenant acquires and installs

sequenceDiagram
    participant WA as Workspace admin (tenant T)
    participant L as LicenseService
    participant FC as FactoryCommercialService
    participant RC as RunControlService
    participant C as MarketplaceCatalogService
    participant AR as AgentRegistryService
    WA->>L: AcquireListing (per-seat plan, 10 seats)
    L->>FC: subscription active? edition allows? add billing line
    alt above the spend threshold
        L->>RC: approval (spend class)
        RC-)L: ApprovalDecided
    end
    L-)C: EntitlementGranted
    WA->>C: InstallListing (project P)
    C->>AR: scoped release reference in T's registry
    C-)WA: ListingInstalled
Hold "Alt" / "Option" to enable pan & zoom

W4 — A newer release offers an update

AssetReleasePublished for a listed asset moves the listing to the new release and marks every installation updateAvailable; tenants whose policy allows auto-update are updated by the UpdateOfferer, the rest accept in the Studio. Runs keep their pinned snapshots either way.

W5 — A release is revoked

AssetReleaseRevoked delists immediately, revokes entitlements where the revocation is for cause, notifies installing tenants, and the registry refuses new runs on the revoked release; running attempts complete on their pinned snapshot.

W6 — A subscription lapses

SubscriptionChanged to suspended suspends the tenant's entitlements; installations stay; policy refuses new runs using the suspended assets; restoring the subscription restores them with no re-installation.