TypeSafe AI

The bundled typesafe plugin connects OpenClaw's optional decision model role to TypeSafe AI's Jev models. Its models appear in the separate Decision picker, never in the conversational model picker.

The plugin is disabled by default. Bundling or enabling it does not select a decision model or schedule background work.

Enable and configure

Create a protected credential in Settings → Secrets, then reference it from the plugin configuration. Merge this example into your existing configuration; keep any other entries in plugins.allow.

{  plugins: {    allow: ["typesafe"],    entries: {      typesafe: {        enabled: true,        config: {          apiKey: { source: "store", provider: "default", id: "TYPESAFE_API_KEY" },        },      },    },  },  agents: {    ownership: "explicit",    defaults: { decisionModel: "typesafe/jev-latest" },    entries: {      research: { decisionModel: "typesafe/jev-1.13.0" },    },  },}

typesafe/jev-latest appears as Jev; the pinned typesafe/jev-1.13.0 appears as Jev 1.13.0. An unset agent override inherits agents.defaults.decisionModel; an empty override disables decisions for that agent. An unset or empty global role leaves decisions off by default.

The plugin reads the host's prepared SecretRef value for each request. It does not independently read environment credentials or cache a previous credential. A missing or unavailable credential makes decisions unavailable. Use the normal secret refresh flow after changing a credential.

Selecting a decision model authorizes supported, otherwise-enabled consumers to send their selected evidence to TypeSafe and incur its normal usage charges. Consumer scheduling and publication permissions remain unchanged. Clearing the role or explicitly disabling the plugin prevents its use by those consumers.

Decision contract

Consumers call the provider-neutral decision runtime. The host supplies the model selected for the owning agent. The adapter translates the supported question types:

Choice supports 2–255 alternatives; Score supports 2–10 rubric levels. Unsupported input is rejected before transmission; the adapter does not truncate or split a consumer's rubric. Responses must match the complete question batch, its labels, types, and rubric bounds.

Reported probabilities can be rounded, so they may not sum exactly to one. A reported label or Score can also differ from a calculation over those estimates. OpenClaw preserves the returned values. Normalizing estimates or choosing their largest value is an explicit consumer policy. Probabilities and confidence are not demonstrated accuracy guarantees or permission to act.

The host owns concurrency, circuit health, deadlines, cancellation, and provider lifecycle. The adapter shares transport and response validation with the tool below. Requests use the fixed TypeSafe HTTPS endpoint, reject redirects, and do not retry automatically. Consumers decide what to do with unavailable decisions; caller cancellation must not start fallback work.

Optional evaluation tool

The same plugin registers the optional typesafe_evaluate tool. Enable it through your normal tool policy when an agent should make explicit evaluations. It accepts shared state, a map of questions, and an optional vendor model override. Its TypeSafe-facing question names are choice, score, and noul.

For this tool only, plugins.entries.typesafe.config.model supplies the default vendor model, initially jev-latest. It does not override the native decisionModel role or select a provider. Pin a model version for reproducible tool evaluations. timeoutMs limits tool requests and caps native requests at the shorter of this setting and the host's remaining deadline.

Tool availability and the decision model role are separate: an explicitly enabled tool does not select a background model, and selecting a decision model does not grant agents the tool. Typed answers supply evidence, not authority to publish, send messages, or change durable state.

Existing external installation

This bundled plugin uses the same typesafe plugin ID as the external prototype. Do not configure two installations as independent providers. Inspect plugin resolution before switching, preserve existing configuration and credentials, and use the supported plugin management flow to remove an external override if you want the bundled copy to own the ID. Installing this change does not delete external plugin files or credentials.