Reference adapter
Supabase Storage
Private bucket · per-user prefix · RLS
OPENAYA OS
SPEC 1.0.0AGENTS.md
MACHINE-READABLE DISK PROTOCOL
Aya is the operating system. Your storage is the disk.
Durable state is stored as portable, versioned files that you own. Aya reads and writes them through one provider-neutral contract. Databases and embeddings are derived indexes—not the source of truth.
Canonical files
JSON + JSON Schema on the mounted disk
DiskAdapter
One contract across storage providers
Derived indexes
Search, embeddings, cache, and UI state
Canonical layout
/aya/ manifest.json profile/profile.json preferences/preferences.json conversations/<id>.json memories/<id>.json projects/<id>.json decisions/<id>.json skills/<id>.json
Every file carries
$schema + schemaVersion
kind + stable id
owner + timestamps
revision + relationships
typed data payload
namespaced extensions
Adapter contract
One disk surface, many providers.
Consumers call read, write, list, delete, move, and stat. Provider IDs, eTags, revisions, and resource URIs remain opaque metadata.
Planned
Google Drive
Drive IDs · revisions · OAuth
Planned
Microsoft OneDrive
Graph API · eTags · OAuth
Planned
Dropbox
Revisions · content hashes · OAuth
Planned
MCP filesystem
Resource URIs · server capabilities
User-owned by design
Private objects are scoped to the authenticated owner's prefix. Aya cannot silently cross ownership boundaries.
Conflicts are explicit
Expected revisions prevent silent last-write-wins. External edits are detected before overwrite.
Indexes are rebuildable
Working memory, vectors, and search indexes can be reconstructed from canonical disk files.
Published JSON Schemas
Build against the contract.
aya-file.schema.json manifest.schema.json profile.schema.json preferences.schema.json conversation.schema.json memory.schema.json project.schema.json decision.schema.json skill.schema.json
Runtime writes are validated with the matching Zod schemas before a provider receives bytes. Future versions migrate sequentially and preserve namespaced extension fields.