alpha-engine-lib 0.34.0__tar.gz → 0.34.1__tar.gz

{alpha_engine_lib-0.34.0 → alpha_engine_lib-0.34.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alpha-engine-lib
-Version: 0.34.0
+Version: 0.34.1
 Summary: Shared utilities for the Alpha Engine modules: preflight, structured logging with secret-redaction, ArcticDB universe access, NYSE-calendar dates + freshness predicates, decision capture, cost telemetry, RAG, agent output schemas, SSM-backed secrets, Telegram alerts + SNS fan-out, EC2 spot-launch resilience, SSM log-capture chokepoint, and Step-Functions execution-state projection. Full surface documented in README.
 Author: Brian McMahon
 License: Proprietary

{alpha_engine_lib-0.34.0 → alpha_engine_lib-0.34.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "alpha-engine-lib"
-version = "0.34.0"
+version = "0.34.1"
 description = "Shared utilities for the Alpha Engine modules: preflight, structured logging with secret-redaction, ArcticDB universe access, NYSE-calendar dates + freshness predicates, decision capture, cost telemetry, RAG, agent output schemas, SSM-backed secrets, Telegram alerts + SNS fan-out, EC2 spot-launch resilience, SSM log-capture chokepoint, and Step-Functions execution-state projection. Full surface documented in README."
 readme = "README.md"
 # EC2 still runs Python 3.9 on the always-on micro instance (boto3 drops

{alpha_engine_lib-0.34.0 → alpha_engine_lib-0.34.1}/src/alpha_engine_lib/__init__.py

@@ -1,3 +1,3 @@
 """alpha-engine-lib — shared utilities for Alpha Engine modules."""
 
-__version__ = "0.34.0"
+__version__ = "0.34.1"

{alpha_engine_lib-0.34.0 → alpha_engine_lib-0.34.1}/src/alpha_engine_lib/pipeline_status/read.py

@@ -191,6 +191,30 @@ def _label_for_arn(state_machine_arn: str) -> str:
     return PIPELINE_LABELS.get(sm_name, sm_name or "Unknown SF")
 
 
+def _region_from_arn(state_machine_arn: str) -> Optional[str]:
+    """Extract the AWS region from a Step Functions ARN.
+
+    ARN shape: ``arn:aws:states:<region>:<account>:stateMachine:<name>``.
+    Returns the region segment, or None if the ARN doesn't parse — in
+    which case the boto3 client falls back to its normal region resolution
+    (env vars / config / instance metadata). The lib is permissive on
+    malformed input here because the downstream boto3 call will fail
+    loud with a typed error that surfaces via ``_raise_for_boto_error``.
+
+    Why this exists: Step Functions is a regional service and boto3
+    raises ``NoRegionError`` if no region is discoverable. Streamlit
+    systemd environments on EC2 may not have ``AWS_REGION`` set, but the
+    ARN ALWAYS carries the region — extracting it eliminates a class of
+    "missing region" failures at the lib chokepoint.
+    """
+    if not state_machine_arn or not state_machine_arn.startswith("arn:"):
+        return None
+    parts = state_machine_arn.split(":")
+    if len(parts) < 4 or not parts[3]:
+        return None
+    return parts[3]
+
+
 def _failure_cause_from(describe_resp: dict) -> str:
     """Extract + truncate the failure cause from DescribeExecution response.
 
@@ -430,7 +454,7 @@ def read_pipeline_state(
     if client is None:  # pragma: no cover — production path
         import boto3
 
-        client = boto3.client("stepfunctions")
+        client = boto3.client("stepfunctions", region_name=_region_from_arn(state_machine_arn))
 
     label = _label_for_arn(state_machine_arn)
 

{alpha_engine_lib-0.34.0 → alpha_engine_lib-0.34.1}/src/alpha_engine_lib.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alpha-engine-lib
-Version: 0.34.0
+Version: 0.34.1
 Summary: Shared utilities for the Alpha Engine modules: preflight, structured logging with secret-redaction, ArcticDB universe access, NYSE-calendar dates + freshness predicates, decision capture, cost telemetry, RAG, agent output schemas, SSM-backed secrets, Telegram alerts + SNS fan-out, EC2 spot-launch resilience, SSM log-capture chokepoint, and Step-Functions execution-state projection. Full surface documented in README.
 Author: Brian McMahon
 License: Proprietary

{alpha_engine_lib-0.34.0 → alpha_engine_lib-0.34.1}/tests/test_pipeline_status_read.py

@@ -37,6 +37,7 @@ from alpha_engine_lib.pipeline_status.read import (
     _failure_cause_from,
     _materialize_tasks,
     _parse_ts,
+    _region_from_arn,
 )
 from alpha_engine_lib.pipeline_status.registry import (
     ArchivePageRef,
@@ -440,3 +441,24 @@ def test_pretty_label_falls_back_to_arn_suffix_for_unknown_sf():
     arn = "arn:aws:states:us-east-1:711398986525:stateMachine:future-pipeline-name"
     run = read_pipeline_state(arn, client=client)
     assert run.pretty_label == "future-pipeline-name"
+
+
+# ── Region extraction ─────────────────────────────────────────────────────
+
+
+def test_region_from_arn_extracts_us_east_1():
+    assert _region_from_arn(SATURDAY_ARN) == "us-east-1"
+
+
+def test_region_from_arn_extracts_non_us_east_1():
+    arn = "arn:aws:states:eu-west-2:123456789012:stateMachine:some-pipeline"
+    assert _region_from_arn(arn) == "eu-west-2"
+
+
+def test_region_from_arn_returns_none_for_malformed():
+    """Permissive on bad input — boto3 will raise NoRegionError downstream,
+    which surfaces as a typed PipelineStatusError per _raise_for_boto_error."""
+    assert _region_from_arn("") is None
+    assert _region_from_arn("not-an-arn") is None
+    assert _region_from_arn("arn:aws:states") is None
+    assert _region_from_arn("arn:aws:states::123:stateMachine:x") is None