tango-python 1.6.0__tar.gz → 1.8.0__tar.gz

{tango_python-1.6.0 → tango_python-1.8.0}/CHANGELOG.md

@@ -7,6 +7,45 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.8.0] - 2026-09-28
+
+### Added
+- **Federal Register documents** (Tango API 5.3.0). Two methods over the new `/api/federal_register/` resource: `list_federal_register_documents()` and `get_federal_register_document()`, plus a `FederalRegisterDocument` schema and the `FEDERAL_REGISTER_MINIMAL` / `FEDERAL_REGISTER_COMPREHENSIVE` defaults. These are the rules, proposed rules, notices and presidential documents published in the Federal Register since 1994. All seventeen of the API's filters are explicit named parameters, including `comments_open`, `cfr_title` / `cfr_part`, `rin`, and both `agency` (a Tango organization, including its sub-agencies) and `fr_agency` (the Federal Register's own agency slug).
+
+  `get_federal_register_document()` takes the document's `uuid`, not its `document_number`, because a document number is not unique on its own: the Federal Register reused some before 2016. Look a document up by number with `list_federal_register_documents(document_number=...)`. `full_text` is available on the detail method only when named in `shape`, and neither default shape includes it, since it can run to several MB. `ordering="rank"` requires a non-empty `search`, matching the API.
+- **`alerts.federal_register.match` is an alertable event type.** `create_webhook_alert(query_type="federal_register", ...)` works.
+- **`agency` filter on `list_budget_accounts()`, `list_exclusions()` and `list_itdashboard_investments()`** (Tango API 5.3.0). It takes a Tango agency name, abbreviation, code or organization key (e.g. `EPA`) and matches the whole organization subtree, so a department includes its sub-agencies; OR several with `|`. On exclusions it scopes by the excluding agency. On IT Dashboard it is available at every plan.
+- **The `organization` expand is accepted on budget accounts, exclusions, SBIR topics and SBIR solicitations**, along with the `organization_id` field on budget accounts and exclusions. `organization(...)` carries `agency_code`, `agency_name`, `department_code`, `department_name`, `office_code`, `office_name` and `organization_id`. The SDK rejected these shapes client-side before. The default shapes are unchanged.
+
+### Fixed
+- **`list_itdashboard_investments()` documents the API's current filter tiers.** `agency_name` is available at every plan, not Business+ only.
+
+## [1.7.0] - 2026-09-23
+
+### Added
+- **Contract Disputes Act appeals** (Tango API 4.26.0). Two methods over the new `/api/contract_appeals/` resource: `list_contract_appeals()` and `get_contract_appeal()`, plus a `ContractAppeal` schema and the `CONTRACT_APPEALS_MINIMAL` / `CONTRACT_APPEALS_COMPREHENSIVE` defaults. These are decisions of the Civilian Board of Contract Appeals (CBCA) and the Armed Services Board of Contract Appeals (ASBCA) — appeals of a contracting officer's final decision under an existing contract, which is a different dispute from a bid protest and shares no identifiers with `list_protests()`. All ten of the API's filters are explicit named parameters.
+
+  Three behaviors are documented on the methods and the model, because each is otherwise a support question. **`decision_text` needs an Enterprise plan, and below that tier the key is absent rather than null** — read it with `.get()`. **Searching that text is free at every plan**: `search=` matches inside the decision body and returns no fragment of it, so buying the body does not change what you can find. And **`docket` accepts a docket as it is cited** — a leading `CBCA` / `ASBCA` and `No.` / `Nos.` are ignored, while commas stay part of a docket (`7092-C(6682, 6765, 6767)`) rather than separating two.
+
+  Neither default shape names `decision_text`: the body runs to roughly 100K characters, so putting it in a default would make every fetch ask for something most callers cannot read. `ordering="rank"` requires a non-empty `search`, matching the API.
+- **`alerts.contract_appeal.match` is an alertable event type.** `create_webhook_alert(query_type="contract_appeal", ...)` works. That method's `query_type` docstring now names the full current set and points at `list_webhook_event_types()` as the authority, since a list written into a docstring can only go stale.
+
+### Fixed
+- **`attachments(doc_role, doc_role_alt)` on opportunities and notices no longer raises `ShapeValidationError`.** The Tango API serves both fields on a Pro plan or above, but the SDK rejected them client-side after the request had already been made. `doc_role` says what an attachment is for (`requirement`, `instructions`, `pricing`, `terms`, `reference` or `unknown`) and `doc_role_alt` is a runner-up role that is usually null. Both must be named in the shape, since `attachments(*)` does not include them, and an attachment that has not been classified omits both keys, so read them with `.get()`.
+- **The shape overlay generator no longer lets one resource's view of a model hide fields from another's.** An opportunity is reachable both from `list_opportunities()` and as the `opportunity` expand on vehicles, and the vehicles embed exposes fewer attachment fields. Whichever tree was generated last replaced the other, so the opportunity schema lost fields its own endpoint serves. The generator now adds the missing fields instead of replacing the schema, and keeps every existing field's type as it was.
+- **SLED solicitations accept `delisted_at` and `meta(jurisdiction_declared)`.** Both were rejected client-side even though the API returns them. `delisted_at` is when a portal dropped a solicitation from its listing before its deadline, which is what `status_reason="delisted"` means. `meta.jurisdiction_declared` says whether the source stated the jurisdiction level itself or Tango classified it from the issuer's name. `delisted_at` is now in both `SLED_OPPORTUNITIES_MINIMAL` and `SLED_OPPORTUNITIES_COMPREHENSIVE`, matching the API's own list default.
+
+### Changed
+- **SLED response values now carry the types the API returns.** The SDK's SLED schema had guessed several types from field names. `posted_date`, `response_deadline`, `response_deadline_original` and `bid_opening_date` on `SledOpportunity` now parse to timezone-aware `datetime` values (before, `posted_date` and `bid_opening_date` were truncated to a `date` and the two deadlines stayed strings), as does `estimated_advertisement_date` on `SledForecast`. `estimated_value(min, max)` on forecasts now parses to `Decimal`. `category_codes` is typed as a list of `{scheme, code}` objects, `attachments` and `revisions` as lists, `meta(last_change_source_declared)` and `revisions(source_declared)` as booleans, and `attachments(size_bytes, pages)` and `revisions(sequence)` as integers. If you compared any of the date fields as strings, compare them as `datetime` values instead.
+- Re-vendored `contracts/filter_shape_contract.json` (Tango API 5.1.0) and regenerated `tango/shapes/generated_overlay.py`. The one resource the SDK does not wrap yet, `ebuy/requests`, is recorded in `contracts/shape_coverage_baseline.json` as a known gap.
+- The `ContractAppeal` shape schema is hand-curated in `tango/shapes/explicit_schemas.py` rather than left to the generated overlay. The generator falls back to name heuristics for a resource the live-API type probe has not sampled yet, and those heuristics get four of this resource's fields wrong: `docket_numbers` is a list, `listed` and `decision_date_repaired` are booleans, and `listing_year` is an integer.
+
+### Documentation
+- `list_protests()` and `docs/API_REFERENCE.md` now describe all three protest venues: GAO, the U.S. Court of Federal Claims (COFC) and the SBA Office of Hearings and Appeals (SBA OHA). `naics_code` is documented as the NAICS code at issue in an SBA OHA size or NAICS appeal, which GAO and COFC protests never carry, rather than the solicitation's code. `case_number` examples now cover each venue's format, and `naics_code` is listed among the filter parameters.
+- `docs/API_REFERENCE.md` documents the document-role fields on opportunity and notice attachments, and `delisted_at` and `meta.jurisdiction_declared` on SLED solicitations.
+- New **Contract Appeals** section in `docs/API_REFERENCE.md`, leading with what separates an appeal from a protest, plus the two new `ShapeConfig` constants in the shapes table.
+- Added `alerts.contract_appeal.match` to the event-type listing in `docs/WEBHOOKS.md`.
+
 ## [1.6.0] - 2026-09-10
 
 ### Added

{tango_python-1.6.0 → tango_python-1.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tango-python
-Version: 1.6.0
+Version: 1.8.0
 Summary: Python SDK for the Tango API
 Project-URL: Homepage, https://github.com/makegov/tango-python
 Project-URL: Documentation, https://docs.makegov.com/tango-python

{tango_python-1.6.0 → tango_python-1.8.0}/docs/API_REFERENCE.md

@@ -22,6 +22,8 @@ Complete reference for all Tango Python SDK methods and functionality.
 - [Grants](#grants)
 - [GSA eLibrary Contracts](#gsa-elibrary-contracts)
 - [Protests](#protests)
+- [Contract Appeals](#contract-appeals)
+- [Federal Register](#federal-register)
 - [Budget](#budget)
 - [Business Types](#business-types)
 - [NAICS](#naics)
@@ -925,6 +927,25 @@ for opp in opportunities.results:
 - `naics_code` - Industry code
 - `psc_code` - Product/service code
 
+**Document roles — `attachments(doc_role, doc_role_alt)`:**
+
+On a **Pro plan or above**, each attachment can say what the document is for.
+`doc_role` is one of `requirement`, `instructions`, `pricing`, `terms`, `reference` or `unknown`; `doc_role_alt` is a runner-up role, and is null on nearly every attachment.
+
+```python
+opp = client.get_opportunity(
+    opportunity_id,
+    shape="opportunity_id,title,attachments(name,url,doc_role,doc_role_alt)",
+)
+for attachment in opp["attachments"]:
+    print(attachment["name"], attachment.get("doc_role"))
+```
+
+- **You have to name them.** `attachments(*)` does not include either field, and no default shape does.
+- **The keys are absent, not null**, on an attachment Tango has not classified. Use `attachment.get("doc_role")`.
+- A Free-plan request that names them gets the response without them, plus an entry in `meta.upgrade_hints`.
+- There is no filter on document role.
+
 ---
 
 ## Notices
@@ -1143,7 +1164,7 @@ contract = client.get_gsa_elibrary_contract("UUID_HERE")
 
 ## Protests
 
-Bid protest records (GAO, COFC, etc.).
+Bid protest records from three venues: GAO, the U.S. Court of Federal Claims (COFC), and the SBA Office of Hearings and Appeals (SBA OHA).
 
 ### list_protests()
 
@@ -1166,20 +1187,22 @@ protests = client.list_protests(
     filed_date_before=None,
     decision_date_after=None,
     decision_date_before=None,
+    naics_code=None,
     search=None,
 )
 ```
 
 **Filter Parameters:**
-- `source_system` - Filter by source system (e.g., `"gao"`)
+- `source_system` - Filter by source system: `"gao"`, `"cofc"`, or `"sba_oha"`
 - `outcome` - Filter by outcome (e.g., `"Denied"`, `"Dismissed"`, `"Withdrawn"`, `"Sustained"`)
 - `case_type` - Filter by case type
 - `agency` - Filter by protested agency
-- `case_number` - Filter by case number (e.g., `"b-423274"`)
+- `case_number` - Filter by base case number, matched case-insensitively (e.g., `"b-423274"` for GAO, `"26-1391"` for COFC, `"SIZ-6100"` for SBA OHA)
 - `solicitation_number` - Filter by solicitation number
 - `protester` - Search by protester name
 - `filed_date_after` / `filed_date_before` - Filed date range
 - `decision_date_after` / `decision_date_before` - Decision date range
+- `naics_code` - The NAICS code at issue in an SBA OHA size or NAICS appeal (e.g., `"541519"`). GAO and COFC protests carry no NAICS code, so this filter returns SBA OHA records only
 - `search` - Full-text search
 
 **Returns:** [PaginatedResponse](#paginatedresponse) with protest dictionaries
@@ -1214,6 +1237,172 @@ protest = client.get_protest(
 
 ---
 
+## Contract Appeals
+
+Contract Disputes Act appeal decisions from the Civilian Board of Contract Appeals (CBCA) and the Armed Services Board of Contract Appeals (ASBCA).
+
+**These are not bid protests.** A protest challenges an award or a solicitation before performance; an appeal here challenges a contracting officer's final decision under an existing contract — a claim, a termination, a differing-site-conditions dispute. Protests live at [Protests](#protests) and share no identifiers with this resource.
+
+One row is one decision as the board's own listing publishes it, so several fields describe the listing rather than the dispute. `listed` goes false once the board's newest listing stops carrying the decision; the row is kept, never dropped.
+
+### list_contract_appeals()
+
+List appeal decisions with filtering and shaping.
+
+```python
+appeals = client.list_contract_appeals(
+    page=1,
+    limit=25,
+    shape=ShapeConfig.CONTRACT_APPEALS_MINIMAL,
+    # Filter parameters (all optional)
+    board=None,
+    docket=None,
+    appellant=None,
+    judge=None,
+    decision_type=None,
+    decision_date_after=None,
+    decision_date_before=None,
+    listed=None,
+    document_id=None,
+    search=None,
+    ordering=None,
+)
+```
+
+**Filter Parameters:**
+- `board` - `"cbca"` or `"asbca"`; OR both with `"cbca|asbca"`
+- `docket` - Exact docket match, e.g. `"3288-R"`, `"59116"` or `"7092-C(6682, 6765, 6767)"`. A leading `CBCA` / `ASBCA` and `No.` / `Nos.` are ignored, so a docket can be pasted as it is cited. Commas are part of a docket, never a separator; OR several with `|`
+- `appellant` - Case-insensitive substring match on the appellant's name (min 2 characters)
+- `judge` - Case-insensitive exact match on the judge as the listing names them
+- `decision_type` - CBCA only: `"Decision"`, `"Dismissal"`, `"Order"`, `"Full Board Order"`, or the listing's own text. ASBCA rows carry no type
+- `decision_date_after` / `decision_date_before` - Decision date range (`YYYY-MM-DD`)
+- `listed` - Whether the board's newest listing still carries the decision
+- `document_id` - The board's own document id
+- `search` - Ranked full-text search over the appellant and the full decision text (min 2 characters); wrap in double quotes for a phrase
+- `ordering` - `decision_date` (the default, as `-decision_date`), `appellant`, `first_listed_at` or `rank`. `rank` requires a non-empty `search`
+
+**Returns:** [PaginatedResponse](#paginatedresponse) with appeal-decision dictionaries
+
+**Example:**
+```python
+appeals = client.list_contract_appeals(
+    board="asbca",
+    search="differing site conditions",
+    decision_date_after="2025-01-01",
+    ordering="rank",
+    limit=25,
+)
+
+for appeal in appeals.results:
+    dockets = ", ".join(appeal["docket_numbers"])
+    print(f"{appeal['board'].upper()} {dockets}: {appeal['appellant']} ({appeal['decision_date']})")
+```
+
+### get_contract_appeal()
+
+Get a single decision by `uuid`.
+
+```python
+appeal = client.get_contract_appeal(
+    "DECISION_UUID",
+    shape=ShapeConfig.CONTRACT_APPEALS_COMPREHENSIVE,
+)
+```
+
+**Notes:**
+- `docket_numbers` is a list — the dockets with the board prefix stripped (`3288-R`, `59116`), and a consolidated appeal carries several. `docket_raw` keeps the listing's own text, and `docket_source` says where the dockets came from.
+- **Reading `decision_text` requires an Enterprise plan, and below that tier the key is absent rather than null** — read it with `.get()`, not `[...]`. Neither default shape names it: the body runs to roughly 100K characters, so asking for it on every row is rarely what you want.
+- **Searching that text is free at every plan.** `search=` matches inside the decision body and returns no fragment of it, so buying the body does not change what you can find.
+
+---
+
+## Federal Register
+
+Federal Register documents — rules, proposed rules, notices and presidential documents published since 1994.
+
+A document is identified by `uuid`. `document_number` is not unique on its own: the Federal Register reused some numbers before 2016, so `document_number=` can return more than one document.
+
+### list_federal_register_documents()
+
+List documents with filtering and shaping.
+
+```python
+documents = client.list_federal_register_documents(
+    page=1,
+    limit=25,
+    shape=ShapeConfig.FEDERAL_REGISTER_MINIMAL,
+    # Filter parameters (all optional)
+    search=None,
+    document_number=None,
+    type=None,
+    agency=None,
+    fr_agency=None,
+    publication_date_after=None,
+    publication_date_before=None,
+    effective_on_after=None,
+    effective_on_before=None,
+    comments_close_on_after=None,
+    comments_close_on_before=None,
+    comments_open=None,
+    cfr_title=None,
+    cfr_part=None,
+    significant=None,
+    rin=None,
+    executive_order_number=None,
+    ordering=None,
+)
+```
+
+**Filter Parameters:**
+- `search` - Ranked full-text search over the title, abstract and action; wrap in double quotes for a phrase
+- `document_number` - Exact FR document number, e.g. `"2016-31922"`; OR several with `|`
+- `type` - `"Notice"`, `"Rule"`, `"Proposed Rule"`, `"Presidential Document"`, `"Correction"`, `"Sunshine Act Document"` or `"Uncategorized Document"` (case-insensitive); OR several with `|`. An unknown type is an error, not an empty page. Documents published before 2008 are mostly `Uncategorized Document`, so a type filter undercounts that era
+- `agency` - A Tango agency name, abbreviation, code or organization key, e.g. `"EPA"`. Matches a document when any agency it lists falls within that organization, so a department includes its sub-agencies; OR several with `|`
+- `fr_agency` - The Federal Register's own agency slug, e.g. `"environmental-protection-agency"`; OR several with `|`
+- `publication_date_after` / `publication_date_before` - Publication date range (`YYYY-MM-DD`)
+- `effective_on_after` / `effective_on_before` - Effective date range (`YYYY-MM-DD`)
+- `comments_close_on_after` / `comments_close_on_before` - Comment-deadline range (`YYYY-MM-DD`)
+- `comments_open` - `True` for documents whose comment period closes today or later, `False` for those already closed; documents with no comment deadline match neither
+- `cfr_title` - A CFR title number, e.g. `"40"`
+- `cfr_part` - A CFR part number, e.g. `"52"`. Requires `cfr_title`, and both must match the same CFR reference, so `cfr_title="40", cfr_part="52"` finds 40 CFR 52
+- `significant` - Significant under Executive Order 12866
+- `rin` - A Regulation Identifier Number, e.g. `"2060-AV16"`; OR several with `|`
+- `executive_order_number` - Exact executive order number
+- `ordering` - `publication_date` (the default, as `-publication_date`), `effective_on`, `comments_close_on`, `document_number` or `rank`. `rank` requires a non-empty `search`
+
+**Returns:** [PaginatedResponse](#paginatedresponse) with document dictionaries
+
+**Example:**
+```python
+documents = client.list_federal_register_documents(
+    type="Proposed Rule",
+    comments_open=True,
+    agency="EPA",
+    limit=25,
+)
+
+for doc in documents.results:
+    print(f"{doc['document_number']} ({doc['publication_date']}): {doc['title']}")
+    print(f"  comments close {doc['comments_close_on']}")
+```
+
+### get_federal_register_document()
+
+Get a single document by `uuid`. To look one up by its document number, use `list_federal_register_documents(document_number=...)`.
+
+```python
+document = client.get_federal_register_document(
+    "DOCUMENT_UUID",
+    shape=ShapeConfig.FEDERAL_REGISTER_COMPREHENSIVE,
+)
+```
+
+**Notes:**
+- `agencies`, `cfr_references`, `dockets` and `topics` are the Federal Register's own structures, served as published. `agencies` carries Federal Register agency slugs, not Tango organization keys.
+- `full_text`, the document's plain text, is available on this method only and only when named in `shape` (e.g. `shape="uuid,title,full_text"`). It can run to several MB, so neither default shape includes it.
+
+---
+
 ## State & Local (SLED)
 
 State, local and education procurement — solicitations that never appear on SAM.gov because they were never federal. **Beta**: coverage is partial and grows one jurisdiction at a time.
@@ -1323,6 +1512,8 @@ row = client.get_sled_opportunity(
 - `meta.attachment_count` can be **lower** than `len(row["attachments"])`. Some portals auto-generate a cover sheet alongside the real documents; it is listed and flagged `is_generated_summary`, but excluded from the count and from `has_documents`. The count answers "does this hold its solicitation package"; the array answers "what files exist".
 - `size_bytes` and `char_count` only mean something as a pair — 3 MB that yielded no characters is a scan awaiting OCR.
 - `raw(*)` needs a Small plan or above, and is explicitly unstable: its shape varies by portal platform.
+- `delisted_at` is when a portal dropped the solicitation from its listing before its deadline, and is what `status_reason="delisted"` means. It is null when the solicitation was never delisted or has been seen again since.
+- `meta.jurisdiction_declared` says whether the source stated the jurisdiction level itself. `False` means Tango classified it from the issuer's name, which is the common case on a state's central portal.
 
 **Reading a document body — `attachments(extracted_text)`:**
 
@@ -2206,12 +2397,16 @@ entity = client.get_entity("UEI_KEY", shape=ShapeConfig.ENTITIES_COMPREHENSIVE)
 | `SUBAWARDS_MINIMAL` | `list_subawards` | award_key, prime_recipient(uei,display_name), subaward_recipient(uei,display_name) |
 | `GSA_ELIBRARY_CONTRACTS_MINIMAL` | `list_gsa_elibrary_contracts` | uuid, contract_number, schedule, recipient(display_name,uei), idv(key,award_date) |
 | `PROTESTS_MINIMAL` | `list_protests` | case_id, case_number, title, source_system, outcome, filed_date |
+| `CONTRACT_APPEALS_MINIMAL` | `list_contract_appeals` | uuid, board, docket_numbers, decision_date, appellant, judge, decision_type, url |
+| `CONTRACT_APPEALS_COMPREHENSIVE` | `get_contract_appeal` | The list fields plus docket_raw, docket_source, decision_date_repaired, decision_type_raw, listing_year, first_listed_at, listed, text_status, text_char_count (omits `decision_text`, which needs an Enterprise plan) |
+| `FEDERAL_REGISTER_MINIMAL` | `list_federal_register_documents` | uuid, document_number, publication_date, type, subtype, title, abstract, action, agencies, cfr_references, citation, significant, comments_close_on, effective_on, html_url, pdf_url |
+| `FEDERAL_REGISTER_COMPREHENSIVE` | `get_federal_register_document` | The list fields plus dates, signing_date, start_page, end_page, volume, docket_ids, dockets, regulation_id_numbers, topics, correction_of, corrections, executive_order_number, presidential_document_number, proclamation_number, comment_url, regulations_dot_gov_url, raw_text_url, body_html_url (omits `full_text`) |
 | `BUDGET_ACCOUNTS_MINIMAL` | `list_budget_accounts`, `get_budget_account` | id, federal_account_symbol, fiscal_year, agency_code/name, bureau_name, account_title, bea_category, on_off_budget, subfunction_code, lifecycle (requested/enacted/apportioned/obligated/outlayed/unobligated), contract & assistance rollups, key ratios, next-year growth |
 | `VEHICLE_ORDERS_MINIMAL` | `list_vehicle_orders` | key, piid, award_date, recipient(display_name,uei), total_contract_value, obligated |
 | `ITDASHBOARD_INVESTMENTS_MINIMAL` | `list_itdashboard_investments` | Minimal IT Dashboard investment fields |
 | `ITDASHBOARD_INVESTMENTS_COMPREHENSIVE` | `get_itdashboard_investment` | Full investment fields: uii, agency_code, agency_name, bureau_code, bureau_name, investment_title, type_of_investment, part_of_it_portfolio, updated_time, url |
-| `SLED_OPPORTUNITIES_MINIMAL` | `list_sled_opportunities` | opportunity_id, solicitation_number, solicitation_type, title, state, jurisdiction, agency, status, status_reason, posted_date, response_deadline, source_url, has_documents, first_seen_at, last_change_seen_at (no `description` — detail-only on the API) |
-| `SLED_OPPORTUNITIES_COMPREHENSIVE` | `get_sled_opportunity` | Full solicitation with description, the raw portal status, both deadlines, bid opening, category codes, and organization / contact / meta / attachments / revisions |
+| `SLED_OPPORTUNITIES_MINIMAL` | `list_sled_opportunities` | opportunity_id, solicitation_number, solicitation_type, title, state, jurisdiction, agency, status, status_reason, delisted_at, posted_date, response_deadline, source_url, has_documents, first_seen_at, last_change_seen_at (no `description` — detail-only on the API) |
+| `SLED_OPPORTUNITIES_COMPREHENSIVE` | `get_sled_opportunity` | Full solicitation with description, the raw portal status, the delisting timestamp, both deadlines, bid opening, category codes, and organization / contact / meta / attachments / revisions |
 | `SLED_REVISIONS_MINIMAL` | `list_sled_opportunity_revisions` | observed_at, sequence, kind, changed_fields, source_declared (omits `changes`, which needs a Small plan) |
 | `SLED_FORECASTS_MINIMAL` | `list_sled_forecasts` | forecast_id, state, agency, title, estimated_advertisement_date, estimated_advertisement_raw, procurement_category, procurement_method, contract_number, incumbent_name, source_url, estimated_value(*) |
 | `SLED_FORECASTS_COMPREHENSIVE` | `get_sled_forecast` | Full forecast with description, contract_term, mbe_dbe_goal, delivery_location, and organization / contact / estimated_value |

{tango_python-1.6.0 → tango_python-1.8.0}/docs/WEBHOOKS.md

@@ -88,6 +88,8 @@ tango webhooks list-event-types
 # alerts.dibbs_rfq.match     DLA DIBBS RFQ matched a saved alert
 # alerts.dibbs_rfp.match     DLA DIBBS RFP matched a saved alert
 # alerts.sled_opportunity.match  State/local/education solicitation matched a saved alert
+# alerts.contract_appeal.match  CBCA/ASBCA appeal decision matched a saved alert
+# alerts.federal_register.match  Federal Register document matched a saved alert
 ```
 
 This list is served by the API, so it is always current — the SDK does not hardcode

{tango_python-1.6.0 → tango_python-1.8.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tango-python"
-version = "1.6.0"
+version = "1.8.0"
 description = "Python SDK for the Tango API"
 readme = "README.md"
 requires-python = ">=3.12"

{tango_python-1.6.0 → tango_python-1.8.0}/scripts/check_filter_shape_conformance.py

@@ -77,6 +77,8 @@ RESOURCE_TO_METHOD: dict[str, str | None] = {
     "sled/opportunities": "list_sled_opportunities",
     "sled/forecasts": "list_sled_forecasts",
     "protests": "list_protests",
+    "contract_appeals": "list_contract_appeals",
+    "federal_register": "list_federal_register_documents",
     "offices": "list_offices",
     "psc": "list_psc",
     "mas_sins": "list_mas_sins",

{tango_python-1.6.0 → tango_python-1.8.0}/scripts/check_shape_coverage.py

@@ -68,6 +68,8 @@ RESOURCE_TO_MODEL: dict[str, str] = {
     "budget/accounts": "BudgetAccount",
     "budget_accounts": "BudgetAccount",
     "protests": "Protest",
+    "contract_appeals": "ContractAppeal",
+    "federal_register": "FederalRegisterDocument",
     "offices": "Office",
     "assistance_listings": "AssistanceListing",
     "business_types": "BusinessType",

{tango_python-1.6.0 → tango_python-1.8.0}/scripts/generate_shape_overlay.py

@@ -174,6 +174,20 @@ overlay: dict[str, dict[str, dict]] = {}
 report_rows: list[str] = []
 
 
+def put(container: str, name: str, e: dict) -> None:
+    """Record an overlay entry, unioning nested schemas when two resources reach the same container.
+
+    A model can be reached from its own resource and as another resource's expand (`opportunities` vs `vehicles.opportunity`), and those trees can expose different sub-fields.
+    Overwriting let a narrower embed hide fields the resource itself serves; the union only adds the missing ones, and the later entry still decides every field both trees define, so no existing type moves.
+    """
+    cur = overlay.setdefault(container, {}).get(name)
+    nested = {cur.get("nested") if cur else None, e.get("nested")}
+    if cur and None not in nested and "CodeDescription" not in nested and len(nested) == 2:
+        merged = {**nested_schemas[cur["nested"]], **nested_schemas[e["nested"]]}
+        e = {**e, "nested": intern_nested(re.sub(r"\d+$", "", e["nested"]), merged)}
+    overlay[container][name] = e
+
+
 def walk(res: str, path: str, node: dict, schema, container: str) -> None:
     if schema is None:
         return
@@ -182,7 +196,7 @@ def walk(res: str, path: str, node: dict, schema, container: str) -> None:
         for f in fields:
             if f != "*" and f not in schema:
                 t, lst = resolve_scalar(res, path, f)
-                overlay.setdefault(container, {})[f] = entry(t, True, lst)
+                put(container, f, entry(t, True, lst))
                 report_rows.append(f"{res}:{path or '(root)'}.{f}  ->  {t}{'[]' if lst else ''}")
     for ename, enode in (node.get("expands") or {}).items():
         fs = schema.get(ename)
@@ -192,7 +206,7 @@ def walk(res: str, path: str, node: dict, schema, container: str) -> None:
         if fs is None or child_schema is None:
             if is_wildcard(enode) and fs is not None:
                 continue
-            overlay.setdefault(container, {})[ename] = expand_entry(res, path, ename, enode)
+            put(container, ename, expand_entry(res, path, ename, enode))
             report_rows.append(f"{res}:{path or '(root)'}.{ename}  ->  expand")
         else:
             walk(res, child_path, enode, child_schema, container=nested_name)
@@ -214,7 +228,8 @@ for rkey, r in contract["resources"].items():
         for cname, cnode in (shape.get("expands") or {}).items():
             s[cname] = expand_entry(rkey, "", cname, cnode)
         if model_name:
-            overlay[model_name] = {**overlay.get(model_name, {}), **s}
+            for name, e in s.items():
+                put(model_name, name, e)
         continue
     walk(rkey, "", shape, schema, container=model_name)
 

{tango_python-1.6.0 → tango_python-1.8.0}/tango/__init__.py

@@ -10,10 +10,12 @@ from .exceptions import (
 )
 from .models import (
     BudgetAccount,
+    ContractAppeal,
     DibbsAward,
     DibbsRfp,
     DibbsRfq,
     Exclusion,
+    FederalRegisterDocument,
     GsaElibraryContract,
     ITDashboardInvestment,
     PaginatedResponse,
@@ -53,7 +55,7 @@ from .webhooks import (
 )
 from .webhooks.receiver import Delivery, WebhookReceiver
 
-__version__ = "1.6.0"
+__version__ = "1.8.0"
 __all__ = [
     "TangoClient",
     "TangoAPIError",
@@ -65,6 +67,8 @@ __all__ = [
     "ResolveCandidate",
     "ResolveResult",
     "BudgetAccount",
+    "ContractAppeal",
+    "FederalRegisterDocument",
     "DibbsAward",
     "DibbsRfp",
     "DibbsRfq",