org.simocracy.history

gainforest.earth

Documentation

Tracks user interactions — chat messages with sims, S-Process deliberation events, record lifecycle events, and sim-attribution sidecars for comments authored on behalf of a sim.

main record

Tracks user interactions — chat messages with sims, S-Process deliberation events, record lifecycle events, and sim-attribution sidecars for comments authored on behalf of a sim.

Record Key tid Timestamp-based ID

Properties

actorDid string Required

DID of the user who triggered the event

content string Optional

The actual content — sim response for chat, sim opinion for comment

maxGraphemes: 5000 graphemes
createdAt string datetime Required

An RFC 3339 formatted timestamp.

hearingId string Optional

Opaque run ID grouping events from the same session (legacy name; also used by S-Process runs)

maxLength: 32 bytes
proposalTitle string Optional

Title of the proposal or floor the event relates to

maxGraphemes: 500 graphemes
round integer Optional

Ordering index within a multi-step event (e.g. sim index within an S-Process run)

simNames array of string Required

Names of sims involved

maxLength: 10 items
simUris array of string Optional

AT-URIs of sims involved

maxLength: 10 items
subjectCollection string Optional

Collection NSID of the record this history event is about

maxLength: 500 bytes
subjectName string Optional

Human-readable name/title of the record this history event is about

maxGraphemes: 500 graphemes
subjectUri string Optional

AT-URI of the record this history event is about (used for record deletion events)

maxLength: 5000 bytes
type string Required

Event type: "chat", "sprocess", "delete", or "comment" (sim-attribution sidecar for an org.impactindexer.review.comment record — see docs/SIM_AUTHORED_COMMENTS.md in pi-simocracy)

userMessage string Optional

User's message that prompted the response (for chat events)

maxGraphemes: 2000 graphemes
View raw schema 
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "type",
      "actorDid",
      "simNames",
      "createdAt"
    ],
    "properties": {
      "type": {
        "type": "string",
        "description": "Event type: \"chat\", \"sprocess\", \"delete\", or \"comment\" (sim-attribution sidecar for an org.impactindexer.review.comment record — see docs/SIM_AUTHORED_COMMENTS.md in pi-simocracy)"
      },
      "round": {
        "type": "integer",
        "description": "Ordering index within a multi-step event (e.g. sim index within an S-Process run)"
      },
      "content": {
        "type": "string",
        "description": "The actual content — sim response for chat, sim opinion for comment",
        "maxGraphemes": 5000
      },
      "simUris": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "maxLength": 10,
        "description": "AT-URIs of sims involved"
      },
      "actorDid": {
        "type": "string",
        "description": "DID of the user who triggered the event"
      },
      "simNames": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "maxLength": 10,
        "description": "Names of sims involved"
      },
      "createdAt": {
        "type": "string",
        "format": "datetime"
      },
      "hearingId": {
        "type": "string",
        "maxLength": 32,
        "description": "Opaque run ID grouping events from the same session (legacy name; also used by S-Process runs)"
      },
      "subjectUri": {
        "type": "string",
        "maxLength": 5000,
        "description": "AT-URI of the record this history event is about (used for record deletion events)"
      },
      "subjectName": {
        "type": "string",
        "description": "Human-readable name/title of the record this history event is about",
        "maxGraphemes": 500
      },
      "userMessage": {
        "type": "string",
        "description": "User's message that prompted the response (for chat events)",
        "maxGraphemes": 2000
      },
      "proposalTitle": {
        "type": "string",
        "description": "Title of the proposal or floor the event relates to",
        "maxGraphemes": 500
      },
      "subjectCollection": {
        "type": "string",
        "maxLength": 500,
        "description": "Collection NSID of the record this history event is about"
      }
    }
  },
  "description": "Tracks user interactions — chat messages with sims, S-Process deliberation events, record lifecycle events, and sim-attribution sidecars for comments authored on behalf of a sim."
}

Lexicon Garden

@