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

package/dist/lib/credential-type-map.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Mapping from workflow-plugin credential type names → Eliza Cloud connector slugs.
+ *
+ * The workflow plugin's LLM emits credential type strings (e.g. `gmailOAuth2`,
+ * `slackOAuth2Api`) on each node that needs an external account. The cloud
+ * exposes per-connector OAuth flows under `/api/v1/eliza/<connector>/...`.
+ *
+ * This map is the single source of truth for which workflow credential type
+ * resolves through which cloud connector + with which OAuth scopes. Add new
+ * entries when the cloud gains support for additional connectors; do not
+ * scatter cred-type → connector logic elsewhere.
+ *
+ * Cloud-side endpoint convention (see cloud/apps/api/v1/eliza/<connector>/):
+ *   POST /api/v1/eliza/<connector>/connect/initiate     → { authUrl }
+ *   GET  /api/v1/eliza/<connector>/status               → { connected, ... }
+ *
+ * Not every connector below has a fully-implemented cloud endpoint yet — the
+ * provider returns `null` for unmapped types and `needs_auth` (with the
+ * cloud-issued OAuth URL) for mapped-but-not-connected accounts. See
+ * `cloud-credential-provider.ts` for the resolution logic.
+ */
+export interface CredentialTypeMapping {
+    /**
+     * Cloud connector slug used in the URL path
+     * (`/api/v1/eliza/<connector>/connect/initiate`).
+     */
+    connector: string;
+    /**
+     * Optional capability tokens passed to the cloud's `connect/initiate`
+     * endpoint. The cloud translates these to provider-specific OAuth scopes
+     * (e.g. Google's `google.gmail.send` → `https://www.googleapis.com/auth/gmail.send`).
+     */
+    capabilities?: string[];
+    /**
+     * Friendly description used in `needs_auth` UI prompts. The runtime may
+     * surface this verbatim to the end-user.
+     */
+    friendlyName: string;
+}
+/**
+ * Workflow credential type → cloud connector mapping.
+ *
+ * Names mirror the n8n / workflows-plugin convention used by the LLM in
+ * `plugins/plugin-workflow/src/utils/workflow-prompts/workflowGeneration.ts`.
+ * Both `gmailOAuth2` and `gmailOAuth2Api` map to the same connector — the
+ * workflow resolver does fuzzy `Api`-suffix matching upstream, but we keep
+ * both keys here so `checkCredentialTypes` answers truthfully without the
+ * caller having to know about that fuzziness.
+ */
+export declare const credTypeToConnector: ReadonlyMap<string, CredentialTypeMapping>;
+/** Set used by `checkCredentialTypes` for O(1) supported-set membership. */
+export declare const supportedCredTypes: ReadonlySet<string>;
+//# sourceMappingURL=credential-type-map.d.ts.map

package/dist/lib/credential-type-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-type-map.d.ts","sourceRoot":"","sources":["../../src/lib/credential-type-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CA2EzE,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAuC,CAAC"}

package/dist/lib/credential-type-map.js

@@ -0,0 +1,88 @@
+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/lib/credential-type-map.ts
+var credTypeToConnector = new Map([
+  [
+    "gmailOAuth2",
+    {
+      connector: "google",
+      capabilities: ["google.gmail.triage", "google.gmail.send", "google.gmail.manage"],
+      friendlyName: "Gmail"
+    }
+  ],
+  [
+    "gmailOAuth2Api",
+    {
+      connector: "google",
+      capabilities: ["google.gmail.triage", "google.gmail.send", "google.gmail.manage"],
+      friendlyName: "Gmail"
+    }
+  ],
+  [
+    "googleCalendarOAuth2Api",
+    {
+      connector: "google",
+      capabilities: ["google.calendar.read", "google.calendar.write"],
+      friendlyName: "Google Calendar"
+    }
+  ],
+  [
+    "googleSheetsOAuth2Api",
+    {
+      connector: "google",
+      capabilities: ["google.basic_identity"],
+      friendlyName: "Google Sheets"
+    }
+  ],
+  [
+    "githubOAuth2Api",
+    {
+      connector: "github",
+      friendlyName: "GitHub"
+    }
+  ],
+  [
+    "githubApi",
+    {
+      connector: "github",
+      friendlyName: "GitHub"
+    }
+  ],
+  [
+    "discordApi",
+    {
+      connector: "discord",
+      friendlyName: "Discord"
+    }
+  ],
+  [
+    "discordBotApi",
+    {
+      connector: "discord",
+      friendlyName: "Discord (Bot)"
+    }
+  ]
+]);
+var supportedCredTypes = new Set(credTypeToConnector.keys());
+export {
+  supportedCredTypes,
+  credTypeToConnector
+};
+
+//# debugId=ABCE65BAC140795564756E2164756E21

package/dist/lib/credential-type-map.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/lib/credential-type-map.ts"],
+  "sourcesContent": [
+    "/**\n * Mapping from workflow-plugin credential type names → Eliza Cloud connector slugs.\n *\n * The workflow plugin's LLM emits credential type strings (e.g. `gmailOAuth2`,\n * `slackOAuth2Api`) on each node that needs an external account. The cloud\n * exposes per-connector OAuth flows under `/api/v1/eliza/<connector>/...`.\n *\n * This map is the single source of truth for which workflow credential type\n * resolves through which cloud connector + with which OAuth scopes. Add new\n * entries when the cloud gains support for additional connectors; do not\n * scatter cred-type → connector logic elsewhere.\n *\n * Cloud-side endpoint convention (see cloud/apps/api/v1/eliza/<connector>/):\n *   POST /api/v1/eliza/<connector>/connect/initiate     → { authUrl }\n *   GET  /api/v1/eliza/<connector>/status               → { connected, ... }\n *\n * Not every connector below has a fully-implemented cloud endpoint yet — the\n * provider returns `null` for unmapped types and `needs_auth` (with the\n * cloud-issued OAuth URL) for mapped-but-not-connected accounts. See\n * `cloud-credential-provider.ts` for the resolution logic.\n */\n\nexport interface CredentialTypeMapping {\n  /**\n   * Cloud connector slug used in the URL path\n   * (`/api/v1/eliza/<connector>/connect/initiate`).\n   */\n  connector: string;\n  /**\n   * Optional capability tokens passed to the cloud's `connect/initiate`\n   * endpoint. The cloud translates these to provider-specific OAuth scopes\n   * (e.g. Google's `google.gmail.send` → `https://www.googleapis.com/auth/gmail.send`).\n   */\n  capabilities?: string[];\n  /**\n   * Friendly description used in `needs_auth` UI prompts. The runtime may\n   * surface this verbatim to the end-user.\n   */\n  friendlyName: string;\n}\n\n/**\n * Workflow credential type → cloud connector mapping.\n *\n * Names mirror the n8n / workflows-plugin convention used by the LLM in\n * `plugins/plugin-workflow/src/utils/workflow-prompts/workflowGeneration.ts`.\n * Both `gmailOAuth2` and `gmailOAuth2Api` map to the same connector — the\n * workflow resolver does fuzzy `Api`-suffix matching upstream, but we keep\n * both keys here so `checkCredentialTypes` answers truthfully without the\n * caller having to know about that fuzziness.\n */\nexport const credTypeToConnector: ReadonlyMap<string, CredentialTypeMapping> = new Map([\n  // ─── Google ──────────────────────────────────────────────────────────\n  // Cloud endpoint: /api/v1/eliza/google/{connect/initiate,status,disconnect}\n  // The cloud's capability tokens are documented in\n  // cloud/apps/api/v1/eliza/google/connect/initiate/route.ts.\n  [\n    \"gmailOAuth2\",\n    {\n      connector: \"google\",\n      capabilities: [\"google.gmail.triage\", \"google.gmail.send\", \"google.gmail.manage\"],\n      friendlyName: \"Gmail\",\n    },\n  ],\n  [\n    \"gmailOAuth2Api\",\n    {\n      connector: \"google\",\n      capabilities: [\"google.gmail.triage\", \"google.gmail.send\", \"google.gmail.manage\"],\n      friendlyName: \"Gmail\",\n    },\n  ],\n  [\n    \"googleCalendarOAuth2Api\",\n    {\n      connector: \"google\",\n      capabilities: [\"google.calendar.read\", \"google.calendar.write\"],\n      friendlyName: \"Google Calendar\",\n    },\n  ],\n  [\n    \"googleSheetsOAuth2Api\",\n    {\n      connector: \"google\",\n      capabilities: [\"google.basic_identity\"],\n      friendlyName: \"Google Sheets\",\n    },\n  ],\n\n  // ─── GitHub ──────────────────────────────────────────────────────────\n  // Cloud endpoint: /api/v1/eliza/github-oauth-complete/ (callback only).\n  // The initiate flow is host-driven; the provider returns `needs_auth`\n  // pointing at the cloud's GitHub install URL when not connected.\n  [\n    \"githubOAuth2Api\",\n    {\n      connector: \"github\",\n      friendlyName: \"GitHub\",\n    },\n  ],\n  [\n    \"githubApi\",\n    {\n      connector: \"github\",\n      friendlyName: \"GitHub\",\n    },\n  ],\n\n  // ─── Discord ─────────────────────────────────────────────────────────\n  // Cloud endpoint: /api/v1/eliza/discord/gateway-agent/ (gateway pairing).\n  // No OAuth-token-issuance flow yet — provider returns `null` so the\n  // workflow resolver falls back to its default missing-connection report.\n  [\n    \"discordApi\",\n    {\n      connector: \"discord\",\n      friendlyName: \"Discord\",\n    },\n  ],\n  [\n    \"discordBotApi\",\n    {\n      connector: \"discord\",\n      friendlyName: \"Discord (Bot)\",\n    },\n  ],\n]);\n\n/** Set used by `checkCredentialTypes` for O(1) supported-set membership. */\nexport const supportedCredTypes: ReadonlySet<string> = new Set(credTypeToConnector.keys());\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAmDO,IAAM,sBAAkE,IAAI,IAAI;AAAA,EAKrF;AAAA,IACE;AAAA,IACA;AAAA,MACE,WAAW;AAAA,MACX,cAAc,CAAC,uBAAuB,qBAAqB,qBAAqB;AAAA,MAChF,cAAc;AAAA,IAChB;AAAA,EACF;AAAA,EACA;AAAA,IACE;AAAA,IACA;AAAA,MACE,WAAW;AAAA,MACX,cAAc,CAAC,uBAAuB,qBAAqB,qBAAqB;AAAA,MAChF,cAAc;AAAA,IAChB;AAAA,EACF;AAAA,EACA;AAAA,IACE;AAAA,IACA;AAAA,MACE,WAAW;AAAA,MACX,cAAc,CAAC,wBAAwB,uBAAuB;AAAA,MAC9D,cAAc;AAAA,IAChB;AAAA,EACF;AAAA,EACA;AAAA,IACE;AAAA,IACA;AAAA,MACE,WAAW;AAAA,MACX,cAAc,CAAC,uBAAuB;AAAA,MACtC,cAAc;AAAA,IAChB;AAAA,EACF;AAAA,EAMA;AAAA,IACE;AAAA,IACA;AAAA,MACE,WAAW;AAAA,MACX,cAAc;AAAA,IAChB;AAAA,EACF;AAAA,EACA;AAAA,IACE;AAAA,IACA;AAAA,MACE,WAAW;AAAA,MACX,cAAc;AAAA,IAChB;AAAA,EACF;AAAA,EAMA;AAAA,IACE;AAAA,IACA;AAAA,MACE,WAAW;AAAA,MACX,cAAc;AAAA,IAChB;AAAA,EACF;AAAA,EACA;AAAA,IACE;AAAA,IACA;AAAA,MACE,WAAW;AAAA,MACX,cAAc;AAAA,IAChB;AAAA,EACF;AACF,CAAC;AAGM,IAAM,qBAA0C,IAAI,IAAI,oBAAoB,KAAK,CAAC;",
+  "debugId": "ABCE65BAC140795564756E2164756E21",
+  "names": []
+}

package/dist/lib/feature-flags.d.ts

@@ -0,0 +1,2 @@
+export declare function isCloudWalletEnabled(): boolean;
+//# sourceMappingURL=feature-flags.d.ts.map

package/dist/lib/feature-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../src/lib/feature-flags.ts"],"names":[],"mappings":"AAuBA,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C"}

package/dist/lib/feature-flags.js

@@ -0,0 +1,40 @@
+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/lib/feature-flags.ts
+function readBoolFlag(name, fallback = false) {
+  const raw = process.env[name];
+  if (raw === undefined || raw === null || raw === "")
+    return fallback;
+  const trimmed = String(raw).trim().toLowerCase();
+  if (trimmed === "1" || trimmed === "true" || trimmed === "yes" || trimmed === "on") {
+    return true;
+  }
+  if (trimmed === "0" || trimmed === "false" || trimmed === "no" || trimmed === "off") {
+    return false;
+  }
+  return fallback;
+}
+function isCloudWalletEnabled() {
+  return readBoolFlag("ENABLE_CLOUD_WALLET");
+}
+export {
+  isCloudWalletEnabled
+};
+
+//# debugId=F2AC4B357531E84364756E2164756E21

package/dist/lib/feature-flags.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/lib/feature-flags.ts"],
+  "sourcesContent": [
+    "function readBoolFlag(name: string, fallback = false): boolean {\n  const raw = process.env[name];\n  if (raw === undefined || raw === null || raw === \"\") return fallback;\n  const trimmed = String(raw).trim().toLowerCase();\n  if (\n    trimmed === \"1\" ||\n    trimmed === \"true\" ||\n    trimmed === \"yes\" ||\n    trimmed === \"on\"\n  ) {\n    return true;\n  }\n  if (\n    trimmed === \"0\" ||\n    trimmed === \"false\" ||\n    trimmed === \"no\" ||\n    trimmed === \"off\"\n  ) {\n    return false;\n  }\n  return fallback;\n}\n\nexport function isCloudWalletEnabled(): boolean {\n  return readBoolFlag(\"ENABLE_CLOUD_WALLET\");\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA,SAAS,YAAY,CAAC,MAAc,WAAW,OAAgB;AAAA,EAC7D,MAAM,MAAM,QAAQ,IAAI;AAAA,EACxB,IAAI,QAAQ,aAAa,QAAQ,QAAQ,QAAQ;AAAA,IAAI,OAAO;AAAA,EAC5D,MAAM,UAAU,OAAO,GAAG,EAAE,KAAK,EAAE,YAAY;AAAA,EAC/C,IACE,YAAY,OACZ,YAAY,UACZ,YAAY,SACZ,YAAY,MACZ;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EACA,IACE,YAAY,OACZ,YAAY,WACZ,YAAY,QACZ,YAAY,OACZ;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EACA,OAAO;AAAA;AAGF,SAAS,oBAAoB,GAAY;AAAA,EAC9C,OAAO,aAAa,qBAAqB;AAAA;",
+  "debugId": "F2AC4B357531E84364756E2164756E21",
+  "names": []
+}

package/dist/lib/http.d.ts

@@ -0,0 +1,22 @@
+import type http from "node:http";
+export interface ReadJsonBodyOptions {
+    maxBytes?: number;
+    tooLargeMessage?: string;
+    destroyOnTooLarge?: boolean;
+    requireObject?: boolean;
+}
+export interface RouteRequestMeta {
+    req: http.IncomingMessage;
+    res: http.ServerResponse;
+    method: string;
+    pathname: string;
+}
+export interface RouteHelpers {
+    json: (res: http.ServerResponse, data: unknown, status?: number) => void;
+    error: (res: http.ServerResponse, message: string, status?: number) => void;
+    readJsonBody: <T extends object>(req: http.IncomingMessage, res: http.ServerResponse, options?: ReadJsonBodyOptions) => Promise<T | null>;
+}
+export declare function sendJson(res: http.ServerResponse, body: unknown, status?: number): void;
+export declare function sendJsonError(res: http.ServerResponse, message: string, status?: number): void;
+export declare function readJsonBody<T extends object = Record<string, unknown>>(req: http.IncomingMessage, res: http.ServerResponse, options?: ReadJsonBodyOptions): Promise<T | null>;
+//# sourceMappingURL=http.d.ts.map

package/dist/lib/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/lib/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,IAAI,CAAC,eAAe,CAAC;IAC1B,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5E,YAAY,EAAE,CAAC,CAAC,SAAS,MAAM,EAC7B,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,OAAO,CAAC,EAAE,mBAAmB,KAC1B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CACxB;AAoBD,wBAAgB,QAAQ,CACtB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,IAAI,EAAE,OAAO,EACb,MAAM,SAAM,GACX,IAAI,CAKN;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,OAAO,EAAE,MAAM,EACf,MAAM,SAAM,GACX,IAAI,CAEN;AAwBD,wBAAsB,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3E,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAiDnB"}

package/dist/lib/http.js

@@ -0,0 +1,107 @@
+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/lib/http.ts
+function scrubStackFields(value) {
+  if (value instanceof Error) {
+    return { error: value.message || "Internal error" };
+  }
+  if (Array.isArray(value)) {
+    return value.map(scrubStackFields);
+  }
+  if (value && typeof value === "object") {
+    const out = {};
+    for (const [key, nested] of Object.entries(value)) {
+      if (key === "stack" || key === "stackTrace")
+        continue;
+      out[key] = scrubStackFields(nested);
+    }
+    return out;
+  }
+  return value;
+}
+function sendJson(res, body, status = 200) {
+  if (res.headersSent)
+    return;
+  res.statusCode = status;
+  res.setHeader("content-type", "application/json; charset=utf-8");
+  res.end(JSON.stringify(scrubStackFields(body)));
+}
+function sendJsonError(res, message, status = 400) {
+  sendJson(res, { error: message }, status);
+}
+async function readRequestBody(req, options) {
+  const maxBytes = options.maxBytes ?? 1048576;
+  const chunks = [];
+  let size = 0;
+  for await (const chunk of req) {
+    const buffer = typeof chunk === "string" ? Buffer.from(chunk) : chunk;
+    size += buffer.length;
+    if (size > maxBytes) {
+      if (options.destroyOnTooLarge)
+        req.destroy();
+      throw new Error(options.tooLargeMessage ?? "Request body too large");
+    }
+    chunks.push(buffer);
+  }
+  if (chunks.length === 0)
+    return null;
+  return Buffer.concat(chunks).toString("utf8");
+}
+async function readJsonBody(req, res, options = {}) {
+  const cached = req.body;
+  if (cached !== undefined) {
+    if (options.requireObject !== false && (!cached || typeof cached !== "object" || Array.isArray(cached))) {
+      sendJsonError(res, "Request body must be a JSON object", 400);
+      return null;
+    }
+    return cached;
+  }
+  let raw;
+  try {
+    raw = await readRequestBody(req, options);
+  } catch (error) {
+    sendJsonError(res, error instanceof Error ? error.message : "Failed to read request body", 413);
+    return null;
+  }
+  if (!raw?.trim()) {
+    const empty = {};
+    req.body = empty;
+    return empty;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    sendJsonError(res, "Invalid JSON in request body", 400);
+    return null;
+  }
+  if (options.requireObject !== false && (!parsed || typeof parsed !== "object" || Array.isArray(parsed))) {
+    sendJsonError(res, "Request body must be a JSON object", 400);
+    return null;
+  }
+  req.body = parsed;
+  return parsed;
+}
+export {
+  sendJsonError,
+  sendJson,
+  readJsonBody
+};
+
+//# debugId=35C1D1B4C679F52364756E2164756E21

package/dist/lib/http.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/lib/http.ts"],
+  "sourcesContent": [
+    "import type http from \"node:http\";\n\nexport interface ReadJsonBodyOptions {\n  maxBytes?: number;\n  tooLargeMessage?: string;\n  destroyOnTooLarge?: boolean;\n  requireObject?: boolean;\n}\n\nexport interface RouteRequestMeta {\n  req: http.IncomingMessage;\n  res: http.ServerResponse;\n  method: string;\n  pathname: string;\n}\n\nexport interface RouteHelpers {\n  json: (res: http.ServerResponse, data: unknown, status?: number) => void;\n  error: (res: http.ServerResponse, message: string, status?: number) => void;\n  readJsonBody: <T extends object>(\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n    options?: ReadJsonBodyOptions,\n  ) => Promise<T | null>;\n}\n\nfunction scrubStackFields(value: unknown): unknown {\n  if (value instanceof Error) {\n    return { error: value.message || \"Internal error\" };\n  }\n  if (Array.isArray(value)) {\n    return value.map(scrubStackFields);\n  }\n  if (value && typeof value === \"object\") {\n    const out: Record<string, unknown> = {};\n    for (const [key, nested] of Object.entries(value)) {\n      if (key === \"stack\" || key === \"stackTrace\") continue;\n      out[key] = scrubStackFields(nested);\n    }\n    return out;\n  }\n  return value;\n}\n\nexport function sendJson(\n  res: http.ServerResponse,\n  body: unknown,\n  status = 200,\n): void {\n  if (res.headersSent) return;\n  res.statusCode = status;\n  res.setHeader(\"content-type\", \"application/json; charset=utf-8\");\n  res.end(JSON.stringify(scrubStackFields(body)));\n}\n\nexport function sendJsonError(\n  res: http.ServerResponse,\n  message: string,\n  status = 400,\n): void {\n  sendJson(res, { error: message }, status);\n}\n\nasync function readRequestBody(\n  req: http.IncomingMessage,\n  options: ReadJsonBodyOptions,\n): Promise<string | null> {\n  const maxBytes = options.maxBytes ?? 1_048_576;\n  const chunks: Buffer[] = [];\n  let size = 0;\n\n  for await (const chunk of req) {\n    const buffer = typeof chunk === \"string\" ? Buffer.from(chunk) : chunk;\n    size += buffer.length;\n    if (size > maxBytes) {\n      if (options.destroyOnTooLarge) req.destroy();\n      throw new Error(options.tooLargeMessage ?? \"Request body too large\");\n    }\n    chunks.push(buffer);\n  }\n\n  if (chunks.length === 0) return null;\n  return Buffer.concat(chunks).toString(\"utf8\");\n}\n\nexport async function readJsonBody<T extends object = Record<string, unknown>>(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  options: ReadJsonBodyOptions = {},\n): Promise<T | null> {\n  const cached = (req as http.IncomingMessage & { body?: unknown }).body;\n  if (cached !== undefined) {\n    if (\n      options.requireObject !== false &&\n      (!cached || typeof cached !== \"object\" || Array.isArray(cached))\n    ) {\n      sendJsonError(res, \"Request body must be a JSON object\", 400);\n      return null;\n    }\n    return cached as T;\n  }\n\n  let raw: string | null;\n  try {\n    raw = await readRequestBody(req, options);\n  } catch (error) {\n    sendJsonError(\n      res,\n      error instanceof Error ? error.message : \"Failed to read request body\",\n      413,\n    );\n    return null;\n  }\n\n  if (!raw?.trim()) {\n    const empty = {} as T;\n    (req as http.IncomingMessage & { body?: unknown }).body = empty;\n    return empty;\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    sendJsonError(res, \"Invalid JSON in request body\", 400);\n    return null;\n  }\n\n  if (\n    options.requireObject !== false &&\n    (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed))\n  ) {\n    sendJsonError(res, \"Request body must be a JSON object\", 400);\n    return null;\n  }\n\n  (req as http.IncomingMessage & { body?: unknown }).body = parsed;\n  return parsed as T;\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "35C1D1B4C679F52364756E2164756E21",
+  "names": []
+}

package/dist/lib/server-cloud-tts.d.ts

@@ -0,0 +1,34 @@
+import type http from "node:http";
+/** Browser → API correlation (never forwarded to Eliza Cloud). */
+export declare function readTtsDebugClientHeaders(req: Pick<http.IncomingMessage, "headers">): {
+    messageId?: string;
+    clipSegment?: string;
+    hearingFull?: string;
+};
+/** Matches `MAX_TEXT_LENGTH` in eliza-cloud-v2 `app/api/v1/voice/tts/route.ts`. */
+export declare const ELIZA_CLOUD_TTS_MAX_TEXT_CHARS = 5000;
+/**
+ * Resolve `voiceId` for Eliza Cloud TTS (ElevenLabs ids). OpenAI-style names
+ * in the request are replaced with the default premade voice.
+ */
+export declare function resolveElizaCloudTtsVoiceId(bodyVoiceId: unknown, env?: NodeJS.ProcessEnv): string;
+export declare function __resetCloudBaseUrlCache(): void;
+/**
+ * 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 declare function shouldRetryCloudTtsUpstream(status: number): boolean;
+/**
+ * Coerce stored/configured values to an ElevenLabs model id Eliza Cloud accepts.
+ * Maps OpenAI TTS ids and common copy-paste mistakes; passes through real `eleven_*` ids.
+ */
+export declare function normalizeElizaCloudTtsModelId(raw: string): string;
+/** Eliza Cloud TTS `modelId` (ElevenLabs), from body or env or default. */
+export declare function resolveCloudProxyTtsModel(bodyModel: unknown, env?: NodeJS.ProcessEnv): string;
+export declare function resolveElevenLabsApiKeyForCloudMode(env?: NodeJS.ProcessEnv): string | null;
+export declare function ensureCloudTtsApiKeyAlias(env?: NodeJS.ProcessEnv): boolean;
+export declare function resolveCloudTtsBaseUrl(env?: NodeJS.ProcessEnv): string;
+export declare function resolveCloudTtsCandidateUrls(env?: NodeJS.ProcessEnv): string[];
+export declare function handleCloudTtsPreviewRoute(req: http.IncomingMessage, res: http.ServerResponse): Promise<boolean>;
+export declare function mirrorCompatHeaders(req: Pick<http.IncomingMessage, "headers">): void;
+//# sourceMappingURL=server-cloud-tts.d.ts.map

package/dist/lib/server-cloud-tts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-cloud-tts.d.ts","sourceRoot":"","sources":["../../src/lib/server-cloud-tts.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAyBlC,kEAAkE;AAClE,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,GACzC;IACD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAoBA;AA4CD,mFAAmF;AACnF,eAAO,MAAM,8BAA8B,OAAO,CAAC;AAqBnD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,OAAO,EACpB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CASR;AAqCD,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C;AA+DD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnE;AA4BD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiBjE;AAED,2EAA2E;AAC3E,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,OAAO,EAClB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAOR;AAMD,wBAAgB,mCAAmC,CACjD,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,IAAI,CAwBf;AAED,wBAAgB,yBAAyB,CACvC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAWT;AAED,wBAAgB,sBAAsB,CACpC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAmBR;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,EAAE,CAmCV;AAED,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC,CA2JlB;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,GACzC,IAAI,CAsBN"}