mainsequence 4.4.27__tar.gz → 4.4.29__tar.gz

{mainsequence-4.4.27 → mainsequence-4.4.29}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence
-Version: 4.4.27
+Version: 4.4.29
 Summary: Main Sequence SDK 
 Author-email: Main Sequence GmbH <dev@main-sequence.io>
 License: MainSequence GmbH SDK License Agreement

{mainsequence-4.4.27 → mainsequence-4.4.29}/agent_scaffold/AGENTS.md

@@ -53,7 +53,8 @@ Core responsibilities:
   - for data publishing and data pipelines, use `DataNode`s and `MetaTable`s
   - for serving application or widget-facing surfaces, use `FastAPI`
   - for visualization, confirm the delivery target with the user:
-    - if they want something quick for testing or iteration, use Streamlit
+    - if they want a Streamlit app, treat app design and implementation as project-owned code and
+      use Main Sequence skills only for platform deployment and release verification
     - if they want reusable components and a more structured product surface, use Command Center
   - for scheduled execution, releases, and backend operations, use jobs, images, resources, and
     other platform objects through the proper platform skills
@@ -72,8 +73,8 @@ Typical outcomes include:
 - build a `MetaTable` to record operational or application data
 - build a `FastAPI` API that reads project data and returns widget-ready or
   application-ready responses
-- confirm whether a visualization should be a quick Streamlit surface or a reusable Command Center
-  surface before building it
+- confirm whether a visualization should be a project-owned Streamlit app or a reusable Command
+  Center surface before building or deploying it
 - build reusable business logic in `src/` and keep thin integration layers in APIs, jobs, and
   dashboards
 - keep the repository auditable through maintenance, journaling, and bug reporting
@@ -204,8 +205,12 @@ Typical routing:
   `.agents/skills/mainsequence/platform_operations/orchestration_and_releases/SKILL.md`
 - RBAC, sharing, constants, secrets, and access verification:
   `.agents/skills/mainsequence/platform_operations/access_control_and_sharing/SKILL.md`
-- dashboards:
-  `.agents/skills/mainsequence/dashboards/streamlit/SKILL.md`
+- Streamlit dashboard deployment and release verification:
+  `.agents/skills/mainsequence/platform_operations/orchestration_and_releases/SKILL.md`
+
+Streamlit dashboard design and implementation are app-owned project work, not a separate Main
+Sequence scaffold skill. Route only deployment of an already-authored Streamlit dashboard to
+orchestration and releases.
 
 ## Mandatory Startup Sequence
 

{mainsequence-4.4.27 → mainsequence-4.4.29}/agent_scaffold/skills/application_surfaces/api_surfaces/SKILL.md

@@ -39,7 +39,7 @@ This skill must not claim ownership of:
 - workspace document creation or mutation
 - AppComponent custom form design
 - job creation, scheduling, image pinning, or releases
-- Streamlit dashboard implementation
+- Streamlit dashboard design or implementation
 - non-FastAPI API framework choices for Main Sequence project APIs
 
 ## Route Adjacent Work
@@ -62,8 +62,8 @@ This skill must not claim ownership of:
   `.agents/skills/mainsequence/command_center/api_mock_prototyping/SKILL.md`
 - Jobs, images, resources, and releases:
   `.agents/skills/mainsequence/platform_operations/orchestration_and_releases/SKILL.md`
-- Streamlit dashboards:
-  `.agents/skills/mainsequence/dashboards/streamlit/SKILL.md`
+
+Streamlit dashboard implementation is app-owned project code, not a Main Sequence platform skill. Route Streamlit deployment only through orchestration and releases.
 
 ## Read First
 

{mainsequence-4.4.27 → mainsequence-4.4.29}/agent_scaffold/skills/command_center/connections/SKILL.md

@@ -45,7 +45,7 @@ This skill must not claim ownership of:
 - AppComponent custom forms or action contracts
 - generic FastAPI endpoint design
 - backend resource and release creation
-- Streamlit dashboards
+- Streamlit dashboard design or implementation
 
 ## Route Adjacent Work
 

{mainsequence-4.4.27 → mainsequence-4.4.29}/agent_scaffold/skills/command_center/widgets/app_components/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: command-center-app-components
-description: Use this skill when the task is about AppComponent widgets in a Main Sequence project. This skill owns AppComponent generated request forms, response-side editable-form and notification UI contracts, dynamic request/response binding contracts, and the boundary between AppComponent responses and widget-facing output contracts, including requiring generic tabular consumers to receive core.tabular_frame@v1 instead of ad hoc AppComponent JSON. Before changing AppComponent payloads or contracts, verify the target widget in the Command Center registry through the CLI. Source order is strict: registry detail first, SDK client models second, local Main Sequence repository docs/models third only if the first two still leave something unresolved. Main Sequence is platform-first: if an AppComponent depends on a project API, that API must already exist as a FastAPI project resource and have a corresponding FastAPI ResourceRelease before the AppComponent is considered usable from Command Center. Resource and release creation belong to the orchestration-and-releases skill. It does not own workspace layout, generic FastAPI design, or Streamlit dashboards.
+description: Use this skill when the task is about AppComponent widgets in a Main Sequence project. This skill owns AppComponent generated request forms, response-side editable-form and notification UI contracts, dynamic request/response binding contracts, and the boundary between AppComponent responses and widget-facing output contracts, including requiring generic tabular consumers to receive core.tabular_frame@v1 instead of ad hoc AppComponent JSON. Before changing AppComponent payloads or contracts, verify the target widget in the Command Center registry through the CLI. Source order is strict: registry detail first, SDK client models second, local Main Sequence repository docs/models third only if the first two still leave something unresolved. Main Sequence is platform-first: if an AppComponent depends on a project API, that API must already exist as a FastAPI project resource and have a corresponding FastAPI ResourceRelease before the AppComponent is considered usable from Command Center. Resource and release creation belong to the orchestration-and-releases skill. It does not own workspace layout, generic FastAPI design, or Streamlit dashboard design or implementation.
 ---
 
 # Command Center AppComponents
@@ -40,7 +40,7 @@ This skill must not claim ownership of:
 - generic FastAPI route architecture
 - tabular or operational data producer design
 - MetaTable schema design
-- Streamlit dashboard implementation
+- Streamlit dashboard design or implementation
 - scheduling, image pinning, resources, or releases
 
 ## Route Adjacent Work
@@ -61,8 +61,8 @@ This skill must not claim ownership of:
   `.agents/skills/mainsequence/data_publishing/meta_tables/SKILL.md`
 - Jobs, images, resources, and releases:
   `.agents/skills/mainsequence/platform_operations/orchestration_and_releases/SKILL.md`
-- Streamlit dashboards:
-  `.agents/skills/mainsequence/dashboards/streamlit/SKILL.md`
+
+Streamlit dashboard implementation is app-owned project code, not an AppComponent or Main Sequence platform skill. Route Streamlit dashboard deployment or release verification to orchestration and releases.
 
 ## Read First
 

{mainsequence-4.4.27 → mainsequence-4.4.29}/agent_scaffold/skills/command_center/workspace_builder/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: command-center-workspace-builder
-description: Use this skill when the task is about creating, updating, validating, or reviewing Main Sequence Command Center workspaces after the workspace design is known. This skill owns workspace documents, widget instance payload resolution, safe mutation, shared versus user state, widget-scoped mutation, connection-backed source widget mounting, and grounding those decisions against the richer widget-type registry contract plus the SDK command_center client models. Use workspace_design first when the task is still about deciding which widgets, layout, narrative, or visualization strategy should express the user intent; use command-center-connections first when source data or query contracts are unresolved. Source order is strict: registry detail first, SDK client models second, local Main Sequence repository docs/models third only when the first two still leave instance payload questions unresolved. Main Sequence is platform-first: if a mounted widget or AppComponent depends on a project API, that API must already exist as a FastAPI project resource and have a corresponding FastAPI ResourceRelease before the workspace flow is considered usable. Resource and release creation belong to the orchestration-and-releases skill. It does not own AppComponent form contracts, API implementation, workspace design, or Streamlit dashboards.
+description: Use this skill when the task is about creating, updating, validating, or reviewing Main Sequence Command Center workspaces after the workspace design is known. This skill owns workspace documents, widget instance payload resolution, safe mutation, shared versus user state, widget-scoped mutation, connection-backed source widget mounting, and grounding those decisions against the richer widget-type registry contract plus the SDK command_center client models. Use workspace_design first when the task is still about deciding which widgets, layout, narrative, or visualization strategy should express the user intent; use command-center-connections first when source data or query contracts are unresolved. Source order is strict: registry detail first, SDK client models second, local Main Sequence repository docs/models third only when the first two still leave instance payload questions unresolved. Main Sequence is platform-first: if a mounted widget or AppComponent depends on a project API, that API must already exist as a FastAPI project resource and have a corresponding FastAPI ResourceRelease before the workspace flow is considered usable. Resource and release creation belong to the orchestration-and-releases skill. It does not own AppComponent form contracts, API implementation, workspace design, or Streamlit dashboard design or implementation.
 ---
 
 # Command Center Workspace Builder
@@ -42,7 +42,7 @@ This skill must not claim ownership of:
 - AppComponent custom input forms
 - widget-facing API response contracts
 - generic FastAPI or backend API implementation
-- Streamlit dashboard implementation
+- Streamlit dashboard design or implementation
 - tabular or operational data producer design
 - MetaTable schema design
 
@@ -66,11 +66,11 @@ This skill must not claim ownership of:
   `.agents/skills/mainsequence/application_surfaces/api_surfaces/SKILL.md`
 - Jobs, images, resources, and releases:
   `.agents/skills/mainsequence/platform_operations/orchestration_and_releases/SKILL.md`
-- Streamlit dashboards:
-  `.agents/skills/mainsequence/dashboards/streamlit/SKILL.md`
 - MetaTables:
   `.agents/skills/mainsequence/data_publishing/meta_tables/SKILL.md`
 
+Streamlit dashboard implementation is app-owned project code, not a Main Sequence workspace skill. Route Streamlit dashboard deployment or release verification to orchestration and releases.
+
 ## Read First
 
 0. If widget selection, layout narrative, or visualization strategy is not already decided, use:

{mainsequence-4.4.27 → mainsequence-4.4.29}/agent_scaffold/skills/command_center/workspace_design/SKILL.md

@@ -48,8 +48,8 @@ This skill must not claim ownership of:
   `.agents/skills/mainsequence/data_publishing/meta_tables/SKILL.md`
 - Jobs, images, resources, and releases:
   `.agents/skills/mainsequence/platform_operations/orchestration_and_releases/SKILL.md`
-- Streamlit dashboards:
-  `.agents/skills/mainsequence/dashboards/streamlit/SKILL.md`
+
+Streamlit dashboard design and implementation are app-owned project work, not a Main Sequence Command Center or platform scaffold skill. Route only Streamlit dashboard deployment or release verification to orchestration and releases.
 
 ## Read First
 

{mainsequence-4.4.27 → mainsequence-4.4.29}/agent_scaffold/skills/data_access/exploration/SKILL.md

@@ -51,13 +51,15 @@ This skill discovers and identifies data. It does not publish, redesign, or defi
   `.agents/skills/mainsequence/data_publishing/meta_tables/SKILL.md`
 - FastAPI or application-facing implementation:
   `.agents/skills/mainsequence/application_surfaces/api_surfaces/SKILL.md`
-- Streamlit dashboards:
-  `.agents/skills/mainsequence/dashboards/streamlit/SKILL.md`
+- Streamlit dashboard deployment:
+  `.agents/skills/mainsequence/platform_operations/orchestration_and_releases/SKILL.md`
 - Command Center surfaces:
   `.agents/skills/mainsequence/command_center/workspace_builder/SKILL.md`
 - blocker and failure analysis:
   `.agents/skills/mainsequence/maintenance/bug_auditor/SKILL.md`
 
+Streamlit dashboard implementation is app-owned project code, not a Main Sequence scaffold skill.
+
 ## Read First
 
 1. `AGENTS.md`

{mainsequence-4.4.27 → mainsequence-4.4.29}/agent_scaffold/skills/maintenance/bug_auditor/SKILL.md

@@ -62,8 +62,10 @@ This skill audits. It does not implement by default.
   `.agents/skills/mainsequence/platform_operations/orchestration_and_releases/SKILL.md`
 - RBAC and access issues:
   `.agents/skills/mainsequence/platform_operations/access_control_and_sharing/SKILL.md`
-- dashboard domain issues:
-  `.agents/skills/mainsequence/dashboards/streamlit/SKILL.md`
+- Streamlit dashboard deployment or release issues:
+  `.agents/skills/mainsequence/platform_operations/orchestration_and_releases/SKILL.md`
+
+Streamlit dashboard design and implementation failures are target-project application code issues unless the evidence points to Main Sequence deployment, resource discovery, image selection, release creation, or platform runtime behavior.
 
 ## Read First
 

{mainsequence-4.4.27 → mainsequence-4.4.29}/agent_scaffold/skills/platform_operations/access_control_and_sharing/SKILL.md

@@ -45,7 +45,7 @@ This skill must not claim ownership of:
 - DataNode producer implementation
 - MetaTable schema design
 - FastAPI route design
-- Streamlit dashboard implementation
+- Streamlit dashboard design or implementation
 - workspace document structure
 
 ## Route Adjacent Work
@@ -58,11 +58,13 @@ This skill must not claim ownership of:
   `.agents/skills/mainsequence/data_publishing/meta_tables/SKILL.md`
 - APIs and FastAPI:
   `.agents/skills/mainsequence/application_surfaces/api_surfaces/SKILL.md`
-- Streamlit dashboards:
-  `.agents/skills/mainsequence/dashboards/streamlit/SKILL.md`
+- Streamlit dashboard deployment:
+  `.agents/skills/mainsequence/platform_operations/orchestration_and_releases/SKILL.md`
 - Command Center workspaces:
   `.agents/skills/mainsequence/command_center/workspace_builder/SKILL.md`
 
+Streamlit dashboard implementation is app-owned project code. This skill only reasons about access to deployed resources such as `ResourceRelease`.
+
 ## Read First
 
 1. `docs/tutorial/role_based_access_control.md`

{mainsequence-4.4.27 → mainsequence-4.4.29}/agent_scaffold/skills/platform_operations/orchestration_and_releases/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mainsequence-orchestration-and-releases
-description: Use this skill when the task is about operational execution in a Main Sequence project. This skill owns jobs, schedules, batch scheduling files, project images, run inspection, project resources, releases, and Artifacts as operational inputs. It does not own DataNode producer design, MetaTable schema design, API route contracts, or RBAC policy.
+description: Use this skill when the task is about operational execution in a Main Sequence project. This skill owns jobs, schedules, batch scheduling files, project images, run inspection, project resources, releases, Streamlit dashboard deployment, and Artifacts as operational inputs. It does not own DataNode producer design, MetaTable schema design, API route contracts, Streamlit dashboard design, or RBAC policy.
 ---
 
 # Main Sequence Orchestration And Releases
@@ -16,6 +16,7 @@ This skill is for:
 - images
 - project resources
 - releases
+- Streamlit dashboard deployment as `streamlit_dashboard` releases
 - operational logs and run inspection
 - Artifacts as job inputs or outputs
 
@@ -30,6 +31,7 @@ This skill is for:
 - freeze jobs to a project image
 - inspect job runs and logs
 - reason about project resources and resource releases
+- create or review Streamlit dashboard deployment through project resources and `streamlit_dashboard` releases
 - review Artifact-based workflows in operational pipelines
 
 ## This Skill Must Not Claim
@@ -41,6 +43,7 @@ This skill must not claim ownership of:
 - FastAPI route contracts
 - RBAC or sharing policy
 - Streamlit dashboard implementation details
+- Streamlit layout, styling, sidebar/session behavior, page structure, or UI helper design
 
 ## Route Adjacent Work
 
@@ -54,20 +57,22 @@ This skill must not claim ownership of:
   `.agents/skills/mainsequence/command_center/api_mock_prototyping/SKILL.md`
 - RBAC and sharing:
   `.agents/skills/mainsequence/platform_operations/access_control_and_sharing/SKILL.md`
-- Streamlit dashboards:
-  `.agents/skills/mainsequence/dashboards/streamlit/SKILL.md`
 
 ## Read First
 
 1. `docs/tutorial/scheduling_jobs.md`
 2. `docs/knowledge/infrastructure/scheduling_jobs.md`
 3. `docs/knowledge/infrastructure/artifacts.md`
+4. `docs/tutorial/dashboards/streamlit/streamlit_integration_2.md` when deploying or verifying a Streamlit dashboard
+5. `docs/knowledge/dashboards/streamlit/index.md` when deployment metadata or SDK/dashboard boundary questions matter
 
-If the task touches deployed dashboards or APIs, also read the relevant domain skill/docs before changing the operational workflow.
+If the task touches deployed FastAPI APIs, also read the relevant API skill/docs before changing the operational workflow.
+
+If the task asks to design, build, style, or restructure a Streamlit app, do not treat that as Main Sequence platform skill work. Streamlit implementation is app-owned project code. This skill only owns deployment and verification of an already-authored dashboard.
 
 If the task is about publishing a Command Center-facing API mainly to test AppComponent UX, bindings, or request/response contracts, read:
 
-4. `.agents/skills/mainsequence/command_center/api_mock_prototyping/SKILL.md`
+6. `.agents/skills/mainsequence/command_center/api_mock_prototyping/SKILL.md`
 
 Do that before building an image or creating a FastAPI `ResourceRelease`.
 
@@ -78,6 +83,7 @@ Before changing orchestration or release behavior, collect or infer:
 - the execution target:
   - `execution_path`
   - app entrypoint
+  - Streamlit `app.py` resource path when deploying a dashboard
 - whether the job is:
   - manual
   - interval
@@ -89,8 +95,10 @@ Before changing orchestration or release behavior, collect or infer:
 - whether the workflow is:
   - direct CLI/client job creation
   - repository-managed batch scheduling
+  - Streamlit dashboard release creation
 - whether Artifact inputs or outputs are part of the run
 - whether the job should be reproducible against a pinned image
+- for Streamlit dashboard deployment, the `README.md` resource next to `app.py`
 
 If the execution target or image strategy is unclear, stop before scheduling anything.
 
@@ -104,6 +112,7 @@ For every non-trivial orchestration task, decide:
 4. Is strict batch sync appropriate or dangerous?
 5. Does the workflow depend on Artifacts?
 6. Is the task actually a release/resource problem instead of only a job problem?
+7. For Streamlit dashboard deployment, do the selected app resource, README resource, and project image all refer to the intended pushed commit?
 
 ## Build Rules
 
@@ -175,7 +184,25 @@ For deployed dashboards, APIs, or agents:
 - the release must exist
 - the release must point at the intended image or resource version
 
-### 6.1 Do not publish an API just to test AppComponent contracts
+### 6.1 Streamlit dashboard deployment is a release workflow
+
+Main Sequence owns the deployment boundary for Streamlit dashboards, not the dashboard UI design.
+
+For Streamlit dashboard deployment:
+
+- the dashboard `app.py` must already exist in the repository
+- the dashboard `README.md` must exist next to `app.py`
+- both files must be committed and pushed
+- the project image must be built from the intended pushed commit
+- `mainsequence project project_resource list` must discover the dashboard app and README resources
+- create the release with `mainsequence project project_resource create_dashboard`
+- the dashboard release kind is `streamlit_dashboard`
+
+Do not prescribe Streamlit page layout, styling, sidebar/session patterns, or helper/component architecture. Those are application-owned implementation details.
+
+Validate the deployment path, not the Streamlit design.
+
+### 6.2 Do not publish an API just to test AppComponent contracts
 
 If the goal is to validate Command Center AppComponent UX, request rendering, response rendering, published outputs, or downstream bindings, do not jump straight to:
 
@@ -203,6 +230,7 @@ When reviewing an orchestration task, look for:
 - unsafe use of `--strict`
 - workflows depending on laptop-specific file paths instead of Artifacts
 - image or release work being used as a substitute for predeployment AppComponent/API contract validation
+- Streamlit dashboard deployment work drifting into app design or UI implementation ownership
 - tasks that are really resource/release problems rather than simple job problems
 
 ## Validation Checklist
@@ -219,6 +247,7 @@ Do not claim success until you have checked:
 - the job exists after creation or sync
 - runs and logs were inspected when execution success matters
 - resources and releases were verified when deployment success matters
+- Streamlit dashboard releases use the intended app resource, README resource, image, and `streamlit_dashboard` release kind
 - Command Center-facing API publishing is not being used just to test AppComponent UX that should have been validated first in `mock-json` mode
 
 If the workflow uses `scheduled_jobs.yaml`, also check:

{mainsequence-4.4.27 → mainsequence-4.4.29}/agent_scaffold/skills/project_builder/SKILL.md

@@ -42,7 +42,7 @@ This skill must not claim ownership of:
 - jobs, schedules, images, resources, or releases
 - RBAC or sharing semantics
 - domain assets, translation tables, or construction logic
-- Streamlit dashboard implementation
+- Streamlit dashboard design or implementation
 - pricing-runtime semantics
 
 Do not let this skill become a domain manual.
@@ -65,12 +65,12 @@ Do not let this skill become a domain manual.
   `.agents/skills/mainsequence/maintenance/local_journal/SKILL.md`
 - project status audits, blocker analysis, and upstream SDK assessment:
   `.agents/skills/mainsequence/maintenance/bug_auditor/SKILL.md`
-- jobs, schedules, artifacts, images, resources, and releases:
+- jobs, schedules, artifacts, images, resources, releases, and Streamlit dashboard deployment:
   `.agents/skills/mainsequence/platform_operations/orchestration_and_releases/SKILL.md`
 - RBAC and sharing:
   `.agents/skills/mainsequence/platform_operations/access_control_and_sharing/SKILL.md`
-- Streamlit dashboards:
-  `.agents/skills/mainsequence/dashboards/streamlit/SKILL.md`
+
+Streamlit dashboard design and implementation are app-owned project work, not a separate Main Sequence scaffold skill. Route only platform deployment of an already-authored Streamlit dashboard to orchestration and releases.
 
 ## Read First
 

{mainsequence-4.4.27 → mainsequence-4.4.29}/mainsequence/client/agent_runtime_models.py

@@ -10,7 +10,7 @@ from enum import Enum
 from typing import Any, ClassVar
 
 import requests
-from pydantic import ConfigDict, Field
+from pydantic import ConfigDict, Field, model_validator
 
 from .base import BaseObjectOrm, BasePydanticModel, ShareableObjectMixin
 from .exceptions import ApiError, raise_for_response
@@ -118,6 +118,10 @@ class AgentRuntimeImageDrift(BasePydanticModel):
         None,
         description="Additional backend detail when drift information is unavailable or degraded.",
     )
+    catalog_state: dict[str, Any] | None = Field(
+        None,
+        description="Platform catalog freshness state returned by the backend, when available.",
+    )
 
 
 class AgentRuntimePaths(BasePydanticModel):
@@ -165,9 +169,13 @@ class AgentSessionRuntimeAccess(BasePydanticModel):
         default_factory=AgentRuntimePaths,
         description="Runtime-relative paths returned by the control plane.",
     )
+    service_runtime_uid: str | None = Field(
+        None,
+        description="Public UID of the linked service runtime, when the backend has one.",
+    )
     knative_service_runtime_uid: str | None = Field(
         None,
-        description="Public UID of the linked Knative service runtime, when the backend has one.",
+        description="Deprecated alias for service_runtime_uid kept for older SDK callers.",
     )
     image_drift: AgentRuntimeImageDrift | None = Field(
         None,
@@ -180,6 +188,20 @@ class AgentSessionRuntimeAccess(BasePydanticModel):
             return None
         return self.image_drift.model_dump()
 
+    @model_validator(mode="after")
+    def _mirror_service_runtime_uid(self) -> AgentSessionRuntimeAccess:
+        if (
+            self.service_runtime_uid is None
+            and self.knative_service_runtime_uid is not None
+        ):
+            self.service_runtime_uid = self.knative_service_runtime_uid
+        elif (
+            self.knative_service_runtime_uid is None
+            and self.service_runtime_uid is not None
+        ):
+            self.knative_service_runtime_uid = self.service_runtime_uid
+        return self
+
 
 def _join_runtime_url(rpc_url: str, runtime_path: str) -> str:
     if not isinstance(rpc_url, str) or not rpc_url.strip():
@@ -423,9 +445,27 @@ class CodingAgentService(BaseObjectOrm, BasePydanticModel):
     related_job_uid: str | None = Field(
         None, description="Public UID of the backing job, if attached."
     )
-    knative_service_runtime_uid: str | None = Field(
-        None, description="Public UID of the backing Knative service runtime, if attached."
+    service_runtime_uid: str | None = Field(
+        None, description="Public UID of the backing service runtime, if attached."
     )
+    knative_service_runtime_uid: str | None = Field(
+        None,
+        description="Deprecated alias for service_runtime_uid kept for older SDK callers.",
+    )
+
+    @model_validator(mode="after")
+    def _mirror_service_runtime_uid(self) -> CodingAgentService:
+        if (
+            self.service_runtime_uid is None
+            and self.knative_service_runtime_uid is not None
+        ):
+            self.service_runtime_uid = self.knative_service_runtime_uid
+        elif (
+            self.knative_service_runtime_uid is None
+            and self.service_runtime_uid is not None
+        ):
+            self.knative_service_runtime_uid = self.service_runtime_uid
+        return self
 
     @classmethod
     def _post_collection_action(

{mainsequence-4.4.27 → mainsequence-4.4.29}/mainsequence.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence
-Version: 4.4.27
+Version: 4.4.29
 Summary: Main Sequence SDK 
 Author-email: Main Sequence GmbH <dev@main-sequence.io>
 License: MainSequence GmbH SDK License Agreement

{mainsequence-4.4.27 → mainsequence-4.4.29}/mainsequence.egg-info/SOURCES.txt

@@ -13,7 +13,6 @@ agent_scaffold/skills/command_center/widgets/tabular_transform/SKILL.md
 agent_scaffold/skills/command_center/workspace_analysis/SKILL.md
 agent_scaffold/skills/command_center/workspace_builder/SKILL.md
 agent_scaffold/skills/command_center/workspace_design/SKILL.md
-agent_scaffold/skills/dashboards/streamlit/SKILL.md
 agent_scaffold/skills/data_access/exploration/SKILL.md
 agent_scaffold/skills/data_publishing/data_nodes/SKILL.md
 agent_scaffold/skills/data_publishing/meta_table_migrations/SKILL.md

{mainsequence-4.4.27 → mainsequence-4.4.29}/pyproject.toml

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

{mainsequence-4.4.27 → mainsequence-4.4.29}/tests/test_filter_normalization.py

@@ -1445,7 +1445,7 @@ def test_agent_runtime_models_deserialize_backend_uid_payloads():
             "is_ready": True,
             "image_drift": {"has_drift": False, "checks": []},
             "related_job_uid": "job-uid",
-            "knative_service_runtime_uid": "runtime-uid",
+            "service_runtime_uid": "runtime-uid",
             "automatic_deployment": True,
         }
     )
@@ -1453,7 +1453,8 @@ def test_agent_runtime_models_deserialize_backend_uid_payloads():
     assert service.agent_uid == agent_uid
     assert service.agent_type == "project-executor"
     assert service.scope["project_uid"] == "project-uid"
-
+    assert service.service_runtime_uid == "runtime-uid"
+    assert service.knative_service_runtime_uid == "runtime-uid"
 
 
 def test_agent_session_runtime_access_uses_session_uid_route(monkeypatch):
@@ -1473,7 +1474,7 @@ def test_agent_session_runtime_access_uses_session_uid_route(monkeypatch):
                 "rpc_url": "https://runtime.main-sequence.app/rpc",
                 "token": "tok-secret",
                 "is_ready": True,
-                "knative_service_runtime_uid": "70c6efb9-8e80-4051-ad3a-f432b2c37f5a",
+                "service_runtime_uid": "70c6efb9-8e80-4051-ad3a-f432b2c37f5a",
                 "image_drift": {
                     "agent_kind": "astro_orchestrator",
                     "available": True,
@@ -1499,6 +1500,21 @@ def test_agent_session_runtime_access_uses_session_uid_route(monkeypatch):
                         }
                     ],
                     "detail": None,
+                    "catalog_state": {
+                        "image_prefix": "astro",
+                        "tag": "latest",
+                        "ttl_seconds": 3600,
+                        "last_synced_at": "2026-07-17T10:00:00+00:00",
+                        "status": "fresh",
+                        "fresh": True,
+                        "refresh_required": False,
+                        "detail": "",
+                        "catalog_image_registry_id": 11,
+                        "catalog_image_registry_uid": "registry-uid",
+                        "catalog_image_id": 42,
+                        "latest_pinned_uri": "registry.example/astro@sha256:expected",
+                        "age_seconds": 12.5,
+                    },
                 },
             }
 
@@ -1515,10 +1531,13 @@ def test_agent_session_runtime_access_uses_session_uid_route(monkeypatch):
 
     assert access.coding_agent_service_id == "svc-12"
     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"
     assert access.image_drift is not None
     assert access.image_drift.agent_kind == "astro_orchestrator"
     assert access.image_drift.checks[0].key == "orchestrator_image"
+    assert access.image_drift.catalog_state is not None
+    assert access.image_drift.catalog_state["refresh_required"] is False
     assert captured == {
         "r_type": "POST",
         "url": f"{agent_models_mod.AgentSession.get_object_url()}/{session_uid}/resolve_runtime_access/",