pi-rpc-sdk

Pi RPC と SDK の統合

根拠資料

1. pi-mono/packages/coding-agent/docs/rpc.md — フレーミングセクション（レコード区切り文字は LF のみ。U+2028/U+2029 による readline との非互換性）。
2. pi-mono/packages/coding-agent/docs/sdk.md — プログラムによるセッションのパターンと、createAgentSession、AgentSession、createAgentSessionRuntime、ModelRegistry.create()、AuthStorage.create()、SessionManager.inMemory()。
3. pi-mono/packages/coding-agent/docs/json.md — --mode json のイベントストリーム：セッションヘッダー、agent_*／turn_*／message_*／tool_execution_* イベント、jq によるフィルタリング例。
4. pi-mono/packages/coding-agent/src/modes/rpc/rpc-client.ts — 該当する場合、rpc.md の導入部で言及されている参考用 TypeScript クライアント。
5. pi-mono/packages/coding-agent/src/core/agent-session.ts — プロセス内への組み込みに使用する API（rpc.md の TypeScript ユーザー向け注記を参照）。

不変条件

• フレーミング規則は pi-mono/packages/coding-agent/docs/rpc.md に記載された規範的な内容です。クライアントの実装者に説明する際は、必ず同ファイルに厳密に沿って引用または言い換えてください。
• rpc.md の prompt コマンドに関する 入力の展開 の箇条書きのとおり、スキルコマンドとプロンプトテンプレートは RPC プロンプト用に展開されます。
• --mode json は読み取り専用の監視（stdout のイベント）であり、--mode rpc は双方向の制御（stdin のコマンドと stdout の応答）です。用途は異なりますが、U+2028/U+2029 に関するフレーミング上の注意点は共通です。
• TypeScript／Node でプロセス内に組み込む場合は、createAgentSession() が主要なファクトリーです。sessionManager、authStorage、modelRegistry が必要です。高度なマルチセッションのホスティングには、agent、sessionManager、settingsManager、modelRegistry、extensions、bashExecutor、resourceLoader への低レベルアクセスを提供する AgentSessionRuntime を返す createAgentSessionRuntime() を使用してください — pi-mono/packages/coding-agent/docs/sdk.md。

ワークフロー

• 統合方法の選択：ユーザーが Node／TS を使用している場合は、サブプロセスより AgentSession を優先するという rpc.md の推奨を案内し、ファイル冒頭の Node.js／TypeScript ユーザー向け注記を参照してください。
• フレーミングのデバッグ：フレーミングセクションを読み直してください。一般的な行読み取り機能を準拠した方法として提案しないでください。
• JSON イベントストリーム：エージェントの動作を読み取り専用で監視する場合は json.md（--mode json）を、双方向で制御する場合は rpc.md（--mode rpc）を案内してください。
• プロセス内への組み込み：サブプロセスによる分離が不要な TypeScript／Node ユーザーには、--mode rpc より createAgentSession() を優先してください。@mariozechner/pi-coding-agent からインポートします。pi-mono/packages/coding-agent/docs/sdk.md と pi-mono/packages/coding-agent/examples/sdk/ を参照してください。

アンチパターン

• rpc.md の区切り文字の動作に反する説明は避けてください（レコード区切り文字は \n のみ。入力時には任意で \r を除去します）。