mirror of
https://github.com/budelius/stoz3n-workflow-movies.git
synced 2026-11-21 16:15:55 +00:00
feat: add movie research workflow manifest
This commit is contained in:
1 parent
b6de16f482
commit
ab49d8d110
4 files changed
+178
-1
No files matched your search
@@ -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.
|
||||
Reference in new issue
Block a user