@elizaos/capacitor-network-policy 2.0.11-beta.7

package/ElizaosCapacitorNetworkPolicy.podspec

@@ -0,0 +1,17 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'ElizaosCapacitorNetworkPolicy'
+  s.version = package['version']
+  s.summary = package['description']
+  s.license = package['license'] || { :type => 'MIT' }
+  s.homepage = 'https://elizaos.ai'
+  s.authors = { 'elizaOS' => 'dev@elizaos.ai' }
+  s.source = { :git => 'https://github.com/elizaOS/eliza.git', :tag => s.version.to_s }
+  s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target = '13.0'
+  s.dependency 'Capacitor'
+  s.swift_version = '5.1'
+end

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,87 @@
+# @elizaos/capacitor-network-policy
+
+Android + iOS Capacitor plugin that surfaces OS-level network-metering hints to Eliza agents running on mobile devices.
+
+## What it does
+
+The voice-model auto-updater in `plugin-local-inference` must decide whether to download updated model weights over the current network link. This plugin bridges two OS APIs:
+
+- **Android** — `ConnectivityManager.getNetworkCapabilities(activeNetwork).hasCapability(NET_CAPABILITY_NOT_METERED)`. Returns `metered: true | false | null` (`null` = unknown/no-permission).
+- **iOS** — `NWPathMonitor.currentPath.isExpensive` and `.isConstrained`. `isExpensive` is Apple's canonical "treat as metered" flag (covers cellular and tethered hotspot Wi-Fi). `isConstrained` is Low Data Mode.
+- **Web / browser fallback** — reads `navigator.connection.saveData`; returns `null` when the signal is absent so the policy falls through to "ask the user."
+
+On import, the plugin installs `globalThis.ElizaNetworkPolicy` so `plugin-local-inference/src/services/network-policy.ts` can call into the bridge without a compile-time Capacitor dependency.
+
+## Capacitor bridge
+
+Bridge name: `ElizaNetworkPolicy`
+
+### `getMeteredHint(): Promise<MeteredHint>`
+
+**Android (safe fallback on iOS/web).** Returns `{ metered: boolean | null, source: "android-os" }`.
+
+| `metered` value | Meaning |
+|-----------------|---------|
+| `true` | Link is metered — defer or skip the download. |
+| `false` | Link is not metered — download is safe. |
+| `null` | No active network, permission denied, or OS cannot report. Policy falls through to "ask." |
+
+> Android explicitly warns that transport type (cellular vs. Wi-Fi) is not a reliable proxy for metering. Use only the `NET_CAPABILITY_NOT_METERED` flag.
+
+### `getPathHints(): Promise<PathHints>`
+
+**iOS (safe fallback on Android/web).** Returns `{ isExpensive: boolean, isConstrained: boolean, source: "nw-path-monitor" }`.
+
+| Field | Meaning |
+|-------|---------|
+| `isExpensive` | `true` when the link is cellular or a cellular hotspot — treat as metered. |
+| `isConstrained` | `true` when Low Data Mode is on — user has explicitly asked the OS to limit non-essential traffic. |
+
+Returns `false/false` on Android (use `getMeteredHint()` there).
+
+## Requirements
+
+- `@capacitor/core ^8.3.1` (peer dependency — provided by the consuming app)
+- Android: `ACCESS_NETWORK_STATE` permission in `AndroidManifest.xml`
+- iOS 13+, Swift 5.1+
+
+## Installation
+
+```bash
+bun add @elizaos/capacitor-network-policy
+npx cap sync
+```
+
+For iOS, add the pod to your Podfile:
+
+```ruby
+pod 'ElizaosCapacitorNetworkPolicy', :path => '../node_modules/@elizaos/capacitor-network-policy'
+```
+
+## Usage
+
+```ts
+import "@elizaos/capacitor-network-policy";
+// globalThis.ElizaNetworkPolicy is now set (side-effect on import).
+
+import { NetworkPolicy } from "@elizaos/capacitor-network-policy";
+
+// Android
+const { metered } = await NetworkPolicy.getMeteredHint();
+if (metered === true) { /* skip download */ }
+
+// iOS
+const { isExpensive, isConstrained } = await NetworkPolicy.getPathHints();
+if (isExpensive || isConstrained) { /* skip download */ }
+```
+
+## Build
+
+```bash
+bun run --cwd plugins/plugin-native-network-policy build
+```
+
+Outputs:
+- `dist/esm/index.js` — ESM (TypeScript-compiled)
+- `dist/plugin.js` — IIFE for web bundlers
+- `dist/plugin.cjs.js` — CommonJS

package/android/build.gradle

@@ -0,0 +1,27 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+}
+
+apply plugin: 'com.android.library'
+android {
+    namespace = "ai.eliza.plugins.networkpolicy"
+    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.has('mavenCentralMirrorUrl') ? rootProject.ext.mavenCentralMirrorUrl : 'https://repo.maven.apache.org/maven2') }
+    mavenCentral()
+}
+
+dependencies {
+    implementation project(':capacitor-android')
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <!--
+      ACCESS_NETWORK_STATE is required to call
+      `ConnectivityManager.getNetworkCapabilities`. The plugin gracefully
+      returns `metered: null` (TS downgrades to ask) when the permission
+      is denied so callers don't have to handle a SecurityException.
+    -->
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+</manifest>

package/android/src/main/java/ai/eliza/plugins/networkpolicy/NetworkPolicyPlugin.kt

@@ -0,0 +1,95 @@
+package ai.eliza.plugins.networkpolicy
+
+import android.content.Context
+import android.net.ConnectivityManager
+import android.net.NetworkCapabilities
+import com.getcapacitor.JSObject
+import com.getcapacitor.Plugin
+import com.getcapacitor.PluginCall
+import com.getcapacitor.PluginMethod
+import com.getcapacitor.annotation.CapacitorPlugin
+
+/**
+ * Android `metered` hint bridge for the voice-model auto-updater
+ * (R5-versioning §4.1).
+ *
+ * Reads `ConnectivityManager.getNetworkCapabilities(activeNetwork)
+ * .hasCapability(NetworkCapabilities.NET_CAPABILITY_NOT_METERED)`.
+ *
+ * Android explicitly warns: "Do not assume that cellular means metered.
+ * On many devices a tethered Wi-Fi hotspot reports `wifi` as the transport
+ * but is metered, and on others a corporate cellular plan reports as
+ * not-metered." The metered flag is the only authoritative source.
+ *
+ * Returned shape (mirrors the TS `MeteredHint` interface):
+ *
+ *   { metered: true | false | null, source: "android-os" }
+ *
+ * `null` is returned when there is no active network, when the
+ * `NetworkCapabilities` object is unavailable (lock-screen / boot races),
+ * or when the system lacks `ACCESS_NETWORK_STATE` permission — the TS
+ * side then downgrades to `unknown → ask`.
+ */
+@CapacitorPlugin(name = "ElizaNetworkPolicy")
+class NetworkPolicyPlugin : Plugin() {
+    private val connectivityManager: ConnectivityManager?
+        get() = context.applicationContext
+            .getSystemService(Context.CONNECTIVITY_SERVICE) as? ConnectivityManager
+
+    @PluginMethod
+    fun getMeteredHint(call: PluginCall) {
+        val response = JSObject()
+        response.put("source", "android-os")
+        val cm = connectivityManager
+        if (cm == null) {
+            response.put("metered", JSObject.NULL)
+            call.resolve(response)
+            return
+        }
+        val active = try {
+            cm.activeNetwork
+        } catch (t: Throwable) {
+            null
+        }
+        if (active == null) {
+            response.put("metered", JSObject.NULL)
+            call.resolve(response)
+            return
+        }
+        val caps: NetworkCapabilities? = try {
+            cm.getNetworkCapabilities(active)
+        } catch (t: SecurityException) {
+            // Missing ACCESS_NETWORK_STATE. Surface as unknown rather than
+            // throw — the caller will downgrade to `ask`.
+            null
+        } catch (t: Throwable) {
+            null
+        }
+        if (caps == null) {
+            response.put("metered", JSObject.NULL)
+            call.resolve(response)
+            return
+        }
+        // `hasCapability(NET_CAPABILITY_NOT_METERED)` is true when the link
+        // is NOT metered. We surface the inverse (whether it IS metered)
+        // because that's the field the TS decision rule consumes.
+        val notMetered = caps.hasCapability(NetworkCapabilities.NET_CAPABILITY_NOT_METERED)
+        response.put("metered", !notMetered)
+        call.resolve(response)
+    }
+
+    /**
+     * iOS-only safe fallback on Android. Always resolves with the shared
+     * response shape so the TS bridge can call `getPathHints()` uniformly;
+     * the TS layer treats a never-expensive / never-constrained Android
+     * response as "no info" and falls back to `getMeteredHint`.
+     */
+    @PluginMethod
+    fun getPathHints(call: PluginCall) {
+        val response = JSObject()
+        response.put("isExpensive", false)
+        response.put("isConstrained", false)
+        response.put("source", "nw-path-monitor")
+        call.resolve(response)
+    }
+}

package/dist/esm/definitions.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Type definitions for the `@elizaos/capacitor-network-policy` bridge.
+ *
+ * Backs the on-device portion of the voice-model auto-updater
+ * network-policy decision (R5-versioning §4). Two methods:
+ *
+ *  - `getMeteredHint()` — Android. Wraps
+ *    `ConnectivityManager.getNetworkCapabilities(activeNetwork).hasCapability(
+ *    NetworkCapabilities.NET_CAPABILITY_NOT_METERED)`. Android docs warn
+ *    explicitly that "cellular" is NOT a synonym for "metered" so the
+ *    metered flag is mandatory.
+ *  - `getPathHints()` — iOS. Wraps `NWPathMonitor.currentPath.isExpensive`
+ *    and `.isConstrained`. `isExpensive == true` is Apple's "treat as
+ *    metered" flag (cellular by default, plus tethered Wi-Fi from a
+ *    cellular hotspot).
+ *
+ * The plugin populates `globalThis.ElizaNetworkPolicy` so the platform-
+ * agnostic probes in `plugin-local-inference/src/services/network-policy.ts`
+ * can read it without depending on Capacitor at compile time.
+ */
+export interface MeteredHint {
+    /**
+     * `true` if Android reports `NET_CAPABILITY_NOT_METERED === false`
+     * (i.e. the link IS metered), `false` if not metered, `null` when the
+     * platform cannot report a definitive answer (no active network or
+     * permission denied).
+     */
+    metered: boolean | null;
+    /** Source label for debugging — always `"android-os"` from this plugin. */
+    source: "android-os";
+}
+export interface PathHints {
+    /** `NWPath.isExpensive` — true when the link is metered per Apple's policy. */
+    isExpensive: boolean;
+    /**
+     * `NWPath.isConstrained` — true when Low Data Mode is engaged. The voice-
+     * updater treats this as "metered" because the user has explicitly asked
+     * the OS to limit non-essential traffic.
+     */
+    isConstrained: boolean;
+    /** Source label for debugging — always `"nw-path-monitor"` from this plugin. */
+    source: "nw-path-monitor";
+}
+export interface NetworkPolicyPlugin {
+    /** Android-only. Returns `{ metered: null, source: "android-os" }` on iOS / web. */
+    getMeteredHint(): Promise<MeteredHint>;
+    /** iOS-only. Returns `{ isExpensive: false, isConstrained: false, source: "nw-path-monitor" }` on Android / web. */
+    getPathHints(): Promise<PathHints>;
+}
+//# 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;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,2EAA2E;IAC3E,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,+EAA+E;IAC/E,WAAW,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB,gFAAgF;IAChF,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,oFAAoF;IACpF,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IACvC,oHAAoH;IACpH,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;CACpC"}

package/dist/esm/definitions.js

@@ -0,0 +1,22 @@
+/**
+ * Type definitions for the `@elizaos/capacitor-network-policy` bridge.
+ *
+ * Backs the on-device portion of the voice-model auto-updater
+ * network-policy decision (R5-versioning §4). Two methods:
+ *
+ *  - `getMeteredHint()` — Android. Wraps
+ *    `ConnectivityManager.getNetworkCapabilities(activeNetwork).hasCapability(
+ *    NetworkCapabilities.NET_CAPABILITY_NOT_METERED)`. Android docs warn
+ *    explicitly that "cellular" is NOT a synonym for "metered" so the
+ *    metered flag is mandatory.
+ *  - `getPathHints()` — iOS. Wraps `NWPathMonitor.currentPath.isExpensive`
+ *    and `.isConstrained`. `isExpensive == true` is Apple's "treat as
+ *    metered" flag (cellular by default, plus tethered Wi-Fi from a
+ *    cellular hotspot).
+ *
+ * The plugin populates `globalThis.ElizaNetworkPolicy` so the platform-
+ * agnostic probes in `plugin-local-inference/src/services/network-policy.ts`
+ * can read it without depending on Capacitor at compile time.
+ */
+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":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/esm/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `@elizaos/capacitor-network-policy` — Android `metered` / iOS `isExpensive`
+ * shims for the voice-model auto-updater network policy (R5-versioning §4).
+ *
+ * Registers as `ElizaNetworkPolicy` on the Capacitor bridge. The
+ * platform-agnostic probes in `plugin-local-inference` read the bridge
+ * via `globalThis.ElizaNetworkPolicy` so this module's only job is to
+ * register and install the global.
+ */
+import type { NetworkPolicyPlugin } from "./definitions";
+export * from "./definitions";
+export declare const NetworkPolicy: NetworkPolicyPlugin;
+/**
+ * Install `globalThis.ElizaNetworkPolicy` so the runtime probe in
+ * `plugin-local-inference/src/services/network-policy.ts` can call into
+ * the native bridge without compile-time Capacitor dependencies.
+ *
+ * Idempotent — re-installing replaces the existing handle with the same
+ * `NetworkPolicy` instance.
+ */
+export declare function installNetworkPolicyGlobal(): void;
+//# 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":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,cAAc,eAAe,CAAC;AAI9B,eAAO,MAAM,aAAa,qBAGzB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD"}

package/dist/esm/index.js

@@ -0,0 +1,29 @@
+/**
+ * `@elizaos/capacitor-network-policy` — Android `metered` / iOS `isExpensive`
+ * shims for the voice-model auto-updater network policy (R5-versioning §4).
+ *
+ * Registers as `ElizaNetworkPolicy` on the Capacitor bridge. The
+ * platform-agnostic probes in `plugin-local-inference` read the bridge
+ * via `globalThis.ElizaNetworkPolicy` so this module's only job is to
+ * register and install the global.
+ */
+import { registerPlugin } from "@capacitor/core";
+export * from "./definitions";
+const loadWeb = () => import("./web").then((m) => new m.NetworkPolicyWeb());
+export const NetworkPolicy = registerPlugin("ElizaNetworkPolicy", { web: loadWeb });
+/**
+ * Install `globalThis.ElizaNetworkPolicy` so the runtime probe in
+ * `plugin-local-inference/src/services/network-policy.ts` can call into
+ * the native bridge without compile-time Capacitor dependencies.
+ *
+ * Idempotent — re-installing replaces the existing handle with the same
+ * `NetworkPolicy` instance.
+ */
+export function installNetworkPolicyGlobal() {
+    globalThis.ElizaNetworkPolicy = NetworkPolicy;
+}
+// Side-effect: install on import so callers that simply
+// `import "@elizaos/capacitor-network-policy"` from the app bootstrap
+// pick up the global without any extra wiring.
+installNetworkPolicyGlobal();
+//# 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;;;;;;;;GAQG;AAEH,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,gBAAgB,EAAE,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CACzC,oBAAoB,EACpB,EAAE,GAAG,EAAE,OAAO,EAAE,CACjB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B;IAEtC,UACD,CAAC,kBAAkB,GAAG,aAAa,CAAC;AACvC,CAAC;AAED,wDAAwD;AACxD,sEAAsE;AACtE,+CAA+C;AAC/C,0BAA0B,EAAE,CAAC"}

package/dist/esm/web.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Web fallback for `@elizaos/capacitor-network-policy`.
+ *
+ * Browsers can read `navigator.connection.saveData` (a heuristic for "user
+ * has Data Saver enabled") and `.type` (`cellular` / `wifi` / `ethernet`),
+ * but the WICG spec is partial and Firefox/Safari support is limited. The
+ * fallback returns conservative defaults so the policy decision falls
+ * through to `unknown → ask` — never silently accepts a download on a
+ * potentially-metered link.
+ */
+import { WebPlugin } from "@capacitor/core";
+import type { MeteredHint, NetworkPolicyPlugin, PathHints } from "./definitions";
+export declare class NetworkPolicyWeb extends WebPlugin implements NetworkPolicyPlugin {
+    getMeteredHint(): Promise<MeteredHint>;
+    getPathHints(): Promise<PathHints>;
+}
+//# 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;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,SAAS,EACV,MAAM,eAAe,CAAC;AAEvB,qBAAa,gBAAiB,SAAQ,SAAU,YAAW,mBAAmB;IACtE,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAWtC,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC;CAQzC"}

package/dist/esm/web.js

@@ -0,0 +1,42 @@
+/**
+ * Web fallback for `@elizaos/capacitor-network-policy`.
+ *
+ * Browsers can read `navigator.connection.saveData` (a heuristic for "user
+ * has Data Saver enabled") and `.type` (`cellular` / `wifi` / `ethernet`),
+ * but the WICG spec is partial and Firefox/Safari support is limited. The
+ * fallback returns conservative defaults so the policy decision falls
+ * through to `unknown → ask` — never silently accepts a download on a
+ * potentially-metered link.
+ */
+import { WebPlugin } from "@capacitor/core";
+export class NetworkPolicyWeb extends WebPlugin {
+    async getMeteredHint() {
+        const saveData = readNavigatorSaveData();
+        // `saveData=true` is a strong signal the user wants metered-mode behavior.
+        // We don't infer "metered=false" from `saveData=false` — that just means
+        // Data Saver isn't on, which says nothing about metering.
+        return {
+            metered: saveData === true ? true : null,
+            source: "android-os",
+        };
+    }
+    async getPathHints() {
+        const saveData = readNavigatorSaveData();
+        return {
+            isExpensive: saveData === true,
+            isConstrained: saveData === true,
+            source: "nw-path-monitor",
+        };
+    }
+}
+function readNavigatorSaveData() {
+    try {
+        const nav = globalThis.navigator;
+        const saveData = nav?.connection?.saveData;
+        return typeof saveData === "boolean" ? saveData : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# 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;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAQ5C,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7C,KAAK,CAAC,cAAc;QAClB,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;QACzC,2EAA2E;QAC3E,yEAAyE;QACzE,0DAA0D;QAC1D,OAAO;YACL,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;YACxC,MAAM,EAAE,YAAY;SACrB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;QACzC,OAAO;YACL,WAAW,EAAE,QAAQ,KAAK,IAAI;YAC9B,aAAa,EAAE,QAAQ,KAAK,IAAI;YAChC,MAAM,EAAE,iBAAiB;SAC1B,CAAC;IACJ,CAAC;CACF;AAED,SAAS,qBAAqB;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,UAAU,CAAC,SAEV,CAAC;QACd,MAAM,QAAQ,GAAG,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC;QAC3C,OAAO,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=web.test.d.ts.map

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

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

package/dist/esm/web.test.js

@@ -0,0 +1,50 @@
+import { afterEach, describe, expect, it } from "vitest";
+import { NetworkPolicyWeb } from "./web";
+function setNavigator(value) {
+    Object.defineProperty(globalThis, "navigator", {
+        configurable: true,
+        value,
+    });
+}
+describe("NetworkPolicyWeb fallback", () => {
+    afterEach(() => {
+        Object.defineProperty(globalThis, "navigator", {
+            configurable: true,
+            value: undefined,
+        });
+    });
+    it("treats browser saveData=true as metered and constrained", async () => {
+        setNavigator({ connection: { saveData: true } });
+        const policy = new NetworkPolicyWeb();
+        await expect(policy.getMeteredHint()).resolves.toEqual({
+            metered: true,
+            source: "android-os",
+        });
+        await expect(policy.getPathHints()).resolves.toEqual({
+            isExpensive: true,
+            isConstrained: true,
+            source: "nw-path-monitor",
+        });
+    });
+    it.each([
+        undefined,
+        {},
+        { connection: null },
+        { connection: { saveData: false } },
+        { connection: { saveData: "true" } },
+        { connection: { saveData: 1 } },
+    ])("falls back conservatively for navigator shape %#", async (navigatorLike) => {
+        setNavigator(navigatorLike);
+        const policy = new NetworkPolicyWeb();
+        await expect(policy.getMeteredHint()).resolves.toEqual({
+            metered: null,
+            source: "android-os",
+        });
+        await expect(policy.getPathHints()).resolves.toEqual({
+            isExpensive: false,
+            isConstrained: false,
+            source: "nw-path-monitor",
+        });
+    });
+});
+//# sourceMappingURL=web.test.js.map

package/dist/esm/web.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.test.js","sourceRoot":"","sources":["../../src/web.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAEzC,SAAS,YAAY,CAAC,KAAc;IAClC,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,WAAW,EAAE;QAC7C,YAAY,EAAE,IAAI;QAClB,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,WAAW,EAAE;YAC7C,YAAY,EAAE,IAAI;YAClB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,YAAY,CAAC,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAEtC,MAAM,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YACrD,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,YAAY;SACrB,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YACnD,WAAW,EAAE,IAAI;YACjB,aAAa,EAAE,IAAI;YACnB,MAAM,EAAE,iBAAiB;SAC1B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC;QACN,SAAS;QACT,EAAE;QACF,EAAE,UAAU,EAAE,IAAI,EAAE;QACpB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;QACnC,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QACpC,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE;KAChC,CAAC,CAAC,kDAAkD,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;QAC7E,YAAY,CAAC,aAAa,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAEtC,MAAM,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YACrD,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,YAAY;SACrB,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YACnD,WAAW,EAAE,KAAK;YAClB,aAAa,EAAE,KAAK;YACpB,MAAM,EAAE,iBAAiB;SAC1B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/plugin.cjs.js

@@ -0,0 +1,80 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+/**
+ * `@elizaos/capacitor-network-policy` — Android `metered` / iOS `isExpensive`
+ * shims for the voice-model auto-updater network policy (R5-versioning §4).
+ *
+ * Registers as `ElizaNetworkPolicy` on the Capacitor bridge. The
+ * platform-agnostic probes in `plugin-local-inference` read the bridge
+ * via `globalThis.ElizaNetworkPolicy` so this module's only job is to
+ * register and install the global.
+ */
+const loadWeb = () => Promise.resolve().then(function () { return web; }).then((m) => new m.NetworkPolicyWeb());
+const NetworkPolicy = core.registerPlugin("ElizaNetworkPolicy", { web: loadWeb });
+/**
+ * Install `globalThis.ElizaNetworkPolicy` so the runtime probe in
+ * `plugin-local-inference/src/services/network-policy.ts` can call into
+ * the native bridge without compile-time Capacitor dependencies.
+ *
+ * Idempotent — re-installing replaces the existing handle with the same
+ * `NetworkPolicy` instance.
+ */
+function installNetworkPolicyGlobal() {
+    globalThis.ElizaNetworkPolicy = NetworkPolicy;
+}
+// Side-effect: install on import so callers that simply
+// `import "@elizaos/capacitor-network-policy"` from the app bootstrap
+// pick up the global without any extra wiring.
+installNetworkPolicyGlobal();
+
+/**
+ * Web fallback for `@elizaos/capacitor-network-policy`.
+ *
+ * Browsers can read `navigator.connection.saveData` (a heuristic for "user
+ * has Data Saver enabled") and `.type` (`cellular` / `wifi` / `ethernet`),
+ * but the WICG spec is partial and Firefox/Safari support is limited. The
+ * fallback returns conservative defaults so the policy decision falls
+ * through to `unknown → ask` — never silently accepts a download on a
+ * potentially-metered link.
+ */
+class NetworkPolicyWeb extends core.WebPlugin {
+    async getMeteredHint() {
+        const saveData = readNavigatorSaveData();
+        // `saveData=true` is a strong signal the user wants metered-mode behavior.
+        // We don't infer "metered=false" from `saveData=false` — that just means
+        // Data Saver isn't on, which says nothing about metering.
+        return {
+            metered: saveData === true ? true : null,
+            source: "android-os",
+        };
+    }
+    async getPathHints() {
+        const saveData = readNavigatorSaveData();
+        return {
+            isExpensive: saveData === true,
+            isConstrained: saveData === true,
+            source: "nw-path-monitor",
+        };
+    }
+}
+function readNavigatorSaveData() {
+    try {
+        const nav = globalThis.navigator;
+        const saveData = nav?.connection?.saveData;
+        return typeof saveData === "boolean" ? saveData : null;
+    }
+    catch {
+        return null;
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    NetworkPolicyWeb: NetworkPolicyWeb
+});
+
+exports.NetworkPolicy = NetworkPolicy;
+exports.installNetworkPolicyGlobal = installNetworkPolicyGlobal;
+//# 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":["/**\n * `@elizaos/capacitor-network-policy` — Android `metered` / iOS `isExpensive`\n * shims for the voice-model auto-updater network policy (R5-versioning §4).\n *\n * Registers as `ElizaNetworkPolicy` on the Capacitor bridge. The\n * platform-agnostic probes in `plugin-local-inference` read the bridge\n * via `globalThis.ElizaNetworkPolicy` so this module's only job is to\n * register and install the global.\n */\nimport { registerPlugin } from \"@capacitor/core\";\nexport * from \"./definitions\";\nconst loadWeb = () => import(\"./web\").then((m) => new m.NetworkPolicyWeb());\nexport const NetworkPolicy = registerPlugin(\"ElizaNetworkPolicy\", { web: loadWeb });\n/**\n * Install `globalThis.ElizaNetworkPolicy` so the runtime probe in\n * `plugin-local-inference/src/services/network-policy.ts` can call into\n * the native bridge without compile-time Capacitor dependencies.\n *\n * Idempotent — re-installing replaces the existing handle with the same\n * `NetworkPolicy` instance.\n */\nexport function installNetworkPolicyGlobal() {\n    globalThis.ElizaNetworkPolicy = NetworkPolicy;\n}\n// Side-effect: install on import so callers that simply\n// `import \"@elizaos/capacitor-network-policy\"` from the app bootstrap\n// pick up the global without any extra wiring.\ninstallNetworkPolicyGlobal();\n//# sourceMappingURL=index.js.map","/**\n * Web fallback for `@elizaos/capacitor-network-policy`.\n *\n * Browsers can read `navigator.connection.saveData` (a heuristic for \"user\n * has Data Saver enabled\") and `.type` (`cellular` / `wifi` / `ethernet`),\n * but the WICG spec is partial and Firefox/Safari support is limited. The\n * fallback returns conservative defaults so the policy decision falls\n * through to `unknown → ask` — never silently accepts a download on a\n * potentially-metered link.\n */\nimport { WebPlugin } from \"@capacitor/core\";\nexport class NetworkPolicyWeb extends WebPlugin {\n    async getMeteredHint() {\n        const saveData = readNavigatorSaveData();\n        // `saveData=true` is a strong signal the user wants metered-mode behavior.\n        // We don't infer \"metered=false\" from `saveData=false` — that just means\n        // Data Saver isn't on, which says nothing about metering.\n        return {\n            metered: saveData === true ? true : null,\n            source: \"android-os\",\n        };\n    }\n    async getPathHints() {\n        const saveData = readNavigatorSaveData();\n        return {\n            isExpensive: saveData === true,\n            isConstrained: saveData === true,\n            source: \"nw-path-monitor\",\n        };\n    }\n}\nfunction readNavigatorSaveData() {\n    try {\n        const nav = globalThis.navigator;\n        const saveData = nav?.connection?.saveData;\n        return typeof saveData === \"boolean\" ? saveData : null;\n    }\n    catch {\n        return null;\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAGA,MAAM,OAAO,GAAG,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,gBAAgB,EAAE,CAAC;AAC/D,MAAC,aAAa,GAAGA,mBAAc,CAAC,oBAAoB,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE;AAClF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,0BAA0B,GAAG;AAC7C,IAAI,UAAU,CAAC,kBAAkB,GAAG,aAAa;AACjD;AACA;AACA;AACA;AACA,0BAA0B,EAAE;;AC3B5B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEO,MAAM,gBAAgB,SAASC,cAAS,CAAC;AAChD,IAAI,MAAM,cAAc,GAAG;AAC3B,QAAQ,MAAM,QAAQ,GAAG,qBAAqB,EAAE;AAChD;AACA;AACA;AACA,QAAQ,OAAO;AACf,YAAY,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,GAAG,IAAI;AACpD,YAAY,MAAM,EAAE,YAAY;AAChC,SAAS;AACT,IAAI;AACJ,IAAI,MAAM,YAAY,GAAG;AACzB,QAAQ,MAAM,QAAQ,GAAG,qBAAqB,EAAE;AAChD,QAAQ,OAAO;AACf,YAAY,WAAW,EAAE,QAAQ,KAAK,IAAI;AAC1C,YAAY,aAAa,EAAE,QAAQ,KAAK,IAAI;AAC5C,YAAY,MAAM,EAAE,iBAAiB;AACrC,SAAS;AACT,IAAI;AACJ;AACA,SAAS,qBAAqB,GAAG;AACjC,IAAI,IAAI;AACR,QAAQ,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS;AACxC,QAAQ,MAAM,QAAQ,GAAG,GAAG,EAAE,UAAU,EAAE,QAAQ;AAClD,QAAQ,OAAO,OAAO,QAAQ,KAAK,SAAS,GAAG,QAAQ,GAAG,IAAI;AAC9D,IAAI;AACJ,IAAI,MAAM;AACV,QAAQ,OAAO,IAAI;AACnB,IAAI;AACJ;;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,83 @@
+var capacitorNetworkPolicy = (function (exports, core) {
+    'use strict';
+
+    /**
+     * `@elizaos/capacitor-network-policy` — Android `metered` / iOS `isExpensive`
+     * shims for the voice-model auto-updater network policy (R5-versioning §4).
+     *
+     * Registers as `ElizaNetworkPolicy` on the Capacitor bridge. The
+     * platform-agnostic probes in `plugin-local-inference` read the bridge
+     * via `globalThis.ElizaNetworkPolicy` so this module's only job is to
+     * register and install the global.
+     */
+    const loadWeb = () => Promise.resolve().then(function () { return web; }).then((m) => new m.NetworkPolicyWeb());
+    const NetworkPolicy = core.registerPlugin("ElizaNetworkPolicy", { web: loadWeb });
+    /**
+     * Install `globalThis.ElizaNetworkPolicy` so the runtime probe in
+     * `plugin-local-inference/src/services/network-policy.ts` can call into
+     * the native bridge without compile-time Capacitor dependencies.
+     *
+     * Idempotent — re-installing replaces the existing handle with the same
+     * `NetworkPolicy` instance.
+     */
+    function installNetworkPolicyGlobal() {
+        globalThis.ElizaNetworkPolicy = NetworkPolicy;
+    }
+    // Side-effect: install on import so callers that simply
+    // `import "@elizaos/capacitor-network-policy"` from the app bootstrap
+    // pick up the global without any extra wiring.
+    installNetworkPolicyGlobal();
+
+    /**
+     * Web fallback for `@elizaos/capacitor-network-policy`.
+     *
+     * Browsers can read `navigator.connection.saveData` (a heuristic for "user
+     * has Data Saver enabled") and `.type` (`cellular` / `wifi` / `ethernet`),
+     * but the WICG spec is partial and Firefox/Safari support is limited. The
+     * fallback returns conservative defaults so the policy decision falls
+     * through to `unknown → ask` — never silently accepts a download on a
+     * potentially-metered link.
+     */
+    class NetworkPolicyWeb extends core.WebPlugin {
+        async getMeteredHint() {
+            const saveData = readNavigatorSaveData();
+            // `saveData=true` is a strong signal the user wants metered-mode behavior.
+            // We don't infer "metered=false" from `saveData=false` — that just means
+            // Data Saver isn't on, which says nothing about metering.
+            return {
+                metered: saveData === true ? true : null,
+                source: "android-os",
+            };
+        }
+        async getPathHints() {
+            const saveData = readNavigatorSaveData();
+            return {
+                isExpensive: saveData === true,
+                isConstrained: saveData === true,
+                source: "nw-path-monitor",
+            };
+        }
+    }
+    function readNavigatorSaveData() {
+        try {
+            const nav = globalThis.navigator;
+            const saveData = nav?.connection?.saveData;
+            return typeof saveData === "boolean" ? saveData : null;
+        }
+        catch {
+            return null;
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        NetworkPolicyWeb: NetworkPolicyWeb
+    });
+
+    exports.NetworkPolicy = NetworkPolicy;
+    exports.installNetworkPolicyGlobal = installNetworkPolicyGlobal;
+
+    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":["/**\n * `@elizaos/capacitor-network-policy` — Android `metered` / iOS `isExpensive`\n * shims for the voice-model auto-updater network policy (R5-versioning §4).\n *\n * Registers as `ElizaNetworkPolicy` on the Capacitor bridge. The\n * platform-agnostic probes in `plugin-local-inference` read the bridge\n * via `globalThis.ElizaNetworkPolicy` so this module's only job is to\n * register and install the global.\n */\nimport { registerPlugin } from \"@capacitor/core\";\nexport * from \"./definitions\";\nconst loadWeb = () => import(\"./web\").then((m) => new m.NetworkPolicyWeb());\nexport const NetworkPolicy = registerPlugin(\"ElizaNetworkPolicy\", { web: loadWeb });\n/**\n * Install `globalThis.ElizaNetworkPolicy` so the runtime probe in\n * `plugin-local-inference/src/services/network-policy.ts` can call into\n * the native bridge without compile-time Capacitor dependencies.\n *\n * Idempotent — re-installing replaces the existing handle with the same\n * `NetworkPolicy` instance.\n */\nexport function installNetworkPolicyGlobal() {\n    globalThis.ElizaNetworkPolicy = NetworkPolicy;\n}\n// Side-effect: install on import so callers that simply\n// `import \"@elizaos/capacitor-network-policy\"` from the app bootstrap\n// pick up the global without any extra wiring.\ninstallNetworkPolicyGlobal();\n//# sourceMappingURL=index.js.map","/**\n * Web fallback for `@elizaos/capacitor-network-policy`.\n *\n * Browsers can read `navigator.connection.saveData` (a heuristic for \"user\n * has Data Saver enabled\") and `.type` (`cellular` / `wifi` / `ethernet`),\n * but the WICG spec is partial and Firefox/Safari support is limited. The\n * fallback returns conservative defaults so the policy decision falls\n * through to `unknown → ask` — never silently accepts a download on a\n * potentially-metered link.\n */\nimport { WebPlugin } from \"@capacitor/core\";\nexport class NetworkPolicyWeb extends WebPlugin {\n    async getMeteredHint() {\n        const saveData = readNavigatorSaveData();\n        // `saveData=true` is a strong signal the user wants metered-mode behavior.\n        // We don't infer \"metered=false\" from `saveData=false` — that just means\n        // Data Saver isn't on, which says nothing about metering.\n        return {\n            metered: saveData === true ? true : null,\n            source: \"android-os\",\n        };\n    }\n    async getPathHints() {\n        const saveData = readNavigatorSaveData();\n        return {\n            isExpensive: saveData === true,\n            isConstrained: saveData === true,\n            source: \"nw-path-monitor\",\n        };\n    }\n}\nfunction readNavigatorSaveData() {\n    try {\n        const nav = globalThis.navigator;\n        const saveData = nav?.connection?.saveData;\n        return typeof saveData === \"boolean\" ? saveData : null;\n    }\n    catch {\n        return null;\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;IAAA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IAGA,MAAM,OAAO,GAAG,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,gBAAgB,EAAE,CAAC;AAC/D,UAAC,aAAa,GAAGA,mBAAc,CAAC,oBAAoB,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE;IAClF;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACO,SAAS,0BAA0B,GAAG;IAC7C,IAAI,UAAU,CAAC,kBAAkB,GAAG,aAAa;IACjD;IACA;IACA;IACA;IACA,0BAA0B,EAAE;;IC3B5B;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IAEO,MAAM,gBAAgB,SAASC,cAAS,CAAC;IAChD,IAAI,MAAM,cAAc,GAAG;IAC3B,QAAQ,MAAM,QAAQ,GAAG,qBAAqB,EAAE;IAChD;IACA;IACA;IACA,QAAQ,OAAO;IACf,YAAY,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,GAAG,IAAI;IACpD,YAAY,MAAM,EAAE,YAAY;IAChC,SAAS;IACT,IAAI;IACJ,IAAI,MAAM,YAAY,GAAG;IACzB,QAAQ,MAAM,QAAQ,GAAG,qBAAqB,EAAE;IAChD,QAAQ,OAAO;IACf,YAAY,WAAW,EAAE,QAAQ,KAAK,IAAI;IAC1C,YAAY,aAAa,EAAE,QAAQ,KAAK,IAAI;IAC5C,YAAY,MAAM,EAAE,iBAAiB;IACrC,SAAS;IACT,IAAI;IACJ;IACA,SAAS,qBAAqB,GAAG;IACjC,IAAI,IAAI;IACR,QAAQ,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS;IACxC,QAAQ,MAAM,QAAQ,GAAG,GAAG,EAAE,UAAU,EAAE,QAAQ;IAClD,QAAQ,OAAO,OAAO,QAAQ,KAAK,SAAS,GAAG,QAAQ,GAAG,IAAI;IAC9D,IAAI;IACJ,IAAI,MAAM;IACV,QAAQ,OAAO,IAAI;IACnB,IAAI;IACJ;;;;;;;;;;;;;;;;"}

package/ios/Sources/NetworkPolicyPlugin/NetworkPolicyPlugin.swift

@@ -0,0 +1,70 @@
+import Foundation
+import Capacitor
+import Network
+
+/// Native iOS implementation of the `ElizaNetworkPolicy` Capacitor plugin
+/// (R5-versioning §4.2).
+///
+/// Bridges `NWPathMonitor` to the TypeScript `NetworkPolicyPlugin`
+/// interface. The voice-model auto-updater calls `getPathHints()` before
+/// every download to gate on `isExpensive` (Apple's "treat as metered"
+/// flag) and `isConstrained` (Low Data Mode).
+///
+/// Implementation note: the plugin keeps one long-lived `NWPathMonitor`
+/// instance and reads its `currentPath` on each call. This avoids the
+/// cost of starting/stopping a monitor per request and gives us a "live"
+/// path snapshot — `NWPathMonitor.currentPath` is updated as the OS sees
+/// path changes (cellular ↔ Wi-Fi handover, hotspot toggle, etc.).
+@objc(ElizaNetworkPolicyPlugin)
+public class ElizaNetworkPolicyPlugin: CAPPlugin, CAPBridgedPlugin {
+    public let identifier = "ElizaNetworkPolicyPlugin"
+    public let jsName = "ElizaNetworkPolicy"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "getMeteredHint", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "getPathHints", returnType: CAPPluginReturnPromise),
+    ]
+
+    private let monitor = NWPathMonitor()
+    private let monitorQueue = DispatchQueue(label: "ai.eliza.network-policy.monitor", qos: .utility)
+    private var started = false
+
+    public override func load() {
+        startIfNeeded()
+    }
+
+    deinit {
+        if started {
+            monitor.cancel()
+        }
+    }
+
+    private func startIfNeeded() {
+        if started { return }
+        // The `pathUpdateHandler` is intentionally empty — we only read
+        // `monitor.currentPath` on demand. The handler is required for the
+        // monitor to publish path updates internally.
+        monitor.pathUpdateHandler = { _ in }
+        monitor.start(queue: monitorQueue)
+        started = true
+    }
+
+    /// Android-only safe fallback on iOS. Always resolves with the shared
+    /// response shape so the JS bridge can call `getMeteredHint()` uniformly across
+    /// platforms; iOS callers should prefer `getPathHints()`.
+    @objc func getMeteredHint(_ call: CAPPluginCall) {
+        var response: [String: Any] = ["source": "android-os"]
+        response["metered"] = NSNull()
+        call.resolve(response)
+    }
+
+    @objc func getPathHints(_ call: CAPPluginCall) {
+        startIfNeeded()
+        let path = monitor.currentPath
+        let response: [String: Any] = [
+            "isExpensive": path.isExpensive,
+            "isConstrained": path.isConstrained,
+            "source": "nw-path-monitor",
+        ]
+        call.resolve(response)
+    }
+}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@elizaos/capacitor-network-policy",
+  "version": "2.0.11-beta.7",
+  "description": "Android + iOS native shims surfacing the `metered` / `isExpensive` hints used by the voice-model auto-updater (R5-versioning §4).",
+  "main": "./dist/plugin.cjs.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "bun": "./src/index.ts",
+      "development": "./src/index.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/plugin.cjs.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "android/src/main/",
+    "android/build.gradle",
+    "ios/Sources/",
+    "ios/Package.swift",
+    "ElizaosCapacitorNetworkPolicy.podspec",
+    "dist/",
+    "dist"
+  ],
+  "scripts": {
+    "build": "node ../../packages/scripts/with-package-build-lock.mjs plugins/plugin-native-network-policy -- bun run build:unlocked",
+    "clean": "node ../../packages/scripts/rm-path-recursive.mjs dist",
+    "test": "vitest run",
+    "prepublishOnly": "bun run build",
+    "build:unlocked": "bun run clean && tsc && bunx rollup -c rollup.config.mjs"
+  },
+  "license": "MIT",
+  "capacitor": {
+    "android": {
+      "src": "android"
+    },
+    "ios": {
+      "src": "ios"
+    }
+  },
+  "devDependencies": {
+    "@capacitor/core": "^8.3.1",
+    "rollup": "^4.60.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.0.0"
+  },
+  "peerDependencies": {
+    "@capacitor/core": "^8.3.1"
+  },
+  "elizaos": {
+    "platforms": [
+      "browser",
+      "node"
+    ],
+    "runtime": "both",
+    "platformDetails": {
+      "browser": "Web fallback returns metered=null / isExpensive=false so callers downgrade to ask.",
+      "node": "Server-side consumers read the bridge through the runtime probe; no Capacitor required."
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "cdbc876f793d96073d7eb0d09715a031ce0cd32e"
+}