AbstractRuntime 0.4.21__tar.gz → 0.4.22__tar.gz

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

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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 +532,8 @@ 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.22...HEAD
+[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.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: AbstractRuntime
-Version: 0.4.21
+Version: 0.4.22
 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.27; 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.27; 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.27; 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.27; 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.27; 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.27; 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.27; 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.22 • **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.27 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.27`, 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.22)
 
 Kernel (dependency-light):
 - workflow graphs: `WorkflowSpec` (`src/abstractruntime/core/spec.py`)

{abstractruntime-0.4.21 → abstractruntime-0.4.22}/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.22 • **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.27 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.27`, 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.22)
 
 Kernel (dependency-light):
 - workflow graphs: `WorkflowSpec` (`src/abstractruntime/core/spec.py`)

{abstractruntime-0.4.21 → abstractruntime-0.4.22}/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.27 or newer).
 
 Implementation: `src/abstractruntime/integrations/abstractcore/*`.
 

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

@@ -1,7 +1,7 @@
 # AbstractRuntime — Architecture
 
-> Updated: 2026-05-22
-> Version: 0.4.21
+> Updated: 2026-05-23
+> Version: 0.4.22
 > 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.22}/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: 29
 - Deprecated: 13
 - Recurrent: 0
 
@@ -68,6 +68,7 @@ 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` |
 
 ## Planned
 

{abstractruntime-0.4.21 → abstractruntime-0.4.22}/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.22/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.21 → abstractruntime-0.4.22}/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.27 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.27`, including `abstractmusic>=0.1.12`).
 
 ## Mental model (source of truth)
 

{abstractruntime-0.4.21 → abstractruntime-0.4.22}/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.27 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.27`. 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:
 

{abstractruntime-0.4.21 → abstractruntime-0.4.22}/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.27`.
 
 Verify:
 

{abstractruntime-0.4.21 → abstractruntime-0.4.22}/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.22
 - 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.27`
+- Multimodal extra: `abstractruntime[multimodal]` installs `abstractcore[remote,vision,voice,audio,music]>=2.13.27`
 - 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.22}/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.22
 - 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.27`
+- Multimodal extra: `abstractruntime[multimodal]` installs `abstractcore[remote,vision,voice,audio,music]>=2.13.27`
 - 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.22}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "AbstractRuntime"
-version = "0.4.21"
+version = "0.4.22"
 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.27",
   "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.27",
   "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.27",
   "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.27",
   "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.27",
   "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.27",
   "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.27",
   "openai<2.0.0,>=1.109.1",
   "httpx<1.0.0,>=0.28.1",
   "anyio<5.0.0,>=4.12.1",

abstractruntime-0.4.22/release-notes.md

@@ -0,0 +1,6 @@
+### 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.

{abstractruntime-0.4.21 → abstractruntime-0.4.22}/src/abstractruntime/integrations/abstractcore/llm_client.py

@@ -7692,12 +7692,17 @@ class RemoteAbstractCoreLLMClient:
         params: Dict[str, Any],
     ) -> Dict[str, Any]:
         fmt = str(spec.get("format") or spec.get("response_format") or "wav").strip().lower() or "wav"
+        legacy_backend = str(spec.get("backend") or spec.get("music_backend") or "").strip()
+        if legacy_backend:
+            raise ValueError(
+                "Music output routing uses `provider` as the backend selector; "
+                "`backend` and `music_backend` are not supported."
+            )
         body: Dict[str, Any] = {
             "prompt": str(prompt or ""),
             "task": str(spec.get("task") or "music_generation"),
             "format": fmt,
         }
-        route_selector = str(spec.get("backend") or spec.get("music_backend") or "").strip().lower().replace("_", "-")
         for key, value in spec.items():
             if key in {
                 "modality",
@@ -7722,15 +7727,10 @@ class RemoteAbstractCoreLLMClient:
         if isinstance(base_url, str) and base_url.strip():
             body["base_url"] = base_url.strip()
 
-        if route_selector:
-            url = _join_core_provider_v1_url(self._server_base_url, route_selector, "/audio/music")
-        else:
-            url = _join_core_v1_url(self._server_base_url, "/audio/music")
+        url = _join_core_v1_url(self._server_base_url, "/audio/music")
         audio_bytes, resp_headers = self._post_bytes(url, headers=headers, json_body=body)
         content_type = str(resp_headers.get("content-type") or f"audio/{fmt}").split(";", 1)[0].strip() or f"audio/{fmt}"
-        media_provider = (
-            str(body.get("provider") or route_selector or "abstractcore-server").strip() or "abstractcore-server"
-        )
+        media_provider = str(body.get("provider") or "abstractcore-server").strip() or "abstractcore-server"
         run_id, tags = self._trace_run_id_and_tags(
             params,
             task="music_generation",

{abstractruntime-0.4.21 → abstractruntime-0.4.22}/src/abstractruntime/integrations/abstractcore/output_specs.py

@@ -4,8 +4,8 @@ from __future__ import annotations
 
 from typing import Any, Dict, List, Optional
 
-_MIN_ABSTRACTCORE_VERSION = (2, 13, 25)
-_MIN_ABSTRACTCORE_VERSION_TEXT = "2.13.25"
+_MIN_ABSTRACTCORE_VERSION = (2, 13, 27)
+_MIN_ABSTRACTCORE_VERSION_TEXT = "2.13.27"
 
 
 def _version_tuple(value: str) -> tuple[int, int, int]:

{abstractruntime-0.4.21 → abstractruntime-0.4.22}/src/abstractruntime/integrations/abstractcore/run_facade.py

@@ -76,6 +76,17 @@ def _workflow_id_for_output(output: Any) -> str:
     return f"{_WORKFLOW_PREFIX}_{safe}"
 
 
+def _validate_music_output_spec(output: Any) -> None:
+    if not isinstance(output, dict):
+        return
+    legacy_backend = str(output.get("backend") or output.get("music_backend") or "").strip()
+    if legacy_backend:
+        raise ValueError(
+            "Music output uses `provider` as the backend selector; "
+            "`backend` and `music_backend` are not supported."
+        )
+
+
 def _workflow_id_for_tool_calls(tool_calls: list[Dict[str, Any]]) -> str:
     suffix = "tool_calls"
     if isinstance(tool_calls, list) and tool_calls:
@@ -410,6 +421,7 @@ class AbstractCoreRunFacade:
 
         spec = {"modality": "music", "task": "music_generation"}
         if isinstance(output, dict):
+            _validate_music_output_spec(output)
             spec.update(copy.deepcopy(output))
         return self.execute_llm_call(
             run_id,

{abstractruntime-0.4.21 → abstractruntime-0.4.22}/src/abstractruntime/visualflow_compiler/visual/executor.py

@@ -1823,7 +1823,6 @@ def visual_to_flow(visual: VisualFlow) -> Flow:
 
             for key in (
                 "lyrics",
-                "structure_prompt",
                 "text_planner_mode",
                 "vocal_language",
                 "negative_prompt",
@@ -1858,7 +1857,7 @@ def visual_to_flow(visual: VisualFlow) -> Flow:
             if guidance is not None:
                 output_spec["guidance_scale"] = guidance
 
-            for key in ("instrumental", "enhance_prompt", "auto_lyrics", "planning"):
+            for key in ("instrumental", "enhance_prompt", "structure_prompt", "auto_lyrics", "planning"):
                 raw_value = _input_or_config(payload, config, key, default=None)
                 if raw_value is not None:
                     output_spec[key] = _coerce_bool(raw_value)
@@ -1869,15 +1868,18 @@ def visual_to_flow(visual: VisualFlow) -> Flow:
             music_model = _nonempty_str(
                 _input_or_config(payload, config, "music_model", "musicModel", "model_music")
             )
-            music_backend = _nonempty_str(
+            legacy_music_backend = _nonempty_str(
                 _input_or_config(payload, config, "music_backend", "musicBackend", "backend_music")
             )
             if music_provider:
                 output_spec["provider"] = music_provider
             if music_model:
                 output_spec["model"] = music_model
-            if music_backend:
-                output_spec["backend"] = music_backend
+            if legacy_music_backend:
+                raise ValueError(
+                    "generate_music uses `music_provider` as the backend selector; "
+                    "`music_backend` is not supported."
+                )
 
             extra = _input_or_config(payload, config, "extra")
             if isinstance(extra, dict) and extra:

{abstractruntime-0.4.21 → abstractruntime-0.4.22}/tests/test_abstractcore_run_facade.py

@@ -285,7 +285,7 @@ def test_run_facade_generate_music_creates_durable_child_run_with_artifact_backe
     parent_run_id = runtime.start(
         workflow=parent,
         session_id="sess-music",
-        vars={"_runtime": {"music_backend": "acemusic"}},
+        vars={"_runtime": {"prompt_cache": {"enabled": True}}},
     )
     runtime.tick(workflow=parent, run_id=parent_run_id)
 
@@ -317,6 +317,23 @@ def test_run_facade_generate_music_creates_durable_child_run_with_artifact_backe
     assert artifact.metadata.tags["kind"] == "generated_media"
 
 
+def test_run_facade_generate_music_rejects_legacy_backend_fields() -> None:
+    class _StubRuntime:
+        def start(self, **kwargs):
+            raise AssertionError("legacy music backend fields should be rejected before runtime start")
+
+        def tick(self, **kwargs):
+            raise AssertionError("legacy music backend fields should be rejected before runtime tick")
+
+        def get_state(self, run_id: str):
+            raise AssertionError(f"unexpected get_state({run_id})")
+
+    facade = AbstractCoreRunFacade(_StubRuntime())
+
+    with pytest.raises(ValueError, match="provider.*backend selector"):
+        facade.generate_music("run-1", prompt="Warm lo-fi piano.", output={"backend": "acemusic"})
+
+
 def test_run_facade_send_telegram_message_creates_durable_child_tool_run() -> None:
     seen: Dict[str, Any] = {}
 

{abstractruntime-0.4.21 → abstractruntime-0.4.22}/tests/test_multimodal_abstractcore_integration.py

@@ -737,6 +737,25 @@ def test_remote_music_output_uses_music_endpoint_and_stores_artifact() -> None:
     assert out["media_model"] == "ace-step"
 
 
+def test_remote_music_output_rejects_legacy_backend_fields() -> None:
+    store = InMemoryArtifactStore()
+    sender = _RemoteMusicSender()
+    client = RemoteAbstractCoreLLMClient(
+        server_base_url="http://core.test",
+        model="openai/gpt-4o-mini",
+        request_sender=sender,
+        artifact_store=store,
+    )
+
+    with pytest.raises(ValueError, match="provider.*backend selector"):
+        client.generate(
+            prompt="Warm lo-fi piano with brushed drums.",
+            params={"output": {"modality": "music", "backend": "acemusic", "format": "wav"}},
+        )
+
+    assert sender.calls == []
+
+
 def test_remote_voice_output_uses_speech_endpoint_and_stores_artifact() -> None:
     store = InMemoryArtifactStore()
     sender = _RemoteTtsSender()

{abstractruntime-0.4.21 → abstractruntime-0.4.22}/tests/test_packaging_extras.py

@@ -49,8 +49,8 @@ def test_runtime_exposes_abstractcore_and_worker_extras_with_gateway_aligned_flo
     assert "[project.optional-dependencies]" in text
     assert "abstractcore = [" in text
     assert "mcp-worker = [" in text
-    assert '"abstractcore>=2.13.25"' in text
-    assert '"abstractcore[remote,vision,voice,audio,music]>=2.13.25"' in text
+    assert '"abstractcore>=2.13.27"' in text
+    assert '"abstractcore[remote,vision,voice,audio,music]>=2.13.27"' in text
     assert '"openai<2.0.0,>=1.109.1"' in text
     assert '"httpx<1.0.0,>=0.28.1"' in text
     assert '"anyio<5.0.0,>=4.12.1"' in text
@@ -59,7 +59,7 @@ def test_runtime_exposes_abstractcore_and_worker_extras_with_gateway_aligned_flo
     assert '"python-pptx<2.0.0,>=1.0.2"' in text
 
     worker_block = _extract_optional_dependency_block(text, key="mcp-worker")
-    assert '"abstractcore[tools]>=2.13.25"' in worker_block
+    assert '"abstractcore[tools]>=2.13.27"' in worker_block
 
 
 def test_runtime_exposes_python_install_hardware_profile_cascades() -> None:
@@ -78,10 +78,10 @@ def test_runtime_exposes_python_install_hardware_profile_cascades() -> None:
     all_apple_block = _extract_optional_dependency_block(text, key="all-apple")
     all_gpu_block = _extract_optional_dependency_block(text, key="all-gpu")
 
-    assert '"abstractcore[apple]>=2.13.25"' in apple_block
-    assert '"abstractcore[gpu]>=2.13.25"' in gpu_block
-    assert '"abstractcore[all-apple]>=2.13.25"' in all_apple_block
-    assert '"abstractcore[all-gpu]>=2.13.25"' in all_gpu_block
+    assert '"abstractcore[apple]>=2.13.27"' in apple_block
+    assert '"abstractcore[gpu]>=2.13.27"' in gpu_block
+    assert '"abstractcore[all-apple]>=2.13.27"' in all_apple_block
+    assert '"abstractcore[all-gpu]>=2.13.27"' in all_gpu_block
     assert '"setuptools<82.0.0,>=80.10.2"' in apple_block
     assert '"setuptools<82.0.0,>=80.10.2"' in gpu_block
     assert '"setuptools<82.0.0,>=80.10.2"' in all_apple_block