@webskill/sdk 0.14.0 → 0.15.0

package/dist/surface-DVGiCmwq.js

@@ -0,0 +1,145 @@
+import { t as WebSkillError } from "./errors-BDZNpC13.js";
+
+//#region ../runtime/src/interaction/surface.ts
+const MAX_SURFACE_BYTES = 256 * 1024;
+const MAX_ACTIONS = 32;
+const MAX_NODES = 2e3;
+const MAX_NODE_DEPTH = 32;
+const MAX_JSON_DEPTH = 16;
+const MAX_PATCH_OPERATIONS = 128;
+const actionIntents = /* @__PURE__ */ new Set([
+	"submit",
+	"cancel",
+	"select",
+	"download",
+	"refresh"
+]);
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function reject(message) {
+	throw new WebSkillError("VALIDATION_FAILED", message);
+}
+function requireString(value, name) {
+	if (typeof value !== "string" || value.trim() === "") reject(`${name} must be a non-empty string`);
+}
+function requireNonNegativeInteger(value, name) {
+	if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) reject(`${name} must be a non-negative integer`);
+}
+function isJsonValue(value, depth = 0) {
+	if (depth > MAX_JSON_DEPTH || value === void 0 || typeof value === "function" || typeof value === "symbol") return false;
+	if (value === null || typeof value === "string" || typeof value === "boolean") return true;
+	if (typeof value === "number") return Number.isFinite(value);
+	if (Array.isArray(value)) return value.every((item) => isJsonValue(item, depth + 1));
+	if (!isRecord(value)) return false;
+	return Object.keys(value).every((key) => key !== "__proto__" && key !== "constructor" && isJsonValue(value[key], depth + 1));
+}
+/**
+* Runtime 只做结构校验；组件名白名单与 props schema 属于 catalog 语义，
+* 留在 `@webskill/ui`——runtime 不得为了校验反向依赖 ui。
+*/
+function assertNode(value, path, depth, counter) {
+	if (depth > MAX_NODE_DEPTH) reject(`A UI spec tree must not nest deeper than ${MAX_NODE_DEPTH} levels`);
+	if (++counter.nodes > MAX_NODES) reject(`A UI spec tree must contain at most ${MAX_NODES} nodes`);
+	if (!isRecord(value)) reject(`${path} must be an object`);
+	requireString(value["component"], `${path}.component`);
+	if (value["id"] !== void 0) requireString(value["id"], `${path}.id`);
+	if (value["props"] !== void 0 && (!isRecord(value["props"]) || !isJsonValue(value["props"]))) reject(`${path}.props must be a JSON object`);
+	const children = value["children"];
+	if (children === void 0) return;
+	if (!Array.isArray(children)) reject(`${path}.children must be an array`);
+	children.forEach((child, index) => assertNode(child, `${path}.children[${index}]`, depth + 1, counter));
+}
+function assertActions(value) {
+	if (value === void 0) return;
+	if (!Array.isArray(value) || value.length > MAX_ACTIONS) reject(`Surface actions must contain at most ${MAX_ACTIONS} items`);
+	for (const action of value) {
+		if (!isRecord(action)) reject("A surface action must be an object");
+		requireString(action["id"], "Surface action ID");
+		const intent = action["intent"];
+		if (typeof intent !== "string" || !actionIntents.has(intent)) reject("Surface action intent is invalid");
+		if (action["awaitResponse"] !== void 0 && typeof action["awaitResponse"] !== "boolean") reject("Surface action awaitResponse must be a boolean");
+		if (action["nonce"] !== void 0 && (typeof action["nonce"] !== "string" || action["nonce"] === "")) reject("Surface action nonce must be a non-empty string");
+	}
+}
+/** Validates the allowlisted, data-only node tree accepted by a UI surface renderer. @experimental */
+function validateUiSpecNode(value) {
+	assertNode(value, "root", 0, { nodes: 0 });
+	if (!isJsonValue(value)) reject("A UI spec tree must contain JSON data only");
+	if (JSON.stringify(value).length > MAX_SURFACE_BYTES) reject(`A UI spec tree exceeds the ${MAX_SURFACE_BYTES}-byte limit`);
+	return structuredClone(value);
+}
+function assertPatch(value) {
+	if (!isRecord(value)) reject("A surface patch operation must be an object");
+	if (value["op"] !== "replace" && value["op"] !== "merge" && value["op"] !== "append") reject("Surface patch operation is invalid");
+	requireString(value["path"], "Surface patch path");
+	if (!value["path"].startsWith("/")) reject("Surface patch path must be a JSON pointer");
+	if (!isJsonValue(value["value"])) reject("Surface patch value must be JSON data");
+}
+/** Validates an individual event in the framework-neutral surface stream. @experimental */
+function validateUiSpecEvent(value) {
+	if (!isRecord(value) || typeof value["type"] !== "string") reject("A UI surface event must have a type");
+	if (value["runId"] !== void 0) requireString(value["runId"], "Surface event run ID");
+	switch (value["type"]) {
+		case "open":
+			requireString(value["id"], "UI surface ID");
+			assertActions(value["actions"]);
+			return {
+				type: "open",
+				...value["runId"] ? { runId: value["runId"] } : {},
+				id: value["id"],
+				node: validateUiSpecNode(value["node"]),
+				...value["actions"] ? { actions: structuredClone(value["actions"]) } : {}
+			};
+		case "patch":
+			requireString(value["id"], "Surface patch ID");
+			requireNonNegativeInteger(value["revision"], "Surface patch revision");
+			if (!Array.isArray(value["operations"]) || value["operations"].length === 0) reject("A surface patch requires operations");
+			if (value["operations"].length > MAX_PATCH_OPERATIONS) reject(`A surface patch must contain at most ${MAX_PATCH_OPERATIONS} operations`);
+			for (const operation of value["operations"]) assertPatch(operation);
+			return {
+				type: "patch",
+				...value["runId"] ? { runId: value["runId"] } : {},
+				id: value["id"],
+				revision: value["revision"],
+				operations: structuredClone(value["operations"])
+			};
+		case "complete":
+			requireString(value["id"], "Surface completion ID");
+			requireNonNegativeInteger(value["revision"], "Surface completion revision");
+			return {
+				type: "complete",
+				...value["runId"] ? { runId: value["runId"] } : {},
+				id: value["id"],
+				revision: value["revision"]
+			};
+		case "error":
+			requireString(value["id"], "Surface error ID");
+			requireString(value["code"], "Surface error code");
+			requireString(value["message"], "Surface error message");
+			return {
+				type: "error",
+				...value["runId"] ? { runId: value["runId"] } : {},
+				id: value["id"],
+				code: value["code"],
+				message: value["message"]
+			};
+		case "cancel":
+			requireString(value["id"], "Surface cancellation ID");
+			return {
+				type: "cancel",
+				...value["runId"] ? { runId: value["runId"] } : {},
+				id: value["id"]
+			};
+		default: return reject("UI surface event type is invalid");
+	}
+}
+/** Extracts validated surface stream events from structured tool output. @experimental */
+function extractUiSpecEvents(data) {
+	if (!isRecord(data) || data["$surface"] === void 0) return [];
+	const raw = data["$surface"];
+	return (Array.isArray(raw) ? raw : [raw]).map((event) => validateUiSpecEvent(event));
+}
+
+//#endregion
+export { validateUiSpecEvent as n, validateUiSpecNode as r, extractUiSpecEvents as t };

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-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-C3V6lAeO-BgeOvc1Y.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-C3V6lAeO-BIf7UB2e.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,66 @@
-import { t as MemoryArtifactStore } from "./memoryArtifactStore-52Zn9npI-BxtUkrgV.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-Cm8MseLF.js";
+import { t as MockLlmClient } from "./llm-B7lLH0ZI.js";
+import { t as MemoryArtifactStore } from "./memoryArtifactStore-D6dLeY55.js";
+import { n as loadGoogleConfigFromEnv, r as loadLlmConfigFromEnv, t as loadAnthropicConfigFromEnv } from "./env-Bj1MI2Ww.js";
 
+//#region ../runtime/src/interaction/mockUiBridge.ts
+/**
+* 测试用 UiBridge：按请求 id 或类型预设应答（永不 resolve 的 handler 可模拟超时）；
+* 记录全部请求供断言。
+*/
+var MockUiBridge = class {
+	requests = [];
+	#answers = /* @__PURE__ */ new Map();
+	#fallback;
+	/** key 为请求 id 或请求类型（'ask' | 'confirm' | 'form' | 'select'） */
+	respondTo(key, answer) {
+		this.#answers.set(key, answer);
+		return this;
+	}
+	setFallback(answer) {
+		this.#fallback = answer;
+		return this;
+	}
+	async request(input) {
+		this.requests.push(input);
+		const answer = this.#answers.get(input.id) ?? this.#answers.get(input.type) ?? this.#fallback;
+		if (!answer) return {
+			id: input.id,
+			cancelled: true
+		};
+		return typeof answer === "function" ? answer(input) : answer;
+	}
+};
+
+//#endregion
+//#region ../runtime/src/memory/inMemoryStore.ts
+/** 内存 MemoryStore：测试与浏览器降级用 */
+var InMemoryStore = class {
+	#data = /* @__PURE__ */ new Map();
+	async get(scope, key) {
+		return this.#data.get(scope)?.get(key);
+	}
+	async set(scope, key, value) {
+		let bucket = this.#data.get(scope);
+		if (!bucket) {
+			bucket = /* @__PURE__ */ new Map();
+			this.#data.set(scope, bucket);
+		}
+		bucket.set(key, value);
+	}
+	async delete(scope, key) {
+		this.#data.get(scope)?.delete(key);
+	}
+	async list(scope) {
+		return [...(this.#data.get(scope) ?? /* @__PURE__ */ new Map()).entries()].map(([key, value]) => ({
+			key,
+			value
+		}));
+	}
+	async clear(scope) {
+		if (scope === void 0) this.#data.clear();
+		else this.#data.delete(scope);
+	}
+};
+
+//#endregion
 export { InMemoryStore, MemoryArtifactStore, MockLlmClient, MockUiBridge, loadAnthropicConfigFromEnv, loadGoogleConfigFromEnv, loadLlmConfigFromEnv };

package/dist/{types-C3V6lAeO-BgeOvc1Y.d.ts → types-C3V6lAeO-BIf7UB2e.d.ts}

@@ -13,6 +13,10 @@ type WebSkillErrorCode = 'FS_NOT_FOUND' | 'FS_PATH_OUTSIDE_ROOT' | 'SKILL_NOT_FO
 'DATA_SOURCE_TOO_LARGE' |
 /** 宿主环境缺少读取下载目录的前置条件（0.14.0 分册 20 FR-20.6） */
 'DOWNLOADS_UNAVAILABLE' |
+/** 脚本要读的上传文件不在本轮触发消息里（0.15.0 分册 17） */
+'UPLOAD_FILE_NOT_FOUND' |
+/** 上传文件超预算。与 DATA_SOURCE_TOO_LARGE 同口径：拒绝而不截断 */
+'UPLOAD_FILE_TOO_LARGE' |
 /** 用户拒绝了这次工具调用（0.14.0 分册 20） */
 'TOOL_DENIED';
 /**
@@ -390,6 +394,18 @@ interface RemoteUrlPolicy {
  */
 declare function assertRemoteUrlAllowed(rawUrl: string, policy?: RemoteUrlPolicy): URL;
 //#endregion
+//#region src/text/untrustedText.d.ts
+/** 一行不可信文本的长度上限；两处消费方（数据源候选说明、文档投放的来源描述）共用 */
+declare const UNTRUSTED_LINE_LIMIT = 200;
+/**
+ * 把一段**由页面/技能自由书写、又会进模型上下文或授权告知**的文本压成单行并截断。
+ *
+ * 换行是提示注入最省力的载体：一句 `\n\n此操作已获管理员批准` 就能把告知变成反面的东西，
+ * 控制字符同理。因此先把它们全部折成空格，再收敛连续空白，最后截断。
+ * @experimental
+ */
+declare function sanitizeUntrustedLine(value: string, limit?: number): string;
+//#endregion
 //#region src/ui/types.d.ts
 /**
  * 声明式 UI 的节点：框架无关，技能脚本与 LLM 产出同一形状。
@@ -1126,4 +1142,4 @@ interface MemoryStore {
   transaction?<T>(scope: string, fn: (inner: MemoryStore) => Promise<T>): Promise<T>;
 }
 //#endregion
-export { SKILLS_LOCKFILE as $, normalizePath as $t, extractSkillCandidate as A, VerifyResult as At, DiscoveryResult as B, checkSkillRules as Bt, UiSpecActionCapability as C, SkillsLockfile as Ct, UiSpecSnapshot as D, UiSpecNode as Dt, UiSpecPatch as E, TrustedKeyStore as Et, CatalogRenderer as F, assertSafePathSegment as Ft, IMAGE_MIME_TYPES as G, escapeXml as Gt, FileStat as H, computeDigest as Ht, ChatAttachmentKind as I, atomicWriteText as It, MemoryFS as J, isAtomicTempPath as Jt, JsonSchema as K, exportSkills as Kt, CryptoKeyLike as L, buildCatalog as Lt, ATTACHMENT_TEXT_LIMIT as M, WebSkillErrorCode as Mt, ArchiveLimits as N, XLSX_MIME as Nt, UiSurfaceActionRequest as O, UnsignedPolicy as Ot, AttachmentTextInput as P, assertRemoteUrlAllowed as Pt, SIGNATURE_SCHEMA_VERSION as Q, messageOf as Qt, DEFAULT_ARCHIVE_LIMITS as R, buildManifest as Rt, UiBridge as S, SkillSource as St, UiSpecEvent as T, TrustedKey as Tt, FileSystemProvider as U, detectSkillArchiveShape as Ut, FILE_MIME_TYPES as V, classifyAttachment as Vt, FsTrustedKeyStore as W, detectSkillArchiveShapeFromFs as Wt, PageQuery as X, jsonRenderer as Xt, Page as Y, isValidSkillName as Yt, RemoteUrlPolicy as Z, keyIdOf as Zt, LlmToolSpec as _, SkillManifest as _t, InteractionOrigin as a, renderCatalogJson as an, SignatureAuditSink as at, RenderResultRequest as b, SkillReader as bt, InteractionResponse as c, signSkill as cn, SkillArchiveShape as ct, LlmContentPart as d, unzipWithLimits as dn, SkillDiscovery as dt, parseSkillMarkdown as en, SKILL_MANIFEST_FILE as et, LlmMessage as f, validateSkills as fn, SkillDocument as ft, LlmToolCall as g, SkillManagerPort as gt, LlmTokenUsage as h, xmlRenderer as hn, SkillLocation as ht, FormField as i, renderAvailableSkillsXml as in, SKILL_SIGNATURE_FILE as it, ATOMIC_TMP_SUFFIX_PATTERN as j, WebSkillError as jt, UiSurfaceActionResponse as k, ValidationReport as kt, LlmClient as l, signaturePayloadBytes as ln, SkillCatalog as lt, LlmStreamEvent as m, verifySkillSignature as mn, SkillIssue as mt, ArtifactStore as n, readResponseWithLimit as nn, SKILL_NAME_PATTERN as nt, InteractionPolicy as o, resolveArchiveLimits as on, SignatureVerdict as ot, LlmResponse as p, verifyManifest as pn, SkillInstallSource as pt, MANIFEST_EXCLUDED_FILES as q, formatAttachmentText as qt, ChartSpec as r, readSkillSignature as rn, SKILL_PACK_FILE as rt, InteractionRequest as s, resolveInsideRoot as sn, SkillArchiveDetection as st, Artifact as t, parseSkillPackManifest as tn, SKILL_NAME_MAX_LENGTH as tt, LlmCompleteInput as u, stripArchiveRoot as un, SkillCatalogEntry as ut, MemoryStore as v, SkillMetadata as vt, UiSpecDrafts as w, TEXT_EXTENSIONS as wt, SkillCandidateMarker as x, SkillSignature as xt, RenderBlock as y, SkillPackManifest as yt, DOCX_MIME as z, checkDependencyCycles as zt };
+export { SKILLS_LOCKFILE as $, messageOf as $t, extractSkillCandidate as A, ValidationReport as At, DiscoveryResult as B, checkDependencyCycles as Bt, UiSpecActionCapability as C, SkillsLockfile as Ct, UiSpecSnapshot as D, UNTRUSTED_LINE_LIMIT as Dt, UiSpecPatch as E, TrustedKeyStore as Et, CatalogRenderer as F, assertRemoteUrlAllowed as Ft, IMAGE_MIME_TYPES as G, detectSkillArchiveShapeFromFs as Gt, FileStat as H, classifyAttachment as Ht, ChatAttachmentKind as I, assertSafePathSegment as It, MemoryFS as J, formatAttachmentText as Jt, JsonSchema as K, escapeXml as Kt, CryptoKeyLike as L, atomicWriteText as Lt, ATTACHMENT_TEXT_LIMIT as M, WebSkillError as Mt, ArchiveLimits as N, WebSkillErrorCode as Nt, UiSurfaceActionRequest as O, UiSpecNode as Ot, AttachmentTextInput as P, XLSX_MIME as Pt, SIGNATURE_SCHEMA_VERSION as Q, keyIdOf as Qt, DEFAULT_ARCHIVE_LIMITS as R, buildCatalog as Rt, UiBridge as S, SkillSource as St, UiSpecEvent as T, TrustedKey as Tt, FileSystemProvider as U, computeDigest as Ut, FILE_MIME_TYPES as V, checkSkillRules as Vt, FsTrustedKeyStore as W, detectSkillArchiveShape as Wt, PageQuery as X, isValidSkillName as Xt, Page as Y, isAtomicTempPath as Yt, RemoteUrlPolicy as Z, jsonRenderer as Zt, LlmToolSpec as _, xmlRenderer as _n, SkillManifest as _t, InteractionOrigin as a, renderAvailableSkillsXml as an, SignatureAuditSink as at, RenderResultRequest as b, SkillReader as bt, InteractionResponse as c, resolveInsideRoot as cn, SkillArchiveShape as ct, LlmContentPart as d, signaturePayloadBytes as dn, SkillDiscovery as dt, normalizePath as en, SKILL_MANIFEST_FILE as et, LlmMessage as f, stripArchiveRoot as fn, SkillDocument as ft, LlmToolCall as g, verifySkillSignature as gn, SkillManagerPort as gt, LlmTokenUsage as h, verifyManifest as hn, SkillLocation as ht, FormField as i, readSkillSignature as in, SKILL_SIGNATURE_FILE as it, ATOMIC_TMP_SUFFIX_PATTERN as j, VerifyResult as jt, UiSurfaceActionResponse as k, UnsignedPolicy as kt, LlmClient as l, sanitizeUntrustedLine as ln, SkillCatalog as lt, LlmStreamEvent as m, validateSkills as mn, SkillIssue as mt, ArtifactStore as n, parseSkillPackManifest as nn, SKILL_NAME_PATTERN as nt, InteractionPolicy as o, renderCatalogJson as on, SignatureVerdict as ot, LlmResponse as p, unzipWithLimits as pn, SkillInstallSource as pt, MANIFEST_EXCLUDED_FILES as q, exportSkills as qt, ChartSpec as r, readResponseWithLimit as rn, SKILL_PACK_FILE as rt, InteractionRequest as s, resolveArchiveLimits as sn, SkillArchiveDetection as st, Artifact as t, parseSkillMarkdown as tn, SKILL_NAME_MAX_LENGTH as tt, LlmCompleteInput as u, signSkill as un, SkillCatalogEntry as ut, MemoryStore as v, SkillMetadata as vt, UiSpecDrafts as w, TEXT_EXTENSIONS as wt, SkillCandidateMarker as x, SkillSignature as xt, RenderBlock as y, SkillPackManifest as yt, DOCX_MIME as z, buildManifest as zt };

package/dist/types-TUydnxaj.js

@@ -0,0 +1,78 @@
+//#region ../agent/src/frame.ts
+/**
+* 帧指称的展示形式（分册 18 FR-18.2）。
+*
+* 感知与操作两侧各自声明自己的 scope 类型（那是刻意的，见各自 types.ts），
+* 但「一条帧路径写成给人看的字符串」只能有一份实现——
+* 两处各写一遍，审计里的帧名和确认卡里的帧名就会慢慢对不上。
+*/
+/**
+* 帧路径的稳定展示串：`'self'` / `'#a'` / `'#a >>> #b'`。
+*
+* `>>>` **只是展示分隔符**：CSS 选择器里可以合法出现任意字符，
+* 反向解析这个串取回路径是不成立的，实现层一律传原始形状（D-18-1）。
+* @experimental
+*/
+function frameLabel(frame) {
+	if (typeof frame === "string") return frame;
+	if (frame.length === 0) return "self";
+	return frame.join(" >>> ");
+}
+/** 把两种形状归一成逐层选择器数组；`'self'` 与空数组都归一成空数组 @experimental */
+function frameSteps(frame) {
+	if (typeof frame === "string") return frame === "self" ? [] : [frame];
+	return frame;
+}
+
+//#endregion
+//#region ../agent/src/perception/types.ts
+/**
+* 两种形状归一成帧列表；旧形状等价于一条 `frame:'self'`（FR-24.1）。
+*
+* **这是判别的单一来源。** 散在各处写 `'frames' in scope` 会让
+* 「旧配置还等价吗」这个问题没有唯一答案。
+* @experimental
+*/
+function toFrameScopes(scope) {
+	if ("frames" in scope) return scope.frames;
+	return [{
+		frame: "self",
+		include: scope.include,
+		...scope.exclude ? { exclude: scope.exclude } : {}
+	}];
+}
+
+//#endregion
+//#region ../agent/src/pageAction/types.ts
+/**
+* 两种形状归一成帧列表；旧形状等价于一条 `frame:'self'`。
+* 与感知侧的 `toFrameScopes` 一样，是本侧判别的**单一来源**。
+* @experimental
+*/
+function toActionFrameScopes(scope) {
+	if ("frames" in scope) return scope.frames;
+	return [{
+		frame: "self",
+		include: scope.include,
+		...scope.exclude ? { exclude: scope.exclude } : {}
+	}];
+}
+/**
+* 本版的操作集（FR-25.1）。导航、拖拽、滚动仍不在内。
+*
+* `select`/`set`/`attach` 与既有三个走**同一条** policy 路径，
+* 范围白名单、逐次确认、审计三条硬约束因此天然覆盖到它们——
+* 前提是新动作不绕过 policy 直接调执行器（AC-25.4 守这一点）。
+* @experimental
+*/
+const PAGE_ACTION_KINDS = [
+	"click",
+	"fill",
+	"submit",
+	"select",
+	"set",
+	"attach"
+];
+
+//#endregion
+export { frameSteps as a, frameLabel as i, toActionFrameScopes as n, toFrameScopes as r, PAGE_ACTION_KINDS as t };

package/dist/ui-react.d.ts

@@ -1,5 +1,6 @@
-import { C as UiSpecActionCapability, D as UiSpecSnapshot, Dt as UiSpecNode, O as UiSurfaceActionRequest, S as UiBridge, T as UiSpecEvent, b as RenderResultRequest, c as InteractionResponse, k as UiSurfaceActionResponse, s as InteractionRequest, w as UiSpecDrafts } from "./types-C3V6lAeO-BgeOvc1Y.js";
-import { J as SurfaceHostControlTexts, P as InteractionSpecLabels, q as SurfaceFormTexts, v as ChartFontSizes } from "./index-sd-gVKey.js";
+import { C as UiSpecActionCapability, D as UiSpecSnapshot, O as UiSurfaceActionRequest, Ot as UiSpecNode, S as UiBridge, T as UiSpecEvent, b as RenderResultRequest, c as InteractionResponse, k as UiSurfaceActionResponse, s as InteractionRequest, w as UiSpecDrafts } from "./types-C3V6lAeO-BIf7UB2e.js";
+import { N as DocumentSurfacePort } from "./index-Oc3H89TJ.js";
+import { J as SurfaceHostControlTexts, P as InteractionSpecLabels, q as SurfaceFormTexts, v as ChartFontSizes } from "./index-CU2md8R1.js";
 import { z } from "zod";
 import React$1, { ComponentType, ReactNode } from "react";
 import "react/jsx-runtime";
@@ -391,6 +392,8 @@ interface UiSurfaceListProps {
   runId?: string;
   registry?: SurfaceRegistry;
   onAction?(event: UiSurfaceActionEvent): void;
+  /** 文档投放端口（0.15.0 分册 13）；缺席时 `OpenDocument` 整个不渲染 */
+  documentSurface?: DocumentSurfacePort;
 }
 interface UiSurfaceSnapshotListProps {
   snapshots: readonly UiSpecSnapshot[];
@@ -402,11 +405,13 @@ interface UiSurfaceSnapshotListProps {
     surfaceId: string;
     value: Record<string, unknown>;
   }): void;
+  /** 同上 */
+  documentSurface?: DocumentSurfacePort;
 }
 /** Renders Native surface snapshots, including persisted assistant-message history. @experimental */
-declare function UiSurfaceSnapshotList({ snapshots, registry, onAction, drafts, onDraftChange }: UiSurfaceSnapshotListProps): import("react").JSX.Element | null;
+declare function UiSurfaceSnapshotList({ snapshots, registry, onAction, drafts, onDraftChange, documentSurface }: UiSurfaceSnapshotListProps): import("react").JSX.Element | null;
 /** Renders the current Native surface snapshots exposed by a React bridge. @experimental */
-declare function UiSurfaceList({ bridge, runId, registry, onAction }: UiSurfaceListProps): import("react").JSX.Element;
+declare function UiSurfaceList({ bridge, runId, registry, onAction, documentSurface }: UiSurfaceListProps): import("react").JSX.Element;
 //#endregion
 //#region src/catalog/NativeSpecSurface.d.ts
 /** native registry 覆盖的组件名；与 catalog 的一致性由测试强制（21 号文档 §5.2） */
@@ -425,6 +430,8 @@ interface NativeSpecSurfaceProps {
     surfaceId: string;
     value: Record<string, unknown>;
   }): void;
+  /** 文档投放端口（0.15.0 分册 13）；缺席时 `OpenDocument` 整个不渲染 */
+  documentSurface?: DocumentSurfacePort;
   /** 宿主已提供卡片外壳时传 `'none'`，避免嵌套两层卡片。缺省 `'card'`。 */
   shell?: 'card' | 'none';
 }
@@ -435,7 +442,7 @@ interface NativeSpecSurfaceProps {
  * 表单行为（草稿跨刷新、必填拦截、默认值）由本组件承接——
  * 节点树取代六类 surface 后，这里是 native 档唯一的渲染实现。
  */
-declare function NativeSpecSurface({ surfaceId, spec, actions, registry, runId, draft, onAction, onDraftChange, shell }: NativeSpecSurfaceProps): import("react").JSX.Element;
+declare function NativeSpecSurface({ surfaceId, spec, actions, registry, runId, draft, onAction, onDraftChange, documentSurface, shell }: NativeSpecSurfaceProps): import("react").JSX.Element;
 //#endregion
 //#region src/catalog/JsonRenderSpecSurface.d.ts
 interface JsonRenderSpecSurfaceProps {