@kynver-app/runtime 0.2.99 → 0.2.101

package/README.md

@@ -99,11 +99,11 @@ Set once in `kynver setup --provider claude|cursor|codex|gemini|gemini-api|opena
 | `cursor` (default) | `agent` on PATH ([Cursor Agent CLI](https://cursor.com/docs/cli/headless)) | `agent login` (OAuth) **or** `CURSOR_API_KEY` for headless runners. **Website chat uses this same CLI** when `workerProvider`/`chatProvider` is `cursor` — `agent` on PATH + `agent login` (or `CURSOR_API_KEY`). Missing/logged-out fails closed (no hosted-model fallback). |
 | `codex` (ChatGPT on your machine) | `codex` on PATH ([Codex CLI](https://developers.openai.com/codex/)) **or** `hermes` with `openai-codex` | `codex login` / `CODEX_API_KEY`, or `hermes auth status openai-codex`. **Website chat uses this same CLI** when `workerProvider`/`chatProvider` is `chatgpt` / `codex` / `gpt` — missing/logged-out fails closed (no hosted-model or Claude fallback). You do not need `OPENAI_API_KEY` for this path. Workers also spawn `codex exec`. When the standalone `codex` CLI is absent, harness workers can fall back to `hermes` openai-codex. |
 | `claude` (operator override) | `claude` on PATH | `claude login` (OAuth). Use `--provider claude` on dispatch/worker start, or set `executorRef: provider:claude` / `[worker-provider: claude]` on the board task. |
-| `gemini` | `gemini` on PATH ([Gemini CLI](https://github.com/google-gemini/gemini-cli)) | `gemini` login **or** `GEMINI_API_KEY` (allowlisted through the worker-env scrub, same as `CODEX_API_KEY`). Missing binary fails closed. |
+| `gemini` | Google Antigravity (`agy` on PATH, [install](https://antigravity.google/docs/cli/install)) | `kynver setup --provider gemini`, install Google Antigravity, then run `agy` once to sign in. **Website chat uses this same CLI** — no Gemini API key. A Gemini API key works only when `~/.gemini/antigravity-cli/settings.json` sets `"modelProvider": "gemini"` and `GEMINI_API_KEY` is set (still the CLI, not HTTP). Workers run `agy --prompt --output-format stream-json`. Set `KYNVER_GEMINI_BIN=gemini` only for a legacy enterprise `gemini` binary; that binary's website chat stays the HTTP key path. Missing binary fails closed. |
 | `gemini-api` | Google Gemini over HTTP (no local CLI). Default `https://generativelanguage.googleapis.com/v1beta/openai` | `KYNVER_GEMINI_API_KEY` or `GEMINI_API_KEY` — read in the daemon parent and handed to the runner over stdin, never argv/child env. Override the endpoint with `KYNVER_GEMINI_BASE_URL`. |
 | `openai-compatible` (aliases `openai`, `openai-api`) | Any OpenAI-compatible `/v1` chat-completions URL | `KYNVER_WORKER_BASE_URL` (required) + optional `KYNVER_WORKER_API_KEY` over stdin. This is the generic HTTP path — not the ChatGPT product option. |
 
-Both Gemini routes share `KYNVER_GEMINI_DEFAULT_MODEL` (default `gemini-2.5-pro`). Choose the route explicitly: `--provider gemini` vs `--provider gemini-api`, or `executorRef: provider:gemini[:model]` / `provider:gemini-api[:model]`. ChatGPT on a box: `--provider chatgpt` or `--provider codex` (same Codex CLI), or `executorRef: provider:chatgpt[:model]`.
+The `gemini-api` HTTP route and a legacy `gemini` binary use `KYNVER_GEMINI_DEFAULT_MODEL` (default `gemini-2.5-pro`). Google Antigravity omits that id at spawn so `agy` keeps the signed-in account's model; pass an Antigravity slug such as `gemini-3.1-pro-high` when you want a specific one. Choose the route explicitly: `--provider gemini` vs `--provider gemini-api`, or `executorRef: provider:gemini[:model]` / `provider:gemini-api[:model]`. ChatGPT on a box: `--provider chatgpt` or `--provider codex` (same Codex CLI), or `executorRef: provider:chatgpt[:model]`.
 
 Override per invocation: `kynver worker start ... --provider gemini` (requires operator intent; default dispatches stay on Cursor)
 
@@ -111,7 +111,7 @@ Install Cursor CLI (Windows PowerShell): `irm 'https://cursor.com/install?win32=
 
 Default Cursor model: `composer-2.5`. Override with `--model` on dispatch/worker start.
 
-Website chat (delegated turns claimed by `kynver daemon`) follows `chatProvider` if set, otherwise `workerProvider`. Cursor boxes spawn `agent --print --mode agent` by default in `~/.kynver/chat-workspace` (created empty — no monorepo clone, no `defaultRepo` assumption). ChatGPT boxes spawn `codex exec --json` in that same workspace (`codex login` or `CODEX_API_KEY`). Gemini boxes call Google over HTTP (`GEMINI_API_KEY` / `KYNVER_GEMINI_API_KEY`). A missing Codex CLI / login fails closed (`codex_cli_unavailable` / `codex_not_logged_in`) — no silent Claude fallback. Ask mode is only used when the website toggle requests it. The hosted personal-agent loop handles Agent-mode / factory turns so MEMBER users can call factory tools. Claude/Anthropic boxes keep the local Anthropic Messages path (`ANTHROPIC_API_KEY` or `kynver start --chat-oauth`). Command turns are unchanged (allowlist + auth proof).
+Website chat (delegated turns claimed by `kynver daemon`) follows `chatProvider` if set, otherwise `workerProvider`. Cursor boxes spawn `agent --print --mode agent` by default in `~/.kynver/chat-workspace` (created empty — no monorepo clone, no `defaultRepo` assumption). ChatGPT boxes spawn `codex exec --json` in that same workspace (`codex login` or `CODEX_API_KEY`). Google Antigravity boxes spawn `agy` in that same workspace (run `agy` once; a bare API key does not select HTTP). `gemini-api` and a legacy `gemini` binary still call Google over HTTP (`GEMINI_API_KEY` / `KYNVER_GEMINI_API_KEY`). A missing Codex CLI / login fails closed (`codex_cli_unavailable` / `codex_not_logged_in`). A missing or signed-out `agy` fails closed (`antigravity_cli_unavailable` / `antigravity_not_logged_in`) — no silent hosted-model fallback. Ask mode is only used when the website toggle requests it. The hosted personal-agent loop handles Agent-mode / factory turns so MEMBER users can call factory tools. Claude/Anthropic boxes keep the local Anthropic Messages path (`ANTHROPIC_API_KEY` or `kynver start --chat-oauth`). Command turns are unchanged (allowlist + auth proof).
 
 ## Contributing