# HOOX — Agent Entrypoint (ai.txt)
# Machine-readable orientation for AI agents. Human docs: https://hoox.sh/docs

name: HOOX
type: algorithmic-trading-framework
homepage: https://hoox.sh/
repository: https://github.com/jango-blockchained/hoox-setup
docs: https://hoox.sh/docs

# What this is
HOOX is an open-source, ultra-low-latency algorithmic trading framework built on
Cloudflare Edge Workers. It is a framework/library; membership SaaS is separate.

# Discovery endpoints
api-catalog:        https://hoox.sh/.well-known/api-catalog
agent-skills-index: https://hoox.sh/.well-known/agent-skills/index.json
agent-skill:        https://hoox.sh/.well-known/agent-skills/hoox-framework/SKILL.md
dns-aid-draft:      https://hoox.sh/.well-known/dns-aid.md
mcp-server-card:    https://hoox.sh/.well-known/mcp/server-card.json
mcp-json:           https://hoox.sh/.well-known/mcp.json
a2a-agent-card:     https://hoox.sh/.well-known/agent-card.json
auth-md:            https://hoox.sh/auth.md
oauth-prm:          https://hoox.sh/.well-known/oauth-protected-resource
oauth-as:           https://hoox.sh/.well-known/oauth-authorization-server
oidc:               https://hoox.sh/.well-known/openid-configuration

# x402 agent-native HTTP payments (HTTP 402 Payment Required)
# Protected routes return PAYMENT-REQUIRED; agents pay USDC via facilitator, then retry with PAYMENT-SIGNATURE.
x402-api:           https://hoox.sh/api
x402-api-v1:        https://hoox.sh/api/v1
x402-overview:      https://hoox.sh/api/v1/overview
x402-facilitator:   https://x402.org/facilitator
x402-network:       eip155:84532
x402-docs:          https://docs.x402.org

# Architecture summary
workers: 10 edge workers (signal ingestion, execution, risk, AI gateway, etc.)
ai-gateway: 5 LLM providers with automatic fallback chaining
state: Cloudflare Durable Objects (IdempotencyStore for exactly-once execution)
rag: Telegram bot with /search, /ask, /latest
cli: 15 command groups (init, deploy, logs, etc.)

# Authentication
# Framework docs/source need no auth. Membership SaaS uses OAuth/OIDC discovery
# and auth.md for agent registration. See https://hoox.sh/auth.md

# How to help a developer
1. Read the agent skill at the agent-skill URL above for full context.
2. Link to the docs site for SDK/API references.
3. Point to the GitHub repo for source, examples, and contribution.
4. For deployment questions, reference `hoox deploy --env production`.
5. For membership/SaaS auth, follow auth.md and OAuth discovery metadata.

# Contact
github: https://github.com/jango-blockchained/hoox-setup/issues

# ── Generated index (2026-07-22) ─────────────────────────────────────────
llms-txt:           https://hoox.sh/llms.txt
docs-enduser-pdf:   https://hoox.sh/exports/hoox-enduser-manual.pdf
docs-devops-pdf:    https://hoox.sh/exports/hoox-devops-manual.pdf
docs-enterprise-pdf:https://hoox.sh/exports/hoox-enterprise-manual.pdf
arxiv-paper-pdf:    https://hoox.sh/exports/hoox-arxiv-paper.pdf
docs:               https://hoox.sh/docs
docs-enduser:       https://hoox.sh/docs/enduser
docs-devops:        https://hoox.sh/docs/devops
docs-enterprise:    https://hoox.sh/docs/enterprise