@elizaos/shared 2.0.0-alpha.538 → 2.0.11-beta.7

package/elizacloud/server-cloud-tts.js

@@ -0,0 +1,293 @@
+/**
+ * Cloud TTS helpers — proxy to Eliza Cloud (`elizacloud.ai`).
+ *
+ * Upstream routes (see eliza-cloud-v2): `POST /api/v1/voice/tts` and legacy
+ * `POST /api/elevenlabs/tts`. Both accept `{ text, voiceId?, modelId? }` with
+ * **ElevenLabs** voice and model ids; the cloud runs ElevenLabs server-side.
+ *
+ * Pure / config-driven helpers live here so consumers in app-core and the
+ * agent can resolve cloud TTS configuration without importing the
+ * `@elizaos/plugin-elizacloud` package (reverse-dep boundary). The full
+ * upstream proxy request handler (`handleCloudTtsPreviewRoute`) stays in the
+ * plugin because it ties together the agent runtime route surface.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { getElizaNamespace, resolveStateDir, resolveUserPath, } from "@elizaos/core";
+import { isElizaCloudServiceSelectedInConfig } from "../contracts/cloud-topology.js";
+import { getCloudSecret } from "./cloud-secrets.js";
+function resolveConfigPath(env = process.env, stateDirPath = resolveStateDir(env)) {
+    const override = env.ELIZA_CONFIG_PATH?.trim();
+    if (override)
+        return resolveUserPath(override);
+    const namespace = getElizaNamespace(env);
+    const primaryPath = path.join(stateDirPath, `${namespace}.json`);
+    if (fs.existsSync(primaryPath))
+        return primaryPath;
+    if (namespace !== "eliza") {
+        const legacyPath = path.join(stateDirPath, "eliza.json");
+        if (fs.existsSync(legacyPath))
+            return legacyPath;
+    }
+    return primaryPath;
+}
+function loadElizaConfig() {
+    const raw = fs.readFileSync(resolveConfigPath(), "utf8");
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+        ? parsed
+        : {};
+}
+function normalizeSecretEnvValue(value) {
+    const trimmed = value?.trim();
+    if (!trimmed) {
+        return null;
+    }
+    if (trimmed === "REDACTED" ||
+        trimmed === "[REDACTED]" ||
+        /^\*+$/.test(trimmed)) {
+        return null;
+    }
+    return trimmed;
+}
+function resolveCloudApiKey(env = process.env) {
+    const envKey = normalizeSecretEnvValue(env.ELIZAOS_CLOUD_API_KEY);
+    if (envKey) {
+        return envKey;
+    }
+    try {
+        const config = loadElizaConfig();
+        const configKey = normalizeSecretEnvValue(typeof config.cloud?.apiKey === "string"
+            ? config.cloud.apiKey
+            : undefined);
+        if (configKey) {
+            return configKey;
+        }
+    }
+    catch {
+        // Config is optional; sealed secrets are checked next.
+    }
+    const sealedKey = normalizeSecretEnvValue(getCloudSecret("ELIZAOS_CLOUD_API_KEY"));
+    if (sealedKey) {
+        return sealedKey;
+    }
+    return null;
+}
+let cachedCloudBaseUrlFromConfig;
+let hasResolvedCloudBaseUrlFromConfig = false;
+export function __resetCloudBaseUrlCache() {
+    cachedCloudBaseUrlFromConfig = undefined;
+    hasResolvedCloudBaseUrlFromConfig = false;
+}
+function resolveCloudBaseUrlFromConfig() {
+    if (hasResolvedCloudBaseUrlFromConfig) {
+        return cachedCloudBaseUrlFromConfig ?? null;
+    }
+    try {
+        const config = loadElizaConfig();
+        const raw = typeof config.cloud?.baseUrl === "string"
+            ? config.cloud.baseUrl.trim()
+            : "";
+        cachedCloudBaseUrlFromConfig = raw.length > 0 ? raw : null;
+        hasResolvedCloudBaseUrlFromConfig = true;
+        return cachedCloudBaseUrlFromConfig;
+    }
+    catch {
+        // On failure, remember that we attempted resolution to avoid repeated I/O.
+        cachedCloudBaseUrlFromConfig = null;
+        hasResolvedCloudBaseUrlFromConfig = true;
+        return null;
+    }
+}
+export function resolveElevenLabsApiKeyForCloudMode(env = process.env) {
+    const directKey = normalizeSecretEnvValue(env.ELEVENLABS_API_KEY);
+    if (directKey) {
+        return directKey;
+    }
+    let configWantsCloudTts = false;
+    try {
+        configWantsCloudTts = isElizaCloudServiceSelectedInConfig(loadElizaConfig(), "tts");
+    }
+    catch {
+        configWantsCloudTts = false;
+    }
+    const cloudTtsEnabled = env.ELIZAOS_CLOUD_USE_TTS === "true" ||
+        (env.ELIZAOS_CLOUD_USE_TTS === undefined && configWantsCloudTts);
+    if (!cloudTtsEnabled) {
+        return null;
+    }
+    if (env.ELIZA_CLOUD_TTS_DISABLED === "true") {
+        return null;
+    }
+    return resolveCloudApiKey(env);
+}
+export function ensureCloudTtsApiKeyAlias(env = process.env) {
+    const directKey = normalizeSecretEnvValue(env.ELEVENLABS_API_KEY);
+    if (directKey) {
+        return false;
+    }
+    const cloudBackedKey = resolveElevenLabsApiKeyForCloudMode(env);
+    if (!cloudBackedKey) {
+        return false;
+    }
+    env.ELEVENLABS_API_KEY = cloudBackedKey;
+    return true;
+}
+export function resolveCloudTtsBaseUrl(env = process.env) {
+    const fromEnv = env.ELIZAOS_CLOUD_BASE_URL?.trim() ?? "";
+    const fromConfig = fromEnv.length > 0 ? null : resolveCloudBaseUrlFromConfig();
+    const configured = fromEnv.length > 0 ? fromEnv : (fromConfig?.trim() ?? "");
+    const fallback = "https://www.elizacloud.ai/api/v1";
+    const base = configured.length > 0 ? configured : fallback;
+    try {
+        const parsed = new URL(base);
+        let pathName = parsed.pathname.replace(/\/+$/, "");
+        if (!pathName || pathName === "/") {
+            pathName = "/api/v1";
+        }
+        parsed.pathname = pathName;
+        return parsed.toString().replace(/\/$/, "");
+    }
+    catch {
+        return fallback;
+    }
+}
+export function resolveCloudTtsCandidateUrls(env = process.env) {
+    const base = resolveCloudTtsBaseUrl(env).replace(/\/+$/, "");
+    const candidates = new Set();
+    const addEndpointsForApiV1Base = (baseUrl) => {
+        const trimmed = baseUrl.replace(/\/+$/, "");
+        candidates.add(`${trimmed}/voice/tts`);
+        try {
+            const u = new URL(trimmed);
+            const pathName = u.pathname.replace(/\/+$/, "");
+            if (pathName.endsWith("/api/v1")) {
+                // Preserve the ElevenLabs-shaped compat route; `/audio/speech` would
+                // require OpenAI-style model/voice ids and is intentionally not used.
+                candidates.add(`${u.origin}/api/elevenlabs/tts`);
+            }
+        }
+        catch {
+            // Custom base URL may be a path-like value; the base endpoint is already queued.
+        }
+    };
+    addEndpointsForApiV1Base(base);
+    try {
+        const parsed = new URL(base);
+        if (parsed.hostname.startsWith("www.")) {
+            parsed.hostname = parsed.hostname.slice(4);
+            addEndpointsForApiV1Base(parsed.toString().replace(/\/$/, ""));
+        }
+        else {
+            parsed.hostname = `www.${parsed.hostname}`;
+            addEndpointsForApiV1Base(parsed.toString().replace(/\/$/, ""));
+        }
+    }
+    catch {
+        // The base resolver already validated the default path.
+    }
+    return [...candidates];
+}
+/**
+ * After a non-OK upstream response, only try the next URL for likely-transient /
+ * wrong-route issues. Avoid retrying 401/402/429 etc. so we do not double-charge TTS.
+ */
+export function shouldRetryCloudTtsUpstream(status) {
+    return status === 404 || status === 502 || status === 503;
+}
+/** OpenAI-style names — not valid ElevenLabs `voiceId`; map to default voice. */
+const OPENAI_STYLE_VOICE_ALIASES = new Set([
+    "alloy",
+    "ash",
+    "ballad",
+    "coral",
+    "echo",
+    "nova",
+    "sage",
+    "shimmer",
+    "verse",
+]);
+/** Eliza Cloud default premade voice (matches eliza-cloud-v2 ElevenLabs service). */
+const DEFAULT_ELIZA_CLOUD_TTS_VOICE_ID = "EXAVITQu4vr4xnSDxMaL";
+const DEFAULT_ELIZA_CLOUD_TTS_MODEL_ID = "eleven_flash_v2_5";
+/** Matches `MAX_TEXT_LENGTH` in eliza-cloud-v2 `app/api/v1/voice/tts/route.ts`. */
+export const ELIZA_CLOUD_TTS_MAX_TEXT_CHARS = 5000;
+function isLikelyEdgeOrAzureNeuralVoiceId(raw) {
+    const t = raw.trim();
+    return /^[a-z]{2}-[A-Z]{2}-/i.test(t) && /Neural$/i.test(t);
+}
+function normalizeElizaCloudVoiceId(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return DEFAULT_ELIZA_CLOUD_TTS_VOICE_ID;
+    const lower = trimmed.toLowerCase();
+    if (OPENAI_STYLE_VOICE_ALIASES.has(lower)) {
+        return DEFAULT_ELIZA_CLOUD_TTS_VOICE_ID;
+    }
+    if (isLikelyEdgeOrAzureNeuralVoiceId(trimmed)) {
+        return DEFAULT_ELIZA_CLOUD_TTS_VOICE_ID;
+    }
+    return trimmed;
+}
+export function resolveElizaCloudTtsVoiceId(bodyVoiceId, env = process.env) {
+    if (typeof bodyVoiceId === "string" && bodyVoiceId.trim()) {
+        return normalizeElizaCloudVoiceId(bodyVoiceId);
+    }
+    const envVoice = env.ELIZAOS_CLOUD_TTS_VOICE?.trim() ?? "";
+    if (envVoice) {
+        return normalizeElizaCloudVoiceId(envVoice);
+    }
+    return DEFAULT_ELIZA_CLOUD_TTS_VOICE_ID;
+}
+export function normalizeElizaCloudTtsModelId(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return DEFAULT_ELIZA_CLOUD_TTS_MODEL_ID;
+    const lower = trimmed.toLowerCase();
+    if (OPENAI_STYLE_VOICE_ALIASES.has(lower)) {
+        return DEFAULT_ELIZA_CLOUD_TTS_MODEL_ID;
+    }
+    if (/^gpt-/i.test(trimmed)) {
+        return DEFAULT_ELIZA_CLOUD_TTS_MODEL_ID;
+    }
+    if (/^tts-1/i.test(trimmed)) {
+        return DEFAULT_ELIZA_CLOUD_TTS_MODEL_ID;
+    }
+    if (/mini-tts/i.test(trimmed)) {
+        return DEFAULT_ELIZA_CLOUD_TTS_MODEL_ID;
+    }
+    return trimmed;
+}
+export function resolveCloudProxyTtsModel(bodyModel, env = process.env) {
+    const envModel = env.ELIZAOS_CLOUD_TTS_MODEL?.trim() ?? "";
+    const raw = typeof bodyModel === "string" && bodyModel.trim() ? bodyModel.trim() : "";
+    const chosen = raw || envModel;
+    if (!chosen)
+        return DEFAULT_ELIZA_CLOUD_TTS_MODEL_ID;
+    return normalizeElizaCloudTtsModelId(chosen);
+}
+export function mirrorCompatHeaders(req) {
+    const HEADER_ALIASES = [
+        ["x-elizaos-token", "x-eliza-token"],
+        ["x-elizaos-export-token", "x-eliza-export-token"],
+        ["x-elizaos-client-id", "x-eliza-client-id"],
+        ["x-elizaos-terminal-token", "x-eliza-terminal-token"],
+        ["x-elizaos-ui-language", "x-eliza-ui-language"],
+        ["x-elizaos-agent-action", "x-eliza-agent-action"],
+    ];
+    for (const [appHeader, elizaHeader] of HEADER_ALIASES) {
+        const appValue = req.headers[appHeader];
+        const elizaValue = req.headers[elizaHeader];
+        if (appValue != null && elizaValue == null) {
+            req.headers[elizaHeader] = appValue;
+        }
+        if (elizaValue != null && appValue == null) {
+            req.headers[appHeader] = elizaValue;
+        }
+    }
+}
+/** Internal: expose the resolved cloud API key for the route handler that lives in plugin-elizacloud. */
+export function _internalResolveCloudApiKey(env = process.env) {
+    return resolveCloudApiKey(env);
+}
+//# sourceMappingURL=server-cloud-tts.js.map

package/elizacloud/server-cloud-tts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-cloud-tts.js","sourceRoot":"","sources":["../../src/elizacloud/server-cloud-tts.ts"],"names":[],"mappings":"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"}

package/email-classification/email-classifier.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Lightweight email classifier used during Gmail ingest. Two-stage:
+ *
+ *   1. Cheap rule pass over headers + sender + subject. Most marketing /
+ *      transactional / billing mail is unambiguous and never needs an LLM.
+ *   2. LLM fallback only when rules are silent or low-confidence. Model is
+ *      configurable via the runtime setting `lifeops.emailClassifier.model`
+ *      (defaults to TEXT_SMALL). If the runtime can't run a model, the rule
+ *      result is returned unchanged.
+ *
+ * The classifier is intentionally fail-soft: any error is logged by the
+ * caller and the message defaults to "personal" so ingest is never blocked.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+export type EmailCategory = "promotional" | "bill" | "transactional" | "personal";
+export interface EmailClassification {
+    category: EmailCategory;
+    confidence: number;
+    signals: string[];
+}
+export interface EmailLikeMessage {
+    /** Stable id used as a cache key. */
+    id?: string | null;
+    externalId?: string | null;
+    subject?: string | null;
+    from?: string | null;
+    fromEmail?: string | null;
+    snippet?: string | null;
+    /** Raw header → value map. Optional but used to detect List-Unsubscribe. */
+    headers?: Record<string, string | undefined> | null;
+    /** Optional pre-parsed plaintext body. snippet is used when body is absent. */
+    bodyText?: string | null;
+    /** Raw Gmail labels — used as a cheap supplementary signal. */
+    labels?: readonly string[] | null;
+}
+export interface ClassifyEmailOptions {
+    /**
+     * Optional set of known-personal addresses (e.g. real contacts). When the
+     * sender matches we short-circuit straight to "personal".
+     */
+    knownContacts?: ReadonlySet<string> | null;
+    /** Override the runtime setting for the LLM model. */
+    modelOverride?: string | null;
+    /** Override classifier-enabled flag (defaults to runtime setting / true). */
+    enabledOverride?: boolean | null;
+}
+export declare function isEmailClassifierEnabled(runtime: IAgentRuntime): boolean;
+export declare function getConfiguredEmailClassifierModel(runtime: IAgentRuntime): string;
+/**
+ * Apply the rule layer. Returns null when no rule matched at all so the
+ * caller can decide whether to invoke the LLM.
+ */
+export declare function classifyEmailByRules(message: EmailLikeMessage, opts?: ClassifyEmailOptions): EmailClassification | null;
+export declare function classifyEmail(runtime: IAgentRuntime, message: EmailLikeMessage, opts?: ClassifyEmailOptions): Promise<EmailClassification>;
+/** Test hook: clear the in-memory cache. */
+export declare function _resetEmailClassifierCache(): void;
+//# sourceMappingURL=email-classifier.d.ts.map

package/email-classification/email-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-classifier.d.ts","sourceRoot":"","sources":["../../src/email-classification/email-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AASnD,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,MAAM,GACN,eAAe,GACf,UAAU,CAAC;AAEf,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;IACpD,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC3C,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAClC;AA8FD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAGxE;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,aAAa,GACrB,MAAM,CAER;AAuCD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EACzB,IAAI,GAAE,oBAAyB,GAC9B,mBAAmB,GAAG,IAAI,CAoF5B;AAmFD,wBAAsB,aAAa,CACjC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,gBAAgB,EACzB,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAoE9B;AAED,4CAA4C;AAC5C,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD"}