Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
36 commits
Select commit Hold shift + click to select a range
5faba68
Docs: remote HTTP and WebSocket API contract
sinnafuls Nov 15, 2026
cd174a1
RPC: resume with since/at/cursor/gap, paged get_messages, get_agent_m…
sinnafuls Nov 15, 2026
18654f0
Config: the [remote] table
sinnafuls Nov 15, 2026
36c9f24
Web: SvelteKit frontend for azazel remote (MVP), mock host, fixtures,…
sinnafuls Nov 15, 2026
4502654
azazel-remote: server crate (auth, policy, limits, assets, QR, HTTP, …
sinnafuls Nov 15, 2026
c67973c
azazel-remote: integration tests over real sockets
sinnafuls Nov 15, 2026
9765b2a
Shared download helpers; remote.access setting
sinnafuls Nov 15, 2026
906fdb5
azazel remote: command, background sessions, QR, tunnels
sinnafuls Nov 15, 2026
ec6679d
remote: fixtures and tests
sinnafuls Nov 15, 2026
2cb64ed
Docs and changelog for azazel remote
sinnafuls Nov 15, 2026
04fc24e
remote: clippy fixes
sinnafuls Nov 15, 2026
2424540
Web: design pass (tokens, Geist, brand mark, tool cards, composer, sh…
sinnafuls Nov 15, 2026
79caefc
Merge 11A into next-0.11
sinnafuls Nov 15, 2026
8304c1a
Merge 11B into next-0.11
sinnafuls Nov 15, 2026
4fd9495
Merge 11C into next-0.11
sinnafuls Nov 15, 2026
ed68ec7
Merge 107G: GitHub issues and pull requests in azazel
sinnafuls Nov 15, 2026
79b63a5
Cargo.lock follows the 0.10.6 version
sinnafuls Nov 15, 2026
712484a
pty test: clear the change signal once the program waits for input
sinnafuls Nov 15, 2026
57677bb
Merge main (0.10.7) into next-0.11
sinnafuls Nov 15, 2026
fa68710
Changelog: the /remote lines belong under Unreleased
sinnafuls Nov 15, 2026
3ec679a
remote: warn when the placeholder page is embedded; protocol types fr…
sinnafuls Nov 15, 2026
f657084
web: Playwright e2e against a real azazel remote and a scripted session
sinnafuls Nov 16, 2026
1d37a03
Windows: a background session leaves the job its parent runs in
sinnafuls Nov 16, 2026
03855a8
Merge 11F: a background session leaves its parent's job on Windows
sinnafuls Nov 16, 2026
840c232
CI: web and e2e jobs; release builds the page once; xtask dist needs …
sinnafuls Nov 16, 2026
55c970e
Merge 11E: CI and release build the web page; Playwright e2e; remote …
sinnafuls Nov 16, 2026
3f0d047
rpc: state, roster, messages, tree and fencing as crate-level functio…
sinnafuls Nov 16, 2026
45c725a
host: Live is crate-visible for the in-process remote source
sinnafuls Nov 16, 2026
223e7f3
Merge 11D (partial): rpc refactor for the in-process remote source
sinnafuls Nov 16, 2026
99ec73d
remote: the feed, the shared bridge and the terminal's session source…
sinnafuls Nov 16, 2026
a2407ab
tui: /remote shares the terminal's session with browsers
sinnafuls Nov 16, 2026
fa5bb93
docs: /remote in the terminal
sinnafuls Nov 16, 2026
6e11288
tui: Action::Remote only with the remote feature
sinnafuls Nov 16, 2026
0c2ee7a
Merge 11D2: /remote shares the terminal's own session
sinnafuls Nov 16, 2026
22307d7
e2e: wait for the session's address before opening it in a second tab
sinnafuls Nov 16, 2026
3a828db
azazel 0.11.0
sinnafuls Nov 16, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
82 changes: 82 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,38 @@ concurrency:
cancel-in-progress: true

jobs:
# The web page of `azazel remote`. Its build is embedded into the Rust build below (the check job)
# and is what the end-to-end tests of the e2e job open in a browser.
web:
runs-on: ubuntu-latest
timeout-minutes: 20
defaults:
run:
shell: bash
working-directory: web
steps:
- uses: actions/checkout@v4
# Keep in step with `packageManager` in web/package.json.
- uses: oven-sh/setup-bun@v2
with:
bun-version: 1.4.4
- run: bun install --frozen-lockfile
# The protocol types of the page come from docs/rpc.schema.json; a stale file fails here.
- run: bun run gen:types
- run: git diff --exit-code -- .
- run: bun run check
- run: bun run lint
- run: bun run test
- run: bun run build
- uses: actions/upload-artifact@v4
with:
name: web-build
path: web/build
if-no-files-found: error
retention-days: 7

check:
needs: web
strategy:
fail-fast: false
matrix:
Expand All @@ -40,6 +71,13 @@ jobs:
- if: runner.os == 'Linux'
run: sudo rm -rf /usr/share/dotnet /usr/local/lib/android /opt/ghc /opt/hostedtoolcache/CodeQL
- uses: actions/checkout@v4
# The page `azazel remote` serves is embedded when the crate is built: with it, the tests and
# the binary below carry the real page, not the placeholder a checkout without it gets.
- if: runner.os == 'Linux'
uses: actions/download-artifact@v4
with:
name: web-build
path: web/build
# Installs the toolchain and components pinned in rust-toolchain.toml.
- run: rustup show
# mold links the many test binaries in a fraction of the time ld takes.
Expand Down Expand Up @@ -80,4 +118,48 @@ jobs:
cargo test --workspace --doc
- if: runner.os != 'Linux'
run: cargo test --workspace --no-fail-fast
# The binary the end-to-end tests drive is the one the test build above made: the integration
# tests of azazel-cli turn on `test-support` (the scripted provider) and `remote` for it, so
# no second build is needed. Upload it before the build below replaces it.
- if: runner.os == 'Linux'
uses: actions/upload-artifact@v4
with:
name: azazel-test-binary
path: target/debug/azazel
if-no-files-found: error
retention-days: 1
- run: cargo build --no-default-features -p azazel-cli

# The browser tests: Chromium on Linux against a real `azazel remote` in front of a scripted
# background session (tests/fixtures/scripts/web_session.json).
e2e:
needs: [web, check]
runs-on: ubuntu-latest
timeout-minutes: 20
defaults:
run:
shell: bash
working-directory: web
steps:
- uses: actions/checkout@v4
- uses: actions/download-artifact@v4
with:
name: azazel-test-binary
path: ${{ runner.temp }}/azazel-bin
- run: chmod +x "$RUNNER_TEMP/azazel-bin/azazel"
- uses: oven-sh/setup-bun@v2
with:
bun-version: 1.4.4
- run: bun install --frozen-lockfile
- run: bunx playwright install --with-deps chromium
- run: bun run test:e2e
env:
AZAZEL_BIN: ${{ runner.temp }}/azazel-bin/azazel
- if: failure()
uses: actions/upload-artifact@v4
with:
name: playwright-report
path: |
web/playwright-report
web/test-results
retention-days: 7
27 changes: 26 additions & 1 deletion .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -52,8 +52,28 @@ jobs:
gh release create "$GITHUB_REF_NAME" --title "$GITHUB_REF_NAME" --notes-file notes.md --draft
fi

# The web page of `azazel remote`, built once: every platform embeds the same files.
web:
runs-on: ubuntu-latest
defaults:
run:
working-directory: web
steps:
- uses: actions/checkout@v4
# Keep in step with `packageManager` in web/package.json.
- uses: oven-sh/setup-bun@v2
with:
bun-version: 1.4.4
- run: bun install --frozen-lockfile
- run: bun run build
- uses: actions/upload-artifact@v4
with:
name: web-build
path: web/build
if-no-files-found: error

build:
needs: create
needs: [create, web]
strategy:
fail-fast: false
matrix:
Expand All @@ -71,6 +91,11 @@ jobs:
runs-on: ${{ matrix.runner }}
steps:
- uses: actions/checkout@v4
# `cargo xtask dist` refuses to build the `remote` feature without it.
- uses: actions/download-artifact@v4
with:
name: web-build
path: web/build
- run: rustup show && rustup target add ${{ matrix.target }}
# Screen capture (the `screen` feature) links against these on Linux.
- if: runner.os == 'Linux'
Expand Down
29 changes: 28 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ Rust 1.99, edition 2024, tokio. It builds and is tested on Windows, Linux and ma
| `crates/azazel-cli` | The binary: the command line (`cli.rs`), building the application (`app.rs`), the terminal UI (`src/tui/`), print mode, RPC, ACP, background sessions, settings, logins |
| `crates/azazel-mcp`, `azazel-memory`, `azazel-browser`, `azazel-media`, `azazel-lua` | Optional features, each an `Extension`: MCP, memory and the code index, the browser and the screen, media generation, Luau scripts and `run_code` |
| `crates/azazel-protocol`, `azazel-client` | The RPC protocol's types, and a client for it |
| `crates/azazel-remote`, `web/` | `azazel remote`: the server (HTTP, WebSocket, pairing) with the built web page embedded in it, and the page itself, a SvelteKit app built with bun |
| `xtask` | Maintenance tasks (`cargo xtask <task>`); `xtask/docs-check` is the docs check |
| `tests/fixtures` | Stand-in programs the tests run (`fake-lsp`, `mcp-echo`, `fake-check`, `fake-sg`, `fake-gh`, `fake-ssh`, …), scripts for the scripted provider (`scripts/*.json`) and sample projects |
| `skills/` | The skills built into the binary |
Expand Down Expand Up @@ -70,9 +71,35 @@ Other tasks:
| `cargo xtask bench-startup` | Builds the release binary and fails when it is larger than 56 MB, or `azazel --version` takes more than 30 ms, or a scripted `azazel -p hi` more than 150 ms. Prints the size and what it gained since the last run |
| `cargo xtask rpc-schema` | Writes `docs/rpc.schema.json` from `azazel-protocol`; run it after changing the protocol |
| `cargo xtask catalog` | Regenerates from models.dev (needs the network) the model catalogue `crates/azazel-ai/catalog/models.json`, the generated provider rows `crates/azazel-ai/src/providers/generated.rs` and their table in `docs/models-and-logins.md` |
| `cargo xtask dist [--target <triple>]` | Builds the release archive and its checksum into `dist/`; the release workflow runs it |
| `cargo xtask dist [--target <triple>]` | Builds the release archive and its checksum into `dist/`; the release workflow runs it. Fails when the `remote` feature is in the build and `web/build/index.html` is missing |
| `cargo xtask prune [--dry-run]` | Deletes the build output of earlier builds from `target/`: for every crate it keeps the version built last and any built in the last hour |

### The web page (`web/`)

`azazel remote` serves a SvelteKit page that lives in `web/` and is built with **bun** (never npm or pnpm; the
lockfile is `web/bun.lock`). `crates/azazel-remote/build.rs` gzips `web/build/` into the binary; without it
a one-page placeholder is embedded and the build warns, so Rust builds and tests need no bun. From `web/`:

```sh
bun install --frozen-lockfile
bun run gen:types # src/lib/protocol/rpc.ts from docs/rpc.schema.json; run after `cargo xtask rpc-schema`
bun run check && bun run lint && bun run test
bun run build # web/build
bun run test:e2e # Playwright against a real `azazel remote`; see below
```

- **Rebuilding the embedded page.** `build.rs` does not watch a `web/build/` that did not exist when it last
ran. After the first `bun run build` (or whenever the warning says the placeholder is embedded), run
`touch crates/azazel-remote/build.rs` and build again. Later rebuilds of the page are noticed by cargo.
`AZAZEL_WEB_BUILD=<dir>` embeds another directory.
- **End-to-end tests** (`web/tests/e2e`, Chromium) start their own `azazel remote` in front of a scripted
background session (`tests/fixtures/scripts/web_session.json`). They need a binary built with
`--features test-support,remote` (`cargo build -p azazel-cli --features test-support,remote`; the test uses
`target/debug/azazel` of `CARGO_TARGET_DIR` or `AZAZEL_BIN`) and `bunx playwright install chromium` once.
- **CI** builds the page in the `web` job and the Linux Rust job downloads it, so tests and the binary carry
the real page; the `e2e` job reuses the test binary of that job. The release workflow builds the page once
and every platform downloads it before `cargo xtask dist`.

### Keeping `target/` small

Cargo keeps every version of a crate it ever built, so `target/` grows by gigabytes a day while you change
Expand Down
18 changes: 17 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,21 @@ GitHub are its section here.

## [Unreleased]

## [0.11.0] - 2026-11-16

### Fixed

- A browser joining or reconnecting after a failed run now shows why it stopped, instead of leaving a prompt with no answer. A shared terminal session also includes the reply and tool calls already in progress when a browser joins.
- Joining while a tool is running no longer duplicates its card or leaves an old copy stuck as running after the call finishes.
- On Windows, a background session (`azazel bg`, `/bg`, or one that `azazel attach` or `azazel remote` starts again) ended with the command that started it when that command ran in a job that ends its processes, as a terminal, a CI runner or an agent harness may run it. The session now leaves that job when the job allows it. When it does not, `azazel bg` says so, and the session may end with the job; `azazel attach` starts it again.

### Added

- RPC: a client of a background session can resume after a dropped connection. Every logged frame carries `at`, `attach` takes `since` (the `at` of the last frame it saw) and replays exactly the frames after it, and the answer has `cursor` and `gap` (true when `since` is unknown, so the client reloads with `get_messages`).
- RPC: `get_messages` takes `before` and `limit` to load the history in pages, and the new `get_agent_messages` reads the transcript of a sub-agent the same way.
- `azazel remote` serves the background sessions of this machine to a web page on `127.0.0.1:7420`. A browser pairs with a single-use link or QR code, watches a session live and, with a control link, answers approvals and questions, steers and stops it. `--tunnel` reaches it from a phone through a Cloudflare quick tunnel (azazel offers to install `cloudflared`), `--tailscale` through Tailscale; `--view` makes a watch-only link. Settings are in `[remote]`; see `docs/remote.md`. The `remote` Cargo feature is on by default.
- `/remote` shares the session of your terminal with browsers: it shows a control link and QR code in a box (`/remote view` for watch-only, `/remote tunnel`, `/remote tailscale` or `/remote share` for a phone, `/remote stop` to end). Approvals and questions appear at the terminal and in the browsers at once, and the first answer wins. See `docs/remote.md`.

## [0.10.7] - 2026-11-15

### Fixed
Expand Down Expand Up @@ -1104,7 +1119,8 @@ GitHub are its section here.
browser tools, screen capture and playtesting, media generation and sprite sheets, language servers,
subscription sign-in, packages, built-in skills, RPC mode, installers and `azazel update`.

[Unreleased]: https://github.com/sinnafuls/azazel-cli/compare/v0.10.7...HEAD
[Unreleased]: https://github.com/sinnafuls/azazel-cli/compare/v0.11.0...HEAD
[0.11.0]: https://github.com/sinnafuls/azazel-cli/compare/v0.10.7...v0.11.0
[0.10.7]: https://github.com/sinnafuls/azazel-cli/compare/v0.10.6...v0.10.7
[0.10.6]: https://github.com/sinnafuls/azazel-cli/compare/v0.10.5...v0.10.6
[0.10.5]: https://github.com/sinnafuls/azazel-cli/compare/v0.10.4...v0.10.5
Expand Down
Loading
Loading