tango-python 0.5.0__py3-none-any.whl → 0.6.0__py3-none-any.whl

tango/__init__.py

@@ -15,6 +15,8 @@ from .models import (
     RateLimitInfo,
     SearchFilters,
     ShapeConfig,
+    Vehicle,
+    VehicleMetrics,
     WebhookEndpoint,
     WebhookEventType,
     WebhookEventTypesResponse,
@@ -28,8 +30,14 @@ from .shapes import (
     ShapeParser,
     TypeGenerator,
 )
+from .webhooks import (
+    generate_signature,
+    parse_signature_header,
+    verify_signature,
+)
+from .webhooks.receiver import Delivery, WebhookReceiver
 
-__version__ = "0.5.0"
+__version__ = "0.6.0"
 __all__ = [
     "TangoClient",
     "TangoAPIError",
@@ -43,6 +51,8 @@ __all__ = [
     "PaginatedResponse",
     "SearchFilters",
     "ShapeConfig",
+    "Vehicle",
+    "VehicleMetrics",
     "WebhookEndpoint",
     "WebhookEventType",
     "WebhookEventTypesResponse",
@@ -53,4 +63,9 @@ __all__ = [
     "ModelFactory",
     "TypeGenerator",
     "SchemaRegistry",
+    "Delivery",
+    "WebhookReceiver",
+    "generate_signature",
+    "parse_signature_header",
+    "verify_signature",
 ]

tango/client.py

@@ -1,6 +1,7 @@
 """Tango API Client"""
 
 import os
+import warnings
 from datetime import date, datetime
 from decimal import Decimal
 from typing import Any
@@ -123,6 +124,7 @@ class TangoClient:
     @staticmethod
     def _parse_rate_limit_headers(headers: httpx.Headers) -> RateLimitInfo:
         """Extract rate limit info from response headers."""
+
         def _int_or_none(val: str | None) -> int | None:
             if val is None:
                 return None
@@ -1447,6 +1449,40 @@ class TangoClient:
     # Vehicles (Awards)
     # ============================================================================
 
+    @staticmethod
+    def _warn_deprecated_vehicle_shape(shape: str | None) -> None:
+        # Upstream sends `Deprecation: true` for these fields/expansions; warn
+        # callers who request them explicitly so they have time to migrate
+        # before tango publishes a Sunset timeline.
+        from tango.shapes.explicit_schemas import DEPRECATED_VEHICLE_SHAPE_FIELDS
+
+        if not shape:
+            return
+        # Match top-level field tokens, ignoring nesting inside parentheses.
+        depth = 0
+        token = ""
+        tokens: list[str] = []
+        for ch in shape:
+            if ch == "(":
+                depth += 1
+            elif ch == ")":
+                depth = max(0, depth - 1)
+            elif ch == "," and depth == 0:
+                tokens.append(token.strip())
+                token = ""
+                continue
+            token += ch
+        tokens.append(token.strip())
+        used = {t.split("(", 1)[0] for t in tokens} & DEPRECATED_VEHICLE_SHAPE_FIELDS
+        if used:
+            warnings.warn(
+                f"Vehicle shape field(s) {sorted(used)!r} are deprecated upstream "
+                "and may be removed in a future tango API version. The API currently "
+                "returns a `Deprecation: true` header for these.",
+                DeprecationWarning,
+                stacklevel=3,
+            )
+
     def list_vehicles(
         self,
         page: int = 1,
@@ -1456,12 +1492,46 @@ class TangoClient:
         flat_lists: bool = False,
         joiner: str = ".",
         search: str | None = None,
+        vehicle_type: str | None = None,
+        type_of_idc: str | None = None,
+        contract_type: str | None = None,
+        set_aside: str | None = None,
+        who_can_use: str | None = None,
+        naics_code: int | None = None,
+        psc_code: str | None = None,
+        program_acronym: str | None = None,
+        agency: str | None = None,
+        organization_id: str | None = None,
+        total_obligated_min: float | int | Decimal | None = None,
+        total_obligated_max: float | int | Decimal | None = None,
+        idv_count_min: int | None = None,
+        idv_count_max: int | None = None,
+        order_count_min: int | None = None,
+        order_count_max: int | None = None,
+        fiscal_year: int | None = None,
+        award_date_after: str | date | datetime | None = None,
+        award_date_before: str | date | datetime | None = None,
+        last_date_to_order_after: str | date | datetime | None = None,
+        last_date_to_order_before: str | date | datetime | None = None,
+        ordering: str | None = None,
     ) -> PaginatedResponse:
-        """List Vehicles (solicitation-centric groupings of IDVs)."""
+        """List Vehicles (solicitation-centric groupings of IDVs).
+
+        Multi-value filters (``vehicle_type``, ``type_of_idc``, ``contract_type``,
+        ``set_aside``) accept pipe-separated values for OR semantics, e.g.
+        ``vehicle_type="A|B|C"``.
+
+        ``ordering`` accepts: ``vehicle_obligations``, ``latest_award_date``,
+        ``total_obligated``, ``award_date``, ``last_date_to_order``,
+        ``fiscal_year``, ``idv_count``, ``order_count``. Prefix with ``-`` for
+        descending.
+        """
         params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
 
         if shape is None:
             shape = ShapeConfig.VEHICLES_MINIMAL
+        else:
+            self._warn_deprecated_vehicle_shape(shape)
         if shape:
             params["shape"] = shape
             if flat:
@@ -1471,8 +1541,37 @@ class TangoClient:
             if flat_lists:
                 params["flat_lists"] = "true"
 
-        if search:
-            params["search"] = search
+        for k, val in (
+            ("search", search),
+            ("vehicle_type", vehicle_type),
+            ("type_of_idc", type_of_idc),
+            ("contract_type", contract_type),
+            ("set_aside", set_aside),
+            ("who_can_use", who_can_use),
+            ("naics_code", naics_code),
+            ("psc_code", psc_code),
+            ("program_acronym", program_acronym),
+            ("agency", agency),
+            ("organization_id", organization_id),
+            ("total_obligated_min", total_obligated_min),
+            ("total_obligated_max", total_obligated_max),
+            ("idv_count_min", idv_count_min),
+            ("idv_count_max", idv_count_max),
+            ("order_count_min", order_count_min),
+            ("order_count_max", order_count_max),
+            ("fiscal_year", fiscal_year),
+            ("award_date_after", award_date_after),
+            ("award_date_before", award_date_before),
+            ("last_date_to_order_after", last_date_to_order_after),
+            ("last_date_to_order_before", last_date_to_order_before),
+            ("ordering", ordering),
+        ):
+            if val is None:
+                continue
+            if isinstance(val, (date, datetime)):
+                params[k] = val.isoformat()
+            else:
+                params[k] = val
 
         data = self._get("/api/vehicles/", params)
 
@@ -1504,6 +1603,8 @@ class TangoClient:
 
         if shape is None:
             shape = ShapeConfig.VEHICLES_COMPREHENSIVE
+        else:
+            self._warn_deprecated_vehicle_shape(shape)
         if shape:
             params["shape"] = shape
             if flat:
@@ -1531,8 +1632,14 @@ class TangoClient:
         flat: bool = False,
         flat_lists: bool = False,
         joiner: str = ".",
+        search: str | None = None,
     ) -> PaginatedResponse:
-        """List the IDV awardees for a Vehicle (`/api/vehicles/{uuid}/awardees/`)."""
+        """List the IDV awardees for a Vehicle (`/api/vehicles/{uuid}/awardees/`).
+
+        ``search`` runs entity-aware full-text search across IDV fields
+        (PIID, key, solicitation_identifier, NAICS, PSC, idv_type,
+        fiscal_year) and recipient entity details (name, address).
+        """
         params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
 
         if shape is None:
@@ -1546,6 +1653,9 @@ class TangoClient:
             if flat_lists:
                 params["flat_lists"] = "true"
 
+        if search:
+            params["search"] = search
+
         data = self._get(f"/api/vehicles/{uuid}/awardees/", params)
 
         results = [
@@ -1560,6 +1670,54 @@ class TangoClient:
             results=results,
         )
 
+    def list_vehicle_orders(
+        self,
+        uuid: str,
+        page: int = 1,
+        limit: int = 25,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+        joiner: str = ".",
+        ordering: str | None = None,
+    ) -> PaginatedResponse:
+        """List task orders under a Vehicle's IDVs (``/api/vehicles/{uuid}/orders/``).
+
+        Args:
+            ordering: Server-side sort. Allowed: ``award_date`` (default),
+                ``obligated``, ``total_contract_value``. Prefix with ``-`` for
+                descending.
+        """
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
+
+        if shape is None:
+            shape = ShapeConfig.VEHICLE_ORDERS_MINIMAL
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+                if joiner:
+                    params["joiner"] = joiner
+            if flat_lists:
+                params["flat_lists"] = "true"
+
+        if ordering:
+            params["ordering"] = ordering
+
+        data = self._get(f"/api/vehicles/{uuid}/orders/", params)
+
+        results = [
+            self._parse_response_with_shape(order, shape, Contract, flat, flat_lists, joiner=joiner)
+            for order in data["results"]
+        ]
+
+        return PaginatedResponse(
+            count=data["count"],
+            next=data.get("next"),
+            previous=data.get("previous"),
+            results=results,
+        )
+
     # Business Types endpoints
     def list_business_types(self, page: int = 1, limit: int = 25) -> PaginatedResponse:
         """List business types"""

tango/models.py

@@ -413,6 +413,12 @@ class Vehicle:
     uuid: str
     solicitation_identifier: str
     agency_id: str
+    is_synthetic_solicitation: bool | None = None
+    program_acronym: str | None = None
+    description: str | None = None
+    idv_count: int | None = None
+    total_obligated: Decimal | None = None
+    latest_award_date: date | None = None
     solicitation_title: str | None = None
     solicitation_date: date | None = None
     award_date: date | None = None
@@ -420,6 +426,24 @@ class Vehicle:
     fiscal_year: int | None = None
 
 
+@dataclass
+class VehicleMetrics:
+    """Schema definition for the Vehicle `metrics(*)` expansion (not used for instances)"""
+
+    avg_offers_received: float | None = None
+    award_concentration_hhi: float | None = None
+    order_concentration_hhi: float | None = None
+    competed_rate: float | None = None
+    using_agency_count: int | None = None
+    avg_order_value: float | None = None
+    max_order_value: float | None = None
+    top_recipient_share: float | None = None
+    recent_obligations_24mo: float | None = None
+    recent_orders_24mo: int | None = None
+    days_since_last_order: int | None = None
+    obligation_to_ceiling_ratio: float | None = None
+
+
 @dataclass
 class Entity:
     """Schema definition for Entity (not used for instances)"""
@@ -690,21 +714,34 @@ class ShapeConfig:
 
     # Default for list_vehicles()
     VEHICLES_MINIMAL: Final = (
-        "uuid,solicitation_identifier,organization_id,awardee_count,order_count,"
-        "vehicle_obligations,vehicle_contracts_value,solicitation_title,solicitation_date"
+        "uuid,solicitation_identifier,is_synthetic_solicitation,program_acronym,"
+        "organization_id,organization,vehicle_type,description,"
+        "idv_count,awardee_count,order_count,total_obligated,"
+        "vehicle_obligations,vehicle_contracts_value,latest_award_date,"
+        "solicitation_title,solicitation_date"
     )
 
     # Default for get_vehicle()
     VEHICLES_COMPREHENSIVE: Final = (
-        "uuid,solicitation_identifier,agency_id,organization_id,vehicle_type,who_can_use,"
-        "solicitation_title,solicitation_description,solicitation_date,naics_code,psc_code,set_aside,"
-        "fiscal_year,award_date,last_date_to_order,awardee_count,order_count,vehicle_obligations,vehicle_contracts_value,"
-        "type_of_idc,contract_type,competition_details(*)"
+        "uuid,solicitation_identifier,is_synthetic_solicitation,agency_id,program_acronym,"
+        "organization_id,organization(*),vehicle_type,who_can_use,"
+        "solicitation_title,solicitation_description,solicitation_date,opportunity_id,"
+        "naics_code,psc_code,set_aside,"
+        "fiscal_year,award_date,latest_award_date,last_date_to_order,"
+        "description,idv_count,awardee_count,order_count,total_obligated,"
+        "vehicle_obligations,vehicle_contracts_value,"
+        "type_of_idc,contract_type,metrics(*)"
     )
 
     # Default for list_vehicle_awardees()
     VEHICLE_AWARDEES_MINIMAL: Final = "uuid,key,piid,award_date,title,order_count,idv_obligations,idv_contracts_value,recipient(display_name,uei)"
 
+    # Default for list_vehicle_orders()
+    VEHICLE_ORDERS_MINIMAL: Final = (
+        "key,piid,award_date,obligated,total_contract_value,description,"
+        "recipient(display_name,uei)"
+    )
+
     # Default for list_organizations()
     ORGANIZATIONS_MINIMAL: Final = "key,fh_key,name,level,type,short_name"
 

tango/shapes/explicit_schemas.py

@@ -37,6 +37,25 @@ AWARD_OFFICE_SCHEMA: dict[str, FieldSchema] = {
     ),
 }
 
+# Canonical 7-key office payload returned by the `organization(...)` shape
+# expand on awards, vehicles, forecasts, grants, IT Dashboard, and protests.
+# Resolved deterministically from the resource's organization_id.
+ORGANIZATION_OFFICE_SCHEMA: dict[str, FieldSchema] = {
+    "organization_id": FieldSchema(
+        name="organization_id", type=str, is_optional=True, is_list=False
+    ),
+    "office_code": FieldSchema(name="office_code", type=str, is_optional=True, is_list=False),
+    "office_name": FieldSchema(name="office_name", type=str, is_optional=True, is_list=False),
+    "agency_code": FieldSchema(name="agency_code", type=str, is_optional=True, is_list=False),
+    "agency_name": FieldSchema(name="agency_name", type=str, is_optional=True, is_list=False),
+    "department_code": FieldSchema(
+        name="department_code", type=str, is_optional=True, is_list=False
+    ),
+    "department_name": FieldSchema(
+        name="department_name", type=str, is_optional=True, is_list=False
+    ),
+}
+
 PERIOD_OF_PERFORMANCE_IDV_SCHEMA: dict[str, FieldSchema] = {
     "start_date": FieldSchema(name="start_date", type=date, is_optional=True, is_list=False),
     "last_date_to_order": FieldSchema(
@@ -396,6 +415,13 @@ CONTRACT_SCHEMA: dict[str, FieldSchema] = {
     "undefinitized_action": FieldSchema(
         name="undefinitized_action", type=str, is_optional=True, is_list=False
     ),
+    "vehicle": FieldSchema(
+        name="vehicle",
+        type=dict,
+        is_optional=True,
+        is_list=False,
+        nested_model="Vehicle",
+    ),
 }
 
 
@@ -556,6 +582,13 @@ FORECAST_SCHEMA: dict[str, FieldSchema] = {
     "source_system": FieldSchema(name="source_system", type=str, is_optional=False, is_list=False),
     "status": FieldSchema(name="status", type=str, is_optional=True, is_list=False),
     "title": FieldSchema(name="title", type=str, is_optional=False, is_list=False),
+    "organization": FieldSchema(
+        name="organization",
+        type=dict,
+        is_optional=True,
+        is_list=False,
+        nested_model="OrganizationOffice",
+    ),
 }
 
 
@@ -685,6 +718,13 @@ PROTEST_SCHEMA: dict[str, FieldSchema] = {
     "dockets": FieldSchema(
         name="dockets", type=dict, is_optional=True, is_list=True, nested_model="ProtestDocket"
     ),
+    "organization": FieldSchema(
+        name="organization",
+        type=dict,
+        is_optional=True,
+        is_list=False,
+        nested_model="OrganizationOffice",
+    ),
 }
 
 
@@ -785,6 +825,13 @@ GRANT_SCHEMA: dict[str, FieldSchema] = {
         is_list=True,
         nested_model="GrantAttachment",
     ),
+    "organization": FieldSchema(
+        name="organization",
+        type=dict,
+        is_optional=True,
+        is_list=False,
+        nested_model="OrganizationOffice",
+    ),
 }
 
 
@@ -838,6 +885,45 @@ VEHICLE_COMPETITION_DETAILS_SCHEMA: dict[str, FieldSchema] = {
 }
 
 
+# Vehicles expose a "metrics(...)" expansion bundling computed metrics.
+VEHICLE_METRICS_SCHEMA: dict[str, FieldSchema] = {
+    "avg_offers_received": FieldSchema(
+        name="avg_offers_received", type=float, is_optional=True, is_list=False
+    ),
+    "award_concentration_hhi": FieldSchema(
+        name="award_concentration_hhi", type=float, is_optional=True, is_list=False
+    ),
+    "order_concentration_hhi": FieldSchema(
+        name="order_concentration_hhi", type=float, is_optional=True, is_list=False
+    ),
+    "competed_rate": FieldSchema(name="competed_rate", type=float, is_optional=True, is_list=False),
+    "using_agency_count": FieldSchema(
+        name="using_agency_count", type=int, is_optional=True, is_list=False
+    ),
+    "avg_order_value": FieldSchema(
+        name="avg_order_value", type=float, is_optional=True, is_list=False
+    ),
+    "max_order_value": FieldSchema(
+        name="max_order_value", type=float, is_optional=True, is_list=False
+    ),
+    "top_recipient_share": FieldSchema(
+        name="top_recipient_share", type=float, is_optional=True, is_list=False
+    ),
+    "recent_obligations_24mo": FieldSchema(
+        name="recent_obligations_24mo", type=float, is_optional=True, is_list=False
+    ),
+    "recent_orders_24mo": FieldSchema(
+        name="recent_orders_24mo", type=int, is_optional=True, is_list=False
+    ),
+    "days_since_last_order": FieldSchema(
+        name="days_since_last_order", type=int, is_optional=True, is_list=False
+    ),
+    "obligation_to_ceiling_ratio": FieldSchema(
+        name="obligation_to_ceiling_ratio", type=float, is_optional=True, is_list=False
+    ),
+}
+
+
 # IDV schema (used for `/api/idvs/`, and also by Vehicles awardees shaping).
 IDV_SCHEMA: dict[str, FieldSchema] = {
     # Identifiers
@@ -970,26 +1056,52 @@ VEHICLE_SCHEMA: dict[str, FieldSchema] = {
     "solicitation_identifier": FieldSchema(
         name="solicitation_identifier", type=str, is_optional=False, is_list=False
     ),
+    "is_synthetic_solicitation": FieldSchema(
+        name="is_synthetic_solicitation", type=bool, is_optional=True, is_list=False
+    ),
     "agency_id": FieldSchema(name="agency_id", type=str, is_optional=False, is_list=False),
     "organization_id": FieldSchema(
         name="organization_id", type=str, is_optional=True, is_list=False
     ),
+    # Live awarding-org snapshot — canonical 7-key office payload. Selectable
+    # as the bare leaf (`shape=...,organization` returns the full dict) or as
+    # a sub-selectable expansion (`shape=...,organization(office_code,...)`).
+    "organization": FieldSchema(
+        name="organization",
+        type=dict,
+        is_optional=True,
+        is_list=False,
+        nested_model="OrganizationOffice",
+    ),
     # Choice fields are returned as {code, description} objects.
     "vehicle_type": FieldSchema(name="vehicle_type", type=dict, is_optional=True, is_list=False),
+    "program_acronym": FieldSchema(
+        name="program_acronym", type=str, is_optional=True, is_list=False
+    ),
     "who_can_use": FieldSchema(name="who_can_use", type=dict, is_optional=True, is_list=False),
     "type_of_idc": FieldSchema(name="type_of_idc", type=dict, is_optional=True, is_list=False),
     "contract_type": FieldSchema(name="contract_type", type=dict, is_optional=True, is_list=False),
+    # Deprecated: recomputed from IDVs at request time. Upstream sends `Deprecation: true`.
     "agency_details": FieldSchema(
         name="agency_details", type=dict, is_optional=True, is_list=False
     ),
+    "description": FieldSchema(name="description", type=str, is_optional=True, is_list=False),
     "descriptions": FieldSchema(name="descriptions", type=str, is_optional=True, is_list=True),
     "fiscal_year": FieldSchema(name="fiscal_year", type=int, is_optional=True, is_list=False),
     "award_date": FieldSchema(name="award_date", type=date, is_optional=True, is_list=False),
+    "latest_award_date": FieldSchema(
+        name="latest_award_date", type=date, is_optional=True, is_list=False
+    ),
     "last_date_to_order": FieldSchema(
         name="last_date_to_order", type=date, is_optional=True, is_list=False
     ),
+    # Denormalized rollups
+    "idv_count": FieldSchema(name="idv_count", type=int, is_optional=True, is_list=False),
     "awardee_count": FieldSchema(name="awardee_count", type=int, is_optional=True, is_list=False),
     "order_count": FieldSchema(name="order_count", type=int, is_optional=True, is_list=False),
+    "total_obligated": FieldSchema(
+        name="total_obligated", type=Decimal, is_optional=True, is_list=False
+    ),
     "vehicle_obligations": FieldSchema(
         name="vehicle_obligations", type=Decimal, is_optional=True, is_list=False
     ),
@@ -1006,6 +1118,7 @@ VEHICLE_SCHEMA: dict[str, FieldSchema] = {
     "solicitation_date": FieldSchema(
         name="solicitation_date", type=date, is_optional=True, is_list=False
     ),
+    "opportunity_id": FieldSchema(name="opportunity_id", type=str, is_optional=True, is_list=False),
     "naics_code": FieldSchema(name="naics_code", type=int, is_optional=True, is_list=False),
     "psc_code": FieldSchema(name="psc_code", type=str, is_optional=True, is_list=False),
     "set_aside": FieldSchema(name="set_aside", type=str, is_optional=True, is_list=False),
@@ -1013,6 +1126,14 @@ VEHICLE_SCHEMA: dict[str, FieldSchema] = {
     "awardees": FieldSchema(
         name="awardees", type=dict, is_optional=True, is_list=True, nested_model="IDV"
     ),
+    "metrics": FieldSchema(
+        name="metrics",
+        type=dict,
+        is_optional=True,
+        is_list=False,
+        nested_model="VehicleMetrics",
+    ),
+    # Deprecated expansions (upstream sends `Deprecation: true`).
     "opportunity": FieldSchema(
         name="opportunity", type=dict, is_optional=True, is_list=False, nested_model="Opportunity"
     ),
@@ -1026,6 +1147,14 @@ VEHICLE_SCHEMA: dict[str, FieldSchema] = {
 }
 
 
+# Top-level vehicle shape fields that upstream marks deprecated (the API sends
+# `Deprecation: true` and recomputes them from IDVs at request time). The client
+# emits a `DeprecationWarning` when callers explicitly include these in `shape`.
+DEPRECATED_VEHICLE_SHAPE_FIELDS: frozenset[str] = frozenset(
+    {"agency_details", "competition_details", "opportunity"}
+)
+
+
 # Organization (agencies hierarchy)
 ORGANIZATION_SCHEMA: dict[str, FieldSchema] = {
     "key": FieldSchema(name="key", type=str, is_optional=True, is_list=False),
@@ -1135,18 +1264,10 @@ GSA_ELIBRARY_CONTRACT_SCHEMA: dict[str, FieldSchema] = {
 # IT Dashboard Investment
 ITDASHBOARD_INVESTMENT_SCHEMA: dict[str, FieldSchema] = {
     "uii": FieldSchema(name="uii", type=str, is_optional=False, is_list=False),
-    "agency_code": FieldSchema(
-        name="agency_code", type=int, is_optional=True, is_list=False
-    ),
-    "agency_name": FieldSchema(
-        name="agency_name", type=str, is_optional=True, is_list=False
-    ),
-    "bureau_code": FieldSchema(
-        name="bureau_code", type=int, is_optional=True, is_list=False
-    ),
-    "bureau_name": FieldSchema(
-        name="bureau_name", type=str, is_optional=True, is_list=False
-    ),
+    "agency_code": FieldSchema(name="agency_code", type=int, is_optional=True, is_list=False),
+    "agency_name": FieldSchema(name="agency_name", type=str, is_optional=True, is_list=False),
+    "bureau_code": FieldSchema(name="bureau_code", type=int, is_optional=True, is_list=False),
+    "bureau_name": FieldSchema(name="bureau_name", type=str, is_optional=True, is_list=False),
     "investment_title": FieldSchema(
         name="investment_title", type=str, is_optional=True, is_list=False
     ),
@@ -1167,15 +1288,9 @@ ITDASHBOARD_INVESTMENT_SCHEMA: dict[str, FieldSchema] = {
     # Modeled as opaque dict/list since their inner shapes are dynamic.
     "funding": FieldSchema(name="funding", type=dict, is_optional=True, is_list=False),
     "details": FieldSchema(name="details", type=dict, is_optional=True, is_list=False),
-    "cio_evaluation": FieldSchema(
-        name="cio_evaluation", type=list, is_optional=True, is_list=True
-    ),
-    "contracts": FieldSchema(
-        name="contracts", type=list, is_optional=True, is_list=True
-    ),
-    "projects": FieldSchema(
-        name="projects", type=list, is_optional=True, is_list=True
-    ),
+    "cio_evaluation": FieldSchema(name="cio_evaluation", type=list, is_optional=True, is_list=True),
+    "contracts": FieldSchema(name="contracts", type=list, is_optional=True, is_list=True),
+    "projects": FieldSchema(name="projects", type=list, is_optional=True, is_list=True),
     "cost_pools_towers": FieldSchema(
         name="cost_pools_towers", type=list, is_optional=True, is_list=True
     ),
@@ -1191,6 +1306,13 @@ ITDASHBOARD_INVESTMENT_SCHEMA: dict[str, FieldSchema] = {
     "operational_analysis": FieldSchema(
         name="operational_analysis", type=list, is_optional=True, is_list=True
     ),
+    "organization": FieldSchema(
+        name="organization",
+        type=dict,
+        is_optional=True,
+        is_list=False,
+        nested_model="OrganizationOffice",
+    ),
 }
 
 # ============================================================================
@@ -1200,6 +1322,7 @@ ITDASHBOARD_INVESTMENT_SCHEMA: dict[str, FieldSchema] = {
 EXPLICIT_SCHEMAS: dict[str, dict[str, FieldSchema]] = {
     "Office": OFFICE_SCHEMA,
     "AwardOffice": AWARD_OFFICE_SCHEMA,
+    "OrganizationOffice": ORGANIZATION_OFFICE_SCHEMA,
     "Location": LOCATION_SCHEMA,
     "PlaceOfPerformance": PLACE_OF_PERFORMANCE_SCHEMA,
     "Competition": COMPETITION_SCHEMA,
@@ -1225,6 +1348,7 @@ EXPLICIT_SCHEMAS: dict[str, dict[str, FieldSchema]] = {
     "Vehicle": VEHICLE_SCHEMA,
     "IDV": IDV_SCHEMA,
     "VehicleCompetitionDetails": VEHICLE_COMPETITION_DETAILS_SCHEMA,
+    "VehicleMetrics": VEHICLE_METRICS_SCHEMA,
     # Nested schemas for Grant fields
     "CFDANumber": CFDA_NUMBER_SCHEMA,
     "CodeDescription": CODE_DESCRIPTION_SCHEMA,

tango/webhooks/__init__.py

@@ -0,0 +1,27 @@
+"""Tango webhooks: signature helpers and developer tooling.
+
+The signing helpers (:func:`verify_signature`, :func:`generate_signature`,
+:func:`parse_signature_header`) are pure stdlib and importable from a default
+``pip install tango``. The CLI (``tango webhooks ...``) and the in-process
+:class:`~tango.webhooks.receiver.WebhookReceiver` ship with the
+``tango[webhooks]`` extra.
+"""
+
+from tango.webhooks.signing import (
+    SIGNATURE_HEADER,
+    SIGNATURE_PREFIX,
+    generate_signature,
+    parse_signature_header,
+    verify_signature,
+)
+from tango.webhooks.simulate import SignedRequest, sign
+
+__all__ = [
+    "SIGNATURE_HEADER",
+    "SIGNATURE_PREFIX",
+    "SignedRequest",
+    "generate_signature",
+    "parse_signature_header",
+    "sign",
+    "verify_signature",
+]