@webskill/sdk 0.29.0 → 0.30.0-next.1

package/dist/types-BXRIoabj.js

@@ -0,0 +1,76 @@
+//#region ../agent/src/perception/types.ts
+/**
+* 两种形状归一成帧列表；旧形状等价于一条 `frame:'self'`（FR-24.1）。
+*
+* **这是判别的单一来源。** 散在各处写 `'frames' in scope` 会让
+* 「旧配置还等价吗」这个问题没有唯一答案。
+* @experimental
+*/
+function toFrameScopes(scope) {
+	if ("frames" in scope) return scope.frames;
+	return [{
+		frame: "self",
+		include: scope.include,
+		...scope.exclude ? { exclude: scope.exclude } : {}
+	}];
+}
+/** 四个方向的规范清单；工具层校验与文案生成都从这里取，不各写一份 */
+const SCROLL_DIRECTIONS = [
+	"up",
+	"down",
+	"left",
+	"right"
+];
+
+//#endregion
+//#region ../agent/src/pageAction/types.ts
+/**
+* 两种形状归一成帧列表；旧形状等价于一条 `frame:'self'`。
+* 与感知侧的 `toFrameScopes` 一样，是本侧判别的**单一来源**。
+* @experimental
+*/
+function toActionFrameScopes(scope) {
+	if ("frames" in scope) return scope.frames;
+	return [{
+		frame: "self",
+		include: scope.include,
+		...scope.exclude ? { exclude: scope.exclude } : {}
+	}];
+}
+/**
+* 本版的操作集（FR-25.1 / 0.16.0 FR-13.6 / 0.18.0 FR-10.1 / 0.22.0 FR-17.1）。
+* 导航只有 `back` 一个，且它**不接受地址**——可达面被浏览器历史封死（SC-1）。
+*
+* `drag` 只表达**起点与终点**，没有中途轨迹（0.22.0 FR-17.6 裁定，D64 就此撤销）：
+* 轨迹是实现细节不是意图，能画任意路径等于架空 AC-23.2，而且滑块验证码要的正是轨迹——
+* 表达不了轨迹，这个动作就天然做不了人机验证绕过。
+*
+* 这些动作与既有几个走**同一条** policy 路径，
+* 范围白名单、逐次确认、审计三条硬约束因此天然覆盖到它们——
+* 前提是新动作不绕过 policy 直调执行器（AC-25.4 守这一点）。
+* @experimental
+*/
+const PAGE_ACTION_KINDS = [
+	"click",
+	"fill",
+	"submit",
+	"select",
+	"set",
+	"attach",
+	"scroll",
+	"hover",
+	"drag",
+	"back"
+];
+/**
+* `back` 的目标占位（0.16.0 分册 13 §4.1）。
+*
+* **模型不能表达它**：工具源在 `action === 'back'` 时拒绝任何 `ref` 入参。
+* 它存在只为了让 `back` 不必改 `PageActionRequest.ref` 的类型——
+* 改它会波及所有实现过 executor 的宓主。
+* @experimental
+*/
+const PAGE_DOCUMENT_REF = "@document";
+
+//#endregion
+export { toFrameScopes as a, SCROLL_DIRECTIONS as i, PAGE_DOCUMENT_REF as n, toActionFrameScopes as r, PAGE_ACTION_KINDS as t };

package/dist/types-DmcXN3qR-Dy7ZDstc.d.ts

@@ -0,0 +1,265 @@
+import { B as ExternalToolSource } from "./index-UbNuzd2a.js";
+//#region ../controller/dist/types-DmcXN3qR.d.ts
+//#region src/jsonRpc.d.ts
+type JsonRpcId = string | number;
+interface JsonRpcRequest {
+  jsonrpc: '2.0';
+  id?: JsonRpcId;
+  method?: string;
+  params?: unknown;
+  result?: unknown;
+  error?: {
+    code: number;
+    message: string;
+    data?: unknown;
+  };
+}
+interface WebSocketEventLike {
+  data: unknown;
+}
+interface WebSocketLike {
+  readonly readyState: number;
+  onopen?: ((event?: unknown) => void) | null;
+  onmessage?: ((event: WebSocketEventLike) => void) | null;
+  onerror?: ((event: unknown) => void) | null;
+  onclose?: ((event: {
+    code?: number;
+    reason?: string;
+  }) => void) | null;
+  send(data: string): void;
+  close(code?: number, reason?: string): void;
+}
+type WebSocketConstructor = new (url: string) => WebSocketLike;
+//#endregion
+//#region src/generated/protocol.d.ts
+/** @experimental */
+type ProtocolVersion = string;
+/** @experimental */
+type IsoDateTime = string;
+/** @experimental */
+type Base64Url = string;
+/** @experimental */
+type Origin = string;
+/** @experimental */
+type BoundedString = string;
+/** @experimental */
+interface InvocationMeta {
+  'webskill/invocationId': string;
+  'webskill/deviceEpoch'?: BoundedString;
+  'webskill/sequence'?: number;
+  'webskill/context'?: {
+    [k: string]: unknown | undefined;
+  };
+  [k: string]: unknown | undefined;
+}
+/** @experimental */
+interface Principal {
+  displayName: BoundedString;
+}
+/** @experimental */
+interface HelloParams {
+  /**
+   * @minItems 1
+   * @maxItems 8
+   */
+  protocolVersions: [ProtocolVersion] | [ProtocolVersion, ProtocolVersion] | [ProtocolVersion, ProtocolVersion, ProtocolVersion] | [ProtocolVersion, ProtocolVersion, ProtocolVersion, ProtocolVersion] | [ProtocolVersion, ProtocolVersion, ProtocolVersion, ProtocolVersion, ProtocolVersion] | [ProtocolVersion, ProtocolVersion, ProtocolVersion, ProtocolVersion, ProtocolVersion, ProtocolVersion] | [ProtocolVersion, ProtocolVersion, ProtocolVersion, ProtocolVersion, ProtocolVersion, ProtocolVersion, ProtocolVersion] | [ProtocolVersion, ProtocolVersion, ProtocolVersion, ProtocolVersion, ProtocolVersion, ProtocolVersion, ProtocolVersion, ProtocolVersion];
+  hostName: BoundedString;
+  hostVersion: BoundedString;
+  deviceFingerprint?: BoundedString;
+}
+/** @experimental */
+interface HelloResult {
+  protocolVersion: ProtocolVersion;
+  controllerInstanceId: BoundedString;
+  controllerName: BoundedString;
+  /**
+   * @maxItems 128
+   */
+  excludedOrigins: Origin[];
+}
+/** @experimental */
+interface PairStartParams {
+  publicKey: Base64Url;
+  deviceName: BoundedString;
+}
+/** @experimental */
+interface PairStartResult {
+  sessionId: BoundedString;
+  code: string;
+  expiresAt: IsoDateTime;
+}
+/** @experimental */
+interface PairApprovedParams {
+  sessionId: BoundedString;
+  approvalNonce: Base64Url;
+  controllerInstanceId: BoundedString;
+  principal: Principal;
+  /**
+   * @maxItems 128
+   */
+  capabilities: BoundedString[];
+  /**
+   * @maxItems 128
+   */
+  excludedOrigins: Origin[];
+}
+/** @experimental */
+interface PairRejectedParams {
+  sessionId: BoundedString;
+  code: BoundedString;
+}
+/** @experimental */
+interface PairConfirmParams {
+  sessionId: BoundedString;
+  accepted: boolean;
+  signature?: Base64Url;
+}
+/** @experimental */
+interface PairConfirmResult {
+  grant?: BoundedString;
+  expiresAt?: IsoDateTime;
+}
+/** @experimental */
+interface AuthPresentParams {
+  grant: BoundedString;
+}
+/** @experimental */
+interface AuthPresentResult {
+  expiresAt: IsoDateTime;
+}
+/** @experimental */
+type AuthChallengeParams = Record<string, never>;
+/** @experimental */
+interface AuthChallengeResult {
+  nonce: Base64Url;
+  expiresAt: IsoDateTime;
+}
+/** @experimental */
+interface AuthRenewParams {
+  nonce: Base64Url;
+  signature: Base64Url;
+}
+/** @experimental */
+interface AuthRenewResult {
+  grant: BoundedString;
+  expiresAt: IsoDateTime;
+}
+/** @experimental */
+interface AuthRevokedParams {
+  reason: BoundedString;
+}
+/** @experimental */
+interface OriginsParams {
+  /**
+   * @maxItems 128
+   */
+  excludedOrigins: Origin[];
+}
+/** @experimental */
+interface HumanControlParams {
+  inControl: boolean;
+  at: IsoDateTime;
+}
+/** @experimental */
+interface ReadyParams {
+  deviceEpoch: BoundedString;
+  writeHighWatermark: number;
+  hostVersion: BoundedString;
+  writeStateRecoverable: boolean;
+}
+/** @experimental */
+type PingParams = Record<string, never>;
+/** @experimental */
+type PingResult = Record<string, never>;
+/** @experimental */
+interface ByeParams {
+  code: BoundedString;
+  message: BoundedString;
+}
+//#endregion
+//#region src/device/types.d.ts
+/** @experimental */
+type ControllerDeviceState = 'idle' | 'connecting' | 'handshaking' | 'unpaired' | 'pairing' | 'awaiting-confirmation' | 'authorizing' | 'ready' | 'offline' | 'failed';
+/** @experimental */
+interface ControllerPairingRecord {
+  readonly controllerUrl: string;
+  readonly controllerInstanceId: string;
+  readonly controllerName: string;
+  readonly principalDisplayName: string;
+  readonly sessionId: string;
+  readonly grant: string;
+  readonly grantExpiresAt: string;
+  readonly declaredOrigins: readonly string[];
+  readonly pairedAt: string;
+}
+/** @experimental */
+interface ControllerWriteState {
+  readonly epoch: string;
+  readonly highWatermark: number;
+}
+/** @experimental */
+interface ControllerDeviceStore {
+  loadKeyPair(): Promise<CryptoKeyPair | undefined>;
+  saveKeyPair(keyPair: CryptoKeyPair): Promise<void>;
+  loadPairing(): Promise<ControllerPairingRecord | undefined>;
+  savePairing(record: ControllerPairingRecord | undefined): Promise<void>;
+  loadWriteState?(): Promise<ControllerWriteState | undefined>;
+  saveWriteState?(state: ControllerWriteState | undefined): Promise<void>;
+  clear(): Promise<void>;
+}
+/** @experimental */
+interface ControllerPairingApproval {
+  readonly sessionId: string;
+  readonly approvalNonce: string;
+  readonly controllerInstanceId: string;
+  readonly controllerName: string;
+  readonly principal: Principal;
+  readonly capabilities: readonly string[];
+  readonly excludedOrigins: readonly string[];
+}
+/** @experimental */
+interface ControllerPairingCode extends PairStartResult {
+  readonly deviceFingerprint: string;
+}
+/** @experimental */
+interface ControllerAuditEvent {
+  readonly type: string;
+  readonly data: Record<string, unknown>;
+}
+/** @experimental */
+interface ControllerDeviceOptions {
+  readonly url: string;
+  readonly deviceName: string;
+  readonly hostVersion: string;
+  readonly store: ControllerDeviceStore;
+  readonly tools: readonly ExternalToolSource[];
+  readonly excludedOrigins?: readonly string[];
+  readonly confirmPairing: (approval: ControllerPairingApproval) => Promise<boolean>;
+  readonly onStateChange?: (state: ControllerDeviceState) => void;
+  readonly onExcludedOriginsChange?: (origins: readonly string[]) => void;
+  readonly onError?: (error: {
+    code: string;
+    message: string;
+  }) => void;
+  readonly audit?: (event: ControllerAuditEvent) => void | Promise<void>;
+  readonly WebSocket?: WebSocketConstructor;
+  readonly now?: () => number;
+}
+/** @experimental */
+interface ControllerDevice {
+  readonly state: ControllerDeviceState;
+  readonly humanInControl: boolean;
+  readonly writeStateRecoverable: boolean;
+  readonly excludedOrigins: readonly string[];
+  readonly pairingCode?: ControllerPairingCode;
+  readonly controllerInstanceId?: string;
+  readonly controllerOrigin: string;
+  connect(): Promise<void>;
+  disconnect(reason?: string): Promise<void>;
+  startPairing(): Promise<ControllerPairingCode>;
+  unpair(): Promise<void>;
+  setHumanInControl(inControl: boolean): void;
+  refreshTools(): Promise<void>;
+}
+//#endregion
+export { PairConfirmResult as A, WebSocketLike as B, InvocationMeta as C, OriginsParams as D, Origin as E, PingResult as F, Principal as I, ProtocolVersion as L, PairStartParams as M, PairStartResult as N, PairApprovedParams as O, PingParams as P, ReadyParams as R, HumanControlParams as S, JsonRpcRequest as T, ControllerPairingCode as _, AuthRenewParams as a, HelloParams as b, Base64Url as c, ControllerAuditEvent as d, ControllerDevice as f, ControllerPairingApproval as g, ControllerDeviceStore as h, AuthPresentResult as i, PairRejectedParams as j, PairConfirmParams as k, BoundedString as l, ControllerDeviceState as m, AuthChallengeResult as n, AuthRenewResult as o, ControllerDeviceOptions as p, AuthPresentParams as r, AuthRevokedParams as s, AuthChallengeParams as t, ByeParams as u, ControllerPairingRecord as v, IsoDateTime as w, HelloResult as x, ControllerWriteState as y, WebSocketConstructor as z };

package/dist/{types-wKp3YBSM-D7w-ZbsB.d.ts → types-wKp3YBSM-CSeFUL9R.d.ts}

@@ -51,7 +51,7 @@ type WebSkillErrorCode = 'FS_NOT_FOUND' | 'FS_PATH_OUTSIDE_ROOT' | 'SKILL_NOT_FO
 /** 请求了若干格，一条都没写成——那不是部分成功，是整个填错了地方（0.24.0 FR-17.10） */
 'TEMPLATE_FILL_REJECTED' |
 /** 用户拒绝了这次工具调用（0.14.0 分册 20） */
-'TOOL_DENIED';
+'TOOL_DENIED' | 'CONTROLLER_PROTOCOL_UNSUPPORTED' | 'CONTROLLER_MESSAGE_INVALID' | 'CONTROLLER_NOT_PAIRED' | 'CONTROLLER_PAIRING_REJECTED' | 'CONTROLLER_PAIRING_RATE_LIMITED' | 'CONTROLLER_CAPABILITY_MISSING' | 'CONTROLLER_HUMAN_IN_CONTROL' | 'CONTROLLER_INVOCATION_DUPLICATE';
 /**
  * 所有公开 API 抛出的结构化错误，code 供上层可编程处理
  * @stable