@webskill/sdk 0.9.0 → 0.10.0

package/dist/mcp.d.ts

@@ -1,5 +1,5 @@
-import { at as SkillDocument, g as LlmToolSpec, rt as SkillCatalogEntry, z as JsonSchema } from "./types-B3n0cMZu-BDhheIhX.js";
-import { O as ExternalSkillProvider, Pn as mergeCatalogEntries, Yt as ToolResult, k as ExternalToolSource } from "./index-znZjobkr.js";
+import { B as JsonSchema, _ as LlmToolSpec, it as SkillCatalogEntry, ot as SkillDocument } from "./types-CrRcT-LM-DZAp8sWv.js";
+import { Fn as mergeCatalogEntries, O as ExternalSkillProvider, Xt as ToolResult, k as ExternalToolSource } from "./index-DtFdMKBX.js";
 import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
 import { JSONRPCMessage } from "@modelcontextprotocol/sdk/types.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -264,6 +264,19 @@ declare class ExperimentalWebMcpAdapter {
 }
 //#endregion
 //#region src/plugin/mcpRuntimePlugin.d.ts
+/**
+ * 工具可见性策略（0.10.0 UI-UX5 #50.3）：端点禁用 ∨ 工具禁用 ⇒ 不进 LLM tool spec，
+ * 调用侧同样拦截（模型找不到这些工具）。各判定缺省视为启用。
+ * 回调每次 listToolSpecs/call 实时求值，宿主改状态不需要重建插件。
+ */
+interface McpToolVisibility {
+  /** 端点级开关；返回 false 时该端点所有工具对大模型不可见 */
+  isEndpointEnabled?(endpoint: string): boolean;
+  /** 端点工具级开关；返回 false 时该工具对大模型不可见 */
+  isEndpointToolEnabled?(endpoint: string, tool: string): boolean;
+  /** WebMCP 工具级开关；返回 false 时该工具对大模型不可见 */
+  isWebMcpToolEnabled?(tool: string): boolean;
+}
 /**
  * runtime 扩展点实现：endpoint 注册表 + WebMCP adapter 一处装配。
  * LLM 可见名：endpoint__tool / mcp__tool；call 时反向映射。
@@ -275,6 +288,8 @@ declare class McpRuntimePlugin implements ExternalToolSource {
     registry: EndpointRegistry<McpClientLike>;
     webMcp?: ExperimentalWebMcpAdapter;
     resolver?: McpToolResolver;
+    /** 工具可见性策略（端点/工具级启停）；缺省全部可见 */
+    visibility?: McpToolVisibility;
     /** 已知的 endpoint 名（注销后仍按 MCP_ENDPOINT_UNAVAILABLE 响应，而非 TOOL_NOT_FOUND） */
     endpoints?: string[];
     /** endpoint 不可用时的告警出口（默认 console.warn） */
@@ -428,4 +443,4 @@ interface RemoteEndpointHandle {
  */
 declare function connectRemoteEndpoint(registry: EndpointRegistry<McpClientLike>, config: RemoteEndpointConfig): Promise<RemoteEndpointHandle>;
 //#endregion
-export { type BrowserModelContextLike, EndpointRegistry, ExperimentalWebMcpAdapter, type McpClientLike, type McpOAuthClient, type McpOAuthConfig, type McpOAuthHandshake, type McpOAuthHandshakeStore, type McpOAuthProvider, type McpOAuthStage, type McpOAuthTokenStore, type McpOAuthTokens, McpRuntimePlugin, McpToolResolver, MessageChannelTransport, type MessageChannelTransportOptions, type MessagePortLike, type RemoteEndpointConfig, type RemoteEndpointHandle, type ServedSkill, TemporarySkillProvider, type TransportState, type WebMcpToolDescriptor, type WebMcpToolLike, catalogMerge, connectRemoteEndpoint, createMemoryOAuthStores, createOAuthProvider, endpointToolLlmName, parseEndpointToolLlmName, parseWebMcpToolLlmName, serveSkillAsMcp, validateJsonRpcMessage, webMcpToolLlmName };
+export { type BrowserModelContextLike, EndpointRegistry, ExperimentalWebMcpAdapter, type McpClientLike, type McpOAuthClient, type McpOAuthConfig, type McpOAuthHandshake, type McpOAuthHandshakeStore, type McpOAuthProvider, type McpOAuthStage, type McpOAuthTokenStore, type McpOAuthTokens, McpRuntimePlugin, McpToolResolver, type McpToolVisibility, MessageChannelTransport, type MessageChannelTransportOptions, type MessagePortLike, type RemoteEndpointConfig, type RemoteEndpointHandle, type ServedSkill, TemporarySkillProvider, type TransportState, type WebMcpToolDescriptor, type WebMcpToolLike, catalogMerge, connectRemoteEndpoint, createMemoryOAuthStores, createOAuthProvider, endpointToolLlmName, parseEndpointToolLlmName, parseWebMcpToolLlmName, serveSkillAsMcp, validateJsonRpcMessage, webMcpToolLlmName };

package/dist/mcp.js

@@ -1,5 +1,5 @@
 import { M as messageOf, g as assertRemoteUrlAllowed, h as WebSkillError } from "./dist-Bev6i6Ip.js";
-import { it as mergeCatalogEntries, lt as normalizeToolContent } from "./dist-CFmkV45C.js";
+import { it as mergeCatalogEntries, lt as normalizeToolContent } from "./dist-BViUeszk.js";
 
 //#region ../mcp/dist/index.js
 /**
@@ -501,6 +501,14 @@ var ExperimentalWebMcpAdapter = class {
 		}
 	}
 };
+const disabledResult = (llmToolName) => ({
+	ok: false,
+	content: [],
+	error: {
+		code: "MCP_TOOL_DISABLED",
+		message: `Tool "${llmToolName}" is disabled`
+	}
+});
 /**
 * runtime 扩展点实现：endpoint 注册表 + WebMCP adapter 一处装配。
 * LLM 可见名：endpoint__tool / mcp__tool；call 时反向映射。
@@ -510,43 +518,71 @@ var McpRuntimePlugin = class {
 	#registry;
 	#resolver;
 	#webMcp;
+	#visibility;
 	#configuredEndpoints;
 	#onWarning;
 	constructor(deps) {
 		this.#registry = deps.registry;
 		this.#resolver = deps.resolver ?? new McpToolResolver(deps.registry);
 		this.#webMcp = deps.webMcp;
+		this.#visibility = deps.visibility;
 		this.#configuredEndpoints = deps.endpoints ?? [];
 		this.#onWarning = deps.onWarning ?? ((message) => console.warn(message));
 	}
 	#endpoints() {
 		return [.../* @__PURE__ */ new Set([...this.#configuredEndpoints, ...this.#registry.endpoints()])];
 	}
+	/** 端点级可见性：未接策略或判定非 false 即启用 */
+	#endpointEnabled(endpoint) {
+		return this.#visible(() => this.#visibility?.isEndpointEnabled?.(endpoint));
+	}
+	/**
+	* 可见性回调统一求值：宿主注入的回调抛异常时按「放行 + 告警」处理。
+	* 可见性不是安全闸门（安全由审批链兜底），异常关闭会让整轮工具集消失、
+	* 模型转而幻觉；放行代价更小，但必须走 onWarning，否则宿主回调 bug 被静默吞掉。
+	*/
+	#visible(probe) {
+		try {
+			return probe() !== false;
+		} catch (e) {
+			this.#onWarning(`[webskill] MCP visibility callback failed; treating as enabled: ${e instanceof Error ? e.message : String(e)}`);
+			return true;
+		}
+	}
 	async listToolSpecs() {
 		const specs = [];
-		for (const endpoint of this.#endpoints()) try {
-			const { tools } = await this.#registry.get(endpoint).listTools();
-			for (const tool of tools) specs.push({
-				name: endpointToolLlmName(endpoint, tool.name),
-				...tool.description ? { description: `[${endpoint}] ${tool.description}` } : {},
-				inputSchema: typeof tool.inputSchema === "object" && tool.inputSchema !== null ? tool.inputSchema : {
-					type: "object",
-					properties: {}
+		for (const endpoint of this.#endpoints()) {
+			if (!this.#endpointEnabled(endpoint)) continue;
+			try {
+				const { tools } = await this.#registry.get(endpoint).listTools();
+				for (const tool of tools) {
+					if (!this.#visible(() => this.#visibility?.isEndpointToolEnabled?.(endpoint, tool.name))) continue;
+					specs.push({
+						name: endpointToolLlmName(endpoint, tool.name),
+						...tool.description ? { description: `[${endpoint}] ${tool.description}` } : {},
+						inputSchema: typeof tool.inputSchema === "object" && tool.inputSchema !== null ? tool.inputSchema : {
+							type: "object",
+							properties: {}
+						}
+					});
 				}
-			});
-		} catch (e) {
-			this.#onWarning(`[webskill] MCP endpoint "${endpoint}" is unavailable; its tools are omitted from this turn: ${e instanceof Error ? e.message : String(e)}`);
+			} catch (e) {
+				this.#onWarning(`[webskill] MCP endpoint "${endpoint}" is unavailable; its tools are omitted from this turn: ${e instanceof Error ? e.message : String(e)}`);
+			}
 		}
 		if (this.#webMcp?.isEnabled()) {
 			const tools = await this.#webMcp.listTools();
-			for (const tool of tools ?? []) specs.push({
-				name: webMcpToolLlmName(tool.name),
-				description: tool.description ?? `[webmcp] ${tool.name}`,
-				inputSchema: typeof tool.inputSchema === "object" && tool.inputSchema !== null ? tool.inputSchema : {
-					type: "object",
-					properties: {}
-				}
-			});
+			for (const tool of tools ?? []) {
+				if (!this.#visible(() => this.#visibility?.isWebMcpToolEnabled?.(tool.name))) continue;
+				specs.push({
+					name: webMcpToolLlmName(tool.name),
+					description: tool.description ?? `[webmcp] ${tool.name}`,
+					inputSchema: typeof tool.inputSchema === "object" && tool.inputSchema !== null ? tool.inputSchema : {
+						type: "object",
+						properties: {}
+					}
+				});
+			}
 		}
 		return specs;
 	}
@@ -565,11 +601,16 @@ var McpRuntimePlugin = class {
 					message: "WebMCP adapter is not configured"
 				}
 			};
+			if (!this.#visible(() => this.#visibility?.isWebMcpToolEnabled?.(webMcpTool))) return disabledResult(llmToolName);
 			return this.#webMcp.call(webMcpTool, args);
 		}
 		for (const endpoint of this.#endpoints()) {
 			const toolName = parseEndpointToolLlmName(endpoint, llmToolName);
-			if (toolName !== void 0) return this.#resolver.call(endpoint, toolName, args);
+			if (toolName !== void 0) {
+				if (!this.#endpointEnabled(endpoint)) return disabledResult(llmToolName);
+				if (!this.#visible(() => this.#visibility?.isEndpointToolEnabled?.(endpoint, toolName))) return disabledResult(llmToolName);
+				return this.#resolver.call(endpoint, toolName, args);
+			}
 		}
 		return {
 			ok: false,

package/dist/node.d.ts

@@ -1,6 +1,6 @@
-import { I as FileStat, K as SKILLS_LOCKFILE, L as FileSystemProvider, Q as SignatureAuditSink, St as VerifyResult, bt as UnsignedPolicy, c as InteractionResponse, gt as SkillsLockfile, j as ArchiveLimits, lt as SkillManagerPort, ot as SkillInstallSource, q as SKILL_MANIFEST_FILE, s as InteractionRequest, ut as SkillManifest, vt as TrustedKeyStore, x as UiBridge, y as RenderResultRequest, z as JsonSchema } from "./types-B3n0cMZu-BDhheIhX.js";
-import { Et as ScriptExecutor, M as FsMemoryStore, Tt as ScriptExecutionContext, Y as NetworkPolicy, Yt as ToolResult, _ as BridgeCapabilities, f as ApprovalScope, j as FsArtifactStore, mn as WebSkillRuntimeDeps, pn as WebSkillRuntime, qt as ToolDefinition, wt as SchemaInferer, yn as createScriptContext } from "./index-znZjobkr.js";
-import { a as AuditLog, p as CandidateStore, r as ApprovalPolicy, u as CandidateSkill, v as SkillVersionStore } from "./skillVersionStore-Bl-ElD45-dMJ8Ybhb.js";
+import { $ as SignatureAuditSink, B as JsonSchema, Ct as VerifyResult, J as SKILL_MANIFEST_FILE, L as FileStat, M as ArchiveLimits, R as FileSystemProvider, S as UiBridge, _t as SkillsLockfile, b as RenderResultRequest, c as InteractionResponse, dt as SkillManifest, q as SKILLS_LOCKFILE, s as InteractionRequest, st as SkillInstallSource, ut as SkillManagerPort, xt as UnsignedPolicy, yt as TrustedKeyStore } from "./types-CrRcT-LM-DZAp8sWv.js";
+import { Dt as ScriptExecutor, Et as ScriptExecutionContext, Jt as ToolDefinition, M as FsMemoryStore, Tt as SchemaInferer, Xt as ToolResult, Y as NetworkPolicy, _ as BridgeCapabilities, bn as createScriptContext, f as ApprovalScope, hn as WebSkillRuntimeDeps, j as FsArtifactStore, mn as WebSkillRuntime } from "./index-DtFdMKBX.js";
+import { a as AuditLog, b as SkillVersionStore, d as CandidateSkill, m as CandidateStore, r as ApprovalPolicy } from "./skillVersionStore-D-qHk9ZE-DBsYYCWn.js";
 import { n as LlmEnvConfig, s as probeLlmCapabilities, t as LlmCapabilities } from "./env-AK3cSMEA-Dli6QU5E.js";
 import { Readable, Writable } from "node:stream";
 //#region ../node/dist/index.d.ts

package/dist/node.js

@@ -1,7 +1,7 @@
 import { B as resolveArchiveLimits, D as exportSkills, F as parseSkillPackManifest, G as unzipWithLimits, I as readResponseWithLimit, J as verifySkillSignature, K as validateSkills, L as readSkillSignature, M as messageOf, O as isAtomicTempPath, P as parseSkillMarkdown, V as resolveInsideRoot, _ as assertSafePathSegment, b as buildManifest, c as SKILL_MANIFEST_FILE, d as SKILL_PACK_FILE, g as assertRemoteUrlAllowed, h as WebSkillError, i as MANIFEST_EXCLUDED_FILES, k as isValidSkillName, q as verifyManifest, s as SKILLS_LOCKFILE, v as atomicWriteText } from "./dist-Bev6i6Ip.js";
-import { B as bridgeError, H as createScriptContext, L as WebSkillRuntime, c as CapabilityApproval, dt as parseBridgeRequest, h as FsMemoryStore, lt as normalizeToolContent, m as FsArtifactStore, ot as networkPolicyLibSource, ut as normalizeToolError } from "./dist-CFmkV45C.js";
+import { B as bridgeError, H as createScriptContext, L as WebSkillRuntime, c as CapabilityApproval, dt as parseBridgeRequest, h as FsMemoryStore, lt as normalizeToolContent, m as FsArtifactStore, ot as networkPolicyLibSource, ut as normalizeToolError } from "./dist-BViUeszk.js";
 import { i as probeLlmCapabilities } from "./env-8cY40DXB-CGnEVZby.js";
-import { t as AUDIT_EVENT_TYPES } from "./eventTypes-DbOpAECr-BjcjZVms.js";
+import { t as AUDIT_EVENT_TYPES } from "./eventTypes-s2uwAcLG-Go3l_dUe.js";
 import { createRequire } from "node:module";
 import { unzipSync, zipSync } from "fflate";
 import { existsSync, promises, realpathSync } from "node:fs";

package/dist/{openUiLibrary-DURlAxjk-Do_yqg3u.js → openUiLibrary-CIrV--Ad-B8zG_91e.js}

@@ -1,5 +1,5 @@
-import { ft as uiCatalog } from "./dist-BQe1uglQ.js";
-import { t as CatalogNode } from "./catalogComponents-DfxxfUvn-T7Ic8QFV.js";
+import { ft as uiCatalog } from "./dist-1OFC-zax.js";
+import { t as CatalogNode } from "./catalogComponents-DTcYfpLQ-CcoOaz-Z.js";
 import { z } from "zod";
 import { Component, Fragment, createContext, useCallback, useContext, useEffect, useInsertionEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -3761,7 +3761,7 @@ function Renderer({ response, library, isStreaming = false, onAction, onStateUpd
 const FormValidationContext = createContext(null);
 
 //#endregion
-//#region ../ui-react/dist/openUiLibrary-DURlAxjk.js
+//#region ../ui-react/dist/openUiLibrary-CIrV--Ad.js
 const propsFor = (props, container) => container ? props.extend({ children: z.array(z.any()).optional() }) : props;
 /**
 * catalog 的 OpenUI 投影：`defineComponent` 复用同一份 zod schema 与描述，

package/dist/{skillVersionStore-Bl-ElD45-dMJ8Ybhb.d.ts → skillVersionStore-D-qHk9ZE-DBsYYCWn.d.ts}

@@ -1,5 +1,5 @@
-import { H as Page, L as FileSystemProvider, U as PageQuery, rt as SkillCatalogEntry, ut as SkillManifest } from "./types-B3n0cMZu-BDhheIhX.js";
-//#region ../governance/dist/skillVersionStore-Bl-ElD45.d.ts
+import { R as FileSystemProvider, U as Page, W as PageQuery, dt as SkillManifest, it as SkillCatalogEntry } from "./types-CrRcT-LM-DZAp8sWv.js";
+//#region ../governance/dist/skillVersionStore-D-qHk9ZE.d.ts
 //#region src/types.d.ts
 type CandidateStatus = 'draft' | 'pending-review' | 'approved' | 'published' | 'rejected';
 /** `generated` 是 0.5.0 的技能自动生成来源（需求 12 号 AC-9.1） */
@@ -84,6 +84,10 @@ type SkillState = 'active' | 'quarantined' | 'deprecated' | 'disabled';
 //#region src/candidate/candidateStore.d.ts
 /** 候选列表的缺省页长。缺省属于实现，不属于调用方 */
 declare const CANDIDATE_PAGE_SIZE = 50;
+/** 候选分页结果：`total` 为筛选后匹配总数（0.10.0 UI-UX5 #40.12，页码分页的总页数依据） @stable */
+interface CandidatePage extends Page<CandidateSkill> {
+  total: number;
+}
 /** 逐文件持久化的候选存储：<managedRoot>/.webskill/candidates/<id>.json */
 declare class CandidateStore {
   #private;
@@ -100,7 +104,7 @@ declare class CandidateStore {
    */
   list(options?: {
     status?: CandidateStatus;
-  } & PageQuery): Promise<Page<CandidateSkill>>;
+  } & PageQuery): Promise<CandidatePage>;
   updateStatus(id: string, status: CandidateStatus, now?: string): Promise<CandidateSkill>;
 }
 /** 硬门禁：仅 published 可转换为 Catalog 条目，否则 APPROVAL_REQUIRED */
@@ -128,6 +132,10 @@ declare class CompositeApprovalPolicy implements ApprovalPolicy {
 //#region src/versioning/skillVersionStore.d.ts
 /** 版本列表的缺省页长。缺省属于实现，不属于调用方 */
 declare const SKILL_VERSION_PAGE_SIZE = 20;
+/** 版本分页结果：`total` 为该技能版本总数（0.10.0 UI-UX5 #40.12，页码分页的总页数依据） @stable */
+interface SkillVersionPage extends Page<SkillVersion> {
+  total: number;
+}
 /** 版本存储：manifest 快照 + parentVersionId 链；回滚 = 追加新版本（谱系不断）。
  *  保留策略：maxArchivesPerSkill（默认 5）超出时清理最旧版本（json + zip 归档一并删除）。 */
 declare class SkillVersionStore {
@@ -153,7 +161,7 @@ declare class SkillVersionStore {
    * 版本列表分页（方向同 C1：无游标给**最新**一页）。
    * 保留策略与谱系构建走 `#readAll`：它们必须看到全量，不能被分页截断。
    */
-  list(skillName: string, options?: PageQuery): Promise<Page<SkillVersion>>;
+  list(skillName: string, options?: PageQuery): Promise<SkillVersionPage>;
   get(skillName: string, versionId: string): Promise<SkillVersion>;
   /** 回滚：基于旧 manifest 追加新版本 + skill.rolled_back 审计 */
   rollback(skillName: string, targetVersionId: string, input: {
@@ -162,4 +170,4 @@ declare class SkillVersionStore {
   }): Promise<SkillVersion>;
 }
 //#endregion
-export { SkillVersion as _, AuditLog as a, CandidateFile as c, CandidateSource as d, CandidateStatus as f, SkillState as g, SKILL_VERSION_PAGE_SIZE as h, AuditEvent as i, CandidateRisk as l, CompositeApprovalPolicy as m, ApprovalDecision as n, AuditQueryFilter as o, CandidateStore as p, ApprovalPolicy as r, CANDIDATE_PAGE_SIZE as s, AlwaysHumanApprovalPolicy as t, CandidateSkill as u, SkillVersionStore as v, candidateToCatalogEntry as y };
+export { SkillState as _, AuditLog as a, SkillVersionStore as b, CandidateFile as c, CandidateSkill as d, CandidateSource as f, SKILL_VERSION_PAGE_SIZE as g, CompositeApprovalPolicy as h, AuditEvent as i, CandidatePage as l, CandidateStore as m, ApprovalDecision as n, AuditQueryFilter as o, CandidateStatus as p, ApprovalPolicy as r, CANDIDATE_PAGE_SIZE as s, AlwaysHumanApprovalPolicy as t, CandidateRisk as u, SkillVersion as v, candidateToCatalogEntry as x, SkillVersionPage as y };

package/dist/{testing-Csg5ljNm.js → testing-WPTyXQYt.js}

@@ -23,13 +23,21 @@ var MockLlmClient = class {
 		if ("stream" in next) {
 			const events = typeof next.stream === "function" ? next.stream(input) : next.stream;
 			let content = "";
+			let thinking = "";
 			let toolCalls;
+			let usage;
 			for (const event of events) if (event.type === "text-delta") content += event.delta;
+			else if (event.type === "thinking-delta") thinking += event.delta;
 			else if (event.type === "tool-calls") toolCalls = event.toolCalls;
-			else if (event.type === "done" && event.content !== void 0) content = event.content;
+			else if (event.type === "done") {
+				if (event.content !== void 0) content = event.content;
+				if (event.usage !== void 0) usage = event.usage;
+			}
 			return {
 				content: content === "" ? void 0 : textParts(content),
-				toolCalls
+				toolCalls,
+				...thinking === "" ? {} : { thinking },
+				...usage ? { usage } : {}
 			};
 		}
 		return next;
@@ -44,6 +52,18 @@ var MockLlmClient = class {
 			return;
 		}
 		const response = typeof next === "function" ? await next(input) : next;
+		if (response.thinking !== void 0 && response.thinking !== "") {
+			const half = Math.ceil(response.thinking.length / 2);
+			yield {
+				type: "thinking-delta",
+				delta: response.thinking.slice(0, half)
+			};
+			const rest = response.thinking.slice(half);
+			if (rest !== "") yield {
+				type: "thinking-delta",
+				delta: rest
+			};
+		}
 		const text = partsToText(response.content);
 		if (text !== "") {
 			const chunkSize = Math.max(1, Math.ceil(text.length / 3));
@@ -56,7 +76,10 @@ var MockLlmClient = class {
 			type: "tool-calls",
 			toolCalls: response.toolCalls
 		};
-		yield { type: "done" };
+		yield {
+			type: "done",
+			...response.usage ? { usage: response.usage } : {}
+		};
 	}
 };
 /**

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { _ as MemoryStore, c as InteractionResponse, l as LlmClient, m as LlmStreamEvent, n as ArtifactStore, p as LlmResponse, s as InteractionRequest, t as Artifact, u as LlmCompleteInput, x as UiBridge } from "./types-B3n0cMZu-BDhheIhX.js";
+import { S as UiBridge, c as InteractionResponse, l as LlmClient, m as LlmStreamEvent, n as ArtifactStore, p as LlmResponse, s as InteractionRequest, t as Artifact, u as LlmCompleteInput, v as MemoryStore } from "./types-CrRcT-LM-DZAp8sWv.js";
 import { a as loadGoogleConfigFromEnv, i as loadAnthropicConfigFromEnv, n as LlmEnvConfig, o as loadLlmConfigFromEnv, r as ProviderEnvConfig } from "./env-AK3cSMEA-Dli6QU5E.js";
 //#region ../runtime/dist/testing.d.ts
 //#region src/llm/mockLlmClient.d.ts

package/dist/testing.js

@@ -1,5 +1,5 @@
 import { t as MemoryArtifactStore } from "./memoryArtifactStore-52Zn9npI-LbCQaqyx.js";
 import { n as loadGoogleConfigFromEnv, r as loadLlmConfigFromEnv, t as loadAnthropicConfigFromEnv } from "./env-8cY40DXB-CGnEVZby.js";
-import { n as MockLlmClient, r as MockUiBridge, t as InMemoryStore } from "./testing-Csg5ljNm.js";
+import { n as MockLlmClient, r as MockUiBridge, t as InMemoryStore } from "./testing-WPTyXQYt.js";
 
 export { InMemoryStore, MemoryArtifactStore, MockLlmClient, MockUiBridge, loadAnthropicConfigFromEnv, loadGoogleConfigFromEnv, loadLlmConfigFromEnv };

package/dist/{types-B3n0cMZu-BDhheIhX.d.ts → types-CrRcT-LM-DZAp8sWv.d.ts}

@@ -629,18 +629,34 @@ declare function escapeXml(text: string): string;
 declare function renderAvailableSkillsXml(catalog: SkillCatalog): string;
 declare const xmlRenderer: CatalogRenderer;
 //#endregion
-//#region ../runtime/dist/types-B3n0cMZu.d.ts
+//#region ../runtime/dist/types-CrRcT-LM.d.ts
 //#region src/llm/streamTypes.d.ts
 /** 流式 LLM 事件（OpenAI SSE / Vercel fullStream 统一映射） */
 type LlmStreamEvent = {
   type: 'text-delta';
   delta: string;
+} | {
+  /**
+   * 思考增量（Anthropic thinking_delta / OpenAI 兼容 reasoning_content /
+   * Vercel reasoning-delta 统一映射）。模型不产出思考时一个事件也没有——
+   * 消费方据「有没有收到」决定要不要渲染思考区，不做空壳入口。
+   */
+  type: 'thinking-delta';
+  delta: string;
 } | {
   type: 'tool-calls';
   toolCalls: LlmToolCall[];
-} | {
+} |
+/**
+ * 流收尾。`usage`（0.10.0 UI-UX5 #47）：本次调用的 token 用量，
+ * 各家适配层在末段汇总后随 done 下发（Anthropic message_start/message_delta、
+ * OpenAI include_usage 末段 chunk、Vercel finish 的 totalUsage 统一映射）；
+ * 上游不回报时缺省——消费方据「有没有」决定要不要展示，不显示假数据。
+ */
+{
   type: 'done';
   content?: string;
+  usage?: LlmTokenUsage;
 };
 //#endregion
 //#region src/llm/types.d.ts
@@ -681,9 +697,26 @@ interface LlmToolCall {
   /** 流式拼接后的 arguments 不是合法 JSON 时的错误描述；设置时 arguments 不可信 */
   argumentsParseError?: string;
 }
+/**
+ * 一次模型调用的 token 用量（0.10.0 UI-UX5 #47）。
+ * 上游不回报 usage 时整个字段缺省——不填 0 冒充「已知为零」，
+ * 消费方据「有没有」决定要不要展示，不显示假数据。
+ * @stable
+ */
+interface LlmTokenUsage {
+  inputTokens: number;
+  outputTokens: number;
+}
 interface LlmResponse {
   content?: LlmContentPart[];
   toolCalls?: LlmToolCall[];
+  /**
+   * 本轮模型产出的思考正文（Anthropic thinking blocks / reasoning_content 等）。
+   * 不进消息历史、不回喂模型；只用于运行细节展示与 trace。
+   */
+  thinking?: string;
+  /** 本轮 token 用量（上游回报才有；chrome-builtin 等无 usage 能力的客户端缺省） */
+  usage?: LlmTokenUsage;
   raw?: unknown;
 }
 interface LlmCompleteInput {
@@ -1017,4 +1050,4 @@ interface MemoryStore {
   transaction?<T>(scope: string, fn: (inner: MemoryStore) => Promise<T>): Promise<T>;
 }
 //#endregion
-export { SignatureVerdict as $, stripArchiveRoot as $t, ATOMIC_TMP_SUFFIX_PATTERN as A, checkDependencyCycles as At, MANIFEST_EXCLUDED_FILES as B, keyIdOf as Bt, UiSpecDrafts as C, WebSkillError as Ct, UiSurfaceActionRequest as D, atomicWriteText as Dt, UiSpecSnapshot as E, assertSafePathSegment as Et, DiscoveryResult as F, escapeXml as Ft, SIGNATURE_SCHEMA_VERSION as G, readResponseWithLimit as Gt, Page as H, normalizePath as Ht, FileStat as I, exportSkills as It, SKILL_NAME_MAX_LENGTH as J, renderCatalogJson as Jt, SKILLS_LOCKFILE as K, readSkillSignature as Kt, FileSystemProvider as L, isAtomicTempPath as Lt, CatalogRenderer as M, computeDigest as Mt, CryptoKeyLike as N, detectSkillArchiveShape as Nt, UiSurfaceActionResponse as O, buildCatalog as Ot, DEFAULT_ARCHIVE_LIMITS as P, detectSkillArchiveShapeFromFs as Pt, SignatureAuditSink as Q, signaturePayloadBytes as Qt, FsTrustedKeyStore as R, isValidSkillName as Rt, UiSpecActionCapability as S, VerifyResult as St, UiSpecPatch as T, assertRemoteUrlAllowed as Tt, PageQuery as U, parseSkillMarkdown as Ut, MemoryFS as V, messageOf as Vt, RemoteUrlPolicy as W, parseSkillPackManifest as Wt, SKILL_PACK_FILE as X, resolveInsideRoot as Xt, SKILL_NAME_PATTERN as Y, resolveArchiveLimits as Yt, SKILL_SIGNATURE_FILE as Z, signSkill as Zt, MemoryStore as _, TrustedKey as _t, InteractionOrigin as a, SkillDocument as at, SkillCandidateMarker as b, UnsignedPolicy as bt, InteractionResponse as c, SkillLocation as ct, LlmContentPart as d, SkillMetadata as dt, unzipWithLimits as en, SkillArchiveDetection as et, LlmMessage as f, SkillPackManifest as ft, LlmToolSpec as g, SkillsLockfile as gt, LlmToolCall as h, SkillSource as ht, FormField as i, xmlRenderer as in, SkillDiscovery as it, ArchiveLimits as j, checkSkillRules as jt, extractSkillCandidate as k, buildManifest as kt, LlmClient as l, SkillManagerPort as lt, LlmStreamEvent as m, SkillSignature as mt, ArtifactStore as n, verifyManifest as nn, SkillCatalog as nt, InteractionPolicy as o, SkillInstallSource as ot, LlmResponse as p, SkillReader as pt, SKILL_MANIFEST_FILE as q, renderAvailableSkillsXml as qt, ChartSpec as r, verifySkillSignature as rn, SkillCatalogEntry as rt, InteractionRequest as s, SkillIssue as st, Artifact as t, validateSkills as tn, SkillArchiveShape as tt, LlmCompleteInput as u, SkillManifest as ut, RenderBlock as v, TrustedKeyStore as vt, UiSpecEvent as w, WebSkillErrorCode as wt, UiBridge as x, ValidationReport as xt, RenderResultRequest as y, UiSpecNode as yt, JsonSchema as z, jsonRenderer as zt };
+export { SignatureAuditSink as $, signaturePayloadBytes as $t, extractSkillCandidate as A, buildManifest as At, JsonSchema as B, jsonRenderer as Bt, UiSpecActionCapability as C, VerifyResult as Ct, UiSpecSnapshot as D, assertSafePathSegment as Dt, UiSpecPatch as E, assertRemoteUrlAllowed as Et, DEFAULT_ARCHIVE_LIMITS as F, detectSkillArchiveShapeFromFs as Ft, RemoteUrlPolicy as G, parseSkillPackManifest as Gt, MemoryFS as H, messageOf as Ht, DiscoveryResult as I, escapeXml as It, SKILL_MANIFEST_FILE as J, renderAvailableSkillsXml as Jt, SIGNATURE_SCHEMA_VERSION as K, readResponseWithLimit as Kt, FileStat as L, exportSkills as Lt, ArchiveLimits as M, checkSkillRules as Mt, CatalogRenderer as N, computeDigest as Nt, UiSurfaceActionRequest as O, atomicWriteText as Ot, CryptoKeyLike as P, detectSkillArchiveShape as Pt, SKILL_SIGNATURE_FILE as Q, signSkill as Qt, FileSystemProvider as R, isAtomicTempPath as Rt, UiBridge as S, ValidationReport as St, UiSpecEvent as T, WebSkillErrorCode as Tt, Page as U, normalizePath as Ut, MANIFEST_EXCLUDED_FILES as V, keyIdOf as Vt, PageQuery as W, parseSkillMarkdown as Wt, SKILL_NAME_PATTERN as X, resolveArchiveLimits as Xt, SKILL_NAME_MAX_LENGTH as Y, renderCatalogJson as Yt, SKILL_PACK_FILE as Z, resolveInsideRoot as Zt, LlmToolSpec as _, SkillsLockfile as _t, InteractionOrigin as a, xmlRenderer as an, SkillDiscovery as at, RenderResultRequest as b, UiSpecNode as bt, InteractionResponse as c, SkillIssue as ct, LlmContentPart as d, SkillManifest as dt, stripArchiveRoot as en, SignatureVerdict as et, LlmMessage as f, SkillMetadata as ft, LlmToolCall as g, SkillSource as gt, LlmTokenUsage as h, SkillSignature as ht, FormField as i, verifySkillSignature as in, SkillCatalogEntry as it, ATOMIC_TMP_SUFFIX_PATTERN as j, checkDependencyCycles as jt, UiSurfaceActionResponse as k, buildCatalog as kt, LlmClient as l, SkillLocation as lt, LlmStreamEvent as m, SkillReader as mt, ArtifactStore as n, validateSkills as nn, SkillArchiveShape as nt, InteractionPolicy as o, SkillDocument as ot, LlmResponse as p, SkillPackManifest as pt, SKILLS_LOCKFILE as q, readSkillSignature as qt, ChartSpec as r, verifyManifest as rn, SkillCatalog as rt, InteractionRequest as s, SkillInstallSource as st, Artifact as t, unzipWithLimits as tn, SkillArchiveDetection as tt, LlmCompleteInput as u, SkillManagerPort as ut, MemoryStore as v, TrustedKey as vt, UiSpecDrafts as w, WebSkillError as wt, SkillCandidateMarker as x, UnsignedPolicy as xt, RenderBlock as y, TrustedKeyStore as yt, FsTrustedKeyStore as z, isValidSkillName as zt };

package/dist/ui-react.d.ts

@@ -1,5 +1,5 @@
-import { C as UiSpecDrafts, D as UiSurfaceActionRequest, E as UiSpecSnapshot, O as UiSurfaceActionResponse, S as UiSpecActionCapability, c as InteractionResponse, s as InteractionRequest, w as UiSpecEvent, x as UiBridge, y as RenderResultRequest, yt as UiSpecNode } from "./types-B3n0cMZu-BDhheIhX.js";
-import { E as InteractionSpecLabels, R as SurfaceFormTexts } from "./index-DXNTIa-6.js";
+import { C as UiSpecActionCapability, D as UiSpecSnapshot, O as UiSurfaceActionRequest, S as UiBridge, T as UiSpecEvent, b as RenderResultRequest, bt as UiSpecNode, c as InteractionResponse, k as UiSurfaceActionResponse, s as InteractionRequest, w as UiSpecDrafts } from "./types-CrRcT-LM-DZAp8sWv.js";
+import { E as InteractionSpecLabels, R as SurfaceFormTexts } from "./index-B0QPLWPZ.js";
 import { z } from "zod";
 import React$1, { ComponentType, ReactNode } from "react";
 import "react/jsx-runtime";
@@ -253,6 +253,15 @@ declare class UiSurfaceStore {
   subscribe: (listener: () => void) => (() => void);
   get snapshots(): readonly UiSpecSnapshot[];
   apply(event: UiSpecEvent): void;
+  /**
+   * 表单 surface 提交成功后，把提交值回写为 Field 的 `defaultValue`（UI-UX5 #15）：
+   * run 结束后界面用持久化快照重放，初值只认 defaultValue——不回写，
+   * 只读回看就看不到用户当时选/填了什么。
+   * 只写标量；字段名全树唯一才写（多表单同名字段无法判定归属，宁可不写也不写错）。
+   * 0.10.0 复核注记：multi-select 的数组值不会回写，属已知限制——重放里
+   * 多选项字段仍显示初值；标量优先的取舍保留。
+   */
+  applySubmittedValues(surfaceId: string, values: Record<string, unknown>): void;
 }
 //#endregion
 //#region src/bridgeState.d.ts