synth-ai 0.22.2.dev687__tar.gz → 0.22.2.dev688__tar.gz

{synth_ai-0.22.2.dev687/synth_ai.egg-info → synth_ai-0.22.2.dev688}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synth-ai
-Version: 0.22.2.dev687
+Version: 0.22.2.dev688
 Summary: Python SDK, CLI and MCP servers for Synth Index search and Swarms
 Author-email: Synth AI <josh@usesynth.ai>
 License-Expression: MIT

{synth_ai-0.22.2.dev687 → synth_ai-0.22.2.dev688}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "synth-ai"
-version = "0.22.2.dev687"
+version = "0.22.2.dev688"
 description = "Python SDK, CLI and MCP servers for Synth Index search and Swarms"
 keywords = ["synth", "index", "search", "citations", "research", "swarms", "mcp", "sdk"]
 authors = [{name = "Synth AI", email = "josh@usesynth.ai"}]

{synth_ai-0.22.2.dev687 → synth_ai-0.22.2.dev688}/synth_ai/cli/index.py

@@ -633,8 +633,8 @@ def contribution_status(contribution_id, revision_id, search_id, api_key, backen
 @_lifecycle_target_options
 def contribution_upload(draft_file, upload_spec_file, root, files, api_key, backend_url):
     """Prepare, transfer exactly the selected files, then finalize. Does not submit."""
-    from synth_ai.mcp.research.tools.index import read_selected_files
     from synth_ai.sdk.index.contributions import ContributionDraft, ContributionUploadSpec
+    from synth_ai.sdk.index.local_files import read_selected_files
 
     selected: dict[str, str] = {}
     for item in files:

{synth_ai-0.22.2.dev687 → synth_ai-0.22.2.dev688}/synth_ai/mcp/research/registry.py

@@ -109,6 +109,7 @@ _DEFAULT_REQUIRED_SCOPES_BY_TOOL_NAME: dict[str, tuple[str, ...]] = {
     "research_get_run": READ_SCOPES,
     "research_get_swarm_activity": READ_SCOPES,
     "research_get_swarm_configuration": READ_SCOPES,
+    "research_get_run_history": READ_SCOPES,
     "research_get_swarm_evidence": READ_SCOPES,
     "research_get_swarm_usage": READ_SCOPES,
     "research_get_run_execution": READ_SCOPES,

{synth_ai-0.22.2.dev687 → synth_ai-0.22.2.dev688}/synth_ai/mcp/research/server.py

@@ -173,6 +173,7 @@ _STABLE_TOOL_NAMES = RESOURCE_READ_TOOL_NAMES | frozenset(
         "research_get_record",
         "research_get_record_citations",
         "research_get_native_attachments",
+        "research_verify_citations",
         "research_list_records",
         "research_get_operation_receipt",
         "research_record_events",
@@ -192,6 +193,7 @@ _STABLE_TOOL_NAMES = RESOURCE_READ_TOOL_NAMES | frozenset(
         "research_get_run_transcript",
         "research_get_swarm_activity",
         "research_get_swarm_configuration",
+        "research_get_run_history",
         "research_get_swarm_evidence",
         "research_get_swarm_status",
         "research_get_swarm_usage",
@@ -2015,6 +2017,13 @@ class ResearchMcpServer:
             result = client.runs.get(run_id, project_id=project_id)
             return asdict(result) if is_dataclass(result) else result
 
+    def _tool_get_run_history(self, args: JSONDict) -> JSONDict:
+        run_id = SwarmId(require_string(args, "run_id"))
+        after = _optional_int_default(args, "after", 0)
+        limit = _optional_int_default(args, "limit", 100)
+        with self._core_client_from_args(args) as client:
+            return client.swarms.history(run_id, after=after, limit=limit).to_wire()
+
     def _tool_get_swarm_configuration(self, args: JSONDict) -> JSONDict:
         swarm_id = SwarmId(require_string(args, "run_id"))
         with self._core_client_from_args(args) as client:

{synth_ai-0.22.2.dev687 → synth_ai-0.22.2.dev688}/synth_ai/mcp/research/tools/index.py

@@ -7,8 +7,7 @@ Upload reads only explicitly listed files under an explicit root: this stdio ser
 runs on the caller's machine; the hosted server cannot read a client's disk.
 """
 
-import re
-from collections.abc import Callable, Mapping
+from collections.abc import Callable
 from contextlib import AbstractContextManager
 from typing import Annotated
 
@@ -24,11 +23,11 @@ from synth_ai.mcp.research.tools.index_qa import (
     QA_READ_TOOL_NAMES,
     build_qa_tools,
 )
-from synth_ai.mcp.research.tools.local_files import SelectedFileReader
 from synth_ai.sdk.index.catalog import PublicSearchCapability
 from synth_ai.sdk.index.client import STATUS_POLL_TIMEOUT_SECONDS, IndexAPI, PublicIndexAPI
 from synth_ai.sdk.index.contracts import ContributionReference, Identifier, IndexContract
 from synth_ai.sdk.index.contributions import ContributionDraft, ContributionUploadSpec
+from synth_ai.sdk.index.local_files import read_selected_files
 from synth_ai.sdk.index.public_search import (
     DEFAULT_PUBLIC_SEARCH_WAIT_SECONDS,
     PublicSearchDisabledError,
@@ -75,11 +74,6 @@ INDEX_WRITE_TOOL_NAMES: tuple[str, ...] = (
 )
 INDEX_TOOL_NAMES = frozenset(INDEX_READ_TOOL_NAMES + INDEX_WRITE_TOOL_NAMES)
 
-_UPLOAD_MAX_BYTES = 64 * 1024 * 1024
-_CREDENTIAL = re.compile(
-    rb"(sk-[A-Za-z0-9_-]{20,}|AKIA[0-9A-Z]{16}|-----BEGIN [A-Z ]*PRIVATE KEY"
-    rb"|ghp_[A-Za-z0-9]{30,}|xox[bpa]-[A-Za-z0-9-]{10,})"
-)
 _KEY = Field(min_length=1, max_length=128, pattern=r"^[a-zA-Z0-9_.-]+$")
 
 
@@ -158,20 +152,6 @@ class SubmitRequest(IndexContract):
     spec: ContributionSubmitSpec
 
 
-def read_selected_files(root: str, files: Mapping[str, str]) -> dict[str, bytes]:
-    """Read exactly the listed regular files; reject escapes, symlinks and secrets."""
-    content: dict[str, bytes] = {}
-    total = 0
-    with SelectedFileReader(root) as reader:
-        for logical_path, relative in files.items():
-            data = reader.read(relative, _UPLOAD_MAX_BYTES - total)
-            total += len(data)
-            if _CREDENTIAL.search(data):
-                raise ValueError(f"{logical_path}: possible credential; remove it before upload")
-            content[logical_path] = data
-    return content
-
-
 _PUBLIC_SEARCH_DESCRIPTION = (
     "Search reviewed Synth Index Contributions (Index Search v0.2). Without an API key "
     "this is the free public search; mode is fast (synchronous) or deep (admitted, then "

synth_ai-0.22.2.dev688/synth_ai/mcp/research/tools/local_files.py

@@ -0,0 +1,5 @@
+"""Compatibility import for the shared descriptor-confined file reader."""
+
+from synth_ai.core.local_files import SelectedFileReader
+
+__all__ = ["SelectedFileReader"]

{synth_ai-0.22.2.dev687 → synth_ai-0.22.2.dev688}/synth_ai/mcp/research/tools/runs.py

@@ -821,6 +821,19 @@ def build_run_tools(server: Any) -> list[ToolDefinition]:
             ),
             handler=server._tool_get_run,
         ),
+        ToolDefinition(
+            name="research_get_run_history",
+            description="Read a bounded backend-authorized journal page with decision reasons and redacted inputs.",
+            input_schema=tool_schema(
+                {
+                    "run_id": {"type": "string", "description": "Research run id."},
+                    "after": {"type": "integer", "minimum": 0, "maximum": 2**64 - 1},
+                    "limit": {"type": "integer", "minimum": 1, "maximum": 256},
+                },
+                required=["run_id"],
+            ),
+            handler=server._tool_get_run_history,
+        ),
         ToolDefinition(
             name="research_get_swarm_configuration",
             description=(

{synth_ai-0.22.2.dev687 → synth_ai-0.22.2.dev688}/synth_ai/mcp/research/tools/scientific_records.py

@@ -58,6 +58,14 @@ class EventArguments(Contract):
     limit: int = Field(default=100, ge=1, le=1000)
 
 
+READ_DESCRIPTIONS = {
+    "research_verify_citations": (
+        "Check a retained record revision's external citations: retained, dangling, "
+        "denied, conflict, unavailable or refused. Read-only."
+    ),
+}
+
+
 def build_scientific_record_tools(client_factory):
     def execution_writer(arguments):
         selected = ExecutionWriteArguments.model_validate(arguments)
@@ -159,6 +167,7 @@ def build_scientific_record_tools(client_factory):
     )
     for name, model, method in (
         ("research_get_record", ReadArguments, "get"),
+        ("research_verify_citations", ReadArguments, "verify_citations"),
         ("research_list_records", ListArguments, "list"),
         ("research_get_operation_receipt", ReceiptArguments, "receipt"),
         ("research_record_events", EventArguments, "events"),
@@ -180,7 +189,9 @@ def build_scientific_record_tools(client_factory):
         tools.append(
             ToolDefinition(
                 name=name,
-                description="Read scoped retained scientific evidence.",
+                description=READ_DESCRIPTIONS.get(
+                    name, "Read scoped retained scientific evidence."
+                ),
                 input_schema=model.model_json_schema(),
                 handler=reader(model, method),
                 required_scopes=READ_SCOPES,

synth_ai-0.22.2.dev688/synth_ai/sdk/index/local_files.py

@@ -0,0 +1,32 @@
+"""Explicit, bounded local bytes shared by Index SDK, CLI and MCP uploads.
+
+# See: synth_ai/core/local_files.py (descriptor confinement)
+"""
+
+import re
+from collections.abc import Mapping
+
+from synth_ai.core.local_files import SelectedFileReader
+
+_UPLOAD_MAX_BYTES = 64 * 1024 * 1024
+_CREDENTIAL = re.compile(
+    rb"(sk-[A-Za-z0-9_-]{20,}|AKIA[0-9A-Z]{16}|-----BEGIN [A-Z ]*PRIVATE KEY"
+    rb"|ghp_[A-Za-z0-9]{30,}|xox[bpa]-[A-Za-z0-9-]{10,})"
+)
+
+
+def read_selected_files(root: str, files: Mapping[str, str]) -> dict[str, bytes]:
+    """Read exactly the listed regular files; reject escapes, symlinks and secrets."""
+    content: dict[str, bytes] = {}
+    total = 0
+    with SelectedFileReader(root) as reader:
+        for logical_path, relative in files.items():
+            data = reader.read(relative, _UPLOAD_MAX_BYTES - total)
+            total += len(data)
+            if _CREDENTIAL.search(data):
+                raise ValueError(f"{logical_path}: possible credential; remove it before upload")
+            content[logical_path] = data
+    return content
+
+
+__all__ = ["read_selected_files"]

{synth_ai-0.22.2.dev687 → synth_ai-0.22.2.dev688}/synth_ai/sdk/index/upload_session.py

@@ -30,8 +30,8 @@ from urllib.parse import urlsplit
 import httpx
 from pydantic import ValidationError
 
-from synth_ai.mcp.research.tools.index import read_selected_files
 from synth_ai.sdk.index.contributions import ContributionUploadPrepared
+from synth_ai.sdk.index.local_files import read_selected_files
 from synth_ai.sdk.index.transfer import _transfer_content
 
 _ACCEPTED = (200, 201, 204)

{synth_ai-0.22.2.dev687 → synth_ai-0.22.2.dev688}/synth_ai/sdk/research/contracts/__init__.py

@@ -430,6 +430,11 @@ from synth_ai.sdk.research.contracts.runtime_stream_snapshot import (
 )
 from synth_ai.sdk.research.contracts.status import SwarmPendingAction
 from synth_ai.sdk.research.contracts.swarm_controls import SwarmControlReceipt
+from synth_ai.sdk.research.contracts.swarm_history import (
+    SwarmHistoryDecision,
+    SwarmHistoryEntry,
+    SwarmHistoryPage,
+)
 from synth_ai.sdk.research.contracts.swarm_tasks import (
     RetryKind,
     ReviewVerdict,
@@ -626,6 +631,9 @@ def __getattr__(name: str) -> object:
 
 
 __all__ = [
+    "SwarmHistoryDecision",
+    "SwarmHistoryEntry",
+    "SwarmHistoryPage",
     "SwarmControlReceipt",
     "ReviewVerdict",
     "RetryKind",

synth_ai-0.22.2.dev688/synth_ai/sdk/research/contracts/forge_citations.py

@@ -0,0 +1,29 @@
+# Mirrors backend services/forge/client.py (CitationVerification) and Forge
+# forge_service.persistence.CitationVerification (forge.citation-verification.v1).
+"""Read-time custodian state of a retained revision's external citations (R06).
+
+The retained record and its exact references are never changed or dropped;
+each external citation reports ``retained``, ``dangling`` (deleted/retired or
+withdrawn), ``denied`` (revoked grant, foreign scope), ``conflict``,
+``unavailable`` or ``refused`` with the custodian's closed code.
+"""
+
+from typing import Literal
+
+from synth_ai.sdk.research.contracts.forge.contracts import Contract, ExactReference
+
+CitationStatus = Literal["retained", "dangling", "denied", "conflict", "unavailable", "refused"]
+
+
+class CitationCheck(Contract):
+    reference: ExactReference
+    status: CitationStatus
+    code: str = ""
+    authority_code: str = ""
+
+
+class CitationVerification(Contract):
+    schema_version: Literal["forge.citation-verification.v1"]
+    record: ExactReference
+    citations: tuple[CitationCheck, ...]
+    retained: bool

synth_ai-0.22.2.dev688/synth_ai/sdk/research/contracts/forge_uploads.py

@@ -0,0 +1,84 @@
+# Generated from backend packages/forge_authority/uploads.py.
+"""Bounded private Forge publication contract; forge-authority.v1.md."""
+
+import base64
+import hashlib
+from typing import Literal
+
+from pydantic import Field, model_validator
+
+from synth_ai.sdk.research.contracts.forge.contracts import (
+    Contract,
+    Digest,
+    ExactReference,
+    Identifier,
+    Scope,
+)
+
+MAX_UPLOAD_BYTES = 4 * 1024 * 1024
+
+
+class UploadObject(Contract):
+    logical_path: str = Field(min_length=1, max_length=1024)
+    media_type: str = Field(min_length=1, max_length=128)
+    content_base64: str = Field(max_length=5592408, repr=False)
+    digest_sha256: Digest
+    size_bytes: int = Field(strict=True, ge=0, le=MAX_UPLOAD_BYTES)
+
+    @model_validator(mode="after")
+    def exact_bytes(self):
+        if (
+            "\\" in self.logical_path
+            or "\x00" in self.logical_path
+            or any(part in {"", ".", ".."} for part in self.logical_path.split("/"))
+        ):
+            raise ValueError("normalized relative path required")
+        if len(self.bytes()) != self.size_bytes:
+            raise ValueError("declared bytes differ")
+        return self
+
+    def bytes(self):
+        content = base64.b64decode(self.content_base64, validate=True)
+        if (
+            len(content) > MAX_UPLOAD_BYTES
+            or hashlib.sha256(content).hexdigest() != self.digest_sha256
+        ):
+            raise ValueError("exact bounded byte digest required")
+        return content
+
+
+class UploadRequest(Contract):
+    schema_version: Literal["synth.forge.upload.v1"] = "synth.forge.upload.v1"
+    scope: Scope
+    operation_id: Identifier
+    objects: tuple[UploadObject, ...] = Field(min_length=1, max_length=16)
+
+    @model_validator(mode="after")
+    def bounded_unique_objects(self):
+        if len({item.logical_path for item in self.objects}) != len(self.objects):
+            raise ValueError("unique object paths required")
+        if sum(item.size_bytes for item in self.objects) > MAX_UPLOAD_BYTES:
+            raise ValueError("publication exceeds 4 MiB")
+        if len({item.digest_sha256 for item in self.objects}) != len(self.objects):
+            raise ValueError("unique object digests required for exact reference lookup")
+        return self
+
+
+class UploadedObject(Contract):
+    logical_path: str
+    media_type: str
+    size_bytes: int
+    reference: ExactReference
+
+
+class Uploaded(Contract):
+    schema_version: Literal["synth.forge.upload.v1"] = "synth.forge.upload.v1"
+    result: Literal["committed"] = "committed"
+    scope: Scope
+    operation_id: Identifier
+    request_digest_sha256: Digest
+    publication_id: str
+    collection_id: str
+    revision: int = Field(strict=True, ge=1)
+    manifest: ExactReference
+    objects: tuple[UploadedObject, ...] = Field(min_length=1, max_length=16)

{synth_ai-0.22.2.dev687 → synth_ai-0.22.2.dev688}/synth_ai/sdk/research/contracts/runtime_intent.py

@@ -21,6 +21,7 @@ class RuntimeIntentKind(StrEnum):
     RECORD_SPEND = "record_spend"
     PLAN_TASKS = "plan_tasks"
     WRITE_PROJECT_MILESTONES = "write_project_milestones"
+    TOOL_WRITE = "tool_write"
 
 
 class RuntimeIntentStatus(StrEnum):
@@ -283,6 +284,38 @@ class RuntimeIntentReceipt:
         )
 
 
+@dataclass(frozen=True)
+class RuntimeScientificRecordReference:
+    """Consumer of backend docs/contracts/runtime-scientific-record.v1.md."""
+
+    schema_version: str
+    kind: str
+    record_id: str
+    parent_entry_id: str | None = None
+
+    @classmethod
+    def from_wire(cls, payload: object) -> RuntimeScientificRecordReference:
+        from uuid import UUID
+
+        mapping = _require_mapping(payload, label="scientific record reference")
+        if mapping.get("schema_version") != "runtime_scientific_record.v1":
+            raise ValueError("unsupported scientific record reference version")
+        kind = str(mapping.get("kind") or "")
+        if kind not in {
+            "experiment_log_append",
+            "experiment_log_attach_link",
+            "work_product_publish_report",
+        }:
+            raise ValueError("unsupported scientific record reference kind")
+        identity = str(UUID(str(mapping.get("record_id") or "")))
+        parent = mapping.get("parent_entry_id")
+        if parent is not None:
+            parent = str(UUID(str(parent)))
+        if kind == "experiment_log_attach_link" and parent is None:
+            raise ValueError("scientific link reference requires parent entry")
+        return cls("runtime_scientific_record.v1", kind, identity, parent)
+
+
 @dataclass(frozen=True)
 class RuntimeIntentView(RuntimeIntentReceipt):
     message_id: str = ""
@@ -301,6 +334,7 @@ class RuntimeIntentView(RuntimeIntentReceipt):
     error_detail: str | None = None
     retryable: bool = False
     applied_mode: str | None = None
+    scientific_record: RuntimeScientificRecordReference | None = None
 
     @classmethod
     def from_wire(cls, payload: object) -> RuntimeIntentView:
@@ -331,6 +365,11 @@ class RuntimeIntentView(RuntimeIntentReceipt):
             error_detail=_optional_string(mapping, "error_detail"),
             retryable=bool(mapping.get("retryable", False)),
             applied_mode=_optional_string(mapping, "applied_mode"),
+            scientific_record=(
+                RuntimeScientificRecordReference.from_wire(mapping["scientific_record"])
+                if mapping.get("scientific_record") is not None
+                else None
+            ),
         )
 
 
@@ -341,4 +380,5 @@ __all__ = [
     "RuntimeIntentStatus",
     "RuntimeIntentView",
     "RuntimeMessageMode",
+    "RuntimeScientificRecordReference",
 ]

{synth_ai-0.22.2.dev687 → synth_ai-0.22.2.dev688}/synth_ai/sdk/research/contracts/status.py

@@ -397,6 +397,50 @@ class SwarmPendingAction:
         }
 
 
+@dataclass(frozen=True, slots=True)
+class SwarmStatusAuthorityRef:
+    """Evidence reference to the constructor terminal that owns terminal truth.
+
+    # See: backend services/smr/runtime/terminal_public_adapter.py (hotspot 2a)
+    """
+
+    owner: str
+    schema: str
+    reference: str
+    sha256: str
+
+    @classmethod
+    def from_wire(cls, value: JsonValue) -> SwarmStatusAuthorityRef:
+        payload = _exact(
+            value,
+            label="swarm status authority_ref",
+            fields=frozenset({"owner", "schema", "reference", "sha256"}),
+        )
+        return cls(
+            required_text(payload, "owner"),
+            required_text(payload, "schema"),
+            required_text(payload, "reference"),
+            required_text(payload, "sha256"),
+        )
+
+    def to_wire(self) -> JsonObject:
+        return {
+            "owner": self.owner,
+            "schema": self.schema,
+            "reference": self.reference,
+            "sha256": self.sha256,
+        }
+
+
+def _optional_bool(payload: JsonObject, name: str) -> bool | None:
+    value = payload.get(name)
+    if value is None:
+        return None
+    if not isinstance(value, bool):
+        raise ValueError(f"{name} must be a boolean or null")
+    return value
+
+
 _STATUS_FIELDS = frozenset(
     {
         "schema_version",
@@ -413,8 +457,15 @@ _STATUS_FIELDS = frozenset(
         "freshness",
     }
 )
-# Orchestra-authority runs carry unanswered actions; older backends omit the key.
-_STATUS_OPTIONAL_FIELDS = frozenset({"pending_questions"})
+# Known keys an older backend may omit. Each is parsed strictly when present:
+# Orchestra-authority runs carry unanswered actions (``pending_questions``);
+# the hotspot 2a terminal adapter (Pressure beceec07) carries ``active``,
+# ``authority_ref`` and ``finished_at``.
+_STATUS_OPTIONAL_FIELDS = frozenset({"pending_questions", "active", "authority_ref", "finished_at"})
+
+
+# Preserve both public names for the same strict pending-question contract.
+SwarmStatusPendingQuestion = SwarmPendingAction
 
 
 @dataclass(frozen=True, slots=True)
@@ -434,18 +485,31 @@ class SwarmStatus:
     freshness: SwarmStatusFreshness
     schema_version: int = 1
     pending_actions: tuple[SwarmPendingAction, ...] = ()
+    # ``None`` means the backend did not send the key (older backend) or
+    # explicitly published no value (no terminal authority / refused authority).
+    active: bool | None = None
+    authority_ref: SwarmStatusAuthorityRef | None = None
+    finished_at: datetime | None = None
+    # Top-level keys this SDK does not know yet. Additive server fields must
+    # not break installed clients (Pressure 6204833e); their names are kept so
+    # callers can detect a newer server, their values are not interpreted.
+    unrecognized_fields: frozenset[str] = frozenset()
+
+    @property
+    def pending_questions(self) -> tuple[SwarmPendingAction, ...]:
+        return self.pending_actions
 
     @classmethod
     def from_wire(cls, value: JsonValue) -> SwarmStatus:
         payload = object_value(value, operation_id="retrieve_swarm_status")
-        present = payload.keys() - _STATUS_OPTIONAL_FIELDS
-        missing, extra = _STATUS_FIELDS - present, present - _STATUS_FIELDS
-        if missing or extra:
-            raise ValueError(
-                "retrieve_swarm_status fields drifted: "
-                f"missing={sorted(missing)!r} extra={sorted(extra)!r}"
-            )
+        missing = _STATUS_FIELDS - payload.keys()
+        if missing:
+            raise ValueError(f"retrieve_swarm_status fields drifted: missing={sorted(missing)!r}")
+        unrecognized = frozenset(
+            str(key) for key in payload.keys() - _STATUS_FIELDS - _STATUS_OPTIONAL_FIELDS
+        )
         pending = payload.get("pending_questions")
+        authority_ref = payload.get("authority_ref")
         schema_version = payload["schema_version"]
         if schema_version != 1:
             raise ValueError(f"unsupported swarm status schema_version {schema_version!r}")
@@ -470,6 +534,10 @@ class SwarmStatus:
                     else array_value(pending, operation_id="swarm status pending_questions")
                 )
             ),
+            _optional_bool(payload, "active"),
+            None if authority_ref is None else SwarmStatusAuthorityRef.from_wire(authority_ref),
+            _optional_datetime(payload, "finished_at"),
+            unrecognized,
         )
 
     def to_wire(self) -> JsonObject:
@@ -560,12 +628,16 @@ class SwarmStatus:
                 "generated_at": self.freshness.generated_at.isoformat(),
             },
             "pending_questions": [item.to_wire() for item in self.pending_actions],
+            "active": self.active,
+            "authority_ref": None if self.authority_ref is None else self.authority_ref.to_wire(),
+            "finished_at": None if self.finished_at is None else self.finished_at.isoformat(),
         }
 
 
 __all__ = [
     "SwarmPendingAction",
     "SwarmStatus",
+    "SwarmStatusAuthorityRef",
     "SwarmStatusFailure",
     "SwarmStatusFinalization",
     "SwarmStatusFreshness",