Theoria

Effect-native libraries for applied math, optimization, language model programming, text layout, and cryptography.

Theoria (θεωρία) — observation that produces knowledge.

Package Map · Theoria App · Development · Contributing · Security

Package Map

Package	Focus	Docs
effect-math	Numerics, linear algebra, statistics, probability, special functions, optimization kernels	README
effect-search	Typed search spaces, Bayesian optimization, studies, snapshots, replay	README
effect-dsp	Effect-native DSPy-style language model programming	README
effect-text	Effectful text preparation and pure multiline layout	README
effect-inference	Provider-blind runtime descriptors, route resolution, and replay-safe runtime evidence	README
@scenesystems/digest	Hashing, HMAC, HKDF, JCS canonicalization	README
@scenesystems/seal	Authenticated encryption and self-describing envelopes	README
@scenesystems/sign	Signatures, key exchange, and KEMs	README

Workspace relationships stay explicit:

• effect-search depends on effect-math and @scenesystems/digest.
• effect-dsp depends on effect-search, effect-math, and @scenesystems/digest.
• effect-text depends on effect-search and effect-math, while still owning a separate prepare/layout runtime lane.
• effect-inference owns provider-blind runtime descriptors and route resolution, while effect-dsp, effect-search, and apps/theoria consume that substrate without re-hosting provider clients.
• @scenesystems/digest, @scenesystems/seal, and @scenesystems/sign are standalone single-entrypoint crypto packages.

Theoria App

apps/theoria/ is the proving consumer for the published packages. It exposes live, typed demos for effect-text, effect-search, effect-math, and effect-dsp.

bun run app:theoria

Open http://127.0.0.1:3876.

For the tmux workflow and route-level app guidance, see apps/theoria/README.md.

Development

Requires bun >= 1.3.

bun install
bun run check
bun run check:tests
bun run check:readmes
bun run lint
bun run test
bun run build

Run one package at a time with Bun filters:

bun run --filter effect-text test
bun run --filter effect-search build
bun run --filter @scenesystems/digest test

See CONTRIBUTING.md for the workflow and repository rules.

Notes

The monorepo is built on Effect. The crypto packages build on the Noble ecosystem. Package-specific algorithm references, prior art, and third-party notices live in the individual package READMEs and notice files rather than being duplicated here.

License

MIT — Copyright © 2026 Scene Systems