@elizaos/plugin-steward-app 2.0.3-beta.5 → 2.0.3-beta.7

package/dist/services/steward-evm-bridge.js

@@ -0,0 +1,78 @@
+import { setStewardEvmBridgeActive } from "@elizaos/agent";
+import {
+  initStewardEvmAccount,
+  isStewardCloudProvisioned,
+  isStewardSigningReady
+} from "./steward-evm-account.js";
+const STEWARD_BOOTSTRAP_PRIVATE_KEY_SENTINEL = "0x0000000000000000000000000000000000000000000000000000000000000001";
+let _stewardAccount = null;
+let _initialized = false;
+async function stewardEvmPreBoot(runtime) {
+  if (!isStewardSigningReady()) {
+    return;
+  }
+  console.log(
+    isStewardCloudProvisioned() ? "[StewardEvmBridge] Cloud-provisioned Steward detected" : "[StewardEvmBridge] Self-hosted Steward detected"
+  );
+  try {
+    _stewardAccount = await initStewardEvmAccount();
+    if (_stewardAccount) {
+      const existing = runtime.getSetting("EVM_PRIVATE_KEY");
+      if (!existing) {
+        runtime.setSetting(
+          "EVM_PRIVATE_KEY",
+          STEWARD_BOOTSTRAP_PRIVATE_KEY_SENTINEL
+        );
+        console.log("[StewardEvmBridge] Set reserved EVM_PRIVATE_KEY sentinel");
+      }
+      const addr = _stewardAccount.address;
+      if (addr && addr !== "0x0000000000000000000000000000000000000000") {
+        process.env.ELIZA_MANAGED_EVM_ADDRESS = addr;
+        console.log(`[StewardEvmBridge] Set ELIZA_MANAGED_EVM_ADDRESS=${addr}`);
+      }
+      _initialized = true;
+      setStewardEvmBridgeActive(true);
+    }
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(`[StewardEvmBridge] Pre-boot failed: ${msg}`);
+    console.warn("[StewardEvmBridge] Plugin-evm will use default key behavior");
+  }
+}
+async function stewardEvmPostBoot(runtime) {
+  if (!_initialized || !_stewardAccount) {
+    return;
+  }
+  try {
+    const evmService = runtime.getService("evm");
+    if (!evmService?.walletProvider) {
+      console.warn(
+        "[StewardEvmBridge] EVMService not found or no walletProvider \u2014 cannot inject Steward account"
+      );
+      return;
+    }
+    const wp = evmService.walletProvider;
+    const oldAddress = evmService.walletProvider.getAddress?.();
+    wp._account = _stewardAccount;
+    const newAddress = evmService.walletProvider.getAddress?.();
+    console.log(
+      `[StewardEvmBridge] \u2713 Replaced EVM account: ${oldAddress} \u2192 ${newAddress} (Steward-backed)`
+    );
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(`[StewardEvmBridge] Post-boot failed: ${msg}`);
+  }
+}
+function getStewardEvmAccount() {
+  return _stewardAccount;
+}
+function isStewardEvmBridgeActive() {
+  return _initialized && _stewardAccount !== null;
+}
+export {
+  getStewardEvmAccount,
+  isStewardEvmBridgeActive,
+  stewardEvmPostBoot,
+  stewardEvmPreBoot
+};
+//# sourceMappingURL=steward-evm-bridge.js.map

package/dist/services/steward-evm-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/services/steward-evm-bridge.ts"],"sourcesContent":["/**\n * Steward EVM Bridge — intercepts plugin-wallet EVM initialization in cloud-provisioned\n * containers to route signing through Steward API instead of local private keys.\n *\n * Strategy:\n *   1. Before the runtime starts plugins, check if we're in cloud-provisioned mode\n *   2. If so, create a Steward viem Account\n *   3. Inject a reserved EVM_PRIVATE_KEY setting so initWalletProvider doesn't\n *      generate a random key, then immediately replace the account on the\n *      WalletProvider after EVMService starts\n *\n * This module exports a boot hook that should be called early in the runtime\n * initialization, before plugins are loaded.\n */\n\nimport { setStewardEvmBridgeActive } from \"@elizaos/agent\";\nimport type { IAgentRuntime } from \"@elizaos/core\";\nimport {\n  initStewardEvmAccount,\n  isStewardCloudProvisioned,\n  isStewardSigningReady,\n} from \"./steward-evm-account.js\";\n\n// Reserved private-key-shaped seed that satisfies plugin-wallet validation but is\n// replaced by the Steward account before signing. Its derived address must never\n// be funded; it exists only to prevent auto-generation/persistence of a random key.\nconst STEWARD_BOOTSTRAP_PRIVATE_KEY_SENTINEL =\n  \"0x0000000000000000000000000000000000000000000000000000000000000001\";\n\n/** Stash the account globally so we can retrieve it in the post-start hook. */\nlet _stewardAccount: Awaited<ReturnType<typeof initStewardEvmAccount>> = null;\nlet _initialized = false;\n\n/**\n * Pre-boot hook: call before plugins are loaded.\n * Sets a reserved EVM_PRIVATE_KEY if in Steward mode so that initWalletProvider\n * does not auto-generate and persist a random key.\n */\nexport async function stewardEvmPreBoot(runtime: IAgentRuntime): Promise<void> {\n  if (!isStewardSigningReady()) {\n    return;\n  }\n\n  console.log(\n    isStewardCloudProvisioned()\n      ? \"[StewardEvmBridge] Cloud-provisioned Steward detected\"\n      : \"[StewardEvmBridge] Self-hosted Steward detected\",\n  );\n\n  try {\n    _stewardAccount = await initStewardEvmAccount();\n    if (_stewardAccount) {\n      // Set the reserved seed so initWalletProvider doesn't generate a random\n      // key and doesn't try to persist it to the database.\n      const existing = runtime.getSetting(\"EVM_PRIVATE_KEY\");\n      if (!existing) {\n        runtime.setSetting(\n          \"EVM_PRIVATE_KEY\",\n          STEWARD_BOOTSTRAP_PRIVATE_KEY_SENTINEL,\n        );\n        console.log(\"[StewardEvmBridge] Set reserved EVM_PRIVATE_KEY sentinel\");\n      }\n      // Expose the steward-managed address so getWalletAddresses() and\n      // resolveWalletCapabilityStatus() can discover it synchronously,\n      // even before initStewardWalletCache() runs.\n      const addr = _stewardAccount.address;\n      if (addr && addr !== \"0x0000000000000000000000000000000000000000\") {\n        process.env.ELIZA_MANAGED_EVM_ADDRESS = addr;\n        console.log(`[StewardEvmBridge] Set ELIZA_MANAGED_EVM_ADDRESS=${addr}`);\n      }\n      _initialized = true;\n      setStewardEvmBridgeActive(true);\n    }\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    console.error(`[StewardEvmBridge] Pre-boot failed: ${msg}`);\n    console.warn(\"[StewardEvmBridge] Plugin-evm will use default key behavior\");\n  }\n}\n\n/**\n * Post-boot hook: call after plugins have started.\n * Replaces the WalletProvider's account on the EVMService with the Steward account.\n */\nexport async function stewardEvmPostBoot(\n  runtime: IAgentRuntime,\n): Promise<void> {\n  if (!_initialized || !_stewardAccount) {\n    return;\n  }\n\n  try {\n    const evmService = runtime.getService(\"evm\") as {\n      walletProvider?: {\n        _account?: unknown;\n        getAddress?: () => string;\n      };\n    } | null;\n\n    if (!evmService?.walletProvider) {\n      console.warn(\n        \"[StewardEvmBridge] EVMService not found or no walletProvider — cannot inject Steward account\",\n      );\n      return;\n    }\n\n    // Replace the account on the WalletProvider instance.\n    // WalletProvider stores the account as `this._account` (see initializeAccount).\n    // TypeScript doesn't expose it, but it's a simple property assignment.\n    const wp = evmService.walletProvider as Record<string, unknown>;\n    const oldAddress = (\n      evmService.walletProvider as { getAddress?: () => string }\n    ).getAddress?.();\n    wp._account = _stewardAccount;\n\n    const newAddress = (\n      evmService.walletProvider as { getAddress?: () => string }\n    ).getAddress?.();\n    console.log(\n      `[StewardEvmBridge] ✓ Replaced EVM account: ${oldAddress} → ${newAddress} (Steward-backed)`,\n    );\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    console.error(`[StewardEvmBridge] Post-boot failed: ${msg}`);\n  }\n}\n\n/**\n * Get the Steward account if initialized (for use by other services).\n */\nexport function getStewardEvmAccount(): Awaited<\n  ReturnType<typeof initStewardEvmAccount>\n> {\n  return _stewardAccount;\n}\n\n/**\n * Check if Steward EVM bridge is active.\n */\nexport function isStewardEvmBridgeActive(): boolean {\n  return _initialized && _stewardAccount !== null;\n}\n"],"mappings":"AAeA,SAAS,iCAAiC;AAE1C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAKP,MAAM,yCACJ;AAGF,IAAI,kBAAqE;AACzE,IAAI,eAAe;AAOnB,eAAsB,kBAAkB,SAAuC;AAC7E,MAAI,CAAC,sBAAsB,GAAG;AAC5B;AAAA,EACF;AAEA,UAAQ;AAAA,IACN,0BAA0B,IACtB,0DACA;AAAA,EACN;AAEA,MAAI;AACF,sBAAkB,MAAM,sBAAsB;AAC9C,QAAI,iBAAiB;AAGnB,YAAM,WAAW,QAAQ,WAAW,iBAAiB;AACrD,UAAI,CAAC,UAAU;AACb,gBAAQ;AAAA,UACN;AAAA,UACA;AAAA,QACF;AACA,gBAAQ,IAAI,0DAA0D;AAAA,MACxE;AAIA,YAAM,OAAO,gBAAgB;AAC7B,UAAI,QAAQ,SAAS,8CAA8C;AACjE,gBAAQ,IAAI,4BAA4B;AACxC,gBAAQ,IAAI,oDAAoD,IAAI,EAAE;AAAA,MACxE;AACA,qBAAe;AACf,gCAA0B,IAAI;AAAA,IAChC;AAAA,EACF,SAAS,KAAK;AACZ,UAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,YAAQ,MAAM,uCAAuC,GAAG,EAAE;AAC1D,YAAQ,KAAK,6DAA6D;AAAA,EAC5E;AACF;AAMA,eAAsB,mBACpB,SACe;AACf,MAAI,CAAC,gBAAgB,CAAC,iBAAiB;AACrC;AAAA,EACF;AAEA,MAAI;AACF,UAAM,aAAa,QAAQ,WAAW,KAAK;AAO3C,QAAI,CAAC,YAAY,gBAAgB;AAC/B,cAAQ;AAAA,QACN;AAAA,MACF;AACA;AAAA,IACF;AAKA,UAAM,KAAK,WAAW;AACtB,UAAM,aACJ,WAAW,eACX,aAAa;AACf,OAAG,WAAW;AAEd,UAAM,aACJ,WAAW,eACX,aAAa;AACf,YAAQ;AAAA,MACN,mDAA8C,UAAU,WAAM,UAAU;AAAA,IAC1E;AAAA,EACF,SAAS,KAAK;AACZ,UAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,YAAQ,MAAM,wCAAwC,GAAG,EAAE;AAAA,EAC7D;AACF;AAKO,SAAS,uBAEd;AACA,SAAO;AACT;AAKO,SAAS,2BAAoC;AAClD,SAAO,gBAAgB,oBAAoB;AAC7C;","names":[]}

package/dist/services/steward-sidecar/health-check.d.ts

@@ -0,0 +1,2 @@
+export * from "@elizaos/app-core";
+//# sourceMappingURL=health-check.d.ts.map

package/dist/services/steward-sidecar/health-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.d.ts","sourceRoot":"","sources":["../../../src/services/steward-sidecar/health-check.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/services/steward-sidecar/health-check.js

@@ -0,0 +1,2 @@
+export * from "@elizaos/app-core";
+//# sourceMappingURL=health-check.js.map

package/dist/services/steward-sidecar/health-check.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/steward-sidecar/health-check.ts"],"sourcesContent":["export * from \"@elizaos/app-core\";\n"],"mappings":"AAAA,cAAc;","names":[]}

package/dist/services/steward-sidecar/helpers.d.ts

@@ -0,0 +1,2 @@
+export * from "@elizaos/app-core";
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/services/steward-sidecar/helpers.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/services/steward-sidecar/helpers.js

@@ -0,0 +1,2 @@
+export * from "@elizaos/app-core";
+//# sourceMappingURL=helpers.js.map

package/dist/services/steward-sidecar/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/steward-sidecar/helpers.ts"],"sourcesContent":["export * from \"@elizaos/app-core\";\n"],"mappings":"AAAA,cAAc;","names":[]}

package/dist/services/steward-sidecar/process-management.d.ts

@@ -0,0 +1,2 @@
+export * from "@elizaos/app-core";
+//# sourceMappingURL=process-management.d.ts.map

package/dist/services/steward-sidecar/process-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-management.d.ts","sourceRoot":"","sources":["../../../src/services/steward-sidecar/process-management.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/services/steward-sidecar/process-management.js

@@ -0,0 +1,2 @@
+export * from "@elizaos/app-core";
+//# sourceMappingURL=process-management.js.map

package/dist/services/steward-sidecar/process-management.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/steward-sidecar/process-management.ts"],"sourcesContent":["export * from \"@elizaos/app-core\";\n"],"mappings":"AAAA,cAAc;","names":[]}

package/dist/services/steward-sidecar/types.d.ts

@@ -0,0 +1,2 @@
+export * from "@elizaos/app-core";
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/steward-sidecar/types.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/services/steward-sidecar/types.js

@@ -0,0 +1,2 @@
+export * from "@elizaos/app-core";
+//# sourceMappingURL=types.js.map

package/dist/services/steward-sidecar/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/steward-sidecar/types.ts"],"sourcesContent":["export * from \"@elizaos/app-core\";\n"],"mappings":"AAAA,cAAc;","names":[]}

package/dist/services/steward-sidecar/wallet-setup.d.ts

@@ -0,0 +1,2 @@
+export * from "@elizaos/app-core";
+//# sourceMappingURL=wallet-setup.d.ts.map

package/dist/services/steward-sidecar/wallet-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-setup.d.ts","sourceRoot":"","sources":["../../../src/services/steward-sidecar/wallet-setup.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,2 @@
+export * from "@elizaos/app-core";
+//# sourceMappingURL=wallet-setup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/steward-sidecar/wallet-setup.ts"],"sourcesContent":["export * from \"@elizaos/app-core\";\n"],"mappings":"AAAA,cAAc;","names":[]}

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

@@ -0,0 +1,2 @@
+export * from "@elizaos/app-core";
+//# sourceMappingURL=steward-sidecar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"steward-sidecar.d.ts","sourceRoot":"","sources":["../../src/services/steward-sidecar.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/services/steward-sidecar.js

@@ -0,0 +1,2 @@
+export * from "@elizaos/app-core";
+//# sourceMappingURL=steward-sidecar.js.map

package/dist/services/steward-sidecar.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/services/steward-sidecar.ts"],"sourcesContent":["export * from \"@elizaos/app-core\";\n"],"mappings":"AAAA,cAAc;","names":[]}

package/dist/services/steward-wallet.d.ts

@@ -0,0 +1,25 @@
+import type { StewardApprovalActionResponse, StewardPendingApproval, StewardSignRequest, StewardSignResponse, StewardStatusResponse } from "../types/steward.js";
+interface PersistedStewardCredentials {
+    apiUrl: string;
+    tenantId: string;
+    agentId: string;
+    apiKey: string;
+    agentToken: string;
+    walletAddresses?: {
+        evm?: string;
+        solana?: string;
+    };
+    agentName?: string;
+}
+interface EffectiveStewardConfig extends PersistedStewardCredentials {
+}
+export declare function resolveEffectiveStewardConfig(env?: NodeJS.ProcessEnv): EffectiveStewardConfig | null;
+export declare function isStewardWalletConfigured(env?: NodeJS.ProcessEnv): boolean;
+export declare function getStewardWalletUnavailableMessage(): string;
+export declare function getStewardWalletStatus(env?: NodeJS.ProcessEnv): Promise<StewardStatusResponse>;
+export declare function getStewardPendingApprovals(env?: NodeJS.ProcessEnv): Promise<StewardPendingApproval[]>;
+export declare function approveStewardWalletRequest(txId: string, env?: NodeJS.ProcessEnv): Promise<StewardApprovalActionResponse>;
+export declare function rejectStewardWalletRequest(txId: string, reason?: string, env?: NodeJS.ProcessEnv): Promise<StewardApprovalActionResponse>;
+export declare function signWithStewardWallet(request: StewardSignRequest, env?: NodeJS.ProcessEnv): Promise<StewardSignResponse>;
+export {};
+//# sourceMappingURL=steward-wallet.d.ts.map

package/dist/services/steward-wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steward-wallet.d.ts","sourceRoot":"","sources":["../../src/services/steward-wallet.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,6BAA6B,EAC7B,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,kBAAkB,CAAC;AAQ1B,UAAU,2BAA2B;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,sBAAuB,SAAQ,2BAA2B;CAAG;AA2CvE,wBAAgB,6BAA6B,CAC3C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,sBAAsB,GAAG,IAAI,CAsB/B;AAqBD,wBAAgB,yBAAyB,CACvC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAIT;AAED,wBAAgB,kCAAkC,IAAI,MAAM,CAE3D;AAgGD,wBAAsB,sBAAsB,CAC1C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAwFhC;AAED,wBAAsB,0BAA0B,CAC9C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,sBAAsB,EAAE,CAAC,CA+BnC;AAED,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,6BAA6B,CAAC,CA+BxC;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,6BAA6B,CAAC,CAsBxC;AAuBD,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,EAC3B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,mBAAmB,CAAC,CA4D9B"}

package/dist/services/steward-wallet.js

@@ -0,0 +1,333 @@
+import fs from "node:fs";
+import path from "node:path";
+import { resolveStateDir } from "@elizaos/core";
+import { getWalletAddresses } from "../api/wallet.js";
+const DEFAULT_TIMEOUT_MS = 12e3;
+function resolveStewardCredentialsPath() {
+  return path.join(resolveStateDir(), "steward-credentials.json");
+}
+function normalizeEnvValue(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function resolvePersistedStewardCredentials() {
+  const credentialsPath = resolveStewardCredentialsPath();
+  try {
+    if (!fs.existsSync(credentialsPath)) {
+      return null;
+    }
+    const parsed = JSON.parse(
+      fs.readFileSync(credentialsPath, "utf8")
+    );
+    if (!normalizeEnvValue(parsed.apiUrl)) {
+      return null;
+    }
+    return {
+      apiUrl: normalizeEnvValue(parsed.apiUrl) ?? "",
+      tenantId: normalizeEnvValue(parsed.tenantId) ?? "",
+      agentId: normalizeEnvValue(parsed.agentId) ?? "",
+      apiKey: normalizeEnvValue(parsed.apiKey) ?? "",
+      agentToken: normalizeEnvValue(parsed.agentToken) ?? "",
+      walletAddresses: parsed.walletAddresses && typeof parsed.walletAddresses === "object" && !Array.isArray(parsed.walletAddresses) ? parsed.walletAddresses : void 0,
+      agentName: normalizeEnvValue(parsed.agentName ?? void 0) ?? void 0
+    };
+  } catch {
+    return null;
+  }
+}
+function resolveEffectiveStewardConfig(env = process.env) {
+  const persisted = resolvePersistedStewardCredentials();
+  const apiUrl = normalizeEnvValue(env.STEWARD_API_URL) ?? persisted?.apiUrl;
+  if (!apiUrl) {
+    return null;
+  }
+  return {
+    apiUrl,
+    tenantId: normalizeEnvValue(env.STEWARD_TENANT_ID) ?? persisted?.tenantId ?? "",
+    agentId: normalizeEnvValue(env.STEWARD_AGENT_ID) ?? normalizeEnvValue(env.ELIZA_STEWARD_AGENT_ID) ?? persisted?.agentId ?? "",
+    apiKey: normalizeEnvValue(env.STEWARD_API_KEY) ?? persisted?.apiKey ?? "",
+    agentToken: normalizeEnvValue(env.STEWARD_AGENT_TOKEN) ?? persisted?.agentToken ?? "",
+    walletAddresses: persisted?.walletAddresses,
+    agentName: persisted?.agentName
+  };
+}
+function resolveStewardWalletAgentId(env = process.env) {
+  const config = resolveEffectiveStewardConfig(env);
+  const addresses = getWalletAddresses();
+  return normalizeEnvValue(env.STEWARD_AGENT_ID) ?? normalizeEnvValue(env.ELIZA_STEWARD_AGENT_ID) ?? normalizeEnvValue(config?.agentId) ?? normalizeEnvValue(addresses.evmAddress ?? void 0);
+}
+function resolveStewardWalletBaseUrl(env = process.env) {
+  return resolveEffectiveStewardConfig(env)?.apiUrl ?? null;
+}
+function isStewardWalletConfigured(env = process.env) {
+  return Boolean(
+    resolveStewardWalletBaseUrl(env) && resolveStewardWalletAgentId(env)
+  );
+}
+function getStewardWalletUnavailableMessage() {
+  return "Eliza agent wallet is unavailable. Configure Steward in Eliza wallet settings or set STEWARD_API_URL and Steward credentials.";
+}
+function buildStewardWalletHeaders(env = process.env) {
+  const config = resolveEffectiveStewardConfig(env);
+  const headers = new Headers();
+  headers.set("Accept", "application/json");
+  headers.set("Content-Type", "application/json");
+  const bearerToken = normalizeEnvValue(env.STEWARD_AGENT_TOKEN) ?? config?.agentToken ?? null;
+  const apiKey = normalizeEnvValue(env.STEWARD_API_KEY) ?? config?.apiKey ?? null;
+  const tenantId = normalizeEnvValue(env.STEWARD_TENANT_ID) ?? config?.tenantId ?? null;
+  if (bearerToken) {
+    headers.set("Authorization", `Bearer ${bearerToken}`);
+  } else if (apiKey) {
+    headers.set("X-Steward-Key", apiKey);
+  }
+  if (tenantId) {
+    headers.set("X-Steward-Tenant", tenantId);
+  }
+  return headers;
+}
+async function readErrorBody(response) {
+  try {
+    return (await response.text()).trim().slice(0, 240);
+  } catch {
+    return "";
+  }
+}
+async function requestStewardWallet(pathname, init, env = process.env) {
+  const baseUrl = resolveStewardWalletBaseUrl(env);
+  if (!baseUrl) {
+    throw new Error(getStewardWalletUnavailableMessage());
+  }
+  return fetch(`${baseUrl.replace(/\/{1,1024}$/, "")}${pathname}`, {
+    ...init,
+    headers: init?.headers ?? buildStewardWalletHeaders(env),
+    signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS)
+  });
+}
+function resolveWalletAddresses(_env, config, agentRecord) {
+  const localAddresses = getWalletAddresses();
+  const remoteWalletAddresses = agentRecord?.walletAddresses && typeof agentRecord.walletAddresses === "object" && !Array.isArray(agentRecord.walletAddresses) ? agentRecord.walletAddresses : null;
+  const remoteEvm = normalizeEnvValue(
+    typeof remoteWalletAddresses?.evm === "string" ? remoteWalletAddresses.evm : void 0
+  ) ?? normalizeEnvValue(
+    typeof agentRecord?.walletAddress === "string" ? agentRecord.walletAddress : void 0
+  );
+  const remoteSolana = normalizeEnvValue(
+    typeof remoteWalletAddresses?.solana === "string" ? remoteWalletAddresses.solana : void 0
+  );
+  return {
+    evm: localAddresses.evmAddress ?? remoteEvm ?? config?.walletAddresses?.evm?.trim() ?? null,
+    solana: localAddresses.solanaAddress ?? remoteSolana ?? config?.walletAddresses?.solana?.trim() ?? null
+  };
+}
+async function getStewardWalletStatus(env = process.env) {
+  const config = resolveEffectiveStewardConfig(env);
+  const agentId = resolveStewardWalletAgentId(env);
+  const localAddresses = getWalletAddresses();
+  const fallbackWalletAddresses = {
+    evm: localAddresses.evmAddress ?? config?.walletAddresses?.evm?.trim() ?? null,
+    solana: localAddresses.solanaAddress ?? config?.walletAddresses?.solana?.trim() ?? null
+  };
+  if (!config?.apiUrl || !agentId) {
+    return {
+      configured: false,
+      available: false,
+      connected: false,
+      baseUrl: config?.apiUrl ?? void 0,
+      agentId: agentId ?? void 0,
+      agentName: config?.agentName,
+      evmAddress: fallbackWalletAddresses.evm ?? void 0,
+      walletAddresses: fallbackWalletAddresses,
+      error: null
+    };
+  }
+  try {
+    const response = await requestStewardWallet(
+      `/agents/${encodeURIComponent(agentId)}`,
+      void 0,
+      env
+    );
+    if (!response.ok) {
+      const details = await readErrorBody(response);
+      return {
+        configured: true,
+        available: true,
+        connected: false,
+        baseUrl: config.apiUrl,
+        agentId,
+        agentName: config.agentName,
+        evmAddress: fallbackWalletAddresses.evm ?? void 0,
+        walletAddresses: fallbackWalletAddresses,
+        error: `Steward agent lookup failed (${response.status})${details ? `: ${details}` : ""}`
+      };
+    }
+    const body = await response.json().catch(() => ({}));
+    const agentRecord = body.data && typeof body.data === "object" && !Array.isArray(body.data) ? body.data : body;
+    const walletAddresses = resolveWalletAddresses(env, config, agentRecord);
+    return {
+      configured: true,
+      available: true,
+      connected: true,
+      baseUrl: config.apiUrl,
+      agentId,
+      agentName: normalizeEnvValue(
+        typeof agentRecord.name === "string" ? agentRecord.name : void 0
+      ) ?? config.agentName,
+      evmAddress: walletAddresses.evm ?? void 0,
+      walletAddresses,
+      error: null,
+      vaultHealth: "ok"
+    };
+  } catch (error) {
+    return {
+      configured: true,
+      available: true,
+      connected: false,
+      baseUrl: config.apiUrl,
+      agentId,
+      agentName: config.agentName,
+      evmAddress: fallbackWalletAddresses.evm ?? void 0,
+      walletAddresses: fallbackWalletAddresses,
+      error: error instanceof Error ? error.message : String(error),
+      vaultHealth: "error"
+    };
+  }
+}
+async function getStewardPendingApprovals(env = process.env) {
+  const agentId = resolveStewardWalletAgentId(env);
+  if (!agentId) {
+    throw new Error(getStewardWalletUnavailableMessage());
+  }
+  const response = await requestStewardWallet(
+    `/vault/${encodeURIComponent(agentId)}/pending`,
+    void 0,
+    env
+  );
+  if (response.status === 404) {
+    return [];
+  }
+  if (!response.ok) {
+    const details = await readErrorBody(response);
+    throw new Error(
+      `Steward pending approvals failed (${response.status})${details ? `: ${details}` : ""}`
+    );
+  }
+  const body = await response.json().catch(() => ({}));
+  const data = Array.isArray(body.data) ? body.data : Array.isArray(body) ? body : [];
+  return data;
+}
+async function approveStewardWalletRequest(txId, env = process.env) {
+  const agentId = resolveStewardWalletAgentId(env);
+  if (!agentId) {
+    throw new Error(getStewardWalletUnavailableMessage());
+  }
+  const response = await requestStewardWallet(
+    `/vault/${encodeURIComponent(agentId)}/approve/${encodeURIComponent(txId)}`,
+    { method: "POST" },
+    env
+  );
+  if (!response.ok) {
+    const details = await readErrorBody(response);
+    throw new Error(
+      `Steward approve failed (${response.status})${details ? `: ${details}` : ""}`
+    );
+  }
+  const body = await response.json().catch(() => ({}));
+  const payload = body.data && typeof body.data === "object" && !Array.isArray(body.data) ? body.data : body;
+  return {
+    ok: true,
+    txHash: typeof payload.txHash === "string" ? payload.txHash : void 0
+  };
+}
+async function rejectStewardWalletRequest(txId, reason, env = process.env) {
+  const agentId = resolveStewardWalletAgentId(env);
+  if (!agentId) {
+    throw new Error(getStewardWalletUnavailableMessage());
+  }
+  const response = await requestStewardWallet(
+    `/vault/${encodeURIComponent(agentId)}/reject/${encodeURIComponent(txId)}`,
+    {
+      method: "POST",
+      body: JSON.stringify(reason?.trim() ? { reason } : {})
+    },
+    env
+  );
+  if (!response.ok) {
+    const details = await readErrorBody(response);
+    throw new Error(
+      `Steward reject failed (${response.status})${details ? `: ${details}` : ""}`
+    );
+  }
+  return { ok: true };
+}
+function normalizeViolations(raw) {
+  if (!Array.isArray(raw)) {
+    return void 0;
+  }
+  return raw.filter(
+    (entry) => Boolean(entry) && typeof entry === "object" && typeof entry.policy === "string" && typeof entry.reason === "string"
+  ).map((entry) => ({
+    policy: entry.policy,
+    reason: entry.reason
+  }));
+}
+async function signWithStewardWallet(request, env = process.env) {
+  const agentId = resolveStewardWalletAgentId(env);
+  if (!agentId) {
+    throw new Error(getStewardWalletUnavailableMessage());
+  }
+  const response = await requestStewardWallet(
+    `/vault/${encodeURIComponent(agentId)}/sign`,
+    {
+      method: "POST",
+      body: JSON.stringify({
+        to: request.to,
+        value: request.value,
+        chainId: request.chainId,
+        data: request.data,
+        broadcast: request.broadcast ?? true,
+        description: request.description
+      })
+    },
+    env
+  );
+  const body = await response.json().catch(() => ({}));
+  const payload = body.data && typeof body.data === "object" && !Array.isArray(body.data) ? body.data : body;
+  if (response.ok && body.ok === true) {
+    return {
+      approved: true,
+      txHash: typeof payload.txHash === "string" ? payload.txHash : void 0
+    };
+  }
+  if (response.status === 202) {
+    return {
+      approved: false,
+      pending: true,
+      txId: typeof payload.txId === "string" ? payload.txId : void 0,
+      violations: normalizeViolations(payload.violations)
+    };
+  }
+  if (response.status === 403) {
+    return {
+      approved: false,
+      denied: true,
+      violations: normalizeViolations(payload.violations)
+    };
+  }
+  throw new Error(
+    typeof body.error === "string" ? body.error : `Steward sign failed (${response.status})`
+  );
+}
+export {
+  approveStewardWalletRequest,
+  getStewardPendingApprovals,
+  getStewardWalletStatus,
+  getStewardWalletUnavailableMessage,
+  isStewardWalletConfigured,
+  rejectStewardWalletRequest,
+  resolveEffectiveStewardConfig,
+  signWithStewardWallet
+};
+//# sourceMappingURL=steward-wallet.js.map

package/dist/services/steward-wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/services/steward-wallet.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { resolveStateDir } from \"@elizaos/core\";\nimport { getWalletAddresses } from \"../api/wallet.js\";\nimport type {\n  StewardApprovalActionResponse,\n  StewardPendingApproval,\n  StewardSignRequest,\n  StewardSignResponse,\n  StewardStatusResponse,\n} from \"../types/steward.js\";\n\nconst DEFAULT_TIMEOUT_MS = 12_000;\n\nfunction resolveStewardCredentialsPath(): string {\n  return path.join(resolveStateDir(), \"steward-credentials.json\");\n}\n\ninterface PersistedStewardCredentials {\n  apiUrl: string;\n  tenantId: string;\n  agentId: string;\n  apiKey: string;\n  agentToken: string;\n  walletAddresses?: {\n    evm?: string;\n    solana?: string;\n  };\n  agentName?: string;\n}\n\ninterface EffectiveStewardConfig extends PersistedStewardCredentials {}\n\nfunction normalizeEnvValue(value: string | undefined): string | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction resolvePersistedStewardCredentials(): PersistedStewardCredentials | null {\n  const credentialsPath = resolveStewardCredentialsPath();\n  try {\n    if (!fs.existsSync(credentialsPath)) {\n      return null;\n    }\n\n    const parsed = JSON.parse(\n      fs.readFileSync(credentialsPath, \"utf8\"),\n    ) as Partial<PersistedStewardCredentials>;\n    if (!normalizeEnvValue(parsed.apiUrl)) {\n      return null;\n    }\n\n    return {\n      apiUrl: normalizeEnvValue(parsed.apiUrl) ?? \"\",\n      tenantId: normalizeEnvValue(parsed.tenantId) ?? \"\",\n      agentId: normalizeEnvValue(parsed.agentId) ?? \"\",\n      apiKey: normalizeEnvValue(parsed.apiKey) ?? \"\",\n      agentToken: normalizeEnvValue(parsed.agentToken) ?? \"\",\n      walletAddresses:\n        parsed.walletAddresses &&\n        typeof parsed.walletAddresses === \"object\" &&\n        !Array.isArray(parsed.walletAddresses)\n          ? parsed.walletAddresses\n          : undefined,\n      agentName: normalizeEnvValue(parsed.agentName ?? undefined) ?? undefined,\n    };\n  } catch {\n    return null;\n  }\n}\n\nexport function resolveEffectiveStewardConfig(\n  env: NodeJS.ProcessEnv = process.env,\n): EffectiveStewardConfig | null {\n  const persisted = resolvePersistedStewardCredentials();\n  const apiUrl = normalizeEnvValue(env.STEWARD_API_URL) ?? persisted?.apiUrl;\n  if (!apiUrl) {\n    return null;\n  }\n\n  return {\n    apiUrl,\n    tenantId:\n      normalizeEnvValue(env.STEWARD_TENANT_ID) ?? persisted?.tenantId ?? \"\",\n    agentId:\n      normalizeEnvValue(env.STEWARD_AGENT_ID) ??\n      normalizeEnvValue(env.ELIZA_STEWARD_AGENT_ID) ??\n      persisted?.agentId ??\n      \"\",\n    apiKey: normalizeEnvValue(env.STEWARD_API_KEY) ?? persisted?.apiKey ?? \"\",\n    agentToken:\n      normalizeEnvValue(env.STEWARD_AGENT_TOKEN) ?? persisted?.agentToken ?? \"\",\n    walletAddresses: persisted?.walletAddresses,\n    agentName: persisted?.agentName,\n  };\n}\n\nfunction resolveStewardWalletAgentId(\n  env: NodeJS.ProcessEnv = process.env,\n): string | null {\n  const config = resolveEffectiveStewardConfig(env);\n  const addresses = getWalletAddresses();\n  return (\n    normalizeEnvValue(env.STEWARD_AGENT_ID) ??\n    normalizeEnvValue(env.ELIZA_STEWARD_AGENT_ID) ??\n    normalizeEnvValue(config?.agentId) ??\n    normalizeEnvValue(addresses.evmAddress ?? undefined)\n  );\n}\n\nfunction resolveStewardWalletBaseUrl(\n  env: NodeJS.ProcessEnv = process.env,\n): string | null {\n  return resolveEffectiveStewardConfig(env)?.apiUrl ?? null;\n}\n\nexport function isStewardWalletConfigured(\n  env: NodeJS.ProcessEnv = process.env,\n): boolean {\n  return Boolean(\n    resolveStewardWalletBaseUrl(env) && resolveStewardWalletAgentId(env),\n  );\n}\n\nexport function getStewardWalletUnavailableMessage(): string {\n  return \"Eliza agent wallet is unavailable. Configure Steward in Eliza wallet settings or set STEWARD_API_URL and Steward credentials.\";\n}\n\nfunction buildStewardWalletHeaders(\n  env: NodeJS.ProcessEnv = process.env,\n): Headers {\n  const config = resolveEffectiveStewardConfig(env);\n  const headers = new Headers();\n  headers.set(\"Accept\", \"application/json\");\n  headers.set(\"Content-Type\", \"application/json\");\n\n  const bearerToken =\n    normalizeEnvValue(env.STEWARD_AGENT_TOKEN) ?? config?.agentToken ?? null;\n  const apiKey =\n    normalizeEnvValue(env.STEWARD_API_KEY) ?? config?.apiKey ?? null;\n  const tenantId =\n    normalizeEnvValue(env.STEWARD_TENANT_ID) ?? config?.tenantId ?? null;\n\n  if (bearerToken) {\n    headers.set(\"Authorization\", `Bearer ${bearerToken}`);\n  } else if (apiKey) {\n    headers.set(\"X-Steward-Key\", apiKey);\n  }\n  if (tenantId) {\n    headers.set(\"X-Steward-Tenant\", tenantId);\n  }\n  return headers;\n}\n\nasync function readErrorBody(response: Response): Promise<string> {\n  try {\n    return (await response.text()).trim().slice(0, 240);\n  } catch {\n    return \"\";\n  }\n}\n\nasync function requestStewardWallet(\n  pathname: string,\n  init?: RequestInit,\n  env: NodeJS.ProcessEnv = process.env,\n): Promise<Response> {\n  const baseUrl = resolveStewardWalletBaseUrl(env);\n  if (!baseUrl) {\n    throw new Error(getStewardWalletUnavailableMessage());\n  }\n\n  return fetch(`${baseUrl.replace(/\\/{1,1024}$/, \"\")}${pathname}`, {\n    ...init,\n    headers: init?.headers ?? buildStewardWalletHeaders(env),\n    signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),\n  });\n}\n\nfunction resolveWalletAddresses(\n  _env: NodeJS.ProcessEnv,\n  config: EffectiveStewardConfig | null,\n  agentRecord?: Record<string, unknown> | null,\n): { evm: string | null; solana: string | null } {\n  const localAddresses = getWalletAddresses();\n  const remoteWalletAddresses =\n    agentRecord?.walletAddresses &&\n    typeof agentRecord.walletAddresses === \"object\" &&\n    !Array.isArray(agentRecord.walletAddresses)\n      ? (agentRecord.walletAddresses as Record<string, unknown>)\n      : null;\n  const remoteEvm =\n    normalizeEnvValue(\n      typeof remoteWalletAddresses?.evm === \"string\"\n        ? remoteWalletAddresses.evm\n        : undefined,\n    ) ??\n    normalizeEnvValue(\n      typeof agentRecord?.walletAddress === \"string\"\n        ? agentRecord.walletAddress\n        : undefined,\n    );\n  const remoteSolana = normalizeEnvValue(\n    typeof remoteWalletAddresses?.solana === \"string\"\n      ? remoteWalletAddresses.solana\n      : undefined,\n  );\n\n  return {\n    evm:\n      localAddresses.evmAddress ??\n      remoteEvm ??\n      config?.walletAddresses?.evm?.trim() ??\n      null,\n    solana:\n      localAddresses.solanaAddress ??\n      remoteSolana ??\n      config?.walletAddresses?.solana?.trim() ??\n      null,\n  };\n}\n\nexport async function getStewardWalletStatus(\n  env: NodeJS.ProcessEnv = process.env,\n): Promise<StewardStatusResponse> {\n  const config = resolveEffectiveStewardConfig(env);\n  const agentId = resolveStewardWalletAgentId(env);\n  const localAddresses = getWalletAddresses();\n  const fallbackWalletAddresses = {\n    evm:\n      localAddresses.evmAddress ?? config?.walletAddresses?.evm?.trim() ?? null,\n    solana:\n      localAddresses.solanaAddress ??\n      config?.walletAddresses?.solana?.trim() ??\n      null,\n  };\n\n  if (!config?.apiUrl || !agentId) {\n    return {\n      configured: false,\n      available: false,\n      connected: false,\n      baseUrl: config?.apiUrl ?? undefined,\n      agentId: agentId ?? undefined,\n      agentName: config?.agentName,\n      evmAddress: fallbackWalletAddresses.evm ?? undefined,\n      walletAddresses: fallbackWalletAddresses,\n      error: null,\n    };\n  }\n\n  try {\n    const response = await requestStewardWallet(\n      `/agents/${encodeURIComponent(agentId)}`,\n      undefined,\n      env,\n    );\n\n    if (!response.ok) {\n      const details = await readErrorBody(response);\n      return {\n        configured: true,\n        available: true,\n        connected: false,\n        baseUrl: config.apiUrl,\n        agentId,\n        agentName: config.agentName,\n        evmAddress: fallbackWalletAddresses.evm ?? undefined,\n        walletAddresses: fallbackWalletAddresses,\n        error: `Steward agent lookup failed (${response.status})${details ? `: ${details}` : \"\"}`,\n      };\n    }\n\n    const body = (await response.json().catch(() => ({}))) as Record<\n      string,\n      unknown\n    >;\n    const agentRecord =\n      body.data && typeof body.data === \"object\" && !Array.isArray(body.data)\n        ? (body.data as Record<string, unknown>)\n        : body;\n    const walletAddresses = resolveWalletAddresses(env, config, agentRecord);\n\n    return {\n      configured: true,\n      available: true,\n      connected: true,\n      baseUrl: config.apiUrl,\n      agentId,\n      agentName:\n        normalizeEnvValue(\n          typeof agentRecord.name === \"string\" ? agentRecord.name : undefined,\n        ) ?? config.agentName,\n      evmAddress: walletAddresses.evm ?? undefined,\n      walletAddresses,\n      error: null,\n      vaultHealth: \"ok\",\n    };\n  } catch (error) {\n    return {\n      configured: true,\n      available: true,\n      connected: false,\n      baseUrl: config.apiUrl,\n      agentId,\n      agentName: config.agentName,\n      evmAddress: fallbackWalletAddresses.evm ?? undefined,\n      walletAddresses: fallbackWalletAddresses,\n      error: error instanceof Error ? error.message : String(error),\n      vaultHealth: \"error\",\n    };\n  }\n}\n\nexport async function getStewardPendingApprovals(\n  env: NodeJS.ProcessEnv = process.env,\n): Promise<StewardPendingApproval[]> {\n  const agentId = resolveStewardWalletAgentId(env);\n  if (!agentId) {\n    throw new Error(getStewardWalletUnavailableMessage());\n  }\n\n  const response = await requestStewardWallet(\n    `/vault/${encodeURIComponent(agentId)}/pending`,\n    undefined,\n    env,\n  );\n  if (response.status === 404) {\n    return [];\n  }\n  if (!response.ok) {\n    const details = await readErrorBody(response);\n    throw new Error(\n      `Steward pending approvals failed (${response.status})${details ? `: ${details}` : \"\"}`,\n    );\n  }\n\n  const body = (await response.json().catch(() => ({}))) as Record<\n    string,\n    unknown\n  >;\n  const data = Array.isArray(body.data)\n    ? body.data\n    : Array.isArray(body)\n      ? body\n      : [];\n  return data as StewardPendingApproval[];\n}\n\nexport async function approveStewardWalletRequest(\n  txId: string,\n  env: NodeJS.ProcessEnv = process.env,\n): Promise<StewardApprovalActionResponse> {\n  const agentId = resolveStewardWalletAgentId(env);\n  if (!agentId) {\n    throw new Error(getStewardWalletUnavailableMessage());\n  }\n\n  const response = await requestStewardWallet(\n    `/vault/${encodeURIComponent(agentId)}/approve/${encodeURIComponent(txId)}`,\n    { method: \"POST\" },\n    env,\n  );\n  if (!response.ok) {\n    const details = await readErrorBody(response);\n    throw new Error(\n      `Steward approve failed (${response.status})${details ? `: ${details}` : \"\"}`,\n    );\n  }\n\n  const body = (await response.json().catch(() => ({}))) as Record<\n    string,\n    unknown\n  >;\n  const payload =\n    body.data && typeof body.data === \"object\" && !Array.isArray(body.data)\n      ? (body.data as Record<string, unknown>)\n      : body;\n\n  return {\n    ok: true,\n    txHash: typeof payload.txHash === \"string\" ? payload.txHash : undefined,\n  };\n}\n\nexport async function rejectStewardWalletRequest(\n  txId: string,\n  reason?: string,\n  env: NodeJS.ProcessEnv = process.env,\n): Promise<StewardApprovalActionResponse> {\n  const agentId = resolveStewardWalletAgentId(env);\n  if (!agentId) {\n    throw new Error(getStewardWalletUnavailableMessage());\n  }\n\n  const response = await requestStewardWallet(\n    `/vault/${encodeURIComponent(agentId)}/reject/${encodeURIComponent(txId)}`,\n    {\n      method: \"POST\",\n      body: JSON.stringify(reason?.trim() ? { reason } : {}),\n    },\n    env,\n  );\n  if (!response.ok) {\n    const details = await readErrorBody(response);\n    throw new Error(\n      `Steward reject failed (${response.status})${details ? `: ${details}` : \"\"}`,\n    );\n  }\n\n  return { ok: true };\n}\n\nfunction normalizeViolations(\n  raw: unknown,\n): Array<{ policy: string; reason: string }> | undefined {\n  if (!Array.isArray(raw)) {\n    return undefined;\n  }\n\n  return raw\n    .filter(\n      (entry): entry is { policy: string; reason: string } =>\n        Boolean(entry) &&\n        typeof entry === \"object\" &&\n        typeof (entry as Record<string, unknown>).policy === \"string\" &&\n        typeof (entry as Record<string, unknown>).reason === \"string\",\n    )\n    .map((entry) => ({\n      policy: entry.policy,\n      reason: entry.reason,\n    }));\n}\n\nexport async function signWithStewardWallet(\n  request: StewardSignRequest,\n  env: NodeJS.ProcessEnv = process.env,\n): Promise<StewardSignResponse> {\n  const agentId = resolveStewardWalletAgentId(env);\n  if (!agentId) {\n    throw new Error(getStewardWalletUnavailableMessage());\n  }\n\n  const response = await requestStewardWallet(\n    `/vault/${encodeURIComponent(agentId)}/sign`,\n    {\n      method: \"POST\",\n      body: JSON.stringify({\n        to: request.to,\n        value: request.value,\n        chainId: request.chainId,\n        data: request.data,\n        broadcast: request.broadcast ?? true,\n        description: request.description,\n      }),\n    },\n    env,\n  );\n\n  const body = (await response.json().catch(() => ({}))) as Record<\n    string,\n    unknown\n  >;\n  const payload =\n    body.data && typeof body.data === \"object\" && !Array.isArray(body.data)\n      ? (body.data as Record<string, unknown>)\n      : body;\n\n  if (response.ok && body.ok === true) {\n    return {\n      approved: true,\n      txHash: typeof payload.txHash === \"string\" ? payload.txHash : undefined,\n    };\n  }\n\n  if (response.status === 202) {\n    return {\n      approved: false,\n      pending: true,\n      txId: typeof payload.txId === \"string\" ? payload.txId : undefined,\n      violations: normalizeViolations(payload.violations),\n    };\n  }\n\n  if (response.status === 403) {\n    return {\n      approved: false,\n      denied: true,\n      violations: normalizeViolations(payload.violations),\n    };\n  }\n\n  throw new Error(\n    typeof body.error === \"string\"\n      ? body.error\n      : `Steward sign failed (${response.status})`,\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/steward-ui-state.d.ts

@@ -0,0 +1,14 @@
+import type { WalletConfigStatus, WalletEntry } from "@elizaos/core";
+import type { StewardStatusResponse } from "./types/steward.js";
+export interface StewardUiState {
+    connected: boolean;
+    showFeatures: boolean;
+    title: string;
+    description: string;
+}
+export declare function resolveStewardUiState(args: {
+    stewardStatus?: StewardStatusResponse | null;
+    walletConfig?: WalletConfigStatus | null;
+    wallets?: WalletEntry[] | null;
+}): StewardUiState;
+//# sourceMappingURL=steward-ui-state.d.ts.map

package/dist/steward-ui-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steward-ui-state.d.ts","sourceRoot":"","sources":["../src/steward-ui-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAUD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,aAAa,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC7C,YAAY,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACzC,OAAO,CAAC,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;CAChC,GAAG,cAAc,CA4CjB"}