AbstractRuntime 0.4.9__tar.gz → 0.4.11__tar.gz

{abstractruntime-0.4.9 → abstractruntime-0.4.11}/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.11] - 2026-05-13
+
+### Fixed
+- AbstractCore effect-handler media materialization now preserves artifact `content_type`, media `type`, artifact ids, and safe filename extensions instead of dropping artifact-backed media to bare paths. This keeps generated WAV artifacts valid for downstream transcription nodes.
+- Added explicit MIME extension aliases for common generated media types such as `audio/wav`, `image/png`, and `video/mp4` so platform MIME table differences do not create extensionless temp files.
+
+### Changed
+- Minimum AbstractCore optional dependency floor is now `abstractcore>=2.13.14`.
+
+
+## [0.4.10] - 2026-05-12
+
+### Fixed
+- Generated media VisualFlow nodes now keep media model selection in the output spec and reserve LLM `provider`/`model` routing for explicit `runtime_provider`/`runtime_model` overrides.
+- Legacy `provider`/`model` pins on image, TTS, and STT media nodes remain accepted as media selector fallbacks for existing flows.
+
+### Changed
+- Minimum AbstractCore optional dependency floor is now `abstractcore>=2.13.13` so generated media and audio catalog contracts stay aligned.
+
 ## [0.4.9] - 2026-05-09
 
 ### Changed

{abstractruntime-0.4.9 → abstractruntime-0.4.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: AbstractRuntime
-Version: 0.4.9
+Version: 0.4.11
 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,23 +23,23 @@ Requires-Python: >=3.10
 Requires-Dist: abstractmemory>=0.2.6
 Requires-Dist: abstractsemantics>=0.0.3
 Provides-Extra: abstractcore
-Requires-Dist: abstractcore>=2.13.12; extra == 'abstractcore'
+Requires-Dist: abstractcore>=2.13.14; extra == 'abstractcore'
 Provides-Extra: all-apple
-Requires-Dist: abstractcore[all-apple]>=2.13.12; extra == 'all-apple'
+Requires-Dist: abstractcore[all-apple]>=2.13.14; extra == 'all-apple'
 Provides-Extra: all-gpu
-Requires-Dist: abstractcore[all-gpu]>=2.13.12; extra == 'all-gpu'
+Requires-Dist: abstractcore[all-gpu]>=2.13.14; extra == 'all-gpu'
 Provides-Extra: apple
-Requires-Dist: abstractcore[apple]>=2.13.12; extra == 'apple'
+Requires-Dist: abstractcore[apple]>=2.13.14; extra == 'apple'
 Provides-Extra: docs
 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.12; extra == 'gpu'
+Requires-Dist: abstractcore[gpu]>=2.13.14; extra == 'gpu'
 Provides-Extra: mcp-worker
-Requires-Dist: abstractcore[tools]>=2.13.12; extra == 'mcp-worker'
+Requires-Dist: abstractcore[tools]>=2.13.14; extra == 'mcp-worker'
 Provides-Extra: multimodal
-Requires-Dist: abstractcore[audio,media,openai,vision,voice]>=2.13.12; extra == 'multimodal'
+Requires-Dist: abstractcore[audio,media,openai,vision,voice]>=2.13.14; extra == 'multimodal'
 Provides-Extra: test
 Requires-Dist: pytest>=7.0.0; extra == 'test'
 Description-Content-Type: text/markdown
@@ -50,7 +50,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.9 • **Python:** 3.10+
+**Version:** 0.4.10 • **Python:** 3.10+
 
 **Status:** pre-1.0 (API may evolve). For production use, pin versions and follow `CHANGELOG.md`.
 
@@ -84,7 +84,7 @@ AbstractCore integration (LLM + tools):
 pip install "abstractruntime[abstractcore]"
 ```
 
-The `abstractcore` extra installs AbstractCore 2.13.12 or newer so the hardened server auth model, provider-key header routing, generated-media contracts, capability catalog, prompt-cache control plane, current tool catalog, public output-selector contract, and async/sync text-generation output-selector parity are available. Use `abstractruntime[multimodal]` when you need common media, vision, voice, and audio dependencies.
+The `abstractcore` extra installs AbstractCore 2.13.13 or newer so the hardened server auth model, provider-key header routing, generated-media contracts, capability catalog, prompt-cache control plane, current tool catalog, public output-selector contract, and async/sync text-generation output-selector parity are available. Use `abstractruntime[multimodal]` when you need common media, vision, voice, and audio dependencies.
 
 Hardware profile cascades are available for native Python installs:
 `abstractruntime[apple]`, `abstractruntime[gpu]`, `abstractruntime[all-apple]`,
@@ -138,7 +138,7 @@ state = rt.resume(
 assert state.status.value == "completed"
 ```
 
-## What’s included (v0.4.9)
+## What’s included (v0.4.10)
 
 Kernel (dependency-light):
 - workflow graphs: `WorkflowSpec` (`src/abstractruntime/core/spec.py`)

{abstractruntime-0.4.9 → abstractruntime-0.4.11}/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.9 • **Python:** 3.10+
+**Version:** 0.4.10 • **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.12 or newer so the hardened server auth model, provider-key header routing, generated-media contracts, capability catalog, prompt-cache control plane, current tool catalog, public output-selector contract, and async/sync text-generation output-selector parity are available. Use `abstractruntime[multimodal]` when you need common media, vision, voice, and audio dependencies.
+The `abstractcore` extra installs AbstractCore 2.13.13 or newer so the hardened server auth model, provider-key header routing, generated-media contracts, capability catalog, prompt-cache control plane, current tool catalog, public output-selector contract, and async/sync text-generation output-selector parity are available. Use `abstractruntime[multimodal]` when you need common media, vision, voice, and audio dependencies.
 
 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.9)
+## What’s included (v0.4.10)
 
 Kernel (dependency-light):
 - workflow graphs: `WorkflowSpec` (`src/abstractruntime/core/spec.py`)

abstractruntime-0.4.11/docs/backlog/proposed/2026-05-09_runtime_retention_and_purge_contract.md

@@ -0,0 +1,82 @@
+# Proposed: Runtime Retention And Purge Contract
+
+## Metadata
+- Created: 2026-05-09
+- Status: Proposed
+- Completed: N/A
+
+## Context
+
+AbstractRuntime is the durable graph ledger. Durability is still the default, but hosts such as
+AbstractGateway need a principled way to handle temporary/private runs created by authoring tools
+like AbstractFlow.
+
+Current Runtime reality:
+
+- `RunStore` exposes `save()` and `load()`.
+- `QueryableRunStore` exposes listing and child traversal.
+- `LedgerStore` is append-only with `append()` and `list()`.
+- `ArtifactStore` implementations already have delete helpers such as `delete_by_run()`.
+- There is no generic retention class, purge protocol, or host-neutral cleanup helper for a run tree.
+
+## Why this might matter
+
+Gateway can implement cleanup itself, but the concepts are generic:
+
+- deleting or archiving a root run and all child/subworkflow runs;
+- deleting ledgers and artifacts for a run tree;
+- preserving append-only production ledgers while allowing explicitly temporary authoring runs to
+  expire;
+- hiding private runs from default indexes.
+
+If every host invents its own cleanup behavior, run history, artifacts, and child runs can drift.
+
+## Proposed direction
+
+Add optional runtime-level retention/purge contracts:
+
+- Run metadata convention:
+  - `run.vars["_runtime"]["purpose"]`;
+  - `run.vars["_runtime"]["visibility"]`;
+  - `run.vars["_runtime"]["retention"]`;
+  - `expires_at` or `ttl_s` where appropriate.
+- Optional storage protocols:
+  - `DeletableRunStore.delete(run_id)`;
+  - `DeletableLedgerStore.delete(run_id)` or `delete_by_run(run_id)`;
+  - query helpers for expired/private/draft runs.
+- Runtime helper:
+  - collect a run tree from a root;
+  - purge or archive run checkpoints, ledgers, and artifacts;
+  - return a structured cleanup report.
+- Documentation:
+  - durability remains default;
+  - purge is allowed only for explicitly temporary/private runs unless a host chooses otherwise.
+
+## Evidence to gather before promotion
+
+- Determine whether JSON file and SQLite stores can implement deletion safely without weakening
+  provenance guarantees for production runs.
+- Decide whether "private" means hidden, encrypted, or merely excluded from default listings in v0.
+- Decide whether purge should be hard-delete or archive-to-artifact for auditability.
+- Check Gateway's needs for draft Flow tests and backlog/UAT workspaces before finalizing fields.
+
+## Validation ideas
+
+- Store contract tests for JSON, SQLite, and in-memory implementations.
+- Runtime helper tests:
+  - root + child run tree cleanup;
+  - artifact cleanup;
+  - no accidental cleanup of non-temporary runs unless explicitly forced.
+- Gateway integration tests once promoted.
+
+## Non-goals
+
+- Do not make Runtime responsible for Gateway's retention policy defaults.
+- Do not remove append-only ledger semantics for normal production runs.
+- Do not require every store backend to implement deletion immediately; keep protocols optional and
+  capability-detected.
+
+## Guidance for future agents
+
+Promote this only when Gateway starts implementing first-class draft/private run cleanup. Keep the
+boundary clean: Runtime defines reusable storage mechanics; Gateway decides policy; Flow decides UX.

{abstractruntime-0.4.9 → abstractruntime-0.4.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "AbstractRuntime"
-version = "0.4.9"
+version = "0.4.11"
 description = "AbstractRuntime: a durable graph runner designed to pair with AbstractCore."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -46,34 +46,34 @@ dependencies = [
 [project.optional-dependencies]
 # Enables `abstractruntime.integrations.abstractcore.*` imports.
 abstractcore = [
-  "abstractcore>=2.13.12",
+  "abstractcore>=2.13.14",
 ]
 
 apple = [
-  "abstractcore[apple]>=2.13.12",
+  "abstractcore[apple]>=2.13.14",
 ]
 
 gpu = [
-  "abstractcore[gpu]>=2.13.12",
+  "abstractcore[gpu]>=2.13.14",
 ]
 
 all-apple = [
-  "abstractcore[all-apple]>=2.13.12",
+  "abstractcore[all-apple]>=2.13.14",
 ]
 
 all-gpu = [
-  "abstractcore[all-gpu]>=2.13.12",
+  "abstractcore[all-gpu]>=2.13.14",
 ]
 
 # Enables AbstractCore multimodal generation helpers with common OpenAI-backed
 # image/voice capability packages.
 multimodal = [
-  "abstractcore[media,openai,vision,voice,audio]>=2.13.12",
+  "abstractcore[media,openai,vision,voice,audio]>=2.13.14",
 ]
 
 # Enables `abstractruntime-mcp-worker` with the default toolsets (includes bs4/lxml).
 mcp-worker = [
-  "abstractcore[tools]>=2.13.12",
+  "abstractcore[tools]>=2.13.14",
 ]
 
 # CI/test dependencies. The workflow runs the basic contract suite plus focused

abstractruntime-0.4.11/release-notes.md

@@ -0,0 +1,6 @@
+### Fixed
+- AbstractCore effect-handler media materialization now preserves artifact `content_type`, media `type`, artifact ids, and safe filename extensions instead of dropping artifact-backed media to bare paths. This keeps generated WAV artifacts valid for downstream transcription nodes.
+- Added explicit MIME extension aliases for common generated media types such as `audio/wav`, `image/png`, and `video/mp4` so platform MIME table differences do not create extensionless temp files.
+
+### Changed
+- Minimum AbstractCore optional dependency floor is now `abstractcore>=2.13.14`.

{abstractruntime-0.4.9 → abstractruntime-0.4.11}/src/abstractruntime/integrations/abstractcore/effect_handlers.py

@@ -63,6 +63,23 @@ def _guess_ext_from_content_type(content_type: str) -> str:
     ct = str(content_type or "").strip().lower()
     if not ct:
         return ""
+    explicit = {
+        "audio/wav": ".wav",
+        "audio/wave": ".wav",
+        "audio/x-wav": ".wav",
+        "audio/mpeg": ".mp3",
+        "audio/mp3": ".mp3",
+        "audio/ogg": ".ogg",
+        "audio/flac": ".flac",
+        "image/jpeg": ".jpg",
+        "image/jpg": ".jpg",
+        "image/png": ".png",
+        "image/webp": ".webp",
+        "video/mp4": ".mp4",
+        "video/quicktime": ".mov",
+    }
+    if ct in explicit:
+        return explicit[ct]
     ext = mimetypes.guess_extension(ct) or ""
     if ext == ".jpe":
         return ".jpg"
@@ -679,9 +696,21 @@ def _resolve_llm_call_media(
             raw_name = source_path or item.get("filename") or item.get("name")
             if isinstance(raw_name, str) and raw_name.strip():
                 filename = raw_name.strip()
+        content_type = ""
+        if isinstance(item, dict):
+            for key in ("content_type", "mime_type", "mimeType", "mime"):
+                raw_ct = item.get(key)
+                if isinstance(raw_ct, str) and raw_ct.strip():
+                    content_type = raw_ct.strip()
+                    break
+        if not content_type:
+            raw_artifact_ct = getattr(artifact, "content_type", None)
+            if isinstance(raw_artifact_ct, str) and raw_artifact_ct.strip():
+                content_type = raw_artifact_ct.strip()
+
         ext = Path(filename).suffix if filename else ""
         if not ext:
-            ct = str(getattr(getattr(artifact, "metadata", None), "content_type", "") or "")
+            ct = content_type or str(getattr(getattr(artifact, "metadata", None), "content_type", "") or "")
             ext = _guess_ext_from_content_type(ct)
 
         desired = source_path or filename or artifact_id
@@ -691,7 +720,19 @@ def _resolve_llm_call_media(
             p.write_bytes(bytes(content))
         except Exception as e:
             return None, f"Failed to materialize artifact '{artifact_id}': {e}"
-        out.append(str(p))
+        resolved: Dict[str, Any] = {"file_path": str(p), "$artifact": str(artifact_id), "artifact_id": str(artifact_id)}
+        if content_type:
+            resolved["content_type"] = content_type
+            base_type = content_type.split(";", 1)[0].strip().lower()
+            if base_type.startswith("audio/"):
+                resolved["type"] = "audio"
+            elif base_type.startswith("image/"):
+                resolved["type"] = "image"
+            elif base_type.startswith("video/"):
+                resolved["type"] = "video"
+            elif base_type.startswith("text/"):
+                resolved["type"] = "text"
+        out.append(resolved)
 
     return (out or None), None
 

{abstractruntime-0.4.9 → abstractruntime-0.4.11}/src/abstractruntime/integrations/abstractcore/llm_client.py

@@ -842,8 +842,24 @@ def _resolve_media_artifacts(
                     file_path = ""
 
         if file_path:
-            # Return a raw file path to trigger AutoMediaHandler processing.
-            out.append(str(file_path))
+            # Preserve content type alongside the resolved path. Artifact stores
+            # often use extensionless content paths, so a raw path can lose the
+            # modality and make downstream transcription reject valid audio.
+            resolved: Dict[str, Any] = {"file_path": str(file_path)}
+            if content_type:
+                resolved["content_type"] = str(content_type)
+                base_type = str(content_type).split(";", 1)[0].strip().lower()
+                if base_type.startswith("audio/"):
+                    resolved["type"] = "audio"
+                elif base_type.startswith("image/"):
+                    resolved["type"] = "image"
+                elif base_type.startswith("video/"):
+                    resolved["type"] = "video"
+                elif base_type.startswith("text/"):
+                    resolved["type"] = "text"
+            resolved["artifact_id"] = str(aid)
+            resolved["$artifact"] = str(aid)
+            out.append(resolved)
             continue
 
         raise ValueError(f"Unable to resolve artifact '{aid}' to provider-ready media content.")

{abstractruntime-0.4.9 → abstractruntime-0.4.11}/src/abstractruntime/visualflow_compiler/compiler.py

@@ -169,7 +169,7 @@ def _create_effect_node_handler(
             input_key=input_key,
             output_key=output_key,
         )
-    elif effect_type == "llm_call":
+    elif effect_type in {"llm_call", "generate_image", "generate_voice", "transcribe_audio"}:
         base_handler = create_llm_call_handler(
             node_id=node_id,
             next_node=next_node,
@@ -180,6 +180,13 @@ def _create_effect_node_handler(
             temperature=effect_config.get("temperature", 0.7),
             seed=effect_config.get("seed", -1),
         )
+    elif effect_type == "listen_voice":
+        base_handler = create_wait_event_handler(
+            node_id=node_id,
+            next_node=next_node,
+            input_key=input_key,
+            output_key=output_key,
+        )
     elif effect_type == "tool_calls":
         base_handler = create_tool_calls_handler(
             node_id=node_id,
@@ -2571,6 +2578,71 @@ def _sync_effect_results_to_node_outputs(run: Any, flow: Flow) -> None:
                 if (node_id, "ttft_ms") in referenced_source_pins:
                     current["ttft_ms"] = ttft_ms
                 mapped_value = response_text
+        elif effect_type in {"generate_image", "generate_voice"}:
+            if isinstance(raw, dict):
+                modality = "image" if effect_type == "generate_image" else "voice"
+                outputs = raw.get("outputs")
+                current["outputs"] = outputs if isinstance(outputs, dict) else {}
+                resources = raw.get("resources")
+                if isinstance(resources, dict):
+                    current["resources"] = resources
+                artifact_id, artifact_ref = _first_generated_artifact(raw)
+                if artifact_ref:
+                    current["artifact_ref"] = artifact_ref
+                    current["image_artifact" if modality == "image" else "audio_artifact"] = artifact_ref
+                    ct = artifact_ref.get("content_type")
+                    if isinstance(ct, str) and ct.strip():
+                        current["content_type"] = ct.strip()
+                if artifact_id:
+                    current["artifact_id"] = artifact_id
+                current["success"] = bool(artifact_id or artifact_ref)
+                meta = {
+                    "schema": f"abstractflow.{effect_type}.v1.meta",
+                    "version": 1,
+                    "modality": modality,
+                    "provider": raw.get("provider"),
+                    "model": raw.get("model"),
+                }
+                current["meta"] = {k: v for k, v in meta.items() if v is not None}
+                current["raw"] = raw
+                mapped_value = artifact_ref or artifact_id
+        elif effect_type == "transcribe_audio":
+            if isinstance(raw, dict):
+                text_value = ""
+                text_obj = raw.get("text")
+                if isinstance(text_obj, dict):
+                    content = text_obj.get("content")
+                    if content is not None:
+                        text_value = str(content)
+                if not text_value:
+                    content = raw.get("content")
+                    if content is not None:
+                        text_value = str(content)
+                current["text"] = text_value
+                artifact_id, artifact_ref = _first_generated_artifact(raw)
+                if artifact_ref:
+                    current["artifact_ref"] = artifact_ref
+                    current["transcript_artifact"] = artifact_ref
+                if artifact_id:
+                    current["artifact_id"] = artifact_id
+                current["success"] = True
+                current["meta"] = {"schema": "abstractflow.transcribe_audio.v1.meta", "version": 1, "modality": "text", "task": "transcription"}
+                current["raw"] = raw
+                mapped_value = text_value
+        elif effect_type == "listen_voice":
+            if isinstance(raw, dict):
+                current.update(raw)
+                audio_ref = raw.get("audio_artifact") or raw.get("artifact") or raw.get("artifact_ref")
+                if isinstance(audio_ref, dict):
+                    current["audio_artifact"] = audio_ref
+                    current["artifact_ref"] = audio_ref
+                    aid = audio_ref.get("$artifact") or audio_ref.get("artifact_id")
+                    if isinstance(aid, str) and aid.strip():
+                        current["artifact_id"] = aid.strip()
+                mapped_value = current.get("audio_artifact") or raw
+            else:
+                current["event_data"] = raw
+                mapped_value = raw
         elif effect_type == "tool_calls":
             # Effect outcome is produced by AbstractRuntime TOOL_CALLS handler:
             # - executed: {"mode":"executed","results":[{call_id,name,success,output,error}, ...]}