@kynver-app/runtime 0.2.59 → 0.2.65

package/README.md

@@ -79,18 +79,18 @@ Run `kynver help` for the full flag-level usage.
 
 ## Worker providers
 
-Set once in `kynver setup --provider claude|cursor|codex|gemini|gemini-api` (stored in `~/.kynver/config.json` as `workerProvider`).
+Set once in `kynver setup --provider claude|cursor|codex|gemini|gemini-api|openai-compatible` (stored in `~/.kynver/config.json` as `workerProvider`). `--provider chatgpt` / `gpt` are aliases for `codex`.
 
 | Provider | CLI / endpoint | Auth |
 | --- | --- | --- |
 | `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` (BYO OAuth / Hermes subscription, low-cost orchestration) | `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` (ChatGPT Codex subscription). When the standalone `codex` CLI is absent, harness workers spawn `hermes chat -q … --provider openai-codex -Q` (non-interactive). Kynver never stores raw OAuth tokens — fingerprint audit only. Low-risk orchestration routes here when bound; privileged actions escalate to Cursor. |
+| `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-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` | Any OpenAI-compatible `/v1` chat-completions URL | `KYNVER_WORKER_BASE_URL` (required) + optional `KYNVER_WORKER_API_KEY` over stdin. |
+| `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]`.
+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]`.
 
 Override per invocation: `kynver worker start ... --provider gemini` (requires operator intent; default dispatches stay on Cursor)
 
@@ -98,7 +98,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). 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`). 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).
 
 ## Contributing