ワークフローとトリガー

{
  "slug": "research_brief",
  "title": "Research brief",
  "description": "Search the web for a topic and read the top result.",
  "inputSchema": {
    "type": "object",
    "properties": { "topic": { "type": "string" } },
    "required": ["topic"]
  },
  "steps": [
    { "id": "search", "tool": "web_search",
      "arguments": { "query": { "$input": "topic" } } },
    { "id": "read", "tool": "scrape_page",
      "arguments": { "url": { "$step": "search", "path": "/results/0/url" } } }
  ]
}

curl "$RELVO_API_URL/v1/workflows" \
  -H "Authorization: Bearer $RELVO_API_KEY" \
  -H "Content-Type: application/json" \
  --data @workflow.json

curl "$RELVO_API_URL/v1/workflows/research_brief/runs" \
  -H "Authorization: Bearer $RELVO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: research-brief-001" \
  --data '{"inputs":{"topic":"content marketing"},"maximumChargeMicros":200000}'

{
  "kind": "poll",
  "tool": "github__issues_list_for_repo",
  "arguments": { "owner": "octo", "repo": "app" },
  "connectionId": "CONNECTION_ID",
  "interval": "5m",
  "destinations": [{ "kind": "webhook", "url": "https://YOUR_SERVER/relvo/events" }]
}

curl "$RELVO_API_URL/v1/triggers" \
  -H "Authorization: Bearer $RELVO_API_KEY" \
  -H "Content-Type: application/json" \
  --data @trigger.json

webhook
  イベントごとに、署名付きのJSONをHTTPSのURLにPOSTします。

workflow
  イベントごとにワークフローを1回実行します。イベントは入力eventに入り、maximumChargeMicrosが1回の予算です。

slack / discord
  新しいイベント最大10件の要約とアプリへのリンクを、受信WebhookのURLに送ります。

email
  チームメンバーに要約を送ります。アプリからだけ追加できます。

import { createHmac, timingSafeEqual } from "node:crypto";

// rawBody is the request body exactly as received, before JSON parsing.
export function verifyRelvoSignature(header, rawBody, secret, toleranceSeconds = 300) {
  const parts = Object.fromEntries(header.split(",").map(part => part.split("=", 2)));
  const timestamp = Number(parts.t);
  const age = Math.abs(Date.now() / 1000 - timestamp);
  if (!Number.isInteger(timestamp) || age > toleranceSeconds) return false;
  const expected = createHmac("sha256", secret).update(`${parts.t}.${rawBody}`).digest();
  const received = Buffer.from(parts.v1 ?? "", "hex");
  return received.length === expected.length && timingSafeEqual(received, expected);
}

GET  /v1/workflows · tools:read
  ワークフローの一覧

POST /v1/workflows · tools:execute
  新しいワークフローを保存

GET  /v1/workflows/{slug} · tools:read
  ワークフローを1つ読む

POST /v1/workflows/{slug}/update · tools:execute
  新しいバージョンとして置き換える（expectedVersionを送る）

POST /v1/workflows/{slug}/delete · tools:execute
  削除する

POST /v1/workflows/{slug}/runs · tools:execute
  実行を開始

GET  /v1/workflow-runs/{id} · executions:read
  実行を1つ読む

POST /v1/workflow-runs/{id}/cancel · tools:execute
  実行をキャンセル

GET  /v1/trigger-types?app={app} · tools:read
  アプリのWebhook種別とポーリングできる操作

GET  /v1/triggers · executions:read
  トリガーの一覧

POST /v1/triggers · tools:execute
  トリガーを作成

POST /v1/triggers/{id}/update · tools:execute
  有効化・無効化・名前の変更

POST /v1/triggers/{id}/delete · tools:execute
  削除する

POST /v1/triggers/{id}/destinations · tools:execute
  届け先を追加

GET  /v1/triggers/{id}/events · executions:read
  1つのトリガーのイベント

GET  /v1/trigger-events · executions:read
  全トリガーのイベント

POST /v1/monitors/quote · tools:read
  作成せずに料金を見積もる

GET  /v1/monitors · executions:read
  監視の一覧

POST /v1/monitors · tools:execute
  監視を作成

POST /v1/monitors/{id}/resume · tools:execute
  一時停止した監視を再開

POST /v1/monitors/{id}/delete · tools:execute
  削除する

GET  /v1/monitor-events · executions:read
  全監視のイベント