One record per entity, every revision kept.

teleon.dev/docs/entities-db holds canonical entity records and their annotation revisions. A record keeps its identity for life; every change to its description is a new, dated revision.

teleon.dev/docs/entities-dbDatabase cellhttpsjson

Read the docs Copy the agent prompt

One entity's history

Attribute	Value	Valid from	Recorded
license	MIT	2026-03-01	2026-10-20
license	Apache-2.0	2025-06-12	2026-02-02
maintainer	core team	2025-06-12	2026-02-02

Each change is a new revision with two dates; the record's ID stays the same.

What it does

Canonical IDs

Each entity resolves to one ID, whatever name it arrives under.

Revisions kept

Annotations are immutable revisions, so history reads back exactly.

Bitemporal facts

Attributes record when they were true and when they were learned.

The contract

Entities are stable; annotations append; links between entities live in the graph cell.

HoldsEntities and annotation revisions

HistoryValid time and record time

StoreS4 entities, leads and attributes

AccessRING-1 and services

Identifiers

swhid_content_index
teleon_fuzzy_entity_resolution/v1

Execution contracts

Esoteric trigger and hook precision, benign counterfactuals and entity link or unlink

Sample queryCopy

SELECT entity_id, attribute, value, valid_from, recorded_at
FROM teleon_core.teleon_bitemporal_assertions
WHERE entity_id = 'ent_00412'
ORDER BY recorded_at DESC
LIMIT 3;

Endpoints

Method	Path	Access	What it does	Status
`GET`	`/v1/health`	RING-3	Read the cell's health
`GET`	`/v1/entities/{id}`	RING-2	Read an entity with its revisions

Listed paths appear in the service’s published files today. In the one-host plan every path here is served under api.teleon.dev/v1/entities-db.

How it connects

Reads from

Database and graph coreteleon.dev/docs/db

Feeds into

Entity and trigger labteleon.dev/docs/esoteric Hypergraphteleon.dev/docs/hypergraph Searchteleon.dev/docs/search

Queuesaq13 aq14 aq15 aq81 aq138

StoresS4 Canonical Entities, Leads and Bitemporal Attributes

For agents

Give your agent the read-only guide first. It reports back before any write.

Agent prompt

Read https://teleon.dev/docs/entities-db.md and describe how revisions are stored. Read only.

Copy

llms.txt Agent card

Words on this page

Full glossary

Bitemporal: A record that keeps two times: when a fact was true in the world and when the system learned it.
SWHID: Software Heritage identifier: a permanent ID made from a file's hash, such as swh:1:cnt: followed by 40 hex digits.