Skip to content

chore(deps): bump agents to 0.19.0 in worker, the last beta-free line #250

Description

@liplus-lin-lay

目的

workeragents を 0.8 系 → 0.19.0 へ引き上げ、SDK v2 beta を踏まずに依存 drift を解消する。挙動は現状維持。

前提

  • 現状 = worker/package.jsonagents: ^0.8.0 + @modelcontextprotocol/sdk: 1.26.0(pin)。worker/package-lock.json の実解決は agents 0.8.2 / sdk 1.26.0 / @cloudflare/workers-types 4.20260404.1
  • sdk を pin している理由は既存コメント参照(agents が内包する版と worker 直下の版が二重化すると McpServer の private _serverInfo が型レベルで衝突するため)
  • agents@0.19.0dependencies@modelcontextprotocol/sdk@1.29.0 のみ。beta peer なし、@modelcontextprotocol/client / /server の静的 import なし
  • agents@0.20.0 から v2 beta(client / server 2.0.0-beta.5)が非 optional な必須 peerになり、dist/mcp/index.js が静的 import する。よって 0.19.0 が beta を踏まない最終版
  • 0.19.0 時点で McpAgent は export 継続、deprecated マーカーなし(0.20.1 で feature-frozen 化)

姉妹リポジトリでの先行実施から持ち込む知見

Liplus-Project/github-rag-mcp#225 / #226 で同じ引き上げを完了済み(merge 済み、実機確認通過)。そこで実際に踏んだものを以下に引き渡す。

  1. SDK の単一コピー化で @ts-expect-error が不要になり、TS2578(unused directive)で落ちる。 rag-mcp では src/mcp.ts の抑止コメントがこれに該当した。本 repo も同型の pin 理由を持つため、worker/src/agent.ts 周辺に同じことが起きる可能性が高い。抑止が不要になったら削除する(再抑止しない)
  2. ^0.19.0 は 0.x semantics で >=0.19.0 <0.20.0 に解決される。 beta 境界がレンジ自体に封じ込められるので、この書き方を選ぶこと
  3. @cloudflare/workers-types の pin は lock 実読で前後比較して確認する。 rag-mcp では引き上げ前後とも 4.20260404.1 単一コピーで保持された
  4. 抑止削除の跡地にコメントを残す場合、時制と事実を実測に合わせること。 rag-mcp では「SDK が 1.30.0 を公開したら型エラーが戻る」と未来形で書いたが 1.30.0 は 2026-07-27 に公開済みで、トラップは既に arm されており committed lockfile だけが押さえている状態だった。同種の記述をする場合は npm view で現況を確認してから書く

制約

  • 挙動変更を伴わないことWebhookMcpAgent.serve("/mcp") の構成を維持する
  • sdk の pin 版が 1.26.0 → 1.29.0 へ動くため、既存 overrides コメントの前提が変わる。単一コピー維持の意図は保ったまま、版と理由を更新すること
  • @cloudflare/workers-types の pin を壊さないこと
  • ステートレス移行は spec: MCP 2026-07-28 migration plan - single-lane flip, no dual-lane fallback #249 の範囲。本 issue では触らない
  • mcp-server/ および local-mcp/ には触らない。本 issue は worker 側のみ

対象ファイル

  • worker/package.json — agents / sdk のバージョン指定と overrides コメント
  • worker/package-lock.json
  • worker/src/agent.ts / worker/src/index.ts — 型エラーが出た場合のみ

関連

Metadata

Metadata

Assignees

No one assigned

    Labels

    done完了・マージ済み。追跡用に保持enhancementNew feature or requestreadybody converged for implementation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions