memo(worker): the workers-types pin now sits below the range partyserver declares

[liplus-lin-lay]

観測

#250 / #251 で agents を 0.19.0 へ引き上げた際、worker/package-lock.json を実読して以下を確認した。

agents@0.19.0 が nest する partyserver@0.5.10 の peerDependencies:

"@cloudflare/workers-types": "^4.20260424.1 || ^5.20260703.1"

一方 worker/package.json が pin している版は 4.20260404.1。この宣言レンジを満たさない。

overrides の "@cloudflare/workers-types": "$@cloudflare/workers-types" が勝つため、ツリーには 4.20260404.1 が単一コピーで入る。npm ci は通り、typecheck / wrangler deploy --dry-run / test はすべて green。@cloudflare/workers-types は型専用の devDependency なので runtime への影響も無い。

なぜ memo として残すのか

pin が transitive の宣言レンジを下回っている状態は、lockfile を実読しない限り見えない。今後の保守で次のいずれかが起きたときに、この事実を知らないと判断を誤る:

• npm のバージョンが上がって override 下の peer 不整合の扱いが厳しくなる
• partyserver が新しい workers-types の型に実際に依存するコードを出す（現状の型検査は通っているので今は無い）
• pin を上げようとしたときに「なぜ 4.20260404.1 なのか」の理由が失われている

pin 自体は本 repo family の既知トラップ（toolchain の bump が transitive に workers-types を持ち上げ、厳格化された binding 型が既存 worker source を型レベルで壊す）への対抗として load-bearing であり、外す判断ではない。

想定される選択肢（結論は出していない）

1. 現状維持。pin は効いており、型検査も build も通っている。lockfile が resolution を押さえている
2. worker/src を新しい workers-types の binding 型に追従させた上で pin を ^4.20260424.1 系へ引き上げる。トラップの本体（既存 src が型レベルで壊れる）に正面から対処する形
3. worker/package.json の overrides コメントに partyserver の宣言レンジとの乖離を明記して、観測結果だけ残す

どれを取るかは、worker/src が新しい binding 型でどれだけ壊れるかの実測を見てから決めるのが筋。実測前に方針を決めない。

前提

• 現状 = pin 4.20260404.1、単一コピー、CI green
• 本 issue は観測の記録であり、即時対応を要求しない
• chore(deps): bump agents to 0.19.0 in worker, the last beta-free line #250 / chore(deps): bump worker agents to 0.19.0, the last line before the MCP SDK v2 beta peers #251 の範囲では扱わなかった（挙動変更を伴わないという制約に反するため）

関連

• chore(deps): bump agents to 0.19.0 in worker, the last beta-free line #250 — agents 0.19.0 への引き上げ
• chore(deps): bump worker agents to 0.19.0, the last line before the MCP SDK v2 beta peers #251 — その PR