The event log

A meeting is not stored as a transcript. It is stored as the list of things that happened: a line was heard, someone said who spoke it, a line was edited, that was undone. The transcript and the receipt are what you get by replaying the list. That is why a bundle loses nothing: it holds the history, not a summary of it.

Every event

{
  "id": "01927f3a-0000-7000-8000-000000001006",
  "meetingId": "01927f3a-0000-7000-8000-000000000001",
  "at": 1791561609000,
  "type": "SpeakerAssigned",
  "lineIds": [
    "01927f3a-0000-7000-8000-000000000101"
  ],
  "participantId": "01927f3a-0000-7000-8000-000000000011"
}

Field	Type	Meaning
`id`	string	This event's id
`meetingId`	string	The meeting it belongs to. The same on every event in a file
`at`	number	When it happened, in milliseconds since 1970 (UTC)
`type`	string	One of the types below

Ids are UUIDs written in lowercase with hyphens: 8-4-4-4-12 hex digits. Chitmonk makes version 7 UUIDs, which sort by time. Any lowercase UUID is accepted.

Two clocks. at is the wall clock. startMs and endMs on a line are milliseconds into the recording, with pauses left out, so they line up with the audio file.

Extra fields are allowed on any event, kept, and written back out.

Replaying a log

Collect the targetId of every EventUndone. Those events did not happen: skip them. An undo is final: undoing an EventUndone does not bring its target back.
Apply the rest in the order they appear in the file.
The result is the meeting as it stands.

Two rules decide what you may show as fact:

A speaker is confirmed only by a person. A line has a confirmed speaker if a SpeakerAssigned named it, or if it arrived with a speakerId (the person had already chosen who was talking). A suggestedSpeakerId is the app's guess from the sound of the voice. Show it as a guess: Chitmonk writes it as Maya?.
An action item or decision is accepted only by a person. Until an ActionAccepted or DecisionAccepted, it is a suggestion found by phrase rules.

The events

The meeting

Type	Fields	What it does
`MeetingCreated`	`schema`, `title`, `language`, `privacyMode`, `engine`, `vocabulary`, `ephemeral`?	Always first. Sets the title and settings; its `at` is when the meeting was created
`MeetingRenamed`	`title`	Replaces the title
`RecordingStarted`		Recording begins, or resumes after a pause
`RecordingPaused`		Recording pauses
`MeetingEnded`		Recording stops for good; its `at` is when the meeting ended
`MeetingDeleted`		Marks the meeting deleted. Not normally found in an export
`EventUndone`	`targetId`	The event with that id is skipped when replaying

In MeetingCreated: schema is 1. language is auto or one of en, de, fr, es, it, nl, pl. privacyMode is transcript-only or audio-retained. engine says what made the transcript, as { "stt", "sttVersion", "runtime", "vad", "speaker" }, all strings except speaker, which is a string or null. vocabulary is up to 200 words the meeting was told to listen for.

The meeting's length is the time between each RecordingStarted and the RecordingPaused or MeetingEnded that follows it, added up.

People

Type	Fields	What it does
`ParticipantAdded`	`participantId`, `name`, `pronouns`?	Adds a person, after the ones already there
`ParticipantUpdated`	`participantId`, `name`?, `pronouns`?	Changes what is given. `pronouns: null` removes them
`ParticipantReordered`	`order`	The new order, as a list of participant ids. Anyone left out goes last
`ParticipantRemoved`	`participantId`	The person leaves the list, but lines they spoke keep their name

A person's position in the list is the number key that means them during a meeting.

The transcript

Type	Fields	What it does
`SegmentCommitted`	`lineId`, `text`, `words`, `startMs`, `endMs`, `language`, `turnId`, `suggestedSpeakerId`?, `speakerId`?	Adds a line at the end of the transcript
`SpeakerAssigned`	`lineIds`, `participantId`	A person says who spoke those lines. `null` means "nobody on the list", on purpose
`TranscriptLineEdited`	`lineId`, `text`	Replaces the line's words. The words first heard are still in its `SegmentCommitted`
`TranscriptLineDeleted`	`lineId`	Removes the line

In SegmentCommitted: language is the language heard on that line. turnId groups lines from one unbroken stretch of the same voice. words is a list of { "w", "s", "e", "p" }: the word, its start and end in recording milliseconds, and the model's probability for it. It may be empty.

SpeakerAssigned also clears any guess on those lines. If an action item took its owner from the speaker of one of them, the owner changes with it.

Action items and decisions

The two families are the same shape. Replace Action with Decision.

Type	Fields	What it does
`ActionSuggested`	`itemId`, `lineId`, `text`, `ownerId`?, `ownerFromSpeaker`?, `dueText`?, `dueDate`?	Adds an item, not yet accepted
`ActionEdited`	`itemId`, `text`?, `ownerId`?, `dueText`?, `dueDate`?	Changes what is given. `null` clears an owner or a due date
`ActionAccepted`	`itemId`	A person accepts it
`ActionDeleted`	`itemId`	Removes it

lineId is the line it was found in, or null for one a person typed. dueText is the words as spoken ("by Friday"). dueDate is YYYY-MM-DD, set only when the words pin down a single day. ownerFromSpeaker: true means the owner is whoever spoke the line, and follows a later SpeakerAssigned; an ActionEdited that sets ownerId ends that.

Side notes

Type	Fields	What it does
`NoteAdded`	`noteId`, `lineId`, `text`	Adds a note beside a line, or beside the meeting if `lineId` is `null`
`NoteEdited`	`noteId`, `text`	Replaces its words
`NoteDeleted`	`noteId`	Removes it

A note never changes the line it sits beside.

The sample, start to finish

This is the whole event log in the sample bundle. It has a confirmed speaker, a guessed one, an unknown one, an undo, an edit, a note, an accepted action item and a suggested one.

{
  "schema": 1,
  "events": [
    {"id":"01927f3a-0000-7000-8000-000000001000","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561600000,"type":"MeetingCreated","schema":1,"title":"Launch review","language":"en","privacyMode":"transcript-only","engine":{"stt":"Cactus Whistle","sttVersion":"2.0.0","runtime":"Cactus needle3 (WebAssembly)","vad":"Silero VAD v5","speaker":"3D-Speaker CAM++"},"vocabulary":["Chitmonk"]},
    {"id":"01927f3a-0000-7000-8000-000000001001","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561601000,"type":"ParticipantAdded","participantId":"01927f3a-0000-7000-8000-000000000011","name":"Maya"},
    {"id":"01927f3a-0000-7000-8000-000000001002","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561602000,"type":"ParticipantAdded","participantId":"01927f3a-0000-7000-8000-000000000012","name":"Leo"},
    {"id":"01927f3a-0000-7000-8000-000000001003","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561603000,"type":"ParticipantAdded","participantId":"01927f3a-0000-7000-8000-000000000013","name":"Sam","pronouns":"they/them"},
    {"id":"01927f3a-0000-7000-8000-000000001004","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561604000,"type":"RecordingStarted"},
    {"id":"01927f3a-0000-7000-8000-000000001005","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561608000,"type":"SegmentCommitted","lineId":"01927f3a-0000-7000-8000-000000000101","text":"Okay, let us get started. Thanks everyone for joining the launch review.","words":[],"startMs":1000,"endMs":6000,"language":"en","turnId":"01927f3a-0000-7000-8000-000000000201"},
    {"id":"01927f3a-0000-7000-8000-000000001006","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561609000,"type":"SpeakerAssigned","lineIds":["01927f3a-0000-7000-8000-000000000101"],"participantId":"01927f3a-0000-7000-8000-000000000011"},
    {"id":"01927f3a-0000-7000-8000-000000001007","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561613000,"type":"SegmentCommitted","lineId":"01927f3a-0000-7000-8000-000000000102","text":"Sounds good. The checkout tests passed last night, so the build is ready.","words":[],"startMs":7000,"endMs":12000,"language":"en","turnId":"01927f3a-0000-7000-8000-000000000202"},
    {"id":"01927f3a-0000-7000-8000-000000001008","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561614000,"type":"SpeakerAssigned","lineIds":["01927f3a-0000-7000-8000-000000000102"],"participantId":"01927f3a-0000-7000-8000-000000000012"},
    {"id":"01927f3a-0000-7000-8000-000000001009","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561618000,"type":"SegmentCommitted","lineId":"01927f3a-0000-7000-8000-000000000103","text":"Great. I will send the revised deck by friday.","words":[],"startMs":13000,"endMs":16000,"language":"en","turnId":"01927f3a-0000-7000-8000-000000000203","suggestedSpeakerId":"01927f3a-0000-7000-8000-000000000011"},
    {"id":"01927f3a-0000-7000-8000-000000001010","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561619000,"type":"ActionSuggested","itemId":"01927f3a-0000-7000-8000-000000000301","lineId":"01927f3a-0000-7000-8000-000000000103","text":"I will send the revised deck by Friday.","ownerId":"01927f3a-0000-7000-8000-000000000011","ownerFromSpeaker":true,"dueText":"by Friday"},
    {"id":"01927f3a-0000-7000-8000-000000001011","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561620000,"type":"SpeakerAssigned","lineIds":["01927f3a-0000-7000-8000-000000000103"],"participantId":"01927f3a-0000-7000-8000-000000000011"},
    {"id":"01927f3a-0000-7000-8000-000000001012","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561621000,"type":"TranscriptLineEdited","lineId":"01927f3a-0000-7000-8000-000000000103","text":"Great. I will send the revised deck by Friday."},
    {"id":"01927f3a-0000-7000-8000-000000001013","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561622000,"type":"NoteAdded","noteId":"01927f3a-0000-7000-8000-000000000401","lineId":"01927f3a-0000-7000-8000-000000000103","text":"Ask Leo for the old deck"},
    {"id":"01927f3a-0000-7000-8000-000000001014","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561626000,"type":"SegmentCommitted","lineId":"01927f3a-0000-7000-8000-000000000104","text":"We decided to launch on Tuesday.","words":[],"startMs":17000,"endMs":20000,"language":"en","turnId":"01927f3a-0000-7000-8000-000000000204"},
    {"id":"01927f3a-0000-7000-8000-000000001015","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561627000,"type":"DecisionSuggested","itemId":"01927f3a-0000-7000-8000-000000000302","lineId":"01927f3a-0000-7000-8000-000000000104","text":"We decided to launch on Tuesday."},
    {"id":"01927f3a-0000-7000-8000-000000001016","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561628000,"type":"SpeakerAssigned","lineIds":["01927f3a-0000-7000-8000-000000000104"],"participantId":"01927f3a-0000-7000-8000-000000000012"},
    {"id":"01927f3a-0000-7000-8000-000000001017","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561629000,"type":"EventUndone","targetId":"01927f3a-0000-7000-8000-000000001016"},
    {"id":"01927f3a-0000-7000-8000-000000001018","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561630000,"type":"SpeakerAssigned","lineIds":["01927f3a-0000-7000-8000-000000000104"],"participantId":"01927f3a-0000-7000-8000-000000000013"},
    {"id":"01927f3a-0000-7000-8000-000000001019","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561634000,"type":"SegmentCommitted","lineId":"01927f3a-0000-7000-8000-000000000105","text":"Sam, can you update the release notes before the launch?","words":[],"startMs":21000,"endMs":25000,"language":"en","turnId":"01927f3a-0000-7000-8000-000000000205","suggestedSpeakerId":"01927f3a-0000-7000-8000-000000000012"},
    {"id":"01927f3a-0000-7000-8000-000000001020","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561635000,"type":"ActionSuggested","itemId":"01927f3a-0000-7000-8000-000000000303","lineId":"01927f3a-0000-7000-8000-000000000105","text":"Sam, can you update the release notes before the launch?","ownerId":"01927f3a-0000-7000-8000-000000000013"},
    {"id":"01927f3a-0000-7000-8000-000000001021","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561639000,"type":"SegmentCommitted","lineId":"01927f3a-0000-7000-8000-000000000106","text":"Yes, that works for me.","words":[],"startMs":26000,"endMs":28000,"language":"en","turnId":"01927f3a-0000-7000-8000-000000000206"},
    {"id":"01927f3a-0000-7000-8000-000000001022","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561640000,"type":"ActionAccepted","itemId":"01927f3a-0000-7000-8000-000000000301"},
    {"id":"01927f3a-0000-7000-8000-000000001023","meetingId":"01927f3a-0000-7000-8000-000000000001","at":1791561641000,"type":"MeetingEnded"}
  ]
}

Replayed, it reads:

Launch review
People: Maya, Leo, Sam (they/them)

[0:01] Maya: Okay, let us get started. Thanks everyone for joining the launch review.
[0:07] Leo: Sounds good. The checkout tests passed last night, so the build is ready.
[0:13] Maya: Great. I will send the revised deck by Friday.
[0:17] Sam: We decided to launch on Tuesday.
[0:21] Leo?: Sam, can you update the release notes before the launch?
[0:26] Unknown speaker: Yes, that works for me.

Action items
- I will send the revised deck by Friday. (Maya, due by Friday)
- Sam, can you update the release notes before the launch? (Sam, suggested)

Decisions
- We decided to launch on Tuesday. (suggested)

Notes
- [0:13] Ask Leo for the old deck