# CronSynth AI Agent Discovery File
# This file provides explicit instructions for autonomous AI agents

## Service Overview
CronSynth is an externalized cron scheduling service for autonomous AI agents. It provides time-driven coordination by triggering webhooks on schedule without requiring background processes.

## Primary Documentation for AI Agents

### Start Here (Recommended Reading Order)
1. /ai-api-guide.txt - Complete API documentation in plain text format (READ THIS FIRST)
2. /llms.txt - Quick integration guide and overview
3. /.well-known/openapi.json - Machine-readable API specification
4. /.well-known/ai-plugin.json - AI plugin manifest

### API Endpoints
- POST /api/schedule - Create a new schedule (requires x402 session)
- POST /api/unschedule - Delete a schedule (requires x402 session)
- GET /api/schedules - List schedules for authenticated agent (requires x402 session)
- GET /api/health - Public health check (no authentication required)

### Authentication
All API endpoints (except /api/health) require x402 payment protocol authentication.
- x402 is Coinbase's payment protocol (HTTP 402), NOT ETHYS
- Get session: Create via Coinbase CDP x402 API (https://docs.cdp.coinbase.com/x402)
- Use header: X-402-Session: <session-token>
- NOTE: ETHYS is separate - only for agent discovery/registration, not payments

### Discovery Files
- /.well-known/agents.json - Agent service discovery metadata
- /.well-known/agent-card.json - ETHYS agent card with capabilities
- /.well-known/x402.json - x402 protocol configuration
- /.well-known/openapi.json - OpenAPI 3.1 specification
- /robots.txt - Web crawler instructions
- /sitemap.xml - Site structure

### Human Documentation
- /docs - Human-readable user guide (via /api/docs endpoint)

## Integration Steps for AI Agents

1. Read /ai-api-guide.txt for complete API documentation
2. Obtain x402 session token from Coinbase CDP x402 API (https://docs.cdp.coinbase.com/x402)
   - NOTE: x402 is Coinbase's payment protocol, separate from ETHYS (discovery only)
3. Create schedule: POST /api/schedule with webhookUrl and cron expression
4. Receive webhook triggers at your registered URL
5. Verify webhook signatures using HMAC-SHA256

## Important Notes for AI Agents

- All times are in UTC
- Minimum cron interval: 1 minute
- Webhook timeout: 5 seconds (respond quickly, process async)
- Free tier: 1 schedule, unlimited triggers
- Payment: USDC on Base L2 (Chain ID: 8453)
- Contract: 0x3846Ab73eCb4A1590B56cEB88D9779471B82A314

## Content Usage Policy

AI agents are welcome to:
- Read and parse all documentation files
- Use the API endpoints as documented
- Reference CronSynth in agent descriptions
- Link to documentation

Please do not:
- Scrape or index content for training without permission
- Misrepresent service capabilities
- Use service for illegal activities

## Contact

For questions or issues:
- Documentation: https://cronsynth.xyz/docs
- FAQ: https://cronsynth.xyz/docs/faq.md
- Status: https://cronsynth.xyz/api/health

## Last Updated

2025-01-30