return stored?.takeIf { it.isNotEmpty() }

}

/** Saves the paired gateway token under the current Android instance id. */

fun saveGatewayToken(token: String) {

val key = "gateway.token.${_instanceId.value}"

securePrefs.edit { putString(key, token.trim()) }

}

/** Loads the bootstrap token used during gateway setup and device-token handoff. */

fun loadGatewayBootstrapToken(): String? {

val key = "gateway.bootstrapToken.${_instanceId.value}"

return if (!trimmed.isNullOrEmpty()) trimmed else "main"

}

/** Accepts only gateway session keys that can represent the main chat stream. */

internal fun isCanonicalMainSessionKey(raw: String?): Boolean {

val trimmed = raw?.trim().orEmpty()

if (trimmed.isEmpty()) return false

if (trimmed == "global") return true

return trimmed.startsWith("agent:")

}

/** Extracts the agent id from canonical agent-scoped main session keys. */

internal fun resolveAgentIdFromMainSessionKey(raw: String?): String? {

val trimmed = raw?.trim().orEmpty()

currentConnection?.closeQuietly()

}

fun currentCanvasHostUrl(): String? = pluginSurfaceUrls["canvas"]

/** Refreshes the canvas plugin surface URL and caches the normalized Android-reachable URL. */

suspend fun refreshCanvasHostUrl(timeoutMs: Long = 8_000): String? {

val refreshed =

refreshPluginSurfaceUrl(

method = "node.pluginSurface.refresh",

params = buildJsonObject { put("surface", JsonPrimitive("canvas")) },

timeoutMs = timeoutMs,

)

if (!refreshed.isNullOrBlank()) {

pluginSurfaceUrls = pluginSurfaceUrls + ("canvas" to refreshed)

}

return refreshed

}

fun currentMainSessionKey(): String? = mainSessionKey

/** Sends a best-effort node.event and returns false instead of throwing on failure. */

suspend fun sendNodeEvent(

event: String,

fun currentUrl(): String? = url

fun isDefaultCanvas(): Boolean = url == null

fun setDebugStatusEnabled(enabled: Boolean) {

debugStatusEnabled = enabled

applyDebugStatus()

}

}

suspend fun snapshotPngBase64(maxWidth: Int?): String =

withContext(Dispatchers.Main) {

val wv = webView ?: throw IllegalStateException("no webview")

val bmp = wv.captureBitmap()

try {

val scaled = bmp.scaleForMaxWidth(maxWidth)

try {

val out = ByteArrayOutputStream()

scaled.compress(Bitmap.CompressFormat.PNG, 100, out)

Base64.encodeToString(out.toByteArray(), Base64.NO_WRAP)

} finally {

if (scaled !== bmp) scaled.recycle()

}

} finally {

bmp.recycle()

}

}

/** Captures the WebView as PNG/JPEG base64 with optional width and quality bounds. */

suspend fun snapshotBase64(

format: SnapshotFormat,

// Light mode keeps overlays away from pure-white glare on the app canvas.

return if (isDark) base else base.copy(alpha = 0.88f)

}

/**

* Overlay icon token kept next to overlayContainerColor for callers outside the design package.

*/

@Composable

fun overlayIconColor(): Color = MaterialTheme.colorScheme.onSurfaceVariant

disabledContentColor = Color.White.copy(alpha = 0.9f),

)

/** Destructive button colors for permission and capability settings actions. */

@Composable

private fun settingsDangerButtonColors() =

ButtonDefaults.buttonColors(

containerColor = mobileDanger,

contentColor = Color.White,

disabledContainerColor = mobileDanger.copy(alpha = 0.45f),

disabledContentColor = Color.White.copy(alpha = 0.9f),

)

/** Opens this app's Android settings page for permissions that require system UI. */

private fun openAppSettings(context: Context) {

val intent =