@elizaos/agent 2.0.0-alpha.441 → 2.0.0-alpha.501

package/packages/app-core/src/onboarding/mobile-runtime-mode.d.ts

@@ -1,6 +1,6 @@
 import type { OnboardingServerTarget } from "./server-target";
 export declare const MOBILE_RUNTIME_MODE_STORAGE_KEY = "eliza:mobile-runtime-mode";
-export type MobileRuntimeMode = "remote-mac" | "cloud" | "cloud-hybrid";
+export type MobileRuntimeMode = "remote-mac" | "cloud" | "cloud-hybrid" | "local";
 export declare function normalizeMobileRuntimeMode(value: string | null | undefined): MobileRuntimeMode | null;
 export declare function mobileRuntimeModeForServerTarget(target: OnboardingServerTarget): MobileRuntimeMode | null;
 export declare function readPersistedMobileRuntimeMode(): MobileRuntimeMode | null;

package/packages/app-core/src/onboarding/mobile-runtime-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mobile-runtime-mode.d.ts","sourceRoot":"","sources":["../../../../../../app-core/src/onboarding/mobile-runtime-mode.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,eAAO,MAAM,+BAA+B,8BAA8B,CAAC;AAE3E,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,OAAO,GAAG,cAAc,CAAC;AAExE,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,iBAAiB,GAAG,IAAI,CAU1B;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,sBAAsB,GAC7B,iBAAiB,GAAG,IAAI,CAW1B;AAED,wBAAgB,8BAA8B,IAAI,iBAAiB,GAAG,IAAI,CASzE;AAED,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,sBAAsB,GAC7B,IAAI,CAkBN"}
+{"version":3,"file":"mobile-runtime-mode.d.ts","sourceRoot":"","sources":["../../../../../../app-core/src/onboarding/mobile-runtime-mode.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,eAAO,MAAM,+BAA+B,8BAA8B,CAAC;AAE3E,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,OAAO,GACP,cAAc,GACd,OAAO,CAAC;AAEZ,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,iBAAiB,GAAG,IAAI,CAW1B;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,sBAAsB,GAC7B,iBAAiB,GAAG,IAAI,CAa1B;AAED,wBAAgB,8BAA8B,IAAI,iBAAiB,GAAG,IAAI,CASzE;AAED,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,sBAAsB,GAC7B,IAAI,CAkBN"}

package/packages/app-core/src/onboarding/mobile-runtime-mode.js

@@ -6,6 +6,7 @@ export function normalizeMobileRuntimeMode(value) {
         case "remote-mac":
         case "cloud":
         case "cloud-hybrid":
+        case "local":
             return normalized;
         default:
             return null;
@@ -19,6 +20,8 @@ export function mobileRuntimeModeForServerTarget(target) {
             return "cloud";
         case "elizacloud-hybrid":
             return "cloud-hybrid";
+        case "local":
+            return "local";
         default:
             return null;
     }

package/packages/app-core/src/onboarding/probe-local-agent.d.ts

@@ -0,0 +1,44 @@
+/**
+ * probe-local-agent.ts
+ *
+ * Liveness probe for an on-device Eliza agent listening on loopback.
+ *
+ * Phase E of the local-agent-on-Android effort gates the "Local Agent" tile
+ * in `RuntimeGate` behind a real check that the agent's `/api/health`
+ * endpoint is reachable and reports `{ ok: true }`. Without this, a user on
+ * Android with no native agent installed would see a tile that does nothing.
+ *
+ * Result is cached for `PROBE_CACHE_TTL_MS` so repeated renders during the
+ * onboarding flow do not hammer loopback. The cache is keyed by URL.
+ *
+ * `clearLocalAgentProbeCache()` resets the cache between tests.
+ */
+export declare const DEFAULT_LOCAL_AGENT_HEALTH_URL = "http://127.0.0.1:31337/api/health";
+/** Reset the probe cache. Test-only. */
+export declare function clearLocalAgentProbeCache(): void;
+export interface LocalOptionGate {
+    isDesktop: boolean;
+    isDev: boolean;
+    isAndroid: boolean;
+}
+/**
+ * Whether the "Local Agent" tile should appear on the onboarding chooser.
+ *
+ * - Desktop and dev builds always show it (they manage the runtime themselves).
+ * - On Android the tile only appears when the on-device agent is actually
+ *   responding on `127.0.0.1:31337` — there is no point showing an option
+ *   that would immediately fail.
+ * - Other platforms (iOS, plain web) do not host a local agent.
+ */
+export declare function shouldShowLocalOption(gate: LocalOptionGate): Promise<boolean>;
+/**
+ * Probes a local agent's `/api/health` endpoint with a timeout.
+ *
+ * Returns `true` only when the response is HTTP 200 and the JSON body
+ * contains `{ ok: true }`. Any other outcome (timeout, network error,
+ * non-200, non-JSON, missing field) returns `false`.
+ *
+ * Results are memoized per URL for 30 seconds.
+ */
+export declare function probeLocalAgent(timeoutMs?: number, url?: string): Promise<boolean>;
+//# sourceMappingURL=probe-local-agent.d.ts.map

package/packages/app-core/src/onboarding/probe-local-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-local-agent.d.ts","sourceRoot":"","sources":["../../../../../../app-core/src/onboarding/probe-local-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,8BAA8B,sCACN,CAAC;AAkBtC,wCAAwC;AACxC,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,OAAO,CAAC,CAIlB;AAiDD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,SAAS,SAAO,EAChB,GAAG,GAAE,MAAuC,GAC3C,OAAO,CAAC,OAAO,CAAC,CA0BlB"}

package/packages/app-core/src/onboarding/probe-local-agent.js

@@ -0,0 +1,126 @@
+/**
+ * probe-local-agent.ts
+ *
+ * Liveness probe for an on-device Eliza agent listening on loopback.
+ *
+ * Phase E of the local-agent-on-Android effort gates the "Local Agent" tile
+ * in `RuntimeGate` behind a real check that the agent's `/api/health`
+ * endpoint is reachable and reports `{ ok: true }`. Without this, a user on
+ * Android with no native agent installed would see a tile that does nothing.
+ *
+ * Result is cached for `PROBE_CACHE_TTL_MS` so repeated renders during the
+ * onboarding flow do not hammer loopback. The cache is keyed by URL.
+ *
+ * `clearLocalAgentProbeCache()` resets the cache between tests.
+ */
+export const DEFAULT_LOCAL_AGENT_HEALTH_URL = "http://127.0.0.1:31337/api/health";
+// Positive results are cached longer so re-renders during onboarding don't
+// hammer loopback. Negative results are short-lived because the agent may
+// finish booting moments after the first probe — without a short negative
+// TTL the user sees "no local agent" for 30 s after a reboot even though
+// the agent is up. 3 s lets `RuntimeGate`'s render cycle re-poll naturally.
+const PROBE_POSITIVE_CACHE_TTL_MS = 30_000;
+const PROBE_NEGATIVE_CACHE_TTL_MS = 3_000;
+const resultCache = new Map();
+const inflight = new Map();
+/** Reset the probe cache. Test-only. */
+export function clearLocalAgentProbeCache() {
+    resultCache.clear();
+    inflight.clear();
+}
+/**
+ * Whether the "Local Agent" tile should appear on the onboarding chooser.
+ *
+ * - Desktop and dev builds always show it (they manage the runtime themselves).
+ * - On Android the tile only appears when the on-device agent is actually
+ *   responding on `127.0.0.1:31337` — there is no point showing an option
+ *   that would immediately fail.
+ * - Other platforms (iOS, plain web) do not host a local agent.
+ */
+export async function shouldShowLocalOption(gate) {
+    if (gate.isDesktop || gate.isDev)
+        return true;
+    if (!gate.isAndroid)
+        return false;
+    return probeLocalAgent();
+}
+async function runProbe(url, timeoutMs) {
+    if (typeof fetch !== "function")
+        return false;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    let res;
+    try {
+        res = await fetch(url, {
+            method: "GET",
+            signal: controller.signal,
+            headers: { Accept: "application/json" },
+        });
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    if (!res.ok)
+        return false;
+    let body;
+    try {
+        body = await res.json();
+    }
+    catch {
+        return false;
+    }
+    // The agent's /api/health responds with one of two shapes depending on
+    // version:
+    //   { ok: true, agent, bun, uptime }                 ← spike stub
+    //   { ready: true, runtime: "ok", database: "ok",
+    //     agentState: "running", uptime, ...}            ← real @elizaos/agent
+    // Treat either as healthy. `ok === true` covers the stub; `ready === true`
+    // and `agentState === "running"` cover the real runtime. Without this, the
+    // RuntimeGate tile stays hidden even when the agent is plainly up.
+    if (typeof body !== "object" || body === null)
+        return false;
+    const b = body;
+    if (b.ok === true)
+        return true;
+    if (b.ready === true)
+        return true;
+    if (b.agentState === "running")
+        return true;
+    return false;
+}
+/**
+ * Probes a local agent's `/api/health` endpoint with a timeout.
+ *
+ * Returns `true` only when the response is HTTP 200 and the JSON body
+ * contains `{ ok: true }`. Any other outcome (timeout, network error,
+ * non-200, non-JSON, missing field) returns `false`.
+ *
+ * Results are memoized per URL for 30 seconds.
+ */
+export async function probeLocalAgent(timeoutMs = 1500, url = DEFAULT_LOCAL_AGENT_HEALTH_URL) {
+    const now = Date.now();
+    const cached = resultCache.get(url);
+    if (cached && cached.expiresAt > now) {
+        return cached.result;
+    }
+    const existing = inflight.get(url);
+    if (existing)
+        return existing;
+    const promise = runProbe(url, timeoutMs)
+        .then((result) => {
+        resultCache.set(url, {
+            result,
+            expiresAt: Date.now() +
+                (result ? PROBE_POSITIVE_CACHE_TTL_MS : PROBE_NEGATIVE_CACHE_TTL_MS),
+        });
+        return result;
+    })
+        .finally(() => {
+        inflight.delete(url);
+    });
+    inflight.set(url, promise);
+    return promise;
+}

package/packages/app-core/src/onboarding-config.d.ts

@@ -26,6 +26,7 @@ export interface BuildOnboardingConnectionArgs {
     onboardingFeatureCrypto?: boolean;
     onboardingFeatureBrowser?: boolean;
     onboardingFeatureComputerUse?: boolean;
+    onboardingUseLocalEmbeddings?: boolean;
 }
 /** Feature selections from the onboarding features step. */
 export interface OnboardingFeatureSetup {

package/packages/app-core/src/onboarding-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding-config.d.ts","sourceRoot":"","sources":["../../../../../app-core/src/onboarding-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAE7B,KAAK,0BAA0B,EAI/B,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,6BAA6B;IAC5C,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yBAAyB,EAAE,MAAM,CAAC;IAClC,yBAAyB,EAAE,OAAO,CAAC;IACnC,uBAAuB,EAAE,MAAM,CAAC;IAChC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IAEtC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,4BAA4B,CAAC,EAAE,OAAO,CAAC;CACxC;AAED,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE;QACV,QAAQ,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,CAAA;SAAE,CAAC;QAChC,OAAO,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,CAAA;SAAE,CAAC;KAChC,CAAC;IACF,YAAY,EAAE;QACZ,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,kCAAkC;IACjD,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,cAAc,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACrD,cAAc,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACjD,gBAAgB,EAAE,0BAA0B,GAAG,SAAS,CAAC;IACzD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,sBAAsB,GAAG,SAAS,CAAC;CAClD;AAuBD,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yBAAyB,EAAE,MAAM,CAAC;CACnC,GAAG,MAAM,GAAG,SAAS,CAKrB;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,6BAA6B,GAClC,kCAAkC,CAmLpC"}
+{"version":3,"file":"onboarding-config.d.ts","sourceRoot":"","sources":["../../../../../app-core/src/onboarding-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAE7B,KAAK,0BAA0B,EAI/B,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,6BAA6B;IAC5C,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yBAAyB,EAAE,MAAM,CAAC;IAClC,yBAAyB,EAAE,OAAO,CAAC;IACnC,uBAAuB,EAAE,MAAM,CAAC;IAChC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IAEtC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,4BAA4B,CAAC,EAAE,OAAO,CAAC;CACxC;AAED,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE;QACV,QAAQ,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,CAAA;SAAE,CAAC;QAChC,OAAO,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,CAAA;SAAE,CAAC;KAChC,CAAC;IACF,YAAY,EAAE;QACZ,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,kCAAkC;IACjD,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,cAAc,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACrD,cAAc,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACjD,gBAAgB,EAAE,0BAA0B,GAAG,SAAS,CAAC;IACzD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,sBAAsB,GAAG,SAAS,CAAC;CAClD;AAuBD,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yBAAyB,EAAE,MAAM,CAAC;CACnC,GAAG,MAAM,GAAG,SAAS,CAKrB;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,6BAA6B,GAClC,kCAAkC,CAsLpC"}

package/packages/app-core/src/onboarding-config.js

@@ -113,6 +113,9 @@ export function buildOnboardingRuntimeConfig(args) {
             base: serviceRouting,
             includeInference: shouldConfigureRuntimeProvider &&
                 args.onboardingProvider === "elizacloud",
+            excludeServices: args.onboardingUseLocalEmbeddings
+                ? ["embeddings"]
+                : undefined,
             nanoModel,
             smallModel,
             mediumModel,

package/packages/app-core/src/platform/init.d.ts

@@ -6,6 +6,14 @@ export declare const isAndroid: boolean;
 export declare function isDesktopPlatform(): boolean;
 /** True when the runtime can spin up a local agent — desktop or dev server. */
 export declare function canRunLocal(): boolean;
+/**
+ * True when the platform might host a local agent that the UI can reach over
+ * loopback. Used to decide whether the RuntimeGate's "Local Agent" tile
+ * should run a liveness probe before being shown. Desktop and dev mode
+ * always qualify; Android qualifies because Phase B's `MiladyAgentService`
+ * starts the bundled agent on `127.0.0.1:31337`.
+ */
+export declare function canHostLocalAgent(): boolean;
 export declare function isWebPlatform(): boolean;
 export interface ShareTargetFile {
     name: string;

package/packages/app-core/src/platform/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../../app-core/src/platform/init.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAsBvD,eAAO,MAAM,QAAQ,QAEA,CAAC;AACtB,eAAO,MAAM,QAAQ,SAAoB,CAAC;AAC1C,eAAO,MAAM,KAAK,SAAqB,CAAC;AACxC,eAAO,MAAM,SAAS,SAAyB,CAAC;AAEhD,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAID,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,uBAAuB,CAAC,EAAE,kBAAkB,EAAE,CAAC;KAChD;CACF;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,kBAAkB,EAC3B,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,EACtD,SAAS,EAAE,MAAM,GAChB,IAAI,CAMN;AAID,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAChD,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,gBAAgB,GACzB,IAAI,CAsEN;AAID,wBAAgB,mBAAmB,IAAI,IAAI,CAqB1C;AAID,wBAAgB,cAAc,IAAI,OAAO,CAMxC;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAuC1C"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../../app-core/src/platform/init.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAsBvD,eAAO,MAAM,QAAQ,QAEA,CAAC;AACtB,eAAO,MAAM,QAAQ,SAAoB,CAAC;AAC1C,eAAO,MAAM,KAAK,SAAqB,CAAC;AACxC,eAAO,MAAM,SAAS,SAAyB,CAAC;AAEhD,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAID,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,uBAAuB,CAAC,EAAE,kBAAkB,EAAE,CAAC;KAChD;CACF;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,kBAAkB,EAC3B,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,EACtD,SAAS,EAAE,MAAM,GAChB,IAAI,CAMN;AAID,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAChD,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,gBAAgB,GACzB,IAAI,CAsEN;AAID,wBAAgB,mBAAmB,IAAI,IAAI,CAqB1C;AAID,wBAAgB,cAAc,IAAI,OAAO,CAMxC;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAuC1C"}

package/packages/app-core/src/platform/init.js

@@ -29,6 +29,16 @@ export function isDesktopPlatform() {
 export function canRunLocal() {
     return isDesktopPlatform() || Boolean(import.meta.env.DEV);
 }
+/**
+ * True when the platform might host a local agent that the UI can reach over
+ * loopback. Used to decide whether the RuntimeGate's "Local Agent" tile
+ * should run a liveness probe before being shown. Desktop and dev mode
+ * always qualify; Android qualifies because Phase B's `MiladyAgentService`
+ * starts the bundled agent on `127.0.0.1:31337`.
+ */
+export function canHostLocalAgent() {
+    return canRunLocal() || isAndroid;
+}
 export function isWebPlatform() {
     return detected.platform === "web" && !isElectrobunRuntime();
 }

package/packages/app-core/src/services/account-pool.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Multi-account selection brain.
+ *
+ * Owns the runtime decision "which `LinkedAccountConfig` should serve this
+ * request?" given a strategy (priority / round-robin / least-used /
+ * quota-aware), session affinity, and per-account health state.
+ *
+ * The pool never reads OAuth credentials directly — callers resolve them
+ * via `getAccessToken(providerId, accountId)` from `@elizaos/agent` once
+ * the pool returns an account. Health, priority, and usage live in this
+ * layer; the OAuth blob lives under `~/.eliza/auth/` (see WS1's
+ * `account-storage.ts`).
+ *
+ * Persistence: the pool layers rich metadata (priority, enabled, health,
+ * usage) on top of WS1's credential records. The metadata is written to
+ * `<ELIZA_HOME>/auth/_pool-metadata.json` atomically so it survives
+ * process restarts and is independent of WS3's eventual `milady.json`
+ * field — when WS3 lands its CRUD API on top of `LinkedAccountsConfig`
+ * we can swap `createDefaultAccountPool()`'s deps without touching the
+ * pool itself.
+ */
+import type { LinkedAccountConfig, LinkedAccountProviderId, LinkedAccountsConfig } from "@elizaos/shared";
+export type Strategy = "priority" | "round-robin" | "least-used" | "quota-aware";
+export type PoolProviderId = LinkedAccountProviderId | "anthropic-api" | "openai-api";
+export interface AccountPoolDeps {
+    /** Read the current `LinkedAccountsConfig` (live). */
+    readAccounts: () => Record<string, LinkedAccountConfig>;
+    /** Persist a single account's mutated fields. */
+    writeAccount: (account: LinkedAccountConfig) => Promise<void>;
+    /** Remove the metadata overlay for an account. */
+    deleteAccount?: (providerId: PoolProviderId, accountId: string) => Promise<void>;
+}
+export interface SelectInput {
+    providerId: PoolProviderId;
+    /** Stable session key for affinity (e.g. agent id + run id). */
+    sessionKey?: string;
+    /** Defaults to `"priority"`. */
+    strategy?: Strategy;
+    /** Explicit pool; defaults to all enabled accounts for `providerId`. */
+    accountIds?: string[];
+    /** Account IDs to skip (e.g. just-failed accounts). */
+    exclude?: string[];
+}
+export declare class AccountPool {
+    private readonly deps;
+    private readonly affinity;
+    private readonly roundRobinCursor;
+    constructor(deps: AccountPoolDeps);
+    select(input: SelectInput): Promise<LinkedAccountConfig | null>;
+    private filterEligible;
+    private applyStrategy;
+    list(providerId?: PoolProviderId): LinkedAccountConfig[];
+    get(accountId: string): LinkedAccountConfig | null;
+    upsert(account: LinkedAccountConfig): Promise<void>;
+    deleteMetadata(providerId: PoolProviderId, accountId: string): Promise<void>;
+    recordCall(accountId: string, result: {
+        tokens?: number;
+        latencyMs?: number;
+        ok: boolean;
+        errorCode?: string;
+        model?: string;
+    }): Promise<void>;
+    refreshUsage(accountId: string, accessToken: string, opts?: {
+        codexAccountId?: string;
+        fetch?: typeof fetch;
+    }): Promise<void>;
+    markRateLimited(accountId: string, untilMs: number, detail?: string): Promise<void>;
+    markNeedsReauth(accountId: string, detail?: string): Promise<void>;
+    markInvalid(accountId: string, detail?: string): Promise<void>;
+    markHealthy(accountId: string): Promise<void>;
+    /**
+     * Re-probe accounts whose `health` is non-OK and whose `healthDetail.until`
+     * has passed (or is absent). Used by background sweepers to recover
+     * temporarily flagged accounts. We don't load access tokens here — the
+     * caller probes via `refreshUsage` separately.
+     */
+    reprobeFlagged(): Promise<string[]>;
+}
+/**
+ * Module-level singleton for the default pool wired against WS1's
+ * `account-storage` and the pool-owned metadata file. Plugins / runtime
+ * resolvers should import `getDefaultAccountPool()` rather than building
+ * a new pool. WS3 may later swap the default deps to read/write the
+ * `LinkedAccountsConfig` field directly out of `milady.json`; consumers
+ * keep the same accessor.
+ */
+export declare function getDefaultAccountPool(): AccountPool;
+/**
+ * @deprecated kept for compatibility with the WS2 spec naming. Use
+ * {@link getDefaultAccountPool}.
+ */
+export declare function createDefaultAccountPool(): AccountPool;
+/**
+ * Resets the cached singleton. Test-only.
+ */
+export declare function __resetDefaultAccountPoolForTests(): void;
+export type { LinkedAccountsConfig };
+//# sourceMappingURL=account-pool.d.ts.map

package/packages/app-core/src/services/account-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-pool.d.ts","sourceRoot":"","sources":["../../../../../../app-core/src/services/account-pool.ts"],"names":[],"mappings":"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"}