mainsequence 6.0.26__tar.gz → 6.0.27__tar.gz

{mainsequence-6.0.26/mainsequence.egg-info → mainsequence-6.0.27}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence
-Version: 6.0.26
+Version: 6.0.27
 Summary: Main Sequence SDK 
 Author-email: Main Sequence GmbH <dev@main-sequence.io>
 License-Expression: LicenseRef-MainSequence-Proprietary

{mainsequence-6.0.26 → mainsequence-6.0.27}/mainsequence/cli/cli.py

@@ -1496,7 +1496,6 @@ def _format_resource_release_delete_preview(release: dict[str, object]) -> list[
     return [
         ("UID", str(release.get("uid") or "-")),
         ("Release Kind", str(release.get("release_kind") or "-")),
-        ("Subdomain", str(release.get("subdomain") or "-")),
         ("Resource", str(release.get("resource") or "-")),
         ("Related Image", _format_related_image_label(release.get("related_image"))),
     ]

{mainsequence-6.0.26 → mainsequence-6.0.27}/mainsequence/client/agent_runtime_models.py

@@ -143,24 +143,23 @@ class AgentRuntimePaths(BasePydanticModel):
 class AgentSessionRuntimeAccess(BasePydanticModel):
     model_config = ConfigDict(extra="allow")
 
-    coding_agent_service_id: str | None = Field(
+    coding_agent_service_uid: str | None = Field(
         None,
-        description="Identifier of the backing coding-agent service that owns the runtime.",
+        description="Canonical public UID of the coding-agent service that owns the runtime.",
     )
-    coding_agent_id: str | None = Field(
-        None,
-        description="Stable coding-agent routing identifier presented to the gateway.",
-    )
-    mode: str = Field(
+    mode: Literal["token", "unavailable"] = Field(
         "token",
-        description="Runtime access mode. Currently only token-based gateway access is supported.",
+        description="Runtime access mode returned by the backend.",
     )
-    rpc_url: str = Field(
-        ...,
-        description="Gateway RPC URL that the caller should use to reach the coding-agent runtime.",
+    rpc_url: str | None = Field(
+        None,
+        description=(
+            "Opaque, server-issued gateway RPC URL for the coding-agent runtime. "
+            "Callers must not derive it from tenancy, names, numeric IDs, or subdomains."
+        ),
     )
-    token: str = Field(
-        ...,
+    token: str | None = Field(
+        None,
         description="Bearer token that authorizes calls to the coding-agent gateway.",
     )
     expires_at: str | None = Field(
@@ -175,6 +174,14 @@ class AgentSessionRuntimeAccess(BasePydanticModel):
         None,
         description="Backend readiness metadata returned by runtime access resolution.",
     )
+    reconciliation: dict[str, Any] | None = Field(
+        None,
+        description="Backend reconciliation metadata when runtime access is unavailable or stale.",
+    )
+    detail: str | None = Field(
+        None,
+        description="Human-readable runtime access detail returned by the backend.",
+    )
     runtime_paths: AgentRuntimePaths = Field(
         default_factory=AgentRuntimePaths,
         description="Runtime-relative paths returned by the control plane.",
@@ -292,6 +299,14 @@ class Agent(ShareableObjectMixin, BaseObjectOrm, BasePydanticModel):
         None,
         description="Service-level automatic deployment flag for the resolved typed coding-agent service.",
     )
+    project_branch_uid: str | None = Field(
+        None,
+        description=(
+            "Public UID of the canonical ProjectBranch attached through the "
+            "typed Project Executor service, or null when the agent is not "
+            "ProjectBranch-scoped."
+        ),
+    )
 
     @classmethod
     def semantic_search(
@@ -973,10 +988,18 @@ class AgentSession(BaseObjectOrm, BasePydanticModel):
         body: dict[str, Any],
         timeout=None,
     ) -> requests.Response:
+        if access.mode != "token":
+            detail = str(access.detail or "").strip()
+            message = "Coding-agent runtime access is unavailable."
+            if detail:
+                message = f"{message} {detail}"
+            raise ApiError(message)
+        if not isinstance(access.token, str) or not access.token.strip():
+            raise ApiError("Runtime access response is missing token.")
         url = _join_runtime_url(access.rpc_url, STANDARD_A2A_MESSAGE_SEND_PATH)
         request_timeout = DEFAULT_AGENT_SESSION_LONG_REQUEST_TIMEOUT if timeout is None else timeout
         headers = {
-            "Authorization": f"Bearer {access.token}",
+            "Authorization": f"Bearer {access.token.strip()}",
             "Content-Type": STANDARD_A2A_CONTENT_TYPE,
             "Accept": STANDARD_A2A_CONTENT_TYPE,
         }

{mainsequence-6.0.26 → mainsequence-6.0.27}/mainsequence/client/models_helpers.py

@@ -1003,11 +1003,6 @@ class ResourceRelease(ShareableObjectMixin, BaseObjectOrm, BasePydanticModel):
         description="Public UID of the resource release.",
         examples=["0ce33c15-e3b1-4677-a66e-70460b89198f"],
     )
-    subdomain: str = Field(
-        title="Subdomain",
-        description="DNS-safe label used as the subdomain for this release.",
-        examples=["analytics-123"],
-    )
     project_branch_uid: str | None = Field(
         None,
         title="ProjectBranch UID",
@@ -1204,20 +1199,42 @@ class DeploymentRunError(BaseModel):
 
 class DeploymentRunStep(BaseModel):
     uid: str
-    sequence: int
+    sequence: PositiveInt
     key: str
     name: str = ""
-    kind: str
-    state: str
-    phase: str = ""
+    kind: Literal[
+        "source",
+        "image_build",
+        "validation",
+        "runtime_deploy",
+        "runtime_readiness",
+        "publish",
+        "cleanup",
+        "orchestration",
+    ]
+    required: bool = True
+    state: Literal[
+        "pending",
+        "running",
+        "succeeded",
+        "failed",
+        "cancelled",
+        "skipped",
+        "blocked",
+        "superseded",
+    ]
     outcome: str = ""
-    provider: str = ""
-    external_operation_id: str = ""
     artifact_context: dict[str, Any] = Field(default_factory=dict)
     started_at: datetime.datetime | None = None
     finished_at: datetime.datetime | None = None
-    error_code: str = ""
-    error_detail: str = ""
+    error: DeploymentRunError | None = None
+
+
+class DeploymentRunPipeline(BaseModel):
+    key: str
+    version: PositiveInt
+    current_step_key: str | None = None
+    steps: list[DeploymentRunStep] = Field(default_factory=list)
 
 
 class DeploymentRunLogEntry(BaseModel):
@@ -1282,8 +1299,8 @@ class DeploymentRun(BaseObjectOrm, BasePydanticModel):
     commit_sha: str = ""
     configuration_revision: int | None = None
     state: str
-    phase: str = ""
     outcome: str = ""
+    pipeline: DeploymentRunPipeline
     created_at: datetime.datetime
     started_at: datetime.datetime | None = None
     finished_at: datetime.datetime | None = None
@@ -1294,7 +1311,6 @@ class DeploymentRun(BaseObjectOrm, BasePydanticModel):
     result: dict[str, Any] = Field(default_factory=dict)
     builder_image: str = ""
     builder_runtime: str = ""
-    steps: list[DeploymentRunStep] = Field(default_factory=list)
     logs: DeploymentRunLogReference
     error: DeploymentRunError | None = None
 

{mainsequence-6.0.26 → mainsequence-6.0.27/mainsequence.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence
-Version: 6.0.26
+Version: 6.0.27
 Summary: Main Sequence SDK 
 Author-email: Main Sequence GmbH <dev@main-sequence.io>
 License-Expression: LicenseRef-MainSequence-Proprietary

{mainsequence-6.0.26 → mainsequence-6.0.27}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mainsequence"
-version = "6.0.26"
+version = "6.0.27"
 description = "Main Sequence SDK "
 readme = "README.md"
 requires-python = ">=3.13"

{mainsequence-6.0.26 → mainsequence-6.0.27}/tests/test_cli.py

@@ -933,7 +933,9 @@ def test_send_agent_session_a2a_message_uses_client_model(cli_mod, monkeypatch):
         api_mod,
         "get_runtime_access_cache",
         lambda agent_session_uid: {
-            "rpc_url": "https://runtime.main-sequence.app/rpc",
+            "coding_agent_service_uid": "7bd86be3-d11a-4ad1-8fe2-9260ccdbca7f",
+            "mode": "token",
+            "rpc_url": "https://7bd86be3-d11a-4ad1-8fe2-9260ccdbca7f.coding-agent.main-sequence.app/",
             "token": "tok-secret",
         },
     )
@@ -1000,7 +1002,9 @@ def test_send_agent_session_a2a_message_uses_client_model(cli_mod, monkeypatch):
     assert captured["cached_runtime_access"] == {
         "agent_session": session_uid,
         "runtime_access": {
-            "rpc_url": "https://runtime.main-sequence.app/rpc",
+            "coding_agent_service_uid": "7bd86be3-d11a-4ad1-8fe2-9260ccdbca7f",
+            "mode": "token",
+            "rpc_url": "https://7bd86be3-d11a-4ad1-8fe2-9260ccdbca7f.coding-agent.main-sequence.app/",
             "token": "tok-secret",
         },
     }
@@ -4398,7 +4402,6 @@ def test_delete_resource_release_uses_client_model(cli_mod, monkeypatch):
                     return {
                         "uid": pk,
                         "release_kind": "streamlit_dashboard",
-                        "subdomain": "analytics-123",
                         "resource": 381,
                         "related_image": 94,
                     }
@@ -6203,7 +6206,6 @@ def test_project_project_resource_delete_dashboard_requires_confirmation(
         lambda release_uid, expected_release_kind=None, timeout=None: {
             "uid": release_uid,
             "release_kind": expected_release_kind,
-            "subdomain": "analytics-123",
             "resource": 381,
             "related_image": 94,
         },
@@ -6215,7 +6217,6 @@ def test_project_project_resource_delete_dashboard_requires_confirmation(
         return {
             "uid": release_uid,
             "release_kind": expected_release_kind,
-            "subdomain": "analytics-123",
             "resource": 381,
             "related_image": 94,
         }
@@ -6231,6 +6232,7 @@ def test_project_project_resource_delete_dashboard_requires_confirmation(
     assert captured["release_uid"] == release_uid
     assert captured["expected_release_kind"] == "streamlit_dashboard"
     assert "Project Resource Release Delete Preview" in result.output
+    assert "Subdomain" not in result.output
     assert f"Delete dashboard release {release_uid}?" in result.output
     assert f"Project resource release deleted: uid={release_uid}" in result.output
 
@@ -6248,7 +6250,6 @@ def test_project_project_resource_delete_fastapi_requires_confirmation(
         lambda release_uid, expected_release_kind=None, timeout=None: {
             "uid": release_uid,
             "release_kind": expected_release_kind,
-            "subdomain": "api-123",
             "resource": 382,
             "related_image": 94,
         },
@@ -6260,7 +6261,6 @@ def test_project_project_resource_delete_fastapi_requires_confirmation(
         return {
             "uid": release_uid,
             "release_kind": expected_release_kind,
-            "subdomain": "api-123",
             "resource": 382,
             "related_image": 94,
         }
@@ -6275,6 +6275,7 @@ def test_project_project_resource_delete_fastapi_requires_confirmation(
     assert result.exit_code == 0
     assert captured["release_uid"] == release_uid
     assert captured["expected_release_kind"] == "fastapi"
+    assert "Subdomain" not in result.output
     assert f"Delete FastAPI release {release_uid}?" in result.output
     assert f"Project resource release deleted: uid={release_uid}" in result.output
 

{mainsequence-6.0.26 → mainsequence-6.0.27}/tests/test_filter_normalization.py

@@ -1647,6 +1647,7 @@ def test_agent_runtime_models_deserialize_backend_uid_payloads():
     session_uid = "3f1cc452-43ec-49cb-b2ba-87dbac164d29"
     user_uid = "fdf409f7-d16f-4f71-986b-9057db6c7eca"
     service_uid = "ac9e221d-1cd6-464c-a253-e302754872c1"
+    project_branch_uid = "9d81d63f-b8c9-404d-9f1a-5f2ad29dbf16"
 
     agent = agent_models_mod.Agent.model_validate(
         {
@@ -1664,12 +1665,14 @@ def test_agent_runtime_models_deserialize_backend_uid_payloads():
             "has_agent_service": True,
             "agent_service_uid": service_uid,
             "agent_service_automatic_deployment": True,
+            "project_branch_uid": project_branch_uid,
         }
     )
     assert agent.uid == agent_uid
     assert agent.has_agent_service is True
     assert agent.agent_service_uid == service_uid
     assert agent.agent_service_automatic_deployment is True
+    assert agent.project_branch_uid == project_branch_uid
 
     search_result = agent_models_mod.AgentSemanticSearchResult.model_validate(
         {
@@ -2024,7 +2027,6 @@ def test_resource_release_model_accepts_collection_payload_without_runtime_child
     release = models_helpers_mod.ResourceRelease.model_validate(
         {
             "uid": release_uid,
-            "subdomain": "competition-analysis-dc3697f1f1",
             "project_branch_uid": project_branch_uid,
             "name": "Competition Analysis",
             "release_kind": "static_site",
@@ -2039,6 +2041,7 @@ def test_resource_release_model_accepts_collection_payload_without_runtime_child
     assert release.resource_uid is None
     assert release.readme_resource_uid is None
     assert release.related_job_uid is None
+    assert "subdomain" not in models_helpers_mod.ResourceRelease.model_fields
 
 
 def test_resource_release_model_supports_automatic_deployment_payloads():
@@ -2049,7 +2052,6 @@ def test_resource_release_model_supports_automatic_deployment_payloads():
     release = models_helpers_mod.ResourceRelease.model_validate(
         {
             "uid": release_uid,
-            "subdomain": "analytics-123",
             "resource_uid": resource_uid,
             "readme_resource_uid": None,
             "related_job_uid": job_uid,
@@ -2094,7 +2096,6 @@ def test_resource_release_create_sends_automatic_deployment(monkeypatch):
         def json():
             return {
                 "uid": release_uid,
-                "subdomain": "analytics-123",
                 "resource_uid": resource_uid,
                 "readme_resource_uid": None,
                 "related_job_uid": "7d0ab07c-d1c0-4b7f-9c69-3c1a41c0a4da",
@@ -2156,7 +2157,6 @@ def test_project_resource_create_release_uses_related_image_uid(monkeypatch):
         def json():
             return {
                 "uid": release_uid,
-                "subdomain": "analytics-123",
                 "resource_uid": resource_uid,
                 "readme_resource_uid": None,
                 "related_job_uid": "7d0ab07c-d1c0-4b7f-9c69-3c1a41c0a4da",
@@ -2187,13 +2187,57 @@ def test_project_resource_create_release_uses_related_image_uid(monkeypatch):
     assert captured["timeout"] == 7
 
 
+def _resource_release_pipeline_payload(*, running_step: str | None = None):
+    keys = (
+        "resolve_revision",
+        "validate_deployment",
+        "resolve_resource",
+        "build_project_image",
+        "deploy_runtime",
+        "verify_runtime_readiness",
+    )
+    current_index = keys.index(running_step) if running_step else None
+    steps = []
+    for index, key in enumerate(keys, start=1):
+        if current_index is None or index - 1 < current_index:
+            step_state = "succeeded"
+            outcome = "completed"
+        elif index - 1 == current_index:
+            step_state = "running"
+            outcome = ""
+        else:
+            step_state = "pending"
+            outcome = ""
+        steps.append(
+            {
+                "uid": f"00000000-0000-4000-8000-{index:012d}",
+                "sequence": index,
+                "key": key,
+                "name": key.replace("_", " ").title(),
+                "kind": "orchestration",
+                "required": True,
+                "state": step_state,
+                "outcome": outcome,
+                "artifact_context": {},
+                "started_at": None,
+                "finished_at": None,
+                "error": None,
+            }
+        )
+    return {
+        "key": "resource_release.fastapi.build_and_deploy",
+        "version": 1,
+        "current_step_key": running_step,
+        "steps": steps,
+    }
+
+
 def test_resource_release_deploy_current_version_posts_detail_action(monkeypatch):
     captured = {}
     release_uid = "2f4c4c3d-5669-4da5-9d86-b84633c1e6ed"
     run_uid = "11111111-1111-4111-8111-111111111111"
     release = models_helpers_mod.ResourceRelease(
         uid=release_uid,
-        subdomain="analytics-123",
         release_kind="fastapi",
         automatic_deployment=True,
     )
@@ -2214,8 +2258,8 @@ def test_resource_release_deploy_current_version_posts_detail_action(monkeypatch
                 "commit_sha": "a" * 40,
                 "configuration_revision": 4,
                 "state": "succeeded",
-                "phase": "completed",
                 "outcome": "deployed",
+                "pipeline": _resource_release_pipeline_payload(),
                 "created_at": "2026-07-19T12:00:00Z",
                 "started_at": "2026-07-19T12:00:01Z",
                 "finished_at": "2026-07-19T12:00:05Z",
@@ -2226,7 +2270,6 @@ def test_resource_release_deploy_current_version_posts_detail_action(monkeypatch
                 "result": {},
                 "builder_image": "",
                 "builder_runtime": "",
-                "steps": [],
                 "logs": {
                     "state": "available",
                     "url": f"/api/v1/deployment-runs/{run_uid}/logs/",
@@ -2250,8 +2293,9 @@ def test_resource_release_deploy_current_version_posts_detail_action(monkeypatch
     assert isinstance(run, models_helpers_mod.DeploymentRun)
     assert run.target.uid == release_uid
     assert run.state == "succeeded"
-    assert run.phase == "completed"
     assert run.outcome == "deployed"
+    assert run.pipeline.current_step_key is None
+    assert len(run.pipeline.steps) == 6
     assert run.builder_image == ""
     assert run.builder_runtime == ""
     assert run.logs.state == "available"
@@ -2281,8 +2325,8 @@ def test_deployment_run_collection_and_detail_use_unified_resource_release_contr
         "commit_sha": "a" * 40,
         "configuration_revision": 4,
         "state": "succeeded",
-        "phase": "completed",
         "outcome": "deployed",
+        "pipeline": _resource_release_pipeline_payload(),
         "created_at": "2026-07-19T12:00:00Z",
         "started_at": "2026-07-19T12:00:01Z",
         "finished_at": "2026-07-19T12:00:05Z",
@@ -2293,7 +2337,6 @@ def test_deployment_run_collection_and_detail_use_unified_resource_release_contr
         "result": {},
         "builder_image": "",
         "builder_runtime": "",
-        "steps": [],
         "logs": {
             "state": "available",
             "url": f"/api/v1/deployment-runs/{run_uid}/logs/",
@@ -2314,7 +2357,6 @@ def test_deployment_run_collection_and_detail_use_unified_resource_release_contr
             "result",
             "builder_image",
             "builder_runtime",
-            "steps",
         }
     }
 
@@ -2349,8 +2391,9 @@ def test_deployment_run_collection_and_detail_use_unified_resource_release_contr
     assert len(runs) == 1
     assert runs[0].target.uid == release_uid
     assert detail.state == "succeeded"
-    assert detail.phase == "completed"
     assert detail.outcome == "deployed"
+    assert len(runs[0].pipeline.steps) == 6
+    assert detail.pipeline.current_step_key is None
     assert detail.builder_image == ""
     assert detail.builder_runtime == ""
     assert detail.logs.state == "available"
@@ -2377,8 +2420,10 @@ def test_unified_deployment_run_models_and_filters(monkeypatch):
             "commit_sha": "a" * 40,
             "configuration_revision": None,
             "state": "running",
-            "phase": "waiting_project_image",
             "outcome": "",
+            "pipeline": _resource_release_pipeline_payload(
+                running_step="build_project_image"
+            ),
             "created_at": "2026-07-19T12:00:00Z",
             "started_at": "2026-07-19T12:00:01Z",
             "finished_at": None,
@@ -2402,7 +2447,9 @@ def test_unified_deployment_run_models_and_filters(monkeypatch):
     )
 
     assert run.target.uid == target_uid
-    assert run.steps == []
+    assert run.pipeline.current_step_key == "build_project_image"
+    assert run.pipeline.steps[3].state == "running"
+    assert run.pipeline.steps[4].state == "pending"
     assert run.builder_image == "us-docker.pkg.dev/platform/static-builder:latest"
     assert run.builder_runtime == "nodejs22"
     assert normalized == {
@@ -2471,10 +2518,9 @@ def test_agent_session_runtime_access_uses_session_uid_route(monkeypatch):
         @staticmethod
         def json():
             return {
-                "coding_agent_service_id": "svc-12",
-                "coding_agent_id": "agent-rt-77",
+                "coding_agent_service_uid": "7bd86be3-d11a-4ad1-8fe2-9260ccdbca7f",
                 "mode": "token",
-                "rpc_url": "https://runtime.main-sequence.app/rpc",
+                "rpc_url": "https://7bd86be3-d11a-4ad1-8fe2-9260ccdbca7f.coding-agent.main-sequence.app/",
                 "token": "tok-secret",
                 "is_ready": True,
                 "service_runtime_uid": "70c6efb9-8e80-4051-ad3a-f432b2c37f5a",
@@ -2532,7 +2578,9 @@ def test_agent_session_runtime_access_uses_session_uid_route(monkeypatch):
 
     access = agent_models_mod.AgentSession.resolve_runtime_access(session_uid, timeout=11)
 
-    assert access.coding_agent_service_id == "svc-12"
+    assert access.coding_agent_service_uid == "7bd86be3-d11a-4ad1-8fe2-9260ccdbca7f"
+    assert "coding_agent_service_id" not in agent_models_mod.AgentSessionRuntimeAccess.model_fields
+    assert "coding_agent_id" not in agent_models_mod.AgentSessionRuntimeAccess.model_fields
     assert access.is_ready is True
     assert access.service_runtime_uid == "70c6efb9-8e80-4051-ad3a-f432b2c37f5a"
     assert access.knative_service_runtime_uid == "70c6efb9-8e80-4051-ad3a-f432b2c37f5a"
@@ -2559,10 +2607,9 @@ def test_agent_session_runtime_access_accepts_minimal_image_drift(monkeypatch):
         @staticmethod
         def json():
             return {
-                "coding_agent_service_id": "39",
-                "coding_agent_id": "astro-orchestrator",
+                "coding_agent_service_uid": "7bd86be3-d11a-4ad1-8fe2-9260ccdbca7f",
                 "mode": "token",
-                "rpc_url": "https://runtime.main-sequence.app/rpc",
+                "rpc_url": "https://7bd86be3-d11a-4ad1-8fe2-9260ccdbca7f.coding-agent.main-sequence.app/",
                 "token": "tok-secret",
                 "is_ready": True,
                 "knative_service_runtime_uid": "70c6efb9-8e80-4051-ad3a-f432b2c37f5a",
@@ -2602,7 +2649,9 @@ def test_agent_session_send_a2a_message_posts_standard_contract(monkeypatch):
         @staticmethod
         def json():
             return {
-                "rpc_url": "https://runtime.main-sequence.app/rpc",
+                "coding_agent_service_uid": "7bd86be3-d11a-4ad1-8fe2-9260ccdbca7f",
+                "mode": "token",
+                "rpc_url": "https://7bd86be3-d11a-4ad1-8fe2-9260ccdbca7f.coding-agent.main-sequence.app/",
                 "token": "tok-secret",
                 "expires_at": "2999-01-01T00:00:00Z",
             }
@@ -2665,7 +2714,8 @@ def test_agent_session_send_a2a_message_posts_standard_contract(monkeypatch):
     }
     assert payload["message"]["parts"] == [{"text": "I can analyze workspaces."}]
     assert captured["runtime"]["url"] == (
-        "https://runtime.main-sequence.app/rpc/api/a2a/v1/message:send"
+        "https://7bd86be3-d11a-4ad1-8fe2-9260ccdbca7f.coding-agent.main-sequence.app/"
+        "api/a2a/v1/message:send"
     )
     assert captured["runtime"]["headers"]["Content-Type"] == "application/a2a+json"
     assert captured["runtime"]["headers"]["Accept"] == "application/a2a+json"
@@ -2686,6 +2736,51 @@ def test_agent_session_send_a2a_message_posts_standard_contract(monkeypatch):
     assert "omit_reasoning" not in captured["runtime"]["data"]
 
 
+def test_agent_session_send_a2a_message_reports_unavailable_runtime_without_post(
+    monkeypatch,
+):
+    session_uid = "3f1cc452-43ec-49cb-b2ba-87dbac164d29"
+    agent_models_mod.AgentSession.clear_cached_runtime_access(session_uid)
+
+    class FakeResolveResponse:
+        status_code = 200
+        content = b'{"ok": true}'
+
+        @staticmethod
+        def json():
+            return {
+                "coding_agent_service_uid": None,
+                "mode": "unavailable",
+                "rpc_url": None,
+                "token": None,
+                "is_ready": False,
+                "detail": "Runtime reconciliation is queued.",
+            }
+
+    monkeypatch.setattr(
+        agent_models_mod,
+        "make_request",
+        lambda **kwargs: FakeResolveResponse(),
+    )
+
+    def _unexpected_post(*args, **kwargs):
+        pytest.fail("A2A HTTP request must not run for unavailable runtime access")
+
+    monkeypatch.setattr(agent_models_mod.requests, "post", _unexpected_post)
+
+    with pytest.raises(
+        agent_models_mod.ApiError,
+        match=(
+            "Coding-agent runtime access is unavailable. "
+            "Runtime reconciliation is queued."
+        ),
+    ):
+        agent_models_mod.AgentSession.send_a2a_message(
+            session_uid,
+            message="Do not send this yet.",
+        )
+
+
 def test_agent_session_send_a2a_message_posts_strict_dictionary_contract(monkeypatch):
     captured = {"resolve_count": 0}
     session_uid = "3f1cc452-43ec-49cb-b2ba-87dbac164d29"
@@ -2699,7 +2794,9 @@ def test_agent_session_send_a2a_message_posts_strict_dictionary_contract(monkeyp
         @staticmethod
         def json():
             return {
-                "rpc_url": "https://runtime.main-sequence.app/rpc",
+                "coding_agent_service_uid": "7bd86be3-d11a-4ad1-8fe2-9260ccdbca7f",
+                "mode": "token",
+                "rpc_url": "https://7bd86be3-d11a-4ad1-8fe2-9260ccdbca7f.coding-agent.main-sequence.app/",
                 "token": "tok-secret",
             }
 
@@ -2769,7 +2866,9 @@ def test_agent_session_send_a2a_message_refreshes_access_and_reuses_body(monkeyp
         def json():
             captured["resolve_count"] += 1
             return {
-                "rpc_url": "https://runtime.main-sequence.app/rpc",
+                "coding_agent_service_uid": "7bd86be3-d11a-4ad1-8fe2-9260ccdbca7f",
+                "mode": "token",
+                "rpc_url": "https://7bd86be3-d11a-4ad1-8fe2-9260ccdbca7f.coding-agent.main-sequence.app/",
                 "token": f"tok-secret-{captured['resolve_count']}",
             }