tango-python 1.5.1__tar.gz → 1.7.0__tar.gz

{tango_python-1.5.1 → tango_python-1.7.0}/CHANGELOG.md

@@ -7,6 +7,51 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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
+- **`attachments(extracted_text)` — SLED document bodies on the Small plan and above** (Tango API 4.25.1). Re-vendored the contract and regenerated the shape overlay, so `shape="...,attachments(name,extracted_text)"` now validates instead of being rejected client-side. Three properties are documented on the model and in `docs/API_REFERENCE.md`, because each is otherwise a support question: the leaf must be **named** (neither `SLED_OPPORTUNITIES_MINIMAL` nor `SLED_OPPORTUNITIES_COMPREHENSIVE` includes it, and `attachments(*)` does not carry it, because the API only resolves the body for a caller who asked); the **key is absent rather than null** when the text is not being served, so read it with `.get()`; and a **contested document never returns text at any plan**. Searching document text stays ungated on every plan and returns no fragment of it — buying the body does not change search.
+- **State, local and education (SLED) procurement** (Tango API 4.25.0). Six methods over the new `/api/sled/` namespace: `list_sled_opportunities()`, `get_sled_opportunity()`, `list_sled_opportunity_revisions()`, `get_sled_coverage()`, `list_sled_forecasts()`, `get_sled_forecast()`, plus `SledOpportunity` / `SledOpportunityRevision` / `SledForecast` schemas and five `ShapeConfig` defaults. Every one of the API's 27 solicitation filters and 13 forecast filters is an explicit named parameter.
+
+  Four behaviors are documented on the methods themselves because each misleads a caller who assumes federal semantics. **Passing neither `status` nor `active` returns open solicitations only** — that default is the API's, and the SDK deliberately does not synthesize a `status` param, since doing so would make `active=False` unreachable (pinned by a test). **`status` is Tango-derived and refreshed every fifteen minutes**; the portal's own word is served as `source_status`, is frozen at last capture, and is not a liveness filter. **Category scheme tagging is mid-migration**, so `naics=` matches only the small tagged share and `category_code=` is the escape hatch. And **`meta.attachment_count` can be lower than `len(attachments)`**, because an auto-generated portal cover sheet is listed and flagged `is_generated_summary` but excluded from the count.
+
+  `SLED_REVISIONS_MINIMAL` omits `changes` on purpose: the per-field before/after needs a Small plan, so naming it by default would 403 a Free caller. `changed_fields` is in the default and available at every plan.
+- **`previous_uii` on `list_itdashboard_investments()`.** The Tango API has accepted this filter for a while — it resolves a retired UII forward to whatever superseded it — and the SDK never picked it up, so it was a silent no-op for anyone who passed it through. Ungated, unlike its analytical neighbours on that endpoint. Found by the SDK's own filter-conformance check, not by SLED work.
+
+### Changed
+- Re-vendored `contracts/filter_shape_contract.json` (schema_version 2, 48 resources) and regenerated `tango/shapes/generated_overlay.py` from it — 535 fields across 33 containers, 84 nested schemas. Besides the SLED expands this closes three entity gaps the older contract could not see: `relationships(confidence, verification_method)` and the whole `workforce(*)` expand were reachable on the API and rejected client-side by the SDK's schema.
+- Baselined 14 reverse-shape-coverage gaps in `contracts/shape_coverage_baseline.json`. All 14 are nested sub-resource routes the newer contract publishes for the first time (`entities_contracts`, `idvs_awards`, `vehicles_orders`, and similar); none is SLED, and none is a regression — they are pre-existing SDK gaps that only became visible with the re-vendored contract. The gate reports 0 new drift.
+
+### Documentation
+- New **State & Local (SLED)** section in `docs/API_REFERENCE.md` covering all six methods, both defaults that surprise people, and the five new `ShapeConfig` constants.
+- Corrected `docs/WEBHOOKS.md`. It stated flatly that "nothing fires when a record merely lapses"; that is now false for exactly one query type. `alerts.sled_opportunity.match` **does** fire on a closing, because SLED liveness is a stored column a fifteen-minute sweep writes rather than a query-time derivation. Also documented that there is no `sled_forecast` query type and that SLED revisions and attachments are not separately alertable.
+
 ## [1.5.1] - 2026-08-10
 
 ### Documentation

{tango_python-1.5.1 → tango_python-1.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: tango-python
-Version: 1.5.1
+Version: 1.7.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.5.1 → tango_python-1.7.0}/docs/API_REFERENCE.md

@@ -18,9 +18,11 @@ Complete reference for all Tango Python SDK methods and functionality.
 - [Forecasts](#forecasts)
 - [Opportunities](#opportunities)
 - [Notices](#notices)
+- [State \& Local (SLED)](#state--local-sled)
 - [Grants](#grants)
 - [GSA eLibrary Contracts](#gsa-elibrary-contracts)
 - [Protests](#protests)
+- [Contract Appeals](#contract-appeals)
 - [Budget](#budget)
 - [Business Types](#business-types)
 - [NAICS](#naics)
@@ -924,6 +926,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
@@ -1142,7 +1163,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()
 
@@ -1165,20 +1186,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
@@ -1213,6 +1236,284 @@ 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.
+
+---
+
+## 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.
+
+This data does not join to the federal data. There is no UEI, no PIID, no agency-hierarchy key and no NAICS/PSC crosswalk; `organization(*)` here is three strings, not the federal 7-key office payload.
+
+### list_sled_opportunities()
+
+List SLED solicitations with filtering and shaping.
+
+```python
+solicitations = client.list_sled_opportunities(
+    page=1,
+    limit=25,
+    shape=ShapeConfig.SLED_OPPORTUNITIES_MINIMAL,
+    # Filter parameters (all optional)
+    state=None,
+    jurisdiction=None,
+    status=None,
+    active=None,
+    agency=None,
+    solicitation_number=None,
+    solicitation_type=None,
+    has_documents=None,
+    revision_kind=None,
+    naics=None,
+    nigp=None,
+    unspsc=None,
+    category=None,
+    category_code=None,
+    posted_after=None,
+    posted_before=None,
+    response_deadline_after=None,
+    response_deadline_before=None,
+    first_seen_after=None,
+    first_seen_before=None,
+    change_seen_after=None,
+    modified_after=None,
+    modified_before=None,
+    search=None,
+    ordering=None,
+)
+```
+
+**Two defaults worth knowing before your first call:**
+
+- **Passing neither `status` nor `active` returns open solicitations only.** Only about a fifth of the corpus is open, and a portal drops a closed solicitation rather than restating it, so the API defaults the list to `status=open`. Pass an explicit `status` to page the whole corpus. `status="unknown"` (standing rosters, dateless RFIs) is hidden by that default — reach it with `status="open|unknown"`. `get_sled_opportunity()` returns the solicitation whatever its status.
+- **`status` is Tango's answer, not the portal's.** It is derived from the portal's word, the deadline and the clock, and refreshed every fifteen minutes. The portal's own word is served as `source_status` and is frozen at last capture — most of what it calls open already has a passed deadline. Never filter liveness on it.
+
+**Filter Parameters:**
+- `state` - Two-letter state or territory code. Multi-value: `"TX|OK"`
+- `jurisdiction` - `"state"`, `"local"`, `"education"`, or `"unknown"` for aggregator rows that cannot tell state from local
+- `status` - `"open"`, `"closed"`, `"awarded"`, `"cancelled"`, `"unknown"`
+- `active` - Sugar for federal-shaped callers: `True` is `status="open"`; `False` is its complement, so it includes `unknown`
+- `agency` - Substring match on the buyer's published text (min 2 characters); no code resolution behind it
+- `solicitation_number` - The number a human would quote; null on roughly a third of the corpus
+- `solicitation_type` - `"rfp"`, `"ifb"`, `"rfq"`, `"rfi"`, `"itb"`, `"sole_source"`, `"grant"`, `"other"`. `"null"` (portal states no type) is a distinct answer from `"other"`
+- `has_documents` - Whether the solicitation advertises at least one document
+- `revision_kind` - Kind of the most recent substantive revision
+- `naics` / `nigp` / `unspsc` / `category` - Exact match within one category scheme. **`naics` is thin on purpose**: scheme tagging is mid-migration, so only a small share of entries are tagged NAICS
+- `category_code` - Match a code under ANY scheme, including the untagged pre-migration strings. The escape hatch when a scheme-specific filter returns less than expected
+- `posted_after` / `posted_before` - Posted-date range
+- `response_deadline_after` / `response_deadline_before` - Deadline range
+- `first_seen_after` / `first_seen_before` - When Tango first observed it. The polling primitive
+- `change_seen_after` - When Tango *observed* the last substantive change. A scrape date, not an amendment date
+- `modified_after` / `modified_before` - When the Tango row last changed
+- `platform` / `native_id` / `external_id` - Support filters for reproducing a record with us. Not in any response shape and not stable values
+- `search` - Ranked full-text search over title, agency, identifiers, category labels and description, widened by the solicitations whose *attachment text* matched (min 2 characters)
+- `ordering` - `rank`, `response_deadline`, `posted_date`, `first_seen_at`, `last_seen_at`, `last_change_seen_at`, `modified`. `rank` requires a non-empty `search`
+
+**Returns:** [PaginatedResponse](#paginatedresponse) with solicitation dictionaries
+
+**Example:**
+```python
+# Open Texas solicitations closing this month, newest first
+page = client.list_sled_opportunities(
+    state="TX",
+    response_deadline_before="2026-10-01",
+    ordering="response_deadline",
+    limit=25,
+)
+
+for row in page.results:
+    print(f"{row['state']} {row.get('solicitation_number') or '—'}: {row['title']}")
+
+# Full-text search puts the matching passage on each row that matched on its body
+hits = client.list_sled_opportunities(
+    search="environmental mitigation",
+    shape="opportunity_id,title,state,snippet,response_deadline",
+)
+```
+
+`snippet` is present only under `search=`, and only on rows that matched on their description — a title-or-agency match honestly carries none. Attachment matching contributes ids only: a caller learns *that* a document matched, never what it said.
+
+### get_sled_opportunity()
+
+Get a single solicitation by `opportunity_id`, whatever its status.
+
+```python
+row = client.get_sled_opportunity(
+    "OPPORTUNITY_UUID",
+    shape="opportunity_id,title,status,attachments(*),revisions(*)",
+)
+```
+
+**Notes:**
+- `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)`:**
+
+```python
+row = client.get_sled_opportunity(
+    opportunity_id,
+    shape="opportunity_id,attachments(name,size_bytes,extracted_text)",
+)
+```
+
+Needs a **Small plan or above**, and Tango API 4.25.1 or later (`client.get_version()` reports what you are calling). Three rules:
+
+- **You have to name it.** `attachments(*)` does not carry the body, and neither default shape names it — the API only resolves it for a caller who asked, so a default would make every detail fetch pay for a document nobody wanted to read.
+- **The key is absent, not null**, whenever the text is not being served to you: below Small (where it is withheld and named in `meta.upgrade_hints`), on a contested document, or where the text cannot be resolved. Use `attachment.get("extracted_text")`.
+- **A contested document never returns text**, at any plan — its stored bytes disagree with what the record advertised, so its text is not reliably that record's.
+
+Searching document text and reading it are separate things. `search=` matches inside attachment text on **every plan** and returns no fragment of it; `extracted_text` is a per-record read on Small and above. Buying the body does not change search.
+
+### list_sled_opportunity_revisions()
+
+List one solicitation's observed revision history.
+
+```python
+revisions = client.list_sled_opportunity_revisions(
+    "OPPORTUNITY_UUID",
+    kind=None,
+    source_declared=None,
+    observed_after=None,
+    observed_before=None,
+)
+```
+
+**Notes:**
+- `observed_at` is the scrape that saw the change, not the date the agency made it. No state portal emits amendment notices, so `kind` is Tango's inference from the diff on about 95% of revisions, resolution is that state's crawl cadence, and history starts when Tango began reading the jurisdiction.
+- Unlike the `revisions(*)` expand, this route serves `enrichment` rows — Tango's own detail fetch filling in coverage rather than an agency amendment. Pass `kind="enrichment"` for only those.
+- `changes` (the per-field before and after) needs a Small plan; it is left out of the default shape for that reason. `changed_fields` names what moved at every plan.
+
+### get_sled_coverage()
+
+Get the per-state coverage rollup. Takes no parameters; not shaped or paginated.
+
+```python
+coverage = client.get_sled_coverage()
+print(coverage["totals"])
+for row in coverage["states"]:
+    print(row["state"], row["total_count"], row["by_status"], row["last_change_observed_at"])
+```
+
+**Call this before treating a per-state count as market size.** A thin result for a state is at least as likely to be a portal Tango does not read as a quiet market, and that is the ambiguity this endpoint exists to resolve. Every state row carries all five status buckets whether or not they have rows, so a total and two buckets never invite subtraction.
+
+### list_sled_forecasts()
+
+List planned state procurements.
+
+```python
+forecasts = client.list_sled_forecasts(
+    state=None,
+    agency=None,
+    procurement_category=None,
+    procurement_method=None,
+    contract_number=None,
+    incumbent_name=None,
+    advertisement_after=None,
+    advertisement_before=None,
+    first_seen_after=None,
+    first_seen_before=None,
+    modified_after=None,
+    modified_before=None,
+    search=None,
+    ordering=None,
+)
+```
+
+**Notes:**
+- **Forecasts carry no liveness at all** — no deadline to have passed, so there is no `status` field, no `active` filter, and no open-only default. Currency is the caller's call from `estimated_advertisement_date`.
+- `estimated_advertisement_date` is the **start of the published quarter**, not a posting date. `estimated_advertisement_raw` keeps the portal's own words (`"Q3 (Jan.-March 2027)"`), and a large share of rows publish no quarter at all.
+- `estimated_value(min,max,raw)` is parsed from a free-text award band at serve time. **A band naming one number is a floor, so `max` is `None`** — never read a missing `max` as an unbounded ceiling. `raw` is always there to check the parse against.
+- `incumbent_name` is published text, not a resolved Tango entity.
+- `ordering`: `rank`, `estimated_advertisement_date`, `first_seen_at`, `last_seen_at`, `modified`.
+
+### get_sled_forecast()
+
+```python
+forecast = client.get_sled_forecast("FORECAST_UUID")
+```
+
+---
+
 ## Budget
 
 Federal account × fiscal year budget rollups, covering the full budget lifecycle (requested → enacted → apportioned → obligated → outlayed), pre-computed ratios and trends, the contract / assistance / unlinked breakdown, and request-vs-actual spend.
@@ -2008,10 +2309,17 @@ 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) |
 | `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, 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 |
 
 All predefined shapes are validated at SDK release time (see [Developer Guide](DEVELOPERS.md#sdk-conformance-maintainers)). For custom shapes, see the [Shaping Guide](SHAPES.md).
 

{tango_python-1.5.1 → tango_python-1.7.0}/docs/WEBHOOKS.md

@@ -87,6 +87,8 @@ tango webhooks list-event-types
 # alerts.exclusion.match     SAM.gov exclusion matched a saved alert
 # 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
 ```
 
 This list is served by the API, so it is always current — the SDK does not hardcode
@@ -97,11 +99,20 @@ Two things that surprise people:
 
 - **DIBBS awards are not alertable.** There is no `alerts.dibbs_award.match`;
   only RFQs and RFPs emit alerts.
-- **Nothing fires when a record merely lapses.** An exclusion reaching its
-  termination date, or an RFQ/RFP passing its close date, emits no event.
-  Alerts fire on a record matching your saved search, not on the passage of
-  time. Poll with `list_exclusions(active=...)` / `list_dibbs_rfqs(open=...)`
-  if you need to observe expiry.
+- **Nothing fires when a record merely lapses — except SLED.** An exclusion
+  reaching its termination date, or an RFQ/RFP passing its close date, emits no
+  event: open/closed and in-force are derived at query time, so no stored row
+  changes. Poll with `list_exclusions(active=...)` /
+  `list_dibbs_rfqs(open=...)` if you need to observe expiry.
+
+  `sled_opportunity` is the exception, and the only one. A SLED solicitation's
+  liveness is a stored `status` column that Tango recomputes every fifteen
+  minutes rather than deriving per request, so a deadline passing **is** a write
+  and `alerts.sled_opportunity.match` can follow it. There is no
+  `sled_forecast` query type — a forecast has no deadline, so nothing
+  transitions — and SLED revisions and attachments are not separately
+  alertable: subscribe to `sled_opportunity` and filter on
+  `change_seen_after` or `revision_kind`.
 
 ### 2. See what a payload looks like
 

{tango_python-1.5.1 → tango_python-1.7.0}/pyproject.toml

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

{tango_python-1.5.1 → tango_python-1.7.0}/scripts/check_filter_shape_conformance.py

@@ -74,7 +74,10 @@ RESOURCE_TO_METHOD: dict[str, str | None] = {
     "exclusions": "list_exclusions",
     "sbir/topics": "list_sbir_topics",
     "sbir/solicitations": "list_sbir_solicitations",
+    "sled/opportunities": "list_sled_opportunities",
+    "sled/forecasts": "list_sled_forecasts",
     "protests": "list_protests",
+    "contract_appeals": "list_contract_appeals",
     "offices": "list_offices",
     "psc": "list_psc",
     "mas_sins": "list_mas_sins",

{tango_python-1.5.1 → tango_python-1.7.0}/scripts/check_shape_coverage.py

@@ -68,6 +68,7 @@ RESOURCE_TO_MODEL: dict[str, str] = {
     "budget/accounts": "BudgetAccount",
     "budget_accounts": "BudgetAccount",
     "protests": "Protest",
+    "contract_appeals": "ContractAppeal",
     "offices": "Office",
     "assistance_listings": "AssistanceListing",
     "business_types": "BusinessType",
@@ -79,6 +80,8 @@ RESOURCE_TO_MODEL: dict[str, str] = {
     "exclusions": "Exclusion",
     "sbir/topics": "SbirTopic",
     "sbir/solicitations": "SbirSolicitation",
+    "sled/opportunities": "SledOpportunity",
+    "sled/forecasts": "SledForecast",
     "mas_sins": "MasSin",
     "events": "Event",
     "news": "News",

{tango_python-1.5.1 → tango_python-1.7.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.5.1 → tango_python-1.7.0}/tango/__init__.py

@@ -10,6 +10,7 @@ from .exceptions import (
 )
 from .models import (
     BudgetAccount,
+    ContractAppeal,
     DibbsAward,
     DibbsRfp,
     DibbsRfq,
@@ -24,6 +25,9 @@ from .models import (
     SbirTopic,
     SearchFilters,
     ShapeConfig,
+    SledForecast,
+    SledOpportunity,
+    SledOpportunityRevision,
     ValidateResult,
     Vehicle,
     VehicleMetrics,
@@ -50,7 +54,7 @@ from .webhooks import (
 )
 from .webhooks.receiver import Delivery, WebhookReceiver
 
-__version__ = "1.5.1"
+__version__ = "1.7.0"
 __all__ = [
     "TangoClient",
     "TangoAPIError",
@@ -62,6 +66,7 @@ __all__ = [
     "ResolveCandidate",
     "ResolveResult",
     "BudgetAccount",
+    "ContractAppeal",
     "DibbsAward",
     "DibbsRfp",
     "DibbsRfq",
@@ -73,6 +78,9 @@ __all__ = [
     "PaginatedResponse",
     "SearchFilters",
     "ShapeConfig",
+    "SledForecast",
+    "SledOpportunity",
+    "SledOpportunityRevision",
     "ValidateResult",
     "Vehicle",
     "VehicleMetrics",