stoz3n-workflow-movies
An example repository-backed workflow for
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:
/movie Where can I stream Arrival (2016) in Austria? Include the director and main cast.
Repository contract
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
python scripts/validate_manifest.py
The validator uses only Python's standard library and prints the canonical manifest digest consumed by the host lock.