AbstractRuntime 0.4.8__tar.gz → 0.4.10__tar.gz

{abstractruntime-0.4.8 → abstractruntime-0.4.10}/ACKNOWLEDGMENTS.md

@@ -7,14 +7,15 @@ The canonical dependency list lives in `pyproject.toml`.
 
 ## Runtime dependencies (core install)
 
-- **abstractsemantics** (`>=0.0.2`) — structured schema registry support (declared in `pyproject.toml`, used in `src/abstractruntime/integrations/abstractmemory/effect_handlers.py` and VisualFlow execution wiring).
+- **abstractsemantics** (`>=0.0.3`) — structured schema registry support (declared in `pyproject.toml`, used in `src/abstractruntime/integrations/abstractmemory/effect_handlers.py` and VisualFlow execution wiring).
+- **AbstractMemory** (`>=0.2.6`) — TripleStore models and store contract used by Runtime's `MEMORY_KG_*` effects. Durable/vector backend dependencies such as LanceDB remain selected by hosts.
 
 ## Optional integrations (extras)
 
 Installed only when you opt in to extras:
-- **abstractcore** (`>=2.11.8`) — LLM + tools integration used by `abstractruntime[abstractcore]` (declared in `pyproject.toml`, implementation under `src/abstractruntime/integrations/abstractcore/*`, docs: `docs/integrations/abstractcore.md`).
+- **abstractcore** (`>=2.13.12`) — LLM + tools integration used by `abstractruntime[abstractcore]` (declared in `pyproject.toml`, implementation under `src/abstractruntime/integrations/abstractcore/*`, docs: `docs/integrations/abstractcore.md`).
   - The AbstractCore integration uses **httpx** for remote mode (`src/abstractruntime/integrations/abstractcore/llm_client.py`) and **pydantic** for structured validation (`src/abstractruntime/integrations/abstractcore/effect_handlers.py`). These are provided by AbstractCore’s dependency set.
-- **abstractcore[tools]** (`>=2.11.8`) — toolchain extra used by `abstractruntime[mcp-worker]` (declared in `pyproject.toml`) and intended to include HTML parsing dependencies (see comments in `pyproject.toml`).
+- **abstractcore[tools]** (`>=2.13.12`) — toolchain extra used by `abstractruntime[mcp-worker]` (declared in `pyproject.toml`) and intended to include HTML parsing dependencies (see comments in `pyproject.toml`).
 - **RestrictedPython** (optional) — used for sandboxed execution of VisualFlow “Code” nodes when available (`src/abstractruntime/visualflow_compiler/visual/code_executor.py`).
 
 ## Build & test tooling

{abstractruntime-0.4.8 → abstractruntime-0.4.10}/CHANGELOG.md

@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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
+- Added `AbstractMemory>=0.2.6` as a base dependency so Runtime's
+  `MEMORY_KG_*` effect contract always has the AbstractMemory TripleStore
+  models available.
+
+### Notes
+- Runtime still does not depend on `AbstractMemory[lancedb]`. Hosts such as
+  AbstractGateway choose the durable/vector memory backend, path, embeddings,
+  and readiness policy.
+
 ## [0.4.8] - 2026-05-08
 
 ### Changed

{abstractruntime-0.4.8 → abstractruntime-0.4.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: AbstractRuntime
-Version: 0.4.8
+Version: 0.4.10
 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
@@ -20,25 +20,26 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 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.13; extra == 'abstractcore'
 Provides-Extra: all-apple
-Requires-Dist: abstractcore[all-apple]>=2.13.12; extra == 'all-apple'
+Requires-Dist: abstractcore[all-apple]>=2.13.13; 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.13; extra == 'all-gpu'
 Provides-Extra: apple
-Requires-Dist: abstractcore[apple]>=2.13.12; extra == 'apple'
+Requires-Dist: abstractcore[apple]>=2.13.13; 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.13; extra == 'gpu'
 Provides-Extra: mcp-worker
-Requires-Dist: abstractcore[tools]>=2.13.12; extra == 'mcp-worker'
+Requires-Dist: abstractcore[tools]>=2.13.13; 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.13; extra == 'multimodal'
 Provides-Extra: test
 Requires-Dist: pytest>=7.0.0; extra == 'test'
 Description-Content-Type: text/markdown
@@ -49,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.8 • **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`.
 
@@ -83,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]`,
@@ -137,7 +138,7 @@ state = rt.resume(
 assert state.status.value == "completed"
 ```
 
-## What’s included (v0.4.8)
+## What’s included (v0.4.10)
 
 Kernel (dependency-light):
 - workflow graphs: `WorkflowSpec` (`src/abstractruntime/core/spec.py`)
@@ -162,6 +163,9 @@ Drivers + distribution:
 
 Optional integrations:
 - AbstractCore (LLM + tools, cached sessions/prompt cache, media inputs, generated media, tool approval waits): `docs/integrations/abstractcore.md`
+- AbstractMemory TripleStore integration for `MEMORY_KG_*` effects. Runtime
+  depends on the light AbstractMemory contract; hosts choose storage backends
+  such as LanceDB, SQLite, or in-memory stores.
 - comms toolset gating (email/WhatsApp/Telegram): `docs/tools-comms.md`
 
 ## Built-in scheduler (zero-config)

{abstractruntime-0.4.8 → abstractruntime-0.4.10}/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.8 • **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.8)
+## What’s included (v0.4.10)
 
 Kernel (dependency-light):
 - workflow graphs: `WorkflowSpec` (`src/abstractruntime/core/spec.py`)
@@ -117,6 +117,9 @@ Drivers + distribution:
 
 Optional integrations:
 - AbstractCore (LLM + tools, cached sessions/prompt cache, media inputs, generated media, tool approval waits): `docs/integrations/abstractcore.md`
+- AbstractMemory TripleStore integration for `MEMORY_KG_*` effects. Runtime
+  depends on the light AbstractMemory contract; hosts choose storage backends
+  such as LanceDB, SQLite, or in-memory stores.
 - comms toolset gating (email/WhatsApp/Telegram): `docs/tools-comms.md`
 
 ## Built-in scheduler (zero-config)

{abstractruntime-0.4.8 → abstractruntime-0.4.10}/docs/architecture.md

@@ -1,7 +1,7 @@
 # AbstractRuntime — Architecture
 
 > Updated: 2026-05-08
-> Version: 0.4.8
+> Version: 0.4.9
 > 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.
@@ -12,7 +12,7 @@ AbstractRuntime is the durable execution kernel inside the wider AbstractFramewo
 - AbstractFramework umbrella: [lpalbou/AbstractFramework](https://github.com/lpalbou/AbstractFramework)
 - AbstractCore (LLM + tools): [lpalbou/abstractcore](https://github.com/lpalbou/abstractcore)
 
-The runtime stays dependency-light and delegates LLM/tool execution to integrations (notably AbstractCore): `src/abstractruntime/integrations/abstractcore/*`.
+The runtime stays dependency-light and delegates LLM/tool execution to integrations (notably AbstractCore): `src/abstractruntime/integrations/abstractcore/*`. Runtime also depends on the light AbstractMemory contract so `MEMORY_KG_*` effects always have the TripleStore model types available; hosts still choose the concrete memory backend.
 
 ```mermaid
 flowchart LR
@@ -37,7 +37,7 @@ The boundary is intentionally narrow:
 - Remote chat media is sent to AbstractCore Server as provider-ready content arrays, but persisted provider-request metadata redacts data URLs so checkpoints and ledgers do not embed media bytes.
 - Provider sessions and prompt-cache objects are not runtime state. Runtime may carry stable cache keys, while AbstractCore clients/servers manage warm caches.
 - Local execution can use richer AbstractCore capability plugins. Remote and hybrid execution map the common media cases to AbstractCore Server endpoints and OpenAI-compatible content arrays, while hybrid keeps tool execution local.
-- Gateway and other hosts compose Runtime with the desired Core/capability/memory profile. Runtime's base package does not expose hardware profile extras such as `apple`, `gpu`, `all-apple`, or `all-gpu`; those cascade through AbstractCore when a host selects them.
+- Gateway and other hosts compose Runtime with the desired Core/capability/memory profile. Runtime's base package includes the AbstractMemory contract but not backend extras such as LanceDB; hosts choose storage, embeddings, and readiness policy. Hardware profile extras such as `apple`, `gpu`, `all-apple`, and `all-gpu` cascade through AbstractCore when a host selects them.
 - Remote and hybrid clients use explicit Core server URLs and auth headers supplied by the host. Runtime does not read Gateway auth environment variables for provider/model/auth decisions or treat Gateway bearer tokens as Core server/provider credentials.
 
 This keeps the runtime usable by `../abstractgateway` and application layers such as `../abstractflow`, `../abstractassistant`, `../abstractobserver`, and `../abstractcode` without embedding provider-specific model logic in the durable kernel.

abstractruntime-0.4.10/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.8 → abstractruntime-0.4.10}/docs/limits.md

@@ -62,7 +62,7 @@ Returns a structured dict for UI/status display. (`src/abstractruntime/core/runt
 
 Returns a list of `LimitWarning` objects for limits approaching/exceeded. (`src/abstractruntime/core/models.py`, `src/abstractruntime/core/runtime.py`)
 
-As of v0.4.8, warnings are computed for:
+As of v0.4.9, warnings are computed for:
 - `iterations` (`current_iteration` vs `max_iterations`)
 - `tokens` (`estimated_tokens_used` vs `max_tokens`)
 

{abstractruntime-0.4.8 → abstractruntime-0.4.10}/docs/proposal.md

@@ -79,7 +79,7 @@ AbstractRuntime stays dependency-light at the kernel level; concrete integration
 
 ## Status (implemented in this repository)
 
-As of v0.4.8:
+As of v0.4.9:
 - durable kernel: `RunState`, `WaitState`, `Runtime.start/tick/resume`
 - built-in waits + events: `WAIT_EVENT`, `WAIT_UNTIL`, `ASK_USER`, `EMIT_EVENT`
 - persistence backends: in-memory, JSON/JSONL, SQLite

{abstractruntime-0.4.8 → abstractruntime-0.4.10}/docs/provenance.md

@@ -8,7 +8,7 @@ Implementation pointers:
 - model fields: `src/abstractruntime/core/models.py` (`StepRecord.prev_hash`, `StepRecord.record_hash`, `StepRecord.signature`)
 - hash-chain decorator + verifier: `src/abstractruntime/storage/ledger_chain.py`
 
-## What is implemented (v0.4.8)
+## What is implemented (v0.4.9)
 
 - `HashChainedLedgerStore(inner_store)` — wraps any `LedgerStore` to compute hashes on append
 - `verify_ledger_chain(records)` — validates the chain and returns a verification report

{abstractruntime-0.4.8 → abstractruntime-0.4.10}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "AbstractRuntime"
-version = "0.4.8"
+version = "0.4.10"
 description = "AbstractRuntime: a durable graph runner designed to pair with AbstractCore."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -37,39 +37,43 @@ dependencies = [
   # Required to resolve stable structured-output schema refs like:
   # {"$ref":"abstractsemantics:kg_assertion_schema_v0"}
   "abstractsemantics>=0.0.3",
+  # Required for the Runtime-owned MEMORY_KG_* effect contract and TripleStore
+  # model types. Durable/vector backend dependencies such as LanceDB remain
+  # package extras owned by AbstractMemory and selected by hosts such as Gateway.
+  "AbstractMemory>=0.2.6",
 ]
 
 [project.optional-dependencies]
 # Enables `abstractruntime.integrations.abstractcore.*` imports.
 abstractcore = [
-  "abstractcore>=2.13.12",
+  "abstractcore>=2.13.13",
 ]
 
 apple = [
-  "abstractcore[apple]>=2.13.12",
+  "abstractcore[apple]>=2.13.13",
 ]
 
 gpu = [
-  "abstractcore[gpu]>=2.13.12",
+  "abstractcore[gpu]>=2.13.13",
 ]
 
 all-apple = [
-  "abstractcore[all-apple]>=2.13.12",
+  "abstractcore[all-apple]>=2.13.13",
 ]
 
 all-gpu = [
-  "abstractcore[all-gpu]>=2.13.12",
+  "abstractcore[all-gpu]>=2.13.13",
 ]
 
 # 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.13",
 ]
 
 # Enables `abstractruntime-mcp-worker` with the default toolsets (includes bs4/lxml).
 mcp-worker = [
-  "abstractcore[tools]>=2.13.12",
+  "abstractcore[tools]>=2.13.13",
 ]
 
 # CI/test dependencies. The workflow runs the basic contract suite plus focused

abstractruntime-0.4.10/release-notes.md

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

{abstractruntime-0.4.8 → abstractruntime-0.4.10}/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}, ...]}