プラグインSDK+ランタイムリファクタリング計画
目標: すべてのメッセージングコネクタが1つの安定したAPIを使うプラグイン(バンドルまたは外部)になること。プラグインがsrc/**から直接インポートしない。すべての依存はSDKまたはランタイム経由。
なぜ今か
- 現在のコネクタはパターンが混在: コア直接インポート、distのみのブリッジ、カスタムヘルパー。
- これによりアップグレードが脆くなり、クリーンな外部プラグインサーフェスがブロックされる。
ターゲットアーキテクチャ(2層)
1) プラグインSDK(コンパイル時、安定、公開可能)
スコープ: 型、ヘルパー、設定ユーティリティ。ランタイム状態なし、副作用なし。
2) プラグインランタイム(実行サーフェス、注入)
スコープ: コアランタイム動作に触れるすべて。OpenClawPluginApi.runtime経由でアクセスし、プラグインがsrc/**をインポートしない。
移行計画(段階的、安全)
フェーズ0〜5: SDKスキャフォールディング → ブリッジクリーンアップ → 軽量プラグイン → 重量プラグイン → iMessageプラグイン化 → 強制。
成功基準
- すべてのチャンネルコネクタがSDK+ランタイムを使用するプラグイン。
extensions/**からsrc/**へのインポートなし。- 新しいコネクタテンプレートがSDK+ランタイムのみに依存。
- 外部プラグインがコアソースアクセスなしで開発・更新可能。