vite-plugin-aipanel 1.2.6 → 1.2.8

package/es/core/proxy-server.d.ts

@@ -4,6 +4,13 @@ export interface ProxyServerOptions {
     bridgeScript?: string;
     /** 绑定地址，需与端口检查使用的地址族一致，避免 IPv4/IPv6 不匹配 */
     hostname?: string;
+    /**
+     * Provider Web 服务的 browser-session 认证 Cookie（dsh 0.1.2+ 需要）。
+     * 代理在转发每个请求（含 WebSocket 升级）时把该 Cookie 注入到上游请求头，
+     * 使浏览器免于亲自换取/携带会话 Cookie（避免跨端口/跨站 SameSite 限制），
+     * 同时通过上游 /api 的 browser-auth 门禁。
+     */
+    webAuthCookie?: string;
 }
 export interface ProxyServerResult {
     server: http.Server;

package/es/core/proxy-server.mjs

@@ -5,6 +5,7 @@ function startProxyServer(targetUrl, port, options = {}) {
   return new Promise((resolve, reject) => {
     const target = new URL(targetUrl);
     const bridgeScript = options.bridgeScript ?? "";
+    const webAuthCookie = options.webAuthCookie ?? "";
     const agent = new http.Agent({
       keepAlive: true,
       keepAliveMsecs: 3e4,
@@ -32,6 +33,9 @@ function startProxyServer(targetUrl, port, options = {}) {
         headers: {
           ...req.headers,
           host: target.host,
+          // 注入 Provider Web 服务的 browser-session 认证 Cookie：代理作为已认证客户端
+          // 替 iframe 里的浏览器完成 dsh 0.1.2+ 的会话认证（浏览器无需换取/携带该 Cookie）。
+          ...webAuthCookie ? { cookie: webAuthCookie } : {},
           // 上游（如 dsh 的 trust fence）校验 Origin 必须匹配自身 origin；
           // 页面经代理访问时浏览器发的 Origin 是代理端口，须改写为目标 origin 否则 403
           origin: `http://${target.host}`,
@@ -104,6 +108,8 @@ function startProxyServer(targetUrl, port, options = {}) {
         headers: {
           ...req.headers,
           host: target.host,
+          // 与 HTTP 分支一致：注入认证 Cookie，通过 dsh 0.1.2+ 的 browser-auth 门禁
+          ...webAuthCookie ? { cookie: webAuthCookie } : {},
           // 与 HTTP 分支一致：改写 Origin 为目标 origin，通过 dsh 的 trust fence
           origin: `http://${target.host}`
         }

package/es/core/service.d.ts

@@ -1,6 +1,6 @@
 import type { ResultPromise } from "execa";
 import type http from "http";
-import type { PluginOptions, ServiceStartupTask, WebProvider } from "@aipanel/core";
+import type { PluginOptions, ProviderEvent, ServiceStartupTask, WebProvider } from "@aipanel/core";
 import { ChromeMcpWarmupErrorType } from "@aipanel/core";
 import type { McpProxy } from "./mcp-proxy";
 export declare class AIPanelService {
@@ -25,11 +25,18 @@ export declare class AIPanelService {
     private mcp;
     private provider;
     private unsubscribeEvents;
+    /**
+     * 宿主事件推送令牌（每轮 start 随机生成）。Provider 侧 Host 插件（dsh-plugin）推送
+     * ProviderEvent 时须携带该令牌，core 校验通过后按 SESSION_EVENT 广播给 SSE 客户端。
+     */
+    eventsToken: string | null;
     constructor(config: Required<PluginOptions>, sseClients: Set<http.ServerResponse>, onPortAllocated: (port: number) => void, onProxyPortAllocated: (port: number) => void);
     /** 设置 Provider（由编排层动态加载后调用） */
     setProvider(provider: WebProvider): void;
     private sendTaskUpdate;
     start(vitePort: number, corsOrigins: string[], contextApiUrl: string, logsApiUrl: string, viteOrigin: string, mcp: McpProxy, vueDevtoolsApiUrl?: string): Promise<void>;
+    /** 把一条 ProviderEvent 广播给所有 SSE 客户端（SESSION_EVENT 载荷） */
+    pushProviderEvent(event: ProviderEvent): void;
     retryWarmupChromeMcp(): Promise<{
         success: boolean;
         errorType?: string;

package/es/core/service.mjs

@@ -1,6 +1,7 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+import { randomUUID } from "node:crypto";
 import { DEFAULT_PROXY_PORT, SERVER_START_TIMEOUT, ChromeMcpWarmupErrorType } from "@aipanel/core";
 import { createLogger, findAvailablePort } from "@aipanel/core/node";
 import { findGitRoot, waitForServer } from "../utils/system.mjs";
@@ -26,6 +27,11 @@ class AIPanelService {
     __publicField(this, "mcp", null);
     __publicField(this, "provider", null);
     __publicField(this, "unsubscribeEvents", null);
+    /**
+     * 宿主事件推送令牌（每轮 start 随机生成）。Provider 侧 Host 插件（dsh-plugin）推送
+     * ProviderEvent 时须携带该令牌，core 校验通过后按 SESSION_EVENT 广播给 SSE 客户端。
+     */
+    __publicField(this, "eventsToken", null);
     this.actualWebPort = config.webPort;
     this.actualProxyPort = config.proxyPort ?? DEFAULT_PROXY_PORT;
   }
@@ -60,6 +66,7 @@ class AIPanelService {
       throw new Error("Provider \u672A\u521D\u59CB\u5316\uFF0C\u8BF7\u5148\u8C03\u7528 setProvider");
     }
     this.startPromise = (async () => {
+      this.eventsToken = randomUUID();
       const timer = log.timer("startServices", {
         corsOrigins,
         contextApiUrl,
@@ -96,6 +103,7 @@ class AIPanelService {
       this.sendTaskUpdate("preparing_runtime");
       this.sendTaskUpdate("starting_web");
       let webUrl;
+      let webAuthCookie;
       try {
         const startResult = await provider.start({
           port: this.actualWebPort,
@@ -106,11 +114,14 @@ class AIPanelService {
           contextApiUrl,
           logsApiUrl,
           verbose: this.config.verbose,
-          vueDevtoolsApiUrl
+          vueDevtoolsApiUrl,
+          // 宿主事件推送令牌：provider 将其注入 Host 插件（dsh-plugin）配置，用于回推事件鉴权
+          eventsToken: this.eventsToken ?? void 0
         });
         this.webProcess = startResult.processHandle ?? null;
         timer.checkpoint("Web process started");
         webUrl = startResult.url;
+        webAuthCookie = startResult.webAuthCookie;
         log.debug(`Waiting for Web UI to become ready at ${webUrl}...`);
         this.sendTaskUpdate("waiting_web_ready");
         await waitForServer(webUrl, SERVER_START_TIMEOUT, this.webProcess ?? void 0);
@@ -147,7 +158,8 @@ class AIPanelService {
       try {
         const result = await startProxyServer(webUrl, this.actualProxyPort, {
           bridgeScript: provider.bridgeScript,
-          hostname: this.config.hostname
+          hostname: this.config.hostname,
+          webAuthCookie
         });
         this.proxyServer = result.server;
         if (result.actualPort !== this.actualProxyPort) {
@@ -164,7 +176,8 @@ class AIPanelService {
           const nextPort = await findAvailablePort(this.actualProxyPort + 1, this.config.hostname);
           const result = await startProxyServer(webUrl, nextPort, {
             bridgeScript: provider.bridgeScript,
-            hostname: this.config.hostname
+            hostname: this.config.hostname,
+            webAuthCookie
           });
           this.proxyServer = result.server;
           this.actualProxyPort = result.actualPort;
@@ -199,15 +212,7 @@ class AIPanelService {
       this.isStarted = true;
       this.unsubscribeEvents?.();
       this.unsubscribeEvents = provider.subscribeEvents((event) => {
-        this.sseClients.forEach((client) => {
-          try {
-            client.write(`data: ${JSON.stringify({ type: "SESSION_EVENT", event })}
-
-`);
-          } catch (e) {
-            log.debug("Failed to send SESSION_EVENT", { error: e });
-          }
-        });
+        this.pushProviderEvent(event);
       });
       if (warmupFailed) {
         this.sendTaskUpdate("chrome_mcp_failed", {
@@ -221,6 +226,18 @@ class AIPanelService {
     })();
     return this.startPromise;
   }
+  /** 把一条 ProviderEvent 广播给所有 SSE 客户端（SESSION_EVENT 载荷） */
+  pushProviderEvent(event) {
+    this.sseClients.forEach((client) => {
+      try {
+        client.write(`data: ${JSON.stringify({ type: "SESSION_EVENT", event })}
+
+`);
+      } catch (e) {
+        log.debug("Failed to send SESSION_EVENT", { error: e });
+      }
+    });
+  }
   async retryWarmupChromeMcp() {
     if (!this.mcp) {
       return { success: false, errorType: "UNKNOWN", errorMessage: "MCP not initialized" };
@@ -250,6 +267,7 @@ class AIPanelService {
     log.info("Stopping Web UI services...");
     this.unsubscribeEvents?.();
     this.unsubscribeEvents = null;
+    this.eventsToken = null;
     if (this.proxyServer) {
       log.debug("Closing proxy server");
       this.proxyServer.close();

package/es/endpoints/host-events.d.ts

@@ -0,0 +1,8 @@
+import type { ViteDevServer } from "vite";
+import type { EndpointContext } from "./types";
+/**
+ * 宿主侧事件推送端点（dsh-plugin 等 Host 插件 → core → SSE 广播）。
+ * 只允许无浏览器 Origin 的服务端请求：携带每轮启动随机令牌（x-aipanel-token 头或 body.token），
+ * 通过校验后按 SESSION_EVENT 广播给全部 SSE 客户端（与 provider.subscribeEvents 同一通道）。
+ */
+export declare function setupHostEventsEndpoint(server: ViteDevServer, ctx: EndpointContext): void;

package/es/endpoints/host-events.mjs

@@ -0,0 +1,77 @@
+import { HOST_EVENTS_API_PATH } from "@aipanel/core";
+import { RequestContext, createLogger } from "@aipanel/core/node";
+const log = createLogger("Endpoints:HostEvents");
+function setupHostEventsEndpoint(server, ctx) {
+  server.middlewares.use(HOST_EVENTS_API_PATH, async (req, res) => {
+    const reqCtx = new RequestContext(req.method || "GET", HOST_EVENTS_API_PATH);
+    res.setHeader("Content-Type", "application/json");
+    if (req.headers.origin) {
+      res.writeHead(403);
+      res.end(JSON.stringify({ error: "forbidden" }));
+      reqCtx.end(403);
+      return;
+    }
+    if (req.method === "OPTIONS") {
+      res.writeHead(204);
+      res.end();
+      reqCtx.end(204);
+      return;
+    }
+    if (req.method !== "POST") {
+      res.writeHead(405);
+      res.end(JSON.stringify({ error: "method not allowed" }));
+      reqCtx.end(405);
+      return;
+    }
+    let body = "";
+    req.on("data", (chunk) => body += chunk.toString());
+    req.on("error", () => {
+      res.writeHead(400);
+      res.end(JSON.stringify({ error: "request error" }));
+      reqCtx.end(400);
+    });
+    req.on("end", () => {
+      try {
+        const data = JSON.parse(body);
+        const expected = ctx.eventsToken;
+        if (!expected || data.token !== expected) {
+          res.writeHead(403);
+          res.end(JSON.stringify({ error: "invalid token" }));
+          reqCtx.end(403);
+          return;
+        }
+        const event = data.event;
+        if (!isProviderEvent(event)) {
+          res.writeHead(400);
+          res.end(JSON.stringify({ error: "invalid event" }));
+          reqCtx.end(400);
+          return;
+        }
+        ctx.pushProviderEvent(event);
+        res.writeHead(200);
+        res.end(JSON.stringify({ ok: true }));
+        reqCtx.end(200);
+      } catch {
+        res.writeHead(400);
+        res.end(JSON.stringify({ error: "invalid json" }));
+        reqCtx.end(400);
+      }
+    });
+  });
+}
+function isProviderEvent(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const v = value;
+  if (v.type === "session.status" || v.type === "thinking") {
+    return typeof v.sessionId === "string" && v.sessionId.length > 0;
+  }
+  if (v.type === "session.updated") {
+    const s = v.session;
+    return typeof s === "object" && s !== null && typeof s.id === "string";
+  }
+  if (v.type === "connected") return true;
+  return false;
+}
+export {
+  setupHostEventsEndpoint
+};

package/es/endpoints/index.mjs

@@ -2,6 +2,7 @@ import { setupWidgetEndpoints } from "./widget.mjs";
 import { setupContextEndpoint } from "./context.mjs";
 import { setupStartEndpoint } from "./start.mjs";
 import { setupSseEndpoint } from "./sse.mjs";
+import { setupHostEventsEndpoint } from "./host-events.mjs";
 import { setupSessionsEndpoint } from "./sessions.mjs";
 import { setupWarmupEndpoint } from "./warmup.mjs";
 import { setupLogsEndpoint } from "./logs.mjs";
@@ -14,6 +15,7 @@ function setupMiddlewares(server, ctx, mcp, logFiles) {
   setupContextEndpoint(server, ctx);
   setupStartEndpoint(server, ctx);
   setupSseEndpoint(server, ctx);
+  setupHostEventsEndpoint(server, ctx);
   setupSessionsEndpoint(server, ctx);
   setupWarmupEndpoint(server, ctx);
   setupLogsEndpoint(server);

package/es/endpoints/sessions.mjs

@@ -17,8 +17,10 @@ function setupSessionsEndpoint(server, ctx) {
     try {
       if (req.method === "GET") {
         reqCtx.checkpoint("Fetching sessions");
+        const url = new URL(req.url || "", `http://${req.headers.host}`);
+        const activeSessionId = url.searchParams.get("current") || void 0;
         const [sessions, capabilities] = await Promise.all([
-          ctx.getSessions(),
+          ctx.getSessions(activeSessionId),
           ctx.getCapabilities()
         ]);
         res.writeHead(200);

package/es/endpoints/start.mjs

@@ -2,7 +2,7 @@ import { START_API_PATH } from "@aipanel/core";
 import { RequestContext } from "@aipanel/core/node";
 function setupStartEndpoint(server, ctx) {
   server.middlewares.use(START_API_PATH, async (_req, res) => {
-    const reqCtx = new RequestContext("GET", START_API_PATH);
+    const reqCtx = new RequestContext("GET", START_API_PATH, { quiet: true });
     res.setHeader("Content-Type", "application/json");
     res.setHeader("Access-Control-Allow-Origin", "*");
     res.writeHead(200);

package/es/endpoints/types.d.ts

@@ -1,4 +1,4 @@
-import type { ChatSession, PageContext, ProviderCapabilities, ServiceStartupTask } from "@aipanel/core";
+import type { ChatSession, PageContext, ProviderCapabilities, ProviderEvent, ServiceStartupTask } from "@aipanel/core";
 import type http from "http";
 export interface EndpointContext {
     get webUrl(): string | null;
@@ -19,11 +19,16 @@ export interface EndpointContext {
     get actualProxyPort(): number;
     get actualWebPort(): number;
     get serviceInstanceId(): string;
-    getSessions: () => Promise<ChatSession[]>;
+    /** 获取会话列表；activeSessionId（当前选中会话）由客户端传入，供 Provider 对齐 UI 可见性规则 */
+    getSessions: (activeSessionId?: string) => Promise<ChatSession[]>;
     createSession: () => Promise<ChatSession>;
     deleteSession: (id: string) => Promise<void>;
     /** 获取当前 Provider 能力描述（客户端自适应行为依据） */
     getCapabilities: () => ProviderCapabilities;
+    /** 宿主事件推送令牌（Host 插件回推 ProviderEvent 时鉴权用；未启动时 null） */
+    get eventsToken(): string | null;
+    /** 广播一条 ProviderEvent 给所有 SSE 客户端（SESSION_EVENT 载荷；Host 插件回推与 Provider 订阅共用） */
+    pushProviderEvent: (event: ProviderEvent) => void;
     resolveWidgetPath: () => string;
     resolveWidgetStylePath: () => string;
     retryWarmupChromeMcp: () => Promise<{

package/es/index.mjs

@@ -158,9 +158,15 @@ function createAIPanelPlugin(options = {}) {
           get serviceInstanceId() {
             return serviceInstanceId;
           },
-          getSessions: () => {
+          get eventsToken() {
+            return service.eventsToken;
+          },
+          pushProviderEvent(event) {
+            service.pushProviderEvent(event);
+          },
+          getSessions: (activeSessionId) => {
             if (!provider) return Promise.reject(new Error("Provider \u672A\u521D\u59CB\u5316"));
-            return provider.listSessions(service.workspaceRoot);
+            return provider.listSessions(service.workspaceRoot, activeSessionId);
           },
           createSession: () => {
             if (!provider) return Promise.reject(new Error("Provider \u672A\u521D\u59CB\u5316"));