From 9e522f62e0b4830ce71b070d2c056bcf7b4135d3 Mon Sep 17 00:00:00 2001 From: bensynapse <118375461+bensynapse@users.noreply.github.com> Date: Tue, 17 Nov 2026 11:39:00 +0200 Subject: [PATCH] Version 0.11.2: the spec at API 1.21.3 The saved spec takes the two changes of the public document from 1.21.2 to 1.21.3, and every local edit is kept. The models are regenerated, 175 as before. The docstring of Subscription.ends_at names the entitled case. The metadata uses PEP 639: license = "MIT" with license-files, and the licence classifier is gone. The build needs hatchling 1.27 or later for that. The Documentation link points at the Python SDK page. --- CHANGELOG.md | 11 +++++++++++ README.md | 2 +- pyproject.toml | 10 +++++----- spec/openapi.yaml | 6 +++--- src/faxforagents/__init__.py | 2 +- src/faxforagents/models.py | 4 ++-- 6 files changed, 23 insertions(+), 12 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index b9da9d3..cb2afb1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,16 @@ # Changelog +## 0.11.2 (2026-11-17) + +Follows API 1.21.3. The saved spec has 165 operations and 175 schemas, as in 0.11.1, and the models are regenerated from it. +No method, argument or field changed. + +- The generated docstring of `Subscription.ends_at` says it is `None` whenever `entitled` is false, as after the plan ended. + The server sent that at 1.21.2 already. +- The package metadata names its licence as `License-Expression: MIT`, from `license = "MIT"` and `license-files` (PEP 639). + The licence classifier is gone, and the build needs hatchling 1.27 or later. +- The Documentation link of the package points at https://faxforagents.com/docs/sdks/python/. + ## 0.11.1 (2026-11-17) Follows API 1.21.2. The saved spec has 165 operations and 175 schemas, as in 0.11.0, and the models are regenerated from it. diff --git a/README.md b/README.md index 6369739..517fd98 100644 --- a/README.md +++ b/README.md @@ -330,7 +330,7 @@ ruff check src tests && mypy src sh scripts/truthcheck.sh ``` -`spec/openapi.yaml` follows the public document at API version 1.21.2. It has the same 165 operations and no schema that document lacks. +`spec/openapi.yaml` follows the public document at API version 1.21.3. It has the same 165 operations and no schema that document lacks. It also declares fields a route returns beyond the public schemas, in `InboxItemSummary` and `ExtractionPage`. 0.5.0 removed the two validation error schemas, because the server never sent that shape. 0.6.0 removed two cost fields of an extraction, because the server stopped sending them. diff --git a/pyproject.toml b/pyproject.toml index 27d9924..6864a90 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,20 +1,20 @@ [build-system] -requires = ["hatchling"] +requires = ["hatchling>=1.27"] build-backend = "hatchling.build" [project] name = "faxforagents" -version = "0.11.1" +version = "0.11.2" description = "Python client for Fax for Agents: a fax API, a hosted MCP server and SDKs built so AI agents can send and receive faxes." readme = "README.md" requires-python = ">=3.10" -license = { text = "MIT" } +license = "MIT" +license-files = ["LICENSE"] authors = [{ name = "Fax for Agents", email = "hello@faxforagents.com" }] keywords = ["fax", "fax-api", "ai-agents", "mcp", "agents", "api-client", "sdk", "webhooks"] classifiers = [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", - "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.10", @@ -49,7 +49,7 @@ faxforagents = "faxforagents.cli:main" [project.urls] Homepage = "https://faxforagents.com" -Documentation = "https://faxforagents.com/docs" +Documentation = "https://faxforagents.com/docs/sdks/python/" Pricing = "https://faxforagents.com/pricing" Dashboard = "https://app.faxforagents.com" Repository = "https://github.com/faxforagents/sdk-python" diff --git a/spec/openapi.yaml b/spec/openapi.yaml index 0928285..2a1ae84 100644 --- a/spec/openapi.yaml +++ b/spec/openapi.yaml @@ -1,4 +1,4 @@ -# Fax for Agents API, refreshed from the public document of https://github.com/faxforagents/openapi at API 1.21.2. +# Fax for Agents API, refreshed from the public document of https://github.com/faxforagents/openapi at API 1.21.3. # An operation reaches every schema here. 0.10.0 dropped 70 earlier schemas that no operation reached. # Existing SDK routes, model names and serializer additions are retained. openapi: 3.1.0 @@ -27,7 +27,7 @@ info: x-logo: url: https://faxforagents.com/brand/logo-512.png altText: Fax for Agents - version: 1.21.2 + version: 1.21.3 servers: - url: https://api.faxforagents.com description: Production (live and test keys) @@ -16246,7 +16246,7 @@ components: title: Ends At description: When the subscription ends without being charged again. That is cancel_at when it comes no later than current_period_end, or current_period_end after a cancel at the period's end. Null while - it renews. + it renews, and whenever entitled is false, as after it ended. current_period_end: anyOf: - type: string diff --git a/src/faxforagents/__init__.py b/src/faxforagents/__init__.py index 62f6ea7..7e5fa2a 100644 --- a/src/faxforagents/__init__.py +++ b/src/faxforagents/__init__.py @@ -18,7 +18,7 @@ from __future__ import annotations -__version__ = "0.11.1" +__version__ = "0.11.2" from faxforagents._http import ORDER_TOKEN_HEADER from faxforagents.async_client import AsyncClient diff --git a/src/faxforagents/models.py b/src/faxforagents/models.py index a0c1a24..82a1023 100644 --- a/src/faxforagents/models.py +++ b/src/faxforagents/models.py @@ -1,6 +1,6 @@ """Typed models of the Fax for Agents API. -GENERATED by scripts/gen_models.py from spec/openapi.yaml (API version 1.21.2). Do not edit by hand. +GENERATED by scripts/gen_models.py from spec/openapi.yaml (API version 1.21.3). Do not edit by hand. Money fields ending in ``_micro`` are integer USD micro-units (39000 is $0.039). Timestamps are ISO 8601 strings in UTC. Response models accept fields the API adds later. Request models refuse unknown fields. """ @@ -1622,7 +1622,7 @@ class Subscription(_Response): stripe_price_id: str | None cancel_at_period_end: bool cancel_at: str | None = Field(None, description="When Stripe is set to end the subscription. A cancel in the billing portal sets it to the end of the period and leaves cancel_at_period_end false.") - ends_at: str | None = Field(None, description="When the subscription ends without being charged again. That is cancel_at when it comes no later than current_period_end, or current_period_end after a cancel at the period's end. Null while it renews.") + ends_at: str | None = Field(None, description="When the subscription ends without being charged again. That is cancel_at when it comes no later than current_period_end, or current_period_end after a cancel at the period's end. Null while it renews, and whenever entitled is false, as after it ended.") current_period_end: str | None entitled: bool created_at: str