Skip to main content

Release notes

Platform-level changelog for marketplace-fleapoai-service, fleapo-marketplace, and this docs site. Per-agent changelogs are on each agent's detail page.

How to read this page​

  • Breaking — clients of the API or contributors to the repos must change something.
  • Added — new endpoints, fields, or capabilities. Backwards-compatible.
  • Changed — existing behavior tuned. Usually backwards-compatible; flagged if not.
  • Fixed — bugs.
  • Removed — only on major version bumps.

Unreleased​

(in flight as of writing)

Added​

  • marketplace-docs site — this site. Spec auto-sync, Mermaid diagrams, local search.
  • "Add a New Agent" three-track guide.
  • Concept pages for every domain object.
  • Flow pages with sequence diagrams for every user-visible operation.

Notes​

  • The first release of these docs is dated 2026-05-14.

v1.0 — Initial public catalog​

(historical reconstruction; check git history for exact dates)

Added​

  • agents table + CRUD endpoints.
  • agent_capabilities, agent_steps, agent_changelog, tags, agent_tags.
  • Agent detail page with hero, capabilities, steps, pricing tiers.
  • better-auth integration: signup, signin, sessions, admin plugin.
  • OIDC provider plugin: /api/auth/oauth2/*, JWKS at /api/auth/jwks.
  • Stripe integration: Product + Price creation, Checkout Sessions, webhook handler.
  • user_agent_subscriptions with status enum and Stripe-driven lifecycle.
  • agent_pricing_tiers with isFree + Stripe IDs.
  • agent_metric_definitions, tier_metric_quotas, subscription_usage, subscription_addons, usage_ledger.
  • Atomic consume / release endpoints under /me/agents/:agentId/usage.
  • reviews, agent_installs, agent_waitlist.
  • interactions table + interaction_recipients for admin email fanout.
  • PostHog audit log middleware + batch service.
  • Admin SPA: /admin/agents, /admin/interactions, AdminAgentSubmit, AdminAgentEdit.
  • Frontend Orval-generated API client.
  • Cloudflare Pages deployment for the marketplace UI.

Conventions for this changelog​

  • Group by version, then by category (### Added, ### Changed, etc.).
  • Always show a date.
  • Cross-link to a PR when possible.
  • Breaking changes always at the top of their version.

Adding an entry​

## v1.3.0 — 2026-06-15

### Added
- `POST /admin/usage/:subscriptionId/:metricId/addon/grant-batch` — bulk addon grants for support flows. Closes #142.

### Changed
- `POST /me/agents/:agentId/usage/:metricSlug/consume` now requires `metadata.sessionId` for `sessions` metric specifically. (#150)

### Fixed
- Stripe webhook retry no longer double-creates `subscription_created` interactions. (#161)

Open a PR to marketplace-docs whenever you ship platform changes worth telling integrators about.