Zebflow Documentation

Data Layers

Understanding Zebflow's three-layer data model

Data Layers

Layer 1: Platform Catalog

  • Location: platform/catalog/ (Sekejap)
  • Contents: Users, sessions, MCP sessions, platform settings
  • Access: Platform services only — not directly accessible from pipelines

Layer 2: Project Config

  • Location: repo/zebflow.json
  • Contents: Project title, assistant configuration, project-level settings
  • Access: Via ZebflowJsonService — git-tracked, version controlled

Layer 3: Project Data

  • Location: data/sekejap/
  • Contents: Application collections, KV store entries, runtime state
  • Access: Via pipeline nodes (sekejap.*, kv.*) and MCP tools

Sekejap collections

| sekejap.put --collection articles --slug "{{ $input.slug }}"
| sekejap.query --collection articles --filter "status == 'published'"
| sekejap.get --collection articles --slug my-article

KV store

| kv.set --key "user:{{ $input.id }}:prefs" --durable
| kv.get --key "user:123:prefs"
| kv.list --prefix "user:" --durable

The --durable flag persists KV entries to disk. Without it, entries are in-memory only.