@feltdb/studio

FeltDB Studio is an application-fabric designer and operational interface. Its visual model and editable Flow DSL are two representations of the same canonical FlowSpec.

Features

• Application Designer - Collections, references, capabilities, workflows, agents, triggers, policies, schedules, and their executable graph

• Bidirectional Flow DSL - Visual edits generate feltdb.flow; DSL edits update the graph

• Validation and migration diff - Semantic references, duplicates, field changes, guarded transforms, and destructive-change warnings

• Versioned deployment - Canonical application revisions compile into FeltDB model collections, workflow definitions, and agent definitions

• Import and export - Portable feltdb.flow is the source representation, not Studio state

• Overview Dashboard - Real-time health status and runtime statistics

• State Explorer - Interactive browser for collections and objects

• Reference Explorer - Flow reference and content tracking

• Peer Map - Visual topology of connected peers

• Capabilities Explorer - Distributed capability router visualization

• Execution Viewer - Track capability executions and workflows

• Workflow Visualizer - Dependency graphs and execution tracking

• Agent Explorer - First-class agent runtime objects

• Provenance Explorer - Causal graphs and timeline

• Operations Stream - Low-level event log

• Conflicts Explorer - Convergence and conflict resolution

• Health Center - System diagnostics and health status

• Live Updates - Reactive updates using FeltDB's event infrastructure

Usage

Browser (npm)

npm run studio

Self-Hosted

feltdb studio

Remote Connection

feltdb studio --connect http://localhost:7700

Studio prompts for the API key and retains it only in browser session storage. The CLI also supports:

feltdb validate feltdb.flow
feltdb diff feltdb.flow
FELTDB_URL=https://db.example FELTDB_API_KEY=... feltdb deploy feltdb.flow

Architecture

Studio uses the same public FeltDB APIs available to all developers. It never directly manipulates FeltDB's internal storage, and the FlowSpec compiler is shared with the CLI.

FeltDB Studio
     │
@feltdb/client
     │
FeltDB API Protocol
     │
┌────┴────┐
│          │
Browser  Self-hosted
Runtime   Runtime
     │      │
  FeltDB Core

Development

npm install
npm run dev

Build for production:

npm run build