# Lexicons matching `org.simocracy`

**4** lexicon(s) found.

## org.simocracy.agents

- **Lexicon Version:** 1

### main (record)

A sim's constitution and agent configuration. One document per sim.

**Record Key:** `tid`

**Properties:**

- `sim`: ref → com.atproto.repo.strongRef
  Reference to the sim record this constitution belongs to
- `createdAt`: string (datetime)
  Timestamp when the record was created
- `description`: string
  Full constitution text: beliefs, values, governance positions. Rich text annotations may be provided via descriptionFacets.
  Constraints: maxLength: 30000, maxGraphemes: 3000
- `shortDescription`: string
  Short summary of this sim's constitution, suitable for previews and list views. Rich text annotations may be provided via shortDescriptionFacets.
  Constraints: maxLength: 3000, maxGraphemes: 300
- `descriptionFacets`: array
  Rich text annotations for description (mentions, URLs, hashtags, etc).
  Array of:
    - `item`: ref → app.bsky.richtext.facet
- `shortDescriptionFacets`: array
  Rich text annotations for shortDescription (mentions, URLs, hashtags, etc).
  Array of:
    - `item`: ref → app.bsky.richtext.facet

**Required:** sim, shortDescription, createdAt


---

## org.simocracy.defs

- **Lexicon Version:** 1

### spriteSettings (object)

**Properties:**

- `selectedOptions`: unknown
  Map of part name -> sprite path
- `partColorSettings`: unknown
  Map of part name -> {red, green, blue, alpha}
- `currentAnimDirection`: integer
  0=right, 1=back, 2=left, 3=front

**Required:** selectedOptions


---

## org.simocracy.gathering

- **Lexicon Version:** 1

### main (record)

A governance or funding event that users can create and participate in.

**Record Key:** `tid`

**Properties:**

- `url`: string
  External link (e.g. Luma registration page)
  Constraints: maxLength: 5000
- `name`: string
  Display name of the event
  Constraints: maxLength: 3000, maxGraphemes: 300
- `dates`: string
  Human-readable date range (e.g. March 14-15, 2026)
  Constraints: maxLength: 1000, maxGraphemes: 100
- `image`: blob
  Cover image for the event (ATProto blob)
- `status`: string
  Current status of the gathering
- `context`: string
  Background / briefing material for sims participating in this event. Shown to AI sims as event context so they can act efficiently (e.g. prior decisions, mission, constraints, data, links). Unbounded — length constrained only by ATProto's per-record size limit.
- `simSize`: string
  Size of sim avatars in this gathering's world. large=48px, normal=32px (senate default), small=20px (ftc-sf default).
- `appRoute`: string
  Internal app route path (e.g. /senate, /ftc-sf) for built-in events
  Constraints: maxLength: 1000
- `location`: string
  Physical or virtual location
  Constraints: maxLength: 3000, maxGraphemes: 300
- `simScope`: string
  Which sims walk around in this gathering's world. council=only appointed council sims (default), all=every sim in Simocracy.
- `createdAt`: string (datetime)
  Timestamp when the record was created
- `councilSims`: array
  Array of StrongRefs to sim records appointed to this gathering's council by the event creator.
  Constraints: maxLength: 50
  Array of:
    - `item`: ref → com.atproto.repo.strongRef
- `description`: string
  Full event description with details, agenda, etc.
  Constraints: maxLength: 30000, maxGraphemes: 3000
- `treasuryUsd`: integer
  Optional agentic treasury amount in USD that the council governs.
  Constraints: min: 0
- `collectionUri`: string
  AT-URI of an org.hypercerts.collection record for this gathering's proposals.
  Constraints: maxLength: 5000
- `contextFacets`: array
  Rich text facets for context
  Array of:
    - `item`: ref → app.bsky.richtext.facet
- `gatheringType`: string
  Type of gathering
- `proposalScope`: string
  Who can submit proposals to this gathering. council=only users who own at least one sim on the appointed council (event creator always allowed), all=anyone signed in (default).
- `buildingImageUrl`: string
  URL of the building/venue image for this gathering. Can be an absolute URL or a path relative to the app (e.g. /senate.png, /frontiertower.webp).
  Constraints: maxLength: 5000
- `shortDescription`: string
  Brief summary for cards and previews
  Constraints: maxLength: 3000, maxGraphemes: 300
- `descriptionFacets`: array
  Rich text facets for description
  Array of:
    - `item`: ref → app.bsky.richtext.facet
- `allocationMechanism`: string
  The mechanism used to allocate the treasury among proposals.
- `shortDescriptionFacets`: array
  Rich text facets for shortDescription
  Array of:
    - `item`: ref → app.bsky.richtext.facet
- `suggestedInterviewTemplates`: array
  Optional: interview templates this gathering suggests to prospective council members.
  Constraints: maxLength: 5
  Array of:
    - `item`: ref → com.atproto.repo.strongRef

**Required:** name, gatheringType, status, createdAt


---

## org.simocracy.interview

- **Lexicon Version:** 1

### main (record)

An interview transcript for a sim — captures voice answers and value positions to derive the sim's constitution and speaking style.

**Record Key:** `tid`

**Properties:**

- `sim`: ref → com.atproto.repo.strongRef
  Reference to the sim record this interview is about
- `template`: ref → com.atproto.repo.strongRef
  Optional reference to the template this interview answered.
- `createdAt`: string (datetime)
  Timestamp when the interview was completed
- `openAnswers`: array
  Open-ended question answers, transcribed from voice recordings.
  Array of:
    - `item`: ref → #openAnswer
- `yesNoAnswers`: array
  Yes/no value statement responses.
  Array of:
    - `item`: ref → #valueResponse

**Required:** sim, openAnswers, yesNoAnswers, createdAt

### openAnswer (object)

A single open-ended interview answer.

**Properties:**

- `answer`: string
  The transcribed voice answer
  Constraints: maxLength: 30000, maxGraphemes: 3000
- `question`: string
  The interview question that was asked
  Constraints: maxLength: 1000
- `questionId`: string
  Stable ID linking this answer to a question in the template.
  Constraints: maxLength: 64

**Required:** question, answer

### valueResponse (object)

A yes/no response to a value statement.

**Properties:**

- `answer`: boolean
  Whether the interviewee agreed (true) or disagreed (false)
- `statement`: string
  The value statement presented
  Constraints: maxLength: 1000
- `questionId`: string
  Stable ID linking this answer to a question in the template.
  Constraints: maxLength: 64

**Required:** statement, answer


---
