# Hatchloop Agent Utils — Utility API for AI Agents

> Zero-authentication utility API hub. 10 essential tools that AI agents need constantly. Consistent JSON responses. No rate limits for reasonable use. CORS open.

Base URL: `https://hatchloop.dev`
OpenAPI spec: `https://hatchloop.dev/tools/openapi.json`
All responses: `{success: bool, tool: string, result: object, timestamp: ISO8601}`

---

## Tool Index

### 1. UUID Generation
`GET /api/tools/uuid?version=4`
Generates a UUID. `version=4` (random, default) or `version=7` (time-sortable, ideal for DB primary keys).
Returns: `{uuid, version, format}`

### 2. String Hashing
`GET /api/tools/hash?input=TEXT&algo=sha256`
Hashes a string. Algorithms: `sha256` (default), `md5`, `sha1`, `sha512`. Returns hex digest.
Returns: `{input, algorithm, hash, length_bits, length_hex_chars}`

### 3. Base64 Encode/Decode
`GET /api/tools/base64?action=encode&value=TEXT`
`action`: `encode` or `decode`. Also returns URL-safe Base64url variant on encode.
Returns: `{action, input, output, url_safe?}`

### 4. Current Timestamp
`GET /api/tools/timestamp?format=all`
`format`: `iso`, `unix`, `human`, or `all` (default — returns all formats + date components).
Returns: `{iso, unix, unix_ms, human, year, month, day, hour, minute, second}`

### 5. Email Validation
`GET /api/tools/validate/email?email=user@example.com`
Validates email format. Returns validity, local/domain parts, and specific issues if invalid.
Returns: `{email, valid, local_part, domain, has_subdomain, issues}`

### 6. JSON Validation + Pretty-Print
`POST /api/tools/validate/json`
Body: raw JSON text. Validates JSON, returns parsed object, pretty-printed string, type, key count.
Returns: `{valid, parsed, pretty, type, char_count, key_count, issues}`
Note: `success:true` even when JSON is invalid — check `result.valid`.

### 7. Unit Conversion
`GET /api/tools/convert/units?value=100&from=km&to=miles`
Supported units: `km`, `miles`, `meters`, `feet` (distance) | `kg`, `lbs`, `grams`, `ounces` (weight) | `celsius`, `fahrenheit`, `kelvin` (temperature) | `liters`, `gallons`, `ml` (volume) | `bytes`, `kb`, `mb`, `gb`, `tb` (storage).
Returns: `{input_value, input_unit, output_value, output_unit, formatted}`

### 8. Regex Tester
`GET /api/tools/regex/test?pattern=\d+&input=abc123&flags=g`
Tests a regex pattern against input. `flags`: `g` (all matches), `i` (case-insensitive), `m` (multiline).
Returns: `{pattern, flags, input, matched, match_count, matches[{match, index, groups}]}`

### 9. Cron Expression Describer
`GET /api/tools/cron/describe?expr=0+9+*+*+1-5`
Converts cron expression to human-readable text + next 5 run times in UTC ISO 8601.
Returns: `{expression, description, next_5_runs, timezone}`
Example: `0 9 * * 1-5` → "At 09:00 AM, Monday through Friday"

### 10. JWT Decoder (no secret)
`GET /api/tools/jwt/decode?token=eyJ...`
Decodes JWT header + payload without signature verification. Returns all claims, expiry status, issuer, subject.
Returns: `{header, payload, algorithm, expires_at, is_expired, seconds_until_expiry, issuer, subject, signature_verified: false}`
NOTE: Signature is NOT verified. Do not use for security decisions.

---

## Meta Endpoints

`GET /api/tools` — List all tools with descriptions and parameters
`GET /api/tools/health` — Service health check (status, uptime, tool count)

---

## Quick Examples

```
# Generate UUID
curl https://hatchloop.dev/api/tools/uuid

# SHA-256 hash
curl "https://hatchloop.dev/api/tools/hash?input=hello+world&algo=sha256"

# Base64 encode
curl "https://hatchloop.dev/api/tools/base64?action=encode&value=hello"

# Current timestamp (all formats)
curl https://hatchloop.dev/api/tools/timestamp

# Validate email
curl "https://hatchloop.dev/api/tools/validate/email?email=user@example.com"

# Validate JSON
curl -X POST https://hatchloop.dev/api/tools/validate/json \
  -H "Content-Type: application/json" \
  -d '{"key": "value"}'

# Convert 100km to miles
curl "https://hatchloop.dev/api/tools/convert/units?value=100&from=km&to=miles"

# Test regex
curl "https://hatchloop.dev/api/tools/regex/test?pattern=%5Cd%2B&input=abc123def456&flags=g"

# Describe cron
curl "https://hatchloop.dev/api/tools/cron/describe?expr=0+9+*+*+1-5"

# Decode JWT
curl "https://hatchloop.dev/api/tools/jwt/decode?token=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ1c2VyIn0.sig"
```

---

## Authentication

None required. All endpoints are public. CORS enabled for all origins.

## Rate Limits

No hard rate limits for reasonable agent use. Please cache results where appropriate (e.g., cron descriptions, unit conversions).

## Keywords

UUID generator, hash API, SHA256 API, base64 encode decode API, timestamp API, email validator API, JSON validator API, unit conversion API, regex tester API, cron parser API, JWT decoder API, agent utility API, no-auth API, developer tools API, AI agent tools