abstractframework 0.3.1__tar.gz → 0.3.2__tar.gz

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

@@ -2,6 +2,47 @@
 
 All notable changes to AbstractFramework will be documented in this file.
 
+## [Unreleased]
+
+## [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 +59,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 +95,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 +133,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 +153,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 +166,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 +227,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.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractframework
-Version: 0.3.1
+Version: 0.3.2
 Summary: Unified installer and documentation hub for the AbstractFramework ecosystem
 Author-email: Laurent-Philippe Albou <contact@abstractframework.ai>
 License: MIT
@@ -23,10 +23,10 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: abstractgateway==0.4.2
+Requires-Dist: abstractgateway==0.4.3
 Requires-Dist: abstractassistant==0.5.0
-Requires-Dist: abstractcore==2.15.1
-Requires-Dist: AbstractRuntime==0.4.34
+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
@@ -34,10 +34,10 @@ 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: 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.2; extra == "gpu"
+Requires-Dist: abstractgateway[gpu]==0.4.3; extra == "gpu"
 Requires-Dist: abstractassistant[gpu]==0.5.0; extra == "gpu"
 Dynamic: license-file
 
@@ -69,7 +69,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 +85,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.
 
@@ -171,7 +174,7 @@ abstractgateway serve --host 127.0.0.1 --port 8080
 
 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 +191,10 @@ 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.4.3` and `ghcr.io/lpalbou/abstractcore-server:2.15.2`.
 
 For artifact and runtime-resource investigation, see
-`docs/guide/runtime-artifacts.md`.
+[Runtime artifacts and retrieval](docs/guide/runtime-artifacts.md).
 
 ---
 
@@ -204,7 +207,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,50 +221,50 @@ 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, `/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` |
+| [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` |
@@ -271,9 +274,9 @@ The ecosystem, grouped by layer. Each name links to the package's own README.
 
 | 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) |
+| [abstractskill](https://github.com/lpalbou/AbstractSkill) | Shared library for Agent Skills (`SKILL.md` folders: load, trust-gate, activate) |
 
 ---
 
@@ -307,7 +310,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.3.2)
 
 `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,10 +319,10 @@ and tested together.
 
 | Registry | Package | Version |
 |---|---|---|
-| PyPI | `abstractgateway` | 0.4.2 |
+| PyPI | `abstractgateway` | 0.4.3 |
 | PyPI | `abstractassistant` | 0.5.0 |
-| PyPI | `abstractcore` | 2.15.1 |
-| PyPI | `AbstractRuntime` | 0.4.34 |
+| PyPI | `abstractcore` | 2.15.2 |
+| PyPI | `AbstractRuntime` | 0.4.35 |
 | PyPI | `abstractagent` | 0.3.13 |
 | PyPI | `AbstractMemory` | 0.3.0 |
 | PyPI | `abstractsemantics` | 0.0.5 |
@@ -329,14 +332,14 @@ and tested together.
 | 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 |
+| 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 |
 | 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.4.3 (`gpu-latest` / `<version>-gpu` experimental) |
+| GHCR | `ghcr.io/lpalbou/abstractcore-server` | 2.15.2 |
 
 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
@@ -357,9 +360,13 @@ See [docs/install.md](docs/install.md) for the full install chooser, `uv`/venv g
 | [docs/architecture.md](docs/architecture.md) | Layered model, durable execution primitives, comparisons |
 | [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 +397,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).

{abstractframework-0.3.1 → abstractframework-0.3.2}/README.md

@@ -26,7 +26,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
@@ -40,10 +42,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.
 
@@ -128,7 +131,7 @@ abstractgateway serve --host 127.0.0.1 --port 8080
 
 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.
@@ -145,10 +148,10 @@ 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.4.3` and `ghcr.io/lpalbou/abstractcore-server:2.15.2`.
 
 For artifact and runtime-resource investigation, see
-`docs/guide/runtime-artifacts.md`.
+[Runtime artifacts and retrieval](docs/guide/runtime-artifacts.md).
 
 ---
 
@@ -161,7 +164,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).
 
 ---
 
@@ -175,50 +178,50 @@ 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, `/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` |
+| [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` |
@@ -228,9 +231,9 @@ The ecosystem, grouped by layer. Each name links to the package's own README.
 
 | 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) |
+| [abstractskill](https://github.com/lpalbou/AbstractSkill) | Shared library for Agent Skills (`SKILL.md` folders: load, trust-gate, activate) |
 
 ---
 
@@ -264,7 +267,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.3.2)
 
 `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
@@ -273,10 +276,10 @@ and tested together.
 
 | Registry | Package | Version |
 |---|---|---|
-| PyPI | `abstractgateway` | 0.4.2 |
+| PyPI | `abstractgateway` | 0.4.3 |
 | PyPI | `abstractassistant` | 0.5.0 |
-| PyPI | `abstractcore` | 2.15.1 |
-| PyPI | `AbstractRuntime` | 0.4.34 |
+| PyPI | `abstractcore` | 2.15.2 |
+| PyPI | `AbstractRuntime` | 0.4.35 |
 | PyPI | `abstractagent` | 0.3.13 |
 | PyPI | `AbstractMemory` | 0.3.0 |
 | PyPI | `abstractsemantics` | 0.0.5 |
@@ -286,14 +289,14 @@ and tested together.
 | 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 |
+| 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 |
 | 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.4.3 (`gpu-latest` / `<version>-gpu` experimental) |
+| GHCR | `ghcr.io/lpalbou/abstractcore-server` | 2.15.2 |
 
 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
@@ -314,9 +317,13 @@ See [docs/install.md](docs/install.md) for the full install chooser, `uv`/venv g
 | [docs/architecture.md](docs/architecture.md) | Layered model, durable execution primitives, comparisons |
 | [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 |
 
 ---
 
@@ -347,4 +354,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).

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

@@ -10,15 +10,15 @@ Most implementation functionality still lives in component projects.
 
 from __future__ import annotations
 
-__version__ = "0.3.1"
+__version__ = "0.3.2"
 __author__ = "Laurent-Philippe Albou"
 __license__ = "MIT"
 
 RELEASE_VERSIONS: dict[str, str] = {
-    "abstractcore": "2.15.1",
-    "abstractruntime": "0.4.34",
+    "abstractcore": "2.15.2",
+    "abstractruntime": "0.4.35",
     "abstractagent": "0.3.13",
-    "abstractgateway": "0.4.2",
+    "abstractgateway": "0.4.3",
     "abstractmemory": "0.3.0",
     "abstractsemantics": "0.0.5",
     "abstractvoice": "0.11.4",
@@ -44,8 +44,8 @@ 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.0",
-    "@abstractframework/entity": "0.2.0",
+    "@abstractframework/continuum": "0.3.1",
+    "@abstractframework/entity": "0.2.1",
 }
 
 # Terminal tools published on crates.io alongside this release (installed with `cargo install`,