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

package/dist/routes/cloud-features-routes.js

@@ -0,0 +1,124 @@
+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;
+}
+
+// src/routes/cloud-features-routes.ts
+var LIFEOPS_CLOUD_FEATURES_MODULE = "@elizaos/app-lifeops";
+async function handleCloudFeaturesRoute(req, res, pathname, method, state) {
+  if (pathname !== "/api/cloud/features" && pathname !== "/api/cloud/features/sync") {
+    return false;
+  }
+  try {
+    const loaded = await import(LIFEOPS_CLOUD_FEATURES_MODULE);
+    if (typeof loaded.handleCloudFeaturesRoute !== "function") {
+      sendJsonError(res, "LifeOps cloud feature routes are not available", 503);
+      return true;
+    }
+    return await loaded.handleCloudFeaturesRoute(req, res, pathname, method, state);
+  } catch {
+    sendJsonError(res, "LifeOps cloud feature routes are not available", 503);
+    return true;
+  }
+}
+export {
+  handleCloudFeaturesRoute
+};
+
+//# debugId=4BEC6681664CAA8664756E2164756E21

package/dist/routes/cloud-features-routes.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/lib/http.ts", "../src/routes/cloud-features-routes.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",
+    "import type http from \"node:http\";\nimport type { AgentRuntime } from \"@elizaos/core\";\nimport type { CloudProxyConfigLike } from \"../lib/config-like\";\nimport { sendJsonError } from \"../lib/http\";\n\nconst LIFEOPS_CLOUD_FEATURES_MODULE: string =\n  \"@elizaos/app-lifeops\";\n\nexport interface CloudFeaturesRouteState {\n  config: CloudProxyConfigLike;\n  runtime?: AgentRuntime | null;\n}\n\ntype CloudFeaturesRoutesModule = {\n  handleCloudFeaturesRoute?: (\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n    pathname: string,\n    method: string,\n    state: CloudFeaturesRouteState,\n  ) => Promise<boolean> | boolean;\n};\n\nexport async function handleCloudFeaturesRoute(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  pathname: string,\n  method: string,\n  state: CloudFeaturesRouteState,\n): Promise<boolean> {\n  if (\n    pathname !== \"/api/cloud/features\" &&\n    pathname !== \"/api/cloud/features/sync\"\n  ) {\n    return false;\n  }\n\n  try {\n    const loaded = (await import(\n      /* @vite-ignore */ LIFEOPS_CLOUD_FEATURES_MODULE\n    )) as CloudFeaturesRoutesModule;\n    if (typeof loaded.handleCloudFeaturesRoute !== \"function\") {\n      sendJsonError(res, \"LifeOps cloud feature routes are not available\", 503);\n      return true;\n    }\n    return await loaded.handleCloudFeaturesRoute(\n      req,\n      res,\n      pathname,\n      method,\n      state,\n    );\n  } catch {\n    sendJsonError(res, \"LifeOps cloud feature routes are not available\", 503);\n    return true;\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "4BEC6681664CAA8664756E2164756E21",
+  "names": []
+}

package/dist/routes/cloud-provisioning.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Platform-managed cloud containers should skip local pairing and onboarding UI.
+ *
+ * In production we may have either:
+ * - a Steward sidecar token (older / sidecar-managed path),
+ * - an inbound API token injected directly into the container, or
+ * - cloud-managed API-key access injected into the runtime environment.
+ *
+ * Requiring the cloud flag plus one of those credentials keeps accidental local
+ * env leakage from triggering cloud behavior, while still matching real deployed
+ * cloud containers.
+ */
+export declare function isCloudProvisionedContainer(): boolean;
+//# sourceMappingURL=cloud-provisioning.d.ts.map

package/dist/routes/cloud-provisioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-provisioning.d.ts","sourceRoot":"","sources":["../../src/routes/cloud-provisioning.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CASrD"}

package/dist/routes/cloud-provisioning.js

@@ -0,0 +1,37 @@
+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/routes/cloud-provisioning.ts
+function hasValue(value) {
+  return Boolean(value?.trim());
+}
+function hasCompatApiToken() {
+  return hasValue(process.env.ELIZA_API_TOKEN);
+}
+function hasCloudApiKeyProvisioning() {
+  return process.env.ELIZAOS_CLOUD_ENABLED === "true" && hasValue(process.env.ELIZAOS_CLOUD_API_KEY);
+}
+function isCloudProvisionedContainer() {
+  const hasCloudFlag = process.env.ELIZA_CLOUD_PROVISIONED === "1";
+  return hasCloudFlag && (hasValue(process.env.STEWARD_AGENT_TOKEN) || hasCompatApiToken() || hasCloudApiKeyProvisioning());
+}
+export {
+  isCloudProvisionedContainer
+};
+
+//# debugId=20AD93380402B0AE64756E2164756E21

package/dist/routes/cloud-provisioning.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/routes/cloud-provisioning.ts"],
+  "sourcesContent": [
+    "function hasValue(value: string | undefined): boolean {\n  return Boolean(value?.trim());\n}\n\nfunction hasCompatApiToken(): boolean {\n  return hasValue(process.env.ELIZA_API_TOKEN);\n}\n\nfunction hasCloudApiKeyProvisioning(): boolean {\n  return (\n    process.env.ELIZAOS_CLOUD_ENABLED === \"true\" &&\n    hasValue(process.env.ELIZAOS_CLOUD_API_KEY)\n  );\n}\n\n/**\n * Platform-managed cloud containers should skip local pairing and onboarding UI.\n *\n * In production we may have either:\n * - a Steward sidecar token (older / sidecar-managed path),\n * - an inbound API token injected directly into the container, or\n * - cloud-managed API-key access injected into the runtime environment.\n *\n * Requiring the cloud flag plus one of those credentials keeps accidental local\n * env leakage from triggering cloud behavior, while still matching real deployed\n * cloud containers.\n */\nexport function isCloudProvisionedContainer(): boolean {\n  const hasCloudFlag = process.env.ELIZA_CLOUD_PROVISIONED === \"1\";\n\n  return (\n    hasCloudFlag &&\n    (hasValue(process.env.STEWARD_AGENT_TOKEN) ||\n      hasCompatApiToken() ||\n      hasCloudApiKeyProvisioning())\n  );\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA,SAAS,QAAQ,CAAC,OAAoC;AAAA,EACpD,OAAO,QAAQ,OAAO,KAAK,CAAC;AAAA;AAG9B,SAAS,iBAAiB,GAAY;AAAA,EACpC,OAAO,SAAS,QAAQ,IAAI,eAAe;AAAA;AAG7C,SAAS,0BAA0B,GAAY;AAAA,EAC7C,OACE,QAAQ,IAAI,0BAA0B,UACtC,SAAS,QAAQ,IAAI,qBAAqB;AAAA;AAgBvC,SAAS,2BAA2B,GAAY;AAAA,EACrD,MAAM,eAAe,QAAQ,IAAI,4BAA4B;AAAA,EAE7D,OACE,iBACC,SAAS,QAAQ,IAAI,mBAAmB,KACvC,kBAAkB,KAClB,2BAA2B;AAAA;",
+  "debugId": "20AD93380402B0AE64756E2164756E21",
+  "names": []
+}

package/dist/routes/cloud-relay-routes.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Cloud gateway relay status route.
+ *
+ * Exposes the current state of the CloudManagedGatewayRelayService
+ * so the UI can show whether this local instance is registered with
+ * Eliza Cloud and actively receiving routed messages.
+ *
+ *   GET /api/cloud/relay-status
+ *
+ * The relay service lives in plugin-elizacloud and registers itself
+ * as a runtime service named "cloud-managed-gateway-relay". We query
+ * it via the runtime.getService interface to avoid a build-time dep.
+ */
+import type http from "node:http";
+import type { RouteHelpers } from "../lib/http";
+export interface CloudRelayRouteState {
+    runtime?: {
+        getService(type: string): unknown;
+    };
+}
+export declare function handleCloudRelayRoute(_req: http.IncomingMessage, res: http.ServerResponse, pathname: string, method: string, state: CloudRelayRouteState, helpers: RouteHelpers): Promise<boolean>;
+//# sourceMappingURL=cloud-relay-routes.d.ts.map

package/dist/routes/cloud-relay-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-relay-routes.d.ts","sourceRoot":"","sources":["../../src/routes/cloud-relay-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAchD,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;KACnC,CAAC;CACH;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,IAAI,CAAC,eAAe,EAC1B,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,OAAO,CAAC,CA8ClB"}

package/dist/routes/cloud-relay-routes.js

@@ -0,0 +1,60 @@
+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/routes/cloud-relay-routes.ts
+async function handleCloudRelayRoute(_req, res, pathname, method, state, helpers) {
+  if (method !== "GET" || pathname !== "/api/cloud/relay-status") {
+    return false;
+  }
+  if (!state.runtime) {
+    helpers.json(res, {
+      available: false,
+      status: "no_runtime",
+      reason: "Runtime not initialized"
+    });
+    return true;
+  }
+  const service = state.runtime.getService("CLOUD_MANAGED_GATEWAY_RELAY") ?? state.runtime.getService("cloud-managed-gateway-relay") ?? state.runtime.getService("cloudManagedGatewayRelay");
+  if (!service || typeof service.getSessionInfo !== "function") {
+    helpers.json(res, {
+      available: false,
+      status: "not_registered",
+      reason: "Gateway relay service not active. Connect to Eliza Cloud in Settings to enable instance routing."
+    });
+    return true;
+  }
+  try {
+    const info = service.getSessionInfo();
+    helpers.json(res, {
+      available: true,
+      ...info
+    });
+  } catch (err) {
+    helpers.json(res, {
+      available: false,
+      status: "error",
+      reason: err instanceof Error ? err.message : String(err)
+    });
+  }
+  return true;
+}
+export {
+  handleCloudRelayRoute
+};
+
+//# debugId=58E55DD1D02A7A0B64756E2164756E21

package/dist/routes/cloud-relay-routes.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/routes/cloud-relay-routes.ts"],
+  "sourcesContent": [
+    "/**\n * Cloud gateway relay status route.\n *\n * Exposes the current state of the CloudManagedGatewayRelayService\n * so the UI can show whether this local instance is registered with\n * Eliza Cloud and actively receiving routed messages.\n *\n *   GET /api/cloud/relay-status\n *\n * The relay service lives in plugin-elizacloud and registers itself\n * as a runtime service named \"cloud-managed-gateway-relay\". We query\n * it via the runtime.getService interface to avoid a build-time dep.\n */\n\nimport type http from \"node:http\";\nimport type { RouteHelpers } from \"../lib/http\";\n\ninterface RelayServiceLike {\n  getSessionInfo(): {\n    sessionId: string | null;\n    organizationId: string | null;\n    userId: string | null;\n    agentName: string | null;\n    platform: string | null;\n    lastSeenAt: string | null;\n    status: \"idle\" | \"registered\" | \"polling\" | \"error\" | \"stopped\";\n  };\n}\n\nexport interface CloudRelayRouteState {\n  runtime?: {\n    getService(type: string): unknown;\n  };\n}\n\nexport async function handleCloudRelayRoute(\n  _req: http.IncomingMessage,\n  res: http.ServerResponse,\n  pathname: string,\n  method: string,\n  state: CloudRelayRouteState,\n  helpers: RouteHelpers,\n): Promise<boolean> {\n  if (method !== \"GET\" || pathname !== \"/api/cloud/relay-status\") {\n    return false;\n  }\n\n  if (!state.runtime) {\n    helpers.json(res, {\n      available: false,\n      status: \"no_runtime\",\n      reason: \"Runtime not initialized\",\n    });\n    return true;\n  }\n\n  // Try known service names used across package boundaries.\n  const service = (state.runtime.getService(\"CLOUD_MANAGED_GATEWAY_RELAY\") ??\n    state.runtime.getService(\"cloud-managed-gateway-relay\") ??\n    state.runtime.getService(\n      \"cloudManagedGatewayRelay\",\n    )) as RelayServiceLike | null;\n\n  if (!service || typeof service.getSessionInfo !== \"function\") {\n    helpers.json(res, {\n      available: false,\n      status: \"not_registered\",\n      reason:\n        \"Gateway relay service not active. Connect to Eliza Cloud in Settings to enable instance routing.\",\n    });\n    return true;\n  }\n\n  try {\n    const info = service.getSessionInfo();\n    helpers.json(res, {\n      available: true,\n      ...info,\n    });\n  } catch (err) {\n    helpers.json(res, {\n      available: false,\n      status: \"error\",\n      reason: err instanceof Error ? err.message : String(err),\n    });\n  }\n\n  return true;\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAmCA,eAAsB,qBAAqB,CACzC,MACA,KACA,UACA,QACA,OACA,SACkB;AAAA,EAClB,IAAI,WAAW,SAAS,aAAa,2BAA2B;AAAA,IAC9D,OAAO;AAAA,EACT;AAAA,EAEA,IAAI,CAAC,MAAM,SAAS;AAAA,IAClB,QAAQ,KAAK,KAAK;AAAA,MAChB,WAAW;AAAA,MACX,QAAQ;AAAA,MACR,QAAQ;AAAA,IACV,CAAC;AAAA,IACD,OAAO;AAAA,EACT;AAAA,EAGA,MAAM,UAAW,MAAM,QAAQ,WAAW,6BAA6B,KACrE,MAAM,QAAQ,WAAW,6BAA6B,KACtD,MAAM,QAAQ,WACZ,0BACF;AAAA,EAEF,IAAI,CAAC,WAAW,OAAO,QAAQ,mBAAmB,YAAY;AAAA,IAC5D,QAAQ,KAAK,KAAK;AAAA,MAChB,WAAW;AAAA,MACX,QAAQ;AAAA,MACR,QACE;AAAA,IACJ,CAAC;AAAA,IACD,OAAO;AAAA,EACT;AAAA,EAEA,IAAI;AAAA,IACF,MAAM,OAAO,QAAQ,eAAe;AAAA,IACpC,QAAQ,KAAK,KAAK;AAAA,MAChB,WAAW;AAAA,SACR;AAAA,IACL,CAAC;AAAA,IACD,OAAO,KAAK;AAAA,IACZ,QAAQ,KAAK,KAAK;AAAA,MAChB,WAAW;AAAA,MACX,QAAQ;AAAA,MACR,QAAQ,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,IACzD,CAAC;AAAA;AAAA,EAGH,OAAO;AAAA;",
+  "debugId": "58E55DD1D02A7A0B64756E2164756E21",
+  "names": []
+}

package/dist/routes/cloud-routes-autonomous.d.ts

@@ -0,0 +1,83 @@
+import type http from "node:http";
+import type { CloudChainType, CloudWalletDescriptor, CloudWalletProvider } from "../cloud/bridge-client.js";
+export interface CloudConfigLike {
+    cloud?: {
+        enabled?: boolean;
+        apiKey?: string;
+        baseUrl?: string;
+    };
+}
+interface CloudClientLike {
+    listAgents: () => Promise<unknown>;
+    createAgent: (args: {
+        agentName: string;
+        agentConfig?: Record<string, unknown>;
+        environmentVars?: Record<string, string>;
+    }) => Promise<unknown>;
+    deleteAgent: (agentId: string) => Promise<unknown>;
+    getAgentWallet: (agentId: string, chain: CloudChainType) => Promise<CloudWalletDescriptor>;
+    provisionWallet: (input: {
+        chainType: CloudChainType;
+        clientAddress: string;
+    }) => Promise<{
+        walletId: string;
+        address: string;
+        chainType: CloudChainType;
+        provider: CloudWalletProvider;
+    }>;
+}
+interface ConnectedCloudAgentLike {
+    agentName: string;
+}
+interface CloudManagerLike {
+    init?: () => Promise<void>;
+    replaceApiKey?: (apiKey: string) => Promise<void>;
+    getClient: () => CloudClientLike | null;
+    connect: (agentId: string) => Promise<ConnectedCloudAgentLike>;
+    disconnect: () => Promise<void>;
+    getStatus: () => unknown;
+    getActiveAgentId: () => string | null;
+}
+interface RuntimeLike {
+    agentId: string;
+    character?: {
+        secrets?: Record<string, string | number | boolean>;
+    };
+    getService?: (name: string) => unknown;
+    setSetting?: (key: string, value: string | null) => unknown;
+    updateAgent?: (agentId: string, update: {
+        secrets: Record<string, string | number | boolean>;
+    }) => Promise<unknown>;
+}
+interface IntegrationTelemetrySpanLike {
+    success: (args?: {
+        statusCode?: number;
+    }) => void;
+    failure: (args?: {
+        statusCode?: number;
+        error?: unknown;
+        errorKind?: string;
+    }) => void;
+}
+type CreateTelemetrySpanLike = (meta: {
+    boundary: "cloud";
+    operation: string;
+    timeoutMs?: number;
+}) => IntegrationTelemetrySpanLike | null | undefined;
+export interface CloudRouteState {
+    config: CloudConfigLike;
+    cloudManager: CloudManagerLike | null;
+    runtime: RuntimeLike | null;
+    saveConfig?: (config: CloudConfigLike) => void;
+    createTelemetrySpan?: CreateTelemetrySpanLike;
+    /**
+     * Optional runtime restart hook. When Phase 8 lands the cloud-wallet
+     * provisioning integration, the cloud-login handler will call this to
+     * rebind plugin-wallet to the cloud provider. Threaded
+     * from server.ts the same way provider-switch-routes does.
+     */
+    restartRuntime?: (reason: string) => Promise<boolean> | boolean;
+}
+export declare function handleCloudRoute(req: http.IncomingMessage, res: http.ServerResponse, pathname: string, method: string, state: CloudRouteState): Promise<boolean>;
+export {};
+//# sourceMappingURL=cloud-routes-autonomous.d.ts.map

package/dist/routes/cloud-routes-autonomous.d.ts.map

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