chore(worker): align pinned workers types with partyserver peer #252

Codex Luna

目的

worker の @cloudflare/workers-types の明示 pin を、partyserver の宣言を満たす最小の 4.x 版 4.20260424.1 に揃える。全ツリーの pin/override と現在の Worker 動作を維持し、依存の宣言と実解決の不一致を解消する。

前提と実測

#250 / #251 当時は agents 0.19.0 配下の partyserver 0.5.10 が ^4.20260424.1 || ^5.20260703.1 を宣言し、worker の pin 4.20260404.1 が範囲を下回っていた。この issue は当初その観測メモだった。pin は新しい binding 型による破壊を防ぐためのものであり、撤去する判断ではない。

2026-10-29、main cf2ad01 の現行は agents 0.20.1、nested partyserver 0.5.10、workers-types 4.20260404.1 の単一コピー。専用 worktree で以下を測定した。

• 現行 pin: npm ci と npm run typecheck が成功、型エラー0件。
• 最小候補の exact 4.20260424.1: npm install 後の typecheck が成功、型エラー0件。全ツリーで同版の単一コピーとなり、partyserver の宣言を満たした。
• ソース、tsconfig、cast、抑止コメントの修正は不要だった。既存の skipLibCheck 設定は変更していない。
• 測定環境: Windows / Node 24.22.1 / npm 11.19.1 / TypeScript 5.9.3。test/build は実装後の検証に含める。

要件と制約

• worker/package.json の exact pin を 4.20260424.1 に変更し、全ツリーを同版にする既存 override を保持する。最新版全般への追従、pin 撤去、5.x 移行は行わない。
• lockfile は対象版の解決に必要な最小差分に限定し、agents / MCP / Wrangler 等を合わせて更新しない。
• overrides の説明を、現在は partyserver の peer 宣言を満たすことと、無制限な型更新を避ける pin の意図が伝わる内容へ修正する。
• Worker の実行コードや認証・保存・MCP 動作を変えず、型の抑止・tsconfig 緩和で検証を通さない。
• npm ci、型検査、dry-run bundle、既存の unit/contract/DO テストを通し、最終 head のCIを確認する。本番 deploy・release は含めない。

対象ファイル

• worker/package.json
• worker/package-lock.json
• 同じ pin の現在値を説明する現存文書があれば、検索して必要な箇所のみ更新する。履歴の記載は履歴として保つ。

完了条件

宣言を満たす単一の exact pin と override、正確な説明、最小差分がPRに入り、検証と親レビューを通ってマージされること。

— Luna