@webskill/sdk 0.5.0 → 0.6.0

package/dist/agent.d.ts

@@ -1,2 +1,2 @@
-import { A as SubAgentRunInput, B as createDelegationToolSource, C as SKILL_GENERATION_SYSTEM_PROMPT, D as SkillGenerationToolSourceOptions, E as SkillGenerationPolicy, F as TodoList, H as createSkillGenerationToolSource, I as TodoListener, L as TodoStatus, M as TODO_SYSTEM_PROMPT, N as TodoEvent, O as SkillGenerator, P as TodoItem, R as TodoStore, S as PerceptionScope, T as SkillGenerationOutcome, U as createTodoToolSource, V as createPagePerceptionToolSource, W as withDelegationOrigin, _ as PagePerceptionToolSourceOptions, a as DelegationOrchestratorOptions, b as PerceptionAuditSink, c as DelegationToolSourceOptions, d as MANAGE_TODO_TOOL, f as PERCEIVE_PAGE_TOOL, g as PagePerceptionReader, h as PagePerceptionPolicyOptions, i as DelegationOrchestrator, j as SubAgentRunner, k as SkillGeneratorOptions, l as GENERATE_SKILL_TOOL, m as PagePerceptionPolicy, n as DELEGATION_SYSTEM_PROMPT, o as DelegationRequest, p as PERCEPTION_SYSTEM_PROMPT, r as DelegationBudget, s as DelegationResult, t as DELEGATE_TASK_TOOL, u as GeneratedSkillDraft, v as ParentBudget, w as SkillCandidateSink, x as PerceptionRecord, y as PerceivedNode, z as TodoToolSourceOptions } from "./index-D_7ZZjkl.js";
-export { DELEGATE_TASK_TOOL, DELEGATION_SYSTEM_PROMPT, type DelegationBudget, DelegationOrchestrator, type DelegationOrchestratorOptions, type DelegationRequest, type DelegationResult, type DelegationToolSourceOptions, GENERATE_SKILL_TOOL, type GeneratedSkillDraft, MANAGE_TODO_TOOL, PERCEIVE_PAGE_TOOL, PERCEPTION_SYSTEM_PROMPT, PagePerceptionPolicy, type PagePerceptionPolicyOptions, type PagePerceptionReader, type PagePerceptionToolSourceOptions, type ParentBudget, type PerceivedNode, type PerceptionAuditSink, type PerceptionRecord, type PerceptionScope, SKILL_GENERATION_SYSTEM_PROMPT, type SkillCandidateSink, type SkillGenerationOutcome, type SkillGenerationPolicy, type SkillGenerationToolSourceOptions, SkillGenerator, type SkillGeneratorOptions, type SubAgentRunInput, type SubAgentRunner, TODO_SYSTEM_PROMPT, type TodoEvent, type TodoItem, type TodoList, type TodoListener, type TodoStatus, TodoStore, type TodoToolSourceOptions, createDelegationToolSource, createPagePerceptionToolSource, createSkillGenerationToolSource, createTodoToolSource, withDelegationOrigin };
+import { A as SkillGenerationPolicy, B as TodoListener, C as PerceptionCaptureOptions, D as SKILL_GENERATION_SYSTEM_PROMPT, E as PerceptionScope, F as SubAgentRunner, G as createPagePerceptionToolSource, H as TodoStore, I as TODO_SYSTEM_PROMPT, J as withDelegationOrigin, K as createSkillGenerationToolSource, L as TodoEvent, M as SkillGenerator, N as SkillGeneratorOptions, O as SkillCandidateSink, P as SubAgentRunInput, R as TodoItem, S as PerceptionAuditSink, T as PerceptionResult, U as TodoToolSourceOptions, V as TodoStatus, W as createDelegationToolSource, _ as PagePerceptionReader, a as DelegationOrchestratorOptions, b as PerceivedImage, c as DelegationToolSourceOptions, d as ImageCaptureBudget, f as MANAGE_TODO_TOOL, g as PagePerceptionPolicyOptions, h as PagePerceptionPolicy, i as DelegationOrchestrator, j as SkillGenerationToolSourceOptions, k as SkillGenerationOutcome, l as GENERATE_SKILL_TOOL, m as PERCEPTION_SYSTEM_PROMPT, n as DELEGATION_SYSTEM_PROMPT, o as DelegationRequest, p as PERCEIVE_PAGE_TOOL, q as createTodoToolSource, r as DelegationBudget, s as DelegationResult, t as DELEGATE_TASK_TOOL, u as GeneratedSkillDraft, v as PagePerceptionToolSourceOptions, w as PerceptionRecord, x as PerceivedNode, y as ParentBudget, z as TodoList } from "./index-BuTpBMzr.js";
+export { DELEGATE_TASK_TOOL, DELEGATION_SYSTEM_PROMPT, type DelegationBudget, DelegationOrchestrator, type DelegationOrchestratorOptions, type DelegationRequest, type DelegationResult, type DelegationToolSourceOptions, GENERATE_SKILL_TOOL, type GeneratedSkillDraft, type ImageCaptureBudget, MANAGE_TODO_TOOL, PERCEIVE_PAGE_TOOL, PERCEPTION_SYSTEM_PROMPT, PagePerceptionPolicy, type PagePerceptionPolicyOptions, type PagePerceptionReader, type PagePerceptionToolSourceOptions, type ParentBudget, type PerceivedImage, type PerceivedNode, type PerceptionAuditSink, type PerceptionCaptureOptions, type PerceptionRecord, type PerceptionResult, type PerceptionScope, SKILL_GENERATION_SYSTEM_PROMPT, type SkillCandidateSink, type SkillGenerationOutcome, type SkillGenerationPolicy, type SkillGenerationToolSourceOptions, SkillGenerator, type SkillGeneratorOptions, type SubAgentRunInput, type SubAgentRunner, TODO_SYSTEM_PROMPT, type TodoEvent, type TodoItem, type TodoList, type TodoListener, type TodoStatus, TodoStore, type TodoToolSourceOptions, createDelegationToolSource, createPagePerceptionToolSource, createSkillGenerationToolSource, createTodoToolSource, withDelegationOrigin };

package/dist/agent.js

@@ -359,14 +359,22 @@ var SkillGenerator = class {
 /**
 * 技能自动生成的系统提示词。默认不注册工具，因此这段提示词只在
 * 宿主打开开关时才进入上下文（设计 02 §1.3）。
+*
+* 触发条件写成正面清单而不是「不要自发调用」（0.6.0 FR-18.5）：实测中后者会连
+* 「帮我写一份流程规范」这类明确的沉淀请求一起抑制掉，开关等于白开。
 */
 const SKILL_GENERATION_SYSTEM_PROMPT = [
 	"## Saving a reusable skill",
 	"",
-	"When the user has walked you through a procedure that is worth reusing, you may call",
-	"`generate_skill` to turn it into a skill candidate.",
+	"Call `generate_skill` when the user asks you to define a procedure, policy, workflow,",
+	"standard, or checklist that they will reuse later — for example \"draft a process for ...\",",
+	"\"write a standard for ...\", \"create a checklist for ...\".",
+	"",
+	"Do not call it for one-off answers, factual questions, or content the user only needs once.",
+	"",
+	"Before calling it, ask the user for the missing details: scope, the roles involved, and",
+	"any constraints. Do not emit a generic template when information is insufficient.",
 	"",
-	"- Never call it on your own initiative for one-off answers; only for repeatable procedures.",
 	"- `content` must be a complete SKILL.md: YAML frontmatter with `name` and `description`,",
 	"  then the instructions as Markdown. The frontmatter `name` must equal the `name` argument.",
 	"- Put helper scripts under `scripts/` and use the `.ts` or `.js` extension.",
@@ -730,9 +738,10 @@ function withDelegationOrigin(bridge, origin) {
 /**
 * 页面只读感知策略（需求 10）。
 *
-* **`perceive()` 不接受任何参数**——这是「白名单判定不受模型输出影响」
+* **`perceive()` 不接受任何范围参数**——这是「白名单判定不受模型输出影响」
 * （AC-10.8）的实现方式。不是先拿模型给的范围再去校验，而是模型压根没有
 * 表达范围的入口：能被读的区域只由构造时的 `scope` 决定。
+* 唯一的参数是取像预算（`PerceptionCaptureOptions`），它里面没有任何范围字段。
 *
 * 本类**没有**任何点击 / 输入 / 提交 / 导航 / 滚动方法（FR-10.7）。
 * @experimental
@@ -760,15 +769,27 @@ var PagePerceptionPolicy = class {
 		this.#listeners.add(listener);
 		return () => this.#listeners.delete(listener);
 	}
-	async perceive() {
+	async perceive(capture) {
 		if (!this.enabled) throw new WebSkillError("PERCEPTION_NOT_ENABLED", "Page perception is not enabled: the host declared no readable regions.");
 		const scope = this.#options.scope;
-		const nodes = await this.#options.reader.read(scope);
+		const raw = await this.#options.reader.read(scope, capture);
+		const result = Array.isArray(raw) ? { nodes: raw } : raw;
+		const nodes = result.nodes;
+		const images = result.images ?? [];
+		const imagesOmitted = result.imagesOmitted ?? 0;
 		const record = {
 			at: this.#options.now?.() ?? (/* @__PURE__ */ new Date()).toISOString(),
 			include: [...scope.include],
 			exclude: [...scope.exclude ?? []],
-			nodeCount: nodes.length
+			nodeCount: nodes.length,
+			...capture?.images === true ? {
+				images: {
+					src: images.filter((image) => image.level === "src").length,
+					canvas: images.filter((image) => image.level === "canvas").length
+				},
+				imagesOmitted,
+				imageFailures: result.imageFailures ?? 0
+			} : {}
 		};
 		this.#records = [record, ...this.#records].slice(0, 50);
 		for (const listener of this.#listeners) listener(record);
@@ -779,11 +800,18 @@ var PagePerceptionPolicy = class {
 				include: record.include,
 				exclude: record.exclude,
 				nodeCount: record.nodeCount,
-				at: record.at
+				at: record.at,
+				...record.images !== void 0 ? {
+					imageCount: record.images.src + record.images.canvas,
+					imagesOmitted,
+					imageFailures: record.imageFailures
+				} : {}
 			}
 		});
 		return {
 			nodes,
+			images,
+			imagesOmitted,
 			record
 		};
 	}
@@ -844,17 +872,31 @@ function createPagePerceptionToolSource(options) {
 		canHandle: (name) => name === PERCEIVE_PAGE_TOOL,
 		call: async () => {
 			try {
-				const { nodes, record } = await policy.perceive();
+				const budget = await options.imageCapture?.();
+				const capture = {
+					images: budget?.enabled === true,
+					maxImageBytes: budget?.maxImageBytes ?? 0,
+					maxImages: budget?.maxImages ?? 0
+				};
+				const { nodes, images, imagesOmitted, record } = await policy.perceive(capture);
+				const data = {
+					scope: record.include,
+					excluded: record.exclude,
+					nodes
+				};
+				if (imagesOmitted > 0) data["imagesOmitted"] = imagesOmitted;
+				if ((record.imageFailures ?? 0) > 0) data["imageFailures"] = record.imageFailures;
 				return {
 					ok: true,
 					content: [{
 						type: "json",
-						data: {
-							scope: record.include,
-							excluded: record.exclude,
-							nodes
-						}
-					}]
+						data
+					}, ...images.map((image) => ({
+						type: "image",
+						id: image.id,
+						mimeType: image.mimeType,
+						data: image.data
+					}))]
 				};
 			} catch (e) {
 				return toolError("PERCEPTION_FAILED", `perceive_page failed: ${messageOf(e)}`);

package/dist/browser.d.ts

@@ -1,6 +1,6 @@
-import { N as FileStat, O as ArchiveLimits, P as FileSystemProvider, _t as VerifyResult, at as SkillManifest, b as UiBridge, c as InteractionResponse, dt as SkillsLockfile, ht as UnsignedPolicy, l as LlmClient, m as LlmStreamEvent, o as InteractionPolicy, p as LlmResponse, pt as TrustedKeyStore, s as InteractionRequest, tt as SkillInstallSource, u as LlmCompleteInput, vt as WebSkillError, y as RenderResultRequest } from "./types-D_hoCri8-BnNPiZCi.js";
-import { Bt as WebSkillApi, Nt as ToolResult, Ut as bridgeError, W as NetworkPolicy, b as ExternalSkillProvider, d as ApprovalScope, f as BridgeCapabilities, h as BridgeResponse, jt as ToolDefinition, ln as parseBridgeRequest, m as BridgeRequest, vt as ScriptExecutionContext, x as ExternalToolSource, yt as ScriptExecutor } from "./index-vBz_FC9w.js";
-import { S as PerceptionScope, g as PagePerceptionReader, y as PerceivedNode } from "./index-D_7ZZjkl.js";
+import { N as FileStat, O as ArchiveLimits, P as FileSystemProvider, _ as MemoryStore, _t as VerifyResult, at as SkillManifest, b as UiBridge, c as InteractionResponse, dt as SkillsLockfile, ht as UnsignedPolicy, l as LlmClient, m as LlmStreamEvent, o as InteractionPolicy, p as LlmResponse, pt as TrustedKeyStore, s as InteractionRequest, tt as SkillInstallSource, u as LlmCompleteInput, vt as WebSkillError, y as RenderResultRequest } from "./types-4pg-qp_I-Gq63X8Oa.js";
+import { Ct as ScriptExecutionContext, D as ExternalSkillProvider, J as NetworkPolicy, Mn as parseBridgeRequest, O as ExternalToolSource, Ut as ToolResult, Vt as ToolDefinition, _ as BridgeCapabilities, an as WebSkillApi, b as BridgeResponse, f as ApprovalScope, un as bridgeError, wt as ScriptExecutor, y as BridgeRequest } from "./index-C-KFAZoF.js";
+import { C as PerceptionCaptureOptions, E as PerceptionScope, T as PerceptionResult, _ as PagePerceptionReader, x as PerceivedNode } from "./index-BuTpBMzr.js";
 //#region ../browser/dist/index.d.ts
 //#region src/fs/featureDetection.d.ts
 /** 检测当前环境是否可用 OPFS（navigator.storage.getDirectory） */
@@ -331,14 +331,35 @@ declare function checkDictationAvailability(): DictationAvailability;
  */
 declare function startDictation(options: DictationOptions): DictationSession;
 //#endregion
+//#region src/media/compressImage.d.ts
+/** 图片压缩结果；`originalBytes`/`compressedBytes` 供 UI 显示「3.2 MB → 1.8 MB」（FR-11.3 可见性） */
+interface CompressResult {
+  blob: Blob;
+  originalBytes: number;
+  compressedBytes: number;
+  /** 是否发生过缩放（仅降质未缩放时为 false） */
+  scaled: boolean;
+  /** 实际输出所用的 JPEG 质量；未经压缩管线时为 undefined */
+  quality?: number;
+}
+/**
+ * 把图片压到字节预算内（0.6.0 FR-11.3）。
+ * 先逐级降质，仍超限则按长边逐步缩放，最多 5 轮；仍超限抛 `ATTACHMENT_TOO_LARGE`。
+ *
+ * 编码一律交给平台（`OffscreenCanvas.convertToBlob`），不手写编码器（AGENTS.md §6）。
+ * 因此本函数只能在浏览器里用，落在 `@webskill/browser` 而不是 core/runtime（AC-G6）。
+ */
+declare function compressImageToBudget(file: Blob, maxBytes: number): Promise<CompressResult>;
+//#endregion
 //#region src/dom/perception.d.ts
 interface DomPerceptionReaderOptions {
   /** 选择器求值的根；缺省 `globalThis.document` */
   document?: Document;
 }
-/** DOM 遍历是同步的；比 `PagePerceptionReader` 窄，调用方无需 await @experimental */
+/** DOM 遍历是同步的；不取像时比 `PagePerceptionReader` 窄，调用方无需 await @experimental */
 interface DomPerceptionReader extends PagePerceptionReader {
   read(scope: PerceptionScope): readonly PerceivedNode[];
+  read(scope: PerceptionScope, capture: PerceptionCaptureOptions): Promise<PerceptionResult>;
 }
 /**
  * DOM 遍历实现（设计 09 §2 的「实现层」）。产出只有角色 / 名称 / 值，
@@ -350,6 +371,46 @@ interface DomPerceptionReader extends PagePerceptionReader {
  */
 declare function createDomPerceptionReader(options?: DomPerceptionReaderOptions): DomPerceptionReader;
 //#endregion
+//#region src/dom/imageCapture.d.ts
+/**
+ * 取像级别（0.6.0 FR-12.1）。裁决 D-3 已取消 L3 栅格化，只剩两级。
+ * @experimental
+ */
+type CaptureLevel = 'src' | 'canvas';
+/** @experimental */
+interface CapturedImage {
+  id: string;
+  mimeType: string;
+  /** base64，不含 `data:` 前缀 */
+  data: string;
+  level: CaptureLevel;
+  originalBytes: number;
+  /** 压缩后字节数；未压缩时与 `originalBytes` 相同 */
+  bytes: number;
+}
+/** @experimental */
+interface CaptureFailure {
+  id: string;
+  /** 必须说明是哪一级、为什么；只写 "image unavailable" 不足以让用户判断该怎么办 */
+  reason: string;
+  triedLevels: readonly CaptureLevel[];
+}
+/** @experimental */
+declare function isCaptureFailure(result: CapturedImage | CaptureFailure): result is CaptureFailure;
+/** 只有这三种标签能取像；其余元素连取像入口都不进（FR-12.1，由 T-02-15 守门） @experimental */
+declare function isCapturableElement(element: Element): boolean;
+/**
+ * 取一个元素的图像（0.6.0 FR-12.1）。
+ *
+ * 按元素类型分派，不做无意义的尝试：`<img>` 只走 L1，`<canvas>` / `<svg>` 只走 L2，
+ * 两者互不兜底。失败返回 `CaptureFailure` 而不是抛错——一张图抓不到不该让整次感知失败。
+ * @experimental
+ */
+declare function captureElementImage(element: Element, options: {
+  id: string;
+  maxBytes: number;
+}): Promise<CapturedImage | CaptureFailure>;
+//#endregion
 //#region src/host/protocol.d.ts
 /** 主线程 → Worker 的 LLM 配置；mockResponses 供 E2E/测试注入确定性 Mock */
 interface LlmClientConfig {
@@ -521,4 +582,39 @@ declare class WorkerUiBridge implements UiBridge {
   onTextDelta(runId: string, delta: string): Promise<void>;
 }
 //#endregion
-export { type BridgeCapabilities, type BridgeRequest, type BridgeResponse, BrowserSkillManager, BrowserWorkerScriptExecutor, type ChromeBuiltinAvailability, ChromeBuiltinLlmClient, type ConfiguredLlmClient, type DictationAvailability, type DictationOptions, type DictationSession, type DomPerceptionReader, type DomPerceptionReaderOptions, IframeWorkerLike, type LlmClientConfig, type LlmEntryConfig, type MainToWorkerMessage, OpfsProvider, type SandboxMode, type SerializedError, TsTranspiler, type TypeScriptSupportOptions, WORKER_BOOTSTRAP_SOURCE, type WorkerEvent, type WorkerFactory, type WorkerLike, type WorkerRequest, WorkerRuntimeClient, type WorkerRuntimeClientDeps, type WorkerRuntimeHostOverrides, type WorkerScopeLike, WorkerUiBridge, bridgeError, checkDictationAvailability, createDomPerceptionReader, createIframeWorker, createLlmClient, extractZipWeb, installWebSkillNavigator, isOpfsAvailable, parseBridgeRequest, parseMainMessage, parseWorkerEvent, probeChromeBuiltinAvailability, sha256HexWeb, startDictation, startWorkerRuntimeHost };
+//#region src/memory/encryptedMemoryStore.d.ts
+/**
+ * 某条已读出的记忆值是否是密文信封。观测方（如 console）据此决定要不要去取密钥：
+ * 加密关着的时候不该为了读一条明文而凭空建出一把密钥。
+ * @experimental
+ */
+declare function isEncryptedMemoryValue(value: unknown): boolean;
+/**
+ * 用 AES-GCM 包装一个 MemoryStore：值加密后再交给 `inner`，读取时解密。
+ * 密钥不可用（未解锁 / 无 Web Crypto）时**拒绝读写并抛结构化错误**，
+ * 不静默降级成明文——那会让「已加密」的承诺失效而用户无从察觉。
+ *
+ * `scopes` 限定加密范围。默认全加密；宿主通常只加密存放个人数据的
+ * `user:` 作用域，把运行观测（会话参数历史、技能统计）留作明文供 console 读取。
+ * @experimental
+ */
+declare function createEncryptedMemoryStore(inner: MemoryStore, key: CryptoKey | undefined, options?: {
+  scopes?: (scope: string) => boolean;
+}): MemoryStore;
+/**
+ * 生成一把不可导出的 AES-GCM 256 密钥（FR-19.5）。不可导出意味着页面脚本
+ * 拿不到原始字节，只能通过 Web Crypto 使用它；宿主负责持久化这个句柄（如 IndexedDB）。
+ * @experimental
+ */
+declare function generateMemoryEncryptionKey(): Promise<CryptoKey>;
+/**
+ * 取（必要时生成）本地数据加密密钥并持久化在 IndexedDB（FR-19.5）。
+ * 存的是 `CryptoKey` 句柄本身而不是密钥字节：结构化克隆能存它，
+ * 而它是 non-extractable 的，页面脚本与扩展都读不出原始字节。
+ * @experimental
+ */
+declare function openMemoryEncryptionKey(name?: string): Promise<CryptoKey>;
+/** 删除本地数据加密密钥；清除画像与记录时一并调用，避免留下解不开的旧密文 @experimental */
+declare function deleteMemoryEncryptionKey(name?: string): Promise<void>;
+//#endregion
+export { type BridgeCapabilities, type BridgeRequest, type BridgeResponse, BrowserSkillManager, BrowserWorkerScriptExecutor, type CaptureFailure, type CaptureLevel, type CapturedImage, type ChromeBuiltinAvailability, ChromeBuiltinLlmClient, type CompressResult, type ConfiguredLlmClient, type DictationAvailability, type DictationOptions, type DictationSession, type DomPerceptionReader, type DomPerceptionReaderOptions, IframeWorkerLike, type LlmClientConfig, type LlmEntryConfig, type MainToWorkerMessage, OpfsProvider, type SandboxMode, type SerializedError, TsTranspiler, type TypeScriptSupportOptions, WORKER_BOOTSTRAP_SOURCE, type WorkerEvent, type WorkerFactory, type WorkerLike, type WorkerRequest, WorkerRuntimeClient, type WorkerRuntimeClientDeps, type WorkerRuntimeHostOverrides, type WorkerScopeLike, WorkerUiBridge, bridgeError, captureElementImage, checkDictationAvailability, compressImageToBudget, createDomPerceptionReader, createEncryptedMemoryStore, createIframeWorker, createLlmClient, deleteMemoryEncryptionKey, extractZipWeb, generateMemoryEncryptionKey, installWebSkillNavigator, isCapturableElement, isCaptureFailure, isEncryptedMemoryValue, isOpfsAvailable, openMemoryEncryptionKey, parseBridgeRequest, parseMainMessage, parseWorkerEvent, probeChromeBuiltinAvailability, sha256HexWeb, startDictation, startWorkerRuntimeHost };