@@ -2,6 +2,9 @@
|
||||
|
||||
## Unreleased
|
||||
|
||||
- **`agent`**: Production ReAct harness. Default **QVAC** (local); optional OpenAI-compatible **REST** (`agent --setup` stores only the chosen backend). Full guest admin by default (**denylist**, not allowlist). Production flags **`--plan`**, **`--auto`**, **`--new`**, **`--compact`**, **`--max-turns`**, **`--model`**, **`--system`**. Inspect (no model): **`skills`**, **`todos`**, **`plan`**, **`undo`**, **`hooks`**, **`history`**, **`rewind`**, **`export`**, **`remember`**, **`recap`**. Grok-port tools include **`grep`** (`output_mode`), **`apply_patch`**, **`find_symbol`**, **`copy_path`**, **`diff_files`**, **`read_many`**, **`fuzzy_find`**, **`wait_for`**, **`undo_last_edit`**, **`git_log`/`show`/`blame`**, **`create_skill`**, session rewind/export, walk-up project skills (`.grok/skills`, `.agents/skills`, …). Discord **`/agent`** is the same session (shared `~/.agent`).
|
||||
- **`discord-bot`**: Full **`/agent`** surface (ask + inspect + session + models + settings). User-installable profile app; **`DISCORD_ID_WHITELIST`** always enforced (loaded from `~/.discord/.env` / `~/.env`). **`/holesail`** and **`/hdms`** interactive managers. See [developer-guide ch.21](../../developer-guide/21-discord-bots.md).
|
||||
|
||||
- **`summon`**: Text web browser (`ctx.tui`, cell buffer). HTML/CSS engine plus page JS via **`ctx.bare.bareVm`** (`bare-vm` / `bare-realm`) or a Function sandbox. **`--no-js`** / **`J`**. HTTP via **`ctx.httpFetch`**. See [summon.md](../../docs/reference/summon.md).
|
||||
- **`irc`**: Room browser (`/rooms`, Ctrl+L), featured Libera channels, `LIST` filter, self-JOIN switches buffer. Full slash table (`/query`/`/msg` print usage when args are missing). Random `osXXXXX` nick when USER looks like a container id. TLS prefers **`ctx.bareOsTlsConnect`** and falls back to **`ctx.bare.bareTls`**.
|
||||
|
||||
|
||||
@@ -70,7 +70,7 @@ Expected development-range targets (local machine, non-SSH):
|
||||
- `emitMs p95 < 10ms` in synthetic tests
|
||||
- `droppedRefreshPct p50 < 10%` with default `BARE_TOP_UI_MIN_MS=0`
|
||||
|
||||
**`agent`** is the OpenAI-compatible **HTTPS** assistant (**ReAct**-style tools, TTY streaming). Preamble pulls in **`lib/agent-*.js`**, **`agent-workspace.js`** (**`~/.agent/workspace/*.md`** loader), **`agent-skills.js`** (compact skill index + **`read_skill`**), **`agent-web-fetch.js`**, **`agent-tools.js`**, **`agent-tui.js`** (see **`build.mjs`** **`preamble.agent`**). Config and secrets live under `**~/.agent/**` on the **personal** drive (**`man agent`**). **Markdown soul files** default from [`share/agent-workspace/`](share/agent-workspace/) (also staged to **`kernel/share/agent-workspace/`** on build). Outbound HTTPS uses **`ctx.httpFetch`** (same **`BARE_OS_HTTP_ALLOWLIST`** / **`BARE_OS_HTTP_DENYLIST`** as delegated **`curl`** / **`wget`**); the **`web_fetch`** tool needs every target host allowlisted alongside your API origin. Maintainer smoke under the Bare runtime: from repo root **`npm run smoke:agent-web-fetch:bare`** ([`scripts/smoke-agent-web-fetch-bare.mjs`](../../scripts/smoke-agent-web-fetch-bare.mjs)). **`chat`** is separate: swarm / Protomux text chat (**`lib/chat-tui.js`** preamble; **`man chat`**). **`summon`** is the first-party text web browser (**`lib/summon-*.js`**; page JS via **`ctx.bare.bareVm`** / **`bare-vm`**; **`ctx.httpFetch`**; TTY uses **`ctx.tui.run`** with a cell buffer). Headless: **`summon dump|links|get URL`**. See [summon.md](../../docs/reference/summon.md) and **`man summon`**.
|
||||
**`agent`** is the in-guest **ReAct** coding agent (default **QVAC** via **`ctx.bareOsQvac*`**; optional OpenAI-compatible **REST**). Full guest admin by default (denylist). Preamble pulls in **`lib/agent-*.js`**, **`agent-workspace.js`** (**`~/.agent/workspace/*.md`** loader), **`agent-skills.js`** (compact skill index + **`read_skill`** / **`create_skill`**), **`agent-web-fetch.js`**, **`agent-tools.js`**, **`agent-tui.js`**, **`agent-grok-port.js`** (see **`build.mjs`** **`preamble.agent`**). Config and secrets live under `**~/.agent/**` on the **personal** drive (**`man agent`**). Inspect CLI: **`skills`**, **`todos`**, **`plan`**, **`undo`**, **`hooks`**, **`history`**, **`rewind`**, **`export`**, **`remember`**, **`recap`**. Discord **`/agent`** shares that session. **Markdown soul files** default from [`share/agent-workspace/`](share/agent-workspace/) (also staged to **`kernel/share/agent-workspace/`** on build). REST outbound HTTPS uses **`ctx.httpFetch`** (same **`BARE_OS_HTTP_ALLOWLIST`** / **`BARE_OS_HTTP_DENYLIST`** as delegated **`curl`** / **`wget`**); the **`web_fetch`** tool needs every target host allowlisted alongside your API origin. Maintainer smoke under the Bare runtime: from repo root **`npm run smoke:agent-web-fetch:bare`** ([`scripts/smoke-agent-web-fetch-bare.mjs`](../../scripts/smoke-agent-web-fetch-bare.mjs)). **`chat`** is separate: swarm / Protomux text chat (**`lib/chat-tui.js`** preamble; **`man chat`**). **`summon`** is the first-party text web browser (**`lib/summon-*.js`**; page JS via **`ctx.bare.bareVm`** / **`bare-vm`**; **`ctx.httpFetch`**; TTY uses **`ctx.tui.run`** with a cell buffer). Headless: **`summon dump|links|get URL`**. See [summon.md](../../docs/reference/summon.md) and **`man summon`**.
|
||||
|
||||
**`ls`** prepends **[`bare-os-lscolors`](../bare-os-lscolors/bare-os-lscolors.js)** for **`LS_COLORS`** / dircolors parsing. **`dircolors`** and **`theme`** integrate with the booter’s **`bare-os-theme-presets.js`** (see [docs/themes/README.md](../../docs/themes/README.md)).
|
||||
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
"agent --auto GOAL...",
|
||||
"agent skills | todos | plan | compact | reset | undo | hooks | history | rewind | export | remember | recap"
|
||||
],
|
||||
"description": "Runs the in-guest ReAct coding agent (QVAC local or OpenAI-compatible REST). Full guest admin by default (denylist). Tools include grep, apply_patch, web_search, git helpers, find_symbol, session rewind/export, todos, plan mode, and skills. History lives in ~/.agent/history.json.",
|
||||
"description": "Runs the in-guest ReAct coding agent. Default backend is QVAC (local ctx.bareOsQvac*); REST (OpenAI-compatible) is optional. Full guest admin by default (denylist): the read-only base system is /bin /etc /boot /lib /usr /share /proc /dev /sys /run. Tools include grep (output_mode), apply_patch, web_search, git helpers, find_symbol, copy_path, diff_files, create_skill, session rewind/export, todos, plan mode, and walk-up project skills. History lives in ~/.agent/history.json and is shared with Discord /agent. Inspect subcommands (skills, todos, plan, undo, hooks, history, rewind, export, remember, recap) do not call the model.",
|
||||
"options": [
|
||||
{
|
||||
"flag": "--setup, --config",
|
||||
@@ -87,6 +87,18 @@
|
||||
{
|
||||
"caption": "inspect skills",
|
||||
"code": "agent skills"
|
||||
},
|
||||
{
|
||||
"caption": "rewind last user turn",
|
||||
"code": "agent rewind"
|
||||
},
|
||||
{
|
||||
"caption": "remember a durable fact",
|
||||
"code": "agent remember \"holesail keys live in ~/.holesail\""
|
||||
},
|
||||
{
|
||||
"caption": "export transcript",
|
||||
"code": "agent export ~/.agent/export.md"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
@@ -61,9 +61,9 @@ Reasoning/process visibility is configurable in `config.json`:
|
||||
- `reasoning_max_chars` — bounded reasoning output
|
||||
- `reasoning_include_tools` — include tool traces in process stream
|
||||
|
||||
The seeded **SOUL.md** / **AGENTS.md** / **TOOLS.md** tell the model it is a coding agent with full guest admin (denylist): unique `search_replace`, `apply_patch`, `grep`, `glob_files`, `todo_write`, plan mode, memory, skills, `web_search`, `git_status`, and `run_js_script` (no Node in the guest).
|
||||
The seeded **SOUL.md** / **AGENTS.md** / **TOOLS.md** tell the model it is a coding agent with full guest admin (denylist): unique `search_replace`, `apply_patch`, `grep` (`output_mode`), `find_symbol`, `glob_files`, `todo_write`, plan mode, memory / `remember`, skills / `create_skill`, `web_search`, git helpers, session rewind/export, and `run_js_script` (no Node in the guest). Project skills are also walked from `.grok/skills`, `.agents/skills`, `.claude/skills`, and `.cursor/skills`.
|
||||
|
||||
CLI production flags: `--plan`, `--auto`, `--new`, `--compact`, `--max-turns`, `--model`, `--system FILE`, plus inspect subcommands `skills` / `todos` / `plan`.
|
||||
CLI production flags: `--plan`, `--auto`, `--new`, `--compact`, `--max-turns`, `--model`, `--system FILE`. Inspect (no model call): `skills` / `todos` / `plan` / `undo` / `hooks` / `history [query]` / `rewind [N]` / `export [path]` / `remember TEXT` / `recap`. Discord `/agent` is the same harness (shared `~/.agent`).
|
||||
|
||||
Access policy defaults to **full guest admin** (`access_policy: full`):
|
||||
|
||||
|
||||
Reference in New Issue
Block a user