mammoth-cli 2.2.73__tar.gz → 2.2.75__tar.gz

{mammoth_cli-2.2.73 → mammoth_cli-2.2.75}/PKG-INFO

@@ -1,9 +1,10 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.2.73
+Version: 2.2.75
 Summary: Command-line interface for the Mammoth Analytics platform
 Project-URL: homepage, https://mammoth.io
 Project-URL: repository, https://github.com/EdgeMetric/mammothsdk
+Project-URL: documentation, https://docs.mammoth.io/build/cli
 Author-email: Mammoth Analytics <support@mammoth.io>
 License-Expression: LicenseRef-Proprietary
 License-File: LICENSE
@@ -17,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.33
+Requires-Dist: mammoth-io<0.9,>=0.8.39
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.12.5
 Requires-Dist: pyyaml<7,>=6

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

{mammoth_cli-2.2.73 → mammoth_cli-2.2.75}/mammoth_cli/app.py

@@ -73,6 +73,7 @@ _GROUP_DESCRIPTIONS = {
         "for scripts and integrations."
     ),
     "token": "Create, list, and revoke long-lived API keys (aliases of client-app).",
+    "collection": "Group dashboards into a collection and share the set as one.",
     "completion": "Install or print shell completion.",
     "config": "Read and update local CLI configuration.",
     "connector": "Manage data connectors and connector profiles.",
@@ -111,6 +112,8 @@ _AGENT_SUBGROUP_DESCRIPTIONS = {
     "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": "Edit the waiting workflow proposal of an agent chat plan.",
     "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.",
@@ -120,11 +123,143 @@ _AGENT_SUBGROUP_DESCRIPTIONS = {
 }
 
 
+# One line per nested group below the top level, so ``mammoth view --help`` tells its
+# subgroups apart instead of repeating the top-level description. ``agent`` groups are above.
+_SUBGROUP_DESCRIPTIONS = {
+    "addon connector": "Add or remove the connector add-on.",
+    "addon storage": "Add or remove the storage add-on.",
+    "addon user": "Add or remove the user add-on.",
+    "agent run units": "List and read the units of work inside an agent run.",
+    "ai condition": "Generate a filter condition from a description.",
+    "ai expression": "Generate a column expression from a description.",
+    "ai retention": "Generate a data-retention condition from a description.",
+    "ai sql": "Generate SQL from a description.",
+    "ai suggestion": "List AI suggestions for a view.",
+    "annotation comment": "Add comments to annotations.",
+    "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 payment-method": "List, delete and default Stripe payment methods.",
+    "billing stripe storage": "Set the Stripe storage tier.",
+    "billing subscription": "Read and update the subscription.",
+    "browse resources": "Browse workspace resources in bulk.",
+    "collection dashboards": "Add dashboards to a collection or remove them.",
+    "collection files": "Upload files to a collection.",
+    "collection members": "Remove members from a collection.",
+    "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 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 chat": "Edit a dashboard by chat and read the chat history.",
+    "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.",
+    "dashboard embed config": "Read and set the embed configuration.",
+    "dashboard embed key": "Rotate the embed key.",
+    "dashboard embed lifetime": "Set the embed token lifetime.",
+    "dashboard embed origin": "Revoke an allowed embed origin.",
+    "dashboard embed preview-token": "Create an embed preview token.",
+    "dashboard embed secret": "Rotate the embed secret.",
+    "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 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 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.",
+    "dashboard qa comment": "Create and delete Q&A comments.",
+    "dashboard qa session": "Create, read, fork, rename and share Q&A sessions.",
+    "dashboard qa settings": "Read and set Q&A settings.",
+    "dashboard rls": "Row-level security for a dashboard.",
+    "dashboard rls assignment": "List and set row-level security assignments.",
+    "dashboard rls column": "List the columns row-level security can use.",
+    "dashboard rls value": "List the values row-level security can use.",
+    "dashboard signature": "Create, list, update and delete dashboard signatures.",
+    "dashboard source": "List the data sources of dashboards.",
+    "dashboard style": "Manage dashboard styles: presets, tokens, custom and default.",
+    "dashboard style custom": "Create, list, update and delete custom styles.",
+    "dashboard style default": "Read and set the default style.",
+    "dashboard style preset": "List style presets.",
+    "dashboard style token": "List style tokens.",
+    "dashboard suggestion": "List dashboard suggestions.",
+    "dashboard tags": "List, set, rename, merge and delete dashboard tags.",
+    "dashboard template": "Create, apply and manage dashboard templates.",
+    "dashboard template thumbnail": "Read, set and clear a template thumbnail.",
+    "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 file-settings": "Read, update and undo a dataset's file settings.",
+    "dataset interpretation": "Preview and confirm how a file is interpreted.",
+    "parameter group": "Create, list, update, reorder and delete parameter groups.",
+    "project checkpoint": "List project checkpoints.",
+    "project data-check": "List project data checks.",
+    "project memory": "Add, list and remove project memory notes.",
+    "project resource-dependencies": "Update project resource dependencies.",
+    "project user": "Add, update and remove project users.",
+    "skill agents-md": "Install the agent instructions file.",
+    "support connector": "Create, list, update and delete connectors.",
+    "support connector-profile": "Manage connector profiles and their connectors.",
+    "support feature": "Create, list, update and delete features.",
+    "support feature-profile": "Manage feature profiles and their features.",
+    "support ownership": "Transfer ownership.",
+    "support plan": "Manage billing plans.",
+    "support plan storage-option": "Manage a plan's storage options.",
+    "support subscription": "Create, read and update subscriptions.",
+    "support template": "Audit, edit, import, export and publish templates.",
+    "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 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 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.",
+    "view draft": "Enter, run, submit or discard a view draft.",
+    "view explore-panel": "Read and change the Explore cards of a view.",
+    "view export": "Export a view to a file, database or service.",
+    "view exportable-config": "Read and apply a view's exportable config.",
+    "view pipeline": "Read, edit, rerun and wait on a view's pipeline.",
+    "view task": "Add, list, update and delete pipeline tasks.",
+    "view transform": "Add transformations to a view.",
+    "view variants": "Create view variants.",
+    "view version": "List, read, apply and delete view versions.",
+    "workflow block": "Add and configure workflow blocks.",
+    "workspace invite": "List, resend, revoke and delete workspace invites.",
+    "workspace oauth-client": "Register, list, delete and revoke OAuth client grants.",
+    "workspace segment": "List and update workspace segments.",
+    "workspace user": "Add, list, update and remove workspace users.",
+}
+
+
 def _group_description(tokens: tuple[str, ...]) -> str:
     """Return the help line for the group at ``tokens``."""
+    path = " ".join(tokens)
+    if path in _SUBGROUP_DESCRIPTIONS:
+        return _SUBGROUP_DESCRIPTIONS[path]
     if tokens[0] == "agent" and len(tokens) > 1 and tokens[1] in _AGENT_SUBGROUP_DESCRIPTIONS:
         return _AGENT_SUBGROUP_DESCRIPTIONS[tokens[1]]
-    return _GROUP_DESCRIPTIONS.get(tokens[0], f"Commands for {' '.join(tokens)}.")
+    if len(tokens) > 1:
+        return f"Commands for {path}."
+    return _GROUP_DESCRIPTIONS.get(tokens[0], f"Commands for {path}.")
 
 
 _ROOT_HELP_PANELS = {
@@ -142,6 +277,7 @@ _ROOT_HELP_PANELS = {
     "job": "Work with data",
     "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",
@@ -949,7 +1085,7 @@ def _execute(invocation: Invocation) -> None:
     from mammoth_cli.runtime.strict import validate_extra_args
 
     if invocation.profile is None:
-        invocation = replace(invocation, profile=profiles.get_selected())
+        invocation = replace(invocation, profile=profiles.get_selected(), profile_is_default=True)
 
     def producer() -> tuple[Any, dict[str, Any]]:
         refuse_hand_crafted_write(invocation.command_id)
@@ -1041,12 +1177,83 @@ def _dry_run(handler: Handler, invocation: Invocation) -> tuple[Any, dict[str, A
         return report, {"profile": invocation.profile, "project_id": resolved_project(invocation)}
 
 
+#: One-line help for commands that share the generic ``generated_dashboard`` handler, whose
+#: docstring describes the dispatch, not the command.
+_GENERATED_SUMMARIES = {
+    "auth.connected-apps.list": "List the apps connected to your account; each id is a grant id.",
+    "auth.connected-apps.revoke": (
+        "Disconnect one connected app from your account. Grant id is positional."
+    ),
+    "collection.active-job": (
+        "Show the collection's upload job still in flight. Collection id is positional."
+    ),
+    "collection.activity": "Show who opened a collection and which of its dashboards get opened.",
+    "collection.create": "Create a collection in the active project. Name comes from '--input'.",
+    "collection.dashboards.add": (
+        "Add dashboards to a collection, which gives its members access to them."
+    ),
+    "collection.dashboards.remove": (
+        "Take one dashboard out of a collection; the dashboard is kept."
+    ),
+    "collection.delete": "Delete a collection and end its members' access through it.",
+    "collection.files.upload": (
+        "Upload local files to refresh a collection's data. Paths come from '--input'."
+    ),
+    "collection.for-dashboard": (
+        "List the collections that hold a dashboard. Dashboard id is positional."
+    ),
+    "collection.get": "Get one collection with its dashboards, members and refresh setup.",
+    "collection.get-by-url": "Open a collection by its share url token, as a viewer does.",
+    "collection.job": "Poll one collection upload job. Collection id and job id are positional.",
+    "collection.list": "List the collections you manage or were shared.",
+    "collection.members.remove": "Take one person off a collection by email.",
+    "collection.pipeline-changes": "Show the progress of a collection's data refresh.",
+    "collection.share": "Give people access to a collection by email and send them the invite.",
+    "collection.update": "Change a collection's name, description, dashboard order or tab labels.",
+    "dashboard.attachment-create": (
+        "Upload a local workbook as a chat attachment. File path is positional."
+    ),
+    "dashboard.engagement.get": (
+        "Show who has opened a dashboard: reach, depth, devices and actions."
+    ),
+    "dashboard.engagement.person": (
+        "Show one person's recent visits to a dashboard. Dashboard id and user id are positional."
+    ),
+    "dashboard.engagement.remind": (
+        "Email the share link again to people who have not opened a dashboard."
+    ),
+    "dashboard.own-data.accept": (
+        "Apply the proposed 'use my data' version to a board; this changes it."
+    ),
+    "dashboard.own-data.dismiss": (
+        "Drop a board's pending 'use my data' run; the board is not changed."
+    ),
+    "dashboard.own-data.preview": (
+        "Preview a board on your own data as proposed, without saving it."
+    ),
+    "dashboard.own-data.start": "Fit a template board to your own data and wait for the proposal.",
+    "dashboard.own-data.status": (
+        "Show a board's pending 'use my data' run; status null means none."
+    ),
+    "workspace.current": "Show the workspace this token acts in, and the project it is fenced to.",
+    "workspace.oauth-client.delete": (
+        "Delete an OAuth client registration; its grants stop working."
+    ),
+    "workspace.oauth-client.list": "List the workspace's registered OAuth clients (no secrets).",
+    "workspace.oauth-client.revoke-grant": (
+        "Revoke every grant to an OAuth client; users must authorise it again."
+    ),
+}
+
+
 def live_command_summary(command_id: str) -> str | None:
     """The backing handler's docstring first line, the lead of a command's help.
 
     Reading it imports the handler's module, so a group listing takes it from
     the generated index (:func:`_indexed_summary`) instead.
     """
+    if command_id in _GENERATED_SUMMARIES:
+        return _GENERATED_SUMMARIES[command_id]
     handler = HANDLERS.get(command_id) or BESPOKE.get(command_id)
     doc = inspect.getdoc(handler) if handler is not None else None
     if not doc:
@@ -1068,7 +1275,10 @@ def _indexed_summary(command_id: str) -> str | None:
 
 
 #: 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."
 _HELP_NOTES = {
+    "view.data.get": _RAW_NOTE,
+    "view.data.query": _RAW_NOTE,
     "view.export.dataset": (
         "Omit dataset_name unless the user gave one; the product default 'Result Dataset' is used."
     ),
@@ -1321,6 +1531,10 @@ def _top_level_typer(name: str) -> typer.Typer:
     return sub
 
 
+#: Groups kept out of ``mammoth --help`` until their backend is generally available.
+#: They still run when typed; only the listing hides them.
+_HIDDEN_UNTIL_GA = frozenset({"agent"})
+
 # Top-level groups are converted to Click on first use. Building the leaf
 # callbacks and ``--help`` text for all ~550 commands, then letting Typer
 # convert every one of them, used to cost most of the CLI's start-up time on
@@ -1337,6 +1551,7 @@ def _load_top_level_group(name: str) -> Any:
         name=name,
         help=_GROUP_DESCRIPTIONS.get(name, f"Commands for {name}."),
         rich_help_panel=_ROOT_HELP_PANELS.get(name),
+        hidden=name in _HIDDEN_UNTIL_GA,
     )
     return typer.main.get_group_from_info(info, **_LAZY_SETTINGS)
 
@@ -1409,6 +1624,7 @@ def _group_stub(name: str) -> Any:
         help=_GROUP_DESCRIPTIONS.get(name, f"Commands for {name}."),
         rich_help_panel=_ROOT_HELP_PANELS.get(name),
         rich_markup_mode=_LAZY_SETTINGS["rich_markup_mode"],
+        hidden=name in _HIDDEN_UNTIL_GA,
     )
 
 

{mammoth_cli-2.2.73 → mammoth_cli-2.2.75}/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 692 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 714 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.
 
 Status meanings:
 

{mammoth_cli-2.2.73 → mammoth_cli-2.2.75}/mammoth_cli/bundled_skill/mammoth-cli/references/command-index.md

@@ -1,15 +1,15 @@
 # Published CLI command catalog
 
-This generated catalog is a lookup table for every command in the published CLI manifest, currently 692; 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 740; 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) — 44 published commands
+- [agent](commands/agent.md) — 51 published commands
 - [ai](commands/ai.md) — 5 published commands
 - [annotation](commands/annotation.md) — 5 published commands
-- [auth](commands/auth.md) — 3 published commands
+- [auth](commands/auth.md) — 5 published commands
 - [automation](commands/automation.md) — 8 published commands
 - [batch](commands/batch.md) — 7 published commands
 - [billing](commands/billing.md) — 25 published commands
@@ -17,6 +17,7 @@ Load only the applicable domain file:
 - [calc](commands/calc.md) — 1 published commands
 - [capability](commands/capability.md) — 3 published commands
 - [client-app](commands/client-app.md) — 5 published commands
+- [collection](commands/collection.md) — 16 published commands
 - [completion](commands/completion.md) — 2 published commands
 - [config](commands/config.md) — 4 published commands
 - [connector](commands/connector.md) — 22 published commands
@@ -24,12 +25,12 @@ Load only the applicable domain file:
 - [dashboard-qa](commands/dashboard-qa.md) — 14 published commands
 - [dashboard-template](commands/dashboard-template.md) — 12 published commands
 - [dashboard-style](commands/dashboard-style.md) — 10 published commands
-- [dashboard](commands/dashboard.md) — 99 published commands
+- [dashboard](commands/dashboard.md) — 108 published commands
 - [data-app](commands/data-app.md) — 12 published commands
 - [dataset](commands/dataset.md) — 22 published commands
 - [doctor](commands/doctor.md) — 1 published commands
 - [external-key](commands/external-key.md) — 4 published commands
-- [file](commands/file.md) — 9 published commands
+- [file](commands/file.md) — 11 published commands
 - [folder](commands/folder.md) — 10 published commands
 - [job](commands/job.md) — 4 published commands
 - [link](commands/link.md) — 1 published commands
@@ -51,7 +52,7 @@ Load only the applicable domain file:
 - [user](commands/user.md) — 8 published commands
 - [version](commands/version.md) — 1 published commands
 - [view-transform](commands/view-transform.md) — 34 published commands
-- [view](commands/view.md) — 98 published commands
+- [view](commands/view.md) — 101 published commands
 - [webhook](commands/webhook.md) — 7 published commands
-- [workflow](commands/workflow.md) — 16 published commands
-- [workspace](commands/workspace.md) — 26 published commands
+- [workflow](commands/workflow.md) — 20 published commands
+- [workspace](commands/workspace.md) — 31 published commands

{mammoth_cli-2.2.73 → mammoth_cli-2.2.75}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/agent.md

@@ -222,6 +222,26 @@ Result: `AgentMemoryRemoveResult`; mutation `destructive`, confirmation `prompt_
 
 Status on release: untried; no live run recorded.
 
+### `agent.message.set-request-kind`
+
+Run: `mammoth agent message set-request-kind`. Exact input fields: `mammoth schema get agent.message.set-request-kind`.
+
+Example: `mammoth agent message set-request-kind 'Summarize revenue by region' --input '{"request_kind": "sample"}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentMessageSetRequestKindResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.plan.edit-proposal`
+
+Run: `mammoth agent plan edit-proposal`. Exact input fields: `mammoth schema get agent.plan.edit-proposal`.
+
+Example: `mammoth agent plan edit-proposal --input '{"plan_id": "resource-123", "action": "sample", "key": "Status"}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentPlanEditProposalResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `agent.projects.clear`
 
 Run: `mammoth agent projects clear`. Exact input fields: `mammoth schema get agent.projects.clear`.
@@ -272,6 +292,36 @@ Result: `AgentRunExtendResult`; mutation `benign_mutation`, confirmation `none`,
 
 Status on release: untried; no live run recorded.
 
+### `agent.run.instance.list`
+
+Run: `mammoth agent run instance list`. Exact input fields: `mammoth schema get agent.run.instance.list`.
+
+Example: `mammoth agent run instance list resource-123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentRunInstanceListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.run.instance.messages`
+
+Run: `mammoth agent run instance messages`. Exact input fields: `mammoth schema get agent.run.instance.messages`.
+
+Example: `mammoth agent run instance messages resource-123 resource-123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentRunInstanceMessagesResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.run.instance.transcript`
+
+Run: `mammoth agent run instance transcript`. Exact input fields: `mammoth schema get agent.run.instance.transcript`.
+
+Example: `mammoth agent run instance transcript resource-123 resource-123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentRunInstanceTranscriptResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `agent.run.list`
 
 Run: `mammoth agent run list`. Exact input fields: `mammoth schema get agent.run.list`.
@@ -302,6 +352,16 @@ Result: `AgentRunResumeResult`; mutation `benign_mutation`, confirmation `none`,
 
 Status on release: untried; no live run recorded.
 
+### `agent.run.retry`
+
+Run: `mammoth agent run retry`. Exact input fields: `mammoth schema get agent.run.retry`.
+
+Example: `mammoth agent run retry resource-123`. Illustrative only: append `--yes` after observing an owned target.
+
+Result: `AgentRunRetryResult`; mutation `benign_mutation`, confirmation `prompt_or_yes`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `agent.run.status`
 
 Run: `mammoth agent run status`. Exact input fields: `mammoth schema get agent.run.status`.
@@ -322,6 +382,16 @@ Result: `AgentRunStopResult`; mutation `benign_mutation`, confirmation `none`, w
 
 Status on release: untried; no live run recorded.
 
+### `agent.run.units.list`
+
+Run: `mammoth agent run units list`. Exact input fields: `mammoth schema get agent.run.units.list`.
+
+Example: `mammoth agent run units list resource-123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentRunUnitsListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `agent.run.units.set`
 
 Run: `mammoth agent run units set`. Exact input fields: `mammoth schema get agent.run.units.set`.

{mammoth_cli-2.2.73 → mammoth_cli-2.2.75}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/auth.md

@@ -2,6 +2,26 @@
 
 Every command returns the standard JSON envelope. On nonzero exit, read the error envelope and its `recovery_commands`; do not guess request fields. "Status on release" is joined from `docs/release-capability-matrix.json`: *ran once* means one bounded live run succeeded on the named CLI release, *untried* means nobody has run it (use it normally: confirm writes with the user, check the result afterwards), *not supported* means the backend refuses it. When this file disagrees with [capabilities](../capabilities.md) or a recipe, they win. Envelope shapes: [machine output](../machine-output.md).
 
+### `auth.connected-apps.list`
+
+Run: `mammoth auth connected-apps list`. Exact input fields: `mammoth schema get auth.connected-apps.list`.
+
+Example: `mammoth auth connected-apps list`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AuthConnectedAppsListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `auth.connected-apps.revoke`
+
+Run: `mammoth auth connected-apps revoke`. Exact input fields: `mammoth schema get auth.connected-apps.revoke`.
+
+Example: `mammoth auth connected-apps revoke 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `AuthConnectedAppsRevokeResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `auth.login`
 
 Run: `mammoth auth login`. Exact input fields: `mammoth schema get auth.login`.