AbstractRuntime 0.4.21__tar.gz → 0.4.23__tar.gz

{abstractruntime-0.4.21 → abstractruntime-0.4.23}/CHANGELOG.md

@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.23] - 2026-05-26
+
+### Added
+- Run lifecycle helpers and execution metric surfaces for VisualFlow execution and Gateway run retention workflows.
+- Storage deletion primitives for durable run cleanup across the Runtime storage backends.
+
+### Changed
+- Minimum optional AbstractCore dependency floor is now `abstractcore>=2.13.28` (and matching `multimodal`, `mcp-worker`, and hardware-profile cascade extras), aligning Runtime with the latest Core capability defaults, MLX-Gen catalog, and OmniVoice discovery contracts.
+
+### Fixed
+- Effect invocation tracing now records generated-media and code-node execution details consistently across local and Gateway-hosted runs.
+
+## [0.4.22] - 2026-05-23
+
+### Changed
+- Minimum optional AbstractCore dependency floor is now `abstractcore>=2.13.27` (and matching `multimodal`, `mcp-worker`, and hardware-profile cascade extras), aligning Runtime with the latest Core capability plugin floors and server contracts.
+
+### Fixed
+- Remote and VisualFlow music generation now fail closed on legacy `backend` / `music_backend` selectors and require `provider` / `music_provider` as the backend selector, matching AbstractCore Server `/v1/audio/music` validation.
+- VisualFlow `generate_music` lowering now preserves boolean `structure_prompt` values (including explicit `False`) in the pending output selector, keeping the Flow/Gateway/Core contract consistent.
+
 ## [0.4.21] - 2026-05-22
 
 ### Added
@@ -523,7 +544,9 @@ AbstractRuntime is the durable execution substrate designed to pair with Abstrac
 
 Initial development version with basic proof-of-concept features.
 
-[Unreleased]: https://github.com/lpalbou/abstractruntime/compare/v0.4.21...HEAD
+[Unreleased]: https://github.com/lpalbou/abstractruntime/compare/v0.4.23...HEAD
+[0.4.23]: https://github.com/lpalbou/abstractruntime/compare/v0.4.22...v0.4.23
+[0.4.22]: https://github.com/lpalbou/abstractruntime/compare/v0.4.21...v0.4.22
 [0.4.21]: https://github.com/lpalbou/abstractruntime/compare/v0.4.20...v0.4.21
 [0.4.20]: https://github.com/lpalbou/abstractruntime/compare/v0.4.19...v0.4.20
 [0.4.19]: https://github.com/lpalbou/abstractruntime/compare/v0.4.18...v0.4.19

{abstractruntime-0.4.21 → abstractruntime-0.4.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: AbstractRuntime
-Version: 0.4.21
+Version: 0.4.23
 Summary: AbstractRuntime: a durable graph runner designed to pair with AbstractCore.
 Project-URL: AbstractCore (website), https://www.abstractcore.ai/
 Project-URL: AbstractRuntime (GitHub), https://github.com/lpalbou/abstractruntime
@@ -23,24 +23,24 @@ Requires-Python: >=3.10
 Requires-Dist: abstractmemory>=0.2.6
 Requires-Dist: abstractsemantics>=0.0.3
 Provides-Extra: abstractcore
-Requires-Dist: abstractcore>=2.13.25; extra == 'abstractcore'
+Requires-Dist: abstractcore>=2.13.28; extra == 'abstractcore'
 Requires-Dist: anyio<5.0.0,>=4.12.1; extra == 'abstractcore'
 Requires-Dist: httpx<1.0.0,>=0.28.1; extra == 'abstractcore'
 Requires-Dist: openai<2.0.0,>=1.109.1; extra == 'abstractcore'
 Provides-Extra: all-apple
-Requires-Dist: abstractcore[all-apple]>=2.13.25; extra == 'all-apple'
+Requires-Dist: abstractcore[all-apple]>=2.13.28; extra == 'all-apple'
 Requires-Dist: anyio<5.0.0,>=4.12.1; extra == 'all-apple'
 Requires-Dist: httpx<1.0.0,>=0.28.1; extra == 'all-apple'
 Requires-Dist: openai<2.0.0,>=1.109.1; extra == 'all-apple'
 Requires-Dist: setuptools<82.0.0,>=80.10.2; extra == 'all-apple'
 Provides-Extra: all-gpu
-Requires-Dist: abstractcore[all-gpu]>=2.13.25; extra == 'all-gpu'
+Requires-Dist: abstractcore[all-gpu]>=2.13.28; extra == 'all-gpu'
 Requires-Dist: anyio<5.0.0,>=4.12.1; extra == 'all-gpu'
 Requires-Dist: httpx<1.0.0,>=0.28.1; extra == 'all-gpu'
 Requires-Dist: openai<2.0.0,>=1.109.1; extra == 'all-gpu'
 Requires-Dist: setuptools<82.0.0,>=80.10.2; extra == 'all-gpu'
 Provides-Extra: apple
-Requires-Dist: abstractcore[apple]>=2.13.25; extra == 'apple'
+Requires-Dist: abstractcore[apple]>=2.13.28; extra == 'apple'
 Requires-Dist: anyio<5.0.0,>=4.12.1; extra == 'apple'
 Requires-Dist: httpx<1.0.0,>=0.28.1; extra == 'apple'
 Requires-Dist: openai<2.0.0,>=1.109.1; extra == 'apple'
@@ -50,18 +50,18 @@ Requires-Dist: mkdocs-material>=9.0.0; extra == 'docs'
 Requires-Dist: mkdocs>=1.6.0; extra == 'docs'
 Requires-Dist: pymdown-extensions>=10.0; extra == 'docs'
 Provides-Extra: gpu
-Requires-Dist: abstractcore[gpu]>=2.13.25; extra == 'gpu'
+Requires-Dist: abstractcore[gpu]>=2.13.28; extra == 'gpu'
 Requires-Dist: anyio<5.0.0,>=4.12.1; extra == 'gpu'
 Requires-Dist: httpx<1.0.0,>=0.28.1; extra == 'gpu'
 Requires-Dist: openai<2.0.0,>=1.109.1; extra == 'gpu'
 Requires-Dist: setuptools<82.0.0,>=80.10.2; extra == 'gpu'
 Provides-Extra: mcp-worker
-Requires-Dist: abstractcore[tools]>=2.13.25; extra == 'mcp-worker'
+Requires-Dist: abstractcore[tools]>=2.13.28; extra == 'mcp-worker'
 Requires-Dist: anyio<5.0.0,>=4.12.1; extra == 'mcp-worker'
 Requires-Dist: httpx<1.0.0,>=0.28.1; extra == 'mcp-worker'
 Requires-Dist: openai<2.0.0,>=1.109.1; extra == 'mcp-worker'
 Provides-Extra: multimodal
-Requires-Dist: abstractcore[audio,music,remote,vision,voice]>=2.13.25; extra == 'multimodal'
+Requires-Dist: abstractcore[audio,music,remote,vision,voice]>=2.13.28; extra == 'multimodal'
 Requires-Dist: anyio<5.0.0,>=4.12.1; extra == 'multimodal'
 Requires-Dist: httpx<1.0.0,>=0.28.1; extra == 'multimodal'
 Requires-Dist: openai<2.0.0,>=1.109.1; extra == 'multimodal'
@@ -81,7 +81,7 @@ Description-Content-Type: text/markdown
 
 It is designed for long-running workflows that must survive restarts and explicitly model blocking (human input, timers, external events, subworkflows) without keeping Python stacks alive.
 
-**Version:** 0.4.21 • **Python:** 3.10+
+**Version:** 0.4.23 • **Python:** 3.10+
 
 **Status:** pre-1.0 (API may evolve). For production use, pin versions and follow `CHANGELOG.md`.
 
@@ -115,7 +115,7 @@ AbstractCore integration (LLM + tools):
 pip install "abstractruntime[abstractcore]"
 ```
 
-The `abstractcore` extra installs AbstractCore 2.13.25 or newer so the hardened server auth model, provider-key header routing, generated-media contracts, capability catalog, prompt-cache control plane, durable bloc prompt-cache helpers, bindings, lifecycle operations, public output-selector contract, async/sync text-generation output-selector parity, task-aware model residency for text/image/TTS/STT, the public local vision-cache catalog helper used by Runtime discovery, and the lightweight `abstractmusic>=0.1.8` ACE-remote path used by Runtime music generation are available. Use `abstractruntime[multimodal]` when you need common media, vision, voice, audio, or music dependencies.
+The `abstractcore` extra installs AbstractCore 2.13.28 or newer so the hardened server auth model, provider-key header routing, generated-media contracts, capability catalog, prompt-cache control plane, durable bloc prompt-cache helpers, bindings, lifecycle operations, public output-selector contract, async/sync text-generation output-selector parity, task-aware model residency for text/image/TTS/STT, and the public local vision-cache catalog helper used by Runtime discovery remain aligned. Use `abstractruntime[multimodal]` when you need common media dependencies and capability plugins (installs `abstractcore[remote,vision,voice,audio,music]>=2.13.28`, including `abstractmusic>=0.1.12`).
 
 Hardware profile cascades are available for native Python installs:
 `abstractruntime[apple]`, `abstractruntime[gpu]`, `abstractruntime[all-apple]`,
@@ -169,7 +169,7 @@ state = rt.resume(
 assert state.status.value == "completed"
 ```
 
-## What’s included (v0.4.21)
+## What’s included (v0.4.23)
 
 Kernel (dependency-light):
 - workflow graphs: `WorkflowSpec` (`src/abstractruntime/core/spec.py`)

{abstractruntime-0.4.21 → abstractruntime-0.4.23}/README.md

@@ -4,7 +4,7 @@
 
 It is designed for long-running workflows that must survive restarts and explicitly model blocking (human input, timers, external events, subworkflows) without keeping Python stacks alive.
 
-**Version:** 0.4.21 • **Python:** 3.10+
+**Version:** 0.4.23 • **Python:** 3.10+
 
 **Status:** pre-1.0 (API may evolve). For production use, pin versions and follow `CHANGELOG.md`.
 
@@ -38,7 +38,7 @@ AbstractCore integration (LLM + tools):
 pip install "abstractruntime[abstractcore]"
 ```
 
-The `abstractcore` extra installs AbstractCore 2.13.25 or newer so the hardened server auth model, provider-key header routing, generated-media contracts, capability catalog, prompt-cache control plane, durable bloc prompt-cache helpers, bindings, lifecycle operations, public output-selector contract, async/sync text-generation output-selector parity, task-aware model residency for text/image/TTS/STT, the public local vision-cache catalog helper used by Runtime discovery, and the lightweight `abstractmusic>=0.1.8` ACE-remote path used by Runtime music generation are available. Use `abstractruntime[multimodal]` when you need common media, vision, voice, audio, or music dependencies.
+The `abstractcore` extra installs AbstractCore 2.13.28 or newer so the hardened server auth model, provider-key header routing, generated-media contracts, capability catalog, prompt-cache control plane, durable bloc prompt-cache helpers, bindings, lifecycle operations, public output-selector contract, async/sync text-generation output-selector parity, task-aware model residency for text/image/TTS/STT, and the public local vision-cache catalog helper used by Runtime discovery remain aligned. Use `abstractruntime[multimodal]` when you need common media dependencies and capability plugins (installs `abstractcore[remote,vision,voice,audio,music]>=2.13.28`, including `abstractmusic>=0.1.12`).
 
 Hardware profile cascades are available for native Python installs:
 `abstractruntime[apple]`, `abstractruntime[gpu]`, `abstractruntime[all-apple]`,
@@ -92,7 +92,7 @@ state = rt.resume(
 assert state.status.value == "completed"
 ```
 
-## What’s included (v0.4.21)
+## What’s included (v0.4.23)
 
 Kernel (dependency-light):
 - workflow graphs: `WorkflowSpec` (`src/abstractruntime/core/spec.py`)

{abstractruntime-0.4.21 → abstractruntime-0.4.23}/docs/api.md

@@ -180,7 +180,7 @@ This produces a portable record of a run’s state + ledger + artifacts suitable
 
 ### AbstractCore (LLM + tools)
 
-Requires: `pip install "abstractruntime[abstractcore]"` (AbstractCore 2.13.25 or newer).
+Requires: `pip install "abstractruntime[abstractcore]"` (AbstractCore 2.13.28 or newer).
 
 Implementation: `src/abstractruntime/integrations/abstractcore/*`.
 

{abstractruntime-0.4.21 → abstractruntime-0.4.23}/docs/architecture.md

@@ -1,7 +1,7 @@
 # AbstractRuntime — Architecture
 
-> Updated: 2026-05-22
-> Version: 0.4.21
+> Updated: 2026-05-23
+> Version: 0.4.23
 > Scope: this describes **what is implemented in this repository**.
 
 AbstractRuntime is a **durable workflow runtime**: it executes workflow graphs as a persisted state machine with explicit waits (user, time, events, jobs, subworkflows). A run can pause for hours/days and resume **without** keeping Python stacks/coroutines alive.

{abstractruntime-0.4.21 → abstractruntime-0.4.23}/docs/backlog/README.md

@@ -14,7 +14,7 @@ If you are new to the project, start with `../README.md` and `../architecture.md
 
 - Planned: 5
 - Proposed: 3
-- Completed: 28
+- Completed: 30
 - Deprecated: 13
 - Recurrent: 0
 
@@ -68,6 +68,8 @@ If you are new to the project, start with `../README.md` and `../architecture.md
 | 0033 | `completed/0033_runtime_host_local_prompt_cache_export_import_surface.md` |
 | 0035 | `completed/0035_model_residency_provider_truth_for_local_http_clients.md` |
 | 0037 | `completed/0037_visualflow_generate_music_node_compiler_parity.md` |
+| 0039 | `completed/0039_runtime_music_structure_prompt_bool_contract.md` |
+| 0040 | `completed/0040_task_agnostic_local_residency_listing.md` |
 
 ## Planned
 

{abstractruntime-0.4.21 → abstractruntime-0.4.23}/docs/backlog/completed/0037_visualflow_generate_music_node_compiler_parity.md

@@ -25,7 +25,7 @@ AbstractFlow now ships a `generate_music` authoring node. Runtime must recognize
 ## What shipped
 - Added first-class VisualFlow lowering support for `nodeType="generate_music"` in Runtime:
   - compiles into an `EffectType.LLM_CALL` pending effect with output selector `{modality: "music", task: "music_generation"}`
-  - accepts `prompt`, `music_provider`, `music_model`, `music_backend`, `lyrics`, `duration_s`, `format`, `seed`, `num_inference_steps`, `guidance_scale`, `instrumental`, `enhance_prompt`, `auto_lyrics`, `structure_prompt`, `text_planner_mode`, and `extra` from pins or `effectConfig`
+  - accepts `prompt`, `music_provider`, `music_model`, `lyrics`, `duration_s`, `format`, `seed`, `num_inference_steps`, `guidance_scale`, `instrumental`, `enhance_prompt`, `auto_lyrics`, `structure_prompt`, `text_planner_mode`, and `extra` from pins or `effectConfig` (`music_backend` is a legacy alias and is rejected; use `music_provider`)
   - keeps runtime LLM `provider`/`model` separate from music provider/model selectors (no legacy fallback)
 - Extended VisualFlow compiler routing so `generate_music` is treated as an LLM-call-backed effect node (like `generate_image` / `generate_voice` / `transcribe_audio`).
 - Extended VisualFlow effect-result mapping so completed `generate_music` nodes populate:

abstractruntime-0.4.23/docs/backlog/completed/0039_runtime_music_structure_prompt_bool_contract.md

@@ -0,0 +1,43 @@
+# Completed: Runtime Music `structure_prompt` Boolean Contract Alignment
+
+## Metadata
+- Created: 2026-05-22
+- Completed: 2026-05-22
+- Status: Completed
+- Origin: moved from `docs/backlog/proposed/0039_runtime_music_structure_prompt_bool_contract.md`
+
+## Problem
+
+Gateway `MusicGenerateRequest` exposes `structure_prompt` as `Optional[bool]`.
+AbstractFlow mirrors that boolean contract in its Generate Music node.
+
+Runtime's native `generate_music` VisualFlow handler forwarded
+`structure_prompt` only through the string-field path. Boolean values authored
+by Flow were therefore dropped before the Gateway/Core music call.
+
+## Implementation
+
+- Moved `structure_prompt` from the music string option group to the boolean
+  option group in the native `generate_music` VisualFlow handler.
+- Preserved explicit `False` values so callers can distinguish "disabled" from
+  "not specified".
+- Added compiler coverage proving:
+  - `structure_prompt=True` is forwarded as a boolean in the pending music
+    output selector.
+  - `structure_prompt=False` from node input pins is preserved as an explicit
+    boolean override.
+
+## Outcome
+
+Runtime now keeps the same boolean contract used by AbstractFlow, Gateway, and
+AbstractCore. A Flow-authored Generate Music node can enable or disable backend
+structured prompt planning without Runtime stringifying or dropping the control.
+
+## Validation
+
+- `PYTHONPATH=src python -m pytest -q tests/test_visualflow_media_nodes.py`
+
+## Related Flow work
+
+AbstractFlow completed Gateway `0.2.17` native media alignment in
+`abstractflow/docs/backlog/completed/0072_gateway_0_2_17_native_media_contract_alignment.md`.

abstractruntime-0.4.23/docs/backlog/completed/0040_task_agnostic_local_residency_listing.md

@@ -0,0 +1,53 @@
+# 0040 Task-Agnostic Local Residency Listing
+
+## Metadata
+- Created: 2026-05-24
+- Status: Completed
+- Completed: 2026-05-24
+- Origin: direct bug fix from AbstractFlow model residency UI investigation
+
+## Goal
+
+Make Runtime's local model-residency list operation match the Gateway/Core
+control-plane contract: omitting `task` lists resident models across tasks,
+while an explicit `task` remains a filter.
+
+## What Shipped
+
+- Local and MultiLocal Runtime residency listing now treat an omitted task as
+  task-agnostic instead of silently defaulting to `text_generation`.
+- Local capability-backed residency rows are normalized with verified
+  `provider_resident` / `provider_residency_verified` fields when the
+  capability plugin reports `loaded` or `resident`.
+- AbstractFlow's loaded-model table now honors the canonical `loaded` /
+  `resident` state used by Core capability records, while still respecting
+  explicit negative provider-residency fields.
+- Regression tests cover local and MultiLocal TTS rows appearing in an
+  unfiltered residency list after a capability-backed load.
+
+## Current Code Pointers
+
+- `src/abstractruntime/integrations/abstractcore/llm_client.py`
+- `tests/test_model_residency_control_plane.py`
+- AbstractFlow `web/frontend/src/components/ModelResidencyPanel.tsx`
+
+## Validation
+
+Focused validation run on 2026-05-24:
+
+- `python -m py_compile abstractruntime/src/abstractruntime/integrations/abstractcore/llm_client.py`
+- `PYTHONPATH=abstractruntime/src pytest -q abstractruntime/tests/test_model_residency_control_plane.py -q`
+- `npm run build` from `abstractflow/web/frontend`
+- `git diff --check` for the touched Runtime and Flow files
+
+## Completion Report
+
+### Summary
+
+The Omnivoice warmup path was already returning a true resident runtime. The
+row disappeared because local Runtime listing with no task returned only text
+rows, and Flow then hid capability rows that used `loaded=true` /
+`state=resident` instead of text-provider-specific `provider_loaded`.
+
+The fix is at the control-plane normalization boundary, not an Omnivoice
+special case.

{abstractruntime-0.4.21 → abstractruntime-0.4.23}/docs/backlog/planned/025_runtime_retention_and_purge_contract.md

@@ -1,6 +1,6 @@
 ## 025_runtime_retention_and_purge_contract (planned)
 
-**Status**: Planned
+**Status**: Partially implemented
 **Priority**: Medium
 **Depends on**: 009_artifact_store (completed), 011_subworkflow_support (completed), 012_run_store_query_and_scheduler_support (completed), 024_runtime_owned_run_scoped_media_execution (completed)
 **Related ADRs**: 0003_provenance_tamper_evident_hash_chain, 0004_runtime_owns_run_scoped_media_execution_truth
@@ -15,12 +15,18 @@ Define capability-detected runtime purge mechanics for explicitly ephemeral run
 
 ## Current code reality
 
-- `RunStore` still exposes only `save()` / `load()`.
+- `RunStore` still exposes only `save()` / `load()` as its mandatory base interface.
 - `QueryableRunStore` already exposes `list_runs()`, `list_due_wait_until()`, and `list_children()`.
 - `QueryableRunIndexStore` already exposes `list_run_index(...)`, including `session_id` and `root_only`, so hosts can already hide child runs from top-level listings without inventing purge semantics first.
-- `LedgerStore` is still append-only with `append()` / `list()`.
+- `LedgerStore` is still append-only as its mandatory base interface with `append()` / `list()`.
+- Optional deletion protocols now exist for host-owned cleanup paths:
+  - `DeletableRunStore.delete(run_id)`
+  - `DeletableLedgerStore.delete(run_id)`
+  - `DeletableCommandStore.delete_by_run(run_id)`
+- In-memory, JSON-file/JSONL, SQLite, and storage wrapper implementations now support those deletion protocols where applicable.
 - `ArtifactStore` already supports `delete()` and `delete_by_run()`.
 - Runtime already has private tree-walk precedents via `history_bundle._list_descendant_run_ids(...)` and scheduler child-run traversal, but no public host-facing purge helper.
+- Gateway now uses these optional deletion capabilities in `abstractgateway.run_retention` to purge expired ephemeral draft-test run trees. Runtime still does not own the Gateway/Flow draft taxonomy.
 - Runtime-owned child runs now include both classic subworkflows and media child runs, so cleanup is no longer only a Flow/Gateway concern.
 - Provenance hash chains are implemented, which makes purge/archive semantics an explicit audit decision, not just a storage API detail.
 
@@ -101,7 +107,7 @@ Document the consequences clearly:
 ## Acceptance criteria
 
 - [ ] Runtime documents a minimal retention metadata contract centered on `retention_class` and optional `expires_at`.
-- [ ] Optional delete capabilities are defined without widening every storage base class.
+- [x] Optional delete capabilities are defined without widening every storage base class.
 - [ ] A host-facing purge helper can dry-run and execute run-tree cleanup when the configured stores support it.
 - [ ] The helper refuses active runs by default and refuses durable runs unless explicitly forced.
 - [ ] The helper reports descendant runs, deleted checkpoints, deleted ledgers, deleted artifacts, unsupported capabilities, and GC caveats in a structured result.
@@ -139,3 +145,21 @@ No new ADR is required yet. If this item graduates into an accepted retention ta
 ## Priority note
 
 This matters more now that Runtime owns more child-run patterns, but it is still a medium-priority mechanics item, not the highest-priority runtime correctness gap.
+
+---
+
+## 2026-05-25 implementation note
+
+The AbstractFlow draft/published lifecycle slice added the storage-level deletion mechanics needed
+by Gateway-owned draft-test purge:
+
+- `abstractruntime.storage.base.DeletableRunStore`
+- `abstractruntime.storage.base.DeletableLedgerStore`
+- `abstractruntime.storage.commands.DeletableCommandStore`
+- concrete deletion support for memory, JSON/JSONL, SQLite, offloading, observable, and hash-chain
+  store wrappers
+- focused coverage in `tests/test_storage_deletion.py`
+
+The broader Runtime-owned host-facing purge helper remains open. Gateway currently owns the only
+concrete purge policy because `purpose: draft_test` and `retention.mode: ephemeral` are Gateway/Flow
+control-plane semantics, not Runtime taxonomy.

{abstractruntime-0.4.21 → abstractruntime-0.4.23}/docs/getting-started.md

@@ -18,7 +18,7 @@ Optional (LLM + tools via AbstractCore):
 pip install "abstractruntime[abstractcore]"
 ```
 
-This installs AbstractCore 2.13.25 or newer, which matches the documented server auth, provider-key header routing, generated-media contracts, capability catalog, prompt-cache control plane, durable bloc prompt-cache helpers, bindings and lifecycle operations, task-aware model residency for text/image/TTS/STT, current tool behavior, public output-selector contract, async/sync text-generation output-selector parity, the public local vision-cache catalog helper used by Runtime discovery, and the lightweight `abstractmusic>=0.1.8` ACE-remote path used by Runtime music generation. Use `abstractruntime[multimodal]` when your workflows need common media, vision, voice, audio, or music dependencies.
+This installs AbstractCore 2.13.28 or newer, which matches the documented server auth, provider-key header routing, generated-media contracts, capability catalog, prompt-cache control plane, durable bloc prompt-cache helpers, bindings and lifecycle operations, task-aware model residency for text/image/TTS/STT, current tool behavior, public output-selector contract, async/sync text-generation output-selector parity, and the public local vision-cache catalog helper used by Runtime discovery. Use `abstractruntime[multimodal]` when your workflows need common media dependencies and capability plugins (installs `abstractcore[remote,vision,voice,audio,music]>=2.13.28`, including `abstractmusic>=0.1.12`).
 
 ## Mental model (source of truth)
 

{abstractruntime-0.4.21 → abstractruntime-0.4.23}/docs/integrations/abstractcore.md

@@ -16,7 +16,7 @@ Implementation pointers (this repo):
 pip install "abstractruntime[abstractcore]"
 ```
 
-This extra installs AbstractCore 2.13.25 or newer. That is the supported baseline for the current server auth split (`Authorization` for server auth, `X-AbstractCore-Provider-API-Key` for provider overrides), generated-media contracts, capability catalog, prompt-cache control-plane endpoints, durable bloc prompt-cache helpers, bindings and lifecycle operations, task-aware model residency for text/image/TTS/STT, current tool catalog, AbstractCore's public output-selector contract, async/sync text-generation output-selector parity, the public local vision-cache catalog helper used by Runtime discovery, and the lightweight `abstractmusic>=0.1.8` remote ACE path surfaced through Runtime music generation.
+This extra installs AbstractCore 2.13.28 or newer. That is the supported baseline for the current server auth split (`Authorization` for server auth, `X-AbstractCore-Provider-API-Key` for provider overrides), generated-media contracts, capability catalog, prompt-cache control-plane endpoints, durable bloc prompt-cache helpers, bindings and lifecycle operations, task-aware model residency for text/image/TTS/STT, current tool catalog, AbstractCore's public output-selector contract, async/sync text-generation output-selector parity, and the public local vision-cache catalog helper used by Runtime discovery.
 
 For AbstractCore's multimodal `generate(..., output=...)` path, use the newer baseline and optional media packages:
 
@@ -24,7 +24,7 @@ For AbstractCore's multimodal `generate(..., output=...)` path, use the newer ba
 pip install "abstractruntime[multimodal]"
 ```
 
-This installs `abstractcore[remote,vision,voice,audio,music]>=2.13.25`. Local image/voice/music generation still depends on the configured AbstractCore capability backends (for example AbstractVision, AbstractVoice, and AbstractMusic, or OpenAI/OpenAI-compatible remote engines). With `abstractmusic>=0.1.8`, the base music extra includes the lightweight remote ACE Music backend without local model-runtime extras.
+This installs `abstractcore[remote,vision,voice,audio,music]>=2.13.28`. Local image/voice/music generation still depends on the configured AbstractCore capability backends (for example AbstractVision, AbstractVoice, and AbstractMusic, or OpenAI/OpenAI-compatible remote engines). With `abstractmusic>=0.1.12`, the base music extra includes the lightweight remote ACE Music backend without local model-runtime extras.
 
 The MCP worker entrypoint uses the `mcp-worker` extra:
 
@@ -687,7 +687,7 @@ facade = get_abstractcore_run_facade(rt)
 child = facade.generate_image(
     "existing-parent-run-id",
     prompt="A red mug on a white table.",
-    output={"provider": "mflux", "model": "flux-dev", "format": "png"},
+    output={"provider": "mlx-gen", "model": "flux2-klein-4b", "format": "png"},
 )
 
 assert child.status.value == "completed"

{abstractruntime-0.4.21 → abstractruntime-0.4.23}/docs/troubleshooting.md

@@ -21,7 +21,7 @@ Fix:
   - `abstractruntime[abstractcore]` for LLM/tools integration.
   - `abstractruntime[multimodal]` for common image, voice, audio, and music dependencies.
   - `abstractruntime[mcp-worker]` for the MCP worker entry point.
-- The current AbstractCore integration expects `abstractcore>=2.13.25`.
+- The current AbstractCore integration expects `abstractcore>=2.13.28`.
 
 Verify:
 

{abstractruntime-0.4.21 → abstractruntime-0.4.23}/llms-full.txt

@@ -10,11 +10,11 @@ This file is an **agent-oriented build guide** for the AbstractRuntime *library*
 
 Quick facts:
 - Python: 3.10+ (`pyproject.toml`)
-- Version: 0.4.21
+- Version: 0.4.23
 - Ecosystem: [AbstractFramework](https://github.com/lpalbou/AbstractFramework) umbrella; pairs with [AbstractCore](https://github.com/lpalbou/abstractcore)
 - Public export surface (source of truth): `src/abstractruntime/__init__.py`
-- Optional AbstractCore baseline: `abstractruntime[abstractcore]` installs `abstractcore>=2.13.25`
-- Multimodal extra: `abstractruntime[multimodal]` installs `abstractcore[remote,vision,voice,audio,music]>=2.13.25`
+- Optional AbstractCore baseline: `abstractruntime[abstractcore]` installs `abstractcore>=2.13.28`
+- Multimodal extra: `abstractruntime[multimodal]` installs `abstractcore[remote,vision,voice,audio,music]>=2.13.28`
 - Config boundary: Runtime does not read `ABSTRACTGATEWAY_*`; Gateway-owned env/config should be translated into explicit Runtime inputs or Runtime-owned env names.
 
 ```mermaid

{abstractruntime-0.4.21 → abstractruntime-0.4.23}/llms.txt

@@ -3,11 +3,11 @@
 > Durable workflow runtime (interrupt → checkpoint → resume) with an append-only execution ledger.
 
 - Python: 3.10+ (see `pyproject.toml`)
-- Version: 0.4.21
+- Version: 0.4.23
 - Ecosystem: [AbstractFramework](https://github.com/lpalbou/AbstractFramework) umbrella, integrates with [AbstractCore](https://github.com/lpalbou/abstractcore)
 - Hard invariant: `RunState.vars` must be JSON-serializable (`src/abstractruntime/core/models.py`)
-- Current AbstractCore baseline: `abstractruntime[abstractcore]` installs `abstractcore>=2.13.25`
-- Multimodal extra: `abstractruntime[multimodal]` installs `abstractcore[remote,vision,voice,audio,music]>=2.13.25`
+- Current AbstractCore baseline: `abstractruntime[abstractcore]` installs `abstractcore>=2.13.28`
+- Multimodal extra: `abstractruntime[multimodal]` installs `abstractcore[remote,vision,voice,audio,music]>=2.13.28`
 - Config boundary: Runtime does not read `ABSTRACTGATEWAY_*`; Gateway-owned config should be translated into explicit Runtime inputs or Runtime-owned env names.
 
 ## Start here

{abstractruntime-0.4.21 → abstractruntime-0.4.23}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "AbstractRuntime"
-version = "0.4.21"
+version = "0.4.23"
 description = "AbstractRuntime: a durable graph runner designed to pair with AbstractCore."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -46,14 +46,14 @@ dependencies = [
 [project.optional-dependencies]
 # Enables `abstractruntime.integrations.abstractcore.*` imports.
 abstractcore = [
-  "abstractcore>=2.13.25",
+  "abstractcore>=2.13.28",
   "openai<2.0.0,>=1.109.1",
   "httpx<1.0.0,>=0.28.1",
   "anyio<5.0.0,>=4.12.1",
 ]
 
 apple = [
-  "abstractcore[apple]>=2.13.25",
+  "abstractcore[apple]>=2.13.28",
   "openai<2.0.0,>=1.109.1",
   "httpx<1.0.0,>=0.28.1",
   "anyio<5.0.0,>=4.12.1",
@@ -61,7 +61,7 @@ apple = [
 ]
 
 gpu = [
-  "abstractcore[gpu]>=2.13.25",
+  "abstractcore[gpu]>=2.13.28",
   "openai<2.0.0,>=1.109.1",
   "httpx<1.0.0,>=0.28.1",
   "anyio<5.0.0,>=4.12.1",
@@ -69,7 +69,7 @@ gpu = [
 ]
 
 all-apple = [
-  "abstractcore[all-apple]>=2.13.25",
+  "abstractcore[all-apple]>=2.13.28",
   "openai<2.0.0,>=1.109.1",
   "httpx<1.0.0,>=0.28.1",
   "anyio<5.0.0,>=4.12.1",
@@ -77,7 +77,7 @@ all-apple = [
 ]
 
 all-gpu = [
-  "abstractcore[all-gpu]>=2.13.25",
+  "abstractcore[all-gpu]>=2.13.28",
   "openai<2.0.0,>=1.109.1",
   "httpx<1.0.0,>=0.28.1",
   "anyio<5.0.0,>=4.12.1",
@@ -87,7 +87,7 @@ all-gpu = [
 # Enables AbstractCore multimodal generation helpers with common image/voice/
 # audio/music capability packages.
 multimodal = [
-  "abstractcore[remote,vision,voice,audio,music]>=2.13.25",
+  "abstractcore[remote,vision,voice,audio,music]>=2.13.28",
   "openai<2.0.0,>=1.109.1",
   "httpx<1.0.0,>=0.28.1",
   "anyio<5.0.0,>=4.12.1",
@@ -101,7 +101,7 @@ multimodal = [
 
 # Enables `abstractruntime-mcp-worker` with the default toolsets (includes bs4/lxml).
 mcp-worker = [
-  "abstractcore[tools]>=2.13.25",
+  "abstractcore[tools]>=2.13.28",
   "openai<2.0.0,>=1.109.1",
   "httpx<1.0.0,>=0.28.1",
   "anyio<5.0.0,>=4.12.1",
@@ -131,3 +131,6 @@ abstractruntime-mcp-worker = "abstractruntime.integrations.abstractcore.mcp_work
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/abstractruntime"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]

abstractruntime-0.4.23/release-notes.md

@@ -0,0 +1,9 @@
+### Added
+- Run lifecycle helpers and execution metric surfaces for VisualFlow execution and Gateway run retention workflows.
+- Storage deletion primitives for durable run cleanup across the Runtime storage backends.
+
+### Changed
+- Minimum optional AbstractCore dependency floor is now `abstractcore>=2.13.28` (and matching `multimodal`, `mcp-worker`, and hardware-profile cascade extras), aligning Runtime with the latest Core capability defaults, MLX-Gen catalog, and OmniVoice discovery contracts.
+
+### Fixed
+- Effect invocation tracing now records generated-media and code-node execution details consistently across local and Gateway-hosted runs.

{abstractruntime-0.4.21 → abstractruntime-0.4.23}/src/abstractruntime/__init__.py

@@ -29,7 +29,7 @@ from .core.policy import (
     NoRetryPolicy,
     compute_idempotency_key,
 )
-from .storage.base import QueryableRunStore
+from .storage.base import DeletableLedgerStore, DeletableRunStore, QueryableRunStore
 from .storage.in_memory import InMemoryLedgerStore, InMemoryRunStore
 from .storage.json_files import JsonFileRunStore, JsonlLedgerStore
 from .storage.sqlite import (
@@ -44,6 +44,7 @@ from .storage.commands import (
     CommandCursorStore,
     CommandRecord,
     CommandStore,
+    DeletableCommandStore,
     InMemoryCommandCursorStore,
     InMemoryCommandStore,
     JsonFileCommandCursorStore,
@@ -117,6 +118,8 @@ __all__ = [
     "create_scheduled_runtime",
     # Storage backends
     "QueryableRunStore",
+    "DeletableRunStore",
+    "DeletableLedgerStore",
     "InMemoryRunStore",
     "InMemoryLedgerStore",
     "JsonFileRunStore",
@@ -127,6 +130,7 @@ __all__ = [
     "CommandRecord",
     "CommandAppendResult",
     "CommandStore",
+    "DeletableCommandStore",
     "CommandCursorStore",
     "InMemoryCommandStore",
     "JsonlCommandStore",