@elizaos/app-core 2.0.0-beta.3 → 2.0.11-beta.5

package/platform/native-library-policy.d.ts

@@ -0,0 +1,23 @@
+export type NativeLibraryCandidate = {
+    label?: string;
+    path: string;
+};
+export type NativeLibraryPolicyOptions = {
+    env?: NodeJS.ProcessEnv;
+    execPath?: string;
+    expectedBasename: string | readonly string[];
+    moduleDir?: string;
+    warn?: (message: string) => void;
+};
+declare function isStoreBuildVariant(env?: NodeJS.ProcessEnv): boolean;
+declare function isWithinPath(parent: string, child: string): boolean;
+declare function findMacAppBundleRoot(value: string | undefined): string | null;
+export declare function resolveNativeLibraryCandidate(candidate: NativeLibraryCandidate, opts: NativeLibraryPolicyOptions): string | null;
+export declare function resolveFirstNativeLibraryCandidate(candidates: NativeLibraryCandidate[], opts: NativeLibraryPolicyOptions): string | null;
+export declare const nativeLibraryPolicyInternalsForTest: {
+    findMacAppBundleRoot: typeof findMacAppBundleRoot;
+    isStoreBuildVariant: typeof isStoreBuildVariant;
+    isWithinPath: typeof isWithinPath;
+};
+export {};
+//# sourceMappingURL=native-library-policy.d.ts.map

package/platform/native-library-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-library-policy.d.ts","sourceRoot":"","sources":["../../../../../src/platform/native-library-policy.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC,CAAC;AAEF,iBAAS,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAG1E;AAcD,iBAAS,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAM5D;AAED,iBAAS,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAUtE;AA6BD,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,sBAAsB,EACjC,IAAI,EAAE,0BAA0B,GAC/B,MAAM,GAAG,IAAI,CA2Df;AAED,wBAAgB,kCAAkC,CAChD,UAAU,EAAE,sBAAsB,EAAE,EACpC,IAAI,EAAE,0BAA0B,GAC/B,MAAM,GAAG,IAAI,CAMf;AAED,eAAO,MAAM,mCAAmC;;;;CAI/C,CAAC"}

package/platform/native-library-policy.js

@@ -0,0 +1,112 @@
+import { existsSync, realpathSync } from "node:fs";
+import path from "node:path";
+function isStoreBuildVariant(env = process.env) {
+    const raw = env.ELIZA_BUILD_VARIANT?.trim();
+    return raw?.toLowerCase() === "store";
+}
+function realpath(value) {
+    try {
+        return realpathSync.native(value);
+    }
+    catch {
+        try {
+            return realpathSync(value);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+function isWithinPath(parent, child) {
+    const relative = path.relative(parent, child);
+    return (relative === "" ||
+        (!relative.startsWith("..") && !path.isAbsolute(relative)));
+}
+function findMacAppBundleRoot(value) {
+    if (!value)
+        return null;
+    const absolute = path.resolve(value);
+    const parts = absolute.split(path.sep);
+    for (let index = parts.length - 1; index >= 0; index -= 1) {
+        if (parts[index]?.endsWith(".app")) {
+            return parts.slice(0, index + 1).join(path.sep) || path.sep;
+        }
+    }
+    return null;
+}
+function trustedBundleRoots(opts) {
+    const roots = [
+        findMacAppBundleRoot(opts.execPath ?? process.execPath),
+        findMacAppBundleRoot(opts.moduleDir),
+    ];
+    return [...new Set(roots.filter((root) => root !== null))];
+}
+function candidateLabel(candidate) {
+    return candidate.label
+        ? `${candidate.label} (${candidate.path})`
+        : candidate.path;
+}
+function expectedBasenames(opts) {
+    return new Set((Array.isArray(opts.expectedBasename)
+        ? opts.expectedBasename
+        : [opts.expectedBasename]).map((name) => name.trim()));
+}
+function expectedBasenameLabel(expected) {
+    return [...expected].join(", ");
+}
+export function resolveNativeLibraryCandidate(candidate, opts) {
+    const rawPath = candidate.path.trim();
+    if (!rawPath)
+        return null;
+    const resolvedPath = path.isAbsolute(rawPath)
+        ? path.normalize(rawPath)
+        : typeof opts.moduleDir === "string" && opts.moduleDir.length > 0
+            ? path.resolve(opts.moduleDir, rawPath)
+            : null;
+    if (!resolvedPath) {
+        opts.warn?.(`Rejected native library candidate ${candidateLabel(candidate)}: relative path cannot be resolved without a module directory.`);
+        return null;
+    }
+    if (!existsSync(resolvedPath))
+        return null;
+    if (!isStoreBuildVariant(opts.env)) {
+        return realpath(resolvedPath) ?? resolvedPath;
+    }
+    const expected = expectedBasenames(opts);
+    if (!expected.has(path.basename(resolvedPath))) {
+        opts.warn?.(`Rejected native library candidate ${candidateLabel(candidate)} for store build: expected ${expectedBasenameLabel(expected)}.`);
+        return null;
+    }
+    const candidateRealpath = realpath(resolvedPath);
+    if (!candidateRealpath)
+        return null;
+    if (!expected.has(path.basename(candidateRealpath))) {
+        opts.warn?.(`Rejected native library candidate ${candidateLabel(candidate)} for store build: realpath basename is not ${expectedBasenameLabel(expected)}.`);
+        return null;
+    }
+    const roots = trustedBundleRoots(opts)
+        .map((root) => realpath(root))
+        .filter((root) => root !== null);
+    if (roots.length === 0) {
+        opts.warn?.(`Rejected native library candidate ${candidateLabel(candidate)} for store build: no trusted .app bundle root was found.`);
+        return null;
+    }
+    if (!roots.some((root) => isWithinPath(root, candidateRealpath))) {
+        opts.warn?.(`Rejected native library candidate ${candidateLabel(candidate)} for store build: library is outside the signed app bundle.`);
+        return null;
+    }
+    return candidateRealpath;
+}
+export function resolveFirstNativeLibraryCandidate(candidates, opts) {
+    for (const candidate of candidates) {
+        const resolved = resolveNativeLibraryCandidate(candidate, opts);
+        if (resolved)
+            return resolved;
+    }
+    return null;
+}
+export const nativeLibraryPolicyInternalsForTest = {
+    findMacAppBundleRoot,
+    isStoreBuildVariant,
+    isWithinPath,
+};

package/platform/native-plugin-entrypoints.d.ts

@@ -0,0 +1,19 @@
+import "@elizaos/capacitor-camera";
+import "@elizaos/capacitor-canvas";
+import "@elizaos/capacitor-contacts";
+import "@elizaos/capacitor-gateway";
+import "@elizaos/capacitor-location";
+import "@elizaos/capacitor-messages";
+import "@elizaos/capacitor-mobile-agent-bridge";
+import "@elizaos/capacitor-mobile-signals";
+import "@elizaos/capacitor-appblocker";
+import "@elizaos/capacitor-bun-runtime";
+import "@elizaos/capacitor-phone";
+import "@elizaos/capacitor-screencapture";
+import "@elizaos/capacitor-swabble";
+import "@elizaos/capacitor-system";
+import "@elizaos/capacitor-talkmode";
+import "@elizaos/capacitor-websiteblocker";
+import "../connectors/capacitor-jsc.ts";
+import "../connectors/capacitor-quickjs.ts";
+//# sourceMappingURL=native-plugin-entrypoints.d.ts.map

package/platform/native-plugin-entrypoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-plugin-entrypoints.d.ts","sourceRoot":"","sources":["../../../../../src/platform/native-plugin-entrypoints.ts"],"names":[],"mappings":"AASA,OAAO,2BAA2B,CAAC;AACnC,OAAO,2BAA2B,CAAC;AACnC,OAAO,6BAA6B,CAAC;AACrC,OAAO,4BAA4B,CAAC;AACpC,OAAO,6BAA6B,CAAC;AACrC,OAAO,6BAA6B,CAAC;AACrC,OAAO,wCAAwC,CAAC;AAChD,OAAO,mCAAmC,CAAC;AAC3C,OAAO,+BAA+B,CAAC;AACvC,OAAO,gCAAgC,CAAC;AACxC,OAAO,0BAA0B,CAAC;AAClC,OAAO,kCAAkC,CAAC;AAC1C,OAAO,4BAA4B,CAAC;AACpC,OAAO,2BAA2B,CAAC;AACnC,OAAO,6BAA6B,CAAC;AACrC,OAAO,mCAAmC,CAAC;AAG3C,OAAO,gCAAgC,CAAC;AACxC,OAAO,oCAAoC,CAAC"}

package/platform/native-plugin-entrypoints.js

@@ -0,0 +1,29 @@
+// Side-effect barrel that registers every elizaOS Capacitor native plugin so
+// it's available on mobile boot. Each import pulls in the plugin's
+// `web.ts` / `native` registration code under the hood.
+//
+// The published `@elizaos/app-core` npm package contains this file as a
+// publish-time generated entrypoint; the source tree version exists so
+// `ELIZA_ELIZA_SOURCE=local` consumers can resolve the same import path
+// against linked workspace packages. Imports resolve through the
+// `@elizaos/capacitor-*` path mappings in tsconfig{,.build}.json.
+import "@elizaos/capacitor-camera";
+import "@elizaos/capacitor-canvas";
+import "@elizaos/capacitor-contacts";
+import "@elizaos/capacitor-gateway";
+import "@elizaos/capacitor-location";
+import "@elizaos/capacitor-messages";
+import "@elizaos/capacitor-mobile-agent-bridge";
+import "@elizaos/capacitor-mobile-signals";
+import "@elizaos/capacitor-appblocker";
+import "@elizaos/capacitor-bun-runtime";
+import "@elizaos/capacitor-phone";
+import "@elizaos/capacitor-screencapture";
+import "@elizaos/capacitor-swabble";
+import "@elizaos/capacitor-system";
+import "@elizaos/capacitor-talkmode";
+import "@elizaos/capacitor-websiteblocker";
+// JS-runtime sandbox bridges register their factories as import-time side
+// effects so resolveJsRuntimeBridge() can find jsc-ios / quickjs-* on boot.
+import "../connectors/capacitor-jsc.js";
+import "../connectors/capacitor-quickjs.js";

package/platforms/android/README.md

@@ -13,8 +13,10 @@ bun run build:android:cloud
 ```
 
 A Play-Store-compliant Capacitor APK backed by Eliza Cloud as the only
-hosting target. Produces a debug APK at
-`packages/app/android/app/build/outputs/apk/debug/`.
+hosting target. Produces a release AAB at
+`packages/app-core/platforms/android/app/build/outputs/bundle/release/`.
+For local Pixel smoke tests, `android-cloud-debug` produces a debug APK
+under `packages/app-core/platforms/android/app/build/outputs/apk/debug/`.
 
 What this target deliberately does **not** ship:
 
@@ -27,14 +29,58 @@ What this target deliberately does **not** ship:
   `ElizaInCallService`, `ElizaMmsReceiver`,
   `ElizaRespondViaMessageService`, `ElizaSmsComposeActivity`).
 - No `ElizaBootReceiver`.
+- No screen-capture native plugin or MediaProjection foreground-service
+  declaration.
 - No system-only or Play-Store-restricted permissions:
   `MANAGE_APP_OPS_MODES`, `PACKAGE_USAGE_STATS`, `BIND_DEVICE_ADMIN`,
+  `READ_FRAME_BUFFER`, `INJECT_EVENTS`, `REAL_GET_TASKS`,
   `READ_SMS` / `SEND_SMS` / `RECEIVE_SMS` / `RECEIVE_MMS` /
   `RECEIVE_WAP_PUSH`, `CALL_PHONE` / `READ_PHONE_STATE` /
   `ANSWER_PHONE_CALLS` / `MANAGE_OWN_CALLS` / `READ_CALL_LOG` /
   `WRITE_CALL_LOG`, `READ_CONTACTS` / `WRITE_CONTACTS`,
   `ACCESS_BACKGROUND_LOCATION`, `RECEIVE_BOOT_COMPLETED`,
-  `SYSTEM_ALERT_WINDOW`, `FOREGROUND_SERVICE_SPECIAL_USE`.
+  `REQUEST_IGNORE_BATTERY_OPTIMIZATIONS`, `SYSTEM_ALERT_WINDOW`,
+  `FOREGROUND_SERVICE_MEDIA_PROJECTION`, `FOREGROUND_SERVICE_SPECIAL_USE`.
+
+What this target still ships for Pixel/Google Android entry points:
+
+- `res/xml/shortcuts.xml` registered from `MainActivity` with
+  `android.app.shortcuts`.
+- App Actions capabilities for the supported BIIs `OPEN_APP_FEATURE`,
+  `CREATE_MESSAGE`, and `GET_THING`. These cover chat/ask, voice,
+  LifeOps daily brief, LifeOps task creation, and LifeOps task lists by
+  opening source-tagged deep links in the app.
+- `OPEN_APP_FEATURE` uses inline inventory for known features and keeps a
+  no-parameter fallback fulfillment, as required by the App Actions
+  `shortcuts.xml` schema.
+- Static launcher/Assistant shortcuts for chat, voice, daily brief, new
+  task, and tasks.
+
+Entry-point mapping:
+
+| User flow | Android surface | Fulfillment |
+|---|---|---|
+| Ask or chat with Eliza | `CREATE_MESSAGE` for message text, `GET_THING` for search-style ask text, plus the chat static shortcut | `elizaos://chat?...` source-tagged deep links |
+| Start voice chat | `OPEN_APP_FEATURE` inline inventory plus the voice static shortcut | `elizaos://voice?source=android-static-shortcut` |
+| Open LifeOps daily brief | `OPEN_APP_FEATURE` inline inventory plus the daily-brief static shortcut | `elizaos://lifeops/daily-brief?source=android-static-shortcut` |
+| Create a LifeOps task | `OPEN_APP_FEATURE` inline inventory plus the new-task static shortcut | `elizaos://lifeops/task/new?source=android-static-shortcut` deep link, then runtime confirmation/planning |
+| View LifeOps tasks | `OPEN_APP_FEATURE` inline inventory plus the tasks static shortcut | `elizaos://lifeops/tasks?source=android-static-shortcut` |
+
+There is no general third-party "be Gemini/default assistant" API for the
+Play build. Current Android docs route normal app voice entry through
+App Actions capabilities in `shortcuts.xml` and Android shortcuts; custom
+Gemini/Assistant intent formats documented for navigation apps are
+navigation-specific, not a general assistant surface for this app.
+
+The Play build intentionally does not request default-assistant or
+system-only powers. It has no `ACTION_ASSIST`, `VOICE_COMMAND`,
+`ROLE_ASSISTANT`, `BIND_VOICE_INTERACTION`, usage-stats appop, SMS/call
+default-role components, boot receiver, MediaProjection foreground
+service, or special-use foreground service. Gemini/Assistant
+interoperability for this target is through Google App Actions and
+Android shortcuts, not by trying to become the device's default
+assistant. Do not add unsupported BIIs such as `actions.intent.CREATE_THING`;
+task creation is modeled as opening the LifeOps task feature.
 
 Build-time flag set: `VITE_ELIZA_ANDROID_RUNTIME_MODE=cloud`. The
 renderer reads this via
@@ -59,7 +105,10 @@ bun run build:android
 What it does ship: full default-role activities, BootReceiver, the
 on-device agent staged via
 [`stage-android-agent.mjs`](../../scripts/lib/stage-android-agent.mjs),
-and the AOSP-aimed permission set.
+the AOSP-aimed permission set, and the same App Actions/static shortcuts
+metadata used by the Play build. `ElizaAssistActivity` handles
+`android.intent.action.ASSIST` for sideload/AOSP assistant-role testing;
+the Play build strips that activity.
 
 ## `build:android:system` — AOSP privileged platform-signed APK
 
@@ -67,12 +116,21 @@ and the AOSP-aimed permission set.
 bun run build:android:system
 ```
 
-Release APK signed by Soong's platform key for Milady OS / ElizaOS
-device builds. The privileged `MANAGE_APP_OPS_MODES` /
-`PACKAGE_USAGE_STATS` permissions are granted via the
-`privapp-permissions-com.elizaai.eliza.xml` whitelist baked into the
-vendor tree, so this APK is intended for `priv-app/` placement on
-Milady-flavored AOSP devices, **not** for Play Store distribution.
+Release APK signed by Soong's platform key for Eliza OS / ElizaOS
+device builds. The privileged `MANAGE_APP_OPS_MODES`,
+`PACKAGE_USAGE_STATS`, `READ_FRAME_BUFFER`, `INJECT_EVENTS`, and
+`REAL_GET_TASKS` permissions are granted via the
+`privapp-permissions-ai.elizaos.app.xml` whitelist baked into the vendor
+tree, so this APK is intended for `priv-app/` placement on
+Eliza-flavored AOSP devices, **not** for Play Store distribution.
+
+The matching system image also copies
+`/product/etc/eliza/aosp-assistant-full-control.json`, which records the
+AOSP-only assistant/full-control contract: `ROLE_ASSISTANT`,
+`ACTION_ASSIST`, `VOICE_COMMAND`, boot/direct-boot, foreground services,
+usage stats, MediaProjection/SurfaceControl screen capture, Accessibility
+input control, and the AOSP-only accessibility and notification-listener
+service declarations.
 
 The release APK is staged at
 `<repoRoot>/packages/os/android/vendor/eliza/apps/Eliza/Eliza.apk` (or

package/platforms/android/app/build.gradle

@@ -1,7 +1,7 @@
 apply plugin: 'com.android.application'
 
 android {
-    namespace "app.eliza"
+    namespace "ai.elizaos.app"
     compileSdk rootProject.ext.compileSdkVersion
     // BuildConfig is needed for AOSP_BUILD gating in ElizaAgentService.java —
     // see eliza/packages/agent/src/runtime/aosp-llama-adapter.ts and
@@ -10,7 +10,12 @@ android {
         buildConfig true
     }
     defaultConfig {
-        applicationId "app.eliza"
+        buildConfigField "boolean", "ELIZA_ANDROID_SMS_GATEWAY_ENABLED", "${['1', 'true', 'yes'].contains((System.getenv('ELIZA_ANDROID_SMS_GATEWAY_ENABLED') ?: 'false').toLowerCase())}"
+        buildConfigField "String", "ELIZA_ANDROID_SMS_GATEWAY_SECRET", "\"\""
+        buildConfigField "String", "ELIZA_ANDROID_SMS_GATEWAY_WEBHOOK_URL", "\"https://api.elizacloud.ai/api/webhooks/blooio/local?bridge=bluebubbles\""
+        buildConfigField "String", "ELIZA_ANDROID_SMS_GATEWAY_PHONE_NUMBER", "\"+14159611510\""
+        buildConfigField "String", "ELIZA_ANDROID_SMS_GATEWAY_PHONE_LABEL", "\"Eliza Cloud Gateway (+14159611510)\""
+        applicationId "ai.elizaos.app"
         minSdkVersion rootProject.ext.minSdkVersion
         targetSdkVersion rootProject.ext.targetSdkVersion
         versionCode System.getenv("ELIZAOS_VERSION_CODE")?.toInteger() ?: 1
@@ -21,15 +26,51 @@ android {
         // Capacitor APK build path (`bun run build:android`) leaves it
         // unset and the field stays false. ElizaAgentService reads this
         // to decide whether to export ELIZA_LOCAL_LLAMA=1 to the bun
-        // process so the AOSP-only libllama.so loader takes over inference.
+        // process so the AOSP-only fused libelizainference.so loader takes
+        // over inference.
         buildConfigField "boolean", "AOSP_BUILD", "${project.findProperty('elizaAospBuild') ?: 'false'}"
         aaptOptions {
              // Files and dirs to omit from the packaged assets dir, modified to accommodate modern web apps.
              // Default: https://android.googlesource.com/platform/frameworks/base/+/282e181b58cf72b6ca770dc7ca5f91f135444502/tools/aapt/AaptAssets.cpp#61
             ignoreAssetsPattern '!.svn:!.git:!.ds_store:!*.scc:.*:!CVS:!thumbs.db:!picasa.ini:!*~'
         }
+
+        // Phase 3a fused-voice JNI bridge (libelizavoicejni.so). Built by the
+        // NDK (bionic) from src/main/elizavoice-jni; links the prebuilt,
+        // self-contained libelizainference.so staged into jniLibs/arm64-v8a by
+        // stage-elizavoice-lib.mjs. Pass the fork FFI header dir to the shim's
+        // CMake. arm64-v8a only in Phase 3a (other ABIs build a no-op stub).
+        externalNativeBuild {
+            cmake {
+                def elizaRepoRoot = rootProject.projectDir.toPath().resolve('../../../..').normalize().toFile()
+                arguments "-DELIZAVOICE_FFI_INCLUDE_DIR=${new File(elizaRepoRoot, 'plugins/plugin-local-inference/native/llama.cpp/tools/omnivoice/include').absolutePath}"
+            }
+        }
+    }
+
+    // Only wire the Phase 3a elizavoice-jni native build when the prebuilt
+    // libelizainference.so actually exports the fused-voice FFI entrypoints
+    // (wakeword/speaker/diariz). That .so is rebuilt out-of-band by
+    // stage-elizavoice-lib.mjs; when it predates those symbols the bridge fails
+    // to link and would block the entire APK. Skip it instead — the Java
+    // ElizaVoiceNative.ensureLoaded() already degrades to "unavailable" when the
+    // bridge .so is absent. Re-enables automatically once the .so is rebuilt.
+    def elizavoicePrebuilt = file("src/main/jniLibs/arm64-v8a/libelizainference.so")
+    def elizavoiceReady = elizavoicePrebuilt.exists() &&
+        new String(elizavoicePrebuilt.readBytes(), "ISO-8859-1").contains("eliza_inference_wakeword_supported")
+    if (elizavoiceReady) {
+        externalNativeBuild {
+            cmake {
+                path "src/main/elizavoice-jni/CMakeLists.txt"
+                version "3.22.1"
+            }
+        }
+    } else {
+        logger.warn("[elizavoice-jni] prebuilt libelizainference.so lacks fused-voice symbols (wakeword/speaker/diariz); skipping Phase 3a JNI bridge so the APK still builds. Rebuild via stage-elizavoice-lib.mjs to re-enable.")
     }
 
+    ndkVersion "28.2.13676358"
+
     signingConfigs {
         release {
             // For Google Play App Signing: use an upload keystore.
@@ -96,13 +137,218 @@ android {
             keepDebugSymbols += ["**/libimage_processing_util_jni.so"]
         }
     }
+
+    // Preserve .tar.gz / .tar / .gguf / .so as-is in the packaged APK.
+    // aapt2 otherwise rewrites .tar.gz to .tar and PGlite's runtime
+    // extension loader fails to find vector.tar.gz / fuzzystrmatch.tar.gz.
+    androidResources {
+        noCompress += ['gguf', 'tar.gz', 'so', 'tar']
+    }
+}
+// Bundle the MTP Android llama.cpp stack into the APK so mobile
+// gets Eliza-1/Qwen3.5 support across every supported Android ABI
+// (arm64-v8a, x86_64, riscv64). The arm64-v8a slice is mandatory for
+// local-agent capable builds; x86_64 and riscv64 ship when their
+// per-ABI artifacts exist (Wave 2 cross-compiles land them
+// incrementally). Cloud builds and explicitly opted-out CI smoke
+// builds skip this task.
+ext.elizaForkLlamaAbis = ['arm64-v8a', 'x86_64', 'riscv64']
+
+ext.forkLlamaAbiTokens = [
+    'arm64-v8a': 'android-arm64',
+    'x86_64': 'android-x86_64',
+    'riscv64': 'android-riscv64'
+]
+
+ext.forkLlamaLibompAbiTokens = [
+    'arm64-v8a': 'aarch64',
+    'x86_64': 'x86_64',
+    'riscv64': 'riscv64'
+]
+
+def resolveForkLlamaLibDir = { String abi ->
+    // arm64-v8a keeps the legacy un-suffixed property/env names for
+    // backwards compatibility; other ABIs use the suffixed forms.
+    def propSuffix = abi == 'arm64-v8a' ? '' : ".${abi}"
+    def envSuffix = abi == 'arm64-v8a' ? '' : "_${abi.replace('-', '_').toUpperCase()}"
+    def fromProp = project.findProperty("eliza.mtp.android.libdir${propSuffix}")
+    if (fromProp) return fromProp.toString()
+    def fromEnv = System.getenv("ELIZA_MTP_ANDROID_LIBDIR${envSuffix}")
+    if (fromEnv) return fromEnv
+    def stateDir = System.getenv('ELIZA_STATE_DIR') ?: "${System.getProperty('user.home')}/.eliza"
+    def abiToken = project.ext.forkLlamaAbiTokens[abi]
+    def candidates = ['vulkan', 'cpu'].collect { backend ->
+        "${stateDir}/local-inference/bin/mtp/${abiToken}-${backend}"
+    }
+    return candidates.find { new File(it).isDirectory() }
+}
+
+def resolveAndroidLibompForAbi = { String abi ->
+    def localProperties = new Properties()
+    def localPropertiesFile = rootProject.file('local.properties')
+    if (localPropertiesFile.isFile()) {
+        localPropertiesFile.withInputStream { localProperties.load(it) }
+    }
+    def sdkPath = localProperties.getProperty('sdk.dir') ?:
+        System.getenv('ANDROID_HOME') ?:
+        System.getenv('ANDROID_SDK_ROOT') ?:
+        "${System.getProperty('user.home')}/Library/Android/sdk"
+    def androidSdk = new File(sdkPath)
+    def ndkRoots = []
+    def declaredNdkVersion = android.ndkVersion?.toString()
+    if (declaredNdkVersion) ndkRoots << new File(androidSdk, "ndk/${declaredNdkVersion}")
+    ndkRoots << new File(androidSdk, 'ndk/29.0.13113456')
+    def ndkParent = new File(androidSdk, 'ndk')
+    if (ndkParent.isDirectory()) {
+        (ndkParent.listFiles() ?: [] as File[]).each { ndkRoots << it }
+    }
+    def libompAbiToken = project.ext.forkLlamaLibompAbiTokens[abi]
+    for (def ndkDir : ndkRoots.unique { it.absolutePath }) {
+        def prebuiltDir = new File(ndkDir, 'toolchains/llvm/prebuilt')
+        if (!prebuiltDir.isDirectory()) continue
+        def hosts = prebuiltDir.listFiles() ?: [] as File[]
+        for (def hostDir : hosts) {
+            def clangDir = new File(hostDir, 'lib/clang')
+            def versions = clangDir.listFiles() ?: [] as File[]
+            for (def versionDir : versions) {
+                def libomp = new File(versionDir, "lib/linux/${libompAbiToken}/libomp.so")
+                if (libomp.isFile()) return libomp
+            }
+        }
+    }
+    return null
+}
+
+task copyForkLlamaLib {
+    doLast {
+        if (project.findProperty('elizaCloudBuild') == 'true') {
+            println "[copyForkLlamaLib] skipped for cloud build"
+            return
+        }
+        if (project.findProperty('elizaSkipForkLlamaLib') == 'true' || System.getenv('ELIZA_ANDROID_SKIP_FORK_LLAMA_LIB') == '1') {
+            println "[copyForkLlamaLib] skipped by explicit native-lib opt-out"
+            return
+        }
+        boolean stagedArm64 = false
+        int totalCopied = 0
+        boolean stagedKernels = false
+        project.ext.elizaForkLlamaAbis.each { abi ->
+            def libDir = resolveForkLlamaLibDir(abi)
+            if (!libDir) {
+                if (abi == 'arm64-v8a') {
+                    // arm64-v8a is the mandatory baseline ABI; missing it is a hard error.
+                    throw new GradleException("[copyForkLlamaLib] no MTP Android lib dir configured for arm64-v8a. Run packages/app-core/scripts/aosp/compile-libllama.mjs --target android-arm64-vulkan-fused (the Android cross-compiler; build-llama-cpp-mtp.mjs has no Android targets) or set -Peliza.mtp.android.libdir / ELIZA_MTP_ANDROID_LIBDIR.")
+                }
+                logger.lifecycle("[copyForkLlamaLib] no fork lib dir for ABI ${abi}; skipping")
+                return
+            }
+            def srcDir = new File(libDir.toString())
+            if (!srcDir.isDirectory()) {
+                if (abi == 'arm64-v8a') {
+                    throw new GradleException("[copyForkLlamaLib] MTP Android lib dir does not exist for arm64-v8a: ${libDir}")
+                }
+                logger.lifecycle("[copyForkLlamaLib] fork lib dir ${libDir} does not exist for ABI ${abi}; skipping")
+                return
+            }
+            def jniDir = file("src/main/jniLibs/${abi}")
+            jniDir.mkdirs()
+            def assetsDir = file('src/main/assets')
+            assetsDir.mkdirs()
+            int copied = 0
+            srcDir.eachFile { src ->
+                if (src.name.endsWith('.so')) {
+                    def dst = new File(jniDir, src.name)
+                    dst.bytes = src.bytes
+                    copied++
+                }
+                // kernels.json is ABI-independent; stage once from the first ABI we see.
+                if (src.name == 'kernels.json' && !stagedKernels) {
+                    def dst = new File(assetsDir, 'llama-cpp-kernels.json')
+                    dst.bytes = src.bytes
+                    println "[copyForkLlamaLib] staged kernels.json as assets/llama-cpp-kernels.json (from ${abi})"
+                    stagedKernels = true
+                }
+            }
+            def libomp = resolveAndroidLibompForAbi(abi)
+            if (libomp != null) {
+                def dst = new File(jniDir, 'libomp.so')
+                dst.bytes = libomp.bytes
+                copied++
+                println "[copyForkLlamaLib] staged Android OpenMP runtime for ${abi} from ${libomp}"
+            } else if (abi == 'arm64-v8a') {
+                throw new GradleException("[copyForkLlamaLib] Android arm64 libomp.so not found in the configured NDK; MTP CPU backend cannot load without it.")
+            } else {
+                logger.lifecycle("[copyForkLlamaLib] no libomp.so found for ${abi}; the .so set may not link on-device")
+            }
+            println "[copyForkLlamaLib] copied ${copied} .so file(s) from ${libDir} to ${jniDir}"
+            totalCopied += copied
+            if (abi == 'arm64-v8a') stagedArm64 = true
+        }
+        if (!stagedArm64) {
+            throw new GradleException("[copyForkLlamaLib] arm64-v8a slice was not staged; aborting (this is the baseline ABI).")
+        }
+    }
+}
+
+afterEvaluate {
+    tasks.matching { it.name == 'preBuild' }.all { it.dependsOn copyForkLlamaLib }
+}
+
+// Optional app thinning: keep assets/agent/ by default so stock
+// Capacitor APKs can run the bundled local agent. Set
+// -PelizaStripAgentAssets=true only for an explicitly cloud-only slim APK.
+afterEvaluate {
+    tasks.matching { it.name.startsWith('merge') && it.name.endsWith('Assets') }.all { mergeTask ->
+        mergeTask.inputs.property('elizaAospBuild', project.findProperty('elizaAospBuild') ?: 'false')
+        mergeTask.inputs.property('elizaStripAgentAssets', project.findProperty('elizaStripAgentAssets') ?: 'false')
+        mergeTask.inputs.property('elizaCloudBuild', project.findProperty('elizaCloudBuild') ?: 'false')
+        mergeTask.doLast {
+            if (project.findProperty('elizaAospBuild') != 'true' && (project.findProperty('elizaStripAgentAssets') == 'true' || project.findProperty('elizaCloudBuild') == 'true')) {
+                def assetsDir = mergeTask.outputDir.get().asFile
+                def agentDir = new File(assetsDir, 'agent')
+                if (agentDir.exists()) {
+                    println "[app-thinning] removing assets/agent/ from ${mergeTask.name} (cloud/slim Capacitor build)"
+                    agentDir.deleteDir()
+                }
+            } else {
+                println "[app-thinning] keeping assets/agent/ in ${mergeTask.name} (local-agent capable build)"
+            }
+        }
+    }
+}
+
+
+repositories {
+    flatDir {
+        dirs 'libs',
+             '../../node_modules/@capacitor/background-runner/android/src/main/libs',
+             '../../node_modules/@capacitor-community/background-runner/android/src/main/libs',
+             '../../../../app/node_modules/@capacitor/background-runner/android/src/main/libs',
+             '../../../../app/node_modules/@capacitor-community/background-runner/android/src/main/libs',
+             '../../../../node_modules/@capacitor/background-runner/android/src/main/libs',
+             '../../../../node_modules/@capacitor-community/background-runner/android/src/main/libs'
+    }
 }
 
 dependencies {
+    implementation "com.google.code.gson:gson:2.13.2"
     implementation fileTree(include: ['*.jar'], dir: 'libs')
     implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
     implementation "androidx.coordinatorlayout:coordinatorlayout:$androidxCoordinatorLayoutVersion"
     implementation "androidx.core:core-splashscreen:$coreSplashScreenVersion"
+    // WorkManager for periodic background refresh (see ElizaTasksWorker + ElizaBootReceiver).
+    // The Capacitor background-runner already pulls in work-runtime-ktx transitively;
+    // this explicit dep makes the worker classes resolvable from Java without relying on
+    // transitive resolution and pins us to the same version (2.11.0).
+    implementation "androidx.work:work-runtime:2.11.0"
+    // androidx.work's Worker/ListenableWorker API returns Guava's
+    // com.google.common.util.concurrent.ListenableFuture. That class ships in
+    // full Guava; the transitively-resolved listenablefuture artifact is the
+    // empty 9999.0-empty-to-avoid-conflict-with-guava stub, so without a direct
+    // Guava dep javac fails to compile ElizaTasksWorker (extends Worker) with
+    // "cannot access ListenableFuture". The empty-stub mechanism prevents any
+    // duplicate-class conflict once full Guava is on the classpath.
+    implementation "com.google.guava:guava:31.1-android"
     implementation project(':capacitor-android')
     implementation "com.google.code.gson:gson:2.14.0"
     implementation "com.google.firebase:firebase-common-ktx:21.0.0"
@@ -122,3 +368,22 @@ try {
 } catch(Exception e) {
     logger.info("google-services.json not found, google-services plugin not applied. Push Notifications won't work")
 }
+
+// [cloud-app-thinning] Cloud builds must never package the local agent payload.
+// This second hook patches older generated projects whose existing
+// [app-thinning] block only honored -PelizaStripAndroidAgentAssets.
+afterEvaluate {
+    tasks.matching { it.name.startsWith('merge') && it.name.endsWith('Assets') }.all { mergeTask ->
+        mergeTask.inputs.property('elizaCloudBuild', project.findProperty('elizaCloudBuild') ?: 'false')
+        mergeTask.doLast {
+            if (project.findProperty('elizaCloudBuild') == 'true') {
+                def assetsDir = mergeTask.outputDir.get().asFile
+                def agentDir = new File(assetsDir, 'agent')
+                if (agentDir.exists()) {
+                    println "[cloud-app-thinning] removing assets/agent/ from ${mergeTask.name}"
+                    agentDir.deleteDir()
+                }
+            }
+        }
+    }
+}