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

icmd/__init__.py

@@ -6,14 +6,20 @@ from .core.advisory import AdvisoryFinding, ContractProvider, check_input_dict
 from .core.contracts import ContractClient, ContractTransport
 from .core.exceptions import (
     ICMDAuthenticationError,
+    ICMDChecksumMismatchError,
     ICMDConnectionError,
     ICMDContractUnavailableError,
+    ICMDMissingDependencyError,
+    ICMDModelMigrationError,
     ICMDRefreshNetworkError,
     ICMDRefreshRateLimitedError,
     ICMDRefreshResponseError,
     ICMDRefreshTokenInvalidError,
     ICMDRefreshUnavailableError,
+    ICMDReleaseRefusedError,
     ICMDRequestError,
+    ICMDResultsChangedError,
+    ICMDResultsRefusedError,
     ICMDTokenRefreshError,
     ICMDValidationError,
 )
@@ -83,14 +89,20 @@ __all__ = [
     "GridSampling",
     "GridVariable",
     "ICMDAuthenticationError",
+    "ICMDChecksumMismatchError",
     "ICMDConnectionError",
     "ICMDContractUnavailableError",
+    "ICMDMissingDependencyError",
+    "ICMDModelMigrationError",
     "ICMDRefreshNetworkError",
     "ICMDRefreshRateLimitedError",
     "ICMDRefreshResponseError",
     "ICMDRefreshTokenInvalidError",
     "ICMDRefreshUnavailableError",
+    "ICMDReleaseRefusedError",
     "ICMDRequestError",
+    "ICMDResultsChangedError",
+    "ICMDResultsRefusedError",
     "ICMDTokenRefreshError",
     "ICMDValidationError",
     "LatinHypercubeSampling",

icmd/_vendor/assembler.py

@@ -23,7 +23,9 @@ __all__ = [
     "build_design_document",
 ]
 
-#: The scenario discriminator this assembler emits into ``qt_model_inputs``.
+#: The scenario discriminator inside ``qt_model_inputs``.  A catalog node
+#: carries ``qt_model.scenario_key`` instead and the backend derives this from
+#: it; a trained-model node, whose scenarios have no key, still carries it.
 #: Exported so consumers that must recognize it -- notably the advisory check,
 #: which excludes it from contract validation -- bind to this module rather than
 #: re-spelling the literal.  Renaming it here must not leave a stale copy behind.
@@ -83,23 +85,29 @@ def assemble_model_inputs(inputs: Mapping[str, Any]) -> list[dict[str, Any]]:
 
 
 def assemble_model_node(
-    name: str,
+    key: str,
     model_uuid: str,
     inputs: Mapping[str, Any],
-    scenario: str | None = None,
+    scenario_key: str | None = None,
     node_id: str | None = None,
 ) -> dict[str, Any]:
     """Build one model workflow node without model lookup or validation.
 
-    ``node_id`` identifies this workflow instance. The catalog ``model_uuid``
-    remains in ``qt_model.uuid`` and is used only as the default node id.
+    The node is identified by ``qt_model.key`` and ``qt_model.scenario_key``.
+    The backend derives the ``__meta_scenario`` title from the scenario key, so
+    a discriminator in *inputs* is dropped when one is given rather than sent
+    as a second, possibly stale, answer. ``node_id`` identifies this workflow
+    instance. The catalog ``model_uuid`` remains in ``qt_model.uuid`` and is
+    used only as the default node id.
     """
     model_inputs = deepcopy(dict(inputs))
-    if scenario is not None:
-        model_inputs[SCENARIO_KEY] = {"title": scenario}
+    qt_model = {"key": key, "uuid": model_uuid}
+    if scenario_key is not None:
+        qt_model["scenario_key"] = scenario_key
+        model_inputs.pop(SCENARIO_KEY, None)
     return {
         "id": model_uuid if node_id is None else node_id,
-        "qt_model": {"name": name, "uuid": model_uuid},
+        "qt_model": qt_model,
         "qt_model_inputs": assemble_model_inputs(model_inputs),
     }
 

icmd/apps/agent.py

@@ -212,5 +212,16 @@ class AgentApp:
         return self._client.request_json("get", "agent/providers")
 
     def usage(self) -> dict | list[dict]:
-        """Get the group's monthly Assist token usage (``GET agent/assist/usage``)."""
+        """Get the group's Assist credit balance (``GET agent/assist/usage``).
+
+        Group admins only.
+
+        Returns
+        -------
+        dict
+            ``granted``, ``used``, ``balance`` and ``month_used`` in credits,
+            and ``status`` (``"ok"`` / ``"low"`` / ``"out"``).  ``balance``
+            can be negative.  An unmetered group returns ``None`` for all five
+            keys, ``status`` included.
+        """
         return self._client.request_json("get", "agent/assist/usage")

icmd/apps/base.py

@@ -274,7 +274,7 @@ class ReadOnlyResource:
         Parameters
         ----------
         name : str
-            The action's ``url_path`` (e.g. ``"resubmit"``,
+            The action's ``url_path`` (e.g. ``"submit-draft"``,
             ``"queue-position"``, ``"save-calibration"``).
         uuid : str | None
             When given, the action is detail-scoped to this resource UUID.