runcycles/cycles-spring-ai-starter

Cycles Spring AI Starter is a Spring Boot starter that enforces runtime budget and governance for Spring AI ChatClient calls by integrating the Cycles Protocol. It auto-attaches an advisor to ChatClient builders so LLM calls are reserved with Cycles before hitting providers; a denied reservation throws CyclesBudgetDeniedException and prevents the call. Who uses it: Java 21+, Spring Boot 3.5+, Spring AI 1.0+ applications that require multi-tenant spend control, tamper-evident audit, and production-grade fail-closed budgeting for agents and tools. Key features: - Pre-call reservation → commit on success → release on error/cancel lifecycle for non-streaming and streaming flows. - Optional CyclesToolGate to wrap tool callbacks (separate audit labels). - Auto-configuration via ChatClientCustomizer, configurable via application.yml (base URL, api key, tenant/workspace/app, estimates, action labels, fail-open). - Observation convention to append Cycles attribution tags to traces. - Behaves fail-closed by default; configurable fail-open for transport errors.

AI-related keywords found in this repo's description, topics, or README summary — grouped by category. Each badge links to the corresponding ranking detail page.