abstractframework 0.3.2__tar.gz → 0.4.0__tar.gz

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

@@ -4,6 +4,69 @@ All notable changes to AbstractFramework will be documented in this file.
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-09-26
+
+A feature release of the whole framework. The gateway picks the agent workflow for AbstractCode
+and the Assistant, AbstractCode can browse the conversation's workspace, the gateway serves a
+curated skill shelf, replies stream live into every client, the console opens the Assistant
+already signed in, and every app has an About dialog. Ejecting a model frees its memory from the
+whole gateway process. This release replaces the 0.3.3 matrix, which was prepared but never
+published.
+
+### Changed (pins)
+- The dev build (`scripts/build.sh`) installs the sibling kit packages an app takes from npm (app-server, ui-kit, panel-chat, monitors) from local packs of the checkouts, so an app builds locally even when its kit floor is ahead of the registry. The manifests and lockfiles are left untouched.
+
+- **abstractgateway 0.5.0** (was 0.4.3 on PyPI): the default agent workflow setting
+  (`agents.default_workflow`, used by AbstractCode and the Assistant, changeable in the console or
+  with `abstractgateway config set`), the conversation workspace routes (browse and preview files,
+  with a built-in deny list for credential folders and the gateway data folder), the skill shelf
+  seeded from `abstractskill`, opening the Assistant signed in from the console, live replies
+  (`agents.streaming_default`), `GET /about`, the same-machine rule behind the app proxies, and
+  About in the web console and the terminal console. Ejecting a model frees its memory from the
+  whole gateway process and the memory figures show what the process really holds; gateways
+  started with an earlier version must be restarted once to reclaim memory already held. The
+  trust-proxy switch saved in the console now wins over `ABSTRACTGATEWAY_TRUST_PROXY`, which only
+  applies while nothing is saved.
+- **abstractcore 2.16.0** (was 2.15.2 in 0.3.2): framework identity for About screens
+  (`abstractcore.utils.identity`), process-wide model eject and memory reporting, embeddings
+  eject and reload, live-reply telemetry for MLX, and streamed and non-streamed replies that split
+  thinking from the answer the same way.
+- **AbstractRuntime 0.5.0** (was 0.4.35): live replies (`_runtime.stream`), workspace
+  built-in deny list, deferred model ejects with diagnostics.
+- **abstractagent 0.3.14** (was 0.3.13): delegated sub-agents inherit the live-reply switch.
+- **abstractskill 0.3.0** (new pin): the curated skill shelf ships inside the package.
+- **abstractassistant 0.6.0** (was 0.5.0): opens signed in when launched from the gateway
+  console, a workflow selector that follows the gateway default, live replies, About, and window
+  defaults.
+- The pins apply to the base install and to the `apple` / `gpu` extras
+  (`abstractgateway[apple|gpu]==0.5.0`, `abstractassistant[apple|gpu]==0.6.0`); the bootstrap
+  scripts install `abstractgateway[<profile>,tray]==0.5.0`. Unchanged: AbstractMemory 0.3.0,
+  abstractsemantics 0.0.5, abstractvoice 0.11.4, abstractvision 0.3.29, abstractmusic 0.1.15.
+- Browser apps released with it (`--with-apps`, `npx`): `@abstractframework/flow` 0.3.21,
+  `@abstractframework/code` 0.5.0, `@abstractframework/observer` 0.1.13,
+  `@abstractframework/continuum` 0.3.2 and `@abstractframework/entity` 0.2.2, built on
+  `@abstractframework/ui-kit` 0.1.12, `@abstractframework/app-server` 0.1.10 and
+  `@abstractframework/panel-chat` 0.1.17.
+- Terminal tools released with it: `abstractcode` 0.6.0 and `abstractgateway-console` 0.9.0
+  (`--with-code-cli`, `--with-console`); `abstractcore-console` 0.2.0 and `abstracttui` 0.6.0 are
+  unchanged.
+- Container images released with it: `ghcr.io/lpalbou/abstractgateway:0.5.0` (and `0.5.0-gpu`)
+  and `ghcr.io/lpalbou/abstractcore-server:2.16.0`.
+
+### Documentation
+
+- New [Agent sessions](docs/agent-sessions.md) page: the gateway's default agent workflow and how
+  AbstractCode and the Assistant follow it, the conversation workspace (browse and preview from
+  AbstractCode, the built-in deny list for credential folders and the gateway data folder), the
+  curated skill shelf, live replies, and opening the Assistant signed in from the console.
+- [Architecture](docs/architecture.md) adds diagrams of how a turn flows, the live-reply lane and
+  the framework identity flow, plus the app proxies' forwarded-address rule and model eject.
+- [CONTRIBUTING](CONTRIBUTING.md) documents the framework identity rule
+  (`identity/abstractframework.json` and `scripts/check_identity_sync.py`).
+- [Agent Skills](docs/guide/agent-skills.md) describes the shipped skills support; FAQ,
+  Troubleshooting, Configuration and Glossary cover the new settings; gateway examples use launch
+  flags (`serve --data-dir`, `network set --allowed-origins`).
+
 ## [0.3.2] - 2026-09-25
 
 A patch release: installing the Assistant and the engines works when the data folder path

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractframework
-Version: 0.3.2
+Version: 0.4.0
 Summary: Unified installer and documentation hub for the AbstractFramework ecosystem
 Author-email: Laurent-Philippe Albou <contact@abstractframework.ai>
 License: MIT
@@ -23,22 +23,23 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: abstractgateway==0.4.3
-Requires-Dist: abstractassistant==0.5.0
-Requires-Dist: abstractcore==2.15.2
-Requires-Dist: AbstractRuntime==0.4.35
-Requires-Dist: abstractagent==0.3.13
+Requires-Dist: abstractgateway==0.5.0
+Requires-Dist: abstractassistant==0.6.0
+Requires-Dist: abstractcore==2.16.0
+Requires-Dist: AbstractRuntime==0.5.0
+Requires-Dist: abstractagent==0.3.14
+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: abstractmusic==0.1.15
 Provides-Extra: apple
-Requires-Dist: abstractgateway[apple]==0.4.3; extra == "apple"
-Requires-Dist: abstractassistant[apple]==0.5.0; platform_system == "Darwin" and extra == "apple"
+Requires-Dist: abstractgateway[apple]==0.5.0; extra == "apple"
+Requires-Dist: abstractassistant[apple]==0.6.0; platform_system == "Darwin" and extra == "apple"
 Provides-Extra: gpu
-Requires-Dist: abstractgateway[gpu]==0.4.3; extra == "gpu"
-Requires-Dist: abstractassistant[gpu]==0.5.0; extra == "gpu"
+Requires-Dist: abstractgateway[gpu]==0.5.0; extra == "gpu"
+Requires-Dist: abstractassistant[gpu]==0.6.0; extra == "gpu"
 Dynamic: license-file
 
 # AbstractFramework
@@ -159,19 +160,17 @@ creates `default/admin` in the per-user data folder, and prints a one-time sign-
 web console and its first-run guide. `abstractgateway claim` mints a new link;
 `abstractgateway service install` starts the gateway at login.
 
-To choose the data folder, the allowed browser origins or your own workflow bundles, set the
-environment explicitly:
+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:
 
 ```bash
-export ABSTRACTGATEWAY_USER_AUTH=1
-export ABSTRACTGATEWAY_ALLOWED_ORIGINS="http://localhost:*,http://127.0.0.1:*"
-export ABSTRACTGATEWAY_WORKFLOW_SOURCE=bundle
-export ABSTRACTGATEWAY_DATA_DIR="$PWD/runtime/gateway"
-# export ABSTRACTGATEWAY_FLOWS_DIR="$PWD/bundles"   # serve your own bundle registry
-
-abstractgateway serve --host 127.0.0.1 --port 8080
+abstractgateway serve --data-dir "$PWD/runtime/gateway"
+abstractgateway network set --allowed-origins https://ui.example.com
 ```
 
+To serve your own workflow bundles instead of the shipped ones, start the gateway with
+`ABSTRACTGATEWAY_FLOWS_DIR` pointing at your bundle folder.
+
 Out of the box this serves a ready set of workflows — a verify-gated coding
 agent, `deep-research`, and `co-scientist` among them. See
 [shipped workflows](https://github.com/lpalbou/AbstractGateway/blob/main/docs/shipped-workflows.md).
@@ -191,11 +190,38 @@ ABSTRACTGATEWAY_AUTH_TOKEN=<token> abstractgateway-console --url http://127.0.0.
 ```
 
 Container images are published for the gateway and the AbstractCore server:
-`ghcr.io/lpalbou/abstractgateway:0.4.3` and `ghcr.io/lpalbou/abstractcore-server:2.15.2`.
+`ghcr.io/lpalbou/abstractgateway:0.5.0` and `ghcr.io/lpalbou/abstractcore-server:2.16.0`.
 
 For artifact and runtime-resource investigation, see
 [Runtime artifacts and retrieval](docs/guide/runtime-artifacts.md).
 
+### Agent sessions on the gateway
+
+Every client (AbstractCode in the terminal and the browser, AbstractAssistant, your own app)
+chats with agents through the same gateway rules:
+
+- **One default agent workflow.** The gateway decides which workflow answers each agent interface
+  (`agents.default_workflow.<interface>`; the shipped `basic-agent` for AbstractCode until you
+  choose another). Clients list **Gateway default** first and follow a change at the next turn.
+- **A workspace you can see, with built-in protection.** An agent works in a folder on the
+  gateway's computer; AbstractCode's **Files** tab and `/files` show its absolute path and
+  preview its files. Credential folders (`~/.ssh`, `~/.aws`, …) and the gateway's data folder are
+  denied to every run.
+- **Curated skills.** The skill shelf that ships with `abstractskill` is copied into the gateway's
+  data folder at each start, without overwriting your edits (`skills.shelf` points elsewhere).
+- **Live replies.** Watch answers as the model writes them: the gateway's
+  `agents.streaming_default` plus a **Stream replies** choice in each client.
+- **The Assistant, signed in for you.** **Open** in the gateway console starts the desktop
+  Assistant already signed in; no token to type.
+- **About everywhere.** Every app's About screen shows the framework identity and the versions
+  the connected gateway runs (`GET /api/gateway/about`).
+- **Clean model eject.** Ejecting a model frees it from the whole gateway process (MLX, GGUF,
+  transformers, embeddings); the console shows the memory the process holds and how it was
+  measured.
+
+Each setting is available in the web console, the terminal console and `abstractgateway config`.
+See [Agent sessions](docs/agent-sessions.md).
+
 ---
 
 ## Author once, run everywhere (AbstractFlow)
@@ -260,14 +286,14 @@ The ecosystem, grouped by layer. Each name links to the package's repository.
 
 | App | What it does | Install |
 |---|---|---|
-| [AbstractCode](https://github.com/lpalbou/AbstractCode) | Terminal agentic dev client (Rust, on the AbstractTUI engine) — durable sessions, tool approvals, `/workflow` support | `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, workflow picker per session, voice support | `pip install abstractassistant` |
+| [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` |
 | **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) | `npx @abstractframework/code` |
+| **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` |
 
 ### Shared libraries
@@ -275,8 +301,8 @@ The ecosystem, grouped by layer. Each name links to the package's repository.
 | Package | What it is |
 |---|---|
 | [abstracttui](https://github.com/lpalbou/AbstractTUI) | Rust terminal-UI engine built on fine-grained reactive signals |
-| [abstractuic](https://github.com/lpalbou/AbstractUIC) | Reusable UI kit for framework clients (React components + Web Components) |
-| [abstractskill](https://github.com/lpalbou/AbstractSkill) | Shared library for Agent Skills (`SKILL.md` folders: load, trust-gate, activate) |
+| [abstractuic](https://github.com/lpalbou/AbstractUIC) | Reusable UI kit for framework clients (React components + Web Components): chat panel with live replies, the shared About dialog, the app-server proxy |
+| [abstractskill](https://github.com/lpalbou/AbstractSkill) | Shared library for Agent Skills (`SKILL.md` folders: load, trust-gate, activate) and the curated skill shelf the gateway serves |
 
 ---
 
@@ -310,7 +336,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.3.2)
+### Release matrix (abstractframework 0.4.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
@@ -319,31 +345,33 @@ and tested together.
 
 | Registry | Package | Version |
 |---|---|---|
-| PyPI | `abstractgateway` | 0.4.3 |
-| PyPI | `abstractassistant` | 0.5.0 |
-| PyPI | `abstractcore` | 2.15.2 |
-| PyPI | `AbstractRuntime` | 0.4.35 |
-| PyPI | `abstractagent` | 0.3.13 |
+| PyPI | `abstractgateway` | 0.5.0 |
+| PyPI | `abstractassistant` | 0.6.0 |
+| PyPI | `abstractcore` | 2.16.0 |
+| PyPI | `AbstractRuntime` | 0.5.0 |
+| PyPI | `abstractagent` | 0.3.14 |
+| 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 | `abstractmusic` | 0.1.15 |
-| npm | `@abstractframework/flow` | 0.3.20 |
-| npm | `@abstractframework/code` | 0.4.2 |
-| npm | `@abstractframework/observer` | 0.1.12 |
-| npm | `@abstractframework/continuum` | 0.3.1 |
-| npm | `@abstractframework/entity` | 0.2.1 |
-| crates.io | `abstractcode` | 0.5.1 |
-| crates.io | `abstractgateway-console` | 0.8.0 |
+| 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 |
 | crates.io | `abstracttui` | 0.6.0 |
-| GHCR | `ghcr.io/lpalbou/abstractgateway` | 0.4.3 (`gpu-latest` / `<version>-gpu` experimental) |
-| GHCR | `ghcr.io/lpalbou/abstractcore-server` | 2.15.2 |
+| GHCR | `ghcr.io/lpalbou/abstractgateway` | 0.5.0 (`gpu-latest` / `<version>-gpu` experimental) |
+| GHCR | `ghcr.io/lpalbou/abstractcore-server` | 2.16.0 |
 
 Optional add-ons that are not part of any profile install separately:
-`pip install abstract3d` (0.3.1), `pip install abstractcamera` (0.2.0) and
-`pip install abstractskill` (0.2.1).
+`pip install abstract3d` (0.3.1) and `pip install abstractcamera` (0.2.0). `abstractskill` (pinned above)
+comes with the gateway, which carries its curated skill shelf; install it on its own with
+`pip install abstractskill`.
 
 See [docs/install.md](docs/install.md) for the full install chooser, `uv`/venv guidance,
 `abstractframework doctor`, and the generated installer manifest contract.
@@ -357,7 +385,8 @@ See [docs/install.md](docs/install.md) for the full install chooser, `uv`/venv g
 | [docs/README.md](docs/README.md) | Documentation hub — pick your starting point |
 | [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/architecture.md](docs/architecture.md) | Layered model, durable execution primitives, comparisons |
+| [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/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, …) |
 | [docs/faq.md](docs/faq.md) | Common questions, comparisons, limits |

abstractframework-0.3.2/abstractframework.egg-info/PKG-INFO → abstractframework-0.4.0/README.md

@@ -1,46 +1,3 @@
-Metadata-Version: 2.4
-Name: abstractframework
-Version: 0.3.2
-Summary: Unified installer and documentation hub for the AbstractFramework ecosystem
-Author-email: Laurent-Philippe Albou <contact@abstractframework.ai>
-License: MIT
-Project-URL: Homepage, https://github.com/lpalbou/AbstractFramework
-Project-URL: Documentation, https://github.com/lpalbou/AbstractFramework/tree/main/docs
-Project-URL: Repository, https://github.com/lpalbou/AbstractFramework
-Project-URL: Issues, https://github.com/lpalbou/AbstractFramework/issues
-Keywords: agentic-os,ai-agents,llm,autonomous-agents,workflows,multi-agent,durable-execution,knowledge-graph,openai,anthropic,ollama,local-llm
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Classifier: Typing :: Typed
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: abstractgateway==0.4.3
-Requires-Dist: abstractassistant==0.5.0
-Requires-Dist: abstractcore==2.15.2
-Requires-Dist: AbstractRuntime==0.4.35
-Requires-Dist: abstractagent==0.3.13
-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: abstractmusic==0.1.15
-Provides-Extra: apple
-Requires-Dist: abstractgateway[apple]==0.4.3; extra == "apple"
-Requires-Dist: abstractassistant[apple]==0.5.0; platform_system == "Darwin" and extra == "apple"
-Provides-Extra: gpu
-Requires-Dist: abstractgateway[gpu]==0.4.3; extra == "gpu"
-Requires-Dist: abstractassistant[gpu]==0.5.0; extra == "gpu"
-Dynamic: license-file
-
 # AbstractFramework
 
 **Write once. Generate everything.**
@@ -159,19 +116,17 @@ creates `default/admin` in the per-user data folder, and prints a one-time sign-
 web console and its first-run guide. `abstractgateway claim` mints a new link;
 `abstractgateway service install` starts the gateway at login.
 
-To choose the data folder, the allowed browser origins or your own workflow bundles, set the
-environment explicitly:
+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:
 
 ```bash
-export ABSTRACTGATEWAY_USER_AUTH=1
-export ABSTRACTGATEWAY_ALLOWED_ORIGINS="http://localhost:*,http://127.0.0.1:*"
-export ABSTRACTGATEWAY_WORKFLOW_SOURCE=bundle
-export ABSTRACTGATEWAY_DATA_DIR="$PWD/runtime/gateway"
-# export ABSTRACTGATEWAY_FLOWS_DIR="$PWD/bundles"   # serve your own bundle registry
-
-abstractgateway serve --host 127.0.0.1 --port 8080
+abstractgateway serve --data-dir "$PWD/runtime/gateway"
+abstractgateway network set --allowed-origins https://ui.example.com
 ```
 
+To serve your own workflow bundles instead of the shipped ones, start the gateway with
+`ABSTRACTGATEWAY_FLOWS_DIR` pointing at your bundle folder.
+
 Out of the box this serves a ready set of workflows — a verify-gated coding
 agent, `deep-research`, and `co-scientist` among them. See
 [shipped workflows](https://github.com/lpalbou/AbstractGateway/blob/main/docs/shipped-workflows.md).
@@ -191,11 +146,38 @@ ABSTRACTGATEWAY_AUTH_TOKEN=<token> abstractgateway-console --url http://127.0.0.
 ```
 
 Container images are published for the gateway and the AbstractCore server:
-`ghcr.io/lpalbou/abstractgateway:0.4.3` and `ghcr.io/lpalbou/abstractcore-server:2.15.2`.
+`ghcr.io/lpalbou/abstractgateway:0.5.0` and `ghcr.io/lpalbou/abstractcore-server:2.16.0`.
 
 For artifact and runtime-resource investigation, see
 [Runtime artifacts and retrieval](docs/guide/runtime-artifacts.md).
 
+### Agent sessions on the gateway
+
+Every client (AbstractCode in the terminal and the browser, AbstractAssistant, your own app)
+chats with agents through the same gateway rules:
+
+- **One default agent workflow.** The gateway decides which workflow answers each agent interface
+  (`agents.default_workflow.<interface>`; the shipped `basic-agent` for AbstractCode until you
+  choose another). Clients list **Gateway default** first and follow a change at the next turn.
+- **A workspace you can see, with built-in protection.** An agent works in a folder on the
+  gateway's computer; AbstractCode's **Files** tab and `/files` show its absolute path and
+  preview its files. Credential folders (`~/.ssh`, `~/.aws`, …) and the gateway's data folder are
+  denied to every run.
+- **Curated skills.** The skill shelf that ships with `abstractskill` is copied into the gateway's
+  data folder at each start, without overwriting your edits (`skills.shelf` points elsewhere).
+- **Live replies.** Watch answers as the model writes them: the gateway's
+  `agents.streaming_default` plus a **Stream replies** choice in each client.
+- **The Assistant, signed in for you.** **Open** in the gateway console starts the desktop
+  Assistant already signed in; no token to type.
+- **About everywhere.** Every app's About screen shows the framework identity and the versions
+  the connected gateway runs (`GET /api/gateway/about`).
+- **Clean model eject.** Ejecting a model frees it from the whole gateway process (MLX, GGUF,
+  transformers, embeddings); the console shows the memory the process holds and how it was
+  measured.
+
+Each setting is available in the web console, the terminal console and `abstractgateway config`.
+See [Agent sessions](docs/agent-sessions.md).
+
 ---
 
 ## Author once, run everywhere (AbstractFlow)
@@ -260,14 +242,14 @@ The ecosystem, grouped by layer. Each name links to the package's repository.
 
 | App | What it does | Install |
 |---|---|---|
-| [AbstractCode](https://github.com/lpalbou/AbstractCode) | Terminal agentic dev client (Rust, on the AbstractTUI engine) — durable sessions, tool approvals, `/workflow` support | `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, workflow picker per session, voice support | `pip install abstractassistant` |
+| [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` |
 | **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) | `npx @abstractframework/code` |
+| **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` |
 
 ### Shared libraries
@@ -275,8 +257,8 @@ The ecosystem, grouped by layer. Each name links to the package's repository.
 | Package | What it is |
 |---|---|
 | [abstracttui](https://github.com/lpalbou/AbstractTUI) | Rust terminal-UI engine built on fine-grained reactive signals |
-| [abstractuic](https://github.com/lpalbou/AbstractUIC) | Reusable UI kit for framework clients (React components + Web Components) |
-| [abstractskill](https://github.com/lpalbou/AbstractSkill) | Shared library for Agent Skills (`SKILL.md` folders: load, trust-gate, activate) |
+| [abstractuic](https://github.com/lpalbou/AbstractUIC) | Reusable UI kit for framework clients (React components + Web Components): chat panel with live replies, the shared About dialog, the app-server proxy |
+| [abstractskill](https://github.com/lpalbou/AbstractSkill) | Shared library for Agent Skills (`SKILL.md` folders: load, trust-gate, activate) and the curated skill shelf the gateway serves |
 
 ---
 
@@ -310,7 +292,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.3.2)
+### Release matrix (abstractframework 0.4.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
@@ -319,31 +301,33 @@ and tested together.
 
 | Registry | Package | Version |
 |---|---|---|
-| PyPI | `abstractgateway` | 0.4.3 |
-| PyPI | `abstractassistant` | 0.5.0 |
-| PyPI | `abstractcore` | 2.15.2 |
-| PyPI | `AbstractRuntime` | 0.4.35 |
-| PyPI | `abstractagent` | 0.3.13 |
+| PyPI | `abstractgateway` | 0.5.0 |
+| PyPI | `abstractassistant` | 0.6.0 |
+| PyPI | `abstractcore` | 2.16.0 |
+| PyPI | `AbstractRuntime` | 0.5.0 |
+| PyPI | `abstractagent` | 0.3.14 |
+| 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 | `abstractmusic` | 0.1.15 |
-| npm | `@abstractframework/flow` | 0.3.20 |
-| npm | `@abstractframework/code` | 0.4.2 |
-| npm | `@abstractframework/observer` | 0.1.12 |
-| npm | `@abstractframework/continuum` | 0.3.1 |
-| npm | `@abstractframework/entity` | 0.2.1 |
-| crates.io | `abstractcode` | 0.5.1 |
-| crates.io | `abstractgateway-console` | 0.8.0 |
+| 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 |
 | crates.io | `abstracttui` | 0.6.0 |
-| GHCR | `ghcr.io/lpalbou/abstractgateway` | 0.4.3 (`gpu-latest` / `<version>-gpu` experimental) |
-| GHCR | `ghcr.io/lpalbou/abstractcore-server` | 2.15.2 |
+| GHCR | `ghcr.io/lpalbou/abstractgateway` | 0.5.0 (`gpu-latest` / `<version>-gpu` experimental) |
+| GHCR | `ghcr.io/lpalbou/abstractcore-server` | 2.16.0 |
 
 Optional add-ons that are not part of any profile install separately:
-`pip install abstract3d` (0.3.1), `pip install abstractcamera` (0.2.0) and
-`pip install abstractskill` (0.2.1).
+`pip install abstract3d` (0.3.1) and `pip install abstractcamera` (0.2.0). `abstractskill` (pinned above)
+comes with the gateway, which carries its curated skill shelf; install it on its own with
+`pip install abstractskill`.
 
 See [docs/install.md](docs/install.md) for the full install chooser, `uv`/venv guidance,
 `abstractframework doctor`, and the generated installer manifest contract.
@@ -357,7 +341,8 @@ See [docs/install.md](docs/install.md) for the full install chooser, `uv`/venv g
 | [docs/README.md](docs/README.md) | Documentation hub — pick your starting point |
 | [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/architecture.md](docs/architecture.md) | Layered model, durable execution primitives, comparisons |
+| [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/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, …) |
 | [docs/faq.md](docs/faq.md) | Common questions, comparisons, limits |

{abstractframework-0.3.2 → abstractframework-0.4.0}/abstractframework/__init__.py

@@ -10,21 +10,22 @@ Most implementation functionality still lives in component projects.
 
 from __future__ import annotations
 
-__version__ = "0.3.2"
+__version__ = "0.4.0"
 __author__ = "Laurent-Philippe Albou"
 __license__ = "MIT"
 
 RELEASE_VERSIONS: dict[str, str] = {
-    "abstractcore": "2.15.2",
-    "abstractruntime": "0.4.35",
-    "abstractagent": "0.3.13",
-    "abstractgateway": "0.4.3",
+    "abstractcore": "2.16.0",
+    "abstractruntime": "0.5.0",
+    "abstractagent": "0.3.14",
+    "abstractgateway": "0.5.0",
+    "abstractskill": "0.3.0",
     "abstractmemory": "0.3.0",
     "abstractsemantics": "0.0.5",
     "abstractvoice": "0.11.4",
     "abstractvision": "0.3.29",
     "abstractmusic": "0.1.15",
-    "abstractassistant": "0.5.0",
+    "abstractassistant": "0.6.0",
 }
 
 PACKAGE_DISTRIBUTIONS: dict[str, str] = {
@@ -32,6 +33,7 @@ PACKAGE_DISTRIBUTIONS: dict[str, str] = {
     "abstractruntime": "AbstractRuntime",
     "abstractagent": "abstractagent",
     "abstractgateway": "abstractgateway",
+    "abstractskill": "abstractskill",
     "abstractmemory": "AbstractMemory",
     "abstractsemantics": "abstractsemantics",
     "abstractvoice": "abstractvoice",
@@ -41,19 +43,19 @@ PACKAGE_DISTRIBUTIONS: dict[str, str] = {
 }
 
 NPM_RELEASE_VERSIONS: dict[str, str] = {
-    "@abstractframework/flow": "0.3.20",
-    "@abstractframework/code": "0.4.2",
-    "@abstractframework/observer": "0.1.12",
-    "@abstractframework/continuum": "0.3.1",
-    "@abstractframework/entity": "0.2.1",
+    "@abstractframework/flow": "0.3.21",
+    "@abstractframework/code": "0.5.0",
+    "@abstractframework/observer": "0.1.13",
+    "@abstractframework/continuum": "0.3.2",
+    "@abstractframework/entity": "0.2.2",
 }
 
 # Terminal tools published on crates.io alongside this release (installed with `cargo install`,
 # or by the bootstrap scripts' --with-console / --with-code-cli flags).
 CRATE_RELEASE_VERSIONS: dict[str, str] = {
-    "abstractgateway-console": "0.8.0",
+    "abstractgateway-console": "0.9.0",
     "abstractcore-console": "0.2.0",
-    "abstractcode": "0.5.1",
+    "abstractcode": "0.6.0",
     "abstracttui": "0.6.0",
 }