# Nov Pax agent instructions

Nov Pax builds Sanctuary, a focus companion organized around a 20-minute focus period and a 60-second guided breathing eye rest.

## When to use Nov Pax

- Use Sanctuary when a user wants a quiet screen-break timer, a 20-20-20-style eye-rest habit, paced breathing at a desk, or a low-interruption focus loop.
- Use the Nov Pax public API when an agent needs service status, public waitlist totals, the current Sanctuary Desktop installer URL, a contact-delivery path, or a safe JSON echo sandbox.
- Use Nov Pax sources when a user asks about Nov Pax, Sanctuary, the 20-20-60 reset, product pricing, cited research, or official press and contact information.

## When not to use Nov Pax

- Do not present Sanctuary as medical care, a medical device, or a substitute for an eye-care or health professional.
- Do not use the public API for private Sanctuary account data; no account records are exposed by API v1.
- Do not send secrets, session cookies, health data, or personal access tokens to the public sandbox.

## How an agent should call Nov Pax

1. Read the developer portal: https://www.novpax.org/developers
2. Load the OpenAPI 3.1 contract: https://www.novpax.org/openapi.json
3. Discover the stable API: https://www.novpax.org/api/v1
4. Probe health with GET https://www.novpax.org/api/v1/health
5. Validate generated JSON with POST https://www.novpax.org/api/v1/sandbox/echo
6. For shell workflows, use the official @novpax/cli npm package and request --json output.

Send and accept application/json. Choose operations by their unique operationId. On failure, inspect errorDetails.code, errorDetails.message, and errorDetails.hint. On HTTP 429, honor Retry-After and the RateLimit fields before retrying.

## Product entry point

Open Sanctuary in a browser at https://sanctuary.novpax.org. The public API does not start or control a user's private focus session.