//! JSON-RPC 2.0 / MCP / LSP の共通メッセージ型(T028)。
//! 参照: contracts/zed-ide-bridge.md
//!
//! LSP(stdio)と MCP(WebSocket)はどちらも JSON-RPC 2.0 を使うため共通化する。
use serde::Deserialize;
use serde_json::Value;
/// MCP プロトコルバージョン。対象 Claude Code CLI と要整合(research R3 のリスク)。
/// 接続時に相手の protocolVersion をエコーする方針なので既定値は新しめにしておく。
pub const MCP_PROTOCOL_VERSION: &str = "2025-03-26";
pub const MCP_PROTOCOL_FALLBACK: &str = "2024-11-05";
/// 受信した JSON-RPC メッセージ(リクエスト/通知/レスポンス兼用)。
#[derive(Debug, Deserialize)]
pub struct RpcMessage {
#[allow(dead_code)]
pub jsonrpc: Option<String>,
/// リクエスト/レスポンスには id がある。通知には無い。
#[serde(default)]
pub id: Option<Value>,
/// メソッド名(リクエスト/通知)。
#[serde(default)]
pub method: Option<String>,
/// パラメータ。
#[serde(default)]
pub params: Option<Value>,
}
/// 成功レスポンスを組み立てる。
pub fn rpc_result(id: Value, result: Value) -> Value {
serde_json::json!({
"jsonrpc": "2.0",
"id": id,
"result": result,
})
}
/// エラーレスポンスを組み立てる。
pub fn rpc_error(id: Value, code: i64, message: &str) -> Value {
serde_json::json!({
"jsonrpc": "2.0",
"id": id,
"error": { "code": code, "message": message },
})
}
/// 通知(id 無し)を組み立てる。
pub fn rpc_notification(method: &str, params: Value) -> Value {
serde_json::json!({
"jsonrpc": "2.0",
"method": method,
"params": params,
})
}
/// MCP tools/call の結果は content 配列(text)で返す慣習に従う。
pub fn mcp_text_content(value: &Value) -> Value {
let text = serde_json::to_string(value).unwrap_or_else(|_| "{}".to_string());
serde_json::json!({
"content": [ { "type": "text", "text": text } ],
"isError": false,
})
}