@vcp-dev/contracts 0.10.4 → 0.10.5

package/dist/index.d.ts

@@ -13,6 +13,7 @@ export * from "./deployment-lifecycle.js";
 export * from "./external-site-edit.js";
 export * from "./workspace-attachment.js";
 export * from "./internal-entity-id.js";
+export * from "./run-control.js";
 export * from "./designer-component-library.js";
 export * from "./designer-page-library.js";
 export * from "./component-i18n-resources.js";
@@ -93,6 +94,8 @@ export * from "./site-publish-domain.js";
 export * from "./google-search-console.js";
 export * from "./site-publish-workflow.js";
 export * from "./e2b-preview-proxy.js";
+export * from "./generation-ledger.js";
+export * from "./fill-in-targets.js";
 /**
  * Clarify 视觉调性 text-options 题的每个 option 的结构化硬绑信号。
  * spec §1.1 + 2026-05-27 接通：用户选中的 option 的 visualHints 会被
@@ -869,6 +872,7 @@ export declare const SITE_PLANNING_FROZEN_ERROR_CODE: "SITE_PLANNING_INPUT_FROZE
 export declare const SITE_PLANNING_LOCKED_ERROR_CODE: "SITE_PLANNING_LOCKED";
 export declare const SITE_STRUCTURE_CONFIRMATION_REQUIRED_ERROR_CODE: "SITE_STRUCTURE_CONFIRMATION_REQUIRED";
 export declare const SITE_STRUCTURE_CONFIRMATION_STALE_ERROR_CODE: "SITE_STRUCTURE_CONFIRMATION_STALE";
+export declare const SITE_STRUCTURE_INVALID_ERROR_CODE: "SITE_STRUCTURE_INVALID";
 export declare const CreateSiteInputSchema: z.ZodObject<{
     tenant_id: z.ZodString;
     name: z.ZodString;
@@ -1930,10 +1934,11 @@ export declare const AgentRunTypeSchema: z.ZodEnum<{
 }>;
 export declare const AgentRunKindSchema: z.ZodEnum<{
     landing_page: "landing_page";
-    sitemap: "sitemap";
-    clarify: "clarify";
     initial_generation: "initial_generation";
     iteration: "iteration";
+    fill_in: "fill_in";
+    sitemap: "sitemap";
+    clarify: "clarify";
 }>;
 export type AgentRunStatus = z.infer<typeof AgentRunStatusSchema>;
 export type AgentRunType = z.infer<typeof AgentRunTypeSchema>;
@@ -1955,10 +1960,11 @@ export declare const AgentRunRecordSchema: z.ZodObject<{
     }>;
     run_kind: z.ZodEnum<{
         landing_page: "landing_page";
-        sitemap: "sitemap";
-        clarify: "clarify";
         initial_generation: "initial_generation";
         iteration: "iteration";
+        fill_in: "fill_in";
+        sitemap: "sitemap";
+        clarify: "clarify";
     }>;
     status: z.ZodEnum<{
         succeeded: "succeeded";
@@ -1980,6 +1986,45 @@ export declare const AgentRunRecordSchema: z.ZodObject<{
     thread_id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
 }, z.core.$strip>;
 export type AgentRunRecord = z.infer<typeof AgentRunRecordSchema>;
+export declare const StartFillInResponseSchema: z.ZodObject<{
+    agent_run: z.ZodObject<{
+        id: z.ZodUUID;
+        tenant_id: z.ZodString;
+        site_id: z.ZodUUID;
+        agent_type: z.ZodEnum<{
+            sitemap: "sitemap";
+            clarify: "clarify";
+            workspace: "workspace";
+        }>;
+        run_kind: z.ZodEnum<{
+            landing_page: "landing_page";
+            initial_generation: "initial_generation";
+            iteration: "iteration";
+            fill_in: "fill_in";
+            sitemap: "sitemap";
+            clarify: "clarify";
+        }>;
+        status: z.ZodEnum<{
+            succeeded: "succeeded";
+            failed: "failed";
+            running: "running";
+            queued: "queued";
+            cancelled: "cancelled";
+        }>;
+        model_route: z.ZodEnum<{
+            sitemap: "sitemap";
+            clarify: "clarify";
+            workspace: "workspace";
+            summarize: "summarize";
+        }>;
+        started_at: z.ZodNullable<z.ZodString>;
+        finished_at: z.ZodNullable<z.ZodString>;
+        error_code: z.ZodNullable<z.ZodString>;
+        created_at: z.ZodString;
+        thread_id: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    }, z.core.$strip>;
+}, z.core.$strict>;
+export type StartFillInResponse = z.infer<typeof StartFillInResponseSchema>;
 /**
  * 线程类别：`workspace` = 用户在站点工作台开的会话（NULL 线程是默认会话）；
  * `landing_page` = 一个落地页一条；`external` = 外部编排系统的会话。
@@ -2039,10 +2084,11 @@ export declare const AgentRunContextResponseSchema: z.ZodObject<{
         }>;
         run_kind: z.ZodEnum<{
             landing_page: "landing_page";
-            sitemap: "sitemap";
-            clarify: "clarify";
             initial_generation: "initial_generation";
             iteration: "iteration";
+            fill_in: "fill_in";
+            sitemap: "sitemap";
+            clarify: "clarify";
         }>;
         status: z.ZodEnum<{
             succeeded: "succeeded";
@@ -2101,10 +2147,11 @@ export declare const CreateAgentRunRequestSchema: z.ZodObject<{
     }>;
     run_kind: z.ZodOptional<z.ZodEnum<{
         landing_page: "landing_page";
-        sitemap: "sitemap";
-        clarify: "clarify";
         initial_generation: "initial_generation";
         iteration: "iteration";
+        fill_in: "fill_in";
+        sitemap: "sitemap";
+        clarify: "clarify";
     }>>;
     model_route: z.ZodEnum<{
         sitemap: "sitemap";
@@ -2127,10 +2174,11 @@ export declare const CreateAgentRunResponseSchema: z.ZodObject<{
         }>;
         run_kind: z.ZodEnum<{
             landing_page: "landing_page";
-            sitemap: "sitemap";
-            clarify: "clarify";
             initial_generation: "initial_generation";
             iteration: "iteration";
+            fill_in: "fill_in";
+            sitemap: "sitemap";
+            clarify: "clarify";
         }>;
         status: z.ZodEnum<{
             succeeded: "succeeded";
@@ -4263,10 +4311,11 @@ export declare const CreateAgentRunConflictResponseSchema: z.ZodObject<{
                 }>;
                 run_kind: z.ZodEnum<{
                     landing_page: "landing_page";
-                    sitemap: "sitemap";
-                    clarify: "clarify";
                     initial_generation: "initial_generation";
                     iteration: "iteration";
+                    fill_in: "fill_in";
+                    sitemap: "sitemap";
+                    clarify: "clarify";
                 }>;
                 status: z.ZodEnum<{
                     succeeded: "succeeded";
@@ -5122,6 +5171,7 @@ export declare const PageSchema: z.ZodObject<{
         showInFooter: z.ZodBoolean;
         order: z.ZodNumber;
     }, z.core.$strict>;
+    parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strict>;
 export declare const SitemapDraftBlockSchema: z.ZodObject<{
     id: z.ZodString;
@@ -5145,6 +5195,7 @@ export type SitemapDraftBlock = z.infer<typeof SitemapDraftBlockSchema>;
 export declare const SitemapDraftPageSchema: 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;
@@ -5198,6 +5249,7 @@ export declare const SitemapModelPageSchema: z.ZodObject<{
         }, z.core.$strip>>;
         id: z.ZodString;
     }, z.core.$strict>>;
+    parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strict>;
 export type SitemapModelPage = z.infer<typeof SitemapModelPageSchema>;
 export declare const SitemapSourceProvenanceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -5241,6 +5293,7 @@ export declare const SitemapSchema: z.ZodObject<{
             showInFooter: z.ZodBoolean;
             order: z.ZodNumber;
         }, z.core.$strict>;
+        parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strict>>;
     navigation: z.ZodObject<{
         primaryLinks: z.ZodArray<z.ZodObject<{
@@ -5622,6 +5675,7 @@ export declare const SitemapDraftSchema: 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;
@@ -5860,6 +5914,7 @@ export declare const SitemapResolverRequestSchema: 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;
@@ -5901,6 +5956,7 @@ export declare const SitemapResolverRequestSchema: z.ZodObject<{
             fields: z.ZodTuple<[z.ZodLiteral<"type">], null>;
         }, z.core.$strict>>;
     }, z.core.$strict>;
+    reserved_slugs: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 export type SitemapResolverRequest = z.infer<typeof SitemapResolverRequestSchema>;
 export declare const SitemapResolverModelOutputSchema: z.ZodObject<{
@@ -5948,6 +6004,7 @@ export declare const SitemapResolverResponseSchema: z.ZodObject<{
                 showInFooter: z.ZodBoolean;
                 order: z.ZodNumber;
             }, z.core.$strict>;
+            parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strict>>;
         navigation: z.ZodObject<{
             primaryLinks: z.ZodArray<z.ZodObject<{
@@ -6139,6 +6196,8 @@ export declare const SitemapResolverResponseSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type SitemapResolverResponse = z.infer<typeof SitemapResolverResponseSchema>;
 export { reconcileSitemapNavigation } from "./sitemap-navigation.js";
+export { countSitemapStructure, homeLabelForLocale, isTopLevelPage, listChildPages, markAllPagesInHeader, moreLabelForLocale, normalizeStructureTitle, orderNavigationLinksByStructure, orderSitemapPagesForDisplay, validateSitemapStructure, type SitemapOrderingPageLike, type SitemapStructureIssue, type SitemapStructureIssueCode, type SitemapStructurePageLike, } from "./sitemap-structure.js";
+export { MAX_NAV_LABEL_WIDTH, estimateNavLabelWidth, navLabelCollisionKey, } from "./nav-label-width.js";
 /**
  * 提供给 emit_sitemap 工具输入的 sitemap schema 子集。
  * skillSelection / visualTheme / userChoices / confirmedChoices / seoKeywords
@@ -6184,6 +6243,7 @@ export declare const SitemapModelOutputSchema: z.ZodObject<{
             }, z.core.$strip>>;
             id: z.ZodString;
         }, z.core.$strict>>;
+        parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strict>>;
     navigation: z.ZodObject<{
         primaryLinks: z.ZodArray<z.ZodObject<{
@@ -8141,6 +8201,7 @@ export declare const SitemapStreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObj
                 showInFooter: z.ZodBoolean;
                 order: z.ZodNumber;
             }, z.core.$strict>;
+            parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strict>>;
         navigation: z.ZodObject<{
             primaryLinks: z.ZodArray<z.ZodObject<{
@@ -8409,6 +8470,7 @@ export declare const SitemapRecordSchema: z.ZodObject<{
                 showInFooter: z.ZodBoolean;
                 order: z.ZodNumber;
             }, z.core.$strict>;
+            parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strict>>;
         navigation: z.ZodObject<{
             primaryLinks: z.ZodArray<z.ZodObject<{
@@ -8799,6 +8861,7 @@ export declare const SitemapDraftRecordSchema: 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;
@@ -8860,6 +8923,7 @@ export declare const PersistSiteSitemapRequestSchema: z.ZodObject<{
                 showInFooter: z.ZodBoolean;
                 order: z.ZodNumber;
             }, z.core.$strict>;
+            parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strict>>;
         navigation: z.ZodObject<{
             primaryLinks: z.ZodArray<z.ZodObject<{
@@ -9246,6 +9310,7 @@ export declare const ConfirmSiteStructureRequestSchema: 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;
@@ -9310,6 +9375,7 @@ export declare const PersistGeneratedSitemapDraftRequestSchema: z.ZodObject<{
                 showInFooter: z.ZodBoolean;
                 order: z.ZodNumber;
             }, z.core.$strict>;
+            parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strict>>;
         navigation: z.ZodObject<{
             primaryLinks: z.ZodArray<z.ZodObject<{
@@ -9757,6 +9823,7 @@ export declare const PersistSiteSitemapResponseSchema: z.ZodObject<{
                     showInFooter: z.ZodBoolean;
                     order: z.ZodNumber;
                 }, z.core.$strict>;
+                parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             }, z.core.$strict>>;
             navigation: z.ZodObject<{
                 primaryLinks: z.ZodArray<z.ZodObject<{
@@ -10367,6 +10434,7 @@ export declare const PersistSiteSitemapDraftResponseSchema: 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;
@@ -10653,6 +10721,7 @@ export declare const PersistGeneratedSitemapDraftResponseSchema: z.ZodObject<{
                     showInFooter: z.ZodBoolean;
                     order: z.ZodNumber;
                 }, z.core.$strict>;
+                parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             }, z.core.$strict>>;
             navigation: z.ZodObject<{
                 primaryLinks: z.ZodArray<z.ZodObject<{
@@ -12104,6 +12173,7 @@ export declare const WorkspaceRunKindSchema: z.ZodEnum<{
     landing_page: "landing_page";
     initial_generation: "initial_generation";
     iteration: "iteration";
+    fill_in: "fill_in";
 }>;
 export type WorkspaceRunKind = z.infer<typeof WorkspaceRunKindSchema>;
 /**
@@ -12170,6 +12240,7 @@ export declare const AgentMessageHistoryPurposeSchema: z.ZodEnum<{
 }>;
 export type AgentMessageHistoryPurpose = z.infer<typeof AgentMessageHistoryPurposeSchema>;
 export declare const AgentEventTypeSchema: z.ZodEnum<{
+    "workspace.generation_ledger": "workspace.generation_ledger";
     "run.started": "run.started";
     "skill.selecting": "skill.selecting";
     "skill.selected": "skill.selected";
@@ -12333,6 +12404,14 @@ export declare const WorkspacePlanTaskSchema: z.ZodObject<{
     required_reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
     search_params_sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
     standard_form_view: z.ZodOptional<z.ZodString>;
+    breadcrumb: z.ZodOptional<z.ZodObject<{
+        trail: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            href: z.ZodNullable<z.ZodString>;
+            omitted_href: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        current: z.ZodString;
+    }, z.core.$strict>>;
 }, z.core.$strip>;
 export type WorkspacePlanTask = z.infer<typeof WorkspacePlanTaskSchema>;
 export declare const WorkspacePlanDependencySchema: z.ZodObject<{
@@ -12354,6 +12433,7 @@ export declare const WorkspaceExecutionPlanSchema: z.ZodObject<{
         landing_page: "landing_page";
         initial_generation: "initial_generation";
         iteration: "iteration";
+        fill_in: "fill_in";
     }>;
     model_route: z.ZodObject<{
         planner: z.ZodLiteral<"workspace_planner">;
@@ -12419,6 +12499,14 @@ export declare const WorkspaceExecutionPlanSchema: z.ZodObject<{
         required_reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
         search_params_sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
         standard_form_view: z.ZodOptional<z.ZodString>;
+        breadcrumb: z.ZodOptional<z.ZodObject<{
+            trail: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                href: z.ZodNullable<z.ZodString>;
+                omitted_href: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            current: z.ZodString;
+        }, z.core.$strict>>;
     }, z.core.$strip>>;
     dependencies: z.ZodArray<z.ZodObject<{
         from_group_id: z.ZodString;
@@ -12779,6 +12867,7 @@ export declare const AgentEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 showInFooter: z.ZodBoolean;
                 order: z.ZodNumber;
             }, z.core.$strict>;
+            parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strict>>;
         navigation: z.ZodObject<{
             primaryLinks: z.ZodArray<z.ZodObject<{
@@ -13072,6 +13161,7 @@ export declare const AgentEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         landing_page: "landing_page";
         initial_generation: "initial_generation";
         iteration: "iteration";
+        fill_in: "fill_in";
     }>;
     groups: z.ZodArray<z.ZodObject<{
         group_id: z.ZodString;
@@ -13133,6 +13223,14 @@ export declare const AgentEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         required_reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
         search_params_sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
         standard_form_view: z.ZodOptional<z.ZodString>;
+        breadcrumb: z.ZodOptional<z.ZodObject<{
+            trail: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                href: z.ZodNullable<z.ZodString>;
+                omitted_href: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            current: z.ZodString;
+        }, z.core.$strict>>;
     }, z.core.$strip>>;
     dependencies: z.ZodArray<z.ZodObject<{
         from_group_id: z.ZodString;
@@ -13221,6 +13319,7 @@ export declare const AgentEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"workspace.degraded">;
     reason: z.ZodEnum<{
         patch_protected_dropped: "patch_protected_dropped";
+        preview_build_failed: "preview_build_failed";
         block_placeholder: "block_placeholder";
         form_placeholder: "form_placeholder";
         preview_health_degraded: "preview_health_degraded";
@@ -13230,6 +13329,9 @@ export declare const AgentEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         form_prebuild_skipped: "form_prebuild_skipped";
         form_section_fallback: "form_section_fallback";
         first_settings_sync_failed: "first_settings_sync_failed";
+        component_omitted: "component_omitted";
+        page_omitted: "page_omitted";
+        shared_fallback: "shared_fallback";
     }>;
     degraded_block_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
     dropped_files: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -13292,6 +13394,80 @@ export declare const AgentEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }>;
     type: z.ZodLiteral<"workspace.suggestions">;
     at: z.ZodString;
+}, z.core.$strict>, 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>, z.ZodObject<{
     type: z.ZodLiteral<"file.changed">;
     path: z.ZodString;
@@ -13367,6 +13543,77 @@ export declare const AgentEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         sandbox_unavailable: "sandbox_unavailable";
     }>>;
     build_verified: z.ZodOptional<z.ZodBoolean>;
+    generation_ledger: z.ZodOptional<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.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"media_resolution.started">;
@@ -13463,6 +13710,7 @@ export declare const AgentEventRecordSchema: z.ZodObject<{
     agent_run_id: z.ZodUUID;
     sequence: z.ZodNumber;
     event_type: z.ZodEnum<{
+        "workspace.generation_ledger": "workspace.generation_ledger";
         "run.started": "run.started";
         "skill.selecting": "skill.selecting";
         "skill.selected": "skill.selected";
@@ -13687,6 +13935,7 @@ export declare const AgentEventRecordSchema: z.ZodObject<{
                     showInFooter: z.ZodBoolean;
                     order: z.ZodNumber;
                 }, z.core.$strict>;
+                parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             }, z.core.$strict>>;
             navigation: z.ZodObject<{
                 primaryLinks: z.ZodArray<z.ZodObject<{
@@ -13980,6 +14229,7 @@ export declare const AgentEventRecordSchema: z.ZodObject<{
             landing_page: "landing_page";
             initial_generation: "initial_generation";
             iteration: "iteration";
+            fill_in: "fill_in";
         }>;
         groups: z.ZodArray<z.ZodObject<{
             group_id: z.ZodString;
@@ -14041,6 +14291,14 @@ export declare const AgentEventRecordSchema: z.ZodObject<{
             required_reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
             search_params_sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
             standard_form_view: z.ZodOptional<z.ZodString>;
+            breadcrumb: z.ZodOptional<z.ZodObject<{
+                trail: z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    href: z.ZodNullable<z.ZodString>;
+                    omitted_href: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+                current: z.ZodString;
+            }, z.core.$strict>>;
         }, z.core.$strip>>;
         dependencies: z.ZodArray<z.ZodObject<{
             from_group_id: z.ZodString;
@@ -14129,6 +14387,7 @@ export declare const AgentEventRecordSchema: z.ZodObject<{
         type: z.ZodLiteral<"workspace.degraded">;
         reason: z.ZodEnum<{
             patch_protected_dropped: "patch_protected_dropped";
+            preview_build_failed: "preview_build_failed";
             block_placeholder: "block_placeholder";
             form_placeholder: "form_placeholder";
             preview_health_degraded: "preview_health_degraded";
@@ -14138,6 +14397,9 @@ export declare const AgentEventRecordSchema: z.ZodObject<{
             form_prebuild_skipped: "form_prebuild_skipped";
             form_section_fallback: "form_section_fallback";
             first_settings_sync_failed: "first_settings_sync_failed";
+            component_omitted: "component_omitted";
+            page_omitted: "page_omitted";
+            shared_fallback: "shared_fallback";
         }>;
         degraded_block_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
         dropped_files: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -14200,6 +14462,80 @@ export declare const AgentEventRecordSchema: z.ZodObject<{
         }>;
         type: z.ZodLiteral<"workspace.suggestions">;
         at: z.ZodString;
+    }, z.core.$strict>, 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>, z.ZodObject<{
         type: z.ZodLiteral<"file.changed">;
         path: z.ZodString;
@@ -14275,6 +14611,77 @@ export declare const AgentEventRecordSchema: z.ZodObject<{
             sandbox_unavailable: "sandbox_unavailable";
         }>>;
         build_verified: z.ZodOptional<z.ZodBoolean>;
+        generation_ledger: z.ZodOptional<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.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"media_resolution.started">;
@@ -14369,6 +14776,7 @@ export declare const AgentEventRecordSchema: z.ZodObject<{
 export type AgentEventRecord = z.infer<typeof AgentEventRecordSchema>;
 export declare const AppendAgentEventRequestSchema: z.ZodObject<{
     event_type: z.ZodEnum<{
+        "workspace.generation_ledger": "workspace.generation_ledger";
         "run.started": "run.started";
         "skill.selecting": "skill.selecting";
         "skill.selected": "skill.selected";
@@ -14593,6 +15001,7 @@ export declare const AppendAgentEventRequestSchema: z.ZodObject<{
                     showInFooter: z.ZodBoolean;
                     order: z.ZodNumber;
                 }, z.core.$strict>;
+                parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             }, z.core.$strict>>;
             navigation: z.ZodObject<{
                 primaryLinks: z.ZodArray<z.ZodObject<{
@@ -14886,6 +15295,7 @@ export declare const AppendAgentEventRequestSchema: z.ZodObject<{
             landing_page: "landing_page";
             initial_generation: "initial_generation";
             iteration: "iteration";
+            fill_in: "fill_in";
         }>;
         groups: z.ZodArray<z.ZodObject<{
             group_id: z.ZodString;
@@ -14947,6 +15357,14 @@ export declare const AppendAgentEventRequestSchema: z.ZodObject<{
             required_reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
             search_params_sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
             standard_form_view: z.ZodOptional<z.ZodString>;
+            breadcrumb: z.ZodOptional<z.ZodObject<{
+                trail: z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    href: z.ZodNullable<z.ZodString>;
+                    omitted_href: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+                current: z.ZodString;
+            }, z.core.$strict>>;
         }, z.core.$strip>>;
         dependencies: z.ZodArray<z.ZodObject<{
             from_group_id: z.ZodString;
@@ -15035,6 +15453,7 @@ export declare const AppendAgentEventRequestSchema: z.ZodObject<{
         type: z.ZodLiteral<"workspace.degraded">;
         reason: z.ZodEnum<{
             patch_protected_dropped: "patch_protected_dropped";
+            preview_build_failed: "preview_build_failed";
             block_placeholder: "block_placeholder";
             form_placeholder: "form_placeholder";
             preview_health_degraded: "preview_health_degraded";
@@ -15044,6 +15463,9 @@ export declare const AppendAgentEventRequestSchema: z.ZodObject<{
             form_prebuild_skipped: "form_prebuild_skipped";
             form_section_fallback: "form_section_fallback";
             first_settings_sync_failed: "first_settings_sync_failed";
+            component_omitted: "component_omitted";
+            page_omitted: "page_omitted";
+            shared_fallback: "shared_fallback";
         }>;
         degraded_block_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
         dropped_files: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -15106,6 +15528,80 @@ export declare const AppendAgentEventRequestSchema: z.ZodObject<{
         }>;
         type: z.ZodLiteral<"workspace.suggestions">;
         at: z.ZodString;
+    }, z.core.$strict>, 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>, z.ZodObject<{
         type: z.ZodLiteral<"file.changed">;
         path: z.ZodString;
@@ -15181,6 +15677,77 @@ export declare const AppendAgentEventRequestSchema: z.ZodObject<{
             sandbox_unavailable: "sandbox_unavailable";
         }>>;
         build_verified: z.ZodOptional<z.ZodBoolean>;
+        generation_ledger: z.ZodOptional<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.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"media_resolution.started">;
@@ -15284,10 +15851,11 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
         }>;
         run_kind: z.ZodEnum<{
             landing_page: "landing_page";
-            sitemap: "sitemap";
-            clarify: "clarify";
             initial_generation: "initial_generation";
             iteration: "iteration";
+            fill_in: "fill_in";
+            sitemap: "sitemap";
+            clarify: "clarify";
         }>;
         status: z.ZodEnum<{
             succeeded: "succeeded";
@@ -15315,6 +15883,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
         agent_run_id: z.ZodUUID;
         sequence: z.ZodNumber;
         event_type: z.ZodEnum<{
+            "workspace.generation_ledger": "workspace.generation_ledger";
             "run.started": "run.started";
             "skill.selecting": "skill.selecting";
             "skill.selected": "skill.selected";
@@ -15539,6 +16108,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
                         showInFooter: z.ZodBoolean;
                         order: z.ZodNumber;
                     }, z.core.$strict>;
+                    parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 }, z.core.$strict>>;
                 navigation: z.ZodObject<{
                     primaryLinks: z.ZodArray<z.ZodObject<{
@@ -15832,6 +16402,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
                 landing_page: "landing_page";
                 initial_generation: "initial_generation";
                 iteration: "iteration";
+                fill_in: "fill_in";
             }>;
             groups: z.ZodArray<z.ZodObject<{
                 group_id: z.ZodString;
@@ -15893,6 +16464,14 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
                 required_reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 search_params_sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 standard_form_view: z.ZodOptional<z.ZodString>;
+                breadcrumb: z.ZodOptional<z.ZodObject<{
+                    trail: z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        href: z.ZodNullable<z.ZodString>;
+                        omitted_href: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>;
+                    current: z.ZodString;
+                }, z.core.$strict>>;
             }, z.core.$strip>>;
             dependencies: z.ZodArray<z.ZodObject<{
                 from_group_id: z.ZodString;
@@ -15981,6 +16560,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
             type: z.ZodLiteral<"workspace.degraded">;
             reason: z.ZodEnum<{
                 patch_protected_dropped: "patch_protected_dropped";
+                preview_build_failed: "preview_build_failed";
                 block_placeholder: "block_placeholder";
                 form_placeholder: "form_placeholder";
                 preview_health_degraded: "preview_health_degraded";
@@ -15990,6 +16570,9 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
                 form_prebuild_skipped: "form_prebuild_skipped";
                 form_section_fallback: "form_section_fallback";
                 first_settings_sync_failed: "first_settings_sync_failed";
+                component_omitted: "component_omitted";
+                page_omitted: "page_omitted";
+                shared_fallback: "shared_fallback";
             }>;
             degraded_block_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
             dropped_files: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -16052,6 +16635,80 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
             }>;
             type: z.ZodLiteral<"workspace.suggestions">;
             at: z.ZodString;
+        }, z.core.$strict>, 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>, z.ZodObject<{
             type: z.ZodLiteral<"file.changed">;
             path: z.ZodString;
@@ -16127,6 +16784,77 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
                 sandbox_unavailable: "sandbox_unavailable";
             }>>;
             build_verified: z.ZodOptional<z.ZodBoolean>;
+            generation_ledger: z.ZodOptional<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.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"media_resolution.started">;
@@ -16232,10 +16960,11 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
         }>;
         run_kind: z.ZodEnum<{
             landing_page: "landing_page";
-            sitemap: "sitemap";
-            clarify: "clarify";
             initial_generation: "initial_generation";
             iteration: "iteration";
+            fill_in: "fill_in";
+            sitemap: "sitemap";
+            clarify: "clarify";
         }>;
         status: z.ZodEnum<{
             succeeded: "succeeded";
@@ -16263,6 +16992,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
         agent_run_id: z.ZodUUID;
         sequence: z.ZodNumber;
         event_type: z.ZodEnum<{
+            "workspace.generation_ledger": "workspace.generation_ledger";
             "run.started": "run.started";
             "skill.selecting": "skill.selecting";
             "skill.selected": "skill.selected";
@@ -16487,6 +17217,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
                         showInFooter: z.ZodBoolean;
                         order: z.ZodNumber;
                     }, z.core.$strict>;
+                    parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 }, z.core.$strict>>;
                 navigation: z.ZodObject<{
                     primaryLinks: z.ZodArray<z.ZodObject<{
@@ -16780,6 +17511,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
                 landing_page: "landing_page";
                 initial_generation: "initial_generation";
                 iteration: "iteration";
+                fill_in: "fill_in";
             }>;
             groups: z.ZodArray<z.ZodObject<{
                 group_id: z.ZodString;
@@ -16841,6 +17573,14 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
                 required_reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 search_params_sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 standard_form_view: z.ZodOptional<z.ZodString>;
+                breadcrumb: z.ZodOptional<z.ZodObject<{
+                    trail: z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        href: z.ZodNullable<z.ZodString>;
+                        omitted_href: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>;
+                    current: z.ZodString;
+                }, z.core.$strict>>;
             }, z.core.$strip>>;
             dependencies: z.ZodArray<z.ZodObject<{
                 from_group_id: z.ZodString;
@@ -16929,6 +17669,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
             type: z.ZodLiteral<"workspace.degraded">;
             reason: z.ZodEnum<{
                 patch_protected_dropped: "patch_protected_dropped";
+                preview_build_failed: "preview_build_failed";
                 block_placeholder: "block_placeholder";
                 form_placeholder: "form_placeholder";
                 preview_health_degraded: "preview_health_degraded";
@@ -16938,6 +17679,9 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
                 form_prebuild_skipped: "form_prebuild_skipped";
                 form_section_fallback: "form_section_fallback";
                 first_settings_sync_failed: "first_settings_sync_failed";
+                component_omitted: "component_omitted";
+                page_omitted: "page_omitted";
+                shared_fallback: "shared_fallback";
             }>;
             degraded_block_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
             dropped_files: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -17000,6 +17744,80 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
             }>;
             type: z.ZodLiteral<"workspace.suggestions">;
             at: z.ZodString;
+        }, z.core.$strict>, 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>, z.ZodObject<{
             type: z.ZodLiteral<"file.changed">;
             path: z.ZodString;
@@ -17075,6 +17893,77 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
                 sandbox_unavailable: "sandbox_unavailable";
             }>>;
             build_verified: z.ZodOptional<z.ZodBoolean>;
+            generation_ledger: z.ZodOptional<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.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"media_resolution.started">;
@@ -17177,6 +18066,7 @@ export declare const ListAgentEventsResponseSchema: z.ZodObject<{
         agent_run_id: z.ZodUUID;
         sequence: z.ZodNumber;
         event_type: z.ZodEnum<{
+            "workspace.generation_ledger": "workspace.generation_ledger";
             "run.started": "run.started";
             "skill.selecting": "skill.selecting";
             "skill.selected": "skill.selected";
@@ -17401,6 +18291,7 @@ export declare const ListAgentEventsResponseSchema: z.ZodObject<{
                         showInFooter: z.ZodBoolean;
                         order: z.ZodNumber;
                     }, z.core.$strict>;
+                    parent_page_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 }, z.core.$strict>>;
                 navigation: z.ZodObject<{
                     primaryLinks: z.ZodArray<z.ZodObject<{
@@ -17694,6 +18585,7 @@ export declare const ListAgentEventsResponseSchema: z.ZodObject<{
                 landing_page: "landing_page";
                 initial_generation: "initial_generation";
                 iteration: "iteration";
+                fill_in: "fill_in";
             }>;
             groups: z.ZodArray<z.ZodObject<{
                 group_id: z.ZodString;
@@ -17755,6 +18647,14 @@ export declare const ListAgentEventsResponseSchema: z.ZodObject<{
                 required_reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 search_params_sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 standard_form_view: z.ZodOptional<z.ZodString>;
+                breadcrumb: z.ZodOptional<z.ZodObject<{
+                    trail: z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        href: z.ZodNullable<z.ZodString>;
+                        omitted_href: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>;
+                    current: z.ZodString;
+                }, z.core.$strict>>;
             }, z.core.$strip>>;
             dependencies: z.ZodArray<z.ZodObject<{
                 from_group_id: z.ZodString;
@@ -17843,6 +18743,7 @@ export declare const ListAgentEventsResponseSchema: z.ZodObject<{
             type: z.ZodLiteral<"workspace.degraded">;
             reason: z.ZodEnum<{
                 patch_protected_dropped: "patch_protected_dropped";
+                preview_build_failed: "preview_build_failed";
                 block_placeholder: "block_placeholder";
                 form_placeholder: "form_placeholder";
                 preview_health_degraded: "preview_health_degraded";
@@ -17852,6 +18753,9 @@ export declare const ListAgentEventsResponseSchema: z.ZodObject<{
                 form_prebuild_skipped: "form_prebuild_skipped";
                 form_section_fallback: "form_section_fallback";
                 first_settings_sync_failed: "first_settings_sync_failed";
+                component_omitted: "component_omitted";
+                page_omitted: "page_omitted";
+                shared_fallback: "shared_fallback";
             }>;
             degraded_block_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
             dropped_files: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -17914,6 +18818,80 @@ export declare const ListAgentEventsResponseSchema: z.ZodObject<{
             }>;
             type: z.ZodLiteral<"workspace.suggestions">;
             at: z.ZodString;
+        }, z.core.$strict>, 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>, z.ZodObject<{
             type: z.ZodLiteral<"file.changed">;
             path: z.ZodString;
@@ -17989,6 +18967,77 @@ export declare const ListAgentEventsResponseSchema: z.ZodObject<{
                 sandbox_unavailable: "sandbox_unavailable";
             }>>;
             build_verified: z.ZodOptional<z.ZodBoolean>;
+            generation_ledger: z.ZodOptional<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.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"media_resolution.started">;
@@ -18548,11 +19597,11 @@ export declare const REST_API_ENDPOINTS: readonly [{
     readonly method: "POST";
     readonly path: "/internal/sites/:site_id/page-templates";
     readonly tag: "page-templates";
-    readonly summary: "Create a private page template through the authenticated VCP internal service surface.";
+    readonly summary: "Accept 1–3 Page Template items as one asynchronous Workspace task (HTTP 202).";
     readonly status: "implemented";
     readonly request_body_schema: "PageTemplateCreateRequestSchema";
     readonly response_schema: "PageTemplateCreateResponseSchema";
-    readonly notes: readonly ["Internal service endpoint; callers use the API bearer token plus trusted tenant/user headers. API delegates to Agent with its own AGENT_INTERNAL_TOKEN and never forwards caller Authorization."];
+    readonly notes: readonly ["Internal bearer plus tenant context; API starts one new background thread/run with its fixed system identity. Poll GET /internal/external-site-edits/:task_id; no external IDs or callbacks. Manifest-gated whole-batch success commits exactly one snapshot."];
 }, {
     readonly method: "POST";
     readonly path: "/internal/sites/:site_id/page-templates/promote";
@@ -18731,6 +19780,15 @@ export declare const REST_API_ENDPOINTS: readonly [{
     readonly summary: "Replay AgentEvents after a run-local sequence cursor.";
     readonly status: "implemented";
     readonly response_schema: "ListAgentEventsResponseSchema";
+}, {
+    readonly method: "POST";
+    readonly path: "/agent-runs/workspace/stop";
+    readonly tag: "agent-runs";
+    readonly summary: "Request a soft stop of the active first-generation or fill-in run for a site.";
+    readonly status: "implemented";
+    readonly request_body_schema: "StopWorkspaceGenerationRequestSchema";
+    readonly response_schema: "StopWorkspaceGenerationResponseSchema";
+    readonly notes: readonly ["Browser surface with the same tenant scoping as POST /agent-runs/workspace/cancel: only the active initial_generation / fill_in run of a site in the caller's tenant is touched.", "A run holding a live lease gets stop_requested_at instead of a terminal event, so it keeps the pages it already saved and closes itself: status=requested, or already_requested on a repeat (the first stop timestamp is never moved).", "A run whose lease has lapsed has no process left to honour the flag, so it is closed immediately (run.failed, site lock released) and the answer is status=stopped. Nothing in flight returns no_active_run with run_id null."];
 }, {
     readonly method: "POST";
     readonly path: "/internal/agent-runs/fail-stale-in-flight";
@@ -18739,12 +19797,79 @@ export declare const REST_API_ENDPOINTS: readonly [{
     readonly status: "implemented";
     readonly response_schema: "FailStaleInFlightWorkspaceRunsResponseSchema";
     readonly notes: readonly ["Internal maintenance endpoint guarded by InternalAgentAuthGuard (Bearer VCP_AGENT_INTERNAL_TOKEN, production fail-closed); the /internal/** prefix is exempt from browser auth middleware so the guard is the sole trust boundary. Not exposed to the browser via agent-proxy; called by an external admin cron / controlled ops script."];
+}, {
+    readonly method: "POST";
+    readonly path: "/internal/agent-runs/claim-stale-workspace-runs";
+    readonly tag: "agent-runs";
+    readonly summary: "Claim stale workspace runs for resumption (internal maintenance, cross-tenant sweep).";
+    readonly status: "implemented";
+    readonly response_schema: "ClaimStaleWorkspaceRunsResponseSchema";
+    readonly notes: readonly ["Internal maintenance endpoint guarded by InternalAgentAuthGuard; same trust boundary as fail-stale-in-flight and not exposed to the browser.", "Re-issues a fresh lease_owner (fencing token) and increments resume_count in one UPDATE for each resumable initial run; a lease expiring only means the work was interrupted, not that the run failed. Initial runs that used up WORKSPACE_MAX_RESUME_COUNT and interrupted fill-in runs are failed instead and are absent from the response."];
+}, {
+    readonly method: "GET";
+    readonly path: "/internal/agent-runs/:run_id/context";
+    readonly tag: "agent-runs";
+    readonly summary: "Resolve run thread context (internal, Agent Runtime).";
+    readonly status: "implemented";
+    readonly response_schema: "AgentRunContextResponseSchema";
+    readonly notes: readonly ["Internal endpoint guarded by InternalAgentAuthGuard; tenant comes from x-vcp-tenant-id.", "Returns the run together with its thread (null = the site main thread); a run outside the tenant is 404."];
+}, {
+    readonly method: "POST";
+    readonly path: "/internal/agent-runs/:run_id/heartbeat";
+    readonly tag: "agent-runs";
+    readonly summary: "Renew a workspace run lease (internal, Agent Runtime).";
+    readonly status: "implemented";
+    readonly request_body_schema: "WorkspaceRunHeartbeatRequestSchema";
+    readonly response_schema: "WorkspaceRunHeartbeatResponseSchema";
+    readonly notes: readonly ["Internal endpoint guarded by InternalAgentAuthGuard; tenant comes from x-vcp-tenant-id.", "One CAS UPDATE checks that the run is still in flight and that lease_owner has not been re-issued: superseded means another attempt took over and this process must stop dispatching; not_active means the run already reached a terminal state."];
+}, {
+    readonly method: "POST";
+    readonly path: "/internal/agent-runs/:run_id/page-checkpoints";
+    readonly tag: "agent-runs";
+    readonly summary: "Register a workspace page checkpoint (internal, Agent Runtime).";
+    readonly status: "implemented";
+    readonly request_body_schema: "RegisterWorkspacePageCheckpointRequestSchema";
+    readonly response_schema: "WorkspacePageCheckpointSchema";
+    readonly notes: readonly ["Internal endpoint guarded by InternalAgentAuthGuard; tenant comes from x-vcp-tenant-id.", "Idempotent on (tenant_id, run_id, page_id, attempt): a conflict returns the existing row unchanged. The object must already be written to storage — a failed registration means the page was not saved. A lease_owner that no longer matches the run is 409, and a run in a terminal state is 409."];
+}, {
+    readonly method: "GET";
+    readonly path: "/internal/agent-runs/:run_id/page-checkpoints";
+    readonly tag: "agent-runs";
+    readonly summary: "List workspace page checkpoints (internal, Agent Runtime).";
+    readonly status: "implemented";
+    readonly response_schema: "ListWorkspacePageCheckpointsResponseSchema";
+    readonly notes: readonly ["Internal endpoint guarded by InternalAgentAuthGuard; returns one row per page_id (the highest attempt). A run outside the tenant returns no checkpoints."];
+}, {
+    readonly method: "GET";
+    readonly path: "/internal/agent-runs/:run_id/run-control";
+    readonly tag: "agent-runs";
+    readonly summary: "Read workspace run control input (internal, Agent Runtime).";
+    readonly status: "implemented";
+    readonly response_schema: "WorkspaceRunControlInputResponseSchema";
+    readonly notes: readonly ["Internal endpoint guarded by InternalAgentAuthGuard; AgentRunRecord carries no input, so the lease owner, stop flag, resume count and fill-in inputs stored on the run row are read here. A run outside the tenant, or one that is not a workspace run, is 404."];
 }, {
     readonly method: "GET";
     readonly path: "/deployments";
     readonly tag: "deployments";
     readonly summary: "Deployment resource summary endpoint until publish APIs land.";
     readonly status: "skeleton";
+}, {
+    readonly method: "GET";
+    readonly path: "/sites/:site_id/generation-ledger";
+    readonly tag: "sites";
+    readonly summary: "Read the stored generation ledger of a site (omitted deliverables and fill-in progress).";
+    readonly status: "implemented";
+    readonly response_schema: "SiteGenerationLedgerResponseSchema";
+    readonly notes: readonly ["One ledger per (tenant_id, site_id), written when an initial_generation / fill_in run.finished carries generation_ledger. A site that has never finished such a run returns ledger null with source_run_id and updated_at null."];
+}, {
+    readonly method: "POST";
+    readonly path: "/sites/:site_id/generation/fill-in";
+    readonly tag: "sites";
+    readonly summary: "Start a fill-in run for deliverables the generation ledger still lists as omitted.";
+    readonly status: "implemented";
+    readonly request_body_schema: "StartFillInRequestSchema";
+    readonly response_schema: "StartFillInResponseSchema";
+    readonly notes: readonly ["Every target must still be listed as an unfilled omission in the site ledger; otherwise 400 FILL_IN_TARGET_NOT_OMITTED with details.target_id. A site with no ledger at all is rejected with the same code.", "The site must be workspace_ready; otherwise 409 FILL_IN_NOT_AVAILABLE.", "A fill-in run does not take the per-site workspace_run operation lock: while it runs the user keeps browsing. client_run_key makes the POST idempotent — repeating it returns the existing in-flight run and does not dispatch it again; another in-flight workspace run on the same site is rejected with 409 WORKSPACE_RUN_IN_FLIGHT."];
 }, {
     readonly method: "POST";
     readonly path: "/sites/:site_id/workspace/runs";
@@ -18762,6 +19887,15 @@ export declare const REST_API_ENDPOINTS: readonly [{
     readonly status: "implemented";
     readonly response_schema: "WorkspaceAttachmentSchema";
     readonly notes: readonly ["multipart/form-data with a single `file`; the response `image_url` is referenced by a `file` part of the next client message."];
+}, {
+    readonly method: "POST";
+    readonly path: "/sites/:site_id/workspace/attachments/from-url";
+    readonly tag: "workspace";
+    readonly summary: "Capture a screenshot of a web page and store it as a chat image attachment.";
+    readonly status: "implemented";
+    readonly request_body_schema: "WorkspaceAttachmentFromUrlRequestSchema";
+    readonly response_schema: "WorkspaceAttachmentSchema";
+    readonly notes: readonly ["The screenshot becomes an ordinary attachment: same quotas, same `file` part reference, never placed on the site.", "Capture runs through the ingestion service (SSRF guard, concurrency gate, Firecrawl credits)."];
 }, {
     readonly method: "GET";
     readonly path: "/sites/:site_id/workspace/attachments/:attachment_id/image";
@@ -19358,6 +20492,7 @@ export declare const WorkspaceSocketDescriptorSchema: z.ZodObject<{
         landing_page: "landing_page";
         initial_generation: "initial_generation";
         iteration: "iteration";
+        fill_in: "fill_in";
     }>;
 }, z.core.$strip>;
 export type WorkspaceSocketDescriptor = z.infer<typeof WorkspaceSocketDescriptorSchema>;
@@ -19373,10 +20508,11 @@ export declare const StartWorkspaceRunResponseSchema: z.ZodObject<{
         }>;
         run_kind: z.ZodEnum<{
             landing_page: "landing_page";
-            sitemap: "sitemap";
-            clarify: "clarify";
             initial_generation: "initial_generation";
             iteration: "iteration";
+            fill_in: "fill_in";
+            sitemap: "sitemap";
+            clarify: "clarify";
         }>;
         status: z.ZodEnum<{
             succeeded: "succeeded";
@@ -19405,6 +20541,7 @@ export declare const StartWorkspaceRunResponseSchema: z.ZodObject<{
             landing_page: "landing_page";
             initial_generation: "initial_generation";
             iteration: "iteration";
+            fill_in: "fill_in";
         }>;
     }, z.core.$strip>;
     next_step: z.ZodLiteral<"workspace_socket">;
@@ -19430,10 +20567,11 @@ export declare const LatestWorkspaceRunResponseSchema: z.ZodObject<{
         }>;
         run_kind: z.ZodEnum<{
             landing_page: "landing_page";
-            sitemap: "sitemap";
-            clarify: "clarify";
             initial_generation: "initial_generation";
             iteration: "iteration";
+            fill_in: "fill_in";
+            sitemap: "sitemap";
+            clarify: "clarify";
         }>;
         status: z.ZodEnum<{
             succeeded: "succeeded";
@@ -19473,10 +20611,11 @@ export declare const ActiveWorkspaceRunResponseSchema: z.ZodObject<{
         }>;
         run_kind: z.ZodEnum<{
             landing_page: "landing_page";
-            sitemap: "sitemap";
-            clarify: "clarify";
             initial_generation: "initial_generation";
             iteration: "iteration";
+            fill_in: "fill_in";
+            sitemap: "sitemap";
+            clarify: "clarify";
         }>;
         status: z.ZodEnum<{
             succeeded: "succeeded";
@@ -19623,10 +20762,11 @@ export declare const LatestAgentRunResponseSchema: z.ZodObject<{
         }>;
         run_kind: z.ZodEnum<{
             landing_page: "landing_page";
-            sitemap: "sitemap";
-            clarify: "clarify";
             initial_generation: "initial_generation";
             iteration: "iteration";
+            fill_in: "fill_in";
+            sitemap: "sitemap";
+            clarify: "clarify";
         }>;
         status: z.ZodEnum<{
             succeeded: "succeeded";
@@ -20513,6 +21653,7 @@ export declare const WorkspaceServerMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
             landing_page: "landing_page";
             initial_generation: "initial_generation";
             iteration: "iteration";
+            fill_in: "fill_in";
         }>;
         groups: z.ZodArray<z.ZodObject<{
             group_id: z.ZodString;
@@ -20574,6 +21715,14 @@ export declare const WorkspaceServerMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
             required_reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
             search_params_sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
             standard_form_view: z.ZodOptional<z.ZodString>;
+            breadcrumb: z.ZodOptional<z.ZodObject<{
+                trail: z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    href: z.ZodNullable<z.ZodString>;
+                    omitted_href: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+                current: z.ZodString;
+            }, z.core.$strict>>;
         }, z.core.$strip>>;
         dependencies: z.ZodArray<z.ZodObject<{
             from_group_id: z.ZodString;
@@ -21742,6 +22891,7 @@ export declare const WorkspaceWebSocketMessageSchema: z.ZodUnion<readonly [z.Zod
             landing_page: "landing_page";
             initial_generation: "initial_generation";
             iteration: "iteration";
+            fill_in: "fill_in";
         }>;
         groups: z.ZodArray<z.ZodObject<{
             group_id: z.ZodString;
@@ -21803,6 +22953,14 @@ export declare const WorkspaceWebSocketMessageSchema: z.ZodUnion<readonly [z.Zod
             required_reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
             search_params_sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
             standard_form_view: z.ZodOptional<z.ZodString>;
+            breadcrumb: z.ZodOptional<z.ZodObject<{
+                trail: z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    href: z.ZodNullable<z.ZodString>;
+                    omitted_href: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+                current: z.ZodString;
+            }, z.core.$strict>>;
         }, z.core.$strip>>;
         dependencies: z.ZodArray<z.ZodObject<{
             from_group_id: z.ZodString;
@@ -22615,12 +23773,12 @@ export declare const SandboxSessionStatusSchema: z.ZodEnum<{
     creating: "creating";
     ready: "ready";
     active: "active";
+    stopped: "stopped";
     idle: "idle";
     restoring_snapshot: "restoring_snapshot";
     installing_dependencies: "installing_dependencies";
     starting_preview: "starting_preview";
     stopping: "stopping";
-    stopped: "stopped";
 }>;
 export type SandboxSessionStatus = z.infer<typeof SandboxSessionStatusSchema>;
 export declare const SandboxSessionSchema: z.ZodObject<{
@@ -22633,12 +23791,12 @@ export declare const SandboxSessionSchema: z.ZodObject<{
         creating: "creating";
         ready: "ready";
         active: "active";
+        stopped: "stopped";
         idle: "idle";
         restoring_snapshot: "restoring_snapshot";
         installing_dependencies: "installing_dependencies";
         starting_preview: "starting_preview";
         stopping: "stopping";
-        stopped: "stopped";
     }>;
     source_snapshot_id: z.ZodNullable<z.ZodUUID>;
     last_snapshot_id: z.ZodNullable<z.ZodUUID>;
@@ -22663,12 +23821,12 @@ export declare const PersistPreviewSessionRequestSchema: z.ZodObject<{
         creating: "creating";
         ready: "ready";
         active: "active";
+        stopped: "stopped";
         idle: "idle";
         restoring_snapshot: "restoring_snapshot";
         installing_dependencies: "installing_dependencies";
         starting_preview: "starting_preview";
         stopping: "stopping";
-        stopped: "stopped";
     }>;
     preview_url: z.ZodOptional<z.ZodString>;
     launch_id: z.ZodOptional<z.ZodString>;
@@ -22685,12 +23843,12 @@ export declare const PersistPreviewSessionResponseSchema: z.ZodObject<{
             creating: "creating";
             ready: "ready";
             active: "active";
+            stopped: "stopped";
             idle: "idle";
             restoring_snapshot: "restoring_snapshot";
             installing_dependencies: "installing_dependencies";
             starting_preview: "starting_preview";
             stopping: "stopping";
-            stopped: "stopped";
         }>;
         source_snapshot_id: z.ZodNullable<z.ZodUUID>;
         last_snapshot_id: z.ZodNullable<z.ZodUUID>;
@@ -22739,6 +23897,13 @@ export type FailStaleInFlightWorkspaceRunsResponse = z.infer<typeof FailStaleInF
  * use. This lets a user "stop" actually release the lock even when the driving
  * WebSocket is gone (page refresh, terminal close, or agent restart left the
  * run orphaned). status=no_active_run when nothing was in flight.
+ *
+ * Exception: for initial_generation / fill_in runs that still hold a live lease
+ * this is a soft stop — it only writes stop_requested_at so the run can keep the
+ * pages it already saved and close itself, and answers status=stop_requested
+ * with the still-running agent_run. Such a run without a live lease has no
+ * process left to honour the flag, so it takes the terminal path above and
+ * answers status=cancelled like every other run_kind.
  */
 export declare const CancelActiveWorkspaceRunRequestSchema: z.ZodObject<{
     site_id: z.ZodUUID;
@@ -22746,6 +23911,7 @@ export declare const CancelActiveWorkspaceRunRequestSchema: z.ZodObject<{
 export type CancelActiveWorkspaceRunRequest = z.infer<typeof CancelActiveWorkspaceRunRequestSchema>;
 export declare const CancelActiveWorkspaceRunResponseSchema: z.ZodObject<{
     status: z.ZodEnum<{
+        stop_requested: "stop_requested";
         cancelled: "cancelled";
         no_active_run: "no_active_run";
     }>;
@@ -22760,10 +23926,11 @@ export declare const CancelActiveWorkspaceRunResponseSchema: z.ZodObject<{
         }>;
         run_kind: z.ZodEnum<{
             landing_page: "landing_page";
-            sitemap: "sitemap";
-            clarify: "clarify";
             initial_generation: "initial_generation";
             iteration: "iteration";
+            fill_in: "fill_in";
+            sitemap: "sitemap";
+            clarify: "clarify";
         }>;
         status: z.ZodEnum<{
             succeeded: "succeeded";