{"schema_version":"1.0","name":"catholic-greatness","display_name":"Catholic Greatness — Spiritual AI","description":"AI-powered Catholic formation: spiritual direction, daily saints, scripture readings, formation programs, and semantic search across 2,000 years of wisdom.","version":"1.0.0","base_url":"https://cg.substrate-a2a.com","platform":"phos","auth":{"type":"api_key","header":"X-API-Key","internal_bypass":{"convention":"internal_<engine_name>_<hmac_32>","docs":"HMAC-SHA256(INTERNAL_SERVICE_SECRET, engine_name)[:32]. Bypasses credit deduction for cross-engine calls.","examples":["internal_piranha_<hmac>","internal_marketing_<hmac>"]}},"billing":{"model":"credits","unit_price_usd":0.01,"balance_endpoint":"GET /api/credits/balance","docs":"Credits deducted on 2xx responses. Free ops cost 0 credits. X-Credits-Charged and X-Credits-Balance headers on every metered response."},"product_lines":["spiritual_ai","content_library"],"capabilities":[{"id":"truth_lens_analyze","product_line":"spiritual_ai","category":"analysis","name":"Truth Lens — Analyze Content","method":"POST","path":"/api/v1/truth-lens/analyze","description":"Analyze any text or URL through the lens of Catholic truth. Returns alignment score, key claims evaluation, and theological commentary.","cost_credits":10,"compute":"ai"},{"id":"wisdom_lens_generate","product_line":"spiritual_ai","category":"analysis","name":"Wisdom Lens — Generate Reflection","method":"POST","path":"/api/v1/wisdom-lens/generate","description":"Generate a Catholic wisdom reflection on any topic, drawing from Church Fathers, Saints, and Scripture.","cost_credits":10,"compute":"ai"},{"id":"spiritual_chat","product_line":"spiritual_ai","category":"chat","name":"Spiritual Chat — Send Message","method":"POST","path":"/api/chat/conversations/*/messages","description":"Send a message to the AI spiritual director. Requires a conversation ID. Returns personalized guidance rooted in Catholic tradition.","cost_credits":5,"compute":"ai"},{"id":"spiritual_chat_stream","product_line":"spiritual_ai","category":"chat","name":"Spiritual Chat — Stream Message","method":"POST","path":"/api/chat/conversations/*/messages/stream","description":"Stream a spiritual direction response in real-time via SSE.","cost_credits":5,"compute":"ai"},{"id":"conversation_summary","product_line":"spiritual_ai","category":"chat","name":"Conversation Summary","method":"GET","path":"/api/chat/conversations/*/summary","description":"Get an AI-generated summary of a spiritual direction conversation.","cost_credits":5,"compute":"ai"},{"id":"examen_reflect","product_line":"spiritual_ai","category":"reflection","name":"Examen — AI Reflection","method":"POST","path":"/api/v1/examen/*/reflect","description":"Generate an AI-guided Ignatian Examen reflection based on the user's journal entry.","cost_credits":5,"compute":"ai"},{"id":"weekly_plan_generate","product_line":"spiritual_ai","category":"formation","name":"Weekly Plan — Generate","method":"GET","path":"/api/v1/camino/weekly-plan","description":"Generate a personalized weekly spiritual formation plan based on the user's El Camino phase and progress.","cost_credits":8,"compute":"ai"},{"id":"weekly_plan_regenerate","product_line":"spiritual_ai","category":"formation","name":"Weekly Plan — Regenerate","method":"POST","path":"/api/v1/camino/weekly-plan/regenerate","description":"Force regeneration of the weekly spiritual plan, discarding the cached version.","cost_credits":8,"compute":"ai"},{"id":"semantic_search","product_line":"spiritual_ai","category":"search","name":"Semantic Search","method":"POST","path":"/api/v1/vectors/search","description":"Semantic search across Catholic wisdom: saints, scripture, formation content, and meditations.","cost_credits":3,"compute":"ai"},{"id":"get_saints","product_line":"content_library","category":"saints","name":"List Saints","method":"GET","path":"/api/v1/saints","description":"Get the full catalog of saints with biographies, feast days, and patron topics.","cost_credits":1,"compute":"read"},{"id":"get_saint_detail","product_line":"content_library","category":"saints","name":"Saint Detail","method":"GET","path":"/api/v1/saints/*","description":"Get detailed saint information including AI-generated biography, meditation, and quotes.","cost_credits":1,"compute":"read"},{"id":"get_daily_saint","product_line":"content_library","category":"saints","name":"Daily Saint","method":"GET","path":"/api/v1/saints/daily","description":"Get today's saint based on the liturgical calendar.","cost_credits":1,"compute":"read"},{"id":"get_daily_readings","product_line":"content_library","category":"scripture","name":"Daily Readings","method":"GET","path":"/api/v1/scripture/readings/daily","description":"Get today's USCCB daily scripture readings.","cost_credits":1,"compute":"read"},{"id":"get_liturgical_day","product_line":"content_library","category":"scripture","name":"Liturgical Day","method":"GET","path":"/api/v1/scripture/liturgical-day","description":"Get today's liturgical calendar data: season, color, rank, celebrations.","cost_credits":1,"compute":"read"},{"id":"get_meditations","product_line":"content_library","category":"saints","name":"Saint Meditations","method":"GET","path":"/api/v1/saints/*/meditations","description":"Get AI-generated meditations for a specific saint.","cost_credits":1,"compute":"read"},{"id":"get_quotes","product_line":"content_library","category":"wisdom","name":"Quotes Library","method":"GET","path":"/api/v1/quotes","description":"Get quotes from saints, Church Fathers, and Catholic tradition.","cost_credits":1,"compute":"read"},{"id":"search_content","product_line":"content_library","category":"search","name":"Content Search","method":"GET","path":"/api/v1/vectors/search","description":"Keyword/filtered search across content library.","cost_credits":1,"compute":"read"},{"id":"get_formation_programs","product_line":"content_library","category":"formation","name":"Formation Programs","method":"GET","path":"/api/formation/programs","description":"List available spiritual formation programs (8-week curriculum).","cost_credits":1,"compute":"read"},{"id":"get_formation_weeks","product_line":"content_library","category":"formation","name":"Formation Week Detail","method":"GET","path":"/api/formation/weeks/*","description":"Get a specific formation week with daily activities and reflections.","cost_credits":1,"compute":"read"},{"id":"get_formation_day","product_line":"content_library","category":"formation","name":"Formation Day Detail","method":"GET","path":"/api/formation/days/*","description":"Get a specific formation day with readings, activities, and prayer.","cost_credits":1,"compute":"read"},{"id":"get_lenten_programs","product_line":"content_library","category":"formation","name":"Lenten Programs","method":"GET","path":"/api/v1/lent/programs","description":"List available Lenten formation programs.","cost_credits":1,"compute":"read"},{"id":"get_health","product_line":"content_library","category":"system","name":"Health Check","method":"GET","path":"/health","description":"Service health check.","cost_credits":0,"compute":"free"},{"id":"get_service_catalog","product_line":"content_library","category":"system","name":"Service Catalog","method":"GET","path":"/.well-known/agent.json","description":"A2A service discovery manifest.","cost_credits":0,"compute":"free"},{"id":"get_pillars","product_line":"content_library","category":"system","name":"Eight Pillars","method":"GET","path":"/api/v1/pillars","description":"Get the 8 pillars of Catholic Greatness framework.","cost_credits":0,"compute":"free"}],"rate_limits":{"default":"60 req/min","ai_operations":"10 req/min","note":"Rate limits per API key. AI operations have lower limits due to compute cost."}}