abstractframework 0.3.1__tar.gz → 0.4.0__tar.gz

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

@@ -2,6 +2,110 @@
 
 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
+contains a space (such as the macOS Application Support folder), and the default MLX model id
+names a published repository.
+
+### Changed (pins)
+
+- **abstractcore 2.15.2** (was 2.15.1; the default MLX model id names a published repository),
+  **AbstractRuntime 0.4.35** (was 0.4.34) and **abstractgateway 0.4.3** (was 0.4.2; installing the
+  Assistant and engines works when the data folder path contains a space, such as the macOS
+  Application Support folder; the console page carries no maintainer comments), in the base
+  install and in the `apple` / `gpu` extras (`abstractgateway[apple|gpu]==0.4.3`). The bootstrap
+  scripts install `abstractgateway[<profile>,tray]==0.4.3`. The other pins are unchanged:
+  abstractagent 0.3.13, AbstractMemory 0.3.0, abstractsemantics 0.0.5, abstractvoice 0.11.4,
+  abstractvision 0.3.29, abstractmusic 0.1.15, abstractassistant 0.5.0. Unchanged too:
+  `abstractgateway-console` 0.8.0, ui-kit 0.1.11 and the browser apps flow 0.3.20, code 0.4.2
+  and observer 0.1.12.
+- Browser apps released with it (`--with-apps`, `npx`): `@abstractframework/continuum` 0.3.1
+  (was 0.3.0) and `@abstractframework/entity` 0.2.1 (was 0.2.0).
+- Container images released with it: `ghcr.io/lpalbou/abstractgateway:0.4.3` (and `0.4.3-gpu`)
+  and `ghcr.io/lpalbou/abstractcore-server:2.15.2`.
+
+### Documentation
+
+- New [Troubleshooting](docs/troubleshooting.md) page (installer blocked by macOS, sign-in links,
+  ports, network access, providers), and root `CONTRIBUTING.md`, `SECURITY.md`,
+  `CODE_OF_CONDUCT.md` and `ACKNOWLEDGEMENTS.md`.
+- [Install](docs/install.md) states the one-time **Open Anyway** step for the unsigned Mac
+  installer as part of the install, lists every installer option, and documents the gateway's
+  Network setting (`abstractgateway network`). `service install` examples no longer pass `--host`,
+  which would store `localhost` over a chosen Network mode.
+- [Architecture](docs/architecture.md) has a Mermaid component diagram of the released packages.
+- README and docs link to each component's GitHub repository.
+- `llms-full.txt` now carries the pages the docs index links, including Troubleshooting and the
+  installer implementation plan, and no longer includes backlog items or the Agent Skills research
+  notes. `python scripts/gen_llms_full.py --check` fails when it is stale or when a docs page is
+  missing from the index.
+
 ## [0.3.1] - 2026-09-24
 
 A patch release that pins abstractcore 2.15.1 and abstractgateway 0.4.2: download cancels are
@@ -18,8 +122,8 @@ totals it compared; one Install button per app; the Assistant appears as an app.
   AbstractMemory 0.3.0, abstractsemantics 0.0.5, abstractvoice 0.11.4, abstractvision 0.3.29,
   abstractmusic 0.1.15, abstractassistant 0.5.0. Unchanged too: `abstractgateway-console` 0.8.0
   and the browser apps (continuum 0.3.0, entity 0.2.0, flow 0.3.20, code 0.4.2, observer 0.1.12).
-- The docs name the container images released with it: `ghcr.io/lpalbou/abstractgateway:0.4.2`
-  (and `0.4.2-gpu`) and `ghcr.io/lpalbou/abstractcore-server:2.15.1`.
+- Container images released with it: `ghcr.io/lpalbou/abstractgateway:0.4.2` (and `0.4.2-gpu`)
+  and `ghcr.io/lpalbou/abstractcore-server:2.15.1`.
 
 ### What the new pins bring
 
@@ -54,13 +158,10 @@ uninstaller), install failures explained in plain words, and the meta-package pi
 - Browser apps released with it (`--with-apps`, `npx`): `@abstractframework/continuum` 0.3.0 (was
   0.2.0) and `@abstractframework/entity` 0.2.0 (was 0.1.0); flow 0.3.20, code 0.4.2 and observer
   0.1.12 are unchanged.
-- The docs name the container images released with it: `ghcr.io/lpalbou/abstractgateway:0.4.1`
-  and `ghcr.io/lpalbou/abstractcore-server:2.15.0`.
-- `docs/backlog/planned/0859` states the real stack port map (observer 3001, continuum 3002,
-  code 3003, entity 3004, flow 3005), as `scripts/start-local.sh` and the gateway's
-  `STACK_PORTS` use.
-- `scripts/lib/packages.txt`: abstractgateway 0.4.1 depends on abstractcore directly
-  (`abstractcore>=2.15.0`), so its edge is `abstractcore:dep` (was `extra`).
+- Container images released with it: `ghcr.io/lpalbou/abstractgateway:0.4.1` and
+  `ghcr.io/lpalbou/abstractcore-server:2.15.0`.
+- Workspace scripts (`scripts/lib/packages.txt`): abstractgateway depends on abstractcore directly,
+  so `deps.sh` and `build.sh` order it after abstractcore.
 
 ### Added
 
@@ -95,8 +196,8 @@ uninstaller), install failures explained in plain words, and the meta-package pi
   `uv tool update-shell` warning. The health wait is 180 s (the first start loads the engines) with
   a progress line every 15 s.
 - **The gateway's Network setting decides where it listens, not the installer.** `install.sh` and
-  `install.ps1` no longer pass `--host 127.0.0.1` to `abstractgateway service install` (it reset a
-  "Local network" choice to localhost on every re-run); they pass `--port` only. Without a login
+  `install.ps1` pass only `--port` to `abstractgateway service install`, so re-running the
+  installer keeps a "Local network" choice. Without a login
   item (background mode) they store the setting first (`abstractgateway network set localhost
   --port N` when nothing is stored; a stored mode is kept and only the port aligned) and start plain
   `abstractgateway serve`. Gateways without the `network` command keep the old
@@ -115,14 +216,11 @@ uninstaller), install failures explained in plain words, and the meta-package pi
   Where no wheel exists (Intel Mac, musl Linux, Windows on ARM) or the wheel install fails, the
   script installs without it and prints `GGUF (llama.cpp) skipped: no prebuilt wheel for this
   machine; re-run with --full after installing a C compiler`. The summary's `GGUF:` line says what
-  was installed. `--full` builds llama.cpp from source, now in the light profile too. CI's
-  bootstrap smoke imports `llama_cpp` from the installed gateway on macOS, Linux and Windows and
-  checks GPU offload on macOS.
+  was installed. `--full` builds llama.cpp from source, in the light profile too.
 
 ### Known limitations
 
-These are unchanged from 0.2.1 (the same packages, checked with `uv pip install --dry-run
---no-build` against both releases). The one-line installer is not affected by the first two: it
+These are unchanged from 0.2.1. The one-line installer is not affected by the first two: it
 installs the gateway, not `abstractassistant`, and builds pure-Python source packages.
 
 - A plain `pip install abstractframework` on Linux builds `evdev` from source (a C compiler and
@@ -131,8 +229,9 @@ installs the gateway, not `abstractassistant`, and builds pure-Python source pac
   published as source only; they are pure Python and build without a compiler.
 - `abstractframework[gpu]` on Linux needs glibc 2.35 or later (Ubuntu 22.04+): `mlx[cuda13]`,
   pulled by `abstractvision[all-gpu]` through `mlx-gen`, has only `manylinux_2_35` wheels.
-- The macOS `.pkg` built by `scripts/lib/build_macos_installer.sh` is not signed yet, so
-  Gatekeeper asks the user to allow it ("Open Anyway").
+- `AbstractFramework-Installer.pkg` is not signed with an Apple Developer ID: macOS asks you to
+  allow it once (**Open Anyway** in **System Settings > Privacy & Security**). The one-line install
+  is not affected.
 
 ## [0.2.1] - 2026-09-24
 
@@ -191,7 +290,7 @@ manage local models and engines from the console, the terminal or the command li
   Options: `--profile`, `--port`, `--with-apps` (Node.js through `nodejs-wheel`), `--with-ollama`,
   `--with-lmstudio`, `--with-console`, `--with-code-cli`, `--with-core-cli`, `--no-service`,
   `--no-open`, `--pin`, `--print` (dry run), `--uninstall [--purge]`. Re-running upgrades or
-  repairs in place. See [Install](docs/install.md#quick-start).
+  repairs in place. See [Install](docs/install.md).
 - **First-run wizard.** Through the pinned gateway 0.3.0, a bare `abstractgateway serve` binds
   `127.0.0.1`, creates the admin user and prints a one-time console link; the console's first-run
   guide sets up a local engine, a default model that fits the machine, and the apps.

{abstractframework-0.3.1/abstractframework.egg-info → abstractframework-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractframework
-Version: 0.3.1
+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.2
-Requires-Dist: abstractassistant==0.5.0
-Requires-Dist: abstractcore==2.15.1
-Requires-Dist: AbstractRuntime==0.4.34
-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.2; 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.2; 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
@@ -69,7 +70,9 @@ MLX, llama.cpp), downloads a model that fits your machine, and lists the apps.
 
 - **Mac, no Terminal:** download and double-click
   [AbstractFramework-Installer.pkg](https://github.com/lpalbou/AbstractFramework/releases/latest/download/AbstractFramework-Installer.pkg).
-  A Terminal window shows each step; press Return at its one question.
+  The package is not signed with an Apple Developer ID, so the first time macOS blocks it: open
+  **System Settings > Privacy & Security**, click **Open Anyway** next to the installer's name and
+  confirm. A Terminal window then shows each step; press Return at its one question.
 - **macOS / Linux, one line:**
 
   ```bash
@@ -83,10 +86,11 @@ MLX, llama.cpp), downloads a model that fits your machine, and lists the apps.
   ```
 
 Every failure says what to do next; running the installer again repairs or upgrades in place. To
-remove it: `Uninstall AbstractFramework.command`, or
+remove it, double-click `Uninstall AbstractFramework.command` (in
+`~/Library/Application Support/AbstractFramework/Installer` after a package install), or run
 `curl -LsSf https://raw.githubusercontent.com/lpalbou/AbstractFramework/main/scripts/uninstall.sh | sh`.
 Step by step, the failure table, options (`--with-apps`, `--with-ollama`, `--print`, …):
-[Install](docs/install.md).
+[Install](docs/install.md). Something not working: [Troubleshooting](docs/troubleshooting.md).
 
 Already have Python? Either entry point works the same way: start it, then open the link it prints.
 
@@ -156,22 +160,20 @@ 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](abstractgateway/docs/shipped-workflows.md).
+[shipped workflows](https://github.com/lpalbou/AbstractGateway/blob/main/docs/shipped-workflows.md).
 
 The `admin` user token is kept in `<data dir>/auth/bootstrap-admin-token`; use it to sign in to
 AbstractFlow, AbstractCode Web or AbstractObserver, or to the console without a claim link.
@@ -188,10 +190,37 @@ 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.2` and `ghcr.io/lpalbou/abstractcore-server:2.15.1`.
+`ghcr.io/lpalbou/abstractgateway:0.5.0` and `ghcr.io/lpalbou/abstractcore-server:2.16.0`.
 
 For artifact and runtime-resource investigation, see
-`docs/guide/runtime-artifacts.md`.
+[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).
 
 ---
 
@@ -204,7 +233,7 @@ AbstractFlow lets you author complex agentic orchestration as portable `.flow` b
 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)
 
-**AbstractAgent** provides ready-made agent patterns (ReAct, CodeAct, MemAct) that can be used inside flows or standalone. The workflows Gateway ships with are authored the same way — their editable sources are documented in [shipped workflow sources](abstractflow/docs/shipped-workflow-sources.md).
+**AbstractAgent** provides ready-made agent patterns (ReAct, CodeAct, MemAct) that can be used inside flows or standalone. The workflows Gateway ships with are authored the same way — their editable sources are documented in [shipped workflow sources](https://github.com/lpalbou/AbstractFlow/blob/main/docs/shipped-workflow-sources.md).
 
 ---
 
@@ -218,62 +247,62 @@ AbstractFlow lets you author complex agentic orchestration as portable `.flow` b
 
 ## Package map
 
-The ecosystem, grouped by layer. Each name links to the package's own README.
+The ecosystem, grouped by layer. Each name links to the package's repository.
 
 ### Foundation
 
 | Package | What it is |
 |---|---|
-| [abstractcore](abstractcore/) | Unified LLM interface: 9+ providers, tools, structured output, media, embeddings, `/v1` server, capability plugins |
-| [abstractsemantics](abstractsemantics/) | Central semantics registry (predicates + entity types) with JSON-Schema helpers |
-| [abstractmemory](abstractmemory/) | Durable, append-only agent memory: usage-weighted graph + journal — recall, formation, consolidation (the entity mind engine) |
+| [abstractcore](https://github.com/lpalbou/AbstractCore) | Unified LLM interface: 9+ providers, tools, structured output, media, embeddings, `/v1` server, capability plugins |
+| [abstractsemantics](https://github.com/lpalbou/AbstractSemantics) | Central semantics registry (predicates + entity types) with JSON-Schema helpers |
+| [abstractmemory](https://github.com/lpalbou/AbstractMemory) | Durable, append-only agent memory: usage-weighted graph + journal — recall, formation, consolidation (the entity mind engine) |
 
 ### Durable execution
 
 | Package | What it is |
 |---|---|
-| [abstractruntime](abstractruntime/) | Durable execution kernel: runs, effects, waits, append-only ledger, artifacts; the VisualFlow compiler (visual graphs → executable workflows); the entity identity lane (homes, chat/life/visit drivers) |
-| [abstractagent](abstractagent/) | Agent patterns (ReAct / CodeAct / MemAct) composing Runtime + Core |
-| [abstractflow](abstractflow/) | Visual workflow editor + portable `.flow` bundles — author once, run anywhere |
+| [abstractruntime](https://github.com/lpalbou/AbstractRuntime) | Durable execution kernel: runs, effects, waits, append-only ledger, artifacts; the VisualFlow compiler (visual graphs → executable workflows); the entity identity lane (homes, chat/life/visit drivers) |
+| [abstractagent](https://github.com/lpalbou/AbstractAgent) | Agent patterns (ReAct / CodeAct / MemAct) composing Runtime + Core |
+| [abstractflow](https://github.com/lpalbou/AbstractFlow) | Visual workflow editor + portable `.flow` bundles — author once, run anywhere |
 
 ### Control plane
 
 | Package | What it is |
 |---|---|
-| [abstractgateway](abstractgateway/) | Deployable control plane: durable runs over HTTP/SSE, scheduling + run commands (cancel/steer), workflow catalog, artifact/ledger serving, multi-user auth with per-user runtimes, the summoned-entity lifecycle (create / summon / visit / state / blueprint), and the operator consoles (web + TUI) |
+| [abstractgateway](https://github.com/lpalbou/AbstractGateway) | Deployable control plane: durable runs over HTTP/SSE, scheduling + run commands (cancel/steer), workflow catalog, artifact/ledger serving, multi-user auth with per-user runtimes, the summoned-entity lifecycle (create / summon / visit / state / blueprint), and the operator consoles (web + TUI) |
 
 ### Multimodal capabilities
 
 | Package | What it is |
 |---|---|
-| [abstractvoice](abstractvoice/) | Voice I/O (TTS / STT), local and remote backends |
-| [abstractvision](abstractvision/) | Model-agnostic generative vision (images, optional video) |
-| [abstractmusic](abstractmusic/) | Text-to-music / text-to-audio (Core capability plugin) |
-| [abstract3d](abstract3d/) | Local-first 3D generation |
-| [abstractcamera](abstractcamera/) | Camera control and capture tools |
-| [abstractsound](abstractsound/), [abstractvideo](abstractvideo/), [abstractspatial](abstractspatial/), [abstractgeometry](abstractgeometry/), [abstractcognition](abstractcognition/) | Reserved capability packages (namespaces held; APIs landing incrementally) |
+| [abstractvoice](https://github.com/lpalbou/AbstractVoice) | Voice I/O (TTS / STT), local and remote backends |
+| [abstractvision](https://github.com/lpalbou/AbstractVision) | Model-agnostic generative vision (images, optional video) |
+| [abstractmusic](https://github.com/lpalbou/AbstractMusic) | Text-to-music / text-to-audio (Core capability plugin) |
+| [abstract3d](https://github.com/lpalbou/abstract3d) | Local-first 3D generation |
+| [abstractcamera](https://github.com/lpalbou/AbstractCamera) | Camera control and capture tools |
+| `abstractsound`, `abstractvideo`, `abstractspatial`, `abstractgeometry`, `abstractcognition` | Reserved capability packages (namespaces held; APIs landing incrementally) |
 
 ### Apps and clients
 
 | App | What it does | Install |
 |---|---|---|
-| [AbstractCode](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](abstractassistant/) | macOS tray client — gateway-native, workflow picker per session, voice support | `pip install abstractassistant` |
-| [AbstractObserver](abstractobserver/) | Browser UI — monitor, control, and schedule gateway runs | `npx @abstractframework/observer` |
-| [AbstractEntity](abstractentity/) | Summoned-entity manager — roster, blueprint (cognition map + editing), chat drawer, live replay | `npx @abstractframework/entity` |
-| [AbstractContinuum](abstractcontinuum/) | Continuous iterative development and deployment console | `npx @abstractframework/continuum` |
+| [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
 
 | Package | What it is |
 |---|---|
-| [abstracttui](abstracttui/) | Rust terminal-UI engine built on fine-grained reactive signals |
-| [abstractuic](abstractuic/) | Reusable UI kit for framework clients (React components + Web Components) |
-| [abstractskill](abstractskill/) | Shared library for Agent Skills (`SKILL.md` folders: load, trust-gate, activate) |
+| [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): 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 |
 
 ---
 
@@ -307,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.1)
+### 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
@@ -316,31 +345,33 @@ and tested together.
 
 | Registry | Package | Version |
 |---|---|---|
-| PyPI | `abstractgateway` | 0.4.2 |
-| PyPI | `abstractassistant` | 0.5.0 |
-| PyPI | `abstractcore` | 2.15.1 |
-| PyPI | `AbstractRuntime` | 0.4.34 |
-| 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.0 |
-| npm | `@abstractframework/entity` | 0.2.0 |
-| 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.2 (`gpu-latest` / `<version>-gpu` experimental) |
-| GHCR | `ghcr.io/lpalbou/abstractcore-server` | 2.15.1 |
+| 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.
@@ -354,12 +385,17 @@ 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, troubleshooting |
-| [docs/api.md](docs/api.md) | Meta-package API (pins, helpers, re-exports) |
+| [docs/faq.md](docs/faq.md) | Common questions, comparisons, limits |
+| [docs/troubleshooting.md](docs/troubleshooting.md) | Symptoms, checks and fixes for install, sign-in, network and provider problems |
+| [docs/api.md](docs/api.md) | Meta-package API (pins, helpers, re-exports, `abstractframework doctor`) |
 | [docs/workspace-scripts.md](docs/workspace-scripts.md) | Working from source: package tiers, build, status, pull/commit/push scripts |
+| [CHANGELOG.md](CHANGELOG.md) | Release history of the meta-package and its pins |
+| [CONTRIBUTING.md](CONTRIBUTING.md) | How to work on this repository and propose changes |
+| [SECURITY.md](SECURITY.md) | How to report a vulnerability |
 
 ---
 
@@ -390,4 +426,5 @@ abstractcore --install   # check every subsystem and download missing models and
 
 ## License
 
-MIT. See [LICENSE](LICENSE).
+MIT. See [LICENSE](LICENSE). Credits: [ACKNOWLEDGEMENTS.md](ACKNOWLEDGEMENTS.md). Community
+expectations: [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).