@webskill/sdk 0.14.0 → 0.15.0

package/dist/browser.d.ts

@@ -1,6 +1,6 @@
-import { At as VerifyResult, Ct as SkillsLockfile, Et as TrustedKeyStore, H as FileStat, N as ArchiveLimits, Ot as UnsignedPolicy, S as UiBridge, U as FileSystemProvider, _t as SkillManifest, b as RenderResultRequest, c as InteractionResponse, jt as WebSkillError, l as LlmClient, m as LlmStreamEvent, o as InteractionPolicy, p as LlmResponse, pt as SkillInstallSource, s as InteractionRequest, u as LlmCompleteInput, v as MemoryStore } from "./types-C3V6lAeO-BgeOvc1Y.js";
-import { F as ExternalSkillProvider, Ht as ScriptExecutionContext, I as ExternalToolSource, Ln as WebSkillApi, S as BridgeResponse, Un as bridgeError, Ut as ScriptExecutor, at as NetworkPolicy, fn as ToolDefinition, hn as ToolResult, m as ApprovalScope, pr as parseBridgeRequest, rt as LinkedDocumentReader, x as BridgeRequest, y as BridgeCapabilities } from "./index-CWoKOFBP.js";
-import { $ as PageActionOutcome, Ct as PerceptionScopeInput, Z as PageActionExecutor, at as PageActionScopeInput, ft as PagePerceptionReader, gt as PerceivedNode, ot as PageActionTarget, rt as PageActionRequest, ut as PagePerceptionPolicy, vt as PerceptionCaptureOptions, xt as PerceptionResult } from "./index-DQwGvHAI.js";
+import { Ct as SkillsLockfile, Et as TrustedKeyStore, H as FileStat, Mt as WebSkillError, N as ArchiveLimits, S as UiBridge, U as FileSystemProvider, _t as SkillManifest, b as RenderResultRequest, c as InteractionResponse, jt as VerifyResult, kt as UnsignedPolicy, l as LlmClient, m as LlmStreamEvent, o as InteractionPolicy, p as LlmResponse, pt as SkillInstallSource, s as InteractionRequest, u as LlmCompleteInput, v as MemoryStore } from "./types-C3V6lAeO-BIf7UB2e.js";
+import { Kt as ScriptExecutionContext, M as DocumentSurfaceHost, R as ExternalSkillProvider, S as BridgeResponse, Un as WebSkillApi, Yn as bridgeError, ct as NetworkPolicy, gn as ToolDefinition, m as ApprovalScope, ot as LinkedDocumentReader, qt as ScriptExecutor, x as BridgeRequest, y as BridgeCapabilities, yn as ToolResult, yr as parseBridgeRequest, z as ExternalToolSource } from "./index-Oc3H89TJ.js";
+import { Ct as PerceptionCaptureOptions, Et as PerceptionResult, J as NestedFrameRef, Ot as PerceptionScopeInput, _t as PagePerceptionReader, ct as PageActionRequest, dt as PageActionTarget, ht as PagePerceptionPolicy, it as PageActionOutcome, nt as PageActionExecutor, ut as PageActionScopeInput, xt as PerceivedNode } from "./index-CQYo4tcT.js";
 //#region ../browser/dist/index.d.ts
 //#region src/fs/featureDetection.d.ts
 /** 检测当前环境是否可用 OPFS（navigator.storage.getDirectory） */
@@ -39,7 +39,7 @@ declare class OpfsProvider implements FileSystemProvider {
  *
  * 协议（宿主 ↔ Worker）：
  * - 宿主 → Worker：{type:'load', id, source, networkPolicy?} 请求加载脚本定义
- * - 宿主 → Worker：{type:'execute', id, skillName, runId, source, args, networkPolicy?} 请求执行
+ * - 宿主 → Worker：{type:'execute', id, skillName, runId, source, args, networkPolicy?, documentSurface?} 请求执行
  * - Worker → 宿主：{type:'load-result', id, ok, definition?, error?}
  * - Worker → 宿主：{type:'execute-result', id, ok, value?, stdout, stderr, error?}
  * - Worker → 宿主：{type:'bridge', request} 能力桥 RPC（readReference/writeArtifact/confirm）
@@ -649,6 +649,99 @@ interface PageAgentHandler {
  */
 declare function createPageAgentHandler(options?: PageAgentHandlerOptions): PageAgentHandler;
 //#endregion
+//#region src/remote/frameRouter.d.ts
+/**
+ * 一次感知能铺开的上限（0.14.0 分册 16 FR-16.4）。
+ *
+ * 兜底的是**帧数与节点总量**，不是层数。0.13.0 D-18-8 用深度上限兜底，
+ * 前提是「路径由宿主写死」；自动发现一进来那个前提就没了：
+ * 三层的页面可能只有 5 个节点，两层的门户可能挂着 40 个 iframe。
+ * 层数是错的度量，总量才是。
+ * @experimental
+ */
+interface FrameBudget {
+  maxFrames: number;
+  maxNodes: number;
+}
+/** @experimental */
+declare const DEFAULT_FRAME_BUDGET: FrameBudget;
+/**
+ * 一次投递的回执。
+ *
+ * `documentUrl` 是应答**实际来自**的文档地址，用于导航漂移判定：
+ * 投递地址是上一刻算出来的，那一帧完全可能在往返之间导航走。
+ * @experimental
+ */
+interface FrameDelivery {
+  reply: PageAgentReply;
+  documentUrl: string;
+}
+/**
+ * 解析嵌套帧时宿主能拿到的上下文。
+ *
+ * `visited` 由路由器攒、由宿主读：去重需要比较地址，而地址对路由器是不透明的
+ * （D-11-1）。让宿主自己在 dispatcher 里存一份则解决不了生命周期——
+ * dispatcher 是长期对象，一次编排结束后没人通知它清空。
+ * @experimental
+ */
+interface FrameResolveContext<A> {
+  /** 发现这个嵌套帧的那一帧的地址 */
+  readonly parent: A;
+  /** 本次感知已投递过的地址，按投递顺序 */
+  readonly visited: readonly A[];
+}
+/**
+ * 宿主实现的那一半（分册 11 FR-11.1）：**寻址**。
+ *
+ * 地址类型 `A` 对路由器完全不透明：不比较、不序列化、不持久化，
+ * 只在同一次编排内原样传递。扩展宿主用帧号，`postMessage` 宿主用 URL，
+ * 两者不需要迁就同一个形状。
+ * @experimental
+ */
+interface FrameDispatcher<A> {
+  /** 从哪里开始下钻 */
+  mainFrame(): A | Promise<A>;
+  /** 把一次请求送到某个地址 */
+  send(address: A, request: PageAgentRequest): Promise<FrameDelivery>;
+  /**
+   * 把某一帧报上来的嵌套帧引用换成可投递的地址。
+   *
+   * 解析不出（跨源、不可达、不在宿主白名单里、已经读过）时返回 `undefined`，
+   * 该帧被跳过并留说明，**不算错误**。这是帧可达性的唯一出口：
+   * SDK 不带任何缺省白名单，也不因为「导出了」就替宿主放行一帧（D-11-4）。
+   */
+  resolveNestedFrame(nested: NestedFrameRef, context: FrameResolveContext<A>): Promise<A | undefined> | A | undefined;
+}
+/** @experimental */
+interface FrameRouterOptions<A> {
+  dispatcher: FrameDispatcher<A>;
+  budget?: Partial<FrameBudget>;
+  /**
+   * 主帧的帧名（D-11-3）。不给则主帧节点**不带** `frame`——
+   * 主帧就是「这个页面」，给它加一段前缀只会让每个节点都变吵。
+   * 主帧本身就是外壳里的一帧时（模型要能区分外壳与业务帧）才给。
+   */
+  mainFrameLabel?: string;
+}
+/** @experimental */
+interface FrameRouter {
+  perceive(request: PageAgentRequest & {
+    type: 'perceive';
+  }): Promise<PageAgentReply>;
+  execute(request: PageAgentRequest & {
+    type: 'execute';
+  }): Promise<PageAgentReply>;
+}
+/**
+ * 逐帧下钻并汇总（分册 16 FR-16.2 / FR-16.3 / FR-16.4，分册 11 FR-11.2）。
+ *
+ * 编排本身与浏览器 API 无关：它只认 `PageAgentRequest` / `PageAgentReply`，
+ * 寻址全压在宿主实现的 `FrameDispatcher` 里。因此这个模块可以在 Service Worker
+ * 里实例化，也可以服务不按帧号寻址的宿主。
+ * @experimental
+ */
+declare function createFrameRouter<A>(options: FrameRouterOptions<A>): FrameRouter;
+//#endregion
 //#region src/dom/imageCapture.d.ts
 /**
  * 取像级别（0.6.0 FR-12.1）。裁决 D-3 已取消 L3 栅格化，只剩两级。
@@ -1204,6 +1297,14 @@ declare const DOCUMENT_SURFACE_AUDIT_EVENT = "document.surface.open";
  * 无 `allow-top-navigation` 改不了它的地址。
  */
 declare function openDocumentSurface(input: OpenDocumentInput, options: DocumentSurfaceOptions): Promise<WindowLike>;
+/**
+ * 把 `openDocumentSurface` 柯里化成 `DocumentSurfaceHost`（0.15.0 分册 13 FR-13.3）。
+ *
+ * **只绑定选项，不新增任何逻辑**：体积上限、握手超时、`DOCUMENT_SURFACE_DECLINED`
+ * 与审计事件全部沿用上面那一份实现（FR-13.5「逐条不变」的实现基础）。
+ * @experimental
+ */
+declare function createDocumentSurfaceHost(options: DocumentSurfaceOptions): DocumentSurfaceHost;
 //#endregion
 //#region src/viewer/shell.d.ts
 /**
@@ -1280,4 +1381,4 @@ declare function watchBlockedResources(host: ViewerBlockedHost, notice: ViewerBl
 /** 提示文案的单一来源；判据直接引用，不各写一份字面量 */
 declare function blockedMessage(origins: readonly string[]): string;
 //#endregion
-export { type BlockedEventLike, type BridgeCapabilities, type BridgeRequest, type BridgeResponse, type BrowserHostBundle, type BrowserHostOptions, type BrowserHostOverrides, BrowserSkillManager, BrowserWorkerScriptExecutor, type CaptureFailure, type CaptureLevel, type CapturedImage, type ChromeBuiltinAvailability, ChromeBuiltinLlmClient, type CompressResult, type ConfiguredLlmClient, DEFAULT_MAX_VIEWER_PAYLOAD_BYTES, DOCUMENT_SURFACE_AUDIT_EVENT, DOCX_UNEXTRACTED, type DictationAvailability, type DictationOptions, type DictationSession, type DocumentSurfaceAudit, type DocumentSurfaceOptions, type DomPageActionExecutor, type DomPageActionOptions, type DomPerceptionReader, type DomPerceptionReaderOptions, type FetchLinkedDocumentOptions, HOST_PORT_MATRIX, type HostChatbotAdapterShape, type HostConnectFacadeShape, type HostConsoleBackendShape, type HostKind, type HostSurface, type IframeSandboxOptions, IframeWorkerLike, type InspectHostWiringInput, type LlmClientConfig, type LlmEntryConfig, type MainToWorkerMessage, type OpenDocumentInput, OpfsProvider, type PageAgentHandler, type PageAgentHandlerOptions, type PageAgentReply, type PageAgentRequest, type PageAgentTargetEntry, type PageAgentTransport, type PortApplicability, type PortReport, type PortSpec, type PortStatus, type RemotePageActionExecutorOptions, type RemotePerceptionReaderOptions, type RemoteTargetRegistry, type RoleHint, SANDBOX_PAGE_SCRIPT_SOURCE, type SandboxMode, type SerializedError, TsTranspiler, type TypeScriptSupportOptions, VIEWER_SANDBOX_TOKENS, type ViewerBlockedHost, type ViewerBlockedNotice, type ViewerBlockedResult, type ViewerCspOptions, type ViewerDocument, type ViewerShellHost, type ViewerShellMount, type ViewerShellResult, WORKER_BOOTSTRAP_SOURCE, type WindowLike, type WorkerEvent, type WorkerFactory, type WorkerLike, type WorkerRequest, WorkerRuntimeClient, type WorkerRuntimeClientDeps, type WorkerRuntimeHostOverrides, type WorkerScopeLike, WorkerUiBridge, XLSX_UNEXTRACTED, blockedMessage, bridgeError, captureElementImage, checkDictationAvailability, compressImageToBudget, createBrowserChatbotHost, createDomPageActionExecutor, createDomPerceptionReader, createEncryptedMemoryStore, createFetchLinkedDocumentReader, createIframeWorker, createLlmClient, createPageAgentHandler, createRemotePageActionExecutor, createRemotePerceptionReader, createRemoteTargetRegistry, deleteMemoryEncryptionKey, extractDocxText, extractXlsxText, extractZipWeb, generateMemoryEncryptionKey, inspectHostWiring, installWebSkillNavigator, isCapturableElement, isCaptureFailure, isEncryptedMemoryValue, isOpfsAvailable, missingPorts, openDocumentSurface, openMemoryEncryptionKey, parseBridgeRequest, parseMainMessage, parseWorkerEvent, probeChromeBuiltinAvailability, sha256HexWeb, startDictation, startViewerShell, startWorkerRuntimeHost, viewerCspHeader, watchBlockedResources };
+export { type BlockedEventLike, type BridgeCapabilities, type BridgeRequest, type BridgeResponse, type BrowserHostBundle, type BrowserHostOptions, type BrowserHostOverrides, BrowserSkillManager, BrowserWorkerScriptExecutor, type CaptureFailure, type CaptureLevel, type CapturedImage, type ChromeBuiltinAvailability, ChromeBuiltinLlmClient, type CompressResult, type ConfiguredLlmClient, DEFAULT_FRAME_BUDGET, DEFAULT_MAX_VIEWER_PAYLOAD_BYTES, DOCUMENT_SURFACE_AUDIT_EVENT, DOCX_UNEXTRACTED, type DictationAvailability, type DictationOptions, type DictationSession, type DocumentSurfaceAudit, type DocumentSurfaceOptions, type DomPageActionExecutor, type DomPageActionOptions, type DomPerceptionReader, type DomPerceptionReaderOptions, type FetchLinkedDocumentOptions, type FrameBudget, type FrameDelivery, type FrameDispatcher, type FrameResolveContext, type FrameRouter, type FrameRouterOptions, HOST_PORT_MATRIX, type HostChatbotAdapterShape, type HostConnectFacadeShape, type HostConsoleBackendShape, type HostKind, type HostSurface, type IframeSandboxOptions, IframeWorkerLike, type InspectHostWiringInput, type LlmClientConfig, type LlmEntryConfig, type MainToWorkerMessage, type OpenDocumentInput, OpfsProvider, type PageAgentHandler, type PageAgentHandlerOptions, type PageAgentReply, type PageAgentRequest, type PageAgentTargetEntry, type PageAgentTransport, type PortApplicability, type PortReport, type PortSpec, type PortStatus, type RemotePageActionExecutorOptions, type RemotePerceptionReaderOptions, type RemoteTargetRegistry, type RoleHint, SANDBOX_PAGE_SCRIPT_SOURCE, type SandboxMode, type SerializedError, TsTranspiler, type TypeScriptSupportOptions, VIEWER_SANDBOX_TOKENS, type ViewerBlockedHost, type ViewerBlockedNotice, type ViewerBlockedResult, type ViewerCspOptions, type ViewerDocument, type ViewerShellHost, type ViewerShellMount, type ViewerShellResult, WORKER_BOOTSTRAP_SOURCE, type WindowLike, type WorkerEvent, type WorkerFactory, type WorkerLike, type WorkerRequest, WorkerRuntimeClient, type WorkerRuntimeClientDeps, type WorkerRuntimeHostOverrides, type WorkerScopeLike, WorkerUiBridge, XLSX_UNEXTRACTED, blockedMessage, bridgeError, captureElementImage, checkDictationAvailability, compressImageToBudget, createBrowserChatbotHost, createDocumentSurfaceHost, createDomPageActionExecutor, createDomPerceptionReader, createEncryptedMemoryStore, createFetchLinkedDocumentReader, createFrameRouter, createIframeWorker, createLlmClient, createPageAgentHandler, createRemotePageActionExecutor, createRemotePerceptionReader, createRemoteTargetRegistry, deleteMemoryEncryptionKey, extractDocxText, extractXlsxText, extractZipWeb, generateMemoryEncryptionKey, inspectHostWiring, installWebSkillNavigator, isCapturableElement, isCaptureFailure, isEncryptedMemoryValue, isOpfsAvailable, missingPorts, openDocumentSurface, openMemoryEncryptionKey, parseBridgeRequest, parseMainMessage, parseWorkerEvent, probeChromeBuiltinAvailability, sha256HexWeb, startDictation, startViewerShell, startWorkerRuntimeHost, viewerCspHeader, watchBlockedResources };