@elizaos/plugin-elizacloud 2.0.0-beta.1 → 2.0.3-beta.2

package/dist/cloud/managed-payment-clients.d.ts

@@ -0,0 +1,166 @@
+export { normalizeCloudSiteUrl, resolveCloudApiBaseUrl } from "./base-url.js";
+export interface ElizaCloudManagedClientConfig {
+    configured: boolean;
+    apiKey: string | null;
+    apiBaseUrl: string;
+    siteUrl: string;
+}
+export declare function normalizeElizaCloudApiKey(value: string | undefined | null): string | null;
+export declare function resolveEnvElizaCloudManagedClientConfig(env?: Record<string, string | undefined>): ElizaCloudManagedClientConfig;
+type ConfigSource = () => ElizaCloudManagedClientConfig;
+export declare class PlaidManagedClientError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+export declare class PaypalManagedClientError extends Error {
+    readonly status: number;
+    readonly fallback: "csv_export" | null;
+    constructor(status: number, message: string, fallback?: "csv_export" | null);
+}
+export interface PlaidLinkTokenResponse {
+    linkToken: string;
+    expiration: string;
+    environment: "sandbox" | "development" | "production";
+}
+export interface PlaidExchangeResponse {
+    accessToken: string;
+    itemId: string;
+    institution: {
+        institutionId: string;
+        institutionName: string;
+        primaryAccountMask: string | null;
+        accounts: Array<{
+            accountId: string;
+            name: string;
+            mask: string | null;
+            type: string;
+            subtype: string | null;
+        }>;
+    };
+}
+export interface PlaidSyncResponse {
+    added: PlaidTransactionDto[];
+    modified: PlaidTransactionDto[];
+    removed: Array<{
+        transaction_id: string;
+    }>;
+    nextCursor: string;
+    hasMore: boolean;
+}
+export interface PlaidTransactionDto {
+    transaction_id: string;
+    account_id: string;
+    amount: number;
+    iso_currency_code: string | null;
+    unofficial_currency_code: string | null;
+    date: string;
+    authorized_date: string | null;
+    name: string;
+    merchant_name: string | null;
+    pending: boolean;
+    category: string[] | null;
+    personal_finance_category: {
+        primary: string;
+        detailed: string;
+    } | null;
+}
+export declare class PlaidManagedClient {
+    private readonly configSource;
+    constructor(configSource?: ConfigSource);
+    private requireConfig;
+    get configured(): boolean;
+    createLinkToken(): Promise<PlaidLinkTokenResponse>;
+    exchangePublicToken(args: {
+        publicToken: string;
+    }): Promise<PlaidExchangeResponse>;
+    syncTransactions(args: {
+        accessToken: string;
+        cursor?: string;
+        count?: number;
+    }): Promise<PlaidSyncResponse>;
+}
+export interface PaypalAuthorizeUrlResponse {
+    url: string;
+    scope: string;
+    environment: "live" | "sandbox";
+}
+export interface PaypalCallbackResponse {
+    accessToken: string;
+    refreshToken: string | null;
+    expiresIn: number;
+    scope: string;
+    capability: {
+        hasReporting: boolean;
+        hasIdentity: boolean;
+    };
+    identity: {
+        payerId: string;
+        emails: string[];
+        name: string | null;
+    } | null;
+}
+export interface PaypalTransactionDto {
+    transaction_info: {
+        transaction_id: string;
+        transaction_initiation_date: string;
+        transaction_updated_date: string | null;
+        transaction_amount: {
+            currency_code: string;
+            value: string;
+        };
+        transaction_status: string;
+        transaction_subject: string | null;
+        transaction_note: string | null;
+    };
+    payer_info?: {
+        email_address?: string;
+        payer_name?: {
+            alternate_full_name?: string;
+        };
+    };
+    shipping_info?: {
+        name?: string;
+    };
+    cart_info?: {
+        item_details?: Array<{
+            item_name?: string;
+            item_amount?: {
+                currency_code: string;
+                value: string;
+            };
+        }>;
+    };
+}
+export interface PaypalTransactionsResponse {
+    transactions: PaypalTransactionDto[];
+    totalItems: number;
+    totalPages: number;
+    page: number;
+}
+export declare class PaypalManagedClient {
+    private readonly configSource;
+    constructor(configSource?: ConfigSource);
+    private requireConfig;
+    get configured(): boolean;
+    buildAuthorizeUrl(args: {
+        state: string;
+    }): Promise<PaypalAuthorizeUrlResponse>;
+    exchangeCode(args: {
+        code: string;
+    }): Promise<PaypalCallbackResponse>;
+    refreshAccessToken(args: {
+        refreshToken: string;
+    }): Promise<{
+        accessToken: string;
+        refreshToken: string | null;
+        expiresIn: number;
+        scope: string;
+    }>;
+    searchTransactions(args: {
+        accessToken: string;
+        startDate: string;
+        endDate: string;
+        page?: number;
+    }): Promise<PaypalTransactionsResponse>;
+}
+//# sourceMappingURL=managed-payment-clients.d.ts.map

package/dist/cloud/managed-payment-clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-payment-clients.d.ts","sourceRoot":"","sources":["../../src/cloud/managed-payment-clients.ts"],"names":[],"mappings":"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"}

package/dist/cloud/managed-payment-clients.js

@@ -0,0 +1,238 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/cloud/base-url.ts
+import { normalizeCloudSiteUrl, resolveCloudApiBaseUrl } from "@elizaos/shared";
+var init_base_url = () => {};
+
+// src/cloud/managed-payment-clients.ts
+init_base_url();
+init_base_url();
+function normalizeElizaCloudApiKey(value) {
+  const trimmed = value?.trim();
+  if (!trimmed)
+    return null;
+  return trimmed.toUpperCase() === "[REDACTED]" ? null : trimmed;
+}
+function resolveEnvElizaCloudManagedClientConfig(env = typeof process === "undefined" ? {} : process.env) {
+  const apiKey = normalizeElizaCloudApiKey(env.ELIZAOS_CLOUD_API_KEY);
+  const baseUrl = env.ELIZAOS_CLOUD_BASE_URL;
+  return {
+    configured: Boolean(apiKey),
+    apiKey,
+    apiBaseUrl: resolveCloudApiBaseUrl(baseUrl),
+    siteUrl: normalizeCloudSiteUrl(baseUrl)
+  };
+}
+var PLAID_REQUEST_TIMEOUT_MS = 30000;
+var PAYPAL_REQUEST_TIMEOUT_MS = 30000;
+
+class PlaidManagedClientError extends Error {
+  status;
+  constructor(status, message) {
+    super(message);
+    this.status = status;
+    this.name = "PlaidManagedClientError";
+  }
+}
+
+class PaypalManagedClientError extends Error {
+  status;
+  fallback;
+  constructor(status, message, fallback = null) {
+    super(message);
+    this.status = status;
+    this.fallback = fallback;
+    this.name = "PaypalManagedClientError";
+  }
+}
+async function readPlaidJson(response) {
+  if (!response.ok) {
+    let detail = `${response.status} ${response.statusText}`.trim();
+    const text = await response.text();
+    if (text.trim().length > 0) {
+      try {
+        const parsed = JSON.parse(text);
+        detail = parsed.message ?? parsed.error ?? text.slice(0, 240);
+      } catch {
+        detail = text.slice(0, 240);
+      }
+    }
+    throw new PlaidManagedClientError(response.status, detail);
+  }
+  return await response.json();
+}
+async function readPaypalJson(response) {
+  if (!response.ok) {
+    let detail = `${response.status} ${response.statusText}`.trim();
+    let fallback = null;
+    const text = await response.text();
+    if (text.trim().length > 0) {
+      try {
+        const parsed = JSON.parse(text);
+        detail = parsed.message ?? parsed.error ?? text.slice(0, 240);
+        fallback = parsed.fallback ?? null;
+      } catch {
+        detail = text.slice(0, 240);
+      }
+    }
+    throw new PaypalManagedClientError(response.status, detail, fallback);
+  }
+  return await response.json();
+}
+
+class PlaidManagedClient {
+  configSource;
+  constructor(configSource = resolveEnvElizaCloudManagedClientConfig) {
+    this.configSource = configSource;
+  }
+  requireConfig() {
+    const config = this.configSource();
+    if (!config.apiKey) {
+      throw new PlaidManagedClientError(409, "Eliza Cloud is not connected.");
+    }
+    return { ...config, apiKey: config.apiKey };
+  }
+  get configured() {
+    return this.configSource().configured;
+  }
+  async createLinkToken() {
+    const config = this.requireConfig();
+    const response = await fetch(`${config.apiBaseUrl}/v1/eliza/plaid/link-token`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${config.apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: "{}",
+      signal: AbortSignal.timeout(PLAID_REQUEST_TIMEOUT_MS)
+    });
+    return readPlaidJson(response);
+  }
+  async exchangePublicToken(args) {
+    const config = this.requireConfig();
+    const response = await fetch(`${config.apiBaseUrl}/v1/eliza/plaid/exchange`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${config.apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ publicToken: args.publicToken }),
+      signal: AbortSignal.timeout(PLAID_REQUEST_TIMEOUT_MS)
+    });
+    return readPlaidJson(response);
+  }
+  async syncTransactions(args) {
+    const config = this.requireConfig();
+    const response = await fetch(`${config.apiBaseUrl}/v1/eliza/plaid/sync`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${config.apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        accessToken: args.accessToken,
+        cursor: args.cursor ?? "",
+        count: args.count ?? 250
+      }),
+      signal: AbortSignal.timeout(PLAID_REQUEST_TIMEOUT_MS * 2)
+    });
+    return readPlaidJson(response);
+  }
+}
+
+class PaypalManagedClient {
+  configSource;
+  constructor(configSource = resolveEnvElizaCloudManagedClientConfig) {
+    this.configSource = configSource;
+  }
+  requireConfig() {
+    const config = this.configSource();
+    if (!config.apiKey) {
+      throw new PaypalManagedClientError(409, "Eliza Cloud is not connected.");
+    }
+    return { ...config, apiKey: config.apiKey };
+  }
+  get configured() {
+    return this.configSource().configured;
+  }
+  async buildAuthorizeUrl(args) {
+    const config = this.requireConfig();
+    const response = await fetch(`${config.apiBaseUrl}/v1/eliza/paypal/authorize`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${config.apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ state: args.state }),
+      signal: AbortSignal.timeout(PAYPAL_REQUEST_TIMEOUT_MS)
+    });
+    return readPaypalJson(response);
+  }
+  async exchangeCode(args) {
+    const config = this.requireConfig();
+    const response = await fetch(`${config.apiBaseUrl}/v1/eliza/paypal/callback`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${config.apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ code: args.code }),
+      signal: AbortSignal.timeout(PAYPAL_REQUEST_TIMEOUT_MS)
+    });
+    return readPaypalJson(response);
+  }
+  async refreshAccessToken(args) {
+    const config = this.requireConfig();
+    const response = await fetch(`${config.apiBaseUrl}/v1/eliza/paypal/refresh`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${config.apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ refreshToken: args.refreshToken }),
+      signal: AbortSignal.timeout(PAYPAL_REQUEST_TIMEOUT_MS)
+    });
+    return readPaypalJson(response);
+  }
+  async searchTransactions(args) {
+    const config = this.requireConfig();
+    const response = await fetch(`${config.apiBaseUrl}/v1/eliza/paypal/transactions`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${config.apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(args),
+      signal: AbortSignal.timeout(PAYPAL_REQUEST_TIMEOUT_MS * 2)
+    });
+    return readPaypalJson(response);
+  }
+}
+export {
+  resolveEnvElizaCloudManagedClientConfig,
+  resolveCloudApiBaseUrl,
+  normalizeElizaCloudApiKey,
+  normalizeCloudSiteUrl,
+  PlaidManagedClientError,
+  PlaidManagedClient,
+  PaypalManagedClientError,
+  PaypalManagedClient
+};
+
+//# debugId=2B8E2C0AADAD7D4A64756E2164756E21

package/dist/cloud/managed-payment-clients.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/cloud/base-url.ts", "../src/cloud/managed-payment-clients.ts"],
+  "sourcesContent": [
+    "/**\n * Cloud site/API URL normalizer. The implementation moved to\n * `@elizaos/shared/elizacloud/base-url` so host-layer packages can normalize\n * URLs without reverse-importing this plugin.\n */\nexport { normalizeCloudSiteUrl, resolveCloudApiBaseUrl } from \"@elizaos/shared\";\n",
+    "import {\n  normalizeCloudSiteUrl,\n  resolveCloudApiBaseUrl,\n} from \"./base-url.js\";\n\nexport { normalizeCloudSiteUrl, resolveCloudApiBaseUrl } from \"./base-url.js\";\n\nexport interface ElizaCloudManagedClientConfig {\n  configured: boolean;\n  apiKey: string | null;\n  apiBaseUrl: string;\n  siteUrl: string;\n}\n\nexport function normalizeElizaCloudApiKey(\n  value: string | undefined | null,\n): string | null {\n  const trimmed = value?.trim();\n  if (!trimmed) return null;\n  return trimmed.toUpperCase() === \"[REDACTED]\" ? null : trimmed;\n}\n\nexport function resolveEnvElizaCloudManagedClientConfig(\n  env: Record<string, string | undefined> =\n    typeof process === \"undefined\" ? {} : process.env,\n): ElizaCloudManagedClientConfig {\n  const apiKey = normalizeElizaCloudApiKey(env.ELIZAOS_CLOUD_API_KEY);\n  const baseUrl = env.ELIZAOS_CLOUD_BASE_URL;\n  return {\n    configured: Boolean(apiKey),\n    apiKey,\n    apiBaseUrl: resolveCloudApiBaseUrl(baseUrl),\n    siteUrl: normalizeCloudSiteUrl(baseUrl),\n  };\n}\n\nconst PLAID_REQUEST_TIMEOUT_MS = 30_000;\nconst PAYPAL_REQUEST_TIMEOUT_MS = 30_000;\n\ntype ConfigSource = () => ElizaCloudManagedClientConfig;\n\nexport class PlaidManagedClientError extends Error {\n  constructor(\n    public readonly status: number,\n    message: string,\n  ) {\n    super(message);\n    this.name = \"PlaidManagedClientError\";\n  }\n}\n\nexport class PaypalManagedClientError extends Error {\n  constructor(\n    public readonly status: number,\n    message: string,\n    public readonly fallback: \"csv_export\" | null = null,\n  ) {\n    super(message);\n    this.name = \"PaypalManagedClientError\";\n  }\n}\n\nasync function readPlaidJson<T>(response: Response): Promise<T> {\n  if (!response.ok) {\n    let detail = `${response.status} ${response.statusText}`.trim();\n    const text = await response.text();\n    if (text.trim().length > 0) {\n      try {\n        const parsed = JSON.parse(text) as {\n          error?: string;\n          message?: string;\n        };\n        detail = parsed.message ?? parsed.error ?? text.slice(0, 240);\n      } catch {\n        detail = text.slice(0, 240);\n      }\n    }\n    throw new PlaidManagedClientError(response.status, detail);\n  }\n  return (await response.json()) as T;\n}\n\nasync function readPaypalJson<T>(response: Response): Promise<T> {\n  if (!response.ok) {\n    let detail = `${response.status} ${response.statusText}`.trim();\n    let fallback: \"csv_export\" | null = null;\n    const text = await response.text();\n    if (text.trim().length > 0) {\n      try {\n        const parsed = JSON.parse(text) as {\n          error?: string;\n          message?: string;\n          fallback?: \"csv_export\" | null;\n        };\n        detail = parsed.message ?? parsed.error ?? text.slice(0, 240);\n        fallback = parsed.fallback ?? null;\n      } catch {\n        detail = text.slice(0, 240);\n      }\n    }\n    throw new PaypalManagedClientError(response.status, detail, fallback);\n  }\n  return (await response.json()) as T;\n}\n\nexport interface PlaidLinkTokenResponse {\n  linkToken: string;\n  expiration: string;\n  environment: \"sandbox\" | \"development\" | \"production\";\n}\n\nexport interface PlaidExchangeResponse {\n  accessToken: string;\n  itemId: string;\n  institution: {\n    institutionId: string;\n    institutionName: string;\n    primaryAccountMask: string | null;\n    accounts: Array<{\n      accountId: string;\n      name: string;\n      mask: string | null;\n      type: string;\n      subtype: string | null;\n    }>;\n  };\n}\n\nexport interface PlaidSyncResponse {\n  added: PlaidTransactionDto[];\n  modified: PlaidTransactionDto[];\n  removed: Array<{ transaction_id: string }>;\n  nextCursor: string;\n  hasMore: boolean;\n}\n\nexport interface PlaidTransactionDto {\n  transaction_id: string;\n  account_id: string;\n  amount: number;\n  iso_currency_code: string | null;\n  unofficial_currency_code: string | null;\n  date: string;\n  authorized_date: string | null;\n  name: string;\n  merchant_name: string | null;\n  pending: boolean;\n  category: string[] | null;\n  personal_finance_category: {\n    primary: string;\n    detailed: string;\n  } | null;\n}\n\nexport class PlaidManagedClient {\n  constructor(\n    private readonly configSource: ConfigSource =\n      resolveEnvElizaCloudManagedClientConfig,\n  ) {}\n\n  private requireConfig(): ElizaCloudManagedClientConfig & { apiKey: string } {\n    const config = this.configSource();\n    if (!config.apiKey) {\n      throw new PlaidManagedClientError(409, \"Eliza Cloud is not connected.\");\n    }\n    return { ...config, apiKey: config.apiKey };\n  }\n\n  get configured(): boolean {\n    return this.configSource().configured;\n  }\n\n  async createLinkToken(): Promise<PlaidLinkTokenResponse> {\n    const config = this.requireConfig();\n    const response = await fetch(\n      `${config.apiBaseUrl}/v1/eliza/plaid/link-token`,\n      {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${config.apiKey}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: \"{}\",\n        signal: AbortSignal.timeout(PLAID_REQUEST_TIMEOUT_MS),\n      },\n    );\n    return readPlaidJson<PlaidLinkTokenResponse>(response);\n  }\n\n  async exchangePublicToken(args: {\n    publicToken: string;\n  }): Promise<PlaidExchangeResponse> {\n    const config = this.requireConfig();\n    const response = await fetch(\n      `${config.apiBaseUrl}/v1/eliza/plaid/exchange`,\n      {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${config.apiKey}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({ publicToken: args.publicToken }),\n        signal: AbortSignal.timeout(PLAID_REQUEST_TIMEOUT_MS),\n      },\n    );\n    return readPlaidJson<PlaidExchangeResponse>(response);\n  }\n\n  async syncTransactions(args: {\n    accessToken: string;\n    cursor?: string;\n    count?: number;\n  }): Promise<PlaidSyncResponse> {\n    const config = this.requireConfig();\n    const response = await fetch(`${config.apiBaseUrl}/v1/eliza/plaid/sync`, {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${config.apiKey}`,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify({\n        accessToken: args.accessToken,\n        cursor: args.cursor ?? \"\",\n        count: args.count ?? 250,\n      }),\n      signal: AbortSignal.timeout(PLAID_REQUEST_TIMEOUT_MS * 2),\n    });\n    return readPlaidJson<PlaidSyncResponse>(response);\n  }\n}\n\nexport interface PaypalAuthorizeUrlResponse {\n  url: string;\n  scope: string;\n  environment: \"live\" | \"sandbox\";\n}\n\nexport interface PaypalCallbackResponse {\n  accessToken: string;\n  refreshToken: string | null;\n  expiresIn: number;\n  scope: string;\n  capability: { hasReporting: boolean; hasIdentity: boolean };\n  identity: { payerId: string; emails: string[]; name: string | null } | null;\n}\n\nexport interface PaypalTransactionDto {\n  transaction_info: {\n    transaction_id: string;\n    transaction_initiation_date: string;\n    transaction_updated_date: string | null;\n    transaction_amount: { currency_code: string; value: string };\n    transaction_status: string;\n    transaction_subject: string | null;\n    transaction_note: string | null;\n  };\n  payer_info?: {\n    email_address?: string;\n    payer_name?: { alternate_full_name?: string };\n  };\n  shipping_info?: { name?: string };\n  cart_info?: {\n    item_details?: Array<{\n      item_name?: string;\n      item_amount?: { currency_code: string; value: string };\n    }>;\n  };\n}\n\nexport interface PaypalTransactionsResponse {\n  transactions: PaypalTransactionDto[];\n  totalItems: number;\n  totalPages: number;\n  page: number;\n}\n\nexport class PaypalManagedClient {\n  constructor(\n    private readonly configSource: ConfigSource =\n      resolveEnvElizaCloudManagedClientConfig,\n  ) {}\n\n  private requireConfig(): ElizaCloudManagedClientConfig & { apiKey: string } {\n    const config = this.configSource();\n    if (!config.apiKey) {\n      throw new PaypalManagedClientError(409, \"Eliza Cloud is not connected.\");\n    }\n    return { ...config, apiKey: config.apiKey };\n  }\n\n  get configured(): boolean {\n    return this.configSource().configured;\n  }\n\n  async buildAuthorizeUrl(args: {\n    state: string;\n  }): Promise<PaypalAuthorizeUrlResponse> {\n    const config = this.requireConfig();\n    const response = await fetch(\n      `${config.apiBaseUrl}/v1/eliza/paypal/authorize`,\n      {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${config.apiKey}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({ state: args.state }),\n        signal: AbortSignal.timeout(PAYPAL_REQUEST_TIMEOUT_MS),\n      },\n    );\n    return readPaypalJson<PaypalAuthorizeUrlResponse>(response);\n  }\n\n  async exchangeCode(args: { code: string }): Promise<PaypalCallbackResponse> {\n    const config = this.requireConfig();\n    const response = await fetch(\n      `${config.apiBaseUrl}/v1/eliza/paypal/callback`,\n      {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${config.apiKey}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({ code: args.code }),\n        signal: AbortSignal.timeout(PAYPAL_REQUEST_TIMEOUT_MS),\n      },\n    );\n    return readPaypalJson<PaypalCallbackResponse>(response);\n  }\n\n  async refreshAccessToken(args: { refreshToken: string }): Promise<{\n    accessToken: string;\n    refreshToken: string | null;\n    expiresIn: number;\n    scope: string;\n  }> {\n    const config = this.requireConfig();\n    const response = await fetch(\n      `${config.apiBaseUrl}/v1/eliza/paypal/refresh`,\n      {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${config.apiKey}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({ refreshToken: args.refreshToken }),\n        signal: AbortSignal.timeout(PAYPAL_REQUEST_TIMEOUT_MS),\n      },\n    );\n    return readPaypalJson(response);\n  }\n\n  async searchTransactions(args: {\n    accessToken: string;\n    startDate: string;\n    endDate: string;\n    page?: number;\n  }): Promise<PaypalTransactionsResponse> {\n    const config = this.requireConfig();\n    const response = await fetch(\n      `${config.apiBaseUrl}/v1/eliza/paypal/transactions`,\n      {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${config.apiKey}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(args),\n        signal: AbortSignal.timeout(PAYPAL_REQUEST_TIMEOUT_MS * 2),\n      },\n    );\n    return readPaypalJson<PaypalTransactionsResponse>(response);\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "2B8E2C0AADAD7D4A64756E2164756E21",
+  "names": []
+}

package/dist/cloud/null-observer.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Silent `CloudSetupObserver` for tests and headless runs.
+ *
+ * - All event methods intentionally ignore their inputs.
+ * - All prompt methods resolve to `null` (i.e. "user cancelled"), which
+ *   lets the orchestrator exercise its cancel branches without surfacing
+ *   any UI.
+ *
+ * Tests that want to assert observer calls should use a capturing
+ * observer instead.
+ *
+ * @module cloud/null-observer
+ */
+import type { CloudSetupObserver, ConfirmPrompt, ProvisionSuccessInfo, SelectChoicePrompt } from "./setup-observer.js";
+export declare class NullCloudSetupObserver implements CloudSetupObserver {
+    onAvailabilityChecked(_result: {
+        ok: boolean;
+        reason?: string;
+    }): void;
+    onAuthStart(_loginUrl: string): void;
+    onAuthBrowserOpenFailed(_loginUrl: string, _error: Error): void;
+    onAuthPollStatus(_status: string): void;
+    onAuthSuccess(): void;
+    onAuthFailure(_message: string): void;
+    onProvisionStart(_agentName: string): void;
+    onProvisionStatus(_status: string): void;
+    onProvisionTimeout(_agentId: string, _lastStatus: string): void;
+    onProvisionFailure(_reason: string): void;
+    onProvisionSuccess(_result: ProvisionSuccessInfo): void;
+    onNotice(_message: string): void;
+    onFatalError(_error: Error, _context: string): void;
+    confirm(_prompt: ConfirmPrompt): Promise<boolean | null>;
+    selectChoice<T extends string>(_prompt: SelectChoicePrompt<T>): Promise<T | null>;
+}
+//# sourceMappingURL=null-observer.d.ts.map

package/dist/cloud/null-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-observer.d.ts","sourceRoot":"","sources":["../../src/cloud/null-observer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D,qBAAqB,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IACtE,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IACpC,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,IAAI;IAC/D,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IACvC,aAAa,IAAI,IAAI;IACrB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IACrC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAC1C,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IACxC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAC/D,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IACzC,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAChC,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAE7C,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAIxD,YAAY,CAAC,CAAC,SAAS,MAAM,EACjC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;CAGrB"}

package/dist/cloud/null-observer.js

@@ -0,0 +1,45 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/cloud/null-observer.ts
+class NullCloudSetupObserver {
+  onAvailabilityChecked(_result) {}
+  onAuthStart(_loginUrl) {}
+  onAuthBrowserOpenFailed(_loginUrl, _error) {}
+  onAuthPollStatus(_status) {}
+  onAuthSuccess() {}
+  onAuthFailure(_message) {}
+  onProvisionStart(_agentName) {}
+  onProvisionStatus(_status) {}
+  onProvisionTimeout(_agentId, _lastStatus) {}
+  onProvisionFailure(_reason) {}
+  onProvisionSuccess(_result) {}
+  onNotice(_message) {}
+  onFatalError(_error, _context) {}
+  async confirm(_prompt) {
+    return null;
+  }
+  async selectChoice(_prompt) {
+    return null;
+  }
+}
+export {
+  NullCloudSetupObserver
+};
+
+//# debugId=41A094308B5C165F64756E2164756E21

package/dist/cloud/null-observer.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cloud/null-observer.ts"],
+  "sourcesContent": [
+    "/**\n * Silent `CloudSetupObserver` for tests and headless runs.\n *\n * - All event methods intentionally ignore their inputs.\n * - All prompt methods resolve to `null` (i.e. \"user cancelled\"), which\n *   lets the orchestrator exercise its cancel branches without surfacing\n *   any UI.\n *\n * Tests that want to assert observer calls should use a capturing\n * observer instead.\n *\n * @module cloud/null-observer\n */\nimport type {\n  CloudSetupObserver,\n  ConfirmPrompt,\n  ProvisionSuccessInfo,\n  SelectChoicePrompt,\n} from \"./setup-observer.js\";\n\nexport class NullCloudSetupObserver implements CloudSetupObserver {\n  onAvailabilityChecked(_result: { ok: boolean; reason?: string }): void {}\n  onAuthStart(_loginUrl: string): void {}\n  onAuthBrowserOpenFailed(_loginUrl: string, _error: Error): void {}\n  onAuthPollStatus(_status: string): void {}\n  onAuthSuccess(): void {}\n  onAuthFailure(_message: string): void {}\n  onProvisionStart(_agentName: string): void {}\n  onProvisionStatus(_status: string): void {}\n  onProvisionTimeout(_agentId: string, _lastStatus: string): void {}\n  onProvisionFailure(_reason: string): void {}\n  onProvisionSuccess(_result: ProvisionSuccessInfo): void {}\n  onNotice(_message: string): void {}\n  onFatalError(_error: Error, _context: string): void {}\n\n  async confirm(_prompt: ConfirmPrompt): Promise<boolean | null> {\n    return null;\n  }\n\n  async selectChoice<T extends string>(\n    _prompt: SelectChoicePrompt<T>,\n  ): Promise<T | null> {\n    return null;\n  }\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAoBO,MAAM,uBAAqD;AAAA,EAChE,qBAAqB,CAAC,SAAiD;AAAA,EACvE,WAAW,CAAC,WAAyB;AAAA,EACrC,uBAAuB,CAAC,WAAmB,QAAqB;AAAA,EAChE,gBAAgB,CAAC,SAAuB;AAAA,EACxC,aAAa,GAAS;AAAA,EACtB,aAAa,CAAC,UAAwB;AAAA,EACtC,gBAAgB,CAAC,YAA0B;AAAA,EAC3C,iBAAiB,CAAC,SAAuB;AAAA,EACzC,kBAAkB,CAAC,UAAkB,aAA2B;AAAA,EAChE,kBAAkB,CAAC,SAAuB;AAAA,EAC1C,kBAAkB,CAAC,SAAqC;AAAA,EACxD,QAAQ,CAAC,UAAwB;AAAA,EACjC,YAAY,CAAC,QAAe,UAAwB;AAAA,OAE9C,QAAO,CAAC,SAAiD;AAAA,IAC7D,OAAO;AAAA;AAAA,OAGH,aAA8B,CAClC,SACmB;AAAA,IACnB,OAAO;AAAA;AAEX;",
+  "debugId": "41A094308B5C165F64756E2164756E21",
+  "names": []
+}

package/dist/cloud/setup-observer.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Transport-agnostic observer for the cloud setup orchestrator.
+ *
+ * `runCloudSetup` calls into this interface for every user-visible
+ * event and every interactive prompt. CLI provides a `@clack/prompts`-
+ * backed implementation; web/desktop provides an event-bridge
+ * implementation; tests provide a capturing observer.
+ *
+ * The orchestrator MUST stay free of any presentation-layer concerns
+ * (spinners, terminal output, GUI events). It only knows about the
+ * methods defined here.
+ *
+ * @module cloud/setup-observer
+ */
+import type { ProvisionInfo } from "./bridge-client.js";
+export interface AvailabilityResult {
+    ok: boolean;
+    /** Human-readable reason when `ok` is false. */
+    reason?: string;
+}
+export interface ProvisionSuccessInfo {
+    agentId: string;
+    bridgeUrl?: string;
+}
+export interface ConfirmPrompt {
+    message: string;
+    /** Optional override for the default value when the user just presses enter. */
+    defaultValue?: boolean;
+    /** Optional label for the "true" branch. CLI surfaces use this on a toggle. */
+    activeLabel?: string;
+    /** Optional label for the "false" branch. CLI surfaces use this on a toggle. */
+    inactiveLabel?: string;
+}
+export interface SelectChoiceOption<T extends string> {
+    label: string;
+    value: T;
+    hint?: string;
+}
+export interface SelectChoicePrompt<T extends string> {
+    message: string;
+    options: SelectChoiceOption<T>[];
+}
+/**
+ * Sink for every event the cloud setup orchestrator surfaces, plus the
+ * interactive prompts it needs to resolve.
+ *
+ * Implementation contract:
+ *
+ *   - Event methods are fire-and-forget; they MUST NOT throw. Implementations
+ *     that fail to render an event are responsible for their own logging.
+ *   - Prompt methods are async. A `null` return from `selectChoice` or a
+ *     cancellation from `confirm` is interpreted by the orchestrator as
+ *     "user cancelled" — the orchestrator decides what that means for the
+ *     flow. The observer MUST NOT exit the process or throw on cancel.
+ */
+export interface CloudSetupObserver {
+    onAvailabilityChecked(result: AvailabilityResult): void;
+    onAuthStart(loginUrl: string): void;
+    /**
+     * The orchestrator could not spawn the OS browser (no `open` / `xdg-open`
+     * / `cmd.exe` on PATH, etc.). The login URL is unchanged — the observer
+     * can render an inline "visit this URL manually" affordance, retry, or
+     * surface the error however it wants. This was previously swallowed
+     * silently behind a debug log.
+     */
+    onAuthBrowserOpenFailed(loginUrl: string, error: Error): void;
+    onAuthPollStatus(status: string): void;
+    onAuthSuccess(): void;
+    onAuthFailure(message: string): void;
+    onProvisionStart(agentName: string): void;
+    onProvisionStatus(status: string, current?: ProvisionInfo): void;
+    onProvisionTimeout(agentId: string, lastStatus: string): void;
+    onProvisionFailure(reason: string): void;
+    onProvisionSuccess(result: ProvisionSuccessInfo): void;
+    /**
+     * A categorized user-facing message that doesn't map onto a specific
+     * lifecycle event — e.g. "Cloud login was not completed", "Cloud agent
+     * is still starting up. You can try `eliza cloud connect` once it's
+     * ready." The CLI implementation renders these as `log.warn`.
+     */
+    onNotice(message: string): void;
+    /**
+     * An unexpected, non-flow-control error. The orchestrator does not
+     * itself swallow errors — it surfaces them here and lets the observer
+     * decide whether to retry, fall back, or rethrow.
+     */
+    onFatalError(error: Error, context: string): void;
+    /**
+     * Resolve to `true` / `false` for a yes/no decision, or `null` when the
+     * user explicitly cancels (e.g. Ctrl-C on CLI, modal dismiss on GUI).
+     */
+    confirm(prompt: ConfirmPrompt): Promise<boolean | null>;
+    /**
+     * Resolve to the chosen value, or `null` on cancel.
+     */
+    selectChoice<T extends string>(prompt: SelectChoicePrompt<T>): Promise<T | null>;
+}
+//# sourceMappingURL=setup-observer.d.ts.map

package/dist/cloud/setup-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-observer.d.ts","sourceRoot":"","sources":["../../src/cloud/setup-observer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMxD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;CAClC;AAMD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IAEjC,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAExD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC;;;;;;OAMG;IACH,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC9D,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,aAAa,IAAI,IAAI,CAAC;IACtB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACjE,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAEvD;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAGlD;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAExD;;OAEG;IACH,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3B,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CACtB"}

package/dist/cloud/setup-observer.js

@@ -0,0 +1,2 @@
+
+//# debugId=F6EBC316424461C464756E2164756E21