@doubao-dev/framework 0.0.41 → 0.0.42

package/dist/api.d.ts

@@ -191,12 +191,23 @@ export declare interface AddPhoneRepeatCalendarParams extends AddPhoneCalendarPa
     repeatEndTime?: number;
 }
 
+/**
+ * 相册精细授权状态。
+ *
+ * 继承 {@link BasicAuthorizationDetail} 的全部取值，并增加：
+ * - `limited`：只能访问用户选择的部分照片；支持 iOS 和 Android 14 及以上版本。
+ * - `add only`：只能向相册添加照片，不能读取相册内容；仅 iOS 支持。
+ *
+ * @public
+ */
+export declare type AlbumAuthorizationDetail = BasicAuthorizationDetail | 'limited' | 'add only';
+
 /** @public */
 export declare type AppAuthorizeStatus = 'authorized' | 'denied' | 'not determined';
 
 /** @public */
 export declare interface AppBaseInfoHost {
-    /** 宿主 app 对应的 appId */
+    /** 当前豆包客户端的 appId */
     appId: string;
 }
 
@@ -441,6 +452,16 @@ export declare interface BackgroundAudioState {
     playbackRate?: number;
 }
 
+/**
+ * 只有完整授权和未授权状态的权限所使用的通用精细状态。
+ *
+ * 继承 {@link UnauthorizedDetail} 的全部取值，并增加：
+ * - `full`：已获得该权限的完整访问能力。
+ *
+ * @public
+ */
+export declare type BasicAuthorizationDetail = UnauthorizedDetail | 'full';
+
 /**
  * 电池信息变化事件。
  *
@@ -529,6 +550,16 @@ export declare type BluetoothAdapterStateChangeEvent = GetBluetoothAdapterStateR
 /** @public */
 export declare type BluetoothAdapterStateChangeListener = (event: BluetoothAdapterStateChangeEvent) => void;
 
+/**
+ * 蓝牙精细授权状态。
+ *
+ * 继承 {@link BasicAuthorizationDetail} 的全部取值，并增加：
+ * - `partial`：只获得部分已声明的蓝牙子权限；仅 Android 支持。
+ *
+ * @public
+ */
+export declare type BluetoothAuthorizationDetail = BasicAuthorizationDetail | 'partial';
+
 /**
  * 蓝牙广播二进制字段。
  *
@@ -739,6 +770,155 @@ export declare type BottomSheetCancelSource = 'mask' | 'gesture' | 'hostUnavaila
  */
 export declare type CalendarRepeatInterval = 'day' | 'week' | 'month' | 'year';
 
+/**
+ * 调用当前应用的 Tool。
+ *
+ * 豆包会根据当前智能服务页面或会话 Widget 确定应用和版本，开发者只需传入 Tool 名称和参数。
+ * Tool 正常结果通过 `toolResult` 返回，Tool 业务错误通过 `toolError` 返回，两者都会正常
+ * resolve；调用前校验、鉴权或返回结构校验失败时 Promise reject。
+ *
+ * @param params - Tool 名称和参数。
+ * @returns Tool 正常结果或业务错误，以及 Widget 场景下可选的更新错误。
+ * @example
+ * ```typescript
+ * import { callTool } from '@doubao-dev/framework/api';
+ *
+ * const result = await callTool({
+ *   toolName: 'query_order',
+ *   toolArgs: {
+ *     orderId: 'order-123'
+ *   }
+ * });
+ *
+ * if (result.toolError) {
+ *   console.warn(result.toolError.code, result.toolError.message);
+ * } else {
+ *   console.log(result.toolResult);
+ * }
+ * ```
+ *
+ * @since 0.0.42
+ * @contractStatus verified | 公开参数、页面与 Widget 调用场景、Widget 更新控制、互斥返回结构及 Android、iOS 错误字段一致。
+ * @platformSupport Android | supported | 支持在智能服务页面和会话 Widget 中调用当前应用的 Tool。
+ * @platformSupport iOS | supported | 支持在智能服务页面和会话 Widget 中调用当前应用的 Tool。
+ * @platformSupport PC | unsupported | 客户端尚未实现 callTool。
+ * @platformSupport HarmonyOS | unsupported | 客户端尚未实现 callTool。
+ * @permission none | - | none | Android,iOS | 无需额外权限
+ * @precondition Android | 在当前应用的智能服务页面或由当前应用真实生成的会话 Widget 内调用，且目标 Tool 已在当前应用版本中配置。
+ * @precondition iOS | 在当前应用的智能服务页面或由当前应用真实生成的会话 Widget 内调用，且目标 Tool 已在当前应用版本中配置。
+ * @usageNote All | toolResult 与 toolError 互斥；toolError 是正常返回的 Tool 业务错误，不会导致 Promise reject。skipWidgetUpdate 为 true 时不执行 Widget 更新阶段，因此不会返回 cardUpdateError；否则 cardUpdateError 表示 Tool 已执行但当前 Widget 更新失败。重试会再次执行 Tool，请避免重复触发。
+ * @resultExample
+ * ```json
+ * {
+ *   "toolResult": {
+ *     "content": [
+ *       {
+ *         "type": "text",
+ *         "text": "订单已支付"
+ *       }
+ *     ],
+ *     "structuredContent": {
+ *       "orderId": "order-123",
+ *       "status": "paid"
+ *     }
+ *   }
+ * }
+ * ```
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 104,
+ *   "errMsg": "invalid parameter"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 103 | feature not support | Android,iOS | 在 Worker 等非智能服务页面、Widget 容器中调用 | 仅在智能服务页面或会话 Widget 中调用。
+ * @errorCode errNo | 104 | invalid parameter | Android,iOS | toolName 为空、toolArgs 无法序列化为 JSON 对象，或传入的 skipWidgetUpdate 不是布尔值 | 修正 Tool 名称、参数和 Widget 更新控制参数后重试。
+ * @errorCode errNo | 112 | invalid result | Android,iOS | Tool 正常结果、业务错误或 Widget 更新错误结构无效 | 稍后重试；持续失败时反馈 Tool 或服务端返回异常。
+ * @platformNote All | 非智能服务页面、Widget 容器返回 103；参数非法返回 104；返回结构无效返回 112；上下文无效、网络或服务端调用失败返回 102。
+ * @knownIssue All | Web SDK 模拟器暂不支持 skipWidgetUpdate 为 true；请在 Android 或 iOS 豆包客户端验证跳过 Widget 更新的调用。
+ *
+ * @public
+ */
+export declare const callTool: (params: CallToolParams) => Promise<CallToolResult>;
+
+/**
+ * Tool 正常完成调用后返回的业务错误。
+ *
+ * @public
+ */
+export declare interface CallToolBusinessError {
+    /** Tool 业务错误码。 */
+    code: number;
+    /** Tool 业务错误信息。 */
+    message: string;
+}
+
+/**
+ * Widget 更新阶段的错误。
+ *
+ * @public
+ */
+export declare interface CallToolError {
+    /** 错误码。 */
+    code: string;
+    /** 错误信息。 */
+    message: string;
+    /** 错误阶段，固定为渲染阶段。 */
+    phase: 'render';
+}
+
+/**
+ * 调用 Tool 的参数。
+ *
+ * @public
+ */
+export declare interface CallToolParams {
+    /** 当前应用内需要调用的 Tool 名称。 */
+    toolName: string;
+    /** Tool 入参。 */
+    toolArgs: Record<string, unknown>;
+    /**
+     * 是否跳过 Widget 更新阶段。设为 `true` 时，即使 Tool 下发 Widget，也只返回 Tool 数据，
+     * 不更新当前 Widget。
+     *
+     * @default false
+     * @constraint 仅影响会下发 Widget 的 Tool。
+     */
+    skipWidgetUpdate?: boolean;
+}
+
+/**
+ * 调用 Tool 的结果。
+ *
+ * @public
+ */
+export declare type CallToolResult = {
+    /**
+     * Tool 已执行，但返回结果未能用于更新当前 Widget 时的错误。仅 Widget 场景可能返回。
+     *
+     * @default -
+     */
+    cardUpdateError?: CallToolError;
+} & ({
+    /** Tool 正常结果，与 `toolError` 二选一。 */
+    toolResult: ToolResult;
+    /** @hidden */
+    toolError?: never;
+} | {
+    /** Tool 业务错误，与 `toolResult` 二选一。该字段不会导致 API reject。 */
+    toolError: CallToolBusinessError;
+    /** @hidden */
+    toolResult?: never;
+});
+
+/**
+ * 摄像头精细授权状态，取值与 {@link BasicAuthorizationDetail} 一致。
+ *
+ * @public
+ */
+export declare type CameraAuthorizationDetail = BasicAuthorizationDetail;
+
 /** @public */
 export declare interface CanIUseParams {
     /** 需要检测的能力标识，例如 API 名称 */
@@ -751,6 +931,47 @@ export declare interface CanIUseResult {
     result: boolean;
 }
 
+/**
+ * 对话框高度或展示状态变化事件。
+ *
+ * @public
+ */
+export declare type ChatPanelHeightChangedEvent = ChatPanelInfo;
+
+/**
+ * 对话框高度或展示状态变化监听函数。
+ *
+ * @public
+ */
+export declare type ChatPanelHeightChangedListener = (event: ChatPanelHeightChangedEvent) => void;
+
+/**
+ * 对话框状态快照。
+ *
+ * @public
+ */
+export declare interface ChatPanelInfo {
+    /**
+     * 对话框当前占用的垂直高度，单位为逻辑像素（px），不包含系统键盘高度。
+     *
+     * @constraint 大于等于 0；收起态高度也可能大于 0
+     */
+    height: number;
+    /**
+     * 对话框当前展示状态。
+     *
+     * `preview` 表示从收起态发送消息后、收到回复前的中间态。
+     */
+    state: ChatPanelState;
+}
+
+/**
+ * 对话框展示状态。
+ *
+ * @public
+ */
+export declare type ChatPanelState = 'collapsed' | 'expanded' | 'preview';
+
 /**
  * 检测无障碍能力是否开启。
  *
@@ -1428,13 +1649,13 @@ export declare function connectSocket(params: ConnectSocketParams): SocketTask;
 /**
  * 创建 WebSocket 连接的参数。
  *
- * `connectSocket` 会把这些参数透传给宿主侧创建连接。连接创建请求发出后，
+ * `connectSocket` 会把这些参数交给豆包客户端创建连接。连接创建请求发出后，
  * 调用方会立即拿到一个 {@link SocketTask}，后续连接成功、失败、收到消息和关闭状态
  * 都通过 `SocketTask` 上注册的事件回调通知。
  *
  * @remarks
- * - `url` 应填写完整的 WebSocket 地址。线上环境通常要求使用 `wss://` 协议，并由宿主侧按当前应用配置校验合法域名和证书。
- * - `header` 用于补充握手请求头，`referer` 等由宿主管控的字段不会被业务代码覆盖。
+ * - `url` 应填写完整的 WebSocket 地址。线上环境通常要求使用 `wss://` 协议，并由豆包客户端按当前智能服务配置校验合法域名和证书。
+ * - `header` 用于补充握手请求头，`referer` 等由豆包客户端管理的字段不会被业务代码覆盖。
  * - `protocols` 非空时，服务端需要在握手响应中选择并返回匹配的子协议，否则连接可能失败。
  * - 同一个页面多次调用会创建多个独立连接，已创建的旧连接不会因为新连接自动关闭。
  *
@@ -1453,7 +1674,7 @@ export declare interface ConnectSocketParams {
      * WebSocket 握手阶段携带的 HTTP Header。
      *
      * 适合放置业务自定义 Header，例如鉴权 token、trace id、客户端能力标识等。
-     * `referer` 由宿主侧统一生成和管理，不应依赖该字段被业务传入值覆盖。
+     * `referer` 由豆包客户端统一生成和管理，不应依赖该字段被业务传入值覆盖。
      *
      * @default -
      */
@@ -1463,7 +1684,7 @@ export declare interface ConnectSocketParams {
      *
      * 会作为握手请求中的 `Sec-WebSocket-Protocol` 候选值传给服务端。
      * 如果传入非空数组，服务端需要选择其中一个协议并在握手响应中返回；
-     * 服务端不支持或不返回匹配协议时，连接可能被宿主判定为创建失败。
+     * 服务端不支持或不返回匹配协议时，豆包客户端可能判定连接创建失败。
      *
      * @default -
      */
@@ -2071,9 +2292,9 @@ export declare const disableUserScreenRecord: (params?: {} | undefined) => Promi
  *   "errMsg": "resource not found"
  * }
  * ```
- * @errorCode errNo | 103 | feature not support | Android,iOS | 当前运行环境未接入消息下发能力（宿主消息依赖或消息服务缺失） | 请在支持消息下发的豆包环境中调用。
+ * @errorCode errNo | 103 | feature not support | Android,iOS | 当前豆包环境未提供消息下发能力 | 请在支持消息下发的豆包环境中调用。
  * @errorCode errNo | 116 | resource not found | Android,iOS | 依据 widgetInstanceId 找不到对应会话 | 确认 widgetInstanceId 有效且处于会话环境后重试。
- * @platformNote All | 找不到会话返回 116；宿主消息依赖或消息服务缺失返回 103。
+ * @platformNote All | 找不到会话返回 116；当前豆包环境未提供消息下发能力时返回 103。
  *
  * @internal
  */
@@ -2189,8 +2410,8 @@ export declare interface DoubaoAppAccountInfo {
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
  * @platformSupport HarmonyOS | unsupported | 当前未提供该平台实现。
  * @permission none | - | none | Android,iOS | 无需额外权限
- * @precondition All | 下载地址需通过宿主侧下载域名白名单校验，单个文件不得超过 200 MB，单个智能服务同时最多执行 10 个下载任务；指定 filePath 时仅支持临时目录或用户目录。
- * @usageNote All | 未指定 filePath 时文件写入临时目录，并通过 Promise resolve 结果的 tempFilePath 返回；临时文件的生命周期由宿主管理。
+ * @precondition All | 下载地址需通过豆包配置的下载域名白名单校验，单个文件不得超过 200 MB，单个智能服务同时最多执行 10 个下载任务；指定 filePath 时仅支持临时目录或用户目录。
+ * @usageNote All | 未指定 filePath 时文件写入临时目录，并通过 Promise resolve 结果的 tempFilePath 返回；临时文件的生命周期由豆包客户端管理。
  * @usageNote All | 不跟随 HTTP 重定向，3xx 响应使 Promise reject；4xx、5xx 响应在文件写入成功后仍使 Promise resolve。
  * @resultExample
  * ```json
@@ -2214,10 +2435,10 @@ export declare function downloadFile(params: DownloadFileParams): DownloadTask;
  * @public
  */
 export declare interface DownloadFileParams {
-    /** 下载资源地址，需为完整 HTTPS URL，并通过宿主侧下载域名白名单校验。 */
+    /** 下载资源地址，需为完整 HTTPS URL，并通过豆包配置的下载域名白名单校验。 */
     url: string;
     /**
-     * 请求 Header。`referer` 和 `user-agent` 由宿主管控，业务传入值不会透传。
+     * 请求 Header。`referer` 和 `user-agent` 由豆包客户端管理，业务传入值不会透传。
      *
      * @default -
      */
@@ -2601,30 +2822,34 @@ export declare interface GetAccountInfoResult {
 export declare function getAccountInfoSync(params?: {}): GetAccountInfoResult;
 
 /**
- * 获取宿主应用的系统授权设置。
+ * 获取豆包客户端的系统授权设置。
  *
- * 调用只读取当前系统授权状态，不会申请权限或触发系统授权弹窗。状态字段固定返回
- * `authorized`、`denied` 或 `not determined`。
+ * 调用只读取当前系统授权状态，不会申请权限或触发系统授权弹窗。原有状态字段固定返回
+ * `authorized`、`denied` 或 `not determined`，精细授权字段用于区分部分、只读、只写、前后台等能力。
  *
- * @returns 返回宿主应用相册、蓝牙、摄像头、定位、麦克风、通知和日历权限状态。
+ * @returns 返回豆包客户端的相册、蓝牙、摄像头、定位、麦克风、通知和日历系统权限状态。
  * @example
  * ```typescript
  * import { getAppAuthorizeSetting } from '@doubao-dev/framework/api';
  *
  * const result = getAppAuthorizeSetting();
- * console.log(result.cameraAuthorized, result.microphoneAuthorized);
- * console.log(result.notificationAuthorized, result.locationReducedAccuracy);
+ * const detail = result.phoneCalendarAuthorizationDetail;
+ * const canWriteCalendar =
+ *   detail === 'full' ||
+ *   detail === 'write only' ||
+ *   (detail == null && result.phoneCalendarAuthorized === 'authorized');
+ * console.log(canWriteCalendar);
  * ```
  *
  * @since 0.0.40
- * @contractStatus verified | Android 与 iOS 均同步返回固定 11 个字段；除 locationReducedAccuracy 为 boolean 外，其余授权状态字段均限定为 authorized、denied 或 not determined，调用不会触发权限申请。
- * @platformSupport Android | supported | 支持同步读取宿主应用授权状态。
- * @platformSupport iOS | supported | 支持同步读取宿主应用授权状态。
+ * @contractStatus verified | Android 与 iOS 均同步返回原有授权状态及可映射的精细授权字段；精细字段无法可靠映射或平台不适用时可为空，调用不会触发权限申请。
+ * @platformSupport Android | supported | 支持同步读取豆包客户端的系统权限状态。
+ * @platformSupport iOS | supported | 支持同步读取豆包客户端的系统权限状态。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
  * @platformSupport HarmonyOS | unsupported | 当前未提供该平台实现。
  * @permission none | - | none | Android,iOS | 无需额外权限
  * @precondition All | 无额外前置条件
- * @usageNote All | 本接口查询宿主应用权限，不等同于查询当前智能服务 scope 授权。
+ * @usageNote All | 本接口查询豆包客户端的系统权限，不等同于查询当前智能服务的 scope 授权。
  * @usageNote iOS | SDK 首次完成通知设置异步预热前，或应用重新激活后的刷新尚未完成时，四个通知字段可能仍为旧值或 not determined。
  * @resultExample
  * ```json
@@ -2639,14 +2864,23 @@ export declare function getAccountInfoSync(params?: {}): GetAccountInfoResult;
  *   "notificationAlertAuthorized": "authorized",
  *   "notificationBadgeAuthorized": "denied",
  *   "notificationSoundAuthorized": "authorized",
- *   "phoneCalendarAuthorized": "not determined"
+ *   "phoneCalendarAuthorized": "denied",
+ *   "albumAuthorizationDetail": "limited",
+ *   "bluetoothAuthorizationDetail": "full",
+ *   "cameraAuthorizationDetail": "full",
+ *   "locationAuthorizationDetail": "foreground precise",
+ *   "microphoneAuthorizationDetail": "full",
+ *   "notificationAuthorizationDetail": "provisional",
+ *   "phoneCalendarAuthorizationDetail": "write only"
  * }
  * ```
  * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
  * @platformNote Android | albumAuthorized 和通知分项固定返回 not determined，locationReducedAccuracy 固定返回 false 且不表示实际定位精度
  * @platformNote Android | bluetoothAuthorized、cameraAuthorized、locationAuthorized、microphoneAuthorized、notificationAuthorized 和 phoneCalendarAuthorized 不区分尚未申请和已经拒绝，两种情况均返回 denied
  * @platformNote Android | locationAuthorized 在粗略或精确定位任一权限已授权时返回 authorized；phoneCalendarAuthorized 仅在读、写日历权限均授权时返回 authorized
+ * @platformNote Android | 精细字段区分 Android 14 部分相册、日历读写、定位前后台和精度，以及蓝牙部分子权限
  * @platformNote iOS | 相册 limited 映射为 authorized，通知 provisional 和 ephemeral 映射为 authorized
+ * @platformNote iOS | 精细字段区分相册 limited/add only、日历 write only、定位前后台和精度，以及通知 provisional；ephemeral 暂不映射
  *
  * @public
  */
@@ -2676,12 +2910,56 @@ export declare interface GetAppAuthorizeSettingResult {
     notificationSoundAuthorized: AppAuthorizeStatus;
     /** 系统日历授权状态 */
     phoneCalendarAuthorized: AppAuthorizeStatus;
+    /**
+     * 相册精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 `null`。
+     *
+     * 继承 {@link BasicAuthorizationDetail} 的全部取值，并增加：
+     * - `limited`：只能访问用户选择的部分照片；支持 iOS 和 Android 14 及以上版本。
+     * - `add only`：只能向相册添加照片，不能读取相册内容；仅 iOS 支持。
+     */
+    albumAuthorizationDetail?: AlbumAuthorizationDetail | null;
+    /**
+     * 蓝牙精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 `null`。
+     *
+     * 继承 {@link BasicAuthorizationDetail} 的全部取值，并增加：
+     * - `partial`：只获得部分已声明的蓝牙子权限；仅 Android 支持。
+     */
+    bluetoothAuthorizationDetail?: BluetoothAuthorizationDetail | null;
+    /** 摄像头精细授权状态，取值与 {@link BasicAuthorizationDetail} 一致；旧客户端或无法可靠映射时不返回该字段或返回 `null`。 */
+    cameraAuthorizationDetail?: CameraAuthorizationDetail | null;
+    /**
+     * 定位精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 `null`。
+     *
+     * 继承 {@link UnauthorizedDetail} 的全部取值；获得权限时返回：
+     * - `foreground approximate`：仅应用在前台时可以获取模糊定位。
+     * - `foreground precise`：仅应用在前台时可以获取精确定位。
+     * - `background approximate`：应用在前台或后台时均可以获取模糊定位。
+     * - `background precise`：应用在前台或后台时均可以获取精确定位。
+     */
+    locationAuthorizationDetail?: LocationAuthorizationDetail | null;
+    /** 麦克风精细授权状态，取值与 {@link BasicAuthorizationDetail} 一致；旧客户端或无法可靠映射时不返回该字段或返回 `null`。 */
+    microphoneAuthorizationDetail?: MicrophoneAuthorizationDetail | null;
+    /**
+     * 通知精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 `null`。
+     *
+     * 继承 {@link BasicAuthorizationDetail} 的全部取值，并增加：
+     * - `provisional`：iOS 临时静默授权；不会弹出授权框，通知只进入通知中心。
+     */
+    notificationAuthorizationDetail?: NotificationAuthorizationDetail | null;
+    /**
+     * 系统日历精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 `null`。
+     *
+     * 继承 {@link BasicAuthorizationDetail} 的全部取值，并增加：
+     * - `read only`：只能读取日历，不能新增、修改或删除日程；仅 Android 支持。
+     * - `write only`：只能新增日程，不能读取现有日历数据。
+     */
+    phoneCalendarAuthorizationDetail?: PhoneCalendarAuthorizationDetail | null;
 }
 
 /**
  * 获取应用基础信息。
  *
- * @returns 返回 SDK 版本、调试开关、宿主信息、语言和主题等字段，见 {@link GetAppBaseInfoResult}。
+ * @returns 返回 SDK 版本、调试开关、豆包客户端信息、语言和主题等字段，见 {@link GetAppBaseInfoResult}。
  * @example
  * ```typescript
  * import { getAppBaseInfo } from '@doubao-dev/framework/api';
@@ -2726,11 +3004,11 @@ export declare interface GetAppBaseInfoResult {
     SDKVersion?: string;
     /** 是否已打开调试 */
     enableDebug?: boolean;
-    /** 当前豆包 App 运行的宿主环境 */
+    /** 当前豆包客户端信息 */
     host?: AppBaseInfoHost;
     /** 当前语言 */
     language: string;
-    /** 宿主版本号 */
+    /** 豆包客户端版本号 */
     version?: string;
     /** 当前主题 */
     theme?: 'light' | 'dark';
@@ -2739,7 +3017,7 @@ export declare interface GetAppBaseInfoResult {
 /**
  * 获取应用基础信息。
  *
- * @returns 返回 SDK 版本、调试开关、宿主信息、语言和主题等字段，见 {@link GetAppBaseInfoResult}。
+ * @returns 返回 SDK 版本、调试开关、豆包客户端信息、语言和主题等字段，见 {@link GetAppBaseInfoResult}。
  * @example
  * ```typescript
  * import { getAppBaseInfoSync } from '@doubao-dev/framework/api';
@@ -3307,6 +3585,40 @@ export declare interface GetBluetoothDevicesResult {
     devices: BluetoothDevice[];
 }
 
+/**
+ * 获取当前对话框状态快照。
+ *
+ * 调用不会改变对话框状态，也不会触发高度变化事件。
+ *
+ * @example
+ * ```typescript
+ * import { getChatPanelInfo } from '@doubao-dev/framework/api';
+ *
+ * const { height, state } = await getChatPanelInfo();
+ * console.log('current chat panel', { height, state });
+ * ```
+ * @since 0.0.42
+ * @contractStatus verified | 请求参数、返回字段和状态枚举与对话框状态查询协议一致。
+ * @platformSupport Android | supported | 支持获取当前对话框状态快照。
+ * @platformSupport iOS | supported | 支持获取当前对话框状态快照。
+ * @platformSupport PC | unsupported | 当前未提供该平台实现。
+ * @platformSupport HarmonyOS | unsupported | 当前未提供该平台实现。
+ * @permission none | - | none | Android,iOS | 无需额外权限
+ * @precondition All | 当前页面需在 app.config.ts 中声明 chat.enabled 为 true
+ * @usageNote All | 调用只读取当前状态，不会改变对话框状态或触发高度变化事件。
+ * @resultExample
+ * ```json
+ * {
+ *   "height": 336,
+ *   "state": "expanded"
+ * }
+ * ```
+ * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ *
+ * @public
+ */
+export declare const getChatPanelInfo: (params?: {} | undefined) => Promise<ChatPanelInfo>;
+
 /**
  * 获取剪贴板内容。
  *
@@ -3555,7 +3867,7 @@ export declare const getDeviceInfo: (params?: {} | undefined) => Promise<GetDevi
  * @public
  */
 export declare interface GetDeviceInfoResult {
-    /** 宿主 App 二进制接口类型，仅 Android 支持。 */
+    /** 豆包客户端二进制接口类型，仅 Android 支持。 */
     abi?: string;
     /** 设备二进制接口类型，仅 Android 支持。 */
     deviceAbi?: string;
@@ -3867,6 +4179,13 @@ export declare interface GetLocationParams {
      * @constraint 取值为 0、1 或 2
      */
     mode?: number;
+    /**
+     * 是否接受轻定位结果。轻定位会直接利用设备已有的 Wi-Fi 扫描缓存，由服务端快速计算当前位置，缩短定位耗时。
+     *
+     * @default false
+     * @constraint 仅 Android 生效，需使用 0.0.42 及以上版本的基础库
+     */
+    acceptLightLocation?: boolean;
     /**
      * 超时时间，单位毫秒，默认 30000
      *
@@ -4207,39 +4526,60 @@ export declare interface GetPackageInfoResult {
 }
 
 /**
- * 同步获取当前 package 信息。
+ * 同步获取当前 package 信息，仅供 Web SDK 模拟器使用。
+ *
+ * @internal
+ */
+export declare const getPackageInfoSync: () => GetPackageInfoResult;
+
+/**
+ * 获取当前智能服务应用的性能数据。
+ *
+ * Entry 由客户端保存；`getEntries*()` 同步查询当前快照，observer 只接收新完成的 Entry。
  *
- * @returns 返回当前 package 的 appId、展示名称和展示图标地址，见 {@link GetPackageInfoResult}。
+ * @returns 返回可查询性能 Entry 和创建观察者的 {@link Performance}。
  * @example
  * ```typescript
- * import { getPackageInfoSync } from '@doubao-dev/framework/api';
+ * import { getPerformance } from '@doubao-dev/framework/api';
  *
- * const result = getPackageInfoSync();
+ * const performance = getPerformance();
+ * const observer = performance.createObserver((entryList) => {
+ *   console.log(entryList.getEntries());
+ * });
  *
- * console.log(result.appId, result.name, result.iconSrc);
+ * performance.setBufferSize(100);
+ * observer.observe({ entryTypes: ['render'] });
+ * console.log(performance.getEntriesByType('render'));
+ * observer.disconnect();
  * ```
  *
- * @since 0.0.34
- * @contractStatus verified | 由智能服务运行环境同步读取，字段与公开类型一致。
- * @platformSupport Android | supported | 支持同步读取当前 package 信息。
- * @platformSupport iOS | supported | 支持同步读取当前 package 信息。
+ * @since 0.0.42
+ * @contractStatus verified | Android 支持同步查询已记录的性能 Entry、设置缓冲区大小，并向已观察的运行时发送新完成的 Entry。
+ * @platformSupport Android | supported | 支持查询性能 Entry、设置性能缓冲区大小和创建性能观察者。
+ * @platformSupport iOS | unsupported | 当前未提供该平台实现。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
  * @platformSupport HarmonyOS | unsupported | 当前未提供该平台实现。
  * @permission none | - | none | Android,iOS | 无需额外权限
  * @precondition All | 无额外前置条件
+ * @usageNote All | 仅在需要接收后续新完成的 Entry 时创建 observer；不再需要时调用 disconnect。
  * @resultExample
  * ```json
- * {
- *   "appId": "7000000000000000000",
- *   "name": "示例智能服务",
- *   "iconSrc": "https://example.com/icon.png"
- * }
+ * [
+ *   {
+ *     "entryType": "render",
+ *     "name": "firstRender",
+ *     "startTime": 1730000000000,
+ *     "duration": 42,
+ *     "path": "pages/index/index",
+ *     "pageId": 1
+ *   }
+ * ]
  * ```
  * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
  *
  * @public
  */
-export declare const getPackageInfoSync: () => GetPackageInfoResult;
+export declare function getPerformance(): Performance_2;
 
 /**
  * 获取隐私设置状态。
@@ -4495,7 +4835,7 @@ export declare interface GetSettingParams {
 export declare interface GetSettingResult {
     /** 用户授权结果，key 为权限 scope，value 表示是否已授权 */
     authSetting: AuthSetting;
-    /** 用户订阅消息设置，withSubscriptions 为 true 时才会返回 */
+    /** 预留的订阅消息设置字段。豆包当前仅支持 `withSubscriptions: false`，因此不会返回该字段。 */
     subscriptionsSetting?: SubscriptionsSetting;
 }
 
@@ -4696,7 +5036,7 @@ export declare function getStorageSync<TData = unknown>(params: GetStorageParams
 /**
  * 获取系统信息。
  *
- * @returns 返回设备品牌、型号、屏幕尺寸、宿主信息和安全区域等字段，见 {@link GetSystemInfoResult}。
+ * @returns 返回设备品牌、型号、屏幕尺寸、豆包客户端信息和安全区域等字段，见 {@link GetSystemInfoResult}。
  * @example
  * ```typescript
  * import { getSystemInfo } from '@doubao-dev/framework/api';
@@ -4709,7 +5049,7 @@ export declare function getStorageSync<TData = unknown>(params: GetStorageParams
  *
  * @since 0.0.34
  * @contractStatus verified | 设备品牌、屏幕尺寸、系统信息和安全区域等字段与公开类型一致。
- * @contractMismatch non-blocking | return | abi | Android,iOS | abi 为可选字段，返回宿主 App 二进制接口类型 | Android 返回具体 abi，iOS 不返回该字段 | 依赖 abi 的逻辑仅在 Android 生效 | packages/open-api/src/basic/system/system.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/system/GetSystemInfoMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/System | 明确 abi 为 Android 专属字段，或补齐 iOS 对应字段
+ * @contractMismatch non-blocking | return | abi | Android,iOS | abi 为可选字段，返回豆包客户端二进制接口类型 | Android 返回具体 abi，iOS 不返回该字段 | 依赖 abi 的逻辑仅在 Android 生效 | packages/open-api/src/basic/system/system.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/system/GetSystemInfoMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/System | 明确 abi 为 Android 专属字段，或补齐 iOS 对应字段
  * @platformSupport Android | supported | 支持获取系统信息。
  * @platformSupport iOS | supported | 支持获取系统信息。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -4748,7 +5088,7 @@ export declare function getStorageSync<TData = unknown>(params: GetStorageParams
  * }
  * ```
  * @errorCode common | 102 | Android
- * @platformNote Android | abi 返回宿主 App 二进制接口类型（如 arm64-v8a），iOS 不返回该字段
+ * @platformNote Android | abi 返回豆包客户端二进制接口类型（如 arm64-v8a），iOS 不返回该字段
  *
  * @public
  */
@@ -4774,7 +5114,7 @@ export declare interface GetSystemInfoResult {
     statusBarHeight: number;
     /** 系统语言，格式为 language_region，如 zh_CN、en_US */
     language: string;
-    /** 宿主版本号 */
+    /** 豆包客户端版本号 */
     version?: string;
     /** 操作系统及版本，如 "Android 14"、"iOS 17.5" */
     system: string;
@@ -4792,14 +5132,14 @@ export declare interface GetSystemInfoResult {
     enableDebug?: boolean;
     /** 设备方向 */
     deviceOrientation?: 'portrait' | 'landscape';
-    /** 宿主 App 二进制接口类型（如 arm64-v8a），仅 Android 返回 */
+    /** 豆包客户端二进制接口类型（如 arm64-v8a），仅 Android 返回 */
     abi?: string;
 }
 
 /**
  * 同步获取系统信息。
  *
- * @returns 返回设备品牌、型号、屏幕尺寸、宿主信息和安全区域等字段，见 {@link GetSystemInfoResult}。
+ * @returns 返回设备品牌、型号、屏幕尺寸、豆包客户端信息和安全区域等字段，见 {@link GetSystemInfoResult}。
  * @example
  * ```typescript
  * import { getSystemInfoSync } from '@doubao-dev/framework/api';
@@ -4812,7 +5152,7 @@ export declare interface GetSystemInfoResult {
  *
  * @since 0.0.34
  * @contractStatus verified | 设备品牌、屏幕尺寸、系统信息和安全区域等字段与公开类型一致。
- * @contractMismatch non-blocking | return | abi | Android,iOS | abi 为可选字段，返回宿主 App 二进制接口类型 | Android 返回具体 abi，iOS 不返回该字段 | 依赖 abi 的逻辑仅在 Android 生效 | packages/open-api/src/basic/system/system.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/system/GetSystemInfoMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/System | 明确 abi 为 Android 专属字段，或补齐 iOS 对应字段
+ * @contractMismatch non-blocking | return | abi | Android,iOS | abi 为可选字段，返回豆包客户端二进制接口类型 | Android 返回具体 abi，iOS 不返回该字段 | 依赖 abi 的逻辑仅在 Android 生效 | packages/open-api/src/basic/system/system.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/system/GetSystemInfoMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/System | 明确 abi 为 Android 专属字段，或补齐 iOS 对应字段
  * @platformSupport Android | supported | 支持同步获取系统信息。
  * @platformSupport iOS | supported | 支持同步获取系统信息。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -4851,7 +5191,7 @@ export declare interface GetSystemInfoResult {
  * }
  * ```
  * @errorCode common | 102 | Android
- * @platformNote Android | abi 返回宿主 App 二进制接口类型（如 arm64-v8a），iOS 不返回该字段
+ * @platformNote Android | abi 返回豆包客户端二进制接口类型（如 arm64-v8a），iOS 不返回该字段
  *
  * @public
  */
@@ -5404,6 +5744,19 @@ export declare interface KeyboardHeightChangeEvent {
 /** @public */
 export declare type KeyboardHeightChangeListener = (event: KeyboardHeightChangeEvent) => void;
 
+/**
+ * 定位精细授权状态。
+ *
+ * 继承 {@link UnauthorizedDetail} 的全部取值；获得权限时返回：
+ * - `foreground approximate`：仅应用在前台时可以获取模糊定位。
+ * - `foreground precise`：仅应用在前台时可以获取精确定位。
+ * - `background approximate`：应用在前台或后台时均可以获取模糊定位。
+ * - `background precise`：应用在前台或后台时均可以获取精确定位。
+ *
+ * @public
+ */
+export declare type LocationAuthorizationDetail = UnauthorizedDetail | 'foreground approximate' | 'foreground precise' | 'background approximate' | 'background precise';
+
 /** @public */
 export declare interface LocationChangeErrorEvent {
     /**
@@ -5774,6 +6127,13 @@ export declare interface MenuButtonBoundingClientRect {
     left: number;
 }
 
+/**
+ * 麦克风精细授权状态，取值与 {@link BasicAuthorizationDetail} 一致。
+ *
+ * @public
+ */
+export declare type MicrophoneAuthorizationDetail = BasicAuthorizationDetail;
+
 /**
  * {@link FileSystemManager.mkdir} 的参数。
  *
@@ -5906,6 +6266,16 @@ export declare type NetworkStatusChangeListener = (event: NetworkStatusChangeEve
  */
 export declare type NetworkType = 'wifi' | '2g' | '3g' | '4g' | '5g' | 'unknown' | 'none';
 
+/**
+ * 通知精细授权状态。
+ *
+ * 继承 {@link BasicAuthorizationDetail} 的全部取值，并增加：
+ * - `provisional`：iOS 临时静默授权；不会弹出授权框，通知只进入通知中心。
+ *
+ * @public
+ */
+export declare type NotificationAuthorizationDetail = BasicAuthorizationDetail | 'provisional';
+
 /**
  * 订阅 BLE 特征值变化。
  *
@@ -6210,6 +6580,43 @@ export declare const onBluetoothAdapterStateChange: ClientEventRegistry<GetBluet
  */
 export declare function onBluetoothDeviceFound(callback: BluetoothDeviceFoundListener): () => void;
 
+/**
+ * 监听对话框高度或展示状态变化。
+ *
+ * 注册后不会立即回调当前值。需要当前状态时，先调用 {@link getChatPanelInfo}。
+ *
+ * @example
+ * ```typescript
+ * import { onChatPanelHeightChanged } from '@doubao-dev/framework/api';
+ *
+ * const off = onChatPanelHeightChanged(({ height, state }) => {
+ *   console.log('chat panel changed', { height, state });
+ * });
+ *
+ * off();
+ * ```
+ * @since 0.0.42
+ * @contractStatus verified | 事件字段、状态枚举和触发语义与对话框高度变化协议一致。
+ * @platformSupport Android | supported | 支持监听对话框高度或展示状态变化。
+ * @platformSupport iOS | supported | 支持监听对话框高度或展示状态变化。
+ * @platformSupport PC | unsupported | 当前未提供该平台实现。
+ * @platformSupport HarmonyOS | unsupported | 当前未提供该平台实现。
+ * @permission none | - | none | Android,iOS | 无需额外权限
+ * @precondition All | 当前页面需在 app.config.ts 中声明 chat.enabled 为 true
+ * @usageNote All | 注册后不立即回调当前值；页面卸载前调用返回的取消函数。
+ * @resultExample
+ * ```json
+ * {
+ *   "height": 336,
+ *   "state": "expanded"
+ * }
+ * ```
+ * @errorCode none | - | - | Android,iOS | 事件无错误码 | 无需处理
+ *
+ * @public
+ */
+export declare const onChatPanelHeightChanged: ClientEventRegistry<ChatPanelInfo>;
+
 /**
  * 监听罗盘数据变化事件。
  *
@@ -6499,7 +6906,7 @@ export declare const onNetworkStatusChange: ClientEventRegistry<NetworkStatusCha
 /**
  * 监听应用主题变化。
  *
- * 当用户在系统设置或宿主内切换浅色、深色主题时触发。回调参数中的 `theme` 表示切换后的主题，可与
+ * 当用户在系统设置或豆包客户端内切换浅色、深色主题时触发。回调参数中的 `theme` 表示切换后的主题，可与
  * {@link getAppBaseInfo} 返回的 `theme` 字段配合使用。
  *
  * @summary 监听应用主题变化。
@@ -6517,7 +6924,7 @@ export declare const onNetworkStatusChange: ClientEventRegistry<NetworkStatusCha
  *
  * @since 0.0.32
  * @contractStatus verified | 主题变化事件回调只包含必需的 theme 字段，与公开类型一致。
- * @contractMismatch non-blocking | behavior | onThemeChange | Android | 用户切换浅色、深色主题时触发回调 | iOS 由客户端主动派发事件，Android 依赖宿主接入主题变化通知，未接入时可能不触发 | Android 上事件触发依赖宿主接入情况 | packages/open-api/src/basic/system/system.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge; ai-sdk/ios/AISDK/Sources/JSBridge | 统一双端主题变化事件派发，保证 Android 稳定触发
+ * @contractMismatch non-blocking | behavior | onThemeChange | Android | 用户切换浅色、深色主题时触发回调 | iOS 由客户端主动派发事件，Android 依赖豆包客户端接入主题变化通知，未接入时可能不触发 | Android 上事件触发依赖豆包客户端的接入情况 | packages/open-api/src/basic/system/system.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge; ai-sdk/ios/AISDK/Sources/JSBridge | 统一双端主题变化事件派发，保证 Android 稳定触发
  * @platformSupport Android | supported | 支持注册主题变化监听。
  * @platformSupport iOS | supported | 支持注册主题变化监听。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -6532,7 +6939,7 @@ export declare const onNetworkStatusChange: ClientEventRegistry<NetworkStatusCha
  * }
  * ```
  * @errorCode none | - | - | Android,iOS | 该监听只接收成功的主题变化事件 | 无需处理
- * @platformNote Android | 主题变化事件依赖宿主接入主题通知，未接入时可能不触发
+ * @platformNote Android | 主题变化事件依赖豆包客户端接入主题通知，未接入时可能不触发
  *
  * @public
  */
@@ -6763,6 +7170,64 @@ export declare interface OpenLocationParams {
     latitude: number;
 }
 
+/**
+ * 打开应用内页面。
+ *
+ * 在对话流卡片中调用时会重新打开全页并忽略 `mode`；在全页中调用时按照 `mode` 操作页面栈。
+ *
+ * @param params 打开页面参数，字段见 {@link OpenPageParams}。
+ * @returns 无返回字段。
+ * @example
+ * ```typescript
+ * import { openPage } from '@doubao-dev/framework/api';
+ *
+ * await openPage({
+ *   url: '/pages/detail/index?id=1',
+ *   mode: 'navigate'
+ * });
+ * ```
+ *
+ * @since 0.0.42
+ * @contractStatus conflict | 新版 url 和页面栈 mode 协议已公开，但当前 Android、iOS 尚未提供对应实现。
+ * @contractMismatch blocking | parameter | params | Android | 接收 url 和可选的 push、replace、navigate、popTo mode | 当前 doubao.openPage 仍映射到旧版 applet.openPage，要求 pageId 和 context，且 mode 仅识别 full、popup、floating | 按新版参数调用无法打开页面 | packages/open-api/src/router/open-page.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/router/AbsOpenPageMethodIDL.kt; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/router/OpenPageMethod.kt | Native 使用独立的 doubao.openPage handler 实现新版参数和路由语义
+ * @contractMismatch blocking | platform | method registration | iOS | doubao.openPage 可按新版参数调用 | 当前只注册 applet.openPage，未注册新版 doubao.openPage | iOS 无法调用该 API | packages/open-api/src/router/open-page.ts; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Route/AIBridgeOpenPageMethod.swift; ai-sdk/ios/AISDK/Sources/Core/AISDK.swift | 注册独立的 doubao.openPage handler 并实现新版路由语义
+ * @platformSupport Android | unsupported | 当前版本尚未提供新版 openPage 路由协议。
+ * @platformSupport iOS | unsupported | 当前版本尚未提供新版 openPage 路由协议。
+ * @platformSupport PC | unsupported | 当前未提供该平台实现。
+ * @platformSupport HarmonyOS | unsupported | 当前未提供该平台实现。
+ * @permission none | - | none | Android,iOS | 无需额外权限
+ * @precondition All | 无额外前置条件
+ * @usageNote All | mode 省略时按 push 处理；对话流卡片中始终重新打开全页，全页中才应用页面栈操作。
+ * @errorCode none | - | - | Android,iOS | 当前没有可审计的新版 Native 失败字段 | 等待 Native 实现后补充错误处理
+ *
+ * @public
+ */
+export declare const openPage: (params: OpenPageParams) => Promise<object>;
+
+/**
+ * 打开页面时使用的页面栈操作。
+ *
+ * @public
+ */
+export declare type OpenPageMode = 'push' | 'replace' | 'navigate' | 'popTo';
+
+/** @public */
+export declare interface OpenPageParams {
+    /** 应用内页面路径，可携带查询参数。 */
+    url: string;
+    /**
+     * 页面栈操作。
+     *
+     * - `push`：始终压入新的页面实例。
+     * - `replace`：目标为栈顶页面时更新栈顶页面，否则替换栈顶页面。
+     * - `navigate`：目标已在栈中时回退到最近的目标页面并更新，否则压入新页面。
+     * - `popTo`：目标已在栈中时回退到最近的目标页面并更新，否则替换栈顶页面。
+     *
+     * @default 'push'
+     */
+    mode?: OpenPageMode;
+}
+
 /**
  * 打开智能服务授权设置页面
  *
@@ -6771,7 +7236,7 @@ export declare interface OpenLocationParams {
  * @returns Promise 对象，设置页关闭后返回最新授权设置
  * @remarks
  * 该接口不要求在用户点击事件中调用。
- * 注意：当前宿主暂不支持订阅模板，传入 `withSubscriptions: true` 时会由宿主返回失败，错误信息为 `subscription templates are not supported yet`。
+ * JavaScript 调用方也不要传入 `withSubscriptions: true`，否则豆包会返回 `subscription templates are not supported yet`。
  * @example
  * ```typescript
  * import { openSetting } from '@doubao-dev/framework/api';
@@ -6823,10 +7288,104 @@ export declare interface OpenSettingOptions {
 export declare interface OpenSettingResult {
     /** 用户授权结果，key 为权限 scope，value 表示是否已授权 */
     authSetting: AuthSetting;
-    /** 用户订阅消息设置，withSubscriptions 为 true 时才会返回 */
+    /** 预留的订阅消息设置字段。豆包当前仅支持 `withSubscriptions: false`，因此不会返回该字段。 */
     subscriptionsSetting?: SubscriptionsSetting;
 }
 
+/** @public */
+declare interface Performance_2 {
+    /**
+     * 创建性能观察者。调用返回对象的 `observe` 后，回调会接收之后新完成且匹配的 Entry。
+     */
+    createObserver: (callback: PerformanceObserverCallback_2) => PerformanceObserver_2;
+    /** 设置客户端最多保留的性能 Entry 数量。 */
+    setBufferSize: (size: number) => void;
+    /** 返回当前智能服务已记录的全部性能 Entry。 */
+    getEntries: () => PerformanceEntry_2[];
+    /** 返回指定 entryType 的性能 Entry。 */
+    getEntriesByType: (entryType: string) => PerformanceEntry_2[];
+    /** 返回指定名称的性能 Entry；传入 entryType 时同时按类型筛选。 */
+    getEntriesByName: (name: string, entryType?: string) => PerformanceEntry_2[];
+}
+export { Performance_2 as Performance }
+
+/** @public */
+declare interface PerformanceEntry_2 {
+    /** 性能指标所属类别。 */
+    entryType: PerformanceEntryType;
+    /** 性能指标名称，例如 `appLaunch`、`route`、`evaluateScript` 或 `firstRender`。 */
+    name: string;
+    /** 指标开始或发生时刻的 Unix 时间戳，单位为毫秒。 */
+    startTime: number;
+    /** 指标持续时间，单位为毫秒；仅耗时类指标提供。 */
+    duration?: number;
+    /** 页面路径；仅页面的 navigation 和 render 类型指标提供。 */
+    path?: string;
+    /** `path` 对应的页面实例 Id（随机生成，不保证递增）；仅页面相关指标提供。 */
+    pageId?: number;
+    /** 路由来源页面的路径；仅 `navigation / route` 指标提供。 */
+    referrerPath?: string;
+    /** 路由来源页面的实例 ID；仅 `navigation / route` 指标提供。 */
+    referrerPageId?: number;
+    /** 路由开始被渲染层处理的 Unix 时间戳，单位为毫秒；仅 navigation 类型指标提供。 */
+    navigationStart?: number;
+    /** 路由类型。仅 navigation 类型的 Entry 有效。 */
+    navigationType?: string;
+    /** 被执行脚本的模块名称；仅 `script / evaluateScript` 指标提供。 */
+    moduleName?: string;
+    /** 视图层准备完成的 Unix 时间戳，单位为毫秒；仅 `render / firstRender` 指标提供。 */
+    viewLayerReadyTime?: number;
+    /** 视图层首次渲染开始的 Unix 时间戳，单位为毫秒；仅 `render / firstRender` 指标提供。 */
+    viewLayerRenderStartTime?: number;
+    /** 视图层首次渲染结束的 Unix 时间戳，单位为毫秒；仅 `render / firstRender` 指标提供。 */
+    viewLayerRenderEndTime?: number;
+    /** Widget 标识；仅 Widget 的 render 类型指标提供。 */
+    widgetId?: string;
+    /** Widget 实例 Id（随机生成，不保证递增）；仅 Widget 的 render 类型指标提供。 */
+    widgetInstanceId?: string;
+    /** Widget 关联的应用是否冷启动；仅 Widget 的 render 类型指标提供。 */
+    isAppColdLaunch?: boolean;
+}
+export { PerformanceEntry_2 as PerformanceEntry }
+
+/** @public */
+export declare type PerformanceEntryType = 'navigation' | 'script' | 'render';
+
+/** @public */
+declare interface PerformanceObserver_2 {
+    observe(options: PerformanceObserverOptions): void;
+    disconnect(): void;
+}
+export { PerformanceObserver_2 as PerformanceObserver }
+
+/** @public */
+declare type PerformanceObserverCallback_2 = (entryList: PerformanceObserverEntryList_2) => void;
+export { PerformanceObserverCallback_2 as PerformanceObserverCallback }
+
+/** @public */
+declare interface PerformanceObserverEntryList_2 {
+    getEntries(): PerformanceEntry_2[];
+    getEntriesByType(entryType: string): PerformanceEntry_2[];
+    getEntriesByName(name: string, entryType?: string): PerformanceEntry_2[];
+}
+export { PerformanceObserverEntryList_2 as PerformanceObserverEntryList }
+
+/** @public */
+export declare interface PerformanceObserverOptions {
+    entryTypes: string[];
+}
+
+/**
+ * 系统日历精细授权状态。
+ *
+ * 继承 {@link BasicAuthorizationDetail} 的全部取值，并增加：
+ * - `read only`：只能读取日历，不能新增、修改或删除日程；仅 Android 支持。
+ * - `write only`：只能新增日程，不能读取现有日历数据。
+ *
+ * @public
+ */
+export declare type PhoneCalendarAuthorizationDetail = BasicAuthorizationDetail | 'read only' | 'write only';
+
 /**
  * 插件账号信息（仅在插件中调用时包含）。
  *
@@ -8721,15 +9280,14 @@ export declare interface ShowLoadingParams {
  * ```
  *
  * @since 0.0.26
- * @contractStatus verified | 公开参数、返回动作及 Android、iOS 行为已核对一致；按钮默认文案存在平台差异，已在字段约束中说明。
- * @contractMismatch non-blocking | default | confirmText、cancelText | Android,iOS | 省略时使用统一默认文案 | Android 默认 confirm/cancel，iOS 默认 OK/Cancel | 未传文案时双端按钮文字不同，公开可选类型可承载 | ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/ui/ShowModalMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/UI/AIBridgeShowModalMethod.swift | 统一双端默认按钮文案
+ * @contractStatus verified | 参数、返回 action/content 及 Android、iOS 行为已核对一致；HarmonyOS 当前不提供实现。
  * @platformSupport Android | supported | 支持展示模态对话框。
  * @platformSupport iOS | supported | 支持展示模态对话框。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
  * @platformSupport HarmonyOS | unsupported | 当前未提供该平台实现。
  * @permission none | - | none | Android,iOS | 无需额外权限
  * @precondition All | 无额外前置条件
- * @usageNote All | content 必填；仅当 showCancel 为 true 时展示取消按钮，仅当 tapMaskToDismiss 为 true 时点击蒙层可关闭。
+ * @usageNote All | 仅当 showCancel 为 true 时展示取消按钮；仅当 tapMaskToDismiss 为 true 时点击蒙层可关闭；editable 为 true 且用户确认时返回输入 content。
  * @resultExample
  * ```json
  * {
@@ -8740,7 +9298,7 @@ export declare interface ShowLoadingParams {
  *
  * @public
  */
-export declare const showModal: (params: ShowModalParams) => Promise<ShowModalResult>;
+export declare const showModal: (params?: ShowModalParams | undefined) => Promise<ShowModalResult>;
 
 /**
  * 显示模态对话框的参数。
@@ -8753,25 +9311,50 @@ export declare interface ShowModalParams {
      * @default -
      */
     title?: string;
-    /** 模态对话框的内容。 */
-    content: string;
+    /**
+     * 模态对话框的内容。
+     * @default -
+     */
+    content?: string;
     /**
      * 是否显示取消按钮。
      * @default true
      */
     showCancel?: boolean;
     /**
-     * 取消按钮的文字，省略时使用平台默认文案。
-     * @default -
-     * @constraint Android 默认文案为“cancel”，iOS 默认文案为“Cancel”，需统一时请显式传入。
+     * 取消按钮的文字。
+     * @default 取消
+     * @constraint 最多 4 个字符。
      */
     cancelText?: string;
     /**
-     * 确认按钮的文字，省略时使用平台默认文案。
-     * @default -
-     * @constraint Android 默认文案为“confirm”，iOS 默认文案为“OK”，需统一时请显式传入。
+     * 取消按钮的文字颜色。
+     * @default #000000
+     * @constraint 必须是 16 进制格式的颜色字符串。
+     */
+    cancelColor?: string;
+    /**
+     * 确认按钮的文字。
+     * @default 确定
+     * @constraint 最多 4 个字符。
      */
     confirmText?: string;
+    /**
+     * 确认按钮的文字颜色。
+     * @default #F85959
+     * @constraint 必须是 16 进制格式的颜色字符串。
+     */
+    confirmColor?: string;
+    /**
+     * 是否显示输入框。
+     * @default false
+     */
+    editable?: boolean;
+    /**
+     * 显示输入框时的提示文本。
+     * @default -
+     */
+    placeholderText?: string;
     /**
      * 是否允许点击蒙层关闭对话框。
      * @default true
@@ -8787,22 +9370,17 @@ export declare interface ShowModalParams {
 export declare interface ShowModalResult {
     /** 用户点击的动作。 */
     action: 'confirm' | 'cancel' | 'mask';
+    /** `editable` 为 true 时，用户点击确认后输入的文本。 */
+    content?: string;
 }
 
 /**
  * 显示 Toast 提示。
  *
- * 参数 `options` 包含以下字段：
- * - `message`：提示的内容。
- * - `type`：Toast 的类型，可选值为 'default'、'success'、'error' 或 'warning'。
- * - `duration`：提示的延迟时间，单位毫秒，默认为 2000。
- * - `icon`：图标，可选值为 'success'、'error'、'warn'。
- * - `customIcon`：自定义图标的 URL 或 base64 字符串。
- *
  * @summary 显示 Toast 提示。
  * @returns 返回一个 Promise，在 Toast 显示结束时 resolve。
  * @remarks
- * duration 和 icon 可控制提示表现。
+ * Android 默认显示 3000 毫秒，iOS 默认显示 2000 毫秒；需要双端一致时请显式传入 `duration`。
  * @example
  * ```typescript
  * import { showToast } from '@doubao-dev/framework/api';
@@ -8849,7 +9427,7 @@ export declare interface ShowModalResult {
  * @errorCode errNo | 104 | invalid parameter | Android,iOS | message 为空；iOS 还会在 icon 取值非法或入参无法解析时返回（type 由前端归一化为合法值，非法 type 场景不会触发） | 修正参数后重试。
  * @errorCode errNo | 103 | feature not support | iOS | 豆包 UIService 未实现，无法展示 Toast | 降级到其他提示方式。
  * @errorCode common | 102 | Android
- * @platformNote iOS | 参数校验失败统一返回 errNo 104；UIService 缺失时返回 errNo 103。Android 参数校验失败返回 errNo 104，宿主上下文缺失返回 errNo 102。
+ * @platformNote iOS | 参数校验失败统一返回 errNo 104；UIService 缺失时返回 errNo 103。Android 参数校验失败返回 errNo 104，豆包页面运行上下文缺失返回 errNo 102。
  *
  * @public
  * */
@@ -8866,8 +9444,8 @@ export declare interface ShowToastParams {
     type?: 'default' | 'success' | 'error' | 'warning';
     /**
      * 提示的持续时间，单位毫秒。
-     * @default -
-     * @constraint Android 默认 3000，iOS 默认 2000，需双端一致时请显式传入。
+     * @default Android 3000，iOS 2000
+     * @constraint 需双端保持一致时请显式传入。
      */
     duration?: number;
     /**
@@ -8888,7 +9466,7 @@ export declare interface ShowToastParams {
  * @param params - `createSignOrder` 返回的平台签约订单号。
  * @returns 签约页面流程正常返回时解析为空对象；该结果不代表签约成功。
  * @remarks
- * 如果用户尚未绑定抖音账号，宿主可能先拉起账号绑定流程，再继续展示签约页面。
+ * 如果用户尚未绑定抖音账号，豆包可能先拉起账号绑定流程，再继续展示签约页面。
  *
  * 用户的最终签约状态必须以业务服务端查询签约单详情或收到的签约结果回调为准。
  * 业务服务端还需要维护业务用户与签约 ID 的对应关系。
@@ -8996,7 +9574,7 @@ export declare interface SocketTask {
     /**
      * 表示 Socket 正在连接。
      *
-     * `connectSocket` 刚返回且宿主尚未完成握手时通常处于该状态。
+     * `connectSocket` 刚返回且豆包客户端尚未完成握手时通常处于该状态。
      */
     readonly CONNECTING: 0;
     /**
@@ -9008,7 +9586,7 @@ export declare interface SocketTask {
     /**
      * 表示 Socket 连接关闭中。
      *
-     * 调用 {@link SocketTask.close} 后、本地等待宿主侧完成关闭流程时通常处于该状态。
+     * 调用 {@link SocketTask.close} 后，等待豆包客户端完成关闭流程时通常处于该状态。
      */
     readonly CLOSING: 2;
     /**
@@ -9021,7 +9599,7 @@ export declare interface SocketTask {
      * 当前 Socket 连接状态 code。
      *
      * 可与 `CONNECTING`、`OPEN`、`CLOSING`、`CLOSED` 常量比较。
-     * 如果因为参数错误等原因导致连接请求没有被宿主成功创建，则为 `undefined`。
+     * 如果因为参数错误等原因导致豆包客户端没有成功创建连接，则为 `undefined`。
      */
     readonly readyState: number | undefined;
     /**
@@ -9073,7 +9651,7 @@ export declare interface SocketTask {
 /**
  * WebSocket 关闭事件。
  *
- * 当前连接被主动关闭、服务端关闭或宿主侧因异常回收连接时触发。
+ * 当前连接被主动关闭、服务端关闭或豆包客户端因异常回收连接时触发。
  * 触发后 `readyState` 会变为 `SocketTask.CLOSED`，该 `SocketTask` 不应再继续发送数据。
  *
  * @public
@@ -9082,31 +9660,31 @@ export declare interface SocketTaskCloseEvent {
     /**
      * 关闭状态码。
      *
-     * 可能来自调用 {@link SocketTask.close} 时传入的 `code`，也可能来自服务端或宿主侧。
+     * 可能来自调用 {@link SocketTask.close} 时传入的 `code`，也可能来自服务端或豆包客户端。
      */
     code?: number;
     /**
      * 关闭原因。
      *
-     * 可能来自调用 {@link SocketTask.close} 时传入的 `reason`，也可能来自服务端或宿主侧。
+     * 可能来自调用 {@link SocketTask.close} 时传入的 `reason`，也可能来自服务端或豆包客户端。
      */
     reason?: string;
     /**
      * 错误信息。
      *
-     * 非正常关闭时宿主侧可能通过该字段补充失败原因；正常关闭时通常为空。
+     * 非正常关闭时豆包客户端可能通过该字段补充失败原因；正常关闭时通常为空。
      */
     errMsg?: string;
     /**
      * 当前连接使用的网络传输层协议。
      *
-     * 该字段由宿主侧返回，部分运行环境可能不提供。
+     * 该字段由豆包客户端返回，部分运行环境可能不提供。
      */
     protocolType?: string;
     /**
-     * 宿主侧使用的 WebSocket 实现类型。
+     * 豆包客户端使用的 WebSocket 实现类型。
      *
-     * 该字段由宿主侧返回，部分运行环境可能不提供。
+     * 该字段由豆包客户端返回，部分运行环境可能不提供。
      */
     socketType?: string;
 }
@@ -9123,10 +9701,10 @@ export declare interface SocketTaskCloseParams {
     /**
      * 关闭连接状态码。
      *
-     * 不传时由宿主侧按正常关闭处理，通常等价于 `1000`。
+     * 不传时由豆包客户端按正常关闭处理，通常等价于 `1000`。
      * 常见值包括：
      * - `1000`: 正常关闭；
-     * - `1001`: 因页面进入后台、宿主回收连接等原因关闭。
+     * - `1001`: 因页面进入后台、豆包客户端回收连接等原因关闭。
      */
     code?: number;
     /**
@@ -9149,7 +9727,7 @@ export declare interface SocketTaskErrorEvent {
     /**
      * 错误信息。
      *
-     * 由前端参数校验、编码过程或宿主侧返回的失败原因组成，可直接用于日志上报。
+     * 由前端参数校验、编码过程或豆包客户端返回的失败原因组成，可直接用于日志上报。
      */
     errMsg: string;
 }
@@ -9175,13 +9753,13 @@ export declare interface SocketTaskMessageEvent {
     /**
      * 当前消息所属连接使用的协议。
      *
-     * 该字段由宿主侧返回，部分运行环境可能不提供。
+     * 该字段由豆包客户端返回，部分运行环境可能不提供。
      */
     protocolType?: string;
     /**
-     * 宿主侧使用的 WebSocket 实现类型。
+     * 豆包客户端使用的 WebSocket 实现类型。
      *
-     * 该字段由宿主侧返回，部分运行环境可能不提供。
+     * 该字段由豆包客户端返回，部分运行环境可能不提供。
      */
     socketType?: string;
 }
@@ -9189,7 +9767,7 @@ export declare interface SocketTaskMessageEvent {
 /**
  * WebSocket 连接成功事件。
  *
- * 当宿主侧完成 WebSocket 握手并进入 open 状态后触发。
+ * 当豆包客户端完成 WebSocket 握手并进入 open 状态后触发。
  * 收到该事件后，调用方可以开始通过 {@link SocketTask.send} 发送数据。
  *
  * @public
@@ -9205,13 +9783,13 @@ export declare interface SocketTaskOpenEvent {
     /**
      * 当前连接使用的网络传输层协议。
      *
-     * 该字段由宿主侧返回，部分运行环境可能不提供。
+     * 该字段由豆包客户端返回，部分运行环境可能不提供。
      */
     protocolType?: string;
     /**
-     * 宿主侧使用的 WebSocket 实现类型。
+     * 豆包客户端使用的 WebSocket 实现类型。
      *
-     * 可能的值由宿主实现决定，例如传统 WebSocket 实现或宿主网络库实现；
+     * 可能的值由豆包客户端实现决定，例如系统 WebSocket 实现或豆包网络库实现；
      * 部分运行环境可能不提供。
      */
     socketType?: string;
@@ -9230,7 +9808,7 @@ export declare interface SocketTaskSendParams {
      * 需要发送给服务端的数据。
      *
      * - 传入 `string` 时按文本消息发送；
-     * - 传入 `ArrayBuffer` 时按二进制消息发送，内部会编码后交给宿主侧处理。
+     * - 传入 `ArrayBuffer` 时按二进制消息发送，内部会编码后交给豆包客户端处理。
      *
      * 建议只在 `onOpen` 回调触发后调用 `send`，此时 `readyState` 通常为 `SocketTask.OPEN`。
      */
@@ -9613,14 +10191,14 @@ export declare interface StartGyroscopeParams {
  * }
  * ```
  * @errorCode common | 102 | Android,iOS
- * @errorCode errNo | 103 | feature not support | Android,iOS | 宿主未注册持续定位能力（location service 不可用） | 确认宿主已集成持续定位能力，不可用时不要调用
+ * @errorCode errNo | 103 | feature not support | Android,iOS | 当前豆包客户端未提供持续定位能力（location service 不可用） | 请在支持持续定位的豆包版本中调用
  * @errorCode errNo | 114 | operation cancelled | Android,iOS | 启动过程中被取消（用户取消授权，或授权返回前已调用 stopLocationUpdate） | 需要时重新调用 startLocationUpdate
  * @errorCode errNo | 118 | already exists | Android,iOS | 持续定位已启动，重复调用 startLocationUpdate | 先调用 stopLocationUpdate 再重新启动
  * @errorCode errNo | 1700001 | location permission denied | Android,iOS | 用户拒绝应用位置授权或系统定位权限被拒 | 调用 authorize 重新发起授权并在系统设置中开启定位权限后重试
  * @errorCode errNo | 1700002 | location network error | Android,iOS | 位置授权过程中发生网络错误 | 检查网络连接后重试
  * @errorCode errNo | 104 | invalid parameter | iOS | 位置授权 scope 非法 | 检查应用权限声明中配置的 scope 后重试
- * @platformNote Android | 用户拒绝授权返回 1700001、取消返回 114、授权网络失败返回 1700002；宿主未注册持续定位能力返回 103；其他失败统一返回 102。
- * @platformNote iOS | 用户拒绝授权返回 1700001、取消返回 114、授权网络失败返回 1700002、非法 scope 返回 104；宿主未注册持续定位能力返回 103；其他失败统一返回 102。
+ * @platformNote Android | 用户拒绝授权返回 1700001、取消返回 114、授权网络失败返回 1700002；当前豆包客户端不支持持续定位时返回 103；其他失败统一返回 102。
+ * @platformNote iOS | 用户拒绝授权返回 1700001、取消返回 114、授权网络失败返回 1700002、非法 scope 返回 104；当前豆包客户端不支持持续定位时返回 103；其他失败统一返回 102。
  *
  * @public
  */
@@ -9930,7 +10508,7 @@ export declare const stopGyroscope: (params?: {} | undefined) => Promise<object>
  * }
  * ```
  * @errorCode common | 102 | Android,iOS
- * @errorCode errNo | 103 | feature not support | Android,iOS | 持续定位已启动，但宿主未注册持续定位能力（location service 不可用），无法停止 | 确认宿主已集成持续定位能力
+ * @errorCode errNo | 103 | feature not support | Android,iOS | 当前豆包客户端未提供持续定位能力（location service 不可用），无法停止 | 请在支持持续定位的豆包版本中调用
  * @platformNote All | 未启动或仍在授权阶段调用直接返回成功；仅在已启动后停止失败时返回错误码，其他失败统一返回 102。
  *
  * @public
@@ -10116,6 +10694,18 @@ export declare interface ThemeChangeEvent {
  */
 export declare type ThemeChangeListener = (event: ThemeChangeEvent) => void;
 
+/**
+ * Tool 返回的标准内容。
+ *
+ * @public
+ */
+export declare interface ToolResult {
+    /** Tool 返回的内容块。 */
+    content?: Array<Record<string, unknown>>;
+    /** Tool 返回的结构化内容。 */
+    structuredContent?: unknown;
+}
+
 /**
  * {@link FileSystemManager.truncate} 的参数。
  *
@@ -10139,6 +10729,18 @@ export declare interface TruncateParams {
 
 declare type TypeGuard<From, To extends From> = (from: From) => from is To;
 
+/**
+ * 尚未获得权限时的精细状态。
+ *
+ * 取值说明：
+ * - `not determined`：系统明确表示用户尚未作出选择
+ * - `denied`：当前没有权限；可能是用户拒绝、关闭权限，或平台无法进一步区分拒绝原因
+ * - `restricted`：系统明确表示权限受设备管理、家长控制等策略限制，用户无法直接修改
+ *
+ * @public
+ */
+export declare type UnauthorizedDetail = 'not determined' | 'denied' | 'restricted';
+
 /**
  * {@link FileSystemManager.unlink} 的参数。
  *
@@ -10282,10 +10884,10 @@ export declare interface UpdateModelContextParams {
  * }
  * ```
  * @errorCode common | 102 | Android,iOS
- * @errorCode errNo | 103 | feature not support | Android,iOS | 当前运行环境未接入消息更新能力（宿主消息依赖或消息服务缺失） | 请在支持卡片消息更新的豆包环境中调用。
+ * @errorCode errNo | 103 | feature not support | Android,iOS | 当前豆包环境未提供消息更新能力 | 请在支持卡片消息更新的豆包环境中调用。
  * @errorCode errNo | 104 | invalid parameter | Android,iOS | widgetInstanceId 或 widgetData 为空，或传入了空字符串的 widgetId | 传入非空的 widgetInstanceId、widgetData，并确保 widgetId 有效后重试。
  * @errorCode errNo | 116 | resource not found | Android,iOS | 依据 widgetInstanceId 找不到对应消息，或依据 widgetId 找不到已注册的 Widget | 确认 widgetInstanceId 与 widgetId 有效后重试。
- * @platformNote All | 参数为空返回 104；消息或 Widget 未找到返回 116；宿主消息依赖或消息服务缺失返回 103；其他失败统一返回 102。
+ * @platformNote All | 参数为空返回 104；消息或 Widget 未找到返回 116；当前豆包环境未提供消息更新能力时返回 103；其他失败统一返回 102。
  *
  * @public
  */
@@ -10367,7 +10969,7 @@ export declare interface UpdateWidgetParams {
  * @errorCode errNo | 121902 | uploadFile:fail no file exist | Android,iOS | filePath 为空、文件不存在或路径不是文件 | 使用文件 API 获取当前智能服务可访问的有效文件路径
  * @errorCode errNo | 121905 | uploadFile:fail upload file abort | Android,iOS | 调用 UploadTask.abort 中断上传 | 按业务需要处理取消状态，无需自动重试
  * @errorCode errNo | 121906 | uploadFile:fail file path permission denied | Android,iOS | 当前智能服务无权访问 filePath | 改用当前智能服务目录内的文件
- * @errorCode errNo | 121920 | uploadFile:fail request time out | Android,iOS | 上传超过宿主超时时间 | 检查网络或设置合理的 timeout 后重试
+ * @errorCode errNo | 121920 | uploadFile:fail request time out | Android,iOS | 上传超过豆包客户端的超时时间 | 检查网络或设置合理的 timeout 后重试
  * @errorCode errNo | 121985 | uploadFile:fail network unavailable | Android,iOS | 当前网络不可用 | 恢复网络连接后重试
  * @errorCode errNo | 121991 | uploadFile:fail network error | Android,iOS | 上传过程中发生网络错误 | 检查网络和服务端状态后重试
  * @errorCode errNo | 121992 | uploadFile:fail enableProfile is not supported | Android,iOS | enableProfile 设置为 true | 移除 enableProfile 或设置为 false
@@ -10400,14 +11002,14 @@ export declare function uploadFile(params: UploadFileParams): UploadTask;
  * @public
  */
 export declare interface UploadFileParams {
-    /** 开发者服务器地址，需为完整的 HTTP/HTTPS URL，并通过宿主侧上传域名白名单校验。 */
+    /** 开发者服务器地址，需为完整的 HTTP/HTTPS URL，并通过豆包配置的上传域名白名单校验。 */
     url: string;
     /** 要上传文件资源的本地路径。 */
     filePath: string;
     /** 文件对应的 form field name/key，服务端通过该 key 获取文件内容；multipart filename 使用 filePath 的 basename。 */
     name: string;
     /**
-     * HTTP 请求 Header。`referer`、`user-agent`、`content-type` 等宿主管控字段不会被业务覆盖。
+     * HTTP 请求 Header。`referer`、`user-agent`、`content-type` 等由豆包客户端管理的字段不会被业务覆盖。
      *
      * @default -
      */
@@ -10419,7 +11021,7 @@ export declare interface UploadFileParams {
      */
     formData?: Record<string, unknown>;
     /**
-     * 超时时间，单位 ms；不传时使用宿主侧默认超时配置。
+     * 超时时间，单位 ms；不传时使用豆包客户端的默认超时配置。
      *
      * @default -
      */
@@ -10461,7 +11063,7 @@ export declare interface UploadTask extends Promise<UploadFileResult> {
     /**
      * 监听上传进度变化。
      *
-     * 同一个任务可以注册多个回调，每次收到宿主进度事件时依次调用。
+     * 同一个任务可以注册多个回调，每次收到豆包客户端的进度事件时依次调用。
      */
     onProgressUpdate: (callback: (event: UploadTaskProgressUpdateEvent) => void) => void;
     /**
@@ -10473,7 +11075,7 @@ export declare interface UploadTask extends Promise<UploadFileResult> {
     /**
      * 监听 HTTP Response Header 事件。
      *
-     * 同一个任务可以注册多个回调，宿主收到上传响应头时依次调用。
+     * 同一个任务可以注册多个回调，豆包客户端收到上传响应头时依次调用。
      */
     onHeadersReceived: (callback: (event: UploadTaskHeadersReceivedEvent) => void) => void;
     /**