feat(plugins): dynamic toolbar icons, mic permission, and API dump

Add ToolbarAction.iconProvider and IdeUIService.refreshToolbarActions so plugins can drive state-based animated toolbar icons; declare RECORD_AUDIO for voice plugins. Collapse the duplicate editor renderer overrides into a single GhostTextRenderer that extends TracingEditorRenderer (keeps the ADFA-2468 block-line data-race guard), and regenerate the plugin-api golden file so apiCheck passes.

Author: jatezzz

app/src/main/AndroidManifest.xml

@@ -26,6 +26,10 @@
     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
     <uses-permission android:name="android.permission.CAMERA" />
+    <!-- Required so voice/speech plugins (e.g. speech-to-text) can record audio. Plugins run
+         under this app's UID, so the runtime permission must be declared here — a plugin
+         manifest's uses-permission is not merged into the host APK. -->
+    <uses-permission android:name="android.permission.RECORD_AUDIO" />
     <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
     <uses-permission

app/src/main/java/com/itsaky/androidide/actions/PluginToolbarActionItem.kt

@@ -21,7 +21,7 @@ import com.itsaky.androidide.plugins.manager.ui.PluginDrawableResolver
  * so the toolbar fully removes it (instead of greying it) when not applicable.
  */
 class PluginToolbarActionItem(
-    context: Context,
+    private val context: Context,
     private val toolbarAction: ToolbarAction,
     val pluginId: String
 ) : EditorActivityAction() {
@@ -55,6 +55,13 @@ class PluginToolbarActionItem(
         runCatching {
             enabled = toolbarAction.isEnabledProvider?.invoke() ?: toolbarAction.isEnabled
             visible = toolbarAction.isVisibleProvider?.invoke() ?: toolbarAction.isVisible
+            // Re-resolve the icon on every rebuild when the plugin drives it dynamically.
+            // When iconProvider is null the icon stays as resolved in init (static behavior).
+            if (visible) {
+                toolbarAction.iconProvider?.invoke()?.let { resId ->
+                    PluginDrawableResolver.resolve(resId, pluginId, context)?.let { icon = it }
+                }
+            }
         }.onFailure { e ->
             // A throwing/disposed plugin must never keep a stale icon on the toolbar.
             Log.w("PluginToolbarActionItem", "prepare failed for '${toolbarAction.id}'", e)

app/src/main/java/com/itsaky/androidide/activities/editor/EditorHandlerActivity.kt

@@ -80,6 +80,7 @@ import com.itsaky.androidide.plugins.manager.fragment.PluginFragmentFactory
 import com.itsaky.androidide.preferences.internal.EditorPreferences
 import com.itsaky.androidide.plugins.manager.ui.PluginDrawableResolver
 import com.itsaky.androidide.plugins.manager.ui.PluginEditorTabManager
+import com.itsaky.androidide.plugins.manager.ui.PluginToolbarHost
 import com.itsaky.androidide.plugins.manager.ui.PluginUiActionManager
 import com.itsaky.androidide.projects.ProjectManagerImpl
 import com.itsaky.androidide.projects.builder.BuildResult
@@ -120,7 +121,8 @@ import com.itsaky.androidide.utils.hasVisibleDialog
  */
 open class EditorHandlerActivity :
 	ProjectHandlerActivity(),
-	IEditorHandler {
+	IEditorHandler,
+	PluginToolbarHost {
 	private val singleBuildListeners = CopyOnWriteArrayList<Consumer<BuildResult>>()
 
 	companion object {
@@ -491,6 +493,15 @@ open class EditorHandlerActivity :
 		}
 	}
 
+	/**
+	 * [PluginToolbarHost] entry point. Lets plugin services (via IdeUIService) request a
+	 * toolbar rebuild so dynamic [com.itsaky.androidide.plugins.extensions.ToolbarAction]
+	 * providers (icon/enabled/visible) are re-evaluated. Marshalled to the UI thread.
+	 */
+	override fun refreshPluginToolbarActions() {
+		runOnUiThread { prepareOptionsMenu() }
+	}
+
 	fun prepareOptionsMenu() {
 		val registry = getInstance() as DefaultActionsRegistry
 		val data = createToolbarActionData()

common/src/main/java/com/itsaky/androidide/ui/ProjectActionsToolbar.kt

@@ -52,6 +52,9 @@ class ProjectActionsToolbar @JvmOverloads constructor(
             }
             contentDescription = hint
             setImageDrawable(icon)
+            // Start animation for animated drawables (e.g. AnimatedVectorDrawable used by a
+            // plugin's dynamic toolbar icon). No-op for ordinary static drawables.
+            (icon as? android.graphics.drawable.Animatable)?.start()
             addCircleRipple()
             // Set layout params for width and height
             layoutParams = LinearLayout.LayoutParams(

editor/src/main/java/com/itsaky/androidide/editor/ui/GhostTextRenderer.kt

@@ -27,11 +27,15 @@ import io.github.rosemoe.sora.widget.EditorRenderer
  * at a fixed anchor position, after the editor's normal content. This backs the host side of the
  * inline-suggestion plugin pipeline (`IdeEditorService.showInlineSuggestion`).
  *
+ * Extends [TracingEditorRenderer] so it inherits the block-line data-race guards (ADFA-2468) while
+ * layering ghost text on top of the normal draw pass — the editor only supports a single renderer,
+ * so the two behaviours have to share one class.
+ *
  * State is mutated from the main thread (via [IDEEditor]); [draw] reads it defensively and must
  * never throw — a bad suggestion or transient layout state can never take the editor's draw pass
  * down with it.
  */
-class GhostTextRenderer(private val editor: CodeEditor) : EditorRenderer(editor) {
+class GhostTextRenderer(private val editor: CodeEditor) : TracingEditorRenderer(editor = editor) {
 
   @Volatile
   private var suggestion: String? = null

editor/src/main/java/com/itsaky/androidide/editor/ui/IDEEditor.kt

@@ -524,12 +524,6 @@ constructor(
     final override fun <T : EditorBuiltinComponent?> getComponent(clazz: Class<T>): T & Any =
         super.getComponent(clazz)
 
-    /** Uses [TracingEditorRenderer], which guards block-line drawing against the
-     * styles.blocks data race that otherwise crashes onDraw. */
-    override fun onCreateRenderer(): EditorRenderer {
-        return TracingEditorRenderer(editor = this)
-    }
-
     override fun release() {
         ensureWindowsDismissed()
 
@@ -976,6 +970,8 @@ constructor(
 
     // --- Inline suggestions (ghost text) ------------------------------------
 
+    /** [GhostTextRenderer] extends [TracingEditorRenderer], so this keeps the block-line
+     * data-race guards while also drawing inline ghost text. */
     override fun onCreateRenderer(): EditorRenderer = GhostTextRenderer(this)
 
     private val ghostRenderer: GhostTextRenderer?

editor/src/main/java/com/itsaky/androidide/editor/ui/TracingEditorRenderer.kt

@@ -39,7 +39,7 @@ import org.slf4j.LoggerFactory
  *
  * @author Akash Yadav
  */
-class TracingEditorRenderer(
+open class TracingEditorRenderer(
   private val enabled: Boolean = BuildConfig.DEBUG,
   editor: CodeEditor
 ) : EditorRenderer(editor) {

plugin-api/api/plugin-api.api

@@ -6,16 +6,25 @@ public abstract interface class com/itsaky/androidide/plugins/IPlugin {
 }
 
 public abstract interface class com/itsaky/androidide/plugins/PluginContext {
+	public abstract fun addPluginLifecycleListener (Lcom/itsaky/androidide/plugins/PluginLifecycleListener;)V
 	public abstract fun getAndroidContext ()Landroid/content/Context;
 	public abstract fun getAppFilesDir ()Ljava/io/File;
+	public abstract fun getAppSharedPreferences (Ljava/lang/String;)Landroid/content/SharedPreferences;
 	public abstract fun getEventBus ()Ljava/lang/Object;
 	public abstract fun getLogger ()Lcom/itsaky/androidide/plugins/PluginLogger;
 	public abstract fun getPluginDataDir ()Ljava/io/File;
 	public abstract fun getPluginFilesDir ()Ljava/io/File;
 	public abstract fun getPluginId ()Ljava/lang/String;
+	public abstract fun getPluginService (Ljava/lang/String;Ljava/lang/Class;)Ljava/lang/Object;
 	public abstract fun getPluginSharedPreferences (Ljava/lang/String;)Landroid/content/SharedPreferences;
+	public abstract fun getPluginVersion (Ljava/lang/String;)Ljava/lang/String;
+	public abstract fun getProvidedServices ()Ljava/util/List;
 	public abstract fun getResources ()Lcom/itsaky/androidide/plugins/ResourceManager;
 	public abstract fun getServices ()Lcom/itsaky/androidide/plugins/ServiceRegistry;
+	public abstract fun isPluginActive (Ljava/lang/String;)Z
+	public abstract fun registerService (Ljava/lang/Class;Ljava/lang/Object;)V
+	public abstract fun removePluginLifecycleListener (Lcom/itsaky/androidide/plugins/PluginLifecycleListener;)V
+	public abstract fun unregisterService (Ljava/lang/Class;)V
 }
 
 public final class com/itsaky/androidide/plugins/PluginInfo {
@@ -36,6 +45,12 @@ public final class com/itsaky/androidide/plugins/PluginInfo {
 	public fun toString ()Ljava/lang/String;
 }
 
+public abstract interface class com/itsaky/androidide/plugins/PluginLifecycleListener {
+	public abstract fun onPluginActivated (Ljava/lang/String;)V
+	public abstract fun onPluginDeactivated (Ljava/lang/String;)V
+	public abstract fun onPluginUninstalled (Ljava/lang/String;)V
+}
+
 public abstract interface class com/itsaky/androidide/plugins/PluginLogger {
 	public abstract fun debug (Ljava/lang/String;)V
 	public abstract fun debug (Ljava/lang/String;Ljava/lang/Throwable;)V
@@ -1053,6 +1068,7 @@ public final class com/itsaky/androidide/plugins/extensions/ToolbarAction {
 	public fun equals (Ljava/lang/Object;)Z
 	public final fun getAction ()Lkotlin/jvm/functions/Function0;
 	public final fun getIcon ()Ljava/lang/Integer;
+	public final fun getIconProvider ()Lkotlin/jvm/functions/Function0;
 	public final fun getId ()Ljava/lang/String;
 	public final fun getOrder ()I
 	public final fun getShowAsAction ()Lcom/itsaky/androidide/plugins/extensions/ShowAsAction;
@@ -1063,6 +1079,7 @@ public final class com/itsaky/androidide/plugins/extensions/ToolbarAction {
 	public final fun isVisible ()Z
 	public final fun isVisibleProvider ()Lkotlin/jvm/functions/Function0;
 	public final fun setEnabledProvider (Lkotlin/jvm/functions/Function0;)V
+	public final fun setIconProvider (Lkotlin/jvm/functions/Function0;)V
 	public final fun setVisibleProvider (Lkotlin/jvm/functions/Function0;)V
 	public fun toString ()Ljava/lang/String;
 }
@@ -1151,6 +1168,10 @@ public final class com/itsaky/androidide/plugins/services/CursorPosition {
 	public fun toString ()Ljava/lang/String;
 }
 
+public abstract interface class com/itsaky/androidide/plugins/services/EditorContentChangeListener {
+	public abstract fun onContentChanged (Ljava/lang/String;IILjava/lang/String;)V
+}
+
 public abstract class com/itsaky/androidide/plugins/services/ExtractResult {
 }
 
@@ -1224,9 +1245,11 @@ public final class com/itsaky/androidide/plugins/services/IdeCommandService$Defa
 }
 
 public abstract interface class com/itsaky/androidide/plugins/services/IdeEditorService {
+	public abstract fun addContentChangeListener (Lcom/itsaky/androidide/plugins/services/EditorContentChangeListener;)V
 	public abstract fun addFileChangeListener (Lcom/itsaky/androidide/plugins/services/FileChangeListener;)V
 	public abstract fun appendToLine (Ljava/io/File;ILjava/lang/String;)Z
 	public abstract fun deleteLine (Ljava/io/File;I)Z
+	public abstract fun dismissInlineSuggestion ()V
 	public abstract fun getCurrentCursorPosition ()Lcom/itsaky/androidide/plugins/services/CursorPosition;
 	public abstract fun getCurrentFile ()Ljava/io/File;
 	public abstract fun getCurrentFileContent ()Ljava/lang/String;
@@ -1248,11 +1271,20 @@ public abstract interface class com/itsaky/androidide/plugins/services/IdeEditor
 	public abstract fun openFile (Ljava/io/File;)Z
 	public abstract fun openFileAt (Ljava/io/File;II)Z
 	public abstract fun prependToLine (Ljava/io/File;ILjava/lang/String;)Z
+	public abstract fun removeContentChangeListener (Lcom/itsaky/androidide/plugins/services/EditorContentChangeListener;)V
 	public abstract fun removeFileChangeListener (Lcom/itsaky/androidide/plugins/services/FileChangeListener;)V
 	public abstract fun replaceLine (Ljava/io/File;ILjava/lang/String;)Z
 	public abstract fun replaceRange (Ljava/io/File;Lcom/itsaky/androidide/plugins/services/SelectionRange;Ljava/lang/String;)Z
 	public abstract fun replaceSelection (Ljava/lang/String;)Z
 	public abstract fun saveCurrentFile ()Z
+	public abstract fun showInlineSuggestion (Ljava/lang/String;)V
+}
+
+public final class com/itsaky/androidide/plugins/services/IdeEditorService$DefaultImpls {
+	public static fun addContentChangeListener (Lcom/itsaky/androidide/plugins/services/IdeEditorService;Lcom/itsaky/androidide/plugins/services/EditorContentChangeListener;)V
+	public static fun dismissInlineSuggestion (Lcom/itsaky/androidide/plugins/services/IdeEditorService;)V
+	public static fun removeContentChangeListener (Lcom/itsaky/androidide/plugins/services/IdeEditorService;Lcom/itsaky/androidide/plugins/services/EditorContentChangeListener;)V
+	public static fun showInlineSuggestion (Lcom/itsaky/androidide/plugins/services/IdeEditorService;Ljava/lang/String;)V
 }
 
 public abstract interface class com/itsaky/androidide/plugins/services/IdeEditorTabService {
@@ -1354,6 +1386,7 @@ public abstract interface class com/itsaky/androidide/plugins/services/IdeUIServ
 	public abstract fun getCurrentActivity ()Landroid/app/Activity;
 	public abstract fun isUIAvailable ()Z
 	public abstract fun openPluginScreen (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)Z
+	public abstract fun refreshToolbarActions ()V
 }
 
 public final class com/itsaky/androidide/plugins/services/IdeUIService$Companion {
@@ -1366,6 +1399,7 @@ public final class com/itsaky/androidide/plugins/services/IdeUIService$Companion
 public final class com/itsaky/androidide/plugins/services/IdeUIService$DefaultImpls {
 	public static fun openPluginScreen (Lcom/itsaky/androidide/plugins/services/IdeUIService;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)Z
 	public static synthetic fun openPluginScreen$default (Lcom/itsaky/androidide/plugins/services/IdeUIService;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;ILjava/lang/Object;)Z
+	public static fun refreshToolbarActions (Lcom/itsaky/androidide/plugins/services/IdeUIService;)V
 }
 
 public abstract interface class com/itsaky/androidide/plugins/services/LlmInferenceService {

plugin-api/src/main/kotlin/com/itsaky/androidide/plugins/extensions/UIExtension.kt

@@ -159,6 +159,21 @@ data class ToolbarAction(
      * from the toolbar when this resolves to false.
      */
     var isVisibleProvider: (() -> Boolean)? = null
+
+    /**
+     * Optional callback to compute the icon dynamically at render time, returning a
+     * drawable resource id from the plugin's own resources (e.g. `R.drawable.ic_mic`).
+     * When null, the static [icon] is used — existing plugins keep their fixed icon.
+     *
+     * The host re-invokes this each time the toolbar is (re)built, so a plugin can
+     * change the icon in response to its own state. Ask the host to rebuild the
+     * toolbar after a state change via
+     * [com.itsaky.androidide.plugins.services.IdeUIService.refreshToolbarActions].
+     * If the returned resource is an animated drawable (e.g. `AnimatedVectorDrawable`),
+     * the host starts it automatically; author it to loop for a continuous animation.
+     * Returning null (or a failure) falls back to the static [icon].
+     */
+    var iconProvider: (() -> Int?)? = null
 }
 
 enum class ShowAsAction {

plugin-api/src/main/kotlin/com/itsaky/androidide/plugins/services/IdeServices.kt

@@ -217,6 +217,20 @@ interface IdeUIService {
         title: String? = null
     ): Boolean = false
 
+    /**
+     * Asks the IDE to rebuild the editor toolbar, re-evaluating each plugin
+     * [com.itsaky.androidide.plugins.extensions.ToolbarAction]'s dynamic providers
+     * ([com.itsaky.androidide.plugins.extensions.ToolbarAction.iconProvider],
+     * `isEnabledProvider`, `isVisibleProvider`). Call this after changing plugin state
+     * that those providers depend on — e.g. to swap a toolbar icon between
+     * idle/active/processing states.
+     *
+     * Safe to call from any thread; the rebuild is marshalled to the UI thread. A no-op
+     * when no editor is in the foreground. Default implementation does nothing so older
+     * hosts remain source/binary compatible.
+     */
+    fun refreshToolbarActions() {}
+
     companion object {
         const val ACTION_OPEN_PLUGIN_SCREEN = "com.itsaky.androidide.plugins.OPEN_PLUGIN_SCREEN"
         const val EXTRA_PLUGIN_ID = "com.itsaky.androidide.plugins.extra.PLUGIN_ID"