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

package/services/steward-sidecar/wallet-setup.js

@@ -3,8 +3,9 @@
  */
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { fingerprintRandomToken, generateApiKey } from "./helpers";
-import { CREDENTIALS_FILE, DEFAULT_AGENT_ID, DEFAULT_AGENT_NAME, DEFAULT_TENANT_ID, DEFAULT_TENANT_NAME, } from "./types";
+import { logger } from "@elizaos/core";
+import { fingerprintRandomToken, generateApiKey } from "./helpers.js";
+import { CREDENTIALS_FILE, DEFAULT_AGENT_ID, DEFAULT_AGENT_NAME, DEFAULT_TENANT_ID, DEFAULT_TENANT_NAME, } from "./types.js";
 /**
  * Ensure wallet is set up: verify existing wallet or perform first-launch setup.
  */
@@ -26,19 +27,19 @@ async function verifyExistingWallet(credentials, apiBase, updateStatus) {
         if (response.ok) {
             const result = (await response.json());
             if (result.ok && result.data?.walletAddress) {
-                console.log(`[StewardSidecar] Wallet verified: ${result.data.walletAddress}`);
+                logger.info(`[StewardSidecar] Wallet verified: ${result.data.walletAddress}`);
                 updateStatus({ walletAddress: result.data.walletAddress });
                 return;
             }
         }
-        console.warn("[StewardSidecar] Wallet verification returned unexpected result, continuing");
+        logger.warn("[StewardSidecar] Wallet verification returned unexpected result, continuing");
     }
     catch (err) {
-        console.warn("[StewardSidecar] Wallet verification failed:", err instanceof Error ? err.message : err);
+        logger.warn("[StewardSidecar] Wallet verification failed", err instanceof Error ? err.message : String(err));
     }
 }
 async function performFirstLaunchSetup(apiBase, _masterPassword, dataDir, updateStatus) {
-    console.log("[StewardSidecar] First launch - creating tenant and wallet");
+    logger.info("[StewardSidecar] First launch - creating tenant and wallet");
     // 1. Create tenant
     const tenantApiKey = generateApiKey();
     const tenantResponse = await fetch(`${apiBase}/tenants`, {
@@ -109,6 +110,6 @@ async function performFirstLaunchSetup(apiBase, _masterPassword, dataDir, update
         agentId: credentials.agentId,
         tenantId: credentials.tenantId,
     });
-    console.log(`[StewardSidecar] Wallet created: ${credentials.walletAddress}`);
+    logger.info(`[StewardSidecar] Wallet created: ${credentials.walletAddress}`);
     return credentials;
 }

package/services/steward-sidecar.d.ts

@@ -13,7 +13,7 @@
  * database (PGLite when available, or standard Postgres via DATABASE_URL).
  *
  * Usage:
- *   const sidecar = new StewardSidecar({ dataDir: '~/.eliza/steward/' });
+ *   const sidecar = new StewardSidecar({ dataDir: '~/.local/state/eliza/steward/' });
  *   await sidecar.start();  // starts process + first-launch setup
  *   const client = sidecar.getClient();
  *   await sidecar.stop();
@@ -60,7 +60,7 @@ export declare class StewardSidecar {
  * Create a StewardSidecar with standard defaults.
  *
  * Uses environment variables for overrides:
- *   - STEWARD_DATA_DIR: data directory (default: ~/.eliza/steward/)
+ *   - STEWARD_DATA_DIR: data directory (default: ~/.local/state/eliza/steward/)
  *   - STEWARD_PORT: API port (default: 3200)
  *   - STEWARD_MASTER_PASSWORD: vault encryption password
  *   - STEWARD_ENTRY_POINT: path to steward API entry

package/services/steward-sidecar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"steward-sidecar.d.ts","sourceRoot":"","sources":["../../../../../src/services/steward-sidecar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAqBH,OAAO,EAML,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,cAAc,GACf,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AA8BjC,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAGS;IACvB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAKC;IAChB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,gBAAgB,CAAgC;gBAE5C,MAAM,EAAE,oBAAoB;IAuBxC;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAwC5C,mDAAmD;IAC7C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0C3B,0CAA0C;IACpC,OAAO,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAM9C,kCAAkC;IAClC,SAAS,IAAI,oBAAoB;IAIjC,wCAAwC;IACxC,UAAU,IAAI,MAAM;IAIpB,+DAA+D;IAC/D,cAAc,IAAI,kBAAkB,GAAG,IAAI;IAI3C,4DAA4D;IAC5D,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC,wDAAwD;IACxD,aAAa,IAAI,MAAM,GAAG,IAAI;YAMhB,aAAa;YAwCb,uBAAuB;YA8BvB,YAAY;YA4HZ,WAAW;IAqDzB,OAAO,CAAC,YAAY;CAIrB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACxC,cAAc,CAmBhB"}
+{"version":3,"file":"steward-sidecar.d.ts","sourceRoot":"","sources":["../../../../../src/services/steward-sidecar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAsBH,OAAO,EAML,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,cAAc,GACf,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AA8BjC,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAGS;IACvB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAKC;IAChB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,gBAAgB,CAAgC;gBAE5C,MAAM,EAAE,oBAAoB;IAuBxC;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAwC5C,mDAAmD;IAC7C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0C3B,0CAA0C;IACpC,OAAO,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAM9C,kCAAkC;IAClC,SAAS,IAAI,oBAAoB;IAIjC,wCAAwC;IACxC,UAAU,IAAI,MAAM;IAIpB,+DAA+D;IAC/D,cAAc,IAAI,kBAAkB,GAAG,IAAI;IAI3C,4DAA4D;IAC5D,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC,wDAAwD;IACxD,aAAa,IAAI,MAAM,GAAG,IAAI;YAMhB,aAAa;YAwCb,uBAAuB;YA8BvB,YAAY;YA2HZ,WAAW;IAqDzB,OAAO,CAAC,YAAY;CAIrB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACxC,cAAc,CA0BhB"}

package/services/steward-sidecar.js

@@ -13,7 +13,7 @@
  * database (PGLite when available, or standard Postgres via DATABASE_URL).
  *
  * Usage:
- *   const sidecar = new StewardSidecar({ dataDir: '~/.eliza/steward/' });
+ *   const sidecar = new StewardSidecar({ dataDir: '~/.local/state/eliza/steward/' });
  *   await sidecar.start();  // starts process + first-launch setup
  *   const client = sidecar.getClient();
  *   await sidecar.stop();
@@ -27,13 +27,14 @@
 import * as childProcess from "node:child_process";
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { waitForHealthy } from "./steward-sidecar/health-check";
-import { allocateFirstFreeLoopbackPort, generateMasterPassword, resolveDataDir, } from "./steward-sidecar/helpers";
-import { findStewardEntryPoint, pipeOutput, } from "./steward-sidecar/process-management";
-import { CREDENTIALS_FILE, DEFAULT_MAX_RESTARTS, DEFAULT_PORT, INITIAL_BACKOFF_MS, MAX_BACKOFF_MS, } from "./steward-sidecar/types";
-import { ensureWalletSetup } from "./steward-sidecar/wallet-setup";
-// Re-export helpers for external consumers (used by @elizaos/app-steward).
-export { allocateFirstFreeLoopbackPort, fingerprintRandomToken, generateApiKey, generateMasterPassword, resolveDataDir, } from "./steward-sidecar/helpers";
+import { logger } from "@elizaos/core";
+import { waitForHealthy } from "./steward-sidecar/health-check.js";
+import { allocateFirstFreeLoopbackPort, generateMasterPassword, resolveDataDir, } from "./steward-sidecar/helpers.js";
+import { findStewardEntryPoint, pipeOutput, } from "./steward-sidecar/process-management.js";
+import { CREDENTIALS_FILE, DEFAULT_MAX_RESTARTS, DEFAULT_PORT, INITIAL_BACKOFF_MS, MAX_BACKOFF_MS, } from "./steward-sidecar/types.js";
+import { ensureWalletSetup } from "./steward-sidecar/wallet-setup.js";
+// Re-export helpers for external consumers (used by @elizaos/plugin-steward-app).
+export { allocateFirstFreeLoopbackPort, fingerprintRandomToken, generateApiKey, generateMasterPassword, resolveDataDir, } from "./steward-sidecar/helpers.js";
 function getBunRuntime() {
     return globalThis.Bun ?? null;
 }
@@ -190,7 +191,7 @@ export class StewardSidecar {
         if (legacyDataDir !== targetDataDir &&
             fs.existsSync(legacyDataDir) &&
             !targetHasData) {
-            console.log(`[StewardSidecar] Migrating legacy steward data from ${legacyDataDir} to ${targetDataDir}`);
+            logger.info(`[StewardSidecar] Migrating legacy steward data from ${legacyDataDir} to ${targetDataDir}`);
             fs.cpSync(legacyDataDir, targetDataDir, {
                 recursive: true,
                 force: false,
@@ -214,7 +215,7 @@ export class StewardSidecar {
                 return;
             }
             catch {
-                console.warn("[StewardSidecar] Failed to parse credentials, will recreate");
+                logger.warn("[StewardSidecar] Failed to parse credentials, will recreate");
             }
         }
         if (!this.config.masterPassword) {
@@ -229,7 +230,7 @@ export class StewardSidecar {
         const preferredPort = this.config.port;
         const allocatedPort = await allocateFirstFreeLoopbackPort(preferredPort);
         if (allocatedPort !== preferredPort) {
-            console.warn(`[StewardSidecar] Port ${preferredPort} is busy; using ${allocatedPort} instead`);
+            logger.warn(`[StewardSidecar] Port ${preferredPort} is busy; using ${allocatedPort} instead`);
             this.config.port = allocatedPort;
         }
         const env = {
@@ -249,7 +250,7 @@ export class StewardSidecar {
         env.STEWARD_DATA_DIR = path.join(this.config.dataDir, "data");
         env.STEWARD_PGLITE_PATH = env.STEWARD_DATA_DIR;
         env.STEWARD_REDIS_DISABLED = "true";
-        console.log(`[StewardSidecar] Spawning steward on port ${this.config.port}`, { entryPoint, dataDir: this.config.dataDir });
+        logger.info(`[StewardSidecar] Spawning steward on port ${this.config.port} (entryPoint=${entryPoint}, dataDir=${this.config.dataDir})`);
         const bun = getBunRuntime();
         if (bun) {
             const proc = bun.spawn(["bun", "run", entryPoint], {
@@ -264,7 +265,7 @@ export class StewardSidecar {
             pipeOutput(proc.stderr, "stderr", this.config.onLog);
             proc.exited.then((code) => {
                 if (!this.stopping) {
-                    console.warn(`[StewardSidecar] Process exited unexpectedly (code ${code})`);
+                    logger.warn(`[StewardSidecar] Process exited unexpectedly (code ${code})`);
                     void this.handleCrash(code);
                 }
             });
@@ -288,7 +289,7 @@ export class StewardSidecar {
                 child.stdout.on("data", (chunk) => {
                     const line = chunk.toString().trimEnd();
                     if (line) {
-                        console.log(`[Steward] ${line}`);
+                        logger.info(`[Steward] ${line}`);
                         this.config.onLog?.(line, "stdout");
                     }
                 });
@@ -297,14 +298,14 @@ export class StewardSidecar {
                 child.stderr.on("data", (chunk) => {
                     const line = chunk.toString().trimEnd();
                     if (line) {
-                        console.error(`[Steward:err] ${line}`);
+                        logger.warn(`[Steward:err] ${line}`);
                         this.config.onLog?.(line, "stderr");
                     }
                 });
             }
             exitPromise.then((code) => {
                 if (!this.stopping) {
-                    console.warn(`[StewardSidecar] Process exited unexpectedly (code ${code})`);
+                    logger.warn(`[StewardSidecar] Process exited unexpectedly (code ${code})`);
                     void this.handleCrash(code);
                 }
             });
@@ -323,7 +324,7 @@ export class StewardSidecar {
             return;
         }
         const backoff = Math.min(INITIAL_BACKOFF_MS * 2 ** (this.status.restartCount - 1), MAX_BACKOFF_MS);
-        console.log(`[StewardSidecar] Restarting in ${backoff}ms (attempt ${this.status.restartCount}/${this.config.maxRestarts})`);
+        logger.info(`[StewardSidecar] Restarting in ${backoff}ms (attempt ${this.status.restartCount}/${this.config.maxRestarts})`);
         this.updateStatus({ state: "restarting", pid: null });
         this.restartTimer = setTimeout(async () => {
             if (this.stopping)
@@ -362,7 +363,7 @@ export class StewardSidecar {
  * Create a StewardSidecar with standard defaults.
  *
  * Uses environment variables for overrides:
- *   - STEWARD_DATA_DIR: data directory (default: ~/.eliza/steward/)
+ *   - STEWARD_DATA_DIR: data directory (default: ~/.local/state/eliza/steward/)
  *   - STEWARD_PORT: API port (default: 3200)
  *   - STEWARD_MASTER_PASSWORD: vault encryption password
  *   - STEWARD_ENTRY_POINT: path to steward API entry
@@ -370,10 +371,17 @@ export class StewardSidecar {
  */
 export function createDesktopStewardSidecar(overrides) {
     const home = process.env.HOME || process.env.USERPROFILE || "";
+    const namespace = process.env.ELIZA_NAMESPACE?.trim() || "eliza";
+    const xdgStateHome = process.env.XDG_STATE_HOME?.trim();
+    const stateHome = xdgStateHome
+        ? path.isAbsolute(xdgStateHome)
+            ? xdgStateHome
+            : path.join(home, xdgStateHome)
+        : path.join(home, ".local", "state");
     return new StewardSidecar({
         dataDir: process.env.STEWARD_DATA_DIR ||
             overrides?.dataDir ||
-            `${home}/.eliza/steward`,
+            path.join(stateHome, namespace, "steward"),
         port: parseInt(process.env.STEWARD_PORT || "", 10) ||
             overrides?.port ||
             DEFAULT_PORT,

package/services/task-host-capabilities.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Runtime probe for the set of `TaskExecutionProfile` values the current
+ * host can satisfy.
+ *
+ * Consumed by `plugins/plugin-personal-assistant/src/lifeops/scheduled-task/runtime-
+ * wiring.ts` when constructing the `ScheduledTaskRunner`. The runner uses
+ * the result post-fire-claim to substitute incapable profiles to
+ * `notify-only` (a local notification the user taps to resume the work
+ * in foreground).
+ *
+ * Detection rules:
+ *  - `foreground`:    always available (every host can run a task while
+ *                     the app is in front).
+ *  - `notify-only`:   always available (the local-notification channel
+ *                     fires even on suspended Capacitor apps).
+ *  - `bg-light-30s`:  Capacitor host with a registered BackgroundRunner
+ *                     plugin (probe via `globalThis.Capacitor.Plugins.
+ *                     BackgroundRunner`), OR Node desktop.
+ *  - `bg-heavy-fgs`:  Android FGS alive (we read `runtime.getSetting(
+ *                     "ELIZA_HOST_FGS_ACTIVE")` which the Java FGS sets
+ *                     to "1" while running) OR Node desktop. iOS gets it
+ *                     when `BGProcessingTask` identifiers are present
+ *                     (probed via the ElizaTasks plugin handle on the
+ *                     Capacitor global).
+ *
+ * Layering: this module lives in app-core (infrastructure) so the
+ * scheduled-task runner in app-lifeops can call it without inverting the
+ * dependency direction. It probes `globalThis.Capacitor` so the same
+ * code path works in both the iOS-local-agent-kernel (runs in the same
+ * WebView) and on a Node desktop runtime (no Capacitor — falls through
+ * to "all four available").
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+/**
+ * Mirrors `TaskExecutionProfile` from `plugins/plugin-personal-assistant/src/lifeops/
+ * scheduled-task/types.ts`. Re-declared here to avoid an import inversion
+ * (app-core must not depend on app-lifeops). Kept in sync via the test at
+ * `plugins/plugin-personal-assistant/src/lifeops/scheduled-task/runner.test.ts` which
+ * imports both and asserts structural compatibility.
+ */
+export type TaskExecutionProfileForHost = "foreground" | "bg-light-30s" | "bg-heavy-fgs" | "notify-only";
+/**
+ * Resolves the host's currently-available execution profiles. Pure
+ * function of `globalThis.Capacitor` + `runtime.getSetting`; safe to call
+ * on every fire.
+ */
+export declare function getHostExecutionCapabilities(runtime: IAgentRuntime): ReadonlySet<TaskExecutionProfileForHost>;
+/**
+ * Snapshot helper for diagnostics — returns the same data as
+ * `getHostExecutionCapabilities` but as a structured object that's
+ * easier to serialize into `/api/health` extensions.
+ */
+export declare function describeHostExecutionCapabilities(runtime: IAgentRuntime): {
+    profiles: TaskExecutionProfileForHost[];
+    isCapacitor: boolean;
+    hasBackgroundRunner: boolean;
+    hasElizaTasksPlugin: boolean;
+    fgsActive: boolean;
+};
+//# sourceMappingURL=task-host-capabilities.d.ts.map

package/services/task-host-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-host-capabilities.d.ts","sourceRoot":"","sources":["../../../../../src/services/task-host-capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,MAAM,2BAA2B,GACnC,YAAY,GACZ,cAAc,GACd,cAAc,GACd,aAAa,CAAC;AAYlB;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,aAAa,GACrB,WAAW,CAAC,2BAA2B,CAAC,CA4D1C;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,aAAa,GAAG;IACzE,QAAQ,EAAE,2BAA2B,EAAE,CAAC;IACxC,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;CACpB,CAiCA"}

package/services/task-host-capabilities.js

@@ -0,0 +1,122 @@
+/**
+ * Runtime probe for the set of `TaskExecutionProfile` values the current
+ * host can satisfy.
+ *
+ * Consumed by `plugins/plugin-personal-assistant/src/lifeops/scheduled-task/runtime-
+ * wiring.ts` when constructing the `ScheduledTaskRunner`. The runner uses
+ * the result post-fire-claim to substitute incapable profiles to
+ * `notify-only` (a local notification the user taps to resume the work
+ * in foreground).
+ *
+ * Detection rules:
+ *  - `foreground`:    always available (every host can run a task while
+ *                     the app is in front).
+ *  - `notify-only`:   always available (the local-notification channel
+ *                     fires even on suspended Capacitor apps).
+ *  - `bg-light-30s`:  Capacitor host with a registered BackgroundRunner
+ *                     plugin (probe via `globalThis.Capacitor.Plugins.
+ *                     BackgroundRunner`), OR Node desktop.
+ *  - `bg-heavy-fgs`:  Android FGS alive (we read `runtime.getSetting(
+ *                     "ELIZA_HOST_FGS_ACTIVE")` which the Java FGS sets
+ *                     to "1" while running) OR Node desktop. iOS gets it
+ *                     when `BGProcessingTask` identifiers are present
+ *                     (probed via the ElizaTasks plugin handle on the
+ *                     Capacitor global).
+ *
+ * Layering: this module lives in app-core (infrastructure) so the
+ * scheduled-task runner in app-lifeops can call it without inverting the
+ * dependency direction. It probes `globalThis.Capacitor` so the same
+ * code path works in both the iOS-local-agent-kernel (runs in the same
+ * WebView) and on a Node desktop runtime (no Capacitor — falls through
+ * to "all four available").
+ */
+/**
+ * Resolves the host's currently-available execution profiles. Pure
+ * function of `globalThis.Capacitor` + `runtime.getSetting`; safe to call
+ * on every fire.
+ */
+export function getHostExecutionCapabilities(runtime) {
+    const profiles = new Set();
+    // Foreground + notify-only are always available.
+    profiles.add("foreground");
+    profiles.add("notify-only");
+    const capacitor = Reflect.get(globalThis, "Capacitor");
+    const isCapacitor = typeof capacitor === "object" &&
+        capacitor !== null &&
+        typeof capacitor.isNativePlatform === "function" &&
+        capacitor.isNativePlatform?.() === true;
+    if (!isCapacitor) {
+        // Node desktop or pure browser. Desktop hosts every profile; pure
+        // browser cannot keep a process alive but is rare in production. We
+        // err toward "capable" because the Node path is the dominant one;
+        // the browser-only case is covered by the engine's own activation
+        // gate (`assertHostSupports` refuses `requiresLongRunning` on pure
+        // browsers).
+        profiles.add("bg-light-30s");
+        profiles.add("bg-heavy-fgs");
+        return profiles;
+    }
+    const plugins = capacitor.Plugins;
+    const hasBackgroundRunner = plugins != null &&
+        typeof plugins === "object" &&
+        plugins.BackgroundRunner != null &&
+        typeof plugins.BackgroundRunner === "object";
+    if (hasBackgroundRunner) {
+        profiles.add("bg-light-30s");
+    }
+    // iOS: ElizaTasksPlugin registers `ai.eliza.tasks.processing`
+    // (BGProcessingTask). Its presence means we can ask for a long
+    // background window on charger+idle.
+    const hasElizaTasks = plugins != null &&
+        typeof plugins === "object" &&
+        plugins.ElizaTasks != null &&
+        typeof plugins.ElizaTasks === "object";
+    // Android: ElizaAgentService sets ELIZA_HOST_FGS_ACTIVE to "1" while
+    // the foreground service is running. The runtime exposes this via
+    // `getSetting` (read-through to env / settings store).
+    let fgsActive = false;
+    const getSetting = runtime
+        .getSetting;
+    if (typeof getSetting === "function") {
+        const raw = getSetting.call(runtime, "ELIZA_HOST_FGS_ACTIVE");
+        fgsActive = raw === "1" || raw === true;
+    }
+    if (hasElizaTasks || fgsActive) {
+        profiles.add("bg-heavy-fgs");
+    }
+    return profiles;
+}
+/**
+ * Snapshot helper for diagnostics — returns the same data as
+ * `getHostExecutionCapabilities` but as a structured object that's
+ * easier to serialize into `/api/health` extensions.
+ */
+export function describeHostExecutionCapabilities(runtime) {
+    const profiles = Array.from(getHostExecutionCapabilities(runtime));
+    const capacitor = Reflect.get(globalThis, "Capacitor");
+    const isCapacitor = typeof capacitor === "object" &&
+        capacitor !== null &&
+        typeof capacitor.isNativePlatform === "function" &&
+        capacitor.isNativePlatform?.() === true;
+    const plugins = isCapacitor && capacitor != null
+        ? capacitor.Plugins
+        : undefined;
+    const hasBackgroundRunner = plugins != null &&
+        typeof plugins === "object" &&
+        plugins.BackgroundRunner != null;
+    const hasElizaTasksPlugin = plugins != null &&
+        typeof plugins === "object" &&
+        plugins.ElizaTasks != null;
+    const getSetting = runtime
+        .getSetting;
+    const raw = typeof getSetting === "function"
+        ? getSetting.call(runtime, "ELIZA_HOST_FGS_ACTIVE")
+        : undefined;
+    return {
+        profiles,
+        isCapacitor,
+        hasBackgroundRunner: Boolean(hasBackgroundRunner),
+        hasElizaTasksPlugin: Boolean(hasElizaTasksPlugin),
+        fgsActive: raw === "1" || raw === true,
+    };
+}

package/services/tool-call-cache/index.d.ts

@@ -8,6 +8,6 @@
  * services path so external callers can locate it without reaching into
  * the agent package layout.
  */
-export { buildCacheKey, CACHEABLE_TOOL_REGISTRY, canonicalizeJson, defaultPrivacyRedactor, isCacheable, resolveToolDescriptor, ToolCallCache, } from "../../../../agent/src/runtime/tool-call-cache/index.ts";
-export type { CacheableToolDescriptor, PrivacyRedactor, ToolArgs, ToolCacheEntry, ToolCallCacheOptions, ToolOutput, } from "../../../../agent/src/runtime/tool-call-cache/index.ts";
+export type { CacheableToolDescriptor, PrivacyRedactor, ToolArgs, ToolCacheEntry, ToolCallCacheOptions, ToolOutput, } from "@elizaos/agent/runtime/tool-call-cache/index";
+export { buildCacheKey, CACHEABLE_TOOL_REGISTRY, canonicalizeJson, defaultPrivacyRedactor, isCacheable, resolveToolDescriptor, ToolCallCache, } from "@elizaos/agent/runtime/tool-call-cache/index";
 //# sourceMappingURL=index.d.ts.map

package/services/tool-call-cache/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/services/tool-call-cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,qBAAqB,EACrB,aAAa,GACd,MAAM,wDAAwD,CAAC;AAChE,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,QAAQ,EACR,cAAc,EACd,oBAAoB,EACpB,UAAU,GACX,MAAM,wDAAwD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/services/tool-call-cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,QAAQ,EACR,cAAc,EACd,oBAAoB,EACpB,UAAU,GACX,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,qBAAqB,EACrB,aAAa,GACd,MAAM,8CAA8C,CAAC"}

package/services/tool-call-cache/index.js

@@ -8,4 +8,4 @@
  * services path so external callers can locate it without reaching into
  * the agent package layout.
  */
-export { buildCacheKey, CACHEABLE_TOOL_REGISTRY, canonicalizeJson, defaultPrivacyRedactor, isCacheable, resolveToolDescriptor, ToolCallCache, } from "../../../../agent/src/runtime/tool-call-cache/index.js";
+export { buildCacheKey, CACHEABLE_TOOL_REGISTRY, canonicalizeJson, defaultPrivacyRedactor, isCacheable, resolveToolDescriptor, ToolCallCache, } from "@elizaos/agent/runtime/tool-call-cache/index";

package/services/trigger-event-bridge.js

@@ -170,7 +170,7 @@ export function startTriggerEventBridge(runtime, options = {}) {
                 const last = lastDispatchMs.get(triggerId);
                 const current = now();
                 if (last !== undefined && current - last < minIntervalMs) {
-                    runtime.logger.debug?.({
+                    runtime.logger.debug({
                         src: "trigger-event-bridge",
                         triggerId,
                         eventKind: eventType,

package/services/tunnel-to-mobile/index.d.ts

@@ -0,0 +1,2 @@
+export { TunnelToMobileClient, type TunnelToMobileOptions, type TunnelToMobileState, type WebSocketLike, } from "./tunnel-to-mobile-client";
+//# sourceMappingURL=index.d.ts.map

package/services/tunnel-to-mobile/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/services/tunnel-to-mobile/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,2BAA2B,CAAC"}

package/services/tunnel-to-mobile/index.js

@@ -0,0 +1 @@
+export { TunnelToMobileClient, } from "./tunnel-to-mobile-client.js";

package/services/tunnel-to-mobile/tunnel-to-mobile-client.d.ts

@@ -0,0 +1,105 @@
+/**
+ * TunnelToMobileClient — Mac-side dialer for an agent hosted on a phone.
+ *
+ * Inverse of the existing phone→Mac device-bridge. The phone in
+ * `tunnel-to-mobile` mode holds an outbound connection to a relay
+ * (Eliza Cloud managed gateway relay by default — see
+ * `eliza/plugins/plugin-elizacloud/src/services/cloud-managed-gateway-relay.ts`).
+ * This client dials the same relay from the user's Mac and lets the
+ * existing `DeviceBridge` machinery treat the phone-hosted agent as if
+ * it were any other device on the LAN.
+ *
+ * Responsibilities:
+ *   - Opens a WebSocket to the relay with the configured pairing
+ *     credentials.
+ *   - Forwards frames into a caller-provided handler (typically the
+ *     same `DeviceBridge.handleConnection` path that an inbound device
+ *     would hit) so the Mac-side agent runtime treats the bridged
+ *     phone as a registered device.
+ *   - Reports state transitions for the UI.
+ */
+export type TunnelToMobileState = "idle" | "connecting" | "connected" | "reconnecting" | "disconnected" | "error";
+export interface TunnelToMobileOptions {
+    /**
+     * Relay URL the Mac dials. Must point at the same relay endpoint the
+     * phone is registered against — i.e. the cloud-managed gateway relay
+     * for cloud-paired flows, or a Headscale/ngrok URL in the
+     * out-of-cloud paths described in the design doc.
+     */
+    relayUrl: string;
+    /**
+     * The phone's stable device ID. The Mac uses this to address the
+     * phone session inside the relay.
+     */
+    remoteDeviceId: string;
+    /**
+     * Pre-shared pairing token. Must match the token the phone sent in
+     * its `register` frame, or the cloud user-token if the relay is
+     * cloud-auth-backed.
+     */
+    pairingToken?: string;
+    /**
+     * Frame handler. Each JSON frame the relay delivers from the phone
+     * is parsed and passed here; the caller is expected to forward it
+     * into the local `DeviceBridge`'s registered-device codepath so the
+     * agent runtime can treat the bridged phone identically to a
+     * LAN-connected device.
+     */
+    onFrame(frame: unknown): void;
+    /**
+     * State change callback. Drives the UI status.
+     */
+    onStateChange?(state: TunnelToMobileState, detail?: string): void;
+    /**
+     * Optional pluggable WebSocket constructor for testing or for
+     * runtimes that do not expose a global `WebSocket`.
+     */
+    webSocketCtor?: WebSocketLike;
+}
+/**
+ * Minimal structural type for the WebSocket constructor. Lets us inject
+ * a `ws.WebSocket` (Node) or the browser `WebSocket` interchangeably.
+ */
+export interface WebSocketInstanceLike {
+    readyState: number;
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    addEventListener(type: "open", listener: () => void): void;
+    addEventListener(type: "close", listener: (event: {
+        code?: number;
+        reason?: string;
+    }) => void): void;
+    addEventListener(type: "error", listener: (event: unknown) => void): void;
+    addEventListener(type: "message", listener: (event: {
+        data: string | ArrayBuffer | Buffer;
+    }) => void): void;
+}
+export type WebSocketLike = new (url: string, protocols?: string | string[]) => WebSocketInstanceLike;
+/**
+ * Mac-side client. Construct with `TunnelToMobileClient.start(...)` to
+ * get a started instance, or `new TunnelToMobileClient(...)` if you want
+ * to manage the lifecycle yourself.
+ */
+export declare class TunnelToMobileClient {
+    private socket;
+    private state;
+    private readonly options;
+    private readonly ctor;
+    private stopped;
+    private reconnectTimer;
+    private backoffMs;
+    constructor(options: TunnelToMobileOptions);
+    static start(options: TunnelToMobileOptions): TunnelToMobileClient;
+    getState(): TunnelToMobileState;
+    connect(): void;
+    stop(): void;
+    /**
+     * Send a frame back through the tunnel to the phone. Wrapped in a
+     * helper so the caller doesn't reach into the WebSocket directly.
+     */
+    sendFrame(frame: unknown): boolean;
+    private sendRegistration;
+    private scheduleReconnect;
+    private transition;
+}
+//# sourceMappingURL=tunnel-to-mobile-client.d.ts.map

package/services/tunnel-to-mobile/tunnel-to-mobile-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel-to-mobile-client.d.ts","sourceRoot":"","sources":["../../../../../../src/services/tunnel-to-mobile/tunnel-to-mobile-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,YAAY,GACZ,WAAW,GACX,cAAc,GACd,cAAc,GACd,OAAO,CAAC;AAEZ,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B;;OAEG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClE;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC3D,gBAAgB,CACd,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAC5D,IAAI,CAAC;IACR,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1E,gBAAgB,CACd,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAA;KAAE,KAAK,IAAI,GACjE,IAAI,CAAC;CACT;AAED,MAAM,MAAM,aAAa,GAAG,KAC1B,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAC1B,qBAAqB,CAAC;AAE3B;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,SAAS,CAAO;gBAEZ,OAAO,EAAE,qBAAqB;IAW1C,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB;IAMlE,QAAQ,IAAI,mBAAmB;IAI/B,OAAO,IAAI,IAAI;IAmFf,IAAI,IAAI,IAAI;IAiBZ;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAWlC,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,UAAU;CAUnB"}