Files

1.9 KiB

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.