@doubao-dev/framework 0.0.40 → 0.0.42-canary-d679ede7d-20260902030825

package/dist/api.d.ts

@@ -1,3 +1,5 @@
+import type { HealthDataType as HealthDataType_2 } from '@byted-doubao-apps/bridge-api';
+
 /**
  * 加速度数据变化事件。
  *
@@ -67,6 +69,8 @@ export declare enum ActionDirectiveType {
  *
  * @since 0.0.19
  * @contractStatus verified | Android、iOS 均支持向系统日历写入一次性事件；成功通过 Promise resolve 空对象，失败通过 Promise reject。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 写入系统日历事件；path 传入后按原值追加到日历备注。
  * @platformSupport iOS | supported | 写入系统日历事件；path 传入后按原值追加到日历备注。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -155,6 +159,8 @@ export declare interface AddPhoneCalendarParams {
  *
  * @since 0.0.25
  * @contractStatus verified | Android、iOS 均支持向系统日历写入重复事件；成功通过 Promise resolve 空对象，失败通过 Promise reject。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 写入系统日历重复事件；repeatInterval 支持 day、week、month、year，path 行为与 addPhoneCalendar 一致。
  * @platformSupport iOS | supported | 写入系统日历重复事件；repeatInterval 支持 day、week、month、year，path 行为与 addPhoneCalendar 一致。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -191,12 +197,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;
 }
 
@@ -237,7 +254,7 @@ export declare interface AppendFileParams {
 export declare type AppTheme = 'light' | 'dark';
 
 /**
- * 提前向用户发起指定 scope 的应用授权。
+ * 提前向用户发起指定 scope 的授权；scope.healthData 仅用于选择 iOS HealthKit 系统授权路径。
  *
  * @param params - 授权参数，字段见 {@link AuthorizeRequest}。
  * @returns 返回一个 Promise，用户完成授权后 resolve。
@@ -246,20 +263,50 @@ export declare type AppTheme = 'light' | 'dark';
  * import { authorize } from '@doubao-dev/framework/api';
  *
  * await authorize({ scope: 'scope.userLocation' });
+ * await authorize({
+ *   scope: 'scope.healthData',
+ *   options: { types: ['heart_rate', 'step_count'] }
+ * });
  * ```
  *
  * @since 0.0.18
  * @contractStatus conflict | scope 公开声明了 scope.payment，但 Android、iOS 当前不支持该 scope。
  * @contractMismatch blocking | parameter | scope | Android,iOS | scope 可取 scope.payment | 传入 scope.payment 时被判为非法 scope 并直接失败 | 依赖 scope.payment 发起授权的调用无法成功 | packages/open-api/src/basic/authorize.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/authorize/AuthorizeFlowMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Auth/AIBridgeAuthorizeMethod.swift | 补齐豆包支付授权 scope，或从公开 scope 中移除 scope.payment
- * @platformSupport Android | supported | 支持按 scope 发起应用授权。
- * @platformSupport iOS | supported | 支持按 scope 发起应用授权。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
+ * @platformSupport Android | supported | 支持既有 scope；当前不支持 scope.healthData。
+ * @platformSupport iOS | supported | 支持既有 scope；scope.healthData 会继续申请 options.types 对应的 HealthKit 读取权限。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
  * @platformSupport HarmonyOS | unsupported | 当前未提供该平台实现。
- * @permission applet | 传入的 scope | required | Android,iOS | 按传入 scope 发起对应的应用授权。
- * @authorizationBehavior All | 调用会主动向用户发起指定 scope 的授权弹窗。用户拒绝、取消或此前已撤销授权时调用直接失败，可再次调用 `authorize` 重新发起；scope 未在应用权限声明中配置或不受支持时也会失败。
- * @precondition All | 在应用权限声明中配置需要申请的 scope。
- * @usageNote All | 授权状态可通过 `getSetting` 查询；建议在真正需要能力前再发起授权。
- * @errorCode none | - | - | Android,iOS | 用户拒绝、取消或 scope 非法等失败当前只返回文本信息，未稳定返回顶层 errNo/errMsg | 根据异常信息提示用户重新授权或检查 scope 声明
+ * @permission applet | 非 scope.healthData 的 scope | required | Android,iOS | 按传入 scope 发起对应的应用授权。
+ * @permission applet | scope.healthData | none | iOS | 不校验 manifest，也不查询或更新服务端小程序 scope 状态。
+ * @permission system | HealthKit read | required | iOS | scope.healthData 会申请 options.types 对应的系统读取权限。
+ * @authorizationBehavior Android | 非健康 scope 会发起小程序及相应系统授权；当前不支持 scope.healthData。
+ * @authorizationBehavior iOS | 非健康 scope 会发起小程序及相应系统授权；scope.healthData 仅可能展示 HealthKit 系统授权框。
+ * @precondition Android | 非健康 scope 需要在应用权限声明中配置；当前不支持 scope.healthData。
+ * @precondition iOS | 非健康 scope 需要在应用权限声明中配置；scope.healthData 不需要 manifest 声明。
+ * @usageNote Android | 非健康 scope 的授权状态可通过 `getSetting` 查询；当前不支持 scope.healthData。
+ * @usageNote iOS | 非健康 scope 的授权状态可通过 `getSetting` 查询；scope.healthData 的逐类型系统状态通过 `getAppAuthorizeSetting` 查询。
+ * @usageNote iOS | HealthKit 授权成功表示系统授权流程已完成；Apple 不向应用公开每个读取类型是否被用户拒绝。
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 107,
+ *   "errMsg": "user permission denied"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 104 | invalid parameter | Android,iOS | 传入的 scope 为空或不受支持（如 scope.payment） | 检查并传入受支持的 scope 后重试。
+ * @errorCode errNo | 104 | invalid parameter | iOS | scope.healthData 未传 options.types、列表为空或包含不支持类型 | 传入非空且受支持的健康数据类型列表。
+ * @errorCode errNo | 106 | system permission denied | Android,iOS | 对应能力的系统权限被拒绝 | 引导用户在系统设置中开启对应权限后重试。
+ * @errorCode errNo | 107 | user permission denied | Android,iOS | 用户拒绝了本次应用授权 | 说明能力用途后再次调用 `authorize` 重新发起授权。
+ * @errorCode errNo | 114 | operation cancelled | Android,iOS | 用户取消了授权弹窗 | 用户需要时可再次调用 `authorize` 重新发起授权。
+ * @errorCode errNo | 301 | network request cancelled | iOS | 授权过程中的网络请求被取消 | 确认应用和网络状态后重试。
+ * @errorCode errNo | 302 | connection timed out | iOS | 授权过程中的网络连接超时 | 检查网络连接后重试。
+ * @errorCode errNo | 303 | no network connection | iOS | 当前无可用网络连接 | 恢复网络连接后重试。
+ * @errorCode errNo | 305 | network failure | Android,iOS | 授权过程中发生其他网络错误 | 检查网络连接，稍后重试。
+ * @errorCode errNo | 112 | invalid result | iOS | 授权服务返回的数据无法解析 | 稍后重试；持续失败时反馈服务端响应异常。
+ * @platformNote iOS | 网络类失败会细分为 301/302/303/305，并可能返回 112；Android 的网络类失败统一返回 305。
  *
  * @public
  */
@@ -267,12 +314,13 @@ export declare const authorize: (params: AuthorizeRequest) => Promise<object>;
 
 /** @public */
 export declare interface AuthorizeRequest {
+    /** 授权范围。 */
+    scope: Scope;
     /**
-     * 授权范围
-     *
-     * @constraint 豆包 Android、iOS 当前不支持 scope.payment，传入后授权会失败
+     * 权限扩展参数；仅 scope.healthData 生效，用于传入 HealthKit 读取类型，其他 scope 会忽略该字段。
+     * @default -
      */
-    scope: Scope;
+    options?: HealthDataAuthorizeOptions;
 }
 
 /** @public */
@@ -424,6 +472,16 @@ export declare interface BackgroundAudioState {
     playbackRate?: number;
 }
 
+/**
+ * 只有完整授权和未授权状态的权限所使用的通用精细状态。
+ *
+ * 继承 {@link UnauthorizedDetail} 的全部取值，并增加：
+ * - `full`：已获得该权限的完整访问能力。
+ *
+ * @public
+ */
+export declare type BasicAuthorizationDetail = UnauthorizedDetail | 'full';
+
 /**
  * 电池信息变化事件。
  *
@@ -512,6 +570,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';
+
 /**
  * 蓝牙广播二进制字段。
  *
@@ -722,6 +790,156 @@ 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 错误字段一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
+ * @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。
+ *
+ * @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 名称 */
@@ -734,6 +952,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';
+
 /**
  * 检测无障碍能力是否开启。
  *
@@ -749,6 +1008,7 @@ export declare interface CanIUseResult {
  * @since 0.0.25
  * @contractStatus verified | open 字段的类型与必返性已与 Android、iOS 当前实现对齐；双端检测的无障碍能力口径不同但公开类型已准确表达
  * @contractMismatch non-blocking | behavior | 无障碍能力口径 | Android,iOS | 返回设备是否开启视觉无障碍能力 | Android 检测系统无障碍服务是否开启，iOS 检测 VoiceOver/开关控制是否开启 | 相同返回值在双端代表的具体能力不同 | ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/AIBridgeAccessibilityMethods.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeAccessibilityMethods.swift | 统一双端无障碍检测口径
+ * @containerSupport Page | supported
  * @platformSupport Android | supported | 支持检测无障碍能力
  * @platformSupport iOS | supported | 支持检测无障碍能力
  * @platformSupport PC | unsupported | 暂不支持
@@ -763,7 +1023,15 @@ export declare interface CanIUseResult {
  *   "open": false
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息重试
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 103,
+ *   "errMsg": "feature not support"
+ * }
+ * ```
+ * @errorCode common | 102 | Android
+ * @errorCode errNo | 103 | feature not support | Android | 当前运行环境无法获取系统无障碍服务 | 在具备系统无障碍服务的设备上调用。
  *
  * @public
  */
@@ -797,6 +1065,8 @@ export declare interface CheckIsOpenAccessibilityResult {
  * @contractStatus conflict | sizeType 不生效，sourceType 仅支持“只传 camera”与相册两种实际分支
  * @contractMismatch blocking | parameter | sizeType | Android,iOS | original 和 compressed 控制返回原图或压缩图 | 选择结果不受 sizeType 影响 | 调用方无法控制返回图片尺寸 | packages/open-api/src/media/image.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/media/ChooseImageMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Media/AIBridgeImageMethods.swift; flow_android/business/applet/impl/src/main/java/com/bytedance/applet/impl/AppletHostImageServiceImpl.kt; flow_ios/flow_iOS/Modules/FlowApplet/Sources/AIBridge/FlowAIBridgeService.swift | 补齐双端原图与压缩图选择逻辑，或移除公开字段
  * @contractMismatch blocking | parameter | sourceType | Android,iOS | sourceType 数组声明允许的 album、camera、user、environment 来源 | 仅当数组只包含 camera 时打开相机；其他组合均打开相册，user 和 environment 不生效 | 传入多个来源或 user、environment 时实际入口与配置不一致 | packages/open-api/src/media/image.ts; flow_android/business/applet/impl/src/main/java/com/bytedance/applet/impl/AppletHostImageServiceImpl.kt; flow_ios/flow_iOS/Modules/FlowApplet/Sources/AIBridge/FlowAIBridgeService.swift | 实现来源选择和前后摄像头语义，或收敛公开枚举
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持从相册选择图片；只传 camera 时支持拍照
  * @platformSupport iOS | supported | 支持从相册选择图片；只传 camera 时支持拍照
  * @platformSupport PC | unsupported | 暂不支持
@@ -1034,6 +1304,8 @@ export declare type ChooseMessageFileType = 'all' | 'video' | 'image' | 'file';
  *
  * @since 0.0.17
  * @contractStatus verified | 清空语义及 Android、iOS 错误字段已核对一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持清空当前智能服务的全部本地缓存。
  * @platformSupport iOS | supported | 支持清空当前智能服务的全部本地缓存。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -1060,6 +1332,8 @@ export declare const clearStorage: (params?: object | undefined) => Promise<obje
  *
  * @since 0.0.19
  * @contractStatus verified | 清空语义及 Android、iOS 错误字段已核对一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持同步清空当前智能服务的全部本地缓存。
  * @platformSupport iOS | supported | 支持同步清空当前智能服务的全部本地缓存。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -1130,6 +1404,8 @@ export { close_2 as close }
  * @returns 不包含字段的结果对象。
  * @since 0.0.25
  * @contractStatus verified | 关闭 BLE 连接的入参与返回结构已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持关闭 BLE 连接
  * @platformSupport iOS | supported | 支持关闭 BLE 连接
  * @platformSupport PC | unsupported | 暂不支持
@@ -1175,6 +1451,8 @@ export declare interface CloseBLEConnectionParams {
  * @returns 不包含字段的结果对象。
  * @since 0.0.25
  * @contractStatus verified | 关闭蓝牙适配器的入参与返回结构已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持关闭蓝牙适配器
  * @platformSupport iOS | supported | 支持关闭蓝牙适配器
  * @platformSupport PC | unsupported | 暂不支持
@@ -1236,6 +1514,8 @@ export declare type CompassChangeListener = (event: CompassChangeEvent) => void;
  * ```
  * @since 0.0.26
  * @contractStatus verified | Android、iOS 均按相同默认质量和尺寸组合规则输出 JPEG 临时文件
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持压缩豆包智能服务本地图片
  * @platformSupport iOS | supported | 支持压缩豆包智能服务本地图片
  * @platformSupport PC | unsupported | 暂不支持
@@ -1364,6 +1644,8 @@ export declare interface ConnectedBluetoothDevice {
  * @since 0.0.30
  * @contractStatus verified | ws 和 wss 均可创建连接，握手结果通过 SocketTask 事件回调通知；SocketTaskOpenEvent.header 恒为空对象已在公开类型说明中表达。
  * @contractMismatch non-blocking | return | SocketTaskOpenEvent.header | Android,iOS | 声明返回握手响应头 | 双端握手成功后该字段固定返回空对象 {} | 调用方无法通过该字段读取服务端握手 Header | packages/open-api/src/network/connect-socket.ts | 暂不对齐，公开类型已补充字段说明
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持 ws 和 wss 协议的 WebSocket 连接。
  * @platformSupport iOS | supported | 支持 ws 和 wss 协议的 WebSocket 连接。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -1378,7 +1660,23 @@ export declare interface ConnectedBluetoothDevice {
  *   "readyState": 0
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 1501001,
+ *   "errMsg": "websocket connection limit exceeded"
+ * }
+ * ```
+ * @errorCode common | 102 | Android
+ * @errorCode common | 113 | Android,iOS
+ * @errorCode errNo | 104 | invalid parameter | Android,iOS | 创建连接时 url 为空或非 ws/wss，或调用 send 时 base64 数据非法、dataType 不支持 | 传入合法的 ws/wss url 与受支持的发送数据后重试。
+ * @errorCode errNo | 110 | API call prohibited | Android,iOS | socket url 未通过域名白名单校验 | 确认目标域名已在智能服务中配置后重试。
+ * @errorCode errNo | 116 | resource not found | Android,iOS | 对已关闭或不存在的 socketTaskId 调用 send/close | 仅在 onOpen 后、onClose 前操作连接，不要复用已关闭的连接。
+ * @errorCode errNo | 305 | network failure | Android,iOS | 建立连接、发送或关闭过程中发生网络错误 | 检查网络连接，必要时重新建立连接。
+ * @errorCode errNo | 1501001 | websocket connection limit exceeded | Android,iOS | 同一智能服务的 WebSocket 连接数超过上限 | 关闭不再使用的连接后重试。
+ * @errorCode errNo | 1501002 | websocket is not open | iOS | 连接尚未打开或已关闭时调用 send | 在收到 onOpen 事件后再发送数据。
+ * @platformNote Android | 建立连接失败统一返回 102；send 在连接未打开时返回 305 或 116。
+ * @platformNote iOS | send 在连接未打开时返回 1501002。
  *
  * @public
  */
@@ -1387,13 +1685,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` 非空时，服务端需要在握手响应中选择并返回匹配的子协议，否则连接可能失败。
  * - 同一个页面多次调用会创建多个独立连接，已创建的旧连接不会因为新连接自动关闭。
  *
@@ -1412,7 +1710,7 @@ export declare interface ConnectSocketParams {
      * WebSocket 握手阶段携带的 HTTP Header。
      *
      * 适合放置业务自定义 Header，例如鉴权 token、trace id、客户端能力标识等。
-     * `referer` 由宿主侧统一生成和管理，不应依赖该字段被业务传入值覆盖。
+     * `referer` 由豆包客户端统一生成和管理，不应依赖该字段被业务传入值覆盖。
      *
      * @default -
      */
@@ -1422,7 +1720,7 @@ export declare interface ConnectSocketParams {
      *
      * 会作为握手请求中的 `Sec-WebSocket-Protocol` 候选值传给服务端。
      * 如果传入非空数组，服务端需要选择其中一个协议并在握手响应中返回；
-     * 服务端不支持或不返回匹配协议时，连接可能被宿主判定为创建失败。
+     * 服务端不支持或不返回匹配协议时，豆包客户端可能判定连接创建失败。
      *
      * @default -
      */
@@ -1447,6 +1745,8 @@ export declare interface ConnectSocketParams {
  * @since 0.0.25
  * @contractStatus conflict | 双端均可连接 Wi-Fi，但 bssid 参数仅 Android 生效
  * @contractMismatch blocking | parameter | bssid | iOS | 通过 bssid 指定连接目标 | 豆包 iOS 的连接实现不接收 bssid，仅按 ssid 与密码连接 | iOS 上传入 bssid 不会生效 | packages/open-api/src/device/wifi/wifi.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/wifi/WifiModuleManager.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/Wifi/AIBridgeWifiManager.swift | 补齐豆包 iOS 按 bssid 连接能力
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持连接 Wi-Fi，可按 bssid 指定目标
  * @platformSupport iOS | supported | 支持连接 Wi-Fi，忽略 bssid 参数
  * @platformSupport PC | unsupported | 暂不支持
@@ -1459,7 +1759,20 @@ export declare interface ConnectSocketParams {
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据返回的错误信息提示用户重试
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 1401003,
+ *   "errMsg": "connect wifi failed"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 104 | invalid parameter | Android,iOS | ssid 为空 | 传入非空的 ssid 后重试
+ * @errorCode errNo | 103 | feature not support | Android,iOS | 设备无可用的 Wi-Fi 能力，或 iOS 系统版本过低不支持连接 | 检查设备与系统能力，不支持时不要调用
+ * @errorCode errNo | 1401001 | wifi is not initialized | Android,iOS | 调用前未先调用 startWifi 完成初始化 | 先调用 startWifi 再连接 Wi-Fi
+ * @errorCode errNo | 115 | operation timeout | Android | 连接 Wi-Fi 超时 | 确认目标网络可用后提示用户重试
+ * @errorCode errNo | 1401003 | connect wifi failed | Android,iOS | 连接目标 Wi-Fi 失败（如密码错误、网络不可达、系统连接被拒） | 检查 ssid 与密码后提示用户重试
+ * @platformNote Android | 连接超时返回 115；iOS 未细分超时，连接失败统一归为 1401003。
  *
  * @public
  */
@@ -1516,6 +1829,22 @@ export declare type Content = {
         /** API 调用参数。 */
         arguments: object;
     };
+} | {
+    /** 模型响应提示。 */
+    type: 'responseHint';
+    /** 用户动作和模型响应建议。 */
+    data: {
+        /**
+         * 用户做了什么。
+         * @default -
+         */
+        userAction?: string;
+        /**
+         * 建议模型如何响应。
+         * @default -
+         */
+        responseGuidance?: string;
+    };
 };
 
 /**
@@ -1556,6 +1885,8 @@ export declare interface CopyFileParams {
  * @returns 不包含字段的结果对象。
  * @since 0.0.25
  * @contractStatus verified | 创建 BLE 连接的入参与返回结构已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持创建 BLE 连接
  * @platformSupport iOS | supported | 支持创建 BLE 连接
  * @platformSupport PC | unsupported | 暂不支持
@@ -1595,28 +1926,57 @@ export declare interface CreateBLEConnectionParams {
 }
 
 /**
- * A factory to generate a custom event API pair (for both the caller and the callee)
+ * 创建一组用于发送和监听自定义事件的函数。
+ *
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
+ * @public
+ */
+export declare const createCustomEvent: typeof createCustomEvent_2;
+
+/**
+ * 创建一组用于发送和监听自定义事件的函数。
  *
- * @param name event name
- * @param options Extra options when generating the event API
- * @returns A custom event API pair
+ * 发送函数会向当前智能服务的其他 Runtime 广播事件；监听注册函数可注册多个处理函数，
+ * 并返回对应的注销函数。发送端和接收端应复用同一份事件定义，确保事件名称和参数类型一致。
+ *
+ * @summary 创建自定义事件。
+ * @param name 事件名称。建议添加业务命名空间，避免与其他事件重名。
+ * @param options 自定义事件配置。省略时不校验接收到的事件参数。
+ * @returns 返回一个元组，第一项用于发送事件，第二项用于注册事件处理函数。
  * @category Custom API
  * @example
+ * ```typescript
+ * import { createCustomEvent } from '@doubao-dev/framework/api';
+ *
  * interface TestEventParams {
  *   input: string;
  * }
  *
- * const [emitEvent, onReceiveEvent] = createCustomEvent<TestEventParams>('testEvent');
+ * const [emitEvent, onReceiveEvent] =
+ *   createCustomEvent<TestEventParams>('example.testEvent');
  *
- * // For receiver
- * const unregister = onReceiveEvent((params) => console.log(params));
+ * const unregister = onReceiveEvent((params) => {
+ *   console.log(params.input);
+ * });
  *
- * // For sender
- * function emitEventToOtherView() {
- *   emitEvent({ input: 'test' });
- * }
+ * emitEvent({ input: 'test' });
+ * unregister();
+ * ```
+ *
+ * @since 0.0.1
+ * @contractStatus verified | 自定义事件通过统一 Bridge 消息机制在 Runtime 之间广播和接收。
+ * @platformSupport Android | supported | 支持在智能服务的多个 Runtime 之间发送和接收自定义事件。
+ * @platformSupport iOS | supported | 支持在智能服务的多个 Runtime 之间发送和接收自定义事件。
+ * @platformSupport PC | supported | 支持在智能服务的多个 Runtime 之间发送和接收自定义事件。
+ * @platformSupport HarmonyOS | unsupported | 当前未提供该平台实现。
+ * @permission none | - | none | Android,iOS,PC | 无需额外权限
+ * @precondition All | 发送端与接收端需使用相同的事件名称和参数结构。
+ * @usageNote All | 为事件名称添加业务命名空间，并在不再监听时调用注册函数返回的注销函数。
+ * @errorCode none | - | - | Android,iOS,PC | 该 API 不返回业务错误码，发送失败时不会抛出异常 | 无需处理
+ * @public
  */
-export declare function createCustomEvent<Params extends object>(name: string, options?: CustomEventOptions<Params>): [CustomEventCaller<Params>, CustomEventHandlerRegistry<Params>];
+declare function createCustomEvent_2<Params extends object>(name: string, options?: CustomEventOptions_2<Params>): [CustomEventCaller_2<Params>, CustomEventHandlerRegistry_2<Params>];
 
 /**
  * 创建一个内部音频上下文。
@@ -1637,6 +1997,8 @@ export declare function createCustomEvent<Params extends object>(name: string, o
  * ```
  * @since 0.0.37
  * @contractStatus verified | Android、iOS 均支持独立实例、属性控制、基础播控和事件监听
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持多实例内部音频播放
  * @platformSupport iOS | supported | 支持多实例内部音频播放
  * @platformSupport PC | unsupported | 暂不支持
@@ -1711,6 +2073,8 @@ export declare function createInnerAudioContext(): InnerAudioContext;
  * @since 0.0.28
  * @contractStatus verified | 成功返回结构与 Android、iOS 一致；失败通过 Promise reject，业务错误在错误对象的 data 字段。公开联合类型的失败分支不会作为 resolve 值出现，仅作后续对齐项。
  * @contractMismatch non-blocking | return | CreateSignOrderResult | Android,iOS | 返回类型声明为 CreateSignOrderSuccessResult 与 CreateSignOrderFailResult 的联合，暗示失败结果可作为 resolve 值 | 双端失败时通过 Promise reject 返回，业务错误（errNo、errMsg、errLogId）在错误对象的 data 字段，resolve 值只会是成功结果 | 调用方误以为可对 await 结果做失败分支判断 | packages/open-api/src/open/payment/create-sign-order.ts; packages/bridge-base/src/client-api.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/payment/CreateSignOrderMethod.kt | 将公开返回类型收敛为成功结果，失败改由错误对象表达
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持创建签约订单并返回 authOrderId。
  * @platformSupport iOS | supported | 支持创建签约订单并返回 authOrderId。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -1726,7 +2090,7 @@ export declare function createInnerAudioContext(): InnerAudioContext;
  *   "logId": "20260519xxxx"
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 无稳定的顶层 errNo/errMsg；调用失败时 Promise reject，业务错误（errNo、errMsg、errLogId）在错误对象的 data 字段 | 通过 catch 捕获并读取 e.data 排查
+ * @errorCode common | 102 | Android,iOS
  * @knownIssue All | 失败结果不会作为 await 的返回值，需通过 catch 捕获并从错误对象的 data 字段读取 errNo、errMsg、errLogId。
  *
  * @public
@@ -1806,6 +2170,8 @@ export declare interface CreateSignOrderSuccessResult {
  * @since 0.0.31
  * @contractStatus conflict | 公开定义声明 taskType 支持 local 与 remote，豆包双端仅支持 remote。
  * @contractMismatch blocking | parameter | params.taskType | Android,iOS | 声明支持 local 与 remote 两种任务类型 | 豆包 Android、iOS 仅支持 remote 任务，传入 local 无法按本地任务处理 | 调用方传入 local 时行为与预期不符 | packages/open-api/src/open/business/task.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/task/CreateTaskMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Doubao/AIBridgeCreateTaskMethod.swift | 将 taskType 收敛为 remote，或补齐双端 local 任务实现
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持创建 remote 任务并返回 taskId、token。
  * @platformSupport iOS | supported | 支持创建 remote 任务并返回 taskId、token。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -1822,7 +2188,17 @@ export declare interface CreateSignOrderSuccessResult {
  *   "expiresIn": 3600
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 104,
+ *   "errMsg": "invalid parameter"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 104 | invalid parameter | Android,iOS | taskType 不是 remote（如传入 local） | 传入 remote 任务类型后重试。
+ * @errorCode errNo | 112 | invalid result | Android,iOS | 远端任务创建成功但返回数据为空或缺少 taskId | 稍后重试；持续失败时反馈服务端响应异常。
+ * @platformNote All | taskType 非 remote 返回 104；远端返回数据为空或缺少 taskId 返回 112；其他失败统一返回 102。
  *
  * @public
  */
@@ -1858,27 +2234,50 @@ export declare interface CreateTaskResult {
     expiresIn?: number;
 }
 
+/** @public */
+export declare type CustomEventCaller<Params extends object = object> = CustomEventCaller_2<Params>;
+
 /**
- * The caller part of an event API pair
+ * 自定义事件发送函数。
+ *
+ * 调用后会向当前智能服务的其他 Runtime 广播事件，不返回处理结果。
  *
- * Used to send an event registered at foreign entity.
+ * @public
  */
-export declare type CustomEventCaller<Params extends object = object> = (params: Params) => void;
+declare type CustomEventCaller_2<Params extends object = object> = (params: Params) => void;
+
+/** @public */
+export declare type CustomEventHandlerRegistry<Params extends object = object> = CustomEventHandlerRegistry_2<Params>;
 
 /**
- * The callee part of an event API pair
+ * 自定义事件监听注册函数。
+ *
+ * 可以为同一事件注册多个处理函数。调用返回的函数可注销当前处理函数。
  *
- * Used to register custom event handler.
+ * @public
  */
-export declare type CustomEventHandlerRegistry<Params extends object = object> = (handler: (params: Params) => void) => () => void;
+declare type CustomEventHandlerRegistry_2<Params extends object = object> = (handler: (params: Params) => void) => () => void;
+
+/** @public */
+export declare interface CustomEventOptions<Params extends object> {
+    /**
+     * 接收端的参数类型守卫。返回 `false` 时会忽略当前事件，不调用已注册的处理函数。
+     *
+     * @default -
+     */
+    paramsTypeGuard?: CustomEventOptions_2<Params>['paramsTypeGuard'];
+}
 
 /**
- * Extra options for custom event factory
+ * 创建自定义事件的配置。
+ *
+ * @public
  */
-export declare interface CustomEventOptions<Params extends object> {
+declare interface CustomEventOptions_2<Params extends object> {
     /**
-     * Applied after the target runtime receives the event message and before passing it to the handler. Will skip the
-     * event silently when type guard failed.
+     * 接收端的参数类型守卫。返回 `false` 时会忽略当前事件，不调用已注册的处理函数。
+     *
+     * @default -
      */
     paramsTypeGuard?: TypeGuard<object, Params>;
 }
@@ -1930,6 +2329,8 @@ export declare type DeviceOrientation = 'portrait' | 'landscape';
  * @since 0.0.37
  * @contractStatus verified | 禁止录屏的成功语义已与 Android、iOS 当前实现对齐；双端防护粒度不同但公开类型已准确表达
  * @contractMismatch non-blocking | behavior | 防录屏粒度 | Android,iOS | 禁止当前页面被录屏 | Android 对整个窗口设置 FLAG_SECURE，iOS 对内容视图包裹安全容器保护 | 防护范围在双端不同 | packages/open-api/src/device/screen/disable-user-screen-record.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/system/AIBridgeScreenMethods.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeScreenMethods.swift | 统一双端防录屏的作用范围
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持禁止用户录屏
  * @platformSupport iOS | supported | 支持禁止用户录屏
  * @platformSupport PC | unsupported | 暂不支持
@@ -1943,7 +2344,7 @@ export declare type DeviceOrientation = 'portrait' | 'landscape';
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息重试
+ * @errorCode common | 102 | Android,iOS
  *
  * @public
  */
@@ -1954,6 +2355,7 @@ export declare const disableUserScreenRecord: (params?: {} | undefined) => Promi
  *
  * @param params - 动作描述、预期行为及工具调用约束参数。
  * @returns 返回一个 Promise，在动作指令成功下发时解析。
+ * @deprecated 使用 {@link sendFollowUpMessage} 发送后续消息。
  * @remarks
  * 适用于卡片交互后向模型补充结构化动作上下文，例如按钮点击、选项选择或表单提交。
  * `getWidgetInstanceId` 仅在卡片环境中有效，在智能服务页面中会返回 `undefined`。如果需要在页面中调用，
@@ -1983,9 +2385,18 @@ export declare const disableUserScreenRecord: (params?: {} | undefined) => Promi
  * @precondition Android | 在卡片或会话环境中调用，需传入有效的 widgetInstanceId。
  * @precondition iOS | 在卡片或会话环境中调用，需传入有效的 widgetInstanceId。
  * @usageNote All | 请在卡片交互（按钮点击、选项选择、表单提交）后调用，向模型补充结构化动作上下文。
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 116,
+ *   "errMsg": "resource not found"
+ * }
+ * ```
+ * @errorCode errNo | 103 | feature not support | Android,iOS | 当前豆包环境未提供消息下发能力 | 请在支持消息下发的豆包环境中调用。
+ * @errorCode errNo | 116 | resource not found | Android,iOS | 依据 widgetInstanceId 找不到对应会话 | 确认 widgetInstanceId 有效且处于会话环境后重试。
+ * @platformNote All | 找不到会话返回 116；当前豆包环境未提供消息下发能力时返回 103。
  *
- * @public
+ * @internal
  */
 export declare const dispatchActionDirective: (params: DispatchActionDirectiveParams) => Promise<object>;
 
@@ -2094,13 +2505,15 @@ export declare interface DoubaoAppAccountInfo {
  *
  * @since 0.0.40
  * @contractStatus verified | Android、iOS 均支持 HTTPS GET 下载、域名校验、临时或用户目录写入、超时、取消及进度和响应头监听。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持 HTTPS GET 下载、域名白名单校验、临时或用户目录写入、超时、取消及任务事件监听。
  * @platformSupport iOS | supported | 支持 HTTPS GET 下载、域名白名单校验、临时或用户目录写入、超时、取消及任务事件监听。
  * @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
@@ -2124,10 +2537,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 -
      */
@@ -2213,6 +2626,61 @@ export declare interface DownloadTaskHeadersReceivedEvent {
     header: Record<string, string>;
 }
 
+/**
+ * 发起抖音支付流程。
+ *
+ * @param params - 支付请求数据。
+ * @returns 返回支付流程的结果对象。
+ * @remarks
+ * `data` 应由业务服务端生成，前端不要自行拼装或修改。
+ *
+ * 支付流程返回不代表最终支付状态，最终结果应以业务服务端查询结果或支付回调为准。
+ * @example
+ * ```typescript
+ * import { dypay } from '@doubao-dev/framework/api';
+ *
+ * // 业务方自行实现：从业务服务端获取支付请求数据；该函数不是 SDK API。
+ * declare function getDypayDataFromBusinessServer(): Promise<string>;
+ *
+ * const data = await getDypayDataFromBusinessServer();
+ * const result = await dypay({ data });
+ *
+ * console.log(result);
+ * ```
+ *
+ * @since 0.0.43
+ * @contractStatus verified | Android、iOS 均支持接收字符串类型的 data 并发起抖音支付流程。
+ * @platformSupport Android | supported | 支持传入 data 发起抖音支付流程。
+ * @platformSupport iOS | supported | 支持传入 data 发起抖音支付流程。
+ * @platformSupport PC | unsupported | 当前未提供该平台实现。
+ * @platformSupport HarmonyOS | unsupported | 当前未提供该平台实现。
+ * @permission none | - | none | Android,iOS | 无需额外权限
+ * @precondition All | 调用前需由业务服务端生成合法的支付请求 data。
+ * @usageNote All | 调用会进入支付流程，请在用户明确触发支付的交互场景中调用；不要在后台逻辑中自动调用。
+ * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 根据调用失败信息提示用户稍后重试
+ * @public
+ */
+export declare const dypay: (params: DypayParams) => Promise<DypayResult>;
+
+/** @public */
+export declare interface DypayParams {
+    /**
+     * 支付请求数据。
+     *
+     * 该字段应由业务服务端按支付接入协议生成，前端需原样透传。
+     */
+    data: string;
+}
+
+/**
+ * 支付流程返回的数据对象。
+ *
+ * 具体字段由支付请求对应的业务流程决定。
+ *
+ * @public
+ */
+export declare type DypayResult = Record<string, unknown>;
+
 /**
  * 允许用户录屏。
  *
@@ -2227,6 +2695,8 @@ export declare interface DownloadTaskHeadersReceivedEvent {
  * @since 0.0.37
  * @contractStatus verified | 允许录屏的成功语义已与 Android、iOS 当前实现对齐；双端恢复机制不同但公开类型已准确表达
  * @contractMismatch non-blocking | behavior | 恢复录屏粒度 | Android,iOS | 恢复当前页面的录屏能力 | Android 清除窗口 FLAG_SECURE，iOS 还原内容视图的安全容器 | 恢复范围在双端不同 | packages/open-api/src/device/screen/enable-user-screen-record.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/system/AIBridgeScreenMethods.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeScreenMethods.swift | 统一双端恢复录屏的作用范围
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持允许用户录屏
  * @platformSupport iOS | supported | 支持允许用户录屏
  * @platformSupport PC | unsupported | 暂不支持
@@ -2238,7 +2708,7 @@ export declare interface DownloadTaskHeadersReceivedEvent {
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息重试
+ * @errorCode common | 102 | Android,iOS
  *
  * @public
  */
@@ -2257,6 +2727,8 @@ export declare const enableUserScreenRecord: (params?: {} | undefined) => Promis
  *
  * @since 0.0.20
  * @contractStatus verified | 退出语义及 Android、iOS 失败字段已核对一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持退出当前智能服务的全部页面。
  * @platformSupport iOS | supported | 支持退出当前智能服务的全部页面。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -2264,7 +2736,7 @@ export declare const enableUserScreenRecord: (params?: {} | undefined) => Promis
  * @permission none | - | none | Android,iOS | 无需额外权限
  * @precondition All | 无额外前置条件
  * @usageNote All | 会退出当前所有页面；当 navigateBack 已无法继续返回时，使用 exitApp 退出智能服务。
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorCode common | 102 | Android,iOS
  *
  * @public
  */
@@ -2295,6 +2767,8 @@ export declare const exitApp: () => Promise<object>;
  *
  * @since 0.0.27
  * @contractStatus verified | 通过 updateWidget 实现，公开定义与 Android、iOS 的成功、失败路径一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持将过期卡片更新为固定卡片。
  * @platformSupport iOS | supported | 支持将过期卡片更新为固定卡片。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -2439,6 +2913,8 @@ export declare interface FileSystemManager {
  * @since 0.0.18
  * @contractStatus conflict | envVersion 公开声明了 trial，但 Android、iOS 当前只返回 develop 或 release。
  * @contractMismatch blocking | return | miniProgram.envVersion | Android,iOS | envVersion 取值为 develop、trial 或 release | 仅返回 develop 或 release，永远不会返回 trial | 依赖 trial 判断体验版环境的逻辑不会生效 | packages/open-api/src/basic/account-info.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/info/GetAccountInfoMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Info/AIBridgeGetAccountInfoMethod.swift | 补齐豆包体验版环境返回 trial，或收敛公开 envVersion 取值
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持获取当前智能服务账号信息。
  * @platformSupport iOS | supported | 支持获取当前智能服务账号信息。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -2455,7 +2931,7 @@ export declare interface FileSystemManager {
  *   }
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息确认智能服务运行环境后重试
+ * @errorCode common | 102 | Android
  *
  * @public
  */
@@ -2488,6 +2964,8 @@ export declare interface GetAccountInfoResult {
  * @since 0.0.18
  * @contractStatus conflict | envVersion 公开声明了 trial，但 Android、iOS 当前只返回 develop 或 release。
  * @contractMismatch blocking | return | miniProgram.envVersion | Android,iOS | envVersion 取值为 develop、trial 或 release | 仅返回 develop 或 release，永远不会返回 trial | 依赖 trial 判断体验版环境的逻辑不会生效 | packages/open-api/src/basic/account-info.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/info/GetAccountInfoMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Info/AIBridgeGetAccountInfoMethod.swift | 补齐豆包体验版环境返回 trial，或收敛公开 envVersion 取值
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持同步获取当前智能服务账号信息。
  * @platformSupport iOS | supported | 支持同步获取当前智能服务账号信息。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -2504,38 +2982,46 @@ export declare interface GetAccountInfoResult {
  *   }
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息确认智能服务运行环境后重试
+ * @errorCode common | 102 | Android
  *
  * @public
  */
 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);
+ * console.log(result.healthDataAuthorizationDetail?.readStatus);
  * ```
  *
  * @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 均同步返回原有授权状态及可映射的精细授权字段；精细字段无法可靠映射或平台不适用时可为空，调用不会触发权限申请。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
+ * @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。
+ * @usageNote iOS | healthDataAuthorizationDetail 使用异步缓存；首次预热或应用重新激活刷新完成前可能返回 UNKNOWN。Apple 不公开精确读取授权，DENIED/GRANTED 为轻量查询推断。
  * @resultExample
  * ```json
  * {
@@ -2549,14 +3035,30 @@ 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",
+ *   "healthDataAuthorizationDetail": {
+ *     "readStatus": [
+ *       { "type": "heart_rate", "status": 2 },
+ *       { "type": "step_count", "status": 0 }
+ *     ]
+ *   }
  * }
  * ```
  * @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 暂不映射
+ * @platformNote iOS | healthDataAuthorizationDetail 返回 SDK 支持的全部健康类型，调用方可按自己申请读取权限时使用的 types 过滤；它不等同于 Apple 提供的精确读取授权结果
  *
  * @public
  */
@@ -2586,12 +3088,63 @@ 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;
+    /**
+     * HealthKit 逐类型读取授权状态；仅 iOS 新版本客户端返回。
+     *
+     * Apple 不提供读取权限的精确查询接口。`status` 为 1 或 2 时采用轻量查询推断，
+     * “已授权但没有数据”和“拒绝读取”仍可能无法可靠区分；业务应以实际读取结果为准。
+     */
+    healthDataAuthorizationDetail?: HealthDataAuthorizationDetail | null;
 }
 
 /**
  * 获取应用基础信息。
  *
- * @returns 返回 SDK 版本、调试开关、宿主信息、语言和主题等字段，见 {@link GetAppBaseInfoResult}。
+ * @returns 返回 SDK 版本、调试开关、豆包客户端信息、语言和主题等字段，见 {@link GetAppBaseInfoResult}。
  * @example
  * ```typescript
  * import { getAppBaseInfo } from '@doubao-dev/framework/api';
@@ -2605,6 +3158,8 @@ export declare interface GetAppAuthorizeSettingResult {
  * @since 0.0.18
  * @contractStatus conflict | Android 已实现异步应用基础信息接口，iOS 当前未注册 doubao.getAppBaseInfo，iOS 上调用会失败。
  * @contractMismatch blocking | platform | doubao.getAppBaseInfo | iOS | iOS 异步返回应用基础信息 | iOS 仅提供接口声明未注册实现，调用直接返回不支持 | iOS 上的异步调用无法获得成功结果 | packages/open-api/src/basic/system/system.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/system; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/System | 补齐 iOS doubao.getAppBaseInfo 实现，或统一改用 getAppBaseInfoSync
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持异步获取应用基础信息。
  * @platformSupport iOS | unsupported | 未注册异步应用基础信息接口，请改用 getAppBaseInfoSync。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -2636,11 +3191,11 @@ export declare interface GetAppBaseInfoResult {
     SDKVersion?: string;
     /** 是否已打开调试 */
     enableDebug?: boolean;
-    /** 当前豆包 App 运行的宿主环境 */
+    /** 当前豆包客户端信息 */
     host?: AppBaseInfoHost;
     /** 当前语言 */
     language: string;
-    /** 宿主版本号 */
+    /** 豆包客户端版本号 */
     version?: string;
     /** 当前主题 */
     theme?: 'light' | 'dark';
@@ -2649,7 +3204,7 @@ export declare interface GetAppBaseInfoResult {
 /**
  * 获取应用基础信息。
  *
- * @returns 返回 SDK 版本、调试开关、宿主信息、语言和主题等字段，见 {@link GetAppBaseInfoResult}。
+ * @returns 返回 SDK 版本、调试开关、豆包客户端信息、语言和主题等字段，见 {@link GetAppBaseInfoResult}。
  * @example
  * ```typescript
  * import { getAppBaseInfoSync } from '@doubao-dev/framework/api';
@@ -2662,6 +3217,8 @@ export declare interface GetAppBaseInfoResult {
  *
  * @since 0.0.18
  * @contractStatus verified | 应用基础信息由智能服务运行环境同步读取，字段与公开类型一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持同步获取应用基础信息。
  * @platformSupport iOS | supported | 支持同步获取应用基础信息。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -2703,6 +3260,8 @@ export declare const getAppBaseInfoSync: (_params?: {}) => GetAppBaseInfoResult;
  * ```
  * @since 0.0.37
  * @contractStatus verified | Android、iOS 均支持全局单例、背景播控、状态属性和事件监听
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持背景音频播放和系统媒体控件
  * @platformSupport iOS | supported | 支持背景音频播放和系统媒体控件
  * @platformSupport PC | unsupported | 暂不支持
@@ -2760,6 +3319,8 @@ export declare function getBackgroundAudioManager(): BackgroundAudioManager;
  * @since 0.0.25
  * @contractStatus conflict | level 电量取值范围双端不一致，无法从公开类型判断实际区间
  * @contractMismatch blocking | return | level | Android,iOS | 返回当前电量百分比 | Android 返回 0 到 100，iOS 由系统电量换算后可能返回 0 | 依赖固定下限的调用方在低电量时可能误判 | ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/AIBridgeBatteryMethods.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeBatteryMethods.swift | 统一双端电量下限并明确取值范围
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持获取电池信息
  * @platformSupport iOS | supported | 支持获取电池信息
  * @platformSupport PC | unsupported | 暂不支持
@@ -2774,7 +3335,7 @@ export declare function getBackgroundAudioManager(): BackgroundAudioManager;
  *   "level": 82
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息重试
+ * @errorCode common | 102 | Android
  *
  * @public
  */
@@ -2810,6 +3371,8 @@ export declare interface GetBatteryInfoResult {
  * @since 0.0.25
  * @contractStatus verified | 返回的 beacons 列表字段与公开类型一致；双端权限与失败行为不同但不影响公开契约
  * @contractMismatch non-blocking | behavior | 失败行为 | Android,iOS | 返回当前已搜到的 iBeacon 列表 | Android 需定位与蓝牙权限、缺失时可能失败，iOS 恒返回成功 | 双端失败可能性不同，但公开成功语义一致 | ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/GetBeaconsMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeDeviceBeaconMethods.swift | 统一双端获取列表的权限与成功行为
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持获取已搜索到的 iBeacon 列表
  * @platformSupport iOS | supported | 支持获取已搜索到的 iBeacon 列表
  * @platformSupport PC | unsupported | 暂不支持
@@ -2878,6 +3441,8 @@ export declare interface GetBeaconsResult {
  *
  * @since 0.0.25
  * @contractStatus verified | BLE 特征值列表的入参与返回结构已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持获取 BLE 特征值列表
  * @platformSupport iOS | supported | 支持获取 BLE 特征值列表
  * @platformSupport PC | unsupported | 暂不支持
@@ -2948,6 +3513,8 @@ export declare interface GetBLEDeviceCharacteristicsResult {
  *
  * @since 0.0.25
  * @contractStatus verified | BLE RSSI 的入参与返回结构已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持获取 BLE 设备 RSSI
  * @platformSupport iOS | supported | 支持获取 BLE 设备 RSSI
  * @platformSupport PC | unsupported | 暂不支持
@@ -3006,6 +3573,8 @@ export declare interface GetBLEDeviceRSSIResult {
  *
  * @since 0.0.25
  * @contractStatus verified | BLE 服务列表的入参与返回结构已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持获取 BLE 服务列表
  * @platformSupport iOS | supported | 支持获取 BLE 服务列表
  * @platformSupport PC | unsupported | 暂不支持
@@ -3067,6 +3636,8 @@ export declare interface GetBLEDeviceServicesResult {
  *
  * @since 0.0.25
  * @contractStatus verified | 获取 BLE MTU 的入参与返回结构已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持获取 BLE MTU
  * @platformSupport iOS | supported | 支持获取 BLE MTU
  * @platformSupport PC | unsupported | 暂不支持
@@ -3129,6 +3700,8 @@ export declare interface GetBLEMTUResult {
  *
  * @since 0.0.25
  * @contractStatus verified | 蓝牙适配器状态的返回结构已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持获取蓝牙适配器状态
  * @platformSupport iOS | supported | 支持获取蓝牙适配器状态
  * @platformSupport PC | unsupported | 暂不支持
@@ -3179,6 +3752,8 @@ export declare interface GetBluetoothAdapterStateResult {
  *
  * @since 0.0.25
  * @contractStatus verified | 已发现设备列表的返回结构已与 Android、iOS 当前实现对齐；广播二进制字段由框架统一解码为 ArrayBuffer
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持获取已发现的蓝牙设备列表
  * @platformSupport iOS | supported | 支持获取已发现的蓝牙设备列表
  * @platformSupport PC | unsupported | 暂不支持
@@ -3217,6 +3792,42 @@ 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 | 请求参数、返回字段和状态枚举与对话框状态查询协议一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
+ * @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>;
+
 /**
  * 获取剪贴板内容。
  *
@@ -3231,6 +3842,8 @@ export declare interface GetBluetoothDevicesResult {
  *
  * @since 0.0.25
  * @contractStatus verified | data 字段的类型与必返性已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持读取剪贴板
  * @platformSupport iOS | supported | 支持读取剪贴板
  * @platformSupport PC | unsupported | 暂不支持
@@ -3245,7 +3858,15 @@ export declare interface GetBluetoothDevicesResult {
  *   "data": "hello doubao"
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息确认豆包是否提供剪贴板能力
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 103,
+ *   "errMsg": "feature not support"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 103 | feature not support | Android,iOS | 当前豆包版本或运行环境未提供剪贴板读取能力 | 在支持剪贴板能力的豆包版本中调用。
  *
  * @public
  */
@@ -3277,6 +3898,8 @@ export declare interface GetClipboardDataResult {
  *
  * @since 0.0.25
  * @contractStatus verified | 已连接设备列表的入参与返回结构已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持获取已连接的蓝牙设备列表
  * @platformSupport iOS | supported | 支持获取已连接的蓝牙设备列表
  * @platformSupport PC | unsupported | 暂不支持
@@ -3340,6 +3963,8 @@ export declare interface GetConnectedBluetoothDevicesResult {
  * @contractStatus conflict | 双端均可获取已连接 Wi-Fi，但 signalStrength 量纲不一致且 iOS 无 frequency
  * @contractMismatch blocking | return | signalStrength | Android,iOS | 返回统一量纲的信号强度 | 豆包 Android 返回 0 到 100 的信号等级，iOS 返回 0 到 1 的归一化值 | 跨端使用同一阈值判断信号强弱会出错 | packages/open-api/src/device/wifi/wifi.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/wifi/WifiInfoReader.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/Wifi/AIBridgeWifiInfoReader.swift | 统一双端 signalStrength 量纲
  * @contractMismatch non-blocking | return | frequency | iOS | 返回 Wi-Fi 频段 | 豆包 iOS 无法获取频段，frequency 恒为空 | iOS 上无法读取 Wi-Fi 频段 | packages/open-api/src/device/wifi/wifi.ts; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/Wifi/AIBridgeWifiInfoReader.swift | 记录 iOS 无频段能力
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持获取已连接 Wi-Fi，signalStrength 为 0 到 100
  * @platformSupport iOS | supported | 支持获取已连接 Wi-Fi，signalStrength 为 0 到 1 且无 frequency
  * @platformSupport PC | unsupported | 暂不支持
@@ -3362,7 +3987,26 @@ export declare interface GetConnectedBluetoothDevicesResult {
  *   }
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据返回的错误信息（如未连接、无权限）提示用户
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 1401002,
+ *   "errMsg": "wifi is not connected"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 1401001 | wifi is not initialized | Android,iOS | 调用前未先调用 startWifi 完成初始化 | 先调用 startWifi 再获取已连接 Wi-Fi
+ * @errorCode errNo | 1401002 | wifi is not connected | Android,iOS | 当前未连接 Wi-Fi 或无法读取已连接 Wi-Fi 信息 | 确认设备已连接 Wi-Fi 后重试
+ * @errorCode errNo | 106 | system permission denied | iOS | 系统定位服务未开启，无法读取 Wi-Fi 信息 | 引导用户在系统设置中开启定位服务
+ * @errorCode errNo | 107 | user permission denied | iOS | 用户未授予定位权限或未开启精确定位 | 引导用户授予定位权限并开启精确定位
+ * @errorCode errNo | 114 | operation cancelled | iOS | 用户取消了位置权限授权弹窗 | 用户需要时可再次触发授权后重试
+ * @errorCode errNo | 301 | network request cancelled | iOS | 位置授权过程中的网络请求被取消 | 确认应用和网络状态后重试
+ * @errorCode errNo | 302 | connection timed out | iOS | 位置授权过程中的网络连接超时 | 检查网络连接后重试
+ * @errorCode errNo | 303 | no network connection | iOS | 当前无可用网络连接 | 恢复网络连接后重试
+ * @errorCode errNo | 305 | network failure | iOS | 位置授权过程中发生其他网络错误 | 检查网络连接，稍后重试
+ * @errorCode errNo | 112 | invalid result | iOS | 位置授权服务返回的数据无法解析 | 稍后重试；持续失败时反馈服务端响应异常
+ * @platformNote Android | 未连接或因缺少定位权限无法读取时统一返回 1401002；未初始化返回 1401001。
+ * @platformNote iOS | 读取前会发起位置权限授权，可返回 106/107 及授权网络类失败（301/302/303/305/112）；读取阶段未连接返回 1401002。
  *
  * @public
  */
@@ -3407,6 +4051,8 @@ export declare interface GetConnectedWifiResult {
  * ```
  * @since 0.0.32
  * @contractStatus verified | 设备信息字段的类型、必返性与平台可选性已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持获取设备信息
  * @platformSupport iOS | supported | 支持获取设备信息
  * @platformSupport PC | unsupported | 暂不支持
@@ -3438,7 +4084,7 @@ export declare const getDeviceInfo: (params?: {} | undefined) => Promise<GetDevi
  * @public
  */
 export declare interface GetDeviceInfoResult {
-    /** 宿主 App 二进制接口类型，仅 Android 支持。 */
+    /** 豆包客户端二进制接口类型，仅 Android 支持。 */
     abi?: string;
     /** 设备二进制接口类型，仅 Android 支持。 */
     deviceAbi?: string;
@@ -3473,13 +4119,15 @@ export declare interface GetDeviceInfoResult {
  * ```
  * @since 0.0.32
  * @contractStatus verified | 同步设备信息由智能服务运行环境 globalProps 读取，字段类型与公开类型一致
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持同步获取设备信息
  * @platformSupport iOS | supported | 支持同步获取设备信息
  * @platformSupport PC | unsupported | 暂不支持
  * @platformSupport HarmonyOS | unsupported | 暂不支持
  * @permission none | - | none | Android,iOS | 无需额外权限
  * @precondition All | 无额外前置条件
- * @usageNote All | `benchmarkLevel`、`memorySize`、`deviceAbi` 和 `cpuType` 取自 globalProps；运行环境未注入时，`benchmarkLevel` 返回 -1，`memorySize` 返回空字符串，可选字段不返回
+ * @usageNote All | `platform` 优先取自 globalProps.platform，未注入时由 globalProps.os 推导；`benchmarkLevel`、`memorySize`、`deviceAbi` 和 `cpuType` 也取自 globalProps
  * @platformNote Android | `abi`、`deviceAbi`、`cpuType` 仅在运行环境注入对应 globalProps 字段时返回
  * @platformNote iOS | 未注入时不返回 `abi`、`deviceAbi`、`cpuType`
  * @resultExample
@@ -3557,6 +4205,8 @@ export declare interface GetFileInfoResult {
  * @since 0.0.31
  * @contractStatus verified | Android、iOS 均支持文件系统管理器的读写、目录、状态、保存与解压能力，同步与异步方法行为一致
  * @contractMismatch non-blocking | default | ReadFileParams.encoding | Android,iOS | readFile、readFileSync 的 encoding 默认值为 'base64'，而 writeFile、appendFile 的 encoding 默认值为 'utf-8' | 双端实现与声明一致：读文件省略 encoding 默认按 Base64 返回，写入、追加省略 encoding 默认按 UTF-8 处理 | 读写默认编码方向不一致，写后再读若都不传 encoding 会得到与写入不匹配的字符串编码 | packages/open-api/src/file-system/file-system-manager.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/file/ReadFileMethod.kt; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/file/WriteFileMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/File/AIBridgeFileMethods.swift | 后续统一读写默认编码方向，建议评估将读文件默认改为 utf-8 并同步双端实现
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持全部读写、目录、状态、保存与解压方法，同步与异步均可用
  * @platformSupport iOS | supported | 支持全部读写、目录、状态、保存与解压方法，同步与异步均可用
  * @platformSupport PC | unsupported | 暂不支持
@@ -3564,7 +4214,21 @@ export declare interface GetFileInfoResult {
  * @permission none | - | none | Android,iOS | 无需额外权限
  * @precondition All | 无额外前置条件，直接调用 getFileSystemManager 获取管理器实例后再调用其方法
  * @usageNote All | readFile、readFileSync 省略 encoding 时默认返回 Base64 字符串，writeFile、appendFile 省略 encoding 时默认按 UTF-8 写入；需要明确编码时请显式传入 encoding。
- * @errorCode none | - | - | Android,iOS | 文件操作失败时对应方法会 reject 或抛出异常，错误信息通过 errMsg 描述，当前不提供稳定的业务错误码 | 根据 errMsg 检查路径、权限与参数后重试
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 203,
+ *   "errMsg": "file does not exist"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode common | 103 | Android
+ * @errorCode common | 104 | Android,iOS
+ * @errorCode errNo | 203 | file does not exist | Android,iOS | readFile、stat、getFileInfo、copyFile、rename、truncate、unlink、rmdir、removeSavedFile、unzip 等操作的目标文件或目录不存在 | 确认路径存在或先创建后重试。
+ * @errorCode errNo | 213 | invalid file path | Android,iOS | 传入的路径不是合法的沙箱内 appletfile 路径，或试图越过沙箱根目录访问 | 使用应用沙箱内的合法本地路径后重试。
+ * @errorCode errNo | 208 | total size limit exceeded | Android,iOS | readFile、writeFile、appendFile、copyFile 时单次读写超过单文件大小上限，或写入后超出沙箱存储配额 | 减小单次读写数据量或清理已保存文件后重试。
+ * @errorCode errNo | 1901001 | target is a directory | Android,iOS | 对目录执行了仅适用于文件的操作（如 readFile、writeFile、appendFile、copyFile、truncate、getFileInfo、unzip 的源文件），或 rmdir 删除非空目录时未开启 recursive | 改为对文件操作，或删除目录时开启 recursive。
+ * @errorCode errNo | 1901002 | target is not a directory | Android,iOS | 对文件执行了仅适用于目录的操作（如 readdir），或 mkdir 目标已存在同名文件、unzip 的 targetPath 不是目录 | 确认目标为目录后重试。
  * @public
  */
 export declare function getFileSystemManager(): FileSystemManager;
@@ -3584,6 +4248,8 @@ export declare function getFileSystemManager(): FileSystemManager;
  * ```
  * @since 0.0.26
  * @contractStatus verified | Android、iOS 的入参、图片尺寸、方向、格式和路径返回结构一致
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持读取本地图片和 HTTP、HTTPS 网络图片信息
  * @platformSupport iOS | supported | 支持读取本地图片和 HTTP、HTTPS 网络图片信息
  * @platformSupport PC | unsupported | 暂不支持
@@ -3677,6 +4343,8 @@ export declare interface GetImageInfoResult {
  * @contractStatus verified | 文档入参与返回字段可选性已与 Android、iOS 当前实现对齐
  * @contractMismatch non-blocking | behavior | 授权触发方式 | Android,iOS | Android、iOS 均要求应用授权和系统定位权限 | Android 调用 getLocation 时可主动申请权限，iOS 调用 getLocation 时只检查现有权限 | 开发者需要按平台采用不同的授权调用时序 | ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/system/location/GetLocationMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/System/AIBridgeDoubaoGetLocationMethod.swift | 对齐双端 getLocation 是否主动申请权限
  * @contractMismatch non-blocking | behavior | mode=1 | iOS | mode=1 表示仅设备定位 | iOS 将 mode=1 按高精度模式处理 | 同一参数在双端的定位策略不同 | flow_ios/flow_iOS/Modules/FlowApplet/Sources/AIBridge/AIBridgeFlowGetLocationMethod.swift | 补齐 iOS 仅设备定位策略，或收敛公开参数语义
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持获取设备当前位置
  * @platformSupport iOS | supported | 支持获取设备当前位置
  * @platformSupport PC | unsupported | 暂不支持
@@ -3698,7 +4366,19 @@ export declare interface GetImageInfoResult {
  *   "accuracy": 15
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息提示用户检查授权和系统定位服务
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 107,
+ *   "errMsg": "user permission denied"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode common | 116 | Android
+ * @errorCode errNo | 106 | system permission denied | Android,iOS | 系统定位权限被拒绝或系统定位服务不可用 | 引导用户在系统设置中开启定位服务与权限后重试
+ * @errorCode errNo | 107 | user permission denied | Android,iOS | 用户拒绝了应用位置授权（scope.userLocation） | 调用 authorize 重新发起应用授权后重试
+ * @platformNote Android | 用户拒绝应用授权返回 107、系统权限被拒返回 106；定位失败等其他失败统一返回 102。
+ * @platformNote iOS | 应用授权或系统权限被拒返回 107/106；其他失败（含非法 scope）统一返回 102。
  * @platformNote iOS | mode 为 1 时按高精度模式处理
  *
  * @public
@@ -3724,6 +4404,13 @@ export declare interface GetLocationParams {
      * @constraint 取值为 0、1 或 2
      */
     mode?: number;
+    /**
+     * 是否接受轻定位结果。轻定位会直接利用设备已有的 Wi-Fi 扫描缓存，由服务端快速计算当前位置，缩短定位耗时。
+     *
+     * @default false
+     * @constraint 仅 Android 生效，需使用 0.0.42 及以上版本的基础库
+     */
+    acceptLightLocation?: boolean;
     /**
      * 超时时间，单位毫秒，默认 30000
      *
@@ -3779,6 +4466,8 @@ export declare interface GetLocationResponse {
  *
  * @since 0.0.26
  * @contractStatus verified | 返回值由当前窗口、安全区域和设备类型同步计算，与 Android、iOS 胶囊按钮布局规则一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持获取菜单按钮布局信息。
  * @platformSupport iOS | supported | 支持获取菜单按钮布局信息。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -3820,6 +4509,8 @@ export declare const getMenuButtonBoundingClientRect: () => MenuButtonBoundingCl
  * @contractStatus conflict | networkType 取值及 signalStrength/weakNet 的返回条件双端不一致，无法从公开类型判断实际结果
  * @contractMismatch blocking | return | networkType | Android,iOS | 返回 NetworkType 联合类型内的取值 | iOS 在蜂窝网络下可能返回联合类型外的 "mobile" | 依赖联合类型穷举分支的调用方会遗漏该取值 | packages/open-api/src/device/network/network.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/AIBridgeNetworkMethods.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeNetworkMethods.swift | 统一双端网络类型取值集合
  * @contractMismatch non-blocking | return | signalStrength | Android,iOS | 可选返回信号强度 | 仅 Android Wi-Fi 环境返回，iOS 恒不返回 | 依赖该字段的逻辑在 iOS 或蜂窝网络下取不到值 | ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/AIBridgeNetworkMethods.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeNetworkMethods.swift | 明确 signalStrength 的返回条件
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持获取网络类型
  * @platformSupport iOS | supported | 支持获取网络类型
  * @platformSupport PC | unsupported | 暂不支持
@@ -3834,7 +4525,9 @@ export declare const getMenuButtonBoundingClientRect: () => MenuButtonBoundingCl
  *   "hasSystemProxy": false
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息重试
+ * @errorCode common | 102 | Android
+ * @platformNote Android | 正常场景稳定返回网络类型；失败时返回 102。
+ * @platformNote iOS | 始终成功返回网络类型，无失败分支。
  *
  * @public
  */
@@ -3910,6 +4603,8 @@ export declare interface GetNetworkTypeResult {
  *
  * @since 0.0.28
  * @contractStatus verified | 公开成功返回结构与 Android、iOS 一致；失败通过 Promise reject，业务错误在错误对象的 data 字段。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持拉起收银台完成订单支付。
  * @platformSupport iOS | supported | 支持拉起收银台完成订单支付。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -3925,8 +4620,18 @@ export declare interface GetNetworkTypeResult {
  *   "logId": "20260519xxxx"
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 无稳定的顶层 errNo/errMsg；调用失败时 Promise reject，业务错误（errNo、errMsg、errLogId）在错误对象的 data 字段 | 通过 catch 捕获并读取 e.data 排查
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 114,
+ *   "errMsg": "operation cancelled"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode common | 103 | Android,iOS
+ * @errorCode errNo | 114 | operation cancelled | Android | 用户在收银台中取消了支付操作 | 用户需要时可再次调用 `getOrderPayment` 重新拉起收银台。
  * @platformNote Android | 需在前台可见的 Activity 中调用，应用退至后台或无有效页面时会返回失败。
+ * @platformNote Android | 用户主动取消支付时返回顶层 errNo 114（operation cancelled）；iOS 在该场景不返回顶层专属 errNo。
  *
  * @public
  */
@@ -3983,6 +4688,8 @@ export declare interface GetOrderPaymentResult {
  *
  * @since 0.0.28
  * @contractStatus verified | 公开成功返回结构与 Android、iOS 一致；失败通过 Promise reject，业务错误在错误对象的 data 字段。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持携带签名信息拉起收银台完成订单支付。
  * @platformSupport iOS | supported | 支持携带签名信息拉起收银台完成订单支付。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -3998,8 +4705,18 @@ export declare interface GetOrderPaymentResult {
  *   "logId": "20260519xxxx"
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 无稳定的顶层 errNo/errMsg；调用失败时 Promise reject，业务错误（errNo、errMsg、errLogId）在错误对象的 data 字段 | 通过 catch 捕获并读取 e.data 排查
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 114,
+ *   "errMsg": "operation cancelled"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode common | 103 | Android,iOS
+ * @errorCode errNo | 114 | operation cancelled | Android | 用户在收银台中取消了支付操作 | 用户需要时可再次调用 `getOrderPaymentWithSign` 重新拉起收银台。
  * @platformNote Android | 需在前台可见的 Activity 中调用，应用退至后台或无有效页面时会返回失败。
+ * @platformNote Android | 用户主动取消支付时返回顶层 errNo 114（operation cancelled）；iOS 在该场景不返回顶层专属 errNo。
  *
  * @public
  */
@@ -4042,39 +4759,64 @@ export declare interface GetPackageInfoResult {
 }
 
 /**
- * 同步获取当前 package 信息。
+ * 同步获取当前 package 信息，仅供 Web SDK 模拟器使用。
+ *
+ * @internal
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
+ */
+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、iOS 均支持同步查询已记录的性能 Entry、设置缓冲区大小，并向已观察的运行时发送新完成的 Entry。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
+ * @platformSupport Android | supported | 支持查询性能 Entry、设置性能缓冲区大小和创建性能观察者。
+ * @platformSupport iOS | supported | 支持查询性能 Entry、设置性能缓冲区大小和创建性能观察者。
  * @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;
 
 /**
  * 获取隐私设置状态。
@@ -4091,6 +4833,8 @@ export declare const getPackageInfoSync: () => GetPackageInfoResult;
  *
  * @since 0.0.19
  * @contractStatus verified | 公开定义与 Android、iOS 的成功、失败路径一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持获取隐私协议授权状态。
  * @platformSupport iOS | supported | 支持获取隐私协议授权状态。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -4105,7 +4849,8 @@ export declare const getPackageInfoSync: () => GetPackageInfoResult;
  *   "needAuthorization": false
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorCode common | 102 | Android,iOS
+ * @platformNote All | 该 API 无专属错误码，失败时统一返回 102。
  *
  * @public
  */
@@ -4126,6 +4871,8 @@ export declare const getPrivacySetting: (params?: {} | undefined) => Promise<Pri
  *
  * @since 0.0.25
  * @contractStatus verified | 由前端基于 Crypto.getRandomValues 实现，入参校验与返回结构在各端一致
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持获取安全随机数
  * @platformSupport iOS | supported | 支持获取安全随机数
  * @platformSupport PC | supported | 支持获取安全随机数
@@ -4184,6 +4931,8 @@ export declare interface GetRandomValuesResult {
  * @since 0.0.36
  * @contractStatus verified | Android、iOS 均支持单例录音管理、授权、状态事件、停止结果和可选分片事件
  * @contractMismatch non-blocking | platform | pcm、wav 无分片录音 | Android,iOS | format 支持 aac、pcm、wav，并通过字段约束说明平台组合要求 | Android 的 pcm、wav 必须设置大于 0 的 frameSize，iOS 可在不设置 frameSize 时直接录制 pcm、wav | 不按 Android 组合要求传参时仅 Android 启动失败 | packages/open-api/src/media/record.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/media/recorder/RecorderManager.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Media/Recorder/AIBridgeRecorderManager.swift | 对齐双端无分片 pcm、wav 能力
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持 AAC 录音和带 frameSize 的 PCM/WAV 分片录音
  * @platformSupport iOS | supported | 支持 AAC、PCM/WAV 录音和带 frameSize 的分片录音
  * @platformSupport PC | unsupported | 暂不支持
@@ -4238,6 +4987,8 @@ export declare interface GetSavedFileListResult {
  * @since 0.0.19
  * @contractStatus conflict | 豆包 iOS 未注册该接口，仅 Android 可调用
  * @contractMismatch blocking | platform | 获取屏幕亮度 | iOS | 双端均可获取屏幕亮度 | 豆包 iOS 未注册 doubao.getScreenBrightness，仅提供 IDL 抽象类，调用直接失败 | iOS 上调用无法取得屏幕亮度 | packages/open-api/src/device/screen/get-screen-brightness.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/system/GetScreenBrightnessMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/IDL/AbsGetScreenBrightnessMethodIDL.swift; ai-sdk/ios/AISDK/Sources/Core/AISDK.swift | 补齐豆包 iOS getScreenBrightness 实现与注册
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持获取屏幕亮度
  * @platformSupport iOS | unsupported | 豆包 iOS 未实现获取屏幕亮度接口
  * @platformSupport PC | unsupported | 暂不支持
@@ -4251,7 +5002,7 @@ export declare interface GetSavedFileListResult {
  *   "value": 0.6
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | Android 根据异常信息重试，iOS 暂不支持该 API
+ * @errorCode common | 102 | Android
  *
  * @public
  */
@@ -4282,12 +5033,15 @@ export declare interface GetScreenBrightnessResult {
  *
  * @since 0.0.36
  * @contractStatus verified | withSubscriptions 当前仅允许 false，Android、iOS 均支持返回授权设置。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持获取用户的应用授权设置。
  * @platformSupport iOS | supported | 支持获取用户的应用授权设置。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
  * @platformSupport HarmonyOS | unsupported | 当前未提供该平台实现。
  * @permission none | - | none | Android,iOS | 无需额外权限
  * @precondition All | 无额外前置条件
+ * @usageNote All | authSetting 只表示当前智能服务的 scope 授权，不表示宿主系统权限；HealthKit 逐类型系统状态通过 getAppAuthorizeSetting 查询。
  * @usageNote All | authSetting 只包含已向用户请求过且状态明确的权限；豆包当前不支持订阅模板，不要传入 withSubscriptions: true。
  * @resultExample
  * ```json
@@ -4298,7 +5052,17 @@ export declare interface GetScreenBrightnessResult {
  *   }
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 传入 withSubscriptions: true 等失败当前只返回文本信息，未稳定返回顶层 errNo/errMsg | 不要传入 withSubscriptions: true
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 103,
+ *   "errMsg": "feature not support"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 103 | feature not support | Android,iOS | 传入 withSubscriptions: true，豆包当前不支持订阅消息模板 | 不要传入 withSubscriptions: true，仅使用默认的 false
+ * @errorCode errNo | 116 | resource not found | Android | 未找到当前应用对应的运行环境记录 | 确认应用已正确安装并在有效运行环境中调用后重试
+ * @platformNote iOS | iOS 不返回 errNo 116（resource not found），相应失败场景统一以 errNo 102（internal error）返回。
  *
  * @public
  */
@@ -4319,7 +5083,7 @@ export declare interface GetSettingParams {
 export declare interface GetSettingResult {
     /** 用户授权结果，key 为权限 scope，value 表示是否已授权 */
     authSetting: AuthSetting;
-    /** 用户订阅消息设置，withSubscriptions 为 true 时才会返回 */
+    /** 预留的订阅消息设置字段。豆包当前仅支持 `withSubscriptions: false`，因此不会返回该字段。 */
     subscriptionsSetting?: SubscriptionsSetting;
 }
 
@@ -4342,6 +5106,8 @@ export declare interface GetSettingResult {
  * @since 0.0.17
  * @contractStatus conflict | key 不存在时双端返回空值且判定成功，与公开必返 data 类型冲突。
  * @contractMismatch blocking | return | result.data | Android,iOS | data 为必返字段，类型为 TData | key 不存在时 Android 返回 null、iOS 返回 nil，且均按成功返回，不抛出错误 | 调用方按必返字段使用会得到 undefined，且无法区分「未写入」与「写入了空值」 | ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/storage/GetStorageMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Storage/GetStorageMethod.swift; ai-sdk/ios/AISDK/Sources/JSBridge/IDL/AbsGetStorageMethodIDL.swift | key 不存在时改为返回 keyNotFound 错误，或将公开 data 字段改为可选
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持按智能服务维度读取本地缓存。
  * @platformSupport iOS | supported | 支持按智能服务维度读取本地缓存。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -4388,6 +5154,8 @@ export declare function getStorage<TData = unknown>(params: GetStorageParams): P
  *
  * @since 0.0.17
  * @contractStatus verified | 返回字段、单位及 Android、iOS 错误字段已核对一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持查询当前智能服务的本地缓存信息。
  * @platformSupport iOS | supported | 支持查询当前智能服务的本地缓存信息。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -4434,6 +5202,8 @@ export declare interface GetStorageInfoResult {
  *
  * @since 0.0.19
  * @contractStatus verified | 返回字段、单位及 Android、iOS 错误字段已核对一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持同步查询当前智能服务的本地缓存信息。
  * @platformSupport iOS | supported | 支持同步查询当前智能服务的本地缓存信息。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -4486,6 +5256,8 @@ export declare interface GetStorageResult<TData = unknown> {
  * @since 0.0.19
  * @contractStatus conflict | key 不存在时双端返回空值且判定成功，与公开必返 data 类型冲突。
  * @contractMismatch blocking | return | result.data | Android,iOS | data 为必返字段，类型为 TData | key 不存在时 Android 返回 null、iOS 返回 nil，且均按成功返回，不抛出错误 | 调用方按必返字段使用会得到 undefined，且无法区分「未写入」与「写入了空值」 | ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/storage/GetStorageMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Storage/GetStorageMethod.swift; ai-sdk/ios/AISDK/Sources/JSBridge/IDL/AbsGetStorageMethodIDL.swift | key 不存在时改为返回 keyNotFound 错误，或将公开 data 字段改为可选
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持按智能服务维度同步读取本地缓存。
  * @platformSupport iOS | supported | 支持按智能服务维度同步读取本地缓存。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -4520,7 +5292,7 @@ export declare function getStorageSync<TData = unknown>(params: GetStorageParams
 /**
  * 获取系统信息。
  *
- * @returns 返回设备品牌、型号、屏幕尺寸、宿主信息和安全区域等字段，见 {@link GetSystemInfoResult}。
+ * @returns 返回设备品牌、型号、屏幕尺寸、豆包客户端信息和安全区域等字段，见 {@link GetSystemInfoResult}。
  * @example
  * ```typescript
  * import { getSystemInfo } from '@doubao-dev/framework/api';
@@ -4533,7 +5305,9 @@ 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 对应字段
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持获取系统信息。
  * @platformSupport iOS | supported | 支持获取系统信息。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -4572,7 +5346,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
  */
@@ -4598,7 +5372,7 @@ export declare interface GetSystemInfoResult {
     statusBarHeight: number;
     /** 系统语言，格式为 language_region，如 zh_CN、en_US */
     language: string;
-    /** 宿主版本号 */
+    /** 豆包客户端版本号 */
     version?: string;
     /** 操作系统及版本，如 "Android 14"、"iOS 17.5" */
     system: string;
@@ -4616,14 +5390,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';
@@ -4636,7 +5410,9 @@ 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 对应字段
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持同步获取系统信息。
  * @platformSupport iOS | supported | 支持同步获取系统信息。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -4675,7 +5451,7 @@ export declare interface GetSystemInfoResult {
  * }
  * ```
  * @errorCode common | 102 | Android
- * @platformNote Android | abi 返回宿主 App 二进制接口类型（如 arm64-v8a），iOS 不返回该字段
+ * @platformNote Android | abi 返回豆包客户端二进制接口类型（如 arm64-v8a），iOS 不返回该字段
  *
  * @public
  */
@@ -4698,6 +5474,8 @@ export declare const getSystemInfoSync: (_params?: {}) => GetSystemInfoResult;
  * @since 0.0.25
  * @contractStatus verified | 蓝牙、定位、Wi-Fi 和设备方向字段与公开类型一致，均可稳定返回。
  * @contractMismatch non-blocking | return | wifiEnabled | Android,iOS | wifiEnabled 表示 Wi-Fi 系统开关状态 | Android 返回系统 Wi-Fi 开关是否打开，iOS 返回当前是否正在通过 Wi-Fi 联网 | 双端 wifiEnabled 语义不同，但不会破坏公开类型 | packages/open-api/src/basic/system/system.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/system/GetSystemSettingMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/System | 统一双端 wifiEnabled 语义，或在公开字段说明中固定其中一种
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持获取设备系统设置。
  * @platformSupport iOS | supported | 支持获取设备系统设置。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -4713,7 +5491,7 @@ export declare const getSystemInfoSync: (_params?: {}) => GetSystemInfoResult;
  *   "deviceOrientation": "portrait"
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorCode common | 102 | Android
  * @platformNote Android | wifiEnabled 表示系统 Wi-Fi 开关是否打开
  * @platformNote iOS | wifiEnabled 表示当前是否正在通过 Wi-Fi 联网
  *
@@ -4751,6 +5529,8 @@ export declare interface GetSystemSettingResult {
  * @since 0.0.25
  * @contractStatus conflict | 双端均可调用，但 Android 返回扫描到的周边 Wi-Fi，iOS 仅返回当前连接
  * @contractMismatch blocking | behavior | 扫描范围 | iOS | 返回周边可用的 Wi-Fi 列表 | 豆包 iOS 无系统扫描能力，仅返回当前已连接的一条 Wi-Fi | iOS 上无法列出周边 Wi-Fi，列表最多一条 | packages/open-api/src/device/wifi/wifi.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/wifi/WifiInfoReader.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/Wifi/AIBridgeWifiManager.swift | 记录 iOS 无法扫描周边 Wi-Fi
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持扫描并返回周边 Wi-Fi 列表
  * @platformSupport iOS | supported | 仅返回当前已连接的 Wi-Fi
  * @platformSupport PC | unsupported | 暂不支持
@@ -4775,7 +5555,26 @@ export declare interface GetSystemSettingResult {
  *   ]
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据返回的错误信息（如未初始化、无权限）提示用户
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 1401001,
+ *   "errMsg": "wifi is not initialized"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 1401001 | wifi is not initialized | Android,iOS | 调用前未先调用 startWifi 完成初始化 | 先调用 startWifi 再获取 Wi-Fi 列表
+ * @errorCode errNo | 1401002 | wifi is not connected | iOS | iOS 仅返回当前已连接 Wi-Fi，当前未连接时读取失败 | 确认设备已连接 Wi-Fi 后重试
+ * @errorCode errNo | 106 | system permission denied | iOS | 系统定位服务未开启，无法读取 Wi-Fi 信息 | 引导用户在系统设置中开启定位服务
+ * @errorCode errNo | 107 | user permission denied | iOS | 用户未授予定位权限或未开启精确定位 | 引导用户授予定位权限并开启精确定位
+ * @errorCode errNo | 114 | operation cancelled | iOS | 用户取消了位置权限授权弹窗 | 用户需要时可再次触发授权后重试
+ * @errorCode errNo | 301 | network request cancelled | iOS | 位置授权过程中的网络请求被取消 | 确认应用和网络状态后重试
+ * @errorCode errNo | 302 | connection timed out | iOS | 位置授权过程中的网络连接超时 | 检查网络连接后重试
+ * @errorCode errNo | 303 | no network connection | iOS | 当前无可用网络连接 | 恢复网络连接后重试
+ * @errorCode errNo | 305 | network failure | iOS | 位置授权过程中发生其他网络错误 | 检查网络连接，稍后重试
+ * @errorCode errNo | 112 | invalid result | iOS | 位置授权服务返回的数据无法解析 | 稍后重试；持续失败时反馈服务端响应异常
+ * @platformNote Android | 未初始化返回 1401001；扫描列表为空不视为失败；因定位权限不足导致读取失败时返回 102。
+ * @platformNote iOS | 仅返回当前已连接 Wi-Fi，未连接返回 1401002；读取前会发起位置权限授权，可返回 106/107 及授权网络类失败（301/302/303/305/112）。
  *
  * @public
  */
@@ -4807,6 +5606,8 @@ export declare interface GetWifiListResult {
  *
  * @since 0.0.18
  * @contractStatus verified | 窗口信息由智能服务运行环境读取，字段与公开类型一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持获取窗口信息。
  * @platformSupport iOS | supported | 支持获取窗口信息。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -4876,6 +5677,8 @@ export declare interface GetWindowInfoResult {
  *
  * @since 0.0.18
  * @contractStatus verified | 窗口信息由智能服务运行环境同步读取，字段与公开类型一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持同步获取窗口信息。
  * @platformSupport iOS | supported | 支持同步获取窗口信息。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -4931,6 +5734,40 @@ export declare interface GyroscopeChangeEvent {
  */
 export declare type GyroscopeChangeListener = (event: GyroscopeChangeEvent) => void;
 
+/** @public */
+export declare interface HealthDataAuthorizationDetail {
+    /** iOS SDK 支持的全部健康类型及其读取状态。 */
+    readStatus: HealthDataAuthorizationItem[];
+}
+
+/** @public */
+export declare interface HealthDataAuthorizationItem {
+    /** 健康数据类型。 */
+    type: HealthDataType_2;
+    /** 当前类型的读取权限状态码。 */
+    status: HealthDataAuthorizationStatus;
+}
+
+/**
+ * HealthKit 读取权限状态码。
+ *
+ * - `-1`：未知或当前系统不支持该类型
+ * - `0`：系统仍需要展示授权请求
+ * - `1`：轻量查询推断为已拒绝
+ * - `2`：轻量查询未发现授权错误
+ *
+ * @public
+ */
+export declare type HealthDataAuthorizationStatus = -1 | 0 | 1 | 2;
+
+/** @public */
+export declare interface HealthDataAuthorizeOptions {
+    /** 健康数据类型列表；用于申请对应的 HealthKit 读取权限。 */
+    types: HealthDataType[];
+}
+
+export declare type HealthDataType = HealthDataType_2;
+
 /**
  * 隐藏交互提示框的公共参数。
  *
@@ -4951,6 +5788,8 @@ export declare interface HideInteractionParams {
  *
  * @since 0.0.25
  * @contractStatus verified | 无返回字段，与 Android、iOS 实现一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持收起当前键盘。
  * @platformSupport iOS | supported | 支持收起当前键盘。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -4980,6 +5819,8 @@ export declare interface HideKeyboardParam {
  *
  * @since 0.0.26
  * @contractStatus verified | 无参数、无返回字段，与 Android、iOS 实现一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持隐藏当前 loading。
  * @platformSupport iOS | supported | 支持隐藏当前 loading。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -5005,6 +5846,8 @@ export declare const hideLoading: (params?: HideInteractionParams | undefined) =
  *
  * @since 0.0.26
  * @contractStatus verified | 无参数、无返回字段，与 Android、iOS 实现一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持隐藏当前 Toast。
  * @platformSupport iOS | supported | 支持隐藏当前 Toast。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -5149,6 +5992,8 @@ export declare interface InnerAudioError {
  * @since 0.0.25
  * @contractStatus conflict | 豆包 iOS 未提供查询配对状态能力，仅 Android 可调用
  * @contractMismatch blocking | platform | 查询配对状态 | iOS | 双端均可查询设备配对状态 | 豆包 iOS 的 isBluetoothDevicePaired 固定返回不支持 | iOS 上调用无法查询设备是否已配对 | packages/open-api/src/device/bluetooth/bluetooth.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/IsBluetoothDevicePairedMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeDeviceBluetoothMethods.swift | 补齐豆包 iOS 查询配对状态能力
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持查询设备配对状态
  * @platformSupport iOS | unsupported | 豆包 iOS 未实现查询配对状态，调用返回不支持
  * @platformSupport PC | unsupported | 暂不支持
@@ -5209,6 +6054,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 {
     /**
@@ -5291,6 +6149,8 @@ export declare type LocationOperationResult = Record<string, never>;
  *
  * @since 0.0.19
  * @contractStatus verified | 公开参数、超时语义、返回结构及 Android、iOS 错误字段已核对一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持获取当前智能服务的一次性登录凭证。
  * @platformSupport iOS | supported | 支持获取当前智能服务的一次性登录凭证。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -5405,6 +6265,8 @@ export declare const LoginType: {
  * @since 0.0.19
  * @contractStatus conflict | loginType 的四个枚举语义未在 Android、iOS 完整实现。
  * @contractMismatch blocking | parameter | params.loginType | Android,iOS | 通过 0/1/2/3 分别指定隐私登录、仅登录、先登录再隐私（两次弹窗）、登录与隐私合并（一次弹窗） | Android 仅区分 0（隐私流程）与非 0（登录流程），iOS 按当前隐私授权状态路由、仅记录 loginType 不据其分流，两次弹窗与合并弹窗语义均未生效 | 调用方无法通过 loginType 精确控制弹窗形态 | packages/open-api/src/open/login/login-with-doubao-widget.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/login/LoginWithDoubaoWidgetMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Auth/AppletPageLoginManager.swift | 明确 loginType 各枚举的双端一致行为或收敛可选值
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持拉起豆包登录或隐私授权流程。
  * @platformSupport iOS | supported | 支持拉起豆包登录或隐私授权流程。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -5419,7 +6281,17 @@ export declare const LoginType: {
  *   "result": true
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 112,
+ *   "errMsg": "invalid result"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 112 | invalid result | Android | 登录或隐私状态查询成功但返回数据缺失（如缺少隐私卡片或手机掩码） | 稍后重试；持续失败时反馈服务端响应异常。
+ * @platformNote Android | 状态查询成功但关键数据缺失返回 112；其他失败统一返回 102。
+ * @platformNote iOS | 失败统一返回 102。
  *
  * @public
  */
@@ -5460,6 +6332,8 @@ export declare interface LoginWithWidgetResult {
  * @since 0.0.25
  * @contractStatus conflict | 豆包 iOS 未提供蓝牙配对能力，仅 Android 可调用
  * @contractMismatch blocking | platform | 蓝牙配对 | iOS | 双端均可发起蓝牙配对 | 豆包 iOS 的 makeBluetoothPair 固定返回不支持 | iOS 上调用无法发起蓝牙配对 | packages/open-api/src/device/bluetooth/bluetooth.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/MakeBluetoothPairMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeDeviceBluetoothMethods.swift | 补齐豆包 iOS 蓝牙配对能力
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持发起蓝牙配对
  * @platformSupport iOS | unsupported | 豆包 iOS 未实现蓝牙配对，调用返回不支持
  * @platformSupport PC | unsupported | 暂不支持
@@ -5517,6 +6391,8 @@ export declare interface MakeBluetoothPairParams {
  * @since 0.0.19
  * @contractStatus conflict | 拨号成功语义双端不一致
  * @contractMismatch blocking | behavior | 拨号成功语义 | Android,iOS | 唤起系统拨号并返回成功 | Android 通过 ACTION_DIAL 打开拨号盘即成功，iOS 通过 open(tel:) 唤起，是否进入拨号盘取决于系统处理结果 | 相同调用在双端"成功"代表的实际状态不同 | packages/open-api/src/device/phone/phone.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/AIBridgePhoneMethods.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgePhoneMethods.swift | 统一双端拨号成功语义
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持唤起系统拨号
  * @platformSupport iOS | supported | 支持唤起系统拨号
  * @platformSupport PC | unsupported | 暂不支持
@@ -5528,7 +6404,16 @@ export declare interface MakeBluetoothPairParams {
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息确认设备是否支持拨号
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 104,
+ *   "errMsg": "invalid parameter"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 104 | invalid parameter | Android,iOS | phoneNumber 为空，或在 iOS 上无法拼接为有效的拨号 URL | 传入合法的电话号码后重试。
+ * @errorCode errNo | 103 | feature not support | iOS | 当前设备不支持拨打电话 | 在支持拨号的设备上调用，或提前提示用户设备不支持拨号。
  *
  * @public
  */
@@ -5560,6 +6445,13 @@ export declare interface MenuButtonBoundingClientRect {
     left: number;
 }
 
+/**
+ * 麦克风精细授权状态，取值与 {@link BasicAuthorizationDetail} 一致。
+ *
+ * @public
+ */
+export declare type MicrophoneAuthorizationDetail = BasicAuthorizationDetail;
+
 /**
  * {@link FileSystemManager.mkdir} 的参数。
  *
@@ -5594,6 +6486,8 @@ export declare interface MkdirParams {
  *
  * @since 0.0.19
  * @contractStatus verified | 公开参数、返回语义及 Android、iOS 失败字段已核对一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持在页面栈内返回指定层数。
  * @platformSupport iOS | supported | 支持在页面栈内返回指定层数。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -5601,7 +6495,7 @@ export declare interface MkdirParams {
  * @permission none | - | none | Android,iOS | 无需额外权限
  * @precondition All | 无额外前置条件
  * @usageNote All | navigateBack 只能在页面栈内返回；当前页面已是页面栈中的最后一个页面时无法继续返回，需要退出智能服务请调用 exitApp。
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorCode common | 102 | Android,iOS
  *
  * @public
  */
@@ -5631,6 +6525,8 @@ export declare interface NavigateBackParams {
  *
  * @since 0.0.19
  * @contractStatus verified | 公开参数、跳转语义及 Android、iOS 失败字段已核对一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持在当前智能服务内跳转到指定页面。
  * @platformSupport iOS | supported | 支持在当前智能服务内跳转到指定页面。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -5638,7 +6534,15 @@ export declare interface NavigateBackParams {
  * @permission none | - | none | Android,iOS | 无需额外权限
  * @precondition All | 无额外前置条件
  * @usageNote All | url 为智能服务内的页面路径，可携带查询参数；跳转后当前页面会保留在页面栈中，可通过 navigateBack 返回。
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 104,
+ *   "errMsg": "invalid url"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 104 | invalid url | Android,iOS | url 为空或无法解析为有效的智能服务页面路径 | 检查 url 是否为合法的应用内页面路径后重试。
  *
  * @public
  */
@@ -5684,6 +6588,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 特征值变化。
  *
@@ -5704,6 +6618,8 @@ export declare type NetworkType = 'wifi' | '2g' | '3g' | '4g' | '5g' | 'unknown'
  * @returns 不包含字段的结果对象。
  * @since 0.0.25
  * @contractStatus verified | 订阅特征值变化的入参与返回结构已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持订阅 BLE 特征值变化
  * @platformSupport iOS | supported | 支持订阅 BLE 特征值变化
  * @platformSupport PC | unsupported | 暂不支持
@@ -5764,6 +6680,8 @@ export declare interface NotifyBLECharacteristicValueChangeParams {
  * ```
  * @since 0.0.27
  * @contractStatus verified | 加速度事件的字段类型与必返性已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持监听加速度数据变化
  * @platformSupport iOS | supported | 支持监听加速度数据变化
  * @platformSupport PC | unsupported | 暂不支持
@@ -5803,6 +6721,8 @@ export declare const onAccelerometerChange: ClientEventRegistry<AccelerometerCha
  * ```
  * @since 0.0.25
  * @contractStatus verified | 省电模式变化事件的 isLowPowerModeEnabled 字段类型与必返性已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持监听省电模式变化
  * @platformSupport iOS | supported | 支持监听省电模式变化
  * @platformSupport PC | unsupported | 暂不支持
@@ -5843,6 +6763,8 @@ export declare const onBatteryInfoChange: ClientEventRegistry<BatteryInfoChangeE
  *
  * @since 0.0.36
  * @contractStatus verified | BLE 特征值变化事件的结构已与 Android、iOS 当前实现对齐；value 由框架统一解码为 ArrayBuffer
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持监听 BLE 特征值变化
  * @platformSupport iOS | supported | 支持监听 BLE 特征值变化
  * @platformSupport PC | unsupported | 暂不支持
@@ -5883,6 +6805,8 @@ export declare function onBLECharacteristicValueChange(callback: BLECharacterist
  *
  * @since 0.0.36
  * @contractStatus verified | BLE 连接状态变化事件的结构已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持监听 BLE 连接状态变化
  * @platformSupport iOS | supported | 支持监听 BLE 连接状态变化
  * @platformSupport PC | unsupported | 暂不支持
@@ -5922,6 +6846,8 @@ export declare const onBLEConnectionStateChange: ClientEventRegistry<BLEConnecti
  *
  * @since 0.0.36
  * @contractStatus verified | 蓝牙适配器状态变化事件的结构已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持监听蓝牙适配器状态变化
  * @platformSupport iOS | supported | 支持监听蓝牙适配器状态变化
  * @platformSupport PC | unsupported | 暂不支持
@@ -5961,6 +6887,8 @@ export declare const onBluetoothAdapterStateChange: ClientEventRegistry<GetBluet
  *
  * @since 0.0.36
  * @contractStatus verified | 发现蓝牙设备事件的结构已与 Android、iOS 当前实现对齐；广播二进制字段由框架统一解码为 ArrayBuffer
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持监听发现蓝牙设备
  * @platformSupport iOS | supported | 支持监听发现蓝牙设备
  * @platformSupport PC | unsupported | 暂不支持
@@ -5988,6 +6916,45 @@ 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 | 事件字段、状态枚举和触发语义与对话框高度变化协议一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
+ * @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>;
+
 /**
  * 监听罗盘数据变化事件。
  *
@@ -6005,6 +6972,8 @@ export declare function onBluetoothDeviceFound(callback: BluetoothDeviceFoundLis
  * ```
  * @since 0.0.26
  * @contractStatus verified | 罗盘事件的 direction 字段类型与必返性已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持监听罗盘数据变化
  * @platformSupport iOS | supported | 支持监听罗盘数据变化
  * @platformSupport PC | unsupported | 暂不支持
@@ -6041,6 +7010,8 @@ export declare const onCompassChange: ClientEventRegistry<CompassChangeEvent>;
  * ```
  * @since 0.0.29
  * @contractStatus verified | 设备方向事件的字段类型与必返性已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持监听设备方向变化
  * @platformSupport iOS | supported | 支持监听设备方向变化
  * @platformSupport PC | unsupported | 暂不支持
@@ -6079,6 +7050,8 @@ export declare const onDeviceMotionChange: ClientEventRegistry<DeviceMotionChang
  * ```
  * @since 0.0.27
  * @contractStatus verified | 陀螺仪事件的字段类型与必返性已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持监听陀螺仪数据变化
  * @platformSupport iOS | supported | 支持监听陀螺仪数据变化
  * @platformSupport PC | unsupported | 暂不支持
@@ -6116,6 +7089,8 @@ export declare const onGyroscopeChange: ClientEventRegistry<GyroscopeChangeEvent
  * @since 0.0.20
  * @contractStatus verified | 回调字段与 Android、iOS 事件一致；高度单位存在平台差异，已在平台差异中说明。
  * @contractMismatch non-blocking | return | event.height | Android,iOS | 键盘高度，单位 px | Android 返回物理像素高度，iOS 返回逻辑像素（points）高度 | 同一键盘在两端返回的数值口径不同，公开类型可承载 | ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/event/KeyboardHeightChangeEventHelper.kt; ai-sdk/ios/AISDK/Sources/JSBridge | 统一双端键盘高度的单位口径
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持监听键盘高度变化。
  * @platformSupport iOS | supported | 支持监听键盘高度变化。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -6155,6 +7130,8 @@ export declare const onKeyboardHeightChange: ClientEventRegistry<KeyboardHeightC
  * @since 0.0.32
  * @contractStatus verified | 豆包 Android、iOS 成功事件均会返回必需的 latitude 和 longitude，其他字段可由公开可选类型承载
  * @contractMismatch non-blocking | return | event.verticalAccuracy、event.horizontalAccuracy | Android,iOS | 两个精度字段均为可选 number | 豆包 Android 固定返回 0，iOS 返回系统定位结果中的精度值 | 双端精度字段语义不同，但不会破坏公开类型 | flow_android/business/applet/impl/src/main/java/com/bytedance/applet/impl/AppletHostLocationActionServiceImpl.kt; flow_ios/flow_iOS/Modules/FlowApplet/Sources/AIBridge/FlowAIBridgeService.swift | 保留平台说明，后续统一双端精度字段语义
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持监听位置变化事件
  * @platformSupport iOS | supported | 支持监听位置变化事件
  * @platformSupport PC | unsupported | 暂不支持
@@ -6203,6 +7180,8 @@ export declare function onLocationChange(callback: LocationChangeListener): () =
  * @since 0.0.32
  * @contractStatus verified | 错误信息必返、错误码可选的公开类型可准确表达双端事件
  * @contractMismatch non-blocking | return | event.errCode | Android,iOS | errCode 为可选 number | 豆包 Android 的定位异常事件固定补充 0；iOS 返回系统错误码，但位置结果无效时可能省略 errCode | 双端字段出现规则不同，但公开可选类型可准确承载 | flow_android/business/applet/impl/src/main/java/com/bytedance/applet/impl/AppletHostLocationActionServiceImpl.kt; flow_ios/flow_iOS/Modules/FlowApplet/Sources/AIBridge/FlowAIBridgeService.swift | 保留平台错误码说明，后续统一双端缺省错误码策略
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持监听位置更新异常事件
  * @platformSupport iOS | supported | 支持监听位置更新异常事件
  * @platformSupport PC | unsupported | 暂不支持
@@ -6254,6 +7233,8 @@ export declare function onLocationChangeError(callback: LocationChangeErrorListe
  *
  * @since 0.0.26
  * @contractStatus verified | 网络状态事件的 isConnected、networkType 字段类型与必返性已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持监听网络状态变化
  * @platformSupport iOS | supported | 支持监听网络状态变化
  * @platformSupport PC | unsupported | 暂不支持
@@ -6277,7 +7258,7 @@ export declare const onNetworkStatusChange: ClientEventRegistry<NetworkStatusCha
 /**
  * 监听应用主题变化。
  *
- * 当用户在系统设置或宿主内切换浅色、深色主题时触发。回调参数中的 `theme` 表示切换后的主题，可与
+ * 当用户在系统设置或豆包客户端内切换浅色、深色主题时触发。回调参数中的 `theme` 表示切换后的主题，可与
  * {@link getAppBaseInfo} 返回的 `theme` 字段配合使用。
  *
  * @summary 监听应用主题变化。
@@ -6295,7 +7276,9 @@ 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 稳定触发
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持注册主题变化监听。
  * @platformSupport iOS | supported | 支持注册主题变化监听。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -6310,7 +7293,7 @@ export declare const onNetworkStatusChange: ClientEventRegistry<NetworkStatusCha
  * }
  * ```
  * @errorCode none | - | - | Android,iOS | 该监听只接收成功的主题变化事件 | 无需处理
- * @platformNote Android | 主题变化事件依赖宿主接入主题通知，未接入时可能不触发
+ * @platformNote Android | 主题变化事件依赖豆包客户端接入主题通知，未接入时可能不触发
  *
  * @public
  */
@@ -6335,6 +7318,8 @@ export declare function onThemeChange(callback: ThemeChangeListener): () => void
  * @since 0.0.26
  * @contractStatus verified | 用户截屏事件的空参数结构已与 Android、iOS 当前实现对齐；双端检测机制不同但公开类型已准确表达
  * @contractMismatch non-blocking | behavior | 截屏检测机制 | Android,iOS | 监听用户主动截屏 | iOS 监听系统截屏通知全版本可用，Android 14+ 使用系统截屏回调、低版本回退相册变化监听且需读取图片权限 | 低版本 Android 检测准确性与权限依赖不同 | packages/open-api/src/device/screen/on-user-capture-screen.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/event/UserCaptureScreenEventHelper.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeUserCaptureScreenEventHelper.swift | 统一双端截屏检测机制与权限要求
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持监听用户截屏
  * @platformSupport iOS | supported | 支持监听用户截屏
  * @platformSupport PC | unsupported | 暂不支持
@@ -6371,6 +7356,8 @@ export declare const onUserCaptureScreen: ClientEventRegistry<UserCaptureScreenE
  * @since 0.0.37
  * @contractStatus verified | 录屏事件的 state 字段类型与必返性已与 Android、iOS 当前实现对齐；双端支持范围不同但公开类型已准确表达
  * @contractMismatch non-blocking | platform | 录屏事件支持范围 | Android | 监听用户录屏状态变化 | iOS 全版本可用且订阅后立即回报当前状态，Android 仅 Android 15 及以上生效、低版本静默不上报 | 低版本 Android 无法收到录屏事件 | packages/open-api/src/device/screen/on-user-screen-record.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/system/AIBridgeScreenMethods.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeScreenMethods.swift | 补齐低版本 Android 录屏事件能力
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持监听用户录屏（Android 15 及以上）
  * @platformSupport iOS | supported | 支持监听用户录屏
  * @platformSupport PC | unsupported | 暂不支持
@@ -6409,6 +7396,8 @@ export declare const onUserScreenRecord: ClientEventRegistry<UserScreenRecordEve
  *
  * @since 0.0.31
  * @contractStatus verified | 双端均可监听 Wi-Fi 连接事件
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持监听 Wi-Fi 连接事件
  * @platformSupport iOS | supported | 支持监听 Wi-Fi 连接事件
  * @platformSupport PC | unsupported | 暂不支持
@@ -6431,73 +7420,6 @@ export declare const onUserScreenRecord: ClientEventRegistry<UserScreenRecordEve
  */
 export declare const onWifiConnected: ClientEventRegistry<WifiConnectedEvent>;
 
-/**
- * 通过 deep link 等方式打开外部应用。
- *
- * @param params - 外部应用打开参数。
- * @returns 返回一个 Promise，成功时解析为外部应用打开结果（{@link OpenAppResult}）。
- * @example
- * ```typescript
- * import { openApp } from '@doubao-dev/framework/api';
- *
- * const { status } = await openApp({
- *   uri: 'demo://detail?id=1',
- *   fallbackUrl: 'https://example.com/download'
- * });
- *
- * console.log(status);
- * ```
- *
- * @since 0.0.6
- * @contractStatus conflict | Android 已实现，iOS 未提供可调用实现。
- * @contractMismatch blocking | platform | 打开外部应用 | iOS | 通过 applet.openApp 打开外部应用并返回执行方式 status | 豆包 iOS 暂未提供该能力，调用会返回不支持 | 该 API 在豆包 iOS 无法打开外部应用 | packages/open-api/src/open/business/open-app.ts; ai-sdk/ios/AISDK/Sources/JSBridge/IDL/AbsOpenAppMethodIDL.swift | 补齐豆包 iOS applet.openApp 实现后再在该平台开放文档
- * @platformSupport Android | supported | 支持通过 deep link、应用市场或浏览器兜底打开外部应用。
- * @platformSupport iOS | unsupported | 豆包当前未实现打开外部应用能力。
- * @platformSupport PC | unsupported | 当前未提供该平台实现。
- * @platformSupport HarmonyOS | unsupported | 当前未提供该平台实现。
- * @permission none | - | none | Android | 无需额外权限
- * @precondition Android | 传入合法的 uri。
- * @usageNote All | 建议同时传入 fallbackUrl，当目标应用未安装、deep link 无法命中时可兜底至应用市场或浏览器。iOS 暂不支持，请勿在该平台调用。
- * @resultExample
- * ```json
- * {
- *   "status": "deep_link"
- * }
- * ```
- * @platformNote Android | 客户端会依次尝试 deep link、应用市场、浏览器，并通过 status 返回实际执行方式（deep_link、market、browser）。
- * @errorCode none | - | - | Android | 无 API 专属错误码 | 无需处理
- *
- * @public
- */
-export declare const openApp: (params: OpenAppRequest) => Promise<OpenAppResult>;
-
-/** @public */
-export declare interface OpenAppRequest {
-    /** 要打开的目标 URI，例如 `scheme://path?query`。 */
-    uri: string;
-    /**
-     * Android 上的目标应用包名，可选。
-     *
-     * @default -
-     */
-    targetPackage?: string;
-    /**
-     * deep link 失败时的兜底 URL，可选。
-     *
-     * @default -
-     */
-    fallbackUrl?: string;
-}
-
-/** @public */
-export declare interface OpenAppResult {
-    /** 客户端实际执行的打开方式。 */
-    status: OpenAppStatus;
-}
-
-/** @public */
-export declare type OpenAppStatus = 'deep_link' | 'market' | 'browser';
-
 /**
  * 打开蓝牙适配器。
  *
@@ -6513,6 +7435,8 @@ export declare type OpenAppStatus = 'deep_link' | 'market' | 'browser';
  * @returns 不包含字段的结果对象。
  * @since 0.0.25
  * @contractStatus verified | 打开蓝牙适配器的入参与返回结构已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持打开蓝牙适配器
  * @platformSupport iOS | supported | 支持打开蓝牙适配器
  * @platformSupport PC | unsupported | 暂不支持
@@ -6595,17 +7519,74 @@ export declare interface OpenLocationParams {
      */
     scale?: number;
     /**
-     * 经度
+     * 经度
+     *
+     * @constraint -180 至 180
+     */
+    longitude: number;
+    /**
+     * 纬度
+     *
+     * @constraint -90 至 90
+     */
+    latitude: number;
+}
+
+/**
+ * 打开应用内页面。
+ *
+ * 在主对话流卡片中调用时会重新打开全页并忽略 `mode`；在全页或全页内 Chat UI 的卡片中调用时按照
+ * `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.43
+ * @contractStatus verified | Android、iOS 均支持通过 url 和页面栈 mode 打开应用内页面。
+ * @platformSupport Android | supported | 支持 push、replace、navigate 和 pop_to 页面栈操作。
+ * @platformSupport iOS | supported | 支持 push、replace、navigate 和 pop_to 页面栈操作。
+ * @platformSupport PC | unsupported | 当前未提供该平台实现。
+ * @platformSupport HarmonyOS | unsupported | 当前未提供该平台实现。
+ * @permission none | - | none | Android,iOS | 无需额外权限
+ * @precondition All | 无额外前置条件
+ * @usageNote All | mode 省略时按 push 处理；主对话流卡片中重新打开全页，全页及其 Chat UI 中应用页面栈操作。
+ * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ *
+ * @public
+ */
+export declare const openPage: (params: OpenPageParams) => Promise<object>;
+
+/**
+ * 打开页面时使用的页面栈操作。
+ *
+ * @public
+ */
+export declare type OpenPageMode = 'push' | 'replace' | 'navigate' | 'pop_to';
+
+/** @public */
+export declare interface OpenPageParams {
+    /** 应用内页面路径，可携带查询参数。 */
+    url: string;
+    /**
+     * 页面栈操作。
      *
-     * @constraint -180 至 180
-     */
-    longitude: number;
-    /**
-     * 纬度
+     * - `push`：始终压入新的页面实例。
+     * - `replace`：目标为栈顶页面时更新栈顶页面，否则替换栈顶页面。
+     * - `navigate`：目标已在栈中时回退到最近的目标页面并更新，否则压入新页面。
+     * - `pop_to`：目标已在栈中时回退到最近的目标页面并更新，否则替换栈顶页面。
      *
-     * @constraint -90 至 90
+     * @default 'push'
      */
-    latitude: number;
+    mode?: OpenPageMode;
 }
 
 /**
@@ -6616,7 +7597,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';
@@ -6631,12 +7612,15 @@ export declare interface OpenLocationParams {
  *
  * @since 0.0.39
  * @contractStatus verified | withSubscriptions 当前仅允许 false，Android、iOS 均支持打开设置页并返回授权设置。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持打开授权设置页并在关闭后返回最新授权设置。
  * @platformSupport iOS | supported | 支持打开授权设置页并在关闭后返回最新授权设置。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
  * @platformSupport HarmonyOS | unsupported | 当前未提供该平台实现。
  * @permission none | - | none | Android,iOS | 无需额外权限
  * @precondition All | 无额外前置条件，不要求在用户点击事件中调用。
+ * @usageNote All | 设置页只能修改当前智能服务的 scope，不承载 HealthKit 系统权限设置。
  * @usageNote All | 豆包当前不支持订阅模板，不要传入 withSubscriptions: true。
  * @resultExample
  * ```json
@@ -6668,10 +7652,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';
+
 /**
  * 插件账号信息（仅在插件中调用时包含）。
  *
@@ -6715,6 +7793,8 @@ export declare interface PluginAccountInfo {
  * @contractStatus conflict | result 为 false 时双端回传行为不一致，且 result 为 true 时 code 实为必填。
  * @contractMismatch blocking | behavior | params.result | Android,iOS | result 为 false 用于回传登录失败结果，回传完成后 Promise 正常 resolve | Android 在 result 为 false 时正常 resolve，iOS 在 result 为 false 时以失败 reject（message 为 "no login result"） | 调用方无法用统一方式判断失败结果是否已回传成功 | packages/open-api/src/open/login/post-mcp-login.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/login/PostLoginResultMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Auth/AIBridgePostLoginResultMethod.swift | 统一 result 为 false 时的双端回传结果语义
  * @contractMismatch blocking | parameter | params.code | Android,iOS | code 声明为可选，仅在登录结果为 true 时有效 | result 为 true 时若 code 缺省或为空，双端均按失败处理（Android reject、iOS reject） | 调用方误以为成功回传可省略 code | packages/open-api/src/open/login/post-mcp-login.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/login/PostLoginResultMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Auth/AppletPageLoginManager.swift | 将 code 约束为 result 为 true 时必填
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持向豆包回传 MCP 授权登录结果。
  * @platformSupport iOS | supported | 支持向豆包回传 MCP 授权登录结果。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -6723,7 +7803,24 @@ export declare interface PluginAccountInfo {
  * @precondition Android | 先完成登录，并传入登录成功返回的有效 code。
  * @precondition iOS | 先完成登录，并传入登录成功返回的有效 code。
  * @usageNote All | 仅在完成 MCP 授权登录流程后回传结果；登录成功时必须携带有效 code，回传成功后不要重复回传。
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 105,
+ *   "errMsg": "authentication fail"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 104 | invalid parameter | Android | result 为 true 但缺少有效的兑换 code | 传入业务服务端生成的有效 code 后重试。
+ * @errorCode errNo | 105 | authentication fail | Android,iOS | 登录被拒绝或兑换 code 校验未通过 | 确认业务登录状态与 code 是否有效后重试。
+ * @errorCode errNo | 112 | invalid result | Android,iOS | Token 交换服务返回的数据无法解析 | 稍后重试；持续失败时反馈服务端响应异常。
+ * @errorCode errNo | 115 | operation timeout | Android | Token 交换耗时超过限制 | 检查网络后重试。
+ * @errorCode errNo | 301 | network request cancelled | iOS | Token 交换的网络请求被取消 | 确认应用和网络状态后重试。
+ * @errorCode errNo | 302 | connection timed out | Android,iOS | Token 交换的网络连接超时 | 检查网络连接后重试。
+ * @errorCode errNo | 303 | no network connection | Android,iOS | 当前无可用网络连接 | 恢复网络连接后重试。
+ * @errorCode errNo | 305 | network failure | Android,iOS | Token 交换时发生其他网络错误 | 检查网络连接，稍后重试。
+ * @platformNote Android | 缺少有效 code 时返回 104；调用超时返回 115。
+ * @platformNote iOS | 缺少有效 code 时返回 102；网络请求被取消时返回 301，超时归类为 302。
  *
  * @public
  */
@@ -6766,6 +7863,8 @@ export declare interface PostLoginResultRequest {
  * @contractStatus conflict | current 的数字下标形式和 referrerPolicy 在 Android、iOS 当前实现中不生效
  * @contractMismatch blocking | parameter | current | Android,iOS | 可传图片链接或数字下标指定首张图片 | 只按字符串形式与 urls 中的完整图片地址匹配，数字下标不能定位图片 | 传入数字下标时会从第一张图片开始预览 | packages/open-api/src/media/image.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/media/PreviewImageMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Media/AIBridgeImageMethods.swift; flow_android/business/applet/impl/src/main/java/com/bytedance/applet/impl/AppletHostImageServiceImpl.kt; flow_ios/flow_iOS/Modules/FlowApplet/Sources/AIBridge/FlowAIBridgeService.swift | 让双端支持数字下标，或从公开类型中移除数字形式
  * @contractMismatch blocking | parameter | referrerPolicy | Android,iOS | 用 referrerPolicy 控制预览页的 Referrer 策略 | 调用时忽略 referrerPolicy，预览请求不会应用该策略 | 调用方配置的 Referrer 策略不生效 | packages/open-api/src/media/image.ts; ai-sdk/android/ai-sdk/build/api/com/bytedance/ai/bridge/media/image/AbsPreviewImageMethodIDL.kt; ai-sdk/ios/AISDK/Sources/JSBridge/IDL/Media/AbsPreviewImageMethodIDL.swift | 补齐参数透传与预览请求配置，或移除公开字段
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持预览网络图片和豆包智能服务本地图片
  * @platformSupport iOS | supported | 支持预览网络图片和豆包智能服务本地图片
  * @platformSupport PC | unsupported | 暂不支持
@@ -6865,6 +7964,8 @@ export declare interface PrivacySettingResult {
  * @returns 不包含字段的结果对象。
  * @since 0.0.25
  * @contractStatus verified | 读取特征值的入参与返回结构已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持读取 BLE 特征值
  * @platformSupport iOS | supported | 支持读取 BLE 特征值
  * @platformSupport PC | unsupported | 暂不支持
@@ -7126,6 +8227,8 @@ export declare type RecorderSampleRate = 8000 | 11025 | 12000 | 16000 | 22050 |
  *
  * @since 0.0.19
  * @contractStatus verified | 公开参数、跳转语义及 Android、iOS 失败字段已核对一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持关闭当前页面并跳转到指定页面。
  * @platformSupport iOS | supported | 支持关闭当前页面并跳转到指定页面。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -7133,7 +8236,15 @@ export declare type RecorderSampleRate = 8000 | 11025 | 12000 | 16000 | 22050 |
  * @permission none | - | none | Android,iOS | 无需额外权限
  * @precondition All | 无额外前置条件
  * @usageNote All | url 为智能服务内的页面路径，可携带查询参数；跳转会替换当前页面，不保留在页面栈中。
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 104,
+ *   "errMsg": "invalid url"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 104 | invalid url | Android,iOS | url 为空或无法解析为有效的智能服务页面路径 | 检查 url 是否为合法的应用内页面路径后重试。
  *
  * @public
  */
@@ -7153,6 +8264,8 @@ export declare const redirectTo: (params: NavigateToParams) => Promise<object>;
  *
  * @since 0.0.19
  * @contractStatus verified | 公开参数、跳转语义及 Android、iOS 失败字段已核对一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持关闭所有页面并跳转到指定页面。
  * @platformSupport iOS | supported | 支持关闭所有页面并跳转到指定页面。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -7160,7 +8273,15 @@ export declare const redirectTo: (params: NavigateToParams) => Promise<object>;
  * @permission none | - | none | Android,iOS | 无需额外权限
  * @precondition All | 无额外前置条件
  * @usageNote All | url 为智能服务内的页面路径，可携带查询参数；跳转会关闭现有全部页面并以目标页面作为唯一页面。
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 104,
+ *   "errMsg": "invalid url"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 104 | invalid url | Android,iOS | url 为空或无法解析为有效的智能服务页面路径 | 检查 url 是否为合法的应用内页面路径后重试。
  *
  * @public
  */
@@ -7226,6 +8347,8 @@ export declare interface RemoveSavedFileParams {
  *
  * @since 0.0.17
  * @contractStatus verified | 公开参数、删除语义及 Android、iOS 错误字段已核对一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持按智能服务维度删除指定 key。
  * @platformSupport iOS | supported | 支持按智能服务维度删除指定 key。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -7268,6 +8391,8 @@ export declare interface RemoveStorageParams {
  *
  * @since 0.0.19
  * @contractStatus verified | 公开参数、删除语义及 Android、iOS 错误字段已核对一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持按智能服务维度同步删除指定 key。
  * @platformSupport iOS | supported | 支持按智能服务维度同步删除指定 key。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -7330,6 +8455,8 @@ export declare interface RenameParams {
  *
  * @since 0.0.28
  * @contractStatus verified | 事件名与事件参数会被 Android、iOS 一并上报，公开参数与双端消费一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持上报智能服务数据分析事件。
  * @platformSupport iOS | supported | 支持上报智能服务数据分析事件。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -7337,7 +8464,7 @@ export declare interface RenameParams {
  * @permission none | - | none | Android,iOS | 无需额外权限
  * @precondition All | 无额外前置条件。
  * @usageNote All | 事件名与事件参数会用于数据分析，请勿写入用户隐私或敏感数据。
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorCode common | 102 | Android,iOS
  *
  * @public
  */
@@ -7384,6 +8511,8 @@ export declare interface ReportEventParams {
  * @contractStatus conflict | method 支持范围与 arraybuffer 返回类型在 Android、iOS 均与公开类型不一致
  * @contractMismatch blocking | parameter | method | Android,iOS | 公开类型声明 GET/POST/PUT/DELETE/HEAD/OPTIONS/TRACE/CONNECT 八种方法 | Android 仅支持 GET/POST/PUT/DELETE，其余方法返回 "Illegal method"；iOS 仅支持 GET/POST，其余方法返回 "method type not supported" | 调用 PUT/DELETE 时 iOS 会失败；调用 HEAD/OPTIONS/TRACE/CONNECT 时双端均失败 | packages/open-api/src/network/request.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/net/RequestMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Network/AIBridgeRequestMethod.swift | 收窄公开类型声明，或在文档明确各端实际支持范围
  * @contractMismatch blocking | return | RequestResponse.data | Android,iOS | dataType 传入 arraybuffer 时声明返回 ArrayBuffer | Android 将二进制响应以 base64 字符串返回；iOS doubao.request 路径不启用 arraybuffer 支持，返回 base64 编码字符串 | 调用方按 ArrayBuffer 解析会失败 | packages/open-api/src/network/request.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/net/RequestMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Network/AIBridgeRequestMethod.swift | 统一双端 arraybuffer 返回语义，或在文档说明实际返回 base64 字符串
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持发起 HTTP/HTTPS 网络请求，method 支持 GET/POST/PUT/DELETE。
  * @platformSupport iOS | supported | 支持发起 HTTP/HTTPS 网络请求，method 仅支持 GET/POST。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -7402,7 +8531,22 @@ export declare interface ReportEventParams {
  *   }
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 305,
+ *   "errMsg": "network failure"
+ * }
+ * ```
+ * @errorCode common | 102 | iOS
+ * @errorCode errNo | 104 | invalid parameter | Android,iOS | url 为空、method 非法，或请求参数、请求体校验失败 | 修正 url、method 与请求参数后重试。
+ * @errorCode errNo | 110 | API call prohibited | Android,iOS | 请求 URL 未通过域名白名单校验 | 确认目标域名已在智能服务中配置后重试。
+ * @errorCode errNo | 301 | network request cancelled | iOS | 网络请求被取消 | 确认应用与网络状态后重试。
+ * @errorCode errNo | 302 | connection timed out | Android,iOS | 网络连接超时 | 检查网络连接后重试。
+ * @errorCode errNo | 303 | no network connection | Android,iOS | 当前无可用网络连接 | 恢复网络连接后重试。
+ * @errorCode errNo | 305 | network failure | Android,iOS | 发生其他网络错误 | 检查网络连接，稍后重试。
+ * @platformNote Android | 网络失败仅细分为 302（HTTP 408 超时）、303（无网络连接）与 305（其他网络错误），不返回 301；url 为空或 method 非法返回 104；命中域名管控返回 110。
+ * @platformNote iOS | 依据 NSURLError 细分网络失败：请求取消 301、连接超时 302、无网络 303、其他 305；参数或请求体校验失败返回 104；命中域名管控返回 110；其他失败统一返回 102。
  *
  * @public
  */
@@ -7440,6 +8584,8 @@ export declare type RequestMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'HEAD' |
  *
  * @since 0.0.28
  * @contractStatus verified | 成功返回结构与 Android、iOS 一致；失败通过 Promise reject，业务错误在错误对象的 data 字段。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持发起订单支付流程并返回 orderId。
  * @platformSupport iOS | supported | 支持发起订单支付流程并返回 orderId。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -7455,7 +8601,7 @@ export declare type RequestMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'HEAD' |
  *   "logId": "20260519xxxx"
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 无稳定的顶层 errNo/errMsg；调用失败时 Promise reject，业务错误（errNo、errMsg、errLogId）在错误对象的 data 字段 | 通过 catch 捕获并读取 e.data 排查
+ * @errorCode common | 102 | Android,iOS
  * @knownIssue All | 失败结果不会作为 await 的返回值，需通过 catch 捕获并从错误对象的 data 字段读取 errNo、errMsg、errLogId。
  *
  * @public
@@ -7626,6 +8772,8 @@ export declare interface SaveFileResult {
  * ```
  * @since 0.0.26
  * @contractStatus verified | Android、iOS 均可将有效本地图片写入系统相册
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持将本地图片保存到系统相册
  * @platformSupport iOS | supported | 支持将本地图片保存到系统相册
  * @platformSupport PC | unsupported | 暂不支持
@@ -7673,6 +8821,8 @@ export declare interface SaveImageToPhotosAlbumParams {
  * @contractStatus conflict | onlyFromCamera/scanType 参数的生效情况及取消行为双端不一致
  * @contractMismatch blocking | parameter | scanType | Android,iOS | 限制允许的扫码类型 | 双端对 scanType 的过滤支持不一致，部分取值可能不生效 | 依赖类型过滤的调用方可能扫出预期外的码型 | packages/open-api/src/device/scan/scan.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/AIBridgeScanMethods.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeScanMethods.swift | 统一双端扫码类型过滤能力
  * @contractMismatch non-blocking | behavior | 用户取消 | Android,iOS | 用户取消扫码时的返回未在公开类型体现 | 双端在用户取消时的失败表现不一致 | 调用方需分别处理双端的取消结果 | ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/AIBridgeScanMethods.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeScanMethods.swift | 统一取消扫码的返回语义
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持调起扫码
  * @platformSupport iOS | supported | 支持调起扫码
  * @platformSupport PC | unsupported | 暂不支持
@@ -7691,7 +8841,16 @@ export declare interface SaveImageToPhotosAlbumParams {
  *   "scanType": "QR_CODE"
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息确认相机权限及用户是否取消
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 103,
+ *   "errMsg": "feature not support"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 103 | feature not support | Android,iOS | 当前豆包版本或运行环境未提供扫码能力 | 在支持扫码能力的豆包版本中调用。
+ * @errorCode errNo | 112 | invalid result | iOS | 扫码成功但未返回可用的扫码结果数据 | 稍后重试；持续失败时反馈扫码结果异常。
  *
  * @public
  */
@@ -7751,7 +8910,7 @@ export declare type ScanCodeType = 'barCode' | 'qrCode' | 'datamatrix' | 'pdf417
 export declare type ScanResultType = 'QR_CODE' | 'AZTEC' | 'CODABAR' | 'CODE_39' | 'CODE_93' | 'CODE_128' | 'DATA_MATRIX' | 'EAN_8' | 'EAN_13' | 'ITF' | 'MAXICODE' | 'PDF_417' | 'RSS_14' | 'RSS_EXPANDED' | 'UPC_A' | 'UPC_E' | 'UPC_EAN_EXTENSION' | 'WX_CODE' | 'CODE_25';
 
 /** @public */
-export declare type Scope = 'scope.userLocation' | 'scope.userFuzzyLocation' | 'scope.userLocationBackground' | 'scope.payment' | 'scope.record' | 'scope.bluetooth' | 'scope.camera' | 'scope.addPhoneContact' | 'scope.addPhoneCalendar';
+export declare type Scope = 'scope.userLocation' | 'scope.userFuzzyLocation' | 'scope.userLocationBackground' | 'scope.payment' | 'scope.record' | 'scope.bluetooth' | 'scope.camera' | 'scope.addPhoneContact' | 'scope.addPhoneCalendar' | 'scope.healthData';
 
 /**
  * 选择消息文件后返回的文件类型。
@@ -7761,7 +8920,7 @@ export declare type Scope = 'scope.userLocation' | 'scope.userFuzzyLocation' | '
 export declare type SelectedMessageFileType = 'video' | 'image' | 'file';
 
 /**
- * 以用户身份发送后续消息，触发新一轮对话或 API 调用。
+ * 以用户身份发送后续消息，触发新一轮对话、API 调用或引导模型响应。
  *
  * @param params - 要发送的后续消息内容。
  * @returns 返回一个 Promise，在消息发送请求提交后解析。
@@ -7782,6 +8941,13 @@ export declare type SelectedMessageFileType = 'video' | 'image' | 'file';
  *         name: 'selectDrink',
  *         arguments: { drinkId: 'latte_001' }
  *       }
+ *     },
+ *     {
+ *       type: 'responseHint',
+ *       data: {
+ *         userAction: '用户选择了拿铁',
+ *         responseGuidance: '确认已选择拿铁，并询问是否需要调整杯型'
+ *       }
  *     }
  *   ]
  * });
@@ -7789,6 +8955,8 @@ export declare type SelectedMessageFileType = 'video' | 'image' | 'file';
  *
  * @since 0.0.37
  * @contractStatus verified | 公开参数与 Android、iOS 的消息提交行为一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持在卡片或智能服务页面中发送后续消息。
  * @platformSupport iOS | supported | 支持在卡片和智能服务页面中发送后续消息。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -7823,7 +8991,7 @@ export declare interface SendFollowUpMessageParams {
  *
  * @param params - 消息内容及类型。
  * @returns 返回一个 Promise，在消息成功发送时解析。
- * @deprecated 使用 {@link dispatchActionDirective} 描述用户行为并约束模型后续动作。
+ * @deprecated 使用 {@link sendFollowUpMessage} 发送后续消息。
  * @summary 以用户身份发送消息。
  * @example
  * ```typescript
@@ -7844,7 +9012,7 @@ export declare interface SendFollowUpMessageParams {
  * @permission none | - | none | Android,iOS | 无需额外权限
  * @precondition Android | 在卡片或页面环境中调用，由客户端自动获取页面上下文确定目标 bot。
  * @precondition iOS | 在卡片或页面环境中调用，由客户端自动获取页面上下文确定目标 bot。
- * @usageNote All | 该 API 已废弃，请改用 dispatchActionDirective 描述用户行为并约束模型后续动作。
+ * @usageNote All | 该 API 已废弃，请改用 sendFollowUpMessage 发送后续消息。
  * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
  *
  * @internal
@@ -7876,6 +9044,8 @@ export declare interface SendQueryMessageParams {
  * @since 0.0.25
  * @contractStatus conflict | 拉起短信面板的成功语义双端不一致
  * @contractMismatch blocking | behavior | 拉起短信面板成功语义 | Android,iOS | 成功拉起系统短信面板时解析 | Android 通过 Intent 打开短信应用即成功，iOS 通过 MFMessageComposeViewController 呈现并在用户完成/取消后回调，成功时机不同 | 相同调用在双端"成功"代表的实际状态不同 | packages/open-api/src/device/sms/sms.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/AIBridgeSmsMethods.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeSmsMethods.swift | 统一双端拉起短信面板的成功语义
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持拉起系统短信面板
  * @platformSupport iOS | supported | 支持拉起系统短信面板
  * @platformSupport PC | unsupported | 暂不支持
@@ -7887,7 +9057,17 @@ export declare interface SendQueryMessageParams {
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息确认设备是否支持短信
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 114,
+ *   "errMsg": "operation cancelled"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 103 | feature not support | iOS | 当前设备不支持发送短信 | 在支持短信的设备上调用，或提前提示用户设备不支持短信。
+ * @errorCode errNo | 114 | operation cancelled | iOS | 用户在系统短信面板中取消了发送 | 用户需要时可再次调用 `sendSms` 重新拉起短信面板。
+ * @platformNote iOS | 拉起短信面板后用户取消返回 114、发送失败返回 102、设备不支持短信返回 103；Android 无法拉起短信应用时返回 102。
  *
  * @public
  */
@@ -7948,7 +9128,18 @@ export declare type SensorInterval = 'game' | 'ui' | 'normal';
  * @precondition Android | 无额外前置条件
  * @precondition iOS | 无额外前置条件
  * @usageNote All | 该 API 已废弃，请改用 updateModelContext 按任务或实体维度补充模型上下文。
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 103,
+ *   "errMsg": "feature not support"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 103 | feature not support | Android | 当前容器类型不支持设置全局上下文 | 请在支持的容器（页面、卡片或 Worker）环境中调用。
+ * @errorCode errNo | 104 | invalid parameter | iOS | 传入的参数结构非法，无法解析 | 检查传入的参数结构后重试。
+ * @platformNote Android | 当前容器类型不受支持返回 103；其他失败统一返回 102。
+ * @platformNote iOS | 参数结构非法返回 104；其他失败统一返回 102。
  *
  * @internal
  */
@@ -7984,6 +9175,8 @@ export declare interface SetAdditionalContextParams {
  * @since 0.0.25
  * @contractStatus conflict | 豆包 iOS 未提供设置 MTU 能力，仅 Android 可调用
  * @contractMismatch blocking | platform | 设置 MTU | iOS | 双端均可设置 BLE MTU | 豆包 iOS 的 setBLEMTU 固定返回不支持 | iOS 上调用无法设置 MTU | packages/open-api/src/device/bluetooth/bluetooth.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/SetBLEMTUMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeDeviceBluetoothMethods.swift | 补齐豆包 iOS 设置 MTU 能力
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持设置 BLE MTU
  * @platformSupport iOS | unsupported | 豆包 iOS 未实现设置 MTU，调用返回不支持
  * @platformSupport PC | unsupported | 暂不支持
@@ -8042,6 +9235,8 @@ export declare interface SetBLEMTUResult {
  * @returns 不包含字段的结果对象。
  * @since 0.0.20
  * @contractStatus verified | 设置剪贴板的成功语义已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持写入剪贴板
  * @platformSupport iOS | supported | 支持写入剪贴板
  * @platformSupport PC | unsupported | 暂不支持
@@ -8054,7 +9249,16 @@ export declare interface SetBLEMTUResult {
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息确认豆包是否提供剪贴板能力
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 103,
+ *   "errMsg": "feature not support"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 103 | feature not support | Android,iOS | 当前豆包版本或运行环境未提供剪贴板写入能力 | 在支持剪贴板能力的豆包版本中调用。
+ * @errorCode errNo | 106 | system permission denied | Android | 写入后系统未授予剪贴板访问权限，写入未生效 | 引导用户在系统设置中开启剪贴板相关权限后重试。
  *
  * @public
  */
@@ -8080,6 +9284,8 @@ export declare interface SetClipboardDataParams {
  * @since 0.0.25
  * @contractStatus verified | 设置屏幕常亮的成功语义已与 Android、iOS 当前实现对齐；双端实现机制不同但公开类型已准确表达
  * @contractMismatch non-blocking | behavior | 常亮生效范围 | Android,iOS | 设置屏幕保持常亮 | Android 通过窗口 keepScreenOn 标志控制，iOS 通过 isIdleTimerDisabled 引用计数控制并随页面销毁自动恢复 | 常亮的生效范围与自动恢复行为在双端不同 | packages/open-api/src/device/screen/set-keep-screen-on.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/system/AIBridgeScreenMethods.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeScreenMethods.swift | 统一双端常亮的生效范围与恢复策略
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持设置屏幕常亮
  * @platformSupport iOS | supported | 支持设置屏幕常亮
  * @platformSupport PC | unsupported | 暂不支持
@@ -8088,11 +9294,12 @@ export declare interface SetClipboardDataParams {
  * @precondition All | 无额外前置条件
  * @usageNote All | 不再需要常亮时应主动将 keepScreenOn 设为 false，避免额外功耗
  * @platformNote iOS | 页面销毁后常亮状态会自动恢复
+ * @platformNote iOS | 设置常亮恒返回成功，无失败错误码
  * @resultExample
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息重试
+ * @errorCode common | 102 | Android
  *
  * @public
  */
@@ -8125,6 +9332,8 @@ export declare interface SetKeepScreenOnParams {
  *
  * @since 0.0.17
  * @contractStatus verified | 公开参数、写入语义及 Android、iOS 错误字段已核对一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持按智能服务维度写入本地缓存。
  * @platformSupport iOS | supported | 支持按智能服务维度写入本地缓存。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -8174,6 +9383,8 @@ export declare interface SetStorageParams<TData = unknown> {
  *
  * @since 0.0.19
  * @contractStatus verified | 公开参数、写入语义及 Android、iOS 错误字段已核对一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持按智能服务维度同步写入本地缓存。
  * @platformSupport iOS | supported | 支持按智能服务维度同步写入本地缓存。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -8217,6 +9428,8 @@ export declare function setStorageSync<TData = unknown>(params: SetStorageParams
  * @since 0.0.25
  * @contractStatus conflict | 豆包 Android 未提供设置预设列表能力，仅 iOS 可调用
  * @contractMismatch blocking | platform | 设置 Wi-Fi 预设列表 | Android | 双端均可设置预设 Wi-Fi 列表 | 豆包 Android 的 setWifiList 固定返回失败（setWifiList is iOS only） | Android 上调用无法设置预设列表 | packages/open-api/src/device/wifi/wifi.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/wifi/SetWifiListMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/Wifi/AIBridgeSetWifiListMethod.swift | 补齐豆包 Android 设置预设列表能力
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | unsupported | 豆包 Android 未实现设置预设列表，调用固定失败
  * @platformSupport iOS | supported | 支持设置 Wi-Fi 预设列表
  * @platformSupport PC | unsupported | 暂不支持
@@ -8228,7 +9441,17 @@ export declare function setStorageSync<TData = unknown>(params: SetStorageParams
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | Android 不要调用该 API，iOS 根据返回的错误信息重试
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 1401001,
+ *   "errMsg": "wifi is not initialized"
+ * }
+ * ```
+ * @errorCode common | 102 | iOS
+ * @errorCode errNo | 103 | feature not support | Android | 该 API 为 iOS 特有，Android 调用固定失败 | 不要在 Android 调用该 API
+ * @errorCode errNo | 1401001 | wifi is not initialized | iOS | 调用前未先调用 startWifi 完成初始化 | 先调用 startWifi 再设置预设列表
+ * @platformNote Android | 固定返回 103（该能力仅 iOS）；iOS 未初始化返回 1401001，其他失败统一返回 102。
  *
  * @public
  */
@@ -8260,6 +9483,8 @@ export declare interface SetWifiListParams {
  *
  * @since 0.0.26
  * @contractStatus verified | 公开参数、返回 tapIndex 及 Android、iOS 行为已核对一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持展示操作菜单。
  * @platformSupport iOS | supported | 支持展示操作菜单。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -8273,7 +9498,16 @@ export declare interface SetWifiListParams {
  *   "tapIndex": 0
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 114,
+ *   "errMsg": "operation cancelled"
+ * }
+ * ```
+ * @errorCode errNo | 104 | invalid parameter | Android,iOS | itemList 为空数组 | 传入至少一个菜单项后重试。
+ * @errorCode errNo | 114 | operation cancelled | Android,iOS | 用户点击 Cancel 按钮或点击蒙层关闭操作菜单 | 用户主动取消，按需静默处理。
+ * @errorCode common | 102 | Android,iOS
  *
  * @public
  */
@@ -8340,6 +9574,8 @@ export declare interface ShowActionSheetResult {
  * @since 0.0.36
  * @contractStatus conflict | 参数校验错误码双端一致，但 provider 不可用与三按钮场景的错误处理在 Android、iOS 上不一致。
  * @contractMismatch blocking | error | provider 不可用与三按钮场景 | Android,iOS | 同一异常场景返回一致的失败结果 | iOS 在 provider 不可用或不支持三按钮时返回 errNo 103 失败，Android 在 provider 不可用时返回 action=cancel、source=hostUnavailable 的成功结果，且不检测三按钮能力 | 调用方无法用统一逻辑处理弹窗不可用场景 | ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/bottomsheet/ShowBottomSheetMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Doubao/AIBridgeShowBottomSheetMethod.swift | 统一双端 provider 不可用与三按钮场景的错误返回
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持展示 Native 底部弹窗。
  * @platformSupport iOS | supported | 支持展示 Native 底部弹窗。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -8355,8 +9591,16 @@ export declare interface ShowActionSheetResult {
  *   "role": "agreeMain"
  * }
  * ```
- * @errorCode common | 104 | Android,iOS
- * @errorCode common | 103 | iOS
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 104,
+ *   "errMsg": "invalid parameter"
+ * }
+ * ```
+ * @errorCode errNo | 104 | invalid parameter | Android,iOS | title 或 content 为空、content 含被拦截的标签/事件属性/危险链接、buttons 数量不在 1-3 范围；iOS 还会在按钮语义重复或按钮文案为空时返回 | 修正参数后重试。
+ * @errorCode errNo | 103 | feature not support | iOS | 豆包底部弹窗能力不可用，或按钮数为 3 时当前 provider 不支持三按钮 | 降级到自定义弹窗；同场景 Android 返回 action=cancel、source=hostUnavailable 的成功结果，请一并做降级处理。
+ * @platformNote iOS | provider 不可用或不支持三按钮时返回 errNo 103 失败；Android 在 provider 不可用时返回 action=cancel、source=hostUnavailable 的成功结果，且不校验三按钮能力。
  *
  * @public
  */
@@ -8403,6 +9647,8 @@ export declare type ShowBottomSheetResult = BottomSheetButtonClickResult | Botto
  *
  * @since 0.0.26
  * @contractStatus verified | 无参数、无返回字段，与 Android、iOS 实现一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持展示 loading 提示框。
  * @platformSupport iOS | supported | 支持展示 loading 提示框。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -8410,7 +9656,7 @@ export declare type ShowBottomSheetResult = BottomSheetButtonClickResult | Botto
  * @permission none | - | none | Android,iOS | 无需额外权限
  * @precondition All | 无额外前置条件
  * @usageNote All | loading 展示后需调用 hideLoading 手动关闭。
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorCode common | 102 | Android,iOS
  *
  * @public
  */
@@ -8444,26 +9690,27 @@ 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 当前不提供实现。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @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
  * {
  *   "action": "confirm"
  * }
  * ```
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorCode common | 102 | Android,iOS
  *
  * @public
  */
-export declare const showModal: (params: ShowModalParams) => Promise<ShowModalResult>;
+export declare const showModal: (params?: ShowModalParams | undefined) => Promise<ShowModalResult>;
 
 /**
  * 显示模态对话框的参数。
@@ -8476,25 +9723,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
@@ -8510,22 +9782,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';
@@ -8551,6 +9818,8 @@ export declare interface ShowModalResult {
  * @since 0.0.9
  * @contractStatus conflict | 公开参数 customIcon 在 Android、iOS 均未渲染，与其可自定义图标的定义冲突。
  * @contractMismatch blocking | parameter | customIcon | Android,iOS | 传入 URL 或 base64 展示自定义图标 | Android、iOS 均只按 icon/type 渲染内置图标，不加载 customIcon | 依赖 customIcon 展示图标的调用不会生效 | ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/ui/ShowToastMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/UI/AIBridgeShowToastMethod.swift; flow_ios/flow_iOS/Modules/FlowApplet/Sources/AIBridge/FlowAIBridgeService.swift | 补齐豆包双端 customIcon 渲染，或从公开参数中移除 customIcon
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持展示 Toast 提示。
  * @platformSupport iOS | supported | 支持展示 Toast 提示。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -8562,7 +9831,17 @@ export declare interface ShowModalResult {
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 104,
+ *   "errMsg": "invalid parameter"
+ * }
+ * ```
+ * @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。
  *
  * @public
  * */
@@ -8579,8 +9858,8 @@ export declare interface ShowToastParams {
     type?: 'default' | 'success' | 'error' | 'warning';
     /**
      * 提示的持续时间，单位毫秒。
-     * @default -
-     * @constraint Android 默认 3000，iOS 默认 2000，需双端一致时请显式传入。
+     * @default Android 3000，iOS 2000
+     * @constraint 需双端保持一致时请显式传入。
      */
     duration?: number;
     /**
@@ -8601,7 +9880,7 @@ export declare interface ShowToastParams {
  * @param params - `createSignOrder` 返回的平台签约订单号。
  * @returns 签约页面流程正常返回时解析为空对象；该结果不代表签约成功。
  * @remarks
- * 如果用户尚未绑定抖音账号，宿主可能先拉起账号绑定流程，再继续展示签约页面。
+ * 如果用户尚未绑定抖音账号，豆包可能先拉起账号绑定流程，再继续展示签约页面。
  *
  * 用户的最终签约状态必须以业务服务端查询签约单详情或收到的签约结果回调为准。
  * 业务服务端还需要维护业务用户与签约 ID 的对应关系。
@@ -8631,6 +9910,8 @@ export declare interface ShowToastParams {
  * @since 0.0.28
  * @contractStatus verified | 成功解析为空对象，与 Android、iOS 一致；失败通过 Promise reject，业务错误在错误对象的 data 字段。公开联合类型的失败分支不会作为 resolve 值出现，仅作后续对齐项。
  * @contractMismatch non-blocking | return | SignResult | Android,iOS | 返回类型声明为 SignSuccessResult 与 SignFailResult 的联合，暗示失败结果可作为 resolve 值 | 双端成功时 resolve 空对象，失败时通过 Promise reject 返回，业务错误（code、errNo、errMsg、errLogId）在错误对象的 data 字段 | 调用方误以为可对 await 结果做失败分支判断 | packages/open-api/src/open/payment/sign.ts; packages/bridge-base/src/client-api.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/payment/SignMethod.kt | 将公开返回类型收敛为成功结果，失败改由错误对象表达
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持拉起签约流程。
  * @platformSupport iOS | supported | 支持拉起签约流程。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -8643,8 +9924,18 @@ export declare interface ShowToastParams {
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 无稳定的顶层 errNo/errMsg；调用失败时 Promise reject，业务错误（code、errNo、errMsg、errLogId）在错误对象的 data 字段 | 通过 catch 捕获并读取 e.data 排查
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 114,
+ *   "errMsg": "operation cancelled"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode common | 103 | Android,iOS
+ * @errorCode errNo | 114 | operation cancelled | Android | 用户在签约收银台中取消了签约操作 | 用户需要时可再次调用 `sign` 重新发起签约。
  * @platformNote Android | 需在前台可见的 Activity 中调用，应用退至后台或无有效页面时会返回失败。
+ * @platformNote Android | 用户主动取消签约时返回顶层 errNo 114（operation cancelled）；iOS 在该场景不返回顶层专属 errNo。
  * @knownIssue All | 失败结果不会作为 await 的返回值，需通过 catch 捕获并从错误对象的 data 字段读取 code、errNo、errMsg、errLogId。
  *
  * @public
@@ -8699,7 +9990,7 @@ export declare interface SocketTask {
     /**
      * 表示 Socket 正在连接。
      *
-     * `connectSocket` 刚返回且宿主尚未完成握手时通常处于该状态。
+     * `connectSocket` 刚返回且豆包客户端尚未完成握手时通常处于该状态。
      */
     readonly CONNECTING: 0;
     /**
@@ -8711,7 +10002,7 @@ export declare interface SocketTask {
     /**
      * 表示 Socket 连接关闭中。
      *
-     * 调用 {@link SocketTask.close} 后、本地等待宿主侧完成关闭流程时通常处于该状态。
+     * 调用 {@link SocketTask.close} 后，等待豆包客户端完成关闭流程时通常处于该状态。
      */
     readonly CLOSING: 2;
     /**
@@ -8724,7 +10015,7 @@ export declare interface SocketTask {
      * 当前 Socket 连接状态 code。
      *
      * 可与 `CONNECTING`、`OPEN`、`CLOSING`、`CLOSED` 常量比较。
-     * 如果因为参数错误等原因导致连接请求没有被宿主成功创建，则为 `undefined`。
+     * 如果因为参数错误等原因导致豆包客户端没有成功创建连接，则为 `undefined`。
      */
     readonly readyState: number | undefined;
     /**
@@ -8776,7 +10067,7 @@ export declare interface SocketTask {
 /**
  * WebSocket 关闭事件。
  *
- * 当前连接被主动关闭、服务端关闭或宿主侧因异常回收连接时触发。
+ * 当前连接被主动关闭、服务端关闭或豆包客户端因异常回收连接时触发。
  * 触发后 `readyState` 会变为 `SocketTask.CLOSED`，该 `SocketTask` 不应再继续发送数据。
  *
  * @public
@@ -8785,31 +10076,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;
 }
@@ -8826,10 +10117,10 @@ export declare interface SocketTaskCloseParams {
     /**
      * 关闭连接状态码。
      *
-     * 不传时由宿主侧按正常关闭处理，通常等价于 `1000`。
+     * 不传时由豆包客户端按正常关闭处理，通常等价于 `1000`。
      * 常见值包括：
      * - `1000`: 正常关闭；
-     * - `1001`: 因页面进入后台、宿主回收连接等原因关闭。
+     * - `1001`: 因页面进入后台、豆包客户端回收连接等原因关闭。
      */
     code?: number;
     /**
@@ -8852,7 +10143,7 @@ export declare interface SocketTaskErrorEvent {
     /**
      * 错误信息。
      *
-     * 由前端参数校验、编码过程或宿主侧返回的失败原因组成，可直接用于日志上报。
+     * 由前端参数校验、编码过程或豆包客户端返回的失败原因组成，可直接用于日志上报。
      */
     errMsg: string;
 }
@@ -8878,13 +10169,13 @@ export declare interface SocketTaskMessageEvent {
     /**
      * 当前消息所属连接使用的协议。
      *
-     * 该字段由宿主侧返回，部分运行环境可能不提供。
+     * 该字段由豆包客户端返回，部分运行环境可能不提供。
      */
     protocolType?: string;
     /**
-     * 宿主侧使用的 WebSocket 实现类型。
+     * 豆包客户端使用的 WebSocket 实现类型。
      *
-     * 该字段由宿主侧返回，部分运行环境可能不提供。
+     * 该字段由豆包客户端返回，部分运行环境可能不提供。
      */
     socketType?: string;
 }
@@ -8892,7 +10183,7 @@ export declare interface SocketTaskMessageEvent {
 /**
  * WebSocket 连接成功事件。
  *
- * 当宿主侧完成 WebSocket 握手并进入 open 状态后触发。
+ * 当豆包客户端完成 WebSocket 握手并进入 open 状态后触发。
  * 收到该事件后，调用方可以开始通过 {@link SocketTask.send} 发送数据。
  *
  * @public
@@ -8908,13 +10199,13 @@ export declare interface SocketTaskOpenEvent {
     /**
      * 当前连接使用的网络传输层协议。
      *
-     * 该字段由宿主侧返回，部分运行环境可能不提供。
+     * 该字段由豆包客户端返回，部分运行环境可能不提供。
      */
     protocolType?: string;
     /**
-     * 宿主侧使用的 WebSocket 实现类型。
+     * 豆包客户端使用的 WebSocket 实现类型。
      *
-     * 可能的值由宿主实现决定，例如传统 WebSocket 实现或宿主网络库实现；
+     * 可能的值由豆包客户端实现决定，例如系统 WebSocket 实现或豆包网络库实现；
      * 部分运行环境可能不提供。
      */
     socketType?: string;
@@ -8933,7 +10224,7 @@ export declare interface SocketTaskSendParams {
      * 需要发送给服务端的数据。
      *
      * - 传入 `string` 时按文本消息发送；
-     * - 传入 `ArrayBuffer` 时按二进制消息发送，内部会编码后交给宿主侧处理。
+     * - 传入 `ArrayBuffer` 时按二进制消息发送，内部会编码后交给豆包客户端处理。
      *
      * 建议只在 `onOpen` 回调触发后调用 `send`，此时 `readyState` 通常为 `SocketTask.OPEN`。
      */
@@ -8954,6 +10245,8 @@ export declare interface SocketTaskSendParams {
  * @returns 不包含字段的结果对象。
  * @since 0.0.25
  * @contractStatus verified | 开始监听加速度的入参与成功语义已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持开始监听加速度
  * @platformSupport iOS | supported | 支持开始监听加速度
  * @platformSupport PC | unsupported | 暂不支持
@@ -8965,7 +10258,15 @@ export declare interface SocketTaskSendParams {
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息确认设备是否支持加速度传感器
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 103,
+ *   "errMsg": "feature not support"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 103 | feature not support | Android,iOS | 当前设备不支持加速度传感器或无法注册监听 | 在具备加速度传感器的设备上调用，或提前提示用户设备不支持。
  *
  * @public
  */
@@ -9001,6 +10302,8 @@ export declare interface StartAccelerometerParams {
  * @since 0.0.25
  * @contractStatus conflict | ignoreBluetoothAvailable 仅在 iOS 生效，Android 不消费该参数
  * @contractMismatch blocking | parameter | ignoreBluetoothAvailable | Android | 忽略蓝牙可用性校验后继续搜索 | Android 不读取该字段，蓝牙不可用时仍会失败 | Android 调用方设置该参数不会生效 | packages/open-api/src/device/ibeacon/beacon.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/StartBeaconDiscoveryMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeDeviceBeaconMethods.swift | 补齐 Android 对 ignoreBluetoothAvailable 的处理或收敛为 iOS 特有参数
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持搜索附近的 iBeacon
  * @platformSupport iOS | supported | 支持搜索附近的 iBeacon
  * @platformSupport PC | unsupported | 暂不支持
@@ -9065,6 +10368,8 @@ export declare interface StartBeaconDiscoveryParams {
  * @returns 不包含字段的结果对象。
  * @since 0.0.25
  * @contractStatus verified | 搜索蓝牙设备的入参与返回结构已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持搜索附近蓝牙设备
  * @platformSupport iOS | supported | 支持搜索附近蓝牙设备
  * @platformSupport PC | unsupported | 暂不支持
@@ -9134,6 +10439,8 @@ export declare interface StartBluetoothDevicesDiscoveryParams {
  * @since 0.0.25
  * @contractStatus verified | 开始监听罗盘的成功语义已与 Android、iOS 当前实现对齐；双端回调频率策略不同但不影响公开类型
  * @contractMismatch non-blocking | behavior | 回调频率策略 | Android,iOS | 按监听频率持续回调罗盘方向 | Android 将频率作为采样速率，iOS 将其作为回调节流阈值 | 相同频率下双端实际回调节奏不同 | ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/AIBridgeCompassMethods.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeCompassMethods.swift | 统一双端监听频率的物理含义
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持开始监听罗盘
  * @platformSupport iOS | supported | 支持开始监听罗盘
  * @platformSupport PC | unsupported | 暂不支持
@@ -9145,7 +10452,15 @@ export declare interface StartBluetoothDevicesDiscoveryParams {
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息确认设备是否支持罗盘传感器
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 103,
+ *   "errMsg": "feature not support"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 103 | feature not support | Android,iOS | 当前设备不支持罗盘传感器或无法注册监听 | 在具备罗盘传感器的设备上调用，或提前提示用户设备不支持。
  *
  * @public
  */
@@ -9165,6 +10480,8 @@ export declare const startCompass: (params?: {} | undefined) => Promise<object>;
  * @returns 不包含字段的结果对象。
  * @since 0.0.25
  * @contractStatus verified | 开始监听设备方向的入参与成功语义已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持开始监听设备方向变化
  * @platformSupport iOS | supported | 支持开始监听设备方向变化
  * @platformSupport PC | unsupported | 暂不支持
@@ -9176,7 +10493,15 @@ export declare const startCompass: (params?: {} | undefined) => Promise<object>;
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息确认设备是否支持方向传感器
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 103,
+ *   "errMsg": "feature not support"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 103 | feature not support | Android,iOS | 当前设备不支持方向传感器或无法注册监听 | 在具备方向传感器的设备上调用，或提前提示用户设备不支持。
  *
  * @public
  */
@@ -9211,6 +10536,8 @@ export declare interface StartDeviceMotionListeningParams {
  * @returns 不包含字段的结果对象。
  * @since 0.0.25
  * @contractStatus verified | 开始监听陀螺仪的入参与成功语义已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持开始监听陀螺仪
  * @platformSupport iOS | supported | 支持开始监听陀螺仪
  * @platformSupport PC | unsupported | 暂不支持
@@ -9222,7 +10549,15 @@ export declare interface StartDeviceMotionListeningParams {
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息确认设备是否支持陀螺仪传感器
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 103,
+ *   "errMsg": "feature not support"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 103 | feature not support | Android,iOS | 当前设备不支持陀螺仪传感器或无法注册监听 | 在具备陀螺仪传感器的设备上调用，或提前提示用户设备不支持。
  *
  * @public
  */
@@ -9258,6 +10593,8 @@ export declare interface StartGyroscopeParams {
  * @since 0.0.32
  * @contractStatus conflict | iOS 原生参数模型要求 type 必传，与公开可选类型冲突
  * @contractMismatch blocking | default | type | iOS | type 可省略，省略时使用 gcj02 | 省略 type 时调用失败 | iOS 调用方必须显式传入 type | packages/open-api/src/location/location.ts; ai-sdk/ios/AISDK/Sources/JSBridge/IDL/System/AbsStartLocationUpdateMethodIDL.swift | 将 iOS type 调整为可选并保留 gcj02 默认值，或将公开参数改为必填
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持启动持续定位
  * @platformSupport iOS | supported | 支持启动持续定位
  * @platformSupport PC | unsupported | 暂不支持
@@ -9276,7 +10613,22 @@ export declare interface StartGyroscopeParams {
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息检查授权、系统定位服务和是否重复启动
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 1700001,
+ *   "errMsg": "location permission denied"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @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。
  *
  * @public
  */
@@ -9309,6 +10661,8 @@ export declare interface StartLocationUpdateParams {
  *
  * @since 0.0.25
  * @contractStatus verified | 双端均可初始化 Wi-Fi 模块
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持初始化 Wi-Fi 模块
  * @platformSupport iOS | supported | 支持初始化 Wi-Fi 模块
  * @platformSupport PC | unsupported | 暂不支持
@@ -9319,7 +10673,16 @@ export declare interface StartLocationUpdateParams {
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据返回的错误信息重试
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 103,
+ *   "errMsg": "feature not support"
+ * }
+ * ```
+ * @errorCode common | 102 | Android
+ * @errorCode errNo | 103 | feature not support | Android | 设备无可用的 Wi-Fi 能力（缺少系统 Wi-Fi 服务） | 检查设备是否支持 Wi-Fi，不支持时不要调用
+ * @platformNote iOS | 初始化恒返回成功，不返回失败错误码。
  *
  * @public
  */
@@ -9369,6 +10732,8 @@ export declare interface StatResult {
  * @returns 不包含字段的结果对象。
  * @since 0.0.25
  * @contractStatus verified | 停止监听加速度的成功语义已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持停止监听加速度
  * @platformSupport iOS | supported | 支持停止监听加速度
  * @platformSupport PC | unsupported | 暂不支持
@@ -9399,6 +10764,8 @@ export declare const stopAccelerometer: (params?: {} | undefined) => Promise<obj
  * @since 0.0.25
  * @contractStatus verified | 停止搜索的成功语义与公开类型一致；双端权限与失败行为不同但不影响公开契约
  * @contractMismatch non-blocking | behavior | 失败行为 | Android,iOS | 停止搜索并返回成功 | Android 需定位与蓝牙权限、缺失时可能失败，iOS 恒返回成功 | 双端失败可能性不同，但公开成功语义一致 | ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/StopBeaconDiscoveryMethod.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeDeviceBeaconMethods.swift | 统一双端停止搜索的权限与成功行为
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持停止搜索 iBeacon
  * @platformSupport iOS | supported | 支持停止搜索 iBeacon
  * @platformSupport PC | unsupported | 暂不支持
@@ -9440,6 +10807,8 @@ export declare const stopBeaconDiscovery: (params?: {} | undefined) => Promise<o
  * @returns 不包含字段的结果对象。
  * @since 0.0.25
  * @contractStatus verified | 停止搜索蓝牙设备的入参与返回结构已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持停止搜索蓝牙设备
  * @platformSupport iOS | supported | 支持停止搜索蓝牙设备
  * @platformSupport PC | unsupported | 暂不支持
@@ -9471,6 +10840,8 @@ export declare const stopBluetoothDevicesDiscovery: (params?: {} | undefined) =>
  * @returns 不包含字段的结果对象。
  * @since 0.0.25
  * @contractStatus verified | 停止监听罗盘的成功语义已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持停止监听罗盘
  * @platformSupport iOS | supported | 支持停止监听罗盘
  * @platformSupport PC | unsupported | 暂不支持
@@ -9500,6 +10871,8 @@ export declare const stopCompass: (params?: {} | undefined) => Promise<object>;
  * @returns 不包含字段的结果对象。
  * @since 0.0.25
  * @contractStatus verified | 停止监听设备方向的成功语义已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持停止监听设备方向变化
  * @platformSupport iOS | supported | 支持停止监听设备方向变化
  * @platformSupport PC | unsupported | 暂不支持
@@ -9529,6 +10902,8 @@ export declare const stopDeviceMotionListening: (params?: {} | undefined) => Pro
  * @returns 不包含字段的结果对象。
  * @since 0.0.25
  * @contractStatus verified | 停止监听陀螺仪的成功语义已与 Android、iOS 当前实现对齐
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持停止监听陀螺仪
  * @platformSupport iOS | supported | 支持停止监听陀螺仪
  * @platformSupport PC | unsupported | 暂不支持
@@ -9558,6 +10933,8 @@ export declare const stopGyroscope: (params?: {} | undefined) => Promise<object>
  * @returns 不包含字段的结果对象。
  * @since 0.0.32
  * @contractStatus verified | 停止语义与 Android、iOS 当前实现一致，未启动时调用也成功
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持停止持续定位
  * @platformSupport iOS | supported | 支持停止持续定位
  * @platformSupport PC | unsupported | 暂不支持
@@ -9569,7 +10946,16 @@ export declare const stopGyroscope: (params?: {} | undefined) => Promise<object>
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息确认持续定位状态后重试
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 103,
+ *   "errMsg": "feature not support"
+ * }
+ * ```
+ * @errorCode common | 102 | Android,iOS
+ * @errorCode errNo | 103 | feature not support | Android,iOS | 当前豆包客户端未提供持续定位能力（location service 不可用），无法停止 | 请在支持持续定位的豆包版本中调用
+ * @platformNote All | 未启动或仍在授权阶段调用直接返回成功；仅在已启动后停止失败时返回错误码，其他失败统一返回 102。
  *
  * @public
  */
@@ -9589,6 +10975,8 @@ export declare function stopLocationUpdate(): Promise<LocationOperationResult>;
  *
  * @since 0.0.25
  * @contractStatus verified | 双端均可关闭 Wi-Fi 模块
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持关闭 Wi-Fi 模块
  * @platformSupport iOS | supported | 支持关闭 Wi-Fi 模块
  * @platformSupport PC | unsupported | 暂不支持
@@ -9599,7 +10987,7 @@ export declare function stopLocationUpdate(): Promise<LocationOperationResult>;
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据返回的错误信息重试
+ * @errorCode none | - | - | Android,iOS | 该接口双端恒返回成功，无 API 专属错误码 | 无需处理
  *
  * @public
  */
@@ -9754,6 +11142,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} 的参数。
  *
@@ -9777,6 +11177,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} 的参数。
  *
@@ -9831,6 +11243,8 @@ export declare interface UnzipParams {
  *
  * @since 0.0.26
  * @contractStatus verified | 公开定义与 Android、iOS 的成功、失败路径一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持向 Agent 捐赠模型上下文。
  * @platformSupport iOS | supported | 支持向 Agent 捐赠模型上下文。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -9839,7 +11253,23 @@ export declare interface UnzipParams {
  * @precondition Android | 未传 taskId 时需传 entityId；两者都不传时仅可在卡片环境调用，以便客户端补充必要信息。
  * @precondition iOS | 未传 taskId 时需传 entityId；两者都不传时仅可在卡片环境调用，以便客户端补充必要信息。
  * @usageNote All | 用于在任务或实体维度补充模型可理解的上下文，请在业务状态变化后按需调用，避免高频重复捐赠相同内容。
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 305,
+ *   "errMsg": "network failure"
+ * }
+ * ```
+ * @errorCode common | 100 | Android
+ * @errorCode common | 102 | Android
+ * @errorCode errNo | 103 | feature not support | Android | 当前容器类型不受支持，无法归类为页面、卡片或 Worker 来源 | 请在支持的容器（页面、卡片或 Worker）环境中调用。
+ * @errorCode errNo | 112 | invalid result | Android | 捐赠上下文的远端响应无法解析 | 稍后重试；持续失败时反馈服务端响应异常。
+ * @errorCode errNo | 301 | network request cancelled | iOS | 捐赠上下文的网络请求被取消 | 确认应用与网络状态后重试。
+ * @errorCode errNo | 302 | connection timed out | Android,iOS | 捐赠上下文的网络连接超时 | 检查网络连接后重试。
+ * @errorCode errNo | 303 | no network connection | Android,iOS | 当前无可用网络连接 | 恢复网络连接后重试。
+ * @errorCode errNo | 305 | network failure | Android,iOS | 捐赠上下文时发生其他网络错误 | 检查网络连接，稍后重试。
+ * @platformNote Android | 网络失败细分为连接超时 302、无网络 303、其他网络错误 305；远端响应无法解析返回 112；当前容器类型不受支持返回 103；其他失败统一返回 102，未归类的远端业务错误返回 100。
+ * @platformNote iOS | 依据网络错误细分：请求取消 301、连接超时 302、无网络 303、其他 305；不支持的调用来源仅回退处理、不作为失败。
  *
  * @public
  */
@@ -9888,6 +11318,8 @@ export declare interface UpdateModelContextParams {
  *
  * @since 0.0.26
  * @contractStatus verified | 公开定义与 Android、iOS 的成功、失败路径一致。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持更新 Widget 卡片实例的渲染数据。
  * @platformSupport iOS | supported | 支持更新 Widget 卡片实例的渲染数据。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -9896,7 +11328,18 @@ export declare interface UpdateModelContextParams {
  * @precondition Android | 在卡片或消息环境中调用，需传入有效的 widgetInstanceId。
  * @precondition iOS | 在卡片或消息环境中调用，需传入有效的 widgetInstanceId。
  * @usageNote All | 请在卡片交互或服务端结果回写后调用；传入的 widgetData 通常为 `JSON.stringify(viewData)`。
- * @errorCode none | - | - | Android,iOS | 无 API 专属错误码 | 无需处理
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 104,
+ *   "errMsg": "invalid parameter"
+ * }
+ * ```
+ * @errorCode common | 102 | 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。
  *
  * @public
  */
@@ -9965,6 +11408,8 @@ export declare interface UpdateWidgetParams {
  *
  * @since 0.0.39
  * @contractStatus verified | enableProfile 当前仅允许 false，Android、iOS 均支持正常发起上传。
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持文件上传、进度监听、响应头监听和中断任务。
  * @platformSupport iOS | supported | 支持文件上传、进度监听、响应头监听和中断任务。
  * @platformSupport PC | unsupported | 当前未提供该平台实现。
@@ -9978,7 +11423,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
@@ -10011,14 +11456,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 -
      */
@@ -10030,7 +11475,7 @@ export declare interface UploadFileParams {
      */
     formData?: Record<string, unknown>;
     /**
-     * 超时时间，单位 ms；不传时使用宿主侧默认超时配置。
+     * 超时时间，单位 ms；不传时使用豆包客户端的默认超时配置。
      *
      * @default -
      */
@@ -10072,7 +11517,7 @@ export declare interface UploadTask extends Promise<UploadFileResult> {
     /**
      * 监听上传进度变化。
      *
-     * 同一个任务可以注册多个回调，每次收到宿主进度事件时依次调用。
+     * 同一个任务可以注册多个回调，每次收到豆包客户端的进度事件时依次调用。
      */
     onProgressUpdate: (callback: (event: UploadTaskProgressUpdateEvent) => void) => void;
     /**
@@ -10084,7 +11529,7 @@ export declare interface UploadTask extends Promise<UploadFileResult> {
     /**
      * 监听 HTTP Response Header 事件。
      *
-     * 同一个任务可以注册多个回调，宿主收到上传响应头时依次调用。
+     * 同一个任务可以注册多个回调，豆包客户端收到上传响应头时依次调用。
      */
     onHeadersReceived: (callback: (event: UploadTaskHeadersReceivedEvent) => void) => void;
     /**
@@ -10172,6 +11617,8 @@ export declare type UserScreenRecordState = 'start' | 'stop';
  * @since 0.0.25
  * @contractStatus conflict | 长震动的成功语义双端不一致
  * @contractMismatch blocking | behavior | 长震动成功语义 | Android,iOS | 触发一次长震动并返回成功 | Android 固定震动约 400ms 且在设备不支持时可能失败，iOS 恒返回成功 | 依赖统一成功语义的调用方在双端体验不一致 | ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/AIBridgeVibrateMethods.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeVibrateMethods.swift | 统一双端长震动时长与失败语义
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持长震动
  * @platformSupport iOS | supported | 支持长震动
  * @platformSupport PC | unsupported | 暂不支持
@@ -10183,7 +11630,16 @@ export declare type UserScreenRecordState = 'start' | 'stop';
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息确认设备是否支持震动
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 103,
+ *   "errMsg": "feature not support"
+ * }
+ * ```
+ * @errorCode errNo | 103 | feature not support | Android | Android 设备无振动器或不支持震动能力 | 提示用户当前设备不支持震动，避免依赖该能力
+ * @errorCode common | 102 | Android
+ * @platformNote iOS | 长震动恒返回成功，无失败错误码
  *
  * @public
  */
@@ -10203,6 +11659,8 @@ export declare const vibrateLong: (params?: {} | undefined) => Promise<object>;
  * @since 0.0.25
  * @contractStatus conflict | type 参数在 Android 侧的必填性与 TypeScript 可选声明不一致
  * @contractMismatch blocking | parameter | type | Android | 可选参数，省略时使用默认强度 | Android 底层要求必传 type，省略可能导致调用不生效 | 未显式传 type 的调用在 Android 上行为不确定 | packages/open-api/src/device/vibration/vibration.ts; ai-sdk/android/ai-sdk/src/main/java/com/bytedance/ai/bridge/method/device/AIBridgeVibrateMethods.kt; ai-sdk/ios/AISDK/Sources/JSBridge/Methods/Device/AIBridgeVibrateMethods.swift | 对齐双端 type 的可选性与默认值
+ * @containerSupport Page | supported
+ * @containerSupport Widget | supported
  * @platformSupport Android | supported | 支持短震动
  * @platformSupport iOS | supported | 支持短震动
  * @platformSupport PC | unsupported | 暂不支持
@@ -10214,7 +11672,16 @@ export declare const vibrateLong: (params?: {} | undefined) => Promise<object>;
  * ```json
  * {}
  * ```
- * @errorCode none | - | - | Android,iOS | 当前实现未稳定返回顶层 errNo/errMsg | 根据异常信息确认设备是否支持震动
+ * @errorExample
+ * ```json
+ * {
+ *   "errNo": 103,
+ *   "errMsg": "feature not support"
+ * }
+ * ```
+ * @errorCode errNo | 103 | feature not support | Android,iOS | Android 设备无振动器或不支持震动能力，或 iOS 系统版本低于 13.0 | 提示用户当前设备或系统不支持震动，避免依赖该能力
+ * @errorCode common | 102 | Android
+ * @platformNote Android | 设备不支持震动或触发震动失败时返回 102 internal error；iOS 无对应失败错误码
  *
  * @public
  */
@@ -10339,6 +11806,8 @@ export declare interface WindowSafeArea {
  * @returns 不包含字段的结果对象。
  * @since 0.0.25
  * @contractStatus verified | 写入特征值的入参与返回结构已与 Android、iOS 当前实现对齐；value 由框架统一编码为 Base64 传给原生
+ * @containerSupport Page | supported
+ * @containerSupport Widget | unsupported
  * @platformSupport Android | supported | 支持写入 BLE 特征值
  * @platformSupport iOS | supported | 支持写入 BLE 特征值
  * @platformSupport PC | unsupported | 暂不支持