# phisio

> 

- Documentation: https://pr-1-3b5c652a9824.thally.app
- GitHub: https://github.com/thallylabs/phisio
- Full docs for LLMs: https://pr-1-3b5c652a9824.thally.app/llms-full.txt
- Agent discovery (ai.txt): https://pr-1-3b5c652a9824.thally.app/ai.txt
- Structured docs index (JSON): https://pr-1-3b5c652a9824.thally.app/api/docs-index
- OpenAPI spec: https://pr-1-3b5c652a9824.thally.app/openapi.yaml

## For AI agents

Every page supports content negotiation on its human URL:
- JSON API: append `?format=json` or send `Accept: application/json`
- JSON-LD: append `?format=ldjson` or send `Accept: application/ld+json`
- Markdown: append `?format=md` or send `Accept: text/markdown`
- Per-page API: https://pr-1-3b5c652a9824.thally.app/api/docs/{page-id}
- Search API: https://pr-1-3b5c652a9824.thally.app/api/search?q={query}
- Capability manifest (skill): https://pr-1-3b5c652a9824.thally.app/skill.md
- Agent guidance (editing these docs): https://pr-1-3b5c652a9824.thally.app/AGENTS.md
- MCP server (attach docs as native tools): https://pr-1-3b5c652a9824.thally.app/api/mcp
- Agent readiness: https://pr-1-3b5c652a9824.thally.app/api/agent-readiness

### Recommended workflow

1. Use this index, the search API, or `search_docs` before choosing a page.
2. Read the smallest set of relevant pages and follow their prerequisite links.
3. Treat the published docs as the source of truth. Label inferences and say when evidence is missing.
4. Cite the canonical human page URLs, not only API endpoints.
5. Use `/AGENTS.md` before editing a repository. The public MCP server is read-only.

## Documentation

### Get started

- [OrbitRail](https://pr-1-3b5c652a9824.thally.app/): Reliable event delivery and payload verification for product integrations.
- [Quickstart](https://pr-1-3b5c652a9824.thally.app/quickstart): Install the OrbitRail packages, publish your first event, and verify a signed payload.

### Events

- [Delivery policy](https://pr-1-3b5c652a9824.thally.app/delivery-policy): Retry windows, timeouts, payload limits, and every constant exported by @orbitrail/events.
- [Publishing events](https://pr-1-3b5c652a9824.thally.app/publishing): How to publish events to OrbitRail, including idempotency, payload requirements, and error handling.
- [Replay and retention](https://pr-1-3b5c652a9824.thally.app/replay): Replay retained events on demand and track delivery status through the event lifecycle.

### Verify

- [Overview](https://pr-1-3b5c652a9824.thally.app/verify-overview): Validate signed payloads with @orbitrail/verify before your application processes them.
- [Configuration](https://pr-1-3b5c652a9824.thally.app/verify-configuration): Configuration options, defaults, valid ranges, and error handling for @orbitrail/verify.

## API Reference

Interactive API reference available at https://pr-1-3b5c652a9824.thally.app/api