mainsequence 4.0.9__tar.gz → 4.0.10__tar.gz

{mainsequence-4.0.9 → mainsequence-4.0.10}/PKG-INFO

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

{mainsequence-4.0.9 → mainsequence-4.0.10}/agent_scaffold/skills/data_publishing/data_nodes/SKILL.md

@@ -179,6 +179,26 @@ Rules:
 - Do not invent another schema object or parallel record declaration.
 - Prefer `DataNodeConfiguration.records` over overriding `get_column_metadata()` for normal nodes.
 
+### DataNode table metadata is discovery-critical
+
+Every production `DataNodeConfiguration` should set `node_metadata` with
+`DataNodeMetaData`. This is not decorative metadata. The `description` is used
+for embedding-based data discovery, so it must be written as a useful dataset
+description rather than a vague one-line label.
+
+Good `DataNodeMetaData.description` values should describe:
+
+- what real-world entity or process the dataset represents
+- the row grain and identity dimensions
+- the important measures or columns
+- the time coverage and expected update cadence when known
+- the source, assumptions, caveats, and intended analytical use
+- common search terms a user might use to find this dataset
+
+Keep `identifier` short and stable. Make `description` rich enough that a user
+searching semantically for the dataset can find it through the embedding model.
+Do not use the description for runtime controls or configuration.
+
 ### 8. Use `SourceTableForeignKey` when a DataNode references a MetaTable
 
 When a DataNode source table has a column that should reference a registered

{mainsequence-4.0.9 → mainsequence-4.0.10}/mainsequence/cli/api.py

@@ -3370,7 +3370,7 @@ def delete_secret(
 
 
 def list_secret_users_can_view(
-    secret_id: int | str,
+    secret_uid: int | str,
     *,
     timeout: int | None = None,
 ) -> dict[str, Any]:
@@ -3380,14 +3380,14 @@ def list_secret_users_can_view(
     return _get_shareable_object_access_state(
         module_name="mainsequence.client.models_tdag",
         class_name="Secret",
-        object_id=secret_id,
+        object_id=secret_uid,
         accessor_name="can_view",
         timeout=timeout,
     )
 
 
 def list_secret_users_can_edit(
-    secret_id: int | str,
+    secret_uid: int | str,
     *,
     timeout: int | None = None,
 ) -> dict[str, Any]:
@@ -3397,14 +3397,14 @@ def list_secret_users_can_edit(
     return _get_shareable_object_access_state(
         module_name="mainsequence.client.models_tdag",
         class_name="Secret",
-        object_id=secret_id,
+        object_id=secret_uid,
         accessor_name="can_edit",
         timeout=timeout,
     )
 
 
 def add_secret_user_to_view(
-    secret_id: int | str,
+    secret_uid: int | str,
     user_id: int | str,
     *,
     timeout: int | None = None,
@@ -3415,7 +3415,7 @@ def add_secret_user_to_view(
     return _mutate_shareable_object_access(
         module_name="mainsequence.client.models_tdag",
         class_name="Secret",
-        object_id=secret_id,
+        object_id=secret_uid,
         action_name="add_to_view",
         user_id=user_id,
         timeout=timeout,
@@ -3423,7 +3423,7 @@ def add_secret_user_to_view(
 
 
 def add_secret_user_to_edit(
-    secret_id: int | str,
+    secret_uid: int | str,
     user_id: int | str,
     *,
     timeout: int | None = None,
@@ -3434,7 +3434,7 @@ def add_secret_user_to_edit(
     return _mutate_shareable_object_access(
         module_name="mainsequence.client.models_tdag",
         class_name="Secret",
-        object_id=secret_id,
+        object_id=secret_uid,
         action_name="add_to_edit",
         user_id=user_id,
         timeout=timeout,
@@ -3442,7 +3442,7 @@ def add_secret_user_to_edit(
 
 
 def remove_secret_user_from_view(
-    secret_id: int | str,
+    secret_uid: int | str,
     user_id: int | str,
     *,
     timeout: int | None = None,
@@ -3453,7 +3453,7 @@ def remove_secret_user_from_view(
     return _mutate_shareable_object_access(
         module_name="mainsequence.client.models_tdag",
         class_name="Secret",
-        object_id=secret_id,
+        object_id=secret_uid,
         action_name="remove_from_view",
         user_id=user_id,
         timeout=timeout,
@@ -3461,7 +3461,7 @@ def remove_secret_user_from_view(
 
 
 def remove_secret_user_from_edit(
-    secret_id: int | str,
+    secret_uid: int | str,
     user_id: int | str,
     *,
     timeout: int | None = None,
@@ -3472,7 +3472,7 @@ def remove_secret_user_from_edit(
     return _mutate_shareable_object_access(
         module_name="mainsequence.client.models_tdag",
         class_name="Secret",
-        object_id=secret_id,
+        object_id=secret_uid,
         action_name="remove_from_edit",
         user_id=user_id,
         timeout=timeout,
@@ -3480,7 +3480,7 @@ def remove_secret_user_from_edit(
 
 
 def add_secret_team_to_view(
-    secret_id: int | str,
+    secret_uid: int | str,
     team_id: int | str,
     *,
     timeout: int | None = None,
@@ -3488,7 +3488,7 @@ def add_secret_team_to_view(
     return _mutate_shareable_object_team_access(
         module_name="mainsequence.client.models_tdag",
         class_name="Secret",
-        object_id=secret_id,
+        object_id=secret_uid,
         action_name="add_team_to_view",
         team_id=team_id,
         timeout=timeout,
@@ -3496,7 +3496,7 @@ def add_secret_team_to_view(
 
 
 def add_secret_team_to_edit(
-    secret_id: int | str,
+    secret_uid: int | str,
     team_id: int | str,
     *,
     timeout: int | None = None,
@@ -3504,7 +3504,7 @@ def add_secret_team_to_edit(
     return _mutate_shareable_object_team_access(
         module_name="mainsequence.client.models_tdag",
         class_name="Secret",
-        object_id=secret_id,
+        object_id=secret_uid,
         action_name="add_team_to_edit",
         team_id=team_id,
         timeout=timeout,
@@ -3512,7 +3512,7 @@ def add_secret_team_to_edit(
 
 
 def remove_secret_team_from_view(
-    secret_id: int | str,
+    secret_uid: int | str,
     team_id: int | str,
     *,
     timeout: int | None = None,
@@ -3520,7 +3520,7 @@ def remove_secret_team_from_view(
     return _mutate_shareable_object_team_access(
         module_name="mainsequence.client.models_tdag",
         class_name="Secret",
-        object_id=secret_id,
+        object_id=secret_uid,
         action_name="remove_team_from_view",
         team_id=team_id,
         timeout=timeout,
@@ -3528,7 +3528,7 @@ def remove_secret_team_from_view(
 
 
 def remove_secret_team_from_edit(
-    secret_id: int | str,
+    secret_uid: int | str,
     team_id: int | str,
     *,
     timeout: int | None = None,
@@ -3536,7 +3536,7 @@ def remove_secret_team_from_edit(
     return _mutate_shareable_object_team_access(
         module_name="mainsequence.client.models_tdag",
         class_name="Secret",
-        object_id=secret_id,
+        object_id=secret_uid,
         action_name="remove_team_from_edit",
         team_id=team_id,
         timeout=timeout,
@@ -3783,7 +3783,7 @@ def _mutate_labelable_object_labels(
 
 
 def list_constant_users_can_view(
-    constant_id: int | str,
+    constant_uid: int | str,
     *,
     timeout: int | None = None,
 ) -> dict[str, Any]:
@@ -3793,14 +3793,14 @@ def list_constant_users_can_view(
     return _get_shareable_object_access_state(
         module_name="mainsequence.client.models_tdag",
         class_name="Constant",
-        object_id=constant_id,
+        object_id=constant_uid,
         accessor_name="can_view",
         timeout=timeout,
     )
 
 
 def list_constant_users_can_edit(
-    constant_id: int | str,
+    constant_uid: int | str,
     *,
     timeout: int | None = None,
 ) -> dict[str, Any]:
@@ -3810,14 +3810,14 @@ def list_constant_users_can_edit(
     return _get_shareable_object_access_state(
         module_name="mainsequence.client.models_tdag",
         class_name="Constant",
-        object_id=constant_id,
+        object_id=constant_uid,
         accessor_name="can_edit",
         timeout=timeout,
     )
 
 
 def add_constant_user_to_view(
-    constant_id: int | str,
+    constant_uid: int | str,
     user_id: int | str,
     *,
     timeout: int | None = None,
@@ -3828,7 +3828,7 @@ def add_constant_user_to_view(
     return _mutate_shareable_object_access(
         module_name="mainsequence.client.models_tdag",
         class_name="Constant",
-        object_id=constant_id,
+        object_id=constant_uid,
         action_name="add_to_view",
         user_id=user_id,
         timeout=timeout,
@@ -3836,7 +3836,7 @@ def add_constant_user_to_view(
 
 
 def add_constant_user_to_edit(
-    constant_id: int | str,
+    constant_uid: int | str,
     user_id: int | str,
     *,
     timeout: int | None = None,
@@ -3847,7 +3847,7 @@ def add_constant_user_to_edit(
     return _mutate_shareable_object_access(
         module_name="mainsequence.client.models_tdag",
         class_name="Constant",
-        object_id=constant_id,
+        object_id=constant_uid,
         action_name="add_to_edit",
         user_id=user_id,
         timeout=timeout,
@@ -3855,7 +3855,7 @@ def add_constant_user_to_edit(
 
 
 def remove_constant_user_from_view(
-    constant_id: int | str,
+    constant_uid: int | str,
     user_id: int | str,
     *,
     timeout: int | None = None,
@@ -3866,7 +3866,7 @@ def remove_constant_user_from_view(
     return _mutate_shareable_object_access(
         module_name="mainsequence.client.models_tdag",
         class_name="Constant",
-        object_id=constant_id,
+        object_id=constant_uid,
         action_name="remove_from_view",
         user_id=user_id,
         timeout=timeout,
@@ -3874,7 +3874,7 @@ def remove_constant_user_from_view(
 
 
 def remove_constant_user_from_edit(
-    constant_id: int | str,
+    constant_uid: int | str,
     user_id: int | str,
     *,
     timeout: int | None = None,
@@ -3885,7 +3885,7 @@ def remove_constant_user_from_edit(
     return _mutate_shareable_object_access(
         module_name="mainsequence.client.models_tdag",
         class_name="Constant",
-        object_id=constant_id,
+        object_id=constant_uid,
         action_name="remove_from_edit",
         user_id=user_id,
         timeout=timeout,
@@ -3893,7 +3893,7 @@ def remove_constant_user_from_edit(
 
 
 def add_constant_team_to_view(
-    constant_id: int | str,
+    constant_uid: int | str,
     team_id: int | str,
     *,
     timeout: int | None = None,
@@ -3901,7 +3901,7 @@ def add_constant_team_to_view(
     return _mutate_shareable_object_team_access(
         module_name="mainsequence.client.models_tdag",
         class_name="Constant",
-        object_id=constant_id,
+        object_id=constant_uid,
         action_name="add_team_to_view",
         team_id=team_id,
         timeout=timeout,
@@ -3909,7 +3909,7 @@ def add_constant_team_to_view(
 
 
 def add_constant_team_to_edit(
-    constant_id: int | str,
+    constant_uid: int | str,
     team_id: int | str,
     *,
     timeout: int | None = None,
@@ -3917,7 +3917,7 @@ def add_constant_team_to_edit(
     return _mutate_shareable_object_team_access(
         module_name="mainsequence.client.models_tdag",
         class_name="Constant",
-        object_id=constant_id,
+        object_id=constant_uid,
         action_name="add_team_to_edit",
         team_id=team_id,
         timeout=timeout,
@@ -3925,7 +3925,7 @@ def add_constant_team_to_edit(
 
 
 def remove_constant_team_from_view(
-    constant_id: int | str,
+    constant_uid: int | str,
     team_id: int | str,
     *,
     timeout: int | None = None,
@@ -3933,7 +3933,7 @@ def remove_constant_team_from_view(
     return _mutate_shareable_object_team_access(
         module_name="mainsequence.client.models_tdag",
         class_name="Constant",
-        object_id=constant_id,
+        object_id=constant_uid,
         action_name="remove_team_from_view",
         team_id=team_id,
         timeout=timeout,
@@ -3941,7 +3941,7 @@ def remove_constant_team_from_view(
 
 
 def remove_constant_team_from_edit(
-    constant_id: int | str,
+    constant_uid: int | str,
     team_id: int | str,
     *,
     timeout: int | None = None,
@@ -3949,7 +3949,7 @@ def remove_constant_team_from_edit(
     return _mutate_shareable_object_team_access(
         module_name="mainsequence.client.models_tdag",
         class_name="Constant",
-        object_id=constant_id,
+        object_id=constant_uid,
         action_name="remove_team_from_edit",
         team_id=team_id,
         timeout=timeout,

{mainsequence-4.0.9 → mainsequence-4.0.10}/mainsequence/cli/cli.py

@@ -6626,7 +6626,7 @@ def secrets_delete_cmd(
 
 @secrets.command("can_view")
 def secrets_can_view_cmd(
-    secret_id: str = typer.Argument(..., help="Secret UID."),
+    secret_uid: str = typer.Argument(..., help="Secret UID."),
     timeout: int | None = typer.Option(None, "--timeout", help="Request timeout in seconds"),
 ):
     """
@@ -6637,21 +6637,21 @@ def secrets_can_view_cmd(
     Examples
     --------
     ```bash
-    mainsequence secrets can_view 42
+    mainsequence secrets can_view 498d499f-b74c-43f7-acf1-2e2955ad0e6b
     ```
     """
     _shareable_user_list_impl(
         fetch_fn=list_secret_users_can_view,
         object_label="Secret",
         access_label="view",
-        object_id=secret_id,
+        object_id=secret_uid,
         timeout=timeout,
     )
 
 
 @secrets.command("can_edit")
 def secrets_can_edit_cmd(
-    secret_id: str = typer.Argument(..., help="Secret UID."),
+    secret_uid: str = typer.Argument(..., help="Secret UID."),
     timeout: int | None = typer.Option(None, "--timeout", help="Request timeout in seconds"),
 ):
     """
@@ -6662,21 +6662,21 @@ def secrets_can_edit_cmd(
     Examples
     --------
     ```bash
-    mainsequence secrets can_edit 42
+    mainsequence secrets can_edit 498d499f-b74c-43f7-acf1-2e2955ad0e6b
     ```
     """
     _shareable_user_list_impl(
         fetch_fn=list_secret_users_can_edit,
         object_label="Secret",
         access_label="edit",
-        object_id=secret_id,
+        object_id=secret_uid,
         timeout=timeout,
     )
 
 
 @secrets.command("add_to_view")
 def secrets_add_to_view_cmd(
-    secret_id: str = typer.Argument(..., help="Secret UID."),
+    secret_uid: str = typer.Argument(..., help="Secret UID."),
     user_id: int = typer.Argument(..., help="User ID to grant view access."),
     timeout: int | None = typer.Option(None, "--timeout", help="Request timeout in seconds"),
 ):
@@ -6686,14 +6686,14 @@ def secrets_add_to_view_cmd(
     Examples
     --------
     ```bash
-    mainsequence secrets add_to_view 42 7
+    mainsequence secrets add_to_view 498d499f-b74c-43f7-acf1-2e2955ad0e6b 7
     ```
     """
     _shareable_user_access_update_impl(
         action_fn=add_secret_user_to_view,
         object_label="Secret",
         action_label="add_to_view",
-        object_id=secret_id,
+        object_id=secret_uid,
         user_id=user_id,
         timeout=timeout,
     )
@@ -6701,7 +6701,7 @@ def secrets_add_to_view_cmd(
 
 @secrets.command("add_to_edit")
 def secrets_add_to_edit_cmd(
-    secret_id: str = typer.Argument(..., help="Secret UID."),
+    secret_uid: str = typer.Argument(..., help="Secret UID."),
     user_id: int = typer.Argument(..., help="User ID to grant edit access."),
     timeout: int | None = typer.Option(None, "--timeout", help="Request timeout in seconds"),
 ):
@@ -6711,14 +6711,14 @@ def secrets_add_to_edit_cmd(
     Examples
     --------
     ```bash
-    mainsequence secrets add_to_edit 42 7
+    mainsequence secrets add_to_edit 498d499f-b74c-43f7-acf1-2e2955ad0e6b 7
     ```
     """
     _shareable_user_access_update_impl(
         action_fn=add_secret_user_to_edit,
         object_label="Secret",
         action_label="add_to_edit",
-        object_id=secret_id,
+        object_id=secret_uid,
         user_id=user_id,
         timeout=timeout,
     )
@@ -6726,7 +6726,7 @@ def secrets_add_to_edit_cmd(
 
 @secrets.command("remove_from_view")
 def secrets_remove_from_view_cmd(
-    secret_id: str = typer.Argument(..., help="Secret UID."),
+    secret_uid: str = typer.Argument(..., help="Secret UID."),
     user_id: int = typer.Argument(..., help="User ID to remove explicit view access from."),
     timeout: int | None = typer.Option(None, "--timeout", help="Request timeout in seconds"),
 ):
@@ -6736,14 +6736,14 @@ def secrets_remove_from_view_cmd(
     Examples
     --------
     ```bash
-    mainsequence secrets remove_from_view 42 7
+    mainsequence secrets remove_from_view 498d499f-b74c-43f7-acf1-2e2955ad0e6b 7
     ```
     """
     _shareable_user_access_update_impl(
         action_fn=remove_secret_user_from_view,
         object_label="Secret",
         action_label="remove_from_view",
-        object_id=secret_id,
+        object_id=secret_uid,
         user_id=user_id,
         timeout=timeout,
     )
@@ -6751,7 +6751,7 @@ def secrets_remove_from_view_cmd(
 
 @secrets.command("remove_from_edit")
 def secrets_remove_from_edit_cmd(
-    secret_id: str = typer.Argument(..., help="Secret UID."),
+    secret_uid: str = typer.Argument(..., help="Secret UID."),
     user_id: int = typer.Argument(..., help="User ID to remove explicit edit access from."),
     timeout: int | None = typer.Option(None, "--timeout", help="Request timeout in seconds"),
 ):
@@ -6761,14 +6761,14 @@ def secrets_remove_from_edit_cmd(
     Examples
     --------
     ```bash
-    mainsequence secrets remove_from_edit 42 7
+    mainsequence secrets remove_from_edit 498d499f-b74c-43f7-acf1-2e2955ad0e6b 7
     ```
     """
     _shareable_user_access_update_impl(
         action_fn=remove_secret_user_from_edit,
         object_label="Secret",
         action_label="remove_from_edit",
-        object_id=secret_id,
+        object_id=secret_uid,
         user_id=user_id,
         timeout=timeout,
     )
@@ -6776,7 +6776,7 @@ def secrets_remove_from_edit_cmd(
 
 @secrets.command("add_team_to_view")
 def secrets_add_team_to_view_cmd(
-    secret_id: str = typer.Argument(..., help="Secret UID."),
+    secret_uid: str = typer.Argument(..., help="Secret UID."),
     team_id: int = typer.Argument(..., help="Team ID to grant view access."),
     timeout: int | None = typer.Option(None, "--timeout", help="Request timeout in seconds"),
 ):
@@ -6784,7 +6784,7 @@ def secrets_add_team_to_view_cmd(
         action_fn=add_secret_team_to_view,
         object_label="Secret",
         action_label="add_team_to_view",
-        object_id=secret_id,
+        object_id=secret_uid,
         team_id=team_id,
         timeout=timeout,
     )
@@ -6792,7 +6792,7 @@ def secrets_add_team_to_view_cmd(
 
 @secrets.command("add_team_to_edit")
 def secrets_add_team_to_edit_cmd(
-    secret_id: str = typer.Argument(..., help="Secret UID."),
+    secret_uid: str = typer.Argument(..., help="Secret UID."),
     team_id: int = typer.Argument(..., help="Team ID to grant edit access."),
     timeout: int | None = typer.Option(None, "--timeout", help="Request timeout in seconds"),
 ):
@@ -6800,7 +6800,7 @@ def secrets_add_team_to_edit_cmd(
         action_fn=add_secret_team_to_edit,
         object_label="Secret",
         action_label="add_team_to_edit",
-        object_id=secret_id,
+        object_id=secret_uid,
         team_id=team_id,
         timeout=timeout,
     )
@@ -6808,7 +6808,7 @@ def secrets_add_team_to_edit_cmd(
 
 @secrets.command("remove_team_from_view")
 def secrets_remove_team_from_view_cmd(
-    secret_id: str = typer.Argument(..., help="Secret UID."),
+    secret_uid: str = typer.Argument(..., help="Secret UID."),
     team_id: int = typer.Argument(..., help="Team ID to remove explicit view access from."),
     timeout: int | None = typer.Option(None, "--timeout", help="Request timeout in seconds"),
 ):
@@ -6816,7 +6816,7 @@ def secrets_remove_team_from_view_cmd(
         action_fn=remove_secret_team_from_view,
         object_label="Secret",
         action_label="remove_team_from_view",
-        object_id=secret_id,
+        object_id=secret_uid,
         team_id=team_id,
         timeout=timeout,
     )
@@ -6824,7 +6824,7 @@ def secrets_remove_team_from_view_cmd(
 
 @secrets.command("remove_team_from_edit")
 def secrets_remove_team_from_edit_cmd(
-    secret_id: str = typer.Argument(..., help="Secret UID."),
+    secret_uid: str = typer.Argument(..., help="Secret UID."),
     team_id: int = typer.Argument(..., help="Team ID to remove explicit edit access from."),
     timeout: int | None = typer.Option(None, "--timeout", help="Request timeout in seconds"),
 ):
@@ -6832,7 +6832,7 @@ def secrets_remove_team_from_edit_cmd(
         action_fn=remove_secret_team_from_edit,
         object_label="Secret",
         action_label="remove_team_from_edit",
-        object_id=secret_id,
+        object_id=secret_uid,
         team_id=team_id,
         timeout=timeout,
     )