プラグインSDK+ランタイムリファクタリング計画

目標: すべてのメッセージングコネクタが1つの安定したAPIを使うプラグイン(バンドルまたは外部)になること。プラグインがsrc/**から直接インポートしない。すべての依存はSDKまたはランタイム経由。

なぜ今か

  • 現在のコネクタはパターンが混在: コア直接インポート、distのみのブリッジ、カスタムヘルパー。
  • これによりアップグレードが脆くなり、クリーンな外部プラグインサーフェスがブロックされる。

ターゲットアーキテクチャ(2層)

1) プラグインSDK(コンパイル時、安定、公開可能)

スコープ: 型、ヘルパー、設定ユーティリティ。ランタイム状態なし、副作用なし。

2) プラグインランタイム(実行サーフェス、注入)

スコープ: コアランタイム動作に触れるすべて。OpenClawPluginApi.runtime経由でアクセスし、プラグインがsrc/**をインポートしない。

移行計画(段階的、安全)

フェーズ0〜5: SDKスキャフォールディング → ブリッジクリーンアップ → 軽量プラグイン → 重量プラグイン → iMessageプラグイン化 → 強制。

成功基準

  • すべてのチャンネルコネクタがSDK+ランタイムを使用するプラグイン。
  • extensions/**からsrc/**へのインポートなし。
  • 新しいコネクタテンプレートがSDK+ランタイムのみに依存。
  • 外部プラグインがコアソースアクセスなしで開発・更新可能。

関連ドキュメント: プラグインチャンネル設定