@webskill/sdk 0.5.0 → 0.6.0

package/dist/{env--jJB-TSX-04klhTYi.js → env-8cY40DXB-CGnEVZby.js}

@@ -1,6 +1,6 @@
 import { readFileSync } from "node:fs";
 
-//#region ../node/dist/env--jJB-TSX.js
+//#region ../node/dist/env-8cY40DXB.js
 /** 解析 .env（简单 KEY=VALUE 行解析，不引依赖）；文件缺失返回 undefined */
 function readEnvVars(dotenvPath) {
 	let raw;
@@ -23,15 +23,16 @@ function readEnvVars(dotenvPath) {
 	return vars;
 }
 /**
-* 读取 LLM_BASE_URL / LLM_API_KEY / LLM_MODEL（优先），
-* 向后兼容 VITE_BASE_URL / VITE_API_KEY / VITE_MODEL_NAME；缺项返回 undefined 供测试 skip 判断。
+* 读取 LLM_BASE_URL / LLM_API_KEY / LLM_MODEL；缺项返回 undefined 供测试 skip 判断。
+* 0.6.0 FR-13.2 移除了旧的 `VITE_` 前缀回退：该前缀是 Vite 向**客户端 bundle** 注入变量的开关，
+* 把 API key 放在它名下等于告诉使用者“这个 key 会被打进前端产物”。
 */
 function loadLlmConfigFromEnv(dotenvPath = ".env") {
 	const vars = readEnvVars(dotenvPath);
 	if (!vars) return void 0;
-	const baseUrl = vars.get("LLM_BASE_URL") ?? vars.get("VITE_BASE_URL");
-	const apiKey = vars.get("LLM_API_KEY") ?? vars.get("VITE_API_KEY");
-	const model = vars.get("LLM_MODEL") ?? vars.get("VITE_MODEL_NAME");
+	const baseUrl = vars.get("LLM_BASE_URL");
+	const apiKey = vars.get("LLM_API_KEY");
+	const model = vars.get("LLM_MODEL");
 	if (!baseUrl || !apiKey || !model) return void 0;
 	return {
 		baseUrl,

package/dist/{env-BPUBZCwJ-4jat_SVG.d.ts → env-AK3cSMEA-Dli6QU5E.d.ts}

@@ -1,4 +1,4 @@
-//#region ../node/dist/env-BPUBZCwJ.d.ts
+//#region ../node/dist/env-AK3cSMEA.d.ts
 //#region src/env.d.ts
 interface LlmEnvConfig {
   baseUrl: string;
@@ -12,8 +12,9 @@ interface ProviderEnvConfig {
   baseUrl?: string;
 }
 /**
- * 读取 LLM_BASE_URL / LLM_API_KEY / LLM_MODEL（优先），
- * 向后兼容 VITE_BASE_URL / VITE_API_KEY / VITE_MODEL_NAME；缺项返回 undefined 供测试 skip 判断。
+ * 读取 LLM_BASE_URL / LLM_API_KEY / LLM_MODEL；缺项返回 undefined 供测试 skip 判断。
+ * 0.6.0 FR-13.2 移除了旧的 `VITE_` 前缀回退：该前缀是 Vite 向**客户端 bundle** 注入变量的开关，
+ * 把 API key 放在它名下等于告诉使用者“这个 key 会被打进前端产物”。
  */
 declare function loadLlmConfigFromEnv(dotenvPath?: string): LlmEnvConfig | undefined;
 /** ANTHROPIC_API_KEY / ANTHROPIC_MODEL（可选 ANTHROPIC_BASE_URL）；缺项返回 undefined */

package/dist/governance.d.ts

@@ -1,6 +1,6 @@
-import { B as PageQuery, P as FileSystemProvider, Q as SkillCatalogEntry, b as UiBridge, et as SkillDocument, f as LlmMessage, it as SkillManagerPort, l as LlmClient, z as Page } from "./types-D_hoCri8-BnNPiZCi.js";
-import { Et as SkillOutcomeReporter, L as IntegrityVerdict, Ot as SkillStateGuard, Tt as SkillIntegrityGuard, Vt as WebSkillRuntime, pt as RuntimeRun } from "./index-vBz_FC9w.js";
-import { _ as SkillVersion, a as AuditLog, c as CandidateFile, d as CandidateSource, f as CandidateStatus, g as SkillState, h as SKILL_VERSION_PAGE_SIZE, i as AuditEvent, l as CandidateRisk, m as CompositeApprovalPolicy, n as ApprovalDecision, o as AuditQueryFilter, p as CandidateStore, r as ApprovalPolicy, s as CANDIDATE_PAGE_SIZE, t as AlwaysHumanApprovalPolicy, u as CandidateSkill, v as SkillVersionStore, y as candidateToCatalogEntry } from "./skillVersionStore-BzLbzFOL-CxwIewHJ.js";
+import { B as PageQuery, P as FileSystemProvider, Q as SkillCatalogEntry, b as UiBridge, et as SkillDocument, f as LlmMessage, it as SkillManagerPort, l as LlmClient, z as Page } from "./types-4pg-qp_I-Gq63X8Oa.js";
+import { It as SkillStateGuard, Mt as SkillOutcomeReporter, V as IntegrityVerdict, jt as SkillIntegrityGuard, on as WebSkillRuntime, vt as RuntimeRun } from "./index-C-KFAZoF.js";
+import { _ as SkillVersion, a as AuditLog, c as CandidateFile, d as CandidateSource, f as CandidateStatus, g as SkillState, h as SKILL_VERSION_PAGE_SIZE, i as AuditEvent, l as CandidateRisk, m as CompositeApprovalPolicy, n as ApprovalDecision, o as AuditQueryFilter, p as CandidateStore, r as ApprovalPolicy, s as CANDIDATE_PAGE_SIZE, t as AlwaysHumanApprovalPolicy, u as CandidateSkill, v as SkillVersionStore, y as candidateToCatalogEntry } from "./skillVersionStore-BzLbzFOL-CxdAFWO2.js";
 //#region ../governance/dist/index.d.ts
 //#region src/candidate/candidateNormalizer.d.ts
 /** 剥 markdown fence 与 <think> 块、截取首尾 {}；非对象 → CANDIDATE_INVALID */

package/dist/governance.js

@@ -1,5 +1,5 @@
 import { O as messageOf, T as isValidSkillName, g as assertSafePathSegment, m as WebSkillError } from "./dist-8oQRa8Xz.js";
-import { i as textParts, n as partsToText } from "./memoryArtifactStore-BtOeB_hm-tj3fC5ip.js";
+import { a as textParts, n as partsToText } from "./memoryArtifactStore-52Zn9npI-BMPYwvoy.js";
 
 //#region ../governance/dist/index.js
 const invalid = (message, details) => {

package/dist/{index-Bsqg4ftU.d.ts → index-BMocOEi0.d.ts}

@@ -1,11 +1,11 @@
-import { I as JsonSchema, T as UiSpecSnapshot, b as UiBridge, c as InteractionResponse, mt as UiSpecNode, r as ChartSpec, s as InteractionRequest, v as RenderBlock, x as UiSpecActionCapability, y as RenderResultRequest } from "./types-D_hoCri8-BnNPiZCi.js";
-import { x as ExternalToolSource } from "./index-vBz_FC9w.js";
+import { I as JsonSchema, T as UiSpecSnapshot, b as UiBridge, c as InteractionResponse, mt as UiSpecNode, r as ChartSpec, s as InteractionRequest, v as RenderBlock, x as UiSpecActionCapability, y as RenderResultRequest } from "./types-4pg-qp_I-Gq63X8Oa.js";
+import { O as ExternalToolSource } from "./index-C-KFAZoF.js";
 import { z } from "zod";
 import { ComponentType, ReactNode } from "react";
 //#region ../ui/dist/index.d.ts
 //#region src/model/formModel.d.ts
 interface FormModel {
-  kind: 'ask' | 'confirm' | 'form' | 'select' | 'authorize';
+  kind: 'ask' | 'confirm' | 'form' | 'select' | 'authorize' | 'file-pick';
   title?: string;
   message?: string;
   controls: ControlModel[];
@@ -15,7 +15,7 @@ interface FormModel {
 interface ControlModel {
   name: string;
   label: string;
-  control: 'text' | 'number' | 'boolean' | 'select' | 'textarea';
+  control: 'text' | 'number' | 'boolean' | 'select' | 'textarea' | 'file';
   required?: boolean;
   description?: string;
   defaultValue?: unknown;
@@ -23,14 +23,17 @@ interface ControlModel {
     label: string;
     value: unknown;
   }>;
+  /** 传给 `input.accept` 的类型列表（仅 file 控件） */
+  accept?: readonly string[];
+  multiple?: boolean;
   /**
-   * 上次填写值（FR-5.9）。与 `defaultValue` 严格分开：渲染器只能把它展示为建议，
+   * 建议值（FR-19.4）。与 `defaultValue` 严格分开：渲染器只能把它展示为建议，
    * 用户主动采纳后才能进控件。
    * @experimental
    */
   suggestion?: {
     value: unknown;
-    ts: number;
+    reason?: string;
   };
 }
 /** 提交值按请求类型归形（WebFormBridge 与框架组件库共享单一来源） */
@@ -67,7 +70,10 @@ declare function applySuggestion(control: ControlModel, container: ParentNode):
 declare function renderMiniMarkdown(text: string, doc: Document): HTMLElement;
 //#endregion
 //#region src/chart/miniChart.d.ts
-/** 固定 8 色循环调色板 */
+/**
+ * 固定 8 色循环调色板。这是**数据编码**（区分序列），不是主题色；
+ * 图表的轴线与文字等“外壳”颜色走 currentColor，跟随宿主容器的主题。
+ */
 declare const CHART_PALETTE: readonly ["#4e79a7", "#f28e2b", "#e15759", "#76b7b2", "#59a14f", "#edc948", "#b07aa1", "#ff9da7"];
 /**
  * ChartSpec → SVG（bar 等宽柱 + 值标签；line 折线 + 点；pie 扇形 + 图例；空数据容错）

package/dist/{index-D_7ZZjkl.d.ts → index-BuTpBMzr.d.ts}

@@ -1,5 +1,5 @@
-import { a as InteractionOrigin, b as UiBridge } from "./types-D_hoCri8-BnNPiZCi.js";
-import { x as ExternalToolSource } from "./index-vBz_FC9w.js";
+import { a as InteractionOrigin, b as UiBridge } from "./types-4pg-qp_I-Gq63X8Oa.js";
+import { O as ExternalToolSource } from "./index-C-KFAZoF.js";
 //#region ../agent/dist/index.d.ts
 //#region src/todo/types.d.ts
 /** 待办条目状态：未开始 / 进行中 / 已完成（FR-3.1） */
@@ -165,6 +165,9 @@ declare function createSkillGenerationToolSource(options: SkillGenerationToolSou
 /**
  * 技能自动生成的系统提示词。默认不注册工具，因此这段提示词只在
  * 宿主打开开关时才进入上下文（设计 02 §1.3）。
+ *
+ * 触发条件写成正面清单而不是「不要自发调用」（0.6.0 FR-18.5）：实测中后者会连
+ * 「帮我写一份流程规范」这类明确的沉淀请求一起抑制掉，开关等于白开。
  */
 declare const SKILL_GENERATION_SYSTEM_PROMPT: string;
 //#endregion
@@ -312,8 +315,46 @@ interface PerceivedNode {
   name?: string;
   /** 仅非敏感控件的当前值 */
   value?: string;
+  /** 关联的图像分片 id（FR-12.1）；节点里只放 id 不放 base64，否则 JSON 树会被截断切碎 */
+  imageId?: string;
+  /** 取像失败的降级说明（英文）；不得静默丢弃（FR-12.1） */
+  imageNote?: string;
   children?: readonly PerceivedNode[];
 }
+/** 随感知一起下发的一张图像（FR-12.1） @experimental */
+interface PerceivedImage {
+  /** 与 `PerceivedNode.imageId` 对应 */
+  id: string;
+  mimeType: string;
+  /** base64，不含 `data:` 前缀 */
+  data: string;
+  /** 取像级别：`src` 为原图字节，`canvas` 为画布/SVG 读回 */
+  level: 'src' | 'canvas';
+}
+/**
+ * 取像预算与开关（FR-12.3 / FR-12.5）。
+ * 它只能来自宿主配置与当前模型能力，**不包含任何范围字段**：
+ * “读哪里”仍只由构造时的 `scope` 决定（AC-10.8）。
+ * @experimental
+ */
+interface PerceptionCaptureOptions {
+  /** false 时 reader 不得进入任何取像分支（抓完再丢弃不可接受） */
+  images: boolean;
+  maxImageBytes: number;
+  maxImages: number;
+}
+/**
+ * reader 的完整产物。只实现文本的 reader 可以继续返回节点数组。
+ * @experimental
+ */
+interface PerceptionResult {
+  nodes: readonly PerceivedNode[];
+  images?: readonly PerceivedImage[];
+  /** 超出 `maxImages` 而未下发的张数 */
+  imagesOmitted?: number;
+  /** 取像失败的张数；失败不影响整次感知的成功与否 */
+  imageFailures?: number;
+}
 /**
  * 页面读取实现的注入口（浏览器侧 `createDomPerceptionReader`）。
  *
@@ -322,7 +363,7 @@ interface PerceivedNode {
  * @experimental
  */
 interface PagePerceptionReader {
-  read(scope: PerceptionScope): Promise<readonly PerceivedNode[]> | readonly PerceivedNode[];
+  read(scope: PerceptionScope, capture?: PerceptionCaptureOptions): Promise<readonly PerceivedNode[] | PerceptionResult> | readonly PerceivedNode[] | PerceptionResult;
 }
 /** 一次感知的留痕（FR-10.5 的 UI 提示与 FR-10.6 的审计共用同一条记录） @experimental */
 interface PerceptionRecord {
@@ -333,6 +374,14 @@ interface PerceptionRecord {
   exclude: readonly string[];
   /** 读到的顶层节点数；用于「它读的比我预期的多」这类判断 */
   nodeCount: number;
+  /** 本次下发的图像张数，按取像级别分组（只在取像开启时存在） */
+  images?: {
+    src: number;
+    canvas: number;
+  };
+  imagesOmitted?: number;
+  /** 读取失败的张数；藏起来会让用户误以为模型看到了全部图片 */
+  imageFailures?: number;
 }
 /**
  * 审计落盘端口。刻意只声明 `append` 的结构化子集，`FsAuditLog` 直接满足——
@@ -361,9 +410,10 @@ interface PagePerceptionPolicyOptions {
 /**
  * 页面只读感知策略（需求 10）。
  *
- * **`perceive()` 不接受任何参数**——这是「白名单判定不受模型输出影响」
+ * **`perceive()` 不接受任何范围参数**——这是「白名单判定不受模型输出影响」
  * （AC-10.8）的实现方式。不是先拿模型给的范围再去校验，而是模型压根没有
  * 表达范围的入口：能被读的区域只由构造时的 `scope` 决定。
+ * 唯一的参数是取像预算（`PerceptionCaptureOptions`），它里面没有任何范围字段。
  *
  * 本类**没有**任何点击 / 输入 / 提交 / 导航 / 滚动方法（FR-10.7）。
  * @experimental
@@ -378,8 +428,10 @@ declare class PagePerceptionPolicy {
   get records(): readonly PerceptionRecord[];
   /** FR-10.5：感知发生时通知 UI，chatbot 据此在消息流里标注一行 */
   subscribe(listener: (record: PerceptionRecord) => void): () => void;
-  perceive(): Promise<{
+  perceive(capture?: PerceptionCaptureOptions): Promise<{
     nodes: readonly PerceivedNode[];
+    images: readonly PerceivedImage[];
+    imagesOmitted: number;
     record: PerceptionRecord;
   }>;
 }
@@ -388,6 +440,17 @@ declare class PagePerceptionPolicy {
 declare const PERCEIVE_PAGE_TOOL = "perceive_page";
 interface PagePerceptionToolSourceOptions {
   policy: PagePerceptionPolicy;
+  /**
+   * 取像预算与开关（FR-12.5）。每次调用重取，设置或选中模型改完立刻生效；
+   * 缺省即不取像。判定在遍历 DOM **之前**完成一次，不是每个节点判一次。
+   */
+  imageCapture?(): ImageCaptureBudget | Promise<ImageCaptureBudget>;
+}
+/** @experimental */
+interface ImageCaptureBudget {
+  enabled: boolean;
+  maxImageBytes: number;
+  maxImages: number;
 }
 /**
  * 把只读感知接到既有工具协议上。**本工具源不导出任何写入动作**（FR-10.7）：
@@ -408,4 +471,4 @@ declare function createPagePerceptionToolSource(options: PagePerceptionToolSourc
  */
 declare const PERCEPTION_SYSTEM_PROMPT: string;
 //#endregion
-export { SubAgentRunInput as A, createDelegationToolSource as B, SKILL_GENERATION_SYSTEM_PROMPT as C, SkillGenerationToolSourceOptions as D, SkillGenerationPolicy as E, TodoList as F, createSkillGenerationToolSource as H, TodoListener as I, TodoStatus as L, TODO_SYSTEM_PROMPT as M, TodoEvent as N, SkillGenerator as O, TodoItem as P, TodoStore as R, PerceptionScope as S, SkillGenerationOutcome as T, createTodoToolSource as U, createPagePerceptionToolSource as V, withDelegationOrigin as W, PagePerceptionToolSourceOptions as _, DelegationOrchestratorOptions as a, PerceptionAuditSink as b, DelegationToolSourceOptions as c, MANAGE_TODO_TOOL as d, PERCEIVE_PAGE_TOOL as f, PagePerceptionReader as g, PagePerceptionPolicyOptions as h, DelegationOrchestrator as i, SubAgentRunner as j, SkillGeneratorOptions as k, GENERATE_SKILL_TOOL as l, PagePerceptionPolicy as m, DELEGATION_SYSTEM_PROMPT as n, DelegationRequest as o, PERCEPTION_SYSTEM_PROMPT as p, DelegationBudget as r, DelegationResult as s, DELEGATE_TASK_TOOL as t, GeneratedSkillDraft as u, ParentBudget as v, SkillCandidateSink as w, PerceptionRecord as x, PerceivedNode as y, TodoToolSourceOptions as z };
+export { SkillGenerationPolicy as A, TodoListener as B, PerceptionCaptureOptions as C, SKILL_GENERATION_SYSTEM_PROMPT as D, PerceptionScope as E, SubAgentRunner as F, createPagePerceptionToolSource as G, TodoStore as H, TODO_SYSTEM_PROMPT as I, withDelegationOrigin as J, createSkillGenerationToolSource as K, TodoEvent as L, SkillGenerator as M, SkillGeneratorOptions as N, SkillCandidateSink as O, SubAgentRunInput as P, TodoItem as R, PerceptionAuditSink as S, PerceptionResult as T, TodoToolSourceOptions as U, TodoStatus as V, createDelegationToolSource as W, PagePerceptionReader as _, DelegationOrchestratorOptions as a, PerceivedImage as b, DelegationToolSourceOptions as c, ImageCaptureBudget as d, MANAGE_TODO_TOOL as f, PagePerceptionPolicyOptions as g, PagePerceptionPolicy as h, DelegationOrchestrator as i, SkillGenerationToolSourceOptions as j, SkillGenerationOutcome as k, GENERATE_SKILL_TOOL as l, PERCEPTION_SYSTEM_PROMPT as m, DELEGATION_SYSTEM_PROMPT as n, DelegationRequest as o, PERCEIVE_PAGE_TOOL as p, createTodoToolSource as q, DelegationBudget as r, DelegationResult as s, DELEGATE_TASK_TOOL as t, GeneratedSkillDraft as u, PagePerceptionToolSourceOptions as v, PerceptionRecord as w, PerceivedNode as x, ParentBudget as y, TodoList as z };