What's Changed

Metadata-only release. No code, no test, no protocol changes — wire format and public API are identical to 0.4.0. pip install --upgrade runcycles is safe; no migration needed.

Why

Diagnostic on Python-side adoption found the biggest gap was discovery: runcycles wasn't ranking for natural Python search queries ("Python AI agent budget control", "LLM cost enforcement", etc.) while named competitor packages were. The brand-led PyPI description and missing keywords were contributors.

Three changes to pyproject.toml

1. Description rewritten to lead with the literal category-search phrase:

   • Old: "Python client for the Cycles budget-management protocol"
   • New: "Python AI agent budget control — enforce LLM cost limits, tool permissions, and multi-tenant policies before agent actions execute."

2. Keywords expanded 12 → 21, organized into:

   • Category-search: ai-agent, agent-budget, agent-governance, budget-control, cost-control, cost-enforcement, spending-limit, llm-cost, runtime-authority, action-control, multi-tenant
   • Framework targeting: langchain, langgraph, crewai, autogen, openai-agents, mcp, openai, anthropic
   • Brand: cycles, runcycles

3. Classifier added: Topic :: Scientific/Engineering :: Artificial Intelligence — standard PyPI category for AI/ML packages.

Companion changes (separate)

• GitHub topics on this repo: governance dropped, mcp added (now mirrors cycles-client-typescript).
• runcycles/docs: Python framework integration guide titles retitled for category-keyword leading (PR runcycles/cycles-docs#568).

• chore(seo): retarget PyPI metadata for category-search discovery by @amavashev in #56

Test coverage: 100% across all 13 modules (no test additions; no behavior change).

Full Changelog: v0.4.0...v0.4.1

Contributors

• @amavashev

What's Changed

The @cycles decorator now accepts callables on every previously-static field — six subject fields (tenant, workspace, app, workflow, agent, toolset), three action fields (action_kind, action_name, action_tags), and dimensions. Callables are invoked with the decorated function's *args, **kwargs at reservation time, enabling per-call budget routing and dynamic action labeling.

@cycles(
 estimate=lambda req, workspace_id: req.tokens * 10,
 workspace=lambda req, workspace_id: workspace_id, # per-call routing
 action_kind=lambda req, *_: f"llm.{req.provider}", # dynamic label
 action_name=lambda req, *_: req.model,
 dimensions=lambda req, *_: {"region": req.region},
)
def run_request(req: ResponseRequest, workspace_id: str) -> Response: ...

Mirrors the existing estimate / actual callable contract and re-aligns the Python client with the Java client's SpEL behavior shipped in cycles-spring-boot-starter 0.2.1.

Fallback semantics (preserved)

• Subject callables returning None fall through to the client-config default.
• action_kind / action_name returning None fall through to "unknown".
• action_tags / dimensions returning None are omitted from the request.
• Exceptions in user callables propagate fail-fast without creating a reservation.

No protocol or wire-format changes.

• feat(decorator): support callables on subject and action fields by @amavashev in #46

Test coverage: 100% across all 13 modules (389 tests).

Full Changelog: v0.3.0...v0.4.0

Contributors

• @amavashev

What's Changed

• Add Claude settings and git workflow guidelines by @amavashev in #22
• Standardize CLAUDE.md and settings.json: fix typo, add schema, add gi... by @amavashev in #23
• Add CLAUDE.md, settings.json, and SessionStart hook by @amavashev in #24
• Refactor CI workflow to use shared workflow from .github repository by @amavashev in #25
• Claude/analyze codebase metrics 9 uqs6 by @amavashev in #26
• Fix contract test UTF-8 encoding for Windows compatibility by @amavashev in #27
• Update coverage badge to reflect actual coverage by @amavashev in #32
• Improve package metadata and discoverability by @amavashev in #33
• chore(deps): bump actions/upload-artifact from 4 to 7 by @dependabot[bot] in #31
• chore(deps): bump actions/checkout from 4 to 6 by @dependabot[bot] in #30
• chore(deps): bump actions/setup-python from 5 to 6 by @dependabot[bot] in #29
• chore(deps): bump actions/download-artifact from 4 to 8 by @dependabot[bot] in #28
• Add project URLs for PyPI sidebar links by @amavashev in #34
• Implement real integration tests for nightly pipeline by @amavashev in #36
• Fix API response codes and parameter names in integration tests by @amavashev in #37
• fix: guard requests import so CI collection doesn't fail by @amavashev in #38
• feat: add StreamReservation context manager for streaming DX by @amavashev in #39

New Contributors

• @dependabot[bot] made their first contribution in #31

Full Changelog: v0.2.0...v0.3.0

Contributors

• @amavashev
• @dependabot

What's Changed

• Add comprehensive integration examples for Cycles Python client by @amavashev in #9
• Raise test coverage threshold from unconfigured to 95% by @amavashev in #10
• Remove redundant --cov-fail-under=85 from CI workflow by @amavashev in #11
• Move coverage config to [tool.coverage] so pytest works without pytes... by @amavashev in #12
• Add API key creation instructions to README by @amavashev in #13
• docs: fix broken docs URLs and add API key comment to examples by @amavashev in #14
• Add badges to README for PyPI, CI, and License by @amavashev in #15
• Add documentation links to README by @amavashev in #16
• Document nested @cycles decorator behavior and best practices by @amavashev in #17
• Claude/analyze spring issue 29 v biy9 by @amavashev in #18
• Change default overage policy from REJECT to ALLOW_IF_AVAILABLE by @amavashev in #19
• Add budget state and extension error codes, charged amount to response by @amavashev in #20
• chore: bump version to 0.2.0 for protocol v0.1.24 by @amavashev in #21

Full Changelog: v0.1.3...v0.2.0

Contributors

• @amavashev
• @cycles

What's Changed

• Claude/review python cycles client w2 pzs by @amavashev in #5
• test: close all coverage gaps, achieve 100% coverage by @amavashev in #6
• Add comprehensive audit report and improve code quality by @amavashev in #7
• ci: enforce 85% pytest coverage threshold in CI by @amavashev in #8

Full Changelog: v0.1.2...v0.1.3

Contributors

• @amavashev

What's Changed

• Add comprehensive test coverage and input validation by @amavashev in #2
• Enforce spec-required fields and fix estimate validation by @amavashev in #3
• Claude/validate python client m soj n by @amavashev in #4

Full Changelog: v0.1.1...v0.1.2

Contributors

• @amavashev

Full Changelog: v0.1.0...v0.1.1

What's Changed

• Add comprehensive error handling and improve API model validation by @amavashev in #1

New Contributors

• @amavashev made their first contribution in #1

Full Changelog: https://github.com/runcycles/cycles-client-python/commits/v0.1.0

Contributors

• @amavashev