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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export * from "./ApprovalQueue.js";
+export * from "./api/tx-service.js";
+export * from "./api/wallet-dex-prices.js";
+export * from "./chain-utils.js";
+export { stewardPlugin } from "./plugin.js";
+export { __resetStewardAgentEnsured, approveStewardTransaction, buildStewardHeaders, createStewardClient, denyStewardTransaction, type EnsureStewardAgentResult, ensureStewardAgent, formatStewardError, getRecentWebhookEvents, getStewardBalance, getStewardBridgeStatus, getStewardHistory, getStewardPendingApprovals as getStewardBridgePendingApprovals, getStewardTokenBalances, getStewardWalletAddresses, isStewardConfigured, provisionStewardWallet, pushWebhookEvent, registerStewardWebhook, resolveStewardAgentId, type StewardBalanceResult, type StewardBridgeOptions, type StewardBridgeStatus, type StewardExecutionResult, type StewardPendingApprovalResult, type StewardPendingEntry, type StewardSignedTransactionResult, type StewardTokenBalancesResult, type StewardWalletAddresses, type StewardWebhookEvent, type StewardWebhookEventType, signTransactionWithOptionalSteward, signViaSteward, tryRegisterStewardWebhook, } from "./routes/steward-bridge.js";
+export * from "./routes/wallet-core-routes.js";
+export * from "./StewardLogo.js";
+export * from "./StewardView.js";
+export * from "./StewardView.helpers.js";
+export * from "./security/hydrate-wallet-keys-from-platform-store.js";
+export * from "./security/wallet-os-store-actions.js";
+export { loadStewardCredentials, type PersistedStewardCredentials, saveStewardCredentials, } from "./services/steward-credentials.js";
+export * from "./services/steward-evm-account.js";
+export * from "./services/steward-evm-bridge.js";
+export * from "./services/steward-wallet.js";
+export * from "./TransactionHistory.js";
+export * from "./types/index.js";
+export * from "./ui.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,0BAA0B,IAAI,gCAAgC,EAC9D,uBAAuB,EACvB,yBAAyB,EACzB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,kCAAkC,EAClC,cAAc,EACd,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oDAAoD,CAAC;AACnE,cAAc,oCAAoC,CAAC;AACnD,OAAO,EACL,sBAAsB,EACtB,KAAK,2BAA2B,EAChC,sBAAsB,GACvB,MAAM,gCAAgC,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,77 @@
+if (typeof window === "undefined") {
+  void import("./register-terminal-view.js").then((m) => m.registerStewardTerminalView()).catch(() => {
+  });
+}
+export * from "./ApprovalQueue.js";
+export * from "./api/tx-service.js";
+export * from "./api/wallet-dex-prices.js";
+export * from "./chain-utils.js";
+import { stewardPlugin } from "./plugin.js";
+import {
+  __resetStewardAgentEnsured,
+  approveStewardTransaction,
+  buildStewardHeaders,
+  createStewardClient,
+  denyStewardTransaction,
+  ensureStewardAgent,
+  formatStewardError,
+  getRecentWebhookEvents,
+  getStewardBalance,
+  getStewardBridgeStatus,
+  getStewardHistory,
+  getStewardPendingApprovals,
+  getStewardTokenBalances,
+  getStewardWalletAddresses,
+  isStewardConfigured,
+  provisionStewardWallet,
+  pushWebhookEvent,
+  registerStewardWebhook,
+  resolveStewardAgentId,
+  signTransactionWithOptionalSteward,
+  signViaSteward,
+  tryRegisterStewardWebhook
+} from "./routes/steward-bridge.js";
+export * from "./routes/wallet-core-routes.js";
+export * from "./StewardLogo.js";
+export * from "./StewardView.js";
+export * from "./StewardView.helpers.js";
+export * from "./security/hydrate-wallet-keys-from-platform-store.js";
+export * from "./security/wallet-os-store-actions.js";
+import {
+  loadStewardCredentials,
+  saveStewardCredentials
+} from "./services/steward-credentials.js";
+export * from "./services/steward-evm-account.js";
+export * from "./services/steward-evm-bridge.js";
+export * from "./services/steward-wallet.js";
+export * from "./TransactionHistory.js";
+export * from "./types/index.js";
+export * from "./ui.js";
+export {
+  __resetStewardAgentEnsured,
+  approveStewardTransaction,
+  buildStewardHeaders,
+  createStewardClient,
+  denyStewardTransaction,
+  ensureStewardAgent,
+  formatStewardError,
+  getRecentWebhookEvents,
+  getStewardBalance,
+  getStewardPendingApprovals as getStewardBridgePendingApprovals,
+  getStewardBridgeStatus,
+  getStewardHistory,
+  getStewardTokenBalances,
+  getStewardWalletAddresses,
+  isStewardConfigured,
+  loadStewardCredentials,
+  provisionStewardWallet,
+  pushWebhookEvent,
+  registerStewardWebhook,
+  resolveStewardAgentId,
+  saveStewardCredentials,
+  signTransactionWithOptionalSteward,
+  signViaSteward,
+  stewardPlugin,
+  tryRegisterStewardWebhook
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// In a terminal host (the Node agent, no DOM), register the Steward view so it\n// renders inline in the terminal. Lazy + DOM-guarded so the terminal engine\n// stays out of browser/mobile bundles.\nif (typeof window === \"undefined\") {\n  void import(\"./register-terminal-view.js\")\n    .then((m) => m.registerStewardTerminalView())\n    .catch(() => {\n      // Terminal rendering is best-effort; never block plugin load.\n    });\n}\n\nexport * from \"./ApprovalQueue.js\";\nexport * from \"./api/tx-service.js\";\nexport * from \"./api/wallet-dex-prices.js\";\nexport * from \"./chain-utils.js\";\nexport { stewardPlugin } from \"./plugin.js\";\nexport {\n  __resetStewardAgentEnsured,\n  approveStewardTransaction,\n  buildStewardHeaders,\n  createStewardClient,\n  denyStewardTransaction,\n  type EnsureStewardAgentResult,\n  ensureStewardAgent,\n  formatStewardError,\n  getRecentWebhookEvents,\n  getStewardBalance,\n  getStewardBridgeStatus,\n  getStewardHistory,\n  getStewardPendingApprovals as getStewardBridgePendingApprovals,\n  getStewardTokenBalances,\n  getStewardWalletAddresses,\n  isStewardConfigured,\n  provisionStewardWallet,\n  pushWebhookEvent,\n  registerStewardWebhook,\n  resolveStewardAgentId,\n  type StewardBalanceResult,\n  type StewardBridgeOptions,\n  type StewardBridgeStatus,\n  type StewardExecutionResult,\n  type StewardPendingApprovalResult,\n  type StewardPendingEntry,\n  type StewardSignedTransactionResult,\n  type StewardTokenBalancesResult,\n  type StewardWalletAddresses,\n  type StewardWebhookEvent,\n  type StewardWebhookEventType,\n  signTransactionWithOptionalSteward,\n  signViaSteward,\n  tryRegisterStewardWebhook,\n} from \"./routes/steward-bridge.js\";\nexport * from \"./routes/wallet-core-routes.js\";\nexport * from \"./StewardLogo.js\";\nexport * from \"./StewardView.js\";\nexport * from \"./StewardView.helpers\";\nexport * from \"./security/hydrate-wallet-keys-from-platform-store.js\";\nexport * from \"./security/wallet-os-store-actions.js\";\nexport {\n  loadStewardCredentials,\n  type PersistedStewardCredentials,\n  saveStewardCredentials,\n} from \"./services/steward-credentials.js\";\nexport * from \"./services/steward-evm-account.js\";\nexport * from \"./services/steward-evm-bridge.js\";\nexport * from \"./services/steward-wallet.js\";\nexport * from \"./TransactionHistory.js\";\nexport * from \"./types/index.js\";\nexport * from \"./ui.js\";\n"],"mappings":"AAGA,IAAI,OAAO,WAAW,aAAa;AACjC,OAAK,OAAO,6BAA6B,EACtC,KAAK,CAAC,MAAM,EAAE,4BAA4B,CAAC,EAC3C,MAAM,MAAM;AAAA,EAEb,CAAC;AACL;AAEA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAC8B;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAYA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd;AAAA,EACE;AAAA,EAEA;AAAA,OACK;AACP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/plugin.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Steward plugin — registers all Steward wallet compat routes with the
+ * elizaOS runtime plugin route system.
+ *
+ * All routes use `rawPath: true` to preserve the legacy `/api/wallet/*`
+ * and `/api/steward/*` paths without a plugin-name prefix.
+ *
+ * Handler modules:
+ *   - wallet-core-routes           (addresses, balances, import, generate, config, export)
+ *   - wallet-bsc-core-routes       (preflight, quote, tx-status, profile, transfer, defaults)
+ *   - wallet-compat-routes         (OS store, keys, NFTs)
+ *   - wallet-browser-compat-routes (browser wallet bridge)
+ *   - steward-compat-routes        (steward wallet management)
+ *   - wallet-trade-compat-routes   (trade / transfer execution with steward signing)
+ *
+ * Each handler operates on raw `http.IncomingMessage` / `http.ServerResponse`,
+ * which the runtime plugin route bridge already passes through.
+ */
+import type { Plugin } from "@elizaos/core";
+export declare const stewardPlugin: Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAS,MAAM,eAAe,CAAC;AAqVnD,eAAO,MAAM,aAAa,EAAE,MAmC3B,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,319 @@
+import { walletRouterAction } from "@elizaos/plugin-wallet";
+import { stewardBalanceProvider } from "./providers/steward-balance.js";
+import { stewardReceiveAddressProvider } from "./providers/steward-receive-address.js";
+import { handleStewardCompatRoutes } from "./routes/steward-compat-routes.js";
+import { handleWalletBrowserCompatRoutes } from "./routes/wallet-browser-compat-routes.js";
+import { handleWalletBscCoreRoutes } from "./routes/wallet-bsc-core-routes.js";
+import { handleWalletCompatRoutes } from "./routes/wallet-compat-routes.js";
+import { handleWalletCoreRoutes } from "./routes/wallet-core-routes.js";
+import { handleWalletTradeCompatRoutes } from "./routes/wallet-trade-compat-routes.js";
+function buildCompatState(runtime) {
+  return { current: runtime };
+}
+function stewardRouteHandler(handler) {
+  return async (req, res, runtime) => {
+    const httpReq = req;
+    const httpRes = res;
+    await handler(httpReq, httpRes, buildCompatState(runtime));
+  };
+}
+function coreRouteHandler(handler) {
+  return async (req, res, runtime) => {
+    const httpReq = req;
+    const httpRes = res;
+    await handler(httpReq, httpRes, runtime);
+  };
+}
+const stewardRoutes = [
+  // ── Core wallet routes (addresses, balances, import, generate, config, export) ──
+  // GET /api/wallet/addresses
+  {
+    type: "GET",
+    path: "/api/wallet/addresses",
+    rawPath: true,
+    handler: coreRouteHandler(handleWalletCoreRoutes)
+  },
+  // GET /api/wallet/balances
+  {
+    type: "GET",
+    path: "/api/wallet/balances",
+    rawPath: true,
+    handler: coreRouteHandler(handleWalletCoreRoutes)
+  },
+  // POST /api/wallet/import
+  {
+    type: "POST",
+    path: "/api/wallet/import",
+    rawPath: true,
+    handler: coreRouteHandler(handleWalletCoreRoutes)
+  },
+  // POST /api/wallet/generate
+  {
+    type: "POST",
+    path: "/api/wallet/generate",
+    rawPath: true,
+    handler: coreRouteHandler(handleWalletCoreRoutes)
+  },
+  // GET /api/wallet/config
+  {
+    type: "GET",
+    path: "/api/wallet/config",
+    rawPath: true,
+    handler: coreRouteHandler(handleWalletCoreRoutes)
+  },
+  // PUT /api/wallet/config
+  {
+    type: "PUT",
+    path: "/api/wallet/config",
+    rawPath: true,
+    handler: coreRouteHandler(handleWalletCoreRoutes)
+  },
+  // POST /api/wallet/export
+  {
+    type: "POST",
+    path: "/api/wallet/export",
+    rawPath: true,
+    handler: coreRouteHandler(handleWalletCoreRoutes)
+  },
+  // ── BSC trade routes (preflight, quote, tx-status, profile, transfer, defaults) ──
+  // POST /api/wallet/trade/preflight
+  {
+    type: "POST",
+    path: "/api/wallet/trade/preflight",
+    rawPath: true,
+    handler: coreRouteHandler(handleWalletBscCoreRoutes)
+  },
+  // POST /api/wallet/trade/quote
+  {
+    type: "POST",
+    path: "/api/wallet/trade/quote",
+    rawPath: true,
+    handler: coreRouteHandler(handleWalletBscCoreRoutes)
+  },
+  // GET /api/wallet/trade/tx-status
+  {
+    type: "GET",
+    path: "/api/wallet/trade/tx-status",
+    rawPath: true,
+    handler: coreRouteHandler(handleWalletBscCoreRoutes)
+  },
+  // GET /api/wallet/trading/profile
+  {
+    type: "GET",
+    path: "/api/wallet/trading/profile",
+    rawPath: true,
+    handler: coreRouteHandler(handleWalletBscCoreRoutes)
+  },
+  // POST /api/wallet/production-defaults
+  {
+    type: "POST",
+    path: "/api/wallet/production-defaults",
+    rawPath: true,
+    handler: coreRouteHandler(handleWalletBscCoreRoutes)
+  },
+  // ── wallet-compat-routes (OS store, keys, NFTs) ────────────────────
+  // GET /api/wallet/os-store
+  {
+    type: "GET",
+    path: "/api/wallet/os-store",
+    rawPath: true,
+    handler: stewardRouteHandler(handleWalletCompatRoutes)
+  },
+  // POST /api/wallet/os-store
+  {
+    type: "POST",
+    path: "/api/wallet/os-store",
+    rawPath: true,
+    handler: stewardRouteHandler(handleWalletCompatRoutes)
+  },
+  // GET /api/wallet/keys
+  {
+    type: "GET",
+    path: "/api/wallet/keys",
+    rawPath: true,
+    handler: stewardRouteHandler(handleWalletCompatRoutes)
+  },
+  // GET /api/wallet/nfts
+  {
+    type: "GET",
+    path: "/api/wallet/nfts",
+    rawPath: true,
+    handler: stewardRouteHandler(handleWalletCompatRoutes)
+  },
+  // ── wallet-browser-compat-routes (browser wallet bridge) ───────────
+  // POST /api/wallet/browser-transaction
+  {
+    type: "POST",
+    path: "/api/wallet/browser-transaction",
+    rawPath: true,
+    handler: stewardRouteHandler(handleWalletBrowserCompatRoutes)
+  },
+  // POST /api/wallet/browser-sign-message
+  {
+    type: "POST",
+    path: "/api/wallet/browser-sign-message",
+    rawPath: true,
+    handler: stewardRouteHandler(handleWalletBrowserCompatRoutes)
+  },
+  // POST /api/wallet/browser-solana-sign-message
+  {
+    type: "POST",
+    path: "/api/wallet/browser-solana-sign-message",
+    rawPath: true,
+    handler: stewardRouteHandler(handleWalletBrowserCompatRoutes)
+  },
+  // POST /api/wallet/browser-solana-transaction
+  {
+    type: "POST",
+    path: "/api/wallet/browser-solana-transaction",
+    rawPath: true,
+    handler: stewardRouteHandler(handleWalletBrowserCompatRoutes)
+  },
+  // ── steward-compat-routes (steward wallet management) ──────────────
+  // GET /api/wallet/steward-status
+  {
+    type: "GET",
+    path: "/api/wallet/steward-status",
+    rawPath: true,
+    handler: stewardRouteHandler(handleStewardCompatRoutes)
+  },
+  // GET /api/wallet/steward-policies
+  {
+    type: "GET",
+    path: "/api/wallet/steward-policies",
+    rawPath: true,
+    handler: stewardRouteHandler(handleStewardCompatRoutes)
+  },
+  // PUT /api/wallet/steward-policies
+  {
+    type: "PUT",
+    path: "/api/wallet/steward-policies",
+    rawPath: true,
+    handler: stewardRouteHandler(handleStewardCompatRoutes)
+  },
+  // GET /api/wallet/steward-tx-records
+  {
+    type: "GET",
+    path: "/api/wallet/steward-tx-records",
+    rawPath: true,
+    handler: stewardRouteHandler(handleStewardCompatRoutes)
+  },
+  // GET /api/wallet/steward-pending-approvals
+  {
+    type: "GET",
+    path: "/api/wallet/steward-pending-approvals",
+    rawPath: true,
+    handler: stewardRouteHandler(handleStewardCompatRoutes)
+  },
+  // POST /api/wallet/steward-approve-tx
+  {
+    type: "POST",
+    path: "/api/wallet/steward-approve-tx",
+    rawPath: true,
+    handler: stewardRouteHandler(handleStewardCompatRoutes)
+  },
+  // POST /api/wallet/steward-deny-tx
+  {
+    type: "POST",
+    path: "/api/wallet/steward-deny-tx",
+    rawPath: true,
+    handler: stewardRouteHandler(handleStewardCompatRoutes)
+  },
+  // POST /api/wallet/steward-webhook (loopback only, no auth)
+  {
+    type: "POST",
+    path: "/api/wallet/steward-webhook",
+    rawPath: true,
+    public: true,
+    name: "steward-webhook",
+    handler: stewardRouteHandler(handleStewardCompatRoutes)
+  },
+  // GET /api/wallet/steward-webhook-events
+  {
+    type: "GET",
+    path: "/api/wallet/steward-webhook-events",
+    rawPath: true,
+    handler: stewardRouteHandler(handleStewardCompatRoutes)
+  },
+  // POST /api/wallet/steward-sign
+  {
+    type: "POST",
+    path: "/api/wallet/steward-sign",
+    rawPath: true,
+    handler: stewardRouteHandler(handleStewardCompatRoutes)
+  },
+  // GET /api/wallet/steward-addresses
+  {
+    type: "GET",
+    path: "/api/wallet/steward-addresses",
+    rawPath: true,
+    handler: stewardRouteHandler(handleStewardCompatRoutes)
+  },
+  // GET /api/wallet/steward-balances
+  {
+    type: "GET",
+    path: "/api/wallet/steward-balances",
+    rawPath: true,
+    handler: stewardRouteHandler(handleStewardCompatRoutes)
+  },
+  // GET /api/wallet/steward-tokens
+  {
+    type: "GET",
+    path: "/api/wallet/steward-tokens",
+    rawPath: true,
+    handler: stewardRouteHandler(handleStewardCompatRoutes)
+  },
+  // ── wallet-trade-compat-routes (trade / transfer execution) ────────
+  // POST /api/wallet/trade/execute
+  {
+    type: "POST",
+    path: "/api/wallet/trade/execute",
+    rawPath: true,
+    handler: stewardRouteHandler(handleWalletTradeCompatRoutes)
+  },
+  // POST /api/wallet/transfer/execute
+  {
+    type: "POST",
+    path: "/api/wallet/transfer/execute",
+    rawPath: true,
+    handler: stewardRouteHandler(handleWalletTradeCompatRoutes)
+  }
+];
+const stewardPlugin = {
+  name: "@elizaos/plugin-steward-app",
+  description: "Steward wallet management, browser wallet bridge, and trade/transfer routes (extracted from agent server.ts)",
+  routes: stewardRoutes,
+  actions: [
+    // Canonical wallet router — handles preview, swap, transfer, and other
+    // wallet subactions across registered chain backends.
+    walletRouterAction
+  ],
+  providers: [
+    // Read-only wallet snapshots surfaced to the planner every turn.
+    stewardBalanceProvider,
+    stewardReceiveAddressProvider
+  ],
+  views: [
+    // ONE declaration → GUI + XR + TUI, all drawn from the single StewardView
+    // spatial source. `modalities` is a plain literal here (plugin.ts is not in
+    // the view bundle), so no brand-new `@elizaos/core` runtime export reaches
+    // the bundle build.
+    {
+      id: "steward",
+      label: "Steward",
+      description: "Transaction history and approval queue for Steward wallet management",
+      icon: "Shield",
+      path: "/steward",
+      modalities: ["gui", "xr", "tui"],
+      bundlePath: "dist/views/bundle.js",
+      componentExport: "StewardView",
+      tags: ["finance", "wallet", "approvals", "transactions"],
+      visibleInManager: true,
+      desktopTabEnabled: true
+    }
+  ]
+};
+export {
+  stewardPlugin
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["/**\n * Steward plugin — registers all Steward wallet compat routes with the\n * elizaOS runtime plugin route system.\n *\n * All routes use `rawPath: true` to preserve the legacy `/api/wallet/*`\n * and `/api/steward/*` paths without a plugin-name prefix.\n *\n * Handler modules:\n *   - wallet-core-routes           (addresses, balances, import, generate, config, export)\n *   - wallet-bsc-core-routes       (preflight, quote, tx-status, profile, transfer, defaults)\n *   - wallet-compat-routes         (OS store, keys, NFTs)\n *   - wallet-browser-compat-routes (browser wallet bridge)\n *   - steward-compat-routes        (steward wallet management)\n *   - wallet-trade-compat-routes   (trade / transfer execution with steward signing)\n *\n * Each handler operates on raw `http.IncomingMessage` / `http.ServerResponse`,\n * which the runtime plugin route bridge already passes through.\n */\n\nimport type http from \"node:http\";\nimport type { CompatRuntimeState } from \"@elizaos/app-core/api/compat-route-shared\";\nimport type { Plugin, Route } from \"@elizaos/core\";\nimport { walletRouterAction } from \"@elizaos/plugin-wallet\";\nimport { stewardBalanceProvider } from \"./providers/steward-balance.js\";\nimport { stewardReceiveAddressProvider } from \"./providers/steward-receive-address.js\";\nimport { handleStewardCompatRoutes } from \"./routes/steward-compat-routes.js\";\nimport { handleWalletBrowserCompatRoutes } from \"./routes/wallet-browser-compat-routes.js\";\nimport { handleWalletBscCoreRoutes } from \"./routes/wallet-bsc-core-routes.js\";\nimport { handleWalletCompatRoutes } from \"./routes/wallet-compat-routes.js\";\nimport { handleWalletCoreRoutes } from \"./routes/wallet-core-routes.js\";\nimport { handleWalletTradeCompatRoutes } from \"./routes/wallet-trade-compat-routes.js\";\n\n// ---------------------------------------------------------------------------\n// Helper: build a CompatRuntimeState adapter. The compat handlers need a `state`\n// object with `{ current: AgentRuntime | null }`.  When dispatched via the\n// plugin route system the runtime is the third argument, so we thread it\n// through.\n// ---------------------------------------------------------------------------\n\nfunction buildCompatState(runtime: unknown): CompatRuntimeState {\n  // The compat handlers only read `state.current` (the running AgentRuntime).\n  // When invoked through the plugin route system, `runtime` is the live\n  // AgentRuntime instance — pass it as `current`.\n  return { current: runtime } as CompatRuntimeState;\n}\n\n// ---------------------------------------------------------------------------\n// Generic wrapper for any of the four compat handler functions.\n// ---------------------------------------------------------------------------\n\ntype CompatHandler = (\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  state: CompatRuntimeState,\n) => Promise<boolean>;\n\nfunction stewardRouteHandler(handler: CompatHandler) {\n  return async (\n    req: unknown,\n    res: unknown,\n    runtime: unknown,\n  ): Promise<void> => {\n    const httpReq = req as http.IncomingMessage;\n    const httpRes = res as http.ServerResponse;\n    await handler(httpReq, httpRes, buildCompatState(runtime));\n  };\n}\n\n/** Wrapper for handlers that take (req, res, state) with state as unknown. */\ntype CoreHandler = (\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  state: unknown,\n) => Promise<boolean>;\n\nfunction coreRouteHandler(handler: CoreHandler) {\n  return async (\n    req: unknown,\n    res: unknown,\n    runtime: unknown,\n  ): Promise<void> => {\n    const httpReq = req as http.IncomingMessage;\n    const httpRes = res as http.ServerResponse;\n    await handler(httpReq, httpRes, runtime);\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Route definitions\n// ---------------------------------------------------------------------------\n\nconst stewardRoutes: Route[] = [\n  // ── Core wallet routes (addresses, balances, import, generate, config, export) ──\n\n  // GET /api/wallet/addresses\n  {\n    type: \"GET\",\n    path: \"/api/wallet/addresses\",\n    rawPath: true,\n    handler: coreRouteHandler(handleWalletCoreRoutes),\n  },\n  // GET /api/wallet/balances\n  {\n    type: \"GET\",\n    path: \"/api/wallet/balances\",\n    rawPath: true,\n    handler: coreRouteHandler(handleWalletCoreRoutes),\n  },\n  // POST /api/wallet/import\n  {\n    type: \"POST\",\n    path: \"/api/wallet/import\",\n    rawPath: true,\n    handler: coreRouteHandler(handleWalletCoreRoutes),\n  },\n  // POST /api/wallet/generate\n  {\n    type: \"POST\",\n    path: \"/api/wallet/generate\",\n    rawPath: true,\n    handler: coreRouteHandler(handleWalletCoreRoutes),\n  },\n  // GET /api/wallet/config\n  {\n    type: \"GET\",\n    path: \"/api/wallet/config\",\n    rawPath: true,\n    handler: coreRouteHandler(handleWalletCoreRoutes),\n  },\n  // PUT /api/wallet/config\n  {\n    type: \"PUT\",\n    path: \"/api/wallet/config\",\n    rawPath: true,\n    handler: coreRouteHandler(handleWalletCoreRoutes),\n  },\n  // POST /api/wallet/export\n  {\n    type: \"POST\",\n    path: \"/api/wallet/export\",\n    rawPath: true,\n    handler: coreRouteHandler(handleWalletCoreRoutes),\n  },\n\n  // ── BSC trade routes (preflight, quote, tx-status, profile, transfer, defaults) ──\n\n  // POST /api/wallet/trade/preflight\n  {\n    type: \"POST\",\n    path: \"/api/wallet/trade/preflight\",\n    rawPath: true,\n    handler: coreRouteHandler(handleWalletBscCoreRoutes),\n  },\n  // POST /api/wallet/trade/quote\n  {\n    type: \"POST\",\n    path: \"/api/wallet/trade/quote\",\n    rawPath: true,\n    handler: coreRouteHandler(handleWalletBscCoreRoutes),\n  },\n  // GET /api/wallet/trade/tx-status\n  {\n    type: \"GET\",\n    path: \"/api/wallet/trade/tx-status\",\n    rawPath: true,\n    handler: coreRouteHandler(handleWalletBscCoreRoutes),\n  },\n  // GET /api/wallet/trading/profile\n  {\n    type: \"GET\",\n    path: \"/api/wallet/trading/profile\",\n    rawPath: true,\n    handler: coreRouteHandler(handleWalletBscCoreRoutes),\n  },\n  // POST /api/wallet/production-defaults\n  {\n    type: \"POST\",\n    path: \"/api/wallet/production-defaults\",\n    rawPath: true,\n    handler: coreRouteHandler(handleWalletBscCoreRoutes),\n  },\n\n  // ── wallet-compat-routes (OS store, keys, NFTs) ────────────────────\n\n  // GET /api/wallet/os-store\n  {\n    type: \"GET\",\n    path: \"/api/wallet/os-store\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleWalletCompatRoutes),\n  },\n  // POST /api/wallet/os-store\n  {\n    type: \"POST\",\n    path: \"/api/wallet/os-store\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleWalletCompatRoutes),\n  },\n  // GET /api/wallet/keys\n  {\n    type: \"GET\",\n    path: \"/api/wallet/keys\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleWalletCompatRoutes),\n  },\n  // GET /api/wallet/nfts\n  {\n    type: \"GET\",\n    path: \"/api/wallet/nfts\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleWalletCompatRoutes),\n  },\n\n  // ── wallet-browser-compat-routes (browser wallet bridge) ───────────\n\n  // POST /api/wallet/browser-transaction\n  {\n    type: \"POST\",\n    path: \"/api/wallet/browser-transaction\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleWalletBrowserCompatRoutes),\n  },\n  // POST /api/wallet/browser-sign-message\n  {\n    type: \"POST\",\n    path: \"/api/wallet/browser-sign-message\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleWalletBrowserCompatRoutes),\n  },\n  // POST /api/wallet/browser-solana-sign-message\n  {\n    type: \"POST\",\n    path: \"/api/wallet/browser-solana-sign-message\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleWalletBrowserCompatRoutes),\n  },\n  // POST /api/wallet/browser-solana-transaction\n  {\n    type: \"POST\",\n    path: \"/api/wallet/browser-solana-transaction\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleWalletBrowserCompatRoutes),\n  },\n\n  // ── steward-compat-routes (steward wallet management) ──────────────\n\n  // GET /api/wallet/steward-status\n  {\n    type: \"GET\",\n    path: \"/api/wallet/steward-status\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleStewardCompatRoutes),\n  },\n  // GET /api/wallet/steward-policies\n  {\n    type: \"GET\",\n    path: \"/api/wallet/steward-policies\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleStewardCompatRoutes),\n  },\n  // PUT /api/wallet/steward-policies\n  {\n    type: \"PUT\",\n    path: \"/api/wallet/steward-policies\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleStewardCompatRoutes),\n  },\n  // GET /api/wallet/steward-tx-records\n  {\n    type: \"GET\",\n    path: \"/api/wallet/steward-tx-records\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleStewardCompatRoutes),\n  },\n  // GET /api/wallet/steward-pending-approvals\n  {\n    type: \"GET\",\n    path: \"/api/wallet/steward-pending-approvals\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleStewardCompatRoutes),\n  },\n  // POST /api/wallet/steward-approve-tx\n  {\n    type: \"POST\",\n    path: \"/api/wallet/steward-approve-tx\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleStewardCompatRoutes),\n  },\n  // POST /api/wallet/steward-deny-tx\n  {\n    type: \"POST\",\n    path: \"/api/wallet/steward-deny-tx\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleStewardCompatRoutes),\n  },\n  // POST /api/wallet/steward-webhook (loopback only, no auth)\n  {\n    type: \"POST\",\n    path: \"/api/wallet/steward-webhook\",\n    rawPath: true,\n    public: true,\n    name: \"steward-webhook\",\n    handler: stewardRouteHandler(handleStewardCompatRoutes),\n  },\n  // GET /api/wallet/steward-webhook-events\n  {\n    type: \"GET\",\n    path: \"/api/wallet/steward-webhook-events\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleStewardCompatRoutes),\n  },\n  // POST /api/wallet/steward-sign\n  {\n    type: \"POST\",\n    path: \"/api/wallet/steward-sign\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleStewardCompatRoutes),\n  },\n  // GET /api/wallet/steward-addresses\n  {\n    type: \"GET\",\n    path: \"/api/wallet/steward-addresses\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleStewardCompatRoutes),\n  },\n  // GET /api/wallet/steward-balances\n  {\n    type: \"GET\",\n    path: \"/api/wallet/steward-balances\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleStewardCompatRoutes),\n  },\n  // GET /api/wallet/steward-tokens\n  {\n    type: \"GET\",\n    path: \"/api/wallet/steward-tokens\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleStewardCompatRoutes),\n  },\n\n  // ── wallet-trade-compat-routes (trade / transfer execution) ────────\n\n  // POST /api/wallet/trade/execute\n  {\n    type: \"POST\",\n    path: \"/api/wallet/trade/execute\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleWalletTradeCompatRoutes),\n  },\n  // POST /api/wallet/transfer/execute\n  {\n    type: \"POST\",\n    path: \"/api/wallet/transfer/execute\",\n    rawPath: true,\n    handler: stewardRouteHandler(handleWalletTradeCompatRoutes),\n  },\n];\n\n// ---------------------------------------------------------------------------\n// Plugin export\n// ---------------------------------------------------------------------------\n\nexport const stewardPlugin: Plugin = {\n  name: \"@elizaos/plugin-steward-app\",\n  description:\n    \"Steward wallet management, browser wallet bridge, and trade/transfer routes (extracted from agent server.ts)\",\n  routes: stewardRoutes,\n  actions: [\n    // Canonical wallet router — handles preview, swap, transfer, and other\n    // wallet subactions across registered chain backends.\n    walletRouterAction,\n  ],\n  providers: [\n    // Read-only wallet snapshots surfaced to the planner every turn.\n    stewardBalanceProvider,\n    stewardReceiveAddressProvider,\n  ],\n  views: [\n    // ONE declaration → GUI + XR + TUI, all drawn from the single StewardView\n    // spatial source. `modalities` is a plain literal here (plugin.ts is not in\n    // the view bundle), so no brand-new `@elizaos/core` runtime export reaches\n    // the bundle build.\n    {\n      id: \"steward\",\n      label: \"Steward\",\n      description:\n        \"Transaction history and approval queue for Steward wallet management\",\n      icon: \"Shield\",\n      path: \"/steward\",\n      modalities: [\"gui\", \"xr\", \"tui\"],\n      bundlePath: \"dist/views/bundle.js\",\n      componentExport: \"StewardView\",\n      tags: [\"finance\", \"wallet\", \"approvals\", \"transactions\"],\n      visibleInManager: true,\n      desktopTabEnabled: true,\n    },\n  ],\n};\n"],"mappings":"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","names":[]}

package/dist/providers/steward-balance.d.ts

@@ -0,0 +1,12 @@
+/**
+ * stewardBalance provider — read-only wallet balance snapshot for the planner.
+ *
+ * Replaces the legacy CHECK_BALANCE action. Fetches `/api/wallet/balances` and
+ * renders a JSON-encoded summary so the LLM can see chain holdings without a
+ * mutating action call.
+ *
+ * @module providers/steward-balance
+ */
+import type { Provider } from "@elizaos/core";
+export declare const stewardBalanceProvider: Provider;
+//# sourceMappingURL=steward-balance.d.ts.map

package/dist/providers/steward-balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steward-balance.d.ts","sourceRoot":"","sources":["../../src/providers/steward-balance.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAGV,QAAQ,EAIT,MAAM,eAAe,CAAC;AA8FvB,eAAO,MAAM,sBAAsB,EAAE,QAgDpC,CAAC"}

package/dist/providers/steward-balance.js

@@ -0,0 +1,85 @@
+import {
+  buildAuthHeaders,
+  getWalletActionApiPort
+} from "../actions/wallet-action-shared.js";
+const BALANCE_TIMEOUT_MS = 1e4;
+const MAX_TOKENS_PER_CHAIN = 10;
+function buildSnapshot(data) {
+  return {
+    evm: data.evm ? {
+      address: data.evm.address,
+      chains: data.evm.chains.map(
+        (c) => ({
+          chain: c.chain,
+          chainId: c.chainId,
+          nativeSymbol: c.nativeSymbol,
+          nativeBalance: c.nativeBalance,
+          nativeValueUsd: c.nativeValueUsd,
+          tokens: c.tokens.slice(0, MAX_TOKENS_PER_CHAIN).map((t) => ({
+            symbol: t.symbol,
+            balance: t.balance,
+            valueUsd: t.valueUsd
+          })),
+          tokenOverflow: Math.max(
+            0,
+            c.tokens.length - MAX_TOKENS_PER_CHAIN
+          ),
+          error: c.error
+        })
+      )
+    } : null,
+    solana: data.solana ? {
+      address: data.solana.address,
+      solBalance: data.solana.solBalance,
+      solValueUsd: data.solana.solValueUsd,
+      tokens: data.solana.tokens.slice(0, MAX_TOKENS_PER_CHAIN).map((t) => ({
+        symbol: t.symbol,
+        balance: t.balance,
+        valueUsd: t.valueUsd
+      })),
+      tokenOverflow: Math.max(
+        0,
+        data.solana.tokens.length - MAX_TOKENS_PER_CHAIN
+      )
+    } : null
+  };
+}
+const stewardBalanceProvider = {
+  name: "stewardBalance",
+  description: "Wallet balances across configured chains (EVM + Solana). Read-only snapshot for the planner so it can answer balance / portfolio / holdings questions without invoking a mutating action.",
+  descriptionCompressed: "Wallet balances across chains.",
+  dynamic: true,
+  contexts: ["finance", "wallet", "crypto"],
+  contextGate: { anyOf: ["finance", "wallet", "crypto"] },
+  cacheStable: false,
+  cacheScope: "turn",
+  get: async (_runtime, _message, _state) => {
+    try {
+      const response = await fetch(
+        `http://127.0.0.1:${getWalletActionApiPort()}/api/wallet/balances`,
+        {
+          headers: { ...buildAuthHeaders() },
+          signal: AbortSignal.timeout(BALANCE_TIMEOUT_MS)
+        }
+      );
+      if (!response.ok) {
+        return { text: "" };
+      }
+      const data = await response.json();
+      const snapshot = buildSnapshot(data);
+      if (!snapshot.evm && !snapshot.solana) {
+        return { text: "" };
+      }
+      return {
+        text: JSON.stringify({ steward_balance: snapshot }),
+        data: { snapshot }
+      };
+    } catch {
+      return { text: "", data: { snapshot: null } };
+    }
+  }
+};
+export {
+  stewardBalanceProvider
+};
+//# sourceMappingURL=steward-balance.js.map

package/dist/providers/steward-balance.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/steward-balance.ts"],"sourcesContent":["/**\n * stewardBalance provider — read-only wallet balance snapshot for the planner.\n *\n * Replaces the legacy CHECK_BALANCE action. Fetches `/api/wallet/balances` and\n * renders a JSON-encoded summary so the LLM can see chain holdings without a\n * mutating action call.\n *\n * @module providers/steward-balance\n */\n\nimport type {\n  IAgentRuntime,\n  Memory,\n  Provider,\n  ProviderResult,\n  State,\n  WalletBalancesResponse,\n} from \"@elizaos/core\";\nimport {\n  buildAuthHeaders,\n  getWalletActionApiPort,\n} from \"../actions/wallet-action-shared.js\";\n\n/** Timeout for the balance API call. */\nconst BALANCE_TIMEOUT_MS = 10_000;\n\n/** Maximum token holdings to surface per chain. */\nconst MAX_TOKENS_PER_CHAIN = 10;\n\ninterface BalanceEvmChainSummary {\n  chain: string;\n  chainId: number;\n  nativeSymbol: string;\n  nativeBalance: string;\n  nativeValueUsd: string;\n  tokens: Array<{\n    symbol: string;\n    balance: string;\n    valueUsd: string;\n  }>;\n  tokenOverflow: number;\n  error: string | null;\n}\n\ninterface BalanceSolanaSummary {\n  address: string;\n  solBalance: string;\n  solValueUsd: string;\n  tokens: Array<{\n    symbol: string;\n    balance: string;\n    valueUsd: string;\n  }>;\n  tokenOverflow: number;\n}\n\ninterface BalanceSnapshot {\n  evm: {\n    address: string;\n    chains: BalanceEvmChainSummary[];\n  } | null;\n  solana: BalanceSolanaSummary | null;\n}\n\nfunction buildSnapshot(data: WalletBalancesResponse): BalanceSnapshot {\n  return {\n    evm: data.evm\n      ? {\n          address: data.evm.address,\n          chains: data.evm.chains.map(\n            (c): BalanceEvmChainSummary => ({\n              chain: c.chain,\n              chainId: c.chainId,\n              nativeSymbol: c.nativeSymbol,\n              nativeBalance: c.nativeBalance,\n              nativeValueUsd: c.nativeValueUsd,\n              tokens: c.tokens.slice(0, MAX_TOKENS_PER_CHAIN).map((t) => ({\n                symbol: t.symbol,\n                balance: t.balance,\n                valueUsd: t.valueUsd,\n              })),\n              tokenOverflow: Math.max(\n                0,\n                c.tokens.length - MAX_TOKENS_PER_CHAIN,\n              ),\n              error: c.error,\n            }),\n          ),\n        }\n      : null,\n    solana: data.solana\n      ? {\n          address: data.solana.address,\n          solBalance: data.solana.solBalance,\n          solValueUsd: data.solana.solValueUsd,\n          tokens: data.solana.tokens\n            .slice(0, MAX_TOKENS_PER_CHAIN)\n            .map((t) => ({\n              symbol: t.symbol,\n              balance: t.balance,\n              valueUsd: t.valueUsd,\n            })),\n          tokenOverflow: Math.max(\n            0,\n            data.solana.tokens.length - MAX_TOKENS_PER_CHAIN,\n          ),\n        }\n      : null,\n  };\n}\n\nexport const stewardBalanceProvider: Provider = {\n  name: \"stewardBalance\",\n\n  description:\n    \"Wallet balances across configured chains (EVM + Solana). Read-only \" +\n    \"snapshot for the planner so it can answer balance / portfolio / holdings \" +\n    \"questions without invoking a mutating action.\",\n  descriptionCompressed: \"Wallet balances across chains.\",\n\n  dynamic: true,\n  contexts: [\"finance\", \"wallet\", \"crypto\"],\n  contextGate: { anyOf: [\"finance\", \"wallet\", \"crypto\"] },\n  cacheStable: false,\n  cacheScope: \"turn\",\n\n  get: async (\n    _runtime: IAgentRuntime,\n    _message: Memory,\n    _state: State,\n  ): Promise<ProviderResult> => {\n    try {\n      const response = await fetch(\n        `http://127.0.0.1:${getWalletActionApiPort()}/api/wallet/balances`,\n        {\n          headers: { ...buildAuthHeaders() },\n          signal: AbortSignal.timeout(BALANCE_TIMEOUT_MS),\n        },\n      );\n\n      if (!response.ok) {\n        return { text: \"\" };\n      }\n\n      const data = (await response.json()) as WalletBalancesResponse;\n      const snapshot = buildSnapshot(data);\n\n      if (!snapshot.evm && !snapshot.solana) {\n        return { text: \"\" };\n      }\n\n      return {\n        text: JSON.stringify({ steward_balance: snapshot }),\n        data: { snapshot },\n      };\n    } catch {\n      return { text: \"\", data: { snapshot: null } };\n    }\n  },\n};\n"],"mappings":"AAkBA;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAGP,MAAM,qBAAqB;AAG3B,MAAM,uBAAuB;AAqC7B,SAAS,cAAc,MAA+C;AACpE,SAAO;AAAA,IACL,KAAK,KAAK,MACN;AAAA,MACE,SAAS,KAAK,IAAI;AAAA,MAClB,QAAQ,KAAK,IAAI,OAAO;AAAA,QACtB,CAAC,OAA+B;AAAA,UAC9B,OAAO,EAAE;AAAA,UACT,SAAS,EAAE;AAAA,UACX,cAAc,EAAE;AAAA,UAChB,eAAe,EAAE;AAAA,UACjB,gBAAgB,EAAE;AAAA,UAClB,QAAQ,EAAE,OAAO,MAAM,GAAG,oBAAoB,EAAE,IAAI,CAAC,OAAO;AAAA,YAC1D,QAAQ,EAAE;AAAA,YACV,SAAS,EAAE;AAAA,YACX,UAAU,EAAE;AAAA,UACd,EAAE;AAAA,UACF,eAAe,KAAK;AAAA,YAClB;AAAA,YACA,EAAE,OAAO,SAAS;AAAA,UACpB;AAAA,UACA,OAAO,EAAE;AAAA,QACX;AAAA,MACF;AAAA,IACF,IACA;AAAA,IACJ,QAAQ,KAAK,SACT;AAAA,MACE,SAAS,KAAK,OAAO;AAAA,MACrB,YAAY,KAAK,OAAO;AAAA,MACxB,aAAa,KAAK,OAAO;AAAA,MACzB,QAAQ,KAAK,OAAO,OACjB,MAAM,GAAG,oBAAoB,EAC7B,IAAI,CAAC,OAAO;AAAA,QACX,QAAQ,EAAE;AAAA,QACV,SAAS,EAAE;AAAA,QACX,UAAU,EAAE;AAAA,MACd,EAAE;AAAA,MACJ,eAAe,KAAK;AAAA,QAClB;AAAA,QACA,KAAK,OAAO,OAAO,SAAS;AAAA,MAC9B;AAAA,IACF,IACA;AAAA,EACN;AACF;AAEO,MAAM,yBAAmC;AAAA,EAC9C,MAAM;AAAA,EAEN,aACE;AAAA,EAGF,uBAAuB;AAAA,EAEvB,SAAS;AAAA,EACT,UAAU,CAAC,WAAW,UAAU,QAAQ;AAAA,EACxC,aAAa,EAAE,OAAO,CAAC,WAAW,UAAU,QAAQ,EAAE;AAAA,EACtD,aAAa;AAAA,EACb,YAAY;AAAA,EAEZ,KAAK,OACH,UACA,UACA,WAC4B;AAC5B,QAAI;AACF,YAAM,WAAW,MAAM;AAAA,QACrB,oBAAoB,uBAAuB,CAAC;AAAA,QAC5C;AAAA,UACE,SAAS,EAAE,GAAG,iBAAiB,EAAE;AAAA,UACjC,QAAQ,YAAY,QAAQ,kBAAkB;AAAA,QAChD;AAAA,MACF;AAEA,UAAI,CAAC,SAAS,IAAI;AAChB,eAAO,EAAE,MAAM,GAAG;AAAA,MACpB;AAEA,YAAM,OAAQ,MAAM,SAAS,KAAK;AAClC,YAAM,WAAW,cAAc,IAAI;AAEnC,UAAI,CAAC,SAAS,OAAO,CAAC,SAAS,QAAQ;AACrC,eAAO,EAAE,MAAM,GAAG;AAAA,MACpB;AAEA,aAAO;AAAA,QACL,MAAM,KAAK,UAAU,EAAE,iBAAiB,SAAS,CAAC;AAAA,QAClD,MAAM,EAAE,SAAS;AAAA,MACnB;AAAA,IACF,QAAQ;AACN,aAAO,EAAE,MAAM,IAAI,MAAM,EAAE,UAAU,KAAK,EAAE;AAAA,IAC9C;AAAA,EACF;AACF;","names":[]}

package/dist/providers/steward-receive-address.d.ts

@@ -0,0 +1,12 @@
+/**
+ * stewardReceiveAddress provider — wallet receive addresses for the planner.
+ *
+ * Replaces the legacy GET_RECEIVE_ADDRESS action. Fetches
+ * `/api/wallet/addresses` and renders a JSON-encoded summary so the LLM can
+ * surface the user's deposit address without invoking a mutating action.
+ *
+ * @module providers/steward-receive-address
+ */
+import type { Provider } from "@elizaos/core";
+export declare const stewardReceiveAddressProvider: Provider;
+//# sourceMappingURL=steward-receive-address.d.ts.map

package/dist/providers/steward-receive-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steward-receive-address.d.ts","sourceRoot":"","sources":["../../src/providers/steward-receive-address.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAGV,QAAQ,EAIT,MAAM,eAAe,CAAC;AAcvB,eAAO,MAAM,6BAA6B,EAAE,QAmD3C,CAAC"}