mammoth-cli 2.1.0__tar.gz → 2.1.2__tar.gz

{mammoth_cli-2.1.0 → mammoth_cli-2.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.1.0
+Version: 2.1.2
 Summary: Command-line interface for the Mammoth Analytics platform
 Project-URL: homepage, https://mammoth.io
 Project-URL: repository, https://github.com/EdgeMetric/mammothsdk

{mammoth_cli-2.1.0 → mammoth_cli-2.1.2}/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.1.0"
+__version__ = "2.1.2"
 
 # The versioned machine output envelope contract.
 SCHEMA_VERSION = 1

{mammoth_cli-2.1.0 → mammoth_cli-2.1.2}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -85,8 +85,8 @@ mammoth schema find "join two datasets; remove duplicates; build a dashboard"
 | Change a column's type | `view transform convert-type` |
 | Rename a column, sort the rows (view settings, not tasks) | `view transform rename-columns`, `view transform sort` |
 | Rank, running total, previous row | `view transform window` |
-| A dashboard | `dashboard v3 generate`, then `chat edit` ([dashboards](references/recipes/dashboards.md)) |
-| Deliver the rows | `view export csv`, `view export postgres` (and other destinations), `view export dataset` |
+| A dashboard, or its PDF or slides | `dashboard v3 generate`, then `chat edit` ([dashboards](references/recipes/dashboards.md)) |
+| Deliver the rows | `view export csv`, `view export postgres` (and more), `view export dataset` |
 | Run something on a schedule or on new data (refresh, append, alert) | `automation create`: a condition (`at_specific_time`, new file in a folder, ...) and tasks (`run_data_retrieval`, `append_data`, `send_an_alert`, `pull_cloud_files`). `schedule create` only pulls a connector's data. A dataset from an uploaded file or URL is a one-time copy with no source to refresh; say so. Recipe and caveats: [recurring work](references/recipes/scheduling.md) |
 
 Call a find result (or `suggestions` entry) from its `accepted_fields` and

{mammoth_cli-2.1.0 → mammoth_cli-2.1.2}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/dashboards.md

@@ -134,10 +134,24 @@ that canvas: `--input '{"widget_id": "WIDGET_UUID"}'` (optional
 descriptor with a `kind` (`scalar`, `group`, `rate`, `detail`, `options`,
 `range`); `{"kind":"scalar","agg":"count"}` is the smallest that runs.
 
-`dashboard pdf export` and `dashboard video export` cannot be completed from
-the CLI: the backend requires the browser-hydrated `DashboardData` map
-(pre-rendered widget results) in `params.data` and refuses to rebuild it. Report
-this as a known limitation instead of retrying with `{}`.
+There is NO slide/PowerPoint export. Never answer "turn this into a slide deck"
+by editing the user's board (`dashboard chat edit`, `canvas save`) into a
+"brief"; say plainly that a slide file is not possible and offer a PDF instead.
+
+PDF from the CLI:
+
+```bash
+mammoth dashboard pdf export DASHBOARD_ID --input '{"body":{"params":{"carousel":true}}}'
+# -> job_id; wait for it, then: mammoth dashboard pdf-artifact DASHBOARD_ID JOB_ID
+```
+
+`carousel:true` prints the board's narrative as 1080x1350 cards, one claim per
+card (the closest thing to a short deck), and needs no `params.data`. A layout
+print (no `carousel`) needs the browser-hydrated `DashboardData` map in
+`params.data` ONLY for `dashboard`/`qa` style boards; the backend refuses to
+rebuild it (HTTP 400 `params.data`). For that print, offer the carousel or tell
+the user to use Download PDF in the app; never retry with `{"data": {}}`.
+`dashboard video export` needs a motion-story dashboard.
 
 ## Publishing and the url routes
 

{mammoth_cli-2.1.0 → mammoth_cli-2.1.2}/mammoth_cli/bundled_skill/mammoth-cli/references/recovery.md

@@ -34,7 +34,7 @@ these commands are not blanket permission to replay a mutation.
 | `needs_view` in `file upload` result, or `status: ready` with `status_info.ready` "more than one plausible way to be read" and `view list` empty | all-text CSV: the platform ingests the rows but creates no view | run the `next_command` (`view create DATASET_ID`) once, then `view list DATASET_ID`; see recipes/need-action.md |
 | `need_action` in `file upload` result | the platform needs a parsing decision (e.g. ambiguous dates) | run the `next_command` it returns (`dataset file-settings get ID`), then `dataset file-settings update ID`; see recipes/need-action.md |
 | `confirmation_required` (exit 2) | destructive/high-impact command without `--yes` (and `--confirm TARGET` when policy is confirm_target) | re-run with the flag after you have read the target back by id |
-| `4GENR001 ... params.data` (HTTP 400) from `dashboard pdf export` | route needs a browser-rendered payload | not available from the CLI; report it, do not retry with `{"data": {}}` |
+| `4GENR001 ... params.data` (HTTP 400) from `dashboard pdf export` | route needs a browser-rendered payload | layout print of a dashboard-style board needs the browser payload; retry with `{"carousel":true}` (narrative cards, no data needed) or tell the user to use Download PDF in the app; do not retry with `{"data": {}}` |
 | `'destination'` KeyError in a `view export create` job with handler_type csv_file | generic export route is broken for CSV on release | use `view export csv` |
 | `timeout` / `outcome_unknown` (exit 7) | the request may have completed | run the envelope's `recovery_commands` first: `job get JOB_ID`, `project get ID` after a delete (repeat until `resource_not_found`), `dashboard list` after `create-blank` (look for your title), `dashboard canvas get ID` after a canvas or pages write. Else re-list the resource (`dataset list`, `view task list VIEW_ID DATASET_ID`) before any replay |
 | HTTP 502 / connection errors on every command | backend outage | `mammoth doctor`; wait and re-run doctor until it succeeds; do not replay mutations blindly |

{mammoth_cli-2.1.0 → mammoth_cli-2.1.2}/mammoth_cli/commands/activity.py

@@ -11,9 +11,15 @@ public SDK method named by the command's reviewed manifest ``sdk_symbol``.
 
 from __future__ import annotations
 
+import json
 from typing import Any
 
-from mammoth_cli.errors.envelope import CODE_SDK_SYMBOL_UNRESOLVED, EXIT_USAGE, CliError
+from mammoth_cli.errors.envelope import (
+    CODE_INVALID_ARGUMENT,
+    CODE_SDK_SYMBOL_UNRESOLVED,
+    EXIT_USAGE,
+    CliError,
+)
 from mammoth_cli.manifest.loader import command_by_id
 from mammoth_cli.runtime.invocation import Invocation
 from mammoth_cli.runtime.session import open_service, resolved_project
@@ -38,6 +44,16 @@ _LIST_OPTIONAL = (
     "search_text",
 )
 
+# How the activity log keys an entry's resource: ``<type>_<id>``. A bare id names no
+# type, so the backend's exact match on it finds nothing and reads as "no activity".
+_RESOURCE_TYPES = (
+    ("dataview", "a view"),
+    ("datasource", "a dataset"),
+    ("project", "a project"),
+    ("dashboard", "a dashboard"),
+    ("automation", "an automation"),
+)
+
 _EXPORT_OPTIONAL = (
     "format",
     "start_time",
@@ -97,6 +113,32 @@ def _forward_optional(
         kwargs[field] = value
 
 
+def _refuse_bare_resource_id(document: dict[str, Any]) -> None:
+    """Refuse a ``resource_id`` that is a bare id: it matches no log entry.
+
+    Raises:
+        CliError: ``invalid_argument`` naming each typed form, with the retry for a
+            view and for a dataset as recovery commands.
+    """
+    resource = str(document.get("resource_id", "")).strip()
+    if not resource.isdigit():
+        return
+    forms = "; ".join(f"{kind}_{resource} for {label}" for kind, label in _RESOURCE_TYPES)
+    retries = [
+        json.dumps({**document, "resource_id": f"{kind}_{resource}"})
+        for kind, _ in _RESOURCE_TYPES[:2]
+    ]
+    raise CliError(
+        code=CODE_INVALID_ARGUMENT,
+        message=(
+            f"resource_id {resource} is a bare id, which no activity entry has: the log"
+            f" keys each resource by its type — {forms}."
+        ),
+        exit_status=EXIT_USAGE,
+        recovery_commands=[f"mammoth activity list --input '{retry}'" for retry in retries],
+    )
+
+
 def _meta(invocation: Invocation, workspace_id: int, project_id: int | None) -> dict[str, Any]:
     """Build the common envelope metadata for an activity command.
 
@@ -118,6 +160,7 @@ def _meta(invocation: Invocation, workspace_id: int, project_id: int | None) ->
 def activity_list(invocation: Invocation) -> HandlerResult:
     """List activity logs in the active workspace, with optional filters."""
     document = _bound_document(invocation)
+    _refuse_bare_resource_id(document)
     kwargs: dict[str, Any] = {}
     _forward_optional(document, kwargs, _LIST_OPTIONAL)
     with open_service(invocation) as (service, auth):

{mammoth_cli-2.1.0 → mammoth_cli-2.1.2}/mammoth_cli/commands/dataset.py

@@ -146,43 +146,65 @@ def _require_string_positional(invocation: Invocation, name: str) -> str:
 _MAX_PROJECTS_SEARCHED = 100
 
 
+def _visible_projects(service: Any) -> list[dict[str, Any]]:
+    """The projects the credential can see (at most ``_MAX_PROJECTS_SEARCHED``)."""
+    listing = service.list_projects(limit=_MAX_PROJECTS_SEARCHED)
+    return list(listing.get("projects", [])) if isinstance(listing, dict) else []
+
+
+def _find_in_projects(
+    service: Any, needle: str, projects: list[dict[str, Any]]
+) -> list[dict[str, Any]]:
+    """Datasets whose name contains ``needle`` (case-insensitive), in each of ``projects``."""
+    matches: list[dict[str, Any]] = []
+    for project in projects:
+        project_id = project.get("id")
+        if project_id is None:
+            continue
+        response = service.call("mammoth.api.datasets.DatasetsAPI.list_all", project_id=project_id)
+        datasets = response.get("datasets", []) if isinstance(response, dict) else []
+        for dataset in datasets:
+            name = dataset.get("name") if isinstance(dataset, dict) else None
+            if isinstance(name, str) and needle in name.lower():
+                matches.append(
+                    {
+                        "project_id": project_id,
+                        "project_name": project.get("name"),
+                        "id": dataset.get("id"),
+                        "name": name,
+                    }
+                )
+    return matches
+
+
+def _other_projects(service: Any, project_id: int) -> list[dict[str, Any]]:
+    """Every visible project except ``project_id``."""
+    return [p for p in _visible_projects(service) if p.get("id") != project_id]
+
+
 def dataset_find(invocation: Invocation) -> HandlerResult:
     """Search dataset names for a substring across every visible project.
 
-    Read-only local composite: lists the projects the credential can see (or
-    just the one named by ``--project``), then lists datasets in each and
-    keeps a case-insensitive substring match. Does not require an active
-    project.
+    Read-only local composite: lists the projects the credential can see, then
+    lists datasets in each and keeps a case-insensitive substring match. With
+    ``--project`` that project is searched first, and the rest only when it holds
+    no match: the in-product agent runs every call under the project the user
+    last opened, which is often not the one the named dataset is in. Does not
+    require an active project.
     """
     name_substring = _require_string_positional(invocation, "name substring")
     needle = name_substring.lower()
-    matches: list[dict[str, Any]] = []
     with open_service(invocation) as (service, auth):
         if invocation.project is not None:
             projects: list[dict[str, Any]] = [{"id": invocation.project, "name": None}]
+            matches = _find_in_projects(service, needle, projects)
+            if not matches:
+                others = _other_projects(service, invocation.project)
+                matches = _find_in_projects(service, needle, others)
+                projects += others
         else:
-            listing = service.list_projects(limit=_MAX_PROJECTS_SEARCHED)
-            projects = list(listing.get("projects", [])) if isinstance(listing, dict) else []
-        for project in projects:
-            project_id = project.get("id")
-            if project_id is None:
-                continue
-            project_name = project.get("name")
-            response = service.call(
-                "mammoth.api.datasets.DatasetsAPI.list_all", project_id=project_id
-            )
-            datasets = response.get("datasets", []) if isinstance(response, dict) else []
-            for dataset in datasets:
-                name = dataset.get("name") if isinstance(dataset, dict) else None
-                if isinstance(name, str) and needle in name.lower():
-                    matches.append(
-                        {
-                            "project_id": project_id,
-                            "project_name": project_name,
-                            "id": dataset.get("id"),
-                            "name": name,
-                        }
-                    )
+            projects = _visible_projects(service)
+            matches = _find_in_projects(service, needle, projects)
         meta = {
             "profile": invocation.profile,
             "workspace_id": auth.workspace_id,
@@ -191,9 +213,7 @@ def dataset_find(invocation: Invocation) -> HandlerResult:
     return {
         "matches": matches,
         "projects_searched": len(projects),
-        "projects_truncated": (
-            invocation.project is None and len(projects) >= _MAX_PROJECTS_SEARCHED
-        ),
+        "projects_truncated": len(projects) >= _MAX_PROJECTS_SEARCHED,
     }, meta
 
 
@@ -240,8 +260,18 @@ def _dataset_name_search(
             sort=document.get("sort", "(created_at:desc)"),
             fields=DATASET_LIST_FIELDS,
         )
-    records = data.get("datasets", []) if isinstance(data, dict) else []
-    page = search_page(records, name, int(document.get("offset", 0)), document.get("limit"))
+        records = data.get("datasets", []) if isinstance(data, dict) else []
+        page = search_page(records, name, int(document.get("offset", 0)), document.get("limit"))
+        if page["matched"] == 0:
+            elsewhere = _find_in_projects(
+                service, name.lower(), _other_projects(service, project_id)
+            )
+            if elsewhere:
+                page["in_other_projects"] = elsewhere
+                page["note"] = (
+                    f"No dataset in project {project_id} matches; the ones listed in "
+                    "in_other_projects do. Run the next call with --project <its project_id>."
+                )
     page["name"] = name
     return page, _meta(invocation, auth.workspace_id, project_id)
 

{mammoth_cli-2.1.0 → mammoth_cli-2.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mammoth-cli"
-version = "2.1.0"
+version = "2.1.2"
 description = "Command-line interface for the Mammoth Analytics platform"
 authors = [{name = "Mammoth Analytics", email = "support@mammoth.io"}]
 readme = "README.md"

{mammoth_cli-2.1.0 → mammoth_cli-2.1.2}/spec/openapi/metadata.json

@@ -20,6 +20,6 @@
     "key (credential-shaped)"
   ],
   "schema_count": 864,
-  "sha256": "1c279542fe65426002ed4878ebc9b564b12335827083f2bb0011eb09803bd6d7",
+  "sha256": "31a0b89da93732ffd8e158529d81733aaa7437a19a0c4375133b89e080bd63a5",
   "source_url": "https://app.mammoth.io/api/v2/docs/openapi.json"
 }