@webskill/sdk 0.4.0 → 0.5.0

package/dist/index.js

@@ -1,5 +1,5 @@
 import { A as parseSkillMarkdown, B as unzipWithLimits, C as escapeXml, D as keyIdOf, E as jsonRenderer, F as renderCatalogJson, H as verifyManifest, I as resolveArchiveLimits, L as resolveInsideRoot, M as readResponseWithLimit, N as readSkillSignature, O as messageOf, P as renderAvailableSkillsXml, R as signSkill, S as computeDigest, T as isValidSkillName, U as verifySkillSignature, V as validateSkills, W as xmlRenderer, _ as atomicWriteText, a as SIGNATURE_SCHEMA_VERSION, b as checkDependencyCycles, c as SKILL_NAME_MAX_LENGTH, d as SKILL_SIGNATURE_FILE, f as SkillDiscovery, g as assertSafePathSegment, h as assertRemoteUrlAllowed, i as MemoryFS, j as parseSkillPackManifest, k as normalizePath, l as SKILL_NAME_PATTERN, m as WebSkillError, n as FsTrustedKeyStore, o as SKILLS_LOCKFILE, p as SkillReader, r as MANIFEST_EXCLUDED_FILES, s as SKILL_MANIFEST_FILE, t as DEFAULT_ARCHIVE_LIMITS, u as SKILL_PACK_FILE, v as buildCatalog, w as exportSkills, x as checkSkillRules, y as buildManifest, z as signaturePayloadBytes } from "./dist-8oQRa8Xz.js";
 import { i as textParts, n as partsToText } from "./memoryArtifactStore-BtOeB_hm-tj3fC5ip.js";
-import { A as createScriptContext, B as networkUrlHost, C as RUN_TRACE_SCHEMA_VERSION, D as WebSkillRuntime, E as TraceRecorder, F as fromVercelStreamPart, G as resolveToolName, H as normalizeToolContent, I as isNetworkAllowed, J as toLlmToolSpec, K as schemaToForm, L as isUnsupportedRunSnapshot, M as extractChartSpec, N as extractUiSpecEvents, O as bridgeError, P as fromVercelResult, R as mergeCatalogEntries, S as RUN_SNAPSHOT_SCHEMA_VERSION, T as SerializingMemoryStore, U as normalizeToolError, V as normalizeErrorCode, W as parseBridgeRequest, X as validateUiSpecEvent, Y as toVercelToolSpecs, Z as validateUiSpecNode, _ as OpenAiCompatibleClient, a as AnthropicClient, b as READ_SKILL_FILE_TOOL, c as FS_SESSION_PAGE_SIZE, d as FsRunSnapshotStore, f as FsRunTraceStore, g as HookRunner, h as GoogleGenAiClient, i as AgentLoop, j as createWebSkillApi, k as buildRenderResult, l as FsArtifactStore, m as FullDisclosureRouter, n as ASK_USER_TOOL, o as CapabilityApproval, p as FsSessionStore, q as summarizeToolCalls, r as ASK_USER_TOOL_NAME, s as EventBus, t as ASK_USER_INPUT_SCHEMA, u as FsMemoryStore, v as ProgressiveRouter, w as SESSION_SCHEMA_VERSION, x as READ_SKILL_FILE_TOOL_NAME, y as READ_SKILL_FILE_INPUT_SCHEMA, z as networkPolicyLibSource } from "./dist-C-Sh0MDU.js";
+import { $ as schemaToForm, A as buildRenderResult, B as fromVercelStreamPart, C as RUN_SNAPSHOT_SCHEMA_VERSION, D as TraceRecorder, E as SerializingMemoryStore, F as extractChartSpec, G as networkUrlHost, H as isUnsupportedRunSnapshot, I as extractTodoTraceEvents, J as normalizeToolError, K as normalizeErrorCode, L as extractUiSpecEvents, M as clearStoredFormValues, N as createScriptContext, O as WebSkillRuntime, P as createWebSkillApi, Q as resolveToolName, R as formFieldKey, S as READ_SKILL_FILE_TOOL_NAME, T as SESSION_SCHEMA_VERSION, U as mergeCatalogEntries, V as isNetworkAllowed, W as networkPolicyLibSource, X as putFormValues, Y as parseBridgeRequest, Z as readFormValues, _ as HookRunner, a as AnthropicClient, b as READ_SKILL_FILE_INPUT_SCHEMA, c as FORM_VALUES_KEY, d as FsMemoryStore, et as summarizeToolCalls, f as FsRunSnapshotStore, g as GoogleGenAiClient, h as FullDisclosureRouter, i as AgentLoop, it as validateUiSpecNode, j as clearFormValues, k as bridgeError, l as FS_SESSION_PAGE_SIZE, m as FsSessionStore, n as ASK_USER_TOOL, nt as toVercelToolSpecs, o as CapabilityApproval, p as FsRunTraceStore, q as normalizeToolContent, r as ASK_USER_TOOL_NAME, rt as validateUiSpecEvent, s as EventBus, t as ASK_USER_INPUT_SCHEMA, tt as toLlmToolSpec, u as FsArtifactStore, v as OpenAiCompatibleClient, w as RUN_TRACE_SCHEMA_VERSION, x as READ_SKILL_FILE_TOOL, y as ProgressiveRouter, z as fromVercelResult } from "./dist-6C03DShK.js";
 
-export { ASK_USER_INPUT_SCHEMA, ASK_USER_TOOL, ASK_USER_TOOL_NAME, AgentLoop, AnthropicClient, CapabilityApproval, DEFAULT_ARCHIVE_LIMITS, EventBus, FS_SESSION_PAGE_SIZE, FsArtifactStore, FsMemoryStore, FsRunSnapshotStore, FsRunTraceStore, FsSessionStore, FsTrustedKeyStore, FullDisclosureRouter, GoogleGenAiClient, HookRunner, MANIFEST_EXCLUDED_FILES, MemoryFS, OpenAiCompatibleClient, ProgressiveRouter, READ_SKILL_FILE_INPUT_SCHEMA, READ_SKILL_FILE_TOOL, READ_SKILL_FILE_TOOL_NAME, RUN_SNAPSHOT_SCHEMA_VERSION, RUN_TRACE_SCHEMA_VERSION, SESSION_SCHEMA_VERSION, SIGNATURE_SCHEMA_VERSION, SKILLS_LOCKFILE, SKILL_MANIFEST_FILE, SKILL_NAME_MAX_LENGTH, SKILL_NAME_PATTERN, SKILL_PACK_FILE, SKILL_SIGNATURE_FILE, SerializingMemoryStore, SkillDiscovery, SkillReader, TraceRecorder, WebSkillError, WebSkillRuntime, assertRemoteUrlAllowed, assertSafePathSegment, atomicWriteText, bridgeError, buildCatalog, buildManifest, buildRenderResult, checkDependencyCycles, checkSkillRules, computeDigest, createScriptContext, createWebSkillApi, escapeXml, exportSkills, extractChartSpec, extractUiSpecEvents, fromVercelResult, fromVercelStreamPart, isNetworkAllowed, isUnsupportedRunSnapshot, isValidSkillName, jsonRenderer, keyIdOf, mergeCatalogEntries, messageOf, networkPolicyLibSource, networkUrlHost, normalizeErrorCode, normalizePath, normalizeToolContent, normalizeToolError, parseBridgeRequest, parseSkillMarkdown, parseSkillPackManifest, partsToText, readResponseWithLimit, readSkillSignature, renderAvailableSkillsXml, renderCatalogJson, resolveArchiveLimits, resolveInsideRoot, resolveToolName, schemaToForm, signSkill, signaturePayloadBytes, summarizeToolCalls, textParts, toLlmToolSpec, toVercelToolSpecs, unzipWithLimits, validateSkills, validateUiSpecEvent, validateUiSpecNode, verifyManifest, verifySkillSignature, xmlRenderer };
+export { ASK_USER_INPUT_SCHEMA, ASK_USER_TOOL, ASK_USER_TOOL_NAME, AgentLoop, AnthropicClient, CapabilityApproval, DEFAULT_ARCHIVE_LIMITS, EventBus, FORM_VALUES_KEY, FS_SESSION_PAGE_SIZE, FsArtifactStore, FsMemoryStore, FsRunSnapshotStore, FsRunTraceStore, FsSessionStore, FsTrustedKeyStore, FullDisclosureRouter, GoogleGenAiClient, HookRunner, MANIFEST_EXCLUDED_FILES, MemoryFS, OpenAiCompatibleClient, ProgressiveRouter, READ_SKILL_FILE_INPUT_SCHEMA, READ_SKILL_FILE_TOOL, READ_SKILL_FILE_TOOL_NAME, RUN_SNAPSHOT_SCHEMA_VERSION, RUN_TRACE_SCHEMA_VERSION, SESSION_SCHEMA_VERSION, SIGNATURE_SCHEMA_VERSION, SKILLS_LOCKFILE, SKILL_MANIFEST_FILE, SKILL_NAME_MAX_LENGTH, SKILL_NAME_PATTERN, SKILL_PACK_FILE, SKILL_SIGNATURE_FILE, SerializingMemoryStore, SkillDiscovery, SkillReader, TraceRecorder, WebSkillError, WebSkillRuntime, assertRemoteUrlAllowed, assertSafePathSegment, atomicWriteText, bridgeError, buildCatalog, buildManifest, buildRenderResult, checkDependencyCycles, checkSkillRules, clearFormValues, clearStoredFormValues, computeDigest, createScriptContext, createWebSkillApi, escapeXml, exportSkills, extractChartSpec, extractTodoTraceEvents, extractUiSpecEvents, formFieldKey, fromVercelResult, fromVercelStreamPart, isNetworkAllowed, isUnsupportedRunSnapshot, isValidSkillName, jsonRenderer, keyIdOf, mergeCatalogEntries, messageOf, networkPolicyLibSource, networkUrlHost, normalizeErrorCode, normalizePath, normalizeToolContent, normalizeToolError, parseBridgeRequest, parseSkillMarkdown, parseSkillPackManifest, partsToText, putFormValues, readFormValues, readResponseWithLimit, readSkillSignature, renderAvailableSkillsXml, renderCatalogJson, resolveArchiveLimits, resolveInsideRoot, resolveToolName, schemaToForm, signSkill, signaturePayloadBytes, summarizeToolCalls, textParts, toLlmToolSpec, toVercelToolSpecs, unzipWithLimits, validateSkills, validateUiSpecEvent, validateUiSpecNode, verifyManifest, verifySkillSignature, xmlRenderer };

package/dist/mcp.d.ts

@@ -1,5 +1,5 @@
-import { $ as SkillDocument, F as JsonSchema, Z as SkillCatalogEntry, h as LlmToolSpec } from "./types-7Wcg--Vh-1YlQ4jF9.js";
-import { Yt as mergeCatalogEntries, b as ExternalSkillProvider, kt as ToolResult, x as ExternalToolSource } from "./index-DLfR2Y6I.js";
+import { I as JsonSchema, Q as SkillCatalogEntry, et as SkillDocument, g as LlmToolSpec } from "./types-D_hoCri8-BnNPiZCi.js";
+import { Nt as ToolResult, b as ExternalSkillProvider, rn as mergeCatalogEntries, x as ExternalToolSource } from "./index-vBz_FC9w.js";
 import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
 import { JSONRPCMessage } from "@modelcontextprotocol/sdk/types.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

package/dist/mcp.js

@@ -1,5 +1,5 @@
 import { O as messageOf, h as assertRemoteUrlAllowed, m as WebSkillError } from "./dist-8oQRa8Xz.js";
-import { H as normalizeToolContent, R as mergeCatalogEntries } from "./dist-C-Sh0MDU.js";
+import { U as mergeCatalogEntries, q as normalizeToolContent } from "./dist-6C03DShK.js";
 
 //#region ../mcp/dist/index.js
 /**

package/dist/node.d.ts

@@ -1,6 +1,6 @@
-import { D as ArchiveLimits, F as JsonSchema, H as SKILLS_LOCKFILE, J as SignatureAuditSink, M as FileStat, N as FileSystemProvider, U as SKILL_MANIFEST_FILE, et as SkillInstallSource, ft as TrustedKeyStore, gt as VerifyResult, it as SkillManifest, mt as UnsignedPolicy, o as InteractionRequest, rt as SkillManagerPort, s as InteractionResponse, ut as SkillsLockfile, v as RenderResultRequest, y as UiBridge } from "./types-7Wcg--Vh-1YlQ4jF9.js";
-import { C as FsArtifactStore, Dt as ToolDefinition, Lt as WebSkillRuntime, Rt as WebSkillRuntimeDeps, V as NetworkPolicy, Vt as createScriptContext, d as ApprovalScope, f as BridgeCapabilities, gt as ScriptExecutor, ht as ScriptExecutionContext, kt as ToolResult, mt as SchemaInferer, w as FsMemoryStore } from "./index-DLfR2Y6I.js";
-import { a as AuditLog, p as CandidateStore, r as ApprovalPolicy, u as CandidateSkill, v as SkillVersionStore } from "./skillVersionStore-uyefLPR1-DXOzbksv.js";
+import { I as JsonSchema, N as FileStat, O as ArchiveLimits, P as FileSystemProvider, U as SKILLS_LOCKFILE, W as SKILL_MANIFEST_FILE, Y as SignatureAuditSink, _t as VerifyResult, at as SkillManifest, b as UiBridge, c as InteractionResponse, dt as SkillsLockfile, ht as UnsignedPolicy, it as SkillManagerPort, pt as TrustedKeyStore, s as InteractionRequest, tt as SkillInstallSource, y as RenderResultRequest } from "./types-D_hoCri8-BnNPiZCi.js";
+import { D as FsMemoryStore, E as FsArtifactStore, Ht as WebSkillRuntimeDeps, Nt as ToolResult, Vt as WebSkillRuntime, W as NetworkPolicy, _t as SchemaInferer, d as ApprovalScope, f as BridgeCapabilities, jt as ToolDefinition, qt as createScriptContext, vt as ScriptExecutionContext, yt as ScriptExecutor } from "./index-vBz_FC9w.js";
+import { a as AuditLog, p as CandidateStore, r as ApprovalPolicy, u as CandidateSkill, v as SkillVersionStore } from "./skillVersionStore-BzLbzFOL-CxwIewHJ.js";
 import { n as LlmEnvConfig, s as probeLlmCapabilities, t as LlmCapabilities } from "./env-BPUBZCwJ-4jat_SVG.js";
 import { Readable, Writable } from "node:stream";
 //#region ../node/dist/index.d.ts

package/dist/node.js

@@ -1,5 +1,5 @@
 import { A as parseSkillMarkdown, B as unzipWithLimits, H as verifyManifest, I as resolveArchiveLimits, L as resolveInsideRoot, M as readResponseWithLimit, N as readSkillSignature, O as messageOf, T as isValidSkillName, U as verifySkillSignature, V as validateSkills, _ as atomicWriteText, g as assertSafePathSegment, h as assertRemoteUrlAllowed, j as parseSkillPackManifest, m as WebSkillError, o as SKILLS_LOCKFILE, r as MANIFEST_EXCLUDED_FILES, s as SKILL_MANIFEST_FILE, u as SKILL_PACK_FILE, w as exportSkills, y as buildManifest } from "./dist-8oQRa8Xz.js";
-import { A as createScriptContext, D as WebSkillRuntime, H as normalizeToolContent, O as bridgeError, U as normalizeToolError, W as parseBridgeRequest, l as FsArtifactStore, o as CapabilityApproval, u as FsMemoryStore, z as networkPolicyLibSource } from "./dist-C-Sh0MDU.js";
+import { J as normalizeToolError, N as createScriptContext, O as WebSkillRuntime, W as networkPolicyLibSource, Y as parseBridgeRequest, d as FsMemoryStore, k as bridgeError, o as CapabilityApproval, q as normalizeToolContent, u as FsArtifactStore } from "./dist-6C03DShK.js";
 import { i as probeLlmCapabilities } from "./env--jJB-TSX-04klhTYi.js";
 import { createRequire } from "node:module";
 import { unzipSync, zipSync } from "fflate";

package/dist/{openUiLibrary-YLS-cxyT-C96jWDQq.js → openUiLibrary-W3Ce896k-ClFTRZFs.js}

@@ -1,5 +1,5 @@
-import { q as uiCatalog } from "./dist-D9Lcn5Pp.js";
-import { t as CatalogNode } from "./catalogComponents-KsujmL4b-Clx1kCnU.js";
+import { nt as uiCatalog } from "./dist-bewtXYlO.js";
+import { t as CatalogNode } from "./catalogComponents-DV7cPpUm-C77AEEx9.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-YLS-cxyT.js
+//#region ../ui-react/dist/openUiLibrary-W3Ce896k.js
 const propsFor = (props, container) => container ? props.extend({ children: z.array(z.any()).optional() }) : props;
 /**
 * catalog 的 OpenUI 投影：`defineComponent` 复用同一份 zod schema 与描述，

package/dist/{skillVersionStore-uyefLPR1-DXOzbksv.d.ts → skillVersionStore-BzLbzFOL-CxwIewHJ.d.ts}

@@ -1,8 +1,9 @@
-import { N as FileSystemProvider, R as Page, Z as SkillCatalogEntry, it as SkillManifest, z as PageQuery } from "./types-7Wcg--Vh-1YlQ4jF9.js";
-//#region ../governance/dist/skillVersionStore-uyefLPR1.d.ts
+import { B as PageQuery, P as FileSystemProvider, Q as SkillCatalogEntry, at as SkillManifest, z as Page } from "./types-D_hoCri8-BnNPiZCi.js";
+//#region ../governance/dist/skillVersionStore-BzLbzFOL.d.ts
 //#region src/types.d.ts
 type CandidateStatus = 'draft' | 'pending-review' | 'approved' | 'published' | 'rejected';
-type CandidateSource = 'runtime-miss' | 'document' | 'manual';
+/** `generated` 是 0.5.0 的技能自动生成来源（需求 12 号 AC-9.1） */
+type CandidateSource = 'runtime-miss' | 'document' | 'manual' | 'generated';
 type CandidateRisk = 'low' | 'medium' | 'high';
 interface CandidateFile {
   path: string;

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { c as LlmClient, f as LlmResponse, g as MemoryStore, l as LlmCompleteInput, n as ArtifactStore, o as InteractionRequest, p as LlmStreamEvent, s as InteractionResponse, t as Artifact, y as UiBridge } from "./types-7Wcg--Vh-1YlQ4jF9.js";
+import { _ as MemoryStore, b 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 } from "./types-D_hoCri8-BnNPiZCi.js";
 import { a as loadGoogleConfigFromEnv, i as loadAnthropicConfigFromEnv, n as LlmEnvConfig, o as loadLlmConfigFromEnv, r as ProviderEnvConfig } from "./env-BPUBZCwJ-4jat_SVG.js";
 //#region ../runtime/dist/testing.d.ts
 //#region src/llm/mockLlmClient.d.ts

package/dist/{types-7Wcg--Vh-1YlQ4jF9.d.ts → types-D_hoCri8-BnNPiZCi.d.ts}

@@ -1,6 +1,6 @@
 //#region ../core/dist/index.d.ts
 //#region src/errors.d.ts
-type WebSkillErrorCode = 'FS_NOT_FOUND' | 'FS_PATH_OUTSIDE_ROOT' | 'SKILL_NOT_FOUND' | 'SKILL_INVALID_METADATA' | 'SKILL_INVALID_NAME' | 'SKILL_DUPLICATE_NAME' | 'SKILL_UNSUPPORTED_SCRIPT' | 'VALIDATION_FAILED' | 'TOOL_NOT_FOUND' | 'TOOL_EXECUTION_FAILED' | 'NETWORK_BLOCKED' | 'TOOL_UNSUPPORTED' | 'TOOL_NOT_ALLOWED' | 'TOOL_SCHEMA_UNAVAILABLE' | 'RUN_TIMEOUT' | 'RUN_MAX_TURNS_EXCEEDED' | 'RUN_FAILED' | 'RUN_CANCELLED' | 'RUN_INTERACTION_TIMEOUT' | 'UI_UNAVAILABLE' | 'LLM_UNAVAILABLE' | 'LLM_REQUEST_FAILED' | 'INSTALL_FAILED' | 'UNINSTALL_FAILED' | 'EXPORT_FAILED' | 'INTEGRITY_FAILED' | 'FS_PERMISSION_DENIED' | 'MCP_ENDPOINT_UNAVAILABLE' | 'MCP_TOOL_NOT_FOUND' | 'CANDIDATE_INVALID' | 'APPROVAL_REQUIRED' | 'SKILL_QUARANTINED' | 'SKILL_DISABLED' | 'SKILL_UNKNOWN_ALLOWED_TOOL' | 'SKILL_UNKNOWN_DEPENDENCY' | 'SKILL_CIRCULAR_DEPENDENCY' | 'GOVERNANCE_FAILED' | 'RUN_SNAPSHOT_NOT_FOUND' | 'RUN_SNAPSHOT_EXPIRED' | 'RUN_SNAPSHOT_INCOMPATIBLE' | 'RUN_SNAPSHOT_SCHEMA_UNSUPPORTED' | 'RUN_TRACE_INCOMPATIBLE' | 'SESSION_INCOMPATIBLE' | 'SIGNATURE_MISSING' | 'SIGNATURE_MALFORMED' | 'SIGNATURE_UNTRUSTED_KEY' | 'SIGNATURE_MISMATCH' | 'SIGNATURE_UNSUPPORTED' | 'MCP_STDIO_SPAWN_FAILED' | 'MCP_STDIO_EXITED' | 'MCP_STDIO_TIMEOUT';
+type WebSkillErrorCode = 'FS_NOT_FOUND' | 'FS_PATH_OUTSIDE_ROOT' | 'SKILL_NOT_FOUND' | 'SKILL_INVALID_METADATA' | 'SKILL_INVALID_NAME' | 'SKILL_DUPLICATE_NAME' | 'SKILL_UNSUPPORTED_SCRIPT' | 'VALIDATION_FAILED' | 'TOOL_NOT_FOUND' | 'TOOL_EXECUTION_FAILED' | 'NETWORK_BLOCKED' | 'TOOL_UNSUPPORTED' | 'TOOL_NOT_ALLOWED' | 'TOOL_SCHEMA_UNAVAILABLE' | 'RUN_TIMEOUT' | 'RUN_MAX_TURNS_EXCEEDED' | 'RUN_FAILED' | 'RUN_CANCELLED' | 'RUN_INTERACTION_TIMEOUT' | 'UI_UNAVAILABLE' | 'LLM_UNAVAILABLE' | 'LLM_REQUEST_FAILED' | 'INSTALL_FAILED' | 'UNINSTALL_FAILED' | 'EXPORT_FAILED' | 'INTEGRITY_FAILED' | 'FS_PERMISSION_DENIED' | 'MCP_ENDPOINT_UNAVAILABLE' | 'MCP_TOOL_NOT_FOUND' | 'CANDIDATE_INVALID' | 'APPROVAL_REQUIRED' | 'SKILL_QUARANTINED' | 'SKILL_DISABLED' | 'SKILL_UNKNOWN_ALLOWED_TOOL' | 'SKILL_UNKNOWN_DEPENDENCY' | 'SKILL_CIRCULAR_DEPENDENCY' | 'GOVERNANCE_FAILED' | 'RUN_SNAPSHOT_NOT_FOUND' | 'RUN_SNAPSHOT_EXPIRED' | 'RUN_SNAPSHOT_INCOMPATIBLE' | 'RUN_SNAPSHOT_SCHEMA_UNSUPPORTED' | 'RUN_TRACE_INCOMPATIBLE' | 'SESSION_INCOMPATIBLE' | 'SIGNATURE_MISSING' | 'SIGNATURE_MALFORMED' | 'SIGNATURE_UNTRUSTED_KEY' | 'SIGNATURE_MISMATCH' | 'SIGNATURE_UNSUPPORTED' | 'MCP_STDIO_SPAWN_FAILED' | 'MCP_STDIO_EXITED' | 'MCP_STDIO_TIMEOUT' | 'TS_RESOURCE_URL_REJECTED' | 'TS_TRANSPILER_UNAVAILABLE' | 'TS_TRANSPILE_FAILED' | 'TODO_LIST_INVALID' | 'TODO_ITEM_NOT_FOUND' | 'SKILL_GENERATION_DISABLED' | 'SKILL_GENERATION_LIMIT_EXCEEDED' | 'SKILL_GENERATION_VALIDATION_FAILED' | 'DELEGATION_UNAVAILABLE' | 'DELEGATION_IN_PROGRESS' | 'DELEGATION_BUDGET_EXCEEDED' | 'PREFERENCE_IMPORT_INVALID' | 'PREFERENCE_IMPORT_VERSION_UNSUPPORTED' | 'PREFERENCE_IMPORT_CREDENTIAL_REJECTED' | 'DICTATION_UNAVAILABLE' | 'DICTATION_PERMISSION_DENIED' | 'DICTATION_FAILED' | 'PERCEPTION_NOT_ENABLED' | 'PERCEPTION_FAILED';
 /**
  * 所有公开 API 抛出的结构化错误，code 供上层可编程处理
  * @stable
@@ -582,7 +582,7 @@ declare function escapeXml(text: string): string;
 declare function renderAvailableSkillsXml(catalog: SkillCatalog): string;
 declare const xmlRenderer: CatalogRenderer;
 //#endregion
-//#region ../runtime/dist/types-7Wcg--Vh.d.ts
+//#region ../runtime/dist/types-D_hoCri8.d.ts
 //#region src/llm/streamTypes.d.ts
 /** 流式 LLM 事件（OpenAI SSE / Vercel fullStream 统一映射） */
 type LlmStreamEvent = {
@@ -682,7 +682,21 @@ interface ArtifactStore {
 }
 //#endregion
 //#region src/interaction/types.d.ts
+/**
+ * 交互的发起方标识（FR-11.6）。串行委派下父 agent 与子 agent 都能发起交互，
+ * 缺了这个标识用户无法判断弹出来的表单属于哪个子任务。
+ * 缺省即父 agent 自己发起。
+ * @experimental
+ */
+interface InteractionOrigin {
+  /** 展示用标签，通常是子任务标题 */
+  label: string;
+  /** 关联的待办条目 */
+  todoId?: string;
+}
 type InteractionRequest = {
+  origin?: InteractionOrigin;
+} & ({
   type: 'ask';
   id: string;
   message: string;
@@ -715,7 +729,7 @@ type InteractionRequest = {
   capability: 'readReference' | 'writeArtifact' | 'confirm';
   message: string;
   details?: unknown;
-};
+});
 interface InteractionResponse {
   id: string;
   value?: unknown;
@@ -867,6 +881,17 @@ interface FormField {
     label: string;
     value: unknown;
   }>;
+  /** 跨会话稳定的字段标识 `<skillName>#<fieldName>`（FR-5.6）；缺省表示该字段不参与召回 */
+  fieldKey?: string;
+  /**
+   * 上次填写值（FR-5.9）。**刻意不叫 defaultValue**：渲染器会把 defaultValue 直接填进控件，
+   * 而历史值可能是手机号、地址甚至凭据，必须由用户看到后主动采纳。
+   * @experimental
+   */
+  suggestion?: {
+    value: unknown;
+    ts: number;
+  };
 }
 interface InteractionPolicy {
   /** 缺必填参数策略：默认 'user'（表单问用户），'llm' 回喂自愈 */
@@ -892,4 +917,4 @@ interface MemoryStore {
   transaction?<T>(scope: string, fn: (inner: MemoryStore) => Promise<T>): Promise<T>;
 }
 //#endregion
-export { SkillDocument as $, DEFAULT_ARCHIVE_LIMITS as A, jsonRenderer as At, RemoteUrlPolicy as B, resolveArchiveLimits as Bt, UiSpecPatch as C, buildManifest as Ct, ArchiveLimits as D, escapeXml as Dt, UiSurfaceActionResponse as E, computeDigest as Et, JsonSchema as F, parseSkillPackManifest as Ft, SKILL_NAME_PATTERN as G, validateSkills as Gt, SKILLS_LOCKFILE as H, signSkill as Ht, MANIFEST_EXCLUDED_FILES as I, readResponseWithLimit as It, SignatureAuditSink as J, xmlRenderer as Jt, SKILL_PACK_FILE as K, verifyManifest as Kt, MemoryFS as L, readSkillSignature as Lt, FileStat as M, messageOf as Mt, FileSystemProvider as N, normalizePath as Nt, CatalogRenderer as O, exportSkills as Ot, FsTrustedKeyStore as P, parseSkillMarkdown as Pt, SkillDiscovery as Q, Page as R, renderAvailableSkillsXml as Rt, UiSpecEvent as S, buildCatalog as St, UiSurfaceActionRequest as T, checkSkillRules as Tt, SKILL_MANIFEST_FILE as U, signaturePayloadBytes as Ut, SIGNATURE_SCHEMA_VERSION as V, resolveInsideRoot as Vt, SKILL_NAME_MAX_LENGTH as W, unzipWithLimits as Wt, SkillCatalog as X, SignatureVerdict as Y, SkillCatalogEntry as Z, RenderBlock as _, WebSkillError as _t, InteractionPolicy as a, SkillMetadata as at, UiSpecActionCapability as b, assertSafePathSegment as bt, LlmClient as c, SkillSignature as ct, LlmMessage as d, TrustedKey as dt, SkillInstallSource as et, LlmResponse as f, TrustedKeyStore as ft, MemoryStore as g, VerifyResult as gt, LlmToolSpec as h, ValidationReport as ht, FormField as i, SkillManifest as it, DiscoveryResult as j, keyIdOf as jt, CryptoKeyLike as k, isValidSkillName as kt, LlmCompleteInput as l, SkillSource as lt, LlmToolCall as m, UnsignedPolicy as mt, ArtifactStore as n, SkillLocation as nt, InteractionRequest as o, SkillPackManifest as ot, LlmStreamEvent as p, UiSpecNode as pt, SKILL_SIGNATURE_FILE as q, verifySkillSignature as qt, ChartSpec as r, SkillManagerPort as rt, InteractionResponse as s, SkillReader as st, Artifact as t, SkillIssue as tt, LlmContentPart as u, SkillsLockfile as ut, RenderResultRequest as v, WebSkillErrorCode as vt, UiSpecSnapshot as w, checkDependencyCycles as wt, UiSpecDrafts as x, atomicWriteText as xt, UiBridge as y, assertRemoteUrlAllowed as yt, PageQuery as z, renderCatalogJson as zt };
+export { SkillDiscovery as $, CryptoKeyLike as A, isValidSkillName as At, PageQuery as B, renderCatalogJson as Bt, UiSpecEvent as C, buildCatalog as Ct, UiSurfaceActionResponse as D, computeDigest as Dt, UiSurfaceActionRequest as E, checkSkillRules as Et, FsTrustedKeyStore as F, parseSkillMarkdown as Ft, SKILL_NAME_MAX_LENGTH as G, unzipWithLimits as Gt, SIGNATURE_SCHEMA_VERSION as H, resolveInsideRoot as Ht, JsonSchema as I, parseSkillPackManifest as It, SKILL_SIGNATURE_FILE as J, verifySkillSignature as Jt, SKILL_NAME_PATTERN as K, validateSkills as Kt, MANIFEST_EXCLUDED_FILES as L, readResponseWithLimit as Lt, DiscoveryResult as M, keyIdOf as Mt, FileStat as N, messageOf as Nt, ArchiveLimits as O, escapeXml as Ot, FileSystemProvider as P, normalizePath as Pt, SkillCatalogEntry as Q, MemoryFS as R, readSkillSignature as Rt, UiSpecDrafts as S, atomicWriteText as St, UiSpecSnapshot as T, checkDependencyCycles as Tt, SKILLS_LOCKFILE as U, signSkill as Ut, RemoteUrlPolicy as V, resolveArchiveLimits as Vt, SKILL_MANIFEST_FILE as W, signaturePayloadBytes as Wt, SignatureVerdict as X, SignatureAuditSink as Y, xmlRenderer as Yt, SkillCatalog as Z, MemoryStore as _, VerifyResult as _t, InteractionOrigin as a, SkillManifest as at, UiBridge as b, assertRemoteUrlAllowed as bt, InteractionResponse as c, SkillReader as ct, LlmContentPart as d, SkillsLockfile as dt, SkillDocument as et, LlmMessage as f, TrustedKey as ft, LlmToolSpec as g, ValidationReport as gt, LlmToolCall as h, UnsignedPolicy as ht, FormField as i, SkillManagerPort as it, DEFAULT_ARCHIVE_LIMITS as j, jsonRenderer as jt, CatalogRenderer as k, exportSkills as kt, LlmClient as l, SkillSignature as lt, LlmStreamEvent as m, UiSpecNode as mt, ArtifactStore as n, SkillIssue as nt, InteractionPolicy as o, SkillMetadata as ot, LlmResponse as p, TrustedKeyStore as pt, SKILL_PACK_FILE as q, verifyManifest as qt, ChartSpec as r, SkillLocation as rt, InteractionRequest as s, SkillPackManifest as st, Artifact as t, SkillInstallSource as tt, LlmCompleteInput as u, SkillSource as ut, RenderBlock as v, WebSkillError as vt, UiSpecPatch as w, buildManifest as wt, UiSpecActionCapability as x, assertSafePathSegment as xt, RenderResultRequest as y, WebSkillErrorCode as yt, Page as z, renderAvailableSkillsXml as zt };

package/dist/ui-react.d.ts

@@ -1,5 +1,5 @@
-import { E as UiSurfaceActionResponse, S as UiSpecEvent, T as UiSurfaceActionRequest, b as UiSpecActionCapability, o as InteractionRequest, pt as UiSpecNode, s as InteractionResponse, v as RenderResultRequest, w as UiSpecSnapshot, x as UiSpecDrafts, y as UiBridge } from "./types-7Wcg--Vh-1YlQ4jF9.js";
-import { y as InteractionSpecLabels } from "./index-CHXxDccV.js";
+import { C as UiSpecEvent, D as UiSurfaceActionResponse, E as UiSurfaceActionRequest, S as UiSpecDrafts, T as UiSpecSnapshot, b as UiBridge, c as InteractionResponse, mt as UiSpecNode, s as InteractionRequest, x as UiSpecActionCapability, y as RenderResultRequest } from "./types-D_hoCri8-BnNPiZCi.js";
+import { b as InteractionSpecLabels } from "./index-Bsqg4ftU.js";
 import { z } from "zod";
 import { ComponentType, ReactNode } from "react";
 import "react/jsx-runtime";
@@ -256,8 +256,24 @@ declare class UiSurfaceStore {
 }
 //#endregion
 //#region src/bridgeState.d.ts
+/**
+ * 一次被丢弃的 surface action（FR-11.7）。
+ *
+ * 丢弃本身是对的（重放/串扰防护），但静默丢弃会让「点了没反应」变成无从排查的现象。
+ * @experimental
+ */
+interface DroppedSurfaceActionWarning {
+  /** duplicate：nonce 已被消费；no-pending：当前没有等待中的动作；mismatch：与待决动作不是同一个 */
+  reason: 'duplicate' | 'no-pending' | 'mismatch';
+  nonce: string;
+  message: string;
+  /** 丢弃发生时的待决状态，用于定位串扰 */
+  pending: UiSurfaceActionRequest | null;
+}
 interface ReactBridgeStateOptions {
   onSurfaceDraftChange?(runId: string, surfaceId: string, value: Record<string, unknown>): Promise<void> | void;
+  /** 覆盖默认的 console.warn 上报（测试与宿主遥测用）。@experimental */
+  onDroppedSurfaceAction?(warning: DroppedSurfaceActionWarning): void;
 }
 /**
  * React 桥接状态：UiBridge 实现 + useSyncExternalStore 兼容订阅。
@@ -287,7 +303,10 @@ declare class ReactBridgeState implements UiBridge {
   renderResult(input: RenderResultRequest): Promise<void>;
   renderSurface(event: UiSpecEvent): Promise<void>;
   requestSurfaceAction(input: UiSurfaceActionRequest): Promise<UiSurfaceActionResponse>;
-  /** Resolves exactly one pending action capability; stale or duplicate nonces are ignored. */
+  /**
+   * Resolves exactly one pending action capability; stale or duplicate nonces are ignored.
+   * Every ignored response is reported through `onDroppedSurfaceAction` (FR-11.7).
+   */
   resolveSurfaceAction(response: UiSurfaceActionResponse): boolean;
   cancelSurfaceAction(nonce: string): void;
   onTextDelta(runId: string, delta: string): Promise<void>;
@@ -317,6 +336,8 @@ interface CustomSurfaceActionEvent {
   actionId: string;
   intent: UiSpecActionCapability['intent'];
   nonce?: string;
+  /** 提交动作所属的表单容器；一张 surface 只有一个表单时省略 */
+  scopeId?: string;
   value?: Record<string, unknown>;
 }
 interface RegisteredSurfaceProps<Props> {
@@ -482,10 +503,10 @@ type CatalogNodeProps = {
   children?: ReactNode;
 };
 /**
- * catalog 16 个组件的展示实现：json-render 与 OpenUI 两档共用同一份，
+ * catalog 展示类组件的实现：json-render 与 OpenUI 两档共用同一份，
  * 避免"一个 catalog、多套 registry"退化成多套各自演进的视觉。
  * 交互（表单值收集 / action 回传）由各档的宿主组件负责。
  */
 declare const catalogComponentImpls: Record<string, (input: CatalogNodeProps) => ReactNode>;
 //#endregion
-export { type CatalogNodeProps, type CustomSurfaceActionEvent, InteractionForm, type JsonRenderActionDispatch, JsonRenderSpecSurface, type JsonRenderSpecSurfaceProps, NATIVE_SPEC_COMPONENTS, NativeSpecSurface, type NativeSpecSurfaceProps, OpenUiSpecSurface, type OpenUiSpecSurfaceProps, ReactBridgeState, type RegisteredSurfaceProps, ResultBlocks, SpecInteractionChannel, type SpecInteractionSession, StreamingText, type SurfaceRegistration, SurfaceRegistry, type UiSurfaceActionEvent, UiSurfaceList, type UiSurfaceListProps, UiSurfaceSnapshotList, type UiSurfaceSnapshotListProps, UiSurfaceStore, catalogComponentImpls, createJsonRenderRegistry, probeJsonRenderAvailability };
+export { type CatalogNodeProps, type CustomSurfaceActionEvent, type DroppedSurfaceActionWarning, InteractionForm, type JsonRenderActionDispatch, JsonRenderSpecSurface, type JsonRenderSpecSurfaceProps, NATIVE_SPEC_COMPONENTS, NativeSpecSurface, type NativeSpecSurfaceProps, OpenUiSpecSurface, type OpenUiSpecSurfaceProps, ReactBridgeState, type ReactBridgeStateOptions, type RegisteredSurfaceProps, ResultBlocks, SpecInteractionChannel, type SpecInteractionSession, StreamingText, type SurfaceRegistration, SurfaceRegistry, type UiSurfaceActionEvent, UiSurfaceList, type UiSurfaceListProps, UiSurfaceSnapshotList, type UiSurfaceSnapshotListProps, UiSurfaceStore, catalogComponentImpls, createJsonRenderRegistry, probeJsonRenderAvailability };

package/dist/ui-react.js

@@ -1,8 +1,8 @@
 import { r as __exportAll$1 } from "./rolldown-runtime-BOF7iYI8.js";
 import { m as WebSkillError } from "./dist-8oQRa8Xz.js";
-import { X as validateUiSpecEvent, Z as validateUiSpecNode } from "./dist-C-Sh0MDU.js";
-import { C as interactionToUiSpec, D as renderMiniChart, K as renderMiniMarkdown, M as toJsonRenderSpec, N as toOpenUiSpecLang, S as interactionToFormModel, U as chartSpecFromProps, h as collectValues, k as shapeInteractionValue, q as uiCatalog } from "./dist-D9Lcn5Pp.js";
-import { _ as DropdownMenuContent, a as SurfaceField, b as Markdown, c as str, d as Badge, f as Button, g as DropdownMenuCheckboxItem, h as DropdownMenu, i as SurfaceButton, l as useCatalogSurfaceForm, m as DataTable, n as CatalogSurfaceProvider, o as SurfaceFormButtons, p as Checkbox, r as EChart, s as catalogComponentImpls, u as useSurfaceForm, v as DropdownMenuTrigger, x as Separator, y as Input } from "./catalogComponents-KsujmL4b-Clx1kCnU.js";
+import { it as validateUiSpecNode, rt as validateUiSpecEvent } from "./dist-6C03DShK.js";
+import { B as toOpenUiSpecLang, I as shapeInteractionValue, O as interactionToFormModel, P as renderMiniChart, Q as chartSpecFromProps, g as applySuggestion, k as interactionToUiSpec, nt as uiCatalog, tt as renderMiniMarkdown, x as collectValues, z as toJsonRenderSpec } from "./dist-bewtXYlO.js";
+import { C as Input, S as DropdownMenuTrigger, T as Separator, _ as Checkbox, a as SpecProgress, b as DropdownMenuCheckboxItem, c as SurfaceButton, d as catalogComponentImpls, f as str, g as Button, h as Badge, i as SpecGrid, l as SurfaceField, m as useSurfaceForm, n as CatalogSurfaceProvider, o as SpecTabs, p as useCatalogSurfaceForm, r as EChart, s as SpecTimeline, u as SurfaceFormButtons, v as DataTable, w as Markdown, x as DropdownMenuContent, y as DropdownMenu } from "./catalogComponents-DV7cPpUm-C77AEEx9.js";
 import { z } from "zod";
 import * as React$1 from "react";
 import React, { createContext, useCallback, useContext, useEffect, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
@@ -6489,8 +6489,10 @@ var ReactBridgeState = class {
 	#processedSurfaceActionNonces = /* @__PURE__ */ new Set();
 	#surfaceDrafts = /* @__PURE__ */ new Map();
 	#onSurfaceDraftChange;
+	#onDroppedSurfaceAction;
 	constructor(options = {}) {
 		this.#onSurfaceDraftChange = options.onSurfaceDraftChange;
+		this.#onDroppedSurfaceAction = options.onDroppedSurfaceAction;
 		this.surfaceStore.subscribe(() => this.#emit());
 	}
 	get surfaceSnapshots() {
@@ -6559,12 +6561,25 @@ var ReactBridgeState = class {
 			this.#surfaceActionResolvers.set(input.nonce, resolve);
 		});
 	}
-	/** Resolves exactly one pending action capability; stale or duplicate nonces are ignored. */
+	/**
+	* Resolves exactly one pending action capability; stale or duplicate nonces are ignored.
+	* Every ignored response is reported through `onDroppedSurfaceAction` (FR-11.7).
+	*/
 	resolveSurfaceAction(response) {
-		if (this.#processedSurfaceActionNonces.has(response.nonce)) return false;
+		if (this.#processedSurfaceActionNonces.has(response.nonce)) {
+			this.#reportDropped("duplicate", response);
+			return false;
+		}
 		const resolver = this.#surfaceActionResolvers.get(response.nonce);
 		const pending = this.pendingSurfaceAction;
-		if (!resolver || !pending || pending.runId !== response.runId || pending.surfaceId !== response.surfaceId || pending.actionId !== response.actionId || pending.nonce !== response.nonce) return false;
+		if (!resolver || !pending) {
+			this.#reportDropped("no-pending", response);
+			return false;
+		}
+		if (pending.runId !== response.runId || pending.surfaceId !== response.surfaceId || pending.actionId !== response.actionId || pending.nonce !== response.nonce) {
+			this.#reportDropped("mismatch", response);
+			return false;
+		}
 		this.#processedSurfaceActionNonces.add(response.nonce);
 		this.#surfaceActionResolvers.delete(response.nonce);
 		this.pendingSurfaceAction = null;
@@ -6585,6 +6600,21 @@ var ReactBridgeState = class {
 			cancelled: true
 		});
 	}
+	#reportDropped(reason, response) {
+		const pending = this.pendingSurfaceAction;
+		const state = pending === null ? "no action is pending" : `pending action is ${pending.surfaceId}/${pending.actionId} (nonce ${pending.nonce}, run ${pending.runId})`;
+		const warning = {
+			reason,
+			nonce: response.nonce,
+			message: `Dropped UI surface action ${response.surfaceId}/${response.actionId} with nonce ${response.nonce}: ${reason}; ${state}`,
+			pending
+		};
+		if (this.#onDroppedSurfaceAction) {
+			this.#onDroppedSurfaceAction(warning);
+			return;
+		}
+		console.warn(`[webskill] ${warning.message}`);
+	}
 	async onTextDelta(runId, delta) {
 		if (this.streamingRunId !== runId) {
 			this.streamingRunId = runId;
@@ -6594,6 +6624,28 @@ var ReactBridgeState = class {
 		this.#emit();
 	}
 };
+/**
+* 历史值以**建议**形态出现（FR-5.9）：控件初始值仍为空，
+* 用户点「使用」才写入。切勿改成 defaultValue。
+*/
+function Suggestion({ control, onUse }) {
+	if (control.suggestion === void 0) return null;
+	const preview = String(control.suggestion.value);
+	return /* @__PURE__ */ jsxs("div", {
+		className: "webskill-form__suggestion",
+		"data-webskill-suggestion": control.name,
+		children: [/* @__PURE__ */ jsxs("span", {
+			className: "webskill-form__suggestion-value",
+			children: ["Last entered: ", preview]
+		}), /* @__PURE__ */ jsx("button", {
+			type: "button",
+			className: "webskill-form__suggestion-use",
+			"data-webskill-suggestion-use": control.name,
+			onClick: onUse,
+			children: "Use"
+		})]
+	});
+}
 function Control({ control, invalid }) {
 	const controlId = `webskill-field-${control.name}`;
 	const label = /* @__PURE__ */ jsxs("label", {
@@ -6709,15 +6761,24 @@ function InteractionForm({ bridge }) {
 			}) : null,
 			model.controls.map((control) => /* @__PURE__ */ jsxs("div", {
 				className: invalid.includes(control.name) ? "webskill-form__control--invalid" : void 0,
-				children: [/* @__PURE__ */ jsx(Control, {
-					control,
-					invalid: invalid.includes(control.name)
-				}), invalid.includes(control.name) ? /* @__PURE__ */ jsx("div", {
-					id: `webskill-error-${control.name}`,
-					role: "alert",
-					className: "webskill-form__error",
-					children: "This field is required"
-				}) : null]
+				children: [
+					/* @__PURE__ */ jsx(Control, {
+						control,
+						invalid: invalid.includes(control.name)
+					}),
+					/* @__PURE__ */ jsx(Suggestion, {
+						control,
+						onUse: () => {
+							if (formRef.current) applySuggestion(control, formRef.current);
+						}
+					}),
+					invalid.includes(control.name) ? /* @__PURE__ */ jsx("div", {
+						id: `webskill-error-${control.name}`,
+						role: "alert",
+						className: "webskill-form__error",
+						children: "This field is required"
+					}) : null
+				]
 			}, control.name)),
 			/* @__PURE__ */ jsxs("div", {
 				className: "webskill-form__actions",
@@ -6955,9 +7016,10 @@ const TONE_CLASS = {
 	info: "text-info",
 	destructive: "text-destructive"
 };
-function renderNode(node, context, key) {
+function renderNode(node, context, key, scope) {
 	const props = node.props ?? {};
-	const children = (node.children ?? []).map((child, index) => renderNode(child, context, `${key}.${index}`));
+	const nodeScope = node.component === "Form" ? context.scopeOfNode(node) : scope;
+	const children = (node.children ?? []).map((child, index) => renderNode(child, context, `${key}.${index}`, nodeScope));
 	switch (node.component) {
 		case "Stack": return /* @__PURE__ */ jsx("div", {
 			className: `flex gap-3 ${str(props, "direction", "vertical") === "horizontal" ? "flex-row items-center" : "flex-col"}`,
@@ -7015,6 +7077,16 @@ function renderNode(node, context, key) {
 			label: str(props, "title", "Data")
 		}, key);
 		case "Chart": return /* @__PURE__ */ jsx(EChart, { chart: chartSpecFromProps(props) }, key);
+		case "Tabs": return /* @__PURE__ */ jsx(SpecTabs, {
+			props,
+			children
+		}, key);
+		case "Grid": return /* @__PURE__ */ jsx(SpecGrid, {
+			props,
+			children
+		}, key);
+		case "Timeline": return /* @__PURE__ */ jsx(SpecTimeline, { props }, key);
+		case "Progress": return /* @__PURE__ */ jsx(SpecProgress, { props }, key);
 		case "FileLink": return /* @__PURE__ */ jsxs("div", {
 			className: "flex items-center gap-2 text-sm",
 			children: [/* @__PURE__ */ jsx("span", {
@@ -7032,7 +7104,7 @@ function renderNode(node, context, key) {
 			className: "flex flex-col gap-3",
 			onSubmit: (event) => {
 				event.preventDefault();
-				context.submit("submit");
+				context.submit("submit", void 0, nodeScope);
 			},
 			noValidate: true,
 			children: [
@@ -7043,17 +7115,20 @@ function renderNode(node, context, key) {
 				children,
 				/* @__PURE__ */ jsx(SurfaceFormButtons, {
 					form: context,
-					props
+					props,
+					scope: nodeScope
 				})
 			]
 		}, key);
 		case "Field": return /* @__PURE__ */ jsx(SurfaceField, {
 			form: context,
-			props
+			props,
+			scope
 		}, key);
 		case "Button": return /* @__PURE__ */ jsx(SurfaceButton, {
 			form: context,
 			props,
+			scope,
 			...node.id ? { nodeId: node.id } : {}
 		}, key);
 		case "Alert": return /* @__PURE__ */ jsxs("div", {
@@ -7418,7 +7493,7 @@ function OpenUiSpecSurface({ spec, surfaceId, actions, onAction }) {
 	const [unavailable, setUnavailable] = useState(false);
 	useEffect(() => {
 		let cancelled = false;
-		import("./openUiLibrary-YLS-cxyT-C96jWDQq.js").then((loaded) => {
+		import("./openUiLibrary-W3Ce896k-ClFTRZFs.js").then((loaded) => {
 			if (!cancelled) setModule(loaded);
 		}).catch(() => {
 			if (!cancelled) setUnavailable(true);

package/dist/ui-vue.d.ts

@@ -1,4 +1,4 @@
-import { o as InteractionRequest, s as InteractionResponse, v as RenderResultRequest, y as UiBridge } from "./types-7Wcg--Vh-1YlQ4jF9.js";
+import { b as UiBridge, c as InteractionResponse, s as InteractionRequest, y as RenderResultRequest } from "./types-D_hoCri8-BnNPiZCi.js";
 import { PropType } from "vue";
 //#region ../ui-vue/dist/index.d.ts
 //#region src/bridgeState.d.ts

package/dist/ui-vue.js

@@ -1,4 +1,4 @@
-import { D as renderMiniChart, K as renderMiniMarkdown, S as interactionToFormModel, h as collectValues, k as shapeInteractionValue } from "./dist-D9Lcn5Pp.js";
+import { I as shapeInteractionValue, O as interactionToFormModel, P as renderMiniChart, g as applySuggestion, tt as renderMiniMarkdown, x as collectValues } from "./dist-bewtXYlO.js";
 import { defineComponent, h, reactive, ref } from "vue";
 
 //#region ../ui-vue/dist/index.js
@@ -46,6 +46,19 @@ var VueBridgeState = class {
 		this.state.streamingText += delta;
 	}
 };
+/** 历史值以**建议**形态出现（FR-5.9）：控件初始值仍为空，用户点「使用」才写入 */
+function renderSuggestion(control, onUse) {
+	if (control.suggestion === void 0) return null;
+	return h("div", {
+		class: "webskill-form__suggestion",
+		"data-webskill-suggestion": control.name
+	}, [h("span", { class: "webskill-form__suggestion-value" }, `Last entered: ${String(control.suggestion.value)}`), h("button", {
+		type: "button",
+		class: "webskill-form__suggestion-use",
+		"data-webskill-suggestion-use": control.name,
+		onClick: onUse
+	}, "Use")]);
+}
 function renderControl(control, invalid) {
 	const controlId = `webskill-field-${control.name}`;
 	const label = h("label", {
@@ -137,11 +150,17 @@ const InteractionForm = defineComponent({
 			}, [
 				model.title ? h("div", { class: "webskill-form__title" }, model.title) : null,
 				model.message && (model.kind === "form" || model.kind === "authorize") ? h("p", { class: "webskill-form__message" }, model.message) : null,
-				...model.controls.map((control) => h("div", { key: control.name }, [renderControl(control, invalid.value.includes(control.name)), invalid.value.includes(control.name) ? h("div", {
-					id: `webskill-error-${control.name}`,
-					role: "alert",
-					class: "webskill-form__error"
-				}, "This field is required") : null])),
+				...model.controls.map((control) => h("div", { key: control.name }, [
+					renderControl(control, invalid.value.includes(control.name)),
+					renderSuggestion(control, () => {
+						if (formRef.value) applySuggestion(control, formRef.value);
+					}),
+					invalid.value.includes(control.name) ? h("div", {
+						id: `webskill-error-${control.name}`,
+						role: "alert",
+						class: "webskill-form__error"
+					}, "This field is required") : null
+				])),
 				h("div", { class: "webskill-form__actions" }, [h("button", {
 					type: "submit",
 					class: "webskill-form__button webskill-form__button--primary"

package/dist/ui.d.ts

@@ -1,4 +1,4 @@
-import { pt as UiSpecNode } from "./types-7Wcg--Vh-1YlQ4jF9.js";
-import { Bt as buildRenderResult } from "./index-DLfR2Y6I.js";
-import { $ as fromA2uiSpecAction, A as UiCatalogToolSourceOptions, B as WEBSKILL_SURFACE_ACTION, C as OpenUiRuntime, D as UiCatalog, E as UiActionDef, F as VERCEL_INTERACTION_TOOL_NAME, G as buildA2uiCatalogDefinition, H as ZodRuntime, I as VercelToolInvocation, J as collectSpecActions, K as chartSpecFromProps, L as VercelUiBridge, M as UiSpecIssue, N as UiSpecValidation, O as UiCatalogInput, P as UiSurfaceActionDispatch, Q as ensureStyles, R as WEBSKILL_A2UI_CATALOG_ID, S as OpenUiRendererProps, T as UI_CATALOG_GROUPS, U as a2uiComponentSchema, V as WebFormBridge, W as a2uiComponentShapes, X as createUiCatalogToolSource, Y as collectValues, Z as defineUiCatalog, _ as EchartHandle, _t as toUiSurfaceActionDispatch, a as A2UI_SURFACE_ACTION, at as loadOpenUiPeers, b as JsonRenderSpec, c as A2uiCatalogDefinition, ct as renderBlocks, d as A2uiMessage, dt as renderRenderResult, et as fromA2uiSurfaceAction, f as A2uiSpecActionEvent, ft as shapeInteractionValue, g as ControlModel, gt as toOpenUiSpecLang, h as CollectedValues, ht as toJsonRenderSpec, i as A2UI_SPEC_FORM_PATH, it as interactionToUiSpec, j as UiComponentDef, k as UiCatalogPromptOptions, l as A2uiCatalogHandle, lt as renderMiniChart, m as CHART_PALETTE, mt as toA2uiSurfaceAction, n as A2UI_COMMON_TYPES, nt as fromVercelToolResult, o as A2UI_VERSION, ot as loadWebSkillLitCatalog, p as A2uiSpecMessageOptions, pt as toA2uiSpecMessages, q as chartToTable, r as A2UI_SPEC_ACTION, rt as interactionToFormModel, s as A2uiCatalogComponent, st as mountEchart, t as A2UI_BASIC_CATALOG_ID, tt as fromUiSurfaceActionDispatch, u as A2uiComponentShape, ut as renderMiniMarkdown, v as FormModel, vt as toVercelToolInvocation, w as RENDER_UI_TOOL, x as LoadedOpenUiPeers, y as InteractionSpecLabels, yt as uiCatalog, z as WEBSKILL_STYLES_CSS } from "./index-CHXxDccV.js";
-export { A2UI_BASIC_CATALOG_ID, A2UI_COMMON_TYPES, A2UI_SPEC_ACTION, A2UI_SPEC_FORM_PATH, A2UI_SURFACE_ACTION, A2UI_VERSION, type A2uiCatalogComponent, type A2uiCatalogDefinition, type A2uiCatalogHandle, type A2uiComponentShape, type A2uiMessage, type A2uiSpecActionEvent, type A2uiSpecMessageOptions, CHART_PALETTE, type CollectedValues, type ControlModel, type EchartHandle, type FormModel, type InteractionSpecLabels, type JsonRenderSpec, type LoadedOpenUiPeers, type OpenUiRendererProps, type OpenUiRuntime, RENDER_UI_TOOL, UI_CATALOG_GROUPS, type UiActionDef, type UiCatalog, type UiCatalogInput, type UiCatalogPromptOptions, type UiCatalogToolSourceOptions, type UiComponentDef, type UiSpecIssue, type UiSpecNode, type UiSpecValidation, type UiSurfaceActionDispatch, VERCEL_INTERACTION_TOOL_NAME, type VercelToolInvocation, VercelUiBridge, WEBSKILL_A2UI_CATALOG_ID, WEBSKILL_STYLES_CSS, WEBSKILL_SURFACE_ACTION, WebFormBridge, type ZodRuntime, a2uiComponentSchema, a2uiComponentShapes, buildA2uiCatalogDefinition, buildRenderResult, chartSpecFromProps, chartToTable, collectSpecActions, collectValues, createUiCatalogToolSource, defineUiCatalog, ensureStyles, fromA2uiSpecAction, fromA2uiSurfaceAction, fromUiSurfaceActionDispatch, fromVercelToolResult, interactionToFormModel, interactionToUiSpec, loadOpenUiPeers, loadWebSkillLitCatalog, mountEchart, renderBlocks, renderMiniChart, renderMiniMarkdown, renderRenderResult, shapeInteractionValue, toA2uiSpecMessages, toA2uiSurfaceAction, toJsonRenderSpec, toOpenUiSpecLang, toUiSurfaceActionDispatch, toVercelToolInvocation, uiCatalog };
+import { mt as UiSpecNode } from "./types-D_hoCri8-BnNPiZCi.js";
+import { Wt as buildRenderResult } from "./index-vBz_FC9w.js";
+import { $ as buildA2uiCatalogDefinition, A as UiActionDef, At as uiCatalog, B as UiSpecValidation, C as OpenUiRendererProps, Ct as shapeInteractionValue, D as UI_CATALOG_PROMPT_BUDGET_BYTES, Dt as toOpenUiSpecLang, E as UI_CATALOG_GROUPS, Et as toJsonRenderSpec, F as UiComponentDef, G as WEBSKILL_A2UI_CATALOG_ID, H as VERCEL_INTERACTION_TOOL_NAME, I as UiFormScope, J as WebFormBridge, K as WEBSKILL_STYLES_CSS, L as UiPreset, M as UiCatalogInput, N as UiCatalogPromptOptions, O as UI_PRESETS, Ot as toUiSurfaceActionDispatch, P as UiCatalogToolSourceOptions, Q as applySuggestion, R as UiPresetName, S as LoadedOpenUiPeers, St as renderRenderResult, T as RENDER_UI_TOOL, Tt as toA2uiSurfaceAction, U as VercelToolInvocation, V as UiSurfaceActionDispatch, W as VercelUiBridge, X as a2uiComponentSchema, Y as ZodRuntime, Z as a2uiComponentShapes, _ as DESCRIBE_UI_PRESET_TOOL, _t as mountEchart, a as A2UI_SURFACE_ACTION, at as collectValues, b as InteractionSpecLabels, bt as renderMiniChart, c as A2uiCatalogDefinition, ct as ensureStyles, d as A2uiMessage, dt as fromUiSurfaceActionDispatch, et as chartSpecFromProps, f as A2uiSpecActionEvent, ft as fromVercelToolResult, g as ControlModel, gt as loadWebSkillLitCatalog, h as CollectedValues, ht as loadOpenUiPeers, i as A2UI_SPEC_FORM_PATH, it as collectSpecActions, j as UiCatalog, jt as uiPreset, k as UI_PRESET_NAMES, kt as toVercelToolInvocation, l as A2uiCatalogHandle, lt as fromA2uiSpecAction, m as CHART_PALETTE, mt as interactionToUiSpec, n as A2UI_COMMON_TYPES, nt as collectFormScopes, o as A2UI_VERSION, ot as createUiCatalogToolSource, p as A2uiSpecMessageOptions, pt as interactionToFormModel, q as WEBSKILL_SURFACE_ACTION, r as A2UI_SPEC_ACTION, rt as collectScopedValues, s as A2uiCatalogComponent, st as defineUiCatalog, t as A2UI_BASIC_CATALOG_ID, tt as chartToTable, u as A2uiComponentShape, ut as fromA2uiSurfaceAction, v as EchartHandle, vt as qualifyFieldName, w as OpenUiRuntime, wt as toA2uiSpecMessages, x as JsonRenderSpec, xt as renderMiniMarkdown, y as FormModel, yt as renderBlocks, z as UiSpecIssue } from "./index-Bsqg4ftU.js";
+export { A2UI_BASIC_CATALOG_ID, A2UI_COMMON_TYPES, A2UI_SPEC_ACTION, A2UI_SPEC_FORM_PATH, A2UI_SURFACE_ACTION, A2UI_VERSION, type A2uiCatalogComponent, type A2uiCatalogDefinition, type A2uiCatalogHandle, type A2uiComponentShape, type A2uiMessage, type A2uiSpecActionEvent, type A2uiSpecMessageOptions, CHART_PALETTE, type CollectedValues, type ControlModel, DESCRIBE_UI_PRESET_TOOL, type EchartHandle, type FormModel, type InteractionSpecLabels, type JsonRenderSpec, type LoadedOpenUiPeers, type OpenUiRendererProps, type OpenUiRuntime, RENDER_UI_TOOL, UI_CATALOG_GROUPS, UI_CATALOG_PROMPT_BUDGET_BYTES, UI_PRESETS, UI_PRESET_NAMES, type UiActionDef, type UiCatalog, type UiCatalogInput, type UiCatalogPromptOptions, type UiCatalogToolSourceOptions, type UiComponentDef, type UiFormScope, type UiPreset, type UiPresetName, type UiSpecIssue, type UiSpecNode, type UiSpecValidation, type UiSurfaceActionDispatch, VERCEL_INTERACTION_TOOL_NAME, type VercelToolInvocation, VercelUiBridge, WEBSKILL_A2UI_CATALOG_ID, WEBSKILL_STYLES_CSS, WEBSKILL_SURFACE_ACTION, WebFormBridge, type ZodRuntime, a2uiComponentSchema, a2uiComponentShapes, applySuggestion, buildA2uiCatalogDefinition, buildRenderResult, chartSpecFromProps, chartToTable, collectFormScopes, collectScopedValues, collectSpecActions, collectValues, createUiCatalogToolSource, defineUiCatalog, ensureStyles, fromA2uiSpecAction, fromA2uiSurfaceAction, fromUiSurfaceActionDispatch, fromVercelToolResult, interactionToFormModel, interactionToUiSpec, loadOpenUiPeers, loadWebSkillLitCatalog, mountEchart, qualifyFieldName, renderBlocks, renderMiniChart, renderMiniMarkdown, renderRenderResult, shapeInteractionValue, toA2uiSpecMessages, toA2uiSurfaceAction, toJsonRenderSpec, toOpenUiSpecLang, toUiSurfaceActionDispatch, toVercelToolInvocation, uiCatalog, uiPreset };

package/dist/ui.js

@@ -1,4 +1,4 @@
-import { k as buildRenderResult } from "./dist-C-Sh0MDU.js";
-import { A as toA2uiSpecMessages, B as a2uiComponentSchema, C as interactionToUiSpec, D as renderMiniChart, E as renderBlocks, F as toVercelToolInvocation, G as mountEchart, H as buildA2uiCatalogDefinition, K as renderMiniMarkdown, L as A2UI_COMMON_TYPES, M as toJsonRenderSpec, N as toOpenUiSpecLang, O as renderRenderResult, P as toUiSurfaceActionDispatch, R as UI_CATALOG_GROUPS, S as interactionToFormModel, T as loadWebSkillLitCatalog, U as chartSpecFromProps, V as a2uiComponentShapes, W as defineUiCatalog, _ as ensureStyles, a as A2UI_VERSION, b as fromUiSurfaceActionDispatch, c as VERCEL_INTERACTION_TOOL_NAME, d as WEBSKILL_SURFACE_ACTION, f as WebFormBridge, g as createUiCatalogToolSource, h as collectValues, i as A2UI_SURFACE_ACTION, j as toA2uiSurfaceAction, k as shapeInteractionValue, l as VercelUiBridge, m as collectSpecActions, n as A2UI_SPEC_ACTION, o as CHART_PALETTE, p as chartToTable, q as uiCatalog, r as A2UI_SPEC_FORM_PATH, s as RENDER_UI_TOOL, t as A2UI_BASIC_CATALOG_ID, u as WEBSKILL_STYLES_CSS, v as fromA2uiSpecAction, w as loadOpenUiPeers, x as fromVercelToolResult, y as fromA2uiSurfaceAction, z as WEBSKILL_A2UI_CATALOG_ID } from "./dist-D9Lcn5Pp.js";
+import { A as buildRenderResult } from "./dist-6C03DShK.js";
+import { $ as defineUiCatalog, A as loadOpenUiPeers, B as toOpenUiSpecLang, C as ensureStyles, D as fromVercelToolResult, E as fromUiSurfaceActionDispatch, F as renderRenderResult, G as A2UI_COMMON_TYPES, H as toVercelToolInvocation, I as shapeInteractionValue, J as WEBSKILL_A2UI_CATALOG_ID, K as UI_CATALOG_GROUPS, L as toA2uiSpecMessages, M as qualifyFieldName, N as renderBlocks, O as interactionToFormModel, P as renderMiniChart, Q as chartSpecFromProps, R as toA2uiSurfaceAction, S as createUiCatalogToolSource, T as fromA2uiSurfaceAction, U as uiPreset, V as toUiSurfaceActionDispatch, X as a2uiComponentShapes, Y as a2uiComponentSchema, Z as buildA2uiCatalogDefinition, _ as chartToTable, a as A2UI_VERSION, b as collectSpecActions, c as RENDER_UI_TOOL, d as VERCEL_INTERACTION_TOOL_NAME, et as mountEchart, f as VercelUiBridge, g as applySuggestion, h as WebFormBridge, i as A2UI_SURFACE_ACTION, j as loadWebSkillLitCatalog, k as interactionToUiSpec, l as UI_PRESETS, m as WEBSKILL_SURFACE_ACTION, n as A2UI_SPEC_ACTION, nt as uiCatalog, o as CHART_PALETTE, p as WEBSKILL_STYLES_CSS, q as UI_CATALOG_PROMPT_BUDGET_BYTES, r as A2UI_SPEC_FORM_PATH, s as DESCRIBE_UI_PRESET_TOOL, t as A2UI_BASIC_CATALOG_ID, tt as renderMiniMarkdown, u as UI_PRESET_NAMES, v as collectFormScopes, w as fromA2uiSpecAction, x as collectValues, y as collectScopedValues, z as toJsonRenderSpec } from "./dist-bewtXYlO.js";
 
-export { A2UI_BASIC_CATALOG_ID, A2UI_COMMON_TYPES, A2UI_SPEC_ACTION, A2UI_SPEC_FORM_PATH, A2UI_SURFACE_ACTION, A2UI_VERSION, CHART_PALETTE, RENDER_UI_TOOL, UI_CATALOG_GROUPS, VERCEL_INTERACTION_TOOL_NAME, VercelUiBridge, WEBSKILL_A2UI_CATALOG_ID, WEBSKILL_STYLES_CSS, WEBSKILL_SURFACE_ACTION, WebFormBridge, a2uiComponentSchema, a2uiComponentShapes, buildA2uiCatalogDefinition, buildRenderResult, chartSpecFromProps, chartToTable, collectSpecActions, collectValues, createUiCatalogToolSource, defineUiCatalog, ensureStyles, fromA2uiSpecAction, fromA2uiSurfaceAction, fromUiSurfaceActionDispatch, fromVercelToolResult, interactionToFormModel, interactionToUiSpec, loadOpenUiPeers, loadWebSkillLitCatalog, mountEchart, renderBlocks, renderMiniChart, renderMiniMarkdown, renderRenderResult, shapeInteractionValue, toA2uiSpecMessages, toA2uiSurfaceAction, toJsonRenderSpec, toOpenUiSpecLang, toUiSurfaceActionDispatch, toVercelToolInvocation, uiCatalog };
+export { A2UI_BASIC_CATALOG_ID, A2UI_COMMON_TYPES, A2UI_SPEC_ACTION, A2UI_SPEC_FORM_PATH, A2UI_SURFACE_ACTION, A2UI_VERSION, CHART_PALETTE, DESCRIBE_UI_PRESET_TOOL, RENDER_UI_TOOL, UI_CATALOG_GROUPS, UI_CATALOG_PROMPT_BUDGET_BYTES, UI_PRESETS, UI_PRESET_NAMES, VERCEL_INTERACTION_TOOL_NAME, VercelUiBridge, WEBSKILL_A2UI_CATALOG_ID, WEBSKILL_STYLES_CSS, WEBSKILL_SURFACE_ACTION, WebFormBridge, a2uiComponentSchema, a2uiComponentShapes, applySuggestion, buildA2uiCatalogDefinition, buildRenderResult, chartSpecFromProps, chartToTable, collectFormScopes, collectScopedValues, collectSpecActions, collectValues, createUiCatalogToolSource, defineUiCatalog, ensureStyles, fromA2uiSpecAction, fromA2uiSurfaceAction, fromUiSurfaceActionDispatch, fromVercelToolResult, interactionToFormModel, interactionToUiSpec, loadOpenUiPeers, loadWebSkillLitCatalog, mountEchart, qualifyFieldName, renderBlocks, renderMiniChart, renderMiniMarkdown, renderRenderResult, shapeInteractionValue, toA2uiSpecMessages, toA2uiSurfaceAction, toJsonRenderSpec, toOpenUiSpecLang, toUiSurfaceActionDispatch, toVercelToolInvocation, uiCatalog, uiPreset };