jishushell 0.0.1 → 0.4.2-beta2

package/dist/server.js

@@ -0,0 +1,392 @@
+import Fastify from "fastify";
+import fastifyStatic from "@fastify/static";
+import { join, dirname } from "path";
+import { existsSync, realpathSync } from "fs";
+import { fileURLToPath } from "url";
+import { request as httpRequest } from "http";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+import { ensureDirs, ensurePanelConfig, getPanelConfig } from "./config.js";
+import { verifyToken } from "./auth.js";
+import { authRoutes } from "./routes/auth.js";
+import { instanceRoutes } from "./routes/instances.js";
+import { systemRoutes } from "./routes/system.js";
+import { setupRoutes } from "./routes/setup.js";
+import * as llmProxy from "./services/llm-proxy/index.js";
+import * as nomadManager from "./services/nomad-manager.js";
+import * as instanceManager from "./services/instance-manager.js";
+import * as setupManager from "./services/setup-manager.js";
+import { PROXY_IDENTITY_HEADERS } from "./constants.js";
+const PUBLIC_PATHS = new Set(["/api/auth/status", "/api/auth/init", "/api/auth/login", "/api/setup/status"]);
+export async function createServer(options = {}) {
+    const port = options.port || 8090;
+    const host = options.host || "0.0.0.0";
+    ensureDirs();
+    llmProxy.rebuildTokenMap();
+    setupManager.loadNomadToken();
+    const app = Fastify({
+        logger: true,
+        bodyLimit: 1048576,
+    });
+    // Allow empty JSON body for POST requests
+    app.addContentTypeParser("application/json", { parseAs: "string" }, (req, body, done) => {
+        if (!body || body.length === 0) {
+            done(null, {});
+        }
+        else {
+            try {
+                done(null, JSON.parse(body));
+            }
+            catch (e) {
+                done(e, undefined);
+            }
+        }
+    });
+    // Auth middleware
+    app.addHook("onRequest", async (request, reply) => {
+        const path = request.url.split("?")[0];
+        if (!path.startsWith("/api/") || PUBLIC_PATHS.has(path))
+            return;
+        // Allow gateway proxy without panel auth (gateway has its own auth),
+        // but verify the instance actually exists to prevent probing.
+        if (/^\/api\/instances\/[^/]+\/gateway(\/|$)/.test(path)) {
+            const id = path.match(/^\/api\/instances\/([^/]+)\/gateway/)?.[1];
+            if (!id || !instanceManager.getInstance(id)) {
+                return reply.status(404).send({ detail: "Instance not found" });
+            }
+            return;
+        }
+        // Check Authorization header first, then fall back to httpOnly cookie
+        const authHeader = request.headers.authorization || "";
+        const match = authHeader.match(/^Bearer\s+(\S+)$/);
+        let token = match?.[1] || "";
+        if (!token) {
+            const cookie = request.headers.cookie || "";
+            const cookieMatch = cookie.match(/(?:^|;\s*)jishushell_session=([^;]*)/);
+            token = cookieMatch?.[1] || "";
+        }
+        if (!token || token.length > 4096 || !verifyToken(token)) {
+            return reply.status(401).send({ detail: "Unauthorized" });
+        }
+    });
+    // Global error handler — hide stack traces in production
+    app.setErrorHandler((error, _request, reply) => {
+        const statusCode = error.statusCode || 500;
+        if (statusCode >= 500) {
+            console.error("[server] Internal error:", error.message || error);
+        }
+        reply.status(statusCode).send({
+            detail: statusCode >= 500 ? "Internal server error" : (error.message || "Error"),
+        });
+    });
+    // Register proxy routes before auth middleware (proxy uses its own token auth)
+    await llmProxy.registerProxyRoutes(app);
+    // Register routes
+    // authRoutes needs a rebind callback so /api/auth/init can switch from 127.0.0.1 → 0.0.0.0
+    // without calling process.exit(). We define the callback after listen() and patch it in below.
+    let _rebind = null;
+    await app.register(authRoutes, {
+        getRebind: () => _rebind,
+    });
+    await app.register(instanceRoutes);
+    await app.register(systemRoutes);
+    await app.register(setupRoutes);
+    // Serve frontend static files
+    // Look for frontend dist in multiple locations
+    const resolvedDir = existsSync(__dirname) ? realpathSync(__dirname) : __dirname;
+    const frontendCandidates = [
+        join(resolvedDir, "..", "public"), // npm package: dist/ + public/ siblings
+        join(resolvedDir, "..", "frontend", "dist"), // dev: project root legacy path
+    ];
+    let frontendDir = "";
+    for (const candidate of frontendCandidates) {
+        if (existsSync(join(candidate, "index.html"))) {
+            frontendDir = candidate;
+            break;
+        }
+    }
+    if (frontendDir) {
+        // Serve /assets/ directory
+        const assetsDir = join(frontendDir, "assets");
+        if (existsSync(assetsDir)) {
+            await app.register(fastifyStatic, {
+                root: assetsDir,
+                prefix: "/assets/",
+                decorateReply: false,
+            });
+        }
+        // Serve other static files and SPA fallback
+        await app.register(fastifyStatic, {
+            root: frontendDir,
+            prefix: "/",
+            decorateReply: true,
+            wildcard: false,
+        });
+        // SPA fallback: serve index.html for non-API, non-asset routes
+        app.setNotFoundHandler(async (request, reply) => {
+            const path = request.url.split("?")[0];
+            if (path.startsWith("/api/")) {
+                return reply.status(404).send({ detail: "Not found" });
+            }
+            if (path.startsWith("/proxy/")) {
+                return reply.status(404).send({
+                    error: { message: "proxy route not found", type: "server_error" },
+                });
+            }
+            return reply.sendFile("index.html");
+        });
+    }
+    // Auto-start Nomad-managed instances on startup
+    app.addHook("onReady", async () => {
+        setTimeout(async () => {
+            try {
+                ensurePanelConfig();
+                const config = getPanelConfig();
+                if (config.service_manager === "nomad") {
+                    const nomadResult = await setupManager.startNomad();
+                    if (!nomadResult.ok) {
+                        console.error(`[startup] Nomad not available: ${nomadResult.error || nomadResult.message}`);
+                    }
+                    else {
+                        console.log(`[startup] Nomad: ${nomadResult.message}`);
+                    }
+                    // Auto-start stopped instances that were running before jishushell was restarted.
+                    // Running instances are left alone — no forced restart to avoid unnecessary disruption.
+                    try {
+                        for (const inst of instanceManager.listInstances()) {
+                            if (!inst.id)
+                                continue;
+                            const status = await nomadManager.getStatus(inst.id);
+                            if (status.status === "running") {
+                                continue;
+                            }
+                            else if (status.status === "pending" || status.status === "stopped") {
+                                const shouldStart = await nomadManager.shouldAutoStart(inst.id);
+                                if (shouldStart) {
+                                    console.log(`[startup] Auto-starting Nomad instance ${inst.id} (was running before restart)...`);
+                                    await nomadManager.startInstance(inst.id);
+                                }
+                            }
+                        }
+                        console.log("[startup] Nomad instances started/restarted.");
+                    }
+                    catch (e) {
+                        console.error("[startup] Nomad restart failed:", e);
+                    }
+                }
+            }
+            catch (e) {
+                console.log(`[startup] Auto-start failed: ${e}`);
+            }
+        }, 0);
+    });
+    await app.listen({ port, host });
+    // Assign the rebind implementation now that the server is listening.
+    // Called by /api/auth/init to switch from 127.0.0.1 → 0.0.0.0 in-process.
+    _rebind = async (newHost) => {
+        await new Promise((resolve, reject) => {
+            app.server.close((err) => { if (err)
+                reject(err);
+            else
+                resolve(); });
+        });
+        await new Promise((resolve, reject) => {
+            app.server.listen(port, newHost, () => {
+                console.log(`[server] Rebound to http://${newHost}:${port}`);
+                resolve();
+            });
+            app.server.once("error", reject);
+        });
+    };
+    // Track active WebSocket proxy sockets for graceful shutdown
+    const activeWsSockets = new Set();
+    // Handle WebSocket upgrades directly on the HTTP server, bypassing Fastify's
+    // request lifecycle. Fastify's internal headersTimeout (73s) kills hijacked
+    // sockets, so we intercept upgrades before Fastify sees them.
+    const GATEWAY_WS_RE = /^\/api\/instances\/([a-z0-9][a-z0-9-]{0,62})\/gateway(?:\/(.*))?$/;
+    app.server.on("upgrade", async (req, socket, head) => {
+        const url = req.url || "";
+        const path = url.split("?")[0];
+        const match = path.match(GATEWAY_WS_RE);
+        if (!match) {
+            // Not a gateway WebSocket — let it drop (Fastify doesn't handle WS natively)
+            socket.destroy();
+            return;
+        }
+        // Defense-in-depth: validate Origin header for WebSocket upgrades.
+        // Require Origin for non-loopback clients; gateway has its own token auth as primary.
+        const origin = req.headers.origin || "";
+        const remoteIp = socket.remoteAddress || "";
+        const isLoopback = remoteIp === "127.0.0.1" || remoteIp === "::1" || remoteIp === "::ffff:127.0.0.1";
+        if (!origin && !isLoopback) {
+            socket.write("HTTP/1.1 403 Forbidden\r\n\r\n");
+            socket.destroy();
+            return;
+        }
+        if (origin) {
+            const reqHost = req.headers.host || "";
+            try {
+                const originHost = new URL(origin).host.toLowerCase();
+                if (originHost !== reqHost.toLowerCase()) {
+                    socket.write("HTTP/1.1 403 Forbidden\r\n\r\n");
+                    socket.destroy();
+                    return;
+                }
+            }
+            catch {
+                socket.write("HTTP/1.1 403 Forbidden\r\n\r\n");
+                socket.destroy();
+                return;
+            }
+        }
+        const id = match[1];
+        const inst = instanceManager.getInstance(id);
+        if (!inst) {
+            socket.destroy();
+            return;
+        }
+        const gwPort = instanceManager.getGatewayPort(id);
+        const gwHost = await instanceManager.getGatewayHost(id);
+        const suffix = match[2] || "";
+        const qs = url.includes("?") ? url.slice(url.indexOf("?")) : "";
+        const targetPath = `/${suffix}${qs}`;
+        const upstreamHeaders = {};
+        for (const [key, value] of Object.entries(req.headers)) {
+            if (value === undefined)
+                continue;
+            const lower = key.toLowerCase();
+            if (lower === "host" ||
+                PROXY_IDENTITY_HEADERS.has(lower) ||
+                // Strip panel auth credentials — do not leak to downstream OpenClaw gateway
+                lower === "cookie" ||
+                lower === "authorization")
+                continue;
+            upstreamHeaders[key] = value;
+        }
+        // Prevent any HTTP-level timeouts from killing this long-lived connection
+        socket.setTimeout?.(0);
+        socket.setNoDelay?.(true);
+        socket.setKeepAlive?.(true, 30000);
+        let proxyReq;
+        try {
+            proxyReq = httpRequest({
+                hostname: gwHost,
+                port: gwPort,
+                path: targetPath,
+                method: "GET",
+                timeout: 10000, // 10s timeout for upstream upgrade handshake
+                headers: {
+                    ...upstreamHeaders,
+                    host: `${gwHost}:${gwPort}`,
+                },
+            });
+        }
+        catch {
+            try {
+                socket.destroy();
+            }
+            catch { }
+            activeWsSockets.delete(socket);
+            return;
+        }
+        proxyReq.on("timeout", () => {
+            proxyReq.destroy();
+            socket.destroy();
+        });
+        proxyReq.on("upgrade", (_res, proxySocket, proxyHead) => {
+            proxySocket.setTimeout(0);
+            proxySocket.setNoDelay(true);
+            proxySocket.setKeepAlive(true, 30000);
+            // Pause upstream until the 101 handshake is flushed to the client
+            proxySocket.pause();
+            // Build and send 101 response — forward all sec-websocket-* headers
+            let handshake = "HTTP/1.1 101 Switching Protocols\r\nUpgrade: websocket\r\nConnection: Upgrade\r\n";
+            for (const [k, v] of Object.entries(_res.headers)) {
+                if (v !== undefined && k.toLowerCase().startsWith("sec-websocket-")) {
+                    handshake += `${k}: ${v}\r\n`;
+                }
+            }
+            handshake += "\r\n";
+            socket.write(handshake);
+            if (head.length > 0)
+                proxySocket.write(head);
+            if (proxyHead.length > 0)
+                socket.write(proxyHead);
+            // Bidirectional pipe: forward all WebSocket frames without interception.
+            // OpenClaw manages its own upgrades inside the container.
+            proxySocket.pipe(socket);
+            socket.pipe(proxySocket);
+            proxySocket.resume();
+            activeWsSockets.add(socket);
+            activeWsSockets.add(proxySocket);
+            const release = (s) => {
+                activeWsSockets.delete(s);
+            };
+            const fail = () => {
+                try {
+                    proxySocket.destroy();
+                }
+                catch { }
+                try {
+                    socket.destroy();
+                }
+                catch { }
+                release(socket);
+                release(proxySocket);
+            };
+            // Do not destroy the peer on normal close. The upstream may have already
+            // sent a WebSocket close frame, and force-destroying the other side turns
+            // that graceful close into a browser-visible 1006.
+            proxySocket.on("close", () => {
+                release(proxySocket);
+                try {
+                    if (!socket.destroyed && !socket.writableEnded)
+                        socket.end();
+                }
+                catch { }
+            });
+            socket.on("close", () => {
+                release(socket);
+                try {
+                    if (!proxySocket.destroyed && !proxySocket.writableEnded)
+                        proxySocket.end();
+                }
+                catch { }
+            });
+            proxySocket.on("error", fail);
+            socket.on("error", fail);
+        });
+        proxyReq.on("error", () => {
+            try {
+                socket.write("HTTP/1.1 502 Bad Gateway\r\nConnection: close\r\n\r\n");
+            }
+            catch { }
+            socket.destroy();
+            activeWsSockets.delete(socket);
+        });
+        proxyReq.end();
+    });
+    llmProxy.setProxyPort(port);
+    setupManager.setServerPort(port);
+    nomadManager.setPanelPort(port);
+    console.log(`JishuShell listening on http://${host}:${port}`);
+    // Graceful shutdown — let in-flight requests finish before exiting
+    const shutdown = async () => {
+        console.log("[server] Shutting down gracefully...");
+        llmProxy.flushUsage();
+        // Destroy all active WebSocket proxy connections
+        for (const s of activeWsSockets) {
+            try {
+                s.destroy();
+            }
+            catch { }
+        }
+        activeWsSockets.clear();
+        await app.close();
+        process.exit(0);
+    };
+    process.on("SIGTERM", shutdown);
+    process.on("SIGINT", shutdown);
+    return app;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,MAAM,CAAC;AAI9C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,QAAQ,MAAM,+BAA+B,CAAC;AAC1D,OAAO,KAAK,YAAY,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,eAAe,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,YAAY,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC;AAE7G,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAA4C,EAAE;IAC/E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;IAClC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;IAEvC,UAAU,EAAE,CAAC;IACb,QAAQ,CAAC,eAAe,EAAE,CAAC;IAC3B,YAAY,CAAC,cAAc,EAAE,CAAC;IAE9B,MAAM,GAAG,GAAG,OAAO,CAAC;QAClB,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,OAAO;KACnB,CAAC,CAAC;IAEH,0CAA0C;IAC1C,GAAG,CAAC,oBAAoB,CAAC,kBAAkB,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QACtF,IAAI,CAAC,IAAI,IAAK,IAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAc,CAAC,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,CAAM,EAAE,CAAC;gBAChB,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,kBAAkB;IAClB,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAChD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAChE,qEAAqE;QACrE,8DAA8D;QAC9D,IAAI,yCAAyC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,qCAAqC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAClE,IAAI,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC5C,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;YAClE,CAAC;YACD,OAAO;QACT,CAAC;QACD,sEAAsE;QACtE,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACnD,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;YAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;YACzE,KAAK,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,yDAAyD;IACzD,GAAG,CAAC,eAAe,CAAC,CAAC,KAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;QAClD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,GAAG,CAAC;QAC3C,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;QACpE,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;YAC5B,MAAM,EAAE,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC;SACjF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,+EAA+E;IAC/E,MAAM,QAAQ,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAExC,kBAAkB;IAClB,2FAA2F;IAC3F,+FAA+F;IAC/F,IAAI,OAAO,GAAgD,IAAI,CAAC;IAChE,MAAM,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE;QAC7B,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO;KACzB,CAAC,CAAC;IACH,MAAM,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACnC,MAAM,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACjC,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAEhC,8BAA8B;IAC9B,+CAA+C;IAC/C,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChF,MAAM,kBAAkB,GAAG;QACzB,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAS,wCAAwC;QAClF,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,gCAAgC;KAC9E,CAAC;IAEF,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,KAAK,MAAM,SAAS,IAAI,kBAAkB,EAAE,CAAC;QAC3C,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC;YAC9C,WAAW,GAAG,SAAS,CAAC;YACxB,MAAM;QACR,CAAC;IACH,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,2BAA2B;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC9C,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,MAAM,GAAG,CAAC,QAAQ,CAAC,aAAa,EAAE;gBAChC,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,UAAU;gBAClB,aAAa,EAAE,KAAK;aACrB,CAAC,CAAC;QACL,CAAC;QAED,4CAA4C;QAC5C,MAAM,GAAG,CAAC,QAAQ,CAAC,aAAa,EAAE;YAChC,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,GAAG;YACX,aAAa,EAAE,IAAI;YACnB,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;QAEH,+DAA+D;QAC/D,GAAG,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACvC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7B,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;YACzD,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC/B,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBAC5B,KAAK,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE,IAAI,EAAE,cAAc,EAAE;iBAClE,CAAC,CAAC;YACL,CAAC;YACD,OAAO,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,gDAAgD;IAChD,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QAChC,UAAU,CAAC,KAAK,IAAI,EAAE;YACpB,IAAI,CAAC;gBACH,iBAAiB,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;gBAChC,IAAI,MAAM,CAAC,eAAe,KAAK,OAAO,EAAE,CAAC;oBACvC,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,CAAC;oBACpD,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC;wBACpB,OAAO,CAAC,KAAK,CAAC,kCAAkC,WAAW,CAAC,KAAK,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;oBAC9F,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,GAAG,CAAC,oBAAoB,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;oBACzD,CAAC;oBACD,kFAAkF;oBAClF,wFAAwF;oBACxF,IAAI,CAAC;wBACH,KAAK,MAAM,IAAI,IAAI,eAAe,CAAC,aAAa,EAAE,EAAE,CAAC;4BACnD,IAAI,CAAC,IAAI,CAAC,EAAE;gCAAE,SAAS;4BACvB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;4BACrD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gCAChC,SAAS;4BACX,CAAC;iCAAM,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gCACtE,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gCAChE,IAAI,WAAW,EAAE,CAAC;oCAChB,OAAO,CAAC,GAAG,CAAC,0CAA0C,IAAI,CAAC,EAAE,kCAAkC,CAAC,CAAC;oCACjG,MAAM,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gCAC5C,CAAC;4BACH,CAAC;wBACH,CAAC;wBACD,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;oBAC9D,CAAC;oBAAC,OAAO,CAAC,EAAE,CAAC;wBACX,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,CAAC,CAAC,CAAC;oBACtD,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,EAAE,CAAC,CAAC;YACnD,CAAC;QAEH,CAAC,EAAE,CAAC,CAAC,CAAC;IACR,CAAC,CAAC,CAAC;IAEH,MAAM,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjC,qEAAqE;IACrE,0EAA0E;IAC1E,OAAO,GAAG,KAAK,EAAE,OAAe,EAAE,EAAE;QAClC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,GAAG;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;gBAAM,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE;gBACpC,OAAO,CAAC,GAAG,CAAC,8BAA8B,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;gBAC7D,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,6DAA6D;IAC7D,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1C,6EAA6E;IAC7E,4EAA4E;IAC5E,8DAA8D;IAC9D,MAAM,aAAa,GAAG,mEAAmE,CAAC;IAC1F,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,GAAoB,EAAE,MAAc,EAAE,IAAY,EAAE,EAAE;QACpF,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,6EAA6E;YAC7E,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QAED,mEAAmE;QACnE,sFAAsF;QACtF,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAI,MAAiB,CAAC,aAAa,IAAI,EAAE,CAAC;QACxD,MAAM,UAAU,GAAG,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,kBAAkB,CAAC;QACrG,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YAC3B,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAC/C,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACtD,IAAI,UAAU,KAAK,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;oBACzC,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;oBAC/C,MAAM,CAAC,OAAO,EAAE,CAAC;oBACjB,OAAO;gBACT,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;gBAC/C,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO;YACT,CAAC;QACH,CAAC;QAED,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,IAAI,GAAG,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;YAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAAC,OAAO;QAAC,CAAC;QACxC,MAAM,MAAM,GAAG,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,MAAM,UAAU,GAAG,IAAI,MAAM,GAAG,EAAE,EAAE,CAAC;QACrC,MAAM,eAAe,GAAsC,EAAE,CAAC;QAC9D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACvD,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAClC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YAChC,IACE,KAAK,KAAK,MAAM;gBAChB,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC;gBACjC,4EAA4E;gBAC5E,KAAK,KAAK,QAAQ;gBAClB,KAAK,KAAK,eAAe;gBACzB,SAAS;YACX,eAAe,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC/B,CAAC;QAED,0EAA0E;QACzE,MAAc,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAc,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;QAClC,MAAc,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAE5C,IAAI,QAAwC,CAAC;QAC7C,IAAI,CAAC;YACH,QAAQ,GAAG,WAAW,CAAC;gBACrB,QAAQ,EAAE,MAAM;gBAChB,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,KAAK,EAAE,6CAA6C;gBAC7D,OAAO,EAAE;oBACP,GAAG,eAAe;oBAClB,IAAI,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE;iBAC5B;aACF,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC;gBAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YAClC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YAC1B,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE;YACtD,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC1B,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC7B,WAAW,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAEtC,kEAAkE;YAClE,WAAW,CAAC,KAAK,EAAE,CAAC;YAEpB,oEAAoE;YACpE,IAAI,SAAS,GAAG,mFAAmF,CAAC;YACpG,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClD,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBACpE,SAAS,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC;gBAChC,CAAC;YACH,CAAC;YACD,SAAS,IAAI,MAAM,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACxB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAElD,yEAAyE;YACzE,0DAA0D;YAC1D,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAEzB,WAAW,CAAC,MAAM,EAAE,CAAC;YAErB,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC5B,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACjC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,EAAE;gBAC5B,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC5B,CAAC,CAAC;YACF,MAAM,IAAI,GAAG,GAAG,EAAE;gBAChB,IAAI,CAAC;oBAAC,WAAW,CAAC,OAAO,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC;gBACvC,IAAI,CAAC;oBAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC;gBAClC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAChB,OAAO,CAAC,WAAW,CAAC,CAAC;YACvB,CAAC,CAAC;YAEF,yEAAyE;YACzE,0EAA0E;YAC1E,mDAAmD;YACnD,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBAC3B,OAAO,CAAC,WAAW,CAAC,CAAC;gBACrB,IAAI,CAAC;oBAAC,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,aAAa;wBAAE,MAAM,CAAC,GAAG,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC;YAChF,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACtB,OAAO,CAAC,MAAM,CAAC,CAAC;gBAChB,IAAI,CAAC;oBAAC,IAAI,CAAC,WAAW,CAAC,SAAS,IAAI,CAAC,WAAW,CAAC,aAAa;wBAAE,WAAW,CAAC,GAAG,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC;YAC/F,CAAC,CAAC,CAAC;YACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC9B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACxB,IAAI,CAAC;gBAAC,MAAM,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YACvF,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,GAAG,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,kCAAkC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;IAE9D,mEAAmE;IACnE,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QACpD,QAAQ,CAAC,UAAU,EAAE,CAAC;QACtB,iDAAiD;QACjD,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;YAAC,IAAI,CAAC;gBAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QAAC,CAAC;QAClE,eAAe,CAAC,KAAK,EAAE,CAAC;QACxB,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE/B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/services/instance-manager.d.ts

@@ -0,0 +1,67 @@
+type ConfigChangeListener = (instanceId: string) => void;
+export declare function onConfigChange(listener: ConfigChangeListener): () => void;
+declare function instanceDir(instanceId: string): string;
+export declare function getResolvedOpenclawBin(): string;
+/**
+ * When jishushell runs as root (e.g. systemd service), returns the actual
+ * non-root user that should own instance files and run openclaw processes.
+ * Returns null when not running as root or when no suitable non-root user is found.
+ */
+export declare function resolveServiceUser(): {
+    username: string;
+    uid: number;
+    gid: number;
+} | null;
+export declare function parseEnvFile(path: string): Record<string, string>;
+export declare function updateEnvFile(path: string, updates: Record<string, string>): void;
+export declare function inferProviderApiKeyEnvName(providerId: string): string;
+export declare const CHANNEL_PLUGIN_MAP: Record<string, string>;
+/** Check if a channel plugin is installed for an instance. */
+export declare function isChannelPluginInstalled(instanceId: string, channelId: string): boolean;
+/**
+ * Install a single channel plugin on the host.
+ * This is the unified entry point for all plugin installation — never use docker exec.
+ */
+export declare function installChannelPlugin(instanceId: string, channelId: string): Promise<void>;
+export declare function listInstances(): Record<string, any>[];
+export declare function getInstance(instanceId: string): Record<string, any> | null;
+export declare function createInstance(instanceId: string, name: string, description?: string, cloneFrom?: string, openclawHome?: string): Promise<Record<string, any>>;
+export declare function updateInstance(instanceId: string, name?: string, description?: string): Record<string, any> | null;
+export declare function deleteInstance(instanceId: string): {
+    ok: boolean;
+    warnings?: string[];
+};
+export declare function getConfig(instanceId: string): Record<string, any> | null;
+export declare function getStoredConfig(instanceId: string): Record<string, any> | null;
+export declare function saveConfig(instanceId: string, config: Record<string, any>): boolean;
+export declare function getOpenclawHome(instanceId: string): string;
+export declare function saveFeishuCredentials(instanceId: string, creds: {
+    appId: string;
+    appSecret: string;
+    domain: string;
+    channelKey?: string;
+}): void;
+export declare function saveWeixinCredentials(instanceId: string, creds: {
+    accountId: string;
+    token: string;
+    baseUrl: string;
+    userId: string;
+}): void;
+/**
+ * Get connected WeChat accounts for an instance.
+ */
+export declare function getWeixinAccounts(instanceId: string): Array<{
+    accountId: string;
+    userId?: string;
+    savedAt?: string;
+}>;
+export declare function getOpenclawConfigPath(instanceId: string): string;
+export declare function getLegacyOpenclawConfigPath(instanceId: string): string;
+export declare function getInstanceRuntime(instanceId: string): Record<string, any>;
+export declare function getRuntimeEnvFiles(instanceId: string): string[];
+export declare function getGatewayPort(instanceId: string): number;
+export declare function getGatewayHost(instanceId: string): Promise<string>;
+export declare function findInstancesSharingOpenclawHome(instanceId: string): string[];
+export declare function findInstancesSharingGatewayPort(instanceId: string): string[];
+export declare function getRuntimeEnv(instanceId: string): Record<string, string>;
+export { instanceDir as getInstanceDir };