Citations

Omni uses short handles inside answer text and returns matching structured citation objects.

Conversation citation

[C1] points to a validated range in the workspace's persistent conversation:

{
  "handle": "C1",
  "source_type": "conversation",
  "conversation": {
    "sequence_epoch": 1,
    "first_sequence": 8,
    "last_sequence": 10
  }
}

Vault citation

[V1] points to a validated range in a ready Vault file:

{
  "handle": "V1",
  "source_type": "vault_file",
  "vault_file": {
    "file_id": "file_01ARZ3NDEKTSV4RRFFQ69G5FAV",
    "filename": "launch-notes.txt",
    "version_id": "version_...",
    "chunk": { "ordinal": 0, "char_start": 120, "char_end": 284 }
  }
}

The task status, retrieval_citations/done events, and persisted assistant message represent the same validated citation set. Do not manufacture handles client-side.

Retrieval scores, internal chunk IDs, vector identities, hashes, storage paths, and provider metadata are not part of the public citation contract.