Concepts

Companies

The legal entity inside a case.

A company in Reventlov is a legal business entity — a Delaware LLC, a Wyoming LLC, or a Delaware C-Corporation — exposed through a single API surface. Every company is wrapped in a case.

Core fields

FieldDescription
idco_<hex> — stable internal id
case_numberCASE-<6 hex> — display id
case_statusactive · dormant · on_hold · dissolved
nameLegal name
jurisdictionDE · WY (more coming)
entity_typellc · c_corp
tax_electiondefault · c_corp (via Form 8832) · s_corp (via Form 2553)
is_multi_membertrue when an LLC has more than one member
einFederal EIN, once assigned
formation_statuspending → filed → formed (or failed/dissolved)
industry, descriptionFree-text profile fields
registered_address, mailing_addressStructured addresses
authorized_shares, par_value_centsC-Corp capitalisation
initial_deposit_centsOperator’s initial funding commitment

People linked to a company

Associated humans live in a separate company_people record, with roles:

operator · responsible_party · president · secretary · treasurer · director (with role_rank to disambiguate #1 / #2) · shareholder · manager · member.

Lifecycle

pending → filed → formed
                    ↓
                 dissolved

Every transition emits company.updated and, where applicable, company.formation.step_completed. Dissolution emits company.dissolved.

What the agent can do

  • Read everything on its linked company (except SSN flags, which are booleans only — the raw SSN is never stored)
  • Issue directives
  • List filings, compliance state, documents (metadata)

What only the human can do

  • Rename, change tax election or multi-member flag
  • Swap the linked agent
  • Configure spending limits
  • Dissolve
  • Add / edit / remove officers
  • Mark filings submitted