Metadata-Version: 2.4
Name: athena-references
Version: 0.1.0
Summary: Pure-stdlib Python mirror of the @athenaintel/references anchor types, shared by the Athena studio SDKs
License: Proprietary
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# athena-references

Pure-stdlib Python mirror of the TypeScript `@athenaintel/references` anchor
types. It is the single Python source of truth for `AssetReference`, the full
`Anchor` union, and the per-asset anchor registry that the Athena studio SDKs
(`athena-python-pptx`, `athena-openpyxl`, `athena-python-docx`) share.

It is intentionally dependency-free (Python stdlib only) so the studio SDKs can
depend on it inside the Daytona execution sandboxes without pulling in a heavy
dependency tree.

## Source of truth

`agora/agora/utils/asset_references.py` remains the **canonical** Python
definition of the anchor types and the asset → anchor registry. This package is
a downstream **mirror** of those types for the studio SDKs.

Both this package and the agora module are pinned to the same shared contract
fixture, `packages/references/src/anchors/registry-contract.json`, which is
generated from the TypeScript registry. The parity test
(`tests/test_registry_contract_parity.py`) locks this package to that contract,
so a one-sided edit to the anchor union or the registry fails CI.
