abstractframework 0.4.2__tar.gz → 0.6.0__tar.gz

{abstractframework-0.4.2 → abstractframework-0.6.0}/CHANGELOG.md

@@ -4,6 +4,198 @@ All notable changes to AbstractFramework will be documented in this file.
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-09-28
+
+Remote and headless machines work like a Mac: one address and one SSH tunnel reach the console, the
+API and every browser app; every client finds the local gateway on its own; AbstractCode creates and
+runs automations; history replay keeps whole messages up to 50,000 tokens and never cuts one.
+
+### Added
+
+- **Browser apps open through the gateway at `/apps/<app>/`** (AbstractGateway 0.7.0). Flow, Code,
+  Observer, Continuum and Entity are served on the gateway's own address (HTTP, server-sent events
+  and WebSocket), signed in with the app's gateway session, so a LAN address, a reverse proxy or one
+  SSH tunnel reaches them all. The apps listen on `127.0.0.1` by default. The installer summary's
+  `Apps:` line and the docs point to `<gateway>/apps/<app>/`; the console's **Apps** page installs
+  and opens them. Running an app on its own with `npx … --gateway-url <url>` is the advanced
+  alternative (`Standalone:` line).
+- **Local gateway pointer.** After the health check the installer writes
+  `~/.abstractframework/gateway.json` (Windows: `%USERPROFILE%\.abstractframework\gateway.json`),
+  mode 0600: the gateway's loopback URL, port and data directory, never a token. The Assistant (the
+  macOS app included), both terminal consoles, AbstractCode's terminal client and the browser apps'
+  servers read it to find a gateway on a port other than 8080, and follow it when the gateway moves.
+  The installer writes it for the install it just made, a custom `--data-dir` included (replacing a
+  pointer that names another data directory); `abstractgateway serve` then keeps it current under
+  its ownership rule. The uninstaller deletes it when it names the uninstalled data directory.
+- **Automations in AbstractCode** (`abstractcode` 0.7.0, `@abstractframework/code` 0.6.0). In the
+  terminal client, `/automations` lists and opens automations (runs as chat pairs, waits that need
+  you, the folder, pause/resume, run now, stop, revise, archive, Discuss) and `/schedule` creates
+  one; the browser client has the same in its **Automations** sidebar section. See
+  [Automations](docs/automations.md).
+- **Start at login from the consoles.** Both the web console (Gateway card, last setup step) and the
+  terminal console (F3, the Finish step) have a **Start at login** switch that changes the login item
+  without restarting the gateway.
+- **The terminal console on a headless machine** (`abstractgateway-console` 0.11.0): a Network
+  screen that shows the saved and the running setting and offers the restart, Apps that give the link
+  and the tunnel command instead of opening a browser, voice and engine states, and the local
+  gateway pointer. Neither terminal console tries to open a browser on a machine without a display.
+- `--ask-wait SECONDS` (Windows: `-AskWait`) sets how long a timed question waits (default 25, at
+  most 25). `--console-wait` remains as an alias.
+
+### Changed
+
+- **One flag for the gateway address: `--gateway-url`** in every app and terminal client
+  (`--url` for the gateway terminal console and `--gateway` for AbstractCode remain as aliases). The
+  installer summary and the docs use it; with `--with-apps` the installer prints
+  `npx -y @abstractframework/<app>@<version> --gateway-url <gateway>` for all five apps.
+- **Start at login is asked whenever a person is at a terminal**, not only with `--interactive`:
+  `curl … | sh` asks it on your terminal (`/dev/tty`), Enter = yes. Nobody answering within
+  `--ask-wait`, an install without a terminal (a script, CI, a provisioning tool) and `--yes` keep
+  the previous choice on a re-run and leave start at login **off** on a first install (it was on);
+  the summary then says how to turn it on: the **Start at login** switch in either console, or
+  `abstractgateway service enable`. A re-run reads the login item's own state, so a change made
+  with a console's switch is kept. `install.ps1` asks the same question on an interactive console
+  (it registered the login entry without asking). `--interactive` waits for answers without a time
+  limit; `--no-service` still asks nothing.
+- **On a remote or headless session** (SSH, or Linux without a display) with a terminal, the
+  installer offers the terminal console at the end ("Press Enter within 25 s"), signed in; nobody answering skips it, so automation never blocks.
+  Over SSH it no longer opens a browser on the remote machine. `--no-open` skips both.
+- **History replay keeps whole messages up to 50,000 tokens** (AbstractRuntime 0.7.0): growing
+  automations, session chats, run chat, the docs assistants and entity visits replay the newest whole
+  turns up to 50,000 tokens. No message is cut; the former 40-message, 24,000-character and
+  per-message caps are gone. Each run records how many earlier messages were not replayed, and the
+  clients say so.
+- **Voice says what it can do** (AbstractVoice 0.13.0, AbstractCore 2.18.0). Voice listings name
+  the providers that cannot run here and why, instead of an empty list; cloud voice providers are
+  listed as needing a key until one is configured; a capability route whose engine is not installed
+  reports `engine_missing` with the install command; an OpenAI key saved in the Providers screen
+  reaches voice. The installer adds local voice to every install profile: Supertonic text-to-speech
+  and Whisper speech-to-text (`abstractvoice[supertonic,stt]`), both CPU, from prebuilt wheels
+  (skipped where no wheels exist: musl Linux / Alpine, macOS before 13; Whisper on Windows ARM64).
+  Voice never fails an install: where its packages do not install the gateway is installed without
+  it. The summary's `Voice:` line says what was installed, and a re-run that adds voice restarts the
+  gateway to load it.
+- **Observer: Edit opens the form, and a calmer Automations page** (`@abstractframework/observer`
+  0.2.0). A row's **Edit** opens the automation's edit form at once, prefilled (title, task,
+  interval, context, tools); action buttons carry icons; a workspace folder can be browsed from the
+  browser; **Discuss** opens a chat with a fork of the automation; a run's **Ask** chat sends the
+  whole conversation.
+- **Apple silicon model fits account for the GPU memory limit** (AbstractCore 2.18.0): a model that
+  fits once macOS raises its limit reads `needs_gpu_limit` with the exact command.
+
+### Security
+
+- **DNS-rebinding protection in the browser apps**: an app treats a browser as on this machine only
+  when both its address and the page's host are loopback, so a rebinding page can neither reveal a
+  folder nor change the gateway address. Continuum's local-only pages answer on `localhost` or
+  `127.0.0.1` only. The gateway's app proxy refuses requests with another origin or an invalid host.
+- **Server-held keys are spent only for authenticated requests** (AbstractCore 2.18.0): with a
+  saved or environment OpenAI key, unauthenticated requests to the AbstractVoice audio routes, the
+  audio and vision discovery routes, OpenAI-backed vision generation and the capability discovery
+  routes get `401`, also with `ABSTRACTCORE_SERVER_ALLOW_UNAUTHENTICATED=1`; an explicit
+  `X-AbstractCore-Provider-API-Key` is spent instead. The music route follows the same rule while
+  the server holds a music backend key.
+- The local gateway pointer is written without following links, with mode 0600, and readers reject
+  a pointer that other users can write.
+
+### Changed (pins)
+
+- **abstractgateway 0.7.0** (was 0.6.0): apps through `/apps/<app>/`, the local gateway pointer,
+  start at login from the consoles, cloud voice providers listed, the history window on every chat
+  route, and the terminal console 0.11.0.
+- **abstractcore 2.18.0** (was 2.17.0): `engine_missing`, `needs_gpu_limit`, the saved OpenAI key
+  for voice, the key guards above, and `abstractcore-console` 0.4.0.
+- **AbstractRuntime 0.7.1** (was 0.6.0): the 50,000-token history window, recorded in each run;
+  images in replayed history stay images, and an image counts as a flat 512 tokens in the window.
+  Library callers of `session_chat_messages` and `automation_timeline_messages` should read its
+  changelog's Breaking note.
+- **abstractagent 0.3.17** (was 0.3.16): ReAct sends the runtime's history window when the host
+  asks for it.
+- **abstractvoice 0.13.0** (was 0.12.0): engine status and unavailable-provider reasons, Qwen3-ASR
+  on Transformers 5.x, Qwen3-TTS predictor and sampler flags.
+- **abstractassistant 0.9.0** (was 0.8.0): the macOS app finds a gateway through the local gateway
+  pointer; automation cards say their state in words.
+- npm: **@abstractframework/flow 0.4.0**, **code 0.6.0**, **observer 0.2.0**, **continuum 0.4.0**
+  and **entity 0.3.0**, all served through the gateway at `/apps/<app>/` and taking
+  `--gateway-url`.
+- crates.io: **abstractgateway-console 0.11.0**, **abstractcore-console 0.4.0** and
+  **abstractcode 0.7.0**.
+- The pins apply to the base install and to the `apple` / `gpu` extras. Unchanged:
+  abstractskill 0.3.0, AbstractMemory 0.3.0, abstractsemantics 0.0.5, abstractvision 0.3.30,
+  abstractmusic 0.1.15 and `abstracttui` 0.6.0.
+
+## [0.5.0] - 2026-09-27
+
+Automations, a terminal console installed by default, and a headless setup path: installing and
+configuring AbstractFramework on a remote Linux server without a browser works like it does on a Mac.
+
+### Added
+
+- **Automations v1.** Run a workflow or the gateway's default agent again and again on a fixed UTC
+  interval or on request, read every run as a chat turn, and be notified only when a run asks for
+  you or fails. Create and manage them in the Assistant (session switcher, **Automations** tab), the
+  Observer (**Launch → Automate**, **Automations** page) or from a workflow's automation defaults in
+  the Flow editor. See [Automations](docs/automations.md).
+- **The terminal console is installed by default.** The installer builds `abstractgateway-console`
+  with cargo next to the `abstractgateway` command. On macOS and Linux, when cargo is missing or
+  older than Rust 1.87, it adds Rust with rustup, user-scoped (`~/.rustup`, `~/.cargo`, about
+  600 MB, shell profile untouched); Windows builds it when Rust is already installed. The build
+  needs a C compiler; without one, or if it fails, the installer says why and continues.
+  `--no-console` (`-NoConsole`) skips it; `--with-console` is accepted and has no effect. The
+  uninstaller removes the console it built and keeps Rust.
+- **Both consoles in the installer summary.** The summary shows the web console link and the
+  terminal console command, `abstractgateway-console --url <gateway> --token-file <data dir>/auth/bootstrap-admin-token`:
+  the token is read from the gateway's data dir and never appears on the command line or in the
+  environment.
+- **Headless or remote machine** ([Install](docs/install.md#headless-or-remote-machine)): configure
+  the gateway from the terminal console on the server, or tunnel the web console over SSH.
+- **The terminal console matches the web console** (`abstractgateway-console` 0.10.0): the setup
+  guide for a headless first run (Connection, Setup, Engines, Providers, Routes, Models, Apps,
+  Review), twelve screens including **Setup** and **A Apps**, the **F2** docs assistant, the **F3**
+  host panel, every sandbox mode, entity summon and workflow import, with the same admin rules.
+  `abstractcore-console` 0.3.0 adds Hugging Face search, parallel downloads, engine start/stop and
+  a video filter to the shared Models and Engines screens.
+- **Recommended defaults fit the machine** (AbstractCore 2.17.0): every recommended route is written
+  only where its engine runs, and a route this computer cannot run says why. Video joins the model
+  catalog and the recommendations (MLX-Gen Wan2.2 TI2V-5B on Apple silicon with enough memory), and
+  the web console has a **Video** filter and card.
+
+### Changed
+
+- **App hints use launch flags.** With `--with-apps`, the installer prints
+  `npx -y @abstractframework/flow@<version> --gateway-url <gateway>` (Continuum likewise); Code,
+  Observer and Entity take a gateway other than `http://127.0.0.1:8080` on their sign-in screen.
+  `--with-code-cli` prints `abstractcode --gateway <gateway>`.
+
+### Changed (pins)
+
+- **abstractgateway 0.6.0** (was 0.5.1): the Automations API, run lists attributed to automations,
+  web console video and host-aware routes, and the terminal console 0.10.0.
+- **abstractcore 2.17.0** (was 2.16.1): host-aware recommended defaults, video models and routes,
+  `route_unavailable` on routes this computer cannot run, a voice-clone fix for local engines.
+- **AbstractRuntime 0.6.0** (was 0.5.1): the durable automation controller and its occurrences.
+- **abstractassistant 0.8.0** (was 0.7.0): automations in the session switcher (schedule a
+  conversation, read runs as a chat, answer waiting runs, discuss a run); it finds a gateway the
+  installer moved off a busy port 8080.
+- **abstractvoice 0.12.0** (was 0.11.4): Qwen3-TTS checkpoint selection, directed speech and a
+  steadier codebook predictor.
+- **abstractvision 0.3.30** (was 0.3.29): unloading an MLX-Gen model returns its memory to the
+  operating system.
+- npm: **@abstractframework/flow 0.3.22** (automation defaults on workflows) and
+  **@abstractframework/observer 0.1.14** (Automate mode and the Automations page).
+- crates.io: **abstractgateway-console 0.10.0** and **abstractcore-console 0.3.0**.
+- The pins apply to the base install and to the `apple` / `gpu` extras. Unchanged:
+  abstractagent 0.3.16, abstractskill 0.3.0, AbstractMemory 0.3.0, abstractsemantics 0.0.5,
+  abstractmusic 0.1.15, @abstractframework/code 0.5.0, continuum 0.3.2, entity 0.2.2,
+  `abstractcode` 0.6.0 and `abstracttui` 0.6.0.
+
+### Documentation
+
+- **Automations guide** ([docs/automations.md](docs/automations.md)): how automations work, creating
+  them from each client, two worked examples, managing them, notifications and typed waits, restart
+  safety, limits and troubleshooting. A discussion about a run works in its own folder with the
+  automation's folder mounted read-only.
+
 ## [0.4.2] - 2026-09-27
 
 A patch release for the uninstaller and two package updates.

{abstractframework-0.4.2/abstractframework.egg-info → abstractframework-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractframework
-Version: 0.4.2
+Version: 0.6.0
 Summary: Unified installer and documentation hub for the AbstractFramework ecosystem
 Author-email: Laurent-Philippe Albou <contact@abstractframework.ai>
 License: MIT
@@ -23,23 +23,23 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: abstractgateway==0.5.1
-Requires-Dist: abstractassistant==0.7.0
-Requires-Dist: abstractcore==2.16.1
-Requires-Dist: AbstractRuntime==0.5.1
-Requires-Dist: abstractagent==0.3.16
+Requires-Dist: abstractgateway==0.7.0
+Requires-Dist: abstractassistant==0.9.0
+Requires-Dist: abstractcore==2.18.0
+Requires-Dist: AbstractRuntime==0.7.1
+Requires-Dist: abstractagent==0.3.17
 Requires-Dist: abstractskill==0.3.0
 Requires-Dist: AbstractMemory==0.3.0
 Requires-Dist: abstractsemantics==0.0.5
-Requires-Dist: abstractvoice==0.11.4
-Requires-Dist: abstractvision==0.3.29
+Requires-Dist: abstractvoice==0.13.0
+Requires-Dist: abstractvision==0.3.30
 Requires-Dist: abstractmusic==0.1.15
 Provides-Extra: apple
-Requires-Dist: abstractgateway[apple]==0.5.1; extra == "apple"
-Requires-Dist: abstractassistant[apple]==0.7.0; platform_system == "Darwin" and extra == "apple"
+Requires-Dist: abstractgateway[apple]==0.7.0; extra == "apple"
+Requires-Dist: abstractassistant[apple]==0.9.0; platform_system == "Darwin" and extra == "apple"
 Provides-Extra: gpu
-Requires-Dist: abstractgateway[gpu]==0.5.1; extra == "gpu"
-Requires-Dist: abstractassistant[gpu]==0.7.0; extra == "gpu"
+Requires-Dist: abstractgateway[gpu]==0.7.0; extra == "gpu"
+Requires-Dist: abstractassistant[gpu]==0.9.0; extra == "gpu"
 Dynamic: license-file
 
 # AbstractFramework
@@ -64,9 +64,14 @@ Think of it as an **agentic OS**: durable runs + replay-first observability + mu
 ## Quick start
 
 The installer sets up the gateway in your user account (no admin password, no system Python),
-asks whether to start it at login, starts it on `127.0.0.1:8080`, and opens its web console in
-your browser already signed in. A first-run guide then sets up a local engine (Ollama, LM Studio,
-MLX, llama.cpp), downloads a model that fits your machine, and lists the apps.
+with local voice (Supertonic text-to-speech and Whisper speech-to-text), asks whether to start it
+at login (Enter = yes; an unattended install leaves it off and says how to turn it on), starts it
+on `127.0.0.1:8080`, and opens its web console in your browser already signed in. A first-run guide
+then sets up a local engine (Ollama, LM Studio, MLX, llama.cpp), downloads a model that fits your
+machine, and lists the apps; the gateway serves them on its own address at `/apps/<app>/`. The
+installer also builds the terminal console, `abstractgateway-console`, which runs the same guide on
+a server without a browser and offers itself at the end of an install over SSH
+([Headless or remote machine](docs/install.md#headless-or-remote-machine)).
 
 - **Mac, no Terminal:** download and double-click
   [AbstractFramework-Installer.pkg](https://github.com/lpalbou/AbstractFramework/releases/latest/download/AbstractFramework-Installer.pkg).
@@ -76,7 +81,7 @@ MLX, llama.cpp), downloads a model that fits your machine, and lists the apps.
 - **macOS / Linux, one line:**
 
   ```bash
-  curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.sh | sh -s -- --interactive
+  curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.sh | sh
   ```
 
 - **Windows 10 22H2+ / 11** (PowerShell):
@@ -145,7 +150,7 @@ Start here if you're building persistent AI applications — agents that run for
 
 - Durable execution that survives crashes and restarts
 - Append-only ledger (replay-first) for auditability
-- Scheduled workflows (cron-style, recurring)
+- Automations: a workflow that runs on a fixed interval or on demand, kept as a readable conversation ([Automations](docs/automations.md))
 - Multi-client: terminal, browser, tray, Telegram, email
 - Start on one device, continue on another
 
@@ -158,7 +163,8 @@ With no auth configured, `abstractgateway serve` binds `127.0.0.1:8080`, enables
 creates `default/admin` in the per-user data folder, and prints a one-time sign-in link
 (`http://127.0.0.1:8080/console#claim=…`, valid 10 minutes, this machine only). Open it to reach the
 web console and its first-run guide. `abstractgateway claim` mints a new link;
-`abstractgateway service install` starts the gateway at login.
+`abstractgateway service enable` (or the console's **Start at login** switch) starts the gateway at
+login.
 
 Browser apps on `http://localhost:*` and `http://127.0.0.1:*` may always call it. To choose
 another data folder or allow another browser origin:
@@ -180,17 +186,19 @@ AbstractFlow, AbstractCode Web or AbstractObserver, or to the console without a
 `ABSTRACTGATEWAY_AUTH_TOKEN` remains a legacy server/operator bearer token; it is not a browser
 sign-in token.
 
-Monitor runs from a browser, or from a terminal with the gateway console:
+Monitor runs from a browser, or from a terminal with the gateway console. The console's **Apps**
+page installs and opens the browser apps, served by the gateway at `/apps/<app>/`
+(`http://127.0.0.1:8080/apps/observer/`), so one address (and one SSH tunnel) reaches them all:
 
 ```bash
-npx @abstractframework/observer   # open http://localhost:3001
+npx @abstractframework/observer --gateway-url http://127.0.0.1:8080   # or run one on its own
 
-cargo install abstractgateway-console   # Rust 1.87+
-ABSTRACTGATEWAY_AUTH_TOKEN=<token> abstractgateway-console --url http://127.0.0.1:8080
+cargo install abstractgateway-console   # Rust 1.87+; the installer builds it for you
+abstractgateway-console --gateway-url http://127.0.0.1:8080 --token <admin token>   # <data dir>/auth/bootstrap-admin-token
 ```
 
 Container images are published for the gateway and the AbstractCore server:
-`ghcr.io/lpalbou/abstractgateway:0.5.1` and `ghcr.io/lpalbou/abstractcore-server:2.16.1`.
+`ghcr.io/lpalbou/abstractgateway:0.7.0` and `ghcr.io/lpalbou/abstractcore-server:2.18.0`.
 
 For artifact and runtime-resource investigation, see
 [Runtime artifacts and retrieval](docs/guide/runtime-artifacts.md).
@@ -228,7 +236,7 @@ See [Agent sessions](docs/agent-sessions.md).
 
 AbstractFlow lets you author complex agentic orchestration as portable `.flow` bundles:
 
-1. Open the Flow Editor (`npx @abstractframework/flow`)
+1. Open the Flow Editor (the console's **Apps** page, or `npx @abstractframework/flow --gateway-url <url>`)
 2. Build a workflow: LLM steps, tool steps, branching, loops, subflows
 3. Export a `.flow` bundle into your own bundle directory and point `ABSTRACTGATEWAY_FLOWS_DIR` at it (or publish it through the Gateway API)
 4. Run it from any gateway-backed client (Observer, AbstractAssistant, Code Web UI, your app)
@@ -241,7 +249,7 @@ AbstractFlow lets you author complex agentic orchestration as portable `.flow` b
 
 - **Observe**: replay the full ledger of any run, or watch one live over SSE
 - **Control**: cancel, resume, or inspect runs from the browser
-- **Schedule**: durable schedules (cron-style) owned by the gateway — they survive restarts
+- **Automate**: create and manage automations (Launch → Automate, the Automations page); they run on the gateway and survive restarts. See [Automations](docs/automations.md)
 
 ---
 
@@ -288,13 +296,13 @@ The ecosystem, grouped by layer. Each name links to the package's repository.
 |---|---|---|
 | [AbstractCode](https://github.com/lpalbou/AbstractCode) | Terminal agentic dev client (Rust, on the AbstractTUI engine) — durable sessions, tool approvals, the gateway's default workflow, workspace files, live replies | `cargo install abstractcode`, or a prebuilt binary from the [GitHub release](https://github.com/lpalbou/AbstractCode/releases) |
 | [AbstractAssistant](https://github.com/lpalbou/AbstractAssistant) | macOS tray client — gateway-native, follows the gateway's default workflow or your pick, live replies, voice support | `pip install abstractassistant`, or **Open** in the gateway console (starts it signed in) |
-| [AbstractObserver](https://github.com/lpalbou/AbstractObserver) | Browser UI — monitor, control, and schedule gateway runs | `npx @abstractframework/observer` |
-| [AbstractEntity](https://github.com/lpalbou/AbstractEntity) | Summoned-entity manager — roster, blueprint (cognition map + editing), chat drawer, live replay | `npx @abstractframework/entity` |
-| [AbstractContinuum](https://github.com/lpalbou/AbstractContinuum) | Continuous iterative development and deployment console | `npx @abstractframework/continuum` |
-| **Gateway consoles** | Operator consoles for a running gateway: web at `/console` (first-run guide, Models, Engines, providers, users), terminal via `abstractgateway-console` | built into `abstractgateway`; `cargo install abstractgateway-console` |
+| [AbstractObserver](https://github.com/lpalbou/AbstractObserver) | Browser UI — monitor, control, and schedule gateway runs | the gateway console's **Apps** page (served at `/apps/observer/`), or `npx @abstractframework/observer --gateway-url <url>` |
+| [AbstractEntity](https://github.com/lpalbou/AbstractEntity) | Summoned-entity manager — roster, blueprint (cognition map + editing), chat drawer, live replay | the gateway console's **Apps** page (served at `/apps/entity/`), or `npx @abstractframework/entity --gateway-url <url>` |
+| [AbstractContinuum](https://github.com/lpalbou/AbstractContinuum) | Continuous iterative development and deployment console | the gateway console's **Apps** page (served at `/apps/continuum/`), or `npx @abstractframework/continuum --gateway-url <url>` |
+| **Gateway consoles** | Operator consoles for a running gateway: web at `/console` (first-run guide, Models, Engines, providers, users), terminal via `abstractgateway-console` (the same setup guide and screens, Network and Apps included, for headless hosts) | built into `abstractgateway`; built by the installer, or `cargo install abstractgateway-console` |
 | **Core consoles** | Consoles for AbstractCore: web at `/console` of `abstractcore serve`, terminal via `abstractcore-console` (config, Models, Engines) | built into `abstractcore`; `cargo install abstractcore-console` |
-| **Code Web UI** | Browser client of AbstractCode (gateway-backed): workflow selector, Files tab, live replies | `npx @abstractframework/code` |
-| **Flow Editor** | Visual workflow authoring in the browser | `npx @abstractframework/flow` |
+| **Code Web UI** | Browser client of AbstractCode (gateway-backed): workflow selector, Files tab, live replies | the gateway console's **Apps** page (served at `/apps/code/`), or `npx @abstractframework/code --gateway-url <url>` |
+| **Flow Editor** | Visual workflow authoring in the browser | the gateway console's **Apps** page (served at `/apps/flow/`), or `npx @abstractframework/flow --gateway-url <url>` |
 
 ### Shared libraries
 
@@ -336,7 +344,7 @@ pip install "abstractframework[gpu]"
 | Apple | `pip install "abstractframework[apple]"` | macOS 14+ on Apple Silicon | 3.10–3.13 (F5-TTS voice cloning needs 3.11+) |
 | GPU | `pip install "abstractframework[gpu]"` | Linux / Windows with a CUDA or ROCm GPU | 3.10–3.13 (F5-TTS voice cloning needs 3.11+) |
 
-### Release matrix (abstractframework 0.4.2)
+### Release matrix (abstractframework 0.6.0)
 
 `abstractframework` pins every Python package with `==`, so one version of the
 meta-package always installs the same stack. The browser apps and Rust tools are
@@ -345,28 +353,28 @@ and tested together.
 
 | Registry | Package | Version |
 |---|---|---|
-| PyPI | `abstractgateway` | 0.5.1 |
-| PyPI | `abstractassistant` | 0.7.0 |
-| PyPI | `abstractcore` | 2.16.1 |
-| PyPI | `AbstractRuntime` | 0.5.1 |
-| PyPI | `abstractagent` | 0.3.16 |
+| PyPI | `abstractgateway` | 0.7.0 |
+| PyPI | `abstractassistant` | 0.9.0 |
+| PyPI | `abstractcore` | 2.18.0 |
+| PyPI | `AbstractRuntime` | 0.7.1 |
+| PyPI | `abstractagent` | 0.3.17 |
 | PyPI | `abstractskill` | 0.3.0 |
 | PyPI | `AbstractMemory` | 0.3.0 |
 | PyPI | `abstractsemantics` | 0.0.5 |
-| PyPI | `abstractvoice` | 0.11.4 |
-| PyPI | `abstractvision` | 0.3.29 |
+| PyPI | `abstractvoice` | 0.13.0 |
+| PyPI | `abstractvision` | 0.3.30 |
 | PyPI | `abstractmusic` | 0.1.15 |
-| npm | `@abstractframework/flow` | 0.3.21 |
-| npm | `@abstractframework/code` | 0.5.0 |
-| npm | `@abstractframework/observer` | 0.1.13 |
-| npm | `@abstractframework/continuum` | 0.3.2 |
-| npm | `@abstractframework/entity` | 0.2.2 |
-| crates.io | `abstractcode` | 0.6.0 |
-| crates.io | `abstractgateway-console` | 0.9.0 |
-| crates.io | `abstractcore-console` | 0.2.0 |
+| npm | `@abstractframework/flow` | 0.4.0 |
+| npm | `@abstractframework/code` | 0.6.0 |
+| npm | `@abstractframework/observer` | 0.2.0 |
+| npm | `@abstractframework/continuum` | 0.4.0 |
+| npm | `@abstractframework/entity` | 0.3.0 |
+| crates.io | `abstractcode` | 0.7.0 |
+| crates.io | `abstractgateway-console` | 0.11.0 |
+| crates.io | `abstractcore-console` | 0.4.0 |
 | crates.io | `abstracttui` | 0.6.0 |
-| GHCR | `ghcr.io/lpalbou/abstractgateway` | 0.5.1 (`gpu-latest` / `<version>-gpu` experimental) |
-| GHCR | `ghcr.io/lpalbou/abstractcore-server` | 2.16.1 |
+| GHCR | `ghcr.io/lpalbou/abstractgateway` | 0.7.0 (`gpu-latest` / `<version>-gpu` experimental) |
+| GHCR | `ghcr.io/lpalbou/abstractcore-server` | 2.18.0 |
 
 Optional add-ons that are not part of any profile install separately:
 `pip install abstract3d` (0.3.1) and `pip install abstractcamera` (0.2.0). `abstractskill` (pinned above)
@@ -386,6 +394,7 @@ See [docs/install.md](docs/install.md) for the full install chooser, `uv`/venv g
 | [docs/install.md](docs/install.md) | Light / Apple / GPU install chooser and first checks |
 | [docs/getting-started.md](docs/getting-started.md) | Two entry points + first end-to-end run |
 | [docs/agent-sessions.md](docs/agent-sessions.md) | Default agent workflow, the conversation workspace and its protection, skills, live replies, the Assistant hand-over |
+| [docs/automations.md](docs/automations.md) | Automations: how they work (controller run, occurrences, independent vs growing context), creating and managing them from the Assistant, the Observer or a workflow, notifications, limits |
 | [docs/architecture.md](docs/architecture.md) | Component diagram, how a turn flows, the live-reply lane, app proxies, model eject, framework identity, durable execution primitives |
 | [docs/configuration.md](docs/configuration.md) | Minimal config, where defaults live, Core vs Gateway |
 | [docs/glossary.md](docs/glossary.md) | Shared terminology (run, ledger, effect, wait, bundle, …) |

{abstractframework-0.4.2 → abstractframework-0.6.0}/README.md

@@ -20,9 +20,14 @@ Think of it as an **agentic OS**: durable runs + replay-first observability + mu
 ## Quick start
 
 The installer sets up the gateway in your user account (no admin password, no system Python),
-asks whether to start it at login, starts it on `127.0.0.1:8080`, and opens its web console in
-your browser already signed in. A first-run guide then sets up a local engine (Ollama, LM Studio,
-MLX, llama.cpp), downloads a model that fits your machine, and lists the apps.
+with local voice (Supertonic text-to-speech and Whisper speech-to-text), asks whether to start it
+at login (Enter = yes; an unattended install leaves it off and says how to turn it on), starts it
+on `127.0.0.1:8080`, and opens its web console in your browser already signed in. A first-run guide
+then sets up a local engine (Ollama, LM Studio, MLX, llama.cpp), downloads a model that fits your
+machine, and lists the apps; the gateway serves them on its own address at `/apps/<app>/`. The
+installer also builds the terminal console, `abstractgateway-console`, which runs the same guide on
+a server without a browser and offers itself at the end of an install over SSH
+([Headless or remote machine](docs/install.md#headless-or-remote-machine)).
 
 - **Mac, no Terminal:** download and double-click
   [AbstractFramework-Installer.pkg](https://github.com/lpalbou/AbstractFramework/releases/latest/download/AbstractFramework-Installer.pkg).
@@ -32,7 +37,7 @@ MLX, llama.cpp), downloads a model that fits your machine, and lists the apps.
 - **macOS / Linux, one line:**
 
   ```bash
-  curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.sh | sh -s -- --interactive
+  curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/install.sh | sh
   ```
 
 - **Windows 10 22H2+ / 11** (PowerShell):
@@ -101,7 +106,7 @@ Start here if you're building persistent AI applications — agents that run for
 
 - Durable execution that survives crashes and restarts
 - Append-only ledger (replay-first) for auditability
-- Scheduled workflows (cron-style, recurring)
+- Automations: a workflow that runs on a fixed interval or on demand, kept as a readable conversation ([Automations](docs/automations.md))
 - Multi-client: terminal, browser, tray, Telegram, email
 - Start on one device, continue on another
 
@@ -114,7 +119,8 @@ With no auth configured, `abstractgateway serve` binds `127.0.0.1:8080`, enables
 creates `default/admin` in the per-user data folder, and prints a one-time sign-in link
 (`http://127.0.0.1:8080/console#claim=…`, valid 10 minutes, this machine only). Open it to reach the
 web console and its first-run guide. `abstractgateway claim` mints a new link;
-`abstractgateway service install` starts the gateway at login.
+`abstractgateway service enable` (or the console's **Start at login** switch) starts the gateway at
+login.
 
 Browser apps on `http://localhost:*` and `http://127.0.0.1:*` may always call it. To choose
 another data folder or allow another browser origin:
@@ -136,17 +142,19 @@ AbstractFlow, AbstractCode Web or AbstractObserver, or to the console without a
 `ABSTRACTGATEWAY_AUTH_TOKEN` remains a legacy server/operator bearer token; it is not a browser
 sign-in token.
 
-Monitor runs from a browser, or from a terminal with the gateway console:
+Monitor runs from a browser, or from a terminal with the gateway console. The console's **Apps**
+page installs and opens the browser apps, served by the gateway at `/apps/<app>/`
+(`http://127.0.0.1:8080/apps/observer/`), so one address (and one SSH tunnel) reaches them all:
 
 ```bash
-npx @abstractframework/observer   # open http://localhost:3001
+npx @abstractframework/observer --gateway-url http://127.0.0.1:8080   # or run one on its own
 
-cargo install abstractgateway-console   # Rust 1.87+
-ABSTRACTGATEWAY_AUTH_TOKEN=<token> abstractgateway-console --url http://127.0.0.1:8080
+cargo install abstractgateway-console   # Rust 1.87+; the installer builds it for you
+abstractgateway-console --gateway-url http://127.0.0.1:8080 --token <admin token>   # <data dir>/auth/bootstrap-admin-token
 ```
 
 Container images are published for the gateway and the AbstractCore server:
-`ghcr.io/lpalbou/abstractgateway:0.5.1` and `ghcr.io/lpalbou/abstractcore-server:2.16.1`.
+`ghcr.io/lpalbou/abstractgateway:0.7.0` and `ghcr.io/lpalbou/abstractcore-server:2.18.0`.
 
 For artifact and runtime-resource investigation, see
 [Runtime artifacts and retrieval](docs/guide/runtime-artifacts.md).
@@ -184,7 +192,7 @@ See [Agent sessions](docs/agent-sessions.md).
 
 AbstractFlow lets you author complex agentic orchestration as portable `.flow` bundles:
 
-1. Open the Flow Editor (`npx @abstractframework/flow`)
+1. Open the Flow Editor (the console's **Apps** page, or `npx @abstractframework/flow --gateway-url <url>`)
 2. Build a workflow: LLM steps, tool steps, branching, loops, subflows
 3. Export a `.flow` bundle into your own bundle directory and point `ABSTRACTGATEWAY_FLOWS_DIR` at it (or publish it through the Gateway API)
 4. Run it from any gateway-backed client (Observer, AbstractAssistant, Code Web UI, your app)
@@ -197,7 +205,7 @@ AbstractFlow lets you author complex agentic orchestration as portable `.flow` b
 
 - **Observe**: replay the full ledger of any run, or watch one live over SSE
 - **Control**: cancel, resume, or inspect runs from the browser
-- **Schedule**: durable schedules (cron-style) owned by the gateway — they survive restarts
+- **Automate**: create and manage automations (Launch → Automate, the Automations page); they run on the gateway and survive restarts. See [Automations](docs/automations.md)
 
 ---
 
@@ -244,13 +252,13 @@ The ecosystem, grouped by layer. Each name links to the package's repository.
 |---|---|---|
 | [AbstractCode](https://github.com/lpalbou/AbstractCode) | Terminal agentic dev client (Rust, on the AbstractTUI engine) — durable sessions, tool approvals, the gateway's default workflow, workspace files, live replies | `cargo install abstractcode`, or a prebuilt binary from the [GitHub release](https://github.com/lpalbou/AbstractCode/releases) |
 | [AbstractAssistant](https://github.com/lpalbou/AbstractAssistant) | macOS tray client — gateway-native, follows the gateway's default workflow or your pick, live replies, voice support | `pip install abstractassistant`, or **Open** in the gateway console (starts it signed in) |
-| [AbstractObserver](https://github.com/lpalbou/AbstractObserver) | Browser UI — monitor, control, and schedule gateway runs | `npx @abstractframework/observer` |
-| [AbstractEntity](https://github.com/lpalbou/AbstractEntity) | Summoned-entity manager — roster, blueprint (cognition map + editing), chat drawer, live replay | `npx @abstractframework/entity` |
-| [AbstractContinuum](https://github.com/lpalbou/AbstractContinuum) | Continuous iterative development and deployment console | `npx @abstractframework/continuum` |
-| **Gateway consoles** | Operator consoles for a running gateway: web at `/console` (first-run guide, Models, Engines, providers, users), terminal via `abstractgateway-console` | built into `abstractgateway`; `cargo install abstractgateway-console` |
+| [AbstractObserver](https://github.com/lpalbou/AbstractObserver) | Browser UI — monitor, control, and schedule gateway runs | the gateway console's **Apps** page (served at `/apps/observer/`), or `npx @abstractframework/observer --gateway-url <url>` |
+| [AbstractEntity](https://github.com/lpalbou/AbstractEntity) | Summoned-entity manager — roster, blueprint (cognition map + editing), chat drawer, live replay | the gateway console's **Apps** page (served at `/apps/entity/`), or `npx @abstractframework/entity --gateway-url <url>` |
+| [AbstractContinuum](https://github.com/lpalbou/AbstractContinuum) | Continuous iterative development and deployment console | the gateway console's **Apps** page (served at `/apps/continuum/`), or `npx @abstractframework/continuum --gateway-url <url>` |
+| **Gateway consoles** | Operator consoles for a running gateway: web at `/console` (first-run guide, Models, Engines, providers, users), terminal via `abstractgateway-console` (the same setup guide and screens, Network and Apps included, for headless hosts) | built into `abstractgateway`; built by the installer, or `cargo install abstractgateway-console` |
 | **Core consoles** | Consoles for AbstractCore: web at `/console` of `abstractcore serve`, terminal via `abstractcore-console` (config, Models, Engines) | built into `abstractcore`; `cargo install abstractcore-console` |
-| **Code Web UI** | Browser client of AbstractCode (gateway-backed): workflow selector, Files tab, live replies | `npx @abstractframework/code` |
-| **Flow Editor** | Visual workflow authoring in the browser | `npx @abstractframework/flow` |
+| **Code Web UI** | Browser client of AbstractCode (gateway-backed): workflow selector, Files tab, live replies | the gateway console's **Apps** page (served at `/apps/code/`), or `npx @abstractframework/code --gateway-url <url>` |
+| **Flow Editor** | Visual workflow authoring in the browser | the gateway console's **Apps** page (served at `/apps/flow/`), or `npx @abstractframework/flow --gateway-url <url>` |
 
 ### Shared libraries
 
@@ -292,7 +300,7 @@ pip install "abstractframework[gpu]"
 | Apple | `pip install "abstractframework[apple]"` | macOS 14+ on Apple Silicon | 3.10–3.13 (F5-TTS voice cloning needs 3.11+) |
 | GPU | `pip install "abstractframework[gpu]"` | Linux / Windows with a CUDA or ROCm GPU | 3.10–3.13 (F5-TTS voice cloning needs 3.11+) |
 
-### Release matrix (abstractframework 0.4.2)
+### Release matrix (abstractframework 0.6.0)
 
 `abstractframework` pins every Python package with `==`, so one version of the
 meta-package always installs the same stack. The browser apps and Rust tools are
@@ -301,28 +309,28 @@ and tested together.
 
 | Registry | Package | Version |
 |---|---|---|
-| PyPI | `abstractgateway` | 0.5.1 |
-| PyPI | `abstractassistant` | 0.7.0 |
-| PyPI | `abstractcore` | 2.16.1 |
-| PyPI | `AbstractRuntime` | 0.5.1 |
-| PyPI | `abstractagent` | 0.3.16 |
+| PyPI | `abstractgateway` | 0.7.0 |
+| PyPI | `abstractassistant` | 0.9.0 |
+| PyPI | `abstractcore` | 2.18.0 |
+| PyPI | `AbstractRuntime` | 0.7.1 |
+| PyPI | `abstractagent` | 0.3.17 |
 | PyPI | `abstractskill` | 0.3.0 |
 | PyPI | `AbstractMemory` | 0.3.0 |
 | PyPI | `abstractsemantics` | 0.0.5 |
-| PyPI | `abstractvoice` | 0.11.4 |
-| PyPI | `abstractvision` | 0.3.29 |
+| PyPI | `abstractvoice` | 0.13.0 |
+| PyPI | `abstractvision` | 0.3.30 |
 | PyPI | `abstractmusic` | 0.1.15 |
-| npm | `@abstractframework/flow` | 0.3.21 |
-| npm | `@abstractframework/code` | 0.5.0 |
-| npm | `@abstractframework/observer` | 0.1.13 |
-| npm | `@abstractframework/continuum` | 0.3.2 |
-| npm | `@abstractframework/entity` | 0.2.2 |
-| crates.io | `abstractcode` | 0.6.0 |
-| crates.io | `abstractgateway-console` | 0.9.0 |
-| crates.io | `abstractcore-console` | 0.2.0 |
+| npm | `@abstractframework/flow` | 0.4.0 |
+| npm | `@abstractframework/code` | 0.6.0 |
+| npm | `@abstractframework/observer` | 0.2.0 |
+| npm | `@abstractframework/continuum` | 0.4.0 |
+| npm | `@abstractframework/entity` | 0.3.0 |
+| crates.io | `abstractcode` | 0.7.0 |
+| crates.io | `abstractgateway-console` | 0.11.0 |
+| crates.io | `abstractcore-console` | 0.4.0 |
 | crates.io | `abstracttui` | 0.6.0 |
-| GHCR | `ghcr.io/lpalbou/abstractgateway` | 0.5.1 (`gpu-latest` / `<version>-gpu` experimental) |
-| GHCR | `ghcr.io/lpalbou/abstractcore-server` | 2.16.1 |
+| GHCR | `ghcr.io/lpalbou/abstractgateway` | 0.7.0 (`gpu-latest` / `<version>-gpu` experimental) |
+| GHCR | `ghcr.io/lpalbou/abstractcore-server` | 2.18.0 |
 
 Optional add-ons that are not part of any profile install separately:
 `pip install abstract3d` (0.3.1) and `pip install abstractcamera` (0.2.0). `abstractskill` (pinned above)
@@ -342,6 +350,7 @@ See [docs/install.md](docs/install.md) for the full install chooser, `uv`/venv g
 | [docs/install.md](docs/install.md) | Light / Apple / GPU install chooser and first checks |
 | [docs/getting-started.md](docs/getting-started.md) | Two entry points + first end-to-end run |
 | [docs/agent-sessions.md](docs/agent-sessions.md) | Default agent workflow, the conversation workspace and its protection, skills, live replies, the Assistant hand-over |
+| [docs/automations.md](docs/automations.md) | Automations: how they work (controller run, occurrences, independent vs growing context), creating and managing them from the Assistant, the Observer or a workflow, notifications, limits |
 | [docs/architecture.md](docs/architecture.md) | Component diagram, how a turn flows, the live-reply lane, app proxies, model eject, framework identity, durable execution primitives |
 | [docs/configuration.md](docs/configuration.md) | Minimal config, where defaults live, Core vs Gateway |
 | [docs/glossary.md](docs/glossary.md) | Shared terminology (run, ledger, effect, wait, bundle, …) |