mammoth-cli 2.2.93__tar.gz → 2.2.95__tar.gz

{mammoth_cli-2.2.93 → mammoth_cli-2.2.95}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.2.93
+Version: 2.2.95
 Summary: Command-line interface for the Mammoth Analytics platform
 Project-URL: homepage, https://mammoth.io
 Project-URL: repository, https://github.com/EdgeMetric/mammothsdk
@@ -18,7 +18,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.9,>=0.8.46
+Requires-Dist: mammoth-io<0.9,>=0.8.48
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.12.5
 Requires-Dist: pyyaml<7,>=6

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

{mammoth_cli-2.2.93 → mammoth_cli-2.2.95}/mammoth_cli/app.py

@@ -82,7 +82,6 @@ _GROUP_DESCRIPTIONS = {
     "log": "Locate and read the local run log.",
     "context": "Inspect and select the active project context.",
     "dashboard": "Build, query, and publish dashboards.",
-    "data-app": "Create and manage data applications.",
     "dataset": "Create, inspect, and manage datasets.",
     "external-key": "Manage LLM provider keys (OpenAI, Anthropic, etc.) used by AI features.",
     "file": (
@@ -115,19 +114,12 @@ _GROUP_DESCRIPTIONS = {
 
 # One line per ``agent`` subgroup, so ``mammoth agent --help`` tells them apart.
 _AGENT_SUBGROUP_DESCRIPTIONS = {
-    "access": "Set who may use an agent definition.",
+    "access": "Grant, request and review access to the Mammoth agent, and its settings.",
     "action": "List and delete the changes an agent chat made.",
-    "charter": "Read, change and restore an agent definition's charter.",
-    "feedback": "Read the feedback an agent definition has received.",
-    "goldens": "Manage and run the golden cases an agent definition is proven against.",
-    "memory": "Manage the facts an agent definition has learned, per project.",
     "message": "Correct the request kind of a reply in an agent chat.",
     "plan": "Approve, skip or discard the plan of an agent chat, or edit its workflow proposal.",
-    "projects": "Set or clear the projects an agent definition works in.",
     "run": "Inspect and control an agent's runs.",
-    "scratch": "Read, write and clear an agent definition's scratchpad notes per project.",
     "session": "List, read, delete and share agent chat sessions.",
-    "team": "Set the agents this agent may consult while answering.",
     "turn": "Control one turn of an agent chat session.",
 }
 
@@ -148,6 +140,7 @@ _SUBGROUP_DESCRIPTIONS = {
     "auth connected-apps": "List and revoke the apps you have authorised.",
     "billing invoice": "List and charge invoices.",
     "billing stripe": "Manage the Stripe subscription: checkout, trial, payment methods, invoices.",
+    "billing stripe held-change": "Read or cancel a held plan change.",
     "billing stripe payment-method": "List, delete and default Stripe payment methods.",
     "billing stripe storage": "Set the Stripe storage tier.",
     "billing subscription": "Read and update the subscription.",
@@ -157,16 +150,22 @@ _SUBGROUP_DESCRIPTIONS = {
     "collection email-updates": "Read and set a collection's email updates, and send a test.",
     "collection email-updates me": "Read and set your own email updates for a collection.",
     "collection members": "Remove members from a collection.",
+    "automation route": "Preview and set which automation a watched folder's file goes to.",
+    "automation run-file": "Act on a file an automation run held back.",
     "connector ai": "Chat with the connector assistant to set up a connection.",
     "connector ai session": "List connector assistant sessions and their messages.",
     "connector connection": "Create, read, update and delete connector connections.",
+    "connector draft": "Build a connector step by step: sources, gaps, sample, then save.",
+    "connector draft source": "List a draft's sources, preview them and find join keys.",
     "connector ds-config": "Create, read, update and delete data-source configs.",
     "connector query": "Generate connector queries and check their status.",
     "context project": "Show, select or clear the active project.",
     "dashboard audience": "Read who views a dashboard and its digest.",
     "dashboard audience digest": "Read and set the audience digest of a dashboard.",
     "dashboard canvas": "Read, save and restore a dashboard canvas.",
+    "dashboard chart-type": "List, create and delete the workspace's own chart types.",
     "dashboard chat": "Edit a dashboard by chat and read the chat history.",
+    "dashboard chat attachment": "Upload a file to a dashboard's chat.",
     "dashboard context": "Create, review, apply and manage dashboard contexts.",
     "dashboard data": "Read the data behind a dashboard, draft or published.",
     "dashboard embed": "Manage dashboard embedding: keys, origins, tokens and usage.",
@@ -182,14 +181,14 @@ _SUBGROUP_DESCRIPTIONS = {
     "dashboard embed usage": "Read embed usage and its summary.",
     "dashboard engagement": "Read a dashboard's engagement and remind its viewers.",
     "dashboard exemplar": "Extract an exemplar from a dashboard.",
-    "dashboard figure": "Add figures to a dashboard.",
+    "dashboard figure": "Add, describe and read the data behind dashboard figures.",
     "dashboard filter": "Add, list and remove dashboard filters.",
     "dashboard gallery": "List and read gallery dashboards.",
     "dashboard own-data": "Start, check and finish a dashboard's own-data setup.",
     "dashboard page": "Plan dashboard pages.",
     "dashboard pages": "Add pages to a dashboard.",
     "dashboard pdf": "Export a dashboard as a PDF.",
-    "dashboard published": "Read and export a published dashboard.",
+    "dashboard published": "Read, drill into and export a published dashboard.",
     "dashboard published pdf": "Export a published dashboard as a PDF.",
     "dashboard published video": "Export a published dashboard as a video.",
     "dashboard qa": "Ask questions of a dashboard and manage the Q&A sessions.",
@@ -214,11 +213,11 @@ _SUBGROUP_DESCRIPTIONS = {
     "dashboard templates": "Use or list pending dashboard templates.",
     "dashboard v3": "Generate v3 dashboards.",
     "dashboard video": "Export a dashboard as a video.",
-    "data-app user": "List and remove the users of a data app.",
     "dataset broken-rows": "List and resolve rows that failed to load.",
     "dataset definition": "List, save and remove what terms mean for a dataset.",
     "dataset file-settings": "Read, update and undo a dataset's file settings.",
     "dataset interpretation": "Preview and confirm how a file is interpreted.",
+    "dataset tool-claim": "Read an emailed Open tables link and add its tables to a project.",
     "parameter group": "Create, list, update, reorder and delete parameter groups.",
     "project checkpoint": "List project checkpoints.",
     "project data-check": "List project data checks.",
@@ -226,11 +225,17 @@ _SUBGROUP_DESCRIPTIONS = {
     "project resource-dependencies": "Update project resource dependencies.",
     "project user": "Add, update and remove project users.",
     "skill agents-md": "Install the agent instructions file.",
+    "support billing": "Trials, plan changes, payment retries, refunds and cancellations.",
     "support connector": "Create, list, update and delete connectors.",
     "support connector-profile": "Manage connector profiles and their connectors.",
+    "support deal": "Create, read and update deals, and move them to partners.",
+    "support entitlement": "Read the entitlement registry.",
     "support feature": "Create, list, update and delete features.",
     "support feature-profile": "Manage feature profiles and their features.",
+    "support identity": "List and read users across workspaces.",
     "support ownership": "Transfer ownership.",
+    "support partner": "Create, read and update partners, and manage their billing and invoices.",
+    "support partner client": "List, delete and detach (or cancel detaching) a partner's clients.",
     "support plan": "Manage billing plans.",
     "support plan storage-option": "Manage a plan's storage options.",
     "support subscription": "Create, read and update subscriptions.",
@@ -238,13 +243,16 @@ _SUBGROUP_DESCRIPTIONS = {
     "support template thumbnail": "Set and clear a template thumbnail.",
     "support user": "List, register and update users.",
     "support workspace": "Manage workspaces: create, suspend, restore and delete.",
+    "support workspace invite": "Cancel or resend a workspace invite.",
     "support workspace user": "Add, list, remove and transfer workspace users.",
     "user avatar": "Upload or delete the avatar.",
     "user preference": "Read and update user preferences.",
     "view active-user": "List the users active on a view and mark activity.",
     "view ai": "AI profile and generated data for a view.",
     "view checkpoint": "Create, list, update and delete view checkpoints.",
-    "view conditional-format": "Create, list, update and delete conditional formats.",
+    "view column": "Set how a view's columns look.",
+    "view column format": "Set how columns display: date or number format.",
+    "view conditional-format": "Create, list, update, replace and delete conditional formats.",
     "view data": "Read, query, aggregate, compare and profile a view's data.",
     "view data-check": "Create, list, update and delete data checks on a view.",
     "view derivative": "Create, list, update and delete derivative views.",
@@ -296,7 +304,6 @@ _ROOT_HELP_PANELS = {
     "batch": "Work with data",
     "dashboard": "Build and share",
     "collection": "Build and share",
-    "data-app": "Build and share",
     "report": "Build and share",
     "template": "Build and share",
     "snippet": "Build and share",
@@ -321,6 +328,7 @@ _ROOT_HELP_PANELS = {
     "activity": "Manage resources",
     "support": "Manage resources",
     "config": "CLI and agent tools",
+    "run": "CLI and agent tools",
     "completion": "CLI and agent tools",
     "skill": "CLI and agent tools",
     "log": "CLI and agent tools",
@@ -1421,9 +1429,26 @@ def _indexed_summary(command_id: str) -> str | None:
     return _summary_index().get(command_id)
 
 
+def _sdk_backed(command_id: str) -> bool:
+    """Whether the command's help comes from an SDK method's docstring."""
+    from mammoth_cli.commands.registry import _TARGETS
+
+    return _TARGETS.get(command_id, "").endswith(":generated_dashboard")
+
+
 #: A line of ``--help`` a command needs that its handler's shared docstring cannot carry.
 _RAW_NOTE = "Input field raw: true returns DATE values with their time, not the date alone."
+_RUN_HELP_NOTE = (
+    'One command per line: {"cmd": "view task list", "args": ["290"], "input": {}, '
+    '"flags": {"project": 1}, "id": "a"}. cmd is the command path, args its positionals, '
+    "input its --input document, flags the global flags by long name (yes, confirm, dry-run, "
+    "project). Prints each line's envelope plus line, cmd and exit, then a summary; stops at "
+    "the first failed line (exit = its status) unless --continue. No global --yes: a "
+    "mutating line carries its own. --dry-run, --profile and --project apply to every line. "
+    "FILE defaults to stdin; --continue may come before or after it."
+)
 _HELP_NOTES = {
+    "run": _RUN_HELP_NOTE,
     "view.data.get": _RAW_NOTE,
     "view.data.query": _RAW_NOTE,
     "view.export.dataset": (
@@ -1452,7 +1477,11 @@ def _command_help(command_id: str, record: dict[str, Any] | None) -> str | None:
     from mammoth_cli.commands.schema import IN_PLACE_RECIPE, edits_view_in_place
 
     parts: list[str] = []
-    summary = live_command_summary(command_id)
+    # The generated index equals the handler's docstring (a unit test pins it) and reading it
+    # keeps the handler's module, and the SDK it imports, out of ``--help``. A command built from
+    # an SDK method reads it live: the installed SDK may be newer than the index.
+    summary = None if _sdk_backed(command_id) else _indexed_summary(command_id)
+    summary = summary or live_command_summary(command_id)
     if summary:
         parts.append(summary)
     if record is not None and edits_view_in_place(record):
@@ -1617,7 +1646,9 @@ def _lazy_leaf_command(command_id: str) -> type[TyperCommand]:
                 info = CommandInfo(
                     name=self.name,
                     callback=_build_leaf(command_id),
-                    help=_command_help(command_id, command_by_id(command_id)),
+                    # The help text is read from this class's lazy ``help`` property; building
+                    # it here would import the contract and schema layers on every run.
+                    help="",
                     rich_help_panel=self.rich_help_panel,
                     context_settings=_leaf_context_settings(command_id),
                 )
@@ -1751,6 +1782,11 @@ _ROOT_LEAF_HELP: dict[str, str] = {
         "Say what NAME refers to: a dataset, a view or a project, with ids and projects."
         "\n\nExample: mammoth resolve uqa-w29-ren\n\nInput fields: all_projects (bool)"
     ),
+    "run": (
+        "Run many commands in one process: JSON Lines of cmd, args, input and flags."
+        f"\n\n{_RUN_HELP_NOTE}"
+        "\n\nExample: mammoth run commands.jsonl"
+    ),
     "upgrade": (
         "Upgrade the mammoth CLI to the latest (or a specified) version from PyPI."
         "\n\nExample: mammoth upgrade --yes"

{mammoth_cli-2.2.93 → mammoth_cli-2.2.95}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.2.93
+version: 2.2.95
 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."
 ---
 
@@ -192,7 +192,7 @@ your report. If no column links the files, ask before you combine them.
   a web-app task you cannot find in the CLI:** [about Mammoth](references/about-mammoth.md)
 - **Cold start, task plan, or unsupported route:** [task start](references/task-start.md)
 - **Login, profiles, and authorized scope:** [auth](references/auth.md)
-- **Nested input, output envelopes, confirmations, jobs, or recovery:**
+- **Input, envelopes, `mammoth run` (batch), confirmations, jobs, recovery:**
   [input](references/input.md), [machine output](references/machine-output.md),
   [safety](references/safety.md), or [jobs and drafts](references/jobs-drafts.md)
 - **Import, resources, transforms, pipelines, dashboards, exports, or cleanup:**

{mammoth_cli-2.2.93 → mammoth_cli-2.2.95}/mammoth_cli/bundled_skill/mammoth-cli/references/capabilities-misc.md

@@ -78,10 +78,6 @@ Ran once: `connector.active`, `connector.ai.session.list`, `connector.list`
 | `connector.query.generate` | observed blocker | blocked_missing_fixture: No real connector connection exists in workspace 4 (connector.list shows all is_added:false; connector.active returns []), matching the documented capabili |
 | `connector.query.status` | observed blocker | blocked_missing_fixture: No real connector connection exists in workspace 4 (connector list shows all is_added:false; connector active returns []) and creating one requires externa |
 
-## `data-app`
-
-Ran once: `data-app.list`
-
 ## `external-key`
 
 Ran once: `external-key.list`

{mammoth_cli-2.2.93 → mammoth_cli-2.2.95}/mammoth_cli/bundled_skill/mammoth-cli/references/capabilities.md

@@ -1,7 +1,7 @@
 # What is proven on release
 
 Generated from `docs/release-capability-matrix.json`; do not edit by hand.
-The CLI publishes 785 commands. 516 of them bind one of the 545 API operations in the matrix; the remainder are local commands (`schema`, `auth`, `doctor`, `log`, ...) or typed variants that share an operation (`view transform *` commands submit through `view.task.add`, except `rename-columns` and `sort`, which set view display properties through `view.update`). 262 bound commands ran once successfully on release, 1 are not supported there, and the rest are untried. Untried is not broken: discover the contract with `mammoth schema get COMMAND_ID`, run it, and treat the structured error envelope as the answer. Use an untried command normally: confirm a write with the user first, check its result with a read afterwards, and never refuse a command only because it is untried.
+The CLI publishes 845 commands. 700 of them bind one of the 769 API operations in the matrix; the remainder are local commands (`schema`, `auth`, `doctor`, `log`, ...) or typed variants that share an operation (`view transform *` commands submit through `view.task.add`, except `rename-columns` and `sort`, which set view display properties through `view.update`). 261 bound commands ran once successfully on release, 1 are not supported there, and the rest are untried. Untried is not broken: discover the contract with `mammoth schema get COMMAND_ID`, run it, and treat the structured error envelope as the answer. Use an untried command normally: confirm a write with the user first, check its result with a read afterwards, and never refuse a command only because it is untried.
 
 Status meanings:
 
@@ -17,27 +17,27 @@ The typed `view transform *` commands all submit through `view.task.add` (`renam
 
 | Family | Commands | Ran once | Not supported | Untried |
 |---|---|---|---|---|
-| `dashboard` | 131 | 81 | 1 | 49 |
-| `support` | 66 | 9 | 0 | 57 |
-| `view` | 63 | 58 | 0 | 5 |
-| `billing` | 24 | 4 | 0 | 20 |
-| `connector` | 22 | 3 | 0 | 19 |
-| `workspace` | 20 | 7 | 0 | 13 |
-| `dataset` | 18 | 12 | 0 | 6 |
-| `project` | 17 | 15 | 0 | 2 |
-| `workflow` | 16 | 9 | 0 | 7 |
+| `dashboard` | 166 | 81 | 1 | 84 |
+| `support` | 112 | 9 | 0 | 103 |
+| `view` | 71 | 58 | 0 | 13 |
+| `agent` | 41 | 1 | 0 | 40 |
+| `connector` | 39 | 3 | 0 | 36 |
+| `workspace` | 27 | 7 | 0 | 20 |
+| `billing` | 26 | 4 | 0 | 22 |
+| `dataset` | 26 | 12 | 0 | 14 |
+| `workflow` | 23 | 9 | 0 | 14 |
+| `collection` | 21 | 0 | 0 | 21 |
+| `project` | 18 | 15 | 0 | 3 |
 | `parameter` | 14 | 7 | 0 | 7 |
-| `data-app` | 12 | 1 | 0 | 11 |
+| `automation` | 13 | 3 | 0 | 10 |
 | `browse` | 9 | 1 | 0 | 8 |
-| `automation` | 8 | 3 | 0 | 5 |
+| `file` | 8 | 5 | 0 | 3 |
 | `folder` | 8 | 8 | 0 | 0 |
 | `snippet` | 8 | 6 | 0 | 2 |
 | `user` | 7 | 3 | 0 | 4 |
 | `webhook` | 7 | 5 | 0 | 2 |
 | `addon` | 6 | 0 | 0 | 6 |
-| `agent` | 6 | 1 | 0 | 5 |
 | `batch` | 6 | 6 | 0 | 0 |
-| `file` | 6 | 5 | 0 | 1 |
 | `ai` | 5 | 3 | 0 | 2 |
 | `annotation` | 5 | 1 | 0 | 4 |
 | `client-app` | 5 | 0 | 0 | 5 |
@@ -47,6 +47,7 @@ The typed `view transform *` commands all submit through `view.task.add` (`renam
 | `external-key` | 4 | 1 | 0 | 3 |
 | `trash` | 3 | 3 | 0 | 0 |
 | `activity` | 2 | 1 | 0 | 1 |
+| `auth` | 2 | 0 | 0 | 2 |
 | `job` | 2 | 2 | 0 | 0 |
 | `report` | 1 | 1 | 0 | 0 |
 

{mammoth_cli-2.2.93 → mammoth_cli-2.2.95}/mammoth_cli/bundled_skill/mammoth-cli/references/command-index.md

@@ -1,18 +1,18 @@
 # Published CLI command catalog
 
-This generated catalog is a lookup table for every command in the published CLI manifest, currently 785; each entry carries its release status line. It is a command-contract index, not an assertion that every backend/OpenAPI operation has a CLI binding. For an exact local CLI contract, run `mammoth schema get COMMAND_ID`; `mammoth capability list` is an API-binding inventory and can omit typed/local CLI routes. For focused workflows, read the [recipes index](recipes/index.md). Sensitive structured input must come from a private file or pipe; never put secrets in literal argv.
+This generated catalog is a lookup table for every command in the published CLI manifest, currently 845; each entry carries its release status line. It is a command-contract index, not an assertion that every backend/OpenAPI operation has a CLI binding. For an exact local CLI contract, run `mammoth schema get COMMAND_ID`; `mammoth capability list` is an API-binding inventory and can omit typed/local CLI routes. For focused workflows, read the [recipes index](recipes/index.md). Sensitive structured input must come from a private file or pipe; never put secrets in literal argv.
 
 Load only the applicable domain file:
 
 - [activity](commands/activity.md) — 2 published commands
-- [addon](commands/addon.md) — 7 published commands
-- [agent](commands/agent.md) — 54 published commands
+- [addon](commands/addon.md) — 6 published commands
+- [agent](commands/agent.md) — 44 published commands
 - [ai](commands/ai.md) — 5 published commands
 - [annotation](commands/annotation.md) — 5 published commands
 - [auth](commands/auth.md) — 5 published commands
-- [automation](commands/automation.md) — 8 published commands
+- [automation](commands/automation.md) — 13 published commands
 - [batch](commands/batch.md) — 7 published commands
-- [billing](commands/billing.md) — 25 published commands
+- [billing](commands/billing.md) — 27 published commands
 - [browse](commands/browse.md) — 9 published commands
 - [calc](commands/calc.md) — 1 published commands
 - [capabilities](commands/capabilities.md) — 1 published commands
@@ -21,16 +21,15 @@ Load only the applicable domain file:
 - [collection](commands/collection.md) — 21 published commands
 - [completion](commands/completion.md) — 2 published commands
 - [config](commands/config.md) — 4 published commands
-- [connector](commands/connector.md) — 23 published commands
+- [connector](commands/connector.md) — 40 published commands
 - [context](commands/context.md) — 4 published commands
 - [dashboard-qa](commands/dashboard-qa.md) — 14 published commands
 - [dashboard-template](commands/dashboard-template.md) — 12 published commands
+- [dashboard-published](commands/dashboard-published.md) — 10 published commands
 - [dashboard-style](commands/dashboard-style.md) — 10 published commands
 - [dashboard-embed](commands/dashboard-embed.md) — 9 published commands
-- [dashboard-published](commands/dashboard-published.md) — 8 published commands
-- [dashboard](commands/dashboard.md) — 104 published commands
-- [data-app](commands/data-app.md) — 12 published commands
-- [dataset](commands/dataset.md) — 28 published commands
+- [dashboard](commands/dashboard.md) — 112 published commands
+- [dataset](commands/dataset.md) — 30 published commands
 - [doctor](commands/doctor.md) — 1 published commands
 - [external-key](commands/external-key.md) — 4 published commands
 - [file](commands/file.md) — 11 published commands
@@ -44,19 +43,20 @@ Load only the applicable domain file:
 - [project](commands/project.md) — 25 published commands
 - [report](commands/report.md) — 1 published commands
 - [resolve](commands/resolve.md) — 1 published commands
+- [run](commands/run.md) — 1 published commands
 - [schedule](commands/schedule.md) — 5 published commands
 - [schema](commands/schema.md) — 3 published commands
 - [skill](commands/skill.md) — 7 published commands
 - [snippet](commands/snippet.md) — 8 published commands
-- [support](commands/support.md) — 66 published commands
+- [support](commands/support.md) — 112 published commands
 - [template](commands/template.md) — 5 published commands
 - [token](commands/token.md) — 3 published commands
 - [trash](commands/trash.md) — 3 published commands
 - [upgrade](commands/upgrade.md) — 1 published commands
-- [user](commands/user.md) — 8 published commands
+- [user](commands/user.md) — 7 published commands
 - [version](commands/version.md) — 1 published commands
 - [view-transform](commands/view-transform.md) — 35 published commands
-- [view](commands/view.md) — 109 published commands
+- [view](commands/view.md) — 110 published commands
 - [webhook](commands/webhook.md) — 7 published commands
 - [workflow](commands/workflow.md) — 23 published commands
 - [workspace](commands/workspace.md) — 33 published commands

{mammoth_cli-2.2.93 → mammoth_cli-2.2.95}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/addon.md

@@ -22,16 +22,6 @@ Result: `AddonConnectorRemoveResult`; mutation `high_impact`, confirmation `conf
 
 Status on release: untried; no live run recorded.
 
-### `addon.list`
-
-Run: `mammoth addon list`. Exact input fields: `mammoth schema get addon.list`.
-
-Example: `mammoth addon list`. Placeholders are illustrative; resolve IDs and input from observed reads.
-
-Result: `AddonListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
-
-Status on release: untried; no live run recorded.
-
 ### `addon.storage.add`
 
 Run: `mammoth addon storage add`. Exact input fields: `mammoth schema get addon.storage.add`.