Introduction
corespine is the thin shared core of the Spine family — a small set of domain-neutral primitives, eight seams plus a unified error shape, depended on by ragspine and spineagent but never the reverse.
corespine is the thin shared core of the Spine family: a small set of domain-neutral
primitives — the stable bedrock that belongs to neither RAG nor agents. It is depended on by
sibling packages like ragspine and spineagent, but never depends back on any of them, and
carries none of their domain concepts.
It is made of eight "seams" plus an errors seam, each holding only the smallest, obviously stable
mechanism. As of 0.2.0 the newest seams are a BlobStore (key → bytes artifact storage), a
TraceExporter fan-out for the privacy trace, and a StreamingLLMProvider overlay protocol. The
core imports zero third-party SDKs, zero network, zero runtime dependencies (dependencies
stays empty forever) — install it and it runs offline, deterministically, end to end.
corespine provides mechanism, not policy: the conformance harness, the seam registry, the privacy-trace shape. The specific invariants are bound by each app, never baked into the core.
Start here
Overview
What corespine is, what it solves, when to use it, and the seam meta-pattern.
API
The real signature and contract of every export, grouped by seam.
Recipes
Runnable, offline, zero-dependency minimal examples with real output.
Gotchas
Real pitfalls, ranked by how often people hit them — wrong vs. right.