dirigent-client 0.18.0__tar.gz → 0.18.2__tar.gz

{dirigent_client-0.18.0 → dirigent_client-0.18.2}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: dirigent-client
-Version: 0.18.0
+Version: 0.18.2
 Summary: The dirigent API contract: typed wire schemas and an async Python client.
 License-Expression: LicenseRef-Proprietary
 License-File: LICENSE
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: dirigent-common==0.18.0
+Requires-Dist: dirigent-common==0.18.2
 Requires-Dist: httpx2>=2.12.0
 Requires-Dist: pydantic>=2.13.5
 Requires-Dist: pyyaml>=6.0.3

{dirigent_client-0.18.0 → dirigent_client-0.18.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dirigent-client"
-version = "0.18.0"
+version = "0.18.2"
 description = "The dirigent API contract: typed wire schemas and an async Python client."
 readme = "README.md"
 requires-python = ">=3.13"
@@ -11,7 +11,7 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "dirigent-common==0.18.0",
+    "dirigent-common==0.18.2",
     "httpx2>=2.12.0",
     "pydantic>=2.13.5",
     "pyyaml>=6.0.3",

{dirigent_client-0.18.0 → dirigent_client-0.18.2}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "dirigent-client"
-version = "0.18.0"
+version = "0.18.2"
 description = "The dirigent API contract: typed wire schemas and an async Python client."
 readme = "README.md"
 requires-python = ">=3.13"
@@ -11,7 +11,7 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "dirigent-common==0.18.0",
+    "dirigent-common==0.18.2",
     "httpx2>=2.12.0",
     "pydantic>=2.13.5",
     "pyyaml>=6.0.3",

{dirigent_client-0.18.0 → dirigent_client-0.18.2}/src/dirigent_client/__init__.py

@@ -8,6 +8,7 @@ from dirigent_client.enums import (
     AttemptStatus,
     DocumentKind,
     FiringOutcome,
+    Importance,
     LogLevel,
     NotificationStatus,
     ProvenanceSource,
@@ -36,6 +37,7 @@ from dirigent_client.errors import (
     WaitTimeout,
 )
 from dirigent_client.schemas import (
+    LOG_NOTIFIER,
     TERMINAL_RUN_STATUSES,
     AlertRuleIn,
     AlertRuleOut,
@@ -119,6 +121,7 @@ __all__ = [
     "TERMINAL_RUN_STATUSES",
     "VERSION_HEADER",
     "AlertEvent",
+    "LOG_NOTIFIER",
     "AlertRuleIn",
     "AlertRuleOut",
     "AlertScope",
@@ -161,6 +164,7 @@ __all__ = [
     "Health",
     "HookAccepted",
     "Identity",
+    "Importance",
     "IssuedTokenOut",
     "ItemOut",
     "JsonList",

{dirigent_client-0.18.0 → dirigent_client-0.18.2}/src/dirigent_client/enums.py

@@ -69,6 +69,22 @@ class RunPriority(StrEnum):
 PRIORITY_RANK: dict[RunPriority, int] = {RunPriority.LOW: 0, RunPriority.NORMAL: 1, RunPriority.HIGH: 2}
 
 
+class Importance(StrEnum):
+    """How much a pipeline matters when it goes wrong, which is not when its work is claimed."""
+
+    ROUTINE = "routine"
+    """Nothing downstream waits on it, and a failure keeps until someone looks."""
+
+    NORMAL = "normal"
+
+    CRITICAL = "critical"
+    """A failure is worth interrupting someone for."""
+
+
+#: What each importance is worth to a comparison, least first.
+IMPORTANCE_RANK: dict[Importance, int] = {Importance.ROUTINE: 0, Importance.NORMAL: 1, Importance.CRITICAL: 2}
+
+
 class TriggerKind(StrEnum):
     """What started a run."""
 

{dirigent_client-0.18.0 → dirigent_client-0.18.2}/src/dirigent_client/resources/alerts.py

@@ -3,7 +3,7 @@
 from datetime import timedelta
 from uuid import UUID
 
-from dirigent_client.enums import AlertEvent, AlertScope
+from dirigent_client.enums import AlertEvent, AlertScope, Importance
 from dirigent_client.resources.base import Resource, query, request_body
 from dirigent_client.schemas import (
     AlertRuleIn,
@@ -31,23 +31,23 @@ class Alerts(Resource):
         name: str | None = None,
         description: str | None = None,
         event: AlertEvent,
-        notifier: str,
         scope: AlertScope = AlertScope.GLOBAL,
         pipeline: str | None = None,
+        importance: Importance | None = None,
         connection: str | None = None,
         template: str | None = None,
         body: str | None = None,
         throttle: timedelta | str = timedelta(0),
     ) -> AlertRuleOut:
-        """Declare an alert rule, refusing a notifier or a pipeline this instance does not have."""
+        """Declare an alert rule, refusing a target or a pipeline this instance does not have."""
         payload = AlertRuleIn(
             code=code,
             name=name,
             description=description,
             event=event,
-            notifier=notifier,
             scope=scope,
             pipeline=pipeline,
+            importance=importance,
             connection=connection,
             template=template,
             body=body,
@@ -66,13 +66,15 @@ class Alerts(Resource):
         paused: bool | None = None,
         template: str | None = None,
         body: str | None = None,
+        importance: Importance | None = None,
+        connection: str | None = None,
     ) -> AlertRuleOut:
-        """Change what a rule says or whether it delivers.
+        """Change what a rule says, where it delivers, or whether it delivers at all.
 
         A field this call was not given is absent from the body, which is how the endpoint
         tells "leave it alone" from "clear it".
         """
-        named = query(paused=paused, template=template, body=body)
+        named = query(paused=paused, template=template, body=body, importance=importance, connection=connection)
         body_json = AlertRuleUpdate.model_validate(named).model_dump(mode="json", exclude_unset=True)
         return await self._one(AlertRuleOut, "PATCH", f"/alert-rules/{code}", json=body_json)
 
@@ -83,13 +85,12 @@ class Alerts(Resource):
     async def test(
         self,
         *,
-        notifier: str,
         connection: str | None = None,
         subject: str | None = None,
         body: str | None = None,
     ) -> TestQueued:
-        """Queue one message through a channel, on the same path a real alert takes."""
-        declared = TestRequest(notifier=notifier, connection=connection)
+        """Queue one message through the target a rule would name, on the path a real alert takes."""
+        declared = TestRequest(connection=connection)
         payload = declared.model_copy(
             update=query(subject=subject, body=body),
         )

{dirigent_client-0.18.0 → dirigent_client-0.18.2}/src/dirigent_client/schemas/__init__.py

@@ -1,6 +1,7 @@
 """The wire schemas: one definition of every shape the REST API accepts and answers with."""
 
 from dirigent_client.schemas.alerts import (
+    LOG_NOTIFIER,
     AlertRuleIn,
     AlertRuleOut,
     AlertRuleUpdate,
@@ -87,6 +88,7 @@ from dirigent_common import JsonList, JsonMap
 
 __all__ = [
     "TERMINAL_RUN_STATUSES",
+    "LOG_NOTIFIER",
     "AlertRuleIn",
     "AlertRuleOut",
     "AlertRuleUpdate",

{dirigent_client-0.18.0 → dirigent_client-0.18.2}/src/dirigent_client/schemas/alerts.py

@@ -5,15 +5,28 @@ from uuid import UUID
 
 from pydantic import BaseModel, Field
 
-from dirigent_client.enums import AlertEvent, AlertScope, NotificationStatus
+from dirigent_client.enums import AlertEvent, AlertScope, Importance, NotificationStatus
 from dirigent_client.schemas.common import WireModel
 from dirigent_common import EntityName
 from dirigent_common.durations import Duration
 
+#: The notifier a rule that names no connection delivers through.
+LOG_NOTIFIER = "log"
+
 SUBJECT_HELP = "Subject, a Jinja template over the run's facts."
 
 BODY_HELP = "Body, a Jinja template over the run's facts; `report` is the run's report document when it has one."
 
+IMPORTANCE_HELP = "The least importance a pipeline must carry before this rule fires; absent fires for every one."
+
+CONNECTION_HELP = (
+    "The connection this rule delivers through, whose kind names the sender; absent delivers to the process log."
+)
+
+TEST_CONNECTION_HELP = (
+    "The connection this message delivers through, whose kind names the sender; absent delivers to the process log."
+)
+
 
 class AlertRuleIn(BaseModel):
     """An alert rule as a caller declares it."""
@@ -22,10 +35,10 @@ class AlertRuleIn(BaseModel):
     name: str | None = None
     description: str | None = None
     event: AlertEvent
-    notifier: str
     scope: AlertScope = AlertScope.GLOBAL
     pipeline: str | None = None
-    connection: str | None = None
+    importance: Importance | None = Field(default=None, description=IMPORTANCE_HELP)
+    connection: str | None = Field(default=None, description=CONNECTION_HELP)
     template: str | None = Field(default=None, description=SUBJECT_HELP)
     body: str | None = Field(default=None, description=BODY_HELP)
     throttle: Duration = timedelta(0)
@@ -41,7 +54,12 @@ class AlertRuleOut(WireModel):
     event: AlertEvent
     scope: AlertScope
     pipeline: str | None = None
+    importance: Importance | None = None
+    """The least importance a pipeline must carry before this rule fires."""
+
     notifier: str
+    """The sender this rule's target resolved to, which is its connection's kind or the log."""
+
     connection: str | None = None
     template: str | None = None
     body: str | None = None
@@ -61,6 +79,8 @@ class AlertRuleUpdate(BaseModel):
     paused: bool | None = None
     template: str | None = Field(default=None, description=SUBJECT_HELP)
     body: str | None = Field(default=None, description=BODY_HELP)
+    importance: Importance | None = Field(default=None, description=IMPORTANCE_HELP)
+    connection: str | None = Field(default=None, description=CONNECTION_HELP)
 
 
 class NotificationOut(WireModel):
@@ -85,10 +105,9 @@ class NotificationOut(WireModel):
 
 
 class TestRequest(BaseModel):
-    """Which channel to send a test message through, and what to say."""
+    """Which target to send a test message through, and what to say."""
 
-    notifier: str
-    connection: str | None = None
+    connection: str | None = Field(default=None, description=TEST_CONNECTION_HELP)
     subject: str = "dirigent test alert"
     body: str = "This is a test message sent through the notifier surface."
 

{dirigent_client-0.18.0 → dirigent_client-0.18.2}/src/dirigent_client/schemas/pipelines.py

@@ -7,7 +7,7 @@ from uuid import UUID
 
 from pydantic import AliasChoices, BaseModel, ConfigDict, Field, field_validator, model_validator
 
-from dirigent_client.enums import DocumentKind, LogLevel, ProvenanceSource, RunPriority, RunStatus
+from dirigent_client.enums import DocumentKind, Importance, LogLevel, ProvenanceSource, RunPriority, RunStatus
 from dirigent_client.messages import (
     EMPTY_LOG_LEVEL_PATTERN,
     WINDOW_HAS_TWO_ENDS,
@@ -64,6 +64,9 @@ class PipelineOut(WireModel):
     tags: list[str] = Field(default_factory=list[str])
     """What the current document says this pipeline is for."""
 
+    importance: Importance = Importance.NORMAL
+    """How much the current document says this pipeline matters."""
+
     active: bool
     current_version: int | None = None
     active_runs: int = 0