RECOVER — Decide Safely After a Failed Machine Action

RECOVER

マシン操作に失敗しました。次に何をすべきでしょうか？

RECOVER は、AI エージェント、MCP クライアント、自動化システム、一般的なバックエンドシステム向けの、小規模で決定論的な意思決定 API です。失敗のコンテキストを、次の 6 つのアクションのいずれかに変換します。

RETRY_NOW · WAIT · REPAIR_REQUEST · VERIFY_FIRST · ESCALATE · ABORT

API／ツール／操作の失敗直後、自動リトライの前に使用してください。特に、副作用を伴う操作、タイムアウトが曖昧な場合、レート制限、不正なリクエスト、リトライ予算の使い切り、実行結果が不確かな場合に有効です。

本番環境

ベース URL：https://recover-api-production-bbba.up.railway.app

MCP Streamable HTTP エンドポイント：https://recover-api-production-bbba.up.railway.app/mcp

アクティビティダッシュボード：https://recover-api-production-bbba.up.railway.app/activity

安全なデモ：https://recover-api-production-bbba.up.railway.app/demo

REST

POST https://recover-api-production-bbba.up.railway.app/v1/recover

{
  "method":"POST",
  "status":503,
  "error":"upstream timeout",
  "attempt":1,
  "sideEffect":true,
  "idempotencyKey":false
}

レスポンスの例：

{
  "decision":"VERIFY_FIRST",
  "retry":false,
  "risk":"high",
  "reason":"A side-effecting non-idempotent action may have completed before the failure became visible.",
  "next":"Verify external state or obtain an idempotency key before retrying."
}

MCP

ツール：recover_decide

次の URL を MCP クライアントに指定します。

https://recover-api-production-bbba.up.railway.app/mcp

このサーバーはマシンによる検出を想定して設計されており、公式 MCP Registry 向けの server.json メタデータを含みます。

RECOVER を呼び出す理由

リトライライブラリが答えるのは、どのようにリトライするかです。RECOVER がまず答えるのは、より重要な問い、つまりこの特定の失敗の後に取るべき、最も安全な次のアクションは何かです。

適切な呼び出し元には、API クライアント、AI エージェント、ブラウザー自動化、ワークフローエンジン、MCP ホスト、ジョブランナー、決済／注文フローのほか、無条件のリトライによって副作用が重複したり、障害が拡大したりする可能性のあるあらゆるシステムが含まれます。

分析

GET /activity では、永続的でプライバシーに配慮した利用状況テレメトリーと、恒久的な 実世界で初めて利用した外部ユーザー 10 人のスコアボードを確認できます。実利用イベントは別に保存されるため、検出目的のトラフィックによってマイルストーンが履歴から押し出されることはありません。生の IP アドレスやリクエストペイロードは保存されません。

デプロイ

このリポジトリは Dockerfile と railway.toml を備えており、Railway ですぐに利用できます。再起動後も実利用の永久台帳を保持できるよう、/data に永続ボリュームをマウントしてください。