typesafeai-cli 0.3.1__tar.gz

typesafeai_cli-0.3.1/.gitignore

@@ -0,0 +1,14 @@
+.env.local
+.env
+PLAN.md
+plan.md
+docs/
+.venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+.pytest_cache/
+.ruff_cache/
+.coverage
+uv.lock

typesafeai_cli-0.3.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 typesafeai-cli contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

typesafeai_cli-0.3.1/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.5
+Name: typesafeai-cli
+Version: 0.3.1
+Summary: Agent CLI for TypeSafe System One (Jev)
+Project-URL: Homepage, https://github.com/maddygoround/typesafeai-cli
+Project-URL: Repository, https://github.com/maddygoround/typesafeai-cli
+Project-URL: Issues, https://github.com/maddygoround/typesafeai-cli/issues
+Project-URL: Releases, https://github.com/maddygoround/typesafeai-cli/releases
+Author: safeaiforeveryone
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,jev,typesafe
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: typer>=0.12
+Requires-Dist: typesafe-sdk>=0.6.0
+Description-Content-Type: text/markdown
+
+# TypeSafe agent CLI
+
+`typesafe` is an **agent CLI** for [TypeSafe](https://typesafe.ai) **Jev**.
+
+It is meant to be invoked by coding agents (Grok, Codex, Claude Code, Cursor, and anything else that can run a shell command). You can run it yourself while you debug; the usual caller is an agent.
+
+Jev does not chat. The agent gathers a small JSON document (`state`) and typed questions (`noul`, `choice`, `score`). This CLI sends that to `POST /v1/systemone` and prints probabilities on stdout. Jev never sees the repo unless the agent copies the relevant slices into `state`.
+
+You do not hand-write production payloads every day. Install the **typesafe-cli** skill, and the agent writes the JSON (in a temp directory, not in git). The files under [`examples/`](examples/) exist so you can see the shape, and so you can run a call without inventing one.
+
+## JSON shape
+
+Two files. Names are yours; types are not.
+
+**`state.json`** — named fields the questions will point at:
+
+```json
+{
+  "message": "I was charged twice for order A-104. Please refund the duplicate.",
+  "policy": "Duplicate charges are eligible for an immediate refund."
+}
+```
+
+**`questions.json`** — one judgment per id. `instructions` should backtick those fields (`` `message` ``):
+
+```json
+{
+  "refund_requested": {
+    "type": "noul",
+    "instructions": "Does `message` request a refund?"
+  },
+  "intent": {
+    "type": "choice",
+    "instructions": "What does `message` ask for?",
+    "criteria": {
+      "refund": "The customer wants money returned",
+      "information": "Explanation only",
+      "other": "Something else"
+    }
+  }
+}
+```
+
+Full copies, including a **code-change** example with `files[].hunk`:
+
+| Sample | Files |
+| --- | --- |
+| Support ticket | [`examples/ticket/state.json`](examples/ticket/state.json), [`questions.json`](examples/ticket/questions.json) |
+| Skill / code slice | [`examples/code-change/state.json`](examples/code-change/state.json), [`questions.json`](examples/code-change/questions.json) |
+| How to run them | [`examples/README.md`](examples/README.md) |
+
+```bash
+WORKDIR="${TMPDIR:-/tmp}/codex/typesafeai-cli"
+mkdir -p "$WORKDIR"
+cp examples/ticket/*.json "$WORKDIR/"
+typesafe ask --state-file "$WORKDIR/state.json" --questions-file "$WORKDIR/questions.json"
+```
+
+One-liners skip files: `typesafe noul "Does this request a refund?" --state "I was charged twice."`
+
+If `data.model` looks like `jev-1.13.0`, the request reached TypeSafe. `auth status` does not.
+
+## What the agent is supposed to do
+
+1. `typesafe skills install` (once) so **typesafe-cli** and the official TypeSafe skill are on disk.
+2. `typesafe auth status` — read `has_key` only. Agents must not print or open `TYPESAFE_*` or key files.
+3. Write questions first. Each instruction backticks the state paths it needs. That list is what to collect.
+4. Fill only those paths. If a path is code, put the hunk body in, not a filename.
+5. Write JSON under `${TMPDIR:-/tmp}/codex/<project>/`, never in the git tree.
+6. `typesafe ask`. Apply thresholds in the agent (a noul near `0.5` is unsure). Jev does not pick the next tool.
+
+`typesafe agent schema` is the machine-readable command list. `--agent` makes `--help` JSON.
+
+## Install
+
+Python 3.10+ and a key from the [TypeSafe console](https://console.typesafe.ai/settings/keys).
+
+```bash
+export TYPESAFE_API_KEY=apikey_…
+
+pip install typesafeai-cli
+# or: pipx install typesafeai-cli
+# or clone, then: uv sync && uv run typesafe --help
+```
+
+`install.sh` on the repo and on each release can also install the GitHub wheel. Optional: `TYPESAFE_BASE_URL`, `TYPESAFE_DEFAULT_MODEL`. `--key` / `--creds` are for scripts, not for agents scraping secrets.
+
+## Commands
+
+| | |
+| --- | --- |
+| `typesafe ask` | State file + questions file |
+| `typesafe noul` / `choice` / `score` | One question |
+| `typesafe find` | Search a local file by plain-language query |
+| `typesafe rank` | Rerank a JSON shortlist |
+| `typesafe extract` | Pick a verbatim span (email / phone / money / `--candidates`) |
+| `typesafe verify` | Check a claim against a source (missing quote → fabricated) |
+| `typesafe screen` | Jailbreak / injection / sensitive-data / harm gate |
+| `typesafe suggest-skill` | At most one skill name, or none |
+| `typesafe decide` | Map nouls/choices to no / uncertain / yes (no HTTP) |
+| `typesafe models` | Aliases (`jev-latest`, …) |
+| `typesafe smoke` | Live docs quickstart |
+| `typesafe auth status` | `has_key`; never prints the key |
+| `typesafe agent schema` | JSON command tree |
+| `typesafe skills install` | Official TypeSafe skill + **typesafe-cli** |
+
+Exit `0` answered, `1` request failed (including missing key on `ask`), `2` bad flags or questions (no HTTP).
+
+## Releases
+
+A merge to `main` that passes CI ships automatically: patch bump, tag `vX.Y.Z`, GitHub release, PyPI (`release.yml`, environment `pypi`). Start the merge commit with `[skip release]` to skip. For a minor or major, run **Prepare Release** and pick the bump.
+
+Match `version` in `pyproject.toml` to `__version__` in `src/typesafe_cli/__init__.py` if you tag by hand.

typesafeai_cli-0.3.1/README.md

@@ -0,0 +1,113 @@
+# TypeSafe agent CLI
+
+`typesafe` is an **agent CLI** for [TypeSafe](https://typesafe.ai) **Jev**.
+
+It is meant to be invoked by coding agents (Grok, Codex, Claude Code, Cursor, and anything else that can run a shell command). You can run it yourself while you debug; the usual caller is an agent.
+
+Jev does not chat. The agent gathers a small JSON document (`state`) and typed questions (`noul`, `choice`, `score`). This CLI sends that to `POST /v1/systemone` and prints probabilities on stdout. Jev never sees the repo unless the agent copies the relevant slices into `state`.
+
+You do not hand-write production payloads every day. Install the **typesafe-cli** skill, and the agent writes the JSON (in a temp directory, not in git). The files under [`examples/`](examples/) exist so you can see the shape, and so you can run a call without inventing one.
+
+## JSON shape
+
+Two files. Names are yours; types are not.
+
+**`state.json`** — named fields the questions will point at:
+
+```json
+{
+  "message": "I was charged twice for order A-104. Please refund the duplicate.",
+  "policy": "Duplicate charges are eligible for an immediate refund."
+}
+```
+
+**`questions.json`** — one judgment per id. `instructions` should backtick those fields (`` `message` ``):
+
+```json
+{
+  "refund_requested": {
+    "type": "noul",
+    "instructions": "Does `message` request a refund?"
+  },
+  "intent": {
+    "type": "choice",
+    "instructions": "What does `message` ask for?",
+    "criteria": {
+      "refund": "The customer wants money returned",
+      "information": "Explanation only",
+      "other": "Something else"
+    }
+  }
+}
+```
+
+Full copies, including a **code-change** example with `files[].hunk`:
+
+| Sample | Files |
+| --- | --- |
+| Support ticket | [`examples/ticket/state.json`](examples/ticket/state.json), [`questions.json`](examples/ticket/questions.json) |
+| Skill / code slice | [`examples/code-change/state.json`](examples/code-change/state.json), [`questions.json`](examples/code-change/questions.json) |
+| How to run them | [`examples/README.md`](examples/README.md) |
+
+```bash
+WORKDIR="${TMPDIR:-/tmp}/codex/typesafeai-cli"
+mkdir -p "$WORKDIR"
+cp examples/ticket/*.json "$WORKDIR/"
+typesafe ask --state-file "$WORKDIR/state.json" --questions-file "$WORKDIR/questions.json"
+```
+
+One-liners skip files: `typesafe noul "Does this request a refund?" --state "I was charged twice."`
+
+If `data.model` looks like `jev-1.13.0`, the request reached TypeSafe. `auth status` does not.
+
+## What the agent is supposed to do
+
+1. `typesafe skills install` (once) so **typesafe-cli** and the official TypeSafe skill are on disk.
+2. `typesafe auth status` — read `has_key` only. Agents must not print or open `TYPESAFE_*` or key files.
+3. Write questions first. Each instruction backticks the state paths it needs. That list is what to collect.
+4. Fill only those paths. If a path is code, put the hunk body in, not a filename.
+5. Write JSON under `${TMPDIR:-/tmp}/codex/<project>/`, never in the git tree.
+6. `typesafe ask`. Apply thresholds in the agent (a noul near `0.5` is unsure). Jev does not pick the next tool.
+
+`typesafe agent schema` is the machine-readable command list. `--agent` makes `--help` JSON.
+
+## Install
+
+Python 3.10+ and a key from the [TypeSafe console](https://console.typesafe.ai/settings/keys).
+
+```bash
+export TYPESAFE_API_KEY=apikey_…
+
+pip install typesafeai-cli
+# or: pipx install typesafeai-cli
+# or clone, then: uv sync && uv run typesafe --help
+```
+
+`install.sh` on the repo and on each release can also install the GitHub wheel. Optional: `TYPESAFE_BASE_URL`, `TYPESAFE_DEFAULT_MODEL`. `--key` / `--creds` are for scripts, not for agents scraping secrets.
+
+## Commands
+
+| | |
+| --- | --- |
+| `typesafe ask` | State file + questions file |
+| `typesafe noul` / `choice` / `score` | One question |
+| `typesafe find` | Search a local file by plain-language query |
+| `typesafe rank` | Rerank a JSON shortlist |
+| `typesafe extract` | Pick a verbatim span (email / phone / money / `--candidates`) |
+| `typesafe verify` | Check a claim against a source (missing quote → fabricated) |
+| `typesafe screen` | Jailbreak / injection / sensitive-data / harm gate |
+| `typesafe suggest-skill` | At most one skill name, or none |
+| `typesafe decide` | Map nouls/choices to no / uncertain / yes (no HTTP) |
+| `typesafe models` | Aliases (`jev-latest`, …) |
+| `typesafe smoke` | Live docs quickstart |
+| `typesafe auth status` | `has_key`; never prints the key |
+| `typesafe agent schema` | JSON command tree |
+| `typesafe skills install` | Official TypeSafe skill + **typesafe-cli** |
+
+Exit `0` answered, `1` request failed (including missing key on `ask`), `2` bad flags or questions (no HTTP).
+
+## Releases
+
+A merge to `main` that passes CI ships automatically: patch bump, tag `vX.Y.Z`, GitHub release, PyPI (`release.yml`, environment `pypi`). Start the merge commit with `[skip release]` to skip. For a minor or major, run **Prepare Release** and pick the bump.
+
+Match `version` in `pyproject.toml` to `__version__` in `src/typesafe_cli/__init__.py` if you tag by hand.

typesafeai_cli-0.3.1/examples/README.md

@@ -0,0 +1,15 @@
+Samples for the TypeSafe **agent CLI**. How to run them, install, and what agents should do lives in the [project README](../README.md).
+
+| Directory | What it is |
+| --- | --- |
+| [ticket/](ticket/) | Support message → refund / intent / frustration |
+| [code-change/](code-change/) | A skill hunk → whether agents must attach real code |
+
+Copy these into a temp dir before a live call (agents use `${TMPDIR:-/tmp}/codex/<project>/`, not the git tree):
+
+```bash
+WORKDIR="${TMPDIR:-/tmp}/codex/typesafeai-cli"
+mkdir -p "$WORKDIR"
+cp examples/ticket/*.json "$WORKDIR/"
+typesafe ask --state-file "$WORKDIR/state.json" --questions-file "$WORKDIR/questions.json"
+```

typesafeai_cli-0.3.1/examples/code-change/questions.json

@@ -0,0 +1,25 @@
+{
+  "enough_code_in_state": {
+    "type": "noul",
+    "instructions": "Does `files[0].hunk` require the agent to put the actual code slice into state when a question path is code, rather than a path or 'see the PR'?"
+  },
+  "what_to_do": {
+    "type": "choice",
+    "instructions": "Given `task` and `files[0].hunk`, what should we do with this skill?",
+    "criteria": {
+      "keep": "Keep questions-first collection; do not add a job catalog",
+      "thin": "Cut the skill down to command examples only",
+      "expand": "Add per-job recipes (diff, CI, routing, …)",
+      "abstain": "Not enough in state to decide"
+    }
+  },
+  "clarity": {
+    "type": "score",
+    "instructions": "How clearly does `files[0].hunk` tell an agent to attach real code when the judgment is about a change?",
+    "criteria": [
+      "Silent; agents would send only a path",
+      "Mentions code but easy to skip the hunk",
+      "Clear: a code path must contain the slice"
+    ]
+  }
+}

typesafeai_cli-0.3.1/examples/code-change/state.json

@@ -0,0 +1,10 @@
+{
+  "task": "An agent is about to call Jev on a pull request. Decide whether the typesafe-cli skill tells that agent to attach real code, or only a file path.",
+  "files": [
+    {
+      "path": "src/typesafe_cli/data/typesafe-cli/SKILL.md",
+      "line_range": "50-74",
+      "hunk": "### 2. Name the decision, then write the questions\n\nDo not start by dumping context. TypeSafe's contract is the questions: they name the fields Jev is allowed to look at.\n\nThen write `$WORKDIR/questions.json`. Each question's `instructions` must point at named paths with backticks (`task`, `files[0].hunk`, `tools`). Those paths **are** the collection list.\n\n### 3. Fill only those fields\n\nIf a path is code (`files[0].hunk`), the value must be the slice (path + line range + body), not a filename and not \"see the PR.\" Prefer under ~8k tokens of code. Do not send the tree.\n"
+    }
+  ]
+}

typesafeai_cli-0.3.1/examples/ticket/questions.json

@@ -0,0 +1,24 @@
+{
+  "refund_requested": {
+    "type": "noul",
+    "instructions": "Does `message` request a refund?"
+  },
+  "intent": {
+    "type": "choice",
+    "instructions": "What does `message` ask for?",
+    "criteria": {
+      "refund": "The customer wants money returned",
+      "information": "The customer wants an explanation only",
+      "other": "Something else"
+    }
+  },
+  "frustration": {
+    "type": "score",
+    "instructions": "How frustrated does the customer sound in `message`?",
+    "criteria": [
+      "Calm and factual",
+      "Annoyed but civil",
+      "Very angry"
+    ]
+  }
+}

typesafeai_cli-0.3.1/examples/ticket/state.json

@@ -0,0 +1,4 @@
+{
+  "message": "I was charged twice for order A-104. Please refund the duplicate. This is the third time.",
+  "policy": "Duplicate charges are eligible for an immediate refund. One-off goodwill refunds need a human."
+}

typesafeai_cli-0.3.1/install.sh

@@ -0,0 +1,125 @@
+#!/usr/bin/env bash
+# Optional installer for the typesafe CLI. Prefer pipx if you have it:
+#   pipx install typesafeai-cli
+#
+# This script installs the wheel from the GitHub release (Pup-style
+# "download the artifact") or from PyPI.
+#
+#   ./install.sh
+#   TYPESAFE_CLI_VERSION=v0.2.0 ./install.sh
+#   TYPESAFE_CLI_FROM=pypi ./install.sh
+#
+# Env:
+#   TYPESAFE_CLI_VERSION   tag like v0.2.0, or "latest" (default)
+#   TYPESAFE_CLI_FROM      github (default) or pypi
+set -euo pipefail
+
+REPO="${TYPESAFE_CLI_REPO:-maddygoround/typesafeai-cli}"
+PKG="${TYPESAFE_CLI_PKG:-typesafeai-cli}"
+BIN="${TYPESAFE_CLI_BIN:-typesafe}"
+VERSION="${TYPESAFE_CLI_VERSION:-latest}"
+FROM="${TYPESAFE_CLI_FROM:-github}"
+API="https://api.github.com/repos/${REPO}"
+
+say() { printf '%s\n' "$*" >&2; }
+die() { say "install.sh: $*"; exit 1; }
+
+need_python() {
+  if ! command -v python3 >/dev/null 2>&1; then
+    die "python3 is required (3.10+)"
+  fi
+  python3 - <<'PY'
+import sys
+if sys.version_info < (3, 10):
+    raise SystemExit(f"python 3.10+ required, found {sys.version.split()[0]}")
+PY
+}
+
+resolve_tag() {
+  if [ "$VERSION" != "latest" ]; then
+    case "$VERSION" in
+      v*) printf '%s\n' "$VERSION" ;;
+      *) printf 'v%s\n' "$VERSION" ;;
+    esac
+    return
+  fi
+  python3 - <<PY
+import json, urllib.request
+url = "${API}/releases/latest"
+req = urllib.request.Request(url, headers={"Accept": "application/vnd.github+json", "User-Agent": "typesafe-install"})
+with urllib.request.urlopen(req, timeout=30) as resp:
+    data = json.load(resp)
+tag = data.get("tag_name") or ""
+if not tag:
+    raise SystemExit("could not resolve latest GitHub release")
+print(tag)
+PY
+}
+
+wheel_url_for_tag() {
+  local tag="$1"
+  python3 - <<PY
+import json, urllib.request
+url = "${API}/releases/tags/${tag}"
+req = urllib.request.Request(url, headers={"Accept": "application/vnd.github+json", "User-Agent": "typesafe-install"})
+with urllib.request.urlopen(req, timeout=30) as resp:
+    data = json.load(resp)
+for asset in data.get("assets") or []:
+    name = asset.get("name") or ""
+    if name.endswith(".whl"):
+        print(asset["browser_download_url"])
+        break
+else:
+    raise SystemExit("no wheel on GitHub release ${tag}")
+PY
+}
+
+have() { command -v "$1" >/dev/null 2>&1; }
+
+install_spec() {
+  local spec="$1"
+  if have pipx; then
+    pipx install --force "$spec"
+  elif have uv; then
+    uv tool install --force "$spec"
+  else
+    say "pipx/uv not found; using python3 -m pip --user"
+    python3 -m pip install --user --upgrade "$spec"
+  fi
+}
+
+main() {
+  need_python
+  if [ "$FROM" = "pypi" ]; then
+    local spec
+    if [ "$VERSION" = "latest" ]; then
+      spec="$PKG"
+    else
+      spec="${PKG}==${VERSION#v}"
+    fi
+    say "installing ${spec} from PyPI"
+    install_spec "$spec"
+  else
+    local tag url tmp
+    tag="$(resolve_tag)"
+    say "using GitHub release ${tag}"
+    url="$(wheel_url_for_tag "$tag")"
+    say "wheel ${url}"
+    tmp="$(mktemp -d)"
+    trap 'rm -rf "$tmp"' EXIT
+    python3 - <<PY
+import urllib.request
+urllib.request.urlretrieve("${url}", "${tmp}/pkg.whl")
+PY
+    install_spec "${tmp}/pkg.whl"
+  fi
+
+  if have "$BIN"; then
+    say "ok: $(command -v "$BIN")"
+  else
+    say "installed the package, but '${BIN}' is not on PATH."
+    say "add ~/.local/bin to PATH, then run: ${BIN} --help"
+  fi
+}
+
+main "$@"

typesafeai_cli-0.3.1/pyproject.toml

@@ -0,0 +1,55 @@
+[project]
+name = "typesafeai-cli"
+version = "0.3.1"
+description = "Agent CLI for TypeSafe System One (Jev)"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "safeaiforeveryone" }]
+keywords = ["typesafe", "jev", "cli"]
+classifiers = [
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "typesafe-sdk>=0.6.0",
+    "typer>=0.12",
+]
+
+[project.urls]
+Homepage = "https://github.com/maddygoround/typesafeai-cli"
+Repository = "https://github.com/maddygoround/typesafeai-cli"
+Issues = "https://github.com/maddygoround/typesafeai-cli/issues"
+Releases = "https://github.com/maddygoround/typesafeai-cli/releases"
+
+[project.scripts]
+typesafe = "typesafe_cli.cli:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/typesafe_cli"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/examples",
+    "/install.sh",
+    "/README.md",
+    "/LICENSE",
+]
+
+[dependency-groups]
+dev = ["pytest>=8"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+addopts = "-q"

typesafeai_cli-0.3.1/src/typesafe_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.3.1"

typesafeai_cli-0.3.1/src/typesafe_cli/cli.py

@@ -0,0 +1,93 @@
+from __future__ import annotations
+
+import typer
+
+from typesafe_cli.commands.agent import schema as agent_schema
+from typesafe_cli.commands.ask import ask
+from typesafe_cli.commands.auth import status as auth_status
+from typesafe_cli.commands.decide import decide
+from typesafe_cli.commands.extract import extract
+from typesafe_cli.commands.find import find
+from typesafe_cli.commands.models import models
+from typesafe_cli.commands.oneshot import choice, noul, score
+from typesafe_cli.commands.rank import rank
+from typesafe_cli.commands.screen import screen
+from typesafe_cli.commands.skills import install as skills_install
+from typesafe_cli.commands.skills import list_skills
+from typesafe_cli.commands.smoke import smoke
+from typesafe_cli.commands.suggest_skill import suggest_skill
+from typesafe_cli.commands.verify import verify
+from typesafe_cli.help import AgentCommand, AgentGroup
+
+app = typer.Typer(
+    name="typesafe",
+    cls=AgentGroup,
+    no_args_is_help=True,
+    add_completion=False,
+    pretty_exceptions_enable=False,
+    help="Agent CLI for TypeSafe System One (Jev). Typed judgments, not chat. Agents must not read TYPESAFE_* env vars or key files; use typesafe auth status.",
+)
+
+
+def _on_agent(args: bool = False) -> bool:
+    if args:
+        from typesafe_cli.detect import set_force_agent
+
+        set_force_agent(True)
+    return args
+
+
+def _on_no_agent(args: bool = False) -> bool:
+    if args:
+        from typesafe_cli.detect import set_force_agent
+
+        set_force_agent(False)
+    return args
+
+
+@app.callback()
+def _global_options(
+    agent: bool = typer.Option(
+        False,
+        "--agent",
+        help="Force agent mode (JSON help/schema)",
+        is_eager=True,
+        callback=_on_agent,
+    ),
+    no_agent: bool = typer.Option(
+        False,
+        "--no-agent",
+        help="Disable agent mode",
+        is_eager=True,
+        callback=_on_no_agent,
+    ),
+) -> None:
+    del agent, no_agent
+
+
+auth_app = typer.Typer(cls=AgentGroup, no_args_is_help=True, help="Authentication helpers")
+auth_app.command("status", cls=AgentCommand)(auth_status)
+app.add_typer(auth_app, name="auth")
+
+agent_app = typer.Typer(cls=AgentGroup, no_args_is_help=True, help="Agent discovery")
+agent_app.command("schema", cls=AgentCommand)(agent_schema)
+app.add_typer(agent_app, name="agent")
+
+skills_app = typer.Typer(cls=AgentGroup, no_args_is_help=True, help="Install the official TypeSafe skill")
+skills_app.command("install", cls=AgentCommand)(skills_install)
+skills_app.command("list", cls=AgentCommand)(list_skills)
+app.add_typer(skills_app, name="skills")
+
+app.command("ask", cls=AgentCommand)(ask)
+app.command("noul", cls=AgentCommand)(noul)
+app.command("choice", cls=AgentCommand)(choice)
+app.command("score", cls=AgentCommand)(score)
+app.command("find", cls=AgentCommand)(find)
+app.command("rank", cls=AgentCommand)(rank)
+app.command("extract", cls=AgentCommand)(extract)
+app.command("verify", cls=AgentCommand)(verify)
+app.command("screen", cls=AgentCommand)(screen)
+app.command("suggest-skill", cls=AgentCommand)(suggest_skill)
+app.command("decide", cls=AgentCommand)(decide)
+app.command("models", cls=AgentCommand)(models)
+app.command("smoke", cls=AgentCommand)(smoke)