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

package/dist/models/research.js

@@ -0,0 +1,341 @@
+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/config.ts
+import { logger } from "@elizaos/core";
+import { DEFAULT_ELIZA_CLOUD_TEXT_MODEL } from "@elizaos/core";
+var DEFAULT_ELIZA_CLOUD_LARGE_MODEL = "zai-glm-4.7";
+function getEnvValue(key) {
+  if (typeof process === "undefined") {
+    return;
+  }
+  const value = process.env[key];
+  return value === undefined ? undefined : String(value);
+}
+function getSetting(runtime, key, defaultValue) {
+  const value = runtime.getSetting(key);
+  if (value !== undefined && value !== null) {
+    return String(value);
+  }
+  return getEnvValue(key) ?? defaultValue;
+}
+function isBrowser() {
+  return typeof globalThis !== "undefined" && typeof globalThis.document !== "undefined";
+}
+function isProxyMode(runtime) {
+  return isBrowser() && !!getSetting(runtime, "ELIZAOS_CLOUD_BROWSER_BASE_URL");
+}
+function getBaseURL(runtime) {
+  const browserURL = getSetting(runtime, "ELIZAOS_CLOUD_BROWSER_BASE_URL");
+  const baseURL = isBrowser() && browserURL ? browserURL : getSetting(runtime, "ELIZAOS_CLOUD_BASE_URL", "https://www.elizacloud.ai/api/v1");
+  return baseURL;
+}
+function getEmbeddingBaseURL(runtime) {
+  const embeddingURL = isBrowser() ? getSetting(runtime, "ELIZAOS_CLOUD_BROWSER_EMBEDDING_URL") || getSetting(runtime, "ELIZAOS_CLOUD_BROWSER_BASE_URL") : getSetting(runtime, "ELIZAOS_CLOUD_EMBEDDING_URL");
+  if (embeddingURL) {
+    logger.debug(`[ELIZAOS_CLOUD] Using specific embedding base URL: ${embeddingURL}`);
+    return embeddingURL;
+  }
+  logger.debug("[ELIZAOS_CLOUD] Falling back to general base URL for embeddings.");
+  return getBaseURL(runtime);
+}
+function getApiKey(runtime) {
+  return getSetting(runtime, "ELIZAOS_CLOUD_API_KEY");
+}
+function getEmbeddingApiKey(runtime) {
+  const embeddingApiKey = getSetting(runtime, "ELIZAOS_CLOUD_EMBEDDING_API_KEY");
+  if (embeddingApiKey) {
+    logger.debug("[ELIZAOS_CLOUD] Using specific embedding API key (present)");
+    return embeddingApiKey;
+  }
+  logger.debug("[ELIZAOS_CLOUD] Falling back to general API key for embeddings.");
+  return getApiKey(runtime);
+}
+function getSmallModel(runtime) {
+  return getSetting(runtime, "ELIZAOS_CLOUD_SMALL_MODEL") ?? getSetting(runtime, "SMALL_MODEL", DEFAULT_ELIZA_CLOUD_TEXT_MODEL);
+}
+function getNanoModel(runtime) {
+  return getSetting(runtime, "ELIZAOS_CLOUD_NANO_MODEL") ?? getSetting(runtime, "NANO_MODEL") ?? getSmallModel(runtime);
+}
+function getMediumModel(runtime) {
+  return getSetting(runtime, "ELIZAOS_CLOUD_MEDIUM_MODEL") ?? getSetting(runtime, "MEDIUM_MODEL") ?? getSmallModel(runtime);
+}
+function getLargeModel(runtime) {
+  return getSetting(runtime, "ELIZAOS_CLOUD_LARGE_MODEL") ?? getSetting(runtime, "LARGE_MODEL", DEFAULT_ELIZA_CLOUD_LARGE_MODEL);
+}
+function getMegaModel(runtime) {
+  return getSetting(runtime, "ELIZAOS_CLOUD_MEGA_MODEL") ?? getSetting(runtime, "MEGA_MODEL") ?? getLargeModel(runtime);
+}
+function getResponseHandlerModel(runtime) {
+  return getSetting(runtime, "ELIZAOS_CLOUD_RESPONSE_HANDLER_MODEL") ?? getSetting(runtime, "ELIZAOS_CLOUD_SHOULD_RESPOND_MODEL") ?? getSetting(runtime, "RESPONSE_HANDLER_MODEL") ?? getSetting(runtime, "SHOULD_RESPOND_MODEL") ?? getSmallModel(runtime);
+}
+function getActionPlannerModel(runtime) {
+  return getSetting(runtime, "ELIZAOS_CLOUD_ACTION_PLANNER_MODEL") ?? getSetting(runtime, "ELIZAOS_CLOUD_PLANNER_MODEL") ?? getSetting(runtime, "ACTION_PLANNER_MODEL") ?? getSetting(runtime, "PLANNER_MODEL") ?? getLargeModel(runtime);
+}
+function getResponseModel(runtime) {
+  return getSetting(runtime, "ELIZAOS_CLOUD_RESPONSE_MODEL") ?? getSetting(runtime, "RESPONSE_MODEL") ?? getLargeModel(runtime);
+}
+function getImageDescriptionModel(runtime) {
+  return getSetting(runtime, "ELIZAOS_CLOUD_IMAGE_DESCRIPTION_MODEL", "gpt-5.4-mini");
+}
+function getImageGenerationModel(runtime) {
+  return getSetting(runtime, "ELIZAOS_CLOUD_IMAGE_GENERATION_MODEL", "google/gemini-2.5-flash-image") ?? "google/gemini-2.5-flash-image";
+}
+function getResearchModel(runtime) {
+  return getSetting(runtime, "ELIZAOS_CLOUD_RESEARCH_MODEL") ?? getSetting(runtime, "RESEARCH_MODEL", "o3-deep-research");
+}
+function getTTSModel(runtime) {
+  return getSetting(runtime, "ELIZAOS_CLOUD_TTS_MODEL", "gpt-5-mini-tts");
+}
+function getTranscriptionModel(runtime) {
+  return getSetting(runtime, "ELIZAOS_CLOUD_TRANSCRIPTION_MODEL", "gpt-5-mini-transcribe");
+}
+function getExperimentalTelemetry(runtime) {
+  const setting = getSetting(runtime, "ELIZAOS_CLOUD_EXPERIMENTAL_TELEMETRY", "false");
+  return String(setting).toLowerCase() === "true";
+}
+function resolveCloudTimeoutMs(envKey, defaultMs) {
+  const raw = typeof process !== "undefined" ? process.env[envKey] : undefined;
+  if (raw === undefined || raw.trim() === "")
+    return defaultMs;
+  const parsed = Number.parseInt(raw, 10);
+  if (!Number.isFinite(parsed))
+    return defaultMs;
+  return parsed <= 0 ? undefined : parsed;
+}
+
+// src/utils/sdk-client.ts
+import { ElizaCloudClient } from "@elizaos/cloud-sdk";
+function trimTrailingSlash(value) {
+  return value.replace(/\/+$/, "");
+}
+function apiBaseToSiteBaseUrl(apiBaseUrl) {
+  const trimmed = trimTrailingSlash(apiBaseUrl);
+  return trimmed.endsWith("/api/v1") ? trimmed.slice(0, -"/api/v1".length) : trimmed;
+}
+function apiKeyForRuntime(runtime, embedding = false) {
+  if (isBrowser())
+    return;
+  return embedding ? getEmbeddingApiKey(runtime) : getApiKey(runtime);
+}
+function createCloudApiClient(runtime, embedding = false) {
+  const baseUrl = embedding ? getEmbeddingBaseURL(runtime) : getBaseURL(runtime);
+  return new ElizaCloudClient({
+    apiBaseUrl: trimTrailingSlash(baseUrl),
+    baseUrl: apiBaseToSiteBaseUrl(baseUrl),
+    apiKey: apiKeyForRuntime(runtime, embedding)
+  }).v1;
+}
+function createElizaCloudClient(runtime) {
+  const apiBaseUrl = trimTrailingSlash(getBaseURL(runtime));
+  return new ElizaCloudClient({
+    apiBaseUrl,
+    baseUrl: apiBaseToSiteBaseUrl(apiBaseUrl),
+    apiKey: apiKeyForRuntime(runtime)
+  });
+}
+
+// src/utils/events.ts
+import {
+  EventType
+} from "@elizaos/core";
+function emitModelUsageEvent(runtime, type, _prompt, usage, meta = {}) {
+  const inputTokens = Number(usage.inputTokens || 0);
+  const outputTokens = Number(usage.outputTokens || 0);
+  const totalTokens = Number(usage.totalTokens != null ? usage.totalTokens : inputTokens + outputTokens);
+  const payload = {
+    runtime,
+    source: "elizacloud",
+    type,
+    tokens: {
+      prompt: inputTokens,
+      completion: outputTokens,
+      total: totalTokens
+    },
+    ...meta.modelName ? { modelName: meta.modelName } : {},
+    ...typeof meta.costUsd === "number" && Number.isFinite(meta.costUsd) ? { costUsd: meta.costUsd } : {}
+  };
+  runtime.emitEvent(EventType.MODEL_USED, payload);
+}
+
+// src/models/research.ts
+import { logger as logger2, ModelType } from "@elizaos/core";
+var DEFAULT_RESEARCH_TIMEOUT_MS = 600000;
+function normalizeInput(input) {
+  if (typeof input !== "string") {
+    return input;
+  }
+  return [
+    {
+      role: "user",
+      content: [
+        {
+          type: "input_text",
+          text: input
+        }
+      ]
+    }
+  ];
+}
+function buildResearchApiError(status, errorText) {
+  try {
+    const parsed = JSON.parse(errorText);
+    const message = parsed.error?.message;
+    const param = parsed.error?.param;
+    if (param === "tools.0.type" && message?.includes('expected "function"')) {
+      return new Error(`Research API error: ${status} Eliza Cloud /responses rejected deep-research tool types; the provider currently only accepts function tools on this route`);
+    }
+  } catch {}
+  return new Error(`Research API error: ${status} ${errorText}`);
+}
+function parseAnnotations(raw) {
+  return raw.filter((a) => a.url !== undefined).map((a) => ({
+    url: a.url,
+    title: a.title ?? "",
+    startIndex: a.start_index ?? 0,
+    endIndex: a.end_index ?? 0
+  }));
+}
+function parseOutputItems(raw) {
+  const items = [];
+  for (const item of raw) {
+    switch (item.type) {
+      case "web_search_call":
+        items.push({
+          id: item.id ?? "",
+          type: "web_search_call",
+          status: item.status ?? "completed",
+          action: {
+            type: item.action?.type ?? "search",
+            query: item.action?.query,
+            url: item.action?.url
+          }
+        });
+        break;
+      case "file_search_call":
+        items.push({
+          id: item.id ?? "",
+          type: "file_search_call",
+          status: item.status ?? "completed",
+          query: item.query ?? "",
+          results: item.results?.map((r) => ({
+            fileId: r.file_id,
+            fileName: r.file_name,
+            score: r.score
+          }))
+        });
+        break;
+      case "code_interpreter_call":
+        items.push({
+          id: item.id ?? "",
+          type: "code_interpreter_call",
+          status: item.status ?? "completed",
+          code: item.code ?? "",
+          output: item.output
+        });
+        break;
+      case "mcp_tool_call":
+        items.push({
+          id: item.id ?? "",
+          type: "mcp_tool_call",
+          status: item.status ?? "completed",
+          serverLabel: item.server_label ?? "",
+          toolName: item.tool_name ?? "",
+          arguments: item.arguments ?? {},
+          result: item.result
+        });
+        break;
+      case "message": {
+        const content = item.content ?? [];
+        items.push({
+          type: "message",
+          content: content.filter((c) => c.type === "output_text").map((c) => ({
+            type: "output_text",
+            text: c.text ?? "",
+            annotations: parseAnnotations(c.annotations ?? [])
+          }))
+        });
+        break;
+      }
+    }
+  }
+  return items;
+}
+async function handleResearch(runtime, params) {
+  const modelName = params.model ?? getResearchModel(runtime);
+  logger2.log(`[ELIZAOS_CLOUD] Using RESEARCH model: ${modelName}`);
+  const tools = params.tools ?? [{ type: "web_search_preview" }];
+  const requestBody = {
+    model: modelName,
+    input: normalizeInput(params.input),
+    tools
+  };
+  if (params.instructions) {
+    requestBody.instructions = params.instructions;
+  }
+  if (params.background !== undefined) {
+    requestBody.background = params.background;
+  }
+  if (params.maxToolCalls !== undefined) {
+    requestBody.max_tool_calls = params.maxToolCalls;
+  }
+  if (params.reasoningSummary) {
+    requestBody.reasoning = { summary: params.reasoningSummary };
+  }
+  const response = await createCloudApiClient(runtime).requestRaw("POST", "/responses", {
+    json: requestBody,
+    timeoutMs: resolveCloudTimeoutMs("ELIZAOS_CLOUD_RESEARCH_TIMEOUT_MS", DEFAULT_RESEARCH_TIMEOUT_MS)
+  });
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw buildResearchApiError(response.status, errorText);
+  }
+  const data = await response.json();
+  if (data.usage) {
+    emitModelUsageEvent(runtime, ModelType.RESEARCH, params.input, {
+      inputTokens: data.usage.input_tokens,
+      outputTokens: data.usage.output_tokens,
+      totalTokens: data.usage.total_tokens
+    });
+  }
+  const outputItems = parseOutputItems(data.output);
+  let text = "";
+  const annotations = [];
+  for (const item of outputItems) {
+    if (item.type === "message") {
+      for (const content of item.content) {
+        if (content.type === "output_text") {
+          text += content.text;
+          annotations.push(...content.annotations);
+        }
+      }
+    }
+  }
+  return {
+    id: data.id,
+    text,
+    annotations,
+    outputItems,
+    status: data.status
+  };
+}
+export {
+  handleResearch
+};
+
+//# debugId=9CB55D8877604A1C64756E2164756E21

package/dist/models/research.js.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../src/utils/config.ts", "../src/utils/sdk-client.ts", "../src/utils/events.ts", "../src/models/research.ts"],
+  "sourcesContent": [
+    "import type { IAgentRuntime } from \"@elizaos/core\";\nimport { logger } from \"@elizaos/core\";\nimport { DEFAULT_ELIZA_CLOUD_TEXT_MODEL } from \"@elizaos/core\";\n\nexport const DEFAULT_ELIZA_CLOUD_LARGE_MODEL = \"zai-glm-4.7\";\n\nfunction getEnvValue(key: string): string | undefined {\n  if (typeof process === \"undefined\") {\n    return undefined;\n  }\n  const value = process.env[key];\n  return value === undefined ? undefined : String(value);\n}\n\nexport function getSetting(\n  runtime: IAgentRuntime,\n  key: string,\n  defaultValue?: string\n): string | undefined {\n  const value = runtime.getSetting(key);\n  if (value !== undefined && value !== null) {\n    return String(value);\n  }\n  return getEnvValue(key) ?? defaultValue;\n}\n\nexport function isBrowser(): boolean {\n  return (\n    typeof globalThis !== \"undefined\" &&\n    typeof (globalThis as { document?: Document }).document !== \"undefined\"\n  );\n}\n\nexport function isProxyMode(runtime: IAgentRuntime): boolean {\n  return isBrowser() && !!getSetting(runtime, \"ELIZAOS_CLOUD_BROWSER_BASE_URL\");\n}\n\nexport function getBaseURL(runtime: IAgentRuntime): string {\n  const browserURL = getSetting(runtime, \"ELIZAOS_CLOUD_BROWSER_BASE_URL\");\n  const baseURL = (\n    isBrowser() && browserURL\n      ? browserURL\n      : getSetting(runtime, \"ELIZAOS_CLOUD_BASE_URL\", \"https://www.elizacloud.ai/api/v1\")\n  ) as string;\n  return baseURL;\n}\n\nexport function getEmbeddingBaseURL(runtime: IAgentRuntime): string {\n  const embeddingURL = isBrowser()\n    ? getSetting(runtime, \"ELIZAOS_CLOUD_BROWSER_EMBEDDING_URL\") ||\n      getSetting(runtime, \"ELIZAOS_CLOUD_BROWSER_BASE_URL\")\n    : getSetting(runtime, \"ELIZAOS_CLOUD_EMBEDDING_URL\");\n  if (embeddingURL) {\n    logger.debug(`[ELIZAOS_CLOUD] Using specific embedding base URL: ${embeddingURL}`);\n    return embeddingURL;\n  }\n  logger.debug(\"[ELIZAOS_CLOUD] Falling back to general base URL for embeddings.\");\n  return getBaseURL(runtime);\n}\n\nexport function getApiKey(runtime: IAgentRuntime): string | undefined {\n  return getSetting(runtime, \"ELIZAOS_CLOUD_API_KEY\");\n}\n\nexport function getEmbeddingApiKey(runtime: IAgentRuntime): string | undefined {\n  const embeddingApiKey = getSetting(runtime, \"ELIZAOS_CLOUD_EMBEDDING_API_KEY\");\n  if (embeddingApiKey) {\n    logger.debug(\"[ELIZAOS_CLOUD] Using specific embedding API key (present)\");\n    return embeddingApiKey;\n  }\n  logger.debug(\"[ELIZAOS_CLOUD] Falling back to general API key for embeddings.\");\n  return getApiKey(runtime);\n}\n\nexport function getSmallModel(runtime: IAgentRuntime): string {\n  return (\n    getSetting(runtime, \"ELIZAOS_CLOUD_SMALL_MODEL\") ??\n    (getSetting(runtime, \"SMALL_MODEL\", DEFAULT_ELIZA_CLOUD_TEXT_MODEL) as string)\n  );\n}\n\nexport function getNanoModel(runtime: IAgentRuntime): string {\n  return (\n    getSetting(runtime, \"ELIZAOS_CLOUD_NANO_MODEL\") ??\n    getSetting(runtime, \"NANO_MODEL\") ??\n    getSmallModel(runtime)\n  );\n}\n\nexport function getMediumModel(runtime: IAgentRuntime): string {\n  return (\n    getSetting(runtime, \"ELIZAOS_CLOUD_MEDIUM_MODEL\") ??\n    getSetting(runtime, \"MEDIUM_MODEL\") ??\n    getSmallModel(runtime)\n  );\n}\n\nexport function getLargeModel(runtime: IAgentRuntime): string {\n  return (\n    getSetting(runtime, \"ELIZAOS_CLOUD_LARGE_MODEL\") ??\n    (getSetting(runtime, \"LARGE_MODEL\", DEFAULT_ELIZA_CLOUD_LARGE_MODEL) as string)\n  );\n}\n\nexport function getMegaModel(runtime: IAgentRuntime): string {\n  return (\n    getSetting(runtime, \"ELIZAOS_CLOUD_MEGA_MODEL\") ??\n    getSetting(runtime, \"MEGA_MODEL\") ??\n    getLargeModel(runtime)\n  );\n}\n\nexport function getResponseHandlerModel(runtime: IAgentRuntime): string {\n  return (\n    getSetting(runtime, \"ELIZAOS_CLOUD_RESPONSE_HANDLER_MODEL\") ??\n    getSetting(runtime, \"ELIZAOS_CLOUD_SHOULD_RESPOND_MODEL\") ??\n    getSetting(runtime, \"RESPONSE_HANDLER_MODEL\") ??\n    getSetting(runtime, \"SHOULD_RESPOND_MODEL\") ??\n    getSmallModel(runtime)\n  );\n}\n\nexport function getActionPlannerModel(runtime: IAgentRuntime): string {\n  return (\n    getSetting(runtime, \"ELIZAOS_CLOUD_ACTION_PLANNER_MODEL\") ??\n    getSetting(runtime, \"ELIZAOS_CLOUD_PLANNER_MODEL\") ??\n    getSetting(runtime, \"ACTION_PLANNER_MODEL\") ??\n    getSetting(runtime, \"PLANNER_MODEL\") ??\n    getLargeModel(runtime)\n  );\n}\n\nexport function getResponseModel(runtime: IAgentRuntime): string {\n  return (\n    getSetting(runtime, \"ELIZAOS_CLOUD_RESPONSE_MODEL\") ??\n    getSetting(runtime, \"RESPONSE_MODEL\") ??\n    getLargeModel(runtime)\n  );\n}\n\nexport function getImageDescriptionModel(runtime: IAgentRuntime): string {\n  return getSetting(runtime, \"ELIZAOS_CLOUD_IMAGE_DESCRIPTION_MODEL\", \"gpt-5.4-mini\") as string;\n}\n\nexport function getImageGenerationModel(runtime: IAgentRuntime): string {\n  return (\n    getSetting(runtime, \"ELIZAOS_CLOUD_IMAGE_GENERATION_MODEL\", \"google/gemini-2.5-flash-image\") ??\n    \"google/gemini-2.5-flash-image\"\n  );\n}\n\nexport function getResearchModel(runtime: IAgentRuntime): string {\n  return (\n    getSetting(runtime, \"ELIZAOS_CLOUD_RESEARCH_MODEL\") ??\n    (getSetting(runtime, \"RESEARCH_MODEL\", \"o3-deep-research\") as string)\n  );\n}\n\nexport function getTTSModel(runtime: IAgentRuntime): string {\n  return getSetting(runtime, \"ELIZAOS_CLOUD_TTS_MODEL\", \"gpt-5-mini-tts\") as string;\n}\n\nexport function getTranscriptionModel(runtime: IAgentRuntime): string {\n  return getSetting(\n    runtime,\n    \"ELIZAOS_CLOUD_TRANSCRIPTION_MODEL\",\n    \"gpt-5-mini-transcribe\"\n  ) as string;\n}\n\nexport function getExperimentalTelemetry(runtime: IAgentRuntime): boolean {\n  const setting = getSetting(runtime, \"ELIZAOS_CLOUD_EXPERIMENTAL_TELEMETRY\", \"false\");\n  return String(setting).toLowerCase() === \"true\";\n}\n\n/**\n * Resolve a client-side timeout (ms) for a cloud model round-trip from `envKey`,\n * falling back to `defaultMs`. `0`/negative/non-numeric → undefined (opt out).\n *\n * cloud-sdk applies NO default timeout (a fetch with no signal hangs until the\n * platform default), so turn-blocking calls (TTS/STT in a voice turn, deep\n * research) need an explicit ceiling or a stalled gateway hangs the turn.\n */\nexport function resolveCloudTimeoutMs(\n  envKey: string,\n  defaultMs: number\n): number | undefined {\n  const raw = typeof process !== \"undefined\" ? process.env[envKey] : undefined;\n  if (raw === undefined || raw.trim() === \"\") return defaultMs;\n  const parsed = Number.parseInt(raw, 10);\n  if (!Number.isFinite(parsed)) return defaultMs;\n  return parsed <= 0 ? undefined : parsed;\n}\n",
+    "import { CloudApiClient, ElizaCloudClient } from \"@elizaos/cloud-sdk\";\nimport type { IAgentRuntime } from \"@elizaos/core\";\nimport {\n  getApiKey,\n  getBaseURL,\n  getEmbeddingApiKey,\n  getEmbeddingBaseURL,\n  isBrowser,\n} from \"./config\";\n\nfunction trimTrailingSlash(value: string): string {\n  return value.replace(/\\/+$/, \"\");\n}\n\nfunction apiBaseToSiteBaseUrl(apiBaseUrl: string): string {\n  const trimmed = trimTrailingSlash(apiBaseUrl);\n  return trimmed.endsWith(\"/api/v1\") ? trimmed.slice(0, -\"/api/v1\".length) : trimmed;\n}\n\nfunction apiKeyForRuntime(runtime: IAgentRuntime, embedding = false): string | undefined {\n  if (isBrowser()) return undefined;\n  return embedding ? getEmbeddingApiKey(runtime) : getApiKey(runtime);\n}\n\nexport function createCloudApiClient(runtime: IAgentRuntime, embedding = false): CloudApiClient {\n  const baseUrl = embedding ? getEmbeddingBaseURL(runtime) : getBaseURL(runtime);\n  return new ElizaCloudClient({\n    apiBaseUrl: trimTrailingSlash(baseUrl),\n    baseUrl: apiBaseToSiteBaseUrl(baseUrl),\n    apiKey: apiKeyForRuntime(runtime, embedding),\n  }).v1;\n}\n\nexport function createElizaCloudClient(runtime: IAgentRuntime): ElizaCloudClient {\n  const apiBaseUrl = trimTrailingSlash(getBaseURL(runtime));\n  return new ElizaCloudClient({\n    apiBaseUrl,\n    baseUrl: apiBaseToSiteBaseUrl(apiBaseUrl),\n    apiKey: apiKeyForRuntime(runtime),\n  });\n}\n",
+    "import {\n  EventType,\n  type IAgentRuntime,\n  type ModelEventPayload,\n  type ModelTypeName,\n} from \"@elizaos/core\";\nimport type { LanguageModelUsage } from \"ai\";\n\n/**\n * Extra metadata that rides along with a {@link ModelEventPayload} so that\n * downstream consumers (e.g. the waifu metering bridge) can attribute spend\n * to a concrete model id and, when the cloud surfaces it, the authoritative\n * post-markup USD cost it just debited from the org's credit balance.\n *\n * These are additive fields layered onto the standard payload — the core\n * {@link ModelEventPayload} shape is unchanged for every other listener.\n */\nexport interface ModelUsageEventMeta {\n  /** Resolved provider model id, e.g. \"anthropic/claude-opus-4.7\". */\n  modelName?: string;\n  /**\n   * Authoritative USD cost the metered gateway charged for this call, when\n   * available (e.g. from a `usage.cost_usd` field or `X-Eliza-Cost-Usd`\n   * response header). Undefined when the cloud does not surface it; consumers\n   * then fall back to a token-based estimate.\n   */\n  costUsd?: number;\n}\n\nexport type ModelUsageEventPayload = ModelEventPayload & ModelUsageEventMeta;\n\nexport function emitModelUsageEvent(\n  runtime: IAgentRuntime,\n  type: ModelTypeName,\n  _prompt: string,\n  usage: Partial<LanguageModelUsage> & {\n    inputTokens?: number;\n    outputTokens?: number;\n    totalTokens?: number;\n  },\n  meta: ModelUsageEventMeta = {}\n) {\n  const inputTokens = Number(usage.inputTokens || 0);\n  const outputTokens = Number(usage.outputTokens || 0);\n  const totalTokens = Number(\n    usage.totalTokens != null ? usage.totalTokens : inputTokens + outputTokens\n  );\n\n  const payload: ModelUsageEventPayload = {\n    runtime,\n    source: \"elizacloud\",\n    type,\n    tokens: {\n      prompt: inputTokens,\n      completion: outputTokens,\n      total: totalTokens,\n    },\n    ...(meta.modelName ? { modelName: meta.modelName } : {}),\n    ...(typeof meta.costUsd === \"number\" && Number.isFinite(meta.costUsd)\n      ? { costUsd: meta.costUsd }\n      : {}),\n  };\n\n  runtime.emitEvent(EventType.MODEL_USED, payload);\n}\n",
+    "/** Research model handler — calls /responses for deep-research models. */\n\nimport type {\n  IAgentRuntime,\n  ResearchAnnotation,\n  ResearchOutputItem,\n  ResearchParams,\n  ResearchResult,\n} from \"@elizaos/core\";\nimport { logger, ModelType } from \"@elizaos/core\";\nimport { getResearchModel, resolveCloudTimeoutMs } from \"../utils/config\";\nimport { emitModelUsageEvent } from \"../utils/events\";\nimport { createCloudApiClient } from \"../utils/sdk-client\";\n\n// Deep research is a long-running, TURN-BLOCKING call; without a timeout a\n// stalled gateway hangs the turn forever (cloud-sdk applies no default). The\n// default is deliberately generous (10 min) so a legitimately slow run isn't\n// aborted; `ELIZAOS_CLOUD_RESEARCH_TIMEOUT_MS=0` opts out.\nconst DEFAULT_RESEARCH_TIMEOUT_MS = 600_000;\n\ninterface ResponsesAPIOutput {\n  id: string;\n  status: string;\n  output: Array<{\n    type: string;\n    id?: string;\n    status?: string;\n    content?: Array<{\n      type: string;\n      text?: string;\n      annotations?: Array<{\n        type: string;\n        url?: string;\n        title?: string;\n        start_index?: number;\n        end_index?: number;\n      }>;\n    }>;\n    action?: {\n      type: string;\n      query?: string;\n      url?: string;\n    };\n    query?: string;\n    results?: Array<{\n      file_id: string;\n      file_name: string;\n      score: number;\n    }>;\n    code?: string;\n    output?: string;\n    server_label?: string;\n    tool_name?: string;\n    arguments?: Record<string, unknown>;\n    result?: unknown;\n  }>;\n  usage?: {\n    input_tokens: number;\n    output_tokens: number;\n    total_tokens: number;\n  };\n}\n\ntype ResponsesAPIInput =\n  | string\n  | Array<{\n      role: \"user\" | \"system\" | \"assistant\";\n      content: Array<{\n        type: \"input_text\";\n        text: string;\n      }>;\n    }>;\n\nfunction normalizeInput(input: ResearchParams[\"input\"]): ResponsesAPIInput {\n  if (typeof input !== \"string\") {\n    return input as ResponsesAPIInput;\n  }\n\n  return [\n    {\n      role: \"user\",\n      content: [\n        {\n          type: \"input_text\",\n          text: input,\n        },\n      ],\n    },\n  ];\n}\n\nfunction buildResearchApiError(status: number, errorText: string): Error {\n  try {\n    const parsed = JSON.parse(errorText) as {\n      error?: { message?: string; param?: string; code?: string };\n    };\n    const message = parsed.error?.message;\n    const param = parsed.error?.param;\n    if (param === \"tools.0.type\" && message?.includes('expected \"function\"')) {\n      return new Error(\n        `Research API error: ${status} Eliza Cloud /responses rejected deep-research tool types; the provider currently only accepts function tools on this route`\n      );\n    }\n  } catch {\n    // Fall through to the raw error text.\n  }\n\n  return new Error(`Research API error: ${status} ${errorText}`);\n}\n\nfunction parseAnnotations(\n  raw: Array<{\n    type: string;\n    url?: string;\n    title?: string;\n    start_index?: number;\n    end_index?: number;\n  }>\n): ResearchAnnotation[] {\n  return raw\n    .filter((a) => a.url !== undefined)\n    .map((a) => ({\n      url: a.url as string,\n      title: a.title ?? \"\",\n      startIndex: a.start_index ?? 0,\n      endIndex: a.end_index ?? 0,\n    }));\n}\n\nfunction parseOutputItems(raw: ResponsesAPIOutput[\"output\"]): ResearchOutputItem[] {\n  const items: ResearchOutputItem[] = [];\n\n  for (const item of raw) {\n    switch (item.type) {\n      case \"web_search_call\":\n        items.push({\n          id: item.id ?? \"\",\n          type: \"web_search_call\",\n          status: (item.status as \"completed\" | \"failed\") ?? \"completed\",\n          action: {\n            type: (item.action?.type as \"search\" | \"open_page\" | \"find_in_page\") ?? \"search\",\n            query: item.action?.query,\n            url: item.action?.url,\n          },\n        });\n        break;\n      case \"file_search_call\":\n        items.push({\n          id: item.id ?? \"\",\n          type: \"file_search_call\",\n          status: (item.status as \"completed\" | \"failed\") ?? \"completed\",\n          query: item.query ?? \"\",\n          results: item.results?.map((r) => ({\n            fileId: r.file_id,\n            fileName: r.file_name,\n            score: r.score,\n          })),\n        });\n        break;\n      case \"code_interpreter_call\":\n        items.push({\n          id: item.id ?? \"\",\n          type: \"code_interpreter_call\",\n          status: (item.status as \"completed\" | \"failed\") ?? \"completed\",\n          code: item.code ?? \"\",\n          output: item.output,\n        });\n        break;\n      case \"mcp_tool_call\":\n        items.push({\n          id: item.id ?? \"\",\n          type: \"mcp_tool_call\",\n          status: (item.status as \"completed\" | \"failed\") ?? \"completed\",\n          serverLabel: item.server_label ?? \"\",\n          toolName: item.tool_name ?? \"\",\n          arguments: (item.arguments ?? {}) as Record<string, import(\"@elizaos/core\").JsonValue>,\n          result: item.result as import(\"@elizaos/core\").JsonValue | undefined,\n        });\n        break;\n      case \"message\": {\n        const content = item.content ?? [];\n        items.push({\n          type: \"message\",\n          content: content\n            .filter((c) => c.type === \"output_text\")\n            .map((c) => ({\n              type: \"output_text\" as const,\n              text: c.text ?? \"\",\n              annotations: parseAnnotations(c.annotations ?? []),\n            })),\n        });\n        break;\n      }\n    }\n  }\n\n  return items;\n}\n\nexport async function handleResearch(\n  runtime: IAgentRuntime,\n  params: ResearchParams\n): Promise<ResearchResult> {\n  const modelName = params.model ?? getResearchModel(runtime);\n  logger.log(`[ELIZAOS_CLOUD] Using RESEARCH model: ${modelName}`);\n\n  const tools = params.tools ?? [{ type: \"web_search_preview\" }];\n\n  const requestBody: Record<string, unknown> = {\n    model: modelName,\n    input: normalizeInput(params.input),\n    tools: tools,\n  };\n\n  if (params.instructions) {\n    requestBody.instructions = params.instructions;\n  }\n  if (params.background !== undefined) {\n    requestBody.background = params.background;\n  }\n  if (params.maxToolCalls !== undefined) {\n    requestBody.max_tool_calls = params.maxToolCalls;\n  }\n  if (params.reasoningSummary) {\n    requestBody.reasoning = { summary: params.reasoningSummary };\n  }\n\n  const response = await createCloudApiClient(runtime).requestRaw(\"POST\", \"/responses\", {\n    json: requestBody,\n    timeoutMs: resolveCloudTimeoutMs(\n      \"ELIZAOS_CLOUD_RESEARCH_TIMEOUT_MS\",\n      DEFAULT_RESEARCH_TIMEOUT_MS\n    ),\n  });\n\n  if (!response.ok) {\n    const errorText = await response.text();\n    throw buildResearchApiError(response.status, errorText);\n  }\n\n  const data = (await response.json()) as ResponsesAPIOutput;\n\n  if (data.usage) {\n    emitModelUsageEvent(runtime, ModelType.RESEARCH, params.input, {\n      inputTokens: data.usage.input_tokens,\n      outputTokens: data.usage.output_tokens,\n      totalTokens: data.usage.total_tokens,\n    });\n  }\n\n  const outputItems = parseOutputItems(data.output);\n\n  // Extract final text and annotations from the last message output\n  let text = \"\";\n  const annotations: ResearchAnnotation[] = [];\n\n  for (const item of outputItems) {\n    if (item.type === \"message\") {\n      for (const content of item.content) {\n        if (content.type === \"output_text\") {\n          text += content.text;\n          annotations.push(...content.annotations);\n        }\n      }\n    }\n  }\n\n  return {\n    id: data.id,\n    text,\n    annotations,\n    outputItems,\n    status: data.status as ResearchResult[\"status\"],\n  };\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "9CB55D8877604A1C64756E2164756E21",
+  "names": []
+}

package/dist/models/speech.d.ts

@@ -1,7 +1,65 @@
 import type { Readable } from "node:stream";
-import type { IAgentRuntime } from "@elizaos/core";
+import type { AudioStreamResult, IAgentRuntime } from "@elizaos/core";
 import type { OpenAITextToSpeechParams } from "../types";
-declare function fetchTextToSpeech(runtime: IAgentRuntime, options: OpenAITextToSpeechParams): Promise<ReadableStream<Uint8Array> | Readable>;
-export declare function handleTextToSpeech(runtime: IAgentRuntime, input: string | OpenAITextToSpeechParams): Promise<ReadableStream<Uint8Array> | Readable>;
+/**
+ * Narrow client interface the speech handler actually exercises. Lets tests
+ * substitute a fake without rebuilding the full SDK surface.
+ */
+export interface CloudTtsClient {
+    routes: {
+        postApiV1VoiceTts<T = unknown>(options: {
+            headers?: Record<string, unknown>;
+            json: {
+                text: string;
+                voiceId?: string;
+                modelId?: string;
+            };
+            timeoutMs?: number;
+        }): Promise<T>;
+    };
+}
+type CloudTtsClientFactory = (runtime: IAgentRuntime) => CloudTtsClient;
+/**
+ * Test seam: substitute the SDK client factory used by `handleTextToSpeech`.
+ * Pass `null` to reset to the real `createElizaCloudClient`. Production code
+ * should never call this.
+ */
+export declare function setCloudTtsClientFactoryForTesting(factory: CloudTtsClientFactory | null): void;
+/**
+ * Extended TTS params accepted by the cloud handler.
+ *
+ * The runtime canonical type (`TextToSpeechParams`) only carries `text`, but
+ * the cloud TTS upstream maps to ElevenLabs and therefore accepts arbitrary
+ * ElevenLabs `voiceId` + `modelId`. We accept those via either OpenAI-style
+ * (`voice`, `model`) or ElevenLabs-style (`voiceId`, `modelId`) fields and
+ * normalize them to the upstream shape.
+ */
+export interface CloudTextToSpeechParams extends OpenAITextToSpeechParams {
+    voiceId?: string;
+    modelId?: string;
+}
+/**
+ * Marker error used so the runtime can fall through to the next TTS handler
+ * (e.g. local omnivoice) when Eliza Cloud is not connected.
+ */
+export declare class CloudTtsUnavailableError extends Error {
+    constructor(message?: string);
+}
+declare function fetchTextToSpeech(runtime: IAgentRuntime, options: CloudTextToSpeechParams): Promise<ReadableStream<Uint8Array> | Readable>;
+/**
+ * TEXT_TO_SPEECH handler for plugin-elizacloud.
+ *
+ * Behavior:
+ *   - When Eliza Cloud is **not** connected, throws `CloudTtsUnavailableError`
+ *     so the runtime's model-handler fallback chain can pick the next
+ *     provider (e.g. local omnivoice, ElevenLabs direct, etc.).
+ *   - When connected, forwards `text`, `voiceId`, and `modelId` to the
+ *     upstream cloud TTS proxy and returns the audio stream.
+ *
+ * Accepts both OpenAI-style (`voice` / `model`) and ElevenLabs-style
+ * (`voiceId` / `modelId`) input fields. ElevenLabs-style wins when both are
+ * present.
+ */
+export declare function handleTextToSpeech(runtime: IAgentRuntime, input: string | CloudTextToSpeechParams | OpenAITextToSpeechParams): Promise<Uint8Array | AudioStreamResult>;
 export { fetchTextToSpeech };
 //# sourceMappingURL=speech.d.ts.map

package/dist/models/speech.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"speech.d.ts","sourceRoot":"","sources":["../../models/speech.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAIzD,iBAAe,iBAAiB,CAC9B,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC,CA8ChD;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,MAAM,GAAG,wBAAwB,GACvC,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC,CAehD;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"speech.d.ts","sourceRoot":"","sources":["../../src/models/speech.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAKzD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE;QACN,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE;YACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAClC,IAAI,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;YAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;KAChB,CAAC;CACH;AAED,KAAK,qBAAqB,GAAG,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;AAKxE;;;;GAIG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,qBAAqB,GAAG,IAAI,GACpC,IAAI,CAON;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,SAAiC;CAIrD;AAyDD,iBAAe,iBAAiB,CAC9B,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC,CAoChD;AA4GD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,MAAM,GAAG,uBAAuB,GAAG,wBAAwB,GACjE,OAAO,CAAC,UAAU,GAAG,iBAAiB,CAAC,CAkCzC;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}