@nnepoch/dtc-sdk 3.0.2 → 3.0.3

package/dist/cjs/index.d.cts

@@ -92,6 +92,10 @@ interface EngineConfig {
   initialSettings?: Record<string, unknown>;
   /** 日志级别，默认值为 info */
   logger?: EngineLogLevel;
+  /** 从指定级别开始附加业务调用栈，默认值为 warn；silent 表示关闭 */
+  includeStack?: EngineLogLevel;
+  /** Pixel Streaming 依赖日志级别，默认值为 warn */
+  pixelStreamingLogger?: EngineLogLevel;
 }
 interface ApiRequestEnvelope<T = unknown> {
   AssemblyName: string;
@@ -130,6 +134,8 @@ interface ResolvedEngineConfig {
   freeCheckInterval: number;
   initialSettings: Record<string, unknown>;
   logger: EngineLogLevel;
+  includeStack: EngineLogLevel;
+  pixelStreamingLogger: EngineLogLevel;
   centerHeartbeatIntervalMs: number;
   centerHeartbeatTimeoutMs: number;
 }
@@ -2309,6 +2315,104 @@ interface HeatMapConfigRequest {
   heightScale?: number;
   /** 颜色过渡比例，默认 2.5。 */
   lerpScale?: number;
+  /**影响范围 */
+  influenceSize?: number;
+}
+/**
+ * Navigation.startMeshNav / getMeshNavDistance 参数。
+ */
+interface NavigationMeshNavRequest {
+  /** 对象组的父对象，可以为空。 */
+  parentId?: string;
+  /** 对象名称数组集合。 */
+  id: string;
+  /** 路径节点数组集合，与 `targetIds` 二选一。 */
+  nodes?: Vector3Input[];
+  /** 路径节点经过的目标对象名称数组集合，与 `nodes` 二选一；需保证场景中各编号对象唯一存在。 */
+  targetIds?: string[];
+  /** 物体移动的速度，默认 1。 */
+  speed?: number;
+  /** 是否作为导航缓存路径点，默认 `true`；`true` 表示将节点加入缓存路径，下次修改时前置节点仍会经过，`false` 表示按新路径导航。 */
+  isCache?: boolean;
+  /** 导航规划路径颜色。 */
+  planColor?: string;
+  /** 导航已走过的路径颜色。 */
+  passColor?: string;
+  /** 导航规划线的宽度，默认 1。 */
+  lineWidth?: number;
+  /** 是否自动播放，默认 `true`。 */
+  isAutoPlay?: boolean;
+  /** 场景的模型路径，可为空；为空时根据 id 到场景中寻找模型对象。 */
+  assetPath?: string;
+  /** 是否自动清除，默认 `true`。 */
+  isAutoClear?: boolean;
+  offSetZ?: number;
+}
+/**
+ * Navigation.pauseMeshNav / resumeMeshNav / stopMeshNav / pauseNavPath / resumeNavPath / stopNavPath 参数。
+ */
+interface NavigationNodeRequest {
+  /** 对象组的父对象，可以为空。 */
+  parentId?: string;
+  /** 对象名称数组集合。 */
+  id: string;
+}
+/**
+ * Navigation.updateMeshNav 参数。
+ */
+interface NavigationUpdateMeshNavRequest {
+  /** 对象组的父对象，可以为空。 */
+  parentId?: string;
+  /** 对象名称数组集合。 */
+  id: string;
+  /** 物体移动的速度，默认 -1（不改变速度）。 */
+  speed?: number;
+  /** 导航规划路径颜色。 */
+  planColor?: string;
+  /** 导航已走过的路径颜色。 */
+  passColor?: string;
+}
+interface NavigationUpdateSpeedRequest {
+  /** 对象组的父对象，可以为空。 */
+  parentId?: string;
+  /** 对象名称数组集合。 */
+  id: string;
+  /** 物体移动的速度，默认 -1（不改变速度）。 */
+  speed?: number;
+}
+/**
+ * Navigation.startNavByPath 参数。
+ */
+interface NavigationNavByPathRequest {
+  /** 对象组的父对象，可以为空。 */
+  parentId?: string;
+  /** 对象名称数组集合。 */
+  id: string[];
+  /** 路径节点数组集合。 */
+  nodes: Vector3Input[];
+  /** 是否作为导航缓存路径点，默认 `true`。 */
+  isCache?: boolean;
+  /** 导航轨迹总时间（秒），默认 10。 */
+  duration?: number;
+  /** 导航规划路径颜色。 */
+  planColor?: string;
+  /** 导航已走过的路径颜色。 */
+  passColor?: string;
+}
+/**
+ * Navigation.updateNavPath 参数。
+ */
+interface NavigationUpdateNavPathRequest {
+  /** 对象组的父对象，可以为空。 */
+  parentId?: string;
+  /** 对象名称数组集合。 */
+  id: string[];
+  /** 导航轨迹总时间（秒），默认 -1（不改变时长）。 */
+  duration?: number;
+  /** 导航规划路径颜色。 */
+  planColor?: string;
+  /** 导航已走过的路径颜色。 */
+  passColor?: string;
 }
 //#endregion
 //#region src/types/response.d.ts
@@ -4029,6 +4133,258 @@ declare class ModelTransform extends BaseApi {
   restoreScale(payload: ModelTransformRestoreRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
 }
 //#endregion
+//#region src/api/Navigation.d.ts
+/**
+ * 场景对象导航 API，支持两种导航模式：
+ * 1. 在导航网格上寻路，产生导航路径；
+ * 2. 根据设置好的路径节点，进行直线导航。
+ * @agentTitle 对象导航
+ * @agentCapabilities 网格导航寻路, 导航距离查询, 网格导航暂停, 网格导航继续, 网格导航停止, 网格导航属性修改, 路径导航开始, 路径导航暂停, 路径导航继续, 路径导航停止, 路径导航属性修改
+ * @hideconstructor
+ */
+declare class Navigation extends BaseApi {
+  constructor(bridge: ApiBridge, runtimeOptions?: BaseApiRuntimeOptions);
+  /**
+     * 网格导航寻路：模型对象根据路过的节点进行导航。
+     * `nodes` 与 `targetIds` 两者必须有一个不为空。
+     * 默认值：`isCache=true`、`speed=1`、`frontWidth=1`、`backWidth=1`、`isAutoPlay=true`。
+     * @param payload - 导航参数。
+     * @param callback - 可选回调函数。
+     * @returns Promise 形式的接口响应。
+     * @agentSideEffects write
+     * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+     * @agentRiskLevel low
+     * @agentExample { parentId: 'Players', id: 'Player1' nodes: [{ x: 114.7985155712282, y: 34.842421780635625, z: 2 }, { x: 114.79789723105696, y: 34.84218433379876, z: 1.5 }], isCache: false, planColor: '#00ff00', passColor: '#e1e1e1' }
+     * @example
+     * ```ts
+      dtcEngine.Navigation.startNav({
+        parentId: 'Players',
+        id: 'Player1',
+        nodes: [
+          new dtcEngine.Type.Vector3(114.7985155712282, 34.842421780635625, 2),
+          new dtcEngine.Type.Vector3(114.79789723105696, 34.84218433379876, 1.5),
+          new dtcEngine.Type.Vector3(114.79790138598447, 34.842529820659664, 2),
+          new dtcEngine.Type.Vector3(114.79799880513536, 34.84259530893161, 1.5),
+          new dtcEngine.Type.Vector3(114.79814201498125, 34.842669768891525, 2),
+          new dtcEngine.Type.Vector3(114.79808229900121, 34.842686310921465, 2)
+        ],
+        isCache: false,
+        planColor: '#00ff00',
+        passColor: '#e1e1e1',
+        offSetZ: 0.5,
+      }, (result) => { console.log(result); });
+     * ```
+     */
+  startNav(payload: NavigationMeshNavRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+   * 网格导航距离查询：模型对象根据路过的节点进行导航，并返回导航距离信息。
+   * `nodes` 与 `targetIds` 两者必须有一个不为空。
+   * 默认值：`isCache=false`、`speed=1`、`frontWidth=1`、`backWidth=1`、`isAutoPlay=false`。
+   * @param payload - 导航参数。
+   * @param callback - 可选回调函数。
+   * @returns Promise 形式的接口响应。
+   * @agentSideEffects write
+   * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+   * @agentRiskLevel low
+   * @agentExample { parentId: 'Players', id: ['Player1', 'MyRobut'], nodes: [{ x: 114.7985155712282, y: 34.842421780635625, z: 2 }, { x: 114.79789723105696, y: 34.84218433379876, z: 1.5 }], isCache: false, planColor: '#00ff00', passColor: '#e1e1e1' }
+   * @example
+   * ```ts
+   * dtcEngine.Navigation.getMeshNavDistance({
+   *   parentId: 'Players',
+   *   id: ['Player1', 'MyRobut'],
+   *   nodes: [
+   *     new dtcEngine.Type.Vector3(114.7985155712282, 34.842421780635625, 2),
+   *     new dtcEngine.Type.Vector3(114.79789723105696, 34.84218433379876, 1.5)
+   *   ],
+   *   isCache: false,
+   *   planColor: '#00ff00',
+   *   passColor: '#e1e1e1'
+   * }, (result) => { console.log(result); });
+   * ```
+   */
+  getMeshNavDistance(payload: NavigationMeshNavRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+   * 暂停模型对象网格导航。
+   * @param payload - 导航对象参数。
+   * @param callback - 可选回调函数。
+   * @returns Promise 形式的接口响应。
+   * @agentSideEffects write
+   * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+   * @agentRiskLevel low
+   * @agentExample { parentId: 'Players', id: ['Player1', 'MyRobut'] }
+   * @example
+   * ```ts
+   * dtcEngine.Navigation.pauseNav({ parentId: 'Players', id: 'Player1' }, (result) => { console.log(result); });
+   * ```
+   */
+  pauseNav(payload: NavigationNodeRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+   * 继续模型对象网格导航。
+   * @param payload - 导航对象参数。
+   * @param callback - 可选回调函数。
+   * @returns Promise 形式的接口响应。
+   * @agentSideEffects write
+   * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+   * @agentRiskLevel low
+   * @agentExample { parentId: 'Players', id: ['Player1', 'MyRobut'] }
+   * @example
+   * ```ts
+   * dtcEngine.Navigation.resumeNav({ parentId: 'Players', id: ['Player1', 'MyRobut'] }, (result) => { console.log(result); });
+   * ```
+   */
+  resumeNav(payload: NavigationNodeRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+   * 停止模型对象网格导航。
+   * @param payload - 导航对象参数。
+   * @param callback - 可选回调函数。
+   * @returns Promise 形式的接口响应。
+   * @agentSideEffects write
+   * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+   * @agentRiskLevel low
+   * @agentExample { parentId: 'Players', id: ['Player1', 'MyRobut'] }
+   * @example
+   * ```ts
+   * dtcEngine.Navigation.stopNav({ parentId: 'Players', id: ['Player1'] }, (result) => { console.log(result); });
+   * ```
+   */
+  stopNav(payload: NavigationNodeRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+   * 设置网格导航路径属性。
+   * 默认值：`speed=-1`（不改变速度）。
+   * @param payload - 导航属性参数。
+   * @param callback - 可选回调函数。
+   * @returns Promise 形式的接口响应。
+   * @agentSideEffects write
+   * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+   * @agentRiskLevel low
+   * @agentExample { parentId: 'Players', id: 'Player1', planColor: '#00ff00', passColor: '#e1e1e1', speed: 4 }
+   * @example
+   * ```ts
+   * dtcEngine.Navigation.updateNav({
+   *   parentId: 'Players',
+   *   id: 'Player1',
+   *   planColor: '#00ff00',
+   *   passColor: '#e1e1e1',
+   *   speed: 4
+   * }, (result) => { console.log(result); });
+   * ```
+   */
+  updateNav(payload: NavigationUpdateMeshNavRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+     * 设置网格导航路径属性。
+     * 默认值：`speed=-1`（不改变速度）。
+     * @param payload - 导航属性参数。
+     * @param callback - 可选回调函数。
+     * @returns Promise 形式的接口响应。
+     * @agentSideEffects write
+     * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+     * @agentRiskLevel low
+     * @agentExample { parentId: 'Players', id: 'Player1', speed: 4 }
+     * @example
+     * ```ts
+      dtcEngine.Navigation.updateSpeed({
+        parentId: 'Players',
+        id: 'Player1',
+        speed: 4
+      }, (result) => { console.log(result); });
+     * ```
+     */
+  updateSpeed(payload: NavigationUpdateSpeedRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+   * 路径导航开始：根据指定的轨迹节点进行直线导航行走。
+   * 默认值：`isCache=true`、`duration=10`。
+   * @param payload - 路径导航参数。
+   * @param callback - 可选回调函数。
+   * @returns Promise 形式的接口响应。
+   * @agentSideEffects write
+   * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+   * @agentRiskLevel low
+   * @agentExample { parentId: 'Players', id: ['Player1', 'MyRobut'], nodes: [{ x: 114.7985155712282, y: 34.842421780635625, z: 2 }, { x: 114.79789723105696, y: 34.84218433379876, z: 1.5 }], isCache: false, duration: 10 }
+   * @example
+   * ```ts
+   * dtcEngine.Navigation.startNavByPath({
+   *   parentId: 'Players',
+   *   id: ['Player1', 'MyRobut'],
+   *   nodes: [
+   *     new dtcEngine.Type.Vector3(114.7985155712282, 34.842421780635625, 2),
+   *     new dtcEngine.Type.Vector3(114.79789723105696, 34.84218433379876, 1.5),
+   *     new dtcEngine.Type.Vector3(114.79790138598447, 34.842529820659664, 2)
+   *   ],
+   *   isCache: false,
+   *   duration: 10
+   * }, (result) => { console.log(result); });
+   * ```
+   */
+  startNavByPath(payload: NavigationNavByPathRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+   * 暂停模型对象路径导航。
+   * @param payload - 导航对象参数。
+   * @param callback - 可选回调函数。
+   * @returns Promise 形式的接口响应。
+   * @agentSideEffects write
+   * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+   * @agentRiskLevel low
+   * @agentExample { parentId: 'Players', id: ['Player1', 'MyRobut'] }
+   * @example
+   * ```ts
+   * dtcEngine.Navigation.pauseNavPath({ parentId: 'Players', id: ['Player1', 'MyRobut'] }, (result) => { console.log(result); });
+   * ```
+   */
+  pauseNavPath(payload: NavigationNodeRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+   * 继续模型对象路径导航。
+   * @param payload - 导航对象参数。
+   * @param callback - 可选回调函数。
+   * @returns Promise 形式的接口响应。
+   * @agentSideEffects write
+   * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+   * @agentRiskLevel low
+   * @agentExample { parentId: 'Players', id: ['Player1', 'MyRobut'] }
+   * @example
+   * ```ts
+   * dtcEngine.Navigation.resumeNavPath({ parentId: 'Players', id: ['Player1', 'MyRobut'] }, (result) => { console.log(result); });
+   * ```
+   */
+  resumeNavPath(payload: NavigationNodeRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+   * 停止模型对象路径导航。
+   * @param payload - 导航对象参数。
+   * @param callback - 可选回调函数。
+   * @returns Promise 形式的接口响应。
+   * @agentSideEffects write
+   * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+   * @agentRiskLevel low
+   * @agentExample { parentId: 'Players', id: ['Player1', 'MyRobut'] }
+   * @example
+   * ```ts
+   * dtcEngine.Navigation.stopNavPath({ parentId: 'Players', id: ['Player1'] }, (result) => { console.log(result); });
+   * ```
+   */
+  stopNavPath(payload: NavigationNodeRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+   * 设置路径导航属性。
+   * 默认值：`duration=-1`（不改变时长）。
+   * @param payload - 路径导航属性参数。
+   * @param callback - 可选回调函数。
+   * @returns Promise 形式的接口响应。
+   * @agentSideEffects write
+   * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+   * @agentRiskLevel low
+   * @agentExample { parentId: 'Players', id: ['Player1', 'MyRobut'], planColor: '#00ff00', passColor: '#e1e1e1', duration: 5 }
+   * @example
+   * ```ts
+   * dtcEngine.Navigation.updateNavPath({
+   *   parentId: 'Players',
+   *   id: ['Player1', 'MyRobut'],
+   *   planColor: '#00ff00',
+   *   passColor: '#e1e1e1',
+   *   duration: 5
+   * }, (result) => { console.log(result); });
+   * ```
+   */
+  updateNavPath(payload: NavigationUpdateNavPathRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+}
+//#endregion
 //#region src/api/PathPatrol.d.ts
 /**
  * 路径巡逻 API，支持巡逻路线添加、样式修改、时间节点设置与巡逻控制。
@@ -4047,6 +4403,7 @@ declare class PathPatrol extends BaseApi {
    * @agentSideEffects write
    * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
    * @agentRiskLevel low
+   * @agentResponseMode stream
    * @agentExample { parentId: 'patrolLayer', id: 'patrolMan', assetPath: 'PatrolMan', scale: { x: 2, y: 2, z: 2 }, showPath: true, passedColor: '#ff0013', lineColor: '#0040ef', lineWidth: 2, nodes: [{ x: 114.79234244388735, y: 34.8353249473732, z: 67.76611328125 }, { x: 114.78552975378634, y: 34.84532722646887, z: 67.76627349853516 }], duration: 10 }
    * @example
    * ```ts
@@ -4264,24 +4621,24 @@ declare class HeatMap extends BaseApi {
    */
   clear(callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
   /**
-   * 设置热力图参数（透明度/高度缩放/颜色过渡）。
-   * `id` 非空时作用于该 id 的热力图，否则作用于最近创建的热力图。
-   * 默认值：`opacity=0.7`、`heightScale=2500`、`lerpScale=2.5`。
-   * @param payload - 热力图参数。
-   * @param callback - 可选回调函数。
-   * @returns Promise 形式的接口响应。
-   * @agentSideEffects write
-   * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
-   * @agentRiskLevel low
-   * @agentExample { id: 'heatMap1', opacity: 0.5, heightScale: 3000, lerpScale: 3 }
-   * @example
-   * ```ts
-   * dtcEngine.HeatMap.setConfig(
-   *   { id: 'heatMap1', opacity: 0.5, heightScale: 3000, lerpScale: 3 },
-   *   (result) => { console.log(result); }
-   * );
-   * ```
-   */
+     * 设置热力图参数（透明度/高度缩放/颜色过渡）。
+     * `id` 非空时作用于该 id 的热力图，否则作用于最近创建的热力图。
+     * 默认值：`opacity=0.7`、`heightScale=2500`、`lerpScale=2.5`。
+     * @param payload - 热力图参数。
+     * @param callback - 可选回调函数。
+     * @returns Promise 形式的接口响应。
+     * @agentSideEffects write
+     * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+     * @agentRiskLevel low
+     * @agentExample { id: 'heatMap1', opacity: 0.5, heightScale: 3000, lerpScale: 3 }
+     * @example
+     * ```ts
+      dtcEngine.HeatMap.setConfig(
+        { id: 'heatMap1', opacity: 0.5, heightScale: 3000, lerpScale: 3 },
+        (result) => { console.log(result); }
+      );
+     * ```
+     */
   setConfig(payload: HeatMapConfigRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
 }
 //#endregion
@@ -4645,6 +5002,7 @@ declare class TimeLine extends BaseApi {
    * @agentSideEffects write
    * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
    * @agentRiskLevel low
+   * @agentResponseMode stream
    * @agentExample { id: 'Path1', speed: 2 }
      * @example
      * ```ts
@@ -5132,6 +5490,7 @@ interface ApiInstanceMap {
   UIPOI: UIPOI;
   ModelPOI: ModelPOI;
   ModelTransform: ModelTransform;
+  Navigation: Navigation;
   PathPatrol: PathPatrol;
   HeatMap: HeatMap;
   HighlighterEffect: HighLighterEffect;
@@ -5200,11 +5559,11 @@ interface AgentBridgeReconnectOptions {
 interface DTCEngineAgentBridgeOptions {
   /** MCP bridge server 地址；缺省连接本机默认 MCP bridge server。 */
   serverUrl?: string;
-  /** 可选的页面运行时名称。 */
+  /** 可选诊断名称，缺省自动使用 EngineConfig.sceneName；项目 Skill 不使用它路由。 */
   runtimeName?: string;
   /** 是否启用 bridge；只有 `true` 会创建连接。 */
   enabled?: boolean;
-  /** API 暴露范围，缺省为 `all`。 */
+  /** 高级安全配置；API 暴露范围缺省为 `all`，普通项目接入无需传入。 */
   expose?: AgentBridgeExposeConfig;
   /** 心跳间隔，缺省 5000ms。 */
   heartbeatIntervalMs?: number;
@@ -5212,7 +5571,7 @@ interface DTCEngineAgentBridgeOptions {
   reconnect?: boolean | AgentBridgeReconnectOptions;
   /** 仅用于测试/联调：校验通过后不调用真实 UE API，直接返回 mock 成功。 */
   mockInvoke?: boolean;
-  /** 预留的业务元数据。 */
+  /** 兼容性扩展字段；项目 Skill 不依赖该字段路由。 */
   metadata?: Record<string, string>;
 }
 interface AgentBridgeRuntimeEngineSnapshot {
@@ -5240,6 +5599,8 @@ interface AgentBridgeRuntimeSnapshot {
 }
 /** API 方法副作用描述，用于帮助 Agent 判断调用风险。 */
 type AgentBridgeMethodSideEffect = 'read' | 'write' | 'connection' | 'stream';
+/** API 的响应模式；与副作用风险是两个独立维度。 */
+type AgentBridgeMethodResponseMode = 'single' | 'stream';
 /**
  * 模块目录项。
  */
@@ -5259,6 +5620,7 @@ interface AgentBridgeMethodCatalogItem {
   description: string;
   sideEffects: AgentBridgeMethodSideEffect[];
   preconditions: string[];
+  responseMode: AgentBridgeMethodResponseMode;
 }
 /** schema 字段类型。 */
 type AgentBridgeSchemaFieldType = 'string' | 'number' | 'boolean' | 'object' | 'array' | 'enum' | 'unknown';
@@ -5288,9 +5650,10 @@ interface AgentBridgeMethodSchemaMetadata {
   payloadKind: 'none' | 'object';
   fields: AgentBridgeSchemaField[];
   examples: unknown[];
+  responseMode: AgentBridgeMethodResponseMode;
 }
 /** bridge 统一错误码。 */
-type AgentBridgeErrorCode = 'API_NOT_FOUND' | 'API_NOT_EXPOSED' | 'METHOD_SCHEMA_NOT_FOUND' | 'SDK_NOT_READY' | 'INVALID_PAYLOAD' | 'API_EXECUTION_FAILED' | 'PROTOCOL_ERROR' | 'BRIDGE_NOT_CONNECTED';
+type AgentBridgeErrorCode = 'API_NOT_FOUND' | 'API_NOT_EXPOSED' | 'METHOD_SCHEMA_NOT_FOUND' | 'SDK_NOT_READY' | 'INVALID_PAYLOAD' | 'API_EXECUTION_FAILED' | 'API_NOT_STREAMING' | 'STREAM_INVOKE_REQUIRED' | 'PROTOCOL_ERROR' | 'BRIDGE_NOT_CONNECTED';
 /**
  * bridge 结构化错误。
  */
@@ -5321,6 +5684,42 @@ interface AgentBridgeInvokeRequest {
   methodName: string;
   payload?: unknown;
 }
+/** 启动流式 API 请求。streamId 由 MCP server 创建，用于跨进程关联事件。 */
+interface AgentBridgeStreamStartRequest extends AgentBridgeInvokeRequest {
+  streamId: string;
+}
+/** 主动关闭浏览器侧流监听；这只取消本地回调，不等价于停止 UE 业务。 */
+interface AgentBridgeStreamCloseRequest {
+  streamId: string;
+  reason?: string;
+}
+type AgentBridgeStreamTerminalReason = 'completed' | 'finished' | 'stopped' | 'cancelled' | 'error' | 'bridge-disconnected';
+interface AgentBridgeStreamEventPayload {
+  streamId: string;
+  requestId: string;
+  moduleName: string;
+  methodName: string;
+  event: {
+    type: StreamRequestEventType;
+    requestId: string;
+    response?: unknown;
+    error?: {
+      name: string;
+      message: string;
+    };
+  };
+  terminal: boolean;
+  terminalReason?: AgentBridgeStreamTerminalReason;
+}
+interface AgentBridgeStreamStartResult {
+  streamId: string;
+  requestId: string;
+}
+interface AgentBridgeStreamCloseResult {
+  streamId: string;
+  closed: boolean;
+}
+type AgentBridgeStreamEventListener = (payload: AgentBridgeStreamEventPayload) => void;
 /**
  * 面向 WebSocket bridge 的运行时适配接口。
  */
@@ -5331,6 +5730,15 @@ interface AgentBridgeRuntimeAdapter {
   listMethods(moduleName: string): AgentBridgeOperationResult<AgentBridgeMethodCatalogItem[]>;
   getMethodSchema(moduleName: string, methodName: string): AgentBridgeOperationResult<AgentBridgeMethodSchemaMetadata>;
   invoke(request: AgentBridgeInvokeRequest): Promise<AgentBridgeOperationResult<unknown>>;
+  startStream(request: AgentBridgeStreamStartRequest, onEvent: AgentBridgeStreamEventListener): Promise<AgentBridgeOperationResult<AgentBridgeStreamStartResult>>;
+  closeStream(request: AgentBridgeStreamCloseRequest): Promise<AgentBridgeOperationResult<AgentBridgeStreamCloseResult>>;
+  closeAllStreams?(reason?: string): void;
+}
+/** createBridgeRuntime 内部保存的浏览器流句柄。 */
+interface AgentBridgeActiveStream {
+  request: AgentBridgeStreamStartRequest;
+  promise: StreamRequestPromise<unknown>;
+  onEvent: AgentBridgeStreamEventListener;
 }
 //#endregion
 //#region src/agentBridge/protocol.d.ts
@@ -5339,7 +5747,7 @@ declare const AGENT_BRIDGE_PROTOCOL_VERSION = "sdk3-agent-bridge/v1";
 /**
  * 浏览器侧 bridge 与 MCP 服务端之间的协议消息类型。
  */
-type AgentBridgeMessageType = 'register' | 'unregister' | 'heartbeat' | 'catalog' | 'schema' | 'invoke' | 'result';
+type AgentBridgeMessageType = 'register' | 'unregister' | 'heartbeat' | 'catalog' | 'schema' | 'invoke' | 'stream-start' | 'stream-close' | 'stream-event' | 'result';
 /**
  * 所有协议消息的基础信封。
  */
@@ -5358,6 +5766,7 @@ interface AgentBridgeRegisterPayload extends AgentBridgeRuntimeSnapshot {
     catalog: true;
     schema: true;
     invoke: true;
+    stream: true;
   };
 }
 /** 关闭消息携带的原因。 */
@@ -5381,13 +5790,16 @@ interface AgentBridgeSchemaRequestPayload {
 }
 /** invoke 请求。 */
 type AgentBridgeInvokeRequestPayload = AgentBridgeInvokeRequest;
+/** 流式 invoke 与关闭请求。 */
+type AgentBridgeStreamStartRequestPayload = AgentBridgeStreamStartRequest;
+type AgentBridgeStreamCloseRequestPayload = AgentBridgeStreamCloseRequest;
 /** result 消息。 */
 interface AgentBridgeResultPayload<TData = unknown> {
-  requestType: 'catalog' | 'schema' | 'invoke';
+  requestType: 'catalog' | 'schema' | 'invoke' | 'stream-start' | 'stream-close';
   result: AgentBridgeOperationResult<TData>;
 }
-type AgentBridgeInboundMessage = AgentBridgeMessageEnvelope<AgentBridgeCatalogRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeSchemaRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeInvokeRequestPayload>;
-type AgentBridgeOutboundMessage = AgentBridgeMessageEnvelope<AgentBridgeRegisterPayload> | AgentBridgeMessageEnvelope<AgentBridgeUnregisterPayload> | AgentBridgeMessageEnvelope<AgentBridgeHeartbeatPayload> | AgentBridgeMessageEnvelope<AgentBridgeResultPayload>;
+type AgentBridgeInboundMessage = AgentBridgeMessageEnvelope<AgentBridgeCatalogRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeSchemaRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeInvokeRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeStreamStartRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeStreamCloseRequestPayload>;
+type AgentBridgeOutboundMessage = AgentBridgeMessageEnvelope<AgentBridgeRegisterPayload> | AgentBridgeMessageEnvelope<AgentBridgeUnregisterPayload> | AgentBridgeMessageEnvelope<AgentBridgeHeartbeatPayload> | AgentBridgeMessageEnvelope<AgentBridgeStreamEventPayload> | AgentBridgeMessageEnvelope<AgentBridgeResultPayload>;
 //#endregion
 //#region src/agentBridge/AgentRuntimeBridge.d.ts
 interface AgentBridgeSocket {
@@ -5438,6 +5850,7 @@ declare class AgentRuntimeBridge {
   private startHeartbeat;
   private clearHeartbeat;
   private handleMessage;
+  private sendStreamEvent;
   private sendResult;
   private send;
   private clearSocketHandlers;
@@ -5872,4 +6285,4 @@ declare class SDKValidationError extends Error {
   toJSON(): Record<string, unknown>;
 }
 //#endregion
-export { AGENT_BRIDGE_API_METADATA, type AGENT_BRIDGE_PROTOCOL_VERSION, API_MODULE_KEYS, type AgentBridgeCatalogRequestPayload, type AgentBridgeErrorCode, type AgentBridgeExposeConfig, type AgentBridgeHeartbeatPayload, type AgentBridgeInboundMessage, type AgentBridgeInvokeRequest, type AgentBridgeInvokeRequestPayload, type AgentBridgeMessageEnvelope, type AgentBridgeMessageType, type AgentBridgeMethodCatalogItem, type AgentBridgeMethodSchemaMetadata, type AgentBridgeMethodSideEffect, type AgentBridgeModuleCatalogItem, type AgentBridgeOperationResult, type AgentBridgeOutboundMessage, type AgentBridgeReconnectOptions, type AgentBridgeRegisterPayload, type AgentBridgeResultPayload, type AgentBridgeRuntimeAdapter, type AgentBridgeRuntimeEngineSnapshot, type AgentBridgeRuntimeFactoryOptions, type AgentBridgeRuntimeSnapshot, type AgentBridgeSchemaEnumOption, type AgentBridgeSchemaField, type AgentBridgeSchemaFieldType, type AgentBridgeSchemaRequestPayload, type AgentBridgeSocket, type AgentBridgeSocketFactory, type AgentBridgeStructuredError, type AgentBridgeUnregisterPayload, AgentRuntimeBridge, type AgentRuntimeBridgeDependencies, Animation, type AnimationGetLengthRequest, type AnimationPlayRequest, type AnimationSetSpeedRequest, type AnimationStartLoopRequest, type AnimationStopLoopRequest, type AnimationStopRequest, type ApiCallback, type ApiFacade, type ApiInstanceMap, type ApiModuleFactory, type ApiModuleKey, type ApiRegistry, type ApiRegistryContext, ApiRegistryError, type ApiRequestEnvelope, type ApiResponseEnvelope, type AuthErrorInfo, type AuthSessionSnapshot, type AuthWorkflowState, Camera, type CameraFlyByPathRequest, type CameraFlyToTargetRequest, type CameraLookAtRequest, type CameraObjFollowRequest, type CameraSetFlySpeedRequest, type CameraSetFovRequest, type CameraSetPositionAndRotationRequest, type CenterConnectResult, type CenterEnvelope, type CenterServiceInfo, type CenterTokenAuthorizeResult, Connect, DTCEngine, type DTCEngineAgentBridgeOptions, Dlss, DlssQuality, type DlssSetEnableRequest, type DlssSetQualityRequest, type EngineConfig, type EngineLogLevel, type EngineStatusInfo, type EngineViewMode, type FeatureToggleRequest, FilterMode, type GetWeatherTypeRequest, HeatMap, type HeatMapConfigRequest, type HeatMapCreateRequest, type HeatMapPointRequest, type HeatMapRemoveRequest, HighLighterEffect, type HighLighterEnableRequest, type HighLighterRemoveHighLightModelRequest, type HighLighterSetHighLightModelRequest, Layer, type LayerAddRequest, type LayerChildElementRequest, LayerEnum, type LayerModelAddRequest, type LayerModelRemoveRequest, type LayerPOIAddRequest, type LayerSelectorRequest, type LayerShowUIPopRequest, type LayerSwitchModelRequest, Model, type ModelAddRequest, type ModelBoundsRequest, ModelPOI, type ModelPOIAddRequest, type ModelPOIDeleteByGroupRequest, type ModelPOIDeleteByIdRequest, type ModelPOIGetInfoRequest, type ModelPOIUpdateRequest, type ModelPOIVisibleByGroupRequest, type ModelRemoveRequest, type ModelSelectorRequest, type ModelSetVisibleByAttributeRequest, type ModelSetVisibleByTagsRequest, type ModelSetVisibleRequest, ModelTransform, type ModelTransformNodeRequest, type ModelTransformRestoreRequest, type ModelTransformRotateByTargetRequest, type ModelTransformRotateRequest, type ModelTransformScaleRequest, type ModelTransformStartMoveRequest, ModelTransformType, type NetworkAdaptationActionResult, type NetworkAdaptationActionStep, type NetworkAdaptationActionType, type NetworkAdaptationLevel, type NetworkAdaptationMode, type NetworkAdaptationState, type NetworkDecisionTrace, type NetworkDiagnosticsSnapshot, type NetworkMetricsSnapshot, PathPatrol, type PathPatrolAddRequest, type PathPatrolNodeRequest, type PathPatrolSetTimeNodeRequest, type PathPatrolUpdateRequest, PendingValidationSchemaMap, Popup, type PopupAddRequest, type PopupDelayRequest, type PopupItemRequest, type PopupRemoveRequest, type PopupShowDistanceRequest, type PopupShowRequest, type PopupSyncInfoRequest, type QOS_EVENT_NAMES, type QosEvent, type QosEventName, type QosLevel, type QosReportingPayload, type QosRuntimeContext, type QosSessionContext, type QosStage, type QosStatus, type QosWarnErrorSummary, type ResolvedEngineConfig, SDKValidationError, Scene, type SceneListenCompassRequest, type SceneSwitchRequest, Screen, ScreenRenderBitratePreset, ScreenRenderBitratePresetOptions, type ScreenRenderBitratePresetValueMap, type ScreenSetSceneFPSRequest, type ScreenSetSceneRenderBitrateRequest, type ScreenSetScreenResolutionRequest, type ScreenSetVideoDecodeRequest, Season, type SignallingAllocateResponse, type StandardResponse, TimeLine, type TimeSerialNode, type TimelineNodeRequest, type TimelinePlayRequest, type TimelineSetSpeedRequest, type TimelineStopRequest, UIPOI, type UIPOIAddRequest, type UIPOIDeleteByGroupRequest, type UIPOIDeleteByIdRequest, type UIPOIEnableOverlapRequest, type UIPOIShowDistanceRequest, type UIPOIUpdateRequest, type UIPOIUpdateStateRequest, type Vector2Input, type Vector2JsonInput, type Vector3Input, type Vector3JsonInput, VideoCodeType, type WeatherChangeSeasonRequest, type WeatherOpenCameraFogRequest, type WeatherSetAnimateTimeOfDayRequest, type WeatherSetDayAndNightRequest, type WeatherSetSceneTimeRequest, type WeatherSetTimeSyncRequest, WeatherSystem, type WeatherTypeRequest, WebView, type WebViewUpdateRequest, apiRegistry, createAgentBridgeMetadata, createApiFacade, createBridgeRuntime, getAgentBridgeMethodSchema, isAgentBridgeMethodExposed, isAgentBridgeModuleExposed, isAgentBridgeModuleName, listAgentBridgeMethods, listAgentBridgeModules, resolveAgentBridgeExposeConfig };
+export { AGENT_BRIDGE_API_METADATA, type AGENT_BRIDGE_PROTOCOL_VERSION, API_MODULE_KEYS, type AgentBridgeActiveStream, type AgentBridgeCatalogRequestPayload, type AgentBridgeErrorCode, type AgentBridgeExposeConfig, type AgentBridgeHeartbeatPayload, type AgentBridgeInboundMessage, type AgentBridgeInvokeRequest, type AgentBridgeInvokeRequestPayload, type AgentBridgeMessageEnvelope, type AgentBridgeMessageType, type AgentBridgeMethodCatalogItem, type AgentBridgeMethodResponseMode, type AgentBridgeMethodSchemaMetadata, type AgentBridgeMethodSideEffect, type AgentBridgeModuleCatalogItem, type AgentBridgeOperationResult, type AgentBridgeOutboundMessage, type AgentBridgeReconnectOptions, type AgentBridgeRegisterPayload, type AgentBridgeResultPayload, type AgentBridgeRuntimeAdapter, type AgentBridgeRuntimeEngineSnapshot, type AgentBridgeRuntimeFactoryOptions, type AgentBridgeRuntimeSnapshot, type AgentBridgeSchemaEnumOption, type AgentBridgeSchemaField, type AgentBridgeSchemaFieldType, type AgentBridgeSchemaRequestPayload, type AgentBridgeSocket, type AgentBridgeSocketFactory, type AgentBridgeStreamCloseRequest, type AgentBridgeStreamCloseRequestPayload, type AgentBridgeStreamCloseResult, type AgentBridgeStreamEventListener, type AgentBridgeStreamEventPayload, type AgentBridgeStreamStartRequest, type AgentBridgeStreamStartRequestPayload, type AgentBridgeStreamStartResult, type AgentBridgeStreamTerminalReason, type AgentBridgeStructuredError, type AgentBridgeUnregisterPayload, AgentRuntimeBridge, type AgentRuntimeBridgeDependencies, Animation, type AnimationGetLengthRequest, type AnimationPlayRequest, type AnimationSetSpeedRequest, type AnimationStartLoopRequest, type AnimationStopLoopRequest, type AnimationStopRequest, type ApiCallback, type ApiFacade, type ApiInstanceMap, type ApiModuleFactory, type ApiModuleKey, type ApiRegistry, type ApiRegistryContext, ApiRegistryError, type ApiRequestEnvelope, type ApiResponseEnvelope, type AuthErrorInfo, type AuthSessionSnapshot, type AuthWorkflowState, Camera, type CameraFlyByPathRequest, type CameraFlyToTargetRequest, type CameraLookAtRequest, type CameraObjFollowRequest, type CameraSetFlySpeedRequest, type CameraSetFovRequest, type CameraSetPositionAndRotationRequest, type CenterConnectResult, type CenterEnvelope, type CenterServiceInfo, type CenterTokenAuthorizeResult, Connect, DTCEngine, type DTCEngineAgentBridgeOptions, Dlss, DlssQuality, type DlssSetEnableRequest, type DlssSetQualityRequest, type EngineConfig, type EngineLogLevel, type EngineStatusInfo, type EngineViewMode, type FeatureToggleRequest, FilterMode, type GetWeatherTypeRequest, HeatMap, type HeatMapConfigRequest, type HeatMapCreateRequest, type HeatMapPointRequest, type HeatMapRemoveRequest, HighLighterEffect, type HighLighterEnableRequest, type HighLighterRemoveHighLightModelRequest, type HighLighterSetHighLightModelRequest, Layer, type LayerAddRequest, type LayerChildElementRequest, LayerEnum, type LayerModelAddRequest, type LayerModelRemoveRequest, type LayerPOIAddRequest, type LayerSelectorRequest, type LayerShowUIPopRequest, type LayerSwitchModelRequest, Model, type ModelAddRequest, type ModelBoundsRequest, ModelPOI, type ModelPOIAddRequest, type ModelPOIDeleteByGroupRequest, type ModelPOIDeleteByIdRequest, type ModelPOIGetInfoRequest, type ModelPOIUpdateRequest, type ModelPOIVisibleByGroupRequest, type ModelRemoveRequest, type ModelSelectorRequest, type ModelSetVisibleByAttributeRequest, type ModelSetVisibleByTagsRequest, type ModelSetVisibleRequest, ModelTransform, type ModelTransformNodeRequest, type ModelTransformRestoreRequest, type ModelTransformRotateByTargetRequest, type ModelTransformRotateRequest, type ModelTransformScaleRequest, type ModelTransformStartMoveRequest, ModelTransformType, Navigation, type NavigationMeshNavRequest, type NavigationNavByPathRequest, type NavigationNodeRequest, type NavigationUpdateMeshNavRequest, type NavigationUpdateNavPathRequest, type NavigationUpdateSpeedRequest, type NetworkAdaptationActionResult, type NetworkAdaptationActionStep, type NetworkAdaptationActionType, type NetworkAdaptationLevel, type NetworkAdaptationMode, type NetworkAdaptationState, type NetworkDecisionTrace, type NetworkDiagnosticsSnapshot, type NetworkMetricsSnapshot, PathPatrol, type PathPatrolAddRequest, type PathPatrolNodeRequest, type PathPatrolSetTimeNodeRequest, type PathPatrolUpdateRequest, PendingValidationSchemaMap, Popup, type PopupAddRequest, type PopupDelayRequest, type PopupItemRequest, type PopupRemoveRequest, type PopupShowDistanceRequest, type PopupShowRequest, type PopupSyncInfoRequest, type QOS_EVENT_NAMES, type QosEvent, type QosEventName, type QosLevel, type QosReportingPayload, type QosRuntimeContext, type QosSessionContext, type QosStage, type QosStatus, type QosWarnErrorSummary, type ResolvedEngineConfig, SDKValidationError, Scene, type SceneListenCompassRequest, type SceneSwitchRequest, Screen, ScreenRenderBitratePreset, ScreenRenderBitratePresetOptions, type ScreenRenderBitratePresetValueMap, type ScreenSetSceneFPSRequest, type ScreenSetSceneRenderBitrateRequest, type ScreenSetScreenResolutionRequest, type ScreenSetVideoDecodeRequest, Season, type SignallingAllocateResponse, type StandardResponse, TimeLine, type TimeSerialNode, type TimelineNodeRequest, type TimelinePlayRequest, type TimelineSetSpeedRequest, type TimelineStopRequest, UIPOI, type UIPOIAddRequest, type UIPOIDeleteByGroupRequest, type UIPOIDeleteByIdRequest, type UIPOIEnableOverlapRequest, type UIPOIShowDistanceRequest, type UIPOIUpdateRequest, type UIPOIUpdateStateRequest, type Vector2Input, type Vector2JsonInput, type Vector3Input, type Vector3JsonInput, VideoCodeType, type WeatherChangeSeasonRequest, type WeatherOpenCameraFogRequest, type WeatherSetAnimateTimeOfDayRequest, type WeatherSetDayAndNightRequest, type WeatherSetSceneTimeRequest, type WeatherSetTimeSyncRequest, WeatherSystem, type WeatherTypeRequest, WebView, type WebViewUpdateRequest, apiRegistry, createAgentBridgeMetadata, createApiFacade, createBridgeRuntime, getAgentBridgeMethodSchema, isAgentBridgeMethodExposed, isAgentBridgeModuleExposed, isAgentBridgeModuleName, listAgentBridgeMethods, listAgentBridgeModules, resolveAgentBridgeExposeConfig };