@elizaos/plugin-elizacloud 2.0.0-beta.1 → 2.0.11-beta.7

package/dist/utils/waifu-metering.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Waifu metering bridge.
+ *
+ * A hosted waifu agent runs as a sandboxed container whose model inference is
+ * routed through the Eliza Cloud metered inference gateway. The gateway is the
+ * honest meter: it owns the per-model pricing table and the platform markup,
+ * and it debits the organization's credit balance on every call. That debit is
+ * authoritative and already happens server-side.
+ *
+ * What was missing is the *signal back to waifu*: waifu's burn rollup
+ * (`apps/worker/src/processors/agent-rollup.ts`) reads `inference.spent`
+ * agent_events to compute `agentDailyBurnUsd` / `agentRunwayDays`, but falls
+ * back to a $5/day default estimate when no such events exist. Nothing emitted them.
+ *
+ * This bridge listens for the runtime `MODEL_USED` event (emitted by the cloud
+ * model handlers after each inference) and POSTs a signed `inference.spent`
+ * webhook to waifu's receiver (`POST /webhooks/eliza-cloud/inference`). It is
+ * inactive unless the container is provisioned with the waifu metering env knobs,
+ * so it never fires for non-hosted (local dev / standalone) agents.
+ *
+ * Token counts are exact (reported by the gateway). USD is the authoritative
+ * post-markup cost when the gateway surfaces it (`usage.cost_usd` /
+ * `X-Eliza-Cost-Usd`); otherwise a conservative token-based estimate is used,
+ * configurable per-model via WAIFU_METER_USD_PER_1K_INPUT / _OUTPUT. The credit
+ * debit itself is always the cloud's authoritative number; the estimate only
+ * affects waifu's burn display until the cloud cost is wired through.
+ */
+import { type IAgentRuntime } from "@elizaos/core";
+import type { ModelUsageEventPayload } from "./events";
+/**
+ * The MODEL_USED event `source` set by the Eliza Cloud metered inference path
+ * (see ./events.ts emitModelUsageEvent). ElizaOS event dispatch is global: every
+ * MODEL_USED handler receives every MODEL_USED event regardless of which plugin
+ * emitted it. Only inference that actually went through the cloud metered
+ * gateway debits real credits, so we must meter only those events. Other model
+ * providers (e.g. plugin-local-inference emits source "local-ai" for free CPU
+ * inference, plugin-openrouter emits "openrouter", etc.) must never be metered
+ * as cloud burn.
+ */
+export declare const CLOUD_INFERENCE_SOURCE = "elizacloud";
+export interface WaifuMeteringConfig {
+    webhookUrl: string;
+    secret: string;
+    agentId: string;
+    usdPer1kInput: number;
+    usdPer1kOutput: number;
+}
+/**
+ * Resolve the metering config from the container environment. Returns null
+ * (bridge disabled) when the required knobs are absent, which is the case for
+ * any agent that is not a hosted waifu agent.
+ */
+export declare function resolveWaifuMeteringConfig(runtime: IAgentRuntime): WaifuMeteringConfig | null;
+/**
+ * Resolve the inference webhook URL from the container environment.
+ *
+ * Prefers the explicit WAIFU_INFERENCE_WEBHOOK_URL. If that is absent but a
+ * credits webhook URL (WAIFU_WEBHOOK_URL) is present, derive the sibling
+ * `/inference` receiver path from the known `/credits` path. We NEVER post
+ * inference events to the credits receiver: the credits mapper defaults unknown
+ * payloads to `credits.topped_up`, which would corrupt credit state. If we
+ * cannot safely derive an inference URL, return undefined so the bridge stays
+ * disabled.
+ */
+export declare function resolveInferenceWebhookUrl(runtime: IAgentRuntime): string | undefined;
+/**
+ * Map a known `/credits` webhook URL to its sibling `/inference` URL. Returns
+ * undefined when the input does not contain a `/credits` path segment, so we
+ * never accidentally post inference to a non-inference endpoint.
+ */
+export declare function deriveInferenceUrlFromCredits(creditsUrl: string): string | undefined;
+/**
+ * HMAC signature compatible with waifu's webhook receiver:
+ * `sha256=` + HMAC-SHA256 over `${timestamp}.${rawBody}`.
+ */
+export declare function signWaifuWebhook(rawBody: string, timestamp: string, secret: string): string;
+export declare function estimateUsd(config: WaifuMeteringConfig, inputTokens: number, outputTokens: number): number;
+export interface InferenceSpentPayload {
+    agentId: string;
+    modelType: string;
+    modelName?: string;
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    usd: number;
+    costSource: "gateway" | "estimate";
+    timestamp: string;
+    idempotencyKey: string;
+    source: "elizacloud";
+}
+export declare function buildInferenceSpentPayload(config: WaifuMeteringConfig, event: ModelUsageEventPayload, now?: Date): InferenceSpentPayload | null;
+/**
+ * POST a signed `inference.spent` webhook to waifu. Best-effort: failures are
+ * logged but never thrown, so metering never blocks or breaks an agent reply.
+ * A 10s AbortSignal bounds the request so a stuck receiver can never leave a
+ * background fetch hanging.
+ */
+export declare function postInferenceSpent(config: WaifuMeteringConfig, payload: InferenceSpentPayload, fetchImpl?: typeof fetch): Promise<{
+    ok: boolean;
+    status?: number;
+}>;
+/**
+ * Build the MODEL_USED event handler that forwards inference spend to waifu.
+ * Resolves config lazily per-event so it stays inactive until the metering env
+ * is present, and so config changes (rare) are picked up without a restart.
+ */
+export declare function createWaifuMeteringHandler(fetchImpl?: typeof fetch): (payload: ModelUsageEventPayload) => Promise<void>;
+//# sourceMappingURL=waifu-metering.d.ts.map

package/dist/utils/waifu-metering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waifu-metering.d.ts","sourceRoot":"","sources":["../../src/utils/waifu-metering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAKvD;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAEnD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAuBD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,aAAa,GACrB,mBAAmB,GAAG,IAAI,CAqB5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAerF;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgBpF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,mBAAmB,EAC3B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAKR;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,sBAAsB,EAC7B,GAAG,GAAE,IAAiB,GACrB,qBAAqB,GAAG,IAAI,CAkC9B;AAID;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,qBAAqB,EAC9B,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmC3C;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,GAAE,OAAO,KAAa,GAC9B,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,CAepD"}

package/dist/utils/waifu-metering.js

@@ -0,0 +1,166 @@
+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/utils/waifu-metering.ts
+import crypto from "node:crypto";
+import { logger } from "@elizaos/core";
+var DEFAULT_USD_PER_1K_INPUT = 0.003;
+var DEFAULT_USD_PER_1K_OUTPUT = 0.015;
+var CLOUD_INFERENCE_SOURCE = "elizacloud";
+function readEnv(runtime, key) {
+  const fromSettings = typeof runtime.getSetting === "function" ? runtime.getSetting(key) : undefined;
+  const value = typeof fromSettings === "string" && fromSettings || (typeof process !== "undefined" ? process.env?.[key] : undefined);
+  const trimmed = typeof value === "string" ? value.trim() : "";
+  return trimmed.length > 0 ? trimmed : undefined;
+}
+function readNumberEnv(runtime, key, fallback) {
+  const raw = readEnv(runtime, key);
+  if (!raw)
+    return fallback;
+  const parsed = Number(raw);
+  return Number.isFinite(parsed) && parsed >= 0 ? parsed : fallback;
+}
+function resolveWaifuMeteringConfig(runtime) {
+  const webhookUrl = resolveInferenceWebhookUrl(runtime);
+  const secret = readEnv(runtime, "WAIFU_WEBHOOK_SECRET") ?? readEnv(runtime, "WAIFU_INFERENCE_WEBHOOK_SECRET");
+  const agentId = readEnv(runtime, "WAIFU_AGENT_ID") ?? readEnv(runtime, "WAIFU_CORE_AGENT_ID");
+  if (!webhookUrl || !secret || !agentId) {
+    return null;
+  }
+  return {
+    webhookUrl,
+    secret,
+    agentId,
+    usdPer1kInput: readNumberEnv(runtime, "WAIFU_METER_USD_PER_1K_INPUT", DEFAULT_USD_PER_1K_INPUT),
+    usdPer1kOutput: readNumberEnv(runtime, "WAIFU_METER_USD_PER_1K_OUTPUT", DEFAULT_USD_PER_1K_OUTPUT)
+  };
+}
+function resolveInferenceWebhookUrl(runtime) {
+  const explicit = readEnv(runtime, "WAIFU_INFERENCE_WEBHOOK_URL");
+  if (explicit)
+    return explicit;
+  const creditsUrl = readEnv(runtime, "WAIFU_WEBHOOK_URL");
+  if (!creditsUrl)
+    return;
+  const derived = deriveInferenceUrlFromCredits(creditsUrl);
+  if (derived)
+    return derived;
+  return;
+}
+function deriveInferenceUrlFromCredits(creditsUrl) {
+  try {
+    const url = new URL(creditsUrl);
+    if (!/\/credits\/?$/.test(url.pathname)) {
+      return;
+    }
+    url.pathname = url.pathname.replace(/\/credits(\/?)$/, "/inference$1");
+    return url.toString();
+  } catch {
+    if (/\/credits\/?$/.test(creditsUrl)) {
+      return creditsUrl.replace(/\/credits(\/?)$/, "/inference$1");
+    }
+    return;
+  }
+}
+function signWaifuWebhook(rawBody, timestamp, secret) {
+  return `sha256=${crypto.createHmac("sha256", secret).update(`${timestamp}.${rawBody}`).digest("hex")}`;
+}
+function estimateUsd(config, inputTokens, outputTokens) {
+  const usd = inputTokens / 1000 * config.usdPer1kInput + outputTokens / 1000 * config.usdPer1kOutput;
+  return Number.isFinite(usd) && usd > 0 ? usd : 0;
+}
+function buildInferenceSpentPayload(config, event, now = new Date) {
+  const promptTokens = Math.max(0, Math.round(Number(event.tokens?.prompt ?? 0)));
+  const completionTokens = Math.max(0, Math.round(Number(event.tokens?.completion ?? 0)));
+  const totalTokens = Math.max(0, Math.round(Number(event.tokens?.total ?? promptTokens + completionTokens)));
+  if (totalTokens === 0 && promptTokens === 0 && completionTokens === 0) {
+    return null;
+  }
+  const gatewayCost = typeof event.costUsd === "number" && Number.isFinite(event.costUsd) && event.costUsd >= 0 ? event.costUsd : undefined;
+  const usd = gatewayCost ?? estimateUsd(config, promptTokens, completionTokens);
+  const timestamp = now.toISOString();
+  return {
+    agentId: config.agentId,
+    modelType: String(event.type ?? "unknown"),
+    ...event.modelName ? { modelName: event.modelName } : {},
+    promptTokens,
+    completionTokens,
+    totalTokens,
+    usd,
+    costSource: gatewayCost !== undefined ? "gateway" : "estimate",
+    timestamp,
+    idempotencyKey: `inference:${config.agentId}:${crypto.randomUUID()}`,
+    source: "elizacloud"
+  };
+}
+var POST_TIMEOUT_MS = 1e4;
+async function postInferenceSpent(config, payload, fetchImpl = fetch) {
+  const body = JSON.stringify(payload);
+  const signature = signWaifuWebhook(body, payload.timestamp, config.secret);
+  try {
+    const res = await fetchImpl(config.webhookUrl, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        "X-Waifu-Webhook-Signature": signature
+      },
+      body,
+      signal: AbortSignal.timeout(POST_TIMEOUT_MS)
+    });
+    if (!res.ok) {
+      logger.warn(`[waifu-metering] inference.spent POST returned ${res.status} for agent ${config.agentId}`);
+      return { ok: false, status: res.status };
+    }
+    logger.debug(`[waifu-metering] inference.spent posted (agent=${config.agentId} tokens=${payload.totalTokens} usd=${payload.usd.toFixed(6)} src=${payload.costSource})`);
+    return { ok: true, status: res.status };
+  } catch (err) {
+    const aborted = err instanceof Error && err.name === "TimeoutError";
+    const detail = aborted ? `timed out after ${POST_TIMEOUT_MS}ms` : err instanceof Error ? err.message : String(err);
+    logger.warn(`[waifu-metering] inference.spent POST failed for agent ${config.agentId}: ${detail}`);
+    return { ok: false };
+  }
+}
+function createWaifuMeteringHandler(fetchImpl = fetch) {
+  return async (payload) => {
+    const runtime = payload?.runtime;
+    if (!runtime)
+      return;
+    if (payload?.source !== CLOUD_INFERENCE_SOURCE)
+      return;
+    const config = resolveWaifuMeteringConfig(runtime);
+    if (!config)
+      return;
+    const spent = buildInferenceSpentPayload(config, payload);
+    if (!spent)
+      return;
+    await postInferenceSpent(config, spent, fetchImpl);
+  };
+}
+export {
+  signWaifuWebhook,
+  resolveWaifuMeteringConfig,
+  resolveInferenceWebhookUrl,
+  postInferenceSpent,
+  estimateUsd,
+  deriveInferenceUrlFromCredits,
+  createWaifuMeteringHandler,
+  buildInferenceSpentPayload,
+  CLOUD_INFERENCE_SOURCE
+};
+
+//# debugId=17310B83242297D764756E2164756E21

package/dist/utils/waifu-metering.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/utils/waifu-metering.ts"],
+  "sourcesContent": [
+    "/**\n * Waifu metering bridge.\n *\n * A hosted waifu agent runs as a sandboxed container whose model inference is\n * routed through the Eliza Cloud metered inference gateway. The gateway is the\n * honest meter: it owns the per-model pricing table and the platform markup,\n * and it debits the organization's credit balance on every call. That debit is\n * authoritative and already happens server-side.\n *\n * What was missing is the *signal back to waifu*: waifu's burn rollup\n * (`apps/worker/src/processors/agent-rollup.ts`) reads `inference.spent`\n * agent_events to compute `agentDailyBurnUsd` / `agentRunwayDays`, but falls\n * back to a $5/day default estimate when no such events exist. Nothing emitted them.\n *\n * This bridge listens for the runtime `MODEL_USED` event (emitted by the cloud\n * model handlers after each inference) and POSTs a signed `inference.spent`\n * webhook to waifu's receiver (`POST /webhooks/eliza-cloud/inference`). It is\n * inactive unless the container is provisioned with the waifu metering env knobs,\n * so it never fires for non-hosted (local dev / standalone) agents.\n *\n * Token counts are exact (reported by the gateway). USD is the authoritative\n * post-markup cost when the gateway surfaces it (`usage.cost_usd` /\n * `X-Eliza-Cost-Usd`); otherwise a conservative token-based estimate is used,\n * configurable per-model via WAIFU_METER_USD_PER_1K_INPUT / _OUTPUT. The credit\n * debit itself is always the cloud's authoritative number; the estimate only\n * affects waifu's burn display until the cloud cost is wired through.\n */\n\nimport crypto from \"node:crypto\";\nimport { type IAgentRuntime, logger } from \"@elizaos/core\";\nimport type { ModelUsageEventPayload } from \"./events\";\n\nconst DEFAULT_USD_PER_1K_INPUT = 0.003;\nconst DEFAULT_USD_PER_1K_OUTPUT = 0.015;\n\n/**\n * The MODEL_USED event `source` set by the Eliza Cloud metered inference path\n * (see ./events.ts emitModelUsageEvent). ElizaOS event dispatch is global: every\n * MODEL_USED handler receives every MODEL_USED event regardless of which plugin\n * emitted it. Only inference that actually went through the cloud metered\n * gateway debits real credits, so we must meter only those events. Other model\n * providers (e.g. plugin-local-inference emits source \"local-ai\" for free CPU\n * inference, plugin-openrouter emits \"openrouter\", etc.) must never be metered\n * as cloud burn.\n */\nexport const CLOUD_INFERENCE_SOURCE = \"elizacloud\";\n\nexport interface WaifuMeteringConfig {\n  webhookUrl: string;\n  secret: string;\n  agentId: string;\n  usdPer1kInput: number;\n  usdPer1kOutput: number;\n}\n\nfunction readEnv(runtime: IAgentRuntime, key: string): string | undefined {\n  const fromSettings =\n    typeof runtime.getSetting === \"function\" ? runtime.getSetting(key) : undefined;\n  const value =\n    (typeof fromSettings === \"string\" && fromSettings) ||\n    (typeof process !== \"undefined\" ? process.env?.[key] : undefined);\n  const trimmed = typeof value === \"string\" ? value.trim() : \"\";\n  return trimmed.length > 0 ? trimmed : undefined;\n}\n\nfunction readNumberEnv(\n  runtime: IAgentRuntime,\n  key: string,\n  fallback: number\n): number {\n  const raw = readEnv(runtime, key);\n  if (!raw) return fallback;\n  const parsed = Number(raw);\n  return Number.isFinite(parsed) && parsed >= 0 ? parsed : fallback;\n}\n\n/**\n * Resolve the metering config from the container environment. Returns null\n * (bridge disabled) when the required knobs are absent, which is the case for\n * any agent that is not a hosted waifu agent.\n */\nexport function resolveWaifuMeteringConfig(\n  runtime: IAgentRuntime\n): WaifuMeteringConfig | null {\n  const webhookUrl = resolveInferenceWebhookUrl(runtime);\n  const secret =\n    readEnv(runtime, \"WAIFU_WEBHOOK_SECRET\") ?? readEnv(runtime, \"WAIFU_INFERENCE_WEBHOOK_SECRET\");\n  const agentId = readEnv(runtime, \"WAIFU_AGENT_ID\") ?? readEnv(runtime, \"WAIFU_CORE_AGENT_ID\");\n\n  if (!webhookUrl || !secret || !agentId) {\n    return null;\n  }\n\n  return {\n    webhookUrl,\n    secret,\n    agentId,\n    usdPer1kInput: readNumberEnv(runtime, \"WAIFU_METER_USD_PER_1K_INPUT\", DEFAULT_USD_PER_1K_INPUT),\n    usdPer1kOutput: readNumberEnv(\n      runtime,\n      \"WAIFU_METER_USD_PER_1K_OUTPUT\",\n      DEFAULT_USD_PER_1K_OUTPUT\n    ),\n  };\n}\n\n/**\n * Resolve the inference webhook URL from the container environment.\n *\n * Prefers the explicit WAIFU_INFERENCE_WEBHOOK_URL. If that is absent but a\n * credits webhook URL (WAIFU_WEBHOOK_URL) is present, derive the sibling\n * `/inference` receiver path from the known `/credits` path. We NEVER post\n * inference events to the credits receiver: the credits mapper defaults unknown\n * payloads to `credits.topped_up`, which would corrupt credit state. If we\n * cannot safely derive an inference URL, return undefined so the bridge stays\n * disabled.\n */\nexport function resolveInferenceWebhookUrl(runtime: IAgentRuntime): string | undefined {\n  const explicit = readEnv(runtime, \"WAIFU_INFERENCE_WEBHOOK_URL\");\n  if (explicit) return explicit;\n\n  const creditsUrl = readEnv(runtime, \"WAIFU_WEBHOOK_URL\");\n  if (!creditsUrl) return undefined;\n\n  // Only derive when the credits URL ends in a recognizable `/credits` segment.\n  // Replacing the trailing `/credits` with `/inference` keeps the same host,\n  // base path, and query string. Anything we cannot confidently map is treated\n  // as unsafe and skipped, never reused as-is for inference.\n  const derived = deriveInferenceUrlFromCredits(creditsUrl);\n  if (derived) return derived;\n\n  return undefined;\n}\n\n/**\n * Map a known `/credits` webhook URL to its sibling `/inference` URL. Returns\n * undefined when the input does not contain a `/credits` path segment, so we\n * never accidentally post inference to a non-inference endpoint.\n */\nexport function deriveInferenceUrlFromCredits(creditsUrl: string): string | undefined {\n  try {\n    const url = new URL(creditsUrl);\n    if (!/\\/credits\\/?$/.test(url.pathname)) {\n      return undefined;\n    }\n    url.pathname = url.pathname.replace(/\\/credits(\\/?)$/, \"/inference$1\");\n    return url.toString();\n  } catch {\n    // Fall back to a string replacement for non-absolute URLs, still requiring\n    // an explicit `/credits` segment so we cannot mis-route.\n    if (/\\/credits\\/?$/.test(creditsUrl)) {\n      return creditsUrl.replace(/\\/credits(\\/?)$/, \"/inference$1\");\n    }\n    return undefined;\n  }\n}\n\n/**\n * HMAC signature compatible with waifu's webhook receiver:\n * `sha256=` + HMAC-SHA256 over `${timestamp}.${rawBody}`.\n */\nexport function signWaifuWebhook(rawBody: string, timestamp: string, secret: string): string {\n  return `sha256=${crypto.createHmac(\"sha256\", secret).update(`${timestamp}.${rawBody}`).digest(\"hex\")}`;\n}\n\nexport function estimateUsd(\n  config: WaifuMeteringConfig,\n  inputTokens: number,\n  outputTokens: number\n): number {\n  const usd =\n    (inputTokens / 1000) * config.usdPer1kInput +\n    (outputTokens / 1000) * config.usdPer1kOutput;\n  return Number.isFinite(usd) && usd > 0 ? usd : 0;\n}\n\nexport interface InferenceSpentPayload {\n  agentId: string;\n  modelType: string;\n  modelName?: string;\n  promptTokens: number;\n  completionTokens: number;\n  totalTokens: number;\n  usd: number;\n  costSource: \"gateway\" | \"estimate\";\n  timestamp: string;\n  idempotencyKey: string;\n  source: \"elizacloud\";\n}\n\nexport function buildInferenceSpentPayload(\n  config: WaifuMeteringConfig,\n  event: ModelUsageEventPayload,\n  now: Date = new Date()\n): InferenceSpentPayload | null {\n  const promptTokens = Math.max(0, Math.round(Number(event.tokens?.prompt ?? 0)));\n  const completionTokens = Math.max(0, Math.round(Number(event.tokens?.completion ?? 0)));\n  const totalTokens = Math.max(\n    0,\n    Math.round(Number(event.tokens?.total ?? promptTokens + completionTokens))\n  );\n\n  // Nothing was actually spent (e.g. a cached/short-circuited call with no\n  // tokens). Skip so we never inflate the burn with empty events.\n  if (totalTokens === 0 && promptTokens === 0 && completionTokens === 0) {\n    return null;\n  }\n\n  const gatewayCost =\n    typeof event.costUsd === \"number\" && Number.isFinite(event.costUsd) && event.costUsd >= 0\n      ? event.costUsd\n      : undefined;\n  const usd = gatewayCost ?? estimateUsd(config, promptTokens, completionTokens);\n\n  const timestamp = now.toISOString();\n  return {\n    agentId: config.agentId,\n    modelType: String(event.type ?? \"unknown\"),\n    ...(event.modelName ? { modelName: event.modelName } : {}),\n    promptTokens,\n    completionTokens,\n    totalTokens,\n    usd,\n    costSource: gatewayCost !== undefined ? \"gateway\" : \"estimate\",\n    timestamp,\n    idempotencyKey: `inference:${config.agentId}:${crypto.randomUUID()}`,\n    source: \"elizacloud\",\n  };\n}\n\nconst POST_TIMEOUT_MS = 10000;\n\n/**\n * POST a signed `inference.spent` webhook to waifu. Best-effort: failures are\n * logged but never thrown, so metering never blocks or breaks an agent reply.\n * A 10s AbortSignal bounds the request so a stuck receiver can never leave a\n * background fetch hanging.\n */\nexport async function postInferenceSpent(\n  config: WaifuMeteringConfig,\n  payload: InferenceSpentPayload,\n  fetchImpl: typeof fetch = fetch\n): Promise<{ ok: boolean; status?: number }> {\n  const body = JSON.stringify(payload);\n  const signature = signWaifuWebhook(body, payload.timestamp, config.secret);\n  try {\n    const res = await fetchImpl(config.webhookUrl, {\n      method: \"POST\",\n      headers: {\n        \"content-type\": \"application/json\",\n        \"X-Waifu-Webhook-Signature\": signature,\n      },\n      body,\n      signal: AbortSignal.timeout(POST_TIMEOUT_MS),\n    });\n    if (!res.ok) {\n      logger.warn(\n        `[waifu-metering] inference.spent POST returned ${res.status} for agent ${config.agentId}`\n      );\n      return { ok: false, status: res.status };\n    }\n    logger.debug(\n      `[waifu-metering] inference.spent posted (agent=${config.agentId} tokens=${payload.totalTokens} usd=${payload.usd.toFixed(6)} src=${payload.costSource})`\n    );\n    return { ok: true, status: res.status };\n  } catch (err) {\n    const aborted = err instanceof Error && err.name === \"TimeoutError\";\n    const detail = aborted\n      ? `timed out after ${POST_TIMEOUT_MS}ms`\n      : err instanceof Error\n        ? err.message\n        : String(err);\n    logger.warn(\n      `[waifu-metering] inference.spent POST failed for agent ${config.agentId}: ${detail}`\n    );\n    return { ok: false };\n  }\n}\n\n/**\n * Build the MODEL_USED event handler that forwards inference spend to waifu.\n * Resolves config lazily per-event so it stays inactive until the metering env\n * is present, and so config changes (rare) are picked up without a restart.\n */\nexport function createWaifuMeteringHandler(\n  fetchImpl: typeof fetch = fetch\n): (payload: ModelUsageEventPayload) => Promise<void> {\n  return async (payload: ModelUsageEventPayload): Promise<void> => {\n    const runtime = payload?.runtime;\n    if (!runtime) return;\n    // ElizaOS dispatches MODEL_USED globally to every registered handler, so we\n    // also receive events from other model providers (local-ai, openrouter,\n    // etc.). Only cloud-metered inference debits real credits; meter only that\n    // source so we never bill free/local inference as cloud burn.\n    if (payload?.source !== CLOUD_INFERENCE_SOURCE) return;\n    const config = resolveWaifuMeteringConfig(runtime);\n    if (!config) return;\n    const spent = buildInferenceSpentPayload(config, payload);\n    if (!spent) return;\n    await postInferenceSpent(config, spent, fetchImpl);\n  };\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "17310B83242297D764756E2164756E21",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-elizacloud",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.11-beta.7",
   "type": "module",
   "main": "dist/node/index.node.js",
   "module": "dist/node/index.node.js",
@@ -15,6 +15,11 @@
     "./package.json": "./package.json",
     ".": {
       "types": "./dist/node/index.d.ts",
+      "eliza-source": {
+        "types": "./src/index.node.ts",
+        "import": "./src/index.node.ts",
+        "default": "./src/index.node.ts"
+      },
       "browser": {
         "types": "./dist/browser/index.d.ts",
         "import": "./dist/browser/index.browser.js",
@@ -26,6 +31,17 @@
         "default": "./dist/node/index.node.js"
       },
       "default": "./dist/node/index.node.js"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
     }
   },
   "files": [
@@ -48,18 +64,31 @@
     }
   },
   "dependencies": {
+    "@ai-sdk/gateway": "3.0.133",
     "@ai-sdk/openai": "^3.0.9",
-    "@elizaos/cloud-sdk": "2.0.0-beta.1",
-    "@elizaos/core": "2.0.0-beta.1",
+    "@ai-sdk/provider": "3.0.10",
+    "@ai-sdk/provider-utils": "4.0.26",
+    "@elizaos/cloud-sdk": "2.0.11-beta.7",
+    "@elizaos/core": "2.0.11-beta.7",
+    "@elizaos/shared": "2.0.11-beta.7",
+    "@noble/curves": "2.2.0",
+    "@noble/hashes": "1.8.0",
+    "@opentelemetry/api": "1.9.1",
+    "@scure/bip32": "1.7.0",
+    "@scure/bip39": "1.6.0",
+    "abitype": "1.2.3",
     "ai": "^6.0.30",
+    "isows": "1.0.7",
     "jose": "^6.2.2",
     "js-tiktoken": "^1.0.21",
-    "undici": "8.2.0",
-    "viem": "^2.48.8"
+    "ox": "0.14.20",
+    "undici": "8.5.0",
+    "viem": "^2.48.8",
+    "ws": "8.21.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.14",
-    "@clack/prompts": "^0.11.0",
+    "@clack/prompts": "^1.5.1",
     "@types/bun": "^1.3.5",
     "@types/node": "^25.0.3",
     "typescript": "^6.0.3",
@@ -70,7 +99,7 @@
   },
   "scripts": {
     "dev": "bun run build.ts --watch",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "typecheck": "tsgo --noEmit -p tsconfig.json",
     "lint": "bunx @biomejs/biome check --write --unsafe .",
     "clean": "rm -rf dist .turbo .turbo-tsconfig.json tsconfig.tsbuildinfo",
     "format": "bunx @biomejs/biome format --write .",
@@ -105,72 +134,72 @@
       },
       "ELIZAOS_CLOUD_NANO_MODEL": {
         "type": "string",
-        "description": "Nano/cheapest text model for lightweight routing and should-respond tasks (overrides NANO_MODEL). Default: openai/gpt-oss-120b:nitro",
+        "description": "Nano/cheapest text model for lightweight routing and should-respond tasks (overrides NANO_MODEL). Default: gpt-oss-120b",
         "required": false,
-        "default": "openai/gpt-oss-120b:nitro",
+        "default": "gpt-oss-120b",
         "sensitive": false
       },
       "NANO_MODEL": {
         "type": "string",
         "description": "Fallback identifier for the nano language model if ELIZAOS_CLOUD_NANO_MODEL is not set.",
         "required": false,
-        "default": "openai/gpt-oss-120b:nitro",
+        "default": "gpt-oss-120b",
         "sensitive": false
       },
       "ELIZAOS_CLOUD_SMALL_MODEL": {
         "type": "string",
-        "description": "Small/fast model for quick tasks (overrides SMALL_MODEL). Default: openai/gpt-oss-120b:nitro",
+        "description": "Small/fast model for quick tasks (overrides SMALL_MODEL). Default: gpt-oss-120b",
         "required": false,
-        "default": "openai/gpt-oss-120b:nitro",
+        "default": "gpt-oss-120b",
         "sensitive": false
       },
       "SMALL_MODEL": {
         "type": "string",
         "description": "Fallback identifier for the small language model if ELIZAOS_CLOUD_SMALL_MODEL is not set.",
         "required": false,
-        "default": "openai/gpt-oss-120b:nitro",
+        "default": "gpt-oss-120b",
         "sensitive": false
       },
       "ELIZAOS_CLOUD_MEDIUM_MODEL": {
         "type": "string",
-        "description": "Medium planning model for multi-step reasoning (overrides MEDIUM_MODEL). Default: openai/gpt-oss-120b:nitro",
+        "description": "Medium planning model for multi-step reasoning (overrides MEDIUM_MODEL). Default: gpt-oss-120b",
         "required": false,
-        "default": "openai/gpt-oss-120b:nitro",
+        "default": "gpt-oss-120b",
         "sensitive": false
       },
       "MEDIUM_MODEL": {
         "type": "string",
         "description": "Fallback identifier for the medium language model if ELIZAOS_CLOUD_MEDIUM_MODEL is not set.",
         "required": false,
-        "default": "openai/gpt-oss-120b:nitro",
+        "default": "gpt-oss-120b",
         "sensitive": false
       },
       "ELIZAOS_CLOUD_LARGE_MODEL": {
         "type": "string",
-        "description": "Large/powerful model for complex tasks (overrides LARGE_MODEL). Default: openai/gpt-oss-120b:nitro",
+        "description": "Large/powerful model for complex tasks (overrides LARGE_MODEL). Default: zai-glm-4.7",
         "required": false,
-        "default": "openai/gpt-oss-120b:nitro",
+        "default": "zai-glm-4.7",
         "sensitive": false
       },
       "LARGE_MODEL": {
         "type": "string",
         "description": "Fallback identifier for the large language model if ELIZAOS_CLOUD_LARGE_MODEL is not set.",
         "required": false,
-        "default": "openai/gpt-oss-120b:nitro",
+        "default": "zai-glm-4.7",
         "sensitive": false
       },
       "ELIZAOS_CLOUD_MEGA_MODEL": {
         "type": "string",
         "description": "Mega/top-tier model for the heaviest generation tasks (overrides MEGA_MODEL). Falls back to the large tier when unset.",
         "required": false,
-        "default": "openai/gpt-oss-120b:nitro",
+        "default": "zai-glm-4.7",
         "sensitive": false
       },
       "MEGA_MODEL": {
         "type": "string",
         "description": "Fallback identifier for the mega language model if ELIZAOS_CLOUD_MEGA_MODEL is not set.",
         "required": false,
-        "default": "openai/gpt-oss-120b:nitro",
+        "default": "zai-glm-4.7",
         "sensitive": false
       },
       "ELIZAOS_CLOUD_RESPONSE_HANDLER_MODEL": {
@@ -292,7 +321,7 @@
       }
     }
   },
-  "gitHead": "646c632924826e2b75c2304a75ee56959fe4a460",
+  "gitHead": "cdbc876f793d96073d7eb0d09715a031ce0cd32e",
   "eliza": {
     "platforms": [
       "browser",

package/src/cloud/auth-service-types.ts

@@ -0,0 +1,24 @@
+import type { Service } from "@elizaos/core";
+
+export interface CloudAuthApiKeyService {
+  isAuthenticated: () => boolean;
+  getApiKey?: () => string | undefined;
+}
+
+export function isCloudAuthApiKeyService(
+  value: Service | null | undefined,
+): value is Service & CloudAuthApiKeyService {
+  return (
+    value !== null &&
+    value !== undefined &&
+    typeof (value as Partial<CloudAuthApiKeyService>).isAuthenticated ===
+      "function"
+  );
+}
+
+export function normalizeCloudApiKey(value: string | null | undefined): string | null {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  if (!trimmed || trimmed.toUpperCase() === "[REDACTED]") return null;
+  return trimmed;
+}

package/src/cloud/base-url.ts

@@ -1,62 +1,6 @@
-const DEFAULT_CLOUD_SITE_URL = "https://www.elizacloud.ai";
-
-const LEGACY_CLOUD_HOST_ALIASES = new Set([
-  "elizacloud.ai",
-  "www.elizacloud.ai",
-]);
-
-function isLoopbackHost(hostname: string): boolean {
-  const normalized = hostname.toLowerCase();
-  return (
-    normalized === "localhost" ||
-    normalized === "::1" ||
-    normalized === "0:0:0:0:0:0:0:1" ||
-    normalized.startsWith("127.")
-  );
-}
-
-function trimApiPath(pathname: string): string {
-  const normalized = pathname.trim().replace(/\/+$/, "");
-  if (!normalized) return "";
-  if (normalized === "/api/v1") return "";
-  if (normalized.endsWith("/api/v1")) {
-    return normalized.slice(0, -"/api/v1".length);
-  }
-  return normalized;
-}
-
-export function normalizeCloudSiteUrl(rawUrl?: string): string {
-  // Allow cloud-provisioned containers to override the base URL via env var
-  const envOverride = process.env.ELIZAOS_CLOUD_BASE_URL?.trim();
-  const candidate = envOverride || rawUrl?.trim() || DEFAULT_CLOUD_SITE_URL;
-
-  try {
-    const parsed = new URL(candidate);
-    const pathname = trimApiPath(parsed.pathname);
-    const host = parsed.hostname.toLowerCase();
-    const preserveLocalOrigin = isLoopbackHost(host);
-
-    parsed.hash = "";
-    parsed.search = "";
-    if (!preserveLocalOrigin) {
-      parsed.protocol = "https:";
-      parsed.port = "";
-    }
-    parsed.pathname = pathname;
-
-    if (LEGACY_CLOUD_HOST_ALIASES.has(host)) {
-      parsed.hostname = "www.elizacloud.ai";
-      parsed.pathname = "";
-    }
-
-    return parsed.toString().replace(/\/{1,1024}$/, "");
-  } catch {
-    const safeCandidate =
-      candidate.length > 8192 ? candidate.slice(0, 8192) : candidate;
-    return safeCandidate.replace(/\/{1,1024}$/, "");
-  }
-}
-
-export function resolveCloudApiBaseUrl(rawUrl?: string): string {
-  return `${normalizeCloudSiteUrl(rawUrl)}/api/v1`;
-}
+/**
+ * Cloud site/API URL normalizer. The implementation moved to
+ * `@elizaos/shared/elizacloud/base-url` so host-layer packages can normalize
+ * URLs without reverse-importing this plugin.
+ */
+export { normalizeCloudSiteUrl, resolveCloudApiBaseUrl } from "@elizaos/shared";