# reiswaffel78/jev-agent-toolkit architecture

> Architecture diagram of the GitHub repository reiswaffel78/jev-agent-toolkit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/reiswaffel78/jev-agent-toolkit
- Repository: https://github.com/reiswaffel78/jev-agent-toolkit

## Overview

jev-agent-toolkit is primarily a portable Agent Skill: a host agent uses Jev for bounded semantic judgments while retaining reasoning and deterministic decisions. Its optional MCP bridge exposes the same evaluation capability as one tool. The README documents workflow areas, but their detailed orchestration is in unsampled skill references; those branches are represented at the documented capability level. Source excerpts show the MCP request path, validation, upstream call, and error handling.

Main entry points: [`skills/jev-agent-toolkit/SKILL.md`](https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/skills/jev-agent-toolkit/SKILL.md) (Portable Skill Core), [`mcp/jev/src/index.ts`](https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/mcp/jev/src/index.ts) (Stdio Entry), [`mcp/jev/src/server.ts`](https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/mcp/jev/src/server.ts) (Tool Server), [`mcp/jev/src/errors.ts`](https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/mcp/jev/src/errors.ts) (Error Mapping Redaction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_skill["Agent Skill"]
  node_skill_core["Portable Skill Core<br/>[SKILL.md]"]
  node_jev_guide["Jev Guidance<br/>[jev-api.md]"]
end

subgraph group_workflows["Workflow Capabilities"]
  node_coding["Coding Workflows<br/>[coding.md]"]
  node_browser["Browser Research"]
  node_blender["Blender Workflows<br/>[blender.md]"]
  node_unreal["Unreal Workflows<br/>[unreal-engine.md]"]
  node_orchestration["Tool Orchestration"]
  node_multiagent["Multi-agent Workflows<br/>[multi-agent.md]"]
end

subgraph group_mcp["MCP Bridge"]
  node_stdio_entry["Stdio Entry<br/>[index.ts]"]
  node_mcp_server["Tool Server<br/>[server.ts]"]
  node_schemas["Input Output Schemas<br/>[schemas.ts]"]
  node_typesafe_sdk["TypeSafe SDK"]
end

subgraph group_safety["MCP Safety"]
  node_error_handling["Error Mapping Redaction<br/>[errors.ts]"]
end

node_agent(("Host Agent"))
node_mcp_host(("MCP-capable Host"))
node_typesafe_api{{"TypeSafe API"}}

node_agent -->|"uses guidance"| node_skill_core
node_skill_core -->|"covers Jev"| node_jev_guide
node_skill_core -->|"guides coding"| node_coding
node_skill_core -->|"guides research"| node_browser
node_skill_core -->|"guides workflows"| node_blender
node_skill_core -->|"guides workflows"| node_unreal
node_skill_core -->|"covers orchestration"| node_orchestration
node_skill_core -->|"covers delegation"| node_multiagent
node_agent -->|"calls directly"| node_typesafe_api
node_mcp_host -->|"connects over stdio"| node_stdio_entry
node_stdio_entry -->|"creates client"| node_typesafe_sdk
node_stdio_entry -->|"creates server"| node_mcp_server
node_stdio_entry -->|"redacts logs"| node_error_handling
node_mcp_server -->|"validates inputs"| node_schemas
node_mcp_server -->|"evaluates state"| node_typesafe_sdk
node_typesafe_sdk -->|"sends evaluation"| node_typesafe_api
node_mcp_server -->|"maps failures"| node_error_handling

click node_skill_core "https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/skills/jev-agent-toolkit/SKILL.md"
click node_jev_guide "https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/skills/jev-agent-toolkit/references/jev-api.md"
click node_coding "https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/skills/jev-agent-toolkit/references/coding.md"
click node_browser "https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/skills/jev-agent-toolkit/references/browser-research.md"
click node_blender "https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/skills/jev-agent-toolkit/references/blender.md"
click node_unreal "https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/skills/jev-agent-toolkit/references/unreal-engine.md"
click node_orchestration "https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/skills/jev-agent-toolkit/references/tool-orchestration.md"
click node_multiagent "https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/skills/jev-agent-toolkit/references/multi-agent.md"
click node_stdio_entry "https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/mcp/jev/src/index.ts"
click node_mcp_server "https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/mcp/jev/src/server.ts"
click node_schemas "https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/mcp/jev/src/schemas.ts"
click node_error_handling "https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/mcp/jev/src/errors.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill_core,node_jev_guide toneBlue
class node_coding,node_browser,node_blender,node_unreal,node_orchestration,node_multiagent toneAmber
class node_stdio_entry,node_mcp_server,node_schemas,node_typesafe_sdk,node_typesafe_api toneMint
class node_error_handling toneRose
class node_agent,node_mcp_host toneIndigo
```

## Components

### Agent Skill

- [Portable Skill Core](https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/skills/jev-agent-toolkit/SKILL.md): `skills/jev-agent-toolkit/SKILL.md`
- [Jev Guidance](https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/skills/jev-agent-toolkit/references/jev-api.md): `skills/jev-agent-toolkit/references/jev-api.md`

### Workflow Capabilities

- [Coding Workflows](https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/skills/jev-agent-toolkit/references/coding.md): `skills/jev-agent-toolkit/references/coding.md`
- [Browser Research](https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/skills/jev-agent-toolkit/references/browser-research.md): `skills/jev-agent-toolkit/references/browser-research.md`
- [Blender Workflows](https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/skills/jev-agent-toolkit/references/blender.md): `skills/jev-agent-toolkit/references/blender.md`
- [Unreal Workflows](https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/skills/jev-agent-toolkit/references/unreal-engine.md): `skills/jev-agent-toolkit/references/unreal-engine.md`
- [Tool Orchestration](https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/skills/jev-agent-toolkit/references/tool-orchestration.md): `skills/jev-agent-toolkit/references/tool-orchestration.md`
- [Multi-agent Workflows](https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/skills/jev-agent-toolkit/references/multi-agent.md): `skills/jev-agent-toolkit/references/multi-agent.md`

### MCP Bridge

- [Stdio Entry](https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/mcp/jev/src/index.ts): `mcp/jev/src/index.ts`
- [Tool Server](https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/mcp/jev/src/server.ts): `mcp/jev/src/server.ts`
- [Input Output Schemas](https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/mcp/jev/src/schemas.ts): `mcp/jev/src/schemas.ts`
- **TypeSafe SDK**

### MCP Safety

- [Error Mapping Redaction](https://github.com/reiswaffel78/jev-agent-toolkit/blob/main/mcp/jev/src/errors.ts): `mcp/jev/src/errors.ts`

### Other components

- **Host Agent**
- **MCP-capable Host**
- **TypeSafe API**

## Connections

- Host Agent → Portable Skill Core: uses guidance (evidence: `README.md`)
- Portable Skill Core → Jev Guidance: covers Jev (evidence: `README.md`)
- Portable Skill Core → Coding Workflows: guides coding (evidence: `README.md`)
- Portable Skill Core → Browser Research: guides research (evidence: `README.md`)
- Portable Skill Core → Blender Workflows: guides workflows (evidence: `README.md`)
- Portable Skill Core → Unreal Workflows: guides workflows (evidence: `README.md`)
- Portable Skill Core → Tool Orchestration: covers orchestration (evidence: `README.md`)
- Portable Skill Core → Multi-agent Workflows: covers delegation (evidence: `README.md`)
- Host Agent → TypeSafe API: calls directly (evidence: `README.md`)
- MCP-capable Host → Stdio Entry: connects over stdio (evidence: `README.md`)
- Stdio Entry → TypeSafe SDK: creates client (evidence: `mcp/jev/src/index.ts`)
- Stdio Entry → Tool Server: creates server (evidence: `mcp/jev/src/index.ts`)
- Stdio Entry → Error Mapping Redaction: redacts logs (evidence: `mcp/jev/src/index.ts`)
- Tool Server → Input Output Schemas: validates inputs (evidence: `mcp/jev/src/server.ts`)
- Tool Server → TypeSafe SDK: evaluates state (evidence: `mcp/jev/src/server.ts`)
- TypeSafe SDK → TypeSafe API: sends evaluation (evidence: `README.md`)
- Tool Server → Error Mapping Redaction: maps failures (evidence: `mcp/jev/src/server.ts`)
