feat(#1292): plugin settings/diagnostics and persisted edit previews (#1304)

app/src/main/java/com/m57/hermescontrol/data/ws/PluginManageModels.kt

@@ -0,0 +1,102 @@
+package com.m57.hermescontrol.data.ws
+
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+import kotlinx.serialization.json.JsonElement
+
+@Serializable
+enum class PluginSettingFieldType {
+    @SerialName("string")
+    STRING,
+
+    @SerialName("number")
+    NUMBER,
+
+    @SerialName("boolean")
+    BOOLEAN,
+
+    @SerialName("enum")
+    ENUM,
+
+    @SerialName("secret")
+    SECRET,
+
+    @SerialName("json")
+    JSON,
+}
+
+@Serializable
+data class PluginSettingField(
+    val key: String,
+    val type: PluginSettingFieldType,
+    val label: String,
+    val description: String = "",
+    val required: Boolean = false,
+    val value: JsonElement? = null,
+    val default: JsonElement? = null,
+    val choices: List<String>? = null,
+    val env: String? = null,
+    @SerialName("has_value") val hasValue: Boolean? = null,
+)
+
+@Serializable
+enum class PluginServerState {
+    @SerialName("connected")
+    CONNECTED,
+
+    @SerialName("app_not_running")
+    APP_NOT_RUNNING,
+
+    @SerialName("endpoint_unavailable")
+    ENDPOINT_UNAVAILABLE,
+
+    @SerialName("no_interactive_session")
+    NO_INTERACTIVE_SESSION,
+
+    @SerialName("version_too_old")
+    VERSION_TOO_OLD,
+
+    @SerialName("missing_app")
+    MISSING_APP,
+
+    @SerialName("unknown")
+    UNKNOWN,
+}
+
+@Serializable
+data class PluginServerRow(
+    val name: String,
+    val state: PluginServerState,
+    val sentence: String = "",
+)
+
+@Serializable
+data class AgentPluginRow(
+    val name: String,
+    val key: String? = null,
+    val version: String = "",
+    val description: String = "",
+    val source: String = "",
+    val status: String = "",
+    val portable: Boolean = false,
+    @SerialName("install_dir") val installDir: String = "",
+    @SerialName("has_desktop_half") val hasDesktopHalf: Boolean = false,
+    val servers: List<PluginServerRow> = emptyList(),
+    @SerialName("settings_schema") val settingsSchema: List<PluginSettingField>? = null,
+    @SerialName("catalog_name") val catalogName: String? = null,
+    @SerialName("catalog_tier") val catalogTier: String? = null,
+    @SerialName("installed_sha") val installedSha: String? = null,
+    @SerialName("catalog_sha") val catalogSha: String? = null,
+    @SerialName("catalog_version") val catalogVersion: String? = null,
+    @SerialName("update_available") val updateAvailable: Boolean? = null,
+    @SerialName("pinned_sha") val pinnedSha: String? = null,
+)
+
+@Serializable
+data class PluginsManageSettingsResult(
+    val ok: Boolean = false,
+    val name: String? = null,
+    val written: List<String>? = null,
+    val plugin: AgentPluginRow? = null,
+    val error: String? = null,
+)

app/src/main/java/com/m57/hermescontrol/data/ws/PluginManageRepository.kt

@@ -0,0 +1,52 @@
+package com.m57.hermescontrol.data.ws
+
+import com.m57.hermescontrol.data.remote.OkHttpProvider
+import kotlinx.coroutines.CancellationException
+import kotlinx.serialization.json.Json
+import kotlinx.serialization.json.JsonElement
+import kotlinx.serialization.json.JsonObject
+import kotlinx.serialization.json.decodeFromJsonElement
+
+/**
+ * Manages plugin settings and inspection through the gateway's canonical `plugins.manage` RPC.
+ */
+class PluginManageRepository(
+    private val rpcRequest: suspend (String, Map<String, Any?>) -> Any? = { method, params ->
+        val deferred = HermesWsClient.request(method, params.filterValues { it != null }.mapValues { it.value ?: "" })
+        try {
+            deferred.await()
+        } catch (e: CancellationException) {
+            deferred.cancel(e)
+            throw e
+        }
+    },
+) {
+    suspend fun listPlugins(profile: String? = null): List<AgentPluginRow> {
+        val params = mutableMapOf<String, Any?>("action" to "list")
+        if (!profile.isNullOrBlank()) {
+            params["profile"] = profile
+        }
+        val result = rpcRequest(WsMethods.PLUGINS_MANAGE, params)
+        val element = result.toJsonElement()
+        val pluginsElement = (element as? JsonObject)?.get("plugins") ?: return emptyList()
+        return OkHttpProvider.json.decodeFromJsonElement<List<AgentPluginRow>>(pluginsElement)
+    }
+
+    suspend fun saveSettings(
+        key: String,
+        values: Map<String, JsonElement>,
+        profile: String? = null,
+    ): PluginsManageSettingsResult {
+        val params =
+            mutableMapOf<String, Any?>(
+                "action" to "settings",
+                "key" to key,
+                "values" to JsonObject(values),
+            )
+        if (!profile.isNullOrBlank()) {
+            params["profile"] = profile
+        }
+        val result = rpcRequest(WsMethods.PLUGINS_MANAGE, params)
+        return OkHttpProvider.json.decodeFromJsonElement<PluginsManageSettingsResult>(result.toJsonElement())
+    }
+}