mainsequence 4.3.14__tar.gz → 4.3.19__tar.gz

{mainsequence-4.3.14/mainsequence.egg-info → mainsequence-4.3.19}/PKG-INFO

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

{mainsequence-4.3.14 → mainsequence-4.3.19}/agent_scaffold/skills/command_center/adapter_from_api/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: command-center-adapter-from-api
-description: Use when building or changing an API so Command Center can consume it through an Adapter from API connection. This skill defines the provider-side API contract standards required for Command Center connection discovery, health checks, operation selection, config fields, secret injection metadata, canonical `TabularFrameResponse` outputs, and tabular response mappings. It does not define general API architecture and does not imply the API may only serve these endpoints.
+description: Use when building or changing an API so Command Center can consume it through an Adapter from API connection. This skill defines the provider-side API contract standards required for Command Center connection discovery, health checks, operation selection, config fields, secret injection metadata, canonical `TabularFrameResponse` outputs, and optional response-mapping metadata for frontend/editor context or future explicit transforms. It does not define general API architecture and does not imply the API may only serve these endpoints.
 ---
 
 # Command Center Adapter From API
@@ -13,7 +13,7 @@ connection.
 This skill defines the Command Center-facing contract that the API must expose. It does not own the
 whole API architecture. An API may serve other clients and routes, but if it is consumed by Command
 Center through this adapter, it must also expose the discovery, health, operation, config, secret,
-and response-mapping metadata described here.
+and any optional response-mapping metadata described here.
 
 The runtime flow is:
 
@@ -26,8 +26,12 @@ API with Command Center contract endpoints
 ```
 
 Generic table, chart, statistic, curve, transform, and agent-facing data consumers must consume
-`core.tabular_frame@v1`. API responses that are provider-native, paginated, nested, or domain
-specific need an exact response mapping before they are consumed by generic tabular widgets.
+an actual `core.tabular_frame@v1` payload at the consumption boundary. API responses that are
+provider-native, paginated, nested, or domain specific are still provider-native even when the
+contract includes `responseMappings`. A mapping may describe how a response could be interpreted by
+frontend/editor tooling or a future explicit transform, but the current backend adapter must not
+hot-path validate, extract JSONPath rows, coerce schemas, or reshape provider responses because a
+mapping exists.
 
 ## Scope
 
@@ -39,7 +43,7 @@ This skill owns:
 - operation metadata needed by Connection Query
 - public config variable definitions
 - secret variable definitions and backend injection metadata
-- response mappings for canonical tabular consumption
+- optional response-mapping metadata for frontend/editor context and future explicit transforms
 - API-side validation and maintenance rules for this contract
 
 This skill does not own:
@@ -103,7 +107,7 @@ GET /openapi.json
 ```
 
 This is supplementary metadata. The well-known Command Center contract decides what operations,
-config fields, secrets, and response mappings Command Center may use.
+config fields, secrets, and optional response-mapping metadata Command Center may use.
 
 ### 3. Dedicated Health Endpoint
 
@@ -123,8 +127,9 @@ parameters. Do not use a parameterized data endpoint as a fake health check.
 Each queryable API operation must have a stable `operationId` in the well-known contract and a
 matching route in the API.
 
-Operation endpoints may return provider-native JSON. For generic tabular consumers, the contract
-must declare exactly how that response becomes `core.tabular_frame@v1`.
+Operation endpoints may return a full canonical `core.tabular_frame@v1` payload or provider-native
+JSON. `responseMappings` may document an intended tabular interpretation, but they are not a
+runtime guarantee that provider-native JSON becomes `core.tabular_frame@v1`.
 
 ## Well-Known Contract Shape
 
@@ -185,7 +190,7 @@ Every operation listed in `availableOperations` must define:
 - `supportsMaxRows`
 - `parameters`
 - optional `requestBody`
-- `responseMappings`
+- optional `responseMappings`
 - `cache`
 
 Rules:
@@ -264,8 +269,8 @@ from mainsequence.client.command_center.data_models import TabularFrameResponse
 Declare `response_model=TabularFrameResponse` instead of recreating the canonical frame shape
 locally.
 
-If an operation returns provider-native JSON, declare a `responseMappings` entry that exposes the
-operation as `core.tabular_frame@v1`:
+If an operation returns provider-native JSON, it may declare a `responseMappings` entry that
+describes a tabular interpretation for frontend/editor metadata or future explicit transforms:
 
 ```json
 {
@@ -289,13 +294,23 @@ operation as `core.tabular_frame@v1`:
 
 Rules:
 
-- `contract` must be `core.tabular_frame@v1` for generic tabular consumption.
-- `rowsPath` must point to the array of row objects inside the operation response.
-- `fieldTypes` must cover the fields that consumers need for formatting and inference.
-- Time-series metadata should be present when the rows are meant for charts, curves, or time-aware
+- `responseMappings` are optional metadata in the current Adapter from API flow.
+- A mapping does not make provider-native JSON a `core.tabular_frame@v1` runtime payload.
+- The backend must not hot-path validate the upstream body against `responseMappings`.
+- The backend must not extract JSONPath rows, coerce schemas, or reshape the response merely
+  because a mapping exists.
+- If a mapping describes tabular interpretation, `contract` should be `core.tabular_frame@v1`.
+- If `rowsPath` is present, it should point to the array of row objects inside the operation
+  response.
+- If `fieldTypes` is present, it should cover the fields that frontend/editor tooling or future
+  transforms need for formatting and inference.
+- Time-series metadata is useful when the mapped rows are meant for charts, curves, or time-aware
   transforms.
 - If the response shape changes, update the response mapping in the same change.
-- Do not bind provider-native JSON directly to generic tabular consumers.
+- Do not claim provider-native JSON is safe for generic tabular consumers just because a
+  `responseMappings` entry exists.
+- If generic tabular widgets need to consume the operation directly today, return
+  `TabularFrameResponse` from the API operation.
 
 ## Canonical SDK Model
 
@@ -313,8 +328,9 @@ Related SDK models:
 - `TabularTimeSeriesMetaResponse`
 
 Use these models when the API operation returns the full canonical frame. If the provider operation
-returns provider-native JSON instead, keep the provider response model explicit and declare an exact
-`responseMappings` entry that maps it into `core.tabular_frame@v1`.
+returns provider-native JSON instead, keep the provider response model explicit. Add
+`responseMappings` only as metadata; do not treat it as runtime conversion into
+`core.tabular_frame@v1`.
 
 ## Required Decisions
 
@@ -327,9 +343,10 @@ Before implementing or revising an API for Adapter from API consumption, decide:
 5. Which operation IDs must remain stable?
 6. Which public config fields does the connection need?
 7. Which secrets does the connection need, and how does the backend inject them?
-8. Which operations produce generic tabular consumption?
-9. For each tabular operation, does the API return a full `core.tabular_frame@v1` document or a
-   provider-native response with an exact `responseMappings` entry?
+8. Which operations directly return a full `core.tabular_frame@v1` payload for generic tabular
+   consumption?
+9. For provider-native responses, is optional `responseMappings` metadata useful, and what explicit
+   transform or future feature would consume it?
 10. If the operation returns a full canonical frame, does it use `TabularFrameResponse` as the
     FastAPI `response_model`?
 
@@ -343,7 +360,8 @@ For a FastAPI provider:
 - expose a zero-argument health route
 - expose query operation routes with documented request parameters
 - declare every Command Center-callable operation in `availableOperations`
-- declare `core.tabular_frame@v1` response mappings for tabular consumption
+- declare `responseMappings` only as optional metadata when useful; do not rely on them for runtime
+  normalization
 - use `TabularFrameResponse` when an operation returns the full canonical frame
 - keep the API root, well-known contract, and OpenAPI document internally consistent
 
@@ -358,10 +376,11 @@ When reviewing an Adapter from API provider change, look for:
 - operations missing from `availableOperations`
 - operations exposed to Command Center without explicit allowlist metadata
 - secret values represented as public config or query payload fields
-- tabular responses without `core.tabular_frame@v1` response mappings
-- response mappings whose `rowsPath` no longer matches the API response
-- missing `fieldTypes` for fields consumed by widgets
-- API endpoints returning provider-native JSON directly to generic tabular consumers
+- provider-native responses being treated as `core.tabular_frame@v1` because a mapping exists
+- response mappings whose `rowsPath` no longer matches the API response when the mapping is present
+- missing `fieldTypes` for fields that declared mappings or future transforms need
+- API endpoints returning provider-native JSON directly to generic tabular consumers without an
+  explicit transform path
 - full canonical frame endpoints that do not use `TabularFrameResponse`
 - docs or README examples that disagree with the actual contract endpoint
 
@@ -380,10 +399,12 @@ Do not claim the API is consumable by Adapter from API until:
 - query-capable operations are explicitly marked as query-capable
 - public config and secret fields are separated
 - secret injection rules are backend-owned and explicit
-- each generic tabular operation declares `core.tabular_frame@v1`
+- each operation that must feed generic tabular consumers directly returns `core.tabular_frame@v1`
 - each full canonical frame operation uses `TabularFrameResponse`
-- each provider-native tabular response has an exact `rowsPath`
-- field types and time-series hints are present where consumers need them
+- provider-native responses are not represented as direct generic tabular outputs solely through
+  `responseMappings`
+- optional response mappings, when present, have accurate `rowsPath`, `fieldTypes`, and time-series
+  hints for their intended metadata or transform use
 - the local README documents the Command Center contract endpoints
 - any general FastAPI/API work has also followed `application_surfaces/api_surfaces`
 
@@ -396,8 +417,10 @@ Stop and surface the missing backend task when:
 - operation IDs cannot be made stable
 - auth requirements are unknown
 - secret injection cannot be described without exposing secret values
-- no exact response mapping exists for generic tabular consumption
-- the API response shape cannot be mapped to `core.tabular_frame@v1`
+- a provider-native response is being treated as generic tabular output only because
+  `responseMappings` exists
+- the API response shape must feed generic tabular consumers directly but cannot return
+  `TabularFrameResponse`
 - a full canonical frame endpoint cannot import or use `TabularFrameResponse`
 - backend Adapter from API runtime support is required but not implemented
 

{mainsequence-4.3.14 → mainsequence-4.3.19}/agent_scaffold/skills/command_center/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 input contracts, custom forms, form sections and field definitions, and the boundary between AppComponent input contracts 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 dashboards.
 ---
 
 # Command Center AppComponents
@@ -11,22 +11,23 @@ Use this skill when the task is about the backend contract behind a Command Cent
 
 This skill is for:
 
-- AppComponent input contracts
-- custom forms
+- AppComponent generated request form contracts
+- response-side editable form and notification contracts
 - field and section definitions
-- deciding when default argument resolution is enough
+- deciding when default request form generation is enough
 - deciding when a widget-facing API response must use an exact SDK contract
 - requiring API-backed AppComponents to depend on deployed FastAPI resources/releases, not local-only API code
 
 ## This Skill Can Do
 
-- decide whether an AppComponent should rely on the default generated form
-- create a custom `EditableFormDefinition`
+- decide whether an AppComponent should rely on the default generated request form
+- return an `EditableFormDefinition` response when the API should render a stateful editable response form
+- return a `NotificationDefinition` response when the API should render banner-style feedback
 - define `FormSectionDefinition`
 - define `FormFieldDefinition`
 - choose the correct `FormFieldKind`
 - define stable `token` values for fields
-- review whether an AppComponent form is too thin or too custom
+- review whether the request form or response UI contract is over- or under-specified
 - separate input contracts from output contracts
 - decide when the API behind an AppComponent must return exact widget-facing response models
 - verify the target widget type in the CLI registry before changing payload or contract logic
@@ -90,8 +91,10 @@ Before changing an AppComponent backend contract, collect or infer:
 - registry detail payload from:
   - `mainsequence cc registered_widget_type detail <WIDGET_ID> --json`
 - what the widget is trying to collect from the user
-- whether the default generated form is already sufficient
-- the fields, sections, and labels the form should expose
+- whether the default generated request form is already sufficient
+- whether the request form needs supported operation-level UI metadata such as `select2` async search
+- whether the response should render as a notification banner, an editable form session, or the generic response viewer
+- the fields, sections, labels, and tokens a response-side editable form should expose
 - whether the output is:
   - a generic API contract
   - an exact widget-facing contract
@@ -118,26 +121,27 @@ If registry detail is not sufficient, and only after checking the SDK client mod
 - `mainsequence/client/command_center/app_component.py`
 - `mainsequence/client/command_center/data_models.py`
 
-If the input contract or output contract is unclear, stop before building the form.
+If the request contract, response UI contract, or widget-facing output contract is unclear, stop before building the AppComponent contract.
 
 ## Required Decisions
 
 For every non-trivial AppComponent task, decide:
 
-1. Is the default generated form sufficient?
-2. If not, what requires a custom `EditableFormDefinition`?
-3. What are the stable field tokens?
-4. What field kinds should the frontend render?
-5. Is the output generic, or does it need an exact widget-facing response contract?
-6. If the AppComponent depends on a project API, does that API already exist as a FastAPI project resource with a FastAPI `ResourceRelease`?
+1. Is the default generated request form sufficient?
+2. If not, can the request-side need be handled by supported OpenAPI UI metadata such as `select2` async search?
+3. Should the response render as generic JSON/form output, a `NotificationDefinition`, or an `EditableFormDefinition` session?
+4. What are the stable field tokens for editable-form responses?
+5. What field kinds should the frontend render?
+6. Is the output generic, or does it need an exact widget-facing response contract?
+7. If the AppComponent depends on a project API, does that API already exist as a FastAPI project resource with a FastAPI `ResourceRelease`?
 
 ## Build Rules
 
-### 1. Default generated form first
+### 1. Default generated request form first
 
-Do not jump to a custom form by default.
+Do not jump to a response-side editable form by default.
 
-If the operation only exposes simple flat arguments with a straightforward shape, let Command Center resolve the form automatically.
+If the operation only exposes simple flat arguments with a straightforward shape, let Command Center resolve the request form automatically from OpenAPI parameters and request body schema.
 
 Typical cases where default generation is enough:
 
@@ -176,9 +180,14 @@ This skill does not create resources or releases. If the FastAPI project resourc
 
 Only return to AppComponent contract work once the backing API deployment surface is real on the platform.
 
-### 2. Use `EditableFormDefinition` only when the form needs to be specialized
+### 2. Use `EditableFormDefinition` only for response-side editable form sessions
 
-Use a custom form when the widget needs:
+`EditableFormDefinition` is a response model. Command Center renders it after the operation returns successfully when the selected operation's primary success response advertises:
+
+- `"x-ui-role": "editable-form"`
+- `"x-ui-widget": "definition-v1"`
+
+Use it when the response should become a stateful editable form session with:
 
 - grouped sections
 - domain-specific labels
@@ -186,7 +195,14 @@ Use a custom form when the widget needs:
 - more control over editable vs read-only behavior
 - stable custom tokens for bindings or draft state
 
-Do not use a custom form just to restate a trivial flat contract.
+Do not use `EditableFormDefinition` to define the pre-submit request form. Request inputs are generated from OpenAPI path, query, header, and JSON body metadata. If the request side needs richer behavior, use supported operation-level UI metadata instead of returning a form definition.
+
+The current supported request-side UI enhancement is:
+
+- `"x-ui-widget": "select2"`
+- `"x-ui-role": "async-select-search"`
+
+This enhancement is resolved from the selected OpenAPI operation metadata and currently targets query-parameter search helpers on that operation.
 
 ### 3. Treat tokens as stable identities
 
@@ -212,7 +228,10 @@ Example:
 
 Keep the boundary clear:
 
-- `EditableFormDefinition` and related form objects describe what the widget should collect
+- OpenAPI parameters and request body schemas describe what the widget should collect before execution
+- operation-level `select2` metadata can specialize supported request-side generated fields
+- `EditableFormDefinition` and related form objects describe a response-side editable form session
+- `NotificationDefinition` describes response-side banner feedback
 - `mainsequence.client.command_center.data_models.TabularFrameResponse` is the SDK canonical model for `core.tabular_frame@v1`
 - other SDK widget data models describe specialized widget-facing API responses when those exist
 
@@ -265,24 +284,37 @@ Do not use AppComponent as a shortcut source node for generic workspace data jus
 operation itself is the intended form-driven action or workflow producing the canonical tabular
 result.
 
-### 6.2 `x-ui-role` is what makes the contract render as richer UI
+### 6.2 `x-ui-role` is what makes supported contracts render as richer UI
 
-For AppComponent contracts, prefer SDK models whose OpenAPI schema carries the explicit UI role markers.
+For AppComponent response contracts, prefer SDK models whose OpenAPI schema carries the explicit UI role markers.
 
 The AppComponent should always try to implement:
 
-- `"x-ui-role": "editable-form"` for input-side contracts
-- `"x-ui-role": "notification"` for response-side contracts
+- `"x-ui-role": "editable-form"` with `"x-ui-widget": "definition-v1"` for response-side editable form sessions
+- `"x-ui-role": "notification"` with `"x-ui-widget": "banner-v1"` for response-side banner feedback
+
+For request-side generated form enhancements, the current supported operation-level contract is:
+
+- `"x-ui-role": "async-select-search"` with `"x-ui-widget": "select2"`
 
 These markers are not cosmetic. They are what tell Command Center to treat the payload as a richer UI contract instead of generic JSON.
 
 That means:
 
-- use `EditableFormDefinition` and related input models when the AppComponent needs a specialized input form
+- use OpenAPI parameters and request bodies for pre-submit inputs
+- use operation-level `select2` metadata when a request field should render as an async search input
+- use `EditableFormDefinition` and related models when the AppComponent response should render as a stateful editable form
 - use `NotificationDefinition` for response-side user feedback when the backend should return a banner-style notification
 - do not handcraft loose dictionaries for these cases when the SDK model already exists
 - keep input and response contracts separate instead of overloading one model to do both jobs
 
+Current frontend resolution details matter:
+
+- generated request forms come from OpenAPI path, query, header, and JSON body metadata
+- request-side `select2` metadata is read from the selected OpenAPI operation
+- response-side editable-form and notification metadata is read from the primary success response schema first, then from the operation metadata
+- placing these response UI markers only on the OpenAPI media-type or response object is not sufficient in the current frontend
+
 ### 6.3 AppComponent bindings are dynamic, port-to-port, and response-shape aware
 
 Treat AppComponent bindings as normal canonical widget bindings, not as a separate AppComponent-only
@@ -369,8 +401,8 @@ When reviewing an AppComponent task, look for:
 
 - inferred or guessed `widget_id` values
 - AppComponent work that skipped `registered_widget_type list/detail`
-- a custom form that should have been auto-generated
-- a flat autogenerated form that should have been specialized
+- a response-side editable form being used where the request form should simply be generated from OpenAPI
+- a flat autogenerated request form that should have used supported operation-level UI metadata
 - unstable or poorly named field tokens
 - wrong `FormFieldKind` choices
 - generic API output being used where an exact widget-facing contract should have been returned
@@ -388,14 +420,16 @@ Do not claim success until you have checked:
   - `mainsequence cc registered_widget_type list --json`
   - `mainsequence cc registered_widget_type detail <WIDGET_ID> --json`
 - registry detail was used as the first source of truth
-- the choice between autogenerated form and custom form is intentional
-- custom forms use `EditableFormDefinition`
+- the choice between autogenerated request form and supported request-side UI metadata is intentional
+- response-side editable forms use `EditableFormDefinition`
+- response-side notifications use `NotificationDefinition`
 - sections and fields are explicit where needed
 - field tokens are stable and meaningful
 - field kinds reflect business meaning
 - input and output contracts are not mixed together
-- input-side AppComponent contracts use `"x-ui-role": "editable-form"` when a specialized form is intended
-- response-side AppComponent contracts use `"x-ui-role": "notification"` when the API is returning user-facing banner feedback
+- request-side AppComponent enhancements use operation-level `"x-ui-role": "async-select-search"` with `"x-ui-widget": "select2"` when async search is intended
+- response-side AppComponent contracts use `"x-ui-role": "editable-form"` with `"x-ui-widget": "definition-v1"` when the API is returning a stateful editable form
+- response-side AppComponent contracts use `"x-ui-role": "notification"` with `"x-ui-widget": "banner-v1"` when the API is returning user-facing banner feedback
 - widget-facing outputs use exact SDK response models when applicable
 - generic tabular consumers receive `core.tabular_frame@v1`
 - AppComponent operations producing full canonical tabular frames use `TabularFrameResponse`
@@ -411,7 +445,8 @@ Do not claim success until you have checked:
 - the task depends on guessed widget behavior without registry verification
 - registry detail is insufficient and the required contract cannot be resolved from Main Sequence docs/models in this repository
 - the task is really about workspace structure instead of AppComponent contracts
-- the form contract is unclear but a custom form is being forced anyway
+- the request form contract is unclear but a response-side editable form is being forced anyway
+- the response UI contract is unclear but `EditableFormDefinition` or `NotificationDefinition` is being forced anyway
 - the widget-facing output contract is unclear and no exact SDK model is available
 - the task is really a generic API design problem rather than an AppComponent problem
 - the AppComponent depends on a project API that does not yet exist as a FastAPI resource and FastAPI `ResourceRelease`

{mainsequence-4.3.14 → mainsequence-4.3.19}/mainsequence/client/metatables/core.py

@@ -2375,6 +2375,23 @@ class DataNodeUpdate(TableUpdateNode, BaseObjectOrm):
 
         return depth_df
 
+    def clear_dependencies(self, timeout=None) -> dict[str, Any] | None:
+        url = self.get_object_url() + f"/{self._public_uid()}/clear-dependencies/"
+        payload = {"json": {}}
+        r = make_request(
+            s=self.build_session(),
+            loaders=self.LOADERS,
+            r_type="POST",
+            url=url,
+            payload=payload,
+            time_out=timeout,
+        )
+        if r.status_code not in (200, 204):
+            raise_for_response(r, payload=payload)
+        if not r.content:
+            return None
+        return r.json()
+
     @classmethod
     def get_upstream_nodes(cls, storage_hash, data_source_uid, timeout=None):
         s = cls.build_session()
@@ -3010,6 +3027,56 @@ class TimeIndexMetaTable(MetaTable):
                     descriptor[key] = cls._date_for_payload(descriptor[key])
         return normalized
 
+    def _identity_dimensions_from_time_indexed_profile(self) -> list[str]:
+        profile = self.time_indexed_profile
+        if profile is None:
+            raise ValueError(
+                "Cannot validate dimension_range_map because TimeIndexMetaTable "
+                "is missing time_indexed_profile."
+            )
+
+        time_index_name = str(profile.time_index_name)
+        index_names = [str(name) for name in profile.index_names]
+        if not time_index_name or not index_names:
+            raise ValueError(
+                "Cannot validate dimension_range_map because TimeIndexMetaTable "
+                "time_indexed_profile is missing time_index_name or index_names."
+            )
+        return [name for name in index_names if name != time_index_name]
+
+    def _validate_dimension_range_map_coordinates(
+        self,
+        dimension_range_map: list[dict[str, Any]] | None,
+    ) -> None:
+        if not dimension_range_map:
+            return
+
+        expected_dimensions = self._identity_dimensions_from_time_indexed_profile()
+        if not expected_dimensions:
+            return
+
+        for position, descriptor in enumerate(dimension_range_map):
+            coordinate = descriptor.get("coordinate") if isinstance(descriptor, Mapping) else None
+            provided_dimensions = (
+                [str(name) for name in coordinate.keys()]
+                if isinstance(coordinate, Mapping)
+                else []
+            )
+            provided_set = set(provided_dimensions)
+            missing_dimensions = [
+                dimension
+                for dimension in expected_dimensions
+                if dimension not in provided_set
+            ]
+            if missing_dimensions:
+                raise ValueError(
+                    "dimension_range_map coordinate is incomplete for "
+                    "TimeIndexMetaTable read. "
+                    f"Entry {position} expected identity dimensions "
+                    f"{expected_dimensions!r}; provided {provided_dimensions!r}; "
+                    f"missing {missing_dimensions!r}."
+                )
+
     def _build_dimension_payload(
         self,
         *,
@@ -3023,6 +3090,7 @@ class TimeIndexMetaTable(MetaTable):
         if index_coordinates is not None:
             payload["index_coordinates"] = index_coordinates
         if dimension_range_map is not None:
+            self._validate_dimension_range_map_coordinates(dimension_range_map)
             payload["dimension_range_map"] = self._normalize_dimension_range_map(
                 dimension_range_map
             )
@@ -3309,7 +3377,7 @@ class TimeIndexMetaTable(MetaTable):
                 )
                 if r.status_code != 200:
                     logger.warning(f"Error in request: {r.text}")
-                    return [], None
+                    raise_for_response(r, payload=payload)
 
                 response_data = r.json()
                 # Accumulate results

{mainsequence-4.3.14 → mainsequence-4.3.19}/mainsequence/meta_tables/data_nodes/data_nodes.py

@@ -807,12 +807,29 @@ class DataNode(DataAccessMixin, ABC):
             local_configuration=self.local_initial_configuration,
         )
 
-    def set_relation_tree(self):
+    def set_relation_tree(
+        self,
+        *,
+        force_rebuild: bool = False,
+        _visited_update_uids: set[str] | None = None,
+    ):
         """Sets the node relationships in the backend by calling the dependencies() method."""
 
         if self.local_persist_manager.data_node_update is None:
             self.verify_and_build_remote_objects()  #
-        if self.local_persist_manager.is_local_relation_tree_set():
+        data_node_update_uid = str(getattr(self.local_persist_manager.data_node_update, "uid", ""))
+        if _visited_update_uids is None:
+            _visited_update_uids = set()
+        if data_node_update_uid:
+            if data_node_update_uid in _visited_update_uids:
+                return
+            _visited_update_uids.add(data_node_update_uid)
+
+        if force_rebuild:
+            self.local_persist_manager.clear_dependencies()
+            self.depth_df = pd.DataFrame()
+            self.dependencies_df = None
+        elif self.local_persist_manager.is_local_relation_tree_set():
             return
         declared_dependencies = self.dependencies() or {}
 
@@ -827,7 +844,11 @@ class DataNode(DataAccessMixin, ABC):
             self.local_persist_manager.depends_on_connect(dependency_ts, is_api=is_api)
 
             # Recursively set the relation tree for the dependency
-            dependency_ts.set_relation_tree()
+            if not is_api:
+                dependency_ts.set_relation_tree(
+                    force_rebuild=force_rebuild,
+                    _visited_update_uids=_visited_update_uids,
+                )
 
         self.local_persist_manager.set_ogm_dependencies_linked()
 
@@ -996,7 +1017,7 @@ class DataNode(DataAccessMixin, ABC):
             self.logger.warning(f"{self} produced no new data in this update round.")
             return temp_df
 
-        if update_statistics_max_time_index is None and not SessionDataSource.is_local_db:
+        if update_statistics_max_time_index is not None and not SessionDataSource.is_local_db:
             temp_df = self.update_statistics.filter_df_by_latest_value(temp_df)
 
         if temp_df.empty: