@downcity/city 1.1.1

package/bin/console/ConsoleClient.js

@@ -0,0 +1,258 @@
+/**
+ * InteractiveServer：交互式 Web UI 网关。
+ *
+ * 关键职责（中文）
+ * - 提供独立 UI 静态资源。
+ * - 将 `/api/*`、`/health`、`/webhook/*` 代理到主 Agent API。
+ * - 作为前端开发与运维观察入口，不承载核心业务状态。
+ */
+import { Hono } from 'hono';
+import { cors } from 'hono/cors';
+import { logger } from 'hono/logger';
+import http from 'node:http';
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * 交互式 Web 服务器
+ * 在独立端口上提供 Web UI，通过代理调用主 API 服务器
+ */
+/**
+ * InteractiveServer。
+ */
+export class ConsoleClient {
+    app;
+    context;
+    server = null;
+    publicDir;
+    version = 'unknown';
+    constructor(context) {
+        this.context = context;
+        // 关键点（中文）：旧的 ui 资源路径都统一回到 packages/downcity/public。
+        this.publicDir = path.join(__dirname, "../../public");
+        this.app = new Hono();
+        try {
+            const pkg = fs.readJsonSync(path.join(__dirname, "../../package.json"));
+            if (pkg && typeof pkg.version === 'string')
+                this.version = pkg.version;
+        }
+        catch {
+            // ignore
+        }
+        // 中间件
+        this.app.use('*', logger());
+        this.app.use('*', cors({
+            origin: '*',
+            allowMethods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
+            allowHeaders: ['Content-Type', 'Authorization'],
+        }));
+        // 设置路由
+        this.setupRoutes();
+    }
+    /**
+     * 注册交互式路由。
+     *
+     * 关键点（中文）
+     * - UI 资源本地提供，API 与 webhook 走反向代理。
+     * - 代理时过滤 Host/Content-Length 等头，避免上游校验冲突。
+     */
+    setupRoutes() {
+        // 静态文件服务 - 主页
+        this.app.get('/', async (c) => {
+            const indexPath = path.join(this.publicDir, 'index.html');
+            if (await fs.pathExists(indexPath)) {
+                const content = await fs.readFile(indexPath, 'utf-8');
+                return c.body(content, 200, {
+                    'Content-Type': 'text/html; charset=utf-8',
+                    'Cache-Control': 'no-cache',
+                });
+            }
+            return c.text('Downcity Interactive Web UI', 200);
+        });
+        // 静态文件服务 - CSS
+        this.app.get('/styles.css', async (c) => {
+            const cssPath = path.join(this.publicDir, 'styles.css');
+            if (await fs.pathExists(cssPath)) {
+                const content = await fs.readFile(cssPath, 'utf-8');
+                return c.body(content, 200, {
+                    'Content-Type': 'text/css; charset=utf-8',
+                    'Cache-Control': 'no-cache',
+                });
+            }
+            return c.text('Not Found', 404);
+        });
+        // 静态文件服务 - JS
+        this.app.get('/app.js', async (c) => {
+            const jsPath = path.join(this.publicDir, 'app.js');
+            if (await fs.pathExists(jsPath)) {
+                const content = await fs.readFile(jsPath, 'utf-8');
+                return c.body(content, 200, {
+                    'Content-Type': 'application/javascript; charset=utf-8',
+                    'Cache-Control': 'no-cache',
+                });
+            }
+            return c.text('Not Found', 404);
+        });
+        // API 代理 - 将所有 /api/* 请求代理到主 API 服务器
+        // 算法说明（中文）：保留请求方法与主体，头部做最小必要过滤后透传。
+        this.app.all('/api/*', async (c) => {
+            try {
+                const reqUrl = new URL(c.req.url);
+                const upstreamUrl = new URL(reqUrl.pathname + reqUrl.search, this.context.agentApiUrl).toString();
+                const method = c.req.method;
+                const headers = new Headers();
+                for (const [k, v] of c.req.raw.headers.entries()) {
+                    const key = k.toLowerCase();
+                    if (key === 'host' || key === 'content-length')
+                        continue;
+                    headers.set(k, v);
+                }
+                const body = method === 'GET' || method === 'HEAD'
+                    ? undefined
+                    : Buffer.from(await c.req.raw.arrayBuffer());
+                const response = await fetch(upstreamUrl, {
+                    method,
+                    headers,
+                    body,
+                });
+                const buf = Buffer.from(await response.arrayBuffer());
+                const contentType = response.headers.get('content-type') || 'application/octet-stream';
+                return new Response(buf, {
+                    status: response.status,
+                    headers: { 'Content-Type': contentType },
+                });
+            }
+            catch (error) {
+                return c.json({
+                    success: false,
+                    message: `代理请求失败: ${String(error)}`
+                }, { status: 500 });
+            }
+        });
+        // API 代理 - /health
+        this.app.get('/health', async (c) => {
+            try {
+                const upstreamUrl = new URL('/health', this.context.agentApiUrl).toString();
+                const response = await fetch(upstreamUrl);
+                const buf = Buffer.from(await response.arrayBuffer());
+                const contentType = response.headers.get('content-type') || 'application/json; charset=utf-8';
+                return new Response(buf, {
+                    status: response.status,
+                    headers: { 'Content-Type': contentType },
+                });
+            }
+            catch (error) {
+                return c.json({
+                    status: 'error',
+                    message: String(error)
+                }, { status: 500 });
+            }
+        });
+        // Webhook 代理
+        this.app.post('/webhook/:type', async (c) => {
+            try {
+                const upstreamUrl = new URL(`/webhook/${c.req.param('type')}`, this.context.agentApiUrl).toString();
+                const headers = new Headers();
+                for (const [k, v] of c.req.raw.headers.entries()) {
+                    const key = k.toLowerCase();
+                    if (key === 'host' || key === 'content-length')
+                        continue;
+                    headers.set(k, v);
+                }
+                if (!headers.get('content-type')) {
+                    headers.set('Content-Type', 'application/json');
+                }
+                const body = Buffer.from(await c.req.raw.arrayBuffer());
+                const response = await fetch(upstreamUrl, { method: 'POST', headers, body });
+                const buf = Buffer.from(await response.arrayBuffer());
+                const contentType = response.headers.get('content-type') || 'application/json; charset=utf-8';
+                return new Response(buf, {
+                    status: response.status,
+                    headers: { 'Content-Type': contentType },
+                });
+            }
+            catch (error) {
+                return c.json({
+                    success: false,
+                    message: String(error)
+                }, { status: 500 });
+            }
+        });
+        // 根路径提示
+        this.app.get('/info', (c) => {
+            return c.json({
+                name: 'Downcity Interactive Web UI',
+                version: this.version,
+                agentApiUrl: this.context.agentApiUrl,
+            });
+        });
+    }
+    /**
+     * 启动交互式 Web 服务。
+     */
+    async start(options) {
+        const { port, host } = options;
+        return new Promise((resolve) => {
+            const server = http.createServer(async (req, res) => {
+                try {
+                    const url = new URL(req.url || '/', `http://${host}:${port}`);
+                    const method = req.method || 'GET';
+                    // 收集 body
+                    const bodyBuffer = await new Promise((resolve, reject) => {
+                        let chunks = [];
+                        req.on('data', (chunk) => chunks.push(chunk));
+                        req.on('end', () => resolve(Buffer.concat(chunks)));
+                        req.on('error', reject);
+                    });
+                    // 创建请求适配
+                    const request = new Request(url.toString(), {
+                        method,
+                        headers: new Headers(req.headers),
+                        body: bodyBuffer.length > 0 ? bodyBuffer : undefined,
+                    });
+                    const response = await this.app.fetch(request);
+                    // 转换 Response 为 HTTP 响应
+                    res.statusCode = response.status;
+                    for (const [key, value] of response.headers.entries()) {
+                        res.setHeader(key, value);
+                    }
+                    const body = await response.text();
+                    res.end(body);
+                }
+                catch (error) {
+                    res.statusCode = 500;
+                    res.end('Internal Server Error');
+                }
+            });
+            this.server = server;
+            server.listen(port, host, () => {
+                console.log(`\n🌐 交互式 Web 界面已启动: http://${host}:${port}`);
+                console.log('📌 可用功能:');
+                console.log('   - 多 Context 消息历史');
+                console.log('   - Services 运行状态');
+                console.log('   - Tasks 执行过程与产物');
+                console.log('   - 实时日志查看');
+                console.log('');
+                resolve();
+            });
+        });
+    }
+    /**
+     * 停止交互式 Web 服务。
+     */
+    async stop() {
+        if (this.server) {
+            this.server.close();
+            console.log('🌐 交互式 Web 服务器已停止');
+        }
+    }
+    getApp() {
+        return this.app;
+    }
+}
+export function createConsoleClient(context) {
+    return new ConsoleClient(context);
+}
+//# sourceMappingURL=ConsoleClient.js.map

package/bin/console/ConsoleClient.js.map

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

package/bin/console/ConsoleGateway.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Console 网关。
+ *
+ * 关键点（中文）
+ * - UI 由 console 进程独立托管，不依赖单个 agent 启动参数。
+ * - 提供统一的多 agent 选择能力，并把 `/api/*` 代理到选中 agent。
+ */
+/**
+ * Console 启动参数。
+ */
+export interface ConsoleGatewayStartOptions {
+    /**
+     * UI 监听端口。
+     */
+    port: number;
+    /**
+     * UI 监听主机。
+     */
+    host: string;
+}
+/**
+ * Console 网关。
+ */
+export declare class ConsoleGateway {
+    private app;
+    private server;
+    private readonly publicDir;
+    private readonly authService;
+    constructor();
+    /**
+     * 注册网关路由。
+     */
+    private setupRoutes;
+    private readRequestedAgentId;
+    private pickDirectoryPath;
+    private listKnownAgents;
+    private buildAgentsResponse;
+    /**
+     * 构建 Global Model 面板响应。
+     *
+     * 关键点（中文）
+     * - 模型池来自 console 全局 SQLite，而不是某个 agent。
+     * - `agentPrimaryModelId` 仅用于展示当前选中 agent 的项目绑定。
+     */
+    private buildModelResponse;
+    /**
+     * 读取单个配置文件状态。
+     *
+     * 关键点（中文）
+     * - 不抛出异常，统一返回 `status/reason` 便于 UI 汇总展示。
+     * - 使用最小探测维度：存在性、文件类型、可读性、大小、修改时间。
+     */
+    private readConfigFileStatus;
+    /**
+     * 构建配置文件状态响应。
+     *
+     * 关键点（中文）
+     * - `console` 维度始终返回。
+     * - `agent` 维度仅在存在选中 agent 时返回，避免误导。
+     */
+    private buildConfigStatusResponse;
+    private resolveSelectedAgent;
+    /**
+     * 根据 id 查找 agent（允许离线 agent，用于 command 页面）。
+     */
+    private resolveAgentById;
+    /**
+     * 探测目录状态，用于“打开文件夹”流程。
+     */
+    private inspectAgentDirectory;
+    /**
+     * 列出可直接用于 local executor 的本地 GGUF 模型。
+     */
+    private listLocalModels;
+    /**
+     * 在 agent 项目目录中执行 shell 命令。
+     *
+     * 关键点（中文）
+     * - 默认 shell 使用 zsh，保持与 CLI 使用习惯一致。
+     * - 输出做大小限制，避免单次命令把 UI 网关进程内存打满。
+     */
+    private executeShellCommand;
+    private initializeAgentProject;
+    private startAgentByProjectRoot;
+    private updateAgentExecution;
+    private inspectAgentRestartSafety;
+    private restartAgentByProjectRoot;
+    private stopAgentByProjectRoot;
+    private buildUpstreamUrl;
+    private forwardRequest;
+    private serveFrontendPath;
+    /**
+     * 启动 UI 网关。
+     */
+    start(options: ConsoleGatewayStartOptions): Promise<void>;
+    /**
+     * 停止 UI 网关。
+     */
+    stop(): Promise<void>;
+}
+export declare function createConsoleGateway(): ConsoleGateway;
+//# sourceMappingURL=ConsoleGateway.d.ts.map

package/bin/console/ConsoleGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleGateway.d.ts","sourceRoot":"","sources":["../../src/console/ConsoleGateway.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuEH;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAAO;IAClB,OAAO,CAAC,MAAM,CAAqD;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;;IA+B1C;;OAEG;IACH,OAAO,CAAC,WAAW;IAgCnB,OAAO,CAAC,oBAAoB;YAId,iBAAiB;YAIjB,eAAe;YAIf,mBAAmB;IASjC;;;;;;OAMG;YACW,kBAAkB;IAwBhC;;;;;;OAMG;YACW,oBAAoB;IASlC;;;;;;OAMG;YACW,yBAAyB;YASzB,oBAAoB;IAMlC;;OAEG;YACW,gBAAgB;IAM9B;;OAEG;YACW,qBAAqB;IAMnC;;OAEG;YACW,eAAe;IAM7B;;;;;;OAMG;YACW,mBAAmB;YAiBnB,sBAAsB;YAatB,uBAAuB;YAuBvB,oBAAoB;YAapB,yBAAyB;YAUzB,yBAAyB;YAczB,sBAAsB;IAUpC,OAAO,CAAC,gBAAgB;YAIV,cAAc;YAOd,iBAAiB;IAQ/B;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC/D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ5B;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}

package/bin/console/ConsoleGateway.js

@@ -0,0 +1,283 @@
+/**
+ * Console 网关。
+ *
+ * 关键点（中文）
+ * - UI 由 console 进程独立托管，不依赖单个 agent 启动参数。
+ * - 提供统一的多 agent 选择能力，并把 `/api/*` 代理到选中 agent。
+ */
+import { Hono } from "hono";
+import { cors } from "hono/cors";
+import { logger } from "hono/logger";
+import http from "node:http";
+import fs from "fs-extra";
+import path from "node:path";
+import { fileURLToPath } from "url";
+import { registerConsoleGatewayRoutes } from "../console/ConsoleGatewayRoutes.js";
+import { buildConsoleAgentsResponse, buildConsoleConfigStatusResponse, buildConsoleModelResponse, inspectConsoleAgentDirectory, listKnownConsoleAgents, readConsoleConfigFileStatus, readRequestedConsoleAgentId, resolveConsoleAgentById, resolveSelectedConsoleAgent, } from "../console/gateway/AgentCatalog.js";
+import { executeConsoleShellCommand, initializeConsoleAgentProject, inspectConsoleAgentRestartSafety, pickConsoleDirectoryPath, restartConsoleAgentByProjectRoot, startConsoleAgentByProjectRoot, stopConsoleAgentByProjectRoot, updateConsoleAgentExecution, } from "../console/gateway/AgentActions.js";
+import { serveConsoleFrontendPath } from "../console/gateway/FrontendAssets.js";
+import { buildConsoleUpstreamUrl, forwardConsoleRequest, } from "../console/gateway/Proxy.js";
+import { AuthService } from "../http/auth/AuthService.js";
+import { registerAuthRoutes } from "../http/auth/AuthRoutes.js";
+import { CONSOLE_AUTH_ROUTE_POLICIES, createRouteAuthGuardMiddleware, } from "../http/auth/RoutePolicy.js";
+import { listBuiltinPluginRuntimeAuthPolicies } from "../plugin/HttpRoutes.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * 当前 DC 版本号（用于 Console Overview 显示）。
+ */
+const DC_VERSION = (() => {
+    try {
+        const pkg = fs.readJsonSync(path.join(__dirname, "../../package.json"));
+        const version = String(pkg?.version || "").trim();
+        return version || "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+})();
+/**
+ * Console 网关。
+ */
+export class ConsoleGateway {
+    app;
+    server = null;
+    publicDir;
+    authService;
+    constructor() {
+        // 关键点（中文）：旧的 ui 构建产物路径都统一回退到 packages/downcity/public。
+        this.publicDir = path.join(__dirname, "../../public");
+        this.app = new Hono();
+        this.authService = new AuthService();
+        this.app.use("*", logger());
+        this.app.use("*", cors({
+            origin: "*",
+            allowMethods: ["GET", "POST", "PUT", "DELETE", "OPTIONS"],
+            allowHeaders: ["Content-Type", "Authorization", "X-DC-Agent"],
+        }));
+        this.app.use("*", createRouteAuthGuardMiddleware(this.authService, [
+            ...CONSOLE_AUTH_ROUTE_POLICIES,
+            ...listBuiltinPluginRuntimeAuthPolicies(),
+        ]));
+        this.setupRoutes();
+    }
+    /**
+     * 注册网关路由。
+     */
+    setupRoutes() {
+        registerAuthRoutes({
+            app: this.app,
+            authService: this.authService,
+        });
+        registerConsoleGatewayRoutes({
+            app: this.app,
+            handlers: {
+                readRequestedAgentId: (request) => this.readRequestedAgentId(request),
+                buildAgentsResponse: (requestedAgentId) => this.buildAgentsResponse(requestedAgentId),
+                initializeAgentProject: (projectRoot, initialization) => this.initializeAgentProject(projectRoot, initialization),
+                startAgentByProjectRoot: (projectRoot, options) => this.startAgentByProjectRoot(projectRoot, options),
+                updateAgentExecution: (projectRoot, input) => this.updateAgentExecution(projectRoot, input),
+                pickDirectoryPath: () => this.pickDirectoryPath(),
+                inspectAgentDirectory: (projectRoot) => this.inspectAgentDirectory(projectRoot),
+                listLocalModels: (projectRoot) => this.listLocalModels(projectRoot),
+                inspectAgentRestartSafety: (projectRoot) => this.inspectAgentRestartSafety(projectRoot),
+                restartAgentByProjectRoot: (projectRoot) => this.restartAgentByProjectRoot(projectRoot),
+                stopAgentByProjectRoot: (projectRoot) => this.stopAgentByProjectRoot(projectRoot),
+                buildConfigStatusResponse: (requestedAgentId) => this.buildConfigStatusResponse(requestedAgentId),
+                resolveAgentById: (requestedAgentId) => this.resolveAgentById(requestedAgentId),
+                executeShellCommand: (args) => this.executeShellCommand(args),
+                buildModelResponse: (requestedAgentId) => this.buildModelResponse(requestedAgentId),
+                resolveSelectedAgent: (requestedAgentId) => this.resolveSelectedAgent(requestedAgentId),
+                buildUpstreamUrl: (requestUrl, baseUrl) => this.buildUpstreamUrl(requestUrl, baseUrl),
+                forwardRequest: (request, upstreamUrl) => this.forwardRequest(request, upstreamUrl),
+                serveFrontendPath: (c, reqPath) => this.serveFrontendPath(c, reqPath),
+            },
+        });
+    }
+    readRequestedAgentId(request) {
+        return readRequestedConsoleAgentId(request);
+    }
+    async pickDirectoryPath() {
+        return pickConsoleDirectoryPath();
+    }
+    async listKnownAgents() {
+        return listKnownConsoleAgents();
+    }
+    async buildAgentsResponse(requestedAgentId) {
+        return buildConsoleAgentsResponse({
+            requestedAgentId,
+            cityVersion: DC_VERSION,
+        });
+    }
+    /**
+     * 构建 Global Model 面板响应。
+     *
+     * 关键点（中文）
+     * - 模型池来自 console 全局 SQLite，而不是某个 agent。
+     * - `agentPrimaryModelId` 仅用于展示当前选中 agent 的项目绑定。
+     */
+    async buildModelResponse(requestedAgentId) {
+        return buildConsoleModelResponse({
+            requestedAgentId,
+            cityVersion: DC_VERSION,
+        });
+    }
+    /**
+     * 读取单个配置文件状态。
+     *
+     * 关键点（中文）
+     * - 不抛出异常，统一返回 `status/reason` 便于 UI 汇总展示。
+     * - 使用最小探测维度：存在性、文件类型、可读性、大小、修改时间。
+     */
+    async readConfigFileStatus(params) {
+        return readConsoleConfigFileStatus(params);
+    }
+    /**
+     * 构建配置文件状态响应。
+     *
+     * 关键点（中文）
+     * - `console` 维度始终返回。
+     * - `agent` 维度仅在存在选中 agent 时返回，避免误导。
+     */
+    async buildConfigStatusResponse(requestedAgentId) {
+        return buildConsoleConfigStatusResponse({
+            requestedAgentId,
+            cityVersion: DC_VERSION,
+        });
+    }
+    async resolveSelectedAgent(requestedAgentId) {
+        return resolveSelectedConsoleAgent(requestedAgentId, DC_VERSION);
+    }
+    /**
+     * 根据 id 查找 agent（允许离线 agent，用于 command 页面）。
+     */
+    async resolveAgentById(requestedAgentId) {
+        return resolveConsoleAgentById(requestedAgentId);
+    }
+    /**
+     * 探测目录状态，用于“打开文件夹”流程。
+     */
+    async inspectAgentDirectory(projectRoot) {
+        return inspectConsoleAgentDirectory(projectRoot);
+    }
+    /**
+     * 列出可直接用于 local executor 的本地 GGUF 模型。
+     */
+    async listLocalModels(projectRoot) {
+        return { success: true, modelsDir: "~/.models", models: [] };
+    }
+    /**
+     * 在 agent 项目目录中执行 shell 命令。
+     *
+     * 关键点（中文）
+     * - 默认 shell 使用 zsh，保持与 CLI 使用习惯一致。
+     * - 输出做大小限制，避免单次命令把 UI 网关进程内存打满。
+     */
+    async executeShellCommand(params) {
+        return executeConsoleShellCommand(params);
+    }
+    async initializeAgentProject(projectRoot, initialization) {
+        return initializeConsoleAgentProject({
+            projectRoot,
+            agentName: initialization.agentName,
+            modelId: initialization.modelId,
+            forceOverwriteShipJson: initialization.forceOverwriteShipJson,
+        });
+    }
+    async startAgentByProjectRoot(projectRoot, options) {
+        return startConsoleAgentByProjectRoot({
+            projectRoot,
+            cliPath: path.resolve(__dirname, "../cli/Index.js"),
+            initializeIfNeeded: options?.initializeIfNeeded,
+            initialization: options?.initialization,
+        });
+    }
+    async updateAgentExecution(projectRoot, input) {
+        return updateConsoleAgentExecution({
+            projectRoot,
+            modelId: input.modelId,
+        });
+    }
+    async inspectAgentRestartSafety(projectRoot) {
+        return inspectConsoleAgentRestartSafety({
+            projectRoot,
+            listKnownAgents: () => this.listKnownAgents(),
+        });
+    }
+    async restartAgentByProjectRoot(projectRoot) {
+        return restartConsoleAgentByProjectRoot({
+            projectRoot,
+            cliPath: path.resolve(__dirname, "../cli/Index.js"),
+        });
+    }
+    async stopAgentByProjectRoot(projectRoot) {
+        return stopConsoleAgentByProjectRoot(projectRoot);
+    }
+    buildUpstreamUrl(requestUrl, baseUrl) {
+        return buildConsoleUpstreamUrl(requestUrl, baseUrl);
+    }
+    async forwardRequest(request, upstreamUrl) {
+        return forwardConsoleRequest(request, upstreamUrl);
+    }
+    async serveFrontendPath(c, reqPath) {
+        return serveConsoleFrontendPath({
+            context: c,
+            publicDir: this.publicDir,
+            requestPath: reqPath,
+        });
+    }
+    /**
+     * 启动 UI 网关。
+     */
+    async start(options) {
+        const { port, host } = options;
+        await new Promise((resolve) => {
+            const server = http.createServer(async (req, res) => {
+                try {
+                    const url = new URL(req.url || "/", `http://${host}:${port}`);
+                    const method = req.method || "GET";
+                    const bodyBuffer = await new Promise((onDone, onError) => {
+                        const chunks = [];
+                        req.on("data", (chunk) => chunks.push(chunk));
+                        req.on("end", () => onDone(Buffer.concat(chunks)));
+                        req.on("error", onError);
+                    });
+                    const request = new Request(url.toString(), {
+                        method,
+                        headers: new Headers(req.headers),
+                        body: bodyBuffer.length > 0 ? bodyBuffer : undefined,
+                    });
+                    const response = await this.app.fetch(request);
+                    res.statusCode = response.status;
+                    for (const [key, value] of response.headers.entries()) {
+                        res.setHeader(key, value);
+                    }
+                    const output = Buffer.from(await response.arrayBuffer());
+                    res.end(output);
+                }
+                catch {
+                    res.statusCode = 500;
+                    res.end("Internal Server Error");
+                }
+            });
+            this.server = server;
+            server.listen(port, host, () => resolve());
+        });
+    }
+    /**
+     * 停止 UI 网关。
+     */
+    async stop() {
+        if (!this.server)
+            return;
+        const server = this.server;
+        this.server = null;
+        await new Promise((resolve) => {
+            server.close(() => resolve());
+        });
+    }
+}
+export function createConsoleGateway() {
+    return new ConsoleGateway();
+}
+//# sourceMappingURL=ConsoleGateway.js.map