TypeSafe Connector for Mule 4
Think: Smart If Statements.
Jev is TypeSafe's System One model. It turns unstructured JSON state and typed questions into a value a Choice router, filter, or expression can read. The flow owns the if: the threshold, the route, and the side effect. This connector exists to make that if possible in Mule.
Jev
Use these pages when you need the official project behind a connector concept:
| Topic | Official page |
|---|---|
| What Jev is | Introduction |
| System One | System One |
| How to design the if | How to build with System One |
| State | State |
| Choice, Score, and Noul | Primitives |
| When to act on an answer | Confidence |
jev-latest and model cards | Models |
POST /{apiVersion}/systemone | HTTP API |
| Announcement | Introducing System One Models and Jev |
Why use it?
- Typed decisions — Noul (yes/no probability), Choice (classification), and Score (ordered rubric) answers.
- Native DataSense — JSON input and output metadata, including answer-specific metadata for reusable question sets.
- Six routes — TypeSafe, OpenRouter, Vercel AI Gateway, Cloudflare Workers AI, compatible gateways, and an in-process mock.
- Resilient execution — ordered provider fallbacks, retry handling, optional caching, budgets, and usage statistics.
- Flow-ready governance — local policy evaluation returns
ACCEPT,REVIEW, orREJECT. - Scale operations — bounded-concurrency batch evaluation and cost-efficient filtering.
- Operational signals — polling sources for drift, budget thresholds, and successful provider failovers.
Core concepts
| Term | Meaning |
|---|---|
| State | The JSON context being evaluated, such as a ticket, order, candidate, or message. |
| Noul | A yes/no question whose answer is the probability of “yes.” |
| Choice | A classification question that returns one option and a probability distribution. |
| Score | An ordered rubric that returns a score, level distribution, and derived level. |
| Question set | A reusable JSON file under src/main/resources/questions/. |
| Policy | Local thresholds that convert answers into an ACCEPT, REVIEW, or REJECT action. |
Routes
| Route | Authentication | Notes |
|---|---|---|
| TypeSafe | API key | Direct System One access and model listing. |
| OpenRouter | API key | Jev through OpenRouter, including provider-reported cost. |
| Vercel AI Gateway | Gateway key or OIDC token | Jev through Vercel AI Gateway. |
| Cloudflare Workers AI | Account ID and API token | Cloudflare model endpoint; model listing is unavailable. |
| Compatible Gateway | Optional bearer key | A configurable endpoint that implements the System One contract. |
| Mock | None | In-process, deterministic answers for development and tests. |
Keyed routes can define ordered fallback routes. A fallback is attempted for connectivity, timeout, rate-limit, and overload failures—not for invalid requests or authorization failures.
Operations
Decide and select
- [Decide] Evaluate — evaluate a complete question set.
- [Decide] Ask Yes/No — ask one Noul question.
- [Decide] Choose — classify state into one option.
- [Decide] Score — grade state against ordered levels.
- [Select] Candidate — select and rank the best upstream row.
- [Decide] Evaluate Batch — evaluate one question set across many states.
- [Select] Filter — retain items that clear a Noul threshold.
Policy and utilities
- [Policy] Apply — turn answers into a routing action locally.
- [Util] Connection Get Capabilities — report route capabilities locally.
- [Util] Connection List Models — enumerate models across supporting routes.
- [Util] Validate Question Set — validate a question set before a billed call.
See the operations overview for inputs, outputs, and provider-call behavior.
Sources
- On Drift Detected — watches no-match rate, confidence, and answer-distribution changes.
- On Budget Threshold — fires when calls or input tokens cross a configured percentage.
- On Provider Failover — emits successful fallback events.
See Sources for payloads and configuration.
Requirements
- Mule Runtime 4.9.0 or later
- Java 17
- Maven 3.9.x