@vcp-dev/contracts 0.10.21 → 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-version.d.ts

@@ -5,7 +5,7 @@
  *
  * 由 release-edit-engine-packages.ts 在 bump 版本时自动更新。
  */
-export declare const CURRENT_EDIT_ENGINE_VERSION = "0.10.21";
+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-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/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.21",
+  "version": "0.10.22",
   "type": "module",
   "license": "UNLICENSED",
   "repository": {