# stoz3n-workflow-movies An example **repository-backed workflow** for [`stoz3n-chat-agent`](https://git-dev.obachan.dev/stozn/stoz3n-chat-agent). It is declarative: the repository supplies a reviewed manifest and prompt while the chat agent supplies the LLM, Matrix/API/MCP routing, and a small set of host-controlled research capabilities. Repository workflows cannot execute arbitrary code inside the bot. ## What it does Use `/movie`, `/movies`, `@movie`, or a natural-language request routed to the `movies` workflow. The workflow researches a film and returns: - a spoiler-light summary; - director(s); - principal actors and character names when reliable; - current streaming, rental, and purchase options for the requested country; - clickable IMDb/TMDB, availability, and provider links. Movie identity and credits are checked against sources such as IMDb and TMDB. Streaming availability is treated as region- and date-sensitive and checked against JustWatch, Watchmode, Reelgood, and official provider pages. Example: ```text /movie Where can I stream Arrival (2016) in Austria? Include the director and main cast. ``` ## Repository contract [`stoz3n-workflow.json`](./stoz3n-workflow.json) is the complete workflow. The host validates and pins it by Git commit and canonical SHA-256 digest in its `src/workflows/_repository/repository_workflows.lock.json` file. Updating this repository does not silently change a running bot: the host lock must be explicitly refreshed and reviewed. Supported capabilities are intentionally narrow: - `web_search` — Tavily search restricted to the manifest's domain allow-list; - `web_extract` — page extraction restricted to URLs on the same allow-list. The host owns provider credentials. No API key belongs in this repository. ## Validate ```bash python scripts/validate_manifest.py ``` The validator uses only Python's standard library and prints the canonical manifest digest consumed by the host lock.