highhxcli 0.3.2__tar.gz → 0.4.0__tar.gz

{highhxcli-0.3.2 → highhxcli-0.4.0}/CHANGELOG.md

@@ -6,6 +6,63 @@ project uses [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-09-27
+
+One interactive HighhX for both plans: run `highhx` and describe what you want.
+
+### Added
+
+- **Interactive session.** `highhx` with no arguments in a terminal opens the HighhX session
+  (`highhx agent` opens the same one). Free and Pro share the interface; the plan decides
+  which capabilities are attached. Status line: `Free • Local`, `Free • Connected`,
+  `Pro • Connected`, `Pro • Offline (cached)`, `… • Platform unavailable`.
+- **Capabilities** (`highhx.cloud.capabilities`): local capabilities (commands, shell,
+  deterministic intents, deterministic automation) plus the platform-reported plan
+  features. The platform stays authoritative and enforces every AI request.
+- **Free in the session:** known plain-language requests run the matching HighhX command
+  deterministically (the `highhx do` rules, no AI); `!command` runs shell commands through
+  the engine (risk, policy, approval, history); `highhx <command>` runs any command in place.
+  Requests that need AI show a **HighhX Pro capability** panel naming the capability, with
+  local alternatives (`[1-3] Continue locally`, `[p] View Pro`).
+- **Platform resilience:** without the platform, local capabilities keep working; when the
+  AI gateway fails during a request, the session says so and offers the local route.
+- **Plan changes apply in place:** `highhx login` / `/account` in the session re-checks the
+  account and attaches or detaches the AI agent.
+- Slash commands `/tools`, `/config`, `/account`, `/pro`; agent-only commands explain
+  that they need Pro on Free.
+- Input: `"""` blocks for multi-line input, readline-safe coloured prompt (clean redraw of
+  long lines and history), Ctrl+C at the prompt no longer cancels the application token.
+- Tool outcomes distinguish blocked / declined (⊘) and cancelled (○) from failures (✗);
+  approvals render as panels.
+
+### Security
+
+- The AI agent runtime is only constructed on a live confirmation from the platform:
+  `create_session` refuses a cached account, and a cached account grants no platform
+  capability (the cache is an editable local file). Previously an edited cache could start
+  the runtime offline (it still could not reach a model — the gateway checks every request).
+- Free/Pro boundary tests: tripwires on every AI entry point, a static scan for
+  bring-your-own-key paths and vendor SDK imports, and an instrumented interpreter that
+  records environment lookups (no provider key is ever read on Free).
+
+### Fixed
+
+- `highhx do` and the session no longer treat file names as websites or applications
+  (`open main.py` opened `https://main.py`).
+- `highhx -v agent …`, `highhx -C DIR agent …` or a bare `highhx -v` typed inside the
+  session no longer start a nested session.
+- An unexpected error in one command or agent turn no longer ends the session.
+- Known requests that change files (`fix`, `install dependencies`) are confirmed first when
+  typed as free-form text in the session.
+- A signed-in session that started offline attaches the AI agent once the platform is back.
+
+### Changed
+
+- The startup banner is the same for Free and Pro ("Developer command center" with git
+  state and plan status).
+- `highhx` outside a terminal, and with `--json` or `--quiet`, still prints the help (CI and
+  scripts are unaffected). One-shot `highhx agent "…"` requests still require Pro (exit 10).
+
 ## [0.3.0] - 2026-09-27
 
 Two plans, one platform: **Free** is deterministic HighhX; **Pro** adds the AI agent and AI

{highhxcli-0.3.2 → highhxcli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: highhxcli
-Version: 0.3.2
+Version: 0.4.0
 Summary: HighhX — the developer command center CLI, with HighhX Pro: an AI developer agent in your terminal.
 Author: HighhX contributors
 License-Expression: MIT
@@ -50,11 +50,13 @@ history of everything it did. Every risky action is classified and needs approva
 
 | | |
 |---|---|
-| **HighhX Free** | Deterministic HighhX: the full developer CLI plus browser/desktop automation with known targets (`highhx computer`, `highhx do`). Local, no account, no AI. |
-| **HighhX Pro** | Everything in Free plus `highhx agent` — an AI developer agent that plans, changes code, runs your tools, operates browsers and apps (AI computer use), recovers from failures and verifies the result. |
+| **HighhX Free** | The interactive `highhx` session and the full developer CLI: known requests in plain language run locally without AI, plus every command, shell commands with risk checks and approvals, and browser/desktop automation with known targets (`highhx computer`, `highhx do`). Local, no account, no AI. |
+| **HighhX Pro** | The same session with the AI developer agent attached — it plans, changes code, runs your tools, operates browsers and apps (AI computer use), recovers from failures and verifies the result. |
 
-Free and Pro share one execution platform: the same tools, safety policy, confirmations,
-verification and audit trail. The AI only chooses actions; it never gets its own way to run them.
+Run `highhx` in a terminal and describe what you want. Free and Pro share one interface and
+one execution platform: the same tools, safety policy, confirmations, verification and audit
+trail. Your plan only decides which capabilities the session has — the HighhX platform grants
+and enforces them. The AI only chooses actions; it never gets its own way to run them.
 
 ```text
 $ highhx doctor
@@ -79,6 +81,7 @@ Suggested actions
 - [Why HighhX](#why-highhx)
 - [Installation](#installation)
 - [Quick start](#quick-start)
+- [The interactive session](#the-interactive-session)
 - [HighhX Pro: the AI developer agent](#highhx-pro-the-ai-developer-agent)
 - [Commands](#commands)
 - [Workflows](#workflows)
@@ -159,20 +162,79 @@ highhx logs            # output of the last execution (secrets redacted)
 └── logs/                # execution logs (git-ignored)
 ```
 
+## The interactive session
+
+`highhx` with no arguments, in a terminal, opens the HighhX session (`highhx agent` opens the
+same one). Outside a terminal, and with `--json` or `--quiet`, it prints the help as before,
+so scripts and CI are unaffected.
+
+```text
+$ highhx
+
+  (the Knight)   HighhX v0.4.0
+                 Developer command center
+                 ~/code/shop
+                 main • clean
+                 Free • Local
+
+❯ show git status
+
+◉ highhx git status
+✓ Working tree clean
+✓ highhx git status (0.1s)
+
+❯ Fix the failing tests
+
+╭─ HighhX Pro capability ─────────────────────────────╮
+│  AI code changes require HighhX Pro.                │
+│                                                     │
+│  Available locally, without AI:                     │
+│  1  Run the tests         highhx test               │
+│  2  Diagnose the project  highhx diagnose           │
+│  3  Show recent logs      highhx logs               │
+│                                                     │
+│  [1-3] Continue locally    [p] View Pro             │
+╰─────────────────────────────────────────────────────╯
+```
+
+- **Plain language first.** On Free, requests that map to a known action (*run the tests*,
+  *run the checks*, *build*, *show git status*, *security scan*, *open localhost:3000* …)
+  run the matching HighhX command — deterministically, no AI. Requests that need
+  understanding name the Pro capability they need and offer the local commands that can
+  do part of the job. On Pro the AI agent handles every request.
+- **`!command`** runs a shell command through the HighhX engine (risk classification,
+  policy, approval, history); **`highhx <command>`** runs any HighhX command in the session.
+- **Input.** ↑/↓ history (kept across sessions), line editing, `\` at the end of a line or
+  a `"""` block for multi-line input, Ctrl+C interrupts the running request, Ctrl+D exits.
+- **Status line.** `Free • Local`, `Free • Connected`, `Pro • Connected`,
+  `Pro • Offline (cached)` or `… • Platform unavailable`. Only a live answer from the
+  platform attaches the AI agent. When the platform cannot be reached, local capabilities
+  keep working and the session re-checks when a request needs the agent; if the gateway
+  fails during a Pro request, the session says so and offers the local route for it.
+- **Deterministic means predictable.** Free never calls a model or reads a provider API key.
+  File names are never treated as websites (`open main.py` is not `https://main.py`), and
+  known requests that change files (`fix`, `install dependencies`) ask first.
+- **Plan changes apply in place.** Run `highhx login` (or `/account` after upgrading) inside
+  the session and it re-checks your account: the AI agent attaches when the platform grants
+  it, and detaches when it no longer does.
+- **Slash commands.** `/help` `/status` `/tools` `/context` `/config` `/account` `/usage`
+  `/history` `/memory` `/pro` `/clear` `/quit`, plus the agent's `/plan` `/model` `/mode`
+  `/changes` `/undo` (Pro).
+
 ## HighhX Pro: the AI developer agent
 
 ```text
-$ highhx agent
+$ highhx
 
      ▗█▖
      ▐▀▌
     ▗ ▄ ▖
    ▗▚▐█▌▞▖
-  ▗▚█▐█▌█▞▖      HighhX v0.3.0
-   ▟█▐█▌█▙       AI Developer Agent · Pro
+  ▗▚█▐█▌█▞▖      HighhX v0.4.0
+   ▟█▐█▌█▙       Developer command center
   ▐▐█▌█▐█▌▌      ~/code/shop
-  █▗▜▌█▐▛▖█
-  █▐▙▘█▝▟▌█
+  █▗▜▌█▐▛▖█      main • clean
+  █▐▙▘█▝▟▌█      Pro • Connected
   ▐▐▜▌▄▐▛▌▌
  ▗▝▐▐▌█▐▌▌▘▖
  █▙▝█▌█▐█▘▟█
@@ -180,10 +242,7 @@ $ highhx agent
  ▀█▟▀ █ ▀▙█▀
    ▀▌ █ ▐▀
 
-Project   shop
-Stack     Python, FastAPI
-Branch    main
-Status    clean
+Project   shop Python, FastAPI
 AI        Connected HighhX (managed)
 
 What would you like me to do? (/help for commands)
@@ -200,8 +259,10 @@ Proceed? [Y/n]
 
 ✓ Run tests — 3 tests failing (4.1s)
 ✓ Read src/shop/cart.py — 88 lines
-⚠ Action requires approval
-  Edit src/shop/cart.py (+2 -1)
+
+╭─ ⚠ Action requires approval ─────────────────────╮
+│  Edit src/shop/cart.py (+2 -1)                   │
+╰──────────────────────────────────────────────────╯
   …diff…
 Proceed? [y/N/a=always this session] y
 ✓ Edit src/shop/cart.py — +2 -1
@@ -227,8 +288,8 @@ summarises it.
   choose `--mode auto-edit`); pushes, deploys and rollbacks always ask; production
   deploys need typed confirmation. The agent cannot leave the project, read secret files
   or touch `.git/`. `--mode read-only` investigates without changing anything.
-- **Slash commands.** `/help` `/status` `/plan` `/context` `/model` `/mode` `/history`
-  `/changes` `/undo` `/memory` `/usage` `/clear` `/quit`.
+- **Slash commands.** Everything from the [interactive session](#the-interactive-session), plus
+  `/plan` `/model` `/mode` `/changes` `/undo`.
 - **Sessions.** Saved per project: `highhx agent --continue`, `--resume ID`, `highhx agent sessions`.
 - **Scriptable.** `highhx agent "…"` outside a terminal (or with `--json`) handles one request
   and exits — `--yes --mode auto-edit` for unattended runs in CI.
@@ -243,7 +304,7 @@ summarises it.
 ```bash
 highhx login                 # browser sign-in (creates your account)
 highhx account upgrade       # HighhX Pro checkout
-highhx agent                 # interactive
+highhx                       # interactive session (also: highhx agent)
 highhx agent "why is the application crashing?"
 ```
 

{highhxcli-0.3.2 → highhxcli-0.4.0}/README.md

@@ -7,11 +7,13 @@ history of everything it did. Every risky action is classified and needs approva
 
 | | |
 |---|---|
-| **HighhX Free** | Deterministic HighhX: the full developer CLI plus browser/desktop automation with known targets (`highhx computer`, `highhx do`). Local, no account, no AI. |
-| **HighhX Pro** | Everything in Free plus `highhx agent` — an AI developer agent that plans, changes code, runs your tools, operates browsers and apps (AI computer use), recovers from failures and verifies the result. |
+| **HighhX Free** | The interactive `highhx` session and the full developer CLI: known requests in plain language run locally without AI, plus every command, shell commands with risk checks and approvals, and browser/desktop automation with known targets (`highhx computer`, `highhx do`). Local, no account, no AI. |
+| **HighhX Pro** | The same session with the AI developer agent attached — it plans, changes code, runs your tools, operates browsers and apps (AI computer use), recovers from failures and verifies the result. |
 
-Free and Pro share one execution platform: the same tools, safety policy, confirmations,
-verification and audit trail. The AI only chooses actions; it never gets its own way to run them.
+Run `highhx` in a terminal and describe what you want. Free and Pro share one interface and
+one execution platform: the same tools, safety policy, confirmations, verification and audit
+trail. Your plan only decides which capabilities the session has — the HighhX platform grants
+and enforces them. The AI only chooses actions; it never gets its own way to run them.
 
 ```text
 $ highhx doctor
@@ -36,6 +38,7 @@ Suggested actions
 - [Why HighhX](#why-highhx)
 - [Installation](#installation)
 - [Quick start](#quick-start)
+- [The interactive session](#the-interactive-session)
 - [HighhX Pro: the AI developer agent](#highhx-pro-the-ai-developer-agent)
 - [Commands](#commands)
 - [Workflows](#workflows)
@@ -116,20 +119,79 @@ highhx logs            # output of the last execution (secrets redacted)
 └── logs/                # execution logs (git-ignored)
 ```
 
+## The interactive session
+
+`highhx` with no arguments, in a terminal, opens the HighhX session (`highhx agent` opens the
+same one). Outside a terminal, and with `--json` or `--quiet`, it prints the help as before,
+so scripts and CI are unaffected.
+
+```text
+$ highhx
+
+  (the Knight)   HighhX v0.4.0
+                 Developer command center
+                 ~/code/shop
+                 main • clean
+                 Free • Local
+
+❯ show git status
+
+◉ highhx git status
+✓ Working tree clean
+✓ highhx git status (0.1s)
+
+❯ Fix the failing tests
+
+╭─ HighhX Pro capability ─────────────────────────────╮
+│  AI code changes require HighhX Pro.                │
+│                                                     │
+│  Available locally, without AI:                     │
+│  1  Run the tests         highhx test               │
+│  2  Diagnose the project  highhx diagnose           │
+│  3  Show recent logs      highhx logs               │
+│                                                     │
+│  [1-3] Continue locally    [p] View Pro             │
+╰─────────────────────────────────────────────────────╯
+```
+
+- **Plain language first.** On Free, requests that map to a known action (*run the tests*,
+  *run the checks*, *build*, *show git status*, *security scan*, *open localhost:3000* …)
+  run the matching HighhX command — deterministically, no AI. Requests that need
+  understanding name the Pro capability they need and offer the local commands that can
+  do part of the job. On Pro the AI agent handles every request.
+- **`!command`** runs a shell command through the HighhX engine (risk classification,
+  policy, approval, history); **`highhx <command>`** runs any HighhX command in the session.
+- **Input.** ↑/↓ history (kept across sessions), line editing, `\` at the end of a line or
+  a `"""` block for multi-line input, Ctrl+C interrupts the running request, Ctrl+D exits.
+- **Status line.** `Free • Local`, `Free • Connected`, `Pro • Connected`,
+  `Pro • Offline (cached)` or `… • Platform unavailable`. Only a live answer from the
+  platform attaches the AI agent. When the platform cannot be reached, local capabilities
+  keep working and the session re-checks when a request needs the agent; if the gateway
+  fails during a Pro request, the session says so and offers the local route for it.
+- **Deterministic means predictable.** Free never calls a model or reads a provider API key.
+  File names are never treated as websites (`open main.py` is not `https://main.py`), and
+  known requests that change files (`fix`, `install dependencies`) ask first.
+- **Plan changes apply in place.** Run `highhx login` (or `/account` after upgrading) inside
+  the session and it re-checks your account: the AI agent attaches when the platform grants
+  it, and detaches when it no longer does.
+- **Slash commands.** `/help` `/status` `/tools` `/context` `/config` `/account` `/usage`
+  `/history` `/memory` `/pro` `/clear` `/quit`, plus the agent's `/plan` `/model` `/mode`
+  `/changes` `/undo` (Pro).
+
 ## HighhX Pro: the AI developer agent
 
 ```text
-$ highhx agent
+$ highhx
 
      ▗█▖
      ▐▀▌
     ▗ ▄ ▖
    ▗▚▐█▌▞▖
-  ▗▚█▐█▌█▞▖      HighhX v0.3.0
-   ▟█▐█▌█▙       AI Developer Agent · Pro
+  ▗▚█▐█▌█▞▖      HighhX v0.4.0
+   ▟█▐█▌█▙       Developer command center
   ▐▐█▌█▐█▌▌      ~/code/shop
-  █▗▜▌█▐▛▖█
-  █▐▙▘█▝▟▌█
+  █▗▜▌█▐▛▖█      main • clean
+  █▐▙▘█▝▟▌█      Pro • Connected
   ▐▐▜▌▄▐▛▌▌
  ▗▝▐▐▌█▐▌▌▘▖
  █▙▝█▌█▐█▘▟█
@@ -137,10 +199,7 @@ $ highhx agent
  ▀█▟▀ █ ▀▙█▀
    ▀▌ █ ▐▀
 
-Project   shop
-Stack     Python, FastAPI
-Branch    main
-Status    clean
+Project   shop Python, FastAPI
 AI        Connected HighhX (managed)
 
 What would you like me to do? (/help for commands)
@@ -157,8 +216,10 @@ Proceed? [Y/n]
 
 ✓ Run tests — 3 tests failing (4.1s)
 ✓ Read src/shop/cart.py — 88 lines
-⚠ Action requires approval
-  Edit src/shop/cart.py (+2 -1)
+
+╭─ ⚠ Action requires approval ─────────────────────╮
+│  Edit src/shop/cart.py (+2 -1)                   │
+╰──────────────────────────────────────────────────╯
   …diff…
 Proceed? [y/N/a=always this session] y
 ✓ Edit src/shop/cart.py — +2 -1
@@ -184,8 +245,8 @@ summarises it.
   choose `--mode auto-edit`); pushes, deploys and rollbacks always ask; production
   deploys need typed confirmation. The agent cannot leave the project, read secret files
   or touch `.git/`. `--mode read-only` investigates without changing anything.
-- **Slash commands.** `/help` `/status` `/plan` `/context` `/model` `/mode` `/history`
-  `/changes` `/undo` `/memory` `/usage` `/clear` `/quit`.
+- **Slash commands.** Everything from the [interactive session](#the-interactive-session), plus
+  `/plan` `/model` `/mode` `/changes` `/undo`.
 - **Sessions.** Saved per project: `highhx agent --continue`, `--resume ID`, `highhx agent sessions`.
 - **Scriptable.** `highhx agent "…"` outside a terminal (or with `--json`) handles one request
   and exits — `--yes --mode auto-edit` for unattended runs in CI.
@@ -200,7 +261,7 @@ summarises it.
 ```bash
 highhx login                 # browser sign-in (creates your account)
 highhx account upgrade       # HighhX Pro checkout
-highhx agent                 # interactive
+highhx                       # interactive session (also: highhx agent)
 highhx agent "why is the application crashing?"
 ```
 

{highhxcli-0.3.2 → highhxcli-0.4.0}/docs/agent.md

@@ -4,18 +4,46 @@ HighhX has exactly two plans:
 
 | | |
 |---|---|
-| **Free** | Deterministic HighhX: every CLI command, workflows, diagnostics, build/test, git, deploy, deterministic browser/desktop automation (`highhx computer`, `highhx do`). No AI, no account needed. |
-| **Pro** | Everything in Free **plus** `highhx agent`: natural-language tasks, AI planning, adaptive multi-step execution, recovery and replanning, and AI computer use. |
-
-Free and Pro share one execution platform: the same tools, safety policy, human
-confirmation, verification, audit trail, sessions and engine. Pro adds an intelligence
-layer that *chooses* actions; it never gets its own way to execute them.
+| **Free** | The interactive `highhx` session with local capabilities: known plain-language requests run deterministically (no AI), every CLI command, `!shell` commands with approvals, workflows, diagnostics, build/test, git, deploy, deterministic browser/desktop automation (`highhx computer`, `highhx do`). No AI, no account needed. |
+| **Pro** | The same session **plus** the AI agent: natural-language tasks, AI planning, adaptive multi-step execution, recovery and replanning, and AI computer use. |
+
+Free and Pro share one interface and one execution platform: the same session, tools,
+safety policy, human confirmation, verification, audit trail and engine. Pro adds an
+intelligence layer that *chooses* actions; it never gets its own way to execute them.
+
+## Capabilities
+
+`highhx.cloud.capabilities` decides what a session can do. Local capabilities
+(`local.commands`, `local.shell`, `local.intents`, `local.automation`) are always
+there. Platform capabilities are the plan features (`agent`, `agent.code_changes`,
+`agent.commands`, `agent.git`, `agent.deploy`, `agent.computer_use`, `cloud.sessions`)
+and exist only when the HighhX platform reports them for your account. The result
+shapes the CLI only: the platform checks the plan on every AI request, so nothing
+local can unlock a Pro capability. Only a live answer from the platform attaches the
+agent: the locally cached account copy is shown (`Pro • Offline (cached)`) but grants
+nothing, and `create_session` — the one constructor of the agent runtime — refuses it.
+While the platform is unreachable the session keeps its local capabilities and re-checks
+the platform (at most every 20 seconds) when a request needs the agent; when the platform
+is back and grants Pro, the agent attaches and handles that request. If the gateway fails
+during a Pro request, the session says so and offers the local route for it.
+
+Free never calls a model, never reads a provider API key (there is no bring-your-own-key
+path; provider keys live only on the platform) and never constructs the agent runtime —
+`tests/unit/agent/test_free_pro_boundary.py` checks this with tripwires on every AI entry
+point, a static scan of the package and an instrumented interpreter.
+
+Requests that need a capability the session lacks show a **HighhX Pro capability**
+panel naming it (AI code changes, AI git operations, AI-driven deployment, AI browser
+and desktop automation, or the agent itself) with the HighhX commands that can do part
+of the job locally — `[1-3] Continue locally` runs one of them, `[p] View Pro` shows the
+plans. Nothing is blocked that Free can do: known requests run directly.
 
 ## Starting
 
 ```bash
 highhx login                                   # once (Pro)
-highhx agent                                   # interactive session in this project
+highhx                                         # interactive session in this project
+highhx agent                                   # the same session
 highhx agent "fix my failing tests"            # interactive, starting with this request
 highhx agent --continue                        # continue the last session in this project
 highhx agent --resume s-20260927T101500-3f9a1c
@@ -31,7 +59,8 @@ highhx agent --json --mode read-only "find security issues" | jq -r .text
 ```
 
 Exit codes: `0` completed, `1` stopped early (step limit, output limit, refusal,
-cancellation, provider failure), `10` no HighhX Pro account.
+cancellation, provider failure), `10` no HighhX Pro account. (One-shot requests are AI
+requests, so they need Pro; the interactive session works on every plan.)
 
 ## How a request runs
 

{highhxcli-0.3.2 → highhxcli-0.4.0}/src/highhx/__init__.py

@@ -1,5 +1,5 @@
 """HighhX — a local-first developer operations command center."""
 
-__version__ = "0.3.2"
+__version__ = "0.4.0"
 
 __all__ = ["__version__"]

{highhxcli-0.3.2 → highhxcli-0.4.0}/src/highhx/agent/bootstrap.py

@@ -15,6 +15,7 @@ from highhx.agent.session import AgentSession, AgentUI
 from highhx.agent.settings import AgentSettings
 from highhx.agent.sync import SessionSync
 from highhx.cloud.plans import AGENT, CLOUD_SESSIONS
+from highhx.core.errors import CloudError
 
 if TYPE_CHECKING:
     from highhx.cloud.account import Account, CloudAccount
@@ -62,8 +63,18 @@ def create_session(
     overrides: dict[str, Any] | None = None,
     resume: Resume | None = None,
 ) -> tuple[AgentSession, Account, bool]:
-    """Returns ``(session, account, resumed)``. Raises unless the account includes the agent."""
+    """Returns ``(session, account, resumed)``. Raises unless the platform confirms the agent.
+
+    This is the only production path that constructs the agent runtime. It requires a live
+    answer from the platform: a cached account (platform unreachable) is refused, so an
+    edited local cache can never start the runtime (and every model request is checked by
+    the platform again anyway)."""
     account = cloud.require(AGENT, what="The HighhX AI developer agent")
+    if account.cached:
+        raise CloudError(
+            "The HighhX AI agent needs the HighhX platform, which cannot be reached right now.",
+            hint="Local HighhX commands keep working; try again when you are back online.",
+        )
     settings = resolve_settings(app, account, overrides or {})
     provider = build_provider(settings, cloud, account)
     context = gather(app)

highhxcli-0.4.0/src/highhx/agent/input.py

@@ -0,0 +1,70 @@
+"""Reading requests in the interactive session.
+
+Line editing, ↑/↓ history (persisted across sessions), Ctrl+R search and redraw on
+terminal resize come from the platform's readline (GNU readline or libedit). The
+prompt's colour codes are wrapped in readline's ignore markers so wrapped long lines
+and recalled history redraw cleanly.
+
+Multi-line input: end a line with ``\\`` to continue it, or open a block with a line
+containing only ``\"\"\"`` and close it the same way (for pasting logs or code).
+"""
+
+from __future__ import annotations
+
+import contextlib
+from collections.abc import Callable
+
+from highhx.utils.paths import user_data_dir
+
+HISTORY_FILE = "agent-input-history"
+HISTORY_LENGTH = 1000
+BLOCK = '"""'
+PROMPT = "❯ "  # noqa: RUF001
+CONTINUATION = "… "
+PROMPT_MARKUP = f"[bold magenta]{PROMPT}[/bold magenta]"
+CONTINUATION_MARKUP = f"[dim]{CONTINUATION}[/dim]"
+
+
+def setup_readline() -> Callable[[], None]:
+    """Load the input history; returns a function that saves it."""
+    try:
+        import readline
+    except ImportError:  # pragma: no cover - Windows without pyreadline
+        return lambda: None
+    path = user_data_dir() / HISTORY_FILE
+    with contextlib.suppress(OSError):
+        readline.read_history_file(str(path))
+    readline.set_history_length(HISTORY_LENGTH)
+    with contextlib.suppress(Exception):  # libedit and GNU readline name the binding differently
+        readline.parse_and_bind("tab: complete")
+
+    def save() -> None:
+        with contextlib.suppress(OSError):
+            path.parent.mkdir(parents=True, exist_ok=True)
+            readline.write_history_file(str(path))
+
+    return save
+
+
+def ansi_prompt(text: str, sgr: str, *, color: bool) -> str:
+    """``text`` coloured with SGR ``sgr``, with the escapes hidden from readline's width count."""
+    if not color:
+        return text
+    return f"\001\033[{sgr}m\002{text}\001\033[0m\002"
+
+
+def read_request(read_line: Callable[[str], str], *, prompt: str, continuation: str) -> str:
+    """One request: a line, ``\\``-continued lines, or a ``\"\"\"`` block. Raises EOFError / KeyboardInterrupt."""
+    first = read_line(prompt)
+    if first.strip() == BLOCK:
+        lines: list[str] = []
+        while True:
+            line = read_line(continuation)
+            if line.strip() == BLOCK:
+                return "\n".join(lines)
+            lines.append(line)
+    lines = [first]
+    while lines[-1].endswith("\\"):
+        lines[-1] = lines[-1][:-1]
+        lines.append(read_line(continuation))
+    return "\n".join(lines)

highhxcli-0.4.0/src/highhx/agent/launch.py

@@ -0,0 +1,76 @@
+"""Start the interactive HighhX session — used by bare ``highhx`` and by ``highhx agent``.
+
+One entry point, one UI. The account's capabilities decide whether the AI agent
+session is attached (HighhX Pro) or requests are handled locally (HighhX Free); a
+platform that is unreachable or refuses the agent leaves the local capabilities.
+"""
+
+from __future__ import annotations
+
+import dataclasses
+from typing import TYPE_CHECKING, Any
+
+from highhx.cloud import capabilities
+from highhx.cloud.capabilities import LOCAL, Capability, Connection
+from highhx.core.errors import CloudError, HighhXError, UsageError
+
+if TYPE_CHECKING:
+    from highhx.agent.bootstrap import Resume
+    from highhx.agent.session import AgentSession
+    from highhx.cloud.account import Account
+    from highhx.commands import App
+
+
+def interactive_terminal(app: App) -> bool:
+    """True when the interactive session may start: a terminal on both ends and no --json / --quiet."""
+    options = app.options
+    if options.json or options.quiet or not options.is_interactive():
+        return False
+    return bool(app.output.console.is_terminal)
+
+
+def start_interactive(
+    app: App,
+    *,
+    first: str | None = None,
+    overrides: dict[str, Any] | None = None,
+    resume: Resume | None = None,
+) -> int:
+    from highhx.agent.bootstrap import Resume, create_session
+    from highhx.agent.repl import AgentREPL
+    from highhx.agent.running import registered
+    from highhx.agent.ui import TerminalUI
+
+    if getattr(app, "interactive_session", False):
+        raise UsageError("You are already in the HighhX session.", hint="Type your request at the prompt.")
+    app.interactive_session = True  # type: ignore[attr-defined]
+    out = app.output
+    cloud = app.cloud
+    ui = TerminalUI(out.console, out.symbols, interactive=True)
+    entitlements = capabilities.resolve(cloud)
+
+    def factory() -> tuple[AgentSession, Account, bool]:
+        return create_session(app, cloud, ui, overrides=overrides or {}, resume=Resume())
+
+    session: AgentSession | None = None
+    account: Account | None = entitlements.account
+    resumed = False
+    if entitlements.has(Capability.AI_AGENT):
+        try:
+            session, account, resumed = create_session(app, cloud, ui, overrides=overrides or {}, resume=resume)
+        except HighhXError as exc:
+            # The platform decides: when it refuses or cannot be reached (or the agent cannot be
+            # set up), the session starts with local capabilities instead of not at all.
+            problem = "HighhX platform unavailable." if isinstance(exc, CloudError) else exc.message
+            entitlements = dataclasses.replace(
+                entitlements,
+                capabilities=LOCAL,
+                connection=Connection.UNAVAILABLE,
+                problem=f"{problem} Local capabilities remain available.",
+            )
+    elif resume is not None and (resume.session_id or resume.latest):
+        ui.notice("info", "Saved agent sessions are part of HighhX Pro — starting a local session.")
+    repl = AgentREPL(session, ui, cloud, account, app=app, entitlements=entitlements, session_factory=factory)
+    session_id = session.record.id if session is not None and session.record else None
+    with registered(session_id, app.root):
+        return repl.run(first, resumed=resumed)

{highhxcli-0.3.2 → highhxcli-0.4.0}/src/highhx/agent/model/platform.py

@@ -89,7 +89,7 @@ class PlatformProvider:
                     ) from None
                 if resumes >= MAX_RESUMES or (cancel is not None and cancel.cancelled):
                     raise ModelProviderError(
-                        f"Streaming from the HighhX platform failed: {exc.message}", retryable=True
+                        f"Streaming from the HighhX platform failed: {exc.message}", retryable=True, connection=True
                     ) from None
             except _Gap as exc:
                 reason = str(exc)