robopark 3.1.1 → 3.1.2

package/dist/robopark/standalone.js

@@ -150,6 +150,7 @@ export async function connectDevice(token, opts = {}) {
         deviceToken: enrolled.device_token,
         name,
         connectedAt: new Date().toISOString(),
+        controlPort: pairing.controlPort,
     };
     atomicJson(CONNECTION_PATH, connection);
     writeFileSync(join(STATE_DIR, 'device_token'), connection.deviceToken, { encoding: 'utf8', mode: 0o600 });
@@ -196,6 +197,53 @@ function positiveInteger(value, fallback, label) {
         throw new Error(`${label} must be a positive integer`);
     return parsed;
 }
+function openBrowser(url) {
+    // Use detached platform-native launchers so this CLI remains usable from
+    // terminals and does not inherit browser stdio or lifecycle.
+    const command = process.platform === 'win32'
+        ? 'cmd.exe'
+        : process.platform === 'darwin'
+            ? 'open'
+            : 'xdg-open';
+    const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];
+    try {
+        spawn(command, args, { detached: true, stdio: 'ignore', windowsHide: true }).unref();
+    }
+    catch (err) {
+        console.log(chalk.yellow(`  ⚠ could not open browser: ${err instanceof Error ? err.message : String(err)}`));
+    }
+}
+/**
+ * Opens the character-specific ElevenLabs voice-join page (served by the Park
+ * Control Center, not the scheduler) for the device just configured. Best
+ * effort only: a browser-less robot host or an unreachable control server
+ * must never fail `robopark start`/`robopark connect`.
+ */
+async function openCharacterCallPage(connection, character) {
+    try {
+        const preset = await jsonRequest(`${connection.schedulerUrl}/api/character-presets/${encodeURIComponent(character)}`, {});
+        if (!preset.elevenlabs_agent_id) {
+            console.log(chalk.yellow(`  ⚠ character "${character}" has no ElevenLabs agent configured; not opening a call page.`));
+            return;
+        }
+        const controlPort = connection.controlPort ?? 47913;
+        const controlHost = new URL(connection.schedulerUrl).hostname;
+        const params = new URLSearchParams({
+            character,
+            agent_id: preset.elevenlabs_agent_id,
+            mode: 'production',
+            robot: connection.deviceId,
+        });
+        if (preset.elevenlabs_branch_id)
+            params.set('branch_id', preset.elevenlabs_branch_id);
+        const url = `http://${controlHost}:${controlPort}/voice-join.html?${params.toString()}`;
+        console.log(`  call page: ${chalk.cyan(url)}`);
+        openBrowser(url);
+    }
+    catch (err) {
+        console.log(chalk.yellow(`  ⚠ could not open the character call page: ${err instanceof Error ? err.message : String(err)}`));
+    }
+}
 export async function startDevice(opts) {
     const connection = readConnection();
     const desired = {
@@ -216,6 +264,9 @@ export async function startDevice(opts) {
     }
     await updateDeviceConfiguration(desired);
     atomicJson(DESIRED_PATH, desired);
+    if (desired.character) {
+        await openCharacterCallPage(connection, desired.character);
+    }
     if (opts.foreground) {
         await superviseDevice(DESIRED_PATH);
         return;
@@ -424,20 +475,36 @@ export async function gatewayStart(opts) {
     }
     const schedulerUrl = localPublicUrl(host, port, opts.publicUrl);
     const healthUrl = `http://127.0.0.1:${port}`;
+    const controlHealthUrl = `http://127.0.0.1:${controlPort}/fed/ui-build`;
     const deadline = Date.now() + 30_000;
-    while (!(await schedulerHealthy(healthUrl, 1_000))) {
-        if (Date.now() >= deadline)
-            throw new Error(`gateway did not become healthy at ${schedulerUrl}`);
+    let schedulerReady = false;
+    let controlReady = false;
+    while (!schedulerReady || !controlReady) {
+        [schedulerReady, controlReady] = await Promise.all([
+            schedulerHealthy(healthUrl, 1_000),
+            fetch(controlHealthUrl, { signal: AbortSignal.timeout(1_000) })
+                .then(async (response) => {
+                if (!response.ok)
+                    return false;
+                const body = await response.json();
+                return body.owner === 'robopark';
+            })
+                .catch(() => false),
+        ]);
+        if (Date.now() >= deadline) {
+            throw new Error(`gateway did not become healthy (scheduler ${port}: ${schedulerReady ? 'ready' : 'down'}, `
+                + `Control Center ${controlPort}: ${controlReady ? 'ready' : 'down'})`);
+        }
         await wait(500);
     }
-    const token = await createGatewayTokenAt(healthUrl, schedulerUrl);
+    const token = await createGatewayTokenAt(healthUrl, schedulerUrl, controlPort);
     const controlHost = new URL(schedulerUrl).hostname;
     console.log(`  Park Control Center: ${chalk.cyan(`http://${controlHost}:${controlPort}/`)}`);
     console.log(chalk.bold('\n  Connect a device'));
     console.log(`  ${chalk.cyan(`robopark connect ${token}`)}`);
     console.log(chalk.dim('  This pairing token expires in 24 hours. Connected devices keep their own durable credentials.\n'));
 }
-async function createGatewayTokenAt(localUrl, publicUrl) {
+async function createGatewayTokenAt(localUrl, publicUrl, controlPort) {
     await jsonRequest(`${localUrl}/api/settings`, {
         method: 'PUT',
         headers: { 'content-type': 'application/json' },
@@ -449,6 +516,7 @@ async function createGatewayTokenAt(localUrl, publicUrl) {
         schedulerUrl: publicUrl,
         enrollmentToken: result.enrollment_token,
         expiresAt: new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString(),
+        controlPort,
     });
     atomicJson(GATEWAY_PATH, { schedulerUrl: publicUrl, pairingToken: pairing, createdAt: new Date().toISOString() });
     return pairing;
@@ -471,6 +539,14 @@ export async function runGatewayService(opts) {
             open: false,
             foreground: true,
         });
+        // roboparkServe wires the scheduler child's lifecycle handlers and then
+        // returns once it has launched. Keep this outer gateway process alive so
+        // the sibling Control Center server is not closed by the finally block.
+        await new Promise((resolve) => {
+            const stop = () => resolve();
+            process.once('SIGINT', stop);
+            process.once('SIGTERM', stop);
+        });
     }
     finally {
         control.close();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "robopark",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "description": "Standalone packaged RoboPark control center and supervised robot runtime.",
   "type": "module",
   "bin": {
@@ -33,7 +33,8 @@
     "commander": "^12.1.0",
     "conf": "^12.0.0",
     "execa": "^9.3.0",
-    "livekit-client": "^2.20.1"
+    "livekit-client": "^2.20.1",
+    "robopark": "^3.1.1"
   },
   "devDependencies": {
     "@types/node": "^20.14.0",