@vcp-dev/contracts 0.10.3 → 0.10.5

package/dist/cms-page-directory.d.ts

@@ -81,6 +81,7 @@ export declare const DesignerPageDisabledReasonSchema: z.ZodEnum<{
     missing_url: "missing_url";
     not_vcp_managed: "not_vcp_managed";
     unsupported_page_type: "unsupported_page_type";
+    page_not_generated: "page_not_generated";
 }>;
 export type DesignerPageDisabledReason = z.infer<typeof DesignerPageDisabledReasonSchema>;
 export declare const DesignerPageDeleteBlockReasonSchema: z.ZodEnum<{

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

@@ -7,6 +7,12 @@ import { z } from "zod";
  * 自己的运行与会话标识，VCP 只原样存储与回显，不解析其含义。
  */
 export declare const ExternalSiteEditTaskIdSchema: z.ZodUUID;
+export declare const SiteEditExecutionSceneSchema: z.ZodEnum<{
+    external_site_edit: "external_site_edit";
+    page_template_create: "page_template_create";
+}>;
+export type SiteEditExecutionScene = z.infer<typeof SiteEditExecutionSceneSchema>;
+export declare const ExternalSiteEditExternalIdSchema: z.ZodString;
 /** 提示词上限。改站提示词是一次任务描述，不是资料投递通道。 */
 export declare const EXTERNAL_SITE_EDIT_PROMPT_MAX_LENGTH = 4000;
 /**
@@ -75,9 +81,13 @@ export type CreateExternalSiteEditRequest = z.infer<typeof CreateExternalSiteEdi
  */
 export declare const ExternalSiteEditTaskSchema: z.ZodObject<{
     id: z.ZodUUID;
+    execution_scene: z.ZodDefault<z.ZodEnum<{
+        external_site_edit: "external_site_edit";
+        page_template_create: "page_template_create";
+    }>>;
     site_id: z.ZodUUID;
-    external_run_id: z.ZodString;
-    external_thread_id: z.ZodString;
+    external_run_id: z.ZodNullable<z.ZodString>;
+    external_thread_id: z.ZodNullable<z.ZodString>;
     status: z.ZodEnum<{
         succeeded: "succeeded";
         failed: "failed";
@@ -112,11 +122,11 @@ export declare const ExternalSiteEditTaskSchema: z.ZodObject<{
     summary: z.ZodNullable<z.ZodString>;
     error_code: z.ZodNullable<z.ZodString>;
     build_verified: z.ZodNullable<z.ZodBoolean>;
-    callback_status: z.ZodEnum<{
+    callback_status: z.ZodNullable<z.ZodEnum<{
         failed: "failed";
         pending: "pending";
         delivered: "delivered";
-    }>;
+    }>>;
     created_at: z.ZodString;
     started_at: z.ZodNullable<z.ZodString>;
     finished_at: z.ZodNullable<z.ZodString>;
@@ -125,9 +135,13 @@ export type ExternalSiteEditTask = z.infer<typeof ExternalSiteEditTaskSchema>;
 export declare const CreateExternalSiteEditResponseSchema: z.ZodObject<{
     task: z.ZodObject<{
         id: z.ZodUUID;
+        execution_scene: z.ZodDefault<z.ZodEnum<{
+            external_site_edit: "external_site_edit";
+            page_template_create: "page_template_create";
+        }>>;
         site_id: z.ZodUUID;
-        external_run_id: z.ZodString;
-        external_thread_id: z.ZodString;
+        external_run_id: z.ZodNullable<z.ZodString>;
+        external_thread_id: z.ZodNullable<z.ZodString>;
         status: z.ZodEnum<{
             succeeded: "succeeded";
             failed: "failed";
@@ -162,11 +176,11 @@ export declare const CreateExternalSiteEditResponseSchema: z.ZodObject<{
         summary: z.ZodNullable<z.ZodString>;
         error_code: z.ZodNullable<z.ZodString>;
         build_verified: z.ZodNullable<z.ZodBoolean>;
-        callback_status: z.ZodEnum<{
+        callback_status: z.ZodNullable<z.ZodEnum<{
             failed: "failed";
             pending: "pending";
             delivered: "delivered";
-        }>;
+        }>>;
         created_at: z.ZodString;
         started_at: z.ZodNullable<z.ZodString>;
         finished_at: z.ZodNullable<z.ZodString>;
@@ -176,9 +190,13 @@ export type CreateExternalSiteEditResponse = z.infer<typeof CreateExternalSiteEd
 export declare const GetExternalSiteEditResponseSchema: z.ZodObject<{
     task: z.ZodObject<{
         id: z.ZodUUID;
+        execution_scene: z.ZodDefault<z.ZodEnum<{
+            external_site_edit: "external_site_edit";
+            page_template_create: "page_template_create";
+        }>>;
         site_id: z.ZodUUID;
-        external_run_id: z.ZodString;
-        external_thread_id: z.ZodString;
+        external_run_id: z.ZodNullable<z.ZodString>;
+        external_thread_id: z.ZodNullable<z.ZodString>;
         status: z.ZodEnum<{
             succeeded: "succeeded";
             failed: "failed";
@@ -213,11 +231,11 @@ export declare const GetExternalSiteEditResponseSchema: z.ZodObject<{
         summary: z.ZodNullable<z.ZodString>;
         error_code: z.ZodNullable<z.ZodString>;
         build_verified: z.ZodNullable<z.ZodBoolean>;
-        callback_status: z.ZodEnum<{
+        callback_status: z.ZodNullable<z.ZodEnum<{
             failed: "failed";
             pending: "pending";
             delivered: "delivered";
-        }>;
+        }>>;
         created_at: z.ZodString;
         started_at: z.ZodNullable<z.ZodString>;
         finished_at: z.ZodNullable<z.ZodString>;

package/dist/fill-in-targets.d.ts

@@ -0,0 +1,22 @@
+import type { WorkspaceGenerationLedger } from "./generation-ledger.js";
+import type { FillInTarget } from "./run-control.js";
+export type FillInTargetCheck = {
+    ok: true;
+} | {
+    ok: false;
+    target_id: string;
+};
+/**
+ * 账本侧的补齐目标校验：只看遗漏清单，不看文件。文件层面的冲突
+ * （用户后来自己建了同路由页面、删了承载页面）由 agent 侧的
+ * `resolveFillInTargets` 判 FILL_IN_TARGET_MODIFIED。
+ *
+ * 页面目标的 `target_id` 是该页 `page_id`，组件目标是 `block_id`，
+ * 共享目标是 `header` / `footer` / `style`。已经补齐过的条目留在账本里
+ * （`filled: true`，历史不删），因此必须连同 `filled` 一起判：只要目标
+ * 不在清单里、或者已经补过，就不是一个可补齐的目标。
+ */
+export declare function assertFillInTargetsOmitted(input: {
+    ledger: WorkspaceGenerationLedger;
+    targets: readonly FillInTarget[];
+}): FillInTargetCheck;

package/dist/generation-ledger.d.ts

@@ -0,0 +1,254 @@
+import { z } from "zod";
+/**
+ * 首次生成的页面结果账本（方案 5.0、6.3、8 章）。
+ * 计划中保留用户确认的全部页面身份；实际交付允许省略，但每个省略项都带对象、原因与修复次数。
+ *
+ * message 只写固定枚举文案：本对象会整体进 AgentEvent payload，
+ * AppendAgentEventRequestSchema 对整份 payload 跑 containsSensitiveData，
+ * 把 tsc 诊断或模型自由文本塞进来会让整条事件被拒收。
+ */
+export declare const WorkspaceOmissionKindSchema: z.ZodEnum<{
+    page: "page";
+    component: "component";
+    shared: "shared";
+}>;
+export type WorkspaceOmissionKind = z.infer<typeof WorkspaceOmissionKindSchema>;
+export declare const WorkspaceOmissionReasonSchema: 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";
+}>;
+export type WorkspaceOmissionReason = z.infer<typeof WorkspaceOmissionReasonSchema>;
+export declare const WorkspaceOmissionSchema: 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>;
+export type WorkspaceOmission = z.infer<typeof WorkspaceOmissionSchema>;
+export declare const WorkspacePageResultSchema: z.ZodEnum<{
+    partial: "partial";
+    complete: "complete";
+    pending: "pending";
+    check_incomplete: "check_incomplete";
+    omitted: "omitted";
+}>;
+export type WorkspacePageResult = z.infer<typeof WorkspacePageResultSchema>;
+export declare const WorkspacePageOutcomeSchema: 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>;
+export type WorkspacePageOutcome = z.infer<typeof WorkspacePageOutcomeSchema>;
+export declare const WorkspaceGenerationLedgerSchema: 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>;
+export type WorkspaceGenerationLedger = z.infer<typeof WorkspaceGenerationLedgerSchema>;
+export declare const WorkspaceGenerationLedgerEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"workspace.generation_ledger">;
+    ledger: 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>;
+    at: z.ZodString;
+}, z.core.$strict>;
+export declare function countLedgerAccessiblePages(ledger: WorkspaceGenerationLedger): number;
+/**
+ * 已处理 = 可访问 + 带页面级省略的页面（方案 5.0 / U36 的恒等式：已处理 = 可访问 + 遗漏清单里的整页条目数）。
+ * `omitted` / `check_incomplete` / `user_stopped` 三类页面各带且只带一条 `kind: "page"` 的省略，避免重复计数；
+ * 停止后仍为 `pending` 但带 `user_stopped` 整页省略的页面也算已处理。
+ */
+export declare function countLedgerProcessedPages(ledger: WorkspaceGenerationLedger): number;