mirror of
https://github.com/budelius/stoz3n-workflow-movies.git
synced 2026-11-21 16:15:55 +00:00
54 lines
1.9 KiB
Markdown
54 lines
1.9 KiB
Markdown
# 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.
|