@vcp-dev/contracts 0.6.3 → 0.6.5

package/dist/connect-form.d.ts

@@ -26,13 +26,13 @@ export declare const FormFieldDeclSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type FormFieldDecl = z.infer<typeof FormFieldDeclSchema>;
 export declare const ConnectFormInputSchema: z.ZodObject<{
-    form_hint: z.ZodString;
     mode: z.ZodEnum<{
         bind_existing: "bind_existing";
         provision: "provision";
     }>;
-    component_slug: z.ZodOptional<z.ZodString>;
+    form_hint: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
+    component_slug: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
     fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -68,7 +68,7 @@ export type ConnectFormResult = {
     form_name: string;
     /** 读回落定的表单字段（提交 data 的键 = name）。 */
     fields: ResolvedFormField[];
-    /** 表单来源页 id（提交必带；null=CMS 未回，提交会被 cms 以 unknown_source_page 拒）。 */
+    /** 历史表单来源页 id，仅用于旧生成站点兼容；当前提交按 url_path 解析真实页面。 */
     source_page_id: number | null;
     /** LLM 要写的表单 view 组件路径（必须 "use client"）。 */
     form_view: string;
@@ -92,7 +92,7 @@ export type ConnectFormResult = {
 }
 /**
  * 幂等命中：该表单的 scaffold 已存在于 base snapshot（此前 run 绑定过），
- * 本次零写入。LLM 收到后下一步：按实时重算的 form_contract 写 form view，
+ * 本次会补建或升级确定性提交基建。LLM 收到后下一步：按实时重算的 form_contract 写 form view，
  * 绝不重建 existing_files、绝不手写提交链路（与 connect_dynamic_collection
  * 的 already_bound 同款）。
  */
@@ -102,13 +102,13 @@ export type ConnectFormResult = {
     form_name: string;
     /** 实时读回落定的表单字段（提交 data 的键 = name）。 */
     fields: ResolvedFormField[];
-    /** 表单来源页 id（提交必带；null=CMS 未回）。 */
+    /** 历史表单来源页 id，仅用于旧生成站点兼容。 */
     source_page_id: number | null;
     /** LLM 要写的表单 view 组件路径（必须 "use client"）。 */
     form_view: string;
     /** 实时重算（与 bound 同源派生），不读旧产物。 */
     form_contract: string;
-    /** 已存在的 scaffold 路径（容器 + 站点级基建），绝不可重建（再 create 必撞 ALREADY_EXISTS）。 */
+    /** 工具返回时已在 working set 的 scaffold 路径，绝不可重建。 */
     existing_files: string[];
 }
 /** CMS 基础设施暂不可达（网络/5xx/530 瞬断），非「表单不存在」——稍后重试，勿换名猜测。 */

package/dist/designer-component-library.d.ts

@@ -0,0 +1,52 @@
+import { z } from "zod";
+export declare const INSERT_NEW_COMPONENT_CATEGORY_GROUP_KEY: "insertNewComponent";
+export declare const DESIGNER_COMPONENT_LIBRARY_ERROR_CODES: {
+    readonly categoryGroupMissing: "DESIGNER_COMPONENT_CATEGORY_GROUP_MISSING";
+    readonly unavailable: "DESIGNER_COMPONENT_LIBRARY_UNAVAILABLE";
+    readonly timeout: "DESIGNER_COMPONENT_LIBRARY_TIMEOUT";
+    readonly invalidResponse: "DESIGNER_COMPONENT_LIBRARY_INVALID_RESPONSE";
+};
+export interface DesignerComponentCategoryNode {
+    readonly id: string;
+    readonly key: string;
+    readonly name: string;
+    readonly children: readonly DesignerComponentCategoryNode[];
+}
+export declare const DesignerComponentCategoryNodeSchema: z.ZodType<DesignerComponentCategoryNode>;
+export declare const DesignerComponentCategoriesDataSchema: z.ZodObject<{
+    category_group_key: z.ZodLiteral<"insertNewComponent">;
+    categories: z.ZodArray<z.ZodType<DesignerComponentCategoryNode, unknown, z.core.$ZodTypeInternals<DesignerComponentCategoryNode, unknown>>>;
+}, z.core.$strict>;
+export declare const DesignerComponentCatalogItemSchema: z.ZodObject<{
+    resource_id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    thumbnail_url: z.ZodNullable<z.ZodString>;
+    resolved_version: z.ZodString;
+    category_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const DesignerComponentsDataSchema: z.ZodObject<{
+    category_group_key: z.ZodLiteral<"insertNewComponent">;
+    items: z.ZodArray<z.ZodObject<{
+        resource_id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        thumbnail_url: z.ZodNullable<z.ZodString>;
+        resolved_version: z.ZodString;
+        category_id: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    next_cursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const ListDesignerComponentsQuerySchema: z.ZodObject<{
+    category_id: z.ZodOptional<z.ZodString>;
+    include_descendants: z.ZodPipe<z.ZodOptional<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>>, z.ZodTransform<boolean, "true" | "false" | undefined>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type DesignerComponentCategoriesData = z.infer<typeof DesignerComponentCategoriesDataSchema>;
+export type DesignerComponentCatalogItem = z.infer<typeof DesignerComponentCatalogItemSchema>;
+export type DesignerComponentsData = z.infer<typeof DesignerComponentsDataSchema>;
+export type ListDesignerComponentsQuery = z.infer<typeof ListDesignerComponentsQuerySchema>;

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 export * from "./deployment-runtime.js";
+export * from "./designer-component-library.js";
 export { PAGE_SLUG_PATTERN, PAGE_SLUG_SEGMENT_PATTERN_SOURCE, canonicalizePageSlug, isCanonicalPageSlug, pageSlugToRouteFilePath, tryCanonicalizeAsciiPageSlug, } from "./page-slug.js";
 export * from "./site-edit-capability.js";
 export * from "./site-edit-class-name-source.js";
@@ -977,6 +978,32 @@ export declare const ApiResponseSchema: <T extends z.ZodTypeAny>(dataSchema: T)
     data: T;
     message: z.ZodString;
 }, z.core.$strip>;
+export declare const ListDesignerComponentCategoriesResponseSchema: z.ZodObject<{
+    code: z.ZodNumber;
+    data: z.ZodObject<{
+        category_group_key: z.ZodLiteral<"insertNewComponent">;
+        categories: z.ZodArray<z.ZodType<import("./designer-component-library.js").DesignerComponentCategoryNode, unknown, z.core.$ZodTypeInternals<import("./designer-component-library.js").DesignerComponentCategoryNode, unknown>>>;
+    }, z.core.$strict>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export type ListDesignerComponentCategoriesResponse = z.infer<typeof ListDesignerComponentCategoriesResponseSchema>;
+export declare const ListDesignerComponentsResponseSchema: z.ZodObject<{
+    code: z.ZodNumber;
+    data: z.ZodObject<{
+        category_group_key: z.ZodLiteral<"insertNewComponent">;
+        items: z.ZodArray<z.ZodObject<{
+            resource_id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodNullable<z.ZodString>;
+            thumbnail_url: z.ZodNullable<z.ZodString>;
+            resolved_version: z.ZodString;
+            category_id: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        next_cursor: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export type ListDesignerComponentsResponse = z.infer<typeof ListDesignerComponentsResponseSchema>;
 export declare const ExternalSyncSiteResponseSchema: z.ZodObject<{
     code: z.ZodNumber;
     data: z.ZodObject<{
@@ -7153,6 +7180,7 @@ export declare const AgentEventTypeSchema: z.ZodEnum<{
     "workspace.design_plan.outcome": "workspace.design_plan.outcome";
     "workspace.suggestions": "workspace.suggestions";
     "file.changed": "file.changed";
+    "snapshot.finalized": "snapshot.finalized";
     "preview.preparing": "preview.preparing";
     "preview.ready": "preview.ready";
     "preview.build.started": "preview.build.started";
@@ -8079,6 +8107,10 @@ export declare const AgentEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     snapshot_id: z.ZodString;
     manifest_hash: z.ZodString;
     at: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"snapshot.finalized">;
+    snapshot_id: z.ZodString;
+    at: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"preview.preparing">;
     at: z.ZodString;
@@ -8246,6 +8278,7 @@ export declare const AgentEventRecordSchema: z.ZodObject<{
         "workspace.design_plan.outcome": "workspace.design_plan.outcome";
         "workspace.suggestions": "workspace.suggestions";
         "file.changed": "file.changed";
+        "snapshot.finalized": "snapshot.finalized";
         "preview.preparing": "preview.preparing";
         "preview.ready": "preview.ready";
         "preview.build.started": "preview.build.started";
@@ -8792,6 +8825,10 @@ export declare const AgentEventRecordSchema: z.ZodObject<{
         snapshot_id: z.ZodString;
         manifest_hash: z.ZodString;
         at: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"snapshot.finalized">;
+        snapshot_id: z.ZodString;
+        at: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"preview.preparing">;
         at: z.ZodString;
@@ -8956,6 +8993,7 @@ export declare const AppendAgentEventRequestSchema: z.ZodObject<{
         "workspace.design_plan.outcome": "workspace.design_plan.outcome";
         "workspace.suggestions": "workspace.suggestions";
         "file.changed": "file.changed";
+        "snapshot.finalized": "snapshot.finalized";
         "preview.preparing": "preview.preparing";
         "preview.ready": "preview.ready";
         "preview.build.started": "preview.build.started";
@@ -9502,6 +9540,10 @@ export declare const AppendAgentEventRequestSchema: z.ZodObject<{
         snapshot_id: z.ZodString;
         manifest_hash: z.ZodString;
         at: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"snapshot.finalized">;
+        snapshot_id: z.ZodString;
+        at: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"preview.preparing">;
         at: z.ZodString;
@@ -9705,6 +9747,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
             "workspace.design_plan.outcome": "workspace.design_plan.outcome";
             "workspace.suggestions": "workspace.suggestions";
             "file.changed": "file.changed";
+            "snapshot.finalized": "snapshot.finalized";
             "preview.preparing": "preview.preparing";
             "preview.ready": "preview.ready";
             "preview.build.started": "preview.build.started";
@@ -10251,6 +10294,10 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
             snapshot_id: z.ZodString;
             manifest_hash: z.ZodString;
             at: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"snapshot.finalized">;
+            snapshot_id: z.ZodString;
+            at: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"preview.preparing">;
             at: z.ZodString;
@@ -10455,6 +10502,7 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
             "workspace.design_plan.outcome": "workspace.design_plan.outcome";
             "workspace.suggestions": "workspace.suggestions";
             "file.changed": "file.changed";
+            "snapshot.finalized": "snapshot.finalized";
             "preview.preparing": "preview.preparing";
             "preview.ready": "preview.ready";
             "preview.build.started": "preview.build.started";
@@ -11001,6 +11049,10 @@ export declare const AppendAgentEventResponseSchema: z.ZodDiscriminatedUnion<[z.
             snapshot_id: z.ZodString;
             manifest_hash: z.ZodString;
             at: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"snapshot.finalized">;
+            snapshot_id: z.ZodString;
+            at: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"preview.preparing">;
             at: z.ZodString;
@@ -11173,6 +11225,7 @@ export declare const ListAgentEventsResponseSchema: z.ZodObject<{
             "workspace.design_plan.outcome": "workspace.design_plan.outcome";
             "workspace.suggestions": "workspace.suggestions";
             "file.changed": "file.changed";
+            "snapshot.finalized": "snapshot.finalized";
             "preview.preparing": "preview.preparing";
             "preview.ready": "preview.ready";
             "preview.build.started": "preview.build.started";
@@ -11719,6 +11772,10 @@ export declare const ListAgentEventsResponseSchema: z.ZodObject<{
             snapshot_id: z.ZodString;
             manifest_hash: z.ZodString;
             at: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"snapshot.finalized">;
+            snapshot_id: z.ZodString;
+            at: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"preview.preparing">;
             at: z.ZodString;
@@ -11926,6 +11983,23 @@ export declare const REST_API_ENDPOINTS: readonly [{
     readonly summary: "Get one tenant-scoped site.";
     readonly status: "implemented";
     readonly response_schema: "SiteRecordSchema";
+}, {
+    readonly method: "GET";
+    readonly path: "/sites/:site_id/designer/component-library/categories";
+    readonly tag: "designer-component-library";
+    readonly summary: "List the fixed insert-new-component category tree for a site.";
+    readonly status: "implemented";
+    readonly response_schema: "ListDesignerComponentCategoriesResponseSchema";
+    readonly notes: readonly ["The server validates site ownership and fixes category_group_key to insertNewComponent."];
+}, {
+    readonly method: "GET";
+    readonly path: "/sites/:site_id/designer/component-library/resources";
+    readonly tag: "designer-component-library";
+    readonly summary: "List component resources from the fixed designer catalog group.";
+    readonly status: "implemented";
+    readonly query_schema: "ListDesignerComponentsQuerySchema";
+    readonly response_schema: "ListDesignerComponentsResponseSchema";
+    readonly notes: readonly ["The server fixes resource type to component and does not expose resource-platform secrets, internal hosts, or product-line selection."];
 }, {
     readonly method: "PATCH";
     readonly path: "/sites/:site_id";
@@ -12716,6 +12790,7 @@ export declare const WorkspaceWebSocketMessageTypeSchema: z.ZodEnum<{
     "server.patch.applied": "server.patch.applied";
     "server.sitemap.updated": "server.sitemap.updated";
     "server.snapshot.created": "server.snapshot.created";
+    "server.snapshot.finalized": "server.snapshot.finalized";
     "server.preview.invalidated": "server.preview.invalidated";
     "server.run.finished": "server.run.finished";
     "server.run.failed": "server.run.failed";
@@ -13276,6 +13351,18 @@ export declare const WorkspaceServerMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
         snapshot_id: z.ZodString;
         manifest_hash: z.ZodString;
     }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    tenant_id: z.ZodString;
+    site_id: z.ZodString;
+    run_id: z.ZodOptional<z.ZodString>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    sent_at: z.ZodString;
+    type: z.ZodLiteral<"server.snapshot.finalized">;
+    payload: z.ZodObject<{
+        snapshot_id: z.ZodString;
+    }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
     tenant_id: z.ZodString;
@@ -13994,6 +14081,18 @@ export declare const WorkspaceWebSocketMessageSchema: z.ZodUnion<readonly [z.Zod
         snapshot_id: z.ZodString;
         manifest_hash: z.ZodString;
     }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    tenant_id: z.ZodString;
+    site_id: z.ZodString;
+    run_id: z.ZodOptional<z.ZodString>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+    sent_at: z.ZodString;
+    type: z.ZodLiteral<"server.snapshot.finalized">;
+    payload: z.ZodObject<{
+        snapshot_id: z.ZodString;
+    }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
     tenant_id: z.ZodString;