icmd-python 3.10.0__py3-none-any.whl → 3.11.0__py3-none-any.whl

icmd/apps/__init__.py

@@ -11,6 +11,7 @@ Provides a clean nested-attribute API::
 
 from .account import AccountApp
 from .agent import AgentApp
+from .comments import CommentsApp
 from .constants import ProjectKind
 from .studio import StudioApp
 from .suite import SuiteApp
@@ -19,6 +20,7 @@ from .workspace import WorkspaceApp
 __all__ = [
     "AccountApp",
     "AgentApp",
+    "CommentsApp",
     "ProjectKind",
     "StudioApp",
     "SuiteApp",

icmd/apps/agent.py

@@ -55,7 +55,11 @@ def _poll_message(
     elapsed = 0
     while True:
         msg = _expect_dict(
-            client.request_json("get", f"{_MESSAGE_PATH}/{message_uuid}", inject_group=False),
+            client.request_json(
+                "get",
+                f"{_MESSAGE_PATH}/{message_uuid}",
+                inject_group=client.has_owner_group,
+            ),
             _MESSAGE_PATH,
         )
         if (msg.get("status") or "").lower() in _TERMINAL_MESSAGE_STATUSES:

icmd/apps/base.py

@@ -214,7 +214,7 @@ class ReadOnlyResource:
         uuid: str,
         *,
         params: dict[str, Any] | None = None,
-        inject_group: bool = False,
+        inject_group: bool | None = None,
     ) -> dict:
         """Get a single resource by UUID.
 
@@ -223,21 +223,26 @@ class ReadOnlyResource:
         caller's server-side ``current_group`` (whatever they last
         selected in the web UI).  A resource owned by any other group
         answers ``404`` — this is not a cross-group lookup, and omitting
-        ``owner_group`` does not make it one.  For jobs specifically, the
-        Studio action ``studio/jobs/{uuid}/accessible-group/`` answers which
-        of your groups can ordinarily see a job; it walks plain project
-        access, so it performs no admin widening.
+        ``owner_group`` does not make it one.  By default the client's group
+        is sent when it already holds one (see :attr:`ICMD.has_owner_group`),
+        so a resource created through this client is found again.  For jobs
+        specifically, the Studio action ``studio/jobs/{uuid}/accessible-group/``
+        answers which of your groups can ordinarily see a job; it walks plain
+        project access, so it performs no admin widening.
 
         Parameters
         ----------
         uuid : str
             The resource UUID.
         params : dict | None
-            Query parameters, forwarded only when not ``None``.
-        inject_group : bool
-            When ``True``, pin the lookup to the client's active
-            ``owner_group`` (resolving it if needed) instead of leaving it
-            to the caller's ``current_group``.
+            Query parameters, forwarded only when not ``None``.  An
+            ``owner_group`` named here is sent as given.
+        inject_group : bool | None
+            ``None`` (default) pins the lookup to the client's
+            ``owner_group`` only when the client already holds one, and never
+            resolves or prompts for one.  ``True`` always pins, resolving the
+            group if needed; ``False`` never pins, leaving the lookup to the
+            caller's ``current_group``.
 
         Returns
         -------
@@ -245,6 +250,8 @@ class ReadOnlyResource:
             The resource record.
         """
         endpoint = f"{self._path}/{uuid}"
+        if inject_group is None:
+            inject_group = self._client.has_owner_group
         kwargs: dict[str, Any] = {"inject_group": inject_group}
         if params is not None:
             kwargs["params"] = params
@@ -268,8 +275,10 @@ class ReadOnlyResource:
         *method*.
 
         The active ``owner_group`` is injected as a query parameter for
-        *list* actions (no *uuid*) and skipped for *detail* actions — the
-        same convention :meth:`list` and :meth:`get` follow.
+        *list* actions (no *uuid*); *detail* actions send it only when the
+        client already holds one — the same convention :meth:`list` and
+        :meth:`get` follow.  An ``owner_group`` named in *params* is sent as
+        given either way.
 
         Parameters
         ----------
@@ -292,7 +301,7 @@ class ReadOnlyResource:
             list, some a single object).
         """
         endpoint = "/".join(part for part in (self._path, uuid, name) if part)
-        kwargs: dict[str, Any] = {"inject_group": uuid is None}
+        kwargs: dict[str, Any] = {"inject_group": uuid is None or self._client.has_owner_group}
         if data is not None:
             kwargs["json"] = data
         if params is not None:
@@ -328,8 +337,8 @@ class Resource(ReadOnlyResource):
         supported across the API — several viewsets accept ``PATCH`` but
         block ``PUT`` to keep their state-machine guards intact (e.g.
         studio jobs, suite ML models).  Use :meth:`replace` for a full
-        ``PUT`` replacement where the resource allows it.  Group injection
-        is skipped — the UUID fully identifies the target.
+        ``PUT`` replacement where the resource allows it.  Like :meth:`get`,
+        the request is pinned to the client's group only when it holds one.
 
         Parameters
         ----------
@@ -345,7 +354,9 @@ class Resource(ReadOnlyResource):
         """
         endpoint = f"{self._path}/{uuid}"
         return _expect_dict(
-            self._client.request_json("patch", endpoint, inject_group=False, json=data),
+            self._client.request_json(
+                "patch", endpoint, inject_group=self._client.has_owner_group, json=data
+            ),
             endpoint,
         )
 
@@ -369,7 +380,9 @@ class Resource(ReadOnlyResource):
         """
         endpoint = f"{self._path}/{uuid}"
         return _expect_dict(
-            self._client.request_json("put", endpoint, inject_group=False, json=data),
+            self._client.request_json(
+                "put", endpoint, inject_group=self._client.has_owner_group, json=data
+            ),
             endpoint,
         )
 
@@ -399,7 +412,9 @@ class Resource(ReadOnlyResource):
         """
         endpoint = f"{self._path}/{uuid}"
         return _expect_dict(
-            self._client.request_json("delete", endpoint, inject_group=False),
+            self._client.request_json(
+                "delete", endpoint, inject_group=self._client.has_owner_group
+            ),
             endpoint,
         )
 
@@ -435,7 +450,8 @@ class SoftDeleteMixin:
         """
         endpoint = f"{self._path}/{uuid}/trash"
         return _expect_dict(
-            self._client.request_json("post", endpoint, inject_group=False), endpoint
+            self._client.request_json("post", endpoint, inject_group=self._client.has_owner_group),
+            endpoint,
         )
 
     def restore(self, uuid: str) -> dict:
@@ -453,7 +469,8 @@ class SoftDeleteMixin:
         """
         endpoint = f"{self._path}/{uuid}/restore"
         return _expect_dict(
-            self._client.request_json("post", endpoint, inject_group=False), endpoint
+            self._client.request_json("post", endpoint, inject_group=self._client.has_owner_group),
+            endpoint,
         )
 
     def permanent_delete(self, uuid: str, *, confirm: bool = False) -> dict:
@@ -483,7 +500,10 @@ class SoftDeleteMixin:
             )
         endpoint = f"{self._path}/{uuid}/permanent-delete"
         return _expect_dict(
-            self._client.request_json("delete", endpoint, inject_group=False), endpoint
+            self._client.request_json(
+                "delete", endpoint, inject_group=self._client.has_owner_group
+            ),
+            endpoint,
         )
 
 

icmd/apps/comments.py

@@ -0,0 +1,34 @@
+"""Discussion comments and your comment notifications (``/api/v2/comments/``).
+
+A discussion belongs to one item (a job, dataset, composition, ...), named by
+``target_type`` and ``target_id``.  Listing needs both, and a new comment
+carries them in its body::
+
+    icmd = ICMD("icmd.ai")
+    on_job = {"target_type": "job", "target_id": "<uuid>"}
+    icmd.comments.comment.list(**on_job)
+    icmd.comments.comment.add({**on_job, "body": "Looks good"})
+
+A comment's ``delete`` is final: nothing restores it.  Notifications are the
+caller's own feed, list-only; mark them read through
+``icmd.comments.notification.action("mark_all_read", method="post")``.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from .base import ReadOnlyResource, Resource
+
+if TYPE_CHECKING:
+    from icmd.core.session import ResourceClient
+
+
+class CommentsApp:
+    """Discussion comments and comment notifications."""
+
+    __slots__ = ("comment", "notification")
+
+    def __init__(self, client: ResourceClient) -> None:
+        self.comment = Resource(client, "comments")
+        self.notification = ReadOnlyResource(client, "comments/notifications")

icmd/apps/jobs.py

@@ -620,14 +620,16 @@ class JobResource(ReadOnlyResource):
         """Get the current status of a job (``GET /jobs/{uuid}/status/``)."""
         endpoint = f"{self._path}/{uuid}/status"
         return _expect_dict(
-            self._client.request_json("get", endpoint, inject_group=False), endpoint
+            self._client.request_json("get", endpoint, inject_group=self._client.has_owner_group),
+            endpoint,
         )
 
     def cancel(self, uuid: str) -> dict:
         """Cancel a running job (``POST /jobs/{uuid}/cancel/``)."""
         endpoint = f"{self._path}/{uuid}/cancel"
         return _expect_dict(
-            self._client.request_json("post", endpoint, inject_group=False), endpoint
+            self._client.request_json("post", endpoint, inject_group=self._client.has_owner_group),
+            endpoint,
         )
 
     def check_status(self, uuid: str) -> tuple[str, dict]:
@@ -671,7 +673,9 @@ class JobResource(ReadOnlyResource):
         if from_timestamp is not None:
             params["from_timestamp"] = from_timestamp
         return _expect_dict(  # type: ignore[return-value]
-            self._client.request_json("get", endpoint, inject_group=False, params=params or None),
+            self._client.request_json(
+                "get", endpoint, inject_group=self._client.has_owner_group, params=params or None
+            ),
             endpoint,
         )
 
@@ -690,7 +694,9 @@ class JobResource(ReadOnlyResource):
         """
         endpoint = f"{self._path}/{uuid}/log-entries"
         return _expect_dict(
-            self._client.request_json("get", endpoint, inject_group=False, params=params or None),
+            self._client.request_json(
+                "get", endpoint, inject_group=self._client.has_owner_group, params=params or None
+            ),
             endpoint,
         )
 
@@ -845,7 +851,9 @@ class JobResource(ReadOnlyResource):
         """
         endpoint = f"{self._path}/{uuid}"
         return _expect_dict(
-            self._client.request_json("delete", endpoint, inject_group=False),
+            self._client.request_json(
+                "delete", endpoint, inject_group=self._client.has_owner_group
+            ),
             endpoint,
         )
 
@@ -869,7 +877,9 @@ class JobResource(ReadOnlyResource):
             )
         endpoint = f"{self._path}/{uuid}/permanent-delete"
         return _expect_dict(
-            self._client.request_json("delete", endpoint, inject_group=False),
+            self._client.request_json(
+                "delete", endpoint, inject_group=self._client.has_owner_group
+            ),
             endpoint,
         )
 
@@ -1530,7 +1540,7 @@ class JobResource(ReadOnlyResource):
             self._client.request_json(
                 "post",
                 f"{self._path}/{uuid}/attach-plot",
-                inject_group=False,
+                inject_group=self._client.has_owner_group,
                 data={"source": json.dumps(transfer._plot_header(source), allow_nan=False)},
                 **transfer._figure_part(figure),
             ),

icmd/apps/results.py

@@ -228,7 +228,9 @@ class ResultsResource(ReadOnlyResource):
         dict
             The result record.
         """
-        return self.get(uuid, params={"admin": "true"} if admin else None, inject_group=admin)
+        return self.get(
+            uuid, params={"admin": "true"} if admin else None, inject_group=True if admin else None
+        )
 
     def grant(
         self,

icmd/cli/commands.py

@@ -370,10 +370,9 @@ _DETAIL_ROUTE_CAUSES = (
     "a project you cannot reach",
 )
 
-#: What ``log`` — and ``action --id`` when ``--param`` carried no
-#: ``owner_group`` — must say about scope: both call
-#: ``request_json(..., inject_group=False)``, so naming a group here would name
-#: one the client never transmitted.
+#: What a detail command's 404 says about scope when it sent no group.  The CLI
+#: client holds a group only for an explicit ``--group``; without one, naming a
+#: group here would name one the client never transmitted.
 _NO_GROUP_SENT = (
     "none was sent, so the server used your current_group — whatever you last "
     "selected in the web UI"
@@ -978,11 +977,12 @@ def _make_permanent_delete_cmd(path: str) -> click.Command:
 
 
 #: The two halves of a detail action's scope, each offered on a 404 only when
-#: ``--param`` did not already carry it: telling callers to re-run the flag
-#: they just typed is the wild-goose chase :func:`_explaining_404` exists to end.
+#: the call did not already send it (through ``--param``, or ``--group`` for the
+#: group): telling callers to re-run the flag they just typed is the
+#: wild-goose chase :func:`_explaining_404` exists to end.
 _ACTION_GROUP_REMEDY = (
-    "Add --param owner_group=<id> to scope the call explicitly — action sends "
-    "no group on a detail route."
+    "Add --group <name|id> or --param owner_group=<id> to scope the call "
+    "explicitly — without either, action sends no group on a detail route."
 )
 _ACTION_ADMIN_REMEDY = (
     "Add --param admin=true where the route honours it: it resolves the id as "
@@ -1013,6 +1013,7 @@ def _action_explanation(  # noqa: PLR0913 — each input decides a part of the m
     uuid: str | None,
     method: str,
     query: dict[str, str],
+    client: Any,
 ) -> contextlib.AbstractContextManager[None]:
     """Build the ``404`` annotation an ``action`` call runs under.
 
@@ -1021,10 +1022,13 @@ def _action_explanation(  # noqa: PLR0913 — each input decides a part of the m
     """
     if not uuid:
         return contextlib.nullcontext()
-    # ``action`` transmits no scope of its own, so ``--param`` is the whole
-    # truth about one: report the group the caller actually sent, and offer
-    # only the half they left out.
+    # Report the group the caller actually sent, and offer only the half they
+    # left out: ``--param owner_group`` wins, else the SDK pins the client's
+    # group, which the CLI holds only for an explicit ``--group``.
     sent_group = query.get("owner_group")
+    if "owner_group" not in query and client.has_owner_group:
+        held = client.owner_group
+        sent_group = f"{held['id']} ({held['name']})"
     remedies: tuple[str, ...] = ()
     if not sent_group:
         remedies += (_ACTION_GROUP_REMEDY,)
@@ -1040,6 +1044,14 @@ def _action_explanation(  # noqa: PLR0913 — each input decides a part of the m
     return _explaining_404(uuid, scope=scope, remedies=remedies, cause=_action_name_cause(name))
 
 
+#: ``action`` names that cannot be undone whatever their method, so they take
+#: ``--yes`` like a ``--method delete``.  The backend's MCP server confirms the
+#: same set, and its CLI parity test compares the two.
+IRREVERSIBLE_ACTIONS: frozenset[str] = frozenset(
+    {"permanent-delete", "empty-trash", "detach-plot", "transfer-ownership", "developer-access"}
+)
+
+
 def _make_action_cmd(path: str) -> click.Command:
     """Build a generic ``action`` command — the CLI escape hatch for custom actions.
 
@@ -1078,7 +1090,10 @@ def _make_action_cmd(path: str) -> click.Command:
         "assume_yes",
         is_flag=True,
         default=False,
-        help="Skip the confirmation prompt for a destructive (--method delete) action.",
+        help=(
+            "Skip the confirmation prompt for a destructive action: any --method delete, "
+            f"and {', '.join(sorted(IRREVERSIBLE_ACTIONS))}."
+        ),
     )
     @_global_options
     def action_cmd(**opts: Any) -> None:
@@ -1086,14 +1101,20 @@ def _make_action_cmd(path: str) -> click.Command:
         body, body_file = opts["body"], opts["body_file"]
         data = _load_json_body(body, body_file) if (body or body_file) else None
         query = _parse_param_pairs(opts["params"])
-        if opts["method"] == "delete":
-            target = "/".join(p for p in (path, opts["uuid"], opts["name"]) if p)
+        # Gate on the URL's last segment, not NAME: ``--id`` may carry the action itself.
+        target = "/".join(p for p in (path, opts["uuid"], opts["name"]) if p)
+        if (
+            opts["method"] == "delete"
+            or target.strip("/").rsplit("/", 1)[-1] in IRREVERSIBLE_ACTIONS
+        ):
             _confirm_destructive(
-                f"Run destructive action DELETE {target}? This may be irreversible.",
+                f"Run destructive action {opts['method'].upper()} {target}? "
+                "This may be irreversible.",
                 yes=opts["assume_yes"],
             )
         ctx = click.get_current_context()
-        resource = _get_client_and_resource(ctx, path)
+        client = _build_client(ctx)
+        resource = Resource(client, path)
         with _action_explanation(
             ctx,
             path=path,
@@ -1101,6 +1122,7 @@ def _make_action_cmd(path: str) -> click.Command:
             uuid=opts["uuid"],
             method=opts["method"],
             query=query,
+            client=client,
         ):
             result = resource.action(
                 opts["name"],
@@ -1232,23 +1254,31 @@ def _make_log_cmd(path: str) -> click.Command:
         client = _build_client(ctx)
         endpoint = f"{path}/{resource_id}/logs"
 
-        # ``action logs --id`` reaches this exact endpoint by construction, and
-        # unlike ``log`` it can carry an explicit scope through ``--param``.
-        remedy = (
-            f"`{ctx.parent.command_path} action logs --id {resource_id} "  # type: ignore[union-attr]
-            "--param owner_group=<id> --param admin=true` reaches the same "
-            "endpoint with an explicit scope — log sends neither."
-        )
         # ``log`` is declared on ``studio/jobs`` alone (``registry.py:149``), so
         # the ``accessible-group`` sentence needs no path check here.
-        remedies = (remedy, _accessible_group_remedy(ctx, resource_id))
-        with _explaining_404(resource_id, scope=_NO_GROUP_SENT, remedies=remedies):
+        # ``action logs --id`` reaches this exact endpoint by construction, and
+        # unlike ``log`` it can also send ``admin=true``.
+        action_logs = f"`{ctx.parent.command_path} action logs --id {resource_id}"  # type: ignore[union-attr]
+        if client.has_owner_group:
+            group = client.owner_group
+            scope = f"?owner_group={group['id']} ({group['name']}) was sent"
+            admin_remedy = (
+                f"{action_logs} --group <name|id> --param admin=true` reads them as a group admin."
+            )
+        else:
+            scope = f"{_NO_GROUP_SENT}; pass --group <name|id> to name one"
+            admin_remedy = (
+                f"{action_logs} --param owner_group=<id> --param admin=true` reaches "
+                "the same endpoint with an explicit scope — log sent neither."
+            )
+        remedies = (admin_remedy, _accessible_group_remedy(ctx, resource_id))
+        with _explaining_404(resource_id, scope=scope, remedies=remedies):
             if not follow:
                 params: dict[str, str] = {}
                 if from_timestamp is not None:
                     params["from_timestamp"] = from_timestamp
                 result = client.request_json(
-                    "get", endpoint, inject_group=False, params=params or None
+                    "get", endpoint, inject_group=client.has_owner_group, params=params or None
                 )
                 write_output(result, fmt=_format(ctx))
                 return
@@ -1274,7 +1304,9 @@ def _fetch_log_page(client: Any, endpoint: str, next_ts: str | None) -> dict[str
     params: dict[str, str] = {}
     if next_ts is not None:
         params["from_timestamp"] = next_ts
-    result = client.request_json("get", endpoint, inject_group=False, params=params or None)
+    result = client.request_json(
+        "get", endpoint, inject_group=client.has_owner_group, params=params or None
+    )
     if not isinstance(result, dict):
         raise click.ClickException(
             f"Unexpected log response from {endpoint}: expected dict, got {type(result).__name__}"

icmd/cli/registry.py

@@ -392,4 +392,28 @@ APP_REGISTRY: tuple[AppSpec, ...] = (
             ),
         ),
     ),
+    AppSpec(
+        "comments",
+        "Discussion comments and your comment notifications",
+        resources=(
+            # ``DELETE`` trashes a comment, but nothing restores it: ``hard``.
+            ResourceSpec(
+                "comment",
+                "comments",
+                writable=True,
+                delete_style="hard",
+                help=(
+                    "Comments on a job, dataset or other item "
+                    "(list needs --param target_type=job --param target_id=<uuid>)"
+                ),
+            ),
+            # Recipient-scoped and list-only: there is no detail ``GET``.
+            ResourceSpec(
+                "notification",
+                "comments/notifications",
+                actions=("list", "action"),
+                help="Your comment notifications (mark_read etc. via `action`)",
+            ),
+        ),
+    ),
 )

icmd/client.py

@@ -9,7 +9,7 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any
 
-from .apps import AccountApp, AgentApp, StudioApp, SuiteApp, WorkspaceApp
+from .apps import AccountApp, AgentApp, CommentsApp, StudioApp, SuiteApp, WorkspaceApp
 from .apps.base import _expect_dict
 from .core.auth import Authenticator
 
@@ -124,6 +124,7 @@ class ICMD:
         self.studio = StudioApp(self)
         self.workspace = WorkspaceApp(self)
         self.agent = AgentApp(self)
+        self.comments = CommentsApp(self)
         self.account = AccountApp(self)
 
     # -----------------------------------------------------------------
@@ -433,6 +434,16 @@ class ICMD:
         """Return the active owner group as a full group dict."""
         return self._groups.owner_group
 
+    @property
+    def has_owner_group(self) -> bool:
+        """Whether this client already holds an owner group.
+
+        Set by the ``owner_group`` constructor argument, by
+        :meth:`set_owner_group`, or by the first request that resolved one.
+        Reading it never resolves a group, so it never prompts.
+        """
+        return self._groups.has_owner_group
+
     # -----------------------------------------------------------------
     # Group management
     # -----------------------------------------------------------------
@@ -474,7 +485,8 @@ class ICMD:
         ----------
         inject_group : bool
             If ``True`` (default), automatically inject the active
-            ``owner_group`` as a query parameter.  ``False`` suppresses that
+            ``owner_group`` as a query parameter; an ``owner_group`` already
+            in ``params`` is sent as given.  ``False`` suppresses that
             injection: group-scoped detail routes then fall back to the
             caller's server-side ``current_group``, while other endpoints
             apply their own scoping.  It does not request a cross-group

icmd/core/groups.py

@@ -71,6 +71,11 @@ class GroupManager:
             self._owner_group = self._resolve_owner_group()
         return self._owner_group
 
+    @property
+    def has_owner_group(self) -> bool:
+        """Whether a group is already held, without resolving one."""
+        return self._owner_group is not None
+
     def set_owner_group(self, group: int | str | None = None) -> None:
         """Set the owner group for subsequent API operations.
 
@@ -123,13 +128,15 @@ class GroupManager:
     def inject_params(self, kwargs: dict[str, Any]) -> None:
         """Inject ``owner_group`` as a query parameter, resolving lazily if needed.
 
-        No recursion risk: :meth:`_resolve_owner_group` fetches groups via
-        ``Session.request_json`` directly, which does not call back into
-        this method.
+        An ``owner_group`` the caller already names in ``params`` is sent as
+        given, and no group is resolved for it.  The caller's dict is copied,
+        never mutated.  No recursion risk: :meth:`_resolve_owner_group`
+        fetches groups via ``Session.request_json`` directly, which does not
+        call back into this method.
         """
-        group = self.owner_group
-        params = kwargs.get("params") or {}
-        params["owner_group"] = group["id"]
+        params = dict(kwargs.get("params") or {})
+        if params.get("owner_group") is None:
+            params["owner_group"] = self.owner_group["id"]
         kwargs["params"] = params
 
     # -----------------------------------------------------------------

icmd/core/session.py

@@ -69,6 +69,11 @@ class ResourceClient(Protocol):
 
     contracts: ContractClient
 
+    @property
+    def has_owner_group(self) -> bool:
+        """Whether an owner group is already held, without resolving one."""
+        ...
+
     def request_json(
         self,
         method: HTTPMethod,

icmd/version.py

@@ -1 +1 @@
-__version__ = "3.10.0"
+__version__ = "3.11.0"

{icmd_python-3.10.0.dist-info → icmd_python-3.11.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: icmd-python
-Version: 3.10.0
+Version: 3.11.0
 Summary: Python client app for ICMD®
 Author: QuesTek Innovations LLC
 License-Expression: LicenseRef-Proprietary
@@ -116,8 +116,8 @@ errors go to stderr.
 
 - `ICMD` — the client facade. Constructing it authenticates (interactive sign-in, a developer
   token, or a stored credential) and binds the session to one tenant.
-- `client.suite`, `client.studio`, `client.workspace`, `client.agent`, `client.account` — the API
-  areas. Most expose resource objects with a uniform surface: `list()` and `list_all()`, `get()`,
+- `client.suite`, `client.studio`, `client.workspace`, `client.agent`, `client.account`,
+  `client.comments` — the API areas. Most expose resource objects with a uniform surface: `list()` and `list_all()`, `get()`,
   and, where the endpoint allows it, `add()`, `update()`, and `delete()`.
 - `client.contracts` — model contracts fetched from the server, and the advisory check that reads
   a job input against them.

{icmd_python-3.10.0.dist-info → icmd_python-3.11.0.dist-info}/RECORD

@@ -1,21 +1,22 @@
 icmd/__init__.py,sha256=-2i4tJ69UAb547_LPnAVrglNc1ZRRTce5Ju2BoKzaDc,3109
-icmd/client.py,sha256=eXWJuoHX2cv7B30Vha5aCAOoR5nE-y8u4d2V0d-_SU4,22600
+icmd/client.py,sha256=0mHPuWCvfv-urlTRqOvjmaBwFNt09XR1nmr-4QSRk3Q,23098
 icmd/compose.py,sha256=-xkfVsqvNejYnaxvddlidNpzLE1tZ59Qdj8DZq1yENQ,7089
 icmd/links.py,sha256=I8v8_xhI6lbUwrMjIUcYYcqKUi2PIPm6zQ7mXYP9A5E,6827
 icmd/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 icmd/types.py,sha256=af26gLTblS33vhlYdHLSPKY7Rm1shJDDOpzauCeOxAE,81323
-icmd/version.py,sha256=iKJAvc5i0UTDDSSefTGL0Tq-kWQ4S3OJJgvyaQfQNF8,23
+icmd/version.py,sha256=cpptu6yAKjujkKCECVRXYkw3SmUpyBiTvJvB3Mmcu5s,23
 icmd/_vendor/__init__.py,sha256=VFA4EQd2l76sxgkHPUpgzZavFF6kFdpq9v71AZsPIdQ,579
 icmd/_vendor/assembler.py,sha256=2KpvpIARfcM2H1mE3ajKT6ukaEnE5cKztSySpsSq8ZA,5776
-icmd/apps/__init__.py,sha256=ak2ch1UU-qaiyOT1eCdRwqSI0Avhzyw5DLkw-U2ivQQ,659
+icmd/apps/__init__.py,sha256=Bg6rR2Zt38OHdBBwGKBzSqbsDW8chVM9KwjZ4IGODXE,712
 icmd/apps/account.py,sha256=BWDO0Zysv0ygLVhbeIk82BjsvuDVb_vBdu6jqBPw3tc,14557
-icmd/apps/agent.py,sha256=MmWuH1sYqo-hOhNNuTwh930H_BFXs7oMP0QgyzaC0Iw,8387
-icmd/apps/base.py,sha256=SHqvtkHTxNIYRZMV2BMG-SVTWl_3iPm4WVINUbjmGN4,18983
+icmd/apps/agent.py,sha256=EasQ0ZHbBbqXauAcoSym-eK2TOFDbdd2XGJPnKYBx6k,8467
+icmd/apps/base.py,sha256=kyowDVglcXok90DiM4GuGEObusH1m86ZWbWKLiGT8Aw,19931
+icmd/apps/comments.py,sha256=gnsyQvUVkSix4nxRjqHr2Jpz69iDQmbMmOTM5IClmWQ,1152
 icmd/apps/constants.py,sha256=5xoIwFNGOaAp2cHAlVDlbzJ7ObQHYXJgVGMBfNLCHzI,757
 icmd/apps/documents.py,sha256=8_wFc7NLUFQMYZA5hqsciXniHECZEWS-egX_ni8F4LE,3720
-icmd/apps/jobs.py,sha256=ckjS8Uz2hVyTqsTPF14g7paKMHsaRg3jZ90lZLdTz-o,66924
+icmd/apps/jobs.py,sha256=-OFCJNgeBJGfuq4joA29NHDcP4ZMLSc24VYN3NonuRA,67231
 icmd/apps/navigation.py,sha256=mbEJG33Z-Nha5txvMpL63sT-UqsgFgZ-NMhTU7L7gI0,3738
-icmd/apps/results.py,sha256=9Bh6DaZ7oDxrKxWsZxSVCBxKFLYd_3dASTaYhAhR6iQ,18224
+icmd/apps/results.py,sha256=vXT3mVZSNn_to_zYw3tO_SMIc1YpKbYxjBd_aOizRHI,18264
 icmd/apps/results_store.py,sha256=19g6XQVBpKGLC3o1RU_Dn6IV83Qtaq3i1d41m5yBQf4,12439
 icmd/apps/studio.py,sha256=XN6gVCqkTzp7qH9I-UOhW7UJ2RfkGv60H-G7ulkR850,2419
 icmd/apps/suite.py,sha256=1XT8aKPn15W-bwBdOz-JV3Wrmr_JOKyrMEC6--ljj9A,3907
@@ -27,12 +28,12 @@ icmd/cli/account.py,sha256=equTAGWR3NCCMYEPTw4IZKHEtBEdGD8F4Pp8cfiSNoU,13859
 icmd/cli/auth.py,sha256=UFpEf-lLlkbphivgBfd9NxAEqHcCsPmEl-DXet-NStg,3317
 icmd/cli/auth_status.py,sha256=6wkI3Q0c-t8DBOfuPaN_xXEUcL9HLZm1jX4lQ76X3Ag,13505
 icmd/cli/client.py,sha256=3iToPSABFYWWUPn-uDVFAv9GoBWQXP04l2Id_aYgd64,2186
-icmd/cli/commands.py,sha256=srDoAMF5kiMxph0vUKpo1urRt7CEaH7Lgrb1TiksWmk,63707
+icmd/cli/commands.py,sha256=z_LngviZ5tcMJx-gmsFfllAYpxvhsNqNFra2aVDrQ9Q,65158
 icmd/cli/diagnostics.py,sha256=1fXgKmpUMA5U-_79AzZ0uSibFmDTK_CLCe91YhBnM8s,2747
 icmd/cli/domain.py,sha256=MiGzdKwKaOEvMshsPPJTmdBm7pCTjGM98MOg9RhAL_k,874
 icmd/cli/links.py,sha256=7CMhKUJ-qKQmk2I-KCdn6oF06cdCq0v5jQDGU7gEJ30,14039
 icmd/cli/output.py,sha256=-TKZ8fJYCUhh7qHRNAZyFYFaXcMDqm4NDR2qFfErg5A,1190
-icmd/cli/registry.py,sha256=zUMbuDXLYO442J54Ivns_exFxYRwjnefA3zMrd1vaG4,16697
+icmd/cli/registry.py,sha256=MEkqcu2b6ZjfmE2L2L062PxTjOTjlVEyYSycTv_tq30,17577
 icmd/core/__init__.py,sha256=45q0vlUao61rG6ugufGTRtoDeBTDcscU5dLAMluDSBA,225
 icmd/core/advisory.py,sha256=9zB2Ew5RKtwwDKTYF3nPYSuv5SnHCEthriYfTr6Tzko,22707
 icmd/core/auth.py,sha256=bG6eLbSkmyDWLyprx7NJMDwLTGsOIrsRdBZ3f6vz1vk,29480
@@ -41,12 +42,12 @@ icmd/core/contracts.py,sha256=uHybwSxBHV4l6M4ho4ECRKitXm4lMbBroFhGxim0V0I,10690
 icmd/core/credentials.py,sha256=39vyoFH1_MrzD9TpTh4FVPhWbrY5X35zGCS22KeTi_8,46835
 icmd/core/display.py,sha256=RkgJhr2Bfw3-ZjGvE100ddD6oyAAUUAJfBAy6DvX5ik,13060
 icmd/core/exceptions.py,sha256=Lv9zPMqZqZW8O-QqZ8AThF2u9xcGv-yfHWk1Vl6FKeA,12663
-icmd/core/groups.py,sha256=OFbQce42DLDK0rDAdMbh8H7imNPAkBJMl7o7tbKQ4Iw,7211
+icmd/core/groups.py,sha256=BEwpBEe60l_8HpnsIvLPC3EhLSXnv-qyo-OZIyP0sWI,7585
 icmd/core/model_classes.py,sha256=uuhJwh_AZ69eOp8SoWYo0MM5rNwA_a-vkxhrIwFasds,40372
-icmd/core/session.py,sha256=UmpcixYEhBYgDJyd0ijXKhCXTK426XzbNzTCzSDM9WM,60759
-icmd_python-3.10.0.dist-info/licenses/LICENSE,sha256=644lGvCmDFa5hQl6xdhaYk3o-1oWqPXAIiiQlvqeZdE,1028
-icmd_python-3.10.0.dist-info/METADATA,sha256=oZpNJbpbNkS1w1Jx46TR3p3x2KMeySULtmpFnIEX-lE,5339
-icmd_python-3.10.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-icmd_python-3.10.0.dist-info/entry_points.txt,sha256=CFX537PlyyPQL3Q_3TKUFeiiDSkOAboqaLEy9AIEwVU,39
-icmd_python-3.10.0.dist-info/top_level.txt,sha256=olzM6Z_QEwg7RrFVOnkgO0I2Ps2m7vhSqYQZYeiawcw,5
-icmd_python-3.10.0.dist-info/RECORD,,
+icmd/core/session.py,sha256=I3X0z2ZZm9H68NLnOOs4vS6sn4THWLNjvgUcBDJB5i8,60902
+icmd_python-3.11.0.dist-info/licenses/LICENSE,sha256=644lGvCmDFa5hQl6xdhaYk3o-1oWqPXAIiiQlvqeZdE,1028
+icmd_python-3.11.0.dist-info/METADATA,sha256=47PYNTfR1-9e39BnnlAHFJQSOOfoWcQy6r2OHGcs59c,5358
+icmd_python-3.11.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+icmd_python-3.11.0.dist-info/entry_points.txt,sha256=CFX537PlyyPQL3Q_3TKUFeiiDSkOAboqaLEy9AIEwVU,39
+icmd_python-3.11.0.dist-info/top_level.txt,sha256=olzM6Z_QEwg7RrFVOnkgO0I2Ps2m7vhSqYQZYeiawcw,5
+icmd_python-3.11.0.dist-info/RECORD,,

{icmd_python-3.10.0.dist-info → icmd_python-3.11.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (84.0.0)
+Generator: setuptools (84.2.1)
 Root-Is-Purelib: true
 Tag: py3-none-any