dirigent-client 0.23.4__tar.gz → 0.25.0__tar.gz

{dirigent_client-0.23.4 → dirigent_client-0.25.0}/PKG-INFO

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

{dirigent_client-0.23.4 → dirigent_client-0.25.0}/pyproject.toml

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

{dirigent_client-0.23.4 → dirigent_client-0.25.0}/pyproject.toml.orig

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

{dirigent_client-0.23.4 → dirigent_client-0.25.0}/src/dirigent_client/__init__.py

@@ -6,9 +6,11 @@ from dirigent_client.enums import (
     AlertScope,
     AttemptKind,
     AttemptStatus,
+    BodyKind,
     DocumentKind,
     FiringOutcome,
     Importance,
+    InputOutcome,
     LogLevel,
     NotificationStatus,
     ProvenanceSource,
@@ -16,6 +18,8 @@ from dirigent_client.enums import (
     RunPriority,
     RunStatus,
     ScheduleKind,
+    SourceState,
+    StepKind,
     TokenKind,
     TriggerKind,
     UserRole,
@@ -66,12 +70,14 @@ from dirigent_client.schemas import (
     DagView,
     DeliveryOut,
     DiffSummary,
+    EndpointInput,
     ExampleDetail,
     ExampleOut,
     FiringOut,
     Health,
     HookAccepted,
     Identity,
+    InputAccepted,
     IssuedTokenOut,
     ItemOut,
     JsonList,
@@ -88,6 +94,7 @@ from dirigent_client.schemas import (
     PlanAction,
     Problem,
     Readiness,
+    RequestFacts,
     Requirements,
     RunAccepted,
     RunDetail,
@@ -101,6 +108,11 @@ from dirigent_client.schemas import (
     SchemaIn,
     SchemaOut,
     SchemaUpdate,
+    SourceChanges,
+    SourceEntry,
+    SourceInputOut,
+    SourceOut,
+    SourceTokenOut,
     StepReport,
     SurfaceEntry,
     SystemInfo,
@@ -165,6 +177,17 @@ __all__ = [
     "ConnectionOut",
     "ConnectionUpdate",
     "SchemaIn",
+    "RequestFacts",
+    "EndpointInput",
+    "InputAccepted",
+    "InputOutcome",
+    "SourceChanges",
+    "SourceInputOut",
+    "SourceOut",
+    "SourceState",
+    "SourceTokenOut",
+    "StepKind",
+    "BodyKind",
     "SchemaOut",
     "SchemaUpdate",
     "DagNode",
@@ -221,6 +244,7 @@ __all__ = [
     "SchedulePreviewRequest",
     "ServerError",
     "StepReport",
+    "SourceEntry",
     "SurfaceEntry",
     "SystemInfo",
     "TestQueued",

{dirigent_client-0.23.4 → dirigent_client-0.25.0}/src/dirigent_client/client.py

@@ -16,6 +16,7 @@ from dirigent_client.resources.pipelines import Pipelines
 from dirigent_client.resources.runs import Runs
 from dirigent_client.resources.schedules import Schedules
 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
@@ -66,6 +67,7 @@ class Dirigent:
         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)
         self.system = System(self.transport)
@@ -110,6 +112,7 @@ class BlockingDirigent:
         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
         self.system = self.client.system

{dirigent_client-0.23.4 → dirigent_client-0.25.0}/src/dirigent_client/enums.py

@@ -37,10 +37,23 @@ class AttemptStatus(StrEnum):
 
 
 class AttemptKind(StrEnum):
-    """Whether the engine created an attempt or an operator asked for it."""
+    """Whether the engine created an attempt, an operator asked for it, or an input arrived as it."""
 
     AUTOMATIC = "automatic"
     MANUAL = "manual"
+    RECEIVED = "received"
+    """A source node's attempt: written succeeded when the run is created, its output the input."""
+
+
+class StepKind(StrEnum):
+    """Which of the three forms a step takes: work on a worker, an entry, or an answer."""
+
+    BLOCK = "block"
+    SOURCE = "source"
+    """Where an input enters the pipeline; settled by the server when the run is created."""
+
+    REPLY = "reply"
+    """A leaf that answers the caller an input arrived from; settled by the server, never claimed."""
 
 
 class RunItemStatus(StrEnum):
@@ -102,6 +115,9 @@ class TriggerKind(StrEnum):
     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."""
+
 
 class ScheduleKind(StrEnum):
     """How a schedule computes its next firing."""
@@ -175,6 +191,41 @@ class WebhookOutcome(StrEnum):
     """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."""
+
+    LISTENING = "listening"
+    """It takes inputs."""
+
+    BACKLOGGED = "backlogged"
+    """As many runs from it are unsettled as ``max_in_flight`` allows; a new input is refused 503."""
+
+    DRAINING = "draining"
+    """It or its pipeline is paused, and runs it started are still unsettled."""
+
+    PAUSED = "paused"
+    """It or its pipeline is paused, and nothing it started is unsettled."""
+
+
+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."""
+
+    REFUSED = "refused"
+    """It was refused before any run existed, and the reason is on the row."""
+
+
+class BodyKind(StrEnum):
+    """How an inbound request's body was read."""
+
+    NONE = "none"
+    JSON = "json"
+    FORM = "form"
+    TEXT = "text"
+
+
 class LogLevel(StrEnum):
     """Severity of a product log entry, which is separate from process logging."""
 

{dirigent_client-0.23.4 → dirigent_client-0.25.0}/src/dirigent_client/resources/pipelines.py

@@ -7,6 +7,7 @@ from pathlib import Path
 from typing import cast
 
 import yaml
+from pydantic import JsonValue
 
 from dirigent_client.enums import LogLevel, ProvenanceSource, RunPriority
 from dirigent_client.errors import DirigentError
@@ -137,6 +138,8 @@ class Pipelines(Resource):
         window: tuple[datetime, datetime] | None = None,
         log_levels: dict[str, LogLevel] | None = None,
         priority: RunPriority | None = None,
+        source: str | None = None,
+        input: JsonValue = None,
     ) -> RunAccepted:
         """Start an ad hoc run, with parameters validated against the pipeline's own schema.
 
@@ -151,9 +154,14 @@ class Pipelines(Resource):
 
         ``priority`` is how far ahead of other runs this one's attempts are claimed; omitted
         takes the pipeline's own.
+
+        ``source`` is the source a run of a pipeline with sources enters at, omitted for its only
+        one, and ``input`` is what arrives there, omitted for the source's sample.
         """
         payload = RunRequest(
             params=params or {},
+            source=source,
+            input=input,
             window_start=window[0] if window else None,
             window_end=window[1] if window else None,
             log_levels=log_levels,

dirigent_client-0.25.0/src/dirigent_client/resources/sources.py

@@ -0,0 +1,42 @@
+"""A pipeline's sources: what each listens to, its state, what has arrived, and its token."""
+
+from dirigent_client.resources.base import Resource, query
+from dirigent_client.schemas import Page, SourceInputOut, SourceOut, SourceTokenOut
+
+
+class Sources(Resource):
+    """Read, pause, resume and rotate the sources a pipeline's document declares."""
+
+    async def list(
+        self, pipeline: str | None = None, *, after: str | None = None, limit: int | None = None
+    ) -> Page[SourceOut]:
+        """List one pipeline's sources, or every pipeline's, never their tokens."""
+        path = f"/pipelines/{pipeline}/sources" if pipeline is not None else "/sources"
+        return await self._many(SourceOut, "GET", path, params=query(after=after, limit=limit))
+
+    async def get(self, pipeline: str, code: str) -> SourceOut:
+        """Read one source by its step code, never its token."""
+        return await self._one(SourceOut, "GET", f"/pipelines/{pipeline}/sources/{code}")
+
+    async def pause(self, pipeline: str, code: str) -> SourceOut:
+        """Refuse new inputs with 503, keeping the token and the counts."""
+        return await self._one(SourceOut, "POST", f"/pipelines/{pipeline}/sources/{code}/$pause")
+
+    async def resume(self, pipeline: str, code: str) -> SourceOut:
+        """Take inputs again on the token that was already issued."""
+        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."""
+        return await self._one(SourceTokenOut, "POST", f"/pipelines/{pipeline}/sources/{code}/$rotate-token")
+
+    async def inputs(
+        self, pipeline: str, code: str, *, after: str | None = None, limit: int | None = None
+    ) -> Page[SourceInputOut]:
+        """Read what has arrived, newest first, refusals included."""
+        return await self._many(
+            SourceInputOut,
+            "GET",
+            f"/pipelines/{pipeline}/sources/{code}/inputs",
+            params=query(after=after, limit=limit),
+        )

{dirigent_client-0.23.4 → dirigent_client-0.25.0}/src/dirigent_client/schemas/__init__.py

@@ -23,7 +23,7 @@ from dirigent_client.schemas.auth import (
     UserOut,
     UserUpdate,
 )
-from dirigent_client.schemas.catalog import BlockEntry, BlockKind, Catalog, SurfaceEntry
+from dirigent_client.schemas.catalog import BlockEntry, BlockKind, Catalog, SourceEntry, SurfaceEntry
 from dirigent_client.schemas.common import Page, Problem
 from dirigent_client.schemas.connections import ConnectionIn, ConnectionOut, ConnectionUpdate
 from dirigent_client.schemas.examples import ExampleDetail, ExampleOut
@@ -64,6 +64,15 @@ from dirigent_client.schemas.runs import (
     StepReport,
 )
 from dirigent_client.schemas.schemas import SchemaIn, SchemaOut, SchemaUpdate
+from dirigent_client.schemas.sources import (
+    EndpointInput,
+    InputAccepted,
+    RequestFacts,
+    SourceChanges,
+    SourceInputOut,
+    SourceOut,
+    SourceTokenOut,
+)
 from dirigent_client.schemas.system import (
     CheckResult,
     CheckStatus,
@@ -100,8 +109,8 @@ __all__ = [
     "AttemptEvent",
     "AttemptOut",
     "BackfillAccepted",
-    "BackfilledRun",
     "BackfillRequest",
+    "BackfilledRun",
     "BlockEntry",
     "BlockKind",
     "Catalog",
@@ -115,6 +124,8 @@ __all__ = [
     "DagView",
     "DeliveryOut",
     "DiffSummary",
+    "EndpointInput",
+    "InputAccepted",
     "ExampleDetail",
     "ExampleOut",
     "FiringOut",
@@ -125,11 +136,9 @@ __all__ = [
     "ItemOut",
     "JsonList",
     "JsonMap",
+    "LOG_NOTIFIER",
     "Labels",
     "LastRun",
-    "LOG_NOTIFIER",
-    "TEST_BODY",
-    "TEST_SUBJECT",
     "LogEntryOut",
     "LoginRequest",
     "Materialized",
@@ -146,6 +155,11 @@ __all__ = [
     "PruneRequest",
     "PruneResult",
     "Readiness",
+    "RequestFacts",
+    "SourceChanges",
+    "SourceInputOut",
+    "SourceOut",
+    "SourceTokenOut",
     "Requirements",
     "RunAccepted",
     "RunDetail",
@@ -159,10 +173,13 @@ __all__ = [
     "SchemaIn",
     "SchemaOut",
     "SchemaUpdate",
+    "SourceEntry",
     "StepReport",
     "SurfaceEntry",
     "SystemInfo",
     "TERMINAL_RUN_STATUSES",
+    "TEST_BODY",
+    "TEST_SUBJECT",
     "TestQueued",
     "TestRequest",
     "TokenOut",

{dirigent_client-0.23.4 → dirigent_client-0.25.0}/src/dirigent_client/schemas/catalog.py

@@ -49,6 +49,31 @@ class SurfaceEntry(BaseModel):
     declares one. Monochrome: a screen fills it in the ink it draws every other mark in."""
 
 
+class SourceEntry(BaseModel):
+    """One source kind in the catalog: where an input enters a pipeline, and what it hands on."""
+
+    kind: str
+    """What a document writes as ``source.kind``."""
+
+    plugin: str
+    summary: str
+    hosting: str
+    """Who takes the kind's inputs: ``received`` by the server, ``polled`` or ``held`` by a worker."""
+
+    replies: bool = False
+    """Whether a reply node may answer an input of this kind."""
+
+    config_schema: JsonMap = Field(default_factory=dict)
+    """The fields a source node of this kind writes beside ``kind``."""
+
+    output_schema: JsonMap = Field(default_factory=dict)
+    """The input a source node of this kind hands the step after it."""
+
+    secret_fields: list[str] = Field(default_factory=list[str])
+    mark: str | None = None
+    """The ``d`` of one SVG path on a 24-unit grid this kind is drawn by, where it declares one."""
+
+
 class Catalog(BaseModel):
     """The host's merged view of every contribution."""
 
@@ -58,11 +83,17 @@ class Catalog(BaseModel):
     storage_schemes: list[SurfaceEntry] = Field(default_factory=list[SurfaceEntry])
     notifiers: list[SurfaceEntry] = Field(default_factory=list[SurfaceEntry])
     connection_kinds: list[SurfaceEntry] = Field(default_factory=list[SurfaceEntry])
+    sources: list[SourceEntry] = Field(default_factory=list[SourceEntry])
+    """The source kinds a source node may write."""
 
     def block(self, block_id: str) -> BlockEntry | None:
         """Find one catalog entry by block id."""
         return next((entry for entry in self.blocks if entry.id == block_id), None)
 
+    def source(self, kind: str) -> SourceEntry | None:
+        """Find one source kind by the ``kind`` a document writes."""
+        return next((entry for entry in self.sources if entry.kind == kind), None)
+
     @property
     def digest(self) -> str:
         """Hash the catalog, so a worker registry row can prove code parity across nodes."""

{dirigent_client-0.23.4 → dirigent_client-0.25.0}/src/dirigent_client/schemas/pipelines.py

@@ -5,7 +5,7 @@ from enum import StrEnum
 from typing import Any
 from uuid import UUID
 
-from pydantic import AliasChoices, BaseModel, ConfigDict, Field, field_validator, model_validator
+from pydantic import AliasChoices, BaseModel, ConfigDict, Field, JsonValue, field_validator, model_validator
 
 from dirigent_client.enums import DocumentKind, Importance, LogLevel, ProvenanceSource, RunPriority, RunStatus
 from dirigent_client.messages import (
@@ -15,6 +15,7 @@ from dirigent_client.messages import (
     WINDOW_RUNS_FORWARDS,
 )
 from dirigent_client.schemas.common import WireModel
+from dirigent_client.schemas.sources import SourceChanges
 from dirigent_common import EntityName, Issue, JsonMap, Message
 
 
@@ -141,6 +142,20 @@ class RunRequest(BaseModel):
     """Ad hoc run parameters, validated against the pipeline's own schema."""
 
     params: JsonMap = Field(default_factory=dict)
+    source: str | None = Field(
+        default=None,
+        description=(
+            "The source node a run of a pipeline with sources enters at. Omitted names the "
+            "pipeline's only source, and a pipeline with several refuses the run."
+        ),
+    )
+    input: JsonValue = Field(
+        default=None,
+        description=(
+            "What arrives at that source, in the shape of its output; what it omits the kind "
+            "fills in. Omitted takes the source's sample."
+        ),
+    )
     priority: RunPriority | None = Field(
         default=None,
         description=(
@@ -381,3 +396,6 @@ class ApplyResult(WireModel):
     dry_run: bool = False
     triggers: Materialized = Field(default_factory=Materialized)
     """Which schedules, webhooks and watches 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.23.4 → dirigent_client-0.25.0}/src/dirigent_client/schemas/runs.py

@@ -12,6 +12,7 @@ from dirigent_client.enums import (
     RunItemStatus,
     RunPriority,
     RunStatus,
+    StepKind,
     TriggerKind,
 )
 from dirigent_client.schemas.common import WireModel
@@ -42,7 +43,13 @@ class RunOut(WireModel):
     triggered_by_kind: TriggerKind
     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."""
+
     triggered_by_label: str | None = None
+    source: str | None = None
+    """The source node a run of a pipeline with sources entered at, by its step code."""
+
     trace_id: str | None = None
     error: str | None = None
     """What went wrong: the reason a cancel gave, else what the first failed attempt said."""
@@ -158,7 +165,12 @@ class DagNode(WireModel):
     name: str | None = None
     """The step's human title, when the document gave it one."""
 
+    kind: StepKind = StepKind.BLOCK
+    """Which form the step takes: a block, a source an input enters at, or a reply."""
+
     block: str
+    """The block a block step runs, the kind of a source, or ``reply``."""
+
     outcome: str
     depends_on: list[str] = Field(default_factory=list[str])
     rule: str
@@ -166,6 +178,10 @@ class DagNode(WireModel):
     grid_source: str | None = None
     """The step a late grid waits for before it expands, or null for a grid fixed at creation."""
 
+    item_wise_parent: str | None = None
+    """The fan-out whose matching item each of this step's items waits for, one by one, or null
+    when the step waits for its prerequisites whole."""
+
     items_total: int = 0
     items_failed: int = 0
     attempts: int = 0

dirigent_client-0.25.0/src/dirigent_client/schemas/sources.py

@@ -0,0 +1,164 @@
+"""Sources: what an input arrives as, the source rows that take inputs, and their journal."""
+
+from datetime import datetime
+from uuid import UUID
+
+from pydantic import BaseModel, ConfigDict, Field, JsonValue
+
+from dirigent_client.enums import BodyKind, InputOutcome, SourceState
+from dirigent_client.schemas.common import WireModel
+from dirigent_common import JsonMap
+
+
+class RequestFacts(BaseModel):
+    """What an HTTP request arrived as, read once: the shape the playground and an endpoint share."""
+
+    model_config = ConfigDict(use_attribute_docstrings=True)
+
+    method: str
+    """The HTTP method the call was made with."""
+
+    path: str
+    """The concrete path, without the query."""
+
+    query: dict[str, JsonValue] = Field(default_factory=dict[str, JsonValue])
+    """The query arguments as strings, with a repeated name arriving as a list."""
+
+    headers: dict[str, str] = Field(default_factory=dict[str, str])
+    """The request headers, lowercased."""
+
+    content_type: str | None = None
+    """The content type the body arrived under, as the header spelled it."""
+
+    body_kind: BodyKind = BodyKind.NONE
+    """How the body was read. A body appears once, in ``body``."""
+
+    body: JsonValue = None
+    """The body, decoded the way ``body_kind`` says. Null when there was none."""
+
+    body_bytes: int = 0
+    """How large the body was, in bytes."""
+
+
+class EndpointInput(RequestFacts):
+    """The output of an endpoint source, which is the input its pipeline's next steps read.
+
+    ``headers`` never carries the credential the caller presented: ``authorization``, the
+    cookie and the signature header are removed before the input is written.
+    """
+
+    route: str
+    """The template the source declares, which the concrete path matched."""
+
+    path_params: dict[str, str] = Field(default_factory=dict[str, str])
+    """What each ``{name}`` in the template matched, as a string."""
+
+    received_at: datetime
+    """When the input arrived, or when a hand run supplied it."""
+
+
+class SourceOut(WireModel):
+    """A source as a listing shows it: what it listens to, its state, and what it has taken, never its token."""
+
+    model_config = ConfigDict(use_attribute_docstrings=True)
+
+    id: UUID
+    pipeline: str
+    """The code of the pipeline the source belongs to."""
+
+    code: str
+    """The source's step key."""
+
+    name: str | None = None
+    description: str | None = None
+    kind: str
+    state: SourceState
+    methods: list[str] = Field(default_factory=list[str])
+    """The methods a received source answers; empty for a kind the server does not receive."""
+
+    route: str | None = None
+    """The template a received source answers, under the instance's endpoint prefix."""
+
+    url_path: str | None = None
+    """Where a received source is called: the endpoint prefix and the template."""
+
+    auth: str | None = None
+    """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."""
+
+    in_flight: int = 0
+    """How many runs it started are unsettled."""
+
+    max_in_flight: int | None = None
+    """How many unsettled runs it allows before refusing an input, or null for no bound."""
+
+    accepted: int = 0
+    """How many inputs became runs."""
+
+    refused: int = 0
+    """How many inputs were refused once their caller was let in."""
+
+    last_input_at: datetime | None = None
+    created_at: datetime
+
+
+class SourceTokenOut(WireModel):
+    """A token freshly minted for a source, returned once and never readable again."""
+
+    source_id: UUID
+    pipeline: str
+    code: str
+    token: str
+    prefix: str
+    url_path: str
+    """Where the source is called, so a caller can be configured without assembling the path by hand."""
+
+
+class SourceChanges(WireModel):
+    """What applying a document did to the source rows its pipeline holds."""
+
+    created: list[str] = Field(default_factory=list[str])
+    updated: list[str] = Field(default_factory=list[str])
+    removed: list[str] = Field(default_factory=list[str])
+    tokens: list[SourceTokenOut] = Field(default_factory=list[SourceTokenOut])
+    """The tokens minted for the sources this apply created, each shown here and nowhere else again."""
+
+    @property
+    def empty(self) -> bool:
+        """Report whether the apply left every source row exactly as it was."""
+        return not (self.created or self.updated or self.removed)
+
+
+class SourceInputOut(WireModel):
+    """One input that reached a source, and the run or the refusal it became."""
+
+    id: int
+    created_at: datetime
+    outcome: InputOutcome
+    status: int
+    """The HTTP status the caller was answered with."""
+
+    run_id: UUID | None = None
+    code: str | None = None
+    """The refusal's message code, or null for an accepted input."""
+
+    reason: str | None = None
+    params: JsonMap | None = None
+    method: str
+    path: str
+    body_bytes: int = 0
+    duration_ms: int = 0
+    caller: str | None = None
+
+
+class InputAccepted(WireModel):
+    """What a caller of a source is answered with when its input became a run."""
+
+    run_id: UUID
+    status: str
+    """The status the run was created in."""
+
+    run_url: str
+    """Where the run is read, under the versioned API."""