AbstractRuntime 0.4.10__tar.gz → 0.4.12__tar.gz

{abstractruntime-0.4.10 → abstractruntime-0.4.12}/.github/workflows/release.yml

@@ -1,6 +1,9 @@
 name: Release
 
 on:
+  push:
+    tags:
+      - "v*.*.*"
   workflow_dispatch:
     inputs:
       version:
@@ -111,7 +114,9 @@ jobs:
           import urllib.request
           from pathlib import Path
 
-          raw_version = os.environ["RELEASE_INPUT_VERSION"].strip()
+          version_input = os.environ.get("RELEASE_INPUT_VERSION", "").strip()
+          ref_name = os.environ.get("GITHUB_REF_NAME", "").strip()
+          raw_version = version_input or ref_name
           version = raw_version[1:] if raw_version.startswith("v") else raw_version
           if not re.fullmatch(r"\d+\.\d+\.\d+(?:[a-zA-Z0-9.-]+)?", version):
               raise SystemExit(f"Invalid release version: {raw_version!r}")
@@ -136,28 +141,36 @@ jobs:
               raise SystemExit(f"CHANGELOG.md entry for {version} is empty")
           Path("release-notes.md").write_text(notes + "\n", encoding="utf-8")
 
-          publish = os.environ["RELEASE_PUBLISH"].lower() == "true"
+          event_name = os.environ.get("GITHUB_EVENT_NAME", "")
+          publish = event_name == "push" or os.environ["RELEASE_PUBLISH"].lower() == "true"
           if publish:
-              if os.environ.get("GITHUB_REF") != "refs/heads/main":
+              if event_name == "workflow_dispatch" and os.environ.get("GITHUB_REF") != "refs/heads/main":
                   raise SystemExit("Publishing is only allowed from the main branch.")
 
-              expected = f"publish-abstractruntime-{version}"
-              confirmation = os.environ.get("RELEASE_CONFIRMATION", "").strip()
-              if confirmation != expected:
-                  raise SystemExit(
-                      f"publish_confirmation must be exactly {expected!r}; got {confirmation!r}"
-                  )
+              if event_name == "workflow_dispatch":
+                  expected = f"publish-abstractruntime-{version}"
+                  confirmation = os.environ.get("RELEASE_CONFIRMATION", "").strip()
+                  if confirmation != expected:
+                      raise SystemExit(
+                          f"publish_confirmation must be exactly {expected!r}; got {confirmation!r}"
+                      )
 
-              tag_check = subprocess.run(
-                  ["git", "ls-remote", "--exit-code", "--tags", "origin", f"refs/tags/{tag}"],
-                  check=False,
-                  stdout=subprocess.DEVNULL,
-                  stderr=subprocess.DEVNULL,
-              )
-              if tag_check.returncode == 0:
-                  raise SystemExit(f"Remote tag {tag} already exists.")
-              if tag_check.returncode not in (0, 2):
-                  raise SystemExit(f"Could not check remote tag {tag}.")
+              if event_name == "workflow_dispatch":
+                  tag_check = subprocess.run(
+                      ["git", "ls-remote", "--exit-code", "--tags", "origin", f"refs/tags/{tag}^{{}}"],
+                      check=False,
+                      capture_output=True,
+                      text=True,
+                  )
+                  if tag_check.returncode == 0:
+                      remote_sha = tag_check.stdout.split()[0].strip() if tag_check.stdout.split() else ""
+                      local_sha = subprocess.check_output(["git", "rev-parse", "HEAD"], text=True).strip()
+                      if remote_sha != local_sha:
+                          raise SystemExit(
+                              f"Remote tag {tag} already exists at {remote_sha}, but current commit is {local_sha}."
+                          )
+                  elif tag_check.returncode != 2:
+                      raise SystemExit(f"Could not check remote tag {tag}.")
 
               try:
                   with urllib.request.urlopen(
@@ -200,17 +213,27 @@ jobs:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
-      - name: Create annotated tag
+      - name: Create annotated tag for manual releases
+        if: github.event_name == 'workflow_dispatch'
         run: |
           tag="${{ needs.build.outputs.tag }}"
           if git ls-remote --exit-code --tags origin "refs/tags/${tag}" >/dev/null 2>&1; then
-            echo "Tag ${tag} already exists on origin."
-            exit 1
+            remote_sha="$(git ls-remote --tags origin "refs/tags/${tag}^{}" | awk '{print $1}')"
+            local_sha="$(git rev-parse HEAD)"
+            if [ "${remote_sha}" != "${local_sha}" ]; then
+              echo "Tag ${tag} already exists at ${remote_sha}, but current commit is ${local_sha}."
+              exit 1
+            fi
+            echo "Tag ${tag} already exists on origin for the same commit. Reusing it."
+            exit 0
           fi
           git config user.name "github-actions[bot]"
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
           git tag -a "${tag}" -m "AbstractRuntime ${tag}"
           git push origin "${tag}"
+      - name: Tag already supplied by push trigger
+        if: github.event_name != 'workflow_dispatch'
+        run: echo "Using existing tag ${{ needs.build.outputs.tag }}"
 
   publish-pypi:
     name: Publish to PyPI

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

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.12] - 2026-05-19
+
+### Fixed
+- Remote AbstractCore transcription now uses provider-scoped audio routes such as `/{provider}/v1/audio/transcriptions` when an STT provider is selected.
+- VisualFlow generated media nodes now keep LLM `provider`/`model` routing separate from image, TTS, and STT provider/model pins.
+
+### Changed
+- Minimum AbstractCore optional dependency floor is now `abstractcore>=2.13.15`.
+
+## [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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: AbstractRuntime
-Version: 0.4.10
+Version: 0.4.12
 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.13; extra == 'abstractcore'
+Requires-Dist: abstractcore>=2.13.15; extra == 'abstractcore'
 Provides-Extra: all-apple
-Requires-Dist: abstractcore[all-apple]>=2.13.13; extra == 'all-apple'
+Requires-Dist: abstractcore[all-apple]>=2.13.15; extra == 'all-apple'
 Provides-Extra: all-gpu
-Requires-Dist: abstractcore[all-gpu]>=2.13.13; extra == 'all-gpu'
+Requires-Dist: abstractcore[all-gpu]>=2.13.15; extra == 'all-gpu'
 Provides-Extra: apple
-Requires-Dist: abstractcore[apple]>=2.13.13; extra == 'apple'
+Requires-Dist: abstractcore[apple]>=2.13.15; 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.13; extra == 'gpu'
+Requires-Dist: abstractcore[gpu]>=2.13.15; extra == 'gpu'
 Provides-Extra: mcp-worker
-Requires-Dist: abstractcore[tools]>=2.13.13; extra == 'mcp-worker'
+Requires-Dist: abstractcore[tools]>=2.13.15; extra == 'mcp-worker'
 Provides-Extra: multimodal
-Requires-Dist: abstractcore[audio,media,openai,vision,voice]>=2.13.13; extra == 'multimodal'
+Requires-Dist: abstractcore[audio,media,openai,vision,voice]>=2.13.15; extra == 'multimodal'
 Provides-Extra: test
 Requires-Dist: pytest>=7.0.0; extra == 'test'
 Description-Content-Type: text/markdown

{abstractruntime-0.4.10 → abstractruntime-0.4.12}/docs/integrations/abstractcore.md

@@ -115,6 +115,21 @@ Notes:
 - `output.tags`, when present, are merged into the generated artifact metadata. Runtime metadata such as `run_id` and `tags` is used by AbstractRuntime's ArtifactStore boundary and is not forwarded as provider-specific generation kwargs.
 - Host-supplied run defaults such as `run.vars["_runtime"]["provider"]` and `run.vars["_runtime"]["model"]` are persisted as JSON-safe routing metadata; provider clients, auth objects, downloaded model handles, and server sessions are not durable runtime state.
 
+## Runtime grounding
+
+AbstractRuntime records per-call grounding as structured response metadata under `metadata.runtime_grounding`. The current fields include local datetime, timezone when detectable, country, source, whether prompt injection occurred, and an optional user identity when supplied by trace metadata or local environment.
+
+For text/chat LLM calls only, the same grounding is rendered into the current user turn as a tagged runtime envelope:
+
+```text
+<runtime_metadata>{"country":"FR","local_datetime":"2026-05-13T18:00:00+02:00"}</runtime_metadata>
+hello
+```
+
+This makes time/location/user context visible to the LLM without mutating the durable human message into a natural-language prefix. If a model echoes the runtime-owned envelope, AbstractRuntime removes that envelope from user-facing response text while preserving `metadata.runtime_grounding` for audit.
+
+Direct media requests, including image generation, TTS, and transcription, do not receive prompt-injected grounding. They still receive trace headers/tags for observability and artifact ownership, but TTS `input` and image prompts remain the literal text supplied by the workflow.
+
 ## Multimodal generation
 
 AbstractRuntime forwards AbstractCore's unified `generate(..., output=...)` selector and normalizes multimodal responses into JSON-safe, artifact-backed results.

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "AbstractRuntime"
-version = "0.4.10"
+version = "0.4.12"
 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.13",
+  "abstractcore>=2.13.15",
 ]
 
 apple = [
-  "abstractcore[apple]>=2.13.13",
+  "abstractcore[apple]>=2.13.15",
 ]
 
 gpu = [
-  "abstractcore[gpu]>=2.13.13",
+  "abstractcore[gpu]>=2.13.15",
 ]
 
 all-apple = [
-  "abstractcore[all-apple]>=2.13.13",
+  "abstractcore[all-apple]>=2.13.15",
 ]
 
 all-gpu = [
-  "abstractcore[all-gpu]>=2.13.13",
+  "abstractcore[all-gpu]>=2.13.15",
 ]
 
 # Enables AbstractCore multimodal generation helpers with common OpenAI-backed
 # image/voice capability packages.
 multimodal = [
-  "abstractcore[media,openai,vision,voice,audio]>=2.13.13",
+  "abstractcore[media,openai,vision,voice,audio]>=2.13.15",
 ]
 
 # Enables `abstractruntime-mcp-worker` with the default toolsets (includes bs4/lxml).
 mcp-worker = [
-  "abstractcore[tools]>=2.13.13",
+  "abstractcore[tools]>=2.13.15",
 ]
 
 # CI/test dependencies. The workflow runs the basic contract suite plus focused

abstractruntime-0.4.12/release-notes.md

@@ -0,0 +1,6 @@
+### Fixed
+- Remote AbstractCore transcription now uses provider-scoped audio routes such as `/{provider}/v1/audio/transcriptions` when an STT provider is selected.
+- VisualFlow generated media nodes now keep LLM `provider`/`model` routing separate from image, TTS, and STT provider/model pins.
+
+### Changed
+- Minimum AbstractCore optional dependency floor is now `abstractcore>=2.13.15`.

{abstractruntime-0.4.10 → abstractruntime-0.4.12}/src/abstractruntime/core/runtime.py

@@ -291,12 +291,30 @@ def _maybe_inject_llm_call_grounding_for_ledger(*, effect: Effect) -> Effect:
     prompt_str = str(prompt or "")
     messages_list = messages if isinstance(messages, list) else None
 
+    output_request = payload.get("output")
+    if output_request is None:
+        output_request = payload.get("outputs")
+
     try:
-        from abstractruntime.integrations.abstractcore.llm_client import _inject_turn_grounding
+        from abstractruntime.integrations.abstractcore.llm_client import (
+            _mark_grounding_prompt_injected,
+            _normalize_turn_grounding,
+            _output_request_has_non_text_result,
+            _runtime_grounding_metadata,
+        )
     except Exception:
         return effect
 
-    updated_prompt, updated_messages = _inject_turn_grounding(prompt=prompt_str, messages=messages_list)
+    skip_turn_grounding = _output_request_has_non_text_result(output_request)
+    grounding = None
+    if not skip_turn_grounding:
+        grounding = _mark_grounding_prompt_injected(_runtime_grounding_metadata(), True)
+
+    updated_prompt, updated_messages = _normalize_turn_grounding(
+        prompt=prompt_str,
+        messages=messages_list,
+        grounding=grounding,
+    )
 
     changed = False
     if updated_prompt != prompt_str:

{abstractruntime-0.4.10 → abstractruntime-0.4.12}/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