@webskill/chatbot 0.3.0 → 0.5.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, RuntimeRun, ScriptExecutor, SessionStore, SkillCandidateMarker, SkillCatalogEntry, SkillIntegrityGuard, SkillOutcomeReporter, SkillStateGuard, UiBridge, UiSpecDrafts, UiSpecEvent, UiSpecSnapshot, UiSurfaceActionRequest, UiSurfaceActionResponse, UserProfile, 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
@@ -290,6 +290,18 @@ interface ChatbotGovernancePorts {
   skillOutcomeReporter?: SkillOutcomeReporter;
   /** `SkillStatePolicy.catalogFilter()`：非 active 技能不进路由候选集 */
   catalogFilter?: (entries: SkillCatalogEntry[]) => SkillCatalogEntry[] | Promise<SkillCatalogEntry[]>;
+  /**
+   * run 未激活任何技能时的钩子（如 `createMissHook`）。
+   *
+   * 开关存在 `GovernanceFacade.missHook`（属 console），chatbot 读不到也不该依赖它；
+   * 所以读开关是**宿主**的责任。宿主应传一个**每次触发时才读开关**的闭包，
+   * 而不是装配时把布尔值算好——`#assemble()` 不是每次 run 都跑，
+   * 算好了会导致「开着启动 → 中途关闭」不生效（AC-17.11）。
+   */
+  onSkillMiss?: (input: {
+    prompt: string;
+    run: RuntimeRun;
+  }) => Promise<void>;
 }
 /** 分配式交叉：直接写 `信封 & LifecycleEventInit` 会把联合压成一个对象，`phase` 的判别性就没了 */
 type WithChatMeta<T> = T extends unknown ? {
@@ -365,7 +377,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 +429,12 @@ interface ChatMessage {
    * @experimental
    */
   interactions?: ChatInteractionRecord[];
+  /**
+   * 该轮提交的技能候选（FR-24.1）。数据来自 `$skillCandidate` 载荷，
+   * 不从模型复述的自然语言里解析。
+   * @experimental
+   */
+  candidates?: SkillCandidateMarker[];
 }
 /** @stable */
 interface ChatSessionMeta {
@@ -579,6 +601,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 +613,13 @@ interface ChatbotHostAdapter {
    * @experimental
    */
   pagePerception?: PagePerceptionPolicy;
+  /**
+   * 页面操作能力（需求 23）。**不注入即完全关闭**，与 `pagePerception` 分开：
+   * 可读不等于可操作。同样只能在这里注入——给终端用户一个「打开代操作」的开关
+   * 等于把安全边界交给最不了解它的人。
+   * @experimental
+   */
+  pageActions?: PageActionPolicy;
 }
 //#endregion
 //#region src/core/chatEngine.d.ts
@@ -603,6 +634,20 @@ interface SandboxExecutorDeps {
   /** 缺省时 `.ts` 脚本按 `TOOL_UNSUPPORTED` 拒绝 */
   typescript?: TypeScriptSupportOptions;
 }
+/**
+ * 装配时（而非执行时）把 `sandbox.typescript` 转成执行器参数，让配置错误早暴露。
+ * 只对绝对 URL 走 `RemoteUrlPolicy`：同源相对路径与打包器 specifier 不是出站请求。
+ */
+/**
+ * 由 `RuntimeConfig` 装出沙箱执行器依赖。
+ *
+ * 主链路与**评估链路**共用这一处（T-17-H）：此前评估侧只传 `fs`，
+ * 于是评估里跑的技能不受沙箱、网络策略、能力与授权范围约束——
+ * 那比「.ts 跑不了」严重得多（设计 17 §1.1a）。
+ *
+ * @experimental
+ */
+declare function sandboxExecutorDeps(fs: FileSystemProvider, rc?: RuntimeConfig, uiBridge?: SandboxExecutorDeps['uiBridge']): SandboxExecutorDeps;
 /** @stable */
 interface ChatEngineOptions {
   llm?: LlmClient;
@@ -824,6 +869,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 +900,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 +921,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;
@@ -907,8 +960,17 @@ declare const chatbotDictionary: {
     'message.copied': string;
     'message.retry': string;
     'message.delete': string;
+    'message.deleted.title': string;
+    'message.deleted.description': 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 +989,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 +1008,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 +1034,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;
@@ -965,6 +1048,10 @@ declare const chatbotDictionary: {
     'interaction.allow': string;
     'interaction.deny': string;
     'interaction.required': string;
+    'surface.addItem': string;
+    'surface.removeItem': string;
+    'surface.arrayFirstItemOnly': string;
+    'surface.readOnlySnapshot': string;
     'interaction.wait': string;
     'interaction.wait.inPanel': string;
     'interaction.wait.fallback': string;
@@ -996,8 +1083,7 @@ declare const chatbotDictionary: {
     'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.demo': string;
-    'composer.plainChatOnly': string;
-    'composer.menu': string;
+    'capability.group': string;
     'composer.pageCapture': string;
     'composer.pageCapture.disabled.setting': string;
     'composer.pageCapture.disabled.model': string;
@@ -1070,10 +1156,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;
@@ -1122,6 +1216,7 @@ declare const chatbotDictionary: {
     'vercel.preview.badge': string;
     'vercel.preview.description': string;
     'surface.legacy.placeholder': string;
+    'a11y.messageActions': string;
     'error.title': string;
     'error.suggestion': string;
     'error.suggestion.LLM_UNAVAILABLE': string;
@@ -1130,6 +1225,10 @@ 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.message.RUN_CANCELLED': string;
+    'error.openSettings': string;
     'error.dismiss': string;
   };
   zh: {
@@ -1142,6 +1241,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 +1278,19 @@ 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.deleted.title': string;
+    'message.deleted.description': 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 +1309,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 +1328,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 +1354,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;
@@ -1238,6 +1368,10 @@ declare const chatbotDictionary: {
     'interaction.allow': string;
     'interaction.deny': string;
     'interaction.required': string;
+    'surface.addItem': string;
+    'surface.removeItem': string;
+    'surface.arrayFirstItemOnly': string;
+    'surface.readOnlySnapshot': string;
     'interaction.wait': string;
     'interaction.wait.inPanel': string;
     'interaction.wait.fallback': string;
@@ -1269,8 +1403,7 @@ declare const chatbotDictionary: {
     'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.demo': string;
-    'composer.plainChatOnly': string;
-    'composer.menu': string;
+    'capability.group': string;
     'composer.pageCapture': string;
     'composer.pageCapture.disabled.setting': string;
     'composer.pageCapture.disabled.model': string;
@@ -1343,10 +1476,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;
@@ -1395,6 +1536,7 @@ declare const chatbotDictionary: {
     'vercel.preview.badge': string;
     'vercel.preview.description': string;
     'surface.legacy.placeholder': string;
+    'a11y.messageActions': string;
     'error.title': string;
     'error.suggestion': string;
     'error.suggestion.LLM_UNAVAILABLE': string;
@@ -1403,6 +1545,10 @@ 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.message.RUN_CANCELLED': string;
+    'error.openSettings': string;
     'error.dismiss': string;
   };
 };
@@ -1418,6 +1564,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;
@@ -1456,8 +1603,17 @@ declare const useT: () => TranslateFn<{
     'message.copied': string;
     'message.retry': string;
     'message.delete': string;
+    'message.deleted.title': string;
+    'message.deleted.description': 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 +1632,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 +1651,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 +1677,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;
@@ -1514,6 +1691,10 @@ declare const useT: () => TranslateFn<{
     'interaction.allow': string;
     'interaction.deny': string;
     'interaction.required': string;
+    'surface.addItem': string;
+    'surface.removeItem': string;
+    'surface.arrayFirstItemOnly': string;
+    'surface.readOnlySnapshot': string;
     'interaction.wait': string;
     'interaction.wait.inPanel': string;
     'interaction.wait.fallback': string;
@@ -1545,8 +1726,7 @@ declare const useT: () => TranslateFn<{
     'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.demo': string;
-    'composer.plainChatOnly': string;
-    'composer.menu': string;
+    'capability.group': string;
     'composer.pageCapture': string;
     'composer.pageCapture.disabled.setting': string;
     'composer.pageCapture.disabled.model': string;
@@ -1619,10 +1799,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;
@@ -1671,6 +1859,7 @@ declare const useT: () => TranslateFn<{
     'vercel.preview.badge': string;
     'vercel.preview.description': string;
     'surface.legacy.placeholder': string;
+    'a11y.messageActions': string;
     'error.title': string;
     'error.suggestion': string;
     'error.suggestion.LLM_UNAVAILABLE': string;
@@ -1679,6 +1868,10 @@ 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.message.RUN_CANCELLED': string;
+    'error.openSettings': string;
     'error.dismiss': string;
   };
   zh: {
@@ -1691,6 +1884,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 +1921,19 @@ 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.deleted.title': string;
+    'message.deleted.description': 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 +1952,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 +1971,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 +1997,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;
@@ -1787,6 +2011,10 @@ declare const useT: () => TranslateFn<{
     'interaction.allow': string;
     'interaction.deny': string;
     'interaction.required': string;
+    'surface.addItem': string;
+    'surface.removeItem': string;
+    'surface.arrayFirstItemOnly': string;
+    'surface.readOnlySnapshot': string;
     'interaction.wait': string;
     'interaction.wait.inPanel': string;
     'interaction.wait.fallback': string;
@@ -1818,8 +2046,7 @@ declare const useT: () => TranslateFn<{
     'composer.attachment.compressed': string;
     'composer.model': string;
     'composer.model.demo': string;
-    'composer.plainChatOnly': string;
-    'composer.menu': string;
+    'capability.group': string;
     'composer.pageCapture': string;
     'composer.pageCapture.disabled.setting': string;
     'composer.pageCapture.disabled.model': string;
@@ -1892,10 +2119,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;
@@ -1944,6 +2179,7 @@ declare const useT: () => TranslateFn<{
     'vercel.preview.badge': string;
     'vercel.preview.description': string;
     'surface.legacy.placeholder': string;
+    'a11y.messageActions': string;
     'error.title': string;
     'error.suggestion': string;
     'error.suggestion.LLM_UNAVAILABLE': string;
@@ -1952,6 +2188,10 @@ 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.message.RUN_CANCELLED': string;
+    'error.openSettings': string;
     'error.dismiss': string;
   };
 }>;
@@ -1972,6 +2212,20 @@ interface AppearanceChange {
   dictationLang?: string;
 }
 //#endregion
+//#region src/react/settingsSection.d.ts
+/**
+ * chatbot 里各处「打开设置」出口指向的分区（FR-20.3）。
+ *
+ * 取值就是 console 的路由 leaf id，因此不需要维护第二套映射表；
+ * 但这**不构成对 `@webskill/console` 的依赖**——它只是一组字符串字面量。
+ * 宿主不用 console 时，这些字符串就是它自定义路由的键名，语义自定。
+ *
+ * 只覆盖**配置类** leaf：`skills.editor`、`governance.review` 这些与配置无关的页
+ * 不在其中（AC-20.7 按「无未覆盖的配置类 leaf」执行，见偏差 D-15）。
+ * @experimental
+ */
+type SettingsSectionId = 'settings.runtime' | 'settings.sandbox' | 'settings.genui' | 'settings.trust' | 'settings.privacy' | 'settings.appearance' | 'connections.models' | 'connections.page' | 'connections.mcp';
+//#endregion
 //#region src/react/useChatLayout.d.ts
 /** 宿主可指定的布局档；auto 按容器尺寸判定 @stable */
 type ChatLayout = 'auto' | 'fullscreen' | 'embedded';
@@ -1999,6 +2253,11 @@ interface ChatbotProps {
   /** 布局档（默认 'auto'：按容器尺寸在 fullscreen / embedded / mobile 之间判定） */
   layout?: ChatLayout;
   onAppearanceChange?(next: AppearanceChange): void;
+  /**
+   * 打开配置面（FR-20.4）。配置面本身已迁到 console，chatbot 只负责发出这个请求；
+   * 宿主不接就不渲染任何「打开设置」出口——给一个点了没反应的按钮更糟。
+   */
+  onOpenSettings?(section: SettingsSectionId): void;
   /**
    * 装配完成后把引擎交给宿主，用于接线跨界面动作（例如 console 的快照恢复入口
    * 需要调 `engine.resume(runId)`）。每次重新装配都会再调一次。
@@ -2010,7 +2269,7 @@ interface ChatbotProps {
  * presentation shell and accessible thread primitives.
  * @stable
  */
-declare function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, renderer: rendererProp, dictationLang: dictationLangProp, surfaceRegistry, layout, onAppearanceChange, onEngineReady }: ChatbotProps): import("react").JSX.Element;
+declare function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, renderer: rendererProp, dictationLang: dictationLangProp, surfaceRegistry, layout, onAppearanceChange, onOpenSettings, onEngineReady }: ChatbotProps): import("react").JSX.Element;
 //#endregion
 //#region src/react/A2uiSurfaceHost.d.ts
 /** @experimental */
@@ -2145,7 +2404,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;
@@ -2164,69 +2425,26 @@ interface InterruptedBannerProps {
  */
 declare function InterruptedBanner({ engine, sessionId }: InterruptedBannerProps): import("react").JSX.Element | null;
 //#endregion
-//#region src/react/SettingsDrawer.d.ts
-/** @stable */
-interface SettingsDrawerProps {
-  open: boolean;
-  /**
-   * 运行环境配置存储：模型列表、流式、temperature、Agent 能力全部读写这里。
-   * 缺省时模型区只读展示（宿主没接配置源，谈不上持久化）。
-   */
-  runtimeConfig?: RuntimeConfigStore;
-  /**
-   * 语音识别语言（BCP-47）；空串即跟随界面语言（FR-7.7）。
-   * @experimental
-   */
-  dictationLang?: string;
-  /** 语音语言切换时回调（写回同一份外观配置） */
-  onAppearanceChange?(next: AppearanceChange): void;
-  /**
-   * 当前选中的模型条目 id（FR-14.4）：它不支持工具时，Agent 能力开关置灰。
-   * @experimental
-   */
-  selectedModelId?: string;
-  /** 保存/清除成功后回调（Chatbot 借此触发 engine.reloadConfig） */
-  onSaved(): void;
-  /**
-   * 用户画像的读写入口（需求 19）。不注入即整段画像 UI 不渲染（R11）——
-   * 没有数据源时展示一个空列表比不展示更容易让人以为「记录丢了」。
-   * @experimental
-   */
-  userProfileApi?: UserProfileApi;
-  onClose(): void;
-}
-/** 设置面板对画像数据的最小依赖面；实现由 Chatbot 用 ChatEngine 装配 @experimental */
-interface UserProfileApi {
-  read(): Promise<UserProfile>;
-  refine(): Promise<UserProfile>;
-  deleteEntry(id: string): Promise<UserProfile>;
-  clearRecords(): Promise<void>;
-  clearProfile(): Promise<void>;
-  /** 记录与画像一并清除（关闭总开关时的追问） */
-  clearAll(): Promise<void>;
-  /** `excludeIds` 来自导出前的逐条审阅 */
-  export(excludeIds: readonly string[]): Promise<UserProfileExport>;
-  diffImport(incoming: UserProfileExport): Promise<UserProfileImportDiff>;
-  applyImport(incoming: UserProfileExport): Promise<UserProfile>;
-}
-/** @experimental */
-interface UserProfileImportDiff {
-  added: readonly UserProfileEntry[];
-  updated: readonly UserProfileEntry[];
-  origin: string;
-}
-/** 设置抽屉：模型列表（增删改 / 设默认 / 逐条探测）+ 流式与 temperature + Agent 能力 + 语音语言 @stable */
-declare function SettingsDrawer({ open, runtimeConfig, dictationLang, selectedModelId, onAppearanceChange, onSaved, userProfileApi: profileApi, onClose }: SettingsDrawerProps): import("react").JSX.Element;
-//#endregion
 //#region src/react/ErrorCard.d.ts
 /** @stable */
 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 };
+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, type SettingsSectionId, SkillBadges, SpecInteraction, type SpecInteractionProps, VercelPayloadPreview, type VercelPayloadPreviewProps, VercelSurfaceHost, type VercelSurfaceHostProps, VercelSurfaceSnapshotHost, type VercelSurfaceSnapshotHostProps, chatbotDictionary, configureA2uiMarkdown, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, probeA2uiAvailability, probeOpenUiAvailability, sandboxExecutorDeps, useT };