How cobusgreyling/jev works
Jev Showcase is an operator-facing interactive lab and smart-home demo, alongside a TypeScript CLI that applies Jev decisions to agent tasks. The main user workflows are exploring documented concepts and examples in the lab, issuing a home request that is judged and converted into a code-owned device plan, or invoking a CLI decision command for routing, retrieval, guardrails, or trace classification. Source excerpts support the Python API/client and parts of the TypeScript harness; unsampled CLI subsystems are included from the documented capabilities and tree, with uncertain internal wiring omitted.
Main entry points: app.py Lab API · cli.ts Jev CLI · client.ts TypeScript client · route.ts Model routing
Components 21
Operator lab
- Browser UI
static/app.js - Lab API
app.py - Cost analysis
jev_lab/cost.py - Ticket policy
jev_lab/policy.py
Smart-home demo
- Home UI
static/home.js - Home API
app.py - House planning
jev_lab/home.py - House state
jev_lab/home.py
Agent harness
- Jev CLI
packages/js/src/cli.ts - Model routing
packages/js/src/route.ts - Context retrieval
packages/js/src/retrieve.ts - Text guardrails
packages/js/src/guard.ts - Trace classification
packages/js/src/classify.ts - Question builders
packages/js/src/questions.ts
Jev service
- TypeScript client
packages/js/src/client.ts - Python client
jev_lab/client.py
Knowledge assets
- Lab content
data - Home fixtures
data/fixtures
Other components
- Operator
- CLI user
- TypeSafe System One
Connections 25
- Operator → Browser UI: uses
- Browser UI → Lab API: requests
- Lab API → Cost analysis: calculates costs
- Lab API → Ticket policy: applies policy
- Lab API → Python client: judges request
- Lab API → Lab content: loads content
- Home UI → Home API: submits commands
- Home API → House planning: builds and applies plans
- Home API → Python client: judges home state
- Home API → Home fixtures: uses fixtures
- House planning → House state: updates device state
- Home UI → Home API: applies confirmed plan
- CLI user → Jev CLI: invokes
- Jev CLI → Model routing: routes task
- Jev CLI → Context retrieval: retrieves context
- Jev CLI → Text guardrails: screens text
- Jev CLI → Trace classification: classifies trace
- Model routing → Question builders: builds questions
- Context retrieval → Question builders: builds questions
- Model routing → TypeScript client: calls service
- Context retrieval → TypeScript client: calls service
- Text guardrails → TypeScript client: calls service
- Trace classification → TypeScript client: calls service
- TypeScript client → TypeSafe System One: sends decisions request
- Python client → TypeSafe System One: sends decisions request