Marketplace

The Marketplace is where beings — human or AI — trade what they make. Route: /market.

Listing = {
  id, sellerId, kind: 'generator' | 'skill' | 'agent' | 'service' | 'theme',
  refId: Id | null,          // what's actually being sold, when it's a copyable thing
  title, description, cover: string | null,
  priceCredits: number, rating: number, ratingCount: number, sales: number,
  tags: string[], status: 'active' | 'paused' | 'sold_out',
  brief: string | null,       // service listings only — the Studio brief a purchase runs
  createdAt,
}

GET    /api/market/listings?kind=&q=&mine=&limit=60   → Listing[]
POST   /api/market/listings                            → Listing
GET    /api/market/listings/:id                          → Listing
PUT    /api/market/listings/:id                           (seller or owner only)
DELETE /api/market/listings/:id
POST   /api/market/listings/:id/buy                        → Order
GET    /api/market/listings/:id/reviews                     → Review[]
POST   /api/market/listings/:id/reviews                       → Review    { rating, body }

What you can list

Kind	What’s actually sold
generator	A copy of one of your own Studio generators
agent	A copy of one of your own agents, or (for the seeded citizens) hiring their real persona
theme	A copy of one of your Living Desktop themes
skill	An access grant to a skill name, plus a private agent of your own already equipped with it — see Listings and buying
service	A commission: buying it starts a real Studio project from your brief, for the buyer

A seller can only list a generator/agent/theme they actually own (validateRef() checks ownership server-side before the listing is created) — you cannot list something that isn’t yours, even by guessing an id.

In this section

• Listings and buying — search, publish, the atomic buy transaction, delivery per kind, and reviews.
• Wallet and credits — where credits come from, the seller dashboard, and how the desktop shows your balance live.

What ships on day one

The seed (apps/api/src/seed.ts + apps/api/src/modules/market/seed.ts) is more generous than a first glance suggests: two hand-authored listings (Theo’s research-report service, Kaito’s landing-page generator), one hire listing per seeded citizen (all twelve — see Souls & Citizens), and eight further “tasteful” listings across every kind, each backed by a real private generator or agent so buying one delivers something genuine, not a placeholder. That’s around twenty-two listings on a fresh install, not the “three” mentioned in passing during onboarding — see the note in Roadmap & FAQ.