@vcp-dev/contracts 0.10.20 → 0.10.22

package/dist/input-context-bundle.d.ts

@@ -137,7 +137,7 @@ export declare const MAX_DOCUMENT_SOURCES_PER_SITE = 2;
  *
  * multipart/form-data 字段值一律是字符串:`consent_cross_border` 用字面量联合只放行
  * `true` / `"true"`(其余含 `"false"` 一律拒)。**不用 `.transform()`**——会破坏
- * `z.toJSONSchema` → OpenAPI(该 schema 进 `@ApiBody`;见 tasks/lessons.md 教训);
+ * `z.toJSONSchema` → OpenAPI(该 schema 进 `@ApiBody`);
  * 服务端用 `isConsentGranted()` 把 `true`/`"true"` 归一为已同意布尔。
  */
 export declare const CreateDocumentUploadRequestSchema: z.ZodObject<{

package/dist/media-library.d.ts

@@ -101,32 +101,19 @@ export declare const UploadMediaLibraryAssetResponseSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type UploadMediaLibraryAssetResponse = z.infer<typeof UploadMediaLibraryAssetResponseSchema>;
 export declare const AI_IMAGE_GENERATION_MAX_QUANTITY = 4;
-export declare const AI_IMAGE_GENERATION_ENTITLEMENT = "site.image_generation.max";
-export declare const AiImageGenerationPrecheckRequestSchema: z.ZodObject<{
-    quantity: z.ZodNumber;
-}, z.core.$strip>;
-export type AiImageGenerationPrecheckRequest = z.infer<typeof AiImageGenerationPrecheckRequestSchema>;
-export declare const AiImageGenerationQuotaSchema: z.ZodObject<{
-    available: z.ZodBoolean;
-    remaining: z.ZodNullable<z.ZodNumber>;
-    unlimited: z.ZodBoolean;
-    max_quantity: z.ZodNumber;
-}, z.core.$strip>;
-export type AiImageGenerationQuota = z.infer<typeof AiImageGenerationQuotaSchema>;
-export declare const AiImageGenerationPrecheckResponseSchema: z.ZodObject<{
-    code: z.ZodLiteral<0>;
-    message: z.ZodString;
-    data: z.ZodObject<{
-        available: z.ZodBoolean;
-        remaining: z.ZodNullable<z.ZodNumber>;
-        unlimited: z.ZodBoolean;
-        max_quantity: z.ZodNumber;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-export type AiImageGenerationPrecheckResponse = z.infer<typeof AiImageGenerationPrecheckResponseSchema>;
 export declare const GenerateAiImagesRequestSchema: z.ZodObject<{
     pageName: z.ZodString;
-    pageType: z.ZodString;
+    pageType: z.ZodEnum<{
+        landing_page: "landing_page";
+        general_page: "general_page";
+        detail_page: "detail_page";
+        list_page: "list_page";
+        category_page: "category_page";
+        tag_page: "tag_page";
+        author_page: "author_page";
+        search_page: "search_page";
+        date_page: "date_page";
+    }>;
     sectionTitle: z.ZodString;
     nearbyTitle: z.ZodString;
     nearbyBody: z.ZodString;
@@ -134,49 +121,21 @@ export declare const GenerateAiImagesRequestSchema: z.ZodObject<{
     aspectRatio: z.ZodString;
 }, z.core.$strip>;
 export type GenerateAiImagesRequest = z.infer<typeof GenerateAiImagesRequestSchema>;
-export declare const GeneratedAiImageResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+export declare const GeneratedAiImageResultSchema: z.ZodObject<{
     index: z.ZodNumber;
     ok: z.ZodLiteral<true>;
-    url: z.ZodURL;
-    request_id: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    index: z.ZodNumber;
-    ok: z.ZodLiteral<false>;
-    error: z.ZodEnum<{
-        quota: "quota";
-        generate: "generate";
-        network: "network";
-    }>;
-    message: z.ZodString;
-    request_id: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>], "ok">;
+    url: z.ZodString;
+}, z.core.$strip>;
 export type GeneratedAiImageResult = z.infer<typeof GeneratedAiImageResultSchema>;
 export declare const GenerateAiImagesResponseSchema: z.ZodObject<{
     code: z.ZodLiteral<0>;
     message: z.ZodString;
     data: z.ZodObject<{
-        quota: z.ZodObject<{
-            available: z.ZodBoolean;
-            remaining: z.ZodNullable<z.ZodNumber>;
-            unlimited: z.ZodBoolean;
-            max_quantity: z.ZodNumber;
-        }, z.core.$strip>;
-        items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
             index: z.ZodNumber;
             ok: z.ZodLiteral<true>;
-            url: z.ZodURL;
-            request_id: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
-            index: z.ZodNumber;
-            ok: z.ZodLiteral<false>;
-            error: z.ZodEnum<{
-                quota: "quota";
-                generate: "generate";
-                network: "network";
-            }>;
-            message: z.ZodString;
-            request_id: z.ZodNullable<z.ZodString>;
-        }, z.core.$strip>], "ok">>;
+            url: z.ZodString;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type GenerateAiImagesResponse = z.infer<typeof GenerateAiImagesResponseSchema>;

package/dist/page-template.d.ts

@@ -78,6 +78,12 @@ export declare const PageTemplateTaskSchema: z.ZodObject<{
     created_at: z.ZodString;
     started_at: z.ZodNullable<z.ZodString>;
     finished_at: z.ZodNullable<z.ZodString>;
+    advisories: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<{
+            preexisting_placeholder_media: "preexisting_placeholder_media";
+        }>;
+        block_ids: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>>>;
     execution_scene: z.ZodLiteral<"page_template_create">;
     external_run_id: z.ZodString;
     external_thread_id: z.ZodString;
@@ -111,6 +117,12 @@ export declare const PageTemplateCreateResponseSchema: z.ZodObject<{
         created_at: z.ZodString;
         started_at: z.ZodNullable<z.ZodString>;
         finished_at: z.ZodNullable<z.ZodString>;
+        advisories: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            code: z.ZodEnum<{
+                preexisting_placeholder_media: "preexisting_placeholder_media";
+            }>;
+            block_ids: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>>>;
         execution_scene: z.ZodLiteral<"page_template_create">;
         external_run_id: z.ZodString;
         external_thread_id: z.ZodString;
@@ -138,6 +150,12 @@ export declare const PageTemplatePromoteResponseSchema: z.ZodObject<{
     page_path: z.ZodString;
     route_id: z.ZodString;
     snapshot_id: z.ZodUUID;
+    advisories: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<{
+            preexisting_placeholder_media: "preexisting_placeholder_media";
+        }>;
+        block_ids: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>>;
 }, z.core.$strict>;
 export type PageTemplatePromoteResponse = z.infer<typeof PageTemplatePromoteResponseSchema>;
 export declare const PageTemplateCleanupResponseSchema: z.ZodObject<{
@@ -148,6 +166,12 @@ export declare const PageTemplateCleanupResponseSchema: z.ZodObject<{
     page_path: z.ZodString;
     route_id: z.ZodString;
     snapshot_id: z.ZodUUID;
+    advisories: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<{
+            preexisting_placeholder_media: "preexisting_placeholder_media";
+        }>;
+        block_ids: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>>;
 }, z.core.$strict>;
 export type PageTemplateCleanupResponse = z.infer<typeof PageTemplateCleanupResponseSchema>;
 export declare const PageTemplateErrorCodeSchema: z.ZodEnum<{

package/dist/site-edit-source.d.ts

@@ -1,12 +1,19 @@
 import { z } from "zod";
 export declare const SITE_EDIT_SOURCE_ALLOWED_ROOT_FILES: readonly ["design.md", "DESIGN.md"];
 export declare const SITE_EDIT_SOURCE_ALLOWED_DIRS: readonly ["components/site", "src/components/site", "lib/generated", "src/lib/generated", "public"];
+/**
+ * 目录白名单之外、按**全等**放行的模板层文件：路径在模板里，内容却归每个站。
+ *
+ * 404 正文由 `app/not-found.tsx` 与设计器入口 `app/system/not-found/page.tsx` 共用，
+ * 文案是普通文字，设计器改完要能写回；不放开整个 `components/system/`。
+ */
+export declare const SITE_EDIT_SOURCE_ALLOWED_SYSTEM_FILES: readonly ["components/system/not-found-content.tsx", "src/components/system/not-found-content.tsx"];
 export declare const SITE_EDIT_SOURCE_ALLOWED_APP_FILES: readonly ["app/globals.css", "src/app/globals.css"];
 export declare const SITE_EDIT_TEXT_SOURCE_EXTENSIONS: readonly [".cjs", ".css", ".cts", ".html", ".js", ".json", ".jsx", ".md", ".mdx", ".mjs", ".mts", ".ts", ".tsx", ".txt", ".yaml", ".yml"];
 export declare const SITE_EDIT_SOURCE_DELETE_CAPABILITY: "source-delete";
 export declare const SiteEditSourceDeleteCapabilitySchema: z.ZodLiteral<"source-delete">;
 export type SiteEditSourceDeleteCapability = z.infer<typeof SiteEditSourceDeleteCapabilitySchema>;
-export type SiteEditSourceDeleteProtectionReason = "design-document" | "route-entry" | "app-global-style" | "generated-media-manifest";
+export type SiteEditSourceDeleteProtectionReason = "design-document" | "route-entry" | "app-global-style" | "generated-media-manifest" | "system-page";
 export declare const SiteEditSourcePathSchema: z.ZodString;
 export type SiteEditSourcePath = z.infer<typeof SiteEditSourcePathSchema>;
 export declare const SiteEditSourceDirectoryPathSchema: z.ZodString;

package/dist/site-edit-version.d.ts

@@ -5,7 +5,7 @@
  *
  * 由 release-edit-engine-packages.ts 在 bump 版本时自动更新。
  */
-export declare const CURRENT_EDIT_ENGINE_VERSION = "0.10.20";
+export declare const CURRENT_EDIT_ENGINE_VERSION = "0.10.22";
 export declare const EDIT_ENGINE_VERSION_HEADER = "x-vcp-edit-engine-version";
 export declare const EDIT_ENGINE_VERSION_SOURCE_HEADER = "x-vcp-edit-engine-version-source";
 export type EditEngineVersionSource = "explicit" | "fallback_current" | "system_current";

package/dist/site-localization-fields.d.ts

@@ -17,7 +17,7 @@ import { z } from "zod";
  *   落空、整页 SEO 元数据全部丢失且不报错。
  * - **根布局 `metadata`**（平台确定性产出的站级元数据）：站名、标题模板、
  *   OpenGraph / Twitter 的标题与描述是文案；`metadataBase`、`openGraph.type`、
- *   `twitter.card`、各类图片地址是机器值。
+ *   `twitter.card`、各类图片地址、`robots` 索引指令是机器值。
  * - **`NAV_ITEMS`**（导航静态兜底数据）：`label` 是导航上印着的字；`href` 是路由、
  *   `targetType` 是渲染分支的判别式、`iconKey` 是图标注册表的键。
  *
@@ -36,8 +36,9 @@ import { z } from "zod";
  *
  * - `*`：数组下标（查表前把具体下标归一成这一段）。
  * - `**`：**本段及其整棵子树**。只用在取值形状开放、无法逐字段枚举的地方
- *   （`schema_json` 是任意 JSON-LD，`meta_tags_json` 是键由 CMS 决定的开放记录）。
- *   这两处按机器值整体处理是**故意往漏翻倒**：真有一天生成侧往里写文案，结果是
+ *   （`schema_json` 是任意 JSON-LD，`meta_tags_json` 是键由 CMS 决定的开放记录，
+ *   根布局 `robots` 是上游 Next 的指令对象，形状随 Next 版本开放）。
+ *   这几处按机器值整体处理是**故意往漏翻倒**：真有一天生成侧往里写文案，结果是
  *   那段不被翻译（可见、可查），而不是把结构化数据译坏（静默、难查）。
  */
 /** 已登记的混合结构。取值与抽取器的单元 `kind` 同名，便于对读。 */
@@ -77,9 +78,17 @@ export declare const PageSeoDeclSchema: z.ZodObject<{
  * `keywords`、`openGraph.url` / `locale`——它们今天只出现在运行时返回值里，但形状
  * 同源，一并登记免得哪天被内联进源码时整份文件停翻。
  *
- * 这里**没有**声明 `robots` / `icons` / `verification` 等其余 Next 元数据键：真出现
- * 了就是「已登记结构长出了没登记的字段」，按设计整文件本轮不翻并记降级，由人来
- * 决定新键是文案还是机器值。这是清单相对上游开放类型必然会漂的那一面，方向安全。
+ * `robots` 是平台自己写进系统页的：`app/system/not-found/page.tsx`（模板）与
+ * `app/search/page.tsx`（产品搜索）都用 `export const metadata` 声明
+ * `robots: { index: false, follow: false }`——这两条路由返回 200，不挡就会被收录。
+ * 它是给爬虫的指令，取值要么是布尔开关，要么是 `googleBot` 这类指令串
+ * （`"max-snippet:-1"`），没有一处是访客读的字，因此整棵子树按机器值登记。
+ * 没登记之前，这两份文件在翻译链路上整文件不译（搜索页标题停在主站语种），在可见
+ * 文本导出里直接让整站导出失败。
+ *
+ * 这里**没有**声明 `icons` / `verification` 等其余 Next 元数据键：真出现了就是
+ * 「已登记结构长出了没登记的字段」，按设计整文件本轮不翻并记降级，由人来决定新键
+ * 是文案还是机器值。这是清单相对上游开放类型必然会漂的那一面，方向安全。
  */
 export declare const RootLayoutMetadataSchema: z.ZodObject<{
     metadataBase: z.ZodOptional<z.ZodString>;
@@ -111,6 +120,7 @@ export declare const RootLayoutMetadataSchema: z.ZodObject<{
     alternates: z.ZodOptional<z.ZodObject<{
         canonical: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    robots: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
 }, z.core.$strip>;
 /**
  * `NAV_ITEMS` 的一条，与 `@vcp/sitemap` 的 `NavItem` 对齐（分组条目是同一批字段的
@@ -172,7 +182,7 @@ export declare const PAGE_SEO_MACHINE_FIELD_PATHS: readonly ["path", "meta_tags_
 /** 根布局 `metadata` 里该翻的字段路径。 */
 export declare const ROOT_LAYOUT_METADATA_LOCALIZABLE_FIELD_PATHS: readonly ["title", "title.default", "title.template", "title.absolute", "description", "keywords", "openGraph.title", "openGraph.description", "openGraph.siteName", "openGraph.images.*.alt", "twitter.title", "twitter.description"];
 /** 根布局 `metadata` 里必须逐字节留下的字段路径。 */
-export declare const ROOT_LAYOUT_METADATA_MACHINE_FIELD_PATHS: readonly ["metadataBase", "openGraph.type", "openGraph.url", "openGraph.locale", "openGraph.images.*", "openGraph.images.*.url", "twitter.card", "twitter.images.*", "alternates.canonical"];
+export declare const ROOT_LAYOUT_METADATA_MACHINE_FIELD_PATHS: readonly ["metadataBase", "openGraph.type", "openGraph.url", "openGraph.locale", "openGraph.images.*", "openGraph.images.*.url", "twitter.card", "twitter.images.*", "alternates.canonical", "robots.**"];
 /**
  * `NAV_ITEMS` 里该翻的字段路径。写成**叶子字段名**：查表前下标与 `children` 层会被
  * 归一掉，`NAV_ITEMS[2].children[0].label` 与 `NAV_ITEMS[0].label` 查的是同一条。

package/dist/site-workflow.d.ts

@@ -933,7 +933,6 @@ export declare const CompleteSiteWorkflowRequestSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type CompleteSiteWorkflowRequest = z.infer<typeof CompleteSiteWorkflowRequestSchema>;
 export declare const CompleteQualityOnlyWorkflowRequestSchema: z.ZodObject<{
-    expected_current_node: z.ZodLiteral<"preview_personalization">;
     publish_workflow_id: z.ZodUUID;
     expected_publish_revision: z.ZodNumber;
 }, z.core.$strict>;

package/dist/subsite-visible-text-export.d.ts

@@ -29,6 +29,25 @@ export declare const SubsiteVisibleTextExportResponseSchema: z.ZodObject<{
         text: z.ZodString;
         media_key: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
+    images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        source: z.ZodEnum<{
+            "media-registry": "media-registry";
+            "source-literal": "source-literal";
+        }>;
+        src: z.ZodString;
+        alt: z.ZodNullable<z.ZodString>;
+        media_key: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        provider: z.ZodOptional<z.ZodString>;
+        is_placeholder: z.ZodBoolean;
+        occurrences: z.ZodArray<z.ZodObject<{
+            file_path: z.ZodString;
+            line: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
+export type SubsiteVisibleTextImage = NonNullable<z.infer<typeof SubsiteVisibleTextExportResponseSchema>["images"]>[number];
 export type SubsiteVisibleTextEntry = NonNullable<z.infer<typeof SubsiteVisibleTextExportResponseSchema>["entries"]>[number];
 export type SubsiteVisibleTextExportResponse = z.infer<typeof SubsiteVisibleTextExportResponseSchema>;

package/dist/type-weight.d.ts

@@ -12,6 +12,9 @@ export type WeightRole = "display" | "heading" | "title" | "ui" | "button" | "bo
 export declare const WEIGHT_STYLE_PRESETS: Readonly<Record<WeightStyleId, Readonly<Record<WeightRole, number>>>>;
 export declare const SITE_WEIGHT_TOKEN_NAMES: string[];
 export declare const SITE_LEADING_BODY_TOKEN = "--site-leading-body";
+/** 标题行高令牌，与 display / heading / title 三个字重角色一一对应（模板基础层挂在 h1 / h2 / h3 与对应的 `type-*` 角色类上）。 */
+export declare const SITE_LEADING_HEADING_TOKEN_NAMES: readonly ["--site-leading-display", "--site-leading-heading", "--site-leading-title"];
+export type SiteLeadingHeadingToken = (typeof SITE_LEADING_HEADING_TOKEN_NAMES)[number];
 /**
  * `resolveFontDisplayName` silently falls back to `"Inter"` for a name it
  * doesn't recognize, so calling it first would make an unknown font
@@ -26,4 +29,5 @@ export declare function siteWeightVariables(style: WeightStyleId | undefined, fo
     body?: string;
 }): Record<`--site-weight-${WeightRole}`, string>;
 export declare function siteLeadingBody(locale: string | undefined): string;
+export declare function siteLeadingHeadingVariables(locale: string | undefined): Record<SiteLeadingHeadingToken, string>;
 export declare function resolveTryOnFontWeights(family: string, wanted: readonly number[]): string[];

package/dist/workspace-file-mutation-tools.d.ts

@@ -19,9 +19,18 @@ export declare const MODEL_FILE_MUTATION_TOOL_NAMES: readonly ["write_file", "ed
  * 会错判。
  */
 export declare const LEGACY_FILE_MUTATION_TOOL_NAME: "apply_patch_batch";
-/** 写类工具全集：模型可见的三个 + 历史批量工具。 */
-export declare const WORKSPACE_FILE_MUTATION_TOOL_NAMES: readonly ["write_file", "edit_file", "delete_file", "apply_patch_batch"];
+/**
+ * 平台确定性改写站点代码的类型化工具：模型只给意图（例如面包屑放法），平台在工具
+ * 内部读工作副本、算出改动、经 `applyPatchBatch` 一次写入。它们会改站点代码，所以
+ * 算写类（预览蒙层、工具卡分类都要认）；但入参与结果不是 canonical 补丁形状，
+ * agent 运行时的补丁归一、逐文件重试预算只认 {@link isCanonicalFileMutationToolName}。
+ */
+export declare const PLATFORM_FILE_MUTATION_TOOL_NAMES: readonly ["set_breadcrumb_placement"];
+/** 写类工具全集：模型可见的三个 + 历史批量工具 + 平台确定性写入工具。 */
+export declare const WORKSPACE_FILE_MUTATION_TOOL_NAMES: readonly ["write_file", "edit_file", "delete_file", "apply_patch_batch", "set_breadcrumb_placement"];
 export type ModelFileMutationToolName = (typeof MODEL_FILE_MUTATION_TOOL_NAMES)[number];
+export type PlatformFileMutationToolName = (typeof PLATFORM_FILE_MUTATION_TOOL_NAMES)[number];
+export type CanonicalFileMutationToolName = ModelFileMutationToolName | typeof LEGACY_FILE_MUTATION_TOOL_NAME;
 export type WorkspaceFileMutationToolName = (typeof WORKSPACE_FILE_MUTATION_TOOL_NAMES)[number];
 /** 是不是模型可见的文件修改工具（不含历史批量工具）。 */
 export declare function isModelFileMutationToolName(toolName: string): toolName is ModelFileMutationToolName;
@@ -30,3 +39,9 @@ export declare function isModelFileMutationToolName(toolName: string): toolName
  * ——预览蒙层、工具卡分类、状态胶囊、业务任务标题共用同一判据。
  */
 export declare function isWorkspaceFileMutationToolName(toolName: string): toolName is WorkspaceFileMutationToolName;
+/**
+ * 是不是走 canonical 补丁协议的写类工具（模型可见的三个 + 历史批量工具）：入参能
+ * 归一成 `ApplyPatchBatchToolInput`、结果就是 `ApplyPatchBatchResult`。平台确定性
+ * 写入工具不在此列，它们的结果由调用方按各自合同处理。
+ */
+export declare function isCanonicalFileMutationToolName(toolName: string): toolName is CanonicalFileMutationToolName;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vcp-dev/contracts",
-  "version": "0.10.20",
+  "version": "0.10.22",
   "type": "module",
   "license": "UNLICENSED",
   "repository": {