Episodes

View as Markdown

Episodes

An episode is a structured summary of a conversation session. It captures the arc of the interaction — not a verbatim transcript, but a distillation of outcomes.

What an episode contains

  • Summary — what was discussed and what happened
  • Decisions made — beliefs established or revised during the session
  • Open threads — unresolved questions or next steps
  • Linked beliefs — facts that were created or modified in this session

When episodes are created

Episodes are extracted automatically when the system flushes a conversation segment. The extraction pipeline generates the episode summary in parallel with fact and artifact extraction.

For Chrome extension users, episodes are created as you chat in ChatGPT, Claude, or Gemini — no manual action needed.

How episodes help retrieval

When you search for context, episodes provide temporal grounding. If you ask “what did we discuss about the API design?”, the system can return the episode where that discussion happened, along with the specific beliefs it established.

Episodes also support co-occurrence expansion during retrieval — if a fact was established in an episode, other facts from the same episode may be relevant too.

API

OperationEndpoint
ListGET /v1/episodes
SearchGET /v1/episodes/search
GetGET /v1/episodes/{id}
DeleteDELETE /v1/episodes/{id}