watcher_start
Start a headless hot-folder watcher to automatically run a specified recipe whenever a PDF is dropped into a local directory, enabling automated document processing.
Instructions
Start a headless hot folder watcher daemon on a local directory. When a PDF is dropped into the watched directory it automatically runs the specified recipe.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"dir": "<dir>",
"recipe": "<recipe>"
},
"name": "watcher_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dir | Yes | Absolute path to the directory to watch | |
| recipe | Yes | Local .ppflow recipe path, preset ID, or serialized workflow | |
| output_dir | No | Output directory; defaults to a separate processed subfolder | |
| name_template | No | Output basename template; input, UTC date, SHA-256 and index tokens | |
| settle_delay_ms | No |