> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roomote.dev/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Start new users at /index, then /self-hosting to choose and prepare a host, including home networks at /homelab or infrastructure providers at /self-hosting/platforms. Continue through /first-task. Use Local development only when the user intends to modify Roomote itself.
> When an agent is asked to follow /self-hosting or install Roomote autonomously, read and follow /self-hosting/agent-installation as the normative automation contract even though it is intentionally hidden from side navigation.
> Use the one-command Linux installer for both evaluation and production. On macOS or Windows, create or reuse a full Ubuntu VM and run the same installer inside it; do not replace the installer with the repository's development Compose files.
> For a local VM, prepare a stable public HTTPS domain before connecting providers. Use a named tunnel with internal origin TLS or public DNS with ports 80/443 forwarded to the Linux host. Cloudflare Quick Tunnels do not support the Server-Sent Events Roomote uses; do not use them for the complete setup path.
> Run automated installs with --no-setup-url so the bootstrap token is not captured in the agent transcript. Let the user obtain the setup URL in a trusted terminal, enter credentials, and complete browser authorization.
> Proceed through safe, reversible setup and pause for privileged host or VM changes, public tunnel creation, credentials or browser authorization, durable external-account changes, destructive operations, existing-state conflicts, or when no documented safe default applies.
> A setup is not complete when the services merely start. Follow /first-task to verify sign-in, repository sync, and a real Roomote task that can clone and run a command. A saved environment is optional for a repository task. Verify branch or pull-request delivery and previews when configured; Slack and other communications providers are optional.

# TypeSafe

> Use TypeSafe's Jev as Roomote's judgment model for fast routing and triage decisions.

[TypeSafe](https://typesafe.ai)'s Jev is a judgment model. It answers typed
questions (yes or no, one of several options, or a graded score) with
probabilities in a single fast call instead of generating text. Roomote can use
it as the optional [judgment model](https://docs.roomote.dev/models#judgment-model) for routing and
triage decisions. This dedicated role handles typed decisions alongside the
chat and task inference models.

You can reach Jev three ways:

* **Jev via TypeSafe**, with a TypeSafe API key (this page)
* **Jev via OpenRouter**, with the OpenRouter key a deployment already uses for
  [OpenRouter](https://docs.roomote.dev/providers/inference/openrouter.md)
* **Jev via Vercel AI Gateway**, with the AI Gateway key a deployment already
  uses for [Vercel AI Gateway](https://docs.roomote.dev/providers/inference/vercel-ai-gateway.md)

## Get an API key

Create an API key in your [TypeSafe](https://typesafe.ai) account.

## Configuration

Add **TypeSafe** in **Settings > Models** and paste the key. Roomote checks the
key with a small request when you save it. Self-hosted operators can set the
key in the environment instead:

```sh theme={null}
R_TYPESAFE_API_KEY=...
```

A TypeSafe key alone turns on **Jev via TypeSafe**. To use OpenRouter, Vercel
AI Gateway, or the Roomote judgment model instead, or to turn the judgment
model off while keeping the key, choose the **Judgment model** in
**Settings > Models**, or set `R_JUDGMENT_MODEL` to `typesafe`, `openrouter`,
`vercel`, `roomote`, or `off`. The environment variable overrides the Settings
choice.

## What is sent to TypeSafe

Each judgment sends only the text that decision needs, such as a channel
message and its launch criteria, a request and the names and descriptions of
environments, or an inbound email.
The key stays on the control plane and is never sent to task sandboxes. Review
TypeSafe's data terms before enabling it.

## Verify setup

1. save the key in **Settings > Models** and confirm TypeSafe shows as
   connected
2. confirm **Judgment model** shows **Jev via TypeSafe**
3. post a message in an [auto-respond channel](https://docs.roomote.dev/automation-configuration.md#channel-automations)
   and confirm the launch decision in the logs names the judgment model

## Common issues

* **The key is rejected when saving.** Confirm the key is active in your
  TypeSafe account.
* **The judgment model is selected but unused.** The selected route needs its
  key: a TypeSafe key for **Jev via TypeSafe**, an OpenRouter key for **Jev via
  OpenRouter**, or a Vercel AI Gateway key for **Jev via Vercel AI Gateway**.
  Roomote never switches routes on its own.
* **Decisions look the same as before.** Roomote acts on the judgment model
  only when it is confident; everything else keeps the existing behavior.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.