@webskill/chatbot 0.12.0 → 0.13.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { AgentLoopConfig, ApprovalScope, BridgeCapabilities, DataSourceInfo, DocumentSurfaceHost, DocxTextExtractor, ExternalSkillProvider, ExternalToolSource, FileSystemProvider, HookRunner, InteractionRequest, InteractionResponse, LifecycleEventInit, LinkedDocumentReader, LlmClient, NetworkPolicy, Page, PageQuery, PdfTextExtractor, RenderBlock, RenderResultRequest, RunSnapshot, RunSnapshotListEntry, RuntimePhase, RuntimeRun, ScriptExecutor, SessionStore, SkillCandidateMarker, SkillCatalogEntry, SkillIntegrityGuard, SkillOutcomeReporter, SkillStateGuard, UiBridge, UiSpecDrafts, UiSpecEvent, UiSpecSnapshot, UiSurfaceActionRequest, UiSurfaceActionResponse, UserProfile, UserProfileExport, WebSkillErrorCode, XlsxTextExtractor, diffUserProfile } from "@webskill/sdk";
 import { SandboxMode, TypeScriptSupportOptions } from "@webskill/sdk/browser";
 import { CustomSurfaceActionEvent, ReactBridgeState, SpecInteractionChannel, SurfaceRegistry, UiSurfaceActionEvent } from "@webskill/sdk/ui-react";
-import { DownloadedFileConsent, DownloadedFileReader, PageActionPolicy, PagePerceptionPolicy, PerceptionPagingBudget, PerceptionRecord, SkillCandidateSink, TodoItem } from "@webskill/sdk/agent";
+import { DownloadedFileConsent, DownloadedFileReader, PageActionPolicy, PagePerceptionPolicy, PerceptionPagingBudget, PerceptionRecord, SkillCandidateSink, TabWorksetPolicy, TodoItem } from "@webskill/sdk/agent";
 import "react";
 import "react/jsx-runtime";
 //#region ../ui-kit/src/i18n/types.d.ts
@@ -506,6 +506,15 @@ interface ChatbotHostAdapter {
    * @experimental
    */
   pageActions?: PageActionPolicy;
+  /**
+   * 模型侧标签页控制（0.16.0 分册 12）。**不注入即三个工具不存在**。
+   *
+   * 与 `pageActions` 分开给，是因为它们的实现依赖不同：前者只需一条页面通道，
+   * 后者需要宿主真的能枚举与关闭标签页。但它们的**开关**是同一个：
+   * 策略自己以 `pageActions.enabled` 为前提，不能操作页面的会话里切页没有意义。
+   * @experimental
+   */
+  pageTabs?: TabWorksetPolicy;
   /**
    * 读页面链接指向的文档（分册 22）。实现住在 `@webskill/browser`，
    * 而 chatbot 不依赖它 —— 与 `pagePerception` 同一条装配规矩：宿主注入。
@@ -1483,15 +1492,19 @@ declare const chatbotDictionary: {
     'interaction.pageAction.select': string;
     'interaction.pageAction.set': string;
     'interaction.pageAction.attach': string;
+    'interaction.pageAction.back': string;
     'interaction.pageAction.role.click': string;
     'interaction.pageAction.role.fill': string;
     'interaction.pageAction.role.submit': string;
     'interaction.pageAction.role.select': string;
     'interaction.pageAction.role.set': string;
     'interaction.pageAction.role.attach': string;
+    'interaction.pageAction.role.back': string;
     'interaction.pageAction.remember': string;
     'interaction.pageAction.frame': string;
     'interaction.pageAction.elevated': string;
+    'interaction.downloadedFile.list': string;
+    'interaction.downloadedFile.read': string;
     'interaction.downloadedFile.file': string;
     'interaction.downloadedFile.remember': string;
     'interaction.traceEvidence.title': string;
@@ -1845,15 +1858,19 @@ declare const chatbotDictionary: {
     'interaction.pageAction.select': string;
     'interaction.pageAction.set': string;
     'interaction.pageAction.attach': string;
+    'interaction.pageAction.back': string;
     'interaction.pageAction.role.click': string;
     'interaction.pageAction.role.fill': string;
     'interaction.pageAction.role.submit': string;
     'interaction.pageAction.role.select': string;
     'interaction.pageAction.role.set': string;
     'interaction.pageAction.role.attach': string;
+    'interaction.pageAction.role.back': string;
     'interaction.pageAction.remember': string;
     'interaction.pageAction.frame': string;
     'interaction.pageAction.elevated': string;
+    'interaction.downloadedFile.list': string;
+    'interaction.downloadedFile.read': string;
     'interaction.downloadedFile.file': string;
     'interaction.downloadedFile.remember': string;
     'interaction.traceEvidence.title': string;
@@ -2210,15 +2227,19 @@ declare const useT: () => TranslateFn<{
     'interaction.pageAction.select': string;
     'interaction.pageAction.set': string;
     'interaction.pageAction.attach': string;
+    'interaction.pageAction.back': string;
     'interaction.pageAction.role.click': string;
     'interaction.pageAction.role.fill': string;
     'interaction.pageAction.role.submit': string;
     'interaction.pageAction.role.select': string;
     'interaction.pageAction.role.set': string;
     'interaction.pageAction.role.attach': string;
+    'interaction.pageAction.role.back': string;
     'interaction.pageAction.remember': string;
     'interaction.pageAction.frame': string;
     'interaction.pageAction.elevated': string;
+    'interaction.downloadedFile.list': string;
+    'interaction.downloadedFile.read': string;
     'interaction.downloadedFile.file': string;
     'interaction.downloadedFile.remember': string;
     'interaction.traceEvidence.title': string;
@@ -2572,15 +2593,19 @@ declare const useT: () => TranslateFn<{
     'interaction.pageAction.select': string;
     'interaction.pageAction.set': string;
     'interaction.pageAction.attach': string;
+    'interaction.pageAction.back': string;
     'interaction.pageAction.role.click': string;
     'interaction.pageAction.role.fill': string;
     'interaction.pageAction.role.submit': string;
     'interaction.pageAction.role.select': string;
     'interaction.pageAction.role.set': string;
     'interaction.pageAction.role.attach': string;
+    'interaction.pageAction.role.back': string;
     'interaction.pageAction.remember': string;
     'interaction.pageAction.frame': string;
     'interaction.pageAction.elevated': string;
+    'interaction.downloadedFile.list': string;
+    'interaction.downloadedFile.read': string;
     'interaction.downloadedFile.file': string;
     'interaction.downloadedFile.remember': string;
     'interaction.traceEvidence.title': string;
@@ -3071,6 +3096,6 @@ declare function ErrorCard({ code, message, loopLimits, onOpenSettings, onDismis
  * Version of the published `@webskill/chatbot` package, injected at build time.
  * @stable
  */
-declare const CHATBOT_VERSION = "0.12.0";
+declare const CHATBOT_VERSION = "0.13.0";
 //#endregion
 export { A2uiSurfaceHost, type A2uiSurfaceHostProps, A2uiSurfaceSnapshotHost, type A2uiSurfaceSnapshotHostProps, type AppearanceChange, CHATBOT_VERSION, type ChatAttachmentInput, type ChatAttachmentMeta, type ChatContentPart, ChatEngine, type ChatEngineOptions, type ChatEvent, type ChatInteractionRecord, type ChatLayout, type ChatMessage, type ChatRunPhase, type ChatSessionListResult, type ChatSessionMeta, type ChatTheme, type ChatThinking, type ChatTokenUsage, 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, type LocalizedText, OpenUiSurfaceHost, type OpenUiSurfaceHostProps, OpenUiSurfaceSnapshotHost, type OpenUiSurfaceSnapshotHostProps, type QuickPrompt, type QuickPromptIconName, type RendererCapability, type RendererKind, type ResolvedChatLayout, ResultBlockList, type ResultBlockListProps, ResultBlocksPro, type ResultBlocksProProps, type RunSnapshot, type RuntimeAppearanceConfig, type RuntimeConfig, type RuntimeConfigStore, type RuntimeQuickPrompt, type RuntimeRendererId, type SandboxExecutorDeps, type SettingsSectionId, SkillBadges, SpecInteraction, type SpecInteractionProps, VercelPayloadPreview, type VercelPayloadPreviewProps, VercelSurfaceHost, type VercelSurfaceHostProps, VercelSurfaceSnapshotHost, type VercelSurfaceSnapshotHostProps, chatbotDictionary, configureA2uiMarkdown, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, isLlmEntryUsable, pickUsableLlmEntry, probeA2uiAvailability, probeOpenUiAvailability, sandboxExecutorDeps, useT };

package/dist/index.js

@@ -10,7 +10,7 @@ import { BEHAVIOR_RECORDS_KEY, DEFAULT_LOOP_LIMITS, DEFAULT_USER_PROFILE_LIMITS,
 import { BrowserWorkerScriptExecutor, checkDictationAvailability, compressImageToBudget, createEncryptedMemoryStore, createLlmClient, deleteMemoryEncryptionKey, openMemoryEncryptionKey, probeChromeBuiltinAvailability, startDictation } from "@webskill/sdk/browser";
 import { JsonRenderSpecSurface, NativeSpecSurface, OpenUiSpecSurface, ReactBridgeState, SpecInteractionChannel, SurfaceFormTextsProvider, UiSurfaceSnapshotList, probeJsonRenderAvailability } from "@webskill/sdk/ui-react";
 import { A2UI_SPEC_FORM_PATH, collectFormScopes, createUiCatalogToolSource, fromA2uiSpecAction, fromA2uiSurfaceAction, interactionToFormModel, interactionToUiSpec, loadOpenUiPeers, loadWebSkillLitCatalog, renderMiniChart, shapeInteractionValue, toA2uiSpecMessages, toA2uiSurfaceAction, toVercelToolInvocation, uiCatalog } from "@webskill/sdk/ui";
-import { DownloadedFilePolicy, PAGE_ACTION_KINDS, TodoStore, createDelegationToolSource, createDownloadedFileToolSource, createPageActionToolSource, createPagePerceptionToolSource, createSkillGenerationToolSource, createTodoToolSource, withDelegationOrigin } from "@webskill/sdk/agent";
+import { DownloadedFilePolicy, PAGE_ACTION_KINDS, TodoStore, createDelegationToolSource, createDownloadedFileToolSource, createPageActionToolSource, createPagePerceptionToolSource, createSkillGenerationToolSource, createTabWorksetToolSource, createTodoToolSource, withDelegationOrigin } from "@webskill/sdk/agent";
 import * as React$1 from "react";
 import React, { Children, Component, Fragment, createContext, createElement, forwardRef, isValidElement, memo, useCallback, useContext, useDeferredValue, useEffect, useEffectEvent, useId, useInsertionEffect, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
@@ -31683,15 +31683,19 @@ const chatbotDictionary = defineDictionary({
 		"interaction.pageAction.select": "Allow the assistant to select an option in “{target}”?",
 		"interaction.pageAction.set": "Allow the assistant to toggle “{target}”?",
 		"interaction.pageAction.attach": "Allow the assistant to attach a file to “{target}”?",
+		"interaction.pageAction.back": "Allow the assistant to go back to the previous page on “{target}”?",
 		"interaction.pageAction.role.click": "this control",
 		"interaction.pageAction.role.fill": "this field",
 		"interaction.pageAction.role.submit": "this form",
 		"interaction.pageAction.role.select": "this list",
 		"interaction.pageAction.role.set": "this switch",
 		"interaction.pageAction.role.attach": "this upload field",
+		"interaction.pageAction.role.back": "this page",
 		"interaction.pageAction.remember": "Don’t ask again for this kind of action",
 		"interaction.pageAction.frame": "The target is in the embedded frame \"{frame}\".",
 		"interaction.pageAction.elevated": "This dialog is outside the usual allowlist; it was opened by this task.",
+		"interaction.downloadedFile.list": "Allow the assistant to see the list of files you recently downloaded?",
+		"interaction.downloadedFile.read": "Allow the assistant to read this file from your downloads?",
 		"interaction.downloadedFile.file": "{name} · {size}",
 		"interaction.downloadedFile.remember": "Don’t ask again for this kind of access",
 		"interaction.traceEvidence.title": "Steps this skill claims",
@@ -32045,15 +32049,19 @@ const chatbotDictionary = defineDictionary({
 		"interaction.pageAction.select": "允许助手在「{target}」中选择选项吗？",
 		"interaction.pageAction.set": "允许助手切换「{target}」吗？",
 		"interaction.pageAction.attach": "允许助手向「{target}」附加文件吗？",
+		"interaction.pageAction.back": "允许助手在「{target}」上返回上一页吗？",
 		"interaction.pageAction.role.click": "这个控件",
 		"interaction.pageAction.role.fill": "这个输入框",
 		"interaction.pageAction.role.submit": "这个表单",
 		"interaction.pageAction.role.select": "这个选择框",
 		"interaction.pageAction.role.set": "这个开关",
 		"interaction.pageAction.role.attach": "这个上传控件",
+		"interaction.pageAction.role.back": "这个页面",
 		"interaction.pageAction.remember": "以后不再询问此类操作",
 		"interaction.pageAction.frame": "目标位于嵌入帧「{frame}」中。",
 		"interaction.pageAction.elevated": "该对话框不在常规允许清单内，是本次任务打开的。",
+		"interaction.downloadedFile.list": "允许助手查看你最近下载的文件列表吗？",
+		"interaction.downloadedFile.read": "允许助手读取你下载目录里的这份文件吗？",
 		"interaction.downloadedFile.file": "{name} · {size}",
 		"interaction.downloadedFile.remember": "以后不再询问此类访问",
 		"interaction.traceEvidence.title": "该技能声称的步骤",
@@ -33102,9 +33110,21 @@ var ChatEngine = class {
 			await this.#finishRun(sessionId, result);
 		} catch (e) {
 			this.#emitError(e);
+		} finally {
+			this.#releaseTabWorkset();
 		}
 	}
 	/**
+	* run 结束就丢掉标签页工作集（0.16.0 FR-11.4 / FR-12.7）。
+	*
+	* 放在 `finally` 而不是 `#finishRun` 里：完成、失败、中断、取消四条路径必须清得一样干净，
+	* 而异常路径根本不经过 `#finishRun`——漏一条就是让上一轮的句柄活到下一轮，
+	* 那正是 SC-2 要堵的口子。它**不关闭任何标签页**：模型开出来的页归用户处置。
+	*/
+	#releaseTabWorkset() {
+		Promise.resolve(this.#adapter.pageTabs?.reset()).catch(() => void 0);
+	}
+	/**
 	* 本轮触发消息里的附件，包成只对这一次 run 生效的读取端口（0.15.0 分册 17）。
 	* 开关关着就返回 undefined → 脚本上下文里那两个成员整个不存在，
 	* 与「本轮没传附件」（空数组）分得开。
@@ -33233,6 +33253,8 @@ var ChatEngine = class {
 			await this.#finishRun(sessionId, result);
 		} catch (e) {
 			this.#emitError(e);
+		} finally {
+			this.#releaseTabWorkset();
 		}
 	}
 	async #persistSurfaceDraft(runId, surfaceId, value) {
@@ -33541,6 +33563,7 @@ var ChatEngine = class {
 				}
 			})] : [],
 			...this.#adapter.pageActions ? [createPageActionToolSource({ policy: this.#adapter.pageActions })] : [],
+			...this.#adapter.pageTabs ? [createTabWorksetToolSource({ policy: this.#adapter.pageTabs })] : [],
 			...this.#adapter.downloads ? [createDownloadedFileToolSource({ policy: new DownloadedFilePolicy({
 				reader: this.#adapter.downloads.reader,
 				ui: this.#uiBridge,
@@ -45860,6 +45883,14 @@ function InlineBlocks() {
 
 //#endregion
 //#region src/react/interactionLabels.ts
+/**
+* 这两类的次要按钮是「不同意」而非「中止这次运行」（UI-UX8 D14）：
+* 报成 cancelled 会让运行整个结束，工具拿不到否决结果，也就不会留下否决的审计。
+* native 卡与 spec 三档共用本判定，不得各写一份（分册 15 缺陷 C 就是两份逐渐走歧）。
+*/
+function declinesOnCancel(request) {
+	return request.type === "confirm" || request.type === "authorize";
+}
 /** 交互类型 → 标题字典键。徽章与声明树共用，避免两处各写一份映射。 */
 function interactionTitleKey(request) {
 	return request.type === "file-pick" ? "interaction.filePick.title" : `interaction.${request.type}.title`;
@@ -47490,7 +47521,8 @@ function ActiveInteractionCard({ request, bridge }) {
 	const pageAction = isAuthorize && request.capability === "pageAction" ? pageActionDetails(request.details) : void 0;
 	const downloadedFile = isAuthorize && request.capability === "readDownloadedFile" ? downloadedFileDetails(request.details) : void 0;
 	const traceEvidence = isAuthorize ? traceEvidenceDetails(request.details) : void 0;
-	const spec = interactionToUiSpec(request.type === "authorize" && pageAction !== void 0 ? {
+	const localized = pageAction !== void 0 || downloadedFile !== void 0;
+	const spec = interactionToUiSpec(request.type === "authorize" && localized ? {
 		...request,
 		message: ""
 	} : request, {
@@ -47500,7 +47532,7 @@ function ActiveInteractionCard({ request, bridge }) {
 	const preview = isAuthorize && typeof request.details === "object" && request.details !== null ? request.details["preview"] : void 0;
 	const handleAction = (event) => {
 		if (event.intent !== "submit") {
-			if (request.type === "confirm" || request.type === "authorize") {
+			if (declinesOnCancel(request)) {
 				bridge.resolve({
 					id: request.id,
 					value: false
@@ -47604,22 +47636,30 @@ function ActiveInteractionCard({ request, bridge }) {
 							}), pageAction.rememberLabel ?? t("interaction.pageAction.remember")]
 						}) : null
 					] }) : null,
-					downloadedFile ? /* @__PURE__ */ jsxs(Fragment$1, { children: [downloadedFile.file ? /* @__PURE__ */ jsx("p", {
-						"data-testid": "interaction-downloaded-file",
-						className: "text-sm text-ink",
-						children: t("interaction.downloadedFile.file", {
-							name: downloadedFile.file.name,
-							size: formatBytes(downloadedFile.file.size)
-						})
-					}) : null, downloadedFile.rememberable === true ? /* @__PURE__ */ jsxs("label", {
-						className: "flex items-center gap-2 text-sm text-ink",
-						children: [/* @__PURE__ */ jsx("input", {
-							type: "checkbox",
-							"data-testid": "interaction-downloaded-file-remember",
-							checked: remember,
-							onChange: (event) => setRemember(event.currentTarget.checked)
-						}), downloadedFile.rememberLabel ?? t("interaction.downloadedFile.remember")]
-					}) : null] }) : null,
+					downloadedFile ? /* @__PURE__ */ jsxs(Fragment$1, { children: [
+						/* @__PURE__ */ jsx("p", {
+							"data-testid": "interaction-downloaded-file-action",
+							className: "text-sm text-ink",
+							children: t(`interaction.downloadedFile.${downloadedFile.action}`)
+						}),
+						downloadedFile.file ? /* @__PURE__ */ jsx("p", {
+							"data-testid": "interaction-downloaded-file",
+							className: "text-sm text-ink",
+							children: t("interaction.downloadedFile.file", {
+								name: downloadedFile.file.name,
+								size: formatBytes(downloadedFile.file.size)
+							})
+						}) : null,
+						downloadedFile.rememberable === true ? /* @__PURE__ */ jsxs("label", {
+							className: "flex items-center gap-2 text-sm text-ink",
+							children: [/* @__PURE__ */ jsx("input", {
+								type: "checkbox",
+								"data-testid": "interaction-downloaded-file-remember",
+								checked: remember,
+								onChange: (event) => setRemember(event.currentTarget.checked)
+							}), downloadedFile.rememberLabel ?? t("interaction.downloadedFile.remember")]
+						}) : null
+					] }) : null,
 					traceEvidence ? /* @__PURE__ */ jsxs("div", {
 						"data-testid": "interaction-trace-evidence",
 						children: [/* @__PURE__ */ jsx("div", {
@@ -47667,7 +47707,7 @@ function ActiveInteractionCard({ request, bridge }) {
 							}, `${step.tool}-${index}`))
 						})]
 					}) : null,
-					request.details !== void 0 && pageAction === void 0 ? /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("div", {
+					request.details !== void 0 && !localized ? /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("div", {
 						className: "mb-1 text-xs font-medium text-muted",
 						children: t("interaction.authorize.details")
 					}), /* @__PURE__ */ jsx("pre", {
@@ -47948,11 +47988,15 @@ function SpecInteraction({ channel, renderer }) {
 	}, [channel, renderer]);
 	if (!session) return null;
 	const Surface = SURFACES[renderer];
+	const { request } = session;
 	return /* @__PURE__ */ jsx(Surface, {
-		surfaceId: session.request.id,
+		surfaceId: request.id,
 		spec: session.spec,
 		actions: INTERACTION_ACTIONS,
-		onAction: (event) => channel.handleAction(event)
+		onAction: (event) => {
+			if (event.intent !== "submit" && declinesOnCancel(request)) channel.decline(request.id);
+			else channel.handleAction(event);
+		}
 	});
 }
 
@@ -48861,7 +48905,7 @@ function VercelPayloadPreview({ bridge }) {
 * Version of the published `@webskill/chatbot` package, injected at build time.
 * @stable
 */
-const CHATBOT_VERSION = "0.12.0";
+const CHATBOT_VERSION = "0.13.0";
 
 //#endregion
 export { A2uiSurfaceHost, A2uiSurfaceSnapshotHost, CHATBOT_VERSION, ChatEngine, Chatbot, CompositeUiBridge, DEFAULT_RENDERER_CAPABILITIES, DEFAULT_RUNTIME_CONFIG_STORAGE_KEY, ErrorCard, InteractionCard, InterruptedBanner, OpenUiSurfaceHost, OpenUiSurfaceSnapshotHost, ResultBlockList, ResultBlocksPro, SkillBadges, SpecInteraction, VercelPayloadPreview, VercelSurfaceHost, VercelSurfaceSnapshotHost, chatbotDictionary, configureA2uiMarkdown, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, isLlmEntryUsable, pickUsableLlmEntry, probeA2uiAvailability, probeOpenUiAvailability, sandboxExecutorDeps, useT };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webskill/chatbot",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "license": "MIT",
   "type": "module",
   "exports": {
@@ -26,7 +26,7 @@
     "@a2ui/web_core": "^0.10.5",
     "@lit/context": "^1.1.0",
     "@openuidev/react-lang": "0.2.8",
-    "@webskill/sdk": "^0.15.0",
+    "@webskill/sdk": "^0.16.0",
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0",
     "zod": "^3.25.0 || ^4.0.0"