@elizaos/capacitor-system 1.0.0

package/android/build.gradle

@@ -0,0 +1,29 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxActivityVersion = project.hasProperty('androidxActivityVersion') ? rootProject.ext.androidxActivityVersion : '1.8.0'
+}
+
+apply plugin: 'com.android.library'
+android {
+    namespace = "ai.eliza.plugins.system"
+    compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 34
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 23
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 34
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+}
+
+repositories {
+    google()
+    maven { url = uri(rootProject.ext.mavenCentralMirrorUrl) }
+    mavenCentral()
+}
+
+dependencies {
+    implementation project(':capacitor-android')
+    implementation "androidx.activity:activity:$androidxActivityVersion"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" />

package/android/src/main/java/ai/eliza/plugins/system/SystemPlugin.kt

@@ -0,0 +1,146 @@
+package ai.eliza.plugins.system
+
+import android.app.role.RoleManager
+import android.content.ComponentName
+import android.content.Context
+import android.content.Intent
+import android.os.Build
+import android.provider.Settings
+import android.provider.Telephony
+import android.telecom.TelecomManager
+import androidx.activity.result.ActivityResult
+import com.getcapacitor.JSArray
+import com.getcapacitor.JSObject
+import com.getcapacitor.Plugin
+import com.getcapacitor.PluginCall
+import com.getcapacitor.PluginMethod
+import com.getcapacitor.annotation.ActivityCallback
+import com.getcapacitor.annotation.CapacitorPlugin
+
+@CapacitorPlugin(name = "ElizaSystem")
+class SystemPlugin : Plugin() {
+    private val roleMap = mapOf(
+        "home" to RoleManager.ROLE_HOME,
+        "dialer" to RoleManager.ROLE_DIALER,
+        "sms" to RoleManager.ROLE_SMS,
+        "assistant" to RoleManager.ROLE_ASSISTANT
+    )
+
+    @PluginMethod
+    fun getStatus(call: PluginCall) {
+        val result = JSObject()
+        val roles = JSArray()
+        result.put("packageName", context.packageName)
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+            val roleManager = context.getSystemService(Context.ROLE_SERVICE) as RoleManager
+            for ((name, androidRole) in roleMap) {
+                val role = JSObject()
+                val available = roleManager.isRoleAvailable(androidRole)
+                val holders = if (available) roleHolders(name) else emptyList()
+                val held = holders.contains(context.packageName)
+                role.put("role", name)
+                role.put("androidRole", androidRole)
+                role.put("available", available)
+                role.put("held", held)
+                role.put("holders", JSArray(holders))
+                roles.put(role)
+            }
+        }
+        result.put("roles", roles)
+        call.resolve(result)
+    }
+
+    @PluginMethod
+    fun requestRole(call: PluginCall) {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.Q) {
+            call.reject("Android role requests require Android 10 or newer")
+            return
+        }
+
+        val roleName = call.getString("role")?.trim()
+        val androidRole = roleMap[roleName]
+        if (roleName.isNullOrEmpty() || androidRole == null) {
+            call.reject("role must be one of ${roleMap.keys.joinToString(", ")}")
+            return
+        }
+
+        val roleManager = context.getSystemService(Context.ROLE_SERVICE) as RoleManager
+        if (!roleManager.isRoleAvailable(androidRole)) {
+            call.reject("$androidRole is not available on this device")
+            return
+        }
+
+        if (roleManager.isRoleHeld(androidRole)) {
+            call.resolve(roleRequestResult(roleName, true, 0))
+            return
+        }
+
+        startActivityForResult(
+            call,
+            roleManager.createRequestRoleIntent(androidRole),
+            "handleRoleRequestResult"
+        )
+    }
+
+    @ActivityCallback
+    private fun handleRoleRequestResult(call: PluginCall, result: ActivityResult) {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.Q) {
+            call.reject("Android role requests require Android 10 or newer")
+            return
+        }
+
+        val roleName = call.getString("role")?.trim()
+        val androidRole = roleMap[roleName]
+        if (roleName.isNullOrEmpty() || androidRole == null) {
+            call.reject("role must be one of ${roleMap.keys.joinToString(", ")}")
+            return
+        }
+
+        val roleManager = context.getSystemService(Context.ROLE_SERVICE) as RoleManager
+        call.resolve(roleRequestResult(roleName, roleManager.isRoleHeld(androidRole), result.resultCode))
+    }
+
+    private fun roleHolders(name: String): List<String> {
+        return when (name) {
+            "home" -> listOfNotNull(resolveHomePackage())
+            "dialer" -> listOfNotNull(resolveDefaultDialerPackage())
+            "sms" -> listOfNotNull(Telephony.Sms.getDefaultSmsPackage(context))
+            "assistant" -> listOfNotNull(resolveAssistantPackage())
+            else -> emptyList()
+        }
+    }
+
+    private fun resolveHomePackage(): String? {
+        val intent = Intent(Intent.ACTION_MAIN)
+        intent.addCategory(Intent.CATEGORY_HOME)
+        val resolved = context.packageManager.resolveActivity(intent, 0)
+        return resolved?.activityInfo?.packageName
+    }
+
+    private fun resolveDefaultDialerPackage(): String? {
+        val telecom = context.getSystemService(Context.TELECOM_SERVICE) as? TelecomManager
+        return telecom?.defaultDialerPackage
+    }
+
+    private fun resolveAssistantPackage(): String? {
+        val flattened = Settings.Secure.getString(context.contentResolver, "assistant")
+        if (flattened.isNullOrBlank()) return null
+        return ComponentName.unflattenFromString(flattened)?.packageName
+    }
+
+    private fun roleRequestResult(roleName: String, held: Boolean, resultCode: Int): JSObject {
+        val result = JSObject()
+        result.put("role", roleName)
+        result.put("held", held)
+        result.put("resultCode", resultCode)
+        return result
+    }
+
+    @PluginMethod
+    fun openSettings(call: PluginCall) {
+        val intent = Intent(Settings.ACTION_SETTINGS)
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
+        context.startActivity(intent)
+        call.resolve()
+    }
+}

package/dist/esm/definitions.d.ts

@@ -0,0 +1,25 @@
+export type AndroidRoleName = "home" | "dialer" | "sms" | "assistant";
+export interface AndroidRoleStatus {
+    role: AndroidRoleName;
+    androidRole: string;
+    held: boolean;
+    holders: string[];
+    available: boolean;
+}
+export interface SystemStatus {
+    packageName: string;
+    roles: AndroidRoleStatus[];
+}
+export interface AndroidRoleRequestResult {
+    role: AndroidRoleName;
+    held: boolean;
+    resultCode: number;
+}
+export interface SystemPlugin {
+    getStatus(): Promise<SystemStatus>;
+    requestRole(options: {
+        role: AndroidRoleName;
+    }): Promise<AndroidRoleRequestResult>;
+    openSettings(): Promise<void>;
+}
+//# sourceMappingURL=definitions.d.ts.map

package/dist/esm/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,WAAW,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IACnC,WAAW,CAAC,OAAO,EAAE;QACnB,IAAI,EAAE,eAAe,CAAC;KACvB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACtC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B"}

package/dist/esm/definitions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":""}

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+import type { SystemPlugin } from "./definitions";
+export * from "./definitions";
+export declare const System: SystemPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,cAAc,eAAe,CAAC;AAI9B,eAAO,MAAM,MAAM,cAEjB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+import { registerPlugin } from "@capacitor/core";
+export * from "./definitions";
+const loadWeb = () => import("./web").then((m) => new m.SystemWeb());
+export const System = registerPlugin("ElizaSystem", {
+    web: loadWeb,
+});
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,cAAc,eAAe,CAAC;AAE9B,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;AAErE,MAAM,CAAC,MAAM,MAAM,GAAG,cAAc,CAAe,aAAa,EAAE;IAChE,GAAG,EAAE,OAAO;CACb,CAAC,CAAC"}

package/dist/esm/web.d.ts

@@ -0,0 +1,10 @@
+import { WebPlugin } from "@capacitor/core";
+import type { AndroidRoleName, AndroidRoleRequestResult, SystemPlugin, SystemStatus } from "./definitions";
+export declare class SystemWeb extends WebPlugin implements SystemPlugin {
+    getStatus(): Promise<SystemStatus>;
+    openSettings(): Promise<void>;
+    requestRole(options: {
+        role: AndroidRoleName;
+    }): Promise<AndroidRoleRequestResult>;
+}
+//# sourceMappingURL=web.d.ts.map

package/dist/esm/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACxB,YAAY,EACZ,YAAY,EACb,MAAM,eAAe,CAAC;AAEvB,qBAAa,SAAU,SAAQ,SAAU,YAAW,YAAY;IACxD,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;IAOlC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,WAAW,CAAC,OAAO,EAAE;QACzB,IAAI,EAAE,eAAe,CAAC;KACvB,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAKtC"}

package/dist/esm/web.js

@@ -0,0 +1,16 @@
+import { WebPlugin } from "@capacitor/core";
+export class SystemWeb extends WebPlugin {
+    async getStatus() {
+        return {
+            packageName: "web",
+            roles: [],
+        };
+    }
+    async openSettings() {
+        throw new Error("System settings are only available on Android.");
+    }
+    async requestRole(options) {
+        throw new Error(`Android role ${options.role} is only available on Android.`);
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAS5C,MAAM,OAAO,SAAU,SAAQ,SAAS;IACtC,KAAK,CAAC,SAAS;QACb,OAAO;YACL,WAAW,EAAE,KAAK;YAClB,KAAK,EAAE,EAAE;SACV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAEjB;QACC,MAAM,IAAI,KAAK,CACb,gBAAgB,OAAO,CAAC,IAAI,gCAAgC,CAC7D,CAAC;IACJ,CAAC;CACF"}

package/dist/plugin.cjs.js

@@ -0,0 +1,31 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+const loadWeb = () => Promise.resolve().then(function () { return web; }).then((m) => new m.SystemWeb());
+const System = core.registerPlugin("ElizaSystem", {
+    web: loadWeb,
+});
+
+class SystemWeb extends core.WebPlugin {
+    async getStatus() {
+        return {
+            packageName: "web",
+            roles: [],
+        };
+    }
+    async openSettings() {
+        throw new Error("System settings are only available on Android.");
+    }
+    async requestRole(options) {
+        throw new Error(`Android role ${options.role} is only available on Android.`);
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    SystemWeb: SystemWeb
+});
+
+exports.System = System;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from \"@capacitor/core\";\nexport * from \"./definitions\";\nconst loadWeb = () => import(\"./web\").then((m) => new m.SystemWeb());\nexport const System = registerPlugin(\"ElizaSystem\", {\n    web: loadWeb,\n});\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\nexport class SystemWeb extends WebPlugin {\n    async getStatus() {\n        return {\n            packageName: \"web\",\n            roles: [],\n        };\n    }\n    async openSettings() {\n        throw new Error(\"System settings are only available on Android.\");\n    }\n    async requestRole(options) {\n        throw new Error(`Android role ${options.role} is only available on Android.`);\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AAEA,MAAM,OAAO,GAAG,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;AACxD,MAAC,MAAM,GAAGA,mBAAc,CAAC,aAAa,EAAE;AACpD,IAAI,GAAG,EAAE,OAAO;AAChB,CAAC;;ACJM,MAAM,SAAS,SAASC,cAAS,CAAC;AACzC,IAAI,MAAM,SAAS,GAAG;AACtB,QAAQ,OAAO;AACf,YAAY,WAAW,EAAE,KAAK;AAC9B,YAAY,KAAK,EAAE,EAAE;AACrB,SAAS;AACT,IAAI;AACJ,IAAI,MAAM,YAAY,GAAG;AACzB,QAAQ,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC;AACzE,IAAI;AACJ,IAAI,MAAM,WAAW,CAAC,OAAO,EAAE;AAC/B,QAAQ,MAAM,IAAI,KAAK,CAAC,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;AACrF,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,34 @@
+var capacitorSystem = (function (exports, core) {
+    'use strict';
+
+    const loadWeb = () => Promise.resolve().then(function () { return web; }).then((m) => new m.SystemWeb());
+    const System = core.registerPlugin("ElizaSystem", {
+        web: loadWeb,
+    });
+
+    class SystemWeb extends core.WebPlugin {
+        async getStatus() {
+            return {
+                packageName: "web",
+                roles: [],
+            };
+        }
+        async openSettings() {
+            throw new Error("System settings are only available on Android.");
+        }
+        async requestRole(options) {
+            throw new Error(`Android role ${options.role} is only available on Android.`);
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        SystemWeb: SystemWeb
+    });
+
+    exports.System = System;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from \"@capacitor/core\";\nexport * from \"./definitions\";\nconst loadWeb = () => import(\"./web\").then((m) => new m.SystemWeb());\nexport const System = registerPlugin(\"ElizaSystem\", {\n    web: loadWeb,\n});\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\nexport class SystemWeb extends WebPlugin {\n    async getStatus() {\n        return {\n            packageName: \"web\",\n            roles: [],\n        };\n    }\n    async openSettings() {\n        throw new Error(\"System settings are only available on Android.\");\n    }\n    async requestRole(options) {\n        throw new Error(`Android role ${options.role} is only available on Android.`);\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;IAEA,MAAM,OAAO,GAAG,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;AACxD,UAAC,MAAM,GAAGA,mBAAc,CAAC,aAAa,EAAE;IACpD,IAAI,GAAG,EAAE,OAAO;IAChB,CAAC;;ICJM,MAAM,SAAS,SAASC,cAAS,CAAC;IACzC,IAAI,MAAM,SAAS,GAAG;IACtB,QAAQ,OAAO;IACf,YAAY,WAAW,EAAE,KAAK;IAC9B,YAAY,KAAK,EAAE,EAAE;IACrB,SAAS;IACT,IAAI;IACJ,IAAI,MAAM,YAAY,GAAG;IACzB,QAAQ,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC;IACzE,IAAI;IACJ,IAAI,MAAM,WAAW,CAAC,OAAO,EAAE;IAC/B,QAAQ,MAAM,IAAI,KAAK,CAAC,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACrF,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@elizaos/capacitor-system",
+  "version": "1.0.0",
+  "description": "Android system-role status bridge for ElizaOS.",
+  "main": "./dist/plugin.cjs.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/plugin.cjs.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "android/src/main/",
+    "android/build.gradle",
+    "dist/"
+  ],
+  "scripts": {
+    "build": "npm run clean && tsc && rollup -c rollup.config.mjs",
+    "clean": "rimraf ./dist",
+    "prepublishOnly": "npm run build"
+  },
+  "license": "MIT",
+  "capacitor": {
+    "android": {
+      "src": "android"
+    }
+  },
+  "devDependencies": {
+    "@capacitor/cli": "^8.0.0",
+    "@capacitor/core": "^8.3.1",
+    "rimraf": "^6.0.0",
+    "rollup": "^4.60.2",
+    "typescript": "^6.0.0"
+  },
+  "peerDependencies": {
+    "@capacitor/core": "^8.3.1"
+  },
+  "elizaos": {
+    "platforms": [
+      "browser",
+      "node"
+    ],
+    "runtime": "both",
+    "platformDetails": {
+      "browser": "Web fallback reports no Android roles.",
+      "android": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}