# AutoShow Discovery Index

Canonical site URL: https://autoshow.page
Repository: https://github.com/ajcwebdev/autoshow-bun

This markdown index is for agents and operators. It lists the public discovery surfaces plus the authenticated workflow routes that are intentionally excluded from normal crawl/index flows.
Public shared show-note pages are emitted dynamically in `/sitemap.xml` and are not enumerated here.

## Public discovery routes
- [/](/) `text/html` - Public overview of AutoShow capabilities, supported inputs, and the processing pipeline.
- [/pricing](/pricing) `text/html` - Public pricing overview for credit bundles, base conversion, and usage-based billing.
- [/llms.txt](/llms.txt) `text/plain` - Cheap plain-text orientation for agents and operators.
- [/sitemap.md](/sitemap.md) `text/markdown` - Machine-readable markdown index for public routes, operator routes, and API entry points.
- [/sitemap.xml](/sitemap.xml) `application/xml` - Search-oriented sitemap for public crawlable pages and machine-readable discovery routes.
- [/robots.txt](/robots.txt) `text/plain` - Crawler policy that keeps protected routes blocked while allowing discovery endpoints.
- [/api](/api) `application/json` - Public JSON overview of the AutoShow API with auth expectations and next actions.
- [/api/health](/api/health) `application/json` - Public JSON health endpoint used by deploy checks and test runners.
- [/api/process/document-capabilities](/api/process/document-capabilities) `application/json` - Public JSON capabilities surface for document extraction providers and current runtime support.

## Authenticated operator routes
- [/login](/login) `public` - Magic-link sign-in page for interactive operators.
- [/create](/create) `session` - Authenticated UI for verifying inputs, uploading files, and starting processing jobs.
- [/show-notes](/show-notes) `session` - Authenticated dashboard for completed jobs and generated assets.
- [/show-notes/{id}](/show-notes/{id}) `public` - Public when the owner enables sharing; otherwise only the owner can view the note.

## API endpoints
- `GET /api` `public` returns `application/json` - Machine-readable API overview with endpoint metadata and next actions.
- `GET /api/health` `public` returns `application/json` - Read-only service health endpoint.
- `GET /api/process/document-capabilities` `public` returns `application/json` - Current server-side document extraction capability matrix.
- `POST /api/download/verify-url` `session` accepts `application/json`; returns `application/json` - Validate a public source URL and return metadata before job submission.
- `POST /api/download/upload` `session` accepts `multipart/form-data`; returns `application/json` - Single-request file upload endpoint for local sources.
- `POST /api/download/upload-chunk` `session` accepts `multipart/form-data`; returns `application/json` - Chunked upload endpoint for large local files.
- `POST /api/process` `session` accepts `multipart/form-data`; returns `application/json` - Start a background job for transcription or document extraction plus optional generation steps.
- `GET /api/jobs/{id}` `session` returns `application/json` - Fetch current job progress until a show note is completed or the job fails.
- `DELETE /api/show-notes/{id}` `session` returns `application/json` - Soft delete a show note so it no longer appears in the user library.
- `POST /api/show-notes/{id}/share` `session` accepts `application/json`; returns `application/json` - Make a show note public at its existing URL or return it to private owner-only access.

## Repository markdown docs
- [README.md](https://raw.githubusercontent.com/ajcwebdev/autoshow-bun/main/README.md) `text/markdown` - Setup, feature summary, CLI/docs index, and discovery route references.
- [docs/api/README.md](https://raw.githubusercontent.com/ajcwebdev/autoshow-bun/main/docs/api/README.md) `text/markdown` - Top-level API docs for auth, endpoints, errors, and environment expectations.
- [docs/tests.md](https://raw.githubusercontent.com/ajcwebdev/autoshow-bun/main/docs/tests.md) `text/markdown` - Canonical test commands and shared infrastructure notes.

## Recommended next moves
1. Read [llms.txt](/llms.txt) for the cheapest orientation surface.
2. Read [the API discovery document](/api) for JSON endpoint metadata.
3. Read [the repository overview](https://github.com/ajcwebdev/autoshow-bun#readme) for setup and documentation links.