@vcp-dev/contracts 0.6.11 → 0.7.1

package/dist/subsite-localization-input.d.ts

@@ -0,0 +1,121 @@
+import { z } from "zod";
+/**
+ * 子站本地化的**上游可传入参**合同：术语表与站点信息。
+ *
+ * 两项都可选，两项都遵循同一条取向：**服务不猜上游本该给的东西**。子站编排链路
+ * 上只有调用方知道「这个品牌词该译成什么」「这个站是做什么的」，服务端能做的只是
+ * 从主站已有数据里尽力还原一份兜底；传了就用传的，没传才走兜底。
+ *
+ * 三个使用点共用本文件：`apps/api` 公网入口（subsites.controller）、
+ * 该入口组装的入队 payload（subsites.service）、以及 `services/subsite-service`
+ * 侧对 payload 的读取。口径只此一份。
+ */
+/** 单条术语表条目的长度上限。原文与译文都是短语，超长即为误用。 */
+export declare const SUBSITE_GLOSSARY_ENTRY_MAX_CHARS = 200;
+/**
+ * 术语表条目数上限。术语表随**每一个**翻译批次一起发出去（不是每站一次），
+ * 条数直接乘进每批的输入 token，因此必须有上界。
+ */
+export declare const SUBSITE_GLOSSARY_MAX_ENTRIES = 200;
+/**
+ * 术语表条目的形态：`"原文:译文"`，半角冒号分隔，取第一个冒号为分隔点
+ * （译文里可以再出现冒号）。
+ *
+ * ✓ 实测（dev 翻译服务，2026-08-16）：术语表是**以指令方式交给模型**的，不是
+ * 字符串替换——同一批 6 条含品牌词的中文，不带术语表时译名在
+ * `SANY Heavy Industry` 与 `Sany Heavy Industry` 之间三三分裂；带上
+ * `三一重工:SANY` 后 6/6 全部落在 `SANY`。这正是「一个品牌名在产出站里裂成三种
+ * 写法」这条缺陷的修法。
+ *
+ * 返回 `null` 表示形态不合格（没有冒号、冒号在首位、或某一侧只有空白）。
+ */
+export declare function splitSubsiteGlossaryEntry(entry: string): {
+    readonly source: string;
+    readonly target: string;
+} | null;
+/**
+ * 单条术语表条目。**刻意不做 transform**：schema effect 会让 `z.toJSONSchema`
+ * 抛错，连带炸掉 OpenAPI 文档生成（与 `SubsiteMountPathSchema` 同一条约束）。
+ * refine 只校验不改值，条目原样进入翻译请求体。
+ */
+export declare const SubsiteGlossaryEntrySchema: z.ZodString;
+export declare const SubsiteGlossariesSchema: z.ZodArray<z.ZodString>;
+/**
+ * 翻译服务的站点上下文。
+ *
+ * **只有 `website_name` 必填**，行业与一句话简介可缺。✓ 实测（dev，2026-08-16）：
+ * 该服务对 `site_info` 既不强制存在、也不要求三项齐全——完全不带 `site_info`
+ * 与只带 `website_name` 都返回 200 且译文正常。因此「凑不齐三项」不是中止本地化
+ * 的正当理由：缺的字段省略掉，照常翻译，把不完整记成可观测的降级信号。
+ */
+export declare const SubsiteSiteInfoSchema: z.ZodObject<{
+    website_name: z.ZodString;
+    website_industry: z.ZodOptional<z.ZodString>;
+    website_description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SubsiteSiteInfo = z.infer<typeof SubsiteSiteInfoSchema>;
+/**
+ * 配色本地化档位。
+ *
+ * **只约束颜色与明暗底面，不约束图片**：`fonts_only` 档下用户在 `note` 里写的
+ * 换图诉求仍然生效。档位这个词容易被读成「什么都不变」，界面提示语必须写明这一点。
+ *
+ * 只有两档，却覆盖三级优先级：锁定色值不是第三种模式，而是在 `regional` 档下
+ * 按槽施加的约束（见 `SubsitePaletteSeedsSchema`）。
+ */
+export declare const SubsitePaletteModeSchema: z.ZodEnum<{
+    regional: "regional";
+    fonts_only: "fonts_only";
+}>;
+export type SubsitePaletteMode = z.infer<typeof SubsitePaletteModeSchema>;
+/**
+ * 用户锁定的色值。只接受 `#rrggbb`——界面给的是取色器，出来就是十六进制；
+ * 模型面 schema 允许 CSS 颜色名是给模型的宽容度，用户输入不需要那份宽容。
+ *
+ * **刻意不做 transform**：schema effect 会让 `z.toJSONSchema` 抛错，连带炸掉
+ * OpenAPI 文档生成（与 `SubsiteGlossaryEntrySchema` 同一条约束）。
+ */
+export declare const SubsiteHexColorSchema: z.ZodString;
+/**
+ * 四个角色与 `DesignColorSeeds` 一一对应，不自造一套命名。**逐槽可选**：
+ * 填了的槽服务端强制覆盖模型产出，空槽交给模型按目标地区补齐。
+ */
+export declare const SubsitePaletteSeedsSchema: z.ZodObject<{
+    primary: z.ZodOptional<z.ZodString>;
+    accent: z.ZodOptional<z.ZodString>;
+    foreground: z.ZodOptional<z.ZodString>;
+    neutral: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SubsitePaletteSeeds = z.infer<typeof SubsitePaletteSeedsSchema>;
+/** 风格补充说明的长度上限。整段进用户提示词，必须有上界。 */
+export declare const SUBSITE_PALETTE_NOTE_MAX_CHARS = 600;
+export declare const SubsitePaletteLocalizationSchema: z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+        regional: "regional";
+        fonts_only: "fonts_only";
+    }>>;
+    seeds: z.ZodOptional<z.ZodObject<{
+        primary: z.ZodOptional<z.ZodString>;
+        accent: z.ZodOptional<z.ZodString>;
+        foreground: z.ZodOptional<z.ZodString>;
+        neutral: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SubsitePaletteLocalization = z.infer<typeof SubsitePaletteLocalizationSchema>;
+/**
+ * 缺省档位。
+ *
+ * 存在的理由是一个容易踩的 zod 行为：上游把整个 `palette` 声明成 `.optional()`
+ * 之后，字段整体缺席时解析结果是 `undefined`，内层 `mode` 的 `.default()`
+ * **根本没机会触发**。若不在服务端显式补这一格，`undefined` 会一路传到底，
+ * 而下游每一层都得自己猜「空了算哪档」——同样的请求会产出不同结果。
+ */
+export declare const DEFAULT_SUBSITE_PALETTE: SubsitePaletteLocalization;
+/**
+ * 是否锁了至少一个色值槽。
+ *
+ * 两个使用点共用：公网入口据此拒绝「只改字体 + 又锁了色值」这种矛盾输入；
+ * 决策侧据此决定要不要逐槽压掉模型的颜色产出。
+ */
+export declare function hasLockedSeeds(seeds: SubsitePaletteSeeds | undefined): boolean;

package/dist/subsite-mount-path.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+/**
+ * 子站挂载路径合同（设计 5.3 约束 3）：单层、小写、带前导斜杠、不带尾斜杠，
+ * 形如 `/fr`。三个校验点——apps/api 公网入口（subsites.controller）、
+ * apps/api 内部回写（internal-subsites.controller）、subsite-service 入队
+ * （subsite-jobs.controller）——共用本文件，口径只此一份。
+ */
+export declare const SUBSITE_MOUNT_PATH_PATTERN: RegExp;
+/**
+ * 设计 5.4 保留段清单：主站基础设施占用的一级路径，不得作为 `mount_path`。
+ * `_next` / `robots.txt` / `sitemap.xml` / `.well-known` 当前已被字符集正则
+ * 天然挡掉（下划线与点号不在集合内），仍全量列出——保留段语义不依赖正则的
+ * 具体收紧程度，正则将来放宽（如允许点号后缀）时清单继续兜底。
+ */
+export declare const SUBSITE_RESERVED_MOUNT_SEGMENTS: readonly ["api", "_next", "assets", "static", "robots.txt", "sitemap.xml", ".well-known"];
+/** 传入不带前导斜杠的一级段（如 `api`）。 */
+export declare function isReservedSubsiteMountSegment(segment: string): boolean;
+/**
+ * 唯一的 `mount_path` 校验 schema：形态正则 + 保留段拦截。
+ * 刻意不做 transform（schema effect 会让 `z.toJSONSchema` 抛错，
+ * 连带炸掉 OpenAPI 文档生成），refine 仅校验不改值。
+ */
+export declare const SubsiteMountPathSchema: z.ZodString;

package/dist/subsite-sync-diff.d.ts

@@ -0,0 +1,76 @@
+import { z } from "zod";
+/** 一份快照在 store 上的定位坐标。**没有 store 根**：那是被调用方自己的挂载点。 */
+declare const SnapshotRefSchema: z.ZodObject<{
+    snapshot_id: z.ZodString;
+    object_key: z.ZodString;
+}, z.core.$strip>;
+export type SubsiteSyncDiffSnapshotRef = z.infer<typeof SnapshotRefSchema>;
+/**
+ * 请求体。`base` 是子站当前快照（差集的被减数），`target` 是主站目标快照
+ * （已发布优先，未发布回落 current）——两者都由 apps/api 在带 `tenant_id` 过滤的
+ * where 下解析出来，是「跨租户 object key 不可能出现」这条保证的唯一来源。
+ *
+ * 刻意**不接受** `sync_enabled`：那是主库 `sites` 上的用户开关，subsite-service
+ * 不读主库、对它没有任何裁决权。让它在这条通道上来回一趟只会让人误以为编排服务
+ * 参与了那个判断。开关状态由 apps/api 自己补进对外响应。
+ */
+export declare const SubsiteSyncDiffComputeRequestSchema: z.ZodObject<{
+    tenant_id: z.ZodString;
+    parent_site_id: z.ZodString;
+    subsite_site_id: z.ZodString;
+    base: z.ZodObject<{
+        snapshot_id: z.ZodString;
+        object_key: z.ZodString;
+    }, z.core.$strip>;
+    target: z.ZodObject<{
+        snapshot_id: z.ZodString;
+        object_key: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SubsiteSyncDiffComputeRequest = z.infer<typeof SubsiteSyncDiffComputeRequestSchema>;
+/**
+ * 响应体。**绝不回带 `object_key`、store 绝对路径或内部堆栈**：调用方（apps/api）
+ * 那两个值本来就是自己传进去的，回显它们只会平白多一条把挂载点形状泄漏出去的路。
+ *
+ * `hash_diverged_count` / `child_only_count` 是原始读数，只出计数不出路径清单
+ * ——子站文件是主站文件的译文，同路径 hash 天然不同，把它当「主站改了 N 页」展示
+ * 是 100% 误报（口径见 apps/api 的 `SubsiteSyncDiffResponseSchema` 描述）。
+ */
+export declare const SubsiteSyncDiffComputeResponseSchema: z.ZodObject<{
+    subsite_site_id: z.ZodString;
+    pending_pages: z.ZodArray<z.ZodString>;
+    hash_diverged_count: z.ZodNumber;
+    child_only_count: z.ZodNumber;
+    base_snapshot_id: z.ZodString;
+    target_snapshot_id: z.ZodString;
+}, z.core.$strip>;
+export type SubsiteSyncDiffComputeResponse = z.infer<typeof SubsiteSyncDiffComputeResponseSchema>;
+/**
+ * 编排服务在读不出清单时返回的结构化错误码。
+ *
+ * **缺失或不可读的清单永远是错误，绝不退化成 `pending_pages: []`**——调用方拿到
+ * 一个空清单必须能确定那就是「真没有待同步页面」。`side` 让 apps/api 把失败归回
+ * 子站侧还是主站侧，两侧的既有错误码因此一个字都不用改。
+ */
+export declare const SubsiteSyncDiffErrorCodeSchema: z.ZodEnum<{
+    SUBSITE_DIFF_REQUEST_INVALID: "SUBSITE_DIFF_REQUEST_INVALID";
+    SUBSITE_DIFF_STORE_NOT_CONFIGURED: "SUBSITE_DIFF_STORE_NOT_CONFIGURED";
+    SUBSITE_DIFF_MANIFEST_MISSING: "SUBSITE_DIFF_MANIFEST_MISSING";
+    SUBSITE_DIFF_MANIFEST_INVALID: "SUBSITE_DIFF_MANIFEST_INVALID";
+}>;
+export type SubsiteSyncDiffErrorCode = z.infer<typeof SubsiteSyncDiffErrorCodeSchema>;
+export declare const SubsiteSyncDiffErrorResponseSchema: z.ZodObject<{
+    error_code: z.ZodEnum<{
+        SUBSITE_DIFF_REQUEST_INVALID: "SUBSITE_DIFF_REQUEST_INVALID";
+        SUBSITE_DIFF_STORE_NOT_CONFIGURED: "SUBSITE_DIFF_STORE_NOT_CONFIGURED";
+        SUBSITE_DIFF_MANIFEST_MISSING: "SUBSITE_DIFF_MANIFEST_MISSING";
+        SUBSITE_DIFF_MANIFEST_INVALID: "SUBSITE_DIFF_MANIFEST_INVALID";
+    }>;
+    message: z.ZodString;
+    side: z.ZodOptional<z.ZodEnum<{
+        target: "target";
+        base: "base";
+    }>>;
+}, z.core.$strip>;
+export type SubsiteSyncDiffErrorResponse = z.infer<typeof SubsiteSyncDiffErrorResponseSchema>;
+export {};

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

@@ -0,0 +1,34 @@
+import { z } from "zod";
+/**
+ * apps/api 调用 subsite-service 导出站点静态可见文本时的内部合同。
+ * tenant_id 是主库 text 主键（例如 tenant_dev），不是 UUID。
+ */
+export declare const SubsiteVisibleTextExportRequestSchema: z.ZodObject<{
+    tenant_id: z.ZodString;
+    site_id: z.ZodUUID;
+    snapshot_id: z.ZodUUID;
+    manifest_hash: z.ZodString;
+    object_key: z.ZodString;
+    page_slug: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SubsiteVisibleTextExportRequest = z.infer<typeof SubsiteVisibleTextExportRequestSchema>;
+/** 内部服务返回 Markdown 正文及可审计计数；公网接口只下载 markdown 字段。 */
+export declare const SubsiteVisibleTextExportResponseSchema: z.ZodObject<{
+    site_id: z.ZodUUID;
+    snapshot_id: z.ZodUUID;
+    unit_count: z.ZodNumber;
+    file_count: z.ZodNumber;
+    markdown: z.ZodString;
+    page_slug: z.ZodOptional<z.ZodString>;
+    page_file: z.ZodOptional<z.ZodString>;
+    entries: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        file_path: z.ZodString;
+        line: z.ZodNullable<z.ZodNumber>;
+        kind: z.ZodString;
+        text: z.ZodString;
+        media_key: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type SubsiteVisibleTextEntry = NonNullable<z.infer<typeof SubsiteVisibleTextExportResponseSchema>["entries"]>[number];
+export type SubsiteVisibleTextExportResponse = z.infer<typeof SubsiteVisibleTextExportResponseSchema>;

package/dist/template-upgrade-observability.d.ts

@@ -19,8 +19,8 @@ export declare const TemplateUpgradeValidationStageSchema: z.ZodEnum<{
 }>;
 export type TemplateUpgradeValidationStage = z.infer<typeof TemplateUpgradeValidationStageSchema>;
 export declare const TemplateUpgradeCasOutcomeSchema: z.ZodEnum<{
-    not_attempted: "not_attempted";
     promoted: "promoted";
+    not_attempted: "not_attempted";
     aborted: "aborted";
 }>;
 export type TemplateUpgradeCasOutcome = z.infer<typeof TemplateUpgradeCasOutcomeSchema>;
@@ -50,8 +50,8 @@ export declare const RecordTemplateUpgradeEventRequestSchema: z.ZodObject<{
         validation: "validation";
     }>>;
     cas_outcome: z.ZodNullable<z.ZodEnum<{
-        not_attempted: "not_attempted";
         promoted: "promoted";
+        not_attempted: "not_attempted";
         aborted: "aborted";
     }>>;
 }, z.core.$strict>;

package/dist/theme-presets.d.ts

@@ -6,13 +6,68 @@
  * resources (workspace ns, keyed by preset id) and switch with the locale;
  * the preset itself only holds stable data (id + seeds), never a label.
  */
-export type ThemePresetId = "ocean" | "forest" | "clay" | "violet" | "graphite" | "crimson";
+import type { SiteDesignRadiusId } from "./site-design-presets.js";
+export declare const THEME_PRESET_IDS: readonly ["ocean", "forest", "clay", "violet", "graphite", "crimson"];
+export type ThemePresetId = (typeof THEME_PRESET_IDS)[number];
+/**
+ * 旧 Step6 AI 目录的主题 id（`ai-*`）。生成式主题卡上线后不再有新推荐使用
+ * 这些 id，仅保留给存量 selection 行与历史推荐读取兼容（schema 并集的一员）。
+ */
+export declare const STEP6_AI_THEME_IDS: readonly ["ai-forest", "ai-navy", "ai-steel"];
+export type Step6AiThemeId = (typeof STEP6_AI_THEME_IDS)[number];
+/**
+ * 生成式主题卡 id：API 侧按卡片内容确定性派生（见 step6-design.service 的
+ * 拼接序列化），形状 `gen-` + 8 位小写 hex。内容相同则 id 相同。
+ */
+export declare const STEP6_GENERATED_THEME_ID_PATTERN: RegExp;
+export type Step6GeneratedThemeId = `gen-${string}`;
+export type SiteDesignThemeId = ThemePresetId | Step6AiThemeId | Step6GeneratedThemeId;
 export interface ThemePreset {
     /** Stable identity; the i18n display name keys off this. */
     id: ThemePresetId;
     colorSeeds: {
         primary: string;
         accent: string;
+        foreground: string;
     };
+    surfaceMode: "light" | "dark";
+    /**
+     * 该主题的默认圆角档位。用户在 Step6 换主题时随之带出，
+     * 之后仍可单独调整；调整过就不再被换主题覆盖。
+     */
+    radius: SiteDesignRadiusId;
 }
+export interface Step6AiThemePreset {
+    /**
+     * 旧目录 id（`ai-*`）。新推荐不再使用——生成卡用 `gen-*` id、fallback 卡也按
+     * 内容派生 `gen-*` id。保留该字段只为记录每套 fallback 内容对应的旧目录身份，
+     * 并让 `getSiteDesignThemeRadius` 能回答存量 `ai-*` 选择的圆角回退。
+     */
+    id: Step6AiThemeId;
+    name: string;
+    description: string;
+    /** fallback 卡的原因文案（为什么这套适合作为默认兜底）。 */
+    fallbackReason: string;
+    colorSeeds: {
+        primary: string;
+        accent: string;
+        foreground: string;
+    };
+    surfaceMode: "light" | "dark";
+    radius: SiteDesignRadiusId;
+}
+/**
+ * Step6 设计推荐的 deterministic fallback 内容：模型生成连续失败时，API 侧用
+ * 这三套人工调过的锚点造卡（`buildStep6FallbackThemeCards`），保证「卡必达」。
+ * 不再是模型排序的目录——生成式方案里颜色由模型按站点现场 authoring。
+ */
+export declare const STEP6_AI_THEME_PRESETS: readonly Step6AiThemePreset[];
 export declare const THEME_PRESETS: readonly ThemePreset[];
+export declare function getThemePreset(id: ThemePresetId): ThemePreset;
+/**
+ * 主题（含存量 `ai-*` 候选）对应的默认圆角档位。id 不认识时返回 undefined，
+ * 由调用方决定回退，避免在合同层吞掉未知主题。生成卡（`gen-*`）自带 radius，
+ * 不走这里。入参放宽为 string：zod 的 regex schema 推断类型是 string，
+ * 本函数只做查表，不认识就 undefined。
+ */
+export declare function getSiteDesignThemeRadius(id: string): SiteDesignRadiusId | undefined;

package/dist/workspace-design-apply.d.ts

@@ -4,7 +4,12 @@ export declare const WorkspaceDesignApplyRequestSchema: z.ZodObject<{
     colorSeeds: z.ZodOptional<z.ZodObject<{
         primary: z.ZodString;
         accent: z.ZodString;
+        foreground: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
+    surfaceMode: z.ZodOptional<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>>;
     fonts: z.ZodOptional<z.ZodObject<{
         heading: z.ZodString;
         body: z.ZodString;

package/dist/workspace-resource-operation.d.ts

@@ -35,7 +35,10 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
         id: z.ZodString;
         siteId: z.ZodUUID;
         baseSnapshotId: z.ZodUUID;
-        routeId: z.ZodOptional<z.ZodString>;
+        composition: z.ZodObject<{
+            routeId: z.ZodString;
+            templateId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
         kind: z.ZodEnum<{
             "insert-child": "insert-child";
             "update-text": "update-text";
@@ -52,20 +55,26 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
         target: z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"node">;
             key: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
+        }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"page-unit">;
-            routeId: z.ZodString;
+            composition: z.ZodObject<{
+                routeId: z.ZodString;
+                templateId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
             placementUnitKey: z.ZodString;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"route">;
-            routeId: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
+            composition: z.ZodObject<{
+                routeId: z.ZodString;
+                templateId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"source-file">;
             path: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
+        }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"source-batch">;
             paths: z.ZodArray<z.ZodString>;
-        }, z.core.$strip>, z.ZodObject<{
+        }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"project">;
         }, z.core.$strict>], "kind">;
         documentVersion: z.ZodNumber;
@@ -144,7 +153,10 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
                 kind: z.ZodLiteral<"page-composition">;
                 placementKey: z.ZodString;
                 documentVersion: z.ZodNumber;
-                routeId: z.ZodString;
+                composition: z.ZodObject<{
+                    routeId: z.ZodString;
+                    templateId: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
                 placementUnitKey: z.ZodString;
                 relation: z.ZodEnum<{
                     before: "before";
@@ -156,6 +168,10 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
                 kind: z.ZodLiteral<"page-composition">;
                 placementKey: z.ZodString;
                 documentVersion: z.ZodNumber;
+                composition: z.ZodObject<{
+                    routeId: z.ZodString;
+                    templateId: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
             }, z.core.$strict>]>;
         }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<"move-node">;
@@ -175,7 +191,10 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
                 kind: z.ZodLiteral<"page-composition">;
                 placementKey: z.ZodString;
                 documentVersion: z.ZodNumber;
-                routeId: z.ZodString;
+                composition: z.ZodObject<{
+                    routeId: z.ZodString;
+                    templateId: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
                 placementUnitKey: z.ZodString;
                 relation: z.ZodEnum<{
                     before: "before";
@@ -187,7 +206,6 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
             preserveBindings: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<"set-class-name-source">;
-            routeId: z.ZodOptional<z.ZodString>;
             filePath: z.ZodString;
             expectedVersion: z.ZodObject<{
                 documentVersion: z.ZodNumber;
@@ -228,7 +246,6 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
         }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<"apply-style-draft">;
             className: z.ZodOptional<z.ZodObject<{
-                routeId: z.ZodOptional<z.ZodString>;
                 filePath: z.ZodString;
                 expectedVersion: z.ZodObject<{
                     documentVersion: z.ZodNumber;
@@ -350,7 +367,7 @@ export declare const WorkspaceResourceOperationTransientInputSchema: z.ZodObject
             kind: z.ZodLiteral<"delete-page-source">;
             expectedUrlPath: z.ZodString;
         }, z.core.$strict>], "kind">;
-    }, z.core.$strip>;
+    }, z.core.$strict>;
     navigation_selection: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"none">;
     }, z.core.$strict>, z.ZodObject<{
@@ -391,7 +408,10 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                 id: z.ZodString;
                 siteId: z.ZodUUID;
                 baseSnapshotId: z.ZodUUID;
-                routeId: z.ZodOptional<z.ZodString>;
+                composition: z.ZodObject<{
+                    routeId: z.ZodString;
+                    templateId: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
                 kind: z.ZodEnum<{
                     "insert-child": "insert-child";
                     "update-text": "update-text";
@@ -408,20 +428,26 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                 target: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"node">;
                     key: z.ZodString;
-                }, z.core.$strip>, z.ZodObject<{
+                }, z.core.$strict>, z.ZodObject<{
                     kind: z.ZodLiteral<"page-unit">;
-                    routeId: z.ZodString;
+                    composition: z.ZodObject<{
+                        routeId: z.ZodString;
+                        templateId: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>;
                     placementUnitKey: z.ZodString;
                 }, z.core.$strict>, z.ZodObject<{
                     kind: z.ZodLiteral<"route">;
-                    routeId: z.ZodString;
-                }, z.core.$strip>, z.ZodObject<{
+                    composition: z.ZodObject<{
+                        routeId: z.ZodString;
+                        templateId: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>;
+                }, z.core.$strict>, z.ZodObject<{
                     kind: z.ZodLiteral<"source-file">;
                     path: z.ZodString;
-                }, z.core.$strip>, z.ZodObject<{
+                }, z.core.$strict>, z.ZodObject<{
                     kind: z.ZodLiteral<"source-batch">;
                     paths: z.ZodArray<z.ZodString>;
-                }, z.core.$strip>, z.ZodObject<{
+                }, z.core.$strict>, z.ZodObject<{
                     kind: z.ZodLiteral<"project">;
                 }, z.core.$strict>], "kind">;
                 documentVersion: z.ZodNumber;
@@ -500,7 +526,10 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                         kind: z.ZodLiteral<"page-composition">;
                         placementKey: z.ZodString;
                         documentVersion: z.ZodNumber;
-                        routeId: z.ZodString;
+                        composition: z.ZodObject<{
+                            routeId: z.ZodString;
+                            templateId: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strict>;
                         placementUnitKey: z.ZodString;
                         relation: z.ZodEnum<{
                             before: "before";
@@ -512,6 +541,10 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                         kind: z.ZodLiteral<"page-composition">;
                         placementKey: z.ZodString;
                         documentVersion: z.ZodNumber;
+                        composition: z.ZodObject<{
+                            routeId: z.ZodString;
+                            templateId: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strict>;
                     }, z.core.$strict>]>;
                 }, z.core.$strip>, z.ZodObject<{
                     kind: z.ZodLiteral<"move-node">;
@@ -531,7 +564,10 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                         kind: z.ZodLiteral<"page-composition">;
                         placementKey: z.ZodString;
                         documentVersion: z.ZodNumber;
-                        routeId: z.ZodString;
+                        composition: z.ZodObject<{
+                            routeId: z.ZodString;
+                            templateId: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strict>;
                         placementUnitKey: z.ZodString;
                         relation: z.ZodEnum<{
                             before: "before";
@@ -543,7 +579,6 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                     preserveBindings: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>, z.ZodObject<{
                     kind: z.ZodLiteral<"set-class-name-source">;
-                    routeId: z.ZodOptional<z.ZodString>;
                     filePath: z.ZodString;
                     expectedVersion: z.ZodObject<{
                         documentVersion: z.ZodNumber;
@@ -584,7 +619,6 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                 }, z.core.$strip>, z.ZodObject<{
                     kind: z.ZodLiteral<"apply-style-draft">;
                     className: z.ZodOptional<z.ZodObject<{
-                        routeId: z.ZodOptional<z.ZodString>;
                         filePath: z.ZodString;
                         expectedVersion: z.ZodObject<{
                             documentVersion: z.ZodNumber;
@@ -706,7 +740,7 @@ export declare const WorkspaceResourceOperationClientMessageSchema: z.ZodObject<
                     kind: z.ZodLiteral<"delete-page-source">;
                     expectedUrlPath: z.ZodString;
                 }, z.core.$strict>], "kind">;
-            }, z.core.$strip>;
+            }, z.core.$strict>;
             navigation_selection: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"none">;
             }, z.core.$strict>, z.ZodObject<{

package/package.json

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