# orchid_stratum v0.2.1 - Table of Contents

A deterministic, content-addressable caching layer for the Orchid workflow engine.
Enables massive performance gains by bypassing redundant computations via payload
dehydration/hydration and pluggable storage adapters.

## Pages

- [OrchidStratum](readme.md)

## Modules

- [OrchidStratum](OrchidStratum.md): `OrchidStratum` is a deterministic, content-addressable caching layer for the
[Orchid](https://hex.pm/packages/orchid) workflow engine.

- Meta Storage Behaviour
  - [OrchidStratum.MetaStorage](OrchidStratum.MetaStorage.md): A Meta Store records the outcome of a step execution indexed by the step's
content-addressable key. Each entry is a `MetaItem` that carries the
dehydrated outputs (with heavy payloads replaced by `{:ref, ...}` tuples)
plus provenance metadata.
  - [OrchidStratum.MetaStorage.MetaItem](OrchidStratum.MetaStorage.MetaItem.md): Struct representing a single cached step result in the Meta Store.

- Blob Storage Behaviour
  - [OrchidStratum.BlobStorage](OrchidStratum.BlobStorage.md): A Blob Store is responsible for persisting and retrieving raw payload data
(tensors, audio frames, binary chunks, arbitrary Elixir terms, etc.) using a
content-derived key — typically the SHA-256 hash of the serialised payload.

- Orchid Integration
  - [OrchidStratum.BypassHook](OrchidStratum.BypassHook.md): An `Orchid.Runner.Hook` that transparently intercepts step execution and
serves results from cache when possible.
  - [OrchidStratum.HashKeyBuilder](OrchidStratum.HashKeyBuilder.md): Builds deterministic, content-addressable cache keys for steps and payloads.

- Default Adapters
  - [OrchidStratum.BlobStorage.EtsAdapter](OrchidStratum.BlobStorage.EtsAdapter.md): In-process ETS-backed adapter for `OrchidStratum.BlobStorage`.
  - [OrchidStratum.MetaStorage.EtsAdapter](OrchidStratum.MetaStorage.EtsAdapter.md): In-process ETS-backed adapter for `OrchidStratum.BlobStorage`.

