個人で回している作業看板で、「任せる」を押してから作業AIが動き始めるまで、平均で約30秒かかっていました。既存の認証もポーリングも変えずにWebSocket通知だけを足し、押した直後の1秒未満で動くようにした記録です。
看板には「仕事を任せる」ボタンがあり、押すとVPSにいる作業AI(拾い手)が仕事を取りに来ます。従来はcronで1分ごとに見に行くだけで、押してから動くまで平均約30秒、最悪60秒待ちでした。
即時化にあたり、守る条件を決めました。認証はBearerトークン一本のまま。前段のCloudflare Accessの設定も変えない。ポーリングは消さず、通知はあくまでヒントとして、切れても従来どおり拾える。鍵ファイル、日次の実行上限、STOPファイル、二重起動防止のlockも全部そのままです。
新しい監視用エンドポイントを作ると、認証とAccessの設定をそちらにも揃える必要が出ます。そこで、認証ライブラリがAPIのパスの配下も同じ保護リソースとして扱うことに着目しました。MCPのURLにGETとUpgradeのヘッダを投げれば、既存の認証・Accessのバイパス・鍵の監査がそのまま効くWebSocket経路になります。
看板本体のDurable Objectは、Hibernation WebSocket APIで受けます。誰が待っているかはメモリではなくソケットの付属情報に持ち、通知のたびに「いま仕事が待っている宛先」をSQLiteに聞き直します。拾い手側は新しい--watchモードを足しただけで、合図を受けたら既存のpassを1回呼びます。通知専用の拾い方は作りません。
本番で測ると、wakeが1回のはずなのに300msで4回連鎖しました。原因は「tool呼び出しのあとに全部通知を評価する」設計です。起きた拾い手のpassが看板を呼ぶと、その呼び出しでまた通知が評価され、拾えない仕事が残っているかぎり自分のpassが自分を再び起こしていました。
対処は、同じ待ち状態では1度送ったら二度と送らないという重複排除です。ソケットに送信済みの印を持たせ、待ちが解消したら戻します。試験にも、再送されないことと、再依頼で再びwakeすることを足しました。
本番では、handoffを書き込んでからwake passが始まるまで191ms、画面の「任せる」から受付開始まで1秒未満でした。デプロイでDurable Objectが再起動してソケットが切れた間も、60秒ごとのpollは走り続け、フォールバックが本番で働くことも確かめられました。STOP・日次上限・lockは何も変わりません。
認証したいAPIと同じパスへのUpgradeにすると経路を増やさずに済み、通知はヒントとして正本のpollを残す。この二つで、戻すときも常駐プロセスを止めて旧版をデプロイするだけです。細かいコードと手順は全文にあります。
コードの抜粋、拾い手側の実装、計測の詳細は、Qiitaの全文にまとめています。