@webskill/chatbot 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { AgentLoopConfig, ApprovalScope, BridgeCapabilities, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, HookRunner, InteractionRequest, InteractionResponse, LifecycleEventInit, LlmClient, NetworkPolicy, Page, PageQuery, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshotListEntry, RuntimePhase, ScriptExecutor, SessionStore, SkillCatalogEntry, SkillIntegrityGuard, SkillOutcomeReporter, SkillStateGuard, UiBridge, UiSpecDrafts, UiSpecEvent, UiSpecSnapshot, UiSurfaceActionRequest, UiSurfaceActionResponse, UserProfile, UserProfileEntry, UserProfileExport, WebSkillErrorCode, diffUserProfile } from "@webskill/sdk";
+import { AgentLoopConfig, ApprovalScope, BridgeCapabilities, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, HookRunner, InteractionRequest, InteractionResponse, LifecycleEventInit, LlmClient, NetworkPolicy, Page, PageQuery, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshotListEntry, RuntimePhase, ScriptExecutor, SessionStore, SkillCandidateMarker, SkillCatalogEntry, SkillIntegrityGuard, SkillOutcomeReporter, SkillStateGuard, UiBridge, UiSpecDrafts, UiSpecEvent, UiSpecSnapshot, UiSurfaceActionRequest, UiSurfaceActionResponse, UserProfile, UserProfileEntry, UserProfileExport, WebSkillErrorCode, diffUserProfile } from "@webskill/sdk";
 import { SandboxMode, TypeScriptSupportOptions } from "@webskill/sdk/browser";
 import { CustomSurfaceActionEvent, ReactBridgeState, SpecInteractionChannel, SurfaceRegistry, UiSurfaceActionEvent } from "@webskill/sdk/ui-react";
-import { PagePerceptionPolicy, PerceptionRecord, SkillCandidateSink, TodoItem } from "@webskill/sdk/agent";
+import { PageActionPolicy, PagePerceptionPolicy, PerceptionRecord, SkillCandidateSink, TodoItem } from "@webskill/sdk/agent";
 import "react";
 import "react/jsx-runtime";
 //#region ../ui-kit/src/i18n/types.d.ts
@@ -365,7 +365,11 @@ interface ChatInteractionRecord {
 interface ChatMessage {
   id: string;
   role: 'user' | 'assistant';
-  text: string;
+  /**
+   * 消息正文。本 run 一个字也没产出时（例如模型开口前就被中止）**缺省**，
+   * 与「产出了空串」区分开——写空串会渲染出一个空白气泡（FR-20.4）。
+   */
+  text?: string;
   ts: string;
   /** user 消息携带的附件（旧会话文件无该字段） */
   attachments?: ChatAttachmentMeta[];
@@ -413,6 +417,12 @@ interface ChatMessage {
    * @experimental
    */
   interactions?: ChatInteractionRecord[];
+  /**
+   * 该轮提交的技能候选（FR-24.1）。数据来自 `$skillCandidate` 载荷，
+   * 不从模型复述的自然语言里解析。
+   * @experimental
+   */
+  candidates?: SkillCandidateMarker[];
 }
 /** @stable */
 interface ChatSessionMeta {
@@ -579,6 +589,8 @@ interface ChatbotHostAdapter {
     openConsole(): void;
     /** 跳 console Traces 面板并定位该 run（v1.1；缺省时消息不渲染 View trace 入口） */
     openConsoleTrace?(runId: string): void;
+    /** 打开治理面的审批队列并定位该候选（FR-24.2）；宿主未接治理面时不提供，入口随之不渲染 */
+    openConsoleCandidate?(candidateId: string): void;
   };
   /** 缺省 BrowserWorkerScriptExecutor（@webskill/browser）；Node 宿主可注入自己的执行器 */
   executor?: ScriptExecutor;
@@ -589,6 +601,13 @@ interface ChatbotHostAdapter {
    * @experimental
    */
   pagePerception?: PagePerceptionPolicy;
+  /**
+   * 页面操作能力（需求 23）。**不注入即完全关闭**，与 `pagePerception` 分开：
+   * 可读不等于可操作。同样只能在这里注入——给终端用户一个「打开代操作」的开关
+   * 等于把安全边界交给最不了解它的人。
+   * @experimental
+   */
+  pageActions?: PageActionPolicy;
 }
 //#endregion
 //#region src/core/chatEngine.d.ts
@@ -824,6 +843,12 @@ interface CompositeUiBridgeDeps {
    * @experimental
    */
   onResolved?(request: InteractionRequest, response: InteractionResponse): void;
+  /**
+   * 工具返回值里的技能候选（FR-24.1）。它不经任何渲染层，
+   * 直接给引擎收集到本 run 的终态消息上。
+   * @experimental
+   */
+  onSkillCandidate?(runId: string, candidate: SkillCandidateMarker): void;
   emit(event: ChatEvent): void;
 }
 /**
@@ -849,6 +874,7 @@ declare class CompositeUiBridge implements UiBridge {
   requestSurfaceAction(input: UiSurfaceActionRequest): Promise<UiSurfaceActionResponse>;
   cancelSurfaceAction(nonce: string): void;
   onTextDelta(runId: string, delta: string): Promise<void>;
+  onSkillCandidate(runId: string, candidate: SkillCandidateMarker): void;
 }
 //#endregion
 //#region src/i18n.d.ts
@@ -869,6 +895,7 @@ declare const chatbotDictionary: {
     'session.title': string;
     'session.new': string;
     'session.searchPlaceholder': string;
+    'session.searchClear': string;
     'session.empty': string;
     'session.missingRoot': string;
     'session.skipped': string;
@@ -909,6 +936,13 @@ declare const chatbotDictionary: {
     'message.delete': string;
     'message.viewTrace': string;
     'message.skillsUsed': string;
+    'message.edit': string;
+    'message.editSend': string;
+    'message.editCancel': string;
+    'capability.tools.on': string;
+    'capability.tools.off': string;
+    'capability.images.on': string;
+    'capability.images.off': string;
     'tool.summary.one': string;
     'tool.summary.other': string;
     'tool.status.running': string;
@@ -927,6 +961,13 @@ declare const chatbotDictionary: {
     'cot.reasoning': string;
     'cot.working': string;
     'trace.title': string;
+    'trace.runId': string;
+    'trace.runId.copy': string;
+    'trace.runId.copied': string;
+    'candidate.submitted': string;
+    'candidate.id.copy': string;
+    'candidate.id.copied': string;
+    'candidate.review': string;
     'trace.skill': string;
     'perception.reading': string;
     'perception.excluded': string;
@@ -939,6 +980,14 @@ declare const chatbotDictionary: {
     'trace.phase.interact': string;
     'trace.phase.complete': string;
     'trace.phase.fail': string;
+    'run.terminated.userCancelled': string;
+    'run.terminated.maxTurns': string;
+    'run.terminated.timeout': string;
+    'run.terminated.llmError': string;
+    'run.terminated.interactionTimeout': string;
+    'run.terminated.hookError': string;
+    'run.terminated.toolResolutionExhausted': string;
+    'run.terminated.unknown': string;
     'todo.title': string;
     'todo.progress': string;
     'todo.status.pending': string;
@@ -957,6 +1006,12 @@ declare const chatbotDictionary: {
     'interaction.authorize.description': string;
     'interaction.authorize.capability': string;
     'interaction.authorize.details': string;
+    'interaction.pageAction.click': string;
+    'interaction.pageAction.fill': string;
+    'interaction.pageAction.submit': string;
+    'interaction.pageAction.role.click': string;
+    'interaction.pageAction.role.fill': string;
+    'interaction.pageAction.role.submit': string;
     'interaction.origin': string;
     'interaction.submitted': string;
     'interaction.submit': string;
@@ -996,7 +1051,6 @@ declare const chatbotDictionary: {
     'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.demo': string;
-    'composer.plainChatOnly': string;
     'composer.menu': string;
     'composer.pageCapture': string;
     'composer.pageCapture.disabled.setting': string;
@@ -1070,10 +1124,18 @@ declare const chatbotDictionary: {
     'settings.agent.todoNote': string;
     'settings.agent.generativeUi': string;
     'settings.agent.generativeUiNote': string;
+    'settings.agent.generativeUiUnaffected': string;
     'settings.agent.skillGeneration': string;
     'settings.agent.skillGenerationNote': string;
     'settings.agent.delegation': string;
     'settings.agent.delegationNote': string;
+    'settings.agent.limits': string;
+    'settings.agent.limitsNote': string;
+    'settings.agent.totalTimeout': string;
+    'settings.agent.maxTurns': string;
+    'settings.agent.toolTimeout': string;
+    'settings.agent.limits.invalid': string;
+    'settings.agent.limits.reset': string;
     'settings.privacy.enabled': string;
     'settings.privacy.enabledRisk': string;
     'settings.privacy.encrypted': string;
@@ -1130,6 +1192,9 @@ declare const chatbotDictionary: {
     'error.suggestion.RUN_INTERACTION_TIMEOUT': string;
     'error.suggestion.RUN_MAX_TURNS_EXCEEDED': string;
     'error.suggestion.TOOL_RESOLUTION_EXHAUSTED': string;
+    'error.limit.totalTimeoutMs': string;
+    'error.limit.maxTurns': string;
+    'error.openSettings': string;
     'error.dismiss': string;
   };
   zh: {
@@ -1142,6 +1207,7 @@ declare const chatbotDictionary: {
     'session.title': string;
     'session.new': string;
     'session.searchPlaceholder': string;
+    'session.searchClear': string;
     'session.empty': string;
     'session.missingRoot': string;
     'session.skipped': string;
@@ -1178,10 +1244,17 @@ declare const chatbotDictionary: {
     'welcome.prompt.4': string;
     'message.copy': string;
     'message.copied': string;
+    'message.edit': string;
+    'message.editSend': string;
+    'message.editCancel': string;
     'message.retry': string;
     'message.delete': string;
     'message.viewTrace': string;
     'message.skillsUsed': string;
+    'capability.tools.on': string;
+    'capability.tools.off': string;
+    'capability.images.on': string;
+    'capability.images.off': string;
     'tool.summary.one': string;
     'tool.summary.other': string;
     'tool.status.running': string;
@@ -1200,6 +1273,13 @@ declare const chatbotDictionary: {
     'cot.reasoning': string;
     'cot.working': string;
     'trace.title': string;
+    'trace.runId': string;
+    'trace.runId.copy': string;
+    'trace.runId.copied': string;
+    'candidate.submitted': string;
+    'candidate.id.copy': string;
+    'candidate.id.copied': string;
+    'candidate.review': string;
     'trace.skill': string;
     'perception.reading': string;
     'perception.excluded': string;
@@ -1212,6 +1292,14 @@ declare const chatbotDictionary: {
     'trace.phase.interact': string;
     'trace.phase.complete': string;
     'trace.phase.fail': string;
+    'run.terminated.userCancelled': string;
+    'run.terminated.maxTurns': string;
+    'run.terminated.timeout': string;
+    'run.terminated.llmError': string;
+    'run.terminated.interactionTimeout': string;
+    'run.terminated.hookError': string;
+    'run.terminated.toolResolutionExhausted': string;
+    'run.terminated.unknown': string;
     'todo.title': string;
     'todo.progress': string;
     'todo.status.pending': string;
@@ -1230,6 +1318,12 @@ declare const chatbotDictionary: {
     'interaction.authorize.description': string;
     'interaction.authorize.capability': string;
     'interaction.authorize.details': string;
+    'interaction.pageAction.click': string;
+    'interaction.pageAction.fill': string;
+    'interaction.pageAction.submit': string;
+    'interaction.pageAction.role.click': string;
+    'interaction.pageAction.role.fill': string;
+    'interaction.pageAction.role.submit': string;
     'interaction.origin': string;
     'interaction.submitted': string;
     'interaction.submit': string;
@@ -1269,7 +1363,6 @@ declare const chatbotDictionary: {
     'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.demo': string;
-    'composer.plainChatOnly': string;
     'composer.menu': string;
     'composer.pageCapture': string;
     'composer.pageCapture.disabled.setting': string;
@@ -1343,10 +1436,18 @@ declare const chatbotDictionary: {
     'settings.agent.todoNote': string;
     'settings.agent.generativeUi': string;
     'settings.agent.generativeUiNote': string;
+    'settings.agent.generativeUiUnaffected': string;
     'settings.agent.skillGeneration': string;
     'settings.agent.skillGenerationNote': string;
     'settings.agent.delegation': string;
     'settings.agent.delegationNote': string;
+    'settings.agent.limits': string;
+    'settings.agent.limitsNote': string;
+    'settings.agent.totalTimeout': string;
+    'settings.agent.maxTurns': string;
+    'settings.agent.toolTimeout': string;
+    'settings.agent.limits.invalid': string;
+    'settings.agent.limits.reset': string;
     'settings.privacy.enabled': string;
     'settings.privacy.enabledRisk': string;
     'settings.privacy.encrypted': string;
@@ -1403,6 +1504,9 @@ declare const chatbotDictionary: {
     'error.suggestion.RUN_INTERACTION_TIMEOUT': string;
     'error.suggestion.RUN_MAX_TURNS_EXCEEDED': string;
     'error.suggestion.TOOL_RESOLUTION_EXHAUSTED': string;
+    'error.limit.totalTimeoutMs': string;
+    'error.limit.maxTurns': string;
+    'error.openSettings': string;
     'error.dismiss': string;
   };
 };
@@ -1418,6 +1522,7 @@ declare const useT: () => TranslateFn<{
     'session.title': string;
     'session.new': string;
     'session.searchPlaceholder': string;
+    'session.searchClear': string;
     'session.empty': string;
     'session.missingRoot': string;
     'session.skipped': string;
@@ -1458,6 +1563,13 @@ declare const useT: () => TranslateFn<{
     'message.delete': string;
     'message.viewTrace': string;
     'message.skillsUsed': string;
+    'message.edit': string;
+    'message.editSend': string;
+    'message.editCancel': string;
+    'capability.tools.on': string;
+    'capability.tools.off': string;
+    'capability.images.on': string;
+    'capability.images.off': string;
     'tool.summary.one': string;
     'tool.summary.other': string;
     'tool.status.running': string;
@@ -1476,6 +1588,13 @@ declare const useT: () => TranslateFn<{
     'cot.reasoning': string;
     'cot.working': string;
     'trace.title': string;
+    'trace.runId': string;
+    'trace.runId.copy': string;
+    'trace.runId.copied': string;
+    'candidate.submitted': string;
+    'candidate.id.copy': string;
+    'candidate.id.copied': string;
+    'candidate.review': string;
     'trace.skill': string;
     'perception.reading': string;
     'perception.excluded': string;
@@ -1488,6 +1607,14 @@ declare const useT: () => TranslateFn<{
     'trace.phase.interact': string;
     'trace.phase.complete': string;
     'trace.phase.fail': string;
+    'run.terminated.userCancelled': string;
+    'run.terminated.maxTurns': string;
+    'run.terminated.timeout': string;
+    'run.terminated.llmError': string;
+    'run.terminated.interactionTimeout': string;
+    'run.terminated.hookError': string;
+    'run.terminated.toolResolutionExhausted': string;
+    'run.terminated.unknown': string;
     'todo.title': string;
     'todo.progress': string;
     'todo.status.pending': string;
@@ -1506,6 +1633,12 @@ declare const useT: () => TranslateFn<{
     'interaction.authorize.description': string;
     'interaction.authorize.capability': string;
     'interaction.authorize.details': string;
+    'interaction.pageAction.click': string;
+    'interaction.pageAction.fill': string;
+    'interaction.pageAction.submit': string;
+    'interaction.pageAction.role.click': string;
+    'interaction.pageAction.role.fill': string;
+    'interaction.pageAction.role.submit': string;
     'interaction.origin': string;
     'interaction.submitted': string;
     'interaction.submit': string;
@@ -1545,7 +1678,6 @@ declare const useT: () => TranslateFn<{
     'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.demo': string;
-    'composer.plainChatOnly': string;
     'composer.menu': string;
     'composer.pageCapture': string;
     'composer.pageCapture.disabled.setting': string;
@@ -1619,10 +1751,18 @@ declare const useT: () => TranslateFn<{
     'settings.agent.todoNote': string;
     'settings.agent.generativeUi': string;
     'settings.agent.generativeUiNote': string;
+    'settings.agent.generativeUiUnaffected': string;
     'settings.agent.skillGeneration': string;
     'settings.agent.skillGenerationNote': string;
     'settings.agent.delegation': string;
     'settings.agent.delegationNote': string;
+    'settings.agent.limits': string;
+    'settings.agent.limitsNote': string;
+    'settings.agent.totalTimeout': string;
+    'settings.agent.maxTurns': string;
+    'settings.agent.toolTimeout': string;
+    'settings.agent.limits.invalid': string;
+    'settings.agent.limits.reset': string;
     'settings.privacy.enabled': string;
     'settings.privacy.enabledRisk': string;
     'settings.privacy.encrypted': string;
@@ -1679,6 +1819,9 @@ declare const useT: () => TranslateFn<{
     'error.suggestion.RUN_INTERACTION_TIMEOUT': string;
     'error.suggestion.RUN_MAX_TURNS_EXCEEDED': string;
     'error.suggestion.TOOL_RESOLUTION_EXHAUSTED': string;
+    'error.limit.totalTimeoutMs': string;
+    'error.limit.maxTurns': string;
+    'error.openSettings': string;
     'error.dismiss': string;
   };
   zh: {
@@ -1691,6 +1834,7 @@ declare const useT: () => TranslateFn<{
     'session.title': string;
     'session.new': string;
     'session.searchPlaceholder': string;
+    'session.searchClear': string;
     'session.empty': string;
     'session.missingRoot': string;
     'session.skipped': string;
@@ -1727,10 +1871,17 @@ declare const useT: () => TranslateFn<{
     'welcome.prompt.4': string;
     'message.copy': string;
     'message.copied': string;
+    'message.edit': string;
+    'message.editSend': string;
+    'message.editCancel': string;
     'message.retry': string;
     'message.delete': string;
     'message.viewTrace': string;
     'message.skillsUsed': string;
+    'capability.tools.on': string;
+    'capability.tools.off': string;
+    'capability.images.on': string;
+    'capability.images.off': string;
     'tool.summary.one': string;
     'tool.summary.other': string;
     'tool.status.running': string;
@@ -1749,6 +1900,13 @@ declare const useT: () => TranslateFn<{
     'cot.reasoning': string;
     'cot.working': string;
     'trace.title': string;
+    'trace.runId': string;
+    'trace.runId.copy': string;
+    'trace.runId.copied': string;
+    'candidate.submitted': string;
+    'candidate.id.copy': string;
+    'candidate.id.copied': string;
+    'candidate.review': string;
     'trace.skill': string;
     'perception.reading': string;
     'perception.excluded': string;
@@ -1761,6 +1919,14 @@ declare const useT: () => TranslateFn<{
     'trace.phase.interact': string;
     'trace.phase.complete': string;
     'trace.phase.fail': string;
+    'run.terminated.userCancelled': string;
+    'run.terminated.maxTurns': string;
+    'run.terminated.timeout': string;
+    'run.terminated.llmError': string;
+    'run.terminated.interactionTimeout': string;
+    'run.terminated.hookError': string;
+    'run.terminated.toolResolutionExhausted': string;
+    'run.terminated.unknown': string;
     'todo.title': string;
     'todo.progress': string;
     'todo.status.pending': string;
@@ -1779,6 +1945,12 @@ declare const useT: () => TranslateFn<{
     'interaction.authorize.description': string;
     'interaction.authorize.capability': string;
     'interaction.authorize.details': string;
+    'interaction.pageAction.click': string;
+    'interaction.pageAction.fill': string;
+    'interaction.pageAction.submit': string;
+    'interaction.pageAction.role.click': string;
+    'interaction.pageAction.role.fill': string;
+    'interaction.pageAction.role.submit': string;
     'interaction.origin': string;
     'interaction.submitted': string;
     'interaction.submit': string;
@@ -1818,7 +1990,6 @@ declare const useT: () => TranslateFn<{
     'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.demo': string;
-    'composer.plainChatOnly': string;
     'composer.menu': string;
     'composer.pageCapture': string;
     'composer.pageCapture.disabled.setting': string;
@@ -1892,10 +2063,18 @@ declare const useT: () => TranslateFn<{
     'settings.agent.todoNote': string;
     'settings.agent.generativeUi': string;
     'settings.agent.generativeUiNote': string;
+    'settings.agent.generativeUiUnaffected': string;
     'settings.agent.skillGeneration': string;
     'settings.agent.skillGenerationNote': string;
     'settings.agent.delegation': string;
     'settings.agent.delegationNote': string;
+    'settings.agent.limits': string;
+    'settings.agent.limitsNote': string;
+    'settings.agent.totalTimeout': string;
+    'settings.agent.maxTurns': string;
+    'settings.agent.toolTimeout': string;
+    'settings.agent.limits.invalid': string;
+    'settings.agent.limits.reset': string;
     'settings.privacy.enabled': string;
     'settings.privacy.enabledRisk': string;
     'settings.privacy.encrypted': string;
@@ -1952,6 +2131,9 @@ declare const useT: () => TranslateFn<{
     'error.suggestion.RUN_INTERACTION_TIMEOUT': string;
     'error.suggestion.RUN_MAX_TURNS_EXCEEDED': string;
     'error.suggestion.TOOL_RESOLUTION_EXHAUSTED': string;
+    'error.limit.totalTimeoutMs': string;
+    'error.limit.maxTurns': string;
+    'error.openSettings': string;
     'error.dismiss': string;
   };
 }>;
@@ -2145,7 +2327,9 @@ interface ResultBlockListProps {
 declare function ResultBlockList({ blocks, runId, onDownload }: ResultBlockListProps): import("react").JSX.Element;
 /**
  * run 完成结果块渐进挂载（AnimatePresence 逐块入场）：
- * markdown / json / table / chart / image / file + artifact 下载卡。
+ * markdown / json / table / chart / image / file。
+ * 产物只由 blocks 中的 file block 承载——历史消息也只持久化 blocks，
+ * 走同一路渲染，刷新前后的卡片计数才一致。
  * @stable
  */
 declare function ResultBlocksPro({ bridge, activeRunId, onDownload }: ResultBlocksProProps): import("react").JSX.Element | null;
@@ -2193,6 +2377,12 @@ interface SettingsDrawerProps {
    * @experimental
    */
   userProfileApi?: UserProfileApi;
+  /**
+   * 打开时定位到哪个分区（缺省 `'general'`）。触顶报错的「打开设置」按此直达 Agent 区，
+   * 让用户少找一步（FR-21.2）。传了不存在的 id 则回落到 `'general'`。
+   * @experimental
+   */
+  initialSectionId?: string;
   onClose(): void;
 }
 /** 设置面板对画像数据的最小依赖面；实现由 Chatbot 用 ChatEngine 装配 @experimental */
@@ -2216,7 +2406,7 @@ interface UserProfileImportDiff {
   origin: string;
 }
 /** 设置抽屉：模型列表（增删改 / 设默认 / 逐条探测）+ 流式与 temperature + Agent 能力 + 语音语言 @stable */
-declare function SettingsDrawer({ open, runtimeConfig, dictationLang, selectedModelId, onAppearanceChange, onSaved, userProfileApi: profileApi, onClose }: SettingsDrawerProps): import("react").JSX.Element;
+declare function SettingsDrawer({ open, runtimeConfig, dictationLang, selectedModelId, onAppearanceChange, onSaved, userProfileApi: profileApi, initialSectionId, onClose }: SettingsDrawerProps): import("react").JSX.Element;
 //#endregion
 //#region src/react/ErrorCard.d.ts
 /** @stable */
@@ -2224,9 +2414,20 @@ interface ErrorCardProps {
   /** 稳定错误码（WebSkillError.code / RUN_FAILED；缺省不渲染徽章） */
   code?: string;
   message: string;
+  /**
+   * 触顶类错误的生效上限值：`totalTimeoutMs` 为毫秒、`maxTurns` 为轮数。
+   * 给了才渲染「哪个上限 / 当前值 / 去哪改」，否则退回英文 message（FR-21.2）。
+   * @experimental
+   */
+  loopLimits?: {
+    totalTimeoutMs: number;
+    maxTurns: number;
+  };
+  /** 提供时，触顶类错误下多一个直达设置的按钮 @experimental */
+  onOpenSettings?(): void;
   onDismiss?(): void;
 }
 /** 结构化错误卡：错误码徽章 + 描述 + 建议（engine error 事件 / 失败 run） @stable */
-declare function ErrorCard({ code, message, onDismiss }: ErrorCardProps): import("react").JSX.Element;
+declare function ErrorCard({ code, message, loopLimits, onOpenSettings, onDismiss }: ErrorCardProps): import("react").JSX.Element;
 //#endregion
 export { A2uiSurfaceHost, type A2uiSurfaceHostProps, A2uiSurfaceSnapshotHost, type A2uiSurfaceSnapshotHostProps, type AppearanceChange, type ChatAttachmentInput, type ChatAttachmentMeta, ChatEngine, type ChatEngineOptions, type ChatEvent, type ChatInteractionRecord, type ChatLayout, type ChatMessage, type ChatRunPhase, type ChatSessionListResult, type ChatSessionMeta, type ChatTheme, type ChatToolCall, Chatbot, type ChatbotConfig, type ChatbotGovernancePorts, type ChatbotHostAdapter, type ChatbotProps, CompositeUiBridge, type CompositeUiBridgeDeps, DEFAULT_RENDERER_CAPABILITIES, DEFAULT_RUNTIME_CONFIG_STORAGE_KEY, type DownloadableFile, ErrorCard, type ErrorCardProps, InteractionCard, type InteractionCardProps, InterruptedBanner, type InterruptedBannerProps, type Locale, OpenUiSurfaceHost, type OpenUiSurfaceHostProps, OpenUiSurfaceSnapshotHost, type OpenUiSurfaceSnapshotHostProps, type RendererCapability, type RendererKind, type ResolvedChatLayout, ResultBlockList, type ResultBlockListProps, ResultBlocksPro, type ResultBlocksProProps, type RunSnapshot, type RuntimeAppearanceConfig, type RuntimeConfig, type RuntimeConfigStore, type RuntimeRendererId, type SandboxExecutorDeps, SettingsDrawer, type SettingsDrawerProps, SkillBadges, SpecInteraction, type SpecInteractionProps, type UserProfileApi, type UserProfileImportDiff, VercelPayloadPreview, type VercelPayloadPreviewProps, VercelSurfaceHost, type VercelSurfaceHostProps, VercelSurfaceSnapshotHost, type VercelSurfaceSnapshotHostProps, chatbotDictionary, configureA2uiMarkdown, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, probeA2uiAvailability, probeOpenUiAvailability, useT };