command-code 1.62.0 → 1.62.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # command-code
 
+## 1.62.1
+
+### Patch Changes
+
+- feat: typesafe/jev support on headless and provider api
+
 ## 1.62.0
 
 ### Minor Changes

package/dist/bundled/command-code-knowledge/reference/headless.md

@@ -217,6 +217,39 @@ fi
 
 ---
 
+## Decision models (typesafe/jev)
+
+`typesafe/jev` is available on the headless mode as a decision model. It runs headless, on your normal login, and it is free for a limited time.
+
+It answers typed questions about a **state** with **probabilities** instead of text, so a script can branch on the number. The headless prompt is typesafe/jev's request as JSON. Request and response follow TypeSafe's [official shape](https://docs.typesafe.ai/api).
+
+Here is an example of how to run it headlessly with cmd:
+
+```bash
+cmd -p '{
+  "state": {"diff": "- if (user.isAdmin)\n+ if (true)"},
+  "questions": {
+    "risky":    {"type": "noul",   "instructions": "Does this weaken an authorization check?"},
+    "category": {"type": "choice", "instructions": "Which kind of change is this?", "criteria": {"security": "auth or secrets", "bugfix": "wrong behavior", "refactor": "no behavior change"}}
+  }
+}' -m typesafe/jev
+```
+
+```json
+{
+  "model": "typesafe/jev",
+  "answers": {
+    "risky":    {"type": "noul",   "noul": 0.93},
+    "category": {"type": "choice", "choice": "security", "confidence": 0.81, "probabilities": {"security": 0.8, "bugfix": 0.15, "refactor": 0.05}}
+  },
+  "usage": {"input_tokens": 360, "output_tokens": 57}
+}
+```
+
+Interactive use is refused, since Jev is not a chat model. You can find the full request and response reference on the [Provider API page](https://commandcode.ai/docs/provider#decision-models-typesafe-jev).
+
+---
+
 ## Shell script
 
 ```bash
@@ -299,6 +332,7 @@ scriptable automatically. Confirmations print to stderr, keeping `-p` stdout cle
 | **No interactive prompts** | No keyboard shortcuts or interactive UI. Slash commands aren't typed here - use flags instead (see [Configuring settings](#configuring-settings)); session-lifecycle commands like `/clear` and `/reload` have no meaning in one-shot mode |
 | **No resume picker** | A bare `--resume` errors in print mode; resume by explicit id or use `--continue` |
 | **Stdin timeout** | Piped stdin times out after 30 seconds if no data is received |
+| **Decision models are headless only** | `typesafe/jev` answers typed questions, not chat, so it runs with `-p` only (see [Decision model: Jev](#decision-models-typesafe-jev)) |
 
 ---