echolot flow

echolot flow запускает сценарии без приложения: один раз из терминала или задания CI либо как службу, которая запускает сценарии по расписанию, когда подходит время, и отвечает на вебхуки.

Каждая подкоманда принимает рабочее пространство через -w или --workspace.

echolot flow listCopy Anchor Link

echolot flow list --workspace <workspace> [--json]

echolot flow list -w Alpenglow.echolot

morning-stock-check  Morning stock check
order-status-webhook  Order status on webhook
place-test-order  Place a test order  MCP tool place_test_order

В каждой строке — slug сценария (имя его файла в flows/ без .flow.toml) и его имя, затем, если они есть, входные данные в круглых скобках (необязательные — в квадратных), инструмент MCP, которым сценарий предлагается, и число проблем. --json печатает каждый сценарий с его slug, name, description, inputs, blockCount, errors, warnings и его schedule или webhook.

echolot flow runCopy Anchor Link

echolot flow run <flow> --workspace <workspace> [--env <env>] [--input <name=value> ...] [--json] [--no-input]

<flow> — это slug или имя сценария.

echolot flow run morning-stock-check -w Alpenglow.echolot

✓ start  Start  0 ms
✓ list  List products  148 ms
✓ low  Running low?  4 ms
notification: Restock Bern — A tent is under five in Bern.
✓ notify  Restock  0 ms
Morning stock check: passed in 152 ms

• Каждый блок печатает строку, когда завершается: ✓ или ✗, его ID, его заголовок и его время, а при ошибке — и саму ошибку. То, что пишут блоки Log, и результат каждого теста идут следом отдельными строками.
• Уведомления идут в стандартный поток ошибок.
• Результат сценария печатается в конце как JSON, а за ним в стандартном потоке ошибок — сводка.
• --input name=value задаёт входное значение как текст, преобразованный в тип входа. Указывайте по разу для каждого входа.
• Когда сценарию нужен человек (вход без значения, блок Одобрить), Echolot спрашивает в терминале. --no-input не спрашивает никогда: сценарий в этом месте завершается ошибкой — это именно то, что нужно в CI.
• --json печатает всю запись о прогоне как JSON вместо строк хода выполнения.

echolot flow run "Place a test order" -w Alpenglow.echolot --env staging --no-input

Прогон завершается ошибкой, с кодом 1, когда сценарий или один из его тестов не проходит.

echolot flow newCopy Anchor Link

echolot flow new [<name>] [--workspace <workspace>] [--template <template>]

Без имени команда перечисляет шаблоны:

device-sign-in  OAuth device sign-in: shows the code and link (with a QR code), waits until the person approves, saves the tokens to the Keychain.
refresh-token  Trades the refresh token for a new access token and saves both to the Keychain; says so when it fails.
paginate-and-export  Fetches a number of pages, gathers their items into one list and writes it to a JSON file in the workspace.
smoke-monitor  Every hour, checks that a request answers 200 quickly; a notification when it does not.
seed-and-clean-up  Creates a few records, leaves room for what needs them, then deletes each one again.

С именем она записывает новый файл сценария:

echolot flow new "Export tents" --template paginate-and-export -w Alpenglow.echolot

Created flows/export-tents.flow.toml.

Шаблоны оставляют выбор запросов вам — в приложении или в файле сценария; какие именно, сказано в заметке на холсте. См. шаблоны.

echolot flow serveCopy Anchor Link

echolot flow serve --workspace <workspace> [--env <env>] [--port <port>] [--share] [--token <token>]

Запускает каждый сценарий с расписанием, когда подходит его время, и отвечает на вебхуки сценариев, у которых они есть, пока вы не остановите его клавишами ⌃C. Запустите его на сервере или в контейнере, чтобы автоматизации рабочего пространства продолжали работать без приложения.

echolot flow serve -w Alpenglow.echolot --port 4100

Serving Alpenglow (Ctrl-C stops it)
  schedule  Morning stock check: 0 6 * * *
  webhook   POST http://127.0.0.1:4100/order-status  (Order status on webhook)
  token     3f9a…

Каждый запуск печатает строку со временем, сценарием, тем, чем он закончился, и сколько длился.

Вебхуки. Вызывающий отправляет метод и путь вебхука сценария, а токен — как Authorization: Bearer <token>, заголовок X-Echolot-Token или ?token= в URL. Входные данные сценария берутся из запроса и из тела JSON; вход с именем body получает всё тело. Ответ — результат сценария в виде JSON, 500 с ошибкой, если сценарий завершился ошибкой, 401 без правильного токена и 404 со списком существующих путей для пути, которого нет ни у одного сценария.

curl -X POST http://127.0.0.1:4100/order-status \
  -H "Authorization: Bearer $ECHOLOT_WEBHOOK_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"orderId": "ord_7Hk2Lw"}'

Токен — это --token, иначе ECHOLOT_WEBHOOK_TOKEN, иначе новый, который печатает Echolot. Запуск по вебхуку может длиться до двух минут; тело больше 8 МБ отклоняется целиком.

О расписаниях и вебхуках в приложении см. запуск сценариев и триггеры.

Коды выходаCopy Anchor Link