@oracle-agent/oracle 0.26.0 → 0.28.0

package/README.md

@@ -13,7 +13,7 @@ oracle doctor                           # verify local posture
 
 `oracle setup model` offers Anthropic, OpenAI Codex, and Grok OAuth plus secure
 API-key setup for OpenRouter, OpenAI, Anthropic, xAI, DeepSeek, Gemini, Kimi,
-Mistral, and custom OpenAI-compatible providers. `oracle auth status` reports
+Mistral, Nous, and custom OpenAI-compatible providers. `oracle auth status` reports
 providers without printing credentials. Linux, Windows, and macOS apps are in beta.
 
 The CLI, source, and desktop beta are public to everyone. Locals Only holders
@@ -242,7 +242,7 @@ known answer. This matters: the canonical QuoterV2 address also has bytecode on
 Base, but does not price that chain's pairs. A codesize check would have
 allowlisted the wrong contract.
 
-**86 provider modules** in the read/quote catalog, covering **220 unique
+**88 provider modules** in the read/quote catalog, covering **220 unique
 protocols/venues** across EVM, Solana, and Bitcoin (115 EVM + cross-chain, 98
 Solana venues backed by 101 verified Jupiter program IDs, 6 Bitcoin surfaces).
 One module can cover many protocols: the Jupiter module alone routes 98 Solana

package/SETUP.md

@@ -73,6 +73,12 @@ oracle --version
 This installs into `~/.local/share/oracle` and puts `oracle` on `~/.local/bin`
 (no sudo, no global `npm -g`). Re-run the same command to upgrade.
 
+On an interactive terminal the installer prints a small ASCII globe banner
+while it works. When stdout isn't a TTY (piped through another script, CI,
+`TERM=dumb`, or `NO_COLOR` set), it skips the globe and stays to plain
+`oracle-install: ...` log lines instead. Set `ORACLE_INSTALL_PLAIN=1` to force
+the plain form even on an interactive terminal.
+
 npm still works if you prefer:
 
 ```bash
@@ -108,7 +114,7 @@ model. Use `--no-browser` when the browser must be opened manually.
 
 ```bash
 oracle setup model openrouter
-# also supported: openai, anthropic, xai, deepseek, gemini, kimi, mistral, custom
+# also supported: openai, anthropic, xai, deepseek, gemini, kimi, mistral, nous, custom
 ```
 
 Interactive API-key entry is hidden. Do not put a key directly in the command
@@ -135,6 +141,17 @@ available, with a private `0600` local fallback.
 oracle
 ```
 
+On a fresh TTY, the first `oracle`/`oracle chat` run walks through, in order:
+
+1. Model setup (`oracle setup model`) if no provider is configured yet —
+   OAuth first (`claude`, `codex`, `grok`), then API-key providers.
+2. The onboarding splash: a welcome panel with the orb, Enter opens the
+   chain picker, arrow keys + Enter select a chain (Esc skips at either
+   screen), then a ready card. It shows once per install and is marked done
+   under `ORACLE_CONFIG_DIR`; `ORACLE_ONBOARDING=0` skips it, `oracle chat
+   --onboard` replays it.
+3. Chat itself.
+
 Useful first commands:
 
 ```bash
@@ -146,9 +163,18 @@ oracle doctor
 
 Inside chat:
 
+- `/sessions`, `/new [title]`, `/1`–`/9`, `/resume [n]`, `/session rm <n>` —
+  manage numbered chat sessions.
 - `/chain` lists or selects the active chain.
 - `/model` changes the model without changing the Oracle persona.
 - `/setup` opens optional messaging setup.
+- `/help` lists every in-chat command.
+
+Chat always runs on Oracle's own native loop unless you explicitly opt into
+Hermes with `ORACLE_CHAT_BACKEND=hermes` (or `oracle chat --backend
+hermes`); the default `auto` resolution never selects Hermes on its own, and
+an explicit `hermes` request fails closed with an actionable error if Hermes
+isn't actually detected.
 
 A model response is not authorization, a prepared object is not a transaction,
 and a submitted transaction is not a confirmed receipt.

package/dist/assets/skills/oracle-desk-product/SKILL.md

@@ -97,7 +97,7 @@ does not prove npm users receive it. A locally hosted model/data/policy loop doe
 a bundled signer. A merged feature is not public until the npm artifact containing it is
 published and inspected.
 
-**Candidate release in this source tree:** public package `@oracle-agent/oracle@0.26.0`
+**Candidate release in this source tree:** public package `@oracle-agent/oracle@0.28.0`
 ships the encrypted local vault + short-lived loopback signer. Hosted/keyless
 Oracle cannot hold keys or move funds. Self-host after `oracle sign init|import` is **auto-armed**
 for user-initiated actions. Public still charges the disclosed fee card; Administrator