dirigent-client 0.26.0__tar.gz → 0.27.0__tar.gz

{dirigent_client-0.26.0 → dirigent_client-0.27.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: dirigent-client
-Version: 0.26.0
+Version: 0.27.0
 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.26.0
+Requires-Dist: dirigent-common==0.27.0
 Requires-Dist: httpx2>=2.12.0
 Requires-Dist: pydantic>=2.13.5
 Requires-Dist: pyyaml>=6.0.3

{dirigent_client-0.26.0 → dirigent_client-0.27.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dirigent-client"
-version = "0.26.0"
+version = "0.27.0"
 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.26.0",
+    "dirigent-common==0.27.0",
     "httpx2>=2.12.0",
     "pydantic>=2.13.5",
     "pyyaml>=6.0.3",

{dirigent_client-0.26.0 → dirigent_client-0.27.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "dirigent-client"
-version = "0.26.0"
+version = "0.27.0"
 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.26.0",
+    "dirigent-common==0.27.0",
     "httpx2>=2.12.0",
     "pydantic>=2.13.5",
     "pyyaml>=6.0.3",

{dirigent_client-0.26.0 → dirigent_client-0.27.0}/src/dirigent_client/__init__.py

@@ -23,7 +23,6 @@ from dirigent_client.enums import (
     TokenKind,
     TriggerKind,
     UserRole,
-    WebhookOutcome,
     WorkerStatus,
 )
 from dirigent_client.errors import (
@@ -68,14 +67,12 @@ from dirigent_client.schemas import (
     ConnectionUpdate,
     DagNode,
     DagView,
-    DeliveryOut,
     DiffSummary,
     EndpointInput,
     ExampleDetail,
     ExampleOut,
     FiringOut,
     Health,
-    HookAccepted,
     Identity,
     InputAccepted,
     IssuedTokenOut,
@@ -125,10 +122,6 @@ from dirigent_client.schemas import (
     UserIn,
     UserOut,
     ValidationIssue,
-    WatchOut,
-    WebhookIn,
-    WebhookOut,
-    WebhookTokenOut,
     WorkerOut,
 )
 from dirigent_client.transport import (
@@ -193,7 +186,6 @@ __all__ = [
     "DagNode",
     "DagView",
     "DocumentKind",
-    "DeliveryOut",
     "DiffSummary",
     "ExampleDetail",
     "ExampleOut",
@@ -203,7 +195,6 @@ __all__ = [
     "FiringOutcome",
     "Forbidden",
     "Health",
-    "HookAccepted",
     "Identity",
     "Importance",
     "IssuedTokenOut",
@@ -264,11 +255,6 @@ __all__ = [
     "ValidationFailed",
     "ValidationIssue",
     "WaitTimeout",
-    "WebhookIn",
-    "WebhookOut",
-    "WebhookOutcome",
-    "WatchOut",
-    "WebhookTokenOut",
     "WorkerOut",
     "WorkerStatus",
     "declared_label",

{dirigent_client-0.26.0 → dirigent_client-0.27.0}/src/dirigent_client/client.py

@@ -19,8 +19,6 @@ from dirigent_client.resources.schemas import Schemas
 from dirigent_client.resources.sources import Sources
 from dirigent_client.resources.system import System, Workers
 from dirigent_client.resources.trigger_documents import TriggerDocuments
-from dirigent_client.resources.watches import Watches
-from dirigent_client.resources.webhooks import Webhooks
 from dirigent_client.transport import (
     API_PREFIX,
     DEFAULT_CONNECT_TIMEOUT,
@@ -65,8 +63,6 @@ class Dirigent:
         self.blocks = Blocks(self.transport)
         self.examples = Examples(self.transport)
         self.schedules = Schedules(self.transport)
-        self.webhooks = Webhooks(self.transport)
-        self.watches = Watches(self.transport)
         self.sources = Sources(self.transport)
         self.trigger_documents = TriggerDocuments(self.transport)
         self.alerts = Alerts(self.transport)
@@ -110,8 +106,6 @@ class BlockingDirigent:
         self.blocks = self.client.blocks
         self.examples = self.client.examples
         self.schedules = self.client.schedules
-        self.webhooks = self.client.webhooks
-        self.watches = self.client.watches
         self.sources = self.client.sources
         self.trigger_documents = self.client.trigger_documents
         self.alerts = self.client.alerts

{dirigent_client-0.26.0 → dirigent_client-0.27.0}/src/dirigent_client/enums.py

@@ -103,7 +103,6 @@ class TriggerKind(StrEnum):
 
     ADHOC = "adhoc"
     SCHEDULE = "schedule"
-    WEBHOOK = "webhook"
     API_TOKEN = "api_token"
     USER = "user"
     PIPELINE = "pipeline"
@@ -112,9 +111,6 @@ class TriggerKind(StrEnum):
     BACKFILL = "backfill"
     """A backfill over past windows created this one, and ``triggered_by_id`` names the schedule."""
 
-    WATCH = "watch"
-    """A watch armed this one to wait on its sensor, and ``triggered_by_id`` names the watch."""
-
     SOURCE = "source"
     """An input arrived at a source node, and ``triggered_by_id`` names the source."""
 
@@ -178,25 +174,18 @@ class FiringOutcome(StrEnum):
     """The run could not be created at all, and the reason is on the row."""
 
 
-class WebhookOutcome(StrEnum):
-    """What the intake endpoint did with one delivery."""
-
-    ACCEPTED = "accepted"
-    """The payload mapped, validated, and started a run."""
-
-    SKIPPED = "skipped"
-    """The payload was good, but the pipeline's concurrency policy dropped the run."""
-
-    REJECTED = "rejected"
-    """The delivery was refused, and the reason is on the row."""
-
-
 class SourceState(StrEnum):
     """Whether a source takes inputs now, read from its row and the runs it has unsettled."""
 
+    STARTING = "starting"
+    """A worker has yet to poll it successfully for the first time."""
+
     LISTENING = "listening"
     """It takes inputs."""
 
+    FAILING = "failing"
+    """Its last polls failed, and the next one waits out a backoff."""
+
     BACKLOGGED = "backlogged"
     """As many runs from it are unsettled as ``max_in_flight`` allows; a new input is refused 503."""
 
@@ -211,11 +200,17 @@ class InputOutcome(StrEnum):
     """What came of one input that reached a source."""
 
     ACCEPTED = "accepted"
-    """It became a run, and the caller was answered with where to read it."""
+    """It became a run, and the caller was answered with where to read it, or is held for its reply."""
+
+    REPLIED = "replied"
+    """It became a run whose answer the caller was held for: a reply, or the run's failure."""
 
     REFUSED = "refused"
     """It was refused before any run existed, and the reason is on the row."""
 
+    TIMED_OUT = "timed_out"
+    """It became a run the caller was held for, and no answer came before the caller's timeout."""
+
 
 class BodyKind(StrEnum):
     """How an inbound request's body was read."""
@@ -240,7 +235,7 @@ class DocumentKind(StrEnum):
 
     PIPELINE = "pipeline"
     TRIGGERS = "triggers"
-    """Clocks and webhooks for a pipeline defined somewhere else."""
+    """Clocks for a pipeline defined somewhere else."""
 
 
 class ProvenanceSource(StrEnum):

{dirigent_client-0.26.0 → dirigent_client-0.27.0}/src/dirigent_client/resources/sources.py

@@ -1,7 +1,9 @@
 """A pipeline's sources: what each listens to, its state, what has arrived, and its token."""
 
+from pydantic import SecretStr
+
 from dirigent_client.resources.base import Resource, query
-from dirigent_client.schemas import Page, SourceInputOut, SourceOut, SourceTokenOut
+from dirigent_client.schemas import Page, SetSecretRequest, SourceInputOut, SourceOut, SourceTokenOut
 
 
 class Sources(Resource):
@@ -27,9 +29,19 @@ class Sources(Resource):
         return await self._one(SourceOut, "POST", f"/pipelines/{pipeline}/sources/{code}/$resume")
 
     async def rotate_token(self, pipeline: str, code: str) -> SourceTokenOut:
-        """Mint a new token and forget the old one immediately; every caller has to be given it."""
+        """Mint a new token or signing secret and forget the old one immediately; every caller has to be given it."""
         return await self._one(SourceTokenOut, "POST", f"/pipelines/{pipeline}/sources/{code}/$rotate-token")
 
+    async def set_secret(self, pipeline: str, code: str, secret: str) -> SourceOut:
+        """Replace a signed source's signing secret with one its sender issued."""
+        body = SetSecretRequest(secret=SecretStr(secret))
+        return await self._one(
+            SourceOut,
+            "POST",
+            f"/pipelines/{pipeline}/sources/{code}/$set-secret",
+            json={"secret": body.secret.get_secret_value()},
+        )
+
     async def inputs(
         self, pipeline: str, code: str, *, after: str | None = None, limit: int | None = None
     ) -> Page[SourceInputOut]:

{dirigent_client-0.26.0 → dirigent_client-0.27.0}/src/dirigent_client/resources/trigger_documents.py

@@ -1,4 +1,4 @@
-"""Triggers documents: the clocks and webhooks one document declares for another's pipeline."""
+"""Triggers documents: the clocks one document declares for another's pipeline."""
 
 from dirigent_client.resources.base import Resource, query
 from dirigent_client.schemas import Page, TriggerDocumentDetail, TriggerDocumentOut
@@ -16,5 +16,5 @@ class TriggerDocuments(Resource):
         return await self._one(TriggerDocumentDetail, "GET", f"/trigger-documents/{code}")
 
     async def delete(self, code: str) -> None:
-        """Remove a triggers document and every schedule and webhook it owns."""
+        """Remove a triggers document and every schedule it owns."""
         await self._transport.request("DELETE", f"/trigger-documents/{code}")

{dirigent_client-0.26.0 → dirigent_client-0.27.0}/src/dirigent_client/schemas/__init__.py

@@ -68,6 +68,7 @@ from dirigent_client.schemas.sources import (
     EndpointInput,
     InputAccepted,
     RequestFacts,
+    SetSecretRequest,
     SourceChanges,
     SourceInputOut,
     SourceOut,
@@ -83,19 +84,13 @@ from dirigent_client.schemas.system import (
     WorkerOut,
 )
 from dirigent_client.schemas.triggers import (
-    DeliveryOut,
     FiringOut,
-    HookAccepted,
     ScheduleIn,
     ScheduleOut,
     SchedulePreview,
     SchedulePreviewRequest,
     TriggerDocumentDetail,
     TriggerDocumentOut,
-    WatchOut,
-    WebhookIn,
-    WebhookOut,
-    WebhookTokenOut,
 )
 from dirigent_common import JsonList, JsonMap
 
@@ -122,7 +117,6 @@ __all__ = [
     "ConnectionUpdate",
     "DagNode",
     "DagView",
-    "DeliveryOut",
     "DiffSummary",
     "EndpointInput",
     "InputAccepted",
@@ -130,7 +124,6 @@ __all__ = [
     "ExampleOut",
     "FiringOut",
     "Health",
-    "HookAccepted",
     "Identity",
     "IssuedTokenOut",
     "ItemOut",
@@ -159,6 +152,7 @@ __all__ = [
     "SourceChanges",
     "SourceInputOut",
     "SourceOut",
+    "SetSecretRequest",
     "SourceTokenOut",
     "Requirements",
     "RunAccepted",
@@ -190,9 +184,5 @@ __all__ = [
     "UserOut",
     "UserUpdate",
     "ValidationIssue",
-    "WatchOut",
-    "WebhookIn",
-    "WebhookOut",
-    "WebhookTokenOut",
     "WorkerOut",
 ]

{dirigent_client-0.26.0 → dirigent_client-0.27.0}/src/dirigent_client/schemas/pipelines.py

@@ -76,12 +76,6 @@ class PipelineOut(WireModel):
     schedules: int = 0
     """How many clocks fire this pipeline."""
 
-    webhooks: int = 0
-    """How many inbound endpoints fire this pipeline."""
-
-    watches: int = 0
-    """How many watches keep a run of this pipeline waiting on a sensor."""
-
     last_run: LastRun | None = None
     """How the newest run of this pipeline went, or nothing when it has never run."""
 
@@ -116,7 +110,7 @@ class ApplyRequest(BaseModel):
     source_ref: str | None = Field(default=None, description="The file path or URL the document came from.")
     pause_schedules: bool = Field(
         default=False,
-        description="Create the schedules and watches this apply brings into being already paused.",
+        description="Create the schedules this apply brings into being already paused.",
     )
 
 
@@ -336,27 +330,11 @@ class Materialized(WireModel):
     schedules_created: list[str] = Field(default_factory=list[str])
     schedules_updated: list[str] = Field(default_factory=list[str])
     schedules_removed: list[str] = Field(default_factory=list[str])
-    webhooks_created: list[str] = Field(default_factory=list[str])
-    webhooks_updated: list[str] = Field(default_factory=list[str])
-    webhooks_removed: list[str] = Field(default_factory=list[str])
-    watches_created: list[str] = Field(default_factory=list[str])
-    watches_updated: list[str] = Field(default_factory=list[str])
-    watches_removed: list[str] = Field(default_factory=list[str])
 
     @property
     def empty(self) -> bool:
         """Report whether the apply left every trigger exactly as it was."""
-        return not (
-            self.schedules_created
-            or self.schedules_updated
-            or self.schedules_removed
-            or self.webhooks_created
-            or self.webhooks_updated
-            or self.webhooks_removed
-            or self.watches_created
-            or self.watches_updated
-            or self.watches_removed
-        )
+        return not (self.schedules_created or self.schedules_updated or self.schedules_removed)
 
 
 class PipelinePlan(WireModel):
@@ -395,7 +373,7 @@ class ApplyResult(WireModel):
     version: int | None = None
     dry_run: bool = False
     triggers: Materialized = Field(default_factory=Materialized)
-    """Which schedules, webhooks and watches the document's ``triggers:`` section created, changed, or retired."""
+    """Which schedules the document's ``triggers:`` section created, changed, or retired."""
 
     sources: SourceChanges = Field(default_factory=SourceChanges)
     """Which source rows the apply created, changed, or retired, and the tokens it minted."""

{dirigent_client-0.26.0 → dirigent_client-0.27.0}/src/dirigent_client/schemas/runs.py

@@ -44,7 +44,7 @@ class RunOut(WireModel):
     parent_run_id: UUID | None = None
     """The run whose step started this one, when a step of another run did."""
     triggered_by_id: UUID | None = None
-    """What started the run: the source, schedule, webhook, watch, token or user, as its id."""
+    """What started the run: the source, schedule, token or user, as its id."""
 
     triggered_by_label: str | None = None
     source: str | None = None

{dirigent_client-0.26.0 → dirigent_client-0.27.0}/src/dirigent_client/schemas/sources.py

@@ -3,7 +3,7 @@
 from datetime import datetime
 from uuid import UUID
 
-from pydantic import BaseModel, ConfigDict, Field, JsonValue
+from pydantic import BaseModel, ConfigDict, Field, JsonValue, SecretStr
 
 from dirigent_client.enums import BodyKind, InputOutcome, SourceState
 from dirigent_client.schemas.common import WireModel
@@ -86,7 +86,10 @@ class SourceOut(WireModel):
     """How a caller of a received source authenticates: ``token`` or ``public``."""
 
     token_prefix: str | None = None
-    """The leading characters of the token, so a caller's copy can be told apart from another."""
+    """The leading characters of the token or the signing secret, so a caller's copy can be told apart."""
+
+    signature_header: str | None = None
+    """For an ``hmac`` source, the header a caller's signature of the body arrives in."""
 
     in_flight: int = 0
     """How many runs it started are unsettled."""
@@ -101,21 +104,46 @@ class SourceOut(WireModel):
     """How many inputs were refused once their caller was let in."""
 
     last_input_at: datetime | None = None
+    summary: str | None = None
+    """What the source listens to, in one line its kind writes, such as the prefix it polls."""
+
+    polled_at: datetime | None = None
+    """When a poll of a polled source last succeeded."""
+
+    next_poll_at: datetime | None = None
+    failures: int = 0
+    """How many polls in a row have failed."""
+
+    last_error: str | None = None
     created_at: datetime
 
 
 class SourceTokenOut(WireModel):
-    """A token freshly minted for a source, returned once and never readable again."""
+    """A credential freshly minted for a source, returned once and never readable again."""
 
     source_id: UUID
     pipeline: str
     code: str
+    auth: str = "token"
+    """``token`` for a bearer token a caller presents, ``hmac`` for a secret a caller signs the body with."""
+
+    header: str | None = None
+    """For ``hmac``, the header the signature arrives in."""
+
     token: str
+    """The token, or the signing secret."""
+
     prefix: str
     url_path: str
     """Where the source is called, so a caller can be configured without assembling the path by hand."""
 
 
+class SetSecretRequest(WireModel):
+    """The signing secret a sender issued, to replace the one the instance minted."""
+
+    secret: SecretStr
+
+
 class SourceChanges(WireModel):
     """What applying a document did to the source rows its pipeline holds."""
 
@@ -137,8 +165,8 @@ class SourceInputOut(WireModel):
     id: int
     created_at: datetime
     outcome: InputOutcome
-    status: int
-    """The HTTP status the caller was answered with."""
+    status: int | None = None
+    """The HTTP status the caller was answered with, or null for an input a worker polled."""
 
     run_id: UUID | None = None
     code: str | None = None
@@ -146,8 +174,11 @@ class SourceInputOut(WireModel):
 
     reason: str | None = None
     params: JsonMap | None = None
-    method: str
-    path: str
+    method: str | None = None
+    path: str | None = None
+    label: str | None = None
+    """What a polled kind names the input, such as the object it found."""
+
     body_bytes: int = 0
     duration_ms: int = 0
     caller: str | None = None

{dirigent_client-0.26.0 → dirigent_client-0.27.0}/src/dirigent_client/schemas/triggers.py

@@ -1,9 +1,9 @@
-"""A pipeline's persisted triggers: its schedules, its inbound webhooks, and its watches."""
+"""A pipeline's persisted triggers: its schedules."""
 
 from datetime import datetime
 from uuid import UUID
 
-from pydantic import BaseModel, Field, SecretStr, field_validator
+from pydantic import BaseModel, Field, field_validator
 
 from dirigent_client.enums import (
     FiringOutcome,
@@ -11,7 +11,6 @@ from dirigent_client.enums import (
     ProvenanceSource,
     RunPriority,
     ScheduleKind,
-    WebhookOutcome,
 )
 from dirigent_client.messages import (
     EMPTY_LOG_LEVEL_PATTERN,
@@ -112,84 +111,6 @@ class FiringOut(WireModel):
     detail: str | None = None
 
 
-class WebhookIn(BaseModel):
-    """A webhook as a caller declares it; the token is never supplied, only minted."""
-
-    code: EntityName
-    name: str | None = None
-    description: str | None = None
-    params_from_payload: dict[str, str] = Field(default_factory=dict[str, str])
-    hmac_secret: SecretStr | None = Field(default=None, min_length=1)
-    """The signing secret, or null for an unsigned webhook; an empty string is neither."""
-
-    rate_limit_per_minute: int = Field(default=60, ge=1)
-    priority: RunPriority | None = Field(
-        default=None,
-        description="The priority every accepted delivery's run carries. Omitted takes the pipeline's own.",
-    )
-
-
-class WebhookOut(WireModel):
-    """A webhook as a listing shows it: everything about it except the token."""
-
-    id: UUID
-    code: str
-    name: str | None = None
-    description: str | None = None
-    token_prefix: str
-    params_from_payload: dict[str, str] = Field(default_factory=dict[str, str])
-    signed: bool
-    """Whether this webhook requires an HMAC signature; the secret itself never leaves."""
-
-    active: bool
-    managed: bool
-    trigger_document: str | None = None
-    """The triggers document that declares this row, or null when the pipeline's own does."""
-
-    rate_limit_per_minute: int
-    priority: RunPriority | None = None
-    """The priority every accepted delivery's run carries, or null when it takes the pipeline's own."""
-
-    last_delivery_at: datetime | None = None
-    created_at: datetime
-
-
-class WatchOut(WireModel):
-    """A watch as a listing shows it: what it waits on, and how its last run of waiting went."""
-
-    id: UUID
-    code: str
-    name: str | None = None
-    description: str | None = None
-    step: str
-    """The root sensor step every run it arms waits on."""
-
-    params: JsonMap = Field(default_factory=dict)
-    paused: bool
-    managed: bool
-    trigger_document: str | None = None
-    """The triggers document that declares this row, or null when the pipeline's own does."""
-
-    cursor: JsonMap | None = None
-    """Where the last successful poke of the watched step left off, which the next run starts from."""
-
-    waiting_run_id: UUID | None = None
-    """The run waiting on the sensor now, or null between one run and the next."""
-
-    failures: int = 0
-    """How many waits in a row have ended without the sensor succeeding."""
-
-    last_error: str | None = None
-    """Why the last wait ended without the sensor succeeding, or null once one has succeeded since."""
-
-    last_error_at: datetime | None = None
-    rearm_at: datetime | None = None
-    """When a watch backing off after a failure arms its next run."""
-
-    last_armed_at: datetime | None = None
-    created_at: datetime
-
-
 class TriggerDocumentOut(WireModel):
     """A ``kind: triggers`` document as a listing shows it."""
 
@@ -213,36 +134,3 @@ class TriggerDocumentDetail(TriggerDocumentOut):
 
     document: JsonMap
     schedules: list[str] = Field(default_factory=list[str])
-    webhooks: list[str] = Field(default_factory=list[str])
-    watches: list[str] = Field(default_factory=list[str])
-
-
-class WebhookTokenOut(WireModel):
-    """A freshly minted webhook token, returned once and never readable again."""
-
-    webhook_id: UUID
-    code: str
-    token: str
-    prefix: str
-    url_path: str
-    """Where to POST, so a caller can be configured without assembling the path by hand."""
-
-
-class HookAccepted(WireModel):
-    """What an accepted delivery answers with: the run it started, or why it started none."""
-
-    run_id: UUID | None = None
-    outcome: WebhookOutcome
-    detail: str | None = None
-
-
-class DeliveryOut(WireModel):
-    """One inbound delivery, and what came of it."""
-
-    id: int
-    created_at: datetime
-    outcome: WebhookOutcome
-    run_id: UUID | None = None
-    reason: str | None = None
-    mapped_params: JsonMap | None = None
-    source: str | None = None

dirigent_client-0.26.0/src/dirigent_client/resources/watches.py

@@ -1,29 +0,0 @@
-"""A pipeline's watches: the sensor each keeps a run waiting on, and how that is going."""
-
-from dirigent_client.resources.base import Resource, query
-from dirigent_client.schemas import Page, WatchOut
-
-
-class Watches(Resource):
-    """Read, pause, and resume the watches hanging from a pipeline."""
-
-    async def list(self, pipeline: str, *, after: str | None = None, limit: int | None = None) -> Page[WatchOut]:
-        """List every watch on a pipeline, with the run each one has waiting."""
-        return await self._many(
-            WatchOut,
-            "GET",
-            f"/pipelines/{pipeline}/triggers/watches",
-            params=query(after=after, limit=limit),
-        )
-
-    async def get(self, pipeline: str, code: str) -> WatchOut:
-        """Read one watch by code."""
-        return await self._one(WatchOut, "GET", f"/pipelines/{pipeline}/triggers/watches/{code}")
-
-    async def pause(self, pipeline: str, code: str) -> WatchOut:
-        """Stop a watch, cancelling the run it has waiting, and keep where it left off."""
-        return await self._one(WatchOut, "POST", f"/pipelines/{pipeline}/triggers/watches/{code}/$pause")
-
-    async def resume(self, pipeline: str, code: str) -> WatchOut:
-        """Start a watch again, arming a run from where its last success left off."""
-        return await self._one(WatchOut, "POST", f"/pipelines/{pipeline}/triggers/watches/{code}/$resume")

dirigent_client-0.26.0/src/dirigent_client/resources/webhooks.py

@@ -1,80 +0,0 @@
-"""A pipeline's inbound webhooks: their mapping, their token, and what has arrived."""
-
-from pydantic import SecretStr
-
-from dirigent_client.enums import RunPriority
-from dirigent_client.resources.base import Resource, query, request_body
-from dirigent_client.schemas import DeliveryOut, Page, WebhookIn, WebhookOut, WebhookTokenOut
-
-
-class Webhooks(Resource):
-    """Declare, enable, rotate, and read the webhooks hanging from a pipeline."""
-
-    async def list(self, pipeline: str, *, after: str | None = None, limit: int | None = None) -> Page[WebhookOut]:
-        """List every webhook on a pipeline, with its mapping but never its token."""
-        return await self._many(
-            WebhookOut,
-            "GET",
-            f"/pipelines/{pipeline}/triggers/webhooks",
-            params=query(after=after, limit=limit),
-        )
-
-    async def get(self, pipeline: str, code: str) -> WebhookOut:
-        """Read one webhook by code, with its mapping but never its token."""
-        return await self._one(WebhookOut, "GET", f"/pipelines/{pipeline}/triggers/webhooks/{code}")
-
-    async def create(
-        self,
-        pipeline: str,
-        code: str,
-        *,
-        name: str | None = None,
-        description: str | None = None,
-        params_from_payload: dict[str, str] | None = None,
-        hmac_secret: str | None = None,
-        rate_limit_per_minute: int = 60,
-        priority: RunPriority | None = None,
-    ) -> WebhookTokenOut:
-        """Declare a webhook and return its token, which is shown here and nowhere else again."""
-        payload = WebhookIn(
-            code=code,
-            name=name,
-            description=description,
-            params_from_payload=params_from_payload or {},
-            hmac_secret=SecretStr(hmac_secret) if hmac_secret else None,
-            rate_limit_per_minute=rate_limit_per_minute,
-            priority=priority,
-        )
-        return await self._one(
-            WebhookTokenOut,
-            "POST",
-            f"/pipelines/{pipeline}/triggers/webhooks",
-            json=request_body(payload),
-        )
-
-    async def rotate_token(self, pipeline: str, code: str) -> WebhookTokenOut:
-        """Mint a new token and forget the old one immediately; callers must be updated."""
-        return await self._one(WebhookTokenOut, "POST", f"/pipelines/{pipeline}/triggers/webhooks/{code}/$rotate-token")
-
-    async def enable(self, pipeline: str, code: str) -> WebhookOut:
-        """Accept deliveries again on the token that was already issued."""
-        return await self._one(WebhookOut, "POST", f"/pipelines/{pipeline}/triggers/webhooks/{code}/$enable")
-
-    async def disable(self, pipeline: str, code: str) -> WebhookOut:
-        """Refuse deliveries without rotating or losing the token."""
-        return await self._one(WebhookOut, "POST", f"/pipelines/{pipeline}/triggers/webhooks/{code}/$disable")
-
-    async def delete(self, pipeline: str, code: str) -> None:
-        """Remove a webhook, its token, and its delivery history."""
-        await self._transport.request("DELETE", f"/pipelines/{pipeline}/triggers/webhooks/{code}")
-
-    async def deliveries(
-        self, pipeline: str, code: str, *, after: str | None = None, limit: int | None = None
-    ) -> Page[DeliveryOut]:
-        """Read what has arrived, newest first, refusals included."""
-        return await self._many(
-            DeliveryOut,
-            "GET",
-            f"/pipelines/{pipeline}/triggers/webhooks/{code}/deliveries",
-            params=query(after=after, limit=limit),
-        )