@tutti-os/commerce

Host-neutral Commerce contracts, policies, visual assets, and React presentation for Tutti products.

The package does not fetch APIs or own authentication, feature flags, navigation, clipboard, notifications, Electron, or VM state. Product hosts provide normalized data, labels, links, and callbacks.

The Account shell (avatar, popover, sign-in/out, settings, and UID copy) belongs to each Host. CommerceMenuContent renders only membership, credits, and account-center rows. AgentConfigCommerceContent is the compact account, clickable credits balance with inline refresh, membership, and account-center presentation for an Agent config menu. Clicking Credits opens the Host-provided usageUrl. The Host still supplies the account name, state, labels, refresh command, and navigation.

Host actions may be asynchronous. CommerceMenuContent catches rejected external-link actions and forwards them to the optional onActionError callback; the Host owns user-facing failure notification.

import {
  resolveInsufficientCreditsSemantic,
  resolveMembershipAction
} from "@tutti-os/commerce";
import {
  AgentConfigCommerceContent,
  CommerceMenuContent,
  MembershipTierIcon
} from "@tutti-os/commerce/react";

basic is the canonical tier key for the Basic plan. It intentionally maps to the existing Lite visual asset for parity with the Tutti desktop product.