mammoth-cli 2.2.59__tar.gz → 2.2.60__tar.gz

{mammoth_cli-2.2.59 → mammoth_cli-2.2.60}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.2.59
+Version: 2.2.60
 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.2.59 → mammoth_cli-2.2.60}/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.59"
+__version__ = "2.2.60"
 
 # The versioned machine output envelope contract.
 SCHEMA_VERSION = 1

{mammoth_cli-2.2.59 → mammoth_cli-2.2.60}/mammoth_cli/app.py

@@ -103,6 +103,30 @@ _GROUP_DESCRIPTIONS = {
     "workspace": "Manage workspace settings and members.",
 }
 
+# One line per ``agent`` subgroup, so ``mammoth agent --help`` tells them apart.
+_AGENT_SUBGROUP_DESCRIPTIONS = {
+    "access": "Set who may use an agent definition.",
+    "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.",
+    "projects": "Set 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.",
+}
+
+
+def _group_description(tokens: tuple[str, ...]) -> str:
+    """Return the help line for the group at ``tokens``."""
+    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)}.")
+
+
 _ROOT_HELP_PANELS = {
     "auth": "Start here",
     "context": "Start here",
@@ -1133,7 +1157,7 @@ def _group_typer(tokens: tuple[str, ...], command_id: str | None) -> typer.Typer
         sub.callback()(_build_leaf(command_id, is_group_callback=True))
         return sub
     return typer.Typer(
-        help=_GROUP_DESCRIPTIONS.get(tokens[0], f"Commands for {' '.join(tokens)}."),
+        help=_group_description(tokens),
         no_args_is_help=True,
         context_settings={"allow_extra_args": True, "ignore_unknown_options": True},
     )
@@ -1233,7 +1257,7 @@ def _populate(base: tuple[str, ...], group: typer.Typer) -> None:
         parent.add_typer(
             sub,
             name=tokens[-1],
-            help=_GROUP_DESCRIPTIONS.get(top_level, f"Commands for {' '.join(tokens)}."),
+            help=_group_description(tokens),
             rich_help_panel=_ROOT_HELP_PANELS.get(top_level) if len(tokens) == 1 else None,
         )
         groups[tokens] = sub

{mammoth_cli-2.2.59 → mammoth_cli-2.2.60}/mammoth_cli/commands/agent.py

@@ -314,11 +314,12 @@ def agent_roles(invocation: Invocation) -> HandlerResult:
 
 def agent_create(invocation: Invocation) -> HandlerResult:
     """Create an agent definition under the KEY positional; ``name`` is required input."""
-    key = _require_string_positional(invocation, "agent key")
+    _require_string_positional(invocation, "agent key")
     document = _bound_document(invocation)
     _require_field(document, "name")
+    # The bound document already carries the KEY positional as ``key``.
     with open_service(invocation) as (service, auth):
-        data = service.call(_symbol(invocation), key=key, **document)
+        data = service.call(_symbol(invocation), **document)
     return data, _meta(invocation, auth.workspace_id, resolved_project(invocation))
 
 
@@ -364,7 +365,8 @@ def agent_feedback_list(invocation: Invocation) -> HandlerResult:
 
 def agent_update(invocation: Invocation) -> HandlerResult:
     """Change an agent definition; only the ``--input`` fields given are sent."""
-    return _definition_call(invocation, **_bound_document(invocation))
+    fields = {k: v for k, v in _bound_document(invocation).items() if k != "agent_key"}
+    return _definition_call(invocation, **fields)
 
 
 def agent_delete(invocation: Invocation) -> HandlerResult:

{mammoth_cli-2.2.59 → mammoth_cli-2.2.60}/pyproject.toml

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

{mammoth_cli-2.2.59 → mammoth_cli-2.2.60}/spec/manifests/commands/agent.yaml

@@ -484,8 +484,8 @@ commands:
   - CT-AGENT-DISABLE-ERROR
   draft_test: null
   undo_test: null
-  known_restrictions: Writes. Takes a published agent out of use; chat no longer finds it. Publish it
-    again to bring it back.
+  known_restrictions: Writes. Takes an agent out of use, draft or published; chat no longer finds it.
+    Publish it again to bring it back.
   reviewed_by: primary
   no_readback: returns the changed definition itself
 - command_id: agent.feedback.list