@aipanel/core 1.2.7 → 1.2.8

package/es/constants.d.ts

@@ -37,8 +37,10 @@ export declare const START_API_PATH = "/__aipanel_start__";
 export declare const SESSIONS_API_PATH = "/__aipanel_sessions__";
 /** MCP 代理 API 路径 */
 export declare const MCP_API_PATH = "/__aipanel_mcp__";
-/** SSE 事件流路径 */
+/** SSE 事件流路径（客户端订阅 SESSION_EVENT 等） */
 export declare const SSE_EVENTS_PATH = "/__aipanel_events__";
+/** 宿主侧事件推送 API 路径（dsh-plugin 等 Host 插件把归一化 ProviderEvent POST 到这里，core 再广播给 SSE 客户端） */
+export declare const HOST_EVENTS_API_PATH = "/__aipanel_host_events__";
 /** 上下文更新间隔（毫秒） */
 export declare const CONTEXT_UPDATE_INTERVAL = 500;
 /** 服务器同步间隔（毫秒） */

package/es/constants.mjs

@@ -14,6 +14,7 @@ const START_API_PATH = "/__aipanel_start__";
 const SESSIONS_API_PATH = "/__aipanel_sessions__";
 const MCP_API_PATH = "/__aipanel_mcp__";
 const SSE_EVENTS_PATH = "/__aipanel_events__";
+const HOST_EVENTS_API_PATH = "/__aipanel_host_events__";
 const CONTEXT_UPDATE_INTERVAL = 500;
 const SERVER_SYNC_INTERVAL = 2e3;
 const INSPECTOR_CHECK_INTERVAL = 500;
@@ -97,6 +98,7 @@ export {
   ENV_VSCODE_PORT,
   EXT_BROADCAST,
   EXT_MSG,
+  HOST_EVENTS_API_PATH,
   INIT_MARKER,
   INSPECTOR_CHECK_INTERVAL,
   LOGS_API_PATH,

package/es/node-logger.d.ts

@@ -28,7 +28,10 @@ export declare class RequestContext {
     path: string;
     startTime: number;
     private checkpoints;
-    constructor(method: string, path: string);
+    private quiet;
+    constructor(method: string, path: string, options?: {
+        quiet?: boolean;
+    });
     checkpoint(label: string): void;
     end(statusCode: number): void;
     error(error: Error | unknown): void;

package/es/node-logger.mjs

@@ -168,25 +168,32 @@ class PerformanceTimer {
   }
 }
 class RequestContext {
-  constructor(method, path) {
+  constructor(method, path, options) {
     __publicField(this, "traceId");
     __publicField(this, "method");
     __publicField(this, "path");
     __publicField(this, "startTime");
     __publicField(this, "checkpoints", []);
+    __publicField(this, "quiet");
     this.traceId = _generateTraceId();
     this.method = method;
     this.path = path;
+    this.quiet = options?.quiet ?? false;
     this.startTime = performance.now();
-    nodeLogger.debug(`\u2192 ${method} ${path}`, { traceId: this.traceId, module: "HTTP" });
+    if (!this.quiet) {
+      nodeLogger.debug(`\u2192 ${method} ${path}`, { traceId: this.traceId, module: "HTTP" });
+    }
   }
   checkpoint(label) {
     const elapsed = Math.round(performance.now() - this.startTime);
     this.checkpoints.push({ time: elapsed, label });
-    nodeLogger.debug(`  \u2192 ${label}`, { traceId: this.traceId, duration: elapsed });
+    if (!this.quiet) {
+      nodeLogger.debug(`  \u2192 ${label}`, { traceId: this.traceId, duration: elapsed });
+    }
   }
   end(statusCode) {
     const duration = Math.round(performance.now() - this.startTime);
+    if (this.quiet) return;
     const statusColor = statusCode < 400 ? COLORS.green : COLORS.red;
     nodeLogger.debug(`\u2190 ${this.method} ${this.path} ${statusColor}${statusCode}${COLORS.reset}`, {
       traceId: this.traceId,

package/es/provider.d.ts

@@ -74,6 +74,12 @@ export interface ProviderStartOptions {
     logsApiUrl?: string;
     /** Vue DevTools API 地址（核心层提供的回连地址） */
     vueDevtoolsApiUrl?: string;
+    /**
+     * 宿主事件推送令牌（核心层每轮启动随机生成，透传给 Host 侧插件）。
+     * dsh-plugin 监听宿主事件（session/event 总线）时须携带该令牌 POST 到 HOST_EVENTS_API_PATH，
+     * core 校验通过后按 SESSION_EVENT 广播给 SSE 客户端。无该能力/无需求的 Provider 忽略即可。
+     */
+    eventsToken?: string;
     /** 启用 verbose 模式 */
     verbose?: boolean;
 }
@@ -99,6 +105,12 @@ export interface ProviderStartResult {
     url: string;
     /** 进程句柄（供编排层做就绪等待与退出检测，不透明） */
     processHandle?: unknown;
+    /**
+     * 对 Provider Web 服务做浏览器会话认证所需的 Cookie（可选）。
+     * dsh web 升级后在索引页与 /api 上强制 browser-session 认证（launch token → 签名 cookie），
+     * 代理需在转发请求时注入该 Cookie 才能通过 401 门禁。opencode 等无需认证的 Provider 不设置。
+     */
+    webAuthCookie?: string;
 }
 /** Provider 初始化配置（主题/语言/设置等，schema 由 Provider 定义） */
 export interface ProviderConfig {
@@ -142,8 +154,12 @@ export interface WebProvider {
     stop(): Promise<void>;
     /** 清理孤儿进程（上次退出残留的 provider 进程），返回清理数量（可选） */
     killOrphans?(): Promise<number>;
-    /** 会话管理（归一化到 ChatSession，过滤逻辑在此内部完成） */
-    listSessions(projectDir: string): Promise<ChatSession[]>;
+    /**
+     * 会话管理（归一化到 ChatSession，过滤逻辑在此内部完成）。
+     * @param activeSessionId 当前选中会话 id（可选）：用于对齐 dsh 等 UI 的可见性规则
+     *   （blank 会话仅当其为当前选中会话时展示）。无选中态概念的 Provider 忽略即可。
+     */
+    listSessions(projectDir: string, activeSessionId?: string): Promise<ChatSession[]>;
     createSession(projectDir: string, title?: string): Promise<ChatSession>;
     /** 可选：部分 Provider 无删除语义；core 不支持时隐藏删除入口 */
     deleteSession?(sessionId: string): Promise<void>;

package/lib/constants.cjs

@@ -34,6 +34,7 @@ __export(constants_exports, {
   ENV_VSCODE_PORT: () => ENV_VSCODE_PORT,
   EXT_BROADCAST: () => EXT_BROADCAST,
   EXT_MSG: () => EXT_MSG,
+  HOST_EVENTS_API_PATH: () => HOST_EVENTS_API_PATH,
   INIT_MARKER: () => INIT_MARKER,
   INSPECTOR_CHECK_INTERVAL: () => INSPECTOR_CHECK_INTERVAL,
   LOGS_API_PATH: () => LOGS_API_PATH,
@@ -78,6 +79,7 @@ const START_API_PATH = "/__aipanel_start__";
 const SESSIONS_API_PATH = "/__aipanel_sessions__";
 const MCP_API_PATH = "/__aipanel_mcp__";
 const SSE_EVENTS_PATH = "/__aipanel_events__";
+const HOST_EVENTS_API_PATH = "/__aipanel_host_events__";
 const CONTEXT_UPDATE_INTERVAL = 500;
 const SERVER_SYNC_INTERVAL = 2e3;
 const INSPECTOR_CHECK_INTERVAL = 500;
@@ -162,6 +164,7 @@ const VUE_DEVTOOLS_ACTIONS = {
   ENV_VSCODE_PORT,
   EXT_BROADCAST,
   EXT_MSG,
+  HOST_EVENTS_API_PATH,
   INIT_MARKER,
   INSPECTOR_CHECK_INTERVAL,
   LOGS_API_PATH,

package/lib/constants.d.ts

@@ -37,8 +37,10 @@ export declare const START_API_PATH = "/__aipanel_start__";
 export declare const SESSIONS_API_PATH = "/__aipanel_sessions__";
 /** MCP 代理 API 路径 */
 export declare const MCP_API_PATH = "/__aipanel_mcp__";
-/** SSE 事件流路径 */
+/** SSE 事件流路径（客户端订阅 SESSION_EVENT 等） */
 export declare const SSE_EVENTS_PATH = "/__aipanel_events__";
+/** 宿主侧事件推送 API 路径（dsh-plugin 等 Host 插件把归一化 ProviderEvent POST 到这里，core 再广播给 SSE 客户端） */
+export declare const HOST_EVENTS_API_PATH = "/__aipanel_host_events__";
 /** 上下文更新间隔（毫秒） */
 export declare const CONTEXT_UPDATE_INTERVAL = 500;
 /** 服务器同步间隔（毫秒） */

package/lib/node-logger.cjs

@@ -189,25 +189,32 @@ class PerformanceTimer {
   }
 }
 class RequestContext {
-  constructor(method, path) {
+  constructor(method, path, options) {
     __publicField(this, "traceId");
     __publicField(this, "method");
     __publicField(this, "path");
     __publicField(this, "startTime");
     __publicField(this, "checkpoints", []);
+    __publicField(this, "quiet");
     this.traceId = (0, import_logger_core.generateTraceId)();
     this.method = method;
     this.path = path;
+    this.quiet = options?.quiet ?? false;
     this.startTime = performance.now();
-    nodeLogger.debug(`\u2192 ${method} ${path}`, { traceId: this.traceId, module: "HTTP" });
+    if (!this.quiet) {
+      nodeLogger.debug(`\u2192 ${method} ${path}`, { traceId: this.traceId, module: "HTTP" });
+    }
   }
   checkpoint(label) {
     const elapsed = Math.round(performance.now() - this.startTime);
     this.checkpoints.push({ time: elapsed, label });
-    nodeLogger.debug(`  \u2192 ${label}`, { traceId: this.traceId, duration: elapsed });
+    if (!this.quiet) {
+      nodeLogger.debug(`  \u2192 ${label}`, { traceId: this.traceId, duration: elapsed });
+    }
   }
   end(statusCode) {
     const duration = Math.round(performance.now() - this.startTime);
+    if (this.quiet) return;
     const statusColor = statusCode < 400 ? COLORS.green : COLORS.red;
     nodeLogger.debug(`\u2190 ${this.method} ${this.path} ${statusColor}${statusCode}${COLORS.reset}`, {
       traceId: this.traceId,

package/lib/node-logger.d.ts

@@ -28,7 +28,10 @@ export declare class RequestContext {
     path: string;
     startTime: number;
     private checkpoints;
-    constructor(method: string, path: string);
+    private quiet;
+    constructor(method: string, path: string, options?: {
+        quiet?: boolean;
+    });
     checkpoint(label: string): void;
     end(statusCode: number): void;
     error(error: Error | unknown): void;

package/lib/provider.d.ts

@@ -74,6 +74,12 @@ export interface ProviderStartOptions {
     logsApiUrl?: string;
     /** Vue DevTools API 地址（核心层提供的回连地址） */
     vueDevtoolsApiUrl?: string;
+    /**
+     * 宿主事件推送令牌（核心层每轮启动随机生成，透传给 Host 侧插件）。
+     * dsh-plugin 监听宿主事件（session/event 总线）时须携带该令牌 POST 到 HOST_EVENTS_API_PATH，
+     * core 校验通过后按 SESSION_EVENT 广播给 SSE 客户端。无该能力/无需求的 Provider 忽略即可。
+     */
+    eventsToken?: string;
     /** 启用 verbose 模式 */
     verbose?: boolean;
 }
@@ -99,6 +105,12 @@ export interface ProviderStartResult {
     url: string;
     /** 进程句柄（供编排层做就绪等待与退出检测，不透明） */
     processHandle?: unknown;
+    /**
+     * 对 Provider Web 服务做浏览器会话认证所需的 Cookie（可选）。
+     * dsh web 升级后在索引页与 /api 上强制 browser-session 认证（launch token → 签名 cookie），
+     * 代理需在转发请求时注入该 Cookie 才能通过 401 门禁。opencode 等无需认证的 Provider 不设置。
+     */
+    webAuthCookie?: string;
 }
 /** Provider 初始化配置（主题/语言/设置等，schema 由 Provider 定义） */
 export interface ProviderConfig {
@@ -142,8 +154,12 @@ export interface WebProvider {
     stop(): Promise<void>;
     /** 清理孤儿进程（上次退出残留的 provider 进程），返回清理数量（可选） */
     killOrphans?(): Promise<number>;
-    /** 会话管理（归一化到 ChatSession，过滤逻辑在此内部完成） */
-    listSessions(projectDir: string): Promise<ChatSession[]>;
+    /**
+     * 会话管理（归一化到 ChatSession，过滤逻辑在此内部完成）。
+     * @param activeSessionId 当前选中会话 id（可选）：用于对齐 dsh 等 UI 的可见性规则
+     *   （blank 会话仅当其为当前选中会话时展示）。无选中态概念的 Provider 忽略即可。
+     */
+    listSessions(projectDir: string, activeSessionId?: string): Promise<ChatSession[]>;
     createSession(projectDir: string, title?: string): Promise<ChatSession>;
     /** 可选：部分 Provider 无删除语义；core 不支持时隐藏删除入口 */
     deleteSession?(sessionId: string): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipanel/core",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "type": "module",
   "sideEffects": false,
   "main": "lib/index.cjs",