@webskill/sdk 0.28.1 → 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-167azx1H.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
@@ -521,6 +521,7 @@ declare const FILE_MIME_TYPES: readonly ["application/pdf"];
  * 不走直通的 `file`：docx / xlsx / pptx 发给 provider 会被当成二进制垃圾。
  */
 declare const DOCX_MIME = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+declare const XLS_MIME = "application/vnd.ms-excel";
 declare const XLSX_MIME = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
 declare const PPTX_MIME = "application/vnd.openxmlformats-officedocument.presentationml.presentation";
 /** 文本类附件进模型上下文的字符上限（0.6.0） @experimental */
@@ -1276,4 +1277,4 @@ interface MemoryStore {
   transaction?<T>(scope: string, fn: (inner: MemoryStore) => Promise<T>): Promise<T>;
 }
 //#endregion
-export { PPTX_MIME as $, exportSkills as $t, extractSkillCandidate as A, TrustedKey as At, DOCX_MIME as B, assertRemoteUrlAllowed as Bt, UiSpecActionCapability as C, verifySkillSignature as Cn, SkillMetadata as Ct, UiSpecSnapshot as D, SkillSource as Dt, UiSpecPatch as E, SkillSignature as Et, BINARY_EXTENSIONS as F, ValidationReport as Ft, FileStat as G, buildManifest as Gt, DiscoveryResult as H, atomicWriteBinary as Ht, CatalogRenderer as I, VerifyResult as It, FsTrustedKeyStore as J, classifyAttachment as Jt, FileSystemProvider as K, checkDependencyCycles as Kt, ChatAttachmentKind as L, WebSkillError as Lt, ATTACHMENT_TEXT_LIMIT as M, UNTRUSTED_LINE_LIMIT as Mt, ArchiveLimits as N, UiSpecNode as Nt, UiSurfaceActionRequest as O, SkillsLockfile as Ot, AttachmentTextInput as P, UnsignedPolicy as Pt, MemoryFS as Q, escapeXml as Qt, CryptoKeyLike as R, WebSkillErrorCode as Rt, UiBridge as S, verifyManifest as Sn, SkillManifest as St, UiSpecEvent as T, SkillReader as Tt, ExtractedDocumentFormat as U, atomicWriteText as Ut, DWG_MIME_TYPES as V, assertSafePathSegment as Vt, FILE_MIME_TYPES as W, buildCatalog as Wt, JsonSchema as X, detectSkillArchiveShape as Xt, IMAGE_MIME_TYPES as Y, computeDigest as Yt, MANIFEST_EXCLUDED_FILES as Z, detectSkillArchiveShapeFromFs as Zt, LlmToolSpec as _, signSkill as _n, SkillDocument as _t, InteractionOrigin as a, keyIdOf as an, SKILL_MANIFEST_FILE as at, RenderResultRequest as b, unzipWithLimits as bn, SkillLocation as bt, InteractionResponse as c, parseSkillMarkdown as cn, SKILL_PACK_FILE as ct, LlmContentPart as d, readSkillSignature as dn, SignatureVerdict as dt, extractedDocumentFormat as en, Page as et, LlmMessage as f, renderAvailableSkillsXml as fn, SkillArchiveDetection as ft, LlmToolCall as g, sanitizeUntrustedLine as gn, SkillDiscovery as gt, LlmTokenUsage as h, resolveInsideRoot as hn, SkillCatalogEntry as ht, FormField as i, jsonRenderer as in, SKILLS_LOCKFILE as it, ATOMIC_TMP_SUFFIX_PATTERN as j, TrustedKeyStore as jt, UiSurfaceActionResponse as k, TEXT_EXTENSIONS as kt, LlmClient as l, parseSkillPackManifest as ln, SKILL_SIGNATURE_FILE as lt, LlmStreamEvent as m, resolveArchiveLimits as mn, SkillCatalog as mt, ArtifactStore as n, isAtomicTempPath as nn, RemoteUrlPolicy as nt, InteractionPolicy as o, messageOf as on, SKILL_NAME_MAX_LENGTH as ot, LlmResponse as p, renderCatalogJson as pn, SkillArchiveShape as pt, FileWriteStream as q, checkSkillRules as qt, ChartSpec as r, isValidSkillName as rn, SIGNATURE_SCHEMA_VERSION as rt, InteractionRequest as s, normalizePath as sn, SKILL_NAME_PATTERN as st, Artifact as t, formatAttachmentText as tn, PageQuery as tt, LlmCompleteInput as u, readResponseWithLimit as un, SignatureAuditSink as ut, MemoryStore as v, signaturePayloadBytes as vn, SkillInstallSource as vt, UiSpecDrafts as w, xmlRenderer as wn, SkillPackManifest as wt, SkillCandidateMarker as x, validateSkills as xn, SkillManagerPort as xt, RenderBlock as y, stripArchiveRoot as yn, SkillIssue as yt, DEFAULT_ARCHIVE_LIMITS as z, XLSX_MIME as zt };
+export { PPTX_MIME as $, escapeXml as $t, extractSkillCandidate as A, TrustedKey as At, DOCX_MIME as B, XLS_MIME as Bt, UiSpecActionCapability as C, verifyManifest as Cn, SkillMetadata as Ct, UiSpecSnapshot as D, SkillSource as Dt, UiSpecPatch as E, SkillSignature as Et, BINARY_EXTENSIONS as F, ValidationReport as Ft, FileStat as G, buildCatalog as Gt, DiscoveryResult as H, assertSafePathSegment as Ht, CatalogRenderer as I, VerifyResult as It, FsTrustedKeyStore as J, checkSkillRules as Jt, FileSystemProvider as K, buildManifest as Kt, ChatAttachmentKind as L, WebSkillError as Lt, ATTACHMENT_TEXT_LIMIT as M, UNTRUSTED_LINE_LIMIT as Mt, ArchiveLimits as N, UiSpecNode as Nt, UiSurfaceActionRequest as O, SkillsLockfile as Ot, AttachmentTextInput as P, UnsignedPolicy as Pt, MemoryFS as Q, detectSkillArchiveShapeFromFs as Qt, CryptoKeyLike as R, WebSkillErrorCode as Rt, UiBridge as S, validateSkills as Sn, SkillManifest as St, UiSpecEvent as T, xmlRenderer as Tn, SkillReader as Tt, ExtractedDocumentFormat as U, atomicWriteBinary as Ut, DWG_MIME_TYPES as V, assertRemoteUrlAllowed as Vt, FILE_MIME_TYPES as W, atomicWriteText as Wt, JsonSchema as X, computeDigest as Xt, IMAGE_MIME_TYPES as Y, classifyAttachment as Yt, MANIFEST_EXCLUDED_FILES as Z, detectSkillArchiveShape as Zt, LlmToolSpec as _, sanitizeUntrustedLine as _n, SkillDocument as _t, InteractionOrigin as a, jsonRenderer as an, SKILL_MANIFEST_FILE as at, RenderResultRequest as b, stripArchiveRoot as bn, SkillLocation as bt, InteractionResponse as c, normalizePath as cn, SKILL_PACK_FILE as ct, LlmContentPart as d, readResponseWithLimit as dn, SignatureVerdict as dt, exportSkills as en, Page as et, LlmMessage as f, readSkillSignature as fn, SkillArchiveDetection as ft, LlmToolCall as g, resolveInsideRoot as gn, SkillDiscovery as gt, LlmTokenUsage as h, resolveArchiveLimits as hn, SkillCatalogEntry as ht, FormField as i, isValidSkillName as in, SKILLS_LOCKFILE as it, ATOMIC_TMP_SUFFIX_PATTERN as j, TrustedKeyStore as jt, UiSurfaceActionResponse as k, TEXT_EXTENSIONS as kt, LlmClient as l, parseSkillMarkdown as ln, SKILL_SIGNATURE_FILE as lt, LlmStreamEvent as m, renderCatalogJson as mn, SkillCatalog as mt, ArtifactStore as n, formatAttachmentText as nn, RemoteUrlPolicy as nt, InteractionPolicy as o, keyIdOf as on, SKILL_NAME_MAX_LENGTH as ot, LlmResponse as p, renderAvailableSkillsXml as pn, SkillArchiveShape as pt, FileWriteStream as q, checkDependencyCycles as qt, ChartSpec as r, isAtomicTempPath as rn, SIGNATURE_SCHEMA_VERSION as rt, InteractionRequest as s, messageOf as sn, SKILL_NAME_PATTERN as st, Artifact as t, extractedDocumentFormat as tn, PageQuery as tt, LlmCompleteInput as u, parseSkillPackManifest as un, SignatureAuditSink as ut, MemoryStore as v, signSkill as vn, SkillInstallSource as vt, UiSpecDrafts as w, verifySkillSignature as wn, SkillPackManifest as wt, SkillCandidateMarker as x, unzipWithLimits as xn, SkillManagerPort as xt, RenderBlock as y, signaturePayloadBytes as yn, SkillIssue as yt, DEFAULT_ARCHIVE_LIMITS as z, XLSX_MIME as zt };