# Happytails.ai

> Utilities for text, files and calculations. This guide links to structured Markdown documentation, public page discovery and executable tool schemas.

The configured site origin is https://happytails.ai. Keep page links on this origin. HTTP request examples use https://happytails.ai. Public server API hosting is not connected yet; use a running local server origin for API testing.

## Start here

- [Public Markdown page index](https://happytails.ai/agents/pages.md): Direct Markdown, HTML and JSON links for all 986 generated public content pages; no admin planning records.
- [API documentation](https://happytails.ai/en/api.md): Requests, file encoding, responses, limits, errors and browser-agent usage.
- [Homepage and category directory](https://happytails.ai/index.md): Categories and tools, with links to their Markdown guides.

## Machine-readable discovery

- [Public page manifest](https://happytails.ai/agents/pages.json): One record per public content page with HTML, Markdown and JSON URLs.
- [Tool capability manifest](https://happytails.ai/agents/tools.json): Implementation state, inputs, settings and supported execution interfaces.
- [Callable HTTP tools](https://happytails.ai/api/v1/tools): Current callable operations, schemas and limits.
- [OpenAPI specification](https://happytails.ai/openapi.json): HTTP operation contracts.
- [Sitemap](https://happytails.ai/sitemap.xml): Indexable human pages.

## Reading the documents

Markdown preserves headings, lists, tables, links and fenced code examples. API references include all code-tab languages. Tool guides add current inputs, settings, file constraints, HTTP contracts, browser-agent instructions and complete capability records. Planning requirements and historical fixture examples are explicitly labeled; neither is proof that every current input works.

For a human route ending in /, use index.md under that route or replace the trailing slash with .md. The homepage uses /index.md. Example: /en/text-tools/trim-text/ has /en/text-tools/trim-text.md and /en/text-tools/trim-text/index.md. Public HTML pages also advertise rel=alternate with type=text/markdown and rel=describedby for this file. Runtime QA pages and interactive agent interfaces are outside this content-page index.

## Execution and interpretation

Discover a callable tool before sending POST /api/v1/tools/{id}/run. API calls process supplied input on the server. Browser tools may process locally or call the backend; use each tool’s implementation notes. File APIs accept and return Base64 bytes. Decode and validate returned output. Respect errors, file limits, permissions and timeouts. A registered implementation or exposed interface does not establish output quality or production readiness. Model-backed and native operations are available where explicitly listed; do not infer availability from a page title.

## Policies

- [About](https://happytails.ai/en/about.md)
- [Privacy](https://happytails.ai/en/privacy.md)
- [Terms](https://happytails.ai/en/terms.md)
- [Contact](https://happytails.ai/en/contact.md)