feat: add movie research workflow manifest

This commit is contained in:
budelius committed 2026-10-13 11:12:56 +02:00
1 parent b6de16f482
commit ab49d8d110
4 files changed
+178 -1

No files matched your search

+51 -1
View File
@@ -1,3 +1,53 @@
# stoz3n-workflow-movies
Example repository-backed movie research workflow for stoz3n
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.