@mearl/cloud-server 2.9.5 → 2.10.0

package/README.md

@@ -23,6 +23,7 @@ npx @mearl/setup --qoder-cloud --yes
 ### 命令行方式
 
 Server **默认以后台守护进程方式运行**，启动后立即返回，并打印本地机器需要执行的连接命令。
+POSIX 环境下后台进程会进入独立 session，可在启动命令结束后继续运行。
 Qoder 模式保持相同的 `start/status/restart/stop/logs` 交互；`start` 和 `restart` 生成新的
 pair/connector 信息后退出，不监听端口或创建守护进程。
 
@@ -94,6 +95,13 @@ mearl-cloud-server --foreground
 
 - `MEARL_TOKEN` - 鉴权密钥（覆盖 --token 选项）
 - `CLOUD_SERVER_HOST` - 公网主机名（默认自动获取）
+- `OPENSANDBOX_ID` - 非空时启用 OpenSandbox 环境自适应
+- `AONE_SANDBOX_ENDPOINT_TEMPLATE` - OpenSandbox 注入的入口模板；必须包含 `{port}`，server 会用 connector 端口替换并生成 `wss://` 连接地址
+
+OpenSandbox 中 connector listener 会绑定 `0.0.0.0`，公开地址以平台注入的 endpoint
+template 为准，不会从容器 hostname 推导路由前缀。
+OpenSandbox 与通过 `AONE_SANDBOX_ID` 及本地端口映射接口识别的 AONE Sandbox
+是两种独立环境，server 会分别选择对应的入口解析方式。
 
 ### 编程方式
 

package/dist/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/chunks/{chunk-DCTZIDJ7.js → chunk-AFZKMZDL.js}

@@ -1,9 +1,10 @@
 // src/index.ts
 import WebSocket, { WebSocketServer } from "ws";
 import { createServer as createHttpServer } from "node:http";
-import { chmodSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { chmodSync } from "node:fs";
 import { randomBytes } from "node:crypto";
 import { networkInterfaces } from "node:os";
+import { writeRecord } from "@mearl/daemon-core";
 
 // src/paths.ts
 import { join } from "node:path";
@@ -13,6 +14,25 @@ var CONFIG_FILE = join(CONFIG_DIR, "cloud-server.json");
 var MODE_FILE = join(CONFIG_DIR, "cloud-server-mode.json");
 var LOG_FILE = join(CONFIG_DIR, "cloud-server.log");
 
+// src/sandbox.ts
+var PORT_PLACEHOLDER = "{port}";
+function resolveOpenSandboxEndpoint(port, env = process.env) {
+  if (!env.OPENSANDBOX_ID?.trim()) return null;
+  const template = env.AONE_SANDBOX_ENDPOINT_TEMPLATE?.trim();
+  if (!template?.includes(PORT_PLACEHOLDER)) return null;
+  const rendered = template.replaceAll(PORT_PLACEHOLDER, String(port));
+  const endpoint = /^[a-z][a-z\d+.-]*:\/\//i.test(rendered) ? rendered : `https://${rendered}`;
+  try {
+    const parsed = new URL(endpoint);
+    if (!["http:", "https:", "ws:", "wss:"].includes(parsed.protocol) || !parsed.hostname) {
+      return null;
+    }
+    return parsed.toString();
+  } catch {
+    return null;
+  }
+}
+
 // src/index.ts
 import {
   isAgentHelloMessage,
@@ -484,6 +504,15 @@ var CloudServer = class {
     return "localhost";
   }
   async getSandboxPublicUrl(port) {
+    if (process.env.OPENSANDBOX_ID?.trim()) {
+      const endpoint = resolveOpenSandboxEndpoint(port);
+      if (!endpoint) {
+        console.warn(
+          "[CloudServer] OpenSandbox detected, but AONE_SANDBOX_ENDPOINT_TEMPLATE is missing, invalid, or does not contain {port}."
+        );
+      }
+      return endpoint;
+    }
     if (!process.env.AONE_SANDBOX_ID) {
       return null;
     }
@@ -507,14 +536,8 @@ var CloudServer = class {
   }
   writeConfigFile(info) {
     try {
-      if (!existsSync(CONFIG_DIR)) {
-        mkdirSync(CONFIG_DIR, { recursive: true, mode: 448 });
-      }
       const config = { server: info.localUrl, ...info };
-      writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), {
-        encoding: "utf-8",
-        mode: 384
-      });
+      writeRecord(CONFIG_FILE, config);
       if (process.platform !== "win32") {
         chmodSync(CONFIG_DIR, 448);
         chmodSync(CONFIG_FILE, 384);

package/dist/cli.d.ts

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 import type { CloudServerOptions } from './index.js';
 import { type CloudServerCommand } from './qoder.js';
 export interface ParsedCloudServerArgs {

package/dist/cli.js

@@ -4,16 +4,14 @@ import {
   CloudServer,
   LOG_FILE,
   MODE_FILE
-} from "./chunks/chunk-DCTZIDJ7.js";
+} from "./chunks/chunk-AFZKMZDL.js";
 
 // src/cli.ts
-import path from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
 import { Command, CommanderError, InvalidArgumentError } from "commander";
 
 // src/daemon.ts
 import { fileURLToPath } from "node:url";
-import { createDaemon, readRecord, removeRecord } from "@mearl/daemon-core";
+import { createDaemon, readRecord, removeRecordIfPid } from "@mearl/daemon-core";
 var SCRIPT_PATH = fileURLToPath(import.meta.url);
 function formatConnectInfo(record) {
   const config = record;
@@ -71,7 +69,7 @@ async function runForeground(options) {
     console.log(`
 [CloudServer] Received ${signal}, shutting down...`);
     await server.stop();
-    removeRecord(CONFIG_FILE);
+    removeRecordIfPid(CONFIG_FILE, process.pid);
     process.exit(0);
   };
   process.on("SIGINT", () => void shutdown("SIGINT"));
@@ -178,7 +176,7 @@ async function runQoderCloudServerCommand(command, dependencies) {
 }
 
 // src/cli.ts
-var CLOUD_SERVER_VERSION = true ? "2.9.5" : "unknown";
+var CLOUD_SERVER_VERSION = true ? "2.10.0" : "unknown";
 var COMMANDS = ["start", "stop", "restart", "status", "logs"];
 var START_OPTION_NAMES = /* @__PURE__ */ new Set([
   "foreground",
@@ -355,16 +353,11 @@ async function main(argv = process.argv.slice(2)) {
   }
   return 0;
 }
-var currentFile = fileURLToPath2(import.meta.url);
-if (process.argv[1] && path.resolve(process.argv[1]) === currentFile) {
-  main().then((code) => {
-    process.exitCode = code;
-  }).catch((error) => {
-    console.error("[CloudServer] Fatal error:", error);
-    process.exitCode = 1;
-  });
+
+// src/bin.ts
+try {
+  process.exitCode = await main();
+} catch (error) {
+  console.error("[CloudServer] Fatal error:", error);
+  process.exitCode = 1;
 }
-export {
-  main,
-  parseCloudServerArgs
-};

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   CloudServer
-} from "./chunks/chunk-DCTZIDJ7.js";
+} from "./chunks/chunk-AFZKMZDL.js";
 export {
   CloudServer
 };

package/dist/sandbox.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Resolve the ingress endpoint injected into an OpenSandbox environment.
+ * The template is authoritative because its routing prefix cannot be derived
+ * from the container hostname.
+ */
+export declare function resolveOpenSandboxEndpoint(port: number, env?: NodeJS.ProcessEnv): string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/cloud-server",
-  "version": "2.9.5",
+  "version": "2.10.0",
   "description": "Cloud WebSocket server for Mearl — bridges cloud agents to local connectors",
   "type": "module",
   "engines": {
@@ -35,9 +35,9 @@
   "dependencies": {
     "commander": "^15.0.0",
     "ws": "^8.18.0",
-    "@mearl/cloud-types": "2.9.5",
-    "@mearl/client": "2.9.5",
-    "@mearl/daemon-core": "2.9.5"
+    "@mearl/client": "2.10.0",
+    "@mearl/cloud-types": "2.10.0",
+    "@mearl/daemon-core": "2.10.0"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",