@vcp-dev/contracts 0.10.4 → 0.10.6

package/dist/launcher-prompt-templates.d.ts

@@ -340,6 +340,7 @@ export declare const LauncherPromptTemplateApplyRequestSchema: z.ZodObject<{
         pages: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             title: z.ZodString;
+            parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             slug: z.ZodNullable<z.ZodString>;
             navigation: z.ZodObject<{
                 order: z.ZodNumber;
@@ -561,6 +562,7 @@ export declare const LauncherPromptTemplateApplyResponseSchema: z.ZodObject<{
         pages: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             title: z.ZodString;
+            parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             slug: z.ZodNullable<z.ZodString>;
             navigation: z.ZodObject<{
                 order: z.ZodNumber;

package/dist/media-library.d.ts

@@ -125,8 +125,13 @@ export declare const AiImageGenerationPrecheckResponseSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AiImageGenerationPrecheckResponse = z.infer<typeof AiImageGenerationPrecheckResponseSchema>;
 export declare const GenerateAiImagesRequestSchema: z.ZodObject<{
+    pageName: z.ZodString;
+    pageType: z.ZodString;
+    sectionTitle: z.ZodString;
+    nearbyTitle: z.ZodString;
+    nearbyBody: z.ZodString;
     prompt: z.ZodString;
-    quantity: z.ZodNumber;
+    aspectRatio: z.ZodString;
 }, z.core.$strip>;
 export type GenerateAiImagesRequest = z.infer<typeof GenerateAiImagesRequestSchema>;
 export declare const GeneratedAiImageResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{

package/dist/nav-label-width.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 单个导航标签的横向宽度预算。
+ *
+ * 首屏导航是一整行摊开的（chrome 的桌面导航在 lg 断点就全量显示），标签越长
+ * 越容易把品牌位和主按钮一起挤出屏幕。这里只量单个标签：整行是否放得下还取决
+ * 于页数、品牌名和 CTA 文案，由 chrome 侧决定。
+ *
+ * 这个预算量的是访客真正看到的导航标签，和 Step5 给出的 SEO 搜索意图不是同一
+ * 件事——意图要能被搜索到，标签只要能被点。标签不必等于意图。
+ */
+export declare const MAX_NAV_LABEL_WIDTH = 16;
+/** 估算导航标签占的横向宽度：CJK 字符按 2 个单位算，其余按 1 个。 */
+export declare function estimateNavLabelWidth(label: string): number;
+/**
+ * 导航标签的“撞名”归一化键：折叠宽度/大小写并去掉常见复数尾 s，用来判断两个
+ * 标签是不是同一个概念的不同写法（如 "Products" 与 "product"）。只去一个尾
+ * s，且只在结果够长时去——避免把 "As" 这类本来就短的词也剃成 "a"。
+ */
+export declare function navLabelCollisionKey(label: string): string;

package/dist/page-template.d.ts

@@ -7,12 +7,51 @@ export declare const PageTemplatePagePathSchema: z.ZodString;
 export type PageTemplatePagePath = z.infer<typeof PageTemplatePagePathSchema>;
 /** Narrow exception to ordinary public slug rules; ownership is still checked by the patch runtime. */
 export declare function isPageTemplateCandidateEntryPath(path: string): boolean;
-export declare const PageTemplateCreateRequestSchema: z.ZodObject<{
+export declare const PageTemplateCreateItemSchema: z.ZodObject<{
     page_path: z.ZodString;
     template_id: z.ZodString;
     instruction: z.ZodString;
 }, z.core.$strict>;
+export type PageTemplateCreateItem = z.infer<typeof PageTemplateCreateItemSchema>;
+/** Frozen against the Workspace iteration budget; one batch is one run. */
+export declare const PAGE_TEMPLATE_BATCH_MAX_ITEMS = 3;
+/** Same trailing-slash normalization as Next route resolution; IDs stay raw. */
+export declare function normalizePageTemplatePagePath(path: string): string;
+export declare const PageTemplateCreateRequestSchema: z.ZodPipe<z.ZodObject<{
+    external_run_id: z.ZodString;
+    external_thread_id: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        page_path: z.ZodString;
+        template_id: z.ZodString;
+        instruction: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodTransform<{
+    external_run_id: string;
+    external_thread_id: string;
+    items: {
+        page_path: string;
+        template_id: string;
+        instruction: string;
+    }[];
+}, {
+    external_run_id: string;
+    external_thread_id: string;
+    items: {
+        page_path: string;
+        template_id: string;
+        instruction: string;
+    }[];
+}>>;
 export type PageTemplateCreateRequest = z.infer<typeof PageTemplateCreateRequestSchema>;
+/** Persisted server-owned input, never reconstructed from a model prompt. */
+export declare const PageTemplateBatchManifestSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        page_path: z.ZodString;
+        template_id: z.ZodString;
+        instruction: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type PageTemplateBatchManifest = z.infer<typeof PageTemplateBatchManifestSchema>;
 export declare const PageTemplatePromoteRequestSchema: z.ZodObject<{
     page_path: z.ZodString;
     template_id: z.ZodString;
@@ -24,14 +63,68 @@ export declare const PageTemplateCleanupRequestSchema: z.ZodObject<{
     template_ids: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>;
 }, z.core.$strict>;
 export type PageTemplateCleanupRequest = z.infer<typeof PageTemplateCleanupRequestSchema>;
-export declare const PageTemplateCreateResponseSchema: z.ZodObject<{
-    template_id: z.ZodString;
-    status: z.ZodLiteral<"created">;
-    ok: z.ZodLiteral<true>;
+/** Same task envelope, with the strict Page Template scene reflected in OpenAPI too. */
+export declare const PageTemplateTaskSchema: z.ZodObject<{
+    id: z.ZodUUID;
     site_id: z.ZodUUID;
-    page_path: z.ZodString;
-    route_id: z.ZodString;
-    snapshot_id: z.ZodUUID;
+    vcp_run_id: z.ZodNullable<z.ZodUUID>;
+    vcp_thread_id: z.ZodNullable<z.ZodUUID>;
+    base_snapshot_id: z.ZodUUID;
+    snapshot_id: z.ZodNullable<z.ZodUUID>;
+    preview_url: z.ZodNullable<z.ZodString>;
+    summary: z.ZodNullable<z.ZodString>;
+    error_code: z.ZodNullable<z.ZodString>;
+    build_verified: z.ZodNullable<z.ZodBoolean>;
+    created_at: z.ZodString;
+    started_at: z.ZodNullable<z.ZodString>;
+    finished_at: z.ZodNullable<z.ZodString>;
+    execution_scene: z.ZodLiteral<"page_template_create">;
+    external_run_id: z.ZodString;
+    external_thread_id: z.ZodString;
+    callback_status: z.ZodNull;
+    status: z.ZodEnum<{
+        succeeded: "succeeded";
+        failed: "failed";
+        running: "running";
+    }>;
+    outcome: z.ZodNullable<z.ZodEnum<{
+        succeeded: "succeeded";
+        failed: "failed";
+    }>>;
+    degraded_reason: z.ZodNull;
+}, z.core.$strict>;
+export type PageTemplateTask = z.infer<typeof PageTemplateTaskSchema>;
+/** Create returns the shared asynchronous task envelope (HTTP 202). */
+export declare const PageTemplateCreateResponseSchema: z.ZodObject<{
+    task: z.ZodObject<{
+        id: z.ZodUUID;
+        site_id: z.ZodUUID;
+        vcp_run_id: z.ZodNullable<z.ZodUUID>;
+        vcp_thread_id: z.ZodNullable<z.ZodUUID>;
+        base_snapshot_id: z.ZodUUID;
+        snapshot_id: z.ZodNullable<z.ZodUUID>;
+        preview_url: z.ZodNullable<z.ZodString>;
+        summary: z.ZodNullable<z.ZodString>;
+        error_code: z.ZodNullable<z.ZodString>;
+        build_verified: z.ZodNullable<z.ZodBoolean>;
+        created_at: z.ZodString;
+        started_at: z.ZodNullable<z.ZodString>;
+        finished_at: z.ZodNullable<z.ZodString>;
+        execution_scene: z.ZodLiteral<"page_template_create">;
+        external_run_id: z.ZodString;
+        external_thread_id: z.ZodString;
+        callback_status: z.ZodNull;
+        status: z.ZodEnum<{
+            succeeded: "succeeded";
+            failed: "failed";
+            running: "running";
+        }>;
+        outcome: z.ZodNullable<z.ZodEnum<{
+            succeeded: "succeeded";
+            failed: "failed";
+        }>>;
+        degraded_reason: z.ZodNull;
+    }, z.core.$strict>;
 }, z.core.$strict>;
 export type PageTemplateCreateResponse = z.infer<typeof PageTemplateCreateResponseSchema>;
 export declare const PageTemplatePromoteResponseSchema: z.ZodObject<{

package/dist/run-control.d.ts

@@ -0,0 +1,285 @@
+import { z } from "zod";
+/** agent → api 的 fencing 头：落后的 lease owner 写入一律被拒。 */
+export declare const INTERNAL_RUN_LEASE_OWNER_HEADER: "x-vcp-run-lease-owner";
+export declare const WORKSPACE_RUN_LEASE_MS: number;
+export declare const WORKSPACE_RUN_HEARTBEAT_INTERVAL_MS: number;
+export declare const WORKSPACE_MAX_RESUME_COUNT = 3;
+export declare const WORKSPACE_MAX_PAGE_ATTEMPTS = 2;
+export declare const WORKSPACE_RUN_RESUME_EXHAUSTED_ERROR_CODE: "WORKSPACE_RUN_RESUME_EXHAUSTED";
+export declare const WORKSPACE_CHECK_INCOMPLETE_ERROR_CODE: "WORKSPACE_CHECK_INCOMPLETE";
+export declare const WORKSPACE_GENERATION_STOPPED_ERROR_CODE: "WORKSPACE_GENERATION_STOPPED";
+export declare const WORKSPACE_FILL_IN_INTERRUPTED_ERROR_CODE: "WORKSPACE_FILL_IN_INTERRUPTED";
+export declare const WORKSPACE_RUN_LEASE_SUPERSEDED_ERROR_CODE: "WORKSPACE_RUN_LEASE_SUPERSEDED";
+/**
+ * 已终态的一轮不再收页面检查点：登记接口返回 409。只在内网写入路径出现，
+ * 不会作为 `run.failed` 的 error_code 给用户看，因此没有 ERROR_COPY 文案。
+ */
+export declare const WORKSPACE_RUN_NOT_ACTIVE_ERROR_CODE: "WORKSPACE_RUN_NOT_ACTIVE";
+/**
+ * 站点还没生成完（`status !== "workspace_ready"`）时拒绝启动补齐。
+ * 不复用 `SITE_PLANNING_LOCKED`：那个码的含义是"站点已生成、Step 2/3 被锁"，
+ * 正好相反，前端按它提示会把用户指向错误的补救动作。
+ */
+export declare const FILL_IN_NOT_AVAILABLE_ERROR_CODE: "FILL_IN_NOT_AVAILABLE";
+export declare const FILL_IN_TARGET_NOT_OMITTED_ERROR_CODE: "FILL_IN_TARGET_NOT_OMITTED";
+export declare const FILL_IN_TARGET_MODIFIED_ERROR_CODE: "FILL_IN_TARGET_MODIFIED";
+/**
+ * 接续主体：创建 run 时把内网上下文工厂需要的输入持久化到运行行上，
+ * 接续器据此重建请求上下文（`tenant_id` 取运行行本身，不重复存）。
+ * 字段与 apps/api 的 `DevRequestContext` 同形，去掉 tenant_id。
+ */
+export declare const WorkspaceRunResumePrincipalSchema: z.ZodObject<{
+    authMode: z.ZodEnum<{
+        "disabled-dev": "disabled-dev";
+        "internal-service": "internal-service";
+        oidc: "oidc";
+    }>;
+    user_id: z.ZodString;
+    external_user_id: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    display_name: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type WorkspaceRunResumePrincipal = z.infer<typeof WorkspaceRunResumePrincipalSchema>;
+export declare const WorkspaceRunHeartbeatRequestSchema: z.ZodObject<{
+    run_id: z.ZodUUID;
+    lease_owner: z.ZodString;
+    lease_ms: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type WorkspaceRunHeartbeatRequest = z.infer<typeof WorkspaceRunHeartbeatRequestSchema>;
+export declare const WorkspaceRunHeartbeatResponseSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        renewed: "renewed";
+        not_active: "not_active";
+        superseded: "superseded";
+    }>;
+    expires_at: z.ZodNullable<z.ZodString>;
+    stop_requested: z.ZodBoolean;
+}, z.core.$strict>;
+export type WorkspaceRunHeartbeatResponse = z.infer<typeof WorkspaceRunHeartbeatResponseSchema>;
+/**
+ * 检查点对象是一份正规快照物化产物：`snapshot_id` 是独立的 uuid v7，
+ * 不复用站点快照 id，也不写进 snapshots 表；路径安全由
+ * `@vcp/snapshots` 的 `assertSafeSnapshotPath` 在写盘时保证。
+ */
+export declare const WorkspacePageCheckpointSchema: z.ZodObject<{
+    run_id: z.ZodUUID;
+    page_id: z.ZodString;
+    attempt: z.ZodNumber;
+    snapshot_id: z.ZodUUID;
+    object_key: z.ZodString;
+    manifest_hash: z.ZodString;
+    file_paths: z.ZodArray<z.ZodString>;
+    created_at: z.ZodString;
+}, z.core.$strict>;
+export type WorkspacePageCheckpoint = z.infer<typeof WorkspacePageCheckpointSchema>;
+export declare const RegisterWorkspacePageCheckpointRequestSchema: z.ZodObject<{
+    run_id: z.ZodUUID;
+    snapshot_id: z.ZodUUID;
+    page_id: z.ZodString;
+    attempt: z.ZodNumber;
+    object_key: z.ZodString;
+    manifest_hash: z.ZodString;
+    file_paths: z.ZodArray<z.ZodString>;
+    lease_owner: z.ZodString;
+}, z.core.$strict>;
+export type RegisterWorkspacePageCheckpointRequest = z.infer<typeof RegisterWorkspacePageCheckpointRequestSchema>;
+export declare const ListWorkspacePageCheckpointsResponseSchema: z.ZodObject<{
+    checkpoints: z.ZodArray<z.ZodObject<{
+        run_id: z.ZodUUID;
+        page_id: z.ZodString;
+        attempt: z.ZodNumber;
+        snapshot_id: z.ZodUUID;
+        object_key: z.ZodString;
+        manifest_hash: z.ZodString;
+        file_paths: z.ZodArray<z.ZodString>;
+        created_at: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ListWorkspacePageCheckpointsResponse = z.infer<typeof ListWorkspacePageCheckpointsResponseSchema>;
+export declare const FillInTargetSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        page: "page";
+        component: "component";
+        shared: "shared";
+    }>;
+    target_id: z.ZodString;
+}, z.core.$strict>;
+export type FillInTarget = z.infer<typeof FillInTargetSchema>;
+export declare const WorkspaceRunControlInputResponseSchema: z.ZodObject<{
+    run_id: z.ZodUUID;
+    site_id: z.ZodUUID;
+    tenant_id: z.ZodString;
+    run_kind: z.ZodEnum<{
+        landing_page: "landing_page";
+        initial_generation: "initial_generation";
+        iteration: "iteration";
+        fill_in: "fill_in";
+    }>;
+    status: z.ZodEnum<{
+        succeeded: "succeeded";
+        failed: "failed";
+        running: "running";
+        queued: "queued";
+        cancelled: "cancelled";
+    }>;
+    base_snapshot_id: z.ZodNullable<z.ZodUUID>;
+    lease_owner: z.ZodNullable<z.ZodString>;
+    resume_count: z.ZodNumber;
+    stop_requested: z.ZodBoolean;
+    reuse_from_run_id: z.ZodNullable<z.ZodUUID>;
+    source_run_id: z.ZodNullable<z.ZodUUID>;
+    fill_in_targets: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            page: "page";
+            component: "component";
+            shared: "shared";
+        }>;
+        target_id: z.ZodString;
+    }, z.core.$strict>>;
+    execution_scene: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        external_site_edit: "external_site_edit";
+        page_template_create: "page_template_create";
+    }>>>;
+    page_template_manifest: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            page_path: z.ZodString;
+            template_id: z.ZodString;
+            instruction: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type WorkspaceRunControlInputResponse = z.infer<typeof WorkspaceRunControlInputResponseSchema>;
+export declare const ClaimStaleWorkspaceRunsResponseSchema: z.ZodObject<{
+    runs: z.ZodArray<z.ZodObject<{
+        run_id: z.ZodUUID;
+        site_id: z.ZodUUID;
+        tenant_id: z.ZodString;
+        run_kind: z.ZodLiteral<"initial_generation">;
+        base_snapshot_id: z.ZodUUID;
+        sitemap_id: z.ZodUUID;
+        resume_count: z.ZodNumber;
+        lease_owner: z.ZodString;
+        stop_requested: z.ZodBoolean;
+        resume_principal: z.ZodObject<{
+            authMode: z.ZodEnum<{
+                "disabled-dev": "disabled-dev";
+                "internal-service": "internal-service";
+                oidc: "oidc";
+            }>;
+            user_id: z.ZodString;
+            external_user_id: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+            display_name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ClaimStaleWorkspaceRunsResponse = z.infer<typeof ClaimStaleWorkspaceRunsResponseSchema>;
+export declare const StopWorkspaceGenerationRequestSchema: z.ZodObject<{
+    site_id: z.ZodUUID;
+}, z.core.$strict>;
+/**
+ * `requested` / `already_requested`：这一轮还活着（租约未过期），停止请求已写下，
+ * 由它自己保存好已完成的页面后收尾。
+ * `stopped`：这一轮已经没有活着的处理进程了（租约过期或从未续期）——没人会理会
+ * 停止标记，再软停就等于让站点锁一直挂着，因此当场补终态并释放站点锁。
+ * `no_active_run`：站点上没有首轮生成 / 补齐在途。
+ */
+export declare const StopWorkspaceGenerationResponseSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        requested: "requested";
+        already_requested: "already_requested";
+        stopped: "stopped";
+        no_active_run: "no_active_run";
+    }>;
+    run_id: z.ZodNullable<z.ZodUUID>;
+}, z.core.$strict>;
+export type StopWorkspaceGenerationRequest = z.infer<typeof StopWorkspaceGenerationRequestSchema>;
+export type StopWorkspaceGenerationResponse = z.infer<typeof StopWorkspaceGenerationResponseSchema>;
+export declare const SiteGenerationLedgerResponseSchema: z.ZodObject<{
+    ledger: z.ZodNullable<z.ZodObject<{
+        schema_version: z.ZodLiteral<1>;
+        sitemap_id: z.ZodString;
+        confirmed_page_ids: z.ZodArray<z.ZodString>;
+        pages: z.ZodArray<z.ZodObject<{
+            page_id: z.ZodString;
+            slug: z.ZodString;
+            title: z.ZodString;
+            parent_page_id: z.ZodNullable<z.ZodString>;
+            result: z.ZodEnum<{
+                partial: "partial";
+                complete: "complete";
+                pending: "pending";
+                check_incomplete: "check_incomplete";
+                omitted: "omitted";
+            }>;
+            attempts: z.ZodNumber;
+            omissions: z.ZodArray<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    page: "page";
+                    component: "component";
+                    shared: "shared";
+                }>;
+                target_id: z.ZodString;
+                page_id: z.ZodNullable<z.ZodString>;
+                reason: z.ZodEnum<{
+                    conflict: "conflict";
+                    generation_failed: "generation_failed";
+                    repair_exhausted: "repair_exhausted";
+                    page_unusable: "page_unusable";
+                    check_incomplete: "check_incomplete";
+                    design_missing: "design_missing";
+                    chrome_fallback: "chrome_fallback";
+                    style_fallback: "style_fallback";
+                    resume_exhausted: "resume_exhausted";
+                    user_stopped: "user_stopped";
+                }>;
+                repair_attempts: z.ZodNumber;
+                message: z.ZodString;
+                filled: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        shared: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                page: "page";
+                component: "component";
+                shared: "shared";
+            }>;
+            target_id: z.ZodString;
+            page_id: z.ZodNullable<z.ZodString>;
+            reason: z.ZodEnum<{
+                conflict: "conflict";
+                generation_failed: "generation_failed";
+                repair_exhausted: "repair_exhausted";
+                page_unusable: "page_unusable";
+                check_incomplete: "check_incomplete";
+                design_missing: "design_missing";
+                chrome_fallback: "chrome_fallback";
+                style_fallback: "style_fallback";
+                resume_exhausted: "resume_exhausted";
+                user_stopped: "user_stopped";
+            }>;
+            repair_attempts: z.ZodNumber;
+            message: z.ZodString;
+            filled: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        stopped_by_user: z.ZodBoolean;
+        resume_count: z.ZodNumber;
+        home_replaced_by: z.ZodNullable<z.ZodString>;
+        updated_at: z.ZodString;
+    }, z.core.$strict>>;
+    source_run_id: z.ZodNullable<z.ZodUUID>;
+    updated_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type SiteGenerationLedgerResponse = z.infer<typeof SiteGenerationLedgerResponseSchema>;
+export declare const StartFillInRequestSchema: z.ZodObject<{
+    targets: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            page: "page";
+            component: "component";
+            shared: "shared";
+        }>;
+        target_id: z.ZodString;
+    }, z.core.$strict>>;
+    client_run_key: z.ZodString;
+}, z.core.$strict>;
+export type StartFillInRequest = z.infer<typeof StartFillInRequestSchema>;

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

@@ -72,8 +72,8 @@ export declare const SiteEditStylePropertySchema: z.ZodEnum<{
     color: "color";
     transform: "transform";
     cursor: "cursor";
-    columns: "columns";
     position: "position";
+    columns: "columns";
     width: "width";
     height: "height";
     order: "order";

package/dist/site-edit-render-document.d.ts

@@ -144,6 +144,7 @@ export declare const SiteEditDynamicDataSummarySchema: z.ZodObject<{
         "external-api": "external-api";
         "unknown-api": "unknown-api";
     }>>;
+    collections: z.ZodOptional<z.ZodArray<z.ZodString>>;
     primaryEndpoint: z.ZodOptional<z.ZodString>;
     primaryCollection: z.ZodOptional<z.ZodString>;
     primaryFieldPath: z.ZodOptional<z.ZodString>;
@@ -169,6 +170,7 @@ export declare const SiteEditRenderEntrySchema: z.ZodObject<{
             "external-api": "external-api";
             "unknown-api": "unknown-api";
         }>>;
+        collections: z.ZodOptional<z.ZodArray<z.ZodString>>;
         primaryEndpoint: z.ZodOptional<z.ZodString>;
         primaryCollection: z.ZodOptional<z.ZodString>;
         primaryFieldPath: z.ZodOptional<z.ZodString>;
@@ -223,6 +225,7 @@ export declare const SiteEditRenderDocumentSchema: z.ZodObject<{
                 "external-api": "external-api";
                 "unknown-api": "unknown-api";
             }>>;
+            collections: z.ZodOptional<z.ZodArray<z.ZodString>>;
             primaryEndpoint: z.ZodOptional<z.ZodString>;
             primaryCollection: z.ZodOptional<z.ZodString>;
             primaryFieldPath: z.ZodOptional<z.ZodString>;
@@ -460,8 +463,8 @@ export declare const SiteEditStyleModelSchema: z.ZodUnion<readonly [z.ZodRecord<
             color: "color";
             transform: "transform";
             cursor: "cursor";
-            columns: "columns";
             position: "position";
+            columns: "columns";
             width: "width";
             height: "height";
             order: "order";
@@ -1107,6 +1110,7 @@ export declare const SiteEditObjectSummarySchema: z.ZodObject<{
             "external-api": "external-api";
             "unknown-api": "unknown-api";
         }>>;
+        collections: z.ZodOptional<z.ZodArray<z.ZodString>>;
         primaryEndpoint: z.ZodOptional<z.ZodString>;
         primaryCollection: z.ZodOptional<z.ZodString>;
         primaryFieldPath: z.ZodOptional<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.4";
+export declare const CURRENT_EDIT_ENGINE_VERSION = "0.10.6";
 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/sitemap-structure.d.ts

@@ -0,0 +1,82 @@
+/**
+ * 两层页面结构的纯函数：展示顺序、统计与结构化校验。
+ *
+ * 与 index.ts 里的 zod 不变量分工：不变量守持久化边界并直接拒绝非法数据；
+ * 这里的函数给界面提示和服务端确认门用，返回带页面 id 的问题清单，
+ * 且额外覆盖 zod 不检查的“同一位置重名”与“首页被改名”。
+ */
+export type SitemapStructurePageLike = {
+    id: string;
+    slug: string | null;
+    title: string;
+    parent_page_id?: string | null;
+    blocks: ReadonlyArray<unknown>;
+};
+/**
+ * 只做页面顺序判定的最小结构：isTopLevelPage / listChildPages /
+ * orderSitemapPagesForDisplay 的实现只读 id/slug/parent_page_id，不需要
+ * title/blocks。SitemapStructurePageLike 仍是两层结构契约的完整形状（
+ * countSitemapStructure / validateSitemapStructure 要用 title/blocks 计数与
+ * 校验），这里单独收窄一个类型，让只做排序判定的调用方（例如导航链接排序）
+ * 不必先把没有 blocks 的页面形状转成完整形状再传进来。
+ */
+export type SitemapOrderingPageLike = {
+    id: string;
+    slug: string | null;
+    parent_page_id?: string | null;
+};
+export type SitemapStructureIssueCode = "missing_home" | "home_renamed" | "empty_title" | "self_parent" | "parent_not_found" | "home_has_parent" | "home_has_children" | "depth_exceeded" | "duplicate_sibling_title" | "reserved_slug";
+export type SitemapStructureIssue = {
+    code: SitemapStructureIssueCode;
+    page_id: string | null;
+    message: string;
+};
+export declare function normalizeStructureTitle(title: string): string;
+/** 首页文案兜底：只覆盖三种 CJK 语种并退英文，与 Sitemap 侧导航兜底口径一致。 */
+export declare function homeLabelForLocale(locale: string | null | undefined): string;
+/**
+ * “更多”文案兜底：与 homeLabelForLocale 同风格（按 BCP-47 前缀判断），给收纳
+ * 溢出顶层导航项的下拉入口用。覆盖比首页兜底更广的一组语种，其余（含
+ * null/undefined）一律退英文。
+ */
+export declare function moreLabelForLocale(locale: string | null | undefined): string;
+/**
+ * 首轮页头全覆盖：把每个页面的 `navigation.showInHeader` 钉成 true，只改这一
+ * 个字段。`null` 与 `false` 同等对待——两者都表示"当前不在页头"。已经是
+ * `true` 的页面原样返回（同一引用），不产生多余改动。
+ */
+export declare function markAllPagesInHeader<T extends {
+    navigation: {
+        showInHeader: boolean | null;
+    };
+}>(pages: readonly T[]): T[];
+export declare function isTopLevelPage<T extends SitemapOrderingPageLike>(page: T, pages: ReadonlyArray<T>): boolean;
+export declare function listChildPages<T extends SitemapOrderingPageLike>(pages: readonly T[], parentId: string): T[];
+export declare function orderSitemapPagesForDisplay<T extends SitemapOrderingPageLike>(pages: readonly T[]): T[];
+/**
+ * 把导航链接按页面的展示结构（首页、一级页、各自子页紧随其后）重新排列。
+ *
+ * 只重排「href 的 pathname 精确匹配某个页面 slug」的链接，顺序取
+ * `orderSitemapPagesForDisplay(pages)` 里该页面的位置——不是链接的原数组顺序，
+ * 也不是页面自己的 `navigation.order`。匹配不到页面的链接（外链、或指向已不
+ * 存在页面的死链）保持彼此原有的相对顺序，整体放在排好序的页面链接之后。
+ *
+ * 用途：resolver 补全新增子页的 slug 之后，一般的导航收敛逻辑只知道「这个
+ * 页面之前不在链接列表里」，只会把它追加到末尾，不知道父子结构；这个函数在
+ * 持久化前对最终 primaryLinks 做一次结构对齐，让子页紧跟父页。footerLinks
+ * 不需要这个处理——页脚本来就是按 order 手工挑选的子集，没有「子页必须紧随
+ * 父页」的展示要求。
+ */
+export declare function orderNavigationLinksByStructure<L extends {
+    href: string;
+}, P extends SitemapOrderingPageLike>(links: readonly L[], pages: readonly P[]): L[];
+export declare function countSitemapStructure(pages: ReadonlyArray<SitemapStructurePageLike>): {
+    top_level_pages: number;
+    sub_pages: number;
+    total_pages: number;
+    content_items: number;
+};
+export declare function validateSitemapStructure(pages: ReadonlyArray<SitemapStructurePageLike>, options?: {
+    expectedHomeTitle?: string;
+    reservedSlugs?: readonly string[];
+}): SitemapStructureIssue[];

package/dist/step5-strategy.d.ts

@@ -12,6 +12,9 @@ export declare const Step5OutputLocaleSchema: z.ZodEnum<{
 export type Step5OutputLocale = z.infer<typeof Step5OutputLocaleSchema>;
 export declare const STEP5_STRATEGY_KEYS: readonly ["market", "persona", "product", "brand", "competition", "structure", "language", "keywords", "risk"];
 export declare const STEP5_STRATEGY_COUNT: 9;
+export declare const STEP5_OPTIONAL_STRATEGY_KEYS: readonly ["keywords"];
+export declare const STEP5_REQUIRED_STRATEGY_KEYS: ("product" | "keywords" | "market" | "language" | "persona" | "brand" | "competition" | "structure" | "risk")[];
+export declare const STEP5_REQUIRED_STRATEGY_COUNT: number;
 export declare const Step5ActiveStrategyKeySchema: z.ZodEnum<{
     product: "product";
     keywords: "keywords";
@@ -24,6 +27,7 @@ export declare const Step5ActiveStrategyKeySchema: z.ZodEnum<{
     risk: "risk";
 }>;
 export type Step5ActiveStrategyKey = z.infer<typeof Step5ActiveStrategyKeySchema>;
+export declare function isStep5RequiredStrategyKey(key: Step5ActiveStrategyKey): boolean;
 export declare const Step5StrategyKeySchema: z.ZodEnum<{
     product: "product";
     keywords: "keywords";