Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.synheart.ai/llms.txt

Use this file to discover all available pages before exploring further.

syni-spec is the single source of truth for how Syni behaves across every platform and environment. It defines what Syni is allowed to do, how it is allowed to behave, what it must never do, and what it must always guarantee. Every Syni SDK (Swift, Kotlin, Dart) and the Syni Cloud Gateway must conform to this repository.
If it’s in syni-spec, it is a contract. If it’s not here, it is an implementation detail.

​
What this repository is

  • a behavioral contract, not an implementation
  • a versioned, immutable spec, not a config dump
  • the canonical source of personas, schemas, grammars, safety rules, and budgets consumed by every Syni SDK
  • the artifact that CI enforces before any release is cut

​
What this repository is not

  • not an SDK
  • not a runtime
  • not a place for feature flags, dynamic configuration, or anything that executes code

​
Repository layout

syni-spec/
├── VERSION
├── LICENSE
├── README.md
├── schemas/        # JSON Schemas for outputs and persona meta-schemas
├── personas/       # core / research / prod persona definitions
├── grammars/       # GBNF grammars bound to output schemas
├── rules/          # behavior rules referenced by personas
├── safety/         # global safety policies
├── budgets/        # per-persona resource budgets
├── registries/     # canonical id → file mappings
├── compatibility/  # version compatibility matrices
├── prompts/        # persona prompt fragments
├── conformance/    # CI / validation only
└── packages/       # generated language wrappers (Dart / Swift / Kotlin)

​
Source

syni-spec is maintained by Synheart and released as pinned, signed artifacts via dist.synheart.ai. The repository is not publicly mirrored — the contract is the artifact, not the source.