# auth.md - Still Falling Agent Access & Registration

Welcome to the agent access protocol for **Still Falling** (https://stillfalling.valaciel.com).

## Agent Audience

This service provides public, machine-readable access to the *Still Falling* fantasy web novel archive, character directories, world systems, and aura progression data for autonomous AI agents, search crawlers, LLMs, and research tools.

## Authentication & Access Model

- **Public Anonymous Access:** All machine-readable endpoints (`/llms.txt`, `/llms-full.txt`, `/characters.json`, `/novel.json`, `/novel/*.md`, `/characters/*.md`) are open and accessible to all agents without registration, API keys, or credentials.
- **Identity Types Supported:** `anonymous`
- **Credential Types Supported:** None required for public reading (`bearer` for authorized services).
- **Scopes Supported:** `read:novel`, `read:characters`

## Machine Endpoints & Discovery

- **AI Index & Summary:** [`/llms.txt`](/llms.txt)
- **Deep Context & Full Dossiers:** [`/llms-full.txt`](/llms-full.txt)
- **Structured Cast Directory:** [`/characters.json`](/characters.json)
- **Structured Table of Contents:** [`/novel.json`](/novel.json)
- **RFC 9727 API Catalog:** [`/.well-known/api-catalog`](/.well-known/api-catalog)
- **OAuth Protected Resource Metadata:** [`/.well-known/oauth-protected-resource`](/.well-known/oauth-protected-resource)
- **OAuth Authorization Server Metadata:** [`/.well-known/oauth-authorization-server`](/.well-known/oauth-authorization-server)

## Agent Registration

For automated agent provisioning and discovery:
- **Registration URI:** `https://stillfalling.valaciel.com/agent/auth`
- **Claim URI:** `https://stillfalling.valaciel.com/agent/claim`
- **Protocol Standard:** [Auth.md Specification](https://workos.com/auth-md)

## Polite Crawling & Rate Limits

- Respect standard HTTP `Cache-Control` response headers.
- All endpoints are deployed globally via Cloudflare edge cache.
- Content preferences are declared via `Content-Signal` in [`/robots.txt`](/robots.txt).