mammoth-cli 2.0.56__tar.gz → 2.0.57__tar.gz

{mammoth_cli-2.0.56 → mammoth_cli-2.0.57}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.0.56
+Version: 2.0.57
 Summary: Command-line interface for the Mammoth Analytics platform
 Project-URL: homepage, https://mammoth.io
 Project-URL: repository, https://github.com/EdgeMetric/mammothsdk
@@ -17,7 +17,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: <3.15,>=3.12
 Requires-Dist: jsonschema>=4.20
 Requires-Dist: keyring<26,>=25.7
-Requires-Dist: mammoth-io<0.8,>=0.7.26
+Requires-Dist: mammoth-io<0.8,>=0.7.27
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.13
 Requires-Dist: pyyaml<7,>=6

{mammoth_cli-2.0.56 → mammoth_cli-2.0.57}/mammoth_cli/__init__.py

@@ -6,7 +6,7 @@ not implement a second HTTP client and does not call private SDK members.
 
 from __future__ import annotations
 
-__version__ = "2.0.56"
+__version__ = "2.0.57"
 
 # The versioned machine output envelope contract.
 SCHEMA_VERSION = 1

{mammoth_cli-2.0.56 → mammoth_cli-2.0.57}/mammoth_cli/app.py

@@ -64,7 +64,10 @@ _GROUP_DESCRIPTIONS = {
     "billing": "Manage billing and hosted checkout flows.",
     "browse": "Browse projects and workspace resources.",
     "capability": "Discover API operation support and policies.",
-    "client-app": "Manage client applications.",
+    "client-app": (
+        "Manage the workspace's API keys (client apps): key + secret credentials "
+        "for scripts and integrations."
+    ),
     "completion": "Install or print shell completion.",
     "config": "Read and update local CLI configuration.",
     "connector": "Manage data connectors and connector profiles.",
@@ -73,7 +76,7 @@ _GROUP_DESCRIPTIONS = {
     "dashboard": "Build, query, and publish dashboards.",
     "data-app": "Create and manage data applications.",
     "dataset": "Create, inspect, and manage datasets.",
-    "external-key": "Manage external keys.",
+    "external-key": "Manage LLM provider keys (OpenAI, Anthropic, etc.) used by AI features.",
     "file": "Upload and manage source files.",
     "folder": "Organize folders and their contents.",
     "job": "Inspect and wait for asynchronous jobs.",

{mammoth_cli-2.0.56 → mammoth_cli-2.0.57}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.0.56
+version: 2.0.57
 description: "Use Mammoth Analytics from a terminal: install or authenticate the CLI, discover its live command contract, and safely manage projects, data, views, pipelines (join, merge, pivot, filter, clean), dashboards, exports, and handoffs."
 ---
 

{mammoth_cli-2.0.56 → mammoth_cli-2.0.57}/mammoth_cli/commands/client_app.py

@@ -1,6 +1,7 @@
 """Handlers for the ``client-app`` command family.
 
-Client apps are workspace-level API credentials: none of the reviewed manifest
+Client apps are the workspace's API keys: the key + secret credentials a
+script or integration uses to call Mammoth. None of the reviewed manifest
 signatures in this family take a ``project_id`` argument, so no handler here
 requires an active project. The (optional) active project is still reported
 in the envelope metadata for context, mirroring the read handlers in
@@ -159,7 +160,11 @@ def _meta(invocation: Invocation, workspace_id: int, project_id: int | None) ->
 
 
 def client_app_list(invocation: Invocation) -> HandlerResult:
-    """List client apps in the active workspace (requires an admin role)."""
+    """List the workspace's API keys (client apps). Requires an admin role.
+
+    A client app IS the product's API key: the key + secret credentials a
+    script or integration uses to call Mammoth.
+    """
     document = _bound_document(invocation)
     kwargs: dict[str, Any] = {}
     _forward_optional(document, kwargs, ("limit", "offset", "fields", "sort"))
@@ -169,7 +174,7 @@ def client_app_list(invocation: Invocation) -> HandlerResult:
 
 
 def client_app_get(invocation: Invocation) -> HandlerResult:
-    """Get one client app by its client key."""
+    """Get one API key (client app) by its client key."""
     client_key = _require_string_positional(invocation, "client key")
     document = _bound_document(invocation)
     kwargs: dict[str, Any] = {"client_key": client_key}

{mammoth_cli-2.0.56 → mammoth_cli-2.0.57}/mammoth_cli/commands/external_key.py

@@ -108,14 +108,18 @@ def _meta(invocation: Invocation, workspace_id: int, project_id: int | None) ->
 
 
 def external_key_list(invocation: Invocation) -> HandlerResult:
-    """List all external API keys in the active workspace."""
+    """List the workspace's LLM provider keys (OpenAI, Anthropic, etc.).
+
+    Not the product's own API keys for scripts/integrations -- see
+    ``client-app.list`` for those.
+    """
     with open_service(invocation) as (service, auth):
         data = service.call(_symbol(invocation))
     return data, _meta(invocation, auth.workspace_id, resolved_project(invocation))
 
 
 def external_key_get(invocation: Invocation) -> HandlerResult:
-    """Get one external API key by id."""
+    """Get one LLM provider key by id."""
     key_id = _require_int_positional(invocation, "key id")
     with open_service(invocation) as (service, auth):
         data = service.call(_symbol(invocation), key_id=key_id)
@@ -153,7 +157,7 @@ def external_key_create(invocation: Invocation) -> HandlerResult:
 
 
 def external_key_delete(invocation: Invocation) -> HandlerResult:
-    """Permanently delete one external API key by id. Prompt or ``--yes`` required."""
+    """Permanently delete one LLM provider key by id. Prompt or ``--yes`` required."""
     key_id = _require_int_positional(invocation, "key id")
     enforce_confirmation(
         invocation, policy=POLICY_PROMPT_OR_YES, action=f"delete external key {key_id}"

{mammoth_cli-2.0.56 → mammoth_cli-2.0.57}/mammoth_cli/commands/schema.py

@@ -109,6 +109,13 @@ _COMMAND_DISCOVERY_PURPOSES = {
     "workspace.user.add": (
         "invite add member teammate email role editor viewer admin assign permission access"
     ),
+    # Client apps ARE the product's API keys: the key + secret credentials a
+    # script or integration uses to call Mammoth. Live-eval evidence: "list
+    # active API keys" only ever reached external-key.list (LLM provider
+    # keys), never this command, because nothing in its text said "API key".
+    "client-app.list": (
+        "api keys api key secret credentials workspace active script integration list"
+    ),
     "automation.create": (
         "schedule scheduled recurring repeat refresh rerun run every day daily week weekly "
         "hour hourly month monthly automatically trigger alert email a dataset pipeline"

{mammoth_cli-2.0.56 → mammoth_cli-2.0.57}/mammoth_cli/commands/workspace.py

@@ -292,10 +292,21 @@ def workspace_user_get(invocation: Invocation) -> HandlerResult:
     return data, _meta(invocation, auth.workspace_id)
 
 
+#: The backend field set that includes each user's roles and status.
+_USER_LIST_FIELDS = "__full"
+
+
 def workspace_user_list(invocation: Invocation) -> HandlerResult:
-    """List users in the client's own workspace."""
+    """List users in the client's own workspace, with their roles and status.
+
+    Asks for the backend's ``__full`` field set unless ``--input`` names another,
+    so each user carries ``user_roles`` and ``status``.
+    """
+    document = invocation.load_input() or {}
+    kwargs: dict[str, Any] = {"fields": _USER_LIST_FIELDS}
+    _forward_optional(document, kwargs, ("fields",))
     with open_service(invocation) as (service, auth):
-        data = service.call(_symbol(invocation))
+        data = service.call(_symbol(invocation), **kwargs)
     return data, _meta(invocation, auth.workspace_id)
 
 

{mammoth_cli-2.0.56 → mammoth_cli-2.0.57}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "mammoth-cli"
-version = "2.0.56"
+version = "2.0.57"
 description = "Command-line interface for the Mammoth Analytics platform"
 authors = [{name = "Mammoth Analytics", email = "support@mammoth.io"}]
 readme = "README.md"
 license = "LicenseRef-Proprietary"
 requires-python = ">=3.12,<3.15"
 dependencies = [
-    "mammoth-io (>=0.7.26,<0.8)",
+    "mammoth-io (>=0.7.27,<0.8)",
     "typer (>=0.27,<0.28)",
     "rich (>=15,<16)",
     "platformdirs (>=4.10,<5)",

{mammoth_cli-2.0.56 → mammoth_cli-2.0.57}/spec/manifests/sdk-methods.yaml

@@ -6297,7 +6297,7 @@ methods:
   reviewed_by: primary
 - sdk_symbol: mammoth.api.workspace.WorkspaceAPI.list_users
   implementation_origin: mammoth.api.workspace.WorkspaceAPI.list_users
-  signature: 'list_users(self, workspace_id: ''int | None'' = None) -> ''_list[dict[str, Any]]'''
+  signature: 'list_users(self, workspace_id: ''int | None'' = None, fields: ''str | None'' = None) -> ''_list[dict[str, Any]]'''
   openapi_operation_ids: []
   canonical_command: workspace.user.list
   alias_of: null